Claude Code v2.1.307: /claude-api 버전 관리, 안전 이벤트 텔레메트리 및 MCP 안정성 수정

Claude Code v2.1.307은 Claude API 코드용 API 버전 고정과 도구 호출별 안전 텔레메트리라는 두 가지 개발자 대상 추가 기능과 함께 MCP, 러너, 세션 상태 관련 수정 사항을 다수 포함합니다.

새 기능: API 버전 고정 및 안전 이벤트 텔레메트리

• /claude-api api-version은 Claude API 코드를 API 버전 2026-10-21로 이동합니다. 생성된 API 호출이 모델 기본값 대신 특정 날짜 버전을 대상으로 해야 할 때 유용합니다.
• 새 OpenTelemetry 이벤트인 claude_code.safety_event는 권한 규칙, 자동 모드, 안전 검사, 훅 또는 샌드박스가 중지, 프롬프트 또는 반환한 각 도구 호출에 대해 발생합니다. 이를 통해 에이전트 루프의 모든 개입에 대한 구조화된 추적을 얻을 수 있어, 트랜스크립트에서 유추할 필요가 없습니다.

주요 수정 사항

• 1M 컨텍스트 별칭: CLAUDE_CODE_DISABLE_1M_CONTEXT가 설정되어 있고 모델이 [1m] 접미사가 붙은 별칭(예: opus[1m])인 경우 더 이상 모델을 찾을 수 없음 오류로 요청이 실패하지 않습니다.
• 프롬프트 캐싱: prompt-caching-scope 베타 헤더가 효과가 없던 사용자 지정 ANTHROPIC_BASE_URL 게이트웨이 뒤 또는 Foundry에서 더 이상 전송되지 않습니다.
• macOS의 MCP 인증: 로그인 키체인이 잠겨 있을 때 claude -p가 더 이상 "인증 필요"를 보고하지 않고 이유를 알려주며, 잠금 해제 후 다음 실행은 새 로그인 없이 연결됩니다.
• MCP 절전/시간 초과: macOS 또는 Linux 머신이 절전 상태인 동안 연결 중이던 서버가 더 이상 시간 초과로 보고되어 헤드리스 실행에서 실패로 고정되지 않습니다.
• HTTP MCP 이중 호출: 호출 중 연결이 닫힐 때 도구 호출이 더 이상 두 번 전송되지 않으며, 읽기 전용 또는 멱등성 도구만 재시도됩니다.
• SDK MCP 도구: 백그라운드 작업이 실행 중일 때 SDK MCP 서버의 최신 도구 없이 턴이 시작되지 않습니다.
• 자동 압축: 많은 PDF 페이지, 이미지 또는 대형 도구 결과를 읽는 턴에서 "Autocompact is thrashing" 오류가 감소했으며, 클라우드 세션의 /autocompact도 재시작 후 창을 유지합니다.
• /clear 지속성: /clear로 지운 대화가 클라우드 또는 자체 호스팅 러너 세션 재시작 후 다시 나타나지 않습니다.
• Agent SDK setModel(): API 확인에 5초 이상 걸릴 때 모델 전환이 거부되지 않으며, Claude Code는 이제 최대 15초까지 기다립니다.
• 권한 UI: /permissions > Recently denied에 거부된 셸 명령이 표시되고, 행을 승인하면 설명 대신 명령 이름이 표시되며, 자동 모드의 로컬 분류기가 재시도된 명령에서 해당 승인을 존중합니다.
• GitHub MCP 쓰기 도구: 서버가 직접 구성된 경우 데스크톱 앱의 Code 탭에서 아무것도 생성하지 않고 닫히던 양식을 수정했습니다.

기타 개선 사항

• 구문 분석할 수 없는 도구 호출은 턴이 오류로 끝나기 전에 최대 두 번 재시도됩니다.
• 함께 시작된 포크 하위 에이전트는 각자 자신의 시작임을 알려 받아 교차 시작 작업이 줄어듭니다.
• 브라우저 로그인은 계정 프로필을 기다리지 않고 로그인이 완료되는 즉시 성공 페이지를 표시합니다.
• 클라우드 및 자체 호스팅 러너 세션의 웹 검색 403 오류가 이제 일반적인 "인증 오류" 대신 서버의 이유를 표시합니다.
• 큰 붙여넣기 이미지 또는 PDF 읽기가 있는 세션의 원격 제어 연결 시간이 개선되었습니다.
• WebSearch 예산 소진 알림이 이제 Claude에게 브라우저나 컴퓨터 사용을 통해 검색 엔진을 쿼리하지 말라고도 알려줍니다.

자체 호스팅 러너 사용자는 두 가지 특정 수정을 받습니다: --use-anthropic-git-proxy 세션이 이전 세션에 의해 클론에 남겨진 .claude/settings.local.json을 더 이상 커밋하지 않으며, 체크아웃 훅 중 세션을 보관하거나 재대기열에 넣어도 더 이상 훅 프로세스가 실행 중으로 남아 러너의 슬롯을 차지하지 않습니다.