기본 제공 슬래시 명령어
| 명령어 | 목적 |
|---|---|
/add-dir | 추가 작업 디렉토리 추가 |
/agents | 특화된 작업을 위한 사용자 정의 AI 서브에이전트 관리 |
/bashes | 백그라운드 작업 나열 및 관리 |
/bug | 버그 보고 (Anthropic에 대화 전송) |
/clear | 대화 기록 삭제 |
/compact [instructions] | 선택적 포커스 지침을 포함한 대화 압축 |
/config | 설정 인터페이스 열기 (설정 탭) |
/context | 현재 컨텍스트 사용량을 색상 그리드로 시각화 |
/cost | 토큰 사용 통계 표시. 구독별 세부 사항은 비용 추적 가이드를 참조하세요. |
/doctor | Claude Code 설치 상태 확인 |
/exit | REPL 종료 |
/export [filename] | 현재 대화를 파일 또는 클립보드로 내보내기 |
/help | 사용 도움말 받기 |
/hooks | 도구 이벤트에 대한 훅 구성 관리 |
/ide | IDE 통합 관리 및 상태 표시 |
/init | CLAUDE.md 가이드로 프로젝트 초기화 |
/install-github-app | 리포지토리에 대한 Claude GitHub Actions 설정 |
/login | Anthropic 계정 전환 |
/logout | Anthropic 계정에서 로그아웃 |
/mcp | MCP 서버 연결 및 OAuth 인증 관리 |
/memory | CLAUDE.md 메모리 파일 편집 |
/model | AI 모델 선택 또는 변경 |
/output-style [style] | 출력 스타일을 직접 설정하거나 선택 메뉴에서 설정 |
/permissions | 권한 보기 또는 업데이트 |
/plan | 프롬프트에서 직접 계획 모드 진입 |
/plugin | Claude Code 플러그인 관리 |
/pr-comments | 풀 요청 댓글 보기 |
/privacy-settings | 개인정보 보호 설정 보기 및 업데이트 |
/release-notes | 릴리스 노트 보기 |
/rename <name> | 쉬운 식별을 위해 현재 세션 이름 바꾸기 |
/remote-env | 원격 세션 환경 구성 (claude.ai 구독자) |
/resume [session] | ID 또는 이름으로 대화 재개하거나 세션 선택기 열기 |
/review | 코드 검토 요청 |
/rewind | 대화 및/또는 코드 되감기 |
/sandbox | 더 안전하고 자율적인 실행을 위해 파일 시스템 및 네트워크 격리를 포함한 샌드박스 bash 도구 활성화 |
/security-review | 현재 브랜치의 보류 중인 변경 사항에 대한 보안 검토 완료 |
/stats | 일일 사용량, 세션 기록, 연속 기록 및 모델 선호도 시각화 |
/status | 설정 인터페이스 열기 (버전, 모델, 계정 및 연결성을 표시하는 상태 탭) |
/statusline | Claude Code의 상태 줄 UI 설정 |
/teleport | 세션 ID로 claude.ai에서 원격 세션 재개하거나 선택기 열기 (claude.ai 구독자) |
/terminal-setup | 줄바꿈을 위한 Shift+Enter 키 바인딩 설치 (VS Code, Alacritty, Zed, Warp) |
/theme | 색상 테마 변경 |
/todos | 현재 TODO 항목 나열 |
/usage | 구독 계획만 해당: 계획 사용 제한 및 속도 제한 상태 표시 |
/vim | 삽입 및 명령 모드를 번갈아 사용하는 vim 모드 진입 |
사용자 정의 슬래시 명령어
사용자 정의 슬래시 명령어를 사용하면 자주 사용하는 프롬프트를 Markdown 파일로 정의하여 Claude Code가 실행할 수 있습니다. 명령어는 범위(프로젝트별 또는 개인)로 구성되며 디렉토리 구조를 통한 네임스페이싱을 지원합니다.구문
매개변수
| 매개변수 | 설명 |
|---|---|
<command-name> | Markdown 파일명에서 파생된 이름 (.md 확장자 제외) |
[arguments] | 명령어에 전달되는 선택적 인수 |
명령어 유형
프로젝트 명령어
리포지토리에 저장되고 팀과 공유되는 명령어입니다./help에 나열될 때 이러한 명령어는 설명 뒤에 “(project)“를 표시합니다.
위치: .claude/commands/
다음 예제는 /optimize 명령어를 생성합니다:
개인 명령어
모든 프로젝트에서 사용 가능한 명령어입니다./help에 나열될 때 이러한 명령어는 설명 뒤에 “(user)“를 표시합니다.
위치: ~/.claude/commands/
다음 예제는 /security-review 명령어를 생성합니다:
기능
네임스페이싱
관련 명령어를 그룹화하려면 하위 디렉토리를 사용하세요. 하위 디렉토리는 명령어 설명에 나타나지만 명령어 이름에는 영향을 주지 않습니다. 예를 들어:.claude/commands/frontend/component.md는 설명이 “(project:frontend)“인/component를 생성합니다~/.claude/commands/component.md는 설명이 “(user)“인/component를 생성합니다
.claude/commands/deploy.md와 ~/.claude/commands/deploy.md가 모두 존재하면 /deploy는 프로젝트 버전을 실행합니다.
다른 하위 디렉토리의 명령어는 하위 디렉토리가 설명에 나타나 구별되므로 같은 이름을 공유할 수 있습니다. 예를 들어, .claude/commands/frontend/test.md와 .claude/commands/backend/test.md는 모두 /test를 생성하지만 각각 “(project:frontend)“와 “(project:backend)“로 표시됩니다.
인수
인수 자리 표시자를 사용하여 명령어에 동적 값을 전달합니다:$ARGUMENTS를 사용한 모든 인수
$ARGUMENTS 자리 표시자는 명령어에 전달된 모든 인수를 캡처합니다:
$1, $2 등을 사용한 개별 인수
위치 매개변수를 사용하여 특정 인수에 개별적으로 액세스합니다 (셸 스크립트와 유사):
- 명령어의 다른 부분에서 인수에 개별적으로 액세스
- 누락된 인수에 대한 기본값 제공
- 특정 매개변수 역할을 가진 더 구조화된 명령어 구축
Bash 명령어 실행
! 접두사를 사용하여 슬래시 명령어가 실행되기 전에 bash 명령어를 실행합니다. 출력은 명령어 컨텍스트에 포함됩니다. Bash 도구를 사용하여 allowed-tools를 포함해야 하지만 특정 bash 명령어를 선택할 수 있습니다.
예를 들어:
파일 참조
@ 접두사를 사용하여 명령어에 파일 내용을 포함하여 파일 참조합니다.
예를 들어:
사고 모드
슬래시 명령어는 확장 사고 키워드를 포함하여 확장 사고를 트리거할 수 있습니다.프론트매터
명령어 파일은 명령어에 대한 메타데이터를 지정하는 데 유용한 프론트매터를 지원합니다:| 프론트매터 | 목적 | 기본값 |
|---|---|---|
allowed-tools | 명령어가 사용할 수 있는 도구 목록 | 대화에서 상속됨 |
argument-hint | 슬래시 명령어에 필요한 인수입니다. 예: argument-hint: add [tagId] | remove [tagId] | list. 이 힌트는 슬래시 명령어를 자동완성할 때 사용자에게 표시됩니다. | 없음 |
description | 명령어에 대한 간단한 설명 | 프롬프트의 첫 번째 줄 사용 |
model | 특정 모델 문자열 (모델 개요 참조) | 대화에서 상속됨 |
disable-model-invocation | Skill 도구가 이 명령어를 호출하는 것을 방지할지 여부 | false |
hooks | 이 명령어의 실행 범위로 훅을 정의합니다. 명령어에 대한 훅 정의를 참조하세요. | 없음 |
명령어에 대한 훅 정의
슬래시 명령어는 명령어 실행 중에 실행되는 훅을 정의할 수 있습니다.hooks 필드를 사용하여 PreToolUse, PostToolUse 또는 Stop 핸들러를 지정합니다:
once: true 옵션은 세션당 한 번만 훅을 실행합니다. 첫 번째 성공적인 실행 후 훅이 제거됩니다.
명령어에 정의된 훅은 해당 명령어의 실행 범위로 지정되며 명령어가 완료되면 자동으로 정리됩니다.
전체 훅 구성 형식은 훅을 참조하세요.
플러그인 명령어
플러그인은 Claude Code와 원활하게 통합되는 사용자 정의 슬래시 명령어를 제공할 수 있습니다. 플러그인 명령어는 사용자 정의 명령어와 정확히 동일하게 작동하지만 플러그인 마켓플레이스를 통해 배포됩니다.플러그인 명령어 작동 방식
플러그인 명령어는:- 네임스페이스됨: 명령어는
/plugin-name:command-name형식을 사용하여 충돌을 방지할 수 있습니다 (플러그인 접두사는 이름 충돌이 없으면 선택 사항입니다) - 자동으로 사용 가능: 플러그인이 설치되고 활성화되면 해당 명령어가
/help에 나타납니다 - 완전히 통합됨: 모든 명령어 기능을 지원합니다 (인수, 프론트매터, bash 실행, 파일 참조)
플러그인 명령어 구조
위치: 플러그인 루트의commands/ 디렉토리
파일 형식: 프론트매터가 있는 Markdown 파일
기본 명령어 구조:
- 인수: 명령어 설명에서
{arg1}과 같은 자리 표시자 사용 - 하위 디렉토리: 네임스페이싱을 위해 하위 디렉토리에서 명령어 구성
- Bash 통합: 명령어는 셸 스크립트 및 프로그램을 실행할 수 있습니다
- 파일 참조: 명령어는 프로젝트 파일을 참조하고 수정할 수 있습니다
호출 패턴
직접 명령어 (충돌이 없을 때)
플러그인 접두사 (명확히 하기 위해 필요할 때)
인수 포함 (명령어가 지원하는 경우)
MCP 슬래시 명령어
MCP 서버는 프롬프트를 슬래시 명령어로 노출할 수 있으며, 이는 Claude Code에서 사용 가능하게 됩니다. 이러한 명령어는 연결된 MCP 서버에서 동적으로 발견됩니다.명령어 형식
MCP 명령어는 다음 패턴을 따릅니다:기능
동적 발견
MCP 명령어는 다음 경우에 자동으로 사용 가능합니다:- MCP 서버가 연결되고 활성화됨
- 서버가 MCP 프로토콜을 통해 프롬프트를 노출함
- 연결 중에 프롬프트가 성공적으로 검색됨
인수
MCP 프롬프트는 서버에서 정의한 인수를 수락할 수 있습니다:명명 규칙
서버 및 프롬프트 이름은 정규화됩니다:- 공백 및 특수 문자는 밑줄이 됨
- 일관성을 위해 이름은 소문자입니다
MCP 연결 관리
/mcp 명령어를 사용하여:
- 구성된 모든 MCP 서버 보기
- 연결 상태 확인
- OAuth 지원 서버로 인증
- 인증 토큰 삭제
- 각 서버의 사용 가능한 도구 및 프롬프트 보기
MCP 권한 및 와일드카드
MCP 서버의 모든 도구를 승인하려면 서버 이름 또는 와일드카드 구문을 사용합니다:mcp__github(모든 GitHub 도구 승인)mcp__github__*(와일드카드 구문, 모든 GitHub 도구도 승인)
mcp__github__get_issuemcp__github__list_issues
Skill 도구
Claude Code의 이전 버전에서는 슬래시 명령어 호출이 별도의
SlashCommand 도구에서 제공되었습니다. 이는 Skill 도구로 병합되었습니다. SlashCommand를 사용하는 기존 권한 규칙이 있는 경우 Skill을 사용하도록 업데이트하세요.Skill 도구를 사용하면 Claude가 대화 중에 사용자 정의 슬래시 명령어 및 에이전트 스킬을 프로그래밍 방식으로 호출할 수 있습니다. 이를 통해 Claude는 적절할 때 사용자를 대신하여 이러한 기능을 사용할 수 있습니다.
Skill 도구가 호출할 수 있는 것
Skill 도구는 다음에 대한 액세스를 제공합니다:
| 유형 | 위치 | 요구사항 |
|---|---|---|
| 사용자 정의 슬래시 명령어 | .claude/commands/ 또는 ~/.claude/commands/ | description 프론트매터가 있어야 함 |
| 에이전트 스킬 | .claude/skills/ 또는 ~/.claude/skills/ | disable-model-invocation: true가 없어야 함 |
/compact 및 /init과 같은 기본 제공 명령어는 이 도구를 통해 사용할 수 없습니다.
Claude가 특정 명령어를 사용하도록 권장
Claude가Skill 도구를 사용하도록 권장하려면 프롬프트 또는 CLAUDE.md 파일에서 슬래시를 포함한 명령어 이름을 참조하세요:
/context를 사용하여 토큰 사용량을 모니터링하세요.
Skill 도구에서 사용 가능한 명령어 및 스킬을 확인하려면 claude --debug를 실행하고 쿼리를 트리거하세요.
Skill 도구 비활성화
Claude가 프로그래밍 방식으로 명령어 또는 스킬을 호출하는 것을 방지하려면:
Skill 도구와 모든 명령어/스킬 설명이 컨텍스트에서 제거됩니다.
특정 명령어 또는 스킬 비활성화
특정 명령어 또는 스킬이Skill 도구를 통해 프로그래밍 방식으로 호출되는 것을 방지하려면 프론트매터에 disable-model-invocation: true를 추가하세요. 이렇게 하면 항목의 메타데이터도 컨텍스트에서 제거됩니다.
스킬의
user-invocable 필드는 메뉴 가시성만 제어하며 Skill 도구 액세스는 제어하지 않습니다. 프로그래밍 방식의 호출을 차단하려면 disable-model-invocation: true를 사용하세요. 자세한 내용은 스킬 가시성 제어를 참조하세요.Skill 권한 규칙
권한 규칙은 다음을 지원합니다:
- 정확한 일치:
Skill(/commit)(인수 없이/commit만 허용) - 접두사 일치:
Skill(/review-pr:*)(모든 인수를 포함한/review-pr허용)
문자 예산 제한
Skill 도구에는 컨텍스트 사용을 제한하기 위한 문자 예산이 포함되어 있습니다. 이는 많은 명령어 및 스킬을 사용할 수 있을 때 토큰 오버플로우를 방지합니다.
예산에는 각 항목의 이름, 인수 및 설명이 포함됩니다.
- 기본 제한: 15,000자
- 사용자 정의 제한:
SLASH_COMMAND_TOOL_CHAR_BUDGET환경 변수를 통해 설정합니다. 이름은 이전 버전과의 호환성을 위해 유지됩니다.
/context에서 경고는 포함된 항목의 수를 표시합니다.
스킬 대 슬래시 명령어
슬래시 명령어와 에이전트 스킬은 Claude Code에서 다른 목적을 제공합니다:슬래시 명령어 사용 대상
빠르고 자주 사용하는 프롬프트:- 자주 사용하는 간단한 프롬프트 스니펫
- 빠른 미리 알림 또는 템플릿
- 한 파일에 맞는 자주 사용하는 지침
/review→ “Review this code for bugs and suggest improvements”/explain→ “Explain this code in simple terms”/optimize→ “Analyze this code for performance issues”
스킬 사용 대상
구조가 있는 포괄적인 기능:- 여러 단계가 있는 복잡한 워크플로우
- 스크립트 또는 유틸리티가 필요한 기능
- 여러 파일에 걸쳐 구성된 지식
- 표준화하려는 팀 워크플로우
- 양식 채우기 스크립트 및 검증이 있는 PDF 처리 스킬
- 다양한 데이터 유형에 대한 참조 문서가 있는 데이터 분석 스킬
- 스타일 가이드 및 템플릿이 있는 문서 스킬
주요 차이점
| 측면 | 슬래시 명령어 | 에이전트 스킬 |
|---|---|---|
| 복잡성 | 간단한 프롬프트 | 복잡한 기능 |
| 구조 | 단일 .md 파일 | SKILL.md + 리소스가 있는 디렉토리 |
| 발견 | 명시적 호출 (/command) | 자동 (컨텍스트 기반) |
| 파일 | 한 파일만 | 여러 파일, 스크립트, 템플릿 |
| 범위 | 프로젝트 또는 개인 | 프로젝트 또는 개인 |
| 공유 | git를 통해 | git를 통해 |
예제 비교
슬래시 명령어로:/review (수동 호출)
스킬로:
각각을 사용할 때
슬래시 명령어 사용:- 같은 프롬프트를 반복적으로 호출합니다
- 프롬프트가 한 파일에 맞습니다
- 실행 시기를 명시적으로 제어하려고 합니다
- Claude가 기능을 자동으로 발견해야 합니다
- 여러 파일 또는 스크립트가 필요합니다
- 검증 단계가 있는 복잡한 워크플로우
- 팀이 표준화되고 상세한 지침이 필요합니다