가이드
Claude Code 명령어: 슬래시 명령어와 단축키 치트시트
이 글은 Claude Code에서 매일 쓰는 슬래시 명령어와 단축키를 빠르게 찾아볼 수 있게 정리한 사용법 레퍼런스입니다. 프로젝트 설정, 작업 진행, 컨텍스트 관리, 리뷰와 문제 해결 순서로 세션의 흐름에 맞춰 배열했습니다. 명령어 이름, 별칭, 동작은 Anthropic의 Commands 문서와 Interactive mode 문서를 2026년 10월 30일에 확인한 내용입니다. 표는 일부만 골라 실었으며, 전체 목록은 해당 문서에 있습니다.
/를 입력하면 사용할 수 있는 명령어가 나열되고, 글자를 더 입력하면 필터링됩니다. 명령어는 메시지의 맨 앞에 있을 때만 인식됩니다.- 가장 자주 쓰는 명령어:
/init은CLAUDE.md를 만들고,/compact는 대화를 요약하고,/clear는 새 대화를 시작하고,/resume은 이전 대화로 돌아가고,/rewind는 코드와 대화를 되돌립니다. Shift+Tab은 권한 모드를 순환하고,Esc는 Claude를 중단하며, 빈 프롬프트에서Esc+Esc를 누르면 되감기 메뉴가 열립니다.- 모든 명령어가 모든 사용자에게 보이지는 않습니다. 플랫폼, 요금제, 환경에 따라 다릅니다. 문서에 명시된 제한은 아래에 함께 적어 두었습니다.
프로젝트 시작과 작업 진행
저장소에서 처음 시작할 때는 /init을 실행한 뒤 /memory로 결과를 다듬습니다. 큰 변경 전에는 /plan으로 plan 모드로 전환합니다.
| 명령어 | 동작 |
|---|---|
/init | CLAUDE.md 가이드로 프로젝트를 초기화합니다. CLAUDE_CODE_NEW_INIT=1을 설정하면 skills, hooks, 개인 메모리 파일까지 안내하는 대화형 흐름으로 진행됩니다. CLAUDE.md 작성법 참고 |
/memory | CLAUDE.md 파일을 편집하고, 자동 메모리를 켜거나 끄며, 자동 메모리 항목을 보여 줍니다 |
/plan [description] | 프롬프트에서 plan 모드로 진입합니다. 설명을 덧붙이면 바로 그 작업을 시작합니다. 예: /plan fix the auth bug |
/model [model] | 모델을 바꾸고 새 세션의 기본값으로 저장합니다. 인자가 없으면 선택기가 열리며, 행에서 s를 누르면 현재 세션에만 적용됩니다. 모델 선택 참고 |
/effort [level|auto|status|ultracode [on|off]] | effort 수준을 설정합니다. low부터 xhigh, max, auto까지 있으며 status는 현재 값을 출력합니다. max는 해당 세션에서만 유효합니다 |
/btw [question] | 대화에 추가하지 않고 곁가지 질문을 합니다 |
/add-dir <path> | 세션 중 파일에 접근할 작업 디렉터리를 추가합니다. 경로 일부를 입력하면 후보가 표시되며 Tab으로 선택합니다. 추가한 디렉터리의 .claude/ 설정은 대부분 검색되지 않습니다 |
/tasks | 현재 세션의 백그라운드 작업(끝난 subagent 포함)을 보고 관리합니다. /bashes로도 쓸 수 있습니다 |
컨텍스트와 세션
| 명령어 | 동작 |
|---|---|
/context [all] | 컨텍스트 사용량을 색상 격자로 보여 주고, 컨텍스트를 많이 차지하는 도구와 메모리 비대화에 대한 제안을 표시합니다. 전체 화면 모드에서는 항목별 내역이 접혀 있으며, all을 주면 펼쳐집니다 |
/compact [instructions] | 지금까지의 대화를 요약해 컨텍스트를 확보합니다. 요약에 초점을 둘 지침을 선택적으로 줄 수 있습니다 |
/clear [name] | 빈 컨텍스트로 새 대화를 시작합니다. 이름을 주면 /resume 선택기에서 이전 대화에 그 이름이 붙습니다. 같은 대화를 유지하면서 컨텍스트를 비우려면 /compact를 사용하세요. 별칭: /reset, /new |
/resume [session] | ID나 이름으로 대화를 재개하거나 세션 선택기를 엽니다. 별칭: /continue |
/rewind | 대화 및/또는 코드를 이전 시점으로 되감거나, 선택한 메시지부터 요약합니다. 별칭: /checkpoint, /undo |
/usage | 세션 비용, 요금제 사용 한도, 활동 통계를 보여 줍니다. /cost와 /stats는 별칭입니다. 비용을 줄이는 방법은 토큰 절약하기 참고 |
리뷰, 설정, 문제 해결
| 명령어 | 동작 |
|---|---|
/diff | Claude가 지금까지 한 편집을 포함해 작업 트리의 변경 사항을 검토합니다 |
/code-review | 현재 diff에서 정확성 버그를 점검합니다. --fix를 주면 Claude가 지적 사항을 적용하고, PR 번호를 주면 풀 리퀘스트를 리뷰합니다. 예: /code-review high 1234. /code-review ultra는 클라우드에서 멀티 에이전트 리뷰를 실행합니다. 별칭: /review |
/security-review | 현재 브랜치의 변경 사항에서 보안 취약점을 분석합니다. origin 리모트가 필요합니다 |
/permissions | 도구 권한의 allow, ask, deny 규칙을 대화형 창에서 관리합니다. 범위별 규칙 보기, 추가와 삭제, 작업 디렉터리 관리가 가능합니다. 별칭: /allowed-tools |
/config [key=value ...] | 테마, 모델, 출력 스타일 등을 다루는 Settings 인터페이스를 엽니다. /config model=sonnet처럼 쌍을 주면 설정을 바로 지정하며, /config --help는 받는 키를 나열합니다. 별칭: /settings |
/status | Settings 인터페이스의 Status 탭을 열어 버전, 모델, 계정, 연결 상태를 보여 줍니다. Claude가 응답하는 중에도 동작합니다 |
/doctor | 설치, 설정, 확장, CLAUDE.md 문제를 진단하는 점검을 실행하고, 확인 후 Claude가 적용할 수정안을 제시합니다. 별칭: /checkup |
/terminal-setup | VS Code, Cursor, Devin Desktop, Alacritty, Zed에 줄바꿈용 Shift+Enter 키 바인딩을 설치합니다. Apple Terminal에서는 대신 줄바꿈용 Option+Enter를 활성화하고 경고음을 끕니다 |
일부 명령어는 요금제나 플랫폼에 따라 제한됩니다. /desktop은 Claude 구독으로 로그인한 macOS와 x64 Windows에서만 표시되고, /upgrade는 Enterprise 요금제에서는 표시되지 않습니다. 또한 /vim은 v2.1.92에서 제거되었습니다. Vim 모드와 Normal 편집 모드를 전환하려면 /config에서 Editor mode를 사용하세요.
단축키
아래 단축키는 Interactive mode 문서의 General controls 표에서 가져왔습니다. macOS에서 Alt+B, Alt+F, Alt+D, Alt+Y, Alt+P 같은 Option/Alt 단축키를 쓰려면 먼저 터미널에서 Option을 Meta로 설정해야 합니다.
| 단축키 | 동작 |
|---|---|
Ctrl+C | 실행 중인 작업을 중단합니다. 실행 중인 것이 없으면 첫 번째 입력은 프롬프트를 지우고, 두 번째 입력은 Claude Code를 종료합니다 |
Esc | 턴 도중 현재 응답이나 도구 호출을 멈춥니다. Claude는 지금까지 한 작업을 유지합니다. 열린 대화상자를 닫고, 권한 프롬프트에서는 해당 동작을 거절합니다 |
Esc + Esc | 프롬프트에 텍스트가 있으면 지우고 초안을 히스토리에 저장하므로 Up으로 불러올 수 있습니다. 프롬프트가 비어 있으면 되감기 메뉴를 엽니다 |
Shift+Tab | 권한 모드를 순환합니다: default(모드 표시기에는 Manual로 표시), acceptEdits, plan, 그리고 사용 가능한 경우 bypassPermissions, 이어서 auto. 일부 Windows 환경에서는 Alt+M입니다 |
Ctrl+O | 도구 사용과 실행의 상세 내역을 보여 주는 트랜스크립트 뷰어를 켜고 끕니다 |
Ctrl+R | 명령어 히스토리를 역방향으로 검색합니다 |
Ctrl+B | 실행 중인 Bash 명령과 에이전트를 백그라운드로 보냅니다. tmux 사용자는 두 번 누릅니다 |
Ctrl+G 또는 Ctrl+X Ctrl+E | 프롬프트를 기본 텍스트 편집기에서 엽니다 |
Ctrl+V (iTerm2에서는 Cmd+V, Windows와 WSL에서는 Alt+V) | 클립보드의 이미지를 붙여넣고 커서 위치에 [Image #N] 칩을 삽입하므로, 프롬프트에서 위치로 이미지를 참조할 수 있습니다 |
Option+P (macOS) 또는 Alt+P (Windows/Linux) | 프롬프트를 지우지 않고 모델을 전환합니다 |
Option+T (macOS) 또는 Alt+T (Windows/Linux) | extended thinking을 켜고 끕니다. 항상 extended thinking을 사용하는 Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 모델에서는 효과가 없습니다 |
줄바꿈과 입력 접두사
| 입력 | 동작 |
|---|---|
\ + Enter | 줄바꿈을 삽입합니다. 모든 터미널에서 동작합니다 |
Shift+Enter | 줄바꿈을 삽입합니다. iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal에서는 기본 지원이며, 다른 터미널은 위의 /terminal-setup을 참고하세요 |
Ctrl+J | 줄바꿈을 삽입합니다. 설정 없이 모든 터미널에서 동작합니다 |
맨 앞의 ! | 셸 모드: 명령을 직접 실행하고, 출력을 세션에 추가하며, Claude가 그에 응답합니다 |
@ | 파일 경로 멘션. 경로 자동 완성을 띄웁니다 |
빈 입력에서 ? | 단축키 도움말 패널을 켜고 끕니다 |
! npm test
! git status셸 모드 명령은 Claude가 해석하거나 승인할 필요가 없으며, 출력은 대화 컨텍스트에 들어갑니다. 이후 Claude는 그 출력에 자동으로 응답하며, 비용은 일반 프롬프트를 보낼 때와 같습니다.
문서에서 언급하는 실행 플래그
실행 플래그의 전체 목록은 CLI reference에 있습니다. 이 두 문서에서 언급하는 것은 몇 개뿐입니다.
claude --debug # start with debug logging on
claude --settings file.json # apply this settings file to this session only세션 도중에 디버그 로깅을 켜려면 /debug를 실행하세요. 그 시점부터 로그를 수집하기 시작합니다.
FAQ
"Unknown command"가 나옵니다. 왜 그런가요?
대개 오타이거나, 해당 명령어가 사용 중인 플랫폼, 요금제, 환경에서 제공되지 않기 때문입니다. 오타를 내면 메뉴에 아무것도 강조되지 않고 Enter를 누르면 입력한 텍스트가 그대로 제출되어 Unknown command가 보고됩니다. 사용할 수 없는 명령어는 메뉴에 아예 나타나지 않습니다. 비슷한 메시지는 오류 해결을 참고하세요.
Claude가 응답하는 중에 명령어를 보낼 수 있나요?
네. Claude Code가 명령어를 대기열에 넣었다가 현재 턴이 끝난 뒤 실행합니다. /status, /tasks, /usage 같은 일부 명령어는 응답을 중단하지 않고 즉시 실행됩니다.
macOS에서 Option 단축키가 동작하지 않습니다. 왜 그런가요?
터미널에서 Option을 Meta로 설정해야 합니다. 터미널별 설정은 Anthropic의 터미널 설정 가이드에 있습니다. 문서에 따르면 Option+T만 예외로, 설정 없이도 동작합니다.
출처
- Claude Code: Commands (슬래시 명령어, 별칭, 요금제 및 플랫폼 제한)
- Claude Code: Interactive mode (단축키, 여러 줄 입력, 셸 모드, 대기열 메시지)
- Claude Code: CLI reference (실행 플래그 전체 목록)