Logo
본문으로 이동
초급6분 소요interactive-modeworkflowbasics

읽는 시간: 6분 | 난이도: 초급자

인터랙티브 모드는 Claude Code를 대화형으로 사용하는 핵심 환경입니다. 이 문서는 키보드 단축키, 내장 명령어, Vim 편집기 모드, 백그라운드 실행, 작업 목록 등 인터랙티브 모드의 모든 기능을 다룹니다.

키보드 단축키

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+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 화살표 대화 상자 탭 순환 권한 대화 상자와 메뉴의 탭 사이 이동
Up/Down 화살표 명령어 기록 탐색 이전 입력 불러오기
Esc + Esc 되감기 또는 요약 코드와/또는 대화를 이전 지점으로 복원, 또는 선택한 메시지부터 요약
Shift+Tab / Alt+M 권한 모드 토글 자동 수락 모드, 플랜 모드, 일반 모드 간 전환
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 필요

멀티라인 입력

방법 단축키 컨텍스트
빠른 이스케이프 \ + Enter 모든 터미널에서 작동
macOS 기본 Option+Enter macOS 기본값
Shift+Enter Shift+Enter iTerm2, WezTerm, Ghostty, Kitty에서 기본 작동
Control 시퀀스 Ctrl+J 멀티라인을 위한 줄바꿈 문자
붙여넣기 모드 직접 붙여넣기 코드 블록, 로그 등

팁: Shift+Enter는 iTerm2, WezTerm, Ghostty, Kitty에서 설정 없이 작동합니다. VS Code, Alacritty, Zed, Warp에서는 /terminal-setup으로 바인딩을 설치하세요.

빠른 명령어

단축키 설명 참고
/ (입력 시작) 명령어 또는 스킬 내장 명령어 및 스킬 참조
! (입력 시작) Bash 모드 명령어를 직접 실행하고 출력을 세션에 추가
@ 파일 경로 언급 파일 경로 자동완성 트리거

내장 명령어

내장 명령어는 일반적인 작업을 위한 단축키입니다. 아래 표는 자주 사용되는 명령어를 포함하지만 전체 목록은 아닙니다. Claude Code에서 /를 입력하면 전체 목록을 볼 수 있고, / 뒤에 문자를 입력하면 필터링됩니다.

명령어 목적
/clear 대화 기록 지우기
/compact [지시사항] 선택적 포커스 지시사항으로 대화 압축
/config 설정 인터페이스 열기 (Config 탭)
/context 현재 컨텍스트 사용량을 컬러 그리드로 시각화
/cost 토큰 사용 통계 표시
/debug [설명] 세션 디버그 로그를 읽어 현재 세션 문제 해결
/doctor Claude Code 설치 상태 확인
/exit REPL 종료
/export [파일명] 현재 대화를 파일이나 클립보드로 내보내기
/help 사용법 도움말
/init CLAUDE.md 가이드로 프로젝트 초기화
/mcp MCP 서버 연결 및 OAuth 인증 관리
/memory CLAUDE.md 메모리 파일 편집
/model AI 모델 선택 또는 변경
/permissions 권한 보기 또는 업데이트
/plan 프롬프트에서 직접 플랜 모드 진입
/rename <이름> 현재 세션 이름 변경
/resume [세션] ID나 이름으로 대화를 재개하거나 세션 선택기 열기
/rewind 대화와/또는 코드를 되감거나 선택한 메시지부터 요약
/stats 일별 사용량, 세션 기록, 연속 사용, 모델 선호도 시각화
/status 버전, 모델, 계정, 연결 상태를 보여주는 설정 인터페이스 열기
/statusline Claude Code 상태 표시줄 UI 설정
/copy 마지막 어시스턴트 응답을 클립보드에 복사
/tasks 백그라운드 작업 목록 보기 및 관리
/teleport claude.ai에서 원격 세션 재개 (구독자 전용)
/desktop 현재 CLI 세션을 Claude Code 데스크탑 앱으로 전환 (macOS, Windows)
/theme 색상 테마 변경
/todos 현재 TODO 항목 목록
/usage 구독 플랜 전용: 플랜 사용 한도 및 속도 제한 상태 표시

MCP 프롬프트

MCP 서버는 명령어로 표시되는 프롬프트를 노출할 수 있습니다. 이는 /mcp__<서버>__<프롬프트> 형식을 사용하며 연결된 서버에서 동적으로 검색됩니다.

Vim 편집기 모드

/vim 명령이나 /config를 통해 영구적으로 Vim 스타일 편집을 활성화할 수 있습니다.

모드 전환

명령 동작 시작 모드
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 명령으로 지워집니다
  • Up/Down 화살표로 탐색합니다
  • 참고: 기록 확장(!)은 기본적으로 비활성화되어 있습니다

Ctrl+R로 역방향 검색

Ctrl+R을 눌러 명령어 기록을 인터랙티브하게 검색합니다:

  1. 검색 시작: Ctrl+R로 역방향 기록 검색 활성화
  2. 검색어 입력: 검색어를 입력하면 일치하는 결과에서 해당 부분이 강조 표시됨
  3. 일치 항목 탐색: Ctrl+R을 다시 눌러 더 오래된 일치 항목으로 이동
  4. 일치 항목 수락:
    • Tab 또는 Esc: 현재 일치 항목 수락 후 계속 편집
    • Enter: 수락하고 명령어 즉시 실행
  5. 검색 취소:
    • Ctrl+C: 취소하고 원래 입력 복원
    • 빈 검색에서 Backspace: 취소

백그라운드 Bash 명령어

Claude Code는 Bash 명령어를 백그라운드에서 실행하는 것을 지원하여, 오래 걸리는 프로세스가 실행되는 동안 계속 작업할 수 있습니다.

백그라운드 실행 방법

명령어를 백그라운드로 실행하는 두 가지 방법:

  1. Claude Code에게 명령어를 백그라운드에서 실행하도록 프롬프트
  2. Ctrl+B로 일반 Bash 도구 호출을 백그라운드로 전환 (Tmux 사용자는 두 번 누름)

주요 기능:

  • 출력이 버퍼링되어 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을 눌러 현재 프로젝트의 이전 ! 명령어에서 완성

프롬프트 제안

세션을 처음 열면 프롬프트 입력창에 회색으로 예시 명령어가 표시됩니다. Claude Code가 프로젝트의 git 기록에서 선택하므로 최근 작업 중인 파일을 반영합니다.

Claude가 응답한 후에도 대화 기록을 바탕으로 제안이 계속 표시됩니다.

  • Tab: 제안 수락, 또는 Enter로 수락 및 제출
  • 타이핑 시작: 제안 무시

제안을 완전히 비활성화하려면:

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false

또는 /config에서 설정을 토글합니다.

작업 목록

복잡한 다단계 작업을 진행할 때 Claude는 진행 상황을 추적하는 작업 목록을 만듭니다. 작업은 터미널 상태 영역에 대기 중, 진행 중, 완료 표시기와 함께 나타납니다.

  • Ctrl+T: 작업 목록 보기 토글 (한 번에 최대 10개 작업 표시)
  • 모든 작업을 보거나 지우려면 Claude에게 직접 요청: "모든 작업 보여줘" 또는 "모든 작업 지워줘"
  • 작업은 컨텍스트 압축 후에도 유지되어 대규모 프로젝트에서 Claude가 체계적으로 유지됨
  • 세션 간에 작업 목록을 공유하려면 CLAUDE_CODE_TASK_LIST_ID를 설정: CLAUDE_CODE_TASK_LIST_ID=my-project claude

PR 리뷰 상태

열린 풀 리퀘스트가 있는 브랜치에서 작업 중일 때, Claude Code는 푸터에 클릭 가능한 PR 링크를 표시합니다 (예: "PR #446"). 링크에는 리뷰 상태를 나타내는 컬러 밑줄이 있습니다:

색상 상태
초록 승인됨
노랑 리뷰 대기 중
빨강 변경 요청됨
회색 초안
보라 병합됨

Cmd+클릭 (Mac) 또는 Ctrl+클릭 (Windows/Linux)으로 브라우저에서 풀 리퀘스트를 엽니다. 상태는 60초마다 자동으로 업데이트됩니다.

참고: PR 상태를 사용하려면 gh CLI가 설치되고 인증(gh auth login)되어 있어야 합니다.

다음 단계

인터랙티브 모드에 익숙해졌다면 다음을 탐색해보세요:

관련 가이드

CLI 참조 (CLI Reference)초급

Claude Code의 모든 명령줄 인터페이스 명령어, 옵션, 그리고 사용법에 대한 완전한 참조 가이드입니다.

체크포인팅 (작업 저장)중급

Claude Code의 체크포인팅 기능으로 작업 상태를 추적하고, 이전 상태로 되돌리고, 대화를 요약하여 세션 상태를 관리하는 방법을 안내합니다.

Hooks 레퍼런스고급

Claude Code hooks의 완전한 레퍼런스 - 이벤트 유형, 입출력 형식, 설정 방법, 보안 고려사항

인터랙티브 모드 | Claude Code 가이드 | GodDaeHee | GodDaeHee