Claude Code 치트시트

Anthropic 공식 CLI — 키보드 단축키, 명령어, 워크플로우 총정리

v2.1.123 · 2026.04.29 · 원본

⌨️ 단축키 ⚡ 슬래시 명령 🔌 MCP 📁 메모리 🧠 워크플로우 ⚙️ 설정 🔧 스킬/에이전트 🖥️ CLI 📝 최근 변경

⌨️ 키보드 단축키

일반 제어

단축키	동작
`Ctrl+C`	입력/생성 취소
`Ctrl+D`	세션 종료
`Ctrl+L`	화면 지우기
`Ctrl+O`	상세 모드/트랜스크립트 토글
`Ctrl+R`	히스토리 역검색
`Ctrl+G`	프롬프트를 에디터에서 열기
`Ctrl+B`	실행 중인 작업 백그라운드로
`Ctrl+T`	작업 목록 토글
`Ctrl+V`	이미지 붙여넣기
`Ctrl+X, Ctrl+K`	백그라운드 에이전트 종료
`Esc, Esc`	되감기 또는 요약

모드 전환

단축키	동작
`Shift+Tab`	권한 모드 순환 (일반→자동승인→플랜)
`Alt+P`	모델 전환
`Alt+T`	사고(Thinking) 토글
`Alt+O`	빠른 모드(Fast) 토글 NEW

입력

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

프리픽스

프리픽스	동작
`/`	슬래시 명령어
`!`	직접 bash 실행
`@`	파일 멘션 + 자동완성

세션 선택기

키	동작
`↑↓`	탐색
`←→`	펼치기/접기
`P`	미리보기
`R`	이름 변경
`/`	검색
`A`	전체 프로젝트
`B`	현재 브랜치

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

키	동작
`/`	트랜스크립트 검색
`N` / `Shift+N`	다음/이전 일치
`Ctrl+E`	전체 표시 토글
`Q` / `Esc`	트랜스크립트 종료

Vim 모드 NEW

키	동작
`v`	비주얼 모드 (문자 선택)
`Shift+V`	비주얼-라인 모드 (행 선택)

⚡ 슬래시 명령어

세션 관리

명령어	기능
`/clear`	대화 초기화
`/compact [초점]`	컨텍스트 압축
`/resume`	세션 이어하기/전환
`/rename [이름]`	현재 세션 이름 변경
`/branch [이름]`	대화 분기 (`/fork` 별칭)
`/cost`	토큰 사용량 통계
`/context`	컨텍스트 시각화 (그리드)
`/diff`	인터랙티브 diff 뷰어
`/copy [N]`	마지막 (또는 N번째) 응답 복사
`/rewind`	대화/코드 체크포인트 되감기
`/undo`	`/rewind` 별칭 NEW
`/recap`	복귀 시 세션 컨텍스트 요약 NEW
`/focus`	풀스크린 포커스 뷰 토글 NEW
`/export`	대화 내보내기

설정

명령어	기능
`/config`	설정 열기
`/model [모델]`	모델 전환 (`←→`로 노력도 조절)
`/fast [on\|off]`	빠른 모드 토글
`/vim`	vim 모드 토글
`/theme`	색상 테마 변경
`/permissions`	권한 보기/수정
`/effort [레벨]`	노력도 설정 (low/medium/high/max/auto)
`/keybindings`	키보드 단축키 커스터마이징

도구

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

특수 명령어

명령어	기능
`/powerup`	인터랙티브 기능 학습 NEW
`/btw <질문>`	사이드 질문 (컨텍스트 비소모)
`/plan [설명]`	플랜 모드 (+ 자동 시작)
`/loop [간격]`	반복 예약 작업
`/voice`	푸시투톡 음성 (20개 언어)
`/doctor`	설치 진단
`/pr-comments [PR]`	GitHub PR 댓글 가져오기
`/stats`	사용 기록 및 선호도
`/insights`	세션 분석 리포트
`/schedule`	클라우드 예약 작업
`/security-review`	변경사항 보안 분석
`/remote-control`	claude.ai/code 브리지 (`/rc`)
`/usage`	토큰·비용·캐시 분석 (`/cost`·`/stats` 통합)
`/help`	도움말 + 명령어 목록

🔌 MCP 서버

서버 추가

플래그	용도
`--transport http`	원격 HTTP (권장)
`--transport stdio`	로컬 프로세스
`--transport sse`	원격 SSE

범위

위치	설명
`~/.claude.json`	로컬 (본인만 사용)
`.mcp.json`	프로젝트 (팀 공유/VCS)

관리

명령어	동작
`/mcp`	인터랙티브 UI
`claude mcp list`	전체 서버 목록
`claude mcp serve`	CC를 MCP 서버로 실행

주요 설정: Elicitation(입력 요청), 2KB 도구 설명 제한, maxResultSizeChars 최대 500K, alwaysLoad: true로 세션 간 서버 연결 유지 NEW

📁 메모리 & 파일

CLAUDE.md 위치

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

규칙 & 가져오기

경로	용도
`.claude/rules/*.md`	프로젝트 규칙
`~/.claude/rules/*.md`	사용자 규칙
`paths:` frontmatter	경로별 규칙
`@path/to/file`	CLAUDE.md에서 가져오기

자동 메모리: ~/.claude/projects/<proj>/memory/에 저장. MEMORY.md + 토픽 파일, 자동 로드 (25KB/200줄 제한). CLAUDE.md는 컨텍스트 압축에서도 유지됩니다!

🧠 워크플로우 & 팁

플랜 모드

제어	동작
`Shift+Tab`	일반 → 자동승인 → 플랜 순환
`--permission-mode plan`	플랜 모드로 시작

사고(Thinking) & 노력도

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

Git Worktree

플래그/설정	기능
`--worktree name`	기능별 독립 브랜치
`isolation: worktree`	에이전트가 자체 워크트리에서 실행
`sparsePaths`	필요한 디렉토리만 체크아웃
`/batch`	자동으로 워크트리 생성
`workspace.git_worktree`	상태줄 JSON에 워크트리 경로 노출 NEW

음성 모드

제어	기능
`/voice`	푸시투톡 활성화
`Space` (길게 누르기)	녹음, 놓으면 전송
지원 언어	한국어, 영어, 일본어 등 20개

컨텍스트 관리

명령어	기능
`/context`	사용량 + 최적화 팁
`/compact [초점]`	초점을 두고 압축
자동 압축	~95% 용량 시 자동 (3회 반복 감지) NEW
1M 컨텍스트	Opus 4.6 (Max/Team/Enterprise)

세션 파워 무브

명령어/플래그	기능
`claude -c`	마지막 대화 이어하기
`claude -r "이름"`	이름으로 세션 재개
`/btw 질문`	사이드 질문 (컨텍스트 비소모)
`cat file \| claude -p`	파이프 입력

SDK / 헤드리스

플래그	기능
`claude -p "쿼리"`	비대화형 모드
`--output-format json`	구조화된 출력
`--max-budget-usd 5`	비용 상한

예약 & 원격

명령어	기능
`/loop 5m 메시지`	반복 작업
`/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`	스파스 체크아웃 디렉토리
`hooks: if`	조건부 훅 (권한 규칙 문법)
`hooks: "defer"`	헤드리스 일시정지 → 나중에 재개
`hooks: type: "mcp_tool"`	훅에서 MCP 도구 직접 호출 NEW
`disableSkillShellExec`	스킬/플러그인 셸 실행 차단
`showThinkingSummaries`	사고 요약 표시 (기본 off, opt-in) NEW
`alwaysLoad: true`	MCP 서버 세션 간 연결 유지 NEW
`refreshInterval`	커스텀 상태줄 재실행 간격 NEW

주요 환경변수

변수	용도
`ANTHROPIC_API_KEY`	API 인증
`ANTHROPIC_MODEL`	기본 모델 선택
`CLAUDE_CODE_EFFORT_LEVEL`	low/medium/high/max/auto
`MAX_THINKING_TOKENS`	0=사고 비활성화
`CLAUDE_CODE_NO_FLICKER`	대체 화면 렌더링 (=1)
`MCP_CONNECTION_NONBLOCKING`	`-p`에서 MCP 대기 건너뛰기
`ENABLE_PROMPT_CACHING_1H`	1시간 프롬프트 캐시 TTL opt-in NEW
`FORCE_PROMPT_CACHING_5M`	5분 프롬프트 캐시 TTL 강제 NEW
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	텔레메트리 비활성 시 recap 강제 NEW
`CLAUDE_CODE_FORK_SUBAGENT`	외부 빌드에서 forked 서브에이전트 활성 NEW
`DISABLE_UPDATES`	모든 업데이트 경로 차단 NEW
`CLAUDECODE`	CC 셸 감지 (=1)

🔧 스킬 & 에이전트

내장 스킬

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

커스텀 스킬 위치

위치	범위
`.claude/skills/<이름>/`	프로젝트 스킬
`~/.claude/skills/<이름>/`	개인 스킬

스킬 Frontmatter

필드	기능
`description`	자동 호출 트리거
`allowed-tools`	권한 프롬프트 건너뛰기
`model`	스킬용 모델 재정의
`paths: [글로브]`	경로별 활성화 NEW
`context: fork`	서브에이전트에서 실행
`$ARGUMENTS`	사용자 입력 플레이스홀더
`${CLAUDE_EFFORT}`	현재 노력도 레벨 변수 NEW
!`cmd`	동적 컨텍스트 주입
플러그인 `bin/`	Bash 도구용 실행파일

내장 에이전트

에이전트	설명
Explore	빠른 읽기 전용 (Haiku)
Plan	플랜 모드용 리서치
General	모든 도구, 복잡한 작업
Bash	터미널 별도 컨텍스트

에이전트 Frontmatter

필드	기능
`permissionMode`	default/acceptEdits/plan/dontAsk/bypassPermissions
`isolation: worktree`	Git 워크트리에서 실행
`memory`	user\|project\|local 영속 메모리
`background: true`	백그라운드 작업
`maxTurns`	에이전트 턴 수 제한
`SendMessage`	에이전트 재개 (resume 대체)
`@agent-name`	이름으로 서브에이전트 멘션 NEW

🖥️ CLI & 플래그

핵심 명령어

명령어	기능
`claude`	대화형 모드
`claude "질문"`	프롬프트와 함께 시작
`claude -p "질문"`	헤드리스 (비대화형)
`claude -c`	마지막 대화 이어하기
`claude -r "이름"`	세션 재개
`claude update`	업데이트
`claude plugin prune`	미사용/고아 플러그인 제거 NEW
`claude ultrareview [target]`	비대화형 코드 리뷰 NEW

주요 플래그

플래그	기능
`--model`	모델 설정
`-w`	Git 워크트리
`-n / --name`	세션 이름
`--add-dir`	디렉토리 추가
`--agent`	에이전트 사용
`--allowedTools`	도구 사전 승인
`--output-format`	json/stream
`--max-turns`	턴 수 제한
`--max-budget-usd`	비용 상한
`--effort`	low/medium/high/max
`--permission-mode`	plan/default/…
`--remote`	웹 세션
`--bare`	최소 헤드리스 (훅/LSP 없음)
`--from-pr`	GitHub/GitLab/Bitbucket/GHE PR 컨텍스트 로드 NEW

권한 모드

모드	설명
default	매번 확인 프롬프트
acceptEdits	편집 자동 승인
plan	읽기 전용
dontAsk	허용 목록 외 거부
bypassPermissions	모두 건너뛰기

📝 최근 변경 (v2.1.91 → v2.1.123)

v2.1.123 · CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 환경에서 OAuth 재시도 루프 수정

v2.1.122 · /resume에 PR URL 검색 기능 추가

v2.1.122 · MCP 패널이 숨겨진 claude.ai 커넥터 표시

신규 슬래시: /recap, /undo, /focus

신규 CLI: claude plugin prune, claude ultrareview, --from-pr

신규 환경변수: ENABLE_PROMPT_CACHING_1H, FORCE_PROMPT_CACHING_5M, CLAUDE_CODE_ENABLE_AWAY_SUMMARY, CLAUDE_CODE_FORK_SUBAGENT, DISABLE_UPDATES

신규 설정: MCP alwaysLoad, 훅 type: "mcp_tool", showThinkingSummaries, refreshInterval

Vim 비주얼 모드 (v, Shift+V) 지원

스킬 변수 ${CLAUDE_EFFORT} 추가

원본: cc.storyfox.cz by @phasE89 · 한국어 번역: HaruLogs