키보드 단축키 사용자 정의

구성 파일

{
  "$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+s": null
      }
    }
  ]
}

컨텍스트

사용 가능한 작업

앱 작업

기록 작업

채팅 작업

자동 완성 작업

확인 작업

{
  "bindings": [
    {
      "context": "Confirmation",
      "bindings": {
        "y": "confirm:yes",
        "n": "confirm:no"
      }
    }
  ]
}

권한 작업

기록 작업

기록 검색 작업

작업 작업

테마 작업

도움말 작업

탭 작업

첨부 파일 작업

바닥글 작업

메시지 선택기 작업

{
  "bindings": [
    {
      "context": "MessageSelector",
      "bindings": {
        "o": "select:accept"
      }
    }
  ]
}

차이 작업

차이 패널 작업

모델 선택기 작업

노력 슬라이더 작업

선택 작업

플러그인 작업

프롬프트 위 영역 작업

창 작업

설정 작업

에이전트 작업

음성 작업

스크롤 작업

키 입력 구문

수정자

• ctrl 또는 control - Control 키
• shift - Shift 키
• alt, opt, option, 또는 meta - Windows 및 Linux의 Alt 키, macOS의 Option 키
• cmd, command, super, 또는 win - macOS의 Command 키, Windows의 Windows 키, Linux의 Super 키

ctrl+k          Ctrl + K
shift+tab       Shift + Tab
meta+p          macOS의 Option + P, 다른 곳의 Alt + P
ctrl+shift+c    여러 수정자

대문자

비US 키보드 레이아웃

• Cyrillic과 같은 비라틴 레이아웃에서 Claude Code는 터미널이 Kitty 키보드 프로토콜을 사용하고 해당 위치를 보고할 때 키의 US 레이아웃 위치로 Ctrl 바로가기를 일치시킵니다. 러시아어 레이아웃이 활성화된 그러한 터미널에서 Ctrl과 물리적 W 키를 누르면 ctrl+w가 트리거됩니다. 위치를 보고하지 않는 터미널에서 Claude Code는 키 입력에 대해 터미널이 전송하는 것과 일치합니다: ASCII 제어 코드는 라틴 바로가기를 트리거하고 Cyrillic 문자로 도착하는 키 입력은 바인딩과 일치하지 않습니다
• AZERTY와 같이 라틴 문자를 재배열하는 레이아웃에서 Claude Code는 키가 입력하는 문자와 일치하므로 Ctrl과 A로 표시된 키를 누르면 ctrl+a가 트리거됩니다

코드

ctrl+k ctrl+s   Ctrl+K를 누르고 놓은 다음 Ctrl+S를 누릅니다

특수 키

• escape 또는 esc - Escape 키
• enter 또는 return - Enter 키
• tab - Tab 키
• space - 스페이스바
• up, down, left, right - 화살표 키
• pageup, pagedown - Page Up 및 Page Down 키
• home, end - Home 및 End 키
• backspace, delete - Delete 키
• wheelup, wheeldown - 마우스 휠 스크롤 이벤트

기본 단축키 바인딩 해제

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

• Chat: ctrl+x ctrl+k, ctrl+x ctrl+e, ctrl+x enter, ctrl+x ctrl+a, ctrl+x ctrl+s, ctrl+x tab, ctrl+x ctrl+=, ctrl+x ctrl+-, ctrl+x ctrl+_, ctrl+x =, ctrl+x -
• Task: ctrl+x ctrl+b
• DiffPanel: ctrl+x b
• Pane: ctrl+x left, ctrl+x right, ctrl+x up, ctrl+x down, ctrl+x x
• PaneField: ctrl+x x

{
  "bindings": [
    {
      "context": "Task",
      "bindings": {
        "ctrl+x ctrl+b": null
      }
    },
    {
      "context": "DiffPanel",
      "bindings": {
        "ctrl+x b": null
      }
    },
    {
      "context": "Pane",
      "bindings": {
        "ctrl+x left": null,
        "ctrl+x right": null,
        "ctrl+x up": null,
        "ctrl+x down": null,
        "ctrl+x x": null
      }
    },
    {
      "context": "PaneField",
      "bindings": {
        "ctrl+x x": null
      }
    },
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x enter": null,
        "ctrl+x ctrl+a": null,
        "ctrl+x ctrl+s": null,
        "ctrl+x tab": null,
        "ctrl+x ctrl+=": null,
        "ctrl+x ctrl+-": null,
        "ctrl+x ctrl+_": null,
        "ctrl+x =": null,
        "ctrl+x -": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

예약된 단축키

터미널 충돌

텍스트 필드

• Enter, Escape, Tab 및 화살표 키와 같이 문자를 입력하지 않는 키
• Ctrl, Alt 또는 Cmd와 함께 누르는 모든 키
• 이미 진행 중인 코드의 두 번째 키 입력

Vim 모드 상호 작용

• Vim 모드는 텍스트 입력 수준에서 입력을 처리합니다: 커서 이동, 모드, 모션
• 키보드 단축키는 할 일 전환이나 메시지 제출과 같은 작업을 구성 요소 수준에서 처리합니다.
• vim 모드에서 Escape 키는 INSERT 모드를 NORMAL 모드로 전환하며, chat:cancel을 트리거하지 않습니다
• 대부분의 Ctrl+key 단축키는 vim 모드를 통과하여 키바인딩 시스템으로 이동합니다.
• Vim 키는 키바인딩 파일을 통해 다시 매핑할 수 없습니다. jj를 Escape로 매핑하는 것과 같은 두 키 INSERT 모드 시퀀스를 매핑하려면 vimInsertModeRemaps 설정을 사용합니다.
• vim NORMAL 모드에서 ?는 도움말 메뉴를 표시합니다(vim 동작).
• vim NORMAL 모드에서 /는 히스토리 검색을 열며, 표준 모드의 Ctrl+R과 동일합니다.

키 한 번으로 질문 취소하기

{
  "bindings": [
    {
      "context": "Select",
      "bindings": {
        "ctrl+q": "select:cancel"
      }
    }
  ]
}

유효성 검사

• 구문 분석 오류(잘못된 JSON 또는 구조)
• ctl+k와 같이 철자가 잘못된 수정자 키. Claude Code는 해당 바인딩 전체를 무시합니다. 수정자 키를 올바르게 고치세요. 이 예에서는 ctrl+k로 수정합니다.
• ctrl+ k와 같이 키 문자열에서 + 옆에 공백이 있는 경우. Claude Code는 이 문자열을 ctrl+ 다음에 k가 오는 코드로 읽습니다. ctrl+ 단독과 일치하는 키 입력은 없으므로 이 바인딩은 절대 실행되지 않습니다. 공백을 제거하세요.
• 잘못된 컨텍스트 이름
• 문자열도 null도 아닌 작업과 같은 잘못된 작업 값
• 등록된 작업 이름의 오타와 같은 알 수 없는 작업 이름. Claude Code는 해당 바인딩을 건너뛰고 그 키에 대한 기본 바인딩을 계속 적용합니다.
• 예약된 단축키 충돌
• 동일한 컨텍스트 내의 중복 바인딩