Cmd. /keybindings
키 바인딩 설정 파일(~/.claude/keybindings.json)을 열거나 생성하는 명령
핵심 요약
- keyboard shortcut 파일 열기
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
keyboard shortcut 파일 열기
/keybindings사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/keybindings설정 파일의 기본 형식은 다음과 같습니다. 아래 예시는 Chat 컨텍스트에서 Ctrl+E를 외부 에디터 열기에 바인딩하고, Ctrl+U 기본 바인딩은 null로 해제합니다.
{
"$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
}
}
]
}주요 필드
| 필드 | 설명 |
|---|---|
$schema | (선택) 에디터 자동완성용 JSON 스키마 URL |
$docs | (선택) 문서 URL |
bindings | 컨텍스트별 바인딩 블록 배열 |
키스트로크 문법
- 모디파이어:
+로 결합 —ctrl/control,shift,alt/opt/option/meta,cmd/command/super/win.meta는 macOS의 Option, Windows·Linux의 Alt에 매핑됩니다.cmd계열은 Super 모디파이어를 보고하는 터미널(Kitty 프로토콜, xtermmodifyOtherKeys)에서만 인식됩니다. 대부분의 터미널에서는ctrl또는meta를 사용하세요.
- 대문자: 단독 대문자
K는shift+k와 동일. 단, 모디파이어가 붙은ctrl+K는ctrl+k와 같으며 Shift를 함의하지 않습니다. - 코드(chord): 공백으로 구분한 키 시퀀스 —
ctrl+k ctrl+s는Ctrl+K를 누르고 떼었다가Ctrl+S를 누름. - 특수 키:
escape/esc,enter/return,tab,space,up/down/left/right,backspace/delete.
선택 시점
Chat컨텍스트에서chat:externalEditor를 원하는 키로 재바인딩해 외부 에디터를 빠르게 열기.- 기본 단축키를
null로 설정해 비활성화하기(예: 충돌하는ctrl+u해제). - Vim 모드 사용자를 위한 스크롤 vi 스타일 바인딩 구성(
scroll:halfPageUp/scroll:halfPageDown등은 기본 미바인딩 상태로 제공).
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/keybindings | 키 바인딩 설정 파일 열기/생성 | 단축키를 직접 커스터마이즈할 때 |
/config | Editor mode(Vim 등) 등 설정 토글 | 입력 모드 전환·일반 설정 변경 목적 |
/terminal-setup | Shift+Enter 등 터미널 단축키 구성 | VS Code·Cursor·Zed 등 터미널별 입력 문제 점검 |
/doctor | 키 바인딩 경고를 포함한 진단 | 바인딩 충돌·오류 검증 시 |
실행 결과와 유지 범위
단축키 설정 파일을 열어 입력 동작을 변경할 수 있게 합니다.
공식 문서의 정의는 "Open or create your keybindings configuration file"(키 바인딩 설정 파일을 열거나 생성한다)입니다.
/keybindings를 실행하면 ~/.claude/keybindings.json 파일이 없으면 생성하고, 있으면 엽니다. 이 파일에서 컨텍스트별 키 바인딩을 직접 고쳐 단축키를 커스터마이즈합니다.
- 설정 파일은
bindings배열을 담은 객체이며, 각 블록은 컨텍스트(context) 와 키스트로크 → 액션 맵을 지정합니다. - 액션은
namespace:action형식입니다(예:chat:submit은 메시지 전송,app:toggleTodos는 작업 목록 토글). - 파일 변경 사항은 Claude Code를 재시작하지 않아도 자동으로 감지·적용됩니다.
별칭(alias)은 없으며, 번들 스킬이나 워크플로우가 아닌 일반 내장 명령입니다.
주의사항
- 재바인딩 불가(예약 단축키):
Ctrl+C(인터럽트/취소),Ctrl+D(종료),Ctrl+M(터미널에서 Enter와 동일),Caps Lock은 변경할 수 없습니다. - 터미널 충돌:
Ctrl+B(tmux 프리픽스),Ctrl+A(GNU screen 프리픽스),Ctrl+Z(프로세스 일시정지)는 멀티플렉서와 충돌할 수 있습니다. - Vim 모드 상호작용:
/config→ Editor mode로 Vim 모드를 켜면, Vim 모드(텍스트 입력 레벨)와 키 바인딩(컴포넌트 레벨)이 독립적으로 동작합니다. Vim의 Escape는 INSERT→NORMAL 전환이며chat:cancel을 트리거하지 않습니다. - 검증: Claude Code는 JSON 파싱 오류, 잘못된 컨텍스트 이름, 예약 단축키 충돌, 멀티플렉서 충돌, 동일 컨텍스트 내 중복 바인딩을 경고합니다.
/doctor로 키 바인딩 경고를 확인할 수 있습니다. - 공유 환경에서는
bindings항목을null로 두거나 파일을 제거해 기본값으로 복구하는 경로를 문서화해 두세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록