Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Полноэкранная визуализация — это добровольный исследовательский предпросмотр и требует Claude Code v2.1.89 или более поздней версии. Запустите
/tui fullscreen для переключения в текущем диалоге или установите CLAUDE_CODE_NO_FLICKER=1 в версиях до v2.1.110. Поведение может измениться на основе обратной связи.vim или htop, и отображает только видимые в данный момент сообщения. Это снижает объём данных, отправляемых на ваш терминал при каждом обновлении.
Различие наиболее заметно в эмуляторах терминала, где пропускная способность визуализации является узким местом, таких как встроенный терминал VS Code, tmux и iTerm2. Если позиция прокрутки вашего терминала прыгает в начало, пока Claude работает, или экран мигает при потоковой передаче выходных данных инструмента, этот режим решает эту проблему.
Термин «полноэкранная» описывает то, как Claude Code захватывает поверхность рисования терминала, так же как это делает
vim. Это не имеет никакого отношения к максимизации окна вашего терминала и работает при любом размере окна.Включение полноэкранной визуализации
Запустите/tui fullscreen в любом диалоге Claude Code. CLI сохраняет параметр tui и перезагружается в полноэкранный режим с вашим диалогом в целости, поэтому вы можете переключаться в середине сеанса без потери контекста. Запустите /tui без аргумента для вывода информации о том, какой рендерер активен.
Вы также можете установить переменную окружения CLAUDE_CODE_NO_FLICKER перед запуском Claude Code:
tui и переменная окружения эквивалентны. Команда /tui очищает CLAUDE_CODE_NO_FLICKER из перезагруженного процесса, чтобы вступил в силу записанный параметр.
Что изменилось
Полноэкранная визуализация изменяет способ, которым CLI рисует на вашем терминале. Поле ввода остаётся зафиксированным в нижней части экрана вместо того, чтобы перемещаться при потоковой передаче выходных данных. Если поле ввода остаётся на месте, пока Claude работает, полноэкранная визуализация активна. В дереве визуализации сохраняются только видимые сообщения, поэтому память остаётся постоянной независимо от длины диалога. Поскольку диалог находится в альтернативном буфере экрана вместо истории прокрутки вашего терминала, несколько вещей работают по-другому:| До | Сейчас | Подробности |
|---|---|---|
Cmd+f или поиск tmux для поиска текста | Ctrl+o для режима стенограммы, затем / для поиска или [ для записи в историю прокрутки | Поиск и просмотр диалога |
| Встроенное выделение и копирование нажатием и перетаскиванием терминала | Встроенное выделение, копирование автоматически при отпускании мыши | Использование мыши |
Cmd-клик для открытия URL | Клик по URL | Использование мыши |
Использование мыши
Полноэкранная визуализация захватывает события мыши и обрабатывает их внутри Claude Code:- Клик в поле ввода подсказки для позиционирования курсора в любом месте вводимого вами текста.
- Клик по свёрнутому результату инструмента для его развёртывания и просмотра полного выходного сигнала. Клик снова для свёртывания. Вызов инструмента и его результат развёртываются вместе. Кликабельны только сообщения, которые имеют больше для отображения.
- Клик по URL или пути к файлу для его открытия. Пути к файлам в выходных данных инструмента, такие как те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простые
http://иhttps://URL открываются в вашем браузере. В большинстве терминалов это заменяет встроенныйCmd-клик илиCtrl-клик, который захват мыши перехватывает. Во встроенном терминале VS Code и аналогичных терминалах на основе xterm.js продолжайте использоватьCmd-клик. Claude Code уступает собственному обработчику ссылок терминала там, чтобы избежать открытия ссылок дважды. - Клик и перетаскивание для выделения текста в любом месте диалога. Двойной клик выделяет слово, соответствуя границам слов iTerm2, поэтому путь к файлу выделяется как одна единица. Тройной клик выделяет строку.
- Прокрутка колесом мыши для перемещения по диалогу.
/config. Если это отключено, нажмите Ctrl+Shift+c для ручного копирования. На терминалах, поддерживающих протокол клавиатуры kitty, таких как kitty, WezTerm, Ghostty и iTerm2, Cmd+c также работает. Если у вас активно выделение, Ctrl+c копирует вместо отмены.
С активным выделением удерживайте Shift и нажимайте клавиши со стрелками для его расширения с клавиатуры. Shift+↑ и Shift+↓ прокручивают область просмотра, когда выделение достигает верхнего или нижнего края. Shift+Home и Shift+End расширяют до начала или конца текущей строки.
Прокрутка диалога
Полноэкранная визуализация обрабатывает прокрутку внутри приложения. Используйте эти сочетания клавиш для навигации:| Сочетание клавиш | Действие |
|---|---|
PgUp / PgDn | Прокрутка вверх или вниз на половину экрана |
Ctrl+Home | Переход в начало диалога |
Ctrl+End | Переход к последнему сообщению и повторное включение автоследования |
| Колесо мыши | Прокрутка на несколько строк за раз |
PgUp, PgDn, Home или End, таких как клавиатуры MacBook, удерживайте Fn с клавишами со стрелками: Fn+↑ отправляет PgUp, Fn+↓ отправляет PgDn, Fn+← отправляет Home, и Fn+→ отправляет End. Это делает Ctrl+Fn+→ сочетанием клавиш для перехода в конец. Если это кажется неудобным, прокрутите в конец колесом мыши для возобновления следования, или переназначьте scroll:bottom на что-то более доступное.
Эти действия переназначаемы. Смотрите Scroll actions для полного списка имён действий, включая варианты с половиной страницы и полной страницей, которые не имеют привязки по умолчанию.
Автоследование
Прокрутка вверх приостанавливает автоследование, чтобы новый выходной сигнал не тянул вас обратно в конец. НажмитеCtrl+End или прокрутите в конец для возобновления следования.
Чтобы полностью отключить автоследование, чтобы представление оставалось там, где вы его оставили, откройте /config и установите Auto-scroll на off. С отключённой автопрокруткой представление никогда не прыгает в конец самостоятельно. Диалоги запроса разрешения и другие диалоги, требующие ответа, всё ещё прокручиваются в поле зрения независимо от этого параметра.
Прокрутка колесом мыши
Прокрутка колесом мыши требует, чтобы ваш терминал пересылал события мыши в Claude Code. Большинство терминалов делают это всякий раз, когда приложение это запрашивает. iTerm2 делает это параметром для каждого профиля: если колесо ничего не делает, ноPgUp и PgDn работают, откройте Settings → Profiles → Terminal и включите Enable mouse reporting. Этот же параметр также требуется для работы клика для развёртывания и выделения текста.
Если прокрутка колесом мыши кажется медленной, ваш терминал может отправлять одно событие прокрутки на физический щелчок без множителя. Некоторые терминалы, такие как Ghostty и iTerm2 с включённой более быстрой прокруткой, уже усиливают события колеса. Другие, включая встроенный терминал VS Code, отправляют ровно одно событие на щелчок. Claude Code не может определить, какой из них.
Установите CLAUDE_CODE_SCROLL_SPEED для умножения базового расстояния прокрутки:
3 соответствует значению по умолчанию в vim и аналогичных приложениях. Параметр принимает значения от 1 до 20.
Чтобы отрегулировать скорость прокрутки интерактивно, запустите /scroll-speed. Диалог показывает линейку, по которой вы можете прокручивать, пока он открыт, чтобы вы могли почувствовать изменение немедленно. Нажимайте ← и → для регулировки, r для сброса на автоматически обнаруженное значение по умолчанию, и Enter для сохранения. Команда записывает то же значение, которое устанавливает переменная окружения CLAUDE_CODE_SCROLL_SPEED, сохраняемое в ~/.claude/settings.json. Команда недоступна в терминале IDE JetBrains.
Прокрутка в терминале IDE JetBrains
В терминале IDE JetBrains Claude Code применяет собственную обработку прокрутки и игнорируетCLAUDE_CODE_SCROLL_SPEED. Терминал отправляет события прокрутки с гораздо более высокой частотой, чем другие эмуляторы, поэтому множитель, настроенный в другом месте, здесь переходит за пределы.
В версии 2025.2 терминал также имеет ошибки прокрутки колесом, которые создают ложные клавиши со стрелками и события с неправильным направлением. Claude Code обнаруживает это во время выполнения и автоматически их смягчает, поэтому прокрутка трекпада и колеса мыши работают без конфигурации. Для лучшего опыта прокрутки обновитесь до версии 2025.3 или более поздней. Claude Code показывает подсказку в первый раз, когда вы прокручиваете, если обнаруживает ошибку.
Поиск и просмотр диалога
Ctrl+o переключается между обычной подсказкой и режимом стенограммы. Для более спокойного представления, которое показывает только вашу последнюю подсказку, однострочное резюме вызовов инструментов с diffstats редактирования и финальный ответ, запустите /focus. Параметр сохраняется между сеансами. Запустите /focus снова для его отключения.
Режим стенограммы получает навигацию и поиск в стиле less:
| Клавиша | Действие |
|---|---|
/ | Открыть поиск. Введите для поиска совпадений, Enter для принятия, Esc для отмены и восстановления позиции прокрутки |
n / N | Переход к следующему или предыдущему совпадению. Работает после закрытия строки поиска |
j / k или ↑ / ↓ | Прокрутка на одну строку |
g / G или Home / End | Переход в начало или конец |
Ctrl+u / Ctrl+d | Прокрутка на половину страницы |
Ctrl+b / Ctrl+f или Space / b | Прокрутка на полную страницу |
Ctrl+o, Esc или q | Выход из режима стенограммы и возврат к подсказке |
Cmd+f вашего терминала и поиск tmux не видят диалог, потому что он находится в альтернативном буфере экрана, а не в собственной истории прокрутки. Чтобы вернуть содержимое вашему терминалу, нажмите Ctrl+o для входа в режим стенограммы сначала, затем:
[: записывает полный диалог в собственный буфер истории прокрутки вашего терминала со всеми развёрнутыми выходными данными инструмента. Диалог теперь является обычным текстом в вашем терминале, поэтомуCmd+f, режим копирования tmux и любой другой встроенный инструмент могут искать или выбирать его. Длительные сеансы могут на момент приостановиться, пока это происходит. Это длится до выхода из режима стенограммы с помощьюEscилиq, что возвращает вас к полноэкранной визуализации. СледующийCtrl+oначинается заново.v: записывает диалог во временный файл и открывает его в$VISUALили$EDITOR.
Esc или q для возврата к подсказке.
Очистка диалога
НажмитеCtrl+L дважды в течение двух секунд для запуска /clear и начала нового диалога. Первое нажатие перерисовывает экран и показывает подсказку; второе нажатие очищает диалог. На macOS двойное нажатие Cmd+K также запускает /clear.
Использование с tmux
Полноэкранная визуализация работает внутри tmux с тремя оговорками. Прокрутка колесом мыши требует режима мыши tmux. Если ваш~/.tmux.conf ещё не включает его, добавьте эту строку и перезагрузите конфигурацию:
PgUp и PgDn работает в любом случае. Claude Code выводит однократную подсказку при запуске, если обнаруживает tmux с отключённым режимом мыши.
Полноэкранная визуализация несовместима с режимом интеграции tmux в iTerm2, который является режимом, в который вы входите с помощью tmux -CC. В режиме интеграции iTerm2 отображает каждую панель tmux как встроенное разделение вместо того, чтобы позволить tmux рисовать на терминале. Альтернативный буфер экрана и отслеживание мыши не работают правильно там: колесо мыши ничего не делает, и двойной клик может повредить состояние терминала. Не включайте полноэкранную визуализацию в сеансах tmux -CC. Обычный tmux внутри iTerm2 без -CC работает нормально.
tmux не поддерживает синхронизированный вывод, поэтому вы можете видеть больше мерцания во время перерисовки, чем при запуске Claude Code непосредственно в вашем терминале. Если мерцание заметно, особенно по SSH, запустите Claude Code в отдельной вкладке терминала вне tmux.
Сохранение встроенного выделения текста
Захват мыши — наиболее частая точка трения, особенно по SSH или внутри tmux. Когда Claude Code захватывает события мыши, встроенное копирование при выделении вашего терминала перестаёт работать. Выделение, которое вы делаете с помощью нажатия и перетаскивания, существует внутри Claude Code, а не в буфере выделения вашего терминала, поэтому режим копирования tmux, подсказки Kitty и аналогичные инструменты его не видят. Claude Code пытается записать выделение в буфер обмена, но путь, который он использует, зависит от вашей установки. Внутри tmux он записывает в буфер вставки tmux. По SSH он возвращается к последовательностям escape OSC 52, которые некоторые терминалы блокируют по умолчанию. iTerm2 блокирует их до тех пор, пока вы не включите Settings → General → Selection → Applications in terminal may access clipboard. Запуск/terminal-setup в iTerm2 включает это для вас. Claude Code выводит уведомление после каждого копирования, сообщая вам, какой путь он использовал.
Для одноразового встроенного выделения удерживайте модификатор обхода вашего терминала во время нажатия и перетаскивания: Option в iTerm2 или Shift в большинстве терминалов Linux и Windows. Модификатор указывает вашему терминалу обрабатывать выделение самостоятельно вместо передачи событий мыши в Claude Code, поэтому Cmd+C и другие сочетания клавиш копирования вашего терминала работают на нём.
Если вы полагаетесь на встроенное выделение всё время, установите CLAUDE_CODE_DISABLE_MOUSE=1 для отказа от захвата мыши, сохраняя визуализацию без мерцания и плоскую память:
PgUp, PgDn, Ctrl+Home и Ctrl+End всё ещё работает, и ваш терминал обрабатывает выделение встроенным образом. Вы теряете клик для позиционирования курсора, клик для развёртывания выходных данных инструмента, клик по URL и прокрутку колесом внутри Claude Code.
Исследовательский предпросмотр
Полноэкранная визуализация — это функция исследовательского предпросмотра. Она была протестирована на распространённых эмуляторах терминала, но вы можете столкнуться с проблемами визуализации на менее распространённых терминалах или необычных конфигурациях. Если вы столкнулись с проблемой, запустите/feedback внутри Claude Code для её сообщения, или откройте проблему в репозитории claude-code на GitHub. Включите название и версию вашего эмулятора терминала.
Чтобы отключить полноэкранную визуализацию, запустите /tui default, или отмените установку CLAUDE_CODE_NO_FLICKER, если вы включили её таким образом. Чтобы принудительно использовать классический рендерер независимо от сохранённого параметра tui, установите CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1. Классический рендерер сохраняет беседу в собственной истории прокрутки вашего терминала, поэтому Cmd+f и режим копирования tmux работают как обычно.