Claude Code 치트시트

3 days ago 5

Claude Code v2.1.81의 주요 명령어, 단축키, 설정, 환경 변수, MCP 서버 및 에이전트 구성을 정리한 개발자용 요약 문서
새 버전에는 헤드리스 모드(--bare), 채널 미리보기(--channels), effort 프론트매터, /branch 명령, SendMessage 자동 재개 기능이 추가됨
키보드 단축키로 세션 제어, 모드 전환, 입력 관리, 세션 탐색 등을 빠르게 수행할 수 있으며, /·!·@ 접두사로 명령·bash 실행·파일 참조를 지원함
MCP 서버, 슬래시 명령어, 스킬·에이전트 관리, 헤드리스 실행 및 원격 제어로 로컬·프로젝트·사용자 단위의 유연한 자동화 환경 구성 가능
설정 파일과 환경 변수를 통해 모델, 메모리, 권한 모드, 작업 예산 등을 세밀하게 제어할 수 있어 개발 워크플로 최적화에 유용함

키보드 단축키

일반 제어
- Ctrl C 입력/생성 취소, Ctrl D 세션 종료, Ctrl L 화면 지우기, Ctrl O 상세 출력 전환, Ctrl R 히스토리 검색, Ctrl G 프롬프트 편집기 열기
- Ctrl B 백그라운드 실행, Ctrl T 작업 목록 전환, Ctrl V 이미지 붙여넣기, Ctrl F 백그라운드 에이전트 종료(2회 필요), Esc 되돌리기
모드 전환
- Shift Tab 권한 모드 순환, Alt P 모델 전환, Alt T 사고(thinking) 모드 전환
입력 제어
- Enter 빠른 줄바꿈, Ctrl J 제어 시퀀스 줄바꿈
접두사
- / 슬래시 명령, ! 직접 bash 실행, @ 파일 언급 및 자동완성
세션 선택기
- 방향키로 탐색 및 확장/축소, P 미리보기, R 이름 변경, / 검색, A 전체 프로젝트, B 현재 브랜치

서버 추가
- --transport http 원격 HTTP(권장), --transport stdio 로컬 프로세스, --transport sse 원격 SSE
스코프
- 로컬(~/.claude.json), 프로젝트(project.mcp.json), 사용자(~/.claude.json)
관리 명령
- /mcp 인터랙티브 UI, claude mcp list 전체 서버 목록, claude mcp serve CC를 MCP 서버로 실행
Elicitation Servers
- 작업 중 입력 요청 기능(신규)

세션 관련
- /clear, /compact, /resume, /rename, /branch, /cost, /context, /diff, /copy, /export
설정 관련
- /config, /model, /fast, /vim, /theme, /permissions, /effort, /color
도구 관련
- /init, /memory, /mcp, /hooks, /skills, /agents, /chrome, /reload-plugins
특수 명령
- /btw, /plan, /loop, /voice, /doctor, /rc, /pr-comments, /stats, /insights, /desktop, /remote-control, /stickers

CLAUDE.md 위치
- 프로젝트(./CLAUDE.md), 개인(~/.claude/CLAUDE.md), 조직(/etc/claude-code/Managed)
규칙 및 임포트
- .claude/rules/*.md, ~/.claude/rules/*.md, @path/to/file 임포트 가능
자동 메모리
- ~/.claude/projects/<proj>/memory/ 내 MEMORY.md 및 주제별 파일 자동 로드

Plan Mode
- Shift Tab으로 일반→자동→계획 모드 전환, --permission-mode plan으로 시작 가능
Thinking & Effort
- Alt T 사고 모드 전환, "ultrathink" 최대 노력 모드, /effort로 수준 설정(low, med, high)
Git Worktrees
- --worktree로 기능별 분리 브랜치 생성, sparsePaths로 필요한 디렉터리만 체크아웃
Voice Mode
- /voice로 음성 입력 활성화, 스페이스바로 녹음 및 전송, 20개 언어 지원
Context 관리
- /context, /compact로 컨텍스트 최적화, 최대 1M 컨텍스트 지원, CLAUDE.md는 압축 후에도 유지
세션 단축 명령
- claude -c 마지막 대화 이어가기, claude -r "name" 이름으로 재개, /btw로 별도 질문

비대화형 실행
- claude -p "query", --output-format json, --max-budget-usd 비용 제한, 파이프 입력 지원
스케줄링 및 원격
- /loop 주기적 작업, /rc 원격 제어, --remote로 웹 세션 연결

설정 파일
- 사용자(~/.claude/settings.json), 프로젝트(.claude/settings.json), 로컬(.claude/settings.local.json)
- OAuth, MCP, 상태(~/.claude.json), 프로젝트 MCP 서버(.mcp.json)
핵심 설정 항목
- modelOverrides, autoMemoryDirectory, worktree.sparsePaths
환경 변수
- ANTHROPIC_API_KEY, ANTHROPIC_MODEL, CLAUDE_CODE_EFFORT_LEVEL, MAX_THINKING_TOKENS, ANTHROPIC_CUSTOM_MODEL_OPTION, CLAUDE_CODE_PLUGIN_SEED_DIR

내장 스킬
- /simplify, /batch, /debug, /loop, /claude-api
커스텀 스킬 위치
- 프로젝트(.claude/skills/<name>/), 개인(~/.claude/skills/<name>/)
스킬 프론트매터
- description, allowed-tools, model, effort, context, $ARGUMENTS, ${CLAUDE_SKILL_DIR}, !cmd
내장 에이전트
- Explore, Plan, General, Bash
에이전트 프론트매터
- permissionMode, isolation, memory, background, maxTurns, SendMessage(신규 자동 재개)

핵심 명령
- claude, claude "q", claude -p "q", claude -c, claude -r, claude update
주요 플래그
- --model, -w, -n, --add-dir, --agent, --allowedTools, --output-format, --json-schema, --max-turns, --max-budget-usd, --console, --verbose, --bare, --channels, --remote, --chrome
권한 모드
- default, acceptEdits, plan, dontAsk, bypassPermissions
핵심 환경 변수
- ANTHROPIC_API_KEY, ANTHROPIC_MODEL, CLAUDE_CODE_EFFORT_LEVEL, MAX_THINKING_TOKENS, CLAUDE_CODE_MAX_OUTPUT_TOKENS, CLAUDE_CODE_DISABLE_CRON