accessibility.md +145 −0 created
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Использование Claude Code с программой чтения с экрана
6
7> Настройте Claude Code для программ чтения с экрана, таких как VoiceOver и NVDA, а также параметры для увеличения экрана, уменьшения движения и тем, удобных для дальтоников.
8
9Claude Code имеет режим программы чтения с экрана, который заменяет его визуальный интерфейс терминала простым линейным текстом. Вместо прямоугольников, анимаций прогресса и перерисовок на месте режим выводит помеченные строки, которые программа чтения с экрана, такая как VoiceOver или NVDA, читает по порядку, чтобы вы могли вести полный диалог, одобрять разрешения инструментов и просматривать выходные данные от начала до конца.
10
11Режим программы чтения с экрана является дополнительным. Если вы используете увеличитель экрана, уменьшение движения или тему, удобную для дальтоников, вместо программы чтения с экрана, см. [Параметры доступности за пределами режима программы чтения с экрана](#accessibility-settings-beyond-screen-reader-mode).
12
13<Note>
14 Режим программы чтения с экрана требует Claude Code v2.1.181 или более поздней версии. Более ранние версии отклоняют флаг `--ax-screen-reader` с ошибкой `error: unknown option '--ax-screen-reader'`.
15</Note>
16
17<h2 id="turn-on-screen-reader-mode">
18 Включение режима программы чтения с экрана
19</h2>
20
21Выберите метод, который соответствует тому, как часто вы используете программу чтения с экрана:
22
23* Для одного сеанса: запустите `claude --ax-screen-reader`.
24* Для сеансов, запущенных из одной оболочки: установите переменную окружения `CLAUDE_AX_SCREEN_READER` на `1`. В Bash или Zsh запустите `export CLAUDE_AX_SCREEN_READER=1`; в PowerShell запустите `$env:CLAUDE_AX_SCREEN_READER = "1"`. Добавьте строку в профиль оболочки, чтобы охватить каждую оболочку.
25* Для каждого сеанса на машине: добавьте `"axScreenReader": true` в ваш пользовательский [файл параметров](/ru/settings). Это охватывает любой терминал, включая интегрированный терминал VS Code.
26
27<Note>
28 Методы перечислены в порядке приоритета: флаг [`--ax-screen-reader`](/ru/cli-reference#cli-flags) переопределяет переменную окружения [`CLAUDE_AX_SCREEN_READER`](/ru/env-vars), которая переопределяет параметр [`axScreenReader`](/ru/settings#available-settings).
29</Note>
30
31Если вы используете Claude Code через SSH, установите переменную окружения или параметр на удаленной машине, где работает Claude Code.
32
33Когда режим включен, первое, что выводит Claude Code, это строка подтверждения, называющая метод, который его включил: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]` или `[Screen Reader Mode: on via settings]`; этот формат именования метода требует Claude Code v2.1.206 или более поздней версии.
34{/* max-version: 2.1.205 */}Более ранние версии выводят `[Accessible screen reader mode: on]`.
35
36<h2 id="turn-off-screen-reader-mode">
37 Отключение режима программы чтения с экрана
38</h2>
39
40Отмените любой метод, который включил режим: запустите без флага, отмените установку переменной окружения или установите `axScreenReader` на `false`. Установка `CLAUDE_AX_SCREEN_READER=0` сохраняет режим отключенным даже когда параметр имеет значение `true`.
41
42<h2 id="what-your-screen-reader-hears">
43 Что слышит ваша программа чтения с экрана
44</h2>
45
46В режиме программы чтения с экрана Claude Code выводит плоский текст:
47
48* нет символов рисования прямоугольников для интерфейса
49* нет подсказок только по цвету
50* нет перерисовок содержимого, которое не изменилось; спиннеры прогресса отображаются как статический текст
51* таблицы в ответах Claude читаются как предложения `Header: value` вместо сетки с символами прямоугольников. {/* min-version: 2.1.198 */}Требует Claude Code v2.1.198 или более поздней версии; более ранние версии рисуют таблицы как сетки даже в режиме программы чтения с экрана.
52
53Результаты накапливаются в буфере прокрутки вашего терминала, поэтому вы можете перечитать более ранние ходы с помощью команд просмотра вашей программы чтения с экрана или поиска вашего терминала.
54
55Режим программы чтения с экрана отображается как простой прокручиваемый текст, даже если вы включили [полноэкранный режим](/ru/fullscreen) с помощью [параметра `tui`](/ru/settings#available-settings); параметр не имеет эффекта, пока режим активен. Присоединенные фоновые сеансы по-прежнему отображаются в полноэкранном режиме; см. [Известные ограничения](#known-limitations).
56
57Каждое сообщение в стенограмме начинается с метки, которую объявляет ваша программа чтения с экрана, называющей, что это: ваши сообщения, ответы Claude, активность инструментов, ошибки и подсказки. Метки также доступны для поиска, поэтому вы можете переходить между разделами стенограммы, выполняя поиск в буфере прокрутки вашего терминала:
58
59| Метка | Значение |
60| :--------------------- | :------------------------------------------------------------------------------------------------------- |
61| `you:` | Ваши сообщения |
62| `claude:` | Ответы Claude |
63| `tool:` | Активность инструмента, такая как редактирование файла или запуск команды |
64| `tool error:` | Инструмент, который не удался |
65| `error:` | Ошибка в диалоге, такая как неудачный запрос API |
66| `Permission Required:` | Подсказка разрешения, ожидающая вашего ответа |
67| `Cost:` | Сводка стоимости сеанса при выходе Claude Code, если ваша учетная запись [показывает затраты](/ru/costs) |
68
69Курсор терминала следует за кареткой ввода, поэтому команда чтения текущей строки программы чтения с экрана отвечает на вопрос "где я" с подсказкой, которую вы редактируете.
70
71<h3 id="jump-between-turns">
72 Переход между ходами
73</h3>
74
75Claude Code выводит маркеры интеграции оболочки OSC 133 на границах ходов, поэтому клавиша перехода к предыдущей подсказке вашего терминала перемещается между ходами без чтения всей стенограммы:
76
77* iTerm2: Cmd+Shift+Up
78* Терминал VS Code: Ctrl+Up в Windows, Cmd+Up в macOS
79* Windows Terminal: нет клавиши по умолчанию; привяжите действие `scrollToMark` в его параметрах
80* Kitty и Ghostty: проверьте документацию терминала для его клавиши перехода к подсказке
81
82macOS Terminal не действует на маркеры, и Claude Code не выводит их в WezTerm. В этих терминалах вместо этого выполните поиск в буфере прокрутки по метке `you:`.
83
84<h2 id="answer-menus-and-prompts">
85 Ответ на меню и подсказки
86</h2>
87
88В режиме программы чтения с экрана меню, которыми вы обычно навигируете с помощью клавиш со стрелками, включая подсказки разрешения, становятся нумерованными списками. Каждый вариант объявляется как нумерованная строка, за которой следует подсказка `Enter selection`, которая называет допустимый диапазон. Введите номер нужного варианта и нажмите Enter.
89
90* Чтобы отменить отклоняемое меню: нажмите Escape. Его подсказка заканчивается на `or Escape to cancel`.
91* Если вы введете номер, которого нет в списке: Claude Code объявляет допустимый диапазон и позволяет вам попробовать снова.
92
93Подсказки да-или-нет запрашивают введенный ответ вместо меню с двумя вариантами. Ответьте `y` или `n` и нажмите Enter. `yes` и `no` также работают.
94
95<h2 id="hear-when-claude-code-needs-you">
96 Услышьте, когда Claude Code нуждается в вас
97</h2>
98
99В режиме программы чтения с экрана Claude Code звонит в звонок терминала, когда ему нужно ваше внимание, поэтому вам не нужно постоянно проверять стенограмму. Звонок звонит, когда:
100
101* Claude завершает ответ
102* появляется подсказка разрешения
103* инструмент, который работал дольше 5 секунд, завершается
104
105Звонок - это стандартный сигнал тревоги вашего терминала. Чтобы отключить его, измените параметр звонка в приложении вашего терминала. Звонок не требует режима программы чтения с экрана: вне режима установите [`preferredNotifChannel`](/ru/settings#available-settings) на `"terminal_bell"` для аналогичных оповещений, когда Claude ждет вас. См. [Получить звонок терминала или уведомление](/ru/terminal-config#get-a-terminal-bell-or-notification).
106
107<h2 id="accessibility-settings-beyond-screen-reader-mode">
108 Параметры доступности за пределами режима программы чтения с экрана
109</h2>
110
111Эти параметры решают проблемы доступности вне режима программы чтения с экрана. Все они работают вместе с ним.
112
113* Переменная окружения `CLAUDE_CODE_ACCESSIBILITY` [environment variable](/ru/env-vars) предназначена для увеличителей экрана. Установите `CLAUDE_CODE_ACCESSIBILITY=1`, чтобы сохранить видимый собственный курсор терминала, чтобы увеличители, такие как macOS Zoom, могли отслеживать положение курсора.
114* Параметр `prefersReducedMotion` [setting](/ru/settings#available-settings) уменьшает или отключает спиннеры, мерцание и другие анимации без изменения остальной части интерфейса.
115* Параметр `theme` [setting](/ru/settings#available-settings) выбирает цвета интерфейса, включая удобные для дальтоников темы `dark-daltonized` и `light-daltonized`.
116
117<h2 id="known-limitations">
118 Известные ограничения
119</h2>
120
121Некоторые поведения не адаптированы для режима программы чтения с экрана:
122
123* Режим программы чтения с экрана не включается автоматически при запуске программы чтения с экрана.
124* Изменения режима, такие как вход в [режим плана](/ru/permission-modes#analyze-before-you-edit-with-plan-mode), еще не объявляются.
125* Присоединение к [фоновому сеансу](/ru/agent-view) с помощью `claude attach` или из представления агента входит в альтернативный экран терминала, который не имеет собственного буфера прокрутки. Это [то же поведение, что и для других присоединенных сеансов](/ru/fullscreen). Чтобы выйти, нажмите Left Arrow на пустой подсказке или Ctrl+Z, если диалог имеет фокус.
126* Claude Code объявляет затраты в сводке, которую он выводит при выходе, а не за ход.
127* Режим программы чтения с экрана не изменяет [неинтерактивный режим](/ru/headless) с флагом `-p`. Неинтерактивный режим уже выводит простой текст и остается альтернативой для написания скриптов.
128
129<h2 id="report-an-issue">
130 Сообщить о проблеме
131</h2>
132
133Если что-то не работает с вашей программой чтения с экрана, увеличителем или терминалом, откройте проблему на [трекере проблем Claude Code](https://github.com/anthropics/claude-code/issues) и упомяните вашу вспомогательную технологию в заголовке. Включите вашу операционную систему, приложение терминала и имя и версию вспомогательной технологии в отчет.
134
135<h2 id="related-resources">
136 Связанные ресурсы
137</h2>
138
139Эти страницы содержат полные справочные записи и связанную настройку для того, что охватывает эта страница:
140
141* [Settings](/ru/settings#available-settings): записи `axScreenReader`, `prefersReducedMotion`, `theme` и `preferredNotifChannel`
142* [Environment variables](/ru/env-vars): записи `CLAUDE_AX_SCREEN_READER` и `CLAUDE_CODE_ACCESSIBILITY`
143* [CLI reference](/ru/cli-reference#cli-flags): флаг `--ax-screen-reader`
144* [Terminal configuration](/ru/terminal-config): звонки, уведомления и темы вне режима программы чтения с экрана
145* [Non-interactive mode](/ru/headless): написанные скриптом запуски `claude -p`, которые выводят простой текст без режима программы чтения с экрана