업데이트 내용을 표시하지 못했습니다.
스크립트가 꺼져 있거나 불러오지 못했습니다. Claude Code CHANGELOG 원문에서 확인해 주세요.
업데이트 내용을 표시하지 못했습니다.
데이터를 불러오거나 화면에 그리는 중 문제가 생겼습니다. 페이지를 다시 불러오거나 Claude Code CHANGELOG 원문에서 확인해 주세요.
릴리스 규모
버전 하나에
평균 7.0개가 바뀌었습니다.
28개 버전에서 변경 197개를 정리했습니다. 버전 하나당 평균은 7.0개이고, 최신 2.1.318에는 10개가 담겼습니다.
핵심 변경 8개
모델, 보안, 확장 기능에
핵심 변경이 모였습니다.
핵심 변경 8개 중 모델/추론이 3개, 보안/권한이 2개, 훅/SDK/플러그인/Mods가 2개입니다. Opus 4.8 빠른 모드는 2026-11-30에 제거되므로 속도 이점을 유지하려면 Opus 5.5로 옮겨야 합니다.
Claude Mods 도입
플러그인이 Claude Code의 더 깊은 동작을 바꿀 수 있고, 기본 제공 Mod 'You should know'가 놓친 점을 짚어 줍니다.
Claude Haiku 5.5가 기본 Haiku 모델로
Anthropic API의 기본 Haiku가 1M 컨텍스트의 Haiku 5.5로 바뀌어 빠른 작업의 기본 성능이 달라집니다.
Opus 4.8 빠른 모드 폐지 예고
2026-11-30에 제거되므로 속도 이점을 유지하려면 Opus 5.5로 옮겨야 합니다.
유휴 대화 자동 압축
200K 토큰 이상 대화를 오래 방치하면 요약해 두어, 돌아왔을 때 긴 컨텍스트 비용과 지연을 줄입니다(터미널 2.1.299, VS Code·데스크톱 2.1.314).
작업 폴더 밖 쓰기 차단 설정
permissions.blockWritesOutsideWorkingDirectories로 모든 권한 모드에서 작업 폴더 밖 파일 수정을 막을 수 있습니다.
샌드박스 우회 경로 차단
샌드박스 밖에서 셸 시작 파일이 실행되거나 --mcp-config 파일이 수정되던 경로를 막아 샌드박스 신뢰도가 높아집니다.
서브에이전트 effort 직접 제어
Agent 도구 effort 파라미터(2.1.292), CLAUDE_CODE_SUBAGENT_EFFORT(2.1.316)로 서브에이전트의 추론 강도와 비용을 조절할 수 있습니다.
훅 실패 시 작업 차단(onFailure: block)
명령·HTTP 훅(2.1.295)과 Agent SDK 훅 콜백(2.1.317)이 실패하면 동작을 막을 수 있어, 훅 기반 안전장치가 조용히 뚫리지 않습니다.
커뮤니티 반응
핵심 변경 가운데 Hacker News 반응은 Haiku 5.5 출시 글이,
GitHub 저장소 언급은 Mods가 가장 많았습니다.
핵심 변경 8개 중 3개에서 반응 수치를 확인했습니다. Hacker News에서 가장 큰 스레드는 Haiku 5.5 모델 출시 글(점수 1,049, 댓글 489)이고, GitHub에서 이름을 언급한 저장소가 가장 많은 것은 Claude Mods(985개)입니다. 나머지 5개는 자료가 부족합니다.
Hacker News에서 Haiku 5.5 모델 출시 글의 반응은 1,538개(점수와 댓글의 합)이지만, Claude Code가 기본값으로 바꿨다는 직접 스레드(Tell HN)의 반응은 2개(점수 2, 댓글 0)입니다. GitHub에서 "claude mods"를 언급한 저장소는 985개, "haiku 5.5"를 언급한 저장소는 99개이며, 검색어와 집계 시작일이 달라 같은 조건의 비교는 아닙니다.
Hacker News 대표 스레드의 반응 단위: 개(점수 + 댓글) · 로그 눈금 · 점은 공개일 이후 올라온 스레드 중 점수가 가장 큰 것
1,538개
40개
GitHub 저장소 수 단위: 개 · 로그 눈금 · "기능 이름"을 언급하고 공개일 이후 생성된 저장소
985개
99개
6개
Hacker News는 기능 이름으로 찾은 스레드만 봤고 Reddit·X·기사는 확인하지 못했습니다. Haiku 5.5 글은 모델 출시 글이며 Claude Code 기능만 다룬 글이 아닙니다. 저장소 수는 이름을 언급한 저장소 수라서 기능을 실제로 쓴 저장소 수와 다를 수 있고, 검색어와 집계 시작일이 주제마다 달라 대상 범위가 같지 않습니다. 로그 눈금이라 막대 길이가 아니라 위치로 읽습니다.
수치 표 보기
| 주제 | 버전 | 대표 스레드 | 점수 | 댓글 | 언급 저장소 | 집계 시작일 | 이슈 댓글 |
|---|---|---|---|---|---|---|---|
| Claude Haiku 5.5가 기본 Haiku 모델로 | 2.1.293 | Claude Haiku 5.5 모델 출시 글Tell HN: Claude Code now defaults to Haiku 5.5 · Claude Code 직접 스레드 · 점수 2 · 댓글 0 | 1,049 | 489 | 99"haiku 5.5" | 2026-10-07 | — |
| Claude Mods 도입 | 2.1.287 | Show HN: agent-usage-guard – a Claude Code mod to protect your usage window 제3자 Mod 소개 글Claude Code Mods · Anthropic 공식 글 · 점수 6 · 댓글 0 | 28 | 12 | 985"claude mods" | 2026-10-01 | 276공개 전 개설 |
| 유휴 대화 자동 압축 | 2.1.299 | — | — | — | 6아래 주석"idle compaction" | 2026-10-14 | 25공개 전 개설 |
| Opus 4.8 빠른 모드 폐지 예고 | 2.1.316 | — | — | — | — | — | — |
| 작업 폴더 밖 쓰기 차단 설정 | 2.1.314 | — | — | — | 0"blockWritesOutsideWorkingDirectories" | 2026-10-30 | — |
| 샌드박스 우회 경로 차단 | 2.1.309 | — | — | — | — | — | — |
| 서브에이전트 effort 직접 제어 | 2.1.316 | — | — | — | 0"CLAUDE_CODE_SUBAGENT_EFFORT" | 2026-10-31 | — |
| 훅 실패 시 작업 차단(onFailure: block) | 2.1.317 | — | — | — | 0"onFailure: block" | 2026-10-08 | — |
이슈 댓글 칸의 공개 전 개설은 공개 전에 열린 이슈의 값이라 차트와 판정에 쓰지 않았습니다. — 는 확인한 자료가 없다는 뜻이고 0은 확인했으나 없다는 뜻입니다. 언급 저장소 링크는 지금의 검색 결과를 열어서 표의 값(확인 시각 기준)과 다를 수 있습니다.
유휴 대화 자동 압축: 2026-10-01에 열린 이슈 제목이 2.1.286의 유휴 압축을 가리키므로 2.1.299 이전에도 관련 동작이 있었을 수 있으며, 집계 시작일 2026-10-14 이전에 만들어진 저장소는 세지 않았다.
만들어진 것
Claude Mods와 유휴 압축을 이름으로 언급한 공개 저장소 10개입니다. 표의 저장소는 GitHub 저장소 검색(기능 이름을 따옴표로 묶은 문구, 공개일 이후 생성) 결과를 별이 많은 순으로 정렬해 주제마다 위에서 5개씩 고른 것이고, 별 수가 같으면 먼저 만든 저장소를 앞에 두었습니다. Haiku 5.5는 모델 이름이라 만든 것을 고르지 않았습니다. 별은 기준입니다.
| 저장소 | 주제 | 별 | 만든 것 |
|---|---|---|---|
| wh000wh000/awesome-claude-mods | Claude Mods 도입 | 269 | Claude Code Mod·플러그인·훅을 근거 등급과 함께 모은 색인(목록 저장소) |
| Tickloop/claude-mods | Claude Mods 도입 | 83 | Claude Code Mod 모음 |
| zycck/claude-mods | Claude Mods 도입 | 66 | 프롬프트 위에 계획 진행 막대를 실시간으로 보여 주는 Mod |
| kagamiurayama/claude-code-roof-mod | Claude Mods 도입 | 31 | 바이너리를 고치지 않고 시스템 프롬프트와 영어 알림 문구를 바꾸는 Mod(2.1.287 이상) |
| Jhonatan-de-Souza/ClaudeMods | Claude Mods 도입 | 28 | Claude Tools 메뉴, Zen 모드, 터미널 테마, effort·모드 제어를 더하는 Mod |
| Sn0wo2/oc-idle-compaction | 유휴 대화 자동 압축 | 1 | OpenCode용 플러그인으로, 프롬프트 캐시가 만료되기 전에 큰 유휴 세션을 요약(Claude Code 도구가 아님) |
| ohnotnow/idle-compact-warning | 유휴 대화 자동 압축 | 0 | 유휴 압축이 일어나기 전에 알려 주는 Mod |
| peritus-slf/cache-guard | 유휴 대화 자동 압축 | 0 | 캐시 카운트다운과 keep-alive 핑으로 긴 세션이 식지 않게 하고 유휴 압축을 다루는 도구 |
| lytedev/pi-hot-idle-compaction | 유휴 대화 자동 압축 | 0 | Pi 코딩 에이전트용 확장으로, 프롬프트 캐시가 살아 있는 동안 대화를 요약해 긴 세션 비용을 줄임(Claude Code 도구가 아님) |
| tarnish233/pi-cc-compaction | 유휴 대화 자동 압축 | 0 | Claude Code의 압축 방식을 Pi 코딩 에이전트에 옮긴 도구 |
확인 시각 . 측정 방법과 넣지 않은 스레드는 출처와 기준에 있습니다.
카테고리별 분포
버그 수정이
신기능의 2배입니다.
197개 항목을 8개 카테고리로 나눴습니다. 항목마다 카테고리는 하나이고, 막대는 0에서 시작해 항목 수에 비례합니다. 비교 대상인 버그 수정과 신기능에만 색을 썼습니다.
버그 수정 46개는 신기능 23개의 2배로, 197개 중 가장 많습니다. 버그 수정과 개선/변경을 합치면 82개이고, 훅/SDK/플러그인/Mods가 31개로 세 번째입니다.
카테고리별 항목 수 단위: 개 · 비중은 전체 197개 대비
수치 표 보기
| 카테고리 | 항목 수 | 전체 대비 | 항목이 있는 버전 |
|---|---|---|---|
| 버그 수정 | 46 | 23% | 20 / 28 |
| 개선/변경 | 36 | 18% | 19 / 28 |
| 훅/SDK/플러그인/Mods | 31 | 16% | 19 / 28 |
| 신기능 | 23 | 12% | 14 / 28 |
| 보안/권한 | 22 | 11% | 11 / 28 |
| 모델/추론 | 15 | 8% | 11 / 28 |
| 게이트웨이/엔터프라이즈 | 13 | 7% | 10 / 28 |
| IDE/클라우드/통합 | 11 | 6% | 10 / 28 |
버전별 변경 기록
변경 항목이
버전별로 모두 실렸습니다.
최신 2.1.318부터 2.1.287까지 28개 버전을 날짜순으로 나열했습니다. 항목마다 한국어 요약 아래에 영어 원문이 있고, 카테고리와 검색어로 좁힐 수 있습니다. 날짜는 npm 게시일(UTC)이라 한국 시간으로는 하루 뒤 날짜일 수 있습니다.
필터와 검색
197개 항목 / 28개 버전 표시 중
조건에 맞는 항목이 없습니다.
검색어를 줄이거나 카테고리 선택을 바꿔 보세요.
- 2026년 11월
- 신기능
세션에서 직접 만든 Mod를 켤지 물을 때 사용자의 답을 기록합니다.
Claude Code now records your answer when it asks to turn on mods it wrote in a session.
- 게이트웨이/엔터프라이즈
Claude apps 게이트웨이의 mantle 업스트림에서 assume_role을 지원해 다른 AWS 계정의 역할 사용과 개발자별 비용 귀속이 가능합니다.
assume_role on mantle upstreams of the Claude apps gateway supports a role in another AWS account and per-developer AWS cost attribution.
- 훅/SDK/플러그인/Mods
Mod의 $.model.fork가 effort 옵션을 받아 간단한 부가 작업을 low로 실행할 수 있습니다.
A mod's $.model.fork accepts an effort option, so quick side jobs can run at low.
- 신기능
claude auth status와 claude -p JSON 출력에 저장된 claude.ai 로그인의 만료 시점이 표시됩니다.
claude auth status and claude -p JSON output show when a stored claude.ai sign-in expires.
- 신기능
claude -p 텍스트 출력은 저장된 로그인 만료 10일 전부터 stderr 경고를 출력합니다.
claude -p text output prints a stderr warning starting 10 days before a stored sign-in ends.
- 개선/변경
IDE 터미널에서 시작할 때 더 이상 IDE 확장을 설치하거나 업데이트하지 않습니다.
Claude Code no longer installs or updates the IDE extension when started in an IDE terminal.
- 개선/변경
백그라운드 서브에이전트의 셸 명령이 모든 제공자에서 3분 뒤 백그라운드로 전환됩니다.
Background subagents move a shell command to the background after 3 minutes on all providers.
- 개선/변경
이전 대화를 재개할 때 이전 모델의 thinking을 유지하던 2.1.288의 수정이 제거되었습니다.
The 2.1.288 fix that kept earlier model thinking when resuming older conversations is gone.
- 버그 수정
잘못된 도구 호출의 재시도가 소진된 뒤 --continue가 이전 대화 일부를 잃던 문제를 고쳤습니다.
--continue sometimes lost earlier conversation after a malformed tool call's retries ran out.
- 버그 수정
버전 정리가 실행 중인 바이너리를 지운 뒤 claude remote-control 호스트가 세션을 시작하지 못하던(spawn ENOENT) 문제를 고쳤습니다.
claude remote-control hosts failed to start sessions (spawn ENOENT) after version cleanup removed a running binary.
- 신기능
- 보안/권한
/schedule이 새 클라우드 예약 작업에 요청하지 않은 커넥터가 붙으면 경고하고 제거 방법을 안내합니다.
/schedule warns when a new cloud scheduled task gets connectors you didn't ask for, and explains how to remove them.
- 보안/권한
웹 또는 셸 도구 호출이 계정 이메일 주소를 네트워크로 보내기 전에 확인을 요청합니다.
A check asks before a web or shell tool call sends your account email address to the network.
- 훅/SDK/플러그인/Mods
Agent SDK 훅 콜백에 onFailure: block을 지원해, 콜백이 실패하면 해당 동작을 차단합니다.
onFailure: block for Agent SDK hook callbacks blocks the action when a callback fails.
- 게이트웨이/엔터프라이즈
게이트웨이 관리자 API에 비용 리포트(GET /v1/organizations/analytics/cost)가 추가되어 기간별 과거 지출을 조회합니다.
A cost report in the Claude apps gateway admin API (GET /v1/organizations/analytics/cost) covers past spend over a date range.
- 훅/SDK/플러그인/Mods
CLAUDE_CODE_DISABLE_NESTED_SESSION_ID로 세션 안의 claude -p가 이전처럼 그 세션 ID를 쓰게 할 수 있습니다.
CLAUDE_CODE_DISABLE_NESTED_SESSION_ID lets claude -p inside a session use that session's ID, as in earlier versions.
- 모델/추론
다른 모델을 쓰는 서브에이전트와 팀원은 세션이 아니라 해당 모델의 저장된 effort 또는 기본 effort를 사용합니다.
Subagents and teammates on a different model use that model's saved effort level or its default, not the session's.
- 개선/변경
Read 도구의 '마지막 Read 이후 파일이 바뀌지 않음' 스텁이 사라져, 변경 없는 파일도 다시 읽으면 내용이 반환됩니다.
The Read tool's 'file unchanged since your last Read' stub is gone; rereading an unchanged file returns its content.
- 버그 수정
디스크 가득 참이나 쿼터로 대화 기록 또는 ~/.claude.json 쓰기가 실패해도 claude -p가 0으로 종료하던 문제를 고쳐 이제 1로 종료합니다.
claude -p exited 0 when a full disk or quota lost transcript or ~/.claude.json writes; it now exits 1.
- 버그 수정
LLM 게이트웨이가 안전 검사에 403 또는 422로 응답하면 자동 모드가 매 턴 실패하던 문제를 고쳤습니다.
Auto mode failed every turn when an LLM gateway answered 403 or 422 to its safety check.
- 버그 수정
일부 Claude 데스크톱 세션에서 프로젝트·로컬 MCP 서버가 첫 턴 뒤 연결이 끊기던 문제를 고쳤습니다.
Project and local MCP servers disconnected after the first turn in some Claude desktop sessions.
- 보안/권한
- 2026년 10월
- 모델/추론
CLAUDE_CODE_DISABLE_ULTRATHINK로 ultrathink 키워드를 끌 수 있습니다.
CLAUDE_CODE_DISABLE_ULTRATHINK turns off the ultrathink keyword.
- 게이트웨이/엔터프라이즈
게이트웨이의 그룹 공동 예산으로 구성원이 하나의 월 예산을 함께 씁니다.
Pooled group budgets on the Claude apps gateway give a group one monthly budget its members share.
- 모델/추론
CLAUDE_CODE_SUBAGENT_EFFORT로 서브에이전트가 세션 설정을 상속하지 않고 지정한 effort로 실행됩니다.
CLAUDE_CODE_SUBAGENT_EFFORT sets the effort level subagents run at, instead of inheriting the session's.
- 게이트웨이/엔터프라이즈
managed.policy_mode: layered로 일치하는 모든 정책을 아래 정책 위에 겹쳐 적용합니다.
managed.policy_mode: layered on the gateway applies every matching policy, each merged over the ones below it.
- 모델/추론
Opus 4.8 빠른 모드는 2026-10-30부로 폐지 예정이며 2026-11-30에 제거됩니다. 속도 이점을 유지하려면 Opus 5.5로 옮기세요.
Fast mode for Opus 4.8 is deprecated as of October 30, 2026 and will be removed on November 30, 2026; migrate to Opus 5.5 to keep the speedup.
- 보안/권한
Team·Enterprise 로그인의 서버 관리 설정이 승인 프롬프트 없이 적용되며, 검증되지 않는 저장본은 거부됩니다.
Server-managed settings for Team and Enterprise logins apply without an approval prompt, and a stored copy that doesn't verify is refused.
- 버그 수정
Claude Code가 스스로 종료할 때 macOS·Linux에서 셸 명령이 계속 실행되던 문제를 고쳤습니다.
Shell commands stayed running on macOS and Linux when Claude Code exited by itself.
- 버그 수정
Vertex AI와 Bedrock에서 최신 모델을 쓸 수 없을 때 sonnet, opus, haiku가 오류를 내는 대신 이전 모델로 전환하도록 고쳤습니다.
sonnet, opus and haiku on Vertex AI and Bedrock showed an error mid-session instead of switching to an older model when the newest wasn't available.
- 버그 수정
게이트웨이가 요청에 포함된 모든 모델을 availableModels, deniedModels, models와 대조하지 않던 문제를 고쳤습니다.
The gateway didn't check every model a request names against availableModels, deniedModels and models.
- 보안/권한
--restricted 세션이 Read 허용 규칙이 있을 때 작업 폴더 밖 파일을 업로드하던 문제를 고쳤습니다.
--restricted sessions uploaded files from outside the working directories when a Read allow rule covered them.
- 모델/추론
- 보안/권한
permissions.blockWritesOutsideWorkingDirectories로 모든 권한 모드에서 Write, Edit, NotebookEdit이 작업 폴더 밖 경로를 거부합니다.
permissions.blockWritesOutsideWorkingDirectories makes Write, Edit and NotebookEdit refuse paths outside the working directories in every permission mode.
- IDE/클라우드/통합
VS Code와 데스크톱 Code 탭에서 200K+ 토큰 대화를 오래 방치하면 유휴 압축이 요약합니다.
Idle compaction in VS Code and the Desktop Code tab summarizes a 200K+ token conversation left idle.
- 게이트웨이/엔터프라이즈
게이트웨이 업스트림에 선택적 groups 목록을 두어 지정한 IdP 그룹의 개발자만 해당 업스트림으로 보냅니다.
An optional groups list on gateway upstreams sends only developers in the listed IdP groups to that upstream.
- 게이트웨이/엔터프라이즈
게이트웨이 Bedrock 업스트림에 guardrail_trace가 추가되어 어떤 Bedrock 가드레일 필터가 작동했는지 일치한 텍스트 없이 기록합니다.
guardrail_trace on gateway Bedrock upstreams logs which Bedrock guardrail filter fired, without the matched text.
- 개선/변경
FORCE_HYPERLINK=false(no, off 포함)가 이제 하이퍼링크를 끕니다.
FORCE_HYPERLINK=false (also no and off) now turns hyperlinks off.
- 모델/추론
설정상 구형 Opus만 허용되거나 모델이 없을 때, 플래그된 요청이 거부로 끝나지 않고 다른 모델로 재시도됩니다.
Flagged requests retry on another model, not end in a refusal, when settings leave only an older Opus model or none.
- 개선/변경
Bash 셸이 상속된 which 별칭·함수를 지워 which가 시스템 명령 또는 zsh 내장 명령이 됩니다.
The Bash shell clears any inherited which alias or function, so which is the system command or zsh builtin.
- 버그 수정
관리자가 모델 effort를 제한했을 때 'Invalid effort level'로 매 턴 실패하던 문제를 고쳐, 이제 effort를 낮춰 재시도합니다.
Sessions failed turn after turn with 'Invalid effort level' when an admin capped a model's effort; Claude Code now lowers the effort and retries.
- 버그 수정
시작 실패 시 claude -p가 출력 없이 0으로 종료하던 문제를 고쳐 이제 오류를 출력하고 1로 종료합니다.
claude -p exited 0 with no output when startup failed; it now prints the error and exits 1.
- 버그 수정
Microsoft Foundry에 기본 Sonnet, Opus, Haiku 배포가 없을 때 세션이 실패하던 문제를 고쳐 같은 계열의 이전 모델로 대체합니다.
Microsoft Foundry sessions failed when the resource had no deployment for the default Sonnet, Opus or Haiku; Claude Code now falls back to an older model in that family.
- 보안/권한
- 게이트웨이/엔터프라이즈
게이트웨이의 oidc.user_id_claim으로 sub 대신 Entra ID의 oid 같은 id_token 클레임으로 사용자를 식별합니다.
oidc.user_id_claim on the Claude apps gateway identifies people by an id_token claim other than sub, such as Entra ID's oid.
- 신기능
전체 화면에서 대기 중 메시지 아래의 'to send now' 안내를 클릭하면 즉시 전송됩니다.
In fullscreen, clicking the 'to send now' hint under a queued message sends it right away.
- 모델/추론
Bedrock, Vertex, Foundry, Mantle에서 인식되지 않는 모델 이름에 짧은 시스템 프롬프트를 쓰며, CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0으로 전체 프롬프트를 유지할 수 있습니다.
Bedrock, Vertex, Foundry and Mantle use the shorter system prompt for unrecognized model names; CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 keeps the full prompt.
- 모델/추론
플래그된 메시지 뒤 자동 모델 전환이 인식되지 않는 모델 이름에도 적용되며, CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1로 끌 수 있습니다.
Automatic model switches after a flagged message also cover unrecognized model names; CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 turns them off.
- 개선/변경
사용량 한도 메시지가 5시간 구간을 '세션 한도' 대신 '5시간 한도'로 부릅니다.
Usage limit messages call the 5-hour window the '5-hour limit' instead of the 'session limit.'
- 훅/SDK/플러그인/Mods
프롬프트·에이전트 훅은 서브에이전트를 포함해 세션당 동시에 최대 24개까지 실행됩니다.
Prompt and agent hooks run at most 24 at a time per session, subagents included.
- 개선/변경
서브에이전트의 autoCompactWindow가 CLAUDE_CODE_AUTO_COMPACT_WINDOW 값을 낮출 수 있게 되었습니다.
A subagent's autoCompactWindow can lower the window set by CLAUDE_CODE_AUTO_COMPACT_WINDOW, where it previously had no effect.
- 훅/SDK/플러그인/Mods
claude_code.safety_event OpenTelemetry 이벤트 전송을 중단했습니다.
Claude Code stops sending the claude_code.safety_event OpenTelemetry event.
- 버그 수정
VS Code 확장에서 로그인한 뒤 관리 설정과 조직 정책을 세션 내내 가져오지 못하던 문제를 고쳤습니다.
Managed settings and organization policy weren't fetched for the rest of the session after signing in from the VS Code extension.
- 버그 수정
아주 큰 CLAUDE.md, 규칙 파일, @포함 파일을 앞부분만 보고 덮어쓰던 문제를 고쳐 Write가 전체를 읽거나 제자리 편집하도록 요청합니다.
Claude overwrote a very large CLAUDE.md, rules file or @-included file after seeing only its start; Write now asks Claude to read it all or edit in place.
- 버그 수정
잘못된 이름의 명령 하나가 모든 명령 로딩을 막아 claude -p 출력이 없어지던 문제를 고쳤습니다.
A command with an invalid name stopped all commands from loading, which could leave claude -p with no output.
- 게이트웨이/엔터프라이즈
- IDE/클라우드/통합
self-hosted-runner에 --hold-idle-file, --max-hold-min 옵션이 추가되어 호스트가 남은 프로세스를 알리는 동안 유휴 세션을 열어 둡니다.
New --hold-idle-file and --max-hold-min options for self-hosted-runner keep an idle session open while your host reports leftover processes.
- 신기능
설명을 요청하면 Explanatory 출력 스타일 팁이 표시됩니다.
A tip for the Explanatory output style appears when you ask Claude for explanations.
- 모델/추론
터미널에서 ultrathink가 Anthropic API의 여러 5.5 시리즈 모델과 Fable 5.1에서 xhigh effort로 실행됩니다.
ultrathink in the terminal runs its turn at xhigh effort on several 5.5-series models and Fable 5.1 via Anthropic's API.
- 개선/변경
효과가 없는 곳에서는 모델 이름에서 [1m] 접미사와 라벨이 빠집니다(접미사는 계속 허용).
Model names drop the [1m] suffix and its label where the suffix has no effect, though it is still accepted.
- 개선/변경
설정 파일과 Mod env의 DISABLE_COMPACT는 압축을 끄는 용도로만 동작하며 다시 켤 수는 없습니다.
DISABLE_COMPACT in settings files and mod env can only turn compaction off, not back on.
- 게이트웨이/엔터프라이즈
Bedrock, Mantle, Vertex, Foundry가 서명된 파일에서 모델 설정을 불러오며 CLAUDE_CODE_MODEL_CATALOG=off로 끌 수 있습니다.
Bedrock, Mantle, Vertex, and Foundry load model settings from a signed file, which CLAUDE_CODE_MODEL_CATALOG=off can disable.
- 버그 수정
표준 컨텍스트 세션에서 요청이 200K 토큰을 넘어도 사용량 크레딧 오류로 멈추지 않고 압축 후 계속합니다.
Standard-context sessions no longer stop with a usage-credits error when a request exceeds 200K tokens; Claude compacts and continues.
- 버그 수정
API가 재시도 불가로 표시한 요청을 더 이상 재시도하지 않아 턴이 몇 분간 또는 무한정 멈추던 문제가 사라집니다.
Requests the API marks as non-retryable are no longer retried, which could stall turns for minutes or indefinitely.
- 버그 수정
서브에이전트 시작 후 연결을 마치는 MCP 서버의 도구도 서브에이전트가 사용할 수 있습니다.
Subagents can now use MCP tools from servers that finish connecting after the subagent starts.
- IDE/클라우드/통합
- IDE/클라우드/통합
Monitor 도구와 플러그인 모니터가 Bedrock, Vertex, Foundry와 텔레메트리·비필수 트래픽을 끈 상태에서도 동작합니다.
The Monitor tool and plugin monitors now work on Bedrock, Vertex, and Foundry, and when telemetry or nonessential traffic is disabled.
- 게이트웨이/엔터프라이즈
클라우드 세션과 Remote Control 권한을 Enterprise 커스텀 역할에서 설정할 수 있습니다.
Cloud session and Remote Control permissions can be set in Enterprise custom roles.
- 버그 수정
일부 게이트웨이 뒤에서 effort-2025-11-24 베타 값이나 대화 중 시스템 메시지 때문에 요청이 실패하던 문제를 해당 값 없이 재시도하도록 고쳤습니다.
Requests behind some gateways no longer fail on the effort-2025-11-24 beta value or mid-conversation system messages; they are retried without them.
- 버그 수정
cleanupPeriodDays가 매우 클 때 붙여넣은 이미지 같은 최근 파일이 정리 작업에 지워지던 문제를 고쳤습니다.
Background cleanup no longer deletes some recent files, such as pasted images, when cleanupPeriodDays is very large.
- 버그 수정
'Prompt is too long' 이후 압축이 밀도가 낮은 텍스트를 남겨 다음 요청이 다시 실패할 가능성을 줄였습니다.
Compaction after 'Prompt is too long' keeps less dense text, so the next request is less likely to fail again.
- 보안/권한
파일 읽기 권한 프롬프트에 심볼릭 링크가 가리키는 위치가 표시됩니다.
File read permission prompts now show where a symbolic link leads.
- 개선/변경
비대화형 세션에서 MCP elicitation 응답이 없을 때, 응답이 오지 않았으니 같은 호출을 반복하지 말라고 Claude에게 알립니다.
An unanswered MCP elicitation timeout in non-interactive sessions tells Claude no answer came and not to repeat the call.
- 개선/변경
Linux /sandbox 경고가 Ubuntu AppArmor의 사용자 네임스페이스 제한과 해제 방법을 알려 줍니다.
The Linux /sandbox warning names Ubuntu's AppArmor restriction on user namespaces and how to lift it.
- IDE/클라우드/통합
- 보안/권한
macOS·Linux 샌드박스 Bash 명령이 매 명령 전에 샌드박스 밖에서 셸 시작 파일을 실행하지 않습니다.
Sandboxed Bash commands on macOS and Linux no longer run shell startup files outside the sandbox before each command.
- 보안/권한
샌드박스 명령과 자동 수락된 편집이 --mcp-config로 전달된 MCP 설정 파일을 수정할 수 없습니다.
Sandboxed commands and auto-accepted edits can no longer modify the MCP config file passed with --mcp-config.
- 보안/권한
bypass 모드(데스크톱·VS Code)에서 위험한 rm/rmdir 프롬프트가 이제 명령을 즉시 거부하고 재작성 힌트를 줍니다.
The dangerous rm/rmdir prompt in bypass mode (Desktop and VS Code) now denies the command at once with a rewrite hint.
- 보안/권한
claude ultrareview는 워크스페이스 신뢰가 필요하며, 스크립트는 --trust-workspace 또는 재정의 변수를 써야 합니다.
claude ultrareview requires workspace trust, and scripts must pass --trust-workspace or set an override variable.
- 보안/권한
샌드박스가 켜져 있지만 실행할 수 없을 때, 샌드박스에서 제외된 명령은 쓰기 허용 경로에 쓰기 전에 확인을 요청합니다.
Commands excluded from the sandbox ask before writing to write-list paths when the sandbox is enabled but cannot run.
- 보안/권한
워크트리 생성 시 git이 필요에 따라 객체를 가져오지 못하게 했습니다.
Worktree creation no longer lets git fetch objects on demand.
- 훅/SDK/플러그인/Mods
/claude-api가 Managed Agents 서브에이전트 팀을 multiagent_20261001 기반으로 만들고 동적 워크플로가 기본으로 켜집니다.
/claude-api builds Managed Agents subagent teams on multiagent_20261001 with dynamic workflows on by default.
- 버그 수정
Windows에서 Git for Windows가 없을 때 PreToolUse와 PermissionRequest 훅이 실패해도 통과(fail open)하던 문제를 고쳤습니다.
On Windows, PreToolUse and PermissionRequest hooks no longer fail open when Git for Windows is missing.
- 보안/권한
- 버그 수정
버그 수정과 안정성 개선(세부 항목 없음).
Bug fixes and reliability improvements
- 버그 수정
- 훅/SDK/플러그인/Mods
/claude-api api-version으로 Claude API 코드를 API 버전 2026-10-21로 옮깁니다.
/claude-api api-version moves Claude API code to API version 2026-10-21.
- 훅/SDK/플러그인/Mods
권한 규칙, 자동 모드, 안전 검사, 훅, 샌드박스가 도구 호출을 멈추거나 되돌릴 때마다 claude_code.safety_event OpenTelemetry 이벤트를 내보냅니다(이후 2.1.312에서 전송 중단).
A claude_code.safety_event OpenTelemetry event is emitted for each tool call that a permission rule, auto mode, safety check, hook, or sandbox stops, prompts, or sends back.
- 보안/권한
settings env 블록의 axScreenReader와 CLAUDE_AX_SCREEN_READER는 사용자, 관리, --settings 설정에서만 적용됩니다.
axScreenReader and CLAUDE_AX_SCREEN_READER in a settings env block apply only from user, managed, or --settings settings.
- IDE/클라우드/통합
self-hosted runner 체크아웃 훅이 기본 30분 후 중단되며 --checkout-hook-timeout-min으로 조정할 수 있습니다.
Self-hosted runner checkout hooks stop after 30 minutes by default unless --checkout-hook-timeout-min is raised or set to 0.
- 버그 수정
CLAUDE_CODE_DISABLE_1M_CONTEXT 설정 시 [1m] 접미사 별칭 모델에서 model-not-found로 실패하던 문제를 고쳤습니다.
Requests no longer fail with model-not-found when CLAUDE_CODE_DISABLE_1M_CONTEXT is set and the model is an alias with the [1m] suffix.
- 버그 수정
연결이 호출 도중 닫혀도 HTTP MCP 도구 호출이 두 번 전송되지 않으며, 읽기 전용·멱등 도구만 재시도합니다.
HTTP MCP tool calls are no longer sent twice when a connection closes mid-call; only read-only or idempotent tools retry.
- 버그 수정
API 응답이 5초를 넘어도 Agent SDK setModel() 전환이 거부되지 않으며 대기 시간이 최대 15초로 늘었습니다.
Agent SDK setModel() switches are no longer refused when the API takes over 5 seconds; the wait is now up to 15 seconds.
- 개선/변경
해석할 수 없는 도구 호출에서 최대 두 번 재시도한 뒤 오류로 턴을 끝냅니다.
Recovery from unparseable tool calls retries up to twice before ending the turn with an error.
- 훅/SDK/플러그인/Mods
- 버그 수정
세션 환경 변수 없이 시작해도 클라우드 세션 안의 claude -p가 'Not logged in'을 보고하지 않습니다.
claude -p inside cloud sessions no longer reports 'Not logged in' when started without the session's environment variables.
- 버그 수정
MCP 도구가 많은 세션에서 API 오류가 'prompt is too long'으로 바뀌거나 불필요한 압축이 일어나던 문제를 고쳤습니다.
An API error is no longer replaced by 'prompt is too long,' and unneeded compaction no longer happens in sessions with many MCP tools.
- 버그 수정
- 보안/권한
sandbox.allowNestedUserNamespaces로 샌드박스된 Linux 명령이 사용자 네임스페이스를 만들 수 있으나, 샌드박스의 파일 보호를 우회할 수 있습니다.
sandbox.allowNestedUserNamespaces lets sandboxed Linux commands create user namespaces, which can bypass the sandbox's file protections.
- 신기능
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS로 무인 재시도 모드가 리셋 전에 풀린 사용량 한도를 감지합니다.
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS makes unattended retry mode notice a usage limit lifted before its reset.
- 게이트웨이/엔터프라이즈
allowedMcpServers가 env에서만 ${VAR}를 쓰는 managed-mcp.json stdio 서버를 더 이상 걸러내지 않습니다.
allowedMcpServers no longer filters managed-mcp.json stdio servers that use ${VAR} only in env.
- 개선/변경
/artifacts 삭제 확인이 1 또는 Enter는 유지, 2는 삭제, Esc는 취소로 바뀌고 y, n은 더 이상 동작하지 않습니다.
/artifacts delete confirmation now uses 1 or Enter to keep, 2 to delete, and Esc to cancel; y and n no longer work.
- 훅/SDK/플러그인/Mods
Mod의 도킹 패널은 터미널 너비의 45% 이내로 유지됩니다.
A mod's docked pane stays within 45% of the terminal's width.
- 버그 수정
엔드포인트나 게이트웨이가 도구 검색을 거부할 때 Vertex, Bedrock 등에서 요청이 실패하던 문제(2.1.304 회귀)를 고쳤습니다.
Requests no longer fail on Vertex, Bedrock, and other providers when an endpoint or gateway rejects tool search (a 2.1.304 regression).
- 버그 수정
/effort와 /autocompact가 modelOverrides 값과 대소문자나 [1m] 태그만 다른 모델명에도 적용됩니다.
/effort and /autocompact now apply when the model name differs from a modelOverrides value only by letter case or a [1m] tag.
- 버그 수정
서브에이전트가 대체 모델로 전환된 뒤 Claude가 작업한 모델 이름을 잘못 말하던 문제를 고쳤습니다.
Claude no longer names the wrong model for a subagent's work after the subagent switches to a fallback model.
- 개선/변경
로고 위에 출력되던 시작 경고가 디버그 로그로 옮겨졌습니다.
Startup warnings that printed above the logo now go to the debug log.
- 보안/권한
- 훅/SDK/플러그인/Mods
Mod의 settings.read 훅이 각 설정 계층을 받아 병합된 설정을 다시 쓸 수 있습니다.
Mods' settings.read hooks now receive each settings layer and can rewrite the merged settings.
- 개선/변경
/artifacts 삭제 확인이 번호 선택 방식으로 바뀌었습니다.
The /artifacts delete confirmation now uses numbered choices.
- 개선/변경
사용자 지정 ANTHROPIC_BASE_URL 뒤에서도 도구 검색이 기본으로 켜지며, 400 또는 422 응답 시 도구 검색 없이 재시도합니다.
Tool search is on by default behind a custom ANTHROPIC_BASE_URL, and 400 or 422 responses are retried without it.
- 개선/변경
압축 시 스킬 목록을 다시 보내고, /reload-skills는 새로 추가되거나 바뀐 스킬만 보냅니다.
Compaction resends the skill list, and /reload-skills sends only new or changed skills.
- IDE/클라우드/통합
VS Code에서 백그라운드 서브에이전트가 하나의 상태 줄로 표시됩니다.
Background sub-agents in VS Code show as a single status line.
- 신기능
Code Review에 Quick, Standard, Deep 검토 수준이 추가되었습니다.
Code Review gained Quick, Standard, and Deep review levels.
- IDE/클라우드/통합
Code Review가 이후 추가되는 저장소를 포함해 GitHub 조직의 모든 저장소를 검토할 수 있습니다.
Code Review can review every repository in a GitHub organization, including ones added later.
- 훅/SDK/플러그인/Mods
- 버그 수정
버그 수정과 안정성 개선(세부 항목 없음).
Bug fixes and reliability improvements
- 버그 수정
- 모델/추론
CLAUDE_CODE_AUTO_MODE_MODEL로 클라이언트 측 자동 모드 분류기가 쓸 모델을 고릅니다.
CLAUDE_CODE_AUTO_MODE_MODEL selects the model for the client-side auto mode classifier.
- 신기능
/config에 유휴 압축을 켜고 끄는 Idle compaction 항목이 생겼습니다.
An Idle compaction row in /config turns idle compaction on or off.
- 훅/SDK/플러그인/Mods
claude -p, Agent SDK, 데스크톱 앱, VS Code에서 포크 서브에이전트가 기본으로 켜집니다.
Fork subagents are on by default in claude -p, the Agent SDK, the desktop app, and VS Code.
- IDE/클라우드/통합
데스크톱 앱과 VS Code는 메인 대화의 서브에이전트를 항상 백그라운드에서 실행합니다.
The desktop app and VS Code always run the main conversation's subagents in the background.
- 훅/SDK/플러그인/Mods
프롬프트·에이전트 훅은 이벤트당 동시에 최대 12개까지 실행됩니다.
Prompt and agent hooks run at most 12 at a time per event.
- 버그 수정
Read 도구가 너무 큰 이미지를 통째로 메모리에 올리지 않으며 128MB를 넘는 원본은 거부합니다.
The Read tool no longer loads oversized images entirely into memory; sources over 128 MB are refused.
- 모델/추론
- 신기능
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS로 리셋이 먼 사용량 한도에서 무인 재시도를 끝냅니다.
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS ends unattended retries at usage limits that reset far away.
- 훅/SDK/플러그인/Mods
OpenTelemetry tool_decision 이벤트에 classifier_verdict와 permission_mode가 포함됩니다.
classifier_verdict and permission_mode appear in OpenTelemetry tool_decision events.
- 신기능
vim 모드에서 % 모션을 지원합니다.
Added % motion in vim mode.
- 훅/SDK/플러그인/Mods
Mod의 .catch 핸들러는 훅이 예외를 던지거나 시간 초과될 때만 실행됩니다.
A mod's .catch handler runs only when the hook throws or times out.
- 개선/변경
더 작은 컨텍스트 창의 모델로 전환할 때 먼저 이전 모델로 요약합니다.
Switching to a model with a smaller context window summarizes with the previous model first.
- 버그 수정
Read 도구가 .xlsm 같은 바이너리 파일을 텍스트로 읽지 않습니다.
The Read tool no longer reads binary files such as .xlsm as text.
- 신기능
- IDE/클라우드/통합
Claude Platform on AWS에서 /advisor를 사용할 수 있습니다.
/advisor is available on Claude Platform on AWS.
- 훅/SDK/플러그인/Mods
OpenTelemetry api_request 이벤트에 cache_creation_5m_tokens와 cache_creation_1h_tokens가 추가되었습니다.
cache_creation_5m_tokens and cache_creation_1h_tokens appear in the OpenTelemetry api_request event.
- 훅/SDK/플러그인/Mods
$.ui.view({ agentId })로 에이전트의 대화 기록을 메인 화면에 보여 줍니다.
$.ui.view({ agentId }) shows an agent's transcript in the main view.
- 개선/변경
api.anthropic.com으로 가는 큰 요청은 텔레메트리를 꺼도 gzip을 사용합니다.
Large requests to api.anthropic.com use gzip even when telemetry is disabled.
- 개선/변경
종료 시 정지 요청 후 1.5초가 지나도 남은 백그라운드 명령을 강제 종료합니다.
Exit force-kills background commands still running 1.5 seconds after being asked to stop.
- 개선/변경
로컬 대화 기록에 각 API 요청의 시스템 프롬프트, 도구, 파라미터도 함께 저장됩니다.
Local transcripts also record each API request's system prompt, tools, and parameters.
- IDE/클라우드/통합
- 신기능
터미널에서 약 54분 방치된 200K 토큰 초과 대화를 자동으로 압축하는 유휴 압축이 추가되었습니다.
Idle compaction in the terminal compacts conversations over 200K tokens left idle for about 54 minutes.
- 신기능
CLAUDE_CODE_DISABLE_FILE_MENTIONS를 켜면 @ 멘션의 내용 대신 경로만 Claude에게 전달됩니다.
CLAUDE_CODE_DISABLE_FILE_MENTIONS gives Claude the paths of @ mentions instead of their contents.
- 신기능
에이전트 뷰에서 /effort와 /fast를 사용할 수 있습니다.
/effort and /fast work in agent view.
- 훅/SDK/플러그인/Mods
한 출처의 스킬은 세션당 최대 1,024개의 훅만 등록할 수 있습니다.
Skills from one source can register at most 1,024 hooks per session.
- 보안/권한
MCP 허용 규칙은 이름을 지정한 서버에만 적용됩니다.
MCP allow rules reach only the server they name.
- IDE/클라우드/통합
클라우드와 Remote Control MCP 커넥터가 기본으로 프로토콜 버전 2026-07-28을 협상합니다.
Cloud and Remote Control MCP connectors negotiate protocol version 2026-07-28 by default.
- 신기능
- 게이트웨이/엔터프라이즈
Claude apps 게이트웨이 managed.policies[]에 code 키가 추가되었습니다.
A code key in the Claude apps gateway's managed.policies[].
- 훅/SDK/플러그인/Mods
서브에이전트 frontmatter와 --agents 정의에서 autoCompactWindow를 지정할 수 있습니다.
autoCompactWindow in subagent frontmatter and --agents definitions.
- 모델/추론
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL로 모든 워크플로 에이전트를 하나의 모델로 실행합니다.
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL runs all workflow agents on one model.
- 신기능
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS로 529 재시도의 최대 백오프를 더 길게 설정합니다.
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS sets a longer backoff for 529 retries.
- 신기능
Read 도구에 allow_large 옵션이 생겨 큰 텍스트 파일을 한 번에 읽을 수 있습니다.
An allow_large option lets the Read tool read large text files in one call.
- 개선/변경
MCP 도구 설명의 기본 길이 제한이 2,048자에서 4,096자로 늘었습니다.
The default limit on MCP tool descriptions rose from 2,048 to 4,096 characters.
- 모델/추론
Sonnet 5.5 캐시 읽기 가격이 100만 토큰당 $0.20에서 $0.10으로 내려갔습니다.
Sonnet 5.5 cache reads are priced at $0.10 per million tokens, down from $0.20.
- 게이트웨이/엔터프라이즈
- 훅/SDK/플러그인/Mods
명령·HTTP 훅에 onFailure: block을 지원해 훅이 실패하면 동작을 차단합니다.
onFailure: block for command and HTTP hooks blocks the action when the hook fails.
- 신기능
Program Status Protocol(OSC 7501)을 지원해 Claude Code가 작업 중, 대기 중, 완료 상태인지 표시합니다.
Program Status Protocol (OSC 7501) support shows whether Claude Code is working, waiting, or done.
- 게이트웨이/엔터프라이즈
게이트웨이 업스트림마다 models 목록을 두어 그 업스트림으로 보낼 모델을 제한할 수 있습니다.
An optional models list on each Claude apps gateway upstream limits which models are sent there.
- 신기능
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS로 무인 재시도 모드가 429, 529 오류를 기다리는 최대 시간을 제한합니다.
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS limits how long unattended retry mode waits out 429 and 529 errors.
- 개선/변경
서브에이전트는 skills 필드에서 최대 32개 스킬만 미리 불러옵니다.
Subagents preload at most 32 skills from the skills field.
- 개선/변경
16 MiB를 넘는 WebSocket MCP 메시지는 연결을 닫습니다.
WebSocket MCP messages over 16 MiB close the connection.
- 게이트웨이/엔터프라이즈
Claude Tag 관리 설정에서 채널 관리자를 Custom roles로 옮기기 전에 확인을 요청합니다.
Added a confirmation in Claude Tag admin settings before a channel manager is moved to Custom roles, which can remove other access.
- 버그 수정
게이트웨이가 context-1m 베타를 거부해도 [1m] 모델 요청이 실패하지 않고 해당 값 없이 다시 보냅니다.
Requests on a [1m] model no longer fail when a gateway refuses the context-1m beta; Claude Code resends without it.
- 버그 수정
백그라운드 작업이 다른 턴을 시작해도 claude -p 텍스트 출력이 이전 응답을 잃지 않습니다.
claude -p text output no longer drops earlier responses when background work starts another turn.
- 버그 수정
Code Review 재검토가 이전 지적 사항이 열려 있는데도 문제 없음으로 보고하던 문제를 고쳤습니다.
Fixed Code Review re-reviews reporting no issues while earlier findings were still open.
- 버그 수정
xhigh, max effort에서 웹 검색과 agent 훅 평가가 훨씬 오래 걸리던 문제를 고쳤습니다.
Fixed web searches and agent hook evaluations taking much longer at xhigh and max effort.
- 훅/SDK/플러그인/Mods
- 버그 수정
지시문으로 작성한 prompt, agent 훅이 막아야 할 동작을 허용하던 문제를 고쳤습니다.
Fixed prompt and agent hooks written as instructions allowing actions they should block.
- 개선/변경
Stop, SubagentStop 프롬프트 훅의 판정을 개선해 Claude가 일찍 멈출 가능성을 줄였습니다.
Improved judging of Stop and SubagentStop prompt hooks so Claude is less likely to stop early.
- 버그 수정
- 모델/추론
Claude Haiku 5.5가 추가되어 1M 컨텍스트와 함께 Anthropic API의 기본 Haiku 모델이 되었습니다.
Added Claude Haiku 5.5, now the default Haiku model on the Anthropic API, with 1M context.
- 훅/SDK/플러그인/Mods
subagentStatusLine 페이로드에 agentType이 추가되어 스크립트가 사용자 정의 서브에이전트 유형을 구분할 수 있습니다.
Added agentType to the subagentStatusLine payload so scripts can tell custom subagent types apart.
- 훅/SDK/플러그인/Mods
$.tool.register에 isDeferred가 추가되어 Mod가 도구 스키마를 미리 나열할 수 있습니다.
Added isDeferred to $.tool.register so mods can list a tool's schema up front.
- 버그 수정
Claude가 압축 이전의 자기 행동을 이미 끝난 것으로 보고 작업을 철회하거나 다시 하던 문제를 고쳤습니다.
Fixed Claude treating its own pre-compaction actions as finished, then retracting or redoing that work.
- 버그 수정
HTTP MCP 연결이 닫힐 때까지 모든 요청을 보관하던 메모리 누수를 고쳤습니다.
Fixed a memory leak where an HTTP MCP connection kept every request until it closed.
- 버그 수정
← 키로 세션을 백그라운드로 보낼 때 대기 중 메시지가 사라지던 문제를 고쳤습니다.
Fixed a queued message being lost when the left arrow moved the session to the background.
- 버그 수정
/model의 effort가 범위 끝을 넘어 순환해 Low가 모델 기본값으로 저장될 수 있던 문제를 고쳤습니다.
Fixed /model effort wrapping past the ends of its range, which could save Low as a model's default.
- 모델/추론
- 훅/SDK/플러그인/Mods
claude plugin install에 --marketplace <source> 옵션이 추가되어 마켓플레이스 등록과 설치를 한 번에 합니다.
Added --marketplace <source> to claude plugin install, which adds the marketplace if needed and installs from it.
- 모델/추론
Agent 도구에 effort 파라미터가 추가되어 서브에이전트를 요청한 effort로 실행합니다.
Added an effort parameter to the Agent tool so sub-agents can run at a requested effort level.
- 신기능
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS로 과부하(529) 재시도의 백오프 기준을 더 길게 설정합니다.
Added CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS to set a longer backoff base for overloaded (529) retries.
- 훅/SDK/플러그인/Mods
prompt.autocomplete로 Mod가 프롬프트 자동완성 목록에 자체 항목을 추가할 수 있습니다.
Added prompt.autocomplete, letting mods add their own rows to the prompt autocomplete list.
- 훅/SDK/플러그인/Mods
Mod용 $.model.complete에 프롬프트 캐싱이 추가되었습니다.
Added prompt caching to $.model.complete for mods.
- 개선/변경
로컬 stdio MCP 서버가 기본으로 프로토콜 버전 2026-07-28을 협상하며 MCP_PROTOCOL_NEGOTIATION=legacy로 되돌릴 수 있습니다.
Changed local stdio MCP servers to negotiate protocol version 2026-07-28 by default, with MCP_PROTOCOL_NEGOTIATION=legacy to opt out.
- 개선/변경
에이전트 이름이 최대 256자로 제한되며 더 긴 이름은 거부됩니다.
Changed agent names to a 256-character maximum; longer names are rejected.
- 개선/변경
예약 실행과 Run now 루틴 실행이 승인 없이 본인에게만 보이는 아티팩트를 게시합니다.
Changed scheduled and Run now routine runs to publish artifacts only you can see without asking for approval.
- 훅/SDK/플러그인/Mods
- 버그 수정
클라우드 세션에서 권한 프롬프트 응답이 사라질 수 있던 2.1.290 회귀를 고쳤습니다.
Fixed a 2.1.290 regression where cloud sessions could drop answers to permission prompts.
- 버그 수정
종료할 때 세션의 마지막 메시지가 사라질 수 있던 2.1.288 회귀를 고쳤습니다.
Fixed a 2.1.288 regression where the last messages of a session could be lost when quitting.
- 버그 수정
- 훅/SDK/플러그인/Mods
Mod의 turn.step 훅 결과에 serverToolUses가 추가되었습니다.
Added serverToolUses to the result of a mod's turn.step hook.
- 훅/SDK/플러그인/Mods
tool.check 플러그인 훅 이벤트에 agentId가 추가되어 서브에이전트 검사를 구분할 수 있습니다.
Added agentId to the tool.check plugin hook event so a hook can tell subagent checks apart.
- 신기능
claude attach <name>과 claude logs <name>이 세션 이름의 일부만으로도 동작합니다.
Added claude attach <name> and claude logs <name>, which accept part of a session name.
- 보안/권한
관리 설정 파일이 관리 설정 폴더 밖 파일로의 링크일 때 경고합니다.
Added a warning when a managed settings file is a link to a file outside the managed settings folder.
- 보안/권한
관리 설정이 사용자 샌드박스 allowRead 경로나 허용 도메인을 무시할 때 /status와 doctor가 경고합니다.
Added a /status and doctor warning when managed settings ignore user sandbox allowRead paths or allowed domains.
- 개선/변경
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC가 시작 시 연결 예열도 건너뜁니다.
Changed CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC to also skip the startup connection warm-up.
- 보안/권한
프로젝트 설정 파일로는 Claude in Chrome을 더 이상 켤 수 없습니다.
Changed Claude in Chrome so a project's settings files can no longer turn it on.
- 보안/권한
Bash 도구가 pyright를 실행하기 전에 권한을 요청합니다.
Changed the Bash tool to ask for permission before running pyright.
- 훅/SDK/플러그인/Mods
- 훅/SDK/플러그인/Mods
팀원용 agent.spawn, 플러그인 훅 이벤트 전반의 단일 에이전트 ID, $.agent.list()의 유휴·대기 상태가 추가되었습니다.
Added agent.spawn for teammates, one agent id across plugin hook events, and idle and waiting states in $.agent.list().
- 보안/권한
심볼릭 링크를 통해 @멘션, 변경, IDE에서 선택된 파일에 Read 거부 규칙이 적용되지 않던 문제를 고쳤습니다.
Fixed Read deny rules not applying to files @-mentioned, changed, or selected in the IDE through a symlink.
- 보안/권한
확장된 값을 가진 환경 변수 접두사 뒤의 명령을 Bash deny·ask 규칙이 놓치던 문제를 고쳤습니다.
Fixed Bash deny and ask rules missing a command behind an environment variable prefix with an expanded value.
- 버그 수정
업그레이드 후 첫 세션에서 설치된 Mod가 로드되지 않던 문제를 고쳤습니다.
Fixed installed mods not loading in the first session after an upgrade.
- 버그 수정
로컬 폴더 마켓플레이스에서 설치한 플러그인의 plugin list, eval, update가 오래된 사본을 보여 주던 문제를 고쳤습니다.
Fixed plugin list, plugin eval, and plugin update showing a stale copy of a plugin installed from a local folder marketplace.
- 개선/변경
로그아웃이 잦아질 수 있던 2.1.288의 claude auth status 변경을 되돌렸습니다.
Reverted a 2.1.288 change to claude auth status that may have made sign-outs more frequent.
- 훅/SDK/플러그인/Mods
- 훅/SDK/플러그인/Mods
Mod용 $.ui.selection()이 전체 화면 모드에서 마지막으로 선택한 텍스트를 반환합니다.
Added $.ui.selection() for mods, returning the text you last selected in fullscreen mode.
- IDE/클라우드/통합
GitHub CLI가 없는 이미지의 클라우드 세션에 내장 gh api가 추가되었습니다.
Added a built-in gh api to cloud sessions whose image has no GitHub CLI.
- 신기능
Ctrl+C로 지운 프롬프트를 빈 프롬프트에서 위쪽 화살표로 복구할 수 있습니다.
Added recovery for a prompt cleared with Ctrl+C: pressing Up on the empty prompt brings the draft back.
- 신기능
/code-review에 --max-findings <n>|all 옵션이 추가되었습니다.
Added --max-findings <n>|all to /code-review.
- 신기능
에이전트 뷰에서 Ctrl+F로 세션 이름을 찾고 Alt+위/아래로 그룹 사이를 이동합니다.
Added Ctrl+F to find a session by name and Alt+Up/Down to jump between groups in the agents view.
- 개선/변경
백그라운드 명령 시간 제한이 무인 세션에만 적용됩니다.
Changed the background command time limit to apply only in unattended sessions.
- 모델/추론
자동 모드 분류기가 ANTHROPIC_DEFAULT_SONNET_MODEL의 Sonnet 5.5 또는 Opus 5.5 고정을 무시하고 Sonnet 5를 사용합니다.
Changed the auto mode classifier to ignore Sonnet 5.5 or Opus 5.5 pins in ANTHROPIC_DEFAULT_SONNET_MODEL and use Sonnet 5 instead.
- 개선/변경
/autocompact가 자동 압축 창을 모델별로 저장합니다.
Changed /autocompact to save the auto-compact window per model.
- 개선/변경
claude project purge가 claude purge로 바뀌었고 이전 이름도 안내와 함께 계속 동작합니다.
Changed claude project purge to claude purge; the old name still works and prints a notice.
- 훅/SDK/플러그인/Mods
- 훅/SDK/플러그인/Mods
Claude Mods가 추가되어 플러그인이 더 깊은 동작을 바꿀 수 있습니다.
Added Claude Mods, so plugins can modify deeper behavior.
- 훅/SDK/플러그인/Mods
기본 제공 Mod 'You should know'는 사이드 에이전트가 사용자나 Claude가 놓칠 수 있는 점을 알려 줍니다.
Added 'You should know,' a built-in mod where a side agent flags things you or Claude might miss.
- 신기능
에이전트 뷰에 세션 이름과 작업을 찾는 n:<text> 필터가 추가되었습니다.
Added an n:<text> filter to the agents view that matches session names and tasks.
- 훅/SDK/플러그인/Mods
OpenTelemetry user_prompt 이벤트에 prompt_text가 추가되었습니다.
Added prompt_text to the OpenTelemetry user_prompt event.
- IDE/클라우드/통합
MCP 서버의 URL 프롬프트(2025-11-25 프로토콜, 예: 로그인)를 지원합니다.
Added URL prompts from MCP servers on the 2025-11-25 protocol, such as for sign-in.
- 보안/권한
Windows에서 Bash 도구를 거부하면 PowerShell도 꺼진다는 시작 경고가 추가되었습니다.
Added a Windows startup warning when denying the Bash tool also turns off PowerShell.
- 모델/추론
Bedrock, Vertex, Foundry, Claude apps 게이트웨이에서 Opus 4.7+와 Fable이 기본으로 1M 컨텍스트 창을 사용합니다.
Changed Opus 4.7+ and Fable to use a 1M context window by default on Bedrock, Vertex, Foundry, and the Claude apps gateway.
- 개선/변경
claude agents의 응답이 대기열 메시지로 전달됩니다.
Changed replies from claude agents to arrive as queued messages.
- 개선/변경
alwaysLoad: false인 MCP 서버는 모든 도구를 도구 검색 뒤로 미룹니다.
Changed MCP servers with alwaysLoad: false to defer all their tools behind tool search.
- 훅/SDK/플러그인/Mods
출처와 기준
한국어 요약은 영어 CHANGELOG 항목을 옮겨 요약한 것입니다. 영어 원문은 항목에서 발췌한 문장이며 일부는 축약했을 수 있습니다. 정확한 내용은 CHANGELOG 원문에서 확인해 주세요.
날짜는 npm 레지스트리의 버전별 게시 시각(UTC) 기준이라 한국 시간으로는 하루 뒤 날짜일 수 있습니다. 조사 기간은 2026-10-01 ~ 2026-11-03, 기준일은 입니다.
비중 = 카테고리 항목 수 ÷ 전체 항목 수. 소수점 첫째 자리에서 반올림하므로 합이 100%가 아닐 수 있습니다. 버전당 평균 = 전체 항목 수 ÷ 버전 수.
- Claude Code CHANGELOG (GitHub, 1차 출처)
- npm @anthropic-ai/claude-code (버전별 게시 시각)
- Anthropic News (모델 출시일 확인)
- Hacker News 검색 API (Algolia)
- Hacker News 스레드 페이지 (수치 대조: Haiku 5.5 출시 글)
- GitHub REST API: 저장소 검색
- GitHub REST API: 이슈 검색
커뮤니티 반응의 측정 방법
핵심 변경 8개(highlights)를 대상으로 각 업데이트 공개일부터 2026-11-06까지의 반응을 같은 방법으로 확인했다. (1) 논의: Hacker News 검색 API(Algolia)에서 기능 이름으로 찾은 스레드 중 공개일 이후에 올라온 것의 점수와 댓글 수를 읽고, 스레드 페이지에서 일부를 다시 대조했다. 주제의 대표 스레드는 점수가 가장 큰 스레드이고 반응은 점수와 댓글 수의 합이다. (2) 제작: GitHub 저장소 검색 API에서 기능 이름을 따옴표로 묶어 검색하되 in: 한정자를 쓰지 않아, 저장소 이름·설명·주제에 기능 이름이 들어 있고 공개일 이후에 만들어진 저장소 수를 센다. 기능을 쓴 저장소가 아니라 이름을 언급한 저장소라서 실제 사용 여부는 구분하지 못한다. (3) 같은 지표끼리만 비교한다. 점수·댓글은 Hacker News끼리, 저장소 수는 같은 검색 방식끼리 비교하고 서로 합산하지 않는다. (4) 수치가 0보다 큰 신호가 하나도 없으면 자료 부족으로 둔다. 연결이 불분명한 스레드는 넣지 않고 excluded에 이유와 함께 남겼다. Reddit(조회 도구가 막음), X, 뉴스·블로그 기사 수는 확인하지 못했다.
넣지 않은 스레드
- How the Claude Code team does code review (Hacker News, 점수 488 · 댓글 481 · 2026-10-16) — Code Review를 다루지만 핵심 변경 8개에 들지 않아 넣지 않았다.
- Claude Opus 5.5 (Hacker News, 점수 1,806 · 댓글 1,134 · 2026-09-22) — 2026-09-22 글로 조사 기간 이전이다. 핵심 변경 중에는 Opus 4.8 빠른 모드 폐지 예고의 이전 대상으로만 나온다.
- Backdoor in Claude Code for VS Code extension on the Cursor Marketplace (Hacker News, 점수 1,011 · 댓글 553 · 2026-10-30) — 같은 기간의 큰 스레드이지만 변경 기록의 어느 항목과도 연결된다는 근거를 확인하지 못했다.
- Claude Code regularly sends each background agent's transcript to its model (Hacker News, 점수 590 · 댓글 236 · 2026-10-29) — 변경 기록의 특정 항목과 연결된다는 근거를 확인하지 못했다.