Claude Code 2.1.307
2026-10-22 릴리스 · 변경 항목 43개
breaking 2신기능 15수정 26
- 업그레이드 전에 먼저 확인하세요: 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가 만든 요약입니다. 원문과 다르면 오류 제보해 주세요.