키보드 단축키
키보드 단축키는 플랫폼 및 터미널에 따라 다를 수 있습니다. ?를 눌러 사용 중인 환경에서 사용 가능한 단축키를 확인하세요.macOS 사용자: Option/Alt 키 단축키(Alt+B, Alt+F, Alt+Y, Alt+M, Alt+P)를 사용하려면 터미널에서 Option을 Meta로 구성해야 합니다:
- iTerm2: 설정 → 프로필 → 키 → 왼쪽/오른쪽 Option 키를 “Esc+“로 설정
- Terminal.app: 설정 → 프로필 → 키보드 → “Option을 Meta 키로 사용” 확인
- VS Code: 설정 → 프로필 → 키 → 왼쪽/오른쪽 Option 키를 “Esc+“로 설정
자세한 내용은 터미널 구성을 참조하세요. 일반 제어
| 단축키 | 설명 | 컨텍스트 |
|---|
Ctrl+C | 현재 입력 또는 생성 취소 | 표준 중단 |
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 사용자는 두 번 누르기 |
Left/Right arrows | 대화 상자 탭 순환 | 권한 대화 상자 및 메뉴의 탭 간 이동 |
Up/Down arrows | 명령 기록 탐색 | 이전 입력 회상 |
Esc + Esc | 코드/대화 되감기 | 코드 및/또는 대화를 이전 지점으로 복원 |
Shift+Tab 또는 Alt+M (일부 구성) | 권한 모드 토글 | 자동 수락 모드, Plan Mode 및 일반 모드 간 전환 |
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을 Meta로 설정 필요 |
Alt+B | 커서를 한 단어 뒤로 이동 | 단어 탐색. macOS에서 Option을 Meta로 설정 필요 |
Alt+F | 커서를 한 단어 앞으로 이동 | 단어 탐색. macOS에서 Option을 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을 실행하여 바인딩을 설치하세요.
빠른 명령
| 단축키 | 설명 | 참고 |
|---|
/ 시작 | 명령 또는 skill | 기본 제공 명령 및 skills 참조 |
! 시작 | Bash 모드 | 명령을 직접 실행하고 실행 출력을 세션에 추가 |
@ | 파일 경로 언급 | 파일 경로 자동 완성 트리거 |
기본 제공 명령
기본 제공 명령은 일반적인 작업의 단축키입니다. 아래 표는 일반적으로 사용되는 명령을 다루지만 모든 사용 가능한 옵션을 포함하지는 않습니다. Claude Code에서 /를 입력하여 전체 목록을 보거나 / 뒤에 문자를 입력하여 필터링하세요.
/로 호출할 수 있는 자신만의 명령을 만들려면 skills를 참조하세요.
| 명령 | 목적 |
|---|
/clear | 대화 기록 지우기 |
/compact [instructions] | 선택적 포커스 지침으로 대화 압축 |
/config | 설정 인터페이스 열기 (Config 탭) |
/context | 현재 컨텍스트 사용을 색상 그리드로 시각화 |
/cost | 토큰 사용 통계 표시. 구독별 세부 정보는 비용 추적 가이드를 참조하세요. |
/doctor | Claude Code 설치 상태 확인 |
/exit | REPL 종료 |
/export [filename] | 현재 대화를 파일 또는 클립보드로 내보내기 |
/help | 사용 도움말 받기 |
/init | CLAUDE.md 가이드로 프로젝트 초기화 |
/mcp | MCP 서버 연결 및 OAuth 인증 관리 |
/memory | CLAUDE.md 메모리 파일 편집 |
/model | AI 모델 선택 또는 변경 |
/permissions | 권한 보기 또는 업데이트 |
/plan | 프롬프트에서 직접 plan mode 입력 |
/rename <name> | 더 쉬운 식별을 위해 현재 세션 이름 바꾸기 |
/resume [session] | ID 또는 이름으로 대화 재개하거나 세션 선택기 열기 |
/rewind | 대화 및/또는 코드 되감기 |
/stats | 일일 사용, 세션 기록, 연속 기록 및 모델 선호도 시각화 |
/status | 버전, 모델, 계정 및 연결성을 표시하는 설정 인터페이스 열기 (Status 탭) |
/statusline | Claude Code의 상태 줄 UI 설정 |
/tasks | 백그라운드 작업 나열 및 관리 |
/teleport | claude.ai에서 원격 세션 재개 (구독자만 해당) |
/theme | 색상 테마 변경 |
/todos | 현재 TODO 항목 나열 |
/usage | 구독 계획만 해당: 계획 사용 제한 및 속도 제한 상태 표시 |
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 모션을 역순으로 반복 |
편집 (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의 접두사 키로 인해 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
- 명령 및 출력을 대화 컨텍스트에 추가합니다
- 실시간 진행 상황 및 출력을 표시합니다
- 장시간 실행 명령에 대해 동일한
Ctrl+B 백그라운드 실행을 지원합니다
- Claude가 명령을 해석하거나 승인할 필요가 없습니다
- 기록 기반 자동 완성 지원: 부분 명령을 입력하고 Tab을 눌러 현재 프로젝트의 이전
! 명령에서 완성합니다
이는 대화 컨텍스트를 유지하면서 빠른 셸 작업에 유용합니다.
작업 목록
복잡한 다단계 작업을 수행할 때 Claude는 진행 상황을 추적하기 위해 작업 목록을 만듭니다. 작업은 보류 중, 진행 중 또는 완료를 나타내는 표시기와 함께 터미널의 상태 영역에 나타납니다.
Ctrl+T를 눌러 작업 목록 보기를 토글합니다. 디스플레이는 한 번에 최대 10개의 작업을 표시합니다- 모든 작업을 보거나 지우려면 Claude에 직접 요청하세요: “모든 작업 표시” 또는 “모든 작업 지우기”
- 작업은 컨텍스트 압축 전체에서 유지되어 Claude가 더 큰 프로젝트에서 조직을 유지하도록 도와줍니다
- 세션 간에 작업 목록을 공유하려면
CLAUDE_CODE_TASK_LIST_ID를 ~/.claude/tasks/의 명명된 디렉토리로 사용하도록 설정하세요: CLAUDE_CODE_TASK_LIST_ID=my-project claude
참고 항목
