AI 요약
Agent Teams는 Claude Code의 Subagents를 독립된 프로세스로 분리하고 상호 메시징을 가능하게 하는 실험적 기능입니다. 각 에이전트는 파일 시스템 기반의 메일박스 메커니즘을 통해 상태를 유지하며 협력하며, tmux나 iTerm2와 연동하여 시각적으로 병렬 작업을 관리할 수 있습니다. 특히 대규모 작업 시 토큰 소비를 줄이기 위해 하위 에이전트에게는 Opus 대신 Sonnet이나 Haiku 모델을 할당하는 최적화 기법이 권장됩니다.
핵심 인사이트
- 스테이트풀 협업: 단순한 하위 작업을 넘어 각 에이전트가 독립된 프로세스로서 상태를 유지하고 양방향으로 소통하는 구조를 가집니다.
- 자원 최적화: 모든 에이전트에 고성능 모델을 사용하기보다 작업 성격에 맞춰 하위 모델을 유도함으로써 API 호출 제한 및 비용 문제를 해결합니다.
- 인프라 독립성: 복잡한 메시징 서버 없이 파일 잠금과 추론 능력만으로 안정적인 에이전트 간 통신 시스템을 구현했습니다.
주요 디테일
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1환경 변수를 설정하여 해당 기능을 활성화할 수 있습니다.--teammate-mode옵션을 통해 tmux(추천), iTerm2, 또는 단일 프로세스(in-process) 실행 모드를 선택할 수 있습니다.- 통신 데이터는
~/.claude/teams/경로의 JSON 파일을 통해 폴링(Polling) 방식으로 주고받습니다. - 프롬프트에 직접 "Use Sonnet/Haiku for the teammate"라고 명시하는 것이 하위 에이전트의 모델을 제어하는장장 확실한 방법입니다.
- OpenRouter나 Ollama와 같은 외부 API를 활용한 환경 설정도 지원하여 모델 유연성을 높였습니다.
출처:hatena