슬래시 명령어

​

내장 슬래시 명령어

​

사용자 정의 슬래시 명령어

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

​

구문

/<prefix>:<command-name> [arguments]

​

매개변수

​

명령어 유형

​

프로젝트 명령어

저장소에 저장되어 팀과 공유되는 명령어입니다.

위치: .claude/commands/
접두사: /project:

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

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

​

개인 명령어

모든 프로젝트에서 사용할 수 있는 명령어입니다.

위치: ~/.claude/commands/
접두사: /user:

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

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

​

기능

​

네임스페이스

하위 디렉토리에서 명령어를 구성하여 네임스페이스 명령어를 생성합니다.

구조: <prefix>:<namespace>:<command>

예를 들어, .claude/commands/frontend/component.md에 있는 파일은 /project:frontend:component 명령어를 생성합니다

​

인수

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

예를 들어:

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

# 사용법
> /project:fix-issue 123

​

Bash 명령어 실행

! 접두사를 사용하여 슬래시 명령어가 실행되기 전에 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를 비교하세요

​

사고 모드

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

​

파일 형식

명령어 파일은 다음을 지원합니다:

• Markdown 형식 (.md 확장자)
• 메타데이터를 위한 YAML frontmatter:
  • allowed-tools: 명령어가 사용할 수 있는 도구 목록
  • description: 명령어에 대한 간단한 설명
• bash 명령어(!)와 파일 참조(@)를 사용한 동적 콘텐츠
• 주요 콘텐츠로서의 프롬프트 지침

​

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 지원 서버로 인증
• 인증 토큰 지우기
• 각 서버에서 사용 가능한 도구 및 프롬프트 보기

​

참고 항목

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