26. 키보드 단축키 커스터마이징¶

마우스 없이 Claude Code를 100% 활용하는 방법이에요.

/keybindings로 나만의 단축키를 설정하세요. Vim 스타일 바인딩, 코드(Chords), 기본 단축키 해제까지 전부 가능합니다.

공식 문서: code.claude.com/docs/en/keybindings

필수 단축키 총정리¶

설정을 바꾸기 전에 기본 단축키부터 확실히 알아두세요.

매일 쓰는 핵심 7개¶

네비게이션 & 작업 관리¶

모델 선택기 안에서¶

커스터마이징 방법¶

/keybindings 명령어¶

/keybindings

~/.claude/keybindings.json 파일을 생성하거나 열어줘요. 변경 사항은 자동으로 감지되어 Claude Code를 재시작할 필요 없어요.

keybindings.json 구조¶

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

컨텍스트 종류¶

바인딩은 특정 상황에서만 작동해요. 컨텍스트로 구분합니다.

키 표기법¶

수정자 키¶

+로 조합해요.

ctrl+k          Ctrl + K
shift+tab       Shift + Tab
meta+p          Command + P (macOS)
ctrl+shift+c    Ctrl + Shift + C

대문자¶

대문자 단독 사용은 Shift를 의미해요: K = shift+k

수정자와 함께 쓰면 Shift 아님: ctrl+K = ctrl+k

코드 바인딩 (Chords)¶

키를 순서대로 누르는 조합이에요. 공백으로 구분합니다.

ctrl+k ctrl+s    Ctrl+K 누르고, 떼고, Ctrl+S

특수 키¶

escape, enter, tab, space, up, down, left, right, backspace, delete

실전 레시피¶

레시피 1: 외부 에디터를 Ctrl+E로 변경¶

기본 Ctrl+G 대신 Ctrl+E로 외부 에디터를 여는 설정이에요.

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+g": null
      }
    }
  ]
}

레시피 2: 코드 바인딩으로 빠른 액션¶

Ctrl+K → Ctrl+T로 할 일 목록, Ctrl+K → Ctrl+O로 트랜스크립트 토글.

{
  "bindings": [
    {
      "context": "Global",
      "bindings": {
        "ctrl+k ctrl+t": "app:toggleTodos",
        "ctrl+k ctrl+o": "app:toggleTranscript"
      }
    }
  ]
}

레시피 3: 기본 단축키 해제¶

쓰지 않는 단축키가 다른 프로그램과 충돌할 때 null로 해제하세요.

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

레시피 4: 확인 다이얼로그 커스터마이징¶

권한 확인 화면에서 Y/N 외에 추가 바인딩을 설정해요.

{
  "bindings": [
    {
      "context": "Confirmation",
      "bindings": {
        "ctrl+e": "confirm:toggleExplanation"
      }
    }
  ]
}

전체 액션 목록¶

앱 전체 (Global)¶

채팅 (Chat)¶

자동완성 (Autocomplete)¶

히스토리 검색 (HistorySearch)¶

작업 (Task)¶

Diff 뷰어 (DiffDialog)¶

레시피 5: 보이스 Push-to-Talk 키 변경¶

보이스 모드의 Push-to-Talk 키를 스페이스바 대신 다른 키로 바꿔요.

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+m": "voice:pushToTalk"
      }
    }
  ]
}

보이스 모드에 대한 자세한 내용은 27. 보이스 모드를 참고하세요.

Vim 모드와의 관계¶

/vim으로 Vim 모드를 켜면 h/j/k/l, dd, ciw 같은 Vim 키가 작동해요.

독립 동작 원칙

• Vim 모드: 텍스트 입력 레벨 (커서 이동, 모드 전환, 모션)
• 키바인딩: 컴포넌트 레벨 (할 일 토글, 메시지 전송 등)
• Escape는 Vim에서 INSERT → NORMAL 전환이지, chat:cancel이 아님
• 대부분의 Ctrl+ 조합은 Vim 모드를 통과해서 키바인딩 시스템으로 전달
• Vim NORMAL 모드에서 ?는 도움말 메뉴 표시

터미널 멀티플렉서 충돌¶

tmux나 screen을 쓴다면 주의하세요.

변경 불가능한 단축키¶

검증¶

Claude Code가 키바인딩 파일을 자동으로 검증해요. 문제가 있으면 경고를 보여줍니다.

/doctor

검증 항목:

• JSON 파싱 에러
• 잘못된 컨텍스트 이름
• 예약된 단축키 충돌
• 터미널 멀티플렉서 충돌
• 같은 컨텍스트 내 중복 바인딩

다음 단계¶

• 25. Status Line 커스터마이징 — 하단 바도 내 맘대로
• 13. 파워 유저 70가지 팁 — 더 많은 단축키 활용법
• 16. Hooks 실전 가이드 — 이벤트 기반 자동화