Claude Code 2.1.311·2.1.312: VS Code 코드 블록 색상 표시·OIDC 사용자 식별·컴팩션 개선

Claude Code가 10월 26일과 27일 이틀 연속으로 v2.1.311, v2.1.312를 내놨다. 앞선 2.1.310이 Monitor 도구의 플랫폼 확장에 초점을 맞췄다면, 이번 두 버전은 개발 환경 사용성과 기업 인증 설정에 집중한다.

v2.1.311: VS Code 코드 블록에 구문 색상 추가

코딩하면서 Claude의 답변에 있는 코드를 눈으로 따라가다 보면 늘 조금 불편했다. Claude가 출력하는 코드 블록이 일반 텍스트처럼 단색으로 표시됐기 때문이다. v2.1.311부터는 VS Code 확장 안에서 Claude의 응답 코드 블록이 구문 색상(syntax coloring)으로 표시된다. 라이트, 다크, 하이 콘트라스트 다크 테마를 모두 지원한다.

에디터 창에서 내가 작성 중인 코드와 Claude가 제안하는 코드가 같은 색상 체계로 보인다는 건, 비유하자면 외국어 번역본과 원문이 같은 폰트로 나란히 놓이는 것처럼 비교 독해가 한결 편해지는 효과다.

같은 버전에서 자체 호스팅(self-hosted) 러너 제어 기능도 추가됐다. 내부 인프라에서 Claude Code를 운용하는 팀은 이제 러너 설정을 더 세밀하게 관리할 수 있다.

v2.1.312: OIDC 사용자 식별 클레임 선택

기업 환경에서 Claude Apps 게이트웨이를 운영할 때, 사용자를 어떤 값으로 식별할지가 중요하다. 기존에는 id_token의 sub 클레임만 사용할 수 있었는데, Microsoft Entra ID를 쓰는 조직은 oid 클레임을 선호하는 경우가 많다. sub 값은 테넌트마다 달라질 수 있기 때문이다.

v2.1.312는 oidc.user_id_claim 설정을 추가해서, 관리자가 sub 대신 oid나 다른 클레임을 선택할 수 있게 했다. Entra ID 기반 SSO를 구성한 조직에서는 ID 관리 일관성이 크게 높아지는 변경점이다.

컴팩션 버그 수정: "200K 초과 시 세션 종료" 문제 해결

v2.1.312에서 또 하나 눈에 띄는 수정이 있다. 표준 컨텍스트 세션에서 요청이 200K 토큰을 초과하면 "Usage credits required for 1M context" 라는 오류와 함께 세션이 멈추는 문제가 있었다. 이제 Claude Code는 오류를 내는 대신 대화를 자동으로 컴팩션(compaction)한 뒤 작업을 계속 이어간다.

긴 코드 파일을 다루거나 여러 파일을 열어 놓고 작업할 때 예기치 않게 끊기던 경험이 사라진다.

v2.1.311에서도 컴팩션 관련 개선이 있었다. 모델 응답에 요약(summary)이 없을 경우, 컴팩션 전에 요약을 한 번 더 요청하도록 바뀌었다. 덕분에 대화 맥락이 덜 잘리게 됐다.

CLAUDE.md 덮어쓰기 버그 수정

v2.1.312는 대용량 CLAUDE.md 파일 문제도 잡았다. 이전에는 Claude가 CLAUDE.md의 앞부분만 읽은 상태에서 파일 전체를 덮어쓰는 버그가 있었다. 이제는 파일을 충분히 읽은 후에야 수정을 진행한다. 팀 규칙이나 프로젝트 설정이 담긴 대형 CLAUDE.md를 운영하는 팀에게 안도감을 주는 수정이다.

훅 동시 실행 상한 설정

같은 버전에서 세션당 동시에 실행되는 프롬프트·에이전트 훅이 최대 24개로 제한된다. 서브에이전트 포함이다. 복잡한 파이프라인에서 훅이 무한정 쌓이는 문제를 방지하는 안전망이다.

정리

Claude Code가 매주 꾸준히 업데이트되는 속도를 보면, 지금 이 도구를 주력으로 쓰고 있는 개발자라면 업데이트 노트를 습관적으로 확인하는 편이 낫다. 사소해 보이는 수정 하나가 하루 작업 흐름을 실질적으로 바꾸기도 한다.

Sources:

• Release v2.1.311 · anthropics/claude-code · GitHub
• Claude Code 2.1.312 — OIDC claim choice for the apps gateway
• Claude Code Changelog (October 2026)
• Claude Code Updates & Release Notes