서브에이전트를 전부 Haiku로 돌리려면 환경변수 두 개를 넣는다, --subagents 플래그는 없다

X에서 같은 내용의 글 두 개가 합쳐 좋아요 1만 개를 받았다. "Anthropic 공식 팁"이라며 claude --advisor opus --subagents haiku를 치라고 한다. 절반만 맞다. --advisor opus는 실제 기능이지만 --subagents 플래그는 Claude Code 문서와 최근 아홉 번의 릴리스 노트 어디에도 없다. 치면 그냥 오류가 난다.

서브에이전트를 전부 Haiku 5.5로 돌리려면 설정 파일의 env에 두 줄을 넣는다. 첫 줄만 넣으면 정의에 model을 따로 적어 둔 서브에이전트는 그 모델로 돈다. 두 번째 줄이 그것까지 덮어쓴다(v2.1.257 이상).

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

어드바이저는 명령 한 줄이다. 세션 안에서 /advisor opus를 치거나 시작할 때 플래그로 준다.

claude --advisor opus

적용됐는지 보려면 서브에이전트가 도는 동안 /tasks를 연다. 줄마다 모델 이름이 나온다. haiku 별칭이 Haiku 5.5를 가리키려면 v2.1.293 이상이어야 하니 claude update부터 한다.