명령어 개요
Claude Code 명령어를 목적 중심으로 분류하고 선택 기준을 정리합니다.
핵심 요약
- 이 페이지는 책이 다루는 주요 명령어를
명령어·반영 버전·간단 설명3컬럼 표로 한 번에 찾는 카탈로그입니다. - 정렬은 최신 버전 우선이며,
vX.Y.Z(도입 버전 확인)→현재 공식 문서→레거시(최초 버전 미상)→미상(초기 내장/legacy)순으로 묶습니다. - 명령에 따라 플랫폼·플랜·환경별로 노출이 갈립니다(예:
/desktop은 macOS/Windows,/upgrade는 Pro·Max에서만). /output-style·/pr-comments·/vim·/tag등 폐기·제거된 명령과/extra-usage→/usage-credits같은 개명도 함께 표기합니다.
개요
이 페이지는 이 책이 다루는 주요 명령어를 한 번에 찾는 카탈로그입니다.
컬럼은 명령어, 반영 버전, 간단 설명으로 고정하고, 정렬은 최신 버전 우선입니다.
범위
Claude Code 공식 Commands 문서에는 plan/플랫폼/플랜별로 더 많은
명령이 있습니다. 이 카탈로그는 최근 릴리스에서 바뀐 것과 현업에서 자주 쓰는 명령 위주로 추립니다. 2026년 6월 25일 기준
공식 Changelog는 v2.1.190까지 확인했고, npm 채널은 latest 2.1.190/stable 2.1.179입니다. 공식 문서는 built-in command, bundled skill, dynamic workflow를 한 표에서 함께 묶어 두는데, 명령에 따라 플랫폼·플랜·환경별로
노출 여부가 갈립니다(예: /desktop은 구독 로그인 시 macOS/Windows에서만, /upgrade는 Pro·Max에서만 표시).
표기 규칙(반영 버전)
vX.Y.Z: changelog에서 최초 도입 버전이 확인된 항목현재 공식 문서: 현재Commands/CLI reference에는 있지만 최초 도입 버전이 명시되지 않은 항목레거시(최초 버전 미상): legacy 성격은 확인되지만 최초 버전이 changelog에 명시되지 않은 항목미상(초기 내장/legacy): 초기 내장/legacy로 보이나 최초 버전 근거가 없는 항목
정렬 기준
vX.Y.Z항목을 semver 내림차순으로 정렬- 다음으로
레거시(최초 버전 미상) - 마지막으로
미상(초기 내장/legacy) - 같은 그룹 내에서는 명령어 이름 오름차순
명령어 카탈로그
| 명령어 | 반영 버전 | 간단 설명 |
|---|---|---|
claude mcp login/logout | v2.1.187 | MCP 서버 OAuth 인증을 CLI에서 갱신하거나 해제. 장기 세션의 인증 만료 대응에 사용 |
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT | v2.1.185 | 장시간 MCP tool 호출의 idle timeout을 환경변수로 조정 |
sandbox.credentials | v2.1.186 | sandbox에서 credential boundary를 명확히 하는 보안 설정 |
/advisor [model|off] | v2.1.170 Fable 옵션 | 보조 모델 의견을 받는 명령. Fable 5 접근 권한이 있으면 fable 옵션 사용 가능 |
/cd <path> | v2.1.169 | prompt cache를 유지하며 세션 working directory와 저장 위치를 이동. 새 CLAUDE.md는 메시지로 추가되고 미신뢰 디렉토리는 trust prompt 표시 |
/model | v2.1.170 모델 기준 갱신 | Fable 5, best, Opus 4.8/Sonnet 4.6 alias와 provider별 pinning 정책을 확인하고 전환 |
/workflows | v2.1.154 | dynamic workflow 실행 상태를 보고 pause/resume/save하는 진행 화면 |
/fast | v2.1.154 | /fast [on|off]로 Opus 4.8 fast mode를 토글. 표준 대비 2배 요금/2.5배 속도 기준 |
claude --bg --exec '<command>' | v2.1.154 | 모델 호출 없이 shell command를 Agent View background job으로 실행 |
/code-review | v2.1.147+ | diff의 correctness bug와 cleanup을 리뷰. --fix/--comment 지원, ultra는 클라우드 리뷰 |
/run | v2.1.145+ | 앱을 빌드/실행/관찰해 변경이 실제로 동작하는지 확인하는 skill |
/verify | v2.1.145+ | 테스트 외에도 실행 중인 앱 관찰까지 포함해 변경 의도를 검증하는 skill |
/run-skill-generator | v2.1.145+ | 프로젝트별 /run·/verify 실행 방법을 가르치는 per-project skill 생성 |
/reload-skills | v2.1.152 | 세션 중 디스크에 추가/수정된 skills와 command 디렉토리를 재스캔 |
/goal | v2.1.139 | 완료 조건을 설정해 Claude가 여러 턴에 걸쳐 계속 작업하도록 함(clear로 해제) |
/background / /bg | v2.1.136+ | 현재 conversation을 background agent로 분리하고 Agent View에서 관리 |
/usage-credits | v2.1.134 | 사용량 한도 도달 후 이어서 작업하기 위한 usage credits 설정(구 /extra-usage) |
claude project purge | v2.1.126 | 프로젝트의 로컬 Claude Code 상태를 안전하게 정리하는 CLI 서브커맨드 |
/skills | v2.1.121 (검색 개선) | 사용 가능한 skill을 확인하고 긴 목록에서 필터링/숨김 처리하는 명령 |
/theme | v2.1.118 | built-in/custom theme을 선택하고 테마 파일을 관리하는 명령 |
/fewer-permission-prompts | v2.1.111 | 읽기 전용 Bash/MCP 호출을 분석해 .claude/settings.json allowlist를 제안하는 skill |
/ultrareview | v2.1.86 (research preview) | 클라우드 샌드박스 멀티 에이전트 리뷰. 현재 선호 호출은 /code-review ultra이며 /ultrareview는 alias로 유지 |
/output-style | v2.1.73 (deprecated) | 폐기됨 — /config(Settings)에서 출력 스타일 설정. 세션 시작 시 고정됨 |
/focus | v2.1.110 | fullscreen 렌더링에서 마지막 프롬프트, 도구 요약, 최종 응답만 보이게 토글하는 명령 |
/tui | v2.1.110 | /tui [default|fullscreen]로 기본 렌더러와 fullscreen TUI 렌더러를 전환 |
/recap | v2.1.108 | 현재 세션의 한 줄 요약을 생성해 복귀 비용을 줄이는 명령 |
/team-onboarding | v2.1.101 | 최근 30일 사용 이력으로 팀원용 온보딩 가이드를 생성하는 명령 |
/powerup | v2.1.90 | 애니메이션 데모가 포함된 대화형 레슨으로 Claude Code 기능을 익히는 명령 |
/branch | v2.1.77 (alias /fork) | 현재 대화를 이 지점에서 분기. /resume으로 원본 복귀 가능. /fork는 alias |
/ide | v2.1.73 | IDE 연동 상태를 점검하고 통합을 관리하는 명령 |
/effort | v2.1.72 (v2.1.111 확장) | 모델 추론 강도(low/medium/high/xhigh/max/ultracode)를 조절. auto로 기본값 복귀 |
/loop | v2.1.71 (별칭 /proactive) | 프롬프트/슬래시 명령을 반복 실행하거나 자율 유지보수 루틴을 돌리는 skill 명령 |
/color | v2.1.70 | 현재 세션의 프롬프트 바 색상을 변경하는 명령(default로 초기화) |
/rename | v2.1.70 | 현재 세션의 이름을 변경하는 명령(인자 없으면 대화 이력에서 자동 생성) |
/claude-api | v2.1.69 | Claude API/Anthropic SDK·Managed Agents 앱 개발을 돕는 skill. migrate 서브모드 지원 |
/reload-plugins | v2.1.69 | 재시작 없이 플러그인 변경사항을 즉시 반영하는 명령 |
/batch | v2.1.63 | 대규모 변경을 5~30개 독립 단위로 분해해 worktree별 background subagent로 실행하는 skill |
/simplify | v2.1.63 (v2.1.154 변경) | cleanup/reuse/simplification/efficiency를 4개 병렬 에이전트로 점검(버그 탐지는 /code-review) |
/copy | v2.1.59 | 마지막 응답의 코드 블록 또는 전체 응답을 선택 복사하는 명령(/copy N로 N번째 응답) |
/debug | v2.1.30 | 세션 debug log를 켜고 문제를 진단하는 skill 명령 |
/keybindings | v2.1.18 | 키 바인딩 설정 파일을 열거나 생성하는 명령 |
/doctor | v2.1.3 | 설치/설정을 진단. f를 눌러 Claude가 문제를 고치게 할 수 있음 |
/plan | v2.1.0 | 프롬프트에서 바로 plan mode로 진입. 설명을 함께 넘기면 그 작업으로 시작 |
/remote-env | v2.1.0 | --remote 웹 세션의 기본 원격 환경을 구성하는 명령 |
/teleport | v2.1.0 | 웹 세션을 현재 터미널로 가져오는 명령(/tp 별칭, claude.ai 구독 필요) |
/config | v2.0.71 | Settings 인터페이스를 열어 테마/모델/출력 스타일 등을 조정. /settings 별칭 |
/settings | v2.0.71 | 설정 메뉴 진입을 위한 /config 별칭 명령 |
/permissions | v2.0.67 | 도구 실행 allow/ask/deny 규칙을 관리하는 운영 핵심 명령(/allowed-tools 별칭) |
/resume | v2.0.64 | 저장된 대화를 ID/이름으로 재개(v2.1.144부터 background 세션 bg 표시). /continue 별칭 |
/usage | v2.0.0 | 세션 비용·플랜 한도·활동 통계를 확인. /cost·/stats는 alias |
/cost | /usage 별칭 | /usage의 alias. 세션 사용량/비용 화면을 엶 |
/stats | /usage 별칭 | /usage의 alias로 Stats 탭을 바로 엶 |
/plugin | v2.0.12 | 플러그인 설치/활성화/검증 등 확장 기능을 관리하는 명령군 |
/terminal-setup | v1.0.110 | Shift+Enter 등 터미널 키바인딩을 자동 구성(VS Code/Cursor/Zed 등에서만 노출) |
/todos | v1.0.94 | 현재 작업의 todo 항목을 확인하고 우선순위를 관리하는 명령 |
/context | v1.0.86 (v2.1.74 개선) | 컨텍스트 사용을 그리드로 시각화하고 최적화 제안을 제공하는 명령(/context all) |
/add-dir | v1.0.42 | 현재 세션의 파일 접근 범위를 추가 디렉토리까지 확장하는 명령 |
/mcp | v1.0.18 | MCP 서버 연결과 OAuth 인증 상태를 점검하고 운영하는 명령 |
/upgrade | v1.0.11 | 상위 플랜으로 전환하는 업그레이드 페이지로 연결(Pro·Max에서만 노출) |
/release-notes | v0.2.37 (v2.1.92 개선) | 인터랙티브 버전 피커로 changelog/릴리스 노트를 확인하는 명령 |
/approved-tools | v0.2.26 | 이전 권한 관리 명령의 레거시 문맥을 설명하고 /permissions로 마이그레이션하는 안내 |
/commands | v0.2.21 | 초기 버전의 명령 탐색 맥락을 다루는 레거시 명령 문서 |
/agents | 레거시(v2.1.139 Agent View) | subagent 구성을 관리하고 Agent View에서 background session을 관리하는 명령 |
/diff | 레거시(최초 버전 미상) | 미커밋 변경과 turn별 diff를 인터랙티브 뷰어로 확인하는 명령 |
/export | 레거시(최초 버전 미상) | 현재 대화를 plain text로 내보내거나 클립보드/파일로 저장하는 명령 |
/hooks | 레거시(최초 버전 미상) | 도구 이벤트에 대한 hook 구성을 점검/설계할 때 사용하는 운영 심화 명령 |
/init | 레거시(최초 버전 미상) | 프로젝트 규칙 파일(CLAUDE.md)의 초기 스캐폴딩을 생성하는 명령 |
/memory | 레거시(최초 버전 미상) | CLAUDE.md 메모리 파일과 auto-memory를 점검/관리하는 명령 |
/review | 레거시(최초 버전 미상) | 현재 세션에서 로컬 PR/브랜치 변경을 점검하는 리뷰 명령 |
/rewind | 레거시(최초 버전 미상) | 대화/코드를 체크포인트로 되돌리거나 일부를 요약(/checkpoint·/undo 별칭) |
/sandbox | 레거시(최초 버전 미상) | 지원 플랫폼에서 sandbox mode를 토글하는 명령 |
/security-review | 레거시(최초 버전 미상) | 현재 브랜치 변경을 보안 취약점 관점으로 집중 점검하는 명령 |
/statusline | 레거시(최초 버전 미상) | 터미널 상태 표시줄을 커스터마이즈해 운영 가시성을 높이는 명령 |
/tasks | 레거시(최초 버전 미상) | 백그라운드 작업을 나열/관리하는 명령(/bashes 별칭) |
/autofix-pr | 현재 공식 문서 | PR의 CI 실패/리뷰 코멘트를 원격 Claude Code 세션에서 자동 수정(gh CLI 필요) |
/desktop | 현재 공식 문서 | 현재 세션을 Claude Code Desktop 앱으로 이어서 진행(/app 별칭, macOS/Windows) |
/schedule | 현재 공식 문서 | cloud routine을 생성·수정·실행하는 자동화 명령(/routines 별칭) |
/web-setup | 현재 공식 문서 | 로컬 gh 인증을 Claude Code on the web GitHub 연결에 활용하도록 설정 |
/clear | 미상(초기 내장/legacy) | 빈 컨텍스트로 새 대화 시작(/reset·/new 별칭). 컨텍스트만 비우려면 /compact |
/compact | 미상(초기 내장/legacy) | 지금까지의 대화를 요약·압축해 컨텍스트를 확보하는 명령 |
/exit | 미상(초기 내장/legacy) | CLI 종료(/quit 별칭). background 세션에 attach 중이면 detach만 됨 |
/help | 미상(초기 내장/legacy) | 도움말과 사용 가능한 명령어 표시(기본 코어) |
/quit | 미상(초기 내장/legacy) | 세션 종료(/exit 별칭, 기본 코어) |
/status | 미상(초기 내장/legacy) | Settings의 Status 탭(버전/모델/계정/연결)을 여는 명령 |
/pr-comments (removed) | 레거시(v2.1.91 제거) | 제거됨 — GitHub PR 코멘트 조회 명령이었으나 v2.1.91에서 제거. Claude에게 직접 요청 |
/vim (removed) | v0.2.34 (v2.1.92 제거) | 제거됨 — 입력 Vim 모드 토글이었으나 v2.1.92에서 제거. /config → Editor mode로 대체 |
/tag (removed) | 레거시(최초 버전 미상, v2.1.92 제거) | 제거됨 — 세션 태그 명령. 현재 공식 Commands 문서에 없음. 이름 기반 운영으로 마이그레이션 |
/extra-usage | 레거시(/usage-credits로 개명) | 개명됨 — 현재 이름은 /usage-credits. 기존 문서/세션 호환 목적의 legacy 항목 |
다음 읽기
- 처음 보는 사용자:
/books/claude-code-command-master/how-to-use-this-book - 운영 검증:
/books/claude-code-command-master/verification