키보드 단축키
키보드 단축키는 플랫폼 및 터미널에 따라 다를 수 있습니다. 전체 화면 렌더링에서 트랜스크립트 뷰어의
?를 눌러 사용 가능한 단축키를 확인하세요.macOS 사용자: Option/Alt 키 단축키(Alt+B, Alt+F, Alt+Y, Alt+M, Alt+P)를 사용하려면 터미널에서 Option을 Meta로 구성해야 합니다:- iTerm2: 설정 → 프로필 → 키 → 일반 → Left/Right Option 키를 “Esc+“로 설정
- Apple Terminal: 설정 → 프로필 → 키보드 → “Option을 Meta 키로 사용” 확인
- VS Code: VS Code 설정에서
"terminal.integrated.macOptionIsMeta": true로 설정
일반 제어
텍스트 편집
테마 및 표시
여러 줄 입력
빠른 명령
트랜스크립트 뷰어
트랜스크립트 뷰어가 열려 있을 때(Ctrl+O로 토글), 이 단축키를 사용할 수 있습니다. 전체 화면 렌더링에서 ?를 눌러 뷰어 내에서 전체 단축키 참조 패널을 표시합니다. Ctrl+E는 transcript:toggleShowAll을 통해 재바인딩할 수 있습니다.
음성 입력
명령
Claude Code에서/를 입력하여 사용 가능한 모든 명령을 보거나, / 다음에 문자를 입력하여 필터링하세요. / 메뉴는 호출할 수 있는 모든 것을 표시합니다: 기본 제공 명령, 번들 및 사용자 작성 skills, 그리고 plugins 및 MCP servers에서 제공하는 명령. 플랫폼 또는 요금제에 따라 달라지므로 모든 명령이 모든 사용자에게 표시되지는 않습니다.
전체 화면 렌더링에서 / 명령 및 @ 파일 제안 목록도 마우스에 응답합니다: 행 위에 마우스를 올리면 강조 표시되고 클릭하면 선택됩니다.
Claude Code에 포함된 명령의 전체 목록은 명령 참조를 참조하세요.
Vim 편집기 모드
/config → 편집기 모드를 통해 vim 스타일 편집을 활성화합니다.
모드 전환
INSERT 모드 키 시퀀스 다시 매핑
vimInsertModeRemaps 설정은 두 개의 키 INSERT 모드 시퀀스를 Escape로 매핑하므로 jj와 같은 매핑은 사용자를 NORMAL 모드로 돌려보냅니다. Claude Code v2.1.208 이상이 필요합니다.
다음 ~/.claude/settings.json 예제는 vim 모드를 켜고 jj를 Escape로 매핑합니다:
"<Esc>"는 유일하게 지원되는 대상입니다. 다른 길이 또는 대상을 가진 항목은 무시됩니다.
시퀀스의 첫 번째 문자를 입력하면 정상적으로 삽입됩니다. 1초 이내에 두 번째 문자를 누르면 대기 중인 문자가 제거되고 NORMAL 모드로 전환되며, 입력에 두 문자 모두 남지 않습니다. 1초 창이 지난 후 또는 다른 키가 뒤따르면 두 문자 모두 리터럴 텍스트로 유지되므로 두 키 사이에 일시 중지하여 시퀀스를 포함하는 단어를 여전히 입력할 수 있습니다.
Claude Code는 사용자 설정 파일, --settings 플래그 및 관리되는 설정에서만 이 설정을 읽습니다. 프로젝트의 .claude/settings.json 또는 .claude/settings.local.json의 항목은 무시되므로 체크아웃된 저장소는 사용자의 키 입력을 다시 매핑할 수 없습니다.
탐색 (NORMAL 모드)
vim 일반 모드에서 커서가 입력의 시작 또는 끝에 있고 더 이상 이동할 수 없으면
j/k 및 화살표 키가 명령 기록을 탐색합니다.편집 (NORMAL 모드)
텍스트 객체 (NORMAL 모드)
텍스트 객체는d, c, y와 같은 연산자와 함께 작동합니다:
시각적 모드
문자 단위 선택을 위해v를 누르거나 줄 단위 선택을 위해 V를 누릅니다. 동작은 선택을 확장하고 연산자는 이에 직접 작용합니다.
Ctrl+V를 사용한 블록 단위 시각적 모드는 지원되지 않습니다.
명령 기록
Claude Code는 현재 세션의 명령 기록을 유지합니다:- 입력 기록은 작업 디렉토리별로 저장됩니다
- 입력 기록은
/clear를 실행하여 새 세션을 시작할 때 재설정됩니다. 이전 세션의 대화는 보존되며 재개할 수 있습니다. - 동일한 프롬프트를 연속으로 두 번 제출하면 하나의 기록 항목만 기록되므로 위쪽 화살표를 누르면 이전의 서로 다른 프롬프트로 이동합니다
- Up/Down 화살표를 사용하여 탐색하세요 (위의 키보드 단축키 참조)
- 기록 확장(
!)은 기본적으로 비활성화됩니다
Ctrl+R을 사용한 역방향 검색
Ctrl+R을 눌러 명령 기록을 대화형으로 검색하세요:
- 검색 시작:
Ctrl+R을 눌러 역방향 기록 검색 활성화 - 쿼리 입력: 이전 명령에서 검색할 텍스트를 입력하세요. 검색어는 일치하는 결과에서 강조됩니다
- 일치 탐색:
Ctrl+R을 다시 눌러 더 오래된 일치를 순환하세요 - 범위 변경: 검색은 기본적으로 모든 프로젝트의 프롬프트로 범위가 지정됩니다.
Ctrl+S를 눌러 이 세션, 이 프로젝트, 모든 프로젝트 간에 범위를 순환하세요 - 일치 수락:
Tab또는Esc를 눌러 현재 일치를 수락하고 편집 계속Enter를 눌러 명령을 수락하고 즉시 실행
- 검색 취소:
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에 이유를 설명하는 메모가 있습니다
- v2.1.193부터 macOS 및 Linux에서는 세션이 최소 30분 동안 유휴 상태이고 실행 중인 턴이나 서브에이전트가 없을 때 운영 체제가 메모리 압박 신호를 보내면 실행 중인 백그라운드 작업이 종료됩니다.
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP를1로 설정하여 이를 비활성화할 수 있습니다
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 환경 변수를 1로 설정하세요. 자세한 내용은 환경 변수를 참조하세요.
일반적인 백그라운드 명령:
- 빌드 도구 (webpack, vite, make)
- 패키지 관리자 (npm, yarn, pnpm)
- 테스트 러너 (jest, pytest)
- 개발 서버
- 장시간 실행 프로세스 (docker, terraform)
! 접두사를 사용한 Shell 모드
입력 앞에 !를 붙여 Claude를 거치지 않고 bash 명령을 직접 실행하세요:
- 명령 및 출력을 대화 컨텍스트에 추가합니다
- 실시간 진행 상황 및 출력을 표시합니다
- 장시간 실행 명령에 대해 동일한
Ctrl+B백그라운드 실행을 지원합니다 - Claude가 명령을 해석하거나 승인할 필요가 없습니다
- 기록 기반 자동 완성을 지원합니다: 부분 명령을 입력하고
Tab을 눌러 현재 프로젝트의 이전!명령에서 완성합니다 - v2.1.193부터 모든 플랫폼에서 라이브 파일 경로 자동 완성을 지원합니다:
./src/또는~/와 같이 슬래시를 포함하는 토큰을 입력하면 일치하는 파일 및 디렉터리의 드롭다운이 표시되고,Tab을 눌러 수락합니다. Windows에서도 슬래시를 사용하세요. 드롭다운은/로 트리거되며\로는 아닙니다 - 빈 프롬프트에서
Escape,Backspace또는Ctrl+U로 종료합니다 - 빈 프롬프트에
!로 시작하는 텍스트를 붙여넣으면 입력된!동작과 일치하여 shell 모드에 자동으로 진입합니다
! npm test를 실행하고 실패에 대한 설명을 두 번째 프롬프트 없이 얻을 수 있습니다. 응답 비용은 일반 프롬프트를 보내는 것과 동일합니다. 출력이 응답 없이 컨텍스트에 추가되는 이전 동작을 복원하려면 settings.json에서 respondToBashCommands를 false로 설정하세요. v2.1.186 이전에는 shell 모드가 항상 응답 없이 출력을 컨텍스트에 추가했습니다.
이는 대화 컨텍스트를 유지하면서 빠른 셸 작업에 유용합니다.
프롬프트 제안
세션을 처음 열 때 시작하는 데 도움이 되는 회색으로 표시된 예제 명령이 프롬프트 입력에 나타납니다. Claude Code는 프로젝트의 git 기록에서 이를 선택하므로 최근에 작업한 파일을 반영합니다. Claude가 응답한 후 다중 부분 요청의 후속 단계 또는 워크플로우의 자연스러운 계속과 같은 대화 기록을 기반으로 제안이 계속 나타납니다.Tab또는Right arrow를 눌러 제안을 프롬프트 입력에 배치한 후Enter를 눌러 제출합니다- 입력을 시작하여 제안을 해제합니다
--prompt-suggestions를 --output-format stream-json --verbose와 함께 전달하여 각 턴 이후에 prompt_suggestion 메시지를 내보냅니다.
프롬프트 제안을 완전히 비활성화하려면 환경 변수를 설정하거나 /config에서 설정을 토글하세요:
/btw를 사용한 측면 질문
/btw를 사용하여 현재 작업에 대한 빠른 질문을 하되 대화 기록에 추가하지 않으세요. 이는 빠른 답변을 원하지만 주 컨텍스트를 복잡하게 하거나 Claude의 장시간 실행 작업을 방해하고 싶지 않을 때 유용합니다.
- Claude가 작업하는 동안 사용 가능: Claude가 응답을 처리하는 동안에도
/btw를 실행할 수 있습니다. 측면 질문은 독립적으로 실행되며 주 턴을 중단하지 않습니다. - 도구 액세스 없음: 측면 질문은 이미 컨텍스트에 있는 것에서만 답변합니다. Claude는 측면 질문에 답할 때 파일을 읽거나, 명령을 실행하거나, 검색할 수 없습니다.
- 단일 응답: 오버레이에는 후속 턴이 없습니다. 스레드를 계속하려면
f를 사용하여 자신의 세션으로 포크하세요. - 낮은 비용: 측면 질문은 부모 대화의 프롬프트 캐시를 재사용하므로 추가 비용은 최소입니다.
/btw는 subagent의 역입니다: 전체 대화를 보지만 도구가 없는 반면, subagent는 전체 도구를 가지지만 빈 컨텍스트로 시작합니다. /btw를 사용하여 Claude가 이 세션에서 이미 알고 있는 것에 대해 질문하세요; subagent를 사용하여 새로운 것을 찾아내세요.
작업 목록
작업 목록은 Claude의 할 일 체크리스트입니다: Claude가 다단계 작업을 계획하기 위해 생성한 항목으로, 보류 중, 진행 중 또는 완료된 항목을 나타내는 표시기가 있습니다. 이는 백그라운드 작업 보기와는 별개입니다. 실행 중인 셸과 서브에이전트를 보려면/tasks 대신 사용하세요.
Ctrl+T를 눌러 작업 목록 보기를 토글하세요. 디스플레이는 한 번에 최대 5개의 작업을 표시합니다. Claude가 아직 체크리스트 항목을 생성하지 않았을 때는 표시할 것이 없기 때문에 토글이 눈에 띄는 효과가 없습니다- 모든 작업을 보거나 지우려면 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 (macOS) 또는 Ctrl+click (Windows/Linux)으로 링크를 클릭하여 브라우저에서 풀 요청을 열 수 있습니다. 상태는 60초마다 새로 고쳐지며, gh pr 또는 git push 명령이 세션에서 실행된 직후에 즉시 새로 고쳐집니다.
PR 상태는
gh CLI가 설치되고 인증되어야 합니다 (gh auth login).참고 항목
- Skills - 사용자 정의 프롬프트 및 워크플로우
- Checkpointing - Claude의 편집 되돌리기 및 이전 상태 복원
- CLI 참조 - 명령줄 플래그 및 옵션
- 설정 - 구성 옵션
- 메모리 관리 - CLAUDE.md 파일 관리