Claude Code referenceofficial docs checked 2026-05-15 · updated 2026-05-15
// Claude Code

Claude Code Cheat Sheet

Claude Code에서 자주 쓰는 명령어, 워크플로, 단축키를 코드와 설명 쌍으로 정리한 실무 레퍼런스입니다. 항목은 빠르게 훑되, 실제로 언제 쓰는지 알 수 있도록 설명을 붙였습니다.

이제 막 Claude Code를 설치한 분, 또는 누군가에게 "Claude Code가 뭐냐"고 설명해야 하는 분을 위한 사전입니다. 전체를 외울 필요 없이, 헷갈리는 명령어만 검색해서 한글 설명과 예시를 빠르게 확인하세요. hplan이 실전 워크플로 세트라면, 이 페이지는 그 위에서 쓰는 Claude Code 명령어·개념 사전입니다.

CommandsWorkflowsShortcutsMCPMemorySkills & AgentsCLI & Flags최신 점검: 2026-05-15
CommandsWorkflowsShortcutsCoverageSources
Commands

Commands

Slash command, CLI command, MCP command를 실행 맥락과 함께 정리했습니다. 처음 쓰는 분은 /clear, /compact, /diff, /plan 네 가지만 익혀도 일상 작업의 80%는 해결됩니다.

Session / Daily Commands

Session

  • /clear현재 대화 컨텍스트를 비우고 새 작업을 시작합니다. 이전 맥락이 방해될 때 사용합니다.
  • /compact [focus]긴 대화를 요약해 컨텍스트를 줄입니다. focus를 붙이면 특정 목표 중심으로 압축합니다.
  • /branch [name]현재 대화에서 새 브랜치를 만들어 다른 방향으로 실험합니다. /fork 별칭으로도 사용합니다.
  • /usage토큰, 비용, prompt cache 사용량을 확인합니다. 긴 작업 전후 비용 점검에 씁니다.
  • /context컨텍스트 사용량과 대화가 차지하는 비중을 확인합니다. 불필요한 맥락을 찾을 때 유용합니다.
  • /diffCodex/Claude가 만든 변경사항을 diff 형태로 봅니다. 적용 전 리뷰 루틴의 핵심입니다.
  • /copy [N]마지막 응답 또는 N번째 응답을 클립보드로 복사합니다. 산출물 전달 전에 사용합니다.
  • /recap이전 세션으로 복귀했을 때 현재 상태와 다음 행동을 요약합니다.
  • /undo최근 대화 또는 코드 변경 체크포인트를 되돌립니다.
  • /rewind더 넓은 범위의 대화/코드 체크포인트로 되돌립니다. 실험 실패 시 사용합니다.
  • /export대화 내용을 외부 공유나 기록용으로 내보냅니다.
  • /plan [desc]수정 전 계획 모드로 들어갑니다. 코드 변경 전에 설계를 검토할 때 사용합니다. 쉽게 말하면 "일단 무엇을 할지만 보여줘, 아직 손대지는 마" 모드입니다.
  • /resume [session]ID나 이름으로 이전 세션을 이어서 엽니다.
  • /focus집중 보기 또는 fullscreen focus view를 전환합니다. 긴 출력 검토에 적합합니다.
  • /goal [desc]세션의 완료 목표를 명시합니다. 장기 작업에서 방향을 잃지 않게 합니다.

Config

  • /config [key value]설정 값을 조회하거나 수정합니다. 사용자/프로젝트 설정을 빠르게 조정할 때 사용합니다.
  • /model [model]현재 세션 모델을 변경합니다. 비용, 속도, 품질 요구에 맞춰 전환합니다.
  • /fast [on|off]빠른 추론 모드를 켜거나 끕니다. 단순 작업에서 속도를 우선할 때 사용합니다.
  • /theme [name]터미널 테마를 전환하거나 커스텀 테마를 적용합니다.
  • /permissions허용/차단된 도구 실행 규칙을 확인하고 수정합니다.
  • /effort [level]추론 강도를 low, medium, high, xhigh, max 등으로 조절합니다.
  • /color [color]프롬프트 바 색상을 바꿔 프로젝트나 환경을 구분합니다.
  • /keybindings키바인딩 설정을 확인합니다. 터미널 환경별 충돌을 점검할 때 사용합니다.
  • /scroll-speed [speed]출력 스크롤 속도를 조절합니다. 긴 응답을 읽기 쉽게 맞춥니다.
  • /terminal-setup터미널에서 필요한 키 입력 설정을 안내합니다. Option/Alt 문제 점검에 유용합니다.

Special

  • /btw 현재 주 컨텍스트에 넣지 않고 사이드 질문을 합니다. 본 작업 맥락 오염을 줄입니다.
  • /extra-usagerate limit 또는 추가 사용량 관련 상태를 확인합니다.
  • /voice음성 dictation 모드를 켭니다. 긴 요구사항을 말로 입력할 때 사용합니다.
  • /doctor설치, 인증, 터미널 환경 문제를 진단합니다.
  • /insights세션 리포트와 사용 패턴을 확인합니다.
  • /desktopDesktop app에서 이어서 작업합니다.
  • /rename [name]현재 세션 이름을 바꿉니다. 나중에 resume하기 쉽게 정리합니다.
  • /help사용 가능한 명령과 도움말을 엽니다.
  • /feedback / /bug피드백이나 버그 리포트를 보냅니다.

Project / Advanced Commands

Tools

  • /init프로젝트용 CLAUDE.md를 생성합니다. 빌드 명령, 규칙, 작업 방식을 기록하는 시작점입니다.
  • /memoryCLAUDE.md, auto memory, user/project/local memory 항목을 관리합니다.
  • /mcpMCP 서버 연결 상태를 보고 서버를 추가/수정/삭제합니다. 쉽게 말하면 MCP는 "Claude가 외부 도구(파일·DB·SaaS)에 접속하는 표준 플러그인 규격"입니다.
  • /hooks도구 실행 전후 hook을 관리합니다. 자동 검증이나 승인 흐름에 사용합니다. 쉽게 말하면 "이 명령 실행 직전·직후에 내 스크립트를 자동으로 끼워라"라는 자동 트리거입니다.
  • /skills설치된 skill을 확인합니다. 반복 지침을 기능 단위로 재사용할 때 사용합니다. 쉽게 말하면 skill은 "내가 자주 시키는 작업 묶음을 슬래시 한 번으로 호출하는 단축키"입니다.
  • /agentssubagent 설정을 관리합니다. 역할 분리와 병렬 작업에 사용합니다. 쉽게 말하면 subagent는 "본 세션과 분리된 작은 Claude 인스턴스"로, 탐색·구현·리뷰 같은 역할을 따로 맡길 때 씁니다.
  • /review [PR]로컬 또는 PR 변경사항을 리뷰합니다. 코드 품질/버그 점검에 사용합니다.
  • /ultrareview [PR#]여러 에이전트를 병렬로 사용해 PR을 더 깊게 검토합니다.
  • /security-reviewdiff에서 보안 취약점과 위험한 변경을 점검합니다.
  • /loop [interval] [prompt]정해진 간격으로 반복 작업을 실행합니다. /proactive 별칭으로도 사용합니다.
  • /ideIDE integration 상태를 확인합니다.
  • /add-dir 현재 세션에서 접근할 추가 작업 디렉터리를 등록합니다.

MCP

  • --transport http원격 HTTP MCP 서버를 등록합니다. 팀 공유와 배포형 도구에 적합합니다.
  • --transport stdio로컬 프로세스 기반 MCP 서버를 등록합니다. 파일/CLI 연동에 단순합니다.
  • --transport sse원격 SSE MCP 서버를 등록합니다. 이벤트 스트림이 필요한 서버에 사용합니다.
  • Local: ~/.claude.json개인 로컬 환경에만 적용되는 MCP 설정 범위입니다.
  • Project: .mcp.json프로젝트에 공유되는 MCP 설정입니다. secret은 직접 저장하지 않습니다.
  • User: ~/.claude.json사용자 전역 MCP 서버를 관리하는 위치입니다.
  • claude mcp list현재 등록된 MCP 서버 목록과 상태를 확인합니다.
  • alwaysLoad: true모든 세션에서 MCP 서버를 자동으로 연결하도록 유지합니다.
  • maxResultSizeCharsMCP tool 결과 최대 크기를 제한합니다. 과도한 컨텍스트 유입을 막습니다.

CLI Core

  • claude대화형 Claude Code 세션을 시작합니다.
  • claude "question"질문을 인자로 넘겨 바로 세션을 시작합니다.
  • claude -p "query"headless/print 모드로 결과만 출력합니다. 자동화와 CI에 적합합니다.
  • claude -c최근 세션을 이어서 엽니다.
  • claude -r "name"이름 또는 ID로 특정 세션을 재개합니다.
  • claude updateClaude Code CLI를 업데이트합니다.
  • claude auth login인증을 설정하거나 다시 로그인합니다.
  • claude agentsagent 설정과 실행 상태를 관리합니다.
  • claude mcpMCP 서버를 CLI에서 관리합니다.
  • claude pluginplugin 설치와 관리를 수행합니다.
  • claude plugin prune사용하지 않는 plugin 캐시를 정리합니다.
  • claude project purge [path]특정 프로젝트 상태/캐시를 정리합니다. 주의해서 사용해야 합니다.
  • claude ultrareview [target]대상 변경사항을 더 강한 리뷰 모드로 점검합니다.

Key Flags

  • --model실행할 모델을 명시합니다.
  • -n / --name세션 이름을 지정합니다.
  • --resume / -r기존 세션을 재개합니다.
  • --continue / -c최근 세션을 이어갑니다.
  • --add-dir추가 디렉터리를 작업 범위에 포함합니다.
  • --agent특정 agent를 지정해 실행합니다.
  • --allowedTools허용할 도구 목록을 제한합니다.
  • --disallowedTools차단할 도구 목록을 지정합니다.
  • --output-format text/json/stream-json출력 포맷을 자동화 용도에 맞게 바꿉니다.
  • --max-budget-usd세션 비용 상한을 지정합니다.
  • --remote웹 세션과 연결된 원격 실행을 사용합니다.
  • --effort low/medium/high/xhigh/max추론 강도를 CLI에서 지정합니다.
  • --permission-mode default/acceptEdits/plan/auto/dontAsk/bypassPermissions도구 승인 방식을 세션 시작 시 지정합니다.
  • --dangerously-skip-permissions권한 확인을 우회합니다. 위험도가 높아 격리 환경에서만 사용해야 합니다.
  • --debug [filter]디버그 로그를 출력합니다. 설치/도구 문제 추적에 사용합니다.
  • --settings 특정 설정 파일을 지정합니다.
  • --from-prPR 컨텍스트에서 실행합니다.
Workflows

Workflows

개인 개발 루틴과 팀/자동화 루틴을 나눠, 명령어를 실제 작업 흐름으로 연결했습니다. 라이트 타겟이 가장 자주 하는 실수는 /init 없이 바로 작업을 시작하는 것 — CLAUDE.md가 없으면 Claude는 매번 처음부터 추측합니다.

Personal / Project Routine

First session

  • /init → CLAUDE.md프로젝트 규칙, 빌드 명령, 테스트 명령을 먼저 문서화합니다.
  • /memory팀 규칙과 개인 메모를 분리해 장기 컨텍스트 품질을 유지합니다.
  • /mcp파일, DB, 브라우저, SaaS 도구를 연결하기 전 권한 범위를 확인합니다.
  • /agents리뷰어, 리서처, 구현자 등 역할별 agent를 분리합니다.
  • /permissions쓰기, 삭제, 외부 전송 같은 위험 행동을 승인 규칙으로 통제합니다.

Plan & edit

  • Shift Tabdefault, acceptEdits, plan 등 permission mode를 빠르게 순환합니다.
  • --permission-mode plan읽기와 계획만 허용한 상태로 시작합니다. 큰 변경 전에 사용합니다.
  • /plan [desc]작업 계획을 먼저 만들고 사용자가 확인한 뒤 구현으로 넘어갑니다.
  • /diff변경 파일을 확인해 의도와 다른 수정이 섞였는지 점검합니다.
  • /review / /security-review병합 전 기능/보안 리스크를 점검합니다.

Context management

  • /context컨텍스트 사용량과 큰 파일/긴 대화가 차지하는 비중을 확인합니다.
  • /compact [focus]작업 목표 중심으로 대화를 압축해 장기 세션을 유지합니다.
  • 1M context대형 컨텍스트가 필요한 경우에도 주기적으로 요약과 정리를 병행합니다.
  • /btw주 작업과 무관한 질문을 컨텍스트에 섞지 않고 처리합니다.
  • /recap중단 후 복귀할 때 현재 상태와 다음 행동을 빠르게 복원합니다.

Memory & files

  • ./CLAUDE.md프로젝트 공통 규칙과 명령을 저장합니다. 팀에 공유되는 기준 문서입니다.
  • ./.claude/CLAUDE.md프로젝트 내부의 세부 규칙을 저장합니다.
  • ./CLAUDE.local.md개인 로컬 메모를 저장합니다. gitignore 대상으로 두는 것이 안전합니다.
  • ~/.claude/CLAUDE.md모든 프로젝트에 적용되는 개인 기본 규칙입니다.
  • /etc/claude-code/CLAUDE.md조직 관리형 정책이나 Linux/WSL 공통 규칙에 사용합니다.
  • .claude/rules/*.md프로젝트 단위의 여러 규칙 파일을 분리해 관리합니다.
  • ~/.claude/rules/*.md사용자 전역 규칙을 파일별로 나눠 관리합니다.
  • paths: frontmatter특정 경로에만 규칙을 적용합니다.
  • @path/to/fileCLAUDE.md 내부에서 다른 파일을 import합니다.
  • MEMORY.md auto-load첫 25KB 또는 200 lines를 자동 로드하는 memory 파일 패턴입니다.

Team / Automation Routine

Parallel work

  • --worktree name기능별 git worktree를 만들어 병렬 작업을 격리합니다.
  • isolation: worktreeagent 작업을 별도 worktree에서 실행해 충돌을 줄입니다. 쉽게 말하면 agent team을 돌릴 때 "각자 다른 작업 폴더에서 따로 일하게 격리"하는 옵션으로, 같은 파일을 동시에 건드려 충돌이 나는 사고를 막아줍니다.
  • sparsePathsagent가 필요한 경로만 보도록 범위를 제한합니다.
  • workspace.git_worktreestatus line JSON에서 worktree 상태를 표시합니다.
  • /batch여러 worktree와 agent를 사용해 병렬 작업을 구성합니다.
  • claude agents --cwdagent 실행 디렉터리를 명시합니다.

Thinking & permission

  • Alt Tthinking mode를 전환합니다. 복잡한 설계나 디버깅에서 사용합니다.
  • ultrathink한 턴에서 최대 사고 예산을 유도하는 프롬프트 표현입니다.
  • Ctrl Overbose view에서 thinking/transcript를 확인하는 데 사용합니다.
  • /effort추론 강도를 세션 중 조절합니다.
  • Retry denied with R차단된 권한 요청을 검토 후 재시도합니다.
  • acceptEdits편집은 허용하되 위험 도구는 계속 통제하는 모드입니다.
  • plan읽기/계획 중심으로 제한해 안전하게 설계합니다.
  • bypassPermissions권한 확인을 우회합니다. 격리된 환경이 아니면 피해야 합니다.

Headless / remote

  • claude -p "query"터미널 자동화에서 응답만 받아옵니다.
  • --output-format json스크립트에서 파싱 가능한 구조로 출력합니다.
  • --max-budget-usd 5자동 실행 비용 상한을 설정합니다.
  • cat file | claude -p파일 내용을 stdin으로 넘겨 일회성 분석을 수행합니다.
  • /loop 5m msg5분마다 같은 작업을 반복합니다.
  • --remote웹 세션과 연결해 원격 실행 흐름을 사용합니다.
  • /voice + Space hold음성 입력으로 긴 요구사항을 빠르게 넣습니다.

Config & env

  • ~/.claude/settings.json사용자 전역 설정 파일입니다.
  • .claude/settings.json프로젝트에 공유되는 설정 파일입니다.
  • .claude/settings.local.json로컬 전용 설정입니다. secret이나 개인 선호를 넣습니다.
  • ~/.claude.jsonOAuth, MCP, 상태 정보가 저장되는 파일입니다.
  • .mcp.json프로젝트 MCP 서버 정의 파일입니다.
  • managed-settings.d/조직 관리형 설정 조각을 두는 위치입니다.
  • modelOverrides모델 picker에 custom model ID를 노출합니다.
  • autoMode.hard_denyauto mode에서도 절대 허용하지 않을 동작을 지정합니다.
  • hooks: if / defer / mcp_tool조건부 hook, headless pause/resume, MCP tool hook을 구성합니다.
  • disableSkillShellExecskill 내부 shell 실행을 차단합니다.
  • refreshIntervalstatus line 재실행 주기를 설정합니다.
  • ANTHROPIC_API_KEYAPI key를 환경변수로 제공합니다.
  • ANTHROPIC_MODEL기본 모델을 지정합니다.
  • ANTHROPIC_BASE_URLproxy 또는 gateway endpoint를 지정합니다.
  • ANTHROPIC_BETAS추가 beta header를 설정합니다.
  • ANTHROPIC_CUSTOM_MODEL_OPTIONcustom /model 항목을 추가합니다.
  • MAX_THINKING_TOKENSthinking token 상한을 지정합니다. 0은 thinking off입니다.
  • ENABLE_PROMPT_CACHING_1H1시간 prompt cache를 opt-in합니다.
  • FORCE_PROMPT_CACHING_5M5분 prompt cache를 강제합니다.
  • CLAUDE_CODE_ENABLE_AWAY_SUMMARYtelemetry off 상태에서도 recap을 강제합니다.
  • CLAUDECODEClaude Code shell 환경임을 감지하는 변수입니다.
  • CLAUDE_CODE_DISABLE_CRONscheduled tasks를 비활성화합니다.
  • CLAUDE_CODE_FORK_SUBAGENTsubagent fork 동작을 제어합니다.
  • DISABLE_UPDATES자동 업데이트 확인을 끕니다.
  • API_TIMEOUT_MSAPI 요청 timeout을 조정합니다.
  • MCP_TIMEOUTMCP server timeout을 조정합니다.
  • CLAUDE_CODE_SESSION_ID현재 세션 식별자를 제공합니다.
  • CLAUDE_CODE_DISABLE_ALTERNATE_SCREENalternate screen 사용을 비활성화합니다.
  • CLAUDE_CODE_DISABLE_AUTO_MEMORYauto memory 로드를 비활성화합니다.
  • CLAUDE_CODE_DISABLE_1M_CONTEXT1M context 사용을 비활성화합니다.
  • CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEpackage manager auto update 동작을 제어합니다.
  • CLAUDE_CODE_CERT_STORE인증서 저장소를 지정합니다.
Shortcuts

Shortcuts

키보드 단축키, prefix, skill/agent 구성을 코드와 설명 쌍으로 정리했습니다. Shift+Tab으로 plan ↔ acceptEdits 모드를 오가는 감각만 익혀도 "Claude가 멋대로 코드를 바꿔놨다"는 사고는 거의 사라집니다.

Core / Input Shortcuts

General controls

  • Ctrl C입력 중인 프롬프트나 생성 중인 응답을 취소합니다.
  • Ctrl D빈 입력줄에서 세션을 종료합니다.
  • Ctrl L화면을 redraw하고 입력 상태를 정리합니다.
  • Ctrl Otranscript viewer 또는 focus view를 전환합니다.
  • Ctrl U현재 입력 버퍼를 삭제합니다.
  • Ctrl Y삭제한 입력 버퍼를 복원합니다.
  • Ctrl G외부 에디터에서 긴 프롬프트를 편집합니다.
  • Ctrl R이전 프롬프트 히스토리를 역검색합니다.
  • Esc Esc최근 대화나 코드 체크포인트로 되돌리거나 요약 흐름을 엽니다.

Mode & input

  • Shift Tabpermission mode를 순환합니다. plan, acceptEdits 등으로 빠르게 전환합니다.
  • \ Enter프롬프트를 전송하지 않고 줄바꿈을 입력합니다.
  • vVim visual mode로 선택을 시작합니다.
  • VVim visual-line mode로 줄 단위 선택을 시작합니다.
  • /slash command 입력을 시작합니다. 쉽게 말하면 슬래시 command는 "자연어 대신 정해진 키워드로 Claude 기능을 부르는 호출 통로"입니다.
  • !셸 명령을 직접 입력합니다.
  • @파일이나 디렉터리를 mention하고 자동완성합니다.

Background tasks

  • Ctrl X Ctrl K모든 background agent를 종료합니다. 실수 방지를 위해 두 번 누릅니다.
  • Ctrl B현재 실행 중인 background task를 확인합니다.
  • Ctrl Ttask list 표시를 전환합니다.
  • /tasks / /bashesbackground task와 bash 작업을 관리합니다.
  • /background / /bg현재 세션을 background로 분리합니다.
  • /stopattached background session을 중지합니다.

Mac / Skills / Agents

Mac Option keys

  • Option as MetaMac 터미널에서 Option 키를 Meta로 보내도록 설정해야 일부 단축키가 동작합니다.
  • ⌥P모델 전환 UI를 엽니다.
  • ⌥Textended thinking을 켜거나 끕니다.
  • ⌥Ofast mode를 켜거나 끕니다.

Skills

  • Built-in Skill tool명령과 작업 설명을 기반으로 적절한 skill을 발견합니다.
  • /simplify3개의 병렬 agent로 코드 리뷰를 수행하는 skill 흐름입니다.
  • /batch5-30개 worktree를 활용하는 batch 작업 흐름입니다.
  • /debug [desc]debug log 기반 문제 분석을 수행합니다.
  • /loop [interval]반복 scheduled task를 구성합니다.
  • /claude-apiClaude API와 SDK reference를 확인합니다.
  • .claude/skills//프로젝트 범위 skill 위치입니다.
  • ~/.claude/skills//사용자 전역 skill 위치입니다.
  • descriptionskill이 언제 트리거되는지 설명하는 frontmatter입니다.
  • allowed-toolsskill이 사용할 수 있는 도구를 제한합니다.
  • modelskill 실행에 사용할 모델을 지정합니다.
  • effortskill 실행 추론 강도를 지정합니다.
  • paths: [globs]특정 파일 경로에서만 skill이 적용되도록 제한합니다.
  • context: forkskill 실행 컨텍스트를 분리합니다.
  • $ARGUMENTS사용자 입력 인자를 skill 내부에서 참조합니다.
  • ${CLAUDE_SKILL_DIR}현재 skill 디렉터리 경로를 참조합니다.
  • ${CLAUDE_EFFORT}현재 추론 강도를 참조합니다.
  • !`cmd` dynamic context명령 실행 결과를 동적 컨텍스트로 삽입합니다.
  • plugin bin/plugin에서 실행 가능한 helper command를 둡니다.

Agents

  • Explore빠른 read-only 탐색에 적합한 agent 유형입니다.
  • PlanPlan mode에서 조사와 계획 수립을 담당하는 agent 유형입니다.
  • General전체 도구 사용이 가능한 일반 작업 agent입니다.
  • Bash터미널 작업을 별도 컨텍스트에서 수행하는 agent입니다.
  • permissionModeagent 실행 시 적용할 권한 모드를 지정합니다.
  • isolation: worktreeagent별 작업 디렉터리를 분리합니다.
  • memory: user|project|localagent가 참조할 memory 범위를 지정합니다.
  • background: trueagent를 background 작업으로 실행합니다.
  • maxTurnsagent가 사용할 최대 turn 수를 제한합니다.
  • initialPromptagent 시작 프롬프트를 지정합니다.
  • SendMessage실행 중인 agent에 추가 메시지를 보내 재개합니다.
  • @agent-name대화에서 특정 agent를 mention합니다.
Coverage / Omitted Items

요청된 항목 카테고리는 의도적으로 제외하지 않았습니다.

Recent Changes, Keyboard Shortcuts, MCP Servers, Slash Commands, Memory & Files, Workflows & Tips, Config & Env, Skills & Agents, CLI & Flags, Permission Modes, More Env Vars를 모두 Commands, Workflows, Shortcuts 안에 재배치했습니다.

공식 Claude Code 문서에는 추가 명령과 세부 옵션이 더 있습니다. 이 페이지는 실무에서 찾기 쉬운 code-to-description 형태를 우선합니다.

Sources

출처

Claude Code 공식 문서 기준으로 명령어, CLI, MCP, Memory 항목을 확인했습니다.

Next Reference

LangGraph Cheat Sheet도 같은 읽기 구조로 연결됩니다.

Claude Code는 실행 인터페이스, LangGraph는 에이전트 상태와 복구 흐름을 설계하는 프레임워크로 분리해서 읽으면 좋습니다.