Claude Code 클로드코드 단축키 효율적 사용 가이드

슬래시 명령어 (자주 사용)

핵심 명령어

| /clear | 대화 이력 삭제 (컨텍스트 초기화) | 새 작업 시작할 때 |

| /compact [지시] | 대화 요약/압축 | 컨텍스트 60% 이상일 때

| /cost | 토큰 사용량/비용 | 비용 확인할 때 |

| /context | 컨텍스트 사용률 시각화 | 얼마나 썼나 확인 |

| /rewind | 코드/대화 이전 상태로 복원 | 실수했을 때 |

설정/세션 명령어

| /config | 설정 인터페이스 |

| /init | CLAUDE.md 초기화 |

| /memory`| CLAUDE.md 편집 |

|/model| AI 모델 선택 |

|/permissions| 권한 설정 |

|/plan\ | 플랜 모드 진입 |

세션 관리

| /rename <이름> | 세션 이름 지정 |

| /resume [세션명] | 이전 세션 복구 |

| /export [파일명] | 대화 내보내기 |

MCP/에이전트

| /agents | 서브에이전트 관리 |

| /mcp | MCP 서버 설정/인증 |

| /hooks | 훅 설정 |

| /tasks | 백그라운드 작업 관리 |

| /todos | TODO 목록 |

기타

| /help | 도움말 |

| /stats | 사용량 통계 |

| /theme | 테마 변경 |

| /vim | Vim 모드 |

| /doctor | 설치 상태 진단 |

| /bug | 버그 보고 |

키보드 단축키

필수 단축키

| Esc + Esc | 이전 상태로 복원 (/rewind와 동일) | ★★★ |

| Ctrl+C | 입력/생성 취소 | ★★★ |

| Ctrl+R | 명령 이력 검색 | ★★★ |

| Shift+Tab | 권한 모드 전환 (Auto↔Plan↔Normal) | ★★☆ |

| Ctrl+B | 작업을 백그라운드로 이동 | ★★☆ |

편집 단축키

| Ctrl+L | 화면 지우기 (이력 유지) |

| Ctrl+G | 외부 에디터로 프롬프트 편집 |

| Ctrl+K | 커서~줄끝 삭제 |

| Ctrl+U | 전체 라인 삭제 |

| Ctrl+Y | 삭제한 텍스트 붙여넣기 |

모델/기능 전환

| Alt+P | 모델 전환 (프롬프트 유지) |

| Alt+T | Extended Thinking 토글 |

| Ctrl+O | 상세 출력 토글 |

멀티라인 입력

| \ + Enter | 모든 터미널 |

| Shift+Enter | iTerm2, WezTerm 등 |

| Ctrl+J | 라인 피드 |

빠른 접두사

| / | 슬래시 명령어 | /compact |

| ! | Bash 직접 실행 | !git status |

| @ | 파일 경로 참조 | @src/app.py |

컨텍스트 관리 (핵심!)

왜 중요한가?

컨텍스트 = 입력 토큰 = 비용
컨텍스트가 커지면 성능 저하
95% 도달 시 자동 압축 (정보 손실 가능)

언제 `/compact` 하나?


60% 이상 → /compact 권장

80% 이상 → /compact 필수

95% 이상 → 자동 압축 발생

`/compact` 사용법


/compact                                    # 기본 압축

/compact 코드 변경사항과 에러만 유지해줘      # 지시와 함께

컨텍스트 절약 팁

1. 파일 읽기 최적화


# 좋음 ✓

@src/app.py:100-150    # 특정 라인만 참조

grep "error" logs.txt | head -20   # 필터링

  
# 나쁨 ✗

전체 파일 읽어줘      # 불필요한 컨텍스트 증가

2. Explore 에이전트 활용


"Explore 에이전트로 인증 모듈 분석해줘"

→ 탐색 결과가 메인 컨텍스트와 분리됨

3. MCP 도구 최적화

안 쓰는 MCP 서버 비활성화
/mcp에서 필요한 것만 활성화

에이전트(Sub-agent) 활용

내장 에이전트

| Explore | 코드 탐색/분석 | 읽기 전용, Haiku 사용, 빠름 |

| Plan | 전략 수립 | Shift+Tab으로 진입 |

| General | 복잡한 작업 | 모든 도구 사용 가능 |

언제 에이전트를 쓰나?

✓ 코드베이스 탐색 → Explore

✓ 복잡한 구현 설계 → Plan 모드

✓ 여러 파일 동시 작업 → General

✗ 단순 파일 수정 → 직접 처리

✗ 간단한 질문 → 직접 처리

커스텀 에이전트


/agents   # 에이전트 관리 UI

위치:

개인용: ~/.claude/agents/
프로젝트용: .claude/agents/

토큰/비용 절약

비용 확인


/cost      # 현재 세션 비용

/stats     # 전체 사용량 통계

모델 선택

| Haiku | 빠른 작업, 서브에이전트 | 최저 |

| Sonnet | 일반 작업 | 중간 |

| Opus | 복잡한 추론 | 최고 |


/model   # 모델 변경

Extended Thinking 조정


# 간단한 작업엔 비활성화

MAX_THINKING_TOKENS=0 claude

  

# 또는 적당히 제한

MAX_THINKING_TOKENS=8000 claude

절약 체크리스트

60% 이상이면 /compact
탐색 작업은 Explore 에이전트 사용
큰 파일은 필요한 부분만 읽기
단순 작업은 Haiku/Sonnet 사용
안 쓰는 MCP 서버 비활성화

설정 파일

CLAUDE.md (프로젝트 지침)

위치 (우선순위순):

./CLAUDE.local.md - 개인용 (gitignore)
./.claude/CLAUDE.md - 프로젝트 공유
./CLAUDE.md - 프로젝트 루트
~/.claude/CLAUDE.md - 전역 (모든 프로젝트)

편집:


/memory   # 또는 /init

settings.json (권한)

위치:

사용자: ~/.claude/settings.json
프로젝트: .claude/settings.json
로컬: .claude/settings.local.json

권한 예시:


{

  "permissions": {

    "allow": ["Bash(npm run:*)"],

    "deny": ["Bash(rm -rf:*)"]

  }

}

Hooks (자동화)

주요 이벤트

이벤트

시점

용도

`PreToolUse`

도구 실행 전

명령어 차단/검증

`PostToolUse`

도구 실행 후

자동 포맷팅

`UserPromptSubmit`

사용자 입력 후

입력 전처리

### 설정


/hooks   # 대화형 설정

예시: 자동 포맷팅


{

  "hooks": {

    "PostToolUse": [{

      "matcher": "Edit|Write",

      "hooks": [{

        "type": "command",

        "command": "prettier --write \"${file_path}\""

      }]

    }]

  }

}

자주 쓰는 패턴

새 작업 시작


/clear                    # 컨텍스트 초기화

# 또는

/compact 이전 내용 삭제    # 압축 후 시작

실수 복구


Esc + Esc                 # 이전 상태로 복원

# 또는

/rewind

복잡한 작업 전


Shift+Tab                 # Plan 모드 진입

# 계획 수립 후 실행

긴 작업 중


Ctrl+B                    # 백그라운드로 이동

/tasks                    # 상태 확인

탐색 작업


"Explore 에이전트로 ~~ 분석해줘"

비용 확인


/cost                     # 현재 비용

/context                  # 컨텍스트 사용률

환경변수 (고급)


# 조기 자동 압축 (50%에서)

export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=50

  

# Extended Thinking 제한

export MAX_THINKING_TOKENS=8000

  

# MCP 도구 자동 검색

export ENABLE_TOOL_SEARCH=auto:5

  

# MCP 출력 제한

export MAX_MCP_OUTPUT_TOKENS=50000

문제 해결

"컨텍스트가 너무 큽니다"

→ /compact 실행

"명령이 실행되지 않음"

→ /permissions 확인

"MCP 서버 연결 안 됨"

→ /mcp에서 인증 확인

"이전 상태로 돌아가고 싶음"

→ Esc+Esc 또는 /rewind

"설치 문제"

→ /doctor 실행

빠른 참조 카드

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Claude Code 빠른 참조

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


  Esc+Esc     실수 복구

  Ctrl+C      취소

  Ctrl+R      이력 검색

  Shift+Tab   Plan 모드

  Ctrl+B      백그라운드

  
  /clear      초기화

  /compact    압축

  /cost       비용

  /rewind     복원

  /model      모델 변경


  !command    Bash 직접 실행

  @file       파일 참조

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

마지막 업데이트: 2026-01-21

슬래시 명령어 (자주 사용)

핵심 명령어

설정/세션 명령어

세션 관리

MCP/에이전트

기타

키보드 단축키

필수 단축키

편집 단축키

모델/기능 전환

멀티라인 입력

빠른 접두사

컨텍스트 관리 (핵심!)

왜 중요한가?

언제 /compact 하나?

/compact 사용법

컨텍스트 절약 팁

에이전트(Sub-agent) 활용

내장 에이전트

언제 에이전트를 쓰나?

커스텀 에이전트

토큰/비용 절약

비용 확인

모델 선택

Extended Thinking 조정

절약 체크리스트

설정 파일

CLAUDE.md (프로젝트 지침)

settings.json (권한)

Hooks (자동화)

주요 이벤트

예시: 자동 포맷팅

자주 쓰는 패턴

새 작업 시작

실수 복구

복잡한 작업 전

긴 작업 중

탐색 작업

비용 확인

환경변수 (고급)

문제 해결

"컨텍스트가 너무 큽니다"

"명령이 실행되지 않음"

"MCP 서버 연결 안 됨"

"이전 상태로 돌아가고 싶음"

"설치 문제"

빠른 참조 카드

언제 `/compact` 하나?

`/compact` 사용법