Δdeltalog

Claude Code 2.1.312

2026-10-28 릴리스 · 변경 항목 39개

원문 릴리스 노트 보기 ↗

신기능 15수정 22기타 2

이 페이지는 Claude Code 2.1.312에서 바뀐 점을 유형별로 모은 것입니다.
  • breaking · 보안 변경은 없습니다.
  • 항목 아래 ▸ 원문을 누르면 영어 원문이 펼쳐집니다.
이 버전을 쓰고 있다면: 최신 버전까지 바뀐 점 한 번에 보기 →

+ 신기능 15개

  • Microsoft Entra ID의 `oid` 같은 `id_token` 클레임으로 사용자를 식별하도록 Claude apps gateway에 `oidc.user_id_claim`을 추가한다 # 보안·권한
    원문

    [What's changed] Added `oidc.user_id_claim` to the Claude apps gateway, to identify people by an id_token claim other than `sub`, such as Microsoft Entra ID's `oid`

  • 인식하지 못하는 모델 이름에 더 짧은 시스템 프롬프트를 사용하도록 Bedrock, Vertex, Foundry, Mantle을 변경한다 # 모델·요금
    원문

    [What's changed] Changed Bedrock, Vertex, Foundry and Mantle to use the shorter system prompt for model names Claude Code doesn't recognize, such as custom deployment names and inference profile ARNs, even when they front Sonnet or Haiku; set `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0` to keep the full prompt

  • 플래그가 지정된 메시지 후의 자동 모델 전환이 인식되지 않는 모델 이름도 포함하도록 변경한다 # 모델·요금
    원문

    [What's changed] Changed automatic model switches after a flagged message to also cover model names Claude Code doesn't recognize, such as custom deployment names; set `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1` to turn them off

  • 전체 화면에서 대기 중인 메시지 아래의 보내기 안내를 클릭하면 바로 메시지를 전송하는 기능을 추가한다 # UI
    원문

    [What's changed] Added click to send: in fullscreen, clicking the "to send now" hint under a queued message sends it right away, as its key does

  • 작업 중 변경된 프롬프트 노력 지표의 안내 문구를 개선하고 적용되지 않을 때 지워지도록 한다 # 모델·요금
    원문

    [What's changed] Improved the prompt's effort indicator: a change made mid-task now says it may wait for your next message, and the note clears when it no longer applies

  • 클라우드 세션에서 호스트를 찾지 못할 때 허용된 네트워크 도메인 외부에 있을 수 있음을 설명하도록 WebFetch 오류를 개선한다 # 원격·클라우드
    원문

    [What's changed] Improved WebFetch errors in cloud sessions: a host that does not resolve is now explained as possibly outside the allowed network domains, so Claude names the host to allow

  • 사용량 한도 메시지에서 5시간 창을 세션 한도 대신 5시간 한도로 부르도록 변경한다 # 모델·요금
    원문

    [What's changed] Changed usage limit messages to call the 5-hour window the "5-hour limit" instead of the "session limit"

  • CLI에서 시작된 클라우드 세션이 서버에서 이름과 브랜치 이름을 가져오도록 변경한다 # 원격·클라우드
    원문

    [What's changed] Changed cloud sessions started from the CLI to get their names and branch names from the server

  • 프롬프트 및 에이전트 훅이 세션당 최대 24개까지 실행되도록 제한을 변경한다 # 훅
    원문

    [What's changed] Changed prompt and agent hooks to run at most 24 at a time per session, sub-agents included, plus at most 12 that have waited longer than their event's timeout; a `timeout` under 1 second now counts as 1 second

  • 서브에이전트의 `autoCompactWindow`가 `CLAUDE_CODE_AUTO_COMPACT_WINDOW`로 설정된 창을 낮추도록 변경한다 # 에이전트
    원문

    [What's changed] Changed a subagent's `autoCompactWindow` to lower the window set by `CLAUDE_CODE_AUTO_COMPACT_WINDOW`, where it had no effect before; it still never raises that window

  • 사용량 한도 초기화 시간에 시각을 표시하고 5시간 한도임을 명시하도록 변경한다 # 모델·요금
    원문

    [What's changed] [VSCode] Changed usage limit resets to show a clock time ("Resets at 3:10 PM") and to say "5-hour limit"

  • 클라우드 루틴 생성 및 수정 시 모델 선택기에 노력 수준을 추가한다 # 원격·클라우드
    원문

    [What's changed] [Cloud sessions] Added an effort level to the model picker when you create or edit a routine that runs in the cloud

  • 클라우드 환경 설정의 설정 스크립트 상자에 색상, 줄 번호, 복사 버튼이 있는 Bash 편집기를 추가한다 # 원격·클라우드
    원문

    [What's changed] [Cloud sessions] Added a Bash editor with colors, line numbers and a Copy button to the setup script box in cloud environment settings

  • 클라우드 세션에 저장소를 추가할 때 원시 JSON 대신 요약 표를 표시하도록 개선한다 # 원격·클라우드
    원문

    [What's changed] [Cloud sessions] Improved the step shown when Claude adds a repository to a cloud session: opening it now shows a short table of what happened instead of raw JSON

  • Slack에서 재시도 안내 메시지가 일반 API 오류 대신 사용 중인 모델 이름이나 속도 제한 초과 여부를 표시하도록 개선한다 # Git·연동
    원문

    [What's changed] [Claude Tag] Improved Claude Tag's retry notice in Slack to name the model in use, or say rate limits were hit, instead of a generic API error

~ 수정 22개

  • 매우 큰 CLAUDE.md나 규칙 파일의 시작 부분만 보고 내용을 덮어쓰던 문제를 수정하고 전체를 읽거나 제자리에서 수정하도록 바꾼다 # 세션·컨텍스트
    원문

    [What's changed] Fixed Claude overwriting a very large CLAUDE.md, rules file or @-included file in a subdirectory after seeing only its start; Write now asks Claude to read it all or edit in place

  • VS Code 확장 프로그램에서 로그인한 후 세션 동안 관리 설정과 조직 정책을 가져오지 못하던 문제를 수정한다 # 보안·권한
    원문

    [What's changed] Fixed managed settings and organization policy not being fetched for the rest of the session after signing in from the VS Code extension

  • Bash `cd` 명령으로 깃 저장소 안으로 깊이 이동한 뒤 디렉터리별 및 `paths:` 스킬을 찾지 못하던 문제를 수정한다 # MCP·플러그인
    원문

    [What's changed] Fixed per-directory and `paths:` skills not being found after a Bash `cd` deeper into a git repository

  • 잘못된 이름의 명령 때문에 모든 명령이 로드되지 않아 `claude -p`가 출력을 내보내지 못하던 문제를 수정한다 # CLI·설정
    원문

    [What's changed] Fixed a command with an invalid name stopping all commands from loading, which could leave `claude -p` with no output

  • 조직 설정 로드 실패 시 VSCode 세션이 종료되던 문제를 수정하고 이유와 재시도 또는 로그인 옵션을 표시한다 # 에디터·언어
    원문

    [What's changed] [VSCode] Fixed sessions ending on a bare exit code when your organization's settings couldn't be loaded or were refused at startup; the tab now says why and offers Retry or Sign in again

  • 클라우드 세션에서 전송 실패 후 변경되지 않은 메시지를 다시 보낼 때 가끔 두 번 실행되던 문제를 수정한다 # 원격·클라우드
    원문

    [What's changed] [Cloud sessions] Fixed resending an unchanged message after a failed send in a cloud session sometimes running it twice

  • 비공개 Slack 채널이 공개로 전환될 때 채널 설정이 워크스페이스 기본값으로 돌아가던 문제를 수정한다 # Git·연동
    원문

    [What's changed] [Claude Tag] Fixed a Claude Tag channel's on/off switch and agent settings falling back to workspace defaults when an older private Slack channel goes public and gets a new ID

  • 네트워크 접근이 없는 환경의 Slack 채널에서 Claude가 응답하지 않던 문제를 수정한다 # Git·연동
    원문

    [What's changed] [Claude Tag] Fixed Claude in Slack not replying in channels whose environment has network access set to None

  • GitHub 푸시 이벤트가 늦게 전달될 때 코드 리뷰가 오래된 커밋을 검토하던 문제를 수정하여 최신 커밋을 검토하도록 한다 # Git·연동
    원문

    [What's changed] [Code Review] Fixed Code Review reviewing an outdated commit, or none at all, when GitHub delivered a push event late; it now reviews the pull request's current commit

  • 터미널에서 세션을 재개한 후 첫 번째 응답이 다음 세션 재개 시 누락될 수 있던 드문 문제를 수정한다 # 세션·컨텍스트
    원문

    [What's changed] Fixed a rare case where the first reply after resuming a session in the terminal could be missing the next time the session was resumed

  • 오래된 세션 파일 정리 작업이 동시에 실행될 때 PDF 페이지에서 Read 도구가 실패하던 문제를 수정한다 # 에디터·언어
    원문

    [What's changed] Fixed the Read tool sometimes failing on PDF pages with "pdftoppm failed: Could not write image" when the clean-up of old session files ran at the same time

  • 모델이 적용하기 전에 스피너와 OpenTelemetry `effort` 값이 새로 선택된 노력 수준을 표시하던 문제를 수정한다 # 모델·요금
    원문

    [What's changed] Fixed the spinner, OpenTelemetry `effort` values and transcripts naming a newly picked effort level during a task before the model applied it; they now show the level in force

  • Claude가 작업 중일 때 변경 사항이 더 빨리 적용될 수 있도록 `/model` 및 `/effort` 캐시 경고 문구를 수정한다 # 모델·요금
    원문

    [What's changed] Fixed the `/model` and `/effort` cache warning saying the re-read waits for your next message; a change made while Claude is working can trigger it sooner

  • 마지막 메시지 중간에 대기 중인 항목이 언급되었을 때 일부 세션이 사용자 대기 중으로 잘못 표시되던 문제를 수정한다 # UI
    원문

    [What's changed] Fixed some sessions showing as waiting on you when the last message only mentioned items waiting on you mid-sentence

  • 종료 직전 Ctrl+C로 지운 입력 텍스트가 다음 실행 시 에이전트 뷰에 복원되던 문제를 수정한다 # UI
    원문

    [What's changed] Fixed agent view restoring input text on the next launch after it was cleared with Ctrl+C just before exiting

  • 빈 `!` 입력에서 Ctrl+D로 종료한 후 에이전트 뷰가 셸 모드로 다시 열리던 문제를 수정한다 # UI
    원문

    [What's changed] Fixed agent view reopening in shell mode after exiting with Ctrl+D from an empty `!` input

  • vim 모드에서 `gj` 또는 `gk` 횟수가 남은 줄보다 클 때 텍스트를 삭제하거나 복사하는 대신 커서만 이동하도록 수정한다 # 에디터·언어
    원문

    [What's changed] Fixed vim mode `d`, `c` and `y` with a `gj` or `gk` count larger than the lines left deleting or copying text; like Vim, they now only move the cursor

  • `v` 대신 Claude용 긴 설명이 `/help`와 `/` 명령 메뉴에 표시되던 문제를 수정한다 # UI
    원문

    [What's changed] Fixed `/verify` showing a long description meant for Claude in `/help` and the `/` command menu instead of a short one

  • 클라우드 환경 생성 실패 시 대화상자 외부의 토스트 대신 대화상자 내부에 오류가 표시되도록 고친다 # 원격·클라우드
    원문

    [What's changed] [Cloud sessions] Fixed a failed cloud environment creation showing its error only as a toast outside the open dialog; it now appears inside the dialog

  • 루틴 페이지의 메뉴에서 수정 기능을 누를 때 편집 대화상자가 열리지 않던 문제를 수정한다 # 원격·클라우드
    원문

    [What's changed] [Cloud sessions] Fixed Edit in a routine's menu on the Routines page going to the routine's page without opening its edit dialog

  • 보관되지 않은 원격 제어 세션이 컴퓨터가 재연결될 때까지 작동 중으로 표시되던 문제를 수정한다 # 원격·클라우드
    원문

    [What's changed] [Remote Control] Fixed an unarchived Remote Control session showing as working until a computer reconnected; it now shows as idle

  • Slack에서 Claude가 다른 스레드에 답변할 때 가끔 잘못된 스레드에 파일을 게시하던 문제를 수정한다 # Git·연동
    원문

    [What's changed] [Claude Tag] Fixed Claude in Slack sometimes posting a file in the wrong thread when it was answering in another thread of the same channel

· 기타 2개

  • 공식 Anthropic 마켓플레이스의 플러그인이 선언한 원격 MCP 서버의 실제 이름을 OpenTelemetry가 보고하도록 변경한다 # MCP·플러그인
    원문

    [What's changed] Changed OpenTelemetry `mcp_server.name` to report the real name of fixed-URL remote MCP servers declared by plugins from the official Anthropic marketplace, instead of `custom`

  • Claude Code가 `claude_code.safety_event` OpenTelemetry 이벤트를 보내지 않도록 중단한다 # 성능
    원문

    [What's changed] Changed Claude Code to stop sending the `claude_code.safety_event` OpenTelemetry event

AI가 만든 요약입니다. 원문과 다르면 오류 제보해 주세요.