Claude Code 치트 시트 — 키보드 단축키·슬래시 명령어·워크플로우 총정리

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

# 비대화형 모드로 파일 분석 후 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-api

Terminology

관련 논문

• adamsreview: Claude Code용 멀티 에이전트 PR 코드 리뷰 파이프라인

  Claude Code에서 최대 7개의 병렬 서브 에이전트가 각각 다른 관점으로 PR을 리뷰하고, 자동 수정까지 해주는 오픈소스 플러그인이다. 기존 /review나 CodeRabbit보다 실제 버그를 더 많이 잡는다고 주장하지만 커뮤니티에서는 복잡도와 실효성에 대한 회의론도 나왔다.

• Claude를 User Space IP Stack으로 써서 Ping에 응답시키면 얼마나 빠를까?

  Claude Code에게 IP 패킷을 직접 파싱하고 ICMP echo reply를 구성하도록 시켜서 실제로 ping에 응답하게 만든 실험으로, 'Markdown이 곧 코드이고 LLM이 프로세서'라는 아이디어를 네트워크 스택 수준까지 밀어붙인 재미있는 사례다.

• AI Agent를 위한 Git: re_gent

  AI 코딩 에이전트(Claude Code 등)가 수행한 모든 툴 호출을 자동으로 추적하고, 어떤 프롬프트가 어느 코드 줄을 작성했는지 blame까지 가능한 버전 관리 도구다.

• Agent-Native CLI를 위한 설계 원칙 10가지

  AI 에이전트가 CLI 도구를 더 잘 사용할 수 있도록 설계하는 원칙들을 정리한 글로, 에이전트가 CLI를 도구로 활용하는 빈도가 높아지면서 이 설계 방식이 실용적으로 중요해지고 있다.

• Agent-harness-kit: MCP 기반 멀티 에이전트 워크플로우 오케스트레이션 프레임워크

  여러 AI 에이전트가 서로 역할을 나눠 협업할 수 있도록 조율하는 scaffolding 도구로, Vite처럼 설정 없이 빠르게 멀티 에이전트 파이프라인을 구성할 수 있다.

• Tilde.run – AI Agent를 위한 트랜잭션 기반 버전 관리 파일시스템 샌드박스

  AI 에이전트가 실제 프로덕션 데이터를 건드려도 롤백할 수 있는 격리된 샌드박스 환경을 제공하는 도구로, GitHub/S3/Google Drive를 하나의 버전 관리 파일시스템으로 묶어준다.

Related Resources

• https://cc.storyfox.cz
• https://github.com/notque/claude-code-toolkit