Claude Code 2.1.310

무엇이 바뀌었나?

Claude Code 2.1.310이 2026년 10월 23일 출시됐습니다. Monitor 도구와 플러그인 모니터가 Bedrock, Vertex, Foundry와 텔레메트리를 끈 환경으로 넓어졌고, Enterprise 관리자는 Cloud sessions와 Remote Control 접근을 역할별로 나눠 줄 수 있게 됐습니다. 함께 게이트웨이 호환성, 파일 정리, 대화 압축, 권한 확인 창, Windows 훅 처리와 VS Code 확장, Cloud sessions, Claude Tag, Code Review 관리 화면에 걸친 수정이 들어갔습니다.

새 기능

• Bedrock, Vertex, Foundry에서 Monitor 도구와 플러그인 모니터

  Monitor 도구와 플러그인 모니터는 Bedrock, Vertex, Foundry를 쓰거나 텔레메트리, 필수가 아닌 트래픽을 끈 환경에서는 쓸 수 없었습니다. 이제 이런 환경에서도 사용할 수 있습니다. 함께 이 환경에서도 포그라운드에서 오래 sleep하며 기다리는 명령이 차단됩니다.

• [Cloud sessions] Enterprise 사용자 지정 역할에 Cloud sessions, Remote Control 권한 추가

  이제 Enterprise의 사용자 지정 역할(custom role)에 두 권한이 추가되어, Owner가 역할마다 각 기능의 접근을 따로 정할 수 있습니다.

• [Cloud sessions] 설정 스크립트를 파일에서 불러오는 Choose file 버튼

  이제 Choose file 버튼으로 클라우드 환경의 설정 스크립트를 파일에서 불러올 수 있습니다.

주요 개선

• 작업 디렉터리 밖 첫 읽기에 대한 auto mode 안내

  auto mode에서 작업 디렉터리 밖 파일을 처음 읽기 전에 확인 창이 뜨지만, 이 읽기를 막으면 어떤 영향이 있는지는 알려 주지 않았습니다. 이제 이런 읽기를 막으면 셸 명령도 권한을 묻게 된다는 점을 함께 알려 줍니다.

• 비대화형 세션의 압축 중 메모리 사용

  -p나 Agent SDK로 실행한 비대화형 세션에서 대화 기록 파일이 아주 크면, 압축(compaction) 중 메모리를 많이 썼습니다. 이제 메모리 사용이 줄었습니다.

• tmux와 일부 터미널에서 mod의 Image 표시

  tmux에서 allow-passthrough, focus-events를 켜고 kitty, Ghostty, iTerm2 3.5 이상에서 전체 화면 렌더링을 쓰면 mod의 Image가 그림 대신 alt 텍스트만 보여 줬습니다. 이제 이 환경에서도 이미지가 그려집니다.

• Linux 샌드박스와 Ubuntu AppArmor 안내

  Ubuntu의 AppArmor가 user namespace를 제한하면 bubblewrap이 샌드박스를 시작하지 못합니다. 이제 /sandbox와 샌드박스 시작 경고가 이 AppArmor 제한을 원인으로 짚고 푸는 방법을 알려 줍니다.

• 응답 없는 elicitation 중 MCP 도구 호출 시간 초과 오류

  비대화형 세션에서는 MCP 서버의 elicitation(서버가 사용자에게 입력을 요청하는 것)에 답할 사람이 없어 도구 호출이 시간 초과됩니다. 이제 오류가 답이 오지 않았으니 같은 호출을 반복하지 말라고 Claude에게 알려 줍니다.

• [Cloud sessions] 세션 시작 체크리스트의 설정 스크립트 출력

  세션 시작 체크리스트가 이제 클라우드 환경 설정 스크립트의 출력을 스크롤 상자 안에 보여 줍니다.

• [Cloud sessions] 관리자 설정의 활성화 확인

  관리자 설정에서 Cloud sessions나 Remote Control을 켤 때 이제 확인을 묻고, 해당 권한을 가진 사용자 지정 역할 목록을 함께 보여 줍니다.

• [Cloud sessions] 클라우드 환경 대화 상자 구성

  클라우드 환경 대화 상자가 모든 편집기를 한꺼번에 나열했습니다. 이제 네트워크 접근, 설정 스크립트, 환경 변수를 각 행에서 열어 편집합니다.

• [Code Review] 관리자 화면 첫 로딩

  Code Review 관리자 섹션이 이제 첫 로딩을 다시 시도하고, 그래도 실패하면 Try again 배너 하나만 보여 줍니다.

주요 버그 수정

게이트웨이와 대화 압축

• 일부 게이트웨이와 호환 서버가 effort-2025-11-24 beta 값이나 대화 도중의 system 메시지를 거부해 요청이 실패하던 문제 수정. 이제 이 값들을 빼고 다시 시도합니다.
• “Prompt is too long” 오류 뒤 압축이 base64나 SVG처럼 밀도 높은 텍스트가 든 대화를 너무 많이 남겨, 다음 요청이 다시 실패할 수 있던 문제 수정.

파일과 권한

• cleanupPeriodDays를 아주 큰 값으로 설정하면 백그라운드 정리가 붙여 넣은 이미지 같은 최근 파일을 지우던 문제 수정.
• 파일 읽기 권한 확인 창에 심볼릭 링크가 실제로 가리키는 위치가 표시되지 않던 문제 수정.
• Windows에서 Git Bash가 없고 훅 명령이 따옴표로 감싼 문자열(예: 따옴표로 감싼 경로)로만 되어 있으면 PreToolUse, PermissionRequest 훅이 도구 호출을 그대로 통과시키던 문제 수정.

입력

• 외부 편집기에서 오래 편집한 뒤 닫는 순간, 질문의 자동 진행 시간 제한이 바로 발동하던 문제 수정.

VS Code 확장

• 계획 검토 카드의 “Send feedback and keep planning” 버튼에서 Enter를 누르면 의견을 돌려보내는 대신 계획을 승인하던 문제 수정.
• Session history의 Web 탭에서 연 클라우드 세션에서 “Switch branch & continue”를 누르면 패널에 “Something went wrong”이 뜨던 문제 수정.

Cloud sessions

• 클라우드 환경 편집 대화 상자에서 저장이나 보관이 실패해도 대화 상자 안에 오류가 보이지 않던 문제 수정.
• 루틴 API 토큰 작업이 실패하면 잠깐 뜨는 알림(toast)으로만 알려 주던 문제 수정. 이제 루틴 편집 대화 상자에 오류가 표시됩니다.

Claude Tag (Slack)

• !restart, !help 같은 ! 명령을 굵게, 기울임, 취소선 서식으로 보내면 일반 메시지로 처리하던 문제 수정.
• 번들 목록의 백그라운드 새로 고침이 실패하면 관리자 채널, 워크스페이스 페이지가 로딩 오류 화면으로 바뀌던 문제 수정.
• 관리자 설정의 지출 한도(spend limits) 페이지가 채널 이름을 불러오는 중인데도 필터에 맞는 채널이 없다고 표시하던 문제 수정.

Code Review

• 저장소 목록 새로 고침이 실패하면 Code Review 관리자 섹션의 저장소와 스위치가 사라지던 문제 수정.

알아두면 좋은 점

• Bedrock, Vertex, Foundry를 쓰거나 텔레메트리를 껐다면 이제 Monitor 도구와 플러그인 모니터를 쓸 수 있습니다. 함께 포그라운드에서 오래 sleep하는 명령은 차단됩니다.
• Enterprise 조직의 Owner라면 사용자 지정 역할에서 Cloud sessions와 Remote Control 권한을 역할별로 줄 수 있습니다. 관리자 설정에서 두 기능을 켤 때 해당 권한을 가진 역할 목록이 표시되니 함께 확인하세요.
• cleanupPeriodDays를 아주 크게 설정해 두었다면 이번 버전으로 업데이트하면 붙여 넣은 이미지 같은 최근 파일이 정리 과정에서 지워지지 않습니다.
• 사내 게이트웨이나 호환 서버를 거쳐 Claude Code를 쓴다면 effort-2025-11-24 beta 값이나 대화 도중 system 메시지를 거부하는 서버에서도 Claude Code가 이를 빼고 다시 시도합니다.
• Ubuntu에서 샌드박스가 시작되지 않는다면 /sandbox를 실행해 AppArmor 제한 여부와 푸는 방법을 확인하세요.