본문으로 건너뛰기

커스텀 슬래시 명령어

중급

계속 다시 입력하게 되는 프롬프트를 하나의 /단어로 묶는 것이 커스텀 슬래시 명령어입니다. 한 번 정의하면 영원히 재사용할 수 있습니다(그리고 팀과 공유할 수 있습니다).

What you'll learn
  • 커스텀 명령어는 Skills로 통합되었습니다. .claude/commands/deploy.md 파일과 .claude/skills/deploy/SKILL.md 스킬은 둘 다 /deploy를 만들고 동일하게 동작합니다 — 기존 .claude/commands/ 파일은 계속 작동합니다. Skills는 보조 파일을 위한 디렉터리, 호출 제어 frontmatter, 그리고 관련 있을 때의 자동 로딩을 추가합니다. 한 파일짜리 프롬프트를 넘어서는 것이라면 Skill을 우선하세요.
What you'll learn
  • 커스텀 슬래시 명령어가 무엇이고 왜 프롬프트를 다시 입력하는 것보다 나은지 설명하기
  • 올바른 디렉터리에 Markdown 파일을 넣어 명령어 만들기
  • 위치로 프로젝트 명령어와 개인 명령어 구분하기
  • 구성 요소 사용하기: $ARGUMENTS, 임베드된 bash 출력, 파일 참조, frontmatter
  • 주어진 작업에 슬래시 명령어, 스킬, 서브에이전트 중 무엇을 쓸지 선택하기

작동 방식​

명령어는 그냥 Markdown 파일입니다. commands 디렉터리에 넣으면 파일명이 명령어가 됩니다. 파일 본문은 호출했을 때 Claude가 실행하는 프롬프트입니다.

파일의 위치가 범위를 결정합니다:

Guided walkthrough1 of 3
  1. .claude/commands/changelog.md 아래에 저장 → /changelog. 리포에 있으므로 팀 전체가 사용할 수 있습니다.
Pro tip
  • frontmatter가 아니라 파일명이 명령어 이름이 됩니다. changelog.md는 항상 /changelog입니다.

최소 예제​

완전한 명령어 파일 하나입니다. frontmatter는 description을 담고, 그 아래 모든 것이 프롬프트입니다.

commit.md — Conventional Commit 초안 작성

---
description: Draft a Conventional Commit message from the staged diff
---

Look at the staged changes with `git diff --cached` and write a single
Conventional Commit message (feat/fix/docs/refactor/chore). Output only the
message, no preamble.

이것을 commit.md로 저장하면 /commit이 매번 그 작업을 합니다. (파일명이 무엇이든 그것이 이름이 됩니다 — 같은 본문을 changelog.md로 저장하면 /changelog가 됩니다.)

유용한 구성 요소​

네 가지 재료가 정적인 프롬프트를 유연한 명령어로 바꿉니다:

구성 요소하는 일
$ARGUMENTS사용자가 명령어 뒤에 입력한 것을 주입합니다. /review src/auth.ts → 그 경로가 프롬프트에 들어갑니다.
bash 실행 후 출력 임베드명령어에 셸 출력(예: 현재 diff)을 포함시켜 Claude가 실시간 상태에 따라 동작하게 합니다.
파일 참조파일을 가리켜 그 내용을 포함시킵니다.
Frontmatterdescription(메뉴에 표시)와 기타 옵션.

인자, bash, 파일 참조의 정확한 문법은 공식 문서를 참고하세요.

훔쳐 쓸 만한 명령어​

시작용 세트가 Slash Command Library에 있습니다: 커밋 메시지, PR 설명, 코드 리뷰, changelog, 컴포넌트 스캐폴딩.

명령어 vs 스킬 vs 서브에이전트​

작업을 묶는 세 가지 방법 — 차이는 누가 트리거하는가와 얼마나 격리되어 실행되는가입니다:

  • 슬래시 명령어 — 당신이 아는 워크플로를 필요할 때 트리거합니다.
  • 스킬 — Claude가 관련 있을 때 자동으로 전문성을 로드합니다.
  • 서브에이전트 — 작업 덩어리를 격리된 에이전트에 위임합니다.
Enter 또는 스페이스 키를 눌러 카드를 뒤집습니다. 좌우 화살표 키로 카드를 이동할 수 있습니다.용어가 표시되었습니다.
1 / 6

스스로 점검하기

0/4
  1. 팀 전체가 리포에서 슬래시 명령어를 받게 하려면 어디에 저장하나요?
  2. 슬래시 명령어의 이름을 결정하는 것은 무엇인가요?
  3. 명령어에서 $ARGUMENTS는 무엇을 하나요?
  4. 당신이 트리거하지 않아도 관련 있을 때 Claude가 자동으로 로드하는 묶음 방식은 무엇인가요?

다음​