매번 똑같이 입력하는 긴 지시가 있다면, 나만의 슬래시 커맨드로 만들어 한 번에 실행할 수 있습니다. 예를 들어 "지금까지 작성한 코드를 리뷰하고 문제점을 정리해줘"를 자주 쓴다면, 이를 /review-summary 같은 명령으로 등록하는 것입니다.

1. 커스텀 커맨드의 원리

커스텀 커맨드는 아주 단순합니다. 정해진 폴더에 명령어.md 파일을 만들면, 그 파일 이름이 곧 슬래시 명령어가 됩니다.

.claude/commands/

• 프로젝트 전용: 프로젝트 루트의 .claude/commands/
• 모든 프로젝트 공통: ~/.claude/commands/ (사용자 홈 디렉토리)

예를 들어 .claude/commands/hojun.md 파일을 만들면 /hojun 명령을 쓸 수 있습니다. 파일 안에는 클로드가 수행할 지시를 적습니다.

2. 가장 간단한 커맨드 만들기

.claude/commands/review-summary.md 파일을 만들고 다음을 적습니다.

지금까지 작성한 코드를 한 번 리뷰하고, 예상되는 문제점을 요약 정리해줘.

이제 클로드 코드에서 다음처럼 쓸 수 있습니다.

/review-summary

3. 인자(argument) 전달하기

$ARGUMENTS 를 쓰면 명령에 값을 전달할 수 있습니다.

.claude/commands/review-summary.md:

지금까지 작성한 코드를 $ARGUMENTS 번 리뷰하고, 예상되는 문제점을 요약 정리해줘.

사용:

/review-summary 3

이렇게 하면 $ARGUMENTS 자리에 3이 들어가, "3번 리뷰하고..."로 실행됩니다.

4. 인라인 Bash로 정보 미리 넣기

커맨드 파일 안에서 ! 로 시작하는 줄은 Bash 명령으로 미리 실행되고, 그 결과가 프롬프트에 포함됩니다. 이렇게 하면 클로드가 일일이 명령을 실행하지 않아도 되어 왕복이 줄어듭니다.

.claude/commands/commit-push-pr.md:

---
description: 변경사항 커밋, 원격 푸시, PR 생성
---

# Git Status
!`git status --short`

# Current Branch
!`git branch --show-current`

# Recent Commits
!`git log -5 --oneline`

위 git 정보를 바탕으로:

1. 변경사항을 스테이지하고 설명적인 메시지로 커밋
2. 원격 저장소에 푸시
3. PR 생성

/commit-push-pr 하나로 커밋부터 PR 생성까지 이어집니다. 파일 맨 위 description은 /help나 자동완성에 표시되는 설명입니다.

5. 팀과 공유하기

.claude/commands/ 폴더를 Git에 커밋하면 팀 전체가 같은 커스텀 커맨드를 공유할 수 있습니다. 하루에 여러 번 반복하는 "내부 루프" 작업일수록 커맨드로 만들 가치가 큽니다. 클로드 코드를 만든 개발자도 /commit-push-pr 같은 커맨드를 하루에 수십 번 사용한다고 합니다.

다음 장에서는 특정 동작이 일어날 때 자동으로 스크립트를 실행하는 Hooks를 다룹니다.