Claude Code 슬래시 명령어 7가지 — 반복 작업 30% 줄이는 실전 활용

슬래시 명령어를 쓰면 뭐가 달라지나요

Claude Code 슬래시 명령어, 처음엔 그냥 단축어처럼 보였어요. 그런데 한 달 써보니 매일 반복하던 작업이 한 줄로 줄어들더라고요. PR 리뷰, 테스트 실행, 커밋 메시지 다듬기 — 이런 사이클이 손에 붙으면 진짜로 칼퇴가 가능해요.

저도 처음엔 /help 정도만 알고 있었거든요. 그런데 .claude/commands/ 디렉토리 존재를 알게 된 뒤로 직접 명령어를 만들기 시작했고, 지금은 7개를 매일 돌려요. 이 글에서 그 7개를 공개할게요.

이 글에서 얻어갈 3가지

• 기본 제공 슬래시 명령어 중 꼭 써야 할 4개
• 직접 만들어 쓰는 커스텀 명령어 3개 (복붙 가능)
• 한 작업당 평균 얼마나 시간이 줄었는지 실측치

1. /init — 새 레포에 들어갔을 때 가장 먼저

낯선 코드베이스를 받았을 때 가장 먼저 치는 명령어예요. /init 한 번이면 전체 구조를 훑어서 CLAUDE.md 파일을 만들어줘요. 빌드 명령어, 테스트 명령어, 폴더 구조, 코딩 컨벤션을 자동으로 정리해줘요.

저는 외주 코드 받을 때마다 이걸 먼저 돌려요. 이전엔 README와 package.json을 30분씩 뜯어봐야 했는데, 이제 5분이면 끝나거든요.

# 프로젝트 루트에서
$ claude
> /init

생성된 CLAUDE.md는 그대로 git에 커밋하면 팀원 전체가 동일한 컨텍스트로 작업할 수 있어요.

2. /review — PR 리뷰 1차 패스 자동화

GitHub PR 리뷰 전에 무조건 한 번 돌려요. /review 는 변경된 코드를 읽고 잠재적 버그, 컨벤션 위반, 누락된 에러 핸들링을 짚어줘요. 사람 리뷰어가 보기 전 1차 필터 역할이에요.

제가 직접 써봤는데 놓치기 쉬운 null 체크나 race condition 후보를 잘 잡아줘요. 한 번에 50줄 정도 변경된 PR 기준으로 사람이 5분 걸릴 1차 검토를 30초에 끝냈어요.

3. /security-review — 보안 점검 가벼운 버전

/security-review 는 변경 코드에서 OWASP Top 10 패턴을 점검해요. SQL 인젝션, XSS, 시크릿 노출, 부적절한 인증 체크 같은 거요.

제가 자주 쓰는 시나리오는 이런 식이에요.

• 외부 API 호출 코드 추가했을 때 — 시크릿 노출 점검
• 사용자 입력 받는 폼 추가했을 때 — 검증 누락 점검
• 파일 업로드 기능 만들었을 때 — path traversal 점검

매번 직접 점검표 돌리는 것보다 훨씬 빠르고, 빠진 것도 잘 찾아주거든요. 다만 프로덕션 배포 전엔 엔터프라이즈 LLM 보안 체크리스트 같은 별도 감사를 추가하는 걸 권해요.

4. /compact — 긴 대화 메모리 절약

세션이 길어지면 응답이 느려져요. 토큰을 다 써가는 거죠. /compact 는 지금까지 대화를 요약해서 컨텍스트를 압축해줘요.

저는 이렇게 써요.

• 한 작업 완료할 때마다 /compact 한 번
• 다음 세션으로 이어갈 작업이 있으면 끝나기 전에 /compact
• 응답 속도가 느려졌다 싶으면 /compact

요약 후에도 핵심 결정사항과 진행 상태는 그대로 유지돼요. 손해 없는 정리예요.

5. /run-tests — 내가 매일 쓰는 커스텀 명령어

이제 직접 만든 명령어 차례예요. .claude/commands/run-tests.md 파일을 이렇게 만들어두면 끝이에요.

변경된 파일과 관련된 테스트만 골라서 실행해줘.
1. git diff --name-only HEAD~1 로 변경 파일 확인
2. 각 파일에 대응하는 *.test.ts 또는 *.spec.ts 찾기
3. vitest run <file1> <file2> ... 형식으로 실행
4. 실패한 테스트 있으면 원인 분석해서 보고

이러면 /run-tests 한 번에 변경된 파일만 골라서 테스트가 돌아요. 전체 테스트 돌리면 8분 걸리는데, 변경된 부분만 돌리면 40초에 끝나거든요.

6. /commit-msg — 커밋 메시지 자동 생성

.claude/commands/commit-msg.md 안에 이렇게 적어두면 돼요.

git diff --staged 의 내용을 보고 컨벤셔널 커밋 메시지 작성해줘.
- type(scope): subject 형식
- type: feat, fix, refactor, docs, test, chore 중 선택
- subject: 50자 이내, 명령형, 마침표 없음
- 본문은 비워두고 제목만 출력

저는 git stage 한 다음 /commit-msg 호출하고, 출력된 메시지를 그대로 git commit -m "..." 에 붙여요. 의미 없는 "update files" 같은 커밋이 사라졌어요. 블로그 자동화 시스템에서도 이 패턴을 쓰고 있어요.

7. /todo-from-pr — PR 설명을 작업 목록으로

큰 PR 받았을 때 어디서부터 봐야 할지 막막하잖아요. 이 명령어는 PR 본문과 변경 파일 목록을 읽고 체크리스트 형식의 리뷰 작업 목록을 만들어줘요.

gh pr view 명령으로 현재 PR 정보 가져온 다음
변경 파일 카테고리별로 묶어서
"먼저 봐야 할 파일 → 영향받는 테스트 → 수동 검증할 시나리오"
순서로 markdown 체크리스트 만들어줘.

이걸 돌리면 1000줄짜리 PR도 어느 순서로 봐야 할지 명확해져요. 리뷰 시간 절반은 그냥 "어디서부터 봐야 하지?" 였거든요.

7개 돌려본 한 달 실측치

하루 평균 약 1시간 30분 절감됐어요. 5일이면 7.5시간 — 거의 하루치예요.

지금 당장 해볼 액션 아이템

1. 터미널에서 claude 실행 후 /help 쳐서 기본 명령어 목록 확인
2. 작업 중인 프로젝트에 /init 한 번 돌리고 CLAUDE.md 검토
3. .claude/commands/ 디렉토리 만들고 위 5번 run-tests.md 부터 복붙

3개만 시작해도 다음 PR부터 체감이 와요. 슬래시 명령어는 "한 번 만들어두면 평생 써먹는" 자산이거든요. Claude Code 개발자 생산성 가이드이 궁금하면 별도 가이드도 같이 봐주세요.