Сочетания клавиш
Сочетания клавиш могут различаться в зависимости от платформы и терминала. В полноэкранном режиме нажмите
? в средстве просмотра стенограммы, чтобы увидеть доступные там сочетания клавиш.Пользователи macOS: сочетания клавиш с клавишей Option/Alt (Alt+B, Alt+F, Alt+D, Alt+Y, Alt+P) требуют настройки Option как Meta в вашем терминале. См. Включение сочетаний клавиш Option на macOS для параметра в каждом терминале.Общие элементы управления
Редактирование текста
Границы слов в сочетаниях редактирования
Сочетания словAlt+B, Alt+F, Alt+D, Option+Delete и Ctrl+Backspace рассматривают слово как последовательность букв и цифр, поэтому пунктуация, такая как _, . и /, разделяет слова. С src/utils/foo.ts в подсказке повторные нажатия Alt+B останавливаются в начале ts, foo, utils и src.
Ctrl+W отличается: он игнорирует пунктуацию и удаляет назад до предыдущего пробела, поэтому одно нажатие удаляет все src/utils/foo.ts.
В тексте, написанном без пробелов, таком как китайский или японский, сочетания слов по-прежнему перемещают или удаляют одно слово за раз.
Эти соглашения readline применяются в Claude Code v2.1.261 и более поздних версиях. Параметр keybindingFlavor, который включал их в более ранних версиях, устарел и не имеет эффекта.
Вы не можете переназначить эти сочетания в файле конфигурации сочетаний клавиш, в котором нет действий для них.
Тема и отображение
Многострочный ввод
Быстрые команды
Средство просмотра стенограммы
Когда средство просмотра стенограммы открыто (переключается с помощьюCtrl+O), доступны эти сочетания клавиш. Запустите /tui без аргумента, чтобы проверить, какой рендерер активен. Ctrl+E можно переназначить через transcript:toggleShowAll.
Голосовой ввод
Команды
Введите/ в Claude Code, чтобы увидеть доступные вам команды, или введите / с последующими буквами для фильтрации. Меню / содержит встроенные команды, включённые и созданные пользователем skills, а также команды, предоставленные plugins и MCP servers. Не все встроенные команды видны каждому пользователю, так как некоторые зависят от вашей платформы или плана, и несколько доступных команд скрыты из меню по замыслу и запускаются при вводе их полного имени.
В полноэкранном режиме отображения команда / и списки предложений файлов @ также реагируют на мышь: наведение выделяет строку, а клик принимает её.
Полный список команд, включённых в Claude Code, см. в справочнике команд.
Завершение команды в середине подсказки
Завершение команды также работает в середине подсказки: введите/ после пробела, затем первые буквы имени, как в run the tests, then /com. Совпадают только команды, имена которых начинаются с этих букв, поэтому путь файла, такой как /tmp/notes.md, не открывает список. Claude Code запускает команду только когда команда начинает ваше сообщение.
- В полноэкранном режиме отображения: совпадения открываются в виде списка во время ввода, без выделенной строки, поэтому
Enterпо-прежнему отправляет вашу подсказку в том виде, в котором она введена. НажмитеTabдля вставки верхнего совпадения или выберите строку стрелками иEnter. - Вне полноэкранного режима: остаток верхнего совпадения появляется как призрачный текст в вашем курсоре с подсчётом, например
+2, когда совпадают несколько команд. НажмитеTabдля вставки единственного совпадения или для открытия списка, когда совпадают несколько, затем выберите строку стрелками иEnter.
Tab на голом / в середине подсказки, чтобы вывести список всех команд.
Skill плагина совпадает и по его простому имени, поэтому /deploy находит skill с именем myplugin:deploy-app. Когда вы вставляете совпадение, Claude Code записывает полный /myplugin:deploy-app.
Режим редактора Vim
Включите редактирование в стиле vim через/config → Editor mode.
Claude Code сохраняет ваш режим vim и позицию курсора при переключении средства просмотра стенограммы с помощью Ctrl+O или при открытии и закрытии панели, такой как /config. Если вы оставите приглашение в режиме NORMAL, оно остаётся в режиме NORMAL при возврате, с курсором там, где вы его оставили.
Переключение режимов
Переназначение последовательностей клавиш в режиме INSERT
ПараметрvimInsertModeRemaps отображает двухклавишную последовательность режима INSERT на Escape, поэтому отображение, такое как jj, возвращает вас в режим NORMAL. Требует Claude Code v2.1.208 или более позднюю версию.
Следующий пример ~/.claude/settings.json включает режим vim и отображает jj на Escape:
"<Esc>" — единственная поддерживаемая цель. Записи с другой длиной или целью игнорируются.
Ввод первого символа последовательности вставляет его обычным образом. Нажатие второго символа в течение одной секунды удаляет этот ожидающий символ и переключается в режим NORMAL, не оставляя ни одного символа в вашем вводе. После истечения окна в одну секунду или если следует другая клавиша, оба символа остаются как буквальный текст, поэтому вы всё ещё можете ввести слово, содержащее последовательность, сделав паузу между двумя клавишами.
Claude Code читает этот параметр из файла пользовательских параметров, флага --settings и управляемых параметров только. Записи в .claude/settings.json или .claude/settings.local.json проекта игнорируются, поэтому проверенный репозиторий не может переназначить ваши нажатия клавиш.
Навигация (режим NORMAL)
В режиме vim NORMAL, если курсор находится в начале или конце ввода и не может двигаться дальше,
j/k и ↑/↓ переходят по истории команд вместо этого. ← на пустом приглашении открывает представление агента как из режима NORMAL, так и из INSERT; до v2.1.219 ← на пустом приглашении ничего не делал в режиме NORMAL.Редактирование (режим NORMAL)
Текстовые объекты (режим NORMAL)
Текстовые объекты работают с операторами, такими какd, c и y:
Режим VISUAL
Нажмитеv для выделения по символам или V для выделения по строкам. Движения расширяют выделение, а операторы действуют на него напрямую.
Режим выделения по блокам с
Ctrl+V не поддерживается.
История команд
Claude Code сохраняет историю введённых вами подсказок, и вызов с помощью стрелки вверх позволяет получить подсказки из предыдущих сеансов одного проекта:- История ввода хранится для каждого рабочего каталога
- Выполнение
/clearначинает новый сеанс: при вызове истории сначала отображаются подсказки нового сеанса, а затем подсказки из более ранних сеансов. Разговор из предыдущего сеанса сохраняется и может быть возобновлен. - Если вы отправите одну и ту же подсказку дважды подряд, будет записана одна запись в истории, поэтому нажатие стрелки вверх переходит к предыдущей отличающейся подсказке
- Когда вы вызываете подсказку, которая включала вставленный текст, Claude Code отправляет полное содержимое вставки при повторной отправке. Если содержимое было очищено, Claude Code не отправляет буквальную строку
[Pasted text #N]; см. Вставка большого содержимого для информации о том, что происходит с подсказкой - Расширение истории с помощью
!отключено по умолчанию
Обратный поиск с помощью Ctrl+R
НажмитеCtrl+R для интерактивного поиска в истории команд. В полноэкранном режиме Ctrl+R открывает диалоговое окно поиска: введите текст для фильтрации, нажимайте Up и Down для перемещения по совпадениям и нажимайте Ctrl+S для переключения области поиска между этим сеансом, этим проектом и всеми проектами. Нажмите Enter или Tab для размещения совпадения в поле ввода подсказки или Esc для отмены. Шаги ниже описывают встроенный поиск классического средства визуализации:
- Начать поиск: нажмите
Ctrl+Rдля активации обратного поиска по истории - Введите запрос: введите текст для поиска в предыдущих командах. Поисковый термин выделяется в совпадающих результатах
- Навигация по совпадениям: нажмите
Ctrl+Rснова для перемещения по более старым совпадениям - Область поиска: встроенный поиск всегда ищет подсказки из всех проектов
- Принять совпадение:
- Нажмите
TabилиEscдля принятия текущего совпадения и продолжения редактирования - Нажмите
Enterдля принятия и немедленного выполнения команды
- Нажмите
- Отмена поиска:
- Нажмите
Ctrl+Cдля отмены и восстановления исходного ввода - Нажмите
Backspaceпри пустом поиске для отмены
- Нажмите
Фоновые команды Bash
Claude Code поддерживает запуск команд Bash в фоне, позволяя вам продолжать работу, пока выполняются долгоживущие процессы.Как работает фоновое выполнение
Когда Claude Code запускает команду в фоне, она выполняется асинхронно и немедленно возвращает ID фоновой задачи. Claude Code может отвечать на новые запросы, пока команда продолжает выполняться в фоне. Для запуска команд в фоне вы можете:- Попросить Claude Code запустить команду в фоне
- Нажать
Ctrl+Bдля перемещения обычного вызова инструмента Bash в фон. Пользователи Tmux должны нажатьCtrl+Bдважды из-за префиксного ключа tmux.
sleep. Если вы отключили фоновые задачи с помощью CLAUDE_CODE_DISABLE_BACKGROUND_TASKS или запустив в режиме bare, команда останавливается при достижении времени ожидания. Чтобы изменить время ожидания, установите переменные окружения для времени ожидания Bash.
Ключевые возможности:
- Вывод записывается в файл, и Claude может получить его с помощью инструмента Read
- Фоновые задачи имеют уникальные ID для отслеживания и получения вывода
- Фоновые задачи автоматически очищаются при выходе из Claude Code. На macOS и Linux, когда вы останавливаете фоновую задачу из
/tasksили Claude Code останавливает её при выходе, процессы, отделённые от оболочки задачи, такие как запущенные подsetsidилиtimeout, также останавливаются - Если вы переводите сеанс в фон вместо выхода, ваши фоновые задачи продолжают работать в фоновом сеансе. См. перевод работающего сеанса в фон
- Фоновые задачи автоматически завершаются, если вывод превышает 5 ГБ, с примечанием в stderr, объясняющим причину
- На macOS и Linux Claude Code останавливает ваши работающие фоновые задачи, когда операционная система сообщает о критическом давлении на оперативную память, при условии, что сессия была неактивна не менее 30 минут и не выполняется ни один ход или субагент
- Лог отладки указывает, почему задачи были остановлены или почему событие давления оставило их работающими
- Установите
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAPв1, чтобы отключить остановки из-за давления на память
- Фоновые команды в локальной сессии, с которой вы работаете из терминала, десктопного приложения или расширения VS Code, не имеют ограничения по времени. В сессии, которая выполняется без присмотра, например при запуске с
-pили в облачной сессии, Claude Code останавливает фоновую команду по достижении её ограничения по времени - Фоновая команда, запущенная переднеплановым подагентом, заканчивается, когда заканчивается выполнение этого подагента, независимо от того, завершилась ли она, не удалась или была прервана; см. Когда фоновая команда останавливается в справочнике инструментов
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS в 1. Запуск в режиме bare также отключает её.
Часто используемые фоновые команды:
- Инструменты сборки (webpack, vite, make)
- Менеджеры пакетов (npm, yarn, pnpm)
- Средства запуска тестов (jest, pytest)
- Серверы разработки
- Долгоживущие процессы (docker, terraform)
Режим оболочки с префиксом !
Запускайте команды оболочки напрямую без участия Claude, добавляя префикс ! к вашему вводу:
- Добавляет команду и её вывод в контекст разговора
- Показывает прогресс и вывод в реальном времени
- Поддерживает то же самое
Ctrl+Bфоновое выполнение для долгоживущих команд - Не требует от Claude интерпретации или одобрения команды
- Поддерживает автодополнение на основе истории: введите частичную команду и нажмите
Tabдля завершения из предыдущих команд!в текущем проекте - Поддерживает автодополнение пути к файлу в реальном времени: введите токен, содержащий косую черту, такой как
./src/или~/, чтобы увидеть раскрывающийся список совпадающих файлов и каталогов, затем нажмитеTabдля принятия. Используйте косые черты и на Windows; раскрывающийся список срабатывает на/, а не на\ - Выход с
Escape,BackspaceилиCtrl+Uна пустой подсказке - Вставка текста, начинающегося с
!в пустую подсказку, автоматически входит в режим оболочки, соответствуя поведению введённого!
! npm test и получить объяснение сбоев без второго промпта. Ответ стоит столько же, сколько отправка обычного промпта. Чтобы вместо этого добавлять вывод в контекст без ответа, установите respondToBashCommands в false в settings.json.
Ставьте сообщения в очередь, пока Claude работает
Введите сообщение и нажмитеEnter пока Claude работает. Claude Code ставит сообщение в очередь вместо прерывания хода, и отображает записи в очереди в диалоге до их отправки. Вы можете ставить в очередь ! команды оболочки и большинство команд таким же образом, за исключением команд, таких как /status, которые Claude Code выполняет сразу же при их отправке.
Отправленные и поставленные в очередь сообщения отображаются серым цветом до тех пор, пока Claude не начнет на них отвечать, поэтому вы можете видеть, какие сообщения Claude еще не начинал обрабатывать.
Если вы поставите в очередь сообщение с выделением, прикрепленным из подключенной IDE, оно сохранит выделение, которое у вас было при нажатии Enter, независимо от того, что вы выберете впоследствии.
Когда Claude Code отправляет то, что вы поставили в очередь
Когда Claude Code отправит запись из очереди, зависит от того, что вы поставили в очередь.- Сообщения: если вы поставите сообщение в очередь, пока Claude выполняет вызовы инструментов, Claude Code передаст его Claude сразу же после завершения этих вызовов в рамках одного хода. Когда ход заканчивается с оставшимися в очереди сообщениями, они отправляются без дополнительного нажатия клавиши в порядке, в котором вы их набрали
- Команды и команды оболочки: Claude Code удерживает их до конца хода, затем выполняет их по одной, сохраняя порядок, в котором вы их поставили в очередь
Ctrl+Enter. Ваши сообщения из очереди отправляются сразу же, с вашим черновиком в очереди позади них, если вы что-то набрали. Требуется Claude Code v2.1.275 или позже.
Если вы поставили в очередь команду ! оболочки перед вашими сообщениями, клавиша прерывает ход. В противном случае, что происходит с ходом, зависит от того, что Claude делает при нажатии клавиши:
- Выполнение команд оболочки, субагентов или другой работы, которая может перейти в фоновый режим: эта работа переходит в фоновый режим и продолжает выполняться, а Claude читает ваши сообщения в том же ходе
- Только написание ответа или выполнение чего-то, что не может перейти в фоновый режим: Claude Code прерывает ход и отправляет ваши сообщения дальше. До версии v2.1.281 клавиша прерывала ход в обоих случаях
Ctrl+Enter поступает как обычный Enter и ставит черновик в очередь; Ctrl+X Ctrl+S работает в любом терминале. Обе клавиши являются привязками действия chat:sendNow.
Нажмите Esc для прерывания хода без отправки вашего черновика. Claude Code сохраняет то, что вы поставили в очередь, и отправляет это сразу же.
Claude Code выполняет некоторые команды сразу же при их отправке вместо того, чтобы ставить их в очередь, в том числе /model, /effort и /fast. Каждая из трех команд изменяет настройку: модель, уровень усилий или быстрый режим. То, применяет ли Claude Code новую настройку к ходу, над которым Claude уже работает, или только с вашего следующего хода, отличается в зависимости от команды:
/model: после подтверждения предупреждения о кэше, если Claude Code его показывает, Claude Code применяет ваше изменение к следующему запросу, который он делает в этом ходе/effort: после подтверждения предупреждения о кэше, если Claude Code его показывает, Claude Code применяет ваше изменение к следующему запросу, который он делает в этом ходе/fast: Claude Code сохраняет настройку быстрого режима, которая была активна при начале хода, поэтому ваше изменение скорости применяется с вашего следующего хода. Если ваша текущая модель не поддерживает быстрый режим, его включение также переключает вашу модель, и Claude Code использует новую модель с ее следующего запроса в этом ходе
Отмените то, что вы поставили в очередь
НажмитеUp с первой строки поля ввода, чтобы отменить сообщения и команды из очереди. Claude Code удаляет их из очереди и помещает в поле ввода, по одному на строку, перед любым текстом, который вы набрали. Отредактируйте текст и нажмите Enter, чтобы поставить его в очередь снова как одну запись, или очистите поле ввода, чтобы удалить его.
Claude Code отменяет команды оболочки из очереди только когда поле ввода пусто и у вас нет ничего другого в очереди, и оно переключает поле ввода в режим оболочки при этом. В противном случае оно оставляет их в очереди, перечисленными с префиксом !, и выполняет их после завершения хода.
Если вы забираете текст из очереди, пока ← ожидает перевода сессии в фоновый режим, текст остается в поле ввода, а Claude Code отменяет переключение. Если вы забираете его в момент перемещения сессии, текст исчезает вместе с экраном переднего плана: он не был отправлен. Каждое забранное вами сообщение сохраняется как отдельная запись в истории команд. Чтобы восстановить его, снова откройте сессию и нажмите Up в пустом промпте, когда в очереди ничего нет.
Предложения подсказок
Когда вы впервые открываете сеанс, Claude Code показывает затемненный пример команды в поле ввода подсказки, чтобы помочь вам начать работу. Он выбирает это из истории git вашего проекта, поэтому пример отражает файлы, над которыми вы недавно работали. После ответа Claude Code может предложить вашу следующую подсказку на основе истории вашего разговора, например следующий шаг из многоэтапного запроса или естественное продолжение вашего рабочего процесса.- Нажмите
TabилиRight arrow, чтобы поместить предложение в поле ввода подсказки, затемEnterдля отправки - Начните вводить текст, чтобы отклонить его
Когда Claude Code пропускает предложения
В интерактивном режиме Claude Code по умолчанию отключает предложения подсказок и скрывает переключатель Prompt suggestions в/config в сеансе, который не получает флаги функций, например на стороннем поставщике или через шлюз приложений Claude, и в первом сеансе после установки или обновления, флаги которого еще не поступили.
Claude Code также пропускает отдельные предложения в нескольких ситуациях, включая:
- Кэш подсказок холодный, чтобы избежать ненужных затрат
- После первого хода разговора в некоторых сеансах
- Предыдущий ответ закончился ошибкой
- Пока вы находитесь в Plan Mode
- Ваш аккаунт близок к лимиту использования или достиг его. Чтобы сохранить предложения включенными до достижения лимита, установите
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONвtrue. До версии 2.1.238 Claude Code пропускал их рядом с лимитом даже с переменной, установленной вtrue - В команде агентов, в сеансах товарищей по команде по умолчанию. Сеанс лидера показывает предложения
Showing fewer prompt suggestions · use one to bring them back означает, что Claude Code показывает предложения реже, потому что вы оставили много предложений подряд неиспользованными. Чтобы вернуть обычную частоту, воспользуйтесь предложением или установите CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION в true.
В режиме печати Claude Code по умолчанию не генерирует предложения. Передайте --prompt-suggestions с -p "<prompt>" --output-format stream-json --verbose, чтобы Claude Code выдал сообщение prompt_suggestion после каждого хода, который генерирует его. Генератор также пропускает очень короткие разговоры и холодные кэши подсказок здесь, поэтому один короткий запрос -p может не выдать ничего.
Отключение предложений подсказок
Чтобы полностью отключить предложения подсказок, используйте любое из следующего:- Отключите Prompt suggestions в
/config - Установите
promptSuggestionEnabledвfalseв файле параметров - Установите переменную окружения
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONвfalse, которая имеет приоритет над параметром:
promptSuggestionEnabled в false в управляемых параметрах. Также установите CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION в false под управляемым ключом env, чтобы пользователи не могли повторно включить их с помощью собственной переменной окружения.
Подсказки You should know
«You should know» ищет что-то одно, что вам следует знать, но что вы могли упустить, например компромисс, который Claude выбрал, не упомянув его явно, или результат, который может быть неверным. Обнаружив такое, он показывает короткую заметку над полем ввода промпта:/plugin показывает его в списке, когда вы подключаетесь к Claude API напрямую с учётной записью claude.ai или API-ключом Console. Он не отображается, если вы подключаетесь через LLM-шлюз или шлюз приложений Claude либо получаете ключ из apiKeyHelper. Даже при прямом подключении он не отображается в следующих сессиях:
- Сессия, которая не загружает флаги функций, от которых зависит мод, например сессия с установленной переменной
DISABLE_TELEMETRY - Первая сессия после установки или обновления, флаги которой ещё не получены
/plugin не показывает мод, команда включения отвечает Plugin "cc-plugin-you-should-know@builtin" is not installed in this project.
Стоимость проверок
Пока мод включён, проверки выполняются как фоновые запросы к той же модели, которую использует ваша сессия, и учитываются в лимитах использования вашего плана или в расходах на API. Каждая проверка отправляет то, что уже находится в контексте Claude, то есть диалог на текущий момент вместе с результатами инструментов, а затем собственные инструкции мода и текст ваших недавних заметок. Часть с диалогом считывается из кэша промптов сессии на тех же условиях, что и следующий запрос самого Claude. Инструкции объёмом в несколько тысяч токенов и ответ побочного агента оплачиваются полностью при каждой проверке. Чтобы наблюдать за проверками, установитеCLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG=1 в оболочке перед запуском Claude Code.
Ответ на заметку
Введите цифру варианта отдельно в пустое поле ввода промпта. Заметка предлагает следующие варианты:- Learn more: открывает краткое пояснение под заметкой с собственными вариантами:
- Understood: закрывает его и помечает тему как известную
- Chat in main session: цитирует заметку в поле ввода промпта, чтобы вы могли добавить вопрос и отправить его Claude
- Dismiss: закрывает его, не помечая тему как известную
- Knew this already: закрывает заметку и помечает тему как известную.
- Dismiss: закрывает заметку.
cc-plugin-you-should-know, в каталоге ~/.claude/plugins/store/. Каждая проверка в этой и последующих сессиях передаёт их побочному агенту как те, которые не следует повторять. Claude Code удаляет этот файл, если в течение cleanupPeriodDays ни одна сессия не читала и не записывала его. Чтобы очистить их раньше, удалите этот файл, когда ни одна сессия не запущена.
Отключение You should know
Чтобы отключить You should know, воспользуйтесь одним из следующих способов:- В промпте Claude Code выполните
/plugin disable cc-plugin-you-should-know@builtinили отключите его на вкладке Installed в/plugin - После того как вы выберете Dismiss в заметке, не открывая сначала Learn more, выберите Turn off suggestions в строке
Dismissed., которая исчезает через 20 секунд
Emoji shortcodes
Введите: с последующим кодом emoji в поле ввода подсказки для вставки emoji. Требуется Claude Code v2.1.217 или более поздняя версия.
- Введите полный код, например
:heart:, и Claude Code заменит его на ❤️ сразу же после ввода закрывающего: - Введите
:плюс минимум два символа названия, например:hea, чтобы открыть всплывающее окно предложений, затем нажмитеTabилиEnterдля вставки выделенного emoji
: внутри слова или URL не открывает предложения.
Чтобы отключить эту функцию, установите emojiCompletionEnabled на false в settings.json. Это отключит как всплывающее окно предложений, так и встроенную замену.
Проверка орфографии во время ввода
Claude Code может подчеркивать неправильно написанные слова в поле ввода подсказки во время ввода. Он проверяет только текст в поле ввода, никогда ответы Claude или ваши файлы. Он также ничего не проверяет, пока поле ввода находится в режиме shell, поиске историиCtrl+R или голосовом диктовании.
Проверка орфографии отключена по умолчанию, и Claude Code ничего не проверяет в режиме чтения с экрана. Требуется Claude Code v2.1.235 или более поздняя версия.
Предварительные требования
- Установите aspell, hunspell или ispell и убедитесь, что он находится в вашем
PATH. Claude Code запускает первый из трех найденных им на каждой платформе, включая.cmdshim, который установщик пакетов устанавливает на Windows. - Чтобы проверить, находится ли программа в вашем
PATH, запуститеaspell --version,hunspell --versionилиispell -vв вашем терминале. Ошибка “command not found” означает, что она еще не находится в вашемPATH.
Включение или отключение проверки орфографии
Claude Code читает параметрspellcheck из трех мест и игнорирует его в файлах .claude/settings.json и .claude/settings.local.json проекта. Включите его в том месте, которое вы используете:
- User settings
- Command line
- Managed settings
Добавьте
spellcheck в ~/.claude/settings.json. Это применяется в каждом проекте, который вы открываете, как и остальные ваши пользовательские параметры:enabled на false в том же месте или удалите spellcheck.
Чтобы выбрать, какую из трех программ запускает Claude Code, какой словарь он использует или цвет подчеркивания, добавьте любое из этих полей рядом с enabled в том же месте:
checker:aspell,hunspellилиispell. Claude Code не переходит на другой checker, который вы назвали, и рассматривает любое другое значение какauto.language: имя словаря в форме вашего checker, напримерen_GB. Claude Code игнорирует любое значение, которое не является простым именем словаря, например путь или имя с пробелами, и checker использует свой словарь по умолчанию.color: имя цвета, напримерyellow, или значение#rrggbb,#rgb,rgb(r,g,b),ansi256(n)илиansi:<name>. Claude Code использует цвет ошибки вашей темы по умолчанию и для любого значения, которое он не распознает.
spellcheck запускает hunspell со словарем en_GB и подчеркивает слова желтым цветом. Это работает одинаково в ~/.claude/settings.json, в файле, который вы передаете в --settings, и в управляемых параметрах:
spellcheck, Claude Code использует только один из них: сначала управляемые параметры, затем --settings, затем пользовательские параметры. Он не объединяет поля из двух мест. Например, когда --settings устанавливает spellcheck, language в ваших пользовательских параметрах не имеет никакого эффекта.
Что Claude Code подчеркивает
Вскоре после того, как вы прекратите ввод, Claude Code подчеркивает слова, которые словарь не знает. Он оставляет слово, которое вы все еще вводите, в покое, пока вы не перейдете дальше, и никогда не изменяет ваш текст. Он также пропускает текст, который выглядит как код:- Команды, такие как
/help, упоминания@, URL-адреса, пути к файлам и флаги, такие как--verbose - Слова с цифрами, подчеркиваниями или заглавной буквой после первой, и текст в обратных кавычках
Когда Claude Code ничего не подчеркивает
Claude Code ничего не подчеркивает, когда не может запустить checker:- Checker не установлен, или тот, который вы назвали в
checker, отсутствует - Checker дважды подряд дает сбой при запуске или позже в сеансе. Claude Code перезапускает его после первого сбоя и прекращает проверку после второго, пока вы не перезагрузите Claude Code
- Checker требует более 15 секунд для ответа три раза. Каждый раз Claude Code оставляет слова, на которые он ждал, без отметок; после третьего раза он прекращает проверку, пока вы не перезагрузите Claude Code
claude --debug с включенной проверкой орфографии и введите слово. Затем найдите строки [spellcheck] в журнале отладки в ~/.claude/debug/<session-id>.txt. Одна строка называет программу, которую запустил Claude Code, или перечисляет те, которые он искал и не нашел. Более поздние строки говорят, почему он остановился. Ошибка отсутствующего словаря там означает, что checker не имеет словаря для вашего значения language, или нет словаря по умолчанию, когда language не установлен. Установите один или установите language на словарь, который у вас есть.
Невидимые символы в промптах
Вставленный текст может содержать символы Unicode, которые терминал не отображает вообще, такие как символы тегов, двунаправленные управляющие символы и пробелы нулевой ширины, поэтому промпт может содержать текст, который вы никогда не видите. Чтобы скопированный текст не содержал инструкций, которые ваш терминал не отображает, Claude Code удаляет эти символы при нажатии Enter, прежде чем что-либо отправлять. Он очищает как сам промпт, так и содержимое любой свёрнутой ссылки на вставленный текст, которую включает промпт. Claude Code сохраняет соединители, которые используют персидский и индийский шрифты, а также селекторы внутри последовательностей эмодзи. Если Claude Code что-то удалил, то нажатие Enter ничего не отправляет. Очищенный промпт возвращается в поле ввода с уведомлением, напримерRemoved 3 invisible characters · review and press Enter to send, и повторное нажатие Enter отправляет текст в том виде, в котором он показан.
Когда вы передаёте промпт в командной строке, например claude "fix the login bug", Claude Code не ждёт второго нажатия Enter. Он удаляет символы, показывает уведомление и отправляет очищенный промпт. Если очищенный промпт начинается с /, Claude Code вместо этого помещает его в поле ввода для вашего просмотра и отправки.
Просмотр изменений с помощью /diff
Запустите/diff, чтобы просмотреть изменения в вашем рабочем дереве, не покидая Claude Code. Вы видите правки, которые Claude уже внёс, наряду со всем остальным, что вы ещё не зафиксировали. Что именно открывает /diff, зависит от активного рендерера:
- Полноэкранный режим: панель diff открывается рядом с диалогом. Она остаётся открытой и обновляется, пока вы продолжаете работать.
- Классический рендерер: диалоговое окно diff открывается над промптом, и вы закрываете его, когда закончите читать.
cc-plugin-diff — одним из модов, встроенных в Claude Code. Если вы отключите этот мод в /plugin, /diff вместо них откроет прежнюю панель Claude Code и средство просмотра diff.
В изменениях, которые /diff читает из git, подмодуль отображается как одна запись, и только когда изменяется коммит, на который он указывает; правки файлов внутри подмодуля там не отображаются. Панель и диалоговое окно также предлагают представление правок каждого хода, как только Claude отредактировал файлы. Эти представления ходов создаются из правок файлов Claude, а не из git, поэтому изменение, которое Claude вносит через shell-команду, отображается только в Current — представлении рабочего дерева.
Diff panel
Панель diff отображает изменённые файлы с количеством добавленных и удалённых строк и показывает diff каждого файла под списком. Claude Code обновляет её каждый раз, когда Claude редактирует файл или запускает shell-команду. Чтобы закрыть панель, запустите/diff снова или нажмите ✕ в её заголовке.
Для использования панели вам нужно:
- Полноэкранный режим
- Репозиторий git
- Терминал шириной не менее 110 столбцов
- Claude Code версии 2.1.287 или позже
/diff, в последующих сессиях она открывается сразу же, как только Claude редактирует файл в любом терминале, достаточно широком для её размещения. Закройте панель, и она останется закрытой в этой сессии и в последующих, пока вы снова не запустите /diff.
Пока панель открыта, вы можете:
- Перейти к файлу: нажмите на его строку в списке. Прокручивайте панель колесом мыши. Когда сам список файлов слишком длинный, чтобы поместиться, прокручивайте его с помощью
Alt+UpиAlt+Down, илиCtrl+UpиCtrl+Down. - Спросить Claude об изменениях в файле: нажмите
askсправа от имени файла над его diff. Claude Code прикрепляет diff этого файла к вашему следующему промпту, и на кнопке отображаетсяasked ✓, пока вы не отправите этот промпт. Запрос по второму файлу заменяет первый. - Показать правки одного хода: нажмите на селектор
sourceв заголовке панели, затем выберите ход с помощьюUpиDownи нажмитеEnter. Ходы обозначаютсяT1,T2и так далее. Селектор появляется, как только Claude отредактировал файлы, аCurrentвозвращает вас к рабочему дереву. - Показать файлы, которые панель пропускает: список пропускает тестовые файлы и сгенерированные файлы и сворачивает изменения, сделанные до этой сессии, в одну строку внизу. Нажмите на любую строку счётчика, чтобы развернуть её.
- Изменить, с чем панель сравнивает: нажмите
Ctrl+X B, чтобы переключаться между изменениями этой сессии, вашими незафиксированными изменениями как одним списком и всем, что было с момента ответвления вашей ветки от ветки по умолчанию. Claude Code запоминает выбор для каждого репозитория.
Diff dialog
Диалоговое окно diff открывается в виде блока с рамкой над промптом и отображает изменённые файлы с количеством добавленных и удалённых строк. Оно сравнивает их сHEAD или с тем, что вы в последний раз выбрали в панели diff для этого репозитория.
Как только Claude отредактировал файлы, над списком появляется селектор source. Он предлагает по одному представлению хода, обозначенному T1, T2 и так далее, для каждого вашего промпта, после которого Claude редактировал файлы. Представление хода показывает только правки этого хода, а Current возвращает вас к рабочему дереву.
Используйте эти клавиши в диалоговом окне:
- Up и Down: выбор файла.
- Enter: открыть diff выбранного файла. Прокручивайте его с помощью Up и Down, или PageUp и PageDown.
- Esc: вернуться из diff файла в список или закрыть диалоговое окно из списка.
- Tab: перейти к селектору
source, затем выбратьCurrentили представление хода с помощью Up и Down и нажать Enter. В diff файла Tab переводит фокус на кнопкуask. Нажмите Enter, чтобы прикрепить diff этого файла к вашему следующему промпту.
Боковые вопросы с /btw
Используйте/btw для задания вопроса о вашей текущей работе без добавления в историю разговора.
x для очистки более ранних обменов, и они исчезнут при выходе из Claude Code.
В панели чата расширения VS Code /btw открывает панель вместо оверлея, описанного в этом разделе, и вы задаёте дополнительные вопросы прямо в панели. Поток панели сохраняется при перезагрузке окна согласно графику хранения, описанному на этой странице. Вам нужно расширение версии 2.1.227 или позже. Более ранние версии расширения не предлагают /btw.
- Доступно во время работы Claude: вы можете запустить
/btwдаже во время обработки Claude ответа. Боковой вопрос выполняется независимо и не прерывает основной ход. Он видит всё в разговоре до сих пор, кроме ответа, который Claude ещё пишет. - Без доступа к инструментам: боковые вопросы отвечают только на основе того, что уже находится в контексте. Claude не может читать файлы, выполнять команды или искать при ответе на боковой вопрос. Если Claude всё же выводит вызовы инструментов как текст, ответ заканчивается примечанием о том, что ничего не было выполнено.
- Один ответ: в оверлее нет дополнительных ходов. Чтобы продолжить поток, задайте ещё один вопрос
/btw. Чтобы продолжить с полным доступом к инструментам в локальном сеансе, нажмитеfдля разветвления этого вопроса и ответа в фоновый подагент. - Низкая стоимость: пока кэш подсказок разговора активен, боковой вопрос стоит немного больше, чем сам ответ.
/btw без вопроса. Оверлей снова откроется на вашем самом последнем обмене. До версии 2.1.212 /btw без вопроса выводил сообщение об использовании вместо этого.
После появления ответа оверлей принимает эти клавиши.
В присоединённом фоновом сеансе
Left отсоединяет и возвращает вас в представление агента, даже во время прибытия ответа. Боковой вопрос продолжает выполняться, пока вас нет. В следующий раз, когда вы присоедините к сеансу, оверлей снова откроется с боковым вопросом или с его ответом. До версии 2.1.257 Left там не отсоединял.
/btw видит ваш полный разговор, но не имеет инструментов. Подагент имеет инструменты и начинает с подсказки, которую он получает, или, для разветвления, с копии этого разговора. Используйте /btw для вопросов о том, что Claude уже знает из этого сеанса; используйте подагента для поиска чего-то нового.
Список задач
Список задач — это контрольный список Claude: элементы, которые Claude создал для планирования многоэтапной работы, с индикаторами, показывающими, что ожидает выполнения, находится в процессе или завершено. Это отдельно от представления фоновых задач. Чтобы увидеть запущенные оболочки и подагентов, используйте/tasks вместо этого.
Список заполняется только в сессиях, которые имеют инструменты отслеживания задач, которые Claude Code предоставляет по умолчанию на Opus 4.7, Sonnet 4.6, Haiku 4.5 и более ранних моделях. На любой другой модели, включая ID модели, который Claude Code не распознает, список остается пустым, если вы не согласитесь с CLAUDE_CODE_ENABLE_TODO_TOOLS=1 или одним из других способов в разделе Доступность инструмента Task. Когда сессия имеет инструменты, список задач работает следующим образом:
- Нажмите
Ctrl+Tдля переключения представления списка задач. Дисплей показывает до пяти задач одновременно. Когда Claude еще не создал никаких элементов контрольного списка, переключение не имеет видимого эффекта, потому что нечего отображать - Если вы оставите список развернутым, Claude Code восстановит развернутое представление при следующем запуске в сеанс, который все еще содержит задачи, например с
--resumeили--continue. Когда список задач пуст, Claude Code запускает его в свернутом состоянии - Чтобы увидеть все задачи или очистить их, попросите Claude напрямую: “show me all tasks” или “clear all tasks”
- Задачи сохраняются при сжатии контекста, помогая Claude оставаться организованным в более крупных проектах
- Чтобы поделиться списком задач между сеансами, установите
CLAUDE_CODE_TASK_LIST_IDдля использования именованного каталога в~/.claude/tasks/:CLAUDE_CODE_TASK_LIST_ID=my-project claude
Краткое резюме сеанса
Когда вы возвращаетесь в терминал после перерыва, Claude Code показывает однострочное резюме того, что произошло в сеансе до сих пор. Резюме генерируется в фоновом режиме после того, как прошло не менее трёх минут с момента последнего завершённого хода и терминал не в фокусе, поэтому оно готово, когда вы переключитесь обратно. Резюме появляются только после того, как в сеансе будет не менее трёх ходов, и никогда не появляются два раза подряд. Запустите/recap для создания резюме по требованию. Команда выполняется, только когда вы запрашиваете её сами. Если она приходит в сообщении, переданном из треда Slack, Teams или проекта, или в промпте, отправленном routine, вместо резюме вы получите уведомление.
Краткое резюме сессии включено по умолчанию для каждого плана и поставщика. Чтобы отключить автоматические резюме, откройте /config и отключите Session recap. Автоматическое резюме никогда не появляется в неинтерактивном режиме. Claude Code ограничивает как автоматические резюме, так и вывод /recap до 400 символов.
Ожидание сброса лимита использования
Когда лимит использования claude.ai останавливает Claude в середине задачи, Claude Code ждёт в открытой сессии и продолжает задачу самостоятельно после сброса лимита. Автоматическое продолжение включено по умолчанию в интерактивных сессиях, вошедших в систему с подпиской claude.ai. Требуется Claude Code v2.1.234 или позже. Пока Claude Code ждёт, строки в нижней части сессии показывают, когда сбросится ваш лимит и когда Claude продолжит:/usage-credits to continue now во второй. Когда ожидание начинается само, в диалоге это также фиксируется строкой Usage limit reached · continuing automatically at 3:45pm · esc to cancel.
Держите сессию открытой. Что произойдёт дальше, зависит от того, как закончится ожидание:
- При сбросе: вторая строка меняется на
Continuing shortly · esc to cancel. Затем в диалоге появляетсяUsage limit reset · continuing automatically, и Claude Code отправляет Claude промпт продолжить задачу там, где она остановилась. Он не переотправляет ваше последнее сообщение. - После сна вашего компьютера: если он спал более чем примерно 30 минут и лимит сбросился во время сна, первая строка читается как
Your usage limit has reset, а вторая —Press enter to continue. НажмитеEnterдля продолжения. После более короткого сна или сна, закончившегося до сброса, Claude Code продолжает самостоятельно. - Раньше: когда вы закончите добавлять кредиты использования с помощью
/usage-credits, снова войдёте в систему после/upgradeили переключите модели с помощью/modelво время ожидания, Claude Code проверяет, доступно ли использование снова, и продолжает немедленно, если оно доступно. Он не проверяет после обновления или покупки, которые вы совершаете в браузере самостоятельно. В разделеopusplanи других параметрах модели, которые запускают режим плана на другой модели, Claude Code ждёт сброса вместо этого.
Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again.
Отмена ожидания
НажмитеEsc при пустом промпте или Ctrl+C, пока отображаются строки, или запустите /rate-limit-options и выберите Don’t continue automatically. Claude Code подтверждает строкой, которая начинается с Automatic continue cancelled.
После отмены ничего не продолжается, пока вы не отправите запрос или не выберете строку, которая начинается с Wait here, then continue automatically из /rate-limit-options снова. Claude Code не запускает ожидание самостоятельно снова для этого окна сброса; следующее окно сброса начинается заново.
Ожидание также заканчивается без продолжения задачи в этих случаях:
- Вы отправляете промпт: Claude Code отправляет ваш промпт вместо ожидания. Если ваш промпт тоже упирается в лимит, он остаётся в диалоге, и Claude Code снова начинает ожидание.
- Вы выходите из Claude Code: ожидание не перезапускается при возобновлении сессии.
- Разговор переходит в другие руки: вы переключаете учётные записи с помощью
/login, очищаете или отматываете разговор,/resumeдругую сессию, вытягиваете одну с помощью/teleport, перезапускаете с помощью/tuiили передаёте сессию Claude Desktop, фоновой сессии или облаку. - Параметр отключается или сброс выходит за пределы 24 часов: это заканчивает только ожидание, которое Claude Code запустил самостоятельно. Ожидание, которое вы выбрали из
/rate-limit-options, продолжает отсчитываться. - Продолжение заблокировано:
UserPromptSubmithook, который блокирует запрос продолжения, или сбой перед его достижением модели, заканчивает ожидание. Claude Code сообщает вам, что продолжение не выполнилось. Отправьте запрос для продолжения.
Начните ожидание самостоятельно
Claude Code не запускает ожидание самостоятельно в этих случаях:- Сессии Remote Control и товарищей команды агентов: человек у этого терминала всё ещё может запустить одну.
- Сброс более чем на 24 часа в будущем: еженедельный лимит может сброситься через дни.
- Лимит Opus или Sonnet, пока вы запускаете модель вне этого семейства: ваш следующий ход может не достичь этого лимита.
opusplanи другие параметры модели, которые запускают режим плана на ограниченном семействе, не получают это исключение.
/rate-limit-options самостоятельно, чтобы открыть меню.
Claude Code вообще не предлагает ожидание в этих случаях:
- Фоновые сессии и запуски
-p: строка меню недоступна. - Ключи API, облачные поставщики и выставление счётов на основе использования: использование там измеряется за запрос, поэтому нет сброса для ожидания.
- LLM gateway без сохранённого входа claude.ai: Claude Code предлагает ожидание только при сохранённом входе claude.ai в качестве активного учётного данного.
Отключите автоматическое продолжение
В/config отключите Continue automatically at usage limit или установите autoContinueAtUsageLimit на false в ваших пользовательских параметрах. /config autoContinueAtUsageLimit=false также работает, включая с -p, но форма key=value не может включить его обратно, потому что параметр предоставляет автоматическое выполнение. Какие файлы параметров Claude Code читает для этого ключа, указано в справочнике параметров.
Статус PR
При работе над веткой с открытым pull request Claude Code отображает кликабельную ссылку PR в нижнем колонтитуле, например “PR #446”. Ссылка имеет цветное подчеркивание, указывающее на состояние рецензии:- Зелёный: одобрено
- Жёлтый: ожидание рецензии
- Красный: запрошены изменения
- Серый: черновик
Cmd+click (macOS) или Ctrl+click (Windows/Linux) на ссылку, чтобы открыть pull request в браузере.
Статус обновляется сразу же после успешного выполнения git push или команды gh pr, которая изменяет pull request, такой как gh pr create или gh pr merge, в текущей сессии.
Claude Code отображает значок как гиперссылку даже когда не может обнаружить поддержку гиперссылок в вашем терминале, что часто происходит при подключении по SSH или в tmux. Установите FORCE_HYPERLINK=0, чтобы отображать значок как обычный текст.
Когда вы установите CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, Claude Code не проверяет статус pull request или merge request.
Статус PR для репозиториев GitHub требует токена GitHub. Claude Code находит его на основе хоста удалённого репозитория:
- github.com:
GH_TOKENилиGITHUB_TOKEN, или токен, сохранённый командойgh auth login. Без него нижний колонтитул показываетinstall gh for PR status, если CLIghне установлен, илиgh auth login for PR status, если установлен - Хост GitHub Enterprise, установленный как
GH_HOST:GH_ENTERPRISE_TOKENилиGITHUB_ENTERPRISE_TOKEN, или токен, сохранённый командойgh auth login --hostname <host>. Без него нижний колонтитул показывает те же подсказки - Любой другой хост GitHub: токен, сохранённый командой
gh auth login --hostname <host>. Без него Claude Code не показывает значок и не показывает подсказку
GitLab merge requests
Когда вы работаете над веткой с открытым GitLab merge request, Claude Code показывает кликабельный значокMR !N в нижнем колонтитуле на месте, где обычно находится ссылка на GitHub PR. !N — это собственный синтаксис GitLab для ссылки на merge request номер N. Цветное подчеркивание показывает состояние merge request:
- Зелёный: GitLab сообщает, что merge request можно объединить
- Жёлтый: любое другое открытое состояние
- Серый: черновик
git push или команды glab mr, которая изменяет merge request, такой как glab mr create или glab mr merge, в текущей сессии.
Чтобы получить значок, вам нужно:
- Claude Code v2.1.234 или позже
- Удалённый репозиторий, который указывает на ваш хост GitLab, либо gitlab.com, либо самостоятельно управляемый экземпляр
glabCLI в вашемPATH, аутентифицированный с помощьюglab auth login
glab, такие как GITLAB_TOKEN, при проверке статуса, поэтому вы не получите значок только от экспортированного токена. Claude Code также ищет glab и его вход один раз за сессию, поэтому перезагрузите Claude Code после установки glab или запуска glab auth login.
Ссылки на ссылки проблем
Когда Claude упоминает проблему какowner/repo#123, вы можете щелкнуть ссылку, чтобы открыть её, при условии, что ваш терминал поддерживает гиперссылки. Если Claude Code не обнаружит поддержку гиперссылок в вашем терминале, установите FORCE_HYPERLINK на 1, чтобы включить ссылки, или на 0, чтобы оставить ссылки в виде обычного текста.
Вы получаете ссылку только для двухчастной формы owner/repo#123. Эти ссылки остаются обычным текстом:
- Простая
#123 - Вложенный путь GitLab, такой как
group/subgroup/project#123 - Любая ссылка внутри диапазона кода или блока кода
- Любая ссылка в ответе длиннее примерно 1 000 строк или 100 000 символов
См. также
- Skills - Пользовательские запросы и рабочие процессы
- Checkpointing - Перемотка редактирования Claude и восстановление предыдущих состояний
- Справочник CLI - Флаги и опции командной строки
- Параметры - Опции конфигурации
- Управление памятью - Управление файлами CLAUDE.md