Claude Code v2.1.312 — 큰 파일 덮어쓰기 방지, Entra ID 지원, 관측 정직성
AI

Claude Code v2.1.312 — 큰 파일 덮어쓰기 방지, Entra ID 지원, 관측 정직성

zaq · · 3 min read

v2.1.312의 가장 중요한 수정은 조용합니다. 아주 큰 CLAUDE.md·규칙 파일·@-포함 파일을 "처음 부분만 보고 통째로 덮어쓰던" 사고 경로를 막았습니다. 이제 Write는 큰 파일 앞에서 전체를 읽거나 제자리 편집 중 하나를 요구합니다.

한마디로 말하면, AI의 파일 쓰기에 "다 읽고 써라" 원칙을 강제한 데이터 보호 릴리스인데, 여기에 기업 게이트웨이의 ID 연동 개선이 붙은 구성입니다.

큰 파일 덮어쓰기 방지 — 왜 중요한가

하위 디렉터리의 대형 설정 파일은 길이 제한 때문에 에이전트가 앞부분만 읽게 되는데, 그 상태로 Write를 실행하면 읽지 않은 나머지 전체가 사라졌습니다. CLAUDE.md처럼 프로젝트의 두뇌 역할을 하는 파일이라면 치명적이죠. 수정 후에는 Claude가 파일을 통째로 읽은 뒤 쓰거나, Edit로 제자리 고치도록 유도됩니다. 309의 샌드박스 우회 차단에 이어 "에이전트가 스스로 데이터를 깨지 않게 하는" 안전망이 한 겹 더 쳐진 셈입니다.

엔터프라이즈 — Entra ID와 정책 로딩

Claude apps 게이트웨이에 oidc.user_id_claim이 추가됐습니다. 기본 식별 클레임인 sub 대신 다른 id_token 클레임으로 사용자를 식별할 수 있는데, 대표 사례가 **Microsoft Entra ID의 oid**입니다 — Entra를 쓰는 기업 SSO 구성에서의 정합성 문제를 풀어준 것입니다. 함께 중요한 보안 수정도 들어갔습니다. VS Code 확장에서 로그인하면 그 세션이 끝날 때까지 managed settings와 조직 정책을 다시 가져오지 않던 문제가 잡혔습니다. 정책이 화면에는 있고 실제로는 안 오는 상태 — 거버넌스 관점에서 이번 릴리스에서 가장 조용하지만 무거운 수정입니다.

관측 정직성과 잔손질

재미있는 철학이 보이는 수정은 effort 관련입니다. 작업 도중 effort 수준을 바꾸면 스피너·OpenTelemetry effort 값·트랜스크립트가 모델이 아직 적용하지 않은 새 수준을 미리 표시했는데, 이제 실제 적용 중인 수준을 보여줍니다. 원격측정이 사실과 다르면 대시보드 전체가 틀리니까요. 그 외에 잘못된 이름의 명령 하나가 전체 명령 로딩을 막아 claude -p가 출력 없이 끝나던 문제, PDF 읽기가 오래된 세션 파일 정리와 겹치면 "pdftoppm failed"로 실패하던 문제, vim 모드에서 gj/gk 카운트가 남은 줄보다 클 때 텍스트를 삭제·복사하던 문제 등이 잡혔습니다.

마무리로 — 311이 "세션이 끊기지 않게" 했다면 312는 "끊기지 않는 세션이 스스로 망가뜨리지도 않게" 한 단계입니다. 무인 에이전트 시대의 릴리스는 속도 경쟁이 아니라 사고 경로를 하나씩 막는 인내의 기록이 되어가고 있습니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.312

태그: AI Claude Claude Code 개발도구