Claude Code 공식문서 리뷰-참고자료(Reference)[3] : 슬래시 명령어(Slash commands)

안녕하세요! 갓대희입니다. 

Claude Code Docs 공식 문서 >> [참고자료(Reference)] 섹션의 내용 중 [슬래시 명령어(Slash commands)]를 살펴 보려고 합니다.

이번 섹션 부터는 영문, 한글번역본이 모두 공식문서로 존재하는 섹션이니 한글 문서를 편하게 참고 하셔도 될 것 같습니다.

https://code.claude.com/docs/ko/slash-commands

슬래시 명령어 - Claude Code Docs

 

이 카테고리의 글은 편하게 공식 문서 위주의 내용을 눈으로 쭉 살펴 보고 넘어가는 목적을 갖고 시작 하게 되었습니다.

저도 초심으로 돌아가 기초적읜 글을 살펴보다보니, 지금와서 클로드에서 강조 하고자 하는 원칙이 어떤건지 되돌아볼 수 있는 계기가 되기도 하는 것 같아, 다른 분들도 꼭 한번 눈으로라도 이해 하고 넘어가는것이 좋다고 생각하여 공식 문서의 내용을 억지로 리뷰해보게 되었습니다.

 

 

Claude Code 슬래시 명령어

code.claude.com

슬래시 명령이란?

슬래시 명령은 /로 시작하는 특수 명령어다. Discord나 Slack의 슬래시 명령과 비슷하게, 특정 기능을 빠르게 실행할 수 있다.

슬래시 명령을 쓰면 좋은 점

• 빠른 실행 - 자주 쓰는 기능을 한 단어로 호출
• 일관된 결과 - 매번 같은 프롬프트를 입력할 필요 없음
• 팀 공유 - 커스텀 명령을 Git으로 팀과 공유 가능
• 자동화 - 복잡한 워크플로우를 단순화

 

초보자를 위한 시작하기 - 필수 5가지 명령

명령	언제 쓰나?	예시
/init	새 프로젝트 시작할 때 CLAUDE.md 파일을 만들어 프로젝트 규칙을 설정	/init
/model	AI 모델 바꾸고 싶을 때 Sonnet, Opus, Haiku 중 선택	/model → 선택 메뉴 표시
/clear	대화 내용 초기화할 때 새로운 주제로 시작하고 싶을 때	/clear
/compact	대화가 너무 길어졌을 때 맥락은 유지하면서 토큰 절약	/compact 코드 리팩토링에 집중
/help	사용 가능한 명령 확인할 때 커스텀 명령 포함 전체 목록 표시	/help

먼저 해보자

터미널에서 claude를 실행한 후, /help를 입력해 보자. 사용 가능한 모든 명령어를 확인할 수 있다.

 

상황별 가이드 - 이럴 땐 이 명령을

어떤 명령을 써야 할지 모르겠다면?

아래 상황에서 자신에게 맞는 케이스를 찾아보자.

상황 1: "새 프로젝트를 시작해요"

프로젝트 폴더에서 Claude Code를 처음 실행할 때

추천 명령

/init

→ CLAUDE.md 파일이 생성되고, 프로젝트 구조와 규칙을 설정할 수 있다.

상황 2: "얼마나 썼는지 확인하고 싶어요"

토큰 사용량이나 비용이 궁금할 때

추천 명령

/cost	현재 세션의 토큰 사용량과 비용
/usage	구독 플랜의 사용 한도와 남은 양
/context	현재 컨텍스트 사용량을 시각적으로 표시

상황 3: "대화가 너무 길어졌어요"

대화가 길어져서 느려지거나 토큰을 아끼고 싶을 때

추천 명령

/compact	대화를 압축해서 맥락 유지하면서 토큰 절약
/compact [지침]	특정 주제에 집중해서 압축
/clear	완전히 새로 시작하고 싶을 때

상황 4: "코드 리뷰를 받고 싶어요"

작성한 코드의 품질을 검토받고 싶을 때

추천 명령

/review	일반적인 코드 리뷰
/security-review	보안 취약점 중심 리뷰
/pr-comments	PR 코멘트 확인

상황 5: "이전에 했던 작업을 이어가고 싶어요"

이전 세션의 대화를 다시 불러오고 싶을 때

추천 명령

/resume	세션 선택 UI 표시
/resume [이름]	특정 세션을 이름으로 복원
/rewind	대화나 코드를 이전 상태로 되돌리기

 

전체 내장 명령 레퍼런스

아래는 Claude Code에 내장된 모든 슬래시 명령 목록이다. /help를 실행하면 터미널에서도 확인할 수 있다.

세션 관리

명령	설명
/clear	대화 기록 지우기
/compact [지침]	선택적 지침과 함께 대화 압축
/exit	REPL 종료
/export [파일명]	현재 대화를 파일 또는 클립보드로 내보내기
/rename <이름>	현재 세션 이름 변경
/resume [세션]	ID 또는 이름으로 대화 재개
/rewind	대화 및/또는 코드 되돌리기

 

설정 및 구성

명령	설명
/config	설정 인터페이스 열기 (Config 탭)
/model	AI 모델 선택 또는 변경
/output-style [스타일]	출력 스타일 직접 설정 또는 메뉴에서 선택
/permissions	권한 보기 또는 업데이트
/privacy-settings	개인정보 설정 보기 및 업데이트
/sandbox	파일시스템/네트워크 격리가 적용된 샌드박스 bash 도구 활성화
/status	설정 인터페이스 열기 (Status 탭)
/statusline	Claude Code 상태 줄 UI 설정
/terminal-setup	Shift+Enter 키 바인딩 설치 (iTerm2 & VSCode)
/vim	삽입/명령 모드를 번갈아 사용하는 vim 모드 진입

 

프로젝트 관리

명령	설명
/add-dir	추가 작업 디렉토리 추가
/init	CLAUDE.md 가이드로 프로젝트 초기화
/memory	CLAUDE.md 메모리 파일 편집
/todos	현재 TODO 항목 나열

 

에이전트 및 플러그인

명령	설명
/agents	특수 작업용 커스텀 AI 서브에이전트 관리
/bashes	백그라운드 작업 나열 및 관리
/hooks	도구 이벤트용 훅 설정 관리
/mcp	MCP 서버 연결 및 OAuth 인증 관리
/plugin	Claude Code 플러그인 관리

 

코드 작업

명령	설명
/review	코드 리뷰 요청
/security-review	보류 중인 변경사항에 대한 완전한 보안 리뷰
/pr-comments	풀 리퀘스트 코멘트 보기
/install-github-app	저장소에 Claude GitHub Actions 설정

 

계정 및 사용량

명령	설명
/login	Anthropic 계정 전환
/logout	Anthropic 계정에서 로그아웃
/cost	토큰 사용 통계 표시
/usage	플랜 사용 한도 및 속도 제한 상태 표시
/stats	일일 사용량, 세션 기록, 연속 사용 시각화
/context	현재 컨텍스트 사용량을 컬러 그리드로 시각화

 

기타

명령	설명
/bug	버그 신고 (대화를 Anthropic에 전송)
/doctor	Claude Code 설치 상태 점검
/help	사용법 도움말
/ide	IDE 연동 관리 및 상태 표시
/release-notes	릴리스 노트 보기

 

커스텀 슬래시 명령 만들기

왜 커스텀 명령이 필요한가?

매번 같은 프롬프트를 반복 입력하고 있다면, 커스텀 명령으로 만들자. 한 번 만들면 /명령어 하나로 실행할 수 있다.

커스텀 명령의 활용 예시

• /commit - 팀 컨벤션에 맞는 커밋 메시지 자동 생성
• /test - 현재 파일의 테스트 코드 작성
• /docs - 함수 문서화 자동 생성
• /optimize - 성능 최적화 분석

 

실습: 첫 번째 커스텀 명령 만들기

목표: /optimize 명령 만들기

코드 성능 최적화를 분석하는 커스텀 명령을 만들어 보자.

Step 1: 명령 파일 생성

# 프로젝트 명령 (팀과 공유됨)
mkdir -p .claude/commands

# 또는 개인 명령 (모든 프로젝트에서 사용)
mkdir -p ~/.claude/commands

하위 디렉토리로 네임스페이스 만들기

명령이 많아지면 하위 디렉토리로 그룹화할 수 있다. 디렉토리 이름이 네임스페이스가 된다.

# 디렉토리 구조
.claude/commands/
  frontend/
    component.md    # → /component (project:frontend)로 표시
    styles.md       # → /styles (project:frontend)로 표시
  backend/
    api.md          # → /api (project:backend)로 표시

/help에서 (project:frontend) 형태로 출처가 표시되어 어느 그룹의 명령인지 쉽게 구분된다.

 

Step 2: 명령 내용 작성

.claude/commands/optimize.md 파일을 생성하고 아래 내용을 작성:

---
description: 코드 성능 최적화 분석
argument-hint: [파일 경로]
---

## 분석 대상

$ARGUMENTS

## 수행할 작업

1. 코드의 시간 복잡도 분석
2. 성능 병목 지점 식별
3. 최적화 방안 제안
4. 개선 전후 비교 코드 제시

 

Step 3: 사용하기

# Claude Code에서 사용
/optimize src/utils/parser.js

잘 동작하는지 확인하기

/help를 실행하면 새로 만든 /optimize 명령이 "(project)" 또는 "(user)"로 표시된다.

 

실전 예제: Git 커밋 자동화

팀에서 자주 사용하는 커밋 메시지 생성 명령을 만들어 보자.

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: 팀 컨벤션에 맞는 git 커밋 생성
---

## 현재 상태 확인

- 현재 브랜치: !`git branch --show-current`
- 변경 사항: !`git diff --stat`
- 스테이지된 파일: !`git diff --cached --stat`

## 커밋 메시지 규칙

다음 형식을 따라 커밋 메시지를 작성:

- feat: 새로운 기능
- fix: 버그 수정
- refactor: 리팩토링
- docs: 문서 수정
- test: 테스트 추가

## 수행할 작업

변경 사항을 분석하고, 적절한 커밋 메시지를 생성해서 커밋해.

 

명령 유형 비교

유형	위치	용도
프로젝트 명령 (project)	.claude/commands/	Git으로 팀과 공유 프로젝트별 커밋 규칙, 코드 스타일 등
개인 명령 (user)	~/.claude/commands/	모든 프로젝트에서 사용 개인 워크플로우, 자주 쓰는 분석 등

우선순위
같은 이름의 명령이 있으면, 프로젝트 명령이 개인 명령보다 우선한다.

 

고급 기능

인자 사용하기

변수	설명	예시
$ARGUMENTS	전체 인자	/cmd foo bar → "foo bar"
$1, $2, $3...	위치별 인자	/cmd foo bar → $1="foo", $2="bar"

 

특수 접두어

접두어	기능	사용 예
!	Bash 명령 실행	!`git status`
@	파일 내용 포함	@src/utils.js

 

프론트매터 옵션

필드	용도	기본값
allowed-tools	명령이 사용할 수 있는 도구 목록	대화에서 상속
argument-hint	자동완성용 예상 인자	없음
description	간단한 설명	프롬프트 첫 줄
model	사용할 특정 모델	대화에서 상속
disable-model-invocation	Claude가 이 명령을 자동 호출하지 못하게 함	false

Extended Thinking 모드 트리거

슬래시 명령 프롬프트에 "think", "reason", "plan" 같은 키워드를 포함하면 Claude가 Extended Thinking 모드를 활성화하여 더 깊은 추론을 수행할 수 있다. 복잡한 분석이나 계획 수립이 필요한 명령에 활용하면 좋다.

 

플러그인 명령

플러그인 명령이란?

마켓플레이스에서 설치한 플러그인이 제공하는 슬래시 명령이다. 플러그인을 설치하면 자동으로 사용 가능해진다.

호출 방식

/command-name # 충돌 없으면 직접 호출
/plugin-name:command-name # 명확히 구분 필요시
/command-name arg1 arg2 # 인자와 함께

 

MCP 슬래시 명령

MCP 명령이란?

MCP(Model Context Protocol) 서버와 연결하면, 해당 서버가 제공하는 프롬프트를 슬래시 명령으로 사용할 수 있다. GitHub, Jira 등 외부 서비스와 통합할 때 유용하다.

명령 형식

/mcp__<서버-이름>__<프롬프트-이름> [인자]

 

사용 예시

/mcp__github__list_prs # PR 목록 조회
/mcp__github__pr_review 456 # PR #456 리뷰
/mcp__jira__create_issue "버그 제목" high # Jira 이슈 생성

 

MCP 권한 설정

설정	효과
mcp__github	GitHub 서버의 모든 도구 승인
mcp__github__*	와일드카드로 전체 승인
mcp__github__get_issue	특정 도구만 승인

 

SlashCommand 도구 (자동 호출)

이건 무엇인가?

SlashCommand 도구는 Claude가 대화 중에 커스텀 슬래시 명령을 자동으로 호출할 수 있게 해준다.

사용 예시

CLAUDE.md에 다음과 같이 설정하면:

테스트 작성을 시작할 때 /write-unit-test를 실행해.

Claude가 자동으로 해당 명령을 호출한다.

 

제한사항

• 커스텀 명령만 지원 - /compact 같은 내장 명령은 불가
• description 프론트매터 필수
• 문자 예산 - 기본 15,000자 (SLASH_COMMAND_TOOL_CHAR_BUDGET 환경변수로 조정 가능)

 

자동 호출 비활성화

특정 명령이 자동 호출되지 않게 하려면:

---
disable-model-invocation: true
---

 

권한 설정

SlashCommand 도구에 대한 권한을 세밀하게 설정할 수 있다.

권한 패턴	설명
SlashCommand:/commit	/commit 명령만 정확히 허용
SlashCommand:/review-pr:*	/review-pr로 시작하는 모든 명령 허용 (접두어 매칭)

 

SlashCommand 도구 완전 비활성화

Claude가 슬래시 명령을 자동으로 호출하지 못하게 하려면 /permissions에서 거부 규칙에 추가한다:

# /permissions에서 거부 규칙에 추가
SlashCommand

 

Skills vs 슬래시 명령 - 언제 무엇을 쓸까?

헷갈린다면?

간단한 작업 → 슬래시 명령으로 시작하고, 복잡해지면 Skills로 발전시키자.

기준	슬래시 명령	Skills
복잡도	단순한 프롬프트	복잡한 워크플로우
구조	단일 .md 파일	SKILL.md + 여러 리소스
호출	/명령어로 명시적 호출	컨텍스트 기반 자동 활성화
예시	커밋 메시지 생성	전체 PR 워크플로우
공유	Git 저장소로 팀과 공유	마켓플레이스 또는 Git

 

문제 해결 - 자주 겪는 문제

문제 1: 커스텀 명령이 /help에 안 보여요

증상

명령 파일을 만들었는데 /help에 표시되지 않음

확인사항

1. 파일 위치 확인
   → 프로젝트: .claude/commands/
   → 개인: ~/.claude/commands/
2. 파일 확장자 확인
   → 반드시 .md로 끝나야 함
3. Claude Code 재시작
   → 새 파일은 재시작 후 인식될 수 있음

 

문제 2: Bash 명령이 실행 안 돼요

증상

!`git status` 같은 Bash 명령이 동작하지 않음

해결방법

1. 프론트매터에 allowed-tools 추가

   ---
   allowed-tools: Bash(git:*)
   ---

2. 권한 확인
   → /permissions에서 Bash 도구가 허용되어 있는지 확인

 

문제 3: 같은 이름의 명령이 충돌해요

증상

프로젝트 명령과 개인 명령 이름이 같아서 원하는 게 실행 안 됨

해결방법

• 우선순위 이해: 프로젝트 명령 > 개인 명령
• 이름 변경: 충돌을 피하려면 다른 이름 사용
• 네임스페이스 활용: 하위 폴더로 그룹화

  .claude/commands/my-team/commit.md
  ~/.claude/commands/personal/commit.md

 

핵심 요약 - 체크리스트

빠르게 확인하자

슬래시 명령을 효과적으로 사용하기 위한 핵심 포인트다.

항목	핵심 내용
초보자 필수 명령	/init, /model, /clear, /compact, /help
커스텀 명령 위치	프로젝트: .claude/commands/ 개인: ~/.claude/commands/
인자 사용	$ARGUMENTS (전체) / $1, $2... (위치별)
특수 접두어	! (Bash 실행) / @ (파일 포함)
MCP 명령 형식	/mcp__서버__프롬프트
우선순위	프로젝트 명령 > 개인 명령

 

관련 문서

문서	언제 보나?
플러그인	마켓플레이스에서 플러그인 설치할 때
대화형 모드	키보드 단축키 알고 싶을 때
메모리 관리	CLAUDE.md 설정 방법 알고 싶을 때
Hooks	도구 실행 전후 자동화할 때