Claude Code 치트 시트 — 명령어, 단축키, 플래그
Claude Code의 슬래시 명령어, CLI 플래그, 키보드 단축키, CLAUDE.md와 설정 파일 위치, 훅, MCP 명령어를 한 페이지에.
Claude Code 치트 시트 — freetoolsforweb.com
에 Claude Code 문서와 대조해 확인했습니다(최신 릴리스 v2.1.302 (October 16, 2026)). Claude Code는 일주일에도 여러 번 릴리스되므로, 최신 내용은 변경 로그를 확인하거나 claude --help와 /help를 실행하세요.
표 8개, 항목 169개
내장 슬래시 명령어#
세션에서 /를 입력하면 플러그인과 MCP 서버의 스킬·명령어를 포함해 사용 가능한 모든 명령어가 표시됩니다. 일부는 요금제나 플랫폼에 따라 다릅니다.
| 명령어 | 기능 | |
|---|---|---|
| /help | 도움말과 사용 가능한 명령어를 표시합니다. | |
| /clear | 컨텍스트가 빈 새 대화를 시작합니다. 별칭 /reset, /new. 이전 대화는 /resume에 남아 있습니다. | |
| /compact [instructions] | 지금까지의 대화를 요약해 컨텍스트를 확보합니다. 요약에 대한 초점 지시를 추가할 수 있습니다. | |
| /context | 컨텍스트 창 사용량을 색깔 격자로 보여 주고, 공간을 차지하는 항목에 대한 제안을 표시합니다. | |
| /init | 프로젝트용 CLAUDE.md 가이드를 만듭니다. | |
| /memory | CLAUDE.md 파일을 편집하고, 자동 메모리를 켜거나 끄고, 자동 메모리 항목을 봅니다. | |
| /model [model] | 모델을 바꾸고 기본값으로 저장합니다. 인수 없이 실행하면 선택기가 열립니다(좌우 화살표로 노력 수준 조정). | |
| /effort [level|auto|status] | 노력 수준을 설정합니다(low~xhigh, max 또는 auto). status는 현재 수준을 출력합니다. | |
| /fast [on|off] | 빠른 모드를 켜거나 끕니다. | |
| /config [key=value] | 설정(테마, 모델, 출력 스타일...)을 열거나 값을 바로 지정합니다. 예: /config theme=dark. | |
| /status | 버전, 모델, 계정, 연결 상태를 표시합니다. | |
| /usage | 세션 비용, 요금제 사용 한도, 활동 통계. 별칭 /cost, /stats. | |
| /permissions | 도구에 대한 허용·확인·거부 규칙과 작업 디렉터리를 관리합니다. | |
| /plan [description] | 플랜 모드로 들어갑니다. 작업을 바로 지정할 수도 있습니다: /plan fix the auth bug. | |
| /resume [session] | ID나 이름으로 대화를 재개하거나 세션 선택기를 엽니다. | |
| /rename [name] | 현재 세션 이름을 바꿉니다(프롬프트 바와 /resume에 표시). | |
| /branch [name] | 여기서 대화를 분기해 다른 방향을 시도합니다. 원래 대화는 /resume에 남아 있습니다. | |
| /fork [prompt] | 대화를 새 백그라운드 세션으로 복사하고, 여기서는 계속 작업합니다. | |
| /background [prompt] | 이 세션을 분리해 백그라운드 에이전트로 실행합니다(별칭 /bg). claude agents로 모니터링합니다. | |
| /rewind | 대화와 코드 중 하나 또는 둘 다를 이전 시점으로 되돌립니다. 별칭 /checkpoint, /undo. | |
| /btw [question] | 대화에 추가하지 않고 곁가지 질문을 합니다. | |
| /diff | Claude의 수정을 포함해 작업 트리의 변경 사항을 검토합니다. | |
| /review [level] [pr|branch|path] | /code-review의 별칭: 현재 diff나 PR에서 버그를 검토합니다. | |
| /security-review | 브랜치의 변경 사항에서 보안 취약점을 검토합니다(origin 원격 저장소 필요). | |
| /simplify [target] | 스킬: 변경된 코드를 재사용, 단순화, 효율성 관점에서 검토한 뒤 수정 사항을 적용합니다. | |
| /copy [N] | 마지막(또는 N번째 최근) 응답을 클립보드에 복사합니다. 코드 블록을 하나씩 고를 수 있습니다. | |
| /export [filename] | 대화를 일반 텍스트로 파일이나 클립보드에 내보냅니다. | |
| /add-dir <path> | 이 세션에서 Claude가 다른 작업 디렉터리에 접근하도록 합니다. | |
| /cd <path> | 대화를 유지한 채 세션을 새 작업 디렉터리로 옮깁니다. | |
| /agents | 서브에이전트 만들기 안내: Claude에게 요청하거나 .claude/agents/ 또는 ~/.claude/agents/를 편집하세요. | |
| /tasks | 백그라운드 작업(셸과 서브에이전트)을 보고 관리합니다. /bashes도 같습니다. | |
| /skills | 사용 가능한 스킬을 나열합니다. 필터링, 토큰 비용순 정렬, 표시/숨기기가 가능합니다. | |
| /mcp | MCP 서버 연결과 OAuth를 관리합니다. /mcp reconnect all은 실패한 서버를 다시 시도합니다. | |
| /hooks | 훅 설정을 봅니다. | |
| /plugin [subcommand] | 플러그인 관리: 목록, 설치, 사용, 사용 중지. | |
| /keybindings | 키보드 단축키 파일(~/.claude/keybindings.json)을 엽니다. | |
| /output-style [style] | 출력 스타일을 나열하거나 전환합니다. | |
| /theme | 색상 테마를 바꿉니다(auto, light, dark, 색각 이상 친화, ANSI). | |
| /statusline | 상태 표시줄을 설정하거나, 셸 프롬프트를 바탕으로 자동 설정합니다. | |
| /terminal-setup | 터미널이나 편집기에 Shift+Enter 줄바꿈 키 바인딩을 설치합니다. | |
| /ide | IDE 연동을 관리하고 상태를 표시합니다. | |
| /doctor | 스킬: 설치, 설정, 확장 기능, CLAUDE.md를 점검하고 수정 방법을 제안합니다. 별칭 /checkup. | |
| /loop [interval] [prompt] | 스킬: 세션이 열려 있는 동안 프롬프트를 반복 실행합니다. 예: /loop 5m check the deploy. | |
| /schedule [description] | 클라우드에서 실행되는 루틴을 만들고, 수정하고, 나열하거나 실행합니다. | |
| /goal [condition|clear] | 목표를 설정하면 Claude가 달성할 때까지 여러 턴에 걸쳐 계속 작업합니다. | |
| /install-github-app | Claude GitHub 앱을 설치하고, 원하면 GitHub Actions도 설정합니다. | |
| /sandbox | 샌드박스 모드를 켜거나 끕니다(지원 플랫폼만). | |
| /login | Anthropic 계정에 로그인합니다. | |
| /logout | 로그아웃합니다. | |
| /bug [report] | 동의 화면을 거쳐 버그를 신고하거나 대화를 공유합니다. | |
| /release-notes | 버전별 변경 로그를 봅니다. | |
| /exit | CLI를 종료합니다. 별칭 /quit. | |
| /vim (removed) | v2.1.92에서 제거되었습니다. 대신 /config > Editor mode에서 Vim 편집 모드를 전환하세요. |
CLI 명령어(셸에서 실행)#
| 명령어 | 기능 | |
|---|---|---|
| claude | 대화형 세션을 시작합니다. | |
| claude "query" | 첫 프롬프트와 함께 대화형 세션을 시작합니다. | |
| claude -p "query" | 대화형 UI 없이 한 번 답하고 종료합니다(print / SDK 모드). | |
| cat file | claude -p "query" | 파이프로 넘긴 내용을 처리합니다. 예: cat logs.txt | claude -p "explain". | |
| claude -c | 이 디렉터리의 가장 최근 대화를 이어 갑니다. | |
| claude -r "<session>" "query" | ID나 이름으로 세션을 재개하며, 새 프롬프트를 함께 줄 수 있습니다. | |
| claude update | 최신 버전으로 업데이트합니다. | |
| claude install [version] | 네이티브 바이너리를 설치하거나 다시 설치합니다: 특정 버전, stable 또는 latest. | |
| claude auth login | 로그인합니다(--console을 쓰면 구독 대신 Anthropic Console로 청구). | |
| claude auth status | 로그인 상태를 JSON으로 표시합니다(--text는 일반 텍스트). | |
| claude agents | 에이전트 뷰를 열어 백그라운드 세션을 모니터링하고 배정합니다. | |
| claude doctor | 세션을 시작하지 않고 설치·설정 진단 결과를 출력합니다. | |
| claude mcp | MCP 서버를 설정합니다(아래 MCP 표 참고). | |
| claude plugin | 플러그인을 관리합니다(별칭 claude plugins). | |
| claude setup-token | CI와 스크립트용 장기 OAuth 토큰을 생성합니다(구독 필요). | |
| claude -v | 설치된 버전을 출력합니다. |
CLI 플래그#
플래그는 claude 뒤, 프롬프트 앞에 씁니다. 일부(-p 전용)는 print 모드에만 적용됩니다.
| 플래그 | 기능 | 예시 | |
|---|---|---|---|
| --print, -p | 대화형 모드 없이 응답을 출력합니다. | claude -p "query" | |
| --continue, -c | 현재 디렉터리의 가장 최근 대화를 불러옵니다. | claude --continue | |
| --resume, -r | ID나 이름으로 세션을 재개하거나 선택기를 표시합니다. | claude --resume auth-refactor | |
| --fork-session | --resume이나 --continue와 함께 쓰면 이전 세션 ID를 재사용하지 않고 새 ID로 시작합니다. | claude --resume abc123 --fork-session | |
| --name, -n | 세션 이름을 지정합니다(/resume과 터미널 제목에 표시). | claude -n "my-feature-work" | |
| --model | 이 세션의 모델: 별칭(sonnet, opus, haiku, fable) 또는 전체 모델 이름. | claude --model sonnet | |
| --fallback-model | 기본 모델이 과부하이거나 사용할 수 없을 때 이 모델들로 순서대로 대체합니다. | claude --fallback-model sonnet,haiku | |
| --effort | 이 세션의 노력 수준: low, medium, high, xhigh, max 또는 ultracode. | claude --effort high | |
| --permission-mode | 특정 권한 모드로 시작합니다: default(수동), acceptEdits, plan, auto, dontAsk, bypassPermissions. | claude --permission-mode plan | |
| --dangerously-skip-permissions | 권한 확인을 건너뜁니다(--permission-mode bypassPermissions와 동일). 격리된 컨테이너나 VM에서만 쓰세요. | claude --dangerously-skip-permissions | |
| --allowedTools | 권한 규칙 문법으로 지정한, 확인 없이 실행되는 도구. | claude --allowedTools "Bash(git log *)" "Read" | |
| --disallowedTools | 거부 규칙: 도구 이름만 쓰면 도구를 제거하고, 범위를 지정한 규칙은 일치하는 호출을 거부합니다. | claude --disallowedTools "Bash(rm *)" "Edit" | |
| --tools | 사용할 수 있는 내장 도구를 제한합니다: 없음은 "", "default" 또는 목록. | claude --tools "Bash,Edit,Read" | |
| --output-format | print 모드 출력 형식: text, json 또는 stream-json. | claude -p "query" --output-format json | |
| --input-format | print 모드 입력 형식: text 또는 stream-json. | claude -p --output-format json --input-format stream-json | |
| --json-schema | 실행이 끝나면 스키마에 맞는 검증된 JSON을 반환합니다(print 모드). | claude -p --json-schema '{"type":"object"}' "query" | |
| --max-turns | 에이전트 턴 수를 제한합니다(print 모드). | claude -p --max-turns 3 "query" | |
| --max-budget-usd | 예상 API 비용이 이 금액에 도달하면 멈춥니다(print 모드). | claude -p --max-budget-usd 5.00 "query" | |
| --append-system-prompt | 기본 시스템 프롬프트 뒤에 텍스트를 덧붙입니다. | claude --append-system-prompt "Always use TypeScript" | |
| --system-prompt | 시스템 프롬프트 전체를 교체합니다. | claude --system-prompt "You are a Python expert" | |
| --add-dir | Claude가 읽고 편집할 수 있는 작업 디렉터리를 추가합니다. | claude --add-dir ../apps ../lib | |
| --mcp-config | JSON 파일이나 문자열에서 MCP 서버를 불러옵니다. | claude --mcp-config ./mcp.json | |
| --strict-mcp-config | --mcp-config의 서버만 사용합니다. | claude --strict-mcp-config --mcp-config ./mcp.json | |
| --settings | 이 세션에 JSON 파일이나 문자열의 설정을 불러옵니다. | claude --settings ./settings.json | |
| --setting-sources | 불러올 설정 파일: user, project, local. | claude --setting-sources user,project | |
| --agents | 서브에이전트를 JSON으로 인라인 정의합니다. | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' | |
| --agent | 세션을 특정 에이전트로 실행합니다. | claude --agent my-custom-agent | |
| --worktree, -w | .claude/worktrees/ 아래의 격리된 git 워크트리에서 시작합니다. | claude -w feature-auth | |
| --bare | 최소 모드: 빠른 스크립트 실행을 위해 훅, 스킬, 플러그인, MCP, 자동 메모리, CLAUDE.md를 건너뜁니다. | claude --bare -p "query" | |
| --safe-mode | 망가진 설정을 진단하기 위해 모든 사용자 지정을 끈 상태로 시작합니다. | claude --safe-mode | |
| --verbose | 턴별 전체 출력을 표시합니다. | claude --verbose | |
| --debug | 디버그 모드. 카테고리로 필터링할 수 있습니다. | claude --debug='mcp,startup' | |
| --ide | 시작할 때 사용 가능한 IDE가 정확히 하나이면 연결합니다. | claude --ide | |
| --chrome | Claude in Chrome 브라우저 연동을 사용합니다. | claude --chrome | |
| --version, -v | 버전 번호를 출력합니다. | claude -v |
권한 모드#
Shift+Tab으로 순환하거나, --permission-mode로 시작하거나, 설정에서 defaultMode를 지정합니다. UI에서 Manual이라고 표시되는 모드는 설정에서 default입니다.
| 모드 | 확인 없이 실행되는 것 | 추천 용도 | |
|---|---|---|---|
| default (Manual) | 읽기만. | 모든 동작 검토, 민감한 작업 | |
| acceptEdits | 읽기, 파일 수정, 일반적인 파일 시스템 명령어(mkdir, touch, mv, cp...). | 검토 중인 코드를 반복 수정할 때 | |
| plan | 읽기, 그리고 auto 모드를 쓸 수 있으면 분류기가 승인한 명령어. | 변경 전에 코드베이스 살펴보기 | |
| auto | 전부. 백그라운드 안전 검사와 함께. | 긴 작업, 확인 요청 줄이기 | |
| dontAsk | 작업 디렉터리 내 파일 읽기와 사전 승인된 도구. 그 밖에는 모두 거부. | 잠긴 CI와 스크립트 | |
| bypassPermissions | 전부. | 격리된 컨테이너와 VM에서만 |
메모리: CLAUDE.md 파일과 위치#
CLAUDE.md 파일은 매 세션 시작 시 로드됩니다. 파일 안에 @path/to/file을 쓰면 다른 파일을 가져옵니다(최대 4단계).
| 파일 | 범위와 용도 | |
|---|---|---|
| /Library/Application Support/ClaudeCode/CLAUDE.md | 관리형 정책(macOS): IT 부서가 배포하는 조직 전체 지침. Linux와 WSL: /etc/claude-code/CLAUDE.md, Windows: C:\Program Files\ClaudeCode\CLAUDE.md. | |
| ~/.claude/CLAUDE.md | 모든 프로젝트에 적용되는 개인 지침. | |
| ./CLAUDE.md or ./.claude/CLAUDE.md | 소스 관리로 팀과 공유하는 프로젝트 지침. | |
| ./CLAUDE.local.md | 이 프로젝트용 개인 메모. .gitignore에 추가하세요. | |
| .claude/rules/*.md | 주제별 파일(testing.md, api-design.md). 선택 사항인 paths 프런트매터를 쓰면 일치하는 파일에만 규칙을 로드합니다. | |
| ~/.claude/projects/<project>/memory/ | 자동 메모리: Claude가 스스로 작성하는 MEMORY.md 색인과 주제별 파일. /memory로 관리합니다. | |
| AGENTS.md | 이 파일도 프로젝트 지침으로 읽힙니다. CLAUDE.md 대신 또는 함께 로드되는 경우는 메모리 문서에 설명되어 있습니다. |
설정 파일(우선순위 높은 순)#
관리형 설정이 --settings보다 우선하고, 그다음 프로젝트 로컬, 공유 프로젝트, 사용자 설정 순입니다. 권한 규칙 같은 목록은 파일 간에 병합됩니다.
| 파일 | 범위와 용도 | |
|---|---|---|
| managed-settings.json | 관리형: 조직이 배포합니다(파일, MDM 또는 서버 관리). 내 파일이나 --settings로 이 키를 덮어쓸 수 없습니다. | |
| --settings <file-or-json> | 명령줄: 한 세션 동안 아래 파일들보다 우선합니다. | |
| .claude/settings.local.json | 프로젝트 로컬: 이 프로젝트에서 나에게만 적용되며 git에서 제외됩니다. | |
| .claude/settings.json | 공유 프로젝트: 커밋하면 팀 전체가 같은 권한, 훅, 플러그인을 씁니다. | |
| ~/.claude/settings.json | 사용자: 모든 프로젝트에 적용되는 내 환경설정(테마, 모델, 권한 규칙). | |
| ~/.claude.json | Claude Code가 직접 작성: 로그인, MCP 서버, 프로젝트별 상태. 우선순위 단계에는 포함되지 않습니다. | |
| ~/.claude/keybindings.json | 사용자 지정 키보드 단축키(/keybindings로 열기). 변경 사항은 재시작 없이 적용됩니다. |
훅 이벤트#
훅은 설정 파일의 "hooks" 키에 넣는 셸 명령어(또는 프롬프트)입니다. 차단 가능한 이벤트에서는 종료 코드 2가 동작을 막고, stderr가 Claude에게 표시됩니다.
| 이벤트 | 실행 시점 | |
|---|---|---|
| SessionStart | 세션이 시작되거나 재개될 때. | |
| Setup | Claude Code가 --init-only로 시작되거나, -p 모드에서 --init / --maintenance로 시작될 때. | |
| UserPromptSubmit | 프롬프트를 제출한 직후, Claude가 처리하기 전. | |
| UserPromptExpansion | 입력한 명령어가 프롬프트로 확장될 때. 확장을 막을 수 있습니다. | |
| PreToolUse | 도구 호출이 실행되기 전. 호출을 막을 수 있습니다. | |
| PermissionRequest | 도구 호출에 권한 결정이 필요할 때. | |
| PermissionDenied | auto 모드가 도구 호출을 거부할 때. | |
| PostToolUse | 도구 호출이 성공한 후. | |
| PostToolUseFailure | 도구 호출이 실패한 후. | |
| PostToolBatch | 병렬 도구 호출 묶음이 끝난 후, 다음 모델 호출 전. | |
| Notification | Claude Code가 알림을 보낼 때(권한 확인, 대기 알림...). | |
| MessageDisplay | 어시스턴트 메시지 텍스트가 표시되는 동안. | |
| SubagentStart | 서브에이전트가 생성될 때. | |
| SubagentStop | 서브에이전트가 끝날 때. | |
| TaskCreated | 작업이 생성되는 중일 때. | |
| TaskCompleted | 작업이 완료로 표시되는 중일 때. | |
| Stop | Claude가 응답을 마칠 때. | |
| StopFailure | API 오류로 턴이 끝날 때. | |
| TeammateIdle | 에이전트 팀의 팀원이 유휴 상태로 전환되기 직전. | |
| InstructionsLoaded | CLAUDE.md나 .claude/rules 파일이 컨텍스트에 로드될 때. | |
| ConfigChange | 세션 중 설정 파일이 바뀔 때. | |
| CwdChanged | 작업 디렉터리가 바뀔 때(direnv와 함께 쓰면 유용). | |
| DirectoryAdded | /add-dir로 작업 디렉터리를 추가할 때. | |
| FileChanged | 감시 중인 파일이 디스크에서 바뀔 때(matcher에 파일 이름 나열). | |
| WorktreeCreate | 워크트리가 생성되는 중일 때. 기본 git 동작을 대체합니다. | |
| WorktreeRemove | WorktreeCreate 훅으로 만든 워크트리가 제거될 때. | |
| PreCompact | 컨텍스트 압축 전. | |
| PostCompact | 압축이 끝난 후. | |
| PreModelSwitch | 모델 전환이 적용되기 전. 전환을 막을 수 있습니다. | |
| PostModelSwitch | 세션의 모델이 바뀐 후. | |
| Elicitation | MCP 서버가 도구 호출 중 사용자 입력을 요청할 때. | |
| ElicitationResult | MCP 입력 요청에 답한 후, 답이 전송되기 전. | |
| SessionEnd | 세션이 끝날 때. |
MCP 서버 명령어#
범위: local(기본값, 이 프로젝트, ~/.claude.json에 저장), project(저장소의 .mcp.json, 팀과 공유), user(모든 프로젝트, ~/.claude.json).
| 명령어 | 기능 | 예시 | |
|---|---|---|---|
| claude mcp add --transport http <name> <url> | 원격 HTTP 서버를 추가합니다. | claude mcp add --transport http notion https://mcp.notion.com/mcp | |
| claude mcp add [options] <name> -- <command> [args...] | 로컬 stdio 서버를 추가합니다. -- 뒤의 모든 내용이 서버를 실행합니다. | claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server | |
| claude mcp add --transport sse <name> <url> | SSE 엔드포인트만 제공하는 서버를 추가합니다. | claude mcp add --transport sse asana https://mcp.asana.com/sse | |
| --scope local|project|user | 서버를 저장할 위치를 고릅니다(기본값 local). | claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic | |
| claude mcp add-json <name> '<json>' | JSON 설정 객체로 서버를 추가합니다. | claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}' | |
| claude mcp list | 서버 목록과 상태(Connected, Needs authentication, Failed)를 표시합니다. | ||
| claude mcp get <name> | 서버 하나의 세부 정보와 연결 문제를 표시합니다. | claude mcp get notion | |
| claude mcp remove <name> | 서버를 제거합니다. | claude mcp remove notion | |
| claude mcp login <name> | /mcp를 열지 않고 서버의 OAuth 절차를 실행합니다. | ||
| claude mcp add-from-claude-desktop | Claude Desktop에 설정된 서버를 가져옵니다. | ||
| claude mcp reset-project-choices | 프로젝트 범위 .mcp.json 서버에 대한 승인을 초기화합니다. | ||
| claude mcp serve | Claude Code 자체를 다른 앱용 stdio MCP 서버로 실행합니다. |
키보드 단축키
마지막 확인: , Claude Code v2.1.302(2026년 10월 16일) 기준. 단축키 48개.
대부분의 단축키는 모든 시스템에서 같으며, Mac에서도 Command가 아니라 Control을 씁니다. macOS의 Option 키 단축키(Option 더하기 B, Option 더하기 P...)를 쓰려면 터미널에서 “Option as Meta”를 켜야 합니다. 대부분의 동작은 ~/.claude/keybindings.json에서 다른 키로 바꿀 수 있습니다(/keybindings 실행).
5개 카테고리의 단축키 48개 모두 표시
일반 조작#
| 기능 | macOS | Windows / Linux | 복사 |
|---|---|---|---|
| Claude 중단 또는 대화상자 닫기현재 응답이나 도구 호출을 멈추며, 지금까지 한 작업은 유지됩니다. 권한 확인 화면에서 Esc는 No로 답합니다. | Escape | Escape | |
| 입력 중인 내용 지우기, 또는 되감기 메뉴 열기(빈 프롬프트) | Escape 다음 Escape | Escape 다음 Escape | |
| 중단. 대기 중인 프롬프트에서는 내용을 지우고, 한 번 더 누르면 종료 | Control 더하기 C | Control 더하기 C | |
| Claude Code 종료(두 번 누르기)프롬프트에 텍스트가 있으면 Ctrl+D는 대신 커서 뒤의 문자를 삭제합니다. | Control 더하기 D | Control 더하기 D | |
| 권한 모드 순환(Manual, acceptEdits, plan, auto...) | Shift 더하기 Tab | Shift 더하기 Tab또는 Alt 더하기 M런타임이 VT 입력 모드를 켜지 않은 Windows에서는 Alt+M. | |
| 프롬프트를 지우지 않고 모델 전환 | Option 더하기 PmacOS: 터미널에서 "Option as Meta"를 켜야 합니다(/terminal-setup 또는 문서 참고). | Alt 더하기 P | |
| 확장 사고 켜기/끄기항상 사고하는 모델(Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable)에서는 효과가 없습니다. | Option 더하기 T | Alt 더하기 T | |
| 빠른 모드 켜기/끄기 | Option 더하기 O | Alt 더하기 O | |
| 텍스트 편집기에서 프롬프트 편집 | Control 더하기 G또는 Control 더하기 X 다음 Control 더하기 E | Control 더하기 G또는 Control 더하기 X 다음 Control 더하기 E | |
| 클립보드에서 이미지 붙여넣기 | Control 더하기 V또는 Command 더하기 ViTerm2에서는 Cmd+V. | Control 더하기 V또는 Alt 더하기 VWindows와 WSL에서는 Alt+V. | |
| 프롬프트 기록 역방향 검색 | Control 더하기 R | Control 더하기 R | |
| 기록의 이전 / 다음 프롬프트여러 줄 프롬프트에서는 화살표가 먼저 커서를 움직입니다. | 위쪽 화살표또는 아래쪽 화살표또는 Control 더하기 P또는 Control 더하기 N | 위쪽 화살표또는 아래쪽 화살표또는 Control 더하기 P또는 Control 더하기 N | |
| 트랜스크립트 뷰어 켜기/끄기(도구 호출 상세 보기) | Control 더하기 O | Control 더하기 O | |
| 실행 중인 Bash 명령어와 에이전트를 백그라운드로 보내기tmux에서는 두 번 누르세요. | Control 더하기 B | Control 더하기 B | |
| Claude의 할 일 체크리스트 표시/숨기기 | Control 더하기 T | Control 더하기 T | |
| 프롬프트 임시 보관(빈 프롬프트에서 다시 누르면 복원) | Control 더하기 S | Control 더하기 S | |
| 대기 중인 메시지 지금 보내기 | Control 더하기 Enter또는 Control 더하기 X 다음 Control 더하기 S | Control 더하기 Enter또는 Control 더하기 X 다음 Control 더하기 S | |
| 모든 백그라운드 서브에이전트 중지(3초 안에 두 번 누르기) | Control 더하기 X 다음 Control 더하기 K | Control 더하기 X 다음 Control 더하기 K | |
| 화면 다시 그리기(깨진 화면 복구) | Control 더하기 L | Control 더하기 L | |
| Claude Code를 일시 중단하고 셸로 돌아가기(fg로 재개) | Control 더하기 Z | Control 더하기 ZLinux 전용, Unix 셸. | |
| 자동 완성 제안 수락 | Tab | Tab | |
| 단축키 도움말 패널 표시(빈 프롬프트) | 물음표 | 물음표 | |
| 음성 받아쓰기: Space 길게 누르기(또는 탭)/voice를 켠 경우에만. | 스페이스 바 | 스페이스 바 |
프롬프트 텍스트 편집(readline 방식)#
| 기능 | macOS | Windows / Linux | 복사 |
|---|---|---|---|
| 줄 처음으로 이동 | Control 더하기 A | Control 더하기 A | |
| 줄 끝으로 이동 | Control 더하기 E | Control 더하기 E | |
| 줄 끝까지 삭제 | Control 더하기 K | Control 더하기 K | |
| 커서부터 줄 처음까지 삭제 | Control 더하기 U또는 Command 더하기 DeleteiTerm2와 Terminal.app은 Cmd+Backspace를 Ctrl+U로 보냅니다. | Control 더하기 U | |
| 이전 공백까지 삭제(경로 전체나 --플래그) | Control 더하기 W | Control 더하기 W | |
| 이전 단어 삭제 | Option 더하기 Delete | Control 더하기 BackspaceWindows. | |
| 마지막으로 삭제한 텍스트 붙여넣기 | Control 더하기 Y | Control 더하기 Y | |
| 이전에 삭제한 텍스트 순환(Ctrl+Y 이후) | Option 더하기 YmacOS: 터미널에서 "Option as Meta"를 켜야 합니다(/terminal-setup 또는 문서 참고). | Alt 더하기 Y | |
| 한 단어 뒤로 이동 | Option 더하기 BmacOS: 터미널에서 "Option as Meta"를 켜야 합니다(/terminal-setup 또는 문서 참고). | Alt 더하기 B | |
| 한 단어 앞으로 이동 | Option 더하기 FmacOS: 터미널에서 "Option as Meta"를 켜야 합니다(/terminal-setup 또는 문서 참고). | Alt 더하기 F | |
| 단어 끝까지 삭제 | Option 더하기 DmacOS: 터미널에서 "Option as Meta"를 켜야 합니다(/terminal-setup 또는 문서 참고). | Alt 더하기 D | |
| 프롬프트의 마지막 편집 실행취소 | Control 더하기 밑줄또는 Control 더하기 Shift 더하기 하이픈 | Control 더하기 밑줄또는 Control 더하기 Shift 더하기 하이픈 |
여러 줄 입력#
| 기능 | macOS | Windows / Linux | 복사 |
|---|---|---|---|
| 줄바꿈: \를 입력한 뒤 Enter(모든 터미널) | 백슬래시 다음 Return | 백슬래시 다음 Enter | |
| Shift+Enter로 줄바꿈iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple 터미널, Windows Terminal에서 기본 지원되며, /terminal-setup으로 VS Code, Cursor, Alacritty, Zed에 추가할 수 있습니다. | Shift 더하기 Return | Shift 더하기 Enter | |
| Ctrl+J로 줄바꿈(설정 없이 작동) | Control 더하기 J | Control 더하기 J | |
| Option+Enter로 줄바꿈 | Option 더하기 ReturnmacOS: 터미널에서 "Option as Meta"를 켜야 합니다(/terminal-setup 또는 문서 참고). | 기본 단축키 없음 |
빠른 접두사: /, !, @#
| 기능 | macOS | Windows / Linux | 복사 |
|---|---|---|---|
| 명령어나 스킬 시작 | 슬래시 | 슬래시 | |
| 셸 모드: 명령어를 실행하고 출력을 추가 | 느낌표 | 느낌표 | |
| 파일 언급(경로 자동 완성) | 골뱅이 | 골뱅이 | |
| 이모지 단축 코드(:name:) | 콜론 | 콜론 |
트랜스크립트 뷰어(Ctrl+O)#
| 기능 | macOS | Windows / Linux | 복사 |
|---|---|---|---|
| 트랜스크립트 뷰어 나가기 | Q또는 Control 더하기 C또는 Escape | Q또는 Control 더하기 C또는 Escape | |
| 전체 내용 표시(클래식 렌더러) | Control 더하기 E | Control 더하기 E | |
| 이전 / 다음 프롬프트로 이동(전체 화면) | 왼쪽 중괄호또는 오른쪽 중괄호 | 왼쪽 중괄호또는 오른쪽 중괄호 | |
| 대화를 터미널 스크롤백에 기록(전체 화면) | 왼쪽 대괄호 | 왼쪽 대괄호 | |
| $EDITOR에서 대화 열기(전체 화면) | V | V |
모든 작업은 브라우저에서 실행되며 검색어는 어디에도 전송되지 않습니다. 항목은 공식 Claude Code 문서와 대조해 확인했습니다. 모든 무료 도구 보기.
문제를 발견하셨거나 개선할 점이 있나요? 모든 메시지를 읽고 빠르게 고칩니다.
이 Claude Code 치트 시트는 Anthropic의 코딩 에이전트에서 쓰는 명령어, 키보드 단축키, CLI 플래그를 검색 가능한 한 페이지에 모았습니다. /init, /compact, /context, /rewind 같은 슬래시 명령어, 권한 모드를 순환하는 Shift+Tab과 되감기용 Esc 두 번 같은 단축키, 스크립트용 claude -p, --continue, --model, --permission-mode 같은 플래그가 있습니다. CLAUDE.md와 설정 파일의 위치, 모든 훅 이벤트, MCP 명령어처럼 세션 중에 가장 자주 찾아보게 되는 내용도 정리했습니다.
모든 내용은 2026-10-18에 code.claude.com의 공식 문서와 대조해 확인했으며, 당시 최신 릴리스는 v2.1.302(2026년 10월 16일)였습니다. Claude Code는 일주일에도 여러 번 릴리스되므로 명령어가 추가되거나 이름이 바뀌고 가끔 제거되기도 합니다. 제거된 명령어는 조용히 빼지 않고 표시해 둡니다. 설치된 버전이 지원하는 기능은 세션에서 /를 입력하거나 claude --help를 실행해 확인하고, 전체 옵션 목록은 링크된 문서를 참고하세요.
사용 방법
- 레퍼런스 표에서 명령어, 플래그, 파일, 훅 이벤트를 검색하세요("resume", "--model", "PreToolUse").
- 표 링크로 슬래시 명령어, CLI 플래그, 메모리 파일, 설정, 훅, MCP로 바로 이동하세요.
- 복사를 클릭하면 명령어나 플래그가 복사됩니다. 각 제목이나 행 옆의 #은 해당 위치로 바로 연결되는 링크입니다.
- 아래로 스크롤하면 macOS와 Windows/Linux 열이 있고 별도 검색이 되는 키보드 단축키가 나옵니다.
- "인쇄 / PDF로 저장"을 누르면 2단 인쇄물로 출력됩니다.
자주 묻는 질문
가장 유용한 Claude Code 슬래시 명령어는 무엇인가요?
/init은 프로젝트용 CLAUDE.md를 만들고, /clear는 새로 시작하고, /compact는 긴 대화를 요약해 컨텍스트를 확보하고, /context는 컨텍스트 창을 무엇이 쓰고 있는지 보여 줍니다. /model은 모델을 바꾸고, /resume은 이전 대화를 다시 열고, /rewind는 코드와 대화를 체크포인트로 되돌리고, /permissions는 어떤 도구를 묻지 않고 실행할지 관리합니다. /mcp, /memory, /usage는 서버, CLAUDE.md 파일, 비용을 다룹니다.
/clear와 /compact의 차이는 무엇인가요?
/clear는 컨텍스트가 빈 새 대화를 시작합니다. 이전 대화는 남아 있어 /resume으로 다시 열 수 있습니다. /compact는 같은 대화를 유지하되 기록을 요약으로 바꾸므로, Claude가 하던 일을 기억하면서 컨텍스트는 덜 씁니다. /compact에 요약에서 무엇에 집중할지 같은 지시를 함께 넘길 수 있습니다.
Claude Code 프롬프트에서 줄바꿈은 어떻게 하나요?
백슬래시를 입력하고 Enter를 누르세요. 모든 터미널에서 작동합니다. Ctrl+J도 어디서나 됩니다. Shift+Enter는 iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple 터미널, Windows Terminal에서 기본으로 작동하며, VS Code, Cursor, Alacritty, Zed에는 /terminal-setup을 실행해 추가할 수 있습니다. macOS에서는 Option을 Meta로 쓰도록 설정하면 Option+Enter도 됩니다.
이전 Claude Code 세션을 이어 가거나 재개하려면 어떻게 하나요?
claude -c(또는 --continue)를 실행하면 현재 디렉터리의 가장 최근 대화가 다시 열리고, claude -r에 세션 ID나 이름을 주면 특정 세션을 재개합니다. 세션 안에서는 /resume으로 선택 창을 엽니다. 나중에 찾기 쉽도록 claude -n이나 /rename으로 세션에 이름을 붙이세요.
CLAUDE.md와 settings.json은 어디에 두나요?
모든 프로젝트에 적용할 개인 지침은 ~/.claude/CLAUDE.md에, 팀과 공유하는 프로젝트 지침은 ./CLAUDE.md나 ./.claude/CLAUDE.md에, 비공개 프로젝트 메모는 ./CLAUDE.local.md에 둡니다. 설정도 같은 방식입니다. 본인용은 ~/.claude/settings.json, 팀용은 .claude/settings.json, 비공개 재정의는 .claude/settings.local.json입니다. 조직의 관리형 설정은 이 모두보다 우선합니다.
Claude Code가 매번 권한을 묻지 않게 하려면 어떻게 하나요?
Shift+Tab을 눌러 권한 모드를 순환하세요. acceptEdits는 Claude가 묻지 않고 파일을 편집하게 하고, auto는 백그라운드 안전 검사와 함께 모든 것을 실행합니다. /permissions나 --allowedTools로 Bash(git diff *) 같은 특정 도구를 미리 승인할 수 있습니다. --dangerously-skip-permissions(bypassPermissions 모드)는 모든 검사를 끄며, 격리된 컨테이너나 VM에서만 쓰도록 만든 것입니다.
프린트 모드: 스크립트와 CI에서 Claude Code 쓰기
claude -p "prompt"는 대화형 인터페이스 없이 작업 하나를 실행하고 답을 출력합니다. 셸 스크립트, git 훅, CI에서 필요한 방식입니다. 입력을 파이프로 넘길 수 있고(cat error.log | claude -p "explain this"), 이 모드에서만 의미 있는 플래그와 함께 쓸 수 있습니다.
• 기계가 읽을 수 있는 출력에는 --output-format json 또는 stream-json, 검증된 구조화 출력에는 --json-schema
• --max-turns와 --max-budget-usd로 실행 시간과 비용 상한 설정
• --allowedTools / --disallowedTools 또는 --permission-mode dontAsk로 아무도 답하지 않을 확인 요청에서 멈추지 않게 하기
• --bare로 훅, 플러그인, MCP 서버, CLAUDE.md 로딩을 건너뛰어 더 빠르고 예측 가능하게 실행
• -c 또는 --resume으로 이전 프린트 모드 대화 이어 가기
1분 만에 알아보는 훅
훅은 Claude Code가 정해진 시점에 실행하는 명령입니다. 도구 호출 전의 PreToolUse, 호출 후의 PostToolUse, Claude가 작업을 마쳤을 때의 Stop, 사용자가 필요할 때의 Notification, 세션이 시작될 때의 SessionStart 등 모두 약 30개의 이벤트가 있습니다(위에 정리됨). 훅은 설정 파일의 "hooks" 키 아래에 이벤트별로 묶여 있으며, "Bash"나 "Edit|Write" 같은 matcher를 선택적으로 지정할 수 있습니다.
Edit에 포매터를 실행하는 PostToolUse 훅을 걸면 Claude가 건드리는 모든 파일이 포맷된 상태로 유지됩니다. Bash에 건 PreToolUse 훅은 명령을 검사하고 종료 코드 2로 끝내 차단할 수 있으며, 스크립트가 stderr에 출력한 내용이 Claude에게 이유로 표시됩니다. 어떤 훅이 활성 상태인지는 /hooks로 확인하세요.
이 시트를 최신 상태로 유지하는 방법
Claude Code의 명령어 구성은 빠르게 바뀝니다. /vim, /pr-comments, /ultraplan은 모두 최근 버전에서 제거되었고, 거의 매주 새 명령어가 추가됩니다. 여기 있는 모든 항목은 상단에 표시된 날짜의 공식 문서에서 가져와 쉬운 말로 요약했으며, 페이지에서 각 출처 표로 연결됩니다.
여기 있는 명령어가 세션에 없다면 claude -v로 버전을 확인하고 claude update로 업데이트하세요. 목록에 없는 명령어가 있다면 마지막 확인 이후에 추가되었거나, 사용자 환경에만 있는 스킬, 플러그인, MCP 명령어일 가능성이 높습니다. /help와 / 메뉴에는 항상 설치된 버전이 지원하는 기능이 표시됩니다.
관련 무료 도구
- MCP 설정 생성기 — MCP 서버를 한 번만 정의하면 Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex용 정확한 설정 파일이나 명령어를 얻을 수 있습니다.
- 토큰 계산기 — OpenAI 모델의 토큰은 정확하게 세고 Claude, Gemini, Llama는 추정하며, 비용을 확인하고 텍스트가 토큰으로 나뉘는 모습을 보세요.
- LLM API 비용 계산기 — 캐싱, 배치 할인, 긴 컨텍스트 요금 구간, 추론 토큰까지 반영해 40개 이상 모델의 작업 비용을 비교하세요. 모든 요금에 출처와 확인 날짜가 표시됩니다.
- VS Code 단축키 — Windows와 Mac의 Visual Studio Code 기본 단축키 전체와 Linux 차이점: 다중 커서, 검색, 리팩터링, 터미널.
- Git 치트 시트 — 마지막 커밋 취소, 브랜치 이름 변경, 원격 브랜치 삭제처럼 하려는 작업별로 정리한 Git 명령어. 최신 switch/restore와 기존 명령어, 위험 배지까지 함께 보여 줍니다.