본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Claude Code 고급 활용

기본 세팅

Ch1. 플랜 & 환경 설정Ch2. CLAUDE.md 마스터하기

멀티세션 & 에이전트

Ch3. 멀티세션 워크플로우Ch4. 서브에이전트 활용

자동화 & 확장

Ch5. Hooks 시스템Ch6. MCP 서버 연동Ch7. Skills & 슬래시 커맨드

워크플로우

Ch8. Plan 모드 활용Ch9. 컨텍스트 관리Ch10. IDE 통합Ch11. 헤드리스 & CI/CD

실전

Ch12. 바이브코딩 실전 패턴Ch13. 프롬프팅 베스트 프랙티스

검증

검증 리포트업데이트 내역
핸드북›Claude Code 고급 활용›검증 리포트
한국어English

검증 리포트

Claude Code 고급 활용 핸드북의 용어·링크·예제 정합성 검증 결과

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.

이번 검증은 공식 릴리스 원문과 npm 배포 채널의 대조입니다. 설치된 CLI 실행이나 신규 기능의 실서비스 검증을 뜻하지 않습니다. 아래 표는 이전 날짜의 검증 기록이며 현재 배포 채널은 위 값을 우선합니다.

이 문서는 Claude Code 고급 활용 핸드북의 내부 정합성과 외부 참고 링크 유효성을 검증한 결과입니다.

검증 기준일

2026년 9월 5일 기준으로 검증을 수행했습니다.

검증 방법론

네 단계로 콘텐츠 정합성을 점검했습니다.

1단계: 구조/용어 일관성

  • 챕터 제목과 소개 문구의 용어가 서로 일치하는지 확인
  • 동일 기능에 대해 다른 용어가 섞여 있는지 확인 (예: hooks/Hooks, headless/헤드리스)

2단계: 예제 검증

  • 코드 블록의 문법 오류(따옴표, 파이프, 백틱) 여부 점검
  • 문서 내 경로가 실제 디렉토리 구조와 충돌하지 않는지 확인

3단계: 링크 표기 규칙

  • 참고 문서 링크가 중복/오탈자 없이 일관적으로 표기되는지 확인
  • 링크 설명 뒤에 (한국어)/(영어) 표기를 일관 적용

4단계: 외부 링크 유효성

  • 참고 문서 링크가 실제로 접근 가능한지 확인
  • docs.claude.com → code.claude.com 리다이렉트 여부 확인

검증 결과 요약

항목결과
챕터 제목/설명 일관성이상 없음
명령어/플래그 표기이상 없음
코드 블록 문법이상 없음
링크 표기 규칙이상 없음
외부 링크 유효성이상 없음 (일부 문서 리다이렉트)

검증 결과

내부 정합성 기준에서는 불일치 항목이 발견되지 않았습니다.

공식 문서 교차검증 세부 내역

모델/버전 정보

항목핸드북공식 문서일치
최신 latest 버전v2.1.261Claude Code Changelog + npm latest dist-tagO
stable 채널 버전v2.1.236npm stable dist-tagO
next 채널v2.1.261npm next dist-tagO
Fable 5.1 출시2026-09-01, claude-fable-5-1Fable 5.1 overview + v2.1.257 changelogO
Fable 5.1 Claude Code 요구 버전v2.1.255 이상(v2.1.257부터 기본 Fable)model-config docs + changelogO
Anthropic API fable aliasFable 5.1(ANTHROPIC_DEFAULT_FABLE_MODEL 미설정 시), gateway 세션은 Fable 5model-config docs + v2.1.257 changelogO
Fable 5.1 단가10/10/10/50 per MTok, cache read 0.25/MTok,5mwrite0.25/MTok, 5m write 0.25/MTok,5mwrite12.50, 1h write $20Fable 5.1 overview + What's newO
Fable 5.1 breaking changeforced tool_choice 400, thinking block 모델 귀속, 이전 턴 편집 무효화(2026-08-31 이후 계정 강제)What's new + migration guideO
분류기 자동 fallback 표Fable 5.1·5 bio → Opus 5, cyber → Opus 4.8; Opus 5 cyber → Opus 4.8, bio → 거절; switchModelsOnFlagmodel-config docsO
Fable 5.1 effortlow~max, 기본 high, default effort hold 없음, v2.1.260 cache 유지model-config docs + changelogO
Fast mode Fable 5.1미지원(Opus 5·4.8만)fast-mode docsO
Mythos 5.1Fable 5.1과 동일 사양·단가, Project Glasswing 승인 고객 전용, 편집 검사 미실행Fable 5.1 overview + What's new + 발표O
Fable 5 상태legacy, still available, 은퇴 공지 없음models overview + 발표O
v2.1.252~v2.1.261 변경반영Fable 5.1, /effort s, CLAUDE_CODE_SUBAGENT_MODEL_FORCE, /diff, /skill-doctor, managedMcpServers, --permission-prompts none, 1M auto-compactO
v2.1.239~v2.1.247 변경반영usage loops, managed model/cache settings, subagent continuation, headless recovery, feedback, securityO
v2.1.221~v2.1.237 변경반영fork/cross-session/self-hosted/GitLab/default model/Concise/security fixesO
ANTHROPIC_DEFAULT_MODEL반영model-config docs + v2.1.236 changelogO
fork mode 기본값interactive on, -p/SDK offsub-agents docs + v2.1.232 changelogO
서브에이전트 예산동시 20, 기본 중첩 3단계, 누적 cap 없음sub-agents docs + v2.1.224 changelogO
Concise output style반영v2.1.237 changelogO
v2.1.206~v2.1.220 변경반영Opus 5, fork/subtask, subagent limits, sandbox controls, DirectoryAdded, headless/MCP signalsO
Opus aliasAnthropic API·Claude Platform on AWS·Bedrock·Google Cloud Agent Platform에서 Opus 5model-config docsO
Opus 5 요구 버전v2.1.219 이상model-config docsO
v2.1.202~v2.1.205 변경반영workflow size/OTel, review split, Agent View/background/MCP roots, headless hook, doctor/checkup, Auto/JSON SchemaO
v2.1.198~v2.1.201 변경반영Claude Code Changelog 2026-07-01~2026-07-03 (subagent 기본 백그라운드, /dataviz, 기본 permission mode Manual, Sonnet 5 mid-conversation system role 제거)O
Sonnet 5 기본화반영Claude Code v2.1.197 changelog + Sonnet 5 발표O
Sonnet 5 Claude Code 요구 버전v2.1.197 이상model-config docsO
Anthropic API sonnet aliasSonnet 5model-config docsO
Sonnet 5 1M contextnative 1M contextmodel-config docs + Sonnet 5 발표O
Sonnet 5 effortlow/medium/high/xhigh/max, 기본 highmodel-config docsO
v2.1.181~v2.1.190 운영 변경반영Claude Code Changelog 2026-06-13~2026-06-24O
Fable 5 추가반영Claude Code v2.1.170 changelog + model-config docsO
Anthropic API fable alias(v2.1.255 이전)Fable 5model-config docsO
best aliasFable 접근 가능 시 최신 Fable, 아니면 최신 Opusmodel-config docsO
Fable 5 Claude Code 요구 버전v2.1.170 이상model-config docsO
Fable 5 기본 모델 여부기본값 아님model-config docsO
Fable 5 retention/ZDR30일 data retention, ZDR 미지원Claude models overview + Fable launch docsO
Fable 5 thinkingadaptive thinking 상시 활성화, off 불가model-config docs + Fable launch docsO
Fable prompt caching envDISABLE_PROMPT_CACHING_FABLE 반영model-config docsO
Fable 자동 fallback기본 Opus로 재실행, /model fable로 복귀model-config docsO
Fable 5 재배포6-12 수출통제 중단 → 7-01 전역 복원Anthropic 재배포 성명 + Fable 5 소개 문서O
Fable 5 개선 분류기재배포 시 취약점 탐지 겨냥 안전 분류기 적용Anthropic 재배포 성명O
Mythos 5 구분안전 분류기 없음, Project Glasswing 초대 전용, /model 선택 불가Fable/Mythos 5 소개 문서 + models overviewO
Fable 5 플랜 사용Pro·Max·Team·일부 Enterprise 주간 한도 50%(~7-07) 후 usage creditsAnthropic 재배포 성명O
fallbackModel chain반영v2.1.166 changelog + model-config docsO
--safe-modeFable fallback/설정 디버그 기준으로 반영v2.1.169 changelog + model-config docsO
/cd 세션 이동cwd 이동, 대화·prompt cache 유지, trust prompt, 대상 설정 즉시 적용 반영Commands docs + v2.1.169/v2.1.246 changelogO
disableBundledSkills반영v2.1.169 changelog + env-vars docsO
Opus 5 출시반영Claude Code v2.1.219 + model-config docsO
Anthropic API opus aliasOpus 5model-config docsO
Claude Platform on AWS aliasopus Opus 5 / sonnet Sonnet 4.6model-config docsO
Bedrock/Google Cloud Agent Platform aliasopus Opus 5 / sonnet Sonnet 4.5model-config docsO
Microsoft Foundry aliasopus Opus 4.6 / sonnet Sonnet 4.5model-config docsO
Opus 5 Claude Code 요구 버전v2.1.219 이상model-config docsO
/model 기본 저장 동작v2.1.153부터 Enter가 user settings 기본값 저장model-config docsO
Opus 4.8 high 기본 + xhighhistorical로 반영v2.1.154 changelogO
Opus 4.7 xhighhistorical로 반영v2.1.111 release + commands/model-config docsO
Max 사용자의 Auto mode 경로 단순화반영v2.1.111 releaseO
Opus 4.6 medium 기본반영v2.1.68 releaseO
Sonnet 4.6 출시2026-02-17Anthropic 뉴스 + v2.1.69 자동 마이그레이션O
Opus 4/4.1 제거반영v2.1.68 releaseO
Bedrock/Vertex Opus 4.6반영v2.1.73 releaseO
modelOverrides 설정반영v2.1.73 releaseO
model restrictionsmain model은 Opus/Sonnet/Haiku/Fable family 중심, Haiku main 제한·subagent 허용v2.1.184 changelog + model-config docsO
deprecated model warning반영v2.1.187 changelogO

주요 기능

항목핸드북공식 문서일치
Agent View반영code.claude.com/docs/en/agent-view + v2.1.139 changelogO
/bg//background background sessions반영Agent View docs + Commands docsO
claude --bg --exec shell background job반영v2.1.154 changelog + Agent View docsO
Dynamic workflows + /workflows반영v2.1.154 changelog + Commands docsO
/goal 완료 조건 기반 장기 작업반영v2.1.139 changelog + Commands docsO
/usage-credits반영Commands docsO
/reload-skills반영Commands docsO
/run / /verify / /run-skill-generator반영Commands docsO
/code-review와 /simplify 역할 분리반영v2.1.154 changelog + Commands docsO
sandbox.credentials반영v2.1.186 changelogO
destructive command sandbox auto-approval반영v2.1.183 changelogO
Windows PowerShell sandbox fix반영v2.1.186 changelogO
claude mcp login/logout반영v2.1.187 changelogO
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT반영v2.1.185 changelogO
max 3 agent nesting반영v2.1.184 changelogO
Agent deny rules / background permission prompts반영v2.1.184~v2.1.186 changelogO
Korean paste mojibake fix반영v2.1.187 changelogO

2026-07-10 재검증 요약

항목검증 결과근거
최신 기준 v2.1.205확인공식 Changelog + npm latest dist-tag
stable 채널 v2.1.197확인npm stable dist-tag
next v2.1.206 기준 제외확인npm dist-tag에는 있으나 공개 changelog 없음
v2.1.202 workflow size/OTel 및 review split확인Changelog v2.1.202
v2.1.203 Agent View/background/MCP roots확인Changelog v2.1.203
v2.1.204 headless SessionStart hook streaming확인Changelog v2.1.204
v2.1.205 doctor/checkup·Auto·JSON Schema확인Changelog v2.1.205
Fable 5 재배포(6-12 중단 → 7-01 복원)와 개선 분류기확인Anthropic 재배포 성명 + Fable 5 소개 문서
Mythos 5 구분(Project Glasswing 초대 전용)확인Fable/Mythos 5 소개 문서
v2.1.198 subagent 기본 백그라운드 / /dataviz / Chrome GA확인Changelog v2.1.198
v2.1.200 기본 permission mode Manual확인Changelog v2.1.200
v2.1.201 Sonnet 5 mid-conversation system role 제거확인Changelog v2.1.201

2026-07-01 재검증 요약

항목검증 결과근거
최신 기준 v2.1.197확인공식 Changelog + npm latest dist-tag
stable 채널 v2.1.185확인npm stable dist-tag
Sonnet 5 기본화와 sonnet alias확인v2.1.197 changelog + model-config docs
Sonnet 5 native 1M context와 effort 레벨확인model-config docs + Sonnet 5 발표
조직 기본 모델(Org default/Role default)확인Changelog v2.1.196
.mcp.json self-approval 보안 보강확인Changelog v2.1.196
background/Remote/PowerShell/plugin 안정화확인Changelog v2.1.195~v2.1.196

2026-06-25 재검증 요약

항목검증 결과근거
최신 기준 v2.1.190확인공식 Changelog + npm latest dist-tag
stable 채널 v2.1.179확인npm stable dist-tag
MCP login/logout와 idle timeout확인Changelog v2.1.185, v2.1.187
sandbox credentials / destructive command / PowerShell sandbox확인Changelog v2.1.183, v2.1.186
model restriction/deprecation warning확인Changelog v2.1.184, v2.1.187
nested agent/background 안정화확인Changelog v2.1.184~v2.1.186
항목반영 상태근거문서 반영
--session-id반영v2.1.133 changelogO
--safe-mode반영v2.1.169 changelog + model-config docsO
--log-level반영v2.1.134 changelogO
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC반영v2.1.133 changelogO
worktree.bgIsolation반영Agent View docs + v2.1.143 changelogO
--worktree 플래그반영v2.1.49 releaseO
EnterWorktree/ExitWorktree반영v2.1.72 releaseO
/effort low/medium/high반영v2.1.72 releaseO
/loop 크론 스케줄반영v2.1.71 releaseO
HTTP hooks반영v2.1.63 releaseO
/context 액셔너블 제안반영v2.1.74 releaseO
autoMemoryDirectory반영v2.1.74 releaseO
/copy 인터랙티브 피커반영v2.1.59 releaseO
Voice STT 20개 언어반영v2.1.69 releaseO
/output-style deprecated반영v2.1.73 releaseO
Code Review 연구 프리뷰반영code.claude.com/docs/en/code-reviewO
Remote Control 전 플랜반영code.claude.com/docs/en/remote-controlO
REVIEW.md 커스터마이즈반영code.claude.com/docs/en/code-reviewO
--bare 경량 실행 플래그반영v2.1.81 releaseO
--channels 연구 프리뷰반영v2.1.80-81 releaseO
Opus 4.6 기본 출력 64k반영v2.1.77 releaseO
/branch (구 /fork)반영v2.1.77 releaseO
StopFailure 훅 이벤트반영v2.1.78 releaseO
effort frontmatter (스킬)반영v2.1.80 releaseO
Agent resume 파라미터 제거반영v2.1.77 releaseO
--console API 인증반영v2.1.79 releaseO
source: 'settings' 플러그인반영v2.1.80 releaseO
MCP OAuth CIMD (SEP-991)반영v2.1.81 releaseO
forceRemoteSettingsRefresh반영v2.1.92 releaseO
PreToolUse defer반영v2.1.89 releaseO
MCP maxResultSizeChars반영v2.1.91 releaseO
disableSkillShellExecution반영v2.1.91 releaseO
/powerup반영v2.1.90 releaseO
/release-notes 버전 피커반영v2.1.92 releaseO
/cost 모델별·cache-hit breakdown반영v2.1.92 releaseO
claude-cli://open?q= 멀티라인반영v2.1.91 releaseO
Remote Control hostname prefix반영v2.1.92 releaseO
/agents 실행 인디케이터/탭 UX반영v2.1.97-98 releaseO
/claude-api Managed Agents 가이드반영v2.1.91, v2.1.98 releaseO
background subagent partial progress반영v2.1.98 releaseO
subagent 동적 MCP 상속반영v2.1.101 releaseO
isolated worktree subagent Read/Edit 안정화반영v2.1.101 releaseO
PreCompact block 지원반영v2.1.105 releaseO
EnterWorktree(path)반영v2.1.105 releaseO
/recap + session recap 기본화반영v2.1.108, v2.1.110 release + commands docsO
built-in slash commands via Skill tool반영v2.1.108 release + tools referenceO
/focus반영v2.1.110 release + commands docsO
/tui반영v2.1.110 release + commands docsO
/fewer-permission-prompts반영v2.1.111 release + current commands docs namingO
/ultrareview반영v2.1.111 release + commands docsO
/team-onboarding반영v2.1.101 release + commands docsO
stream-json init plugin_errors반영v2.1.111 releaseO
CLI native binary launcher반영v2.1.113 releaseO
sandbox.network.deniedDomains반영v2.1.113 release + configuration docsO
stalled subagent 10분 failover반영v2.1.113 releaseO
Remote Control의 /extra-usage 지원반영v2.1.113 release + commands docsO

외부 링크 유효성 확인

다음 링크는 모두 접근 가능하며, 일부는 docs.claude.com에서 code.claude.com으로 리다이렉트됩니다.

항목링크상태
Changelog (GitHub)https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md접근 가능
Claude Code Changeloghttps://code.claude.com/docs/en/changelog접근 가능
Model configurationhttps://code.claude.com/docs/en/model-config접근 가능
Fable 5.1 overviewhttps://platform.claude.com/docs/en/models/fable-5-1/overview접근 가능
What's new in Fable 5.1https://platform.claude.com/docs/en/models/fable-5-1/whats-new-fable-5-1접근 가능
Fable 5.1 migration guidehttps://platform.claude.com/docs/en/models/fable-5-1/migration-guide접근 가능
Fable 5.1·Mythos 5.1 발표https://www.anthropic.com/claude-fable-and-mythos-5-1접근 가능
Fast modehttps://code.claude.com/docs/en/fast-mode접근 가능
Fable 5 소개https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5접근 가능
Models overviewhttps://platform.claude.com/docs/en/about-claude/models/overview접근 가능
GitHub Releaseshttps://github.com/anthropics/claude-code/releases접근 가능
Hooks 참조https://docs.claude.com/ko/docs/claude-code/hooks리다이렉트 → code.claude.com
MCPhttps://docs.claude.com/ko/docs/claude-code/mcp리다이렉트 → code.claude.com
메모리https://docs.claude.com/ko/docs/claude-code/memory리다이렉트 → code.claude.com
VS Codehttps://docs.claude.com/ko/docs/claude-code/vs-code리다이렉트 → code.claude.com
JetBrainshttps://docs.claude.com/ko/docs/claude-code/jetbrains리다이렉트 → code.claude.com
Statuslinehttps://docs.claude.com/ko/docs/claude-code/statusline리다이렉트 → code.claude.com
Slash Commandshttps://code.claude.com/docs/ko/slash-commands접근 가능
Settingshttps://code.claude.com/docs/ko/settings접근 가능
Setuphttps://code.claude.com/docs/ko/setup접근 가능
Skillshttps://code.claude.com/docs/ko/skills접근 가능
Headlesshttps://code.claude.com/docs/ko/headless접근 가능
Subagentshttps://docs.claude.com/en/docs/claude-code/subagents리다이렉트 → code.claude.com
Team/Permissionshttps://docs.claude.com/en/docs/claude-code/team리다이렉트 → code.claude.com
Pricinghttps://claude.com/ko-kr/pricing접근 가능
Max 플랜 안내https://support.claude.com/en/articles/11049741-what-is-the-max-plan접근 가능
Agent Skillshttps://platform.claude.com/docs/ko/agents-and-tools/agent-skills/overview접근 가능
Code Reviewhttps://code.claude.com/docs/en/code-review접근 가능
Remote Controlhttps://code.claude.com/docs/en/remote-control접근 가능
git worktreehttps://git-scm.com/docs/git-worktree접근 가능
tmuxhttps://github.com/tmux/tmux/wiki접근 가능

검증 한계

외부 사실 검증 범위

본 리포트는 문서 내부 정합성과 링크 유효성 중심으로 검증했습니다. 공식 문서의 상세 내용이 본문과 일치하는지에 대한 내용 단위 교차검증은 별도로 수행해야 합니다.

후속 권장 작업

  • 공식 문서 변경 시, 참고 링크의 최신성 재확인
  • 신규 기능 추가 시 검증 리포트 항목 보강

관련 문서

릴리스 반영 이력

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

업데이트 내역

Claude Code 고급 활용 핸드북 변경 로그

Ch1. 플랜 & 환경 설정

Claude Code를 쓸 수 있는 플랜(Pro·Max·Team Premium·Enterprise·Console)과 네이티브·Homebrew·npm 설치, 모델·effort·퍼미션·managed settings 설정을 정리합니다

Cmd. /model

Claude Code 명령어 마스터 · Claude 모델을 전환해 새 세션 기본값으로 저장하고, picker에서 effort를 조정하거나 s로 현재 세션에만 적용하는 명령. provider별 alias 해석과 Fable 5.1·Opus 5 운영 기준을 함께 정리한다

검증 리포트

Codex 고급 활용 · Codex 고급 활용 핸드북의 링크·정합성 검증

Ch13. 프롬프팅 베스트 프랙티스

Claude Code에서 결과를 끌어올리는 프롬프트 작성 전략 — 명확한 지시, 맥락·예시, effort 조절, 행동 유발, 자율성과 안전

업데이트 내역

Claude Code 고급 활용 핸드북 변경 로그

On this page

2026-09-12 최신 변경검증 방법론1단계: 구조/용어 일관성2단계: 예제 검증3단계: 링크 표기 규칙4단계: 외부 링크 유효성검증 결과 요약공식 문서 교차검증 세부 내역모델/버전 정보주요 기능2026-07-10 재검증 요약2026-07-01 재검증 요약2026-06-25 재검증 요약외부 링크 유효성 확인검증 한계후속 권장 작업