v2.1.325부터는 Claude Code가 샌드박스(sandbox) 내에서 실행되는 Bash 명령에 대해 기본적으로 일반적인 허가 흐름을 거치도록 변경되었습니다. 샌드박스 내부의 Bash를 프롬프트 없이 실행하던 환경은 sandbox.autoAllowBashIfSandboxed: true 설정이 없으면 이전 상태를 유지할 수 없습니다. 이번 7개 버전에는 Claude Fable 5.2가 기본 Fable 모델로 지정된 v2.1.321도 포함되어 있습니다.
| 변경 사항 | 버전 | 관련 환경 |
|---|
| 샌드박스 내 Bash가 기본적으로 일반적인 허가 흐름을 거치게 함 | v2.1.325 | 샌드박스를 활성화한 경우<br>allowed-tools 또는 hooks를 선언한 skill 앞에서 스케줄러 작업(scheduler task)과 /loop가 확인 절차를 요청함 |
| v2.1.325 | 비인간 실행 (Unmanned execution) | |
Claude Fable 5.2 (claude-fable-5-2)가 기본 Fable 모델로 지정됨 | v2.1.321 | Fable을 사용하는 경우 |
| 인식할 수 없는 모델 ID의 컨텍스트 창(context window)을 1M으로 간주함 | v2.1.323 | 게이트웨이 경유 및 타사 모델 |
| 텔레메트리 또는 feature flag를 비활성화한 auto mode가 내장 분류기로 돌아가지 않음 | v2.1.319 | LLM 게이트웨이 경유 등 |
self-paced의 /loop가 다음을 예약하지 않는 턴에서 종료됨 (CLAUDE_CODE_LOOP_KEEPALIVE=1로 기존과 동일) | v2.1.319 | 간격 지정 없는 /loop |
| Read의 '이전부터 변경 없음' 스텁(stub)을 폐지하고, 다시 읽으면 내용을 반환함 | v2.1.317 | 같은 파일을 여러 번 읽는 세션 |
| Claude가 JavaScript를 작성하여 툴을 호출하는 Code Mode를 실험적인 opt-in 방식으로 추가함 | v2.1.323 | 활성화한 경우에만 해당 |
v2.1.325에서 샌드박스 내 Bash에 대한 자동 허용이 기본적으로 해제되었습니다.
Changed sandboxed Bash commands to follow the normal permission flow by default; set sandbox.autoAllowBashIfSandboxed: true to keep running them without prompts
Claude Code는 v2.1.325부터 샌드박스 안에서 작동하는 명령어도 일반적인 허가 흐름으로 판단합니다. 설정의 sandbox에 autoAllowBashIfSandboxed가 true로 되어 있다면, 샌드박스 내부의 명령어는 이전과 같이 프롬프트 없이 실행됩니다.
{
"sandbox": {
"enabled": true,
...
}
관리 설정에서 샌드박스를 활성화한 조직의 경우, 가장 우선순위가 높은 관리 설정 소스에 동일한 키가 있다면 프롬프트 없는 실행이 계속됩니다.
샌드박스가 쓰기를 거부하는 위치도 v2.1.323과 v2.1.325에서 증가했습니다.
-
추가 디렉토리에 있는 .claude의 settings, skills, agents, commands, hooks에 대한 쓰기 권한을 시작 폴더와 마찬가지로 거부합니다 (v2.1.325) - macOS 및 Linux에서는 git worktree add, move, remove가 읽기 전용으로 실패합니다. 세션을 시작한 worktree에서도 전달된 worktree가 아닌 worktree에서의 커밋은, 해당 worktree가 프로젝트 내에 있더라도 실패합니다 (v2.1.323) - macOS・Linux・WSL에서는 쓰기가 가능한 폴더 안의 심볼릭 링크가 다른 위치나 존재하지 않는 경로를 가리킬 때, 그 링크를 통한 쓰기 권한을 무시합니다. 쓰게 하려면 실제 경로에 대한 허가가 필요합니다 (v2.1.323)
-
스케줄러 작업과 /loop는 allowed-tools 또는 hooks를 선언한 skill을 실행하기 전에 확인 절차를 요청합니다. permissions.allow에 Skill(name)
자동으로 작동합니다 (v2.1.325) - 프로젝트 소유이거나 신뢰된 리포지토리가 아닌 곳에서는 읽기 전용 git 명령어만으로도 확인이 발생할 수 있습니다.
--add-dir
로 지정한 리포지토리의 경우 확인 없이 작동하며, additionalDirectories 설정으로 지정했을 때는 확인 없이 작동하지 않습니다 (v2.1.325) - Desktop, IDE, SDK의 'Always allow' 기능에서는 저장된 규칙을 사용하여 동일한 명령어가 다음에도 통과될 때만 해당 규칙 단독이 선택지로 나타납니다. 개별 규칙에 의존하던 스케줄링 작업은 응답을 기다릴 수 있습니다 (v2.1.325).
- 텔레메트리(Telemetry) 또는 feature flag가 꺼진 auto mode (LLM Gateway 경유 포함)의 경우, 서버가 판별할 수 없는 호출은 확인 대상으로 넘기거나 거부하며, 내장 분류기(built-in classifier)로 돌아가지 않습니다.
CLAUDE_CODE_AUTO_MODE_SERVER=0
으로 설정하면 내장 분류기를 계속 사용하게 되며, Bedrock, Vertex, Foundry는 변경되지 않습니다 (v2.1.319).
v2.1.319에서는 permissions.denyInsteadOfPrompting도 추가되었습니다. 이는 프롬프트 대기(prompt waiting)가 되어야 할 도구 호출을 거부하고 턴을 계속 진행하는 설정이며, 터미널 세션, 서브 에이전트, 팀메이트에게 적용됩니다.
v2.1.321에서 Claude Fable 5.2 (claude-fable-5-2)가 추가되어 기본 Fable 모델이 되었습니다. 컨텍스트는 1M이며, 비용은 Mtok당 8 / 40 USD이고 캐시 읽기는 Mtok당 0.20 USD입니다.
저장된 Fable 5.1 지정은 Pro 및 Max에서는 즉시, Team 및 Enterprise에서는 조직이 허가하는 시점에 fable로 전환됩니다. /model claude-fable-5-1 명령어로 5.1로 되돌릴 수 있습니다.
v2.1.323부터 Claude Code는 인식할 수 없는 모델 ID의 컨텍스트 창을 200K가 아닌 1M으로 간주합니다. 원문에 따르면, 창 크기가 작은 타사 모델 세션에서는 창이 가득 차면 /clear를 할 때까지 매 턴 실패하는 경우가 있을 수 있습니다.
| 설정/명령어 | 작동 방식 | 기재된 버전 |
|---|
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 | 인식할 수 없는 모델 ID를 200K로 유지 처리 | v2.1.323 |
/autocompact | compact 속도를 높임 (빨리 진행) | v2.1.323 |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | claude-로 시작하는 알 수 없는 ID (claude-sonnet-latest 등)의 창 크기도 결정함 | v2.1.325 |
v2.1.317부터 v2.1.325까지 7개 버전에는 총 869 항목이 있으며, 이 중 556개가 Fixed이고 136개가 Changed입니다. Changed 항목 중 사다리고리(sandbox) 내 Bash의 자동 허용 (v2.1.325), 알 수 없는 모델 ID의 컨텍스트 창 (v2.1.323), auto mode의 내장 분류기로의 폴백 (v2.1.319), self-paced의 /loop 종료 방식 (v2.1.319) 모두 설정 키 또는 환경 변수를 통해 이전 동작으로 되돌릴 수 있습니다.