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을 더 이상 커밋하지 않으며, 체크아웃 훅 중 세션을 보관하거나 재대기열에 넣어도 더 이상 훅 프로세스가 실행 중으로 남아 러너의 슬롯을 차지하지 않습니다.
📖 전체 소스 읽기: GitHub Claude-Code
👀 See Also

AI 탄수화물 계산 재현성 실패: 1장 사진에 27K 쿼리에서 429g 편차 발생
26,904개의 AI 쿼리를 4개 모델에 걸쳐 분석한 연구에서, Gemini 2.5 Pro가 단일 빠에야 사진에 대한 탄수화물 추정치를 55g에서 484g까지 다양하게 제시한 것으로 나타났다. 이는 잠재적으로 42.9U의 인슐린 변동을 의미한다. Claude는 중간 변동 계수가 2.4%에 불과했다.

아남 카라-3: 인터랙티브 AI 아바타의 발전
아남 카라-3은 오디오-비디오 변환을 위한 2단계 파이프라인을 통해 고급 인터랙티브 아바타를 도입하며, 인상적인 속도와 반응성을 달성했습니다.

Claude Code v2.1.218 /code-review 수정, MCP 인증, Windows 경로 손상 문제 해결
Claude Code v2.1.218은 /code-review를 백그라운드 하위 에이전트로 실행하고, Windows에서 \u로 시작하는 경로의 손상 문제를 수정하며, 스크린 리더 지원을 개선하고, MCP 인증 과잉 계산 문제를 패치합니다.

클로드 온보딩 경험에서 확인된 네 가지 UX/제품 격차
사용자가 데스크톱, Cowork, Dispatch 및 iPhone 앱에서 Claude를 설정하는 동안 실제 사용 중에 네 가지 특정 UX/제품 격차를 확인했습니다. 문제에는 데스크톱이 오프라인 상태일 때 Dispatch 작업이 무한 루프에 빠지는 것, Dispatch의 단일 지속적 스레드, Chrome의 탭 고정 채팅 패널, 모바일 앱 지식 베이스 UI에서 Google Drive 파일이 누락되는 것이 포함됩니다.