업데이트 내역
Claude Code 명령어 마스터 핸드북 변경 이력을 관리합니다.
2026-08-03 (명령 변경 여부 재검증)
- 공식 Changelog, 로컬 CLI, npm dist-tag를 다시 확인해
v2.1.220latest/next와v2.1.212stable 유지 확인 - 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의
opusalias와 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-reviewbackground 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 응답임을 명시하고, nullablestop_details와 Message Batches 감지 기준을 추가 - 서버 측
fallbacks, SDK refusal-fallback middleware, 수동 재시도의 적용 범위와 Claude CodefallbackModelavailability 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-schemainvalid 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 기본 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 APIsonnetalias의 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.jsonself-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/mcpstatus 수정 메모를 반영 - 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,fablealias,bestalias의 Fable 우선 선택, Claude Codev2.1.170요구 버전, ZDR/30일 data retention, adaptive thinking 상시 활성화, Fable 자동 Opus fallback 기준 추가 /advisor의fable모델 옵션과/cd <path>의 세션 이동 동작(prompt cache 보존,CLAUDE.md메시지 추가, 세션 저장 위치 이동, trust prompt)을 카탈로그에 반영fallbackModel설정과claude --fallback-modelavailability fallback chain을/model운영 기준에 추가--safe-mode를 Fable fallback 및 customization 격리 진단 경로로 반영하고,--bare와의 차이를 정리disableBundledSkills,CLAUDE_CODE_DISABLE_BUNDLED_SKILLS,--disable-slash-commands, self-hosted runnerpost-sessionhook, 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
opusalias, provider별 alias 차이, Claude Codev2.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 --execbackground job 흐름 추가 /model페이지 최신화:/model선택 저장 동작(v2.1.153), resume 모델 보존, full model name pinning, provider별 alias 정책 추가/agents페이지 최신화: Agent View, background sessions, shell background job, worktree isolation,claude agentsflags, 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영구 저장,/modelgateway discovery opt-in,/mcptool count/alwaysLoad,/pluginprune·manifest warning,/colorrandom/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 wakeupEsc취소와 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,/proactivealias),/rewind(/undoalias),/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 NN번째 응답 복사, Opus 4.6 기본 출력 64k(상한 128k),--resume45% 성능 개선,claude plugin validatefrontmatter/hooks.json 검증, 세션 자동 이름(플랜 수락 시), Agentresume파라미터 제거(Breaking), PreToolUse"allow"보안 수정 - v2.1.78:
StopFailure훅 이벤트,${CLAUDE_PLUGIN_DATA}변수,ANTHROPIC_CUSTOM_MODEL_OPTION환경변수,deny: ["mcp__servername"]수정, 줄단위 응답 스트리밍 - v2.1.79:
claude auth login --consoleAPI 인증, "Show turn duration" 토글, VS Code/remote-control브릿지, AI 세션 탭 제목 - v2.1.80:
--channelsMCP 메시지 푸시(연구 프리뷰),rate_limitsstatusline 필드,source: 'settings'인라인 플러그인,/effortauto 해석값 표시,effortfrontmatter 지원 - 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.sparsePathssparse-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.74SessionEnd훅 타임아웃 환경변수 설정 추가- 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-styledeprecated 반영 (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과 동시 반영 - 변경 기록은 날짜 기준 역순으로 누적