Claude Code v2.1.283, 모델 허용/차단 설정 및 프롬프트 감사 추가

Claude Code v2.1.283이 출시되었으며, 주요 변경 사항은 관리 기능입니다. 조직에서 특정 모델을 고정하거나 차단할 수 있는 두 가지 새로운 관리 설정과 구 모델에 맞춰 작성된 오래된 프롬프트 패턴을 찾아내는 프롬프트 감사 명령이 추가되었습니다.

모델 제어 설정

• availableModelsMatch: "exact"로 설정하면 각 availableModels 항목이 명시한 모델 버전만 허용됩니다. 관리자가 새 릴리스를 명시적으로 추가할 때까지는 차단된 상태로 유지됩니다.
• deniedModels: availableModels에서 허용하더라도 특정 모델을 차단합니다.

이 두 가지를 조합하면 엄격한 허용 목록 위에 거부 목록을 얹는 셈이므로, 롤아웃 과정에서 새 모델 버전이 몰래 선택되는 일이 없습니다.

프롬프트 감사 및 OTEL 콘텐츠 로깅

• /doctor prompt-audit(/checkup prompt-audit도 가능)는 CLAUDE.md 파일, 스킬, 에이전트, 명령에서 구 모델에 맞춰 작성된 프롬프트 패턴을 감사합니다.
• OTEL_LOG_TOOL_CONTENT=1로 설정하면 MCP 도구, WebFetch, WebSearch 출력이 tool.output OpenTelemetry 스팬 이벤트에 추가됩니다.

게이트웨이 추가 사항

• 새 힌트 헤더 x-claude-code-prompt-id를 사용하면 LLM 게이트웨이가 하나의 사용자 프롬프트를 처리하는 요청들을 그룹화할 수 있습니다. CLAUDE_CODE_GATEWAY_HINT_HEADERS=1로 활성화합니다.
• Claude 앱 게이트웨이 구성의 선택적 load_test_mode 블록은 요청을 생성하고 서명하지만 업스트림으로 전송하지 않으며, 클라이언트에는 미리 준비된 응답을 반환합니다. 따라서 배포를 격리된 환경에서 부하 테스트할 수 있습니다.
• Amazon Bedrock의 Mantle 엔드포인트를 위해 Claude 앱 게이트웨이에 mantle 업스트림 제공자가 추가되었습니다.

주요 수정 사항

• SDK 세션에서 턴이 조기에 종료될 때 지연된 도구 호출이나 완료된 도구 결과가 유실되지 않으며, 워커 재시작 후 승인 프롬프트가 유지되는 문제와 비스트리밍 폴백의 result.usage 문제도 수정되었습니다.
• 장시간 실행되는 도구 호출이 백그라운드로 전환된 후에도 MCP 진행 알림이 더 이상 버려지지 않고, 백그라운드 작업에 최신 진행 상황이 표시됩니다.
• 세션이 시작 도중 종료될 때 stdio MCP 서버가 계속 실행된 채로 남는 문제가 수정되었습니다.
• 무상태 원격 MCP 서버(예: 재배포 중인 프록시)의 일시적인 HTTP 404로 인해 해당 서버가 연결된 것으로 표시되면서 세션 내내 사용할 수 없게 되는 문제가 수정되었습니다.
• 유효한 URL이 없는 서버의 MCP 로그인이 불투명한 SDK 오류로 실패하지 않으며, /mcp에서 해당 서버에 대한 Authenticate 옵션이 더 이상 표시되지 않습니다.
• /model이 ID에 날짜나 -v1:0 접미사가 있는 경우 Sonnet 4.6 또는 Sonnet 5와 [1m]을 허용하며, 선택기에서 ANTHROPIC_DEFAULT_HAIKU_MODEL이 다른 모델을 고정할 때 하드코딩된 Haiku 버전과 가격이 더 이상 표시되지 않습니다.
• 모델 폴백 중에 시작된 동적 워크플로가 더 이상 모든 에이전트를 폴백 모델에서 실행하지 않습니다.
• Haiku가 세션의 주 모델일 때 DISABLE_PROMPT_CACHING_HAIKU가 이제 적용됩니다.
• 플러그인 수정 사항: 유효성 검사에서 설치할 수 없는 이름을 더 이상 허용하지 않고, outputStyles/themes/monitors/lspServers 경로가 없거나 플러그인 디렉터리 밖에 있는 경우를 잡아내며, plugin.json에 선언된 MCP 서버를 보고하고, marketplace remove가 제거한 항목을 나열하며, uninstall에서 대소문자만 다른 ID 충돌을 수정하고, 유효하지 않거나 읽을 수 없는 레코드가 있는 installed_plugins.json 파일을 복구합니다.
• /context가 이제 MCP 서버 지침을 별도 행으로 집계합니다.

추가된 사항: 전체 화면 모드에서 다른 세션의 잘린 메시지에 대한 클릭 확장, stream-json system/init plugin_errors의 --plugin-dir 로드 실패 항목에 path 포함, 텔레메트리 비활성화 시 주간 Fable 한도가 /usage 및 VS Code 미터에 표시되지 않던 문제 수정, 화면 읽기 프로그램 권한 대화 상자에서 따옴표로 묶인 명령과 경로를 대화 상자 텍스트로 읽지 않도록 수정되었습니다.