Anthropic이 이번 주 Claude Code에 Code Mode라는 실험 기능을 추가했다. 이 기능을 켜면 Claude는 여러 도구를 호출해야 할 때 먼저 JavaScript를 작성하고, Claude Code가 이를 사용자 로컬 컴퓨터의 세션 안에서 실행한다. 코드 한 편으로 여러 명령을 동시에 돌리고, 앞 단계의 결과를 다음 단계로 넘기며, 마지막에는 필요한 부분만 모델에 돌려준다. 기본 방식에서는 Claude가 Bash, Read, Edit 같은 도구를 한 번에 하나씩 호출하고 호출할 때마다 결과를 읽는다.
공식 문서는 이 기능의 위치를 솔직하게 적어 두었다.
"Code Mode is experimental and off by default. It may change or be removed in any release."
(Code Mode는 실험 기능이며 기본적으로 꺼져 있다. 어느 버전에서든 변경되거나 제거될 수 있다.)
켜는 방법과 권한 관리
활성화하려면 환경 변수 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1을 설정한다. 실행 명령 앞에 붙여도 되고, 사용자 수준의 ~/.claude/settings.json에 써도 된다. 프로젝트 수준 설정 파일은 이 변수를 무시한다. 처음 켤 때는 직접 확인해야 한다. 기업 관리자는 관리형 설정에서 값을 0으로 지정해 조직 전체에서 비활성화할 수 있다.
문서가 제시하는 적합한 상황은 세 가지다. 많은 파일에 걸친 반복 수정, 필터링이 필요한 검색, 동시에 실행할 수 있는 독립적인 명령이다. 대화 화면에는 여전히 편집 diff 같은 개별 도구 호출이 표시되고 코드 자체는 한 줄로 접힌다. 펼치려면 Ctrl+O로 기록 뷰어를 열어야 한다.
권한이 느슨해지는 것은 아니다. 코드 안의 모든 도구 호출은 원래 도구 이름(예: Bash)으로 deny/ask 규칙과 PreToolUse 훅을 그대로 거친다. 코드 자체는 REPL이라는 도구를 통해 실행된다. 한 가지 눈여겨볼 변화가 있다. 자동 모드 분류기가 심사하는 것은 코드 전체이며, 실행 중에야 생성되는 값은 볼 수 없다.
기능 설명보다 긴 사용 조건
문서에는 제한이 많이 나열되어 있다. 시간: 포그라운드에서 기다리는 코드는 10분 뒤 중단되고, 백그라운드로 옮기면 최대 2시간 실행된다. 버전: Claude Code v2.1.323부터 사용할 수 있으며 agent teams와 함께 쓰려면 v2.1.326이 필요하다. 진입 경로: 대화형 터미널의 claude만 지원한다. 명령줄 -p 모드, Agent SDK, VS Code 패널, 데스크톱 앱, 클라우드 세션에서는 쓸 수 없다. Remote Control, Claude in Chrome, computer use도 지원하지 않으며, 켜 두면 세션을 데스크톱 앱으로 옮기거나 백그라운드 세션으로 전환할 수도 없다. 모델: Claude Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2로 한정된다.
문서에는 토큰 절감이나 지연 시간 단축에 관한 수치가 전혀 없어, 효과는 개발자가 직접 측정해 봐야 한다.
중국 개발자도 쓸 수 있나
가장 빡빡한 조건은 계정이다. Code Mode는 Claude 구독 사용자와 Console 계정에만 열려 있다. 게이트웨이, Amazon Bedrock, AWS의 Claude Platform, Google Cloud의 Agent Platform, Microsoft Foundry를 거쳐 Claude를 호출하는 경우에는 쓸 수 없다. 중국의 적지 않은 팀이 클라우드 업체 채널이나 자체 구축한 게이트웨이로 Claude에 접속하고 있어, 이들은 당분간 사용할 수 없다. 데이터 무보존(zero data retention) 또는 HIPAA 구성을 켠 조직도 제외되며, API 키 헬퍼, OpenTelemetry 내보내기, DISABLE_TELEMETRY가 설정된 환경도 차단된다.
Windows 사용자는 먼저 Git for Windows를 설치해야 하고, Claude Code도 네이티브 설치 버전이어야 한다. 팀에서 시험해 보려면 곧바로 팀 설정에 넣기보다 개인 터미널에서 며칠 켜 두고 같은 종류의 일괄 변경으로 소요 시간과 토큰 소모를 비교해 보는 편이 안전하다. 애초에 프로젝트 수준 설정은 이 변수를 인식하지도 않는다.
참고 출처: CocoLoop, Claude Code 공식 문서 Code Mode 페이지, Anthropic 개발자 공지; 활성화 방법, 버전 요건, 실행 시간 상한, 지원하지 않는 접속 경로를 확인했다.