대화형 모드

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

키보드 단축키

일반 제어

텍스트 편집

테마 및 표시

여러 줄 입력

빠른 명령

트랜스크립트 뷰어

트랜스크립트 뷰어가 열려 있을 때(Ctrl+O로 토글), 이 단축키를 사용할 수 있습니다. Ctrl+E는 transcript:toggleShowAll을 통해 재바인딩할 수 있습니다.

음성 입력

명령

Claude Code에서 /를 입력하여 사용 가능한 모든 명령을 보거나, / 다음에 문자를 입력하여 필터링하세요. / 메뉴는 호출할 수 있는 모든 것을 표시합니다: 기본 제공 명령, 번들 및 사용자 작성 skills, 그리고 plugins 및 MCP servers에서 제공하는 명령. 플랫폼 또는 요금제에 따라 달라지므로 모든 명령이 모든 사용자에게 표시되지는 않습니다.

Claude Code에 포함된 명령의 전체 목록은 명령 참조를 참조하세요.

Vim 편집기 모드

/config → 편집기 모드를 통해 vim 스타일 편집을 활성화합니다.

모드 전환

탐색 (NORMAL 모드)

편집 (NORMAL 모드)

텍스트 객체 (NORMAL 모드)

텍스트 객체는 d, c, y와 같은 연산자와 함께 작동합니다:

시각적 모드

문자 단위 선택을 위해 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초마다 자동으로 업데이트됩니다.

참고 항목

• Skills - 사용자 정의 프롬프트 및 워크플로우
• Checkpointing - Claude의 편집 되돌리기 및 이전 상태 복원
• CLI 참조 - 명령줄 플래그 및 옵션
• 설정 - 구성 옵션
• 메모리 관리 - CLAUDE.md 파일 관리