⌨️ 키보드 단축키
일반 제어
| 단축키 | 동작 |
|---|---|
| Ctrl+C | 입력/생성 취소 |
| Ctrl+D | 세션 종료 |
| Ctrl+L | 화면 지우기 |
| Ctrl+O | 상세 모드/트랜스크립트 토글 |
| Ctrl+R | 히스토리 역검색 |
| Ctrl+G | 프롬프트를 에디터에서 열기 |
| Ctrl+B | 실행 중인 작업 백그라운드로 |
| Ctrl+T | 작업 목록 토글 |
| Ctrl+V | 이미지 붙여넣기 |
| Ctrl+X, Ctrl+K | 백그라운드 에이전트 종료 |
| Esc, Esc | 되감기 또는 요약 |
모드 전환
| 단축키 | 동작 |
|---|---|
| Shift+Tab | 권한 모드 순환 (일반→자동승인→플랜) |
| Alt+P | 모델 전환 |
| Alt+T | 사고(Thinking) 토글 |
| Alt+O | 빠른 모드(Fast) 토글 NEW |
입력
| 단축키 | 동작 |
|---|---|
| \+Enter | 줄바꿈 (빠른 방법) |
| Ctrl+J | 줄바꿈 (제어 시퀀스) |
프리픽스
| 프리픽스 | 동작 |
|---|---|
/ | 슬래시 명령어 |
! | 직접 bash 실행 |
@ | 파일 멘션 + 자동완성 |
세션 선택기
| 키 | 동작 |
|---|---|
| ↑↓ | 탐색 |
| ←→ | 펼치기/접기 |
| P | 미리보기 |
| R | 이름 변경 |
| / | 검색 |
| A | 전체 프로젝트 |
| B | 현재 브랜치 |
트랜스크립트 모드 (Ctrl+O)
| 키 | 동작 |
|---|---|
| / | 트랜스크립트 검색 |
| N / Shift+N | 다음/이전 일치 |
| Ctrl+E | 전체 표시 토글 |
| Q / Esc | 트랜스크립트 종료 |
⚡ 슬래시 명령어
세션 관리
| 명령어 | 기능 |
|---|---|
/clear | 대화 초기화 |
/compact [초점] | 컨텍스트 압축 |
/resume | 세션 이어하기/전환 |
/rename [이름] | 현재 세션 이름 변경 |
/branch [이름] | 대화 분기 (/fork 별칭) |
/cost | 토큰 사용량 통계 |
/context | 컨텍스트 시각화 (그리드) |
/diff | 인터랙티브 diff 뷰어 |
/copy [N] | 마지막 (또는 N번째) 응답 복사 |
/rewind | 대화/코드 체크포인트 되감기 |
/export | 대화 내보내기 |
설정
| 명령어 | 기능 |
|---|---|
/config | 설정 열기 |
/model [모델] | 모델 전환 (←→로 노력도 조절) |
/fast [on|off] | 빠른 모드 토글 |
/vim | vim 모드 토글 |
/theme | 색상 테마 변경 |
/permissions | 권한 보기/수정 |
/effort [레벨] | 노력도 설정 (low/medium/high/max/auto) |
/keybindings | 키보드 단축키 커스터마이징 |
도구
| 명령어 | 기능 |
|---|---|
/init | CLAUDE.md 생성 |
/memory | CLAUDE.md 파일 편집 |
/mcp | MCP 서버 관리 |
/hooks | 훅 관리 |
/skills | 사용 가능한 스킬 목록 |
/agents | 에이전트 관리 |
/chrome | Chrome 통합 |
/add-dir <경로> | 작업 디렉토리 추가 |
특수 명령어
| 명령어 | 기능 |
|---|---|
/powerup | 인터랙티브 기능 학습 NEW |
/btw <질문> | 사이드 질문 (컨텍스트 비소모) |
/plan [설명] | 플랜 모드 (+ 자동 시작) |
/loop [간격] | 반복 예약 작업 |
/voice | 푸시투톡 음성 (20개 언어) |
/doctor | 설치 진단 |
/pr-comments [PR] | GitHub PR 댓글 가져오기 |
/stats | 사용 기록 및 선호도 |
/insights | 세션 분석 리포트 |
/schedule | 클라우드 예약 작업 |
/security-review | 변경사항 보안 분석 |
/remote-control | claude.ai/code 브리지 (/rc) |
/usage | 요금제 한도 및 사용량 |
/help | 도움말 + 명령어 목록 |
🔌 MCP 서버
서버 추가
| 플래그 | 용도 |
|---|---|
--transport http | 원격 HTTP (권장) |
--transport stdio | 로컬 프로세스 |
--transport sse | 원격 SSE |
범위
| 위치 | 설명 |
|---|---|
~/.claude.json | 로컬 (본인만 사용) |
.mcp.json | 프로젝트 (팀 공유/VCS) |
관리
| 명령어 | 동작 |
|---|---|
/mcp | 인터랙티브 UI |
claude mcp list | 전체 서버 목록 |
claude mcp serve | CC를 MCP 서버로 실행 |
주요 설정: Elicitation(입력 요청), 2KB 도구 설명 제한,
maxResultSizeChars 최대 500K NEW 📁 메모리 & 파일
CLAUDE.md 위치
| 위치 | 범위 |
|---|---|
./CLAUDE.md | 프로젝트 (팀 공유) |
~/.claude/CLAUDE.md | 개인 (모든 프로젝트) |
/etc/claude-code/ | 관리형 (조직 전체) |
규칙 & 가져오기
| 경로 | 용도 |
|---|---|
.claude/rules/*.md | 프로젝트 규칙 |
~/.claude/rules/*.md | 사용자 규칙 |
paths: frontmatter | 경로별 규칙 |
@path/to/file | CLAUDE.md에서 가져오기 |
자동 메모리:
~/.claude/projects/<proj>/memory/에 저장. MEMORY.md + 토픽 파일, 자동 로드 (25KB/200줄 제한). CLAUDE.md는 컨텍스트 압축에서도 유지됩니다! 🧠 워크플로우 & 팁
플랜 모드
| 제어 | 동작 |
|---|---|
| Shift+Tab | 일반 → 자동승인 → 플랜 순환 |
--permission-mode plan | 플랜 모드로 시작 |
사고(Thinking) & 노력도
| 제어 | 동작 |
|---|---|
| Alt+T | 사고 모드 켜기/끄기 |
"ultrathink" | 해당 턴 최대 사고 |
| Ctrl+O | 사고 과정 보기 (상세 모드) |
/effort | ○ low · ◐ medium · ● high · ★ max |
Git Worktree
| 플래그/설정 | 기능 |
|---|---|
--worktree name | 기능별 독립 브랜치 |
isolation: worktree | 에이전트가 자체 워크트리에서 실행 |
sparsePaths | 필요한 디렉토리만 체크아웃 |
/batch | 자동으로 워크트리 생성 |
음성 모드
| 제어 | 기능 |
|---|---|
/voice | 푸시투톡 활성화 |
| Space (길게 누르기) | 녹음, 놓으면 전송 |
| 지원 언어 | 한국어, 영어, 일본어 등 20개 |
컨텍스트 관리
| 명령어 | 기능 |
|---|---|
/context | 사용량 + 최적화 팁 |
/compact [초점] | 초점을 두고 압축 |
| 자동 압축 | ~95% 용량 시 자동 (3회 반복 감지) NEW |
| 1M 컨텍스트 | Opus 4.6 (Max/Team/Enterprise) |
세션 파워 무브
| 명령어/플래그 | 기능 |
|---|---|
claude -c | 마지막 대화 이어하기 |
claude -r "이름" | 이름으로 세션 재개 |
/btw 질문 | 사이드 질문 (컨텍스트 비소모) |
cat file | claude -p | 파이프 입력 |
SDK / 헤드리스
| 플래그 | 기능 |
|---|---|
claude -p "쿼리" | 비대화형 모드 |
--output-format json | 구조화된 출력 |
--max-budget-usd 5 | 비용 상한 |
예약 & 원격
| 명령어 | 기능 |
|---|---|
/loop 5m 메시지 | 반복 작업 |
/rc | 원격 제어 |
--remote | claude.ai 웹 세션 |
⚙️ 설정 & 환경변수
설정 파일
| 파일 | 용도 |
|---|---|
~/.claude/settings.json | 사용자 설정 |
.claude/settings.json | 프로젝트 (공유) |
.claude/settings.local.json | 로컬 전용 |
~/.claude.json | OAuth, MCP, 상태 |
.mcp.json | 프로젝트 MCP 서버 |
managed-settings.d/ | 드롭인 정책 파일 |
주요 설정
| 설정 | 설명 |
|---|---|
modelOverrides | 모델 선택기 → 커스텀 ID 매핑 |
autoMemoryDirectory | 커스텀 메모리 디렉토리 |
worktree.sparsePaths | 스파스 체크아웃 디렉토리 |
hooks: if | 조건부 훅 (권한 규칙 문법) |
hooks: "defer" | 헤드리스 일시정지 → 나중에 재개 |
disableSkillShellExec | 스킬/플러그인 셸 실행 차단 NEW |
주요 환경변수
| 변수 | 용도 |
|---|---|
ANTHROPIC_API_KEY | API 인증 |
ANTHROPIC_MODEL | 기본 모델 선택 |
CLAUDE_CODE_EFFORT_LEVEL | low/medium/high/max/auto |
MAX_THINKING_TOKENS | 0=사고 비활성화 |
CLAUDE_CODE_NO_FLICKER | 대체 화면 렌더링 (=1) NEW |
MCP_CONNECTION_NONBLOCKING | -p에서 MCP 대기 건너뛰기 NEW |
CLAUDECODE | CC 셸 감지 (=1) |
🔧 스킬 & 에이전트
내장 스킬
| 스킬 | 용도 |
|---|---|
/simplify | 코드 리뷰 (3개 병렬 에이전트) |
/batch | 대규모 병렬 변경 (5~30 워크트리) |
/debug [설명] | 디버그 로그로 문제 해결 |
/loop [간격] | 반복 예약 작업 |
/claude-api | API + SDK 레퍼런스 로드 |
커스텀 스킬 위치
| 위치 | 범위 |
|---|---|
.claude/skills/<이름>/ | 프로젝트 스킬 |
~/.claude/skills/<이름>/ | 개인 스킬 |
스킬 Frontmatter
| 필드 | 기능 |
|---|---|
description | 자동 호출 트리거 |
allowed-tools | 권한 프롬프트 건너뛰기 |
model | 스킬용 모델 재정의 |
paths: [글로브] | 경로별 활성화 NEW |
context: fork | 서브에이전트에서 실행 |
$ARGUMENTS | 사용자 입력 플레이스홀더 |
!`cmd` | 동적 컨텍스트 주입 |
플러그인 bin/ | Bash 도구용 실행파일 NEW |
내장 에이전트
| 에이전트 | 설명 |
|---|---|
| Explore | 빠른 읽기 전용 (Haiku) |
| Plan | 플랜 모드용 리서치 |
| General | 모든 도구, 복잡한 작업 |
| Bash | 터미널 별도 컨텍스트 |
에이전트 Frontmatter
| 필드 | 기능 |
|---|---|
permissionMode | default/acceptEdits/plan/dontAsk/bypassPermissions |
isolation: worktree | Git 워크트리에서 실행 |
memory | user|project|local 영속 메모리 |
background: true | 백그라운드 작업 |
maxTurns | 에이전트 턴 수 제한 |
SendMessage | 에이전트 재개 (resume 대체) |
@agent-name | 이름으로 서브에이전트 멘션 NEW |
🖥️ CLI & 플래그
핵심 명령어
| 명령어 | 기능 |
|---|---|
claude | 대화형 모드 |
claude "질문" | 프롬프트와 함께 시작 |
claude -p "질문" | 헤드리스 (비대화형) |
claude -c | 마지막 대화 이어하기 |
claude -r "이름" | 세션 재개 |
claude update | 업데이트 |
주요 플래그
| 플래그 | 기능 |
|---|---|
--model | 모델 설정 |
-w | Git 워크트리 |
-n / --name | 세션 이름 |
--add-dir | 디렉토리 추가 |
--agent | 에이전트 사용 |
--allowedTools | 도구 사전 승인 |
--output-format | json/stream |
--max-turns | 턴 수 제한 |
--max-budget-usd | 비용 상한 |
--effort | low/medium/high/max |
--permission-mode | plan/default/… |
--remote | 웹 세션 |
--bare | 최소 헤드리스 (훅/LSP 없음) |
권한 모드
| 모드 | 설명 |
|---|---|
| default | 매번 확인 프롬프트 |
| acceptEdits | 편집 자동 승인 |
| plan | 읽기 전용 |
| dontAsk | 허용 목록 외 거부 |
| bypassPermissions | 모두 건너뛰기 |