Anthropic의 공식 문서 기준으로 정리한 Claude Code 메뉴, 슬래시 명령어, 키보드 단축키, CLI 플래그 완벽 가이드입니다. 이 글의 모든 정보는 Claude Code 공식 문서를 직접 확인하여 작성했습니다.
📌 글을 시작하기 전에
Claude Code는 Anthropic이 개발한 터미널 기반 AI 코딩 도구입니다. 일반 채팅 인터페이스(claude.ai)와 달리 명령줄(CLI)에서 직접 실행되며, 프로젝트 파일을 읽고 수정하고 명령어를 실행할 수 있는 에이전트형 도구입니다.
이 글에서는 터미널에서 claude 명령으로 Claude Code를 실행한 직후 사용할 수 있는 모든 메뉴(슬래시 명령어), 키보드 단축키, CLI 플래그를 공식 문서 기준으로 빠짐없이 정리합니다.
⚠️ 참고: Claude Code는 매우 빠르게 업데이트되고 있어, 일부 명령어는 향후 변경되거나 추가될 수 있습니다. 가장 정확한 최신 정보는 항상 Claude Code 공식 명령어 문서에서 확인하시기 바랍니다.
🎯 바쁘신 분을 위한 핵심 5가지
이 글이 길어 보일 수 있지만, 실제로 처음 사용 시 외워야 할 것은 다섯 가지뿐입니다:
/help— 사용 가능한 모든 명령어 목록 보기/clear— 대화 기록을 지우고 컨텍스트 비우기/compact— 컨텍스트가 차오를 때 대화를 압축해 토큰 절약Ctrl+C— 현재 입력이나 생성 취소 (Ctrl+D는 세션 자체 종료)Shift+Tab— 권한 모드 빠른 전환 (default↔acceptEdits↔plan↔auto)
1. Claude Code 시작하기
1-1. 설치
Claude Code는 다음 두 가지 방법으로 설치할 수 있습니다 (공식 설치 가이드):
# 방법 1: 공식 설치 스크립트 (macOS / Linux / WSL)
curl -fsSL https://claude.ai/install.sh | sh
# 방법 2: npm으로 설치 (모든 OS)
npm install -g @anthropic-ai/claude-code
# 설치 확인
claude --version
💰 요금제 안내: Claude Code는 Anthropic의 Claude Pro / Max 구독 또는 Anthropic API 키로 사용할 수 있습니다. 일부 기능(예:
auto권한 모드)은 Team, Enterprise, API 요금제에서만 사용 가능하므로 자세한 사항은 공식 문서를 참고하세요.
1-2. 실행
프로젝트 폴더로 이동한 뒤 claude 명령어를 입력하면 인터랙티브 세션이 시작됩니다.
cd your-project
claude
세션이 시작되면 프롬프트 입력창이 나타나며, 여기서 자연어로 명령을 내리거나 슬래시 명령어(/) 를 입력해 메뉴를 사용할 수 있습니다.
2. 슬래시 명령어(/) 완전 정리
세션에서 / 키를 누르면 사용 가능한 모든 명령어 목록이 나타납니다. 알파벳을 추가로 입력하면 필터링됩니다 (예: /co 입력 시 /compact, /config, /copy, /cost, /context 등이 표시됨).
ℹ️ 모든 명령어가 모든 사용자에게 보이는 것은 아닙니다. 플랫폼, 요금제, 환경에 따라 표시 여부가 결정됩니다. 예를 들어
/desktop은 macOS와 Windows에서만,/upgrade는 Pro/Max 요금제에서만 표시됩니다.
표 안에서 <arg>는 필수 인수, [arg]는 선택 인수입니다.
2-1. 세션 관리 명령어
| 명령어 | 설명 |
|---|---|
/clear |
대화 기록 삭제 및 컨텍스트 비우기 (별칭: /reset, /new) |
/compact [instructions] |
대화를 압축하여 컨텍스트 절약 (선택적으로 집중할 주제 지정 가능) |
/context |
현재 컨텍스트 사용량을 컬러 그리드로 시각화 |
/resume [session] |
이전 세션을 ID나 이름으로 재개 (별칭: /continue) |
/rename [name] |
현재 세션 이름 변경 (없으면 자동 생성) |
/branch [name] |
현재 시점에서 대화의 새 분기를 생성 (별칭: /fork) |
/rewind |
코드/대화를 이전 시점으로 되돌리기 (별칭: /checkpoint) - 자세한 내용은 체크포인팅 문서 참조 |
/export [filename] |
현재 대화를 일반 텍스트로 내보내기 |
/copy [N] |
마지막 어시스턴트 응답을 클립보드에 복사 (N은 N번째 이전 응답 지정) |
/exit |
CLI 종료 (별칭: /quit) |
2-2. 모델 및 모드 관련 명령어
| 명령어 | 설명 |
|---|---|
/model [model] |
AI 모델 선택 또는 변경 (좌우 화살표로 추론 강도 조정 가능) |
/effort [low|medium|high|max|auto] |
모델 추론 강도 설정. low/medium/high는 세션 간 유지, max는 현재 세션 한정(Opus 4.6 이상 필요) |
/fast [on|off] |
Fast 모드 토글 |
/permissions |
도구 권한의 허용/요청/거부 규칙 관리 (별칭: /allowed-tools) |
/plan [description] |
프롬프트에서 직접 Plan 모드 진입 |
/sandbox |
Sandbox 모드 토글 (지원 플랫폼 한정) |
2-3. 정보 조회 명령어
| 명령어 | 설명 |
|---|---|
/help |
도움말 및 사용 가능한 명령어 목록 표시 |
/cost |
토큰 사용량 통계 표시 (비용 추적 가이드 참조) |
/usage |
요금제 사용량 한도 및 Rate limit 상태 표시 |
/stats |
일별 사용량, 세션 기록, 연속 사용 일수, 모델 선호도 시각화 |
/insights |
Claude Code 세션을 분석하는 보고서 생성 (프로젝트 영역, 상호작용 패턴, 마찰 지점 등) |
/status |
Settings 인터페이스의 Status 탭 열기 (버전, 모델, 계정, 연결 상태) |
/doctor |
Claude Code 설치 및 설정 진단 (f 키로 자동 수정) |
/release-notes |
변경 로그를 인터랙티브 버전 선택기에서 보기 |
2-4. 설정 및 환경 관련 명령어
| 명령어 | 설명 |
|---|---|
/config |
Settings 인터페이스 열기 (별칭: /settings) |
/theme |
색상 테마 변경 (라이트/다크/색맹 친화/ANSI 테마 포함) |
/color [color|default] |
프롬프트 바 색상 설정 (red, blue, green, yellow, purple, orange, pink, cyan) |
/keybindings |
키바인딩 설정 파일 열기/생성 |
/terminal-setup |
터미널 키바인딩 설정 (Shift+Enter 등) - VS Code, Alacritty, Warp 등에서만 표시 |
/statusline |
Claude Code의 상태줄 설정 |
/memory |
CLAUDE.md 메모리 파일 편집 및 자동 메모리 활성화/비활성화 |
/init |
프로젝트에 CLAUDE.md 가이드 초기화 |
/add-dir <path> |
현재 세션에서 파일 접근을 위한 작업 디렉토리 추가 |
2-5. 확장 기능 관련 명령어
| 명령어 | 설명 |
|---|---|
/agents |
서브에이전트(Agent) 설정 관리 |
/skills |
사용 가능한 스킬 목록 표시 |
/plugin |
Claude Code 플러그인 관리 |
/reload-plugins |
활성 플러그인 재로드 (재시작 없이 변경사항 적용) |
/mcp |
MCP 서버 연결 및 OAuth 인증 관리 |
/hooks |
도구 이벤트에 대한 후크(Hook) 설정 보기 |
/ide |
IDE 통합 관리 및 상태 표시 |
/chrome |
Chrome용 Claude 설정 |
2-6. 작업 흐름 관련 명령어
| 명령어 | 설명 |
|---|---|
/diff |
인터랙티브 diff 뷰어 열기 (커밋되지 않은 변경 + 턴별 diff) |
/btw <question> |
대화 기록에 추가하지 않고 빠른 사이드 질문 하기 |
/loop [interval] [prompt] |
세션이 열린 동안 프롬프트를 반복 실행 (스킬, 별칭: /proactive) - 예약 작업 참조 |
/schedule [description] |
루틴(Routines) 생성/수정/실행 |
/tasks |
백그라운드 작업 목록/관리 (/bashes로도 사용 가능) |
/debug [description] |
현재 세션에서 디버그 로깅 활성화 (스킬) |
2-7. 깃허브 / 협업 관련 명령어
| 명령어 | 설명 |
|---|---|
/install-github-app |
Claude GitHub Actions 앱 설정 |
/install-slack-app |
Claude Slack 앱 설치 (브라우저에서 OAuth 진행) |
/autofix-pr [prompt] |
Claude Code on the Web 세션을 생성해 PR을 모니터링하고 CI 실패/리뷰 코멘트에 대응 (gh CLI 필요) |
/security-review |
현재 브랜치의 변경사항을 보안 취약점 측면에서 분석 (인젝션, 인증 문제, 데이터 노출 등) |
/team-onboarding |
지난 30일간의 사용 기록을 기반으로 팀 온보딩 가이드 생성 |
2-8. 스킬(Skill) 명령어
위 명령어 표에서 "스킬"로 표기된 항목들(/batch, /claude-api, /debug, /loop, /simplify)은 번들 스킬(Bundled Skill)입니다. 스킬은 사용자가 직접 호출할 수도 있고, 상황에 따라 Claude가 자동으로 호출할 수도 있는 프롬프트 기반 가이드입니다. 사용자가 직접 만들 수 있는 스킬과 동일한 메커니즘을 사용합니다.
대표적인 스킬 명령어를 다시 정리하면:
| 명령어 | 설명 |
|---|---|
/batch <instruction> |
코드베이스 전반의 대규모 변경을 병렬로 조율 (5~30개 단위로 분해 후 git worktree에서 각 단위별로 에이전트를 띄워 PR 생성) |
/claude-api |
Claude API 레퍼런스 자료 로드 (Python, TypeScript, Java, Go, Ruby, C#, PHP, cURL 지원). anthropic 또는 @anthropic-ai/sdk를 import하면 자동 활성화됨 |
/simplify [focus] |
최근 변경 파일을 검토하여 코드 재사용성/품질/효율성 개선 (3개 리뷰 에이전트 병렬 실행) |
/debug [description] |
현재 세션에서 디버그 로깅을 활성화하고 디버그 로그를 분석하여 문제 해결 |
/loop [interval] [prompt] |
세션이 열린 동안 프롬프트를 반복 실행 (별칭: /proactive) |
2-9. 계정 / 인증 관련 명령어
| 명령어 | 설명 |
|---|---|
/login |
Anthropic 계정 로그인 |
/logout |
Anthropic 계정 로그아웃 |
/upgrade |
더 높은 요금제로 업그레이드 페이지 열기 |
/privacy-settings |
개인정보 설정 보기/업데이트 (Pro/Max 한정) |
/extra-usage |
Rate limit 도달 시에도 작업을 계속할 수 있도록 추가 사용량 설정 |
/passes |
Claude Code 무료 1주일 친구에게 공유 (자격 있는 계정만 표시) |
2-10. 원격 / 모바일 / 데스크톱 연동
| 명령어 | 설명 |
|---|---|
/desktop |
현재 세션을 Claude Code Desktop 앱에서 계속 (macOS, Windows 한정, 별칭: /app) |
/mobile |
Claude 모바일 앱 다운로드 QR 코드 표시 (별칭: /ios, /android) |
/remote-control |
claude.ai에서 원격 제어할 수 있도록 세션 공개 (별칭: /rc) |
/remote-env |
--remote로 시작된 웹 세션의 기본 원격 환경 설정 |
/teleport |
Claude Code on the Web 세션을 현재 터미널로 가져오기 (별칭: /tp) |
/ultraplan <prompt> |
Ultraplan 세션에서 계획 작성 후 브라우저에서 검토 |
/web-setup |
로컬 gh CLI 자격 증명을 사용해 GitHub 계정을 Claude Code on the Web에 연결 |
/voice |
음성 받아쓰기 토글 (Claude.ai 계정 필요) |
2-11. 클라우드 제공자 설정
| 명령어 | 설명 |
|---|---|
/setup-bedrock |
Amazon Bedrock 인증/리전/모델 설정 (CLAUDE_CODE_USE_BEDROCK=1 필요) |
/setup-vertex |
Google Vertex AI 인증/프로젝트/리전/모델 설정 (CLAUDE_CODE_USE_VERTEX=1 필요) |
2-12. 기타 명령어
| 명령어 | 설명 |
|---|---|
/feedback [report] |
Claude Code에 대한 피드백 제출 (별칭: /bug) |
/powerup |
애니메이션 데모와 함께 Claude Code 기능을 학습 |
/stickers |
Claude Code 스티커 주문 |
2-13. 제거되거나 변경된 명령어 (참고)
이전 버전에서 사용했던 명령어 중 변경된 항목들입니다. 검색 시 혼란을 줄이기 위해 정리합니다:
| 명령어 | 상태 |
|---|---|
/vim |
v2.1.92에서 제거됨. Vim/Normal 편집 모드 전환은 /config → Editor mode에서 설정 |
/pr-comments |
v2.1.91에서 제거됨. 이전 버전에서는 GitHub PR 댓글을 가져오는 기능이었으나, 현재는 Claude에게 직접 PR 댓글을 보라고 요청하면 됩니다 |
/review |
Deprecated. 대신 code-review 플러그인을 설치 (claude plugin install code-review@claude-plugins-official) |
--enable-auto-mode |
v2.1.111에서 제거됨. Auto 모드는 이제 Shift+Tab 순환에 기본 포함되며, 시작부터 사용하려면 --permission-mode auto 사용 |
3. 키보드 단축키 완전 정리
세션 안에서 ? 키를 누르면 현재 환경에서 사용 가능한 단축키를 볼 수 있습니다 (공식 인터랙티브 모드 문서).
💡 macOS 사용자 주의:
Alt+B,Alt+F,Alt+Y,Alt+M,Alt+P,Alt+T같은 Option/Alt 키 단축키를 사용하려면 터미널에서 Option 키를 Meta로 설정해야 합니다.
- iTerm2: Settings → Profiles → Keys → General → Left/Right Option key를 "Esc+"로 설정
- Apple Terminal: Settings → Profiles → Keyboard → "Use Option as Meta Key" 체크
- VS Code: 설정에서
"terminal.integrated.macOptionIsMeta": true추가- 자세한 내용은 터미널 설정 문서 참조
3-1. 일반 컨트롤
| 단축키 | 동작 |
|---|---|
Ctrl+C |
현재 입력 또는 생성 취소 |
Ctrl+X Ctrl+K |
모든 백그라운드 에이전트 종료 (3초 안에 두 번 누르면 확정) |
Ctrl+D |
Claude Code 세션 종료 (EOF 신호) |
Ctrl+G 또는 Ctrl+X Ctrl+E |
기본 텍스트 에디터에서 열기 |
Ctrl+L |
프롬프트 입력 비우고 화면 다시 그리기 (대화 기록은 유지) |
Ctrl+O |
트랜스크립트 뷰어 토글 (도구 사용 및 실행 상세 표시) |
Ctrl+R |
명령 기록 역방향 검색 |
Ctrl+V (또는 Cmd+V iTerm2 / Alt+V Windows) |
클립보드에서 이미지 붙여넣기 |
Ctrl+B |
실행 중인 작업을 백그라운드로 (tmux 사용자는 두 번 누름) |
Ctrl+T |
작업 목록 토글 |
Left/Right 화살표 |
다이얼로그 탭 순환 |
Up/Down 화살표 또는 Ctrl+P/Ctrl+N |
커서 이동 또는 명령 기록 탐색 |
Esc + Esc |
되감기 또는 요약 (이전 시점으로 코드/대화 복원) |
Shift+Tab 또는 Alt+M |
권한 모드 순환 (default, acceptEdits, plan, auto, bypassPermissions 등) |
Option+P (Mac) / Alt+P (Win/Linux) |
모델 전환 (입력한 프롬프트 보존) |
Option+T / Alt+T |
확장 사고(extended thinking) 모드 토글 |
Option+O / Alt+O |
Fast 모드 토글 |
3-2. 텍스트 편집 단축키
| 단축키 | 동작 |
|---|---|
Ctrl+A |
현재 줄 시작으로 커서 이동 |
Ctrl+E |
현재 줄 끝으로 커서 이동 |
Ctrl+K |
줄 끝까지 삭제 (붙여넣기 가능) |
Ctrl+U |
커서부터 줄 시작까지 삭제 (macOS의 Cmd+Backspace와 동일) |
Ctrl+W |
이전 단어 삭제 (Windows에서는 Ctrl+Backspace도 가능) |
Ctrl+Y |
삭제한 텍스트 붙여넣기 |
Alt+Y (Ctrl+Y 다음) |
붙여넣기 기록 순환 |
Alt+B |
단어 단위로 뒤로 이동 |
Alt+F |
단어 단위로 앞으로 이동 |
3-3. 멀티라인 입력
여러 줄 입력을 하려면 다음 방법을 사용합니다:
| 방법 | 사용 환경 |
|---|---|
\ + Enter |
모든 터미널에서 작동 |
Option+Enter |
macOS에서 Option as Meta 활성화 후 |
Shift+Enter |
iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal에서 기본 작동 |
Ctrl+J |
모든 터미널에서 설정 없이 작동 |
| 직접 붙여넣기 | 코드 블록, 로그 등 |
📝 VS Code, Cursor, Windsurf, Alacritty, Zed 사용자는
/terminal-setup을 한 번 실행하면Shift+Enter바인딩이 설치됩니다.
3-4. 빠른 명령어 진입
| 단축키 | 동작 |
|---|---|
시작에 / |
명령어 또는 스킬 호출 |
시작에 ! |
Bash 모드 진입 (명령어를 직접 실행하고 출력을 컨텍스트에 추가) |
@ |
파일 경로 자동완성 트리거 |
4. CLI 플래그 (실행 시 옵션)
claude 명령어 뒤에 붙이는 플래그로, 실행 시점부터 동작을 제어합니다 (공식 CLI 레퍼런스).
ℹ️
claude --help가 모든 플래그를 보여주지는 않으므로, 도움말에 없다고 해서 사용 불가한 것은 아닙니다.
4-1. 자주 쓰는 CLI 명령어
| 명령어 | 설명 | 예시 |
|---|---|---|
claude |
인터랙티브 세션 시작 | claude |
claude "query" |
초기 프롬프트와 함께 시작 | claude "explain this project" |
claude -p "query" |
SDK 방식으로 한 번 실행 후 종료 | claude -p "explain this function" |
claude -c |
현재 디렉토리의 가장 최근 대화 이어가기 | claude -c |
claude -r "<session>" "query" |
세션 ID나 이름으로 재개 | claude -r "auth-refactor" "Finish this PR" |
claude update |
최신 버전으로 업데이트 | claude update |
claude install [version] |
특정 버전 설치 (예: 2.1.118, stable, latest) |
claude install stable |
claude auth login |
Anthropic 계정 로그인 | claude auth login --console |
claude auth logout |
로그아웃 | claude auth logout |
claude auth status |
인증 상태 확인 (JSON 또는 --text) |
claude auth status |
claude mcp |
MCP 서버 설정 | MCP 문서 참조 |
claude plugin |
플러그인 관리 (별칭: claude plugins) |
claude plugin install code-review@claude-plugins-official |
claude setup-token |
CI/스크립트용 장기 OAuth 토큰 생성 | claude setup-token |
4-2. 주요 CLI 플래그
| 플래그 | 설명 |
|---|---|
--add-dir |
추가 작업 디렉토리 등록 (예: claude --add-dir ../apps ../lib) |
--model |
모델 지정 (예: claude --model claude-sonnet-4-6, 별칭 sonnet/opus 가능) |
--effort |
추론 강도 설정 (low, medium, high, xhigh, max) |
--permission-mode |
권한 모드로 시작 (default, acceptEdits, plan, auto, dontAsk, bypassPermissions) |
--allowedTools |
권한 프롬프트 없이 실행할 도구 지정 |
--disallowedTools |
사용 불가 도구 지정 |
--tools |
사용 가능한 내장 도구 제한 (예: "Bash,Edit,Read") |
--print, -p |
인터랙티브 모드 없이 응답 출력 |
--continue, -c |
가장 최근 대화 로드 |
--resume, -r |
특정 세션 재개 |
--name, -n |
세션 표시 이름 지정 |
--worktree, -w |
격리된 git worktree에서 시작 |
--tmux |
worktree용 tmux 세션 생성 (--worktree 필요) |
--verbose |
상세 로깅 활성화 |
--debug |
디버그 모드 (카테고리 필터링 가능, 예: "api,mcp") |
--debug-file <path> |
디버그 로그를 특정 파일로 기록 |
--mcp-config |
JSON 파일/문자열에서 MCP 서버 로드 |
--strict-mcp-config |
--mcp-config의 MCP 서버만 사용 |
--bare |
최소 모드 (훅, 스킬, 플러그인, MCP, 자동 메모리, CLAUDE.md 자동 발견 생략) |
--ide |
유효한 IDE가 정확히 하나일 때 자동 연결 |
--init |
초기화 훅 실행 후 인터랙티브 모드 시작 |
--init-only |
초기화 훅만 실행 후 종료 |
--max-turns |
에이전트 턴 수 제한 (print 모드 한정) |
--max-budget-usd |
최대 지출액 제한 (print 모드 한정) |
--output-format |
출력 형식 (text, json, stream-json) |
--input-format |
입력 형식 (text, stream-json) |
--fallback-model |
기본 모델 과부하 시 폴백 모델 (print 모드 한정) |
--fork-session |
재개 시 새 세션 ID 생성 (--resume/--continue와 함께) |
--from-pr |
특정 PR과 연결된 세션 재개 |
--remote |
claude.ai에 새 웹 세션 생성 |
--teleport |
웹 세션을 로컬 터미널로 가져오기 |
--remote-control, --rc |
원격 제어 활성화 상태로 시작 |
--chrome / --no-chrome |
Chrome 통합 활성화/비활성화 |
--agent |
에이전트 지정 |
--agents |
JSON으로 커스텀 서브에이전트 동적 정의 |
--plugin-dir |
디렉토리에서 플러그인 로드 |
--settings |
Settings JSON 파일/문자열 로드 |
--setting-sources |
로드할 설정 소스 (user, project, local) |
--session-id |
특정 UUID로 세션 시작 |
--no-session-persistence |
세션을 디스크에 저장하지 않음 (print 모드 한정) |
--dangerously-skip-permissions |
권한 프롬프트 모두 건너뛰기 (--permission-mode bypassPermissions와 동일) |
--allow-dangerously-skip-permissions |
bypassPermissions를 Shift+Tab 모드 순환에 추가 (시작은 다른 모드로) |
--version, -v |
버전 출력 |
4-3. 시스템 프롬프트 플래그
Claude Code는 시스템 프롬프트를 커스터마이징하는 4가지 플래그를 제공합니다.
| 플래그 | 동작 |
|---|---|
--system-prompt |
기본 프롬프트를 통째로 교체 |
--system-prompt-file |
파일 내용으로 교체 |
--append-system-prompt |
기본 프롬프트 뒤에 추가 |
--append-system-prompt-file |
파일 내용을 기본 프롬프트 뒤에 추가 |
📌 추천: 대부분의 경우
--append-system-prompt계열 플래그를 사용하세요. Claude Code의 내장 기능을 보존하면서 요구사항만 추가할 수 있습니다.
5. Bash 모드와 파일 멘션 활용
5-1. ! 접두사로 Bash 명령 직접 실행
프롬프트 시작에 !을 붙이면 Claude를 거치지 않고 명령어를 즉시 실행하고, 출력을 대화 컨텍스트에 추가합니다.
! npm test
! git status
! ls -la
특징:
- 명령어와 출력을 대화 컨텍스트에 추가
- 실시간 진행 상황 및 출력 표시
Ctrl+B로 백그라운드 전환 가능- Tab 키로 이전
!명령어 자동완성 Escape,Backspace,Ctrl+U로 종료
5-2. @로 파일 경로 자동완성
@ 키를 누르면 파일 경로 자동완성이 트리거됩니다. 예: @src/components/Header.tsx 이 파일의 반응형 레이아웃을 고쳐줘
이 방법은 Claude에게 파일 위치를 설명하거나 검색을 기다리는 것보다 훨씬 빠릅니다.
6. 백그라운드 작업
Claude Code는 긴 시간이 걸리는 명령어를 백그라운드에서 실행할 수 있습니다.
백그라운드로 보내는 두 가지 방법:
- Claude에게 백그라운드 실행을 요청
- 일반 Bash 도구 실행 중
Ctrl+B누르기 (tmux 사용자는 두 번)
주요 특징:
- 출력은 파일에 기록되며 Claude가 Read 도구로 가져올 수 있음
- 각 작업에 고유 ID 부여
- Claude Code 종료 시 자동 정리
- 출력이 5GB를 초과하면 자동 종료
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1환경변수로 비활성화 가능
자주 백그라운드에서 실행되는 명령어: 빌드 도구(webpack, vite, make), 패키지 매니저(npm, yarn, pnpm), 테스트 러너(jest, pytest), 개발 서버, 장시간 프로세스(docker, terraform).
7. Vim 에디터 모드
/config → Editor mode에서 Vim 스타일 편집을 활성화할 수 있습니다.
7-1. 모드 전환
| 명령 | 동작 |
|---|---|
Esc |
NORMAL 모드 진입 |
i / I |
커서 앞 / 줄 시작에서 삽입 |
a / A |
커서 뒤 / 줄 끝에서 삽입 |
o / O |
아래 / 위에 새 줄 열기 |
v / V |
문자 단위 / 줄 단위 비주얼 선택 |
7-2. NORMAL 모드 이동
| 명령 | 동작 |
|---|---|
h/j/k/l |
좌/하/상/우 이동 |
w / e / b |
다음 단어 / 단어 끝 / 이전 단어 |
0 / $ / ^ |
줄 시작 / 줄 끝 / 첫 비공백 문자 |
gg / G |
입력 시작 / 끝 |
f{char} / F{char} |
다음 / 이전 문자로 점프 |
t{char} / T{char} |
다음 / 이전 문자 직전으로 점프 |
; / , |
마지막 f/F/t/T 동작 반복 / 역방향 반복 |
7-3. NORMAL 모드 편집
| 명령 | 동작 |
|---|---|
x |
문자 삭제 |
dd / D |
줄 삭제 / 줄 끝까지 삭제 |
dw/de/db |
단어 / 단어 끝까지 / 뒤로 단어 삭제 |
cc / C |
줄 변경 / 줄 끝까지 변경 |
yy / Y |
줄 복사 |
p / P |
커서 뒤 / 앞에 붙여넣기 |
>> / << |
들여쓰기 / 내어쓰기 |
J |
줄 합치기 |
u / . |
실행 취소 / 마지막 변경 반복 |
7-4. 텍스트 객체 (NORMAL 모드)
d, c, y 같은 연산자와 함께 사용:
| 명령 | 동작 |
|---|---|
iw / aw |
안쪽 / 바깥쪽 단어 |
iW / aW |
안쪽 / 바깥쪽 WORD (공백 구분) |
i" / a" |
안쪽 / 바깥쪽 큰따옴표 |
i' / a' |
안쪽 / 바깥쪽 작은따옴표 |
i( / a( |
안쪽 / 바깥쪽 괄호 |
i[ / a[ |
안쪽 / 바깥쪽 대괄호 |
i{ / a{ |
안쪽 / 바깥쪽 중괄호 |
⚠️ Block-wise 비주얼 모드(
Ctrl+V)는 지원되지 않습니다.
8. 알아두면 유용한 부가 기능
8-0. 권한 모드(Permission Modes) 한눈에 보기
/permissions, --permission-mode, Shift+Tab 등에서 자주 등장하는 권한 모드는 Claude가 도구를 사용할 때 어떤 방식으로 사용자에게 확인을 받을지 결정합니다. 공식 문서에 명시된 모드는 다음과 같습니다:
| 모드 | 동작 | 추천 사용 상황 |
|---|---|---|
default |
파일 읽기는 자동 허용, 편집/명령은 사용자 확인 | 시작 단계, 민감한 작업 |
acceptEdits |
파일 읽기 + 편집 자동 허용, 명령만 확인 | 검토하면서 코드 반복 작업 |
plan |
읽기만 가능, 코드 수정 없이 계획만 작성 | 코드베이스 탐색, 리팩토링 계획 |
auto |
모든 작업을 백그라운드 분류기가 검토 후 자동 처리 (Team/Enterprise/API 요금제 + Sonnet 4.6 또는 Opus 4.6 필요) | 장시간 작업, 프롬프트 피로 감소 |
dontAsk |
사전 승인된 도구만 허용 (그 외는 자동 거부) | 잠긴 환경, CI 파이프라인 |
bypassPermissions |
모든 권한 확인 건너뜀 (.git, .vscode, .idea 등 일부 예외) |
격리된 컨테이너/VM 환경에서만 |
세션 안에서는 Shift+Tab으로 default → acceptEdits → plan → auto 순으로 모드를 순환할 수 있습니다 (auto는 활성화 조건이 충족된 경우에만, bypassPermissions는 시작 시 명시적으로 활성화한 경우에만 순환에 등장). 시작할 때부터 특정 모드로 시작하려면 claude --permission-mode plan처럼 사용합니다.
⚠️ 주의:
bypassPermissions모드는 프롬프트 인젝션이나 의도하지 않은 작업에 대한 보호가 전혀 없으므로 격리된 환경에서만 사용하세요. 백그라운드 안전성 검사는 유지하면서 자동화 수준을 높이고 싶다면auto모드를 사용하는 것이 더 안전합니다.
8-1. 자주 쓰이는 환경 변수
본문에서 언급된 환경 변수들을 한 곳에 정리합니다. 모든 환경 변수의 전체 목록은 공식 환경 변수 문서에서 확인할 수 있습니다:
| 환경 변수 | 용도 |
|---|---|
CLAUDE_CODE_USE_BEDROCK=1 |
Amazon Bedrock 사용 모드 활성화 (/setup-bedrock이 표시됨) |
CLAUDE_CODE_USE_VERTEX=1 |
Google Vertex AI 사용 모드 활성화 (/setup-vertex가 표시됨) |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 |
백그라운드 작업 기능 전체 비활성화 |
CLAUDE_CODE_TASK_LIST_ID |
세션 간 작업 목록 공유 (예: CLAUDE_CODE_TASK_LIST_ID=my-project claude) |
CLAUDE_CODE_NEW_INIT=1 |
/init 실행 시 스킬, 훅, 개인 메모리 파일까지 안내하는 인터랙티브 흐름 사용 |
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false |
프롬프트 자동 제안 기능 비활성화 |
CLAUDE_CODE_SIMPLE |
--bare 플래그 사용 시 자동 설정됨 |
8-2. 트랜스크립트 뷰어 (Ctrl+O)
Ctrl+O로 토글되는 트랜스크립트 뷰어 안에서:
| 단축키 | 동작 |
|---|---|
Ctrl+E |
모든 콘텐츠 표시 토글 |
[ |
전체 대화를 터미널 스크롤백에 기록 (풀스크린 렌더링 필요) |
v |
대화를 임시 파일에 기록하고 $VISUAL/$EDITOR로 열기 |
q, Ctrl+C, Esc |
트랜스크립트 뷰 종료 |
8-3. 명령 기록 검색 (Ctrl+R)
Ctrl+R을 누르면 이전에 입력한 명령을 인터랙티브하게 검색할 수 있습니다:
Ctrl+R로 검색 시작- 검색어 입력
Ctrl+R을 다시 눌러 더 오래된 매치 순환Tab또는Esc로 매치 수락 후 편집,Enter로 즉시 실행Ctrl+C또는 빈 검색에서Backspace로 취소
8-4. 음성 입력
음성 받아쓰기 기능이 활성화되어 있으면 Space를 눌러 사용할 수 있습니다. 길게 누르면 녹음, /voice tap으로 탭 토글 모드 가능. Claude.ai 계정이 필요합니다.
8-5. 세션 요약 (Session recap)
자리를 비웠다가 터미널로 돌아오면 Claude Code가 지금까지의 세션 진행 상황을 한 줄로 요약해 보여줍니다. 마지막 턴 이후 3분 이상 경과하고 터미널이 비포커스 상태일 때 백그라운드에서 생성됩니다. /recap 명령으로도 즉시 생성 가능하며, /config에서 자동 요약을 비활성화할 수 있습니다.
8-6. PR 리뷰 상태
오픈 PR이 있는 브랜치에서 작업 중이면 푸터에 클릭 가능한 PR 링크(예: "PR #446")가 표시됩니다. 색상으로 리뷰 상태를 나타냅니다:
- 🟢 녹색: 승인됨
- 🟡 노란색: 리뷰 대기 중
- 🔴 빨간색: 변경 요청됨
- ⚪ 회색: 초안
- 🟣 보라색: 머지됨
Cmd+click(Mac) / Ctrl+click(Win/Linux)으로 브라우저에서 PR 열기. gh CLI 설치 및 인증(gh auth login)이 필요합니다.
9. MCP 프롬프트
MCP 서버는 명령어로 표시되는 프롬프트를 노출할 수 있습니다. 형식은 /mcp__<server>__<prompt>이며, 연결된 서버에서 동적으로 발견됩니다. 자세한 내용은 MCP 프롬프트를 명령어로 사용하기 문서 참조.
10. 한눈에 보는 추천 워크플로우
처음 Claude Code를 사용하는 분들을 위한 추천 순서입니다:
claude명령으로 세션 시작/init으로 프로젝트에CLAUDE.md생성 (프로젝트 컨텍스트 자동 학습)/help로 사용 가능한 명령어 확인/terminal-setup으로Shift+Enter멀티라인 입력 활성화 (필요한 터미널의 경우)/permissions로 도구 권한 사전 설정/model로 작업에 맞는 모델 선택- 세션 길어지면
/context로 사용량 확인,/compact으로 압축 - 작업 종료 후
/cost또는/stats로 사용량 점검 - 다음 날
claude -c로 이어서 작업
마무리
Claude Code는 단순한 AI 챗봇이 아니라 터미널에 상주하는 코딩 에이전트입니다. 이 글에서 다룬 슬래시 명령어, 키보드 단축키, CLI 플래그를 충분히 활용하면 일반 IDE 환경에서는 어려운 자동화와 워크플로우를 구축할 수 있습니다.
다만 Claude Code는 매우 빠르게 업데이트되고 있어 일부 명령어는 시간이 지나면서 변경되거나 새로 추가될 수 있습니다. 가장 정확하고 최신인 정보는 항상 다음 공식 문서에서 확인하시기 바랍니다:
세션 안에서는 언제든지 /help 를 입력하면 현재 환경에서 사용 가능한 모든 명령어를 즉시 확인할 수 있다는 점도 잊지 마세요.
이 글의 모든 명령어 및 단축키 정보는 2026년 4월 기준 Anthropic 공식 Claude Code 문서에서 직접 확인한 내용입니다.