
처음엔 저도 "AI 채팅 도구"인 줄 알았어요
솔직히 말할게요. 저도 처음에 클로드 코드를 설치해놓고 한동안 그냥 "터미널 버전 챗봇"처럼 쓰고 있었어요. 질문하고, 코드 받고, 복붙하고. 그게 전부인 줄 알았거든요.
근데 어느 순간 알게 됐어요. 내가 클로드 코드의 10%도 못 쓰고 있다는 걸요.
CLAUDE.md를 제대로 세팅하고, 슬래시 커맨드 몇 개 만들고, MCP 연결하고 나니까... 진짜로 "AI 직원" 한 명 데려온 느낌이 났습니다. 반복하던 작업들이 알아서 돌아가기 시작하고, 매번 길게 설명하던 지시들이 한 줄로 줄어들었어요.
오늘은 그 경험을 7단계 테크트리로 정리해서 공유해드리려고 해요. 순서대로만 따라가도 체감 효율이 완전히 달라질 거예요.
클로드 코드가 뭔지 먼저 짚고 갈게요
클로드 코드는 Anthropic이 직접 만든 AI 코딩 에이전트입니다. 터미널에서 실행되고, 자연어로 지시하면 파일을 열고, 코드를 짜고, 버그 고치고, Git 커밋까지 스스로 처리해요.
일반 클로드 앱과 가장 큰 차이는 "내 컴퓨터를 직접 건드린다"는 점이에요. 웹 브라우저 클로드는 제가 복사해서 붙여넣는 내용만 보는 반면, 클로드 코드는 프로젝트 전체 폴더를 스스로 탐색하고 필요한 파일을 알아서 읽습니다.
규모가 어느 정도냐 하면, 2026년 초 기준으로 Claude Code는 Anthropic 전체 매출의 약 20%를 차지할 정도로 성장했고, VS Code 확장 프로그램 일일 설치 건수가 2,900만 건에 달한다는 보고도 있습니다. Cursor, Windsurf, Lovable 같은 AI 코딩 도구들이 클로드를 기본 모델로 채택하면서 "코딩은 클로드"라는 인식이 자연스럽게 자리 잡고 있어요.
요금은 Max 5x 구독(월 100달러)에 Claude Code가 포함되어 있고, 5시간마다 리셋되는 사용량 구조로 일반적인 업무에는 충분합니다.
1단계: 설치, 두 가지 방법 중 하나를 고르세요
클로드 코드 설치는 크게 두 가지 방법이 있어요.
첫 번째는 VS Code 확장 프로그램으로 설치하는 방법입니다. 마켓플레이스에서 Claude를 검색하면 바로 나와요. 처음 접하시는 분들, 터미널이 익숙하지 않으신 분들께 딱 맞는 방식이에요. 익숙한 VS Code 환경 그대로 쓸 수 있으니까요.
두 번째는 터미널에서 직접 설치하는 방법입니다. Node.js를 먼저 설치하고, npm install -g @anthropic-ai/claude-code 한 줄이면 끝이에요. 3분도 안 걸립니다. 이 방식이 파일 접근, 자동 실행 등 모든 기능을 100% 활용할 수 있어서 어느 정도 익숙해지면 꼭 이쪽으로 넘어오시길 권해요.
설치하고 처음 실행하면 브라우저가 열리면서 Anthropic 계정 인증을 요청합니다. 로그인하면 바로 쓸 수 있어요.
한 줄 정리: 처음엔 확장 프로그램, 익숙해지면 터미널로 전환하세요.
2단계: CLAUDE.md, 이게 AI의 두뇌입니다
클로드 코드를 제대로 쓰려면 CLAUDE.md 세팅이 핵심이에요. 이 파일은 클로드 코드가 작업 시작 전에 가장 먼저 읽는 파일입니다. 여기에 뭘 쓰냐에 따라 AI가 일하는 방식이 완전히 달라져요.
사람으로 치면 입사 첫날 받는 업무 매뉴얼이자 회사 문화 안내서 같은 거예요. 이게 잘 되어 있으면 매번 "이 프로젝트는 어떤 스택이고, 코드 스타일은 어떻고..." 설명하지 않아도 됩니다.
처음부터 만들려 하지 마세요. 공개된 베스트 프랙티스 템플릿을 가져다 쓰고 거기서부터 내 상황에 맞게 수정하는 게 훨씬 빠릅니다.
운영 원칙은 간단해요. 전체 공통 규칙은 최상위 폴더 CLAUDE.md에 100줄 내외로 압축하고, 프로젝트별로 다른 규칙이 필요하면 해당 폴더에 별도 CLAUDE.md를 만들어 세분화하면 됩니다. 클로드 코드는 현재 작업 폴더에서 시작해 루트 폴더까지 거슬러 올라가며 모든 CLAUDE.md를 읽어들이거든요.
팁 하나: Shift+Tab을 누르면 "자동 수락 모드"로 전환됩니다. 매번 "이 파일 수정해도 될까요?" 묻지 않고 알아서 처리해줘서 속도가 확 올라가요.
한 줄 정리: 초반 세팅 시간이 나중에 10배로 돌아옵니다.
3단계: 슬래시 커맨드로 반복 업무를 단축키로 만드세요
매번 긴 지시문을 입력하는 건 생산성의 적이에요. 슬래시 커맨드는 자주 쓰는 복잡한 지시를 단 한 줄로 불러오는 기능입니다.
예를 들어볼게요. 매주 반복하는 "이 코드 리뷰해주고 개선점 정리해줘, 성능 이슈 중심으로, 표로 출력해줘"라는 지시를 /code-review라는 커맨드로 저장해두면, 다음부터는 /code-review만 입력하면 됩니다.
커맨드 파일은 .claude/commands/ 폴더 안에 마크다운 파일로 저장해요. 파일명이 곧 커맨드 이름이 됩니다. 팀 작업이라면 이 폴더를 Git에 올려 공유하면 팀 전체가 같은 커맨드를 쓸 수 있어요.
$ARGUMENTS라는 특수 키워드를 쓰면 매번 다른 값을 넘길 수도 있어서 더 유연하게 활용됩니다.
한 줄 정리: 한 번 만든 커맨드가 1초로 10분짜리 지시를 대체합니다.
4단계: 스킬스(Skills)로 작업 흐름 자체를 파일로 만드세요
커맨드가 "이것 해"라면, 스킬스는 "이 순서대로 일해"입니다.
구조는 간단해요. 폴더 하나 만들고 그 안에 SKILL.md 파일을 넣으면 됩니다. 필요하면 스크립트 파일이나 참조 문서도 추가할 수 있어요. 클로드 코드는 SKILL.md를 읽고 거기 적힌 순서대로 작업을 진행합니다.
실제로 블로그 글쓰기 워크플로를 스킬로 만들어 쓰고 있는 분들이 많아요. "웹 검색 후 보완 데이터 수집 → 키워드 전략 수립 → 본문 작성 → 해시태그 생성 → 이미지 프롬프트 출력"이라는 흐름이 SKILL.md 하나에 담기는 거죠.
초보자 팁: 처음부터 스킬을 만들기 어렵다면, 클로드 코드와 함께 작업을 한 번 잘 진행한 다음 "이 작업 과정을 SKILL.md 파일로 정리해줘"라고 요청해보세요. 내가 한 번 잘 한 작업을 스킬로 기록하면, 다음에 같은 수준의 결과물을 훨씬 쉽게 재현할 수 있어요.
한 줄 정리: 반복할수록 결과물이 일관해집니다.
5단계: 서브 에이전트, AI 혼자보다 AI 팀이 더 똑똑합니다
혼자 일하는 AI는 한계가 있어요. 전문성도 없고, 자기 기준도 없습니다. 그래서 나온 개념이 서브 에이전트예요.
각 역할에 특화된 AI를 여러 개 만들어놓고, 메인 AI가 적합한 에이전트에게 작업을 위임하는 구조입니다. 콘텐츠 에이전트, 데이터 에이전트, 개발 에이전트를 만들어두면 메인 AI가 알아서 역할에 맞게 넘겨요.
실제 사례가 있어요. 한 개발자가 Claude Code의 서브 에이전트를 활용해 대규모 TypeScript 코드베이스에서 병렬 검색 및 빌드 스크립트를 생성한 결과, 작업 시간을 50% 줄였다는 사례가 보고됐습니다. A 인스턴스에게 연동 문서를 만들게 하고, 그 문서를 B 인스턴스에게 넘겨 구현까지 진행하는 방식, 마치 두 명의 개발자가 역할을 나눠 동시에 작업하는 느낌이에요.
에이전트 파일은 .claude/agent/ 폴더 안에 넣습니다. 중요한 건 숫자보다 역할의 명확함이에요.
한 줄 정리: 에이전트를 많이 만드는 것보다, 각 에이전트가 잘 정의된 역할로 일하게 하는 게 핵심입니다.
6단계: MCP 연결, 여기서부터 진짜 자동화가 시작됩니다
MCP(Model Context Protocol)는 클로드 코드를 외부 도구와 연결하는 다리입니다. 이걸 잘 활용하면 클로드 코드의 활용 범위가 완전히 달라져요.
연결 가능한 도구가 정말 방대합니다. Notion, Google Calendar, Google Drive, Gmail, GitHub, Slack, Discord, Figma, Jira, 각종 데이터베이스, 사내 시스템까지 연결됩니다.
실제 활용 예시를 들면, "Google Calendar 오늘 일정 확인하고, Notion 프로젝트 현황 읽어서, Slack 팀 채널에 일일 업무 보고 올려줘"라는 명령 한 줄로 세 가지 도구를 연동한 자동화가 만들어집니다. 코딩 없이, 자연어로만 가능해요.
한 CI/CD 자동화 사례에서는 Claude Code로 GitHub Actions 스크립트를 생성한 결과 배포 시간을 60% 단축하고 개발자가 핵심 작업에 2배 더 집중할 수 있었다는 보고도 있습니다.
MCP 설정은 .mcp.json 파일 또는 설정 메뉴에서 합니다. 팀 프로젝트라면 .mcp.json을 Git에 올려 팀 전체가 같은 도구 연결을 공유할 수 있어요.
한 줄 정리: MCP는 클로드 코드에 팔다리를 달아주는 기능입니다.
7단계: 훅스(Hooks), AI가 스스로 작동하는 자동화 트리거
훅스는 "이런 상황이 생기면 이걸 실행해"를 미리 설정해두는 기능이에요. AI가 특정 조건을 만족하면 자동으로 다음 동작을 수행합니다.
주요 훅스 세 가지를 알아두면 충분해요.
Pre-use 훅은 AI가 도구를 실행하기 전에 체크합니다. 위험한 명령어를 차단하거나, 특정 작업 전에 사용자 확인이 필요한지 자동으로 검토해요.
Post-use 훅은 작업이 끝난 후 자동으로 다음 작업을 이어갑니다. 코드 작성 후 자동 포매팅, 특정 작업 완료 후 다음 단계 자동 실행 등에 씁니다.
Notification 훅은 AI가 사용자 입력을 기다릴 때 알림을 줘요. 긴 작업을 걸어두고 자리를 비웠다가, 작업이 완료되면 Discord나 Slack으로 알림을 받는 방식이에요.
인상적인 활용 예시 하나만 들면, 매일 아침 클로드 코드가 전날 작업 내용, 이슈, 다음 할 일을 정리해서 Discord로 자동 보고하도록 설정해두는 방식입니다. 기록이 쌓일수록 시스템이 스스로 발전해요.
한 줄 정리: 훅스는 AI를 반응형에서 선제적으로 바꿔주는 기능입니다.
오늘 당장 어디서 시작하면 될까요?
처음부터 7단계를 다 세팅하려 하면 지칩니다. 순서대로 하나씩 쌓아가는 게 맞아요.
오늘 당장 시작한다면, 1단계 설치와 2단계 CLAUDE.md 세팅만 완료해도 체감 효율이 달라집니다. 3~4단계 커맨드와 스킬스까지 갖추면 반복 업무의 80%가 자동화돼요. 5~7단계는 그다음 레벨업입니다.
중요한 건 "내 업무"에 맞게 최적화하는 과정이에요. 다른 사람의 세팅을 가져다 쓰되, 내 맥락에 맞게 고쳐나가야 합니다. 그렇게 쌓인 CLAUDE.md, 커맨드, 스킬스 파일들이 모이면 나만의 AI 운영 체제가 완성됩니다.
AI 기술은 지금도 빠르게 업데이트되고 있어요. 클로드 코드의 공식 업데이트 노트를 주기적으로 확인하고, 내 세팅에 하나씩 반영해나가는 게 좋아요. 이 과정이 반복될수록 내 AI는 점점 더 나를 아는 AI가 되어갑니다.
마무리: 클로드 코드는 도구가 아니라 시스템입니다
설치하고 그냥 쓰는 클로드 코드와 7단계 테크트리로 세팅된 클로드 코드는 같은 도구가 아닙니다.
CLAUDE.md로 AI의 두뇌를 설계하고, 커맨드와 스킬스로 반복 업무를 자동화하고, MCP로 외부 도구를 연결하고, 훅스로 자율 실행까지 설정하면 말 그대로 내 업무를 대신 처리하는 AI 직원이 완성됩니다.
오늘 CLAUDE.md 하나만 만들어도, 내일의 작업 속도는 분명 달라질 거예요. 지금 바로 시작해보세요.
'IT > AI' 카테고리의 다른 글
| 🖥️ AI 에이전트 시대, 왜 19년 된 tmux가 다시 뜨고 있을까? (0) | 2026.05.24 |
|---|---|
| 🤔 AI 도입, 왜 기술보다 조직이 더 큰 문제일까? (0) | 2026.05.24 |
| 🧠 AI 시대, 진짜 폭등할 가치는 '지식'이 아니라 '관계'였다 (0) | 2026.05.23 |
| 🧠 개인 위키, 왜 항상 실패할까? AI가 대신 관리해주는 'LLM 위키' 개념 (0) | 2026.05.23 |
| 🤖 Qwen3.6이 왔다! 오픈소스 AI가 Claude를 이긴다고? (1) | 2026.05.23 |