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

Настраиваемые сочетания клавиш требуют Claude Code v2.1.18 или более поздней версии. Проверьте вашу версию с помощью claude --version.

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

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

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

Изменения в файле keybindings автоматически обнаруживаются и применяются без перезагрузки Claude Code.

Поле	Описание
`$schema`	Необязательный URL JSON Schema для автодополнения редактора
`$docs`	Необязательный URL документации
`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
      }
    }
  ]
}

Контексты

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

Контекст	Описание
`Global`	Применяется везде в приложении
`Chat`	Основная область ввода чата
`Autocomplete`	Меню автодополнения открыто
`Settings`	Меню параметров
`Confirmation`	Диалоги разрешений и подтверждений
`Tabs`	Компоненты навигации по вкладкам
`Help`	Меню справки видимо
`Transcript`	Средство просмотра стенограммы
`HistorySearch`	Режим поиска истории (Ctrl+R)
`Task`	Выполняется фоновая задача
`ThemePicker`	Диалог выбора темы
`Attachments`	Навигация по вложениям изображений в диалогах выбора
`Footer`	Навигация по индикатору нижнего колонтитула (задачи, команды, diff)
`MessageSelector`	Выбор сообщения в диалоге перемотки и резюме
`DiffDialog`	Навигация по средству просмотра diff
`ModelPicker`	Уровень усилий выбора модели
`Select`	Универсальные компоненты выбора/списка
`Plugin`	Диалог plugin (обзор, обнаружение, управление)
`Scroll`	Прокрутка разговора и выделение текста в полноэкранном режиме
`Doctor`	Экран диагностики `/doctor`

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

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

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

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

Действие	По умолчанию	Описание
`app:interrupt`	Ctrl+C	Отменить текущую операцию
`app:exit`	Ctrl+D	Выход из Claude Code
`app:redraw`	(не привязано)	Принудительно перерисовать терминал
`app:toggleTodos`	Ctrl+T	Переключить видимость списка задач
`app:toggleTranscript`	Ctrl+O	Переключить подробную стенограмму

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

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

Действие	По умолчанию	Описание
`history:search`	Ctrl+R	Открыть поиск истории
`history:previous`	Up	Предыдущий элемент истории
`history:next`	Down	Следующий элемент истории

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

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

Действие	По умолчанию	Описание
`chat:cancel`	Escape	Отменить текущий ввод
`chat:clearInput`	Ctrl+L	Принудительно перерисовать весь экран, сохраняя ввод. В полноэкранном рендеринге нажмите дважды в течение двух секунд для запуска `/clear`
`chat:clearScreen`	Cmd+K	В полноэкранном рендеринге нажмите дважды в течение двух секунд для запуска `/clear`
`chat:killAgents`	Ctrl+X Ctrl+K	Завершить всех фоновых подагентов в этом сеансе
`chat:cycleMode`	Shift+Tab*	Циклический перебор режимов разрешений
`chat:modelPicker`	Meta+P	Открыть выбор модели
`chat:fastMode`	Meta+O	Переключить быстрый режим
`chat:thinkingToggle`	Meta+T	Переключить расширенное мышление
`chat:submit`	Enter	Отправить сообщение
`chat:newline`	Ctrl+J	Вставить новую строку без отправки
`chat:undo`	Ctrl+_, Ctrl+Shift+-	Отменить последнее действие
`chat:externalEditor`	Ctrl+G, Ctrl+X Ctrl+E	Открыть во внешнем редакторе
`chat:stash`	Ctrl+S	Спрятать текущий запрос
`chat:imagePaste`	Ctrl+V (Alt+V на Windows)	Вставить изображение

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

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

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

Действие	По умолчанию	Описание
`autocomplete:accept`	Tab	Принять предложение
`autocomplete:dismiss`	Escape	Закрыть меню
`autocomplete:previous`	Up	Предыдущее предложение
`autocomplete:next`	Down	Следующее предложение

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

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

Действие	По умолчанию	Описание
`confirm:yes`	Y, Enter	Подтвердить действие
`confirm:no`	N, Escape	Отклонить действие
`confirm:previous`	Up	Предыдущий вариант
`confirm:next`	Down	Следующий вариант
`confirm:nextField`	Tab	Следующее поле
`confirm:previousField`	(не привязано)	Предыдущее поле
`confirm:toggle`	Space	Переключить выбор
`confirm:cycleMode`	Shift+Tab	Циклический перебор режимов разрешений
`confirm:toggleExplanation`	Ctrl+E	Переключить объяснение разрешения

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

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

Действие	По умолчанию	Описание
`permission:toggleDebug`	Ctrl+D	Переключить информацию отладки разрешения

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

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

Действие	По умолчанию	Описание
`transcript:toggleShowAll`	Ctrl+E	Переключить отображение всего содержимого
`transcript:exit`	q, Ctrl+C, Escape	Выход из просмотра стенограммы

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

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

Действие	По умолчанию	Описание
`historySearch:next`	Ctrl+R	Следующее совпадение
`historySearch:accept`	Escape, Tab	Принять выбор
`historySearch:cancel`	Ctrl+C	Отменить поиск
`historySearch:execute`	Enter	Выполнить выбранную команду
`historySearch:cycleScope`	Ctrl+S	Циклический перебор области: сеанс, проект, везде

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

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

Действие	По умолчанию	Описание
`task:background`	Ctrl+B	Переместить текущую задачу в фон

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

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

Действие	По умолчанию	Описание
`theme:toggleSyntaxHighlighting`	Ctrl+T	Переключить подсветку синтаксиса

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

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

Действие	По умолчанию	Описание
`help:dismiss`	Escape	Закрыть меню справки

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

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

Действие	По умолчанию	Описание
`tabs:next`	Tab, Right	Следующая вкладка
`tabs:previous`	Shift+Tab, Left	Предыдущая вкладка

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

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

Действие	По умолчанию	Описание
`attachments:next`	Right	Следующее вложение
`attachments:previous`	Left	Предыдущее вложение
`attachments:remove`	Backspace, Delete	Удалить выбранное вложение
`attachments:exit`	Down, Escape	Выход из навигации по вложениям

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

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

Действие	По умолчанию	Описание
`footer:next`	Right	Следующий элемент нижнего колонтитула
`footer:previous`	Left	Предыдущий элемент нижнего колонтитула
`footer:up`	Up	Навигация вверх в нижнем колонтитуле (отмена выбора в верхней части)
`footer:down`	Down	Навигация вниз в нижнем колонтитуле
`footer:openSelected`	Enter	Открыть выбранный элемент нижнего колонтитула
`footer:clearSelection`	Escape	Очистить выбор нижнего колонтитула

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

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

Действие	По умолчанию	Описание
`messageSelector:up`	Up, K, Ctrl+P	Переместиться вверх в списке
`messageSelector:down`	Down, J, Ctrl+N	Переместиться вниз в списке
`messageSelector:top`	Ctrl+Up, Shift+Up, Meta+Up, Shift+K	Перейти в начало
`messageSelector:bottom`	Ctrl+Down, Shift+Down, Meta+Down, Shift+J	Перейти в конец
`messageSelector:select`	Enter	Выбрать сообщение

Действия diff

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

Действие	По умолчанию	Описание
`diff:dismiss`	Escape	Закрыть средство просмотра diff
`diff:previousSource`	Left	Предыдущий источник diff
`diff:nextSource`	Right	Следующий источник diff
`diff:previousFile`	Up	Предыдущий файл в diff
`diff:nextFile`	Down	Следующий файл в diff
`diff:viewDetails`	Enter	Просмотреть детали diff
`diff:back`	(зависит от контекста)	Вернуться в средстве просмотра diff

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

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

Действие	По умолчанию	Описание
`modelPicker:decreaseEffort`	Left	Уменьшить уровень усилий
`modelPicker:increaseEffort`	Right	Увеличить уровень усилий

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

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

Действие	По умолчанию	Описание
`select:next`	Down, J, Ctrl+N	Следующий вариант
`select:previous`	Up, K, Ctrl+P	Предыдущий вариант
`select:accept`	Enter	Принять выбор
`select:cancel`	Escape	Отменить выбор

Действия plugin

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

Действие	По умолчанию	Описание
`plugin:toggle`	Space	Переключить выбор plugin
`plugin:install`	I	Установить выбранные plugins
`plugin:favorite`	F	Добавить выбранный plugin в избранное, чтобы он сортировался ближе к верхней части вкладки Installed

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

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

Действие	По умолчанию	Описание
`settings:search`	/	Перейти в режим поиска
`settings:retry`	R	Повторить загрузку данных об использовании (при ошибке)
`settings:close`	Enter	Сохранить изменения и закрыть панель конфигурации. Escape отменяет изменения и закрывает

Действия Doctor

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

Действие	По умолчанию	Описание
`doctor:fix`	F	Отправить отчёт диагностики Claude для исправления сообщённых проблем. Активно только при обнаружении проблем

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

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

Действие	По умолчанию	Описание
`voice:pushToTalk`	Space	Диктовать запрос. Удерживайте или нажимайте в зависимости от режима `/voice`

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

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

Действие	По умолчанию	Описание
`scroll:lineUp`	(не привязано)	Прокрутить вверх на одну строку. Прокрутка колесом мыши запускает это действие
`scroll:lineDown`	(не привязано)	Прокрутить вниз на одну строку. Прокрутка колесом мыши запускает это действие
`scroll:pageUp`	PageUp	Прокрутить вверх на половину высоты окна просмотра
`scroll:pageDown`	PageDown	Прокрутить вниз на половину высоты окна просмотра
`scroll:top`	Ctrl+Home	Перейти в начало разговора
`scroll:bottom`	Ctrl+End	Перейти к последнему сообщению и повторно включить автоследование
`scroll:halfPageUp`	(не привязано)	Прокрутить вверх на половину высоты окна просмотра. То же поведение, что и `scroll:pageUp`, предоставляется для переназначений в стиле vi
`scroll:halfPageDown`	(не привязано)	Прокрутить вниз на половину высоты окна просмотра. То же поведение, что и `scroll:pageDown`, предоставляется для переназначений в стиле vi
`scroll:fullPageUp`	(не привязано)	Прокрутить вверх на полную высоту окна просмотра
`scroll:fullPageDown`	(не привязано)	Прокрутить вниз на полную высоту окна просмотра
`selection:copy`	Ctrl+Shift+C / Cmd+C	Скопировать выделённый текст в буфер обмена
`selection:clear`	(не привязано)	Очистить активное выделение текста
`selection:extendLeft`	Shift+Left	Расширить активное выделение на один столбец влево
`selection:extendRight`	Shift+Right	Расширить активное выделение на один столбец вправо
`selection:extendUp`	Shift+Up	Расширить активное выделение на одну строку вверх. Прокручивает окно просмотра, когда выделение достигает верхнего края
`selection:extendDown`	Shift+Down	Расширить активное выделение на одну строку вниз. Прокручивает окно просмотра, когда выделение достигает нижнего края
`selection:extendLineStart`	Shift+Home	Расширить активное выделение до начала строки
`selection:extendLineEnd`	Shift+End	Расширить активное выделение до конца строки

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

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

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

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

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

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

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

Сочетание клавиш	Причина
Ctrl+C	Жёстко закодированное прерывание/отмена
Ctrl+D	Жёстко закодированный выход
Ctrl+M	Идентично Enter в терминалах (оба отправляют CR)
Caps Lock	Не передаётся в приложения терминала

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

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

Сочетание	Конфликт
Ctrl+B	Префикс tmux (нажмите дважды для отправки)
Ctrl+A	Префикс GNU screen
Ctrl+Z	Приостановка процесса Unix (SIGTSTP)

Взаимодействие с режимом 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.

Параметры и разрешения

Модель и ответы

Интерфейс

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

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

Контексты

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Действия diff

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

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

Действия plugin

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

Действия Doctor

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

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

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

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

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

Аккорды

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

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

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

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

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

Валидация

Параметры и разрешения

Модель и ответы

Интерфейс

Documentation Index

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

​Контексты

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

​Действия diff

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

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

​Действия plugin

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

​Действия Doctor

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

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

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

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

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

​Аккорды

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

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

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

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

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

​Валидация

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

Контексты

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Действия diff

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

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

Действия plugin

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

Действия Doctor

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

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

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

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

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

Аккорды

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

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

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

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

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

Валидация