인터랙티브 모드

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을 눌러 명령어 기록을 인터랙티브하게 검색할 수 있습니다:

1. 검색 시작: Ctrl+R을 눌러 역방향 기록 검색 활성화
2. 검색어 입력: 이전 명령어에서 찾을 텍스트 입력. 검색어는 일치하는 결과에서 강조 표시됨
3. 일치 항목 탐색: Ctrl+R을 다시 눌러 이전 일치 항목으로 이동
4. 일치 항목 수락:
   • Tab 또는 Esc를 눌러 현재 일치 항목을 수락하고 편집 계속
   • Enter를 눌러 수락하고 명령어 즉시 실행
5. 검색 취소:
   • 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 상태를 확인하려면 gh CLI가 설치되어 있고 인증(gh auth login)이 완료되어 있어야 합니다.

참고 항목

• 스킬 - 커스텀 프롬프트 및 워크플로우
• 체크포인팅 - Claude의 편집 되돌리기 및 이전 상태 복원
• CLI 참고 - 커맨드라인 플래그 및 옵션
• 설정 - 설정 옵션
• 메모리 관리 - CLAUDE.md 파일 관리