인터랙티브 모드

읽는 시간: 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을 눌러 명령어 기록을 인터랙티브하게 검색합니다:

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

백그라운드 Bash 명령어

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

백그라운드 실행 방법

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

Claude Code에게 명령어를 백그라운드에서 실행하도록 프롬프트
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)되어 있어야 합니다.

다음 단계

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

터미널 설정 - 터미널 환경 최적화
체크포인팅 - Claude의 편집 내용 되감기 및 이전 상태 복원
스킬 - 커스텀 프롬프트 및 워크플로우
CLI 레퍼런스 - 커맨드라인 플래그 및 옵션
설정 - 구성 옵션

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

키보드 단축키

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 모드	명령어를 직접 실행하고 출력을 세션에 추가
`@`	파일 경로 언급	파일 경로 자동완성 트리거

내장 명령어

명령어	목적
`/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을 눌러 명령어 기록을 인터랙티브하게 검색합니다:

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

백그라운드 Bash 명령어

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

백그라운드 실행 방법

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

Claude Code에게 명령어를 백그라운드에서 실행하도록 프롬프트
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가 응답한 후에도 대화 기록을 바탕으로 제안이 계속 표시됩니다.

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

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

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false

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

작업 목록

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

PR 리뷰 상태

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

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

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

다음 단계

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

터미널 설정 - 터미널 환경 최적화
체크포인팅 - Claude의 편집 내용 되감기 및 이전 상태 복원
스킬 - 커스텀 프롬프트 및 워크플로우
CLI 레퍼런스 - 커맨드라인 플래그 및 옵션
설정 - 구성 옵션

키보드 단축키

일반 제어

텍스트 편집

멀티라인 입력

빠른 명령어

내장 명령어

MCP 프롬프트

Vim 편집기 모드

모드 전환

이동 (NORMAL 모드)

편집 (NORMAL 모드)

텍스트 객체 (NORMAL 모드)

명령어 기록

Ctrl+R로 역방향 검색

백그라운드 Bash 명령어

백그라운드 실행 방법

! 접두사로 Bash 모드 사용

프롬프트 제안

작업 목록

PR 리뷰 상태

다음 단계

관련 가이드

키보드 단축키

일반 제어

텍스트 편집

멀티라인 입력

빠른 명령어

내장 명령어

MCP 프롬프트

Vim 편집기 모드

모드 전환

이동 (NORMAL 모드)

편집 (NORMAL 모드)

텍스트 객체 (NORMAL 모드)

명령어 기록

Ctrl+R로 역방향 검색

백그라운드 Bash 명령어

백그라운드 실행 방법

! 접두사로 Bash 모드 사용

프롬프트 제안

작업 목록

PR 리뷰 상태

다음 단계

관련 가이드

`!` 접두사로 Bash 모드 사용

`!` 접두사로 Bash 모드 사용