이전 페이지에서 Solo → Pipeline → Team → Orchestra 4단계 성장 경로를 배웠습니다.
이 페이지에서는 그 구조를 실제로 구현하는 4가지 도구를 익힙니다.
4가지 도구, 한 줄로 이해하기
팀 구조 설계에서 배운 것과 이 도구의 관계
이전 페이지의 Solo → Orchestra 4단계, 각 단계를 실현하는 도구가 다릅니다
| 성장 단계 | 핵심 구조 | 이 단계를 만드는 도구 |
|---|---|---|
| Solo | AI 한 명이 처음부터 끝까지 | 에이전트 하나로 충분 |
| Pipeline | 순서대로 바통 넘기기 + 품질 관문 | 에이전트 + 스킬(단계별 지시서) |
| Team | 여러 AI가 동시에 나눠서 일 | 에이전트 + 서브에이전트(병렬 전문가) |
| Orchestra | 지휘자 AI가 자율 판단 · 동적 조율 | 에이전트 + 서브에이전트 + 스킬 + 후크 전부 |
Orchestra가 가능하려면 4가지 도구를 모두 이해해야 합니다. 각 도구가 어떤 역할을 하는지 정확히 알아야 하네스 엔지니어링을 할 수 있습니다. 이 페이지의 목표가 바로 그것입니다.
Claude Code 자동화 구조
요리 주방으로 이해하는 전체 구조
레스토랑 주방의 역할 분담으로 에이전트·서브에이전트·스킬의 관계를 이해해보세요
에이전트
역할 분담 매트릭스
| 구분 | 자율 판단 | 최종 결정 | 방향 전환 |
|---|---|---|---|
| 에이전트 (헤드 셰프) | ✓ | ✓ | ✓ |
| 서브에이전트 (셰프) | ✓ | ✗ | ✗ |
| 스킬 (도구) | ✗ | ✗ | ✗ |
작업 흐름 예시: 소고기 안심 코스
- 헤드 셰프가 "소고기 안심 메뉴"를 지시
- 육류 셰프: 미디엄 레어 판단 / 전채 셰프: 루꼴라 선택 / 디저트 셰프: 셔벗 결정 → 동시 작업
- 스킬 실행: 오븐 230°C 8분 · 내부온도 55°C 알림 · 소스 150g 측정
- 헤드 셰프 최종 판단: "소스 농도를 줄여" → 서브에이전트가 조정 후 완성
실무에서는 이렇게 쓰입니다
주방 비유를 실제 업무에 대입하면 이런 모습입니다
① 에이전트 (Agent)
일상 비유: "알아서 해주는 만능 비서"
에이전트는 Solo 단계의 핵심이자, 모든 상위 단계의 기반입니다. Solo에서 배운 "AI에게 지시하기"가 바로 에이전트를 사용하는 것이었습니다. Pipeline · Team · Orchestra 어떤 구조든 에이전트 없이는 시작할 수 없습니다.
에이전트는 "이것 좀 해줘"라고 말하면 알아서 척척 처리하는 비서같은 존재입니다. 단순히 질문에 답하는 것을 넘어서, 직접 파일을 열고, 수정하고, 검색하고, 명령을 실행합니다.
"회의록 정리해줘" → AI가 파일을 열고 → 내용을 분석하고 → 정리된 문서를 만들어 줌. 전부 자동!
에이전트는 최종 결정권을 가진 팀장이고, 서브에이전트는 팀장이 부르는 전문 팀원입니다. 팀장은 1명, 팀원은 여러 명이 동시에 일합니다.
- 📂 파일 관리 파일을 직접 열고, 만들고, 수정
- ⌨️ 작업 실행 필요한 작업을 자동으로 실행
- 🔍 내용 검색 원하는 파일이나 내용을 알아서 찾아냄
- 🌐 웹 검색 인터넷에서 최신 정보를 조회
- 터미널에서
claude를 입력해 Claude Code를 실행하세요 - "이 폴더에 어떤 파일이 있는지 알려줘"라고 입력하세요
- 에이전트가 직접 파일 목록을 탐색하고 정리해주는 것을 확인하세요 — 사람이 아닌 AI가 스스로 도구를 사용합니다
에이전트는 "알아서 해줘"라고 말하면 도구를 직접 써서 처리하는 AI 비서입니다. 다음은 이 비서에게 전문 팀원을 붙여주는 방법입니다.
② 서브에이전트 (Sub-Agent)
일상 비유: "전문가 팀원을 불러 동시에 일시키기"
Team 단계에서 "여러 AI가 동시에 나눠서 일한다"고 배웠습니다. 그때 시장 분석 · 재무 분석 · 경쟁사 분석을 동시에 돌리던 것, 그게 바로 서브에이전트입니다. 에이전트(팀장)가 서브에이전트(팀원)를 불러서 병렬로 처리시키는 구조입니다.
팀장 혼자 모든 일을 하면 느리겠죠? 서브에이전트는 전문가 팀원을 불러 여러 일을 동시에 시키는 것과 같습니다. 탐색 전문, 기획 전문, 실행 전문, 각자 맡은 일을 동시에 처리합니다.
| 전문가 | 하는 일 | 언제 부를까? |
|---|---|---|
| 🔍 탐색 전문가 | 폴더 안에서 파일·내용 검색 | 원하는 파일을 찾을 때 |
| 📋 기획 전문가 | 작업 계획과 전략 수립 | 복잡한 작업을 시작할 때 |
| ⚡ 실행 전문가 | 작업 실행 (정리, 변환 등) | 무언가를 직접 실행할 때 |
| 🧩 종합 전문가 | 여러 단계 조사·분석 | 폭넓은 조사가 필요할 때 |
팀장(에이전트)이 혼자 다 하지 않고, 전문가(서브에이전트)를 불러서 동시에 처리 → 더 빠르고 정확
- Claude Code에서 문서가 여러 개 있는 폴더를 여세요
- "이 폴더의 파일들을 분석하고, 각 문서가 무슨 내용인지 동시에 조사해줘"라고 입력하세요
- 화면에 여러 서브에이전트가 동시에 실행되는 모습이 표시됩니다 — 각각이 별도 파일을 분석합니다
서브에이전트는 에이전트가 부르는 전문가 팀원입니다. 핵심은 "동시에 여러 일을 처리"한다는 것. 다음은 반복 작업을 버튼 하나로 만드는 스킬입니다.
③ 스킬 (Skill)
일상 비유: "자주 쓰는 업무를 버튼 하나로 실행하는 매크로"
Pipeline 단계에서 "각 단계마다 담당자가 다르고, 기준 미달이면 되돌린다"고 배웠습니다. 이 각 단계의 지시서를 미리 저장해둔 것이 스킬입니다. 스킬을 만들어두면 Pipeline의 각 공정을 한 줄 명령어로 즉시 실행할 수 있습니다.
매번 같은 지시를 반복하기 귀찮으시죠? 스킬은 자주 하는 작업을 미리 저장해두고, 한 줄 명령어로 바로 실행하는 기능입니다. 엑셀의 매크로, 카카오톡의 빠른 답장 템플릿과 비슷합니다.
- ① 미리 지시서를 작성해둡니다 (텍스트 파일 하나)
- ② 실행할 때
/project:리뷰같은 짧은 명령어를 입력하면 - ③ Claude가 미리 작성된 지시서대로 자동으로 실행합니다
| 구분 | 저장 위치 | 누가 쓸 수 있나 | 실행 방법 |
|---|---|---|---|
| 팀 공용 스킬 | .claude/commands/ | 팀 전체 | /project:이름 |
| 개인 스킬 | ~/.claude/commands/ | 나만 | /user:이름 |
실행할 때 추가로 입력하는 내용이 지시서의 빈칸에 들어갑니다. 예: /project:review 3월보고서 → "3월보고서"가 대상에 자동 입력됩니다.
- Claude Code에서 "보고서 검토 스킬을 만들어줘"라고 요청하세요
- Claude가 스킬 파일을 자동으로 생성합니다
/project:review로 바로 실행해보세요
스킬은 자주 하는 작업을 저장해두고 한 줄로 실행하는 매크로입니다. 다음은 "이런 상황이면 자동 실행"을 설정하는 후크입니다.
④ 후크 (Hook)
일상 비유: "특정 상황이 되면 자동으로 울리는 알람"
Orchestra 단계에서 "목표만 말하면 AI가 알아서 한다"고 배웠습니다. 이것이 가능하려면 "이 상황이 되면 자동으로 다음 단계를 실행"하는 장치가 필요합니다. 그 장치가 바로 후크입니다. 후크가 있어야 사람이 개입하지 않아도 시스템이 스스로 돌아갑니다.
출근하면 자동으로 컴퓨터가 켜지고, 퇴근하면 자동으로 보안이 설정되는 것처럼, 후크는 "이런 상황이 되면 자동으로 이것을 실행해"라고 미리 정해두는 규칙입니다.
| 언제 | 설명 | 이렇게 쓸 수 있어요 |
|---|---|---|
| 🔒 작업 시작 전 | AI가 도구를 쓰기 전에 먼저 실행 | 위험한 명령 자동 차단 |
| ✅ 작업 완료 후 | AI가 파일을 수정한 직후 실행 | 문서 자동 정리·검사 |
| 🔔 알림 발생 시 | Claude가 알림을 보낼 때 실행 | Slack/이메일로 알림 전달 |
| 🏁 전체 작업 끝날 때 | 모든 작업이 끝나면 실행 | 결과 보고서 자동 생성 |
위 코드를 직접 작성할 필요 없습니다. Claude에게 "파일 수정 후 알림 후크를 만들어줘"라고 말하면 자동으로 생성해줍니다.
후크 = "이때 → 이걸 자동 실행". 설정 파일 하나로 수동 작업을 줄이는 가장 강력한 방법입니다.
- Claude Code에서 "파일 저장 후 자동으로 맞춤법 검사하는 후크를 만들어줘"라고 요청하세요
- Claude가
.claude/settings.json에 후크 설정을 자동으로 생성합니다 - 이후 파일을 수정할 때마다 자동으로 검사가 실행됩니다
에이전트(총괄) → 서브에이전트(전문가) → 스킬(매크로) → 후크(자동 실행). 이 4가지를 조합하면 진정한 자동화가 시작됩니다.
이 구조를 익힌 사람들의 변화
* AI 자동화 워크숍 참가자 기준 평균 체감 효과
도구를 이해했다면, 이제 조합할 차례입니다
팀 구조 설계(Solo → Orchestra)를 배웠고, 4가지 도구(에이전트 · 서브에이전트 · 스킬 · 후크)를 익혔습니다.
이제 이 둘을 결합해서 나만의 자동화 시스템을 설계하는 단계로 가세요.