슬래시 명령어란? — 단축키처럼 사용하는 AI 자동화
Claude Code를 처음 쓰면 자연스럽게 "AI한테 말하듯이" 지시를 내립니다. "이 코드 리뷰해줘", "커밋 메시지 만들어줘" 같은 식으로요. 그런데 같은 작업을 매일 반복한다면 어떨까요? 매번 긴 문장으로 설명하는 건 비효율적입니다.
슬래시 명령어(/명령어)는 이 문제를 해결합니다. 자주 사용하는 복잡한 프롬프트를 /commit, /review처럼 짧은 명령어 하나로 압축합니다. 키보드 단축키와 같은 개념이지만 AI 프롬프트에 적용한 것입니다.
슬래시 명령어는 Claude Code 내에서 /를 입력하면 자동 완성 목록이 표시됩니다. 기본 내장 명령어와 사용자가 직접 만든 커스텀 명령어가 모두 나타납니다.
기본 명령어 10개 — /help, /clear, /compact, /cost, /model 등
Claude Code에는 처음부터 내장된 시스템 명령어들이 있습니다. 이 명령어들은 Claude Code 자체의 동작을 제어합니다.
| 명령어 | 기능 | 사용 예 |
|---|---|---|
/help | 사용 가능한 명령어 목록 표시 | /help |
/clear | 대화 기록 초기화 | /clear |
/compact | 대화 내용 압축 (컨텍스트 절약) | /compact |
/cost | 현재 세션 비용 확인 | /cost |
/model | 사용할 AI 모델 변경 | /model claude-opus-4-5 |
/status | 현재 상태 및 설정 확인 | /status |
/vim | Vim 키바인딩 모드 전환 | /vim |
/bug | 버그 리포트 전송 | /bug 오작동 설명 |
/doctor | 설치 상태 진단 | /doctor |
/logout | 로그아웃 | /logout |
개발 워크플로우 명령어 — /commit, /review, /pr, /fix
내장 명령어 외에도, Claude Code는 개발 워크플로우와 관련된 유용한 스킬 명령어들을 지원합니다. 이 명령어들은 설치된 스킬에 따라 달라질 수 있습니다.
/commit — 스마트 커밋 메시지 생성
/commit을 실행하면 현재 스테이징된 변경 사항을 분석하고 의미 있는 커밋 메시지를 자동으로 생성합니다. 단순히 "파일 변경"이 아니라 실제 변경의 의도와 영향을 반영한 메시지를 만들어냅니다.
# 스테이징 후 실행
git add .
/commit
# 결과 예시:
# feat: 사용자 인증에 JWT 토큰 갱신 로직 추가
#
# - 액세스 토큰 만료 시 자동 갱신 구현
# - 리프레시 토큰 검증 강화
# - 관련 테스트 케이스 추가/review — AI 코드 리뷰
/review는 현재 변경 사항에 대한 코드 리뷰를 수행합니다. 버그, 보안 취약점, 코드 품질 문제를 분석합니다.
/review
# 또는 특정 파일 지정
/review src/auth/jwt.ts커스텀 명령어 만들기 — .claude/commands/ 폴더 구조
커스텀 명령어의 진짜 가치는 팀의 반복 작업을 표준화할 수 있다는 것입니다. 프로젝트 루트의 .claude/commands/ 폴더에 마크다운 파일을 만들면 자동으로 슬래시 명령어가 됩니다.
프로젝트/
├── .claude/
│ └── commands/
│ ├── review.md → /review 명령어
│ ├── deploy-check.md → /deploy-check 명령어
│ ├── api-docs.md → /api-docs 명령어
│ └── security-scan.md → /security-scan 명령어
└── src/파일 이름이 명령어 이름이 됩니다. review.md는 /review로 실행됩니다. 전역으로 사용하려면 ~/.claude/commands/에 저장합니다.
명령어 인자 활용법 — $ARGUMENTS 변수 사용
커스텀 명령어에서 $ARGUMENTS 변수를 사용하면 실행 시 인자를 받을 수 있습니다. 이를 통해 유연한 명령어를 만들 수 있습니다.
# .claude/commands/test-feature.md
주어진 기능에 대한 테스트 코드를 작성합니다.
## 대상 기능
$ARGUMENTS
## 요구사항
- 단위 테스트와 통합 테스트 모두 작성
- 경계값 케이스 포함
- 에러 케이스 커버
- 테스트 커버리지 80% 이상 달성실행: /test-feature 사용자 로그인 API
강력한 커스텀 명령어 5가지 예제
예제 1: PR 준비 자동화 (/pr-ready)
# .claude/commands/pr-ready.md
PR 제출 전 최종 점검을 수행합니다.
다음 단계를 순서대로 실행해주세요:
1. git diff HEAD~1..HEAD로 변경 사항 확인
2. 변경된 모든 파일에 대해 코드 품질 검토
3. 보안 취약점 스캔 (하드코딩된 시크릿, SQL 인젝션 등)
4. 테스트 커버리지 확인
5. PR 제목과 설명 초안 작성 (한국어)
결과를 단계별로 보고하고, 수정이 필요한 사항이 있으면 명확히 알려주세요.예제 2: 문서 자동 생성 (/doc-gen)
# .claude/commands/doc-gen.md
대상 파일이나 모듈에 대한 문서를 생성합니다.
## 대상
$ARGUMENTS
## 생성할 문서
- 함수/클래스별 JSDoc 주석 추가
- README.md의 API 섹션 업데이트
- 사용 예제 코드 추가
한국어와 영어를 함께 작성해주세요.예제 3: 성능 분석 (/perf-check)
# .claude/commands/perf-check.md
현재 코드베이스의 성능 이슈를 분석합니다.
다음 항목을 검토해주세요:
1. N+1 쿼리 문제
2. 불필요한 재렌더링 (React 컴포넌트)
3. 메모리 누수 가능성
4. 비효율적인 반복문이나 중첩 루프
5. 불필요한 API 호출
각 이슈에 대해 위치, 원인, 개선 방법을 설명해주세요.예제 4: 의존성 업데이트 가이드 (/dep-update)
# .claude/commands/dep-update.md
package.json의 의존성 업데이트 작업을 도와줍니다.
1. npm outdated 또는 pnpm outdated 실행
2. 각 패키지의 변경 사항 분석
3. Breaking change가 있는 패키지 식별
4. 안전하게 업데이트할 수 있는 패키지 목록 작성
5. 단계별 업데이트 계획 제시
주요 버전 업그레이드는 별도로 처리하고, 마이너/패치 업데이트를 먼저 진행하세요.예제 5: 코드 리뷰 체크리스트 (/review-checklist)
# .claude/commands/review-checklist.md
현재 변경 사항에 대해 다음 체크리스트를 기준으로 코드 리뷰를 수행합니다.
## 보안 체크리스트
- [ ] 하드코딩된 시크릿이 없는가?
- [ ] 사용자 입력이 검증되는가?
- [ ] SQL 인젝션 위험이 없는가?
- [ ] XSS 취약점이 없는가?
## 코드 품질 체크리스트
- [ ] 함수가 50줄 이하인가?
- [ ] 중복 코드가 없는가?
- [ ] 에러 처리가 적절한가?
- [ ] 의미 있는 변수명을 사용하는가?
## 테스트 체크리스트
- [ ] 새 기능에 테스트가 있는가?
- [ ] 엣지 케이스가 커버되는가?
각 항목을 점검하고 문제가 있으면 구체적인 개선 방법을 제시해주세요.팁: 명령어 파일에 YAML frontmatter로 메타데이터를 추가할 수 있습니다. description 필드를 추가하면 /help에서 설명이 표시됩니다.
팀에서 명령어 공유하기 — .claude/commands/ 버전관리
.claude/commands/ 폴더를 Git 저장소에 커밋하면 팀 전체가 같은 명령어를 공유할 수 있습니다. 이것이 커스텀 명령어의 가장 강력한 활용 방법입니다.
모든 팀원이 같은 코드 리뷰 기준, 같은 PR 준비 과정, 같은 문서 작성 형식을 자동으로 따르게 됩니다. 신입 팀원도 /review-checklist 한 번으로 팀의 코드 리뷰 기준을 즉시 적용할 수 있습니다.
# .gitignore에 추가하지 말 것 (팀 공유용)
# .claude/commands/ 는 반드시 버전 관리에 포함
# .gitignore에 추가할 것 (개인 설정)
.claude/settings.local.json슬래시 명령어는 팀의 베스트 프랙티스를 코드로 문서화하는 방법입니다. "항상 이렇게 해야 한다"는 규칙을 명령어로 만들면 자연스럽게 팀 문화가 됩니다.