Claude Code · Reference

Claude Code 치트시트

자주 쓰는 단축키·명령어·설정을 카테고리 탭으로 정리했습니다. 영어 원문 + 한국어 설명 병기이며, 공식 문서·CHANGELOG와 대조해 검증했습니다.

검증 기준: code.claude.com/docs · CHANGELOG · 2026-06

대화형(TUI) 모드 단축키. macOS는 Alt 대신 Option 키입니다.

기본 조작
CtrlC
Cancel input / generation입력·생성 취소
CtrlD
Exit session세션 종료
CtrlL
Redraw / clear screen화면 다시 그리기
CtrlO
Toggle transcript viewer대화 기록(transcript) 토글
CtrlR
Reverse history search히스토리 역방향 검색
CtrlG
Open prompt in editor외부 에디터로 프롬프트 열기 (또는 Ctrl+X Ctrl+E)
CtrlT
Toggle task list작업 목록 토글
CtrlV
Paste image이미지 붙여넣기
에이전트 / 되감기
CtrlB
Send running task to background실행 중 작업을 백그라운드로 전환
CtrlX CtrlK
Kill all background subagents백그라운드 에이전트 전체 종료 (3초 내 두 번)
EscEsc
Rewind conversation / code대화·코드 되감기(rewind)
모드 전환
ShiftTab
Cycle permission modes권한 모드 순환: default · acceptEdits · plan · auto · bypassPermissions
AltP
Switch model모델 전환
AltT
Toggle thinkingthinking(사고) 모드 토글
AltO
Toggle fast modefast 모드 토글
입력 / 접두어
\ Enter
Insert newline줄바꿈 입력
/
Slash command / skill슬래시 명령·스킬 호출
!
Run bash directlybash 명령 직접 실행
@
File mention + autocomplete파일 멘션·자동완성

입력창 맨 앞에서 / 로 호출(뒤 텍스트는 인자: <필수> · [선택]). 표시되는 명령은 플랫폼·요금제·환경에 따라 다릅니다. 출처: code.claude.com/docs/en/commands.

세션
/clear [name]
New conversation (old kept in /resume) · /reset /new새 대화 (이전은 /resume에 보존)
/compact [focus]
Summarize to free context요약해 컨텍스트 확보
/context [all]
Visualize context usage컨텍스트 사용량 시각화
/resume [session]
Resume by id/name or picker · /continue세션 재개·피커
/rename [name]
Rename current session세션 이름 변경
/branch [name]
Branch conversation (original kept)대화 분기 (원본 보존)
/fork <directive>
Background subagent inheriting the conversation대화 상속 백그라운드 서브에이전트
/rewind
Restore checkpoint · /checkpoint /undo체크포인트 되돌리기
/export · /copy [N] · /recap
Export · copy a reply · one-line recap내보내기·응답 복사·세션 요약
설정
/config
Settings UI · /settings설정 인터페이스
/model [model]
Switch model (saves default)모델 전환
/effort [level|auto]
low · medium · high · xhigh · max · ultracode추론 강도 (max·ultracode는 세션 한정)
/fast [on|off]
Toggle fast mode패스트 모드 토글
/theme · /color
Color theme · prompt-bar color테마·프롬프트 바 색상
/permissions
allow/ask/deny rules · /allowed-tools권한 규칙 관리
/statusline · /keybindings
Status line · keybindings file상태줄·단축키 구성
/terminal-setup · /tui
Terminal keys · TUI renderer (fullscreen)터미널 키·렌더러
/sandbox
Toggle sandbox mode샌드박스 토글
도구 · 메모리 · 확장
/init
Initialize CLAUDE.mdCLAUDE.md 초기화
/memory
Edit CLAUDE.md · auto-memory메모리 편집·오토메모리
/add-dir <path>
Add a working directory작업 디렉터리 추가
/agents
Manage subagents서브에이전트 관리
/mcp
MCP servers + OAuthMCP 서버·인증
/hooks
Configure hooks훅 구성
/skills
List available skills스킬 목록
/plugin [sub]
Plugins: list / install / enable플러그인 관리
/reload-skills · /reload-plugins
Rescan without restart재시작 없이 리로드
작업 · 리뷰 (스킬·워크플로)
/plan [desc]
Read-only plan mode플랜 모드
/code-review [lvl]
Bugs + cleanup; --fix --comment; ultra = cloud버그·정리 리뷰 (ultra=클라우드)
/simplify [target]
Cleanup-only review & fix정리 전용 리뷰·수정
/security-review
Security analysis of changes보안 취약점 분석
/review [PR]
Local PR reviewPR 로컬 리뷰
/ultrareview [PR]
Cloud deep review (= /code-review ultra)클라우드 심층 리뷰
/debug [desc]
Debug-log troubleshooting디버그 로그 분석
/goal [cond|clear]
Work autonomously until met목표 충족까지 진행
/loop [interval] [p]
Repeat on interval · /proactive반복 실행
/batch <instruction>
Large parallel changes (worktrees)대규모 병렬 변경
/workflows
Workflow run viewer워크플로 진행 뷰
/deep-research <q>
Fan-out research report분산 리서치 리포트
/run · /verify
Run app · verify a change앱 실행·변경 검증
/autofix-pr [p]
Auto-fix PR CI / review commentsPR CI·리뷰 자동 수정
/ultraplan <p>
Plan → browser review → remote run계획 초안·원격 실행
/claude-api
Load API / SDK referenceAPI·SDK 레퍼런스
/fewer-permission-prompts
Allowlist safe read-only calls권한 프롬프트 감소
원격 · 백그라운드 · 플랫폼
/background [p]
Detach to background agent · /bg백그라운드로 분리
/tasks · /stop
Background items (/bashes) · stop session백그라운드 항목·중지
/teleport
Web session → this terminal · /tp웹 세션을 터미널로
/remote-control · /remote-env
Web remote control (/rc) · cloud env웹 원격 제어·클라우드 환경
/schedule [desc]
Cloud routines · /routines클라우드 루틴
/web-setup
Connect GitHub to Claude Code on the web웹에 GitHub 연결
/desktop · /mobile
Continue in desktop app · mobile QR데스크톱 앱·모바일
/chrome · /voice
Claude in Chrome · voice dictationChrome 연동·음성 입력
계정 · 진단 · 기타
/login · /logout
Sign in / out로그인·로그아웃
/help · /doctor · /status
Help · diagnose · status tab도움말·진단·상태
/usage
Cost / limits / activity · /cost /stats사용량·비용·한도
/release-notes · /feedback
Changelog · feedback (/bug /share)체인지로그·피드백
/upgrade · /passes · /usage-credits
Plan upgrade · share · credits요금제·공유·크레딧
/insights · /team-onboarding
Session analytics · team guide세션 분석·팀 온보딩
/install-github-app · -slack-app
GitHub Actions · Slack integrationGitHub·Slack 통합
/setup-bedrock · /setup-vertex
Bedrock / Vertex AI setupBedrock·Vertex 설정
/btw <q>
Side question (not logged)곁다리 질문 (기록 안 남김)
/powerup · /focus · /radio
Feature demo · focus view · lo-fi radio데모·포커스·라디오
/exit
Quit CLI · /quit종료

제거됨: /pr-comments (v2.1.91 — Claude에게 직접 "PR 코멘트 보여줘") · /vim (v2.1.92 — /config → Editor mode). 본인 버전 기준은 세션에서 / 또는 /help로 확인.

터미널에서 claude 실행 시 사용하는 명령과 플래그.

기본 실행
claude
Interactive session대화형 세션 시작
claude "query"
Start with an initial prompt초기 프롬프트로 시작
claude -p "query"
Headless / print mode, then exit헤드리스 단일 실행 후 종료
cat f | claude -p
Pipe stdin into a prompt파이프 입력 처리
claude -c
Continue last conversation마지막 대화 이어가기
claude -r "name"
Resume by id/name (no arg = picker)세션 재개 (인자 없으면 선택기)
claude --version
Print version버전 출력
세션 · 원격 · 워크트리
claude --remote "task"
Create a web session on claude.aiclaude.ai 클라우드 세션 생성
claude --teleport
Pull a web session into the terminal웹 세션을 로컬 터미널로 가져오기
claude --from-pr <num>
Resume the session linked to a PRPR에 연결된 세션 재개
claude --ide
Auto-connect to an available IDE사용 가능한 IDE 자동 연결
claude -w [name]
Run in a git worktree (--worktree)git 워크트리에서 실행
백그라운드 에이전트
claude --bg "prompt"
Start a background agent (returns session id)백그라운드 에이전트 시작 (세션 ID 반환)
claude agents
Monitor / dispatch background sessions백그라운드 세션 모니터링·관리
claude attach · logs · stop <id>
Attach to / tail / stop a session세션 연결·로그·중지
유지보수 · 인증 · 플러그인
claude update
Update to latest최신 버전으로 업데이트
claude doctor
Diagnose install / setup설치·환경 진단
claude install [ver]
Install / reinstall native binary네이티브 바이너리 설치·재설치
claude setup-token
Long-lived OAuth token for CICI/스크립트용 장기 토큰 발급
claude auth login · logout · status
Sign in / out, check auth로그인·로그아웃·인증 상태
claude plugin install <name>
Plugins: list · marketplace add <src>플러그인 설치·목록·마켓플레이스
주요 플래그
--model
Set model모델 지정
--effort
low / medium / high / max추론 강도
--permission-mode
plan / default / acceptEdits …권한 모드
-w, --worktree
Run in a git worktreegit 워크트리에서 실행
--add-dir
Add working directory작업 디렉터리 추가
--agent
Dispatch to a subagent특정 에이전트로 실행
--allowedTools
Pre-approve tools도구 사전 승인
헤드리스 / 자동화
--output-format
text / json / stream-json출력 형식
--max-turns
Limit agentic turns에이전트 최대 턴 제한
--max-budget-usd
Cost cap (USD)비용 상한(달러)
--fallback-model
Auto-retry on overload과부하 시 대체 모델로 재시도
--bare
Minimal headless (no hooks/LSP)경량 헤드리스 (훅·LSP 없음)
--verbose
Verbose output상세 출력
--remote
Web session on claude.aiclaude.ai 웹 세션
--dangerously-skip-permissions
Skip all prompts — CI only모든 권한 프롬프트 스킵 (CI 전용 · 주의)

2026-06 기준 최신 라인업. 플랜별 기본값·가용성은 공식 문서에서 최종 확인하세요.

모델 라인업
Opus 4.8
Latest, most capable (default on Max/Team/Ent)최신·최고 성능 (별칭 opus)
Opus 4.7 · 4.6
Previous Opus releases이전 Opus 버전
Sonnet 4.6
Balanced (alias sonnet)균형형 (별칭 sonnet)
Haiku 4.5
Fast / light (alias haiku)빠르고 가벼움 (별칭 haiku)
1M 컨텍스트
opus[1m]
Opus 4.8 / 4.7 / 4.6 · included on Max/Team/EntMax/Team/Enterprise 포함
sonnet[1m]
Sonnet 4.6 · uses usage credits크레딧 사용
Effort 레벨 (추론 강도)
low
Fast, scoped, latency-sensitive tasks짧고 빠른 작업 (지연 최소)
medium
Lower token use, cost-sensitive토큰 절약 (비용 우선)
high
Default — balances tokens & intelligence기본값 · 균형 (일반 코딩)
xhigh
Deeper reasoning, more tool calls — Opus 4.8 / 4.7 only더 깊은 추론·반복 탐색 (Opus 4.8/4.7 전용)
max
Deepest reasoning, no token cap (session-only)최심 추론·토큰 무제한 (세션 한정, 과사고 주의)
ultracode
xhigh + auto dynamic multi-agent workflows (Claude Code only · Opus 4.8/4.7)xhigh + 동적 멀티에이전트 워크플로 자동 구성 (CC 전용·세션 한정)
auto
Reset to the model's default모델 기본값으로 초기화
Effort 설정 · 기본값
/effort [level]
Set in session (or --effort, CLAUDE_CODE_EFFORT_LEVEL)세션 설정 (CLI 플래그·환경변수도 가능)
기본값
Opus 4.8 · 4.6 · Sonnet 4.6 = high · Opus 4.7 = xhigh모델별 기본 effort
폴백
Unsupported level → highest supported below (xhigh→high on Opus 4.6 / Sonnet 4.6)미지원 레벨은 지원되는 최고치로 폴백
지속성
low–xhigh persist (settings.json); max & ultracode are session-onlylow~xhigh만 지속, max·ultracode는 세션 한정
ultrathink
One-turn keyword for deeper thinking (not an effort level)한 턴만 깊게 (effort 레벨 아님 · 프롬프트에 포함)
Fast 모드
/fast · AltO
Toggle (or fastMode: true)토글 (설정 fastMode)
지원 모델
Opus 4.8 / 4.7 / 4.6 onlyOpus 전용 (Sonnet·Haiku 제외)
동작
Same Opus model, faster output같은 Opus를 더 빠른 출력으로 (작은 모델 아님)

스킬(SKILL.md)은 재사용 가능한 절차, 에이전트(subagent)는 독립 컨텍스트 실행 단위.

내장 스킬 (명령)
/code-review · /simplify
Bug review · cleanup버그 리뷰·정리
/debug · /loop
Troubleshoot · recurring task디버깅·반복 작업
/run · /verify
Launch app · verify a change앱 실행·변경 검증
/claude-api
API / SDK referenceAPI·SDK 레퍼런스
커스텀 스킬 위치
.claude/skills/<name>/SKILL.md
Project skill프로젝트 스킬
~/.claude/skills/<name>/SKILL.md
Personal skill개인 전역 스킬
SKILL.md frontmatter / 본문
description
Auto-invocation trigger자동 호출 트리거
allowed-tools
Pre-approved tools사전 허용 도구
model · effort
Override per skill스킬 단위 모델·강도
paths: [globs]
Path-scoped activation특정 경로에만 적용
context: fork
Run in a subagent서브에이전트에서 실행
$ARGUMENTS · ${CLAUDE_SKILL_DIR}
Args · skill dir substitution인자·스킬 경로 치환
!`cmd`
Dynamic context injection동적 컨텍스트 주입(쉘 실행)
내장 에이전트
Explore
Fast read-only search (Haiku)빠른 읽기 전용 탐색
Plan
Research for plan mode계획 수립용 리서치
general-purpose
Full tools, complex tasks전체 도구·복합 작업
claude-code-guide
Answers Claude Code questionsClaude Code 질의응답
에이전트 frontmatter
permissionMode
default / acceptEdits / plan / dontAsk / bypassPermissions권한 모드
tools · model
Allowed tools · model override허용 도구·모델
isolation: worktree
Run in its own git worktree전용 워크트리에서 실행
background: true
Run as background task백그라운드 실행
memory: user|project|local
Persistent learnings across sessions세션 간 지속 메모리

CLAUDE.md는 세션 시작 시 컨텍스트에 자동 주입되는 지시 문서입니다.

CLAUDE.md 위치 (우선순위 ↑)
./CLAUDE.md
Project (team-shared, committed)프로젝트 공유 (커밋)
./CLAUDE.local.md
Project-local (gitignored)로컬 전용 (VCS 제외)
~/.claude/CLAUDE.md
Personal (all projects)개인 전역 (모든 프로젝트)
/etc/claude-code/CLAUDE.md
Managed (org-wide)조직 관리형 (전사)
규칙 · 임포트
.claude/rules/*.md
Project rules프로젝트 규칙
~/.claude/rules/*.md
User rules사용자 전역 규칙
paths: (frontmatter)
Load rule only for matching paths특정 경로에만 적용
@path/to/file
Import into CLAUDE.md (≤4 hops)CLAUDE.md 내 파일 임포트 (최대 4단계)
자동 메모리
~/.claude/projects/<proj>/memory/
MEMORY.md + topic filesMEMORY.md + 토픽 파일 저장 위치
auto-load
MEMORY.md loaded each session (~200 lines / 25KB)매 세션 자동 로드 (약 200줄·25KB)
autoMemoryEnabled
On by default; CLAUDE_CODE_DISABLE_AUTO_MEMORY to disable기본 켜짐 (환경변수로 끄기)

설정은 JSON 파일로, 동작은 환경변수로 제어합니다.

설정 파일
~/.claude/settings.json
User settings사용자 전역 설정
.claude/settings.json
Project (shared)프로젝트 공유 설정
.claude/settings.local.json
Local only (gitignored)로컬 전용 (VCS 제외)
.mcp.json
Project MCP servers프로젝트 MCP 서버
managed-settings.d/
Drop-in policy fragments (macOS/Linux)정책 조각 디렉터리
주요 설정 키
model · effortLevel
Default model / effort기본 모델·강도
permissions
Allow / deny / ask rules허용·거부·확인 규칙
env
Env vars applied to the session세션 환경변수
hooks
Event hooks; if = conditional이벤트 훅 (조건부 if 지원)
autoMemoryEnabled
Toggle auto-memory자동 메모리 토글
주요 환경변수
ANTHROPIC_API_KEY
API key (or ANTHROPIC_AUTH_TOKEN)API 인증 키
ANTHROPIC_BASE_URL
Custom endpoint / proxy커스텀 엔드포인트·프록시
ANTHROPIC_MODEL
Default model override기본 모델 재정의
CLAUDE_CODE_EFFORT_LEVEL
low/medium/high/max기본 추론 강도
MAX_THINKING_TOKENS
Thinking budget (0 = off)최대 사고 토큰 (0=끔)
MCP_TIMEOUT · MCP_TOOL_TIMEOUT
MCP connect / tool timeoutsMCP 연결·툴 타임아웃
ENABLE_TOOL_SEARCH
Defer MCP tools, search on demandMCP 툴 지연 로드·온디맨드 검색

MCP는 외부 도구 연결, 훅은 이벤트 시점의 결정론적 자동화.

MCP Transport
http
Remote streamable HTTP (recommended)원격 HTTP (권장)
stdio
Local process로컬 프로세스
sse
Deprecated — use httpdeprecated (http 사용)
ws
WebSocket (persistent)웹소켓 (지속 연결)
스코프 · 관리
Local
~/.claude.json (you only)개인 전용
Project
.mcp.json (shared via git)프로젝트 공유
/mcp
Interactive manager UI대화형 관리 UI
claude mcp add <name> …
Add server (--transport http, --header, -e)서버 추가 (전송·헤더·환경변수 옵션)
claude mcp list · get · remove
List · details · remove목록·상세·삭제
claude mcp add-json · serve
Add via JSON · run CC as an MCP serverJSON으로 추가 · CC를 MCP 서버로 실행
MCP 제한
2KB cap
Tool desc + server instructions툴 설명·서버 지시문 상한
maxResultSizeChars
_meta override (up to 500K)결과 크기 상한 재정의(≤500K)
ToolSearch
Deferred tools, searched on demand지연 로드 후 필요 시 검색
훅 이벤트
SessionStart · SessionEnd
Session lifecycle세션 시작·종료
UserPromptSubmit · Stop
Turn lifecycle프롬프트 제출·턴 종료
PreToolUse · PostToolUse
Around tool calls도구 호출 전·후
SubagentStart · SubagentStop
Subagent lifecycle서브에이전트 시작·종료
PermissionDenied
On auto-mode denial권한 거부 시
훅 종료 코드
exit 0
Success성공
exit 2
Block — stderr fed back to Claude차단 (stderr를 Claude에 전달)
기타
Non-blocking error비차단 오류 (계속 진행)