키보드 단축키
키보드 단축키는 플랫폼 및 터미널에 따라 다를 수 있습니다. ?를 눌러 사용자 환경에서 사용 가능한 단축키를 확인하세요.macOS 사용자: Option/Alt 키 단축키(Alt+B, Alt+F, Alt+Y, Alt+M, Alt+P, Alt+T)를 사용하려면 터미널에서 Option을 Meta로 구성해야 합니다:
- iTerm2: 설정 → 프로필 → 키 → 일반 → Left/Right Option 키를 “Esc+“로 설정
- Apple Terminal: 설정 → 프로필 → 키보드 → “Option을 Meta 키로 사용” 확인
- VS Code: VS Code 설정에서
"terminal.integrated.macOptionIsMeta": true로 설정
자세한 내용은 터미널 구성을 참조하세요. 일반 제어
| 단축키 | 설명 | 컨텍스트 |
|---|
Ctrl+C | 현재 입력 또는 생성 취소 | 표준 중단 |
Ctrl+X Ctrl+K | 모든 백그라운드 에이전트 종료. 3초 이내에 두 번 누르면 확인 | 백그라운드 에이전트 제어 |
Ctrl+D | Claude Code 세션 종료 | EOF 신호 |
Ctrl+G 또는 Ctrl+X Ctrl+E | 기본 텍스트 편집기에서 열기 | 기본 텍스트 편집기에서 프롬프트 또는 사용자 정의 응답을 편집합니다. Ctrl+X Ctrl+E는 readline 기본 바인딩입니다. /config에서 외부 편집기에서 마지막 응답 표시를 켜면 Claude의 이전 응답을 #-주석 처리된 컨텍스트로 프롬프트 위에 앞에 붙입니다. 저장할 때 주석 블록이 제거됩니다 |
Ctrl+L | 프롬프트 입력 지우기 및 화면 다시 그리기 | 입력한 텍스트를 지우고 전체 터미널 다시 그리기를 강제합니다. 대화 기록은 유지됩니다. 디스플레이가 손상되거나 부분적으로 공백이 되면 이를 사용하여 복구하세요 |
Ctrl+O | 트랜스크립트 뷰어 토글 | 자세한 도구 사용 및 실행을 표시합니다. MCP 호출도 확장하며, 기본적으로 “Slack 3회 호출됨”과 같은 단일 줄로 축소됩니다 |
Ctrl+R | 역방향 검색 명령 기록 | 이전 명령을 대화형으로 검색 |
Ctrl+V 또는 Cmd+V (iTerm2) 또는 Alt+V (Windows) | 클립보드에서 이미지 붙여넣기 | 커서에 [Image #N] 칩을 삽입하여 프롬프트에서 위치별로 참조할 수 있습니다 |
Ctrl+B | 백그라운드 실행 작업 | bash 명령 및 에이전트를 백그라운드로 실행합니다. Tmux 사용자는 두 번 누르기 |
Ctrl+T | 작업 목록 토글 | 터미널 상태 영역에서 작업 목록 표시 또는 숨기기 |
Left/Right 화살표 | 대화 상자 탭 순환 | 권한 대화 상자 및 메뉴의 탭 간 탐색 |
Up/Down 화살표 또는 Ctrl+P/Ctrl+N | 커서 이동 또는 명령 기록 탐색 | 여러 줄 입력에서 먼저 프롬프트 내에서 커서를 이동합니다. 커서가 이미 위쪽 또는 아래쪽 가장자리에 있으면 다시 누르면 명령 기록을 탐색합니다 |
Esc + Esc | 되돌리기 또는 요약 | 코드 및/또는 대화를 이전 지점으로 복원하거나 선택한 메시지에서 요약 |
Shift+Tab 또는 Alt+M (일부 구성) | 권한 모드 순환 | default, acceptEdits, plan 및 auto 또는 bypassPermissions와 같이 활성화한 모든 모드를 순환합니다. 권한 모드를 참조하세요. |
Option+P (macOS) 또는 Alt+P (Windows/Linux) | 모델 전환 | 프롬프트를 지우지 않고 모델 전환 |
Option+T (macOS) 또는 Alt+T (Windows/Linux) | 확장 사고 토글 | 확장 사고 모드를 활성화 또는 비활성화합니다. macOS에서 이 단축키가 작동하려면 터미널에서 Option을 Meta로 보내도록 구성하세요 |
Option+O (macOS) 또는 Alt+O (Windows/Linux) | 빠른 모드 토글 | 빠른 모드 활성화 또는 비활성화 |
텍스트 편집
| 단축키 | 설명 | 컨텍스트 |
|---|
Ctrl+A | 현재 줄의 시작으로 커서 이동 | 여러 줄 입력에서 현재 논리 줄의 시작으로 이동합니다 |
Ctrl+E | 현재 줄의 끝으로 커서 이동 | 여러 줄 입력에서 현재 논리 줄의 끝으로 이동합니다 |
Ctrl+K | 줄 끝까지 삭제 | 삭제된 텍스트를 붙여넣기용으로 저장 |
Ctrl+U | 커서에서 줄 시작까지 삭제 | 삭제된 텍스트를 붙여넣기용으로 저장합니다. 여러 줄 입력에서 반복하여 여러 줄을 지웁니다. macOS에서 iTerm2 및 Terminal.app을 포함한 터미널 에뮬레이터는 Cmd+Backspace를 이 단축키로 매핑합니다 |
Ctrl+W | 이전 단어 삭제 | 삭제된 텍스트를 붙여넣기용으로 저장합니다. Windows에서 Ctrl+Backspace도 이전 단어를 삭제합니다 |
Ctrl+Y | 삭제된 텍스트 붙여넣기 | Ctrl+K, Ctrl+U 또는 Ctrl+W로 삭제한 텍스트 붙여넣기 |
Alt+Y (Ctrl+Y 이후) | 붙여넣기 기록 순환 | 붙여넣기 후 이전에 삭제한 텍스트를 순환합니다. macOS에서 Option을 Meta로 설정 필요 |
Alt+B | 커서를 한 단어 뒤로 이동 | 단어 탐색. macOS에서 Option을 Meta로 설정 필요 |
Alt+F | 커서를 한 단어 앞으로 이동 | 단어 탐색. macOS에서 Option을 Meta로 설정 필요 |
테마 및 표시
| 단축키 | 설명 | 컨텍스트 |
|---|
Ctrl+T | 코드 블록의 구문 강조 토글 | /theme 선택기 메뉴 내에서만 작동합니다. Claude의 응답에서 코드가 구문 색상을 사용하는지 여부를 제어합니다 |
여러 줄 입력
| 방법 | 단축키 | 컨텍스트 |
|---|
| 빠른 이스케이프 | \ + Enter | 모든 터미널에서 작동 |
| Option 키 | Option+Enter | macOS에서 Option을 Meta로 활성화한 후 |
| Shift+Enter | Shift+Enter | iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal에서 기본적으로 작동 |
| 제어 시퀀스 | Ctrl+J | 구성 없이 모든 터미널에서 작동 |
| 붙여넣기 모드 | 직접 붙여넣기 | 코드 블록, 로그의 경우 |
Shift+Enter는 iTerm2, WezTerm, Ghostty, Kitty, Warp 및 Apple Terminal에서 구성 없이 작동합니다. VS Code, Cursor, Windsurf, Alacritty 및 Zed의 경우 /terminal-setup을 실행하여 바인딩을 설치하세요.
빠른 명령
| 단축키 | 설명 | 참고 |
|---|
/ 시작 | 명령 또는 skill | 명령 및 skills 참조 |
! 시작 | Bash 모드 | 명령을 직접 실행하고 실행 출력을 세션에 추가 |
@ | 파일 경로 언급 | 파일 경로 자동 완성 트리거 |
트랜스크립트 뷰어
트랜스크립트 뷰어가 열려 있을 때(Ctrl+O로 토글), 이 단축키를 사용할 수 있습니다. Ctrl+E는 transcript:toggleShowAll을 통해 재바인딩할 수 있습니다.
| 단축키 | 설명 |
|---|
Ctrl+E | 모든 콘텐츠 표시 토글 |
[ | 전체 대화를 터미널의 기본 스크롤백에 작성하여 Cmd+F, tmux 복사 모드 및 기타 기본 도구가 검색할 수 있도록 합니다. 전체 화면 렌더링 필요 |
v | 대화를 임시 파일에 작성하고 $VISUAL 또는 $EDITOR에서 엽니다. 전체 화면 렌더링 필요 |
q, Ctrl+C, Esc | 트랜스크립트 보기 종료. 세 가지 모두 transcript:exit를 통해 재바인딩할 수 있습니다 |
음성 입력
| 단축키 | 설명 | 참고 |
|---|
Space 길게 누르기 또는 탭 | 음성 받아쓰기 | 음성 받아쓰기가 활성화되어야 합니다. 길게 누르면 녹음하거나 /voice tap을 실행하여 탭-토글을 사용합니다. 재바인딩 가능 |
/를 입력하여 사용 가능한 모든 명령을 보거나, / 다음에 문자를 입력하여 필터링하세요. / 메뉴는 호출할 수 있는 모든 것을 표시합니다: 기본 제공 명령, 번들 및 사용자 작성 skills, 그리고 plugins 및 MCP servers에서 제공하는 명령. 플랫폼 또는 요금제에 따라 달라지므로 모든 명령이 모든 사용자에게 표시되지는 않습니다.
Claude Code에 포함된 명령의 전체 목록은 명령 참조를 참조하세요.
Vim 편집기 모드
/config → 편집기 모드를 통해 vim 스타일 편집을 활성화합니다.
모드 전환
| 명령 | 작업 | 모드에서 |
|---|
Esc | NORMAL 모드 진입 | INSERT, VISUAL |
i | 커서 앞에 삽입 | NORMAL |
I | 줄 시작에 삽입 | NORMAL |
a | 커서 뒤에 삽입 | NORMAL |
A | 줄 끝에 삽입 | NORMAL |
o | 아래 줄 열기 | NORMAL |
O | 위 줄 열기 | NORMAL |
v | 문자 단위 시각적 선택 시작 | NORMAL |
V | 줄 단위 시각적 선택 시작 | 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 일반 모드에서 커서가 입력의 시작 또는 끝에 있고 더 이상 이동할 수 없으면 j/k 및 화살표 키가 명령 기록을 탐색합니다.
편집 (NORMAL 모드)
| 명령 | 작업 |
|---|
x | 문자 삭제 |
dd | 줄 삭제 |
D | 줄 끝까지 삭제 |
dw/de/db | 단어 삭제/끝까지/뒤로 |
cc | 줄 변경 |
C | 줄 끝까지 변경 |
cw/ce/cb | 단어 변경/끝까지/뒤로 |
yy/Y | 줄 복사 |
yw/ye/yb | 단어 복사/끝까지/뒤로 |
p | 커서 뒤에 붙여넣기 |
P | 커서 앞에 붙여넣기 |
>> | 줄 들여쓰기 |
<< | 줄 내어쓰기 |
J | 줄 결합 |
u | 실행 취소 |
. | 마지막 변경 반복 |
텍스트 객체 (NORMAL 모드)
텍스트 객체는 d, c, y와 같은 연산자와 함께 작동합니다:
| 명령 | 작업 |
|---|
iw/aw | 내부/주변 단어 |
iW/aW | 내부/주변 WORD (공백으로 구분) |
i"/a" | 내부/주변 큰따옴표 |
i'/a' | 내부/주변 작은따옴표 |
i(/a( | 내부/주변 괄호 |
i[/a[ | 내부/주변 대괄호 |
i{/a{ | 내부/주변 중괄호 |
시각적 모드
문자 단위 선택을 위해 v를 누르거나 줄 단위 선택을 위해 V를 누릅니다. 동작은 선택을 확장하고 연산자는 이에 직접 작용합니다.
| 명령 | 작업 |
|---|
d/x | 선택 삭제 |
y | 선택 복사 |
c/s | 선택 변경 |
p | 선택을 레지스터 내용으로 바꾸기 |
r{char} | 선택된 모든 문자를 {char}로 바꾸기 |
~/u/U | 선택 토글, 소문자 또는 대문자 |
>/< | 선택된 줄 들여쓰기 또는 내어쓰기 |
J | 선택된 줄 결합 |
o | 커서와 앵커 교환 |
iw/aw/i"/… | 텍스트 객체 선택 |
v/V | 문자 단위와 줄 단위 간 토글 또는 종료 |
Ctrl+V를 사용한 블록 단위 시각적 모드는 지원되지 않습니다.
명령 기록
Claude Code는 현재 세션의 명령 기록을 유지합니다:
- 입력 기록은 작업 디렉토리별로 저장됩니다
- 입력 기록은
/clear를 실행하여 새 세션을 시작할 때 재설정됩니다. 이전 세션의 대화는 보존되며 재개할 수 있습니다.
- Up/Down 화살표를 사용하여 탐색하세요 (위의 키보드 단축키 참조)
- 참고: 기록 확장(
!)은 기본적으로 비활성화됩니다
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의 접두사 키로 인해 Ctrl+B를 두 번 눌러야 합니다.)
주요 기능:
- 출력은 파일에 기록되며 Claude는 Read 도구를 사용하여 검색할 수 있습니다
- 백그라운드 작업에는 추적 및 출력 검색을 위한 고유 ID가 있습니다
- 백그라운드 작업은 Claude Code가 종료될 때 자동으로 정리됩니다
- 백그라운드 작업은 출력이 5GB를 초과하면 자동으로 종료되며, stderr에 이유를 설명하는 메모가 있습니다
모든 백그라운드 작업 기능을 비활성화하려면 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
- 명령 및 출력을 대화 컨텍스트에 추가
- 실시간 진행 상황 및 출력 표시
- 장시간 실행 명령에 대해 동일한
Ctrl+B 백그라운드 실행 지원
- Claude가 명령을 해석하거나 승인할 필요 없음
- 기록 기반 자동 완성 지원: 부분 명령을 입력하고 Tab을 눌러 현재 프로젝트의 이전
! 명령에서 완성
- 빈 프롬프트에서
Escape, Backspace 또는 Ctrl+U로 종료
- 빈 프롬프트에
!로 시작하는 텍스트를 붙여넣으면 입력된 ! 동작과 일치하여 bash 모드에 자동으로 진입합니다
이는 대화 컨텍스트를 유지하면서 빠른 셸 작업에 유용합니다.
프롬프트 제안
세션을 처음 열 때 시작하는 데 도움이 되는 회색으로 표시된 예제 명령이 프롬프트 입력에 나타납니다. Claude Code는 프로젝트의 git 기록에서 이를 선택하므로 최근에 작업한 파일을 반영합니다.
Claude가 응답한 후 다중 부분 요청의 후속 단계 또는 워크플로우의 자연스러운 계속과 같은 대화 기록을 기반으로 제안이 계속 나타납니다.
- Tab 또는 Right 화살표를 눌러 제안을 수락하거나 Enter를 눌러 수락하고 제출
- 입력을 시작하여 제안 해제
제안은 부모 대화의 프롬프트 캐시를 재사용하는 백그라운드 요청으로 실행되므로 추가 비용은 최소입니다. Claude Code는 불필요한 비용을 피하기 위해 캐시가 콜드일 때 제안 생성을 건너뜁니다.
제안은 대화의 첫 번째 턴 이후, 비대화형 모드에서, 그리고 Plan Mode에서 자동으로 건너뜁니다.
프롬프트 제안을 완전히 비활성화하려면 환경 변수를 설정하거나 /config에서 설정을 토글하세요:
export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
/btw를 사용한 측면 질문
/btw를 사용하여 현재 작업에 대한 빠른 질문을 하되 대화 기록에 추가하지 않으세요. 이는 빠른 답변을 원하지만 주 컨텍스트를 복잡하게 하거나 Claude의 장시간 실행 작업을 방해하고 싶지 않을 때 유용합니다.
/btw what was the name of that config file again?
- Claude가 작업하는 동안 사용 가능: Claude가 응답을 처리하는 동안에도
/btw를 실행할 수 있습니다. 측면 질문은 독립적으로 실행되며 주 턴을 중단하지 않습니다.
- 도구 액세스 없음: 측면 질문은 이미 컨텍스트에 있는 것에서만 답변합니다. Claude는 측면 질문에 답할 때 파일을 읽거나, 명령을 실행하거나, 검색할 수 없습니다.
- 단일 응답: 후속 턴이 없습니다. 왕복이 필요하면 대신 일반 프롬프트를 사용하세요.
- 낮은 비용: 측면 질문은 부모 대화의 프롬프트 캐시를 재사용하므로 추가 비용은 최소입니다.
Space, Enter 또는 Escape를 눌러 답변을 해제하고 프롬프트로 돌아가세요.
/btw는 subagent의 역입니다: 전체 대화를 보지만 도구가 없는 반면, subagent는 전체 도구를 가지지만 빈 컨텍스트로 시작합니다. /btw를 사용하여 Claude가 이 세션에서 이미 알고 있는 것에 대해 질문하세요; subagent를 사용하여 새로운 것을 찾아내세요.
작업 목록
복잡한 다단계 작업을 수행할 때 Claude는 진행 상황을 추적하기 위해 작업 목록을 만듭니다. 작업은 터미널의 상태 영역에 표시되며 보류 중, 진행 중 또는 완료된 항목을 나타내는 표시기가 있습니다.
Ctrl+T를 눌러 작업 목록 보기를 토글하세요. 디스플레이는 한 번에 최대 5개의 작업을 표시합니다- 모든 작업을 보거나 지우려면 Claude에 직접 요청하세요: “show me all tasks” 또는 “clear all tasks”
- 작업은 컨텍스트 압축 전체에서 지속되어 Claude가 더 큰 프로젝트에서 조직화된 상태를 유지하도록 도와줍니다
- 세션 간에 작업 목록을 공유하려면
CLAUDE_CODE_TASK_LIST_ID를 ~/.claude/tasks/의 명명된 디렉토리로 사용하도록 설정하세요: CLAUDE_CODE_TASK_LIST_ID=my-project claude
세션 요약
터미널에서 떠난 후 돌아오면 Claude Code는 지금까지 세션에서 일어난 일에 대한 한 줄 요약을 표시합니다. 요약은 마지막 완료된 턴 이후 최소 3분이 경과하고 터미널이 포커스를 잃으면 백그라운드에서 생성되므로 다시 전환할 때 준비됩니다. 요약은 세션에 최소 3개의 턴이 있을 때만 나타나며 연속으로 두 번 나타나지 않습니다.
/recap을 실행하여 요약을 요청 시 생성합니다. 자동 요약을 끄려면 /config를 열고 세션 요약을 비활성화하세요.
세션 요약은 모든 요금제 및 제공자에 대해 기본적으로 켜져 있습니다. 요약은 항상 비대화형 모드에서 건너뜁니다.
PR 검토 상태
열린 풀 요청이 있는 브랜치에서 작업할 때 Claude Code는 바닥글에 클릭 가능한 PR 링크를 표시합니다 (예: “PR #446”). 링크에는 검토 상태를 나타내는 색상 있는 밑줄이 있습니다:
- 녹색: 승인됨
- 노란색: 검토 대기 중
- 빨간색: 변경 요청됨
- 회색: 초안
- 보라색: 병합됨
Cmd+click (Mac) 또는 Ctrl+click (Windows/Linux)으로 링크를 클릭하여 브라우저에서 풀 요청을 열 수 있습니다. 상태는 60초마다 자동으로 업데이트됩니다.
PR 상태는 gh CLI가 설치되고 인증되어야 합니다 (gh auth login).
참고 항목
