한 줄 요약
Anthropic이 Opus 4.6과 함께 공식 지원하기 시작한 "Claude Code Teams(에이전트 팀)" 기능 — 하나의 메인 클로드 코드가 독립적인 여러 클로드 코드 인스턴스를 오케스트레이션하는 방법과, 기존 서브에이전트와의 차이·설정·비용 트레이드오프를 실연하는 영상.
핵심 내용
- 에이전트 팀은 메인 클로드 코드가 "오케스트레이터"가 되어 독립적인 여러 클로드 코드 인스턴스를 생성·관리하는 기능. 각 인스턴스는 자기만의 대화창과 컨텍스트 윈도우를 가지며, 사용자가 팀원에게 직접 태스크를 던질 수도 있다.
- 기존 서브에이전트와의 차이: 서브에이전트는 같은 클로드 코드 창 안에서 실행되어 결과만 메인에 보고하고, 시작 후에는 건드릴 수 없었다. 반면 에이전트 팀은 완전히 독립적인 인스턴스로, 팀원끼리 실시간으로 직접 메시지를 주고받으며 공유 작업 목록(task list)을 함께 조율한다.
- 적합한 작업: 연구/검토(여러 팀원이 한 문제의 다른 측면을 동시 조사 후 발견을 공유·반박), 새로운 모듈/기능(팀원이 각자 별도 부분 소유), 프론트엔드/백엔드 같은 교차 계층 조율. 부적합: 순차적 작업·동일 파일 편집·종속성 많은 작업은 단일 세션이나 서브에이전트가 더 효과적.
- 설정:
settings.json에 실험 플래그claude-code-experiment-agent-teams: 1을 넣고, teammate 모드를teamwork(권장) 또는inprocess로 지정. teamwork는 tmux로 스플릿 페인을 띄워 각 팀원 창을 직접 보고 타이핑 가능, inprocess는 한 창에서 Shift 위아래로 팀원 전환. 플래그로 강제 실행도 가능. 베타라서 설정이 안 먹을 때가 있어 재실행이 필요. - tmux는 프로그래매틱하게 패널을 만들 수 있어 클로드가 자동 제어하기 좋다. macOS에서 가장 잘 작동(Windows는 불안정 가능). 워프/커서/안티그래비티 등 어떤 터미널에서 실행해도 무방.
- 작업 종료 시 각 에이전트는 자동 디스포즈(삭제)되지만, 지정한 팀 이름으로 정보가 파일에 저장되므로 그 이름으로 작업을 다시 불러올 수 있다.
주요 주장 / 데이터
- 에이전트 팀은 Opus 4.6 모델 출시보다 "훨씬 더 큰 업데이트"라는 강한 평가 (자막상 "오퍼스 4.6"으로 표기, 모델 버전은 자막 오인식 가능성 있어 추정).
- 토큰 비용 경고: 팀 조율 오버헤드 때문에 단일 세션보다 "훨씬 더 많은" 토큰을 사용. 예로 에이전트 4개를 병렬 실행하면 약 4배의 토큰을 쓴다. 원래 서브에이전트가 클로드 코드에서 가장 비싼 기능 중 하나였는데, 에이전트 팀은 그보다도 더 많은 토큰을 쓴다.
- 실전 팁: "팀으로 구성해 작업해 줘"라고만 하면 그냥 서브에이전트를 만드는 경우가 많아, 공식 에이전트 팀 문서 링크를 프롬프트에 넣어 주면 적합하게 구성될 확률이 훨씬 높아진다. 팀 이름을 정해 주는 것이 생각보다 중요.
- 데모: 검증 스킬 4개를 팀메이트 4명에게 각각 실행시키는 사례, 그리고 개발자 블로그를 코디네이터+레이아웃/블로그 엔지니어+컨텐츠 스타일리스트 팀으로 분할 구현하는 사례.
출처 정보
- URL: https://www.youtube.com/watch?v=Gb2VMWrUmZ0
- 채널: 코드팩토리 (2026-07-12 yt-dlp 조회로 확인; 기존 표기 '미상')
- 재생목록: PLUGinkN1Rwv4KGXiVEmSBzglfAoTxyXd3