22. 인터랙티브 모드
키보드 단축키·슬래시 명령어·Vim 모드 등 대화형 조작 레퍼런스
인터랙티브 모드
Claude Code 세션에서 사용할 수 있는 키보드 단축키, 입력 모드, 인터랙티브 기능에 대한 전체 참고 문서입니다.
키보드 단축키
참고:
키보드 단축키는 플랫폼과 터미널에 따라 다를 수 있습니다.
?를 눌러 현재 환경에서 사용 가능한 단축키를 확인하세요.macOS 사용자: Option/Alt 키 단축키(
Alt+B,Alt+F,Alt+Y,Alt+M,Alt+P)를 사용하려면 터미널에서 Option 키를 Meta로 설정해야 합니다:
- iTerm2: 설정 → Profiles → Keys → Left/Right Option key를 "Esc+"로 설정
- Terminal.app: 설정 → Profiles → Keyboard → "Use Option as Meta Key" 체크
- VS Code: 설정 → Profiles → Keys → Left/Right Option key를 "Esc+"로 설정
자세한 내용은 터미널 설정을 참고하세요.
일반 제어
| 단축키 | 설명 | 컨텍스트 |
|---|---|---|
Ctrl+C | 현재 입력 또는 생성 취소 | 표준 인터럽트 |
Ctrl+F | 모든 백그라운드 에이전트 종료. 3초 이내에 두 번 눌러 확인 | 백그라운드 에이전트 제어 |
Ctrl+D | Claude Code 세션 종료 | EOF 시그널 |
Ctrl+G | 기본 텍스트 에디터에서 열기 | 기본 텍스트 에디터에서 프롬프트 또는 커스텀 응답 편집 |
Ctrl+L | 터미널 화면 지우기 | 대화 기록은 유지됨 |
Ctrl+O | 상세 출력 토글 | 자세한 도구 사용 및 실행 내용 표시 |
Ctrl+R | 명령어 기록 역방향 검색 | 이전 명령어를 인터랙티브하게 검색 |
Ctrl+V 또는 Cmd+V (iTerm2) 또는 Alt+V (Windows) | 클립보드에서 이미지 붙여넣기 | 이미지 또는 이미지 파일 경로를 붙여넣기 |
Ctrl+B | 실행 중인 작업을 백그라운드로 전환 | bash 명령어와 에이전트를 백그라운드로 전환. Tmux 사용자는 두 번 누르세요 |
Ctrl+T | 작업 목록 토글 | 터미널 상태 영역에서 작업 목록 표시 또는 숨기기 |
Left/Right arrows | 대화 상자 탭 간 이동 | 권한 대화 상자 및 메뉴에서 탭 간 이동 |
Up/Down arrows | 명령어 기록 탐색 | 이전 입력 불러오기 |
Esc + Esc | 되돌리기 또는 요약 | 코드 및/또는 대화를 이전 시점으로 복원하거나, 선택한 메시지부터 요약 |
Shift+Tab 또는 Alt+M (일부 설정) | 권한 모드 토글 | Auto-Accept 모드, Plan 모드, 일반 모드 간 전환 |
Option+P (macOS) 또는 Alt+P (Windows/Linux) | 모델 전환 | 프롬프트를 지우지 않고 모델 전환 |
Option+T (macOS) 또는 Alt+T (Windows/Linux) | 확장 사고 토글 | 확장 사고 모드 활성화 또는 비활성화. 이 단축키를 활성화하려면 먼저 /terminal-setup을 실행하세요 |
텍스트 편집
| 단축키 | 설명 | 컨텍스트 |
|---|---|---|
Ctrl+K | 줄 끝까지 삭제 | 삭제된 텍스트는 붙여넣기용으로 저장됨 |
Ctrl+U | 전체 줄 삭제 | 삭제된 텍스트는 붙여넣기용으로 저장됨 |
Ctrl+Y | 삭제된 텍스트 붙여넣기 | Ctrl+K 또는 Ctrl+U로 삭제된 텍스트 붙여넣기 |
Alt+Y (Ctrl+Y 이후) | 붙여넣기 기록 순환 | 붙여넣기 후 이전에 삭제된 텍스트를 순환. macOS에서는 Option as Meta 설정 필요 |
Alt+B | 커서를 한 단어 뒤로 이동 | 단어 단위 이동. macOS에서는 Option as Meta 설정 필요 |
Alt+F | 커서를 한 단어 앞으로 이동 | 단어 단위 이동. macOS에서는 Option as Meta 설정 필요 |
테마 및 표시
| 단축키 | 설명 | 컨텍스트 |
|---|---|---|
Ctrl+T | 코드 블록 구문 강조 토글 | /theme 선택기 메뉴 내에서만 작동. Claude 응답의 코드에 구문 색상을 적용할지 제어 |
참고: 구문 강조는 Claude Code의 네이티브 빌드에서만 사용 가능합니다.
멀티라인 입력
| 방법 | 단축키 | 컨텍스트 |
|---|---|---|
| 빠른 이스케이프 | \ + Enter | 모든 터미널에서 작동 |
| macOS 기본 | Option+Enter | macOS에서 기본값 |
| Shift+Enter | Shift+Enter | iTerm2, WezTerm, Ghostty, Kitty에서 별도 설정 없이 작동 |
| 제어 시퀀스 | Ctrl+J | 멀티라인용 줄바꿈 문자 |
| 붙여넣기 모드 | 직접 붙여넣기 | 코드 블록, 로그 등에 사용 |
팁: Shift+Enter는 iTerm2, WezTerm, Ghostty, Kitty에서 별도 설정 없이 작동합니다. 다른 터미널(VS Code, Alacritty, Zed, Warp)에서는
/terminal-setup을 실행하여 키 바인딩을 설치하세요.
빠른 명령어
| 단축키 | 설명 | 참고 |
|---|---|---|
/ (맨 앞) | 명령어 또는 스킬 | 내장 명령어 및 스킬 참고 |
! (맨 앞) | Bash 모드 | 명령어를 직접 실행하고 실행 결과를 세션에 추가 |
@ | 파일 경로 멘션 | 파일 경로 자동 완성 트리거 |
내장 명령어
Claude Code에서 /를 입력하면 사용 가능한 모든 명령어를 볼 수 있으며, / 뒤에 글자를 입력하면 필터링할 수 있습니다. 모든 명령어가 모든 사용자에게 표시되는 것은 아닙니다. 일부는 플랫폼, 요금제, 환경에 따라 다릅니다. 예를 들어 /desktop은 macOS와 Windows에서만 표시되고, /upgrade와 /privacy-settings는 Pro 및 Max 요금제에서만 사용 가능하며, /terminal-setup은 터미널이 기본적으로 키 바인딩을 지원하는 경우 숨겨집니다.
Claude Code에는 /simplify, /batch, /debug 같은 번들 스킬도 포함되어 있으며, /를 입력할 때 내장 명령어와 함께 표시됩니다. 직접 명령어를 만들려면 스킬을 참고하세요.
아래 표에서 <arg>는 필수 인자를, [arg]는 선택적 인자를 나타냅니다.
| 명령어 | 용도 |
|---|---|
/add-dir <path> | 현재 세션에 새 작업 디렉토리 추가 |
/agents | 에이전트 설정 관리 |
/chrome | Chrome에서 Claude 설정 구성 |
/clear | 대화 기록을 지우고 컨텍스트 확보. 별칭: /reset, /new |
/compact [instructions] | 선택적 포커스 지시사항과 함께 대화 압축 |
/config | 설정 인터페이스 열기 (Config 탭). 별칭: /settings |
/context | 현재 컨텍스트 사용량을 컬러 그리드로 시각화 |
/copy | 마지막 어시스턴트 응답을 클립보드에 복사. 코드 블록이 있는 경우 개별 블록 또는 전체 응답을 선택하는 인터랙티브 선택기 표시 |
/cost | 토큰 사용 통계 표시. 구독별 세부 정보는 비용 추적 가이드 참고 |
/desktop | 현재 세션을 Claude Code Desktop 앱에서 계속. macOS 및 Windows 전용. 별칭: /app |
/diff | 커밋되지 않은 변경사항과 턴별 diff를 보여주는 인터랙티브 diff 뷰어 열기. 좌/우 화살표로 현재 git diff와 개별 Claude 턴 간 전환, 위/아래로 파일 탐색 |
/doctor | Claude Code 설치 및 설정 진단 및 확인 |
/exit | CLI 종료. 별칭: /quit |
/export [filename] | 현재 대화를 일반 텍스트로 내보내기. 파일명을 지정하면 해당 파일에 직접 저장. 없으면 클립보드에 복사하거나 파일로 저장하는 대화 상자 표시 |
/extra-usage | 속도 제한에 도달했을 때 계속 작업할 수 있도록 추가 사용량 설정 |
/fast [on|off] | 빠른 모드 켜기 또는 끄기 |
/feedback [report] | Claude Code에 대한 피드백 제출. 별칭: /bug |
/fork [name] | 현재 시점에서 대화 포크 생성 |
/help | 도움말 및 사용 가능한 명령어 표시 |
/hooks | 도구 이벤트에 대한 훅 설정 관리 |
/ide | IDE 통합 관리 및 상태 표시 |
/init | CLAUDE.md 가이드로 프로젝트 초기화 |
/insights | Claude Code 세션을 분석하여 프로젝트 영역, 상호작용 패턴, 마찰 지점 등의 보고서 생성 |
/install-github-app | 저장소에 Claude GitHub Actions 앱 설정. 저장소 선택 및 통합 구성 과정을 안내 |
/install-slack-app | Claude Slack 앱 설치. 브라우저를 열어 OAuth 흐름 완료 |
/keybindings | 키 바인딩 설정 파일 열기 또는 생성 |
/login | Anthropic 계정에 로그인 |
/logout | Anthropic 계정에서 로그아웃 |
/mcp | MCP 서버 연결 및 OAuth 인증 관리 |
/memory | CLAUDE.md 메모리 파일 편집, 자동 메모리 활성화/비활성화, 자동 메모리 항목 보기 |
/mobile | Claude 모바일 앱 다운로드용 QR 코드 표시. 별칭: /ios, /android |
/model [model] | AI 모델 선택 또는 변경. 지원하는 모델의 경우 좌/우 화살표로 노력 수준 조절. 현재 응답 완료를 기다리지 않고 즉시 변경 적용 |
/output-style [style] | 출력 스타일 간 전환. Default는 표준 동작, Explanatory는 구현 선택과 코드베이스 패턴에 대한 교육적 인사이트 추가, Learning은 직접 코드를 작성해보도록 멈추는 실습 모드. 커스텀 출력 스타일 만들기도 가능 |
/passes | 친구에게 Claude Code 무료 1주일 공유. 계정이 자격이 있는 경우에만 표시 |
/permissions | 권한 보기 또는 업데이트. 별칭: /allowed-tools |
/plan | 프롬프트에서 직접 Plan 모드 진입 |
/plugin | Claude Code 플러그인 관리 |
/pr-comments [PR] | GitHub 풀 리퀘스트의 댓글 가져오기 및 표시. 현재 브랜치의 PR을 자동 감지하거나, PR URL 또는 번호를 전달. gh CLI 필요 |
/privacy-settings | 개인정보 설정 보기 및 업데이트. Pro 및 Max 요금제 구독자만 사용 가능 |
/release-notes | 전체 변경 로그 보기, 가장 최신 버전이 프롬프트에 가장 가깝게 표시 |
/reload-plugins | 모든 활성 플러그인을 다시 로드하여 대기 중인 변경사항 적용. 재시작 없이 로드된 내용을 보고하고 재시작이 필요한 변경사항을 알림 |
/remote-control | 이 세션을 claude.ai에서 원격 제어 가능하도록 설정. 별칭: /rc |
/remote-env | 텔레포트 세션의 기본 원격 환경 설정 |
/rename [name] | 현재 세션 이름 변경. 이름 없이 사용하면 대화 기록에서 자동 생성 |
/resume [session] | ID 또는 이름으로 대화 재개하거나 세션 선택기 열기. 별칭: /continue |
/review | 코드 품질, 정확성, 보안, 테스트 커버리지에 대해 풀 리퀘스트 검토. PR 번호를 전달하거나, 생략하면 열려 있는 PR 목록 표시. gh CLI 필요 |
/rewind | 대화 및/또는 코드를 이전 시점으로 되돌리거나, 선택한 메시지부터 요약. 체크포인팅 참고. 별칭: /checkpoint |
/sandbox | 샌드박스 모드 토글. 지원되는 플랫폼에서만 사용 가능 |
/security-review | 현재 브랜치의 대기 중인 변경사항에 대한 보안 취약점 분석. git diff를 검토하고 인젝션, 인증 문제, 데이터 노출 등의 위험 식별 |
/skills | 사용 가능한 스킬 목록 표시 |
/stats | 일별 사용량, 세션 기록, 연속 사용, 모델 선호도 시각화 |
/status | 버전, 모델, 계정, 연결 상태를 보여주는 설정 인터페이스(Status 탭) 열기 |
/statusline | Claude Code의 상태 줄 설정. 원하는 내용을 설명하거나, 인자 없이 실행하면 셸 프롬프트에서 자동 설정 |
/stickers | Claude Code 스티커 주문 |
/tasks | 백그라운드 작업 목록 조회 및 관리 |
/terminal-setup | Shift+Enter 및 기타 단축키를 위한 터미널 키 바인딩 설정. VS Code, Alacritty, Warp 등 필요한 터미널에서만 표시 |
/theme | 색상 테마 변경. 라이트 및 다크 변형, 색각 이상 접근성(daltonized) 테마, 터미널 색상 팔레트를 사용하는 ANSI 테마 포함 |
/upgrade | 더 높은 요금제로 전환하기 위한 업그레이드 페이지 열기 |
/usage | 요금제 사용 한도 및 속도 제한 상태 표시 |
/vim | Vim과 일반 편집 모드 간 전환 |
MCP 프롬프트
MCP 서버는 명령어로 표시되는 프롬프트를 노출할 수 있습니다. 이들은 /mcp__<server>__<prompt> 형식을 사용하며 연결된 서버에서 동적으로 검색됩니다. 자세한 내용은 MCP 프롬프트를 참고하세요.
Vim 에디터 모드
/vim 명령어로 vim 스타일 편집을 활성화하거나 /config를 통해 영구적으로 설정할 수 있습니다.
모드 전환
| 명령어 | 동작 | 전환 전 모드 |
|---|---|---|
Esc | NORMAL 모드 진입 | INSERT |
i | 커서 앞에 삽입 | NORMAL |
I | 줄 시작에 삽입 | NORMAL |
a | 커서 뒤에 삽입 | NORMAL |
A | 줄 끝에 삽입 | NORMAL |
o | 아래에 새 줄 열기 | NORMAL |
O | 위에 새 줄 열기 | NORMAL |
이동 (NORMAL 모드)
| 명령어 | 동작 |
|---|---|
h/j/k/l | 좌/하/상/우 이동 |
w | 다음 단어 |
e | 단어 끝 |
b | 이전 단어 |
0 | 줄 시작 |
$ | 줄 끝 |
^ | 첫 번째 비공백 문자 |
gg | 입력 시작 |
G | 입력 끝 |
f{char} | 다음 해당 문자로 이동 |
F{char} | 이전 해당 문자로 이동 |
t{char} | 다음 해당 문자 바로 앞으로 이동 |
T{char} | 이전 해당 문자 바로 뒤로 이동 |
; | 마지막 f/F/t/T 동작 반복 |
, | 마지막 f/F/t/T 동작 역방향 반복 |
참고: vim normal 모드에서 커서가 입력의 시작 또는 끝에 있어 더 이상 이동할 수 없는 경우, 화살표 키로 명령어 기록을 탐색합니다.
편집 (NORMAL 모드)
| 명령어 | 동작 |
|---|---|
x | 문자 삭제 |
dd | 줄 삭제 |
D | 줄 끝까지 삭제 |
dw/de/db | 단어/끝까지/뒤로 삭제 |
cc | 줄 변경 |
C | 줄 끝까지 변경 |
cw/ce/cb | 단어/끝까지/뒤로 변경 |
yy/Y | 줄 복사(yank) |
yw/ye/yb | 단어/끝까지/뒤로 복사 |
p | 커서 뒤에 붙여넣기 |
P | 커서 앞에 붙여넣기 |
>> | 들여쓰기 |
<< | 내어쓰기 |
J | 줄 합치기 |
. | 마지막 변경 반복 |
텍스트 객체 (NORMAL 모드)
텍스트 객체는 d, c, y 같은 연산자와 함께 사용합니다:
| 명령어 | 동작 |
|---|---|
iw/aw | 단어 안/주변 |
iW/aW | WORD 안/주변 (공백으로 구분) |
i"/a" | 큰따옴표 안/주변 |
i'/a' | 작은따옴표 안/주변 |
i(/a( | 괄호 안/주변 |
i[/a[ | 대괄호 안/주변 |
i{/a{ | 중괄호 안/주변 |
명령어 기록
Claude Code는 현재 세션의 명령어 기록을 유지합니다:
- 입력 기록은 작업 디렉토리별로 저장됩니다
/clear로 새 세션을 시작하면 입력 기록이 초기화됩니다. 이전 세션의 대화는 보존되며 재개할 수 있습니다.- 위/아래 화살표로 탐색할 수 있습니다 (위의 키보드 단축키 참고)
- 참고: 기록 확장(
!)은 기본적으로 비활성화되어 있습니다
Ctrl+R을 사용한 역방향 검색
Ctrl+R을 눌러 명령어 기록을 인터랙티브하게 검색할 수 있습니다:
- 검색 시작:
Ctrl+R을 눌러 역방향 기록 검색 활성화 - 검색어 입력: 이전 명령어에서 찾을 텍스트 입력. 검색어는 일치하는 결과에서 강조 표시됨
- 일치 항목 탐색:
Ctrl+R을 다시 눌러 이전 일치 항목으로 이동 - 일치 항목 수락:
Tab또는Esc를 눌러 현재 일치 항목을 수락하고 편집 계속Enter를 눌러 수락하고 명령어 즉시 실행
- 검색 취소:
Ctrl+C를 눌러 취소하고 원래 입력 복원- 빈 검색에서
Backspace를 눌러 취소
검색은 검색어가 강조된 일치하는 명령어를 표시하므로, 이전 입력을 쉽게 찾아 재사용할 수 있습니다.
백그라운드 bash 명령어
Claude Code는 bash 명령어를 백그라운드에서 실행할 수 있어, 오래 걸리는 프로세스가 실행되는 동안 계속 작업할 수 있습니다.
백그라운드 실행 방식
Claude Code가 백그라운드에서 명령어를 실행하면, 비동기적으로 명령어를 실행하고 즉시 백그라운드 작업 ID를 반환합니다. 명령어가 백그라운드에서 계속 실행되는 동안 Claude Code는 새 프롬프트에 응답할 수 있습니다.
백그라운드에서 명령어를 실행하려면 다음 중 하나를 사용하세요:
- Claude Code에 백그라운드에서 명령어를 실행하도록 프롬프트
- Ctrl+B를 눌러 일반 Bash 도구 호출을 백그라운드로 전환. (Tmux 사용자는 tmux의 prefix 키 때문에 Ctrl+B를 두 번 눌러야 합니다.)
주요 기능:
- 출력은 버퍼링되며 Claude는 TaskOutput 도구를 사용하여 출력을 가져올 수 있음
- 백그라운드 작업은 추적 및 출력 검색을 위한 고유 ID를 가짐
- Claude Code 종료 시 백그라운드 작업은 자동으로 정리됨
모든 백그라운드 작업 기능을 비활성화하려면 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 환경 변수를 1로 설정하세요. 자세한 내용은 환경 변수를 참고하세요.
일반적으로 백그라운드로 실행하는 명령어:
- 빌드 도구 (webpack, vite, make)
- 패키지 관리자 (npm, yarn, pnpm)
- 테스트 러너 (jest, pytest)
- 개발 서버
- 장기 실행 프로세스 (docker, terraform)
! 접두사를 사용한 Bash 모드
Claude를 거치지 않고 입력 앞에 !를 붙여 bash 명령어를 직접 실행할 수 있습니다:
! npm test
! git status
! ls -la
Bash 모드:
- 명령어와 출력을 대화 컨텍스트에 추가
- 실시간 진행 상황 및 출력 표시
- 장기 실행 명령어에 대해 동일한
Ctrl+B백그라운드 전환 지원 - Claude가 명령어를 해석하거나 승인할 필요 없음
- 기록 기반 자동 완성 지원: 부분 명령어를 입력하고 Tab을 눌러 현재 프로젝트의 이전
!명령어에서 완성 - 빈 프롬프트에서
Escape,Backspace, 또는Ctrl+U로 종료
대화 컨텍스트를 유지하면서 빠른 셸 작업을 수행할 때 유용합니다.
프롬프트 제안
세션을 처음 열면, 시작에 도움이 되도록 프롬프트 입력에 회색 예시 명령어가 표시됩니다. Claude Code는 프로젝트의 git 기록에서 이를 선택하므로, 최근 작업한 파일을 반영합니다.
Claude가 응답한 후에도 대화 기록에 기반한 제안이 계속 표시됩니다. 예를 들어 여러 단계 요청의 후속 단계나 워크플로우의 자연스러운 연속이 될 수 있습니다.
- Tab을 눌러 제안을 수락하거나, Enter를 눌러 수락하고 제출
- 타이핑을 시작하면 제안이 사라짐
제안은 상위 대화의 프롬프트 캐시를 재사용하는 백그라운드 요청으로 실행되므로, 추가 비용은 최소입니다. Claude Code는 불필요한 비용을 피하기 위해 캐시가 cold 상태일 때 제안 생성을 건너뜁니다.
대화의 첫 번째 턴 이후, 비인터랙티브 모드, Plan 모드에서는 제안이 자동으로 건너뛰어집니다.
프롬프트 제안을 완전히 비활성화하려면 환경 변수를 설정하거나 /config에서 설정을 토글하세요:
export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
작업 목록
복잡한 여러 단계의 작업을 수행할 때, Claude는 진행 상황을 추적하기 위해 작업 목록을 생성합니다. 작업은 터미널의 상태 영역에 대기 중, 진행 중, 완료 상태를 나타내는 표시와 함께 나타납니다.
Ctrl+T를 눌러 작업 목록 보기를 토글합니다. 한 번에 최대 10개의 작업이 표시됩니다- 모든 작업을 보거나 지우려면 Claude에 직접 요청하세요: "show me all tasks" 또는 "clear all tasks"
- 작업은 컨텍스트 압축 후에도 유지되어, 대규모 프로젝트에서 Claude가 체계적으로 작업할 수 있도록 합니다
- 세션 간에 작업 목록을 공유하려면
CLAUDE_CODE_TASK_LIST_ID를 설정하여~/.claude/tasks/에 이름 있는 디렉토리를 사용하세요:CLAUDE_CODE_TASK_LIST_ID=my-project claude - 이전 TODO 목록으로 되돌리려면
CLAUDE_CODE_ENABLE_TASKS=false를 설정하세요.
PR 검토 상태
열린 풀 리퀘스트가 있는 브랜치에서 작업할 때, Claude Code는 하단에 클릭 가능한 PR 링크를 표시합니다 (예: "PR #446"). 링크에는 검토 상태를 나타내는 색상 밑줄이 있습니다:
- 녹색: 승인됨
- 노란색: 검토 대기 중
- 빨간색: 변경 요청됨
- 회색: 초안
- 보라색: 병합됨
Cmd+click (Mac) 또는 Ctrl+click (Windows/Linux)으로 링크를 클릭하면 브라우저에서 풀 리퀘스트가 열립니다. 상태는 60초마다 자동으로 업데이트됩니다.
참고: PR 상태를 확인하려면
ghCLI가 설치되어 있고 인증(gh auth login)이 완료되어 있어야 합니다.