Claude Code 2.1.312, 동시 실행 훅 제한·자동 모델 전환 범위 확대·OIDC 클레임 설정 추가

Claude Code v2.1.312가 릴리스 노트에 따르면 2026년 10월 27일 출시됐습니다.

• 훅: 프롬프트 훅과 에이전트 훅은 이제 세션당 최대 24개까지 동시에 실행됩니다(하위 에이전트 포함). 여기에 이벤트 제한 시간을 넘겨 대기한 훅도 최대 12개까지 실행됩니다. 1초 미만의 제한 시간은 이제 1초로 간주됩니다.
• 클라우드 제공업체: Bedrock, Vertex, Foundry, Mantle에서 Claude Code가 인식하지 못하는 모델 이름(사용자 지정 배포 이름, 추론 프로필 ARN)은 이제 Sonnet이나 Haiku를 기반으로 하더라도 더 짧은 시스템 프롬프트를 사용합니다. 전체 프롬프트를 유지하려면 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0으로 설정하세요.
• 모델 전환: 플래그가 지정된 메시지 이후 자동 모델 전환이 이제 인식되지 않는 모델 이름에도 적용됩니다. 이를 끄려면 CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1로 설정하세요.
• Claude apps 게이트웨이: 새 설정 oidc.user_id_claim을 사용하면 Microsoft Entra ID의 oid처럼 sub 이외의 id_token 클레임으로 사용자를 식별할 수 있습니다.
• 하위 에이전트: 하위 에이전트의 autoCompactWindow는 이제 CLAUDE_CODE_AUTO_COMPACT_WINDOW로 설정한 윈도 크기를 낮출 수 있지만, 높일 수는 없습니다.
• 텔레메트리: Claude Code는 이제 claude_code.safety_event OpenTelemetry 이벤트를 전송하지 않습니다. 또한 mcp_server.name은 공식 Anthropic 마켓플레이스의 플러그인에 선언된 고정 URL 원격 MCP 서버에 대해 이제 custom 대신 실제 이름을 보고합니다.
• 인터페이스: 전체 화면에서 대기 중인 메시지 아래의 "지금 보내기" 안내를 클릭하면 메시지가 즉시 전송됩니다. 사용량 제한 메시지에서는 5시간 구간을 "세션 제한" 대신 "5시간 제한"이라고 부릅니다. 작업 중간에 적용된 추론 강도 변경은 다음 메시지까지 기다릴 수 있다는 안내가 표시됩니다.
• 쓰기 및 스킬: 매우 큰 CLAUDE.md 파일, 규칙 파일 또는 @로 포함된 파일은 시작 부분만 확인한 뒤 덮어쓰는 대신, Write가 Claude에게 전체 내용을 읽거나 파일을 직접 수정하도록 요청합니다. Bash에서 저장소 내 더 깊은 디렉터리로 cd한 뒤에도 디렉터리별 스킬과 paths: 스킬을 다시 찾습니다.
• 클라우드 세션 및 Claude Tag: 클라우드 루틴의 모델 선택기에 추론 강도 옵션이 추가되고, 설정 스크립트 상자에 Bash 편집기가 추가됩니다. Claude Tag의 Slack 재시도 알림에는 사용 중인 모델이 표시되거나 속도 제한에 걸렸다는 내용이 표시됩니다. 네트워크 액세스가 None으로 설정된 채널의 답글과 잘못된 스레드에 게시된 파일 관련 문제도 수정됐습니다.
• Code Review: GitHub에서 푸시 이벤트가 늦게 전달되는 경우, 이제 풀 리퀘스트의 최신 커밋을 검토합니다.

이번 릴리스에서는 VS Code 확장 프로그램에서 로그인한 뒤 관리 설정을 가져오지 못하는 문제, 이름이 잘못된 명령 하나 때문에 모든 명령을 불러오지 못하는 문제, 세션 정리 중 PDF를 읽지 못하는 문제와 에이전트 보기 및 vim 모드 관련 여러 문제도 수정됐습니다.