Claude Code 명령어 정리 — 슬래시 명령어 · 단축키 · CLI
요약
Claude Code의 효율적인 사용을 위한 슬래시 명령어, 키보드 단축키, CLI 옵션을 정리한 가이드입니다. 세션 관리, 컨텍스트 압축, 환경 설정 등 실무에서 자주 쓰이는 핵심 기능을 요약하여 제공합니다.
핵심 포인트
- 슬래시 명령어(/clear, /compact 등)를 통한 세션 및 컨텍스트 관리
- Esc 및 단축키를 활용한 작업 중단 및 체크포인트 롤백 기능
- 셸 모드(!명령어)와 파일 멘션(@경로)을 통한 효율적인 개발 워크플로우
- CLAUDE.md와 MCP를 활용한 프로젝트 메모리 및 도구 관리
Claude Code의 슬래시 명령어(Slash Commands) · 키보드 단축키 · CLI 옵션을 실제로 손이 움직이는 "자주 사용하는 순서"대로 요약표로 정리했습니다. 양이 많아서 다 외우기 어려우므로, 지도처럼 곁에 두는 용도입니다. (2026년 7월 시점. 최신 전체 목록은 입력창에 /를 입력하거나 /help를 입력하면 나옵니다)
우선 이것만은 기억하기
| 조작 | 내용 |
|---|---|
/clear | 대화를 리셋하고 새로운 세션 시작 (이력은 /resume으로 복구 가능) |
/compact | 대화를 요약하여 컨텍스트 (Context) 압축. /compact 지시로 요약 방침도 전달 가능 |
/context | 컨텍스트 사용량 내역 표시. 사용량이 늘어나면 /compact 판단에 활용 |
/resume | 과거 세션 목록에서 선택하여 재개 |
Esc | 실행 중인 Claude를 중단 (그때까지의 작업은 남음). 방향을 수정하고 싶을 때 |
Esc ×2 | 입력이 비어 있을 때는 되감기 메뉴 (코드·대화를 체크포인트로 되돌림). 입력이 있을 때는 초안 삭제 |
Shift+Tab | 권한 모드 전환 (수동 승인 → 편집 자동 승인 → 플랜 모드… ) |
!명령어 | 셸 모드 (Shell Mode). Claude를 거치지 않고 직접 명령어를 실행하여 출력을 대화에 포함 |
@경로 | 파일 경로 자동 완성 기능이 포함된 멘션. 대상 파일을 명시하여 지시 가능 |
세션 · 대화 조작
| 명령어 | 설명 |
|---|---|
/clear | 새로운 대화 시작 (CLAUDE.md 등의 메모리는 유지) |
/compact | 대화를 요약하여 압축 |
/context | 컨텍스트 사용 상황을 시각화 |
/resume | 과거 세션으로 돌아가기 |
/rewind | 코드와 대화를 체크포인트까지 롤백 (Rollback) (Esc ×2와 동일) |
/fork | 현재 대화를 복사하여 별도의 백그라운드 세션 시작 |
/btw 질문 | 대화 이력을 더럽히지 않고 옆에서 질문. 답변은 오버레이로 표시되며 이력에 남지 않음 |
/copy | 직전 응답을 클립보드에 복사 |
/export | 대화를 텍스트 파일로 내보내기 |
/recap | 지금까지의 세션 요약 생성 |
/btw는 "현재 컨텍스트는 전부 볼 수 있지만 도구는 사용할 수 없는" 역 서브 에이전트(Sub-agent) 같은 기능입니다. 작업을 멈추지 않고 "그 파일 이름이 뭐였더라"라고 물어볼 수 있습니다.
설정 · 환경 관련
| 명령어 | 설명 |
|---|---|
/config | 각종 설정 (에디터 모드=vim화, 테마, 자동 응답 등) 조정 |
/model | 모델 전환 |
/effort | 사고의 깊이 (low~max) 변경 |
/fast | 패스트 모드 (Fast Mode, 고속 출력) On/Off |
/permissions | 도구 실행 승인 규칙 설정 |
/memory | CLAUDE.md (메모리 파일)을 열어서 편집 |
/init | 프로젝트를 분석하여 CLAUDE.md를 자동 생성 |
/add-dir 경로 | 작업 디렉토리 추가 (모노레포 외부를 다루게 하고 싶을 때) |
/mcp | MCP 서버의 접속 · 인증 관리 |
/agents | 서브 에이전트(Sub-agent) 생성 · 관리 |
/skills | 사용 가능한 스킬 목록 · 관리 |
/hooks | 도구 실행 전후의 훅(Hook) 설정 |
/statusline | 터미널 하단의 상태 표시줄(Status line) 표시 설정 |
/terminal-setup | Shift+Enter를 통한 줄바꿈 키 바인딩을 터미널에 설정 |
/theme | 배색 테마 변경 |
/doctor | 설치 · 설정 진단 |
/login /logout | 계정 전환 |
/usage (/cost) | 토큰 사용량 · 플랜 잔량 표시 |
개발 워크플로우 계열 (번들 스킬)
| 명령어 |
설명 |
/plan |
플랜 모드로 전환 (구현 전에 계획을 세우게 하고 승인함) |
/code-review |
현재 diff를 리뷰. /code-review ultra로 멀티 에이전트(Multi-agent) 기반의 무거운 리뷰 수행 |
/security-review |
diff의 보안 취약점 체크 |
/simplify |
동작을 바꾸지 않는 클린업(Cleanup) 제안만 수행하는 리뷰 |
/review PR번호 |
GitHub의 PR을 리뷰 |
/deep-research 질문 |
웹을 검색하여 인용이 포함된 리포트 작성 |
/loop |
프롬프트를 반복 실행 (정기 실행 · 자율 주행) |
/goal 조건 |
목표 조건을 설정하여, 이를 충족할 때까지 작업을 계속하게 함 |
/subtask 지시 |
서브 에이전트(Sub-agent)에게 태스크 위임 |
/tasks |
실행 중인 백그라운드 태스크 · 서브 에이전트 목록 |
/background |
현재 세션을 백그라운드 에이전트로 전환 |
키보드 단축키 (자주 사용하는 것)
| 키 |
동작 |
Esc |
중단 / 다이얼로그 닫기 |
Esc ×2 |
되돌리기 메뉴 (입력이 비어 있을 때) |
Shift+Tab |
권한 모드 전환 |
Ctrl+C |
중단. 입력 내용이 있으면 삭제, 한 번 더 누르면 종료 |
Ctrl+O |
트랜스크립트 뷰어 (도구 실행 상세 로그) 열기/닫기 |
Ctrl+R |
과거 프롬프트 역순 검색 |
Ctrl+B |
실행 중인 명령어 · 에이전트를 백그라운드로 전환 |
Ctrl+T |
Claude의 태스크 체크리스트 표시 열기/닫기 |
Ctrl+S |
입력 중인 텍스트를 임시 저장 (한 번 더 누르면 복원) |
Ctrl+G |
입력 내용을 외부 에디터에서 편집 |
Ctrl+L |
화면 재그리기 (표시가 깨졌을 때) |
Alt+P |
모델 전환 (입력을 지우지 않고) |
Alt+O |
패스트 모드(Fast mode) 전환 |
? (빈 입력 시) |
단축키 도움말 표시 |
Tab |
회색으로 표시되는 프롬프트 후보 채택 |
줄바꿈은 Shift+Enter
(Windows Terminal은 그대로 사용 가능. VS Code 계열은 /terminal-setup으로 설정) 또는 Ctrl+J, \ + Enter로도 가능.
입력 접두사 (Prefix)
| 시작 문자 |
의미 |
/ |
명령어 · 스킬 호출 |
! |
쉘 모드 (직접 명령어 실행, 출력이 대화에 포함됨) |
@ |
파일 경로 자동 완성 |
? |
단축키 도움말 (빈 입력 시에만) |
터미널에서 사용하는 CLI 명령어
| 명령어 |
설명 |
claude |
대화 세션 시작 |
claude "지시" |
첫 프롬프트와 함께 시작 |
claude -p "지시" |
대화 없이 1회 실행 후 종료 (스크립트용. 파이프 입력도 가능) |
claude -c |
이 디렉토리의 마지막 세션을 이어서 시작 |
claude -r 이름 |
세션을 이름 · ID로 재개 |
claude --model 모델명 |
모델 지정하여 실행 |
claude update |
Claude Code 본체 업데이트 |
claude doctor |
환경 진단 |
claude mcp |
MCP 서버 설정 |
claude agents |
병렬 세션을 에이전트 뷰에서 관리 |
커스텀 명령어 (스킬) 만드는 법
자작 슬래시 명령어는 스킬(Skill)로 만든다. 리포지토리의 .claude/skills/명령어명/SKILL.md에 절차를 적기만 하면 /명령어명으로 호출할 수 있게 되며, 리포지토리째로 커밋하면 팀(과 미래의 자신)에게 공유된다.
.claude/
skills/
commit/
...
필자의 리포지토리에서는 커밋 규약을 적은 /commit, 블로그 기사 생성용 /blog-article, X(구 Twitter) 공지 소재 작성용 /x-announce 등을 스킬화하여 매번 같은 지시를 입력할 필요가 없어졌다. "같은 지시를 2번 이상 붙여넣었다면 스킬로 만든다" 정도가 딱 적당하다.
요약
- 일상적으로는
/clear,/compact
/context
/resume
Esc
Shift+Tab
!
@
이 정도면 거의 충분하다.
- 실패했을 때는
Esc를 두 번 눌러 되돌리기(Rollback). 구현 전에 내용을 확정 짓고 싶을 때는/plan을 사용한다. - 커밋(Commit) 전에는
/code-review를, 정형화된 작업은.claude/skills/로 분리한다. - 최신 전체 명령어는 입력창에
/를 입력하면 나타난다. 이 기사는 "자주 사용하는 것들"의 지도와 같다.
이 기사는 Claude Code를 최대한 활용하여 개인적으로 Web 도구를 양산하는 과정에서 쌓인 메모이다. 제작한 도구군과 양산 기록은 Novare Orbis에서 공개하고 있다. 괜찮다면 한 번 둘러봐 주길 바란다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기