Claude 에이전트 입문 4: AI를 여러 명 쓰면 더 잘할까
Claude 에이전트 입문 · 4/5 · 공식 문서 확인: 2026년 9월 20일
Subagent는 별도의 컨텍스트에서 제한된 작업을 맡는 보조 에이전트입니다. 긴 조사나 검사를 분리할 수 있지만 작업 지시와 결과를 전달하는 비용도 듭니다. 이번 편에서는 안내문을 수정하지 않고 사실만 대조하는 보조 작업자를 구성합니다.
무엇을 분리하고 무엇을 돌려받을까
메인 대화에서 길게 조사하면 검색 내용과 중간 결과가 그 대화의 컨텍스트를 차지합니다. Subagent에 분리하면 별도 작업 맥락에서 처리하고 필요한 결과를 돌려받을 수 있습니다. 이때 입력 파일, 맡길 질문, 허용 도구, 반환 형식을 함께 정해야 결과를 합치기 쉽습니다. 공식 문서: Subagents
| 정할 항목 | 사실 확인 작업 예시 |
|---|---|
| 입력 | event.txt, announcement.md |
| 질문 | 일시·장소·정원이 일치하는가 |
| 범위 | 파일 읽기와 검색만 수행 |
| 반환 | 불일치 값, 근거 위치, 확인 불가 항목 |
‘문제없음’만 돌려받으면 총괄은 무엇을 검사했는지 알 수 없습니다. 항목별 원본 값과 초안 값을 함께 받으면 검사 결과를 검토할 수 있습니다.
읽기 전용 보조 작업자 설정하기
프로젝트의 .claude/agents/fact-checker.md에 아래 내용을 넣습니다. tools는 이 Subagent가 사용할 도구 목록입니다.
---
name: fact-checker
description: 행사 자료와 안내문의 사실 일치 여부를 검사한다.
tools: Read, Grep, Glob
---
event.txt와 announcement.md를 대조한다.
행사명, 일시, 장소, 정원을 항목별로 검사한다.
원본에 없는 사실은 확인 불가로 표시한다.
항목, 원본 값, 초안 값, 근거 파일을 보고한다.
파일을 수정하지 않는다.Read는 파일 읽기, Grep은 내용 검색, Glob은 이름 패턴으로 파일 찾기에 쓰는 도구입니다. 이 예시는 쓰기·편집·셸 실행 도구를 목록에서 제외합니다. 자연어 지시와 함께 실제로 쓸 도구도 좁힌 구성입니다. 공식 문서: 도구 제한
처음 .claude/agents 폴더를 만들었다면 새 세션에서 파일을 불러온 뒤 다음처럼 요청합니다.
fact-checker Subagent에게 event.txt와 announcement.md의
사실 확인을 맡겨줘. 결과를 받은 뒤 불일치만 정리해줘.
이 단계에서는 초안 파일을 수정하지 마.별도 컨텍스트와 별도 파일 공간은 다릅니다. 여러 Subagent가 같은 작업 폴더에 접근할 수 있습니다. 파일 편집을 허용한다면 담당 파일을 나누거나 worktree 같은 별도 작업 공간을 구성해야 합니다. 위 예제는 보조 작업자에게 읽기만 맡기고 수정은 메인 작업자가 처리하도록 나눴습니다.
한 세션, Subagent, Agent teams의 선택 기준
| 구성 | 맞는 작업 | 추가 부담 |
|---|---|---|
| 한 세션 | 짧은 자료로 순서대로 끝내는 일 | 긴 작업은 컨텍스트가 커짐 |
| Subagent | 조사·검사를 맡기고 결과를 돌려받는 일 | 지시 전달과 결과 통합 |
| Agent teams | 여러 세션이 작업 목록을 공유하며 조율하는 일 | 작업 배정·메시지·중복 실행 관리 |
현재 Claude Code의 Agent teams는 실험 기능이며 기본적으로 꺼져 있습니다. 협업팀은 작업 목록 공유와 여러 작업자의 조율을 제공합니다. 이름이 있는 Subagent도 메시지를 주고받을 수 있으므로 통신 가능 여부만으로 두 방식을 구분하지는 않습니다. 공식 문서: Agent teams
안내문 두 파일을 비교하는 작은 일은 한 세션으로 충분합니다. 위 Subagent 예제의 목적은 역할과 도구 제한을 익히는 것입니다. 긴 자료 여러 묶음을 독립적으로 검토할 때 분업의 이득을 비교해볼 수 있습니다.
분업이 도움이 됐는지 확인하는 방법
같은 자료와 검사 기준으로 한 세션 방식과 Subagent 방식을 각각 실행해보세요. 오류를 찾았는지, 전체 대기 시간이 줄었는지, 같은 파일을 반복해서 읽었는지, 결과를 합치는 수고가 늘었는지를 비교합니다. 작업자를 늘렸다는 사실만으로 속도나 품질이 좋아졌다고 결론 내릴 수는 없습니다.
분업은 맡길 일을 독립적으로 설명할 수 있을 때 시작하기 쉽습니다. 한 작업자의 결과가 나와야 다음 작업을 시작할 수 있다면 먼저 순차 실행으로 구성하고, 서로 기다릴 필요가 없는 부분을 찾아 분리하세요.
시리즈 이어 읽기
- AI가 일을 끝내는 과정
- 기억과 작업 맥락
- 설명서·도구·권한
- 보조 작업자와 협업팀 · 현재 글
- 검증과 다음 작업의 개선