Claude Code 치트 시트

Claude Code v2.1.92 기준 | 최종 업데이트: 2026년 4월 4일

노트

원본 출처: cc.storyfox.cz (@phasE89)

최근 변경사항 (v2.1.92)

• forceRemoteSettingsRefresh 정책 — 시작 시 원격 설정 새로고침 실패하면 차단
• 로그인 화면에서 대화형 Bedrock 설정 마법사
• /cost에서 모델별 + 캐시 히트 비용 분석
• /release-notes가 대화형 버전 선택기로 변경
• /tag 및 /vim 명령어 제거
• Write 도구 대용량 파일 diff 60% 속도 향상

키보드 단축키

일반 제어

단축키	기능
Ctrl+C	입력/생성 취소
Ctrl+D	세션 종료
Ctrl+L	화면 다시 그리기
Ctrl+O	상세/트랜스크립트 토글
Ctrl+R	히스토리 역방향 검색
Ctrl+G	편집기에서 프롬프트 열기
Ctrl+X Ctrl+E	편집기에서 열기 (별칭)
Ctrl+B	실행 중인 작업 백그라운드로 전환
Ctrl+T	작업 목록 토글
Ctrl+V	이미지 붙여넣기
Ctrl+X Ctrl+K	백그라운드 에이전트 종료
Esc+Esc	되감기 또는 요약

모드 전환

단축키	기능
Shift+Tab	권한 모드 순환
Alt+P	모델 전환
Alt+T	사고(thinking) 토글
Alt+O	빠른 모드 토글 (신규)

입력

단축키	기능
\+Enter	줄바꿈 (빠른 방법)
Ctrl+J	줄바꿈 (제어 시퀀스)

접두사

접두사	기능
/	슬래시 명령어
!	직접 bash 실행
@	파일 언급 + 자동완성

세션 선택기

단축키	기능
↑↓	탐색
←→	확장/축소
P	미리보기
R	이름 변경
/	검색
A	모든 프로젝트
B	현재 브랜치

트랜스크립트 모드 (Ctrl+O)

단축키	기능
Ctrl+E	전체 표시 토글
Q / 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	CC를 MCP 서버로 실행

기능

• Elicitation 서버가 작업 중 입력을 요청할 수 있음
• 도구 설명 + 서버 지시사항 2KB 제한
• maxResultSizeChars _meta 어노테이션 재정의 (최대 500K) - 신규

슬래시 명령어

세션

명령어	설명
/clear	대화 초기화
/compact [초점]	컨텍스트 압축
/resume	세션 재개/전환
/rename [이름]	현재 세션 이름 지정
/branch [이름]	대화 분기 (/fork 별칭)
/cost	토큰 사용량 (모델별 + 캐시 분석) - 신규
/context	컨텍스트 시각화 (그리드)
/diff	대화형 diff 뷰어
/copy [N]	마지막 (또는 N번째) 응답 복사
/rewind	대화/코드 체크포인트로 되감기
/export	대화 내보내기

설정

명령어	설명
/config	설정 열기
/model [모델]	모델 전환 (←→로 노력 수준 조정)
/fast [on\|off]	빠른 모드 토글
/theme	색상 테마 변경
/permissions	권한 보기/수정
/effort [수준]	노력 수준 설정 (low/medium/high/max/auto)
/color [색상]	프롬프트 바 색상 설정
/keybindings	키보드 단축키 커스터마이즈
/terminal-setup	터미널 키바인딩 설정

도구

명령어	설명
/init	CLAUDE.md 생성
/memory	CLAUDE.md 파일 편집
/mcp	MCP 서버 관리
/hooks	훅 관리
/skills	사용 가능한 스킬 목록
/agents	에이전트 관리
/chrome	Chrome 통합
/reload-plugins	플러그인 핫 리로드
/add-dir <경로>	작업 디렉토리 추가

특수

명령어	설명
/powerup	대화형 기능 학습 - 신규
/btw <질문>	사이드 질문 (컨텍스트 불필요)
/plan [설명]	플랜 모드 (+ 자동 시작)
/loop [간격]	반복 예약 작업
/voice	푸시투톡 음성 (20개 언어)
/doctor	설치 진단
/stats	사용 통계 및 선호도
/insights	세션 분석 보고서
/desktop	Desktop 앱에서 계속
/remote-control	claude.ai/code 브릿지 (/rc)
/usage	요금제 한도 및 속도 제한 상태
/schedule	클라우드 예약 작업
/security-review	변경사항 보안 분석
/help	도움말 + 명령어 표시
/feedback	피드백 제출 (/bug 별칭)
/release-notes	대화형 버전 변경 이력 - 신규
/stickers	스티커 주문!

메모리 및 파일

CLAUDE.md 위치

• ./CLAUDE.md — 프로젝트 (팀 공유)
• ~/.claude/CLAUDE.md — 개인 (모든 프로젝트)
• /etc/claude-code/ — 관리형 (조직 전체)

규칙 및 임포트

• .claude/rules/*.md — 프로젝트 규칙
• ~/.claude/rules/*.md — 사용자 규칙
• paths: 프론트매터 — 경로별 규칙
• @path/to/file — CLAUDE.md에서 임포트

자동 메모리

• 위치: ~/.claude/projects/<proj>/memory/
• 내용: MEMORY.md + 주제별 파일, 자동 로드 (최대 25KB/200줄)

워크플로우 및 팁

플랜 모드

단축키	기능
Shift+Tab	Normal → Auto-Accept → Plan
--permission-mode plan	플랜 모드로 시작

사고(Thinking) 및 노력 수준

제어	기능
Alt+T	사고 켜기/끄기
"ultrathink"	해당 턴 최대 노력
Ctrl+O	사고 과정 보기 (상세)
/effort	○ low · ◐ medium · ● high · ★ max

자동 모드 거부

• /permissions → 최근 거부된 항목 R로 재시도 - 신규

Git 워크트리

옵션	설명
--worktree name	기능별 격리된 브랜치
isolation: worktree	에이전트가 별도 워크트리에서 실행
sparsePaths	필요한 디렉토리만 체크아웃
/batch	워크트리 자동 생성

음성 모드

제어	기능
/voice	푸시투톡 활성화
Space (길게 누르기)	녹음, 놓으면 전송
지원 언어	20개 언어: EN, ES, FR, DE, CZ, PL…

컨텍스트 관리

명령어	기능
/context	사용량 + 최적화 팁
/compact [초점]	초점을 맞춰 압축
자동 압축	약 95% 용량에서 작동 (반복 감지: 3회) - 신규
1M 컨텍스트	Opus 4.6 (Max/Team/Ent)
CLAUDE.md	압축에서도 유지됨!

세션 파워 무브

명령어	기능
claude -c	마지막 대화 이어서
claude -r "이름"	이름으로 세션 재개
/btw 질문	사이드 질문, 컨텍스트 비용 없음
claude -p "쿼리"	비대화형 모드
--output-format json	구조화된 출력
--max-budget-usd 5	비용 한도
cat file \| claude -p	파이프 입력

스케줄링 및 원격

명령어	기능
/loop 5m msg	반복 작업
/rc	원격 제어 (호스트명 접두사 기본값) - 신규
--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 매핑
autoMemoryDirectory	커스텀 메모리 디렉토리
worktree.sparsePaths	스파스 체크아웃 디렉토리
sandbox.failIfUnavailable	샌드박스 실패 시 종료
hooks: if	조건부 훅 (권한 규칙 구문)
PermissionDenied	훅: 자동 모드 거부 - 신규
showThinkingSummaries	옵트인 (기본값 꺼짐) - 신규
allowedChannelPlugins	관리자 채널 플러그인 허용 목록
hooks: "defer"	헤드리스 일시정지 → 나중에 재개
disableSkillShellExec	스킬/플러그인에서 !cmd 차단 - 신규
forceRemoteSettingsRefresh	실패 차단: 새로고침까지 시작 차단 - 신규

주요 환경 변수

변수	용도
ANTHROPIC_API_KEY	API 인증
ANTHROPIC_MODEL	기본 모델
CLAUDE_CODE_EFFORT_LEVEL	low/medium/high/max/auto
MAX_THINKING_TOKENS	0=꺼짐
ANTHROPIC_CUSTOM_MODEL_OPTION	커스텀 /model 항목
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB	하위 프로세스에서 자격증명 제거
CLAUDE_STREAM_IDLE_TIMEOUT_MS	스트리밍 감시 타이머 (기본 90초)
CLAUDE_CODE_NO_FLICKER	대체 화면 렌더링 (=1) - 신규
MCP_CONNECTION_NONBLOCKING	-p에서 MCP 대기 건너뛰기 - 신규
CLAUDECODE	CC 셸 감지 (=1)

스킬 및 에이전트

내장 스킬

명령어	설명
/simplify	코드 리뷰 (3개 병렬 에이전트)
/batch	대규모 병렬 변경 (5~30개 워크트리)
/debug [설명]	디버그 로그에서 문제 해결
/loop [간격]	반복 예약 작업
/claude-api	API + SDK 참조 로드

커스텀 스킬 위치

• .claude/skills/<이름>/ — 프로젝트 스킬
• ~/.claude/skills/<이름>/ — 개인 스킬

스킬 프론트매터

속성	용도
description	자동 호출 트리거
allowed-tools	권한 프롬프트 건너뛰기
model	스킬용 모델 재정의
effort	노력 수준 재정의
paths: [글로브]	경로별 적용 (YAML 목록) - 신규
context: fork	서브에이전트에서 실행
$ARGUMENTS	사용자 입력 플레이스홀더
${CLAUDE_SKILL_DIR}	스킬의 자체 디렉토리
!`cmd`	동적 컨텍스트 주입
plugin bin/	Bash 도구용 실행 파일 포함 - 신규

내장 에이전트

• 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	이름 있는 서브에이전트 언급 - 신규

CLI 및 플래그

핵심 명령어

명령어	용도
claude	대화형
claude "q"	프롬프트와 함께
claude -p "q"	헤드리스
claude -c	마지막 대화 이어서
claude -r "n"	세션 재개
claude update	업데이트

주요 플래그

플래그	용도
--model	모델 설정
-w	Git 워크트리
-n / --name	세션 이름
--add-dir	디렉토리 추가
--agent	에이전트 사용
--allowedTools	사전 승인
--output-format	json/stream
--json-schema	구조화
--max-turns	턴 제한
--max-budget-usd	비용 한도
--console	Anthropic Console로 인증
Bedrock 마법사	로그인 시 대화형 AWS 설정 - 신규
--verbose	상세 모드
--bare	최소 헤드리스 (훅/LSP 없음)
--channels	권한 릴레이 / MCP 푸시
--remote	웹 세션
--effort	low/medium/high/max
--permission-mode	plan/default/…
--dangerously-skip-permissions	모든 프롬프트 건너뛰기 ⚠️
--chrome	Chrome
PowerShell 도구	Windows 옵트인 프리뷰 - 신규

권한 모드

• default — 프롬프트 표시
• acceptEdits — 편집 자동 수락
• plan — 읽기 전용
• dontAsk — 허용된 것 외 거부
• bypassPermissions — 모두 건너뛰기
• --dangerously-skip-permissions — CLI 플래그