에이전트 팀(Agent teams)

리더 로봇이 각자 책상에 앉은 팀원 로봇 세 대에게 할 일 카드를 나눠 주고, 그 사이로 편지 봉투가 오가는 그림입니다.

무엇인가요

팀은 여러 개의 세션이 한 가지 일을 함께 하는 기능입니다. 한 세션이 팀 리더가 되어 일을 나누고, 할 일을 맡기고, 결과를 모읍니다. 팀원은 저마다 을 가진 완전한 Claude Code 세션이고, 우편함(mailbox)으로 서로 직접 메시지를 보냅니다. 팀 전체가 할 일 목록 하나를 함께 쓰며, 할 일마다 대기·진행 중·완료 세 가지 상태가 있습니다. 아직 실험 기능이라 직접 켜야 쓸 수 있습니다.

어떻게 돌아가나요

실험 설정을 켭니다
할 일과 원하는 팀원을 말로 부탁합니다
팀원이 할 일을 맡고 서로 대화합니다
리더가 결과를 모아 정리합니다

이렇게 씁니다

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS

이나 settings.json 의 env 에 1 로 두면 켜지고, 0 으로 두면 다시 꺼집니다.
teammateMode

팀원이 보이는 방식을 고릅니다. 기본값 in-process 는 한 안에 모두 두고, 나 iTerm2 가 있으면 팀원마다 창을 나눠 보여 줄 수 있습니다.
에이전트 패널 — 리더 터미널에서 화살표 키로 팀원을 고르고 Enter 를 누르면 그 팀원의 작업을 보고 직접 말을 걸 수 있습니다.
리뷰 — 예를 들어 팀원 세 명에게 하나를 ·성능·테스트 범위로 나눠 검토하게 합니다.

주의할 점

팀원마다 따로 가 돌기 때문에 한 세션보다 을 훨씬 많이 쓰니, 처음에는 3~5명으로 시작합니다. 두 팀원이 같은 파일을 고치면 서로 덮어쓰므로 파일을 나눠 맡기고, 만든 세션에게 결과만 돌려주는 와 헷갈리지 않도록 합니다. /resume 으로 세션을 이어도 in-process 팀원은 돌아오지 않고, claude -p 실행에서는 팀원을 만들지 않습니다.

원문과 공식 문서

이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.

알림

알림을 켜는 방법

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

원문과 공식 문서

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

함께 보면 좋은 용어

원문과 공식 문서