내장 슬래시 명령어

명령어목적
/add-dir추가 작업 디렉토리 추가
/agents전문 작업을 위한 사용자 정의 AI 하위 에이전트 관리
/bug버그 신고 (대화를 Anthropic에 전송)
/clear대화 기록 지우기
/compact [instructions]선택적 집중 지침과 함께 대화 압축
/config구성 보기/수정
/cost토큰 사용량 통계 표시
/doctorClaude Code 설치 상태 확인
/help사용법 도움말 보기
/initCLAUDE.md 가이드로 프로젝트 초기화
/loginAnthropic 계정 전환
/logoutAnthropic 계정에서 로그아웃
/mcpMCP 서버 연결 및 OAuth 인증 관리
/memoryCLAUDE.md 메모리 파일 편집
/modelAI 모델 선택 또는 변경
/permissions권한 보기 또는 업데이트
/pr_comments풀 리퀘스트 댓글 보기
/review코드 리뷰 요청
/status계정 및 시스템 상태 보기
/terminal-setup줄바꿈을 위한 Shift+Enter 키 바인딩 설치 (iTerm2 및 VSCode만)
/vim삽입 모드와 명령 모드를 번갈아 사용하는 vim 모드 진입

사용자 정의 슬래시 명령어

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

구문

/<command-name> [arguments]

매개변수

매개변수설명
<command-name>Markdown 파일명에서 파생된 이름 (.md 확장자 제외)
[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특정 모델 문자열 (모델 개요 참조)대화에서 상속

예를 들어:

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

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

참고 항목