Claude Code 상세 사용법 71: Keybindings로 자주 쓰는 조작을 손에 맞추기 | DAKER 커뮤니티

Claude Code 상세 사용법 71: Keybindings로 자주 쓰는 조작을 손에 맞추기

Claude Code를 매일 쓰면 마우스로 메뉴를 찾는 시간이 누적됩니다. 외부 에디터 열기, 입력창 정리, 스크롤, voice 입력, 설정 열기 같은 조작은 단축키로 묶어야 흐름이 끊기지 않습니다. 공식 Keybindings 문서는 /keybindings로 ~/.claude/keybindings.json을 만들거나 열고, context별 keystroke와 action을 매핑할 수 있다고 설명합니다.

문제 상황

단축키를 아무렇게나 추가하면 더 느려집니다. 터미널이 먼저 키를 먹거나, vim mode와 충돌하거나, Chat에서는 맞지만 Transcript에서는 안 맞는 일이 생깁니다. 그래서 “자주 쓰는 조작 하나”를 고르고, context와 충돌을 확인하는 순서가 중요합니다.

핵심 개념

Keybindings 설정은 bindings 배열로 구성됩니다. 각 블록은 context와 키 입력별 action map을 가집니다. 값에 action 이름을 넣으면 연결되고, null을 넣으면 기본 단축키를 해제합니다. 파일 변경은 자동 감지되어 Claude Code 재시작 없이 적용됩니다.

따라 하는 단계

  1. Claude Code 안에서 설정 파일을 엽니다.

/keybindings

  1. 처음에는 Chat context에서 하나만 바꿉니다.

{
  "$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
      }
    }
  ]
}

  1. macOS에서 Option/Alt 조합이 동작하지 않으면 터미널 설정을 먼저 봅니다. iTerm2는 Option key를 Esc+로, VS Code 터미널은 terminal.integrated.macOptionIsMeta를 켜야 합니다.

실무 예시

외부 에디터를 자주 쓰는 팀은 ctrl+e를 편집기로 묶고, 실수로 입력을 날리는 기본키는 null로 해제합니다. 반대로 vim mode를 쓰는 사람은 편집 키를 새로 만들기보다 기존 vim 흐름과 충돌하지 않는 조합을 고르는 편이 좋습니다.

실수 방지 체크리스트

선임 엔지니어 takeaways

좋은 keybinding은 멋진 키 조합이 아니라 하루에 여러 번 반복되는 마찰을 줄이는 설정입니다. Claude Code를 오래 쓸수록 “모델이 똑똑한가”만큼 “내 손이 막히지 않는가”가 중요합니다. 단축키는 한 번에 많이 바꾸지 말고, 가장 자주 쓰는 조작부터 작게 고정하세요.

공식 출처: Anthropic Claude Code Keybindings, Terminal configuration 문서를 2026-06-18 Asia/Seoul 기준으로 확인했습니다.

Redirecting to Claude Code 상세 사용법 71: Keybindings로 자주 쓰는 조작을 손에 맞추기 | DAKER 커뮤니티...