Claude Code를 사용하다 보면 “이 기능이 어디 있었지?”, “단축키가 뭐였더라?” 같은 순간이 자주 옵니다.
이 글은 Claude Code 최신 버전의 핵심 명령어, 단축키, 설정, MCP 서버, 에이전트 구성까지 한 번에 정리한 치트시트 내용을 바탕으로, 개발자가 실제 작업에서 바로 활용할 수 있도록 구조화한 IT 기술 블로그입니다.
CLI 중심의 워크플로를 쓰는 분들이라면 특히 생산성을 크게 높일 수 있는 내용입니다.
Claude Code란 무엇인가
Claude Code는 CLI 기반 AI 개발 도구로, 코드 작성·분석·리팩토링·자동화 작업을 대화형으로 수행할 수 있도록 설계된 환경입니다.
단순 질의응답을 넘어 에이전트, 스킬, MCP 서버 연동을 통해 실제 개발 워크플로에 깊이 통합되는 것이 특징입니다.
이번 치트시트는 이런 Claude Code의 방대한 기능을 명령어 중심으로 빠르게 참고할 수 있도록 정리한 개발자용 요약 문서입니다.
최신 버전 핵심 업데이트 요약
최근 버전에서 눈에 띄는 변화는 다음과 같습니다.
- 헤드리스 모드(--bare)
UI 없이 비대화형으로 실행 가능 → 자동화·CI 환경에 적합 - MCP 메시지 채널(--channels)
디스코드·텔레그램 등 외부 메시지 전송 지원 - 프론트매터 기반 설정(effort)
스킬·슬래시 명령어에서 사고 수준 제어 - fork → /branch 변경
세션 브랜치 관리 방식 개선 - SendMessage 자동 재개 기능
에이전트 실행 중단 후 자동 이어서 처리
단순한 CLI 도구가 아니라, 자동화와 협업을 고려한 개발 플랫폼으로 진화하고 있다는 점이 핵심입니다.
키보드 단축키로 생산성 높이기
일반 제어 단축키
- Ctrl + C : 입력/생성 취소
- Ctrl + D : 세션 종료
- Ctrl + L : 화면 지우기
- Ctrl + O : 상세 출력 토글
- Ctrl + R : 히스토리 검색
- Ctrl + G : 프롬프트 편집기 열기
작업·백그라운드 제어
- Ctrl + B : 백그라운드 실행
- Ctrl + T : 작업 목록 전환
- Ctrl + F : 백그라운드 에이전트 종료(2회 입력)
모드 전환
- Shift + Tab : 권한 모드 순환
- Alt + P : 모델 전환
- Alt + T : 사고(thinking) 모드 전환
단축키만 익혀도 마우스 없이 빠른 작업 흐름을 만들 수 있습니다.
슬래시 명령어 체계 한눈에 보기
Claude Code는 / 기반 명령어가 매우 강력합니다.
세션 관리
- /clear, /resume, /rename, /branch
- /context, /compact, /diff, /export
설정 관련
- /config, /model, /theme, /permissions
- /effort : 사고 수준(low/med/high) 설정
도구·확장
- /init, /memory, /mcp, /skills, /agents
- /chrome, /reload-plugins
특수 기능
- /plan : 계획 기반 실행
- /loop : 주기적 작업
- /voice : 음성 입력
- /remote-control : 원격 제어
CLI지만 IDE에 가까운 제어 수준을 제공합니다.
MCP 서버와 에이전트 구조 이해하기
MCP 서버란?
Claude Code가 외부 시스템과 연결되는 확장 인터페이스입니다.
- 전송 방식
- http : 원격 HTTP (권장)
- stdio : 로컬 프로세스
- sse : 원격 SSE
- 관리 명령
- /mcp : 인터랙티브 UI
- claude mcp list : 서버 목록
- claude mcp serve : MCP 서버 실행
에이전트와 스킬
- 에이전트: Explore, Plan, General, Bash (내장)
- 스킬: 반복 작업 자동화를 위한 명령 세트
- 프론트매터로 다음 항목 제어 가능
- model, effort, allowed-tools, context
- SendMessage(자동 재개 지원)
이 구조 덕분에 Claude Code는 단발성 도구가 아니라 지속 실행형 작업 파트너가 됩니다.
헤드리스 실행과 자동화 예시
입력 정보 기반으로 가능한 간단한 활용 예시입니다.
claude -p "로그 파일 요약해줘" --output-format json --max-budget-usd 1
- UI 없이 실행
- JSON 결과 출력
- 비용 제한 설정
이 방식은 CI 파이프라인, 스케줄링 작업, 서버 자동 분석에 매우 유용합니다.
설정 파일과 메모리 구조
Claude Code는 컨텍스트 관리가 매우 강력합니다.
- 설정 파일 위치
- 사용자: ~/.claude/settings.json
- 프로젝트: .claude/settings.json
- 메모리 자동 로드
- ~/.claude/projects/<project>/memory/
- 규칙 파일
- .claude/rules/*.md
→ 프로젝트 맥락을 기억하는 AI 환경을 만들 수 있습니다.
이번 Claude Code 치트시트는 단순한 명령어 모음이 아니라,
Claude Code를 ‘어떻게 써야 개발 생산성이 극대화되는지’를 보여주는 실전 가이드입니다.
- 단축키로 작업 속도 향상
- 슬래시 명령으로 세션·컨텍스트 관리
- MCP와 에이전트로 자동화 확장
- 헤드리스 실행으로 CI·서버 작업 통합
앞으로 Claude Code는 개발자의 보조 도구가 아니라, 함께 일하는 에이전트로 자리 잡을 가능성이 큽니다.
이 치트시트를 잘 활용한다면, 복잡한 개발 환경에서도 훨씬 정돈된 워크플로를 만들 수 있을 것입니다.
Claude Code Cheat Sheet — Complete Reference
All Claude Code shortcuts, commands, flags, MCP config, memory files & env vars on one page. Auto-updated daily.
cc.storyfox.cz
