Δdeltalog

Claude Code 2.1.307

2026-10-22 릴리스 · 변경 항목 43개

원문 릴리스 노트 보기 ↗

breaking 2신기능 15수정 26

이 페이지는 Claude Code 2.1.307에서 바뀐 점을 유형별로 모은 것입니다.
  • 업그레이드 전에 먼저 확인하세요: breaking 2개
  • 항목 아래 ▸ 원문을 누르면 영어 원문이 펼쳐집니다.
이 버전을 쓰고 있다면: 최신 버전까지 바뀐 점 한 번에 보기 →

! breaking 2개

  • 설정 env 블록의 `axScreenReader` 설정과 `CLAUDE_AX_SCREEN_READER`가 사용자, 관리형 또는 --settings 설정에서만 적용되도록 변경한다 # CLI·설정
    원문

    [What's changed] Changed the `axScreenReader` setting and `CLAUDE_AX_SCREEN_READER` in a settings `env` block to apply only from user, managed or `--settings` settings (since 2.1.305)

  • 자체 호스팅 러너의 체크아웃 훅이 기본적으로 30분 후에 중단되도록 변경하고 `--checkout-hook-timeout-min`으로 조절할 수 있게 한다 # 원격·클라우드
    원문

    [What's changed] Self-hosted runner: Changed checkout hooks to be stopped after 30 minutes by default, failing the session's setup; if yours needs longer, raise `--checkout-hook-timeout-min` or set it to `0`

+ 신기능 15개

  • Claude API 코드를 API 버전 `2026-10-21`로 이동하는 `/claude-api api-version`을 추가한다 # CLI·설정
    원문

    [What's changed] Added `/claude-api api-version` to move Claude API code to API version `2026-10-21`

  • 도구 호출, 권한 규칙, 자동 모드 등에서 발생하는 `claude_code.safety_event` OpenTelemetry 이벤트를 추가한다 # 보안·권한
    원문

    [What's changed] Added the `claude_code.safety_event` OpenTelemetry event for each tool call a permission rule, auto mode, a safety check, a hook or the sandbox stopped, prompted or sent back

  • 파싱할 수 없는 도구 호출에 대한 복구를 개선하여 오류로 턴을 끝내기 전에 최대 두 번까지 호출을 재시도한다 # 에이전트
    원문

    [What's changed] Improved recovery from unparseable tool calls: Claude Code now retries the call up to twice before ending the turn with an error

  • 함께 실행되는 포크 서브에이전트가 자신의 실행을 구별하도록 하여 서로의 작업을 시도할 가능성을 줄인다 # 에이전트
    원문

    [What's changed] Improved fork subagents launched together: each is now told which launch is its own, so forks are much less likely to try to start each other's work

  • 브라우저 로그인 시 계정 프로필 로딩을 기다리지 않고 완료 즉시 성공 페이지가 나타나도록 개선한다 # 보안·권한
    원문

    [What's changed] Improved browser sign-in: the success page now appears as soon as sign-in completes, without waiting for your account profile to load

  • 새 리뷰를 시작하지 않고 pull request의 리뷰 구독을 끝내는 `@claude review stop` 명령을 코드 리뷰에 추가한다 # Git·연동
    원문

    [What's changed] [Code Review] Added `@claude review stop` (also `off` and `pause`) to Code Review, ending an `@claude review always` subscription on a pull request without starting a new review

  • 클라우드 및 자체 호스팅 러너 세션의 웹 검색 403 거부 오류 시 일반적인 인증 오류 대신 사유를 표시하도록 개선한다 # 원격·클라우드
    원문

    [What's changed] Improved web search errors in cloud and self-hosted runner sessions: a search refused with a 403 that gives a reason now shows that reason instead of a generic "Authentication error"

  • 데스크톱 앱의 MCP 서버 중 하나가 연결되지 않을 때 클라우드 세션의 첫 답변까지 걸리는 시간을 개선한다 # 원격·클라우드
    원문

    [What's changed] Improved the time to the first reply in cloud sessions when one of the desktop app's MCP servers can't connect

  • 대화 기록에 큰 붙여넣기 이미지나 PDF 읽기가 포함된 세션의 Remote Control 연결 시간을 개선한다 # 성능
    원문

    [What's changed] Improved Remote Control connect time for sessions whose transcript contains large pasted images or PDF reads

  • WebSearch 예산이 소진되었을 때 브라우저나 컴퓨터 사용을 통한 검색도 하지 않도록 Claude에게 전달하는 공지를 변경한다 # 모델·요금
    원문

    [What's changed] Changed the notice Claude gets when the WebSearch budget is used up to also tell it not to query search engines in a browser or through computer use

  • Anthropic 관리 git을 위해 빌드된 인증서 파일이 CLI처럼 신뢰할 수 있는 인증서를 필터링하도록 변경한다 # Git·연동
    원문

    [What's changed] Self-hosted runner: Changed the certificate file built for Anthropic-managed git to filter its trusted certificates as the CLI does; a `[runner:warn]` line gives the number left out

  • 음성 받아쓰기가 저절로 멈출 때 이유와 텍스트가 유지된다는 사실을 마이크 버튼에 공지로 추가한다 # UI
    원문

    [What's changed] [VSCode] Added a notice on the microphone button when voice dictation stops by itself (15 seconds without recognized speech, or the 2-minute limit), saying why and that the text so far is kept

  • 확장 프로그램 재시작 후 남아 있는 Claude 프로세스도 다른 곳에서 열려 있음 공지에 포함되도록 변경한다 # UI
    원문

    [What's changed] [VSCode] Changed the "still open somewhere else" notice to also cover a Claude process left over from an extension restart, which usually ends on its own within about 10 minutes

  • 음성 받아쓰기가 CLI처럼 신뢰할 수 있는 인증서를 필터링하도록 변경한다 # 보안·권한
    원문

    [What's changed] [VSCode] Changed voice dictation to filter its trusted certificates as the CLI does

  • 확장 프로그램의 자체 요청이 신뢰할 수 있는 인증서를 필터링하고 환경이나 사용자 설정의 `NODE_EXTRA_CA_CERTS` 파일을 신뢰하도록 변경한다 # 보안·권한
    원문

    [What's changed] [VSCode] Changed the extension's own requests to filter their trusted certificates as the CLI does, and to trust the `NODE_EXTRA_CA_CERTS` file named in the environment or in user settings

~ 수정 26개

  • `CLAUDE_CODE_DISABLE_1M_CONTEXT`가 설정된 상태에서 `opus[1m]` 같은 모델을 사용할 때 model-not-found 오류가 나던 문제를 수정한다 # 모델·요금
    원문

    [What's changed] Fixed requests failing with a model-not-found error when `CLAUDE_CODE_DISABLE_1M_CONTEXT` is set and the model is an alias with the `[1m]` suffix, such as `opus[1m]`

  • 키체인이 잠긴 macOS의 `claude -p`에서 MCP 서버가 인증 필요로 표시되던 문제를 수정한다 # MCP·플러그인
    원문

    [What's changed] Fixed MCP servers showing "needs authentication" in `claude -p` on macOS while the login keychain was locked; they now say why, and the next run after an unlock connects without a new sign-in

  • macOS나 Linux 컴퓨터가 절전 모드에 들어갈 때 MCP 서버가 시간 초과로 처리되던 문제를 수정한다 # MCP·플러그인
    원문

    [What's changed] Fixed MCP servers being reported as timed out, and staying failed in headless runs, when a macOS or Linux computer went to sleep while they were connecting

  • 연결이 끊긴 중간에 HTTP MCP 도구 호출이 두 번 전송되던 문제를 수정하고 읽기 전용 또는 멱등성 도구만 재시도한다 # MCP·플러그인
    원문

    [What's changed] Fixed HTTP MCP tool calls being sent twice when the connection closed mid-call; only read-only or idempotent tools are now retried

  • /permissions 메뉴에서 거부된 쉘 명령이 보이지 않던 문제를 수정하고 승인 시 설명 대신 명령 이름을 표시한다 # 보안·권한
    원문

    [What's changed] Fixed `/permissions` > Recently denied not showing the denied shell command, and auto mode's local classifier ignoring an approval from there when it checks a retried command; approving a row now names the command, not its description

  • API가 모델을 확인하는 데 5초 이상 걸릴 때 Agent SDK의 모델 변경이 거부되던 문제를 수정하고 최대 15초까지 기다리게 한다 # 모델·요금
    원문

    [What's changed] Fixed model switches through the Agent SDK's `setModel()`, and apps built on it, being refused when the API took more than 5 seconds to confirm the model; Claude Code now waits up to 15 seconds

  • `NODE_EXTRA_CA_CERTS`가 `~/.claude/settings.json`에만 설정된 TLS 검사 프록시 뒤에서 받아쓰기가 실패하던 문제를 수정한다 # 보안·권한
    원문

    [What's changed] [VSCode] Fixed dictation failing behind a TLS-inspecting proxy when `NODE_EXTRA_CA_CERTS` is set only in `~/.claude/settings.json`; it now also follows `CLAUDE_CODE_CERT_STORE`

  • 사용되지 않는 `ANTHROPIC_BASE_URL` 게이트웨이와 Foundry에서 `prompt-caching-scope` 베타 헤더가 전송되던 문제를 수정한다 # CLI·설정
    원문

    [What's changed] Fixed the `prompt-caching-scope` beta header being sent behind custom `ANTHROPIC_BASE_URL` gateways and on Foundry, where it has no effect

  • 백그라운드 작업이 실행되는 동안 턴이 SDK MCP 서버의 최신 도구 없이 시작되던 문제를 수정한다 # MCP·플러그인
    원문

    [What's changed] Fixed a turn sometimes starting without an SDK MCP server's latest tools when a background task was running

  • 많은 PDF 페이지나 이미지를 읽는 턴에서 발생하던 Autocompact 스레싱 오류를 수정한다 # 세션·컨텍스트
    원문

    [What's changed] Fixed some "Autocompact is thrashing" errors in turns that read many PDF pages, images or other large tool results

  • 클라우드 세션에서 세션이 재시작된 후 `/autocompact`가 기본 창으로 돌아가던 문제를 수정한다 # 세션·컨텍스트
    원문

    [What's changed] Fixed `/autocompact` in cloud sessions going back to the default window after the session restarted

  • /clear로 지운 대화가 클라우드나 자체 호스팅 러너 세션이 재시작될 때 다시 나타나던 문제를 수정한다 # 세션·컨텍스트
    원문

    [What's changed] Fixed a conversation cleared with `/clear` sometimes coming back when a cloud or self-hosted runner session restarted

  • Claude 앱 게이트웨이 세션에서 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`가 무시되던 문제를 수정한다 # 원격·클라우드
    원문

    [What's changed] Fixed `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` being ignored in Claude apps gateway sessions

  • `OTEL_EXPORTER_OTLP_HEADERS`가 설정된 상태에서 Claude 앱 게이트웨이를 거치는 Claude Desktop 텔레메트리가 거부되던 문제를 수정한다 # 원격·클라우드
    원문

    [What's changed] Fixed telemetry from Claude Desktop sessions behind a Claude apps gateway being rejected when `OTEL_EXPORTER_OTLP_HEADERS` is set

  • /help와 / 명령 메뉴에 번들 스킬의 긴 모델용 설명 대신 짧은 설명이 나오도록 수정한다 # UI
    원문

    [What's changed] Fixed `/help` and the `/` command menu showing long model-facing descriptions for bundled skills such as `/claude-api` instead of their short descriptions

  • 서브에이전트 트랜스크립트가 스트리밍 응답에 대해 빈 토큰 사용량과 중단 이유를 기록하던 문제를 수정한다 # 에이전트
    원문

    [What's changed] Fixed subagent transcripts recording placeholder token usage and an empty stop reason for streamed responses

  • 연결된 앱을 통해 중단된 백그라운드 명령이 사용자에 의해 중단된 것으로 보고되던 문제를 수정하고 출력 파일 이름을 남긴다 # 원격·클라우드
    원문

    [What's changed] Fixed a background command stopped through a connected app (such as the desktop app archiving an idle session) being reported to Claude as stopped by the user; the notice now names its output file

  • Cowork 클라우드 세션의 WebFetch가 4xx 상태나 robots.txt 거부 시 도구 오류로 보고하던 문제를 일반 결과로 수정한다 # 원격·클라우드
    원문

    [What's changed] Fixed WebFetch in Cowork cloud sessions reporting a tool error when a site answered with a 4xx status or a robots.txt refusal; it is now a normal result, as in local sessions

  • 데스크톱 앱의 Code 탭에서 GitHub MCP 서버의 쓰기 도구 폼이 생성 없이 닫히던 문제를 수정한다 # MCP·플러그인
    원문

    [What's changed] Fixed write tools on a directly configured GitHub MCP server showing a form that closed without creating anything in the desktop app's Code tab

  • 서버가 재사용된 연결을 닫았을 때 Artifact 도구 읽기가 연결 재설정으로 실패하던 문제를 수정한다 # MCP·플러그인
    원문

    [What's changed] Fixed Artifact tool reads failing with a connection reset when the server had closed a reused connection

  • --use-anthropic-git-proxy를 사용하는 자체 호스팅 러너 세션이 이전 세션의 설정을 커밋하던 문제를 수정한다 # Git·연동
    원문

    [What's changed] Self-hosted runner: Fixed sessions with `--use-anthropic-git-proxy` committing a `.claude/settings.local.json` left in the clone by an earlier session

  • 체크아웃 훅 중에 러너를 중단하거나 세션을 보관할 때 훅 프로세스가 계속 실행되던 문제를 수정한다 # 원격·클라우드
    원문

    [What's changed] Self-hosted runner: Fixed archiving or requeueing a session, or stopping the runner, during its checkout hook leaving the hook's processes running and the runner's slot held

  • Show more로 확장된 긴 프롬프트가 채팅 패널 전체를 가리던 문제를 수정하여 패널의 40%로 제한하고 스크롤되게 한다 # UI
    원문

    [What's changed] [VSCode] Fixed a long prompt expanded with Show more covering the whole chat panel: a pinned prompt is now capped at 40% of the panel and scrolls

  • LaTeX 수식이 포함된 목록 항목이나 표 셀의 일부가 서식 있는 텍스트 편집기에서 새 목록이나 표로 붙여넣어지던 문제를 수정한다 # 에디터·언어
    원문

    [What's changed] [VSCode] Fixed part of a list item or table cell with LaTeX math pasting as a new list or table in rich text editors

  • 검색 중 저장소 선택기가 저장소가 일치하지 않음으로 표시하던 문제를 수정하여 결과가 올 때까지 검색 중으로 표시한다 # 원격·클라우드
    원문

    [What's changed] [Cloud sessions] Fixed the repository picker saying "No repositories match" while a search was still running; it now shows "Searching…" until the results arrive

  • 자체 호스팅 환경에서 러너 대기 중 상태가 잘리던 문제를 수정하고 마지막 메시지부터의 경과 시간과 실패한 시도를 표시한다 # 원격·클라우드
    원문

    [What's changed] [Cloud sessions] Fixed the "Waiting for a runner" status on self-hosted environments being cut off; with on-demand runners it now counts up from your last message and shows failed attempts

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