클로드 코드 에이전트 팀을 오퍼스 리드와 하이쿠 팀원으로 꾸리는 법 (--teammate-mode는 화면 배치 옵션이다)

X에서 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1을 켜고 claude --model opus --teammate-mode auto로 띄우면 오퍼스가 팀을 이끌고 하이쿠 팀원이 떼로 붙는다는 글이 돌았다. 환경변수는 맞다. --teammate-mode는 팀원 모델과 상관없이, 팀원을 터미널 안에 둘지(in-process) tmux·iTerm2 분할 창으로 띄울지만 정한다.

1. 에이전트 팀을 켠다. 실험 기능이라 기본값은 꺼짐이다.

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

1. 리드 세션을 오퍼스로 띄운다.

claude --model opus

1. 팀을 꾸리라고 할 때 팀원 모델을 프롬프트에 적는다.

팀원 3명을 띄워서 보안, 성능, 테스트를 하나씩 맡겨. 팀원은 모두 Haiku로 돌려.

팀원 모델은 이 순서로 정해진다. 프롬프트에 적은 모델이 먼저고, 서브에이전트 정의로 띄운 팀원이면 그 정의의 model, 그다음 CLAUDE_CODE_SUBAGENT_MODEL 환경변수, 마지막이 리드 모델이다. 매번 적기 번거로우면 CLAUDE_CODE_SUBAGENT_MODEL=haiku를 넣어 두는데, 이 값은 일반 서브에이전트에도 똑같이 걸린다. 예전 teammateDefaultModel 설정은 v2.1.234에서 없어져 남아 있어도 무시된다.

--teammate-mode auto(설정 파일이라면 "teammateMode": "auto")는 분할 창이 필요할 때만 쓴다. tmux 안이거나 iTerm2에 it2 CLI가 깔려 있으면 분할 창으로, 아니면 터미널 안에서 돈다. 팀원마다 클로드 인스턴스가 따로 떠서 토큰은 세션 하나보다 훨씬 많이 쓴다.