SpyBara
Go Premium

interactive-mode.md 2026-05-05 23:00 UTC to 2026-05-07 22:59 UTC

This page contains 5 additions and 4 deletions.

2026
Mon 4 22:58 Thu 7 22:59 Sat 9 04:57 Mon 11 23:00 Tue 12 22:57

대화형 모드

Claude Code 세션의 키보드 단축키, 입력 모드 및 대화형 기능에 대한 완전한 참조입니다.

키보드 단축키

일반 제어

단축키 설명 컨텍스트
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) 확장 사고 토글 확장 사고 모드를 활성화 또는 비활성화합니다. {/* min-version: 2.1.132 */}v2.1.132부터 이 단축키는 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, Windows Terminal에서 기본적으로 작동
제어 시퀀스 Ctrl+J 구성 없이 모든 터미널에서 작동
붙여넣기 모드 직접 붙여넣기 코드 블록, 로그의 경우

빠른 명령

단축키 설명 참고
/ 시작 명령 또는 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을 실행하여 탭-토글을 사용합니다. 재바인딩 가능

명령

Claude Code에서 /를 입력하여 사용 가능한 모든 명령을 보거나, / 다음에 문자를 입력하여 필터링하세요. / 메뉴는 호출할 수 있는 모든 것을 표시합니다: 기본 제공 명령, 번들 및 사용자 작성 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 왼쪽/아래/위/오른쪽 이동
Space 오른쪽 이동
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 줄 복사
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을 눌러 명령 기록을 대화형으로 검색하세요:

  1. 검색 시작: Ctrl+R을 눌러 역방향 기록 검색 활성화
  2. 쿼리 입력: 이전 명령에서 검색할 텍스트를 입력하세요. 검색어는 일치하는 결과에서 강조됩니다
  3. 일치 탐색: Ctrl+R을 다시 눌러 더 오래된 일치를 순환하세요
  4. 범위 변경: Ctrl+S를 눌러 이 세션, 이 프로젝트, 모든 프로젝트 간에 순환하세요
  5. 일치 수락:
    • Tab 또는 Esc를 눌러 현재 일치를 수락하고 편집 계속
    • Enter를 눌러 명령을 수락하고 즉시 실행
  6. 검색 취소:
    • 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)

! 접두사를 사용한 Shell 모드

입력 앞에 !를 붙여 Claude를 거치지 않고 bash 명령을 직접 실행하세요:

! npm test
! git status
! ls -la

Shell 모드:

  • 명령 및 출력을 대화 컨텍스트에 추가합니다
  • 실시간 진행 상황 및 출력을 표시합니다
  • 장시간 실행 명령에 대해 동일한 Ctrl+B 백그라운드 실행을 지원합니다
  • Claude가 명령을 해석하거나 승인할 필요가 없습니다
  • 기록 기반 자동 완성을 지원합니다: 부분 명령을 입력하고 Tab을 눌러 현재 프로젝트의 이전 ! 명령에서 완성합니다
  • 빈 프롬프트에서 Escape, Backspace 또는 Ctrl+U로 종료합니다
  • 빈 프롬프트에 !로 시작하는 텍스트를 붙여넣으면 입력된 ! 동작과 일치하여 shell 모드에 자동으로 진입합니다

이는 대화 컨텍스트를 유지하면서 빠른 셸 작업에 유용합니다.

프롬프트 제안

세션을 처음 열 때 시작하는 데 도움이 되는 회색으로 표시된 예제 명령이 프롬프트 입력에 나타납니다. 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가 작업하는 동안 사용 가능: 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초마다 자동으로 업데이트됩니다.

참고 항목