Claude Code 슬래시 커맨드 만들기 — 자주 쓰는 프롬프트 저장법

Claude Code 입문

Claude Code를 쓰다 보면 같은 프롬프트를 반복 입력하게 돼요. 슬래시 커맨드를 사용하면 자주 쓰는 프롬프트를 저장하고 단축키처럼 꺼내 쓸 수 있어요. 등록 방법부터 실전 예시, 관리 팁까지 한 번에 정리했어요.

📌 3줄 요약

• 반복되는 긴 프롬프트를 .claude/commands/ 폴더에 마크다운 파일로 저장하면 슬래시 커맨드가 자동 생성돼요.
• $ARGUMENTS 변수를 활용하면 하나의 커맨드로 다양한 파일·상황에 대응할 수 있어요.
• 팀 프로젝트에서는 커맨드 폴더를 Git에 포함시켜 작업 방식을 통일할 수 있어요.

📑 목차

• 1. 같은 프롬프트를 반복 입력하는 문제
• 2. 커스텀 슬래시 커맨드 등록 방법
• 3. 실전에서 유용한 슬래시 커맨드 예시
• 4. 슬래시 커맨드 관리와 주의할 점

같은 프롬프트를 반복 입력하는 문제

Claude Code를 쓰다 보면 비슷한 지시를 반복 입력하는 순간이 생겨요. "이 코드 리뷰해줘", "커밋 메시지 작성해줘", "테스트 코드 만들어줘" 같은 요청을 매번 타이핑하고 있다면 시간 낭비예요. 처음 한두 번은 괜찮지만, 하루에 같은 말을 열 번 넘게 쓰다 보면 슬슬 귀찮아지기 시작해요. 복사-붙여넣기를 해도 결국 메모장이나 어딘가에 저장해둔 프롬프트를 찾아야 하니까 번거로운 건 마찬가지예요.

특히 프롬프트(prompt)가 길어질수록 문제가 심해져요. 세부 조건까지 포함하면 한 번에 5줄, 10줄씩 쓰는 경우도 있어요. 예를 들어 "코드 리뷰를 하되, 보안 취약점도 체크하고, 성능 개선점도 찾고, 결과는 표 형식으로 정리해줘"처럼 조건을 붙이면 프롬프트 자체가 하나의 문서가 돼요. 이걸 매번 기억해서 입력하는 건 사실상 불가능하고, 빼먹는 조건이 생기면 결과 품질도 들쭉날쭉해져요.

🔍 슬래시 커맨드란?
터미널에서 /review처럼 짧은 명령어 하나만 입력하면, 미리 저장해둔 긴 프롬프트가 자동으로 실행되는 기능이에요. 마치 스마트폰의 텍스트 단축키처럼, 짧은 키워드가 긴 문장으로 확장되는 원리와 같아요.

Claude Code에는 /help, /clear 같은 기본 슬래시 커맨드가 내장되어 있어요. 여기에 자신만의 커스텀 커맨드를 추가할 수 있다는 것이 핵심이에요. 기본 커맨드만 쓰는 단계에서 커스텀 커맨드를 직접 만드는 단계로 넘어가면, Claude Code 활용 수준이 확 달라져요.

💬 제가 직접 써보니까, 하루에 같은 형태의 요청을 10번 이상 하는 경우가 많았어요. 슬래시 커맨드 하나 등록해두면 그 반복이 완전히 사라져요. 등록에 걸리는 시간은 1분도 안 되는데, 절약되는 시간은 하루 30분 이상이에요.

커스텀 슬래시 커맨드 등록 방법

커스텀 슬래시 커맨드는 .claude/commands/ 폴더에 마크다운 파일을 만드는 것만으로 등록돼요. 별도의 설정 메뉴나 복잡한 과정이 필요 없어요. 코딩을 전혀 몰라도 텍스트 파일 하나만 만들면 되기 때문에 진입 장벽이 정말 낮아요.

먼저 프로젝트 루트에서 .claude/commands/ 디렉토리를 생성해요. 터미널에 아래 명령어를 입력하면 돼요.

mkdir -p .claude/commands

 

이제 이 폴더 안에 마크다운(.md) 파일을 만들어요. 파일 이름이 곧 슬래시 커맨드의 이름이 돼요. 예를 들어 review.md라는 파일을 만들면 /review 커맨드가 자동으로 생성되는 구조예요.

예를 들어 코드 리뷰 커맨드를 만들고 싶다면 review.md라는 파일을 생성해요. 파일 안에는 실행할 프롬프트 내용을 그대로 적으면 돼요. 특별한 문법이나 형식 없이, Claude에게 보내고 싶은 말을 일반 문장으로 작성하면 돼요.

현재 열려 있는 파일의 코드를 리뷰해주세요. 버그 가능성, 성능 이슈, 가독성 개선점을 각각 분리해서 알려주세요. 심각도를 상/중/하로 표시해주세요.

이렇게 저장하면 Claude Code 터미널에서 /review를 입력하는 것만으로 위 프롬프트 전체가 실행돼요.

 

파일명에 하이픈(-)을 넣으면 /code-review처럼 여러 단어 조합도 가능해요. 대소문자 구분은 없으니 편한 이름을 사용하면 돼요.

저장 위치	적용 범위	용도
.claude/commands/	해당 프로젝트만	프로젝트별 전용 커맨드
~/.claude/commands/	모든 프로젝트 공유	개인 공통 커맨드

이 구분만 기억하면 관리가 훨씬 편해져요. 회사 프로젝트에서만 쓰는 커맨드와 개인적으로 항상 쓰는 커맨드를 분리할 수 있어서 깔끔해요.

💡 팁
슬래시 커맨드에는 $ARGUMENTS라는 변수도 쓸 수 있어요. /review utils.py처럼 뒤에 인자를 붙이면, 프롬프트 안의 $ARGUMENTS 자리에 utils.py가 들어가요. 이 기능 덕분에 커맨드 하나로 다양한 파일이나 상황에 대응할 수 있어요. 매번 새로운 커맨드를 만들 필요 없이, 하나의 템플릿으로 여러 상황을 커버하는 셈이에요.

실전에서 유용한 슬래시 커맨드 예시

가장 자주 쓰게 되는 커맨드 몇 가지를 소개할게요. 아래 예시를 그대로 복사해서 .claude/commands/ 폴더에 저장하면 바로 사용할 수 있어요. 실제로 저도 이 커맨드들을 매일 쓰고 있어요.

1 커밋 메시지 자동 생성 — commit.md

현재 스테이징된 변경사항을 확인하고, Conventional Commits 형식으로 커밋 메시지를 작성해주세요. 제목은 50자 이내, 본문은 변경 이유를 포함해주세요.

git add 후 /commit만 입력하면 커밋 메시지가 자동으로 만들어져요. 변경 내용을 분석해서 feat:, fix:, refactor: 같은 접두사까지 자동으로 붙여주니까 커밋 히스토리가 깔끔해져요.

 

2 테스트 코드 생성 — test.md

$ARGUMENTS 파일에 대한 단위 테스트를 작성해주세요. 기존 프로젝트의 테스트 패턴을 따라주세요. 엣지 케이스를 최소 2개 포함해주세요.

/test auth.py처럼 파일명을 붙여서 실행하면, 해당 파일에 맞는 테스트가 생성돼요. $ARGUMENTS 덕분에 어떤 파일이든 같은 커맨드로 테스트를 만들 수 있어요.

 

3 코드 설명 — explain.md

$ARGUMENTS 파일의 코드를 분석해서 설명해주세요. 비개발자도 이해할 수 있는 수준으로 풀어서 설명해주세요. 주요 함수의 역할을 목록으로 정리해주세요.

팀원에게 코드를 설명해야 하거나, 처음 보는 코드를 빠르게 파악할 때 특히 유용해요. /explain database.py처럼 파일명만 바꿔가면서 프로젝트 전체를 빠르게 이해할 수도 있어요.

이런 식으로 자주 쓰는 패턴을 5~6개 등록해두면 작업 속도가 눈에 띄게 빨라져요. 프롬프트를 직접 설계할 때는 구체적인 출력 형식까지 명시하는 것이 좋아요. "목록으로 정리해주세요", "심각도를 표시해주세요"처럼 결과물의 형태를 지정하면 더 일관된 응답을 받을 수 있어요. 모호한 지시보다 구체적인 지시가 들어간 커맨드일수록 매번 안정적인 품질의 결과를 얻을 수 있어요.

슬래시 커맨드 관리와 주의할 점

커맨드가 많아지면 어떤 것이 등록되어 있는지 헷갈릴 수 있어요. Claude Code 터미널에서 /를 입력하면 사용 가능한 커맨드 목록이 자동완성으로 표시돼요. 기본 내장 커맨드와 커스텀 커맨드가 함께 나오기 때문에 한눈에 확인할 수 있어요. 커맨드가 10개 이상 쌓여도 자동완성 덕분에 이름을 외울 필요가 없어요.

 

커맨드 파일을 수정하면 즉시 반영돼요. Claude Code를 재시작할 필요 없이, 파일을 저장하는 순간 변경된 프롬프트가 적용돼요. 프롬프트를 다듬으면서 실시간으로 결과를 확인할 수 있어서 반복 개선이 편해요.

💬 팀 프로젝트에서는 .claude/commands/ 폴더를 Git에 포함시키는 것을 권장해요. 팀원 모두가 동일한 슬래시 커맨드를 공유할 수 있기 때문이에요. 코드 리뷰 기준이나 커밋 메시지 형식을 커맨드로 통일하면, 팀 전체의 작업 품질이 일관되게 유지돼요. 새로운 팀원이 합류해도 커맨드 폴더만 보면 팀의 작업 방식을 바로 파악할 수 있어요.

⚠️ 주의
슬래시 커맨드 안에 민감한 정보(API 키, 비밀번호 등)를 넣으면 Git을 통해 노출될 수 있어요. 실제로 이런 실수로 API 키가 유출되는 사고가 종종 발생하니까 꼭 주의해야 해요. 개인적인 커맨드나 민감한 내용이 포함된 커맨드는 반드시 ~/.claude/commands/(홈 디렉토리)에 저장해야 해요. 이 경로는 프로젝트 저장소에 포함되지 않으므로 안전해요.

💡 팁
커맨드 파일 이름은 영문 소문자와 하이픈만 쓰는 것이 좋아요. 한글이나 특수문자가 들어가면 일부 환경에서 인식이 안 될 수 있어요.

프롬프트 내용이 너무 길어지면 오히려 응답 품질이 떨어질 수 있어요. 한 커맨드당 프롬프트는 10줄 이내로 유지하고, 복잡한 작업은 여러 커맨드로 나누는 편이 나아요. 예를 들어 "리뷰 + 테스트 + 리팩토링"을 하나에 넣기보다 /review, /test, /refactor로 분리하는 것이 결과가 더 좋아요.

결국 슬래시 커맨드는 "나만의 Claude Code 단축키 모음집"을 만드는 것과 같아요. 처음에 5분만 투자해서 3~4개 등록해두면, 그 이후로는 매일 수십 분을 절약할 수 있어요. 아직 커스텀 커맨드를 하나도 안 만들어봤다면, 오늘 당장 가장 자주 쓰는 프롬프트 하나만 등록해보세요.

✍️ 마치며

슬래시 커맨드는 반복 프롬프트를 없애는 가장 간단한 방법이에요. .claude/commands/에 마크다운 파일 하나만 만들면 등록 끝이고, $ARGUMENTS로 유연하게 활용할 수 있어요. 팀과 공유하면 작업 방식까지 통일되니, 오늘 가장 자주 쓰는 프롬프트 하나부터 등록해보세요.

#ClaudeCode #슬래시커맨드 #커스텀커맨드 #프롬프트자동화 #AI코딩 #개발생산성