# Claude CLI 완전 가이드 v4: 슬래시 명령어 완전 가이드 ## 슬래시 명령어란? 슬래시 명령어는 `/`로 시작하는 특수 명령어입니다. Claude와의 대화 중 다양한 기능을 빠르게 실행할 수 있습니다. ``` /help ``` --- ## 카테고리별 명령어 정리 ### 도움말 & 정보 | 명령어 | 설명 | |--------|------| | `/help` | 모든 명령어 사용법 표시 | | `/status` | 버전 및 연결 상태 확인 | | `/release-notes` | 최신 버전 업데이트 내역 | | `/doctor` | 설치 상태 종합 점검 | --- ### 세션 관리 | 명령어 | 설명 | |--------|------| | `/clear` | 대화 히스토리 완전 삭제 | | `/exit` | REPL 종료 | | `/export [filename]` | 대화를 파일 또는 클립보드로 저장 | | `/resume` | 이전 대화 재개 | | `/rewind` | 대화 및 코드 변경 되돌리기 | **사용 예시:** ``` /export my-session.md # 파일로 저장 /export # 클립보드로 복사 /resume # 이전 세션 목록에서 선택 ``` --- ### 설정 & 환경 | 명령어 | 설명 | |--------|------| | `/config` | 설정 인터페이스 열기 | | `/settings` | 설정 보기/편집 (/config와 동일) | | `/model` | AI 모델 선택 | | `/vim` | Vim 편집 모드 진입 | | `/terminal-setup` | Shift+Enter 바인딩 설치 | | `/statusline` | 상태 표시줄 설정 | | `/output-style [style]` | 출력 형식 설정 | **모델 선택:** ``` /model # 모델 목록 표시 /model sonnet # Sonnet 선택 /model opus # Opus 선택 /model haiku # Haiku 선택 ``` --- ### 코드 분석 & 리뷰 | 명령어 | 설명 | |--------|------| | `/review` | 대기 중인 변경사항 코드 리뷰 | | `/security-review` | 브랜치 변경사항 보안 리뷰 | **사용 예시:** ``` /review # 현재 변경사항 리뷰 /security-review # 보안 관점에서 분석 ``` --- ### 프로젝트 & 컨텍스트 | 명령어 | 설명 | |--------|------| | `/init` | CLAUDE.md로 프로젝트 초기화 | | `/memory` | CLAUDE.md 메모리 파일 편집 | | `/add-dir` | 추가 작업 디렉토리 포함 | | `/context` | 컨텍스트 사용량 시각화 | | `/compact [instructions]` | 대화 압축 (선택적 지시사항) | **사용 예시:** ``` /init # CLAUDE.md 생성 /memory # 메모리 편집 /add-dir /path/to/other/project # 다른 프로젝트 추가 /context # 컨텍스트 그리드 표시 /compact 최근 변경에 집중 # 특정 내용 유지하며 압축 ``` --- ### 도구 & 서비스 | 명령어 | 설명 | |--------|------| | `/mcp` | MCP 서버 연결 관리 및 인증 | | `/permissions` | 도구/파일 접근 권한 관리 | | `/sandbox` | 격리된 bash 실행 환경 활성화 | | `/bashes` | 백그라운드 bash 작업 목록 | | `/ide` | IDE 통합 설정 | | `/todos` | 현재 작업 목록 표시 | **사용 예시:** ``` /mcp # MCP 서버 상태 및 인증 /permissions # 현재 권한 설정 확인 /bashes # 실행 중인 백그라운드 작업 ``` --- ### 에이전트 & 플러그인 | 명령어 | 설명 | |--------|------| | `/agents` | 커스텀 AI 서브에이전트 관리 | | `/plugin` | Claude Code 플러그인 관리 | | `/hooks` | 도구 이벤트 설정 관리 | --- ### GitHub 통합 | 명령어 | 설명 | |--------|------| | `/install-github-app` | Claude GitHub Actions 설정 | | `/pr-comments` | PR 코멘트 보기 | --- ### 계정 관리 | 명령어 | 설명 | |--------|------| | `/login` | Anthropic 계정 전환 | | `/logout` | 현재 계정 로그아웃 | | `/privacy-settings` | 개인정보 설정 업데이트 | --- ### 사용량 & 비용 | 명령어 | 설명 | |--------|------| | `/cost` | 토큰 사용량 및 비용 표시 | | `/usage` | Rate limit 및 구독 정보 | **사용 예시:** ``` /cost # 현재 세션 비용 확인 /usage # 남은 할당량 확인 ``` --- ### 피드백 | 명령어 | 설명 | |--------|------| | `/bug` | Anthropic에 버그 신고 | | `/feedback` | 기능 요청 제출 | --- ## 커스텀 슬래시 명령어 만들기 자신만의 슬래시 명령어를 만들어 자주 사용하는 작업을 자동화할 수 있습니다. ### 저장 위치 | 위치 | 범위 | /help 표시 | |------|------|-----------| | `.claude/commands/` | 프로젝트 (팀 공유) | (project) | | `~/.claude/commands/` | 사용자 (모든 프로젝트) | (user) | ### 기본 구조 파일명: `command-name.md` ```markdown --- name: command-name description: 이 명령어가 하는 일 --- # Claude에게 주는 지시사항 여기에 상세한 지시사항을 작성합니다. ``` ### 프론트매터 옵션 ```yaml --- name: my-command description: 명령어 설명 model: opus # 사용할 모델 (선택) allowed-tools: # 허용할 도구 (선택) - Bash - Read - Write thinking: enabled # Extended Thinking (선택) max-thinking-tokens: 10000 --- ``` ### 인수 사용 | 변수 | 설명 | |------|------| | `$ARGUMENTS` | 모든 인수 | | `$1` | 첫 번째 인수 | | `$2` | 두 번째 인수 | | ... | ... | ### 예제 1: 코드 리뷰 명령어 `.claude/commands/review-file.md`: ```markdown --- name: review-file description: 특정 파일의 상세 코드 리뷰 allowed-tools: - Read - Grep --- # 코드 리뷰 다음 파일을 상세히 리뷰해주세요: $ARGUMENTS 리뷰 항목: 1. 코드 품질 및 가독성 2. 잠재적 버그 3. 성능 이슈 4. 보안 취약점 5. 개선 제안 각 항목에 대해 구체적인 피드백을 제공하세요. ``` **사용:** ``` /review-file src/api/auth.js ``` ### 예제 2: 테스트 생성 명령어 `.claude/commands/gen-test.md`: ```markdown --- name: gen-test description: 함수에 대한 단위 테스트 생성 allowed-tools: - Read - Write - Bash --- # 테스트 생성 다음 파일의 테스트를 생성해주세요: $1 요구사항: - Jest 프레임워크 사용 - 경계값 테스트 포함 - 에러 케이스 테스트 포함 - 테스트 파일은 __tests__ 폴더에 저장 ``` **사용:** ``` /gen-test src/utils/validator.js ``` ### 예제 3: 문서화 명령어 `~/.claude/commands/document.md`: ```markdown --- name: document description: 함수/클래스에 JSDoc 문서 추가 --- # 문서화 $ARGUMENTS 에 JSDoc 스타일 문서를 추가해주세요. 포함할 내용: - @description: 기능 설명 - @param: 모든 매개변수 - @returns: 반환값 - @throws: 발생 가능한 예외 - @example: 사용 예시 ``` ### 네임스페이스 사용 서브디렉토리로 명령어를 그룹화할 수 있습니다: ``` .claude/commands/ ├── review/ │ ├── security.md → /review:security │ ├── performance.md → /review:performance │ └── style.md → /review:style └── gen/ ├── test.md → /gen:test └── docs.md → /gen:docs ``` --- ## MCP 슬래시 명령어 연결된 MCP 서버가 제공하는 명령어입니다. ### 형식 ``` /mcp__<서버이름>__<프롬프트이름> [인수] ``` ### 예시 ``` /mcp__github__list_prs /mcp__github__get_issue 123 /mcp__notion__search_pages ``` MCP 서버 연결 후 `/help`에서 사용 가능한 MCP 명령어를 확인할 수 있습니다. --- ## 명령어 자동완성 명령어 입력 시 Tab으로 자동완성: ``` /re[Tab] → /resume, /review, /rewind, /release-notes ``` --- ## 자주 사용하는 명령어 조합 ### 새 프로젝트 시작 ``` /init /memory # 프로젝트 규칙 작성 /model opus ``` ### 코드 리뷰 워크플로우 ``` /review # 피드백 확인 /security-review # 보안 이슈 확인 ``` ### 세션 관리 ``` /context # 컨텍스트 상황 확인 /compact # 필요시 압축 /export review.md # 중요 내용 저장 ``` ### 디버깅 ``` /doctor # 시스템 점검 /status # 연결 상태 /cost # 사용량 확인 ``` --- ## 다음 단계 v4에서는 슬래시 명령어 전체를 다뤘습니다. **다음 v5에서는**: - Skills의 개념 - Skills 자동 활성화 메커니즘 - SKILL.md 작성법 - 실용적인 Skills 예제 를 상세히 알아봅니다. --- ## 빠른 참조 ``` 정보 /help /status /doctor 세션 /clear /exit /export /resume /rewind 설정 /config /model /vim /terminal-setup 코드 /review /security-review 프로젝트 /init /memory /add-dir /context /compact 도구 /mcp /permissions /sandbox /bashes 계정 /login /logout /cost /usage 피드백 /bug /feedback 커스텀 명령어 위치: 프로젝트: .claude/commands/ 사용자: ~/.claude/commands/ ``` --- *Claude CLI 완전 가이드 시리즈 v4/10*