본문 바로가기

Claude Code 슬래시 명령어 — 내장 명령 + 커스텀 명령 만들기

/로 시작하는 Claude Code 슬래시 명령어를, 자주 쓰는 내장 명령과 .claude/commands로 만드는 커스텀 명령·인자·frontmatter까지 공식 문서 기준으로 정리했습니다.

글갱신

Claude Code 슬래시 명령어는 /로 시작하는 단축 명령으로, 세션을 제어하거나 자주 쓰는 작업을 한 번에 실행합니다. /help·/clear·/compact 같은 내장 명령이 수십 개 있고, 자주 쓰는 프롬프트를 Markdown 파일로 저장해 나만의 커스텀 명령도 만들 수 있습니다. (공식: code.claude.com/docs/en/slash-commands)

🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
🟢 현행 모델 라인업 일치 · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (상위 티어: Claude Fable 5.1). 이 안내는 새 모델이 출시될 때만 바뀝니다.

Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당

🟢 현행 모델 라인업 일치 · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (상위 티어: Claude Fable 5.1). 이 안내는 새 모델이 출시될 때만 바뀝니다.
0, 출력 $50)으로 이용합니다. 일회성
🟢 현행 모델 라인업 일치 · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (상위 티어: Claude Fable 5.1). 이 안내는 새 모델이 출시될 때만 바뀝니다.
00 크레딧은 Fable 5 전환 당시에만 지급됐고 5.1에는 없습니다. 일부 코딩·디버깅 요청은 보안 분류기에 의해 Opus 모델로 대체 응답될 수 있습니다(두 모델 공통). 자세한 내용은 Fable 5.1 가이드와 Fable 5 재개 안내를 참조하세요.

두 갈래: 내장 명령 + 커스텀 명령 내장 명령 (기본 제공) /help /clear /compact/model /config /cost/init /review/mcp /agents 세션 제어·작업 단축전체 목록은 /help (버전마다 다름) 커스텀 명령 (직접 정의) .claude/commands/optimize.md ↓ /optimize 파일명이 곧 명령 이름 출처: code.claude.com/docs/en/slash-commands · 기준 2026.6

슬래시 명령어란

슬래시 명령어는 인터랙티브 세션에서 Claude의 동작을 제어하는 /로 시작하는 단축키입니다. 크게 두 갈래입니다 — Claude Code가 기본으로 제공하는 내장 명령, 그리고 내가 직접 정의하는 커스텀 명령. 입력창에서 /만 쳐도 사용 가능한 명령이 자동완성으로 뜹니다.

자주 쓰는 내장 명령

버전에 따라 수십 개의 내장 명령이 있습니다(전체 목록은 /help로 확인). 자주 쓰는 것들입니다.

  • /help — 사용 가능한 명령 목록과 설명
  • /clear — 대화 맥락 비우기
  • /compact — 길어진 맥락을 요약해 압축
  • /model — 사용할 모델 선택
  • /config — 설정 보기·변경
  • /init — 코드베이스를 분석해 CLAUDE.md 생성
  • /review — 코드 리뷰
  • /cost — 토큰 사용량·비용 확인
  • /mcp — MCP 서버 연결·관리
  • /agents — 서브에이전트 관리
인자 받기 + 두 가지 저장 위치 파일 내용: Fix issue #$ARGUMENTS/fix-issue 123 → "Fix issue #123" 로 펼쳐져 실행 프로젝트 명령.claude/commands/git으로 팀 공유 개인 명령~/.claude/commands/내 모든 프로젝트에서 세부 문법은 공식 문서 기준 · 버전에 따라 다를 수 있음

커스텀 명령 만들기

자주 쓰는 프롬프트를 Markdown 파일로 저장하면 그게 곧 명령이 됩니다. 파일 이름(.md 제외)이 명령 이름입니다. 저장 위치는 두 가지입니다.

  • 프로젝트 명령 — .claude/commands/. 리포에 저장되어 git으로 팀과 공유됩니다(/help에서 "(project)" 표시).
  • 개인 명령 — ~/.claude/commands/. 내 컴퓨터의 모든 프로젝트에서 쓸 수 있습니다.

예를 들어 .claude/commands/optimize.md에 "이 코드의 성능 문제를 분석하고 개선안을 제안해줘"라고 적으면, 이후 /optimize로 호출됩니다. 디렉터리 구조로 네임스페이스를 둘 수도 있습니다(예: /test/add-edge-cases).

인자 넣기

명령에 값을 넘기려면 플레이스홀더를 씁니다. $ARGUMENTS는 입력한 인자 전체를 받고, $1·$2는 위치별로 받습니다. 예를 들어 파일에 "Fix issue #$ARGUMENTS"라고 적어 두면 /fix-issue 123은 "Fix issue #123"으로 펼쳐져 실행됩니다.

frontmatter 옵션

명령 파일 맨 위에 ---로 감싼 메타데이터를 둘 수 있습니다. 주요 항목은 description(설명), allowed-tools(허용 도구), argument-hint(인자 힌트), model(사용할 모델)입니다. 중요한 명령에 모델을 고정하면 기본 모델이 바뀌어도 동작이 흔들리지 않습니다(단 특정 모델 ID는 시간이 지나면 달라질 수 있습니다).

알아둘 점

  • 토큰을 씁니다 — 슬래시 명령은 공짜 단축이 아니라, 실행 시 토큰을 소비합니다.
  • Skills로 병합(진행 중) — 최근 안내에 따르면 커스텀 슬래시 명령이 Skills로 병합되었습니다. .claude/commands/ 파일은 계속 작동하지만, .claude/skills/(Skills)가 권장 방식으로 안내됩니다(진행 중이라 변동 가능).
  • MCP·플러그인 명령 — 연결된 MCP 서버의 프롬프트는 /mcp__서버__프롬프트 형태로, 플러그인 명령은 /플러그인:명령 형태로 노출됩니다.
  • 이름 충돌 — 내장 명령이 같은 이름의 커스텀보다 우선합니다. 겹치지 않는 이름을 고르세요.

관련 글

도구 호출 전후에 자동 규칙을 거는 훅(Hooks)은 /hooks 명령으로 설정합니다.

고지: 이 글은 Anthropic 공식 Claude Code 문서(code.claude.com)를 기준으로 작성했습니다. 내장 명령의 개수·목록은 버전에 따라 다르므로 /help로 확인하세요. 커스텀 슬래시 명령이 Skills로 병합되는 등 구조 변경이 진행 중인 것으로 안내되며(변동 가능), 모델 ID·세부 문법도 시간이 지나면 달라질 수 있습니다. 최신 정보는 공식 문서에서 확인하세요. 본 사이트는 Anthropic 공식 사이트가 아닙니다.

이 글이 도움이 됐나요?

이어서 읽어보세요