릴리스 반영 이력

Claude Code: 날짜별 릴리스 반영 내역과 핸드북 업데이트 결정을 현재 사용법과 구분해 보존합니다.

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 v2.1.293~v2.1.296 반영

공식 Changelog의 **v2.1.293(10월 7일)~v2.1.296(10월 9일)**을 대조했습니다. 공식 slash 표는 119행 그대로이고 /doctor·/mcp·/scroll-speed 3개 행의 설명만 바뀌었습니다. CLI 표는 claude daemon logs·claude daemon run이 추가돼 34행에서 36행이 됐습니다. flag 표는 80행 그대로이고 --max-budget-usd·--mcp-config·--forward-subagent-text의 설명이 바뀌었습니다.

Haiku 5.5(v2.1.293): claude-haiku-5-5가 Anthropic API의 기본 Haiku가 됐습니다(1M context, 128K output). 단가는 prompt가 100,000 token 이하일 때 $0.10/$0.50, 넘으면 $0.50/$2.50입니다. Claude Code에서의 기본 effort는 medium이고 thinking을 끌 수 없습니다. Claude Platform on AWS·Bedrock·Google Cloud Agent Platform·Foundry의 haiku는 Haiku 4.5 그대로입니다. v2.1.296은 일부 gateway 뒤에서 실패하던 Haiku 5.5 token count를 고쳤습니다.
비용 표시(v2.1.296): /cost, status line, --max-budget-usd, SDK 비용 수치가 Sonnet 5.5 cache read를 $0.10/MTok로 계산합니다(이전 $0.20). 공식 가격표의 Sonnet 5.5 cache read도 $0.10/MTok이므로, 아래 2026-10-07 항목의 $0.20은 이 값으로 바로잡습니다. 공식 CLI reference의 --max-budget-usd 설명에는 지출이 상한을 넘을 수 있으니 여유를 두라는 문구가 들어갔습니다.
hook: command·HTTP hook에 onFailure: "block"이 추가됐습니다. 시작하지 못하거나 timeout에 걸리거나 예상 밖의 코드로 끝난 hook이 동작을 통과시키지 않고 막습니다(v2.1.295). Stop·SubagentStop의 prompt hook은 "빌드가 깨졌으면 계속하라" 같은 지시문으로 써도 Claude가 일찍 멈추는 일이 줄도록 판정이 개선됐습니다(v2.1.294). --debug는 tool call·prompt·SessionStart·Stop의 command hook이 끝날 때 command·plugin·결과·소요 시간을 기록합니다(v2.1.296).
subagent: subagent frontmatter와 --agents 정의에 autoCompactWindow가 추가돼 메인 대화의 window보다 일찍 auto-compact할 수 있습니다(v2.1.296). skills 필드로 미리 싣는 skill은 최대 32개이고(v2.1.295), subagentStatusLine payload에 agentType이 들어갑니다(v2.1.293). --debug는 custom agent 파일에서 인식하지 못한 frontmatter 필드 이름을 알려 줍니다(v2.1.296).
MCP: 처음부터 보내는 MCP tool description과 server instructions의 기본 한도가 2,048자에서 4,096자로 늘었습니다(v2.1.296). tool search로 불러오는 tool description은 2,048자가 아니라 16,384자에서 잘립니다(v2.1.295). WebSocket(ws) 서버는 16 MiB를 넘는 메시지를 파싱하지 않고 연결을 닫습니다(v2.1.295). feature flag를 가져오지 않는 설치본에서는 claude.ai connector도 protocol 2026-07-28을 기본으로 협상하며 MCP_PROTOCOL_NEGOTIATION=legacy로 끕니다(v2.1.295).
background·입력: ←로 세션을 background로 옮기는 도중에 시작된 턴이나 ! 명령은 보이지 않는 곳에서 끝나지 않고 중단됩니다(v2.1.296). ←가 현재 도구를 기다리는 동안 턴을 멈추면 "Backgrounding cancelled"가 표시됩니다(v2.1.295). attach한 background 세션의 빈 프롬프트에서 Ctrl+C는 예약된 /loop wakeup을 건드리지 않고, loop는 Esc로 멈춥니다(v2.1.295). /copy 선택기에는 인용문이 추가돼 메시지 초안을 > 표시 없이 복사합니다(v2.1.295).
CLI·plugin: claude plugin install·enable·disable·marketplace add는 기록할 settings 파일이 로드되지 않으면 경고합니다. claude plugin validate는 plugin README에 설치 안내 줄이 없으면 붙여 넣을 줄을 출력하며, --strict에서도 종료 코드는 바꾸지 않습니다(이상 v2.1.295).
설정·환경 변수: CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS(v2.1.295), CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS, CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL(이상 v2.1.296)이 추가됐습니다. managed settings가 없는 머신에서는 user settings의 forceLoginMethod: "gateway"와 forceLoginGatewayUrl로 /login이 해당 Claude apps gateway에서 열리게 할 수 있습니다(v2.1.295).
도구·터미널: Read 도구에 allow_large 옵션이 추가됐고(v2.1.296), Grep은 -l·-c·-r 플래그가 붙은 검색을 실패시키지 않고 실행합니다(v2.1.295). Program Status Protocol(OSC 7501)을 구현한 터미널은 Claude Code가 작업 중인지, 입력을 기다리는지, 끝났는지 표시할 수 있습니다(v2.1.295).
되돌려진 변경(v2.1.293): v2.1.281의 auto mode 거부 메시지 변경이 되돌려졌습니다. claude.ai skill 동기화는 사용 중인 세션이 없을 때 10분이 아니라 약 40분마다 변경을 확인합니다.

근거: Changelog, Model configuration, Hooks, Subagents, CLI reference, Haiku 5.5 overview, Pricing.

2026-10-07 v2.1.284~v2.1.292 반영

공식 Changelog의 **v2.1.284(9월 28일)~v2.1.292(10월 6일)**을 대조했습니다(v2.1.291은 변경 항목 없이 공개됨). 공식 slash 표는 114행에서 119행으로 늘었고 6개 행의 문법이 바뀌었습니다. CLI 표는 3개 행의 문법이 바뀌었고 flag 표에 --desktop이 추가됐습니다.

Sonnet 5.5(v2.1.284): claude-sonnet-5-5가 Anthropic API의 기본 Sonnet이 됐습니다(1M context, $2/$ 10, cache read $0.20). Claude Code에서의 기본 effort는 medium이고 thinking을 끌 수 없습니다. 사이버보안 플래그는 Sonnet 5로 재실행하고 생물학 플래그는 거절로 끝납니다. auto mode classifier는 Sonnet 5.5·Opus 5.5를 가리키는 Sonnet pin을 무시하고 Sonnet 5를 씁니다(v2.1.288).
Ultracode·effort: Ultracode가 /effort의 별도 토글이 되어 xhigh를 강제하지 않습니다(v2.1.284). /effort ultracode [on|off]와 슬라이더의 Tab 토글이 추가됐고, effortSlider:* keybinding action으로 다시 묶을 수 있습니다. 플래그에 따른 자동 모델 전환은 현재 effort를 유지하고(v2.1.287), Agent 도구에 effort 인자가 추가돼 subagent를 요청한 레벨로 실행합니다(v2.1.292).
권한 모드: 권한 모드를 설정하지 않은 대화형 터미널·VS Code 세션이 모든 플랜·provider에서 auto mode로 시작합니다. Changelog는 이를 v2.1.284에 적고 공식 Permission modes 문서는 v2.1.283 이상으로 적습니다. third-party provider·telemetry off 환경의 claude -p·Python Agent SDK 세션도 같은 기본값을 따릅니다(v2.1.285). auto mode의 작업 디렉터리 밖 읽기 prompt에 "Yes, but ask again next time"이 추가됐고(v2.1.284), 대화가 classifier 한도를 넘으면 도구 호출마다 묻는 대신 compact합니다(v2.1.288).
새 명령·문법: /mcp reconnect all(v2.1.284), /code-review·/review의 --max-findings <n>|all|default(v2.1.288), /claude-api managed-agents-onboard의 URL·quickstart 이름 인자(v2.1.290)가 추가됐습니다. 공식 표에는 /claude-api preserved-thinking-migration(v2.1.282+)과 /doctor [prompt-audit [path]]가 반영됐고, /artifact-capabilities, /artifact-diagramming(v2.1.221+), /claude-in-chrome [task], /plugin-authoring(v2.1.287+), /slides [brief](v2.1.265+)가 새로 올랐습니다. /rate-limit-options는 claude.ai 구독자의 /help와 명령 메뉴에 표시됩니다(v2.1.284).
동작이 바뀐 명령: /hooks는 이벤트별 단일 목록으로 열리고(v2.1.286), /tasks는 내부 작업을 "System tasks" 행으로 접습니다(v2.1.285). /recap은 채팅 thread·routine·webhook으로 전달되면 거절합니다(v2.1.284). /resume은 background에서 실행 중인 세션을 엽니다(v2.1.285). /autocompact는 window를 모델별로 저장합니다(v2.1.288). /memory는 background session에서 Auto-memory를 켤 수 없게 됐고, /claude-api는 Remote Control client에서 실행할 수 없습니다(둘 다 v2.1.285). /code-review medium은 tuned 설정이 없는 Opus 5.5·Sonnet 5.5에서도 cleanup·CLAUDE.md 규칙 finding을 보고합니다(v2.1.290). /ultrareview 출력에서 브라우저 링크가 빠졌습니다(v2.1.286).
CLI: claude --desktop, claude plugin configure <plugin>, claude plugin install --config <server>.<key>=<value>(모두 v2.1.285), claude plugin install --marketplace <source>(v2.1.292)가 추가됐습니다. claude project purge는 claude purge로 바뀌었고 이전 이름도 동작합니다(v2.1.288). claude attach·claude logs는 ID 대신 세션 이름 일부를 받습니다(v2.1.290). --bare는 명령줄에 지정한 MCP 서버만 연결하고 system reminder와 background task 없이 실행합니다(v2.1.286).
MCP·plugin: 2025-11-25 protocol 서버의 URL prompt와 bareElicitationCapability, alwaysLoad: false의 전체 도구 지연(이상 v2.1.287), stdio 서버의 protocol 2026-07-28 기본 협상과 MCP_PROTOCOL_NEGOTIATION=legacy(v2.1.292)가 추가됐습니다. plugin이 더 깊은 동작을 바꾸는 Claude Mods와 내장 mod You should know가 들어왔습니다(v2.1.287).
설정·환경 변수: managed allowedProviders, CLAUDE_CODE_DISABLE_WEB_FETCH, CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES(이상 v2.1.285), CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR(v2.1.290), CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS(v2.1.292)가 추가됐습니다. 대화형 세션의 WebSearch 예산은 200회에서 끝나지 않고 시간당 100회씩 보충됩니다(v2.1.290). Bedrock·Vertex·Foundry·Claude apps gateway의 Opus 4.7 이상과 Fable은 [1m] 없이 1M context를 기본으로 씁니다(v2.1.287, CLAUDE_CODE_DISABLE_1M_CONTEXT=1이면 200K 유지).
background 명령 시간 제한: v2.1.285가 background Bash·PowerShell 명령에 시간 제한(기본 30분·최대 2시간)을 넣었고, v2.1.288이 이를 -p·Agent SDK·CI·cloud 같은 무인 세션으로 한정했습니다.

2026-09-26 v2.1.280~v2.1.283 반영

공식 Changelog의 **v2.1.280(9월 22일)~v2.1.283(9월 25일)**을 대조했습니다(v2.1.279는 공개되지 않음). 공식 slash·CLI·flag 표는 명령 이름·순서가 그대로이고 설명 문구만 바뀌었습니다.

Opus 5.5(v2.1.280): claude-opus-5-5가 기본 Opus가 됐습니다(1M context, $4/$ 20). Pro·Team Standard의 기본 모델도 Sonnet에서 Opus로 바뀌었습니다. 기본 effort는 medium이고, /effort가 모델별 저장으로 바뀌기 전의 최상위 effortLevel은 Opus 5.5 같은 신규 모델에 적용되지 않습니다. Opus 4.7·4.8·Fable 5의 기본 effort hold는 -p·SDK /effort와 명시 설정보다 우선하지 않게 됐습니다. fast mode 기본 모델도 Opus 5.5( $8/$ 40)입니다.
모델 제한(v2.1.283): managed deniedModels, availableModelsMatch: "exact"가 추가됐고, /model picker의 Opus 행에서 "(1M context)" 표기가 빠졌습니다.
명령: /doctor prompt-audit(/checkup prompt-audit, v2.1.283)이 추가됐습니다. /insights는 auto mode가 처리할 수 있었던 권한 prompt 수를 추정하고(v2.1.281), /deep-research의 긴 brief 안정성이 개선됐습니다(v2.1.281). /tasks에서 실행 중인 /ultrareview를 x로 멈추면 확인을 요청하고(v2.1.281), /ultrareview 실행 대화상자는 로컬 브랜치 리뷰 시 추적 파일의 미커밋 변경이 업로드될 수 있다고 안내합니다(v2.1.283). 메뉴와 /help에 남아 있던 "(removed)" /agents 항목은 삭제됐습니다(v2.1.281).
입력·키 바인딩: send now(ctrl+enter, ctrl+x ctrl+s)는 턴을 취소하지 않고 실행 중인 도구를 background로 옮깁니다(v2.1.281). 대화상자에서 y·n 한 글자는 더 이상 확인·닫기를 하지 않습니다. 이전 동작이 필요하면 keybindings.json에서 confirm:yes·confirm:no에 바인딩합니다(v2.1.280). /rewind·/diff 목록은 다른 목록과 같은 select:* 동작을 따르며 기존 messageSelector:*·diff:* 재바인딩도 유지됩니다(v2.1.283).
이름 공간·권한 모드: v2.1.282는 anthropic-skills·claude-ai 이름의 skill·command·workflow 로딩을 막았지만, v2.1.283에서 claude-ai 예약은 되돌려졌습니다. 권한 모드를 설정하지 않은 third-party provider·telemetry off 대화형 세션은 v2.1.283부터 auto mode로 시작합니다(permissions.defaultMode가 우선).
CLI·설정: --system-prompt·--append-system-prompt는 텍스트와 -file 형태를 함께 받습니다(v2.1.283). --agents는 -p에서 JSON 파일 경로를 받고(v2.1.281), maxProseWidth(v2.1.282)와 "attribution": false(v2.1.281) 설정이 추가됐습니다.

근거: Changelog, Model configuration, Fast mode, Opus 5.5 overview.

2026-09-22 공식 명령 재검증

공식 Commands 표 114항목(제거 이력 포함), CLI reference의 실행 형태 34개와 공통 플래그 79개를 대조했습니다. 릴리스 기준은 공식 Changelog의 **v2.1.278 (2026-09-19)**입니다. 이전 날짜의 npm 채널 값은 해당 시점의 기록이며 현재 채널 값으로 사용하지 않습니다.

/update-config [request]를 한·영 상세 페이지와 전체 목록에 추가했습니다. /agents·/review의 예전 설명, /design 최소 버전(v2.1.265), CLI 출력·예산 조건도 재대조했습니다.
/output-style [style]을 현재 공식 명령으로 복원하고 전체 목록과 상세 사용법을 추가했습니다.
/claude-api build-eval·hillclimb(v2.1.259+), /import cursor(v2.1.265+)를 반영했습니다.
plugin install/update의 --accept-command <sha256>(v2.1.271), /plugin install <plugin> --marketplace <source>(v2.1.275), runner의 --drain-marker-file <path>(v2.1.271)를 추가했습니다.
/config의 Project instructions와 AGENTS.md fallback(v2.1.277), /status의 Auto mode server 표시(v2.1.278), Remote 세션의 /fast(v2.1.271)를 갱신했습니다.

전체 슬래시 명령 · 터미널 CLI 참조

근거: 공식 Commands, CLI reference, Changelog.

아래는 이전 반영 시점의 기록입니다.

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, 관련 명령·운영 챕터의 한·영판. 아래 기록은 이전 검증 시점의 이력입니다.

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

npm 채널을 latest/next=2.1.261, stable=2.1.236으로 갱신하고 공식 Changelog v2.1.252~261, 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이 Claude Code v2.1.257부터 기본 Fable 모델이며 요구 버전은 v2.1.255 이상. fable·best alias가 Fable 5.1로 해석되고 Fable 5는 /model claude-fable-5로 선택. 단가·1M context·128K output·상시 adaptive thinking은 동일하고 prompt cache read만 $0.25/MTok(1/4). Claude apps gateway 세션은 gateway 호환을 위해 alias를 Fable 5로 유지
분류기 자동 fallback 표: Fable 5.1·5 생물학 → Opus 5, 사이버보안 → Opus 4.8, Opus 5 사이버보안 → Opus 4.8, Opus 5 생물학 → 거절. switchModelsOnFlag: false와 third-party ANTHROPIC_DEFAULT_OPUS_MODEL 조건을 /model에 추가
Fable 5.1 Messages API 차이: forced tool_choice 400, thinking block의 생성 모델 귀속, 이전 턴 편집 시 thinking 무효화(2026-08-31 이후 계정 강제)를 breaking change 표로 정리하고 per-message effort·turn-scoped system message·display: "updates"·content provenance를 additive로 반영. Mythos 5.1은 Project Glasswing 승인 고객 전용으로 구분
/effort에 v2.1.257 s 세션 한정 적용, --effort의 hold 세션 한정 해제, Opus 5·Fable 5.1의 default effort hold 부재, v2.1.260 Fable 5.1 effort 변경 시 prompt cache 유지를 반영
/fast에 Fable 5.1 미지원, Opus 4.7 fast mode 제거일(2026-07-24), 모델 전환 연동, VS Code fastMode·-p 제약을 반영
v2.1.260 /model picker Fable 5.1 노출 수정·tool result 후 prompt caching 수정·[1m] 태그 수정, v2.1.261 provider raw ID 대신 모델 이름 표시를 /model 주의사항에 추가
/diff는 기존 내장 명령이라 전체 참조 110개 기준을 유지하고, v2.1.260이 추가한 fullscreen diff 패널 토글만 카탈로그와 상세 페이지 설명에 보강
/skill-doctor(v2.1.261)는 Changelog에만 있고 공식 Commands 표에는 아직 없어 미반영. --permission-prompts none·managedMcpServers·timeFormat·bashOutputMaxChars 등 모델 외 변경도 다음 명령 전수 대조 때 반영 예정

2026-08-30 (v2.1.248~v2.1.251 반영)

공식 Commands 표의 110개 항목을 전수 대조한 한·영 전체 명령 참조를 추가하고 자동 누락 검사를 도입
npm 채널을 latest/next=2.1.251, stable=2.1.236으로 갱신하고 공식 Changelog v2.1.248~251을 확인
/workflow-authoring, PreModelSwitch·PostModelSwitch, /usage spend-limit, /cost prompt-cache 지표, statusline 입력 확장을 반영
--restricted, top-level background session 서브커맨드, workflow·plugin·file tool의 symlink/path traversal 보강과 agent·Remote Control·MCP 수정 사항을 운영 문서에 반영

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

npm 채널을 latest=2.1.247, next=2.1.247, stable=2.1.231로 갱신하고 공식 Changelog v2.1.239~247을 확인
/usage loop 통계, /permissions Auto 모드 규칙 탭, Python 0.x→1.x /claude-api upgrade, Commands signature보다 앞선 release-tracked cost-optimize, Admin API 지원, SendFeedback 정확한 scope/값을 명령 운영 문서에 반영
/cd 대상 디렉터리 설정 즉시 적용, 서브에이전트 maxTurns 부분 결과와 기존 ID/이름 기반 재개, -p·SDK·cloud auto-continue를 반영
v2.1.242+ modelPicker·prompt-cache TTL의 scope/허용값, Changelog-only modelPricing, Sonnet 5 1M compaction, Bash wildcard·marketplace·gateway credential 보안을 현재 기준에 추가

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

npm 채널을 latest=2.1.237, next=2.1.237, stable=2.1.228로 갱신하고 공식 Changelog v2.1.221~237을 전수 확인
interactive fork mode·background subagent spawn 기본화, cross-session SendMessage/ListAgents와 @ 세션 멘션, 세션 누적 200개 제한 제거를 /fork·agent 운영 문서에 반영
ANTHROPIC_DEFAULT_MODEL, Concise output style, claude remote-control --continue, self-hosted runner, GitLab MR, plugin command/archive source를 현재 표면에 반영
최신 모델의 legacy Task/Todo 도구 기본 비활성화와 CLAUDE_CODE_ENABLE_TODO_TOOLS=1 호환 경로, worktree·sandbox·MCP OAuth·trust·Remote Control 보안 수정을 운영 기준에 추가

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

공식 Changelog, 로컬 CLI, npm dist-tag를 다시 확인해 v2.1.220 latest/next와 v2.1.212 stable 유지 확인
2026-08-01 이후 명령 추가·삭제·이름 변경이 없어 /branch·/fork·/subtask, /verify·/code-review 설명을 현행으로 유지
index·verification 및 Claude Code 고급 활용 한·영판에 재검증 기준일과 무변경 판정을 동기화

2026-08-01 (v2.1.206~v2.1.220 반영)

npm dist-tag와 로컬 CLI를 latest=2.1.220, stable=2.1.212, next=2.1.220으로 재확인하고 공식 Changelog v2.1.206~220을 반영
Opus 5를 Anthropic API의 opus alias와 native 1M context 기준으로 갱신하고 provider별 Opus/Sonnet matrix와 Claude Code v2.1.219 최소 버전을 추가
/fast 지원 대상을 Opus 5·Opus 4.8로 갱신하고 v2.1.219의 Opus 4.7 지원 제거를 반영
v2.1.212의 명령 역할 변경에 맞춰 /branch(전환), /fork(별도 background session), /subtask(현재 대화 내부 위임)를 분리
/verify·/code-review의 사용자 수동 호출 전환(v2.1.215)과 /code-review background subagent 실행(v2.1.218)을 반영
context: fork 스킬의 기본 background 실행, 기본 subagent 동시 20개·세션 누적 200개·3단계 nesting, DirectoryAdded, mcp_server_errors, strictAllowlist, sandbox.filesystem.disabled 운영 기준 추가

2026-07-19 (Fable 5 사용·API 폴백 보강)

2026-07-07 한시적 구독 포함량 종료 후 Pro·Max·Team·seat 기반 Enterprise의 usage credits 필요 조건을 현재형으로 갱신하고, Standard/Premium Enterprise와 API 소비 과금을 구분
Fable 5 거절이 HTTP 오류가 아니라 stop_reason: "refusal"을 포함한 HTTP 200 응답임을 명시하고, nullable stop_details와 Message Batches 감지 기준을 추가
서버 측 fallbacks, SDK refusal-fallback middleware, 수동 재시도의 적용 범위와 Claude Code fallbackModel availability chain의 차이를 정리
출력 생성 전 거절 무과금, 서버/SDK 자동 fallback credit, 수동 credit token 환급을 통한 prompt-cache 중복 비용 방지 기준을 추가
내부 추론 복사·전사 지시가 reasoning_extraction 거절과 Opus 폴백을 늘릴 수 있어 근거 요약·검증 결과·structured thinking block을 사용하도록 prompting 지침 보강

2026-07-10 (v2.1.202~v2.1.205 반영)

공식 Claude Code Changelog v2.1.202부터 v2.1.205까지와 npm dist-tag(latest=2.1.205, stable=2.1.197, next=2.1.206)를 교차 확인하고, 공개 변경 로그가 없는 next는 기준에서 제외
/workflows에 advisory Dynamic workflow size 설정과 workflow OTel 속성(workflow.run_id, workflow.name)을 추가
/review를 빠른 단일 패스 리뷰로 명확히 하고, 선택 effort의 멀티에이전트 리뷰는 /code-review <level> <PR>로 분리
/doctor를 전체 setup checkup으로 갱신하고 /checkup 별칭, 진단·수정 흐름을 반영
v2.1.203 Agent View/background/Remote Control/MCP roots 변경과 v2.1.204 headless hook 스트리밍 수정을 운영 기준에 추가
v2.1.205 Auto 모드 transcript 변조 차단, 불명확한 변수 대상 rm -rf 사전 질문, --json-schema invalid schema/format 수정 사항을 검증 기준에 추가

2026-07-04 (v2.1.198~v2.1.201 + Fable 5 재배포 반영)

공식 Claude Code Changelog v2.1.198부터 v2.1.201까지와 npm dist-tag(latest=2.1.201, stable=2.1.185)를 교차 확인
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에 전역 복원됨. 재배포 시 취약점 탐지 행위를 겨냥한 개선된 안전 분류기가 적용됨. Mythos 5는 안전 분류기 없이 Project Glasswing(미국 핵심인프라 방어 조직)으로만 재배포됨
Fable 5 플랜 사용: Pro·Max·Team·일부 Enterprise는 2026-07-07까지 주간 사용 한도의 최대 50%까지 Fable 5를 포함하고, 이후에는 usage credits로 사용하는 기준을 /model 운영 메모에 반영
/model 페이지에 Fable 5 재배포 이력·개선된 안전 분류기·Mythos 5 구분(Project Glasswing 초대 전용, /model 선택 불가)과 v2.1.201 Sonnet 5 mid-conversation system role 변경을 추가
명령 카탈로그에 v2.1.198 신규 /dataviz 스킬(데이터 시각화 생성)을 추가
v2.1.198 서브에이전트 기본 백그라운드 실행·Claude in Chrome GA, v2.1.199 SSL/스트리밍/서브에이전트 오류 처리 수정, v2.1.200 default permission mode의 표시 이름을 Manual로 변경, v2.1.201 Sonnet 5 mid-conversation system role 제거를 검증 기준에 추가

2026-07-01 (v2.1.191~v2.1.197 반영)

공식 Claude Code Changelog v2.1.191부터 v2.1.197까지와 npm dist-tag(latest=2.1.197, stable=2.1.185)를 교차 확인
/model 운영 기준에 Sonnet 5 기본화, Anthropic API sonnet alias의 Sonnet 5 해석, Pro·Team Standard·Enterprise subscription seat의 default → Sonnet 5 흐름을 반영
/effort 운영 기준에 Sonnet 5의 low/medium/high/xhigh/max 지원과 high 기본값을 추가
명령 카탈로그에 v2.1.196 조직 기본 모델(Org default/Role default)과 v2.1.197 Sonnet 5 모델 기준을 반영
운영 안정성 변경으로 .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 안정화를 검증 기준에 추가

2026-06-25 (v2.1.181~v2.1.190 반영)

공식 Claude Code Changelog v2.1.181부터 v2.1.190까지와 npm dist-tag(latest=2.1.190, stable=2.1.179)를 교차 확인
/model 운영 기준에 model restriction, Haiku main model 제한/subagent 허용, deprecated model warning을 추가
MCP 운영 기준에 claude mcp login/logout, CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT, misleading /mcp status 수정 메모를 반영
sandbox/permission 운영 기준에 sandbox.credentials, destructive command sandbox auto-approval, Windows PowerShell sandbox 수정, Agent deny rules, background permission prompt 안정화를 추가
background/subagent 운영 기준에 최대 3단계 nesting, nested agent 안정화, background agent worktree/comment/commit edge case 수정 반영
입력/자동화 안정성 변경으로 Korean paste mojibake fix, non-interactive fallback 안정화, output schema determinism, 앱/스키마 버그 수정 메모를 추가

2026-06-10 (v2.1.166~v2.1.170 반영)

공식 Claude Code Changelog v2.1.166부터 v2.1.170까지와 최신 Model configuration, Fable 5 모델 문서를 교차 확인
Fable 5 추가 반영: /model fable, fable alias, best alias의 Fable 우선 선택, Claude Code v2.1.170 요구 버전, ZDR/30일 data retention, adaptive thinking 상시 활성화, Fable 자동 Opus fallback 기준 추가
/advisor의 fable 모델 옵션과 /cd <path>의 세션 이동 동작(대화·prompt cache 유지, trust prompt, v2.1.246 대상 설정 즉시 적용)을 카탈로그에 반영
fallbackModel 설정과 claude --fallback-model availability fallback chain을 /model 운영 기준에 추가
--safe-mode를 Fable fallback 및 customization 격리 진단 경로로 반영하고, --bare와의 차이를 정리
disableBundledSkills, CLAUDE_CODE_DISABLE_BUNDLED_SKILLS, --disable-slash-commands, self-hosted runner post-session hook, VS Code 통합 터미널 transcript 저장 수정도 함께 반영
/effort 문서에 Fable 5의 high 기본값과 xhigh/max 지원을 추가하고, /fast 문서에는 Fable 5가 fast mode 대상이 아님을 명시
overview, index, 책장 요약(books-data.ts, home-server.ts)을 v2.1.170 기준으로 동기화

2026-05-29 (v2.1.132~v2.1.154 반영)

공식 Claude Code Changelog v2.1.132부터 v2.1.154까지와 최신 Commands, Model configuration, Agent View, Opus 4.8 발표를 교차 확인
Opus 4.8 출시 반영: Anthropic API opus alias, provider별 alias 차이, Claude Code v2.1.154 요구 버전, high effort 기본값, /effort xhigh, Opus 4.8 fast mode 기준 반영
신규/확장 명령 페이지 9개 추가: /workflows, /goal, /background//bg, /usage-credits, /reload-skills, /run, /verify, /run-skill-generator, /code-review
명령 카탈로그에 claude --bg --exec background job 흐름 추가
/model 페이지 최신화: /model 선택 저장 동작(v2.1.153), resume 모델 보존, full model name pinning, provider별 alias 정책 추가
/agents 페이지 최신화: Agent View, background sessions, shell background job, worktree isolation, claude agents flags, dynamic workflows 연결 반영
/simplify와 /code-review 역할 분리 반영: /simplify는 cleanup-only, correctness bug hunting은 /code-review로 정리
/extra-usage를 legacy로 낮추고 /usage-credits를 현재 명령 표면으로 반영
overview, index, 책장 요약(books-data.ts, home-server.ts)을 v2.1.154 기준으로 동기화

2026-05-06 (v2.1.116~v2.1.131 반영)

공식 Claude Code Changelog v2.1.116부터 v2.1.131까지와 최신 Commands, CLI reference, Skills, Fast mode, Routines 문서를 교차 확인
신규/확장 명령 페이지 8개 추가: /autofix-pr, /skills, /schedule, /theme, /fast, /desktop, /web-setup, claude project purge
custom-commands를 최신 Skills 구조 기준으로 재정리: .claude/commands 호환, .claude/skills 권장, $ARGUMENTS/${CLAUDE_EFFORT}/allowed-tools/invocation control 반영
기존 명령 페이지 최신화: /usage 중심으로 /cost·/stats 별칭 정리, /config 영구 저장, /model gateway discovery opt-in, /mcp tool count/alwaysLoad, /plugin prune·manifest warning, /color random/sync 반영
overview, verification, index, 책장 요약(books-data.ts)을 v2.1.131 기준으로 동기화

2026-04-20 (v2.1.113~v2.1.114 반영)

GitHub Releases v2.1.113, v2.1.114와 공식 Commands/Configuration 문서를 직접 교차 확인
현재 공식 명령 문서 명칭에 맞춰 /less-permission-prompts 표기를 /fewer-permission-prompts로 정리
/loop 페이지에 pending wakeup Esc 취소와 wakeup 메시지 UX 반영
/extra-usage 페이지에 Remote Control (mobile/web) 지원 반영
/sandbox 페이지와 검증표에 sandbox.network.deniedDomains 운영 포인트 반영
overview, verification, index, 책장 요약(books-data.ts)을 v2.1.114 기준으로 동기화

2026-04-17 (v2.1.105~v2.1.112 반영)

GitHub Releases v2.1.105, v2.1.108, v2.1.110, v2.1.111, v2.1.112와 공식 Commands 문서를 직접 교차 확인
신규 명령 페이지 6개 추가: /focus, /recap, /tui, /less-permission-prompts, /ultrareview, /team-onboarding
기존 페이지 최신화: /effort(xhigh, 슬라이더), /loop(self-pacing, .claude/loop.md, /proactive alias), /rewind(/undo alias), /review(로컬 리뷰 vs /ultrareview), /config, /ide, /add-dir, /compact
overview, meta.json, verification, index, 책장 요약(books-data.ts)을 v2.1.112 기준으로 동기화
카탈로그 설명을 “공식 전체 명령어 전수 목록”이 아니라 “핸드북이 다루는 주요 명령어” 기준으로 수정

2026-04-12 (v2.1.97~v2.1.101 agent 반영)

GitHub Releases 페이지를 직접 확인해 v2.1.97, v2.1.98, v2.1.101의 agent 관련 변경 반영
/agents 페이지에 ● N running 표시, Running/Library 탭, Run agent / View running instance 액션 반영
/claude-api 페이지에 Managed Agents 지원과 agent 설계 가이드 확장 반영
overview, verification, index, 책장 요약(books-data.ts)을 v2.1.101 기준으로 동기화

2026-04-08 (v2.1.89~v2.1.92 반영)

GitHub Releases 페이지를 직접 확인해 v2.1.89~v2.1.92 반영
신규 명령어 /powerup 페이지 추가 및 목차/카탈로그 반영
/release-notes 페이지를 v2.1.92 인터랙티브 버전 피커 기준으로 갱신
/cost 페이지에 구독 사용자용 모델별 사용량 / cache-hit breakdown 반영
/permissions 페이지에 Auto 모드 Recent 탭 재시도(r) 반영
/plugin 페이지에 bin/ 실행 파일, CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE 반영
제거된 /tag 명령 레거시 페이지 추가 및 카탈로그 반영
/vim 페이지를 removed 상태로 전환하고 /config → Editor mode 대체 경로 명시
/keybindings, /terminal-setup, /config의 /vim 참조 정리
index, overview, verification, meta.json, 책장 요약(books-data.ts) 동기화

2026-03-25 (v2.1.77~v2.1.81 반영)

Changelog v2.1.77~v2.1.81 반영
v2.1.77: /fork → /branch 이름 변경(별칭 유지), /copy N N번째 응답 복사, Opus 4.6 기본 출력 64k(상한 128k), --resume 45% 성능 개선, claude plugin validate frontmatter/hooks.json 검증, 세션 자동 이름(플랜 수락 시), Agent resume 파라미터 제거(Breaking), PreToolUse "allow" 보안 수정
v2.1.78: StopFailure 훅 이벤트, ${CLAUDE_PLUGIN_DATA} 변수, ANTHROPIC_CUSTOM_MODEL_OPTION 환경변수, deny: ["mcp__servername"] 수정, 줄단위 응답 스트리밍
v2.1.79: claude auth login --console API 인증, "Show turn duration" 토글, VS Code /remote-control 브릿지, AI 세션 탭 제목
v2.1.80: --channels MCP 메시지 푸시(연구 프리뷰), rate_limits statusline 필드, source: 'settings' 인라인 플러그인, /effort auto 해석값 표시, effort frontmatter 지원
v2.1.81: --bare 경량 실행 플래그, --channels 퍼미션 릴레이, MCP OAuth CIMD(SEP-991), MCP 도구 호출 1줄 접기, Plan 모드 "clear context" 기본 숨김, worktree 세션 재개 자동 전환, ref-tracked 플러그인 자동 재클론

2026-03-17 (v2.1.75~v2.1.76 반영)

Changelog v2.1.75~v2.1.76 반영
v2.1.76: MCP elicitation 지원, -n/--name 세션 이름 플래그, worktree.sparsePaths sparse-checkout, PostCompact 훅, /effort 슬래시 커맨드 기능, 세션 품질 설문(Enterprise)
v2.1.75: 1M 컨텍스트 윈도우 Opus 4.6 기본화(Max/Team/Enterprise), /color 프롬프트 바 색상 커스터마이징, /rename 세션 이름 표시, 메모리 파일 타임스탬프, 훅 출처 표시, Windows deprecated managed settings 경로 제거(Breaking)
deferred tools compaction 버그 수정, 자동 compaction 회로 차단기(3회 제한)

2026-03-13 (2차: v2.1.74 개선 반영)

/context 페이지에 v2.1.74 액셔너블 제안 기능 추가 (컨텍스트 과다 도구, 메모리 비대화, 용량 경고)
/plugin 페이지에 v2.1.74 마켓플레이스 수정 및 --plugin-dir 오버라이드 동작 변경 반영
/hooks 페이지에 v2.1.74 SessionEnd 훅 타임아웃 환경변수 설정 추가
overview 카탈로그에서 /context 반영 버전 갱신
verification에 v2.1.74 검증 항목 추가

2026-03-13 (1차: v2.1.70~v2.1.73 반영)

Changelog v2.1.70~v2.1.73 반영: 신규 명령어 7개 페이지 추가 (/loop, /effort, /fork, /color, /rename, /ide, /compact)
기존 명령어 10개 페이지 업데이트 (/context, /copy, /plan, /debug, /config, /model, /hooks, /plugin, /security-review, /resume)
/output-style deprecated 반영 (v2.1.73, /config 사용 권장)
overview 카탈로그에 신규 명령어 추가 및 deprecated 표기
심화 명령어 규모를 51개로 확장하고 목차(meta.json) 동기화
verification에 신규 항목 7개와 도입 버전 반영

2026-03-05

basic-commands-session 페이지 제거 및 관련 목차/링크 정리
Changelog 2.1.69 기준 신규 항목 /claude-api, /reload-plugins 심화 페이지 추가
심화 명령어 규모를 44개로 확장하고 목차(meta.json) 및 표지 목록 동기화
how-to-use-this-book에 official overview 기반 실전 예제 루틴(테스트/커밋/로그/보안리뷰/핸드오프) 보강
verification에 신규 항목 2개와 도입 버전(2.1.69) 반영
모든 심화 명령어 페이지(44개)에 최소 지원 버전 섹션 추가
overview를 주요 명령어 카탈로그(명령어/반영 버전/간단 설명) 형식으로 개편하고 최신 버전 우선 정렬 적용
목차 구분명을 심화 명령어에서 명령어로 통일

2026-03-01

신규 도서 Claude Code 명령어 마스터 생성
기본 묶음 페이지 2개 추가
심화 명령어 페이지 10개 추가
확장 페이지(custom-commands, mcp-commands) 추가
검증 리포트 페이지 추가
공식 인터랙티브 명령어 기준으로 /simplify 분류를 bundled skill로 보정
/review 원본 선언을 PR 대상 문법으로 보정
심화 명령어 페이지 12개 추가(/add-dir, /config, /cost, /doctor, /diff, /export, /pr-comments, /rewind, /sandbox, /security-review, /tasks, /statusline)
심화 섹션 규모를 22개로 확장하고 목차/책장 챕터 수 동기화
changelog 기준 누락 명령어 20개 추가(/context, /copy, /debug, /keybindings, /plan, /plugin, /release-notes, /settings, /stats, /terminal-setup, /todos, /upgrade, /usage, /vim, /remote-env, /teleport, /extra-usage, /batch, /commands, /approved-tools)
심화 섹션 규모를 42개로 확장하고 검증표에 버전/성격(내장/alias/legacy/bundled) 상태 반영
검증 페이지에 명령어별 최초 도입 버전/시기(UTC) 표 추가

업데이트 규칙

명령어 추가/변경 시 해당 명령 페이지와 이 문서를 같이 갱신
분류 상태 변경(내장/별칭/커스텀)은 verification과 동시 반영
변경 기록은 날짜 기준 역순으로 누적