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

관련 논문

• 프로덕션 AI 에이전트를 GPT-5.6으로 마이그레이션: 2.2배 빠르고 27% 저렴

  마케팅 웹사이트를 자동 생성하는 프로덕션 AI 에이전트를 Claude Opus 4.8에서 GPT-5.6 Sol로 전환한 실전 경험담으로, 단순 모델 교체가 아니라 eval 하네스, 툴 스키마, 캐싱, 추론 리플레이까지 손봐야 했던 과정을 구체적인 수치와 함께 정리했다.

• xAI Grok Build CLI가 xAI 서버로 전송하는 데이터: 네트워크 레벨 분석

  xAI의 공식 코딩 CLI 도구 Grok Build가 사용자 동의 없이 전체 Git 저장소와 .env 시크릿 파일을 xAI 서버로 업로드한다는 사실이 네트워크 트래픽 분석으로 밝혀졌다.

• 중요할 때 기억하라: Long-Horizon 에이전트를 위한 Proactive Memory Agent

  LLM 에이전트가 긴 작업 중 중요한 정보를 잊어버리는 문제를 별도의 메모리 에이전트가 '적절한 타이밍에' 끼어들어 해결하는 방법

• WebSwarm: 깊고 넓은 웹 검색을 위한 재귀적 Multi-Agent Orchestration

  복잡한 웹 검색을 재귀적으로 분해하고 각 노드에 적합한 검색 모드를 동적으로 할당하는 멀티에이전트 프레임워크

• 웹 앱을 리버스 엔지니어링해서 AI Agent 도구로 자동 변환하기

  로그인된 웹 앱의 API 호출을 브라우저에서 감시해 자동으로 MCP 도구로 변환하는 에이전트를 만들었다. 소스 코드나 공식 API 문서 없이도 Jira, Spotify 같은 서비스에 AI 어시스턴트를 붙일 수 있다.

• FableCut – AI 에이전트가 조작할 수 있는 브라우저 기반 비디오 에디터 (zero deps)

  타임라인 전체를 JSON 파일 하나로 표현하고 MCP/REST로 AI 에이전트가 직접 편집할 수 있는 브라우저 비디오 에디터로, Claude 같은 AI가 프롬프트 하나로 영상을 자동 컷편집하고 결과를 실시간으로 UI에 반영해준다.

Related Resources

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