Files
AX-Copilot/docs/claude-code-docs-main/18_슬래시커맨드.md

172 lines
6.4 KiB
Markdown

# 슬래시 커맨드
> 실행 중인 Claude Code 세션에서 입력하는 커맨드.
```
/command [인수]
```
세션 내에서 언제든 `/help`를 입력해 모든 커맨드를 볼 수 있습니다.
## 빠른 참조
| 커맨드 | 설명 |
|--------|------|
| `/init` | 프로젝트의 `CLAUDE.md` 파일 및 선택적 스킬/훅 생성 |
| `/memory` | Claude 메모리 파일 편집 (전역, 프로젝트, 로컬) |
| `/config` | 설정 패널 열기 |
| `/hooks` | 도구 이벤트의 훅 설정 보기 |
| `/mcp` | MCP 서버 관리 — 활성화, 비활성화, 재연결 |
| `/permissions` | 도구의 허용/차단 규칙 관리 |
| `/plan` | plan 모드 활성화 또는 현재 세션 계획 열기/설명 |
| `/model` | 현재 세션의 AI 모델 설정 |
| `/commit` | AI가 생성한 메시지로 git 커밋 생성 |
| `/review` | 풀 리퀘스트 검토 |
| `/skills` | 사용 가능한 스킬 목록 |
| `/compact` | 컨텍스트 사용량 줄이기 위해 대화 기록 요약 |
| `/clear` | 대화 기록 지우기 및 컨텍스트 해제 |
| `/help` | 도움말 및 사용 가능한 커맨드 표시 |
| `/login` | 로그인 또는 Anthropic 계정 전환 |
| `/logout` | Anthropic 계정에서 로그아웃 |
---
## 프로젝트 및 메모리 커맨드
### `/init`
코드베이스를 분석하고 `CLAUDE.md` 파일과 선택적으로 스킬과 훅을 설정합니다. Claude가 주요 프로젝트 파일(매니페스트, CI 설정, 빌드 스크립트, README)을 조사한 후 인터뷰를 통해 빠진 내용을 채우고 출력 파일을 작성합니다.
설정 내용(사용자 선택에 따라):
- **프로젝트 `CLAUDE.md`** — 팀 공유 지시사항, 소스 컨트롤에 커밋
- **개인 `CLAUDE.local.md`** — 이 프로젝트의 개인 설정(gitignore됨)
- **스킬** — 슬래시 커맨드로 호출하는 온디맨드 워크플로우
- **훅** — 도구 이벤트에서 자동으로 실행되는 결정론적 셸 커맨드
> 💡 언제든 `/init`을 다시 실행하세요. `CLAUDE.md`가 이미 있으면 Claude가 파일을 덮어쓰는 대신 구체적인 변경 사항을 제안합니다.
### `/memory`
Claude의 메모리 파일 대화형 에디터를 엽니다. 세 가지 메모리 범위:
| 범위 | 파일 | 적용 대상 |
|------|------|----------|
| 전역 | `~/.claude/CLAUDE.md` | 모든 프로젝트의 나 |
| 프로젝트 | 프로젝트 루트의 `CLAUDE.md` | 팀 전체 |
| 로컬 | 프로젝트 루트의 `CLAUDE.local.md` | 이 프로젝트의 나 (gitignore됨) |
---
## 설정 커맨드
### `/config` (별칭: `/settings`)
Claude Code 설정을 보고 편집하는 설정 패널 열기.
### `/hooks`
현재 세션에서 활성화된 훅 설정 표시. 훅을 만들거나 편집하려면 `/init`을 사용하거나 `.claude/settings.json`을 직접 편집하세요.
### `/mcp [enable|disable [server-name]]`
현재 세션의 MCP 서버 관리:
| 인수 | 효과 |
|------|------|
| (없음) | MCP 관리 패널 열기 |
| `enable` | 모든 비활성 MCP 서버 활성화 |
| `enable <server-name>` | 특정 서버 활성화 |
| `disable` | 모든 활성 MCP 서버 비활성화 |
| `disable <server-name>` | 특정 서버 비활성화 |
| `reconnect <server-name>` | 특정 서버에 재연결 |
> 📝 `/mcp enable/disable`로 만든 변경 사항은 현재 세션에만 적용됩니다.
### `/permissions` (별칭: `/allowed-tools`)
도구의 허용 및 차단 규칙을 보고 관리하는 권한 패널 열기.
### `/model [모델]`
세션의 AI 모델 설정:
```
/model
/model sonnet
/model claude-opus-4-5
```
---
## 세션 관리 커맨드
### `/plan [open|<설명>]`
| 인수 | 효과 |
|------|------|
| (없음) | plan 모드 토글 |
| `open` | 현재 계획 열기 및 표시 |
| `<설명>` | 주어진 설명으로 새 계획 생성 |
plan 모드에서 Claude는 어떤 작업도 실행하기 전에 작성된 계획을 만들고 승인을 기다립니다.
### `/compact [지시사항]`
대화 기록을 요약하고 컨텍스트 윈도우가 가득 차도 작업을 계속할 수 있게 합니다. 선택적 인수로 요약 방법을 지시할 수 있습니다.
```
/compact
/compact 데이터베이스 스키마 변경에만 집중해줘
/compact 완료된 최근 세 작업만 요약해줘
```
### `/clear` (별칭: `/reset`, `/new`)
전체 대화 기록을 지우고 컨텍스트를 해제해 동일한 작업 디렉토리에서 새 세션을 시작합니다. `/compact`와 달리 요약하는 대신 모든 기록을 제거합니다.
### `/skills`
현재 세션에서 사용 가능한 모든 스킬을 나열합니다.
---
## Git 커맨드
### `/commit`
AI가 생성한 커밋 메시지로 git 커밋을 만듭니다. Claude가 현재 git 상태와 diff를 읽고, 스테이징된 변경 사항을 분석하고, "무엇"이 아닌 "왜"에 초점을 맞춘 간결한 커밋 메시지를 작성합니다.
안전 규칙:
- 기존 커밋을 절대 amend하지 않음
- 훅을 건너뛰지 않음 (`--no-verify` 사용 안 함)
- 시크릿을 포함할 가능성이 있는 파일은 커밋하지 않음
- 변경 사항이 없으면 빈 커밋을 만들지 않음
> 📝 `/commit`은 `git add`, `git status`, `git commit`에만 접근 가능합니다. push, rebase 등의 다른 git 작업은 실행할 수 없습니다.
### `/review [PR-번호]`
GitHub CLI(`gh`)를 사용해 풀 리퀘스트에 AI 코드 리뷰를 실행합니다. PR 번호 없이 사용하면 열린 PR 목록을 표시합니다. 리뷰 내용:
- PR이 하는 일 개요
- 코드 품질 및 스타일 분석
- 구체적인 개선 제안
- 잠재적 문제 또는 리스크
- 성능, 테스트 커버리지, 보안 고려사항
> 📝 `/review`는 [GitHub CLI](https://cli.github.com/)(`gh`)가 설치되고 인증되어야 합니다.
---
## 계정 및 도움말 커맨드
### `/help`
현재 세션에서 사용 가능한 모든 슬래시 커맨드 목록 표시 — 내장 커맨드, 스킬 커맨드, 설치된 플러그인이 추가한 커맨드 포함.
### `/login`
Anthropic 계정에 로그인하거나 계정을 전환합니다.
### `/logout`
Anthropic 계정에서 로그아웃합니다. 로그아웃 후 다음 세션에서 다시 인증을 요청합니다.
---
## 커스텀 스킬 커맨드
`.claude/skills/<skill-name>/SKILL.md`에 스킬이 생성되면 해당 스킬이 로드된 모든 세션에서 `/<skill-name>`으로 사용할 수 있습니다.
```
/verify
/deploy staging
/fix-issue 123
```
`/skills`를 실행해 로드된 모든 스킬과 설명을 확인하세요.