검증 리포트
Claude Code 고급 활용 핸드북의 용어·링크·예제 정합성 검증 결과
이 문서는 Claude Code 고급 활용 핸드북의 내부 정합성과 외부 참고 링크 유효성을 검증한 결과입니다.
검증 기준일
2026년 6월 25일 기준으로 검증을 수행했습니다.
검증 방법론
네 단계로 콘텐츠 정합성을 점검했습니다.
1단계: 구조/용어 일관성
- 챕터 제목과 소개 문구의 용어가 서로 일치하는지 확인
- 동일 기능에 대해 다른 용어가 섞여 있는지 확인 (예: hooks/Hooks, headless/헤드리스)
2단계: 예제 검증
- 코드 블록의 문법 오류(따옴표, 파이프, 백틱) 여부 점검
- 문서 내 경로가 실제 디렉토리 구조와 충돌하지 않는지 확인
3단계: 링크 표기 규칙
- 참고 문서 링크가 중복/오탈자 없이 일관적으로 표기되는지 확인
- 링크 설명 뒤에 (한국어)/(영어) 표기를 일관 적용
4단계: 외부 링크 유효성
- 참고 문서 링크가 실제로 접근 가능한지 확인
docs.claude.com→code.claude.com리다이렉트 여부 확인
검증 결과 요약
| 항목 | 결과 |
|---|---|
| 챕터 제목/설명 일관성 | 이상 없음 |
| 명령어/플래그 표기 | 이상 없음 |
| 코드 블록 문법 | 이상 없음 |
| 링크 표기 규칙 | 이상 없음 |
| 외부 링크 유효성 | 이상 없음 (일부 문서 리다이렉트) |
검증 결과
내부 정합성 기준에서는 불일치 항목이 발견되지 않았습니다.
공식 문서 교차검증 세부 내역
모델/버전 정보
| 항목 | 핸드북 | 공식 문서 | 일치 |
|---|---|---|---|
| 최신 latest 버전 | v2.1.190 | Claude Code Changelog 2026-06-24 + npm latest dist-tag | O |
| stable 채널 버전 | v2.1.179 | npm stable dist-tag | O |
| v2.1.181~v2.1.190 운영 변경 | 반영 | Claude Code Changelog 2026-06-13~2026-06-24 | O |
| Fable 5 추가 | 반영 | Claude Code v2.1.170 changelog + model-config docs | O |
Anthropic API fable alias | Fable 5 | model-config docs | O |
best alias | Fable 접근 가능 시 Fable, 아니면 최신 Opus | model-config docs | O |
| Fable 5 Claude Code 요구 버전 | v2.1.170 이상 | model-config docs | O |
| Fable 5 기본 모델 여부 | 기본값 아님 | model-config docs | O |
| Fable 5 retention/ZDR | 30일 data retention, ZDR 미지원 | Claude models overview + Fable launch docs | O |
| Fable 5 thinking | adaptive thinking 상시 활성화, off 불가 | model-config docs + Fable launch docs | O |
| Fable prompt caching env | DISABLE_PROMPT_CACHING_FABLE 반영 | model-config docs | O |
| Fable 자동 fallback | 기본 Opus로 재실행, /model fable로 복귀 | model-config docs | O |
fallbackModel chain | 반영 | v2.1.166 changelog + model-config docs | O |
--safe-mode | Fable fallback/설정 디버그 기준으로 반영 | v2.1.169 changelog + model-config docs | O |
/cd 세션 이동 | cwd, 세션 저장 위치, trust prompt 반영 | Commands docs + v2.1.169 changelog | O |
disableBundledSkills | 반영 | v2.1.169 changelog + env-vars docs | O |
| Opus 4.8 출시 | 반영 | Anthropic 2026-05-28 발표 + Claude Code v2.1.154 | O |
Anthropic API opus alias | Opus 4.8 | model-config docs | O |
Anthropic API sonnet alias | Sonnet 4.6 | model-config docs | O |
| Claude Platform on AWS alias | opus Opus 4.7 / sonnet Sonnet 4.6 | model-config docs | O |
| Bedrock/Vertex/Foundry alias | opus Opus 4.6 / sonnet Sonnet 4.5 | model-config docs | O |
| Opus 4.8 Claude Code 요구 버전 | v2.1.154 이상 | model-config docs | O |
/model 기본 저장 동작 | v2.1.153부터 Enter가 user settings 기본값 저장 | model-config docs | O |
| Opus 4.8 high 기본 + xhigh | 반영 | v2.1.154 changelog | O |
| Opus 4.7 xhigh | historical로 반영 | v2.1.111 release + commands/model-config docs | O |
| Max 사용자의 Auto mode 경로 단순화 | 반영 | v2.1.111 release | O |
| Opus 4.6 medium 기본 | 반영 | v2.1.68 release | O |
| Sonnet 4.6 출시 | 2026-02-17 | Anthropic 뉴스 + v2.1.69 자동 마이그레이션 | O |
| Opus 4/4.1 제거 | 반영 | v2.1.68 release | O |
| Bedrock/Vertex Opus 4.6 | 반영 | v2.1.73 release | O |
| modelOverrides 설정 | 반영 | v2.1.73 release | O |
| model restrictions | main model은 Opus/Sonnet/Haiku/Fable family 중심, Haiku main 제한·subagent 허용 | v2.1.184 changelog + model-config docs | O |
| deprecated model warning | 반영 | v2.1.187 changelog | O |
주요 기능
| 항목 | 핸드북 | 공식 문서 | 일치 |
|---|---|---|---|
| Agent View | 반영 | code.claude.com/docs/en/agent-view + v2.1.139 changelog | O |
/bg//background background sessions | 반영 | Agent View docs + Commands docs | O |
claude --bg --exec shell background job | 반영 | v2.1.154 changelog + Agent View docs | O |
Dynamic workflows + /workflows | 반영 | v2.1.154 changelog + Commands docs | O |
/goal 완료 조건 기반 장기 작업 | 반영 | v2.1.139 changelog + Commands docs | O |
/usage-credits | 반영 | Commands docs | O |
/reload-skills | 반영 | Commands docs | O |
/run / /verify / /run-skill-generator | 반영 | Commands docs | O |
/code-review와 /simplify 역할 분리 | 반영 | v2.1.154 changelog + Commands docs | O |
sandbox.credentials | 반영 | v2.1.186 changelog | O |
| destructive command sandbox auto-approval | 반영 | v2.1.183 changelog | O |
| Windows PowerShell sandbox fix | 반영 | v2.1.186 changelog | O |
claude mcp login/logout | 반영 | v2.1.187 changelog | O |
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT | 반영 | v2.1.185 changelog | O |
| max 3 agent nesting | 반영 | v2.1.184 changelog | O |
| Agent deny rules / background permission prompts | 반영 | v2.1.184~v2.1.186 changelog | O |
| Korean paste mojibake fix | 반영 | v2.1.187 changelog | O |
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 changelog |
--safe-mode | 반영 | v2.1.169 changelog + model-config docs |
--log-level | 반영 | v2.1.134 changelog |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 반영 | v2.1.133 changelog |
worktree.bgIsolation | 반영 | Agent View docs + v2.1.143 changelog |
| --worktree 플래그 | 반영 | v2.1.49 release |
| EnterWorktree/ExitWorktree | 반영 | v2.1.72 release |
| /effort low/medium/high | 반영 | v2.1.72 release |
| /loop 크론 스케줄 | 반영 | v2.1.71 release |
| HTTP hooks | 반영 | v2.1.63 release |
| /context 액셔너블 제안 | 반영 | v2.1.74 release |
| autoMemoryDirectory | 반영 | v2.1.74 release |
| /copy 인터랙티브 피커 | 반영 | v2.1.59 release |
| Voice STT 20개 언어 | 반영 | v2.1.69 release |
| /output-style deprecated | 반영 | v2.1.73 release |
| Code Review 연구 프리뷰 | 반영 | code.claude.com/docs/en/code-review |
| Remote Control 전 플랜 | 반영 | code.claude.com/docs/en/remote-control |
| REVIEW.md 커스터마이즈 | 반영 | code.claude.com/docs/en/code-review |
| --bare 경량 실행 플래그 | 반영 | v2.1.81 release |
| --channels 연구 프리뷰 | 반영 | v2.1.80-81 release |
| Opus 4.6 기본 출력 64k | 반영 | v2.1.77 release |
| /branch (구 /fork) | 반영 | v2.1.77 release |
| StopFailure 훅 이벤트 | 반영 | v2.1.78 release |
| effort frontmatter (스킬) | 반영 | v2.1.80 release |
| Agent resume 파라미터 제거 | 반영 | v2.1.77 release |
| --console API 인증 | 반영 | v2.1.79 release |
| source: 'settings' 플러그인 | 반영 | v2.1.80 release |
| MCP OAuth CIMD (SEP-991) | 반영 | v2.1.81 release |
forceRemoteSettingsRefresh | 반영 | v2.1.92 release |
PreToolUse defer | 반영 | v2.1.89 release |
MCP maxResultSizeChars | 반영 | v2.1.91 release |
disableSkillShellExecution | 반영 | v2.1.91 release |
/powerup | 반영 | v2.1.90 release |
/release-notes 버전 피커 | 반영 | v2.1.92 release |
/cost 모델별·cache-hit breakdown | 반영 | v2.1.92 release |
claude-cli://open?q= 멀티라인 | 반영 | v2.1.91 release |
| Remote Control hostname prefix | 반영 | v2.1.92 release |
/agents 실행 인디케이터/탭 UX | 반영 | v2.1.97-98 release |
/claude-api Managed Agents 가이드 | 반영 | v2.1.91, v2.1.98 release |
| background subagent partial progress | 반영 | v2.1.98 release |
| subagent 동적 MCP 상속 | 반영 | v2.1.101 release |
| isolated worktree subagent Read/Edit 안정화 | 반영 | v2.1.101 release |
PreCompact block 지원 | 반영 | v2.1.105 release |
EnterWorktree(path) | 반영 | v2.1.105 release |
/recap + session recap 기본화 | 반영 | v2.1.108, v2.1.110 release + commands docs |
| built-in slash commands via Skill tool | 반영 | v2.1.108 release + tools reference |
/focus | 반영 | v2.1.110 release + commands docs |
/tui | 반영 | v2.1.110 release + commands docs |
/fewer-permission-prompts | 반영 | v2.1.111 release + current commands docs naming |
/ultrareview | 반영 | v2.1.111 release + commands docs |
/team-onboarding | 반영 | v2.1.101 release + commands docs |
stream-json init plugin_errors | 반영 | v2.1.111 release |
| CLI native binary launcher | 반영 | v2.1.113 release |
sandbox.network.deniedDomains | 반영 | v2.1.113 release + configuration docs |
| stalled subagent 10분 failover | 반영 | v2.1.113 release |
Remote Control의 /extra-usage 지원 | 반영 | v2.1.113 release + commands docs |
외부 링크 유효성 확인
다음 링크는 모두 접근 가능하며, 일부는 docs.claude.com에서 code.claude.com으로 리다이렉트됩니다.
검증 한계
외부 사실 검증 범위
본 리포트는 문서 내부 정합성과 링크 유효성 중심으로 검증했습니다. 공식 문서의 상세 내용이 본문과 일치하는지에 대한 내용 단위 교차검증은 별도로 수행해야 합니다.
후속 권장 작업
- 공식 문서 변경 시, 참고 링크의 최신성 재확인
- 신규 기능 추가 시 검증 리포트 항목 보강