클로드 코드 워크플로 에이전트만 한 모델로 돌리는 환경변수 설정법

클로드 코드(Claude Code) v2.1.296에 워크플로 에이전트만 한 모델로 묶는 환경변수 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL이 생겼다. 다른 서브에이전트는 각자 정해 둔 모델을 그대로 쓴다.

설정 파일의 env에 넣는다.

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL": "<모델>"
  }
}

모든 서브에이전트의 기본 모델을 정하는 CLAUDE_CODE_SUBAGENT_MODEL은 haiku 같은 별칭이나 전체 모델 이름을 받는다. 새 변수의 값 형식은 체인지로그에 따로 적혀 있지 않고 환경변수 문서에도 아직 없다.

워크플로 에이전트가 많이 도는 작업이면 이 변수로 워크플로만 가벼운 모델에 두고, 코드를 고치는 서브에이전트는 원래 모델로 둔다. v2.1.296보다 낮은 버전이면 claude update로 먼저 올린다.