[Claude] Claude Code 핵심 명령어 & 슬래시 커맨드 총정리

Claude Code를 효과적으로 사용하려면 명령어와 슬래시 커맨드를 숙지하는 것이 필수입니다.

이번 가이드에서는 모든 명령어를 체계적으로 정리하고, 실전 활용법을 소개합니다.

 

명령어 체계 개요

Claude Code의 명령어는 크게 4가지로 분류됩니다:

1. CLI 플래그 - 터미널에서 claude 실행 시 옵션
2. 슬래시 커맨드 - 대화 중 /로 시작하는 명령
3. 키보드 단축키 - 빠른 작업을 위한 핫키
4. 스킬 - 사용자 정의 슬래시 커맨드

 

CLI 플래그 (Command Line Flags)

기본 사용법

# 대화형 모드 시작
claude

# 일회성 작업
claude "hello world 함수 추가"

# 프린트 모드 (응답 후 종료)
claude -p "이 함수 설명"

# 파이프 사용
cat error.log | claude -p "에러 원인 분석"

# 최근 대화 계속
claude -c

# 세션 재개
claude -r "auth-refactor"

 

주요 플래그 레퍼런스

플래그	설명	예시
-p, --print	응답 후 종료 (비대화형)	claude -p "query"
-c, --continue	최근 대화 이어가기	claude -c
-r, --resume	특정 세션 재개	claude -r "session-name"
--model	모델 지정	claude --model opus
--permission-mode	권한 모드 설정	--permission-mode plan
--chrome	Chrome 통합 활성화	claude --chrome
--remote	Web 세션 생성	claude --remote "작업"
--max-turns	최대 턴 수 제한	claude -p --max-turns 3
--max-budget-usd	예산 제한	claude -p --max-budget-usd 5.00
--output-format	출력 형식	--output-format json
--system-prompt	시스템 프롬프트 교체	--system-prompt "너는 전문가다"
--append-system-prompt	프롬프트 추가	--append-system-prompt "TypeScript 사용"

 

고급 플래그

도구 제어:

# 특정 도구만 허용
claude --tools "Bash,Edit,Read"

# 도구 비활성화
claude --disallowedTools "Edit"

# 권한 없이 실행 가능한 도구
claude --allowedTools "Bash(git log *)" "Read"

 

MCP 설정:

# MCP 서버 로드
claude --mcp-config ./mcp.json

# 지정된 MCP만 사용
claude --strict-mcp-config --mcp-config ./mcp.json

 

디버깅:

# 디버그 모드
claude --debug "api,mcp"

# Verbose 출력
claude --verbose

# 특정 세션 ID 사용
claude --session-id "550e8400-e29b-41d4-a716-446655440000"

 

슬래시 커맨드 완전 가이드

필수 명령어 Top 10

명령어	설명	사용 예시
/help	도움말 보기	/help
/resume	세션 재개	/resume 또는 /resume auth-work
/commit	Git 커밋 생성	claude commit (별도 명령)
/config	설정 메뉴 열기	/config
/clear	대화 기록 삭제	/clear
/rename	세션 이름 변경	/rename my-feature
/model	모델 변경	/model
/plan	플랜 모드 진입	/plan
/rewind	대화/코드 되돌리기	/rewind
/export	대화 내보내기	/export chat.md

 

정보 확인 명령어

/status         # 버전, 모델, 계정 정보
/doctor         # 설치 상태 점검
/cost           # 토큰 사용량 통계
/usage          # 플랜 사용량 (구독자만)
/stats          # 일일 사용 통계
/context        # 컨텍스트 사용량 시각화
/todos          # TODO 항목 목록
/tasks          # 백그라운드 작업 목록

 

세션 관리 명령어

/resume                    # 세션 선택 메뉴
/resume auth-refactor     # 이름으로 재개
/rename new-name          # 현재 세션 이름 변경
/clear                    # 대화 기록 삭제
/compact [instructions]   # 대화 압축
/rewind                   # 특정 메시지로 되돌리기
/export filename.md       # 대화 내보내기

 

고급 명령어

/memory         # CLAUDE.md 편집
/init           # 프로젝트 초기화 (CLAUDE.md 생성)
/mcp            # MCP 서버 관리
/agents         # 서브에이전트 보기/생성
/hooks          # 훅 설정 관리
/permissions    # 권한 설정 보기/변경
/keybindings    # 키바인딩 설정 파일 생성
/vim            # Vim 모드 활성화
/theme          # 테마 변경
/statusline     # 상태 표시줄 설정

 

 

 

MCP 프롬프트 명령어

MCP 서버가 제공하는 프롬프트는 다음 형식으로 사용:

/mcp__서버명__프롬프트명

예시:

/mcp__github__create-issue
/mcp__google-drive__search-files

 

키보드 단축키

필수 단축키

단축키	기능	설명
Ctrl+C	취소/중단	입력 또는 생성 취소
Ctrl+D	종료	Claude Code 세션 종료
Ctrl+G	외부 에디터	프롬프트를 에디터에서 편집
Ctrl+O	Verbose 토글	상세 출력 보기
Ctrl+R	히스토리 검색	명령어 역방향 검색
Ctrl+V	이미지 붙여넣기	클립보드의 이미지 삽입
Ctrl+T	작업 목록 토글	백그라운드 작업 표시
Shift+Tab	권한 모드 전환	Normal → Auto → Plan
Option+P (Mac) / Alt+P	모델 변경	모델 선택 메뉴 열기
Option+T (Mac) / Alt+T	Thinking 토글	Extended Thinking 활성화

 

텍스트 편집

단축키	기능
Ctrl+K	줄 끝까지 삭제
Ctrl+U	전체 줄 삭제
Ctrl+Y	삭제한 텍스트 붙여넣기
Alt+B	단어 뒤로 이동
Alt+F	단어 앞으로 이동

 

멀티라인 입력

방법	단축키	지원 터미널
백슬래시 이스케이프	\ + Enter	모든 터미널
macOS 기본	Option+Enter	macOS만
Shift Enter	Shift+Enter	iTerm2, WezTerm 등
Control 시퀀스	Ctrl+J	모든 터미널

 

스킬 (Custom Slash Commands)

스킬이란?

스킬은 사용자 정의 슬래시 커맨드입니다.

.claude/skills/ 폴더에 SKILL.md 파일을 생성하면 Claude가 자동으로 인식합니다.

 

첫 번째 스킬 만들기

1. 디렉토리 생성:

mkdir -p .claude/skills/explain-code

 

2. SKILL.md 작성:

---
name: explain-code
description: 코드를 시각적 다이어그램과 비유로 설명합니다.
---

코드를 설명할 때 항상 다음을 포함하세요:

1. **비유로 시작**: 코드를 일상생활의 무언가와 비교
2. **다이어그램 그리기**: ASCII 아트로 흐름 표시
3. **단계별 설명**: 무슨 일이 일어나는지 설명
4. **주의사항**: 흔한 실수나 오해

대화하는 듯이 설명하세요.

 

3. 사용:

/explain-code auth.js의 로그인 함수

스킬 구조

~/.claude/skills/my-skill/
├── SKILL.md          # 메인 인스트럭션 (필수)
├── template.md       # Claude가 채울 템플릿 (선택)
├── examples.md       # 예시 출력 (선택)
└── scripts/
    └── helper.py     # Claude가 실행할 스크립트 (선택)

 

스킬 Frontmatter 옵션

---
name: my-skill
description: 스킬 설명 (Claude가 언제 사용할지 판단)
argument-hint: "[issue-number]"  # 자동완성 힌트
disable-model-invocation: true   # Claude 자동 호출 비활성화
user-invocable: false            # 메뉴에서 숨김
allowed-tools: "Bash,Edit"       # 권한 없이 실행 가능한 도구
model: opus                      # 이 스킬 사용 시 모델
context: fork                    # 서브에이전트에서 실행
agent: Explore                   # 서브에이전트 타입
---

 

스킬에서 인자 사용

---
name: fix-issue
description: GitHub 이슈 수정
---

GitHub 이슈 $ARGUMENTS를 다음 단계로 수정:

1. 이슈 설명 읽기
2. 요구사항 이해
3. 수정 구현
4. 테스트 작성
5. 커밋 생성

사용:

/fix-issue 123

변수:

• $ARGUMENTS - 모든 인자
• $ARGUMENTS[0] - 첫 번째 인자
• $0, $1, $2 - 인자 단축키
• ${CLAUDE_SESSION_ID} - 현재 세션 ID

 

동적 컨텍스트 주입

---
name: pr-summary
description: PR 변경사항 요약
---

## PR 컨텍스트
- PR diff: !`gh pr diff`
- PR 코멘트: !`gh pr view --comments`

이 풀 리퀘스트를 요약하세요...

백틱 앞의 !는 명령어를 실행하고 결과를 삽입합니다.

 

실전 워크플로우

워크플로우 1: 버그 수정

# 1. 대화 시작
claude

# 2. 문제 설명
> npm test 실행 시 에러 발생
> 에러: "TypeError: Cannot read property 'name' of undefined"
> auth.js에서 발생

# 3. Claude가 제안하면 승인
[Claude가 수정 제안]

# 4. 변경사항 확인
Ctrl+O  # Verbose 모드로 상세 확인

# 5. 커밋
> 변경사항 커밋해줘

 

워크플로우 2: 코드 리팩토링

# Plan 모드로 시작 (안전)
claude --permission-mode plan

> utils.js의 콜백을 async/await로 변경

[Claude가 계획 수립]

# 계획 검토 후 실행
Shift+Tab  # Normal 모드로 전환
> 계획대로 진행해줘

 

워크플로우 3: PR 생성

claude

> feature/auth 브랜치 생성
> 변경사항 커밋
> PR 만들기

# 또는 스킬 사용
/commit-push-pr

 

워크플로우 4: 유닉스 파이프라인

# 에러 로그 분석
cat build-error.txt | claude -p "근본 원인 찾기"

# JSON 출력
cat data.json | claude -p "요약" --output-format json > summary.json

# 빌드 스크립트에 통합
# package.json:
{
  "scripts": {
    "lint:claude": "claude -p '변경사항에서 오타 찾기. 파일명:줄번호 형식으로 보고'"
  }
}

 

권한 모드 이해하기

3가지 권한 모드

1. Normal Mode (기본값)

• 모든 도구 사용 전 승인 요청
• 안전하지만 느림

2. Auto-Accept Mode

• 도구 자동 실행
• 빠르지만 위험

3. Plan Mode

• 계획 수립 후 사용자 승인
• 읽기 전용으로 먼저 탐색

전환 방법:

Shift+Tab  # 모드 순환

# 또는 시작 시 지정
claude --permission-mode plan

 

커스텀 키바인딩

키바인딩 파일 생성

/keybindings

~/.claude/keybindings.json 파일이 생성됩니다.

기본 예시

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+s": "chat:stash",
        "ctrl+u": null
      }
    }
  ]
}

사용 가능한 컨텍스트

• Global - 전역 적용
• Chat - 채팅 입력 영역
• Autocomplete - 자동완성 메뉴
• Settings - 설정 메뉴
• Confirmation - 권한 대화상자
• HistorySearch - 히스토리 검색 모드

주요 액션

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+enter": "chat:submit",
        "escape": "chat:cancel",
        "ctrl+shift+p": "chat:modelPicker",
        "ctrl+t": "chat:thinkingToggle"
      }
    }
  ]
}

 

자주 묻는 질문 (FAQ)

 

Q1. 명령어를 어떻게 외우나요?

A: 외울 필요 없습니다!

• /help - 모든 명령어 보기
• ? - 키보드 단축키 목록
• Tab - 명령어 자동완성

자주 쓰는 것만 자연스럽게 익히면 됩니다.

 

Q2. 가장 유용한 단축키는?

A: Top 5:

1. Shift+Tab - 권한 모드 빠른 전환
2. Ctrl+R - 명령어 히스토리 검색
3. Ctrl+O - Verbose 모드 (상세 보기)
4. Option/Alt+P - 모델 빠른 변경
5. Ctrl+G - 외부 에디터 사용

 

Q3. 스킬과 슬래시 커맨드의 차이는?

A:

• 슬래시 커맨드: Claude Code 내장 기능 (/help, /config 등)
• 스킬: 사용자가 직접 만든 커스텀 명령 (.claude/skills/에 저장)

둘 다 /로 시작하지만, 스킬은 확장 가능합니다!

 

Q4. Verbose 모드는 언제 사용하나요?

A: 다음 상황에서 유용합니다:

• Claude가 어떤 도구를 사용하는지 보고 싶을 때
• Thinking 과정을 보고 싶을 때
• 디버깅할 때

Ctrl+O로 즉시 켜고 끌 수 있습니다.

 

Q5. 세션을 어떻게 관리하나요?

A: 세션 관리 팁:

# 세션 이름 지정
/rename my-feature-work

# 나중에 재개
claude -r my-feature-work

# 세션 목록 보기
/resume  # 인터랙티브 선택기

# 세션 내보내기
/export session.md

 

Q6. Plan 모드는 언제 사용하나요?

A: 다음 경우에 권장:

• 큰 리팩토링 작업
• 익숙하지 않은 코드베이스
• 계획 검토 후 실행하고 싶을 때

claude --permission-mode plan

 

고급 팁

1. 멀티세션 관리

# 터미널 1: Feature 작업
cd ~/project
claude -r feature-work

# 터미널 2: 버그 수정
cd ~/project
claude -r bug-fix

# 터미널 3: 리팩토링
cd ~/project
claude -r refactor

 

2. Context Budget 늘리기

스킬이 너무 많아 제외되면:

export SLASH_COMMAND_TOOL_CHAR_BUDGET=32000

 

3. Extended Thinking 제어

# Thinking 토큰 예산
export MAX_THINKING_TOKENS=10000

# Opus 4.6 Effort 레벨
/model  # 화살표로 low/medium/high 조정

 

4. 백그라운드 작업

# 현재 작업 백그라운드 전송
Ctrl+B

# Bash 명령 백그라운드 실행
! npm test

# 작업 목록
/tasks

 

결론 - 명령어 마스터하기

Claude Code를 효율적으로 사용하려면:

필수 암기 (5개):

1. claude -c - 계속하기
2. /help - 도움말
3. Shift+Tab - 권한 모드 전환
4. Ctrl+O - Verbose 모드
5. /resume - 세션 재개

자주 사용 (10개):

• /config, /model, /clear, /rename
• Ctrl+R, Ctrl+G, Option+P, Option+T
• claude --model opus, claude --permission-mode plan

나머지는 필요할 때 /help로 찾으면 됩니다!

---

📌 관련 글:

• 6편: Claude Code 설치 및 시작하기
• 8편: Claude Code VS Code 연동

[Claude] Claude Code로 코드 리팩토링 & 디버깅 실전 예제

 

[Claude] Claude Code 설치 및 시작하기 (Mac/Windows/Linux)

 

[Claude] Claude Code 핵심 명령어 & 슬래시 커맨드 총정리