Claude Code 2.1.323, 실험적 Code Mode 추가하고 Bash 및 샌드박스 권한 검사 강화

릴리스 노트에 따르면 2026년 11월 12일 출시된 Claude Code v2.1.323에는 다음 기능이 추가됩니다.

• Code Mode: Claude가 JavaScript를 작성해 도구를 호출하는 실험적 옵트인 기능입니다. 문서에서 이 기능을 켜는 방법과 조직 전체에서 끄는 방법을 설명합니다.
• 플러그인: plugin.json에서 engines["claude-code"]를 지정할 수 있습니다. 명시된 Claude Code 버전 범위를 벗어나는 플러그인은 설치, 업데이트 또는 로드되지 않으며, 설치 및 업데이트 시 조건에 맞는 최신 버전이 선택됩니다. 이제 claude plugin validate는 플러그인의 TypeScript hooks 모듈의 타입을 검사하며, --strict를 사용하면 발견 사항이 있을 경우 실패합니다.
• 사용량 크레딧: 모델에 사용량 크레딧이 필요하지만 크레딧이 꺼져 있거나 소진된 경우, 옵션 메뉴(중지, 사용량 크레딧으로 전환, 업그레이드)가 표시됩니다. Fable의 주간 한도 메시지와 초기화 시각에 관한 수정도 포함됩니다.
• 기타 추가 사항: 서드파티 제공업체를 이용하는 Claude Desktop 세션의 관리형 설정에 CLAUDE_CODE_AUTO_MODE_MODEL이 추가되고, Artifact 도구의 에셋 업로드에서 .docx를 지원합니다. 또한 claude -p 및 SDK 세션에서 훅이 오래 실행될 때 30초마다 진행 상태를 알리고, Bash 허용 규칙에서 변수 값에 *가 포함된 경우 시작 시 경고합니다.

권한 및 샌드박스. 이번 릴리스에서는 권한 확인 없이 Bash 명령이 실행되거나 샌드박스 밖에서 실행될 수 있었던 여러 사례를 수정했습니다(와일드카드가 포함된 허용 규칙(예: Bash(ls*)), 결합된 sudo 플래그, sudo 및 env 뒤에서 적용되지 않던 거부 및 확인 규칙, sandbox.excludedCommands, 잘못된 폴더를 기준으로 판단한 rm, Read 거부 규칙 아래의 경로에 도달하는 Write 및 Edit). 기존 설정에 영향을 줄 수 있는 변경 사항은 다음과 같습니다.

• 이제 --permission-mode auto 또는 defaultMode: auto를 설정해도 자동 모드를 사용할 수 없으면 Manual 모드로 시작합니다.
• 비밀 정보가 포함된 것으로 보이거나 Git 추적 대상인 settings.local.json에 저장될 수 있는 "다시 묻지 않기" 규칙은 해당 세션에서만 유지됩니다.
• macOS, Linux 및 WSL에서 Bash 샌드박스는 다른 위치를 가리키는 심볼릭 링크를 통해 부여된 쓰기 권한을 무시하며, 샌드박스 안에서는 git worktree add, move, remove가 읽기 전용으로 실패합니다.
• sandbox 키가 포함된 --settings 파일이 유효한 JSON이 아니면 시작이 중단됩니다.
• /security-review는 실행 전에 확인을 요청하며, .git 폴더가 링크이거나 하드 링크를 포함한 체크아웃에서는 worktree 생성을 거부합니다.
• 인식할 수 없는 모델 ID에 적용되는 컨텍스트 창 가정값이 200K에서 1M으로 변경됩니다. CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정하면 200K를 유지합니다.
• 하나의 세션이 확인 없이 다른 세션에 보낼 수 있는 메시지 수가 약 20개에서 100,000개로 늘어납니다.
• subagentStatusLine 설정이 제거되고, 플러그인의 agent 설정은 더 이상 사용되지 않으며 이제 경고가 표시됩니다.

이번 릴리스에는 Remote Control, 웹용 Claude Code, VS Code, Claude Tag(Enterprise 플랜에서 베타로 제공되는 Compliance API의 Slack 세션 포함), Code Review(검토 비용 CSV 내보내기) 관련 변경 사항과 로그인, MCP, OpenTelemetry 내보내기 및 터미널 표시 관련 다수의 수정 사항도 포함됩니다.