Claude Code 치트 시트 — 키보드 단축키·슬래시 명령어·워크플로우 총정리
Claude Code Cheat Sheet
TL;DR Highlight
Claude Code를 매일 쓰면서도 명령어가 헷갈리는 개발자를 위해, 키보드 단축키부터 MCP 설정·메모리 관리·CLI 플래그까지 한 페이지로 정리한 치트 시트. 자동 업데이트 기능까지 달려 있어 항상 최신 버전을 유지한다.
Who Should Read
Claude Code를 터미널에서 매일 사용하지만 명령어나 단축키를 자주 까먹는 개발자. 특히 MCP 서버 설정, 에이전트 워크플로우, 컨텍스트 관리 같은 고급 기능을 제대로 활용하고 싶은 사람에게 유용하다.
Core Mechanics
- 이 치트 시트는 제작자가 Claude Code 문서와 GitHub를 Claude에게 직접 리서치시킨 뒤, A4 가로 출력용 HTML 한 장으로 만든 결과물이다. 키보드 단축키, 슬래시 명령어, 워크플로우, 메모리/CLAUDE.md, MCP 설정, CLI 플래그, 설정 파일까지 전부 커버한다.
- 매일 cron job이 changelog를 체크해서 새 기능이 추가되면 'NEW' 뱃지를 붙이고 시트를 자동 업데이트한다. 현재 Claude Code v2.1.81 기준이며, 최근 변경사항으로는 --bare 플래그(최소 headless 모드), --channels(MCP push 메시지 프리뷰), /fork 명령어가 /branch로 이름 변경(별칭 유지), SendMessage가 중단된 에이전트를 자동 재개하는 기능 등이 있다.
- 키보드 단축키 중 특히 유용한 것들: Ctrl+B(백그라운드 실행), Ctrl+T(태스크 목록 토글), Ctrl+V(이미지 붙여넣기), Ctrl+F×2(백그라운드 에이전트 종료), EscEsc(되감기/실행 취소), AltP(모델 전환), AltT(thinking 토글), ShiftTab(권한 모드 순환)이 있다.
- 슬래시 명령어 중 실용적인 것들: /compact [focus]로 특정 주제에 집중하며 컨텍스트 압축, /btw <질문>으로 컨텍스트 비용 없이 사이드 질문, /loop [interval]로 반복 작업 스케줄링, /context로 컨텍스트 사용량 시각화, /effort [level]로 low/med/high/max/auto 중 선택해 추론 깊이 조절이 가능하다.
- 메모리 시스템은 세 가지 레벨로 나뉜다. ./CLAUDE.md(프로젝트 팀 공유), ~/.claude/CLAUDE.md(개인 전체 프로젝트), /etc/claude-code/(조직 전체 관리)로 구분되며, CLAUDE.md는 /compact로 컨텍스트가 압축되어도 살아남는다. ~/.claude/projects/<proj>/memory/ 경로에 MEMORY.md와 주제별 파일이 자동 로드된다.
- Git Worktree 통합 기능이 추가됐다. --worktree name 플래그로 기능별 격리된 브랜치를 만들고, sparsePaths 설정으로 필요한 디렉터리만 체크아웃할 수 있다. /batch 명령어가 워크트리를 자동 생성해준다.
- SDK/Headless 모드에서는 claude -p "query"로 비대화형 실행, --output-format json으로 구조화된 출력, --max-budget-usd 5로 비용 상한 설정, cat file | claude -p로 파이프 입력이 가능하다. 환경변수 CLAUDE_CODE_EFFORT_LEVEL로 기본 노력 수준을 설정할 수 있다.
- 주요 설정 파일은 ~/.claude/settings.json(사용자), .claude/settings.json(프로젝트 공유), .claude/settings.local.json(로컬 전용)으로 나뉘며, modelOverrides로 모델 피커를 커스텀 ID에 매핑하고 autoMemoryDirectory로 메모리 저장 위치를 바꿀 수 있다.
Evidence
- 제작자가 직접 댓글에서 제작 경위를 밝혔다. Claude Code를 매일 쓰면서 명령어를 자주 잊어버려서, Claude에게 문서와 GitHub를 리서치시켜 HTML로 만들었고, 레이아웃은 직접 이터레이션했다. Mac/Windows 단축키 자동 감지, 버전 표시, 신규 기능 'NEW' 뱃지까지 구현했으며, 무료·회원가입 불필요를 강조했다.
- '일주일이면 구식 되는 거 아니냐'는 지적이 있었다. 제작자는 매일 cron job으로 changelog를 체크해 자동 업데이트한다고 답했다. 다만 '그냥 Claude Code한테 자기 자신의 치트 시트 만들어 달라고 하면 되는 거 아니냐'는 반응도 있었다.
- 댓글에서 여러 누락 항목이 지적됐다. --dangerously-skip-permissions 플래그(가장 많이 쓰는 플래그인데 없다는 지적), Ctrl+S(프롬프트를 임시 저장하고 슬래시 명령어 입력 가능), Ctrl+_(언두), IS_DEMO=1 환경변수(불필요한 웰컴 배너 제거) 등이 언급됐다. MCP 섹션에서 'Local' 항목의 경로 표기 오류(~/가 아니라 ./이어야 함)도 지적됐다.
- /insights 명령어가 실제로 유용하다는 경험담이 공유됐다. 세션 분석 리포트를 보여주는데, 어떤 사용자는 이 결과를 보면서 실패 케이스를 어떤 모델이 마킹하고 Anthropic에 보고하는 것 같다고 추측했다. CLI가 텍스트 기반임에도 반응이 느릴 때가 있다는 불만도 함께 제기됐다.
- Mac에서 이미지 붙여넣기 단축키가 잘못됐다는 오류 제보가 있었다. 시트에는 CMD+V로 나와 있지만, Mac에서도 Ctrl+V가 맞다는 지적이다(CMD+V는 텍스트 붙여넣기). 또한 '/do 라우터'(https://github.com/notque/claude-code-toolkit)라는 커뮤니티 도구가 소개됐는데, 어떤 명령어를 써야 할지 고민 없이 자동으로 라우팅해주는 방식이라 치트 시트 자체가 필요 없게 만드는 접근법이라는 의견도 있었다.
How to Apply
- Claude Code를 자주 쓰지만 슬래시 명령어나 단축키가 헷갈리는 경우, https://cc.storyfox.cz를 Ctrl+P로 출력해서 모니터 옆에 붙여두거나 북마크해두면 된다. 자동 업데이트되므로 구버전 걱정 없이 최신 기능을 계속 확인할 수 있다.
- CI/CD 파이프라인이나 스크립트에서 Claude Code를 비대화형으로 활용하려면, claude -p "쿼리" --output-format json --max-budget-usd 5 형태로 실행하면 비용 상한을 걸면서 JSON 결과를 받을 수 있다. cat file | claude -p로 파일 내용을 파이프로 넘기는 방식도 유용하다.
- 컨텍스트가 길어지면 /compact [집중할 주제]로 중요한 부분만 압축하고, /btw 명령어로 컨텍스트 비용 없이 빠른 사이드 질문을 처리하면 토큰 낭비를 줄일 수 있다. /context 명령어로 현재 컨텍스트 사용량을 시각화해서 90% 이상 차기 전에 관리하는 습관을 들이면 좋다.
- 여러 기능을 동시에 병렬로 개발할 때 --worktree name 플래그로 기능별 격리된 Git Worktree를 만들고, sparsePaths 설정으로 해당 기능에 필요한 디렉터리만 체크아웃하면 에이전트가 다른 코드를 건드릴 위험 없이 독립적으로 작업하게 할 수 있다.
Code Example
snippet
# 비대화형 모드로 파일 분석 후 JSON 결과 받기
cat myfile.py | claude -p "이 코드의 버그를 찾아줘" --output-format json --max-budget-usd 2
# 세션 이름으로 재개
claude -r "my-session-name"
# 마지막 대화 이어서 시작
claude -c
# 플랜 모드로 시작 (실행 전 검토)
claude --permission-mode plan
# 최소 headless 모드 (hooks/LSP/플러그인 없음)
claude --bare
# 환경변수로 기본 effort 수준 설정
export CLAUDE_CODE_EFFORT_LEVEL=high
export MAX_THINKING_TOKENS=0 # thinking 비활성화
export IS_DEMO=1 # 웰컴 배너 제거
# Git Worktree로 기능별 격리 작업
claude --worktree feature/new-apiTerminology
MCP (Model Context Protocol)Claude가 외부 서버나 도구와 통신하기 위한 표준 프로토콜. 쉽게 말해 Claude에 플러그인을 꽂는 방식으로, HTTP/stdio/SSE 세 가지 방식으로 연결할 수 있다.
Git Worktree하나의 Git 저장소에서 여러 브랜치를 동시에 다른 폴더에 체크아웃해서 작업할 수 있는 기능. Claude 에이전트를 브랜치별로 완전히 격리해서 병렬 실행할 때 유용하다.
CLAUDE.mdClaude Code가 프로젝트 시작 시 자동으로 읽는 마크다운 파일. 팀 규칙, 코드 스타일, 자주 쓰는 명령어 등을 여기 써두면 매번 설명하지 않아도 된다.
headless modeUI나 대화형 인터페이스 없이 백그라운드에서 자동으로 실행되는 모드. CI/CD 파이프라인이나 스크립트에서 Claude Code를 자동화할 때 사용한다.
sparsePathsGit Worktree에서 전체 저장소가 아닌 특정 디렉터리만 체크아웃하는 설정. 큰 모노레포에서 에이전트가 필요한 부분만 보게 해서 속도와 안전성을 높인다.
컨텍스트 압축 (compact)긴 대화 히스토리를 요약해서 토큰 사용량을 줄이는 기능. Claude Code는 컨텍스트가 약 95% 차면 자동으로 압축하며, /compact 명령어로 수동으로 특정 주제에 집중해서 압축할 수 있다.