Claude Code, 여러 도구 호출을 한 자바스크립트 흐름으로 실행하는 기능 추가

Anthropic은 Claude Code v2.1.323에 실험 기능 Code Mode를 추가했습니다. Claude가 Read, Bash, Edit 같은 도구를 한 번씩 호출하고 결과를 읽은 뒤 다음 행동을 정하는 대신, 여러 도구 호출을 묶는 자바스크립트를 작성하면 Claude Code가 현재 세션에서 실행합니다. 한 프로그램 안에서 독립된 작업을 병렬 처리하거나 앞선 호출의 결과를 다음 호출에 넘길 수 있고, 검색 결과에서 필요한 부분만 Claude에 반환할 수도 있습니다.

공식 문서의 예시는 재시도 한도를 높이는 작업입니다. Claude는 먼저 rg로 function retryPolicy가 들어 있는 파일을 찾고, 검색 결과의 첫 경로를 골라 Edit로 maxAttempts 값을 3에서 5로 바꾼 뒤 관련 테스트를 실행하는 코드를 작성합니다. 코드는 파일 경로와 테스트 결과를 반환합니다. 검색·수정·테스트가 한 실행 흐름에서 이어져, Claude가 각 호출의 결과를 차례로 읽고 다음 호출을 결정하는 방식과 달라집니다.

Anthropic은 여러 파일에 같은 변경을 반복하거나, 검색 결과를 걸러낸 뒤 후속 명령을 실행하거나, 서로 독립된 명령을 동시에 처리하는 작업을 Code Mode의 용도로 들었습니다. 기능은 기본적으로 꺼져 있습니다. CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1을 설정해 시작하며, 첫 Code Mode 세션을 열 때 사용자의 활성화 확인을 받습니다. 대화 화면에는 자바스크립트 대신 도구 호출과 편집 결과가 표시되고, 코드는 Ctrl+O로 여는 기록 보기에서 확인할 수 있습니다.

각 도구 호출에는 기존 거부·승인 규칙과 PreToolUse 훅이 적용됩니다. Auto 모드에서는 분류기가 개별 도구 호출이 아니라 실행할 자바스크립트 코드를 검토합니다. 다만 검색 결과에서 가져온 파일 경로처럼 실행 중 계산되는 값은 분류기가 볼 수 없습니다. 다른 권한 모드에서는 코드가 별도 분류 검토 없이 시작되며, 해당 모드에서 확인을 요구하는 도구 호출에는 사용자에게 승인 요청이 표시됩니다.

코드가 끝날 때까지 기다리는 실행은 권한 요청 대기시간을 포함해 최대 10분 뒤 멈춥니다. 백그라운드 실행은 대화를 이어가면서 최대 2시간 동안 계속될 수 있으며, 세션을 Auto 또는 bypassPermissions 모드로 시작해야 합니다.

Code Mode는 Claude Code v2.1.323 이상을 실행하는 대화형 터미널 세션에서 지원됩니다. Claude 구독 또는 Console 계정과 Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 중 하나가 필요합니다. 기본 네이티브 빌드에서 사용할 수 있으며, Windows에서는 Git for Windows도 필요합니다. 조직이 HIPAA 설정이나 Zero Data Retention 구성을 사용하는 경우에는 지원되지 않습니다. 게이트웨이, Amazon Bedrock, AWS·Google Cloud·Microsoft의 해당 플랫폼을 통한 사용과 claude -p, Agent SDK, VS Code 패널, Claude Desktop, 클라우드 세션도 지원 대상에서 제외됩니다. API 키 도우미, 에이전트 팀, OpenTelemetry 내보내기 등 일부 설정이 켜져 있어도 기능이 시작되지 않을 수 있습니다.

Code Mode는 실험 기능으로, Anthropic은 향후 릴리스에서 변경하거나 제거할 수 있다고 설명합니다. 조직 관리자는 관리 설정으로 기능을 차단할 수 있지만 사용자를 대신해 활성화할 수는 없습니다. Code Mode 세션을 이어서 사용하려면 터미널에서 해당 기능을 켠 상태여야 합니다.