claudekit / updates / claude-code-2-1-312
[ PATCH · ]

Claude Code 2.1.312

Claude apps gateway에 `oidc.user_id_claim`이 추가되고, Bedrock, Vertex, Foundry, Mantle에서 Claude Code가 알아보지 못하는 모델 이름에는 짧은 시스템 프롬프트를 쓰도록 바뀌었습니다. 하위 폴더의 큰 CLAUDE.md를 앞부분만 보고 덮어쓰던 문제, VS Code 확장에서 로그인한 뒤 관리 설정을 가져오지 못하던 문제 등 20건이 넘는 버그가 수정됐습니다.

공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.312가 2026년 10월 27일 출시됐습니다. Bedrock, Vertex, Foundry, Mantle에서 사용자 지정 배포 이름을 쓰는 경우의 시스템 프롬프트, 모델 자동 전환 동작이 바뀌었고, 훅 동시 실행 수에 상한이 생겼습니다. 수정은 큰 파일 덮어쓰기, 세션 재개, effort 표시, 에이전트 보기, 클라우드 세션과 Claude Tag에 걸쳐 20건이 넘습니다.

새 기능

  • Claude apps gateway의 oidc.user_id_claim

    Claude apps gateway는 사용자를 id_token의 sub 클레임(로그인 토큰에 담긴 사용자 식별 값)으로만 구분했습니다. 이제 oidc.user_id_claim으로 다른 클레임을 지정할 수 있어, 예를 들어 Microsoft Entra ID의 oid로 사용자를 식별할 수 있습니다.

  • 대기 중인 메시지를 클릭해 바로 보내기

    전체 화면 모드에서 대기열에 들어간 메시지 아래의 “to send now” 안내를 클릭하면, 해당 단축키를 누른 것처럼 메시지가 바로 전송됩니다.

  • [Cloud sessions] 루틴 모델 선택에 effort 수준 추가

    클라우드에서 실행되는 루틴을 만들거나 편집할 때 모델 선택 창에서 effort 수준도 정할 수 있습니다.

  • [Cloud sessions] 설정 스크립트용 Bash 편집기

    클라우드 환경 설정의 설정 스크립트 입력란이 구문 색상, 줄 번호, Copy 버튼을 갖춘 Bash 편집기로 바뀌었습니다.

주요 개선

  • 인식하지 못하는 모델 이름에는 짧은 시스템 프롬프트 사용

    Bedrock, Vertex, Foundry, Mantle에서는 사용자 지정 배포 이름이나 inference profile ARN처럼 Claude Code가 알아보지 못하는 모델 이름을 쓰는 경우가 많습니다. 이제 이런 이름에는, 실제로 Sonnet이나 Haiku를 가리키더라도 짧은 시스템 프롬프트를 씁니다. 전체 프롬프트를 유지하려면 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0을 설정합니다.

  • 모델 자동 전환이 인식하지 못하는 모델 이름까지 적용

    메시지가 거부 대상으로 표시(flagged)된 뒤 다른 모델로 자동 전환하는 동작이 이제 사용자 지정 배포 이름처럼 Claude Code가 알아보지 못하는 모델 이름에도 적용됩니다. 끄려면 CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1을 설정합니다.

  • 훅 동시 실행 수 상한

    이제 prompt 훅과 agent 훅은 서브에이전트를 포함해 세션당 한 번에 최대 24개까지 실행되고, 이벤트의 시간 제한을 넘겨 기다리는 훅은 여기에 더해 최대 12개까지 허용됩니다. 1초 미만으로 지정한 timeout은 1초로 계산합니다.

  • 서브에이전트 autoCompactWindow가 실제로 적용

    서브에이전트의 autoCompactWindow는 CLAUDE_CODE_AUTO_COMPACT_WINDOW로 정한 자동 압축 기준보다 낮게 설정해도 효과가 없었습니다. 이제 그 기준을 낮추는 데 쓰입니다. 기준을 높이지는 않습니다.

  • 작업 중 바꾼 effort 표시

    작업 도중 effort를 바꾸면 언제 적용되는지 알기 어려웠습니다. 이제 프롬프트의 effort 표시가 다음 메시지까지 기다릴 수 있다고 알려 주고, 해당하지 않게 되면 안내가 사라집니다.

  • 클라우드 세션의 WebFetch 오류 안내

    클라우드 세션에서 호스트 이름을 찾지 못하면 이제 허용된 네트워크 도메인 밖일 수 있다고 설명합니다. 그래서 Claude가 어떤 호스트를 허용해야 하는지 알려 줍니다.

  • 사용 한도 메시지의 “5-hour limit” 표기

    사용 한도 메시지가 5시간 단위 한도를 “session limit”으로 부르던 것을 이제 “5-hour limit”으로 부릅니다.

  • CLI에서 시작한 클라우드 세션의 이름

    CLI에서 시작한 클라우드 세션은 이제 세션 이름과 브랜치 이름을 서버에서 받아 옵니다.

  • OpenTelemetry 변경

    공식 Anthropic 마켓플레이스 플러그인이 선언한 고정 URL 원격 MCP 서버는 mcp_server.name에 custom 대신 실제 이름이 기록됩니다. claude_code.safety_event 이벤트는 더 이상 전송되지 않습니다.

  • [VS Code] 사용 한도 초기화 시각 표시

    사용 한도가 초기화되는 시점을 시계 시각(“Resets at 3:10 PM”)으로 보여 주고, “5-hour limit”이라는 표현을 씁니다.

  • [Cloud sessions] 저장소 추가 단계 표시

    Claude가 클라우드 세션에 저장소를 추가하는 단계를 열면 원본 JSON이 그대로 보였습니다. 이제 결과를 짧은 표로 보여 줍니다.

  • [Claude Tag] Slack 재시도 안내

    Slack의 재시도 안내가 일반적인 API 오류 문구로만 나왔습니다. 이제 사용 중인 모델 이름이나 속도 제한에 걸렸다는 사실을 알려 줍니다.

주요 버그 수정

파일과 도구

  • 하위 폴더의 아주 큰 CLAUDE.md, 규칙 파일, @로 포함한 파일을 Claude가 앞부분만 보고 덮어쓰던 문제 수정. 이제 Write 도구가 전체를 읽거나 제자리에서 편집하라고 Claude에게 요청합니다.
  • Bash로 git 저장소 안쪽 폴더에 cd한 뒤 폴더별 스킬과 paths: 스킬을 찾지 못하던 문제 수정.
  • 오래된 세션 파일 정리가 동시에 실행되면 Read 도구가 PDF 페이지에서 “pdftoppm failed: Could not write image”로 가끔 실패하던 문제 수정.

설정과 명령 로딩

  • VS Code 확장에서 로그인한 뒤 세션이 끝날 때까지 관리 설정(managed settings)과 조직 정책을 가져오지 않던 문제 수정.
  • 이름이 잘못된 명령 하나 때문에 모든 명령이 로드되지 않아 claude -p가 아무것도 출력하지 않을 수 있던 문제 수정.

세션 재개와 상태 표시

  • 터미널에서 세션을 재개한 뒤의 첫 응답이 다음 재개 때 빠져 있을 수 있던 드문 문제 수정.
  • 마지막 메시지가 문장 중간에 사용자 확인이 필요한 항목을 언급하기만 해도 세션이 사용자를 기다리는 상태로 표시되던 문제 수정.

effort와 모델 표시

  • 작업 중 새로 고른 effort 수준이 모델에 적용되기 전부터 스피너, OpenTelemetry effort 값, 대화 기록에 표시되던 문제 수정. 이제 실제로 적용 중인 수준을 보여 줍니다.
  • /model, /effort의 캐시 경고가 다시 읽기는 다음 메시지 때 일어난다고 안내하던 문제 수정. Claude가 작업 중일 때 바꾸면 더 일찍 일어날 수 있습니다.

입력과 에이전트 보기

  • 종료 직전에 Ctrl+C로 지운 입력이 다음 실행 때 에이전트 보기에 되살아나던 문제 수정.
  • 빈 ! 입력에서 Ctrl+D로 종료하면 에이전트 보기가 셸 모드로 다시 열리던 문제 수정.
  • vim 모드에서 남은 줄 수보다 큰 횟수의 gj, gk와 함께 쓴 d, c, y가 텍스트를 지우거나 복사하던 문제 수정. 이제 Vim처럼 커서만 이동합니다.
  • /verify가 /help와 / 명령 메뉴에 짧은 설명 대신 Claude용 긴 설명을 보여 주던 문제 수정.

VS Code 확장

  • 시작할 때 조직 설정을 불러오지 못하거나 거부되면 세션이 종료 코드만 남기고 끝나던 문제 수정. 이제 탭에 이유를 보여 주고 Retry 또는 Sign in again을 제안합니다.

Cloud sessions와 Remote Control

  • 클라우드 세션에서 전송에 실패한 메시지를 그대로 다시 보내면 가끔 두 번 실행되던 문제 수정.
  • 클라우드 환경 생성 실패 오류가 열린 대화 상자 밖의 알림으로만 표시되던 문제 수정. 이제 대화 상자 안에 나옵니다.
  • Routines 페이지의 루틴 메뉴에서 Edit을 누르면 편집 대화 상자 없이 루틴 페이지로만 이동하던 문제 수정.
  • 보관을 해제한 Remote Control 세션이 컴퓨터가 다시 연결될 때까지 작업 중으로 표시되던 문제 수정. 이제 유휴 상태로 표시됩니다.

Claude Tag

  • 오래된 비공개 Slack 채널이 공개로 바뀌며 새 ID를 받으면 채널의 켜기/끄기 스위치와 에이전트 설정이 워크스페이스 기본값으로 돌아가던 문제 수정.
  • 환경의 네트워크 접근이 None인 채널에서 Slack의 Claude가 답하지 않던 문제 수정.
  • 같은 채널의 다른 스레드에 답하는 중일 때 Slack의 Claude가 파일을 엉뚱한 스레드에 올리던 문제 수정.

Code Review

  • GitHub가 push 이벤트를 늦게 전달하면 Code Review가 오래된 커밋을 리뷰하거나 아예 리뷰하지 않던 문제 수정. 이제 풀 리퀘스트의 현재 커밋을 리뷰합니다.

알아두면 좋은 점

  • Bedrock, Vertex, Foundry, Mantle에서 사용자 지정 배포 이름이나 inference profile ARN을 쓴다면 이제 짧은 시스템 프롬프트가 적용됩니다. 기존처럼 전체 프롬프트를 쓰려면 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0을 설정하세요.
  • 같은 환경에서 거부 후 모델 자동 전환을 원하지 않는다면 CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1로 끌 수 있습니다.
  • 훅을 많이 쓴다면 prompt 훅과 agent 훅이 세션당 동시에 최대 24개까지 실행되고, 1초 미만 timeout은 1초로 계산된다는 점을 참고하세요.
  • OpenTelemetry로 claude_code.safety_event를 수집하고 있었다면 이 이벤트는 더 이상 전송되지 않습니다. mcp_server.name으로 집계한다면 공식 마켓플레이스 플러그인의 원격 MCP 서버가 custom 대신 실제 이름으로 기록됩니다.