[Claude Code 스킬] 커스텀 슬래시 커맨드 — 자주 쓰는 프롬프트를 /명령어 하나로 | DAKER 커뮤니티
매번 똑같은 긴 프롬프트를 복붙하고 계신가요? "이 코드 리뷰해줘, 보안·성능·엣지케이스 순서로, 우리 컨벤션 지켜서…" 이 한 덩어리를 파일 하나로 굳혀 두면 다음부터는 /review 한 줄이면 됩니다. 요리로 치면, 매번 레시피를 처음부터 읊는 대신 이름표 붙은 밀키트를 꺼내는 셈이죠.
■ 무엇
커스텀 슬래시 커맨드는 자주 쓰는 프롬프트를 마크다운 파일 하나로 저장해 두고 /이름 으로 불러 쓰는 기능입니다. 파일명이 곧 명령어 이름이 됩니다 — review.md 는 /review 가 되죠. 별도 설정도, 재시작도 없습니다. 폴더에 파일을 넣는 순간 Claude Code가 자동으로 인식합니다.
아래 그림은 커맨드가 저장되는 두 위치(프로젝트용·개인용)와 이름 규칙을 정리한 것입니다.
■ 언제 쓰나
같은 형식의 작업을 반복할 때: 코드 리뷰, 커밋 메시지 생성, 테스트 작성, 릴리스 노트 정리
팀이 프롬프트를 공유·표준화하고 싶을 때:
.claude/commands/에 두고 git에 커밋하면 팀 전체가 같은/review를 씁니다손이 기억하는 단축키가 필요할 때: 긴 지시문을 외우지 않고 슬래시(
/)만 누르면 등록된 커맨드가 자동완성됩니다
저장 위치가 곧 사용 범위(scope)를 정합니다. 프로젝트 전용은 .claude/commands/, 어느 프로젝트에서나 쓰는 개인용은 ~/.claude/commands/ 에 둡니다. 하위 폴더는 네임스페이스가 되어 test/unit.md 가 /test:unit 처럼 묶입니다.
■ 사용법
1) 파일을 만든다 — .claude/commands/review.md
---
description: 변경분을 보안·성능·정확성 기준으로 리뷰
argument-hint: [파일경로]
allowed-tools: Bash(git diff:*)
---
아래 변경분을 리뷰해줘.
대상: $ARGUMENTS
변경 내용: !`git diff HEAD`
보안 → 성능 → 엣지케이스 순으로, 우리 컨벤션(@docs/style.md)에 맞춰 지적해줘.2) 부른다
/review src/auth.ts이때 세 가지 자리표시자(placeholder)가 채워집니다. 아래 그림은 커맨드 파일의 구조와, 부르는 순간 무엇이 채워지는지를 보여줍니다.
$ARGUMENTS: 내가 뒤에 적은 입력이 그대로 들어갑니다($1,$2처럼 위치별로도 가능). 위 예시에선src/auth.ts가 들어가죠.!`명령어`: 그 자리에서 bash를 실행해 출력 결과를 프롬프트에 붙여 넣습니다.git diff HEAD의 실제 변경분이 들어가는 식이죠. 단, frontmatter의allowed-tools에 허용한 명령만 실행됩니다.@경로: 파일 내용을 읽어 프롬프트에 끼워 넣습니다.
즉 커맨드 파일은 프롬프트 템플릿이고, 부르는 순간 빈칸이 채워진 완성된 프롬프트가 마치 내가 직접 타이핑한 것처럼 Claude에게 전달됩니다.
frontmatter(파일 맨 위 --- 블록)의 네 필드는 모두 선택입니다. 역할을 아래 치트시트로 정리했습니다.
■ 팁
작게 시작하세요. 방금 길게 쳐서 잘 먹힌 프롬프트가 있다면, 그걸 그대로
.md파일로 저장하는 게 가장 좋은 첫 커맨드입니다. 처음부터 완벽한 설계는 필요 없습니다.allowed-tools 는 좁게.
Bash(git:*)처럼 꼭 필요한 범위만 허용하면, 커맨드가 의도치 않은 명령을 실행하는 사고를 막는 안전벨트가 됩니다.
참고: 2026년 4월 v2.1.101부터 슬래시 커맨드는 Skills 체계로 통합됐지만, /이름 으로 부르는 사용법은 그대로입니다. 기존 .claude/commands/ 파일도 그대로 계속 동작합니다.