업데이트 내역

2026-10-23 · Claude Code 2.1.308

공식 Changelog의 v2.1.299~v2.1.308과 Commands·CLI reference를 대조했습니다. npm latest·next·stable은 모두 2.1.308입니다. 이번에 확인한 Changelog에는 v2.1.297·298 항목이 없어 해당 버전의 변경을 추정하지 않습니다.

권한 기본값(v2.1.302): third-party provider·telemetry off·fresh install에서 권한 모드를 지정하지 않은 claude -p·Agent SDK는 default로 시작합니다. v2.1.285의 auto 기본값 안내를 대체하며 --permission-mode auto는 계속 명시할 수 있습니다.
스킬·훅(v2.1.299~304): UserPromptSubmit은 스킬·custom command가 확장되기 전에 실행돼 거절 시 embedded shell도 막습니다. 스킬 자체의 같은 훅은 호출 다음 프롬프트부터 실행됩니다. PreToolUse·PermissionRequest의 updatedInput은 도구 입력 검증을 거치며, prompt·agent 훅은 같은 이벤트를 최대 12개씩 실행합니다. 소스별 스킬 훅은 세션당 1,024개·matcher 16,384자 한도입니다.
subagent(v2.1.302): fork subagent가 -p·SDK·Desktop·VS Code에서도 기본 활성화됐습니다(CLAUDE_CODE_FORK_SUBAGENT=0으로 해제, claude mcp serve 제외). 메인 대화의 subagent는 background, 그 subagent의 Agent 호출은 해당 환경에서 기본 foreground입니다.
컨텍스트(v2.1.299·302·304): 200K+ 토큰 대화를 약 54분 유휴 뒤 압축하는 idle compaction과 /config 토글을 반영했습니다. idleCompaction: false로 끄고 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS로 최소 토큰을 조절합니다. Changelog는 두 설정의 지원 버전을 v2.1.290+로 적습니다. compaction 뒤에는 스킬 목록을 다시 보내고 /reload-skills는 새로 생기거나 바뀐 스킬만 보냅니다.
API·Design: /claude-api managed-agents-secure(v2.1.304)는 보안 가이드와 설정을 읽기 전용으로 대조하고, api-version(v2.1.307)은 API 버전 2026-10-21 전환을 돕습니다. 공식 표에 /design consent·/design revoke가 추가됐고 consent는 사용자가 직접 입력합니다. /design-login·/design-sync가 쓰는 독립 claude.ai/design은 2026-12-14까지 종료 예정입니다.
MCP·조직 정책(v2.1.299~307): mcp__a의 allow 규칙이 다른 서버 a__b까지 허용하지 않게 바뀌었습니다. 서버 이름 전체를 써 mcp__<server>__*로 지정합니다. v2.1.305부터 managed-mcp.json stdio 서버가 ${VAR}를 env에만 쓰면 allowedMcpServers 필터 대상이 아니므로 차단은 deniedMcpServers로 명시합니다. v2.1.307은 연결 중단 후 HTTP MCP 재시도를 read-only·idempotent 도구로 제한합니다.
운영·진단: claude remote-control --sandbox·--no-sandbox는 v2.1.300부터 오류이며 sandbox.enabled를 사용합니다. v2.1.307부터 runner checkout hook은 기본 30분 제한(--checkout-hook-timeout-min, 0은 해제), 차단·질문된 도구 호출은 claude_code.safety_event OTel 이벤트로 추적합니다. v2.1.308은 일반 버그 수정·안정성 개선으로만 공지됐습니다.
보안·복구: plan mode의 hook 승인 쓰기 우회, symlink sandbox 경계, third-party gateway key 전달, 중복 도구 실행(v2.1.299), worktree 삭제 확인(v2.1.301·304) 등의 수정도 대조했습니다. sandbox.allowNestedUserNamespaces(v2.1.305)는 파일 보호를 우회할 수 있어 Chromium·rootless podman이 필요한 Linux 환경에서 격리 경계를 검토한 뒤 사용합니다.
Code Review·mods: Code Review 서비스의 @claude review stop(off·pause)은 PR의 always 구독만 종료합니다(v2.1.307). v2.1.304는 mod tool.check에 read-only 표시 e.isReadOnly와 사람의 승인만 받는 decider: "person"을 추가했습니다. 승인창·host callback이 없으면 사유와 함께 거절합니다.

근거: Changelog, Commands, CLI reference, Hooks, Subagents, npm dist-tags.

2026-10-10 최신 변경

Claude Code v2.1.293~v2.1.296(10월 7일~9일)과 Claude Haiku 5.5 모델 문서를 반영했습니다. 2026-10-10 KST npm 기준은 latest/next=2.1.296, stable=2.1.287입니다.

Haiku 5.5 출시(2026-10-07): claude-haiku-5-5가 v2.1.293부터 Anthropic API의 기본 Haiku입니다. 1M context, 128K output, prompt 100,000 token 기준으로 갈리는 단가($0.10/$0.50, 초과 $0.50/$2.50), Claude Code 기본 effort medium, 끌 수 없는 thinking을 setup·context·vibe-coding에 반영했습니다.
Sonnet 5.5 cache read: setup의 Sonnet 5.5 cache read 단가를 $0.10/MTok로 바로잡았습니다. v2.1.296부터 /cost·status line·--max-budget-usd·SDK 비용 수치도 이 값으로 계산합니다(이전 $0.20).
hooks: command·HTTP hook의 onFailure: "block"(v2.1.295)과 Stop·SubagentStop prompt hook의 판정 개선(v2.1.294)을 추가했습니다.
subagents: skills preload 상한 32개(v2.1.295), frontmatter autoCompactWindow(v2.1.296), subagentStatusLine의 agentType(v2.1.293)을 추가했습니다.
mcp·headless: MCP description 한도(선로드 4,096자, tool search 16,384자)와 WebSocket 16 MiB 한도를 mcp에, 재시도 환경 변수 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS(v2.1.295)·CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS(v2.1.296)를 headless에 추가했습니다.

근거: 공식 Changelog, Model configuration, Hooks, Subagents, MCP, CLI reference, Claude Haiku 5.5 overview, Pricing, npm dist-tags.

반영 위치: index, setup, context, vibe-coding, hooks, subagents, mcp, headless, verification의 한·영판(영문판은 vibe-coding 대신 prompting).

이전 변경 (2026-10-07)

Claude Code v2.1.284~v2.1.292(9월 28일~10월 6일)과 Claude Sonnet 5.5 모델 문서를 반영했습니다. 2026-10-07 KST npm 기준은 latest/next=2.1.292, stable=2.1.285입니다.

Sonnet 5.5 출시(2026-09-28): claude-sonnet-5-5가 v2.1.284부터 Anthropic API의 기본 Sonnet입니다. 1M context, 128K output, $2/$ 10 per MTok(cache read $0.20), Claude Code 기본 effort medium, 분류기 fallback(사이버보안 → Sonnet 5, 생물학 → 거절)을 반영했습니다.
권한 기본값: 대화형 터미널·VS Code 세션의 auto mode 기본 시작이 모든 플랜·provider로 넓어졌고(v2.1.284), third-party·telemetry off 환경의 claude -p·Python Agent SDK도 같아졌습니다(v2.1.285). headless에서 CI에 --permission-mode를 명시하라는 기준에 이 변경을 더했습니다.
Ultracode·effort: Ultracode가 effort와 별개의 토글이 된 점(v2.1.284)을 setup·vibe-coding에 반영했습니다.
headless: --bare의 MCP·system reminder·background task 범위 변경과 재시도 한도 통합(v2.1.286)을 추가하고, --system-prompt와 -file 형식 병행에 대한 공식 CLI reference 불일치가 해소된 것을 기록했습니다.
운영 변경: managed allowedProviders와 sandbox 설정 보호(v2.1.285), Claude Mods(v2.1.287), stdio MCP protocol 기본 협상(v2.1.292), claude purge 이름 변경(v2.1.288)을 반영했습니다.

근거: 공식 Changelog, Model configuration, Permission modes, MCP, Claude Sonnet 5.5 overview, npm dist-tags.

반영 위치: index, setup, context, vibe-coding, prompting, headless, verification의 한·영판.

이전 변경 (2026-09-26)

Claude Code v2.1.280~v2.1.283(9월 22~25일)과 Claude Opus 5.5 모델 문서를 반영했습니다. 2026-09-26 KST npm 기준은 latest/next=2.1.283, stable=2.1.274입니다.

Opus 5.5 출시(2026-09-22): claude-opus-5-5가 v2.1.280부터 기본 Opus·fast mode 기본 모델이고, Pro·Team Standard를 포함한 대부분 플랜과 Anthropic API·Claude Platform on AWS·Bedrock·Google Cloud Agent Platform의 default가 됐습니다. 1M context, 128K output, $4/$ 20 per MTok(cache read $0.20), 상시 adaptive thinking, 기본 effort `medium`, fast mode$ 8/$40, 분류기 fallback(생물학 → Opus 5, 사이버보안 → Opus 4.8)을 반영했습니다.
effort 기준 변경: user settings의 최상위 effortLevel이 Opus 5.5에 적용되지 않는다는 점과 모델별 저장 방법을 setup·vibe-coding·prompting에 추가했습니다.
Messages API 차이: forced tool_choice 400, thinking 비활성화·고정 budget 400, 모델·대화에 묶인 thinking block, Claude API·Google Cloud의 computer_20251124 거부를 정리했습니다.
릴리스 보류: v2.1.283의 managed deniedModels·availableModelsMatch: "exact"와 requiredMinimumVersion 병행 기준을 추가했습니다.
운영 변경: third-party·telemetry off 환경의 auto mode 기본 시작(v2.1.283), server-side auto mode classifier 기본화와 project/local OTel 변수 무시(v2.1.282), 위험한 rm 확인창 2분 제한·"attribution": false·AGENTS.md provider 확대·--agents 파일 경로(v2.1.281), /doctor prompt-audit·--system-prompt 형식 병행(v2.1.283)을 반영했습니다.

근거: 공식 Changelog, Model configuration, Fast mode, Claude Opus 5.5 overview, What's new in Claude Opus 5.5, npm dist-tags.

반영 위치: index, setup, context, vibe-coding, prompting, subagents, headless, verification의 한·영판(headless는 한국어판만 해당).

이전 변경 (2026-09-12)

Claude Code v2.1.263~v2.1.269(9월 6~11일)을 반영했습니다. 2026-09-12 KST npm 기준은 latest/next=2.1.269, stable=2.1.236입니다. 최신 기능 검증과 팀의 stable 채널 선택을 구분하세요.

플러그인: claude plugin eval은 JSON·HTML 평가 보고서를 만들고, install·uninstall·update·enable·disable은 --json을 지원합니다. --plugin-dir에는 여러 plugin의 상위 폴더도 지정할 수 있습니다.
명령·설정: /output-style [name]이 Remote Control·cloud·headless에도 적용됩니다. maxEffortLevel은 전체 또는 modelSettings의 모델별 effort 상한을 정합니다. bashEditDiffEnabled로 Bash 파일 편집 diff를 결과에 표시할 수 있습니다.
복구·호환성: 2.1.266은 gateway 강제 로그인 회귀, 2.1.268은 2.1.265 이후 Anthropic 호환 endpoint의 HTTP 400을 수정합니다. /goal은 API·네트워크·사용량 한도 오류 뒤 backoff 재시도 또는 이유를 밝힌 일시정지로 처리됩니다.
권한·운영: symlink 경로의 deny/ask, Bash tee의 쓰기 경계, MCP·plugin 오류의 비밀값 노출이 수정됐습니다. WebFetch는 기본 300초 deadline을 갖고, /ultrareview --post는 결과 도착 시 PR 댓글을 바로 게시합니다.

근거: 공식 Changelog, npm dist-tags.

반영 위치: index, setup, verification, 관련 명령·운영 챕터의 한·영판. 아래 기록은 이전 검증 시점의 이력입니다.

이 문서는 핸드북 내용 업데이트와 **근거(공식 Changelog/릴리스)**를 추적합니다. “제품 변화 → 핸드북 반영”의 연결성을 유지하기 위한 운영용 기록입니다.

최종 업데이트

2026년 10월 23일 재검증 기준 (v2.1.308)

운영 원칙

근거 기반 반영: GitHub Changelog/릴리스 확인 후 문서 업데이트
영향 범위 명시: 어떤 챕터에 어떤 변화를 반영했는지 기록
신규 기능 우선: 기능 추가/워크플로우 변화/운영 영향이 큰 항목부터 반영

최근 업데이트

2026-09-05 (v2.1.252~v2.1.261 + Fable 5.1)

최신 기준 상향 (v2.1.261): 공식 Changelog v2.1.252~261과 npm dist-tag(latest/next=2.1.261, stable=2.1.236), Model configuration, Fast mode, Claude Fable 5.1 overview·What's new·migration guide, Anthropic 발표를 교차 확인
Fable 5.1 출시(2026-09-01): claude-fable-5-1이 v2.1.257부터 기본 Fable 모델(요구 버전 v2.1.255+). fable·best alias 해석 변경, Fable 5의 /model claude-fable-5 선택 경로, gateway 세션의 Fable 5 유지, availableModels prefix 동작, cache read $0.25/MTok, 30일 보존·ZDR 조건, 지식 기준일·은퇴 기준을 반영
분류기 fallback 표: Fable 5.1·5 생물학 → Opus 5, 사이버보안 → Opus 4.8, Opus 5 사이버보안 → Opus 4.8, 생물학 → 거절. switchModelsOnFlag: false, third-party ANTHROPIC_DEFAULT_OPUS_MODEL 조건 추가
Fable 5.1 API 차이: forced tool_choice 400, thinking block 모델 귀속, 이전 턴 편집 시 무효화(2026-08-31 이후 계정 강제)를 breaking change로, per-message effort·turn-scoped system message·display: "updates"·content provenance를 additive로 정리. Mythos 5.1 접근 조건 구분
effort·1M 운영: Opus 5·Fable 5.1은 default effort hold 없음, v2.1.257 /effort s·--effort hold 세션 한정, v2.1.260 Fable 5.1 effort 변경 시 cache 유지, Opus·Fable 1M auto-compact 시점 변경, model: fable [1m] 태그 수정, CLAUDE_CODE_SUBAGENT_MODEL_FORCE를 반영
반영한 챕터: index, setup, context, subagents, vibe-coding, verification와 Command Master 한·영판(/model·/effort·/fast·index·overview·verification·updates)

2026-08-28 (v2.1.239~v2.1.247)

사용량·조직 설정: /usage loop별 통계, v2.1.242+ modelPicker·prompt-cache TTL의 scope/허용값, Changelog-only modelPricing, /permissions Auto 모드 탭을 구분해 반영
에이전트·자동화: /tasks model·effort 표시, maxTurns 부분 결과와 기존 에이전트 ID/이름 기반 재개, 첫 호출 404 fallback chain, -p·SDK·cloud auto-continue를 반영
명령·피드백: /claude-api upgrade, Commands signature보다 앞선 release-tracked cost-optimize, Admin API 확장, SendFeedback 초안과 feedbackDrafts=notify|quiet|off를 반영
컨텍스트·보안: Sonnet 5 1M auto-compaction을 약 967k로 상향하고 Bash wildcard 경고, marketplace hardening, third-party gateway 자격증명 격리를 반영
반영한 챕터: index, setup, subagents, headless, context, verification와 Command Master 한·영판

2026-08-20 (v2.1.221~v2.1.237)

세션·에이전트: interactive fork mode와 background subagent spawn 기본화, cross-session messaging·세션 @ 멘션, 세션 누적 200개 제한 제거, /code-review high/xhigh/max background 실행을 반영
배포·자동화: claude self-hosted-runner, claude remote-control --continue, GitLab MR/worktree/agent, plugin command source와 archive+SHA pinning, server-supplied hook을 추가
모델·도구·출력: ANTHROPIC_DEFAULT_MODEL, 최신 모델의 legacy Task/Todo 도구 기본 비활성화와 호환 플래그, Concise output style, gateway/custom base URL prompt caching 수정을 반영
보안·안정성: worktree/symlink, sandbox credential masking, trust prompt, MCP OAuth, cross-session ingress, Remote Control, 위험 git 플래그 승인과 설정 무결성 수정을 반영
반영한 챕터: index, setup, multi-session, subagents, headless, skills-commands, verification와 Command Master 한·영판

2026-08-03 (명령 변경 여부 재검증)

공식 Changelog 최신 항목이 v2.1.220이고 npm·로컬 CLI도 latest=2.1.220, stable=2.1.212, next=2.1.220임을 재확인
2026-08-01 이후 신규 정식 릴리스나 명령 추가·삭제·이름 변경이 없어 기능 본문은 유지
index.mdx와 verification.mdx, Claude Code Command Master 한·영판의 기준일과 무변경 판정을 동기화

2026-08-01

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.220): npm latest=2.1.220, stable=2.1.212, next=2.1.220 교차 확인
Opus 5 (v2.1.219): 기본 Opus 경로, native 1M context, fast mode, provider별 opus alias와 full model pinning 기준 갱신
세션·서브에이전트 제어 (v2.1.212~v2.1.219): /fork background session과 /subtask 분리, 세션당 200개·동시 20개 상한, 기본 3단계 중첩, --max-budget-usd의 background subagent 중단 반영
보안·격리: sandbox.network.strictAllowlist, sandbox.filesystem.disabled, worktree/symlink/permission parser 보강, untrusted agent hook 차단 반영
자동화·headless: DirectoryAdded, mcp_server_errors, --forward-subagent-text의 nested subagent 전달, workflow size 기본 medium(15 agents 미만), /code-review background 실행과 /verify·/code-review 수동 호출 전용화 반영

반영한 챕터

index.mdx·setup.mdx — 버전/모델/provider/fast mode 기준 갱신
multi-session.mdx·subagents.mdx — /fork//subtask, spawn·concurrency·depth 예산 반영
hooks.mdx·headless.mdx·skills-commands.mdx — 신규 hook, init 오류, nested forwarding, workflow/skill 실행 규칙 반영
verification.mdx와 Claude Code Command Master 한·영판 동기화

2026-07-10

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.205): 공식 Changelog와 npm dist-tag 교차 확인. npm latest=2.1.205, stable=2.1.197, next=2.1.206이며, 공개 변경 로그가 없는 next는 본문 기준에서 제외
v2.1.202: /config에 advisory 방식의 Dynamic workflow size 추가, workflow agent telemetry에 workflow.run_id·workflow.name 추가, /review는 빠른 단일 패스로 복귀하고 멀티에이전트 심화 리뷰는 /code-review <level> <PR>로 분리
v2.1.203: 로그인 만료 사전 경고, 추가 working directory의 MCP roots/list 반영, Agent View·background session·worktree·Remote Control 안정성 대폭 보강, workflow 진행 화면 개선
v2.1.204: headless SessionStart hook 중 hook event가 스트리밍되지 않아 remote worker가 idle 종료되던 문제 수정
v2.1.205: Auto 모드가 transcript 파일 변조를 차단하고 해석할 수 없는 변수 대상 rm -rf 실행 전 질문, --json-schema invalid schema/format 처리 수정, /doctor를 진단·수정 가능한 전체 setup checkup으로 확장하고 /checkup 별칭 추가, Agent View·Remote Control 상태 및 updater 메모리 개선

반영한 챕터

index.mdx·setup.mdx — 기준일과 npm 채널을 v2.1.205/latest, v2.1.197/stable로 갱신
multi-session.mdx·mcp.mdx — Agent View/background 안정화와 MCP roots 확장 반영
skills-commands.mdx — Dynamic workflow size·OTel 속성 반영
headless.mdx — --json-schema 검증과 headless SessionStart hook 스트리밍 수정 반영
Command Master의 /workflows·/review·/doctor 및 영어 요약 페이지를 같은 기준으로 동기화
verification.mdx — v2.1.202~205 및 npm dist-tag 검증 행 추가

2026-07-04

반영한 공식 변경(요약)

Fable 5 재배포: Fable 5·Mythos 5는 2026-06-09 GA 출시 후 2026-06-12 미국 수출통제로 전 사용자 접근이 약 19일간 중단됐다가, 6-30 통제 해제로 2026-07-01 Claude Platform·Claude.ai·Claude Code·Cowork에 전역 복원됨. 재배포 시 보고된 취약점 탐지 행위를 겨냥한 개선된 안전 분류기가 적용됨
Fable 5 플랜 사용: Pro·Max·Team·일부 Enterprise는 2026-07-07까지 주간 사용 한도의 최대 50%까지 Fable 5를 포함하고 이후 usage credits로 사용. Mythos 5(안전 분류기 없음)는 Project Glasswing(미국 핵심인프라 방어) 초대 전용
최신 기준 상향 (v2.1.201): 공식 Changelog와 npm dist-tag 교차 확인. npm latest는 2.1.201, stable은 2.1.185
v2.1.198: 서브에이전트가 기본적으로 백그라운드에서 실행, Claude in Chrome GA, /dataviz 스킬 추가
v2.1.199: SSL 오류·스트리밍 응답·서브에이전트 오류 처리 수정
v2.1.200: 기본 permission mode가 Manual로 변경, background session 수정
v2.1.201: Sonnet 5 세션이 mid-conversation system role을 더 이상 사용하지 않음

반영한 챕터

index.mdx — 기준일을 v2.1.201로 갱신하고 v2.1.198~201 운영 변경과 Fable 5 재배포 하이라이트 추가
setup.mdx — npm 기준·sandbox 버전 범위를 v2.1.201로 갱신, Fable 재배포·플랜 사용·Mythos 구분·v2.1.200 기본 permission mode Manual 반영
subagents.mdx·headless.mdx — v2.1.198 서브에이전트 기본 백그라운드 실행과 버전 기준 범위 갱신
skills-commands.mdx — /dataviz 신규 스킬과 재검증 기준 갱신
verification.mdx — v2.1.198~201·Fable 재배포 검증 행 추가

2026-07-01

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.197): 공식 Claude Code Changelog와 npm dist-tag를 교차 확인. npm latest/next는 2.1.197, stable은 2.1.185
Sonnet 5 기본화 (v2.1.197): Claude Code의 기본 모델 경로에 Sonnet 5가 들어왔고, Anthropic API sonnet alias와 Pro·Team Standard·Enterprise subscription seat의 default가 Sonnet 5로 해석됨
1M context/effort 정책 갱신: Sonnet 5는 native 1M context를 기본 지원하고 low/medium/high/xhigh/max effort를 지원하며 기본 effort는 high
조직 모델 거버넌스 (v2.1.196): 조직 관리자가 지정한 기본 모델이 /model에서 Org default/Role default로 보이는 흐름을 모델 정책에 반영
운영 안정성 보강 (v2.1.195~v2.1.196): .mcp.json self-approval 보안 보강, background job transcript 보존, Remote mid-turn crash recovery, PowerShell git command exit-code 처리, plugin validate/enable edge case, background agent/permission 안정화 반영

영향 챕터

index.mdx — 기준일과 최신 버전을 v2.1.197로 갱신하고 Sonnet 5 기본화 하이라이트 추가
setup.mdx — npm latest/stable, Anthropic API sonnet alias, default 계정별 모델, opusplan[1m], Sonnet 5 effort/context 기준 갱신
context.mdx — Sonnet 5 native 1M context와 Sonnet 4.6 usage-credit 설명 분리
Command Master 책 — index, overview, /model, /effort, verification, updates를 같은 기준으로 동기화

근거 링크(공식/공개)

2026-06-25

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.190): 공식 Changelog와 npm dist-tag를 교차 확인. npm latest/next는 2.1.190, stable은 2.1.179
보안·샌드박스 보강 (v2.1.181~v2.1.186): sandbox.credentials, destructive command sandbox auto-approval, Windows PowerShell sandbox 수정, Agent deny rules, background session permission prompt 보강
MCP 운영 보강 (v2.1.185~v2.1.187): claude mcp login/logout, CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT, misleading MCP status 수정, idle timeout runbook 반영
모델 제한/경고 (v2.1.184, v2.1.187): main model restriction은 Opus/Sonnet/Haiku/Fable 계열 중심으로 강화, Haiku main model 불가·subagent 허용, deprecated model warning 보강
서브에이전트/Background 안정화 (v2.1.184~v2.1.186): 최대 3단계 agent nesting, nested agent 안정화, background agent worktree/comment/commit edge case 수정
운영 품질 수정 (v2.1.185~v2.1.190): non-interactive fallback 안정화, output schema determinism, Korean paste mojibake fix, 앱/스키마 버그 수정

영향 챕터

index.mdx — 기준일과 최신 버전을 v2.1.190으로 갱신
setup.mdx — latest/stable 채널과 model restriction/deprecation warning 메모 추가
headless.mdx — sandbox credentials, destructive command, non-interactive fallback, MCP idle timeout 반영
mcp.mdx — claude mcp login/logout, idle timeout, status 오해 방지 추가
subagents.mdx — 3단계 nesting, Haiku subagent, background/deny-rule 안정화 추가
skills-commands.mdx — skill/plugin/command 최신 운영 메모 추가
verification.mdx — 공식 문서 교차검증 기준을 2026-06-25로 갱신
Command Master 책 — index, updates, verification, /model, MCP/운영 페이지를 같은 기준으로 동기화

근거 링크(공식/공개)

2026-06-13

반영한 변경(요약)

핸드북 전체 리뷰·최신화 라운드에서 본 핸드북을 점검했습니다. 새로 반영할 공식 제품 변경은 없었고, 콘텐츠 일관성 정리만 수행했습니다.
skills-commands.mdx — Callout 타입 표기를 표준값으로 정규화(비표준 tip → info, 2건). 본문 내용·의미 변화 없음.

영향 챕터

skills-commands.mdx — Callout 타입 정규화
updates.mdx — 본 기록 추가

2026-06-10

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.170): Claude Code에 Claude Fable 5가 추가된 변경을 모델 정책의 최상단 기준으로 반영
Fable 5 운영 기준: /model fable, fable alias, best alias의 Fable 우선 선택, ANTHROPIC_DEFAULT_FABLE_MODEL, 기본 모델이 아니라는 점, ZDR/30일 data retention, adaptive thinking 상시 활성화, DISABLE_PROMPT_CACHING_FABLE을 반영
Fable 자동 fallback: 안전 분류기가 Fable 요청을 사이버보안·생물학 등 민감 영역으로 판단하면 기본 Opus로 자동 재실행되는 흐름과 claude --safe-mode 진단 절차를 추가
Fallback chain (v2.1.166): overload나 availability failure에 대비해 fallbackModel 설정과 --fallback-model 명령 예시를 추가
인접 운영 변경 (v2.1.169, v2.1.246 재검증): /cd가 대화와 prompt cache를 유지하고 대상의 설정·hook·.mcp.json·skill·agent를 즉시 적용하는 점, --safe-mode가 customization을 끄는 범위, bundled skill/workflow 비활성화, self-hosted runner post-session hook을 반영
세션 저장 버그 수정 (v2.1.170): VS Code 통합 터미널 또는 Claude Code 환경변수를 상속한 shell에서 시작한 세션이 transcript를 저장하지 못해 --resume에 나타나지 않던 문제를 headless/CI 기준에 반영
Opus 4.8 기준 유지: Fable을 사용할 수 없거나 비용상 과한 경우의 고성능 Opus 경로는 Opus 4.8로 유지

영향 챕터

index.mdx — 기준일을 v2.1.170과 Fable 5 기준으로 갱신하고, Fable fallback과 best alias를 하이라이트에 추가
setup.mdx — Fable 5, best, alias pinning, ANTHROPIC_DEFAULT_FABLE_MODEL, fallbackModel, 1M context, effort, retention, prompt caching 기준 반영
context.mdx — Fable 5의 1M context 지원, fable[1m]/claude-fable-5[1m] 예시, adaptive thinking 제약 추가
headless.mdx — --safe-mode와 --bare 차이, v2.1.170 transcript persistence fix, self-hosted runner post-session hook 반영
skills-commands.mdx — /advisor, /cd, disableBundledSkills, CLAUDE_CODE_DISABLE_BUNDLED_SKILLS, --disable-slash-commands 반영
subagents.mdx — 서브에이전트 model frontmatter에서 fable alias와 claude-fable-5 full ID를 명시
vibe-coding.mdx — effort 표에서 Fable 5의 high 기본값과 xhigh 지원 반영
verification.mdx — 공식 문서 교차검증 기준을 2026-06-10으로 갱신
Command Master 책 — /model, /advisor, /cd, --safe-mode, fallback 관련 명령 표면을 같은 기준으로 동기화

근거 링크(공식/공개)

2026-05-29

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.154): Claude Code 최신 기준을 v2.1.154로 올리고, 2026-05-28 공개된 Claude Opus 4.8을 모델 정책의 기준으로 반영
Opus 4.8 모델 정책: Anthropic API의 opus alias가 Opus 4.8로 해석되고, Opus 4.8이 high effort 기본값과 /effort xhigh 경로를 갖는다는 점을 모델 선택/검증 섹션에 반영
Provider별 alias 차이: Anthropic API, Claude Platform on AWS, Bedrock/Vertex/Foundry의 opus/sonnet alias 해석 차이를 분리하고, 재현성 작업은 full model name 또는 ANTHROPIC_DEFAULT_*_MODEL pinning을 권장
/model 저장 동작 변경 (v2.1.153): /model <name>과 picker Enter가 사용자 기본 모델로 저장되고, 현재 세션만 바꾸려면 s를 쓰는 흐름을 반영
Fast mode 최신화 (v2.1.154): Opus 4.8 fast mode가 표준 대비 2배 요금/2.5배 속도 경로로 바뀐 점, Opus 4.6 fast override가 legacy가 되는 점 반영
Agent View / background sessions (v2.1.139~v2.1.154): claude agents, /bg//background, claude --bg, claude --bg --exec, Agent View 필터/그룹/작업 격리 기준 반영
Dynamic workflows (v2.1.154): Claude가 workflow를 만들고 다수 agent를 background에서 오케스트레이션하며 /workflows로 진행 상태를 관리하는 흐름 추가
목표 기반 장기 작업 (v2.1.139): /goal 명령과 interactive/headless/Remote Control에서의 완료 조건 기반 작업 흐름 반영
명령 표면 최신화: /usage-credits, /reload-skills, /run, /verify, /run-skill-generator, /code-review, /workflows, /goal, /background를 skills/commands 운영 기준에 반영
운영/보안 보강: Auto mode data exfiltration 탐지 강화, background session worktree isolation 보강, --session-id, --log-level, 자동 업데이트 settings, 비필수 트래픽/터미널 제목 비활성화 env 반영

영향 챕터

index.mdx — 기준일을 v2.1.154와 Opus 4.8 출시 기준으로 갱신하고, 최신 하이라이트 재구성
setup.mdx — Opus 4.8, provider별 alias, /model 저장 동작, effort/fast mode 운영 기준 반영
subagents.mdx — Agent View, background session dispatch, claude --bg --exec, worktree isolation, model/effort 보존 반영
headless.mdx — --session-id, mcp-clients, background sessions, /run·/verify, 운영 환경변수 반영
skills-commands.mdx — /goal, /workflows, /background, /usage-credits, /reload-skills, /run, /verify, /code-review 반영
verification.mdx — 공식 문서 교차검증 기준을 2026-05-29로 갱신
Command Master 책 — 명령 카탈로그와 /model·/agents 상세를 같은 기준으로 동기화

근거 링크(공식/공개)

2026-04-20

반영한 공식 변경(요약)

최신 안정 버전 상향 (v2.1.114): 최신 stable 기준을 v2.1.114로 갱신하고, permission dialog crash fix를 최신 릴리즈로 기록
런처/설치 경로 정리 (v2.1.113): CLI가 플랫폼별 네이티브 Claude Code binary를 실행하도록 바뀐 점을 반영하고, 네이티브 인스톨러/Homebrew/WinGet 우선 원칙을 강화
샌드박스 네트워크 예외 차단 (v2.1.113): sandbox.network.deniedDomains와 allowedDomains 우선순위, 운영 활용 예시 반영
권한 프롬프트/명령 명칭 정리 (v2.1.111~v2.1.113 + 현재 commands docs): /less-permission-prompts를 현재 공식 명칭 /fewer-permission-prompts로 정리하고, cd <current-directory> && git ... no-op 패턴의 prompt 완화 반영
Remote Control / loop / subagent 운영성 보강 (v2.1.113): Remote Control의 /extra-usage, @ 파일 자동완성 질의, /loop wakeup 취소 UX, subagent 10분 stall failover 반영

영향 챕터

index.mdx — 기준일을 v2.1.114로 올리고 최신 운영/보안 하이라이트 추가
setup.mdx — native binary 런처와 sandbox.network.deniedDomains 반영
headless.mdx — Remote Control 보강, /loop wakeup UX, no-op cd && git prompt 완화 반영
subagents.mdx — stalled subagent 10분 failover 반영
skills-commands.mdx — /fewer-permission-prompts 현재 명칭 정리
verification.mdx — v2.1.114, deniedDomains, native launcher, Remote Control 교차검증 추가
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

2026-04-17

반영한 공식 변경(요약)

Opus 4.7 / xhigh / Max Auto mode 경로 정리 (v2.1.111): xhigh effort, /effort 슬라이더, Max 사용자의 Opus 4.7 Auto mode 접근 경로 단순화 반영
신규 명령/스킬 반영 (v2.1.101, v2.1.108, v2.1.110, v2.1.111): /team-onboarding, /recap, /focus, /tui, /less-permission-prompts, /ultrareview
컨텍스트 복귀 UX 보강 (v2.1.108~v2.1.110): session recap 기본화와 /recap 수동 호출 경로 반영
훅/워크트리 운영 보강 (v2.1.105): PreCompact block 지원, EnterWorktree(path) 지원 반영
헤드리스/권한 운영 변경 (v2.1.111): stream-json init plugin_errors, 읽기 전용 glob Bash와 cd <project-dir> && ... 패턴의 권한 프롬프트 완화 반영
스킬 시스템 최신화 (v2.1.105, v2.1.108): Skill tool이 내장 슬래시 명령을 호출할 수 있는 점, 스킬 description listing cap 확대(1,536자) 반영
설치 경로 정리 (v2.1.111 + 최신 setup docs): 네이티브 인스톨러/Homebrew/WinGet 우선, npm deprecated 유지

영향 챕터

index.mdx — 기준일과 하이라이트를 v2.1.112 기준으로 갱신
setup.mdx — 설치 경로, 업데이트 채널, Opus 4.7/xhigh, Auto mode 최신 조건 반영
multi-session.mdx — EnterWorktree(path), scheduled task 복구 반영
hooks.mdx — PreCompact block 패턴 반영
skills-commands.mdx — 신규 명령, Skill tool-내장 명령 연결, description 예산 최신화
context.mdx — /recap, away summary/session recap 반영
headless.mdx — PowerShell 프리뷰 롤아웃, stream-json plugin_errors, 권한 프롬프트 완화 반영
ide.mdx — 이미지 첨부 UX 개선 반영
subagents.mdx — 최신 운영 메모 범위를 v2.1.112까지 확장
verification.mdx — 최신 안정 버전과 교차검증 항목 갱신
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

2026-04-12

반영한 공식 변경(요약)

/agents 실행 가시성 강화 (v2.1.97~v2.1.98): agent type 옆 ● N running 표시, Running/Library 탭, Library의 Run agent / View running instance 액션
/claude-api의 Managed Agents 확장 (v2.1.91, v2.1.97~v2.1.98): Claude API/SDK 예제뿐 아니라 agent design patterns, tool surface, context management, caching strategy, Managed Agents 설계 출발점 반영
권한/상태 전달 안정화 (v2.1.98): --dangerously-skip-permissions에서 team agent가 leader permission mode를 상속하고, 실패한 background subagent도 partial progress를 부모에 보고
격리 실행 안정화 (v2.1.97~v2.1.101): worktree isolation 또는 cwd: override가 부모 Bash 작업 디렉토리를 오염시키지 않도록 수정되고, isolated worktree subagent가 자기 worktree 파일을 Read/Edit 가능하도록 보강
도구 상속/복구 보강 (v2.1.101): 동적으로 주입된 MCP 서버의 도구가 subagent에도 상속되고, --resume 복구 시 무관한 subagent 대화 체인으로 연결되는 문제 수정

영향 챕터

index.mdx — 기준일과 하이라이트를 v2.1.101 기준으로 갱신
subagents.mdx — 최신 운영 메모(권한 전달, partial progress, MCP 상속, worktree 격리 안정화) 추가
skills-commands.mdx — /claude-api 설명을 Managed Agents까지 확장
verification.mdx — 최신 안정 버전과 agent 관련 교차검증 항목 갱신
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

2026-04-08

반영한 공식 변경(요약)

forceRemoteSettingsRefresh 정책 (v2.1.92): 원격 managed settings를 새로 받아오기 전까지 시작 차단, fetch 실패 시 종료하는 fail-closed 동작
Bedrock 로그인 마법사 (v2.1.92): 로그인 화면의 "3rd-party platform" 경로에서 AWS 인증/리전/모델 pinning 안내
/cost 세분화 (v2.1.92): 구독 사용자에게 모델별 사용량과 cache-hit breakdown 제공
/release-notes 인터랙티브 버전 피커 (v2.1.92): 특정 버전 릴리스 노트 탐색 UX 개선
/tag / /vim 제거 (v2.1.92): 각각 세션 태그 명령과 Vim 토글 명령 제거, vim은 /config → Editor mode로 대체
/powerup (v2.1.90): 애니메이션 데모가 포함된 대화형 학습 명령
disableSkillShellExecution (v2.1.91): skills/custom commands/plugin commands의 inline shell 실행 비활성화
플러그인 bin/ 실행 파일 (v2.1.91): Bash 도구에서 bare command처럼 호출 가능
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE (v2.1.90): 오프라인 환경에서 마켓플레이스 캐시 유지
MCP 결과 보존 override (v2.1.91): _meta["anthropic/maxResultSizeChars"]로 최대 500K자까지 결과 유지
MCP_CONNECTION_NONBLOCKING=true (v2.1.89): -p 실행에서 MCP 연결 대기 생략, --mcp-config 연결 5초 상한
PreToolUse defer 결정 (v2.1.89): 헤드리스 세션을 도구 호출 시점에서 일시 정지 후 -p --resume으로 재평가
Remote Control hostname prefix (v2.1.92): 세션 이름 기본 prefix가 호스트명으로 변경, flag로 오버라이드 가능
멀티라인 claude-cli://open?q= 딥링크 (v2.1.91): %0A 줄바꿈 지원
Linux apply-seccomp helper (v2.1.92): npm/네이티브 설치 모두 unix-socket 차단 복구
PowerShell 권한 검사 하드닝 (v2.1.90): background 우회, debugger hang, archive extraction 관련 보안 보강

영향 챕터

index.mdx — 기준일과 하이라이트를 v2.1.92 기준으로 갱신
setup.mdx — Bedrock 마법사, forceRemoteSettingsRefresh, Auto 모드 Recent 재시도 반영
hooks.mdx — PreToolUse defer, 대용량 훅 출력 디스크 저장 반영
mcp.mdx — nonblocking 연결, 결과 보존 크기 override 반영
skills-commands.mdx — /powerup, disableSkillShellExecution, 플러그인 bin//캐시 운영 반영
context.mdx — Edit 도구 토큰 절감, prompt cache 만료 복귀 힌트 반영
ide.mdx — 멀티라인 딥링크 반영
headless.mdx — Linux 샌드박스 helper, PowerShell 하드닝, Remote Control prefix 반영
verification.mdx — 최신 버전/교차검증 항목 갱신
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

2026-03-31

반영한 공식 변경(요약)

Auto 모드 (2026-03-24): AI 분류기가 도구 호출 위험도를 평가, 안전 작업 자동 진행/위험 작업 차단. default와 bypassPermissions 중간 지점
Computer Use (2026-03-24, 연구 프리뷰): macOS 화면 제어(마우스/키보드). Pro/Max 전용, Desktop 앱에서 활성화
Dispatch (2026-03-17): iPhone에서 작업 전송 → 데스크탑 자동 실행 → 완료 알림 수신. 전 플랜 사용 가능
PowerShell 도구 (v2.1.84): Windows 네이티브 PowerShell 도구 opt-in 프리뷰
PermissionDenied 훅 (v2.1.88): Auto 모드 분류기 거부 시 발생, {retry: true} 응답으로 재시도 가능
CwdChanged / FileChanged 훅 (v2.1.83): 작업 디렉토리 변경 및 파일 변경 감지 이벤트
TaskCreated 훅 (v2.1.84): 태스크 생성 시 발생하는 이벤트
조건부 if 필드 (v2.1.85): 훅에 퍼미션 규칙 구문으로 실행 조건 세밀 제어 (예: Bash(git *))
initialPrompt 에이전트 frontmatter (v2.1.83): 에이전트 생성 시 자동 프롬프트 제출
Named 서브에이전트 @ 타입어헤드 (v2.1.88): 이름 지정된 서브에이전트를 @ 멘션으로 빠르게 선택
MCP OAuth RFC 9728 (v2.1.85): Protected Resource Metadata 디스커버리 지원
MCP 서버 중복 제거 (v2.1.84): 로컬 설정이 claude.ai 커넥터보다 우선
MCP 도구 설명 2KB 제한 (v2.1.84): 도구 설명/서버 지시문 크기 제한
스킬 paths: frontmatter (v2.1.84): YAML 리스트로 glob 패턴 지정, 경로 기반 활성화
스킬 설명 250자 제한 (v2.1.86): /skills 메뉴 알파벳순 정렬
Thinking summaries 기본 비활성화 (v2.1.88): showThinkingSummaries: true로 복원 가능
managed-settings.d/ 드롭인 디렉토리 (v2.1.83): JSON 파일 드롭인으로 managed settings 조합
sandbox.failIfUnavailable (v2.1.83): 샌드박스 없는 환경에서 실행 거부 강제
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 (v2.1.83): 서브프로세스 자격증명 환경변수 제거
CLAUDE_CODE_NO_FLICKER=1 (v2.1.88): alt-screen 렌더링 깜빡임 제거
트랜스크립트 검색 (v2.1.83): Ctrl+O → / 키로 대화 내용 검색, n/N으로 탐색
Read 도구 압축 포맷 (v2.1.86): 압축된 줄번호 + 중복 읽기 제거
@ 멘션 토큰 오버헤드 감소 (v2.1.86): 파일 멘션 시 토큰 효율 향상
X-Claude-Code-Session-Id 헤더 (v2.1.86): API 요청에 세션 ID 자동 포함
CLAUDE_STREAM_IDLE_TIMEOUT_MS (v2.1.84): 스트리밍 유휴 타임아웃 설정 (기본 90초)
PreToolUse updatedInput 응답 (v2.1.85): AskUserQuestion 입력 자동 대체
PreToolUse/PostToolUse file_path 절대 경로 (v2.1.88): 훅 입력의 파일 경로 정규화
유휴 복귀 프롬프트 (v2.1.84): 75분 이상 유휴 시 /clear 제안
.jj/.sl VCS 제외 (v2.1.86): Jujutsu, Sapling VCS 지원
프롬프트 캐시 미스 수정 (v2.1.88), 중첩 CLAUDE.md 중복 주입 수정 (v2.1.88), StructuredOutput 스키마 캐시 수정 (v2.1.88)

영향 챕터

index.mdx — updatedAt 갱신, 하이라이트에 Auto 모드/Dispatch/Computer Use/PowerShell 추가
setup.mdx — Auto 모드, managed-settings.d/, sandbox.failIfUnavailable, thinking summaries, 렌더링 최적화
hooks.mdx — PermissionDenied, CwdChanged, FileChanged, TaskCreated 이벤트, 조건부 if 필드, PreToolUse 고급 응답
subagents.mdx — initialPrompt frontmatter, @ 멘션 타입어헤드
mcp.mdx — RFC 9728 OAuth, 서버 중복 제거, 도구 설명 제한, headersHelper 환경변수
skills-commands.mdx — paths: glob, 설명 250자 제한, 알파벳순 정렬
context.mdx — thinking summaries 비활성화, Read 도구 압축, @ 멘션 토큰 감소, 메모리 인터랙션
ide.mdx — Dispatch, Computer Use, Desktop 앱, 트랜스크립트 검색, 외부 에디터, 딥링크 개선
headless.mdx — PowerShell 도구, 세션 추적 헤더, 스트림 타임아웃
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
https://www.anthropic.com/engineering/claude-code-auto-mode (Auto Mode 엔지니어링 블로그)
https://claude.com/blog/dispatch-and-computer-use (Dispatch & Computer Use 블로그)

2026-03-25

반영한 공식 변경(요약)

Opus 4.6 기본 최대 출력 64k (v2.1.77): 기본 출력 토큰이 64k로 증가, 상한 128k
--bare 경량 실행 플래그 (v2.1.81): 스크립트용 -p 호출에서 hooks, LSP, 플러그인 동기화, 스킬 디렉토리 탐색을 건너뜀. ANTHROPIC_API_KEY 또는 apiKeyHelper 필요
--channels 연구 프리뷰 (v2.1.80): MCP 서버가 세션에 메시지를 직접 푸시 가능
--channels 퍼미션 릴레이 (v2.1.81): 채널 서버가 도구 승인 프롬프트를 폰으로 전달
MCP OAuth CIMD (SEP-991) (v2.1.81): Client ID Metadata Document 지원
/fork → /branch 이름 변경 (v2.1.77): /fork는 별칭으로 유지
Agent resume 파라미터 제거 (v2.1.77, Breaking): SendMessage({to: agentId}) 방식으로 대체
StopFailure 훅 이벤트 (v2.1.78): API 에러로 턴이 종료될 때 발생
effort frontmatter (v2.1.80): 스킬/슬래시 커맨드/플러그인 에이전트에서 effort 레벨 오버라이드
--console 인증 (v2.1.79): claude auth login --console로 API 빌링 인증
ANTHROPIC_CUSTOM_MODEL_OPTION (v2.1.78): /model 피커에 커스텀 항목 추가
source: 'settings' 플러그인 (v2.1.80): settings.json에서 인라인 플러그인 선언
VS Code /remote-control (v2.1.79): claude.ai/code에 브릿지 세션
VS Code AI 세션 제목 (v2.1.79): 첫 메시지 기반 자동 제목 생성
rate_limits 상태 표시줄 (v2.1.80): 5시간/7일 rate limit 사용량 표시
worktree 세션 재개 자동 전환 (v2.1.81): --resume으로 worktree 세션 재개 시 자동 복귀
--resume 성능 개선 (v2.1.77): 최대 45% 빠른 로딩, ~100-150MB 메모리 절감
macOS 시작 ~60ms 빠르게 (v2.1.77), 시작 시 ~80MB 메모리 절감 (v2.1.80)
줄단위 응답 스트리밍 (v2.1.78): 응답이 생성되는 대로 줄 단위 스트리밍
! bash 모드 발견성 개선 (v2.1.81)
Voice mode WebSocket 복구 (v2.1.81): 연결 끊김 시 자동 복구
PreToolUse "allow" 보안 수정 (v2.1.77): deny 퍼미션 규칙이 정상 적용
/copy N (v2.1.77): N번째 최근 응답 복사
"Show turn duration" 토글 (v2.1.79): /config에서 턴 소요 시간 표시
Plan 모드 "clear context" 기본 숨김 (v2.1.81)

영향 챕터

index.mdx — updatedAt 갱신, 하이라이트에 v2.1.77-81 주요 기능 추가
setup.mdx — Opus 64k 출력, 커스텀 모델, effort auto 표시, rate_limits, --console, turn duration
hooks.mdx — StopFailure 이벤트, CLAUDE_PLUGIN_DATA, PreToolUse 보안 수정
mcp.mdx — Channels 신규 섹션, OAuth CIMD, 도구 호출 접기, deny 규칙
multi-session.mdx — /branch 이름 변경, worktree 자동 전환, 세션 자동 이름, --resume 성능
subagents.mdx — Agent resume 제거(Breaking), 플러그인 에이전트 frontmatter
skills-commands.mdx — /copy N, /branch, effort frontmatter, 플러그인 관리
headless.mdx — --bare 플래그, VS Code remote-control, Remote Control 안정성
context.mdx — progress message compaction 개선, 백그라운드 bash 5GB 제한
ide.mdx — VS Code remote-control, AI 세션 제목, 플랜 탭 제목, Windows 호환성
vibe-coding.mdx — /branch, 줄단위 스트리밍, ! bash 모드, Voice 안정성
plan-mode.mdx — clear context 기본 숨김
verification.mdx — 검증일 갱신, 교차검증 테이블 보강
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

2026-03-17

반영한 공식 변경(요약)

Opus 4.6 1M 컨텍스트 기본화 (v2.1.75): Max, Team, Enterprise 플랜에서 Opus 4.6의 1M 컨텍스트 윈도우가 기본 활성화. 기존 Fast mode 한정이었던 것이 모든 모드로 확대
MCP elicitation 지원 (v2.1.76): MCP 서버가 작업 중간에 구조화된 입력을 사용자에게 요청 가능. Elicitation/ElicitationResult 훅 이벤트 추가
PostCompact 훅 이벤트 (v2.1.76): compaction 완료 후 발생하는 훅으로 로깅/알림 자동화에 활용
-n/--name 세션 이름 플래그 (v2.1.76): CLI에서 세션 표시 이름을 부여 가능
worktree.sparsePaths (v2.1.76): worktree 모드에서 git sparse-checkout 활성화, 대규모 모노레포에서 worktree 생성 속도 개선
/color 프롬프트 바 색상 (v2.1.75): 세션별 프롬프트 바 색상 커스터마이징
메모리 파일 last-modified 타임스탬프 (v2.1.75): 메모리 파일에 마지막 수정 시각이 기록되어 오래된 메모리를 식별하기 쉬워짐
훅 출처 표시 (v2.1.75): 권한 프롬프트에서 훅이 어디에서 왔는지 표시
Windows managed settings 경로 제거 (v2.1.75, Breaking): deprecated된 C:\ProgramData\ClaudeCode\ 경로가 제거됨
deferred tools compaction 버그 수정 (v2.1.76): deferred tools가 compaction 후 스키마를 잃는 문제 수정
자동 compaction 회로 차단기 (v2.1.76): 자동 compaction이 3회 초과 시도되지 않도록 제한
세션 품질 설문 (v2.1.76): Enterprise 관리자용 세션 품질 피드백 메커니즘 추가

영향 챕터

index.mdx — updatedAt 갱신, 하이라이트에 1M 기본화/MCP elicitation 추가
setup.mdx — 1M 컨텍스트 기본, -n 플래그, Windows managed settings 제거
mcp.mdx — MCP elicitation 신규 섹션
hooks.mdx — PostCompact, Elicitation, ElicitationResult 훅 추가
context.mdx — 1M 컨텍스트 기본화 문구 갱신
multi-session.mdx — worktree.sparsePaths 섹션 추가
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

2026-03-14

반영한 공식 변경(요약)

Sonnet 4.6 모델 출시(2026-02-17) 및 Sonnet 4.5→4.6 자동 마이그레이션 반영
Enterprise 플랜 정보 추가 ($20/좌석 + 사용량 기반, SCIM, 감사 로그)
/model 피커 읽기 좋은 라벨 표시 + 업그레이드 힌트 (v2.1.51) 반영
/copy 인터랙티브 피커 + w 키 파일 쓰기 (v2.1.59, v2.1.72) 반영
/color 세션 색상 변경 (v2.1.70), /rename 세션 이름 변경 (v2.1.70) 반영
/output-style deprecated 안내 추가 (v2.1.73, /config 대체)
Voice STT 20개 언어 지원 (v2.1.69), voice:pushToTalk 키바인딩 커스터마이즈 (v2.1.71) 반영
음성 인식 정확도 개선: 레포명, 개발 용어 (v2.1.72) 반영
effort 레벨 기호 표기 (○ ◐ ●) 명시
검증 리포트 교차검증 섹션 대폭 보강 (모델/버전 + 주요 기능 13개 항목)
index.mdx 하이라이트에 Sonnet 4.6, Code Review, Remote Control 추가
Code Review 연구 프리뷰 신규 섹션: 멀티에이전트 PR 리뷰, REVIEW.md 커스터마이즈, 심각도 레벨, 요금( $15~$ 25/리뷰)
Remote Control 섹션 대폭 확장: 전 플랜 사용 가능, 보안 모델, 자동 활성화 설정
REVIEW.md 개념 소개 (claude-md.mdx)
/security-review 번들 커맨드 추가

영향 챕터

index.mdx — updatedAt 갱신, 하이라이트에 Code Review/Remote Control 추가
setup.mdx — Sonnet 4.6, Enterprise 플랜, /model 피커 개선
claude-md.mdx — REVIEW.md 섹션 추가
skills-commands.mdx — /copy, /color, /rename, /security-review, /output-style deprecated
headless.mdx — Code Review 신규 섹션, Remote Control 대폭 확장
vibe-coding.mdx — Voice 20개 언어, pushToTalk, effort 기호
verification.mdx — 교차검증 테이블 보강, 링크 추가, 검증일 갱신
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
https://github.com/anthropics/claude-code/releases
https://code.claude.com/docs/en/code-review (Code Review 공식 문서)
https://code.claude.com/docs/en/remote-control (Remote Control 공식 문서)
https://www.anthropic.com/news (Sonnet 4.6, 2026-02-17)
https://claude.com/ko-kr/pricing (Enterprise 플랜)

2026-03-13

반영한 공식 변경(요약)

v2.1.74 기준 최신 반영 (기존 v2.1.39 → v2.1.74, 35개 버전)
Worktree 격리 시스템: --worktree 플래그(v2.1.49), EnterWorktree/ExitWorktree(v2.1.72), isolation: "worktree" 에이전트 정의(v2.1.50)
추론 강도 제어: /effort 명령(v2.1.72), "ultrathink" 키워드(v2.1.68), Opus 4.6 medium 기본값(v2.1.68)
자동화 확장: /loop 크론 스케줄(v2.1.71), HTTP hooks(v2.1.63), 신규 훅 이벤트 4종(ConfigChange, InstructionsLoaded, WorktreeCreate/Remove)
컨텍스트 최적화: /context 액셔너블 제안(v2.1.74), 자동 메모리 기록(v2.1.59), 도구 결과 디스크 저장 임계값 50K(v2.1.51)
VS Code 강화: MCP 관리 다이얼로그(v2.1.70), 플랜 마크다운 뷰(v2.1.70), 스파크 아이콘 세션 목록(v2.1.70)
MCP 고도화: OAuth step-up auth(v2.1.49), 바이너리 콘텐츠 처리(v2.1.69), claude.ai 커넥터(v2.1.63)
/fork(v2.1.71), /color(v2.1.70), /rename(v2.1.70), CLAUDE.md HTML 주석 숨김(v2.1.72) 등 다수 기능 반영

영향 챕터

전 챕터(Ch1~Ch12) 업데이트
index.mdx 버전 기준일 및 하이라이트 갱신

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

2026-02-11

반영한 공식 변경(요약)

v2.1.39 기준 최신 안정화 반영
- 중첩 Claude Code 세션 실행 방지 가드
- MCP 이미지 스트리밍 크래시 수정, /resume 미리보기 가독성 개선
- 터미널 렌더링 성능/안정성 개선
v2.1.36~v2.1.33 큰 변화 반영
- Opus 4.6 대상 Fast mode 지원
- Agent Teams 실험 기능 이후 다중 에이전트 운영 기능 확장
- 신규 Hook 이벤트 TeammateIdle, TaskCompleted
- 에이전트 tools에서 Task(agent_type) 제한 지원
- 에이전트 memory frontmatter(user/project/local) 지원
v2.1.32 반영
- 자동 메모리 기록/재호출
- 메시지 선택기 “Summarize from here” 추가
- --add-dir 경로의 .claude/skills/ 자동 로드
v2.1.30 운영 기능 반영
- Read 도구 PDF pages 파라미터 지원
- MCP OAuth 비DCR 서버용 --client-id, --client-secret 지원
- /debug 명령 도입
- Task 결과에 토큰/도구 사용 수/소요 시간 메트릭 추가
- --resume 메모리 사용량 개선(릴리스 노트 기준 68% 절감)
v2.1.27 반영
- --from-pr로 PR 기반 세션 재개
- gh pr create로 생성한 세션의 PR 자동 연결
v2.1.18 반영
- /keybindings 기반 단축키 커스터마이징
v2.1.15 반영
- npm 설치 경로 deprecation 안내(claude install/공식 설치 스크립트 권장)

사람들 반응이 큰 항목 (GitHub 공개 이슈 반응 기준)

단축키 커스터마이징 수요: #9177 (reactions 19), #5376 (reactions 34)
Agent Teams 확장 수요: #23574 (reactions 18), #24122 (reactions 15)

참고: “반응”은 공개 이슈의 댓글/리액션 수로 간접 판단했습니다.

영향 챕터

index.mdx
subagents.mdx
hooks.mdx
mcp.mdx
headless.mdx
meta.json

근거 링크(공식/공개)

업데이트 기록 템플릿

아래 형식을 복사해 새 기록을 추가하세요.

### YYYY-MM-DD

**반영한 공식 변경(요약)**

- ...

**사람들 반응이 큰 항목 (선택)**

- ...

**영향 챕터**

- ...

**근거 링크(공식/공개)**

- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

2026-10-23 · Claude Code 2.1.308

권한 기본값(v2.1.302): third-party provider·telemetry off·fresh install에서 권한 모드를 지정하지 않은 claude -p·Agent SDK는 default로 시작합니다. v2.1.285의 auto 기본값 안내를 대체하며 --permission-mode auto는 계속 명시할 수 있습니다.
스킬·훅(v2.1.299~304): UserPromptSubmit은 스킬·custom command가 확장되기 전에 실행돼 거절 시 embedded shell도 막습니다. 스킬 자체의 같은 훅은 호출 다음 프롬프트부터 실행됩니다. PreToolUse·PermissionRequest의 updatedInput은 도구 입력 검증을 거치며, prompt·agent 훅은 같은 이벤트를 최대 12개씩 실행합니다. 소스별 스킬 훅은 세션당 1,024개·matcher 16,384자 한도입니다.
subagent(v2.1.302): fork subagent가 -p·SDK·Desktop·VS Code에서도 기본 활성화됐습니다(CLAUDE_CODE_FORK_SUBAGENT=0으로 해제, claude mcp serve 제외). 메인 대화의 subagent는 background, 그 subagent의 Agent 호출은 해당 환경에서 기본 foreground입니다.
컨텍스트(v2.1.299·302·304): 200K+ 토큰 대화를 약 54분 유휴 뒤 압축하는 idle compaction과 /config 토글을 반영했습니다. idleCompaction: false로 끄고 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS로 최소 토큰을 조절합니다. Changelog는 두 설정의 지원 버전을 v2.1.290+로 적습니다. compaction 뒤에는 스킬 목록을 다시 보내고 /reload-skills는 새로 생기거나 바뀐 스킬만 보냅니다.
API·Design: /claude-api managed-agents-secure(v2.1.304)는 보안 가이드와 설정을 읽기 전용으로 대조하고, api-version(v2.1.307)은 API 버전 2026-10-21 전환을 돕습니다. 공식 표에 /design consent·/design revoke가 추가됐고 consent는 사용자가 직접 입력합니다. /design-login·/design-sync가 쓰는 독립 claude.ai/design은 2026-12-14까지 종료 예정입니다.
MCP·조직 정책(v2.1.299~307): mcp__a의 allow 규칙이 다른 서버 a__b까지 허용하지 않게 바뀌었습니다. 서버 이름 전체를 써 mcp__<server>__*로 지정합니다. v2.1.305부터 managed-mcp.json stdio 서버가 ${VAR}를 env에만 쓰면 allowedMcpServers 필터 대상이 아니므로 차단은 deniedMcpServers로 명시합니다. v2.1.307은 연결 중단 후 HTTP MCP 재시도를 read-only·idempotent 도구로 제한합니다.
운영·진단: claude remote-control --sandbox·--no-sandbox는 v2.1.300부터 오류이며 sandbox.enabled를 사용합니다. v2.1.307부터 runner checkout hook은 기본 30분 제한(--checkout-hook-timeout-min, 0은 해제), 차단·질문된 도구 호출은 claude_code.safety_event OTel 이벤트로 추적합니다. v2.1.308은 일반 버그 수정·안정성 개선으로만 공지됐습니다.
보안·복구: plan mode의 hook 승인 쓰기 우회, symlink sandbox 경계, third-party gateway key 전달, 중복 도구 실행(v2.1.299), worktree 삭제 확인(v2.1.301·304) 등의 수정도 대조했습니다. sandbox.allowNestedUserNamespaces(v2.1.305)는 파일 보호를 우회할 수 있어 Chromium·rootless podman이 필요한 Linux 환경에서 격리 경계를 검토한 뒤 사용합니다.
Code Review·mods: Code Review 서비스의 @claude review stop(off·pause)은 PR의 always 구독만 종료합니다(v2.1.307). v2.1.304는 mod tool.check에 read-only 표시 e.isReadOnly와 사람의 승인만 받는 decider: "person"을 추가했습니다. 승인창·host callback이 없으면 사유와 함께 거절합니다.

근거: Changelog, Commands, CLI reference, Hooks, Subagents, npm dist-tags.

2026-10-10 최신 변경

Claude Code v2.1.293~v2.1.296(10월 7일~9일)과 Claude Haiku 5.5 모델 문서를 반영했습니다. 2026-10-10 KST npm 기준은 latest/next=2.1.296, stable=2.1.287입니다.

Haiku 5.5 출시(2026-10-07): claude-haiku-5-5가 v2.1.293부터 Anthropic API의 기본 Haiku입니다. 1M context, 128K output, prompt 100,000 token 기준으로 갈리는 단가($0.10/$0.50, 초과 $0.50/$2.50), Claude Code 기본 effort medium, 끌 수 없는 thinking을 setup·context·vibe-coding에 반영했습니다.
Sonnet 5.5 cache read: setup의 Sonnet 5.5 cache read 단가를 $0.10/MTok로 바로잡았습니다. v2.1.296부터 /cost·status line·--max-budget-usd·SDK 비용 수치도 이 값으로 계산합니다(이전 $0.20).
hooks: command·HTTP hook의 onFailure: "block"(v2.1.295)과 Stop·SubagentStop prompt hook의 판정 개선(v2.1.294)을 추가했습니다.
subagents: skills preload 상한 32개(v2.1.295), frontmatter autoCompactWindow(v2.1.296), subagentStatusLine의 agentType(v2.1.293)을 추가했습니다.
mcp·headless: MCP description 한도(선로드 4,096자, tool search 16,384자)와 WebSocket 16 MiB 한도를 mcp에, 재시도 환경 변수 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS(v2.1.295)·CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS(v2.1.296)를 headless에 추가했습니다.

근거: 공식 Changelog, Model configuration, Hooks, Subagents, MCP, CLI reference, Claude Haiku 5.5 overview, Pricing, npm dist-tags.

반영 위치: index, setup, context, vibe-coding, hooks, subagents, mcp, headless, verification의 한·영판(영문판은 vibe-coding 대신 prompting).

이전 변경 (2026-10-07)

Claude Code v2.1.284~v2.1.292(9월 28일~10월 6일)과 Claude Sonnet 5.5 모델 문서를 반영했습니다. 2026-10-07 KST npm 기준은 latest/next=2.1.292, stable=2.1.285입니다.

Sonnet 5.5 출시(2026-09-28): claude-sonnet-5-5가 v2.1.284부터 Anthropic API의 기본 Sonnet입니다. 1M context, 128K output, $2/$ 10 per MTok(cache read $0.20), Claude Code 기본 effort medium, 분류기 fallback(사이버보안 → Sonnet 5, 생물학 → 거절)을 반영했습니다.
권한 기본값: 대화형 터미널·VS Code 세션의 auto mode 기본 시작이 모든 플랜·provider로 넓어졌고(v2.1.284), third-party·telemetry off 환경의 claude -p·Python Agent SDK도 같아졌습니다(v2.1.285). headless에서 CI에 --permission-mode를 명시하라는 기준에 이 변경을 더했습니다.
Ultracode·effort: Ultracode가 effort와 별개의 토글이 된 점(v2.1.284)을 setup·vibe-coding에 반영했습니다.
headless: --bare의 MCP·system reminder·background task 범위 변경과 재시도 한도 통합(v2.1.286)을 추가하고, --system-prompt와 -file 형식 병행에 대한 공식 CLI reference 불일치가 해소된 것을 기록했습니다.
운영 변경: managed allowedProviders와 sandbox 설정 보호(v2.1.285), Claude Mods(v2.1.287), stdio MCP protocol 기본 협상(v2.1.292), claude purge 이름 변경(v2.1.288)을 반영했습니다.

근거: 공식 Changelog, Model configuration, Permission modes, MCP, Claude Sonnet 5.5 overview, npm dist-tags.

반영 위치: index, setup, context, vibe-coding, prompting, headless, verification의 한·영판.

이전 변경 (2026-09-26)

Claude Code v2.1.280~v2.1.283(9월 22~25일)과 Claude Opus 5.5 모델 문서를 반영했습니다. 2026-09-26 KST npm 기준은 latest/next=2.1.283, stable=2.1.274입니다.

Opus 5.5 출시(2026-09-22): claude-opus-5-5가 v2.1.280부터 기본 Opus·fast mode 기본 모델이고, Pro·Team Standard를 포함한 대부분 플랜과 Anthropic API·Claude Platform on AWS·Bedrock·Google Cloud Agent Platform의 default가 됐습니다. 1M context, 128K output, $4/$ 20 per MTok(cache read $0.20), 상시 adaptive thinking, 기본 effort `medium`, fast mode$ 8/$40, 분류기 fallback(생물학 → Opus 5, 사이버보안 → Opus 4.8)을 반영했습니다.
effort 기준 변경: user settings의 최상위 effortLevel이 Opus 5.5에 적용되지 않는다는 점과 모델별 저장 방법을 setup·vibe-coding·prompting에 추가했습니다.
Messages API 차이: forced tool_choice 400, thinking 비활성화·고정 budget 400, 모델·대화에 묶인 thinking block, Claude API·Google Cloud의 computer_20251124 거부를 정리했습니다.
릴리스 보류: v2.1.283의 managed deniedModels·availableModelsMatch: "exact"와 requiredMinimumVersion 병행 기준을 추가했습니다.
운영 변경: third-party·telemetry off 환경의 auto mode 기본 시작(v2.1.283), server-side auto mode classifier 기본화와 project/local OTel 변수 무시(v2.1.282), 위험한 rm 확인창 2분 제한·"attribution": false·AGENTS.md provider 확대·--agents 파일 경로(v2.1.281), /doctor prompt-audit·--system-prompt 형식 병행(v2.1.283)을 반영했습니다.

근거: 공식 Changelog, Model configuration, Fast mode, Claude Opus 5.5 overview, What's new in Claude Opus 5.5, npm dist-tags.

반영 위치: index, setup, context, vibe-coding, prompting, subagents, headless, verification의 한·영판(headless는 한국어판만 해당).

이전 변경 (2026-09-12)

플러그인: claude plugin eval은 JSON·HTML 평가 보고서를 만들고, install·uninstall·update·enable·disable은 --json을 지원합니다. --plugin-dir에는 여러 plugin의 상위 폴더도 지정할 수 있습니다.
명령·설정: /output-style [name]이 Remote Control·cloud·headless에도 적용됩니다. maxEffortLevel은 전체 또는 modelSettings의 모델별 effort 상한을 정합니다. bashEditDiffEnabled로 Bash 파일 편집 diff를 결과에 표시할 수 있습니다.
복구·호환성: 2.1.266은 gateway 강제 로그인 회귀, 2.1.268은 2.1.265 이후 Anthropic 호환 endpoint의 HTTP 400을 수정합니다. /goal은 API·네트워크·사용량 한도 오류 뒤 backoff 재시도 또는 이유를 밝힌 일시정지로 처리됩니다.
권한·운영: symlink 경로의 deny/ask, Bash tee의 쓰기 경계, MCP·plugin 오류의 비밀값 노출이 수정됐습니다. WebFetch는 기본 300초 deadline을 갖고, /ultrareview --post는 결과 도착 시 PR 댓글을 바로 게시합니다.

근거: 공식 Changelog, npm dist-tags.

반영 위치: index, setup, verification, 관련 명령·운영 챕터의 한·영판. 아래 기록은 이전 검증 시점의 이력입니다.

최종 업데이트

2026년 10월 23일 재검증 기준 (v2.1.308)

운영 원칙

근거 기반 반영: GitHub Changelog/릴리스 확인 후 문서 업데이트
영향 범위 명시: 어떤 챕터에 어떤 변화를 반영했는지 기록
신규 기능 우선: 기능 추가/워크플로우 변화/운영 영향이 큰 항목부터 반영

최근 업데이트

2026-09-05 (v2.1.252~v2.1.261 + Fable 5.1)

최신 기준 상향 (v2.1.261): 공식 Changelog v2.1.252~261과 npm dist-tag(latest/next=2.1.261, stable=2.1.236), Model configuration, Fast mode, Claude Fable 5.1 overview·What's new·migration guide, Anthropic 발표를 교차 확인
Fable 5.1 출시(2026-09-01): claude-fable-5-1이 v2.1.257부터 기본 Fable 모델(요구 버전 v2.1.255+). fable·best alias 해석 변경, Fable 5의 /model claude-fable-5 선택 경로, gateway 세션의 Fable 5 유지, availableModels prefix 동작, cache read $0.25/MTok, 30일 보존·ZDR 조건, 지식 기준일·은퇴 기준을 반영
분류기 fallback 표: Fable 5.1·5 생물학 → Opus 5, 사이버보안 → Opus 4.8, Opus 5 사이버보안 → Opus 4.8, 생물학 → 거절. switchModelsOnFlag: false, third-party ANTHROPIC_DEFAULT_OPUS_MODEL 조건 추가
Fable 5.1 API 차이: forced tool_choice 400, thinking block 모델 귀속, 이전 턴 편집 시 무효화(2026-08-31 이후 계정 강제)를 breaking change로, per-message effort·turn-scoped system message·display: "updates"·content provenance를 additive로 정리. Mythos 5.1 접근 조건 구분
effort·1M 운영: Opus 5·Fable 5.1은 default effort hold 없음, v2.1.257 /effort s·--effort hold 세션 한정, v2.1.260 Fable 5.1 effort 변경 시 cache 유지, Opus·Fable 1M auto-compact 시점 변경, model: fable [1m] 태그 수정, CLAUDE_CODE_SUBAGENT_MODEL_FORCE를 반영
반영한 챕터: index, setup, context, subagents, vibe-coding, verification와 Command Master 한·영판(/model·/effort·/fast·index·overview·verification·updates)

2026-08-28 (v2.1.239~v2.1.247)

사용량·조직 설정: /usage loop별 통계, v2.1.242+ modelPicker·prompt-cache TTL의 scope/허용값, Changelog-only modelPricing, /permissions Auto 모드 탭을 구분해 반영
에이전트·자동화: /tasks model·effort 표시, maxTurns 부분 결과와 기존 에이전트 ID/이름 기반 재개, 첫 호출 404 fallback chain, -p·SDK·cloud auto-continue를 반영
명령·피드백: /claude-api upgrade, Commands signature보다 앞선 release-tracked cost-optimize, Admin API 확장, SendFeedback 초안과 feedbackDrafts=notify|quiet|off를 반영
컨텍스트·보안: Sonnet 5 1M auto-compaction을 약 967k로 상향하고 Bash wildcard 경고, marketplace hardening, third-party gateway 자격증명 격리를 반영
반영한 챕터: index, setup, subagents, headless, context, verification와 Command Master 한·영판

2026-08-20 (v2.1.221~v2.1.237)

세션·에이전트: interactive fork mode와 background subagent spawn 기본화, cross-session messaging·세션 @ 멘션, 세션 누적 200개 제한 제거, /code-review high/xhigh/max background 실행을 반영
배포·자동화: claude self-hosted-runner, claude remote-control --continue, GitLab MR/worktree/agent, plugin command source와 archive+SHA pinning, server-supplied hook을 추가
모델·도구·출력: ANTHROPIC_DEFAULT_MODEL, 최신 모델의 legacy Task/Todo 도구 기본 비활성화와 호환 플래그, Concise output style, gateway/custom base URL prompt caching 수정을 반영
보안·안정성: worktree/symlink, sandbox credential masking, trust prompt, MCP OAuth, cross-session ingress, Remote Control, 위험 git 플래그 승인과 설정 무결성 수정을 반영
반영한 챕터: index, setup, multi-session, subagents, headless, skills-commands, verification와 Command Master 한·영판

2026-08-03 (명령 변경 여부 재검증)

공식 Changelog 최신 항목이 v2.1.220이고 npm·로컬 CLI도 latest=2.1.220, stable=2.1.212, next=2.1.220임을 재확인
2026-08-01 이후 신규 정식 릴리스나 명령 추가·삭제·이름 변경이 없어 기능 본문은 유지
index.mdx와 verification.mdx, Claude Code Command Master 한·영판의 기준일과 무변경 판정을 동기화

2026-08-01

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.220): npm latest=2.1.220, stable=2.1.212, next=2.1.220 교차 확인
Opus 5 (v2.1.219): 기본 Opus 경로, native 1M context, fast mode, provider별 opus alias와 full model pinning 기준 갱신
세션·서브에이전트 제어 (v2.1.212~v2.1.219): /fork background session과 /subtask 분리, 세션당 200개·동시 20개 상한, 기본 3단계 중첩, --max-budget-usd의 background subagent 중단 반영
보안·격리: sandbox.network.strictAllowlist, sandbox.filesystem.disabled, worktree/symlink/permission parser 보강, untrusted agent hook 차단 반영
자동화·headless: DirectoryAdded, mcp_server_errors, --forward-subagent-text의 nested subagent 전달, workflow size 기본 medium(15 agents 미만), /code-review background 실행과 /verify·/code-review 수동 호출 전용화 반영

반영한 챕터

index.mdx·setup.mdx — 버전/모델/provider/fast mode 기준 갱신
multi-session.mdx·subagents.mdx — /fork//subtask, spawn·concurrency·depth 예산 반영
hooks.mdx·headless.mdx·skills-commands.mdx — 신규 hook, init 오류, nested forwarding, workflow/skill 실행 규칙 반영
verification.mdx와 Claude Code Command Master 한·영판 동기화

2026-07-10

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.205): 공식 Changelog와 npm dist-tag 교차 확인. npm latest=2.1.205, stable=2.1.197, next=2.1.206이며, 공개 변경 로그가 없는 next는 본문 기준에서 제외
v2.1.202: /config에 advisory 방식의 Dynamic workflow size 추가, workflow agent telemetry에 workflow.run_id·workflow.name 추가, /review는 빠른 단일 패스로 복귀하고 멀티에이전트 심화 리뷰는 /code-review <level> <PR>로 분리
v2.1.203: 로그인 만료 사전 경고, 추가 working directory의 MCP roots/list 반영, Agent View·background session·worktree·Remote Control 안정성 대폭 보강, workflow 진행 화면 개선
v2.1.204: headless SessionStart hook 중 hook event가 스트리밍되지 않아 remote worker가 idle 종료되던 문제 수정
v2.1.205: Auto 모드가 transcript 파일 변조를 차단하고 해석할 수 없는 변수 대상 rm -rf 실행 전 질문, --json-schema invalid schema/format 처리 수정, /doctor를 진단·수정 가능한 전체 setup checkup으로 확장하고 /checkup 별칭 추가, Agent View·Remote Control 상태 및 updater 메모리 개선

반영한 챕터

index.mdx·setup.mdx — 기준일과 npm 채널을 v2.1.205/latest, v2.1.197/stable로 갱신
multi-session.mdx·mcp.mdx — Agent View/background 안정화와 MCP roots 확장 반영
skills-commands.mdx — Dynamic workflow size·OTel 속성 반영
headless.mdx — --json-schema 검증과 headless SessionStart hook 스트리밍 수정 반영
Command Master의 /workflows·/review·/doctor 및 영어 요약 페이지를 같은 기준으로 동기화
verification.mdx — v2.1.202~205 및 npm dist-tag 검증 행 추가

2026-07-04

반영한 공식 변경(요약)

Fable 5 재배포: Fable 5·Mythos 5는 2026-06-09 GA 출시 후 2026-06-12 미국 수출통제로 전 사용자 접근이 약 19일간 중단됐다가, 6-30 통제 해제로 2026-07-01 Claude Platform·Claude.ai·Claude Code·Cowork에 전역 복원됨. 재배포 시 보고된 취약점 탐지 행위를 겨냥한 개선된 안전 분류기가 적용됨
Fable 5 플랜 사용: Pro·Max·Team·일부 Enterprise는 2026-07-07까지 주간 사용 한도의 최대 50%까지 Fable 5를 포함하고 이후 usage credits로 사용. Mythos 5(안전 분류기 없음)는 Project Glasswing(미국 핵심인프라 방어) 초대 전용
최신 기준 상향 (v2.1.201): 공식 Changelog와 npm dist-tag 교차 확인. npm latest는 2.1.201, stable은 2.1.185
v2.1.198: 서브에이전트가 기본적으로 백그라운드에서 실행, Claude in Chrome GA, /dataviz 스킬 추가
v2.1.199: SSL 오류·스트리밍 응답·서브에이전트 오류 처리 수정
v2.1.200: 기본 permission mode가 Manual로 변경, background session 수정
v2.1.201: Sonnet 5 세션이 mid-conversation system role을 더 이상 사용하지 않음

반영한 챕터

index.mdx — 기준일을 v2.1.201로 갱신하고 v2.1.198~201 운영 변경과 Fable 5 재배포 하이라이트 추가
setup.mdx — npm 기준·sandbox 버전 범위를 v2.1.201로 갱신, Fable 재배포·플랜 사용·Mythos 구분·v2.1.200 기본 permission mode Manual 반영
subagents.mdx·headless.mdx — v2.1.198 서브에이전트 기본 백그라운드 실행과 버전 기준 범위 갱신
skills-commands.mdx — /dataviz 신규 스킬과 재검증 기준 갱신
verification.mdx — v2.1.198~201·Fable 재배포 검증 행 추가

2026-07-01

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.197): 공식 Claude Code Changelog와 npm dist-tag를 교차 확인. npm latest/next는 2.1.197, stable은 2.1.185
Sonnet 5 기본화 (v2.1.197): Claude Code의 기본 모델 경로에 Sonnet 5가 들어왔고, Anthropic API sonnet alias와 Pro·Team Standard·Enterprise subscription seat의 default가 Sonnet 5로 해석됨
1M context/effort 정책 갱신: Sonnet 5는 native 1M context를 기본 지원하고 low/medium/high/xhigh/max effort를 지원하며 기본 effort는 high
조직 모델 거버넌스 (v2.1.196): 조직 관리자가 지정한 기본 모델이 /model에서 Org default/Role default로 보이는 흐름을 모델 정책에 반영
운영 안정성 보강 (v2.1.195~v2.1.196): .mcp.json self-approval 보안 보강, background job transcript 보존, Remote mid-turn crash recovery, PowerShell git command exit-code 처리, plugin validate/enable edge case, background agent/permission 안정화 반영

영향 챕터

index.mdx — 기준일과 최신 버전을 v2.1.197로 갱신하고 Sonnet 5 기본화 하이라이트 추가
setup.mdx — npm latest/stable, Anthropic API sonnet alias, default 계정별 모델, opusplan[1m], Sonnet 5 effort/context 기준 갱신
context.mdx — Sonnet 5 native 1M context와 Sonnet 4.6 usage-credit 설명 분리
Command Master 책 — index, overview, /model, /effort, verification, updates를 같은 기준으로 동기화

근거 링크(공식/공개)

2026-06-25

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.190): 공식 Changelog와 npm dist-tag를 교차 확인. npm latest/next는 2.1.190, stable은 2.1.179
보안·샌드박스 보강 (v2.1.181~v2.1.186): sandbox.credentials, destructive command sandbox auto-approval, Windows PowerShell sandbox 수정, Agent deny rules, background session permission prompt 보강
MCP 운영 보강 (v2.1.185~v2.1.187): claude mcp login/logout, CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT, misleading MCP status 수정, idle timeout runbook 반영
모델 제한/경고 (v2.1.184, v2.1.187): main model restriction은 Opus/Sonnet/Haiku/Fable 계열 중심으로 강화, Haiku main model 불가·subagent 허용, deprecated model warning 보강
서브에이전트/Background 안정화 (v2.1.184~v2.1.186): 최대 3단계 agent nesting, nested agent 안정화, background agent worktree/comment/commit edge case 수정
운영 품질 수정 (v2.1.185~v2.1.190): non-interactive fallback 안정화, output schema determinism, Korean paste mojibake fix, 앱/스키마 버그 수정

영향 챕터

index.mdx — 기준일과 최신 버전을 v2.1.190으로 갱신
setup.mdx — latest/stable 채널과 model restriction/deprecation warning 메모 추가
headless.mdx — sandbox credentials, destructive command, non-interactive fallback, MCP idle timeout 반영
mcp.mdx — claude mcp login/logout, idle timeout, status 오해 방지 추가
subagents.mdx — 3단계 nesting, Haiku subagent, background/deny-rule 안정화 추가
skills-commands.mdx — skill/plugin/command 최신 운영 메모 추가
verification.mdx — 공식 문서 교차검증 기준을 2026-06-25로 갱신
Command Master 책 — index, updates, verification, /model, MCP/운영 페이지를 같은 기준으로 동기화

근거 링크(공식/공개)

2026-06-13

반영한 변경(요약)

핸드북 전체 리뷰·최신화 라운드에서 본 핸드북을 점검했습니다. 새로 반영할 공식 제품 변경은 없었고, 콘텐츠 일관성 정리만 수행했습니다.
skills-commands.mdx — Callout 타입 표기를 표준값으로 정규화(비표준 tip → info, 2건). 본문 내용·의미 변화 없음.

영향 챕터

skills-commands.mdx — Callout 타입 정규화
updates.mdx — 본 기록 추가

2026-06-10

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.170): Claude Code에 Claude Fable 5가 추가된 변경을 모델 정책의 최상단 기준으로 반영
Fable 5 운영 기준: /model fable, fable alias, best alias의 Fable 우선 선택, ANTHROPIC_DEFAULT_FABLE_MODEL, 기본 모델이 아니라는 점, ZDR/30일 data retention, adaptive thinking 상시 활성화, DISABLE_PROMPT_CACHING_FABLE을 반영
Fable 자동 fallback: 안전 분류기가 Fable 요청을 사이버보안·생물학 등 민감 영역으로 판단하면 기본 Opus로 자동 재실행되는 흐름과 claude --safe-mode 진단 절차를 추가
Fallback chain (v2.1.166): overload나 availability failure에 대비해 fallbackModel 설정과 --fallback-model 명령 예시를 추가
인접 운영 변경 (v2.1.169, v2.1.246 재검증): /cd가 대화와 prompt cache를 유지하고 대상의 설정·hook·.mcp.json·skill·agent를 즉시 적용하는 점, --safe-mode가 customization을 끄는 범위, bundled skill/workflow 비활성화, self-hosted runner post-session hook을 반영
세션 저장 버그 수정 (v2.1.170): VS Code 통합 터미널 또는 Claude Code 환경변수를 상속한 shell에서 시작한 세션이 transcript를 저장하지 못해 --resume에 나타나지 않던 문제를 headless/CI 기준에 반영
Opus 4.8 기준 유지: Fable을 사용할 수 없거나 비용상 과한 경우의 고성능 Opus 경로는 Opus 4.8로 유지

영향 챕터

index.mdx — 기준일을 v2.1.170과 Fable 5 기준으로 갱신하고, Fable fallback과 best alias를 하이라이트에 추가
setup.mdx — Fable 5, best, alias pinning, ANTHROPIC_DEFAULT_FABLE_MODEL, fallbackModel, 1M context, effort, retention, prompt caching 기준 반영
context.mdx — Fable 5의 1M context 지원, fable[1m]/claude-fable-5[1m] 예시, adaptive thinking 제약 추가
headless.mdx — --safe-mode와 --bare 차이, v2.1.170 transcript persistence fix, self-hosted runner post-session hook 반영
skills-commands.mdx — /advisor, /cd, disableBundledSkills, CLAUDE_CODE_DISABLE_BUNDLED_SKILLS, --disable-slash-commands 반영
subagents.mdx — 서브에이전트 model frontmatter에서 fable alias와 claude-fable-5 full ID를 명시
vibe-coding.mdx — effort 표에서 Fable 5의 high 기본값과 xhigh 지원 반영
verification.mdx — 공식 문서 교차검증 기준을 2026-06-10으로 갱신
Command Master 책 — /model, /advisor, /cd, --safe-mode, fallback 관련 명령 표면을 같은 기준으로 동기화

근거 링크(공식/공개)

2026-05-29

반영한 공식 변경(요약)

최신 기준 상향 (v2.1.154): Claude Code 최신 기준을 v2.1.154로 올리고, 2026-05-28 공개된 Claude Opus 4.8을 모델 정책의 기준으로 반영
Opus 4.8 모델 정책: Anthropic API의 opus alias가 Opus 4.8로 해석되고, Opus 4.8이 high effort 기본값과 /effort xhigh 경로를 갖는다는 점을 모델 선택/검증 섹션에 반영
Provider별 alias 차이: Anthropic API, Claude Platform on AWS, Bedrock/Vertex/Foundry의 opus/sonnet alias 해석 차이를 분리하고, 재현성 작업은 full model name 또는 ANTHROPIC_DEFAULT_*_MODEL pinning을 권장
/model 저장 동작 변경 (v2.1.153): /model <name>과 picker Enter가 사용자 기본 모델로 저장되고, 현재 세션만 바꾸려면 s를 쓰는 흐름을 반영
Fast mode 최신화 (v2.1.154): Opus 4.8 fast mode가 표준 대비 2배 요금/2.5배 속도 경로로 바뀐 점, Opus 4.6 fast override가 legacy가 되는 점 반영
Agent View / background sessions (v2.1.139~v2.1.154): claude agents, /bg//background, claude --bg, claude --bg --exec, Agent View 필터/그룹/작업 격리 기준 반영
Dynamic workflows (v2.1.154): Claude가 workflow를 만들고 다수 agent를 background에서 오케스트레이션하며 /workflows로 진행 상태를 관리하는 흐름 추가
목표 기반 장기 작업 (v2.1.139): /goal 명령과 interactive/headless/Remote Control에서의 완료 조건 기반 작업 흐름 반영
명령 표면 최신화: /usage-credits, /reload-skills, /run, /verify, /run-skill-generator, /code-review, /workflows, /goal, /background를 skills/commands 운영 기준에 반영
운영/보안 보강: Auto mode data exfiltration 탐지 강화, background session worktree isolation 보강, --session-id, --log-level, 자동 업데이트 settings, 비필수 트래픽/터미널 제목 비활성화 env 반영

영향 챕터

index.mdx — 기준일을 v2.1.154와 Opus 4.8 출시 기준으로 갱신하고, 최신 하이라이트 재구성
setup.mdx — Opus 4.8, provider별 alias, /model 저장 동작, effort/fast mode 운영 기준 반영
subagents.mdx — Agent View, background session dispatch, claude --bg --exec, worktree isolation, model/effort 보존 반영
headless.mdx — --session-id, mcp-clients, background sessions, /run·/verify, 운영 환경변수 반영
skills-commands.mdx — /goal, /workflows, /background, /usage-credits, /reload-skills, /run, /verify, /code-review 반영
verification.mdx — 공식 문서 교차검증 기준을 2026-05-29로 갱신
Command Master 책 — 명령 카탈로그와 /model·/agents 상세를 같은 기준으로 동기화

근거 링크(공식/공개)

2026-04-20

반영한 공식 변경(요약)

최신 안정 버전 상향 (v2.1.114): 최신 stable 기준을 v2.1.114로 갱신하고, permission dialog crash fix를 최신 릴리즈로 기록
런처/설치 경로 정리 (v2.1.113): CLI가 플랫폼별 네이티브 Claude Code binary를 실행하도록 바뀐 점을 반영하고, 네이티브 인스톨러/Homebrew/WinGet 우선 원칙을 강화
샌드박스 네트워크 예외 차단 (v2.1.113): sandbox.network.deniedDomains와 allowedDomains 우선순위, 운영 활용 예시 반영
권한 프롬프트/명령 명칭 정리 (v2.1.111~v2.1.113 + 현재 commands docs): /less-permission-prompts를 현재 공식 명칭 /fewer-permission-prompts로 정리하고, cd <current-directory> && git ... no-op 패턴의 prompt 완화 반영
Remote Control / loop / subagent 운영성 보강 (v2.1.113): Remote Control의 /extra-usage, @ 파일 자동완성 질의, /loop wakeup 취소 UX, subagent 10분 stall failover 반영

영향 챕터

index.mdx — 기준일을 v2.1.114로 올리고 최신 운영/보안 하이라이트 추가
setup.mdx — native binary 런처와 sandbox.network.deniedDomains 반영
headless.mdx — Remote Control 보강, /loop wakeup UX, no-op cd && git prompt 완화 반영
subagents.mdx — stalled subagent 10분 failover 반영
skills-commands.mdx — /fewer-permission-prompts 현재 명칭 정리
verification.mdx — v2.1.114, deniedDomains, native launcher, Remote Control 교차검증 추가
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

2026-04-17

반영한 공식 변경(요약)

Opus 4.7 / xhigh / Max Auto mode 경로 정리 (v2.1.111): xhigh effort, /effort 슬라이더, Max 사용자의 Opus 4.7 Auto mode 접근 경로 단순화 반영
신규 명령/스킬 반영 (v2.1.101, v2.1.108, v2.1.110, v2.1.111): /team-onboarding, /recap, /focus, /tui, /less-permission-prompts, /ultrareview
컨텍스트 복귀 UX 보강 (v2.1.108~v2.1.110): session recap 기본화와 /recap 수동 호출 경로 반영
훅/워크트리 운영 보강 (v2.1.105): PreCompact block 지원, EnterWorktree(path) 지원 반영
헤드리스/권한 운영 변경 (v2.1.111): stream-json init plugin_errors, 읽기 전용 glob Bash와 cd <project-dir> && ... 패턴의 권한 프롬프트 완화 반영
스킬 시스템 최신화 (v2.1.105, v2.1.108): Skill tool이 내장 슬래시 명령을 호출할 수 있는 점, 스킬 description listing cap 확대(1,536자) 반영
설치 경로 정리 (v2.1.111 + 최신 setup docs): 네이티브 인스톨러/Homebrew/WinGet 우선, npm deprecated 유지

영향 챕터

index.mdx — 기준일과 하이라이트를 v2.1.112 기준으로 갱신
setup.mdx — 설치 경로, 업데이트 채널, Opus 4.7/xhigh, Auto mode 최신 조건 반영
multi-session.mdx — EnterWorktree(path), scheduled task 복구 반영
hooks.mdx — PreCompact block 패턴 반영
skills-commands.mdx — 신규 명령, Skill tool-내장 명령 연결, description 예산 최신화
context.mdx — /recap, away summary/session recap 반영
headless.mdx — PowerShell 프리뷰 롤아웃, stream-json plugin_errors, 권한 프롬프트 완화 반영
ide.mdx — 이미지 첨부 UX 개선 반영
subagents.mdx — 최신 운영 메모 범위를 v2.1.112까지 확장
verification.mdx — 최신 안정 버전과 교차검증 항목 갱신
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

2026-04-12

반영한 공식 변경(요약)

/agents 실행 가시성 강화 (v2.1.97~v2.1.98): agent type 옆 ● N running 표시, Running/Library 탭, Library의 Run agent / View running instance 액션
/claude-api의 Managed Agents 확장 (v2.1.91, v2.1.97~v2.1.98): Claude API/SDK 예제뿐 아니라 agent design patterns, tool surface, context management, caching strategy, Managed Agents 설계 출발점 반영
권한/상태 전달 안정화 (v2.1.98): --dangerously-skip-permissions에서 team agent가 leader permission mode를 상속하고, 실패한 background subagent도 partial progress를 부모에 보고
격리 실행 안정화 (v2.1.97~v2.1.101): worktree isolation 또는 cwd: override가 부모 Bash 작업 디렉토리를 오염시키지 않도록 수정되고, isolated worktree subagent가 자기 worktree 파일을 Read/Edit 가능하도록 보강
도구 상속/복구 보강 (v2.1.101): 동적으로 주입된 MCP 서버의 도구가 subagent에도 상속되고, --resume 복구 시 무관한 subagent 대화 체인으로 연결되는 문제 수정

영향 챕터

index.mdx — 기준일과 하이라이트를 v2.1.101 기준으로 갱신
subagents.mdx — 최신 운영 메모(권한 전달, partial progress, MCP 상속, worktree 격리 안정화) 추가
skills-commands.mdx — /claude-api 설명을 Managed Agents까지 확장
verification.mdx — 최신 안정 버전과 agent 관련 교차검증 항목 갱신
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

2026-04-08

반영한 공식 변경(요약)

forceRemoteSettingsRefresh 정책 (v2.1.92): 원격 managed settings를 새로 받아오기 전까지 시작 차단, fetch 실패 시 종료하는 fail-closed 동작
Bedrock 로그인 마법사 (v2.1.92): 로그인 화면의 "3rd-party platform" 경로에서 AWS 인증/리전/모델 pinning 안내
/cost 세분화 (v2.1.92): 구독 사용자에게 모델별 사용량과 cache-hit breakdown 제공
/release-notes 인터랙티브 버전 피커 (v2.1.92): 특정 버전 릴리스 노트 탐색 UX 개선
/tag / /vim 제거 (v2.1.92): 각각 세션 태그 명령과 Vim 토글 명령 제거, vim은 /config → Editor mode로 대체
/powerup (v2.1.90): 애니메이션 데모가 포함된 대화형 학습 명령
disableSkillShellExecution (v2.1.91): skills/custom commands/plugin commands의 inline shell 실행 비활성화
플러그인 bin/ 실행 파일 (v2.1.91): Bash 도구에서 bare command처럼 호출 가능
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE (v2.1.90): 오프라인 환경에서 마켓플레이스 캐시 유지
MCP 결과 보존 override (v2.1.91): _meta["anthropic/maxResultSizeChars"]로 최대 500K자까지 결과 유지
MCP_CONNECTION_NONBLOCKING=true (v2.1.89): -p 실행에서 MCP 연결 대기 생략, --mcp-config 연결 5초 상한
PreToolUse defer 결정 (v2.1.89): 헤드리스 세션을 도구 호출 시점에서 일시 정지 후 -p --resume으로 재평가
Remote Control hostname prefix (v2.1.92): 세션 이름 기본 prefix가 호스트명으로 변경, flag로 오버라이드 가능
멀티라인 claude-cli://open?q= 딥링크 (v2.1.91): %0A 줄바꿈 지원
Linux apply-seccomp helper (v2.1.92): npm/네이티브 설치 모두 unix-socket 차단 복구
PowerShell 권한 검사 하드닝 (v2.1.90): background 우회, debugger hang, archive extraction 관련 보안 보강

영향 챕터

index.mdx — 기준일과 하이라이트를 v2.1.92 기준으로 갱신
setup.mdx — Bedrock 마법사, forceRemoteSettingsRefresh, Auto 모드 Recent 재시도 반영
hooks.mdx — PreToolUse defer, 대용량 훅 출력 디스크 저장 반영
mcp.mdx — nonblocking 연결, 결과 보존 크기 override 반영
skills-commands.mdx — /powerup, disableSkillShellExecution, 플러그인 bin//캐시 운영 반영
context.mdx — Edit 도구 토큰 절감, prompt cache 만료 복귀 힌트 반영
ide.mdx — 멀티라인 딥링크 반영
headless.mdx — Linux 샌드박스 helper, PowerShell 하드닝, Remote Control prefix 반영
verification.mdx — 최신 버전/교차검증 항목 갱신
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

2026-03-31

반영한 공식 변경(요약)

Auto 모드 (2026-03-24): AI 분류기가 도구 호출 위험도를 평가, 안전 작업 자동 진행/위험 작업 차단. default와 bypassPermissions 중간 지점
Computer Use (2026-03-24, 연구 프리뷰): macOS 화면 제어(마우스/키보드). Pro/Max 전용, Desktop 앱에서 활성화
Dispatch (2026-03-17): iPhone에서 작업 전송 → 데스크탑 자동 실행 → 완료 알림 수신. 전 플랜 사용 가능
PowerShell 도구 (v2.1.84): Windows 네이티브 PowerShell 도구 opt-in 프리뷰
PermissionDenied 훅 (v2.1.88): Auto 모드 분류기 거부 시 발생, {retry: true} 응답으로 재시도 가능
CwdChanged / FileChanged 훅 (v2.1.83): 작업 디렉토리 변경 및 파일 변경 감지 이벤트
TaskCreated 훅 (v2.1.84): 태스크 생성 시 발생하는 이벤트
조건부 if 필드 (v2.1.85): 훅에 퍼미션 규칙 구문으로 실행 조건 세밀 제어 (예: Bash(git *))
initialPrompt 에이전트 frontmatter (v2.1.83): 에이전트 생성 시 자동 프롬프트 제출
Named 서브에이전트 @ 타입어헤드 (v2.1.88): 이름 지정된 서브에이전트를 @ 멘션으로 빠르게 선택
MCP OAuth RFC 9728 (v2.1.85): Protected Resource Metadata 디스커버리 지원
MCP 서버 중복 제거 (v2.1.84): 로컬 설정이 claude.ai 커넥터보다 우선
MCP 도구 설명 2KB 제한 (v2.1.84): 도구 설명/서버 지시문 크기 제한
스킬 paths: frontmatter (v2.1.84): YAML 리스트로 glob 패턴 지정, 경로 기반 활성화
스킬 설명 250자 제한 (v2.1.86): /skills 메뉴 알파벳순 정렬
Thinking summaries 기본 비활성화 (v2.1.88): showThinkingSummaries: true로 복원 가능
managed-settings.d/ 드롭인 디렉토리 (v2.1.83): JSON 파일 드롭인으로 managed settings 조합
sandbox.failIfUnavailable (v2.1.83): 샌드박스 없는 환경에서 실행 거부 강제
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 (v2.1.83): 서브프로세스 자격증명 환경변수 제거
CLAUDE_CODE_NO_FLICKER=1 (v2.1.88): alt-screen 렌더링 깜빡임 제거
트랜스크립트 검색 (v2.1.83): Ctrl+O → / 키로 대화 내용 검색, n/N으로 탐색
Read 도구 압축 포맷 (v2.1.86): 압축된 줄번호 + 중복 읽기 제거
@ 멘션 토큰 오버헤드 감소 (v2.1.86): 파일 멘션 시 토큰 효율 향상
X-Claude-Code-Session-Id 헤더 (v2.1.86): API 요청에 세션 ID 자동 포함
CLAUDE_STREAM_IDLE_TIMEOUT_MS (v2.1.84): 스트리밍 유휴 타임아웃 설정 (기본 90초)
PreToolUse updatedInput 응답 (v2.1.85): AskUserQuestion 입력 자동 대체
PreToolUse/PostToolUse file_path 절대 경로 (v2.1.88): 훅 입력의 파일 경로 정규화
유휴 복귀 프롬프트 (v2.1.84): 75분 이상 유휴 시 /clear 제안
.jj/.sl VCS 제외 (v2.1.86): Jujutsu, Sapling VCS 지원
프롬프트 캐시 미스 수정 (v2.1.88), 중첩 CLAUDE.md 중복 주입 수정 (v2.1.88), StructuredOutput 스키마 캐시 수정 (v2.1.88)

영향 챕터

index.mdx — updatedAt 갱신, 하이라이트에 Auto 모드/Dispatch/Computer Use/PowerShell 추가
setup.mdx — Auto 모드, managed-settings.d/, sandbox.failIfUnavailable, thinking summaries, 렌더링 최적화
hooks.mdx — PermissionDenied, CwdChanged, FileChanged, TaskCreated 이벤트, 조건부 if 필드, PreToolUse 고급 응답
subagents.mdx — initialPrompt frontmatter, @ 멘션 타입어헤드
mcp.mdx — RFC 9728 OAuth, 서버 중복 제거, 도구 설명 제한, headersHelper 환경변수
skills-commands.mdx — paths: glob, 설명 250자 제한, 알파벳순 정렬
context.mdx — thinking summaries 비활성화, Read 도구 압축, @ 멘션 토큰 감소, 메모리 인터랙션
ide.mdx — Dispatch, Computer Use, Desktop 앱, 트랜스크립트 검색, 외부 에디터, 딥링크 개선
headless.mdx — PowerShell 도구, 세션 추적 헤더, 스트림 타임아웃
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
https://www.anthropic.com/engineering/claude-code-auto-mode (Auto Mode 엔지니어링 블로그)
https://claude.com/blog/dispatch-and-computer-use (Dispatch & Computer Use 블로그)

2026-03-25

반영한 공식 변경(요약)

Opus 4.6 기본 최대 출력 64k (v2.1.77): 기본 출력 토큰이 64k로 증가, 상한 128k
--bare 경량 실행 플래그 (v2.1.81): 스크립트용 -p 호출에서 hooks, LSP, 플러그인 동기화, 스킬 디렉토리 탐색을 건너뜀. ANTHROPIC_API_KEY 또는 apiKeyHelper 필요
--channels 연구 프리뷰 (v2.1.80): MCP 서버가 세션에 메시지를 직접 푸시 가능
--channels 퍼미션 릴레이 (v2.1.81): 채널 서버가 도구 승인 프롬프트를 폰으로 전달
MCP OAuth CIMD (SEP-991) (v2.1.81): Client ID Metadata Document 지원
/fork → /branch 이름 변경 (v2.1.77): /fork는 별칭으로 유지
Agent resume 파라미터 제거 (v2.1.77, Breaking): SendMessage({to: agentId}) 방식으로 대체
StopFailure 훅 이벤트 (v2.1.78): API 에러로 턴이 종료될 때 발생
effort frontmatter (v2.1.80): 스킬/슬래시 커맨드/플러그인 에이전트에서 effort 레벨 오버라이드
--console 인증 (v2.1.79): claude auth login --console로 API 빌링 인증
ANTHROPIC_CUSTOM_MODEL_OPTION (v2.1.78): /model 피커에 커스텀 항목 추가
source: 'settings' 플러그인 (v2.1.80): settings.json에서 인라인 플러그인 선언
VS Code /remote-control (v2.1.79): claude.ai/code에 브릿지 세션
VS Code AI 세션 제목 (v2.1.79): 첫 메시지 기반 자동 제목 생성
rate_limits 상태 표시줄 (v2.1.80): 5시간/7일 rate limit 사용량 표시
worktree 세션 재개 자동 전환 (v2.1.81): --resume으로 worktree 세션 재개 시 자동 복귀
--resume 성능 개선 (v2.1.77): 최대 45% 빠른 로딩, ~100-150MB 메모리 절감
macOS 시작 ~60ms 빠르게 (v2.1.77), 시작 시 ~80MB 메모리 절감 (v2.1.80)
줄단위 응답 스트리밍 (v2.1.78): 응답이 생성되는 대로 줄 단위 스트리밍
! bash 모드 발견성 개선 (v2.1.81)
Voice mode WebSocket 복구 (v2.1.81): 연결 끊김 시 자동 복구
PreToolUse "allow" 보안 수정 (v2.1.77): deny 퍼미션 규칙이 정상 적용
/copy N (v2.1.77): N번째 최근 응답 복사
"Show turn duration" 토글 (v2.1.79): /config에서 턴 소요 시간 표시
Plan 모드 "clear context" 기본 숨김 (v2.1.81)

영향 챕터

index.mdx — updatedAt 갱신, 하이라이트에 v2.1.77-81 주요 기능 추가
setup.mdx — Opus 64k 출력, 커스텀 모델, effort auto 표시, rate_limits, --console, turn duration
hooks.mdx — StopFailure 이벤트, CLAUDE_PLUGIN_DATA, PreToolUse 보안 수정
mcp.mdx — Channels 신규 섹션, OAuth CIMD, 도구 호출 접기, deny 규칙
multi-session.mdx — /branch 이름 변경, worktree 자동 전환, 세션 자동 이름, --resume 성능
subagents.mdx — Agent resume 제거(Breaking), 플러그인 에이전트 frontmatter
skills-commands.mdx — /copy N, /branch, effort frontmatter, 플러그인 관리
headless.mdx — --bare 플래그, VS Code remote-control, Remote Control 안정성
context.mdx — progress message compaction 개선, 백그라운드 bash 5GB 제한
ide.mdx — VS Code remote-control, AI 세션 제목, 플랜 탭 제목, Windows 호환성
vibe-coding.mdx — /branch, 줄단위 스트리밍, ! bash 모드, Voice 안정성
plan-mode.mdx — clear context 기본 숨김
verification.mdx — 검증일 갱신, 교차검증 테이블 보강
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

2026-03-17

반영한 공식 변경(요약)

Opus 4.6 1M 컨텍스트 기본화 (v2.1.75): Max, Team, Enterprise 플랜에서 Opus 4.6의 1M 컨텍스트 윈도우가 기본 활성화. 기존 Fast mode 한정이었던 것이 모든 모드로 확대
MCP elicitation 지원 (v2.1.76): MCP 서버가 작업 중간에 구조화된 입력을 사용자에게 요청 가능. Elicitation/ElicitationResult 훅 이벤트 추가
PostCompact 훅 이벤트 (v2.1.76): compaction 완료 후 발생하는 훅으로 로깅/알림 자동화에 활용
-n/--name 세션 이름 플래그 (v2.1.76): CLI에서 세션 표시 이름을 부여 가능
worktree.sparsePaths (v2.1.76): worktree 모드에서 git sparse-checkout 활성화, 대규모 모노레포에서 worktree 생성 속도 개선
/color 프롬프트 바 색상 (v2.1.75): 세션별 프롬프트 바 색상 커스터마이징
메모리 파일 last-modified 타임스탬프 (v2.1.75): 메모리 파일에 마지막 수정 시각이 기록되어 오래된 메모리를 식별하기 쉬워짐
훅 출처 표시 (v2.1.75): 권한 프롬프트에서 훅이 어디에서 왔는지 표시
Windows managed settings 경로 제거 (v2.1.75, Breaking): deprecated된 C:\ProgramData\ClaudeCode\ 경로가 제거됨
deferred tools compaction 버그 수정 (v2.1.76): deferred tools가 compaction 후 스키마를 잃는 문제 수정
자동 compaction 회로 차단기 (v2.1.76): 자동 compaction이 3회 초과 시도되지 않도록 제한
세션 품질 설문 (v2.1.76): Enterprise 관리자용 세션 품질 피드백 메커니즘 추가

영향 챕터

index.mdx — updatedAt 갱신, 하이라이트에 1M 기본화/MCP elicitation 추가
setup.mdx — 1M 컨텍스트 기본, -n 플래그, Windows managed settings 제거
mcp.mdx — MCP elicitation 신규 섹션
hooks.mdx — PostCompact, Elicitation, ElicitationResult 훅 추가
context.mdx — 1M 컨텍스트 기본화 문구 갱신
multi-session.mdx — worktree.sparsePaths 섹션 추가
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

2026-03-14

반영한 공식 변경(요약)

Sonnet 4.6 모델 출시(2026-02-17) 및 Sonnet 4.5→4.6 자동 마이그레이션 반영
Enterprise 플랜 정보 추가 ($20/좌석 + 사용량 기반, SCIM, 감사 로그)
/model 피커 읽기 좋은 라벨 표시 + 업그레이드 힌트 (v2.1.51) 반영
/copy 인터랙티브 피커 + w 키 파일 쓰기 (v2.1.59, v2.1.72) 반영
/color 세션 색상 변경 (v2.1.70), /rename 세션 이름 변경 (v2.1.70) 반영
/output-style deprecated 안내 추가 (v2.1.73, /config 대체)
Voice STT 20개 언어 지원 (v2.1.69), voice:pushToTalk 키바인딩 커스터마이즈 (v2.1.71) 반영
음성 인식 정확도 개선: 레포명, 개발 용어 (v2.1.72) 반영
effort 레벨 기호 표기 (○ ◐ ●) 명시
검증 리포트 교차검증 섹션 대폭 보강 (모델/버전 + 주요 기능 13개 항목)
index.mdx 하이라이트에 Sonnet 4.6, Code Review, Remote Control 추가
Code Review 연구 프리뷰 신규 섹션: 멀티에이전트 PR 리뷰, REVIEW.md 커스터마이즈, 심각도 레벨, 요금( $15~$ 25/리뷰)
Remote Control 섹션 대폭 확장: 전 플랜 사용 가능, 보안 모델, 자동 활성화 설정
REVIEW.md 개념 소개 (claude-md.mdx)
/security-review 번들 커맨드 추가

영향 챕터

index.mdx — updatedAt 갱신, 하이라이트에 Code Review/Remote Control 추가
setup.mdx — Sonnet 4.6, Enterprise 플랜, /model 피커 개선
claude-md.mdx — REVIEW.md 섹션 추가
skills-commands.mdx — /copy, /color, /rename, /security-review, /output-style deprecated
headless.mdx — Code Review 신규 섹션, Remote Control 대폭 확장
vibe-coding.mdx — Voice 20개 언어, pushToTalk, effort 기호
verification.mdx — 교차검증 테이블 보강, 링크 추가, 검증일 갱신
updates.mdx — 본 기록 추가

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
https://github.com/anthropics/claude-code/releases
https://code.claude.com/docs/en/code-review (Code Review 공식 문서)
https://code.claude.com/docs/en/remote-control (Remote Control 공식 문서)
https://www.anthropic.com/news (Sonnet 4.6, 2026-02-17)
https://claude.com/ko-kr/pricing (Enterprise 플랜)

2026-03-13

반영한 공식 변경(요약)

v2.1.74 기준 최신 반영 (기존 v2.1.39 → v2.1.74, 35개 버전)
Worktree 격리 시스템: --worktree 플래그(v2.1.49), EnterWorktree/ExitWorktree(v2.1.72), isolation: "worktree" 에이전트 정의(v2.1.50)
추론 강도 제어: /effort 명령(v2.1.72), "ultrathink" 키워드(v2.1.68), Opus 4.6 medium 기본값(v2.1.68)
자동화 확장: /loop 크론 스케줄(v2.1.71), HTTP hooks(v2.1.63), 신규 훅 이벤트 4종(ConfigChange, InstructionsLoaded, WorktreeCreate/Remove)
컨텍스트 최적화: /context 액셔너블 제안(v2.1.74), 자동 메모리 기록(v2.1.59), 도구 결과 디스크 저장 임계값 50K(v2.1.51)
VS Code 강화: MCP 관리 다이얼로그(v2.1.70), 플랜 마크다운 뷰(v2.1.70), 스파크 아이콘 세션 목록(v2.1.70)
MCP 고도화: OAuth step-up auth(v2.1.49), 바이너리 콘텐츠 처리(v2.1.69), claude.ai 커넥터(v2.1.63)
/fork(v2.1.71), /color(v2.1.70), /rename(v2.1.70), CLAUDE.md HTML 주석 숨김(v2.1.72) 등 다수 기능 반영

영향 챕터

전 챕터(Ch1~Ch12) 업데이트
index.mdx 버전 기준일 및 하이라이트 갱신

근거 링크(공식/공개)

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

2026-02-11

반영한 공식 변경(요약)

v2.1.39 기준 최신 안정화 반영
- 중첩 Claude Code 세션 실행 방지 가드
- MCP 이미지 스트리밍 크래시 수정, /resume 미리보기 가독성 개선
- 터미널 렌더링 성능/안정성 개선
v2.1.36~v2.1.33 큰 변화 반영
- Opus 4.6 대상 Fast mode 지원
- Agent Teams 실험 기능 이후 다중 에이전트 운영 기능 확장
- 신규 Hook 이벤트 TeammateIdle, TaskCompleted
- 에이전트 tools에서 Task(agent_type) 제한 지원
- 에이전트 memory frontmatter(user/project/local) 지원
v2.1.32 반영
- 자동 메모리 기록/재호출
- 메시지 선택기 “Summarize from here” 추가
- --add-dir 경로의 .claude/skills/ 자동 로드
v2.1.30 운영 기능 반영
- Read 도구 PDF pages 파라미터 지원
- MCP OAuth 비DCR 서버용 --client-id, --client-secret 지원
- /debug 명령 도입
- Task 결과에 토큰/도구 사용 수/소요 시간 메트릭 추가
- --resume 메모리 사용량 개선(릴리스 노트 기준 68% 절감)
v2.1.27 반영
- --from-pr로 PR 기반 세션 재개
- gh pr create로 생성한 세션의 PR 자동 연결
v2.1.18 반영
- /keybindings 기반 단축키 커스터마이징
v2.1.15 반영
- npm 설치 경로 deprecation 안내(claude install/공식 설치 스크립트 권장)

사람들 반응이 큰 항목 (GitHub 공개 이슈 반응 기준)

단축키 커스터마이징 수요: #9177 (reactions 19), #5376 (reactions 34)
Agent Teams 확장 수요: #23574 (reactions 18), #24122 (reactions 15)

참고: “반응”은 공개 이슈의 댓글/리액션 수로 간접 판단했습니다.

영향 챕터

index.mdx
subagents.mdx
hooks.mdx
mcp.mdx
headless.mdx
meta.json

근거 링크(공식/공개)

업데이트 기록 템플릿

아래 형식을 복사해 새 기록을 추가하세요.

### YYYY-MM-DD

**반영한 공식 변경(요약)**

- ...

**사람들 반응이 큰 항목 (선택)**

- ...

**영향 챕터**

- ...

**근거 링크(공식/공개)**

- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

On this page

업데이트 내역

On this page