업데이트 내역

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년 9월 12일 재검증 기준 (v2.1.269)

운영 원칙

근거 기반 반영: 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-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년 9월 12일 재검증 기준 (v2.1.269)

운영 원칙

근거 기반 반영: 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