슬래시 명령어

​

내장 슬래시 명령어

​

사용자 정의 슬래시 명령어

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

​

구문

/<command-name> [arguments]

​

매개변수

​

명령어 유형

​

프로젝트 명령어

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

위치: .claude/commands/

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

# 프로젝트 명령어 생성
mkdir -p .claude/commands
echo "이 코드의 성능 문제를 분석하고 최적화를 제안하세요:" > .claude/commands/optimize.md

​

개인 명령어

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

위치: ~/.claude/commands/

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

# 개인 명령어 생성
mkdir -p ~/.claude/commands
echo "이 코드의 보안 취약점을 검토하세요:" > ~/.claude/commands/security-review.md

​

기능

​

네임스페이스

하위 디렉토리에서 명령어를 구성합니다. 하위 디렉토리는 구성을 위해 사용되며 명령어 설명에 나타나지만 명령어 이름 자체에는 영향을 주지 않습니다. 설명은 명령어가 프로젝트 디렉토리(.claude/commands)에서 오는지 사용자 수준 디렉토리(~/.claude/commands)에서 오는지를 하위 디렉토리 이름과 함께 표시합니다.

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

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

​

인수

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

$ARGUMENTS로 모든 인수

$ARGUMENTS 플레이스홀더는 명령어에 전달된 모든 인수를 캡처합니다:

# 명령어 정의
echo '우리의 코딩 표준에 따라 이슈 #$ARGUMENTS를 수정하세요' > .claude/commands/fix-issue.md

# 사용법
> /fix-issue 123 high-priority
# $ARGUMENTS는 "123 high-priority"가 됩니다

$1, $2 등으로 개별 인수

위치 매개변수를 사용하여 특정 인수에 개별적으로 액세스합니다 (셸 스크립트와 유사):

# 명령어 정의  
echo 'PR #$1을 우선순위 $2로 검토하고 $3에게 할당하세요' > .claude/commands/review-pr.md

# 사용법
> /review-pr 456 high alice
# $1은 "456", $2는 "high", $3은 "alice"가 됩니다

다음과 같은 경우에 위치 인수를 사용하세요:

• 명령어의 다른 부분에서 인수에 개별적으로 액세스해야 하는 경우
• 누락된 인수에 대한 기본값을 제공하는 경우
• 특정 매개변수 역할을 가진 더 구조화된 명령어를 구축하는 경우

​

Bash 명령어 실행

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

예를 들어:

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: git 커밋 생성
---

## 컨텍스트

- 현재 git 상태: !`git status`
- 현재 git diff (스테이징된 변경사항과 스테이징되지 않은 변경사항): !`git diff HEAD`
- 현재 브랜치: !`git branch --show-current`
- 최근 커밋: !`git log --oneline -10`

## 작업

위의 변경사항을 바탕으로 단일 git 커밋을 생성하세요.

​

파일 참조

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

예를 들어:

# 특정 파일 참조

@src/utils/helpers.js의 구현을 검토하세요

# 여러 파일 참조

@src/old-version.js와 @src/new-version.js를 비교하세요

​

사고 모드

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

​

프론트매터

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

예를 들어:

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: git 커밋 생성
model: claude-3-5-haiku-20241022
---

메시지와 함께 git 커밋 생성: $ARGUMENTS

위치 인수를 사용하는 예제:

---
argument-hint: [pr-number] [priority] [assignee]
description: 풀 리퀘스트 검토
---

PR #$1을 우선순위 $2로 검토하고 $3에게 할당하세요.
보안, 성능, 코드 스타일에 집중하세요.

​

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 "버그 제목" high

​

명명 규칙

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

​

MCP 연결 관리

/mcp 명령어를 사용하여:

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

​

MCP 권한 및 와일드카드

MCP 도구에 대한 권한을 구성할 때 와일드카드는 지원되지 않습니다:

• ✅ 올바름: mcp__github (github 서버의 모든 도구 승인)
• ✅ 올바름: mcp__github__get_issue (특정 도구 승인)
• ❌ 잘못됨: mcp__github__* (와일드카드 지원되지 않음)

MCP 서버의 모든 도구를 승인하려면 서버 이름만 사용하세요: mcp__servername. 특정 도구만 승인하려면 각 도구를 개별적으로 나열하세요.

​

참고 항목

• 신원 및 액세스 관리 - MCP 도구 권한을 포함한 권한에 대한 완전한 가이드
• 대화형 모드 - 단축키, 입력 모드 및 대화형 기능
• CLI 참조 - 명령줄 플래그 및 옵션
• 설정 - 구성 옵션
• 메모리 관리 - 세션 간 Claude의 메모리 관리