지금까지 Claude Code의 기본기를 정리했다. 슬래시 커맨드(#4), 기억 구조(#5, #6). 이제 한 단계 올라간다.
혼자 일하는데 팀처럼 돌아가게 만드는 구조.
Claude Code에는 세 가지 기능이 있다. 이걸 이해하면 "AI 비서"가 아니라 "AI 팀"을 운영하는 감각이 생긴다.
회사에 비유하면
먼저 큰 그림부터 잡자.
나 = CEO
Skills = 업무 매뉴얼 (SOP)
MCP = 외부 도구·서비스 연결
서브에이전트 = 팀원 (실제로 일하는 사람)회사를 운영한다고 생각해보자. CEO가 모든 일을 직접 할 수는 없다. 그래서:
- 매뉴얼(Skills)을 만들어서 "이런 작업은 이렇게 해"를 정해둔다
- 도구(MCP)를 연결해서 슬랙, 깃허브, DB 같은 외부 시스템을 쓸 수 있게 한다
- 팀원(서브에이전트)에게 일을 맡겨서 병렬로 처리한다
하나씩 풀어보자.
Skills — 반복 업무의 매뉴얼
카페에서 신입 알바가 들어오면 매뉴얼을 준다. "아메리카노는 이렇게, 라떼는 이렇게." 매번 말로 설명하지 않아도 된다.
Skills가 이거다. Claude에게 반복 작업의 절차를 미리 적어두는 것.
/commit → 커밋 메시지 규칙대로 작성해줘
/review → 이 코드 리뷰해줘, 이 기준으로
/simplify → 이 코드 더 간결하게 만들어줘슬래시 커맨드(#4)에서 /init이나 /compact 같은 기본 명령을 소개했는데, Skills는 내가 직접 만드는 커스텀 명령이다.
예를 들어 블로그 글을 쓸 때마다 "제목은 이 형식, 태그는 이렇게, 톤은 이렇게"를 매번 말하는 대신, /write-post라는 스킬을 만들어두면 한 단어로 끝난다.
핵심: 한 번 만들면 계속 쓴다. 매번 같은 지시를 반복하지 않아도 된다.
MCP — 외부 세계와 연결하는 통로
Claude Code는 기본적으로 내 컴퓨터 안에서 일한다. 파일 읽고, 코드 수정하고, 터미널 명령 실행하고.
그런데 실제 업무는 내 컴퓨터 안에서만 끝나지 않는다. GitHub에 이슈 올리고, 슬랙에 메시지 보내고, DB에서 데이터 뽑고.
MCP(Model Context Protocol)는 이런 외부 서비스를 Claude에게 연결해주는 규격이다.
MCP 서버 연결 예시:
GitHub → 이슈 조회, PR 생성
Slack → 메시지 전송, 채널 읽기
DB → 쿼리 실행, 데이터 조회
Figma → 디자인 파일 참조비유하면 회사에 전화, 팩스, 사내 시스템을 연결하는 것이다. 팀원이 아무리 유능해도 전화기가 없으면 외부와 소통할 수 없다.
MCP가 없으면 Claude는 내 컴퓨터 안에 갇혀 있다. MCP를 연결하면 외부 세계와 일할 수 있는 팀이 된다.
서브에이전트 — 일을 맡기는 팀원
여기가 가장 흥미로운 부분이다.
Claude Code에게 복잡한 작업을 시키면, Claude가 혼자 다 하는 게 아니다. 자기 밑에 작은 에이전트를 만들어서 일을 분배한다.
나: "이 프로젝트 코드 분석하고, 버그 찾고, 테스트도 돌려줘"
Claude (메인):
├── 서브에이전트 A → 코드 구조 분석
├── 서브에이전트 B → 버그 탐색
└── 서브에이전트 C → 테스트 실행이게 왜 중요하냐면, 동시에 돌아간다. A가 분석하는 동안 B는 버그를 찾고 C는 테스트를 돌린다. 순서대로 하나씩 하는 게 아니라 병렬 처리다.
실제로 내가 플레이북 작업할 때 Claude가 서브에이전트를 45개 넘게 만든 적이 있다. .claude/projects/ 폴더에 subagents/ 디렉토리가 있는데, 거기 파일이 쌓여 있었다.
비유하면 CEO가 "이 프로젝트 진행해"라고 하면, 팀장이 알아서 담당자를 배치하고 병렬로 돌리는 것이다. CEO는 결과만 받으면 된다.
세 가지가 합쳐지면
단독으로도 유용하지만, 조합하면 진짜 팀이 된다.
상황: 코드 리뷰 + GitHub PR 생성 + 슬랙 알림
1. /review (Skill) → 리뷰 기준과 절차가 정해져 있다
2. GitHub MCP → PR을 자동으로 생성한다
3. Slack MCP → 리뷰 결과를 채널에 알린다
4. 서브에이전트 → 여러 파일을 동시에 리뷰한다혼자 일하는 사람이 이 구조를 갖추면, 실질적으로 3~4명이 일하는 효과가 난다. 매뉴얼이 있고, 도구가 연결돼 있고, 병렬로 돌아가니까.
지금 당장 쓸 수 있는 것
셋 다 한꺼번에 세팅할 필요 없다. 단계적으로 가면 된다.
| 단계 | 뭘 하면 되나 | 체감 |
|---|---|---|
| 1단계 | 기본 Skills 써보기 (/commit, /review) | "매번 안 말해도 되네" |
| 2단계 | 커스텀 Skill 하나 만들기 | "내 업무 패턴이 자동화됐다" |
| 3단계 | MCP 서버 하나 연결 | "GitHub을 터미널에서 조작하네" |
| 4단계 | 복잡한 작업 시켜보기 (서브에이전트 자동 활용) | "혼자인데 팀 같다" |
서브에이전트는 따로 설정할 필요 없다. Claude Code가 필요하면 알아서 만든다. 복잡한 작업을 시키면 자동으로 병렬 처리가 돌아간다.
정리
Skills = 매뉴얼. 반복을 없앤다
MCP = 연결. 외부와 소통한다
서브에이전트 = 팀원. 동시에 일한다이 세 가지를 알면 Claude Code를 "비서"가 아니라 "팀"으로 쓸 수 있다. 1인 창업자, 프리랜서, 사이드 프로젝트 하는 사람에게 이건 구조적 우위다.
다음에는 이 중 하나를 실제로 세팅하는 과정을 다뤄볼 생각이다.
이 글은 Claude Code 플레이북을 만들면서 배운 것을 비개발자 시점으로 정리한 시리즈입니다.
