Claude Code 슬래시 명령어는 /로 시작하는 단축 명령으로, 세션을 제어하거나 자주 쓰는 작업을 한 번에 실행합니다. /help·/clear·/compact 같은 내장 명령이 수십 개 있고, 자주 쓰는 프롬프트를 Markdown 파일로 저장해 나만의 커스텀 명령도 만들 수 있습니다. (기준 시점: 2026년 6월 · 공식: docs.anthropic.com/claude-code/slash-commands)
슬래시 명령어란
슬래시 명령어는 인터랙티브 세션에서 Claude의 동작을 제어하는 /로 시작하는 단축키입니다. 크게 두 갈래입니다 — Claude Code가 기본으로 제공하는 내장 명령, 그리고 내가 직접 정의하는 커스텀 명령. 입력창에서 /만 쳐도 사용 가능한 명령이 자동완성으로 뜹니다.
자주 쓰는 내장 명령
버전에 따라 수십 개의 내장 명령이 있습니다(전체 목록은 /help로 확인). 자주 쓰는 것들입니다.
/help— 사용 가능한 명령 목록과 설명/clear— 대화 맥락 비우기/compact— 길어진 맥락을 요약해 압축/model— 사용할 모델 선택/config— 설정 보기·변경/init— 코드베이스를 분석해 CLAUDE.md 생성/review— 코드 리뷰/cost— 토큰 사용량·비용 확인/mcp— MCP 서버 연결·관리/agents— 서브에이전트 관리
커스텀 명령 만들기
자주 쓰는 프롬프트를 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__서버__프롬프트형태로, 플러그인 명령은/플러그인:명령형태로 노출됩니다. - 이름 충돌 — 내장 명령이 같은 이름의 커스텀보다 우선합니다. 겹치지 않는 이름을 고르세요.
관련 글
- 사용법 가이드 — 설치 후 실제로 쓰기
- Claude Code Skills — SKILL.md로 능력 확장
- CLAUDE.md 가이드 — /init로 생성
- Claude Code란? — 개념 입문
고지: 이 글은 Anthropic 공식 Claude Code 문서(docs.anthropic.com·code.claude.com)를 기준으로 작성했습니다. 내장 명령의 개수·목록은 버전에 따라 다르므로 /help로 확인하세요. 커스텀 슬래시 명령이 Skills로 병합되는 등 구조 변경이 진행 중인 것으로 안내되며(변동 가능), 모델 ID·세부 문법도 시간이 지나면 달라질 수 있습니다. 최신 정보는 공식 문서에서 확인하세요. 본 사이트는 Anthropic 공식 사이트가 아닙니다.