발행일 미상 · code.claude.com

Code Mode로 코드에서 도구 호출 실행하기

  1. (1)읽기 전에
  2. (2)Executive Summary
  3. (3)팩트체크
  4. (4)비슷한 기능: Codex와 다른 에이전트 CLI
  5. (5)원본 (완역)
  6. (6)원본 링크·인용
  7. (7)기타

Claude Code 문서 · code.claude.com

Code Mode로 코드에서 도구 호출 실행하기

Code Mode는 Claude가 한 단계에서 여러 도구 호출을 수행하는 JavaScript를 작성하는 실험 기능이다.

읽기 전에

원문은 Anthropic의 Claude Code 공식 문서(code.claude.com)에 실린 「Run tool calls from code with Code Mode」 페이지다. 페이지에는 저자와 날짜가 없다(발행일 미상). Code Mode는 Claude Code v2.1.323(2026-11-12 공개)에 처음 들어갔다. 2026-11-19 기준 원문 분량은 영어 본문 2,239단어와 코드 블록 8개다.

핵심 질문: Code Mode를 켜면 무엇이 달라지나? Claude가 여러 도구 호출을 담은 JavaScript 한 조각을 쓴다. Claude Code는 그 코드를 사용자 세션 안에서 실행한다. Code Mode가 없으면 Claude는 호출 결과를 하나씩 읽은 뒤 다음 호출을 정한다. 원문 예시 코드 4줄은 파일 검색, 재시도 한도(maxAttempts) 수정, 테스트 실행을 한 조각에 담는다. 마지막 줄은 고친 파일 경로와 테스트 출력만 Claude에게 돌려준다.

멘탈 모델: Code Mode의 작업은 두 겹이다. 바깥 겹은 REPL이라는 도구가 실행하는 코드 한 조각이다. auto mode 분류기는 이 바깥 겹을 실행 전에 검토한다. 안쪽 겹은 그 코드가 부르는 Bash·Read·Edit 호출이다. deny·ask 권한 규칙과 PreToolUse 훅은 안쪽 겹의 호출을 Bash 같은 원래 도구 이름으로 하나씩 본다.

권장 읽기 순서

  1. Executive Summary: 써 볼지 정할 결론을 먼저 본다.
  2. 원본 완역의 요구 사항: 내 환경에서 켜지는지가 여기서 갈린다. 조건은 v2.1.323 이상, Claude 구독이나 Console 계정, Opus 5.5·Sonnet 5.5·Haiku 5.5·Fable 5.2 모델, 터미널의 대화형 claude 세션이다. 게이트웨이와 Amazon Bedrock을 포함한 경유 경로 6종으로는 쓸 수 없다. -p, Agent SDK, VS Code 패널, Desktop 앱에서도 동작하지 않는다. API key helper나 OpenTelemetry 내보내기를 켠 설정은 시작을 막는다. 그 밖에 조직, agent teams, 설치 방식, Windows 조건 4종이 원문 목록에 있다.
  3. Code Mode 작동 방식: 예시 코드와 「Code Mode의 제약」 목록을 본다. 원문이 켜기 전에 확인하라는 제약 6가지가 이 목록에 있다.
  4. 권한과 오래 걸리는 코드: auto mode나 PreToolUse 훅에 통제를 맡긴다면 이 절이 훅을 고칠 범위를 정한다. 셸 명령 훅은 명령을 부분별로 검사해야 한다. 원문 예에서 app 폴더의 git push는 훅에 cd 'app' && git push로 들어올 수 있다. 코드 자체는 REPL에 맞춘 PreToolUse 훅이 tool_input.code에서 읽는다.
  5. 팩트체크: 원문 주장의 판정을 본다. 원문은 Code Mode가 어느 릴리스에서든 바뀌거나 사라질 수 있다고 적는다. Claude Code changelog의 v2.1.325~v2.1.328 항목마다 Code Mode 변경이 있다.
  6. 비슷한 기능: Codex와 다른 에이전트 CLI: OpenAI Codex CLI를 비롯한 다른 에이전트 CLI의 비슷한 기능을 비교표로 본다.
  7. Code Mode 써 보기와 문제 해결: 직접 켤 때 옆에 둔다. 켜지지 않으면 세션 위쪽에 이유가 한 줄로 뜬다. 그 문구를 문제 해결 표에서 찾는다.
  8. 원본 링크·인용과 기타: 원문 주소와 인용 출처를 확인할 때 연다.

선행 개념

도구 호출(tool call): Claude가 Bash(셸 명령)·Read(파일 읽기)·Edit(파일 수정) 같은 도구를 한 번 쓰겠다는 요청이다. Claude Code는 호출을 실행한 뒤 결과를 Claude에게 돌려준다.

권한 모드(permission mode)와 auto mode 분류기: 권한 모드는 도구 호출을 사용자에게 물을지 정하는 세션 설정이다. auto mode에서는 사용자 대신 분류기(classifier)가 검토한다. 묻는 모드에서는 Code Mode에서도 그 모드가 묻던 호출마다 사용자에게 묻는다.

deny·ask 권한 규칙: 맞는 도구 호출을 거부(deny)하거나 사용자에게 묻게(ask) 만드는 규칙이다. Bash 규칙은 명령 문자열을 맞추므로 문자열을 바꾼 금지 명령은 Code Mode와 상관없이 규칙을 비켜 갈 수 있다.

PreToolUse 훅: 도구 호출이 실행되기 직전에 도는 사용자 정의 command 훅이나 http 훅이다. 훅은 그 호출을 허용하거나 막을 수 있다.

점검 질문

  1. Code Mode를 켰는데 대화창에 JavaScript가 보이지 않는다. 꺼진 것인가? 꺼졌다는 뜻은 아니다. 대화창은 edit의 diff 같은 도구 호출만 보여 준다. 코드는 Ctrl+O로 여는 트랜스크립트 뷰어에 접힌 Code 행으로 있다. 켜졌는지는 세션 위쪽의 Code Mode (experimental) is on 줄로 확인한다.
  2. 팀 저장소 .claude/settings.json의 env 블록에 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE를 "1"로 넣으면 팀원 모두 Code Mode로 시작하나? 아니다. Claude Code는 프로젝트 설정 파일의 이 변수를 무시하므로 클론한 저장소는 Code Mode를 켜지 못한다. 관리자도 managed settings로 켤 수 없다. 관리자는 값 "0"으로 조직 전체를 끄기만 할 수 있다.
  3. auto mode에서 Claude가 검색 결과에서 얻은 경로의 파일을 고친다. 분류기가 그 경로를 보고 막아 주나? 막는다는 보장이 없다. 분류기는 검색 출력에서 얻은 경로처럼 실행 중에 계산한 값을 보지 못한다. 통제가 필요한 호출은 deny·ask 규칙이나 PreToolUse 훅에 둔다.

Executive Summary

Anthropic이 code.claude.com에 올린 Claude Code 문서 「Run tool calls from code with Code Mode」(저자 표기 없음, 발행일 미상)에 따르면 Code Mode는 Claude가 도구 호출 여러 개를 JavaScript 한 조각에 담아 세션 안에서 실행하게 하는, 기본값이 꺼진 실험 기능이다. 켤지 정할 때 먼저 따질 제약은 auto mode(프롬프트 대신 분류기가 허용 여부를 가르는 권한 모드)의 검토 단위다. 분류기는 실행 전에 코드 한 조각을 한 번 검토할 뿐, 실행 중에 계산된 값은 보지 못한다. 문서는 꼭 통제할 호출을 호출마다 걸리는 deny·ask 규칙과 PreToolUse 훅으로 지키라고 한다.

신뢰도 B — 요구 사항과 권한 규칙은 1차 출처와 맞는다. 대기 시간 10분과 UserPromptSubmit 훅을 다룬 두 절은 2.1.328 이전 동작이다. 판정 55건과 기호의 뜻은 팩트체크 블록에 있다.

Code Mode에서 Claude는 도구를 직접 부르는 대신 호출을 담은 JavaScript를 쓴다

Code Mode를 끈 Claude는 Bash, Read, Edit 같은 도구 호출을 직접 요청한다. 결과를 하나 읽을 때마다 다음 행동을 정한다. Code Mode를 켜도 사용자는 프롬프트로 작업을 설명한다. Claude는 그 작업을 처리할 JavaScript를 쓴다. Claude Code가 그 코드를 사용자 세션에서 실행한다.

코드 한 조각은 명령을 병렬로 돌릴 수 있다. 한 호출의 결과를 다음 호출에 넘길 수도 있다. 출력 가운데 Claude가 읽을 부분만 골라 돌려줄 수도 있다. 문서의 예시는 재시도 한도를 올려 달라는 요청에 Claude가 쓸 법한 코드다. 코드는 파일을 찾아 고친 뒤 테스트를 돌린다. 마지막 줄은 파일 경로와 테스트 출력을 Claude에게 돌려준다.

const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });

대화 화면에는 코드 대신 edit의 diff 같은 도구 호출이 보인다. 코드는 Ctrl+O로 여는 transcript viewer에 접힌 Code 행으로 남는다. 행마다 펼치는 방법을 알려 주는 힌트가 붙는다. Ctrl+O를 다시 누르면 대화로 돌아온다. 문서는 Code Mode가 어느 릴리스에서든 바뀌거나 없어질 수 있다고 적는다. 의견은 /feedback으로 보낸다.

Code Mode는 연관된 도구 호출이 많은 작업에 맞는다

문서가 Code Mode를 써 보라고 권하는 작업은 다음과 같다.

처음 켠 뒤 익숙한 프로젝트에서 보내 볼 프롬프트로 문서는 Read every Markdown file in this project and list the links that point to local files that don't exist.를 든다. Markdown 파일의 로컬 링크 가운데 없는 파일을 가리키는 것을 찾는 작업이다.

Code Mode는 Anthropic에 직접 붙은 터미널의 대화형 세션에서만 켜진다

Claude Code 변경 기록은 v2.1.323에 Code Mode 추가를 적는다. 이 버전의 npm 게시 시각은 2026-11-12 20:29 UTC다.

항목문서가 적는 조건
버전v2.1.323 이상. release channel은 어느 쪽이든 된다. 더 낮은 버전은 Code Mode 없이 시작한다. 이유 문구 it isn't open to your account yet는 뜰 때도 있고 안 뜰 때도 있다.
계정Claude 구독 또는 Console 계정. gateway, Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, Microsoft Foundry, Claude Models on Google Cloud (Anthropic managed)를 거치면 쓸 수 없다.
조직HIPAA 구성이나 zero data retention을 쓰지 않는 조직
모델Claude Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2
실행 표면터미널의 대화형 claude 세션. -p, Agent SDK, VS Code 패널, Desktop app, cloud session에서는 동작하지 않는다.
agent teamsagent teams를 켠 채 쓰려면 v2.1.326 이상. teammate는 기본값인 in-process display mode에서 Code Mode로 돈다. split pane에서는 Code Mode 없이 시작한다.
설치Claude Code native build
WindowsGit for Windows 설치

API key helper, OpenTelemetry export, DISABLE_TELEMETRY 같은 설정이 켜져 있어도 Code Mode는 시작하지 않는다. 설정별 해결책은 아래 시작 실패 표에 있다.

Code Mode의 스위치는 환경 변수 하나다

켜기 전에 claude --version으로 버전을 본다. v2.1.323보다 낮으면 claude update를 돌린다. stable 채널에서 업데이트가 v2.1.323에 못 미치면 stable이 따라올 때까지 기다리거나 latest 채널로 옮긴다.

켜는 방법은 환경 변수 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE를 1로 두는 것이다. 시험 삼아 쓸 때는 셸에서 준다. macOS, Linux, WSL에서는 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude로 시작한다. Windows PowerShell에서는 $env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"을 실행한 뒤 claude를 띄운다. 새 세션마다 켜려면 ~/.claude/settings.json의 env 블록에 같은 값을 넣는다.

Claude Code가 프로젝트 settings 파일의 이 변수를 무시하므로, clone한 저장소가 사용자 대신 Code Mode를 켤 수는 없다. 첫 Code Mode 세션 전에는 확인 창이 뜬다. Yes, turn on Code Mode를 고르면 Claude Code가 재시작한다. 세션 첫머리에는 Code Mode (experimental) is on · this session can be resumed only with Code Mode on 줄이 뜬다. 다른 줄이 뜨거나 아무 줄도 없으면 아래 시작 실패 절을 본다.

끄려면 셸과 ~/.claude/settings.json에서 변수를 지운 뒤 새 세션을 연다. 변수를 남긴 채 값만 0으로 바꿔도 된다. 한 곳에 0이 있으면 다른 곳의 1과 상관없이 Code Mode는 꺼진다.

조직 전체를 막으려면 managed settings의 env에 같은 변수를 "0"으로 넣는다. 이미 Code Mode 세션에 있는 사용자는 종료하거나 Claude Code를 재시작할 때까지 그 세션에 머문다. 그 뒤로는 Code Mode 없이 시작한다. 0이 남아 있는 동안에는 예전 Code Mode 세션도 이어 가지 못한다. managed settings로 사용자에게 Code Mode를 켜 줄 수는 없다.

Code Mode 세션에는 재개 조건과 쓸 수 없는 기능이 붙는다

Code Mode 세션은 터미널에서 Code Mode를 켠 상태로만 이어 갈 수 있다. claude --continue나 claude --resume을 실행할 때도 변수를 1로 유지해야 한다. Code Mode가 꺼져 있으면 Claude Code는 재개를 거부한다. Code Mode 없이 시작한 세션은 변수를 켜 두어도 Code Mode 없이 재개된다.

켠 세션에서는 Remote Control, Claude in Chrome, computer use를 쓸 수 없다. 세션을 Desktop app으로 옮기거나 background session으로 바꿀 수도 없다. /fork도 백그라운드 복사본을 만들지 못한다. 문서는 이 제약들을 켜기 전에 받아들일 수 있는지 확인할 목록으로 묶는다. 같은 목록에 auto mode의 검토 단위, 기다리는 코드의 10분 한도, 훅이 도구 호출이나 코드 출력을 막는 경우가 함께 있다.

권한 규칙과 훅은 호출마다, auto mode 분류기는 코드 한 조각마다 검사한다

코드 검사 방식과 코드가 도는 동안 Claude와 대화할 수 있는지는 권한 모드가 정한다. Claude가 코드를 돌리면 그 안의 도구 호출은 하나하나 deny·ask 권한 규칙과 PreToolUse 훅을 거친다. 이때 호출은 Bash 같은 평소 도구 이름으로 걸린다. 규칙과 훅 위에 모드별 검사가 더해진다.

셸 명령을 허용하거나 막는 PreToolUse 훅은 Bash 규칙처럼 명령의 각 부분을 따로 검사해야 한다. Code Mode에서는 app 폴더 안의 git push가 cd 'app' && git push 형태로 훅에 닿을 수 있다. 코드 자체를 검사하려면 코드를 실행하는 도구인 REPL에 맞춘 PreToolUse 훅을 쓴다. 그 훅은 tool_input.code에서 JavaScript를 읽는다.

Bash 규칙은 명령 문자열을 대조하므로, Claude는 Code Mode와 상관없이 거부된 명령을 규칙에 안 걸리는 형태로 돌릴 수 있다. 명령 문자열에 기대지 않는 제한은 sandboxing이 맡는다.

기다리는 코드는 10분, 백그라운드 코드는 2시간까지 돈다

긴 빌드나 테스트를 도는 코드를 Claude는 기다리거나 백그라운드로 넘긴다.

기다림
Claude는 코드가 끝난 뒤 답한다. 코드는 10분 뒤 멈춘다. 문서는 권한 프롬프트에서 보낸 시간도 그 10분에 든다고 적는다. v2.1.328부터는 그 시간을 빼고 잰다.
백그라운드
사용자는 Claude와 계속 대화할 수 있다. 코드는 최대 2시간 돈다.

백그라운드로 돌리려면 세션을 auto 또는 bypassPermissions 모드로 시작해야 한다. 백그라운드를 기대했는데 Claude가 계속 기다리면, 문서는 지금 모드와 세션 시작 방식을 확인하라고 한다.

Code Mode가 시작하지 않으면 세션 첫머리의 이유 문구가 고칠 곳을 알려 준다

세션 첫머리에 Code Mode (experimental) isn't available이 뜨면 Claude Code가 Code Mode 없이 시작한 것이다. 이유는 같은 줄에 붙는다. /status에도 같은 이유가 나온다. 아래 표에서 이유를 찾아 고친 뒤 새 세션을 연다. 표에 없는 이유라면 위 요구 조건을 다시 본다. 표의 13행은 문서 원문 그대로다. mod 행과 플러그인 행의 이유는 v2.1.327 바이너리부터 나오지 않는다.

이유 문구에 든 말할 일
it isn't open to your account in this version, it isn't open to your account yetv2.1.323보다 낮으면 업데이트한다. 아니면 네트워크 연결을 확인하고 다시 시작한다. 이유가 남으면 다른 날 다시 시도한다.
it only works directly with the Anthropic API, it only works with the Anthropic API클라우드 제공자, gateway, 사용자 지정 ANTHROPIC_BASE_URL로 요청을 보내는 설정을 지운다.
it doesn't work with an API key helperapiKeyHelper, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_CUSTOM_HEADERS의 Authorization·X-Api-Key 헤더를 지운다. 그다음 로그인하거나 ANTHROPIC_API_KEY를 설정한다.
it only works with Opus 5.5, Sonnet 5.5 and later models지원 모델로 시작한다. 예: --model opus. Haiku 5.5와 Fable 5.2도 된다.
it doesn't work in background jobs--remote-control 없이 포그라운드에서 시작한다. teammate의 split pane에 이 이유가 뜨면 in-process display mode로 teammate를 Code Mode에서 돌린다.
it needs settings that Claude Code downloads from AnthropicDISABLE_TELEMETRY처럼 feature-flag fetching을 끄는 변수를 해제한다.
OpenTelemetry is onOpenTelemetry export 없이 일할 수 있으면 CLAUDE_CODE_ENABLE_TELEMETRY와 ENABLE_BETA_TRACING_DETAILED를 해제한다.
it doesn't yet work with the plugin세션에서 /plugin을 열어 이유에 적힌 플러그인을 모두 끈다. 조직이 켠 플러그인은 관리자에게 꺼 달라고 한다.
it doesn't yet work with an installed mod도구 호출을 검사하는 mod를 끈다.
it can't be used together with agent teams yetagent teams를 유지하려면 v2.1.326 이상으로 업데이트한다. 지금 버전에 머물려면 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS를 해제한다.
this launch's tool options--restricted 없이 시작한다. --tools에 REPL을 넣는다. --disallowedTools와 deny 규칙에서는 REPL을 뺀다.
couldn't save your answer~/.claude.json을 쓰기 가능하게 한다.
your organization's settings don't allow it조직을 막는 managed settings 값에 대해 관리자에게 묻는다.

Code Mode에 관한 줄이 아예 없으면 버전을 먼저 확인한다. 다음으로 셸이나 사용자 설정에서 변수가 1인지 본다. 그 두 곳과 --settings로 넘긴 파일에 남은 0도 모두 지운다.

auto mode에서 코드가 겹치면 앞선 코드의 남은 호출에 카운트다운 프롬프트가 뜬다

앞선 코드가 도는 중에 Claude가 auto mode에서 코드를 더 시작하면, 앞선 코드는 분류기 검토를 잃는다. Claude Code는 앞선 코드의 남은 호출 가운데 검토가 필요한 호출을 사용자에게 묻는다. IDE가 연결되지 않았으면 이 프롬프트에 카운트다운이 붙는다. 문서의 예시 문구는 Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session이다.

카운트다운이 끝나기 전에 답해야 한다. 답이 없으면 그 호출은 거부된다. 그 뒤로 카운트다운이 붙었을 호출은 프롬프트 없이 거부된다. 프롬프트를 다시 보려면 Claude에게 메시지를 보낸다.

PreToolUse 훅이 결정을 내지 못하면 호출은 거부된다

Claude가 도구 호출이 거부됐다고 보고하면 오류 문구를 물어본다. 아래 두 문구는 PreToolUse 훅이 결정을 내지 못했다는 뜻이다. 이 경우 onFailure를 설정하지 않았어도 호출은 거부된다.

command·http 훅이 실패하거나 시간을 넘겨도 호출을 통과시키려면 그 훅에 "onFailure": "continue"를 단다. command 훅이 1 같은 일반 종료 코드로 끝나면 호출은 그대로 진행된다. 이 경우까지 막으려면 "onFailure": "block"을 단다.

문서에 따르면 UserPromptSubmit 훅이 코드 출력을 막을 수 있다

코드 출력이 와야 할 자리에 Claude가 훅의 차단 사유를 보고하면 UserPromptSubmit 훅을 본다. 문서는 코드가 백그라운드로 돌 수 있는 세션에서 이 이벤트의 command·http·mcp_tool 훅이 코드 출력에도 돈다고 적는다. 출력을 통과시키려면 입력의 source가 poll_event일 때 막지 않도록 훅을 고친다. 이 절은 v2.1.327까지의 동작이다. v2.1.328(npm 게시 2026-11-18) 변경 기록은 Code Mode가 스크립트 출력에 UserPromptSubmit 훅을 더는 돌리지 않는다고 적는다. 그 버전에서 출력을 가리는 자리는 PostToolUse 훅의 updatedToolOutput이다. 근거는 팩트체크에 있다.

Code Mode는 실행을 코드 한 조각 단위로 묶는다. auto mode에서는 검토도 그 단위를 따른다.


팩트체크

이 문서의 신뢰 등급은 B다. 요구 사항, 시작 거부 이유, 권한 규칙, 예시 코드는 Claude Code 변경 기록과 다른 공식 문서, 설치된 Claude Code 2.1.328 바이너리 문자열과 맞는다. 주장 55개의 판정은 사실 39, 부분사실 11, 불확실 3, 거짓 2다. 거짓 두 건은 2.1.328(변경 기록 날짜 2026-11-19)에서 바뀐 동작이다. 대기 10분에 권한 프롬프트 시간이 들어간다는 문장과 UserPromptSubmit 훅이 코드 출력에도 돈다는 절은 2.1.327까지의 동작을 적는다. 부분사실에는 2.1.327과 2.1.328이 좁힌 안내 세 건(mod 거부 이유, --resume 목록 세션, 카운트다운 조건)과 stable 채널이 2026-11-19 기준 2.1.311에 머문 사정이 들어간다.

B

요구 사항과 권한 규칙은 1차 출처와 맞지만 대기 시간과 UserPromptSubmit 훅 두 절은 2.1.328 이전 동작이다.

✅ 사실은 1차 출처가 주장을 그대로 담은 경우다. 🟡 부분사실은 일부만 맞거나 특정 버전 범위에서만 맞는 경우다. ⚠️ 불확실은 공식 문서와 바이너리 문자열로 가릴 수 없는 경우다. ❌ 거짓은 최신판 2.1.328 기준으로 1차 출처가 반대로 적는 경우다. 바이너리 문자열은 Anthropic이 배포한 Claude Code 실행 파일(macOS arm64)에 든 문구다.

출시와 버전

✅

Code Mode는 기본값이 꺼진 실험 기능이다. 어느 릴리스에서든 바뀌거나 빠질 수 있다.

2.1.328 바이너리의 켜기 확인 창 문구에 “it may change or be removed in any release”가 있다. 2.1.323 변경 기록은 Code Mode를 “experimental opt-in”으로 추가했다.

Claude Code 2.1.328 바이너리 · Claude Code CHANGELOG.md

✅

Code Mode는 Claude Code v2.1.323 이상에서 돈다.

변경 기록 문서의 2.1.323 항목(2026-11-12)이 Code Mode 추가로 시작한다. npm 등록 시각은 2026-11-12T20:29Z다. Anthropic 개발자 계정 ClaudeDevs는 2026-11-17 X 게시물로 이 기능을 알렸다.

Claude Code 변경 기록 문서 · npm 레지스트리 @anthropic-ai/claude-code · ClaudeDevs X 게시물(2026-11-17)

🟡

latest와 stable 두 릴리스 채널 어느 쪽에서든 v2.1.323 이상이면 쓸 수 있다.

원문 “either release channel” → 확인 stable 채널 주소는 2026-11-19 기준 2.1.311을 돌려준다(latest는 2.1.328). 2.1.328 바이너리는 네이티브 설치본의 채널 버전을 이 주소에서 읽는다. 원문 안내대로 그날 stable 사용자는 latest로 옮겨야 Code Mode를 쓴다.

stable 채널 버전 주소 · Claude Code 2.1.328 바이너리 · 설치 문서

✅

에이전트 팀을 켠 채 Code Mode를 쓰려면 v2.1.326 이상이 필요하다.

변경 기록 2.1.326(2026-11-16)이 에이전트 팀을 켠 상태에서 Code Mode를 켜는 기능을 추가했다. 2.1.323 바이너리에 있던 이유 “it can't be used together with agent teams yet”는 2.1.326 바이너리에 없다.

Claude Code 변경 기록 문서 · Claude Code 2.1.323 바이너리 · Claude Code 2.1.326 바이너리

✅

팀원은 기본 표시 모드(in-process)에서 Code Mode로 돈다. 분할 창 팀원은 Code Mode 없이 시작한다.

2.1.328 바이너리의 거부 이유는 “doesn't work in background jobs, in teammates' panes or with Remote Control”이다. 에이전트 팀 문서는 teammateMode를 바꾸기 전까지 팀원이 in-process로 돈다고 적는다.

Claude Code 2.1.328 바이너리 · 에이전트 팀 문서

계정·제공자·모델·실행 환경

✅

Claude 구독이나 Console 계정이 필요하다. Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, Microsoft Foundry, Claude Models on Google Cloud(Anthropic 관리)에서는 쓸 수 없다.

기능 가용성 표의 Code Mode 행에서 지원 표시는 Claude 구독과 Anthropic Console 두 칸뿐이다. 나머지 다섯 제공자 칸은 모두 미지원이다.

기능 가용성 문서

✅

게이트웨이나 사용자 지정 ANTHROPIC_BASE_URL을 거치는 요청으로는 쓸 수 없다.

2.1.328 바이너리 문구는 “only works directly with the Anthropic API (not through a cloud provider such as Bedrock, a gateway or another address in ANTHROPIC_BASE_URL)”다. 2.1.323 바이너리에는 짧은 꼴 “only works with the Anthropic API”가 있다.

Claude Code 2.1.328 바이너리 · Claude Code 2.1.323 바이너리

✅

HIPAA 구성이나 무보존(Zero Data Retention, ZDR)을 쓰는 조직은 쓸 수 없다.

2.1.328 바이너리 문자열에 거부 이유 “it isn't offered yet to organizations under HIPAA or zero data retention”이 있다.

Claude Code 2.1.328 바이너리

🟡

지원 모델은 Claude Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2다.

원문 “Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2” → 확인 2.1.328 바이너리의 모델 거부 문구는 “Opus 5.5, Sonnet 5.5 and later models”까지만 적는다. Haiku 5.5와 Fable 5.2가 이 조건을 통과하는지는 이 문구로 가릴 수 없다.

Claude Code 2.1.328 바이너리

✅

터미널의 대화형 claude 세션에서만 돈다. -p, Agent SDK, VS Code 패널, Desktop 앱, 클라우드 세션에서는 안 된다.

2.1.328 바이너리 문자열에 거부 이유 “for now it only works in the interactive terminal”이 있다.

Claude Code 2.1.328 바이너리

✅

Claude Code 네이티브 빌드가 필요하다.

2.1.328 바이너리 문자열에 거부 이유 “it needs Claude Code's native build”가 있다.

Claude Code 2.1.328 바이너리

✅

Windows에서는 Git for Windows가 설치돼 있어야 한다.

2.1.328 바이너리 문자열에 “for now it needs Git for Windows (Bash) on Windows”가 있다. 2.1.328 변경 기록은 Windows에서 스크립트의 셸 명령이 Git Bash로 돈다는 안내를 Claude에 더했다.

Claude Code 2.1.328 바이너리 · Claude Code 변경 기록 문서

✅

API 키 헬퍼를 쓰면 Code Mode가 시작하지 않는다.

2.1.328 바이너리 거부 이유는 “doesn't work with an API key helper, ANTHROPIC_AUTH_TOKEN or custom auth headers”다. 원문 표가 지우라고 한 세 설정과 같다.

Claude Code 2.1.328 바이너리

✅

OpenTelemetry 내보내기를 켜면 Code Mode가 시작하지 않는다.

2.1.328 바이너리 거부 이유는 “OpenTelemetry is on (CLAUDE_CODE_ENABLE_TELEMETRY or ENABLE_BETA_TRACING_DETAILED …)”이다. 원문 표가 끄라고 한 두 변수와 같다.

Claude Code 2.1.328 바이너리

✅

DISABLE_TELEMETRY처럼 기능 플래그 내려받기를 끄는 변수가 있으면 Code Mode가 시작하지 않는다.

2.1.328 바이너리 거부 이유는 Anthropic에서 받는 설정을 DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC가 막는다고 적는다. 환경 변수 문서도 기능 플래그를 받지 않는 세션에서는 Code Mode를 켤 수 없다고 적는다.

Claude Code 2.1.328 바이너리 · 환경 변수 문서

켜기·끄기·재개

✅

환경 변수 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE를 1로 두면 켜진다.

환경 변수 문서의 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 행은 값이 1이면 세션을 Code Mode로 시작한다고 적는다.

환경 변수 문서

✅

첫 Code Mode 세션 전에 Yes, turn on Code Mode를 고르는 확인 창이 뜬다. 고르면 Claude Code가 다시 시작한다.

2.1.328 바이너리의 확인 창 버튼은 “Yes, turn on Code Mode”와 “No, start without it”이다. 2.1.327 변경 기록에는 Code Mode를 켤 때 Claude Code가 스스로 다시 시작하는 과정을 고친 항목이 있다.

Claude Code 2.1.328 바이너리 · Claude Code 변경 기록 문서

✅

켜진 세션 위쪽에 Code Mode (experimental) is on · this session can be resumed only with Code Mode on 줄이 뜬다.

2.1.328 바이너리의 상태 줄 템플릿이 원문 문구와 같다.

Claude Code 2.1.328 바이너리

✅

Claude Code는 프로젝트 설정 파일의 이 변수를 무시한다. 클론한 저장소는 Code Mode를 켤 수 없다.

설정 레퍼런스는 이 변수를 셸, 사용자 설정, --settings 파일에서만 받는다고 적는다. 관리·프로젝트·로컬 설정으로는 켤 수 없다.

설정 레퍼런스

✅

셸과 사용자 설정 중 한 곳에 0이 있으면 다른 곳에 1이 있어도 꺼진 채다.

설정 레퍼런스는 셸, 사용자 설정, --settings 파일, 관리 설정 중 한 곳에 0이 있으면 다른 곳 값과 상관없이 꺼진다고 적는다.

설정 레퍼런스

✅

관리 설정에 0을 넣으면 조직 전체에서 Code Mode를 막는다. 관리 설정으로 켜 줄 수는 없다.

환경 변수 문서는 관리 설정의 0을 조직 차단 방법으로 적는다. 설정 레퍼런스는 관리 설정으로는 켤 수 없다고 적는다. 2.1.328 바이너리에는 이때 뜨는 이유 “your organization's settings don't allow it”이 있다.

환경 변수 문서 · 설정 레퍼런스 · Claude Code 2.1.328 바이너리

🟡

관리 설정에 0이 들어가도 진행 중 세션은 종료나 재시작까지 이어진다. 그 뒤로는 Code Mode 세션을 재개할 수 없다.

2.1.328 바이너리는 조직 설정이 막은 Code Mode 세션의 재개를 “your organization's settings don't allow” 이유로 거부한다. 진행 중 세션이 종료나 재시작까지 이어진다는 부분은 공식 문서와 바이너리 문자열로 가릴 수 없다.

Claude Code 2.1.328 바이너리

✅

Code Mode 세션은 Code Mode를 켠 채로만 재개된다. 끈 채로는 재개를 거부한다.

2.1.328 바이너리의 확인 창 문구는 Code Mode로 시작한 세션이 Code Mode를 켠 채로만 재개된다고 적는다. 끈 경우에는 다시 켜야 재개된다는 안내가 이어진다.

Claude Code 2.1.328 바이너리

✅

Code Mode 없이 시작한 세션은 변수를 켠 채 재개해도 Code Mode 없이 이어진다.

2.1.328 바이너리에 “Code Mode is on, but this session isn't using it, so it continues with the ordinary tools” 문구가 있다.

Claude Code 2.1.328 바이너리

⚠️

v2.1.323보다 오래된 버전은 Code Mode 없이 시작한다. 이유 줄이 없거나 it isn't open to your account yet가 뜬다.

v2.1.323보다 오래된 판의 시작 동작은 공식 문서와 변경 기록으로 가릴 수 없다. “it isn't open to your account yet” 문구는 요구 버전 안에 드는 2.1.323과 2.1.325 바이너리에 있다.

Claude Code 2.1.323 바이너리

동작 방식

✅

코드 한 조각 안에서 명령을 병렬로 돌리거나 앞 결과를 다음 호출에 넘길 수 있다. 마지막 값만 Claude에 돌아간다.

2.1.328 바이너리가 Claude에 주는 안내에 “One script can look in several places at once and then read what it found” 예시가 있다. 예시는 Promise.all로 검색 두 개를 함께 돌린다.

Claude Code 2.1.328 바이너리

✅

원문 예시 코드의 $ 태그 템플릿(.text(), .nothrow())과 edit() 도우미는 실제 API다.

2.1.328 바이너리의 안내 예시가 원문과 같은 retryPolicy 코드다. $`rg …`.text(), edit(target, 'maxAttempts: 3', 'maxAttempts: 5'), $`npm test …`.nothrow()가 그대로 들어 있다.

Claude Code 2.1.328 바이너리

🟡

Ctrl+O 트랜스크립트 뷰어에서 각 코드 조각이 접힌 Code 행으로 보인다.

대화형 모드 문서는 Ctrl+O를 트랜스크립트 뷰어 토글로 적는다. 2.1.328 바이너리는 코드를 돌리는 도구의 표시 이름을 “Code”로 둔다. 행이 접힌 채 뜨는지와 펼치기 안내는 이 출처들로 가릴 수 없다.

대화형 모드 문서 · Claude Code 2.1.328 바이너리

권한 확인

✅

코드 안의 각 도구 호출은 deny·ask 권한 규칙을 그대로 거친다.

권한 모드 문서는 Code Mode에서도 deny 규칙이 호출을 막는다고 적는다. ask 규칙도 그대로 프롬프트를 띄운다. auto 모드 설정 문서는 코드 안 특정 호출을 막을 때 permissions.deny 규칙을 쓰라고 적는다.

권한 모드 문서 · auto 모드 설정 문서

🟡

코드 안의 각 호출은 Bash 같은 평소 도구 이름으로 PreToolUse 훅에 들어간다.

훅 레퍼런스는 Code Mode에서 PreToolUse 시간 초과와 실패가 다르게 동작한다고 적는다. 훅이 Bash 같은 평소 이름으로 호출을 받는다는 문장은 원문 밖 공식 문서와 바이너리 문자열로 가릴 수 없다.

훅 레퍼런스

✅

auto 모드 분류기는 도구 호출 하나하나 대신 코드 한 조각을 실행 전에 한 번 검토한다. 실행 중에 계산된 값은 보지 못한다.

2.1.328 바이너리의 확인 창은 auto 모드 안전 검사가 JavaScript 조각을 실행 전에 한 번 읽는다고 적는다. 같은 문구는 코드가 실행 중에 계산한 값을 볼 수 없다고 덧붙인다. 권한 모드 문서도 코드가 분류기에 한 번 간다고 적는다.

Claude Code 2.1.328 바이너리 · 권한 모드 문서

⚠️

auto가 아닌 권한 모드에서는 코드가 검토 없이 시작한다. 그 모드에서 물을 호출마다 사용자에게 묻는다.

auto가 아닌 모드의 코드 검토와 호출별 프롬프트 동작은 원문 밖 공식 문서와 바이너리 문자열로 가릴 수 없다.

권한 모드 문서

🟡

app 폴더 안의 git push가 훅에 cd 'app' && git push 꼴로 들어올 수 있다.

2.1.328 바이너리에는 Code Mode 셸 명령 앞에 작업 폴더로 옮기는 cd <폴더> && 를 붙이는 코드가 있다. 폴더 이름을 작은따옴표로 감싸는지는 이 문자열로 가릴 수 없다. 권한 문서의 복합 명령 절은 &&로 이은 명령의 각 부분을 따로 검사한다고 적는다.

Claude Code 2.1.328 바이너리 · 권한 문서

✅

코드를 돌리는 도구 이름은 REPL이다. 훅은 tool_input.code에서 JavaScript를 읽는다.

2.1.328 바이너리는 코드를 돌리는 도구 이름을 “REPL”로 둔다. 도구별 주 입력 필드 표에 ["REPL","code"]가 들어 있다.

Claude Code 2.1.328 바이너리

✅

Bash 규칙은 명령 텍스트를 맞춘다. 규칙이 못 맞추는 꼴로 금지 명령이 돌 수 있다.

권한 문서는 Bash 규칙이 같은 프로그램을 다른 꼴로 부르는 경우를 맞추지 못한다고 적는다.

권한 문서

오래 걸리는 코드

✅

Claude가 기다리는 코드는 10분 뒤 멈춘다.

2.1.328 바이너리의 Code Mode 모듈(repl-tool-code.js)에 600,000 ms(10분) 상수가 있다. 같은 바이너리 안내문은 권한을 묻는 모드에서 스크립트가 이 시간 뒤 멈춘다고 적는다.

Claude Code 2.1.328 바이너리

❌

그 10분에는 권한 프롬프트에서 보낸 시간이 들어간다.

원문 “including time you spend at permission prompts” → 확인 2.1.328 바이너리 안내문은 “not counting time spent waiting at permission prompts”다. 2.1.323부터 2.1.327까지의 바이너리 문구는 “that time includes time spent waiting at permission prompts”였다. 2.1.328 변경 기록도 권한 프롬프트, 계획 승인, 질문이 10분 열려 있을 때 스크립트가 멈추던 문제를 고쳤다고 적는다.

Claude Code 2.1.328 바이너리 · Claude Code 2.1.327 바이너리 · Claude Code 변경 기록 문서

🟡

백그라운드 코드는 최대 2시간 돈다.

2.1.328 바이너리 안내문은 긴 빌드에 “up to 2 hours” 시간 제한을 주라고 적는다. 같은 모듈에 7,200,000 ms(2시간) 상수가 있다. 백그라운드 코드 전체의 상한이 2시간이라는 문장은 공식 문서와 바이너리 문자열로 가릴 수 없다.

Claude Code 2.1.328 바이너리

✅

백그라운드 실행은 auto나 bypassPermissions 모드로 시작한 세션에서만 된다.

2.1.328 바이너리 안내문은 권한을 묻는 모드에서 모든 REPL 호출이 스크립트 끝까지 기다린다고 적는다. 2.1.328 변경 기록의 백그라운드 관련 수정도 auto·bypass 모드를 대상으로 한다.

Claude Code 2.1.328 바이너리 · Claude Code 변경 기록 문서

🟡

claude --resume 목록에서 고른 세션은 백그라운드가 안 된다. 종료한 뒤 claude --continue --permission-mode auto로 다시 시작해야 한다.

원문 “--resume 목록에서 고른 세션은 다시 시작해야 한다” → 확인 2.1.328이 --resume 선택 화면에서 고른 세션의 auto·bypass 스크립트가 백그라운드로 돌지 않던 문제를 고쳤다. 다른 모드로 시작한 세션에 대한 안내는 그대로 맞다.

Claude Code 변경 기록 문서

⚠️

--tools에 도구 이름을 넘긴 세션은 백그라운드가 안 된다. 그 플래그 없이 auto 모드로 다시 시작해야 한다.

--tools 플래그와 백그라운드 실행의 관계는 공식 문서와 바이너리 문자열로 가릴 수 없다.

CLI 레퍼런스

문제 해결 표와 훅

✅

켜지지 않으면 세션 위쪽에 Code Mode (experimental) isn't available과 이유가 한 줄로 뜬다. /status에도 같은 이유가 나온다.

2.1.328 바이너리의 시작 실패 문구는 “Code Mode (experimental) isn't available: <이유>. Starting with the ordinary tools.”다. /status용 문구도 “off · <이유>” 꼴로 같은 이유를 쓴다.

Claude Code 2.1.328 바이너리

✅

이유 it isn't open to your account in this version 또는 it isn't open to your account yet는 업데이트나 재시작으로 풀 수 있다.

2.1.328 바이너리 문구는 “it isn't open to your account in this version of Claude Code … (updating or restarting Claude Code may help)”다. 2.1.323과 2.1.325 바이너리는 “it isn't open to your account yet”을 쓴다.

Claude Code 2.1.328 바이너리 · Claude Code 2.1.323 바이너리

🟡

이유 it doesn't yet work with the plugin이나 it doesn't yet work with an installed mod가 뜨면 해당 플러그인이나 mod를 꺼야 한다.

원문 표의 두 행 → 확인 “installed mod” 이유는 2.1.323·2.1.325 바이너리에만 있다. “the plugin” 이유는 2.1.326 바이너리에만 있다. 2.1.327(2026-11-17)부터 도구 호출을 검사하는 mod가 있어도 Code Mode가 시작을 거부하지 않는다.

Claude Code 2.1.323 바이너리 · Claude Code 2.1.326 바이너리 · Claude Code 변경 기록 문서

✅

이유 this launch's tool options는 --restricted, --tools, --disallowedTools, deny 규칙 때문에 뜬다.

2.1.328 바이너리 거부 이유는 “this launch's tool options (--restricted, --tools, --disallowedTools or a deny rule) leave it out”이다.

Claude Code 2.1.328 바이너리

✅

이유 couldn't save your answer는 ~/.claude.json에 쓸 수 없을 때 뜬다.

2.1.328 바이너리 문구는 “Claude Code couldn't save your answer in ~/.claude.json”이다.

Claude Code 2.1.328 바이너리

✅

카운트다운 프롬프트 문구는 Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session이다.

2.1.328 바이너리 문구는 “Claude Code will automatically block this request in <남은 시간>, to avoid holding up an unattended session”이다. 남은 시간은 분과 두 자리 초로 찍힌다.

Claude Code 2.1.328 바이너리

🟡

auto 모드에서 앞선 코드가 도는 중에 새 코드가 시작되면 앞선 코드는 분류기 검토를 잃는다. 그 뒤 남은 호출마다 사용자에게 묻는다.

원문 “앞선 코드는 분류기 검토를 잃는다” → 확인 2.1.327 변경 기록은 auto 모드가 두 번째 스크립트도 허용한 경우 앞선 스크립트에 프롬프트와 거부가 뜨던 동작을 버그로 고쳤다. 2.1.327부터 이 프롬프트가 뜨는 조건은 원문 설명보다 좁다.

Claude Code 변경 기록 문서

✅

PreToolUse 훅이 결정을 내지 못하면 onFailure가 없어도 호출을 거부한다. 오류 문구는 the hook failed나 the hook did not finish다.

2.1.328 바이너리의 거부 문구는 “the hook did not finish” 또는 “the hook failed” 뒤에 “, so this call was not run”을 붙인다. 훅 레퍼런스도 Code Mode에서는 PreToolUse 실패와 시간 초과가 다르게 동작한다고 적는다.

Claude Code 2.1.328 바이너리 · 훅 레퍼런스

🟡

종료 코드 126, 127과 128보다 큰 값은 호출 거부로 이어진다. 1 같은 보통 종료 코드는 "onFailure": "block"이 없으면 호출을 통과시킨다.

훅 레퍼런스는 종료 코드 1이 실패 시 차단 설정이 없으면 막지 않는 오류라고 적는다. 126, 127, 128보다 큰 코드를 따로 실패로 보는 규칙은 공식 문서와 바이너리 문자열로 가릴 수 없다.

훅 레퍼런스

✅

command·http 훅에 "onFailure": "continue"를 두면 실패나 시간 초과에도 호출이 진행된다.

2.1.328 바이너리는 onFailure가 “continue”인 훅이 실패해도 호출을 진행시킨다. mcp_tool 훅은 이 예외에서 빠진다. 훅 레퍼런스도 onFailure 값으로 “continue”와 “block”을 둔다.

Claude Code 2.1.328 바이너리 · 훅 레퍼런스

❌

백그라운드가 가능한 세션에서는 UserPromptSubmit 훅이 코드 출력에도 돈다. source가 poll_event일 때 막지 않게 고치면 출력이 통과한다.

원문 “UserPromptSubmit 훅이 코드 출력에도 돈다” → 확인 2.1.328부터 관리 훅을 포함한 UserPromptSubmit 훅은 스크립트 출력에 돌지 않는다. 출력을 가리려면 PostToolUse 훅의 updatedToolOutput을 쓴다. 원문 한계 목록의 훅 항목과 훅 레퍼런스의 같은 문장은 2.1.327까지의 동작이다.

Claude Code 변경 기록 문서 · 훅 레퍼런스

쓸 수 없는 기능과 세션 이동

✅

Code Mode에서는 Remote Control, Claude in Chrome, computer use를 쓸 수 없다.

2.1.328 바이너리의 확인 창 문구는 Code Mode에서 Remote Control, Claude in Chrome, computer use가 꺼진다고 적는다. Remote Control을 쓰려면 변수를 0으로 둔 채 다시 시작하라는 문구도 있다.

Claude Code 2.1.328 바이너리

✅

Code Mode 세션은 Desktop 앱으로 옮길 수 없다.

2.1.328 바이너리 문구는 Code Mode를 쓸 수 없는 곳에서는 세션을 재개할 수 없다고 적는다. 클라우드 세션과 Claude 앱이 이 세션을 이어 가지 못한다는 문장이 이어진다.

Claude Code 2.1.328 바이너리

✅

Code Mode 세션은 백그라운드 세션으로 바꿀 수 없다. /fork로 백그라운드 사본도 만들 수 없다.

2.1.328 바이너리 문구는 백그라운드 세션이 아직 Code Mode를 쓰지 못해 이 세션을 백그라운드로 옮기거나 복사할 수 없다고 적는다.

Claude Code 2.1.328 바이너리


비슷한 기능: Codex와 다른 에이전트 CLI

Codex CLI에는 같은 기능이 있다. 이름도 Code Mode다. Codex는 2026-03-11 0.114.0에 이 기능을 실험 기능으로 넣었다. Claude Code의 v2.1.323(2026-11-12)보다 8개월 빠르다. 2026-11-19 기준 1차 자료로 보면, 다른 에이전트 CLI 16종 가운데 6종에 같은 계열 기능이 있다. 모델이 쓴 코드 한 조각이 에이전트의 도구를 여러 번 부르는 기능이다. Codex CLI, opencode, Amp, Goose, Qwen Code, Factory Droid다. Gemini CLI, Cursor CLI, GitHub Copilot CLI, Aider, OpenHands 5종은 도구 목록에 직접 도구만 있다. Kimi CLI, Crush, Cline CLI, Augment Auggie, Warp 5종은 1차 자료에서 이 기능이 확인되지 않는다.

Codex CLI 판정: 있다

기능 이름은 Code Mode다. 모델은 exec 도구에 JavaScript를 넘긴다. 그 코드가 tools.<이름>()으로 Codex의 다른 도구와 MCP 도구를 부른다.

상태는 둘로 갈린다. 기능 플래그 code_mode는 공식 설정 레퍼런스에 "under development and off by default"로 적혀 있다. Codex 저장소에 묶인 모델 카탈로그는 GPT-5.6·GPT-6.x 계열 10개 모델에 code_mode_only를 지정한다. 숨김 모델 3개에도 같은 값이 있다. 코드상 카탈로그 값이 플래그보다 먼저 적용된다.

근거는 기능 레지스트리, 모델 카탈로그, PR #13418(2026-03-10 병합), 설정 레퍼런스, 설치된 codex-cli 0.167.0의 codex features list다.

Codex CLI는 별도 프로세스의 V8에서 코드를 돌린다

Codex 코어는 codex-code-mode-host라는 별도 프로세스를 띄운다. 코드는 실행마다 새 V8 isolate에서 돈다. 모델에게 주는 도구 설명은 이 환경을 "no Node, no file system, no network access, no console"이라고 적는다. 부작용은 코드가 부른 도구에서만 생긴다. Homebrew로 설치한 codex-cli 0.167.0 패키지에도 약 70MB짜리 codex-code-mode-host 실행 파일이 들어 있다. 그 파일 안에 V8 바인딩(rusty_v8)이 있다.

코드 안의 도구 호출은 Codex의 평소 도구 경로를 탄다. 공식 훅 문서는 JavaScript에서 부른 도구에도 훅 결정이 그대로 적용된다고 적는다. 0.141.0 릴리스 노트는 막는 PostToolUse 훅이 코드 모드의 호출을 거부하도록 고쳤다. MCP 도구는 tools.mcp__서버__도구 이름으로 코드에 노출된다. 중간 결과는 JavaScript 변수에 남는다. 모델에게는 text()·image()로 넘긴 값만 간다.

이 기능은 Node 기반 실험 기능 js_repl(0.100.0, 2026-02-12)에서 출발했다. PR #13418은 code_mode를 "A much narrower and more isolated (no node features) version of js_repl"로 소개했다. PR #15276(2026-03-21)이 런타임을 Node에서 내장 V8로 바꿨다. js_repl은 PR #19410(2026-04-25)으로 빠졌다. PR #36217(2026-07-30) 뒤로 코드는 별도 호스트 프로세스에서만 돈다.

네 가지는 확인 안 됨이다. 실행 중인 계정에 어떤 모델 카탈로그가 적용되는지 모른다. 카탈로그가 지정한 모델에서 Code Mode를 끄는 설정도 찾지 못했다. 호스트 프로세스에 OS 수준 샌드박스가 걸리는지도 소스에서 확인하지 못했다. OpenAI의 토큰·지연 수치도 찾지 못했다. 공식 문서 색인에는 Code Mode 전용 페이지가 없다.

에이전트 CLI 비교표

상태 칸의 뜻: 기본 켜짐 문서상 기본 동작이다. 정식·옵트인 정식 기능이지만 사용자가 켠다. 실험 실험 또는 개발 중 표기가 붙어 있다. 없음 1차 자료의 도구 목록에 이 기능이 없다. 확인 안 됨 1차 자료에서 확인되지 않는다. 토큰·지연 칸은 벤더가 직접 낸 수치만 적는다. 기준일은 2026-11-19다.

도구(벤더)기능 이름코드가 도는 곳과 격리코드에서 부르는 도구MCP 연동토큰·지연 수치상태1차 자료
Claude Code (Anthropic)Code Mode (REPL 도구)사용자 세션 안. 실행 엔진은 문서에 없음Bash·Read·Edit 같은 도구. 예시의 $ 셸과 edit()스크립트가 MCP 서버를 부름(2.1.328 변경 기록)수치 없음실험
환경 변수로 켬. v2.1.323(2026-11-12)
문서 · 변경 기록
Codex CLI (OpenAI)Code Mode (exec·wait)별도 프로세스의 새 V8 isolate. Node·파일시스템·네트워크 없음켜진 도구 전부. tools.<이름>(), ALL_TOOLStools.mcp__서버__도구로 호출수치 없음실험
플래그는 꺼짐. 묶인 카탈로그의 GPT-5.6·6.x는 code_mode_only. 0.114.0(2026-03-11)
도구 설명 · 0.114.0
opencode (Anomaly)Code Mode (execute)opencode 자체 인터프리터. 파일시스템·import·타이머 없음MCP 도구, 파일·스킬·플러그인 도구MCP 서버는 기본으로 Code Mode로만 노출. 서버별 codemode: false수치 없음기본 켜짐
v2(v2.3.2, 2026-11-18). 첫 도입 v1.17.14(2026-07-06)는 옵트인
도구 문서 · MCP 문서
Amp (Amp Frontier Corporation)code mode (tool_search + code_exec)Amp 서버. 언어와 격리 방식은 문서에 없음MCP 도구, 플러그인 도구. 내장 도구는 확인 안 됨MCP 접근의 기본 경로. Ask First 도구는 승인까지 코드가 대기수치 없음기본 켜짐
도입일 확인 안 됨
MCP 문서 · 설정 문서
Goose (Block)Code Mode (확장 code_execution)goose 프로세스 안의 Boa JS 엔진. 실행마다 새 컨텍스트. 파일·셸·네트워크 직접 접근 없음켜진 확장의 도구 전부. tools.call()확장 자체가 MCP 서버(메타 도구 3개)한 실험에서 토큰 30% 감소(Goose 블로그 2026-02-06)정식·옵트인
v1.17.0(2025-12-18)
문서 · v1.17.0
Qwen Code (Alibaba)Code Mode (tools.codeModeOnly, exec)자식 프로세스의 QuickJS(WebAssembly). 호출마다 새 런타임일반·지연·MCP 도구. 일부 제어 도구는 직접 호출만MCP 도구도 tools.<이름>()수치 없음실험
기본 꺼짐. PR #10607 병합(2026-09-11)
설정 문서 · 설계 문서
Factory Droid (Factory)Script 도구 (Script mode)샌드박스. 엔진은 확인 안 됨Droid 도구. tools.*확인 안 됨Opus 5.5에서 비용 15% 감소. 호출 312회 작업을 요청 2회·약 61,000토큰에 처리(Factory 2026-10-29)기본 켜짐
지정 모델. Droid 1.0(2026-10-29)
Factory 글 · 문서
Gemini CLI (Google)없음. 가장 가까운 것은 AfterTool 훅의 tailToolCallRequest해당 없음해당 없음해당 없음해당 없음없음
요청 이슈는 not_planned로 닫힘(2026-04-26)
도구 문서 · 이슈 #17323
Cursor CLI (Anysphere)없음. 가까운 것은 병렬 도구 호출해당 없음해당 없음MCP 도구 설명은 dynamic context discovery로 필요할 때 읽음dynamic context discovery: MCP 도구를 부른 실행에서 토큰 46.9% 감소(2026-01-06, 다른 기법)없음Agent 문서 · Cursor 글
GitHub Copilot CLI (GitHub)없음. 가까운 것은 dynamic workflows(확장에 코드로 정의한 재사용 워크플로)해당 없음해당 없음확인 안 됨해당 없음없음
dynamic workflows는 공개 프리뷰, --experimental
명령 레퍼런스 · dynamic workflows
Aider (Aider-AI)없음. 가까운 것은 모델이 제안하고 사용자가 고르는 셸 명령해당 없음해당 없음MCP 언급 없음해당 없음없음
마지막 릴리스 v0.86.0(2025-08-09)
HISTORY
OpenHands (All Hands AI)없음. 가까운 것은 서브에이전트를 조율하는 WorkflowToolSet해당 없음해당 없음확인 안 됨해당 없음없음
옛 CodeActAgent는 보관됨
SDK 문서
Kimi CLI · Crush · Cline CLI · Augment Auggie · Warp확인 안 됨확인 안 됨확인 안 됨확인 안 됨확인 안 됨확인 안 됨
Warp 문서의 "code mode"는 파일 선택 화면 이름이다
Kimi · Crush · Cline · Auggie · Warp

CLI 밖에서 먼저 나온 같은 계열

실제로 다른 점

  1. 기본값이 갈린다. Claude Code, Qwen Code, Goose는 사용자가 켜야 한다. opencode v2, Amp, Factory Droid는 처음부터 켜져 있다. Factory Droid는 지정 모델에서만 켜진다. Codex는 플래그로는 꺼져 있다. 묶인 카탈로그의 GPT-5.6·GPT-6.x 모델에서는 이 모드가 먼저 적용된다.
  2. 코드가 도는 자리가 다르다. Codex는 별도 프로세스의 V8 isolate에서 돌린다. Qwen Code는 자식 프로세스의 QuickJS(WebAssembly)를 쓴다. Goose는 자기 프로세스 안의 Boa 엔진을 쓴다. Amp는 사용자 컴퓨터가 아닌 Amp 서버에서 돌린다. Claude Code 문서는 "your session"이라고만 적고 엔진을 밝히지 않는다.
  3. 호출 단위 검사는 모두 남는다. 차이는 코드 전체를 누가 보느냐다. Claude Code는 auto mode 분류기가 실행 전에 코드를 한 번 검토한다. 분류기는 실행 중에 계산된 값을 보지 못한다. Codex 훅 문서는 코드 안 호출에도 훅 결정을 적용한다. Factory Droid는 Script 안 호출에 PostToolUse 훅을 돌리지 않는다. Amp는 Ask First 도구를 부른 코드를 승인까지 세운다.
  4. 코드가 닿는 도구의 범위가 다르다. Codex와 Goose는 켜진 도구 전부를 코드에 내준다. opencode와 Amp는 MCP 도구가 중심이다. Amp 문서는 셸·편집 같은 내장 도구를 코드에서 부를 수 있는지 밝히지 않는다. Claude Code 문서의 예시는 셸 명령과 파일 편집이다. MCP 호출은 변경 기록에만 나온다.
  5. 절감 수치는 서로 비교할 수 없다. Claude Code, Codex, opencode, Amp, Qwen Code는 수치를 내지 않았다. Factory는 비용 15% 감소를, Goose는 실험 1건의 토큰 30% 감소를 적는다. Anthropic의 98.7%와 Cloudflare의 1,000토큰은 도구 정의를 덜 싣는 효과를 잰 값이다. Claude API 문서에는 이득이 없는 작업의 결과도 있다.
  6. Claude Code는 CLI 가운데 늦게 왔다. 1차 자료의 첫 날짜는 Goose 2025-12-18, Codex 2026-03-11, opencode 2026-07-06, Qwen Code 2026-09-11, Factory Droid 2026-10-03, Claude Code 2026-11-12 순이다. Factory의 2026-10-29 글은 이 방식을 코딩 에이전트에 가져온 쪽으로 Codex를 꼽는다.

원본 (완역)

Code Mode를 써 본다. Code Mode는 Claude가 한 단계에서 여러 도구 호출을 수행하는 JavaScript를 작성하는 실험 기능이다.

Code Mode는 Claude가 도구를 쓰는 방식을 바꾼다. Code Mode가 없으면 Claude는 Bash, Read, Edit 같은 도구 호출을 직접 요청하고, 다음에 무엇을 할지 정하기 전에 각 결과를 읽는다. Code Mode에서는 Claude가 도구 호출을 수행하는 JavaScript 코드 한 조각을 작성하고, Claude Code가 그 코드를 사용자의 세션에서 실행한다.

Code Mode 작동 방식

Code Mode 세션에서도 작업은 여전히 프롬프트로 설명하고, Claude는 그 작업을 수행할 JavaScript를 작성한다. 코드 한 조각은 명령을 병렬로 실행하고, 한 결과를 다음 호출에 쓰고, 출력 가운데 Claude가 읽어야 하는 부분을 돌려줄 수 있다.

예를 들어 Claude에게 재시도 한도를 올려 달라고 하면, Claude는 파일을 찾고, 수정하고, 테스트를 실행하는 다음과 같은 코드를 작성할 수 있다. 마지막 줄은 파일 경로와 테스트 출력을 Claude에게 돌려준다:

const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });

대화에는 코드가 아니라 수정의 diff 같은 도구 호출이 보인다. 코드를 읽으려면 Ctrl+O를 눌러 transcript viewer를 연다. 그곳에서 코드 한 조각은 각각 접힌 Code 행으로 나타나며, 펼치는 방법을 알려 주는 힌트가 함께 붙는다.

Code Mode를 쓸 때

관련된 도구 호출이 많이 필요한 작업에서 Code Mode를 써 본다. 예를 들면 다음과 같다:

Code Mode의 제약

Code Mode를 켜기 전에, 다음 제약을 받아들일 수 있는지 확인한다:

요구 사항

API 키 헬퍼, OpenTelemetry 내보내기, DISABLE_TELEMETRY 같은 일부 설정이 켜져 있을 때도 Code Mode를 시작할 수 없다. 각각의 해결 방법은 Code Mode가 시작되지 않을 때를 참고한다.

Code Mode 써 보기

Code Mode를 켜고, Claude에게 작업을 맡기고, Claude가 작성한 코드를 살펴본다.

1. 버전 확인

claude --version을 실행한다. 버전이 v2.1.323보다 오래되었으면 claude update를 실행한다. stable 채널을 쓰고 있는데 업데이트해도 v2.1.323에 이르지 않으면, stable이 따라잡을 때까지 기다리거나 latest로 전환한다.

2. Code Mode를 켠 채 Claude Code 시작

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 환경 변수를 1로 설정한다. Code Mode를 써 보려면 셸에서 설정한다. 모든 새 세션에서 Code Mode를 켜려면 사용자 설정에서 설정한다.

macOS, Linux, WSL
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Windows PowerShell
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude
settings.json

이 env 블록을 ~/.claude/settings.json에 저장하고 claude를 시작한다:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
  }
}

Claude Code는 프로젝트의 설정 파일에 있는 이 변수를 무시하므로, 클론한 저장소가 사용자 대신 Code Mode를 켤 수는 없다.

3. Code Mode를 쓰겠다고 확인

Claude Code는 첫 Code Mode 세션 전에 확인을 요청한다. Yes, turn on Code Mode를 선택한다. Claude Code가 다시 시작하고 세션 상단 근처에 다음 줄을 보여 준다:

Code Mode (experimental) is on · this session can be resumed only with Code Mode on

번역: Code Mode(실험 기능)가 켜졌다 · 이 세션은 Code Mode를 켠 상태에서만 재개할 수 있다

다른 줄이 보이거나 아무 줄도 보이지 않으면 Code Mode가 시작되지 않을 때를 참고한다.

4. 도구 호출이 많은 작업을 Claude에게 맡기기

잘 아는 프로젝트에서 다음과 같은 프롬프트를 보낸다:

Read every Markdown file in this project and list the links that point to local files that don't exist.

번역: 이 프로젝트의 Markdown 파일을 모두 읽고, 존재하지 않는 로컬 파일을 가리키는 링크를 나열하라.

5. Claude가 작성한 코드 읽기

Ctrl+O를 누르고 Code 행을 펼치면 도구 호출 뒤에 있는 JavaScript가 보인다. 대화로 돌아가려면 Ctrl+O를 다시 누른다.

Code Mode 끄기

셸과 ~/.claude/settings.json에서 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE를 제거한 뒤 새 세션을 시작한다. 변수를 그대로 두고 어느 한 곳에서 값을 0으로 바꿔도 된다. 한 곳에 0이 있으면 다른 곳에 1을 설정해도 Code Mode는 꺼진 채로 있다.

조직 단위로 Code Mode 막기

조직의 누구도 Code Mode를 쓸 수 없도록, 관리형 설정에 값이 0인 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE를 추가한다:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
  }
}

Code Mode 세션 중인 사용자는 종료하거나 Claude Code를 다시 시작할 때까지 그 세션에 머문다. 그 뒤로 사용자는 Code Mode 없이 시작하며, 0이 설정되어 있는 동안에는 자신의 Code Mode 세션을 재개할 수 없다. 관리형 설정으로 사용자에게 Code Mode를 켜 줄 수는 없다.

권한과 오래 걸리는 코드

권한 모드는 Claude가 작성한 코드를 어떻게 확인할지, 그리고 코드가 실행되는 동안 Claude와 대화할 수 있는지를 결정한다.

권한 확인

Claude가 코드를 실행하면, 그 안의 각 도구 호출은 Bash처럼 그 도구의 평소 이름으로 deny·ask 권한 규칙과 PreToolUse 훅을 거친다. 규칙과 훅 외에도, auto mode에서는 분류기가 코드를 검토하고, 확인을 묻는 모드에서는 사용자가 프롬프트에 답한다:

셸 명령을 허용하거나 차단하는 PreToolUse 훅이 있다면, Bash 규칙이 그러듯 명령의 각 부분을 확인하게 만든다. Code Mode에서는 app이라는 폴더에서 실행한 git push가 cd 'app' && git push 형태로 훅에 도달할 수 있다.

코드 자체를 확인하려면, 코드를 실행하는 도구인 REPL에 매칭되는 PreToolUse 훅을 작성하고 tool_input.code에서 JavaScript를 읽는다.

오래 걸리는 코드

코드가 긴 빌드나 테스트를 실행하는 동안, Claude는 그것을 기다리거나 백그라운드에서 계속 실행되게 둔다:

백그라운드 코드를 쓰려면 세션을 auto mode나 bypassPermissions 모드로 시작한다. 그래도 Claude가 기다린다면, 현재 모드와 세션을 시작한 방식을 확인한다:

문제 해결

Code Mode가 시작되지 않을 때

세션 상단 근처에 Code Mode (experimental) isn't available이 보이면 Claude Code가 Code Mode 없이 시작했다는 뜻이다. 같은 줄에 이유가 이어서 나오고, /status에도 표시된다. 이 표에서 이유를 찾아 해당 변경을 하고 새 세션을 시작한다. 표에 없는 이유라면 요구 사항을 확인한다.

이유 문구에 포함된 것할 일
it isn't open to your account in this version 또는 it isn't open to your account yet버전이 v2.1.323보다 오래되었으면 업데이트한다. 그렇지 않으면 네트워크 연결을 확인하고 다시 시작한다. 이유가 계속 남아 있으면 다른 날 다시 시도한다
it only works directly with the Anthropic API 또는 it only works with the Anthropic API요청을 클라우드 제공자, 게이트웨이, 사용자 지정 ANTHROPIC_BASE_URL을 거쳐 보내는 설정을 제거한다
it doesn't work with an API key helperapiKeyHelper, ANTHROPIC_AUTH_TOKEN, 그리고 ANTHROPIC_CUSTOM_HEADERS 안의 Authorization 또는 X-Api-Key 헤더를 모두 제거한다. 그런 다음 로그인하거나 ANTHROPIC_API_KEY를 설정한다
it only works with Opus 5.5, Sonnet 5.5 and later models예를 들어 --model opus처럼 지원되는 모델로 시작한다. Haiku 5.5와 Fable 5.2도 작동한다
it doesn't work in background jobs--remote-control 없이 포그라운드에서 시작한다. 이유가 팀원의 분할 창에 나타나면, 팀원을 Code Mode로 실행하도록 in-process 표시 모드를 쓴다
it needs settings that Claude Code downloads from AnthropicDISABLE_TELEMETRY처럼 기능 플래그 가져오기를 끄는 변수를 해제한다
OpenTelemetry is onOpenTelemetry 내보내기 없이 작업할 수 있다면 CLAUDE_CODE_ENABLE_TELEMETRY와 ENABLE_BETA_TRACING_DETAILED를 해제한다
it doesn't yet work with the plugin세션에서 /plugin을 실행하고, 이유 문구에 이름이 나온 플러그인을 모두 비활성화한다. 조직이 켠 플러그인이 있다면 관리자에게 꺼 달라고 요청한다
it doesn't yet work with an installed mod도구 호출을 검사하는 mod를 끈다
it can't be used together with agent teams yetagent teams를 계속 켜 두려면 Claude Code를 업데이트해 v2.1.326 이상으로 올린다. 현재 버전에 머물려면 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS를 해제한다
this launch's tool options--restricted 없이 시작하고, --tools에 REPL을 추가하고, --disallowedTools와 deny 규칙에서 REPL을 제거한다
couldn't save your answer~/.claude.json을 쓰기 가능하게 만든다
your organization's settings don't allow it관리형 설정에 대해 관리자에게 문의한다

Code Mode에 관한 줄이 아예 보이지 않으면 claude --version을 실행한다. 버전이 v2.1.323보다 오래되었으면 업데이트한다. 그런 다음 셸이나 사용자 설정에서 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE가 1인지 확인하고, 그곳들과 모든 --settings 파일에서 0을 제거한다.

카운트다운이 뜨는 권한 프롬프트

auto mode에서 앞선 코드가 아직 실행 중일 때 Claude가 코드를 더 시작하면, 앞선 코드는 분류기 검토를 잃는다. 그러면 Claude Code는 앞선 코드의 남은 호출 가운데 검토가 필요했을 호출에 대해 사용자에게 묻는다. IDE가 연결되어 있지 않으면 프롬프트에 카운트다운이 표시된다:

Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session

번역: 지켜보는 사람이 없는 세션이 멈춰 있지 않도록, Claude Code는 1:59 뒤에 이 요청을 자동으로 차단한다

카운트다운이 끝나기 전에 답한다. 그러지 않으면 그 호출은 거부되고, 이후 카운트다운이 떴을 호출은 프롬프트 없이 거부된다. 프롬프트를 다시 보려면 Claude에게 메시지를 보낸다.

훅이 도구 호출을 거부할 때

Claude가 거부된 도구 호출을 보고하면, Claude에게 오류 문구를 물어본다. 다음 오류는 PreToolUse 훅이 결정을 내리지 않았다는 뜻이며, 이 경우 onFailure를 설정하지 않았더라도 호출이 거부된다:

command나 http 훅이 실패하거나 시간 초과될 때 호출을 진행시키려면, 그 훅에 "onFailure": "continue"를 설정한다. command 훅이 1 같은 일반 코드로 종료되면, "onFailure": "block"을 설정하지 않은 한 호출은 진행된다.

훅이 코드 출력을 막을 때

코드의 출력을 기대한 자리에 Claude가 훅의 차단 이유를 보고하면, UserPromptSubmit 훅을 확인한다. 코드를 백그라운드에서 실행할 수 있을 때는, 그 이벤트에 걸린 command, http, mcp_tool 훅이 코드 출력에도 실행된다. 출력을 통과시키려면, 입력의 source가 poll_event일 때는 차단하지 않도록 훅을 바꾼다.

관련 자료


원본 링크·인용

원문

Run tool calls from code with Code Mode — code.claude.com, Anthropic. 본문 링크 49개는 완역의 같은 자리에 있다.

원문이 링크한 문서 21개

팩트체크와 비교에 쓴 주요 1차 자료

판정마다 붙은 개별 출처는 팩트체크 블록과 비교표의 출처 칸에 있다.


기타

용어

REPL

Code Mode에서 Claude가 쓴 JavaScript를 실행하는 도구의 이름이다. 코드 자체를 검사하는 PreToolUse 훅은 이 이름에 맞춘다.

auto mode 분류기

auto mode에서 권한 프롬프트 대신 허용 여부를 가르는 모델이다. Code Mode에서는 호출 하나하나 대신 코드 한 조각을 실행 전에 검토한다.

훅(hook)

도구 호출 전후나 프롬프트 제출 때 사용자가 정한 명령을 돌리는 Claude Code 기능이다. PreToolUse는 호출 전, PostToolUse는 호출 뒤, UserPromptSubmit은 프롬프트 제출 때 돈다.

MCP

Model Context Protocol. 에이전트가 외부 서버의 도구를 부르는 표준이다. 비교표의 도구 대부분이 Code Mode의 주 대상으로 MCP 도구를 꼽는다.

V8 isolate · QuickJS · Boa

JavaScript를 돌리는 엔진이다. V8 isolate는 V8 엔진 안의 격리된 실행 단위다. QuickJS와 Boa는 다른 프로그램 안에 넣어 쓰는 작은 JavaScript 엔진이다.

이 페이지의 구성

「비슷한 기능: Codex와 다른 에이전트 CLI」 블록은 원문 문서에 없는 추가 블록이다. 내용은 각 도구의 공식 문서와 저장소, 변경 기록에서 가져왔다. 기준일은 2026-11-19다. 그 블록에서 1차 자료로 확인되지 않는 항목은 "확인 안 됨"으로 적었다.

완역 블록은 원문 본문을 전량 싣는다. 코드 블록과 화면 문구는 원문 그대로 둔다. 영어 문구가 그대로 남은 코드 블록 3곳에는 바로 아래에 번역을 붙였다. 원문에는 이미지가 없다.

원문의 판

원문 페이지는 날짜와 저자를 표시하지 않는다. 완역한 판은 2026-11-19 공개판이다. 그날 최신 Claude Code는 2.1.328이다. 팩트체크가 짚은 두 절은 2.1.328에서 바뀐 동작이다.