CLAUDE CODE CHEAT SHEET (단축키, 명령어, 파일 구조 정리)

 

 

 

 

CLAUDE CODE CHEAT SHEET, CLI 명령어 정리

 

Claude Code CLI를 편리하게 사용하기 위한 명령어와 단축키, 파일 구조 정리 시트입니다.

 

키보드 단축키

일반 제어

• Ctrl + C : 현재 실행 중인 명령이나 응답 생성을 즉시 취소
• Ctrl + D : 현재 CLI 세션을 종료
• Ctrl + L : 터미널 화면을 지워 현재 작업에 집중
• Ctrl + O : 출력 상세 수준을 전환 (간략 / 상세 로그)
• Ctrl + R : 이전에 실행한 명령을 히스토리에서 검색
• Ctrl + G : 프롬프트 편집기를 열어 입력을 편집

 

작업 제어

• Ctrl + B : 현재 작업을 백그라운드 실행으로 전환
• Ctrl + T : 실행 중인 작업 목록을 확인하거나 전환
• Ctrl + V : 클립보드에 있는 이미지를 입력에 붙여넣기
• Ctrl + F : 실행 중인 백그라운드 에이전트를 종료 (보안상 두 번 입력 필요)
• Esc : 현재 입력 상태를 초기 상태로 되돌림

 

모드 전환

• Shift + Tab : Claude 권한 모드를 순환 전환 (일반 / 자동 / 계획)
• Alt + P : 현재 사용할 Claude 모델을 변경
• Alt + T : Thinking 모드를 전환하여 더 깊은 추론을 활성화

 

입력 제어

• Enter : 입력
• Ctrl + J, Shift + Enter : 줄바꿈

 

접두사

• / : Claude CLI 내부 명령 실행 (슬래시 명령어)
• ! : bash 쉘 명령을 CLI 내부에서 직접 실행
• @ : 파일이나 경로를 참조하고 자동완성

 

명령어

MCP 서버 관리

• 서버 추가
  • --transport http : 원격 HTTP 기반 MCP 서버 연결 (일반적인 방식)
  • --transport stdio : 로컬 프로세스로 MCP 서버 실행
  • --transport sse : Server-Sent Events 방식의 원격 MCP 서버 연결
• 서버 관리
  • /mcp : MCP 서버 연결과 인증을 관리하는 인터랙티브 UI 실행
  • claude mcp list : 현재 등록된 MCP 서버 목록 확인
  • claude mcp serve : Claude 인스턴스를 MCP 서버로 실행

 

Elicitation Servers

작업 중 사용자에게 추가 입력을 요청할 수 있는 인터랙티브 서버 기능이다.

 

세션 관련

• /clear : 현재 대화 컨텍스트 초기화
• /compact : 이전 대화를 압축해 컨텍스트 사용량 감소
• /resume : 이전 세션을 다시 이어서 실행, 세션 매니저로 진입
  • 세션 선택기 (Session Selector)
    • ↑ ↓ : 저장된 세션 목록을 탐색
    • → ← : 세션 세부 정보 확장 또는 축소
    • P : 선택한 세션 미리보기
    • R : 세션 이름 변경
    • / : 세션 검색
    • A : 모든 프로젝트 세션 표시
    • B : 현재 Git 브랜치 관련 세션 표시
• /rename : 현재 세션 이름 변경
• /branch : 현재 대화를 기반으로 새 브랜치 생성
• /cost : 현재 세션에서 사용된 토큰 및 비용 확인
• /context : 현재 컨텍스트 사용량 확인
• /diff : 코드 변경 차이 비교
• /copy : 결과를 클립보드에 복사
• /export : 대화 내용을 파일로 내보내기

 

설정 관련

• /config : CLI 설정 조회 및 수정
• /model : 사용 중인 Claude 모델 변경
• /fast : 빠른 응답 모드 활성화
• /vim : Vim 스타일 입력 모드 활성화
• /theme : CLI 색상 테마 변경
• /permissions : 권한 모드 변경 (shift + tab도 가능)
  • 권한 모드
    • default : 기본 권한 모드
    • acceptEdits : 코드 수정 자동 허용
    • plan : 실행 전 계획 생성 모드
    • dontAsk : 사용자 확인 없이 실행
    • bypassPermissions : 권한 체크 우회
• /effort : 추론 노력 수준 설정
  • /effort low, /effort medium, /effort high 가 있으며, ultrathink가 최상
• /color : 출력 색상 설정

 

도구 관련

• /init : 프로젝트용 CLAUDE.md 초기화
• /memory : Claude 메모리 파일 관리
• /mcp : MCP 서버 설정 관리
• /hooks : 자동 실행 훅 설정
• /skills : Claude 스킬 관리
• /agents : 에이전트 관리
• /chrome : Chrome 브라우저 연동
• /reload-plugins : 플러그인 재로드

 

특수 명령

• /btw : 현재 대화와 별개의 질문 실행
• /plan : 작업 계획을 생성
• /loop : 반복 작업 실행
• /voice : 음성 입력 모드 활성화
• /doctor : CLI 환경 진단
• /rc : 원격 제어 기능 실행
• /pr-comments : Pull Request 코멘트 확인
• /stats : 사용 통계 확인
• /insights : 분석 정보 확인
• /desktop : 데스크톱 앱 연결
• /remote-control : 원격 제어 기능
• /stickers : 스티커 기능

 

스킬 및 에이전트

• 내장 스킬
  • /simplify : 코드 단순화
  • /batch : 반복 작업 자동화
  • /debug : 디버깅 지원
  • /loop : 반복 실행 작업
  • /claude-api : Claude API 작업 지원

 

메모리 및 파일 구조

CLAUDE.md

• 프로젝트 : ./CLAUDE.md 프로젝트 전용 AI 설정 파일
• 개인 : ~/.claude/CLAUDE.md 개인 전역 설정
• 조직 : /etc/claude-code/Managed 조직 관리 설정

 

규칙 및 임포트

• .claude/rules/*.md : 프로젝트 규칙 파일
• ~/.claude/rules/*.md : 개인 규칙 파일

 

자동 메모리

• ~/.claude/projects/<project>/memory/
  • MEMORY.md : 기본 프로젝트 메모리
  • *.md : 주제별 메모리 파일 : 기능별 저장

 

설정 파일

• ~/.claude/settings.json : 전역(글로벌) 설정
• .claude/settings.json : 프로젝트 설정
• .claude/settings.local.json : 로컬 설정

 

상태 및 인증

• ~/.claude.json : 상태 파일
• .mcp.json : 프로젝트 MCP 서버 설정
  • 핵심 설정 항목
    • modelOverrides : 프로젝트별 모델 오버라이드
    • autoMemoryDirectory : 자동 메모리 저장 위치
    • worktree.sparsePaths : 부분 체크아웃 경로
  • 환경 변수
    • ANTHROPIC_API_KEY : API 인증 키
    • ANTHROPIC_MODEL : 사용할 Claude 모델 지정
    • CLAUDE_CODE_EFFORT_LEVEL : 추론 노력 수준 설정
    • MAX_THINKING_TOKENS : 최대 사고 토큰 수 제한
    • ANTHROPIC_CUSTOM_MODEL_OPTION : 커스텀 모델 옵션
    • CLAUDE_CODE_PLUGIN_SEED_DIR : 플러그인 시드 디렉토리
    • CLAUDE_CODE_MAX_OUTPUT_TOKENS : 최대 출력 토큰 수 제한
    • CLAUDE_CODE_DISABLE_CRON : 크론 작업 비활성화

 

커스텀 스킬

• .claude/skills/<skill-name>.md/ : 프로젝트 스킬
• ~/.claude/skills/<skill-name>.md/ : 개인 스킬
  • 스킬 마크다운 프론트매터
    • description : 스킬 설명
    • allowed-tools : 사용 가능한 도구 목록
    • model : 사용할 모델
    • effort : 추론 깊이
    • context : 컨텍스트 설정
    • $ARGUMENTS : 사용자 입력 전달
    • ${CLAUDE_SKILL_DIR} : 스킬 디렉토리 경로
    • !cmd : 쉘 명령 실행

 

즉, 커스텀 스킬 마크다운은 아래와 같은 형태로 작성됨.

---
description: 스테이징된 변경사항을 분석해서 Conventional Commits 형식의 커밋 메시지를 자동으로 생성합니다.
allowed-tools: bash
model: claude-haiku-4-5
effort: low
---

# Git 커밋 메시지 생성기

## 사전 실행
!git diff --staged

## 역할
너는 Git 커밋 메시지 작성 전문가야.
위에서 실행된 `git diff --staged` 결과를 분석해서
Conventional Commits 규칙에 맞는 커밋 메시지를 작성해줘.

## 커밋 메시지 형식
```

 

서브에이전트

• • .claude/agentss/<agent-name>.md/ : 프로젝트 서브에이전트
  • ~/.claude/agents/<agent-name>.md/ : 개인 서브에이전트
    • 서브에이전트 마크다운 프론트매터
      
      • permissionMode : 권한 모드
      • isolation : 실행 격리
      • memory : 메모리 사용 여부
      • background : 백그라운드 실행
      • maxTurns : 최대 대화 턴
      • SendMessage : 메시지 전송 기능

 

즉, 서브에이전트 마크다운은 아래와 같이 작성되어야 함.

---
name: code-reviewer
description: 코드 리뷰 전문 에이전트. PR 분석 및 개선점 제안.
allowed-tools: read, bash
model: claude-haiku-4-5
---

# 코드 리뷰어
너는 시니어 개발자야. 코드의 가독성, 성능, 보안을 중심으로 리뷰해줘.

 

 

You are all set up.