슬래시 명령어

​

내장 슬래시 명령어

​

사용자 정의 슬래시 명령어

사용자 정의 슬래시 명령어를 사용하면 Claude Code가 실행할 수 있는 자주 사용하는 프롬프트를 Markdown 파일로 정의할 수 있습니다. 명령어는 범위(프로젝트별 또는 개인)에 따라 구성되며 디렉토리 구조를 통한 네임스페이싱을 지원합니다.

​

구문

/<command-name> [arguments]

​

매개변수

​

명령어 유형

​

프로젝트 명령어

저장소에 저장되어 팀과 공유되는 명령어입니다. /help에 나열될 때 이러한 명령어는 설명 뒤에 “(project)“를 표시합니다.

위치: .claude/commands/

다음 예제에서는 /optimize 명령어를 생성합니다:

# 프로젝트 명령어 생성
mkdir -p .claude/commands
echo "Analyze this code for performance issues and suggest optimizations:" > .claude/commands/optimize.md

​

개인 명령어

모든 프로젝트에서 사용할 수 있는 명령어입니다. /help에 나열될 때 이러한 명령어는 설명 뒤에 “(user)“를 표시합니다.

위치: ~/.claude/commands/

다음 예제에서는 /security-review 명령어를 생성합니다:

# 개인 명령어 생성
mkdir -p ~/.claude/commands
echo "Review this code for security vulnerabilities:" > ~/.claude/commands/security-review.md

​

기능

​

네임스페이싱

하위 디렉토리에서 명령어를 구성합니다. 하위 디렉토리가 명령어의 전체 이름을 결정합니다. 설명은 명령어가 프로젝트 디렉토리(.claude/commands)에서 오는지 사용자 수준 디렉토리(~/.claude/commands)에서 오는지 표시합니다.

사용자 수준과 프로젝트 수준 명령어 간의 충돌은 지원되지 않습니다. 그렇지 않으면 동일한 기본 파일 이름을 가진 여러 명령어가 공존할 수 있습니다.

예를 들어, .claude/commands/frontend/component.md에 있는 파일은 “(project)“를 표시하는 설명과 함께 /frontend:component 명령어를 생성합니다. 한편, ~/.claude/commands/component.md에 있는 파일은 “(user)“를 표시하는 설명과 함께 /component 명령어를 생성합니다.

​

인수

$ARGUMENTS 플레이스홀더를 사용하여 명령어에 동적 값을 전달합니다.

예를 들어:

# 명령어 정의
echo 'Fix issue #$ARGUMENTS following our coding standards' > .claude/commands/fix-issue.md

# 사용법
> /fix-issue 123

​

Bash 명령어 실행

! 접두사를 사용하여 슬래시 명령어가 실행되기 전에 bash 명령어를 실행합니다. 출력은 명령어 컨텍스트에 포함됩니다. Bash 도구와 함께 allowed-tools를 포함해야 하지만, 허용할 특정 bash 명령어를 선택할 수 있습니다.

예를 들어:

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a git commit
---

## Context

- Current git status: !`git status`
- Current git diff (staged and unstaged changes): !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -10`

## Your task

Based on the above changes, create a single git commit.

​

파일 참조

@ 접두사를 사용하여 파일 참조로 명령어에 파일 내용을 포함합니다.

예를 들어:

# 특정 파일 참조

Review the implementation in @src/utils/helpers.js

# 여러 파일 참조

Compare @src/old-version.js with @src/new-version.js

​

사고 모드

슬래시 명령어는 확장 사고 키워드를 포함하여 확장 사고를 트리거할 수 있습니다.

​

프론트매터

명령어 파일은 명령어에 대한 메타데이터를 지정하는 데 유용한 프론트매터를 지원합니다:

| 프론트매터 | 목적 | 기본값 | | :--- | :--- | :--- | --- | ---- | | allowed-tools | 명령어가 사용할 수 있는 도구 목록 | 대화에서 상속 | | argument-hint | 슬래시 명령어에 예상되는 인수입니다. 예: argument-hint: add [tagId] | remove [tagId] | list. 이 힌트는 슬래시 명령어를 자동 완성할 때 사용자에게 표시됩니다. | 없음 | | description | 명령어에 대한 간단한 설명 | 프롬프트의 첫 번째 줄 사용 | | model | opus, sonnet, haiku, 또는 특정 모델 문자열 | 대화에서 상속 |

예를 들어:

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: Create a git commit
model: haiku
---

An example command

​

MCP 슬래시 명령어

MCP 서버는 Claude Code에서 사용할 수 있는 슬래시 명령어로 프롬프트를 노출할 수 있습니다. 이러한 명령어는 연결된 MCP 서버에서 동적으로 발견됩니다.

​

명령어 형식

MCP 명령어는 다음 패턴을 따릅니다:

/mcp__<server-name>__<prompt-name> [arguments]

​

기능

​

동적 발견

MCP 명령어는 다음 조건에서 자동으로 사용할 수 있습니다:

• MCP 서버가 연결되어 활성 상태임
• 서버가 MCP 프로토콜을 통해 프롬프트를 노출함
• 연결 중에 프롬프트가 성공적으로 검색됨

​

인수

MCP 프롬프트는 서버에서 정의한 인수를 받을 수 있습니다:

# 인수 없이
> /mcp__github__list_prs

# 인수와 함께
> /mcp__github__pr_review 456
> /mcp__jira__create_issue "Bug title" high

​

명명 규칙

• 서버 및 프롬프트 이름이 정규화됨
• 공백과 특수 문자는 밑줄이 됨
• 일관성을 위해 이름이 소문자로 변환됨

​

MCP 연결 관리

/mcp 명령어를 사용하여:

• 구성된 모든 MCP 서버 보기
• 연결 상태 확인
• OAuth 지원 서버로 인증
• 인증 토큰 지우기
• 각 서버에서 사용 가능한 도구 및 프롬프트 보기

​

참고 항목

• 대화형 모드 - 단축키, 입력 모드 및 대화형 기능
• CLI 참조 - 명령줄 플래그 및 옵션
• 설정 - 구성 옵션
• 메모리 관리 - 세션 간 Claude의 메모리 관리