Claude Code 치트시트

⌨️ 키보드 단축키

일반 제어

CtrlC 입력/생성 취소

CtrlD 세션 종료

CtrlL 화면 지우기

CtrlO 상세 / 트랜스크립트 / 포커스 뷰 전환NEW

CtrlR 히스토리 역방향 검색

CtrlG 에디터에서 프롬프트 열기

CtrlX CtrlE 에디터에서 열기 (별칭)

CtrlB 실행 중인 작업 백그라운드로

CtrlT 작업 목록 전환

CtrlV 이미지 붙여넣기 ([Image #N] 칩)

CtrlX CtrlK 백그라운드 에이전트 종료

EscEsc 되감기 또는 요약

모드 전환

ShiftTab 권한 모드 순환

AltP 모델 전환

AltT 사고 모드 전환

AltO 빠른 모드 전환NEW

입력

\Enter 줄바꾸기 (빠른)

CtrlJ 줄바꾸기 (제어 시퀀스)

접두사

/ 슬래시 명령어

! 직접 bash 실행

@ 파일 언급 + 자동완성

트랜스크립트 / 포커스 뷰 (Ctrl+O)

CtrlE 전체 표시 전환

Q / CtrlC / Esc 트랜스크립트 종료

🔌 MCP 서버

서버 추가

--transport http 원격 HTTP (권장)

--transport stdio 로컬 프로세스

--transport sse 원격 SSE

범위

Local ~/.claude.json (본인만)

Project .mcp.json (공유/VCS)

User ~/.claude.json (전역)

관리

/mcp 대화형 UI

claude mcp list 모든 서버 목록

claude mcp serve Claude Code 자체를 stdio MCP 서버로 실행

Elicitation 서버가 작업 중간에 사용자 입력을 요청할 수 있음

2KB each 도구 설명과 서버 지침은 각각 2KB에서 잘림

maxResultSizeChars _meta["anthropic/maxResultSizeChars"] 로 도구별 텍스트 한도를 높일 수 있음 (최대 500K자)NEW

⚡ 슬래시 명령어

세션

/clear 대화 지우기

/compact [focus] 컨텍스트 압축

/resume 세션 재개/전환

/rename [name] 현재 세션 이름 지정

/branch [name] 대화 분기 (/fork 별칭)

/cost 토큰 사용량 (모델별 + 캐시 분류)NEW

/context 컨텍스트 시각화 (그리드)

/diff 대화형 diff 뷰어

/copy [N] 마지막 (또는 N번째) 응답 복사

/rewind 대화/코드 체크포인트로 되감기

/recap 세션으로 돌아갈 때 컨텍스트 요약 제공NEW

/export 대화 내보내기

설정

/config 설정 열기

/model [model] 모델 전환 (←→ 노력도)

/fast [on|off] 빠른 모드 전환

/theme 색상 테마 변경

/permissions 권한 보기/업데이트

/effort [level] 노력도 설정 (low/medium/high/max/auto)

/color [color] 프롬프트 바 색상 설정

/keybindings 키보드 단축키 사용자 정의

/terminal-setup 터미널 키 바인딩 구성

도구

/init CLAUDE.md 생성

/memory CLAUDE.md 파일 편집, 자동 메모리 전환, 항목 보기

/mcp MCP 서버 관리

/hooks 훅 관리

/skills 사용 가능한 스킬 목록

/agents 에이전트 구성 관리NEW

/add-dir <path> 작업 디렉토리 추가

특수

/powerup 인터랙티브 기능 학습NEW

/btw <question> 사이드 질문 (컨텍스트 없이)

/plan [desc] 플랜 모드 (+ 자동 시작)

/loop [interval] 반복 작업 예약

/voice 푸시투톡 음성 (20개 언어)

/doctor 설치 진단

/stats 사용 연속 기록 & 선호도

/insights 세션 분석 보고서

/desktop 데스크톱 앱에서 계속

/remote-control claude.ai/code 브릿지 (/rc)

/usage 플랜 한도 & 속도 제한 상태

/schedule 클라우드 예약 작업

/ultraplan <prompt> 브라우저 세션에서 계획 초안을 만들고, 필요하면 기본 클라우드 환경을 자동 생성한 뒤 원격 실행하거나 터미널로 다시 보냄NEW

/security-review 변경사항 보안 분석

/help 도움말 + 명령어 표시

/feedback 피드백 제어 (별칭: /bug)

/release-notes 인터랙티브 버전 변경 로그NEW

/stickers 스티커 주문! 🎉

📁 메모리 & 파일

CLAUDE.md 위치

./CLAUDE.md or ./.claude/CLAUDE.md 프로젝트 (팀 공유)

./CLAUDE.local.md 로컬 개인 프로젝트 메모 (gitignored)

~/.claude/CLAUDE.md 개인 (모든 프로젝트)

/etc/claude-code/CLAUDE.md 관리형 정책 (Linux/WSL, 조직 전체)

규칙 & 가져오기

.claude/rules/*.md 프로젝트 규칙

~/.claude/rules/*.md 사용자 규칙

paths: frontmatter 경로별 규칙

@path/to/file CLAUDE.md에서 가져오기

자동 메모리

~/.claude/projects/<proj>/memory/

MEMORY.md 는 시작 시 자동 로드됨(첫 25KB 또는 200줄); 토픽 파일은 필요할 때 로드

🧠 워크플로우 & 팁

플랜 모드

ShiftTab 일반 → 자동 수락 → 플랜

--permission-mode plan 플랜 모드로 시작

사고 & 노력도

AltT 사고 모드 켜기/끄기

"ultrathink" 현재 턴 최대 노력도

CtrlO 사고 과정 보기 (상세)

/effort ○ low · ◐ medium · ● high · ★ max

자동 모드 거부

/permissions → Recent R로 거부된 작업 재시도NEW

Git 워크트리

--worktree name 기능별 독립 브랜치

isolation: worktree 에이전트 전용 워크트리

sparsePaths 필요한 디렉토리만 체크아웃

workspace.git_worktree 상태 줄 JSON: 연결된 worktree 경로NEW

/batch 자동 워크트리 생성

음성 모드

/voice 푸시투톡 활성화

Space (길게 누르기) 녹음, 놓으면 전송

20개 언어 EN, ES, FR, DE, CZ, PL…

컨텍스트 관리

/context 사용량 + 최적화 팁

/compact [focus] 초점 맞춰 압축

1M context Opus 4.6 (Max/Team/Ent)

세션 파워 무브

claude -c 마지막 대화 계속

claude -r "name" 이름으로 재개

/btw question 사이드 질문, 컨텍스트 비용 없음

SDK / 헤드리스

claude -p "query" 비대화형

--output-format json 구조화된 출력

--max-budget-usd 5 비용 한도

cat file | claude -p 파이프 입력

스케줄링 & 원격

/loop 5m msg 반복 작업

/rc 원격 제어 (기본값은 호스트명 접두사)NEW

/ultraplan 브라우저에서 계획 초안을 만들고, 필요하면 기본 클라우드 환경을 자동 생성한 뒤 원격 실행하거나 터미널로 다시 보냄NEW

--remote claude.ai 웹 세션

⚙️ 설정 & 환경 변수

설정 파일

~/.claude/settings.json 사용자 설정

.claude/settings.json 프로젝트 (공유)

.claude/settings.local.json 로컬 전용

~/.claude.json OAuth, MCP, 상태

.mcp.json 프로젝트 MCP 서버

managed-settings.d/ 드롭인 정책 파편

주요 설정

modelOverrides 모델 선택기 → 커스텀 ID 매핑

hooks: if 조건부 훅 (권한 규칙 구문)

Monitor tool 백그라운드 스크립트의 이벤트를 스트리밍NEW

PermissionDenied 훅: 자동 모드 거부NEW

showThinkingSummaries 옵트인 (기본 비활성화로 변경)NEW

hooks: "defer" 헤드리스 일시중지 → 나중에 재개

disableSkillShellExec 스킬/플러그인의 !`cmd` 차단NEW

forceRemoteSettingsRefresh 시작 시 새로고침 실패 시 차단NEW

refreshInterval 커스텀 상태 줄을 N초마다 다시 실행NEW

주요 환경 변수

ANTHROPIC_API_KEY

ANTHROPIC_MODEL

CLAUDE_CODE_EFFORT_LEVEL low/medium/high/max/auto

MAX_THINKING_TOKENS 0=끄기

ANTHROPIC_CUSTOM_MODEL_OPTION 커스텀 /model 항목

CLAUDECODE CC 쉘 감지 (=1)

CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE Auto-upgrade via Homebrew/WinGetNEW

CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN Opt out of fullscreen rendering (=1)NEW

🔧 스킬 & 에이전트

내장 스킬

/simplify 코드 리뷰 (3개 병렬 에이전트)

/batch 대규모 병렬 변경 (5-30 워크트리)

/debug [desc] 디버그 로그에서 문제 해결

/loop [interval] 반복 예약 작업

/claude-api API + SDK 참조 로드

커스텀 스킬 위치

.claude/skills/<name>/ 프로젝트 스킬

~/.claude/skills/<name>/ 개인 스킬

스킬 프론트매터

description 자동 호출 트리거

allowed-tools 권한 프롬프트 건너뛰기

model 스킬용 모델 재정의

effort 노력도 재정의

paths: [globs] 경로별 적용 (YAML 목록)NEW

context: fork 서브에이전트에서 실행

$ARGUMENTS 사용자 입력 플레이스홀더

${CLAUDE_SKILL_DIR} 스킬 자체 디렉토리

!`cmd` 동적 컨텍스트 주입

plugin bin/ Bash 도구용 실행 파일 제공NEW

내장 에이전트

Explore 빠른 읽기 전용 (Haiku)

Plan 플랜 모드용 조사

General 전체 도구, 복잡한 작업

Bash 터미널 별도 컨텍스트

에이전트 프론트매터

permissionMode default/acceptEdits/plan/dontAsk/bypassPermissions

isolation: worktree git 워크트리에서 실행

memory: user|project|local 영구 메모리

background: true 백그라운드 작업

maxTurns 에이전트 턴 제한

initialPrompt 첫 턴 자동 제출

SendMessage 에이전트 재개 (resume 대체)

@agent-name 이름 지정된 서브에이전트 멘션NEW

🖥️ CLI & 플래그

핵심 명령어

claude 대화형

claude "q" 프롬프트와 함께

claude -p "q" 헤드리스

claude -c 마지막 세션 계속

claude -r "n" 재개

claude update 업데이트

주요 플래그

--model 모델 설정

-w Git 워크트리

-n / --name 세션 이름

--add-dir 디렉토리 추가

--agent 에이전트 사용

--allowedTools 사전 승인

--allow-dangerously-skip-permissions Shift+Tab 순환에 bypassPermissions 추가

--output-format text/json/stream-json

--max-budget-usd 비용 한도

--exclude-dynamic-system-prompt-sections print 모드: 사용자 간 프롬프트 캐시 개선NEW

--verbose 상세 출력

--remote claude.ai에 웹 세션 생성

--rc Remote Control 모드

--effort low/medium/high/max

--permission-mode plan/default/…

--dangerously-skip-permissions 모든 프롬프트 건너뛰기 ⚠️

--chrome Chrome