클로드 코드 서브에이전트의 노력 수준을 환경변수로 따로 정하는 설정법

클로드 코드(Claude Code) 2.1.316(10월 31일)에 CLAUDE_CODE_SUBAGENT_EFFORT 환경변수가 들어왔다. 서브에이전트가 따로 지정된 노력 수준(effort) 없이 돌 때 쓸 값을 정한다. 이 변수가 없으면 서브에이전트는 세션의 노력 수준을 그대로 물려받는다. 메인 대화는 xhigh로 두고 탐색용 서브에이전트만 가볍게 돌리고 싶을 때 쓴다.

export CLAUDE_CODE_SUBAGENT_EFFORT=low
claude

체인지로그에는 값 형식이 적혀 있지 않다. 서브에이전트 문서의 effort 필드가 받는 low, medium, high, xhigh, max 중 모델이 지원하는 값을 쓰면 되는 것으로 보이지만, 확인된 내용은 아니다.

이 변수는 "다른 지정이 없을 때"의 기본값이다. 서브에이전트 정의 파일의 effort 필드를 따로 적어 둔 에이전트는 그 값으로 돈다. 설명 문서(환경변수 문서)에는 아직 이 변수가 올라와 있지 않다.