Настройка сочетаний клавиш

Настройте сочетания клавиш в Claude Code с помощью файла конфигурации keybindings.

Claude Code поддерживает настраиваемые сочетания клавиш. Запустите /keybindings для создания или открытия файла конфигурации в ~/.claude/keybindings.json.

Файл конфигурации

Файл конфигурации keybindings — это объект с массивом bindings. Каждый блок указывает контекст и карту нажатий клавиш на действия.

Этот пример привязывает Ctrl+E к открытию внешнего редактора в контексте чата и отменяет привязку Ctrl+U:

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

Контексты

Каждый блок привязки указывает контекст, где применяются привязки:

Доступные действия

Действия следуют формату namespace:action, например chat:submit для отправки сообщения или app:toggleTodos для отображения списка задач. Каждый контекст имеет определённые доступные действия.

Действия приложения

Действия, доступные в контексте Global:

Действия истории

Действия для навигации по истории команд:

Действия чата

Действия, доступные в контексте Chat:

*На Windows без режима VT (Node <24.2.0/<22.17.0, Bun <1.2.23) по умолчанию используется Meta+M.

Действия автодополнения

Действия, доступные в контексте Autocomplete:

Действия подтверждения

Действия, доступные в контексте Confirmation:

Действия разрешений

Действия, доступные в контексте Confirmation для диалогов разрешений:

Действия стенограммы

Действия, доступные в контексте Transcript:

Действия поиска истории

Действия, доступные в контексте HistorySearch:

Действия задачи

Действия, доступные в контексте Task:

Действия темы

Действия, доступные в контексте ThemePicker:

Действия справки

Действия, доступные в контексте Help:

Действия вкладок

Действия, доступные в контексте Tabs:

Действия вложений

Действия, доступные в контексте Attachments:

Действия нижнего колонтитула

Действия, доступные в контексте Footer:

Действия выбора сообщения

Действия, доступные в контексте MessageSelector:

Действия diff

Действия, доступные в контексте DiffDialog:

Действия выбора модели

Действия, доступные в контексте ModelPicker:

Действия выбора

Действия, доступные в контексте Select:

Действия plugin

Действия, доступные в контексте Plugin:

Действия параметров

Действия, доступные в контексте Settings:

Действия Doctor

Действия, доступные в контексте Doctor:

Действия голоса

Действия, доступные в контексте Chat при включённой диктовке голосом:

Действия прокрутки

Действия, доступные в контексте Scroll при включённом полноэкранном рендеринге:

Синтаксис нажатия клавиш

Модификаторы

Используйте клавиши-модификаторы с разделителем +:

• ctrl или control - клавиша Control
• shift - клавиша Shift
• alt, opt, option или meta - клавиша Alt в Windows и Linux, клавиша Option в macOS
• cmd, command, super или win - клавиша Command в macOS, клавиша Windows в Windows, клавиша Super в Linux

Группа cmd обнаруживается только в терминалах, которые сообщают о модификаторе Super, таких как те, которые поддерживают протокол клавиатуры Kitty или режим modifyOtherKeys xterm. Большинство терминалов его не отправляют, поэтому используйте ctrl или meta для привязок, которые вы хотите использовать везде.

Например:

ctrl+k          Ctrl + K
shift+tab       Shift + Tab
meta+p          Option + P в macOS, Alt + P в других местах
ctrl+shift+c    Несколько модификаторов

Прописные буквы

Отдельная прописная буква подразумевает Shift. Например, K эквивалентна shift+k. Это полезно для привязок в стиле vim, где прописные и строчные клавиши имеют разные значения.

Прописные буквы с модификаторами (например, ctrl+K) рассматриваются как стилистические и не подразумевают Shift: ctrl+K то же самое, что ctrl+k.

Аккорды

Аккорды — это последовательности нажатий клавиш, разделённые пробелами:

ctrl+k ctrl+s   Нажмите Ctrl+K, отпустите, затем Ctrl+S

Специальные клавиши

• escape или esc - клавиша Escape
• enter или return - клавиша Enter
• tab - клавиша Tab
• space - пробел
• up, down, left, right - клавиши со стрелками
• backspace, delete - клавиши удаления

Отмена привязки сочетаний по умолчанию

Установите действие на null для отмены привязки сочетания по умолчанию:

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

Это также работает для привязок аккордов. Отмена привязки каждого аккорда, который использует префикс, освобождает этот префикс для использования в качестве привязки с одной клавишей:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

Если вы отмените привязку некоторых, но не всех аккордов на префиксе, нажатие префикса всё ещё переводит в режим ожидания аккорда для оставшихся привязок.

Зарезервированные сочетания клавиш

Эти сочетания клавиш не могут быть переназначены:

Конфликты терминала

Некоторые сочетания могут конфликтовать с мультиплексорами терминала:

Взаимодействие с режимом vim

Когда включен режим vim через /config → Editor mode, keybindings и режим vim работают независимо:

• Режим vim обрабатывает ввод на уровне текстового ввода (движение курсора, режимы, движения)
• Keybindings обрабатывают действия на уровне компонента (переключение задач, отправка и т. д.)
• Клавиша Escape в режиме vim переключает INSERT в NORMAL режим; она не запускает chat:cancel
• Большинство сочетаний Ctrl+клавиша проходят через режим vim в систему keybindings
• В режиме vim NORMAL ? показывает меню справки (поведение vim)

Валидация

Claude Code проверяет ваши keybindings и показывает предупреждения для:

• Ошибок разбора (неверный JSON или структура)
• Неверных имён контекстов
• Конфликтов зарезервированных сочетаний
• Конфликтов мультиплексоров терминала
• Дублирующихся привязок в одном контексте

Запустите /doctor для просмотра любых предупреждений keybindings.