Claude Code v2.1.310: 모니터 도구 및 게이트웨이 수정

Claude Code v2.1.310이 출시되었습니다. 핵심은 새로운 Monitor 도구입니다. 이제 Bedrock, Vertex, Foundry에서 작동하며, 플러그인 모니터와 텔레메트리 또는 비필수 트래픽이 비활성화된 경우에도 사용할 수 있습니다. 이러한 환경에서는 긴 포그라운드 대기가 차단됩니다.

게이트웨이 및 서버 호환성 수정

effort-2025-11-24 베타 값이나 대화 중 시스템 메시지를 거부하는 게이트웨이 또는 호환 서버 뒤에서 실패했던 요청이 이제 해당 값 없이 재시도되어 바로 실패하지 않습니다.
비대화형 세션에서 MCP 도구 호출이 시간 초과되고 서버의 elicitation이 응답되지 않은 경우, 오류 메시지가 Claude에게 응답이 없었으며 호출을 반복하지 말라고 알려줍니다.

정리, 압축 및 권한 수정

cleanupPeriodDays가 매우 큰 값으로 설정된 경우 백그라운드 정리가 붙여넣은 이미지와 같은 최근 파일을 더 이상 삭제하지 않습니다.
"Prompt is too long" 오류 후 압축이 다음 요청을 다시 실패하게 만들 수 있는 밀집 텍스트(base64, SVG)를 더 이상 유지하지 않습니다.
파일 읽기 권한 프롬프트에 이제 심볼릭 링크가 가리키는 위치가 표시됩니다.
질문에 대한 자동 계속 시간 초과가 긴 편집 후 외부 편집기가 닫히는 순간 더 이상 발생하지 않습니다.
Windows: Git Bash가 없고 훅 명령이 인용된 경로와 같은 인용 문자열만 있는 경우 PreToolUse 및 PermissionRequest 훅이 더 이상 도구 호출을 허용하지 않습니다.

개선된 동작

자동 모드에서 작업 디렉터리 외부 첫 읽기 전 프롬프트에 해당 읽기를 차단하면 셸 명령이 권한을 요청하게 된다는 점이 이제 표시됩니다.
비대화형 세션(-p, Agent SDK)은 트랜스크립트 파일이 매우 클 때 압축 중 메모리를 덜 사용합니다.
tmux의 이미지 렌더링이 이제 allow-passthrough 및 focus-events가 켜진 상태에서 작동하며, kitty, Ghostty, iTerm2 3.5+ 전체 화면 렌더링(이전에는 대체 텍스트만 표시됨)에서도 작동합니다.
Linux /sandbox 및 시작 경고가 이제 bubblewrap이 시작될 수 없을 때 Ubuntu의 사용자 네임스페이스에 대한 AppArmor 제한과 이를 해제하는 방법을 명시합니다.

VSCode, Cloud 세션, Claude Tag, 코드 리뷰

VSCode: "Send feedback and keep planning"에서 Enter를 누르면 이제 계획을 승인하는 대신 의견을 보냅니다. Session history의 Web 탭에서 클라우드 세션에 "Switch branch & continue" 후 패널에 더 이상 "Something went wrong"이 표시되지 않습니다.
Cloud 세션: 엔터프라이즈 사용자 지정 역할이 이제 Claude Code 클라우드 세션 및 원격 제어 권한을 부여할 수 있습니다. 관리자는 해당 권한이 있는 역할 목록을 보여주는 확인 프롬프트를 받습니다. 환경 대화상자에는 설정 스크립트용 파일 선택 버튼이 있고, 행에서 네트워크 액세스/설정 스크립트/환경 변수를 열며, 설정 스크립트 출력을 스크롤 상자에 표시하고, 저장/보관 및 루틴 API 토큰 오류를 대화상자 내에 표시합니다.
Claude Tag: 굵게, 기울임꼴 또는 취소선으로 보낸 경우 !restart 및 !help가 더 이상 일반 메시지로 처리되지 않습니다. 관리자 페이지는 번들 목록 새로 고침 실패 후에도 유지되며, 지출 한도는 이름 로드 중에 더 이상 채널 없음을 보고하지 않습니다.
코드 리뷰: 관리자 섹션이 첫 로드 시 재시도하고, 새로 고침 실패 후 저장소와 스위치를 숨기는 대신 단일 "다시 시도" 배너를 표시합니다.

호환되지 않는 게이트웨이 뒤에서 Claude Code를 실행하거나, 비대화형 Agent SDK 파이프라인에서, 또는 Linux 샌드박스에서 실행하는 경우 이 릴리스를 적용할 가치가 있습니다. 재시도 수정만으로도 한 부류의 심각한 실패가 제거됩니다.

📖 전체 소스 읽기: GitHub Claude-Code