클로드 코드 Code Mode로 도구 호출을 코드 한 조각에 묶어 돌리는 설정법
클로드 코드(Claude Code) v2.1.323(11월 12일)에 실험 기능 Code Mode가 들어왔다. 켜 두면 클로드가 Bash·Read·Edit를 하나씩 부르는 대신 도구 호출 여러 개를 자바스크립트 한 조각에 묶어 한 번에 돌린다. 같은 수정을 여러 파일에 되풀이하거나 검색 결과를 걸러 읽을 때, 서로 상관없는 명령을 동시에 돌릴 때 쓴다.
- 버전을 확인한다. v2.1.323보다 낮으면 업데이트한다.
claude --version
claude update
- 환경변수를 1로 두고 시작한다. 한 번만 써 보려면 셸에서 켠다.
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
새 세션마다 켜려면 ~/.claude/settings.json에 넣는다. 프로젝트 설정 파일에 넣은 값은 무시되니 클론한 저장소가 멋대로 켤 수는 없다.
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
-
첫 실행 때 뜨는 확인 창에서 Yes, turn on Code Mode를 고른다. 다시 시작한 뒤 맨 위에
Code Mode (experimental) is on줄이 보이면 켜진 것이다. -
대화 화면에는 도구 호출만 보인다. 클로드가 쓴 코드는
Ctrl+O로 기록 화면을 열고 Code 줄을 펼쳐서 본다.
쓸 수 있는 조건은 까다롭다. 터미널에서 띄운 대화형 claude(네이티브 빌드)에서만 돌고 -p·VS Code·데스크톱 앱·클라우드 세션에서는 안 된다. 모델은 오퍼스 5.5·소네트 5.5·하이쿠 5.5·페이블 5.2, 계정은 Claude 구독이나 Console 계정이어야 하며 베드록·버텍스·게이트웨이로는 못 쓴다. API 키 헬퍼, 에이전트 팀, OpenTelemetry 내보내기, DISABLE_TELEMETRY 가운데 하나라도 켜져 있으면 시작하지 않는다. 켜지지 않으면 맨 위 줄이나 /status에 이유가 나온다.
몇 가지는 미리 알아 둔다. Code Mode로 시작한 세션은 변수를 1로 둔 채로만 claude --continue·--resume으로 이어진다. 끝날 때까지 기다리는 코드는 10분이 지나면 멈춘다. auto 모드 분류기는 코드 조각을 통째로 검토할 뿐 실행 중에 계산된 값(검색 결과에서 뽑은 경로 등)은 보지 못하니, 꼭 막아야 할 호출은 deny 규칙이나 PreToolUse 훅(매처 REPL)으로 지킨다. 끄려면 변수를 지우거나 0으로 바꾼다. 조직 전체에서 막으려면 관리 설정의 env에 0을 넣는다.
출처