Claude Code 완전 가이드 · 3 min read
Agent Teams
여러 Claude Code 세션이 공유 태스크 리스트를 통해 병렬 협업하는 Agent Teams와, 격리된 실행 환경을 제공하는 Worktree를 다룹니다.
Agent Teams 아키텍처
+==========================================+
| AGENT TEAMS |
+==========================================+
| |
| Team Lead (사용자와 직접 소통) |
| | |
| +-- Shared Task List |
| | | |
| +------+------+------+ |
| | | | | |
| v v v v |
| 팀원A 팀원B 팀원C 팀원D |
| (1M) (1M) (1M) (1M) |
| | | | | |
| +------+------+------+ |
| | |
| Mailbox 메시징 |
| (팀원 간 직접 소통 가능) |
+==========================================+
Teams vs Sub-Agents
Sub-Agents
- 작업자가 결과만 보고
- 단방향 통신
- 간단한 위임 작업에 적합
Agent Teams
- 팀원 간 발견 사항 공유
- 양방향 Mailbox 메시징
- 복잡한 협업 작업에 적합
시작하기
# 환경 변수 설정
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
# tmux로 다중 pane 설정
brew install tmux
tmux new-session -s claude-team
# 3-5명 팀원으로 시작, 팀원당 5-6개 태스크 할당Worktree 격리
Git worktree를 활용한 병렬 실행으로, 같은 레포에서 충돌 없이 동시 작업합니다.
# CLI에서 worktree 모드
claude --worktree my_feature
# 서브에이전트에서 worktree 격리
# agent frontmatter: isolation: worktree/batch 스킬과 Worktree
번들 스킬 /batch는 worktree를 내부적으로 활용합니다:
- 코드베이스를 리서치하고 작업을 5-30개 단위로 분해
- 각 단위마다 격리된 worktree에서 백그라운드 에이전트 생성
- 각 에이전트가 구현, 테스트, PR 생성을 자율 수행
TIP: 셸 별칭(za, zb, zc)을 만들어 단일 키스트로크로 worktree 전환하세요. Desktop 앱에는 전용 worktree 체크박스가 있습니다. — Boris Cherny