📘 github.com/claude-code-expert — 클로드 코드 마스터 (한빛미디어 서적 공식 리포지토리) | 🍺 www.brewnet.dev — 셀프 호스팅 홈서버 자동 구축 오픈소스

Claude Code Cheat Sheet

⚡ 공식 Changelog 대조 검증 완료 · 한국어 설명 포함 · April 2026
v2.1.91
한국어 설명 켜기/끄기
🔍 검증 결과 ✅ 확인됨 — 공식 changelog 일치 항목 ⚠️ 미확인 — v2.1.91 NEW 항목 (공홈 미반영) ❌ 주의 — 오류 가능성 항목 출처: github.com/anthropics/claude-code CHANGELOG.md · code.claude.com/docs/en/changelog
⌨️ Keyboard Shortcuts
General Controls
CtrlC
Cancel input/generation
입력 또는 생성 취소
CtrlD
Exit session
세션 종료
CtrlL
Clear screen
화면 지우기
CtrlO
Toggle verbose/transcript
상세 모드 / 대화 기록 토글
CtrlR
Reverse search history
히스토리 역방향 검색
CtrlG
Open prompt in editor
외부 에디터로 프롬프트 열기
CtrlB
Background running task
현재 작업을 백그라운드로 전환
CtrlT
Toggle task list
작업 목록 토글
CtrlV
Paste image ([Image #N] chip)
이미지 붙여넣기 (위치 칩 삽입)
CtrlXCtrlK
Kill background agents
백그라운드 에이전트 전체 종료 (v2.1.83 Ctrl+F에서 변경)
EscEsc
Rewind or summarize
대화 되감기 또는 요약
Mode Switching
ShiftTab
Cycle permission modes
권한 모드 순환 (Normal → Auto → Plan)
AltP
Switch model
모델 전환
AltT
Toggle thinking
사고(thinking) 모드 토글
AltO
Toggle fast mode NEW
빠른 모드 토글 v2.1.91 미확인
Input / Prefixes
\Enter
Newline
줄바꿈 입력
/
Slash command
슬래시 명령어 입력
!
Direct bash
직접 bash 명령 실행
@
File mention + autocomplete
파일 멘션 및 자동완성
🔌 MCP Servers
Transport
--transport http
Remote HTTP (recommended)
원격 HTTP 방식 (권장)
--transport stdio
Local process
로컬 프로세스 방식
--transport sse
Remote SSE
원격 SSE 방식
Scopes
Local
~/.claude.json (you only)
개인 전용 설정
Project
.mcp.json (shared/VCS)
프로젝트 공유 (버전 관리 포함)
Manage
/mcp
Interactive UI
MCP 서버 대화형 관리 UI
claude mcp list
List all servers
등록된 MCP 서버 목록 출력
claude mcp serve
CC as MCP server
Claude Code 자체를 MCP 서버로 실행
2KB cap
Tool desc + server instructions limit
툴 설명·서버 지시문 최대 2KB 제한 (v2.1.84)
maxResultSizeChars
_meta annotation override (up to 500K) NEW
결과 크기 상한 재정의 최대 500K v2.1.91 미확인
⚡ Slash Commands
Session
/clear
Clear conversation
대화 내용 초기화
/compact [focus]
Compact context
컨텍스트 압축 (포커스 키워드 지정 가능)
/resume
Resume/switch session
이전 세션 재개 또는 전환
/rename [name]
Name current session
현재 세션 이름 지정
/branch [name]
Branch conversation
대화 분기 생성 주의: /fork alias 여부 미검증
/cost
Token usage stats
토큰 사용량 통계
/context
Visualize context (grid)
컨텍스트 사용량 시각화
/diff
Interactive diff viewer
대화형 변경사항 비교기
/rewind
Rewind conv / code checkpoint
대화 되감기 / 코드 체크포인트 복원
Config
/config
Open settings
설정 열기
/model [model]
Switch model
모델 전환 (←→ 으로 effort 조정)
/effort [level]
low / medium / high / max / auto
추론 강도 설정 (○낮음 · ◐중간 · ●높음 · ★최대)
/vim
Toggle vim mode
vim 키바인딩 모드 토글
/theme
Change color theme
컬러 테마 변경
/permissions
View/update permissions
권한 확인·수정 (Recent 탭에서 r로 retry)
Tools
/init
Create CLAUDE.md
프로젝트 CLAUDE.md 자동 생성
/memory
Edit CLAUDE.md files
CLAUDE.md 메모리 파일 편집
/mcp
Manage MCP servers
MCP 서버 관리
/hooks
Manage hooks
훅(Hook) 관리
/skills
List available skills
사용 가능한 스킬 목록 출력
/agents
Manage agents
에이전트 관리
Special
/powerup
Interactive feature lessons NEW
기능 인터랙티브 튜토리얼 ✅ v2.1.90 확인
/btw <q>
Side question (no context cost)
컨텍스트 소비 없는 간단 질문
/plan [desc]
Plan mode
읽기 전용 계획 수립 모드
/voice
Push-to-talk voice (20 langs)
푸시투토크 음성 입력 (20개 언어 지원)
/security-review
Security analysis of changes
변경사항 보안 분석
/pr-comments
Fetch GitHub PR comments
GitHub PR 코멘트 불러오기
📁 Memory & Files
CLAUDE.md 위치
./CLAUDE.md
Project (team-shared)
프로젝트 공유 (팀 전체 적용)
~/.claude/CLAUDE.md
Personal (all projects)
개인 전역 (모든 프로젝트 적용)
/etc/claude-code/
Managed (org-wide)
조직 관리형 (전사 적용)
Rules & Import
.claude/rules/*.md
Project rules
프로젝트 규칙 파일
~/.claude/rules/*.md
User rules
사용자 전역 규칙 파일
paths: frontmatter
Path-specific rules
특정 경로에만 적용되는 규칙
@path/to/file
Import in CLAUDE.md
CLAUDE.md 내 다른 파일 임포트
Auto Memory 상세 수치 미검증
~/.claude/projects/<proj>/memory/
MEMORY.md + topic files, auto-loaded
자동 로드되는 기억 파일 (25KB/200줄 상한은 미검증)
🧠 Workflows & Tips
Plan Mode
ShiftTab
Normal → Auto → Plan cycle
권한 모드 순환 전환
--permission-mode plan
Start in plan mode
플랜 모드로 시작 (읽기 전용)
Thinking & Effort
"ultrathink"
Max effort for this turn
해당 턴 최대 추론 강도 적용
AltT
Toggle thinking on/off
사고 모드 켜기/끄기
showThinkingSummaries
Opt-in (off by default now) ✅ v2.1.89
사고 요약 표시 (기본값 OFF로 변경됨)
Auto Mode Denied ✅ v2.1.89
/permissions → Recent
Retry denied with R key
거부된 명령을 Recent 탭에서 R 키로 재시도
Git Worktrees
--worktree name
Isolated branch per feature
기능별 독립 브랜치 워크트리 생성
isolation: worktree
Agent in own worktree
에이전트를 전용 워크트리에서 실행
sparsePaths
Checkout only needed dirs
필요한 디렉토리만 체크아웃
/batch
Auto-creates worktrees (5-30)
병렬 대규모 변경 (워크트리 자동 생성)
Context Management
/compact [focus]
Compress with focus keyword
포커스 키워드를 유지하며 컨텍스트 압축
Auto-compact
~95% capacity, thrash detection ✅ v2.1.89
95% 도달 시 자동 압축, 3회 반복 시 중단
CLAUDE.md
Survives compaction!
압축 후에도 항상 유지됨 (필수 지시문 보존)
1M context
Opus 4.6 (Max/Team/Ent)
Opus 4.6 기준 1M 토큰 (플랜 조건 별도 확인)
Session Power Moves
claude -c
Continue last conversation
마지막 대화 이어가기
claude -r "name"
Resume by name
이름으로 세션 재개
SDK / Headless
claude -p "query"
Non-interactive (headless)
비대화형 헤드리스 실행
--output-format json
Structured output
JSON 구조화 출력
--max-budget-usd 5
Cost cap
비용 상한 설정 (달러 기준)
cat file | claude -p
Pipe input
파이프로 입력 전달
⚙️ Config & Env
Config Files
~/.claude/settings.json
User settings
사용자 전역 설정
.claude/settings.json
Project (shared)
프로젝트 공유 설정
.claude/settings.local.json
Local only
로컬 전용 (VCS 제외)
managed-settings.d/
Drop-in policy fragments ✅ v2.1.83
팀별 정책 조각 파일 디렉토리
.mcp.json
Project MCP servers
프로젝트 MCP 서버 설정
Key Settings
showThinkingSummaries
Opt-in (off by default) ✅ v2.1.89
사고 요약 표시 여부 (기본 비활성화)
sandbox.failIfUnavailable
Exit if sandbox fails ✅ v2.1.83
샌드박스 불가 시 에러로 종료
hooks: if
Conditional hooks ✅ v2.1.85
조건부 훅 실행 (permission rule 문법)
hooks: "defer"
Pause headless, resume later ✅ v2.1.89
헤드리스 세션 일시중단 후 나중에 재개
PermissionDenied hook
Fires on auto mode denial ✅ v2.1.89
자동 모드 거부 시 훅 실행
disableSkillShellExec
Block !`cmd` in skills NEW
스킬/플러그인 내 쉘 실행 차단 v2.1.91 미확인
allowedChannelPlugins
Admin channel plugin allowlist ✅ v2.1.84
관리자 채널 플러그인 허용 목록
Key Env Vars
ANTHROPIC_API_KEY
API key
Anthropic API 인증 키
ANTHROPIC_MODEL
Default model override
기본 모델 재정의
CLAUDE_CODE_EFFORT_LEVEL
low/medium/high/max/auto
기본 추론 강도 설정
MAX_THINKING_TOKENS
0 = off
최대 사고 토큰 수 (0=비활성화)
CLAUDE_CODE_NO_FLICKER
Alt-screen rendering ✅ v2.1.89
깜빡임 없는 대체 화면 렌더링 (=1)
MCP_CONNECTION_NONBLOCKING
Skip MCP wait in -p ✅ v2.1.89
헤드리스 모드에서 MCP 연결 대기 스킵
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB
Strip creds from subprocesses ✅ v2.1.83
서브프로세스에서 자격증명 제거
CLAUDE_STREAM_IDLE_TIMEOUT_MS
Streaming watchdog (default 90s) ✅ v2.1.84
스트리밍 감시 타임아웃 (기본 90초)
🔧 Skills & Agents
Built-in Skills
/simplify
Code review (parallel agents) 3개 수치 미검증
코드 리뷰 (병렬 에이전트 사용)
/batch
Large parallel changes (5-30 worktrees)
대규모 병렬 변경 (워크트리 자동 분배)
/debug [desc]
Troubleshoot from debug log
디버그 로그 기반 문제 해결
/loop [interval]
Recurring scheduled task
반복 예약 작업 실행
/claude-api
Load API + SDK reference
API/SDK 레퍼런스 컨텍스트 로드
Custom Skill Locations
.claude/skills/<name>/
Project skills
프로젝트 전용 커스텀 스킬
~/.claude/skills/<name>/
Personal skills
개인 전역 커스텀 스킬
Skill Frontmatter
description
Auto-invocation trigger
자동 호출 트리거 설명
allowed-tools
Skip permission prompts
사전 허용 툴 (권한 프롬프트 스킵)
model / effort
Override model/effort for skill
스킬 단위 모델·강도 재정의
paths: [globs]
Path-specific ✅ v2.1.84
특정 경로 glob에만 적용
context: fork
Run in subagent
서브에이전트에서 독립 실행
$ARGUMENTS
User input placeholder
사용자 입력값 치환 변수
${CLAUDE_SKILL_DIR}
Skill's own directory path
스킬 자신의 디렉토리 경로
!`cmd`
Dynamic context injection
동적 컨텍스트 주입 (쉘 명령 실행)
plugin bin/
Ship executables for Bash tool NEW
Bash 툴용 실행파일 제공 v2.1.91 미확인
Built-in Agents
Explore
Fast read-only (Haiku)
빠른 읽기 전용 탐색 (Haiku 모델)
Plan
Research for plan mode
계획 수립용 리서치 에이전트
General
Full tools, complex tasks
전체 툴 사용, 복잡한 작업용
Bash
Terminal separate context
별도 컨텍스트의 터미널 에이전트
Agent Frontmatter
permissionMode
default/acceptEdits/plan/dontAsk/bypassPermissions
에이전트 권한 모드 설정
isolation: worktree
Run in git worktree
전용 git 워크트리에서 실행
background: true
Background task
백그라운드 작업으로 실행
initialPrompt
Auto-submit first turn ✅ v2.1.83
첫 턴 자동 제출 프롬프트
@agent-name
Mention named subagents ✅ v2.1.89
명명된 서브에이전트 멘션
🖥️ CLI & Flags
Core Commands
claude
Interactive mode
대화형 모드 실행
claude "query"
Start with prompt
프롬프트와 함께 시작
claude -p "query"
Headless (non-interactive)
헤드리스 단일 실행
claude -c
Continue last conversation
마지막 대화 이어가기
claude -r "name"
Resume by session name
이름으로 세션 재개
claude update
Update Claude Code
Claude Code 업데이트
Key Flags
--model
Set model
사용할 모델 지정
-w / --worktree
Git worktree
워크트리 지정
--add-dir
Add working directory
작업 디렉토리 추가
--agent
Use specific agent
특정 에이전트 사용
--allowedTools
Pre-approve tools
도구 사전 승인
--output-format
json / stream-json
출력 형식 지정
--max-turns
Limit agentic turns
에이전트 최대 턴 수 제한
--max-budget-usd
Cost cap in USD
비용 상한 (달러 기준)
--verbose
Verbose output
상세 출력 모드
--bare
Minimal headless (no hooks/LSP)
경량 헤드리스 (훅·LSP 없음)
--effort
low/medium/high/max
추론 강도 플래그
--permission-mode
plan/default/acceptEdits…
권한 모드 플래그
--dangerously-skip-permissions
Skip all prompts ⚠️
모든 권한 프롬프트 스킵 (CI용, 주의)
--remote
Web session on claude.ai
claude.ai 웹 세션 연동
PowerShell tool
Windows opt-in preview ✅ v2.1.84
Windows PowerShell 툴 (선택적 프리뷰)