여기까지 왔다면

1편에서 필수 단축키를, 2편에서 Vim 모드를 다뤘다. 3편에서는 키 바인딩 커스터마이징과 특정 화면에서만 쓰는 세부 컨텍스트 단축키를 정리한다.

이 시리즈는 3편으로 구성된다.

키 바인딩 커스터마이징

설정 파일 열기

Claude Code 안에서 /keybindings를 입력하면 ~/.claude/keybindings.json 파일이 열린다. 없으면 자동 생성된다. 변경 사항은 재시작 없이 즉시 적용된다.

설정 형식

[
  {
    "key": "ctrl+enter",
    "command": "chat:submit",
    "when": "Chat"
  },
  {
    "key": "ctrl+shift+k",
    "command": "chat:clearInput",
    "when": "Global"
  }
]
  • key: 키 조합 (ctrl, alt, shift, meta + 키)
  • command: namespace:action 형식의 액션 이름
  • when: 적용 컨텍스트

바인딩 해제

특정 단축키를 비활성화하려면 command를 null로 설정한다.

[
  {
    "key": "ctrl+s",
    "command": null,
    "when": "Chat"
  }
]

사용 가능한 컨텍스트

컨텍스트설명
Global어디서나 동작
Chat채팅 입력 중
Autocomplete자동완성 메뉴
Confirmation확인/권한 다이얼로그
Settings설정 화면
Help도움말 화면
Transcript트랜스크립트 뷰어
HistorySearch히스토리 검색 모드
Tabs탭 내비게이션
Attachments이미지 첨부
Footer하단 바
MessageSelector메시지 선택 (되감기)
DiffDialog디프 뷰어
ModelPicker모델 선택
Scroll스크롤 모드
Plugin플러그인 관리자
Doctor/doctor 화면
ThemePicker테마 선택

바인딩 불가 키

다음 키는 터미널 수준에서 예약되어 있어 변경할 수 없다.

키이유
Ctrl+C인터럽트 시그널 (하드코딩)
Ctrl+DEOF 시그널 (하드코딩)
Ctrl+MEnter와 동일 (터미널에서 둘 다 CR 전송)

설정 검증

/doctor

키 바인딩 설정에 문제가 있으면 /doctor에서 확인할 수 있다.

트랜스크립트 뷰어

Ctrl+O로 트랜스크립트 뷰어를 열면, Claude가 어떤 도구를 실행했는지 상세하게 볼 수 있다. MCP 호출 내용도 여기서 확인 가능하다.

단축키기능
Ctrl+E전체 내용 펼치기/접기
/검색 모드 진입
n다음 검색 결과
N이전 검색 결과
q, Ctrl+C, Esc뷰어 닫기

풀스크린 모드에서 Ctrl+O를 반복하면 normal → transcript → focus view 순으로 전환된다.

디프 뷰어

Claude가 파일을 수정했을 때 나오는 디프 화면에서 쓸 수 있는 키다.

단축키기능
Esc디프 뷰어 닫기
← / →이전/다음 디프 소스
↑ / ↓이전/다음 파일
Enter디프 상세 보기

되감기 / 요약 (메시지 선택)

Esc × 2로 진입하는 메시지 선택 화면의 단축키다.

단축키기능
↑, K, Ctrl+P위로 이동
↓, J, Ctrl+N아래로 이동
Shift+K, Ctrl+↑맨 위로 점프
Shift+J, Ctrl+↓맨 아래로 점프
Enter메시지 선택

Vim 스타일의 J/K 이동도 지원하는 게 눈에 띈다.

스크롤 / 풀스크린 모드

풀스크린 렌더링이 활성화된 상태에서 사용 가능하다.

단축키기능
PageUp반 화면 위로 스크롤
PageDown반 화면 아래로 스크롤
Ctrl+Home대화 맨 처음으로
Ctrl+End최신 메시지로 (자동 따라가기 재활성화)
Ctrl+Shift+C / Cmd+C선택한 텍스트 클립보드에 복사
마우스 휠한 줄씩 스크롤

이미지 첨부 내비게이션

이미지를 여러 장 붙여넣은 후 관리할 때 쓴다.

단축키기능
→다음 첨부
←이전 첨부
Backspace / Delete선택한 첨부 삭제
↓ 또는 Esc첨부 내비게이션 종료

PR 상태, 태스크 등이 표시되는 하단 바에서 쓸 수 있는 키다.

단축키기능
← / →항목 이동
↑ / ↓위/아래 탐색
Enter선택한 항목 열기
Esc선택 해제
Cmd+클릭 (Mac)PR 링크를 브라우저에서 열기

설정 화면

/config로 진입하는 설정 화면의 단축키다.

단축키기능
/검색 모드
R사용량 데이터 다시 로드
Enter저장 후 닫기
Esc변경사항 버리고 닫기

모델 선택

Option+P로 모델 선택 화면에 진입하면:

단축키기능
←노력 수준(effort) 낮추기
→노력 수준 높이기

플러그인 관리자

단축키기능
Space플러그인 선택/해제
I선택한 플러그인 설치

터미널 멀티플렉서 충돌

tmux나 screen을 쓰고 있다면 일부 단축키가 충돌할 수 있다.

단축키충돌 대상해결법
Ctrl+Btmux 프리픽스두 번 눌러서 Claude Code로 전달
Ctrl+AGNU screen 프리픽스두 번 눌러서 전달
Ctrl+ZUnix 프로세스 일시정지 (SIGTSTP)의도치 않게 누르지 않도록 주의

tmux 사용자는 Ctrl+B를 백그라운드 전환에 쓸 때 항상 두 번 눌러야 한다는 것만 기억하면 된다.

한눈에 보기: 커스터마이징 요약

[키 바인딩]
/keybindings .... 설정 파일 열기
/doctor ......... 설정 검증
재시작 불필요 .... 변경 즉시 적용

[트랜스크립트 뷰어] (Ctrl+O)
/ ............... 검색
n / N ........... 다음/이전 결과
Ctrl+E .......... 전체 펼치기
q ............... 닫기

[디프 뷰어]
← / → .......... 디프 소스 전환
↑ / ↓ .......... 파일 전환
Esc ............. 닫기

[되감기] (Esc × 2)
J / K ........... 위/아래 이동
Enter ........... 선택

[주의: 멀티플렉서]
Ctrl+B .......... tmux와 충돌 (두 번 누르기)
Ctrl+A .......... screen과 충돌 (두 번 누르기)

시리즈를 마치며

3편에 걸쳐 Claude Code의 단축키를 정리했다. 솔직히 전부 외울 필요는 없다. 1편의 필수 단축키만 익혀도 충분하고, 나머지는 필요할 때 이 글을 찾아보면 된다.

한 가지 팁을 남기자면, Claude Code 안에서 ?를 누르면 현재 환경에서 쓸 수 있는 단축키가 바로 나온다. 이 글보다 그게 더 빠를 수 있다.

이 글은 2026년 4월 기준 Claude Code v2.1.x 기준으로 작성되었습니다. /keybindings 커스터마이징은 v2.1.18 이상이 필요합니다.

참고 자료