Claude Code 최신 버전
Opus 4.6 기준
Claude Code Agent Teams, 쓰면 비용이 7배 나오는 이유
Claude Code Agent Teams는 2026년 2월 Opus 4.6과 함께 공개된 기능입니다. “AI 팀원 여러 명이 동시에 코딩해 준다”는 개념이 매력적인 건 사실이지만, 공식 문서를 먼저 보고 나면 생각이 좀 달라집니다. 기본값이 비활성화되어 있고, 켜는 순간 토큰 소비 방식이 완전히 바뀝니다.
Agent Teams란 무엇인가 — 공식 정의부터
Claude Code Agent Teams는 하나의 세션이 팀장(Team Lead) 역할을 맡고, 여러 개의 독립적인 Claude Code 인스턴스를 팀원(Teammate)으로 소환해 작업을 분산시키는 기능입니다. 2026년 2월 5일 Claude Opus 4.6 출시와 동시에 연구 프리뷰(Research Preview)로 공개됐습니다. (출처: Anthropic 공식 블로그, 2026.02.05)
핵심 구조는 이렇습니다. 팀장이 공유 작업 목록(Task List)을 만들고, 팀원들이 각자 독립된 컨텍스트 창에서 작업을 가져가 처리합니다. 팀원끼리는 직접 메시지를 주고받을 수 있고, 작업 완료 후에는 팀장에게 자동으로 알림이 전달됩니다. 팀원들의 작업 결과는 팀장 컨텍스트로 자동 병합되지 않고, 팀장이 직접 종합(synthesize)해야 합니다.
💡 공식 발표문과 실제 아키텍처 문서를 같이 놓고 보니 이런 차이가 보였습니다 — 팀원이 여럿이어도 팀장의 컨텍스트는 따로 불어납니다. “AI가 알아서 다 합친다”는 개념이 아닙니다.
팀 구성 정보는 로컬에 저장됩니다. 팀 설정은 ~/.claude/teams/{team-name}/config.json에, 작업 목록은 ~/.claude/tasks/{team-name}/에 기록됩니다. (출처: code.claude.com 공식 문서)
기본값이 비활성화인 이유가 있습니다
Agent Teams는 켜고 싶다고 바로 켜지는 기능이 아닙니다. 공식 문서에는 다음과 같이 나와 있습니다: “Agent teams are disabled by default.” 사용하려면 환경 변수 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1을 직접 설정해야 합니다. (출처: code.claude.com/docs/en/agent-teams, 2026.02 기준)
settings.json에 넣는 방법은 아래와 같습니다.
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}이름 앞에 붙은 EXPERIMENTAL이 핵심 단서입니다. Anthropic이 이 기능을 아직 정식 출시가 아닌 실험 단계로 분류했다는 뜻입니다. 공식 문서에서도 명확히 “Agent teams are experimental”로 못 박아 둡니다. 정식 출시 전이기 때문에 기능이 언제든 달라질 수 있습니다.
💡 기본값을 OFF로 설정한 건 단순한 보수적 접근이 아닙니다. 아래에서 설명할 7배 토큰 소비, 세션 복구 불가, 중첩 팀 불가 등 아직 해결 중인 구조적 제약들이 남아 있기 때문입니다.
split-pane 화면 분할 모드로 팀원을 보려면 tmux 또는 iTerm2가 별도로 필요합니다. VS Code 내장 터미널, Windows Terminal, Ghostty에서는 split-pane 모드가 지원되지 않습니다. (출처: code.claude.com/docs/en/agent-teams, Limitations 항목)
Subagent와 뭐가 다른지, 돈이 달라집니다
Claude Code에는 비슷해 보이는 두 가지 병렬 처리 방식이 있습니다. Subagent와 Agent Teams입니다. 이 둘을 혼용하면 예산 계획이 틀립니다. 공식 문서의 비교표를 기준으로 정리하면 이렇습니다.
| 항목 | Subagent | Agent Teams |
|---|---|---|
| 팀원 간 직접 소통 | ❌ 팀장 경유만 가능 | ✅ 직접 메시지 가능 |
| 컨텍스트 창 | 독립 / 결과만 반환 | 독립 / 완전 자율 |
| 토큰 비용 | 낮음 (요약 반환) | 높음 (팀원 수 비례) |
| 공유 작업 목록 | 없음 | 있음 (자동 클레임) |
| 최적 사용처 | 결과만 필요한 단발 작업 | 토론·협업이 필요한 복잡 작업 |
(출처: code.claude.com/docs/en/agent-teams, Compare with subagents 항목)
Subagent는 작업 결과를 요약해서 팀장 컨텍스트로 돌려주는 구조라 전체 토큰 소비가 적습니다. Agent Teams는 팀원 각자가 독립된 Claude 인스턴스이기 때문에 팀원 수만큼 토큰이 증가합니다. 3명짜리 팀이면 대략 3배 구조, 거기에 팀원 간 메시지 교환과 plan mode가 더해지면 7배까지 올라갑니다.
공식 문서가 말하는 7배 비용의 실체
Anthropic의 공식 비용 문서(code.claude.com/docs/en/costs)에는 이렇게 나와 있습니다: “Agent teams use approximately 7x more tokens than standard sessions when teammates run in plan mode.” plan mode란 팀원이 실제 코드 변경을 하기 전에 계획을 먼저 세우고 팀장 승인을 받는 모드입니다.
단일 세션의 평균 비용이 개발자당 하루 약 $6이고, 90%의 사용자는 $12 이하로 유지된다고 같은 문서에서 밝히고 있습니다. 여기에 7배를 단순 적용하면 plan mode Agent Teams는 하루 $42~$84까지 올라갈 수 있다는 계산이 나옵니다. 실제로 Reddit에서는 5개월 동안 API 비용으로 $4,000이 나왔다는 사례도 등장합니다. (출처: r/ClaudeAI)
계산 예시 (단순 추정, 공식 평균 기준)
단일 세션 일 평균 $6 × 7 = 약 $42/일 (plan mode, 3~5명 팀 기준 추정치)
※ 팀 규모, 작업 복잡도, 컨텍스트 길이에 따라 크게 달라집니다. Anthropic은 “large variance”를 공식 인정합니다.
비용을 낮추는 공식 권고 방법도 문서에 명시되어 있습니다. 팀원 모델을 Opus 대신 Sonnet으로 지정하고, 팀원 수는 3~5명을 넘기지 않으며, 팀원이 유휴 상태일 때 cleanup을 바로 실행하는 것입니다. 유휴 팀원도 토큰을 소비하기 때문입니다. (출처: code.claude.com/docs/en/costs, Agent team token costs 항목)
팀원 모델을 Sonnet으로 설정하는 방법은 간단합니다. 팀 생성 시 프롬프트에 Use Sonnet for each teammate라고 명시하면 됩니다.
Agent Teams가 진짜 효과적인 경우 4가지
공식 문서는 Agent Teams의 “가장 강력한 사용처”를 명확히 구분하고 있습니다. 잘 맞는 작업 유형이 따로 있습니다. (출처: code.claude.com/docs/en/agent-teams, When to use agent teams 항목)
병렬 코드 리뷰
보안, 성능, 테스트 커버리지를 팀원 각각이 동시에 검토하는 구조입니다. 한 명이 순차적으로 리뷰하면 앞서 발견한 문제에 편향되지만, 팀원이 독립적으로 보면 더 넓은 범위를 잡을 수 있습니다.
경쟁 가설 디버깅
원인 불명의 버그를 각 팀원이 서로 다른 가설로 접근해 교차 검증하는 방식입니다. 공식 예시에서는 팀원들이 서로 상대방 이론을 반증하려 시도하도록 설계하는 것을 권장합니다.
독립 모듈 신규 개발
프론트엔드, 백엔드, 테스트를 각 팀원이 동시에 맡아 개발하는 크로스레이어 작업입니다. 파일이 겹치지 않도록 영역을 나눠야 합니다. 같은 파일을 두 팀원이 수정하면 덮어쓰기가 발생합니다.
리서치·조사 작업
에이전트 팀 처음 쓰는 경우라면 코드 작성보다 리서치부터 시작하는 것이 권장됩니다. 코드 작성에서의 파일 충돌 같은 협업 리스크 없이 병렬 탐색의 가치를 먼저 확인할 수 있습니다.
반대로 효과가 없는 경우도 명확합니다. 공식 문서의 표현을 그대로 옮기면 “Agent Teams are NOT great for sequential work where step 2 depends on step 1″입니다. 순차 작업, 같은 파일 편집, 단순 버그 수정처럼 한 세션이 집중하는 게 더 빠른 경우에는 오히려 손해입니다. (출처: Level Up Coding, ZIRU, 2026.02.06)
공식 문서에 명시된 현재 한계 7가지
공식 문서(Limitations 항목)에 현재 존재하는 제약이 직접 나열되어 있습니다. 이 부분이 기존 블로그 대부분에서 언급되지 않은 내용입니다. (출처: code.claude.com/docs/en/agent-teams, 2026.03 기준)
① 세션 재개 시 in-process 팀원 복구 불가
/resume와 /rewind가 in-process 팀원을 복구하지 않습니다. 세션 재개 후 팀장이 존재하지 않는 팀원에게 메시지를 보내는 상황이 발생할 수 있습니다.
② 작업 상태 지연 문제
팀원이 작업을 완료했는데도 상태가 ‘완료’로 표시되지 않는 경우가 있습니다. 이 경우 의존 작업이 블록됩니다. 직접 상태를 갱신하거나 팀장에게 지시해야 합니다.
③ 종료 속도가 느림
팀원은 현재 요청이나 도구 호출이 완전히 끝난 후에야 종료됩니다. 즉시 종료를 기대하면 안 됩니다.
④ 세션당 한 팀만 운영 가능
팀장 한 명이 동시에 하나의 팀만 관리할 수 있습니다. 새 팀을 만들기 전에 기존 팀을 cleanup해야 합니다.
⑤ 중첩 팀 구성 불가
팀원은 자신의 팀이나 하위 팀원을 생성할 수 없습니다. 팀 생성은 팀장만 가능합니다.
⑥ 팀장 교체 불가
팀을 만든 세션이 팀 수명 내내 팀장입니다. 팀원을 팀장으로 승격하거나 리더십을 이전하는 기능이 없습니다.
⑦ split-pane 지원 터미널 제한
VS Code 내장 터미널, Windows Terminal, Ghostty에서는 split-pane 모드를 쓸 수 없습니다. tmux나 iTerm2만 지원합니다.
💡 공식 발표에선 기능의 강점을 먼저 소개하지만, Limitations 항목을 보면 아직 해결 중인 구조적 제약들이 남아 있습니다. 특히 ①번은 장시간 작업 중 연결이 끊기는 상황에서 실질적인 손실로 이어질 수 있습니다.
자주 묻는 질문
마치며
Claude Code Agent Teams는 분명 강력한 기능입니다. 병렬 코드 리뷰, 경쟁 가설 디버깅, 크로스레이어 독립 모듈 개발에선 실제로 단일 세션을 앞서는 결과를 낼 수 있습니다. 다만 “켜면 AI 팀원이 알아서 다 해준다”는 개념으로 접근하면 비용 충격을 피하기 어렵습니다.
plan mode 기준 7배 토큰 소비, 기본값 비활성화, 세션 재개 시 팀원 복구 불가, 세션당 1팀 한정, 중첩 팀 불가 — 이 5가지만 먼저 인식해 두면 충분히 효과적으로 쓸 수 있는 기능입니다. 특히 팀원을 Sonnet으로 설정하고, 팀 규모를 3~5명으로 유지하며, 작업이 끝나면 cleanup을 즉시 실행하는 습관이 비용 관리의 핵심입니다.
실험 단계인 만큼 앞으로 제약들이 해제될 가능성도 있습니다. 공식 changelog와 문서를 주기적으로 확인하는 것이 가장 확실한 방법입니다.
본 포스팅 참고 자료
※ 본 포스팅은 2026년 3월 21일 기준으로 작성되었습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. Agent Teams는 현재 실험적(Experimental) 기능으로, Anthropic이 공식 안내 없이 기능·스펙·비용 구조를 변경할 수 있습니다. 투자·의사결정 전 반드시 공식 문서를 직접 확인하시기 바랍니다.
댓글 남기기