Claude Code 완전 가이드 · 7 min read
Commands & Skills
슬래시로 호출하는 프롬프트 템플릿(Commands)과 재사용 가능한 지식 모듈(Skills)을 다룹니다. Skills는 Commands의 상위 호환이며, 공식적으로 권장됩니다.
Commands vs Skills
Commands (레거시)
- 위치:
.claude/commands/*.md - Frontmatter 4개: description, argument-hint, allowed-tools, model
- 단일 파일로 동작
- 여전히 작동하지만 Skills 권장
Skills (권장)
- 위치:
.claude/skills/name/SKILL.md - Frontmatter 10개: + context, agent, hooks, disable-model-invocation, user-invocable
- 디렉토리 구조 지원 (보조 파일 포함)
- 자동 호출, 격리 실행, 에이전트 프리로드 가능
두 가지 스킬 패턴
Agent Skill (프리로드)
에이전트의 skills: 필드에 지정하면 시작 시 전체 콘텐츠가 주입됩니다.
# 에이전트 frontmatter
skills:
- weather-fetcher에이전트의 도메인 지식으로 활용. user-invocable: false 권장
Invocable Skill (직접 호출)
Skill 도구나 /slash-command로 호출됩니다.
# 커맨드에서 호출
Skill(skill: "weather-svg-creator")
# 사용자가 직접 호출
/weather-svg-creator독립 실행 가능한 작업에 적합
공식 번들 스킬 (5개)
| 스킬 | 설명 | 핵심 기능 |
|---|---|---|
/batch | 대규모 병렬 변경 | 5-30개 단위로 분해, 각각 격리된 worktree에서 에이전트 실행, PR 생성 |
/simplify | 코드 품질 리뷰 | 3개 병렬 에이전트가 재사용성, 품질, 효율성을 동시 검토 |
/loop | 반복 작업 예약 | 최대 3일간 주기적 실행 (배포 모니터링, PR 관찰) |
/debug | 세션 디버깅 | 디버그 로그를 읽어 Claude Code 자체 문제 해결 |
/claude-api | API 레퍼런스 | 프로젝트 언어에 맞는 Claude API 문서 로드 |
공식 빌트인 커맨드 (60개)
전체 커맨드 목록 보기
| # | 커맨드 | 카테고리 | 설명 |
|---|---|---|---|
| 1 | /login | Auth | OAuth로 인증 |
| 2 | /logout | Auth | 로그아웃 |
| 3 | /upgrade | Auth | 상위 플랜으로 업그레이드 |
| 4 | /config | Config | 검색 가능한 설정 인터페이스 |
| 5 | /keybindings | Config | 키보드 단축키 커스터마이징 |
| 6 | /permissions | Config | 도구 권한 설정 |
| 7 | /privacy-settings | Config | 프라이버시/텔레메트리 관리 |
| 8 | /sandbox | Config | 샌드박스 구성 |
| 9 | /statusline | Config | 상태 라인 UI 설정 |
| 10 | /stickers | Config | 스티커 주문 |
| 11 | /terminal-setup | Config | IDE 터미널에서 Shift+Enter 활성화 |
| 12 | /theme | Config | 색상 테마 변경 |
| 13 | /vim | Config | Vim 편집 모드 활성화 |
| 14 | /context | Context | 현재 컨텍스트 사용량 시각화 |
| 15 | /cost | Context | 세션 토큰 사용량 |
| 16 | /extra-usage | Context | 종량제 초과 결제 설정 |
| 17 | /insights | Context | 세션 분석 리포트 생성 |
| 18 | /stats | Context | 일일 사용량, 세션 히스토리, 스트릭 |
| 19 | /status | Context | 세션 상태 요약 |
| 20 | /usage | Context | 플랜 사용량/레이트 리밋 |
| 21 | /doctor | Debug | 설치 상태 진단 |
| 22 | /feedback | Debug | 버그 리포트 URL 생성 |
| 23 | /help | Debug | 슬래시 커맨드 도움말 |
| 24 | /release-notes | Debug | 최근 릴리스 노트 |
| 25 | /tasks | Debug | 백그라운드 태스크 관리 |
| 26 | /copy | Export | 마지막 응답 클립보드 복사 |
| 27 | /export | Export | 대화 내보내기 |
| 28 | /agents | Extensions | 서브에이전트 관리 |
| 29 | /chrome | Extensions | Chrome 브라우저 통합 |
| 30 | /hooks | Extensions | Hook 설정 관리 |
| 31 | /ide | Extensions | IDE 통합 연결 |
| 32 | /mcp | Extensions | MCP 서버 관리 |
| 33 | /plugin | Extensions | 플러그인 관리 |
| 34 | /reload-plugins | Extensions | 플러그인 재로드 |
| 35 | /skills | Extensions | 사용 가능한 스킬 목록 |
| 36 | /memory | Memory | 메모리 파일 보기/편집 |
| 37 | /fast | Model | 빠른 출력 모드 토글 |
| 38 | /model | Model | 모델 전환 및 노력 수준 조정 |
| 39 | /passes | Model | 무료 1주 패스 공유 |
| 40 | /plan | Model | 읽기 전용 플래닝 모드 |
| 41 | /add-dir | Project | 작업 디렉토리 추가 |
| 42 | /diff | Project | 현재 git diff 검토 |
| 43 | /init | Project | CLAUDE.md로 프로젝트 초기화 |
| 44 | /pr-comments | Project | PR 코멘트 검토/답변 |
| 45 | /review | Project | Deprecated (code-review 플러그인 사용) |
| 46 | /security-review | Project | 보안 리뷰 |
| 47 | /desktop | Remote | 데스크톱 앱 연결 |
| 48 | /install-github-app | Remote | GitHub 앱 설치 |
| 49 | /install-slack-app | Remote | Slack 앱 설치 |
| 50 | /mobile | Remote | 모바일 앱 연결 |
| 51 | /remote-control | Remote | 다른 기기에서 세션 이어하기 |
| 52 | /remote-env | Remote | 리모트 컨트롤 환경 확인 |
| 53 | /btw | Session | 사이드 체인 질문 (대화에 추가 안 됨) |
| 54 | /clear | Session | 대화 기록 초기화 |
| 55 | /compact | Session | 대화 압축 (컨텍스트 확보) |
| 56 | /exit | Session | 종료 |
| 57 | /fork | Session | 현재 대화를 새 세션으로 포크 |
| 58 | /rename | Session | 세션 이름 변경 |
| 59 | /resume | Session | 이전 대화 재개 |
| 60 | /rewind | Session | 이전 시점으로 되감기 |