SpyBara
Go Premium

Documentation 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

76 files changed +2,499 −2,607. View all changes and history on the product overview
2026
Wed 5 02:01 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

accessibility.md +18 −18

Details

22 22 

23* Для одного сеанса: запустите `claude --ax-screen-reader`.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"`. Добавьте строку в профиль оболочки, чтобы охватить каждую оболочку.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.25* Для каждого сеанса на машине: добавьте `"axScreenReader": true` в ваш пользовательский [файл параметров](/docs/ru/settings). Это охватывает любой терминал, включая интегрированный терминал VS Code.

26 26 

27<Note>27<Note>

28 Методы перечислены в порядке приоритета: флаг [`--ax-screen-reader`](/ru/cli-reference#cli-flags) переопределяет переменную окружения [`CLAUDE_AX_SCREEN_READER`](/ru/env-vars), которая переопределяет параметр [`axScreenReader`](/ru/settings#available-settings).28 Методы перечислены в порядке приоритета: флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) переопределяет переменную окружения [`CLAUDE_AX_SCREEN_READER`](/docs/ru/env-vars), которая переопределяет параметр [`axScreenReader`](/docs/ru/settings#available-settings).

29</Note>29</Note>

30 30 

31Если вы используете Claude Code через SSH, установите переменную окружения или параметр на удаленной машине, где работает Claude Code.31Если вы используете Claude Code через SSH, установите переменную окружения или параметр на удаленной машине, где работает Claude Code.

32 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 или более поздней версии. Когда Claude Code перезапускается, например для завершения установки обновления, новый процесс наследует режим через переменную окружения `CLAUDE_AX_SCREEN_READER`, поэтому его строка подтверждения читается как `[Screen Reader Mode: on via env]` независимо от того, какой метод вы использовали.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 или более поздней версии. Когда Claude Code перезапускается, например для завершения установки обновления, новый процесс наследует режим через переменную окружения `CLAUDE_AX_SCREEN_READER`, поэтому его строка подтверждения читается как `[Screen Reader Mode: on via env]` независимо от того, какой метод вы использовали.

34{/* max-version: 2.1.205 */}Более ранние версии выводят `[Accessible screen reader mode: on]`.34Более ранние версии выводят `[Accessible screen reader mode: on]`.

35 35 

36<h2 id="turn-off-screen-reader-mode">36<h2 id="turn-off-screen-reader-mode">

37 Отключение режима программы чтения с экрана37 Отключение режима программы чтения с экрана


48* нет символов рисования прямоугольников для интерфейса48* нет символов рисования прямоугольников для интерфейса

49* нет подсказок только по цвету49* нет подсказок только по цвету

50* нет перерисовок содержимого, которое не изменилось; спиннеры прогресса отображаются как статический текст50* нет перерисовок содержимого, которое не изменилось; спиннеры прогресса отображаются как статический текст

51* таблицы в ответах Claude читаются как предложения `Header: value` вместо сетки с символами прямоугольников. {/* min-version: 2.1.198 */}Требует Claude Code v2.1.198 или более поздней версии; более ранние версии рисуют таблицы как сетки даже в режиме программы чтения с экрана.51* таблицы в ответах Claude читаются как предложения `Header: value` вместо сетки с символами прямоугольников. Требует Claude Code v2.1.198 или более поздней версии; более ранние версии рисуют таблицы как сетки даже в режиме программы чтения с экрана.

52 52 

53Результаты накапливаются в буфере прокрутки вашего терминала, поэтому вы можете перечитать более ранние ходы с помощью команд просмотра вашей программы чтения с экрана или поиска вашего терминала.53Результаты накапливаются в буфере прокрутки вашего терминала, поэтому вы можете перечитать более ранние ходы с помощью команд просмотра вашей программы чтения с экрана или поиска вашего терминала.

54 54 

55Режим программы чтения с экрана отображается как простой прокручиваемый текст, даже если вы включили [полноэкранный режим](/ru/fullscreen) с помощью [параметра `tui`](/ru/settings#available-settings); параметр не имеет эффекта, пока режим активен. Присоединенные фоновые сеансы по-прежнему отображаются в полноэкранном режиме; см. [Известные ограничения](#known-limitations).55Режим программы чтения с экрана отображается как простой прокручиваемый текст, даже если вы включили [полноэкранный режим](/docs/ru/fullscreen) с помощью [параметра `tui`](/docs/ru/settings#available-settings); параметр не имеет эффекта, пока режим активен. Присоединенные фоновые сеансы по-прежнему отображаются в полноэкранном режиме; см. [Известные ограничения](#known-limitations).

56 56 

57Каждое сообщение в стенограмме начинается с метки, которую объявляет ваша программа чтения с экрана, называющей, что это: ваши сообщения, ответы Claude, активность инструментов, ошибки и подсказки. Метки также доступны для поиска, поэтому вы можете переходить между разделами стенограммы, выполняя поиск в буфере прокрутки вашего терминала:57Каждое сообщение в стенограмме начинается с метки, которую объявляет ваша программа чтения с экрана, называющей, что это: ваши сообщения, ответы Claude, активность инструментов, ошибки и подсказки. Метки также доступны для поиска, поэтому вы можете переходить между разделами стенограммы, выполняя поиск в буфере прокрутки вашего терминала:

58 58 


64| `tool error:` | Инструмент, который не удался |64| `tool error:` | Инструмент, который не удался |

65| `error:` | Ошибка в диалоге, такая как неудачный запрос API |65| `error:` | Ошибка в диалоге, такая как неудачный запрос API |

66| `Permission Required:` | Подсказка разрешения, ожидающая вашего ответа |66| `Permission Required:` | Подсказка разрешения, ожидающая вашего ответа |

67| `Cost:` | Сводка стоимости сеанса при выходе Claude Code, если ваша учетная запись [показывает затраты](/ru/costs) |67| `Cost:` | Сводка стоимости сеанса при выходе Claude Code, если ваша учетная запись [показывает затраты](/docs/ru/costs) |

68 68 

69Курсор терминала следует за кареткой ввода, поэтому команда чтения текущей строки программы чтения с экрана отвечает на вопрос "где я" с подсказкой, которую вы редактируете.69Курсор терминала следует за кареткой ввода, поэтому команда чтения текущей строки программы чтения с экрана отвечает на вопрос "где я" с подсказкой, которую вы редактируете.

70 70 


102* появляется подсказка разрешения102* появляется подсказка разрешения

103* инструмент, который работал дольше 5 секунд, завершается103* инструмент, который работал дольше 5 секунд, завершается

104 104 

105Звонок - это стандартный сигнал тревоги вашего терминала. Чтобы отключить его, измените параметр звонка в приложении вашего терминала. Звонок не требует режима программы чтения с экрана: вне режима установите [`preferredNotifChannel`](/ru/settings#available-settings) на `"terminal_bell"` для аналогичных оповещений, когда Claude ждет вас. См. [Получить звонок терминала или уведомление](/ru/terminal-config#get-a-terminal-bell-or-notification).105Звонок - это стандартный сигнал тревоги вашего терминала. Чтобы отключить его, измените параметр звонка в приложении вашего терминала. Звонок не требует режима программы чтения с экрана: вне режима установите [`preferredNotifChannel`](/docs/ru/settings#available-settings) на `"terminal_bell"` для аналогичных оповещений, когда Claude ждет вас. См. [Получить звонок терминала или уведомление](/docs/ru/terminal-config#get-a-terminal-bell-or-notification).

106 106 

107<h2 id="accessibility-settings-beyond-screen-reader-mode">107<h2 id="accessibility-settings-beyond-screen-reader-mode">

108 Параметры доступности за пределами режима программы чтения с экрана108 Параметры доступности за пределами режима программы чтения с экрана


110 110 

111Эти параметры решают проблемы доступности вне режима программы чтения с экрана. Все они работают вместе с ним.111Эти параметры решают проблемы доступности вне режима программы чтения с экрана. Все они работают вместе с ним.

112 112 

113* Переменная окружения `CLAUDE_CODE_ACCESSIBILITY` [environment variable](/ru/env-vars) предназначена для увеличителей экрана. Установите `CLAUDE_CODE_ACCESSIBILITY=1`, чтобы сохранить видимый собственный курсор терминала, чтобы увеличители, такие как macOS Zoom, могли отслеживать положение курсора.113* Переменная окружения `CLAUDE_CODE_ACCESSIBILITY` [environment variable](/docs/ru/env-vars) предназначена для увеличителей экрана. Установите `CLAUDE_CODE_ACCESSIBILITY=1`, чтобы сохранить видимый собственный курсор терминала, чтобы увеличители, такие как macOS Zoom, могли отслеживать положение курсора.

114* Параметр `prefersReducedMotion` [setting](/ru/settings#available-settings) уменьшает или отключает спиннеры, мерцание и другие анимации без изменения остальной части интерфейса.114* Параметр `prefersReducedMotion` [setting](/docs/ru/settings#available-settings) уменьшает или отключает спиннеры, мерцание и другие анимации без изменения остальной части интерфейса.

115* Параметр `theme` [setting](/ru/settings#available-settings) выбирает цвета интерфейса, включая удобные для дальтоников темы `dark-daltonized` и `light-daltonized`.115* Параметр `theme` [setting](/docs/ru/settings#available-settings) выбирает цвета интерфейса, включая удобные для дальтоников темы `dark-daltonized` и `light-daltonized`.

116 116 

117<h2 id="known-limitations">117<h2 id="known-limitations">

118 Известные ограничения118 Известные ограничения


121Некоторые поведения не адаптированы для режима программы чтения с экрана:121Некоторые поведения не адаптированы для режима программы чтения с экрана:

122 122 

123* Режим программы чтения с экрана не включается автоматически при запуске программы чтения с экрана.123* Режим программы чтения с экрана не включается автоматически при запуске программы чтения с экрана.

124* Изменения режима, такие как вход в [режим плана](/ru/permission-modes#analyze-before-you-edit-with-plan-mode), еще не объявляются.124* Изменения режима, такие как вход в [режим плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode), еще не объявляются.

125* Присоединение к [фоновому сеансу](/ru/agent-view) с помощью `claude attach` или из представления агента входит в альтернативный экран терминала, который не имеет собственного буфера прокрутки. Это [то же поведение, что и для других присоединенных сеансов](/ru/fullscreen). Чтобы выйти, нажмите Left Arrow на пустой подсказке или Ctrl+Z, если диалог имеет фокус.125* Присоединение к [фоновому сеансу](/docs/ru/agent-view) с помощью `claude attach` или из представления агента входит в альтернативный экран терминала, который не имеет собственного буфера прокрутки. Это [то же поведение, что и для других присоединенных сеансов](/docs/ru/fullscreen). Чтобы выйти, нажмите Left Arrow на пустой подсказке или Ctrl+Z, если диалог имеет фокус.

126* Claude Code объявляет затраты в сводке, которую он выводит при выходе, а не за ход.126* Claude Code объявляет затраты в сводке, которую он выводит при выходе, а не за ход.

127* Режим программы чтения с экрана не изменяет [неинтерактивный режим](/ru/headless) с флагом `-p`. Неинтерактивный режим уже выводит простой текст и остается альтернативой для написания скриптов.127* Режим программы чтения с экрана не изменяет [неинтерактивный режим](/docs/ru/headless) с флагом `-p`. Неинтерактивный режим уже выводит простой текст и остается альтернативой для написания скриптов.

128 128 

129<h2 id="report-an-issue">129<h2 id="report-an-issue">

130 Сообщить о проблеме130 Сообщить о проблеме


138 138 

139Эти страницы содержат полные справочные записи и связанную настройку для того, что охватывает эта страница:139Эти страницы содержат полные справочные записи и связанную настройку для того, что охватывает эта страница:

140 140 

141* [Settings](/ru/settings#available-settings): записи `axScreenReader`, `prefersReducedMotion`, `theme` и `preferredNotifChannel`141* [Settings](/docs/ru/settings#available-settings): записи `axScreenReader`, `prefersReducedMotion`, `theme` и `preferredNotifChannel`

142* [Environment variables](/ru/env-vars): записи `CLAUDE_AX_SCREEN_READER` и `CLAUDE_CODE_ACCESSIBILITY`142* [Environment variables](/docs/ru/env-vars): записи `CLAUDE_AX_SCREEN_READER` и `CLAUDE_CODE_ACCESSIBILITY`

143* [CLI reference](/ru/cli-reference#cli-flags): флаг `--ax-screen-reader`143* [CLI reference](/docs/ru/cli-reference#cli-flags): флаг `--ax-screen-reader`

144* [Terminal configuration](/ru/terminal-config): звонки, уведомления и темы вне режима программы чтения с экрана144* [Terminal configuration](/docs/ru/terminal-config): звонки, уведомления и темы вне режима программы чтения с экрана

145* [Non-interactive mode](/ru/headless): написанные скриптом запуски `claude -p`, которые выводят простой текст без режима программы чтения с экрана145* [Non-interactive mode](/docs/ru/headless): написанные скриптом запуски `claude -p`, которые выводят простой текст без режима программы чтения с экрана

advisor.md +17 −17

Details

22 22 

23Советник подходит для длительных многошаговых задач, где большинство ходов рутинны, но качество плана определяет результат. Примеры включают крупные рефакторинги, сеансы отладки, где ошибка повторяется, и задачи, которые вы хотите независимо проверить перед тем, как Claude объявит их завершёнными.23Советник подходит для длительных многошаговых задач, где большинство ходов рутинны, но качество плана определяет результат. Примеры включают крупные рефакторинги, сеансы отладки, где ошибка повторяется, и задачи, которые вы хотите независимо проверить перед тем, как Claude объявит их завершёнными.

24 24 

25Он добавляет меньше ценности для коротких задач, где мало что нужно планировать, или для работы, где каждый ход требует самой мощной модели. Для этого [переключите основную модель](/ru/model-config#setting-your-model) или см. [как советник сравнивается с opusplan и subagents](#compare-with-related-features) для других способов получить второе мнение.25Он добавляет меньше ценности для коротких задач, где мало что нужно планировать, или для работы, где каждый ход требует самой мощной модели. Для этого [переключите основную модель](/docs/ru/model-config#setting-your-model) или см. [как советник сравнивается с opusplan и subagents](#compare-with-related-features) для других способов получить второе мнение.

26 26 

27<h2 id="enable-the-advisor">27<h2 id="enable-the-advisor">

28 Включение советника28 Включение советника


31Вы можете установить модель советника тремя способами:31Вы можете установить модель советника тремя способами:

32 32 

33* **Команда `/advisor`**: установите или измените советника во время сеанса и сохраните его как стандартный33* **Команда `/advisor`**: установите или измените советника во время сеанса и сохраните его как стандартный

34* **Параметр `advisorModel`**: настройте постоянное значение по умолчанию в вашем [файле параметров](/ru/settings)34* **Параметр `advisorModel`**: настройте постоянное значение по умолчанию в вашем [файле параметров](/docs/ru/settings)

35* **Флаг `--advisor`**: установите советника для одного сеанса при запуске35* **Флаг `--advisor`**: установите советника для одного сеанса при запуске

36 36 

37Если любой из этих способов установит модель советника, советник будет включён для сеансов, основная модель которых [его поддерживает](#choose-an-advisor-model). Чтобы перестать его использовать, см. [Отключение советника](#turn-the-advisor-off).37Если любой из этих способов установит модель советника, советник будет включён для сеансов, основная модель которых [его поддерживает](#choose-an-advisor-model). Чтобы перестать его использовать, см. [Отключение советника](#turn-the-advisor-off).

38 38 

39<Note>39<Note>

40 Чтобы использовать Fable 5 в качестве советника, вам нужна Claude Code v2.1.170 или более поздняя версия и [доступ к Fable 5](/ru/model-config#work-with-fable-5) для вашей организации.40 Чтобы использовать Fable 5 в качестве советника, вам нужна Claude Code v2.1.170 или более поздняя версия и [доступ к Fable 5](/docs/ru/model-config#work-with-fable-5) для вашей организации.

41</Note>41</Note>

42 42 

43<h3 id="use-the-/advisor-command">43<h3 id="use-the-/advisor-command">


50/advisor opus50/advisor opus

51```51```

52 52 

53Ваш выбор сохраняется в `advisorModel` в параметрах пользователя и сохраняется между сеансами. Если [`availableModels`](/ru/model-config#restrict-model-selection) вашей организации исключает сохранённую модель советника из списка разрешённых, советник не будет вызван до тех пор, пока вы не выберете разрешённую модель с помощью `/advisor`. Если ваша текущая основная модель не поддерживает советника, выбор всё равно сохраняется и активируется при переключении на [совместимую основную модель](#choose-an-advisor-model) с помощью [`/model`](/ru/model-config#setting-your-model).53Ваш выбор сохраняется в `advisorModel` в параметрах пользователя и сохраняется между сеансами. Если [`availableModels`](/docs/ru/model-config#restrict-model-selection) вашей организации исключает сохранённую модель советника из списка разрешённых, советник не будет вызван до тех пор, пока вы не выберете разрешённую модель с помощью `/advisor`. Если ваша текущая основная модель не поддерживает советника, выбор всё равно сохраняется и активируется при переключении на [совместимую основную модель](#choose-an-advisor-model) с помощью [`/model`](/docs/ru/model-config#setting-your-model).

54 54 

55<h3 id="set-advisormodel-in-settings">55<h3 id="set-advisormodel-in-settings">

56 Установка `advisorModel` в параметрах56 Установка `advisorModel` в параметрах


74claude --advisor opus74claude --advisor opus

75```75```

76 76 

77Флаг имеет приоритет над параметром `advisorModel` для этого сеанса. Он завершается с ошибкой, если основная модель сеанса не поддерживает советника, или если запрошенная модель советника исключена [`availableModels`](/ru/model-config#restrict-model-selection) вашей организации.77Флаг имеет приоритет над параметром `advisorModel` для этого сеанса. Он завершается с ошибкой, если основная модель сеанса не поддерживает советника, или если запрошенная модель советника исключена [`availableModels`](/docs/ru/model-config#restrict-model-selection) вашей организации.

78 78 

79<h2 id="choose-an-advisor-model">79<h2 id="choose-an-advisor-model">

80 Выбор модели советника80 Выбор модели советника


83Советник должен быть по крайней мере такой же способной, как основная модель. Принятые советники для каждой основной модели:83Советник должен быть по крайней мере такой же способной, как основная модель. Принятые советники для каждой основной модели:

84 84 

85| Основная модель | Принятые советники | Примечания |85| Основная модель | Принятые советники | Примечания |

86| ----------------------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |86| ------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

87| Haiku 4.5 | Fable, Opus, Sonnet | Haiku может вызывать советника, но не может быть им |87| Haiku 4.5 | Fable, Opus, Sonnet | Haiku может вызывать советника, но не может быть им |

88| Sonnet 4.6 | Fable, Opus, Sonnet | |88| Sonnet 4.6 | Fable, Opus, Sonnet | |

89| Sonnet 5 | Fable, Opus, Sonnet 5 | Советник Sonnet 4.6 отклоняется |89| Sonnet 5 | Fable, Opus, Sonnet 5 | Советник Sonnet 4.6 отклоняется |

90| Opus 4.6 | Fable, Opus, Sonnet 5 | Sonnet 5 и Opus 4.6 ранжируются как одинаково способные, поэтому основная модель Opus 4.6 принимает советника Sonnet 5 |90| Opus 4.6 | Fable, Opus, Sonnet 5 | Sonnet 5 и Opus 4.6 ранжируются как одинаково способные, поэтому основная модель Opus 4.6 принимает советника Sonnet 5 |

91| Opus 4.7 или позже | Fable, Opus 4.7, Opus 4.8 | Opus 4.7 и Opus 4.8 ранжируются как одинаково способные, поэтому каждый принимает другого в качестве советника. Основная модель Opus 4.7 с советником Opus 4.6 или Sonnet 5 отклоняется |91| Opus 4.7 или позже | Fable, Opus 4.7, Opus 4.8 | Opus 4.7 и Opus 4.8 ранжируются как одинаково способные, поэтому каждый принимает другого в качестве советника. Основная модель Opus 4.7 с советником Opus 4.6 или Sonnet 5 отклоняется |

92| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Советник Opus или Sonnet отклоняется |92| Fable 5 (v2.1.170+) | Fable | Советник Opus или Sonnet отклоняется |

93 93 

94Fable 5 требует Claude Code v2.1.170 или более поздней версии и доступ к Fable 5, независимо от того, действует ли она в качестве основной модели или советника.94Fable 5 требует Claude Code v2.1.170 или более поздней версии и доступ к Fable 5, независимо от того, действует ли она в качестве основной модели или советника.

95 95 


141 141 

142Каждый вызов советника отправляет диалог модели советника, поэтому он потребляет токены по ставкам модели советника в дополнение к использованию вашей основной модели. При выставлении счёта по API токены советника взимаются по входным и выходным ставкам модели советника. На планах подписки использование советника учитывается в пределах использования вашего плана.142Каждый вызов советника отправляет диалог модели советника, поэтому он потребляет токены по ставкам модели советника в дополнение к использованию вашей основной модели. При выставлении счёта по API токены советника взимаются по входным и выходным ставкам модели советника. На планах подписки использование советника учитывается в пределах использования вашего плана.

143 143 

144Claude вызывает советника в точках принятия решений, а не на каждом ходу, поэтому объединение более быстрой основной модели с более мощным советником обычно стоит меньше, чем запуск более мощной модели на протяжении всего процесса. Использование советника учитывается в итогах сеанса, показанных [`/usage`](/ru/costs#track-your-costs).144Claude вызывает советника в точках принятия решений, а не на каждом ходу, поэтому объединение более быстрой основной модели с более мощным советником обычно стоит меньше, чем запуск более мощной модели на протяжении всего процесса. Использование советника учитывается в итогах сеанса, показанных [`/usage`](/docs/ru/costs#track-your-costs).

145 145 

146Для информации о том, как токены советника сообщаются в ответах API, см. [Usage and billing](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing) в документации Claude API.146Для информации о том, как токены советника сообщаются в ответах API, см. [Usage and billing](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing) в документации Claude API.

147 147 


149 Влияние на кэширование приглашений149 Влияние на кэширование приглашений

150</h2>150</h2>

151 151 

152Включение или отключение советника во время сеанса не делает недействительным [кэш приглашений](/ru/prompt-caching) вашей основной модели. В отличие от [изменения модели или уровня усилий](/ru/prompt-caching#actions-that-invalidate-the-cache), переключение `/advisor` сохраняет кэшированный префикс нетронутым, и возвращённые рекомендации советника кэшируются как часть стенограммы при последующих ходах.152Включение или отключение советника во время сеанса не делает недействительным [кэш приглашений](/docs/ru/prompt-caching) вашей основной модели. В отличие от [изменения модели или уровня усилий](/docs/ru/prompt-caching#actions-that-invalidate-the-cache), переключение `/advisor` сохраняет кэшированный префикс нетронутым, и возвращённые рекомендации советника кэшируются как часть стенограммы при последующих ходах.

153 153 

154Собственное чтение советником диалога не кэшируется. Каждый вызов советника обрабатывает полную стенограмму заново, без повторного использования между вызовами.154Собственное чтение советником диалога не кэшируется. Каждый вызов советника обрабатывает полную стенограмму заново, без повторного использования между вызовами.

155 155 


159 159 

160Инструмент advisor требует всё следующее:160Инструмент advisor требует всё следующее:

161 161 

162* **Только API Anthropic**: советник является инструментом, выполняемым на сервере. Он недоступен на Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry. Через [LLM gateway](/ru/llm-gateway), настроенный с `ANTHROPIC_BASE_URL`, доступность зависит от того, пересылает ли шлюз запрос в целости на API Anthropic.162* **Только API Anthropic**: советник является инструментом, выполняемым на сервере. Он недоступен на Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry. Через [LLM gateway](/docs/ru/llm-gateway), настроенный с `ANTHROPIC_BASE_URL`, доступность зависит от того, пересылает ли шлюз запрос в целости на API Anthropic.

163* **Поддерживаемая основная модель**: Opus 4.6 или позже, Sonnet 4.6 или позже, или Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 также подходит на Claude Code v2.1.170 или позже.163* **Поддерживаемая основная модель**: Opus 4.6 или позже, Sonnet 4.6 или позже, или Haiku 4.5. Fable 5 также подходит на Claude Code v2.1.170 или позже.

164 164 

165<h2 id="turn-the-advisor-off">165<h2 id="turn-the-advisor-off">

166 Отключение советника166 Отключение советника


172/advisor off172/advisor off

173```173```

174 174 

175Чтобы полностью отключить инструмент advisor, установите `CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`. Команда `/advisor` становится недоступной и любой настроенный `advisorModel` игнорируется. Флаг `--advisor` принимается, но не имеет эффекта; существующие скрипты, которые его передают, продолжают работать без ошибок. См. [Environment variables](/ru/env-vars).175Чтобы полностью отключить инструмент advisor, установите `CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`. Команда `/advisor` становится недоступной и любой настроенный `advisorModel` игнорируется. Флаг `--advisor` принимается, но не имеет эффекта; существующие скрипты, которые его передают, продолжают работать без ошибок. См. [Environment variables](/docs/ru/env-vars).

176 176 

177<h2 id="compare-with-related-features">177<h2 id="compare-with-related-features">

178 Сравнение со связанными функциями178 Сравнение со связанными функциями


183| Подход | Когда работает более мощная модель | Как это начинается |183| Подход | Когда работает более мощная модель | Как это начинается |

184| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |184| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |

185| Инструмент advisor | В точках принятия решений во время задачи | Claude вызывает его, когда ему нужна рекомендация |185| Инструмент advisor | В точках принятия решений во время задачи | Claude вызывает его, когда ему нужна рекомендация |

186| [`opusplan`](/ru/model-config#opusplan-model-setting) | Во время режима плана, когда [разрешено `availableModels`](/ru/model-config#restrict-model-selection), затем переключается на Sonnet для выполнения | Вы входите в режим плана |186| [`opusplan`](/docs/ru/model-config#opusplan-model-setting) | Во время режима плана, когда [разрешено `availableModels`](/docs/ru/model-config#restrict-model-selection), затем переключается на Sonnet для выполнения | Вы входите в режим плана |

187| [Subagents](/ru/sub-agents#choose-a-model) с установленным `model` | Для всей делегированной подзадачи | Claude делегирует или вы вызываете subagent |187| [Subagents](/docs/ru/sub-agents#choose-a-model) с установленным `model` | Для всей делегированной подзадачи | Claude делегирует или вы вызываете subagent |

188| [`/model`](/ru/model-config#setting-your-model) | Для всех последующих ходов | Вы переключаете модели |188| [`/model`](/docs/ru/model-config#setting-your-model) | Для всех последующих ходов | Вы переключаете модели |

189 189 

190<h2 id="see-also">190<h2 id="see-also">

191 См. также191 См. также

192</h2>192</h2>

193 193 

194* [Model configuration](/ru/model-config): переключение моделей, установка уровней усилий и использование `opusplan`194* [Model configuration](/docs/ru/model-config): переключение моделей, установка уровней усилий и использование `opusplan`

195* [Manage costs effectively](/ru/costs): отслеживание использования токенов между моделями195* [Manage costs effectively](/docs/ru/costs): отслеживание использования токенов между моделями

196* [Advisor tool in the Claude API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool): понимание базового инструмента сервера или его прямое использование из Messages API196* [Advisor tool in the Claude API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool): понимание базового инструмента сервера или его прямое использование из Messages API

197* [The advisor strategy](https://claude.com/blog/the-advisor-strategy): почему объединение быстрой основной модели с более мощным советником работает197* [The advisor strategy](https://claude.com/blog/the-advisor-strategy): почему объединение быстрой основной модели с более мощным советником работает

agent-sdk/hooks.md +21 −21

Details

26 </Step>26 </Step>

27 27 

28 <Step title="SDK собирает зарегистрированные hooks">28 <Step title="SDK собирает зарегистрированные hooks">

29 SDK проверяет наличие hooks, зарегистрированных для этого типа события. Это включает callback hooks, которые вы передаете в `options.hooks`, и hooks команд shell из файлов настроек, когда соответствующая запись [`settingSources`](/ru/agent-sdk/typescript#settingsource) или [`setting_sources`](/ru/agent-sdk/python#settingsource) включена, что она есть для параметров `query()` по умолчанию.29 SDK проверяет наличие hooks, зарегистрированных для этого типа события. Это включает callback hooks, которые вы передаете в `options.hooks`, и hooks команд shell из файлов настроек, когда соответствующая запись [`settingSources`](/docs/ru/agent-sdk/typescript#settingsource) или [`setting_sources`](/docs/ru/agent-sdk/python#settingsource) включена, что она есть для параметров `query()` по умолчанию.

30 </Step>30 </Step>

31 31 

32 <Step title="Matchers фильтруют, какие hooks запускаются">32 <Step title="Matchers фильтруют, какие hooks запускаются">


155| `PostToolUseFailure` | Да | Да | Ошибка выполнения инструмента | Обработать или логировать ошибки инструмента |155| `PostToolUseFailure` | Да | Да | Ошибка выполнения инструмента | Обработать или логировать ошибки инструмента |

156| `PostToolBatch` | Нет | Да | Полный пакет вызовов инструментов разрешается, один раз за пакет перед следующим вызовом модели | Внедрить соглашения один раз для всего пакета |156| `PostToolBatch` | Нет | Да | Полный пакет вызовов инструментов разрешается, один раз за пакет перед следующим вызовом модели | Внедрить соглашения один раз для всего пакета |

157| `UserPromptSubmit` | Да | Да | Отправка пользовательского приглашения | Внедрить дополнительный контекст в приглашения |157| `UserPromptSubmit` | Да | Да | Отправка пользовательского приглашения | Внедрить дополнительный контекст в приглашения |

158| [`UserPromptExpansion`](/ru/hooks#userpromptexpansion) | Нет | Да | Команда, введённая пользователем, расширяется в приглашение перед тем, как она достигнет Claude | Заблокировать команду от прямого вызова или добавить контекст при вводе skill |158| [`UserPromptExpansion`](/docs/ru/hooks#userpromptexpansion) | Нет | Да | Команда, введённая пользователем, расширяется в приглашение перед тем, как она достигнет Claude | Заблокировать команду от прямого вызова или добавить контекст при вводе skill |

159| `MessageDisplay` | Нет | Да | Сообщение ассистента с текстом завершается, один раз за сообщение с полным текстом сообщения | Скрыть или переформатировать отображаемый текст без изменения стенограммы |159| `MessageDisplay` | Нет | Да | Сообщение ассистента с текстом завершается, один раз за сообщение с полным текстом сообщения | Скрыть или переформатировать отображаемый текст без изменения стенограммы |

160| `Stop` | Да | Да | Остановка выполнения агента | Сохранить состояние сеанса перед выходом |160| `Stop` | Да | Да | Остановка выполнения агента | Сохранить состояние сеанса перед выходом |

161| `SubagentStart` | Да | Да | Инициализация подагента | Отслеживать порождение параллельных задач |161| `SubagentStart` | Да | Да | Инициализация подагента | Отслеживать порождение параллельных задач |


213 Matchers213 Matchers

214</h3>214</h3>

215 215 

216Используйте matchers для фильтрации, когда срабатывают ваши callbacks. Поле `matcher` соответствует другому значению в зависимости от типа события hook. Например, hooks на основе инструментов соответствуют имени инструмента, в то время как hooks `Notification` соответствуют типу уведомления. См. [справочник hooks Claude Code](/ru/hooks#matcher-patterns) для полного списка значений matcher для каждого типа события.216Используйте matchers для фильтрации, когда срабатывают ваши callbacks. Поле `matcher` соответствует другому значению в зависимости от типа события hook. Например, hooks на основе инструментов соответствуют имени инструмента, в то время как hooks `Notification` соответствуют типу уведомления. См. [справочник hooks Claude Code](/docs/ru/hooks#matcher-patterns) для полного списка значений matcher для каждого типа события.

217 217 

218SDK matchers следуют тем же правилам, что и [matchers в файлах настроек](/ru/hooks#matcher-patterns). Matcher, содержащий только буквы, цифры, `_`, `-`, пробелы, `,` и `|`, сравнивается как точная строка, где альтернативы разделены `|` или `,` с необязательными окружающими пробелами, поэтому `Write|Edit` и `Write, Edit` каждый соответствует ровно этим двум инструментам, а `code-reviewer` соответствует только этому типу агента. Matcher `*`, пустая строка или отсутствие matcher вообще соответствует каждому возникновению события.218SDK matchers следуют тем же правилам, что и [matchers в файлах настроек](/docs/ru/hooks#matcher-patterns). Matcher, содержащий только буквы, цифры, `_`, `-`, пробелы, `,` и `|`, сравнивается как точная строка, где альтернативы разделены `|` или `,` с необязательными окружающими пробелами, поэтому `Write|Edit` и `Write, Edit` каждый соответствует ровно этим двум инструментам, а `code-reviewer` соответствует только этому типу агента. Matcher `*`, пустая строка или отсутствие matcher вообще соответствует каждому возникновению события.

219 219 

220Matcher, содержащий любой другой символ, вычисляется как якорь-независимое регулярное выражение, поэтому `^mcp__` соответствует каждому MCP инструменту и `Edit.*` соответствует как `Edit`, так и `NotebookEdit`. Оберните регулярное выражение в `^` и `$`, когда вам нужно совпадение всей строки.220Matcher, содержащий любой другой символ, вычисляется как якорь-независимое регулярное выражение, поэтому `^mcp__` соответствует каждому MCP инструменту и `Edit.*` соответствует как `Edit`, так и `NotebookEdit`. Оберните регулярное выражение в `^` и `$`, когда вам нужно совпадение всей строки.

221 221 


225 225 

226| Опция | Тип | По умолчанию | Описание |226| Опция | Тип | По умолчанию | Описание |

227| --------- | ---------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |227| --------- | ---------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

228| `matcher` | `string` | `undefined` | Паттерн, сопоставляемый с полем фильтра события, следуя правилам сравнения выше. Для hooks инструментов это имя инструмента. Встроенные инструменты включают `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` и другие (см. [Tool Input Types](/ru/agent-sdk/typescript#tool-input-types) для полного списка). MCP инструменты используют паттерн `mcp__<server>__<action>`. |228| `matcher` | `string` | `undefined` | Паттерн, сопоставляемый с полем фильтра события, следуя правилам сравнения выше. Для hooks инструментов это имя инструмента. Встроенные инструменты включают `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` и другие (см. [Tool Input Types](/docs/ru/agent-sdk/typescript#tool-input-types) для полного списка). MCP инструменты используют паттерн `mcp__<server>__<action>`. |

229| `hooks` | `HookCallback[]` | - | Обязательно. Массив функций обратного вызова для выполнения, когда паттерн совпадает |229| `hooks` | `HookCallback[]` | - | Обязательно. Массив функций обратного вызова для выполнения, когда паттерн совпадает |

230| `timeout` | `number` | `60` | Timeout в секундах |230| `timeout` | `number` | `60` | Timeout в секундах |

231 231 


234Для tool-based hooks, matchers фильтруют только по имени инструмента, а не по путям файлов или другим аргументам. Для фильтрации по пути файла проверьте `tool_input.file_path` внутри вашего callback.234Для tool-based hooks, matchers фильтруют только по имени инструмента, а не по путям файлов или другим аргументам. Для фильтрации по пути файла проверьте `tool_input.file_path` внутри вашего callback.

235 235 

236<Tip>236<Tip>

237 **Обнаружение имен инструментов:** См. [Tool Input Types](/ru/agent-sdk/typescript#tool-input-types) для полного списка встроенных имен инструментов, или добавьте hook без matcher для логирования всех вызовов инструментов, которые делает ваш сеанс.237 **Обнаружение имен инструментов:** См. [Tool Input Types](/docs/ru/agent-sdk/typescript#tool-input-types) для полного списка встроенных имен инструментов, или добавьте hook без matcher для логирования всех вызовов инструментов, которые делает ваш сеанс.

238 238 

239 **Именование MCP инструментов:** MCP инструменты всегда начинаются с `mcp__`, за которым следует имя сервера и действие: `mcp__<server>__<action>`. Например, если вы настроите сервер с именем `playwright`, его инструменты будут названы `mcp__playwright__browser_screenshot`, `mcp__playwright__browser_click` и так далее. Имя сервера берется из ключа, который вы используете в конфигурации `mcpServers`.239 **Именование MCP инструментов:** MCP инструменты всегда начинаются с `mcp__`, за которым следует имя сервера и действие: `mcp__<server>__<action>`. Например, если вы настроите сервер с именем `playwright`, его инструменты будут названы `mcp__playwright__browser_screenshot`, `mcp__playwright__browser_click` и так далее. Имя сервера берется из ключа, который вы используете в конфигурации `mcpServers`.

240</Tip>240</Tip>


249 249 

250Каждый callback hook получает три аргумента:250Каждый callback hook получает три аргумента:

251 251 

252* **Входные данные:** типизированный объект, содержащий детали события. Каждый тип hook имеет свою форму входных данных. Например, `PreToolUseHookInput` включает `tool_name` и `tool_input`, в то время как `NotificationHookInput` включает `message`. См. полные определения типов в справочниках [TypeScript](/ru/agent-sdk/typescript#hookinput) и [Python](/ru/agent-sdk/python#hookinput) SDK.252* **Входные данные:** типизированный объект, содержащий детали события. Каждый тип hook имеет свою форму входных данных. Например, `PreToolUseHookInput` включает `tool_name` и `tool_input`, в то время как `NotificationHookInput` включает `message`. См. полные определения типов в справочниках [TypeScript](/docs/ru/agent-sdk/typescript#hookinput) и [Python](/docs/ru/agent-sdk/python#hookinput) SDK.

253 * Все входные данные hook содержат `session_id`, `cwd` и `hook_event_name`.253 * Все входные данные hook содержат `session_id`, `cwd` и `hook_event_name`.

254 * `agent_id` и `agent_type` заполняются, когда hook срабатывает внутри подагента. В TypeScript они находятся на базовом входе hook и доступны для всех типов hook. В Python они являются необязательными полями на `PreToolUse`, `PostToolUse`, `PostToolUseFailure` и `PermissionRequest`, и обязательными полями на `SubagentStart` и `SubagentStop`.254 * `agent_id` и `agent_type` заполняются, когда hook срабатывает внутри подагента. В TypeScript они находятся на базовом входе hook и доступны для всех типов hook. В Python они являются необязательными полями на `PreToolUse`, `PostToolUse`, `PostToolUseFailure` и `PermissionRequest`, и обязательными полями на `SubagentStart` и `SubagentStop`.

255* **ID использования инструмента** (`str | None` / `string | undefined`): коррелирует события `PreToolUse` и `PostToolUse` для одного и того же вызова инструмента.255* **ID использования инструмента** (`str | None` / `string | undefined`): коррелирует события `PreToolUse` и `PostToolUse` для одного и того же вызова инструмента.


262Ваш callback возвращает объект с двумя категориями полей:262Ваш callback возвращает объект с двумя категориями полей:

263 263 

264* **Поля верхнего уровня** работают одинаково для каждого события: `systemMessage` показывает сообщение пользователю, и `continue` (`continue_` в Python) определяет, продолжает ли агент работать после этого hook.264* **Поля верхнего уровня** работают одинаково для каждого события: `systemMessage` показывает сообщение пользователю, и `continue` (`continue_` в Python) определяет, продолжает ли агент работать после этого hook.

265* **`hookSpecificOutput`** контролирует текущую операцию. Поля внутри зависят от типа события hook. Для hooks `PreToolUse` здесь вы устанавливаете `permissionDecision` (`"allow"`, `"deny"`, `"ask"` или `"defer"`), `permissionDecisionReason` и `updatedInput`. Возврат `"defer"` завершает запрос, чтобы вы могли [возобновить его позже](/ru/hooks#defer-a-tool-call-for-later). Для hooks `PostToolUse` вы можете установить `additionalContext` для добавления информации к результату инструмента. Чтобы заменить выходные данные инструмента перед тем, как Claude их увидит, установите `updatedToolOutput`, который работает для любого инструмента в обоих SDK. Более старое поле `updatedMCPToolOutput` заменяет только выходные данные MCP инструмента и является устаревшим.265* **`hookSpecificOutput`** контролирует текущую операцию. Поля внутри зависят от типа события hook. Для hooks `PreToolUse` здесь вы устанавливаете `permissionDecision` (`"allow"`, `"deny"`, `"ask"` или `"defer"`), `permissionDecisionReason` и `updatedInput`. Возврат `"defer"` завершает запрос, чтобы вы могли [возобновить его позже](/docs/ru/hooks#defer-a-tool-call-for-later). Для hooks `PostToolUse` вы можете установить `additionalContext` для добавления информации к результату инструмента. Чтобы заменить выходные данные инструмента перед тем, как Claude их увидит, установите `updatedToolOutput`, который работает для любого инструмента в обоих SDK. Более старое поле `updatedMCPToolOutput` заменяет только выходные данные MCP инструмента и является устаревшим.

266 266 

267Возвращайте `{}` для разрешения операции без изменений. SDK callback hooks используют тот же формат вывода JSON, что и [hooks команд shell Claude Code](/ru/hooks#json-output), который документирует каждое поле и опцию, специфичную для события. Для определений типов SDK см. справочники [TypeScript](/ru/agent-sdk/typescript#synchookjsonoutput) и [Python](/ru/agent-sdk/python#synchookjsonoutput) SDK.267Возвращайте `{}` для разрешения операции без изменений. SDK callback hooks используют тот же формат вывода JSON, что и [hooks команд shell Claude Code](/docs/ru/hooks#json-output), который документирует каждое поле и опцию, специфичную для события. Для определений типов SDK см. справочники [TypeScript](/docs/ru/agent-sdk/typescript#synchookjsonoutput) и [Python](/docs/ru/agent-sdk/python#synchookjsonoutput) SDK.

268 268 

269<Note>269<Note>

270 Когда применяются несколько hooks или правил разрешений, `deny` имеет приоритет над `defer`, который имеет приоритет над `ask`, который имеет приоритет над `allow`. Если какой-либо hook возвращает `deny`, операция блокируется независимо от других hooks.270 Когда применяются несколько hooks или правил разрешений, `deny` имеет приоритет над `defer`, который имеет приоритет над `ask`, который имеет приоритет над `allow`. Если какой-либо hook возвращает `deny`, операция блокируется независимо от других hooks.


539 Отслеживание активности подагента539 Отслеживание активности подагента

540</h3>540</h3>

541 541 

542Используйте hooks `SubagentStop` для мониторинга, когда подагенты завершают свою работу. См. полный тип входных данных в справочниках [TypeScript](/ru/agent-sdk/typescript#hookinput) и [Python](/ru/agent-sdk/python#hookinput) SDK. Этот пример логирует сводку каждый раз, когда подагент завершается:542Используйте hooks `SubagentStop` для мониторинга, когда подагенты завершают свою работу. См. полный тип входных данных в справочниках [TypeScript](/docs/ru/agent-sdk/typescript#hookinput) и [Python](/docs/ru/agent-sdk/python#hookinput) SDK. Этот пример логирует сводку каждый раз, когда подагент завершается:

543 543 

544<CodeGroup>544<CodeGroup>

545 ```python Python theme={null}545 ```python Python theme={null}


791* Проверьте, что имя события hook правильное и чувствительно к регистру (`PreToolUse`, а не `preToolUse`)791* Проверьте, что имя события hook правильное и чувствительно к регистру (`PreToolUse`, а не `preToolUse`)

792* Проверьте, что ваш паттерн matcher точно совпадает с именем инструмента792* Проверьте, что ваш паттерн matcher точно совпадает с именем инструмента

793* Убедитесь, что hook находится под правильным типом события в `options.hooks`793* Убедитесь, что hook находится под правильным типом события в `options.hooks`

794* Для non-tool hooks, которые поддерживают matchers, таких как `Notification` и `SubagentStop`, matchers соответствуют разным полям, и `Stop` полностью игнорирует matchers (см. [matcher patterns](/ru/hooks#matcher-patterns))794* Для non-tool hooks, которые поддерживают matchers, таких как `Notification` и `SubagentStop`, matchers соответствуют разным полям, и `Stop` полностью игнорирует matchers (см. [matcher patterns](/docs/ru/hooks#matcher-patterns))

795* Hooks могут не срабатывать, когда агент достигает лимита [`max_turns`](/ru/agent-sdk/python#claudeagentoptions), потому что сеанс заканчивается перед тем, как hooks смогут выполниться795* Hooks могут не срабатывать, когда агент достигает лимита [`max_turns`](/docs/ru/agent-sdk/python#claudeagentoptions), потому что сеанс заканчивается перед тем, как hooks смогут выполниться

796 796 

797<h3 id="matcher-not-filtering-as-expected">797<h3 id="matcher-not-filtering-as-expected">

798 Matcher не фильтрует как ожидается798 Matcher не фильтрует как ожидается


818* Увеличьте значение `timeout` в конфигурации `HookMatcher`818* Увеличьте значение `timeout` в конфигурации `HookMatcher`

819* Используйте `AbortSignal` из третьего аргумента callback для корректной обработки отмены в TypeScript819* Используйте `AbortSignal` из третьего аргумента callback для корректной обработки отмены в TypeScript

820 820 

821{/* min-version: 2.1.208 */}Callback `UserPromptSubmit` или [`UserPromptExpansion`](/ru/hooks#userpromptexpansion), который превышает свой timeout, блокирует этот запрос с сообщением timeout, и сеанс продолжается. Прерывание запроса во время ожидания callback отменяет ожидающий вызов инструмента. До версии 2.1.208 timeout callback на этих событиях завершал запрос с `error_during_execution`, и прерывание во время ожидания callback `PreToolUse` могло позволить вызову инструмента продолжиться.821Callback `UserPromptSubmit` или [`UserPromptExpansion`](/docs/ru/hooks#userpromptexpansion), который превышает свой timeout, блокирует этот запрос с сообщением timeout, и сеанс продолжается. Прерывание запроса во время ожидания callback отменяет ожидающий вызов инструмента. До версии 2.1.208 timeout callback на этих событиях завершал запрос с `error_during_execution`, и прерывание во время ожидания callback `PreToolUse` могло позволить вызову инструмента продолжиться.

822 822 

823<h3 id="tool-blocked-unexpectedly">823<h3 id="tool-blocked-unexpectedly">

824 Инструмент заблокирован неожиданно824 Инструмент заблокирован неожиданно


852 Hooks сеанса недоступны в Python852 Hooks сеанса недоступны в Python

853</h3>853</h3>

854 854 

855`SessionStart` и `SessionEnd` могут быть зарегистрированы как SDK callback hooks в TypeScript, но недоступны в Python SDK, потому что его тип `HookEvent` их опускает. В Python они доступны только как [shell command hooks](/ru/hooks#hook-events), определенные в файлах настроек, таких как `.claude/settings.json`. Для загрузки shell command hooks из вашего приложения SDK включите соответствующий источник настроек с [`setting_sources`](/ru/agent-sdk/python#settingsource) или [`settingSources`](/ru/agent-sdk/typescript#settingsource):855`SessionStart` и `SessionEnd` могут быть зарегистрированы как SDK callback hooks в TypeScript, но недоступны в Python SDK, потому что его тип `HookEvent` их опускает. В Python они доступны только как [shell command hooks](/docs/ru/hooks#hook-events), определенные в файлах настроек, таких как `.claude/settings.json`. Для загрузки shell command hooks из вашего приложения SDK включите соответствующий источник настроек с [`setting_sources`](/docs/ru/agent-sdk/python#settingsource) или [`settingSources`](/docs/ru/agent-sdk/typescript#settingsource):

856 856 

857<CodeGroup>857<CodeGroup>

858 ```python Python theme={null}858 ```python Python theme={null}


890 systemMessage не появляется в выводе890 systemMessage не появляется в выводе

891</h3>891</h3>

892 892 

893Поле `systemMessage` показывает сообщение пользователю, а не модели. По умолчанию SDK выводит выходные данные hook в поток сообщений только для hooks `SessionStart` и `Setup`, поэтому сообщение из любого другого события hook не появляется, если вы не установите `includeHookEvents` (`include_hook_events` в Python). Для передачи контекста модели вместо этого верните [`additionalContext`](/ru/hooks#add-context-for-claude).893Поле `systemMessage` показывает сообщение пользователю, а не модели. По умолчанию SDK выводит выходные данные hook в поток сообщений только для hooks `SessionStart` и `Setup`, поэтому сообщение из любого другого события hook не появляется, если вы не установите `includeHookEvents` (`include_hook_events` в Python). Для передачи контекста модели вместо этого верните [`additionalContext`](/docs/ru/hooks#add-context-for-claude).

894 894 

895Если вам нужно надежно вывести решения hook в ваше приложение, логируйте их отдельно или используйте выделенный канал вывода.895Если вам нужно надежно вывести решения hook в ваше приложение, логируйте их отдельно или используйте выделенный канал вывода.

896 896 


898 Связанные ресурсы898 Связанные ресурсы

899</h2>899</h2>

900 900 

901* [Справочник hooks Claude Code](/ru/hooks): полные схемы входных/выходных данных JSON, документация событий и паттерны matcher901* [Справочник hooks Claude Code](/docs/ru/hooks): полные схемы входных/выходных данных JSON, документация событий и паттерны matcher

902* [Руководство hooks Claude Code](/ru/hooks-guide): примеры hooks команд shell и пошаговые инструкции902* [Руководство hooks Claude Code](/docs/ru/hooks-guide): примеры hooks команд shell и пошаговые инструкции

903* [Справочник TypeScript SDK](/ru/agent-sdk/typescript): типы hooks, определения входных/выходных данных и параметры конфигурации903* [Справочник TypeScript SDK](/docs/ru/agent-sdk/typescript): типы hooks, определения входных/выходных данных и параметры конфигурации

904* [Справочник Python SDK](/ru/agent-sdk/python): типы hooks, определения входных/выходных данных и параметры конфигурации904* [Справочник Python SDK](/docs/ru/agent-sdk/python): типы hooks, определения входных/выходных данных и параметры конфигурации

905* [Разрешения](/ru/agent-sdk/permissions): контролируйте, что может делать ваш агент905* [Разрешения](/docs/ru/agent-sdk/permissions): контролируйте, что может делать ваш агент

906* [Пользовательские инструменты](/ru/agent-sdk/custom-tools): создавайте инструменты для расширения возможностей агента906* [Пользовательские инструменты](/docs/ru/agent-sdk/custom-tools): создавайте инструменты для расширения возможностей агента

Details

6 6 

7> Контролируйте использование инструментов вашим агентом с помощью режимов разрешений, hooks и декларативных правил allow/deny.7> Контролируйте использование инструментов вашим агентом с помощью режимов разрешений, hooks и декларативных правил allow/deny.

8 8 

9Claude Agent SDK предоставляет элементы управления разрешениями для управления использованием инструментов Claude. Используйте режимы разрешений и правила для определения того, что разрешено автоматически, и callback [`canUseTool`](/ru/agent-sdk/user-input) для обработки всего остального во время выполнения.9Claude Agent SDK предоставляет элементы управления разрешениями для управления использованием инструментов Claude. Используйте режимы разрешений и правила для определения того, что разрешено автоматически, и callback [`canUseTool`](/docs/ru/agent-sdk/user-input) для обработки всего остального во время выполнения.

10 10 

11<Note>11<Note>

12 На этой странице рассматриваются режимы разрешений и правила. Чтобы создать интерактивные потоки утверждения, где пользователи одобряют или отклоняют запросы инструментов во время выполнения, см. [Обработка утверждений и ввода пользователя](/ru/agent-sdk/user-input).12 На этой странице рассматриваются режимы разрешений и правила. Чтобы создать интерактивные потоки утверждения, где пользователи одобряют или отклоняют запросы инструментов во время выполнения, см. [Обработка утверждений и ввода пользователя](/docs/ru/agent-sdk/user-input).

13</Note>13</Note>

14 14 

15<h2 id="how-permissions-are-evaluated">15<h2 id="how-permissions-are-evaluated">


20 20 

21<Steps>21<Steps>

22 <Step title="Hooks">22 <Step title="Hooks">

23 Сначала запустите [hooks](/ru/agent-sdk/hooks). Hook может отклонить вызов полностью или передать его дальше. Hook, который возвращает `allow`, не пропускает правила deny и ask ниже; они оцениваются независимо от результата hook.23 Сначала запустите [hooks](/docs/ru/agent-sdk/hooks). Hook может отклонить вызов полностью или передать его дальше. Hook, который возвращает `allow`, не пропускает правила deny и ask ниже; они оцениваются независимо от результата hook.

24 </Step>24 </Step>

25 25 

26 <Step title="Правила deny">26 <Step title="Правила deny">

27 Проверьте правила `deny` (из `disallowed_tools` и [settings.json](/ru/settings#permission-settings)). Если правило deny совпадает, инструмент блокируется, даже в режиме `bypassPermissions`. Записи с простым названием, такие как `Bash`, удаляют инструмент из контекста Claude перед началом этой оценки, поэтому на этом шаге проверяются только правила с областью действия, такие как `Bash(rm *)`.27 Проверьте правила `deny` (из `disallowed_tools` и [settings.json](/docs/ru/settings#permission-settings)). Если правило deny совпадает, инструмент блокируется, даже в режиме `bypassPermissions`. Записи с простым названием, такие как `Bash`, удаляют инструмент из контекста Claude перед началом этой оценки, поэтому на этом шаге проверяются только правила с областью действия, такие как `Bash(rm *)`.

28 </Step>28 </Step>

29 29 

30 <Step title="Правила ask">30 <Step title="Правила ask">

31 Проверьте правила `ask` из [settings.json](/ru/settings#permission-settings). Если правило ask совпадает, вызов передаётся вашему callback [`canUseTool`](/ru/agent-sdk/user-input) для подтверждения, даже в режиме `bypassPermissions`.31 Проверьте правила `ask` из [settings.json](/docs/ru/settings#permission-settings). Если правило ask совпадает, вызов передаётся вашему callback [`canUseTool`](/docs/ru/agent-sdk/user-input) для подтверждения, даже в режиме `bypassPermissions`.

32 32 

33 Инструменты, которые требуют взаимодействия с пользователем, ведут себя так же: `AskUserQuestion` и MCP инструменты, сервер которых устанавливает [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), всегда передаются callback, даже когда совпадает правило allow. В режиме `dontAsk` оба случая отклоняются вместо этого, потому что этот режим никогда не запрашивает подтверждение. {/* min-version: 2.1.199 */}Аннотация MCP требует Claude Code v2.1.199 или более поздней версии.33 Инструменты, которые требуют взаимодействия с пользователем, ведут себя так же: `AskUserQuestion` и MCP инструменты, сервер которых устанавливает [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), всегда передаются callback, даже когда совпадает правило allow. В режиме `dontAsk` оба случая отклоняются вместо этого, потому что этот режим никогда не запрашивает подтверждение. Аннотация MCP требует Claude Code v2.1.199 или более поздней версии.

34 34 

35 Инструменты [claude.ai connector](/ru/mcp#organization-controls-on-connector-tools), которые ваша организация установила на `ask`, также покидают поток на этом шаге. Каждый вызов передаётся callback, даже в режиме `bypassPermissions` и даже когда совпадает правило allow. Callback получает причину `Your organization requires approval for this tool`. В режиме `dontAsk` вызов отклоняется вместо этого, потому что этот режим никогда не запрашивает подтверждение.35 Инструменты [claude.ai connector](/docs/ru/mcp#organization-controls-on-connector-tools), которые ваша организация установила на `ask`, также покидают поток на этом шаге. Каждый вызов передаётся callback, даже в режиме `bypassPermissions` и даже когда совпадает правило allow. Callback получает причину `Your organization requires approval for this tool`. В режиме `dontAsk` вызов отклоняется вместо этого, потому что этот режим никогда не запрашивает подтверждение.

36 </Step>36 </Step>

37 37 

38 <Step title="Режим разрешений">38 <Step title="Режим разрешений">


44 </Step>44 </Step>

45 45 

46 <Step title="Callback canUseTool">46 <Step title="Callback canUseTool">

47 Если не разрешено ни одним из вышеперечисленных, вызовите ваш callback [`canUseTool`](/ru/agent-sdk/user-input) для принятия решения. В режиме `dontAsk` этот шаг пропускается и инструмент отклоняется.47 Если не разрешено ни одним из вышеперечисленных, вызовите ваш callback [`canUseTool`](/docs/ru/agent-sdk/user-input) для принятия решения. В режиме `dontAsk` этот шаг пропускается и инструмент отклоняется.

48 </Step>48 </Step>

49</Steps>49</Steps>

50 50 


57 57 

58Записи со спецификатором, такие как `Bash(ls *)`, и режим `acceptEdits` не вызывают его, и правила allow из файлов настроек не видны для проверки.58Записи со спецификатором, такие как `Bash(ls *)`, и режим `acceptEdits` не вызывают его, и правила allow из файлов настроек не видны для проверки.

59 59 

60Слушайте с помощью `process.on('warning', ...)` и сопоставьте код для логирования или подавления его. Чтобы контролировать каждый вызов инструмента независимо от режима и правил, используйте вместо этого [hook `PreToolUse`](/ru/agent-sdk/hooks).60Слушайте с помощью `process.on('warning', ...)` и сопоставьте код для логирования или подавления его. Чтобы контролировать каждый вызов инструмента независимо от режима и правил, используйте вместо этого [hook `PreToolUse`](/docs/ru/agent-sdk/hooks).

61 61 

62На этой странице основное внимание уделяется **правилам allow и deny** и **режимам разрешений**. Для других шагов:62На этой странице основное внимание уделяется **правилам allow и deny** и **режимам разрешений**. Для других шагов:

63 63 

64* **Hooks:** запустите пользовательский код для разрешения, отклонения или изменения запросов инструментов. См. [Управление выполнением с помощью hooks](/ru/agent-sdk/hooks).64* **Hooks:** запустите пользовательский код для разрешения, отклонения или изменения запросов инструментов. См. [Управление выполнением с помощью hooks](/docs/ru/agent-sdk/hooks).

65* **Callback canUseTool:** запросите у пользователей утверждение во время выполнения, когда ни один из предыдущих шагов не разрешит вызов. См. [Обработка утверждений и ввода пользователя](/ru/agent-sdk/user-input).65* **Callback canUseTool:** запросите у пользователей утверждение во время выполнения, когда ни один из предыдущих шагов не разрешит вызов. См. [Обработка утверждений и ввода пользователя](/docs/ru/agent-sdk/user-input).

66 66 

67<h2 id="allow-and-deny-rules">67<h2 id="allow-and-deny-rules">

68 Правила allow и deny68 Правила allow и deny


81 81 

82Правила с областью действия для `Read` и `Edit` принимают шаблон пути. Правила `Edit(path)` управляют всеми встроенными инструментами, которые записывают файлы, включая `Write` и `NotebookEdit`; правило `Write(path)` никогда не совпадает с проверками разрешений файлов.82Правила с областью действия для `Read` и `Edit` принимают шаблон пути. Правила `Edit(path)` управляют всеми встроенными инструментами, которые записывают файлы, включая `Write` и `NotebookEdit`; правило `Write(path)` никогда не совпадает с проверками разрешений файлов.

83 83 

84Используйте `//path` для абсолютного пути файловой системы: правило deny `Edit(//secrets/**)` блокирует записи в любом месте под `/secrets` на диске. С одной ведущей косой чертой `Edit(/secrets/**)` якорируется в источнике правила. Для правил, переданных через `allowed_tools` или `disallowed_tools`, это означает рабочий каталог сеанса, поэтому правило не блокирует `/secrets` на диске. См. [Правила Read и Edit](/ru/permissions#read-and-edit) для четырёх форм якорей и того, как правила из файлов параметров разрешаются.84Используйте `//path` для абсолютного пути файловой системы: правило deny `Edit(//secrets/**)` блокирует записи в любом месте под `/secrets` на диске. С одной ведущей косой чертой `Edit(/secrets/**)` якорируется в источнике правила. Для правил, переданных через `allowed_tools` или `disallowed_tools`, это означает рабочий каталог сеанса, поэтому правило не блокирует `/secrets` на диске. См. [Правила Read и Edit](/docs/ru/permissions#read-and-edit) для четырёх форм якорей и того, как правила из файлов параметров разрешаются.

85 85 

86<Warning>86<Warning>

87 **Автоматически одобренные инструменты никогда не достигают `canUseTool`.** Вызов инструмента, одобренный на любом более раннем этапе, с помощью `acceptEdits` или `bypassPermissions`, или по правилу allow, пропускает ваш обратный вызов `canUseTool`, поэтому проверки разрешений, которые вы там поместили, молча обходятся для этого инструмента. `AskUserQuestion`, инструменты MCP, отмеченные [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), и инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) всё ещё достигают обратного вызова, даже когда совпадает правило allow.87 **Автоматически одобренные инструменты никогда не достигают `canUseTool`.** Вызов инструмента, одобренный на любом более раннем этапе, с помощью `acceptEdits` или `bypassPermissions`, или по правилу allow, пропускает ваш обратный вызов `canUseTool`, поэтому проверки разрешений, которые вы там поместили, молча обходятся для этого инструмента. `AskUserQuestion`, инструменты MCP, отмеченные [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), и инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) всё ещё достигают обратного вызова, даже когда совпадает правило allow.

88 88 

89 Охват зависит от формы записи: простое имя, такое как `Read` или `mcp__github__get_issue`, автоматически одобряет каждый вызов этого инструмента, в то время как правило с областью действия, такое как `Bash(ls *)`, автоматически одобряет только совпадающие вызовы, и другие вызовы `Bash` всё ещё переходят к обратному вызову. Для проверок, которые должны выполняться при каждом вызове инструмента, используйте [`PreToolUse` hook](/ru/agent-sdk/hooks): hooks выполняются перед каждым другим шагом, и отказ hook применяется даже в режиме `bypassPermissions`.89 Охват зависит от формы записи: простое имя, такое как `Read` или `mcp__github__get_issue`, автоматически одобряет каждый вызов этого инструмента, в то время как правило с областью действия, такое как `Bash(ls *)`, автоматически одобряет только совпадающие вызовы, и другие вызовы `Bash` всё ещё переходят к обратному вызову. Для проверок, которые должны выполняться при каждом вызове инструмента, используйте [`PreToolUse` hook](/docs/ru/agent-sdk/hooks): hooks выполняются перед каждым другим шагом, и отказ hook применяется даже в режиме `bypassPermissions`.

90</Warning>90</Warning>

91 91 

92Для заблокированного агента объедините `allowedTools` с `permissionMode: "dontAsk"`. Указанные инструменты одобрены, кроме всегда запрашиваемых инструментов в предупреждении выше; всё остальное отклоняется полностью вместо запроса:92Для заблокированного агента объедините `allowedTools` с `permissionMode: "dontAsk"`. Указанные инструменты одобрены, кроме всегда запрашиваемых инструментов в предупреждении выше; всё остальное отклоняется полностью вместо запроса:


102 **`allowed_tools` не ограничивает `bypassPermissions`.** `allowed_tools` только предварительно одобряет указанные вами инструменты. Неуказанные инструменты не совпадают ни с одним правилом allow и переходят к режиму разрешений, где `bypassPermissions` их одобряет. Установка `allowed_tools=["Read"]` вместе с `permission_mode="bypassPermissions"` всё ещё одобряет каждый инструмент, включая `Bash`, `Write` и `Edit`. Если вам нужен `bypassPermissions`, но вы хотите заблокировать определённые инструменты, используйте `disallowed_tools`.102 **`allowed_tools` не ограничивает `bypassPermissions`.** `allowed_tools` только предварительно одобряет указанные вами инструменты. Неуказанные инструменты не совпадают ни с одним правилом allow и переходят к режиму разрешений, где `bypassPermissions` их одобряет. Установка `allowed_tools=["Read"]` вместе с `permission_mode="bypassPermissions"` всё ещё одобряет каждый инструмент, включая `Bash`, `Write` и `Edit`. Если вам нужен `bypassPermissions`, но вы хотите заблокировать определённые инструменты, используйте `disallowed_tools`.

103</Warning>103</Warning>

104 104 

105Вы также можете настроить правила allow, deny и ask декларативно в `.claude/settings.json`. Эти правила читаются, когда включен источник параметра `project`, что происходит для параметров `query()` по умолчанию. Если вы явно установите `setting_sources` (TypeScript: `settingSources`), включите `"project"`, чтобы они применялись. См. [Параметры разрешений](/ru/settings#permission-settings) для синтаксиса правил.105Вы также можете настроить правила allow, deny и ask декларативно в `.claude/settings.json`. Эти правила читаются, когда включен источник параметра `project`, что происходит для параметров `query()` по умолчанию. Если вы явно установите `setting_sources` (TypeScript: `settingSources`), включите `"project"`, чтобы они применялись. См. [Параметры разрешений](/docs/ru/settings#permission-settings) для синтаксиса правил.

106 106 

107<h2 id="permission-modes">107<h2 id="permission-modes">

108 Режимы разрешений108 Режимы разрешений


119| Режим | Описание | Поведение инструмента |119| Режим | Описание | Поведение инструмента |

120| :------------------ | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |120| :------------------ | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

121| `default` | Стандартное поведение разрешений | Без автоматических одобрений; несовпадающие инструменты запускают ваш callback `canUseTool` |121| `default` | Стандартное поведение разрешений | Без автоматических одобрений; несовпадающие инструменты запускают ваш callback `canUseTool` |

122| `dontAsk` | Отклонение вместо запроса | Всё, что не предварительно одобрено `allowed_tools` или правилами, отклоняется; инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, отклоняются даже если вы их предварительно одобрили. `canUseTool` никогда не вызывается |122| `dontAsk` | Отклонение вместо запроса | Всё, что не предварительно одобрено `allowed_tools` или правилами, отклоняется; инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, отклоняются даже если вы их предварительно одобрили. `canUseTool` никогда не вызывается |

123| `acceptEdits` | Автоматическое принятие редактирования файлов | Редактирование файлов и [операции с файловой системой](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv` и т. д.) автоматически одобрены |123| `acceptEdits` | Автоматическое принятие редактирования файлов | Редактирование файлов и [операции с файловой системой](#accept-edits-mode-acceptedits) (`mkdir`, `rm`, `mv` и т. д.) автоматически одобрены |

124| `bypassPermissions` | Обход всех проверок разрешений | Инструменты работают без запросов разрешений, кроме инструментов, совпадающих с явным правилом [`ask`](#how-permissions-are-evaluated), инструментов соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструментов, требующих взаимодействия с пользователем (используйте с осторожностью) |124| `bypassPermissions` | Обход всех проверок разрешений | Инструменты работают без запросов разрешений, кроме инструментов, совпадающих с явным правилом [`ask`](#how-permissions-are-evaluated), инструментов соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструментов, требующих взаимодействия с пользователем (используйте с осторожностью) |

125| `plan` | Режим планирования | Claude исследует и планирует без редактирования исходных файлов; редактирование файлов никогда не одобряется автоматически и запрашивается через ваш callback `canUseTool` |125| `plan` | Режим планирования | Claude исследует и планирует без редактирования исходных файлов; редактирование файлов никогда не одобряется автоматически и запрашивается через ваш callback `canUseTool` |

126| `auto` | Одобрения, классифицированные моделью | Классификатор модели одобряет или отклоняет каждый вызов инструмента. См. [Режим Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) для доступности |126| `auto` | Одобрения, классифицированные моделью | Классификатор модели одобряет или отклоняет каждый вызов инструмента. См. [Режим Auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) для доступности |

127 127 

128<Warning>128<Warning>

129 **Наследование подагентом:** Когда родитель использует `bypassPermissions`, `acceptEdits` или `auto`, все подагенты наследуют этот режим и он не может быть переопределён для каждого подагента. Подагенты могут иметь различные системные подсказки и менее ограниченное поведение, чем ваш основной агент, поэтому наследование `bypassPermissions` предоставляет им полный автономный доступ к системе. Явные правила [`ask`](#how-permissions-are-evaluated), инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, по-прежнему вынуждают запрос.129 **Наследование подагентом:** Когда родитель использует `bypassPermissions`, `acceptEdits` или `auto`, все подагенты наследуют этот режим и он не может быть переопределён для каждого подагента. Подагенты могут иметь различные системные подсказки и менее ограниченное поведение, чем ваш основной агент, поэтому наследование `bypassPermissions` предоставляет им полный автономный доступ к системе. Явные правила [`ask`](#how-permissions-are-evaluated), инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, по-прежнему вынуждают запрос.

130</Warning>130</Warning>

131 131 

132<h3 id="set-permission-mode">132<h3 id="set-permission-mode">


260 Режим без запроса (`dontAsk`)260 Режим без запроса (`dontAsk`)

261</h4>261</h4>

262 262 

263Преобразует любой запрос разрешения в отклонение. Инструменты, предварительно одобренные `allowed_tools`, правилами allow в `settings.json` или hook, работают нормально. Инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, отклоняются даже если правило allow совпадает. Всё остальное отклоняется без вызова `canUseTool`.263Преобразует любой запрос разрешения в отклонение. Инструменты, предварительно одобренные `allowed_tools`, правилами allow в `settings.json` или hook, работают нормально. Инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, отклоняются даже если правило allow совпадает. Всё остальное отклоняется без вызова `canUseTool`.

264 264 

265**Используйте, когда:** вы хотите фиксированную, явную поверхность инструментов для автономного агента и предпочитаете жёсткое отклонение молчаливому полаганию на отсутствие `canUseTool`.265**Используйте, когда:** вы хотите фиксированную, явную поверхность инструментов для автономного агента и предпочитаете жёсткое отклонение молчаливому полаганию на отсутствие `canUseTool`.

266 266 


273<Warning>273<Warning>

274 Используйте с крайней осторожностью. Claude имеет полный доступ к системе в этом режиме. Используйте только в контролируемых средах, где вы доверяете всем возможным операциям.274 Используйте с крайней осторожностью. Claude имеет полный доступ к системе в этом режиме. Используйте только в контролируемых средах, где вы доверяете всем возможным операциям.

275 275 

276 `allowed_tools` не ограничивает этот режим. Каждый инструмент одобрен, а не только те, которые вы указали. Правила deny (`disallowed_tools`), явные правила `ask` и hooks оцениваются перед проверкой режима и всё ещё могут заблокировать инструмент. Инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, по-прежнему переходят к вашему callback `canUseTool`.276 `allowed_tools` не ограничивает этот режим. Каждый инструмент одобрен, а не только те, которые вы указали. Правила deny (`disallowed_tools`), явные правила `ask` и hooks оцениваются перед проверкой режима и всё ещё могут заблокировать инструмент. Инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструменты, требующие взаимодействия с пользователем, по-прежнему переходят к вашему callback `canUseTool`.

277</Warning>277</Warning>

278 278 

279<h4 id="plan-mode-plan">279<h4 id="plan-mode-plan">

280 Режим планирования (`plan`)280 Режим планирования (`plan`)

281</h4>281</h4>

282 282 

283Claude исследует кодовую базу и создаёт план без редактирования исходных файлов. Инструменты только для чтения работают как в режиме по умолчанию. Редактирование файлов никогда не одобряется автоматически в режиме планирования, даже если правило allow совпадает. Вместо этого они запрашиваются через ваш callback `canUseTool`. Claude может использовать `AskUserQuestion` для уточнения требований перед завершением плана. См. [Обработка утверждений и ввода пользователя](/ru/agent-sdk/user-input#handle-clarifying-questions) для обработки этих запросов.283Claude исследует кодовую базу и создаёт план без редактирования исходных файлов. Инструменты только для чтения работают как в режиме по умолчанию. Редактирование файлов никогда не одобряется автоматически в режиме планирования, даже если правило allow совпадает. Вместо этого они запрашиваются через ваш callback `canUseTool`. Claude может использовать `AskUserQuestion` для уточнения требований перед завершением плана. См. [Обработка утверждений и ввода пользователя](/docs/ru/agent-sdk/user-input#handle-clarifying-questions) для обработки этих запросов.

284 284 

285**Используйте, когда:** вы хотите, чтобы Claude предложил изменения без их выполнения, например при проверке кода или когда вам нужно одобрить изменения перед их внесением.285**Используйте, когда:** вы хотите, чтобы Claude предложил изменения без их выполнения, например при проверке кода или когда вам нужно одобрить изменения перед их внесением.

286 286 


290 290 

291Для других шагов в потоке оценки разрешений:291Для других шагов в потоке оценки разрешений:

292 292 

293* [Обработка утверждений и ввода пользователя](/ru/agent-sdk/user-input): интерактивные запросы утверждения и уточняющие вопросы293* [Обработка утверждений и ввода пользователя](/docs/ru/agent-sdk/user-input): интерактивные запросы утверждения и уточняющие вопросы

294* [Руководство по hooks](/ru/agent-sdk/hooks): запуск пользовательского кода в ключевых точках жизненного цикла агента294* [Руководство по hooks](/docs/ru/agent-sdk/hooks): запуск пользовательского кода в ключевых точках жизненного цикла агента

295* [Правила разрешений](/ru/settings#permission-settings): декларативные правила allow/deny в `settings.json`295* [Правила разрешений](/docs/ru/settings#permission-settings): декларативные правила allow/deny в `settings.json`

Details

18pip install claude-agent-sdk18pip install claude-agent-sdk

19```19```

20 20 

21Для uv, Windows PowerShell и настройки API ключа см. [Начало работы в обзоре Agent SDK](/ru/agent-sdk/overview#get-started).21Для uv, Windows PowerShell и настройки API ключа см. [Начало работы в обзоре Agent SDK](/docs/ru/agent-sdk/overview#get-started).

22 22 

23<h2 id="choosing-between-query-and-claudesdkclient">23<h2 id="choosing-between-query-and-claudesdkclient">

24 Выбор между `query()` и `ClaudeSDKClient`24 Выбор между `query()` и `ClaudeSDKClient`


73 `query()`73 `query()`

74</h3>74</h3>

75 75 

76Создает новый сеанс для каждого взаимодействия с Claude Code по умолчанию. Возвращает асинхронный итератор, который выдает сообщения по мере их поступления. Каждый вызов `query()` начинается с нуля без памяти о предыдущих взаимодействиях, если вы не передадите `continue_conversation=True` или `resume` в [`ClaudeAgentOptions`](#claudeagentoptions). См. [Sessions](/ru/agent-sdk/sessions).76Создает новый сеанс для каждого взаимодействия с Claude Code по умолчанию. Возвращает асинхронный итератор, который выдает сообщения по мере их поступления. Каждый вызов `query()` начинается с нуля без памяти о предыдущих взаимодействиях, если вы не передадите `continue_conversation=True` или `resume` в [`ClaudeAgentOptions`](#claudeagentoptions). См. [Sessions](/docs/ru/agent-sdk/sessions).

77 77 

78```python theme={null}78```python theme={null}

79async def query(79async def query(


565| `interrupt()` | Отправьте сигнал прерывания (работает только в режиме потоковой передачи) |565| `interrupt()` | Отправьте сигнал прерывания (работает только в режиме потоковой передачи) |

566| `set_permission_mode(mode)` | Измените режим разрешений для текущего сеанса |566| `set_permission_mode(mode)` | Измените режим разрешений для текущего сеанса |

567| `set_model(model)` | Измените модель для текущего сеанса. Передайте `None` для сброса на значение по умолчанию |567| `set_model(model)` | Измените модель для текущего сеанса. Передайте `None` для сброса на значение по умолчанию |

568| `rewind_files(user_message_id)` | Восстановите файлы в их состояние в указанном пользовательском сообщении. Требует `enable_file_checkpointing=True`. См. [File checkpointing](/ru/agent-sdk/file-checkpointing) |568| `rewind_files(user_message_id)` | Восстановите файлы в их состояние в указанном пользовательском сообщении. Требует `enable_file_checkpointing=True`. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |

569| `get_mcp_status()` | Получите статус всех настроенных MCP servers. Возвращает [`McpStatusResponse`](#mcpstatusresponse) |569| `get_mcp_status()` | Получите статус всех настроенных MCP servers. Возвращает [`McpStatusResponse`](#mcpstatusresponse) |

570| `reconnect_mcp_server(server_name)` | Повторите попытку подключения к MCP server, который не удался или был отключен |570| `reconnect_mcp_server(server_name)` | Повторите попытку подключения к MCP server, который не удался или был отключен |

571| `toggle_mcp_server(server_name, enabled)` | Включите или отключите MCP server в середине сеанса. Отключение удаляет его инструменты |571| `toggle_mcp_server(server_name, enabled)` | Включите или отключите MCP server в середине сеанса. Отключение удаляет его инструменты |


907| Свойство | Тип | По умолчанию | Описание |907| Свойство | Тип | По умолчанию | Описание |

908| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |908| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

909| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Конфигурация инструментов. Используйте `{"type": "preset", "preset": "claude_code"}` для инструментов Claude Code по умолчанию |909| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Конфигурация инструментов. Используйте `{"type": "preset", "preset": "claude_code"}` для инструментов Claude Code по умолчанию |

910| `allowed_tools` | `list[str]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неуказанные инструменты переходят к `permission_mode` и `can_use_tool`. Используйте `disallowed_tools` для блокировки инструментов. См. [Permissions](/ru/agent-sdk/permissions#allow-and-deny-rules) |910| `allowed_tools` | `list[str]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неуказанные инструменты переходят к `permission_mode` и `can_use_tool`. Используйте `disallowed_tools` для блокировки инструментов. См. [Permissions](/docs/ru/agent-sdk/permissions#allow-and-deny-rules) |

911| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | Конфигурация системной подсказки. Передайте строку для пользовательской подсказки, `{"type": "preset", "preset": "claude_code"}` для системной подсказки Claude Code с дополнительным `"append"`, или `{"type": "file", "path": "..."}` для загрузки большой подсказки с диска. См. [`SystemPromptPreset`](#systempromptpreset) и [`SystemPromptFile`](#systempromptfile) |911| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | Конфигурация системной подсказки. Передайте строку для пользовательской подсказки, `{"type": "preset", "preset": "claude_code"}` для системной подсказки Claude Code с дополнительным `"append"`, или `{"type": "file", "path": "..."}` для загрузки большой подсказки с диска. См. [`SystemPromptPreset`](#systempromptpreset) и [`SystemPromptFile`](#systempromptfile) |

912| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Конфигурации MCP server или путь к файлу конфигурации |912| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | Конфигурации MCP server или путь к файлу конфигурации |

913| `strict_mcp_config` | `bool` | `False` | Когда `True`, используйте только servers, переданные в `mcp_servers`, и игнорируйте проект `.mcp.json`, параметры пользователя, MCP servers, предоставленные plugins, и [claude.ai connectors](/ru/mcp#use-mcp-servers-from-claude-ai). Соответствует флагу CLI `--strict-mcp-config` |913| `strict_mcp_config` | `bool` | `False` | Когда `True`, используйте только servers, переданные в `mcp_servers`, и игнорируйте проект `.mcp.json`, параметры пользователя, MCP servers, предоставленные plugins, и [claude.ai connectors](/docs/ru/mcp#use-mcp-servers-from-claude-ai). Соответствует флагу CLI `--strict-mcp-config` |

914| `permission_mode` | `PermissionMode \| None` | `None` | Режим разрешений для использования инструментов |914| `permission_mode` | `PermissionMode \| None` | `None` | Режим разрешений для использования инструментов |

915| `continue_conversation` | `bool` | `False` | Продолжить самый последний разговор |915| `continue_conversation` | `bool` | `False` | Продолжить самый последний разговор |

916| `resume` | `str \| None` | `None` | ID сеанса для возобновления |916| `resume` | `str \| None` | `None` | ID сеанса для возобновления |

917| `max_turns` | `int \| None` | `None` | Максимальное количество агентских ходов (раунды использования инструментов) |917| `max_turns` | `int \| None` | `None` | Максимальное количество агентских ходов (раунды использования инструментов) |

918| `max_budget_usd` | `float \| None` | `None` | Остановите запрос, когда оценка стоимости на стороне клиента достигнет этого значения USD. Сравнивается с той же оценкой, что и `total_cost_usd`; см. [Track cost and usage](/ru/agent-sdk/cost-tracking) для предостережений точности |918| `max_budget_usd` | `float \| None` | `None` | Остановите запрос, когда оценка стоимости на стороне клиента достигнет этого значения USD. Сравнивается с той же оценкой, что и `total_cost_usd`; см. [Track cost and usage](/docs/ru/agent-sdk/cost-tracking) для предостережений точности |

919| `disallowed_tools` | `list[str]` | `[]` | Инструменты для отклонения. Простое имя, такое как `"Bash"`, удаляет инструмент из контекста Claude. Правило с областью действия, такое как `"Bash(rm *)"`, оставляет инструмент доступным и отклоняет совпадающие вызовы в каждом режиме разрешений, включая `bypassPermissions`. См. [Permissions](/ru/agent-sdk/permissions#allow-and-deny-rules) |919| `disallowed_tools` | `list[str]` | `[]` | Инструменты для отклонения. Простое имя, такое как `"Bash"`, удаляет инструмент из контекста Claude. Правило с областью действия, такое как `"Bash(rm *)"`, оставляет инструмент доступным и отклоняет совпадающие вызовы в каждом режиме разрешений, включая `bypassPermissions`. См. [Permissions](/docs/ru/agent-sdk/permissions#allow-and-deny-rules) |

920| `enable_file_checkpointing` | `bool` | `False` | Включить отслеживание изменений файлов для перемотки. См. [File checkpointing](/ru/agent-sdk/file-checkpointing) |920| `enable_file_checkpointing` | `bool` | `False` | Включить отслеживание изменений файлов для перемотки. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |

921| `model` | `str \| None` | `None` | Модель Claude для использования. См. [accepted values and provider-specific IDs](/ru/model-config#available-models) |921| `model` | `str \| None` | `None` | Модель Claude для использования. См. [accepted values and provider-specific IDs](/docs/ru/model-config#available-models) |

922| `fallback_model` | `str \| None` | `None` | Резервная модель для использования, если основная модель не работает |922| `fallback_model` | `str \| None` | `None` | Резервная модель для использования, если основная модель не работает |

923| `betas` | `list[SdkBeta]` | `[]` | Функции бета-версии для включения. См. [`SdkBeta`](#sdkbeta) для доступных опций |923| `betas` | `list[SdkBeta]` | `[]` | Функции бета-версии для включения. См. [`SdkBeta`](#sdkbeta) для доступных опций |

924| `output_format` | `dict[str, Any] \| None` | `None` | Формат вывода для структурированных ответов (например, `{"type": "json_schema", "schema": {...}}`). См. [Structured outputs](/ru/agent-sdk/structured-outputs) для деталей |924| `output_format` | `dict[str, Any] \| None` | `None` | Формат вывода для структурированных ответов (например, `{"type": "json_schema", "schema": {...}}`). См. [Structured outputs](/docs/ru/agent-sdk/structured-outputs) для деталей |

925| `permission_prompt_tool_name` | `str \| None` | `None` | Имя MCP tool для подсказок разрешений |925| `permission_prompt_tool_name` | `str \| None` | `None` | Имя MCP tool для подсказок разрешений |

926| `cwd` | `str \| Path \| None` | `None` | Текущий рабочий каталог |926| `cwd` | `str \| Path \| None` | `None` | Текущий рабочий каталог |

927| `cli_path` | `str \| Path \| None` | `None` | Пользовательский путь к исполняемому файлу Claude Code CLI |927| `cli_path` | `str \| Path \| None` | `None` | Пользовательский путь к исполняемому файлу Claude Code CLI |

928| `settings` | `str \| None` | `None` | Путь к файлу параметров |928| `settings` | `str \| None` | `None` | Путь к файлу параметров |

929| `add_dirs` | `list[str \| Path]` | `[]` | Дополнительные каталоги, к которым Claude может получить доступ |929| `add_dirs` | `list[str \| Path]` | `[]` | Дополнительные каталоги, к которым Claude может получить доступ |

930| `env` | `dict[str, str]` | `{}` | Переменные окружения, объединенные поверх унаследованного окружения процесса. См. [Environment variables](/ru/env-vars) для переменных, которые читает базовый CLI, и [Handle slow or stalled API responses](#handle-slow-or-stalled-api-responses) для переменных, связанных с тайм-аутом |930| `env` | `dict[str, str]` | `{}` | Переменные окружения, объединенные поверх унаследованного окружения процесса. См. [Environment variables](/docs/ru/env-vars) для переменных, которые читает базовый CLI, и [Handle slow or stalled API responses](#handle-slow-or-stalled-api-responses) для переменных, связанных с тайм-аутом |

931| `extra_args` | `dict[str, str \| None]` | `{}` | Дополнительные аргументы CLI для прямой передачи в CLI |931| `extra_args` | `dict[str, str \| None]` | `{}` | Дополнительные аргументы CLI для прямой передачи в CLI |

932| `max_buffer_size` | `int \| None` | `None` | Максимальные байты при буферизации stdout CLI |932| `max_buffer_size` | `int \| None` | `None` | Максимальные байты при буферизации stdout CLI |

933| `debug_stderr` | `Any` | `sys.stderr` | *Устарело* - Объект, подобный файлу, для вывода отладки. Вместо этого используйте обратный вызов `stderr` |933| `debug_stderr` | `Any` | `sys.stderr` | *Устарело* - Объект, подобный файлу, для вывода отладки. Вместо этого используйте обратный вызов `stderr` |

934| `stderr` | `Callable[[str], None] \| None` | `None` | Функция обратного вызова для вывода stderr из CLI |934| `stderr` | `Callable[[str], None] \| None` | `None` | Функция обратного вызова для вывода stderr из CLI |

935| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Функция обратного вызова разрешения инструмента, вызываемая только когда [permission flow](/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к подсказке. Не вызывается для вызовов, автоматически одобренных `allowed_tools`, правилами разрешения или `permission_mode`. `AskUserQuestion`, connector tools [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и MCP tools, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), достигают его даже если вы их разрешили; в режиме `dontAsk` они вместо этого отклоняются. См. [`CanUseTool`](#canusetool) для деталей |935| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | Функция обратного вызова разрешения инструмента, вызываемая только когда [permission flow](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к подсказке. Не вызывается для вызовов, автоматически одобренных `allowed_tools`, правилами разрешения или `permission_mode`. `AskUserQuestion`, connector tools [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и MCP tools, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), достигают его даже если вы их разрешили; в режиме `dontAsk` они вместо этого отклоняются. См. [`CanUseTool`](#canusetool) для деталей |

936| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | Конфигурации hooks для перехвата событий |936| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | Конфигурации hooks для перехвата событий |

937| `user` | `str \| None` | `None` | Идентификатор пользователя |937| `user` | `str \| None` | `None` | Идентификатор пользователя |

938| `include_partial_messages` | `bool` | `False` | Включить события потоковой передачи частичных сообщений. Когда включено, выдаются сообщения [`StreamEvent`](#streamevent) |938| `include_partial_messages` | `bool` | `False` | Включить события потоковой передачи частичных сообщений. Когда включено, выдаются сообщения [`StreamEvent`](#streamevent) |

939| `include_hook_events` | `bool` | `False` | Включить события жизненного цикла hooks в поток сообщений как объекты `HookEventMessage` |939| `include_hook_events` | `bool` | `False` | Включить события жизненного цикла hooks в поток сообщений как объекты `HookEventMessage` |

940| `fork_session` | `bool` | `False` | При возобновлении с `resume` разветвитесь на новый ID сеанса вместо продолжения исходного сеанса |940| `fork_session` | `bool` | `False` | При возобновлении с `resume` разветвитесь на новый ID сеанса вместо продолжения исходного сеанса |

941| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Программно определенные подагенты |941| `agents` | `dict[str, AgentDefinition] \| None` | `None` | Программно определенные подагенты |

942| `plugins` | `list[SdkPluginConfig]` | `[]` | Загрузите пользовательские plugins из локальных путей. См. [Plugins](/ru/agent-sdk/plugins) для деталей |942| `plugins` | `list[SdkPluginConfig]` | `[]` | Загрузите пользовательские plugins из локальных путей. См. [Plugins](/docs/ru/agent-sdk/plugins) для деталей |

943| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Программно настройте поведение sandbox. См. [Sandbox settings](#sandboxsettings) для деталей |943| `sandbox` | [`SandboxSettings`](#sandboxsettings) ` \| None` | `None` | Программно настройте поведение sandbox. См. [Sandbox settings](#sandboxsettings) для деталей |

944| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Контролируйте, какие параметры файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных параметров. Управляемые параметры политики загружаются независимо; параметры, управляемые сервером, загружаются, когда сеанс аутентифицируется с учетными данными организации на [подходящей конфигурации](/ru/server-managed-settings#platform-availability). См. [Use Claude Code features](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входов, которые читаются независимо от этой опции, и как их отключить |944| `setting_sources` | `list[SettingSource] \| None` | `None` (CLI defaults: all sources) | Контролируйте, какие параметры файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных параметров. Управляемые параметры политики загружаются независимо; параметры, управляемые сервером, загружаются, когда сеанс аутентифицируется с учетными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). См. [Use Claude Code features](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входов, которые читаются независимо от этой опции, и как их отключить |

945| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills, доступные сеансу. Передайте `"all"` для включения каждого обнаруженного skill, или список имен skills. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowed_tools`. Если вы также передаете `tools`, включите `"Skill"` в этот список. См. [Skills](/ru/agent-sdk/skills) |945| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills, доступные сеансу. Передайте `"all"` для включения каждого обнаруженного skill, или список имен skills. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowed_tools`. Если вы также передаете `tools`, включите `"Skill"` в этот список. См. [Skills](/docs/ru/agent-sdk/skills) |

946| `max_thinking_tokens` | `int \| None` | `None` | *Устарело* - Максимальные токены для блоков мышления. Вместо этого используйте `thinking` |946| `max_thinking_tokens` | `int \| None` | `None` | *Устарело* - Максимальные токены для блоков мышления. Вместо этого используйте `thinking` |

947| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Управляет поведением расширенного мышления. Имеет приоритет над `max_thinking_tokens` |947| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Управляет поведением расширенного мышления. Имеет приоритет над `max_thinking_tokens` |

948| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | Уровень усилий для глубины мышления. См. [adjust the effort level](/ru/model-config#adjust-effort-level) |948| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | Уровень усилий для глубины мышления. См. [adjust the effort level](/docs/ru/model-config#adjust-effort-level) |

949| `session_store` | [`SessionStore`](/ru/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Зеркалируйте стенограммы сеансов во внешний бэкэнд, чтобы любой хост мог их возобновить. См. [Persist sessions to external storage](/ru/agent-sdk/session-storage) |949| `session_store` | [`SessionStore`](/docs/ru/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Зеркалируйте стенограммы сеансов во внешний бэкэнд, чтобы любой хост мог их возобновить. См. [Persist sessions to external storage](/docs/ru/agent-sdk/session-storage) |

950| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Когда сбрасывать записи зеркальной стенограммы в `session_store`. `"batched"` сбрасывает один раз за ход или когда буфер заполняется; `"eager"` запускает фоновый сброс после каждого кадра. Игнорируется, когда `session_store` равен `None` |950| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Когда сбрасывать записи зеркальной стенограммы в `session_store`. `"batched"` сбрасывает один раз за ход или когда буфер заполняется; `"eager"` запускает фоновый сброс после каждого кадра. Игнорируется, когда `session_store` равен `None` |

951 951 

952<h4 id="handle-slow-or-stalled-api-responses">952<h4 id="handle-slow-or-stalled-api-responses">


966```966```

967 967 

968* `API_TIMEOUT_MS`: тайм-аут для каждого запроса на клиенте Anthropic в миллисекундах. По умолчанию `600000`. Применяется к основному циклу и всем подагентам.968* `API_TIMEOUT_MS`: тайм-аут для каждого запроса на клиенте Anthropic в миллисекундах. По умолчанию `600000`. Применяется к основному циклу и всем подагентам.

969* `CLAUDE_CODE_MAX_RETRIES`: максимальное количество повторных попыток API. По умолчанию `10`, ограничено `15`. Каждая повторная попытка получает свое собственное окно `API_TIMEOUT_MS`, поэтому наихудшее время стены примерно `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` плюс отступ. Для автоматических запусков, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG=1`: он повторяет ошибки емкости бесконечно, и {/* min-version: 2.1.199 */}начиная с Claude Code v2.1.199 повышает значение по умолчанию для других переходных ошибок до `300` и удаляет ограничение на эту переменную.969* `CLAUDE_CODE_MAX_RETRIES`: максимальное количество повторных попыток API. По умолчанию `10`, ограничено `15`. Каждая повторная попытка получает свое собственное окно `API_TIMEOUT_MS`, поэтому наихудшее время стены примерно `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` плюс отступ. Для автоматических запусков, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG=1`: он повторяет ошибки емкости бесконечно, и начиная с Claude Code v2.1.199 повышает значение по умолчанию для других переходных ошибок до `300` и удаляет ограничение на эту переменную.

970* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: сторожевой таймер зависания для подагентов, запущенных с `run_in_background`. По умолчанию `600000`. Сбрасывается при каждом событии потока; при зависании он прерывает подагента, отмечает задачу как неудачную и выводит ошибку родителю с любым частичным результатом. Не применяется к синхронным подагентам.970* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: сторожевой таймер зависания для подагентов, запущенных с `run_in_background`. По умолчанию `600000`. Сбрасывается при каждом событии потока; при зависании он прерывает подагента, отмечает задачу как неудачную и выводит ошибку родителю с любым частичным результатом. Не применяется к синхронным подагентам.

971* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: прерывает запрос, когда заголовки прибыли, но тело ответа перестает потоковать. Сторожевой таймер включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается до этого минимума. Прерванный запрос проходит через обычный путь повторной попытки.971* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: прерывает запрос, когда заголовки прибыли, но тело ответа перестает потоковать. Сторожевой таймер включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается до этого минимума. Прерванный запрос проходит через обычный путь повторной попытки.

972 972 


1008| `type` | Да | Должно быть `"preset"` для использования предустановленной системной подсказки |1008| `type` | Да | Должно быть `"preset"` для использования предустановленной системной подсказки |

1009| `preset` | Да | Должно быть `"claude_code"` для использования системной подсказки Claude Code |1009| `preset` | Да | Должно быть `"claude_code"` для использования системной подсказки Claude Code |

1010| `append` | Нет | Дополнительные инструкции для добавления к предустановленной системной подсказке |1010| `append` | Нет | Дополнительные инструкции для добавления к предустановленной системной подсказке |

1011| `exclude_dynamic_sections` | Нет | Переместите контекст для каждого сеанса, такой как рабочий каталог, статус git и пути памяти, из системной подсказки в первое пользовательское сообщение. Улучшает повторное использование кэша подсказок между пользователями и машинами. См. [Modify system prompts](/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |1011| `exclude_dynamic_sections` | Нет | Переместите контекст для каждого сеанса, такой как рабочий каталог, статус git и пути памяти, из системной подсказки в первое пользовательское сообщение. Улучшает повторное использование кэша подсказок между пользователями и машинами. См. [Modify system prompts](/docs/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

1012 1012 

1013<h3 id="systempromptfile">1013<h3 id="systempromptfile">

1014 `SystemPromptFile`1014 `SystemPromptFile`

1015</h3>1015</h3>

1016 1016 

1017Конфигурация для загрузки пользовательской системной подсказки из файла вместо передачи ее в виде строки. SDK сопоставляет это с флагом CLI [`--system-prompt-file`](/ru/cli-reference#system-prompt-flags). Используйте форму файла, когда подсказка большая: SDK передает строку `system_prompt` в argv подпроцесса CLI, что подвергается ограничениям длины командной строки ОС перед отправкой SDK любого запроса API. На Linux один аргумент длиннее примерно 128 КБ не работает при порождении процесса с `Argument list too long`. На Windows вся командная строка ограничена примерно 32 КБ, поэтому форма строки не работает при более низком пороге.1017Конфигурация для загрузки пользовательской системной подсказки из файла вместо передачи ее в виде строки. SDK сопоставляет это с флагом CLI [`--system-prompt-file`](/docs/ru/cli-reference#system-prompt-flags). Используйте форму файла, когда подсказка большая: SDK передает строку `system_prompt` в argv подпроцесса CLI, что подвергается ограничениям длины командной строки ОС перед отправкой SDK любого запроса API. На Linux один аргумент длиннее примерно 128 КБ не работает при порождении процесса с `Argument list too long`. На Windows вся командная строка ограничена примерно 32 КБ, поэтому форма строки не работает при более низком пороге.

1018 1018 

1019```python theme={null}1019```python theme={null}

1020class SystemPromptFile(TypedDict):1020class SystemPromptFile(TypedDict):


1047 Поведение по умолчанию1047 Поведение по умолчанию

1048</h4>1048</h4>

1049 1049 

1050Когда `setting_sources` опущено или `None`, `query()` загружает те же параметры файловой системы, что и Claude Code CLI: пользовательские, проектные и локальные. Управляемые параметры политики загружаются во всех случаях; параметры, управляемые сервером, загружаются, когда сеанс аутентифицируется с учетными данными организации на [подходящей конфигурации](/ru/server-managed-settings#platform-availability). См. [What settingSources does not control](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входов, которые читаются независимо от этой опции, и как их отключить.1050Когда `setting_sources` опущено или `None`, `query()` загружает те же параметры файловой системы, что и Claude Code CLI: пользовательские, проектные и локальные. Управляемые параметры политики загружаются во всех случаях; параметры, управляемые сервером, загружаются, когда сеанс аутентифицируется с учетными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). См. [What settingSources does not control](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входов, которые читаются независимо от этой опции, и как их отключить.

1051 1051 

1052<h4 id="why-use-setting_sources">1052<h4 id="why-use-setting_sources">

1053 Почему использовать setting\_sources1053 Почему использовать setting\_sources


1257 1257 

1258Возвращает `PermissionResult` (либо `PermissionResultAllow`, либо `PermissionResultDeny`).1258Возвращает `PermissionResult` (либо `PermissionResultAllow`, либо `PermissionResultDeny`).

1259 1259 

1260Обратный вызов - это замена SDK для интерактивной подсказки разрешения: он вызывается только когда [permission evaluation flow](/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в подсказку. Вызовы инструментов, уже одобренные записью `allowed_tools`, правилом параметров разрешения или режимом разрешения, таким как `acceptEdits` или `bypassPermissions`, никогда его не вызывают. `AskUserQuestion`, MCP tools, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), и connector tools [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) достигают обратного вызова даже когда правило разрешения совпадает. В режиме `dontAsk` эти вызовы вместо этого отклоняются, без вызова обратного вызова. Чтобы контролировать каждый вызов инструмента, используйте вместо этого [hook `PreToolUse`](/ru/agent-sdk/hooks).1260Обратный вызов - это замена SDK для интерактивной подсказки разрешения: он вызывается только когда [permission evaluation flow](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в подсказку. Вызовы инструментов, уже одобренные записью `allowed_tools`, правилом параметров разрешения или режимом разрешения, таким как `acceptEdits` или `bypassPermissions`, никогда его не вызывают. `AskUserQuestion`, MCP tools, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), и connector tools [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) достигают обратного вызова даже когда правило разрешения совпадает. В режиме `dontAsk` эти вызовы вместо этого отклоняются, без вызова обратного вызова. Чтобы контролировать каждый вызов инструмента, используйте вместо этого [hook `PreToolUse`](/docs/ru/agent-sdk/hooks).

1261 1261 

1262<h3 id="toolpermissioncontext">1262<h3 id="toolpermissioncontext">

1263 `ToolPermissionContext`1263 `ToolPermissionContext`


1604]1604]

1605```1605```

1606 1606 

1607Для полной информации о создании и использовании plugins см. [Plugins](/ru/agent-sdk/plugins).1607Для полной информации о создании и использовании plugins см. [Plugins](/docs/ru/agent-sdk/plugins).

1608 1608 

1609<h2 id="message-types">1609<h2 id="message-types">

1610 Типы сообщений1610 Типы сообщений


1747 1747 

1748| Ключ | Тип | Описание |1748| Ключ | Тип | Описание |

1749| ----------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1749| ----------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1750| `input_tokens` | `int` | Входные токены, потребленные циклом агента верхнего уровня. [Токены подагента не включены](/ru/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); используйте `model_usage` для учета всего дерева. |1750| `input_tokens` | `int` | Входные токены, потребленные циклом агента верхнего уровня. [Токены подагента не включены](/docs/ru/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); используйте `model_usage` для учета всего дерева. |

1751| `output_tokens` | `int` | Выходные токены, созданные циклом агента верхнего уровня. Токены подагента не включены. |1751| `output_tokens` | `int` | Выходные токены, созданные циклом агента верхнего уровня. Токены подагента не включены. |

1752| `cache_creation_input_tokens` | `int` | Токены, используемые для создания новых записей кэша. |1752| `cache_creation_input_tokens` | `int` | Токены, используемые для создания новых записей кэша. |

1753| `cache_read_input_tokens` | `int` | Токены, прочитанные из существующих записей кэша. |1753| `cache_read_input_tokens` | `int` | Токены, прочитанные из существующих записей кэша. |

1754 1754 

1755Словарь `model_usage` отображает имена моделей на использование для каждой модели. Внутренние ключи словаря используют camelCase, потому что значение передается без изменений из базового процесса CLI, соответствуя типу TypeScript [`ModelUsage`](/ru/agent-sdk/typescript#modelusage):1755Словарь `model_usage` отображает имена моделей на использование для каждой модели. Внутренние ключи словаря используют camelCase, потому что значение передается без изменений из базового процесса CLI, соответствуя типу TypeScript [`ModelUsage`](/docs/ru/agent-sdk/typescript#modelusage):

1756 1756 

1757| Ключ | Тип | Описание |1757| Ключ | Тип | Описание |

1758| -------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1758| -------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


1761| `cacheReadInputTokens` | `int` | Токены чтения кэша для этой модели. |1761| `cacheReadInputTokens` | `int` | Токены чтения кэша для этой модели. |

1762| `cacheCreationInputTokens` | `int` | Токены создания кэша для этой модели. |1762| `cacheCreationInputTokens` | `int` | Токены создания кэша для этой модели. |

1763| `webSearchRequests` | `int` | Запросы веб-поиска, сделанные этой моделью. |1763| `webSearchRequests` | `int` | Запросы веб-поиска, сделанные этой моделью. |

1764| `costUSD` | `float` | Предполагаемая стоимость в USD для этой модели, вычисленная на стороне клиента. См. [Track cost and usage](/ru/agent-sdk/cost-tracking) для предостережений выставления счетов. |1764| `costUSD` | `float` | Предполагаемая стоимость в USD для этой модели, вычисленная на стороне клиента. См. [Track cost and usage](/docs/ru/agent-sdk/cost-tracking) для предостережений выставления счетов. |

1765| `contextWindow` | `int` | Размер окна контекста для этой модели. |1765| `contextWindow` | `int` | Размер окна контекста для этой модели. |

1766| `maxOutputTokens` | `int` | Максимальный лимит выходных токенов для этой модели. |1766| `maxOutputTokens` | `int` | Максимальный лимит выходных токенов для этой модели. |

1767 1767 


2088 Типы hooks2088 Типы hooks

2089</h2>2089</h2>

2090 2090 

2091Для полного руководства по использованию hooks с примерами и общими шаблонами см. [Hooks guide](/ru/agent-sdk/hooks).2091Для полного руководства по использованию hooks с примерами и общими шаблонами см. [Hooks guide](/docs/ru/agent-sdk/hooks).

2092 2092 

2093<h3 id="hookevent">2093<h3 id="hookevent">

2094 `HookEvent`2094 `HookEvent`


2472 `HookSpecificOutput`2472 `HookSpecificOutput`

2473</h4>2473</h4>

2474 2474 

2475`TypedDict`, содержащий имя события hooks и поля, специфичные для события. Форма зависит от значения `hookEventName`. Для полных деталей доступных полей для каждого события hooks см. [Control execution with hooks](/ru/agent-sdk/hooks#outputs).2475`TypedDict`, содержащий имя события hooks и поля, специфичные для события. Форма зависит от значения `hookEventName`. Для полных деталей доступных полей для каждого события hooks см. [Control execution with hooks](/docs/ru/agent-sdk/hooks#outputs).

2476 2476 

2477Дискриминированное объединение типов вывода, специфичных для события. Поле `hookEventName` определяет, какие поля действительны.2477Дискриминированное объединение типов вывода, специфичных для события. Поле `hookEventName` определяет, какие поля действительны.

2478 2478 


2637 2637 

2638**Имя инструмента:** `AskUserQuestion`2638**Имя инструмента:** `AskUserQuestion`

2639 2639 

2640Задает пользователю уточняющие вопросы во время выполнения. См. [Обработка одобрений и ввода пользователя](/ru/agent-sdk/user-input#handle-clarifying-questions) для деталей использования.2640Задает пользователю уточняющие вопросы во время выполнения. См. [Обработка одобрений и ввода пользователя](/docs/ru/agent-sdk/user-input#handle-clarifying-questions) для деталей использования.

2641 2641 

2642**Ввод:**2642**Ввод:**

2643 2643 


2715 2715 

2716Запускает фоновый источник и доставляет каждое событие в Claude, чтобы он мог реагировать без опроса: `command` запускает скрипт и выдает одно событие на строку stdout, а `ws` открывает WebSocket и выдает одно событие на текстовый фрейм. Укажите ровно один из `command` или `ws`.2716Запускает фоновый источник и доставляет каждое событие в Claude, чтобы он мог реагировать без опроса: `command` запускает скрипт и выдает одно событие на строку stdout, а `ws` открывает WebSocket и выдает одно событие на текстовый фрейм. Укажите ровно один из `command` или `ws`.

2717 2717 

2718Когда Monitor запускает команду, он следует тем же правилам разрешений, что и Bash; наблюдение за WebSocket запрашивает одобрение отдельно. {/* min-version: 2.1.195 */}Источник `ws` требует Claude Code v2.1.195 или позже. См. [Справочник инструмента Monitor](/ru/tools-reference#monitor-tool) для поведения и доступности поставщика.2718Когда Monitor запускает команду, он следует тем же правилам разрешений, что и Bash; наблюдение за WebSocket запрашивает одобрение отдельно. Источник `ws` требует Claude Code v2.1.195 или позже. См. [Справочник инструмента Monitor](/docs/ru/tools-reference#monitor-tool) для поведения и доступности поставщика.

2719 2719 

2720**Ввод:**2720**Ввод:**

2721 2721 


2993**Имя инструмента:** `TodoWrite`2993**Имя инструмента:** `TodoWrite`

2994 2994 

2995<Note>2995<Note>

2996 Начиная с Claude Code v2.1.142, `TodoWrite` отключен по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. См. [Миграция на инструменты Task](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.2996 Начиная с Claude Code v2.1.142, `TodoWrite` отключен по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. См. [Миграция на инструменты Task](/docs/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.

2997</Note>2997</Note>

2998 2998 

2999**Ввод:**2999**Ввод:**


3697 `SandboxNetworkConfig`3697 `SandboxNetworkConfig`

3698</h3>3698</h3>

3699 3699 

3700Конфигурация, специфичная для сети, для режима sandbox. Эти параметры применяются к sandboxed Bash командам, когда `enabled` имеет значение `True` в родительском [`SandboxSettings`](#sandboxsettings). Они не ограничивают инструмент WebFetch, который вместо этого использует [правила разрешений](/ru/permissions#webfetch).3700Конфигурация, специфичная для сети, для режима sandbox. Эти параметры применяются к sandboxed Bash командам, когда `enabled` имеет значение `True` в родительском [`SandboxSettings`](#sandboxsettings). Они не ограничивают инструмент WebFetch, который вместо этого использует [правила разрешений](/docs/ru/permissions#webfetch).

3701 3701 

3702```python theme={null}3702```python theme={null}

3703class SandboxNetworkConfig(TypedDict, total=False):3703class SandboxNetworkConfig(TypedDict, total=False):


3725| `socksProxyPort` | `int` | `None` | Порт SOCKS proxy для сетевых запросов |3725| `socksProxyPort` | `int` | `None` | Порт SOCKS proxy для сетевых запросов |

3726 3726 

3727<Note>3727<Note>

3728 Встроенный прокси sandbox обеспечивает соблюдение списка разрешенных сетей на основе запрашиваемого имени хоста и не завершает и не проверяет трафик TLS, поэтому такие методы, как [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting), потенциально могут его обойти. Подробнее см. в разделе [Ограничения безопасности Sandboxing](/ru/sandboxing#security-limitations) и [Безопасное развертывание](/ru/agent-sdk/secure-deployment#traffic-forwarding) для настройки прокси, завершающего TLS.3728 Встроенный прокси sandbox обеспечивает соблюдение списка разрешенных сетей на основе запрашиваемого имени хоста и не завершает и не проверяет трафик TLS, поэтому такие методы, как [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting), потенциально могут его обойти. Подробнее см. в разделе [Ограничения безопасности Sandboxing](/docs/ru/sandboxing#security-limitations) и [Безопасное развертывание](/docs/ru/agent-sdk/secure-deployment#traffic-forwarding) для настройки прокси, завершающего TLS.

3729</Note>3729</Note>

3730 3730 

3731<h3 id="sandboxignoreviolations">3731<h3 id="sandboxignoreviolations">


3822<Warning>3822<Warning>

3823 Команды, работающие с `dangerouslyDisableSandbox: True`, имеют полный доступ к системе. Убедитесь, что ваш обработчик `can_use_tool` тщательно проверяет эти запросы.3823 Команды, работающие с `dangerouslyDisableSandbox: True`, имеют полный доступ к системе. Убедитесь, что ваш обработчик `can_use_tool` тщательно проверяет эти запросы.

3824 3824 

3825 Если `permission_mode` установлен на `bypassPermissions` и `allow_unsandboxed_commands` включен, модель может автономно выполнять команды вне sandbox без каких-либо подсказок одобрения (явное [`ask` правило](/ru/agent-sdk/permissions#how-permissions-are-evaluated) все еще требует одного). Эта комбинация фактически позволяет модели молча выходить из изоляции sandbox.3825 Если `permission_mode` установлен на `bypassPermissions` и `allow_unsandboxed_commands` включен, модель может автономно выполнять команды вне sandbox без каких-либо подсказок одобрения (явное [`ask` правило](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) все еще требует одного). Эта комбинация фактически позволяет модели молча выходить из изоляции sandbox.

3826</Warning>3826</Warning>

3827 3827 

3828<h2 id="see-also">3828<h2 id="see-also">

3829 См. также3829 См. также

3830</h2>3830</h2>

3831 3831 

3832* [SDK overview](/ru/agent-sdk/overview) - Общие концепции SDK3832* [SDK overview](/docs/ru/agent-sdk/overview) - Общие концепции SDK

3833* [TypeScript SDK reference](/ru/agent-sdk/typescript) - Документация TypeScript SDK3833* [TypeScript SDK reference](/docs/ru/agent-sdk/typescript) - Документация TypeScript SDK

3834* [CLI reference](/ru/cli-reference) - Интерфейс командной строки3834* [CLI reference](/docs/ru/cli-reference) - Интерфейс командной строки

3835* [Common workflows](/ru/common-workflows) - Пошаговые руководства3835* [Common workflows](/docs/ru/common-workflows) - Пошаговые руководства

Details

17 17 

18Вы можете создавать подагентов тремя способами:18Вы можете создавать подагентов тремя способами:

19 19 

20* **Программно**: используйте параметр `agents` в параметрах `query()`. См. справочники [TypeScript](/ru/agent-sdk/typescript#agentdefinition) и [Python](/ru/agent-sdk/python#agentdefinition)20* **Программно**: используйте параметр `agents` в параметрах `query()`. См. справочники [TypeScript](/docs/ru/agent-sdk/typescript#agentdefinition) и [Python](/docs/ru/agent-sdk/python#agentdefinition)

21* **На основе файловой системы**: определяйте агентов как файлы markdown в директориях `.claude/agents/`. См. [определение подагентов как файлов](/ru/sub-agents)21* **На основе файловой системы**: определяйте агентов как файлы markdown в директориях `.claude/agents/`. См. [определение подагентов как файлов](/docs/ru/sub-agents)

22* **Встроенный универсальный**: Claude может вызывать встроенного подагента `general-purpose` в любое время через инструмент Agent без необходимости что-либо определять22* **Встроенный универсальный**: Claude может вызывать встроенного подагента `general-purpose` в любое время через инструмент Agent без необходимости что-либо определять

23 23 

24Это руководство сосредоточено на программном подходе, который рекомендуется для приложений SDK.24Это руководство сосредоточено на программном подходе, который рекомендуется для приложений SDK.


197| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | Нет | Уровень усилий рассуждения для этого агента |197| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | Нет | Уровень усилий рассуждения для этого агента |

198| `permissionMode` | `PermissionMode` | Нет | Режим разрешений для выполнения инструментов в этом агенте |198| `permissionMode` | `PermissionMode` | Нет | Режим разрешений для выполнения инструментов в этом агенте |

199 199 

200В Python SDK многословные имена полей, такие как `disallowedTools` и `mcpServers`, сохраняют написание camelCase для соответствия формату передачи, а не следуют соглашению Python snake\_case. Подробности см. в [справочнике `AgentDefinition`](/ru/agent-sdk/python#agentdefinition).200В Python SDK многословные имена полей, такие как `disallowedTools` и `mcpServers`, сохраняют написание camelCase для соответствия формату передачи, а не следуют соглашению Python snake\_case. Подробности см. в [справочнике `AgentDefinition`](/docs/ru/agent-sdk/python#agentdefinition).

201 201 

202Два поведения подагентов изменились в Claude Code v2.1.198:202Два поведения подагентов изменились в Claude Code v2.1.198:

203 203 

204* Подагенты работают в фоновом режиме по умолчанию. Вызов инструмента Agent, который опускает входной параметр [`run_in_background`](/ru/agent-sdk/typescript), запускает фоновый подагент, и Claude устанавливает `run_in_background: false`, когда ему нужен результат перед продолжением. До версии v2.1.198 опускание `run_in_background` запускало подагента синхронно. Установите поле `background` в `true`, чтобы принудительно включить фоновое выполнение для конкретного агента независимо от того, что запрашивает Claude.204* Подагенты работают в фоновом режиме по умолчанию. Вызов инструмента Agent, который опускает входной параметр [`run_in_background`](/docs/ru/agent-sdk/typescript), запускает фоновый подагент, и Claude устанавливает `run_in_background: false`, когда ему нужен результат перед продолжением. До версии v2.1.198 опускание `run_in_background` запускало подагента синхронно. Установите поле `background` в `true`, чтобы принудительно включить фоновое выполнение для конкретного агента независимо от того, что запрашивает Claude.

205* Подагент наследует конфигурацию расширенного мышления основной сессии. В более ранних версиях расширенное мышление отключено внутри подагентов независимо от параметра основной сессии.205* Подагент наследует конфигурацию расширенного мышления основной сессии. В более ранних версиях расширенное мышление отключено внутри подагентов независимо от параметра основной сессии.

206 206 

207<Note>207<Note>

208 {/* min-version: 2.1.172 */}Начиная с Claude Code v2.1.172, подагенты могут создавать своих собственных подагентов. Подагент на пять уровней ниже основного агента не может создавать дополнительных подагентов, независимо от того, работает ли он в переднем плане или в фоновом режиме. Чтобы предотвратить создание подагентом других подагентов, опустите `Agent` из его массива `tools` или добавьте его в `disallowedTools`. Полные правила глубины см. в разделе [вложенные подагенты](/ru/sub-agents#spawn-nested-subagents).208 Начиная с Claude Code v2.1.172, подагенты могут создавать своих собственных подагентов. Подагент на пять уровней ниже основного агента не может создавать дополнительных подагентов, независимо от того, работает ли он в переднем плане или в фоновом режиме. Чтобы предотвратить создание подагентом других подагентов, опустите `Agent` из его массива `tools` или добавьте его в `disallowedTools`. Полные правила глубины см. в разделе [вложенные подагенты](/docs/ru/sub-agents#spawn-nested-subagents).

209</Note>209</Note>

210 210 

211<h3 id="filesystem-based-definition-alternative">211<h3 id="filesystem-based-definition-alternative">

212 Определение на основе файловой системы (альтернатива)212 Определение на основе файловой системы (альтернатива)

213</h3>213</h3>

214 214 

215Вы также можете определять подагентов как файлы markdown в директориях `.claude/agents/`. Подробности об этом подходе см. в [документации подагентов Claude Code](/ru/sub-agents). Программно определенные агенты имеют приоритет над агентами на основе файловой системы с тем же именем.215Вы также можете определять подагентов как файлы markdown в директориях `.claude/agents/`. Подробности об этом подходе см. в [документации подагентов Claude Code](/docs/ru/sub-agents). Программно определенные агенты имеют приоритет над агентами на основе файловой системы с тем же именем.

216 216 

217<Note>217<Note>

218 Даже без определения пользовательских подагентов, Claude может создавать встроенного подагента `general-purpose`. Это полезно для делегирования задач исследования или исследования без создания специализированных агентов. Включите `Agent` в `allowedTools`, чтобы эти вызовы автоматически одобрялись без запроса разрешения.218 Даже без определения пользовательских подагентов, Claude может создавать встроенного подагента `general-purpose`. Это полезно для делегирования задач исследования или исследования без создания специализированных агентов. Включите `Agent` в `allowedTools`, чтобы эти вызовы автоматически одобрялись без запроса разрешения.


224 224 

225Окно контекста подагента начинается свежим (без истории родительской беседы), но не пусто. Единственный канал от родителя к подагенту — это строка промпта инструмента Agent, поэтому включайте любые пути файлов, сообщения об ошибках или решения, которые нужны подагенту, непосредственно в этот промпт.225Окно контекста подагента начинается свежим (без истории родительской беседы), но не пусто. Единственный канал от родителя к подагенту — это строка промпта инструмента Agent, поэтому включайте любые пути файлов, сообщения об ошибках или решения, которые нужны подагенту, непосредственно в этот промпт.

226 226 

227{/* min-version: 2.1.206 */}Подагент, у которого есть инструмент [`SendMessage`](/ru/tools-reference), начинает с списка других именованных агентов, работающих в сеансе, поэтому он знает, каким именам он может отправлять сообщения. Claude Code автоматически добавляет список в первый ход подагента. [Ветвление](/ru/sub-agents#fork-the-current-conversation) не получает список, потому что оно наследует родительскую беседу вместо этого. Список требует Claude Code v2.1.206 или более поздней версии.227Подагент, у которого есть инструмент [`SendMessage`](/docs/ru/tools-reference), начинает с списка других именованных агентов, работающих в сеансе, поэтому он знает, каким именам он может отправлять сообщения. Claude Code автоматически добавляет список в первый ход подагента. [Ветвление](/docs/ru/sub-agents#fork-the-current-conversation) не получает список, потому что оно наследует родительскую беседу вместо этого. Список требует Claude Code v2.1.206 или более поздней версии.

228 228 

229| Подагент получает | Подагент не получает |229| Подагент получает | Подагент не получает |

230| :------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------- |230| :------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------- |

231| Его собственный системный промпт (`AgentDefinition.prompt`) и промпт инструмента Agent | История беседы родителя или результаты инструментов |231| Его собственный системный промпт (`AgentDefinition.prompt`) и промпт инструмента Agent | История беседы родителя или результаты инструментов |

232| Проект CLAUDE.md (загруженный через [`settingSources`](/ru/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources)) | Предварительно загруженное содержимое skills, если не указано в `AgentDefinition.skills` |232| Проект CLAUDE.md (загруженный через [`settingSources`](/docs/ru/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources)) | Предварительно загруженное содержимое skills, если не указано в `AgentDefinition.skills` |

233| Определения инструментов (унаследованные от родителя или подмножество в `tools`) | Системный промпт родителя |233| Определения инструментов (унаследованные от родителя или подмножество в `tools`) | Системный промпт родителя |

234 234 

235<Note>235<Note>

236 Родитель получает финальное сообщение подагента дословно как результат инструмента Agent, но может суммировать его в своем собственном ответе. Чтобы сохранить выходные данные подагента дословно в ответе, обращенном к пользователю, включите инструкцию об этом в промпт или опцию `systemPrompt`, которую вы передаете основному вызову `query()`.236 Родитель получает финальное сообщение подагента дословно как результат инструмента Agent, но может суммировать его в своем собственном ответе. Чтобы сохранить выходные данные подагента дословно в ответе, обращенном к пользователю, включите инструкцию об этом в промпт или опцию `systemPrompt`, которую вы передаете основному вызову `query()`.

237</Note>237</Note>

238 238 

239{/* min-version: 2.1.199 */}Ошибка API, которая завершает работу подагента раньше времени, такая как ограничение скорости, никогда не доставляется как его результат. Если ограничение скорости, перегрузка или ошибка сервера прерывает подагента на переднем плане, который уже произвел текстовый выход, инструмент Agent возвращает этот частичный выход с примечанием о том, что подагент не завершил работу. {/* min-version: 2.1.200 */}Подагент, который не произвел ничего или чей единственный выход был вызовами инструментов без текста, завершается с сообщением об ошибке `Agent terminated early due to an API error`, за которым следует деталь ошибки. См. [API errors in subagents](/ru/sub-agents#api-errors-in-subagents) для поведения на переднем плане и в фоновом режиме.239Ошибка API, которая завершает работу подагента раньше времени, такая как ограничение скорости, никогда не доставляется как его результат. Если ограничение скорости, перегрузка или ошибка сервера прерывает подагента на переднем плане, который уже произвел текстовый выход, инструмент Agent возвращает этот частичный выход с примечанием о том, что подагент не завершил работу. Подагент, который не произвел ничего или чей единственный выход был вызовами инструментов без текста, завершается с сообщением об ошибке `Agent terminated early due to an API error`, за которым следует деталь ошибки. См. [API errors in subagents](/docs/ru/sub-agents#api-errors-in-subagents) для поведения на переднем плане и в фоновом режиме.

240 240 

241Эта обработка частичного выхода требует Claude Code v2.1.199 или более поздней версии. В v2.1.199 ограничение скорости, перегрузка или ошибка сервера оставляли форму, содержащую только вызовы инструментов, с пустым частичным результатом, содержащим только примечание об отсечении.241Эта обработка частичного выхода требует Claude Code v2.1.199 или более поздней версии. В v2.1.199 ограничение скорости, перегрузка или ошибка сервера оставляли форму, содержащую только вызовы инструментов, с пустым частичным результатом, содержащим только примечание об отсечении.

242 242 


441 441 

442Вы можете возобновить подагента, чтобы продолжить с того места, где он остановился, а не начинать заново. Возобновленный подагент сохраняет полную историю беседы, включая все предыдущие вызовы инструментов, результаты и рассуждения.442Вы можете возобновить подагента, чтобы продолжить с того места, где он остановился, а не начинать заново. Возобновленный подагент сохраняет полную историю беседы, включая все предыдущие вызовы инструментов, результаты и рассуждения.

443 443 

444Когда подагент завершается, результат инструмента Agent включает текстовый блок, содержащий `agentId: <id>`. Встроенные агенты [`Explore` и `Plan`](/ru/sub-agents#built-in-subagents) работают в один проход и не возвращают `agentId`, поэтому используйте пользовательского агента или `general-purpose`, когда вам нужно возобновить. Чтобы программно возобновить подагента:444Когда подагент завершается, результат инструмента Agent включает текстовый блок, содержащий `agentId: <id>`. Встроенные агенты [`Explore` и `Plan`](/docs/ru/sub-agents#built-in-subagents) работают в один проход и не возвращают `agentId`, поэтому используйте пользовательского агента или `general-purpose`, когда вам нужно возобновить. Чтобы программно возобновить подагента:

445 445 

4461. **Захватите ID сессии**: извлеките `session_id` из сообщений во время первого запроса4461. **Захватите ID сессии**: извлеките `session_id` из сообщений во время первого запроса

4472. **Извлеките ID агента**: разберите `agentId` из текста результата инструмента Agent4472. **Извлеките ID агента**: разберите `agentId` из текста результата инструмента Agent


661 Масштабирование с помощью динамических рабочих процессов661 Масштабирование с помощью динамических рабочих процессов

662</h2>662</h2>

663 663 

664Подагенты хорошо работают для нескольких делегированных задач за ход. Для запусков, которые координируют десятки или сотни агентов, используйте инструмент `Workflow`, который перемещает оркестровку в скрипт, который среда выполнения выполняет вне контекста беседы. Подробнее о том, чем рабочие процессы отличаются от делегирования подагентов по ходам, см. в [динамических рабочих процессах](/ru/workflows).664Подагенты хорошо работают для нескольких делегированных задач за ход. Для запусков, которые координируют десятки или сотни агентов, используйте инструмент `Workflow`, который перемещает оркестровку в скрипт, который среда выполнения выполняет вне контекста беседы. Подробнее о том, чем рабочие процессы отличаются от делегирования подагентов по ходам, см. в [динамических рабочих процессах](/docs/ru/workflows).

665 665 

666Инструмент `Workflow` доступен в TypeScript Agent SDK v0.3.149 и позже. Включите `Workflow` в `allowedTools` для автоматического одобрения запусков рабочих процессов. Схемы входных и выходных данных инструмента указаны в [справочнике TypeScript](/ru/agent-sdk/typescript#workflow).666Инструмент `Workflow` доступен в TypeScript Agent SDK v0.3.149 и позже. Включите `Workflow` в `allowedTools` для автоматического одобрения запусков рабочих процессов. Схемы входных и выходных данных инструмента указаны в [справочнике TypeScript](/docs/ru/agent-sdk/typescript#workflow).

667 667 

668<h2 id="troubleshooting">668<h2 id="troubleshooting">

669 Troubleshooting669 Troubleshooting


690* **`--disable-slash-commands`**: сессии, запущенные с этим флагом, не отслеживают эти директории и всегда требуют перезагрузки для загрузки новых файлов.690* **`--disable-slash-commands`**: сессии, запущенные с этим флагом, не отслеживают эти директории и всегда требуют перезагрузки для загрузки новых файлов.

691* **Программный агент с тем же именем**: `agents`, переданные в `query()`, переопределяют агента файловой системы с тем же именем.691* **Программный агент с тем же именем**: `agents`, переданные в `query()`, переопределяют агента файловой системы с тем же именем.

692 692 

693Для формата файла см. [как писать файлы подагентов](/ru/sub-agents#write-subagent-files).693Для формата файла см. [как писать файлы подагентов](/docs/ru/sub-agents#write-subagent-files).

694 694 

695<h3 id="long-prompt-failures-on-windows">695<h3 id="long-prompt-failures-on-windows">

696 Сбои при длинных промптах в Windows696 Сбои при длинных промптах в Windows


702 Связанная документация702 Связанная документация

703</h2>703</h2>

704 704 

705* [Подагенты Claude Code](/ru/sub-agents): полная документация подагентов, включая определения на основе файловой системы705* [Подагенты Claude Code](/docs/ru/sub-agents): полная документация подагентов, включая определения на основе файловой системы

706* [Динамические рабочие процессы](/ru/workflows): оркестрируйте множество подагентов из скрипта для работ, слишком больших для одной беседы706* [Динамические рабочие процессы](/docs/ru/workflows): оркестрируйте множество подагентов из скрипта для работ, слишком больших для одной беседы

707* [Обзор SDK](/ru/agent-sdk/overview): начало работы с Claude Agent SDK707* [Обзор SDK](/docs/ru/agent-sdk/overview): начало работы с Claude Agent SDK

Details

40 Примеры40 Примеры

41</h2>41</h2>

42 42 

43Перед запуском этих примеров установите Claude Agent SDK, следуя [краткому руководству](/ru/agent-sdk/quickstart).43Перед запуском этих примеров установите Claude Agent SDK, следуя [краткому руководству](/docs/ru/agent-sdk/quickstart).

44 44 

45Каждый пример выполняется до завершения агентом и выдачи его финального сообщения результата. Если сеанс сначала достигает лимита ходов, то сообщение результата имеет подтип `error_max_turns`. Проверьте `subtype`, чтобы обнаружить это завершение.45Каждый пример выполняется до завершения агентом и выдачи его финального сообщения результата. Если сеанс сначала достигает лимита ходов, то сообщение результата имеет подтип `error_max_turns`. Проверьте `subtype`, чтобы обнаружить это завершение.

46 46 

47Эти примеры используют однократные вызовы `query()`. После выдачи результата `error_max_turns`, `query()` выбрасывает ошибку, которая включает `Reached maximum number of turns`. Каждый пример оборачивает свой цикл в блок try для чистого выхода при возникновении этого события.47Эти примеры используют однократные вызовы `query()`. После выдачи результата `error_max_turns`, `query()` выбрасывает ошибку, которая включает `Reached maximum number of turns`. Каждый пример оборачивает свой цикл в блок try для чистого выхода при возникновении этого события.

48 48 

49См. [Обработка результата](/ru/agent-sdk/agent-loop#handle-the-result) для получения информации о подтипах результатов.49См. [Обработка результата](/docs/ru/agent-sdk/agent-loop#handle-the-result) для получения информации о подтипах результатов.

50 50 

51<h3 id="monitoring-todo-changes">51<h3 id="monitoring-todo-changes">

52 Мониторинг изменений задач52 Мониторинг изменений задач


253 Миграция на инструменты Task253 Миграция на инструменты Task

254</h2>254</h2>

255 255 

256Инструменты Task разделяют единый вызов `TodoWrite` на `TaskCreate` для каждого нового элемента и `TaskUpdate` для каждого изменения статуса, с `TaskList` и `TaskGet`, доступными для модели для чтения текущего списка. Ваш код мониторинга по-прежнему проверяет блоки `tool_use` в потоке помощника, но поддерживает карту, индексированную по ID задачи, вместо замены всего списка при каждом вызове. {/* min-version: 2.1.142 */}Инструменты Task являются стандартными начиная с TypeScript Agent SDK 0.3.142 и Claude Code v2.1.142, поэтому изменение `options.env` не требуется.256Инструменты Task разделяют единый вызов `TodoWrite` на `TaskCreate` для каждого нового элемента и `TaskUpdate` для каждого изменения статуса, с `TaskList` и `TaskGet`, доступными для модели для чтения текущего списка. Ваш код мониторинга по-прежнему проверяет блоки `tool_use` в потоке помощника, но поддерживает карту, индексированную по ID задачи, вместо замены всего списка при каждом вызове. Инструменты Task являются стандартными начиная с TypeScript Agent SDK 0.3.142 и Claude Code v2.1.142, поэтому изменение `options.env` не требуется.

257 257 

258| С `TodoWrite` | С инструментами Task |258| С `TodoWrite` | С инструментами Task |

259| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |259| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |


338 Связанная документация338 Связанная документация

339</h2>339</h2>

340 340 

341* [Справочник TypeScript SDK](/ru/agent-sdk/typescript)341* [Справочник TypeScript SDK](/docs/ru/agent-sdk/typescript)

342* [Справочник Python SDK](/ru/agent-sdk/python)342* [Справочник Python SDK](/docs/ru/agent-sdk/python)

343* [Потоковая передача в сравнении с одиночным режимом](/ru/agent-sdk/streaming-vs-single-mode)343* [Потоковая передача в сравнении с одиночным режимом](/docs/ru/agent-sdk/streaming-vs-single-mode)

344* [Пользовательские инструменты](/ru/agent-sdk/custom-tools)344* [Пользовательские инструменты](/docs/ru/agent-sdk/custom-tools)

Details

6 6 

7> Полный справочник API для TypeScript Agent SDK, включая все функции, типы и интерфейсы.7> Полный справочник API для TypeScript Agent SDK, включая все функции, типы и интерфейсы.

8 8 

9<script src="/components/typescript-sdk-type-links.js" defer />9<script src="/docs/components/typescript-sdk-type-links.js" defer />

10 10 

11<h2 id="installation">11<h2 id="installation">

12 Установка12 Установка


296</h4>296</h4>

297 297 

298| Свойство | Тип | Описание |298| Свойство | Тип | Описание |

299| :------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |299| :------------------- | :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

300| `type` | `"user" \| "assistant"` | Роль сообщения |300| `type` | `"user" \| "assistant"` | Роль сообщения |

301| `uuid` | `string` | Уникальный идентификатор сообщения |301| `uuid` | `string` | Уникальный идентификатор сообщения |

302| `session_id` | `string` | Сессия, к которой принадлежит это сообщение |302| `session_id` | `string` | Сессия, к которой принадлежит это сообщение |

303| `message` | `unknown` | Необработанная полезная нагрузка сообщения из транскрипта |303| `message` | `unknown` | Необработанная полезная нагрузка сообщения из транскрипта |

304| `parent_tool_use_id` | `string \| null` | Для сообщений подагента, `tool_use_id` вызова tool `Agent`, который его запустил. `null` для сообщений основной сессии и более старых сессий |304| `parent_tool_use_id` | `string \| null` | Для сообщений подагента, `tool_use_id` вызова tool `Agent`, который его запустил. `null` для сообщений основной сессии и более старых сессий |

305| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного подагента](/ru/sub-agents#spawn-nested-subagents), `agentId` подагента, который его запустил. `null` для сообщений основной сессии, сообщений от подагентов верхнего уровня и более старых сессий. {/* min-version: 2.1.202 */}Требуется Claude Code v2.1.202 или позже |305| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного подагента](/docs/ru/sub-agents#spawn-nested-subagents), `agentId` подагента, который его запустил. `null` для сообщений основной сессии, сообщений от подагентов верхнего уровня и более старых сессий. Требуется Claude Code v2.1.202 или позже |

306 306 

307<h4 id="example-3">307<h4 id="example-3">

308 Пример308 Пример


423| :------------------------------ | :------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |423| :------------------------------ | :------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

424| `options.cwd` | `string` | `process.cwd()` | Директория для разрешения параметров проекта и локальных параметров относительно |424| `options.cwd` | `string` | `process.cwd()` | Директория для разрешения параметров проекта и локальных параметров относительно |

425| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Все источники | Какие источники файловой системы загружать. Передайте `[]` для пропуска пользовательских, проектных и локальных параметров. Параметры управляемой политики загружаются во всех случаях. Параметры, управляемые сервером, берутся из `serverManagedSettings`, когда хост их передаёт, или читаются из кэша CLI на диске в противном случае; снимок не загружает их из сети |425| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | Все источники | Какие источники файловой системы загружать. Передайте `[]` для пропуска пользовательских, проектных и локальных параметров. Параметры управляемой политики загружаются во всех случаях. Параметры, управляемые сервером, берутся из `serverManagedSettings`, когда хост их передаёт, или читаются из кэша CLI на диске в противном случае; снимок не загружает их из сети |

426| `options.managedSettings` | `Settings` | `undefined` | Ограничивающие параметры уровня политики, предоставленные хостом встраивания. Отбрасываются по умолчанию, когда присутствует развёрнутый администратором управляемый уровень; объединяются под этим уровнем, когда [`parentSettingsBehavior`](/ru/settings#available-settings) равен `"merge"`. Неограничивающие ключи, такие как `model`, молча отбрасываются, поэтому этот параметр может усилить управляемую политику, но не ослабить её |426| `options.managedSettings` | `Settings` | `undefined` | Ограничивающие параметры уровня политики, предоставленные хостом встраивания. Отбрасываются по умолчанию, когда присутствует развёрнутый администратором управляемый уровень; объединяются под этим уровнем, когда [`parentSettingsBehavior`](/docs/ru/settings#available-settings) равен `"merge"`. Неограничивающие ключи, такие как `model`, молча отбрасываются, поэтому этот параметр может усилить управляемую политику, но не ослабить её |

427| `options.serverManagedSettings` | `Settings` | `undefined` | Полезная нагрузка параметров, управляемых сервером, из `/api/claude_code/settings`. Неограничивающие ключи проходят без фильтрации |427| `options.serverManagedSettings` | `Settings` | `undefined` | Полезная нагрузка параметров, управляемых сервером, из `/api/claude_code/settings`. Неограничивающие ключи проходят без фильтрации |

428 428 

429<h4 id="return-type-resolvedsettings">429<h4 id="return-type-resolvedsettings">


474| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | Программно определите подагентов |474| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | Программно определите подагентов |

475| `agentProgressSummaries` | `boolean` | `false` | Когда `true`, генерируйте однострочные сводки прогресса для подагентов и пересылайте их на события [`task_progress`](#sdktaskprogressmessage) через поле `summary`. Применяется к подагентам переднего плана и фонового режима |475| `agentProgressSummaries` | `boolean` | `false` | Когда `true`, генерируйте однострочные сводки прогресса для подагентов и пересылайте их на события [`task_progress`](#sdktaskprogressmessage) через поле `summary`. Применяется к подагентам переднего плана и фонового режима |

476| `allowDangerouslySkipPermissions` | `boolean` | `false` | Включите обход разрешений. Требуется при использовании `permissionMode: 'bypassPermissions'` |476| `allowDangerouslySkipPermissions` | `boolean` | `false` | Включите обход разрешений. Требуется при использовании `permissionMode: 'bypassPermissions'` |

477| `allowedTools` | `string[]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неперечисленные инструменты переходят к `permissionMode` и `canUseTool`. Используйте `disallowedTools` для блокировки инструментов. См. [Разрешения](/ru/agent-sdk/permissions#allow-and-deny-rules) |477| `allowedTools` | `string[]` | `[]` | Инструменты для автоматического одобрения без запроса. Это не ограничивает Claude только этими инструментами; неперечисленные инструменты переходят к `permissionMode` и `canUseTool`. Используйте `disallowedTools` для блокировки инструментов. См. [Разрешения](/docs/ru/agent-sdk/permissions#allow-and-deny-rules) |

478| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | Включите бета-функции |478| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | Включите бета-функции |

479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Пользовательская функция разрешения, вызываемая только когда [поток разрешения](/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к запросу. Не вызывается для вызовов, автоматически одобренных `allowedTools`, правилами разрешения или `permissionMode`. `AskUserQuestion`, инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), достигают её даже если вы их разрешили; в режиме `dontAsk` они вместо этого отклоняются. См. [`CanUseTool`](#canusetool) для деталей |479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | Пользовательская функция разрешения, вызываемая только когда [поток разрешения](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) переходит к запросу. Не вызывается для вызовов, автоматически одобренных `allowedTools`, правилами разрешения или `permissionMode`. `AskUserQuestion`, инструменты соединителя [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), достигают её даже если вы их разрешили; в режиме `dontAsk` они вместо этого отклоняются. См. [`CanUseTool`](#canusetool) для деталей |

480| `continue` | `boolean` | `false` | Продолжите самый последний диалог |480| `continue` | `boolean` | `false` | Продолжите самый последний диалог |

481| `cwd` | `string` | `process.cwd()` | Текущая рабочая директория |481| `cwd` | `string` | `process.cwd()` | Текущая рабочая директория |

482| `debug` | `boolean` | `false` | Включите режим отладки для процесса Claude Code |482| `debug` | `boolean` | `false` | Включите режим отладки для процесса Claude Code |

483| `debugFile` | `string` | `undefined` | Запишите журналы отладки в определённый путь файла. Неявно включает режим отладки |483| `debugFile` | `string` | `undefined` | Запишите журналы отладки в определённый путь файла. Неявно включает режим отладки |

484| `disallowedTools` | `string[]` | `[]` | Инструменты для отклонения. Простое имя, такое как `"Bash"`, удаляет инструмент из контекста Claude. Правило с областью видимости, такое как `"Bash(rm *)"`, оставляет инструмент доступным и отклоняет совпадающие вызовы в каждом режиме разрешения, включая `bypassPermissions`. См. [Разрешения](/ru/agent-sdk/permissions#allow-and-deny-rules) |484| `disallowedTools` | `string[]` | `[]` | Инструменты для отклонения. Простое имя, такое как `"Bash"`, удаляет инструмент из контекста Claude. Правило с областью видимости, такое как `"Bash(rm *)"`, оставляет инструмент доступным и отклоняет совпадающие вызовы в каждом режиме разрешения, включая `bypassPermissions`. См. [Разрешения](/docs/ru/agent-sdk/permissions#allow-and-deny-rules) |

485| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | По умолчанию модели | Контролирует, сколько усилий Claude вкладывает в свой ответ. Работает с адаптивным мышлением для направления глубины мышления. См. [adjust the effort level](/ru/model-config#adjust-effort-level) |485| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | По умолчанию модели | Контролирует, сколько усилий Claude вкладывает в свой ответ. Работает с адаптивным мышлением для направления глубины мышления. См. [adjust the effort level](/docs/ru/model-config#adjust-effort-level) |

486| `enableFileCheckpointing` | `boolean` | `false` | Включите отслеживание изменений файлов для перемотки. См. [File checkpointing](/ru/agent-sdk/file-checkpointing) |486| `enableFileCheckpointing` | `boolean` | `false` | Включите отслеживание изменений файлов для перемотки. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |

487| `env` | `Record<string, string \| undefined>` | `process.env` | Переменные окружения. Когда установлено, это заменяет окружение подпроцесса вместо объединения с `process.env`, поэтому передайте `{ ...process.env, YOUR_VAR: 'value' }` для сохранения унаследованных переменных, таких как `PATH`. См. [Handle slow or stalled API responses](#handle-slow-or-stalled-api-responses) для примера этого паттерна и [Environment variables](/ru/env-vars) для переменных, которые читает базовый CLI. Установите `CLAUDE_AGENT_SDK_CLIENT_APP` для идентификации вашего приложения в заголовке User-Agent |487| `env` | `Record<string, string \| undefined>` | `process.env` | Переменные окружения. Когда установлено, это заменяет окружение подпроцесса вместо объединения с `process.env`, поэтому передайте `{ ...process.env, YOUR_VAR: 'value' }` для сохранения унаследованных переменных, таких как `PATH`. См. [Handle slow or stalled API responses](#handle-slow-or-stalled-api-responses) для примера этого паттерна и [Environment variables](/docs/ru/env-vars) для переменных, которые читает базовый CLI. Установите `CLAUDE_AGENT_SDK_CLIENT_APP` для идентификации вашего приложения в заголовке User-Agent |

488| `executable` | `'bun' \| 'deno' \| 'node'` | Автоопределение | Среда выполнения JavaScript для использования |488| `executable` | `'bun' \| 'deno' \| 'node'` | Автоопределение | Среда выполнения JavaScript для использования |

489| `executableArgs` | `string[]` | `[]` | Аргументы для передачи исполняемому файлу |489| `executableArgs` | `string[]` | `[]` | Аргументы для передачи исполняемому файлу |

490| `extraArgs` | `Record<string, string \| null>` | `{}` | Дополнительные аргументы |490| `extraArgs` | `Record<string, string \| null>` | `{}` | Дополнительные аргументы |


496| `includePartialMessages` | `boolean` | `false` | Включите события частичных сообщений |496| `includePartialMessages` | `boolean` | `false` | Включите события частичных сообщений |

497| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Timeout в миллисекундах для каждого вызова `sessionStore.load()` и `sessionStore.listSubkeys()` во время материализации возобновления. Если адаптер не завершится в этом окне, запрос не удаётся вместо зависания. Игнорируется, когда `sessionStore` не установлен |497| `loadTimeoutMs` | `number` | `60000` | *Alpha.* Timeout в миллисекундах для каждого вызова `sessionStore.load()` и `sessionStore.listSubkeys()` во время материализации возобновления. Если адаптер не завершится в этом окне, запрос не удаётся вместо зависания. Игнорируется, когда `sessionStore` не установлен |

498| `managedSettings` | `Settings` | `undefined` | Настройки уровня политики, предоставленные порождающим родительским процессом. Отбрасываются, когда уровень управляемых настроек, контролируемый IT, уже существует на машине, если только этот администратор не согласится с `parentSettingsBehavior: 'merge'`. Отфильтрованы только для ключей, ограничивающих доступ, независимо |498| `managedSettings` | `Settings` | `undefined` | Настройки уровня политики, предоставленные порождающим родительским процессом. Отбрасываются, когда уровень управляемых настроек, контролируемый IT, уже существует на машине, если только этот администратор не согласится с `parentSettingsBehavior: 'merge'`. Отфильтрованы только для ключей, ограничивающих доступ, независимо |

499| `maxBudgetUsd` | `number` | `undefined` | Остановите запрос, когда оценка стоимости на стороне клиента достигнет этого значения USD. Сравнивается с той же оценкой, что и `total_cost_usd`; см. [Track cost and usage](/ru/agent-sdk/cost-tracking) для предостережений точности |499| `maxBudgetUsd` | `number` | `undefined` | Остановите запрос, когда оценка стоимости на стороне клиента достигнет этого значения USD. Сравнивается с той же оценкой, что и `total_cost_usd`; см. [Track cost and usage](/docs/ru/agent-sdk/cost-tracking) для предостережений точности |

500| `maxThinkingTokens` | `number` | `undefined` | *Устарело:* Используйте вместо этого `thinking`. Максимальные токены для процесса мышления |500| `maxThinkingTokens` | `number` | `undefined` | *Устарело:* Используйте вместо этого `thinking`. Максимальные токены для процесса мышления |

501| `maxTurns` | `number` | `undefined` | Максимальное количество агентских ходов (раунды использования инструмента) |501| `maxTurns` | `number` | `undefined` | Максимальное количество агентских ходов (раунды использования инструмента) |

502| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Конфигурации MCP серверов |502| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | Конфигурации MCP серверов |

503| `model` | `string` | По умолчанию из CLI | Псевдоним модели Claude или полное имя модели. См. [accepted values and provider-specific IDs](/ru/model-config#available-models) |503| `model` | `string` | По умолчанию из CLI | Псевдоним модели Claude или полное имя модели. См. [accepted values and provider-specific IDs](/docs/ru/model-config#available-models) |

504| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Обратный вызов для обработки запросов MCP elicitation. Вызывается, когда MCP сервер запрашивает ввод пользователя и ни один hook не обрабатывает его первым. Если не предоставлено, необработанные запросы elicitation автоматически отклоняются |504| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | Обратный вызов для обработки запросов MCP elicitation. Вызывается, когда MCP сервер запрашивает ввод пользователя и ни один hook не обрабатывает его первым. Если не предоставлено, необработанные запросы elicitation автоматически отклоняются |

505| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Определите формат вывода для результатов агента. См. [Structured outputs](/ru/agent-sdk/structured-outputs) для деталей |505| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | Определите формат вывода для результатов агента. См. [Structured outputs](/docs/ru/agent-sdk/structured-outputs) для деталей |

506| `outputStyle` | `string` | `undefined` | Не поле `Options`. Установите `outputStyle` во встроенном объекте [`settings`](/ru/settings) или файле настроек вместо этого. См. [Activate an output style](/ru/agent-sdk/modifying-system-prompts#activate-an-output-style) |506| `outputStyle` | `string` | `undefined` | Не поле `Options`. Установите `outputStyle` во встроенном объекте [`settings`](/docs/ru/settings) или файле настроек вместо этого. См. [Activate an output style](/docs/ru/agent-sdk/modifying-system-prompts#activate-an-output-style) |

507| `pathToClaudeCodeExecutable` | `string` | Автоопределение из встроенного нативного бинарного файла | Путь к исполняемому файлу Claude Code. Требуется только если опциональные зависимости были пропущены при установке или ваша платформа не в поддерживаемом наборе |507| `pathToClaudeCodeExecutable` | `string` | Автоопределение из встроенного нативного бинарного файла | Путь к исполняемому файлу Claude Code. Требуется только если опциональные зависимости были пропущены при установке или ваша платформа не в поддерживаемом наборе |

508| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | Режим разрешения для сессии |508| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | Режим разрешения для сессии |

509| `permissionPromptToolName` | `string` | `undefined` | Имя MCP инструмента для запросов разрешения |509| `permissionPromptToolName` | `string` | `undefined` | Имя MCP инструмента для запросов разрешения |

510| `persistSession` | `boolean` | `true` | Когда `false`, отключает сохранение сессии на диск. Сессии не могут быть возобновлены позже |510| `persistSession` | `boolean` | `true` | Когда `false`, отключает сохранение сессии на диск. Сессии не могут быть возобновлены позже |

511| `planModeInstructions` | `string` | `undefined` | Пользовательские инструкции рабочего процесса для Plan Mode. Когда `permissionMode` это `'plan'`, эта строка заменяет тело рабочего процесса режима плана по умолчанию. CLI по-прежнему оборачивает его с преамбулой принудительного соблюдения только для чтения и нижним колонтитулом протокола ExitPlanMode |511| `planModeInstructions` | `string` | `undefined` | Пользовательские инструкции рабочего процесса для Plan Mode. Когда `permissionMode` это `'plan'`, эта строка заменяет тело рабочего процесса режима плана по умолчанию. CLI по-прежнему оборачивает его с преамбулой принудительного соблюдения только для чтения и нижним колонтитулом протокола ExitPlanMode |

512| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | Загружайте пользовательские plugins из локальных путей. См. [Plugins](/ru/agent-sdk/plugins) для деталей |512| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | Загружайте пользовательские plugins из локальных путей. См. [Plugins](/docs/ru/agent-sdk/plugins) для деталей |

513| `promptSuggestions` | `boolean` | `false` | Включите предложения запросов. Выдаёт сообщение `prompt_suggestion` после каждого хода с предсказанным следующим пользовательским запросом |513| `promptSuggestions` | `boolean` | `false` | Включите предложения запросов. Выдаёт сообщение `prompt_suggestion` после каждого хода с предсказанным следующим пользовательским запросом |

514| `resume` | `string` | `undefined` | ID сессии для возобновления |514| `resume` | `string` | `undefined` | ID сессии для возобновления |

515| `resumeSessionAt` | `string` | `undefined` | Возобновите сессию в определённом UUID сообщения |515| `resumeSessionAt` | `string` | `undefined` | Возобновите сессию в определённом UUID сообщения |

516| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | Программно настройте поведение sandbox. См. [Sandbox settings](#sandboxsettings) для деталей |516| `sandbox` | [`SandboxSettings`](#sandboxsettings) | `undefined` | Программно настройте поведение sandbox. См. [Sandbox settings](#sandboxsettings) для деталей |

517| `sessionId` | `string` | Автогенерируемый | Используйте определённый UUID для сессии вместо автогенерирования |517| `sessionId` | `string` | Автогенерируемый | Используйте определённый UUID для сессии вместо автогенерирования |

518| `sessionStore` | [`SessionStore`](/ru/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Зеркалируйте транскрипты сессий на внешний бэкенд, чтобы любой хост мог их возобновить. См. [Persist sessions to external storage](/ru/agent-sdk/session-storage) |518| `sessionStore` | [`SessionStore`](/docs/ru/agent-sdk/session-storage#the-sessionstore-interface) | `undefined` | Зеркалируйте транскрипты сессий на внешний бэкенд, чтобы любой хост мог их возобновить. См. [Persist sessions to external storage](/docs/ru/agent-sdk/session-storage) |

519| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha.* Режим flush для `sessionStore`. Игнорируется, когда `sessionStore` не установлен |519| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *Alpha.* Режим flush для `sessionStore`. Игнорируется, когда `sessionStore` не установлен |

520| `settings` | `string \| Settings` | `undefined` | Встроенный объект [settings](/ru/settings) или путь к файлу настроек. Заполняет слой flag-settings в [порядке приоритета](/ru/settings#settings-precedence). Измените во время выполнения с помощью [`applyFlagSettings()`](#applyflagsettings) |520| `settings` | `string \| Settings` | `undefined` | Встроенный объект [settings](/docs/ru/settings) или путь к файлу настроек. Заполняет слой flag-settings в [порядке приоритета](/docs/ru/settings#settings-precedence). Измените во время выполнения с помощью [`applyFlagSettings()`](#applyflagsettings) |

521| `settingSources` | [`SettingSource`](#settingsource)`[]` | Значения по умолчанию CLI (все источники) | Контролируйте, какие настройки файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных настроек. Управляемые политикой настройки загружаются независимо; серверные управляемые настройки загружаются, когда сессия аутентифицируется с учётными данными организации на [подходящей конфигурации](/ru/server-managed-settings#platform-availability). См. [Use Claude Code features](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) |521| `settingSources` | [`SettingSource`](#settingsource)`[]` | Значения по умолчанию CLI (все источники) | Контролируйте, какие настройки файловой системы загружать. Передайте `[]` для отключения пользовательских, проектных и локальных настроек. Управляемые политикой настройки загружаются независимо; серверные управляемые настройки загружаются, когда сессия аутентифицируется с учётными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). См. [Use Claude Code features](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) |

522| `skills` | `string[] \| 'all'` | `undefined` | Skills доступные для сессии. Передайте `'all'` для включения каждого обнаруженного skill, или список имён skills. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowedTools`. Если вы также передаёте `tools`, включите `'Skill'` в этот список. См. [Skills](/ru/agent-sdk/skills) |522| `skills` | `string[] \| 'all'` | `undefined` | Skills доступные для сессии. Передайте `'all'` для включения каждого обнаруженного skill, или список имён skills. Когда установлено, SDK автоматически добавляет инструмент Skill в `allowedTools`. Если вы также передаёте `tools`, включите `'Skill'` в этот список. См. [Skills](/docs/ru/agent-sdk/skills) |

523| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Пользовательская функция для запуска процесса Claude Code. Используйте для запуска Claude Code на ВМ, контейнерах или удалённых окружениях |523| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Пользовательская функция для запуска процесса Claude Code. Используйте для запуска Claude Code на ВМ, контейнерах или удалённых окружениях |

524| `stderr` | `(data: string) => void` | `undefined` | Обратный вызов для вывода stderr |524| `stderr` | `(data: string) => void` | `undefined` | Обратный вызов для вывода stderr |

525| `strictMcpConfig` | `boolean` | `false` | Используйте только серверы, переданные в `mcpServers`, и игнорируйте проект `.mcp.json`, пользовательские настройки, MCP серверы, предоставленные plugins, и [claude.ai connectors](/ru/mcp#use-mcp-servers-from-claude-ai) |525| `strictMcpConfig` | `boolean` | `false` | Используйте только серверы, переданные в `mcpServers`, и игнорируйте проект `.mcp.json`, пользовательские настройки, MCP серверы, предоставленные plugins, и [claude.ai connectors](/docs/ru/mcp#use-mcp-servers-from-claude-ai) |

526| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (минимальный запрос) | Конфигурация системного запроса. Передайте строку для пользовательского запроса или `{ type: 'preset', preset: 'claude_code' }` для использования системного запроса Claude Code. При использовании формы объекта preset добавьте `append` для расширения его дополнительными инструкциями и установите `excludeDynamicSections: true` для перемещения контекста для каждой сессии в первое пользовательское сообщение для [лучшего переиспользования prompt caching на разных машинах](/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |526| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (минимальный запрос) | Конфигурация системного запроса. Передайте строку для пользовательского запроса или `{ type: 'preset', preset: 'claude_code' }` для использования системного запроса Claude Code. При использовании формы объекта preset добавьте `append` для расширения его дополнительными инструкциями и установите `excludeDynamicSections: true` для перемещения контекста для каждой сессии в первое пользовательское сообщение для [лучшего переиспользования prompt caching на разных машинах](/docs/ru/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

527| `taskBudget` | `{ total: number }` | `undefined` | *Alpha.* Бюджет задачи на стороне API в токенах. Когда установлено, модели сообщается её оставшийся бюджет токенов, чтобы она могла регулировать использование инструмента и завершить работу до лимита |527| `taskBudget` | `{ total: number }` | `undefined` | *Alpha.* Бюджет задачи на стороне API в токенах. Когда установлено, модели сообщается её оставшийся бюджет токенов, чтобы она могла регулировать использование инструмента и завершить работу до лимита |

528| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` для поддерживаемых моделей | Контролирует поведение мышления/рассуждения Claude. См. [`ThinkingConfig`](#thinkingconfig) для опций |528| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` для поддерживаемых моделей | Контролирует поведение мышления/рассуждения Claude. См. [`ThinkingConfig`](#thinkingconfig) для опций |

529| `title` | `string` | `undefined` | Отображаемое название для сессии. При возобновлении через `resume` или `continue`, сохранённое название возобновляемой сессии имеет приоритет; используйте [`renameSession()`](#renamesession) для переименования существующей сессии |529| `title` | `string` | `undefined` | Отображаемое название для сессии. При возобновлении через `resume` или `continue`, сохранённое название возобновляемой сессии имеет приоритет; используйте [`renameSession()`](#renamesession) для переименования существующей сессии |


552```552```

553 553 

554* `API_TIMEOUT_MS`: timeout для каждого запроса на клиенте Anthropic, в миллисекундах. По умолчанию `600000`. Применяется к основному циклу и всем подагентам.554* `API_TIMEOUT_MS`: timeout для каждого запроса на клиенте Anthropic, в миллисекундах. По умолчанию `600000`. Применяется к основному циклу и всем подагентам.

555* `CLAUDE_CODE_MAX_RETRIES`: максимальное количество повторных попыток API. По умолчанию `10`, ограничено `15`. Каждая повторная попытка получает своё собственное окно `API_TIMEOUT_MS`, поэтому наихудший случай wall time примерно `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` плюс backoff. Для автоматических запусков, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG=1`: он повторяет ошибки ёмкости бесконечно, и {/* min-version: 2.1.199 */}начиная с Claude Code v2.1.199 повышает значение по умолчанию для других переходящих ошибок до `300` и удаляет ограничение на эту переменную.555* `CLAUDE_CODE_MAX_RETRIES`: максимальное количество повторных попыток API. По умолчанию `10`, ограничено `15`. Каждая повторная попытка получает своё собственное окно `API_TIMEOUT_MS`, поэтому наихудший случай wall time примерно `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` плюс backoff. Для автоматических запусков, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG=1`: он повторяет ошибки ёмкости бесконечно, и начиная с Claude Code v2.1.199 повышает значение по умолчанию для других переходящих ошибок до `300` и удаляет ограничение на эту переменную.

556* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog зависания для подагентов, запущенных с `run_in_background`. По умолчанию `600000`. Сбрасывается при каждом событии потока; при зависании прерывает подагента, отмечает задачу как неудачную и выводит ошибку родителю с любым частичным результатом. Не применяется к синхронным подагентам.556* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog зависания для подагентов, запущенных с `run_in_background`. По умолчанию `600000`. Сбрасывается при каждом событии потока; при зависании прерывает подагента, отмечает задачу как неудачную и выводит ошибку родителю с любым частичным результатом. Не применяется к синхронным подагентам.

557* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: прерывает запрос, когда заголовки получены, но тело ответа перестаёт потоком передаваться. Watchdog включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается до этого минимума. Прерванный запрос проходит через обычный путь повторной попытки.557* `CLAUDE_ENABLE_STREAM_WATCHDOG` с `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: прерывает запрос, когда заголовки получены, но тело ответа перестаёт потоком передаваться. Watchdog включен по умолчанию для всех поставщиков; установите `CLAUDE_ENABLE_STREAM_WATCHDOG=0` для отключения. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` по умолчанию `300000` и зажимается до этого минимума. Прерванный запрос проходит через обычный путь повторной попытки.

558 558 


594</h4>594</h4>

595 595 

596| Метод | Описание |596| Метод | Описание |

597| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |597| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

598| `interrupt()` | Прерывает запрос. Доступно только в режиме потока входных данных. {/* min-version: 2.1.205 */}Когда CLI объявляет возможность `interrupt_receipt_v1` в [`SDKSystemMessage.capabilities`](#sdksystemmessage), разрешается с помощью [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse), в котором перечислены поставленные в очередь сообщения, которые пережили прерывание. Разрешается `undefined` на CLI до v2.1.205 |598| `interrupt()` | Прерывает запрос. Доступно только в режиме потока входных данных. Когда CLI объявляет возможность `interrupt_receipt_v1` в [`SDKSystemMessage.capabilities`](#sdksystemmessage), разрешается с помощью [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse), в котором перечислены поставленные в очередь сообщения, которые пережили прерывание. Разрешается `undefined` на CLI до v2.1.205 |

599| `rewindFiles(userMessageId, options?)` | Восстанавливает файлы в их состояние в указанном пользовательском сообщении. Передайте `{ dryRun: true }` для предпросмотра изменений. Требует `enableFileCheckpointing: true`. См. [File checkpointing](/ru/agent-sdk/file-checkpointing) |599| `rewindFiles(userMessageId, options?)` | Восстанавливает файлы в их состояние в указанном пользовательском сообщении. Передайте `{ dryRun: true }` для предпросмотра изменений. Требует `enableFileCheckpointing: true`. См. [File checkpointing](/docs/ru/agent-sdk/file-checkpointing) |

600| `setPermissionMode()` | Изменяет режим разрешения (доступно только в режиме потока входных данных) |600| `setPermissionMode()` | Изменяет режим разрешения (доступно только в режиме потока входных данных) |

601| `setModel()` | Изменяет модель (доступно только в режиме потока входных данных) |601| `setModel()` | Изменяет модель (доступно только в режиме потока входных данных) |

602| `setMaxThinkingTokens()` | *Устарело:* Используйте вместо этого опцию `thinking`. Изменяет максимальные токены мышления. Передача `null` сбрасывает мышление к значению по умолчанию сессии: переопределение в середине сессии очищается, и мышление остаётся отключённым для сессий, у которых оно отключено |602| `setMaxThinkingTokens()` | *Устарело:* Используйте вместо этого опцию `thinking`. Изменяет максимальные токены мышления. Передача `null` сбрасывает мышление к значению по умолчанию сессии: переопределение в середине сессии очищается, и мышление остаётся отключённым для сессий, у которых оно отключено |

603| `applyFlagSettings(settings)` | Объединяет настройки в слой flag settings сессии во время выполнения (доступно только в режиме потока входных данных). См. [`applyFlagSettings()`](#applyflagsettings) |603| `applyFlagSettings(settings)` | Объединяет настройки в слой flag settings сессии во время выполнения (доступно только в режиме потока входных данных). См. [`applyFlagSettings()`](#applyflagsettings) |

604| `initializationResult()` | Возвращает полный результат инициализации, включая поддерживаемые команды, модели, информацию об учётной записи и конфигурацию стиля вывода |604| `initializationResult()` | Возвращает полный результат инициализации, включая поддерживаемые команды, модели, информацию об учётной записи и конфигурацию стиля вывода |

605| `reinitialize()` | {/* min-version: 2.1.195 */}Повторно отправляет запрос управления `initialize` работающему CLI и возвращает свежий результат вместо кэшированного результата первого подключения. Используйте его после разрыва транспорта, такого как переподключение к сессии после отключения, чтобы ожидающие запросы разрешения снова достигли вашего обратного вызова `canUseTool`. Сделайте обратный вызов идемпотентным для каждого ID запроса, потому что запрос, чей ответ был потерян, отправляется снова. Требует Claude Code v2.1.195 или позже |605| `reinitialize()` | Повторно отправляет запрос управления `initialize` работающему CLI и возвращает свежий результат вместо кэшированного результата первого подключения. Используйте его после разрыва транспорта, такого как переподключение к сессии после отключения, чтобы ожидающие запросы разрешения снова достигли вашего обратного вызова `canUseTool`. Сделайте обратный вызов идемпотентным для каждого ID запроса, потому что запрос, чей ответ был потерян, отправляется снова. Требует Claude Code v2.1.195 или позже |

606| `supportedCommands()` | Возвращает доступные slash commands |606| `supportedCommands()` | Возвращает доступные slash commands |

607| `supportedModels()` | Возвращает доступные модели с информацией отображения |607| `supportedModels()` | Возвращает доступные модели с информацией отображения |

608| `supportedAgents()` | Возвращает доступные подагентов как [`AgentInfo`](#agentinfo)`[]` |608| `supportedAgents()` | Возвращает доступные подагентов как [`AgentInfo`](#agentinfo)`[]` |


619 `applyFlagSettings()`619 `applyFlagSettings()`

620</h4>620</h4>

621 621 

622Изменяет [настройки](/ru/settings) на работающей сессии без перезагрузки запроса. Используйте её, когда настройка, у которой нет выделенного setter, должна измениться в середине сессии, например, ужесточение `permissions` после того, как агент прочитает ненадёжный ввод. `setModel()` и `setPermissionMode()` являются выделенными setters для этих двух ключей; `applyFlagSettings()` является общей формой, которая принимает любое подмножество ключей настроек, и передача `model` здесь ведёт себя так же, как `setModel()`.622Изменяет [настройки](/docs/ru/settings) на работающей сессии без перезагрузки запроса. Используйте её, когда настройка, у которой нет выделенного setter, должна измениться в середине сессии, например, ужесточение `permissions` после того, как агент прочитает ненадёжный ввод. `setModel()` и `setPermissionMode()` являются выделенными setters для этих двух ключей; `applyFlagSettings()` является общей формой, которая принимает любое подмножество ключей настроек, и передача `model` здесь ведёт себя так же, как `setModel()`.

623 623 

624Только некоторые ключи вступают в силу в середине сессии:624Только некоторые ключи вступают в силу в середине сессии:

625 625 

626* **Применяется на следующем ходу**: `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `agent`. Переключение `agent` также применяет переопределение модели этого агента, hooks и системный запрос на следующем ходу.626* **Применяется на следующем ходу**: `model`, `effortLevel`, `ultracode`, `permissions`, `hooks`, `skillOverrides`, `fastMode`, `agent`. Переключение `agent` также применяет переопределение модели этого агента, hooks и системный запрос на следующем ходу.

627* **Нет эффекта в середине сессии**: опции системного запроса. Они разрешаются один раз при запуске, поэтому работающая сессия сохраняет исходное значение, даже если вызов успешен. Чтобы их изменить, запустите новую сессию.627* **Нет эффекта в середине сессии**: опции системного запроса. Они разрешаются один раз при запуске, поэтому работающая сессия сохраняет исходное значение, даже если вызов успешен. Чтобы их изменить, запустите новую сессию.

628 628 

629`effortLevel` принимает имя [уровня усилий](/ru/model-config#adjust-effort-level). Он также принимает `"ultracode"`, который запускает сессию на уровне усилий `xhigh` и включает [ultracode](/ru/workflows#let-claude-decide-with-ultracode). Тип `Settings` объявляет `effortLevel` без этого значения, поэтому передайте эквивалент `{ ultracode: true }` в TypeScript. {/* min-version: 2.1.203 */}Значение `ultracode` требует Claude Code v2.1.203 или позже и принимается только `applyFlagSettings()`, а не ключом `effortLevel` в файле настроек.629`effortLevel` принимает имя [уровня усилий](/docs/ru/model-config#adjust-effort-level). Он также принимает `"ultracode"`, который запускает сессию на уровне усилий `xhigh` и включает [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode). Тип `Settings` объявляет `effortLevel` без этого значения, поэтому передайте эквивалент `{ ultracode: true }` в TypeScript. Значение `ultracode` требует Claude Code v2.1.203 или позже и принимается только `applyFlagSettings()`, а не ключом `effortLevel` в файле настроек.

630 630 

631Значения записываются в слой flag-settings, тот же слой, который встроенная опция `settings` функции `query()` заполняет при запуске. Flag settings находятся рядом с верхней частью [порядка приоритета настроек](/ru/settings#settings-precedence): они переопределяют пользовательские, проектные и локальные настройки, и только управляемые политикой настройки могут их переопределить. Это тот же уровень, который [раздел приоритета на странице](#settings-precedence) называет программными опциями.631Значения записываются в слой flag-settings, тот же слой, который встроенная опция `settings` функции `query()` заполняет при запуске. Flag settings находятся рядом с верхней частью [порядка приоритета настроек](/docs/ru/settings#settings-precedence): они переопределяют пользовательские, проектные и локальные настройки, и только управляемые политикой настройки могут их переопределить. Это тот же уровень, который [раздел приоритета на странице](#settings-precedence) называет программными опциями.

632 632 

633Последовательные вызовы выполняют shallow-merge ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не выполняет deep-merge в него. Чтобы очистить ключ из слоя flag и вернуться к источникам с более низким приоритетом, передайте `null` для этого ключа. Передача `undefined` не имеет эффекта, потому что сериализация JSON её отбрасывает.633Последовательные вызовы выполняют shallow-merge ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не выполняет deep-merge в него. Чтобы очистить ключ из слоя flag и вернуться к источникам с более низким приоритетом, передайте `null` для этого ключа. Передача `undefined` не имеет эффекта, потому что сериализация JSON её отбрасывает.

634 634 


714 714 

715* Только сообщения, которые были поставлены в очередь с UUID, появляются. Пустой массив не означает, что ничего больше не будет работать.715* Только сообщения, которые были поставлены в очередь с UUID, появляются. Пустой массив не означает, что ничего больше не будет работать.

716* Только сообщения основного потока указаны. Сообщения, адресованные подагенту, выходят за рамки.716* Только сообщения основного потока указаны. Сообщения, адресованные подагенту, выходят за рамки.

717* Список может включать UUID, которые ваш клиент никогда не отправлял, такие как триггеры [scheduled task](/ru/scheduled-tasks). Игнорируйте UUID, которые вы не узнаёте, вместо того чтобы рассматривать их как ошибку.717* Список может включать UUID, которые ваш клиент никогда не отправлял, такие как триггеры [scheduled task](/docs/ru/scheduled-tasks). Игнорируйте UUID, которые вы не узнаёте, вместо того чтобы рассматривать их как ошибку.

718 718 

719Квитанция — это снимок, сделанный в момент обработки прерывания, и при чистом прерывании она прибывает до [`SDKResultMessage`](#sdkresultmessage) прерванного хода. Прочитайте квитанцию, а не проверяйте очередь после этого результата: цикл немедленно запускает следующий поставленный в очередь ход, поэтому очередь, которую вы проверяете после результата, уже изменилась.719Квитанция — это снимок, сделанный в момент обработки прерывания, и при чистом прерывании она прибывает до [`SDKResultMessage`](#sdkresultmessage) прерванного хода. Прочитайте квитанцию, а не проверяйте очередь после этого результата: цикл немедленно запускает следующий поставленный в очередь ход, поэтому очередь, которую вы проверяете после результата, уже изменилась.

720 720 


792 Default behavior792 Default behavior

793</h4>793</h4>

794 794 

795Когда `settingSources` опущено или `undefined`, `query()` загружает те же настройки файловой системы, что и CLI Claude Code: пользовательские, проектные и локальные. Управляемые политикой настройки загружаются во всех случаях; серверные управляемые настройки загружаются, когда сессия аутентифицируется с учётными данными организации на [подходящей конфигурации](/ru/server-managed-settings#platform-availability). См. [What settingSources does not control](/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входных данных, которые читаются независимо от этой опции, и как их отключить.795Когда `settingSources` опущено или `undefined`, `query()` загружает те же настройки файловой системы, что и CLI Claude Code: пользовательские, проектные и локальные. Управляемые политикой настройки загружаются во всех случаях; серверные управляемые настройки загружаются, когда сессия аутентифицируется с учётными данными организации на [подходящей конфигурации](/docs/ru/server-managed-settings#platform-availability). См. [What settingSources does not control](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) для входных данных, которые читаются независимо от этой опции, и как их отключить.

796 796 

797<h4 id="why-use-settingsources">797<h4 id="why-use-settingsources">

798 Why use settingSources798 Why use settingSources


913 913 

914Тип пользовательской функции разрешения для контроля использования инструмента.914Тип пользовательской функции разрешения для контроля использования инструмента.

915 915 

916Функция является заменой SDK для интерактивного запроса разрешения: она вызывается только когда [поток оценки разрешения](/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в запрос. Вызовы инструментов, уже одобренные записью `allowedTools`, правилом настроек разрешения или режимом разрешения, такие как `acceptEdits` или `bypassPermissions`, никогда её не вызывают. Чтобы контролировать каждый вызов инструмента, используйте вместо этого [hook `PreToolUse`](/ru/agent-sdk/hooks).916Функция является заменой SDK для интерактивного запроса разрешения: она вызывается только когда [поток оценки разрешения](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) разрешается в запрос. Вызовы инструментов, уже одобренные записью `allowedTools`, правилом настроек разрешения или режимом разрешения, такие как `acceptEdits` или `bypassPermissions`, никогда её не вызывают. Чтобы контролировать каждый вызов инструмента, используйте вместо этого [hook `PreToolUse`](/docs/ru/agent-sdk/hooks).

917 917 

918`AskUserQuestion`, инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool) и инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) достигают функции даже когда правило разрешения совпадает. В режиме `dontAsk` эти вызовы вместо этого отклоняются, без вызова её.918`AskUserQuestion`, инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool) и инструменты соединителя [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) достигают функции даже когда правило разрешения совпадает. В режиме `dontAsk` эти вызовы вместо этого отклоняются, без вызова её.

919 919 

920```typescript theme={null}920```typescript theme={null}

921type CanUseTool = (921type CanUseTool = (


985 985 

986| Поле | Тип | Описание |986| Поле | Тип | Описание |

987| :------------------------------ | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |987| :------------------------------ | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

988| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | Выбирает поле `preview` на опциях [`AskUserQuestion`](/ru/agent-sdk/user-input#question-format) и устанавливает его формат содержимого. Если не установлено, Claude не выдаёт предпросмотры |988| `askUserQuestion.previewFormat` | `'markdown' \| 'html'` | Выбирает поле `preview` на опциях [`AskUserQuestion`](/docs/ru/agent-sdk/user-input#question-format) и устанавливает его формат содержимого. Если не установлено, Claude не выдаёт предпросмотры |

989 989 

990<h3 id="mcpserverconfig">990<h3 id="mcpserverconfig">

991 `McpServerConfig`991 `McpServerConfig`


1091];1091];

1092```1092```

1093 1093 

1094Для полной информации о создании и использовании plugins см. [Plugins](/ru/agent-sdk/plugins).1094Для полной информации о создании и использовании plugins см. [Plugins](/docs/ru/agent-sdk/plugins).

1095 1095 

1096<h2 id="message-types">1096<h2 id="message-types">

1097 Типы сообщений1097 Типы сообщений


1210};1210};

1211```1211```

1212 1212 

1213Пользовательский ход, внедрённый извне сеанса, один, чьё [`origin`](#sdkmessageorigin) имеет вид `peer` или `channel`, достигает потока как повтор, был ли он доставлен во время активного хода или запустил новый ход, пока сеанс был неактивен. {/* min-version: 2.1.207 */}До v2.1.207 внедрённый ход, доставленный, пока сеанс был неактивен, не производил никакого сообщения в потоке и появлялся только при повторном чтении транскрипта.1213Пользовательский ход, внедрённый извне сеанса, один, чьё [`origin`](#sdkmessageorigin) имеет вид `peer` или `channel`, достигает потока как повтор, был ли он доставлен во время активного хода или запустил новый ход, пока сеанс был неактивен. До v2.1.207 внедрённый ход, доставленный, пока сеанс был неактивен, не производил никакого сообщения в потоке и появлялся только при повторном чтении транскрипта.

1214 1214 

1215<h3 id="sdkresultmessage">1215<h3 id="sdkresultmessage">

1216 `SDKResultMessage`1216 `SDKResultMessage`


1279 1279 

1280Поле `origin` передаёт [`SDKMessageOrigin`](#sdkmessageorigin) пользовательского сообщения, которое запустило этот результат. Когда фоновая задача завершается и SDK внедряет синтетический ход продолжения, результирующее `SDKResultMessage` содержит `origin: { kind: "task-notification" }`. Проверьте это поле, чтобы различить результаты, которые отвечают на ваш запрос, от результатов, выданных для продолжений фоновых задач, чтобы вы могли маршрутизировать или подавлять последние. Поле отсутствует для результатов, выданных перед любым пользовательским ходом, таких как ошибки при запуске.1280Поле `origin` передаёт [`SDKMessageOrigin`](#sdkmessageorigin) пользовательского сообщения, которое запустило этот результат. Когда фоновая задача завершается и SDK внедряет синтетический ход продолжения, результирующее `SDKResultMessage` содержит `origin: { kind: "task-notification" }`. Проверьте это поле, чтобы различить результаты, которые отвечают на ваш запрос, от результатов, выданных для продолжений фоновых задач, чтобы вы могли маршрутизировать или подавлять последние. Поле отсутствует для результатов, выданных перед любым пользовательским ходом, таких как ошибки при запуске.

1281 1281 

1282Когда hook `PreToolUse` возвращает `permissionDecision: "defer"`, результат имеет `stop_reason: "tool_deferred"` и `deferred_tool_use` содержит `id`, `name` и `input` ожидающего инструмента. Прочитайте это поле, чтобы отобразить запрос в вашем собственном пользовательском интерфейсе, затем возобновите с тем же `session_id` для продолжения. Смотрите [Отложить вызов инструмента на потом](/ru/hooks#defer-a-tool-call-for-later) для полного цикла.1282Когда hook `PreToolUse` возвращает `permissionDecision: "defer"`, результат имеет `stop_reason: "tool_deferred"` и `deferred_tool_use` содержит `id`, `name` и `input` ожидающего инструмента. Прочитайте это поле, чтобы отобразить запрос в вашем собственном пользовательском интерфейсе, затем возобновите с тем же `session_id` для продолжения. Смотрите [Отложить вызов инструмента на потом](/docs/ru/hooks#defer-a-tool-call-for-later) для полного цикла.

1283 1283 

1284<h3 id="sdksystemmessage">1284<h3 id="sdksystemmessage">

1285 `SDKSystemMessage`1285 `SDKSystemMessage`


1313};1313};

1314```1314```

1315 1315 

1316{/* min-version: 2.1.205 */}

1317 

1318Массив `capabilities` называет поведения протокола, которые реализует этот CLI, поэтому вы можете обнаруживать функции вместо сравнения строк `claude_code_version`. Это открытый набор: игнорируйте значения, которые вы не распознаёте, и проверяйте конкретную возможность, поведение которой вы используете. Поле требует Claude Code v2.1.205 или позже и отсутствует на более ранних CLI.1316Массив `capabilities` называет поведения протокола, которые реализует этот CLI, поэтому вы можете обнаруживать функции вместо сравнения строк `claude_code_version`. Это открытый набор: игнорируйте значения, которые вы не распознаёте, и проверяйте конкретную возможность, поведение которой вы используете. Поле требует Claude Code v2.1.205 или позже и отсутствует на более ранних CLI.

1319 1317 

1320| Возможность | Значение |1318| Возможность | Значение |


1396 `SDKPluginInstallMessage`1394 `SDKPluginInstallMessage`

1397</h3>1395</h3>

1398 1396 

1399Событие прогресса установки plugin. Выдаётся, когда установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ru/env-vars), поэтому ваше приложение Agent SDK может отслеживать установку marketplace plugin перед первым ходом. Статусы `started` и `completed` заключают в скобки общую установку. Статусы `installed` и `failed` сообщают об отдельных marketplaces и включают `name`.1397Событие прогресса установки plugin. Выдаётся, когда установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/ru/env-vars), поэтому ваше приложение Agent SDK может отслеживать установку marketplace plugin перед первым ходом. Статусы `started` и `completed` заключают в скобки общую установку. Статусы `installed` и `failed` сообщают об отдельных marketplaces и включают `name`.

1400 1398 

1401```typescript theme={null}1399```typescript theme={null}

1402type SDKPluginInstallMessage = {1400type SDKPluginInstallMessage = {


1479```1477```

1480 1478 

1481| `kind` | Значение |1479| `kind` | Значение |

1482| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1480| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1483| `human` | Прямой ввод от конечного пользователя. На пользовательских сообщениях отсутствующий `origin` также означает ввод человека. |1481| `human` | Прямой ввод от конечного пользователя. На пользовательских сообщениях отсутствующий `origin` также означает ввод человека. |

1484| `channel` | Сообщение, поступающее на [канал](/ru/channels). `server` это имя исходного MCP сервера. |1482| `channel` | Сообщение, поступающее на [канал](/docs/ru/channels). `server` это имя исходного MCP сервера. |

1485| `peer` | Сообщение от другого агента. Для внутрипроцессного [товарища по команде](/ru/agent-teams), отправляющего на `main` через `SendMessage`, `from` это имя товарища по команде и `senderTaskId` это его ID задачи. Для кросс-сеансового пира, такого как другой локальный процесс Claude Code, `from` это адрес отправителя и `senderTaskId` отсутствует. {/* min-version: 2.1.205 */}}`name` и `body` требуют Claude Code v2.1.205 или позже. `name` это отображаемое имя отправителя, нормализованное Claude Code: оно удаляет управляющие символы Unicode, формат, суррогаты и разделители строк или абзацев, затем обрезает результат и ограничивает его 64 кодовыми точками с многоточием. `body` это декодированное тело сообщения с удалённой оболочкой пира, побайтово совпадающее с тем, что видит модель. Для сообщения товарища по команде `body` всегда присутствует; для кросс-сеансового пира оно присутствует только когда ход точно представляет собой одну оболочку пира, сформированную Claude Code. Отобразите `name` и `body` вместо повторного анализа текста сообщения. |1483| `peer` | Сообщение от другого агента. Для внутрипроцессного [товарища по команде](/docs/ru/agent-teams), отправляющего на `main` через `SendMessage`, `from` это имя товарища по команде и `senderTaskId` это его ID задачи. Для кросс-сеансового пира, такого как другой локальный процесс Claude Code, `from` это адрес отправителя и `senderTaskId` отсутствует. }`name` и `body` требуют Claude Code v2.1.205 или позже. `name` это отображаемое имя отправителя, нормализованное Claude Code: оно удаляет управляющие символы Unicode, формат, суррогаты и разделители строк или абзацев, затем обрезает результат и ограничивает его 64 кодовыми точками с многоточием. `body` это декодированное тело сообщения с удалённой оболочкой пира, побайтово совпадающее с тем, что видит модель. Для сообщения товарища по команде `body` всегда присутствует; для кросс-сеансового пира оно присутствует только когда ход точно представляет собой одну оболочку пира, сформированную Claude Code. Отобразите `name` и `body` вместо повторного анализа текста сообщения. |

1486| `task-notification` | Синтетический ход, внедрённый после завершения фоновой задачи. Смотрите [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |1484| `task-notification` | Синтетический ход, внедрённый после завершения фоновой задачи. Смотрите [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |

1487| `coordinator` | Сообщение от координатора команды в [команде агентов](/ru/agent-teams). |1485| `coordinator` | Сообщение от координатора команды в [команде агентов](/docs/ru/agent-teams). |

1488| `auto-continuation` | Синтетический ход, внедрённый, когда сеанс продолжается без свежего пользовательского ввода, такой как результат команды, который запускает последующий запрос. |1486| `auto-continuation` | Синтетический ход, внедрённый, когда сеанс продолжается без свежего пользовательского ввода, такой как результат команды, который запускает последующий запрос. |

1489 1487 

1490<h2 id="hook-types">1488<h2 id="hook-types">

1491 Типы hooks1489 Типы hooks

1492</h2>1490</h2>

1493 1491 

1494Для полного руководства по использованию hooks с примерами и общими паттернами см. [руководство Hooks](/ru/agent-sdk/hooks).1492Для полного руководства по использованию hooks с примерами и общими паттернами см. [руководство Hooks](/docs/ru/agent-sdk/hooks).

1495 1493 

1496<h3 id="hookevent">1494<h3 id="hookevent">

1497 `HookEvent`1495 `HookEvent`


1600};1598};

1601```1599```

1602 1600 

1603Поле `prompt_id` — это UUID, идентифицирующий пользовательский запрос, который в настоящий момент обрабатывается. Он совпадает с [атрибутом `prompt.id` на событиях OpenTelemetry](/ru/monitoring-usage#event-correlation-attributes) и отсутствует до первого ввода пользователя. Требуется Claude Code v2.1.196 или позже.1601Поле `prompt_id` — это UUID, идентифицирующий пользовательский запрос, который в настоящий момент обрабатывается. Он совпадает с [атрибутом `prompt.id` на событиях OpenTelemetry](/docs/ru/monitoring-usage#event-correlation-attributes) и отсутствует до первого ввода пользователя. Требуется Claude Code v2.1.196 или позже.

1604 1602 

1605<h4 id="pretoolusehookinput">1603<h4 id="pretoolusehookinput">

1606 `PreToolUseHookInput`1604 `PreToolUseHookInput`


2071};2069};

2072```2070```

2073 2071 

2074Задаёт пользователю уточняющие вопросы во время выполнения. См. [Обработка одобрений и пользовательского ввода](/ru/agent-sdk/user-input#handle-clarifying-questions) для деталей использования.2072Задаёт пользователю уточняющие вопросы во время выполнения. См. [Обработка одобрений и пользовательского ввода](/docs/ru/agent-sdk/user-input#handle-clarifying-questions) для деталей использования.

2075 2073 

2076<h3 id="bash">2074<h3 id="bash">

2077 Bash2075 Bash


2110};2108};

2111```2109```

2112 2110 

2113Запускает фоновый источник и доставляет каждое событие к Claude, чтобы он мог реагировать без опроса: `command` запускает скрипт и выдаёт одно событие на строку stdout, а `ws` открывает WebSocket и выдаёт одно событие на текстовый фрейм. Укажите ровно один из `command` или `ws`. {/* min-version: 2.1.195 */}Источник `ws` требует Claude Code v2.1.195 или позже.2111Запускает фоновый источник и доставляет каждое событие к Claude, чтобы он мог реагировать без опроса: `command` запускает скрипт и выдаёт одно событие на строку stdout, а `ws` открывает WebSocket и выдаёт одно событие на текстовый фрейм. Укажите ровно один из `command` или `ws`. Источник `ws` требует Claude Code v2.1.195 или позже.

2114 2112 

2115Установите `persistent: true` для наблюдений на уровне сессии, таких как хвосты логов. Когда Monitor запускает команду, он следует тем же правилам разрешения, что и Bash; наблюдение WebSocket запрашивает одобрение отдельно. См. [справочник tool Monitor](/ru/tools-reference#monitor-tool) для поведения и доступности провайдера.2113Установите `persistent: true` для наблюдений на уровне сессии, таких как хвосты логов. Когда Monitor запускает команду, он следует тем же правилам разрешения, что и Bash; наблюдение WebSocket запрашивает одобрение отдельно. См. [справочник tool Monitor](/docs/ru/tools-reference#monitor-tool) для поведения и доступности провайдера.

2116 2114 

2117<h3 id="taskoutput">2115<h3 id="taskoutput">

2118 TaskOutput2116 TaskOutput


2234};2232};

2235```2233```

2236 2234 

2237Останавливает выполняющуюся фоновую задачу или shell по ID. {/* min-version: 2.1.198 */}Начиная с v2.1.198, `task_id` также принимает товарища по команде agent-team или именованного фонового агента по ID агента или имени.2235Останавливает выполняющуюся фоновую задачу или shell по ID. Начиная с v2.1.198, `task_id` также принимает товарища по команде agent-team или именованного фонового агента по ID агента или имени.

2238 2236 

2239<h3 id="notebookedit">2237<h3 id="notebookedit">

2240 NotebookEdit2238 NotebookEdit


2301};2299};

2302```2300```

2303 2301 

2304Запускает [динамический workflow](/ru/workflows): скрипт, который организует множество подагентов в фоне и возвращает один консолидированный результат. Tool `Workflow` доступен в Agent SDK v0.3.149 и позже. Требуется хотя бы один из `script`, `name` или `scriptPath`.2302Запускает [динамический workflow](/docs/ru/workflows): скрипт, который организует множество подагентов в фоне и возвращает один консолидированный результат. Tool `Workflow` доступен в Agent SDK v0.3.149 и позже. Требуется хотя бы один из `script`, `name` или `scriptPath`.

2305 2303 

2306| Поле | Тип | Описание |2304| Поле | Тип | Описание |

2307| ----------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2305| ----------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


2330Создаёт и управляет структурированным списком задач для отслеживания прогресса.2328Создаёт и управляет структурированным списком задач для отслеживания прогресса.

2331 2329 

2332<Note>2330<Note>

2333 Начиная с TypeScript Agent SDK 0.3.142, `TodoWrite` отключён по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. См. [Миграция на Task tools](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.2331 Начиная с TypeScript Agent SDK 0.3.142, `TodoWrite` отключён по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. См. [Миграция на Task tools](/docs/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.

2334</Note>2332</Note>

2335 2333 

2336<h3 id="taskcreate">2334<h3 id="taskcreate">


2570 2568 

2571Возвращает результат от подагента. Дискриминирован по полю `status`: `"completed"` для завершённых задач, `"async_launched"` для фоновых задач и `"remote_launched"` для задач, которые Claude Code отправил в удалённый облачный сеанс, где `sessionUrl` ссылается на этот сеанс и `taskId` его идентифицирует.2569Возвращает результат от подагента. Дискриминирован по полю `status`: `"completed"` для завершённых задач, `"async_launched"` для фоновых задач и `"remote_launched"` для задач, которые Claude Code отправил в удалённый облачный сеанс, где `sessionUrl` ссылается на этот сеанс и `taskId` его идентифицирует.

2572 2570 

2573Поле `resolvedModel` на вариантах `completed` и `async_launched` указывает модель, на которой фактически работал подагент, которая может отличаться от запрошенного входного параметра `model` когда применяется [`availableModels`](/ru/model-config#restrict-model-selection) или другое переопределение. {/* min-version: 2.1.174 */}Это поле требует Claude Code v2.1.174 или позже.2571Поле `resolvedModel` на вариантах `completed` и `async_launched` указывает модель, на которой фактически работал подагент, которая может отличаться от запрошенного входного параметра `model` когда применяется [`availableModels`](/docs/ru/model-config#restrict-model-selection) или другое переопределение. Это поле требует Claude Code v2.1.174 или позже.

2574 2572 

2575На варианте `completed` `worktreePath` устанавливается, когда подагент работал в изолированном git worktree, и `worktreeBranch` называет ветку этого worktree, когда Claude Code её создал. `usage.service_tier` содержит строку уровня обслуживания, которую API сообщила для запросов подагента.2573На варианте `completed` `worktreePath` устанавливается, когда подагент работал в изолированном git worktree, и `worktreeBranch` называет ветку этого worktree, когда Claude Code её создал. `usage.service_tier` содержит строку уровня обслуживания, которую API сообщила для запросов подагента.

2576 2574 


2936Возвращает предыдущие и обновлённые списки задач.2934Возвращает предыдущие и обновлённые списки задач.

2937 2935 

2938<Note>2936<Note>

2939 Начиная с TypeScript Agent SDK 0.3.142, `TodoWrite` отключён по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. Смотрите [Миграция на Task tools](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.2937 Начиная с TypeScript Agent SDK 0.3.142, `TodoWrite` отключён по умолчанию. Используйте вместо этого `TaskCreate`, `TaskGet`, `TaskUpdate` и `TaskList`. Смотрите [Миграция на Task tools](/docs/ru/agent-sdk/todo-tracking#migrate-to-task-tools) для обновления кода мониторинга, или установите `CLAUDE_CODE_ENABLE_TASKS=0` для возврата к `TodoWrite`.

2940</Note>2938</Note>

2941 2939 

2942<h3 id="taskcreate-2">2940<h3 id="taskcreate-2">


3230```3228```

3231 3229 

3232| Поле | Тип | Описание |3230| Поле | Тип | Описание |

3233| :------------------------- | :----------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3231| :------------------------- | :----------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

3234| `value` | `string` | Идентификатор модели для передачи в вызовы API |3232| `value` | `string` | Идентификатор модели для передачи в вызовы API |

3235| `resolvedModel` | `string \| undefined` | Канонический идентификатор модели провода, на который разрешается `value` этой записи. Запись псевдонима, такая как `sonnet`, разрешается на явный идентификатор модели, такой как `claude-sonnet-5`, поэтому хост может сопоставить сохранённый явный идентификатор модели с записью псевдонима, которая его охватывает. {/* min-version: 2.1.197 */}Требуется Claude Code v2.1.197 или позже. |3233| `resolvedModel` | `string \| undefined` | Канонический идентификатор модели провода, на который разрешается `value` этой записи. Запись псевдонима, такая как `sonnet`, разрешается на явный идентификатор модели, такой как `claude-sonnet-5`, поэтому хост может сопоставить сохранённый явный идентификатор модели с записью псевдонима, которая его охватывает. Требуется Claude Code v2.1.197 или позже. |

3236| `displayName` | `string` | Удобочитаемое отображаемое имя |3234| `displayName` | `string` | Удобочитаемое отображаемое имя |

3237| `description` | `string` | Описание возможностей модели |3235| `description` | `string` | Описание возможностей модели |

3238| `supportsEffort` | `boolean \| undefined` | Поддерживает ли эта модель уровни усилий |3236| `supportsEffort` | `boolean \| undefined` | Поддерживает ли эта модель уровни усилий |


3327 `ModelUsage`3325 `ModelUsage`

3328</h3>3326</h3>

3329 3327 

3330Статистика использования для каждой модели, возвращаемая в сообщениях результата. Значение `costUSD` это оценка на стороне клиента. См. [Отслеживание стоимости и использования](/ru/agent-sdk/cost-tracking) для предостережений выставления счётов.3328Статистика использования для каждой модели, возвращаемая в сообщениях результата. Значение `costUSD` это оценка на стороне клиента. См. [Отслеживание стоимости и использования](/docs/ru/agent-sdk/cost-tracking) для предостережений выставления счётов.

3331 3329 

3332```typescript theme={null}3330```typescript theme={null}

3333type ModelUsage = {3331type ModelUsage = {


3392 `CallToolResult`3390 `CallToolResult`

3393</h3>3391</h3>

3394 3392 

3395Тип результата MCP tool (из `@modelcontextprotocol/sdk/types.js`). `structuredContent` это объект JSON, который может быть возвращён вместе с `content`, включая блоки изображений. См. [Возврат структурированных данных](/ru/agent-sdk/custom-tools#return-structured-data).3393Тип результата MCP tool (из `@modelcontextprotocol/sdk/types.js`). `structuredContent` это объект JSON, который может быть возвращён вместе с `content`, включая блоки изображений. См. [Возврат структурированных данных](/docs/ru/agent-sdk/custom-tools#return-structured-data).

3396 3394 

3397```typescript theme={null}3395```typescript theme={null}

3398type CallToolResult = {3396type CallToolResult = {


3742 3740 

3743Ничего не выдаётся при запуске. Сбросьте на пустой набор всякий раз, когда процесс CLI сессии запускается или перезапускается, и позвольте следующему изменению членства переполнить его.3741Ничего не выдаётся при запуске. Сбросьте на пустой набор всякий раз, когда процесс CLI сессии запускается или перезапускается, и позвольте следующему изменению членства переполнить его.

3744 3742 

3745{/* min-version: 2.1.203 */}Требуется Claude Code v2.1.203 или позже.3743Требуется Claude Code v2.1.203 или позже.

3746 3744 

3747```typescript theme={null}3745```typescript theme={null}

3748type SDKBackgroundTasksChangedMessage = {3746type SDKBackgroundTasksChangedMessage = {


3762 `SDKThinkingTokensMessage`3760 `SDKThinkingTokensMessage`

3763</h3>3761</h3>

3764 3762 

3765Выдаётся во время создания Claude блока мышления, включая отредактированный, с текущей оценкой токенов мышления, созданных до сих пор. `estimated_tokens` это текущий итог для текущего блока мышления и `estimated_tokens_delta` это приращение, переносимое этим кадром. Используйте его для отображения прогресса. Окончательный подсчёт для цикла агента верхнего уровня это `usage.output_tokens` сообщения результата, который [не включает токены подагентов](/ru/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); используйте [`modelUsage`](#modelusage) для учёта всего дерева.3763Выдаётся во время создания Claude блока мышления, включая отредактированный, с текущей оценкой токенов мышления, созданных до сих пор. `estimated_tokens` это текущий итог для текущего блока мышления и `estimated_tokens_delta` это приращение, переносимое этим кадром. Используйте его для отображения прогресса. Окончательный подсчёт для цикла агента верхнего уровня это `usage.output_tokens` сообщения результата, который [не включает токены подагентов](/docs/ru/agent-sdk/cost-tracking#get-the-total-cost-of-a-query); используйте [`modelUsage`](#modelusage) для учёта всего дерева.

3766 3764 

3767{/* min-version: 2.1.153 */}Требуется Claude Code v2.1.153 или позже.3765Требуется Claude Code v2.1.153 или позже.

3768 3766 

3769```typescript theme={null}3767```typescript theme={null}

3770type SDKThinkingTokensMessage = {3768type SDKThinkingTokensMessage = {


3817};3815};

3818```3816```

3819 3817 

3820{/* min-version: 2.1.181 */}Когда `errorCode` это `"credits_required"`, отклонение происходит от подписки claude.ai, чьё включённое использование исчерпано, и сессия не может продолжаться, пока пользователь не купит кредиты использования. `canUserPurchaseCredits` указывает, может ли аутентифицированный пользователь купить кредиты для учётной записи, и `hasChargeableSavedPaymentMethod` указывает, есть ли сохранённый способ оплаты в файле. Все три поля отсутствуют на событиях ограничения скорости, которые не являются отклонениями, требующими кредитов. Требуется Claude Code v2.1.181 или позже.3818Когда `errorCode` это `"credits_required"`, отклонение происходит от подписки claude.ai, чьё включённое использование исчерпано, и сессия не может продолжаться, пока пользователь не купит кредиты использования. `canUserPurchaseCredits` указывает, может ли аутентифицированный пользователь купить кредиты для учётной записи, и `hasChargeableSavedPaymentMethod` указывает, есть ли сохранённый способ оплаты в файле. Все три поля отсутствуют на событиях ограничения скорости, которые не являются отклонениями, требующими кредитов. Требуется Claude Code v2.1.181 или позже.

3821 3819 

3822<h3 id="sdklocalcommandoutputmessage">3820<h3 id="sdklocalcommandoutputmessage">

3823 `SDKLocalCommandOutputMessage`3821 `SDKLocalCommandOutputMessage`


3881};3879};

3882```3880```

3883 3881 

3884{/* min-version: 2.1.203 */}Опубликованные типизации SDK объявляют `SDKConversationResetMessage` в Claude Code v2.1.203 и позже. До v2.1.203, `SDKMessage` ссылалась на тип без его объявления, поэтому сужение на `type === "conversation_reset"` не прошло проверку типов, когда `skipLibCheck` был отключён.3882Опубликованные типизации SDK объявляют `SDKConversationResetMessage` в Claude Code v2.1.203 и позже. До v2.1.203, `SDKMessage` ссылалась на тип без его объявления, поэтому сужение на `type === "conversation_reset"` не прошло проверку типов, когда `skipLibCheck` был отключён.

3885 3883 

3886<h3 id="aborterror">3884<h3 id="aborterror">

3887 `AbortError`3885 `AbortError`


3932| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | Конфигурация пользовательского бинарного файла ripgrep для окружений sandbox |3930| `ripgrep` | `{ command: string; args?: string[] }` | `undefined` | Конфигурация пользовательского бинарного файла ripgrep для окружений sandbox |

3933 3931 

3934<Note>3932<Note>

3935 Sandbox зависит от поддержки платформы и, на Linux, инструментов, таких как `bubblewrap` и `socat`. Когда `enabled` имеет значение `true` и sandbox не может запуститься, `query()` сообщает сообщение `result` с `subtype: "error_during_execution"` и причину в `errors`. Для одного вызова сообщения `query()` SDK выбрасывает после выдачи этого результата ошибки, поэтому оберните цикл в блок try для продолжения после него. Смотрите [Handle the result](/ru/agent-sdk/agent-loop#handle-the-result) для контракта ошибки.3933 Sandbox зависит от поддержки платформы и, на Linux, инструментов, таких как `bubblewrap` и `socat`. Когда `enabled` имеет значение `true` и sandbox не может запуститься, `query()` сообщает сообщение `result` с `subtype: "error_during_execution"` и причину в `errors`. Для одного вызова сообщения `query()` SDK выбрасывает после выдачи этого результата ошибки, поэтому оберните цикл в блок try для продолжения после него. Смотрите [Handle the result](/docs/ru/agent-sdk/agent-loop#handle-the-result) для контракта ошибки.

3936 3934 

3937 Для выполнения без sandbox вместо этого установите `failIfUnavailable: false`.3935 Для выполнения без sandbox вместо этого установите `failIfUnavailable: false`.

3938</Note>3936</Note>


3974 `SandboxNetworkConfig`3972 `SandboxNetworkConfig`

3975</h3>3973</h3>

3976 3974 

3977Конфигурация, специфичная для сети, для режима sandbox. Эти параметры применяются к sandboxed Bash командам, когда `enabled` имеет значение `true` в родительском [`SandboxSettings`](#sandboxsettings). Они не ограничивают инструмент WebFetch, который использует [правила разрешений](/ru/permissions#webfetch) вместо этого.3975Конфигурация, специфичная для сети, для режима sandbox. Эти параметры применяются к sandboxed Bash командам, когда `enabled` имеет значение `true` в родительском [`SandboxSettings`](#sandboxsettings). Они не ограничивают инструмент WebFetch, который использует [правила разрешений](/docs/ru/permissions#webfetch) вместо этого.

3978 3976 

3979```typescript theme={null}3977```typescript theme={null}

3980type SandboxNetworkConfig = {3978type SandboxNetworkConfig = {


3993| :------------------------ | :--------- | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3991| :------------------------ | :--------- | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3994| `allowedDomains` | `string[]` | `[]` | Имена доменов, к которым процессы в sandbox могут получить доступ |3992| `allowedDomains` | `string[]` | `[]` | Имена доменов, к которым процессы в sandbox могут получить доступ |

3995| `deniedDomains` | `string[]` | `[]` | Имена доменов, к которым процессы в sandbox не могут получить доступ. Имеет приоритет над `allowedDomains` |3993| `deniedDomains` | `string[]` | `[]` | Имена доменов, к которым процессы в sandbox не могут получить доступ. Имеет приоритет над `allowedDomains` |

3996| `allowManagedDomainsOnly` | `boolean` | `false` | Только управляемые параметры. Когда установлено в [управляемых параметрах](/ru/permissions#managed-settings), только записи `allowedDomains` из управляемых параметров учитываются, а записи из пользовательских, проектных или локальных параметров игнорируются. Не имеет эффекта при установке через опции SDK |3994| `allowManagedDomainsOnly` | `boolean` | `false` | Только управляемые параметры. Когда установлено в [управляемых параметрах](/docs/ru/permissions#managed-settings), только записи `allowedDomains` из управляемых параметров учитываются, а записи из пользовательских, проектных или локальных параметров игнорируются. Не имеет эффекта при установке через опции SDK |

3997| `allowLocalBinding` | `boolean` | `false` | Разрешите процессам привязываться к локальным портам (например, для dev серверов) |3995| `allowLocalBinding` | `boolean` | `false` | Разрешите процессам привязываться к локальным портам (например, для dev серверов) |

3998| `allowUnixSockets` | `string[]` | `[]` | Пути Unix socket, к которым процессы могут получить доступ (например, Docker socket) |3996| `allowUnixSockets` | `string[]` | `[]` | Пути Unix socket, к которым процессы могут получить доступ (например, Docker socket) |

3999| `allowAllUnixSockets` | `boolean` | `false` | Разрешите доступ ко всем Unix sockets |3997| `allowAllUnixSockets` | `boolean` | `false` | Разрешите доступ ко всем Unix sockets |


4001| `socksProxyPort` | `number` | `undefined` | Порт SOCKS прокси для сетевых запросов |3999| `socksProxyPort` | `number` | `undefined` | Порт SOCKS прокси для сетевых запросов |

4002 4000 

4003<Note>4001<Note>

4004 Встроенный прокси sandbox применяет `allowedDomains` на основе запрашиваемого имени хоста и не завершает и не проверяет трафик TLS, поэтому такие методы, как [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting), потенциально могут его обойти. Смотрите [Ограничения безопасности Sandboxing](/ru/sandboxing#security-limitations) для деталей и [Безопасное развёртывание](/ru/agent-sdk/secure-deployment#traffic-forwarding) для конфигурации прокси, завершающего TLS.4002 Встроенный прокси sandbox применяет `allowedDomains` на основе запрашиваемого имени хоста и не завершает и не проверяет трафик TLS, поэтому такие методы, как [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting), потенциально могут его обойти. Смотрите [Ограничения безопасности Sandboxing](/docs/ru/sandboxing#security-limitations) для деталей и [Безопасное развёртывание](/docs/ru/agent-sdk/secure-deployment#traffic-forwarding) для конфигурации прокси, завершающего TLS.

4005</Note>4003</Note>

4006 4004 

4007<h3 id="sandboxfilesystemconfig">4005<h3 id="sandboxfilesystemconfig">


4079<Warning>4077<Warning>

4080 Команды, работающие с `dangerouslyDisableSandbox: true`, имеют полный доступ к системе. Убедитесь, что ваш обработчик `canUseTool` тщательно проверяет эти запросы.4078 Команды, работающие с `dangerouslyDisableSandbox: true`, имеют полный доступ к системе. Убедитесь, что ваш обработчик `canUseTool` тщательно проверяет эти запросы.

4081 4079 

4082 Если `permissionMode` установлен на `bypassPermissions` и `allowUnsandboxedCommands` включён, модель может автономно выполнять команды вне sandbox без каких-либо запросов одобрения (явное [`ask` правило](/ru/agent-sdk/permissions#how-permissions-are-evaluated) всё ещё заставляет один). Эта комбинация фактически позволяет модели молча выходить из изоляции sandbox.4080 Если `permissionMode` установлен на `bypassPermissions` и `allowUnsandboxedCommands` включён, модель может автономно выполнять команды вне sandbox без каких-либо запросов одобрения (явное [`ask` правило](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated) всё ещё заставляет один). Эта комбинация фактически позволяет модели молча выходить из изоляции sandbox.

4083</Warning>4081</Warning>

4084 4082 

4085<h2 id="see-also">4083<h2 id="see-also">

4086 См. также4084 См. также

4087</h2>4085</h2>

4088 4086 

4089* [Обзор SDK](/ru/agent-sdk/overview) - Общие концепции SDK4087* [Обзор SDK](/docs/ru/agent-sdk/overview) - Общие концепции SDK

4090* [Справочник Python SDK](/ru/agent-sdk/python) - Документация Python SDK4088* [Справочник Python SDK](/docs/ru/agent-sdk/python) - Документация Python SDK

4091* [Справочник CLI](/ru/cli-reference) - Интерфейс командной строки4089* [Справочник CLI](/docs/ru/cli-reference) - Интерфейс командной строки

4092* [Общие рабочие процессы](/ru/common-workflows) - Пошаговые руководства4090* [Общие рабочие процессы](/docs/ru/common-workflows) - Пошаговые руководства

Details

12 12 

13Для уточняющих вопросов Claude генерирует вопросы и варианты ответов. Ваша роль — представить их пользователям и вернуть их выборы. Вы не можете добавлять свои собственные вопросы в этот процесс; если вам нужно что-то спросить у пользователей, сделайте это отдельно в логике вашего приложения.13Для уточняющих вопросов Claude генерирует вопросы и варианты ответов. Ваша роль — представить их пользователям и вернуть их выборы. Вы не можете добавлять свои собственные вопросы в этот процесс; если вам нужно что-то спросить у пользователей, сделайте это отдельно в логике вашего приложения.

14 14 

15Callback может оставаться в ожидании неопределённо долго. Выполнение остаётся приостановленным до возврата вашего callback, и SDK отменяет ожидание только при отмене самого запроса. Если пользователь может ответить дольше, чем ваш процесс может разумно оставаться запущенным, верните решение [`defer` hook](/ru/hooks#defer-a-tool-call-for-later), которое позволяет процессу выйти и возобновиться позже из сохранённой сессии.15Callback может оставаться в ожидании неопределённо долго. Выполнение остаётся приостановленным до возврата вашего callback, и SDK отменяет ожидание только при отмене самого запроса. Если пользователь может ответить дольше, чем ваш процесс может разумно оставаться запущенным, верните решение [`defer` hook](/docs/ru/hooks#defer-a-tool-call-for-later), которое позволяет процессу выйти и возобновиться позже из сохранённой сессии.

16 16 

17Это руководство показывает, как обнаружить каждый тип запроса и ответить надлежащим образом.17Это руководство показывает, как обнаружить каждый тип запроса и ответить надлежащим образом.

18 18 


44 44 

45Callback срабатывает в двух случаях:45Callback срабатывает в двух случаях:

46 46 

471. **Инструмент требует одобрения**: Claude хочет использовать инструмент, который не одобрен автоматически [правилом разрешений](/ru/agent-sdk/permissions) или режимом разрешений. Проверьте `tool_name` на имя инструмента (например, `"Bash"`, `"Write"`).471. **Инструмент требует одобрения**: Claude хочет использовать инструмент, который не одобрен автоматически [правилом разрешений](/docs/ru/agent-sdk/permissions) или режимом разрешений. Проверьте `tool_name` на имя инструмента (например, `"Bash"`, `"Write"`).

482. **Claude задаёт вопрос**: Claude вызывает инструмент `AskUserQuestion`. Проверьте, равен ли `tool_name == "AskUserQuestion"`, чтобы обработать его иначе. Если вы указываете массив `tools`, включите `AskUserQuestion` для работы этого функционала. Подробнее см. [Обработка уточняющих вопросов](#handle-clarifying-questions).482. **Claude задаёт вопрос**: Claude вызывает инструмент `AskUserQuestion`. Проверьте, равен ли `tool_name == "AskUserQuestion"`, чтобы обработать его иначе. Если вы указываете массив `tools`, включите `AskUserQuestion` для работы этого функционала. Подробнее см. [Обработка уточняющих вопросов](#handle-clarifying-questions).

49 49 

50<Warning>50<Warning>

51 **Callback никогда не срабатывает для автоматически одобренных инструментов.** Любое одобрение на более ранних этапах [потока оценки разрешений](/ru/agent-sdk/permissions#how-permissions-are-evaluated), правило разрешения или режим, такой как `acceptEdits` или `bypassPermissions`, разрешает вызов до того, как будет проверен `canUseTool`. Если вы указываете инструмент в `allowed_tools`, проверка `canUseTool` для этого инструмента никогда не выполняется, если только правило ask или режим `plan` не перенаправляют вызов обратно в prompt. Для логики, которая должна применяться к каждому вызову инструмента, используйте [`PreToolUse` hook](/ru/agent-sdk/hooks), который выполняется перед остальной частью потока и может разрешить, отклонить или изменить запросы.51 **Callback никогда не срабатывает для автоматически одобренных инструментов.** Любое одобрение на более ранних этапах [потока оценки разрешений](/docs/ru/agent-sdk/permissions#how-permissions-are-evaluated), правило разрешения или режим, такой как `acceptEdits` или `bypassPermissions`, разрешает вызов до того, как будет проверен `canUseTool`. Если вы указываете инструмент в `allowed_tools`, проверка `canUseTool` для этого инструмента никогда не выполняется, если только правило ask или режим `plan` не перенаправляют вызов обратно в prompt. Для логики, которая должна применяться к каждому вызову инструмента, используйте [`PreToolUse` hook](/docs/ru/agent-sdk/hooks), который выполняется перед остальной частью потока и может разрешить, отклонить или изменить запросы.

52 52 

53 `AskUserQuestion`, инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), и инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) достигают callback даже когда правило разрешения совпадает. В режиме `dontAsk` эти вызовы вместо этого отклоняются без вызова callback.53 `AskUserQuestion`, инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), и инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) достигают callback даже когда правило разрешения совпадает. В режиме `dontAsk` эти вызовы вместо этого отклоняются без вызова callback.

54</Warning>54</Warning>

55 55 

56Вы также можете использовать [`PermissionRequest` hook](/ru/agent-sdk/hooks#available-hooks) для отправки внешних уведомлений (Slack, email, push) когда Claude ждёт одобрения.56Вы также можете использовать [`PermissionRequest` hook](/docs/ru/agent-sdk/hooks#available-hooks) для отправки внешних уведомлений (Slack, email, push) когда Claude ждёт одобрения.

57 57 

58<h2 id="handle-tool-approval-requests">58<h2 id="handle-tool-approval-requests">

59 Обработка запросов на одобрение инструмента59 Обработка запросов на одобрение инструмента


65| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |65| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

66| `toolName` | Имя инструмента, который Claude хочет использовать (например, `"Bash"`, `"Write"`, `"Edit"`) |66| `toolName` | Имя инструмента, который Claude хочет использовать (например, `"Bash"`, `"Write"`, `"Edit"`) |

67| `input` | Параметры, которые Claude передаёт инструменту. Содержимое варьируется в зависимости от инструмента. |67| `input` | Параметры, которые Claude передаёт инструменту. Содержимое варьируется в зависимости от инструмента. |

68| `options` (TS) / `context` (Python) | Дополнительный контекст, включая опциональные `suggestions` (предложенные записи `PermissionUpdate` для избежания повторного запроса) и сигнал отмены. В TypeScript `signal` — это `AbortSignal`; в Python поле signal зарезервировано для будущего использования. Подробнее см. [`ToolPermissionContext`](/ru/agent-sdk/python#toolpermissioncontext) для Python. |68| `options` (TS) / `context` (Python) | Дополнительный контекст, включая опциональные `suggestions` (предложенные записи `PermissionUpdate` для избежания повторного запроса) и сигнал отмены. В TypeScript `signal` — это `AbortSignal`; в Python поле signal зарезервировано для будущего использования. Подробнее см. [`ToolPermissionContext`](/docs/ru/agent-sdk/python#toolpermissioncontext) для Python. |

69 69 

70Объект `input` содержит параметры, специфичные для инструмента. Распространённые примеры:70Объект `input` содержит параметры, специфичные для инструмента. Распространённые примеры:

71 71 


76| `Edit` | `file_path`, `old_string`, `new_string` |76| `Edit` | `file_path`, `old_string`, `new_string` |

77| `Read` | `file_path`, `offset`, `limit` |77| `Read` | `file_path`, `offset`, `limit` |

78 78 

79Полные схемы ввода см. в справочнике SDK: [Python](/ru/agent-sdk/python#tool-input%2Foutput-types) | [TypeScript](/ru/agent-sdk/typescript#tool-input-types).79Полные схемы ввода см. в справочнике SDK: [Python](/docs/ru/agent-sdk/python#tool-input%2Foutput-types) | [TypeScript](/docs/ru/agent-sdk/typescript#tool-input-types).

80 80 

81Вы можете отобразить эту информацию пользователю, чтобы он мог решить, разрешить или отклонить действие, а затем вернуть соответствующий ответ.81Вы можете отобразить эту информацию пользователю, чтобы он мог решить, разрешить или отклонить действие, а затем вернуть соответствующий ответ.

82 82 


200</CodeGroup>200</CodeGroup>

201 201 

202<Note>202<Note>

203 В Python `can_use_tool` требует [режима потоковой передачи](/ru/agent-sdk/streaming-vs-single-mode). Когда вы передаёте конечный поток сообщений через `query(prompt=generator)` или `ClaudeSDKClient.connect(prompt=async_iterable)`, SDK закрывает входной поток после последнего сообщения, прежде чем callback разрешения сможет быть вызван, если зарегистрированный hook или встроенный MCP-сервер не держит его открытым. Пример выше держит его открытым с помощью hook `PreToolUse`, который возвращает `{"continue_": True}`. Подключение без запроса и отправка сообщений через `ClaudeSDKClient.query()` держит поток открытым самостоятельно и не требует hook.203 В Python `can_use_tool` требует [режима потоковой передачи](/docs/ru/agent-sdk/streaming-vs-single-mode). Когда вы передаёте конечный поток сообщений через `query(prompt=generator)` или `ClaudeSDKClient.connect(prompt=async_iterable)`, SDK закрывает входной поток после последнего сообщения, прежде чем callback разрешения сможет быть вызван, если зарегистрированный hook или встроенный MCP-сервер не держит его открытым. Пример выше держит его открытым с помощью hook `PreToolUse`, который возвращает `{"continue_": True}`. Подключение без запроса и отправка сообщений через `ClaudeSDKClient.query()` держит поток открытым самостоятельно и не требует hook.

204</Note>204</Note>

205 205 

206Этот пример использует поток y/n, где любой ввод, отличный от `y`, рассматривается как отказ. На практике вы можете создать более богатый пользовательский интерфейс, который позволяет пользователям изменять запрос, предоставлять обратную связь или полностью перенаправлять Claude. Подробнее см. [Ответ на запросы инструментов](#respond-to-tool-requests).206Этот пример использует поток y/n, где любой ввод, отличный от `y`, рассматривается как отказ. На практике вы можете создать более богатый пользовательский интерфейс, который позволяет пользователям изменять запрос, предоставлять обратную связь или полностью перенаправлять Claude. Подробнее см. [Ответ на запросы инструментов](#respond-to-tool-requests).


216| **Разрешить** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |216| **Разрешить** | `PermissionResultAllow(updated_input=...)` | `{ behavior: "allow", updatedInput }` |

217| **Отклонить** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |217| **Отклонить** | `PermissionResultDeny(message=...)` | `{ behavior: "deny", message }` |

218 218 

219При разрешении инструмент выполняется с вводом, который запросил Claude, если вы не вернёте изменённый ввод, `updatedInput` в TypeScript или `updated_input` в Python. {/* min-version: 2.1.207 */}До версии 2.1.207 Claude Code отклонял результат разрешения, который опускал `updatedInput`, и отклонял вызов инструмента с ошибкой валидации.219При разрешении инструмент выполняется с вводом, который запросил Claude, если вы не вернёте изменённый ввод, `updatedInput` в TypeScript или `updated_input` в Python. До версии 2.1.207 Claude Code отклонял результат разрешения, который опускал `updatedInput`, и отклонял вызов инструмента с ошибкой валидации.

220 220 

221При отклонении предоставьте сообщение, объясняющее причину. Claude видит это сообщение и может скорректировать свой подход.221При отклонении предоставьте сообщение, объясняющее причину. Claude видит это сообщение и может скорректировать свой подход.

222 222 


247* **Одобрить и запомнить**: отправить обратно предложенное правило разрешения, чтобы совпадающие вызовы пропускали запрос в следующий раз247* **Одобрить и запомнить**: отправить обратно предложенное правило разрешения, чтобы совпадающие вызовы пропускали запрос в следующий раз

248* **Отклонить**: заблокировать инструмент и объяснить Claude причину248* **Отклонить**: заблокировать инструмент и объяснить Claude причину

249* **Предложить альтернативу**: заблокировать, но направить Claude к тому, что хочет пользователь249* **Предложить альтернативу**: заблокировать, но направить Claude к тому, что хочет пользователь

250* **Полностью перенаправить**: использовать [потоковый ввод](/ru/agent-sdk/streaming-vs-single-mode) для отправки Claude совершенно новой инструкции250* **Полностью перенаправить**: использовать [потоковый ввод](/docs/ru/agent-sdk/streaming-vs-single-mode) для отправки Claude совершенно новой инструкции

251 251 

252<Tabs>252<Tabs>

253 <Tab title="Одобрить">253 <Tab title="Одобрить">


311 </Tab>311 </Tab>

312 312 

313 <Tab title="Одобрить и запомнить">313 <Tab title="Одобрить и запомнить">

314 Пользователь одобряет и не хочет, чтобы его спрашивали снова для этого вида вызова. Третий аргумент callback содержит `suggestions`, массив готовых записей [`PermissionUpdate`](/ru/agent-sdk/typescript#permissionupdate). Отправьте одну обратно в `updatedPermissions` для её применения. Предложение с назначением `localSettings` записывает правило в `.claude/settings.local.json`, чтобы будущие сеансы пропускали запрос для совпадающих вызовов.314 Пользователь одобряет и не хочет, чтобы его спрашивали снова для этого вида вызова. Третий аргумент callback содержит `suggestions`, массив готовых записей [`PermissionUpdate`](/docs/ru/agent-sdk/typescript#permissionupdate). Отправьте одну обратно в `updatedPermissions` для её применения. Предложение с назначением `localSettings` записывает правило в `.claude/settings.local.json`, чтобы будущие сеансы пропускали запрос для совпадающих вызовов.

315 315 

316 Пример Python требует `claude-agent-sdk` версии 0.1.80 или позже.316 Пример Python требует `claude-agent-sdk` версии 0.1.80 или позже.

317 317 


415 </Tab>415 </Tab>

416 416 

417 <Tab title="Полностью перенаправить">417 <Tab title="Полностью перенаправить">

418 Для полного изменения направления (не просто подсказка), используйте [потоковый ввод](/ru/agent-sdk/streaming-vs-single-mode) для отправки Claude новой инструкции напрямую. Это обходит текущий запрос инструмента и даёт Claude совершенно новые инструкции для следования.418 Для полного изменения направления (не просто подсказка), используйте [потоковый ввод](/docs/ru/agent-sdk/streaming-vs-single-mode) для отправки Claude новой инструкции напрямую. Это обходит текущий запрос инструмента и даёт Claude совершенно новые инструкции для следования.

419 </Tab>419 </Tab>

420</Tabs>420</Tabs>

421 421 


426Когда Claude нуждается в дополнительном направлении для задачи с несколькими допустимыми подходами, он вызывает инструмент `AskUserQuestion`. Это запускает ваш callback `canUseTool` с `toolName`, установленным на `AskUserQuestion`. Ввод содержит вопросы Claude в виде вариантов с множественным выбором, которые вы выводите пользователю и возвращаете их выборы.426Когда Claude нуждается в дополнительном направлении для задачи с несколькими допустимыми подходами, он вызывает инструмент `AskUserQuestion`. Это запускает ваш callback `canUseTool` с `toolName`, установленным на `AskUserQuestion`. Ввод содержит вопросы Claude в виде вариантов с множественным выбором, которые вы выводите пользователю и возвращаете их выборы.

427 427 

428<Tip>428<Tip>

429 Уточняющие вопросы особенно распространены в [режиме `plan`](/ru/agent-sdk/permissions#plan-mode-plan), где Claude исследует кодовую базу и задаёт вопросы перед предложением плана. Это делает режим plan идеальным для интерактивных рабочих процессов, где вы хотите, чтобы Claude собрал требования перед внесением изменений.429 Уточняющие вопросы особенно распространены в [режиме `plan`](/docs/ru/agent-sdk/permissions#plan-mode-plan), где Claude исследует кодовую базу и задаёт вопросы перед предложением плана. Это делает режим plan идеальным для интерактивных рабочих процессов, где вы хотите, чтобы Claude собрал требования перед внесением изменений.

430</Tip>430</Tip>

431 431 

432Следующие шаги показывают, как обработать уточняющие вопросы:432Следующие шаги показывают, как обработать уточняющие вопросы:


864 Потоковый ввод864 Потоковый ввод

865</h3>865</h3>

866 866 

867Используйте [потоковый ввод](/ru/agent-sdk/streaming-vs-single-mode) когда вам нужно:867Используйте [потоковый ввод](/docs/ru/agent-sdk/streaming-vs-single-mode) когда вам нужно:

868 868 

869* **Прервать агента в середине задачи**: отправить сигнал отмены или изменить направление, пока Claude работает869* **Прервать агента в середине задачи**: отправить сигнал отмены или изменить направление, пока Claude работает

870* **Предоставить дополнительный контекст**: добавить информацию, которая нужна Claude, без ожидания, пока он спросит870* **Предоставить дополнительный контекст**: добавить информацию, которая нужна Claude, без ожидания, пока он спросит


876 Пользовательские инструменты876 Пользовательские инструменты

877</h3>877</h3>

878 878 

879Используйте [пользовательские инструменты](/ru/agent-sdk/custom-tools) когда вам нужно:879Используйте [пользовательские инструменты](/docs/ru/agent-sdk/custom-tools) когда вам нужно:

880 880 

881* **Собрать структурированный ввод**: создать формы, мастера или многошаговые рабочие процессы, которые выходят за рамки формата множественного выбора `AskUserQuestion`881* **Собрать структурированный ввод**: создать формы, мастера или многошаговые рабочие процессы, которые выходят за рамки формата множественного выбора `AskUserQuestion`

882* **Интегрировать внешние системы одобрения**: подключиться к существующим системам тикетов, рабочих процессов или одобрения882* **Интегрировать внешние системы одобрения**: подключиться к существующим системам тикетов, рабочих процессов или одобрения


888 Связанные ресурсы888 Связанные ресурсы

889</h2>889</h2>

890 890 

891* [Настройка разрешений](/ru/agent-sdk/permissions): установите режимы и правила разрешений891* [Настройка разрешений](/docs/ru/agent-sdk/permissions): установите режимы и правила разрешений

892* [Управление выполнением с помощью hooks](/ru/agent-sdk/hooks): запустите пользовательский код в ключевых точках жизненного цикла агента892* [Управление выполнением с помощью hooks](/docs/ru/agent-sdk/hooks): запустите пользовательский код в ключевых точках жизненного цикла агента

893* [Справочник TypeScript SDK](/ru/agent-sdk/typescript#canusetool): полная документация API canUseTool893* [Справочник TypeScript SDK](/docs/ru/agent-sdk/typescript#canusetool): полная документация API canUseTool

agent-teams.md +30 −30

Details

7> Координируйте несколько экземпляров Claude Code, работающих вместе как команда, с общими задачами, обменом сообщениями между агентами и централизованным управлением.7> Координируйте несколько экземпляров Claude Code, работающих вместе как команда, с общими задачами, обменом сообщениями между агентами и централизованным управлением.

8 8 

9<Warning>9<Warning>

10 Команды агентов являются экспериментальными и отключены по умолчанию. Включите их, добавив `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` в ваш [settings.json](/ru/settings) или переменную окружения. Без этой переменной команда не будет установлена при запуске сеанса, директории команды не будут созданы, и Claude не будет создавать или предлагать товарищей по команде. Команды агентов имеют [известные ограничения](#limitations) в отношении возобновления сеанса, координации задач и поведения при завершении.10 Команды агентов являются экспериментальными и отключены по умолчанию. Включите их, добавив `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` в ваш [settings.json](/docs/ru/settings) или переменную окружения. Без этой переменной команда не будет установлена при запуске сеанса, директории команды не будут созданы, и Claude не будет создавать или предлагать товарищей по команде. Команды агентов имеют [известные ограничения](#limitations) в отношении возобновления сеанса, координации задач и поведения при завершении.

11</Warning>11</Warning>

12 12 

13Команды агентов позволяют координировать несколько экземпляров Claude Code, работающих вместе. Один сеанс выступает в роли лидера команды, координируя работу, назначая задачи и синтезируя результаты. Товарищи по команде работают независимо, каждый в своем контекстном окне, и общаются друг с другом напрямую.13Команды агентов позволяют координировать несколько экземпляров Claude Code, работающих вместе. Один сеанс выступает в роли лидера команды, координируя работу, назначая задачи и синтезируя результаты. Товарищи по команде работают независимо, каждый в своем контекстном окне, и общаются друг с другом напрямую.

14 14 

15В отличие от [subagents](/ru/sub-agents), которые работают в одном сеансе и могут только докладывать основному агенту, вы также можете взаимодействовать с отдельными товарищами по команде напрямую, не проходя через лидера.15В отличие от [subagents](/docs/ru/sub-agents), которые работают в одном сеансе и могут только докладывать основному агенту, вы также можете взаимодействовать с отдельными товарищами по команде напрямую, не проходя через лидера.

16 16 

17<Note>17<Note>

18 На этой странице описываются команды агентов начиная с версии v2.1.178. Когда установлена переменная `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`, создание товарища по команде больше не требует этапа настройки, и очистка происходит автоматически при выходе из сеанса. До версии v2.1.178 вы просили Claude создать и назвать команду в первую очередь, и Claude использовал инструменты `TeamCreate` и `TeamDelete` для её установки и удаления. Оба инструмента больше не существуют. Входной параметр `team_name` в инструменте Agent принимается, но игнорируется, и поле `team_name` в [полезных нагрузках hook](/ru/hooks#taskcreated) `TaskCreated`, `TaskCompleted` и `TeammateIdle` содержит имя, полученное из сеанса, и является устаревшим.18 На этой странице описываются команды агентов начиная с версии v2.1.178. Когда установлена переменная `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`, создание товарища по команде больше не требует этапа настройки, и очистка происходит автоматически при выходе из сеанса. До версии v2.1.178 вы просили Claude создать и назвать команду в первую очередь, и Claude использовал инструменты `TeamCreate` и `TeamDelete` для её установки и удаления. Оба инструмента больше не существуют. Входной параметр `team_name` в инструменте Agent принимается, но игнорируется, и поле `team_name` в [полезных нагрузках hook](/docs/ru/hooks#taskcreated) `TaskCreated`, `TaskCompleted` и `TeammateIdle` содержит имя, полученное из сеанса, и является устаревшим.

19</Note>19</Note>

20 20 

21<h2 id="when-to-use-agent-teams">21<h2 id="when-to-use-agent-teams">


29* **Отладка с конкурирующими гипотезами**: товарищи по команде тестируют различные теории параллельно и быстрее сходятся на ответе29* **Отладка с конкурирующими гипотезами**: товарищи по команде тестируют различные теории параллельно и быстрее сходятся на ответе

30* **Координация между слоями**: изменения, охватывающие фронтенд, бэкенд и тесты, каждый из которых принадлежит другому товарищу по команде30* **Координация между слоями**: изменения, охватывающие фронтенд, бэкенд и тесты, каждый из которых принадлежит другому товарищу по команде

31 31 

32Команды агентов добавляют накладные расходы на координацию и используют значительно больше токенов, чем один сеанс. Они работают лучше всего, когда товарищи по команде могут работать независимо. Для последовательных задач, редактирования одного файла или работы со множеством зависимостей более эффективны один сеанс или [subagents](/ru/sub-agents).32Команды агентов добавляют накладные расходы на координацию и используют значительно больше токенов, чем один сеанс. Они работают лучше всего, когда товарищи по команде могут работать независимо. Для последовательных задач, редактирования одного файла или работы со множеством зависимостей более эффективны один сеанс или [subagents](/docs/ru/sub-agents).

33 33 

34<h3 id="compare-with-subagents">34<h3 id="compare-with-subagents">

35 Сравнение с subagents35 Сравнение с subagents

36</h3>36</h3>

37 37 

38Как команды агентов, так и [subagents](/ru/sub-agents) позволяют вам распараллелить работу, но они работают по-разному. Выбирайте в зависимости от того, нужны ли вашим работникам общаться друг с другом:38Как команды агентов, так и [subagents](/docs/ru/sub-agents) позволяют вам распараллелить работу, но они работают по-разному. Выбирайте в зависимости от того, нужны ли вашим работникам общаться друг с другом:

39 39 

40<Frame caption="Subagents только докладывают результаты основному агенту и никогда не разговаривают друг с другом. В командах агентов товарищи по команде делят список задач, берут на себя работу и общаются друг с другом напрямую.">40<Frame caption="Subagents только докладывают результаты основному агенту и никогда не разговаривают друг с другом. В командах агентов товарищи по команде делят список задач, берут на себя работу и общаются друг с другом напрямую.">

41 <img src="https://mintcdn.com/claude-code/nsvRFSDNfpSU5nT7/images/subagents-vs-agent-teams-light.png?fit=max&auto=format&n=nsvRFSDNfpSU5nT7&q=85&s=2f8db9b4f3705dd3ab931fbe2d96e42a" className="dark:hidden" alt="Диаграмма, сравнивающая архитектуры subagent и agent team. Subagents порождаются основным агентом, выполняют работу и докладывают результаты. Команды агентов координируют работу через общий список задач, товарищи по команде общаются друг с другом напрямую." width="4245" height="1615" data-path="images/subagents-vs-agent-teams-light.png" />41 <img src="https://mintcdn.com/claude-code/nsvRFSDNfpSU5nT7/images/subagents-vs-agent-teams-light.png?fit=max&auto=format&n=nsvRFSDNfpSU5nT7&q=85&s=2f8db9b4f3705dd3ab931fbe2d96e42a" className="dark:hidden" alt="Диаграмма, сравнивающая архитектуры subagent и agent team. Subagents порождаются основным агентом, выполняют работу и докладывают результаты. Команды агентов координируют работу через общий список задач, товарищи по команде общаются друг с другом напрямую." width="4245" height="1615" data-path="images/subagents-vs-agent-teams-light.png" />


57 Включение команд агентов57 Включение команд агентов

58</h2>58</h2>

59 59 

60Команды агентов отключены по умолчанию. Включите их, установив переменную окружения `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` на `1`, либо в переменной окружения вашей оболочки, либо через [settings.json](/ru/settings):60Команды агентов отключены по умолчанию. Включите их, установив переменную окружения `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` на `1`, либо в переменной окружения вашей оболочки, либо через [settings.json](/docs/ru/settings):

61 61 

62```json settings.json theme={null}62```json settings.json theme={null}

63{63{


81one on UX, one on technical architecture, one playing devil's advocate.81one on UX, one on technical architecture, one playing devil's advocate.

82```82```

83 83 

84После этого Claude заполняет [общий список задач](/ru/interactive-mode#task-list), создает товарищей по команде для каждой перспективы, заставляет их исследовать проблему и синтезирует выводы по завершении.84После этого Claude заполняет [общий список задач](/docs/ru/interactive-mode#task-list), создает товарищей по команде для каждой перспективы, заставляет их исследовать проблему и синтезирует выводы по завершении.

85 85 

86Терминал лидера перечисляет товарищей по команде на панели агентов ниже поля ввода запроса. На панели:86Терминал лидера перечисляет товарищей по команде на панели агентов ниже поля ввода запроса. На панели:

87 87 


89* **Enter**: открыть стенограмму выбранного товарища по команде и отправить ему сообщение напрямую89* **Enter**: открыть стенограмму выбранного товарища по команде и отправить ему сообщение напрямую

90* **Escape**: прервать текущий ход выбранного товарища по команде90* **Escape**: прервать текущий ход выбранного товарища по команде

91 91 

92{/* min-version: 2.1.199 */}Начиная с версии 2.1.199, строка неактивного товарища по команде остается на панели, пока работает любой товарищ по команде или подагент, поэтому вы можете выбрать его для просмотра его стенограммы или отправить ему дополнительную работу. Когда каждый агент на панели неактивен, неактивные строки скрываются через 30 секунд и снова появляются при следующем ходе товарища по команде; товарищ по команде продолжает работать и остается доступным, пока скрыт. В версиях 2.1.181–2.1.198 неактивная строка скрывалась через 30 секунд после завершения собственного хода, даже если другие товарищи по команде все еще работали; неактивные строки не скрываются в версиях до 2.1.181.92Начиная с версии 2.1.199, строка неактивного товарища по команде остается на панели, пока работает любой товарищ по команде или подагент, поэтому вы можете выбрать его для просмотра его стенограммы или отправить ему дополнительную работу. Когда каждый агент на панели неактивен, неактивные строки скрываются через 30 секунд и снова появляются при следующем ходе товарища по команде; товарищ по команде продолжает работать и остается доступным, пока скрыт. В версиях 2.1.181–2.1.198 неактивная строка скрывалась через 30 секунд после завершения собственного хода, даже если другие товарищи по команде все еще работали; неактивные строки не скрываются в версиях до 2.1.181.

93 93 

94Когда более трех товарищей по команде неактивны одновременно, строки, выходящие за пределы первых трех, сворачиваются в одну строку, которая подсчитывает свернутых товарищей по команде, например `2 idle agents` когда пять неактивны. Выберите его и нажмите Enter для развертывания свернутых строк, или нажмите Esc для их свертывания снова. Работающие товарищи по команде, неудачные товарищи по команде и товарищ по команде, который вы просматриваете, всегда сохраняют свои собственные строки.94Когда более трех товарищей по команде неактивны одновременно, строки, выходящие за пределы первых трех, сворачиваются в одну строку, которая подсчитывает свернутых товарищей по команде, например `2 idle agents` когда пять неактивны. Выберите его и нажмите Enter для развертывания свернутых строк, или нажмите Esc для их свертывания снова. Работающие товарищи по команде, неудачные товарищи по команде и товарищ по команде, который вы просматриваете, всегда сохраняют свои собственные строки.

95 95 


116 116 

117По умолчанию используется `"in-process"`. До версии v2.1.179 по умолчанию было `"auto"`, поэтому обновленные сеансы, которые ранее открывали разделенные панели, теперь остаются в одном терминале, если вы не установите режим явно. Установите `"auto"` для включения разделенных панелей, когда вы уже работаете внутри сеанса tmux или ваш терминал — это iTerm2 с установленным CLI `it2`, в противном случае используется in-process. Параметр `"tmux"` включает режим разделенных панелей и автоматически определяет, использовать ли tmux или iTerm2 на основе вашего терминала.117По умолчанию используется `"in-process"`. До версии v2.1.179 по умолчанию было `"auto"`, поэтому обновленные сеансы, которые ранее открывали разделенные панели, теперь остаются в одном терминале, если вы не установите режим явно. Установите `"auto"` для включения разделенных панелей, когда вы уже работаете внутри сеанса tmux или ваш терминал — это iTerm2 с установленным CLI `it2`, в противном случае используется in-process. Параметр `"tmux"` включает режим разделенных панелей и автоматически определяет, использовать ли tmux или iTerm2 на основе вашего терминала.

118 118 

119{/* min-version: 2.1.186 */}Начиная с версии v2.1.186, установите `"iterm2"` для явного использования встроенных разделенных панелей iTerm2. Этот режим требует [`it2` CLI](https://github.com/mkusaka/it2) и показывает ошибку с командой установки, если `it2` отсутствует. Подсказка настройки, которая предлагает установить `it2` или переключиться на tmux, появляется при `"auto"` или `"tmux"`, когда ваш терминал — это iTerm2 и tmux доступен как резервный вариант.119Начиная с версии v2.1.186, установите `"iterm2"` для явного использования встроенных разделенных панелей iTerm2. Этот режим требует [`it2` CLI](https://github.com/mkusaka/it2) и показывает ошибку с командой установки, если `it2` отсутствует. Подсказка настройки, которая предлагает установить `it2` или переключиться на tmux, появляется при `"auto"` или `"tmux"`, когда ваш терминал — это iTerm2 и tmux доступен как резервный вариант.

120 120 

121Чтобы переопределить значение по умолчанию, установите [`teammateMode`](/ru/settings#available-settings) в `~/.claude/settings.json`:121Чтобы переопределить значение по умолчанию, установите [`teammateMode`](/docs/ru/settings#available-settings) в `~/.claude/settings.json`:

122 122 

123```json theme={null}123```json theme={null}

124{124{


150 150 

151Товарищи по команде не наследуют выбор `/model` лидера по умолчанию. Чтобы изменить модель, используемую, когда подсказка не указывает одну, установите **Default teammate model** в `/config`. Выберите **Default (leader's model)**, чтобы товарищи по команде следовали текущей модели лидера.151Товарищи по команде не наследуют выбор `/model` лидера по умолчанию. Чтобы изменить модель, используемую, когда подсказка не указывает одну, установите **Default teammate model** в `/config`. Выберите **Default (leader's model)**, чтобы товарищи по команде следовали текущей модели лидера.

152 152 

153{/* min-version: 2.1.186 */}Товарищи по команде наследуют [уровень усилий](/ru/model-config#adjust-effort-level) лидера. В режиме split-pane это применяется с версии v2.1.186; более ранние версии не передавали уровень усилий сеанса лидера товарищам по команде в режиме split-pane.153Товарищи по команде наследуют [уровень усилий](/docs/ru/model-config#adjust-effort-level) лидера. В режиме split-pane это применяется с версии v2.1.186; более ранние версии не передавали уровень усилий сеанса лидера товарищам по команде в режиме split-pane.

154 154 

155<h3 id="require-plan-approval-for-teammates">155<h3 id="require-plan-approval-for-teammates">

156 Требуйте одобрения плана для товарищей по команде156 Требуйте одобрения плана для товарищей по команде


176* **Режим in-process**: используйте клавиши со стрелками вверх и вниз в панели агента для выбора товарища по команде, затем нажмите Enter для просмотра его сеанса и введите сообщение для отправки ему. Нажмите `x` на выбранном товарище по команде для его остановки. Нажмите Ctrl+T для переключения списка задач.176* **Режим in-process**: используйте клавиши со стрелками вверх и вниз в панели агента для выбора товарища по команде, затем нажмите Enter для просмотра его сеанса и введите сообщение для отправки ему. Нажмите `x` на выбранном товарище по команде для его остановки. Нажмите Ctrl+T для переключения списка задач.

177* **Режим split-pane**: щелкните в панель товарища по команде для прямого взаимодействия с его сеансом. Каждый товарищ по команде имеет полный вид своего собственного терминала.177* **Режим split-pane**: щелкните в панель товарища по команде для прямого взаимодействия с его сеансом. Каждый товарищ по команде имеет полный вид своего собственного терминала.

178 178 

179Пока вы просматриваете товарища по команде в режиме in-process, простой текст и [skills](/ru/skills) идут этому товарищу по команде, но встроенные команды все еще работают в сеансе лидера.179Пока вы просматриваете товарища по команде в режиме in-process, простой текст и [skills](/docs/ru/skills) идут этому товарищу по команде, но встроенные команды все еще работают в сеансе лидера.

180 180 

181Модель товарища по команде и режим быстрого выполнения фиксируются при его порождении, поэтому `/model` и `/fast` изменяют только параметры лидера. {/* min-version: 2.1.199 */}Начиная с версии v2.1.199, ввод любой из этих команд при просмотре товарища по команде показывает уведомление о том, что изменение применяется к лидеру; более ранние версии применяли его к лидеру без указания. `/effort` все еще применяется к последующим ходам просматриваемого товарища по команде, потому что товарищи по команде следуют [уровню усилий](/ru/model-config#adjust-effort-level) лидера.181Модель товарища по команде и режим быстрого выполнения фиксируются при его порождении, поэтому `/model` и `/fast` изменяют только параметры лидера. Начиная с версии v2.1.199, ввод любой из этих команд при просмотре товарища по команде показывает уведомление о том, что изменение применяется к лидеру; более ранние версии применяли его к лидеру без указания. `/effort` все еще применяется к последующим ходам просматриваемого товарища по команде, потому что товарищи по команде следуют [уровню усилий](/docs/ru/model-config#adjust-effort-level) лидера.

182 182 

183<h3 id="assign-and-claim-tasks">183<h3 id="assign-and-claim-tasks">

184 Назначение и взятие задач184 Назначение и взятие задач


211 Обеспечение качества с помощью hooks211 Обеспечение качества с помощью hooks

212</h3>212</h3>

213 213 

214Используйте [hooks](/ru/hooks) для обеспечения правил, когда товарищи по команде заканчивают работу или задачи создаются или завершаются:214Используйте [hooks](/docs/ru/hooks) для обеспечения правил, когда товарищи по команде заканчивают работу или задачи создаются или завершаются:

215 215 

216* [`TeammateIdle`](/ru/hooks#teammateidle): запускается, когда товарищ по команде собирается перейти в режим ожидания. Выйдите с кодом 2, чтобы отправить обратную связь и продолжить работу товарища по команде.216* [`TeammateIdle`](/docs/ru/hooks#teammateidle): запускается, когда товарищ по команде собирается перейти в режим ожидания. Выйдите с кодом 2, чтобы отправить обратную связь и продолжить работу товарища по команде.

217* [`TaskCreated`](/ru/hooks#taskcreated): запускается, когда задача создается. Выйдите с кодом 2, чтобы предотвратить создание и отправить обратную связь.217* [`TaskCreated`](/docs/ru/hooks#taskcreated): запускается, когда задача создается. Выйдите с кодом 2, чтобы предотвратить создание и отправить обратную связь.

218* [`TaskCompleted`](/ru/hooks#taskcompleted): запускается, когда задача отмечается как завершенная. Выйдите с кодом 2, чтобы предотвратить завершение и отправить обратную связь.218* [`TaskCompleted`](/docs/ru/hooks#taskcompleted): запускается, когда задача отмечается как завершенная. Выйдите с кодом 2, чтобы предотвратить завершение и отправить обратную связь.

219 219 

220<h2 id="how-agent-teams-work">220<h2 id="how-agent-teams-work">

221 Как работают команды агентов221 Как работают команды агентов


258* **Конфигурация команды**: `~/.claude/teams/{team-name}/config.json`258* **Конфигурация команды**: `~/.claude/teams/{team-name}/config.json`

259* **Список задач**: `~/.claude/tasks/{team-name}/`259* **Список задач**: `~/.claude/tasks/{team-name}/`

260 260 

261Claude Code генерирует оба этих файла автоматически при запуске сеанса и обновляет их по мере присоединения товарищей по команде, перехода в режим ожидания или ухода. Директория конфигурации команды удаляется при завершении сеанса. Директория списка задач сохраняется локально и никогда не загружается, поэтому возобновленные сеансы сохраняют свои задачи. Хранение управляется тем же [`cleanupPeriodDays`](/ru/settings#available-settings), который вы уже контролируете для стенограмм сеансов.261Claude Code генерирует оба этих файла автоматически при запуске сеанса и обновляет их по мере присоединения товарищей по команде, перехода в режим ожидания или ухода. Директория конфигурации команды удаляется при завершении сеанса. Директория списка задач сохраняется локально и никогда не загружается, поэтому возобновленные сеансы сохраняют свои задачи. Хранение управляется тем же [`cleanupPeriodDays`](/docs/ru/settings#available-settings), который вы уже контролируете для стенограмм сеансов.

262 262 

263Конфигурация команды содержит состояние выполнения, такое как ID сеансов и ID панелей tmux, поэтому не редактируйте ее вручную и не создавайте предварительно: ваши изменения будут перезаписаны при следующем обновлении состояния.263Конфигурация команды содержит состояние выполнения, такое как ID сеансов и ID панелей tmux, поэтому не редактируйте ее вручную и не создавайте предварительно: ваши изменения будут перезаписаны при следующем обновлении состояния.

264 264 


272 Использование определений subagent для товарищей по команде272 Использование определений subagent для товарищей по команде

273</h3>273</h3>

274 274 

275При порождении товарища по команде вы можете ссылаться на тип [subagent](/ru/sub-agents) из любой [области subagent](/ru/sub-agents#choose-the-subagent-scope): проект, пользователь, плагин или определенный CLI. Это позволяет вам определить роль один раз, такую как security-reviewer или test-runner, и переиспользовать ее как делегированный subagent и как товарища по команде в команде агентов.275При порождении товарища по команде вы можете ссылаться на тип [subagent](/docs/ru/sub-agents) из любой [области subagent](/docs/ru/sub-agents#choose-the-subagent-scope): проект, пользователь, плагин или определенный CLI. Это позволяет вам определить роль один раз, такую как security-reviewer или test-runner, и переиспользовать ее как делегированный subagent и как товарища по команде в команде агентов.

276 276 

277Чтобы использовать определение subagent, упомяните его по имени при просьбе Claude порождать товарища по команде:277Чтобы использовать определение subagent, упомяните его по имени при просьбе Claude порождать товарища по команде:

278 278 


292 292 

293Товарищи по команде начинают с параметров разрешений лидера. Если лидер работает с `--dangerously-skip-permissions`, все товарищи по команде тоже. После порождения вы можете изменить отдельные режимы товарищей по команде, но вы не можете установить режимы для отдельных товарищей по команде во время порождения.293Товарищи по команде начинают с параметров разрешений лидера. Если лидер работает с `--dangerously-skip-permissions`, все товарищи по команде тоже. После порождения вы можете изменить отдельные режимы товарищей по команде, но вы не можете установить режимы для отдельных товарищей по команде во время порождения.

294 294 

295Когда один агент отправляет другому сообщение через `SendMessage`, получающему агенту сообщается, что оно пришло от другого сеанса Claude, а не от вас. Товарищ по команде не может одобрить запрос разрешения или дать согласие от вашего имени, и товарищ по команде, которому было отказано в действии, не может передать его другому товарищу по команде, чтобы обойти проверку. В [автоматическом режиме](/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор рассматривает утверждение об одобрении, переданное от другого агента, как недоверенный ввод, а не подтверждение от вас.295Когда один агент отправляет другому сообщение через `SendMessage`, получающему агенту сообщается, что оно пришло от другого сеанса Claude, а не от вас. Товарищ по команде не может одобрить запрос разрешения или дать согласие от вашего имени, и товарищ по команде, которому было отказано в действии, не может передать его другому товарищу по команде, чтобы обойти проверку. В [автоматическом режиме](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор рассматривает утверждение об одобрении, переданное от другого агента, как недоверенный ввод, а не подтверждение от вас.

296 296 

297Запросы разрешений товарищей по команде появляются в основном сеансе, поэтому одобрите их там сами. [Требование одобрения плана](#require-plan-approval-for-teammates) — это предусмотренное исключение: основной сеанс предоставляет одобрения плана товарищей по команде без отдельного запроса к вам.297Запросы разрешений товарищей по команде появляются в основном сеансе, поэтому одобрите их там сами. [Требование одобрения плана](#require-plan-approval-for-teammates) — это предусмотренное исключение: основной сеанс предоставляет одобрения плана товарищей по команде без отдельного запроса к вам.

298 298 


305**Как товарищи по команде делятся информацией:**305**Как товарищи по команде делятся информацией:**

306 306 

307* **Автоматическая доставка сообщений**: когда товарищи по команде отправляют сообщения, они автоматически доставляются получателям. Лидеру не нужно опрашивать обновления.307* **Автоматическая доставка сообщений**: когда товарищи по команде отправляют сообщения, они автоматически доставляются получателям. Лидеру не нужно опрашивать обновления.

308* **Уведомления о неактивности**: когда товарищ по команде заканчивает и останавливается, он автоматически уведомляет лидера. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, товарищ по команде, чей ход заканчивается на ошибке API, уведомляет лидера о том, что он не удался, и включает текст ошибки, вместо того чтобы казаться нормально завершившимся.308* **Уведомления о неактивности**: когда товарищ по команде заканчивает и останавливается, он автоматически уведомляет лидера. Начиная с версии 2.1.198, товарищ по команде, чей ход заканчивается на ошибке API, уведомляет лидера о том, что он не удался, и включает текст ошибки, вместо того чтобы казаться нормально завершившимся.

309* **Общий список задач**: все агенты могут видеть статус задачи и брать доступную работу.309* **Общий список задач**: все агенты могут видеть статус задачи и брать доступную работу.

310* **Обмен сообщениями товарищей по команде**: отправить сообщение одному конкретному товарищу по команде по имени. Чтобы достичь всех, отправьте одно сообщение на получателя.310* **Обмен сообщениями товарищей по команде**: отправить сообщение одному конкретному товарищу по команде по имени. Чтобы достичь всех, отправьте одно сообщение на получателя.

311 311 


315 Использование токенов315 Использование токенов

316</h3>316</h3>

317 317 

318Команды агентов используют значительно больше токенов, чем один сеанс. Каждый товарищ по команде имеет свое собственное контекстное окно, и использование токенов масштабируется с количеством активных товарищей по команде. Для исследования, проверки и работы над новыми функциями дополнительные токены обычно стоят того. Для рутинных задач один сеанс более экономичен. См. [стоимость токенов команды агентов](/ru/costs#agent-team-token-costs) для руководства по использованию.318Команды агентов используют значительно больше токенов, чем один сеанс. Каждый товарищ по команде имеет свое собственное контекстное окно, и использование токенов масштабируется с количеством активных товарищей по команде. Для исследования, проверки и работы над новыми функциями дополнительные токены обычно стоят того. Для рутинных задач один сеанс более экономичен. См. [стоимость токенов команды агентов](/docs/ru/costs#agent-team-token-costs) для руководства по использованию.

319 319 

320<h2 id="use-case-examples">320<h2 id="use-case-examples">

321 Примеры вариантов использования321 Примеры вариантов использования


379 379 

380Нет жесткого ограничения на количество товарищей по команде, но применяются практические ограничения:380Нет жесткого ограничения на количество товарищей по команде, но применяются практические ограничения:

381 381 

382* **Стоимость токенов масштабируется линейно**: каждый товарищ по команде имеет свое собственное контекстное окно и потребляет токены независимо. См. [стоимость токенов команды агентов](/ru/costs#agent-team-token-costs) для деталей.382* **Стоимость токенов масштабируется линейно**: каждый товарищ по команде имеет свое собственное контекстное окно и потребляет токены независимо. См. [стоимость токенов команды агентов](/docs/ru/costs#agent-team-token-costs) для деталей.

383* **Накладные расходы на координацию увеличиваются**: больше товарищей по команде означает больше коммуникации, координации задач и потенциал для конфликтов383* **Накладные расходы на координацию увеличиваются**: больше товарищей по команде означает больше коммуникации, координации задач и потенциал для конфликтов

384* **Убывающая отдача**: сверх определенной точки дополнительные товарищи по команде не ускоряют работу пропорционально384* **Убывающая отдача**: сверх определенной точки дополнительные товарищи по команде не ускоряют работу пропорционально

385 385 

386Начните с 3-5 товарищей по команде для большинства рабочих процессов. Это уравновешивает параллельную работу с управляемой координацией. Примеры в этом руководстве используют 3-5 товарищей по команде, потому что этот диапазон хорошо работает для различных типов задач.386Начните с 3-5 товарищей по команде для большинства рабочих процессов. Это уравновешивает параллельную работу с управляемой координацией. Примеры в этом руководстве используют 3-5 товарищей по команде, потому что этот диапазон хорошо работает для различных типов задач.

387 387 

388Наличие 5-6 [задач](/ru/agent-teams#architecture) на товарища по команде держит всех продуктивными без чрезмерного переключения контекста. Если у вас есть 15 независимых задач, 3 товарища по команде — хорошая отправная точка.388Наличие 5-6 [задач](/docs/ru/agent-teams#architecture) на товарища по команде держит всех продуктивными без чрезмерного переключения контекста. Если у вас есть 15 независимых задач, 3 товарища по команде — хорошая отправная точка.

389 389 

390Масштабируйте только когда работа действительно выигрывает от одновременной работы товарищей по команде. Три сосредоточенных товарища по команде часто превосходят пять рассеянных.390Масштабируйте только когда работа действительно выигрывает от одновременной работы товарищей по команде. Три сосредоточенных товарища по команде часто превосходят пять рассеянных.

391 391 


452 Слишком много запросов разрешений452 Слишком много запросов разрешений

453</h3>453</h3>

454 454 

455Запросы разрешений товарищей по команде всплывают к лидеру, что может создать трение. Предварительно одобрите общие операции в ваших [параметрах разрешений](/ru/permissions) перед порождением товарищей по команде, чтобы уменьшить прерывания.455Запросы разрешений товарищей по команде всплывают к лидеру, что может создать трение. Предварительно одобрите общие операции в ваших [параметрах разрешений](/docs/ru/permissions) перед порождением товарищей по команде, чтобы уменьшить прерывания.

456 456 

457<h3 id="teammates-stopping-on-errors">457<h3 id="teammates-stopping-on-errors">

458 Товарищи по команде останавливаются при ошибках458 Товарищи по команде останавливаются при ошибках


463* Дайте им дополнительные инструкции напрямую463* Дайте им дополнительные инструкции напрямую

464* Порождите товарища по команде-замену для продолжения работы464* Порождите товарища по команде-замену для продолжения работы

465 465 

466{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, сообщение от лидера или другого товарища по команде пробуждает товарища по команде в режиме in-process, который ожидает повтора неудачного запроса API, поэтому он повторяет попытку немедленно вместо ожидания полной задержки повтора.466Начиная с версии 2.1.198, сообщение от лидера или другого товарища по команде пробуждает товарища по команде в режиме in-process, который ожидает повтора неудачного запроса API, поэтому он повторяет попытку немедленно вместо ожидания полной задержки повтора.

467 467 

468<h3 id="lead-shuts-down-before-work-is-done">468<h3 id="lead-shuts-down-before-work-is-done">

469 Лидер завершает работу до завершения работы469 Лидер завершает работу до завершения работы


493* **Завершение может быть медленным**: товарищи по команде завершают свой текущий запрос или вызов инструмента перед завершением, что может занять время.493* **Завершение может быть медленным**: товарищи по команде завершают свой текущий запрос или вызов инструмента перед завершением, что может занять время.

494* **Одна команда на сеанс**: сеанс имеет ровно одну команду, ограниченную этим сеансом. Вы не можете создавать дополнительные именованные команды или делиться командой между сеансами.494* **Одна команда на сеанс**: сеанс имеет ровно одну команду, ограниченную этим сеансом. Вы не можете создавать дополнительные именованные команды или делиться командой между сеансами.

495* **Нет вложенных команд**: товарищи по команде не могут порождать своих собственных товарищей по команде. Только лидер может управлять командой.495* **Нет вложенных команд**: товарищи по команде не могут порождать своих собственных товарищей по команде. Только лидер может управлять командой.

496* **Нет фоновых подагентов от товарищей по команде in-process**: собственные подагенты товарища по команде in-process работают на переднем плане. Запрос фонового подагента, будь то с помощью `run_in_background` или определения подагента, которое устанавливает `background: true`, возвращает ошибку, потому что фоновая работа товарища по команде не может пережить процесс лидера. Подагенты, запущенные из основного разговора, следуют [фоновому значению по умолчанию](/ru/sub-agents#run-subagents-in-foreground-or-background).496* **Нет фоновых подагентов от товарищей по команде in-process**: собственные подагенты товарища по команде in-process работают на переднем плане. Запрос фонового подагента, будь то с помощью `run_in_background` или определения подагента, которое устанавливает `background: true`, возвращает ошибку, потому что фоновая работа товарища по команде не может пережить процесс лидера. Подагенты, запущенные из основного разговора, следуют [фоновому значению по умолчанию](/docs/ru/sub-agents#run-subagents-in-foreground-or-background).

497* **Лидер фиксирован**: основной сеанс является лидером на протяжении всей его жизни. Вы не можете повысить товарища по команде до лидера или передать лидерство.497* **Лидер фиксирован**: основной сеанс является лидером на протяжении всей его жизни. Вы не можете повысить товарища по команде до лидера или передать лидерство.

498* **Разрешения установлены при порождении**: все товарищи по команде начинают с режима разрешений лидера. Вы можете изменить отдельные режимы товарищей по команде после порождения, но вы не можете установить режимы для отдельных товарищей по команде во время порождения.498* **Разрешения установлены при порождении**: все товарищи по команде начинают с режима разрешений лидера. Вы можете изменить отдельные режимы товарищей по команде после порождения, но вы не можете установить режимы для отдельных товарищей по команде во время порождения.

499* **Разделенные панели требуют tmux или iTerm2**: режим in-process по умолчанию работает в любом терминале. Режим разделенных панелей не поддерживается в интегрированном терминале VS Code, Windows Terminal или Ghostty.499* **Разделенные панели требуют tmux или iTerm2**: режим in-process по умолчанию работает в любом терминале. Режим разделенных панелей не поддерживается в интегрированном терминале VS Code, Windows Terminal или Ghostty.


508 508 

509Изучите связанные подходы для параллельной работы и делегирования:509Изучите связанные подходы для параллельной работы и делегирования:

510 510 

511* **Легкое делегирование**: [subagents](/ru/sub-agents) порождают вспомогательных агентов для исследования или проверки в вашем сеансе, лучше для задач, которые не нуждаются в координации между агентами511* **Легкое делегирование**: [subagents](/docs/ru/sub-agents) порождают вспомогательных агентов для исследования или проверки в вашем сеансе, лучше для задач, которые не нуждаются в координации между агентами

512* **Ручные параллельные сеансы**: [Git worktrees](/ru/worktrees) позволяют вам запускать несколько сеансов Claude Code самостоятельно без автоматической координации команды512* **Ручные параллельные сеансы**: [Git worktrees](/docs/ru/worktrees) позволяют вам запускать несколько сеансов Claude Code самостоятельно без автоматической координации команды

513* **Сравнение подходов**: см. [сравнение subagent vs agent team](/ru/features-overview#compare-similar-features) для разбора рядом513* **Сравнение подходов**: см. [сравнение subagent vs agent team](/docs/ru/features-overview#compare-similar-features) для разбора рядом

agent-view.md +87 −87

Details

16 16 

17Когда вы хотите работать более непосредственно в сеансе любого агента, подключитесь к строке, чтобы войти в полную беседу.17Когда вы хотите работать более непосредственно в сеансе любого агента, подключитесь к строке, чтобы войти в полную беседу.

18 18 

19Для сравнения agent view с subagents, agent teams и worktrees см. [Запуск агентов параллельно](/ru/agents).19Для сравнения agent view с subagents, agent teams и worktrees см. [Запуск агентов параллельно](/docs/ru/agents).

20 20 

21<Note>21<Note>

22 Agent view находится в исследовательском предпросмотре и требует Claude Code v2.1.139 или позже. Проверьте вашу версию с помощью `claude --version`. Интерфейс и сочетания клавиш могут измениться по мере развития функции.22 Agent view находится в исследовательском предпросмотре и требует Claude Code v2.1.139 или позже. Проверьте вашу версию с помощью `claude --version`. Интерфейс и сочетания клавиш могут измениться по мере развития функции.


70 70 

71Вы можете использовать `claude agents` как основную точку входа вместо `claude`: отправляйте каждую задачу из agent view, подключайтесь, когда вам нужна полная беседа, и нажимайте `←` для возврата к таблице.71Вы можете использовать `claude agents` как основную точку входа вместо `claude`: отправляйте каждую задачу из agent view, подключайтесь, когда вам нужна полная беседа, и нажимайте `←` для возврата к таблице.

72 72 

73{/* min-version: 2.1.205 */}Внутри обычного сеанса `claude` подсказка в нижнем колонтитуле `←` показывает количество фоновых агентов, которые ждут вас, например `← 2 agents`, и возвращается к `← for agents`, когда никто не требует ввода. Количество выше 99 отображается как `99+`. Количество обновляется примерно каждые десять секунд, пока терминал в фокусе, и немедленно, когда фокус возвращается. Оно кратко меняет цвет при изменении и при завершении агента, если только параметр [`prefersReducedMotion`](/ru/settings#available-settings) не включен, и оно скрыто в [режиме чтения с экрана](/ru/accessibility). На [Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry](/ru/third-party-integrations) подсказка остаётся в простой форме `← for agents` без количества. Требуется Claude Code v2.1.205 или позже.73Внутри обычного сеанса `claude` подсказка в нижнем колонтитуле `←` показывает количество фоновых агентов, которые ждут вас, например `← 2 agents`, и возвращается к `← for agents`, когда никто не требует ввода. Количество выше 99 отображается как `99+`. Количество обновляется примерно каждые десять секунд, пока терминал в фокусе, и немедленно, когда фокус возвращается. Оно кратко меняет цвет при изменении и при завершении агента, если только параметр [`prefersReducedMotion`](/docs/ru/settings#available-settings) не включен, и оно скрыто в [режиме чтения с экрана](/docs/ru/accessibility). На [Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry](/docs/ru/third-party-integrations) подсказка остаётся в простой форме `← for agents` без количества. Требуется Claude Code v2.1.205 или позже.

74 74 

75<h2 id="monitor-sessions-with-agent-view">75<h2 id="monitor-sessions-with-agent-view">

76 Мониторинг сеансов с помощью agent view76 Мониторинг сеансов с помощью agent view


78 78 

79Запустите `claude agents` для открытия agent view. Он захватывает весь терминал и перечисляет каждый сеанс, сгруппированный по состоянию, с закреплёнными сеансами и теми, которые требуют вас в верхней части. Каждая строка показывает имя сеанса, текущую активность и его возраст, отсчитываемый с момента создания сеанса; возраст завершённого сеанса замораживается на время выполнения.79Запустите `claude agents` для открытия agent view. Он захватывает весь терминал и перечисляет каждый сеанс, сгруппированный по состоянию, с закреплёнными сеансами и теми, которые требуют вас в верхней части. Каждая строка показывает имя сеанса, текущую активность и его возраст, отсчитываемый с момента создания сеанса; возраст завершённого сеанса замораживается на время выполнения.

80 80 

81Имя окрашено цветом, установленным с помощью [`/color`](/ru/commands) в этом сеансе. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, цвет сохраняется, когда вы [отправляете сеанс в фон](#from-inside-a-session) с помощью `←` или `/background`.81Имя окрашено цветом, установленным с помощью [`/color`](/docs/ru/commands) в этом сеансе. Начиная с версии 2.1.199, цвет сохраняется, когда вы [отправляете сеанс в фон](#from-inside-a-session) с помощью `←` или `/background`.

82 82 

83По умолчанию список показывает каждый фоновый сеанс, который вы запустили, во всех ваших проектах. Сеанс, работающий в одном репозитории, и другой в другом worktree, оба появляются здесь, независимо от того, из какого каталога вы открыли agent view. Чтобы ограничить список одним проектом, передайте `--cwd`:83По умолчанию список показывает каждый фоновый сеанс, который вы запустили, во всех ваших проектах. Сеанс, работающий в одном репозитории, и другой в другом worktree, оба появляются здесь, независимо от того, из какого каталога вы открыли agent view. Чтобы ограничить список одним проектом, передайте `--cwd`:

84 84 


88 88 

89Это показывает только сеансы, запущенные в этом каталоге. Сеанс, который [переместился в worktree](#how-file-edits-are-isolated) под `~/projects/my-app/.claude/worktrees/`, всё ещё считается принадлежащим `~/projects/my-app`.89Это показывает только сеансы, запущенные в этом каталоге. Сеанс, который [переместился в worktree](#how-file-edits-are-isolated) под `~/projects/my-app/.claude/worktrees/`, всё ещё считается принадлежащим `~/projects/my-app`.

90 90 

91Интерактивные сеансы, открытые в других терминалах, не появляются до тех пор, пока вы не [отправите их в фон](#from-inside-a-session). [Subagents](/ru/sub-agents) и [teammates](/ru/agent-teams), которых порождает сеанс, не указаны как отдельные строки.91Интерактивные сеансы, открытые в других терминалах, не появляются до тех пор, пока вы не [отправите их в фон](#from-inside-a-session). [Subagents](/docs/ru/sub-agents) и [teammates](/docs/ru/agent-teams), которых порождает сеанс, не указаны как отдельные строки.

92 92 

93```text theme={null}93```text theme={null}

94Pinned94Pinned


131| :------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------- |131| :------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------- |

132| `✻` или анимированный `✽` | Процесс сеанса активен и отвечает немедленно |132| `✻` или анимированный `✽` | Процесс сеанса активен и отвечает немедленно |

133| `∙` | Процесс завершился. Вы всё ещё можете просмотреть, ответить или подключиться, и Claude перезапускается с того места, где он остановился |133| `∙` | Процесс завершился. Вы всё ещё можете просмотреть, ответить или подключиться, и Claude перезапускается с того места, где он остановился |

134| `✢` | Сеанс [`/loop`](/ru/scheduled-tasks), спящий между итерациями. Строка показывает количество запусков и обратный отсчёт |134| `✢` | Сеанс [`/loop`](/docs/ru/scheduled-tasks), спящий между итерациями. Строка показывает количество запусков и обратный отсчёт |

135 135 

136Метка `#N`, которая может появиться в правом краю строки, является [pull request, который открыл сеанс](#pull-request-status), а не частью значка состояния.136Метка `#N`, которая может появиться в правом краю строки, является [pull request, который открыл сеанс](#pull-request-status), а не частью значка состояния.

137 137 

138Заголовок вкладки терминала показывает количество ожидающих ввода, пока agent view открыт: `2 awaiting input · claude agents`, когда сеансы требуют ввода, или `claude agents`, когда они не требуют.138Заголовок вкладки терминала показывает количество ожидающих ввода, пока agent view открыт: `2 awaiting input · claude agents`, когда сеансы требуют ввода, или `claude agents`, когда они не требуют.

139 139 

140Начиная с версии 2.1.198, пока agent view открыт, Claude Code также отправляет уведомление через ваш настроенный [канал уведомлений терминала](/ru/terminal-config#get-a-terminal-bell-or-notification), когда локальный фоновый сеанс начинает требовать вашего ввода, завершается или не работает. Сеансы, которые работают по расписанию, такие как сеансы [`/loop`](/ru/scheduled-tasks), уведомляют только когда они требуют вашего ввода. Уведомления используют тот же параметр [`preferredNotifChannel`](/ru/settings#available-settings), что и остальная часть Claude Code, и запускают hook [`Notification`](/ru/hooks#notification) с типом `agent_needs_input` или `agent_completed`.140Начиная с версии 2.1.198, пока agent view открыт, Claude Code также отправляет уведомление через ваш настроенный [канал уведомлений терминала](/docs/ru/terminal-config#get-a-terminal-bell-or-notification), когда локальный фоновый сеанс начинает требовать вашего ввода, завершается или не работает. Сеансы, которые работают по расписанию, такие как сеансы [`/loop`](/docs/ru/scheduled-tasks), уведомляют только когда они требуют вашего ввода. Уведомления используют тот же параметр [`preferredNotifChannel`](/docs/ru/settings#available-settings), что и остальная часть Claude Code, и запускают hook [`Notification`](/docs/ru/hooks#notification) с типом `agent_needs_input` или `agent_completed`.

141 141 

142Фоновые сеансы не требуют открытого терминала для продолжения работы. Отдельный [процесс супервизора](#the-supervisor-process) их запускает, поэтому вы можете закрыть agent view, закрыть оболочку или запустить новый интерактивный сеанс, и ваша отправленная работа продолжает выполняться.142Фоновые сеансы не требуют открытого терминала для продолжения работы. Отдельный [процесс супервизора](#the-supervisor-process) их запускает, поэтому вы можете закрыть agent view, закрыть оболочку или запустить новый интерактивный сеанс, и ваша отправленная работа продолжает выполняться.

143 143 


149 Резюме строк149 Резюме строк

150</h3>150</h3>

151 151 

152Однострочное резюме в каждой строке генерируется [моделью класса Haiku](/ru/model-config) так, чтобы строка могла сказать вам, что делает сеанс, что ему требуется или что он произвёл, без открытия стенограммы. Пока сеанс активно работает, текст строки обновляется не более одного раза каждые 15 секунд из недавнего вывода самого сеанса без отправки запроса модели, и модель пишет свежее резюме, когда каждый ход заканчивается.152Однострочное резюме в каждой строке генерируется [моделью класса Haiku](/docs/ru/model-config) так, чтобы строка могла сказать вам, что делает сеанс, что ему требуется или что он произвёл, без открытия стенограммы. Пока сеанс активно работает, текст строки обновляется не более одного раза каждые 15 секунд из недавнего вывода самого сеанса без отправки запроса модели, и модель пишет свежее резюме, когда каждый ход заканчивается.

153 153 

154Работающая строка показывает, что говорит сеанс, что он делает, и заблокированная строка показывает вопрос, который он задаёт. Во время длительного хода модель также переписывает резюме примерно раз в минуту, ожидая в два раза дольше после каждой переписи до четырёх минут, поэтому занятая строка не продолжает показывать устаревшее резюме. До версии 2.1.205 работающая строка могла показывать необработанный вызов инструмента вместо отчёта, и сеанс, работающий над параллельными рабочими элементами, показывал счётчик `done/total`, такой как `2/5`, перед текстом.154Работающая строка показывает, что говорит сеанс, что он делает, и заблокированная строка показывает вопрос, который он задаёт. Во время длительного хода модель также переписывает резюме примерно раз в минуту, ожидая в два раза дольше после каждой переписи до четырёх минут, поэтому занятая строка не продолжает показывать устаревшее резюме. До версии 2.1.205 работающая строка могла показывать необработанный вызов инструмента вместо отчёта, и сеанс, работающий над параллельными рабочими элементами, показывал счётчик `done/total`, такой как `2/5`, перед текстом.

155 155 


157 157 

158Когда список [сгруппирован по каталогу](#organize-the-list), резюме открывается с состоянием сеанса как цветное слово, такое как `Needs input · double jump or wall climb?`. При группировке состояния по умолчанию заголовок группы уже называет состояние, поэтому строка показывает только резюме. До версии 2.1.205 строки, сгруппированные по каталогу, не содержали слова состояния.158Когда список [сгруппирован по каталогу](#organize-the-list), резюме открывается с состоянием сеанса как цветное слово, такое как `Needs input · double jump or wall climb?`. При группировке состояния по умолчанию заголовок группы уже называет состояние, поэтому строка показывает только резюме. До версии 2.1.205 строки, сгруппированные по каталогу, не содержали слова состояния.

159 159 

160Ход, весь вывод которого не содержит букв или цифр, такой как сеанс [`/loop`](/ru/scheduled-tasks), который печатает одиночный символ на тихой итерации, сохраняет предыдущее резюме и состояние строки. До версии 2.1.205 этот ход был переклассифицирован и мог перевести сеанс, ожидающий вашего ввода, обратно в `Working`.160Ход, весь вывод которого не содержит букв или цифр, такой как сеанс [`/loop`](/docs/ru/scheduled-tasks), который печатает одиночный символ на тихой итерации, сохраняет предыдущее резюме и состояние строки. До версии 2.1.205 этот ход был переклассифицирован и мог перевести сеанс, ожидающий вашего ввода, обратно в `Working`.

161 161 

162Резюме конца хода и каждая переписка в середине хода — это один короткий запрос класса Haiku через вашего обычного поставщика, выставляемый и обрабатываемый в соответствии с теми же [условиями использования данных](/ru/data-usage), что и сам сеанс. Обновления в течение 15 секунд между переписями модели повторно используют вывод самого сеанса и не отправляют запрос. На сторонних поставщиках, таких как Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и пользовательские шлюзы, запрос возвращается к основной модели сеанса, когда модель Haiku не настроена. Установите [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ru/model-config#environment-variables) для выбора модели для этих резюме на этих поставщиках.162Резюме конца хода и каждая переписка в середине хода — это один короткий запрос класса Haiku через вашего обычного поставщика, выставляемый и обрабатываемый в соответствии с теми же [условиями использования данных](/docs/ru/data-usage), что и сам сеанс. Обновления в течение 15 секунд между переписями модели повторно используют вывод самого сеанса и не отправляют запрос. На сторонних поставщиках, таких как Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и пользовательские шлюзы, запрос возвращается к основной модели сеанса, когда модель Haiku не настроена. Установите [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/ru/model-config#environment-variables) для выбора модели для этих резюме на этих поставщиках.

163 163 

164<h3 id="pull-request-status">164<h3 id="pull-request-status">

165 Статус pull request165 Статус pull request


204 204 

205Ответ, который не может быть доставлен, потому что фоновая служба недоступна или отправка не удалась, сохраняется и отправляется сеансу как его следующий запрос, когда его процесс снова запустится, и сообщение об ошибке говорит, что ответ был сохранён. Ответ с префиксом `!` не сохраняется, потому что сохранённый текст достигнет сеанса как простой запрос, а не запустится как команда Bash.205Ответ, который не может быть доставлен, потому что фоновая служба недоступна или отправка не удалась, сохраняется и отправляется сеансу как его следующий запрос, когда его процесс снова запустится, и сообщение об ошибке говорит, что ответ был сохранён. Ответ с префиксом `!` не сохраняется, потому что сохранённый текст достигнет сеанса как простой запрос, а не запустится как команда Bash.

206 206 

207С включённой [голосовой диктовкой](/ru/voice-dictation), удерживайте или нажимайте клавишу push-to-talk, пока фокус находится на вводе ответа, чтобы продиктовать ответ вместо его ввода. То же самое работает в поле отправки внизу agent view.207С включённой [голосовой диктовкой](/docs/ru/voice-dictation), удерживайте или нажимайте клавишу push-to-talk, пока фокус находится на вводе ответа, чтобы продиктовать ответ вместо его ввода. То же самое работает в поле отправки внизу agent view.

208 208 

209Используйте `↑` и `↓` для просмотра соседних сеансов без закрытия панели, или `→` для подключения.209Используйте `↑` и `↓` для просмотра соседних сеансов без закрытия панели, или `→` для подключения.

210 210 


214 214 

215Нажмите `Enter` или `→` на выбранной строке для подключения. Agent view заменяется полным интерактивным сеансом. При подключении Claude публикует краткое резюме того, что произошло, пока вас не было.215Нажмите `Enter` или `→` на выбранной строке для подключения. Agent view заменяется полным интерактивным сеансом. При подключении Claude публикует краткое резюме того, что произошло, пока вас не было.

216 216 

217При подключении сеанс ведёт себя как любой другой сеанс Claude Code: [команды](/ru/commands), сочетания клавиш и функции все работают, с исключениями ниже.217При подключении сеанс ведёт себя как любой другой сеанс Claude Code: [команды](/docs/ru/commands), сочетания клавиш и функции все работают, с исключениями ниже.

218 218 

219Фоновый сеанс отказывает `/install-github-app` и список параметров [`/mcp`](/ru/mcp), включая его действия аутентификации, независимо от того, подключены ли вы или отвечаете из панели просмотра. Сообщение направляет вас к обычному сеансу `claude`, и `/mcp reconnect <server>`, `/mcp enable` и `/mcp disable` всё ещё работают.219Фоновый сеанс отказывает `/install-github-app` и список параметров [`/mcp`](/docs/ru/mcp), включая его действия аутентификации, независимо от того, подключены ли вы или отвечаете из панели просмотра. Сообщение направляет вас к обычному сеансу `claude`, и `/mcp reconnect <server>`, `/mcp enable` и `/mcp disable` всё ещё работают.

220 220 

221Подключённые сеансы всегда отображаются в [полноэкранном режиме](/ru/fullscreen), независимо от вашего параметра `tui`, потому что фоновый сеанс не имеет истории прокрутки терминала для добавления. Прокручивайте с помощью `PgUp`, `PgDn` или колеса мыши, и нажмите `Ctrl+O` для режима стенограммы. Встроенная прокрутка вашего терминала и режим копирования tmux показывают только текущий видимый область, как и при запуске любого полноэкранного приложения.221Подключённые сеансы всегда отображаются в [полноэкранном режиме](/docs/ru/fullscreen), независимо от вашего параметра `tui`, потому что фоновый сеанс не имеет истории прокрутки терминала для добавления. Прокручивайте с помощью `PgUp`, `PgDn` или колеса мыши, и нажмите `Ctrl+O` для режима стенограммы. Встроенная прокрутка вашего терминала и режим копирования tmux показывают только текущий видимый область, как и при запуске любого полноэкранного приложения.

222 222 

223Нажмите `←` на пустой подсказке или запустите `/exit`, чтобы отключиться и вернуться к agent view. Начиная с версии 2.1.198, это работает одинаково, открыли ли вы сеанс из agent view или с помощью `claude attach <id>` из вашей оболочки.223Нажмите `←` на пустой подсказке или запустите `/exit`, чтобы отключиться и вернуться к agent view. Начиная с версии 2.1.198, это работает одинаково, открыли ли вы сеанс из agent view или с помощью `claude attach <id>` из вашей оболочки.

224 224 


232 232 

233Если инструмент работает, когда вы нажимаете `←`, Claude Code ждёт примерно десять секунд, чтобы он завершился, прежде чем отправить сеанс в фон, и ответ продолжается в фоновом сеансе. Нажмите `←` снова, чтобы отправить в фон немедленно вместо ожидания. Когда выполняемая работа не может перейти в фоновый сеанс, сначала появляется диалог `Background this session?`, как и с [`/background`](#from-inside-a-session).233Если инструмент работает, когда вы нажимаете `←`, Claude Code ждёт примерно десять секунд, чтобы он завершился, прежде чем отправить сеанс в фон, и ответ продолжается в фоновом сеансе. Нажмите `←` снова, чтобы отправить в фон немедленно вместо ожидания. Когда выполняемая работа не может перейти в фоновый сеанс, сначала появляется диалог `Background this session?`, как и с [`/background`](#from-inside-a-session).

234 234 

235Десятисекундный лимит не применяется, пока работают [subagents](/ru/sub-agents). Claude Code продолжает ждать, чтобы их работа перешла, и показывает уведомление `Still backgrounding after the current tool`, пока ждёт; нажмите `←` снова, чтобы отправить в фон без ожидания, что перезапустит subagents с начала. До версии 2.1.203 ожидание заканчивалось через десять секунд и работающие subagents перезапускались с начала без предупреждения.235Десятисекундный лимит не применяется, пока работают [subagents](/docs/ru/sub-agents). Claude Code продолжает ждать, чтобы их работа перешла, и показывает уведомление `Still backgrounding after the current tool`, пока ждёт; нажмите `←` снова, чтобы отправить в фон без ожидания, что перезапустит subagents с начала. До версии 2.1.203 ожидание заканчивалось через десять секунд и работающие subagents перезапускались с начала без предупреждения.

236 236 

237Строка создаётся даже из свежего сеанса без истории разговора, поэтому `→` возвращает к ней. {/* max-version: 2.1.202 */}До версии 2.1.203, agent view показывал подсказку адаптации ниже этой строки, когда она была единственной.237Строка создаётся даже из свежего сеанса без истории разговора, поэтому `→` возвращает к ней. До версии 2.1.203, agent view показывал подсказку адаптации ниже этой строки, когда она была единственной.

238 238 

239Вы можете отключить это сочетание клавиш с помощью параметра `leftArrowOpensAgents` в `/config`.239Вы можете отключить это сочетание клавиш с помощью параметра `leftArrowOpensAgents` в `/config`.

240 240 


313 313 

314Введите подсказку в поле ввода внизу agent view и нажмите `Enter` для запуска нового фонового сеанса. Сеанс автоматически называется из подсказки; переименуйте его позже с помощью `Ctrl+R`.314Введите подсказку в поле ввода внизу agent view и нажмите `Enter` для запуска нового фонового сеанса. Сеанс автоматически называется из подсказки; переименуйте его позже с помощью `Ctrl+R`.

315 315 

316Имя, которое сеанс получает позже, также отображается на его строке, включая имя, которое Claude выводит, когда вы [принимаете план](/ru/permission-modes#review-and-approve-a-plan) в этом сеансе. До версии 2.1.207 фоновый сеанс, названный путём принятия плана, показывал это имя в `/status`, но не на строке agent view до тех пор, пока вы не переименовали его сами.316Имя, которое сеанс получает позже, также отображается на его строке, включая имя, которое Claude выводит, когда вы [принимаете план](/docs/ru/permission-modes#review-and-approve-a-plan) в этом сеансе. До версии 2.1.207 фоновый сеанс, названный путём принятия плана, показывал это имя в `/status`, но не на строке agent view до тех пор, пока вы не переименовали его сами.

317 317 

318Вставьте изображение в подсказку, чтобы включить снимок экрана или диаграмму с задачей.318Вставьте изображение в подсказку, чтобы включить снимок экрана или диаграмму с задачей.

319 319 

320Вставленный текст длиннее 800 символов или более двух строк сворачивается в заполнитель `[Pasted text #N]`, чтобы ввод оставался на одной строке; полный текст отправляется при отправке. {/* min-version: 2.1.207 */}Чтобы просмотреть или отредактировать свёрнутый текст перед отправкой, вставьте тот же текст снова, и заполнитель развернётся обратно в ввод. Напоминание `paste again to expand` появляется под вводом на несколько секунд после вставки на терминалах шириной не менее 90 столбцов. До версии 2.1.207 вставка того же текста снова добавляла второй заполнитель вместо развёртывания первого.320Вставленный текст длиннее 800 символов или более двух строк сворачивается в заполнитель `[Pasted text #N]`, чтобы ввод оставался на одной строке; полный текст отправляется при отправке. Чтобы просмотреть или отредактировать свёрнутый текст перед отправкой, вставьте тот же текст снова, и заполнитель развернётся обратно в ввод. Напоминание `paste again to expand` появляется под вводом на несколько секунд после вставки на терминалах шириной не менее 90 столбцов. До версии 2.1.207 вставка того же текста снова добавляла второй заполнитель вместо развёртывания первого.

321 321 

322Используйте префиксы или упомяните части подсказки для управления тем, как запускается сеанс:322Используйте префиксы или упомяните части подсказки для управления тем, как запускается сеанс:

323 323 

324| Ввод | Эффект |324| Ввод | Эффект |

325| :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |325| :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

326| `<agent-name> <prompt>` | Если первое слово совпадает с именем пользовательского [subagent](/ru/sub-agents), этот subagent запускается как основной агент сеанса с конфигурацией из его frontmatter |326| `<agent-name> <prompt>` | Если первое слово совпадает с именем пользовательского [subagent](/docs/ru/sub-agents), этот subagent запускается как основной агент сеанса с конфигурацией из его frontmatter |

327| `@<agent-name>` | Упомяните пользовательского subagent в любом месте подсказки для запуска его как основного агента |327| `@<agent-name>` | Упомяните пользовательского subagent в любом месте подсказки для запуска его как основного агента |

328| `@<repo>` | Упомяните репозиторий для запуска сеанса там. См. [Отправка в конкретный каталог](#dispatch-to-a-specific-directory) для того, какие репозитории указаны |328| `@<repo>` | Упомяните репозиторий для запуска сеанса там. См. [Отправка в конкретный каталог](#dispatch-to-a-specific-directory) для того, какие репозитории указаны |

329| `/<command>` | Предложите [skills](/ru/skills) и [commands](/ru/commands) для отправки как подсказку |329| `/<command>` | Предложите [skills](/docs/ru/skills) и [commands](/docs/ru/commands) для отправки как подсказку |

330| `! <command>` | Запустите команду оболочки как фоновое задание вместо запуска сеанса Claude. Задание отображается как строка, к которой вы можете подключиться, наблюдать и отключиться |330| `! <command>` | Запустите команду оболочки как фоновое задание вместо запуска сеанса Claude. Задание отображается как строка, к которой вы можете подключиться, наблюдать и отключиться |

331| `#<number>` или URL pull request | Если сеанс уже работает над этим PR, выберите его вместо отправки |331| `#<number>` или URL pull request | Если сеанс уже работает над этим PR, выберите его вместо отправки |

332| `Shift+Enter` | Отправка и немедленное подключение к новому сеансу |332| `Shift+Enter` | Отправка и немедленное подключение к новому сеансу |


336* `/exit` и `/quit` закрывают agent view336* `/exit` и `/quit` закрывают agent view

337* `/logout` выходит из системы337* `/logout` выходит из системы

338* `/model` устанавливает [dispatch model](#set-the-model)338* `/model` устанавливает [dispatch model](#set-the-model)

339* {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, `/login` открывает диалог входа, чтобы вы могли войти снова без подключения к сеансу339* Начиная с версии 2.1.198, `/login` открывает диалог входа, чтобы вы могли войти снова без подключения к сеансу

340 340 

341Skills, ваши собственные команды и расширяющие подсказку встроенные команды, такие как `/init`, отправляются в новый фоновый сеанс как его первая подсказка. Другие встроенные команды показывают подсказку `attach to a session to run it` вместо этого. {/* min-version: 2.1.203 */}Всё, что вы вводили, остаётся в поле ввода рядом с подсказкой, чтобы вы могли отредактировать его. До версии 2.1.203 подсказка очищала ввод и введённый текст был потерян.341Skills, ваши собственные команды и расширяющие подсказку встроенные команды, такие как `/init`, отправляются в новый фоновый сеанс как его первая подсказка. Другие встроенные команды показывают подсказку `attach to a session to run it` вместо этого. Всё, что вы вводили, остаётся в поле ввода рядом с подсказкой, чтобы вы могли отредактировать его. До версии 2.1.203 подсказка очищала ввод и введённый текст был потерян.

342 342 

343Упаковка повторяющейся задачи как [skill](/ru/skills) позволяет вам запускать один и тот же рабочий процесс из agent view многократно без переввода подсказки.343Упаковка повторяющейся задачи как [skill](/docs/ru/skills) позволяет вам запускать один и тот же рабочий процесс из agent view многократно без переввода подсказки.

344 344 

345Когда одно и то же имя `@name` совпадает как с subagent, так и с соседним репозиторием, subagent имеет приоритет. Совпадение первого слова также применяется, поэтому подсказка, начинающаяся со слова, совпадающего с одним из имён ваших subagent, отправляет этот subagent, а не обрабатывает слово как обычный текст. Используйте форму `@` когда вы хотите быть явным, или начните подсказку с другого слова, чтобы избежать совпадения.345Когда одно и то же имя `@name` совпадает как с subagent, так и с соседним репозиторием, subagent имеет приоритет. Совпадение первого слова также применяется, поэтому подсказка, начинающаяся со слова, совпадающего с одним из имён ваших subagent, отправляет этот subagent, а не обрабатывает слово как обычный текст. Используйте форму `@` когда вы хотите быть явным, или начните подсказку с другого слова, чтобы избежать совпадения.

346 346 


354* Откройте `claude agents` в родительском каталоге и упомяните дочерний репозиторий с `@<repo>` в подсказке. Введите `@` для отображения этих целей:354* Откройте `claude agents` в родительском каталоге и упомяните дочерний репозиторий с `@<repo>` в подсказке. Введите `@` для отображения этих целей:

355 355 

356 * Git репозитории на один уровень ниже каталога запуска356 * Git репозитории на один уровень ниже каталога запуска

357 * Зарегистрированные [git worktrees](/ru/worktrees) репозитория, из которого вы запустили, которые находятся внутри его дерева каталогов, такие как те, которые Claude создаёт под `.claude/worktrees/`, помеченные их проверенной ветвью. Worktrees, добавленные вне репозитория, такие как `git worktree add ../feature`, не указываются357 * Зарегистрированные [git worktrees](/docs/ru/worktrees) репозитория, из которого вы запустили, которые находятся внутри его дерева каталогов, такие как те, которые Claude создаёт под `.claude/worktrees/`, помеченные их проверенной ветвью. Worktrees, добавленные вне репозитория, такие как `git worktree add ../feature`, не указываются

358 * Любой каталог, который уже имеет сеанс в списке358 * Любой каталог, который уже имеет сеанс в списке

359 359 

360 Каталог, имя которого содержит пробел, не указывается. {/* min-version: 2.1.203 */}До версии 2.1.203 зарегистрированные worktrees не указывались, поэтому отправка в один означала запуск `claude --bg` из каталога этого worktree.360 Каталог, имя которого содержит пробел, не указывается. До версии 2.1.203 зарегистрированные worktrees не указывались, поэтому отправка в один означала запуск `claude --bg` из каталога этого worktree.

361* Из оболочки выполните `cd` в каталог и запустите `claude --bg "<prompt>"`.361* Из оболочки выполните `cd` в каталог и запустите `claude --bg "<prompt>"`.

362 362 

363Когда agent view сгруппирован по каталогу, каталог выделенной строки становится целью отправки, поэтому вы можете прокрутить к группе и отправить в неё без переввода пути.363Когда agent view сгруппирован по каталогу, каталог выделенной строки становится целью отправки, поэтому вы можете прокрутить к группе и отправить в неё без переввода пути.


368 368 

369Запустите `/background` или его псевдоним `/bg` для перемещения текущей беседы в фоновый сеанс. Передайте подсказку, такую как `/bg run the test suite and fix any failures`, для отправки одной дополнительной инструкции перед этим. Если Claude отвечает, когда вы запускаете `/bg`, ответ продолжается в фоновом сеансе.369Запустите `/background` или его псевдоним `/bg` для перемещения текущей беседы в фоновый сеанс. Передайте подсказку, такую как `/bg run the test suite and fix any failures`, для отправки одной дополнительной инструкции перед этим. Если Claude отвечает, когда вы запускаете `/bg`, ответ продолжается в фоновом сеансе.

370 370 

371Выход из интерактивного сеанса, который всё ещё имеет выполняемую фоновую работу, такую как subagents, фоновые команды shell, рабочие процессы или [monitors](/ru/tools-reference#monitor-tool), показывает диалог `Background work is running` вместо немедленного выхода. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, диалог предлагает `Move to background and exit` наряду с `Exit anyway` и `Stay`. Выбор этого варианта перемещает сеанс в фон так же, как это делает `/background`, затем возвращает вас в вашу оболочку, поэтому работа, которая может продолжаться, продолжает работать, и сеанс отображается в agent view. Этот вариант не показывается, когда agent view [отключен](#turn-off-agent-view).371Выход из интерактивного сеанса, который всё ещё имеет выполняемую фоновую работу, такую как subagents, фоновые команды shell, рабочие процессы или [monitors](/docs/ru/tools-reference#monitor-tool), показывает диалог `Background work is running` вместо немедленного выхода. Начиная с версии 2.1.198, диалог предлагает `Move to background and exit` наряду с `Exit anyway` и `Stay`. Выбор этого варианта перемещает сеанс в фон так же, как это делает `/background`, затем возвращает вас в вашу оболочку, поэтому работа, которая может продолжаться, продолжает работать, и сеанс отображается в agent view. Этот вариант не показывается, когда agent view [отключен](#turn-off-agent-view).

372 372 

373Переведение в фон из интерактивного сеанса запускает свежий процесс, который возобновляется из сохранённой беседы, и выполняемая работа переходит в него: работающие фоновые команды shell, фоновые subagents, динамические рабочие процессы и запланированные задачи, которые вы создали с помощью [`/loop`](/ru/scheduled-tasks), переносятся в фоновый сеанс и продолжают работать там. Subagent переходит вместе со всем, что он запустил, поэтому он переносится только когда вся эта работа может перейти тоже, включая на Windows. Чтобы остановить выполняемую работу вместо её переноса, установите переменную окружения [`CLAUDE_DISABLE_ADOPT=1`](/ru/env-vars#variables); Claude Code затем просит вас подтвердить перед отправкой в фон.373Переведение в фон из интерактивного сеанса запускает свежий процесс, который возобновляется из сохранённой беседы, и выполняемая работа переходит в него: работающие фоновые команды shell, фоновые subagents, динамические рабочие процессы и запланированные задачи, которые вы создали с помощью [`/loop`](/docs/ru/scheduled-tasks), переносятся в фоновый сеанс и продолжают работать там. Subagent переходит вместе со всем, что он запустил, поэтому он переносится только когда вся эта работа может перейти тоже, включая на Windows. Чтобы остановить выполняемую работу вместо её переноса, установите переменную окружения [`CLAUDE_DISABLE_ADOPT=1`](/docs/ru/env-vars#variables); Claude Code затем просит вас подтвердить перед отправкой в фон.

374 374 

375Работа, которая не может перейти, такая как работающий [monitor](/ru/tools-reference#monitor-tool), останавливается. Фоновый subagent, который владеет монитором, останавливается вместе с ним. Когда какая-либо такая работа выполняется, Claude Code показывает диалог `Background this session?` так, чтобы вы могли подтвердить перед её остановкой.375Работа, которая не может перейти, такая как работающий [monitor](/docs/ru/tools-reference#monitor-tool), останавливается. Фоновый subagent, который владеет монитором, останавливается вместе с ним. Когда какая-либо такая работа выполняется, Claude Code показывает диалог `Background this session?` так, чтобы вы могли подтвердить перед её остановкой.

376 376 

377После отправки в фон сеанс может запускать новые subagents, monitors и фоновые команды, и они продолжают работать при последующем отключении и переподключении.377После отправки в фон сеанс может запускать новые subagents, monitors и фоновые команды, и они продолжают работать при последующем отключении и переподключении.

378 378 


385* `--fallback-model`385* `--fallback-model`

386* `--allow-dangerously-skip-permissions`386* `--allow-dangerously-skip-permissions`

387 387 

388Каталоги, которые вы добавили во время сеанса с помощью [`/add-dir`](/ru/permissions#additional-directories-grant-file-access-not-configuration), также переносятся.388Каталоги, которые вы добавили во время сеанса с помощью [`/add-dir`](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration), также переносятся.

389 389 

390Перенос `--allow-dangerously-skip-permissions` сохраняет `bypassPermissions` доступным в фоновом сеансе, но это не предоставляет ничего нового. Режим по-прежнему требует того же одноразового интерактивного принятия, описанного в [Permission mode, model, and effort](#permission-mode-model-and-effort), прежде чем любой сеанс сможет его использовать.390Перенос `--allow-dangerously-skip-permissions` сохраняет `bypassPermissions` доступным в фоновом сеансе, но это не предоставляет ничего нового. Режим по-прежнему требует того же одноразового интерактивного принятия, описанного в [Permission mode, model, and effort](#permission-mode-model-and-effort), прежде чем любой сеанс сможет его использовать.

391 391 


399claude --bg "investigate the flaky SettingsChangeDetector test"399claude --bg "investigate the flaky SettingsChangeDetector test"

400```400```

401 401 

402Подсказка является позиционным аргументом, а не значением `-p`. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, объединение `--bg` с `-p` или `--print` отклоняется с ошибкой перед созданием любого сеанса, потому что `--print` никогда не запускает интерактивный сеанс, к которому подключается `claude agents`.402Подсказка является позиционным аргументом, а не значением `-p`. Начиная с версии 2.1.198, объединение `--bg` с `-p` или `--print` отклоняется с ошибкой перед созданием любого сеанса, потому что `--print` никогда не запускает интерактивный сеанс, к которому подключается `claude agents`.

403 403 

404Чтобы запустить конкретного subagent как основного агента сеанса, объедините `--bg` с `--agent`:404Чтобы запустить конкретного subagent как основного агента сеанса, объедините `--bg` с `--agent`:

405 405 


447 Как изолируются правки файлов447 Как изолируются правки файлов

448</h3>448</h3>

449 449 

450Каждый фоновый сеанс, запущенный ли из agent view, `/bg` или `claude --bg`, запускается в вашем рабочем каталоге. Перед редактированием файлов Claude перемещает сеанс в изолированный [git worktree](/ru/worktrees) под `.claude/worktrees/`, поэтому параллельные сеансы могут читать один и тот же checkout, но каждый пишет в свой собственный.450Каждый фоновый сеанс, запущенный ли из agent view, `/bg` или `claude --bg`, запускается в вашем рабочем каталоге. Перед редактированием файлов Claude перемещает сеанс в изолированный [git worktree](/docs/ru/worktrees) под `.claude/worktrees/`, поэтому параллельные сеансы могут читать один и тот же checkout, но каждый пишет в свой собственный.

451 451 

452Claude пропускает worktree когда:452Claude пропускает worktree когда:

453 453 

454* Сеанс уже находится внутри связанного git worktree, создан ли он Claude под `.claude/worktrees/` или вы создали его с помощью `git worktree add` где-то ещё454* Сеанс уже находится внутри связанного git worktree, создан ли он Claude под `.claude/worktrees/` или вы создали его с помощью `git worktree add` где-то ещё

455* Рабочий каталог не является git репозиторием и нет настроенного [`WorktreeCreate` hook](/ru/hooks#worktreecreate)455* Рабочий каталог не является git репозиторием и нет настроенного [`WorktreeCreate` hook](/docs/ru/hooks#worktreecreate)

456* Запись находится вне рабочего каталога456* Запись находится вне рабочего каталога

457 457 

458Чтобы отключить изоляцию worktree для репозитория, где git worktrees непрактичны, установите [`worktree.bgIsolation`](/ru/settings#worktree-settings) на `"none"`. Фоновые сеансы затем редактируют вашу рабочую копию напрямую без предварительного перемещения в worktree. Добавьте параметр в файл `.claude/settings.json` проекта:458Чтобы отключить изоляцию worktree для репозитория, где git worktrees непрактичны, установите [`worktree.bgIsolation`](/docs/ru/settings#worktree-settings) на `"none"`. Фоновые сеансы затем редактируют вашу рабочую копию напрямую без предварительного перемещения в worktree. Добавьте параметр в файл `.claude/settings.json` проекта:

459 459 

460```json theme={null}460```json theme={null}

461{461{


465}465}

466```466```

467 467 

468Вне git репозитория сеансы пишут в рабочий каталог напрямую и не изолированы друг от друга, поэтому избегайте отправки параллельных сеансов, которые редактируют одни и те же файлы. Если вы используете другую систему контроля версий, настройте [`WorktreeCreate` hook](/ru/worktrees#non-git-version-control) и Claude изолирует правки так же, как это делает для git.468Вне git репозитория сеансы пишут в рабочий каталог напрямую и не изолированы друг от друга, поэтому избегайте отправки параллельных сеансов, которые редактируют одни и те же файлы. Если вы используете другую систему контроля версий, настройте [`WorktreeCreate` hook](/docs/ru/worktrees#non-git-version-control) и Claude изолирует правки так же, как это делает для git.

469 469 

470Когда hook не удаётся в каталоге, который не является git репозиторием, сеанс пропускает изоляцию для этого каталога и редактирует рабочий каталог на месте. Внутри git репозитория записи остаются заблокированными до тех пор, пока сеанс не изолирует. До версии 2.1.203 фоновый сеанс в этом состоянии не мог редактировать какой-либо файл: каждая запись была отклонена до изоляции, и hook никогда не мог изолировать этот каталог.470Когда hook не удаётся в каталоге, который не является git репозиторием, сеанс пропускает изоляцию для этого каталога и редактирует рабочий каталог на месте. Внутри git репозитория записи остаются заблокированными до тех пор, пока сеанс не изолирует. До версии 2.1.203 фоновый сеанс в этом состоянии не мог редактировать какой-либо файл: каждая запись была отклонена до изоляции, и hook никогда не мог изолировать этот каталог.

471 471 


478 478 

479Чтобы найти путь worktree сеанса, посмотрите сеанс или подключитесь и проверьте его рабочий каталог.479Чтобы найти путь worktree сеанса, посмотрите сеанс или подключитесь и проверьте его рабочий каталог.

480 480 

481[Subagent](/ru/sub-agents), который запускает фоновый сеанс, наследует рабочий каталог сеанса, поэтому его правки файлов попадают в worktree сеанса, а не в вашу рабочую копию. Чтобы дать subagent его собственный отдельный worktree вместо этого, установите [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) в его frontmatter или передайте `isolation: "worktree"` при запуске его.481[Subagent](/docs/ru/sub-agents), который запускает фоновый сеанс, наследует рабочий каталог сеанса, поэтому его правки файлов попадают в worktree сеанса, а не в вашу рабочую копию. Чтобы дать subagent его собственный отдельный worktree вместо этого, установите [`isolation: worktree`](/docs/ru/sub-agents#supported-frontmatter-fields) в его frontmatter или передайте `isolation: "worktree"` при запуске его.

482 482 

483Начиная с версии 2.1.198, фоновый сеанс, который изолировал свои изменения кода в worktree, также фиксирует, отправляет свою собственную ветку и открывает черновик pull request без остановки для вопроса. Метка [`#N`](#pull-request-status) отображается на его строке, когда pull request открывается. Он никогда не отправляет на `main` или `master`, никогда не выполняет force-push или merge, и пропускает pull request, когда вы сказали ему не открывать один или репозиторий не имеет удалённого.483Начиная с версии 2.1.198, фоновый сеанс, который изолировал свои изменения кода в worktree, также фиксирует, отправляет свою собственную ветку и открывает черновик pull request без остановки для вопроса. Метка [`#N`](#pull-request-status) отображается на его строке, когда pull request открывается. Он никогда не отправляет на `main` или `master`, никогда не выполняет force-push или merge, и пропускает pull request, когда вы сказали ему не открывать один или репозиторий не имеет удалённого.

484 484 


488 Установка модели488 Установка модели

489</h3>489</h3>

490 490 

491Имя модели, показанное в заголовке agent view, является стандартом отправки. Новые сеансы, которые вы запускаете из входа, используют эту модель, которая поступает из параметра [`model` setting](/ru/settings#available-settings) в ваших пользовательских settings. Установите его, выбрав модель в [`/model` picker](/ru/model-config), или отредактируйте параметр напрямую.491Имя модели, показанное в заголовке agent view, является стандартом отправки. Новые сеансы, которые вы запускаете из входа, используют эту модель, которая поступает из параметра [`model` setting](/docs/ru/settings#available-settings) в ваших пользовательских settings. Установите его, выбрав модель в [`/model` picker](/docs/ru/model-config), или отредактируйте параметр напрямую.

492 492 

493Чтобы переопределить стандарт отправки для всего сеанса agent view, передайте `--model` при открытии agent view. См. [Permission mode, model, and effort](#permission-mode-model-and-effort).493Чтобы переопределить стандарт отправки для всего сеанса agent view, передайте `--model` при открытии agent view. См. [Permission mode, model, and effort](#permission-mode-model-and-effort).

494 494 


505 505 

506* Из оболочки передайте `--model` с `claude --bg`.506* Из оболочки передайте `--model` с `claude --bg`.

507* Подключитесь к работающему сеансу и запустите `/model` для переключения: выбор из picker или введённый `/model <name>` сохраняется как ваш стандарт для новых сеансов, если вы не нажмёте `s` в picker для переключения только для этого сеанса. Переключение только для сеанса сохраняется, если сеанс перезапущен.507* Подключитесь к работающему сеансу и запустите `/model` для переключения: выбор из picker или введённый `/model <name>` сохраняется как ваш стандарт для новых сеансов, если вы не нажмёте `s` в picker для переключения только для этого сеанса. Переключение только для сеанса сохраняется, если сеанс перезапущен.

508* Отправьте [subagent](/ru/sub-agents), чей frontmatter устанавливает поле `model`.508* Отправьте [subagent](/docs/ru/sub-agents), чей frontmatter устанавливает поле `model`.

509 509 

510<h3 id="permission-mode-model-and-effort">510<h3 id="permission-mode-model-and-effort">

511 Permission mode, model, and effort511 Permission mode, model, and effort

512</h3>512</h3>

513 513 

514Фоновый сеанс читает свои [settings](/ru/settings) из каталога, в котором он запускается, так же как если бы вы запустили `claude` там. Это включает значения [`env`](/ru/settings#available-settings) в settings проекта, поэтому `ANTHROPIC_MODEL` или переменная поставщика, установленная там, применяется к фоновым сеансам в этом каталоге.514Фоновый сеанс читает свои [settings](/docs/ru/settings) из каталога, в котором он запускается, так же как если бы вы запустили `claude` там. Это включает значения [`env`](/docs/ru/settings#available-settings) в settings проекта, поэтому `ANTHROPIC_MODEL` или переменная поставщика, установленная там, применяется к фоновым сеансам в этом каталоге.

515 515 

516Выбор облачного поставщика, такой как `CLAUDE_CODE_USE_BEDROCK` или `CLAUDE_CODE_USE_VERTEX`, и псевдонимы `ANTHROPIC_DEFAULT_*_MODEL` следуют оболочке, которая отправила сеанс. {/* min-version: 2.1.206 */}Если вы экспортируете переопределение тела запроса [`CLAUDE_CODE_EXTRA_BODY`](/ru/env-vars) в этой оболочке, оно достигает сеанса так же. До версии 2.1.206 фоновые рабочие процессы игнорировали экспортированный оболочкой `CLAUDE_CODE_EXTRA_BODY`.516Выбор облачного поставщика, такой как `CLAUDE_CODE_USE_BEDROCK` или `CLAUDE_CODE_USE_VERTEX`, и псевдонимы `ANTHROPIC_DEFAULT_*_MODEL` следуют оболочке, которая отправила сеанс. Если вы экспортируете переопределение тела запроса [`CLAUDE_CODE_EXTRA_BODY`](/docs/ru/env-vars) в этой оболочке, оно достигает сеанса так же. До версии 2.1.206 фоновые рабочие процессы игнорировали экспортированный оболочкой `CLAUDE_CODE_EXTRA_BODY`.

517 517 

518Если вы экспортируете переменную шлюза `ANTHROPIC_BASE_URL` в отправляющей оболочке, она также достигает сеанса, вместе с `ANTHROPIC_CUSTOM_HEADERS`, когда supervisor работает с той же окружением шлюза и сеанс запускается в каталоге, из которого вы отправляете, или это ваш собственный сеанс, переведённый в фон с помощью `←` или `/background`. Это нормальный случай, когда первая оболочка, открывшая agent view или отправившая фоновый сеанс, является оболочкой шлюза. Отправка в другой каталог с `@repo` или `--cwd` не переносит шлюз оболочки; параметры этого проекта [settings](/ru/settings) предоставляют конечную точку. См. [supervisor process](#the-supervisor-process) для того, как фоновые сеансы получают параметры поставщика и учётные данные.518Если вы экспортируете переменную шлюза `ANTHROPIC_BASE_URL` в отправляющей оболочке, она также достигает сеанса, вместе с `ANTHROPIC_CUSTOM_HEADERS`, когда supervisor работает с той же окружением шлюза и сеанс запускается в каталоге, из которого вы отправляете, или это ваш собственный сеанс, переведённый в фон с помощью `←` или `/background`. Это нормальный случай, когда первая оболочка, открывшая agent view или отправившая фоновый сеанс, является оболочкой шлюза. Отправка в другой каталог с `@repo` или `--cwd` не переносит шлюз оболочки; параметры этого проекта [settings](/docs/ru/settings) предоставляют конечную точку. См. [supervisor process](#the-supervisor-process) для того, как фоновые сеансы получают параметры поставщика и учётные данные.

519 519 

520[Permission mode](/ru/permissions) зависит от того, как вы запустили сеанс. Переведение существующего сеанса в фон с помощью `/bg` или `←` сохраняет текущий permission mode, поэтому сеанс, который вы переключили на `acceptEdits` или `auto`, остаётся в этом режиме после отключения. Отправка из входа agent view или запуск `claude --bg` из вашей оболочки использует `defaultMode` из settings этого каталога или `permissionMode` из frontmatter отправленного [subagent](/ru/sub-agents#supported-frontmatter-fields).520[Permission mode](/docs/ru/permissions) зависит от того, как вы запустили сеанс. Переведение существующего сеанса в фон с помощью `/bg` или `←` сохраняет текущий permission mode, поэтому сеанс, который вы переключили на `acceptEdits` или `auto`, остаётся в этом режиме после отключения. Отправка из входа agent view или запуск `claude --bg` из вашей оболочки использует `defaultMode` из settings этого каталога или `permissionMode` из frontmatter отправленного [subagent](/docs/ru/sub-agents#supported-frontmatter-fields).

521 521 

522Permission mode, модель и усилие, с которыми вы запускаете фоновый сеанс, наряду с [флагами конфигурации, которые он переносит](#from-inside-a-session), все сохраняются, когда supervisor позже [останавливает и перезапускает](#the-supervisor-process) процесс сеанса. Сеанс, который вы запустили с помощью `claude --bg --dangerously-skip-permissions` или `claude --bg --permission-mode bypassPermissions`, остаётся в `bypassPermissions` после этого перезапуска вместо возврата к `defaultMode` каталога, и модель или усилие, которые вы изменили во время сеанса с помощью `/model` или `/effort`, сохраняются.522Permission mode, модель и усилие, с которыми вы запускаете фоновый сеанс, наряду с [флагами конфигурации, которые он переносит](#from-inside-a-session), все сохраняются, когда supervisor позже [останавливает и перезапускает](#the-supervisor-process) процесс сеанса. Сеанс, который вы запустили с помощью `claude --bg --dangerously-skip-permissions` или `claude --bg --permission-mode bypassPermissions`, остаётся в `bypassPermissions` после этого перезапуска вместо возврата к `defaultMode` каталога, и модель или усилие, которые вы изменили во время сеанса с помощью `/model` или `/effort`, сохраняются.

523 523 

524Усилие, которое сеанс взял из параметра [`effortLevel` setting](/ru/settings#available-settings) вместо `--effort` или `/effort`, не фиксируется при отправке: каждый процесс, запущенный для сеанса, читает параметр снова, поэтому редактирование `effortLevel` в `settings.json` достигает сеансов, которые вы переводите в фон с помощью `←` или `/bg`, и их более поздних перезапусков. До версии 2.1.203 переведение сеанса в фон записывало его усилие, полученное из параметров, как если бы вы передали `--effort`, поэтому более поздние правки `effortLevel` никогда не достигали его.524Усилие, которое сеанс взял из параметра [`effortLevel` setting](/docs/ru/settings#available-settings) вместо `--effort` или `/effort`, не фиксируется при отправке: каждый процесс, запущенный для сеанса, читает параметр снова, поэтому редактирование `effortLevel` в `settings.json` достигает сеансов, которые вы переводите в фон с помощью `←` или `/bg`, и их более поздних перезапусков. До версии 2.1.203 переведение сеанса в фон записывало его усилие, полученное из параметров, как если бы вы передали `--effort`, поэтому более поздние правки `effortLevel` никогда не достигали его.

525 525 

526Имя, которое вы установили с помощью [`/rename`](/ru/commands) или `Ctrl+R`, также сохраняется при этом перезапуске, поэтому [`claude --resume <name>`](/ru/sessions#name-your-sessions) по-прежнему разрешает сеанс. До версии 2.1.202 перезапуск возвращал сеанс к имени, с которым он был отправлен, и новое имя перестало разрешаться.526Имя, которое вы установили с помощью [`/rename`](/docs/ru/commands) или `Ctrl+R`, также сохраняется при этом перезапуске, поэтому [`claude --resume <name>`](/docs/ru/sessions#name-your-sessions) по-прежнему разрешает сеанс. До версии 2.1.202 перезапуск возвращал сеанс к имени, с которым он был отправлен, и новое имя перестало разрешаться.

527 527 

528Чтобы установить стандартные значения для каждого сеанса, который вы отправляете из agent view, передайте любой из `--permission-mode`, `--model`, `--effort` или `--agent` при открытии его:528Чтобы установить стандартные значения для каждого сеанса, который вы отправляете из agent view, передайте любой из `--permission-mode`, `--model`, `--effort` или `--agent` при открытии его:

529 529 


531claude agents --permission-mode plan --model opus --effort high531claude agents --permission-mode plan --model opus --effort high

532```532```

533 533 

534`--agent` устанавливает [subagent](/ru/sub-agents), используемый, когда подсказка отправки не называет один, либо с `@name`, либо как первое слово. По умолчанию используется параметр [`agent` setting](/ru/settings#available-settings), если он установлен, иначе встроенный универсальный агент `claude`. Именование subagent в входе отправки переопределяет оба.534`--agent` устанавливает [subagent](/docs/ru/sub-agents), используемый, когда подсказка отправки не называет один, либо с `@name`, либо как первое слово. По умолчанию используется параметр [`agent` setting](/docs/ru/settings#available-settings), если он установлен, иначе встроенный универсальный агент `claude`. Именование subagent в входе отправки переопределяет оба.

535 535 

536`claude agents` также принимает `--dangerously-skip-permissions` как сокращение для `--permission-mode bypassPermissions` и `--allow-dangerously-skip-permissions` для того, чтобы сделать `bypassPermissions` доступным в цикле `Shift+Tab` каждого отправленного сеанса без запуска в этом режиме. Оба совпадают с [флагами CLI верхнего уровня](/ru/cli-reference).536`claude agents` также принимает `--dangerously-skip-permissions` как сокращение для `--permission-mode bypassPermissions` и `--allow-dangerously-skip-permissions` для того, чтобы сделать `bypassPermissions` доступным в цикле `Shift+Tab` каждого отправленного сеанса без запуска в этом режиме. Оба совпадают с [флагами CLI верхнего уровня](/docs/ru/cli-reference).

537 537 

538Активные стандартные значения отображаются в нижнем колонтитуле под входом отправки.538Активные стандартные значения отображаются в нижнем колонтитуле под входом отправки.

539 539 

540Без этих флагов сеанс использует `defaultMode` из settings этого каталога или `permissionMode` из frontmatter отправленного [subagent](/ru/sub-agents#supported-frontmatter-fields), и модель, показанную в заголовке agent view.540Без этих флагов сеанс использует `defaultMode` из settings этого каталога или `permissionMode` из frontmatter отправленного [subagent](/docs/ru/sub-agents#supported-frontmatter-fields), и модель, показанную в заголовке agent view.

541 541 

542Использование `bypassPermissions` с `claude --bg --permission-mode` отклоняется до тех пор, пока вы не примете отказ от ответственности за обход, запустив `claude --dangerously-skip-permissions` один раз интерактивно, так как этот режим позволяет сеансу, который вы не наблюдаете, действовать без одобрения. Передача `--dangerously-skip-permissions` или `--permission-mode bypassPermissions` в `claude agents` показывает тот же отказ от ответственности, когда вы его не приняли раньше, и принятие применяет `bypassPermissions` к сеансам, которые вы запускаете из представления. Передача `--allow-dangerously-skip-permissions` показывает тот же отказ от ответственности тоже, и принятие делает `bypassPermissions` доступным в цикле `Shift+Tab` этих сеансов без запуска их в нём.542Использование `bypassPermissions` с `claude --bg --permission-mode` отклоняется до тех пор, пока вы не примете отказ от ответственности за обход, запустив `claude --dangerously-skip-permissions` один раз интерактивно, так как этот режим позволяет сеансу, который вы не наблюдаете, действовать без одобрения. Передача `--dangerously-skip-permissions` или `--permission-mode bypassPermissions` в `claude agents` показывает тот же отказ от ответственности, когда вы его не приняли раньше, и принятие применяет `bypassPermissions` к сеансам, которые вы запускаете из представления. Передача `--allow-dangerously-skip-permissions` показывает тот же отказ от ответственности тоже, и принятие делает `bypassPermissions` доступным в цикле `Shift+Tab` этих сеансов без запуска их в нём.

543 543 


549 549 

550| Флаг | Эффект |550| Флаг | Эффект |

551| :----------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------- |551| :----------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------- |

552| [`--settings <file-or-json>`](/ru/settings) | Переопределить settings для agent view и отправленных сеансов |552| [`--settings <file-or-json>`](/docs/ru/settings) | Переопределить settings для agent view и отправленных сеансов |

553| [`--add-dir <path>`](/ru/permissions#additional-directories-grant-file-access-not-configuration) | Предоставить доступ к файлам дополнительного каталога |553| [`--add-dir <path>`](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) | Предоставить доступ к файлам дополнительного каталога |

554| [`--plugin-dir <path>`](/ru/plugins) | Загрузить plugin из локального каталога |554| [`--plugin-dir <path>`](/docs/ru/plugins) | Загрузить plugin из локального каталога |

555| [`--mcp-config <file-or-json>`](/ru/mcp) | Загрузить MCP servers из файла конфигурации или строки JSON |555| [`--mcp-config <file-or-json>`](/docs/ru/mcp) | Загрузить MCP servers из файла конфигурации или строки JSON |

556| `--strict-mcp-config` | Использовать только MCP servers из `--mcp-config`, игнорируя другую конфигурацию MCP |556| `--strict-mcp-config` | Использовать только MCP servers из `--mcp-config`, игнорируя другую конфигурацию MCP |

557 557 

558Повторите `--add-dir`, `--plugin-dir` или `--mcp-config` один раз для каждого значения. Форма, разделённая пробелами, такая как `--add-dir a b c`, не поддерживается с `claude agents`.558Повторите `--add-dir`, `--plugin-dir` или `--mcp-config` один раз для каждого значения. Форма, разделённая пробелами, такая как `--add-dir a b c`, не поддерживается с `claude agents`.


603 603 

604`PATH` отправляющей оболочки применяется к рабочему процессу так же, поэтому команды оболочки, которые запускает сеанс, находят те же инструменты, что и ваш терминал. До версии 2.1.203 фоновый сеанс сохранял `PATH` оболочки, которая первой запустила супервизор, поэтому инструменты, добавленные в ваш `PATH` с тех пор, могли отсутствовать, чаще всего на Windows.604`PATH` отправляющей оболочки применяется к рабочему процессу так же, поэтому команды оболочки, которые запускает сеанс, находят те же инструменты, что и ваш терминал. До версии 2.1.203 фоновый сеанс сохранял `PATH` оболочки, которая первой запустила супервизор, поэтому инструменты, добавленные в ваш `PATH` с тех пор, могли отсутствовать, чаще всего на Windows.

605 605 

606Фоновый сеанс не наследует переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL`, или эквивалентные переменные базового URL Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, из оболочки, которая запустила супервизор. Без шлюза, экспортированного в оболочке, из которой вы отправляете, сеанс использует ваши сохранённые учётные данные и любые значения `env` в [параметрах](/ru/settings) каталога проекта. Чтобы указать каждый сеанс в проекте на [шлюз LLM](/ru/llm-gateway), установите `ANTHROPIC_BASE_URL` в блоке `env` файла `.claude/settings.json` этого проекта.606Фоновый сеанс не наследует переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL`, или эквивалентные переменные базового URL Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, из оболочки, которая запустила супервизор. Без шлюза, экспортированного в оболочке, из которой вы отправляете, сеанс использует ваши сохранённые учётные данные и любые значения `env` в [параметрах](/docs/ru/settings) каталога проекта. Чтобы указать каждый сеанс в проекте на [шлюз LLM](/docs/ru/llm-gateway), установите `ANTHROPIC_BASE_URL` в блоке `env` файла `.claude/settings.json` этого проекта.

607 607 

608{/* min-version: 2.1.203 */}Если вы экспортируете шлюз `ANTHROPIC_BASE_URL` в оболочке, из которой вы отправляете, он достигает рабочего процесса этого сеанса. `ANTHROPIC_CUSTOM_HEADERS` и учётные данные, экспортированные рядом с ними, пересылаются вместе с ним. Это происходит, когда супервизор был запущен из окружения с тем же шлюзом. Супервизор захватывает своё окружение из первой оболочки, которая открывает представление агента или отправляет фоновый сеанс, поэтому запуск из оболочки шлюза даёт ему это окружение. Пересылка также применяется только к сеансам, отправленным в каталог, из которого вы отправляете, или отправленным в фон из вашего собственного сеанса с помощью `←` или `/background`: отправка в другой каталог с помощью `@repo` или `--cwd` не переносит шлюз оболочки, и блок `env` файла `settings.json` этого проекта предоставляет конечную точку вместо этого. Когда окружение супервизора несёт другой шлюз или его нет, рабочий процесс сохраняет ваши сохранённые учётные данные против конечной точки по умолчанию вместо смешивания учётных данных одного окружения с конечной точкой другого. До версии 2.1.203 `ANTHROPIC_BASE_URL` отправляющей оболочки был удалён, в то время как `ANTHROPIC_API_KEY`, экспортированный рядом с ним, был сохранён, поэтому ключ шлюза был отправлен на конечную точку по умолчанию и каждый запрос завершился ошибкой 401.608Если вы экспортируете шлюз `ANTHROPIC_BASE_URL` в оболочке, из которой вы отправляете, он достигает рабочего процесса этого сеанса. `ANTHROPIC_CUSTOM_HEADERS` и учётные данные, экспортированные рядом с ними, пересылаются вместе с ним. Это происходит, когда супервизор был запущен из окружения с тем же шлюзом. Супервизор захватывает своё окружение из первой оболочки, которая открывает представление агента или отправляет фоновый сеанс, поэтому запуск из оболочки шлюза даёт ему это окружение. Пересылка также применяется только к сеансам, отправленным в каталог, из которого вы отправляете, или отправленным в фон из вашего собственного сеанса с помощью `←` или `/background`: отправка в другой каталог с помощью `@repo` или `--cwd` не переносит шлюз оболочки, и блок `env` файла `settings.json` этого проекта предоставляет конечную точку вместо этого. Когда окружение супервизора несёт другой шлюз или его нет, рабочий процесс сохраняет ваши сохранённые учётные данные против конечной точки по умолчанию вместо смешивания учётных данных одного окружения с конечной точкой другого. До версии 2.1.203 `ANTHROPIC_BASE_URL` отправляющей оболочки был удалён, в то время как `ANTHROPIC_API_KEY`, экспортированный рядом с ним, был сохранён, поэтому ключ шлюза был отправлен на конечную точку по умолчанию и каждый запрос завершился ошибкой 401.

609 609 

610Пересылаемая конечная точка применяется только к этому живому процессу и никогда не записывается на диск. Когда супервизор останавливает неактивный сеанс и позже перезапускает его, перезапущенный процесс читает свою конечную точку из ваших параметров снова: с шлюзом `ANTHROPIC_AUTH_TOKEN` он возвращается к вашим сохранённым учётным данным, а с выданным шлюзом `ANTHROPIC_API_KEY` он может не пройти аутентификацию, пока шлюз не будет установлен в параметрах.610Пересылаемая конечная точка применяется только к этому живому процессу и никогда не записывается на диск. Когда супервизор останавливает неактивный сеанс и позже перезапускает его, перезапущенный процесс читает свою конечную точку из ваших параметров снова: с шлюзом `ANTHROPIC_AUTH_TOKEN` он возвращается к вашим сохранённым учётным данным, а с выданным шлюзом `ANTHROPIC_API_KEY` он может не пройти аутентификацию, пока шлюз не будет установлен в параметрах.

611 611 


617 617 

618* Фоновая команда оболочки, которая завершилась в то время, сообщается как завершённая с её выводом618* Фоновая команда оболочки, которая завершилась в то время, сообщается как завершённая с её выводом

619* Динамический рабочий процесс возобновляется с того места, где он остановился619* Динамический рабочий процесс возобновляется с того места, где он остановился

620* [Фоновый подагент](/ru/sub-agents#run-subagents-in-foreground-or-background) возобновляется из его собственной стенограммы620* [Фоновый подагент](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) возобновляется из его собственной стенограммы

621 621 

622{/* min-version: 2.1.198 */}Начиная с версии 2.1.198 передача охватывает все три. До версии 2.1.198 она охватывала только команды оболочки и рабочие процессы, поэтому фоновый подагент останавливался с процессом и сообщался как неудачный при следующем пробуждении.622Начиная с версии 2.1.198 передача охватывает все три. До версии 2.1.198 она охватывала только команды оболочки и рабочие процессы, поэтому фоновый подагент останавливался с процессом и сообщался как неудачный при следующем пробуждении.

623 623 

624Работа, состояние которой существует только внутри самого процесса, останавливается вместе с ним вместо передачи. Это команды оболочки, которые запустил подагент, которые возобновлённый подагент может запустить снова, и работающие [мониторы](/ru/tools-reference#monitor-tool), поток событий которых не может быть перемещён в другой процесс.624Работа, состояние которой существует только внутри самого процесса, останавливается вместе с ним вместо передачи. Это команды оболочки, которые запустил подагент, которые возобновлённый подагент может запустить снова, и работающие [мониторы](/docs/ru/tools-reference#monitor-tool), поток событий которых не может быть перемещён в другой процесс.

625 625 

626Удаление сеанса останавливает всё, что он передал. Чтобы остановить всю фоновую работу сеанса с процессом вместо передачи, установите переменную окружения [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/ru/env-vars#variables) на `1`.626Удаление сеанса останавливает всё, что он передал. Чтобы остановить всю фоновую работу сеанса с процессом вместо передачи, установите переменную окружения [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/ru/env-vars#variables) на `1`.

627 627 

628Перезапущенный процесс находит разговор сеанса, который [переместился в worktree](#how-file-edits-are-isolated) во время выполнения задачи: когда стенограмма находится не там, где сеанс начался, Claude Code также ищет под зарегистрированными worktrees репозитория. До версии 2.1.207 повторное открытие этого сеанса из представления агента после остановки его процесса могло показать пустой разговор только с его исходной подсказкой, со стенограммой, всё ещё нетронутой на диске; открытие сеанса снова в версии 2.1.207 или позже восстанавливает его.628Перезапущенный процесс находит разговор сеанса, который [переместился в worktree](#how-file-edits-are-isolated) во время выполнения задачи: когда стенограмма находится не там, где сеанс начался, Claude Code также ищет под зарегистрированными worktrees репозитория. До версии 2.1.207 повторное открытие этого сеанса из представления агента после остановки его процесса могло показать пустой разговор только с его исходной подсказкой, со стенограммой, всё ещё нетронутой на диске; открытие сеанса снова в версии 2.1.207 или позже восстанавливает его.

629 629 


633 633 

634Когда на хосте заканчивается память, супервизор сначала останавливает неактивные незакреплённые сеансы и останавливает неактивные закреплённые сеансы только в том случае, если это ничего не освободило.634Когда на хосте заканчивается память, супервизор сначала останавливает неактивные незакреплённые сеансы и останавливает неактивные закреплённые сеансы только в том случае, если это ничего не освободило.

635 635 

636Супервизор наблюдает установленный двоичный файл Claude Code на диске и перезапускается в новую версию после того, как обычный [auto-updater](/ru/setup#auto-updates) его заменит. Это локальное наблюдение файла, а не сетевая проверка. Фоновые сеансы — это отсоединённые процессы, поэтому они продолжают работать через перезагрузку и новый супервизор переподключается к ним. Неактивный закреплённый сеанс также перезапускается на месте в новую версию, чтобы он получил обновление без необходимости переподключения.636Супервизор наблюдает установленный двоичный файл Claude Code на диске и перезапускается в новую версию после того, как обычный [auto-updater](/docs/ru/setup#auto-updates) его заменит. Это локальное наблюдение файла, а не сетевая проверка. Фоновые сеансы — это отсоединённые процессы, поэтому они продолжают работать через перезагрузку и новый супервизор переподключается к ним. Неактивный закреплённый сеанс также перезапускается на месте в новую версию, чтобы он получил обновление без необходимости переподключения.

637 637 

638После того как новый супервизор берёт на себя управление, он также перезапускает оставшиеся неактивные сеансы в новую версию, несколько за раз в фоне, после короткой задержки, которая позволяет терминалам, подключённым через перезагрузку, переподключиться в первую очередь. Сеанс, который работает, ждёт вашего ввода или имеет подключённый терминал, не прерывается; он переходит на новую версию в следующий раз, когда его процесс перезапускается. До версии 2.1.206 супервизор перемещал только несколько неактивных сеансов в минуту на новую версию, поэтому сеансы могли продолжать работать на старой версии некоторое время после обновления.638После того как новый супервизор берёт на себя управление, он также перезапускает оставшиеся неактивные сеансы в новую версию, несколько за раз в фоне, после короткой задержки, которая позволяет терминалам, подключённым через перезагрузку, переподключиться в первую очередь. Сеанс, который работает, ждёт вашего ввода или имеет подключённый терминал, не прерывается; он переходит на новую версию в следующий раз, когда его процесс перезапускается. До версии 2.1.206 супервизор перемещал только несколько неактивных сеансов в минуту на новую версию, поэтому сеансы могли продолжать работать на старой версии некоторое время после обновления.

639 639 


645 Где хранится состояние645 Где хранится состояние

646</h3>646</h3>

647 647 

648Состояние сеанса хранится в каталоге конфигурации Claude Code. Если вы установили [`CLAUDE_CONFIG_DIR`](/ru/env-vars), супервизор использует этот каталог вместо `~/.claude` и запускается как отдельный экземпляр со своими собственными сеансами.648Состояние сеанса хранится в каталоге конфигурации Claude Code. Если вы установили [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars), супервизор использует этот каталог вместо `~/.claude` и запускается как отдельный экземпляр со своими собственными сеансами.

649 649 

650| Путь | Содержимое |650| Путь | Содержимое |

651| :------------------------------- | :------------------------------------------------------------------------------------------------------------- |651| :------------------------------- | :------------------------------------------------------------------------------------------------------------- |


660 660 

661Команда также предупреждает, когда работающий супервизор находится на другой версии, чем `claude`, который вы вызвали, что происходит после обновления, в которое супервизор ещё не перезагрузился. Предупреждение показывает обе версии и говорит вам запустить `claude daemon stop --any` для получения новой версии. Когда Claude Code установлен как служба ОС, предлагаемая команда — это `claude daemon stop` без флага.661Команда также предупреждает, когда работающий супервизор находится на другой версии, чем `claude`, который вы вызвали, что происходит после обновления, в которое супервизор ещё не перезагрузился. Предупреждение показывает обе версии и говорит вам запустить `claude daemon stop --any` для получения новой версии. Когда Claude Code установлен как служба ОС, предлагаемая команда — это `claude daemon stop` без флага.

662 662 

663Сеансы сохраняют эту версию несовпадения нетронутыми: более старая версия Claude Code, которая обновляет `state.json` сеанса, сохраняет поля, которые она не распознаёт, и сохраняет сеанс в списке. {/* min-version: 2.1.200 */}Список сеансов в `roster.json` следует тому же правилу: более старая версия, которая переписывает его, сохраняет поля, которые написала более новая версия, поэтому сеансы, запущенные более новой версией, остаются доступными и продолжают принимать ввод после перезагрузки супервизора. До версии 2.1.200 более старые версии могли удалить эти поля при переписывании.663Сеансы сохраняют эту версию несовпадения нетронутыми: более старая версия Claude Code, которая обновляет `state.json` сеанса, сохраняет поля, которые она не распознаёт, и сохраняет сеанс в списке. Список сеансов в `roster.json` следует тому же правилу: более старая версия, которая переписывает его, сохраняет поля, которые написала более новая версия, поэтому сеансы, запущенные более новой версией, остаются доступными и продолжают принимать ввод после перезагрузки супервизора. До версии 2.1.200 более старые версии могли удалить эти поля при переписывании.

664 664 

665На Windows `claude daemon status` выводит основную ошибку файла, когда файл ключа pipe супервизора заблокирован или нечитаем, вместо того чтобы сообщать об общей ошибке подключения.665На Windows `claude daemon status` выводит основную ошибку файла, когда файл ключа pipe супервизора заблокирован или нечитаем, вместо того чтобы сообщать об общей ошибке подключения.

666 666 


668 Отключение представления агента668 Отключение представления агента

669</h3>669</h3>

670 670 

671Чтобы полностью отключить фоновых агентов и представление агента, установите параметр `disableAgentView` [setting](/ru/settings) на `true` или установите переменную окружения `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Администраторы могут применить это через [управляемые настройки](/ru/permissions#managed-settings).671Чтобы полностью отключить фоновых агентов и представление агента, установите параметр `disableAgentView` [setting](/docs/ru/settings) на `true` или установите переменную окружения `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Администраторы могут применить это через [управляемые настройки](/docs/ru/permissions#managed-settings).

672 672 

673<h2 id="troubleshooting">673<h2 id="troubleshooting">

674 Troubleshooting674 Troubleshooting


692 Backgrounding показывает диалог `Background this session?`692 Backgrounding показывает диалог `Background this session?`

693</h3>693</h3>

694 694 

695Если нажатие `←` для отправки текущего сеанса в фоновый режим показывает диалог `Background this session?`, сеанс имеет выполняемую работу, которая не может перейти в фоновый сеанс, такую как работающий [monitor](/ru/tools-reference#monitor-tool), и Claude Code не будет молча её останавливать. Диалог называет работу, которая будет остановлена, и отдельно считает задачи, которые переносятся. Запустите `/tasks`, чтобы увидеть всё, что работает, затем подтвердите отправку в фон или выберите `Stay`, чтобы позволить работе завершиться сначала. См. [From inside a session](#from-inside-a-session) для того, какие типы задач переносятся и какие останавливаются.695Если нажатие `←` для отправки текущего сеанса в фоновый режим показывает диалог `Background this session?`, сеанс имеет выполняемую работу, которая не может перейти в фоновый сеанс, такую как работающий [monitor](/docs/ru/tools-reference#monitor-tool), и Claude Code не будет молча её останавливать. Диалог называет работу, которая будет остановлена, и отдельно считает задачи, которые переносятся. Запустите `/tasks`, чтобы увидеть всё, что работает, затем подтвердите отправку в фон или выберите `Stay`, чтобы позволить работе завершиться сначала. См. [From inside a session](#from-inside-a-session) для того, какие типы задач переносятся и какие останавливаются.

696 696 

697<h3 id="prompt-rejected-as-too-short">697<h3 id="prompt-rejected-as-too-short">

698 Подсказка отклонена как слишком короткая698 Подсказка отклонена как слишком короткая


754 754 

755Следующий `claude agents` или `claude --bg` запускает свежий супервизор, который читает ваши сохранённые учётные данные. Если вы аутентифицируетесь с помощью переменной окружения, такой как `ANTHROPIC_API_KEY`, а не `/login`, запустите эту следующую команду из оболочки, где переменная установлена.755Следующий `claude agents` или `claude --bg` запускает свежий супервизор, который читает ваши сохранённые учётные данные. Если вы аутентифицируетесь с помощью переменной окружения, такой как `ANTHROPIC_API_KEY`, а не `/login`, запустите эту следующую команду из оболочки, где переменная установлена.

756 756 

757См. [справочник по ошибкам](/ru/errors#could-not-resolve-authentication-method) для полного списка причин и исправлений.757См. [справочник по ошибкам](/docs/ru/errors#could-not-resolve-authentication-method) для полного списка причин и исправлений.

758 758 

759<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">759<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">

760 Фоновые сеансы не могут читать Desktop, Documents или Downloads на macOS760 Фоновые сеансы не могут читать Desktop, Documents или Downloads на macOS


768 Фоновые сеансы не могут достичь хостов локальной сети на macOS768 Фоновые сеансы не могут достичь хостов локальной сети на macOS

769</h3>769</h3>

770 770 

771На macOS 15 и более поздних версиях система блокирует процесс от доступа к устройствам в вашей локальной сети, пока вы не предоставите разрешение Local Network. До версии 2.1.198 хост фонового сеанса никогда не запрашивал это разрешение, поэтому команды, нацеленные на адрес LAN, завершались с ошибкой `connect: no route to host`, даже если та же команда работала в переднем терминале. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, первая команда в фоновом сеансе, которая подключается к адресу локальной сети, запускает запрос разрешения macOS Local Network для Claude Code. Предоставьте его один раз, и эти команды будут достигать хостов LAN так же, как они это делают в переднем терминале.771На macOS 15 и более поздних версиях система блокирует процесс от доступа к устройствам в вашей локальной сети, пока вы не предоставите разрешение Local Network. До версии 2.1.198 хост фонового сеанса никогда не запрашивал это разрешение, поэтому команды, нацеленные на адрес LAN, завершались с ошибкой `connect: no route to host`, даже если та же команда работала в переднем терминале. Начиная с версии 2.1.198, первая команда в фоновом сеансе, которая подключается к адресу локальной сети, запускает запрос разрешения macOS Local Network для Claude Code. Предоставьте его один раз, и эти команды будут достигать хостов LAN так же, как они это делают в переднем терминале.

772 772 

773<h3 id="a-session-is-slow-to-respond-after-attaching">773<h3 id="a-session-is-slow-to-respond-after-attaching">

774 Сеанс медленно реагирует после подключения774 Сеанс медленно реагирует после подключения


782 `.claude/worktrees/` заполняется782 `.claude/worktrees/` заполняется

783</h3>783</h3>

784 784 

785Удаление сеанса в представлении агентов удаляет рабочее дерево, которое Claude создал для него, и рабочее дерево, которое не может быть удалено безопасно, [сохраняет свою строку сеанса](#organize-the-list), чтобы оно не было потеряно. `claude rm` сохраняет рабочее дерево, которое имеет незафиксированные изменения, и его строку сеанса, и выводит сохранённый путь. Перечислите оставшиеся записи с помощью `git worktree list` в каталоге проекта и удалите каждую с помощью `git worktree remove <path>`. См. [Clean up worktrees](/ru/worktrees#clean-up-worktrees).785Удаление сеанса в представлении агентов удаляет рабочее дерево, которое Claude создал для него, и рабочее дерево, которое не может быть удалено безопасно, [сохраняет свою строку сеанса](#organize-the-list), чтобы оно не было потеряно. `claude rm` сохраняет рабочее дерево, которое имеет незафиксированные изменения, и его строку сеанса, и выводит сохранённый путь. Перечислите оставшиеся записи с помощью `git worktree list` в каталоге проекта и удалите каждую с помощью `git worktree remove <path>`. См. [Clean up worktrees](/docs/ru/worktrees#clean-up-worktrees).

786 786 

787<h2 id="limitations">787<h2 id="limitations">

788 Ограничения788 Ограничения


800 800 

801Для других способов запуска Claude параллельно см.:801Для других способов запуска Claude параллельно см.:

802 802 

803* [Запуск агентов параллельно](/ru/agents): сравните agent view с subagents, agent teams и worktrees803* [Запуск агентов параллельно](/docs/ru/agents): сравните agent view с subagents, agent teams и worktrees

804* [Agent teams](/ru/agent-teams): координируйте несколько сеансов, которые обмениваются сообщениями друг с другом804* [Agent teams](/docs/ru/agent-teams): координируйте несколько сеансов, которые обмениваются сообщениями друг с другом

805* [Claude Code on the web](/ru/claude-code-on-the-web): запускайте сеансы в управляемой облачной среде вместо локально805* [Claude Code on the web](/docs/ru/claude-code-on-the-web): запускайте сеансы в управляемой облачной среде вместо локально

806 806 

807<h2 id="version-history">807<h2 id="version-history">

808 История версий808 История версий


811Agent view быстро развивался во время исследовательского предпросмотра. Если вы находитесь на более старой версии Claude Code, некоторое поведение на этой странице может отличаться; в частности, `claude agents` отклоняет флаги, которые он ещё не поддерживает, с ошибкой `unknown option`. Таблица ниже указывает, когда каждый флаг и поведение были добавлены.811Agent view быстро развивался во время исследовательского предпросмотра. Если вы находитесь на более старой версии Claude Code, некоторое поведение на этой странице может отличаться; в частности, `claude agents` отклоняет флаги, которые он ещё не поддерживает, с ошибкой `unknown option`. Таблица ниже указывает, когда каждый флаг и поведение были добавлены.

812 812 

813| Версия | Изменение |813| Версия | Изменение |

814| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |814| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

815| v2.1.208 | {/* min-version: 2.1.208 */}Подключение к сеансу, процесс которого остановился, показывает последний экран его стенограммы во время запуска процесса вместо только заметки `Session is starting`. Ответ, который не может быть доставлен, потому что фоновый сервис недоступен или отправка не удаётся, сохраняется и отправляется как следующий запрос сеанса при перезапуске его процесса; до этого выпуска ответ, потерянный, когда фоновый сервис был недоступен, был отброшен. Процесс, чей собственный двоичный файл был заменён обновлением, всё ещё может запустить супервизор из установленного средства запуска `claude` или самой новой версии на диске вместо сбоя до перезагрузки Claude Code. Супервизор, работающий на более старой версии, никогда не перезапускает неактивный сеанс, запущенный более новой версией, на его собственный более старый двоичный файл. Удаление сеанса удаляет его worktree даже после того, как сеанс переместил worktree на другую ветвь, и сохраняет worktree вместе со строкой сеанса, когда worktree имеет коммиты, которые не отправлены никуда, или другой сеанс требует его, вместо уничтожения коммитов или оставления worktree без владельца. `/install-github-app` и список параметров `/mcp` и его действия аутентификации отклоняются в фоновом сеансе с сообщением, указывающим альтернативу; только в v2.1.208 средство выбора `/model` было отклонено таким же образом, и введённая команда `/model <name>` переключала только этот сеанс вместо также сохранения вашей модели по умолчанию. |815| v2.1.208 | Подключение к сеансу, процесс которого остановился, показывает последний экран его стенограммы во время запуска процесса вместо только заметки `Session is starting`. Ответ, который не может быть доставлен, потому что фоновый сервис недоступен или отправка не удаётся, сохраняется и отправляется как следующий запрос сеанса при перезапуске его процесса; до этого выпуска ответ, потерянный, когда фоновый сервис был недоступен, был отброшен. Процесс, чей собственный двоичный файл был заменён обновлением, всё ещё может запустить супервизор из установленного средства запуска `claude` или самой новой версии на диске вместо сбоя до перезагрузки Claude Code. Супервизор, работающий на более старой версии, никогда не перезапускает неактивный сеанс, запущенный более новой версией, на его собственный более старый двоичный файл. Удаление сеанса удаляет его worktree даже после того, как сеанс переместил worktree на другую ветвь, и сохраняет worktree вместе со строкой сеанса, когда worktree имеет коммиты, которые не отправлены никуда, или другой сеанс требует его, вместо уничтожения коммитов или оставления worktree без владельца. `/install-github-app` и список параметров `/mcp` и его действия аутентификации отклоняются в фоновом сеансе с сообщением, указывающим альтернативу; только в v2.1.208 средство выбора `/model` было отклонено таким же образом, и введённая команда `/model <name>` переключала только этот сеанс вместо также сохранения вашей модели по умолчанию. |

816| v2.1.207 | {/* min-version: 2.1.207 */}Панель просмотра открывается с предложением, которое строка усекает, например точный вопрос для сеанса, ожидающего вас, и показывает, как долго заблокированный сеанс ждёт, как одна строка `waiting 3m` вместо добавления одного и того же временного штампа к предложению статуса и вопросу. Вставка одного и того же текста снова в поле отправки расширяет свёрнутый заполнитель `[Pasted text #N]` вместо добавления второго. Фоновый сеанс, названный путём принятия плана, показывает это имя на его строке. Фоновый сеанс, который переместился в worktree, сохраняет свой разговор при перезапуске его процесса из agent view. |816| v2.1.207 | Панель просмотра открывается с предложением, которое строка усекает, например точный вопрос для сеанса, ожидающего вас, и показывает, как долго заблокированный сеанс ждёт, как одна строка `waiting 3m` вместо добавления одного и того же временного штампа к предложению статуса и вопросу. Вставка одного и того же текста снова в поле отправки расширяет свёрнутый заполнитель `[Pasted text #N]` вместо добавления второго. Фоновый сеанс, названный путём принятия плана, показывает это имя на его строке. Фоновый сеанс, который переместился в worktree, сохраняет свой разговор при перезапуске его процесса из agent view. |

817| v2.1.206 | {/* min-version: 2.1.206 */}Резюме строк заполняют оставшуюся ширину строки и усекаются только на правом краю терминала вместо 64 столбцов. После перезапуска супервизора в новую версию Claude Code он перезапускает оставшиеся неактивные фоновые сеансы на эту версию в фоне вместо нескольких в минуту. Удаление сеанса с помощью `Ctrl+X` или `claude rm` также очищает его из списка сеансов супервизора, поэтому строка больше не появляется после перезапуска супервизора. |817| v2.1.206 | Резюме строк заполняют оставшуюся ширину строки и усекаются только на правом краю терминала вместо 64 столбцов. После перезапуска супервизора в новую версию Claude Code он перезапускает оставшиеся неактивные фоновые сеансы на эту версию в фоне вместо нескольких в минуту. Удаление сеанса с помощью `Ctrl+X` или `claude rm` также очищает его из списка сеансов супервизора, поэтому строка больше не появляется после перезапуска супервизора. |

818| v2.1.205 | {/* min-version: 2.1.205 */}Резюме строк показывают собственный однострочный отчёт сеанса, усечённый на 64 столбцах, вместо необработанного вызова инструмента или счётчика `done/total`; строки, сгруппированные по каталогам, открываются с цветным словом состояния. Панель просмотра открывается с полным предложением статуса и, для сеанса, ожидающего вас, его точный вопрос выше поля ввода ответа. Сеансы, которые редактируют, комментируют, закрывают или отмечают pull request как готовый с помощью `gh`, связаны с ним, а не только те, которые создают или проверяют pull request; push связывает pull request даже когда имя локальной ветви не совпадает, и pull request, чей вывод команды создания превысил встроенный лимит, также связан. Ход без читаемого текста сохраняет предыдущее состояние сеанса вместо того, чтобы вернуть его обратно в `Working`. `claude attach` ожидает до примерно 60 секунд сеанс, который перезагружается, со строкой статуса, указывающей причину, вместо сбоя. |818| v2.1.205 | Резюме строк показывают собственный однострочный отчёт сеанса, усечённый на 64 столбцах, вместо необработанного вызова инструмента или счётчика `done/total`; строки, сгруппированные по каталогам, открываются с цветным словом состояния. Панель просмотра открывается с полным предложением статуса и, для сеанса, ожидающего вас, его точный вопрос выше поля ввода ответа. Сеансы, которые редактируют, комментируют, закрывают или отмечают pull request как готовый с помощью `gh`, связаны с ним, а не только те, которые создают или проверяют pull request; push связывает pull request даже когда имя локальной ветви не совпадает, и pull request, чей вывод команды создания превысил встроенный лимит, также связан. Ход без читаемого текста сохраняет предыдущее состояние сеанса вместо того, чтобы вернуть его обратно в `Working`. `claude attach` ожидает до примерно 60 секунд сеанс, который перезагружается, со строкой статуса, указывающей причину, вместо сбоя. |

819| v2.1.203 | {/* min-version: 2.1.203 */}Шлюз `ANTHROPIC_BASE_URL`, экспортированный в оболочке отправки, достигает сеансов, отправленных из неё в тот же каталог, когда супервизор делится этой переменной окружения шлюза, вместо того чтобы быть отброшенным, в то время как экспортированный вместе с ним ключ API был сохранён. `PATH` оболочки отправки применяется к каждому рабочему процессу сеанса. Нажатие `←` во время выполнения подагентов ожидает их вместо перезапуска через десять секунд. Пустой список всегда показывает заголовки разделов с описанием под каждым. Ввод `@` в поле отправки также перечисляет зарегистрированные git worktrees репозитория запуска, которые находятся внутри его дерева каталогов. Усилие, унаследованное от параметра `effortLevel`, следует более поздним редактированиям этого параметра вместо того, чтобы быть зафиксированным при отправке. Открытие остановленного сеанса, чей разговор уже открыт в другом запущенном сеансе, отклоняется с сообщением вместо сбоя строки. Команда, которая недоступна в agent view, оставляет введённый текст в поле ввода. Hook `WorktreeCreate`, который не удаётся вне репозитория git, больше не блокирует сеанс от редактирования файлов. |819| v2.1.203 | Шлюз `ANTHROPIC_BASE_URL`, экспортированный в оболочке отправки, достигает сеансов, отправленных из неё в тот же каталог, когда супервизор делится этой переменной окружения шлюза, вместо того чтобы быть отброшенным, в то время как экспортированный вместе с ним ключ API был сохранён. `PATH` оболочки отправки применяется к каждому рабочему процессу сеанса. Нажатие `←` во время выполнения подагентов ожидает их вместо перезапуска через десять секунд. Пустой список всегда показывает заголовки разделов с описанием под каждым. Ввод `@` в поле отправки также перечисляет зарегистрированные git worktrees репозитория запуска, которые находятся внутри его дерева каталогов. Усилие, унаследованное от параметра `effortLevel`, следует более поздним редактированиям этого параметра вместо того, чтобы быть зафиксированным при отправке. Открытие остановленного сеанса, чей разговор уже открыт в другом запущенном сеансе, отклоняется с сообщением вместо сбоя строки. Команда, которая недоступна в agent view, оставляет введённый текст в поле ввода. Hook `WorktreeCreate`, который не удаётся вне репозитория git, больше не блокирует сеанс от редактирования файлов. |

820| v2.1.202 | {/* min-version: 2.1.202 */}Имя, установленное с помощью `/rename` или `Ctrl+R` в фоновом сеансе, сохраняется при остановке и перезапуске процесса супервизора вместо возврата к имени, с которым был отправлен сеанс. |820| v2.1.202 | Имя, установленное с помощью `/rename` или `Ctrl+R` в фоновом сеансе, сохраняется при остановке и перезапуске процесса супервизора вместо возврата к имени, с которым был отправлен сеанс. |

821| v2.1.200 | {/* min-version: 2.1.200 */}Более старая версия Claude Code, которая переписывает список сеансов в `roster.json`, сохраняет поля, написанные более новой версией, соответствуя существующей гарантии `state.json`, поэтому сеансы, запущенные более новой версией, продолжают принимать ввод после перезапуска супервизора. Когда вы открываете сеанс, который перестал отвечать, супервизор перезапускает его процесс и сеанс продолжает прерванный ответ с того места, где он остановился. |821| v2.1.200 | Более старая версия Claude Code, которая переписывает список сеансов в `roster.json`, сохраняет поля, написанные более новой версией, соответствуя существующей гарантии `state.json`, поэтому сеансы, запущенные более новой версией, продолжают принимать ввод после перезапуска супервизора. Когда вы открываете сеанс, который перестал отвечать, супервизор перезапускает его процесс и сеанс продолжает прерванный ответ с того места, где он остановился. |

822| v2.1.199 | {/* min-version: 2.1.199 */}Фоновый сеанс, процесс которого завершается до завершения запуска на хосте с низкой памятью, показывает `possibly low memory — free some up and retry` в статусе его строки вместо только простой причины выхода. Отправка сеанса в фон с помощью `←` или `/background` переносит его `/color` в новую строку. |822| v2.1.199 | Фоновый сеанс, процесс которого завершается до завершения запуска на хосте с низкой памятью, показывает `possibly low memory — free some up and retry` в статусе его строки вместо только простой причины выхода. Отправка сеанса в фон с помощью `←` или `/background` переносит его `/color` в новую строку. |

823| v2.1.198 | {/* min-version: 2.1.198 */}Agent view отправляет уведомление через `preferredNotifChannel`, когда фоновому сеансу требуется ввод, он завершается или не удаётся, и запускает hook `Notification` с типом `agent_needs_input` или `agent_completed`. `←` и `/exit` внутри `claude attach <id>` возвращаются к agent view вместо выхода в shell; `Ctrl+Z` возвращается в shell. Фоновый сеанс, который изолировал свою работу в worktree, фиксирует, отправляет свою собственную изолированную ветвь, никогда не `main` или `master`, и открывает черновик pull request при завершении вместо предварительного запроса. `/login` запускается в agent view и открывает диалог входа. Диалог выхода `Background work is running` предлагает `Move to background and exit`. Передача выхода также охватывает фоновые подагенты, которые возобновляются из своей стенограммы при следующем пробуждении вместо того, чтобы быть отмеченными как неудачные. `claude --bg` в сочетании с `-p` или `--print` отклоняется с ошибкой. |823| v2.1.198 | Agent view отправляет уведомление через `preferredNotifChannel`, когда фоновому сеансу требуется ввод, он завершается или не удаётся, и запускает hook `Notification` с типом `agent_needs_input` или `agent_completed`. `←` и `/exit` внутри `claude attach <id>` возвращаются к agent view вместо выхода в shell; `Ctrl+Z` возвращается в shell. Фоновый сеанс, который изолировал свою работу в worktree, фиксирует, отправляет свою собственную изолированную ветвь, никогда не `main` или `master`, и открывает черновик pull request при завершении вместо предварительного запроса. `/login` запускается в agent view и открывает диалог входа. Диалог выхода `Background work is running` предлагает `Move to background and exit`. Передача выхода также охватывает фоновые подагенты, которые возобновляются из своей стенограммы при следующем пробуждении вместо того, чтобы быть отмеченными как неудачные. `claude --bg` в сочетании с `-p` или `--print` отклоняется с ошибкой. |

824| v2.1.196 | {/* min-version: 2.1.196 */}Одиночное нажатие `←` отправляет сеанс переднего плана в фон; более ранние версии требовали двух нажатий, с подсказкой в нижнем колонтитуле и подтверждением. `--dangerously-skip-permissions`, переданный в `claude agents`, показывает отказ от ответственности за обход вместо молчаливого отклонения. Интерактивные сеансы, которые вы никогда не называли, имеют стандартное имя, такое как `my-app-3f`, в списках сеансов и `claude agents --json`. Фоновые команды shell и динамические рабочие процессы выживают при остановке, перезапуске или обновлении процесса сеанса, включая на Windows; установите `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1`, чтобы отключить передачу. Стенограмма, неправильно прочитанная как пустая при перезапуске, переименовывается с суффиксом `.orphaned-` вместо удаления. |824| v2.1.196 | Одиночное нажатие `←` отправляет сеанс переднего плана в фон; более ранние версии требовали двух нажатий, с подсказкой в нижнем колонтитуле и подтверждением. `--dangerously-skip-permissions`, переданный в `claude agents`, показывает отказ от ответственности за обход вместо молчаливого отклонения. Интерактивные сеансы, которые вы никогда не называли, имеют стандартное имя, такое как `my-app-3f`, в списках сеансов и `claude agents --json`. Фоновые команды shell и динамические рабочие процессы выживают при остановке, перезапуске или обновлении процесса сеанса, включая на Windows; установите `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1`, чтобы отключить передачу. Стенограмма, неправильно прочитанная как пустая при перезапуске, переименовывается с суффиксом `.orphaned-` вместо удаления. |

825| v2.1.195 | {/* min-version: 2.1.195 */}Выполняемая работа переносится, когда вы отправляете сеанс в фон на Windows тоже; установите `CLAUDE_DISABLE_ADOPT=1`, чтобы остановить её вместо этого. Группа `Completed` заполняет оставшееся вертикальное пространство и заголовок сжимается на коротких терминалах. Более старая версия Claude Code больше не отклоняет поля `state.json` более новых сеансов и не скрывает эти сеансы из `claude agents`. Подключение к остановленному сеансу переключается немедленно вместо показа пустого экрана до пяти секунд. Супервизор, который не может принять подключения, выходит и освобождает свою блокировку самостоятельно. |825| v2.1.195 | Выполняемая работа переносится, когда вы отправляете сеанс в фон на Windows тоже; установите `CLAUDE_DISABLE_ADOPT=1`, чтобы остановить её вместо этого. Группа `Completed` заполняет оставшееся вертикальное пространство и заголовок сжимается на коротких терминалах. Более старая версия Claude Code больше не отклоняет поля `state.json` более новых сеансов и не скрывает эти сеансы из `claude agents`. Подключение к остановленному сеансу переключается немедленно вместо показа пустого экрана до пяти секунд. Супервизор, который не может принять подключения, выходит и освобождает свою блокировку самостоятельно. |

826| v2.1.174 | {/* min-version: 2.1.174 */}Фоновые сеансы больше не наследуют переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL`, из оболочки запуска супервизора; супервизор предоставляет свежий снимок учётных данных предварительно прогретым рабочим процессам, исправляя ошибки `Could not resolve authentication method`. |826| v2.1.174 | Фоновые сеансы больше не наследуют переменные конечной точки шлюза, такие как `ANTHROPIC_BASE_URL`, из оболочки запуска супервизора; супервизор предоставляет свежий снимок учётных данных предварительно прогретым рабочим процессам, исправляя ошибки `Could not resolve authentication method`. |

827| v2.1.172 | {/* min-version: 2.1.172 */}Команда `/model` в поле отправки устанавливает переопределение модели отправки с областью действия сеанса. |827| v2.1.172 | Команда `/model` в поле отправки устанавливает переопределение модели отправки с областью действия сеанса. |

828| v2.1.161 | {/* min-version: 2.1.161 */}Резюме строк показывают счётчик `done/total` для параллельных рабочих элементов; панель просмотра называет самый долгоживущий параллельный рабочий элемент. |828| v2.1.161 | Резюме строк показывают счётчик `done/total` для параллельных рабочих элементов; панель просмотра называет самый долгоживущий параллельный рабочий элемент. |

829| v2.1.157 | {/* min-version: 2.1.157 */}Команда `claude agents` принимает `--agent`; отправленные сеансы соблюдают параметр `agent`. |829| v2.1.157 | Команда `claude agents` принимает `--agent`; отправленные сеансы соблюдают параметр `agent`. |

830| v2.1.145 | {/* min-version: 2.1.145 */}Голосовая диктовка поддерживается в входе ответа панели просмотра и входе отправки. |830| v2.1.145 | Голосовая диктовка поддерживается в входе ответа панели просмотра и входе отправки. |

831| v2.1.143 | {/* min-version: 2.1.143 */}Параметр `worktree.bgIsolation` добавлен; `claude agents` принимает `--allow-dangerously-skip-permissions`. |831| v2.1.143 | Параметр `worktree.bgIsolation` добавлен; `claude agents` принимает `--allow-dangerously-skip-permissions`. |

832| v2.1.142 | {/* min-version: 2.1.142 */}Команда `claude agents` принимает `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` и `--strict-mcp-config`. |832| v2.1.142 | Команда `claude agents` принимает `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` и `--strict-mcp-config`. |

833| v2.1.141 | {/* min-version: 2.1.141 */}Команда `claude agents` принимает `--cwd` для ограничения списка одним проектом. |833| v2.1.141 | Команда `claude agents` принимает `--cwd` для ограничения списка одним проектом. |

834| v2.1.139 | {/* min-version: 2.1.139 */}Agent view представлен как исследовательский предпросмотр. |834| v2.1.139 | Agent view представлен как исследовательский предпросмотр. |

agents.md +25 −25

Details

6 6 

7> Сравните способы, которыми Claude Code может выполнять несколько задач одновременно: подагенты, представление агентов, команды агентов и динамические рабочие процессы.7> Сравните способы, которыми Claude Code может выполнять несколько задач одновременно: подагенты, представление агентов, команды агентов и динамические рабочие процессы.

8 8 

9[Subagents](/ru/sub-agents), [agent view](/ru/agent-view), [agent teams](/ru/agent-teams) и [dynamic workflows](/ru/workflows) каждый параллелизирует работу по-разному. Правильный выбор зависит от того, хотите ли вы оставаться в каждом разговоре сами, передать задачи и вернуться позже, или позволить Claude координировать группу работников для вас.9[Subagents](/docs/ru/sub-agents), [agent view](/docs/ru/agent-view), [agent teams](/docs/ru/agent-teams) и [dynamic workflows](/docs/ru/workflows) каждый параллелизирует работу по-разному. Правильный выбор зависит от того, хотите ли вы оставаться в каждом разговоре сами, передать задачи и вернуться позже, или позволить Claude координировать группу работников для вас.

10 10 

11| Подход | Что вы получаете | Используйте, когда |11| Подход | Что вы получаете | Используйте, когда |

12| :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |12| :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

13| [Subagents](/ru/sub-agents) | Делегированные работники в одном сеансе, которые выполняют побочную задачу в своем собственном контексте и возвращают резюме | Побочная задача заполнит ваш основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться |13| [Subagents](/docs/ru/sub-agents) | Делегированные работники в одном сеансе, которые выполняют побочную задачу в своем собственном контексте и возвращают резюме | Побочная задача заполнит ваш основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться |

14| [Agent view](/ru/agent-view) | Один экран для отправки и мониторинга сеансов, работающих в фоновом режиме, открывается с помощью `claude agents`. Предварительный просмотр исследования | У вас есть несколько независимых задач, и вы хотите их передать, проверить статус с первого взгляда и вмешаться только когда один из них нуждается в вас |14| [Agent view](/docs/ru/agent-view) | Один экран для отправки и мониторинга сеансов, работающих в фоновом режиме, открывается с помощью `claude agents`. Предварительный просмотр исследования | У вас есть несколько независимых задач, и вы хотите их передать, проверить статус с первого взгляда и вмешаться только когда один из них нуждается в вас |

15| [Agent teams](/ru/agent-teams) | Несколько координируемых сеансов с общим списком задач и обменом сообщениями между агентами, управляемые лидером. Экспериментальная функция и отключена по умолчанию | Вы хотите, чтобы Claude разделил проект на части, назначил их и держал работников в синхронизации |15| [Agent teams](/docs/ru/agent-teams) | Несколько координируемых сеансов с общим списком задач и обменом сообщениями между агентами, управляемые лидером. Экспериментальная функция и отключена по умолчанию | Вы хотите, чтобы Claude разделил проект на части, назначил их и держал работников в синхронизации |

16| [Dynamic workflows](/ru/workflows) | Скрипт, который запускает множество подагентов и проверяет их результаты, для работы, которая слишком велика для координации за один ход или которая требует более одного прохода | Задача слишком велика для нескольких подагентов, или вы хотите, чтобы результаты были проверены друг против друга: аудит всей кодовой базы, миграция 500 файлов, перепроверенное исследование или план, разработанный с нескольких углов |16| [Dynamic workflows](/docs/ru/workflows) | Скрипт, который запускает множество подагентов и проверяет их результаты, для работы, которая слишком велика для координации за один ход или которая требует более одного прохода | Задача слишком велика для нескольких подагентов, или вы хотите, чтобы результаты были проверены друг против друга: аудит всей кодовой базы, миграция 500 файлов, перепроверенное исследование или план, разработанный с нескольких углов |

17 17 

18В каждом подходе работники — это сеансы Claude. Чтобы задействовать другой инструмент, предоставьте его Claude как [MCP server](/ru/mcp).18В каждом подходе работники — это сеансы Claude. Чтобы задействовать другой инструмент, предоставьте его Claude как [MCP server](/docs/ru/mcp).

19 19 

20Два дополнительных инструмента поддерживают эту работу, не являясь способом запуска агентов:20Два дополнительных инструмента поддерживают эту работу, не являясь способом запуска агентов:

21 21 

22* [Worktrees](/ru/worktrees) дают каждому сеансу отдельный git checkout, поэтому параллельные сеансы никогда не редактируют одни и те же файлы. Используйте их для сеансов, которые вы запускаете сами. Agent view автоматически перемещает каждый отправленный сеанс в его собственный worktree, и подагенты, которых вы порождаете, могут получить свой собственный.22* [Worktrees](/docs/ru/worktrees) дают каждому сеансу отдельный git checkout, поэтому параллельные сеансы никогда не редактируют одни и те же файлы. Используйте их для сеансов, которые вы запускаете сами. Agent view автоматически перемещает каждый отправленный сеанс в его собственный worktree, и подагенты, которых вы порождаете, могут получить свой собственный.

23* [`/batch`](/ru/commands) — это [skill](/ru/skills), который заставляет Claude разделить одно большое изменение на 5–30 worktree-изолированных подагентов, каждый из которых открывает pull request. Это упакованное использование подагентов и worktrees, а не отдельный стиль координации.23* [`/batch`](/docs/ru/commands) — это [skill](/docs/ru/skills), который заставляет Claude разделить одно большое изменение на 5–30 worktree-изолированных подагентов, каждый из которых открывает pull request. Это упакованное использование подагентов и worktrees, а не отдельный стиль координации.

24 24 

25Несколько других функций запускают Claude без того, чтобы вы управляли каждым шагом, но они решают другую проблему, чем разделение работы между агентами:25Несколько других функций запускают Claude без того, чтобы вы управляли каждым шагом, но они решают другую проблему, чем разделение работы между агентами:

26 26 

27* [Фоновая bash команда](/ru/interactive-mode#background-bash-commands) запускает одну команду оболочки без блокировки разговора. Она не порождает агента.27* [Фоновая bash команда](/docs/ru/interactive-mode#background-bash-commands) запускает одну команду оболочки без блокировки разговора. Она не порождает агента.

28* [Разветвленный подагент](/ru/sub-agents#fork-the-current-conversation) — это подагент, который наследует полный контекст вашего разговора вместо того, чтобы начинать с нуля. Это способ порождения подагента, а не отдельная поверхность.28* [Разветвленный подагент](/docs/ru/sub-agents#fork-the-current-conversation) — это подагент, который наследует полный контекст вашего разговора вместо того, чтобы начинать с нуля. Это способ порождения подагента, а не отдельная поверхность.

29* [Routine](/ru/routines) запускает сеанс по расписанию в облаке Anthropic, а не параллельно на вашей машине.29* [Routine](/docs/ru/routines) запускает сеанс по расписанию в облаке Anthropic, а не параллельно на вашей машине.

30 30 

31<Note>31<Note>

32 Запуск нескольких сеансов или подагентов одновременно увеличивает использование токенов. Подробнее см. [Costs](/ru/costs) для информации об использовании и ограничениях скорости.32 Запуск нескольких сеансов или подагентов одновременно увеличивает использование токенов. Подробнее см. [Costs](/docs/ru/costs) для информации об использовании и ограничениях скорости.

33</Note>33</Note>

34 34 

35<h2 id="choose-an-approach">35<h2 id="choose-an-approach">


39Правильный подход зависит от того, кто координирует работу, нужны ли работникам общаться и редактируют ли они одни и те же файлы:39Правильный подход зависит от того, кто координирует работу, нужны ли работникам общаться и редактируют ли они одни и те же файлы:

40 40 

41* **Кто координирует работу?**41* **Кто координирует работу?**

42 * Claude делегирует и собирает результаты в одном разговоре: [subagents](/ru/sub-agents)42 * Claude делегирует и собирает результаты в одном разговоре: [subagents](/docs/ru/sub-agents)

43 * Вы передаёте независимые задачи и проверяете их позже: [agent view](/ru/agent-view)43 * Вы передаёте независимые задачи и проверяете их позже: [agent view](/docs/ru/agent-view)

44 * Claude планирует, назначает и контролирует группу работников: [agent teams](/ru/agent-teams), экспериментальная функция, отключена по умолчанию44 * Claude планирует, назначает и контролирует группу работников: [agent teams](/docs/ru/agent-teams), экспериментальная функция, отключена по умолчанию

45 * Скрипт держит координацию вместо пошагового суждения Claude: [dynamic workflows](/ru/workflows). См. [как workflows сравниваются с subagents и skills](/ru/workflows#when-to-use-a-workflow)45 * Скрипт держит координацию вместо пошагового суждения Claude: [dynamic workflows](/docs/ru/workflows). См. [как workflows сравниваются с subagents и skills](/docs/ru/workflows#when-to-use-a-workflow)

46* **Нужны ли работникам общаться друг с другом?** Subagents сообщают результаты обратно в разговор, который их породил, а сеансы agent view сообщают только вам. Товарищи по команде в команде агентов делят список задач и обмениваются сообщениями напрямую.46* **Нужны ли работникам общаться друг с другом?** Subagents сообщают результаты обратно в разговор, который их породил, а сеансы agent view сообщают только вам. Товарищи по команде в команде агентов делят список задач и обмениваются сообщениями напрямую.

47* **Затрагивают ли задачи одни и те же файлы?** Изолируйте работу с помощью [worktrees](/ru/worktrees). Subagents и сеансы, которые вы запускаете сами, могут каждый использовать отдельный worktree. Agent teams не изолируют товарищей по команде в worktrees, поэтому [разделите работу](/ru/agent-teams#avoid-file-conflicts) так, чтобы каждый товарищ по команде владел другим набором файлов.47* **Затрагивают ли задачи одни и те же файлы?** Изолируйте работу с помощью [worktrees](/docs/ru/worktrees). Subagents и сеансы, которые вы запускаете сами, могут каждый использовать отдельный worktree. Agent teams не изолируют товарищей по команде в worktrees, поэтому [разделите работу](/docs/ru/agent-teams#avoid-file-conflicts) так, чтобы каждый товарищ по команде владел другим набором файлов.

48 48 

49<h2 id="check-on-running-work">49<h2 id="check-on-running-work">

50 Проверьте выполняемую работу50 Проверьте выполняемую работу


52 52 

53Команда для проверки выполняемой работы зависит от того, какой подход вы использовали:53Команда для проверки выполняемой работы зависит от того, какой подход вы использовали:

54 54 

55* Для фоновых сеансов `claude agents` открывает [agent view](/ru/agent-view): один экран, показывающий каждый сеанс, его состояние и какие из них нуждаются в вашем вводе.55* Для фоновых сеансов `claude agents` открывает [agent view](/docs/ru/agent-view): один экран, показывающий каждый сеанс, его состояние и какие из них нуждаются в вашем вводе.

56* Для подагентов в текущем сеансе именованные фоновые подагенты появляются в typeahead @-упоминания с их статусом. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, `/agents` больше не открывает панель; он выводит уведомление, указывающее на расположение файлов подагентов. Чтобы [создавать и редактировать пользовательские подагенты](/ru/sub-agents#configure-subagents), попросите Claude или отредактируйте файлы напрямую. Несмотря на похожее имя, `/agents` отделен от `claude agents`.56* Для подагентов в текущем сеансе именованные фоновые подагенты появляются в typeahead @-упоминания с их статусом. Начиная с версии 2.1.198, `/agents` больше не открывает панель; он выводит уведомление, указывающее на расположение файлов подагентов. Чтобы [создавать и редактировать пользовательские подагенты](/docs/ru/sub-agents#configure-subagents), попросите Claude или отредактируйте файлы напрямую. Несмотря на похожее имя, `/agents` отделен от `claude agents`.

57* Для всего, что работает в фоновом режиме текущего сеанса, `/tasks` перечисляет каждый элемент и позволяет вам проверить, присоединиться или остановить его. Список также включает подагентов, которые завершили работу.57* Для всего, что работает в фоновом режиме текущего сеанса, `/tasks` перечисляет каждый элемент и позволяет вам проверить, присоединиться или остановить его. Список также включает подагентов, которые завершили работу.

58* Для динамических рабочих процессов `/workflows` перечисляет запущенные и завершенные запуски, фазу, в которой находится каждый из них, и сколько агентов завершило работу.58* Для динамических рабочих процессов `/workflows` перечисляет запущенные и завершенные запуски, фазу, в которой находится каждый из них, и сколько агентов завершило работу.

59 59 

60Для представления на рабочем столе всех ваших сеансов см. [параллельные сеансы в приложении для рабочего стола](/ru/desktop#work-in-parallel-with-sessions).60Для представления на рабочем столе всех ваших сеансов см. [параллельные сеансы в приложении для рабочего стола](/docs/ru/desktop#work-in-parallel-with-sessions).

61 61 

62<h2 id="learn-more">62<h2 id="learn-more">

63 Узнайте больше63 Узнайте больше


65 65 

66Каждое руководство ниже охватывает настройку и конфигурацию для одного подхода:66Каждое руководство ниже охватывает настройку и конфигурацию для одного подхода:

67 67 

68* [Create custom subagents](/ru/sub-agents): определите переиспользуемых специалистов и контролируйте, какие инструменты они могут использовать.68* [Create custom subagents](/docs/ru/sub-agents): определите переиспользуемых специалистов и контролируйте, какие инструменты они могут использовать.

69* [Manage agents with agent view](/ru/agent-view): отправляйте сеансы, наблюдайте их состояние и присоединяйтесь, когда один из них нуждается в вас.69* [Manage agents with agent view](/docs/ru/agent-view): отправляйте сеансы, наблюдайте их состояние и присоединяйтесь, когда один из них нуждается в вас.

70* [Orchestrate agent teams](/ru/agent-teams): установите лидера и товарищей по команде, назначьте задачи и проверьте их работу.70* [Orchestrate agent teams](/docs/ru/agent-teams): установите лидера и товарищей по команде, назначьте задачи и проверьте их работу.

71* [Orchestrate dynamic workflows](/ru/workflows): запустите объединённый workflow или позвольте Claude написать один, который запускает множество subagents и проверяет их результаты друг против друга.71* [Orchestrate dynamic workflows](/docs/ru/workflows): запустите объединённый workflow или позвольте Claude написать один, который запускает множество subagents и проверяет их результаты друг против друга.

72* [Run parallel sessions with worktrees](/ru/worktrees): запустите Claude в изолированном checkout, контролируйте, что копируется, и очищайте после этого.72* [Run parallel sessions with worktrees](/docs/ru/worktrees): запустите Claude в изолированном checkout, контролируйте, что копируется, и очищайте после этого.

amazon-bedrock.md +28 −28

Details

107 </Step>107 </Step>

108 108 

109 <Step title="Следуйте подсказкам мастера">109 <Step title="Следуйте подсказкам мастера">

110 Выберите способ аутентификации в AWS: профиль AWS, обнаруженный из вашей директории `~/.aws`, ключ API Amazon Bedrock, ключ доступа и секрет, или учетные данные уже в вашей среде. Мастер выбирает ваш регион, проверяет, какие модели Claude может вызывать ваша учетная запись, и позволяет вам их закрепить. Он сохраняет результат в блок `env` вашего [файла параметров пользователя](/ru/settings), поэтому вам не нужно самостоятельно экспортировать переменные окружения.110 Выберите способ аутентификации в AWS: профиль AWS, обнаруженный из вашей директории `~/.aws`, ключ API Amazon Bedrock, ключ доступа и секрет, или учетные данные уже в вашей среде. Мастер выбирает ваш регион, проверяет, какие модели Claude может вызывать ваша учетная запись, и позволяет вам их закрепить. Он сохраняет результат в блок `env` вашего [файла параметров пользователя](/docs/ru/settings), поэтому вам не нужно самостоятельно экспортировать переменные окружения.

111 </Step>111 </Step>

112</Steps>112</Steps>

113 113 

114После входа запустите `/setup-bedrock` в любое время, чтобы снова открыть мастер и изменить ваши учетные данные, регион или закрепления моделей. Шаг закрепления модели начинается с ваших текущих закрепленных моделей. Мастер записывает в `~/.claude/settings.json`, или в `$CLAUDE_CONFIG_DIR/settings.json` когда установлена [`CLAUDE_CONFIG_DIR`](/ru/env-vars#variables).114После входа запустите `/setup-bedrock` в любое время, чтобы снова открыть мастер и изменить ваши учетные данные, регион или закрепления моделей. Шаг закрепления модели начинается с ваших текущих закрепленных моделей. Мастер записывает в `~/.claude/settings.json`, или в `$CLAUDE_CONFIG_DIR/settings.json` когда установлена [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars#variables).

115 115 

116<h2 id="set-up-manually">116<h2 id="set-up-manually">

117 Ручная установка117 Ручная установка


162export AWS_PROFILE=your-profile-name162export AWS_PROFILE=your-profile-name

163```163```

164 164 

165Claude Code запрашивает учетные данные роли из региона IAM Identity Center, названного в `sso_region` профиля, который не должен совпадать с регионом, в котором вы запускаете Amazon Bedrock. {/* min-version: 2.1.208 */}В версии 2.1.207 регион Amazon Bedrock переопределял `sso_region`, поэтому профиль, экземпляр IAM Identity Center которого находится в другом регионе, не прошел аутентификацию с ошибкой `Session token not found or invalid`.165Claude Code запрашивает учетные данные роли из региона IAM Identity Center, названного в `sso_region` профиля, который не должен совпадать с регионом, в котором вы запускаете Amazon Bedrock. В версии 2.1.207 регион Amazon Bedrock переопределял `sso_region`, поэтому профиль, экземпляр IAM Identity Center которого находится в другом регионе, не прошел аутентификацию с ошибкой `Session token not found or invalid`.

166 166 

167**Вариант D: учетные данные AWS Management Console**167**Вариант D: учетные данные AWS Management Console**

168 168 


188 188 

189До версии 2.1.207 Claude Code разрешал цепочку при каждом запросе API, поэтому профиль на основе SSO запрашивал свежие учетные данные из IAM Identity Center каждый раз и мог быть ограничен в больших развертываниях.189До версии 2.1.207 Claude Code разрешал цепочку при каждом запросе API, поэтому профиль на основе SSO запрашивал свежие учетные данные из IAM Identity Center каждый раз и мог быть ограничен в больших развертываниях.

190 190 

191Кэш охватывает все варианты учетных данных выше, кроме ключа API Amazon Bedrock, который не использует цепочку поставщика. Чтобы разрешить цепочку при каждом запросе вместо этого, установите [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/ru/env-vars).191Кэш охватывает все варианты учетных данных выше, кроме ключа API Amazon Bedrock, который не использует цепочку поставщика. Чтобы разрешить цепочку при каждом запросе вместо этого, установите [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/docs/ru/env-vars).

192 192 

193Каждое разрешение цепочки истекает через 60 секунд. Если шаг в цепочке зависает, например помощник `credential_process`, который ждет ввода, который он не может получить, запрос завершается с ошибкой [`AWS default-chain credential resolve timed out`](/ru/errors#aws-default-chain-credential-resolve-timed-out). Если ваша цепочка запускает интерактивный вход, который законно требует больше времени, например браузерный SSO с MFA через оболочку, такую как `aws-vault`, повысьте лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/ru/env-vars). До версии 2.1.207 зависшее разрешение учетных данных оставляло запрос в ожидании неопределенно долго.193Каждое разрешение цепочки истекает через 60 секунд. Если шаг в цепочке зависает, например помощник `credential_process`, который ждет ввода, который он не может получить, запрос завершается с ошибкой [`AWS default-chain credential resolve timed out`](/docs/ru/errors#aws-default-chain-credential-resolve-timed-out). Если ваша цепочка запускает интерактивный вход, который законно требует больше времени, например браузерный SSO с MFA через оболочку, такую как `aws-vault`, повысьте лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars). До версии 2.1.207 зависшее разрешение учетных данных оставляло запрос в ожидании неопределенно долго.

194 194 

195<h4 id="advanced-credential-configuration">195<h4 id="advanced-credential-configuration">

196 Расширенная конфигурация учетных данных196 Расширенная конфигурация учетных данных

197</h4>197</h4>

198 198 

199Claude Code поддерживает автоматическое обновление учетных данных для AWS SSO и корпоративных поставщиков идентификации. Добавьте эти параметры в файл параметров Claude Code (см. [Settings](/ru/settings) для расположения файлов).199Claude Code поддерживает автоматическое обновление учетных данных для AWS SSO и корпоративных поставщиков идентификации. Добавьте эти параметры в файл параметров Claude Code (см. [Settings](/docs/ru/settings) для расположения файлов).

200 200 

201Эти два параметра имеют разные условия срабатывания:201Эти два параметра имеют разные условия срабатывания:

202 202 


235}235}

236```236```

237 237 

238{/* min-version: 2.1.181 */}Начиная с Claude Code v2.1.181, плоский вывод из `aws configure export-credentials --format process` также принимается, с теми же ключами на верхнем уровне вместо вложения под `Credentials`.238Начиная с Claude Code v2.1.181, плоский вывод из `aws configure export-credentials --format process` также принимается, с теми же ключами на верхнем уровне вместо вложения под `Credentials`.

239 239 

240`Expiration` является необязательным. {/* min-version: 2.1.176 */}Начиная с Claude Code v2.1.176, когда команда возвращает действительное значение `Expiration` в формате ISO 8601, Claude Code кэширует учетные данные до пяти минут до этого времени. Без него или в более ранних версиях учетные данные кэшируются в течение одного часа.240`Expiration` является необязательным. Начиная с Claude Code v2.1.176, когда команда возвращает действительное значение `Expiration` в формате ISO 8601, Claude Code кэширует учетные данные до пяти минут до этого времени. Без него или в более ранних версиях учетные данные кэшируются в течение одного часа.

241 241 

242Когда вы настраиваете `awsCredentialExport` без `awsAuthRefresh`, Claude Code использует экспортированные учетные данные напрямую и не переразрешает цепочку поставщика учетных данных AWS по умолчанию при запуске. До версии 2.1.206 при запуске также переразрешалась цепочка поставщика по умолчанию, что делало живой вызов SSO или STS вне конфигурации вашего прокси и могло заблокировать первый запрос на несколько минут в сетях с ограниченным исходящим трафиком.242Когда вы настраиваете `awsCredentialExport` без `awsAuthRefresh`, Claude Code использует экспортированные учетные данные напрямую и не переразрешает цепочку поставщика учетных данных AWS по умолчанию при запуске. До версии 2.1.206 при запуске также переразрешалась цепочка поставщика по умолчанию, что делало живой вызов SSO или STS вне конфигурации вашего прокси и могло заблокировать первый запрос на несколько минут в сетях с ограниченным исходящим трафиком.

243 243 


263 263 

264При включении Amazon Bedrock для Claude Code имейте в виду следующее:264При включении Amazon Bedrock для Claude Code имейте в виду следующее:

265 265 

266* {/* min-version: 2.1.172 */}Начиная с версии 2.1.172, вам нужно установить `AWS_REGION` только для переопределения региона вашего профиля AWS или когда ваш профиль не имеет региона. Claude Code разрешает регион в этом порядке:266* Начиная с версии 2.1.172, вам нужно установить `AWS_REGION` только для переопределения региона вашего профиля AWS или когда ваш профиль не имеет региона. Claude Code разрешает регион в этом порядке:

267 267 

268 * `AWS_REGION`268 * `AWS_REGION`

269 * `AWS_DEFAULT_REGION`269 * `AWS_DEFAULT_REGION`


272 272 

273 Активный профиль — это `AWS_PROFILE`, если установлен, иначе `default`. Установите `AWS_SHARED_CREDENTIALS_FILE` или `AWS_CONFIG_FILE` для указания на пути к файлам, отличные от стандартных. Запустите `/status` для просмотра разрешенного региона. Когда регион поступил из ваших файлов конфигурации AWS или стандартного резервного варианта, `/status` также указывает источник. На версии 2.1.171 и более ранних Claude Code не читает файлы конфигурации AWS, поэтому установите `AWS_REGION` явно.273 Активный профиль — это `AWS_PROFILE`, если установлен, иначе `default`. Установите `AWS_SHARED_CREDENTIALS_FILE` или `AWS_CONFIG_FILE` для указания на пути к файлам, отличные от стандартных. Запустите `/status` для просмотра разрешенного региона. Когда регион поступил из ваших файлов конфигурации AWS или стандартного резервного варианта, `/status` также указывает источник. На версии 2.1.171 и более ранних Claude Code не читает файлы конфигурации AWS, поэтому установите `AWS_REGION` явно.

274* При использовании Amazon Bedrock команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные AWS.274* При использовании Amazon Bedrock команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные AWS.

275* Инструмент WebSearch недоступен на Amazon Bedrock. См. [поведение инструмента WebSearch](/ru/tools-reference#websearch-tool-behavior).275* Инструмент WebSearch недоступен на Amazon Bedrock. См. [поведение инструмента WebSearch](/docs/ru/tools-reference#websearch-tool-behavior).

276* Вы можете использовать файлы параметров для переменных окружения, таких как `AWS_PROFILE`, которые вы не хотите утечь в другие процессы. См. [Settings](/ru/settings) для получения дополнительной информации.276* Вы можете использовать файлы параметров для переменных окружения, таких как `AWS_PROFILE`, которые вы не хотите утечь в другие процессы. См. [Settings](/docs/ru/settings) для получения дополнительной информации.

277 277 

278<h3 id="4-pin-model-versions">278<h3 id="4-pin-model-versions">

279 4. Закрепите версии моделей279 4. Закрепите версии моделей


293export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'293export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

294```294```

295 295 

296Эти переменные используют ID профилей вывода между регионами (с префиксом `us.`). Если вы используете другой префикс региона или профили вывода приложения, отрегулируйте соответственно. В регионах AWS GovCloud используйте префикс `us-gov.`. Для текущих и устаревших ID моделей см. [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). См. [Model configuration](/ru/model-config#pin-models-for-third-party-deployments) для полного списка переменных окружения.296Эти переменные используют ID профилей вывода между регионами (с префиксом `us.`). Если вы используете другой префикс региона или профили вывода приложения, отрегулируйте соответственно. В регионах AWS GovCloud используйте префикс `us-gov.`. Для текущих и устаревших ID моделей см. [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). См. [Model configuration](/docs/ru/model-config#pin-models-for-third-party-deployments) для полного списка переменных окружения.

297 297 

298Claude Code использует эти модели по умолчанию, когда переменные закрепления не установлены:298Claude Code использует эти модели по умолчанию, когда переменные закрепления не установлены:

299 299 


311 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развертывание, которое не закрепляет основную модель, выставляется по тарифу Opus после обновления до версии 2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развертывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.311 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развертывание, которое не закрепляет основную модель, выставляется по тарифу Opus после обновления до версии 2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развертывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.

312</Warning>312</Warning>

313 313 

314{/* min-version: 2.1.207 */}До версии 2.1.207 основная модель на Amazon Bedrock по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался на Opus 4.6, и фоновые задачи всегда использовали основную модель.314До версии 2.1.207 основная модель на Amazon Bedrock по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался на Opus 4.6, и фоновые задачи всегда использовали основную модель.

315 315 

316Для дальнейшей настройки моделей используйте один из этих методов:316Для дальнейшей настройки моделей используйте один из этих методов:

317 317 


330export ENABLE_PROMPT_CACHING_1H=1330export ENABLE_PROMPT_CACHING_1H=1

331```331```

332 332 

333TTL кэша в 1 час выставляется по более высокому тарифу, чем стандартный 5-минутный. См. [cache lifetime](/ru/prompt-caching#cache-lifetime).333TTL кэша в 1 час выставляется по более высокому тарифу, чем стандартный 5-минутный. См. [cache lifetime](/docs/ru/prompt-caching#cache-lifetime).

334 334 

335<Note>Prompt caching может быть недоступен во всех регионах Amazon Bedrock. Если количество токенов кэша остается на нуле, проверьте [поддерживаемые модели, регионы и ограничения](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) в документации Amazon Bedrock.</Note>335<Note>Prompt caching может быть недоступен во всех регионах Amazon Bedrock. Если количество токенов кэша остается на нуле, проверьте [поддерживаемые модели, регионы и ограничения](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) в документации Amazon Bedrock.</Note>

336 336 


338 Сопоставьте каждую версию модели с профилем вывода338 Сопоставьте каждую версию модели с профилем вывода

339</h4>339</h4>

340 340 

341Переменные окружения `ANTHROPIC_DEFAULT_*_MODEL` настраивают один профиль вывода на семейство моделей. Если вашей организации необходимо предоставить несколько версий одного семейства в средстве выбора `/model`, каждая маршрутизируется на свой ARN профиля вывода приложения, используйте вместо этого параметр `modelOverrides` в вашем [файле параметров](/ru/settings#settings-files).341Переменные окружения `ANTHROPIC_DEFAULT_*_MODEL` настраивают один профиль вывода на семейство моделей. Если вашей организации необходимо предоставить несколько версий одного семейства в средстве выбора `/model`, каждая маршрутизируется на свой ARN профиля вывода приложения, используйте вместо этого параметр `modelOverrides` в вашем [файле параметров](/docs/ru/settings#settings-files).

342 342 

343Этот пример сопоставляет четыре версии Opus с отдельными ARN, чтобы пользователи могли переключаться между ними без обхода профилей вывода вашей организации:343Этот пример сопоставляет четыре версии Opus с отдельными ARN, чтобы пользователи могли переключаться между ними без обхода профилей вывода вашей организации:

344 344 


353}353}

354```354```

355 355 

356Когда пользователь выбирает одну из этих версий в `/model`, Claude Code вызывает Amazon Bedrock с сопоставленным ARN. {/* min-version: 2.1.200 */}То же сопоставление применяется, когда вы передаете ID модели Anthropic напрямую через `--model` или `ANTHROPIC_MODEL`. Версии без переопределения возвращаются к встроенному ID модели Amazon Bedrock или любому соответствующему профилю вывода, обнаруженному при запуске. До версии 2.1.200 значения `--model` и `ANTHROPIC_MODEL` достигали Amazon Bedrock как есть без прохождения через карту переопределений. См. [Override model IDs per version](/ru/model-config#override-model-ids-per-version) для получения подробной информации о том, как переопределения взаимодействуют с `availableModels` и другими параметрами модели.356Когда пользователь выбирает одну из этих версий в `/model`, Claude Code вызывает Amazon Bedrock с сопоставленным ARN. То же сопоставление применяется, когда вы передаете ID модели Anthropic напрямую через `--model` или `ANTHROPIC_MODEL`. Версии без переопределения возвращаются к встроенному ID модели Amazon Bedrock или любому соответствующему профилю вывода, обнаруженному при запуске. До версии 2.1.200 значения `--model` и `ANTHROPIC_MODEL` достигали Amazon Bedrock как есть без прохождения через карту переопределений. См. [Override model IDs per version](/docs/ru/model-config#override-model-ids-per-version) для получения подробной информации о том, как переопределения взаимодействуют с `availableModels` и другими параметрами модели.

357 357 

358<h2 id="startup-model-checks">358<h2 id="startup-model-checks">

359 Проверки моделей при запуске359 Проверки моделей при запуске


361 361 

362Когда Claude Code запускается с настроенным Amazon Bedrock, он проверяет, что модели, которые он намеревается использовать, доступны в вашей учетной записи.362Когда Claude Code запускается с настроенным Amazon Bedrock, он проверяет, что модели, которые он намеревается использовать, доступны в вашей учетной записи.

363 363 

364Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваша учетная запись может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл параметров пользователя](/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию. Закрепления, указывающие на [ARN профиля вывода приложения](#map-each-model-version-to-an-inference-profile), пропускаются, так как они управляются вашим администратором.364Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваша учетная запись может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл параметров пользователя](/docs/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию. Закрепления, указывающие на [ARN профиля вывода приложения](#map-each-model-version-to-an-inference-profile), пропускаются, так как они управляются вашим администратором.

365 365 

366Если вы не закрепили модель и текущее значение по умолчанию недоступно в вашей учетной записи, Claude Code возвращается к предыдущей версии для текущего сеанса и показывает уведомление. Оно сначала пытается использовать более ранние версии модели по умолчанию и, когда модель по умолчанию является моделью Opus и ни одна версия Opus недоступна, возвращается к модели Sonnet по умолчанию. Возврат не сохраняется. Включите более новую модель в вашей учетной записи Amazon Bedrock или [закрепите версию](#4-pin-model-versions), чтобы сделать выбор постоянным.366Если вы не закрепили модель и текущее значение по умолчанию недоступно в вашей учетной записи, Claude Code возвращается к предыдущей версии для текущего сеанса и показывает уведомление. Оно сначала пытается использовать более ранние версии модели по умолчанию и, когда модель по умолчанию является моделью Opus и ни одна версия Opus недоступна, возвращается к модели Sonnet по умолчанию. Возврат не сохраняется. Включите более новую модель в вашей учетной записи Amazon Bedrock или [закрепите версию](#4-pin-model-versions), чтобы сделать выбор постоянным.

367 367 


426 426 

427Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [окно контекста 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на Amazon Bedrock. Sonnet 5 обслуживается через [конечную точку Mantle](#use-the-mantle-endpoint) и всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное окно контекста при выборе варианта модели 1M.427Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [окно контекста 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на Amazon Bedrock. Sonnet 5 обслуживается через [конечную точку Mantle](#use-the-mantle-endpoint) и всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное окно контекста при выборе варианта модели 1M.

428 428 

429[Мастер установки](#sign-in-with-bedrock) предлагает опцию контекста 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели вместо этого, добавьте `[1m]` к ID модели. См. [Pin models for third-party deployments](/ru/model-config#pin-models-for-third-party-deployments) для получения подробной информации.429[Мастер установки](#sign-in-with-bedrock) предлагает опцию контекста 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели вместо этого, добавьте `[1m]` к ID модели. См. [Pin models for third-party deployments](/docs/ru/model-config#pin-models-for-third-party-deployments) для получения подробной информации.

430 430 

431<h2 id="service-tiers">431<h2 id="service-tiers">

432 Уровни обслуживания432 Уровни обслуживания


444 AWS Guardrails444 AWS Guardrails

445</h2>445</h2>

446 446 

447[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) позволяют вам реализовать фильтрацию контента для Claude Code. Создайте Guardrail в [консоли Amazon Bedrock](https://console.aws.amazon.com/bedrock/), опубликуйте версию, затем добавьте заголовки Guardrail в ваш [файл параметров](/ru/settings). Включите Cross-Region inference на вашем Guardrail, если вы используете профили вывода между регионами.447[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) позволяют вам реализовать фильтрацию контента для Claude Code. Создайте Guardrail в [консоли Amazon Bedrock](https://console.aws.amazon.com/bedrock/), опубликуйте версию, затем добавьте заголовки Guardrail в ваш [файл параметров](/docs/ru/settings). Включите Cross-Region inference на вашем Guardrail, если вы используете профили вывода между регионами.

448 448 

449Пример конфигурации:449Пример конфигурации:

450 450 


473export AWS_REGION=us-east-1473export AWS_REGION=us-east-1

474```474```

475 475 

476Claude Code конструирует URL конечной точки из региона AWS. {/* min-version: 2.1.172 */}Начиная с версии v2.1.172, регион разрешается с той же приоритетностью, что и [Amazon Bedrock выше](#3-configure-claude-code); более ранние версии используют только `AWS_REGION`. Чтобы переопределить URL для пользовательской конечной точки или шлюза, установите `ANTHROPIC_BEDROCK_MANTLE_BASE_URL`.476Claude Code конструирует URL конечной точки из региона AWS. Начиная с версии v2.1.172, регион разрешается с той же приоритетностью, что и [Amazon Bedrock выше](#3-configure-claude-code); более ранние версии используют только `AWS_REGION`. Чтобы переопределить URL для пользовательской конечной точки или шлюза, установите `ANTHROPIC_BEDROCK_MANTLE_BASE_URL`.

477 477 

478Запустите `/status` внутри Claude Code для подтверждения. Строка поставщика показывает `Amazon Bedrock (Mantle)`, когда Mantle активен.478Запустите `/status` внутри Claude Code для подтверждения. Строка поставщика показывает `Amazon Bedrock (Mantle)`, когда Mantle активен.

479 479 


500export CLAUDE_CODE_USE_MANTLE=1500export CLAUDE_CODE_USE_MANTLE=1

501```501```

502 502 

503Чтобы отобразить модель Mantle в средстве выбора `/model`, перечислите ее ID в `availableModels` в вашем [файле параметров](/ru/settings). Этот параметр также ограничивает средство выбора перечисленными записями. Перечисление `anthropic.claude-haiku-4-5` удаляет простой псевдоним `haiku` из средства выбора, поэтому также перечислите префиксы версий или полные ID для версий, которые вы хотите сохранить доступными. ID Mantle и псевдоним `haiku` разрешаются в одно семейство моделей, поэтому объединение сохраняет только более конкретную запись. См. [Merge behavior](/ru/model-config#merge-behavior):503Чтобы отобразить модель Mantle в средстве выбора `/model`, перечислите ее ID в `availableModels` в вашем [файле параметров](/docs/ru/settings). Этот параметр также ограничивает средство выбора перечисленными записями. Перечисление `anthropic.claude-haiku-4-5` удаляет простой псевдоним `haiku` из средства выбора, поэтому также перечислите префиксы версий или полные ID для версий, которые вы хотите сохранить доступными. ID Mantle и псевдоним `haiku` разрешаются в одно семейство моделей, поэтому объединение сохраняет только более конкретную запись. См. [Merge behavior](/docs/ru/model-config#merge-behavior):

504 504 

505```json theme={null}505```json theme={null}

506{506{


508}508}

509```509```

510 510 

511Записи с префиксом `anthropic.` добавляются как пользовательские опции средства выбора и маршрутизируются на Mantle. Замените `anthropic.claude-haiku-4-5` на ID модели, который была предоставлена вашей учетной записи. См. [Restrict model selection](/ru/model-config#restrict-model-selection) для получения информации о том, как `availableModels` взаимодействует с другими параметрами модели.511Записи с префиксом `anthropic.` добавляются как пользовательские опции средства выбора и маршрутизируются на Mantle. Замените `anthropic.claude-haiku-4-5` на ID модели, который была предоставлена вашей учетной записи. См. [Restrict model selection](/docs/ru/model-config#restrict-model-selection) для получения информации о том, как `availableModels` взаимодействует с другими параметрами модели.

512 512 

513Когда оба поставщика активны, `/status` показывает `Amazon Bedrock + Amazon Bedrock (Mantle)`.513Когда оба поставщика активны, `/status` показывает `Amazon Bedrock + Amazon Bedrock (Mantle)`.

514 514 


516 Маршрутизируйте Mantle через шлюз516 Маршрутизируйте Mantle через шлюз

517</h3>517</h3>

518 518 

519Если ваша организация маршрутизирует трафик модели через централизованный [LLM gateway](/ru/llm-gateway), который внедряет учетные данные AWS на стороне сервера, отключите аутентификацию на стороне клиента, чтобы Claude Code отправлял запросы без подписей SigV4 или заголовков `x-api-key`:519Если ваша организация маршрутизирует трафик модели через централизованный [LLM gateway](/docs/ru/llm-gateway), который внедряет учетные данные AWS на стороне сервера, отключите аутентификацию на стороне клиента, чтобы Claude Code отправлял запросы без подписей SigV4 или заголовков `x-api-key`:

520 520 

521```bash theme={null}521```bash theme={null}

522export CLAUDE_CODE_USE_MANTLE=1522export CLAUDE_CODE_USE_MANTLE=1


528 Переменные окружения Mantle528 Переменные окружения Mantle

529</h3>529</h3>

530 530 

531Эти переменные специфичны для конечной точки Mantle. См. [Environment variables](/ru/env-vars) для полного списка.531Эти переменные специфичны для конечной точки Mantle. См. [Environment variables](/docs/ru/env-vars) для полного списка.

532 532 

533| Переменная | Назначение |533| Переменная | Назначение |

534| :-------------------------------------- | :------------------------------------------------------------------------- |534| :-------------------------------------- | :------------------------------------------------------------------------- |


545 Цикл аутентификации с SSO и корпоративными прокси545 Цикл аутентификации с SSO и корпоративными прокси

546</h3>546</h3>

547 547 

548Если вкладки браузера открываются повторно при использовании AWS SSO, удалите параметр `awsAuthRefresh` из вашего [файла параметров](/ru/settings). Это может произойти, когда корпоративные VPN или прокси-серверы с проверкой TLS прерывают браузерный поток SSO. Claude Code рассматривает прерванное соединение как ошибку аутентификации, повторно запускает `awsAuthRefresh` и зацикливается бесконечно.548Если вкладки браузера открываются повторно при использовании AWS SSO, удалите параметр `awsAuthRefresh` из вашего [файла параметров](/docs/ru/settings). Это может произойти, когда корпоративные VPN или прокси-серверы с проверкой TLS прерывают браузерный поток SSO. Claude Code рассматривает прерванное соединение как ошибку аутентификации, повторно запускает `awsAuthRefresh` и зацикливается бесконечно.

549 549 

550Если ваша сетевая среда мешает автоматическим браузерным потокам SSO, используйте `aws sso login` вручную перед запуском Claude Code вместо того, чтобы полагаться на `awsAuthRefresh`.550Если ваша сетевая среда мешает автоматическим браузерным потокам SSO, используйте `aws sso login` вручную перед запуском Claude Code вместо того, чтобы полагаться на `awsAuthRefresh`.

551 551 


573 573 

574До версии v2.1.208 та же неправильная конфигурация проявлялась как `API Error: Truncated event message received` после того, как весь ответ был буферизирован.574До версии v2.1.208 та же неправильная конфигурация проявлялась как `API Error: Truncated event message received` после того, как весь ответ был буферизирован.

575 575 

576Чтобы исправить это, настройте шлюз на передачу тела ответа `InvokeModelWithResponseStream` и его заголовка `Content-Type` без изменений. Если шлюз переписывает только заголовок и передает двоичное тело без изменений, установите [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/ru/env-vars), чтобы пропустить проверку до исправления шлюза. С отключенной проверкой тело ответа, которое было преобразовано, снова завершается с ошибкой `Truncated event message received`.576Чтобы исправить это, настройте шлюз на передачу тела ответа `InvokeModelWithResponseStream` и его заголовка `Content-Type` без изменений. Если шлюз переписывает только заголовок и передает двоичное тело без изменений, установите [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/ru/env-vars), чтобы пропустить проверку до исправления шлюза. С отключенной проверкой тело ответа, которое было преобразовано, снова завершается с ошибкой `Truncated event message received`.

577 577 

578<h3 id="zero-token-counts-in-/context">578<h3 id="zero-token-counts-in-/context">

579 Нулевые подсчеты токенов в /context579 Нулевые подсчеты токенов в /context

580</h3>580</h3>

581 581 

582Команда `/context` подсчитывает токены для каждой группы инструментов, отправляя схемы инструментов в API подсчета токенов Amazon Bedrock. {/* min-version: 2.1.196 */}В версиях Claude Code до v2.1.196 Amazon Bedrock отклонял этот запрос, потому что схемы содержали поля, которые его API подсчета токенов не принимает, поэтому каждая группа инструментов показывала 0 токенов. Другие строки в разбивке, такие как сообщения и файлы памяти, не затронуты.582Команда `/context` подсчитывает токены для каждой группы инструментов, отправляя схемы инструментов в API подсчета токенов Amazon Bedrock. В версиях Claude Code до v2.1.196 Amazon Bedrock отклонял этот запрос, потому что схемы содержали поля, которые его API подсчета токенов не принимает, поэтому каждая группа инструментов показывала 0 токенов. Другие строки в разбивке, такие как сообщения и файлы памяти, не затронуты.

583 583 

584Обновитесь до v2.1.196 или более поздней версии.584Обновитесь до v2.1.196 или более поздней версии.

585 585 


587 Ошибки конечной точки Mantle587 Ошибки конечной точки Mantle

588</h3>588</h3>

589 589 

590Если `/status` не показывает `Amazon Bedrock (Mantle)` после установки `CLAUDE_CODE_USE_MANTLE`, переменная не достигает процесса. Подтвердите, что она экспортирована в оболочке, где вы запустили `claude`, или установите ее в блоке `env` вашего [файла параметров](/ru/settings).590Если `/status` не показывает `Amazon Bedrock (Mantle)` после установки `CLAUDE_CODE_USE_MANTLE`, переменная не достигает процесса. Подтвердите, что она экспортирована в оболочке, где вы запустили `claude`, или установите ее в блоке `env` вашего [файла параметров](/docs/ru/settings).

591 591 

592`403` от конечной точки Mantle с действительными учетными данными означает, что вашей учетной записи AWS не был предоставлен доступ к запрошенной модели. Свяжитесь с вашей командой учетной записи AWS, чтобы запросить доступ.592`403` от конечной точки Mantle с действительными учетными данными означает, что вашей учетной записи AWS не был предоставлен доступ к запрошенной модели. Свяжитесь с вашей командой учетной записи AWS, чтобы запросить доступ.

593 593 

artifacts.md +15 −19

Details

6 6 

7> Артефакты превращают работу Claude Code в живые интерактивные страницы на claude.ai, которые вы можете держать в приватности, делиться с вашей организацией или публиковать по общедоступной ссылке.7> Артефакты превращают работу Claude Code в живые интерактивные страницы на claude.ai, которые вы можете держать в приватности, делиться с вашей организацией или публиковать по общедоступной ссылке.

8 8 

9{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}

10 

11<Note>9<Note>

12 Артефакты доступны на планах Pro, Max, Team и Enterprise и требуют сеанс, вошедший с помощью [`/login`](/ru/setup#authenticate). Полный набор требований см. в разделе [Доступность](#availability).10 Артефакты доступны на планах Pro, Max, Team и Enterprise и требуют сеанс, вошедший с помощью [`/login`](/docs/ru/setup#authenticate). Полный набор требований см. в разделе [Доступность](#availability).

13</Note>11</Note>

14 12 

15Артефакт — это живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai. Вы открываете её в браузере, и она обновляется на месте по мере продолжения сеанса. Поделитесь ею из заголовка страницы, когда захотите, чтобы кто-то ещё её увидел. Например, используйте артефакт, чтобы провести рецензента через pull request с аннотированными diff'ами, создать панель управления из данных сеанса или вести временную шкалу расследования, которая заполняется по мере работы Claude.13Артефакт — это живая интерактивная веб-страница, которую Claude Code публикует из вашего сеанса на приватный URL на claude.ai. Вы открываете её в браузере, и она обновляется на месте по мере продолжения сеанса. Поделитесь ею из заголовка страницы, когда захотите, чтобы кто-то ещё её увидел. Например, используйте артефакт, чтобы провести рецензента через pull request с аннотированными diff'ами, создать панель управления из данных сеанса или вести временную шкалу расследования, которая заполняется по мере работы Claude.


22 Когда использовать артефакт20 Когда использовать артефакт

23</h2>21</h2>

24 22 

25Используйте артефакт, когда текст терминала — неправильный способ для того, что создал Claude: вывод, который легче смотреть и с которым взаимодействовать, чем читать строка за строкой. Claude создаёт страницу из всего, что может достичь ваш сеанс, включая вашу кодовую базу и данные, которые он получает через ваши [подключённые инструменты](/ru/mcp), поэтому страница может показывать вещи, которые потребовали бы абзацев для описания. Например, попросите Claude:23Используйте артефакт, когда текст терминала — неправильный способ для того, что создал Claude: вывод, который легче смотреть и с которым взаимодействовать, чем читать строка за строкой. Claude создаёт страницу из всего, что может достичь ваш сеанс, включая вашу кодовую базу и данные, которые он получает через ваши [подключённые инструменты](/docs/ru/mcp), поэтому страница может показывать вещи, которые потребовали бы абзацев для описания. Например, попросите Claude:

26 24 

27* Провести рецензента через pull request с аннотированными diff'ами25* Провести рецензента через pull request с аннотированными diff'ами

28* Отобразить панель управления из данных, которые сеанс уже получил26* Отобразить панель управления из данных, которые сеанс уже получил


104 Получение живых данных с помощью MCP connectors102 Получение живых данных с помощью MCP connectors

105</h2>103</h2>

106 104 

107{/* plan-availability: feature=artifact-mcp plans=pro,max,team,enterprise providers=anthropic */}105Артефакт может вызывать [MCP connectors](/docs/ru/mcp#use-mcp-servers-from-claude-ai) каждый раз, когда кто-то его просматривает, поэтому страница отображает текущие данные, а не снимок из сеанса, в котором она была создана. Вызовы connectors из артефактов доступны в планах Pro, Max, Team и Enterprise и требуют Claude Code версии 2.1.209 или более поздней. В более ранних версиях Claude публикует страницу с теми данными, которые сеанс собрал во время её создания.

108 

109Артефакт может вызывать [MCP connectors](/ru/mcp#use-mcp-servers-from-claude-ai) каждый раз, когда кто-то его просматривает, поэтому страница отображает текущие данные, а не снимок из сеанса, в котором она была создана. Вызовы connectors из артефактов доступны в планах Pro, Max, Team и Enterprise и требуют Claude Code версии 2.1.209 или более поздней. В более ранних версиях Claude публикует страницу с теми данными, которые сеанс собрал во время её создания.

110 106 

111Чтобы создать страницу с поддержкой connector, назовите connector и данные, которые вам нужны, в вашем запросе:107Чтобы создать страницу с поддержкой connector, назовите connector и данные, которые вам нужны, в вашем запросе:

112 108 


202 Улучшение визуального дизайна198 Улучшение визуального дизайна

203</h2>199</h2>

204 200 

205Начиная с Claude Code v2.1.183, Claude применяет встроенный навык дизайна при создании артефакта, поэтому страницы получают намеренную палитру, типографику и макет без дополнительных подсказок. Этот навык также ищет существующую систему дизайна в вашем проекте перед выбором своей собственной. Чтобы сохранить артефакты согласованными с брендингом вашего продукта, запишите ваши токены дизайна там, где Claude может их найти, например в [CLAUDE.md](/ru/memory) проекта или в файле темы в вашем репозитории:201Начиная с Claude Code v2.1.183, Claude применяет встроенный навык дизайна при создании артефакта, поэтому страницы получают намеренную палитру, типографику и макет без дополнительных подсказок. Этот навык также ищет существующую систему дизайна в вашем проекте перед выбором своей собственной. Чтобы сохранить артефакты согласованными с брендингом вашего продукта, запишите ваши токены дизайна там, где Claude может их найти, например в [CLAUDE.md](/docs/ru/memory) проекта или в файле темы в вашем репозитории:

206 202 

207```markdown theme={null}203```markdown theme={null}

208## Design system204## Design system


243| Requirement | Available when |239| Requirement | Available when |

244| :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |240| :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

245| Plan | Pro, Max, Team или Enterprise. На планах Pro и Max артефакты являются приватными для вас до тех пор, пока вы их не поделитесь, и управление администратором не применяется. На планах Team артефакты включены по умолчанию. На планах Enterprise владелец [включает их](#manage-artifacts-for-your-organization) в параметрах администратора claude.ai. |241| Plan | Pro, Max, Team или Enterprise. На планах Pro и Max артефакты являются приватными для вас до тех пор, пока вы их не поделитесь, и управление администратором не применяется. На планах Team артефакты включены по умолчанию. На планах Enterprise владелец [включает их](#manage-artifacts-for-your-organization) в параметрах администратора claude.ai. |

246| Authentication | Сеанс поддерживается учётной записью claude.ai: войдите с помощью `/login` в CLI или приложении для рабочего стола. Сеансы Claude Tag вошли через идентификацию агента, поэтому никаких шагов не требуется. Сеансы, использующие ключ API, [токен шлюза](/ru/llm-gateway) или учётные данные поставщика облачных услуг, не могут публиковать. |242| Authentication | Сеанс поддерживается учётной записью claude.ai: войдите с помощью `/login` в CLI или приложении для рабочего стола. Сеансы Claude Tag вошли через идентификацию агента, поэтому никаких шагов не требуется. Сеансы, использующие ключ API, [токен шлюза](/docs/ru/llm-gateway) или учётные данные поставщика облачных услуг, не могут публиковать. |

247| Model provider | Anthropic API. Недоступно на [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry). |243| Model provider | Anthropic API. Недоступно на [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) или [Microsoft Foundry](/docs/ru/microsoft-foundry). |

248| Organization policy | Ключи шифрования, управляемые клиентом (CMEK), HIPAA и [Zero Data Retention](/ru/zero-data-retention) не включены для организации. |244| Organization policy | Ключи шифрования, управляемые клиентом (CMEK), HIPAA и [Zero Data Retention](/docs/ru/zero-data-retention) не включены для организации. |

249| Surface | Claude Code CLI версии 2.1.183 или позже, или приложение Claude для рабочего стола версии 1.13576.0 или позже. Сеансы [Claude Tag](https://claude.com/docs/claude-tag/overview) также могут публиковать артефакты, когда оба Claude Tag и артефакты включены для организации. По умолчанию отключено в контекстах [Agent SDK](/ru/agent-sdk/overview), GitHub Action и MCP-server, а также когда установлен [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ru/env-vars). |245| Surface | Claude Code CLI версии 2.1.183 или позже, или приложение Claude для рабочего стола версии 1.13576.0 или позже. Сеансы [Claude Tag](https://claude.com/docs/claude-tag/overview) также могут публиковать артефакты, когда оба Claude Tag и артефакты включены для организации. По умолчанию отключено в контекстах [Agent SDK](/docs/ru/agent-sdk/overview), GitHub Action и MCP-server, а также когда установлен [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars). |

250 246 

251<h2 id="disable-artifacts">247<h2 id="disable-artifacts">

252 Отключение артефактов248 Отключение артефактов


256 252 

257| Метод | Параметр |253| Метод | Параметр |

258| :------------------------------------ | :--------------------------------------- |254| :------------------------------------ | :--------------------------------------- |

259| [Файл параметров](/ru/settings) | `"disableArtifact": true` |255| [Файл параметров](/docs/ru/settings) | `"disableArtifact": true` |

260| [Переменная окружения](/ru/env-vars) | `CLAUDE_CODE_DISABLE_ARTIFACT=1` |256| [Переменная окружения](/docs/ru/env-vars) | `CLAUDE_CODE_DISABLE_ARTIFACT=1` |

261| [Правило разрешений](/ru/permissions) | Добавьте `Artifact` в `permissions.deny` |257| [Правило разрешений](/docs/ru/permissions) | Добавьте `Artifact` в `permissions.deny` |

262 258 

263<h2 id="manage-artifacts-for-your-organization">259<h2 id="manage-artifacts-for-your-organization">

264 Управление артефактами для вашей организации260 Управление артефактами для вашей организации


300 Добавление домена средства просмотра в список разрешений296 Добавление домена средства просмотра в список разрешений

301</h3>297</h3>

302 298 

303Средство просмотра на claude.ai загружает каждый артефакт из изолированного источника `*.claudeusercontent.com`. Если ваша организация ограничивает исходящий сетевой доступ, добавьте этот домен в список разрешений вместе с `claude.ai`. Полный список см. в разделе [Требования к сетевому доступу](/ru/network-config#network-access-requirements).299Средство просмотра на claude.ai загружает каждый артефакт из изолированного источника `*.claudeusercontent.com`. Если ваша организация ограничивает исходящий сетевой доступ, добавьте этот домен в список разрешений вместе с `claude.ai`. Полный список см. в разделе [Требования к сетевому доступу](/docs/ru/network-config#network-access-requirements).

304 300 

305<h3 id="list-and-delete-artifacts-with-the-compliance-api">301<h3 id="list-and-delete-artifacts-with-the-compliance-api">

306 Список и удаление артефактов с помощью API соответствия302 Список и удаление артефактов с помощью API соответствия


320 Связанные ресурсы316 Связанные ресурсы

321</h2>317</h2>

322 318 

323* Просмотрите [шаблоны подсказок и рабочие процессы](/ru/prompt-library), которые сочетаются с артефактами319* Просмотрите [шаблоны подсказок и рабочие процессы](/docs/ru/prompt-library), которые сочетаются с артефактами

324* Превратите подсказку артефакта, которую вы повторно используете, в [skill](/ru/skills), чтобы вы могли вызвать её как команду320* Превратите подсказку артефакта, которую вы повторно используете, в [skill](/docs/ru/skills), чтобы вы могли вызвать её как команду

325* [Подключите серверы MCP](/ru/mcp), чтобы Claude мог получить данные в артефакт во время его создания321* [Подключите серверы MCP](/docs/ru/mcp), чтобы Claude мог получить данные в артефакт во время его создания

authentication.md +28 −28

Details

12 Вход в Claude Code12 Вход в Claude Code

13</h2>13</h2>

14 14 

15После [установки Claude Code](/ru/setup#install-claude-code) запустите `claude` в вашем терминале. При первом запуске Claude Code откроет окно браузера для входа.15После [установки Claude Code](/docs/ru/setup#install-claude-code) запустите `claude` в вашем терминале. При первом запуске Claude Code откроет окно браузера для входа.

16 16 

17Если браузер не откроется автоматически, нажмите `c`, чтобы скопировать URL входа в буфер обмена, а затем вставьте его в браузер.17Если браузер не откроется автоматически, нажмите `c`, чтобы скопировать URL входа в буфер обмена, а затем вставьте его в браузер.

18 18 


25* **Подписка Claude Pro или Max**: войдите с помощью вашей учетной записи Claude.ai. Подпишитесь на [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).25* **Подписка Claude Pro или Max**: войдите с помощью вашей учетной записи Claude.ai. Подпишитесь на [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

26* **Claude for Teams или Enterprise**: войдите с помощью учетной записи Claude.ai, на которую вас пригласил администратор вашей команды.26* **Claude for Teams или Enterprise**: войдите с помощью учетной записи Claude.ai, на которую вас пригласил администратор вашей команды.

27* **Claude Console**: войдите с помощью ваших учетных данных Console. Ваш администратор должен был [пригласить вас](#claude-console-authentication) предварительно.27* **Claude Console**: войдите с помощью ваших учетных данных Console. Ваш администратор должен был [пригласить вас](#claude-console-authentication) предварительно.

28* **Облачные провайдеры**: если ваша организация использует [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry), установите необходимые переменные окружения перед запуском `claude`, или выберите **3rd-party platform** в приглашении входа, которое запускает интерактивный мастер настройки для Bedrock и Vertex AI. Вход через браузер не требуется.28* **Облачные провайдеры**: если ваша организация использует [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) или [Microsoft Foundry](/docs/ru/microsoft-foundry), установите необходимые переменные окружения перед запуском `claude`, или выберите **3rd-party platform** в приглашении входа, которое запускает интерактивный мастер настройки для Bedrock и Vertex AI. Вход через браузер не требуется.

29* **Облачный шлюз**: если ваша организация запускает самостоятельно размещенный [шлюз приложений Claude](/ru/claude-apps-gateway), войдите с помощью корпоративного SSO через `/login`. Токен, выданный шлюзом, является единственным учетным данием сеанса.29* **Облачный шлюз**: если ваша организация запускает самостоятельно размещенный [шлюз приложений Claude](/docs/ru/claude-apps-gateway), войдите с помощью корпоративного SSO через `/login`. Токен, выданный шлюзом, является единственным учетным данием сеанса.

30 30 

31Администраторы могут ограничить интерактивный вход с помощью управляемых параметров [`forceLoginMethod` и `forceLoginOrgUUID`](/ru/settings#available-settings). Когда установлен один из них, сеансы, аутентифицированные с помощью `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске; сеансы облачных провайдеров не затрагиваются.31Администраторы могут ограничить интерактивный вход с помощью управляемых параметров [`forceLoginMethod` и `forceLoginOrgUUID`](/docs/ru/settings#available-settings). Когда установлен один из них, сеансы, аутентифицированные с помощью `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске; сеансы облачных провайдеров не затрагиваются.

32 32 

33Чтобы выйти и повторно аутентифицироваться, введите `/logout` в приглашение Claude Code. Выход также сбрасывает состояние первоначальной настройки, поэтому при следующем запуске `claude` вас проведут через вход и настройку снова.33Чтобы выйти и повторно аутентифицироваться, введите `/logout` в приглашение Claude Code. Выход также сбрасывает состояние первоначальной настройки, поэтому при следующем запуске `claude` вас проведут через вход и настройку снова.

34 34 

35Если у вас возникли проблемы с входом, см. [устранение неполадок аутентификации](/ru/troubleshoot-install#login-and-authentication).35Если у вас возникли проблемы с входом, см. [устранение неполадок аутентификации](/docs/ru/troubleshoot-install#login-and-authentication).

36 36 

37<h2 id="set-up-team-authentication">37<h2 id="set-up-team-authentication">

38 Настройка аутентификации команды38 Настройка аутентификации команды


42 42 

43* [Claude for Teams или Enterprise](#claude-for-teams-or-enterprise), рекомендуется для большинства команд43* [Claude for Teams или Enterprise](#claude-for-teams-or-enterprise), рекомендуется для большинства команд

44* [Claude Console](#claude-console-authentication)44* [Claude Console](#claude-console-authentication)

45* [Claude apps gateway](/ru/claude-apps-gateway), самостоятельно размещаемый шлюз, который подписывает разработчиков с помощью вашего IdP и маршрутизирует вывод к облачному провайдеру, который вы настраиваете45* [Claude apps gateway](/docs/ru/claude-apps-gateway), самостоятельно размещаемый шлюз, который подписывает разработчиков с помощью вашего IdP и маршрутизирует вывод к облачному провайдеру, который вы настраиваете

46* [Amazon Bedrock](/ru/amazon-bedrock)46* [Amazon Bedrock](/docs/ru/amazon-bedrock)

47* [Google Cloud's Agent Platform](/ru/google-vertex-ai)47* [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai)

48* [Microsoft Foundry](/ru/microsoft-foundry)48* [Microsoft Foundry](/docs/ru/microsoft-foundry)

49 49 

50<h3 id="claude-for-teams-or-enterprise">50<h3 id="claude-for-teams-or-enterprise">

51 Claude for Teams или Enterprise51 Claude for Teams или Enterprise


99 Каждый приглашенный пользователь должен:99 Каждый приглашенный пользователь должен:

100 100 

101 * Принять приглашение Console101 * Принять приглашение Console

102 * [Проверить системные требования](/ru/setup#system-requirements)102 * [Проверить системные требования](/docs/ru/setup#system-requirements)

103 * [Установить Claude Code](/ru/setup#install-claude-code)103 * [Установить Claude Code](/docs/ru/setup#install-claude-code)

104 * Войти с учетными данными учетной записи Console104 * Войти с учетными данными учетной записи Console

105 </Step>105 </Step>

106</Steps>106</Steps>


113 113 

114<Steps>114<Steps>

115 <Step title="Следуйте настройке провайдера">115 <Step title="Следуйте настройке провайдера">

116 Следуйте [документации Amazon Bedrock](/ru/amazon-bedrock), [документации Google Cloud's Agent Platform](/ru/google-vertex-ai) или [документации Microsoft Foundry](/ru/microsoft-foundry).116 Следуйте [документации Amazon Bedrock](/docs/ru/amazon-bedrock), [документации Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) или [документации Microsoft Foundry](/docs/ru/microsoft-foundry).

117 </Step>117 </Step>

118 118 

119 <Step title="Распределите конфигурацию">119 <Step title="Распределите конфигурацию">

120 Распределите переменные окружения и инструкции по созданию облачных учетных данных среди ваших пользователей. Узнайте больше о том, как [управлять конфигурацией здесь](/ru/settings).120 Распределите переменные окружения и инструкции по созданию облачных учетных данных среди ваших пользователей. Узнайте больше о том, как [управлять конфигурацией здесь](/docs/ru/settings).

121 </Step>121 </Step>

122 122 

123 <Step title="Установите Claude Code">123 <Step title="Установите Claude Code">

124 Пользователи могут [установить Claude Code](/ru/setup#install-claude-code).124 Пользователи могут [установить Claude Code](/docs/ru/setup#install-claude-code).

125 </Step>125 </Step>

126</Steps>126</Steps>

127 127 


136 * На Linux учетные данные хранятся в `~/.claude/.credentials.json` с режимом файла `0600`.136 * На Linux учетные данные хранятся в `~/.claude/.credentials.json` с режимом файла `0600`.

137 * На Windows учетные данные хранятся в `%USERPROFILE%\.claude\.credentials.json` и наследуют элементы управления доступом из каталога профиля пользователя, что по умолчанию ограничивает доступ к файлу вашей учетной записью.137 * На Windows учетные данные хранятся в `%USERPROFILE%\.claude\.credentials.json` и наследуют элементы управления доступом из каталога профиля пользователя, что по умолчанию ограничивает доступ к файлу вашей учетной записью.

138 * Если вы установили переменную окружения `CLAUDE_CONFIG_DIR` на Linux или Windows, файл `.credentials.json` находится в этом каталоге.138 * Если вы установили переменную окружения `CLAUDE_CONFIG_DIR` на Linux или Windows, файл `.credentials.json` находится в этом каталоге.

139 * Claude Code управляет `.credentials.json` через `/login` и `/logout`. Чтобы маршрутизировать запросы через пользовательскую конечную точку API, установите переменную окружения [`ANTHROPIC_BASE_URL`](/ru/env-vars).139 * Claude Code управляет `.credentials.json` через `/login` и `/logout`. Чтобы маршрутизировать запросы через пользовательскую конечную точку API, установите переменную окружения [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars).

140* **Поддерживаемые типы аутентификации**: учетные данные Claude.ai, учетные данные API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth и токены сеанса [Claude apps gateway](/ru/claude-apps-gateway).140* **Поддерживаемые типы аутентификации**: учетные данные Claude.ai, учетные данные API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth и токены сеанса [Claude apps gateway](/docs/ru/claude-apps-gateway).

141* **Пользовательские скрипты учетных данных**: параметр [`apiKeyHelper`](/ru/settings#available-settings) можно настроить для запуска скрипта оболочки, который возвращает ключ API.141* **Пользовательские скрипты учетных данных**: параметр [`apiKeyHelper`](/docs/ru/settings#available-settings) можно настроить для запуска скрипта оболочки, который возвращает ключ API.

142* **Интервалы обновления**: по умолчанию `apiKeyHelper` вызывается через 5 минут или при ответе HTTP 401. Установите переменную окружения `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` для пользовательских интервалов обновления.142* **Интервалы обновления**: по умолчанию `apiKeyHelper` вызывается через 5 минут или при ответе HTTP 401. Установите переменную окружения `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` для пользовательских интервалов обновления.

143* **Уведомление о медленном помощнике**: если `apiKeyHelper` требует более 10 секунд для возврата ключа, Claude Code отображает предупреждающее уведомление в строке приглашения, показывающее прошедшее время. Если вы видите это уведомление регулярно, проверьте, можно ли оптимизировать ваш скрипт учетных данных.143* **Уведомление о медленном помощнике**: если `apiKeyHelper` требует более 10 секунд для возврата ключа, Claude Code отображает предупреждающее уведомление в строке приглашения, показывающее прошедшее время. Если вы видите это уведомление регулярно, проверьте, можно ли оптимизировать ваш скрипт учетных данных.

144* **Сбои помощника**: {/* min-version: 2.1.208 */}когда скрипт завершается с ошибкой, истекает время ожидания или не выводит ничего, запросы завершаются с ошибкой [`Your apiKeyHelper script is failing`](/ru/errors#your-apikeyhelper-script-is-failing) в течение трех попыток. До версии 2.1.208 сбои помощника отображались как общая ошибка 401 после примерно десяти молчаливых повторных попыток.144* **Сбои помощника**: когда скрипт завершается с ошибкой, истекает время ожидания или не выводит ничего, запросы завершаются с ошибкой [`Your apiKeyHelper script is failing`](/docs/ru/errors#your-apikeyhelper-script-is-failing) в течение трех попыток. До версии 2.1.208 сбои помощника отображались как общая ошибка 401 после примерно десяти молчаливых повторных попыток.

145 145 

146`apiKeyHelper`, `ANTHROPIC_API_KEY` и `ANTHROPIC_AUTH_TOKEN` применяются к CLI и поверхностям, которые его оборачивают, включая расширение VS Code, Agent SDK и GitHub Actions. Claude Desktop и облачные сеансы не вызывают `apiKeyHelper` и не читают эти переменные окружения: они используют OAuth, за исключением сеансов рабочего стола, работающих с [конфигурацией вывода третьей стороны](/ru/llm-gateway-connect#desktop-app), которые аутентифицируются с помощью учетных данных этой конфигурации.146`apiKeyHelper`, `ANTHROPIC_API_KEY` и `ANTHROPIC_AUTH_TOKEN` применяются к CLI и поверхностям, которые его оборачивают, включая расширение VS Code, Agent SDK и GitHub Actions. Claude Desktop и облачные сеансы не вызывают `apiKeyHelper` и не читают эти переменные окружения: они используют OAuth, за исключением сеансов рабочего стола, работающих с [конфигурацией вывода третьей стороны](/docs/ru/llm-gateway-connect#desktop-app), которые аутентифицируются с помощью учетных данных этой конфигурации.

147 147 

148<h3 id="renew-an-expiring-login">148<h3 id="renew-an-expiring-login">

149 Обновление истекающего входа149 Обновление истекающего входа


153 153 

154Запустите `/login` для обновления. Предупреждение носит информационный характер и никогда не блокирует запрос: аутентификация продолжает работать до фактического истечения срока действия входа. Сам срок действия входа не изменяется; предварительное предупреждение — это то, что добавляет v2.1.203.154Запустите `/login` для обновления. Предупреждение носит информационный характер и никогда не блокирует запрос: аутентификация продолжает работать до фактического истечения срока действия входа. Сам срок действия входа не изменяется; предварительное предупреждение — это то, что добавляет v2.1.203.

155 155 

156{/* min-version: 2.1.206 */}После истечения срока действия сохраненного входа и невозможности его обновления каждый запрос завершается с ошибкой [`Login expired · Please run /login`](/ru/errors#login-expired) до тех пор, пока вы снова не войдете. До версии 2.1.206 истекший вход отображался как ошибка модели.156После истечения срока действия сохраненного входа и невозможности его обновления каждый запрос завершается с ошибкой [`Login expired · Please run /login`](/docs/ru/errors#login-expired) до тех пор, пока вы снова не войдете. До версии 2.1.206 истекший вход отображался как ошибка модели.

157 157 

158Предупреждение появляется только когда вход claude.ai или Claude Console является активным учетным данием, а не когда облачный провайдер, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` предоставляет учетные данные.158Предупреждение появляется только когда вход claude.ai или Claude Console является активным учетным данием, а не когда облачный провайдер, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` предоставляет учетные данные.

159 159 

160Раннее обновление наиболее важно для сеансов, которые работают без присмотра. [Фоновый сеанс в представлении агента](/ru/agent-view) или сеанс [Remote Control](/ru/remote-control), который пережил вход, прекращает прогресс после истечения срока действия учетных данных и не может восстановиться, пока вы снова не войдете.160Раннее обновление наиболее важно для сеансов, которые работают без присмотра. [Фоновый сеанс в представлении агента](/docs/ru/agent-view) или сеанс [Remote Control](/docs/ru/remote-control), который пережил вход, прекращает прогресс после истечения срока действия учетных данных и не может восстановиться, пока вы снова не войдете.

161 161 

162<h3 id="authentication-precedence">162<h3 id="authentication-precedence">

163 Приоритет аутентификации163 Приоритет аутентификации


165 165 

166Когда присутствуют несколько учетных данных, Claude Code выбирает одно в этом порядке:166Когда присутствуют несколько учетных данных, Claude Code выбирает одно в этом порядке:

167 167 

1681. Учетные данные облачного провайдера, когда установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`. См. [интеграции третьих сторон](/ru/third-party-integrations) для настройки.1681. Учетные данные облачного провайдера, когда установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`. См. [интеграции третьих сторон](/docs/ru/third-party-integrations) для настройки.

1692. Переменная окружения `ANTHROPIC_AUTH_TOKEN`. Отправляется как заголовок `Authorization: Bearer`. Используйте это при маршрутизации через [шлюз LLM или прокси](/ru/llm-gateway), который аутентифицируется с помощью токенов-носителей, а не ключей API Anthropic.1692. Переменная окружения `ANTHROPIC_AUTH_TOKEN`. Отправляется как заголовок `Authorization: Bearer`. Используйте это при маршрутизации через [шлюз LLM или прокси](/docs/ru/llm-gateway), который аутентифицируется с помощью токенов-носителей, а не ключей API Anthropic.

1703. Переменная окружения `ANTHROPIC_API_KEY`. Отправляется как заголовок `X-Api-Key`. Используйте это для прямого доступа к API Anthropic с ключом из [Claude Console](https://platform.claude.com). В интерактивном режиме вам предлагается один раз одобрить или отклонить ключ, и ваш выбор запоминается. Чтобы изменить его позже, используйте переключатель "Use custom API key" в `/config`. Переключатель появляется только при установке `ANTHROPIC_API_KEY` в вашей среде. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии.1703. Переменная окружения `ANTHROPIC_API_KEY`. Отправляется как заголовок `X-Api-Key`. Используйте это для прямого доступа к API Anthropic с ключом из [Claude Console](https://platform.claude.com). В интерактивном режиме вам предлагается один раз одобрить или отклонить ключ, и ваш выбор запоминается. Чтобы изменить его позже, используйте переключатель "Use custom API key" в `/config`. Переключатель появляется только при установке `ANTHROPIC_API_KEY` в вашей среде. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии.

1714. Выход скрипта [`apiKeyHelper`](/ru/settings#available-settings). Используйте это для динамических или ротирующихся учетных данных, таких как краткосрочные токены, полученные из хранилища.1714. Выход скрипта [`apiKeyHelper`](/docs/ru/settings#available-settings). Используйте это для динамических или ротирующихся учетных данных, таких как краткосрочные токены, полученные из хранилища.

1725. Переменная окружения `CLAUDE_CODE_OAUTH_TOKEN`. Долгоживущий токен OAuth, созданный [`claude setup-token`](#generate-a-long-lived-token). Используйте это для конвейеров CI и скриптов, где вход через браузер недоступен.1725. Переменная окружения `CLAUDE_CODE_OAUTH_TOKEN`. Долгоживущий токен OAuth, созданный [`claude setup-token`](#generate-a-long-lived-token). Используйте это для конвейеров CI и скриптов, где вход через браузер недоступен.

1736. Учетные данные OAuth подписки из `/login`. Это значение по умолчанию для пользователей Claude Pro, Max, Team и Enterprise.1736. Учетные данные OAuth подписки из `/login`. Это значение по умолчанию для пользователей Claude Pro, Max, Team и Enterprise.

174 174 

175Подписанный сеанс [Claude apps gateway](/ru/claude-apps-gateway) находится вне этого списка: это выбор провайдера, как Amazon Bedrock или Google Cloud's Agent Platform, и он имеет приоритет над ними. Когда существует сеанс шлюза, CLI аутентифицируется с помощью токена шлюза, даже если установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`, и записи токена-носителя, ключа API и `apiKeyHelper` выше не используются.175Подписанный сеанс [Claude apps gateway](/docs/ru/claude-apps-gateway) находится вне этого списка: это выбор провайдера, как Amazon Bedrock или Google Cloud's Agent Platform, и он имеет приоритет над ними. Когда существует сеанс шлюза, CLI аутентифицируется с помощью токена шлюза, даже если установлены `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` или `CLAUDE_CODE_USE_FOUNDRY`, и записи токена-носителя, ключа API и `apiKeyHelper` выше не используются.

176 176 

177Если у вас есть активная подписка Claude, но также установлен `ANTHROPIC_API_KEY` в вашей среде, ключ API имеет приоритет после одобрения. Это может привести к сбоям аутентификации, если ключ принадлежит отключенной или истекшей организации. Запустите `unset ANTHROPIC_API_KEY`, чтобы вернуться к вашей подписке, и проверьте `/status`, чтобы подтвердить, какой метод активен. Строка `Login method` показывает вашу учетную запись подписки, и строка `API key` появляется при использовании ключа API.177Если у вас есть активная подписка Claude, но также установлен `ANTHROPIC_API_KEY` в вашей среде, ключ API имеет приоритет после одобрения. Это может привести к сбоям аутентификации, если ключ принадлежит отключенной или истекшей организации. Запустите `unset ANTHROPIC_API_KEY`, чтобы вернуться к вашей подписке, и проверьте `/status`, чтобы подтвердить, какой метод активен. Строка `Login method` показывает вашу учетную запись подписки, и строка `API key` появляется при использовании ключа API.

178 178 

179[Claude Code в веб-версии](/ru/claude-code-on-the-web) всегда использует учетные данные вашей подписки. Если вы установите `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN` в среде песочницы, это не переопределит учетные данные вашей подписки.179[Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) всегда использует учетные данные вашей подписки. Если вы установите `ANTHROPIC_API_KEY` или `ANTHROPIC_AUTH_TOKEN` в среде песочницы, это не переопределит учетные данные вашей подписки.

180 180 

181<h3 id="generate-a-long-lived-token">181<h3 id="generate-a-long-lived-token">

182 Создание долгоживущего токена182 Создание долгоживущего токена


194export CLAUDE_CODE_OAUTH_TOKEN=your-token194export CLAUDE_CODE_OAUTH_TOKEN=your-token

195```195```

196 196 

197Этот токен аутентифицируется с помощью вашей подписки Claude и требует план Pro, Max, Team или Enterprise. Он ограничен только выводом и не может устанавливать сеансы [Remote Control](/ru/remote-control).197Этот токен аутентифицируется с помощью вашей подписки Claude и требует план Pro, Max, Team или Enterprise. Он ограничен только выводом и не может устанавливать сеансы [Remote Control](/docs/ru/remote-control).

198 198 

199[Bare mode](/ru/headless#start-faster-with-bare-mode) не читает `CLAUDE_CODE_OAUTH_TOKEN`. Если ваш скрипт передает `--bare`, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или `apiKeyHelper` вместо этого.199[Bare mode](/docs/ru/headless#start-faster-with-bare-mode) не читает `CLAUDE_CODE_OAUTH_TOKEN`. Если ваш скрипт передает `--bare`, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или `apiKeyHelper` вместо этого.

Details

6 6 

7> Сообщите классификатору режима auto, какие репозитории, бакеты и домены доверяет ваша организация. Установите контекст окружения, переопределите правила блокировки и разрешения по умолчанию и проверьте вашу эффективную конфигурацию с помощью подкоманд CLI auto-mode.7> Сообщите классификатору режима auto, какие репозитории, бакеты и домены доверяет ваша организация. Установите контекст окружения, переопределите правила блокировки и разрешения по умолчанию и проверьте вашу эффективную конфигурацию с помощью подкоманд CLI auto-mode.

8 8 

9[Режим auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) позволяет Claude Code работать без обычных запросов разрешений, маршрутизируя вызовы инструментов через классификатор, который блокирует все необратимое, деструктивное или направленное вне вашего окружения. Правила отказа и явного запроса оцениваются перед классификатором и по-прежнему блокируют или запрашивают. Используйте блок настроек `autoMode`, чтобы сообщить этому классификатору, какие репозитории, бакеты и домены доверяет ваша организация, чтобы он перестал блокировать обычные внутренние операции.9[Режим auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) позволяет Claude Code работать без обычных запросов разрешений, маршрутизируя вызовы инструментов через классификатор, который блокирует все необратимое, деструктивное или направленное вне вашего окружения. Правила отказа и явного запроса оцениваются перед классификатором и по-прежнему блокируют или запрашивают. Используйте блок настроек `autoMode`, чтобы сообщить этому классификатору, какие репозитории, бакеты и домены доверяет ваша организация, чтобы он перестал блокировать обычные внутренние операции.

10 10 

11<Note>11<Note>

12 Режим auto доступен всем пользователям на каждом поставщике, включая Anthropic API, Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и сеансы [шлюза приложений Claude](/ru/claude-apps-gateway). Если Claude Code сообщает, что режим auto недоступен для вашей учетной записи, проверьте [полные требования](/ru/permission-modes#eliminate-prompts-with-auto-mode), которые также охватывают поддерживаемые модели и включение Owner на планах Team и Enterprise. {/* min-version: 2.1.207 */}В версиях с v2.1.158 по v2.1.206 режим auto на Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и сеансах шлюза приложений Claude требовал установки `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.12 Режим auto доступен всем пользователям на каждом поставщике, включая Anthropic API, Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и сеансы [шлюза приложений Claude](/docs/ru/claude-apps-gateway). Если Claude Code сообщает, что режим auto недоступен для вашей учетной записи, проверьте [полные требования](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), которые также охватывают поддерживаемые модели и включение Owner на планах Team и Enterprise. В версиях с v2.1.158 по v2.1.206 режим auto на Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и сеансах шлюза приложений Claude требовал установки `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.

13</Note>13</Note>

14 14 

15По умолчанию классификатор доверяет только рабочему каталогу и настроенным удаленным репозиториям текущего репозитория. Действия, такие как отправка в исходный контроль вашей компании или запись в командный облачный бакет, блокируются до тех пор, пока вы не добавите их в `autoMode.environment`.15По умолчанию классификатор доверяет только рабочему каталогу и настроенным удаленным репозиториям текущего репозитория. Действия, такие как отправка в исходный контроль вашей компании или запись в командный облачный бакет, блокируются до тех пор, пока вы не добавите их в `autoMode.environment`.

16 16 

17Для информации о том, как включить режим auto и что он блокирует по умолчанию, см. [Режимы разрешений](/ru/permission-modes#eliminate-prompts-with-auto-mode). Эта страница является справочником по конфигурации.17Для информации о том, как включить режим auto и что он блокирует по умолчанию, см. [Режимы разрешений](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode). Эта страница является справочником по конфигурации.

18 18 

19На этой странице рассматривается, как:19На этой странице рассматривается, как:

20 20 


32 32 

33Автоматический режим позволяет отправлять изменения в вашу рабочую ветку, обычные отправки в ветку по умолчанию репозитория и создание pull request по умолчанию. Классификатор блокирует отправку только когда она несет риск, например при force push или содержимом, которое обходит установленный вами процесс проверки. Если вы хотите контрольную точку человека перед каждой отправкой или pull request, добавьте правила разрешений: рецепты ниже сохраняют автоматический режим включенным для всего остального.33Автоматический режим позволяет отправлять изменения в вашу рабочую ветку, обычные отправки в ветку по умолчанию репозитория и создание pull request по умолчанию. Классификатор блокирует отправку только когда она несет риск, например при force push или содержимом, которое обходит установленный вами процесс проверки. Если вы хотите контрольную точку человека перед каждой отправкой или pull request, добавьте правила разрешений: рецепты ниже сохраняют автоматический режим включенным для всего остального.

34 34 

35Наиболее прямой механизм — это [`permissions.ask`](/ru/permissions#permission-rule-syntax). Правила ask с областью действия контента, подобные приведенным ниже, оцениваются перед классификатором и всегда вызывают запрос разрешения, даже в автоматическом режиме, потому что явное правило ask — это ваше заявленное намерение получить запрос для этого действия. Добавьте правила в ваши [параметры](/ru/settings#settings-files):35Наиболее прямой механизм — это [`permissions.ask`](/docs/ru/permissions#permission-rule-syntax). Правила ask с областью действия контента, подобные приведенным ниже, оцениваются перед классификатором и всегда вызывают запрос разрешения, даже в автоматическом режиме, потому что явное правило ask — это ваше заявленное намерение получить запрос для этого действия. Добавьте правила в ваши [параметры](/docs/ru/settings#settings-files):

36 36 

37```json theme={null}37```json theme={null}

38{38{


51| :----------------------------------- | :------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| :----------------------------------- | :------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

52| Запрос перед действием | `permissions.ask` | Всегда запрашивает для правил с областью действия контента, подобных рецепту выше. Классификатор не может автоматически одобрить соответствующее действие. |52| Запрос перед действием | `permissions.ask` | Всегда запрашивает для правил с областью действия контента, подобных рецепту выше. Классификатор не может автоматически одобрить соответствующее действие. |

53| Никогда не запускать действие | `permissions.deny` | Блокирует перед консультацией классификатора. Ни классификатор, ни намерение пользователя не могут переопределить это. |53| Никогда не запускать действие | `permissions.deny` | Блокирует перед консультацией классификатора. Ни классификатор, ни намерение пользователя не могут переопределить это. |

54| Одноразовая граница для этого сеанса | Укажите это в разговоре, например "не отправляй, пока я не проверю" | Классификатор блокирует соответствующие действия, но граница может быть потеряна, если [компактирование контекста](/ru/costs#reduce-token-usage) удалит сообщение, в котором она была указана. Используйте правило ask или deny для гарантии долговечности. |54| Одноразовая граница для этого сеанса | Укажите это в разговоре, например "не отправляй, пока я не проверю" | Классификатор блокирует соответствующие действия, но граница может быть потеряна, если [компактирование контекста](/docs/ru/costs#reduce-token-usage) удалит сообщение, в котором она была указана. Используйте правило ask или deny для гарантии долговечности. |

55 55 

56<h2 id="where-the-classifier-reads-configuration">56<h2 id="where-the-classifier-reads-configuration">

57 Где классификатор читает конфигурацию57 Где классификатор читает конфигурацию

58</h2>58</h2>

59 59 

60Классификатор читает то же содержимое [CLAUDE.md](/ru/memory), которое загружает сам Claude, поэтому инструкция вроде "никогда не делайте force push" в файле CLAUDE.md вашего проекта управляет как Claude, так и классификатором одновременно. Начните с этого файла для соглашений проекта и правил поведения.60Классификатор читает то же содержимое [CLAUDE.md](/docs/ru/memory), которое загружает сам Claude, поэтому инструкция вроде "никогда не делайте force push" в файле CLAUDE.md вашего проекта управляет как Claude, так и классификатором одновременно. Начните с этого файла для соглашений проекта и правил поведения.

61 61 

62Для правил, которые применяются ко всем проектам, таких как доверенная инфраструктура или организационные правила запрета, используйте блок настроек `autoMode`. Классификатор читает `autoMode` из следующих областей:62Для правил, которые применяются ко всем проектам, таких как доверенная инфраструктура или организационные правила запрета, используйте блок настроек `autoMode`. Классификатор читает `autoMode` из следующих областей:

63 63 

64| Область | Файл | Используется для |64| Область | Файл | Используется для |

65| :------------------------------ | :--------------------------------------------------- | :----------------------------------------------------------- |65| :------------------------------ | :--------------------------------------------------- | :----------------------------------------------------------- |

66| Один разработчик | `~/.claude/settings.json` | Личная доверенная инфраструктура |66| Один разработчик | `~/.claude/settings.json` | Личная доверенная инфраструктура |

67| Организация | [Управляемые настройки](/ru/server-managed-settings) | Доверенная инфраструктура, распределённая всем разработчикам |67| Организация | [Управляемые настройки](/docs/ru/server-managed-settings) | Доверенная инфраструктура, распределённая всем разработчикам |

68| Флаг `--settings` или Agent SDK | Встроенный JSON | Переопределения для каждого вызова для автоматизации |68| Флаг `--settings` или Agent SDK | Встроенный JSON | Переопределения для каждого вызова для автоматизации |

69 69 

70Классификатор не читает `autoMode` из настроек проекта в `.claude/settings.json` или `.claude/settings.local.json`. Оба файла находятся в директории репозитория, поэтому проверенный репозиторий или шаг сборки могли бы иначе внедрить свои собственные правила разрешения. До версии 2.1.207 классификатор также читал `.claude/settings.local.json`; переместите любой блок `autoMode` из этого файла в `~/.claude/settings.json`. Исключение `.claude/settings.local.json` также закрывает случай, когда репозиторий фиксирует файл или локальный инструмент или шаг сборки записывает его.70Классификатор не читает `autoMode` из настроек проекта в `.claude/settings.json` или `.claude/settings.local.json`. Оба файла находятся в директории репозитория, поэтому проверенный репозиторий или шаг сборки могли бы иначе внедрить свои собственные правила разрешения. До версии 2.1.207 классификатор также читал `.claude/settings.local.json`; переместите любой блок `autoMode` из этого файла в `~/.claude/settings.json`. Исключение `.claude/settings.local.json` также закрывает случай, когда репозиторий фиксирует файл или локальный инструмент или шаг сборки записывает его.


72Записи из каждой области объединяются. Разработчик может расширить `environment`, `allow`, `soft_deny` и `hard_deny` личными записями, но не может удалить записи, которые предоставляют управляемые настройки. Поскольку правила разрешения действуют как исключения из правил мягкой блокировки внутри классификатора, запись `allow`, добавленная разработчиком, может переопределить запись организационного `soft_deny`: комбинация является аддитивной, а не жёсткой границей политики.72Записи из каждой области объединяются. Разработчик может расширить `environment`, `allow`, `soft_deny` и `hard_deny` личными записями, но не может удалить записи, которые предоставляют управляемые настройки. Поскольку правила разрешения действуют как исключения из правил мягкой блокировки внутри классификатора, запись `allow`, добавленная разработчиком, может переопределить запись организационного `soft_deny`: комбинация является аддитивной, а не жёсткой границей политики.

73 73 

74<Note>74<Note>

75 Классификатор — это вторая проверка, которая выполняется после [системы разрешений](/ru/permissions). Для действий, которые никогда не должны выполняться независимо от намерения пользователя или конфигурации классификатора, используйте `permissions.deny` в управляемых настройках, что блокирует действие до того, как классификатор будет проверен, и не может быть переопределено.75 Классификатор — это вторая проверка, которая выполняется после [системы разрешений](/docs/ru/permissions). Для действий, которые никогда не должны выполняться независимо от намерения пользователя или конфигурации классификатора, используйте `permissions.deny` в управляемых настройках, что блокирует действие до того, как классификатор будет проверен, и не может быть переопределено.

76</Note>76</Note>

77 77 

78<h2 id="define-trusted-infrastructure">78<h2 id="define-trusted-infrastructure">


87 * **Organization**87 * **Organization**

88 * **Primary use of Claude Code**: по умолчанию разработка программного обеспечения88 * **Primary use of Claude Code**: по умолчанию разработка программного обеспечения

89 * **Cloud provider(s)**89 * **Cloud provider(s)**

90 * **Repository visibility**: репозиторий считается приватным, если его удаленный хост и имя не указывают иное, {/* min-version: 2.1.200 */}или проверка видимости ранее в сеансе, которую читает классификатор, показывает, что он является публичным. Классификатор читает ваши сообщения и команды, которые запускает Claude, а не их вывод, поэтому доказательство должно быть чем-то, что он может прочитать, например вашим собственным сообщением, называющим репозиторий как публичный; вывод `gh repo view` сам по себе не достигает его. Проверка доказательств из стенограммы требует Claude Code v2.1.200 или позже90 * **Repository visibility**: репозиторий считается приватным, если его удаленный хост и имя не указывают иное, или проверка видимости ранее в сеансе, которую читает классификатор, показывает, что он является публичным. Классификатор читает ваши сообщения и команды, которые запускает Claude, а не их вывод, поэтому доказательство должно быть чем-то, что он может прочитать, например вашим собственным сообщением, называющим репозиторий как публичный; вывод `gh repo view` сам по себе не достигает его. Проверка доказательств из стенограммы требует Claude Code v2.1.200 или позже

91 * **Internal sharing / snippet hosting**: публичные сервисы paste и gist рассматриваются как находящиеся вне границы доверия до тех пор, пока вы их не назовете91 * **Internal sharing / snippet hosting**: публичные сервисы paste и gist рассматриваются как находящиеся вне границы доверия до тех пор, пока вы их не назовете

92 * **Org-specific CLIs**92 * **Org-specific CLIs**

93 * **Secrets management**93 * **Secrets management**


96 * **Network posture**96 * **Network posture**

97 * **Protected deployment namespaces / environments**: возвращается к эвристике Sensitive remote targets до тех пор, пока вы их не назовете97 * **Protected deployment namespaces / environments**: возвращается к эвристике Sensitive remote targets до тех пор, пока вы их не назовете

98 * **Data retention / declassification**98 * **Data retention / declassification**

99* **Слоты доверия**: называют то, что классификатор рассматривает как находящееся внутри вашей границы. Слоты — это Trusted repo, Source control, Trusted internal domains, Trusted cloud buckets, Key internal services и Internal package registry. Записи repo и source-control по умолчанию указывают на рабочий репозиторий и его настроенные удаленные репозитории. Все остальные слоты доверия по умолчанию имеют значение `None configured`, поэтому ничего больше не доверяется до тех пор, пока вы это не добавите. {/* min-version: 2.1.203 */}Видимость репозитория охватывает только конфиденциальный материал: приватный репозиторий является приемлемым пунктом назначения для конфиденциального материала, но сделание репозитория приватным никогда не очищает секреты, личные данные или доверенные данные в нем, и классификатор рассматривает содержимое, перенесенное, переориентированное или впервые прочитанное из-за пределов рабочего репозитория, как не являющееся собственной работой этого репозитория. Это определение области требует Claude Code v2.1.203 или позже.99* **Слоты доверия**: называют то, что классификатор рассматривает как находящееся внутри вашей границы. Слоты — это Trusted repo, Source control, Trusted internal domains, Trusted cloud buckets, Key internal services и Internal package registry. Записи repo и source-control по умолчанию указывают на рабочий репозиторий и его настроенные удаленные репозитории. Все остальные слоты доверия по умолчанию имеют значение `None configured`, поэтому ничего больше не доверяется до тех пор, пока вы это не добавите. Видимость репозитория охватывает только конфиденциальный материал: приватный репозиторий является приемлемым пунктом назначения для конфиденциального материала, но сделание репозитория приватным никогда не очищает секреты, личные данные или доверенные данные в нем, и классификатор рассматривает содержимое, перенесенное, переориентированное или впервые прочитанное из-за пределов рабочего репозитория, как не являющееся собственной работой этого репозитория. Это определение области требует Claude Code v2.1.203 или позже.

100* **Слоты чувствительности**: называют то, что защитные правила рассматривают как высокий риск. Слоты — это Sensitive data locations & audiences, Sensitive remote targets и Protected IaC scopes. Каждый по умолчанию использует широкую эвристику, например рассматривая любой хост или пространство имен, чье имя содержит `prod` или `production`, как чувствительную удаленную цель, поэтому защитные правила активны до того, как вы что-либо настроите. Указание конкретных целей в слоте чувствительности заставляет эти правила применяться к названным целям вместо эвристики.100* **Слоты чувствительности**: называют то, что защитные правила рассматривают как высокий риск. Слоты — это Sensitive data locations & audiences, Sensitive remote targets и Protected IaC scopes. Каждый по умолчанию использует широкую эвристику, например рассматривая любой хост или пространство имен, чье имя содержит `prod` или `production`, как чувствительную удаленную цель, поэтому защитные правила активны до того, как вы что-либо настроите. Указание конкретных целей в слоте чувствительности заставляет эти правила применяться к названным целям вместо эвристики.

101 101 

102Чтобы добавить свои собственные записи наряду со значениями по умолчанию, включите буквальную строку `"$defaults"` в массив. Записи по умолчанию вставляются в эту позицию, поэтому ваши пользовательские записи могут идти до или после них.102Чтобы добавить свои собственные записи наряду со значениями по умолчанию, включите буквальную строку `"$defaults"` в массив. Записи по умолчанию вставляются в эту позицию, поэтому ваши пользовательские записи могут идти до или после них.


125* **Доверенные внутренние домены**: имена хостов для API, панелей управления и сервисов внутри вашей сети, например `*.internal.example.com`125* **Доверенные внутренние домены**: имена хостов для API, панелей управления и сервисов внутри вашей сети, например `*.internal.example.com`

126* **Ключевые внутренние сервисы**: CI, реестры артефактов, внутренние индексы пакетов, инструменты для инцидентов126* **Ключевые внутренние сервисы**: CI, реестры артефактов, внутренние индексы пакетов, инструменты для инцидентов

127* **Внутренний реестр пакетов**: приватный npm, PyPI или другой реестр, через который должны проходить установки, поэтому установки, которые обходят его для публичного реестра, блокируются127* **Внутренний реестр пакетов**: приватный npm, PyPI или другой реестр, через который должны проходить установки, поэтому установки, которые обходят его для публичного реестра, блокируются

128* **Sensitive data locations & audiences**: бакеты, базы данных или пути, которые содержат личные данные, конфиденциальные бизнес-данные, учетные данные, регулируемые данные или аналогичный чувствительный материал, и аудитории, с которыми данные в каждом местоположении могут быть общими, поэтому классификатор защищает эти местоположения вместо того, чтобы угадывать из содержимого. {/* min-version: 2.1.195 */}{/* max-version: 2.1.197 */}Claude Code v2.1.195 через v2.1.197 называют эту запись PII / regulated-data locations и охватывают только местоположения, которые содержат личные или регулируемые данные, без измерения аудитории128* **Sensitive data locations & audiences**: бакеты, базы данных или пути, которые содержат личные данные, конфиденциальные бизнес-данные, учетные данные, регулируемые данные или аналогичный чувствительный материал, и аудитории, с которыми данные в каждом местоположении могут быть общими, поэтому классификатор защищает эти местоположения вместо того, чтобы угадывать из содержимого. Claude Code v2.1.195 через v2.1.197 называют эту запись PII / regulated-data locations и охватывают только местоположения, которые содержат личные или регулируемые данные, без измерения аудитории

129* **Sensitive remote targets**: пространства имен, хосты или контейнеры, которые считаются production, поэтому удаленные оболочки и port-forwards в них требуют вашего явного одобрения129* **Sensitive remote targets**: пространства имен, хосты или контейнеры, которые считаются production, поэтому удаленные оболочки и port-forwards в них требуют вашего явного одобрения

130* **Protected IaC scopes**: ресурсы инфраструктуры, чьи apply или destroy всегда должны требовать от вас назвать изменение130* **Protected IaC scopes**: ресурсы инфраструктуры, чьи apply или destroy всегда должны требовать от вас назвать изменение

131* **Дополнительный контекст**: ограничения регулируемой отрасли, многопользовательская инфраструктура или требования соответствия, которые влияют на то, что классификатор должен рассматривать как рискованное131* **Дополнительный контекст**: ограничения регулируемой отрасли, многопользовательская инфраструктура или требования соответствия, которые влияют на то, что классификатор должен рассматривать как рискованное


165* `autoMode.soft_deny`: деструктивные действия, которые намерение пользователя может отменить165* `autoMode.soft_deny`: деструктивные действия, которые намерение пользователя может отменить

166* `autoMode.allow`: исключения из правил мягкой блокировки166* `autoMode.allow`: исключения из правил мягкой блокировки

167 167 

168Каждое из них — это массив описаний на прозе, читаемых как правила на естественном языке. Для инструментов на основе паттернов с жесткими блокировками, которые работают перед классификатором, используйте [`permissions.deny`](/ru/permissions).168Каждое из них — это массив описаний на прозе, читаемых как правила на естественном языке. Для инструментов на основе паттернов с жесткими блокировками, которые работают перед классификатором, используйте [`permissions.deny`](/docs/ru/permissions).

169 169 

170Внутри классификатора приоритет работает в четыре уровня:170Внутри классификатора приоритет работает в четыре уровня:

171 171 


254claude auto-mode defaults254claude auto-mode defaults

255```255```

256 256 

257{/* min-version: 2.1.208 */}Чтобы прочитать полный текст одного правила без передачи через `jq`, передайте `--label` с началом метки правила, например `claude auto-mode defaults --label 'Git Destructive'`. Сопоставление выполняется без учёта регистра по префиксу метки каждого правила, а разделы без совпадений выводятся как пустые списки. Требуется Claude Code v2.1.208 или более поздняя версия.257Чтобы прочитать полный текст одного правила без передачи через `jq`, передайте `--label` с началом метки правила, например `claude auto-mode defaults --label 'Git Destructive'`. Сопоставление выполняется без учёта регистра по префиксу метки каждого правила, а разделы без совпадений выводятся как пустые списки. Требуется Claude Code v2.1.208 или более поздняя версия.

258 258 

259Выведите то, что классификатор фактически использует как JSON, с вашими настройками, применяемыми где установлены, и значениями по умолчанию в противном случае:259Выведите то, что классификатор фактически использует как JSON, с вашими настройками, применяемыми где установлены, и значениями по умолчанию в противном случае:

260 260 


282 282 

283Повторные отказы для одного и того же пункта назначения обычно означают, что классификатору не хватает контекста. Добавьте этот пункт назначения в `autoMode.environment`, затем запустите `claude auto-mode config`, чтобы подтвердить, что это вступило в силу.283Повторные отказы для одного и того же пункта назначения обычно означают, что классификатору не хватает контекста. Добавьте этот пункт назначения в `autoMode.environment`, затем запустите `claude auto-mode config`, чтобы подтвердить, что это вступило в силу.

284 284 

285Чтобы реагировать на отказы программно, используйте hook [`PermissionDenied`](/ru/hooks#permissiondenied).285Чтобы реагировать на отказы программно, используйте hook [`PermissionDenied`](/docs/ru/hooks#permissiondenied).

286 286 

287<h2 id="see-also">287<h2 id="see-also">

288 See also288 See also

289</h2>289</h2>

290 290 

291* [Permission modes](/ru/permission-modes#eliminate-prompts-with-auto-mode): что такое режим auto, что он блокирует по умолчанию и как его включить291* [Permission modes](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode): что такое режим auto, что он блокирует по умолчанию и как его включить

292* [Managed settings](/ru/server-managed-settings): развертывание конфигурации `autoMode` по всей организации292* [Managed settings](/docs/ru/server-managed-settings): развертывание конфигурации `autoMode` по всей организации

293* [Permissions](/ru/permissions): правила разрешения, запроса и отказа, которые применяются перед запуском классификатора293* [Permissions](/docs/ru/permissions): правила разрешения, запроса и отказа, которые применяются перед запуском классификатора

294* [Settings](/ru/settings): полный справочник настроек, включая ключ `autoMode`294* [Settings](/docs/ru/settings): полный справочник настроек, включая ключ `autoMode`

Details

21Claude Code отслеживает все изменения, внесённые его инструментами редактирования файлов:21Claude Code отслеживает все изменения, внесённые его инструментами редактирования файлов:

22 22 

23* Каждый запрос пользователя создаёт новый checkpoint23* Каждый запрос пользователя создаёт новый checkpoint

24* Claude Code хранит снимки файлов для 100 самых последних checkpoints в сеансе. Удаление старого checkpoint удаляет файлы снимков, на которые не ссылается ни один оставшийся checkpoint, за исключением первого снимка каждого файла, который расширение VS Code использует в качестве базовой линии для различий сеанса. {/* min-version: 2.1.208 */}До версии v2.1.208 эти замещённые файлы снимков оставались на диске до очистки сеанса.24* Claude Code хранит снимки файлов для 100 самых последних checkpoints в сеансе. Удаление старого checkpoint удаляет файлы снимков, на которые не ссылается ни один оставшийся checkpoint, за исключением первого снимка каждого файла, который расширение VS Code использует в качестве базовой линии для различий сеанса. До версии v2.1.208 эти замещённые файлы снимков оставались на диске до очистки сеанса.

25* Checkpoints сохраняются с беседой, поэтому возобновлённый сеанс всё ещё может использовать `/rewind` для возврата к ним25* Checkpoints сохраняются с беседой, поэтому возобновлённый сеанс всё ещё может использовать `/rewind` для возврата к ним

26* Автоматически очищаются вместе с сеансами через 30 дней (настраивается)26* Автоматически очищаются вместе с сеансами через 30 дней (настраивается)

27 27 


66В обоих случаях исходные сообщения сохраняются в стенограмме сеанса, поэтому Claude может ссылаться на детали при необходимости. Вы можете ввести дополнительные инструкции для руководства тем, на чём должно сосредоточиться резюме. Это похоже на `/compact`, но целевое: вместо суммирования всей беседы вы выбираете, какую сторону выбранного сообщения сжать.66В обоих случаях исходные сообщения сохраняются в стенограмме сеанса, поэтому Claude может ссылаться на детали при необходимости. Вы можете ввести дополнительные инструкции для руководства тем, на чём должно сосредоточиться резюме. Это похоже на `/compact`, но целевое: вместо суммирования всей беседы вы выбираете, какую сторону выбранного сообщения сжать.

67 67 

68<Note>68<Note>

69 Суммирование держит вас в одном сеансе и сжимает контекст. Если вы хотите ответвиться и попробовать другой подход, сохраняя исходный сеанс нетронутым, используйте вместо этого [fork](/ru/sessions#branch-a-session) (`claude --continue --fork-session`).69 Суммирование держит вас в одном сеансе и сжимает контекст. Если вы хотите ответвиться и попробовать другой подход, сохраняя исходный сеанс нетронутым, используйте вместо этого [fork](/docs/ru/sessions#branch-a-session) (`claude --continue --fork-session`).

70</Note>70</Note>

71 71 

72<h2 id="common-use-cases">72<h2 id="common-use-cases">


118 См. также118 См. также

119</h2>119</h2>

120 120 

121* [Interactive mode](/ru/interactive-mode) - Сочетания клавиш и элементы управления сеансом121* [Interactive mode](/docs/ru/interactive-mode) - Сочетания клавиш и элементы управления сеансом

122* [Commands](/ru/commands) - Доступ к checkpoints с использованием `/rewind`122* [Commands](/docs/ru/commands) - Доступ к checkpoints с использованием `/rewind`

123* [CLI reference](/ru/cli-reference) - Параметры командной строки123* [CLI reference](/docs/ru/cli-reference) - Параметры командной строки

Details

62<Note>62<Note>

63 **Развёртывайте в вашей частной сети.** Claude Code подключается только к шлюзу, адрес которого является частным. Это охранник безопасности, потому что доверенный шлюз может отправлять параметры, которые запускают команды на машинах разработчиков. Поместите шлюз за внутренним балансировщиком нагрузки или VPN и дайте ему имя хоста, которое разрешается только в частные IP-адреса.63 **Развёртывайте в вашей частной сети.** Claude Code подключается только к шлюзу, адрес которого является частным. Это охранник безопасности, потому что доверенный шлюз может отправлять параметры, которые запускают команды на машинах разработчиков. Поместите шлюз за внутренним балансировщиком нагрузки или VPN и дайте ему имя хоста, которое разрешается только в частные IP-адреса.

64 64 

65 Общедоступные конечные точки шлюза, управляемые Anthropic, являются исключением: `/login` принимает их по `https://`. Это небольшой фиксированный набор шлюзов, которыми управляет сама Anthropic; они не являются вариантом развёртывания, который вы можете выбрать или настроить. Список скомпилирован в Claude Code, поэтому никакая конфигурация не может добавить имя хоста в него и ни один шлюз, который вы размещаете, не соответствует исключению. {/* min-version: 2.1.206 */}До версии 2.1.206 `/login` отклонял эти конечные точки, как и любой другой общедоступный адрес.65 Общедоступные конечные точки шлюза, управляемые Anthropic, являются исключением: `/login` принимает их по `https://`. Это небольшой фиксированный набор шлюзов, которыми управляет сама Anthropic; они не являются вариантом развёртывания, который вы можете выбрать или настроить. Список скомпилирован в Claude Code, поэтому никакая конфигурация не может добавить имя хоста в него и ни один шлюз, который вы размещаете, не соответствует исключению. До версии 2.1.206 `/login` отклонял эти конечные точки, как и любой другой общедоступный адрес.

66</Note>66</Note>

67 67 

68<h3 id="prerequisites">68<h3 id="prerequisites">


72Имейте это на месте перед началом:72Имейте это на месте перед началом:

73 73 

74| Вам нужно | Детали |74| Вам нужно | Детали |

75| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |75| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

76| Claude Code v2.1.195 или позже | Подкоманда `claude gateway` и поток входа шлюза поставляются в v2.1.195. Более ранние общедоступные сборки их не включают. Как машина, запускающая сервер шлюза, так и машина каждого разработчика должны быть на v2.1.195 или позже; запустите `claude update`, чтобы получить последний выпуск. {/* min-version: 2.1.198 */}[Claude Platform on AWS upstream](/docs/ru/claude-apps-gateway-config#claude-platform-on-aws) требует Claude Code v2.1.198 или позже на сервере шлюза. |76| Claude Code v2.1.195 или позже | Подкоманда `claude gateway` и поток входа шлюза поставляются в v2.1.195. Более ранние общедоступные сборки их не включают. Как машина, запускающая сервер шлюза, так и машина каждого разработчика должны быть на v2.1.195 или позже; запустите `claude update`, чтобы получить последний выпуск. [Claude Platform on AWS upstream](/docs/ru/claude-apps-gateway-config#claude-platform-on-aws) требует Claude Code v2.1.198 или позже на сервере шлюза. |

77| Поставщик удостоверений OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak или Dex, или любой другой совместимый с OIDC IdP, такой как PingFederate. Шлюз запускает стандартное обнаружение OIDC и поток кода авторизации против него. SAML и LDAP не поддерживаются. |77| Поставщик удостоверений OpenID Connect (OIDC) | Okta, Microsoft Entra ID, Google Workspace, Keycloak или Dex, или любой другой совместимый с OIDC IdP, такой как PingFederate. Шлюз запускает стандартное обнаружение OIDC и поток кода авторизации против него. SAML и LDAP не поддерживаются. |

78| PostgreSQL 14 или позже | Поддерживает поток входа устройства, где обратный вызов браузера пишет, а опрашивающий CLI читает, плюс счётчики ограничения скорости. Любой управляемый Postgres работает, включая самый маленький уровень. Без настроенных ограничений расходов шлюз хранит несколько КБ краткосрочного состояния аутентификации; с [ограничениями расходов](/docs/ru/claude-apps-gateway-spend-limits) он также содержит долговечные таблицы расходов, аудита и идентификации, которые должны быть скопированы. TLS через `?sslmode=require` рекомендуется. |78| PostgreSQL 14 или позже | Поддерживает поток входа устройства, где обратный вызов браузера пишет, а опрашивающий CLI читает, плюс счётчики ограничения скорости. Любой управляемый Postgres работает, включая самый маленький уровень. Без настроенных ограничений расходов шлюз хранит несколько КБ краткосрочного состояния аутентификации; с [ограничениями расходов](/docs/ru/claude-apps-gateway-spend-limits) он также содержит долговечные таблицы расходов, аудита и идентификации, которые должны быть скопированы. TLS через `?sslmode=require` рекомендуется. |

79| Вышестоящий уровень модели | Учётные данные Amazon Bedrock, учётные данные Claude Platform on AWS, учётные данные Google Cloud, ресурс Microsoft Foundry или ключ API Anthropic. Поддерживаются несколько вышестоящих уровней с отказоустойчивостью. |79| Вышестоящий уровень модели | Учётные данные Amazon Bedrock, учётные данные Claude Platform on AWS, учётные данные Google Cloud, ресурс Microsoft Foundry или ключ API Anthropic. Поддерживаются несколько вышестоящих уровней с отказоустойчивостью. |

80| HTTPS | Шлюз должен быть доступен по `https://` с ноутбуков разработчиков и из любого браузера, используемого для входа; шлюз служит страницей проверки устройства на том же слушателе. Либо предоставьте сертификат TLS через `listen.tls`, либо запустите позади завершающего TLS входа и установите `listen.public_url`. Простое происхождение `http://` принимается только на loopback для локальной разработки. |80| HTTPS | Шлюз должен быть доступен по `https://` с ноутбуков разработчиков и из любого браузера, используемого для входа; шлюз служит страницей проверки устройства на том же слушателе. Либо предоставьте сертификат TLS через `listen.tls`, либо запустите позади завершающего TLS входа и установите `listen.public_url`. Простое происхождение `http://` принимается только на loopback для локальной разработки. |

81| Адрес частной сети | При `/login` Claude Code требует, чтобы имя хоста или IP-адрес шлюза разрешались только в частные адреса: RFC 1918, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` или loopback для локальной разработки. Проверка выполняется на каждом разрешённом IP, поэтому если какой-либо адрес, на который разрешается имя, является общедоступным, `/login` отклоняет URL. Если машины разработчиков маршрутизируют HTTPS через корпоративный прокси, вход также требует, чтобы хост прокси разрешался в частные адреса; если это не так, добавьте хост шлюза в `NO_PROXY`, чтобы CLI подключался напрямую. {/* min-version: 2.1.206 */}Общедоступные конечные точки шлюза, управляемые Anthropic, освобождены от проверок частного адреса и прокси: `/login` принимает их по `https://` по точному совпадению имени хоста, поэтому требование частной сети применяется только к шлюзу, который вы размещаете сами. До версии 2.1.206 `/login` отклонял конечную точку, управляемую Anthropic, как и любой другой общедоступный адрес. |81| Адрес частной сети | При `/login` Claude Code требует, чтобы имя хоста или IP-адрес шлюза разрешались только в частные адреса: RFC 1918, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` или loopback для локальной разработки. Проверка выполняется на каждом разрешённом IP, поэтому если какой-либо адрес, на который разрешается имя, является общедоступным, `/login` отклоняет URL. Если машины разработчиков маршрутизируют HTTPS через корпоративный прокси, вход также требует, чтобы хост прокси разрешался в частные адреса; если это не так, добавьте хост шлюза в `NO_PROXY`, чтобы CLI подключался напрямую. Общедоступные конечные точки шлюза, управляемые Anthropic, освобождены от проверок частного адреса и прокси: `/login` принимает их по `https://` по точному совпадению имени хоста, поэтому требование частной сети применяется только к шлюзу, который вы размещаете сами. До версии 2.1.206 `/login` отклонял конечную точку, управляемую Anthropic, как и любой другой общедоступный адрес. |

82| Среда выполнения Linux | Сервер шлюза работает только на собственном двоичном файле Linux. macOS работает для локальной разработки. Windows не поддерживается как платформа сервера. |82| Среда выполнения Linux | Сервер шлюза работает только на собственном двоичном файле Linux. macOS работает для локальной разработки. Windows не поддерживается как платформа сервера. |

83 83 

84Сервер шлюза требует собственный двоичный файл `claude`; загрузите закреплённый выпуск, как описано в [Установка Claude Code](/docs/ru/setup). Сервер использует функции среды выполнения, которые недоступны, когда Claude Code работает под Node. Если вы видите `requires the native binary` при загрузке, переключитесь на один из методов автономной установки.84Сервер шлюза требует собственный двоичный файл `claude`; загрузите закреплённый выпуск, как описано в [Установка Claude Code](/docs/ru/setup). Сервер использует функции среды выполнения, которые недоступны, когда Claude Code работает под Node. Если вы видите `requires the native binary` при загрузке, переключитесь на один из методов автономной установки.

Details

20<Note>20<Note>

21 **Развертывайте в вашей частной сети.** Claude Code подключается только к шлюзу, адрес которого является приватным. Это защита безопасности, потому что доверенный шлюз может отправлять параметры, которые запускают команды на машинах разработчиков. Поместите шлюз за внутренним балансировщиком нагрузки или VPN и дайте ему имя хоста, которое разрешается только на приватные IP-адреса.21 **Развертывайте в вашей частной сети.** Claude Code подключается только к шлюзу, адрес которого является приватным. Это защита безопасности, потому что доверенный шлюз может отправлять параметры, которые запускают команды на машинах разработчиков. Поместите шлюз за внутренним балансировщиком нагрузки или VPN и дайте ему имя хоста, которое разрешается только на приватные IP-адреса.

22 22 

23 Общедоступные конечные точки шлюза, управляемые Anthropic, являются исключением: `/login` принимает их через `https://`. Это небольшой фиксированный набор шлюзов, которыми управляет сама Anthropic; они не являются вариантом развертывания, который вы можете выбрать или настроить. Список скомпилирован в Claude Code, поэтому никакая конфигурация не может добавить имя хоста в него и ни один шлюз, который вы размещаете, не соответствует исключению. {/* min-version: 2.1.206 */}До версии 2.1.206 `/login` отклонял эти конечные точки, как и любой другой общедоступный адрес.23 Общедоступные конечные точки шлюза, управляемые Anthropic, являются исключением: `/login` принимает их через `https://`. Это небольшой фиксированный набор шлюзов, которыми управляет сама Anthropic; они не являются вариантом развертывания, который вы можете выбрать или настроить. Список скомпилирован в Claude Code, поэтому никакая конфигурация не может добавить имя хоста в него и ни один шлюз, который вы размещаете, не соответствует исключению. До версии 2.1.206 `/login` отклонял эти конечные точки, как и любой другой общедоступный адрес.

24</Note>24</Note>

25 25 

26<h2 id="identity-provider-setup">26<h2 id="identity-provider-setup">

Details

140 140 

141Каждая облачная сессия имеет URL транскрипта на claude.ai, и сессия может читать свой собственный ID из переменной окружения `CLAUDE_CODE_REMOTE_SESSION_ID`. Используйте это, чтобы поместить отслеживаемую ссылку в тела PR, сообщения коммитов, посты Slack или созданные отчёты, чтобы рецензент мог открыть запуск, который их создал.141Каждая облачная сессия имеет URL транскрипта на claude.ai, и сессия может читать свой собственный ID из переменной окружения `CLAUDE_CODE_REMOTE_SESSION_ID`. Используйте это, чтобы поместить отслеживаемую ссылку в тела PR, сообщения коммитов, посты Slack или созданные отчёты, чтобы рецензент мог открыть запуск, который их создал.

142 142 

143Начиная с версии 2.1.179, коммиты, которые Claude создаёт в веб-сессии, включают git трейлер `Claude-Session: <url>`, и тела PR включают URL сессии на отдельной строке. {/* min-version: 2.1.182 */}Начиная с версии 2.1.182, установите [`attribution.sessionUrl`](/docs/ru/settings#attribution-settings) на `false`, чтобы опустить трейлер и ссылку в теле PR.143Начиная с версии 2.1.179, коммиты, которые Claude создаёт в веб-сессии, включают git трейлер `Claude-Session: <url>`, и тела PR включают URL сессии на отдельной строке. Начиная с версии 2.1.182, установите [`attribution.sessionUrl`](/docs/ru/settings#attribution-settings) на `false`, чтобы опустить трейлер и ссылку в теле PR.

144 144 

145Чтобы включить ссылку на сессию в что-то другое, чем коммит или PR, например в сообщение Slack, которое публикует Claude, или в файл отчёта, который он пишет, попросите Claude запустить следующую команду и использовать её вывод. Команда преобразует префикс `cse_` в значении переменной окружения в префикс `session_`, который ожидает URL транскрипта:145Чтобы включить ссылку на сессию в что-то другое, чем коммит или PR, например в сообщение Slack, которое публикует Claude, или в файл отчёта, который он пишет, попросите Claude запустить следующую команду и использовать её вывод. Команда преобразует префикс `cse_` в значении переменной окружения в префикс `session_`, который ожидает URL транскрипта:

146 146 


669 669 

670Это создаёт новую облачную сессию на claude.ai. Сессия клонирует удалённый GitHub вашего текущего каталога в вашей текущей ветке, поэтому сначала отправьте, если у вас есть локальные коммиты, так как виртуальная машина клонирует из GitHub, а не с вашей машины. `--cloud` работает с одним репозиторием за раз. Задача запускается в облаке, пока вы продолжаете работать локально. Старое написание `--remote` всё ещё работает как устаревший псевдоним для `--cloud`.670Это создаёт новую облачную сессию на claude.ai. Сессия клонирует удалённый GitHub вашего текущего каталога в вашей текущей ветке, поэтому сначала отправьте, если у вас есть локальные коммиты, так как виртуальная машина клонирует из GitHub, а не с вашей машины. `--cloud` работает с одним репозиторием за раз. Задача запускается в облаке, пока вы продолжаете работать локально. Старое написание `--remote` всё ещё работает как устаревший псевдоним для `--cloud`.

671 671 

672{/* min-version: 2.1.195 */}Начиная с версии v2.1.195, CLI показывает живой чек-лист шагов настройки, таких как клонирование репозитория и запуск вашего [скрипта настройки](#setup-scripts), пока облачный контейнер запускается. Сообщения, которые вы вводите, пока контейнер подготавливается, ставятся в очередь и отправляются после того, как сессия будет готова.672Начиная с версии v2.1.195, CLI показывает живой чек-лист шагов настройки, таких как клонирование репозитория и запуск вашего [скрипта настройки](#setup-scripts), пока облачный контейнер запускается. Сообщения, которые вы вводите, пока контейнер подготавливается, ставятся в очередь и отправляются после того, как сессия будет готова.

673 673 

674<Note>674<Note>

675 `--cloud` создаёт облачные сессии. `--remote-control` не связан: он предоставляет локальную сессию CLI для мониторинга из веб-интерфейса. См. [Remote Control](/docs/ru/remote-control).675 `--cloud` создаёт облачные сессии. `--remote-control` не связан: он предоставляет локальную сессию CLI для мониторинга из веб-интерфейса. См. [Remote Control](/docs/ru/remote-control).


748Телепортирование проверяет эти требования перед возобновлением сессии. Если какое-либо требование не выполнено, вы увидите ошибку или будете приглашены разрешить проблему.748Телепортирование проверяет эти требования перед возобновлением сессии. Если какое-либо требование не выполнено, вы увидите ошибку или будете приглашены разрешить проблему.

749 749 

750| Требование | Детали |750| Требование | Детали |

751| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |751| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

752| Чистое состояние git | Ваш рабочий каталог должен не иметь незафиксированных изменений. Телепортирование предложит вам спрятать изменения, если необходимо. |752| Чистое состояние git | Ваш рабочий каталог должен не иметь незафиксированных изменений. Телепортирование предложит вам спрятать изменения, если необходимо. |

753| Правильный репозиторий | Вы должны запустить `--teleport` из проверки того же репозитория, не форка. {/* min-version: 2.1.199 */}Начиная с версии v2.1.199, Claude Code принимает проверку даже когда он не может разобрать удалённый сервер в имя хоста, такое как псевдоним SSH хоста, как `git@work:owner/repo.git` или переписанная форма `insteadOf`. Он показывает подтверждающий запрос сначала, и только когда владелец удалённого сервера и имя репозитория совпадают с репозиторием сессии. |753| Правильный репозиторий | Вы должны запустить `--teleport` из проверки того же репозитория, не форка. Начиная с версии v2.1.199, Claude Code принимает проверку даже когда он не может разобрать удалённый сервер в имя хоста, такое как псевдоним SSH хоста, как `git@work:owner/repo.git` или переписанная форма `insteadOf`. Он показывает подтверждающий запрос сначала, и только когда владелец удалённого сервера и имя репозитория совпадают с репозиторием сессии. |

754| Доступность ветки | Ветка из облачной сессии должна быть отправлена на удалённый сервер. Телепортирование автоматически получает и проверяет её. |754| Доступность ветки | Ветка из облачной сессии должна быть отправлена на удалённый сервер. Телепортирование автоматически получает и проверяет её. |

755| Один и тот же аккаунт | Вы должны быть аутентифицированы на том же аккаунте claude.ai, который использовался в облачной сессии. |755| Один и тот же аккаунт | Вы должны быть аутентифицированы на том же аккаунте claude.ai, который использовался в облачной сессии. |

756 756 


772 772 

773Облачные сессии поддерживают [встроенные команды](/docs/ru/commands), которые производят текстовый вывод. Команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, недоступны. Команды, которые открывают выбор или панель в терминале, ведут себя иначе в облачных сессиях:773Облачные сессии поддерживают [встроенные команды](/docs/ru/commands), которые производят текстовый вывод. Команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, недоступны. Команды, которые открывают выбор или панель в терминале, ведут себя иначе в облачных сессиях:

774 774 

775* {/* min-version: 2.1.205 */}**`/model`, `/effort`, `/fast`, `/color` и `/rename`**: передайте значение в качестве аргумента, например `/model sonnet`, вместо открытия выбора терминала или ползунка. Формы аргументов требуют Claude Code v2.1.205 или более поздней версии в окружении сессии и следуют примечаниям доступности каждой команды (/ru/commands#all-commands): `/effort` сообщает `Not applied`, пока действует [launch-default effort hold](/docs/ru/model-config#adjust-effort-level) модели, и `/fast` работает только в сессии, которая была запущена с включённым режимом fast mode.775* **`/model`, `/effort`, `/fast`, `/color` и `/rename`**: передайте значение в качестве аргумента, например `/model sonnet`, вместо открытия выбора терминала или ползунка. Формы аргументов требуют Claude Code v2.1.205 или более поздней версии в окружении сессии и следуют примечаниям доступности каждой команды (/ru/commands#all-commands): `/effort` сообщает `Not applied`, пока действует [launch-default effort hold](/docs/ru/model-config#adjust-effort-level) модели, и `/fast` работает только в сессии, которая была запущена с включённым режимом fast mode.

776* **`/config`**: в веб-версии открывает раздел Claude Code ваших параметров вместо установки значения, и текст после команды, включая `key=value`, игнорируется. Чтобы изменить параметры облачной сессии, используйте [переменные окружения](#configure-your-environment) или зафиксируйте [файлы параметров](/docs/ru/settings) в репозитории.776* **`/config`**: в веб-версии открывает раздел Claude Code ваших параметров вместо установки значения, и текст после команды, включая `key=value`, игнорируется. Чтобы изменить параметры облачной сессии, используйте [переменные окружения](#configure-your-environment) или зафиксируйте [файлы параметров](/docs/ru/settings) в репозитории.

777 777 

778Для управления контекстом конкретно:778Для управления контекстом конкретно:

Details

188 188 

189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

190 190 

191Claude Platform on AWS — это API Claude, управляемый Anthropic, с аутентификацией AWS, контролем доступа IAM и выставлением счетов через AWS Marketplace. Запросы поступают непосредственно в API Anthropic, поэтому вы получаете те же модели и функции API, что и в [Claude API](https://platform.claude.com/docs) по тому же графику выпусков. Функции на стороне клиента, которые Claude Code включает через сервис флагов функций Anthropic, такие как [`/loop` самостоятельное управление темпом](/ru/scheduled-tasks#let-claude-choose-the-interval), отключены по умолчанию, и [инструмент advisor](/ru/advisor) недоступен. Полный список см. в [матрице доступности функций](/ru/feature-availability#summary-by-provider). Вы аутентифицируетесь с помощью учетных данных AWS или ключа API рабочей области, и вы платите через AWS Marketplace.191Claude Platform on AWS — это API Claude, управляемый Anthropic, с аутентификацией AWS, контролем доступа IAM и выставлением счетов через AWS Marketplace. Запросы поступают непосредственно в API Anthropic, поэтому вы получаете те же модели и функции API, что и в [Claude API](https://platform.claude.com/docs) по тому же графику выпусков. Функции на стороне клиента, которые Claude Code включает через сервис флагов функций Anthropic, такие как [`/loop` самостоятельное управление темпом](/docs/ru/scheduled-tasks#let-claude-choose-the-interval), отключены по умолчанию, и [инструмент advisor](/docs/ru/advisor) недоступен. Полный список см. в [матрице доступности функций](/docs/ru/feature-availability#summary-by-provider). Вы аутентифицируетесь с помощью учетных данных AWS или ключа API рабочей области, и вы платите через AWS Marketplace.

192 192 

193Используйте это руководство, чтобы направить Claude Code на рабочую область, которую вы уже подготовили через Claude Platform on AWS. Для подписки AWS и настройки рабочей области, которые предшествуют этому, см. [документацию Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).193Используйте это руководство, чтобы направить Claude Code на рабочую область, которую вы уже подготовили через Claude Platform on AWS. Для подписки AWS и настройки рабочей области, которые предшествуют этому, см. [документацию Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws).

194 194 


230 230 

231Для CI и автоматизации дайте средству выполнения роль IAM с разрешением на вызов сервиса Anthropic и установите `AWS_REGION`. Цепочка учетных данных автоматически подхватывает роль.231Для CI и автоматизации дайте средству выполнения роль IAM с разрешением на вызов сервиса Anthropic и установите `AWS_REGION`. Цепочка учетных данных автоматически подхватывает роль.

232 232 

233Если ваши учетные данные SSO истекают во время сеанса, настройте [`awsAuthRefresh`](/ru/amazon-bedrock#advanced-credential-configuration), чтобы Claude Code повторно запустил вашу команду входа и повторил попытку вместо сбоя. Автоматическое обновление на Claude Platform on AWS требует Claude Code v2.1.198 или более поздней версии; более ранние версии останавливаются с подсказкой запустить `/login`, что не может обновить учетные данные AWS. Добавьте команду в ваш `settings.json`:233Если ваши учетные данные SSO истекают во время сеанса, настройте [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration), чтобы Claude Code повторно запустил вашу команду входа и повторил попытку вместо сбоя. Автоматическое обновление на Claude Platform on AWS требует Claude Code v2.1.198 или более поздней версии; более ранние версии останавливаются с подсказкой запустить `/login`, что не может обновить учетные данные AWS. Добавьте команду в ваш `settings.json`:

234 234 

235```json theme={null}235```json theme={null}

236{236{


250 250 

251Ключ отправляется как `x-api-key` и имеет приоритет над SigV4, поэтому любые учетные данные AWS в вашей среде игнорируются. Ключи API из отдельной организации Claude Console здесь не будут работать.251Ключ отправляется как `x-api-key` и имеет приоритет над SigV4, поэтому любые учетные данные AWS в вашей среде игнорируются. Ключи API из отдельной организации Claude Console здесь не будут работать.

252 252 

253Обращайтесь с ключами API рабочей области как с любыми другими производственными учетными данными. [Файл пользовательских настроек](/ru/settings) блок `env` — это удобный способ ограничить ключ вашей машиной без глобального экспорта.253Обращайтесь с ключами API рабочей области как с любыми другими производственными учетными данными. [Файл пользовательских настроек](/docs/ru/settings) блок `env` — это удобный способ ограничить ключ вашей машиной без глобального экспорта.

254 254 

255<Note>255<Note>

256 Команды `/login` и `/logout` не подписывают вас на подписку Claude.ai для Claude Platform on AWS. Аутентификация выполняется через ваши учетные данные AWS или ключ API рабочей области. Исключением является опция **refresh credentials**, которую `/login` показывает при настроенном `awsAuthRefresh`, которая повторно читает ваши учетные данные AWS, как описано выше.256 Команды `/login` и `/logout` не подписывают вас на подписку Claude.ai для Claude Platform on AWS. Аутентификация выполняется через ваши учетные данные AWS или ключ API рабочей области. Исключением является опция **refresh credentials**, которую `/login` показывает при настроенном `awsAuthRefresh`, которая повторно читает ваши учетные данные AWS, как описано выше.


278 278 

279Claude Platform on AWS использует те же идентификаторы моделей, что и прямой API Claude.279Claude Platform on AWS использует те же идентификаторы моделей, что и прямой API Claude.

280 280 

281Псевдонимы по умолчанию `fable`, `opus`, `sonnet` и `haiku` разрешаются в встроенные значения по умолчанию Claude Code для Claude Platform on AWS, которые могут отставать от последнего выпуска. Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` разрешается в Opus 4.8. {/* min-version: 2.1.207 */}До версии v2.1.207 он разрешался в Opus 4.7.281Псевдонимы по умолчанию `fable`, `opus`, `sonnet` и `haiku` разрешаются в встроенные значения по умолчанию Claude Code для Claude Platform on AWS, которые могут отставать от последнего выпуска. Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` разрешается в Opus 4.8. До версии v2.1.207 он разрешался в Opus 4.7.

282 282 

283Если вы развертываете Claude Code для команды, явно закрепите идентификаторы моделей, чтобы новый выпуск не переместил всех сразу:283Если вы развертываете Claude Code для команды, явно закрепите идентификаторы моделей, чтобы новый выпуск не переместил всех сразу:

284 284 


289export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5289export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

290```290```

291 291 

292Полный список идентификаторов моделей и псевдонимов см. в разделе [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для других переменных, связанных с моделями, см. [Конфигурация модели](/ru/model-config).292Полный список идентификаторов моделей и псевдонимов см. в разделе [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для других переменных, связанных с моделями, см. [Конфигурация модели](/docs/ru/model-config).

293 293 

294[Prompt caching](/ru/prompt-caching) включен автоматически. Чтобы запросить TTL кэша на 1 час вместо стандартного 5 минут, установите `ENABLE_PROMPT_CACHING_1H=1`. API выставляет счета за записи кэша на 1 час по более высокому тарифу. Ознакомьтесь с [ценами на prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) для получения информации о тарифах.294[Prompt caching](/docs/ru/prompt-caching) включен автоматически. Чтобы запросить TTL кэша на 1 час вместо стандартного 5 минут, установите `ENABLE_PROMPT_CACHING_1H=1`. API выставляет счета за записи кэша на 1 час по более высокому тарифу. Ознакомьтесь с [ценами на prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) для получения информации о тарифах.

295 295 

296<h2 id="use-the-agent-sdk">296<h2 id="use-the-agent-sdk">

297 Используйте Agent SDK297 Используйте Agent SDK

298</h2>298</h2>

299 299 

300[Agent SDK](/ru/agent-sdk/overview) читает те же переменные окружения, что и CLI, поэтому любая программа, которая порождает подпроцесс Claude Code, может нацеливаться на Claude Platform on AWS, экспортируя `CLAUDE_CODE_USE_ANTHROPIC_AWS`, `ANTHROPIC_AWS_WORKSPACE_ID` и либо `ANTHROPIC_AWS_API_KEY`, либо учетные данные AWS перед вызовом.300[Agent SDK](/docs/ru/agent-sdk/overview) читает те же переменные окружения, что и CLI, поэтому любая программа, которая порождает подпроцесс Claude Code, может нацеливаться на Claude Platform on AWS, экспортируя `CLAUDE_CODE_USE_ANTHROPIC_AWS`, `ANTHROPIC_AWS_WORKSPACE_ID` и либо `ANTHROPIC_AWS_API_KEY`, либо учетные данные AWS перед вызовом.

301 301 

302```typescript theme={null}302```typescript theme={null}

303import { query } from "@anthropic-ai/claude-agent-sdk";303import { query } from "@anthropic-ai/claude-agent-sdk";


311}311}

312```312```

313 313 

314Этот пример полагается на окружающую цепочку учетных данных AWS для SigV4. Чтобы вместо этого аутентифицироваться с помощью ключа API рабочей области, установите `ANTHROPIC_AWS_API_KEY` таким же образом. Для более широкой поверхности Agent SDK см. [Обзор Agent SDK](/ru/agent-sdk/overview).314Этот пример полагается на окружающую цепочку учетных данных AWS для SigV4. Чтобы вместо этого аутентифицироваться с помощью ключа API рабочей области, установите `ANTHROPIC_AWS_API_KEY` таким же образом. Для более широкой поверхности Agent SDK см. [Обзор Agent SDK](/docs/ru/agent-sdk/overview).

315 315 

316<h2 id="route-through-a-corporate-proxy">316<h2 id="route-through-a-corporate-proxy">

317 Маршрутизация через корпоративный прокси317 Маршрутизация через корпоративный прокси

318</h2>318</h2>

319 319 

320Чтобы маршрутизировать трафик через прокси или [LLM gateway](/ru/llm-gateway), установите `ANTHROPIC_AWS_BASE_URL` на адрес прокси. Claude Code отправляет запросы на этот URL с теми же заголовками рабочей области и аутентификации, поэтому любой шлюз, который пересылает их без изменений, работает.320Чтобы маршрутизировать трафик через прокси или [LLM gateway](/docs/ru/llm-gateway), установите `ANTHROPIC_AWS_BASE_URL` на адрес прокси. Claude Code отправляет запросы на этот URL с теми же заголовками рабочей области и аутентификации, поэтому любой шлюз, который пересылает их без изменений, работает.

321 321 

322```bash theme={null}322```bash theme={null}

323export CLAUDE_CODE_USE_ANTHROPIC_AWS=1323export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

cli-reference.md +68 −68

Details

22| `claude -c -p "query"` | Продолжить через SDK | `claude -c -p "Check for type errors"` |22| `claude -c -p "query"` | Продолжить через SDK | `claude -c -p "Check for type errors"` |

23| `claude -r "<session>" "query"` | Возобновить сеанс по ID или имени | `claude -r "auth-refactor" "Finish this PR"` |23| `claude -r "<session>" "query"` | Возобновить сеанс по ID или имени | `claude -r "auth-refactor" "Finish this PR"` |

24| `claude update` | Обновить до последней версии | `claude update` |24| `claude update` | Обновить до последней версии | `claude update` |

25| `claude gateway` | Запустить сервер самостоятельно размещаемого [Claude apps gateway](/ru/claude-apps-gateway), для администраторов, развертывающих SSO и политику перед Claude Code на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Требует `--config`, указывающий на [`gateway.yaml`](/ru/claude-apps-gateway-config). Доступно в Claude Code v2.1.195 и позже. | `claude gateway --config gateway.yaml` |25| `claude gateway` | Запустить сервер самостоятельно размещаемого [Claude apps gateway](/docs/ru/claude-apps-gateway), для администраторов, развертывающих SSO и политику перед Claude Code на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Требует `--config`, указывающий на [`gateway.yaml`](/docs/ru/claude-apps-gateway-config). Доступно в Claude Code v2.1.195 и позже. | `claude gateway --config gateway.yaml` |

26| `claude install [version]` | Установить или переустановить собственный двоичный файл. Принимает версию, такую как `2.1.118`, или `stable`, или `latest`. См. [Установить конкретную версию](/ru/setup#install-a-specific-version) | `claude install stable` |26| `claude install [version]` | Установить или переустановить собственный двоичный файл. Принимает версию, такую как `2.1.118`, или `stable`, или `latest`. См. [Установить конкретную версию](/docs/ru/setup#install-a-specific-version) | `claude install stable` |

27| `claude auth login` | Войти в свою учетную запись Anthropic. Используйте `--email` для предварительного заполнения адреса электронной почты, `--sso` для принудительной аутентификации SSO и `--console` для входа с помощью Anthropic Console для выставления счетов за использование API вместо подписки Claude | `claude auth login --console` |27| `claude auth login` | Войти в свою учетную запись Anthropic. Используйте `--email` для предварительного заполнения адреса электронной почты, `--sso` для принудительной аутентификации SSO и `--console` для входа с помощью Anthropic Console для выставления счетов за использование API вместо подписки Claude | `claude auth login --console` |

28| `claude auth logout` | Выйти из своей учетной записи Anthropic | `claude auth logout` |28| `claude auth logout` | Выйти из своей учетной записи Anthropic | `claude auth logout` |

29| `claude auth status` | Показать статус аутентификации в формате JSON. Используйте `--text` для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нет | `claude auth status` |29| `claude auth status` | Показать статус аутентификации в формате JSON. Используйте `--text` для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нет | `claude auth status` |

30| `claude agents` | Открыть [представление агентов](/ru/agent-view) для мониторинга и отправки параллельных фоновых сеансов. Используйте `--cwd <path>` для отображения только сеансов, запущенных в этом каталоге, или `--json` для вывода активных сеансов в виде массива JSON для написания скриптов (`--json --all` также включает завершенные фоновые сеансы). Передайте `--permission-mode`, `--model`, `--effort` или `--agent` для установки [значений по умолчанию для отправленных сеансов](/ru/agent-view#permission-mode-model-and-effort). Принимает `--settings`, `--add-dir`, `--plugin-dir` и `--mcp-config` как команда верхнего уровня `claude`. Открытие представления агентов требует интерактивный терминал | `claude agents --json` |30| `claude agents` | Открыть [представление агентов](/docs/ru/agent-view) для мониторинга и отправки параллельных фоновых сеансов. Используйте `--cwd <path>` для отображения только сеансов, запущенных в этом каталоге, или `--json` для вывода активных сеансов в виде массива JSON для написания скриптов (`--json --all` также включает завершенные фоновые сеансы). Передайте `--permission-mode`, `--model`, `--effort` или `--agent` для установки [значений по умолчанию для отправленных сеансов](/docs/ru/agent-view#permission-mode-model-and-effort). Принимает `--settings`, `--add-dir`, `--plugin-dir` и `--mcp-config` как команда верхнего уровня `claude`. Открытие представления агентов требует интерактивный терминал | `claude agents --json` |

31| `claude attach <id>` | Подключиться к [фоновому сеансу](/ru/agent-view#manage-sessions-from-the-shell) в этом терминале | `claude attach 7c5dcf5d` |31| `claude attach <id>` | Подключиться к [фоновому сеансу](/docs/ru/agent-view#manage-sessions-from-the-shell) в этом терминале | `claude attach 7c5dcf5d` |

32| `claude auto-mode defaults` | Вывести встроенные правила классификатора [auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) в формате JSON. Используйте `claude auto-mode config` для просмотра вашей эффективной конфигурации с применяемыми параметрами. {/* min-version: 2.1.208 */}Флаг `--label <prefix>` выводит только правила, метка которых начинается с этого префикса, сопоставляя без учета регистра. Требует Claude Code v2.1.208 или позже | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | Вывести встроенные правила классификатора [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) в формате JSON. Используйте `claude auto-mode config` для просмотра вашей эффективной конфигурации с применяемыми параметрами. Флаг `--label <prefix>` выводит только правила, метка которых начинается с этого префикса, сопоставляя без учета регистра. Требует Claude Code v2.1.208 или позже | `claude auto-mode defaults --label 'Git Destructive'` |

33| `claude daemon status` | Вывести состояние [супервизора](/ru/agent-view#the-supervisor-process) фонового сеанса, версию, каталог сокета и количество рабочих процессов для диагностики. Выходит с кодом 1, если супервизор не запущен | `claude daemon status` |33| `claude daemon status` | Вывести состояние [супервизора](/docs/ru/agent-view#the-supervisor-process) фонового сеанса, версию, каталог сокета и количество рабочих процессов для диагностики. Выходит с кодом 1, если супервизор не запущен | `claude daemon status` |

34| `claude daemon stop --any` | Остановить [супервизора](/ru/agent-view#the-supervisor-process) фонового сеанса и размещаемые им сеансы. Передайте `--keep-workers` для сохранения работающих фоновых сеансов, чтобы следующий супервизор переподключился к ним. `--any` подтверждает остановку супервизора по требованию, который используется по умолчанию. Используйте это для восстановления после [неответчивого супервизора](/ru/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |34| `claude daemon stop --any` | Остановить [супервизора](/docs/ru/agent-view#the-supervisor-process) фонового сеанса и размещаемые им сеансы. Передайте `--keep-workers` для сохранения работающих фоновых сеансов, чтобы следующий супервизор переподключился к ним. `--any` подтверждает остановку супервизора по требованию, который используется по умолчанию. Используйте это для восстановления после [неответчивого супервизора](/docs/ru/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |

35| `claude doctor` | Вывести диагностику установки и параметров только для чтения из терминала без запуска сеанса, включая проверку здоровья установки, ошибки валидации файла параметров и приемлемость Remote Control. Для проверки настройки в сеансе, которая также может применять исправления, запустите [`/doctor`](/ru/commands#all-commands) | `claude doctor` |35| `claude doctor` | Вывести диагностику установки и параметров только для чтения из терминала без запуска сеанса, включая проверку здоровья установки, ошибки валидации файла параметров и приемлемость Remote Control. Для проверки настройки в сеансе, которая также может применять исправления, запустите [`/doctor`](/docs/ru/commands#all-commands) | `claude doctor` |

36| `claude logs <id>` | Вывести недавний вывод из [фонового сеанса](/ru/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |36| `claude logs <id>` | Вывести недавний вывод из [фонового сеанса](/docs/ru/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |

37| `claude mcp` | Настроить серверы Model Context Protocol (MCP) | См. [документацию Claude Code MCP](/ru/mcp). |37| `claude mcp` | Настроить серверы Model Context Protocol (MCP) | См. [документацию Claude Code MCP](/docs/ru/mcp). |

38| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Запустить поток OAuth настроенного сервера MCP без открытия интерактивной панели `/mcp`. Работает для HTTP, SSE и серверов соединителя claude.ai. Добавьте `--no-browser` через SSH для вывода URL авторизации вместо открытия браузера, затем вставьте URL перенаправления обратно в приглашение. Требует Claude Code версии 2.1.186 или позже. См. [Аутентификация из командной строки](/ru/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |38| `claude mcp login <name>` | Запустить поток OAuth настроенного сервера MCP без открытия интерактивной панели `/mcp`. Работает для HTTP, SSE и серверов соединителя claude.ai. Добавьте `--no-browser` через SSH для вывода URL авторизации вместо открытия браузера, затем вставьте URL перенаправления обратно в приглашение. Требует Claude Code версии 2.1.186 или позже. См. [Аутентификация из командной строки](/docs/ru/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |

39| `claude mcp logout <name>` | {/* min-version: 2.1.186 */}Очистить сохраненные учетные данные OAuth для сервера MCP. Требует Claude Code версии 2.1.186 или позже | `claude mcp logout sentry` |39| `claude mcp logout <name>` | Очистить сохраненные учетные данные OAuth для сервера MCP. Требует Claude Code версии 2.1.186 или позже | `claude mcp logout sentry` |

40| `claude plugin` | Управлять Claude Code [plugins](/ru/plugins). Псевдоним: `claude plugins`. См. [справочник plugins](/ru/plugins-reference#cli-commands-reference) для подкоманд | `claude plugin install code-review@claude-plugins-official` |40| `claude plugin` | Управлять Claude Code [plugins](/docs/ru/plugins). Псевдоним: `claude plugins`. См. [справочник plugins](/docs/ru/plugins-reference#cli-commands-reference) для подкоманд | `claude plugin install code-review@claude-plugins-official` |

41| `claude project purge [path]` | Удалить все локальное состояние Claude Code для проекта: стенограммы, списки задач, журналы отладки, историю редактирования файлов, строки истории подсказок и запись проекта в `~/.claude.json`. Опустите `[path]` для выбора из интерактивного списка. Флаги: `--dry-run` для предпросмотра, `-y`/`--yes` для пропуска подтверждения, `-i`/`--interactive` для подтверждения каждого элемента, `--all` для каждого проекта. См. [Очистить локальные данные](/ru/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |41| `claude project purge [path]` | Удалить все локальное состояние Claude Code для проекта: стенограммы, списки задач, журналы отладки, историю редактирования файлов, строки истории подсказок и запись проекта в `~/.claude.json`. Опустите `[path]` для выбора из интерактивного списка. Флаги: `--dry-run` для предпросмотра, `-y`/`--yes` для пропуска подтверждения, `-i`/`--interactive` для подтверждения каждого элемента, `--all` для каждого проекта. См. [Очистить локальные данные](/docs/ru/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

42| `claude remote-control` | Запустить сервер [Remote Control](/ru/remote-control) для управления Claude Code из Claude.ai или приложения Claude. Работает в режиме сервера (без локального интерактивного сеанса). См. [флаги режима сервера](/ru/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |42| `claude remote-control` | Запустить сервер [Remote Control](/docs/ru/remote-control) для управления Claude Code из Claude.ai или приложения Claude. Работает в режиме сервера (без локального интерактивного сеанса). См. [флаги режима сервера](/docs/ru/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |

43| `claude respawn <id>` | Перезапустить [фоновый сеанс](/ru/agent-view#manage-sessions-from-the-shell), работающий или остановленный, с сохранением его беседы. Используйте `--all` для перезапуска каждого работающего сеанса, например для применения обновленного двоичного файла Claude Code | `claude respawn 7c5dcf5d` |43| `claude respawn <id>` | Перезапустить [фоновый сеанс](/docs/ru/agent-view#manage-sessions-from-the-shell), работающий или остановленный, с сохранением его беседы. Используйте `--all` для перезапуска каждого работающего сеанса, например для применения обновленного двоичного файла Claude Code | `claude respawn 7c5dcf5d` |

44| `claude rm <id>` | Удалить [фоновый сеанс](/ru/agent-view#manage-sessions-from-the-shell) из списка. Стенограмма беседы остается на вашем локальном компьютере, доступная через `claude --resume` | `claude rm 7c5dcf5d` |44| `claude rm <id>` | Удалить [фоновый сеанс](/docs/ru/agent-view#manage-sessions-from-the-shell) из списка. Стенограмма беседы остается на вашем локальном компьютере, доступная через `claude --resume` | `claude rm 7c5dcf5d` |

45| `claude setup-token` | Создать долгоживущий OAuth токен для CI и скриптов. Выводит токен в терминал без сохранения. Требует подписку Claude. См. [Создать долгоживущий токен](/ru/authentication#generate-a-long-lived-token) | `claude setup-token` |45| `claude setup-token` | Создать долгоживущий OAuth токен для CI и скриптов. Выводит токен в терминал без сохранения. Требует подписку Claude. См. [Создать долгоживущий токен](/docs/ru/authentication#generate-a-long-lived-token) | `claude setup-token` |

46| `claude stop <id>` | Остановить [фоновый сеанс](/ru/agent-view#manage-sessions-from-the-shell). Также принимает `claude kill` | `claude stop 7c5dcf5d` |46| `claude stop <id>` | Остановить [фоновый сеанс](/docs/ru/agent-view#manage-sessions-from-the-shell). Также принимает `claude kill` | `claude stop 7c5dcf5d` |

47| `claude ultrareview [target]` | Запустить [ultrareview](/ru/ultrareview#run-ultrareview-non-interactively) неинтерактивно. Выводит результаты в stdout и выходит с кодом 0 при успехе или 1 при ошибке. Используйте `--json` для необработанного полезного груза и `--timeout <minutes>` для переопределения 30-минутного значения по умолчанию | `claude ultrareview 1234 --json` |47| `claude ultrareview [target]` | Запустить [ultrareview](/docs/ru/ultrareview#run-ultrareview-non-interactively) неинтерактивно. Выводит результаты в stdout и выходит с кодом 0 при успехе или 1 при ошибке. Используйте `--json` для необработанного полезного груза и `--timeout <minutes>` для переопределения 30-минутного значения по умолчанию | `claude ultrareview 1234 --json` |

48 48 

49Если вы неправильно введете подкоманду, Claude Code предложит ближайшее совпадение и выйдет без запуска сеанса. Например, `claude udpate` выводит `Did you mean claude update?`.49Если вы неправильно введете подкоманду, Claude Code предложит ближайшее совпадение и выйдет без запуска сеанса. Например, `claude udpate` выводит `Did you mean claude update?`.

50 50 

51{/* min-version: 2.1.199 */}Начиная с версии v2.1.199, `claude --dangerously-skip-permissions daemon <subcommand>` запускает подкоманду `daemon`. В более ранних версиях `daemon <subcommand>` рассматривалась как приглашение для нового интерактивного сеанса, поэтому подкоманда никогда не запускалась, когда флаг шел первым, что является распространенной настройкой, когда `claude` имеет псевдоним, включающий флаг. Только ведущий `--dangerously-skip-permissions` или `--allow-dangerously-skip-permissions` маршрутизирует к `daemon` таким образом; любой другой ведущий флаг по-прежнему запускает интерактивный сеанс.51Начиная с версии v2.1.199, `claude --dangerously-skip-permissions daemon <subcommand>` запускает подкоманду `daemon`. В более ранних версиях `daemon <subcommand>` рассматривалась как приглашение для нового интерактивного сеанса, поэтому подкоманда никогда не запускалась, когда флаг шел первым, что является распространенной настройкой, когда `claude` имеет псевдоним, включающий флаг. Только ведущий `--dangerously-skip-permissions` или `--allow-dangerously-skip-permissions` маршрутизирует к `daemon` таким образом; любой другой ведущий флаг по-прежнему запускает интерактивный сеанс.

52 52 

53<h2 id="cli-flags">53<h2 id="cli-flags">

54 Флаги CLI54 Флаги CLI


57Настройте поведение Claude Code с помощью этих флагов командной строки. `claude --help` не выводит каждый флаг, поэтому отсутствие флага в `--help` не означает, что он недоступен.57Настройте поведение Claude Code с помощью этих флагов командной строки. `claude --help` не выводит каждый флаг, поэтому отсутствие флага в `--help` не означает, что он недоступен.

58 58 

59| Флаг | Описание | Пример |59| Флаг | Описание | Пример |

60| :---------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |

61| `--add-dir` | Добавить дополнительные рабочие каталоги для Claude для чтения и редактирования файлов. Предоставляет доступ к файлам; большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов. Проверяет, что каждый путь существует как каталог. Чтобы сохранить эти каталоги между сеансами, установите [`permissions.additionalDirectories`](/ru/settings#permission-settings) в параметрах | `claude --add-dir ../apps ../lib` |61| `--add-dir` | Добавить дополнительные рабочие каталоги для Claude для чтения и редактирования файлов. Предоставляет доступ к файлам; большинство конфигурации `.claude/` [не обнаруживается](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов. Проверяет, что каждый путь существует как каталог. Чтобы сохранить эти каталоги между сеансами, установите [`permissions.additionalDirectories`](/docs/ru/settings#permission-settings) в параметрах | `claude --add-dir ../apps ../lib` |

62| `--advisor <model>` | Включить инструмент [advisor](/ru/advisor) на стороне сервера для этого сеанса с псевдонимом модели: `opus`, `sonnet` или `fable` ({/* min-version: 2.1.170 */}v2.1.170+), или полный ID модели. Имеет приоритет над параметром `advisorModel` для сеанса | `claude --advisor opus` |62| `--advisor <model>` | Включить инструмент [advisor](/docs/ru/advisor) на стороне сервера для этого сеанса с псевдонимом модели: `opus`, `sonnet` или `fable` (v2.1.170+), или полный ID модели. Имеет приоритет над параметром `advisorModel` для сеанса | `claude --advisor opus` |

63| `--agent` | Указать агента для текущего сеанса (переопределяет параметр `agent`) | `claude --agent my-custom-agent` |63| `--agent` | Указать агента для текущего сеанса (переопределяет параметр `agent`) | `claude --agent my-custom-agent` |

64| `--agents` | Определить пользовательские subagents динамически через JSON. Использует те же имена полей, что и subagent [frontmatter](/ru/sub-agents#supported-frontmatter-fields), плюс поле `prompt` для инструкций агента | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | Определить пользовательские subagents динамически через JSON. Использует те же имена полей, что и subagent [frontmatter](/docs/ru/sub-agents#supported-frontmatter-fields), плюс поле `prompt` для инструкций агента | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

65| `--allow-dangerously-skip-permissions` | Добавить `bypassPermissions` в цикл режима `Shift+Tab` без немедленной активации. Позволяет начать в другом режиме, таком как `plan`, и переключиться на `bypassPermissions` позже. См. [режимы разрешения](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | Добавить `bypassPermissions` в цикл режима `Shift+Tab` без немедленной активации. Позволяет начать в другом режиме, таком как `plan`, и переключиться на `bypassPermissions` позже. См. [режимы разрешения](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

66| `--allowedTools`, `--allowed-tools` | Инструменты, которые выполняются без запроса разрешения. См. [синтаксис правила разрешения](/ru/settings#permission-rule-syntax) для сопоставления шаблонов. Чтобы ограничить доступные инструменты, используйте `--tools` вместо этого | `"Bash(git log *)" "Bash(git diff *)" "Read"` |66| `--allowedTools`, `--allowed-tools` | Инструменты, которые выполняются без запроса разрешения. См. [синтаксис правила разрешения](/docs/ru/settings#permission-rule-syntax) для сопоставления шаблонов. Чтобы ограничить доступные инструменты, используйте `--tools` вместо этого | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Добавить пользовательский текст в конец системного приглашения каждого [subagent](/ru/sub-agents), включая вложенные subagents. Применяется только в неинтерактивном режиме с `-p`. Требует Claude Code v2.1.205 или позже | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |67| `--append-subagent-system-prompt` | Добавить пользовательский текст в конец системного приглашения каждого [subagent](/docs/ru/sub-agents), включая вложенные subagents. Применяется только в неинтерактивном режиме с `-p`. Требует Claude Code v2.1.205 или позже | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

68| `--append-system-prompt` | Добавить пользовательский текст в конец системного приглашения по умолчанию | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | Добавить пользовательский текст в конец системного приглашения по умолчанию | `claude --append-system-prompt "Always use TypeScript"` |

69| `--append-system-prompt-file` | Загрузить дополнительный текст системного приглашения из файла и добавить к приглашению по умолчанию | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | Загрузить дополнительный текст системного приглашения из файла и добавить к приглашению по умолчанию | `claude --append-system-prompt-file ./extra-rules.txt` |

70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Принудительно использует классический рендерер, поэтому параметр [`tui`](/ru/settings#available-settings) не имеет эффекта; присоединённые [фоновые сеансы](/ru/agent-view) по-прежнему отрендериваются в полноэкранном режиме. Имеет приоритет над [`CLAUDE_AX_SCREEN_READER`](/ru/env-vars) и параметром [`axScreenReader`](/ru/settings#available-settings). Требует Claude Code v2.1.181 или позже | `claude --ax-screen-reader` |70| `--ax-screen-reader` | Отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Принудительно использует классический рендерер, поэтому параметр [`tui`](/docs/ru/settings#available-settings) не имеет эффекта; присоединённые [фоновые сеансы](/docs/ru/agent-view) по-прежнему отрендериваются в полноэкранном режиме. Имеет приоритет над [`CLAUDE_AX_SCREEN_READER`](/docs/ru/env-vars) и параметром [`axScreenReader`](/docs/ru/settings#available-settings). Требует Claude Code v2.1.181 или позже | `claude --ax-screen-reader` |

71| `--bare` | Минимальный режим: пропустить автоматическое обнаружение hooks, skills, plugins, MCP серверов, автоматической памяти и CLAUDE.md, чтобы скриптовые вызовы начинались быстрее. Claude имеет доступ к инструментам Bash, чтения файлов и редактирования файлов. Устанавливает [`CLAUDE_CODE_SIMPLE`](/ru/env-vars). См. [bare mode](/ru/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |71| `--bare` | Минимальный режим: пропустить автоматическое обнаружение hooks, skills, plugins, MCP серверов, автоматической памяти и CLAUDE.md, чтобы скриптовые вызовы начинались быстрее. Claude имеет доступ к инструментам Bash, чтения файлов и редактирования файлов. Устанавливает [`CLAUDE_CODE_SIMPLE`](/docs/ru/env-vars). См. [bare mode](/docs/ru/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

72| `--betas` | Заголовки бета-версии для включения в запросы API (только для пользователей API-ключей) | `claude --betas interleaved-thinking` |72| `--betas` | Заголовки бета-версии для включения в запросы API (только для пользователей API-ключей) | `claude --betas interleaved-thinking` |

73| `--bg`, `--background` | Запустить сеанс как [фоновый агент](/ru/agent-view) и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с `--exec` для запуска команды shell как фонового задания вместо сеанса Claude, или с `--agent` для запуска конкретного subagent. {/* min-version: 2.1.198 */}Не может быть скомбинирован с `-p`/`--print`; см. [справочник ошибок](/ru/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |73| `--bg`, `--background` | Запустить сеанс как [фоновый агент](/docs/ru/agent-view) и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с `--exec` для запуска команды shell как фонового задания вместо сеанса Claude, или с `--agent` для запуска конкретного subagent. Не может быть скомбинирован с `-p`/`--print`; см. [справочник ошибок](/docs/ru/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

74| `--channels` | (Исследовательский предпросмотр) MCP серверы, чьи уведомления [channel](/ru/channels) Claude должен слушать в этом сеансе. Разделенный пробелом список записей `plugin:<name>@<marketplace>`. Требует аутентификацию Claude.ai | `claude --channels plugin:my-notifier@my-marketplace` |74| `--channels` | (Исследовательский предпросмотр) MCP серверы, чьи уведомления [channel](/docs/ru/channels) Claude должен слушать в этом сеансе. Разделенный пробелом список записей `plugin:<name>@<marketplace>`. Требует аутентификацию Claude.ai | `claude --channels plugin:my-notifier@my-marketplace` |

75| `--chrome` | Включить [интеграцию браузера Chrome](/ru/chrome) для веб-автоматизации и тестирования | `claude --chrome` |75| `--chrome` | Включить [интеграцию браузера Chrome](/docs/ru/chrome) для веб-автоматизации и тестирования | `claude --chrome` |

76| `--cloud` | Создать новый [веб-сеанс](/ru/claude-code-on-the-web) на claude.ai с предоставленным описанием задачи | `claude --cloud "Fix the login bug"` |76| `--cloud` | Создать новый [веб-сеанс](/docs/ru/claude-code-on-the-web) на claude.ai с предоставленным описанием задачи | `claude --cloud "Fix the login bug"` |

77| `--continue`, `-c` | Загрузить самую последнюю беседу в текущем каталоге. Включает сеансы, которые добавили этот каталог с помощью `/add-dir` | `claude --continue` |77| `--continue`, `-c` | Загрузить самую последнюю беседу в текущем каталоге. Включает сеансы, которые добавили этот каталог с помощью `/add-dir` | `claude --continue` |

78| `--dangerously-load-development-channels` | Включить [channels](/ru/channels-reference#test-during-the-research-preview), которые не находятся в утвержденном списке разрешений, для локальной разработки. Принимает записи `plugin:<name>@<marketplace>` и `server:<name>`. Запрашивает подтверждение | `claude --dangerously-load-development-channels server:webhook` |78| `--dangerously-load-development-channels` | Включить [channels](/docs/ru/channels-reference#test-during-the-research-preview), которые не находятся в утвержденном списке разрешений, для локальной разработки. Принимает записи `plugin:<name>@<marketplace>` и `server:<name>`. Запрашивает подтверждение | `claude --dangerously-load-development-channels server:webhook` |

79| `--dangerously-skip-permissions` | Пропустить запросы разрешения. Эквивалентно `--permission-mode bypassPermissions`. См. [режимы разрешения](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для информации о том, что это пропускает и что не пропускает. Для сеансов, запущенных с `--bg`, режим [сохраняется при перезапуске сеанса супервизором](/ru/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |79| `--dangerously-skip-permissions` | Пропустить запросы разрешения. Эквивалентно `--permission-mode bypassPermissions`. См. [режимы разрешения](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для информации о том, что это пропускает и что не пропускает. Для сеансов, запущенных с `--bg`, режим [сохраняется при перезапуске сеанса супервизором](/docs/ru/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

80| `--debug` | Включить режим отладки с дополнительной фильтрацией категорий (например, `"api,hooks"` или `"!statsig,!file"`) | `claude --debug "api,mcp"` |80| `--debug` | Включить режим отладки с дополнительной фильтрацией категорий (например, `"api,hooks"` или `"!statsig,!file"`) | `claude --debug "api,mcp"` |

81| `--debug-file <path>` | Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |81| `--debug-file <path>` | Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

82| `--disable-slash-commands` | Отключить все skills и команды для этого сеанса | `claude --disable-slash-commands` |82| `--disable-slash-commands` | Отключить все skills и команды для этого сеанса | `claude --disable-slash-commands` |

83| `--disallowedTools`, `--disallowed-tools` | Правила отрицания. Простое имя инструмента удаляет соответствующие инструменты из контекста модели: `"Edit"` удаляет Edit, `"*"` удаляет каждый инструмент, и `"mcp__*"` удаляет каждый MCP инструмент. Правило с областью действия, такое как `Bash(rm *)`, оставляет инструмент доступным и отрицает только совпадающие вызовы | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |83| `--disallowedTools`, `--disallowed-tools` | Правила отрицания. Простое имя инструмента удаляет соответствующие инструменты из контекста модели: `"Edit"` удаляет Edit, `"*"` удаляет каждый инструмент, и `"mcp__*"` удаляет каждый MCP инструмент. Правило с областью действия, такое как `Bash(rm *)`, оставляет инструмент доступным и отрицает только совпадающие вызовы | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

84| `--effort` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) для текущего сеанса. Опции: `low`, `medium`, `high`, `xhigh`, `max` или {/* min-version: 2.1.203 */}}`ultracode`. Доступные уровни зависят от модели. `ultracode` запускает сеанс с усилием `xhigh` с включенным [ultracode](/ru/workflows#let-claude-decide-with-ultracode) и требует Claude Code v2.1.203 или позже. Переопределяет параметр [`effortLevel`](/ru/settings#available-settings) для этого сеанса и не сохраняется | `claude --effort high` |84| `--effort` | Установить [уровень усилий](/docs/ru/model-config#adjust-effort-level) для текущего сеанса. Опции: `low`, `medium`, `high`, `xhigh`, `max` или }`ultracode`. Доступные уровни зависят от модели. `ultracode` запускает сеанс с усилием `xhigh` с включенным [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) и требует Claude Code v2.1.203 или позже. Переопределяет параметр [`effortLevel`](/docs/ru/settings#available-settings) для этого сеанса и не сохраняется | `claude --effort high` |

85| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Удалено в v2.1.111. Auto mode теперь находится в цикле `Shift+Tab` по умолчанию; используйте `--permission-mode auto` для запуска в нем | `claude --permission-mode auto` |85| `--enable-auto-mode` | Удалено в v2.1.111. Auto mode теперь находится в цикле `Shift+Tab` по умолчанию; используйте `--permission-mode auto` для запуска в нем | `claude --permission-mode auto` |

86| `--exclude-dynamic-system-prompt-sections` | Переместить разделы для каждой машины из системного приглашения (рабочий каталог, информация об окружении, пути памяти, флаг git-repo) в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены `--system-prompt` или `--system-prompt-file`. Используйте с `-p` для скриптовых многопользовательских рабочих нагрузок | `claude -p --exclude-dynamic-system-prompt-sections "query"` |86| `--exclude-dynamic-system-prompt-sections` | Переместить разделы для каждой машины из системного приглашения (рабочий каталог, информация об окружении, пути памяти, флаг git-repo) в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены `--system-prompt` или `--system-prompt-file`. Используйте с `-p` для скриптовых многопользовательских рабочих нагрузок | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

87| `--exec` | Запустить команду shell как фоновое задание с поддержкой PTY вместо запуска сеанса Claude. Используйте с `--bg` для запуска из shell | `claude --bg --exec 'pytest -x'` |87| `--exec` | Запустить команду shell как фоновое задание с поддержкой PTY вместо запуска сеанса Claude. Используйте с `--bg` для запуска из shell | `claude --bg --exec 'pytest -x'` |

88| `--fallback-model` | Включить автоматический переход на указанную модель (модели) при перегрузке или недоступности основной модели, например снятая с производства модель. Принимает разделенный запятыми список, пробуемый по порядку. См. [Цепочки резервных моделей](/ru/model-config#fallback-model-chains). Чтобы сохранить цепочку между сеансами, используйте параметр [`fallbackModel`](/ru/settings#available-settings), который этот флаг переопределяет | `claude --fallback-model sonnet,haiku` |88| `--fallback-model` | Включить автоматический переход на указанную модель (модели) при перегрузке или недоступности основной модели, например снятая с производства модель. Принимает разделенный запятыми список, пробуемый по порядку. См. [Цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains). Чтобы сохранить цепочку между сеансами, используйте параметр [`fallbackModel`](/docs/ru/settings#available-settings), который этот флаг переопределяет | `claude --fallback-model sonnet,haiku` |

89| `--fork-session` | При возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с `--resume` или `--continue`) | `claude --resume abc123 --fork-session` |89| `--fork-session` | При возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с `--resume` или `--continue`) | `claude --resume abc123 --fork-session` |

90| `--from-pr` | Возобновить сеансы, связанные с конкретным pull request. Принимает номер PR, URL GitHub или GitHub Enterprise PR, URL GitLab merge request или URL Bitbucket pull request. Сеансы автоматически связываются при создании Claude pull request | `claude --from-pr 123` |90| `--from-pr` | Возобновить сеансы, связанные с конкретным pull request. Принимает номер PR, URL GitHub или GitHub Enterprise PR, URL GitLab merge request или URL Bitbucket pull request. Сеансы автоматически связываются при создании Claude pull request | `claude --from-pr 123` |

91| `--ide` | Автоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDE | `claude --ide` |91| `--ide` | Автоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDE | `claude --ide` |

92| `--init` | Запустить [Setup hooks](/ru/hooks#setup) с помощью matcher `init` перед сеансом (только режим печати) | `claude -p --init "query"` |92| `--init` | Запустить [Setup hooks](/docs/ru/hooks#setup) с помощью matcher `init` перед сеансом (только режим печати) | `claude -p --init "query"` |

93| `--init-only` | Запустить [Setup](/ru/hooks#setup) и `SessionStart` hooks, затем выйти без запуска беседы | `claude --init-only` |93| `--init-only` | Запустить [Setup](/docs/ru/hooks#setup) и `SessionStart` hooks, затем выйти без запуска беседы | `claude --init-only` |

94| `--include-hook-events` | Включить события жизненного цикла hook из каждого события hook в выходной поток. События `SessionStart` и `Setup` hook всегда включены и не требуют этого флага. Требует `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |94| `--include-hook-events` | Включить события жизненного цикла hook из каждого события hook в выходной поток. События `SessionStart` и `Setup` hook всегда включены и не требуют этого флага. Требует `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

95| `--include-partial-messages` | Включить частичные события потоковой передачи в вывод. Требует `--print` и `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |95| `--include-partial-messages` | Включить частичные события потоковой передачи в вывод. Требует `--print` и `--output-format stream-json` | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |

96| `--input-format` | Указать формат входных данных для режима печати (опции: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |96| `--input-format` | Указать формат входных данных для режима печати (опции: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |

97| `--json-schema` | Получить проверенный вывод JSON, соответствующий JSON Schema после завершения рабочего процесса агента (только режим печати). См. [структурированные выходы](/ru/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Claude Code выходит с ошибкой при недействительной схеме и принимает ключевое слово `format` как аннотацию без проверки на стороне клиента. До v2.1.205 недействительная схема выдавала неструктурированный вывод без ошибки, и схемы, использующие `format`, рассматривались как недействительные | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |97| `--json-schema` | Получить проверенный вывод JSON, соответствующий JSON Schema после завершения рабочего процесса агента (только режим печати). См. [структурированные выходы](/docs/ru/agent-sdk/structured-outputs). Claude Code выходит с ошибкой при недействительной схеме и принимает ключевое слово `format` как аннотацию без проверки на стороне клиента. До v2.1.205 недействительная схема выдавала неструктурированный вывод без ошибки, и схемы, использующие `format`, рассматривались как недействительные | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

98| `--maintenance` | Запустить [Setup hooks](/ru/hooks#setup) с помощью matcher `maintenance` перед сеансом (только режим печати) | `claude -p --maintenance "query"` |98| `--maintenance` | Запустить [Setup hooks](/docs/ru/hooks#setup) с помощью matcher `maintenance` перед сеансом (только режим печати) | `claude -p --maintenance "query"` |

99| `--max-budget-usd` | Максимальная сумма в долларах для расходования на вызовы API перед остановкой (только режим печати) | `claude -p --max-budget-usd 5.00 "query"` |99| `--max-budget-usd` | Максимальная сумма в долларах для расходования на вызовы API перед остановкой (только режим печати) | `claude -p --max-budget-usd 5.00 "query"` |

100| `--max-turns` | Ограничить количество агентских ходов (только режим печати). Выходит с ошибкой при достижении лимита. По умолчанию нет лимита. {/* min-version: 2.1.205 */}С `--input-format stream-json` сообщение, отправленное во время работы Claude, остается в очереди и выполняется как собственный ход с собственным лимитом, когда лимит заканчивает текущий. До v2.1.205 Claude Code отбрасывал это сообщение | `claude -p --max-turns 3 "query"` |100| `--max-turns` | Ограничить количество агентских ходов (только режим печати). Выходит с ошибкой при достижении лимита. По умолчанию нет лимита. С `--input-format stream-json` сообщение, отправленное во время работы Claude, остается в очереди и выполняется как собственный ход с собственным лимитом, когда лимит заканчивает текущий. До v2.1.205 Claude Code отбрасывал это сообщение | `claude -p --max-turns 3 "query"` |

101| `--mcp-config` | Загрузить MCP серверы из JSON файлов или строк (разделенные пробелом) | `claude --mcp-config ./mcp.json` |101| `--mcp-config` | Загрузить MCP серверы из JSON файлов или строк (разделенные пробелом) | `claude --mcp-config ./mcp.json` |

102| `--model` | Устанавливает модель для текущего сеанса с псевдонимом для последней модели (`sonnet`, `opus`, `haiku` или `fable`) или полным именем модели. Переопределяет параметр [`model`](/ru/settings#available-settings) и [`ANTHROPIC_MODEL`](/ru/model-config#environment-variables) | `claude --model claude-sonnet-5` |102| `--model` | Устанавливает модель для текущего сеанса с псевдонимом для последней модели (`sonnet`, `opus`, `haiku` или `fable`) или полным именем модели. Переопределяет параметр [`model`](/docs/ru/settings#available-settings) и [`ANTHROPIC_MODEL`](/docs/ru/model-config#environment-variables) | `claude --model claude-sonnet-5` |

103| `--name`, `-n` | Установить отображаемое имя для сеанса, показываемое в `/resume` и в заголовке терминала. Вы можете возобновить именованный сеанс с помощью `claude --resume <name>`. <br /><br />[`/rename`](/ru/commands) изменяет имя во время сеанса и также показывает его на панели приглашения | `claude -n "my-feature-work"` |103| `--name`, `-n` | Установить отображаемое имя для сеанса, показываемое в `/resume` и в заголовке терминала. Вы можете возобновить именованный сеанс с помощью `claude --resume <name>`. <br /><br />[`/rename`](/docs/ru/commands) изменяет имя во время сеанса и также показывает его на панели приглашения | `claude -n "my-feature-work"` |

104| `--no-chrome` | Отключить [интеграцию браузера Chrome](/ru/chrome) для этого сеанса | `claude --no-chrome` |104| `--no-chrome` | Отключить [интеграцию браузера Chrome](/docs/ru/chrome) для этого сеанса | `claude --no-chrome` |

105| `--no-session-persistence` | Отключить сохранение сеанса, чтобы сеансы не сохранялись на диск и не могли быть возобновлены. Только режим печати. Переменная окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ru/env-vars) делает то же самое в любом режиме | `claude -p --no-session-persistence "query"` |105| `--no-session-persistence` | Отключить сохранение сеанса, чтобы сеансы не сохранялись на диск и не могли быть возобновлены. Только режим печати. Переменная окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars) делает то же самое в любом режиме | `claude -p --no-session-persistence "query"` |

106| `--output-format` | Указать формат вывода для режима печати (опции: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |106| `--output-format` | Указать формат вывода для режима печати (опции: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

107| `--permission-mode` | Начать в указанном [режиме разрешения](/ru/permission-modes). Принимает `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` или {/* min-version: 2.1.200 */}}`manual` как псевдоним для `default`. Псевдоним `manual` выбирает режим, который UI обозначает как Manual и требует Claude Code v2.1.200 или позже; `claude --help` выводит его вместо `default`, и оба значения работают. Переопределяет `defaultMode` из файлов параметров | `claude --permission-mode plan` |107| `--permission-mode` | Начать в указанном [режиме разрешения](/docs/ru/permission-modes). Принимает `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` или }`manual` как псевдоним для `default`. Псевдоним `manual` выбирает режим, который UI обозначает как Manual и требует Claude Code v2.1.200 или позже; `claude --help` выводит его вместо `default`, и оба значения работают. Переопределяет `defaultMode` из файлов параметров | `claude --permission-mode plan` |

108| `--permission-prompt-tool` | Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме. {/* min-version: 2.1.206 */}Claude Code ждет подключения MCP сервера этого инструмента перед запуском первого хода, до [MCP\_TIMEOUT](/ru/env-vars) стартового таймаута в 30 секунд. До v2.1.206 медленно запускающийся сервер мог привести к [выходу с ошибкой, что инструмент MCP не найден](/ru/errors#mcp-permission-prompt-tool-not-found). <br /><br />{/* min-version: 2.1.199 */}Инструмент приглашения не может одобрить инструмент MCP, отмеченный как [требующий взаимодействия пользователя](/ru/mcp#require-approval-for-a-specific-tool): Claude Code преобразует результат `allow` для одного в отрицание. Это ограничение требует Claude Code v2.1.199 или позже | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |108| `--permission-prompt-tool` | Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме. Claude Code ждет подключения MCP сервера этого инструмента перед запуском первого хода, до [MCP\_TIMEOUT](/docs/ru/env-vars) стартового таймаута в 30 секунд. До v2.1.206 медленно запускающийся сервер мог привести к [выходу с ошибкой, что инструмент MCP не найден](/docs/ru/errors#mcp-permission-prompt-tool-not-found). <br /><br />Инструмент приглашения не может одобрить инструмент MCP, отмеченный как [требующий взаимодействия пользователя](/docs/ru/mcp#require-approval-for-a-specific-tool): Claude Code преобразует результат `allow` для одного в отрицание. Это ограничение требует Claude Code v2.1.199 или позже | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

109| `--plugin-dir` | Загрузить plugin из каталога или архива `.zip` только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких plugins: `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |109| `--plugin-dir` | Загрузить plugin из каталога или архива `.zip` только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких plugins: `--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |

110| `--plugin-url` | Получить plugin архив `.zip` из URL только для этого сеанса. Повторите флаг для нескольких plugins или передайте разделенные пробелом URL в одном значении в кавычках | `claude --plugin-url https://example.com/plugin.zip` |110| `--plugin-url` | Получить plugin архив `.zip` из URL только для этого сеанса. Повторите флаг для нескольких plugins или передайте разделенные пробелом URL в одном значении в кавычках | `claude --plugin-url https://example.com/plugin.zip` |

111| `--print`, `-p` | Вывести ответ без интерактивного режима (см. [документацию Agent SDK](/ru/agent-sdk/overview) для деталей программного использования) | `claude -p "query"` |111| `--print`, `-p` | Вывести ответ без интерактивного режима (см. [документацию Agent SDK](/docs/ru/agent-sdk/overview) для деталей программного использования) | `claude -p "query"` |

112| `--prompt-suggestions` | Выдать сообщение `prompt_suggestion` после каждого хода с предсказанным следующим приглашением пользователя. Требует `--print`, `--output-format stream-json` и `--verbose`. См. [Предложения приглашений](/ru/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |112| `--prompt-suggestions` | Выдать сообщение `prompt_suggestion` после каждого хода с предсказанным следующим приглашением пользователя. Требует `--print`, `--output-format stream-json` и `--verbose`. См. [Предложения приглашений](/docs/ru/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

113| `--remote` | Устаревший псевдоним для `--cloud` | `claude --remote "Fix the login bug"` |113| `--remote` | Устаревший псевдоним для `--cloud` | `claude --remote "Fix the login bug"` |

114| `--remote-control`, `--rc` | Запустить интерактивный сеанс с включенным [Remote Control](/ru/remote-control#start-a-remote-control-session), чтобы вы также могли управлять им из claude.ai или приложения Claude. Опционально передайте имя для сеанса | `claude --remote-control "My Project"` |114| `--remote-control`, `--rc` | Запустить интерактивный сеанс с включенным [Remote Control](/docs/ru/remote-control#start-a-remote-control-session), чтобы вы также могли управлять им из claude.ai или приложения Claude. Опционально передайте имя для сеанса | `claude --remote-control "My Project"` |

115| `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически генерируемых имен сеансов [Remote Control](/ru/remote-control) при отсутствии явного имени. По умолчанию используется имя хоста вашей машины, создавая имена вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта | `claude remote-control --remote-control-session-name-prefix dev-box` |115| `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически генерируемых имен сеансов [Remote Control](/docs/ru/remote-control) при отсутствии явного имени. По умолчанию используется имя хоста вашей машины, создавая имена вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта | `claude remote-control --remote-control-session-name-prefix dev-box` |

116| `--replay-user-messages` | Повторно отправить пользовательские сообщения из stdin обратно на stdout для подтверждения. Требует `--input-format stream-json` и `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |116| `--replay-user-messages` | Повторно отправить пользовательские сообщения из stdin обратно на stdout для подтверждения. Требует `--input-format stream-json` и `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

117| `--resume`, `-r` | Возобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Выбор и поиск по имени включают сеансы, которые добавили этот каталог с помощью `/add-dir`; передача ID сеанса ищет только текущий каталог проекта и его git worktrees. Начиная с v2.1.144, [фоновые сеансы](/ru/agent-view) появляются в выборе, отмеченные как `bg` | `claude --resume auth-refactor` |117| `--resume`, `-r` | Возобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Выбор и поиск по имени включают сеансы, которые добавили этот каталог с помощью `/add-dir`; передача ID сеанса ищет только текущий каталог проекта и его git worktrees. Начиная с v2.1.144, [фоновые сеансы](/docs/ru/agent-view) появляются в выборе, отмеченные как `bg` | `claude --resume auth-refactor` |

118| `--safe-mode` | {/* min-version: 2.1.169 */}Запустить со всеми отключенными настройками для устранения неполадок в нарушенной конфигурации: CLAUDE.md, skills, plugins, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, строка состояния и команды предложения файлов, LSP серверы и автоматическая память не загружаются. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально, что отличается от [`--bare`](/ru/headless#start-faster-with-bare-mode). Политика управляемых параметров все еще применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемый CLAUDE.md и настроенные политикой MCP серверы не загружаются. Полезно для проверки того, является ли настройка причиной [автоматического переключения с Fable 5](/ru/model-config#automatic-model-fallback). Устанавливает [`CLAUDE_CODE_SAFE_MODE`](/ru/env-vars) | `claude --safe-mode` |118| `--safe-mode` | Запустить со всеми отключенными настройками для устранения неполадок в нарушенной конфигурации: CLAUDE.md, skills, plugins, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, строка состояния и команды предложения файлов, LSP серверы и автоматическая память не загружаются. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально, что отличается от [`--bare`](/docs/ru/headless#start-faster-with-bare-mode). Политика управляемых параметров все еще применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемый CLAUDE.md и настроенные политикой MCP серверы не загружаются. Полезно для проверки того, является ли настройка причиной [автоматического переключения с Fable 5](/docs/ru/model-config#automatic-model-fallback). Устанавливает [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars) | `claude --safe-mode` |

119| `--session-id` | Использовать конкретный ID сеанса для беседы (должен быть действительным UUID) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |119| `--session-id` | Использовать конкретный ID сеанса для беседы (должен быть действительным UUID) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

120| `--setting-sources` | Разделенный запятыми список источников параметров для загрузки (`user`, `project`, `local`) | `claude --setting-sources user,project` |120| `--setting-sources` | Разделенный запятыми список источников параметров для загрузки (`user`, `project`, `local`) | `claude --setting-sources user,project` |

121| `--settings` | Путь к файлу параметров JSON или встроенная строка JSON. Значения, которые вы устанавливаете здесь, переопределяют те же ключи в ваших файлах `settings.json` для этого сеанса. Ключи, которые вы опускаете, сохраняют свои значения на основе файла. См. [приоритет параметров](/ru/settings#settings-precedence) | `claude --settings ./settings.json` |121| `--settings` | Путь к файлу параметров JSON или встроенная строка JSON. Значения, которые вы устанавливаете здесь, переопределяют те же ключи в ваших файлах `settings.json` для этого сеанса. Ключи, которые вы опускаете, сохраняют свои значения на основе файла. См. [приоритет параметров](/docs/ru/settings#settings-precedence) | `claude --settings ./settings.json` |

122| `--strict-mcp-config` | Использовать только MCP серверы из `--mcp-config`, игнорируя все остальные конфигурации MCP | `claude --strict-mcp-config --mcp-config ./mcp.json` |122| `--strict-mcp-config` | Использовать только MCP серверы из `--mcp-config`, игнорируя все остальные конфигурации MCP | `claude --strict-mcp-config --mcp-config ./mcp.json` |

123| `--system-prompt` | Заменить весь системный запрос пользовательским текстом | `claude --system-prompt "You are a Python expert"` |123| `--system-prompt` | Заменить весь системный запрос пользовательским текстом | `claude --system-prompt "You are a Python expert"` |

124| `--system-prompt-file` | Загрузить системный запрос из файла, заменяя приглашение по умолчанию | `claude --system-prompt-file ./custom-prompt.txt` |124| `--system-prompt-file` | Загрузить системный запрос из файла, заменяя приглашение по умолчанию | `claude --system-prompt-file ./custom-prompt.txt` |

125| `--teleport` | Возобновить [веб-сеанс](/ru/claude-code-on-the-web) в вашем локальном терминале | `claude --teleport` |125| `--teleport` | Возобновить [веб-сеанс](/docs/ru/claude-code-on-the-web) в вашем локальном терминале | `claude --teleport` |

126| `--teammate-mode` | Установить способ отображения товарищей по [команде агентов](/ru/agent-teams): `in-process` (по умолчанию), `auto`, `tmux` или {/* min-version: 2.1.186 */}}`iterm2` (добавлено в v2.1.186). Значение по умолчанию изменилось с `auto` в v2.1.179. Переопределяет параметр [`teammateMode`](/ru/settings#available-settings) для этого сеанса. См. [выбор режима отображения](/ru/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |126| `--teammate-mode` | Установить способ отображения товарищей по [команде агентов](/docs/ru/agent-teams): `in-process` (по умолчанию), `auto`, `tmux` или }`iterm2` (добавлено в v2.1.186). Значение по умолчанию изменилось с `auto` в v2.1.179. Переопределяет параметр [`teammateMode`](/docs/ru/settings#available-settings) для этого сеанса. См. [выбор режима отображения](/docs/ru/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

127| `--tmux` | Создать сеанс tmux для worktree. Требует `--worktree`. Использует встроенные панели iTerm2, если доступны; передайте `--tmux=classic` для традиционного tmux | `claude -w feature-auth --tmux` |127| `--tmux` | Создать сеанс tmux для worktree. Требует `--worktree`. Использует встроенные панели iTerm2, если доступны; передайте `--tmux=classic` для традиционного tmux | `claude -w feature-auth --tmux` |

128| `--tools` | Ограничить, какие встроенные инструменты может использовать Claude. Используйте `""` для отключения всех, `"default"` для всех или имена инструментов, такие как `"Bash,Edit,Read"`. MCP инструменты не затронуты; чтобы отрицать и их, используйте `--disallowedTools "mcp__*"` или передайте `--strict-mcp-config` без `--mcp-config`, чтобы не загружались MCP серверы | `claude --tools "Bash,Edit,Read"` |128| `--tools` | Ограничить, какие встроенные инструменты может использовать Claude. Используйте `""` для отключения всех, `"default"` для всех или имена инструментов, такие как `"Bash,Edit,Read"`. MCP инструменты не затронуты; чтобы отрицать и их, используйте `--disallowedTools "mcp__*"` или передайте `--strict-mcp-config` без `--mcp-config`, чтобы не загружались MCP серверы | `claude --tools "Bash,Edit,Read"` |

129| `--verbose` | Включить подробное логирование, показывает полный вывод по ходам. Переопределяет параметр [`viewMode`](/ru/settings#available-settings) для этого сеанса | `claude --verbose` |129| `--verbose` | Включить подробное логирование, показывает полный вывод по ходам. Переопределяет параметр [`viewMode`](/docs/ru/settings#available-settings) для этого сеанса | `claude --verbose` |

130| `--version`, `-v` | Вывести номер версии | `claude -v` |130| `--version`, `-v` | Вывести номер версии | `claude -v` |

131| `--worktree`, `-w` | Запустить Claude в изолированном [git worktree](/ru/worktrees) в `<repo>/.claude/worktrees/<name>`. Если имя не указано, оно генерируется автоматически. Передайте `#<number>` или URL GitHub pull request для получения этого PR из `origin` и ветвления worktree из него | `claude -w feature-auth` |131| `--worktree`, `-w` | Запустить Claude в изолированном [git worktree](/docs/ru/worktrees) в `<repo>/.claude/worktrees/<name>`. Если имя не указано, оно генерируется автоматически. Передайте `#<number>` или URL GitHub pull request для получения этого PR из `origin` и ветвления worktree из него | `claude -w feature-auth` |

132 132 

133<h3 id="system-prompt-flags">133<h3 id="system-prompt-flags">

134 Флаги системного приглашения134 Флаги системного приглашения


147 147 

148Выбирайте в зависимости от того, подходит ли стандартная идентичность Claude Code для вашей задачи. Используйте флаг добавления, когда Claude должен оставаться помощником по кодированию, который также следует вашим дополнительным правилам: инструкции для каждого вызова, форматирование вывода или контекст домена для скрипта `-p`. Добавление сохраняет стандартное руководство по инструментам, инструкции безопасности и соглашения кодирования, поэтому вы предоставляете только то, что отличается. Используйте флаг замены, когда поверхность, идентичность или модель разрешения отличаются от Claude Code, например некодирующий агент в конвейере, который не смотрит ни один человек. Замена удаляет весь стандартный запрос, включая руководство по инструментам и инструкции безопасности, поэтому вы берете на себя ответственность за все, что вашей задаче все еще нужно.148Выбирайте в зависимости от того, подходит ли стандартная идентичность Claude Code для вашей задачи. Используйте флаг добавления, когда Claude должен оставаться помощником по кодированию, который также следует вашим дополнительным правилам: инструкции для каждого вызова, форматирование вывода или контекст домена для скрипта `-p`. Добавление сохраняет стандартное руководство по инструментам, инструкции безопасности и соглашения кодирования, поэтому вы предоставляете только то, что отличается. Используйте флаг замены, когда поверхность, идентичность или модель разрешения отличаются от Claude Code, например некодирующий агент в конвейере, который не смотрит ни один человек. Замена удаляет весь стандартный запрос, включая руководство по инструментам и инструкции безопасности, поэтому вы берете на себя ответственность за все, что вашей задаче все еще нужно.

149 149 

150Эти флаги применяются только к текущему вызову. Для постоянных персон, которые вы можете переключать и делиться между проектом, используйте [стили вывода](/ru/output-styles). Для соглашений проекта, которые Claude должен всегда соблюдать, используйте [CLAUDE.md](/ru/memory). [Руководство Agent SDK по системным приглашениям](/ru/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) охватывает то же решение более подробно.150Эти флаги применяются только к текущему вызову. Для постоянных персон, которые вы можете переключать и делиться между проектом, используйте [стили вывода](/docs/ru/output-styles). Для соглашений проекта, которые Claude должен всегда соблюдать, используйте [CLAUDE.md](/docs/ru/memory). [Руководство Agent SDK по системным приглашениям](/docs/ru/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) охватывает то же решение более подробно.

151 151 

152<h2 id="see-also">152<h2 id="see-also">

153 См. также153 См. также

154</h2>154</h2>

155 155 

156* [Расширение Chrome](/ru/chrome) - Веб-автоматизация и веб-тестирование156* [Расширение Chrome](/docs/ru/chrome) - Веб-автоматизация и веб-тестирование

157* [Интерактивный режим](/ru/interactive-mode) - Сочетания клавиш, режимы ввода и интерактивные функции157* [Интерактивный режим](/docs/ru/interactive-mode) - Сочетания клавиш, режимы ввода и интерактивные функции

158* [Руководство быстрого старта](/ru/quickstart) - Начало работы с Claude Code158* [Руководство быстрого старта](/docs/ru/quickstart) - Начало работы с Claude Code

159* [Общие рабочие процессы](/ru/common-workflows) - Продвинутые рабочие процессы и шаблоны159* [Общие рабочие процессы](/docs/ru/common-workflows) - Продвинутые рабочие процессы и шаблоны

160* [Параметры](/ru/settings) - Опции конфигурации160* [Параметры](/docs/ru/settings) - Опции конфигурации

161* [Документация Agent SDK](/ru/agent-sdk/overview) - Программное использование и интеграции161* [Документация Agent SDK](/docs/ru/agent-sdk/overview) - Программное использование и интеграции

code-review.md +14 −14

Details

7> Настройте автоматизированные проверки PR, которые выявляют логические ошибки, уязвимости безопасности и регрессии с помощью многоагентного анализа всей вашей кодовой базы7> Настройте автоматизированные проверки PR, которые выявляют логические ошибки, уязвимости безопасности и регрессии с помощью многоагентного анализа всей вашей кодовой базы

8 8 

9<Note>9<Note>

10 Code Review находится в исследовательском предпросмотре и доступен для подписок [Team и Enterprise](https://claude.ai/admin-settings/claude-code). Он недоступен для организаций с включённым [Zero Data Retention](/ru/zero-data-retention).10 Code Review находится в исследовательском предпросмотре и доступен для подписок [Team и Enterprise](https://claude.ai/admin-settings/claude-code). Он недоступен для организаций с включённым [Zero Data Retention](/docs/ru/zero-data-retention).

11</Note>11</Note>

12 12 

13Code Review анализирует ваши pull-запросы GitHub и публикует результаты в виде встроенных комментариев на строках кода, где были обнаружены проблемы. Группа специализированных агентов изучает изменения кода в контексте всей вашей кодовой базы, ища логические ошибки, уязвимости безопасности, нарушенные граничные случаи и тонкие регрессии.13Code Review анализирует ваши pull-запросы GitHub и публикует результаты в виде встроенных комментариев на строках кода, где были обнаружены проблемы. Группа специализированных агентов изучает изменения кода в контексте всей вашей кодовой базы, ища логические ошибки, уязвимости безопасности, нарушенные граничные случаи и тонкие регрессии.

14 14 

15Результаты помечаются по степени серьёзности и не одобряют и не блокируют ваш PR, поэтому существующие рабочие процессы проверки остаются неизменными. Вы можете настроить, что Claude помечает, добавив файл `CLAUDE.md` или `REVIEW.md` в ваш репозиторий.15Результаты помечаются по степени серьёзности и не одобряют и не блокируют ваш PR, поэтому существующие рабочие процессы проверки остаются неизменными. Вы можете настроить, что Claude помечает, добавив файл `CLAUDE.md` или `REVIEW.md` в ваш репозиторий.

16 16 

17Чтобы запустить Claude в собственной инфраструктуре CI вместо этого управляемого сервиса, см. [GitHub Actions](/ru/github-actions) или [GitLab CI/CD](/ru/gitlab-ci-cd). Для репозиториев на самостоятельно размещённом экземпляре GitHub см. [GitHub Enterprise Server](/ru/github-enterprise-server).17Чтобы запустить Claude в собственной инфраструктуре CI вместо этого управляемого сервиса, см. [GitHub Actions](/docs/ru/github-actions) или [GitLab CI/CD](/docs/ru/gitlab-ci-cd). Для репозиториев на самостоятельно размещённом экземпляре GitHub см. [GitHub Enterprise Server](/docs/ru/github-enterprise-server).

18 18 

19На этой странице рассматривается:19На этой странице рассматривается:

20 20 


112 * **Issues**: чтение и запись112 * **Issues**: чтение и запись

113 * **Pull requests**: чтение и запись113 * **Pull requests**: чтение и запись

114 114 

115 Code Review использует доступ на чтение содержимого и доступ на запись к pull-запросам. Более широкий набор разрешений также поддерживает [GitHub Actions](/ru/github-actions), если вы включите это позже.115 Code Review использует доступ на чтение содержимого и доступ на запись к pull-запросам. Более широкий набор разрешений также поддерживает [GitHub Actions](/docs/ru/github-actions), если вы включите это позже.

116 </Step>116 </Step>

117 117 

118 <Step title="Выберите репозитории">118 <Step title="Выберите репозитории">


173 173 

174Code Review читает файлы `CLAUDE.md` вашего репозитория и рассматривает вновь введённые нарушения как результаты [уровня nit](#severity-levels). Это работает двусторонне: если ваш PR изменяет код таким образом, что делает утверждение `CLAUDE.md` устаревшим, Claude помечает, что документы нужно обновить.174Code Review читает файлы `CLAUDE.md` вашего репозитория и рассматривает вновь введённые нарушения как результаты [уровня nit](#severity-levels). Это работает двусторонне: если ваш PR изменяет код таким образом, что делает утверждение `CLAUDE.md` устаревшим, Claude помечает, что документы нужно обновить.

175 175 

176Claude читает файлы `CLAUDE.md` на каждом уровне иерархии вашего каталога, поэтому правила в `CLAUDE.md` подкаталога применяются только к файлам под этим путём. Дополнительную информацию о том, как работает `CLAUDE.md`, см. в [документации памяти](/ru/memory).176Claude читает файлы `CLAUDE.md` на каждом уровне иерархии вашего каталога, поэтому правила в `CLAUDE.md` подкаталога применяются только к файлам под этим путём. Дополнительную информацию о том, как работает `CLAUDE.md`, см. в [документации памяти](/docs/ru/memory).

177 177 

178Для руководства, специфичного для проверок, которое вы не хотите применять к общим сеансам Claude Code, используйте [`REVIEW.md`](#review-md) вместо этого.178Для руководства, специфичного для проверок, которое вы не хотите применять к общим сеансам Claude Code, используйте [`REVIEW.md`](#review-md) вместо этого.

179 179 


183 183 

184`REVIEW.md` — это файл в корне вашего репозитория, который переопределяет поведение Code Review в вашем репо. Его содержимое внедряется в системный запрос каждого агента в конвейере проверки как блок инструкций с наивысшим приоритетом, имеющий приоритет над руководством проверки по умолчанию.184`REVIEW.md` — это файл в корне вашего репозитория, который переопределяет поведение Code Review в вашем репо. Его содержимое внедряется в системный запрос каждого агента в конвейере проверки как блок инструкций с наивысшим приоритетом, имеющий приоритет над руководством проверки по умолчанию.

185 185 

186Поскольку он вставляется дословно, `REVIEW.md` — это простые инструкции: синтаксис [`@` import](/ru/memory#import-additional-files) не расширяется, и на файлы не читаются в подсказку. Поместите правила, которые вы хотите применить, непосредственно в файл.186Поскольку он вставляется дословно, `REVIEW.md` — это простые инструкции: синтаксис [`@` import](/docs/ru/memory#import-additional-files) не расширяется, и на файлы не читаются в подсказку. Поместите правила, которые вы хотите применить, непосредственно в файл.

187 187 

188<h4 id="what-you-can-tune">188<h4 id="what-you-can-tune">

189 Что вы можете настроить189 Что вы можете настроить


315 Проверка diff локально315 Проверка diff локально

316</h2>316</h2>

317 317 

318Команда [`/code-review`](/ru/commands) проверяет diff в вашем терминале без установки GitHub App. Запустите её в любом сеансе Claude Code: она сообщает об ошибках корректности и {/* min-version: 2.1.151 */}переиспользовании, упрощении и очистке эффективности. По умолчанию локальная проверка охватывает коммиты вашей ветки, опережающие её upstream, плюс любые незафиксированные изменения в рабочем дереве. Передайте `--comment` для публикации результатов в виде встроенных комментариев PR или `--fix` для применения результатов к вашему рабочему дереву после проверки.318Команда [`/code-review`](/docs/ru/commands) проверяет diff в вашем терминале без установки GitHub App. Запустите её в любом сеансе Claude Code: она сообщает об ошибках корректности и переиспользовании, упрощении и очистке эффективности. По умолчанию локальная проверка охватывает коммиты вашей ветки, опережающие её upstream, плюс любые незафиксированные изменения в рабочем дереве. Передайте `--comment` для публикации результатов в виде встроенных комментариев PR или `--fix` для применения результатов к вашему рабочему дереву после проверки.

319 319 

320Более низкие [уровни усилий](/ru/model-config#adjust-effort-level) возвращают меньше, более уверенные результаты, в то время как `high` через `max` дают более широкое покрытие и могут включать неуверенные результаты. Без аргумента усилия проверка использует текущее усилие сеанса. Для проверки чего-либо другого, чем стандартный diff, передайте цель: путь к файлу, номер PR, имя ветки или диапазон ссылок, такой как `main...my-feature`. Форма диапазона ссылок проверяет зафиксированный diff, который содержал бы pull request из `my-feature` в `main`, независимо от того, как настроен upstream ветки.320Более низкие [уровни усилий](/docs/ru/model-config#adjust-effort-level) возвращают меньше, более уверенные результаты, в то время как `high` через `max` дают более широкое покрытие и могут включать неуверенные результаты. Без аргумента усилия проверка использует текущее усилие сеанса. Для проверки чего-либо другого, чем стандартный diff, передайте цель: путь к файлу, номер PR, имя ветки или диапазон ссылок, такой как `main...my-feature`. Форма диапазона ссылок проверяет зафиксированный diff, который содержал бы pull request из `my-feature` в `main`, независимо от того, как настроен upstream ветки.

321 321 

322`/code-review ultra --fix` запускает более глубокую [ultrareview](/ru/ultrareview) в облаке, затем применяет её результаты к вашему рабочему дереву, когда они возвращаются в ваш сеанс. Ultrareview использует свою собственную область: вашу текущую ветку против ветки по умолчанию репозитория, плюс любые незафиксированные и поставленные на сцену изменения в рабочем дереве.322`/code-review ultra --fix` запускает более глубокую [ultrareview](/docs/ru/ultrareview) в облаке, затем применяет её результаты к вашему рабочему дереву, когда они возвращаются в ваш сеанс. Ultrareview использует свою собственную область: вашу текущую ветку против ветки по умолчанию репозитория, плюс любые незафиксированные и поставленные на сцену изменения в рабочем дереве.

323 323 

324Команда называлась `/simplify` до версии v2.1.147, когда она применяла исправления по умолчанию. {/* min-version: 2.1.154 */}Начиная с версии v2.1.154, `/simplify` запускает отдельную проверку только для очистки, которая применяет исправления без поиска ошибок. Если вы использовали скрипт `/simplify` для поиска ошибок, переключитесь на `/code-review --fix`, который остался без изменений.324Команда называлась `/simplify` до версии v2.1.147, когда она применяла исправления по умолчанию. Начиная с версии v2.1.154, `/simplify` запускает отдельную проверку только для очистки, которая применяет исправления без поиска ошибок. Если вы использовали скрипт `/simplify` для поиска ошибок, переключитесь на `/code-review --fix`, который остался без изменений.

325 325 

326<h2 id="related-resources">326<h2 id="related-resources">

327 Связанные ресурсы327 Связанные ресурсы


329 329 

330Code Review разработан для работы вместе с остальной частью Claude Code. Если вы хотите запустить проверки локально перед открытием PR, вам нужна самостоятельно размещённая установка или вы хотите глубже разобраться в том, как `CLAUDE.md` формирует поведение Claude во всех инструментах, эти страницы — хорошие следующие остановки:330Code Review разработан для работы вместе с остальной частью Claude Code. Если вы хотите запустить проверки локально перед открытием PR, вам нужна самостоятельно размещённая установка или вы хотите глубже разобраться в том, как `CLAUDE.md` формирует поведение Claude во всех инструментах, эти страницы — хорошие следующие остановки:

331 331 

332* [Commands](/ru/commands): запустите `/code-review` в локальной сессии Claude Code, чтобы проверить diff перед push332* [Commands](/docs/ru/commands): запустите `/code-review` в локальной сессии Claude Code, чтобы проверить diff перед push

333* [GitHub Actions](/ru/github-actions): запустите Claude в ваших собственных рабочих процессах GitHub Actions для пользовательской автоматизации за пределами проверки кода333* [GitHub Actions](/docs/ru/github-actions): запустите Claude в ваших собственных рабочих процессах GitHub Actions для пользовательской автоматизации за пределами проверки кода

334* [GitLab CI/CD](/ru/gitlab-ci-cd): самостоятельно размещённая интеграция Claude для конвейеров GitLab334* [GitLab CI/CD](/docs/ru/gitlab-ci-cd): самостоятельно размещённая интеграция Claude для конвейеров GitLab

335* [Memory](/ru/memory): как работают файлы `CLAUDE.md` во всём Claude Code335* [Memory](/docs/ru/memory): как работают файлы `CLAUDE.md` во всём Claude Code

336* [Analytics](/ru/analytics): отслеживайте использование Claude Code за пределами проверки кода336* [Analytics](/docs/ru/analytics): отслеживайте использование Claude Code за пределами проверки кода

commands.md +85 −85

Details

10 10 

11Введите `/` для просмотра всех доступных вам команд или введите `/` с последующими буквами для фильтрации.11Введите `/` для просмотра всех доступных вам команд или введите `/` с последующими буквами для фильтрации.

12 12 

13Команда распознается только в начале вашего сообщения. Текст, который следует за названием команды, передается ей в качестве аргументов. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, [skills](/ru/skills#pass-arguments-to-skills) являются исключением: вызов skill, за которым следуют другие skills, такие как `/skill-a /skill-b do XYZ`, загружает каждый skill, указанный в начале, и передает завершающий текст каждому в качестве аргументов. Можно объединить до шести skills.13Команда распознается только в начале вашего сообщения. Текст, который следует за названием команды, передается ей в качестве аргументов. Начиная с версии 2.1.199, [skills](/docs/ru/skills#pass-arguments-to-skills) являются исключением: вызов skill, за которым следуют другие skills, такие как `/skill-a /skill-b do XYZ`, загружает каждый skill, указанный в начале, и передает завершающий текст каждому в качестве аргументов. Можно объединить до шести skills.

14 14 

15Если вы отправите команду, пока Claude отвечает, она встанет в очередь и выполнится после завершения текущего хода. Некоторые команды, такие как `/status`, `/tasks` и `/usage`, выполняются немедленно без прерывания ответа.15Если вы отправите команду, пока Claude отвечает, она встанет в очередь и выполнится после завершения текущего хода. Некоторые команды, такие как `/status`, `/tasks` и `/usage`, выполняются немедленно без прерывания ответа.

16 16 


20 20 

21Большинство команд полезны в определенной точке сеанса, от настройки проекта до отправки изменения.21Большинство команд полезны в определенной точке сеанса, от настройки проекта до отправки изменения.

22 22 

23**Первый сеанс в репозитории.** Запустите `/init` для создания стартового `CLAUDE.md`, затем `/memory` для его уточнения. Используйте `/mcp` для настройки любых серверов, которые нужны проекту, попросите Claude создать любых [subagents](/ru/sub-agents), которые вам нужны, и запустите `/permissions` для установки правил одобрения.23**Первый сеанс в репозитории.** Запустите `/init` для создания стартового `CLAUDE.md`, затем `/memory` для его уточнения. Используйте `/mcp` для настройки любых серверов, которые нужны проекту, попросите Claude создать любых [subagents](/docs/ru/sub-agents), которые вам нужны, и запустите `/permissions` для установки правил одобрения.

24 24 

25**Во время задачи.** `/plan` переключает в режим плана перед крупным изменением. `/model` и `/effort` регулируют, какую модель вы используете и сколько рассуждений она применяет. Когда беседа становится длинной, `/context` показывает, что заполняет окно, и `/compact` сжимает его для освобождения места. Используйте `/btw` для быстрого замечания, которое не должно добавляться в историю беседы.25**Во время задачи.** `/plan` переключает в режим плана перед крупным изменением. `/model` и `/effort` регулируют, какую модель вы используете и сколько рассуждений она применяет. Когда беседа становится длинной, `/context` показывает, что заполняет окно, и `/compact` сжимает его для освобождения места. Используйте `/btw` для быстрого замечания, которое не должно добавляться в историю беседы.

26 26 

27**Параллельное выполнение работы.** Claude делегирует побочные задачи [subagents](/ru/sub-agents), и `/tasks` выводит список того, что выполняется в фоне текущего сеанса, включая subagents, которые завершили работу. `/background` отделяет весь сеанс, чтобы он продолжал работать как [фоновый агент](/ru/agent-view), и освобождает ваш терминал. Для крупного изменения, охватывающего всю кодовую базу, `/batch` разбивает его на независимые единицы и запускает каждую в своем собственном [worktree](/ru/worktrees). Смотрите [Запуск агентов параллельно](/ru/agents), чтобы понять, как эти подходы связаны между собой.27**Параллельное выполнение работы.** Claude делегирует побочные задачи [subagents](/docs/ru/sub-agents), и `/tasks` выводит список того, что выполняется в фоне текущего сеанса, включая subagents, которые завершили работу. `/background` отделяет весь сеанс, чтобы он продолжал работать как [фоновый агент](/docs/ru/agent-view), и освобождает ваш терминал. Для крупного изменения, охватывающего всю кодовую базу, `/batch` разбивает его на независимые единицы и запускает каждую в своем собственном [worktree](/docs/ru/worktrees). Смотрите [Запуск агентов параллельно](/docs/ru/agents), чтобы понять, как эти подходы связаны между собой.

28 28 

29**Перед отправкой.** `/diff` показывает, что изменилось, `/code-review` проверяет diff на наличие ошибок корректности и очистки и может применить результаты с помощью `--fix`, `/review` запускает быструю однопроходную проверку только для чтения GitHub pull request, `/code-review <level> <pr#>` запускает многоагентный обзор одного, а `/security-review` проверяет diff на наличие уязвимостей безопасности. `/code-review ultra` запускает многоагентный обзор в облаке.29**Перед отправкой.** `/diff` показывает, что изменилось, `/code-review` проверяет diff на наличие ошибок корректности и очистки и может применить результаты с помощью `--fix`, `/review` запускает быструю однопроходную проверку только для чтения GitHub pull request, `/code-review <level> <pr#>` запускает многоагентный обзор одного, а `/security-review` проверяет diff на наличие уязвимостей безопасности. `/code-review ultra` запускает многоагентный обзор в облаке.

30 30 


38 38 

39В таблице ниже перечислены все команды, включенные в Claude Code. Большинство из них — встроенные команды, поведение которых закодировано в CLI. Отмечены два вида записей:39В таблице ниже перечислены все команды, включенные в Claude Code. Большинство из них — встроенные команды, поведение которых закодировано в CLI. Отмечены два вида записей:

40 40 

41* **[Skill](/ru/skills#bundled-skills)**: встроенный skill. Он работает как skills, которые вы пишете сами: подсказка, переданная Claude, которую Claude также может автоматически вызывать при необходимости.41* **[Skill](/docs/ru/skills#bundled-skills)**: встроенный skill. Он работает как skills, которые вы пишете сами: подсказка, переданная Claude, которую Claude также может автоматически вызывать при необходимости.

42* **[Workflow](/ru/workflows#bundled-workflows)**: встроенный [динамический workflow](/ru/workflows), который распределяет работу между множеством подагентов и выполняется в фоновом режиме.42* **[Workflow](/docs/ru/workflows#bundled-workflows)**: встроенный [динамический workflow](/docs/ru/workflows), который распределяет работу между множеством подагентов и выполняется в фоновом режиме.

43 43 

44Чтобы добавить свои собственные команды, см. [skills](/ru/skills).44Чтобы добавить свои собственные команды, см. [skills](/docs/ru/skills).

45 45 

46В таблице ниже `<arg>` указывает на обязательный аргумент, а `[arg]` указывает на необязательный.46В таблице ниже `<arg>` указывает на обязательный аргумент, а `[arg]` указывает на необязательный.

47 47 


50</Note>50</Note>

51 51 

52| Команда | Назначение |52| Команда | Назначение |

53| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |53| :--------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

54| `/add-dir <path>` | Добавить рабочий каталог для доступа к файлам во время текущего сеанса. Введение частичного пути показывает предложения соответствующих каталогов; нажмите `Tab` для принятия одного. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из добавленного каталога. Вы можете позже возобновить сеанс из добавленного каталога с помощью `--continue` или `--resume` |54| `/add-dir <path>` | Добавить рабочий каталог для доступа к файлам во время текущего сеанса. Введение частичного пути показывает предложения соответствующих каталогов; нажмите `Tab` для принятия одного. Большинство конфигурации `.claude/` [не обнаруживается](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) из добавленного каталога. Вы можете позже возобновить сеанс из добавленного каталога с помощью `--continue` или `--resume` |

55| `/advisor [model\|off]` | Включить или отключить [инструмент advisor](/ru/advisor), который консультирует вторую модель для получения рекомендаций в ключевые моменты во время задачи. Принимает `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+) или полный ID модели. Без аргумента открывает выбор |55| `/advisor [model\|off]` | Включить или отключить [инструмент advisor](/docs/ru/advisor), который консультирует вторую модель для получения рекомендаций в ключевые моменты во время задачи. Принимает `opus`, `sonnet`, `fable` (v2.1.170+) или полный ID модели. Без аргумента открывает выбор |

56| `/agents` | {/* min-version: 2.1.198 */}Начиная с v2.1.198, запуск `/agents` выводит напоминание попросить Claude создать или управлять [подагентами](/ru/sub-agents) или отредактировать `.claude/agents/` или `~/.claude/agents/` напрямую. {/* max-version: 2.1.197 */}На v2.1.197 и более ранних версиях открывает интерактивный интерфейс для создания и управления конфигурациями подагентов |56| `/agents` | Начиная с v2.1.198, запуск `/agents` выводит напоминание попросить Claude создать или управлять [подагентами](/docs/ru/sub-agents) или отредактировать `.claude/agents/` или `~/.claude/agents/` напрямую. На v2.1.197 и более ранних версиях открывает интерактивный интерфейс для создания и управления конфигурациями подагентов |

57| `/autofix-pr [prompt]` | Запустить сеанс [Claude Code в веб-браузере](/ru/claude-code-on-the-web#auto-fix-pull-requests), который отслеживает PR текущей ветви и отправляет исправления при сбое CI или комментариях рецензентов. Обнаруживает открытый PR из вашей текущей ветви с помощью `gh pr view`; чтобы отслеживать другой PR, сначала переключитесь на его ветвь. По умолчанию удаленному сеансу указывается исправить каждый сбой CI и комментарий рецензента; передайте подсказку, чтобы дать ему другие инструкции, например `/autofix-pr only fix lint and type errors`. Требует CLI `gh` и доступ к [Claude Code в веб-браузере](/ru/claude-code-on-the-web) |57| `/autofix-pr [prompt]` | Запустить сеанс [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web#auto-fix-pull-requests), который отслеживает PR текущей ветви и отправляет исправления при сбое CI или комментариях рецензентов. Обнаруживает открытый PR из вашей текущей ветви с помощью `gh pr view`; чтобы отслеживать другой PR, сначала переключитесь на его ветвь. По умолчанию удаленному сеансу указывается исправить каждый сбой CI и комментарий рецензента; передайте подсказку, чтобы дать ему другие инструкции, например `/autofix-pr only fix lint and type errors`. Требует CLI `gh` и доступ к [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web) |

58| `/background [prompt]` | Отсоединить текущий сеанс для запуска в качестве [фонового агента](/ru/agent-view) и освободить этот терминал. Передайте подсказку для отправки еще одной инструкции перед отсоединением. Отслеживайте сеанс с помощью `claude agents`. Псевдоним: `/bg` |58| `/background [prompt]` | Отсоединить текущий сеанс для запуска в качестве [фонового агента](/docs/ru/agent-view) и освободить этот терминал. Передайте подсказку для отправки еще одной инструкции перед отсоединением. Отслеживайте сеанс с помощью `claude agents`. Псевдоним: `/bg` |

59| `/batch <instruction>` | **[Skill](/ru/skills#bundled-skills).** Организовать крупномасштабные изменения в кодовой базе параллельно. Исследует кодовую базу, разбивает работу на 5-30 независимых единиц и представляет план. После одобрения запускает одного [фонового subagent](/ru/sub-agents#run-subagents-in-foreground-or-background) на единицу в изолированном [git worktree](/ru/worktrees). Каждый subagent реализует свою единицу, запускает тесты и открывает pull request. Требует git репозиторий. Пример: `/batch migrate src/ from Solid to React` |59| `/batch <instruction>` | **[Skill](/docs/ru/skills#bundled-skills).** Организовать крупномасштабные изменения в кодовой базе параллельно. Исследует кодовую базу, разбивает работу на 5-30 независимых единиц и представляет план. После одобрения запускает одного [фонового subagent](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) на единицу в изолированном [git worktree](/docs/ru/worktrees). Каждый subagent реализует свою единицу, запускает тесты и открывает pull request. Требует git репозиторий. Пример: `/batch migrate src/ from Solid to React` |

60| `/branch [name]` | Создать ветвь текущей беседы в этой точке, чтобы вы могли попробовать другое направление без потери беседы в том виде, в котором она стоит. Переключает вас в ветвь и сохраняет оригинал, к которому вы можете вернуться с помощью `/resume`. Чтобы передать побочную задачу фоновому subagent вместо переключения в копию самостоятельно, используйте `/fork` |60| `/branch [name]` | Создать ветвь текущей беседы в этой точке, чтобы вы могли попробовать другое направление без потери беседы в том виде, в котором она стоит. Переключает вас в ветвь и сохраняет оригинал, к которому вы можете вернуться с помощью `/resume`. Чтобы передать побочную задачу фоновому subagent вместо переключения в копию самостоятельно, используйте `/fork` |

61| `/btw <question>` | Задать быстрый [побочный вопрос](/ru/interactive-mode#side-questions-with-%2Fbtw) без добавления в беседу |61| `/btw <question>` | Задать быстрый [побочный вопрос](/docs/ru/interactive-mode#side-questions-with-%2Fbtw) без добавления в беседу |

62| `/cd <path>` | {/* min-version: 2.1.169 */}Переместить этот сеанс в новый рабочий каталог. Кэш подсказок беседы сохраняется: [`CLAUDE.md`](/ru/memory) нового каталога добавляется как сообщение вместо перестроения системной подсказки. Сеанс перемещается в хранилище проекта нового каталога, поэтому `--resume` и `--continue` находят его оттуда. Запрашивает вас доверять каталогу, если вы в нем раньше не работали. {/* min-version: 2.1.206 */}Введение частичного пути показывает предложения соответствующих каталогов; нажмите `Tab` для принятия одного. Предложения требуют Claude Code v2.1.206 или позже. Чтобы предоставить доступ к дополнительному каталогу без перемещения сеанса, используйте `/add-dir`. Ограничьте или отключите целевые объекты `/cd` с помощью [правил разрешения `Cd`](/ru/permissions#cd). Требует Claude Code v2.1.169 или позже; более ранние версии сообщают `Unknown command: /cd` |62| `/cd <path>` | Переместить этот сеанс в новый рабочий каталог. Кэш подсказок беседы сохраняется: [`CLAUDE.md`](/docs/ru/memory) нового каталога добавляется как сообщение вместо перестроения системной подсказки. Сеанс перемещается в хранилище проекта нового каталога, поэтому `--resume` и `--continue` находят его оттуда. Запрашивает вас доверять каталогу, если вы в нем раньше не работали. Введение частичного пути показывает предложения соответствующих каталогов; нажмите `Tab` для принятия одного. Предложения требуют Claude Code v2.1.206 или позже. Чтобы предоставить доступ к дополнительному каталогу без перемещения сеанса, используйте `/add-dir`. Ограничьте или отключите целевые объекты `/cd` с помощью [правил разрешения `Cd`](/docs/ru/permissions#cd). Требует Claude Code v2.1.169 или позже; более ранние версии сообщают `Unknown command: /cd` |

63| `/chrome` | Настроить параметры [Claude в Chrome](/ru/chrome) |63| `/chrome` | Настроить параметры [Claude в Chrome](/docs/ru/chrome) |

64| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/ru/skills#bundled-skills).** Загрузить справочный материал Claude API для языка вашего проекта (Python, TypeScript, Java, Go, Ruby, C#, PHP или cURL) и справочник Managed Agents. Охватывает использование инструментов, потоковую передачу, пакеты, структурированные выходы и распространенные ошибки. Также активируется автоматически, когда ваш код импортирует `anthropic` или `@anthropic-ai/sdk`. Запустите `/claude-api migrate` для обновления существующего кода Claude API на более новую модель: Claude спрашивает, какие файлы сканировать и какую модель выбрать, затем обновляет ID моделей, конфигурацию thinking и другие параметры, которые изменились между версиями. Запустите `/claude-api managed-agents-onboard` для интерактивного пошагового руководства, которое создает новый Managed Agent с нуля |64| `/claude-api [migrate\|managed-agents-onboard]` | **[Skill](/docs/ru/skills#bundled-skills).** Загрузить справочный материал Claude API для языка вашего проекта (Python, TypeScript, Java, Go, Ruby, C#, PHP или cURL) и справочник Managed Agents. Охватывает использование инструментов, потоковую передачу, пакеты, структурированные выходы и распространенные ошибки. Также активируется автоматически, когда ваш код импортирует `anthropic` или `@anthropic-ai/sdk`. Запустите `/claude-api migrate` для обновления существующего кода Claude API на более новую модель: Claude спрашивает, какие файлы сканировать и какую модель выбрать, затем обновляет ID моделей, конфигурацию thinking и другие параметры, которые изменились между версиями. Запустите `/claude-api managed-agents-onboard` для интерактивного пошагового руководства, которое создает новый Managed Agent с нуля |

65| `/clear [name]` | Начать новую беседу с пустым контекстом. Передайте имя для обозначения предыдущей беседы в выборщике `/resume`. Чтобы освободить контекст при продолжении той же беседы, используйте `/compact` вместо этого. Возобновите предыдущую беседу с помощью `/resume`, или, в том же процессе Claude Code, {/* min-version: 2.1.191 */}восстановите ее из [записи предыдущего сеанса меню перемотки](/ru/checkpointing#rewind-past-a-cleared-conversation). Псевдонимы: `/reset`, `/new` |65| `/clear [name]` | Начать новую беседу с пустым контекстом. Передайте имя для обозначения предыдущей беседы в выборщике `/resume`. Чтобы освободить контекст при продолжении той же беседы, используйте `/compact` вместо этого. Возобновите предыдущую беседу с помощью `/resume`, или, в том же процессе Claude Code, восстановите ее из [записи предыдущего сеанса меню перемотки](/docs/ru/checkpointing#rewind-past-a-cleared-conversation). Псевдонимы: `/reset`, `/new` |

66| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/ru/skills#bundled-skills).** Просмотреть текущий diff на предмет ошибок корректности и предложить улучшения по переиспользованию, упрощению и эффективности. Передайте `--fix` для применения результатов к вашему рабочему дереву, `--comment` для публикации их как встроенных комментариев GitHub PR, или `ultra` для запуска глубокого [облачного просмотра](/ru/ultrareview). {/* min-version: 2.1.154 */}Начиная с v2.1.154, `/simplify` запускает отдельный просмотр только для очистки, который применяет исправления без поиска ошибок. См. [Просмотр diff локально](/ru/code-review#review-a-diff-locally) для уровней усилий и целей |66| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/docs/ru/skills#bundled-skills).** Просмотреть текущий diff на предмет ошибок корректности и предложить улучшения по переиспользованию, упрощению и эффективности. Передайте `--fix` для применения результатов к вашему рабочему дереву, `--comment` для публикации их как встроенных комментариев GitHub PR, или `ultra` для запуска глубокого [облачного просмотра](/docs/ru/ultrareview). Начиная с v2.1.154, `/simplify` запускает отдельный просмотр только для очистки, который применяет исправления без поиска ошибок. См. [Просмотр diff локально](/docs/ru/code-review#review-a-diff-locally) для уровней усилий и целей |

67| `/color [color\|default]` | Установить цвет строки приглашения для текущего сеанса. Доступные цвета: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Используйте `default` для сброса, или запустите без аргумента для выбора случайного цвета. Когда подключен [Remote Control](/ru/remote-control), цвет синхронизируется с claude.ai/code. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`); требует Claude Code v2.1.205 или позже |67| `/color [color\|default]` | Установить цвет строки приглашения для текущего сеанса. Доступные цвета: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Используйте `default` для сброса, или запустите без аргумента для выбора случайного цвета. Когда подключен [Remote Control](/docs/ru/remote-control), цвет синхронизируется с claude.ai/code. Также доступно в неинтерактивном режиме (`-p`); требует Claude Code v2.1.205 или позже |

68| `/compact [instructions]` | Освободить контекст путем суммирования беседы до сих пор. Опционально передайте инструкции фокуса для сводки. См. [как сжатие обрабатывает правила, skills и файлы памяти](/ru/context-window#what-survives-compaction) |68| `/compact [instructions]` | Освободить контекст путем суммирования беседы до сих пор. Опционально передайте инструкции фокуса для сводки. См. [как сжатие обрабатывает правила, skills и файлы памяти](/docs/ru/context-window#what-survives-compaction) |

69| `/config [key=value ...]` | Открыть интерфейс [Параметры](/ru/settings) для настройки темы, модели, [стиля вывода](/ru/output-styles) и других предпочтений. {/* min-version: 2.1.181 */}Начиная с v2.1.181, передайте одну или несколько пар `key=value` для установки параметра непосредственно без открытия интерфейса, например `/config thinking=false`. {/* min-version: 2.1.182 */}Начиная с v2.1.182, также принимаются именованные сокращенные ключи, такие как `/config theme=dark` или `/config model=sonnet`. Форма `key=value` также работает в неинтерактивном режиме (`-p`) и из приложения Claude mobile через [Remote Control](/ru/remote-control). Запустите `/config --help` для списка каждого устанавливаемого ключа с его опциями. Псевдоним: `/settings` |69| `/config [key=value ...]` | Открыть интерфейс [Параметры](/docs/ru/settings) для настройки темы, модели, [стиля вывода](/docs/ru/output-styles) и других предпочтений. Начиная с v2.1.181, передайте одну или несколько пар `key=value` для установки параметра непосредственно без открытия интерфейса, например `/config thinking=false`. Начиная с v2.1.182, также принимаются именованные сокращенные ключи, такие как `/config theme=dark` или `/config model=sonnet`. Форма `key=value` также работает в неинтерактивном режиме (`-p`) и из приложения Claude mobile через [Remote Control](/docs/ru/remote-control). Запустите `/config --help` для списка каждого устанавливаемого ключа с его опциями. Псевдоним: `/settings` |

70| `/context [all]` | Визуализировать текущее использование контекста в виде цветной сетки. Показывает предложения по оптимизации для инструментов, требующих много контекста, утечек памяти и предупреждений о емкости. В [полноэкранном режиме](/ru/fullscreen) разбивка по элементам свернута, чтобы сетка оставалась видимой. Передайте `all` для развертывания |70| `/context [all]` | Визуализировать текущее использование контекста в виде цветной сетки. Показывает предложения по оптимизации для инструментов, требующих много контекста, утечек памяти и предупреждений о емкости. В [полноэкранном режиме](/docs/ru/fullscreen) разбивка по элементам свернута, чтобы сетка оставалась видимой. Передайте `all` для развертывания |

71| `/copy [N]` | Скопировать последний ответ ассистента в буфер обмена. Передайте число `N` для копирования N-го последнего ответа: `/copy 2` копирует второй с конца. Когда присутствуют блоки кода, показывает интерактивный выбор для выбора отдельных блоков или полного ответа. Нажмите `w` в выборщике для записи выделения в файл вместо буфера обмена, что полезно при работе через SSH |71| `/copy [N]` | Скопировать последний ответ ассистента в буфер обмена. Передайте число `N` для копирования N-го последнего ответа: `/copy 2` копирует второй с конца. Когда присутствуют блоки кода, показывает интерактивный выбор для выбора отдельных блоков или полного ответа. Нажмите `w` в выборщике для записи выделения в файл вместо буфера обмена, что полезно при работе через SSH |

72| `/cost` | Псевдоним для `/usage` |72| `/cost` | Псевдоним для `/usage` |

73| `/dataviz [request]` | **[Skill](/ru/skills#bundled-skills).** Рекомендации по дизайну для диаграмм, графиков и панелей управления. Claude выбирает форму диаграммы для данных, назначает цвет по роли, проверяет палитру на безопасность для дальтоников и контрастность с помощью встроенного скрипта и применяет правила отметок, взаимодействия и доступности. Использует нейтральную по отношению к бренду палитру-заполнитель, которую вы заменяете своей собственной. {/* min-version: 2.1.198 */}Требует Claude Code v2.1.198 или позже |73| `/dataviz [request]` | **[Skill](/docs/ru/skills#bundled-skills).** Рекомендации по дизайну для диаграмм, графиков и панелей управления. Claude выбирает форму диаграммы для данных, назначает цвет по роли, проверяет палитру на безопасность для дальтоников и контрастность с помощью встроенного скрипта и применяет правила отметок, взаимодействия и доступности. Использует нейтральную по отношению к бренду палитру-заполнитель, которую вы заменяете своей собственной. Требует Claude Code v2.1.198 или позже |

74| `/debug [description]` | **[Skill](/ru/skills#bundled-skills).** Включить отладочное логирование для текущего сеанса и устранить проблемы путем чтения журнала отладки сеанса. Отладочное логирование отключено по умолчанию, если вы не запустили с `claude --debug`, поэтому запуск `/debug` в середине сеанса начинает захватывать логи с этого момента. Опционально опишите проблему, чтобы сосредоточить анализ |74| `/debug [description]` | **[Skill](/docs/ru/skills#bundled-skills).** Включить отладочное логирование для текущего сеанса и устранить проблемы путем чтения журнала отладки сеанса. Отладочное логирование отключено по умолчанию, если вы не запустили с `claude --debug`, поэтому запуск `/debug` в середине сеанса начинает захватывать логи с этого момента. Опционально опишите проблему, чтобы сосредоточить анализ |

75| `/deep-research <question>` | **[Workflow](/ru/workflows#bundled-workflows).** Распределить веб-поиски по вопросу, получить и перекрестно проверить источники и синтезировать цитируемый отчет |75| `/deep-research <question>` | **[Workflow](/docs/ru/workflows#bundled-workflows).** Распределить веб-поиски по вопросу, получить и перекрестно проверить источники и синтезировать цитируемый отчет |

76| `/design-login` | Авторизовать доступ к системе дизайна для `/design-sync` с вашей учетной записью claude.ai |76| `/design-login` | Авторизовать доступ к системе дизайна для `/design-sync` с вашей учетной записью claude.ai |

77| `/design-sync [hint]` | **[Skill](/ru/skills#bundled-skills).** Преобразовать систему дизайна React вашего репозитория и загрузить ее в [Claude Design](https://claude.ai/design), чтобы создаваемые ею дизайны использовали ваши реальные компоненты. Опционально назовите систему дизайна, например `/design-sync Acme DS`. Первоначальная синхронизация проверяет каждый компонент и может занять несколько часов на большом репозитории. Доступно на Anthropic API; на Amazon Bedrock, платформе Google Cloud Agent Platform, Microsoft Foundry и Claude Platform на AWS базовый инструмент не может достичь claude.ai, поэтому команда недоступна |77| `/design-sync [hint]` | **[Skill](/docs/ru/skills#bundled-skills).** Преобразовать систему дизайна React вашего репозитория и загрузить ее в [Claude Design](https://claude.ai/design), чтобы создаваемые ею дизайны использовали ваши реальные компоненты. Опционально назовите систему дизайна, например `/design-sync Acme DS`. Первоначальная синхронизация проверяет каждый компонент и может занять несколько часов на большом репозитории. Доступно на Anthropic API; на Amazon Bedrock, платформе Google Cloud Agent Platform, Microsoft Foundry и Claude Platform на AWS базовый инструмент не может достичь claude.ai, поэтому команда недоступна |

78| `/desktop` | Продолжить текущий сеанс в приложении Claude Code Desktop. Требует macOS или Windows и подписку Claude. Псевдоним: `/app` |78| `/desktop` | Продолжить текущий сеанс в приложении Claude Code Desktop. Требует macOS или Windows и подписку Claude. Псевдоним: `/app` |

79| `/diff` | Открыть интерактивное средство просмотра различий, показывающее незафиксированные изменения и различия для каждого хода. Используйте стрелки влево/вправо для переключения между текущим git diff и отдельными ходами Claude, а вверх/вниз для просмотра файлов. Нажмите Enter для открытия diff выбранного файла, прокрутите его с помощью вверх/вниз или PageUp/PageDown и нажмите Esc для возврата к списку файлов. {/* min-version: 2.1.198 */}Начиная с v2.1.198, открытое средство просмотра также автоматически обновляется при изменении состояния git репозитория вне сеанса, например при переключении ветви или коммите в другом терминале |79| `/diff` | Открыть интерактивное средство просмотра различий, показывающее незафиксированные изменения и различия для каждого хода. Используйте стрелки влево/вправо для переключения между текущим git diff и отдельными ходами Claude, а вверх/вниз для просмотра файлов. Нажмите Enter для открытия diff выбранного файла, прокрутите его с помощью вверх/вниз или PageUp/PageDown и нажмите Esc для возврата к списку файлов. Начиная с v2.1.198, открытое средство просмотра также автоматически обновляется при изменении состояния git репозитория вне сеанса, например при переключении ветви или коммите в другом терминале |

80| `/doctor` | **[Skill](/ru/skills#bundled-skills).** Запустить проверку настройки, которая диагностирует проблемы и может их исправить. Проверяет здоровье установки, включая дублирующиеся или оставшиеся установки, проблемы с `PATH` и непарсируемые файлы параметров. Находит неиспользуемые skills, MCP серверы и plugins в сравнении с их стоимостью контекста, отмечает медленные [hooks](/ru/hooks) и проверяет наличие более новой версии на вашем канале выпуска. Дедублирует локальные файлы `CLAUDE.md` в сравнении с зафиксированными, обрезает зафиксированные файлы [`CLAUDE.md`](/ru/memory) путем удаления контента, который Claude может вывести из кодовой базы, и переносит всегда загруженное руководство, которое остается, в [skills](/ru/skills) и вложенные файлы `CLAUDE.md`, которые загружаются по требованию. Обрезание удаляет разделы, такие как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет ошибки, обоснование и соглашения, которые отличаются от стандартных инструментов. Также предлагает сделать [автоматический режим](/ru/permissions#permission-modes) вашим значением по умолчанию и [предварительно одобрить](/ru/permissions) часто отклоняемые команды только для чтения. Сообщает результаты в первую очередь и запрашивает подтверждение перед изменением чего-либо. Из терминала `claude doctor` выводит диагностику установки только для чтения без запуска сеанса. Псевдоним: `/checkup`. {/* min-version: 2.1.206 */}Проверка обрезания `CLAUDE.md` требует Claude Code v2.1.206 или позже. До v2.1.206, проверка версии сравнивала установки Homebrew с параметром `autoUpdatesChannel` вместо [канала установленного cask](/ru/setup#configure-release-channel). {/* min-version: 2.1.205 */}До v2.1.205, `/doctor` открывал экран диагностики только для чтения и нажатие `f` отправляло отчет Claude |80| `/doctor` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить проверку настройки, которая диагностирует проблемы и может их исправить. Проверяет здоровье установки, включая дублирующиеся или оставшиеся установки, проблемы с `PATH` и непарсируемые файлы параметров. Находит неиспользуемые skills, MCP серверы и plugins в сравнении с их стоимостью контекста, отмечает медленные [hooks](/docs/ru/hooks) и проверяет наличие более новой версии на вашем канале выпуска. Дедублирует локальные файлы `CLAUDE.md` в сравнении с зафиксированными, обрезает зафиксированные файлы [`CLAUDE.md`](/docs/ru/memory) путем удаления контента, который Claude может вывести из кодовой базы, и переносит всегда загруженное руководство, которое остается, в [skills](/docs/ru/skills) и вложенные файлы `CLAUDE.md`, которые загружаются по требованию. Обрезание удаляет разделы, такие как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет ошибки, обоснование и соглашения, которые отличаются от стандартных инструментов. Также предлагает сделать [автоматический режим](/docs/ru/permissions#permission-modes) вашим значением по умолчанию и [предварительно одобрить](/docs/ru/permissions) часто отклоняемые команды только для чтения. Сообщает результаты в первую очередь и запрашивает подтверждение перед изменением чего-либо. Из терминала `claude doctor` выводит диагностику установки только для чтения без запуска сеанса. Псевдоним: `/checkup`. Проверка обрезания `CLAUDE.md` требует Claude Code v2.1.206 или позже. До v2.1.206, проверка версии сравнивала установки Homebrew с параметром `autoUpdatesChannel` вместо [канала установленного cask](/docs/ru/setup#configure-release-channel). До v2.1.205, `/doctor` открывал экран диагностики только для чтения и нажатие `f` отправляло отчет Claude |

81| `/effort [level\|auto]` | Установить [уровень усилий](/ru/model-config#adjust-effort-level) модели. Принимает `low`, `medium`, `high`, `xhigh`, `max` или `ultracode`; доступные уровни зависят от модели, и `max` и `ultracode` применяются только к сеансу. `ultracode` — это параметр Claude Code, который объединяет `xhigh` reasoning с автоматической [workflow](/ru/workflows#let-claude-decide-with-ultracode) оркестрацией. `auto` сбрасывает значение по умолчанию модели. Без аргумента открывает интерактивный ползунок; используйте стрелки влево и вправо для выбора уровня и `Enter` для применения. Вступает в силу немедленно без ожидания завершения текущего ответа. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`) с аргументом уровня, где оно применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию; требует Claude Code v2.1.205 или позже. На Fable 5, Opus 4.8 и Opus 4.7, неинтерактивный `/effort` сообщает `Not applied`, пока действует [удержание усилий по умолчанию модели](/ru/model-config#adjust-effort-level), поэтому вместо этого передайте `--effort` при запуске |81| `/effort [level\|auto]` | Установить [уровень усилий](/docs/ru/model-config#adjust-effort-level) модели. Принимает `low`, `medium`, `high`, `xhigh`, `max` или `ultracode`; доступные уровни зависят от модели, и `max` и `ultracode` применяются только к сеансу. `ultracode` — это параметр Claude Code, который объединяет `xhigh` reasoning с автоматической [workflow](/docs/ru/workflows#let-claude-decide-with-ultracode) оркестрацией. `auto` сбрасывает значение по умолчанию модели. Без аргумента открывает интерактивный ползунок; используйте стрелки влево и вправо для выбора уровня и `Enter` для применения. Вступает в силу немедленно без ожидания завершения текущего ответа. Также доступно в неинтерактивном режиме (`-p`) с аргументом уровня, где оно применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию; требует Claude Code v2.1.205 или позже. На Fable 5, Opus 4.8 и Opus 4.7, неинтерактивный `/effort` сообщает `Not applied`, пока действует [удержание усилий по умолчанию модели](/docs/ru/model-config#adjust-effort-level), поэтому вместо этого передайте `--effort` при запуске |

82| `/exit` | Выход из CLI. В подключенном [фоновом сеансе](/ru/agent-view#attach-to-a-session) это отсоединяет и сеанс продолжает работать. Псевдоним: `/quit` |82| `/exit` | Выход из CLI. В подключенном [фоновом сеансе](/docs/ru/agent-view#attach-to-a-session) это отсоединяет и сеанс продолжает работать. Псевдоним: `/quit` |

83| `/export [filename]` | Экспортировать текущую беседу как простой текст. С именем файла записывает непосредственно в этот файл. Без имени открывает диалог для копирования в буфер обмена или сохранения в файл |83| `/export [filename]` | Экспортировать текущую беседу как простой текст. С именем файла записывает непосредственно в этот файл. Без имени открывает диалог для копирования в буфер обмена или сохранения в файл |

84| `/fast [on\|off]` | Переключить [быстрый режим](/ru/fast-mode) включен или выключен. {/* min-version: 2.1.205 */}В неинтерактивном режиме (`-p`), `/fast` работает только в сеансе, запущенном с быстрым режимом в его значении [`--settings`](/ru/cli-reference#cli-flags), например `claude -p --settings '{"fastMode": true}'`; переключение затем применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию, и в любом другом неинтерактивном сеансе команда сообщает, что быстрый режим недоступен. Требует Claude Code v2.1.205 или позже |84| `/fast [on\|off]` | Переключить [быстрый режим](/docs/ru/fast-mode) включен или выключен. В неинтерактивном режиме (`-p`), `/fast` работает только в сеансе, запущенном с быстрым режимом в его значении [`--settings`](/docs/ru/cli-reference#cli-flags), например `claude -p --settings '{"fastMode": true}'`; переключение затем применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию, и в любом другом неинтерактивном сеансе команда сообщает, что быстрый режим недоступен. Требует Claude Code v2.1.205 или позже |

85| `/feedback [report]` | Отправить отзыв, сообщить об ошибке или поделиться вашей беседой. Отправка в Anthropic требует [аутентификацию](/ru/authentication). Псевдонимы: `/bug`, `/share` |85| `/feedback [report]` | Отправить отзыв, сообщить об ошибке или поделиться вашей беседой. Отправка в Anthropic требует [аутентификацию](/docs/ru/authentication). Псевдонимы: `/bug`, `/share` |

86| `/fewer-permission-prompts` | **[Skill](/ru/skills#bundled-skills).** Сканировать ваши стенограммы на предмет распространенных вызовов инструментов Bash и MCP только для чтения, затем добавить приоритизированный список разрешений в проект `.claude/settings.json` для уменьшения запросов разрешений |86| `/fewer-permission-prompts` | **[Skill](/docs/ru/skills#bundled-skills).** Сканировать ваши стенограммы на предмет распространенных вызовов инструментов Bash и MCP только для чтения, затем добавить приоритизированный список разрешений в проект `.claude/settings.json` для уменьшения запросов разрешений |

87| `/focus` | Переключить представление фокуса, которое показывает только ваше последнее приглашение, однострочную сводку вызова инструмента с редактированием diffstats и финальный ответ. {/* min-version: 2.1.198 */}Начиная с v2.1.198, сводка вызова инструмента также подсчитывает запущенные в ходе подагенты и сворачивает завершенные уведомления фоновых задач в один счет. Выбор сохраняется между сеансами; установите [`viewMode`](/ru/settings#available-settings) в параметрах для переопределения. Доступно только в [полноэкранном рендеринге](/ru/fullscreen) |87| `/focus` | Переключить представление фокуса, которое показывает только ваше последнее приглашение, однострочную сводку вызова инструмента с редактированием diffstats и финальный ответ. Начиная с v2.1.198, сводка вызова инструмента также подсчитывает запущенные в ходе подагенты и сворачивает завершенные уведомления фоновых задач в один счет. Выбор сохраняется между сеансами; установите [`viewMode`](/docs/ru/settings#available-settings) в параметрах для переопределения. Доступно только в [полноэкранном рендеринге](/docs/ru/fullscreen) |

88| `/fork <directive>` | {/* min-version: 2.1.161 */}Запустить [разветвленного subagent](/ru/sub-agents#fork-the-current-conversation): фонового subagent, который наследует полную беседу и работает над директивой, пока вы продолжаете. Его результат возвращается в вашу беседу, когда он завершится. Чтобы переключиться в копию беседы самостоятельно, используйте `/branch`. До v2.1.161, `/fork` является псевдонимом для `/branch` |88| `/fork <directive>` | Запустить [разветвленного subagent](/docs/ru/sub-agents#fork-the-current-conversation): фонового subagent, который наследует полную беседу и работает над директивой, пока вы продолжаете. Его результат возвращается в вашу беседу, когда он завершится. Чтобы переключиться в копию беседы самостоятельно, используйте `/branch`. До v2.1.161, `/fork` является псевдонимом для `/branch` |

89| `/goal [condition\|clear]` | Установить [цель](/ru/goal): Claude продолжает работать между ходами до выполнения условия. Без аргумента показывает текущую или последнюю достигнутую цель. `clear`, `stop`, `off`, `reset`, `none` или `cancel` удаляет активную цель раньше |89| `/goal [condition\|clear]` | Установить [цель](/docs/ru/goal): Claude продолжает работать между ходами до выполнения условия. Без аргумента показывает текущую или последнюю достигнутую цель. `clear`, `stop`, `off`, `reset`, `none` или `cancel` удаляет активную цель раньше |

90| `/heapdump` | Записать снимок кучи JavaScript и разбивку памяти в `~/Desktop`, или в домашний каталог на Linux без папки Desktop, для диагностики высокого использования памяти. Файл `.heapsnapshot` содержит ваш полный разговор и учётные данные, поэтому не делитесь им. См. [устранение неполадок](/ru/troubleshooting#high-cpu-or-memory-usage) |90| `/heapdump` | Записать снимок кучи JavaScript и разбивку памяти в `~/Desktop`, или в домашний каталог на Linux без папки Desktop, для диагностики высокого использования памяти. Файл `.heapsnapshot` содержит ваш полный разговор и учётные данные, поэтому не делитесь им. См. [устранение неполадок](/docs/ru/troubleshooting#high-cpu-or-memory-usage) |

91| `/help` | Показать справку и доступные команды |91| `/help` | Показать справку и доступные команды |

92| `/hooks` | Просмотреть конфигурации [hook](/ru/hooks) для событий инструментов |92| `/hooks` | Просмотреть конфигурации [hook](/docs/ru/hooks) для событий инструментов |

93| `/ide` | Управлять интеграциями IDE и показать статус |93| `/ide` | Управлять интеграциями IDE и показать статус |

94| `/init` | Инициализировать проект с руководством `CLAUDE.md`. Установите `CLAUDE_CODE_NEW_INIT=1` для интерактивного потока, который также проходит через skills, hooks и файлы личной памяти |94| `/init` | Инициализировать проект с руководством `CLAUDE.md`. Установите `CLAUDE_CODE_NEW_INIT=1` для интерактивного потока, который также проходит через skills, hooks и файлы личной памяти |

95| `/insights` | Создать отчет, анализирующий ваши сеансы Claude Code, включая области проекта, паттерны взаимодействия и точки трения |95| `/insights` | Создать отчет, анализирующий ваши сеансы Claude Code, включая области проекта, паттерны взаимодействия и точки трения |

96| `/install-github-app` | Установить приложение Claude GitHub для репозитория с дополнительным шагом для настройки [GitHub Actions](/ru/github-actions) workflows и secrets. Проведет вас через выбор репозитория и настройку интеграции |96| `/install-github-app` | Установить приложение Claude GitHub для репозитория с дополнительным шагом для настройки [GitHub Actions](/docs/ru/github-actions) workflows и secrets. Проведет вас через выбор репозитория и настройку интеграции |

97| `/install-slack-app` | Установить приложение Claude Slack. Открывает браузер для завершения потока OAuth |97| `/install-slack-app` | Установить приложение Claude Slack. Открывает браузер для завершения потока OAuth |

98| `/keybindings` | Открыть файл [сочетаний клавиш](/ru/keybindings) |98| `/keybindings` | Открыть файл [сочетаний клавиш](/docs/ru/keybindings) |

99| `/login` | Войти в вашу учетную запись Anthropic |99| `/login` | Войти в вашу учетную запись Anthropic |

100| `/logout` | Выйти из вашей учетной записи Anthropic |100| `/logout` | Выйти из вашей учетной записи Anthropic |

101| `/loop [interval] [prompt]` | **[Skill](/ru/skills#bundled-skills).** Запустить подсказку повторно, пока сеанс остается открытым. Опустите интервал, и Claude будет самостоятельно устанавливать темп между итерациями. Опустите подсказку, и [где доступно](/ru/scheduled-tasks#run-the-built-in-maintenance-prompt), Claude запустит автономную проверку обслуживания или подсказку в `.claude/loop.md`. Пример: `/loop 5m check if the deploy finished`. См. [Запуск подсказок по расписанию](/ru/scheduled-tasks). Псевдоним: `/proactive` |101| `/loop [interval] [prompt]` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить подсказку повторно, пока сеанс остается открытым. Опустите интервал, и Claude будет самостоятельно устанавливать темп между итерациями. Опустите подсказку, и [где доступно](/docs/ru/scheduled-tasks#run-the-built-in-maintenance-prompt), Claude запустит автономную проверку обслуживания или подсказку в `.claude/loop.md`. Пример: `/loop 5m check if the deploy finished`. См. [Запуск подсказок по расписанию](/docs/ru/scheduled-tasks). Псевдоним: `/proactive` |

102| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Управлять подключениями MCP server и аутентификацией OAuth. Запустите без аргумента для открытия интерактивного списка, передайте `reconnect <server>` для переподключения одного отключенного сервера, или передайте `enable`/`disable` с именем сервера или `all` для изменения состояния подключения без открытия диалога. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`), где запуск его без аргумента выводит текстовую сводку статуса сервера вместо открытия списка; требует Claude Code v2.1.205 или позже |102| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | Управлять подключениями MCP server и аутентификацией OAuth. Запустите без аргумента для открытия интерактивного списка, передайте `reconnect <server>` для переподключения одного отключенного сервера, или передайте `enable`/`disable` с именем сервера или `all` для изменения состояния подключения без открытия диалога. Также доступно в неинтерактивном режиме (`-p`), где запуск его без аргумента выводит текстовую сводку статуса сервера вместо открытия списка; требует Claude Code v2.1.205 или позже |

103| `/memory` | Редактировать файлы памяти `CLAUDE.md`, включать или отключать [auto-memory](/ru/memory#auto-memory) и просматривать записи auto-memory |103| `/memory` | Редактировать файлы памяти `CLAUDE.md`, включать или отключать [auto-memory](/docs/ru/memory#auto-memory) и просматривать записи auto-memory |

104| `/mobile` | Показать QR-код для загрузки мобильного приложения Claude. Псевдонимы: `/ios`, `/android` |104| `/mobile` | Показать QR-код для загрузки мобильного приложения Claude. Псевдонимы: `/ios`, `/android` |

105| `/model [model]` | Переключить модель AI и сохранить ее как значение по умолчанию для новых сеансов. Для моделей, которые это поддерживают, используйте стрелки влево/вправо для [регулировки уровня усилий](/ru/model-config#adjust-effort-level). Без аргумента открывает выбор; нажмите `s` на строке для переключения только для текущего сеанса. Выбор запрашивает подтверждение, когда беседа имеет предыдущий вывод, так как следующий ответ перечитывает полную историю без кэшированного контекста. После подтверждения изменение вступает в силу без ожидания завершения текущего ответа. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`) с аргументом модели вместо выбора, где оно применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию; требует Claude Code v2.1.205 или позже |105| `/model [model]` | Переключить модель AI и сохранить ее как значение по умолчанию для новых сеансов. Для моделей, которые это поддерживают, используйте стрелки влево/вправо для [регулировки уровня усилий](/docs/ru/model-config#adjust-effort-level). Без аргумента открывает выбор; нажмите `s` на строке для переключения только для текущего сеанса. Выбор запрашивает подтверждение, когда беседа имеет предыдущий вывод, так как следующий ответ перечитывает полную историю без кэшированного контекста. После подтверждения изменение вступает в силу без ожидания завершения текущего ответа. Также доступно в неинтерактивном режиме (`-p`) с аргументом модели вместо выбора, где оно применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию; требует Claude Code v2.1.205 или позже |

106| `/passes` | Поделиться бесплатной неделей Claude Code с друзьями. Видна только если ваша учетная запись имеет право на это |106| `/passes` | Поделиться бесплатной неделей Claude Code с друзьями. Видна только если ваша учетная запись имеет право на это |

107| `/permissions` | Управлять правилами разрешения, запроса и отказа для разрешений инструментов. Открывает интерактивный диалог, где вы можете просматривать правила по области, добавлять или удалять правила, управлять рабочими каталогами и просматривать [недавние отказы в автоматическом режиме](/ru/auto-mode-config#review-denials). Псевдоним: `/allowed-tools` |107| `/permissions` | Управлять правилами разрешения, запроса и отказа для разрешений инструментов. Открывает интерактивный диалог, где вы можете просматривать правила по области, добавлять или удалять правила, управлять рабочими каталогами и просматривать [недавние отказы в автоматическом режиме](/docs/ru/auto-mode-config#review-denials). Псевдоним: `/allowed-tools` |

108| `/plan [description]` | Войти в Plan Mode непосредственно из приглашения. Передайте необязательное описание для входа в Plan Mode и немедленного начала с этой задачей, например `/plan fix the auth bug` |108| `/plan [description]` | Войти в Plan Mode непосредственно из приглашения. Передайте необязательное описание для входа в Plan Mode и немедленного начала с этой задачей, например `/plan fix the auth bug` |

109| `/plugin [subcommand]` | Управлять Claude Code [plugins](/ru/plugins). Запустите без аргумента для открытия меню plugin, или передайте подкоманду, такую как `list`, `install`, `enable` или `disable` для прямого действия |109| `/plugin [subcommand]` | Управлять Claude Code [plugins](/docs/ru/plugins). Запустите без аргумента для открытия меню plugin, или передайте подкоманду, такую как `list`, `install`, `enable` или `disable` для прямого действия |

110| `/powerup` | Открыть для себя функции Claude Code через быстрые интерактивные уроки с анимированными демонстрациями |110| `/powerup` | Открыть для себя функции Claude Code через быстрые интерактивные уроки с анимированными демонстрациями |

111| `/pr-comments [PR]` | {/* max-version: 2.1.90 */}Удалено в v2.1.91. Попросите Claude напрямую просмотреть комментарии pull request. В более ранних версиях получает и отображает комментарии из запроса на слияние GitHub; автоматически обнаруживает PR для текущей ветви или передайте URL или номер PR. Требует CLI `gh` |111| `/pr-comments [PR]` | Удалено в v2.1.91. Попросите Claude напрямую просмотреть комментарии pull request. В более ранних версиях получает и отображает комментарии из запроса на слияние GitHub; автоматически обнаруживает PR для текущей ветви или передайте URL или номер PR. Требует CLI `gh` |

112| `/privacy-settings` | Просмотреть и обновить параметры конфиденциальности. Доступно только для подписчиков планов Pro и Max |112| `/privacy-settings` | Просмотреть и обновить параметры конфиденциальности. Доступно только для подписчиков планов Pro и Max |

113| `/radio` | Открыть Claude FM lo-fi радио в вашем браузере. Выводит URL потока, когда браузер недоступен. Недоступно на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS |113| `/radio` | Открыть Claude FM lo-fi радио в вашем браузере. Выводит URL потока, когда браузер недоступен. Недоступно на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS |

114| `/recap` | Создать однострочную сводку текущего сеанса по требованию. См. [Сводка сеанса](/ru/interactive-mode#session-recap) для автоматической сводки, которая появляется после вашего отсутствия |114| `/recap` | Создать однострочную сводку текущего сеанса по требованию. См. [Сводка сеанса](/docs/ru/interactive-mode#session-recap) для автоматической сводки, которая появляется после вашего отсутствия |

115| `/release-notes` | Просмотреть журнал изменений в интерактивном выборщике версий. Выберите конкретную версию для просмотра ее примечаний к выпуску или выберите отображение всех версий. {/* min-version: 2.1.208 */}Примечания появляются в вашей стенограмме без входа в беседу, которую видит Claude. До v2.1.208, просмотренные примечания входили в беседу, включая весь журнал изменений при отображении всех версий |115| `/release-notes` | Просмотреть журнал изменений в интерактивном выборщике версий. Выберите конкретную версию для просмотра ее примечаний к выпуску или выберите отображение всех версий. Примечания появляются в вашей стенограмме без входа в беседу, которую видит Claude. До v2.1.208, просмотренные примечания входили в беседу, включая весь журнал изменений при отображении всех версий |

116| `/reload-plugins [--force]` | Перезагрузить все активные [plugins](/ru/plugins) для применения ожидающих изменений без перезагрузки. Сообщает количество для каждого перезагруженного компонента и отмечает любые ошибки загрузки. Когда перезагрузка изменит, какие MCP инструменты загружены и аннулирует кэш подсказок, команда предупреждает и пропускает, если вы не передадите `--force` |116| `/reload-plugins [--force]` | Перезагрузить все активные [plugins](/docs/ru/plugins) для применения ожидающих изменений без перезагрузки. Сообщает количество для каждого перезагруженного компонента и отмечает любые ошибки загрузки. Когда перезагрузка изменит, какие MCP инструменты загружены и аннулирует кэш подсказок, команда предупреждает и пропускает, если вы не передадите `--force` |

117| `/reload-skills` | {/* min-version: 2.1.152 */}Повторно сканировать каталоги [skill](/ru/skills) и команд, чтобы skills, добавленные или измененные на диске во время сеанса, стали доступны без перезагрузки. Сообщает, сколько skills доступно и сколько было добавлено или удалено. Добавлено в v2.1.152 |117| `/reload-skills` | Повторно сканировать каталоги [skill](/docs/ru/skills) и команд, чтобы skills, добавленные или измененные на диске во время сеанса, стали доступны без перезагрузки. Сообщает, сколько skills доступно и сколько было добавлено или удалено. Добавлено в v2.1.152 |

118| `/remote-control` | Сделать этот сеанс доступным для [Remote Control](/ru/remote-control) с claude.ai. {/* min-version: 2.1.206 */}Запуск его при выходе выводит, что Remote Control требует подписку claude.ai и говорит вам, как войти; до v2.1.206 он сообщал `Unknown command: /remote-control`. Псевдоним: `/rc` |118| `/remote-control` | Сделать этот сеанс доступным для [Remote Control](/docs/ru/remote-control) с claude.ai. Запуск его при выходе выводит, что Remote Control требует подписку claude.ai и говорит вам, как войти; до v2.1.206 он сообщал `Unknown command: /remote-control`. Псевдоним: `/rc` |

119| `/remote-env` | Выбрать окружение по умолчанию для [облачных агентов](/ru/claude-code-on-the-web#configure-your-environment) |119| `/remote-env` | Выбрать окружение по умолчанию для [облачных агентов](/docs/ru/claude-code-on-the-web#configure-your-environment) |

120| `/rename [name]` | Переименовать текущий сеанс и показать имя на строке приглашения. Без имени автоматически генерирует одно из истории беседы. {/* min-version: 2.1.205 */}Также доступно в неинтерактивном режиме (`-p`); требует Claude Code v2.1.205 или позже |120| `/rename [name]` | Переименовать текущий сеанс и показать имя на строке приглашения. Без имени автоматически генерирует одно из истории беседы. Также доступно в неинтерактивном режиме (`-p`); требует Claude Code v2.1.205 или позже |

121| `/resume [session]` | Возобновить беседу по ID или имени, или открыть выбор сеанса. Начиная с v2.1.144, [фоновые сеансы](/ru/agent-view) отображаются в выборщике, отмеченные как `bg`; один, который все еще работает, не может быть возобновлен здесь, поэтому подключитесь к нему из `claude agents` или остановите его там сначала. Псевдоним: `/continue` |121| `/resume [session]` | Возобновить беседу по ID или имени, или открыть выбор сеанса. Начиная с v2.1.144, [фоновые сеансы](/docs/ru/agent-view) отображаются в выборщике, отмеченные как `bg`; один, который все еще работает, не может быть возобновлен здесь, поэтому подключитесь к нему из `claude agents` или остановите его там сначала. Псевдоним: `/continue` |

122| `/review [PR]` | {/* min-version: 2.1.202 */}Запустить быстрый однопроходный просмотр только для чтения запроса на слияние GitHub по номеру. Без аргумента выводит список открытых PR для выбора; текст после номера PR становится дополнительными инструкциями просмотра. Начиная с v2.1.186 по v2.1.201, `/review` вместо этого запускал тот же многоагентный механизм, что и `/code-review medium`. Для многоагентного просмотра на выбранном уровне усилий используйте [`/code-review <level> <pr#>`](/ru/code-review#review-a-diff-locally); для облачного просмотра см. [`/code-review ultra`](/ru/ultrareview) |122| `/review [PR]` | Запустить быстрый однопроходный просмотр только для чтения запроса на слияние GitHub по номеру. Без аргумента выводит список открытых PR для выбора; текст после номера PR становится дополнительными инструкциями просмотра. Начиная с v2.1.186 по v2.1.201, `/review` вместо этого запускал тот же многоагентный механизм, что и `/code-review medium`. Для многоагентного просмотра на выбранном уровне усилий используйте [`/code-review <level> <pr#>`](/docs/ru/code-review#review-a-diff-locally); для облачного просмотра см. [`/code-review ultra`](/docs/ru/ultrareview) |

123| `/rewind` | Перемотать беседу и/или код к предыдущей точке или суммировать с выбранного сообщения. См. [checkpointing](/ru/checkpointing). Псевдонимы: `/checkpoint`, `/undo` |123| `/rewind` | Перемотать беседу и/или код к предыдущей точке или суммировать с выбранного сообщения. См. [checkpointing](/docs/ru/checkpointing). Псевдонимы: `/checkpoint`, `/undo` |

124| `/run` | **[Skill](/ru/skills#bundled-skills).** Запустить и управлять приложением вашего проекта, чтобы увидеть работающее изменение в запущенном приложении, а не только в тестах. См. [Запуск и проверка вашего приложения](/ru/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Требует Claude Code v2.1.145 или позже |124| `/run` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить и управлять приложением вашего проекта, чтобы увидеть работающее изменение в запущенном приложении, а не только в тестах. См. [Запуск и проверка вашего приложения](/docs/ru/skills#run-and-verify-your-app). Требует Claude Code v2.1.145 или позже |

125| `/run-skill-generator` | **[Skill](/ru/skills#bundled-skills).** Научить `/run` и `/verify` как собирать, запускать и управлять приложением вашего проекта из чистого окружения путем написания [skill](/ru/skills#run-and-verify-your-app) для каждого проекта. {/* min-version: 2.1.145 */}Требует Claude Code v2.1.145 или позже |125| `/run-skill-generator` | **[Skill](/docs/ru/skills#bundled-skills).** Научить `/run` и `/verify` как собирать, запускать и управлять приложением вашего проекта из чистого окружения путем написания [skill](/docs/ru/skills#run-and-verify-your-app) для каждого проекта. Требует Claude Code v2.1.145 или позже |

126| `/sandbox` | Переключить [режим sandbox](/ru/sandboxing). Доступно только на поддерживаемых платформах |126| `/sandbox` | Переключить [режим sandbox](/docs/ru/sandboxing). Доступно только на поддерживаемых платформах |

127| `/schedule [description]` | Создать, обновить, перечислить или запустить [routines](/ru/routines), которые выполняются на управляемой Anthropic облачной инфраструктуре. Claude проведет вас через настройку в диалоговом режиме. Псевдоним: `/routines` |127| `/schedule [description]` | Создать, обновить, перечислить или запустить [routines](/docs/ru/routines), которые выполняются на управляемой Anthropic облачной инфраструктуре. Claude проведет вас через настройку в диалоговом режиме. Псевдоним: `/routines` |

128| `/scroll-speed` | Отрегулировать [скорость прокрутки](/ru/fullscreen#mouse-wheel-scrolling) колеса мыши интерактивно, с линейкой, которую вы можете прокручивать, пока диалог открыт, чтобы предварительно просмотреть изменение. Доступно только в [полноэкранном рендеринге](/ru/fullscreen) и не в терминале JetBrains IDE |128| `/scroll-speed` | Отрегулировать [скорость прокрутки](/docs/ru/fullscreen#mouse-wheel-scrolling) колеса мыши интерактивно, с линейкой, которую вы можете прокручивать, пока диалог открыт, чтобы предварительно просмотреть изменение. Доступно только в [полноэкранном рендеринге](/docs/ru/fullscreen) и не в терминале JetBrains IDE |

129| `/security-review` | Анализировать ожидающие изменения на текущей ветви на предмет уязвимостей безопасности. Проверяет git diff и определяет риски, такие как инъекции, проблемы с аутентификацией и утечка данных |129| `/security-review` | Анализировать ожидающие изменения на текущей ветви на предмет уязвимостей безопасности. Проверяет git diff и определяет риски, такие как инъекции, проблемы с аутентификацией и утечка данных |

130| `/setup-bedrock` | Настроить аутентификацию [Amazon Bedrock](/ru/amazon-bedrock), регион и привязки моделей через интерактивный мастер. Видна только когда установлено `CLAUDE_CODE_USE_BEDROCK=1`. Пользователи Bedrock в первый раз также могут получить доступ к этому мастеру с экрана входа |130| `/setup-bedrock` | Настроить аутентификацию [Amazon Bedrock](/docs/ru/amazon-bedrock), регион и привязки моделей через интерактивный мастер. Видна только когда установлено `CLAUDE_CODE_USE_BEDROCK=1`. Пользователи Bedrock в первый раз также могут получить доступ к этому мастеру с экрана входа |

131| `/setup-vertex` | Настроить аутентификацию [Google Cloud's Agent Platform](/ru/google-vertex-ai), проект, регион и привязки моделей через интерактивный мастер. Видна только когда установлено `CLAUDE_CODE_USE_VERTEX=1`. Пользователи Google Cloud's Agent Platform в первый раз также могут получить доступ к этому мастеру с экрана входа |131| `/setup-vertex` | Настроить аутентификацию [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), проект, регион и привязки моделей через интерактивный мастер. Видна только когда установлено `CLAUDE_CODE_USE_VERTEX=1`. Пользователи Google Cloud's Agent Platform в первый раз также могут получить доступ к этому мастеру с экрана входа |

132| `/simplify [target]` | {/* min-version: 2.1.154 */}**[Skill](/ru/skills#bundled-skills).** Просмотреть измененный код на предмет возможностей очистки и применить исправления. Четыре агента просмотра [agents](/ru/sub-agents) работают параллельно, охватывая переиспользование существующих помощников, упрощение, эффективность и находится ли изменение на правильном уровне абстракции. Начиная с v2.1.154, просмотр не ищет ошибки корректности. Используйте `/code-review` для поиска ошибок. В более ранних версиях `/simplify` эквивалентен `/code-review --fix`. Передайте путь или ссылку PR для просмотра конкретной цели |132| `/simplify [target]` | **[Skill](/docs/ru/skills#bundled-skills).** Просмотреть измененный код на предмет возможностей очистки и применить исправления. Четыре агента просмотра [agents](/docs/ru/sub-agents) работают параллельно, охватывая переиспользование существующих помощников, упрощение, эффективность и находится ли изменение на правильном уровне абстракции. Начиная с v2.1.154, просмотр не ищет ошибки корректности. Используйте `/code-review` для поиска ошибок. В более ранних версиях `/simplify` эквивалентен `/code-review --fix`. Передайте путь или ссылку PR для просмотра конкретной цели |

133| `/skills` | Список доступных [skills](/ru/skills). {/* min-version: 2.1.121 */}Начиная с v2.1.121, введите для фильтрации списка по имени. Нажмите `t` для сортировки по количеству токенов. Нажмите `Space` для [скрытия skill от Claude или меню `/`](/ru/skills#override-skill-visibility-from-settings), затем `Enter` для сохранения |133| `/skills` | Список доступных [skills](/docs/ru/skills). Начиная с v2.1.121, введите для фильтрации списка по имени. Нажмите `t` для сортировки по количеству токенов. Нажмите `Space` для [скрытия skill от Claude или меню `/`](/docs/ru/skills#override-skill-visibility-from-settings), затем `Enter` для сохранения |

134| `/stats` | Псевдоним для `/usage`. Открывается на вкладке Stats |134| `/stats` | Псевдоним для `/usage`. Открывается на вкладке Stats |

135| `/status` | Открыть интерфейс Параметры (вкладка Статус), показывающий версию, модель, учетную запись и подключение. Работает во время ответа Claude без ожидания завершения текущего ответа |135| `/status` | Открыть интерфейс Параметры (вкладка Статус), показывающий версию, модель, учетную запись и подключение. Работает во время ответа Claude без ожидания завершения текущего ответа |

136| `/statusline` | Настроить [строку статуса](/ru/statusline) Claude Code. Опишите, что вы хотите, или запустите без аргументов для автоматической настройки из приглашения вашей оболочки |136| `/statusline` | Настроить [строку статуса](/docs/ru/statusline) Claude Code. Опишите, что вы хотите, или запустите без аргументов для автоматической настройки из приглашения вашей оболочки |

137| `/stickers` | Заказать наклейки Claude Code |137| `/stickers` | Заказать наклейки Claude Code |

138| `/stop` | Остановить текущий [фоновый сеанс](/ru/agent-view). Доступно только при подключении к фоновому сеансу; стенограмма и любой worktree сохраняются. Чтобы отсоединиться без остановки, используйте `/exit` или нажмите `←` |138| `/stop` | Остановить текущий [фоновый сеанс](/docs/ru/agent-view). Доступно только при подключении к фоновому сеансу; стенограмма и любой worktree сохраняются. Чтобы отсоединиться без остановки, используйте `/exit` или нажмите `←` |

139| `/tasks` | Просмотреть и управлять фоновой работой в текущем сеансе, включая подагентов, которые завершили работу. Также доступно как `/bashes` |139| `/tasks` | Просмотреть и управлять фоновой работой в текущем сеансе, включая подагентов, которые завершили работу. Также доступно как `/bashes` |

140| `/team-onboarding` | Создать руководство по адаптации команды из истории использования Claude Code. Claude анализирует ваши сеансы, команды и использование MCP server за последние 30 дней и создает руководство markdown, которое товарищ по команде может вставить как первое сообщение для быстрой настройки. Для подписчиков claude.ai на планах Pro, Max, Team и Enterprise также возвращает ссылку для совместного доступа, которую товарищи по команде могут открыть непосредственно в Claude Code |140| `/team-onboarding` | Создать руководство по адаптации команды из истории использования Claude Code. Claude анализирует ваши сеансы, команды и использование MCP server за последние 30 дней и создает руководство markdown, которое товарищ по команде может вставить как первое сообщение для быстрой настройки. Для подписчиков claude.ai на планах Pro, Max, Team и Enterprise также возвращает ссылку для совместного доступа, которую товарищи по команде могут открыть непосредственно в Claude Code |

141| `/teleport` | Перенести сеанс [Claude Code в веб-браузере](/ru/claude-code-on-the-web#from-web-to-terminal) в этот терминал: открывает выбор, затем получает ветвь и беседу. Также доступно как `/tp`. Требует подписку claude.ai |141| `/teleport` | Перенести сеанс [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web#from-web-to-terminal) в этот терминал: открывает выбор, затем получает ветвь и беседу. Также доступно как `/tp`. Требует подписку claude.ai |

142| `/terminal-setup` | Настроить сочетания клавиш терминала для Shift+Enter и других ярлыков. Видна только в терминалах, которые в этом нуждаются, таких как VS Code, Cursor, Devin Desktop, Alacritty или Zed |142| `/terminal-setup` | Настроить сочетания клавиш терминала для Shift+Enter и других ярлыков. Видна только в терминалах, которые в этом нуждаются, таких как VS Code, Cursor, Devin Desktop, Alacritty или Zed |

143| `/theme` | Изменить цветовую тему. Включает опцию `auto`, которая следует темному или светлому режиму вашего терминала, светлые и темные варианты, доступные для дальтоников (далтонизированные) темы, ANSI темы, которые используют палитру цветов вашего терминала, и любые [пользовательские темы](/ru/terminal-config#create-a-custom-theme) из `~/.claude/themes/` или plugins. Выберите **New custom theme…** для создания одной |143| `/theme` | Изменить цветовую тему. Включает опцию `auto`, которая следует темному или светлому режиму вашего терминала, светлые и темные варианты, доступные для дальтоников (далтонизированные) темы, ANSI темы, которые используют палитру цветов вашего терминала, и любые [пользовательские темы](/docs/ru/terminal-config#create-a-custom-theme) из `~/.claude/themes/` или plugins. Выберите **New custom theme…** для создания одной |

144| `/tui [default\|fullscreen]` | Установить средство визуализации пользовательского интерфейса терминала и перезагрузиться в него с сохранением вашей беседы. `fullscreen` включает [безмерцающий рендерер alt-screen](/ru/fullscreen). Без аргумента выводит активный рендерер |144| `/tui [default\|fullscreen]` | Установить средство визуализации пользовательского интерфейса терминала и перезагрузиться в него с сохранением вашей беседы. `fullscreen` включает [безмерцающий рендерер alt-screen](/docs/ru/fullscreen). Без аргумента выводит активный рендерер |

145| `/ultraplan <prompt>` | Разработать план в сеансе [ultraplan](/ru/ultraplan), просмотреть его в браузере, затем выполнить удаленно или отправить обратно в ваш терминал |145| `/ultraplan <prompt>` | Разработать план в сеансе [ultraplan](/docs/ru/ultraplan), просмотреть его в браузере, затем выполнить удаленно или отправить обратно в ваш терминал |

146| `/ultrareview [PR]` | Запустить глубокий многоагентный просмотр кода в облачной песочнице с [ultrareview](/ru/ultrareview). Предпочтительный вызов теперь `/code-review ultra`, и `/ultrareview` остается как псевдоним. Включает 3 бесплатных запуска на Pro и Max, затем требует [дополнительное использование](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |146| `/ultrareview [PR]` | Запустить глубокий многоагентный просмотр кода в облачной песочнице с [ultrareview](/docs/ru/ultrareview). Предпочтительный вызов теперь `/code-review ultra`, и `/ultrareview` остается как псевдоним. Включает 3 бесплатных запуска на Pro и Max, затем требует [дополнительное использование](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

147| `/upgrade` | Открыть страницу обновления в вашем браузере для переключения на более высокий уровень плана. Когда браузер не может открыться, команда показывает приглашение входа без вывода URL |147| `/upgrade` | Открыть страницу обновления в вашем браузере для переключения на более высокий уровень плана. Когда браузер не может открыться, команда показывает приглашение входа без вывода URL |

148| `/usage` | Показать стоимость сеанса, ограничения использования плана и статистику активности. На планах Pro, Max, Team и Enterprise включает разбивку использования по skills, subagent, plugins и MCP server. См. [руководство по отслеживанию затрат](/ru/costs#using-the-%2Fusage-command) для деталей. `/cost` и `/stats` являются псевдонимами |148| `/usage` | Показать стоимость сеанса, ограничения использования плана и статистику активности. На планах Pro, Max, Team и Enterprise включает разбивку использования по skills, subagent, plugins и MCP server. См. [руководство по отслеживанию затрат](/docs/ru/costs#using-the-%2Fusage-command) для деталей. `/cost` и `/stats` являются псевдонимами |

149| `/usage-credits` | Настроить дополнительное использование для продолжения работы при достижении ограничений. На планах Pro и Max открывает [диалог в CLI](/ru/costs#set-a-spend-limit-on-pro-and-max) для покупки дополнительного использования, установки ежемесячного лимита расходов и настройки автоматической перезагрузки; на версиях Claude Code до v2.1.207 и на других планах открывает страницу выставления счетов за дополнительное использование в вашем браузере, за исключением того, что члены Team и Enterprise без доступа к выставлению счетов вместо этого отправляют запрос дополнительного использования своему администратору из CLI. {/* min-version: 2.1.205 */}Когда браузер не может открыть страницу выставления счетов, например при работе через SSH, команда выводит URL для посещения вместо этого; это требует Claude Code v2.1.205 или позже, и более ранние версии ничего не показывали в этом случае. Ранее `/extra-usage` |149| `/usage-credits` | Настроить дополнительное использование для продолжения работы при достижении ограничений. На планах Pro и Max открывает [диалог в CLI](/docs/ru/costs#set-a-spend-limit-on-pro-and-max) для покупки дополнительного использования, установки ежемесячного лимита расходов и настройки автоматической перезагрузки; на версиях Claude Code до v2.1.207 и на других планах открывает страницу выставления счетов за дополнительное использование в вашем браузере, за исключением того, что члены Team и Enterprise без доступа к выставлению счетов вместо этого отправляют запрос дополнительного использования своему администратору из CLI. Когда браузер не может открыть страницу выставления счетов, например при работе через SSH, команда выводит URL для посещения вместо этого; это требует Claude Code v2.1.205 или позже, и более ранние версии ничего не показывали в этом случае. Ранее `/extra-usage` |

150| `/verify` | **[Skill](/ru/skills#bundled-skills).** Подтвердить, что изменение кода делает то, что оно должно делать, путем сборки приложения вашего проекта, его запуска и наблюдения результата, а не полагаясь на тесты или проверки типов. См. [Запуск и проверка вашего приложения](/ru/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Требует Claude Code v2.1.145 или позже |150| `/verify` | **[Skill](/docs/ru/skills#bundled-skills).** Подтвердить, что изменение кода делает то, что оно должно делать, путем сборки приложения вашего проекта, его запуска и наблюдения результата, а не полагаясь на тесты или проверки типов. См. [Запуск и проверка вашего приложения](/docs/ru/skills#run-and-verify-your-app). Требует Claude Code v2.1.145 или позже |

151| `/vim` | {/* max-version: 2.1.91 */}Удалено в v2.1.92. Для переключения между режимами редактирования Vim и Normal используйте `/config` → Editor mode |151| `/vim` | Удалено в v2.1.92. Для переключения между режимами редактирования Vim и Normal используйте `/config` → Editor mode |

152| `/voice [hold\|tap\|off]` | Переключить [диктовку голосом](/ru/voice-dictation) или включить ее в определенном режиме. Требует учетную запись Claude.ai |152| `/voice [hold\|tap\|off]` | Переключить [диктовку голосом](/docs/ru/voice-dictation) или включить ее в определенном режиме. Требует учетную запись Claude.ai |

153| `/web-setup` | Подключить вашу учетную запись GitHub к [Claude Code в веб-браузере](/ru/web-quickstart#connect-from-your-terminal) используя учетные данные вашего локального CLI `gh`. `/schedule` автоматически запрашивает это, если GitHub не подключен |153| `/web-setup` | Подключить вашу учетную запись GitHub к [Claude Code в веб-браузере](/docs/ru/web-quickstart#connect-from-your-terminal) используя учетные данные вашего локального CLI `gh`. `/schedule` автоматически запрашивает это, если GitHub не подключен |

154| `/workflows` | Открыть [workflow](/ru/workflows#watch-the-run) представление прогресса для просмотра, паузы, возобновления или сохранения выполняющихся и завершенных workflows |154| `/workflows` | Открыть [workflow](/docs/ru/workflows#watch-the-run) представление прогресса для просмотра, паузы, возобновления или сохранения выполняющихся и завершенных workflows |

155 155 

156<h2 id="mcp-prompts">156<h2 id="mcp-prompts">

157 MCP prompts157 MCP prompts

158</h2>158</h2>

159 159 

160MCP servers могут предоставлять подсказки, которые появляются как команды. Они используют формат `/mcp__<server>__<prompt>` и динамически обнаруживаются из подключенных серверов. См. [MCP prompts](/ru/mcp#use-mcp-prompts-as-commands) для деталей.160MCP servers могут предоставлять подсказки, которые появляются как команды. Они используют формат `/mcp__<server>__<prompt>` и динамически обнаруживаются из подключенных серверов. См. [MCP prompts](/docs/ru/mcp#use-mcp-prompts-as-commands) для деталей.

161 161 

162<h2 id="see-also">162<h2 id="see-also">

163 См. также163 См. также

164</h2>164</h2>

165 165 

166* [Skills](/ru/skills): создавайте свои собственные команды166* [Skills](/docs/ru/skills): создавайте свои собственные команды

167* [Интерактивный режим](/ru/interactive-mode): сочетания клавиш, режим Vim и история команд167* [Интерактивный режим](/docs/ru/interactive-mode): сочетания клавиш, режим Vim и история команд

168* [Справочник CLI](/ru/cli-reference): флаги времени запуска168* [Справочник CLI](/docs/ru/cli-reference): флаги времени запуска

computer-use.md +11 −11

Details

12 12 

13Computer use позволяет Claude открывать приложения, управлять вашим экраном и работать на вашей машине так же, как вы. Из CLI Claude может скомпилировать приложение Swift, запустить его, кликнуть по каждой кнопке и сделать снимок экрана результата, всё в одном разговоре, где он писал код.13Computer use позволяет Claude открывать приложения, управлять вашим экраном и работать на вашей машине так же, как вы. Из CLI Claude может скомпилировать приложение Swift, запустить его, кликнуть по каждой кнопке и сделать снимок экрана результата, всё в одном разговоре, где он писал код.

14 14 

15На этой странице рассказывается о том, как работает computer use в CLI. Для приложения Desktop на macOS или Windows см. [computer use в Desktop](/ru/desktop#let-claude-use-your-computer).15На этой странице рассказывается о том, как работает computer use в CLI. Для приложения Desktop на macOS или Windows см. [computer use в Desktop](/docs/ru/desktop#let-claude-use-your-computer).

16 16 

17<h2 id="what-you-can-do-with-computer-use">17<h2 id="what-you-can-do-with-computer-use">

18 Что вы можете делать с computer use18 Что вы можете делать с computer use


31 31 

32Claude имеет несколько способов взаимодействия с приложением или сервисом. Computer use — самый широкий и медленный, поэтому Claude сначала пытается использовать наиболее точный инструмент:32Claude имеет несколько способов взаимодействия с приложением или сервисом. Computer use — самый широкий и медленный, поэтому Claude сначала пытается использовать наиболее точный инструмент:

33 33 

34* Если у вас есть [MCP server](/ru/mcp) для сервиса, Claude использует его.34* Если у вас есть [MCP server](/docs/ru/mcp) для сервиса, Claude использует его.

35* Если задача — это команда shell, Claude использует Bash.35* Если задача — это команда shell, Claude использует Bash.

36* Если задача — это работа в браузере и у вас настроен [Claude в Chrome](/ru/chrome), Claude использует это.36* Если задача — это работа в браузере и у вас настроен [Claude в Chrome](/docs/ru/chrome), Claude использует это.

37* Если ничего из вышеперечисленного не применимо, Claude использует computer use.37* Если ничего из вышеперечисленного не применимо, Claude использует computer use.

38 38 

39Управление экраном зарезервировано для вещей, которые ничто другое не может достичь: нативные приложения, симуляторы и инструменты без API.39Управление экраном зарезервировано для вещей, которые ничто другое не может достичь: нативные приложения, симуляторы и инструменты без API.


98 98 

99Эти приложения не блокируются. Предупреждение позволяет вам решить, оправдывает ли задача такой уровень доступа.99Эти приложения не блокируются. Предупреждение позволяет вам решить, оправдывает ли задача такой уровень доступа.

100 100 

101Уровень управления Claude также варьируется в зависимости от категории приложения: браузеры и торговые платформы доступны только для просмотра, терминалы и IDE доступны только для клика, а всё остальное получает полный контроль. См. [app permissions в Desktop](/ru/desktop#app-permissions) для полного разбора уровней.101Уровень управления Claude также варьируется в зависимости от категории приложения: браузеры и торговые платформы доступны только для просмотра, терминалы и IDE доступны только для клика, а всё остальное получает полный контроль. См. [app permissions в Desktop](/docs/ru/desktop#app-permissions) для полного разбора уровней.

102 102 

103<h2 id="how-claude-works-on-your-screen">103<h2 id="how-claude-works-on-your-screen">

104 Как Claude работает на вашем экране104 Как Claude работает на вашем экране


110 Один сеанс за раз110 Один сеанс за раз

111</h3>111</h3>

112 112 

113Computer use удерживает блокировку на уровне машины с первого действия computer use до выхода из сеанса, который её получил. {/* min-version: 2.1.195 */}Начиная с версии 2.1.195, завершение задачи не освобождает блокировку; её освобождает только выход из сеанса. Если другой сеанс Claude Code уже использует ваш компьютер, новые попытки завершаются с сообщением, сообщающим вам, какой сеанс удерживает блокировку. Сначала выйдите из этого сеанса.113Computer use удерживает блокировку на уровне машины с первого действия computer use до выхода из сеанса, который её получил. Начиная с версии 2.1.195, завершение задачи не освобождает блокировку; её освобождает только выход из сеанса. Если другой сеанс Claude Code уже использует ваш компьютер, новые попытки завершаются с сообщением, сообщающим вам, какой сеанс удерживает блокировку. Сначала выйдите из этого сеанса.

114 114 

115<h3 id="apps-are-hidden-while-claude-works">115<h3 id="apps-are-hidden-while-claude-works">

116 Приложения скрыты, пока Claude работает116 Приложения скрыты, пока Claude работает


141</h2>141</h2>

142 142 

143<Warning>143<Warning>

144 В отличие от [sandboxed Bash tool](/ru/sandboxing), computer use работает на вашем реальном рабочем столе с доступом к приложениям, которые вы одобрили. Claude проверяет каждое действие и отмечает потенциальные prompt injection из содержимого на экране, но граница доверия отличается. См. [computer use safety guide](https://support.claude.com/en/articles/14128542) для лучших практик.144 В отличие от [sandboxed Bash tool](/docs/ru/sandboxing), computer use работает на вашем реальном рабочем столе с доступом к приложениям, которые вы одобрили. Claude проверяет каждое действие и отмечает потенциальные prompt injection из содержимого на экране, но граница доверия отличается. См. [computer use safety guide](https://support.claude.com/en/articles/14128542) для лучших практик.

145</Warning>145</Warning>

146 146 

147Встроенные защиты снижают риск без необходимости конфигурации:147Встроенные защиты снижают риск без необходимости конфигурации:


235 235 

236Сервер появляется только на подходящих установках. Проверьте, что:236Сервер появляется только на подходящих установках. Проверьте, что:

237 237 

238* Вы на macOS. Computer use в CLI недоступен на Linux или Windows. На Windows используйте [computer use в Desktop](/ru/desktop#let-claude-use-your-computer) вместо этого.238* Вы на macOS. Computer use в CLI недоступен на Linux или Windows. На Windows используйте [computer use в Desktop](/docs/ru/desktop#let-claude-use-your-computer) вместо этого.

239* Вы на плане Pro или Max. Запустите `/status` для подтверждения вашей подписки.239* Вы на плане Pro или Max. Запустите `/status` для подтверждения вашей подписки.

240* Вы аутентифицированы через claude.ai. Computer use недоступен с поставщиками третьих сторон, такими как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через поставщика третьей стороны, вам нужна отдельная учётная запись claude.ai для использования этой функции.240* Вы аутентифицированы через claude.ai. Computer use недоступен с поставщиками третьих сторон, такими как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через поставщика третьей стороны, вам нужна отдельная учётная запись claude.ai для использования этой функции.

241* Вы в интерактивном сеансе. Computer use недоступен в неинтерактивном режиме с флагом `-p`.241* Вы в интерактивном сеансе. Computer use недоступен в неинтерактивном режиме с флагом `-p`.


244 See also244 See also

245</h2>245</h2>

246 246 

247* [Computer use в Desktop](/ru/desktop#let-claude-use-your-computer): та же возможность с графической страницей параметров247* [Computer use в Desktop](/docs/ru/desktop#let-claude-use-your-computer): та же возможность с графической страницей параметров

248* [Claude в Chrome](/ru/chrome): автоматизация браузера для веб-задач248* [Claude в Chrome](/docs/ru/chrome): автоматизация браузера для веб-задач

249* [MCP](/ru/mcp): подключите Claude к структурированным инструментам и API249* [MCP](/docs/ru/mcp): подключите Claude к структурированным инструментам и API

250* [Sandboxing](/ru/sandboxing): как инструмент Bash Claude изолирует доступ к файловой системе и сети250* [Sandboxing](/docs/ru/sandboxing): как инструмент Bash Claude изолирует доступ к файловой системе и сети

251* [Computer use safety guide](https://support.claude.com/en/articles/14128542): лучшие практики для безопасного использования computer use251* [Computer use safety guide](https://support.claude.com/en/articles/14128542): лучшие практики для безопасного использования computer use

context-window.md +13 −13

Details

1578 1578 

1579Сеанс проходит через реалистичный поток с репрезентативными подсчётами токенов:1579Сеанс проходит через реалистичный поток с репрезентативными подсчётами токенов:

1580 1580 

1581* **Перед тем, как вы что-либо введёте**: CLAUDE.md, автоматическая память, имена инструментов MCP и описания skills загружаются в контекст. Ваша собственная настройка может добавить больше здесь, например [стиль вывода](/ru/output-styles) или текст из [`--append-system-prompt`](/ru/cli-reference), которые оба переходят в системный prompt так же.1581* **Перед тем, как вы что-либо введёте**: CLAUDE.md, автоматическая память, имена инструментов MCP и описания skills загружаются в контекст. Ваша собственная настройка может добавить больше здесь, например [стиль вывода](/docs/ru/output-styles) или текст из [`--append-system-prompt`](/docs/ru/cli-reference), которые оба переходят в системный prompt так же.

1582* **Во время работы Claude**: каждое чтение файла добавляется в контекст, [правила с областью действия пути](/ru/memory#path-specific-rules) загружаются автоматически вместе с соответствующими файлами, и [hook PostToolUse](/ru/hooks-guide) срабатывает после каждого редактирования.1582* **Во время работы Claude**: каждое чтение файла добавляется в контекст, [правила с областью действия пути](/docs/ru/memory#path-specific-rules) загружаются автоматически вместе с соответствующими файлами, и [hook PostToolUse](/docs/ru/hooks-guide) срабатывает после каждого редактирования.

1583* **Последующий prompt**: [subagent](/ru/sub-agents) обрабатывает исследование в своём собственном отдельном контекстном окне, поэтому большие чтения файлов остаются вне вашего. Только резюме и небольшой трейлер метаданных возвращаются.1583* **Последующий prompt**: [subagent](/docs/ru/sub-agents) обрабатывает исследование в своём собственном отдельном контекстном окне, поэтому большие чтения файлов остаются вне вашего. Только резюме и небольшой трейлер метаданных возвращаются.

1584* **В конце**: `/compact` заменяет историю разговора структурированным резюме. Большая часть содержимого при запуске перезагружается автоматически; таблица ниже показывает, что происходит с каждым механизмом.1584* **В конце**: `/compact` заменяет историю разговора структурированным резюме. Большая часть содержимого при запуске перезагружается автоматически; таблица ниже показывает, что происходит с каждым механизмом.

1585 1585 

1586<h2 id="what-survives-compaction">1586<h2 id="what-survives-compaction">

1587 Что сохраняется при компактировании1587 Что сохраняется при компактировании

1588</h2>1588</h2>

1589 1589 

1590Когда длительный сеанс компактируется, Claude Code суммирует историю разговора, чтобы она поместилась в контекстное окно. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, запрос суммирования наследует конфигурацию [extended thinking](/ru/model-config#extended-thinking) вашего сеанса, поэтому он рассуждает с включённым thinking, когда в вашем сеансе он включён, и остаётся отключённым в противном случае. Thinking влияет только на то, как создаётся сводка; параметры вашего сеанса остаются неизменными после этого. Что происходит с вашими инструкциями, зависит от того, как они были загружены:1590Когда длительный сеанс компактируется, Claude Code суммирует историю разговора, чтобы она поместилась в контекстное окно. Начиная с версии 2.1.198, запрос суммирования наследует конфигурацию [extended thinking](/docs/ru/model-config#extended-thinking) вашего сеанса, поэтому он рассуждает с включённым thinking, когда в вашем сеансе он включён, и остаётся отключённым в противном случае. Thinking влияет только на то, как создаётся сводка; параметры вашего сеанса остаются неизменными после этого. Что происходит с вашими инструкциями, зависит от того, как они были загружены:

1591 1591 

1592| Механизм | После компактирования |1592| Механизм | После компактирования |

1593| :------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |1593| :------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |


1607 Когда ваш контекст заполняется1607 Когда ваш контекст заполняется

1608</h2>1608</h2>

1609 1609 

1610Claude Code автоматически компактирует по мере приближения к лимиту, поэтому полное контекстное окно не завершает ваш сеанс. Автоматический проход работает так же, как шаг `/compact` на временной шкале. Смотрите [Когда контекст заполняется](/ru/how-claude-code-works#when-context-fills-up) для того, что он сохраняет.1610Claude Code автоматически компактирует по мере приближения к лимиту, поэтому полное контекстное окно не завершает ваш сеанс. Автоматический проход работает так же, как шаг `/compact` на временной шкале. Смотрите [Когда контекст заполняется](/docs/ru/how-claude-code-works#when-context-fills-up) для того, что он сохраняет.

1611 1611 

1612Вы также можете действовать перед автоматическим проходом:1612Вы также можете действовать перед автоматическим проходом:

1613 1613 

1614* **Компактируйте с фокусом**: запустите `/compact` с инструкциями, например `/compact focus on the auth bug fix`, перед началом длительной новой задачи. Резюме сохраняет то, что вы выбираете, вместо того, что автоматический проход предполагает как важное.1614* **Компактируйте с фокусом**: запустите `/compact` с инструкциями, например `/compact focus on the auth bug fix`, перед началом длительной новой задачи. Резюме сохраняет то, что вы выбираете, вместо того, что автоматический проход предполагает как важное.

1615* **Очищайте между задачами**: запустите `/clear` при переходе на несвязанную работу. Старый разговор вытесняет файлы, которые вам нужны дальше, и стоит токены на каждом сообщении.1615* **Очищайте между задачами**: запустите `/clear` при переходе на несвязанную работу. Старый разговор вытесняет файлы, которые вам нужны дальше, и стоит токены на каждом сообщении.

1616* **Делегируйте большие чтения**: отправьте исследование [subagent](/ru/sub-agents), чтобы содержимое файла оставалось в его контекстном окне, а не в вашем.1616* **Делегируйте большие чтения**: отправьте исследование [subagent](/docs/ru/sub-agents), чтобы содержимое файла оставалось в его контекстном окне, а не в вашем.

1617 1617 

1618Если вам нужно большее окно, а не меньший разговор, Fable 5, Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают контекстное окно в 1 миллион токенов. Смотрите [Расширенный контекст](/ru/model-config#extended-context) для доступности по плану и как выбрать вариант модели `[1m]`. Sonnet 5 работает при 1M без варианта `[1m]` для выбора; смотрите [Контекстное окно Sonnet 5](/ru/model-config#sonnet-5-context-window) для его пороговых значений автокомпактирования и исключения шлюза LLM. Компактирование работает так же при большем лимите.1618Если вам нужно большее окно, а не меньший разговор, Fable 5, Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают контекстное окно в 1 миллион токенов. Смотрите [Расширенный контекст](/docs/ru/model-config#extended-context) для доступности по плану и как выбрать вариант модели `[1m]`. Sonnet 5 работает при 1M без варианта `[1m]` для выбора; смотрите [Контекстное окно Sonnet 5](/docs/ru/model-config#sonnet-5-context-window) для его пороговых значений автокомпактирования и исключения шлюза LLM. Компактирование работает так же при большем лимите.

1619 1619 

1620<h2 id="check-your-own-session">1620<h2 id="check-your-own-session">

1621 Проверьте свой собственный сеанс1621 Проверьте свой собственный сеанс


1629 1629 

1630Для более глубокого охвата функций, показанных на временной шкале, смотрите эти страницы:1630Для более глубокого охвата функций, показанных на временной шкале, смотрите эти страницы:

1631 1631 

1632* [Расширьте Claude Code](/ru/features-overview): когда использовать CLAUDE.md против skills против правил против hooks против MCP1632* [Расширьте Claude Code](/docs/ru/features-overview): когда использовать CLAUDE.md против skills против правил против hooks против MCP

1633* [Сохраняйте инструкции и воспоминания](/ru/memory): иерархия CLAUDE.md и автоматическая память1633* [Сохраняйте инструкции и воспоминания](/docs/ru/memory): иерархия CLAUDE.md и автоматическая память

1634* [Subagents](/ru/sub-agents): делегируйте исследование отдельному контекстному окну1634* [Subagents](/docs/ru/sub-agents): делегируйте исследование отдельному контекстному окну

1635* [Лучшие практики](/ru/best-practices): управление контекстом как вашим основным ограничением1635* [Лучшие практики](/docs/ru/best-practices): управление контекстом как вашим основным ограничением

1636* [Prompt caching](/ru/prompt-caching): какие действия инвалидируют кэшированный префикс1636* [Prompt caching](/docs/ru/prompt-caching): какие действия инвалидируют кэшированный префикс

1637* [Снизьте использование токенов](/ru/costs#reduce-token-usage): стратегии для поддержания низкого использования контекста1637* [Снизьте использование токенов](/docs/ru/costs#reduce-token-usage): стратегии для поддержания низкого использования контекста

Details

8 8 

9Когда Claude игнорирует инструкцию или функция, которую вы настроили, не появляется, причина обычно в том, что файл не загрузился, загрузился из другого места, чем вы ожидали, или его переопределил другой файл. Это руководство показывает, как проверить, что Claude Code действительно загрузил, чтобы вы могли сузить, какой из этих вариантов применяется.9Когда Claude игнорирует инструкцию или функция, которую вы настроили, не появляется, причина обычно в том, что файл не загрузился, загрузился из другого места, чем вы ожидали, или его переопределил другой файл. Это руководство показывает, как проверить, что Claude Code действительно загрузил, чтобы вы могли сузить, какой из этих вариантов применяется.

10 10 

11Для проблем с установкой, аутентификацией и подключением см. [Troubleshooting установки и входа](/ru/troubleshoot-install) вместо этого.11Для проблем с установкой, аутентификацией и подключением см. [Troubleshooting установки и входа](/docs/ru/troubleshoot-install) вместо этого.

12 12 

13<h2 id="see-what-loaded-into-context">13<h2 id="see-what-loaded-into-context">

14 Посмотрите, что загрузилось в контекст14 Посмотрите, что загрузилось в контекст


25| `/hooks` | Активные конфигурации hooks |25| `/hooks` | Активные конфигурации hooks |

26| `/mcp` | Подключённые MCP серверы и их статус |26| `/mcp` | Подключённые MCP серверы и их статус |

27| `/permissions` | Разрешённые и запрещённые правила, которые в настоящее время действуют |27| `/permissions` | Разрешённые и запрещённые правила, которые в настоящее время действуют |

28| `/doctor` | Диагностика конфигурации: здоровье установки, неверные файлы параметров, неиспользуемые расширения, дублирующиеся имена [subagent](/ru/sub-agents) в одной папке и проверенное содержимое `CLAUDE.md`, которое Claude может вывести из кодовой базы, с предложенными исправлениями |28| `/doctor` | Диагностика конфигурации: здоровье установки, неверные файлы параметров, неиспользуемые расширения, дублирующиеся имена [subagent](/docs/ru/sub-agents) в одной папке и проверенное содержимое `CLAUDE.md`, которое Claude может вывести из кодовой базы, с предложенными исправлениями |

29| `/debug [issue]` | Включает логирование отладки для сессии и предлагает Claude диагностировать, используя вывод журнала и пути параметров |29| `/debug [issue]` | Включает логирование отладки для сессии и предлагает Claude диагностировать, используя вывод журнала и пути параметров |

30| `/status` | Активные источники параметров, включая то, действуют ли управляемые параметры |30| `/status` | Активные источники параметров, включая то, действуют ли управляемые параметры |

31 31 

32Если файл памяти отсутствует в `/memory`, проверьте его расположение в соответствии с [как загружаются файлы CLAUDE.md](/ru/memory#how-claude-md-files-load). Файлы `CLAUDE.md` в подпапках загружаются по требованию, когда Claude читает файл в этой папке с помощью инструмента Read, а не при запуске сессии.32Если файл памяти отсутствует в `/memory`, проверьте его расположение в соответствии с [как загружаются файлы CLAUDE.md](/docs/ru/memory#how-claude-md-files-load). Файлы `CLAUDE.md` в подпапках загружаются по требованию, когда Claude читает файл в этой папке с помощью инструмента Read, а не при запуске сессии.

33 33 

34Если `/memory` подтверждает, что файл загрузился, но Claude всё ещё не следует конкретной инструкции, проблема, вероятно, в том, как написана инструкция, а не в том, загрузилась ли она. CLAUDE.md хорошо работает для типов рекомендаций, которые вы дали бы новому коллеге, таких как соглашения проекта, команды сборки и где находятся файлы.34Если `/memory` подтверждает, что файл загрузился, но Claude всё ещё не следует конкретной инструкции, проблема, вероятно, в том, как написана инструкция, а не в том, загрузилась ли она. CLAUDE.md хорошо работает для типов рекомендаций, которые вы дали бы новому коллеге, таких как соглашения проекта, команды сборки и где находятся файлы.

35 35 

36Соответствие снижается, когда инструкция достаточно расплывчата, чтобы интерпретировать несколькими способами, когда два файла дают противоречивые указания или когда файл вырос настолько, что отдельные правила получают меньше внимания. [Напишите эффективные инструкции](/ru/memory#write-effective-instructions) охватывает специфичность, размер и структурные паттерны, которые поддерживают высокое соответствие.36Соответствие снижается, когда инструкция достаточно расплывчата, чтобы интерпретировать несколькими способами, когда два файла дают противоречивые указания или когда файл вырос настолько, что отдельные правила получают меньше внимания. [Напишите эффективные инструкции](/docs/ru/memory#write-effective-instructions) охватывает специфичность, размер и структурные паттерны, которые поддерживают высокое соответствие.

37 37 

38<Note>38<Note>

39 CLAUDE.md и permissions решают разные проблемы. CLAUDE.md говорит Claude, как работает ваш проект, чтобы он принимал хорошие решения. [Permissions](/ru/permissions) и [hooks](/ru/hooks) обеспечивают ограничения независимо от того, что решит Claude. Используйте CLAUDE.md для "мы делаем это так здесь". Используйте permissions или hooks для границ безопасности и всего, что никогда не должно происходить, когда вам нужна гарантия вместо рекомендации.39 CLAUDE.md и permissions решают разные проблемы. CLAUDE.md говорит Claude, как работает ваш проект, чтобы он принимал хорошие решения. [Permissions](/docs/ru/permissions) и [hooks](/docs/ru/hooks) обеспечивают ограничения независимо от того, что решит Claude. Используйте CLAUDE.md для "мы делаем это так здесь". Используйте permissions или hooks для границ безопасности и всего, что никогда не должно происходить, когда вам нужна гарантия вместо рекомендации.

40</Note>40</Note>

41 41 

42<h2 id="check-resolved-settings">42<h2 id="check-resolved-settings">

43 Проверьте разрешённые параметры43 Проверьте разрешённые параметры

44</h2>44</h2>

45 45 

46Параметры объединяются в управляемых, пользовательских, проектных и локальных областях. Управляемые параметры всегда выигрывают, когда присутствуют. Среди остальных, более близкая область переопределяет более широкую в порядке локальная, затем проект, затем пользователь. Некоторые параметры также можно устанавливать флагами командной строки или [переменными окружения](/ru/env-vars), которые действуют как ещё один слой переопределения. Когда параметр не кажется применяемым, значение, которое вы установили, обычно переопределяется другой областью или переменной окружения.46Параметры объединяются в управляемых, пользовательских, проектных и локальных областях. Управляемые параметры всегда выигрывают, когда присутствуют. Среди остальных, более близкая область переопределяет более широкую в порядке локальная, затем проект, затем пользователь. Некоторые параметры также можно устанавливать флагами командной строки или [переменными окружения](/docs/ru/env-vars), которые действуют как ещё один слой переопределения. Когда параметр не кажется применяемым, значение, которое вы установили, обычно переопределяется другой областью или переменной окружения.

47 47 

48Запустите `/doctor`, чтобы проверить вашу конфигурацию и установку. Он сообщает о том, что находит, включая неверные файлы параметров, дублирующиеся установки, неиспользуемые расширения и {/* min-version: 2.1.206 */}проверенное содержимое `CLAUDE.md`, которое Claude может вывести из кодовой базы, затем предлагает исправления, которые применяет только после вашего подтверждения. Проверка обрезки `CLAUDE.md` требует Claude Code v2.1.206 или позже. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения, и нажатие `f` отправляло отчёт Claude для исправления.48Запустите `/doctor`, чтобы проверить вашу конфигурацию и установку. Он сообщает о том, что находит, включая неверные файлы параметров, дублирующиеся установки, неиспользуемые расширения и проверенное содержимое `CLAUDE.md`, которое Claude может вывести из кодовой базы, затем предлагает исправления, которые применяет только после вашего подтверждения. Проверка обрезки `CLAUDE.md` требует Claude Code v2.1.206 или позже. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения, и нажатие `f` отправляло отчёт Claude для исправления.

49 49 

50Из терминала `claude doctor` выводит диагностику установки и параметров только для чтения без запуска сеанса.50Из терминала `claude doctor` выводит диагностику установки и параметров только для чтения без запуска сеанса.

51 51 

52Запустите `/status`, чтобы увидеть, какие источники параметров активны, включая то, действуют ли управляемые параметры. Чтобы понять, какая область выигрывает для данного ключа, см. [Как взаимодействуют области](/ru/settings#how-scopes-interact).52Запустите `/status`, чтобы увидеть, какие источники параметров активны, включая то, действуют ли управляемые параметры. Чтобы понять, какая область выигрывает для данного ключа, см. [Как взаимодействуют области](/docs/ru/settings#how-scopes-interact).

53 53 

54<h2 id="check-mcp-servers">54<h2 id="check-mcp-servers">

55 Проверьте MCP серверы55 Проверьте MCP серверы


61* Сервер, который не запускается, отображается как failed в `/mcp`. Относительные пути к файлам в `command` или `args` — частая причина, так как они разрешаются относительно каталога, из которого вы запустили Claude Code, а не расположения `.mcp.json`.61* Сервер, который не запускается, отображается как failed в `/mcp`. Относительные пути к файлам в `command` или `args` — частая причина, так как они разрешаются относительно каталога, из которого вы запустили Claude Code, а не расположения `.mcp.json`.

62* Сервер, который показывает как connected, но перечисляет нулевые tools, успешно запустился, но не возвращает список tools. Выберите **Reconnect** из `/mcp`. Если количество остаётся нулевым, запустите `claude --debug mcp`, чтобы увидеть вывод stderr сервера.62* Сервер, который показывает как connected, но перечисляет нулевые tools, успешно запустился, но не возвращает список tools. Выберите **Reconnect** из `/mcp`. Если количество остаётся нулевым, запустите `claude --debug mcp`, чтобы увидеть вывод stderr сервера.

63 63 

64Для расположений конфигурации и правил области см. [MCP](/ru/mcp).64Для расположений конфигурации и правил области см. [MCP](/docs/ru/mcp).

65 65 

66<h2 id="check-hooks">66<h2 id="check-hooks">

67 Проверьте hooks67 Проверьте hooks


71 71 

72Если hook появляется, но не срабатывает, обычно причина в matcher. Проверьте его на эти ошибки:72Если hook появляется, но не срабатывает, обычно причина в matcher. Проверьте его на эти ошибки:

73 73 

74* Поле `matcher` — это одна строка, которая использует `|` для соответствия нескольким именам tools, например `"Edit|Write"`. {/* min-version: 2.1.191 */}Разделитель `,` эквивалентен, поэтому `"Edit,Write"` соответствует тем же tools. До v2.1.191 запятая переходила к оценке regex и matcher никогда не совпадал, поэтому используйте `|`, если вы ещё не на v2.1.191.74* Поле `matcher` — это одна строка, которая использует `|` для соответствия нескольким именам tools, например `"Edit|Write"`. Разделитель `,` эквивалентен, поэтому `"Edit,Write"` соответствует тем же tools. До v2.1.191 запятая переходила к оценке regex и matcher никогда не совпадал, поэтому используйте `|`, если вы ещё не на v2.1.191.

75* Неправильное имя tool создаёт matcher, который ничему не соответствует, поэтому hook молча не срабатывает.75* Неправильное имя tool создаёт matcher, который ничему не соответствует, поэтому hook молча не срабатывает.

76* Значение массива — это ошибка схемы: Claude Code показывает уведомление об ошибке параметров и отклоняет весь файл параметров пользователя, проекта или локальных параметров, `claude doctor` сообщает об ошибке валидации, и ни один hook из этого файла не появляется в `/hooks`. В [управляемых параметрах](/ru/settings#settings-files) удаляется только неправильная запись, и другие hooks из этого файла всё ещё применяются.76* Значение массива — это ошибка схемы: Claude Code показывает уведомление об ошибке параметров и отклоняет весь файл параметров пользователя, проекта или локальных параметров, `claude doctor` сообщает об ошибке валидации, и ни один hook из этого файла не появляется в `/hooks`. В [управляемых параметрах](/docs/ru/settings#settings-files) удаляется только неправильная запись, и другие hooks из этого файла всё ещё применяются.

77 77 

78Правки в `settings.json` вступают в силу в работающей сессии после краткой задержки стабильности файла. Вам не нужно перезагружаться. Если `/hooks` всё ещё показывает старое определение через несколько секунд после сохранения, запустите `/hooks` снова, чтобы обновить представление.78Правки в `settings.json` вступают в силу в работающей сессии после краткой задержки стабильности файла. Вам не нужно перезагружаться. Если `/hooks` всё ещё показывает старое определение через несколько секунд после сохранения, запустите `/hooks` снова, чтобы обновить представление.

79 79 

80Если `/hooks` показывает hook, но он всё ещё не срабатывает, следующий шаг — наблюдать оценку hook в реальном времени. Запустите сессию с `claude --debug hooks` и вызовите tool call. Журнал отладки записывает каждое событие, какие matchers были проверены, и код выхода и вывод hook. См. [Debug hooks](/ru/hooks#debug-hooks) для формата журнала и [hooks troubleshooting](/ru/hooks-guide#limitations-and-troubleshooting) для распространённых паттернов сбоев.80Если `/hooks` показывает hook, но он всё ещё не срабатывает, следующий шаг — наблюдать оценку hook в реальном времени. Запустите сессию с `claude --debug hooks` и вызовите tool call. Журнал отладки записывает каждое событие, какие matchers были проверены, и код выхода и вывод hook. См. [Debug hooks](/docs/ru/hooks#debug-hooks) для формата журнала и [hooks troubleshooting](/docs/ru/hooks-guide#limitations-and-troubleshooting) для распространённых паттернов сбоев.

81 81 

82<h2 id="test-against-a-clean-configuration">82<h2 id="test-against-a-clean-configuration">

83 Протестируйте с чистой конфигурацией83 Протестируйте с чистой конфигурацией

84</h2>84</h2>

85 85 

86{/* min-version: 2.1.169 */}Начните с [`claude --safe-mode`](/ru/cli-reference#cli-flags), который запускает сессию со всеми отключёнными настройками, включая `CLAUDE.md`, skills, plugins, hooks, MCP серверы и пользовательские команды и агенты. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально. Если проблема исчезает в безопасном режиме, одна из этих поверхностей является причиной; используйте целевые проверки выше, чтобы найти, какая именно. Безопасный режим по-прежнему применяет управляемые hooks и политику параметров от вашей организации. Управляемые plugins, skills, `CLAUDE.md` и MCP серверы отключены.86Начните с [`claude --safe-mode`](/docs/ru/cli-reference#cli-flags), который запускает сессию со всеми отключёнными настройками, включая `CLAUDE.md`, skills, plugins, hooks, MCP серверы и пользовательские команды и агенты. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально. Если проблема исчезает в безопасном режиме, одна из этих поверхностей является причиной; используйте целевые проверки выше, чтобы найти, какая именно. Безопасный режим по-прежнему применяет управляемые hooks и политику параметров от вашей организации. Управляемые plugins, skills, `CLAUDE.md` и MCP серверы отключены.

87 87 

88Если проблема сохраняется в безопасном режиме или ваши параметры сами по себе вызывают подозрения, сравните с сессией, которая ничего не загружает из вашей обычной установки. Укажите [`CLAUDE_CONFIG_DIR`](/ru/env-vars) на пустой каталог, чтобы обойти всё под `~/.claude`, и запустите из каталога, который не имеет папки `.claude`, файла `.mcp.json` или `CLAUDE.md`, чтобы конфигурация проекта также была пропущена.88Если проблема сохраняется в безопасном режиме или ваши параметры сами по себе вызывают подозрения, сравните с сессией, которая ничего не загружает из вашей обычной установки. Укажите [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) на пустой каталог, чтобы обойти всё под `~/.claude`, и запустите из каталога, который не имеет папки `.claude`, файла `.mcp.json` или `CLAUDE.md`, чтобы конфигурация проекта также была пропущена.

89 89 

90```bash theme={null}90```bash theme={null}

91cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude91cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude


97* На Linux и Windows вам будет предложено войти снова, потому что учётные данные хранятся в каталоге конфигурации97* На Linux и Windows вам будет предложено войти снова, потому что учётные данные хранятся в каталоге конфигурации

98* На macOS учётные данные находятся в Keychain и переносятся в чистую сессию98* На macOS учётные данные находятся в Keychain и переносятся в чистую сессию

99 99 

100Если проблема исчезает здесь, причина находится где-то в ваших реальных файлах `~/.claude` или проекта `.claude`. Переинтродуцируйте их по одному, скопировав файлы во временный каталог или запустив из вашего проекта, чтобы найти, какой из них. Если это сохраняется в чистой сессии, причина находится вне вашей пользовательской и проектной конфигурации. Запустите `/status`, чтобы проверить, действуют ли управляемые параметры, ищите [переменные окружения](/ru/env-vars), которые влияют на Claude Code, затем см. [Troubleshooting](/ru/troubleshooting).100Если проблема исчезает здесь, причина находится где-то в ваших реальных файлах `~/.claude` или проекта `.claude`. Переинтродуцируйте их по одному, скопировав файлы во временный каталог или запустив из вашего проекта, чтобы найти, какой из них. Если это сохраняется в чистой сессии, причина находится вне вашей пользовательской и проектной конфигурации. Запустите `/status`, чтобы проверить, действуют ли управляемые параметры, ищите [переменные окружения](/docs/ru/env-vars), которые влияют на Claude Code, затем см. [Troubleshooting](/docs/ru/troubleshooting).

101 101 

102<h2 id="check-common-causes">102<h2 id="check-common-causes">

103 Проверьте распространённые причины103 Проверьте распространённые причины


107 107 

108| Симптом | Причина | Исправление |108| Симптом | Причина | Исправление |

109| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |109| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

110| Hook никогда не срабатывает | `matcher` — это JSON массив вместо строки | Используйте одну строку с `\|` для соответствия нескольким tools, например `"Edit\|Write"`. См. [matcher patterns](/ru/hooks#matcher-patterns). |110| Hook никогда не срабатывает | `matcher` — это JSON массив вместо строки | Используйте одну строку с `\|` для соответствия нескольким tools, например `"Edit\|Write"`. См. [matcher patterns](/docs/ru/hooks#matcher-patterns). |

111| Hook никогда не срабатывает | `matcher` использует `,` как разделитель в версии до v2.1.191 | {/* min-version: 2.1.191 */}Claude Code v2.1.191 или позже рассматривает `,` как разделитель списка, как `\|`. Более ранние версии оценивают запятую как буквальный символ, поэтому `"Edit,Write"` ничему не соответствует. Используйте `\|` вместо этого или обновите Claude Code. |111| Hook никогда не срабатывает | `matcher` использует `,` как разделитель в версии до v2.1.191 | Claude Code v2.1.191 или позже рассматривает `,` как разделитель списка, как `\|`. Более ранние версии оценивают запятую как буквальный символ, поэтому `"Edit,Write"` ничему не соответствует. Используйте `\|` вместо этого или обновите Claude Code. |

112| Hook никогда не срабатывает | значение `matcher` в нижнем регистре, например `"bash"` | Соответствие чувствительно к регистру. Имена tools написаны с заглавной буквы: `Bash`, `Edit`, `Write`, `Read`. |112| Hook никогда не срабатывает | значение `matcher` в нижнем регистре, например `"bash"` | Соответствие чувствительно к регистру. Имена tools написаны с заглавной буквы: `Bash`, `Edit`, `Write`, `Read`. |

113| Hook никогда не срабатывает | Hooks находятся в отдельном файле вместо `settings.json` | Нет отдельного файла hooks для конфигурации проекта или пользователя. Определите hooks под ключом `"hooks"` в `settings.json`. Только [plugins](/ru/plugins-reference#hooks) загружают отдельный `hooks/hooks.json`. См. [hook configuration](/ru/hooks). |113| Hook никогда не срабатывает | Hooks находятся в отдельном файле вместо `settings.json` | Нет отдельного файла hooks для конфигурации проекта или пользователя. Определите hooks под ключом `"hooks"` в `settings.json`. Только [plugins](/docs/ru/plugins-reference#hooks) загружают отдельный `hooks/hooks.json`. См. [hook configuration](/docs/ru/hooks). |

114| Permissions, hooks или env, установленные глобально, игнорируются | Конфигурация была добавлена в `~/.claude.json` | `~/.claude.json` содержит состояние приложения и переключатели UI. `permissions`, `hooks` и `env` принадлежат `~/.claude/settings.json`. Это два разных файла. |114| Permissions, hooks или env, установленные глобально, игнорируются | Конфигурация была добавлена в `~/.claude.json` | `~/.claude.json` содержит состояние приложения и переключатели UI. `permissions`, `hooks` и `env` принадлежат `~/.claude/settings.json`. Это два разных файла. |

115| Значение `settings.json` кажется игнорируемым | Тот же ключ установлен в `settings.local.json` | `settings.local.json` переопределяет `settings.json`, и оба переопределяют `~/.claude/settings.json`. См. [settings precedence](/ru/settings#how-scopes-interact). |115| Значение `settings.json` кажется игнорируемым | Тот же ключ установлен в `settings.local.json` | `settings.local.json` переопределяет `settings.json`, и оба переопределяют `~/.claude/settings.json`. См. [settings precedence](/docs/ru/settings#how-scopes-interact). |

116| Skill не появляется в `/skills` | Файл skill находится в `.claude/skills/name.md` вместо папки | Используйте папку с `SKILL.md` внутри: `.claude/skills/name/SKILL.md`. |116| Skill не появляется в `/skills` | Файл skill находится в `.claude/skills/name.md` вместо папки | Используйте папку с `SKILL.md` внутри: `.claude/skills/name/SKILL.md`. |

117| Skill появляется в `/skills`, но Claude никогда его не вызывает | Skill имеет `disable-model-invocation: true` в своём frontmatter или его описание не совпадает с тем, как вы формулируете запрос | Проверьте значок в `/skills`: метка "user-only" означает, что Claude не будет его запускать самостоятельно. См. [skill invocation](/ru/skills). |117| Skill появляется в `/skills`, но Claude никогда его не вызывает | Skill имеет `disable-model-invocation: true` в своём frontmatter или его описание не совпадает с тем, как вы формулируете запрос | Проверьте значок в `/skills`: метка "user-only" означает, что Claude не будет его запускать самостоятельно. См. [skill invocation](/docs/ru/skills). |

118| Инструкции в подпапке `CLAUDE.md` кажутся игнорируемыми | Файлы подпапок загружаются по требованию, а не при запуске сессии | Они загружаются, когда Claude читает файл в этой папке с помощью инструмента Read, а не при запуске и не при записи или создании файлов там. См. [как загружаются файлы CLAUDE.md](/ru/memory#how-claude-md-files-load). |118| Инструкции в подпапке `CLAUDE.md` кажутся игнорируемыми | Файлы подпапок загружаются по требованию, а не при запуске сессии | Они загружаются, когда Claude читает файл в этой папке с помощью инструмента Read, а не при запуске и не при записи или создании файлов там. См. [как загружаются файлы CLAUDE.md](/docs/ru/memory#how-claude-md-files-load). |

119| Subagent игнорирует инструкции `CLAUDE.md` | Встроенные агенты Explore и Plan пропускают `CLAUDE.md`. Пользовательские subagents загружают его так же, как основной диалог | Для Explore или Plan переформулируйте инструкцию в своём делегирующем prompt. Для пользовательского subagent поместите критические инструкции в тело файла агента, которое становится системным prompt агента. См. [что загружается при запуске](/ru/sub-agents#what-loads-at-startup). |119| Subagent игнорирует инструкции `CLAUDE.md` | Встроенные агенты Explore и Plan пропускают `CLAUDE.md`. Пользовательские subagents загружают его так же, как основной диалог | Для Explore или Plan переформулируйте инструкцию в своём делегирующем prompt. Для пользовательского subagent поместите критические инструкции в тело файла агента, которое становится системным prompt агента. См. [что загружается при запуске](/docs/ru/sub-agents#what-loads-at-startup). |

120| Логика очистки никогда не запускается в конце сессии | Нет настроенного `SessionEnd` hook | Добавьте `SessionEnd` hook в `settings.json`. См. [hook events list](/ru/hooks#hook-events). |120| Логика очистки никогда не запускается в конце сессии | Нет настроенного `SessionEnd` hook | Добавьте `SessionEnd` hook в `settings.json`. См. [hook events list](/docs/ru/hooks#hook-events). |

121| MCP серверы в `.mcp.json` никогда не загружаются | Файл находится под `.claude/` или использует формат конфигурации Claude Desktop | Конфигурация MCP проекта находится в корне репозитория как `.mcp.json`, а не внутри `.claude/`. См. [MCP configuration](/ru/mcp). |121| MCP серверы в `.mcp.json` никогда не загружаются | Файл находится под `.claude/` или использует формат конфигурации Claude Desktop | Конфигурация MCP проекта находится в корне репозитория как `.mcp.json`, а не внутри `.claude/`. См. [MCP configuration](/docs/ru/mcp). |

122| MCP серверы добавлены под `mcpServers` в `settings.json`, но никогда не появляются | `settings.json` не читает ключ `mcpServers` | Определите серверы проекта в `.mcp.json` в корне репозитория или запустите `claude mcp add --scope user` для серверов с областью пользователя. См. [MCP configuration](/ru/mcp). |122| MCP серверы добавлены под `mcpServers` в `settings.json`, но никогда не появляются | `settings.json` не читает ключ `mcpServers` | Определите серверы проекта в `.mcp.json` в корне репозитория или запустите `claude mcp add --scope user` для серверов с областью пользователя. См. [MCP configuration](/docs/ru/mcp). |

123| Добавлен MCP сервер проекта, но не появляется | Prompt одноразового одобрения был отклонён | Серверы с областью проекта требуют одобрения. Запустите `/mcp`, чтобы увидеть статус и одобрить. |123| Добавлен MCP сервер проекта, но не появляется | Prompt одноразового одобрения был отклонён | Серверы с областью проекта требуют одобрения. Запустите `/mcp`, чтобы увидеть статус и одобрить. |

124| MCP сервер не запускается из некоторых каталогов | `command` или `args` использует относительный путь к файлу | Используйте абсолютные пути для локальных скриптов. Исполняемые файлы в вашем `PATH` как `npx` или `uvx` работают как есть. |124| MCP сервер не запускается из некоторых каталогов | `command` или `args` использует относительный путь к файлу | Используйте абсолютные пути для локальных скриптов. Исполняемые файлы в вашем `PATH` как `npx` или `uvx` работают как есть. |

125| MCP сервер запускается без ожидаемых переменных окружения | Переменные находятся в `settings.json` `env`, которые не распространяются на дочерние процессы MCP | Установите `env` для каждого сервера внутри `.mcp.json`. |125| MCP сервер запускается без ожидаемых переменных окружения | Переменные находятся в `settings.json` `env`, которые не распространяются на дочерние процессы MCP | Установите `env` для каждого сервера внутри `.mcp.json`. |

126| Правило отрицания `Bash(rm *)` не блокирует `/bin/rm` или `find -delete` | Правила префикса совпадают с буквальной строкой команды, а не с базовым исполняемым файлом | Добавьте явные паттерны для каждого варианта или используйте [PreToolUse hook](/ru/hooks-guide) или [sandbox](/ru/sandboxing) для жёсткой гарантии. |126| Правило отрицания `Bash(rm *)` не блокирует `/bin/rm` или `find -delete` | Правила префикса совпадают с буквальной строкой команды, а не с базовым исполняемым файлом | Добавьте явные паттерны для каждого варианта или используйте [PreToolUse hook](/docs/ru/hooks-guide) или [sandbox](/docs/ru/sandboxing) для жёсткой гарантии. |

127 127 

128<h2 id="related-resources">128<h2 id="related-resources">

129 Связанные ресурсы129 Связанные ресурсы


131 131 

132Для полного справочника по каждой поверхности конфигурации см. специализированную страницу:132Для полного справочника по каждой поверхности конфигурации см. специализированную страницу:

133 133 

134* **[Справочник каталога `.claude`](/ru/claude-directory)**: каждое расположение файла конфигурации и что его читает134* **[Справочник каталога `.claude`](/docs/ru/claude-directory)**: каждое расположение файла конфигурации и что его читает

135* **[Settings](/ru/settings)**: порядок приоритета и полный список ключей135* **[Settings](/docs/ru/settings)**: порядок приоритета и полный список ключей

136* **[Справочник Hooks](/ru/hooks)**: имена событий, payload и формат вывода `--debug hooks`136* **[Справочник Hooks](/docs/ru/hooks)**: имена событий, payload и формат вывода `--debug hooks`

137* **[MCP](/ru/mcp)**: конфигурация сервера, одобрение и вывод `/mcp`137* **[MCP](/docs/ru/mcp)**: конфигурация сервера, одобрение и вывод `/mcp`

138* **[Troubleshooting установки и входа](/ru/troubleshoot-install)**: `command not found`, PATH и проблемы аутентификации138* **[Troubleshooting установки и входа](/docs/ru/troubleshoot-install)**: `command not found`, PATH и проблемы аутентификации

139* **[Troubleshooting](/ru/troubleshooting)**: производительность, зависания и проблемы поиска139* **[Troubleshooting](/docs/ru/troubleshooting)**: производительность, зависания и проблемы поиска

desktop.md +72 −72

Details

17 For x64 processors17 For x64 processors

18 </Card>18 </Card>

19 19 

20 <Card title="Get Claude for Linux (beta)" icon="linux" href="/en/desktop-linux">20 <Card title="Get Claude for Linux (beta)" icon="linux" href="/docs/en/desktop-linux">

21 apt or .deb for Ubuntu and Debian21 apt or .deb for Ubuntu and Debian

22 </Card>22 </Card>

23</CardGroup>23</CardGroup>

24 24 

25For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). On Linux, install with apt; see [Claude Desktop on Linux](/en/desktop-linux).25For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). On Linux, install with apt; see [Claude Desktop on Linux](/docs/en/desktop-linux).

26 26 

27После установки запустите Claude, войдите в систему и нажмите на вкладку **Code**. Первый раз при открытии на Windows вам необходимо установить [Git for Windows](https://git-scm.com/downloads/win); перезагрузите приложение после установки. Для пошагового руководства вашего первого сеанса см. [Руководство по началу работы](/ru/desktop-quickstart).27После установки запустите Claude, войдите в систему и нажмите на вкладку **Code**. Первый раз при открытии на Windows вам необходимо установить [Git for Windows](https://git-scm.com/downloads/win); перезагрузите приложение после установки. Для пошагового руководства вашего первого сеанса см. [Руководство по началу работы](/docs/ru/desktop-quickstart).

28 28 

29На вкладке Code каждый разговор является **сеансом**: он имеет свою историю чата, папку проекта и изменения кода, независимые от любого другого сеанса. Боковая панель отображает ваши сеансы и позволяет запускать несколько параллельно. В рамках сеанса вы можете:29На вкладке Code каждый разговор является **сеансом**: он имеет свою историю чата, папку проекта и изменения кода, независимые от любого другого сеанса. Боковая панель отображает ваши сеансы и позволяет запускать несколько параллельно. В рамках сеанса вы можете:

30 30 


36* Позволить Claude [открывать приложения и управлять вашим экраном](#let-claude-use-your-computer)36* Позволить Claude [открывать приложения и управлять вашим экраном](#let-claude-use-your-computer)

37* Запускать на вашей машине, в [облаке](#run-long-running-tasks-remotely) или через [SSH](#ssh-sessions)37* Запускать на вашей машине, в [облаке](#run-long-running-tasks-remotely) или через [SSH](#ssh-sessions)

38 38 

39Для [запланированной повторяющейся работы](/ru/desktop-scheduled-tasks), [сочетаний клавиш](#keyboard-shortcuts) или [отправки задач со своего телефона](#sessions-from-dispatch) см. связанные страницы и разделы. Если вы уже используете терминальный CLI, см. [сравнение CLI](#coming-from-the-cli) для того, что переносится.39Для [запланированной повторяющейся работы](/docs/ru/desktop-scheduled-tasks), [сочетаний клавиш](#keyboard-shortcuts) или [отправки задач со своего телефона](#sessions-from-dispatch) см. связанные страницы и разделы. Если вы уже используете терминальный CLI, см. [сравнение CLI](#coming-from-the-cli) для того, что переносится.

40 40 

41<h2 id="start-a-session">41<h2 id="start-a-session">

42 Начало сеанса42 Начало сеанса


44 44 

45Перед отправкой первого сообщения настройте четыре параметра в области подсказки:45Перед отправкой первого сообщения настройте четыре параметра в области подсказки:

46 46 

47* **Environment**: выберите, где запускается Claude. Выберите **Local** для вашей машины, **Remote** для облачных сеансов, размещённых Anthropic, [**SSH-соединение**](#ssh-sessions) для удалённой машины, которой вы управляете, или на Windows [**WSL-дистрибутив**](/ru/desktop-wsl). См. [конфигурация окружения](#environment-configuration).47* **Environment**: выберите, где запускается Claude. Выберите **Local** для вашей машины, **Remote** для облачных сеансов, размещённых Anthropic, [**SSH-соединение**](#ssh-sessions) для удалённой машины, которой вы управляете, или на Windows [**WSL-дистрибутив**](/docs/ru/desktop-wsl). См. [конфигурация окружения](#environment-configuration).

48* **Project folder**: выберите папку или репозиторий, с которым работает Claude. Для облачных сеансов вы можете добавить [несколько репозиториев](#run-long-running-tasks-remotely).48* **Project folder**: выберите папку или репозиторий, с которым работает Claude. Для облачных сеансов вы можете добавить [несколько репозиториев](#run-long-running-tasks-remotely).

49* **Model**: выберите [модель](/ru/model-config#available-models) из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить это во время сеанса.49* **Model**: выберите [модель](/docs/ru/model-config#available-models) из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить это во время сеанса.

50* **Permission mode**: выберите, сколько автономности имеет Claude, из [селектора режима](#choose-a-permission-mode). Вы можете изменить это во время сеанса.50* **Permission mode**: выберите, сколько автономности имеет Claude, из [селектора режима](#choose-a-permission-mode). Вы можете изменить это во время сеанса.

51 51 

52Введите вашу задачу и нажмите **Enter** для начала. Каждый сеанс отслеживает свой собственный контекст и изменения независимо.52Введите вашу задачу и нажмите **Enter** для начала. Каждый сеанс отслеживает свой собственный контекст и изменения независимо.


80 80 

81Режимы разрешений контролируют, сколько автономности имеет Claude во время сеанса: спрашивает ли он перед редактированием файлов, запуском команд или обоих. Вы можете переключать режимы в любое время, используя селектор режима рядом с кнопкой отправки. Начните с Manual, чтобы увидеть ровно то, что делает Claude, затем переходите к Accept edits или Plan по мере того, как вы становитесь более уверены.81Режимы разрешений контролируют, сколько автономности имеет Claude во время сеанса: спрашивает ли он перед редактированием файлов, запуском команд или обоих. Вы можете переключать режимы в любое время, используя селектор режима рядом с кнопкой отправки. Начните с Manual, чтобы увидеть ровно то, что делает Claude, затем переходите к Accept edits или Plan по мере того, как вы становитесь более уверены.

82 82 

83Чтобы установить режим по умолчанию для новых локальных сеансов, добавьте `permissions.defaultMode` в ваш [файл параметров](/ru/settings#settings-files). Приложение для рабочего стола читает те же файлы параметров, что и CLI. Режим, который вы выбираете в селекторе, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки, кроме Plan, который применяется только к текущему сеансу.83Чтобы установить режим по умолчанию для новых локальных сеансов, добавьте `permissions.defaultMode` в ваш [файл параметров](/docs/ru/settings#settings-files). Приложение для рабочего стола читает те же файлы параметров, что и CLI. Режим, который вы выбираете в селекторе, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки, кроме Plan, который применяется только к текущему сеансу.

84 84 

85| Режим | Ключ параметров | Поведение |85| Режим | Ключ параметров | Поведение |

86| ---------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |86| ---------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


88| **Accept edits** | `acceptEdits` | Claude автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch` и `mv`, но всё ещё спрашивает перед запуском других команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию. |88| **Accept edits** | `acceptEdits` | Claude автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch` и `mv`, но всё ещё спрашивает перед запуском других команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию. |

89| **Plan** | `plan` | Claude читает файлы и запускает команды для исследования, затем предлагает план без редактирования вашего исходного кода. Хорошо для сложных задач, где вы хотите сначала проверить подход. |89| **Plan** | `plan` | Claude читает файлы и запускает команды для исследования, затем предлагает план без редактирования вашего исходного кода. Хорошо для сложных задач, где вы хотите сначала проверить подход. |

90| **Auto** | `auto` | Claude выполняет все действия с фоновыми проверками безопасности, которые проверяют соответствие вашему запросу. Снижает подсказки разрешений при сохранении надзора. Появляется, когда ваша учётная запись соответствует [требованиям доступности](#auto-mode-availability) ниже; отдельного переключателя Settings для этого нет. |90| **Auto** | `auto` | Claude выполняет все действия с фоновыми проверками безопасности, которые проверяют соответствие вашему запросу. Снижает подсказки разрешений при сохранении надзора. Появляется, когда ваша учётная запись соответствует [требованиям доступности](#auto-mode-availability) ниже; отдельного переключателя Settings для этого нет. |

91| **Bypass permissions** | `bypassPermissions` | Claude работает без подсказок разрешений, кроме тех, которые вынуждены явными [правилами запроса](/ru/permissions#manage-permissions), инструментами коннектора [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools), инструментами MCP, отмеченными [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), или классификаторами безопасности, когда Claude [действует на внешних сайтах](#browse-external-sites); эквивалентно `--dangerously-skip-permissions` в CLI. На планах Pro и Max включите это в Settings → Claude Code под "Allow bypass permissions mode"; на планах Team и Enterprise нет переключателя Settings, и политика организации контролирует это вместо этого. Используйте только в изолированных контейнерах или виртуальных машинах. |91| **Bypass permissions** | `bypassPermissions` | Claude работает без подсказок разрешений, кроме тех, которые вынуждены явными [правилами запроса](/docs/ru/permissions#manage-permissions), инструментами коннектора [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools), инструментами MCP, отмеченными [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), или классификаторами безопасности, когда Claude [действует на внешних сайтах](#browse-external-sites); эквивалентно `--dangerously-skip-permissions` в CLI. На планах Pro и Max включите это в Settings → Claude Code под "Allow bypass permissions mode"; на планах Team и Enterprise нет переключателя Settings, и политика организации контролирует это вместо этого. Используйте только в изолированных контейнерах или виртуальных машинах. |

92 92 

93Более ранние версии вкладки Code обозначали эти режимы как Ask permissions, Auto accept edits и Plan mode.93Более ранние версии вкладки Code обозначали эти режимы как Ask permissions, Auto accept edits и Plan mode.

94 94 

95Режим разрешений `dontAsk` доступен только в [CLI](/ru/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).95Режим разрешений `dontAsk` доступен только в [CLI](/docs/ru/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).

96 96 

97<span id="auto-mode-availability" />97<span id="auto-mode-availability" />

98 98 

99Auto mode доступен всем пользователям на Anthropic API и требует Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. Администраторы организации могут отключить auto mode с помощью ключа `disableAutoMode` в [управляемых параметрах](#managed-settings).99Auto mode доступен всем пользователям на Anthropic API и требует Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. Администраторы организации могут отключить auto mode с помощью ключа `disableAutoMode` в [управляемых параметрах](#managed-settings).

100 100 

101В развёртываниях Enterprise, которые маршрутизируют Desktop на Google Cloud's Agent Platform, auto mode [доступен по умолчанию](/ru/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), и там поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8. {/* min-version: 2.1.207 */}До Claude Code v2.1.207 развёртывания Enterprise на Google Cloud's Agent Platform должны были установить `CLAUDE_CODE_ENABLE_AUTO_MODE` для включения auto mode.101В развёртываниях Enterprise, которые маршрутизируют Desktop на Google Cloud's Agent Platform, auto mode [доступен по умолчанию](/docs/ru/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), и там поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8. До Claude Code v2.1.207 развёртывания Enterprise на Google Cloud's Agent Platform должны были установить `CLAUDE_CODE_ENABLE_AUTO_MODE` для включения auto mode.

102 102 

103<Tip title="Best practice">103<Tip title="Best practice">

104 Начните сложные задачи в Plan, чтобы Claude наметил подход перед внесением изменений. После одобрения плана переключитесь на Accept edits или Manual для его выполнения. См. [explore first, then plan, then code](/ru/best-practices#explore-first-then-plan-then-code) для получения дополнительной информации об этом рабочем процессе.104 Начните сложные задачи в Plan, чтобы Claude наметил подход перед внесением изменений. После одобрения плана переключитесь на Accept edits или Manual для его выполнения. См. [explore first, then plan, then code](/docs/ru/best-practices#explore-first-then-plan-then-code) для получения дополнительной информации об этом рабочем процессе.

105</Tip>105</Tip>

106 106 

107Облачные сеансы поддерживают Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачные сеансы предварительно одобряют редактирование файлов, поэтому селектор показывает Accept edits вместо Manual. Bypass permissions недоступен, потому что облачное окружение уже изолировано.107Облачные сеансы поддерживают Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачные сеансы предварительно одобряют редактирование файлов, поэтому селектор показывает Accept edits вместо Manual. Bypass permissions недоступен, потому что облачное окружение уже изолировано.


145 145 

146В первый раз, когда Claude действует на внешнем сайте, появляется карточка разрешения и Claude ждёт вашего выбора: **Allow once**, **Always allow** или **Deny**. **Allow once** одобряет действие без сохранения чего-либо. **Always allow** сохраняет одобрение для этого сайта на вашем устройстве, и вы можете отозвать его в Settings. Каждый сайт требует собственного одобрения, включая поддомены. Ваши локальные dev-серверы и файлы проекта не требуют одобрения, поэтому [auto-verify](#auto-verify-changes) продолжает работать без подсказок.146В первый раз, когда Claude действует на внешнем сайте, появляется карточка разрешения и Claude ждёт вашего выбора: **Allow once**, **Always allow** или **Deny**. **Allow once** одобряет действие без сохранения чего-либо. **Always allow** сохраняет одобрение для этого сайта на вашем устройстве, и вы можете отозвать его в Settings. Каждый сайт требует собственного одобрения, включая поддомены. Ваши локальные dev-серверы и файлы проекта не требуют одобрения, поэтому [auto-verify](#auto-verify-changes) продолжает работать без подсказок.

147 147 

148Даже на одобренном сайте Claude не будет покупать товары, создавать учётные записи или обходить CAPTCHAs без вашего ввода. Просмотр в панели Browser использует ту же модель безопасности, что и [Claude in Chrome extension](/ru/chrome). См. [Using Claude in Chrome safely](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) для того, как Claude обрабатывает чувствительные сайты и рискованные действия.148Даже на одобренном сайте Claude не будет покупать товары, создавать учётные записи или обходить CAPTCHAs без вашего ввода. Просмотр в панели Browser использует ту же модель безопасности, что и [Claude in Chrome extension](/docs/ru/chrome). См. [Using Claude in Chrome safely](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) для того, как Claude обрабатывает чувствительные сайты и рискованные действия.

149 149 

150<h4 id="choose-between-the-browser-and-the-chrome-extension">150<h4 id="choose-between-the-browser-and-the-chrome-extension">

151 Выбор между Browser и Chrome extension151 Выбор между Browser и Chrome extension

152</h4>152</h4>

153 153 

154Панель Browser использует чистый профиль браузера, отдельный от вашего личного браузера, без каких-либо сохранённых входов или истории. Используйте его для создания и тестирования вашего приложения и для сайтов, которые не требуют вашей личности. Когда вы хотите, чтобы Claude действовал как вы в ваших вошедших сеансах, используйте [Claude in Chrome extension](/ru/chrome) вместо этого, которая делится состоянием входа вашего браузера.154Панель Browser использует чистый профиль браузера, отдельный от вашего личного браузера, без каких-либо сохранённых входов или истории. Используйте его для создания и тестирования вашего приложения и для сайтов, которые не требуют вашей личности. Когда вы хотите, чтобы Claude действовал как вы в ваших вошедших сеансах, используйте [Claude in Chrome extension](/docs/ru/chrome) вместо этого, которая делится состоянием входа вашего браузера.

155 155 

156<h4 id="restrict-external-browsing-for-your-organization">156<h4 id="restrict-external-browsing-for-your-organization">

157 Ограничение внешнего просмотра для вашей организации157 Ограничение внешнего просмотра для вашей организации


274| `Cmd` `Shift` `E` | Открыть меню усилия |274| `Cmd` `Shift` `E` | Открыть меню усилия |

275| `1`–`9` | Выбрать элемент в открытом меню |275| `1`–`9` | Выбрать элемент в открытом меню |

276 276 

277Эти сочетания клавиш применяются только к вкладке Code. Сочетания клавиш [интерактивного режима](/ru/interactive-mode#keyboard-shortcuts) на основе терминала, такие как `Shift+Tab` для циклирования режимов, не применяются в Desktop.277Эти сочетания клавиш применяются только к вкладке Code. Сочетания клавиш [интерактивного режима](/docs/ru/interactive-mode#keyboard-shortcuts) на основе терминала, такие как `Shift+Tab` для циклирования режимов, не применяются в Desktop.

278 278 

279<h3 id="check-usage">279<h3 id="check-usage">

280 Проверка использования280 Проверка использования


295Использование компьютера отключено по умолчанию. [Включите его в Settings](#enable-computer-use) перед тем, как Claude сможет управлять вашим экраном. На macOS вам также нужно предоставить разрешения Accessibility и Screen Recording.295Использование компьютера отключено по умолчанию. [Включите его в Settings](#enable-computer-use) перед тем, как Claude сможет управлять вашим экраном. На macOS вам также нужно предоставить разрешения Accessibility и Screen Recording.

296 296 

297<Warning>297<Warning>

298 В отличие от [изолированного инструмента Bash](/ru/sandboxing), использование компьютера работает на вашем реальном рабочем столе с доступом к тому, что вы одобрите. Claude проверяет каждое действие и отмечает потенциальную инъекцию подсказок из содержимого на экране, но граница доверия отличается. См. [руководство по безопасности использования компьютера](https://support.claude.com/en/articles/14128542) для лучших практик.298 В отличие от [изолированного инструмента Bash](/docs/ru/sandboxing), использование компьютера работает на вашем реальном рабочем столе с доступом к тому, что вы одобрите. Claude проверяет каждое действие и отмечает потенциальную инъекцию подсказок из содержимого на экране, но граница доверия отличается. См. [руководство по безопасности использования компьютера](https://support.claude.com/en/articles/14128542) для лучших практик.

299</Warning>299</Warning>

300 300 

301<h3 id="when-computer-use-applies">301<h3 id="when-computer-use-applies">


306 306 

307* Если у вас есть [коннектор](#connect-external-tools) для сервиса, Claude использует коннектор.307* Если у вас есть [коннектор](#connect-external-tools) для сервиса, Claude использует коннектор.

308* Если задача — это команда shell, Claude использует Bash.308* Если задача — это команда shell, Claude использует Bash.

309* Если задача — это работа в браузере и у вас есть [Claude в Chrome](/ru/chrome) установлен, Claude использует это.309* Если задача — это работа в браузере и у вас есть [Claude в Chrome](/docs/ru/chrome) установлен, Claude использует это.

310* Если ничего из этого не применяется, Claude использует использование компьютера.310* Если ничего из этого не применяется, Claude использует использование компьютера.

311 311 

312[Уровни доступа для каждого приложения](#app-permissions) усиливают это: браузеры ограничены только просмотром, а терминалы и IDE — только кликом, направляя Claude к выделенному инструменту даже когда использование компьютера активно. Управление экраном зарезервировано для вещей, которые ничто другое не может достичь, таких как нативные приложения, панели управления оборудованием, симуляторы мобильных устройств или собственные инструменты без API.312[Уровни доступа для каждого приложения](#app-permissions) усиливают это: браузеры ограничены только просмотром, а терминалы и IDE — только кликом, направляя Claude к выделенному инструменту даже когда использование компьютера активно. Управление экраном зарезервировано для вещей, которые ничто другое не может достичь, таких как нативные приложения, панели управления оборудованием, симуляторы мобильных устройств или собственные инструменты без API.


319 319 

320<Steps>320<Steps>

321 <Step title="Обновление приложения desktop">321 <Step title="Обновление приложения desktop">

322 Убедитесь, что у вас есть последняя версия Claude Desktop. На macOS и Windows загрузите или обновите на [claude.com/download](https://claude.com/download); на Linux обновите через ваш менеджер пакетов ([инструкции](/ru/desktop-linux)). Затем перезагрузите приложение.322 Убедитесь, что у вас есть последняя версия Claude Desktop. На macOS и Windows загрузите или обновите на [claude.com/download](https://claude.com/download); на Linux обновите через ваш менеджер пакетов ([инструкции](/docs/ru/desktop-linux)). Затем перезагрузите приложение.

323 </Step>323 </Step>

324 324 

325 <Step title="Включение переключателя">325 <Step title="Включение переключателя">


369 Работа параллельно с сеансами369 Работа параллельно с сеансами

370</h3>370</h3>

371 371 

372Нажмите **+ New session** в боковой панели, или нажмите **Cmd+N** на macOS или **Ctrl+N** на Windows, чтобы работать над несколькими задачами параллельно. Нажмите **Ctrl+Tab** и **Ctrl+Shift+Tab**, чтобы циклически переходить через сеансы в боковой панели. Для Git-репозиториев каждый сеанс получает свою собственную изолированную копию вашего проекта, используя [Git Worktrees](/ru/worktrees), поэтому изменения в одном сеансе не влияют на другие сеансы до тех пор, пока вы их не зафиксируете.372Нажмите **+ New session** в боковой панели, или нажмите **Cmd+N** на macOS или **Ctrl+N** на Windows, чтобы работать над несколькими задачами параллельно. Нажмите **Ctrl+Tab** и **Ctrl+Shift+Tab**, чтобы циклически переходить через сеансы в боковой панели. Для Git-репозиториев каждый сеанс получает свою собственную изолированную копию вашего проекта, используя [Git Worktrees](/docs/ru/worktrees), поэтому изменения в одном сеансе не влияют на другие сеансы до тех пор, пока вы их не зафиксируете.

373 373 

374Чтобы просмотреть два сеанса одновременно, удерживайте **Cmd** на macOS или **Ctrl** на Windows и нажмите на сеанс в боковой панели. Сеанс откроется во второй панели рядом с тем, который у вас уже открыт. Пока разделение активно, нажатие на другой сеанс в боковой панели заменяет ту панель, которая имеет фокус. Нажмите **Cmd+\\** на macOS или **Ctrl+\\** на Windows, чтобы закрыть панель с фокусом и вернуться к одному сеансу.374Чтобы просмотреть два сеанса одновременно, удерживайте **Cmd** на macOS или **Ctrl** на Windows и нажмите на сеанс в боковой панели. Сеанс откроется во второй панели рядом с тем, который у вас уже открыт. Пока разделение активно, нажатие на другой сеанс в боковой панели заменяет ту панель, которая имеет фокус. Нажмите **Cmd+\\** на macOS или **Ctrl+\\** на Windows, чтобы закрыть панель с фокусом и вернуться к одному сеансу.

375 375 

376Worktrees хранятся в `<project-root>/.claude/worktrees/` по умолчанию. Вы можете изменить это на пользовательский каталог в Settings → Claude Code под "Worktree location". Вы также можете установить префикс ветви, который добавляется в начало каждого имени ветви worktree, что полезно для организации веток, созданных Claude. Чтобы удалить worktree после завершения, наведите курсор на сеанс в боковой панели и нажмите значок архива. Чтобы сеансы архивировали себя, когда их pull request объединяется или закрывается, включите **Auto-archive after PR merge or close** в Settings → Claude Code. Auto-archive применяется только к локальным сеансам, которые завершили работу.376Worktrees хранятся в `<project-root>/.claude/worktrees/` по умолчанию. Вы можете изменить это на пользовательский каталог в Settings → Claude Code под "Worktree location". Вы также можете установить префикс ветви, который добавляется в начало каждого имени ветви worktree, что полезно для организации веток, созданных Claude. Чтобы удалить worktree после завершения, наведите курсор на сеанс в боковой панели и нажмите значок архива. Чтобы сеансы архивировали себя, когда их pull request объединяется или закрывается, включите **Auto-archive after PR merge or close** в Settings → Claude Code. Auto-archive применяется только к локальным сеансам, которые завершили работу.

377 377 

378Чтобы включить gitignored файлы, такие как `.env`, в новые worktrees, создайте [`.worktreeinclude` файл](/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта.378Чтобы включить gitignored файлы, такие как `.env`, в новые worktrees, создайте [`.worktreeinclude` файл](/docs/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта.

379 379 

380<Note>380<Note>

381 Изоляция сеанса требует [Git](https://git-scm.com/downloads). На большинстве Mac Git включен по умолчанию. Запустите `git --version` в Terminal для проверки. На Windows Git требуется для работы вкладки Code: [загрузите Git для Windows](https://git-scm.com/downloads/win), установите его и перезагрузите приложение. Если вы столкнулись с ошибками Git, попросите Claude в [вкладке Cowork](https://claude.com/product/cowork) помочь вам устранить неполадки вашей установки.381 Изоляция сеанса требует [Git](https://git-scm.com/downloads). На большинстве Mac Git включен по умолчанию. Запустите `git --version` в Terminal для проверки. На Windows Git требуется для работы вкладки Code: [загрузите Git для Windows](https://git-scm.com/downloads/win), установите его и перезагрузите приложение. Если вы столкнулись с ошибками Git, попросите Claude в [вкладке Cowork](https://claude.com/product/cowork) помочь вам устранить неполадки вашей установки.

382</Note>382</Note>

383 383 

384Используйте элементы управления в верхней части боковой панели для фильтрации сеансов по статусу, проекту или окружению, и для группировки сеансов по проекту. Чтобы переименовать сеанс, нажмите на название сеанса в панели инструментов в верхней части активного сеанса. Чтобы проверить использование контекста, см. [Проверка использования](#check-usage). Когда контекст заполняется, Claude автоматически суммирует разговор и продолжает работу. Вы также можете ввести `/compact` для запуска суммирования раньше и освобождения пространства контекста. См. [контекстное окно](/ru/how-claude-code-works#the-context-window) для получения подробной информации о том, как работает компактирование.384Используйте элементы управления в верхней части боковой панели для фильтрации сеансов по статусу, проекту или окружению, и для группировки сеансов по проекту. Чтобы переименовать сеанс, нажмите на название сеанса в панели инструментов в верхней части активного сеанса. Чтобы проверить использование контекста, см. [Проверка использования](#check-usage). Когда контекст заполняется, Claude автоматически суммирует разговор и продолжает работу. Вы также можете ввести `/compact` для запуска суммирования раньше и освобождения пространства контекста. См. [контекстное окно](/docs/ru/how-claude-code-works#the-context-window) для получения подробной информации о том, как работает компактирование.

385 385 

386Приложение для рабочего стола отправляет уведомление ОС, когда сеанс Code завершает задачу и вы в данный момент не просматриваете этот сеанс.386Приложение для рабочего стола отправляет уведомление ОС, когда сеанс Code завершает задачу и вы в данный момент не просматриваете этот сеанс.

387 387 


397 Наблюдение за фоновыми задачами397 Наблюдение за фоновыми задачами

398</h3>398</h3>

399 399 

400Панель задач показывает фоновую работу, выполняемую внутри текущего сеанса: подагентов, фоновые команды shell и [динамические рабочие процессы](/ru/workflows). Откройте её из меню **Views** или перетащите её в ваш макет.400Панель задач показывает фоновую работу, выполняемую внутри текущего сеанса: подагентов, фоновые команды shell и [динамические рабочие процессы](/docs/ru/workflows). Откройте её из меню **Views** или перетащите её в ваш макет.

401 401 

402Нажмите на любую запись, чтобы увидеть её вывод в панели подагента или остановить её. Чтобы увидеть, что делают другие сеансы, используйте [боковую панель](#work-in-parallel-with-sessions).402Нажмите на любую запись, чтобы увидеть её вывод в панели подагента или остановить её. Чтобы увидеть, что делают другие сеансы, используйте [боковую панель](#work-in-parallel-with-sessions).

403 403 


409 409 

410Удалённые сеансы также поддерживают несколько репозиториев. После выбора облачного окружения нажмите кнопку **+** рядом с таблеткой репо, чтобы добавить дополнительные репозитории в сеанс. Каждый репо получает свой собственный селектор ветви. Это полезно для задач, охватывающих несколько кодовых баз, таких как обновление общей библиотеки и её потребителей.410Удалённые сеансы также поддерживают несколько репозиториев. После выбора облачного окружения нажмите кнопку **+** рядом с таблеткой репо, чтобы добавить дополнительные репозитории в сеанс. Каждый репо получает свой собственный селектор ветви. Это полезно для задач, охватывающих несколько кодовых баз, таких как обновление общей библиотеки и её потребителей.

411 411 

412См. [Claude Code на веб-сайте](/ru/claude-code-on-the-web) для получения дополнительной информации о том, как работают удалённые сеансы.412См. [Claude Code на веб-сайте](/docs/ru/claude-code-on-the-web) для получения дополнительной информации о том, как работают удалённые сеансы.

413 413 

414<h3 id="continue-in-another-surface">414<h3 id="continue-in-another-surface">

415 Продолжение на другой поверхности415 Продолжение на другой поверхности


434 434 

435Для настройки, сопряжения и параметров Dispatch см. [статью справки Dispatch](https://support.claude.com/en/articles/13947068). Dispatch требует плана Pro или Max и недоступен на планах Team или Enterprise.435Для настройки, сопряжения и параметров Dispatch см. [статью справки Dispatch](https://support.claude.com/en/articles/13947068). Dispatch требует плана Pro или Max и недоступен на планах Team или Enterprise.

436 436 

437Dispatch — это один из нескольких способов работы с Claude, когда вы находитесь вдали от своего терминала. См. [Платформы и интеграции](/ru/platforms#work-when-you-are-away-from-your-terminal) для сравнения с Remote Control, Channels, Slack и запланированными задачами.437Dispatch — это один из нескольких способов работы с Claude, когда вы находитесь вдали от своего терминала. См. [Платформы и интеграции](/docs/ru/platforms#work-when-you-are-away-from-your-terminal) для сравнения с Remote Control, Channels, Slack и запланированными задачами.

438 438 

439<h2 id="extend-claude-code">439<h2 id="extend-claude-code">

440 Расширение Claude Code440 Расширение Claude Code


446 Подключение внешних инструментов446 Подключение внешних инструментов

447</h3>447</h3>

448 448 

449Для локальных и [SSH](#ssh-sessions) сеансов нажмите кнопку **+** рядом с полем подсказки и выберите **Connectors**, чтобы добавить интеграции, такие как Google Calendar, Slack, GitHub, Linear, Notion и другие. Вы можете добавлять коннекторы до или во время сеанса. Кнопка **+** недоступна в облачных или WSL сеансах, но [routines](/ru/routines) конфигурируют коннекторы во время создания routine.449Для локальных и [SSH](#ssh-sessions) сеансов нажмите кнопку **+** рядом с полем подсказки и выберите **Connectors**, чтобы добавить интеграции, такие как Google Calendar, Slack, GitHub, Linear, Notion и другие. Вы можете добавлять коннекторы до или во время сеанса. Кнопка **+** недоступна в облачных или WSL сеансах, но [routines](/docs/ru/routines) конфигурируют коннекторы во время создания routine.

450 450 

451Чтобы управлять или отключать коннекторы, перейдите в Settings → Connectors в приложении desktop, или выберите **Manage connectors** из меню Connectors в поле подсказки.451Чтобы управлять или отключать коннекторы, перейдите в Settings → Connectors в приложении desktop, или выберите **Manage connectors** из меню Connectors в поле подсказки.

452 452 

453После подключения Claude может читать ваш календарь, отправлять сообщения, создавать проблемы и взаимодействовать с вашими инструментами напрямую. Вы можете спросить Claude, какие коннекторы настроены в вашем сеансе.453После подключения Claude может читать ваш календарь, отправлять сообщения, создавать проблемы и взаимодействовать с вашими инструментами напрямую. Вы можете спросить Claude, какие коннекторы настроены в вашем сеансе.

454 454 

455Коннекторы — это [MCP servers](/ru/mcp) с графическим потоком установки. Используйте их для быстрой интеграции с поддерживаемыми сервисами. Для интеграций, не указанных в Connectors, добавьте MCP servers вручную через [файлы параметров](/ru/mcp#installing-mcp-servers). Вы также можете [создать пользовательские коннекторы](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).455Коннекторы — это [MCP servers](/docs/ru/mcp) с графическим потоком установки. Используйте их для быстрой интеграции с поддерживаемыми сервисами. Для интеграций, не указанных в Connectors, добавьте MCP servers вручную через [файлы параметров](/docs/ru/mcp#installing-mcp-servers). Вы также можете [создать пользовательские коннекторы](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).

456 456 

457<h3 id="use-skills">457<h3 id="use-skills">

458 Использование skills458 Использование skills

459</h3>459</h3>

460 460 

461[Skills](/ru/skills) расширяют возможности Claude. Claude загружает их автоматически, когда они релевантны, или вы можете вызвать один напрямую: введите `/` в поле подсказки или нажмите кнопку **+** и выберите **Slash commands**, чтобы просмотреть доступные. Это включает [встроенные команды](/ru/commands), ваши [пользовательские skills](/ru/skills#create-your-first-skill), skills проекта из вашей кодовой базы и skills из любых [установленных плагинов](/ru/plugins). Выберите один, и он появится выделенным в поле ввода. Введите вашу задачу после него и отправьте как обычно.461[Skills](/docs/ru/skills) расширяют возможности Claude. Claude загружает их автоматически, когда они релевантны, или вы можете вызвать один напрямую: введите `/` в поле подсказки или нажмите кнопку **+** и выберите **Slash commands**, чтобы просмотреть доступные. Это включает [встроенные команды](/docs/ru/commands), ваши [пользовательские skills](/docs/ru/skills#create-your-first-skill), skills проекта из вашей кодовой базы и skills из любых [установленных плагинов](/docs/ru/plugins). Выберите один, и он появится выделенным в поле ввода. Введите вашу задачу после него и отправьте как обычно.

462 462 

463Вы можете отправить команду, пока Claude работает, так же как любое другое сообщение, и сеанс вернётся в режим ожидания после завершения хода. До версии 2.1.206 команда, отправленная во время хода, могла оставить сеанс в состоянии выполнения, и сообщения, которые вы отправили впоследствии, не доставлялись.463Вы можете отправить команду, пока Claude работает, так же как любое другое сообщение, и сеанс вернётся в режим ожидания после завершения хода. До версии 2.1.206 команда, отправленная во время хода, могла оставить сеанс в состоянии выполнения, и сообщения, которые вы отправили впоследствии, не доставлялись.

464 464 


466 Установка плагинов466 Установка плагинов

467</h3>467</h3>

468 468 

469[Plugins](/ru/plugins) — это повторно используемые пакеты, которые добавляют skills, agents, hooks, MCP servers и конфигурации LSP в Claude Code. Вы можете устанавливать плагины из приложения desktop без использования терминала.469[Plugins](/docs/ru/plugins) — это повторно используемые пакеты, которые добавляют skills, agents, hooks, MCP servers и конфигурации LSP в Claude Code. Вы можете устанавливать плагины из приложения desktop без использования терминала.

470 470 

471Для локальных и [SSH](#ssh-sessions) сеансов нажмите кнопку **+** рядом с полем подсказки и выберите **Plugins**, чтобы увидеть ваши установленные плагины и их skills. Чтобы добавить плагин, выберите **Add plugin** из подменю, чтобы открыть браузер плагинов, который показывает доступные плагины из ваших настроенных [marketplaces](/ru/plugin-marketplaces), включая официальный marketplace Anthropic. Выберите **Manage plugins**, чтобы включить, отключить или удалить плагины.471Для локальных и [SSH](#ssh-sessions) сеансов нажмите кнопку **+** рядом с полем подсказки и выберите **Plugins**, чтобы увидеть ваши установленные плагины и их skills. Чтобы добавить плагин, выберите **Add plugin** из подменю, чтобы открыть браузер плагинов, который показывает доступные плагины из ваших настроенных [marketplaces](/docs/ru/plugin-marketplaces), включая официальный marketplace Anthropic. Выберите **Manage plugins**, чтобы включить, отключить или удалить плагины.

472 472 

473Плагины могут быть ограничены вашей учётной записью пользователя, конкретным проектом или только локально. Если ваша организация управляет плагинами централизованно, эти плагины доступны в сеансах desktop так же, как они есть в CLI. Плагины недоступны для облачных или WSL сеансов. Для полного справочника плагинов, включая создание собственных плагинов, см. [plugins](/ru/plugins).473Плагины могут быть ограничены вашей учётной записью пользователя, конкретным проектом или только локально. Если ваша организация управляет плагинами централизованно, эти плагины доступны в сеансах desktop так же, как они есть в CLI. Плагины недоступны для облачных или WSL сеансов. Для полного справочника плагинов, включая создание собственных плагинов, см. [plugins](/docs/ru/plugins).

474 474 

475<h3 id="configure-preview-servers">475<h3 id="configure-preview-servers">

476 Конфигурация серверов предпросмотра476 Конфигурация серверов предпросмотра


636* **Local**: работает на вашей машине с прямым доступом к вашим файлам636* **Local**: работает на вашей машине с прямым доступом к вашим файлам

637* **Remote**: работает на облачной инфраструктуре Anthropic. Сеансы продолжают работу даже если вы закроете приложение.637* **Remote**: работает на облачной инфраструктуре Anthropic. Сеансы продолжают работу даже если вы закроете приложение.

638* **SSH**: работает на удалённой машине, к которой вы подключаетесь через SSH, такой как ваши собственные серверы, облачные виртуальные машины или dev-контейнеры638* **SSH**: работает на удалённой машине, к которой вы подключаетесь через SSH, такой как ваши собственные серверы, облачные виртуальные машины или dev-контейнеры

639* **WSL** (Windows): работает внутри [WSL 2 дистрибутива](/ru/desktop-wsl) на вашей машине, используя его Linux toolchain и собственные пути639* **WSL** (Windows): работает внутри [WSL 2 дистрибутива](/docs/ru/desktop-wsl) на вашей машине, используя его Linux toolchain и собственные пути

640 640 

641<h3 id="local-sessions">641<h3 id="local-sessions">

642 Локальные сеансы642 Локальные сеансы


644 644 

645Приложение desktop не всегда наследует полное окружение shell. На macOS, когда вы запускаете приложение из Dock или Finder, оно читает ваш профиль shell, такой как `~/.zshrc` или `~/.bashrc`, для извлечения `PATH` и фиксированного набора переменных Claude Code, но другие переменные, которые вы экспортируете там, не подхватываются. На Windows приложение наследует переменные окружения пользователя и системы, но не читает профили PowerShell.645Приложение desktop не всегда наследует полное окружение shell. На macOS, когда вы запускаете приложение из Dock или Finder, оно читает ваш профиль shell, такой как `~/.zshrc` или `~/.bashrc`, для извлечения `PATH` и фиксированного набора переменных Claude Code, но другие переменные, которые вы экспортируете там, не подхватываются. На Windows приложение наследует переменные окружения пользователя и системы, но не читает профили PowerShell.

646 646 

647Чтобы установить переменные окружения для локальных сеансов и dev-серверов на любой платформе, откройте раскрывающийся список окружения в поле подсказки, наведите курсор на **Local** и нажмите значок шестерёнки, чтобы открыть локальный редактор окружения. Переменные, которые вы сохраняете здесь, хранятся в зашифрованном виде на вашей машине и применяются к каждому локальному сеансу и серверу предпросмотра, который вы запускаете. Вы также можете добавить переменные к ключу `env` в вашем файле `~/.claude/settings.json`, хотя они достигают только сеансов Claude, а не dev-серверов. См. [переменные окружения](/ru/env-vars) для полного списка поддерживаемых переменных.647Чтобы установить переменные окружения для локальных сеансов и dev-серверов на любой платформе, откройте раскрывающийся список окружения в поле подсказки, наведите курсор на **Local** и нажмите значок шестерёнки, чтобы открыть локальный редактор окружения. Переменные, которые вы сохраняете здесь, хранятся в зашифрованном виде на вашей машине и применяются к каждому локальному сеансу и серверу предпросмотра, который вы запускаете. Вы также можете добавить переменные к ключу `env` в вашем файле `~/.claude/settings.json`, хотя они достигают только сеансов Claude, а не dev-серверов. См. [переменные окружения](/docs/ru/env-vars) для полного списка поддерживаемых переменных.

648 648 

649[Extended thinking](/ru/model-config#extended-thinking) включен по умолчанию, что улучшает производительность на сложных задачах рассуждения, но использует дополнительные токены. Чтобы отключить thinking, установите `MAX_THINKING_TOKENS` на `0` в локальном редакторе окружения; это не влияет на Fable 5, который всегда использует extended thinking. На [сторонних поставщиках](/ru/third-party-integrations) `0` опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения могут всё ещё думать. На моделях с [адаптивным рассуждением](/ru/model-config#adjust-effort-level) любое другое значение `MAX_THINKING_TOKENS` игнорируется, потому что адаптивное рассуждение контролирует глубину thinking вместо этого. На Opus 4.6 и Sonnet 4.6 установите `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` на `1`, чтобы использовать фиксированный бюджет thinking; Fable 5, Sonnet 5 и Opus 4.7 и более поздние версии всегда используют адаптивное рассуждение и не имеют режима фиксированного бюджета.649[Extended thinking](/docs/ru/model-config#extended-thinking) включен по умолчанию, что улучшает производительность на сложных задачах рассуждения, но использует дополнительные токены. Чтобы отключить thinking, установите `MAX_THINKING_TOKENS` на `0` в локальном редакторе окружения; это не влияет на Fable 5, который всегда использует extended thinking. На [сторонних поставщиках](/docs/ru/third-party-integrations) `0` опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения могут всё ещё думать. На моделях с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) любое другое значение `MAX_THINKING_TOKENS` игнорируется, потому что адаптивное рассуждение контролирует глубину thinking вместо этого. На Opus 4.6 и Sonnet 4.6 установите `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` на `1`, чтобы использовать фиксированный бюджет thinking; Fable 5, Sonnet 5 и Opus 4.7 и более поздние версии всегда используют адаптивное рассуждение и не имеют режима фиксированного бюджета.

650 650 

651<h3 id="cloud-sessions">651<h3 id="cloud-sessions">

652 Удалённые сеансы652 Удалённые сеансы

653</h3>653</h3>

654 654 

655Удалённые сеансы продолжают работу в фоне даже если вы закроете приложение. Использование считается в пределах [лимитов вашего плана подписки](/ru/costs) без отдельных расходов на вычисления.655Удалённые сеансы продолжают работу в фоне даже если вы закроете приложение. Использование считается в пределах [лимитов вашего плана подписки](/docs/ru/costs) без отдельных расходов на вычисления.

656 656 

657Вы можете создавать пользовательские облачные окружения с разными уровнями доступа к сети и переменными окружения. Выберите раскрывающийся список окружения при запуске облачного сеанса и выберите **Add environment**. См. [облачное окружение](/ru/claude-code-on-the-web#the-cloud-environment) для получения подробной информации о конфигурации доступа к сети и переменных окружения.657Вы можете создавать пользовательские облачные окружения с разными уровнями доступа к сети и переменными окружения. Выберите раскрывающийся список окружения при запуске облачного сеанса и выберите **Add environment**. См. [облачное окружение](/docs/ru/claude-code-on-the-web#the-cloud-environment) для получения подробной информации о конфигурации доступа к сети и переменных окружения.

658 658 

659<h3 id="ssh-sessions">659<h3 id="ssh-sessions">

660 SSH-сеансы660 SSH-сеансы


677 Предварительная конфигурация SSH-соединений для вашей команды677 Предварительная конфигурация SSH-соединений для вашей команды

678</h4>678</h4>

679 679 

680Администраторы могут распространять SSH-соединения членам команды, добавляя `sshConfigs` в файл [управляемых параметров](/ru/settings#settings-precedence). Соединения, определённые таким образом, появляются в раскрывающемся списке окружения каждого пользователя автоматически и отображаются как управляемые, поэтому пользователи могут выбирать их, но не могут редактировать или удалять их в приложении.680Администраторы могут распространять SSH-соединения членам команды, добавляя `sshConfigs` в файл [управляемых параметров](/docs/ru/settings#settings-precedence). Соединения, определённые таким образом, появляются в раскрывающемся списке окружения каждого пользователя автоматически и отображаются как управляемые, поэтому пользователи могут выбирать их, но не могут редактировать или удалять их в приложении.

681 681 

682Следующий пример предварительно конфигурирует одно соединение, которое открывается в `~/projects` на удалённом хосте:682Следующий пример предварительно конфигурирует одно соединение, которое открывается в `~/projects` на удалённом хосте:

683 683 


702 Ограничение SSH-хостов, к которым могут подключаться пользователи702 Ограничение SSH-хостов, к которым могут подключаться пользователи

703</h4>703</h4>

704 704 

705Администраторы могут ограничить SSH-сеансы Desktop утверждённым набором хостов, добавляя `sshHostAllowlist` в файл [управляемых параметров](/ru/settings#settings-precedence). Когда это установлено, пользователи могут подключаться только к хостам, разрешённое имя хоста которых совпадает с одним из шаблонов. Установите его в пустой массив, чтобы полностью отключить SSH-сеансы.705Администраторы могут ограничить SSH-сеансы Desktop утверждённым набором хостов, добавляя `sshHostAllowlist` в файл [управляемых параметров](/docs/ru/settings#settings-precedence). Когда это установлено, пользователи могут подключаться только к хостам, разрешённое имя хоста которых совпадает с одним из шаблонов. Установите его в пустой массив, чтобы полностью отключить SSH-сеансы.

706 706 

707Следующий пример разрешает соединения с любым хостом под `devboxes.example.com` и с одним именованным хостом-бастионом:707Следующий пример разрешает соединения с любым хостом под `devboxes.example.com` и с одним именованным хостом-бастионом:

708 708 


729Эти параметры настраиваются через [консоль параметров администратора](https://claude.ai/admin-settings/claude-code):729Эти параметры настраиваются через [консоль параметров администратора](https://claude.ai/admin-settings/claude-code):

730 730 

731* **Code in the desktop**: контролируйте, могут ли пользователи в вашей организации получать доступ к Claude Code в приложении desktop731* **Code in the desktop**: контролируйте, могут ли пользователи в вашей организации получать доступ к Claude Code в приложении desktop

732* **Code in the web**: включите или отключите [веб-сеансы](/ru/claude-code-on-the-web) для вашей организации732* **Code in the web**: включите или отключите [веб-сеансы](/docs/ru/claude-code-on-the-web) для вашей организации

733* **Remote Control**: включите или отключите [Remote Control](/ru/remote-control) для вашей организации733* **Remote Control**: включите или отключите [Remote Control](/docs/ru/remote-control) для вашей организации

734* **Отключить режим обхода разрешений**: предотвратите пользователей в вашей организации от включения режима обхода разрешений734* **Отключить режим обхода разрешений**: предотвратите пользователей в вашей организации от включения режима обхода разрешений

735 735 

736<h3 id="managed-settings">736<h3 id="managed-settings">

737 Управляемые параметры737 Управляемые параметры

738</h3>738</h3>

739 739 

740Управляемые параметры переопределяют параметры проекта и пользователя и применяются к сеансам Claude Code в Desktop. Вы можете установить эти ключи в файле [управляемых параметров](/ru/settings#settings-precedence) вашей организации или отправить их удалённо через консоль администратора.740Управляемые параметры переопределяют параметры проекта и пользователя и применяются к сеансам Claude Code в Desktop. Вы можете установить эти ключи в файле [управляемых параметров](/docs/ru/settings#settings-precedence) вашей организации или отправить их удалённо через консоль администратора.

741 741 

742| Ключ | Описание |742| Ключ | Описание |

743| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |743| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

744| `permissions.disableBypassPermissionsMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима обхода разрешений. |744| `permissions.disableBypassPermissionsMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима обхода разрешений. |

745| `disableAutoMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима [Auto](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет Auto из селектора режима. Также принимается под `permissions`. |745| `disableAutoMode` | установите на `"disable"`, чтобы предотвратить пользователей от включения режима [Auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет Auto из селектора режима. Также принимается под `permissions`. |

746| `autoMode` | настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. [Configure auto mode](/ru/auto-mode-config). |746| `autoMode` | настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. [Configure auto mode](/docs/ru/auto-mode-config). |

747| `browserExternalPageTools` | установите на `"disabled"`, чтобы предотвратить Claude от использования инструментов для чтения или действия на внешних страницах в [панели браузера](#browse-external-sites). Пользователи по-прежнему могут самостоятельно переходить на внешние сайты, и предпросмотры локального сервера разработки не затронуты. |747| `browserExternalPageTools` | установите на `"disabled"`, чтобы предотвратить Claude от использования инструментов для чтения или действия на внешних страницах в [панели браузера](#browse-external-sites). Пользователи по-прежнему могут самостоятельно переходить на внешние сайты, и предпросмотры локального сервера разработки не затронуты. |

748| `disableBrowserExternalNavigation` | установите на `true`, чтобы полностью отключить внешний просмотр в [панели браузера](#browse-external-sites). Ни пользователи, ни Claude не могут переходить на внешние сайты, и предпросмотры localhost сервера разработки не затронуты. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |748| `disableBrowserExternalNavigation` | установите на `true`, чтобы полностью отключить внешний просмотр в [панели браузера](#browse-external-sites). Ни пользователи, ни Claude не могут переходить на внешние сайты, и предпросмотры localhost сервера разработки не затронуты. Значение должно быть логическим значением JSON `true`; строка `"true"` игнорируется. |

749| `sshConfigs` | предварительно настройте [SSH-соединения](#pre-configure-ssh-connections-for-your-team), которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения. |749| `sshConfigs` | предварительно настройте [SSH-соединения](#pre-configure-ssh-connections-for-your-team), которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения. |

750| `sshHostAllowlist` | ограничьте [SSH-сеансы](#restrict-which-ssh-hosts-users-can-connect-to) хостами, чьё разрешённое имя хоста совпадает с одним из этих шаблонов. Пустой массив отключает SSH-сеансы. Читается только из управляемых параметров. |750| `sshHostAllowlist` | ограничьте [SSH-сеансы](#restrict-which-ssh-hosts-users-can-connect-to) хостами, чьё разрешённое имя хоста совпадает с одним из этих шаблонов. Пустой массив отключает SSH-сеансы. Читается только из управляемых параметров. |

751| `managedMcpServers` | отправьте конфигурации MCP-сервера всем пользователям в развёртывании третьей стороны. Каждая запись указывает транспорт `"http"`, `"sse"` или `"stdio"`, детали подключения и опционально карту `toolPolicy`, которая ограничивает, какие инструменты на этом сервере пользователи могут вызывать. Доступно только в развёртываниях Desktop третьей стороны (3P). Доставляйте этот ключ через файл управляемых параметров или MDM, так как развёртывания третьей стороны не получают параметры консоли администратора. |751| `managedMcpServers` | отправьте конфигурации MCP-сервера всем пользователям в развёртывании третьей стороны. Каждая запись указывает транспорт `"http"`, `"sse"` или `"stdio"`, детали подключения и опционально карту `toolPolicy`, которая ограничивает, какие инструменты на этом сервере пользователи могут вызывать. Доступно только в развёртываниях Desktop третьей стороны (3P). Доставляйте этот ключ через файл управляемых параметров или MDM, так как развёртывания третьей стороны не получают параметры консоли администратора. |

752 752 

753Какие управляемые параметры достигают сеанса Desktop, зависит от того, где этот сеанс работает. Ограничения модели, такие как [`availableModels`](/ru/model-config#restrict-model-selection), применяются в сеансах Claude Code Desktop так же, как в CLI терминала; см. [охват поверхности](/ru/model-config#surface-coverage).753Какие управляемые параметры достигают сеанса Desktop, зависит от того, где этот сеанс работает. Ограничения модели, такие как [`availableModels`](/docs/ru/model-config#restrict-model-selection), применяются в сеансах Claude Code Desktop так же, как в CLI терминала; см. [охват поверхности](/docs/ru/model-config#surface-coverage).

754 754 

755* **Локальные сеансы на этой машине**: применяется файл управляемых параметров, развёрнутый на диск. Управляемые параметры, отправленные удалённо через консоль администратора, также достигают эти сеансы на API Anthropic, когда сеанс аутентифицируется с помощью входа в организацию или напрямую настроенного ключа API, следуя тому же [приоритету параметров](/ru/settings#settings-precedence), что и CLI терминала.755* **Локальные сеансы на этой машине**: применяется файл управляемых параметров, развёрнутый на диск. Управляемые параметры, отправленные удалённо через консоль администратора, также достигают эти сеансы на API Anthropic, когда сеанс аутентифицируется с помощью входа в организацию или напрямую настроенного ключа API, следуя тому же [приоритету параметров](/docs/ru/settings#settings-precedence), что и CLI терминала.

756* **[Облачные сеансы](#cloud-sessions)**: работают на управляемых Anthropic виртуальных машинах и получают только [параметры, управляемые сервером](/ru/server-managed-settings).756* **[Облачные сеансы](#cloud-sessions)**: работают на управляемых Anthropic виртуальных машинах и получают только [параметры, управляемые сервером](/docs/ru/server-managed-settings).

757* **[SSH-сеансы](#ssh-sessions)**: сеанс читает файл управляемых параметров с удалённого хоста. Desktop сам читает `sshConfigs` и `sshHostAllowlist` из управляемых параметров локальной машины при создании соединения.757* **[SSH-сеансы](#ssh-sessions)**: сеанс читает файл управляемых параметров с удалённого хоста. Desktop сам читает `sshConfigs` и `sshHostAllowlist` из управляемых параметров локальной машины при создании соединения.

758 758 

759`permissions.disableBypassPermissionsMode` и `disableAutoMode` также работают в параметрах пользователя и проекта, но размещение их в управляемых параметрах предотвращает пользователей от их переопределения.759`permissions.disableBypassPermissionsMode` и `disableAutoMode` также работают в параметрах пользователя и проекта, но размещение их в управляемых параметрах предотвращает пользователей от их переопределения.

760 760 

761{/* min-version: 2.1.207 */}Claude Code читает `autoMode` из параметров пользователя, флага `--settings` и управляемых параметров, но не из `.claude/settings.json` или `.claude/settings.local.json`: оба файла находятся в директории репозитория, поэтому клонированный репо или этап сборки не может внедрить свои собственные правила классификатора. До версии 2.1.207 Claude Code также читал `.claude/settings.local.json`.761Claude Code читает `autoMode` из параметров пользователя, флага `--settings` и управляемых параметров, но не из `.claude/settings.json` или `.claude/settings.local.json`: оба файла находятся в директории репозитория, поэтому клонированный репо или этап сборки не может внедрить свои собственные правила классификатора. До версии 2.1.207 Claude Code также читал `.claude/settings.local.json`.

762 762 

763Для полного списка управляемых параметров, включая `allowManagedPermissionRulesOnly` и `allowManagedHooksOnly`, см. [управляемые параметры только](/ru/permissions#managed-only-settings).763Для полного списка управляемых параметров, включая `allowManagedPermissionRulesOnly` и `allowManagedHooksOnly`, см. [управляемые параметры только](/docs/ru/permissions#managed-only-settings).

764 764 

765<h3 id="device-management-policies">765<h3 id="device-management-policies">

766 Политики управления устройствами766 Политики управления устройствами


790*.claudemcpcontent.com790*.claudemcpcontent.com

791```791```

792 792 

793Трафик использует HTTPS на порту 443, если вы не настроите пользовательский порт для [OTLP](/ru/monitoring-usage), шлюза LLM или MCP-сервера.793Трафик использует HTTPS на порту 443, если вы не настроите пользовательский порт для [OTLP](/docs/ru/monitoring-usage), шлюза LLM или MCP-сервера.

794 794 

795Для прокси-серверов, пользовательских центров сертификации, mTLS и доменов, которые требуются автономному CLI, см. [конфигурация сети](/ru/network-config).795Для прокси-серверов, пользовательских центров сертификации, mTLS и доменов, которые требуются автономному CLI, см. [конфигурация сети](/docs/ru/network-config).

796 796 

797Чтобы уменьшить количество подстановочных знаков брандмауэра, разрешите вместо этого эти хосты Anthropic. Некоторые поддомены генерируются динамически и должны оставаться подстановочными знаками.797Чтобы уменьшить количество подстановочных знаков брандмауэра, разрешите вместо этого эти хосты Anthropic. Некоторые поддомены генерируются динамически и должны оставаться подстановочными знаками.

798 798 


820 Аутентификация и SSO820 Аутентификация и SSO

821</h3>821</h3>

822 822 

823Организации предприятия могут требовать SSO для всех пользователей. См. [аутентификация](/ru/authentication) для деталей уровня плана и [Настройка SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) для конфигурации SAML; настройка OIDC рассматривается в [Руководстве администратора Claude Enterprise](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).823Организации предприятия могут требовать SSO для всех пользователей. См. [аутентификация](/docs/ru/authentication) для деталей уровня плана и [Настройка SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) для конфигурации SAML; настройка OIDC рассматривается в [Руководстве администратора Claude Enterprise](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).

824 824 

825<h3 id="data-handling">825<h3 id="data-handling">

826 Обработка данных826 Обработка данных

827</h3>827</h3>

828 828 

829Claude Code обрабатывает ваш код локально в локальных сеансах или на облачной инфраструктуре Anthropic в облачных сеансах. Разговоры и контекст кода отправляются в API Anthropic для обработки. См. [обработка данных](/ru/data-usage) для получения подробной информации о сохранении данных, конфиденциальности и соответствии.829Claude Code обрабатывает ваш код локально в локальных сеансах или на облачной инфраструктуре Anthropic в облачных сеансах. Разговоры и контекст кода отправляются в API Anthropic для обработки. См. [обработка данных](/docs/ru/data-usage) для получения подробной информации о сохранении данных, конфиденциальности и соответствии.

830 830 

831<h3 id="deployment">831<h3 id="deployment">

832 Развёртывание832 Развёртывание


837* **macOS**: распространяйте через MDM, такой как Jamf или Kandji, используя установщик `.dmg`837* **macOS**: распространяйте через MDM, такой как Jamf или Kandji, используя установщик `.dmg`

838* **Windows**: развёртывайте через пакет MSIX. См. [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) для опций развёртывания предприятия, включая автоматическую установку838* **Windows**: развёртывайте через пакет MSIX. См. [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) для опций развёртывания предприятия, включая автоматическую установку

839 839 

840Для доменов, которые нужно добавить в список разрешений брандмауэра, см. [требования к доступу в сеть](#network-access-requirements) выше. Для параметров прокси, пользовательских центров сертификации и шлюзов LLM см. [конфигурация сети](/ru/network-config).840Для доменов, которые нужно добавить в список разрешений брандмауэра, см. [требования к доступу в сеть](#network-access-requirements) выше. Для параметров прокси, пользовательских центров сертификации и шлюзов LLM см. [конфигурация сети](/docs/ru/network-config).

841 841 

842Для полного справочника конфигурации предприятия см. [руководство конфигурации предприятия](https://support.claude.com/en/articles/12622667-enterprise-configuration).842Для полного справочника конфигурации предприятия см. [руководство конфигурации предприятия](https://support.claude.com/en/articles/12622667-enterprise-configuration).

843 843 


866| `--permission-mode` | Селектор режима рядом с кнопкой отправки |866| `--permission-mode` | Селектор режима рядом с кнопкой отправки |

867| `--dangerously-skip-permissions` | Режим Bypass permissions. На планах Pro и Max включите его в Settings → Claude Code → "Allow bypass permissions mode"; на планах Team и Enterprise политика организации контролирует это |867| `--dangerously-skip-permissions` | Режим Bypass permissions. На планах Pro и Max включите его в Settings → Claude Code → "Allow bypass permissions mode"; на планах Team и Enterprise политика организации контролирует это |

868| `--add-dir` | Добавьте несколько репо с кнопкой **+** в удалённых сеансах |868| `--add-dir` | Добавьте несколько репо с кнопкой **+** в удалённых сеансах |

869| `--allowedTools`, `--disallowedTools` | Нет эквивалента для каждого сеанса. Правила разрешений в [файлах параметров](/ru/settings) по-прежнему применяются. |869| `--allowedTools`, `--disallowedTools` | Нет эквивалента для каждого сеанса. Правила разрешений в [файлах параметров](/docs/ru/settings) по-прежнему применяются. |

870| `--verbose` | [Verbose view mode](#switch-view-modes) в раскрывающемся списке Transcript view |870| `--verbose` | [Verbose view mode](#switch-view-modes) в раскрывающемся списке Transcript view |

871| `--print`, `--output-format` | Недоступно. Desktop только интерактивный. |871| `--print`, `--output-format` | Недоступно. Desktop только интерактивный. |

872| `ANTHROPIC_MODEL` переменная окружения | Раскрывающийся список модели рядом с кнопкой отправки |872| `ANTHROPIC_MODEL` переменная окружения | Раскрывающийся список модели рядом с кнопкой отправки |


878 878 

879Desktop и CLI читают одни и те же файлы конфигурации, поэтому ваша установка переносится:879Desktop и CLI читают одни и те же файлы конфигурации, поэтому ваша установка переносится:

880 880 

881* **[CLAUDE.md](/ru/memory)** и `CLAUDE.local.md` файлы в вашем проекте используются обоими881* **[CLAUDE.md](/docs/ru/memory)** и `CLAUDE.local.md` файлы в вашем проекте используются обоими

882* **[MCP servers](/ru/mcp)** настроенные в `~/.claude.json` или `.mcp.json` работают в обоих882* **[MCP servers](/docs/ru/mcp)** настроенные в `~/.claude.json` или `.mcp.json` работают в обоих

883* **[Hooks](/ru/hooks)** и **[skills](/ru/skills)** определённые в параметрах применяются к обоим883* **[Hooks](/docs/ru/hooks)** и **[skills](/docs/ru/skills)** определённые в параметрах применяются к обоим

884* **[Settings](/ru/settings)** в `~/.claude.json` и `~/.claude/settings.json` общие. Правила разрешений, разрешённые инструменты и другие параметры в `settings.json` применяются к сеансам Desktop.884* **[Settings](/docs/ru/settings)** в `~/.claude.json` и `~/.claude/settings.json` общие. Правила разрешений, разрешённые инструменты и другие параметры в `settings.json` применяются к сеансам Desktop.

885* **Models**: те же [модели](/ru/model-config#available-models) доступны в обоих. В Desktop выберите модель из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить модель во время сеанса из того же раскрывающегося списка.885* **Models**: те же [модели](/docs/ru/model-config#available-models) доступны в обоих. В Desktop выберите модель из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить модель во время сеанса из того же раскрывающегося списка.

886 886 

887<Note>887<Note>

888 **MCP servers из приложения Claude Desktop chat**: приложение Desktop загружает MCP servers из `claude_desktop_config.json` в сеансы вкладки Code, наряду с серверами из `~/.claude.json` и `.mcp.json`. Сервер, определённый в `claude_desktop_config.json`, доступен как в поверхности Desktop chat, так и в вкладке Code.888 **MCP servers из приложения Claude Desktop chat**: приложение Desktop загружает MCP servers из `claude_desktop_config.json` в сеансы вкладки Code, наряду с серверами из `~/.claude.json` и `.mcp.json`. Сервер, определённый в `claude_desktop_config.json`, доступен как в поверхности Desktop chat, так и в вкладке Code.

889 889 

890 Автономный CLI не читает `claude_desktop_config.json`. На macOS и WSL запустите `claude mcp add-from-claude-desktop`, чтобы скопировать эти серверы в `~/.claude.json`. См. [Импорт MCP servers из Claude Desktop](/ru/mcp#import-mcp-servers-from-claude-desktop) для потока импорта и опций области видимости.890 Автономный CLI не читает `claude_desktop_config.json`. На macOS и WSL запустите `claude mcp add-from-claude-desktop`, чтобы скопировать эти серверы в `~/.claude.json`. См. [Импорт MCP servers из Claude Desktop](/docs/ru/mcp#import-mcp-servers-from-claude-desktop) для потока импорта и опций области видимости.

891</Note>891</Note>

892 892 

893<h3 id="feature-comparison">893<h3 id="feature-comparison">

894 Сравнение функций894 Сравнение функций

895</h3>895</h3>

896 896 

897Эта таблица сравнивает основные возможности между CLI и Desktop. Для полного списка флагов CLI см. [справочник CLI](/ru/cli-reference).897Эта таблица сравнивает основные возможности между CLI и Desktop. Для полного списка флагов CLI см. [справочник CLI](/docs/ru/cli-reference).

898 898 

899| Функция | CLI | Desktop |899| Функция | CLI | Desktop |

900| ---------------------------------------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |900| ---------------------------------------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

901| Режимы разрешений | Все режимы, включая `dontAsk` | Manual, Accept edits, Plan и Auto. Bypass permissions появляется в селекторе режима после того, как вы включите его: через переключатель Settings на планах Pro и Max, или через политику организации на планах Team и Enterprise |901| Режимы разрешений | Все режимы, включая `dontAsk` | Manual, Accept edits, Plan и Auto. Bypass permissions появляется в селекторе режима после того, как вы включите его: через переключатель Settings на планах Pro и Max, или через политику организации на планах Team и Enterprise |

902| `--dangerously-skip-permissions` | Флаг CLI | Режим Bypass permissions. На планах Pro и Max включите его в Settings → Claude Code → "Allow bypass permissions mode"; на планах Team и Enterprise политика организации контролирует это |902| `--dangerously-skip-permissions` | Флаг CLI | Режим Bypass permissions. На планах Pro и Max включите его в Settings → Claude Code → "Allow bypass permissions mode"; на планах Team и Enterprise политика организации контролирует это |

903| [Сторонние провайдеры](/ru/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API по умолчанию. Для маршрутизации через шлюз см. [подключение приложения desktop к шлюзу](/ru/llm-gateway-connect#desktop-app). Чтобы запустить вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM, см. [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |903| [Сторонние провайдеры](/docs/ru/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | Anthropic's API по умолчанию. Для маршрутизации через шлюз см. [подключение приложения desktop к шлюзу](/docs/ru/llm-gateway-connect#desktop-app). Чтобы запустить вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM, см. [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |

904| [MCP servers](/ru/mcp) | Настройте в файлах параметров | UI Connectors для локальных и SSH-сеансов, или файлы параметров |904| [MCP servers](/docs/ru/mcp) | Настройте в файлах параметров | UI Connectors для локальных и SSH-сеансов, или файлы параметров |

905| [Plugins](/ru/plugins) | Команда `/plugin` | UI менеджера плагинов |905| [Plugins](/docs/ru/plugins) | Команда `/plugin` | UI менеджера плагинов |

906| @mention файлы | Текстовые | С автодополнением; локальные и SSH-сеансы только |906| @mention файлы | Текстовые | С автодополнением; локальные и SSH-сеансы только |

907| Вложения файлов | Недоступно | Изображения, PDF |907| Вложения файлов | Недоступно | Изображения, PDF |

908| Изоляция сеанса | Флаг [`--worktree`](/ru/cli-reference) | Автоматические worktrees |908| Изоляция сеанса | Флаг [`--worktree`](/docs/ru/cli-reference) | Автоматические worktrees |

909| Несколько сеансов | Отдельные терминалы | Вкладки боковой панели |909| Несколько сеансов | Отдельные терминалы | Вкладки боковой панели |

910| Повторяющиеся задачи | Cron jobs, CI pipelines | [Запланированные задачи](/ru/desktop-scheduled-tasks) |910| Повторяющиеся задачи | Cron jobs, CI pipelines | [Запланированные задачи](/docs/ru/desktop-scheduled-tasks) |

911| Использование компьютера | [Включение через `/mcp`](/ru/computer-use) на macOS | [Управление приложениями и экраном](#let-claude-use-your-computer) на macOS и Windows |911| Использование компьютера | [Включение через `/mcp`](/docs/ru/computer-use) на macOS | [Управление приложениями и экраном](#let-claude-use-your-computer) на macOS и Windows |

912| Dispatch интеграция | Недоступно | [Сеансы Dispatch](#sessions-from-dispatch) в боковой панели |912| Dispatch интеграция | Недоступно | [Сеансы Dispatch](#sessions-from-dispatch) в боковой панели |

913| Скрипты и автоматизация | [`--print`](/ru/cli-reference), [Agent SDK](/ru/headless) | Недоступно |913| Скрипты и автоматизация | [`--print`](/docs/ru/cli-reference), [Agent SDK](/docs/ru/headless) | Недоступно |

914 914 

915<h3 id="what’s-not-available-in-desktop">915<h3 id="what’s-not-available-in-desktop">

916 Что недоступно в Desktop916 Что недоступно в Desktop


918 918 

919Следующие функции доступны только в CLI или расширении VS Code, кроме случаев, указанных ниже:919Следующие функции доступны только в CLI или расширении VS Code, кроме случаев, указанных ниже:

920 920 

921* **Сторонние провайдеры**: Desktop подключается к API Anthropic по умолчанию. Для маршрутизации Desktop через шлюз см. [подключение приложения desktop к шлюзу](/ru/llm-gateway-connect#desktop-app). Развёртывания предприятия могут конфигурировать Google Cloud's Agent Platform и провайдеров шлюза через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration). Для Amazon Bedrock или Microsoft Foundry в CLI см. [quickstart](/ru/quickstart). В качестве исключения из раздела выше, [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM.921* **Сторонние провайдеры**: Desktop подключается к API Anthropic по умолчанию. Для маршрутизации Desktop через шлюз см. [подключение приложения desktop к шлюзу](/docs/ru/llm-gateway-connect#desktop-app). Развёртывания предприятия могут конфигурировать Google Cloud's Agent Platform и провайдеров шлюза через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration). Для Amazon Bedrock или Microsoft Foundry в CLI см. [quickstart](/docs/ru/quickstart). В качестве исключения из раздела выше, [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM.

922* **Linux (бета)**: Computer Use ещё недоступна в приложении desktop Linux. См. [Claude Desktop на Linux](/ru/desktop-linux).922* **Linux (бета)**: Computer Use ещё недоступна в приложении desktop Linux. См. [Claude Desktop на Linux](/docs/ru/desktop-linux).

923* **Встроенные предложения кода**: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.923* **Встроенные предложения кода**: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.

924* **Команды агентов**: параллельные сеансы Claude Code, которые обмениваются сообщениями друг с другом, доступны в [CLI](/ru/agent-teams), а не в Desktop. Для многоагентной работы внутри одного сеанса используйте [динамические рабочие процессы](/ru/workflows), которые работают в Desktop.924* **Команды агентов**: параллельные сеансы Claude Code, которые обмениваются сообщениями друг с другом, доступны в [CLI](/docs/ru/agent-teams), а не в Desktop. Для многоагентной работы внутри одного сеанса используйте [динамические рабочие процессы](/docs/ru/workflows), которые работают в Desktop.

925* **Команды диалога терминала**: встроенные команды, которые открывают интерактивную панель в терминале, ведут себя иначе на вкладке Code. Отредактируйте [файлы параметров](/ru/settings) напрямую, чтобы управлять правилами разрешений и конфигурацией, или запустите команды из автономного CLI.925* **Команды диалога терминала**: встроенные команды, которые открывают интерактивную панель в терминале, ведут себя иначе на вкладке Code. Отредактируйте [файлы параметров](/docs/ru/settings) напрямую, чтобы управлять правилами разрешений и конфигурацией, или запустите команды из автономного CLI.

926 * Команды без формы аргумента, такие как `/permissions`, отвечают с `isn't available in this environment`.926 * Команды без формы аргумента, такие как `/permissions`, отвечают с `isn't available in this environment`.

927 * `/config` открывает Settings → Claude Code. Текст после команды игнорируется, поэтому `/config theme=dark` не устанавливает тему.927 * `/config` открывает Settings → Claude Code. Текст после команды игнорируется, поэтому `/config theme=dark` не устанавливает тему.

928 928 


930 Устранение неполадок930 Устранение неполадок

931</h2>931</h2>

932 932 

933Разделы ниже охватывают проблемы, специфичные для приложения desktop. Для ошибок API времени выполнения, которые появляются в чате, такие как `API Error: 500`, `529 Overloaded`, `429` или `Prompt is too long`, см. [справочник ошибок](/ru/errors). Эти ошибки и их исправления одинаковы для CLI, desktop и веб.933Разделы ниже охватывают проблемы, специфичные для приложения desktop. Для ошибок API времени выполнения, которые появляются в чате, такие как `API Error: 500`, `529 Overloaded`, `429` или `Prompt is too long`, см. [справочник ошибок](/docs/ru/errors). Эти ошибки и их исправления одинаковы для CLI, desktop и веб.

934 934 

935<h3 id="check-your-version">935<h3 id="check-your-version">

936 Проверка вашей версии936 Проверка вашей версии


961Если приложение открывается, но показывает пустой или неответный экран:961Если приложение открывается, но показывает пустой или неответный экран:

962 962 

9631. Перезагрузите приложение.9631. Перезагрузите приложение.

9642. Проверьте наличие ожидающих обновлений. На macOS и Windows приложение автоматически обновляется при запуске; на Linux обновите через apt, как описано в [Claude Desktop на Linux](/ru/desktop-linux).9642. Проверьте наличие ожидающих обновлений. На macOS и Windows приложение автоматически обновляется при запуске; на Linux обновите через apt, как описано в [Claude Desktop на Linux](/docs/ru/desktop-linux).

9653. На управляемой сети убедитесь, что ваш брандмауэр разрешает хосты CDN в [требованиях к сетевому доступу](#network-access-requirements).9653. На управляемой сети убедитесь, что ваш брандмауэр разрешает хосты CDN в [требованиях к сетевому доступу](#network-access-requirements).

9664. На Windows проверьте Event Viewer на логи сбоев под **Windows Logs → Application**.9664. На Windows проверьте Event Viewer на логи сбоев под **Windows Logs → Application**.

967 967 

Details

8 8 

9Плагины расширяют Claude Code с помощью skills, agents, hooks и MCP servers. Маркетплейсы плагинов — это каталоги, которые помогают вам обнаруживать и устанавливать эти расширения без необходимости создавать их самостоятельно.9Плагины расширяют Claude Code с помощью skills, agents, hooks и MCP servers. Маркетплейсы плагинов — это каталоги, которые помогают вам обнаруживать и устанавливать эти расширения без необходимости создавать их самостоятельно.

10 10 

11Ищете способ создать и распространять свой собственный маркетплейс? См. [Создание и распространение маркетплейса плагинов](/ru/plugin-marketplaces).11Ищете способ создать и распространять свой собственный маркетплейс? См. [Создание и распространение маркетплейса плагинов](/docs/ru/plugin-marketplaces).

12 12 

13<h2 id="how-marketplaces-work">13<h2 id="how-marketplaces-work">

14 Как работают маркетплейсы14 Как работают маркетплейсы


43Если Claude Code сообщает, что плагин не найден ни в одном маркетплейсе, ваш маркетплейс либо отсутствует, либо устарел. Запустите `/plugin marketplace update claude-plugins-official` для его обновления, или `/plugin marketplace add anthropics/claude-plugins-official`, если вы еще не добавили его. Затем повторите попытку установки.43Если Claude Code сообщает, что плагин не найден ни в одном маркетплейсе, ваш маркетплейс либо отсутствует, либо устарел. Запустите `/plugin marketplace update claude-plugins-official` для его обновления, или `/plugin marketplace add anthropics/claude-plugins-official`, если вы еще не добавили его. Затем повторите попытку установки.

44 44 

45<Note>45<Note>

46 Официальный маркетплейс поддерживается компанией Anthropic, и включение осуществляется по усмотрению Anthropic. Встроенные формы отправки в приложении добавляют плагины в [маркетплейс сообщества](#community-marketplace), а не в официальный. Чтобы распространять плагины независимо, [создайте свой собственный маркетплейс](/ru/plugin-marketplaces) и поделитесь им с пользователями.46 Официальный маркетплейс поддерживается компанией Anthropic, и включение осуществляется по усмотрению Anthropic. Встроенные формы отправки в приложении добавляют плагины в [маркетплейс сообщества](#community-marketplace), а не в официальный. Чтобы распространять плагины независимо, [создайте свой собственный маркетплейс](/docs/ru/plugin-marketplaces) и поделитесь им с пользователями.

47</Note>47</Note>

48 48 

49Официальный маркетплейс включает несколько категорий плагинов:49Официальный маркетплейс включает несколько категорий плагинов:


70| Swift | `swift-lsp` | `sourcekit-lsp` |70| Swift | `swift-lsp` | `sourcekit-lsp` |

71| TypeScript | `typescript-lsp` | `typescript-language-server` |71| TypeScript | `typescript-lsp` | `typescript-language-server` |

72 72 

73Вы также можете [создать свой собственный LSP plugin](/ru/plugins-reference#lsp-servers) для других языков.73Вы также можете [создать свой собственный LSP plugin](/docs/ru/plugins-reference#lsp-servers) для других языков.

74 74 

75<Note>75<Note>

76 Если вы видите `Executable not found in $PATH` на вкладке `/plugin` Errors после установки плагина, установите требуемый двоичный файл из таблицы выше.76 Если вы видите `Executable not found in $PATH` на вкладке `/plugin` Errors после установки плагина, установите требуемый двоичный файл из таблицы выше.


91 External integrations91 External integrations

92</h3>92</h3>

93 93 

94Эти плагины объединяют предварительно настроенные [MCP servers](/ru/mcp), чтобы вы могли подключить Claude к внешним сервисам без ручной настройки:94Эти плагины объединяют предварительно настроенные [MCP servers](/docs/ru/mcp), чтобы вы могли подключить Claude к внешним сервисам без ручной настройки:

95 95 

96* **Source control**: `github`, `gitlab`96* **Source control**: `github`, `gitlab`

97* **Project management**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`97* **Project management**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`


104 Automatic security review104 Automatic security review

105</h3>105</h3>

106 106 

107Плагин `security-guidance` проверяет каждое изменение, которое делает Claude, на предмет распространённых уязвимостей и инструктирует Claude исправить найденные проблемы в том же сеансе. См. [Catch security issues as Claude writes code](/ru/security-guidance) для получения информации о том, что он проверяет и как добавить правила, специфичные для проекта.107Плагин `security-guidance` проверяет каждое изменение, которое делает Claude, на предмет распространённых уязвимостей и инструктирует Claude исправить найденные проблемы в том же сеансе. См. [Catch security issues as Claude writes code](/docs/ru/security-guidance) для получения информации о том, что он проверяет и как добавить правила, специфичные для проекта.

108 108 

109<h3 id="development-workflows">109<h3 id="development-workflows">

110 Development workflows110 Development workflows


142/plugin install <plugin-name>@claude-community142/plugin install <plugin-name>@claude-community

143```143```

144 144 

145Чтобы отправить свой плагин в маркетплейс сообщества, см. [Отправьте свой плагин в маркетплейс сообщества](/ru/plugins#submit-your-plugin-to-the-community-marketplace) в руководстве по созданию плагинов.145Чтобы отправить свой плагин в маркетплейс сообщества, см. [Отправьте свой плагин в маркетплейс сообщества](/docs/ru/plugins#submit-your-plugin-to-the-community-marketplace) в руководстве по созданию плагинов.

146 146 

147<h2 id="try-it-add-the-demo-marketplace">147<h2 id="try-it-add-the-demo-marketplace">

148 Попробуйте: добавьте демо-маркетплейс148 Попробуйте: добавьте демо-маркетплейс


169 * **Marketplaces**: добавляйте, удаляйте или обновляйте добавленные маркетплейсы169 * **Marketplaces**: добавляйте, удаляйте или обновляйте добавленные маркетплейсы

170 * **Errors**: просмотрите любые ошибки загрузки плагинов170 * **Errors**: просмотрите любые ошибки загрузки плагинов

171 171 

172 Перейдите на вкладку **Discover**, чтобы увидеть плагины из маркетплейса, который вы только что добавили. {/* min-version: 2.1.154 */}Когда ваш администратор добавил маркетплейс в список разрешённых через управляемый параметр [`pluginSuggestionMarketplaces`](/ru/settings#available-settings), плагины, отмеченные как релевантные для вашего текущего рабочего каталога, закреплены в верхней части с меткой **suggested for this directory**.172 Перейдите на вкладку **Discover**, чтобы увидеть плагины из маркетплейса, который вы только что добавили. Когда ваш администратор добавил маркетплейс в список разрешённых через управляемый параметр [`pluginSuggestionMarketplaces`](/docs/ru/settings#available-settings), плагины, отмеченные как релевантные для вашего текущего рабочего каталога, закреплены в верхней части с меткой **suggested for this directory**.

173 </Step>173 </Step>

174 174 

175 <Step title="Установите плагин">175 <Step title="Установите плагин">

176 Выберите плагин для просмотра его деталей. На панели деталей показано, что содержит плагин и сколько это стоит:176 Выберите плагин для просмотра его деталей. На панели деталей показано, что содержит плагин и сколько это стоит:

177 177 

178 * {/* min-version: 2.1.143 */}Оценка **Context cost**, чтобы вы могли увидеть, сколько токенов плагин добавит к вашему [окну контекста](/ru/features-overview#understand-context-costs) каждый ход (Claude Code v2.1.143 и более поздние версии)178 * Оценка **Context cost**, чтобы вы могли увидеть, сколько токенов плагин добавит к вашему [окну контекста](/docs/ru/features-overview#understand-context-costs) каждый ход (Claude Code v2.1.143 и более поздние версии)

179 * {/* min-version: 2.1.144 */}Дата **Last updated** плагина (v2.1.144 и более поздние версии)179 * Дата **Last updated** плагина (v2.1.144 и более поздние версии)

180 * {/* min-version: 2.1.145 */}Раздел **Will install**, в котором перечислены команды, агенты, skills, hooks и серверы MCP и LSP плагина, чтобы вы могли просмотреть ровно то, что он добавляет перед установкой (v2.1.145 и более поздние версии)180 * Раздел **Will install**, в котором перечислены команды, агенты, skills, hooks и серверы MCP и LSP плагина, чтобы вы могли просмотреть ровно то, что он добавляет перед установкой (v2.1.145 и более поздние версии)

181 181 

182 Выберите область установки:182 Выберите область установки:

183 183 


193 /plugin install commit-commands@claude-code-plugins193 /plugin install commit-commands@claude-code-plugins

194 ```194 ```

195 195 

196 См. [Configuration scopes](/ru/settings#configuration-scopes), чтобы узнать больше об областях.196 См. [Configuration scopes](/docs/ru/settings#configuration-scopes), чтобы узнать больше об областях.

197 </Step>197 </Step>

198 198 

199 <Step title="Используйте свой новый плагин">199 <Step title="Используйте свой новый плагин">


293```293```

294 294 

295<Note>295<Note>

296 Маркетплейсы на основе URL имеют некоторые ограничения по сравнению с маркетплейсами на основе Git. Если вы столкнулись с ошибками "path not found" при установке плагинов, см. [Troubleshooting](/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).296 Маркетплейсы на основе URL имеют некоторые ограничения по сравнению с маркетплейсами на основе Git. Если вы столкнулись с ошибками "path not found" при установке плагинов, см. [Troubleshooting](/docs/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).

297</Note>297</Note>

298 298 

299<h2 id="install-plugins">299<h2 id="install-plugins">


306/plugin install plugin-name@marketplace-name306/plugin install plugin-name@marketplace-name

307```307```

308 308 

309Команда открывает детали плагина, где вы выбираете [область установки](/ru/settings#configuration-scopes). Вы видите те же варианты, когда запускаете `/plugin`, переходите на вкладку **Discover** и нажимаете **Enter** на плагине:309Команда открывает детали плагина, где вы выбираете [область установки](/docs/ru/settings#configuration-scopes). Вы видите те же варианты, когда запускаете `/plugin`, переходите на вкладку **Discover** и нажимаете **Enter** на плагине:

310 310 

311* **User scope** (по умолчанию): установите для себя во всех проектах311* **User scope** (по умолчанию): установите для себя во всех проектах

312* **Project scope**: установите для всех сотрудников в этом репозитории, что добавляет плагин в `.claude/settings.json`312* **Project scope**: установите для всех сотрудников в этом репозитории, что добавляет плагин в `.claude/settings.json`

313* **Local scope**: установите для себя в этом репозитории только, не делится с сотрудниками313* **Local scope**: установите для себя в этом репозитории только, не делится с сотрудниками

314 314 

315Чтобы установить без интерактивного шага, используйте команду оболочки [`claude plugin install`](/ru/plugins-reference#plugin-install), которая устанавливает в область пользователя, если вы не передадите `--scope`.315Чтобы установить без интерактивного шага, используйте команду оболочки [`claude plugin install`](/docs/ru/plugins-reference#plugin-install), которая устанавливает в область пользователя, если вы не передадите `--scope`.

316 316 

317Вы также можете увидеть плагины с областью **managed**. Они установлены администраторами через [управляемые параметры](/ru/settings#settings-files) и не могут быть изменены.317Вы также можете увидеть плагины с областью **managed**. Они установлены администраторами через [управляемые параметры](/docs/ru/settings#settings-files) и не могут быть изменены.

318 318 

319<Warning>319<Warning>

320 Убедитесь, что вы доверяете плагину перед его установкой. Anthropic не контролирует, какие MCP servers, файлы или другое программное обеспечение включены в плагины, и не может проверить, что они работают как предполагается. Проверьте домашнюю страницу каждого плагина для получения дополнительной информации.320 Убедитесь, что вы доверяете плагину перед его установкой. Anthropic не контролирует, какие MCP servers, файлы или другое программное обеспечение включены в плагины, и не может проверить, что они работают как предполагается. Проверьте домашнюю страницу каждого плагина для получения дополнительной информации.


343* плагины, которыми управляет ваша организация, или которые вы загружаете с помощью `--plugin-dir`343* плагины, которыми управляет ваша организация, или которые вы загружаете с помощью `--plugin-dir`

344* плагины, которые предоставляют тему, стиль вывода, монитор или workflow, поскольку они обеспечивают ценность без вызова для отслеживания344* плагины, которые предоставляют тему, стиль вывода, монитор или workflow, поскольку они обеспечивают ценность без вызова для отслеживания

345 345 

346Заголовок **Not used recently** и строка **Last used** обе скрыты, когда ваша организация ограничивает маркетплейсы с помощью [`strictKnownMarketplaces`](/ru/settings#strictknownmarketplaces).346Заголовок **Not used recently** и строка **Last used** обе скрыты, когда ваша организация ограничивает маркетплейсы с помощью [`strictKnownMarketplaces`](/docs/ru/settings#strictknownmarketplaces).

347 347 

348[Language server](/ru/plugins#add-lsp-servers-to-your-plugin) плагина считается использованным, когда он предоставляет диагностику или отвечает на запрос навигации по коду, поэтому плагин LSP, чей сервер активен в ваших сеансах, не отображается как неиспользуемый. До v2.1.203 активность языкового сервера не могла быть учтена как использование, поэтому плагины, которые предоставляют LSP server, были полностью исключены из группы, так же как плагины темы и стиля вывода по-прежнему есть.348[Language server](/docs/ru/plugins#add-lsp-servers-to-your-plugin) плагина считается использованным, когда он предоставляет диагностику или отвечает на запрос навигации по коду, поэтому плагин LSP, чей сервер активен в ваших сеансах, не отображается как неиспользуемый. До v2.1.203 активность языкового сервера не могла быть учтена как использование, поэтому плагины, которые предоставляют LSP server, были полностью исключены из группы, так же как плагины темы и стиля вывода по-прежнему есть.

349 349 

350Первый сеанс в версии, которая считает активность языкового сервера, также сбрасывает запись об использовании каждого плагина LSP, который еще не записал никакого использования, поэтому Claude Code не судит плагин, который вы установили ранее, как неиспользуемый на основе данных, записанных до того, как была отслежена активность его сервера. До v2.1.206 этот первый сеанс мог отобразить активно используемый плагин LSP под заголовком **Not used recently** и предложить его проверить.350Первый сеанс в версии, которая считает активность языкового сервера, также сбрасывает запись об использовании каждого плагина LSP, который еще не записал никакого использования, поэтому Claude Code не судит плагин, который вы установили ранее, как неиспользуемый на основе данных, записанных до того, как была отслежена активность его сервера. До v2.1.206 этот первый сеанс мог отобразить активно используемый плагин LSP под заголовком **Not used recently** и предложить его проверить.

351 351 


373/plugin enable plugin-name@marketplace-name373/plugin enable plugin-name@marketplace-name

374```374```

375 375 

376В этих идентификаторах `plugin-name` — это `name` плагина в [записи маркетплейса](/ru/plugin-marketplaces#plugin-entries), которое может отличаться от `name` в собственном `plugin.json` плагина.376В этих идентификаторах `plugin-name` — это `name` плагина в [записи маркетплейса](/docs/ru/plugin-marketplaces#plugin-entries), которое может отличаться от `name` в собственном `plugin.json` плагина.

377 377 

378Начиная с Claude Code v2.1.195, **Enable** и **Disable** в интерфейсе `/plugin` работают для плагинов, у которых два имени отличаются, и `/plugin enable` и `/plugin disable` принимают любое имя. Когда вы отключаете такой плагин в более ранней версии, Claude Code сообщает `already disabled` и оставляет его включенным.378Начиная с Claude Code v2.1.195, **Enable** и **Disable** в интерфейсе `/plugin` работают для плагинов, у которых два имени отличаются, и `/plugin enable` и `/plugin disable` принимают любое имя. Когда вы отключаете такой плагин в более ранней версии, Claude Code сообщает `already disabled` и оставляет его включенным.

379 379 


402 402 

403Claude Code перезагружает все активные плагины и показывает количество плагинов, skills, agents, hooks, plugin MCP servers и plugin LSP servers.403Claude Code перезагружает все активные плагины и показывает количество плагинов, skills, agents, hooks, plugin MCP servers и plugin LSP servers.

404 404 

405Перезагрузка имеет стоимость токенов при следующем запросе: вновь загруженные компоненты объявляют о себе в содержимом, добавленном к беседе, в то время как существующая история по-прежнему читается из кэша подсказок. Плагин, который предоставляет MCP servers, стоит дороже, когда его инструменты не отложены [поиском инструментов](/ru/mcp#scale-with-mcp-tool-search): изменение делает кэш недействительным, и следующий запрос повторно читает всю беседу. {/* min-version: 2.1.163 */}В этом случае `/reload-plugins` показывает предупреждение и не применяет перезагрузку; передайте `--force`, чтобы применить в любом случае. Подробнее см. в разделе [включение или отключение плагина](/ru/prompt-caching#enabling-or-disabling-a-plugin).405Перезагрузка имеет стоимость токенов при следующем запросе: вновь загруженные компоненты объявляют о себе в содержимом, добавленном к беседе, в то время как существующая история по-прежнему читается из кэша подсказок. Плагин, который предоставляет MCP servers, стоит дороже, когда его инструменты не отложены [поиском инструментов](/docs/ru/mcp#scale-with-mcp-tool-search): изменение делает кэш недействительным, и следующий запрос повторно читает всю беседу. В этом случае `/reload-plugins` показывает предупреждение и не применяет перезагрузку; передайте `--force`, чтобы применить в любом случае. Подробнее см. в разделе [включение или отключение плагина](/docs/ru/prompt-caching#enabling-or-disabling-a-plugin).

406 406 

407<h2 id="manage-marketplaces">407<h2 id="manage-marketplaces">

408 Управление маркетплейсами408 Управление маркетплейсами


466 466 

467Официальные маркетплейсы Anthropic имеют автоматическое обновление, включенное по умолчанию. Маркетплейсы третьих сторон и локальной разработки имеют автоматическое обновление, отключенное по умолчанию.467Официальные маркетплейсы Anthropic имеют автоматическое обновление, включенное по умолчанию. Маркетплейсы третьих сторон и локальной разработки имеют автоматическое обновление, отключенное по умолчанию.

468 468 

469Администраторы также могут установить `"autoUpdate": true` для каждой записи [`extraKnownMarketplaces`](/ru/settings#extraknownmarketplaces) в управляемых параметрах, чтобы включить автоматическое обновление для маркетплейса организации без необходимости переключения каждым пользователем.469Администраторы также могут установить `"autoUpdate": true` для каждой записи [`extraKnownMarketplaces`](/docs/ru/settings#extraknownmarketplaces) в управляемых параметрах, чтобы включить автоматическое обновление для маркетплейса организации без необходимости переключения каждым пользователем.

470 470 

471Чтобы полностью отключить все автоматические обновления для Claude Code и всех плагинов, установите переменную окружения `DISABLE_AUTOUPDATER`. См. [Auto updates](/ru/setup#auto-updates) для получения подробной информации.471Чтобы полностью отключить все автоматические обновления для Claude Code и всех плагинов, установите переменную окружения `DISABLE_AUTOUPDATER`. См. [Auto updates](/docs/ru/setup#auto-updates) для получения подробной информации.

472 472 

473Чтобы сохранить автоматические обновления плагинов включенными при отключении автоматических обновлений Claude Code, установите `FORCE_AUTOUPDATE_PLUGINS=1` вместе с `DISABLE_AUTOUPDATER`:473Чтобы сохранить автоматические обновления плагинов включенными при отключении автоматических обновлений Claude Code, установите `FORCE_AUTOUPDATE_PLUGINS=1` вместе с `DISABLE_AUTOUPDATER`:

474 474 


502}502}

503```503```

504 504 

505Для полных опций конфигурации, включая `extraKnownMarketplaces` и `enabledPlugins`, см. [Plugin settings](/ru/settings#plugin-settings).505Для полных опций конфигурации, включая `extraKnownMarketplaces` и `enabledPlugins`, см. [Plugin settings](/docs/ru/settings#plugin-settings).

506 506 

507<h2 id="security">507<h2 id="security">

508 Безопасность508 Безопасность

509</h2>509</h2>

510 510 

511Плагины и маркетплейсы — это высоконадежные компоненты, которые могут выполнять произвольный код на вашей машине с вашими привилегиями пользователя. Устанавливайте плагины и добавляйте маркетплейсы только из источников, которым вы доверяете. Организации могут ограничить, какие маркетплейсы пользователям разрешено добавлять, используя [managed marketplace restrictions](/ru/plugin-marketplaces#managed-marketplace-restrictions).511Плагины и маркетплейсы — это высоконадежные компоненты, которые могут выполнять произвольный код на вашей машине с вашими привилегиями пользователя. Устанавливайте плагины и добавляйте маркетплейсы только из источников, которым вы доверяете. Организации могут ограничить, какие маркетплейсы пользователям разрешено добавлять, используя [managed marketplace restrictions](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions).

512 512 

513<h2 id="troubleshooting">513<h2 id="troubleshooting">

514 Troubleshooting514 Troubleshooting


5242. **Update Claude Code**:5242. **Update Claude Code**:

525 * **Homebrew**: `brew upgrade claude-code`, или `brew upgrade claude-code@latest`, если вы установили этот cask525 * **Homebrew**: `brew upgrade claude-code`, или `brew upgrade claude-code@latest`, если вы установили этот cask

526 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`526 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`

527 * **Native installer**: повторно запустите команду установки из [Setup](/ru/setup)527 * **Native installer**: повторно запустите команду установки из [Setup](/docs/ru/setup)

5283. **Restart Claude Code**: после обновления перезагрузите терминал и снова запустите `claude`.5283. **Restart Claude Code**: после обновления перезагрузите терминал и снова запустите `claude`.

529 529 

530<h3 id="common-issues">530<h3 id="common-issues">


536* **Files not found after installation**: плагины копируются в кэш, поэтому пути, ссылающиеся на файлы вне каталога плагина, не будут работать536* **Files not found after installation**: плагины копируются в кэш, поэтому пути, ссылающиеся на файлы вне каталога плагина, не будут работать

537* **Plugin skills not appearing**: очистите кэш с помощью `rm -rf ~/.claude/plugins/cache`, перезагрузите Claude Code и переустановите плагин.537* **Plugin skills not appearing**: очистите кэш с помощью `rm -rf ~/.claude/plugins/cache`, перезагрузите Claude Code и переустановите плагин.

538 538 

539Для подробного устранения неполадок с решениями см. [Troubleshooting](/ru/plugin-marketplaces#troubleshooting) в руководстве маркетплейса. Для инструментов отладки см. [Debugging and development tools](/ru/plugins-reference#debugging-and-development-tools).539Для подробного устранения неполадок с решениями см. [Troubleshooting](/docs/ru/plugin-marketplaces#troubleshooting) в руководстве маркетплейса. Для инструментов отладки см. [Debugging and development tools](/docs/ru/plugins-reference#debugging-and-development-tools).

540 540 

541<h3 id="code-intelligence-issues">541<h3 id="code-intelligence-issues">

542 Code intelligence issues542 Code intelligence issues


550 Следующие шаги550 Следующие шаги

551</h2>551</h2>

552 552 

553* **Создавайте собственные плагины**: см. [Plugins](/ru/plugins) для создания skills, agents и hooks553* **Создавайте собственные плагины**: см. [Plugins](/docs/ru/plugins) для создания skills, agents и hooks

554* **Создайте marketplace**: см. [Create a plugin marketplace](/ru/plugin-marketplaces) для распространения плагинов вашей команде или сообществу554* **Создайте marketplace**: см. [Create a plugin marketplace](/docs/ru/plugin-marketplaces) для распространения плагинов вашей команде или сообществу

555* **Техническая справка**: см. [Plugins reference](/ru/plugins-reference) для полных спецификаций555* **Техническая справка**: см. [Plugins reference](/docs/ru/plugins-reference) для полных спецификаций

env-vars.md +197 −197

Details

6 6 

7> Справочник переменных окружения, которые управляют поведением Claude Code.7> Справочник переменных окружения, которые управляют поведением Claude Code.

8 8 

9Переменные окружения могут управлять поведением Claude Code, таким как выбор модели, аутентификация, маршрутизация запросов и переключатели функций. Многие из этих же поведений также можно настроить через [файл параметров](/ru/settings), [флаг CLI](/ru/cli-reference) или команду в сессии, такую как `/model`.9Переменные окружения могут управлять поведением Claude Code, таким как выбор модели, аутентификация, маршрутизация запросов и переключатели функций. Многие из этих же поведений также можно настроить через [файл параметров](/docs/ru/settings), [флаг CLI](/docs/ru/cli-reference) или команду в сессии, такую как `/model`.

10 10 

11На этой странице рассматривается, как:11На этой странице рассматривается, как:

12 12 


79| `.claude/settings.local.json` | Вам, только в этом проекте (добавьте его в ваш gitignore, если вы создадите его вручную) |79| `.claude/settings.local.json` | Вам, только в этом проекте (добавьте его в ваш gitignore, если вы создадите его вручную) |

80| Управляемые параметры | Всем в вашей организации, развёрнуто администратором |80| Управляемые параметры | Всем в вашей организации, развёрнуто администратором |

81 81 

82См. [Файлы параметров](/ru/settings#settings-files), чтобы узнать, где находится каждый файл, и [Приоритет параметров](/ru/settings#settings-precedence), чтобы узнать, как они объединяются, когда более одного устанавливает одну и ту же переменную.82См. [Файлы параметров](/docs/ru/settings#settings-files), чтобы узнать, где находится каждый файл, и [Приоритет параметров](/docs/ru/settings#settings-precedence), чтобы узнать, как они объединяются, когда более одного устанавливает одну и ту же переменную.

83 83 

84<h2 id="precedence">84<h2 id="precedence">

85 Приоритет85 Приоритет


87 87 

88Когда одно и то же поведение имеет как переменную окружения, так и поле параметров, переменная окружения имеет приоритет. Например, `ANTHROPIC_MODEL` переопределяет параметр `model`, а `CLAUDE_CODE_AUTO_CONNECT_IDE` переопределяет `autoConnectIde`. Поле параметров применяется, когда переменная окружения не установлена.88Когда одно и то же поведение имеет как переменную окружения, так и поле параметров, переменная окружения имеет приоритет. Например, `ANTHROPIC_MODEL` переопределяет параметр `model`, а `CLAUDE_CODE_AUTO_CONNECT_IDE` переопределяет `autoConnectIde`. Поле параметров применяется, когда переменная окружения не установлена.

89 89 

90Когда одна и та же переменная установлена как в вашей оболочке, так и в файле параметров в блоке `env`, применяется значение из файла параметров. Claude Code записывает каждую запись `env` в переменные окружения процесса при запуске, заменяя значение, унаследованное из оболочки. Несколько переменных обрабатываются специально; [параметр `env`](/ru/settings#available-settings) содержит список исключений.90Когда одна и та же переменная установлена как в вашей оболочке, так и в файле параметров в блоке `env`, применяется значение из файла параметров. Claude Code записывает каждую запись `env` в переменные окружения процесса при запуске, заменяя значение, унаследованное из оболочки. Несколько переменных обрабатываются специально; [параметр `env`](/docs/ru/settings#available-settings) содержит список исключений.

91 91 

92Между файлами параметров значения `env` следуют [приоритету параметров](/ru/settings#settings-precedence), поэтому управляемая запись параметров переопределяет ту же переменную в пользовательских или проектных параметрах.92Между файлами параметров значения `env` следуют [приоритету параметров](/docs/ru/settings#settings-precedence), поэтому управляемая запись параметров переопределяет ту же переменную в пользовательских или проектных параметрах.

93 93 

94То, как переменная окружения взаимодействует с флагами CLI и командами в сессии, варьируется в зависимости от функции: `--model` и `/model` переопределяют `ANTHROPIC_MODEL`, а `CLAUDE_CODE_EFFORT_LEVEL` переопределяет `/effort`. Когда переменная взаимодействует с другим источником конфигурации, её строка в списке [Переменные](#variables) указывает приоритет или ссылается на страницу, которая это документирует.94То, как переменная окружения взаимодействует с флагами CLI и командами в сессии, варьируется в зависимости от функции: `--model` и `/model` переопределяют `ANTHROPIC_MODEL`, а `CLAUDE_CODE_EFFORT_LEVEL` переопределяет `/effort`. Когда переменная взаимодействует с другим источником конфигурации, её строка в списке [Переменные](#variables) указывает приоритет или ссылается на страницу, которая это документирует.

95 95 


100</h2>100</h2>

101 101 

102| Переменная | Назначение |102| Переменная | Назначение |

103| :------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |103| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

104| `ANTHROPIC_API_KEY` | Ключ API, отправляемый как заголовок `X-Api-Key`. При установке этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии. В интерактивном режиме вам предлагается одобрить ключ один раз перед тем, как он переопределит вашу подписку. Чтобы использовать вашу подписку вместо этого, запустите `unset ANTHROPIC_API_KEY` |104| `ANTHROPIC_API_KEY` | Ключ API, отправляемый как заголовок `X-Api-Key`. При установке этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии. В интерактивном режиме вам предлагается одобрить ключ один раз перед тем, как он переопределит вашу подписку. Чтобы использовать вашу подписку вместо этого, запустите `unset ANTHROPIC_API_KEY` |

105| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (значение, которое вы установите здесь, будет дополнено префиксом `Bearer `) |105| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (значение, которое вы установите здесь, будет дополнено префиксом `Bearer `) |

106| `ANTHROPIC_AWS_API_KEY` | Ключ API рабочей области для [Claude Platform on AWS](/ru/claude-platform-on-aws), созданный в AWS Console. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |106| `ANTHROPIC_AWS_API_KEY` | Ключ API рабочей области для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), созданный в AWS Console. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |

107| `ANTHROPIC_AWS_BASE_URL` | Переопределить URL конечной точки [Claude Platform on AWS](/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [шлюз LLM](/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{AWS_REGION}.api.aws` |107| `ANTHROPIC_AWS_BASE_URL` | Переопределить URL конечной точки [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [шлюз LLM](/docs/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{AWS_REGION}.api.aws` |

108| `ANTHROPIC_AWS_WORKSPACE_ID` | Требуется для [Claude Platform on AWS](/ru/claude-platform-on-aws). Отправляется в каждом запросе как заголовок `anthropic-workspace-id` |108| `ANTHROPIC_AWS_WORKSPACE_ID` | Требуется для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Отправляется в каждом запросе как заголовок `anthropic-workspace-id` |

109| `ANTHROPIC_BASE_URL` | Переопределить конечную точку API для маршрутизации запросов через прокси или шлюз. При установке на хост, не являющийся хостом первой стороны, [поиск инструментов MCP](/ru/mcp#scale-with-mcp-tool-search) отключен по умолчанию. Установите `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. {/* min-version: 2.1.196 */}Начиная с v2.1.196, [Remote Control](/ru/remote-control#requirements) отключен, когда это указывает на хост, отличный от `api.anthropic.com`, что соответствует его поведению на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |109| `ANTHROPIC_BASE_URL` | Переопределить конечную точку API для маршрутизации запросов через прокси или шлюз. При установке на хост, не являющийся хостом первой стороны, [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен по умолчанию. Установите `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. Начиная с v2.1.196, [Remote Control](/docs/ru/remote-control#requirements) отключен, когда это указывает на хост, отличный от `api.anthropic.com`, что соответствует его поведению на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |

110| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock. Используйте для пользовательских конечных точек Amazon Bedrock или при маршрутизации через [шлюз LLM](/ru/llm-gateway). См. [Amazon Bedrock](/ru/amazon-bedrock) |110| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock. Используйте для пользовательских конечных точек Amazon Bedrock или при маршрутизации через [шлюз LLM](/docs/ru/llm-gateway). См. [Amazon Bedrock](/docs/ru/amazon-bedrock) |

111| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock Mantle. См. [конечная точка Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) |111| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock Mantle. См. [конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) |

112| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [уровень обслуживания](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` или `priority`). Отправляется как заголовок `X-Amzn-Bedrock-Service-Tier`. См. [Amazon Bedrock](/ru/amazon-bedrock#service-tiers) |112| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [уровень обслуживания](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` или `priority`). Отправляется как заголовок `X-Amzn-Bedrock-Service-Tier`. См. [Amazon Bedrock](/docs/ru/amazon-bedrock#service-tiers) |

113| `ANTHROPIC_BETAS` | Разделённый запятыми список дополнительных значений заголовка `anthropic-beta` для включения в запросы API. Claude Code уже отправляет необходимые ему заголовки beta; используйте это, чтобы согласиться на [бета-версию Anthropic API](https://platform.claude.com/docs/en/api/beta-headers) перед тем, как Claude Code добавит встроенную поддержку. В отличие от [флага `--betas`](/ru/cli-reference#cli-flags), который требует аутентификации с помощью ключа API, эта переменная работает со всеми методами аутентификации, включая подписку Claude.ai |113| `ANTHROPIC_BETAS` | Разделённый запятыми список дополнительных значений заголовка `anthropic-beta` для включения в запросы API. Claude Code уже отправляет необходимые ему заголовки beta; используйте это, чтобы согласиться на [бета-версию Anthropic API](https://platform.claude.com/docs/en/api/beta-headers) перед тем, как Claude Code добавит встроенную поддержку. В отличие от [флага `--betas`](/docs/ru/cli-reference#cli-flags), который требует аутентификации с помощью ключа API, эта переменная работает со всеми методами аутентификации, включая подписку Claude.ai |

114| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки для добавления к запросам (формат `Name: Value`, разделённые новой строкой для нескольких заголовков) |114| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки для добавления к запросам (формат `Name: Value`, разделённые новой строкой для нескольких заголовков) |

115| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели для добавления в качестве пользовательской записи в средство выбора `/model`. Используйте это, чтобы сделать нестандартную или специфичную для шлюза модель выбираемой без замены встроенных псевдонимов. См. [Конфигурация модели](/ru/model-config#add-a-custom-model-option) |115| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели для добавления в качестве пользовательской записи в средство выбора `/model`. Используйте это, чтобы сделать нестандартную или специфичную для шлюза модель выбираемой без замены встроенных псевдонимов. См. [Конфигурация модели](/docs/ru/model-config#add-a-custom-model-option) |

116| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Описание отображения для пользовательской записи модели в средстве выбора `/model`. По умолчанию `Custom model (<model-id>)` при отсутствии установки |116| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Описание отображения для пользовательской записи модели в средстве выбора `/model`. По умолчанию `Custom model (<model-id>)` при отсутствии установки |

117| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Имя отображения для пользовательской записи модели в средстве выбора `/model`. По умолчанию ID модели при отсутствии установки |117| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Имя отображения для пользовательской записи модели в средстве выбора `/model`. По умолчанию ID модели при отсутствии установки |

118| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |118| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

119| `ANTHROPIC_DEFAULT_FABLE_MODEL` | См. [Конфигурация модели](/ru/model-config#environment-variables) |119| `ANTHROPIC_DEFAULT_FABLE_MODEL` | См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

120| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |120| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

121| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |121| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

122| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |122| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

123| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | См. [Конфигурация модели](/ru/model-config#environment-variables) |123| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

124| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |124| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

125| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |125| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

126| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |126| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

127| `ANTHROPIC_DEFAULT_OPUS_MODEL` | См. [Конфигурация модели](/ru/model-config#environment-variables) |127| `ANTHROPIC_DEFAULT_OPUS_MODEL` | См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

128| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |128| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

129| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |129| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

130| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |130| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

131| `ANTHROPIC_DEFAULT_SONNET_MODEL` | См. [Конфигурация модели](/ru/model-config#environment-variables) |131| `ANTHROPIC_DEFAULT_SONNET_MODEL` | См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

132| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |132| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

133| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |133| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

134| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/ru/model-config#customize-pinned-model-display-and-capabilities) |134| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

135| `ANTHROPIC_FOUNDRY_API_KEY` | Ключ API для аутентификации Microsoft Foundry (см. [Microsoft Foundry](/ru/microsoft-foundry)) |135| `ANTHROPIC_FOUNDRY_API_KEY` | Ключ API для аутентификации Microsoft Foundry (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |

136| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | {/* min-version: 2.1.203 */}Bearer токен для аутентификации Microsoft Foundry, такой как токен доступа Microsoft Entra. Claude Code отправляет его как заголовок `Authorization: Bearer`. Имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY` и над цепочкой учётных данных Azure по умолчанию. См. [Microsoft Foundry](/ru/microsoft-foundry). Требуется Claude Code v2.1.203 или более поздняя версия |136| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Bearer токен для аутентификации Microsoft Foundry, такой как токен доступа Microsoft Entra. Claude Code отправляет его как заголовок `Authorization: Bearer`. Имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY` и над цепочкой учётных данных Azure по умолчанию. См. [Microsoft Foundry](/docs/ru/microsoft-foundry). Требуется Claude Code v2.1.203 или более поздняя версия |

137| `ANTHROPIC_FOUNDRY_BASE_URL` | Полный базовый URL для ресурса Microsoft Foundry (например, `https://my-resource.services.ai.azure.com/anthropic`). Альтернатива `ANTHROPIC_FOUNDRY_RESOURCE` (см. [Microsoft Foundry](/ru/microsoft-foundry)) |137| `ANTHROPIC_FOUNDRY_BASE_URL` | Полный базовый URL для ресурса Microsoft Foundry (например, `https://my-resource.services.ai.azure.com/anthropic`). Альтернатива `ANTHROPIC_FOUNDRY_RESOURCE` (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |

138| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Microsoft Foundry (например, `my-resource`). Требуется, если `ANTHROPIC_FOUNDRY_BASE_URL` не установлен (см. [Microsoft Foundry](/ru/microsoft-foundry)) |138| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Microsoft Foundry (например, `my-resource`). Требуется, если `ANTHROPIC_FOUNDRY_BASE_URL` не установлен (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |

139| `ANTHROPIC_MODEL` | Имя параметра модели для использования (см. [Конфигурация модели](/ru/model-config#environment-variables)) |139| `ANTHROPIC_MODEL` | Имя параметра модели для использования (см. [Конфигурация модели](/docs/ru/model-config#environment-variables)) |

140| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Имя [модели класса Haiku для фоновых задач](/ru/costs) |140| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Имя [модели класса Haiku для фоновых задач](/docs/ru/costs) |

141| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределить регион AWS для модели класса Haiku при использовании Amazon Bedrock или Amazon Bedrock Mantle. На Amazon Bedrock это вступает в силу только при установке `ANTHROPIC_DEFAULT_HAIKU_MODEL` или устаревшей переменной `ANTHROPIC_SMALL_FAST_MODEL`, так как Amazon Bedrock в противном случае использует основную модель для фоновых задач |141| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Переопределить регион AWS для модели класса Haiku при использовании Amazon Bedrock или Amazon Bedrock Mantle. На Amazon Bedrock это вступает в силу только при установке `ANTHROPIC_DEFAULT_HAIKU_MODEL` или устаревшей переменной `ANTHROPIC_SMALL_FAST_MODEL`, так как Amazon Bedrock в противном случае использует основную модель для фоновых задач |

142| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Google Cloud's Agent Platform. Используйте для пользовательских конечных точек Google Cloud's Agent Platform или при маршрутизации через [шлюз LLM](/ru/llm-gateway). См. [Google Cloud's Agent Platform](/ru/google-vertex-ai) |142| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Google Cloud's Agent Platform. Используйте для пользовательских конечных точек Google Cloud's Agent Platform или при маршрутизации через [шлюз LLM](/docs/ru/llm-gateway). См. [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |

143| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP для запросов Google Cloud's Agent Platform. Переопределяется `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` или проектом в файле учётных данных `GOOGLE_APPLICATION_CREDENTIALS`. См. [Google Cloud's Agent Platform](/ru/google-vertex-ai) |143| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP для запросов Google Cloud's Agent Platform. Переопределяется `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` или проектом в файле учётных данных `GOOGLE_APPLICATION_CREDENTIALS`. См. [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |

144| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, какую рабочую область выбрать |144| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, какую рабочую область выбрать |

145| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}Переопределить тайм-аут неактивности в 5 минут, который прерывает потоковый ответ модели, когда не поступают байты. Установите на `0`, чтобы отключить тайм-аут, например, когда медленный [шлюз](/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами. Установите на `1`, чтобы сохранить тайм-аут на каждом поставщике. Если не установлено, тайм-аут неактивен на прямом Anthropic API и соединениях [Claude Platform on AWS](/ru/claude-platform-on-aws), где работает собственный сторож потока Claude Code на уровне байтов, и активен на каждом другом поставщике, включая [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry), [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/ru/amazon-bedrock) и соединения шлюза, поэтому зависший поток прерывается вместо зависания. Начиная с v2.1.169 |145| `API_FORCE_IDLE_TIMEOUT` | Переопределить тайм-аут неактивности в 5 минут, который прерывает потоковый ответ модели, когда не поступают байты. Установите на `0`, чтобы отключить тайм-аут, например, когда медленный [шлюз](/docs/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами. Установите на `1`, чтобы сохранить тайм-аут на каждом поставщике. Если не установлено, тайм-аут неактивен на прямом Anthropic API и соединениях [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), где работает собственный сторож потока Claude Code на уровне байтов, и активен на каждом другом поставщике, включая [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry), [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), [Amazon Bedrock](/docs/ru/amazon-bedrock) и соединения шлюза, поэтому зависший поток прерывается вместо зависания. Начиная с v2.1.169 |

146| `API_TIMEOUT_MS` | Тайм-аут для запросов API в миллисекундах (по умолчанию: 600000, или 10 минут; максимум: 2147483647). Увеличьте это значение, когда запросы истекают на медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |146| `API_TIMEOUT_MS` | Тайм-аут для запросов API в миллисекундах (по умолчанию: 600000, или 10 минут; максимум: 2147483647). Увеличьте это значение, когда запросы истекают на медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |

147| `AWS_BEARER_TOKEN_BEDROCK` | Ключ API Amazon Bedrock для аутентификации (см. [Ключи API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |147| `AWS_BEARER_TOKEN_BEDROCK` | Ключ API Amazon Bedrock для аутентификации (см. [Ключи API Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

148| `BASH_DEFAULT_TIMEOUT_MS` | Тайм-аут по умолчанию для долгоживущих команд bash (по умолчанию: 120000, или 2 минуты) |148| `BASH_DEFAULT_TIMEOUT_MS` | Тайм-аут по умолчанию для долгоживущих команд bash (по умолчанию: 120000, или 2 минуты) |

149| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов в выводе bash перед сохранением полного вывода в файл и получением Claude пути плюс краткий предпросмотр. См. [Поведение инструмента Bash](/ru/tools-reference#bash-tool-behavior) |149| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов в выводе bash перед сохранением полного вывода в файл и получением Claude пути плюс краткий предпросмотр. См. [Поведение инструмента Bash](/docs/ru/tools-reference#bash-tool-behavior) |

150| `BASH_MAX_TIMEOUT_MS` | Максимальный тайм-аут, который модель может установить для долгоживущих команд bash (по умолчанию: 600000, или 10 минут) |150| `BASH_MAX_TIMEOUT_MS` | Максимальный тайм-аут, который модель может установить для долгоживущих команд bash (по умолчанию: 600000, или 10 минут) |

151| `CCR_FORCE_BUNDLE` | Установите на `1`, чтобы принудительно [`claude --cloud`](/ru/claude-code-on-the-web#send-local-repositories-without-github) объединить и загрузить ваш локальный репозиторий, даже когда доступ GitHub доступен |151| `CCR_FORCE_BUNDLE` | Установите на `1`, чтобы принудительно [`claude --cloud`](/docs/ru/claude-code-on-the-web#send-local-repositories-without-github) объединить и загрузить ваш локальный репозиторий, даже когда доступ GitHub доступен |

152| `CLAUDECODE` | Установите на `1` в подпроцессах, которые порождает Claude Code (инструмент Bash и PowerShell, сессии tmux, команды [hook](/ru/hooks), команды [строки состояния](/ru/statusline), подпроцессы [MCP server](/ru/mcp) stdio). IDE extensions также устанавливают это в их встроенных терминалах. Используйте для обнаружения, когда скрипт выполняется внутри подпроцесса, порождённого Claude Code. Чтобы проверить, был ли текущий процесс порождён непосредственно вызовом инструмента или hook, а не внутри stdio MCP server, который запустил Claude Code, используйте вместо этого `CLAUDE_CODE_CHILD_SESSION` |152| `CLAUDECODE` | Установите на `1` в подпроцессах, которые порождает Claude Code (инструмент Bash и PowerShell, сессии tmux, команды [hook](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline), подпроцессы [MCP server](/docs/ru/mcp) stdio). IDE extensions также устанавливают это в их встроенных терминалах. Используйте для обнаружения, когда скрипт выполняется внутри подпроцесса, порождённого Claude Code. Чтобы проверить, был ли текущий процесс порождён непосредственно вызовом инструмента или hook, а не внутри stdio MCP server, который запустил Claude Code, используйте вместо этого `CLAUDE_CODE_CHILD_SESSION` |

153| `CLAUDE_AFK_COUNTDOWN_MS` | {/* min-version: 2.1.198 */}Сколько миллисекунд перед автоматическим продолжением появляется обратный отсчёт на экране в диалоговом окне [`AskUserQuestion`](/ru/tools-reference) без ответа. По умолчанию `20000` (20 секунд), ограничено тайм-аутом автоматического продолжения. Не имеет эффекта, если автоматическое продолжение отключено; см. параметр [`askUserQuestionTimeout`](/ru/settings#available-settings) и `CLAUDE_AFK_TIMEOUT_MS`. Требуется Claude Code v2.1.198 или более поздняя версия |153| `CLAUDE_AFK_COUNTDOWN_MS` | Сколько миллисекунд перед автоматическим продолжением появляется обратный отсчёт на экране в диалоговом окне [`AskUserQuestion`](/docs/ru/tools-reference) без ответа. По умолчанию `20000` (20 секунд), ограничено тайм-аутом автоматического продолжения. Не имеет эффекта, если автоматическое продолжение отключено; см. параметр [`askUserQuestionTimeout`](/docs/ru/settings#available-settings) и `CLAUDE_AFK_TIMEOUT_MS`. Требуется Claude Code v2.1.198 или более поздняя версия |

154| `CLAUDE_AFK_TIMEOUT_MS` | {/* min-version: 2.1.198 */}Сколько миллисекунд времени неактивности перед диалоговым окном [`AskUserQuestion`](/ru/tools-reference) без ответа автоматически продолжается без вас. {/* min-version: 2.1.200 */}Автоматическое продолжение отключено по умолчанию; согласитесь с параметром [`askUserQuestionTimeout`](/ru/settings#available-settings). Эта переменная — переопределение для демонстраций и автоматизированных тестов: при установке она имеет приоритет над этим параметром и включает автоматическое продолжение, даже когда параметр не установлен или имеет значение `never`. Установка `0` не отключает тайм-аут; она закрывает диалоговое окно немедленно. В v2.1.198 и v2.1.199 автоматическое продолжение было включено по умолчанию с тайм-аутом `60000` (60 секунд). Требуется Claude Code v2.1.198 или более поздняя версия |154| `CLAUDE_AFK_TIMEOUT_MS` | Сколько миллисекунд времени неактивности перед диалоговым окном [`AskUserQuestion`](/docs/ru/tools-reference) без ответа автоматически продолжается без вас. Автоматическое продолжение отключено по умолчанию; согласитесь с параметром [`askUserQuestionTimeout`](/docs/ru/settings#available-settings). Эта переменная — переопределение для демонстраций и автоматизированных тестов: при установке она имеет приоритет над этим параметром и включает автоматическое продолжение, даже когда параметр не установлен или имеет значение `never`. Установка `0` не отключает тайм-аут; она закрывает диалоговое окно немедленно. В v2.1.198 и v2.1.199 автоматическое продолжение было включено по умолчанию с тайм-аутом `60000` (60 секунд). Требуется Claude Code v2.1.198 или более поздняя версия |

155| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Установите на `1`, чтобы отключить все встроенные типы [subagent](/ru/sub-agents), такие как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно для пользователей SDK, которые хотят чистый лист |155| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Установите на `1`, чтобы отключить все встроенные типы [subagent](/docs/ru/sub-agents), такие как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно для пользователей SDK, которые хотят чистый лист |

156| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Установите на `1`, чтобы пропустить префикс `mcp__<server>__` на именах инструментов из MCP серверов, созданных SDK. Инструменты используют свои исходные имена. Только для использования SDK |156| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Установите на `1`, чтобы пропустить префикс `mcp__<server>__` на именах инструментов из MCP серверов, созданных SDK. Инструменты используют свои исходные имена. Только для использования SDK |

157| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Тайм-аут зависания в миллисекундах для фоновых subagents. По умолчанию `600000` (10 минут). Таймер сбрасывается при каждом событии потоковой передачи прогресса; если прогресс не поступает в течение окна, subagent прерывается и задача отмечается как неудачная, выводя любой частичный результат родителю |157| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Тайм-аут зависания в миллисекундах для фоновых subagents. По умолчанию `600000` (10 минут). Таймер сбрасывается при каждом событии потоковой передачи прогресса; если прогресс не поступает в течение окна, subagent прерывается и задача отмечается как неудачная, выводя любой частичный результат родителю |

158| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Установите процент (1-100) окна auto-compaction, при котором срабатывает auto-compaction. Используйте меньшие значения, такие как `50`, для более раннего сжатия. Эта переменная вызывает более раннее сжатие только когда Claude Code сжимает упреждающе: когда установлен `CLAUDE_CODE_AUTO_COMPACT_WINDOW`, в [облачных сессиях](/ru/claude-code-on-the-web) и на Sonnet 4.6 и Opus 4.6 без [расширенного контекста](/ru/model-config#extended-context), которые сжимаются на границе 200K по умолчанию. На Sonnet 5 упреждающее сжатие применяется на [пороге по умолчанию](/ru/model-config#sonnet-5-context-window) модели. В других случаях, таких как локальная сессия на Opus 4.8, auto-compaction срабатывает, когда разговор достигает лимита контекста модели. Переопределение может только снизить порог, поэтому значения выше значения по умолчанию не имеют эффекта. Применяется как к основным разговорам, так и к subagents |158| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Установите процент (1-100) окна auto-compaction, при котором срабатывает auto-compaction. Используйте меньшие значения, такие как `50`, для более раннего сжатия. Эта переменная вызывает более раннее сжатие только когда Claude Code сжимает упреждающе: когда установлен `CLAUDE_CODE_AUTO_COMPACT_WINDOW`, в [облачных сессиях](/docs/ru/claude-code-on-the-web) и на Sonnet 4.6 и Opus 4.6 без [расширенного контекста](/docs/ru/model-config#extended-context), которые сжимаются на границе 200K по умолчанию. На Sonnet 5 упреждающее сжатие применяется на [пороге по умолчанию](/docs/ru/model-config#sonnet-5-context-window) модели. В других случаях, таких как локальная сессия на Opus 4.8, auto-compaction срабатывает, когда разговор достигает лимита контекста модели. Переопределение может только снизить порог, поэтому значения выше значения по умолчанию не имеют эффекта. Применяется как к основным разговорам, так и к subagents |

159| `CLAUDE_AUTO_BACKGROUND_TASKS` | Установите на `1`, чтобы принудительно включить автоматическое фоновое выполнение долгоживущих задач агента. При включении subagents перемещаются в фон после выполнения примерно две минуты |159| `CLAUDE_AUTO_BACKGROUND_TASKS` | Установите на `1`, чтобы принудительно включить автоматическое фоновое выполнение долгоживущих задач агента. При включении subagents перемещаются в фон после выполнения примерно две минуты |

160| `CLAUDE_AX_SCREEN_READER` | {/* min-version: 2.1.181 */}Установите на `1`, чтобы отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Установите на `0`, чтобы принудительно отключить режим программы чтения с экрана, даже когда [`axScreenReader`](/ru/settings#available-settings) имеет значение `true`. Флаг [`--ax-screen-reader`](/ru/cli-reference#cli-flags) имеет приоритет. Требуется Claude Code v2.1.181 или более поздняя версия |160| `CLAUDE_AX_SCREEN_READER` | Установите на `1`, чтобы отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Установите на `0`, чтобы принудительно отключить режим программы чтения с экрана, даже когда [`axScreenReader`](/docs/ru/settings#available-settings) имеет значение `true`. Флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеет приоритет. Требуется Claude Code v2.1.181 или более поздняя версия |

161| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Вернуться в исходный рабочий каталог после каждой команды Bash или PowerShell в основной сессии |161| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Вернуться в исходный рабочий каталог после каждой команды Bash или PowerShell в основной сессии |

162| `CLAUDE_CLIENT_PRESENCE_FILE` | {/* min-version: 2.1.181 */}Путь к файлу, который внешний инструмент, такой как слушатель блокировки экрана, создаёт при разблокировке экрана и удаляет при его блокировке. Пока файл существует, Claude Code пропускает [push-уведомления Remote Control для мобильных устройств](/ru/remote-control#mobile-push-notifications), поэтому вы перестаёте получать push-уведомления, пока активно используете компьютер. Когда файл отсутствует или нечитаем, уведомления отправляются как обычно. Claude Code проверяет файл один раз за событие, запускающее push-уведомление, а не опрашивает его. Требуется Claude Code v2.1.181 или более поздняя версия |162| `CLAUDE_CLIENT_PRESENCE_FILE` | Путь к файлу, который внешний инструмент, такой как слушатель блокировки экрана, создаёт при разблокировке экрана и удаляет при его блокировке. Пока файл существует, Claude Code пропускает [push-уведомления Remote Control для мобильных устройств](/docs/ru/remote-control#mobile-push-notifications), поэтому вы перестаёте получать push-уведомления, пока активно используете компьютер. Когда файл отсутствует или нечитаем, уведомления отправляются как обычно. Claude Code проверяет файл один раз за событие, запускающее push-уведомление, а не опрашивает его. Требуется Claude Code v2.1.181 или более поздняя версия |

163| `CLAUDE_CODE_ACCESSIBILITY` | Установите на `1`, чтобы сохранить видимость собственного курсора терминала и отключить индикатор курсора с инвертированным текстом. Позволяет увеличителям экрана, таким как macOS Zoom, отслеживать позицию курсора |163| `CLAUDE_CODE_ACCESSIBILITY` | Установите на `1`, чтобы сохранить видимость собственного курсора терминала и отключить индикатор курсора с инвертированным текстом. Позволяет увеличителям экрана, таким как macOS Zoom, отслеживать позицию курсора |

164| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Установите на `1`, чтобы загружать файлы памяти из каталогов, указанных с помощью `--add-dir`. Загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md`. По умолчанию дополнительные каталоги не загружают файлы памяти |164| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Установите на `1`, чтобы загружать файлы памяти из каталогов, указанных с помощью `--add-dir`. Загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md`. По умолчанию дополнительные каталоги не загружают файлы памяти |

165| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Установите на `1`, чтобы перерисовать весь экран на каждом кадре в [полноэкранном режиме](/ru/fullscreen) вместо отправки дополнительных обновлений. Используйте это, если полноэкранный режим показывает устаревшие или неправильно размещённые фрагменты текста. Claude Code включает это автоматически для фоновых сессий и [представления агента](/ru/agent-view) на Windows |165| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Установите на `1`, чтобы перерисовать весь экран на каждом кадре в [полноэкранном режиме](/docs/ru/fullscreen) вместо отправки дополнительных обновлений. Используйте это, если полноэкранный режим показывает устаревшие или неправильно размещённые фрагменты текста. Claude Code включает это автоматически для фоновых сессий и [представления агента](/docs/ru/agent-view) на Windows |

166| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Установите на `1`, чтобы отправлять параметр [effort](/ru/model-config#adjust-effort-level) с каждым запросом, даже когда Claude Code не распознаёт ID модели как поддерживающий усилия. Используйте это при маршрутизации через [шлюз LLM](/ru/llm-gateway) или поставщика третьей стороны, который обслуживает модели под пользовательскими идентификаторами. Модели, которые отклоняют параметр усилий в API, включая модели Claude 3, Sonnet 4.0 и 4.5, Opus 4.0 и 4.1 и Haiku 4.5, по-прежнему исключены, поэтому запросы не будут отклонены |166| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Установите на `1`, чтобы отправлять параметр [effort](/docs/ru/model-config#adjust-effort-level) с каждым запросом, даже когда Claude Code не распознаёт ID модели как поддерживающий усилия. Используйте это при маршрутизации через [шлюз LLM](/docs/ru/llm-gateway) или поставщика третьей стороны, который обслуживает модели под пользовательскими идентификаторами. Модели, которые отклоняют параметр усилий в API, включая модели Claude 3, Sonnet 4.0 и 4.5, Opus 4.0 и 4.1 и Haiku 4.5, по-прежнему исключены, поэтому запросы не будут отклонены |

167| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Интервал в миллисекундах, при котором должны быть обновлены учётные данные (при использовании [`apiKeyHelper`](/ru/settings#available-settings)) |167| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Интервал в миллисекундах, при котором должны быть обновлены учётные данные (при использовании [`apiKeyHelper`](/docs/ru/settings#available-settings)) |

168| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Установите на `0`, чтобы остановить Claude Code от автоматического открытия браузера при публикации нового [artifact](/ru/artifacts). Повторная публикация существующего artifact не открывает браузер независимо от этого параметра |168| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Установите на `0`, чтобы остановить Claude Code от автоматического открытия браузера при публикации нового [artifact](/docs/ru/artifacts). Повторная публикация существующего artifact не открывает браузер независимо от этого параметра |

169| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Установите на `0`, чтобы опустить блок атрибуции (версия клиента и отпечаток приглашения) с начала системного приглашения. Отключение его улучшает коэффициент попадания кэша приглашений при маршрутизации через [шлюз LLM](/ru/llm-gateway). Кэширование Anthropic API не затронуто |169| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Установите на `0`, чтобы опустить блок атрибуции (версия клиента и отпечаток приглашения) с начала системного приглашения. Отключение его улучшает коэффициент попадания кэша приглашений при маршрутизации через [шлюз LLM](/docs/ru/llm-gateway). Кэширование Anthropic API не затронуто |

170| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Установите ёмкость контекста в токенах, используемую для расчётов auto-compaction. По умолчанию используется контекстное окно модели: 200K для стандартных моделей или 1M для моделей с [расширенным контекстом](/ru/model-config#extended-context), кроме Sonnet 5, который имеет свой [порог по умолчанию](/ru/model-config#sonnet-5-context-window). Используйте меньшее значение, такое как `500000`, на модели 1M, чтобы рассматривать окно как 500K для целей сжатия. Значение ограничено фактическим контекстным окном модели. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` применяется как процент от этого значения. Установка этой переменной отделяет порог сжатия от `used_percentage` в строке состояния, который всегда использует полное контекстное окно модели |170| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Установите ёмкость контекста в токенах, используемую для расчётов auto-compaction. По умолчанию используется контекстное окно модели: 200K для стандартных моделей или 1M для моделей с [расширенным контекстом](/docs/ru/model-config#extended-context), кроме Sonnet 5, который имеет свой [порог по умолчанию](/docs/ru/model-config#sonnet-5-context-window). Используйте меньшее значение, такое как `500000`, на модели 1M, чтобы рассматривать окно как 500K для целей сжатия. Значение ограничено фактическим контекстным окном модели. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` применяется как процент от этого значения. Установка этой переменной отделяет порог сжатия от `used_percentage` в строке состояния, который всегда использует полное контекстное окно модели |

171| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Переопределить автоматическое [подключение IDE](/ru/vs-code). По умолчанию Claude Code подключается автоматически при запуске внутри встроенного терминала поддерживаемой IDE. Установите на `false`, чтобы предотвратить это. Установите на `true`, чтобы принудительно попытаться подключиться, когда автоматическое обнаружение не удаётся, например, когда tmux скрывает родительский терминал. Имеет приоритет над параметром [`autoConnectIde`](/ru/settings#global-config-settings) глобальной конфигурации |171| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Переопределить автоматическое [подключение IDE](/docs/ru/vs-code). По умолчанию Claude Code подключается автоматически при запуске внутри встроенного терминала поддерживаемой IDE. Установите на `false`, чтобы предотвратить это. Установите на `true`, чтобы принудительно попытаться подключиться, когда автоматическое обнаружение не удаётся, например, когда tmux скрывает родительский терминал. Имеет приоритет над параметром [`autoConnectIde`](/docs/ru/settings#global-config-settings) глобальной конфигурации |

172| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | {/* min-version: 2.1.207 */}Время в миллисекундах Claude Code ждёт для цепи поставщика учётных данных AWS по умолчанию, чтобы произвести учётные данные перед отказом запроса с [`AWS default-chain credential resolve timed out`](/ru/errors#aws-default-chain-credential-resolve-timed-out) (по умолчанию: `60000`). Повысьте это, когда шаг в вашей цепи законно нуждается в большем времени, такой как вход в браузер на основе SSO с MFA через обёртку, такую как `aws-vault`. Применяется везде, где Claude Code подписывает с цепью по умолчанию: [Amazon Bedrock](/ru/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/ru/claude-platform-on-aws) и [конечная точка Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint). Требуется Claude Code v2.1.207 или более поздняя версия |172| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Время в миллисекундах Claude Code ждёт для цепи поставщика учётных данных AWS по умолчанию, чтобы произвести учётные данные перед отказом запроса с [`AWS default-chain credential resolve timed out`](/docs/ru/errors#aws-default-chain-credential-resolve-timed-out) (по умолчанию: `60000`). Повысьте это, когда шаг в вашей цепи законно нуждается в большем времени, такой как вход в браузер на основе SSO с MFA через обёртку, такую как `aws-vault`. Применяется везде, где Claude Code подписывает с цепью по умолчанию: [Amazon Bedrock](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и [конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Требуется Claude Code v2.1.207 или более поздняя версия |

173| `CLAUDE_CODE_BRIDGE_SESSION_ID` | {/* min-version: 2.1.199 */}Установите автоматически в подпроцессах инструмента Bash и [команды hook](/ru/hooks) во время активного соединения [Remote Control](/ru/remote-control), и удалено при завершении соединения. Значение — это ID сессии в форме `session_`, тот же идентификатор, который появляется в URL сессии `claude.ai/code`, поэтому скрипт может ссылаться обратно на сессию, которая его запустила. Требуется Claude Code v2.1.199 или более поздняя версия. В [облачных сессиях](/ru/claude-code-on-the-web) прочитайте вместо этого `CLAUDE_CODE_REMOTE_SESSION_ID` |173| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Установите автоматически в подпроцессах инструмента Bash и [команды hook](/docs/ru/hooks) во время активного соединения [Remote Control](/docs/ru/remote-control), и удалено при завершении соединения. Значение — это ID сессии в форме `session_`, тот же идентификатор, который появляется в URL сессии `claude.ai/code`, поэтому скрипт может ссылаться обратно на сессию, которая его запустила. Требуется Claude Code v2.1.199 или более поздняя версия. В [облачных сессиях](/docs/ru/claude-code-on-the-web) прочитайте вместо этого `CLAUDE_CODE_REMOTE_SESSION_ID` |

174| `CLAUDE_CODE_CERT_STORE` | Разделённый запятыми список источников сертификатов CA для TLS соединений. `bundled` — это набор Mozilla CA, поставляемый с Claude Code. `system` — это хранилище доверия операционной системы, доступное только для чтения на средах выполнения с `tls.getCACertificates`: собственный бинарный файл или Node 22.15 или более поздняя версия для установок npm. См. [Хранилище сертификатов CA](/ru/network-config#ca-certificate-store). По умолчанию `bundled,system` |174| `CLAUDE_CODE_CERT_STORE` | Разделённый запятыми список источников сертификатов CA для TLS соединений. `bundled` — это набор Mozilla CA, поставляемый с Claude Code. `system` — это хранилище доверия операционной системы, доступное только для чтения на средах выполнения с `tls.getCACertificates`: собственный бинарный файл или Node 22.15 или более поздняя версия для установок npm. См. [Хранилище сертификатов CA](/docs/ru/network-config#ca-certificate-store). По умолчанию `bundled,system` |

175| `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}Установите на `1` в подпроцессах, которые Claude Code порождает через инструменты Bash, PowerShell и Monitor, команды [hook](/ru/hooks) и команды [строки состояния](/ru/statusline). Не установлено для подпроцессов stdio [MCP server](/ru/mcp), которые долгоживущие и пережидают сессию, которая их порождала. В отличие от `CLAUDECODE`, это устанавливается только путём собственного порождения Claude Code, а не IDE extensions, поэтому надёжно различает вложенную сессию от верхнего уровня `claude`, запущенного в встроенном терминале IDE. Вложенный интерактивный `claude` TUI, запущенный таким образом, автоматически исключается из `--resume`, `--continue`, истории стрелок вверх и списка `claude agents`. Сессии `claude -p` без интерактивности по-прежнему сохраняются. Установите `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, чтобы переопределить это исключение. Требуется Claude Code v2.1.172 или более поздняя версия |175| `CLAUDE_CODE_CHILD_SESSION` | Установите на `1` в подпроцессах, которые Claude Code порождает через инструменты Bash, PowerShell и Monitor, команды [hook](/docs/ru/hooks) и команды [строки состояния](/docs/ru/statusline). Не установлено для подпроцессов stdio [MCP server](/docs/ru/mcp), которые долгоживущие и пережидают сессию, которая их порождала. В отличие от `CLAUDECODE`, это устанавливается только путём собственного порождения Claude Code, а не IDE extensions, поэтому надёжно различает вложенную сессию от верхнего уровня `claude`, запущенного в встроенном терминале IDE. Вложенный интерактивный `claude` TUI, запущенный таким образом, автоматически исключается из `--resume`, `--continue`, истории стрелок вверх и списка `claude agents`. Сессии `claude -p` без интерактивности по-прежнему сохраняются. Установите `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, чтобы переопределить это исключение. Требуется Claude Code v2.1.172 или более поздняя версия |

176| `CLAUDE_CODE_CLIENT_CERT` | Путь к файлу сертификата клиента для аутентификации mTLS |176| `CLAUDE_CODE_CLIENT_CERT` | Путь к файлу сертификата клиента для аутентификации mTLS |

177| `CLAUDE_CODE_CLIENT_KEY` | Путь к файлу приватного ключа клиента для аутентификации mTLS |177| `CLAUDE_CODE_CLIENT_KEY` | Путь к файлу приватного ключа клиента для аутентификации mTLS |

178| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Парольная фраза для зашифрованного CLAUDE\_CODE\_CLIENT\_KEY (опционально) |178| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Парольная фраза для зашифрованного CLAUDE\_CODE\_CLIENT\_KEY (опционально) |

179| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | {/* max-version: 2.1.185 */}Удалено в v2.1.186 и теперь является no-op. Ранее устанавливало отдельный тайм-аут для фазы подключения, TLS и заголовка ответа потокового запроса API. Используйте `API_TIMEOUT_MS` для тайм-аута для каждого запроса |179| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Удалено в v2.1.186 и теперь является no-op. Ранее устанавливало отдельный тайм-аут для фазы подключения, TLS и заголовка ответа потокового запроса API. Используйте `API_TIMEOUT_MS` для тайм-аута для каждого запроса |

180| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Переопределить путь к файлу журнала отладки. Несмотря на название, это путь к файлу, а не к каталогу. Требует, чтобы режим отладки был включен отдельно через `--debug`, `/debug` или переменную окружения `DEBUG`: установка только этой переменной не включает логирование. Флаг [`--debug-file`](/ru/cli-reference#cli-flags) делает оба сразу. По умолчанию `~/.claude/debug/<session-id>.txt` |180| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Переопределить путь к файлу журнала отладки. Несмотря на название, это путь к файлу, а не к каталогу. Требует, чтобы режим отладки был включен отдельно через `--debug`, `/debug` или переменную окружения `DEBUG`: установка только этой переменной не включает логирование. Флаг [`--debug-file`](/docs/ru/cli-reference#cli-flags) делает оба сразу. По умолчанию `~/.claude/debug/<session-id>.txt` |

181| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Минимальный уровень логирования, записываемый в файл журнала отладки. Значения: `verbose`, `debug` (по умолчанию), `info`, `warn`, `error`. Установите на `verbose`, чтобы включить высокообъёмную диагностику, такую как полный вывод команды строки состояния, или повысьте до `error`, чтобы снизить шум |181| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Минимальный уровень логирования, записываемый в файл журнала отладки. Значения: `verbose`, `debug` (по умолчанию), `info`, `warn`, `error`. Установите на `verbose`, чтобы включить высокообъёмную диагностику, такую как полный вывод команды строки состояния, или повысьте до `error`, чтобы снизить шум |

182| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Установите на `1`, чтобы отключить поддержку [контекстного окна 1M](/ru/model-config#extended-context). При установке варианты модели 1M недоступны в средстве выбора модели, и сессии [Sonnet 5](/ru/model-config#sonnet-5-context-window) рассматриваются как имеющие окно 200K. Полезно для корпоративных сред с требованиями соответствия |182| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Установите на `1`, чтобы отключить поддержку [контекстного окна 1M](/docs/ru/model-config#extended-context). При установке варианты модели 1M недоступны в средстве выбора модели, и сессии [Sonnet 5](/docs/ru/model-config#sonnet-5-context-window) рассматриваются как имеющие окно 200K. Полезно для корпоративных сред с требованиями соответствия |

183| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Установите на `1`, чтобы отключить [адаптивное рассуждение](/ru/model-config#adjust-effort-level) на Opus 4.6 и Sonnet 4.6 и вернуться к фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. {/* min-version: 2.1.111 */}Начиная с v2.1.111, не влияет на Fable 5, Sonnet 5 или на Opus 4.7 и более поздние версии, которые всегда используют адаптивное рассуждение |183| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Установите на `1`, чтобы отключить [адаптивное рассуждение](/docs/ru/model-config#adjust-effort-level) на Opus 4.6 и Sonnet 4.6 и вернуться к фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. Начиная с v2.1.111, не влияет на Fable 5, Sonnet 5 или на Opus 4.7 и более поздние версии, которые всегда используют адаптивное рассуждение |

184| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Установите на `1`, чтобы отключить [инструмент advisor](/ru/advisor). Команда `/advisor` становится недоступной, любой настроенный `advisorModel` игнорируется, и флаг `--advisor` принимается, но не имеет эффекта, поэтому существующие скрипты, которые его передают, продолжают работать без ошибок |184| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Установите на `1`, чтобы отключить [инструмент advisor](/docs/ru/advisor). Команда `/advisor` становится недоступной, любой настроенный `advisorModel` игнорируется, и флаг `--advisor` принимается, но не имеет эффекта, поэтому существующие скрипты, которые его передают, продолжают работать без ошибок |

185| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Установите на `1`, чтобы отключить [фоновых агентов и представление агентов](/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Эквивалент параметра [`disableAgentView`](/ru/settings#available-settings) |185| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Установите на `1`, чтобы отключить [фоновых агентов и представление агентов](/docs/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Эквивалент параметра [`disableAgentView`](/docs/ru/settings#available-settings) |

186| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Установите на `1`, чтобы отключить [полноэкранный режим](/ru/fullscreen) и использовать классический рендерер основного экрана. Разговор остаётся в собственной прокрутке вашего терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно. Имеет приоритет над `CLAUDE_CODE_NO_FLICKER` и параметром [`tui`](/ru/settings#available-settings). Вы также можете переключаться с помощью `/tui default`. Не применяется к фоновым сессиям, открытым из [представления агента](/ru/agent-view), которые всегда используют полноэкранный режим |186| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Установите на `1`, чтобы отключить [полноэкранный режим](/docs/ru/fullscreen) и использовать классический рендерер основного экрана. Разговор остаётся в собственной прокрутке вашего терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно. Имеет приоритет над `CLAUDE_CODE_NO_FLICKER` и параметром [`tui`](/docs/ru/settings#available-settings). Вы также можете переключаться с помощью `/tui default`. Не применяется к фоновым сессиям, открытым из [представления агента](/docs/ru/agent-view), которые всегда используют полноэкранный режим |

187| `CLAUDE_CODE_DISABLE_ARTIFACT` | Установите на `1`, чтобы отключить инструмент [Artifact](/ru/artifacts), который публикует вывод сессии как приватную веб-страницу на claude.ai. Эквивалент параметра [`disableArtifact`](/ru/settings#available-settings) |187| `CLAUDE_CODE_DISABLE_ARTIFACT` | Установите на `1`, чтобы отключить инструмент [Artifact](/docs/ru/artifacts), который публикует вывод сессии как приватную веб-страницу на claude.ai. Эквивалент параметра [`disableArtifact`](/docs/ru/settings#available-settings) |

188| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Установите на `1`, чтобы отключить обработку вложений. Упоминания файлов с синтаксисом `@` отправляются как простой текст вместо расширения в содержимое файла |188| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Установите на `1`, чтобы отключить обработку вложений. Упоминания файлов с синтаксисом `@` отправляются как простой текст вместо расширения в содержимое файла |

189| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Установите на `1`, чтобы отключить [автоматическую память](/ru/memory#auto-memory). Установите на `0`, чтобы принудительно включить автоматическую память даже когда режим `--bare` или [`autoMemoryEnabled: false`](/ru/settings#available-settings) в противном случае отключили бы её. При отключении Claude не создаёт и не загружает файлы автоматической памяти |189| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Установите на `1`, чтобы отключить [автоматическую память](/docs/ru/memory#auto-memory). Установите на `0`, чтобы принудительно включить автоматическую память даже когда режим `--bare` или [`autoMemoryEnabled: false`](/docs/ru/settings#available-settings) в противном случае отключили бы её. При отключении Claude не создаёт и не загружает файлы автоматической памяти |

190| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Установите на `1`, чтобы отключить всю функциональность фоновых задач, включая параметр `run_in_background` на инструментах Bash и subagent, автоматическое фоновое выполнение и сочетание клавиш Ctrl+B |190| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Установите на `1`, чтобы отключить всю функциональность фоновых задач, включая параметр `run_in_background` на инструментах Bash и subagent, автоматическое фоновое выполнение и сочетание клавиш Ctrl+B |

191| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | {/* min-version: 2.1.208 */}Установите на `1`, чтобы пропустить проверку, что потоковый ответ [Amazon Bedrock](/ru/amazon-bedrock) имеет тип содержимого `application/vnd.amazon.eventstream`. Без этой переменной ответ с другим типом содержимого не удаётся с ошибкой, называющей этот тип содержимого, что означает [шлюз или прокси преобразует ответ](/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Установите это только когда шлюз переписывает заголовок `Content-Type`, но пропускает двоичное тело потока событий без изменений; если само тело было преобразовано, запросы не удаются с `Truncated event message received` вместо этого. Требуется Claude Code v2.1.208 или более поздняя версия |191| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Установите на `1`, чтобы пропустить проверку, что потоковый ответ [Amazon Bedrock](/docs/ru/amazon-bedrock) имеет тип содержимого `application/vnd.amazon.eventstream`. Без этой переменной ответ с другим типом содержимого не удаётся с ошибкой, называющей этот тип содержимого, что означает [шлюз или прокси преобразует ответ](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Установите это только когда шлюз переписывает заголовок `Content-Type`, но пропускает двоичное тело потока событий без изменений; если само тело было преобразовано, запросы не удаются с `Truncated event message received` вместо этого. Требуется Claude Code v2.1.208 или более поздняя версия |

192| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Установите на `1`, чтобы остановить выполняющиеся фоновые команды оболочки, динамические workflows {/* min-version: 2.1.198 */}и, начиная с v2.1.198, фоновые subagents [фоновой сессии](/ru/agent-view) при остановке, перезагрузке или обновлении процесса этой сессии [супервизором](/ru/agent-view#the-supervisor-process), вместо передачи их следующему процессу сессии. Влияет только на эту передачу: фоновое выполнение сессии с помощью `←` или [`/background`](/ru/agent-view#from-inside-a-session) по-прежнему переносит выполняющуюся работу, и `CLAUDE_DISABLE_ADOPT` отключает оба. Требуется Claude Code v2.1.196 или более поздняя версия |192| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Установите на `1`, чтобы остановить выполняющиеся фоновые команды оболочки, динамические workflows и, начиная с v2.1.198, фоновые subagents [фоновой сессии](/docs/ru/agent-view) при остановке, перезагрузке или обновлении процесса этой сессии [супервизором](/docs/ru/agent-view#the-supervisor-process), вместо передачи их следующему процессу сессии. Влияет только на эту передачу: фоновое выполнение сессии с помощью `←` или [`/background`](/docs/ru/agent-view#from-inside-a-session) по-прежнему переносит выполняющуюся работу, и `CLAUDE_DISABLE_ADOPT` отключает оба. Требуется Claude Code v2.1.196 или более поздняя версия |

193| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}Установите на `1`, чтобы остановить Claude Code от завершения [фоновых команд оболочки](/ru/interactive-mode#background-bash-commands) при сообщении операционной системой о нехватке памяти. По умолчанию на macOS и Linux Claude Code завершает фоновую оболочку, запущенную в основной сессии, при сигнале нехватки памяти, как только сессия была неактивна в течение 30 минут и ни один ход или subagent не выполняется. Windows не имеет сигнала нехватки памяти, поэтому эта переменная не влияет там. Требуется Claude Code v2.1.193 или более поздняя версия |193| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Установите на `1`, чтобы остановить Claude Code от завершения [фоновых команд оболочки](/docs/ru/interactive-mode#background-bash-commands) при сообщении операционной системой о нехватке памяти. По умолчанию на macOS и Linux Claude Code завершает фоновую оболочку, запущенную в основной сессии, при сигнале нехватки памяти, как только сессия была неактивна в течение 30 минут и ни один ход или subagent не выполняется. Windows не имеет сигнала нехватки памяти, поэтому эта переменная не влияет там. Требуется Claude Code v2.1.193 или более поздняя версия |

194| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Установите на `1`, чтобы отключить [skills](/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. `/doctor` остаётся доступной для ввода, как встроенные команды; скройте её с помощью `DISABLE_DOCTOR_COMMAND` вместо этого. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалент параметра [`disableBundledSkills`](/ru/settings#available-settings); `0` не переопределяет его |194| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Установите на `1`, чтобы отключить [skills](/docs/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. `/doctor` остаётся доступной для ввода, как встроенные команды; скройте её с помощью `DISABLE_DOCTOR_COMMAND` вместо этого. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалент параметра [`disableBundledSkills`](/docs/ru/settings#available-settings); `0` не переопределяет его |

195| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите на `1`, чтобы предотвратить загрузку любых файлов памяти CLAUDE.md в контекст, включая файлы пользователя, проекта и автоматической памяти |195| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите на `1`, чтобы предотвратить загрузку любых файлов памяти CLAUDE.md в контекст, включая файлы пользователя, проекта и автоматической памяти |

196| `CLAUDE_CODE_DISABLE_CRON` | Установите на `1`, чтобы отключить [запланированные задачи](/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными и все уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сессии |196| `CLAUDE_CODE_DISABLE_CRON` | Установите на `1`, чтобы отключить [запланированные задачи](/docs/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными и все уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сессии |

197| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите на `1`, чтобы удалить заголовки запроса `anthropic-beta` для Anthropic и поля схемы инструментов beta (такие как `defer_loading` и `eager_input_streaming`) из запросов API. Используйте это, когда шлюз прокси отклоняет запросы с ошибками типа "Unexpected value(s) for the `anthropic-beta` header" или "Extra inputs are not permitted". Стандартные поля (`name`, `description`, `input_schema`, `cache_control`) сохраняются. [Поиск инструментов MCP](/ru/mcp#scale-with-mcp-tool-search) отключен и все инструменты MCP загружаются заранее, даже когда установлен `ENABLE_TOOL_SEARCH` |197| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите на `1`, чтобы удалить заголовки запроса `anthropic-beta` для Anthropic и поля схемы инструментов beta (такие как `defer_loading` и `eager_input_streaming`) из запросов API. Используйте это, когда шлюз прокси отклоняет запросы с ошибками типа "Unexpected value(s) for the `anthropic-beta` header" или "Extra inputs are not permitted". Стандартные поля (`name`, `description`, `input_schema`, `cache_control`) сохраняются. [Поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен и все инструменты MCP загружаются заранее, даже когда установлен `ENABLE_TOOL_SEARCH` |

198| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | {/* min-version: 2.1.198 */}Установите на `1`, чтобы отключить встроенные [subagents Explore и Plan](/ru/sub-agents#built-in-subagents). Claude исследует с помощью своих инструментов поиска или общего назначения subagent вместо этого, и [режим плана](/ru/permission-modes#analyze-before-you-edit-with-plan-mode) читает файлы напрямую, а не запускает agents Explore и Plan. Пользовательские subagents с именами `Explore` или `Plan` не затронуты. Чтобы удалить каждый встроенный тип subagent в Agent SDK или неинтерактивном режиме, используйте `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` вместо этого. Требуется Claude Code v2.1.198 или более поздняя версия |198| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Установите на `1`, чтобы отключить встроенные [subagents Explore и Plan](/docs/ru/sub-agents#built-in-subagents). Claude исследует с помощью своих инструментов поиска или общего назначения subagent вместо этого, и [режим плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) читает файлы напрямую, а не запускает agents Explore и Plan. Пользовательские subagents с именами `Explore` или `Plan` не затронуты. Чтобы удалить каждый встроенный тип subagent в Agent SDK или неинтерактивном режиме, используйте `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` вместо этого. Требуется Claude Code v2.1.198 или более поздняя версия |

199| `CLAUDE_CODE_DISABLE_FAST_MODE` | Установите на `1`, чтобы отключить [быстрый режим](/ru/fast-mode) |199| `CLAUDE_CODE_DISABLE_FAST_MODE` | Установите на `1`, чтобы отключить [быстрый режим](/docs/ru/fast-mode) |

200| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Установите на `1`, чтобы отключить опросы качества сессии "How is Claude doing?". Опросы также отключаются, когда установлена переменная `DISABLE_TELEMETRY`, `DO_NOT_TRACK` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, если только `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` не согласится вернуться. Чтобы установить частоту выборки вместо полного отключения, используйте параметр [`feedbackSurveyRate`](/ru/settings#available-settings). См. [Опросы качества сессии](/ru/data-usage#session-quality-surveys) |200| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Установите на `1`, чтобы отключить опросы качества сессии "How is Claude doing?". Опросы также отключаются, когда установлена переменная `DISABLE_TELEMETRY`, `DO_NOT_TRACK` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, если только `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` не согласится вернуться. Чтобы установить частоту выборки вместо полного отключения, используйте параметр [`feedbackSurveyRate`](/docs/ru/settings#available-settings). См. [Опросы качества сессии](/docs/ru/data-usage#session-quality-surveys) |

201| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите на `1`, чтобы отключить [checkpointing](/ru/checkpointing) файлов. Команда `/rewind` не сможет восстановить изменения кода |201| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите на `1`, чтобы отключить [checkpointing](/docs/ru/checkpointing) файлов. Команда `/rewind` не сможет восстановить изменения кода |

202| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите на `1`, чтобы удалить встроенные инструкции рабочего процесса коммита и PR и снимок статуса git из системного приглашения Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/ru/settings#available-settings) при установке |202| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите на `1`, чтобы удалить встроенные инструкции рабочего процесса коммита и PR и снимок статуса git из системного приглашения Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/docs/ru/settings#available-settings) при установке |

203| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите на `1`, чтобы предотвратить автоматическое переназначение Opus 4.0 и 4.1 на текущую версию Opus в Anthropic API. Используйте, когда вы намеренно хотите закрепить старую модель. Переназначение не выполняется на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |203| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите на `1`, чтобы предотвратить автоматическое переназначение Opus 4.0 и 4.1 на текущую версию Opus в Anthropic API. Используйте, когда вы намеренно хотите закрепить старую модель. Переназначение не выполняется на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |

204| `CLAUDE_CODE_DISABLE_MOUSE` | Установите на `1`, чтобы отключить отслеживание мыши в [полноэкранном режиме](/ru/fullscreen). Прокрутка с клавиатуры с помощью `PgUp` и `PgDn` по-прежнему работает. Используйте это, чтобы сохранить поведение выделения при нажатии мыши вашего терминала |204| `CLAUDE_CODE_DISABLE_MOUSE` | Установите на `1`, чтобы отключить отслеживание мыши в [полноэкранном режиме](/docs/ru/fullscreen). Прокрутка с клавиатуры с помощью `PgUp` и `PgDn` по-прежнему работает. Используйте это, чтобы сохранить поведение выделения при нажатии мыши вашего терминала |

205| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | {/* min-version: 2.1.195 */}Установите на `1`, чтобы отключить обработку щелчков, перетаскивания и наведения в [полноэкранном режиме](/ru/fullscreen), сохраняя прокрутку колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет, когда оба установлены. Требуется Claude Code v2.1.195 или более поздняя версия |205| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Установите на `1`, чтобы отключить обработку щелчков, перетаскивания и наведения в [полноэкранном режиме](/docs/ru/fullscreen), сохраняя прокрутку колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет, когда оба установлены. Требуется Claude Code v2.1.195 или более поздняя версия |

206| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Эквивалент установки `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` и `DISABLE_TELEMETRY` |206| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Эквивалент установки `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` и `DISABLE_TELEMETRY` |

207| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Установите на `1`, чтобы отключить резервный вариант без потоковой передачи, когда запрос потоковой передачи не удаётся в середине потока. Ошибки потоковой передачи распространяются на уровень повтора вместо этого. Полезно, когда прокси или шлюз вызывает резервный вариант для создания дублирующегося выполнения инструмента |207| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Установите на `1`, чтобы отключить резервный вариант без потоковой передачи, когда запрос потоковой передачи не удаётся в середине потока. Ошибки потоковой передачи распространяются на уровень повтора вместо этого. Полезно, когда прокси или шлюз вызывает резервный вариант для создания дублирующегося выполнения инструмента |

208| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | {/* min-version: 2.1.193 */}Установите на `1`, чтобы отправить уведомление на рабочий стол инструмента `PushNotification` даже во время ввода текста в терминал или его фокусировки. По умолчанию инструмент пропускает как уведомление на рабочий стол, так и [мобильный push](/ru/remote-control#mobile-push-notifications), когда обнаруживает недавнюю активность клавиатуры или фокус терминала. Эта переменная отключает только эту локальную проверку, поэтому сервер по-прежнему может подавить мобильный push, когда обнаруживает, что вы активны. Требуется Claude Code v2.1.193 или более поздняя версия |208| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Установите на `1`, чтобы отправить уведомление на рабочий стол инструмента `PushNotification` даже во время ввода текста в терминал или его фокусировки. По умолчанию инструмент пропускает как уведомление на рабочий стол, так и [мобильный push](/docs/ru/remote-control#mobile-push-notifications), когда обнаруживает недавнюю активность клавиатуры или фокус терминала. Эта переменная отключает только эту локальную проверку, поэтому сервер по-прежнему может подавить мобильный push, когда обнаруживает, что вы активны. Требуется Claude Code v2.1.193 или более поздняя версия |

209| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Установите на `1`, чтобы пропустить автоматическое добавление официального marketplace plugin при первом запуске |209| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Установите на `1`, чтобы пропустить автоматическое добавление официального marketplace plugin при первом запуске |

210| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Установите на `1`, чтобы пропустить загрузку skills из системного каталога управляемых skills. Полезно для сессий контейнера или CI, которые не должны загружать skills, предоставленные оператором |210| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Установите на `1`, чтобы пропустить загрузку skills из системного каталога управляемых skills. Полезно для сессий контейнера или CI, которые не должны загружать skills, предоставленные оператором |

211| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Установите на `1`, чтобы отключить автоматическое обновление заголовка терминала на основе контекста разговора. В сессиях Agent SDK и `claude -p` это также пропускает фоновый запрос Haiku, который генерирует заголовок сессии |211| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Установите на `1`, чтобы отключить автоматическое обновление заголовка терминала на основе контекста разговора. В сессиях Agent SDK и `claude -p` это также пропускает фоновый запрос Haiku, который генерирует заголовок сессии |

212| `CLAUDE_CODE_DISABLE_THINKING` | Установите на `1`, чтобы полностью опустить параметр `thinking` из запросов API. Это опция совместимости для прокси и шлюзов, которые отклоняют параметр. Поведение переменной не изменилось с более ранних версий; на моделях, которые думают по умолчанию, опущение параметра означает, что модель может всё ещё думать. Чтобы явно отключить [расширенное мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) на Anthropic API, используйте вместо этого `MAX_THINKING_TOKENS=0`, что также неэффективно на Fable 5, так как оно не может отключить мышление. На [сторонних поставщиках](/ru/third-party-integrations), `0` аналогично опускает параметр, поэтому две переменные ведут себя одинаково там |212| `CLAUDE_CODE_DISABLE_THINKING` | Установите на `1`, чтобы полностью опустить параметр `thinking` из запросов API. Это опция совместимости для прокси и шлюзов, которые отклоняют параметр. Поведение переменной не изменилось с более ранних версий; на моделях, которые думают по умолчанию, опущение параметра означает, что модель может всё ещё думать. Чтобы явно отключить [расширенное мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) на Anthropic API, используйте вместо этого `MAX_THINKING_TOKENS=0`, что также неэффективно на Fable 5, так как оно не может отключить мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations), `0` аналогично опускает параметр, поэтому две переменные ведут себя одинаково там |

213| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите на `1`, чтобы отключить виртуальную прокрутку в [полноэкранном режиме](/ru/fullscreen) и отрендерить каждое сообщение в транскрипте. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появляться сообщения |213| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите на `1`, чтобы отключить виртуальную прокрутку в [полноэкранном режиме](/docs/ru/fullscreen) и отрендерить каждое сообщение в транскрипте. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появляться сообщения |

214| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите на `1`, чтобы отключить [workflows](/ru/workflows#turn-workflows-off). Эквивалент параметра [`disableWorkflows`](/ru/settings#available-settings) |214| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите на `1`, чтобы отключить [workflows](/docs/ru/workflows#turn-workflows-off). Эквивалент параметра [`disableWorkflows`](/docs/ru/settings#available-settings) |

215| `CLAUDE_CODE_EFFORT_LEVEL` | Установите уровень усилий для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования значения по умолчанию модели. Доступные уровни зависят от модели. Имеет приоритет над `/effort` и параметром `effortLevel`. См. [Отрегулировать уровень усилий](/ru/model-config#adjust-effort-level) |215| `CLAUDE_CODE_EFFORT_LEVEL` | Установите уровень усилий для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования значения по умолчанию модели. Доступные уровни зависят от модели. Имеет приоритет над `/effort` и параметром `effortLevel`. См. [Отрегулировать уровень усилий](/docs/ru/model-config#adjust-effort-level) |

216| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | {/* min-version: 2.1.205 */}Установите на `1`, чтобы включить добавление дополнительного текста в конец системного приглашения каждого [subagent](/ru/sub-agents). Флаг [`--append-subagent-system-prompt`](/ru/cli-reference#cli-flags) предоставляет добавленный текст и устанавливает эту переменную автоматически, поэтому вам не нужно устанавливать её самостоятельно. Требуется Claude Code v2.1.205 или более поздняя версия |216| `CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT` | Установите на `1`, чтобы включить добавление дополнительного текста в конец системного приглашения каждого [subagent](/docs/ru/sub-agents). Флаг [`--append-subagent-system-prompt`](/docs/ru/cli-reference#cli-flags) предоставляет добавленный текст и устанавливает эту переменную автоматически, поэтому вам не нужно устанавливать её самостоятельно. Требуется Claude Code v2.1.205 или более поздняя версия |

217| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.207 */}Принято для совместимости со старыми выпусками и не имеет эффекта. Автоматический режим доступен по умолчанию на каждом поставщике, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и вошедшие в систему сессии [Claude apps gateway](/ru/claude-apps-gateway). В v2.1.158 через v2.1.206 установка этого на `1` была необходима, чтобы сделать [автоматический режим](/ru/permission-modes#eliminate-prompts-with-auto-mode) доступным на этих поставщиках |217| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Принято для совместимости со старыми выпусками и не имеет эффекта. Автоматический режим доступен по умолчанию на каждом поставщике, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и вошедшие в систему сессии [Claude apps gateway](/docs/ru/claude-apps-gateway). В v2.1.158 через v2.1.206 установка этого на `1` была необходима, чтобы сделать [автоматический режим](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) доступным на этих поставщиках |

218| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сессии](/ru/interactive-mode#session-recap). Установите на `0`, чтобы принудительно отключить сводки независимо от переключателя `/config`. Установите на `1`, чтобы принудительно включить сводки, когда [`awaySummaryEnabled`](/ru/settings#available-settings) имеет значение `false`. Имеет приоритет над параметром и переключателем `/config` |218| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сессии](/docs/ru/interactive-mode#session-recap). Установите на `0`, чтобы принудительно отключить сводки независимо от переключателя `/config`. Установите на `1`, чтобы принудительно включить сводки, когда [`awaySummaryEnabled`](/docs/ru/settings#available-settings) имеет значение `false`. Имеет приоритет над параметром и переключателем `/config` |

219| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите на `1`, чтобы обновлять состояние plugin на границах хода в [неинтерактивном режиме](/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системное приглашение в середине сессии, что делает недействительным [кэширование приглашений](/ru/prompt-caching) для этого хода |219| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите на `1`, чтобы обновлять состояние plugin на границах хода в [неинтерактивном режиме](/docs/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системное приглашение в середине сессии, что делает недействительным [кэширование приглашений](/docs/ru/prompt-caching) для этого хода |

220| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Установите на `1`, чтобы направить опрос качества сессии "How is Claude doing?" на ваш собственный [сборщик OpenTelemetry](/ru/monitoring-usage), когда трафик, не связанный с Anthropic, заблокирован. Оценки опроса выдаются только как события OTEL вашему настроенному сборщику. Никакие данные опроса не отправляются в Anthropic в этом режиме. Применяется, когда установлена переменная `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, и не имеет эффекта в противном случае. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` и политика обратной связи организации имеют приоритет |220| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Установите на `1`, чтобы направить опрос качества сессии "How is Claude doing?" на ваш собственный [сборщик OpenTelemetry](/docs/ru/monitoring-usage), когда трафик, не связанный с Anthropic, заблокирован. Оценки опроса выдаются только как события OTEL вашему настроенному сборщику. Никакие данные опроса не отправляются в Anthropic в этом режиме. Применяется, когда установлена переменная `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` или `DO_NOT_TRACK`, и не имеет эффекта в противном случае. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` и политика обратной связи организации имеют приоритет |

221| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Управляет потоковой передачей входных данных инструмента с тонкой зернистостью из API по мере их создания Claude. С этим отключением большой входной параметр инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на Anthropic API. На Amazon Bedrock и Google Cloud's Agent Platform включено для каждой модели, где развёрнутый контейнер это поддерживает. Установите на `0`, чтобы отказаться. Установите на `1`, чтобы принудительно включить при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Microsoft Foundry и соединениях [шлюза](/ru/llm-gateway) |221| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Управляет потоковой передачей входных данных инструмента с тонкой зернистостью из API по мере их создания Claude. С этим отключением большой входной параметр инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на Anthropic API. На Amazon Bedrock и Google Cloud's Agent Platform включено для каждой модели, где развёрнутый контейнер это поддерживает. Установите на `0`, чтобы отказаться. Установите на `1`, чтобы принудительно включить при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Microsoft Foundry и соединениях [шлюза](/docs/ru/llm-gateway) |

222| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите на `1`, чтобы заполнить средство выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показывали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются по списку разрешений [`availableModels`](/ru/settings#available-settings), который сессия получает; доставляйте список через [MDM или управляемый файл параметров](/ru/settings#settings-files), так как [доставка, управляемая сервером, недоступна на конфигурациях шлюза](/ru/server-managed-settings#platform-availability) |222| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите на `1`, чтобы заполнить средство выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показывали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются по списку разрешений [`availableModels`](/docs/ru/settings#available-settings), который сессия получает; доставляйте список через [MDM или управляемый файл параметров](/docs/ru/settings#settings-files), так как [доставка, управляемая сервером, недоступна на конфигурациях шлюза](/docs/ru/server-managed-settings#platform-availability) |

223| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Удалено в v2.1.142, когда [быстрый режим](/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |223| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Удалено в v2.1.142, когда [быстрый режим](/docs/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |

224| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите на `false`, чтобы отключить предложения приглашений (переключатель "Prompt suggestions" в `/config`). Это затемнённые предсказания, которые появляются в вашем вводе приглашения после ответа Claude. См. [Предложения приглашений](/ru/interactive-mode#prompt-suggestions) |224| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите на `false`, чтобы отключить предложения приглашений (переключатель "Prompt suggestions" в `/config`). Это затемнённые предсказания, которые появляются в вашем вводе приглашения после ответа Claude. См. [Предложения приглашений](/docs/ru/interactive-mode#prompt-suggestions) |

225| `CLAUDE_CODE_ENABLE_TASKS` | Управляет тем, используют ли сессии структурированные инструменты Task (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) или устаревший инструмент `TodoWrite`. {/* min-version: 2.1.142 */}Начиная с Claude Code v2.1.142, инструменты Task являются стандартом во всех режимах. Установите на `0`, чтобы вернуться к `TodoWrite`. См. [Список задач](/ru/interactive-mode#task-list) и [Миграция на инструменты Task](/ru/agent-sdk/todo-tracking#migrate-to-task-tools) |225| `CLAUDE_CODE_ENABLE_TASKS` | Управляет тем, используют ли сессии структурированные инструменты Task (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) или устаревший инструмент `TodoWrite`. Начиная с Claude Code v2.1.142, инструменты Task являются стандартом во всех режимах. Установите на `0`, чтобы вернуться к `TodoWrite`. См. [Список задач](/docs/ru/interactive-mode#task-list) и [Миграция на инструменты Task](/docs/ru/agent-sdk/todo-tracking#migrate-to-task-tools) |

226| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите на `1`, чтобы включить сбор данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортёров OTel. См. [Мониторинг](/ru/monitoring-usage) |226| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите на `1`, чтобы включить сбор данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортёров OTel. См. [Мониторинг](/docs/ru/monitoring-usage) |

227| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Время в миллисекундах для ожидания после того, как цикл запроса становится неактивным, перед автоматическим выходом. Полезно для автоматизированных рабочих процессов и скриптов, использующих режим SDK |227| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Время в миллисекундах для ожидания после того, как цикл запроса становится неактивным, перед автоматическим выходом. Полезно для автоматизированных рабочих процессов и скриптов, использующих режим SDK |

228| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Установите на `1`, чтобы включить [команды агентов](/ru/agent-teams). Команды агентов являются экспериментальными и отключены по умолчанию |228| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Установите на `1`, чтобы включить [команды агентов](/docs/ru/agent-teams). Команды агентов являются экспериментальными и отключены по умолчанию |

229| `CLAUDE_CODE_EXTRA_BODY` | JSON объект для объединения на верхний уровень каждого тела запроса API. Полезно для передачи параметров, специфичных для поставщика, которые Claude Code не раскрывает напрямую. {/* min-version: 2.1.206 */}Значение, экспортированное в вашей оболочке, также применяется к [фоновым сессиям](/ru/agent-view), которые вы отправляете с помощью `claude agents` или `--bg`. До v2.1.206 фоновые сессии игнорировали экспортированное значение оболочки и использовали любую копию, которую унаследовал процесс супервизора фоновых сессий |229| `CLAUDE_CODE_EXTRA_BODY` | JSON объект для объединения на верхний уровень каждого тела запроса API. Полезно для передачи параметров, специфичных для поставщика, которые Claude Code не раскрывает напрямую. Значение, экспортированное в вашей оболочке, также применяется к [фоновым сессиям](/docs/ru/agent-view), которые вы отправляете с помощью `claude agents` или `--bg`. До v2.1.206 фоновые сессии игнорировали экспортированное значение оболочки и использовали любую копию, которую унаследовал процесс супервизора фоновых сессий |

230| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Переопределить ограничение токенов по умолчанию для чтения файлов. Полезно, когда вам нужно полностью прочитать большие файлы |230| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Переопределить ограничение токенов по умолчанию для чтения файлов. Полезно, когда вам нужно полностью прочитать большие файлы |

231| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}Установите на `1`, чтобы принудительно включить сохранение транскрипта, истории приглашений и регистрацию `claude agents` даже когда этот `claude` был запущен изнутри другой сессии Claude Code. Используйте, когда унаследованное значение `CLAUDE_CODE_CHILD_SESSION`, например из сервера tmux, впервые запущенного инструментом Bash Claude Code, вызывает неправильную классификацию подлинной сессии верхнего уровня как вложенной. {/* min-version: 2.1.178 */}Начиная с v2.1.178, Claude Code автоматически обнаруживает случай tmux и игнорирует унаследованный маркер, поэтому tmux больше не нуждается в этой переменной. Также соблюдается на v2.1.169 и более ранних версиях; не имеет эффекта на v2.1.170 и v2.1.171, где обнаружение вложенной сессии, которое оно переопределяет, было удалено |231| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Установите на `1`, чтобы принудительно включить сохранение транскрипта, истории приглашений и регистрацию `claude agents` даже когда этот `claude` был запущен изнутри другой сессии Claude Code. Используйте, когда унаследованное значение `CLAUDE_CODE_CHILD_SESSION`, например из сервера tmux, впервые запущенного инструментом Bash Claude Code, вызывает неправильную классификацию подлинной сессии верхнего уровня как вложенной. Начиная с v2.1.178, Claude Code автоматически обнаруживает случай tmux и игнорирует унаследованный маркер, поэтому tmux больше не нуждается в этой переменной. Также соблюдается на v2.1.169 и более ранних версиях; не имеет эффекта на v2.1.170 и v2.1.171, где обнаружение вложенной сессии, которое оно переопределяет, было удалено |

232| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {/* min-version: 2.1.186 */}Установите на `1`, чтобы принудительно использовать зачёркивание для `~~text~~` в ответах Claude, когда ваш терминал это поддерживает, но не автоматически обнаруживается, например, через SSH без переданного `TERM_PROGRAM`. Без этого необнаруженные терминалы показывают буквальные маркеры `~~` вместо отрисовки текста как зачёркнутого. Требуется Claude Code v2.1.186 или более поздняя версия |232| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Установите на `1`, чтобы принудительно использовать зачёркивание для `~~text~~` в ответах Claude, когда ваш терминал это поддерживает, но не автоматически обнаруживается, например, через SSH без переданного `TERM_PROGRAM`. Без этого необнаруженные терминалы показывают буквальные маркеры `~~` вместо отрисовки текста как зачёркнутого. Требуется Claude Code v2.1.186 или более поздняя версия |

233| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Установите на `1`, чтобы принудительно включить режим DEC private 2026 [синхронизированный вывод](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036), когда ваш терминал его поддерживает, но не автоматически обнаруживается. Полезно для эмуляторов, таких как Emacs `eat`, которые реализуют BSU/ESU, но не отвечают на зонд возможностей. Не влияет на tmux. В отличие от `CLAUDE_CODE_NO_FLICKER`, который переключается на [полноэкранный режим](/ru/fullscreen), это не изменяет рендерер |233| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Установите на `1`, чтобы принудительно включить режим DEC private 2026 [синхронизированный вывод](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036), когда ваш терминал его поддерживает, но не автоматически обнаруживается. Полезно для эмуляторов, таких как Emacs `eat`, которые реализуют BSU/ESU, но не отвечают на зонд возможностей. Не влияет на tmux. В отличие от `CLAUDE_CODE_NO_FLICKER`, который переключается на [полноэкранный режим](/docs/ru/fullscreen), это не изменяет рендерер |

234| `CLAUDE_CODE_FORK_SUBAGENT` | Установите на `1`, чтобы позволить Claude порождать [разветвлённые subagents](/ru/sub-agents#fork-the-current-conversation), или на `0`, чтобы отключить их, переопределяя любое развёртывание на стороне сервера. При включении Claude может запросить тип subagent `fork` для порождения разветвления, subagent, который наследует полный контекст разговора вместо начала с нуля. Порождения без типа subagent по-прежнему используют общего назначения subagent, и все порождения subagent выполняются в фоне. Явная команда [`/fork`](/ru/commands) работает без этой переменной. Работает в интерактивном режиме и через SDK или `claude -p` |234| `CLAUDE_CODE_FORK_SUBAGENT` | Установите на `1`, чтобы позволить Claude порождать [разветвлённые subagents](/docs/ru/sub-agents#fork-the-current-conversation), или на `0`, чтобы отключить их, переопределяя любое развёртывание на стороне сервера. При включении Claude может запросить тип subagent `fork` для порождения разветвления, subagent, который наследует полный контекст разговора вместо начала с нуля. Порождения без типа subagent по-прежнему используют общего назначения subagent, и все порождения subagent выполняются в фоне. Явная команда [`/fork`](/docs/ru/commands) работает без этой переменной. Работает в интерактивном режиме и через SDK или `claude -p` |

235| `CLAUDE_CODE_GIT_BASH_PATH` | Только Windows: путь к исполняемому файлу Git Bash (`bash.exe`). Используйте, когда Git Bash установлен, но не в вашем PATH. См. [Настройка Windows](/ru/setup#set-up-on-windows) |235| `CLAUDE_CODE_GIT_BASH_PATH` | Только Windows: путь к исполняемому файлу Git Bash (`bash.exe`). Используйте, когда Git Bash установлен, но не в вашем PATH. См. [Настройка Windows](/docs/ru/setup#set-up-on-windows) |

236| `CLAUDE_CODE_GLOB_HIDDEN` | Установите на `false`, чтобы исключить скрытые файлы из результатов, когда Claude вызывает [инструмент Glob](/ru/tools-reference#glob-tool-behavior). Включено по умолчанию. Не влияет на автодополнение файлов `@`, `ls`, Grep или Read |236| `CLAUDE_CODE_GLOB_HIDDEN` | Установите на `false`, чтобы исключить скрытые файлы из результатов, когда Claude вызывает [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior). Включено по умолчанию. Не влияет на автодополнение файлов `@`, `ls`, Grep или Read |

237| `CLAUDE_CODE_GLOB_NO_IGNORE` | Установите на `false`, чтобы заставить [инструмент Glob](/ru/tools-reference#glob-tool-behavior) соблюдать шаблоны `.gitignore`. По умолчанию Glob возвращает все совпадающие файлы, включая игнорируемые git. Не влияет на автодополнение файлов `@`, которое имеет свой собственный [параметр `respectGitignore`](/ru/settings#available-settings) |237| `CLAUDE_CODE_GLOB_NO_IGNORE` | Установите на `false`, чтобы заставить [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior) соблюдать шаблоны `.gitignore`. По умолчанию Glob возвращает все совпадающие файлы, включая игнорируемые git. Не влияет на автодополнение файлов `@`, которое имеет свой собственный [параметр `respectGitignore`](/docs/ru/settings#available-settings) |

238| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Тайм-аут в секундах для обнаружения файлов инструмента Glob. По умолчанию 20 секунд на большинстве платформ и 60 секунд на WSL |238| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Тайм-аут в секундах для обнаружения файлов инструмента Glob. По умолчанию 20 секунд на большинстве платформ и 60 секунд на WSL |

239| `CLAUDE_CODE_HIDE_CWD` | Установите на `1`, чтобы скрыть рабочий каталог в логотипе при запуске. Полезно для совместного использования экрана или записей, где путь раскрывает имя пользователя вашей ОС |239| `CLAUDE_CODE_HIDE_CWD` | Установите на `1`, чтобы скрыть рабочий каталог в логотипе при запуске. Полезно для совместного использования экрана или записей, где путь раскрывает имя пользователя вашей ОС |

240| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Переопределить адрес хоста, используемый для подключения к расширению IDE. По умолчанию Claude Code автоматически обнаруживает правильный адрес, включая маршрутизацию WSL-to-Windows |240| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Переопределить адрес хоста, используемый для подключения к расширению IDE. По умолчанию Claude Code автоматически обнаруживает правильный адрес, включая маршрутизацию WSL-to-Windows |

241| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Пропустить автоматическую установку расширений IDE. Эквивалент установки [`autoInstallIdeExtension`](/ru/settings#global-config-settings) на `false` |241| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Пропустить автоматическую установку расширений IDE. Эквивалент установки [`autoInstallIdeExtension`](/docs/ru/settings#global-config-settings) на `false` |

242| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Установите на `1`, чтобы пропустить проверку записей файла блокировки IDE при подключении. Используйте, когда автоматическое подключение не может найти вашу IDE, несмотря на то, что она работает |242| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Установите на `1`, чтобы пропустить проверку записей файла блокировки IDE при подключении. Используйте, когда автоматическое подключение не может найти вашу IDE, несмотря на то, что она работает |

243| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Переопределить размер контекстного окна, который Claude Code предполагает для активной модели. {/* min-version: 2.1.193 */}Начиная с v2.1.193, применяется непосредственно для имён моделей, которые Claude Code не распознаёт как модель Claude; для распознанных моделей Claude это вступает в силу только при установке `DISABLE_COMPACT`. Используйте это при маршрутизации к модели через `ANTHROPIC_BASE_URL`, чьё контекстное окно не совпадает с встроенным размером для её имени |243| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Переопределить размер контекстного окна, который Claude Code предполагает для активной модели. Начиная с v2.1.193, применяется непосредственно для имён моделей, которые Claude Code не распознаёт как модель Claude; для распознанных моделей Claude это вступает в силу только при установке `DISABLE_COMPACT`. Используйте это при маршрутизации к модели через `ANTHROPIC_BASE_URL`, чьё контекстное окно не совпадает с встроенным размером для её имени |

244| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Установите максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и максимальные значения варьируются в зависимости от модели; см. [максимальное количество выходных токенов](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Увеличение этого значения уменьшает доступное контекстное окно перед срабатыванием [auto-compaction](/ru/costs#reduce-token-usage) |244| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Установите максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и максимальные значения варьируются в зависимости от модели; см. [максимальное количество выходных токенов](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Увеличение этого значения уменьшает доступное контекстное окно перед срабатыванием [auto-compaction](/docs/ru/costs#reduce-token-usage) |

245| `CLAUDE_CODE_MAX_RETRIES` | Переопределить количество попыток повтора неудачных запросов API (по умолчанию: 10). {/* min-version: 2.1.186 */}Ограничено 15 начиная с v2.1.186; {/* min-version: 2.1.199 */}начиная с v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет лимит. Для автоматических сессий, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG` вместо этого |245| `CLAUDE_CODE_MAX_RETRIES` | Переопределить количество попыток повтора неудачных запросов API (по умолчанию: 10). Ограничено 15 начиная с v2.1.186; начиная с v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет лимит. Для автоматических сессий, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG` вместо этого |

246| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и subagents, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |246| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и subagents, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |

247| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентских ходов, когда явный лимит не передан. Эквивалент передачи [`--max-turns`](/ru/cli-reference#cli-flags), который имеет приоритет, когда оба установлены. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не рассматривается как отсутствие лимита |247| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентских ходов, когда явный лимит не передан. Эквивалент передачи [`--max-turns`](/docs/ru/cli-reference#cli-flags), который имеет приоритет, когда оба установлены. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не рассматривается как отсутствие лимита |

248| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите на `1`, чтобы порождать stdio MCP servers с только безопасной базовой средой плюс настроенная `env` сервера, вместо наследования вашей среды оболочки |248| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите на `1`, чтобы порождать stdio MCP servers с только безопасной базовой средой плюс настроенная `env` сервера, вместо наследования вашей среды оболочки |

249| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}Тайм-аут неактивности в миллисекундах для удалённых вызовов инструментов MCP. Когда HTTP, SSE, WebSocket или [claude.ai connector](/ru/mcp#use-mcp-servers-from-claude-ai) MCP server не отправляет ответ и не отправляет уведомление о прогрессе в течение этого времени, вызов инструмента прерывается с ошибкой вместо ожидания стены часов `MCP_TOOL_TIMEOUT`. Переопределяет значения по умолчанию для каждого транспорта в 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для stdio серверов. Установите на `0`, чтобы отключить проверку неактивности. Значения ниже 1000 повышаются до одной секунды, и значение ограничено эффективным `MCP_TOOL_TIMEOUT`. Поле `timeout` для каждого сервера в `.mcp.json` не менее 1000 повышает окно неактивности этого сервера по крайней мере до значения `timeout`; это требует Claude Code v2.1.203 или более поздней версии. Не применяется к IDE servers или SDK in-process servers. Требуется Claude Code v2.1.187 или более поздняя версия. {/* min-version: 2.1.203 */}До v2.1.203 stdio серверы были освобождены от тайм-аута неактивности |249| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Тайм-аут неактивности в миллисекундах для удалённых вызовов инструментов MCP. Когда HTTP, SSE, WebSocket или [claude.ai connector](/docs/ru/mcp#use-mcp-servers-from-claude-ai) MCP server не отправляет ответ и не отправляет уведомление о прогрессе в течение этого времени, вызов инструмента прерывается с ошибкой вместо ожидания стены часов `MCP_TOOL_TIMEOUT`. Переопределяет значения по умолчанию для каждого транспорта в 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для stdio серверов. Установите на `0`, чтобы отключить проверку неактивности. Значения ниже 1000 повышаются до одной секунды, и значение ограничено эффективным `MCP_TOOL_TIMEOUT`. Поле `timeout` для каждого сервера в `.mcp.json` не менее 1000 повышает окно неактивности этого сервера по крайней мере до значения `timeout`; это требует Claude Code v2.1.203 или более поздней версии. Не применяется к IDE servers или SDK in-process servers. Требуется Claude Code v2.1.187 или более поздняя версия. До v2.1.203 stdio серверы были освобождены от тайм-аута неактивности |

250| `CLAUDE_CODE_NATIVE_CURSOR` | Установите на `1`, чтобы показать собственный курсор терминала в позиции ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |250| `CLAUDE_CODE_NATIVE_CURSOR` | Установите на `1`, чтобы показать собственный курсор терминала в позиции ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |

251| `CLAUDE_CODE_NEW_INIT` | Установите на `1`, чтобы `/init` запустил интерактивный поток настройки. Поток спрашивает, какие файлы генерировать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` автоматически генерирует CLAUDE.md без запроса |251| `CLAUDE_CODE_NEW_INIT` | Установите на `1`, чтобы `/init` запустил интерактивный поток настройки. Поток спрашивает, какие файлы генерировать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` автоматически генерирует CLAUDE.md без запроса |

252| `CLAUDE_CODE_NO_FLICKER` | Установите на `1`, чтобы включить [полноэкранный режим](/ru/fullscreen), исследовательский предпросмотр, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Эквивалент параметра [`tui`](/ru/settings#available-settings); вы также можете переключаться с помощью `/tui fullscreen` |252| `CLAUDE_CODE_NO_FLICKER` | Установите на `1`, чтобы включить [полноэкранный режим](/docs/ru/fullscreen), исследовательский предпросмотр, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Эквивалент параметра [`tui`](/docs/ru/settings#available-settings); вы также можете переключаться с помощью `/tui fullscreen` |

253| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | OAuth токен обновления для аутентификации Claude.ai. При установке `claude auth login` обменивает этот токен напрямую вместо открытия браузера. Требует `CLAUDE_CODE_OAUTH_SCOPES`. Полезно для предоставления аутентификации в автоматизированных сред |253| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | OAuth токен обновления для аутентификации Claude.ai. При установке `claude auth login` обменивает этот токен напрямую вместо открытия браузера. Требует `CLAUDE_CODE_OAUTH_SCOPES`. Полезно для предоставления аутентификации в автоматизированных сред |

254| `CLAUDE_CODE_OAUTH_SCOPES` | Разделённые пробелом OAuth области, с которыми был выдан токен обновления, такие как `"user:profile user:inference user:sessions:claude_code"`. Требуется, когда установлен `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |254| `CLAUDE_CODE_OAUTH_SCOPES` | Разделённые пробелом OAuth области, с которыми был выдан токен обновления, такие как `"user:profile user:inference user:sessions:claude_code"`. Требуется, когда установлен `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |

255| `CLAUDE_CODE_OAUTH_TOKEN` | OAuth токен доступа для аутентификации Claude.ai. Альтернатива `/login` для SDK и автоматизированных сред. Имеет приоритет над учётными данными, хранящимися в цепочке ключей. Создайте один с помощью [`claude setup-token`](/ru/authentication#generate-a-long-lived-token) |255| `CLAUDE_CODE_OAUTH_TOKEN` | OAuth токен доступа для аутентификации Claude.ai. Альтернатива `/login` для SDK и автоматизированных сред. Имеет приоритет над учётными данными, хранящимися в цепочке ключей. Создайте один с помощью [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token) |

256| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}Удалено в v2.1.160 и теперь является no-op. Ранее закреплял [быстрый режим](/ru/fast-mode) на Claude Opus 4.6 вместо текущего стандарта. Opus 4.6 больше не поддерживает быстрый режим |256| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Удалено в v2.1.160 и теперь является no-op. Ранее закреплял [быстрый режим](/docs/ru/fast-mode) на Claude Opus 4.6 вместо текущего стандарта. Opus 4.6 больше не поддерживает быстрый режим |

257| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}Установите на `1`, чтобы записать диагностические ошибки экспортёра OpenTelemetry в stderr. По умолчанию эти ошибки появляются только с `--debug`, поэтому неправильно настроенный экспортёр, такой как конфликт портов Prometheus, в противном случае молча не удаётся. Требуется Claude Code v2.1.179 или более поздняя версия. См. [Мониторинг](/ru/monitoring-usage) |257| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Установите на `1`, чтобы записать диагностические ошибки экспортёра OpenTelemetry в stderr. По умолчанию эти ошибки появляются только с `--debug`, поэтому неправильно настроенный экспортёр, такой как конфликт портов Prometheus, в противном случае молча не удаётся. Требуется Claude Code v2.1.179 или более поздняя версия. См. [Мониторинг](/docs/ru/monitoring-usage) |

258| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Тайм-аут в миллисекундах для очистки ожидающих spans OpenTelemetry (по умолчанию: 5000). См. [Мониторинг](/ru/monitoring-usage) |258| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Тайм-аут в миллисекундах для очистки ожидающих spans OpenTelemetry (по умолчанию: 5000). См. [Мониторинг](/docs/ru/monitoring-usage) |

259| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал для обновления динамических заголовков OpenTelemetry в миллисекундах (по умолчанию: 1740000 / 29 минут). См. [Динамические заголовки](/ru/monitoring-usage#dynamic-headers) |259| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал для обновления динамических заголовков OpenTelemetry в миллисекундах (по умолчанию: 1740000 / 29 минут). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) |

260| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Тайм-аут в миллисекундах для экспортёра OpenTelemetry для завершения при выключении (по умолчанию: 2000). Увеличьте, если метрики отбрасываются при выходе. См. [Мониторинг](/ru/monitoring-usage) |260| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Тайм-аут в миллисекундах для экспортёра OpenTelemetry для завершения при выключении (по умолчанию: 2000). Увеличьте, если метрики отбрасываются при выходе. См. [Мониторинг](/docs/ru/monitoring-usage) |

261| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите на `1`, чтобы позволить Claude Code запустить команду обновления вашего менеджера пакетов в фоне, когда доступна новая версия. Применяется к установкам Homebrew и WinGet. Другие менеджеры пакетов продолжают показывать команду обновления без её запуска. См. [Автоматические обновления](/ru/setup#auto-updates) |261| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите на `1`, чтобы позволить Claude Code запустить команду обновления вашего менеджера пакетов в фоне, когда доступна новая версия. Применяется к установкам Homebrew и WinGet. Другие менеджеры пакетов продолжают показывать команду обновления без её запуска. См. [Автоматические обновления](/docs/ru/setup#auto-updates) |

262| `CLAUDE_CODE_PERFORCE_MODE` | Установите на `1`, чтобы включить защиту от записи с учётом Perforce. При установке Edit, Write и NotebookEdit не удаются с подсказкой `p4 edit <file>`, если целевой файл не имеет бита владельца-записи, который Perforce очищает на синхронизированных файлах до тех пор, пока `p4 edit` их не откроет. Это предотвращает обход Claude Code отслеживания изменений Perforce |262| `CLAUDE_CODE_PERFORCE_MODE` | Установите на `1`, чтобы включить защиту от записи с учётом Perforce. При установке Edit, Write и NotebookEdit не удаются с подсказкой `p4 edit <file>`, если целевой файл не имеет бита владельца-записи, который Perforce очищает на синхронизированных файлах до тех пор, пока `p4 edit` их не откроет. Это предотвращает обход Claude Code отслеживания изменений Perforce |

263| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределить корневой каталог plugins. Несмотря на название, это устанавливает родительский каталог, а не сам кэш: marketplaces и кэш plugin находятся в подкаталогах под этим путём. По умолчанию `~/.claude/plugins` |263| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределить корневой каталог plugins. Несмотря на название, это устанавливает родительский каталог, а не сам кэш: marketplaces и кэш plugin находятся в подкаталогах под этим путём. По умолчанию `~/.claude/plugins` |

264| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Тайм-аут в миллисекундах для операций git при установке или обновлении plugins (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых соединений. См. [Операции Git истекают](/ru/plugin-marketplaces#git-operations-time-out) |264| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Тайм-аут в миллисекундах для операций git при установке или обновлении plugins (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых соединений. См. [Операции Git истекают](/docs/ru/plugin-marketplaces#git-operations-time-out) |

265| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите на `1`, чтобы сохранить существующий кэш marketplace, когда `git pull` не удаётся, вместо очистки и повторного клонирования. Полезно в автономных или изолированных сетях, где повторное клонирование не удалось бы таким же образом. См. [Обновления Marketplace не удаются в автономных сред](/ru/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |265| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите на `1`, чтобы сохранить существующий кэш marketplace, когда `git pull` не удаётся, вместо очистки и повторного клонирования. Полезно в автономных или изолированных сетях, где повторное клонирование не удалось бы таким же образом. См. [Обновления Marketplace не удаются в автономных сред](/docs/ru/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |

266| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите на `1`, чтобы клонировать источники plugin GitHub `owner/repo` через HTTPS вместо SSH. Применяется к установке plugin и обновлению, а также к `/plugin marketplace add` и `update`. Полезно в CI runners, контейнерах или любой среде без настроенного ключа SSH для `github.com` |266| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите на `1`, чтобы клонировать источники plugin GitHub `owner/repo` через HTTPS вместо SSH. Применяется к установке plugin и обновлению, а также к `/plugin marketplace add` и `update`. Полезно в CI runners, контейнерах или любой среде без настроенного ключа SSH для `github.com` |

267| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким каталогам seed plugins только для чтения, разделённым `:` на Unix или `;` на Windows. Используйте это, чтобы объединить предварительно заполненный каталог plugins в образ контейнера. Claude Code регистрирует marketplaces из этих каталогов при запуске и использует предварительно кэшированные plugins без повторного клонирования. См. [Предварительное заполнение plugins для контейнеров](/ru/plugin-marketplaces#pre-populate-plugins-for-containers) |267| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким каталогам seed plugins только для чтения, разделённым `:` на Unix или `;` на Windows. Используйте это, чтобы объединить предварительно заполненный каталог plugins в образ контейнера. Claude Code регистрирует marketplaces из этих каталогов при запуске и использует предварительно кэшированные plugins без повторного клонирования. См. [Предварительное заполнение plugins для контейнеров](/docs/ru/plugin-marketplaces#pre-populate-plugins-for-containers) |

268| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите на `1`, чтобы остановить Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и вместо этого соблюдать эффективную политику выполнения машины. По умолчанию Claude Code обходит политику выполнения в области процесса, поэтому скрипты `.ps1` и импорты модулей работают на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |268| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите на `1`, чтобы остановить Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и вместо этого соблюдать эффективную политику выполнения машины. По умолчанию Claude Code обходит политику выполнения в области процесса, поэтому скрипты `.ps1` и импорты модулей работают на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |

269| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Максимальное время в миллисекундах, которое [неинтерактивный режим](/ru/headless#background-tasks-at-exit) с флагом `-p` ждёт после финального хода для фоновых subagents и workflows, результат которых является частью вывода. По умолчанию: `600000`, или 10 минут. Когда лимит превышен, оставшиеся фоновые задачи завершаются и процесс выходит. Установите на `0`, чтобы ждать бесконечно. Этот лимит отделён от пятисекундного периода благодати, который применяется к простым фоновым оболочкам |269| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Максимальное время в миллисекундах, которое [неинтерактивный режим](/docs/ru/headless#background-tasks-at-exit) с флагом `-p` ждёт после финального хода для фоновых subagents и workflows, результат которых является частью вывода. По умолчанию: `600000`, или 10 минут. Когда лимит превышен, оставшиеся фоновые задачи завершаются и процесс выходит. Установите на `0`, чтобы ждать бесконечно. Этот лимит отделён от пятисекундного периода благодати, который применяется к простым фоновым оболочкам |

270| `CLAUDE_CODE_PROCESS_WRAPPER` | {/* min-version: 2.1.208 */}Запустить процессы Claude Code, которые он запускает из собственного бинарного файла, через обёртку исполняемого файла, заданную как префикс argv, такой как `/opt/corp/launcher`. Охватывает фоновый сервис, который размещает [представление агента](/ru/agent-view) сессии, каждую сессию, которую он порождает, и перезапуск Claude Code выполняет себя, чтобы завершить установку обновления. Первый токен должен быть абсолютным путём исполняемого файла, который заканчивается запуском `exec "$@"`, и большинство пусковых установок — это один путь. Значение — это список аргументов, а не команда оболочки: пробелы разделяют токены, двойные кавычки группируют путь, содержащий пробелы, и значение, которое начинается с `[`, читается как JSON массив строк. Установите это в блоке `env` пользовательских или [управляемых параметров](/ru/permissions#managed-settings), а не как экспорт оболочки, поэтому отделённый фоновый сервис его наследует; параметры проекта и локальные параметры не могут его установить. Расширение VS Code настраивает свой собственный пусковой механизм отдельно через его параметр `claudeProcessWrapper`. Игнорируется на Windows. `CLAUDE_CODE_SHELL_PREFIX` — это отдельный контроль: он обёртывает команды bash, которые Claude Code запускает как одну строку в кавычках оболочки, в то время как эта переменная обёртывает собственные процессы Claude Code как префикс argv. См. [Запустить Claude Code за корпоративным пусковым механизмом](/ru/corporate-launcher) |270| `CLAUDE_CODE_PROCESS_WRAPPER` | Запустить процессы Claude Code, которые он запускает из собственного бинарного файла, через обёртку исполняемого файла, заданную как префикс argv, такой как `/opt/corp/launcher`. Охватывает фоновый сервис, который размещает [представление агента](/docs/ru/agent-view) сессии, каждую сессию, которую он порождает, и перезапуск Claude Code выполняет себя, чтобы завершить установку обновления. Первый токен должен быть абсолютным путём исполняемого файла, который заканчивается запуском `exec "$@"`, и большинство пусковых установок — это один путь. Значение — это список аргументов, а не команда оболочки: пробелы разделяют токены, двойные кавычки группируют путь, содержащий пробелы, и значение, которое начинается с `[`, читается как JSON массив строк. Установите это в блоке `env` пользовательских или [управляемых параметров](/docs/ru/permissions#managed-settings), а не как экспорт оболочки, поэтому отделённый фоновый сервис его наследует; параметры проекта и локальные параметры не могут его установить. Расширение VS Code настраивает свой собственный пусковой механизм отдельно через его параметр `claudeProcessWrapper`. Игнорируется на Windows. `CLAUDE_CODE_SHELL_PREFIX` — это отдельный контроль: он обёртывает команды bash, которые Claude Code запускает как одну строку в кавычках оболочки, в то время как эта переменная обёртывает собственные процессы Claude Code как префикс argv. См. [Запустить Claude Code за корпоративным пусковым механизмом](/docs/ru/corporate-launcher) |

271| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Установите на `1`, чтобы распространять контекст трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к Anthropic API. Добавлено в v2.1.152. См. [Трассировки (beta)](/ru/monitoring-usage#traces-beta) |271| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Установите на `1`, чтобы распространять контекст трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к Anthropic API. Добавлено в v2.1.152. См. [Трассировки (beta)](/docs/ru/monitoring-usage#traces-beta) |

272| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, игнорируются, поэтому параметры пользователя не могут переопределить маршрутизацию хоста. Автоматический отказ от телеметрии для Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry также пропускается, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/ru/data-usage#default-behaviors-by-api-provider) |272| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, игнорируются, поэтому параметры пользователя не могут переопределить маршрутизацию хоста. Автоматический отказ от телеметрии для Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry также пропускается, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/docs/ru/data-usage#default-behaviors-by-api-provider) |

273| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите на `1`, чтобы позволить прокси выполнять разрешение DNS вместо вызывающей стороны. Согласитесь для сред, где прокси должен обрабатывать разрешение имён хостов |273| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите на `1`, чтобы позволить прокси выполнять разрешение DNS вместо вызывающей стороны. Согласитесь для сред, где прокси должен обрабатывать разрешение имён хостов |

274| `CLAUDE_CODE_REMOTE` | Установите автоматически на `true`, когда Claude Code работает как [облачная сессия](/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки, чтобы обнаружить, находитесь ли вы в облачной среде |274| `CLAUDE_CODE_REMOTE` | Установите автоматически на `true`, когда Claude Code работает как [облачная сессия](/docs/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки, чтобы обнаружить, находитесь ли вы в облачной среде |

275| `CLAUDE_CODE_REMOTE_SESSION_ID` | Установите автоматически в [облачных сессиях](/ru/claude-code-on-the-web) на ID текущей сессии. Прочитайте это, чтобы построить ссылку обратно на транскрипт сессии. См. [Ссылка вывода обратно на сессию](/ru/claude-code-on-the-web#link-output-back-to-the-session) |275| `CLAUDE_CODE_REMOTE_SESSION_ID` | Установите автоматически в [облачных сессиях](/docs/ru/claude-code-on-the-web) на ID текущей сессии. Прочитайте это, чтобы построить ссылку обратно на транскрипт сессии. См. [Ссылка вывода обратно на сессию](/docs/ru/claude-code-on-the-web#link-output-back-to-the-session) |

276| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите на `1`, чтобы автоматически возобновить, если предыдущая сессия закончилась в середине хода. Используется в режиме SDK, чтобы модель продолжала работу без необходимости повторной отправки приглашения SDK |276| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите на `1`, чтобы автоматически возобновить, если предыдущая сессия закончилась в середине хода. Используется в режиме SDK, чтобы модель продолжала работу без необходимости повторной отправки приглашения SDK |

277| `CLAUDE_CODE_RESUME_PROMPT` | Переопределить сообщение продолжения, внедрённое при возобновлении сессии, которая закончилась в середине хода. По умолчанию `Continue from where you left off.`. Скрипты порождения для долгоживущих агентов могут установить это на более директивное загрузочное сообщение. Пустая строка использует значение по умолчанию |277| `CLAUDE_CODE_RESUME_PROMPT` | Переопределить сообщение продолжения, внедрённое при возобновлении сессии, которая закончилась в середине хода. По умолчанию `Continue from where you left off.`. Скрипты порождения для долгоживущих агентов могут установить это на более директивное загрузочное сообщение. Пустая строка использует значение по умолчанию |

278| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}Установите на `1` для автоматических сессий, таких как eval harnesses, CI jobs или удалённые рабочие. Повторяет ошибки ёмкости `429` и `529` бесконечно вместо отказа после попыток `CLAUDE_CODE_MAX_RETRIES`. Сторож отступает до 5 минут между попытками, или до сброса лимита, когда ответ содержит время сброса ограничения скорости, поэтому сессия, которая попадает в лимит использования, ждёт оставшегося окна. {/* min-version: 2.1.199 */}Начиная с v2.1.199, это также повышает количество повторных попыток по умолчанию для других переходных ошибок, таких как ошибки сервера, тайм-ауты и разорванные соединения, до 300, примерно три часа отступления, и удаляет лимит 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы установите эту переменную явно. Требуется Claude Code v2.1.186 или более поздняя версия |278| `CLAUDE_CODE_RETRY_WATCHDOG` | Установите на `1` для автоматических сессий, таких как eval harnesses, CI jobs или удалённые рабочие. Повторяет ошибки ёмкости `429` и `529` бесконечно вместо отказа после попыток `CLAUDE_CODE_MAX_RETRIES`. Сторож отступает до 5 минут между попытками, или до сброса лимита, когда ответ содержит время сброса ограничения скорости, поэтому сессия, которая попадает в лимит использования, ждёт оставшегося окна. Начиная с v2.1.199, это также повышает количество повторных попыток по умолчанию для других переходных ошибок, таких как ошибки сервера, тайм-ауты и разорванные соединения, до 300, примерно три часа отступления, и удаляет лимит 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы установите эту переменную явно. Требуется Claude Code v2.1.186 или более поздняя версия |

279| `CLAUDE_CODE_SAFE_MODE` | Установите на `1`, чтобы запустить в безопасном режиме: CLAUDE.md, skills, plugins, hooks, MCP servers, пользовательские команды и агенты, стили вывода, workflows, пользовательские темы, пользовательские сочетания клавиш, команды строки состояния и предложения файлов, LSP servers и автоматическая память не загружаются для устранения неполадок в сломанной конфигурации. Политика управляемых параметров по-прежнему применяется, включая hooks, настроенные политикой, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемые CLAUDE.md и настроенные политикой MCP servers не применяются. Эквивалент передачи [`--safe-mode`](/ru/cli-reference#cli-flags). Непосредственно порождённые дочерние процессы наследуют переменную |279| `CLAUDE_CODE_SAFE_MODE` | Установите на `1`, чтобы запустить в безопасном режиме: CLAUDE.md, skills, plugins, hooks, MCP servers, пользовательские команды и агенты, стили вывода, workflows, пользовательские темы, пользовательские сочетания клавиш, команды строки состояния и предложения файлов, LSP servers и автоматическая память не загружаются для устранения неполадок в сломанной конфигурации. Политика управляемых параметров по-прежнему применяется, включая hooks, настроенные политикой, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемые CLAUDE.md и настроенные политикой MCP servers не применяются. Эквивалент передачи [`--safe-mode`](/docs/ru/cli-reference#cli-flags). Непосредственно порождённые дочерние процессы наследуют переменную |

280| `CLAUDE_CODE_SCRIPT_CAPS` | JSON объект, ограничивающий, сколько раз конкретные скрипты могут быть вызваны за сессию, когда установлен `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Ключи — это подстроки, сопоставленные с текстом команды; значения — это ограничения целого числа вызовов. Например, `{"deploy.sh": 2}` позволяет `deploy.sh` быть вызванным максимум дважды. Сопоставление основано на подстроке, поэтому трюки расширения оболочки, такие как `./scripts/deploy.sh $(evil)`, по-прежнему учитываются в отношении лимита. Разветвление среды выполнения через `xargs` или `find -exec` не обнаруживается; это контроль защиты в глубину |280| `CLAUDE_CODE_SCRIPT_CAPS` | JSON объект, ограничивающий, сколько раз конкретные скрипты могут быть вызваны за сессию, когда установлен `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Ключи — это подстроки, сопоставленные с текстом команды; значения — это ограничения целого числа вызовов. Например, `{"deploy.sh": 2}` позволяет `deploy.sh` быть вызванным максимум дважды. Сопоставление основано на подстроке, поэтому трюки расширения оболочки, такие как `./scripts/deploy.sh $(evil)`, по-прежнему учитываются в отношении лимита. Разветвление среды выполнения через `xargs` или `find -exec` не обнаруживается; это контроль защиты в глубину |

281| `CLAUDE_CODE_SCROLL_SPEED` | Установите множитель прокрутки колеса мыши в [полноэкранном режиме](/ru/fullscreen#mouse-wheel-scrolling). Принимает значения от 1 до 20, и дробные значения ниже 1, такие как `0.5`, чтобы замедлить ускоренную прокрутку трекпада и колеса в терминалах, которые уже усиливают события колеса. Установите на `3`, чтобы соответствовать `vim`, если ваш терминал отправляет одно событие колеса на зубец без усиления. Игнорируется в встроенном терминале JetBrains IDE, где Claude Code использует собственную обработку прокрутки |281| `CLAUDE_CODE_SCROLL_SPEED` | Установите множитель прокрутки колеса мыши в [полноэкранном режиме](/docs/ru/fullscreen#mouse-wheel-scrolling). Принимает значения от 1 до 20, и дробные значения ниже 1, такие как `0.5`, чтобы замедлить ускоренную прокрутку трекпада и колеса в терминалах, которые уже усиливают события колеса. Установите на `3`, чтобы соответствовать `vim`, если ваш терминал отправляет одно событие колеса на зубец без усиления. Игнорируется в встроенном терминале JetBrains IDE, где Claude Code использует собственную обработку прокрутки |

282| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Переопределить бюджет времени в миллисекундах для [SessionEnd](/ru/hooks#sessionend) hooks. Применяется к выходу из сессии, `/clear` и переключению сессий через интерактивный `/resume`. По умолчанию бюджет составляет 1,5 секунды, автоматически повышается до наивысшего `timeout` для каждого hook, настроенного в файлах параметров, до 60 секунд. Тайм-ауты на hooks, предоставленные plugin, не повышают бюджет |282| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Переопределить бюджет времени в миллисекундах для [SessionEnd](/docs/ru/hooks#sessionend) hooks. Применяется к выходу из сессии, `/clear` и переключению сессий через интерактивный `/resume`. По умолчанию бюджет составляет 1,5 секунды, автоматически повышается до наивысшего `timeout` для каждого hook, настроенного в файлах параметров, до 60 секунд. Тайм-ауты на hooks, предоставленные plugin, не повышают бюджет |

283| `CLAUDE_CODE_SESSION_ID` | Установите автоматически в подпроцессах инструмента Bash и PowerShell, подпроцессах [команды hook](/ru/hooks) и подпроцессах stdio [MCP server](/ru/mcp) на ID текущей сессии. Совпадает с полем `session_id` в входных данных hook JSON и обновляется при `/clear`. Подпроцесс MCP server сохраняет ID, с которым он был порождён. На `--resume <session-id>` он получает возобновленный ID, совпадающий с hooks и Bash. На `--continue` или `--resume` без явного ID он может получить начальный ID при запуске вместо этого. Используйте для корреляции скриптов и внешних инструментов с сессией Claude Code, которая их запустила |283| `CLAUDE_CODE_SESSION_ID` | Установите автоматически в подпроцессах инструмента Bash и PowerShell, подпроцессах [команды hook](/docs/ru/hooks) и подпроцессах stdio [MCP server](/docs/ru/mcp) на ID текущей сессии. Совпадает с полем `session_id` в входных данных hook JSON и обновляется при `/clear`. Подпроцесс MCP server сохраняет ID, с которым он был порождён. На `--resume <session-id>` он получает возобновленный ID, совпадающий с hooks и Bash. На `--continue` или `--resume` без явного ID он может получить начальный ID при запуске вместо этого. Используйте для корреляции скриптов и внешних инструментов с сессией Claude Code, которая их запустила |

284| `CLAUDE_CODE_SHELL` | Установить оболочку, которую Claude Code использует для запуска команд инструмента Bash. Принимает путь к бинарному файлу `bash` или `zsh`, например `/opt/homebrew/bin/bash`. Другие оболочки, такие как `fish`, не поддерживаются. Если значение не является рабочим путём `bash` или `zsh`, Claude Code игнорирует его и возвращается к автоматическому обнаружению. Автоматическое обнаружение использует вашу `$SHELL`, когда она указывает на `bash` или `zsh`, в противном случае выбирает первый рабочий `zsh`, затем `bash`, найденный в вашем `PATH` и стандартных местах установки |284| `CLAUDE_CODE_SHELL` | Установить оболочку, которую Claude Code использует для запуска команд инструмента Bash. Принимает путь к бинарному файлу `bash` или `zsh`, например `/opt/homebrew/bin/bash`. Другие оболочки, такие как `fish`, не поддерживаются. Если значение не является рабочим путём `bash` или `zsh`, Claude Code игнорирует его и возвращается к автоматическому обнаружению. Автоматическое обнаружение использует вашу `$SHELL`, когда она указывает на `bash` или `zsh`, в противном случае выбирает первый рабочий `zsh`, затем `bash`, найденный в вашем `PATH` и стандартных местах установки |

285| `CLAUDE_CODE_SHELL_PREFIX` | Префикс команды для обёртывания команд bash, которые порождает Claude Code: вызовы инструмента Bash, команды [hook](/ru/hooks), команды [строки состояния](/ru/statusline) и команды запуска stdio [MCP server](/ru/mcp). Hooks PowerShell и hooks в форме exec выполняются без префикса. Полезно для логирования или аудита. Установка пути к исполняемому файлу, такого как `/path/to/logger.sh`, запускает каждую команду как `/path/to/logger.sh '<command>'`. Обёртка получает командную строку как один аргумент, заключённый в кавычки оболочки в `$1`, поэтому обёртка должна повторно оценить `$1` с помощью оболочки, например `exec bash -c "$1"`. Обработка `$1` как пути к исполняемому файлу нарушает stdio MCP servers, которые передают аргументы, такие как `npx -y <package>`. Для вызовов инструмента Bash `$1` содержит полный вызов оболочки, который собирает Claude Code, включая настройку окружения, а не только команду, которую запустил Claude |285| `CLAUDE_CODE_SHELL_PREFIX` | Префикс команды для обёртывания команд bash, которые порождает Claude Code: вызовы инструмента Bash, команды [hook](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline) и команды запуска stdio [MCP server](/docs/ru/mcp). Hooks PowerShell и hooks в форме exec выполняются без префикса. Полезно для логирования или аудита. Установка пути к исполняемому файлу, такого как `/path/to/logger.sh`, запускает каждую команду как `/path/to/logger.sh '<command>'`. Обёртка получает командную строку как один аргумент, заключённый в кавычки оболочки в `$1`, поэтому обёртка должна повторно оценить `$1` с помощью оболочки, например `exec bash -c "$1"`. Обработка `$1` как пути к исполняемому файлу нарушает stdio MCP servers, которые передают аргументы, такие как `npx -y <package>`. Для вызовов инструмента Bash `$1` содержит полный вызов оболочки, который собирает Claude Code, включая настройку окружения, а не только команду, которую запустил Claude |

286| `CLAUDE_CODE_SIMPLE` | Установите на `1`, чтобы запустить с минимальным системным приглашением и только инструментами Bash, чтения файлов и редактирования файлов. MCP tools из `--mcp-config` по-прежнему доступны. Отключает автоматическое обнаружение hooks, skills, plugins, MCP servers, автоматическую память и CLAUDE.md. OAuth токены и учётные данные цепочки ключей не читаются, поэтому аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалент передачи [`--bare`](/ru/headless#start-faster-with-bare-mode) |286| `CLAUDE_CODE_SIMPLE` | Установите на `1`, чтобы запустить с минимальным системным приглашением и только инструментами Bash, чтения файлов и редактирования файлов. MCP tools из `--mcp-config` по-прежнему доступны. Отключает автоматическое обнаружение hooks, skills, plugins, MCP servers, автоматическую память и CLAUDE.md. OAuth токены и учётные данные цепочки ключей не читаются, поэтому аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалент передачи [`--bare`](/docs/ru/headless#start-faster-with-bare-mode) |

287| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Установите на `1`, чтобы использовать минимальное системное приглашение и свёрнутые описания инструментов на любой модели. Установите на `0`, `false`, `no` или `off`, чтобы отказаться даже на моделях, где эксперимент или конфигурация сервера в противном случае включили бы это. Полный набор инструментов, hooks, MCP servers и обнаружение CLAUDE.md остаются включены |287| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Установите на `1`, чтобы использовать минимальное системное приглашение и свёрнутые описания инструментов на любой модели. Установите на `0`, `false`, `no` или `off`, чтобы отказаться даже на моделях, где эксперимент или конфигурация сервера в противном случае включили бы это. Полный набор инструментов, hooks, MCP servers и обнаружение CLAUDE.md остаются включены |

288| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропустить аутентификацию на стороне клиента для [Claude Platform on AWS](/ru/claude-platform-on-aws), для шлюзов, которые подписывают запросы сами |288| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропустить аутентификацию на стороне клиента для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), для шлюзов, которые подписывают запросы сами |

289| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | {/* min-version: 2.1.207 */}Установите на `1`, чтобы отключить кэш в процессе учётных данных, разрешённых из цепи поставщика учётных данных AWS по умолчанию, поэтому Claude Code разрешает цепь при каждом запросе API. С отключённым кэшем профиль, поддерживаемый SSO, запрашивает учётные данные из IAM Identity Center при каждом запросе. См. [кэширование учётных данных и тайм-аут разрешения](/ru/amazon-bedrock#credential-caching-and-resolution-timeout). Требуется Claude Code v2.1.207 или более поздняя версия |289| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Установите на `1`, чтобы отключить кэш в процессе учётных данных, разрешённых из цепи поставщика учётных данных AWS по умолчанию, поэтому Claude Code разрешает цепь при каждом запросе API. С отключённым кэшем профиль, поддерживаемый SSO, запрашивает учётные данные из IAM Identity Center при каждом запросе. См. [кэширование учётных данных и тайм-аут разрешения](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout). Требуется Claude Code v2.1.207 или более поздняя версия |

290| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock (например, при использовании шлюза LLM) |290| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock (например, при использовании шлюза LLM) |

291| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry, для прокси или шлюза, который внедряет свой собственный заголовок `Authorization`. Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например через `ANTHROPIC_CUSTOM_HEADERS`. Игнорируется, когда установлен `ANTHROPIC_FOUNDRY_API_KEY` или `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. {/* min-version: 2.1.203 */}До v2.1.203 эта переменная оставляла клиент Microsoft Foundry неспособным отправлять запросы, если ключ API также не был установлен |291| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry, для прокси или шлюза, который внедряет свой собственный заголовок `Authorization`. Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например через `ANTHROPIC_CUSTOM_HEADERS`. Игнорируется, когда установлен `ANTHROPIC_FOUNDRY_API_KEY` или `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. До v2.1.203 эта переменная оставляла клиент Microsoft Foundry неспособным отправлять запросы, если ключ API также не был установлен |

292| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании шлюза LLM) |292| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании шлюза LLM) |

293| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите на `1`, чтобы пропустить запись истории приглашений и транскриптов сессий на диск. Сессии, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории стрелок вверх. Полезно для эфемерных скриптовых сессий |293| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите на `1`, чтобы пропустить запись истории приглашений и транскриптов сессий на диск. Сессии, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории стрелок вверх. Полезно для эфемерных скриптовых сессий |

294| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Google Cloud's Agent Platform (например, при использовании шлюза LLM) |294| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Google Cloud's Agent Platform (например, при использовании шлюза LLM) |

295| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Максимальное количество последовательных раз, когда [Stop](/ru/hooks#stop) или [SubagentStop](/ru/hooks#subagentstop) hook может заблокировать завершение хода перед тем, как Claude Code переопределит его и завершит ход в любом случае (по умолчанию: 8). Установите на `0`, чтобы отключить лимит. Повысьте это, если ваш hook законно нуждается в большем количестве итераций для разрешения |295| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Максимальное количество последовательных раз, когда [Stop](/docs/ru/hooks#stop) или [SubagentStop](/docs/ru/hooks#subagentstop) hook может заблокировать завершение хода перед тем, как Claude Code переопределит его и завершит ход в любом случае (по умолчанию: 8). Установите на `0`, чтобы отключить лимит. Повысьте это, если ваш hook законно нуждается в большем количестве итераций для разрешения |

296| `CLAUDE_CODE_SUBAGENT_MODEL` | См. [Конфигурация модели](/ru/model-config). {/* min-version: 2.1.196 */}Начиная с v2.1.196, установка на `inherit` — это то же самое, что оставить её неустановленной; более ранние версии рассматривали `inherit` как переопределение, которое принудительно переводило каждого subagent на модель основного разговора |296| `CLAUDE_CODE_SUBAGENT_MODEL` | См. [Конфигурация модели](/docs/ru/model-config). Начиная с v2.1.196, установка на `inherit` — это то же самое, что оставить её неустановленной; более ранние версии рассматривали `inherit` как переопределение, которое принудительно переводило каждого subagent на модель основного разговора |

297| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите на `1`, чтобы удалить учётные данные Anthropic и поставщика облачных услуг из сред подпроцессов (инструмент Bash, hooks, MCP stdio servers). Родительский процесс Claude сохраняет эти учётные данные для вызовов API, но дочерние процессы не могут их читать, снижая воздействие атак внедрения приглашений, которые пытаются экспортировать секреты через расширение оболочки. На Linux это также запускает подпроцессы Bash в изолированном пространстве имён PID, поэтому они не могут читать сред хост-процессов через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать хост-процессам. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |297| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите на `1`, чтобы удалить учётные данные Anthropic и поставщика облачных услуг из сред подпроцессов (инструмент Bash, hooks, MCP stdio servers). Родительский процесс Claude сохраняет эти учётные данные для вызовов API, но дочерние процессы не могут их читать, снижая воздействие атак внедрения приглашений, которые пытаются экспортировать секреты через расширение оболочки. На Linux это также запускает подпроцессы Bash в изолированном пространстве имён PID, поэтому они не могут читать сред хост-процессов через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать хост-процессам. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |

298| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Установите на `1` в неинтерактивном режиме (флаг `-p`), чтобы дождаться завершения установки plugin перед первым запросом. Без этого plugins устанавливаются в фоне и могут быть недоступны на первом ходу. Объедините с `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`, чтобы ограничить ожидание |298| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Установите на `1` в неинтерактивном режиме (флаг `-p`), чтобы дождаться завершения установки plugin перед первым запросом. Без этого plugins устанавливаются в фоне и могут быть недоступны на первом ходу. Объедините с `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`, чтобы ограничить ожидание |

299| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Тайм-аут в миллисекундах для синхронной установки plugin. При превышении Claude Code продолжает работу без plugins и логирует ошибку. Нет значения по умолчанию: без этой переменной синхронная установка ждёт до завершения |299| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Тайм-аут в миллисекундах для синхронной установки plugin. При превышении Claude Code продолжает работу без plugins и логирует ошибку. Нет значения по умолчанию: без этой переменной синхронная установка ждёт до завершения |

300| `CLAUDE_CODE_SYNC_SKILLS` | Установите на `1`, чтобы загружать ваши включённые claude.ai skills в `~/.claude/skills/` перед первым запросом и повторно синхронизировать каждые 10 минут. Применяется только в неинтерактивном режиме с флагом `-p`. Требуется аутентификация claude.ai. [Claude Code on the web](/ru/claude-code-on-the-web) сессии получают ваши включённые claude.ai skills автоматически; вам не нужно устанавливать это там |300| `CLAUDE_CODE_SYNC_SKILLS` | Установите на `1`, чтобы загружать ваши включённые claude.ai skills в `~/.claude/skills/` перед первым запросом и повторно синхронизировать каждые 10 минут. Применяется только в неинтерактивном режиме с флагом `-p`. Требуется аутентификация claude.ai. [Claude Code on the web](/docs/ru/claude-code-on-the-web) сессии получают ваши включённые claude.ai skills автоматически; вам не нужно устанавливать это там |

301| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Тайм-аут в миллисекундах для повторной синхронизации skills в середине сессии, когда установлен `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 30000). Ограничивает загрузку, запущенную, когда хост запрашивает перезагрузку skill во время сессии. При превышении повторная синхронизация останавливается и оставшиеся загрузки продолжаются в фоне |301| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Тайм-аут в миллисекундах для повторной синхронизации skills в середине сессии, когда установлен `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 30000). Ограничивает загрузку, запущенную, когда хост запрашивает перезагрузку skill во время сессии. При превышении повторная синхронизация останавливается и оставшиеся загрузки продолжаются в фоне |

302| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Тайм-аут в миллисекундах для первого запроса, чтобы дождаться начальной синхронизации skills, когда установлен `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 5000). При превышении запрос продолжает работу и оставшиеся загрузки skills продолжаются в фоне |302| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Тайм-аут в миллисекундах для первого запроса, чтобы дождаться начальной синхронизации skills, когда установлен `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 5000). При превышении запрос продолжает работу и оставшиеся загрузки skills продолжаются в фоне |

303| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Установите на `false`, чтобы отключить подсветку синтаксиса в выводе diff. Полезно, когда цвета мешают вашей настройке терминала. Чтобы также отключить подсветку в блоках кода и предпросмотрах файлов, используйте параметр [`syntaxHighlightingDisabled`](/ru/settings) |303| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Установите на `false`, чтобы отключить подсветку синтаксиса в выводе diff. Полезно, когда цвета мешают вашей настройке терминала. Чтобы также отключить подсветку в блоках кода и предпросмотрах файлов, используйте параметр [`syntaxHighlightingDisabled`](/docs/ru/settings) |

304| `CLAUDE_CODE_TASK_LIST_ID` | Поделитесь списком задач между сессиями. Установите один и тот же ID в нескольких экземплярах Claude Code для координации общего списка задач. См. [Список задач](/ru/interactive-mode#task-list) |304| `CLAUDE_CODE_TASK_LIST_ID` | Поделитесь списком задач между сессиями. Установите один и тот же ID в нескольких экземплярах Claude Code для координации общего списка задач. См. [Список задач](/docs/ru/interactive-mode#task-list) |

305| `CLAUDE_CODE_TEAM_NAME` | Имя команды агентов, к которой принадлежит этот товарищ. Установите автоматически на членах [команды агентов](/ru/agent-teams) |305| `CLAUDE_CODE_TEAM_NAME` | Имя команды агентов, к которой принадлежит этот товарищ. Установите автоматически на членах [команды агентов](/docs/ru/agent-teams) |

306| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | {/* min-version: 2.1.206 */}Переопределить, в миллисекундах, как долго неинтерактивная сессия ждёт при выходе, чтобы её [команда агентов](/ru/agent-teams) завершила разборку. Принимает 1000 до 60000; значение вне диапазона игнорируется и применяется значение по умолчанию 10000. Требуется Claude Code v2.1.206 или более поздняя версия |306| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Переопределить, в миллисекундах, как долго неинтерактивная сессия ждёт при выходе, чтобы её [команда агентов](/docs/ru/agent-teams) завершила разборку. Принимает 1000 до 60000; значение вне диапазона игнорируется и применяется значение по умолчанию 10000. Требуется Claude Code v2.1.206 или более поздняя версия |

307| `CLAUDE_CODE_TMPDIR` | Переопределить временный каталог, используемый для внутренних временных файлов. Claude Code добавляет `/claude-{uid}/` на Unix или `/claude/` на Windows к этому пути. По умолчанию: `/tmp` на macOS, `os.tmpdir()` на Linux и Windows. {/* min-version: 2.1.161 */}Начиная с v2.1.161, на macOS и Linux [изолированные](/ru/sandboxing) подпроцессы Bash получают короткий резервный `$TMPDIR` в системном стандарте, когда ваше переопределение — это длинный путь, так как некоторые инструменты не работают, когда пути временных файлов становятся слишком длинными. Неизолированные команды Bash наследуют `$TMPDIR` вашей оболочки без изменений. Собственные временные файлы Claude Code всегда используют ваше переопределение |307| `CLAUDE_CODE_TMPDIR` | Переопределить временный каталог, используемый для внутренних временных файлов. Claude Code добавляет `/claude-{uid}/` на Unix или `/claude/` на Windows к этому пути. По умолчанию: `/tmp` на macOS, `os.tmpdir()` на Linux и Windows. Начиная с v2.1.161, на macOS и Linux [изолированные](/docs/ru/sandboxing) подпроцессы Bash получают короткий резервный `$TMPDIR` в системном стандарте, когда ваше переопределение — это длинный путь, так как некоторые инструменты не работают, когда пути временных файлов становятся слишком длинными. Неизолированные команды Bash наследуют `$TMPDIR` вашей оболочки без изменений. Собственные временные файлы Claude Code всегда используют ваше переопределение |

308| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите на `1`, чтобы разрешить вывод 24-битного truecolor внутри tmux. По умолчанию Claude Code ограничивает 256 цветами, когда установлена `$TMUX`, потому что tmux не пропускает последовательности выхода truecolor, если не настроен. Установите это после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. См. [Конфигурация терминала](/ru/terminal-config) для других параметров tmux |308| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите на `1`, чтобы разрешить вывод 24-битного truecolor внутри tmux. По умолчанию Claude Code ограничивает 256 цветами, когда установлена `$TMUX`, потому что tmux не пропускает последовательности выхода truecolor, если не настроен. Установите это после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. См. [Конфигурация терминала](/docs/ru/terminal-config) для других параметров tmux |

309| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Использовать [Claude Platform on AWS](/ru/claude-platform-on-aws) |309| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Использовать [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) |

310| `CLAUDE_CODE_USE_BEDROCK` | Использовать [Amazon Bedrock](/ru/amazon-bedrock) |310| `CLAUDE_CODE_USE_BEDROCK` | Использовать [Amazon Bedrock](/docs/ru/amazon-bedrock) |

311| `CLAUDE_CODE_USE_FOUNDRY` | Использовать [Microsoft Foundry](/ru/microsoft-foundry) |311| `CLAUDE_CODE_USE_FOUNDRY` | Использовать [Microsoft Foundry](/docs/ru/microsoft-foundry) |

312| `CLAUDE_CODE_USE_MANTLE` | Использовать конечную точку Amazon Bedrock [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) |312| `CLAUDE_CODE_USE_MANTLE` | Использовать конечную точку Amazon Bedrock [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) |

313| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите на `1`, чтобы обнаруживать пользовательские команды, subagents и стили вывода, используя API файлов Node.js вместо ripgrep. Установите это, если встроенный бинарный файл ripgrep недоступен или заблокирован в вашей среде. Не влияет на инструменты Grep или поиск файлов |313| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите на `1`, чтобы обнаруживать пользовательские команды, subagents и стили вывода, используя API файлов Node.js вместо ripgrep. Установите это, если встроенный бинарный файл ripgrep недоступен или заблокирован в вашей среде. Не влияет на инструменты Grep или поиск файлов |

314| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Управляет инструментом PowerShell. На Windows без Git Bash инструмент включен автоматически; установите на `0`, чтобы отключить его. На Windows с установленным Git Bash инструмент постепенно развёртывается: установите на `1`, чтобы согласиться, или на `0`, чтобы отказаться. На Linux, macOS и WSL установите на `1`, чтобы включить его, что требует `pwsh` в вашем `PATH`. При включении на Windows Claude может запускать команды PowerShell изначально вместо маршрутизации через Git Bash. См. [Инструмент PowerShell](/ru/tools-reference#powershell-tool) |314| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Управляет инструментом PowerShell. На Windows без Git Bash инструмент включен автоматически; установите на `0`, чтобы отключить его. На Windows с установленным Git Bash инструмент постепенно развёртывается: установите на `1`, чтобы согласиться, или на `0`, чтобы отказаться. На Linux, macOS и WSL установите на `1`, чтобы включить его, что требует `pwsh` в вашем `PATH`. При включении на Windows Claude может запускать команды PowerShell изначально вместо маршрутизации через Git Bash. См. [Инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) |

315| `CLAUDE_CODE_USE_VERTEX` | Использовать [Google Cloud's Agent Platform](/ru/google-vertex-ai) |315| `CLAUDE_CODE_USE_VERTEX` | Использовать [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |

316| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, учётные данные, история сессии и plugins хранятся под этим путём. Полезно для запуска нескольких учётных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |316| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, учётные данные, история сессии и plugins хранятся под этим путём. Полезно для запуска нескольких учётных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

317| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}Установите на `1`, чтобы остановить выполняющуюся фоновую работу вместо её переноса при фоновом выполнении сессии нажатием `←` или с помощью [`/background`](/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые в противном случае переносились бы. Требуется Claude Code v2.1.195 или более поздняя версия |317| `CLAUDE_DISABLE_ADOPT` | Установите на `1`, чтобы остановить выполняющуюся фоновую работу вместо её переноса при фоновом выполнении сессии нажатием `←` или с помощью [`/background`](/docs/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые в противном случае переносились бы. Требуется Claude Code v2.1.195 или более поздняя версия |

318| `CLAUDE_EFFORT` | Установите автоматически в подпроцессах инструмента Bash и командах hook на активный [уровень усилий](/ru/model-config#adjust-effort-level) для хода: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Совпадает с полем `effort.level`, переданным в [hooks](/ru/hooks). Установлено только, когда текущая модель поддерживает параметр усилий |318| `CLAUDE_EFFORT` | Установите автоматически в подпроцессах инструмента Bash и командах hook на активный [уровень усилий](/docs/ru/model-config#adjust-effort-level) для хода: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Совпадает с полем `effort.level`, переданным в [hooks](/docs/ru/hooks). Установлено только, когда текущая модель поддерживает параметр усилий |

319| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя на уровне байтов, или установите на `0`, чтобы принудительно отключить его. Когда не установлено, сторож включен по умолчанию для соединений Anthropic API и [Claude Platform on AWS](/ru/claude-platform-on-aws). Сторож байтов прерывает соединение, когда на проводе не поступают байты в течение 180 секунд по умолчанию на соединениях прямого Anthropic API, 300 секунд на Claude Platform on AWS и когда включен на Amazon Bedrock, или для значения `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, когда это установлено, которое ограничено минимумом 5 минут, независимо от сторожа на уровне событий |319| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя на уровне байтов, или установите на `0`, чтобы принудительно отключить его. Когда не установлено, сторож включен по умолчанию для соединений Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Сторож байтов прерывает соединение, когда на проводе не поступают байты в течение 180 секунд по умолчанию на соединениях прямого Anthropic API, 300 секунд на Claude Platform on AWS и когда включен на Amazon Bedrock, или для значения `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, когда это установлено, которое ограничено минимумом 5 минут, независимо от сторожа на уровне событий |

320| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите на `1`, чтобы включить сторож простоя на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`. Отключено по умолчанию. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |320| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите на `1`, чтобы включить сторож простоя на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`. Отключено по умолчанию. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

321| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя потока на уровне событий, или установите на `0`, чтобы принудительно отключить его. {/* min-version: 2.1.196 */}Когда не установлено, сторож включен по умолчанию для всех поставщиков. До v2.1.196 неустановленное значение по умолчанию было контролируемым сервером на прямом Anthropic API и отключено на других поставщиках. {/* min-version: 2.1.169 */}Начиная с v2.1.169, поставщики, отличные от прямого Anthropic API и Claude Platform on AWS, также имеют тайм-аут простоя тела в 5 минут по умолчанию, независимый от этой переменной; см. `API_FORCE_IDLE_TIMEOUT`. На Amazon Bedrock вы также можете включить независимый сторож на уровне байтов с помощью `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; оба работают вместе, когда оба установлены. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |321| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторож простоя потока на уровне событий, или установите на `0`, чтобы принудительно отключить его. Когда не установлено, сторож включен по умолчанию для всех поставщиков. До v2.1.196 неустановленное значение по умолчанию было контролируемым сервером на прямом Anthropic API и отключено на других поставщиках. Начиная с v2.1.169, поставщики, отличные от прямого Anthropic API и Claude Platform on AWS, также имеют тайм-аут простоя тела в 5 минут по умолчанию, независимый от этой переменной; см. `API_FORCE_IDLE_TIMEOUT`. На Amazon Bedrock вы также можете включить независимый сторож на уровне байтов с помощью `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; оба работают вместе, когда оба установлены. Настройте тайм-аут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

322| `CLAUDE_ENV_FILE` | Путь к скрипту оболочки, содержимое которого Claude Code запускает перед каждой командой Bash в том же процессе оболочки, поэтому экспорты в файле видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также динамически заполняется [SessionStart](/ru/hooks#persist-environment-variables), [Setup](/ru/hooks#setup), [CwdChanged](/ru/hooks#cwdchanged) и [FileChanged](/ru/hooks#filechanged) hooks |322| `CLAUDE_ENV_FILE` | Путь к скрипту оболочки, содержимое которого Claude Code запускает перед каждой командой Bash в том же процессе оболочки, поэтому экспорты в файле видны команде. Используйте для сохранения активации virtualenv или conda между командами. Также динамически заполняется [SessionStart](/docs/ru/hooks#persist-environment-variables), [Setup](/docs/ru/hooks#setup), [CwdChanged](/docs/ru/hooks#cwdchanged) и [FileChanged](/docs/ru/hooks#filechanged) hooks |

323| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически сгенерированных имён сессий [Remote Control](/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |323| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически сгенерированных имён сессий [Remote Control](/docs/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |

324| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Тайм-аут в миллисекундах перед тем, как сторож простоя потока закроет зависшее соединение. Когда вы устанавливаете эту переменную явно, минимум составляет `300000` (5 минут); более низкие значения молча ограничиваются, чтобы поглотить паузы расширенного мышления и буферизацию прокси. Когда не установлено, сторож на уровне событий по умолчанию составляет 300 секунд, а сторож на уровне байтов по умолчанию составляет 180 секунд на соединениях прямого Anthropic API (300 секунд на Claude Platform on AWS и других поставщиках). Неустановленное значение по умолчанию сторожа на уровне байтов в 180 секунд — это отдельное значение и не подлежит ограничению в 5 минут. Тайм-аут простоя тела, описанный в `API_FORCE_IDLE_TIMEOUT`, применяется независимо. На Amazon Bedrock также применяется, когда `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |324| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Тайм-аут в миллисекундах перед тем, как сторож простоя потока закроет зависшее соединение. Когда вы устанавливаете эту переменную явно, минимум составляет `300000` (5 минут); более низкие значения молча ограничиваются, чтобы поглотить паузы расширенного мышления и буферизацию прокси. Когда не установлено, сторож на уровне событий по умолчанию составляет 300 секунд, а сторож на уровне байтов по умолчанию составляет 180 секунд на соединениях прямого Anthropic API (300 секунд на Claude Platform on AWS и других поставщиках). Неустановленное значение по умолчанию сторожа на уровне байтов в 180 секунд — это отдельное значение и не подлежит ограничению в 5 минут. Тайм-аут простоя тела, описанный в `API_FORCE_IDLE_TIMEOUT`, применяется независимо. На Amazon Bedrock также применяется, когда `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

325| `DEBUG` | Установите на `1`, чтобы включить режим отладки, эквивалент запуска с [`--debug`](/ru/cli-reference#cli-flags). Журналы отладки записываются в `~/.claude/debug/<session-id>.txt`, или в путь, установленный `CLAUDE_CODE_DEBUG_LOGS_DIR`. Только истинные значения `1`, `true`, `yes` и `on` включают режим отладки, поэтому шаблоны пространства имён, такие как `DEBUG=express:*`, установленные для других инструментов, не запускают его |325| `DEBUG` | Установите на `1`, чтобы включить режим отладки, эквивалент запуска с [`--debug`](/docs/ru/cli-reference#cli-flags). Журналы отладки записываются в `~/.claude/debug/<session-id>.txt`, или в путь, установленный `CLAUDE_CODE_DEBUG_LOGS_DIR`. Только истинные значения `1`, `true`, `yes` и `on` включают режим отладки, поэтому шаблоны пространства имён, такие как `DEBUG=express:*`, установленные для других инструментов, не запускают его |

326| `DISABLE_AUTOUPDATER` | Установите на `1`, чтобы отключить автоматические обновления в фоне. Ручная команда `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES`, чтобы заблокировать оба |326| `DISABLE_AUTOUPDATER` | Установите на `1`, чтобы отключить автоматические обновления в фоне. Ручная команда `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES`, чтобы заблокировать оба |

327| `DISABLE_AUTO_COMPACT` | Установите на `1`, чтобы отключить автоматическое сжатие при приближении к лимиту контекста. Команда `/compact` остаётся доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит сжатие |327| `DISABLE_AUTO_COMPACT` | Установите на `1`, чтобы отключить автоматическое сжатие при приближении к лимиту контекста. Команда `/compact` остаётся доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит сжатие |

328| `DISABLE_COMPACT` | Установите на `1`, чтобы отключить все сжатие: как автоматическое сжатие, так и команду `/compact` |328| `DISABLE_COMPACT` | Установите на `1`, чтобы отключить все сжатие: как автоматическое сжатие, так и команду `/compact` |

329| `DISABLE_COST_WARNINGS` | Установите на `1`, чтобы отключить сообщения предупреждения о стоимости |329| `DISABLE_COST_WARNINGS` | Установите на `1`, чтобы отключить сообщения предупреждения о стоимости |

330| `DISABLE_DOCTOR_COMMAND` | Установите на `1`, чтобы скрыть команду `/doctor`. Полезно для управляемых развёртываний, где пользователи не должны запускать диагностику установки. Не влияет на команду терминала `claude doctor`. {/* min-version: 2.1.205 */}До v2.1.205 эта переменная скрывала экран диагностики `/doctor` |330| `DISABLE_DOCTOR_COMMAND` | Установите на `1`, чтобы скрыть команду `/doctor`. Полезно для управляемых развёртываний, где пользователи не должны запускать диагностику установки. Не влияет на команду терминала `claude doctor`. До v2.1.205 эта переменная скрывала экран диагностики `/doctor` |

331| `DISABLE_ERROR_REPORTING` | Установите на `1`, чтобы отказаться от отчётов об ошибках |331| `DISABLE_ERROR_REPORTING` | Установите на `1`, чтобы отказаться от отчётов об ошибках |

332| `DISABLE_EXTRA_USAGE_COMMAND` | Установите на `1`, чтобы скрыть команду `/usage-credits`, которая позволяет пользователям приобретать дополнительное использование сверх лимитов скорости |332| `DISABLE_EXTRA_USAGE_COMMAND` | Установите на `1`, чтобы скрыть команду `/usage-credits`, которая позволяет пользователям приобретать дополнительное использование сверх лимитов скорости |

333| `DISABLE_FEEDBACK_COMMAND` | Установите на `1`, чтобы отключить команду `/feedback`. Также принимается старое имя `DISABLE_BUG_COMMAND` |333| `DISABLE_FEEDBACK_COMMAND` | Установите на `1`, чтобы отключить команду `/feedback`. Также принимается старое имя `DISABLE_BUG_COMMAND` |


337| `DISABLE_INTERLEAVED_THINKING` | Установите на `1`, чтобы предотвратить отправку заголовка beta interleaved-thinking. Полезно, когда ваш шлюз LLM или поставщик не поддерживает [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |337| `DISABLE_INTERLEAVED_THINKING` | Установите на `1`, чтобы предотвратить отправку заголовка beta interleaved-thinking. Полезно, когда ваш шлюз LLM или поставщик не поддерживает [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

338| `DISABLE_LOGIN_COMMAND` | Установите на `1`, чтобы скрыть команду `/login`. Полезно, когда аутентификация обрабатывается внешне через ключи API или `apiKeyHelper` |338| `DISABLE_LOGIN_COMMAND` | Установите на `1`, чтобы скрыть команду `/login`. Полезно, когда аутентификация обрабатывается внешне через ключи API или `apiKeyHelper` |

339| `DISABLE_LOGOUT_COMMAND` | Установите на `1`, чтобы скрыть команду `/logout` |339| `DISABLE_LOGOUT_COMMAND` | Установите на `1`, чтобы скрыть команду `/logout` |

340| `DISABLE_PROMPT_CACHING` | Установите на `1`, чтобы отключить [кэширование приглашений](/ru/prompt-caching#disable-prompt-caching) для всех моделей (имеет приоритет над параметрами для отдельных моделей) |340| `DISABLE_PROMPT_CACHING` | Установите на `1`, чтобы отключить [кэширование приглашений](/docs/ru/prompt-caching#disable-prompt-caching) для всех моделей (имеет приоритет над параметрами для отдельных моделей) |

341| `DISABLE_PROMPT_CACHING_FABLE` | Установите на `1`, чтобы отключить кэширование приглашений для моделей Fable |341| `DISABLE_PROMPT_CACHING_FABLE` | Установите на `1`, чтобы отключить кэширование приглашений для моделей Fable |

342| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1`, чтобы отключить кэширование приглашений для моделей Haiku |342| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1`, чтобы отключить кэширование приглашений для моделей Haiku |

343| `DISABLE_PROMPT_CACHING_OPUS` | Установите на `1`, чтобы отключить кэширование приглашений для моделей Opus |343| `DISABLE_PROMPT_CACHING_OPUS` | Установите на `1`, чтобы отключить кэширование приглашений для моделей Opus |


346| `DISABLE_UPDATES` | Установите на `1`, чтобы заблокировать все обновления, включая ручную команду `claude update` и `claude install`. Более строгий, чем `DISABLE_AUTOUPDATER`. Используйте при распространении Claude Code через ваши собственные каналы и пользователи не должны самостоятельно обновляться |346| `DISABLE_UPDATES` | Установите на `1`, чтобы заблокировать все обновления, включая ручную команду `claude update` и `claude install`. Более строгий, чем `DISABLE_AUTOUPDATER`. Используйте при распространении Claude Code через ваши собственные каналы и пользователи не должны самостоятельно обновляться |

347| `DISABLE_UPGRADE_COMMAND` | Установите на `1`, чтобы скрыть команду `/upgrade` |347| `DISABLE_UPGRADE_COMMAND` | Установите на `1`, чтобы скрыть команду `/upgrade` |

348| `DO_NOT_TRACK` | Установите на `1`, чтобы отказаться от телеметрии. Эквивалент установки `DISABLE_TELEMETRY`. Claude Code признаёт это как кроссплатформенное соглашение, признанное многими инструментами разработчика |348| `DO_NOT_TRACK` | Установите на `1`, чтобы отказаться от телеметрии. Эквивалент установки `DISABLE_TELEMETRY`. Claude Code признаёт это как кроссплатформенное соглашение, признанное многими инструментами разработчика |

349| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите на `false`, чтобы отключить [MCP servers claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) в Claude Code. Включено по умолчанию для вошедших в систему пользователей. Чтобы отключить для каждого проекта или организации, установите [`disableClaudeAiConnectors`](/ru/settings#available-settings) в параметрах вместо этого |349| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите на `false`, чтобы отключить [MCP servers claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) в Claude Code. Включено по умолчанию для вошедших в систему пользователей. Чтобы отключить для каждого проекта или организации, установите [`disableClaudeAiConnectors`](/docs/ru/settings#available-settings) в параметрах вместо этого |

350| `ENABLE_PROMPT_CACHING_1H` | Установите на `1`, чтобы запросить TTL кэша приглашений в 1 час вместо стандартных 5 минут. Предназначено для пользователей ключа API, [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) и [Claude Platform on AWS](/ru/claude-platform-on-aws). Пользователи подписки получают TTL в 1 час автомат ически. Записи кэша в 1 час выставляются по более высокой ставке |350| `ENABLE_PROMPT_CACHING_1H` | Установите на `1`, чтобы запросить TTL кэша приглашений в 1 час вместо стандартных 5 минут. Предназначено для пользователей ключа API, [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Пользователи подписки получают TTL в 1 час автомат ически. Записи кэша в 1 час выставляются по более высокой ставке |

351| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |351| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |

352| `ENABLE_TOOL_SEARCH` | Управляет [поиском инструментов MCP](/ru/mcp#scale-with-mcp-tool-search). Не установлено: все инструменты MCP отложены по умолчанию, но загружены заранее на Google Cloud's Agent Platform или когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся хостом первой стороны. Значения: `true` (всегда откладывать и отправлять заголовок beta, запросы не удаются на моделях Google Cloud's Agent Platform ранее Sonnet 4.5 или Opus 4.5, или на прокси, которые не поддерживают `tool_reference`), `auto` (режим порога: загружать заранее, если инструменты подходят в пределах 10% контекста), `auto:N` (пользовательский порог, например, `auto:5` для 5%), `false` (загружать все заранее). Игнорируется, когда установлен `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`, который принудительно загружает все инструменты заранее |352| `ENABLE_TOOL_SEARCH` | Управляет [поиском инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search). Не установлено: все инструменты MCP отложены по умолчанию, но загружены заранее на Google Cloud's Agent Platform или когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся хостом первой стороны. Значения: `true` (всегда откладывать и отправлять заголовок beta, запросы не удаются на моделях Google Cloud's Agent Platform ранее Sonnet 4.5 или Opus 4.5, или на прокси, которые не поддерживают `tool_reference`), `auto` (режим порога: загружать заранее, если инструменты подходят в пределах 10% контекста), `auto:N` (пользовательский порог, например, `auto:5` для 5%), `false` (загружать все заранее). Игнорируется, когда установлен `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`, который принудительно загружает все инструменты заранее |

353| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, чтобы все модели, а не только Opus, перестали повторять попытки с повторной ошибкой перегрузки, когда резервная модель не настроена. {/* min-version: 2.1.160 */}Начиная с v2.1.160, настроенная [цепь резервных моделей](/ru/model-config#fallback-model-chains) срабатывает при повторных ошибках перегрузки для любой основной модели, поэтому эта переменная не влияет на переключение на резервную модель |353| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, чтобы все модели, а не только Opus, перестали повторять попытки с повторной ошибкой перегрузки, когда резервная модель не настроена. Начиная с v2.1.160, настроенная [цепь резервных моделей](/docs/ru/model-config#fallback-model-chains) срабатывает при повторных ошибках перегрузки для любой основной модели, поэтому эта переменная не влияет на переключение на резервную модель |

354| `FORCE_AUTOUPDATE_PLUGINS` | Установите на `1`, чтобы принудительно обновлять plugins автоматически, даже если основной автоматический обновитель отключен через `DISABLE_AUTOUPDATER` |354| `FORCE_AUTOUPDATE_PLUGINS` | Установите на `1`, чтобы принудительно обновлять plugins автоматически, даже если основной автоматический обновитель отключен через `DISABLE_AUTOUPDATER` |

355| `FORCE_HYPERLINK` | Установите на `1`, чтобы включить кликабельные гиперссылки OSC 8, когда ваш терминал их поддерживает, но не автоматически обнаруживается, или `0`, чтобы отключить их |355| `FORCE_HYPERLINK` | Установите на `1`, чтобы включить кликабельные гиперссылки OSC 8, когда ваш терминал их поддерживает, но не автоматически обнаруживается, или `0`, чтобы отключить их |

356| `FORCE_PROMPT_CACHING_5M` | Установите на `1`, чтобы принудительно использовать TTL кэша приглашений в 5 минут, даже когда в противном случае применялся бы TTL в 1 час. Переопределяет `ENABLE_PROMPT_CACHING_1H` |356| `FORCE_PROMPT_CACHING_5M` | Установите на `1`, чтобы принудительно использовать TTL кэша приглашений в 5 минут, даже когда в противном случае применялся бы TTL в 1 час. Переопределяет `ENABLE_PROMPT_CACHING_1H` |

357| `HTTP_PROXY` | Укажите HTTP прокси-сервер для сетевых соединений |357| `HTTP_PROXY` | Укажите HTTP прокси-сервер для сетевых соединений |

358| `HTTPS_PROXY` | Укажите HTTPS прокси-сервер для сетевых соединений |358| `HTTPS_PROXY` | Укажите HTTPS прокси-сервер для сетевых соединений |

359| `IS_DEMO` | Установите на `1`, чтобы включить режим демонстрации: скрывает вашу электронную почту и имя организации из заголовка и вывода `/status`, и пропускает адаптацию. Полезно при потоковой передаче или записи сессии |359| `IS_DEMO` | Установите на `1`, чтобы включить режим демонстрации: скрывает вашу электронную почту и имя организации из заголовка и вывода `/status`, и пропускает адаптацию. Полезно при потоковой передаче или записи сессии |

360| `MAX_MCP_OUTPUT_TOKENS` | Максимальное количество токенов, разрешённых в ответах инструментов MCP. Claude Code отображает предупреждение, когда вывод превышает 10 000 токенов. Инструменты, которые объявляют [`anthropic/maxResultSizeChars`](/ru/mcp#raise-the-limit-for-a-specific-tool), используют это ограничение символов для текстового содержимого вместо этого, но содержимое изображения из этих инструментов по-прежнему подлежит этой переменной (по умолчанию: 25000) |360| `MAX_MCP_OUTPUT_TOKENS` | Максимальное количество токенов, разрешённых в ответах инструментов MCP. Claude Code отображает предупреждение, когда вывод превышает 10 000 токенов. Инструменты, которые объявляют [`anthropic/maxResultSizeChars`](/docs/ru/mcp#raise-the-limit-for-a-specific-tool), используют это ограничение символов для текстового содержимого вместо этого, но содержимое изображения из этих инструментов по-прежнему подлежит этой переменной (по умолчанию: 25000) |

361| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток повтора, когда ответ модели не проходит проверку по [`--json-schema`](/ru/cli-reference#cli-flags) в неинтерактивном режиме (флаг `-p`). По умолчанию 5 |361| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток повтора, когда ответ модели не проходит проверку по [`--json-schema`](/docs/ru/cli-reference#cli-flags) в неинтерактивном режиме (флаг `-p`). По умолчанию 5 |

362| `MAX_THINKING_TOKENS` | Переопределить бюджет токенов [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Потолок — это [максимальное количество выходных токенов](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) модели минус один. Установите на `0`, чтобы отключить мышление на Anthropic API, кроме Fable 5, которое не может отключить мышление. На [сторонних поставщиках](/ru/third-party-integrations), `0` аналогично опускает параметр, и модели с [адаптивным рассуждением](/ru/model-config#adjust-effort-level) могут всё ещё думать. Для ненулевых значений на моделях адаптивного рассуждения бюджет игнорируется, если адаптивное рассуждение не отключено через `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |362| `MAX_THINKING_TOKENS` | Переопределить бюджет токенов [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Потолок — это [максимальное количество выходных токенов](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) модели минус один. Установите на `0`, чтобы отключить мышление на Anthropic API, кроме Fable 5, которое не может отключить мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations), `0` аналогично опускает параметр, и модели с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) могут всё ещё думать. Для ненулевых значений на моделях адаптивного рассуждения бюджет игнорируется, если адаптивное рассуждение не отключено через `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |

363| `MCP_CLIENT_SECRET` | Секрет клиента OAuth для MCP servers, которые требуют [предварительно настроенные учётные данные](/ru/mcp#use-pre-configured-oauth-credentials). Избегает интерактивного приглашения при добавлении сервера с `--client-secret` |363| `MCP_CLIENT_SECRET` | Секрет клиента OAuth для MCP servers, которые требуют [предварительно настроенные учётные данные](/docs/ru/mcp#use-pre-configured-oauth-credentials). Избегает интерактивного приглашения при добавлении сервера с `--client-secret` |

364| `MCP_CONNECTION_NONBLOCKING` | Управляет тем, ждёт ли запуск подключения MCP servers перед первым запросом. {/* min-version: 2.1.142 */}Начиная с Claude Code v2.1.142, запуск MCP является неблокирующим по умолчанию: серверы подключаются в фоне и их инструменты становятся доступными по мере завершения. Установите на `0`, чтобы восстановить блокирующее ожидание в 5 секунд. Серверы, настроенные с [`alwaysLoad: true`](/ru/mcp#exempt-a-server-from-deferral), всегда блокируют запуск независимо, так как их инструменты должны присутствовать при построении первого приглашения |364| `MCP_CONNECTION_NONBLOCKING` | Управляет тем, ждёт ли запуск подключения MCP servers перед первым запросом. Начиная с Claude Code v2.1.142, запуск MCP является неблокирующим по умолчанию: серверы подключаются в фоне и их инструменты становятся доступными по мере завершения. Установите на `0`, чтобы восстановить блокирующее ожидание в 5 секунд. Серверы, настроенные с [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral), всегда блокируют запуск независимо, так как их инструменты должны присутствовать при построении первого приглашения |

365| `MCP_CONNECT_TIMEOUT_MS` | Как долго блокирующий запуск MCP ждёт, в миллисекундах, для пакета подключения перед снимком списка инструментов (по умолчанию: 5000). Применяется, когда `MCP_CONNECTION_NONBLOCKING=0` или для серверов, отмеченных [`alwaysLoad: true`](/ru/mcp#exempt-a-server-from-deferral). Серверы, всё ещё ожидающие на крайнем сроке, продолжают подключаться в фоне, но не будут видны до следующего запроса. Отличается от `MCP_TIMEOUT`, который ограничивает попытку подключения отдельного сервера |365| `MCP_CONNECT_TIMEOUT_MS` | Как долго блокирующий запуск MCP ждёт, в миллисекундах, для пакета подключения перед снимком списка инструментов (по умолчанию: 5000). Применяется, когда `MCP_CONNECTION_NONBLOCKING=0` или для серверов, отмеченных [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral). Серверы, всё ещё ожидающие на крайнем сроке, продолжают подключаться в фоне, но не будут видны до следующего запроса. Отличается от `MCP_TIMEOUT`, который ограничивает попытку подключения отдельного сервера |

366| `MCP_OAUTH_CALLBACK_PORT` | Фиксированный порт для обратного вызова перенаправления OAuth, как альтернатива `--callback-port` при добавлении MCP server с [предварительно настроенными учётными данными](/ru/mcp#use-pre-configured-oauth-credentials) |366| `MCP_OAUTH_CALLBACK_PORT` | Фиксированный порт для обратного вызова перенаправления OAuth, как альтернатива `--callback-port` при добавлении MCP server с [предварительно настроенными учётными данными](/docs/ru/mcp#use-pre-configured-oauth-credentials) |

367| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удалённых MCP servers (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |367| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удалённых MCP servers (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |

368| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP servers (stdio) для подключения параллельно при запуске (по умолчанию: 3) |368| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP servers (stdio) для подключения параллельно при запуске (по умолчанию: 3) |

369| `MCP_TIMEOUT` | Тайм-аут в миллисекундах для запуска MCP server (по умолчанию: 30000, или 30 секунд) |369| `MCP_TIMEOUT` | Тайм-аут в миллисекундах для запуска MCP server (по умолчанию: 30000, или 30 секунд) |

370| `MCP_TOOL_TIMEOUT` | Тайм-аут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, примерно 28 часов). Для HTTP, SSE или claude.ai connector сервера каждый запрос также истекает через 60 секунд по умолчанию; установите эту переменную или поле `timeout` для каждого сервера выше 60000, чтобы повысить этот лимит для каждого запроса. Более низкое значение по-прежнему сокращает общий тайм-аут выполнения инструмента, но оставляет лимит для каждого запроса на 60 секунд. Stdio и WebSocket серверы не имеют таймера для каждого запроса. Поле `timeout` для каждого сервера в `.mcp.json` переопределяет это для этого сервера. {/* min-version: 2.1.203 */}Поле `timeout` для каждого сервера не менее 1000 также устанавливает минимальное окно неактивности для вызовов инструментов этого сервера, поэтому `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` никогда не прерывает их раньше; этот пол требует Claude Code v2.1.203 или более поздней версии. Для переменной окружения значения ниже 1000 ограничиваются одной секундой; для поля для каждого сервера значения ниже 1000 игнорируются |370| `MCP_TOOL_TIMEOUT` | Тайм-аут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, примерно 28 часов). Для HTTP, SSE или claude.ai connector сервера каждый запрос также истекает через 60 секунд по умолчанию; установите эту переменную или поле `timeout` для каждого сервера выше 60000, чтобы повысить этот лимит для каждого запроса. Более низкое значение по-прежнему сокращает общий тайм-аут выполнения инструмента, но оставляет лимит для каждого запроса на 60 секунд. Stdio и WebSocket серверы не имеют таймера для каждого запроса. Поле `timeout` для каждого сервера в `.mcp.json` переопределяет это для этого сервера. Поле `timeout` для каждого сервера не менее 1000 также устанавливает минимальное окно неактивности для вызовов инструментов этого сервера, поэтому `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` никогда не прерывает их раньше; этот пол требует Claude Code v2.1.203 или более поздней версии. Для переменной окружения значения ниже 1000 ограничиваются одной секундой; для поля для каждого сервера значения ниже 1000 игнорируются |

371| `NO_PROXY` | Список доменов и IP-адресов, на которые запросы будут отправляться напрямую, обходя прокси |371| `NO_PROXY` | Список доменов и IP-адресов, на которые запросы будут отправляться напрямую, обходя прокси |

372| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}Установите на `1`, чтобы включить текст ответа модели на события логирования OpenTelemetry `assistant_response`. Когда не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите на `0`, чтобы сохранить ответы скрытыми, даже когда установлен `OTEL_LOG_USER_PROMPTS`. Требуется Claude Code v2.1.193 или более поздняя версия. См. [Мониторинг](/ru/monitoring-usage#assistant-response-event) |372| `OTEL_LOG_ASSISTANT_RESPONSES` | Установите на `1`, чтобы включить текст ответа модели на события логирования OpenTelemetry `assistant_response`. Когда не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите на `0`, чтобы сохранить ответы скрытыми, даже когда установлен `OTEL_LOG_USER_PROMPTS`. Требуется Claude Code v2.1.193 или более поздняя версия. См. [Мониторинг](/docs/ru/monitoring-usage#assistant-response-event) |

373| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа Anthropic Messages API как события логирования `api_request_body` / `api_response_body`. Установите на `1` для встроенных тел, усечённых на 60 КБ, или `file:<dir>` для записи неусечённых тел на диск и выдачи пути `body_ref` вместо этого. Отключено по умолчанию; тела включают всю историю разговора. См. [Мониторинг](/ru/monitoring-usage#api-request-body-event) |373| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа Anthropic Messages API как события логирования `api_request_body` / `api_response_body`. Установите на `1` для встроенных тел, усечённых на 60 КБ, или `file:<dir>` для записи неусечённых тел на диск и выдачи пути `body_ref` вместо этого. Отключено по умолчанию; тела включают всю историю разговора. См. [Мониторинг](/docs/ru/monitoring-usage#api-request-body-event) |

374| `OTEL_LOG_TOOL_CONTENT` | Установите на `1`, чтобы включить содержимое входных и выходных данных инструмента в события span OpenTelemetry. Отключено по умолчанию для защиты конфиденциальных данных. См. [Мониторинг](/ru/monitoring-usage) |374| `OTEL_LOG_TOOL_CONTENT` | Установите на `1`, чтобы включить содержимое входных и выходных данных инструмента в события span OpenTelemetry. Отключено по умолчанию для защиты конфиденциальных данных. См. [Мониторинг](/docs/ru/monitoring-usage) |

375| `OTEL_LOG_TOOL_DETAILS` | Установите на `1`, чтобы включить аргументы входных данных инструмента, имена MCP servers, необработанные строки ошибок при сбоях инструментов, категорию отказа на событиях `api_refusal` и другие детали инструментов в трассировки и логи OpenTelemetry. Отключено по умолчанию для защиты PII. См. [Мониторинг](/ru/monitoring-usage) |375| `OTEL_LOG_TOOL_DETAILS` | Установите на `1`, чтобы включить аргументы входных данных инструмента, имена MCP servers, необработанные строки ошибок при сбоях инструментов, категорию отказа на событиях `api_refusal` и другие детали инструментов в трассировки и логи OpenTelemetry. Отключено по умолчанию для защиты PII. См. [Мониторинг](/docs/ru/monitoring-usage) |

376| `OTEL_LOG_USER_PROMPTS` | Установите на `1`, чтобы включить текст приглашения пользователя в трассировки и логи OpenTelemetry. Отключено по умолчанию (приглашения скрыты). См. [Мониторинг](/ru/monitoring-usage) |376| `OTEL_LOG_USER_PROMPTS` | Установите на `1`, чтобы включить текст приглашения пользователя в трассировки и логи OpenTelemetry. Отключено по умолчанию (приглашения скрыты). См. [Мониторинг](/docs/ru/monitoring-usage) |

377| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Установите на `false`, чтобы исключить UUID учётной записи из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/ru/monitoring-usage) |377| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Установите на `false`, чтобы исключить UUID учётной записи из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |

378| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Установите на `true`, чтобы включить точку входа сессии в атрибуты метрик (по умолчанию: исключено). Добавлено в v2.1.152. См. [Мониторинг](/ru/monitoring-usage) |378| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Установите на `true`, чтобы включить точку входа сессии в атрибуты метрик (по умолчанию: исключено). Добавлено в v2.1.152. См. [Мониторинг](/docs/ru/monitoring-usage) |

379| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | {/* min-version: 2.1.161 */}Начиная с v2.1.161, Claude Code присоединяет ключи `OTEL_RESOURCE_ATTRIBUTES` к меткам точек данных метрик. Установите на `false`, чтобы исключить их (по умолчанию: включено). См. [Мониторинг](/ru/monitoring-usage#multi-team-organization-support) |379| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Начиная с v2.1.161, Claude Code присоединяет ключи `OTEL_RESOURCE_ATTRIBUTES` к меткам точек данных метрик. Установите на `false`, чтобы исключить их (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage#multi-team-organization-support) |

380| `OTEL_METRICS_INCLUDE_SESSION_ID` | Установите на `false`, чтобы исключить ID сессии из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/ru/monitoring-usage) |380| `OTEL_METRICS_INCLUDE_SESSION_ID` | Установите на `false`, чтобы исключить ID сессии из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |

381| `OTEL_METRICS_INCLUDE_VERSION` | Установите на `true`, чтобы включить версию Claude Code в атрибуты метрик (по умолчанию: исключено). См. [Мониторинг](/ru/monitoring-usage) |381| `OTEL_METRICS_INCLUDE_VERSION` | Установите на `true`, чтобы включить версию Claude Code в атрибуты метрик (по умолчанию: исключено). См. [Мониторинг](/docs/ru/monitoring-usage) |

382| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределить бюджет символов для метаданных skills, показанных [инструменту Skill](/ru/skills#control-who-invokes-a-skill). Бюджет масштабируется динамически на 1% контекстного окна с резервным значением 8 000 символов. Устаревшее имя сохранено для обратной совместимости |382| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределить бюджет символов для метаданных skills, показанных [инструменту Skill](/docs/ru/skills#control-who-invokes-a-skill). Бюджет масштабируется динамически на 1% контекстного окна с резервным значением 8 000 символов. Устаревшее имя сохранено для обратной совместимости |

383| `TASK_MAX_OUTPUT_LENGTH` | Максимальное количество символов в выводе [subagent](/ru/sub-agents) перед усечением (по умолчанию: 32000, максимум: 160000). При усечении полный вывод сохраняется на диск и путь включается в усечённый ответ |383| `TASK_MAX_OUTPUT_LENGTH` | Максимальное количество символов в выводе [subagent](/docs/ru/sub-agents) перед усечением (по умолчанию: 32000, максимум: 160000). При усечении полный вывод сохраняется на диск и путь включается в усечённый ответ |

384| `USE_BUILTIN_RIPGREP` | Установите на `0`, чтобы использовать установленный в системе `rg` вместо `rg`, включённого в Claude Code |384| `USE_BUILTIN_RIPGREP` | Установите на `0`, чтобы использовать установленный в системе `rg` вместо `rg`, включённого в Claude Code |

385| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределить регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |385| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределить регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |

386| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Переопределить регион для Claude 3.5 Sonnet при использовании Google Cloud's Agent Platform |386| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Переопределить регион для Claude 3.5 Sonnet при использовании Google Cloud's Agent Platform |


392| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Переопределить регион для Claude Sonnet 4.5 при использовании Google Cloud's Agent Platform |392| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Переопределить регион для Claude Sonnet 4.5 при использовании Google Cloud's Agent Platform |

393| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Переопределить регион для Claude Opus 4.6 при использовании Google Cloud's Agent Platform |393| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Переопределить регион для Claude Opus 4.6 при использовании Google Cloud's Agent Platform |

394| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Переопределить регион для Claude Sonnet 4.6 при использовании Google Cloud's Agent Platform |394| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Переопределить регион для Claude Sonnet 4.6 при использовании Google Cloud's Agent Platform |

395| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Переопределить регион для Claude Opus 4.7 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.111 |395| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Переопределить регион для Claude Opus 4.7 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.111 |

396| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Переопределить регион для Claude Opus 4.8 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.154 |396| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Переопределить регион для Claude Opus 4.8 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.154 |

397| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Переопределить регион для Claude Sonnet 5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.197 |397| `VERTEX_REGION_CLAUDE_5_SONNET` | Переопределить регион для Claude Sonnet 5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.197 |

398| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Переопределить регион для Claude Fable 5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.170 |398| `VERTEX_REGION_CLAUDE_FABLE_5` | Переопределить регион для Claude Fable 5 при использовании Google Cloud's Agent Platform. Добавлено в v2.1.170 |

399| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Переопределить регион для Claude Haiku 4.5 при использовании Google Cloud's Agent Platform |399| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Переопределить регион для Claude Haiku 4.5 при использовании Google Cloud's Agent Platform |

400 400 

401Также поддерживаются стандартные переменные экспортёра OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` и варианты для конкретных сигналов). См. [Мониторинг](/ru/monitoring-usage) для деталей конфигурации.401Также поддерживаются стандартные переменные экспортёра OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` и варианты для конкретных сигналов). См. [Мониторинг](/docs/ru/monitoring-usage) для деталей конфигурации.

402 402 

403<h2 id="see-also">403<h2 id="see-also">

404 См. также404 См. также

405</h2>405</h2>

406 406 

407* [Параметры](/ru/settings): все конфигурация `settings.json`, включая ключ `env`407* [Параметры](/docs/ru/settings): все конфигурация `settings.json`, включая ключ `env`

408* [Справочник CLI](/ru/cli-reference): флаги времени запуска408* [Справочник CLI](/docs/ru/cli-reference): флаги времени запуска

409* [Конфигурация сети](/ru/network-config): настройка прокси и TLS409* [Конфигурация сети](/docs/ru/network-config): настройка прокси и TLS

410* [Мониторинг](/ru/monitoring-usage): конфигурация OpenTelemetry410* [Мониторинг](/docs/ru/monitoring-usage): конфигурация OpenTelemetry

errors.md +148 −148

Details

6 6 

7> Найдите сообщения об ошибках runtime Claude Code, узнайте, что они означают и как их исправить.7> Найдите сообщения об ошибках runtime Claude Code, узнайте, что они означают и как их исправить.

8 8 

9На этой странице перечислены ошибки runtime, которые отображает Claude Code, и способы восстановления после каждой из них, а также что проверить, когда ответы кажутся неправильными без ошибки. Для ошибок установки, таких как `command not found` или сбои TLS во время установки, см. [Troubleshoot installation and login](/ru/troubleshoot-install).9На этой странице перечислены ошибки runtime, которые отображает Claude Code, и способы восстановления после каждой из них, а также что проверить, когда ответы кажутся неправильными без ошибки. Для ошибок установки, таких как `command not found` или сбои TLS во время установки, см. [Troubleshoot installation and login](/docs/ru/troubleshoot-install).

10 10 

11Эти ошибки и команды восстановления применяются во всех интерфейсах: CLI, [Desktop app](/ru/desktop) и [Claude Code on the web](/ru/claude-code-on-the-web), поскольку все три используют один и тот же Claude Code CLI. Для проблем, специфичных для конкретного интерфейса, см. раздел troubleshooting на странице этого интерфейса.11Эти ошибки и команды восстановления применяются во всех интерфейсах: CLI, [Desktop app](/docs/ru/desktop) и [Claude Code on the web](/docs/ru/claude-code-on-the-web), поскольку все три используют один и тот же Claude Code CLI. Для проблем, специфичных для конкретного интерфейса, см. раздел troubleshooting на странице этого интерфейса.

12 12 

13<Note>13<Note>

14 Claude Code вызывает Claude API для получения ответов модели, поэтому большинство ошибок runtime соответствуют базовому коду ошибки API. На этой странице описано, что каждая ошибка означает в Claude Code и как восстановиться. Для определений кодов состояния HTTP в исходном виде см. [Claude Platform error reference](https://platform.claude.com/docs/en/api/errors).14 Claude Code вызывает Claude API для получения ответов модели, поэтому большинство ошибок runtime соответствуют базовому коду ошибки API. На этой странице описано, что каждая ошибка означает в Claude Code и как восстановиться. Для определений кодов состояния HTTP в исходном виде см. [Claude Platform error reference](https://platform.claude.com/docs/en/api/errors).


97 Automatic retries97 Automatic retries

98</h2>98</h2>

99 99 

100Claude Code повторяет попытки при временных сбоях перед отображением ошибки. Ошибки сервера, перегруженные ответы, тайм-ауты запросов, временные дроссели 429 и разорванные соединения повторяются до 10 раз с экспоненциальной задержкой. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, это охватывает соединения, которые разрываются в середине ответа перед любым видимым выводом: Claude Code повторно отправляет запрос с той же задержкой и ход продолжается вместо остановки с ошибкой соединения. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, временные дроссели 429, которые не содержат заголовки квоты вашего плана, также повторяются, когда вы вошли с подписью claude.ai; более ранние версии повторяли их только для входов по ключу API и Enterprise.100Claude Code повторяет попытки при временных сбоях перед отображением ошибки. Ошибки сервера, перегруженные ответы, тайм-ауты запросов, временные дроссели 429 и разорванные соединения повторяются до 10 раз с экспоненциальной задержкой. Начиная с версии 2.1.198, это охватывает соединения, которые разрываются в середине ответа перед любым видимым выводом: Claude Code повторно отправляет запрос с той же задержкой и ход продолжается вместо остановки с ошибкой соединения. Начиная с версии 2.1.199, временные дроссели 429, которые не содержат заголовки квоты вашего плана, также повторяются, когда вы вошли с подписью claude.ai; более ранние версии повторяли их только для входов по ключу API и Enterprise.

101 101 

102Некоторые классы сбоев не повторяются, потому что повторная попытка не может быть успешной:102Некоторые классы сбоев не повторяются, потому что повторная попытка не может быть успешной:

103 103 

104* {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, сбой проверки сертификата TLS, такой как прокси, проверяющий TLS, отсутствующий пакет `NODE_EXTRA_CA_CERTS` или истекший сертификат, завершается ошибкой при первой попытке, поэтому исправление появляется немедленно вместо полного бюджета повторных попыток. См. [SSL certificate errors](#ssl-certificate-errors). Временные условия TLS, такие как тайм-аут рукопожатия, все еще повторяются.104* Начиная с версии 2.1.199, сбой проверки сертификата TLS, такой как прокси, проверяющий TLS, отсутствующий пакет `NODE_EXTRA_CA_CERTS` или истекший сертификат, завершается ошибкой при первой попытке, поэтому исправление появляется немедленно вместо полного бюджета повторных попыток. См. [SSL certificate errors](#ssl-certificate-errors). Временные условия TLS, такие как тайм-аут рукопожатия, все еще повторяются.

105* {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, ошибка сервера, которая поступает после того, как Claude уже передал видимый вывод, сохраняет частичный ответ и добавляет [incomplete-response notice](#the-response-above-may-be-incomplete) вместо повторной попытки, так как повторный запрос может выполнить те же вызовы инструментов дважды. Более ранние версии отбрасывали частичный вывод и сообщали о ходе как об ошибке.105* Начиная с версии 2.1.199, ошибка сервера, которая поступает после того, как Claude уже передал видимый вывод, сохраняет частичный ответ и добавляет [incomplete-response notice](#the-response-above-may-be-incomplete) вместо повторной попытки, так как повторный запрос может выполнить те же вызовы инструментов дважды. Более ранние версии отбрасывали частичный вывод и сообщали о ходе как об ошибке.

106* {/* min-version: 2.1.208 */}[Amazon Bedrock streaming response with an unexpected content-type](#bedrock-streaming-response-has-an-unexpected-content-type) завершается ошибкой при первой попытке, потому что шлюз или прокси, переписывающий ответ, переписал бы повторную попытку таким же образом. Требуется Claude Code версии 2.1.208 или позже.106* [Amazon Bedrock streaming response with an unexpected content-type](#bedrock-streaming-response-has-an-unexpected-content-type) завершается ошибкой при первой попытке, потому что шлюз или прокси, переписывающий ответ, переписал бы повторную попытку таким же образом. Требуется Claude Code версии 2.1.208 или позже.

107 107 

108Во время повторных попыток спиннер показывает обратный отсчет `Retrying in Ns · attempt x/y` после метки ошибки. Метка называет конкретную причину первой попытки для сбоев, на которые вы можете действовать немедленно: сеть отключена, рукопожатие TLS не удалось, или вы достигли лимита скорости. Для других ошибок она читается как `API error` вначале. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, она переключается на конкретную причину третьей попытки, или при последней попытке, когда `CLAUDE_CODE_MAX_RETRIES` позволяет менее трёх; более ранние версии переключаются только при последней попытке.108Во время повторных попыток спиннер показывает обратный отсчет `Retrying in Ns · attempt x/y` после метки ошибки. Метка называет конкретную причину первой попытки для сбоев, на которые вы можете действовать немедленно: сеть отключена, рукопожатие TLS не удалось, или вы достигли лимита скорости. Для других ошибок она читается как `API error` вначале. Начиная с версии 2.1.198, она переключается на конкретную причину третьей попытки, или при последней попытке, когда `CLAUDE_CODE_MAX_RETRIES` позволяет менее трёх; более ранние версии переключаются только при последней попытке.

109 109 

110{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, обычная подсказка спиннера подавляется во время повторных попыток. После того как причина ошибки раскрыта, если сбой — это перегрузка 529, строка ниже обратного отсчета также указывает, где проверить статус сервиса: `status.claude.com` на Anthropic API, или хост провайдера или шлюза, указанный в сообщении, на других конфигурациях.110Начиная с версии 2.1.198, обычная подсказка спиннера подавляется во время повторных попыток. После того как причина ошибки раскрыта, если сбой — это перегрузка 529, строка ниже обратного отсчета также указывает, где проверить статус сервиса: `status.claude.com` на Anthropic API, или хост провайдера или шлюза, указанный в сообщении, на других конфигурациях.

111 111 

112{/* min-version: 2.1.185 */}Если данные не поступают на поток ответов в течение 20 секунд, пока запрос все еще ожидает, спиннер показывает `Waiting for API response · will retry in … · check your network` перед началом любой повторной попытки. Запрос еще не завершился с ошибкой: обратный отсчет продолжается до момента, когда Claude Code прерывает зависшее соединение и повторяет попытку, поэтому баннер исчезает самостоятельно, когда данные возобновляются или повторная попытка успешна. Начиная с версии 2.1.185 пороговое значение составляет 20 секунд; в более ранних версиях баннер отображается через 10 секунд с другой формулировкой. Если он появляется при каждой попытке, рассматривайте это как [проблему с сетью](#unable-to-connect-to-api).112Если данные не поступают на поток ответов в течение 20 секунд, пока запрос все еще ожидает, спиннер показывает `Waiting for API response · will retry in … · check your network` перед началом любой повторной попытки. Запрос еще не завершился с ошибкой: обратный отсчет продолжается до момента, когда Claude Code прерывает зависшее соединение и повторяет попытку, поэтому баннер исчезает самостоятельно, когда данные возобновляются или повторная попытка успешна. Начиная с версии 2.1.185 пороговое значение составляет 20 секунд; в более ранних версиях баннер отображается через 10 секунд с другой формулировкой. Если он появляется при каждой попытке, рассматривайте это как [проблему с сетью](#unable-to-connect-to-api).

113 113 

114Когда вы видите одну из ошибок на этой странице, эти повторные попытки уже исчерпаны, если только она не принадлежит к классу, который не повторяется, такому как сбой проверки сертификата. Вы можете настроить поведение с помощью этих переменных окружения:114Когда вы видите одну из ошибок на этой странице, эти повторные попытки уже исчерпаны, если только она не принадлежит к классу, который не повторяется, такому как сбой проверки сертификата. Вы можете настроить поведение с помощью этих переменных окружения:

115 115 

116| Переменная | По умолчанию | Эффект |116| Переменная | По умолчанию | Эффект |

117| :------------------------------------------- | :------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |117| :------------------------------------------- | :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

118| [`CLAUDE_CODE_MAX_RETRIES`](/ru/env-vars) | 10 | Количество попыток повтора. {/* min-version: 2.1.186 */}Ограничено 15 начиная с версии 2.1.186; {/* min-version: 2.1.199 */}начиная с версии 2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Снизьте его, чтобы быстрее выявлять сбои в скриптах. |118| [`CLAUDE_CODE_MAX_RETRIES`](/docs/ru/env-vars) | 10 | Количество попыток повтора. Ограничено 15 начиная с версии 2.1.186; начиная с версии 2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Снизьте его, чтобы быстрее выявлять сбои в скриптах. |

119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/ru/env-vars) | не установлено | Установите значение `1` в автоматических сеансах, таких как задания CI, чтобы повторять попытки при ошибках емкости `429` и `529` бесконечно вместо отказа после `CLAUDE_CODE_MAX_RETRIES` попыток. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, это также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, тайм-ауты и разорванные соединения, до 300, примерно три часа задержки, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. |119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) | не установлено | Установите значение `1` в автоматических сеансах, таких как задания CI, чтобы повторять попытки при ошибках емкости `429` и `529` бесконечно вместо отказа после `CLAUDE_CODE_MAX_RETRIES` попыток. Начиная с версии 2.1.199, это также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, тайм-ауты и разорванные соединения, до 300, примерно три часа задержки, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. |

120| [`API_TIMEOUT_MS`](/ru/env-vars) | 600000 | Тайм-аут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. |120| [`API_TIMEOUT_MS`](/docs/ru/env-vars) | 600000 | Тайм-аут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. |

121 121 

122<h2 id="server-errors">122<h2 id="server-errors">

123 Ошибки сервера123 Ошибки сервера


196API Error: Response stalled mid-stream. The response above may be incomplete.196API Error: Response stalled mid-stream. The response above may be incomplete.

197```197```

198 198 

199* {/* min-version: 2.1.199 */}`Server error mid-response`: ошибка перегрузки или 5xx сервера в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбрасывал частичный результат и сообщал весь ход как ошибку.199* `Server error mid-response`: ошибка перегрузки или 5xx сервера в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбрасывал частичный результат и сообщал весь ход как ошибку.

200* `Connection closed mid-response`: соединение разорвалось.200* `Connection closed mid-response`: соединение разорвалось.

201* `Response stalled mid-stream`: поток перестал отправлять данные.201* `Response stalled mid-stream`: поток перестал отправлять данные.

202 202 


210 Auto mode cannot determine the safety of an action210 Auto mode cannot determine the safety of an action

211</h3>211</h3>

212 212 

213Модель, которую [auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) использует для классификации действий, не смогла принять решение, поэтому auto mode не одобрила действие автоматически. Сообщение, которое вы видите, зависит от того, почему классификатор не сработал.213Модель, которую [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) использует для классификации действий, не смогла принять решение, поэтому auto mode не одобрила действие автоматически. Сообщение, которое вы видите, зависит от того, почему классификатор не сработал.

214 214 

215Чтения, поиски и редактирования в вашем рабочем каталоге пропускают классификатор, поэтому они продолжают работать во всех этих случаях.215Чтения, поиски и редактирования в вашем рабочем каталоге пропускают классификатор, поэтому они продолжают работать во всех этих случаях.

216 216 


224 224 

225* Повторите попытку через несколько секунд; Claude видит то же сообщение и обычно повторяет попытку самостоятельно225* Повторите попытку через несколько секунд; Claude видит то же сообщение и обычно повторяет попытку самостоятельно

226* Если повторные попытки продолжают не удаваться, продолжайте с задачами только для чтения и вернитесь к заблокированному действию позже226* Если повторные попытки продолжают не удаваться, продолжайте с задачами только для чтения и вернитесь к заблокированному действию позже

227* Это временно и не связано с [auto mode eligibility](/ru/permission-modes#eliminate-prompts-with-auto-mode); вам не нужно менять параметры227* Это временно и не связано с [auto mode eligibility](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode); вам не нужно менять параметры

228 228 

229Когда классификатор вернул непарсируемый ответ:229Когда классификатор вернул непарсируемый ответ:

230 230 


247 247 

248* Это не решение о вашем действии. Содержимое, уже находящееся в вашей беседе, вызвало фильтр безопасности на API, когда auto mode отправил беседу классификатору248* Это не решение о вашем действии. Содержимое, уже находящееся в вашей беседе, вызвало фильтр безопасности на API, когда auto mode отправил беседу классификатору

249* Повторная попытка не поможет; то же содержимое беседы снова вызовет фильтр249* Повторная попытка не поможет; то же содержимое беседы снова вызовет фильтр

250* Переключитесь на другой [permission mode](/ru/permission-modes), чтобы вы могли одобрить действие при появлении запроса, или начните новую беседу без содержимого, вызывающего проблему250* Переключитесь на другой [permission mode](/docs/ru/permission-modes), чтобы вы могли одобрить действие при появлении запроса, или начните новую беседу без содержимого, вызывающего проблему

251 251 

252Когда беседа выросла больше, чем контекстное окно классификатора:252Когда беседа выросла больше, чем контекстное окно классификатора:

253 253 


255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

256```256```

257 257 

258В интерактивном сеансе auto mode возвращается к обычному запросу разрешения для этого действия, чтобы вы могли одобрить или отклонить его вручную. В [non-interactive mode](/ru/headless) запуск прерывается, потому что стенограмма только растет и повторная попытка не может быть успешной.258В интерактивном сеансе auto mode возвращается к обычному запросу разрешения для этого действия, чтобы вы могли одобрить или отклонить его вручную. В [non-interactive mode](/docs/ru/headless) запуск прерывается, потому что стенограмма только растет и повторная попытка не может быть успешной.

259 259 

260**Что делать:**260**Что делать:**

261 261 


266 Agent terminated early due to an API error266 Agent terminated early due to an API error

267</h3>267</h3>

268 268 

269{/* min-version: 2.1.199 */}Запрос API [subagent](/ru/sub-agents) не удался окончательно, например, потому что был достигнут лимит использования или повторные попытки для ошибки сервера закончились, поэтому subagent остановился до завершения своей задачи. Это сообщение требует Claude Code v2.1.199 или позже; до этого текст ошибки API был возвращен Claude как если бы это был результат subagent.269Запрос API [subagent](/docs/ru/sub-agents) не удался окончательно, например, потому что был достигнут лимит использования или повторные попытки для ошибки сервера закончились, поэтому subagent остановился до завершения своей задачи. Это сообщение требует Claude Code v2.1.199 или позже; до этого текст ошибки API был возвращен Claude как если бы это был результат subagent.

270 270 

271```text theme={null}271```text theme={null}

272Agent terminated early due to an API error: <error detail>272Agent terminated early due to an API error: <error detail>


275**Что делать:**275**Что делать:**

276 276 

277* Сопоставьте деталь ошибки после двоеточия с ее собственным разделом на этой странице, например [Usage limits](#usage-limits) или [Server errors](#server-errors), и следуйте шагам этого раздела277* Сопоставьте деталь ошибки после двоеточия с ее собственным разделом на этой странице, например [Usage limits](#usage-limits) или [Server errors](#server-errors), и следуйте шагам этого раздела

278* После того как основная ошибка исчезнет, попросите Claude повторить задачу или [resume the subagent](/ru/sub-agents#resume-subagents)278* После того как основная ошибка исчезнет, попросите Claude повторить задачу или [resume the subagent](/docs/ru/sub-agents#resume-subagents)

279 279 

280Когда ограничение скорости, перегрузка или ошибка сервера прерывает foreground subagent, который уже произвел текстовый результат, Claude получает этот частичный результат, отмеченный как неполный, вместо этой ошибки. {/* min-version: 2.1.200 */}Subagent, единственным результатом которого были вызовы инструментов, также получает эту ошибку; в v2.1.199 эта форма возвращала пустой частичный результат вместо этого. См. [API errors in subagents](/ru/sub-agents#api-errors-in-subagents).280Когда ограничение скорости, перегрузка или ошибка сервера прерывает foreground subagent, который уже произвел текстовый результат, Claude получает этот частичный результат, отмеченный как неполный, вместо этой ошибки. Subagent, единственным результатом которого были вызовы инструментов, также получает эту ошибку; в v2.1.199 эта форма возвращала пустой частичный результат вместо этого. См. [API errors in subagents](/docs/ru/sub-agents#api-errors-in-subagents).

281 281 

282<h2 id="usage-limits">282<h2 id="usage-limits">

283 Ограничения использования283 Ограничения использования


309* Запустите `/usage-credits` для покупки дополнительного использования на Pro и Max, или для запроса у администратора на Team и Enterprise. См. [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) для информации о выставлении счетов.309* Запустите `/usage-credits` для покупки дополнительного использования на Pro и Max, или для запроса у администратора на Team и Enterprise. См. [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) для информации о выставлении счетов.

310* Для обновления вашего плана на более высокие базовые лимиты см. [claude.com/pricing](https://claude.com/pricing)310* Для обновления вашего плана на более высокие базовые лимиты см. [claude.com/pricing](https://claude.com/pricing)

311 311 

312Чтобы отслеживать оставшийся лимит перед его исчерпанием, добавьте поля `rate_limits` в [пользовательскую строку состояния](/ru/statusline#rate-limit-usage), или в приложении Desktop нажмите на [кольцо использования](/ru/desktop#check-usage) рядом с выбором модели.312Чтобы отслеживать оставшийся лимит перед его исчерпанием, добавьте поля `rate_limits` в [пользовательскую строку состояния](/docs/ru/statusline#rate-limit-usage), или в приложении Desktop нажмите на [кольцо использования](/docs/ru/desktop#check-usage) рядом с выбором модели.

313 313 

314<h3 id="usage-credits-required-for-1m-context">314<h3 id="usage-credits-required-for-1m-context">

315 Требуются кредиты использования для контекста 1M315 Требуются кредиты использования для контекста 1M


321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

322```322```

323 323 

324Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недельного использования имеют оставшуюся емкость. См. [Extended context](/ru/model-config#extended-context) для информации о том, какие планы включают контекст 1M напрямую и какие требуют кредитов использования.324Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недельного использования имеют оставшуюся емкость. См. [Extended context](/docs/ru/model-config#extended-context) для информации о том, какие планы включают контекст 1M напрямую и какие требуют кредитов использования.

325 325 

326{/* min-version: 2.1.172 */}Когда эта ошибка появляется в середине разговора, потому что контекст вырос более 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом уровне впоследствии, поэтому никаких действий не требуется. На версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведенные ниже шаги применяются, когда вы явно выбрали модель `[1m]`.326Когда эта ошибка появляется в середине разговора, потому что контекст вырос более 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом уровне впоследствии, поэтому никаких действий не требуется. На версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведенные ниже шаги применяются, когда вы явно выбрали модель `[1m]`.

327 327 

328**Что делать:**328**Что делать:**

329 329 

330* Запустите `/model` и выберите вариант без суффикса `[1m]` для возврата к стандартному окну контекста330* Запустите `/model` и выберите вариант без суффикса `[1m]` для возврата к стандартному окну контекста

331* Запустите `/usage-credits` для включения тарифицированного выставления счетов для варианта 1M на Pro и Max, или для запроса у администратора на Team и Enterprise331* Запустите `/usage-credits` для включения тарифицированного выставления счетов для варианта 1M на Pro и Max, или для запроса у администратора на Team и Enterprise

332* Если ошибка сохраняется после `/model`, ID модели 1M может быть установлен в другом месте. См. [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) для проверки мест конфигурации в порядке приоритета.332* Если ошибка сохраняется после `/model`, ID модели 1M может быть установлен в другом месте. См. [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) для проверки мест конфигурации в порядке приоритета.

333* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ru/env-vars)333* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars)

334 334 

335<h3 id="server-is-temporarily-limiting-requests">335<h3 id="server-is-temporarily-limiting-requests">

336 Сервер временно ограничивает запросы336 Сервер временно ограничивает запросы


342API Error: Server is temporarily limiting requests (not your usage limit)342API Error: Server is temporarily limiting requests (not your usage limit)

343```343```

344 344 

345Claude Code различает это от вашего лимита плана по отсутствию унифицированных заголовков квоты, которые несет реальный ответ лимита. {/* min-version: 2.1.199 */}Начиная с v2.1.199 это [автоматически повторяется](#automatic-retries) с отступом перед отображением, независимо от способа аутентификации. На более ранних версиях сеанс, подписанный на подписку claude.ai, не прошел ход при первом возникновении; только API ключ и аутентификация Enterprise повторили попытку.345Claude Code различает это от вашего лимита плана по отсутствию унифицированных заголовков квоты, которые несет реальный ответ лимита. Начиная с v2.1.199 это [автоматически повторяется](#automatic-retries) с отступом перед отображением, независимо от способа аутентификации. На более ранних версиях сеанс, подписанный на подписку claude.ai, не прошел ход при первом возникновении; только API ключ и аутентификация Enterprise повторили попытку.

346 346 

347**Что делать:**347**Что делать:**

348 348 


366* Запустите `/status` и подтвердите, что активные учетные данные - это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через ключ низкого уровня вместо вашей подписки.366* Запустите `/status` и подтвердите, что активные учетные данные - это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через ключ низкого уровня вместо вашей подписки.

367* Проверьте консоль вашего поставщика для активных лимитов и запросите более высокий уровень, если необходимо367* Проверьте консоль вашего поставщика для активных лимитов и запросите более высокий уровень, если необходимо

368* Для API ключей Anthropic см. [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) для информации о том, как работают уровни и как установить ограничения расходов для каждого рабочего пространства368* Для API ключей Anthropic см. [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) для информации о том, как работают уровни и как установить ограничения расходов для каждого рабочего пространства

369* Снизьте параллелизм: понизьте [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ru/env-vars), избегайте запуска множества параллельных подагентов, или переключитесь на меньшую модель с `/model` для высокообъемных скриптовых запусков369* Снизьте параллелизм: понизьте [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/ru/env-vars), избегайте запуска множества параллельных подагентов, или переключитесь на меньшую модель с `/model` для высокообъемных скриптовых запусков

370 370 

371<h3 id="credit-balance-is-too-low">371<h3 id="credit-balance-is-too-low">

372 Баланс кредитов слишком низкий372 Баланс кредитов слишком низкий


382 382 

383* Добавьте кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся до того, как он упадет до нуля383* Добавьте кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся до того, как он упадет до нуля

384* Переключитесь на аутентификацию подписки с `/login` если у вас есть план Pro, Max, Team или Enterprise384* Переключитесь на аутентификацию подписки с `/login` если у вас есть план Pro, Max, Team или Enterprise

385* Установите ограничения расходов для каждого рабочего пространства в Console, чтобы предотвратить истощение баланса организации одним проектом. См. [Manage costs effectively](/ru/costs).385* Установите ограничения расходов для каждого рабочего пространства в Console, чтобы предотвратить истощение баланса организации одним проектом. См. [Manage costs effectively](/docs/ru/costs).

386 386 

387<h2 id="authentication-errors">387<h2 id="authentication-errors">

388 Ошибки аутентификации388 Ошибки аутентификации


404 404 

405* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console405* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console

406* Если вы ожидали, что переменная окружения будет вас аутентифицировать, убедитесь, что `ANTHROPIC_API_KEY` установлена и экспортирована в оболочке, где вы запустили `claude`406* Если вы ожидали, что переменная окружения будет вас аутентифицировать, убедитесь, что `ANTHROPIC_API_KEY` установлена и экспортирована в оболочке, где вы запустили `claude`

407* Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт [`apiKeyHelper`](/ru/settings#available-settings), который получает ключ при запуске407* Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт [`apiKeyHelper`](/docs/ru/settings#available-settings), который получает ключ при запуске

408* См. [Authentication precedence](/ru/authentication#authentication-precedence), чтобы понять, какие учетные данные использует Claude Code, когда присутствует несколько408* См. [Authentication precedence](/docs/ru/authentication#authentication-precedence), чтобы понять, какие учетные данные использует Claude Code, когда присутствует несколько

409 409 

410Если вам предлагается войти повторно, см. [Not logged in or token expired](/ru/troubleshoot-install#not-logged-in-or-token-expired) для исправления системных часов и macOS Keychain.410Если вам предлагается войти повторно, см. [Not logged in or token expired](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired) для исправления системных часов и macOS Keychain.

411 411 

412<h3 id="could-not-resolve-authentication-method">412<h3 id="could-not-resolve-authentication-method">

413 Could not resolve authentication method413 Could not resolve authentication method

414</h3>414</h3>

415 415 

416Сеанс достиг клиента API без каких-либо учетных данных. Это появляется в [background sessions](/ru/agent-view), облачных сеансах и контекстах Agent SDK, где проверка интерактивного входа не выполняется перед первым запросом.416Сеанс достиг клиента API без каких-либо учетных данных. Это появляется в [background sessions](/docs/ru/agent-view), облачных сеансах и контекстах Agent SDK, где проверка интерактивного входа не выполняется перед первым запросом.

417 417 

418```text theme={null}418```text theme={null}

419Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted419Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

420```420```

421 421 

422{/* min-version: 2.1.174 */}До версии 2.1.174 фоновый или облачный сеанс, назначенный неактивному предварительно инициализированному рабочему процессу, мог завершиться ошибкой таким образом, даже если были настроены действительные учетные данные. Обновитесь для восстановления. В текущих версиях ошибка означает, что рабочему процессу не было доступно никаких учетных данных.422До версии 2.1.174 фоновый или облачный сеанс, назначенный неактивному предварительно инициализированному рабочему процессу, мог завершиться ошибкой таким образом, даже если были настроены действительные учетные данные. Обновитесь для восстановления. В текущих версиях ошибка означает, что рабочему процессу не было доступно никаких учетных данных.

423 423 

424**Что делать:**424**Что делать:**

425 425 

426* Обновитесь до версии 2.1.174 или более поздней, если это появляется в фоновом или облачном сеансе и ваши учетные данные уже настроены426* Обновитесь до версии 2.1.174 или более поздней, если это появляется в фоновом или облачном сеансе и ваши учетные данные уже настроены

427* Убедитесь, что `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` или учетные данные вашего облачного провайдера установлены в окружении, которое запускает рабочий процесс, а не только в вашей интерактивной оболочке427* Убедитесь, что `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` или учетные данные вашего облачного провайдера установлены в окружении, которое запускает рабочий процесс, а не только в вашей интерактивной оболочке

428* Для Agent SDK см. [authentication setup](/ru/agent-sdk/overview#get-started)428* Для Agent SDK см. [authentication setup](/docs/ru/agent-sdk/overview#get-started)

429* Запустите `/status` в интерактивном сеансе в том же окружении, чтобы подтвердить, какой источник учетных данных разрешается429* Запустите `/status` в интерактивном сеансе в том же окружении, чтобы подтвердить, какой источник учетных данных разрешается

430 430 

431<h3 id="invalid-api-key">431<h3 id="invalid-api-key">


443* Проверьте опечатки и убедитесь, что ключ не был отозван в [Console](https://platform.claude.com/settings/keys)443* Проверьте опечатки и убедитесь, что ключ не был отозван в [Console](https://platform.claude.com/settings/keys)

444* Запустите `env | grep ANTHROPIC` в той же оболочке. Такие инструменты, как direnv, плагины dotenv shell и терминалы IDE, могут загружать устаревший ключ из файла `.env` в вашем проекте без явной установки.444* Запустите `env | grep ANTHROPIC` в той же оболочке. Такие инструменты, как direnv, плагины dotenv shell и терминалы IDE, могут загружать устаревший ключ из файла `.env` в вашем проекте без явной установки.

445* Отмените установку `ANTHROPIC_API_KEY` и запустите `/login` для использования аутентификации подписки445* Отмените установку `ANTHROPIC_API_KEY` и запустите `/login` для использования аутентификации подписки

446* Если ключ поступает из скрипта [`apiKeyHelper`](/ru/settings#available-settings), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout446* Если ключ поступает из скрипта [`apiKeyHelper`](/docs/ru/settings#available-settings), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout

447* Запустите `/status`, чтобы подтвердить, какой источник учетных данных на самом деле использует Claude Code447* Запустите `/status`, чтобы подтвердить, какой источник учетных данных на самом деле использует Claude Code

448 448 

449<h3 id="your-apikeyhelper-script-is-failing">449<h3 id="your-apikeyhelper-script-is-failing">

450 Your apiKeyHelper script is failing450 Your apiKeyHelper script is failing

451</h3>451</h3>

452 452 

453Команда, настроенная в параметре [`apiKeyHelper`](/ru/settings#available-settings), завершилась с ошибкой, истекла по времени или ничего не вывела на stdout. Без ключа из скрипта запрос достигает API с заполнителем учетных данных, и API отклоняет его с `401`.453Команда, настроенная в параметре [`apiKeyHelper`](/docs/ru/settings#available-settings), завершилась с ошибкой, истекла по времени или ничего не вывела на stdout. Без ключа из скрипта запрос достигает API с заполнителем учетных данных, и API отклоняет его с `401`.

454 454 

455```text theme={null}455```text theme={null}

456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

457```457```

458 458 

459Claude Code повторно запускает скрипт и повторяет попытку запроса до двух раз перед отображением этого сообщения, поэтому сбой проявляется в течение трех попыток. {/* min-version: 2.1.208 */}До версии 2.1.208 Claude Code тратил весь [retry budget](#automatic-retries) на повторную отправку запроса с заполнителем учетных данных, а затем сообщал об общей ошибке аутентификации `401` вместо сбоя скрипта.459Claude Code повторно запускает скрипт и повторяет попытку запроса до двух раз перед отображением этого сообщения, поэтому сбой проявляется в течение трех попыток. До версии 2.1.208 Claude Code тратил весь [retry budget](#automatic-retries) на повторную отправку запроса с заполнителем учетных данных, а затем сообщал об общей ошибке аутентификации `401` вместо сбоя скрипта.

460 460 

461Запуск `/login` здесь не помогает: вывод помощника [имеет приоритет](/ru/authentication#authentication-precedence) над сохраненным входом, пока параметр присутствует.461Запуск `/login` здесь не помогает: вывод помощника [имеет приоритет](/docs/ru/authentication#authentication-precedence) над сохраненным входом, пока параметр присутствует.

462 462 

463**Что делать:**463**Что делать:**

464 464 

465* Запустите команду, настроенную в `apiKeyHelper`, непосредственно в вашей оболочке, чтобы воспроизвести сбой465* Запустите команду, настроенную в `apiKeyHelper`, непосредственно в вашей оболочке, чтобы воспроизвести сбой

466* Если команда сообщает об истекшей сессии, повторно аутентифицируйтесь у вашего поставщика учетных данных, например, снова войдя в ваш SSO или хранилище секретов466* Если команда сообщает об истекшей сессии, повторно аутентифицируйтесь у вашего поставщика учетных данных, например, снова войдя в ваш SSO или хранилище секретов

467* Исправьте команду так, чтобы она выводила ключ на stdout и выходила с кодом 0. См. [rotate credentials with apiKeyHelper](/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) для рабочей настройки.467* Исправьте команду так, чтобы она выводила ключ на stdout и выходила с кодом 0. См. [rotate credentials with apiKeyHelper](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) для рабочей настройки.

468* Запустите `/status`, чтобы подтвердить, что `apiKeyHelper` является активным источником учетных данных. Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки появляются в панели `Cloud authentication` в терминале.468* Запустите `/status`, чтобы подтвердить, что `apiKeyHelper` является активным источником учетных данных. Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки появляются в панели `Cloud authentication` в терминале.

469 469 

470<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">


499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

500```500```

501 501 

502Переменные окружения и `apiKeyHelper` имеют приоритет над `/login`, поэтому запуск только `/login` не помогает, пока один из них все еще предоставляет ключ. См. [Authentication precedence](/ru/authentication#authentication-precedence).502Переменные окружения и `apiKeyHelper` имеют приоритет над `/login`, поэтому запуск только `/login` не помогает, пока один из них все еще предоставляет ключ. См. [Authentication precedence](/docs/ru/authentication#authentication-precedence).

503 503 

504**Что делать:**504**Что делать:**

505 505 

506* Если сообщение называет `ANTHROPIC_API_KEY`, отмените его установку в текущей оболочке и удалите его из профиля вашей оболочки или файла `.env`, затем перезапустите `claude`506* Если сообщение называет `ANTHROPIC_API_KEY`, отмените его установку в текущей оболочке и удалите его из профиля вашей оболочки или файла `.env`, затем перезапустите `claude`

507* Если сообщение называет `apiKeyHelper`, удалите параметр [`apiKeyHelper`](/ru/settings#available-settings) из вашего `settings.json`507* Если сообщение называет `apiKeyHelper`, удалите параметр [`apiKeyHelper`](/docs/ru/settings#available-settings) из вашего `settings.json`

508* Запустите `/login` для входа с помощью вашей учетной записи claude.ai508* Запустите `/login` для входа с помощью вашей учетной записи claude.ai

509* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API509* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API

510* Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console510* Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console


526**Что делать:**526**Что делать:**

527 527 

528* Попросите администратора включить доступ Claude Code для вашей организации528* Попросите администратора включить доступ Claude Code для вашей организации

529* Аутентифицируйтесь с помощью ключа API Console вместо вашей подписки. См. [Claude Console authentication](/ru/authentication#claude-console-authentication) для настройки.529* Аутентифицируйтесь с помощью ключа API Console вместо вашей подписки. См. [Claude Console authentication](/docs/ru/authentication#claude-console-authentication) для настройки.

530* Если вы администратор и не видите опцию для включения доступа, свяжитесь с [Anthropic support](https://support.claude.com)530* Если вы администратор и не видите опцию для включения доступа, свяжитесь с [Anthropic support](https://support.claude.com)

531 531 

532<h3 id="routines-are-disabled-by-your-organizations-policy">532<h3 id="routines-are-disabled-by-your-organizations-policy">

533 Routines are disabled by your organization's policy533 Routines are disabled by your organization's policy

534</h3>534</h3>

535 535 

536Владелец в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, включая из `/schedule` и пользовательского интерфейса [Routines](/ru/routines) на claude.ai/code.536Владелец в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, включая из `/schedule` и пользовательского интерфейса [Routines](/docs/ru/routines) на claude.ai/code.

537 537 

538```text theme={null}538```text theme={null}

539Routines are disabled by your organization's policy.539Routines are disabled by your organization's policy.


544**Что делать:**544**Что делать:**

545 545 

546* Попросите владельца в вашей организации включить переключатель **Routines** на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)546* Попросите владельца в вашей организации включить переключатель **Routines** на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)

547* Для одноразовой запланированной работы, которая не требует routines на уровне организации, см. [scheduled tasks](/ru/scheduled-tasks)547* Для одноразовой запланированной работы, которая не требует routines на уровне организации, см. [scheduled tasks](/docs/ru/scheduled-tasks)

548 548 

549<h3 id="remote-control-requires-the-anthropic-api">549<h3 id="remote-control-requires-the-anthropic-api">

550 Remote Control requires the Anthropic API550 Remote Control requires the Anthropic API

551</h3>551</h3>

552 552 

553Сеанс не взаимодействует с Anthropic API напрямую, поэтому нет бэкенда claude.ai для [Remote Control](/ru/remote-control) для сопряжения.553Сеанс не взаимодействует с Anthropic API напрямую, поэтому нет бэкенда claude.ai для [Remote Control](/docs/ru/remote-control) для сопряжения.

554 554 

555```text theme={null}555```text theme={null}

556Remote Control is only available when using Claude via api.anthropic.com.556Remote Control is only available when using Claude via api.anthropic.com.

557```557```

558 558 

559Это появляется на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, это также появляется, когда [`ANTHROPIC_BASE_URL`](/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/ru/llm-gateway) или прокси, даже если вы входите с claude.ai.559Это появляется на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Начиная с версии 2.1.196, это также появляется, когда [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/docs/ru/llm-gateway) или прокси, даже если вы входите с claude.ai.

560 560 

561**Что делать:**561**Что делать:**

562 562 

563* Отмените установку `ANTHROPIC_BASE_URL` и перезагрузите сеанс, или запустите Remote Control из сеанса, который взаимодействует с Anthropic API напрямую563* Отмените установку `ANTHROPIC_BASE_URL` и перезагрузите сеанс, или запустите Remote Control из сеанса, который взаимодействует с Anthropic API напрямую

564* Для этого и других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/ru/remote-control#troubleshooting)564* Для этого и других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)

565 565 

566<h3 id="oauth-token-revoked-or-expired">566<h3 id="oauth-token-revoked-or-expired">

567 OAuth token revoked or expired567 OAuth token revoked or expired


581 581 

582* Запустите `/login` для повторного входа582* Запустите `/login` для повторного входа

583* Если ошибка возвращается в том же сеансе после повторной аутентификации, сначала запустите `/logout` для полной очистки сохраненного токена, затем `/login`583* Если ошибка возвращается в том же сеансе после повторной аутентификации, сначала запустите `/logout` для полной очистки сохраненного токена, затем `/login`

584* Для повторных запросов на вход при запусках см. проверки системных часов и macOS Keychain в [Troubleshooting](/ru/troubleshoot-install#not-logged-in-or-token-expired)584* Для повторных запросов на вход при запусках см. проверки системных часов и macOS Keychain в [Troubleshooting](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired)

585* Для других сбоев, включая `403 Forbidden` и проблемы с браузером OAuth, см. [Login and authentication](/ru/troubleshoot-install#login-and-authentication)585* Для других сбоев, включая `403 Forbidden` и проблемы с браузером OAuth, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)

586 586 

587<h3 id="login-expired">587<h3 id="login-expired">

588 Login expired588 Login expired

589</h3>589</h3>

590 590 

591Claude Code попытался обновить ваш сохраненный вход claude.ai или Claude Console, и служба OAuth отклонила сохраненный токен обновления, поэтому Claude Code очистила сохраненные учетные данные. После этого каждый запрос останавливается локально перед тем, как достичь API, потому что только `/login` может создать новые учетные данные. {/* min-version: 2.1.206 */}До версии 2.1.206 Claude Code отправляла запрос в любом случае с любыми учетными данными, оставшимися в окружении, и каждая модель затем не выполнялась с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) или 401 вместо запроса на вход.591Claude Code попытался обновить ваш сохраненный вход claude.ai или Claude Console, и служба OAuth отклонила сохраненный токен обновления, поэтому Claude Code очистила сохраненные учетные данные. После этого каждый запрос останавливается локально перед тем, как достичь API, потому что только `/login` может создать новые учетные данные. До версии 2.1.206 Claude Code отправляла запрос в любом случае с любыми учетными данными, оставшимися в окружении, и каждая модель затем не выполнялась с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) или 401 вместо запроса на вход.

592 592 

593```text theme={null}593```text theme={null}

594Login expired · Please run /login594Login expired · Please run /login

595```595```

596 596 

597В [non-interactive mode](/ru/headless) (`-p`) и [Agent SDK](/ru/agent-sdk/overview) сообщение читается следующим образом, и код структурированной ошибки — `authentication_failed`:597В [non-interactive mode](/docs/ru/headless) (`-p`) и [Agent SDK](/docs/ru/agent-sdk/overview) сообщение читается следующим образом, и код структурированной ошибки — `authentication_failed`:

598 598 

599```text theme={null}599```text theme={null}

600Failed to authenticate: OAuth session expired and could not be refreshed600Failed to authenticate: OAuth session expired and could not be refreshed


602 602 

603Это не то же состояние, что [OAuth token revoked or expired](#oauth-token-revoked-or-expired). Эти сообщения сообщают о 401, который вернул API. Claude Code сама создает `Login expired` для входа, который она уже не смогла обновить, поэтому она не отправляет запрос.603Это не то же состояние, что [OAuth token revoked or expired](#oauth-token-revoked-or-expired). Эти сообщения сообщают о 401, который вернул API. Claude Code сама создает `Login expired` для входа, который она уже не смогла обновить, поэтому она не отправляет запрос.

604 604 

605Сеансы, аутентифицированные с помощью ключа API, [`CLAUDE_CODE_OAUTH_TOKEN`](/ru/env-vars) или поставщика третьей стороны, не используют сохраненный вход и никогда не видят это сообщение.605Сеансы, аутентифицированные с помощью ключа API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars) или поставщика третьей стороны, не используют сохраненный вход и никогда не видят это сообщение.

606 606 

607**Что делать:**607**Что делать:**

608 608 

609* Запустите `/login` для повторного входа. Повторная попытка без входа показывает то же сообщение при каждом запросе.609* Запустите `/login` для повторного входа. Повторная попытка без входа показывает то же сообщение при каждом запросе.

610* В неинтерактивном режиме запустите `claude` в том же окружении, завершите `/login`, затем повторно запустите вашу команду. Для автоматизации, которая не может войти интерактивно, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или [generate a long-lived token with `claude setup-token`](/ru/authentication#generate-a-long-lived-token).610* В неинтерактивном режиме запустите `claude` в том же окружении, завершите `/login`, затем повторно запустите вашу команду. Для автоматизации, которая не может войти интерактивно, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или [generate a long-lived token with `claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token).

611* Если вход продолжает не выполняться, см. [Login and authentication](/ru/troubleshoot-install#login-and-authentication)611* Если вход продолжает не выполняться, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)

612 612 

613<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">

614 OAuth scope requirement614 OAuth scope requirement


628 AWS credentials expired or invalid628 AWS credentials expired or invalid

629</h3>629</h3>

630 630 

631{/* min-version: 2.1.198 */}Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда [`awsAuthRefresh`](/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш токен сеанса AWS истек или был отклонен, и автоматическое обновление, которое уже запустил Claude Code, не создало учетные данные, которые API принимает. Это появляется при 401 от [Claude Platform on AWS](/ru/claude-platform-on-aws) или [Mantle endpoint](/ru/amazon-bedrock#use-the-mantle-endpoint), что является тем, как эти провайдеры сообщают об истекшем токене безопасности.631Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш токен сеанса AWS истек или был отклонен, и автоматическое обновление, которое уже запустил Claude Code, не создало учетные данные, которые API принимает. Это появляется при 401 от [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), что является тем, как эти провайдеры сообщают об истекшем токене безопасности.

632 632 

633Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это начальная `AWS credentials expired or invalid`:633Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это начальная `AWS credentials expired or invalid`:

634 634 


641**Что делать:**641**Что делать:**

642 642 

643* Запустите команду `awsAuthRefresh`, названную в сообщении, такую как `aws sso login --profile myprofile`, в другом терминале и завершите вход в браузер, затем повторите попытку643* Запустите команду `awsAuthRefresh`, названную в сообщении, такую как `aws sso login --profile myprofile`, в другом терминале и завершите вход в браузер, затем повторите попытку

644* В интерактивном сеансе запустите `/login`, выберите **3rd-party platform**, затем выберите **Claude Platform on AWS · refresh credentials** в разделе **Using 3rd-party platforms** для запуска той же команды без перезагрузки Claude Code. См. [Configure AWS credentials](/ru/claude-platform-on-aws#1-configure-aws-credentials)644* В интерактивном сеансе запустите `/login`, выберите **3rd-party platform**, затем выберите **Claude Platform on AWS · refresh credentials** в разделе **Using 3rd-party platforms** для запуска той же команды без перезагрузки Claude Code. См. [Configure AWS credentials](/docs/ru/claude-platform-on-aws#1-configure-aws-credentials)

645* Если ошибка повторяется после успешного выполнения команды обновления, подтвердите, что идентификатор действителен вне Claude Code с помощью `aws sts get-caller-identity` в той же оболочке и профиле645* Если ошибка повторяется после успешного выполнения команды обновления, подтвердите, что идентификатор действителен вне Claude Code с помощью `aws sts get-caller-identity` в той же оболочке и профиле

646 646 

647<h3 id="aws-authentication-failed">647<h3 id="aws-authentication-failed">

648 AWS authentication failed648 AWS authentication failed

649</h3>649</h3>

650 650 

651{/* min-version: 2.1.198 */}Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда [`awsAuthRefresh`](/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш провайдер AWS вернул 403, или [Amazon Bedrock](/ru/amazon-bedrock) вернул 401.651Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш провайдер AWS вернул 403, или [Amazon Bedrock](/docs/ru/amazon-bedrock) вернул 401.

652 652 

653Claude Code не может определить, какую причину вы получили. Amazon Bedrock сообщает об истекшем токене безопасности как 403, но 403 также является тем, как он сообщает об отказе в авторизации, такой как `AccessDeniedException` из-за отсутствующего разрешения IAM или модели, которая не включена для вашей учетной записи.653Claude Code не может определить, какую причину вы получили. Amazon Bedrock сообщает об истекшем токене безопасности как 403, но 403 также является тем, как он сообщает об отказе в авторизации, такой как `AccessDeniedException` из-за отсутствующего разрешения IAM или модели, которая не включена для вашей учетной записи.

654 654 


665**Что делать:**665**Что делать:**

666 666 

667* Запустите команду `awsAuthRefresh`, названную в сообщении, или `aws sso login`, на случай, если причиной является истекшие учетные данные667* Запустите команду `awsAuthRefresh`, названную в сообщении, или `aws sso login`, на случай, если причиной является истекшие учетные данные

668* Если ваши учетные данные актуальны, подтвердите, что разрешения IAM в [IAM configuration](/ru/amazon-bedrock#iam-configuration) присоединены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона668* Если ваши учетные данные актуальны, подтвердите, что разрешения IAM в [IAM configuration](/docs/ru/amazon-bedrock#iam-configuration) присоединены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона

669* Запустите `aws sts get-caller-identity` для подтверждения того, какой идентификатор используют ваши запросы; устаревший `AWS_PROFILE` или профиль по умолчанию — это частая причина несоответствия разрешений669* Запустите `aws sts get-caller-identity` для подтверждения того, какой идентификатор используют ваши запросы; устаревший `AWS_PROFILE` или профиль по умолчанию — это частая причина несоответствия разрешений

670 670 

671<h3 id="aws-default-chain-credential-resolve-timed-out">671<h3 id="aws-default-chain-credential-resolve-timed-out">

672 AWS default-chain credential resolve timed out672 AWS default-chain credential resolve timed out

673</h3>673</h3>

674 674 

675Цепь поставщика учетных данных AWS по умолчанию не создала учетные данные в течение 60 секунд, поэтому Claude Code остановила разрешение и не выполнила запрос. Сбой — это локальное разрешение учетных данных: запрос никогда не достиг [Amazon Bedrock](/ru/amazon-bedrock), [Claude Platform on AWS](/ru/claude-platform-on-aws) или [Mantle endpoint](/ru/amazon-bedrock#use-the-mantle-endpoint). Claude Code очищает свой [credential cache](/ru/amazon-bedrock#credential-caching-and-resolution-timeout) и повторяет попытку перед тем, как эта ошибка проявляется, поэтому к тому времени, когда вы ее видите, цепь зависла при повторных попытках.675Цепь поставщика учетных данных AWS по умолчанию не создала учетные данные в течение 60 секунд, поэтому Claude Code остановила разрешение и не выполнила запрос. Сбой — это локальное разрешение учетных данных: запрос никогда не достиг [Amazon Bedrock](/docs/ru/amazon-bedrock), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Claude Code очищает свой [credential cache](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout) и повторяет попытку перед тем, как эта ошибка проявляется, поэтому к тому времени, когда вы ее видите, цепь зависла при повторных попытках.

676 676 

677```text theme={null}677```text theme={null}

678API Error: AWS default-chain credential resolve timed out678API Error: AWS default-chain credential resolve timed out

679```679```

680 680 

681Частые причины — это команда `credential_process` в вашем профиле AWS, которая ждет входа, который она не может получить, и контейнер или виртуальная машина, служба метаданных экземпляра (IMDS) которых никогда не отвечает на зонд цепи. {/* min-version: 2.1.207 */}До версии 2.1.207 зависшая цепь оставляла запрос ожидающим неопределенно долго вместо того, чтобы не выполняться с этим сообщением.681Частые причины — это команда `credential_process` в вашем профиле AWS, которая ждет входа, который она не может получить, и контейнер или виртуальная машина, служба метаданных экземпляра (IMDS) которых никогда не отвечает на зонд цепи. До версии 2.1.207 зависшая цепь оставляла запрос ожидающим неопределенно долго вместо того, чтобы не выполняться с этим сообщением.

682 682 

683**Что делать:**683**Что делать:**

684 684 

685* Запустите `aws sts get-caller-identity` в той же оболочке с тем же `AWS_PROFILE`. Если он также зависает, исправьте профиль; команда `credential_process`, которая запрашивает интерактивно, — это частая причина.685* Запустите `aws sts get-caller-identity` в той же оболочке с тем же `AWS_PROFILE`. Если он также зависает, исправьте профиль; команда `credential_process`, которая запрашивает интерактивно, — это частая причина.

686* Завершите шаг входа перед запуском Claude Code, например `aws sso login --profile myprofile`, чтобы цепь разрешилась из локального кэша SSO вместо ожидания потока браузера686* Завершите шаг входа перед запуском Claude Code, например `aws sso login --profile myprofile`, чтобы цепь разрешилась из локального кэша SSO вместо ожидания потока браузера

687* Если ваша цепь запускает интерактивный вход, который законно требует более 60 секунд, такой как SSO с MFA через оболочку, как `aws-vault`, повысьте лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/ru/env-vars)687* Если ваша цепь запускает интерактивный вход, который законно требует более 60 секунд, такой как SSO с MFA через оболочку, как `aws-vault`, повысьте лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars)

688 688 

689<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">

690 Ошибки сети и подключения690 Ошибки сети и подключения


712**Что делать:**712**Что делать:**

713 713 

714* Убедитесь, что вы можете достичь хоста API из той же оболочки, выполнив `curl -I https://api.anthropic.com`. В Windows PowerShell используйте `curl.exe -I https://api.anthropic.com`, чтобы встроенный псевдоним `Invoke-WebRequest` не использовался.714* Убедитесь, что вы можете достичь хоста API из той же оболочки, выполнив `curl -I https://api.anthropic.com`. В Windows PowerShell используйте `curl.exe -I https://api.anthropic.com`, чтобы встроенный псевдоним `Invoke-WebRequest` не использовался.

715* Если вы находитесь за корпоративным прокси, установите `HTTPS_PROXY` перед запуском Claude Code и см. [Конфигурация сети](/ru/network-config)715* Если вы находитесь за корпоративным прокси, установите `HTTPS_PROXY` перед запуском Claude Code и см. [Конфигурация сети](/docs/ru/network-config)

716* Если вы маршрутизируете через шлюз LLM или ретранслятор, установите [`ANTHROPIC_BASE_URL`](/ru/env-vars) на его адрес. См. [Подключение Claude Code к шлюзу LLM](/ru/llm-gateway-connect) для настройки.716* Если вы маршрутизируете через шлюз LLM или ретранслятор, установите [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) на его адрес. См. [Подключение Claude Code к шлюзу LLM](/docs/ru/llm-gateway-connect) для настройки.

717* Убедитесь, что ваш брандмауэр разрешает хосты, указанные в [Требования к доступу в сеть](/ru/network-config#network-access-requirements)717* Убедитесь, что ваш брандмауэр разрешает хосты, указанные в [Требования к доступу в сеть](/docs/ru/network-config#network-access-requirements)

718* Перебойные сбои [автоматически повторяются](#automatic-retries); постоянные сбои указывают на локальную проблему с сетью718* Перебойные сбои [автоматически повторяются](#automatic-retries); постоянные сбои указывают на локальную проблему с сетью

719 719 

720Если `curl` работает успешно, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:720Если `curl` работает успешно, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:


727 Bedrock streaming response has an unexpected content-type727 Bedrock streaming response has an unexpected content-type

728</h3>728</h3>

729 729 

730Шлюз или прокси между Claude Code и [Amazon Bedrock](/ru/amazon-bedrock) преобразует тело потокового ответа или его заголовок `Content-Type`. Amazon Bedrock передаёт ответы потоком как `application/vnd.amazon.eventstream`, и Claude Code отклоняет успешный потоковый ответ, который сообщает о другом типе содержимого вместо декодирования тела, которое он не может прочитать. Запрос не повторяется.730Шлюз или прокси между Claude Code и [Amazon Bedrock](/docs/ru/amazon-bedrock) преобразует тело потокового ответа или его заголовок `Content-Type`. Amazon Bedrock передаёт ответы потоком как `application/vnd.amazon.eventstream`, и Claude Code отклоняет успешный потоковый ответ, который сообщает о другом типе содержимого вместо декодирования тела, которое он не может прочитать. Запрос не повторяется.

731 731 

732```text theme={null}732```text theme={null}

733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

734```734```

735 735 

736{/* min-version: 2.1.208 */}До версии 2.1.208 та же неправильная конфигурация проявлялась как `API Error: Truncated event message received` после того, как весь ответ был буферизирован.736До версии 2.1.208 та же неправильная конфигурация проявлялась как `API Error: Truncated event message received` после того, как весь ответ был буферизирован.

737 737 

738**Что делать:**738**Что делать:**

739 739 

740* Настройте шлюз для передачи тела ответа `InvokeModelWithResponseStream` и его заголовка `Content-Type` без изменений. Промежуточный узел, который повторно отправляет поток как события, отправляемые сервером, является распространённой причиной.740* Настройте шлюз для передачи тела ответа `InvokeModelWithResponseStream` и его заголовка `Content-Type` без изменений. Промежуточный узел, который повторно отправляет поток как события, отправляемые сервером, является распространённой причиной.

741* Если шлюз переписывает только заголовок и передаёт двоичное тело без изменений, установите [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/ru/env-vars) для пропуска проверки до исправления шлюза. См. [Ошибки потоковой передачи за шлюзом или прокси](/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).741* Если шлюз переписывает только заголовок и передаёт двоичное тело без изменений, установите [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/ru/env-vars) для пропуска проверки до исправления шлюза. См. [Ошибки потоковой передачи за шлюзом или прокси](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).

742 742 

743<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">

744 SSL certificate errors744 SSL certificate errors


751Unable to connect to API: Self-signed certificate detected751Unable to connect to API: Self-signed certificate detected

752```752```

753 753 

754{/* min-version: 2.1.199 */}Начиная с версии 2.1.199, сбой проверки сертификата не повторяется, поэтому эта ошибка появляется при первой попытке вместо того, чтобы появиться после полного [бюджета повторных попыток](#automatic-retries). Более ранние версии потратили несколько минут на повторные попытки перед её отображением. Переходящие условия TLS, такие как истечение времени ожидания при установлении соединения, всё ещё повторяются.754Начиная с версии 2.1.199, сбой проверки сертификата не повторяется, поэтому эта ошибка появляется при первой попытке вместо того, чтобы появиться после полного [бюджета повторных попыток](#automatic-retries). Более ранние версии потратили несколько минут на повторные попытки перед её отображением. Переходящие условия TLS, такие как истечение времени ожидания при установлении соединения, всё ещё повторяются.

755 755 

756Во время `/login` и проверки подключения при запуске тот же сбой сообщается с кодом OpenSSL и исправлением в строке:756Во время `/login` и проверки подключения при запуске тот же сбой сообщается с кодом OpenSSL и исправлением в строке:

757 757 


762**Что делать:**762**Что делать:**

763 763 

764* Экспортируйте пакет CA вашей организации и укажите Claude Code на него с помощью `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`764* Экспортируйте пакет CA вашей организации и укажите Claude Code на него с помощью `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`

765* См. [Конфигурация сети](/ru/network-config#custom-ca-certificates) для полных инструкций по настройке765* См. [Конфигурация сети](/docs/ru/network-config#custom-ca-certificates) для полных инструкций по настройке

766* Не устанавливайте `NODE_TLS_REJECT_UNAUTHORIZED=0`, что полностью отключает проверку сертификата766* Не устанавливайте `NODE_TLS_REJECT_UNAUTHORIZED=0`, что полностью отключает проверку сертификата

767 767 

768<h3 id="host-not-allowed-in-a-cloud-session">768<h3 id="host-not-allowed-in-a-cloud-session">


778 778 

779Вы также можете увидеть сертификат TLS, который не соответствует реальному сертификату пункта назначения. Облачная среда маршрутизирует исходящий трафик через прокси, который применяет политику сети, поэтому несоответствующий сертификат означает, что прокси завершил соединение, а не пункт назначения.779Вы также можете увидеть сертификат TLS, который не соответствует реальному сертификату пункта назначения. Облачная среда маршрутизирует исходящий трафик через прокси, который применяет политику сети, поэтому несоответствующий сертификат означает, что прокси завершил соединение, а не пункт назначения.

780 780 

781Это не проблема сети на стороне клиента. Облачные сессии и [подпрограммы](/ru/routines) работают внутри изолированной среды, исходящий трафик которой фильтруется в соответствии со списком разрешений среды. Среда **Default** использует доступ **Trusted**, который разрешает [список разрешений по умолчанию](/ru/claude-code-on-the-web#default-allowed-domains) реестров пакетов, API поставщиков облачных услуг, реестров контейнеров и распространённых доменов разработки, но блокирует всё остальное.781Это не проблема сети на стороне клиента. Облачные сессии и [подпрограммы](/docs/ru/routines) работают внутри изолированной среды, исходящий трафик которой фильтруется в соответствии со списком разрешений среды. Среда **Default** использует доступ **Trusted**, который разрешает [список разрешений по умолчанию](/docs/ru/claude-code-on-the-web#default-allowed-domains) реестров пакетов, API поставщиков облачных услуг, реестров контейнеров и распространённых доменов разработки, но блокирует всё остальное.

782 782 

783**Что делать:**783**Что делать:**

784 784 

785* Откройте подпрограмму для редактирования или запустите облачную сессию. Выберите облачный значок, показывающий имя вашей среды, например **Default**, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.785* Откройте подпрограмму для редактирования или запустите облачную сессию. Выберите облачный значок, показывающий имя вашей среды, например **Default**, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.

786* В диалоговом окне **Update cloud environment** измените **Network access** с **Trusted** на **Custom**, затем добавьте заблокированный домен в **Allowed domains**. Введите один домен в строку. Установите флажок **Also include default list of common package managers**, чтобы сохранить [список разрешений по умолчанию](/ru/claude-code-on-the-web#default-allowed-domains) вместе с вашими пользовательскими доменами. Выберите **Full** вместо этого, если вы хотите неограниченный доступ.786* В диалоговом окне **Update cloud environment** измените **Network access** с **Trusted** на **Custom**, затем добавьте заблокированный домен в **Allowed domains**. Введите один домен в строку. Установите флажок **Also include default list of common package managers**, чтобы сохранить [список разрешений по умолчанию](/docs/ru/claude-code-on-the-web#default-allowed-domains) вместе с вашими пользовательскими доменами. Выберите **Full** вместо этого, если вы хотите неограниченный доступ.

787* Нажмите **Save changes**. Следующий запуск использует обновленный список разрешений.787* Нажмите **Save changes**. Следующий запуск использует обновленный список разрешений.

788 788 

789См. [Доступ в сеть](/ru/claude-code-on-the-web#network-access) для уровней доступа и списка разрешений по умолчанию. Локальные сессии CLI не затронуты этой политикой.789См. [Доступ в сеть](/docs/ru/claude-code-on-the-web#network-access) для уровней доступа и списка разрешений по умолчанию. Локальные сессии CLI не затронуты этой политикой.

790 790 

791<h3 id="couldnt-reconnect-to-your-remote-control-session">791<h3 id="couldnt-reconnect-to-your-remote-control-session">

792 Couldn't reconnect to your Remote Control session792 Couldn't reconnect to your Remote Control session


796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

797```797```

798 798 

799Возобновление с помощью `claude --resume` или `claude --continue` переподключается к сессии [Remote Control](/ru/remote-control), записанной в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённая сессия. Ваша локальная сессия продолжает работать без Remote Control.799Возобновление с помощью `claude --resume` или `claude --continue` переподключается к сессии [Remote Control](/docs/ru/remote-control), записанной в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённая сессия. Ваша локальная сессия продолжает работать без Remote Control.

800 800 

801**Что делать:**801**Что делать:**

802 802 

803* Запустите `/remote-control` для повторной попытки подключения803* Запустите `/remote-control` для повторной попытки подключения

804* Запустите Claude Code без `--resume` для создания новой сессии Remote Control804* Запустите Claude Code без `--resume` для создания новой сессии Remote Control

805* Для других сообщений при запуске Remote Control см. [Troubleshoot Remote Control](/ru/remote-control#troubleshooting)805* Для других сообщений при запуске Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)

806 806 

807Вы не увидите это сообщение, когда сервер подтвердит, что предыдущая сессия больше не существует; Claude Code создаст новую в этом случае. {/* min-version: 2.1.200 */}До версии 2.1.200 любой сбой переподключения создавал новую сессию Remote Control, которая оставляла дополнительные сессии в списке сессий на claude.ai/code.807Вы не увидите это сообщение, когда сервер подтвердит, что предыдущая сессия больше не существует; Claude Code создаст новую в этом случае. До версии 2.1.200 любой сбой переподключения создавал новую сессию Remote Control, которая оставляла дополнительные сессии в списке сессий на claude.ai/code.

808 808 

809<h2 id="request-errors">809<h2 id="request-errors">

810 Ошибки запроса810 Ошибки запроса


827* Запустите `/compact` для суммирования предыдущих ходов и освобождения места, или `/clear` для начала заново827* Запустите `/compact` для суммирования предыдущих ходов и освобождения места, или `/clear` для начала заново

828* Запустите `/context` для просмотра разбивки того, что потребляет окно: системный prompt, инструменты, файлы памяти и сообщения828* Запустите `/context` для просмотра разбивки того, что потребляет окно: системный prompt, инструменты, файлы памяти и сообщения

829* Отключите MCP серверы, которые вы не используете, с помощью `/mcp disable <name>` для удаления их определений инструментов из контекста829* Отключите MCP серверы, которые вы не используете, с помощью `/mcp disable <name>` для удаления их определений инструментов из контекста

830* Обрежьте большие файлы памяти `CLAUDE.md`, или переместите инструкции в [правила с областью действия пути](/ru/memory#path-specific-rules), которые загружаются только при необходимости830* Обрежьте большие файлы памяти `CLAUDE.md`, или переместите инструкции в [правила с областью действия пути](/docs/ru/memory#path-specific-rules), которые загружаются только при необходимости

831* Подагенты наследуют каждое определение инструмента MCP из родительской сессии, что может заполнить их контекстное окно до первого хода. Отключите MCP серверы, которые вы не используете, перед созданием подагентов.831* Подагенты наследуют каждое определение инструмента MCP из родительской сессии, что может заполнить их контекстное окно до первого хода. Отключите MCP серверы, которые вы не используете, перед созданием подагентов.

832* Auto-compact включен по умолчанию и обычно предотвращает эту ошибку. Если вы установили [`DISABLE_AUTO_COMPACT`](/ru/env-vars), переактивируйте его или запустите `/compact` вручную перед заполнением окна.832* Auto-compact включен по умолчанию и обычно предотвращает эту ошибку. Если вы установили [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars), переактивируйте его или запустите `/compact` вручную перед заполнением окна.

833 833 

834Смотрите [Explore the context window](/ru/context-window) для интерактивного просмотра того, как заполняется контекст.834Смотрите [Explore the context window](/docs/ru/context-window) для интерактивного просмотра того, как заполняется контекст.

835 835 

836<h3 id="error-during-compaction-conversation-too-long">836<h3 id="error-during-compaction-conversation-too-long">

837 Error during compaction: Conversation too long837 Error during compaction: Conversation too long


879API Error: 400 ... image dimensions exceed max allowed size879API Error: 400 ... image dimensions exceed max allowed size

880```880```

881 881 

882{/* min-version: 2.1.142 */}Claude Code заменяет необработанное изображение текстовым заполнителем и повторяет попытку, поэтому последующие сообщения успешны. В версиях до 2.1.142 вставленное изображение могло остаться в разговоре и повторять одну и ту же ошибку при каждом последующем сообщении. Для восстановления в этих версиях нажмите Esc дважды и вернитесь на несколько ходов назад, пройдя ход, где было добавлено изображение.882Claude Code заменяет необработанное изображение текстовым заполнителем и повторяет попытку, поэтому последующие сообщения успешны. В версиях до 2.1.142 вставленное изображение могло остаться в разговоре и повторять одну и ту же ошибку при каждом последующем сообщении. Для восстановления в этих версиях нажмите Esc дважды и вернитесь на несколько ходов назад, пройдя ход, где было добавлено изображение.

883 883 

884**Что делать:**884**Что делать:**

885 885 


939 939 

940**Что делать:**940**Что делать:**

941 941 

942* Настройте ваш шлюз для пересылки заголовка `anthropic-beta`. Смотрите [feature pass-through](/ru/llm-gateway-protocol#feature-pass-through) для того, что шлюзы должны пересылать.942* Настройте ваш шлюз для пересылки заголовка `anthropic-beta`. Смотрите [feature pass-through](/docs/ru/llm-gateway-protocol#feature-pass-through) для того, что шлюзы должны пересылать.

943* В качестве резервного варианта установите [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ru/env-vars) перед запуском. Это отключает функции, которые требуют заголовка бета-версии, чтобы запросы успешно проходили через шлюз, который не может его пересылать.943* В качестве резервного варианта установите [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) перед запуском. Это отключает функции, которые требуют заголовка бета-версии, чтобы запросы успешно проходили через шлюз, который не может его пересылать.

944 944 

945<h3 id="theres-an-issue-with-the-selected-model">945<h3 id="theres-an-issue-with-the-selected-model">

946 There's an issue with the selected model946 There's an issue with the selected model


955**Что делать:**955**Что делать:**

956 956 

957* **Interactive CLI**: запустите `/model` для выбора из моделей, доступных вашей учётной записи.957* **Interactive CLI**: запустите `/model` для выбора из моделей, доступных вашей учётной записи.

958* **Non-interactive mode (`-p`)**: передайте `--model` с действительным псевдонимом или ID, или установите [`ANTHROPIC_MODEL`](/ru/env-vars). Текст ошибки показывает `Run --model` на этой поверхности.958* **Non-interactive mode (`-p`)**: передайте `--model` с действительным псевдонимом или ID, или установите [`ANTHROPIC_MODEL`](/docs/ru/env-vars). Текст ошибки показывает `Run --model` на этой поверхности.

959* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found` для отображения вашего собственного повтора или средства выбора модели.959* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/docs/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/docs/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found` для отображения вашего собственного повтора или средства выбора модели.

960* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите [Model configuration](/ru/model-config).960* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите [Model configuration](/docs/ru/model-config).

961* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте в [порядке приоритета](/ru/model-config#setting-your-model): флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, затем поле `model` в `.claude/settings.local.json`, файл вашего проекта `.claude/settings.json` и `~/.claude/settings.json`. Удалите устаревшее значение, и Claude Code вернётся к умолчанию вашей учётной записи.961* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте в [порядке приоритета](/docs/ru/model-config#setting-your-model): флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, затем поле `model` в `.claude/settings.local.json`, файл вашего проекта `.claude/settings.json` и `~/.claude/settings.json`. Удалите устаревшее значение, и Claude Code вернётся к умолчанию вашей учётной записи.

962* {/* min-version: 2.1.206 */}Claude Code сообщает об истёкшем входе claude.ai как [Login expired](#login-expired), а не как об этой ошибке. До v2.1.206 истёкший вход, который больше не удалось обновить, не удавался для каждой модели с этой ошибкой; запустите `/login`, если вы видите это в более старой версии.962* Claude Code сообщает об истёкшем входе claude.ai как [Login expired](#login-expired), а не как об этой ошибке. До v2.1.206 истёкший вход, который больше не удалось обновить, не удавался для каждой модели с этой ошибкой; запустите `/login`, если вы видите это в более старой версии.

963* Для развёртываний Google Cloud's Agent Platform смотрите [Google Cloud's Agent Platform troubleshooting](/ru/google-vertex-ai#troubleshooting).963* Для развёртываний Google Cloud's Agent Platform смотрите [Google Cloud's Agent Platform troubleshooting](/docs/ru/google-vertex-ai#troubleshooting).

964 964 

965<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">

966 Model is not a recognized model id966 Model is not a recognized model id


974 974 

975Конечная подсказка называет ближайший совпадающий псевдоним или ID модели. Когда ничего не совпадает достаточно близко, она читает `Run /model to see available models.` вместо этого.975Конечная подсказка называет ближайший совпадающий псевдоним или ID модели. Когда ничего не совпадает достаточно близко, она читает `Run /model to see available models.` вместо этого.

976 976 

977Claude Code производит эту ошибку локально в момент запроса переключения, перед любым запросом API. Она применяется, когда модель установлена через метод [Agent SDK](/ru/agent-sdk/typescript) `setModel()` или приложением, таким как [Desktop app](/ru/desktop), которое запускает Claude Code CLI для вас.977Claude Code производит эту ошибку локально в момент запроса переключения, перед любым запросом API. Она применяется, когда модель установлена через метод [Agent SDK](/docs/ru/agent-sdk/typescript) `setModel()` или приложением, таким как [Desktop app](/docs/ru/desktop), которое запускает Claude Code CLI для вас.

978 978 

979**Что делать:**979**Что делать:**

980 980 

981* Запустите `/model` без аргумента, чтобы открыть средство выбора и выбрать из моделей, доступных вашей учётной записи, затем передайте показанный там псевдоним или ID981* Запустите `/model` без аргумента, чтобы открыть средство выбора и выбрать из моделей, доступных вашей учётной записи, затем передайте показанный там псевдоним или ID

982* Если вы использовали псевдоним, который поддерживает более новая версия Claude Code, запустите `claude update`. Полный ID, который начинается с `claude-`, проходит эту проверку даже когда модель новее вашей версии Claude Code, поэтому обновление не требуется для них.982* Если вы использовали псевдоним, который поддерживает более новая версия Claude Code, запустите `claude update`. Полный ID, который начинается с `claude-`, проходит эту проверку даже когда модель новее вашей версии Claude Code, поэтому обновление не требуется для них.

983* Модель, сохранённая до v2.1.200, не восстанавливается этой проверкой. Если устаревшее значение продолжает возвращаться, удалите его из мест, перечисленных в [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).983* Модель, сохранённая до v2.1.200, не восстанавливается этой проверкой. Если устаревшее значение продолжает возвращаться, удалите его из мест, перечисленных в [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).

984* Проверка выполняется только на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/ru/claude-platform-on-aws) и за [LLM gateway](/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code принимает любую строку и пропускает её.984* Проверка выполняется только на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и за [LLM gateway](/docs/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code принимает любую строку и пропускает её.

985 985 

986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

987 Claude Opus is not available with the Claude Pro plan987 Claude Opus is not available with the Claude Pro plan


1003 Model is restricted by your organization's settings1003 Model is restricted by your organization's settings

1004</h3>1004</h3>

1005 1005 

1006Администратор вашей организации отключил эту модель в консоли администратора claude.ai, или она исключена [`availableModels`](/ru/model-config#restrict-model-selection) списком разрешений в управляемых параметрах. Когда ограниченная модель была установлена с `--model`, `ANTHROPIC_MODEL` или параметром `model`, Claude Code подставляет разрешённую модель и продолжает. Ввод `/model <name>` для ограниченной модели отклоняется с `Run /model to choose a different model.` и сессия сохраняет свою текущую модель.1006Администратор вашей организации отключил эту модель в консоли администратора claude.ai, или она исключена [`availableModels`](/docs/ru/model-config#restrict-model-selection) списком разрешений в управляемых параметрах. Когда ограниченная модель была установлена с `--model`, `ANTHROPIC_MODEL` или параметром `model`, Claude Code подставляет разрешённую модель и продолжает. Ввод `/model <name>` для ограниченной модели отклоняется с `Run /model to choose a different model.` и сессия сохраняет свою текущую модель.

1007 1007 

1008```text theme={null}1008```text theme={null}

1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

1010```1010```

1011 1011 

1012Claude Code рассматривает псевдоним семейства моделей, один из `opus`, `sonnet`, `haiku` или `fable`, как запрос для этого семейства, а не для его новейшей версии. На Anthropic API и на [Claude Platform on AWS](/ru/claude-platform-on-aws) ограниченный псевдоним семейства разрешается в новейшую версию семейства, которую разрешают ваша организация и список разрешений `availableModels`, и уведомление о подстановке называет эту версию. Claude Code отклоняет `/model <alias>` только когда каждая версия семейства ограничена. До v2.1.205 псевдоним семейства был подставлен или отклонен на основе только его новейшей версии, даже когда была разрешена более старая версия того же семейства.1012Claude Code рассматривает псевдоним семейства моделей, один из `opus`, `sonnet`, `haiku` или `fable`, как запрос для этого семейства, а не для его новейшей версии. На Anthropic API и на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) ограниченный псевдоним семейства разрешается в новейшую версию семейства, которую разрешают ваша организация и список разрешений `availableModels`, и уведомление о подстановке называет эту версию. Claude Code отклоняет `/model <alias>` только когда каждая версия семейства ограничена. До v2.1.205 псевдоним семейства был подставлен или отклонен на основе только его новейшей версии, даже когда была разрешена более старая версия того же семейства.

1013 1013 

1014**Что делать:**1014**Что делать:**

1015 1015 

1016* Запустите `/model` для выбора из моделей, которые разрешает ваша организация. Ограниченные модели скрыты от средства выбора.1016* Запустите `/model` для выбора из моделей, которые разрешает ваша организация. Ограниченные модели скрыты от средства выбора.

1017* Если ограниченная модель была установлена в `--model`, `ANTHROPIC_MODEL` или поле `model` файла параметров, удалите или обновите это значение, чтобы уведомление не повторялось при каждом запуске1017* Если ограниченная модель была установлена в `--model`, `ANTHROPIC_MODEL` или поле `model` файла параметров, удалите или обновите это значение, чтобы уведомление не повторялось при каждом запуске

1018* Если вам нужен доступ к ограниченной модели, попросите администратора вашей организации включить её. Смотрите [Organization model restrictions](/ru/model-config#organization-model-restrictions).1018* Если вам нужен доступ к ограниченной модели, попросите администратора вашей организации включить её. Смотрите [Organization model restrictions](/docs/ru/model-config#organization-model-restrictions).

1019 1019 

1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

1021 thinking.type.enabled is not supported for this model1021 thinking.type.enabled is not supported for this model


1031 1031 

1032* Запустите `claude update` и перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже1032* Запустите `claude update` и перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже

1033* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого1033* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого

1034* {/* min-version: agent-sdk@0.3.197 */}Если вы столкнулись с этим в [Agent SDK](/ru/agent-sdk/overview), обновите пакет SDK вместо этого. Opus 4.8 требует TypeScript SDK v0.3.154 или позже и Python SDK v0.2.88 или позже. Sonnet 5 требует TypeScript SDK v0.3.197 или позже1034* Если вы столкнулись с этим в [Agent SDK](/docs/ru/agent-sdk/overview), обновите пакет SDK вместо этого. Opus 4.8 требует TypeScript SDK v0.3.154 или позже и Python SDK v0.2.88 или позже. Sonnet 5 требует TypeScript SDK v0.3.197 или позже

1035 1035 

1036<h3 id="thinking-budget-exceeds-output-limit">1036<h3 id="thinking-budget-exceeds-output-limit">

1037 Thinking budget exceeds output limit1037 Thinking budget exceeds output limit


1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

1044```1044```

1045 1045 

1046Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Cloud's Agent Platform, когда [`MAX_THINKING_TOKENS`](/ru/env-vars) установлен выше лимита вывода поставщика, или когда режим плана повышает бюджет мышления.1046Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Cloud's Agent Platform, когда [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) установлен выше лимита вывода поставщика, или когда режим плана повышает бюджет мышления.

1047 1047 

1048**Что делать:**1048**Что делать:**

1049 1049 

1050* Понизьте `MAX_THINKING_TOKENS`, или повысьте [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/ru/env-vars) выше бюджета мышления1050* Понизьте `MAX_THINKING_TOKENS`, или повысьте [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ru/env-vars) выше бюджета мышления

1051* Смотрите [Extended thinking](/ru/model-config#extended-thinking) для того, как бюджет взаимодействует с длиной вывода1051* Смотрите [Extended thinking](/docs/ru/model-config#extended-thinking) для того, как бюджет взаимодействует с длиной вывода

1052 1052 

1053<h3 id="tool-use-or-thinking-block-mismatch">1053<h3 id="tool-use-or-thinking-block-mismatch">

1054 Tool use or thinking block mismatch1054 Tool use or thinking block mismatch


1066 1066 

1067**Что делать:**1067**Что делать:**

1068 1068 

1069* {/* max-version: 2.1.155 */}Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку при нормальном использовании инструмента, и `/rewind` её не очищает.1069* Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку при нормальном использовании инструмента, и `/rewind` её не очищает.

1070* Запустите `/rewind`, или нажмите Esc дважды, чтобы вернуться к контрольной точке перед повреждённым ходом и продолжить оттуда. Смотрите [Checkpointing](/ru/checkpointing) для того, как создаются и восстанавливаются контрольные точки.1070* Запустите `/rewind`, или нажмите Esc дважды, чтобы вернуться к контрольной точке перед повреждённым ходом и продолжить оттуда. Смотрите [Checkpointing](/docs/ru/checkpointing) для того, как создаются и восстанавливаются контрольные точки.

1071 1071 

1072<h3 id="usage-policy-refusal">1072<h3 id="usage-policy-refusal">

1073 Usage Policy refusal1073 Usage Policy refusal


1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

1080```1080```

1081 1081 

1082Проверка оценивает весь разговор, а не только ваш последний prompt, поэтому отправка нового сообщения в той же сессии обычно повторно вызывает тот же отказ. То же самое применяется после выхода и переоткрытия сессии с `--continue` или `--resume`, так как стенограмма на диске всё ещё содержит вызывающее содержимое. На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) и [Microsoft Foundry](/ru/microsoft-foundry) это сообщение также охватывает запросы, которые меры безопасности модели отметили как тему кибербезопасности. Смотрите [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).1082Проверка оценивает весь разговор, а не только ваш последний prompt, поэтому отправка нового сообщения в той же сессии обычно повторно вызывает тот же отказ. То же самое применяется после выхода и переоткрытия сессии с `--continue` или `--resume`, так как стенограмма на диске всё ещё содержит вызывающее содержимое. На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) это сообщение также охватывает запросы, которые меры безопасности модели отметили как тему кибербезопасности. Смотрите [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).

1083 1083 

1084**Что делать:**1084**Что делать:**

1085 1085 

1086* Нажмите Esc дважды или запустите `/rewind` для возврата к контрольной точке перед ходом, который вызвал отказ, затем переформулируйте или примите другой подход. Смотрите [Checkpointing](/ru/checkpointing).1086* Нажмите Esc дважды или запустите `/rewind` для возврата к контрольной точке перед ходом, который вызвал отказ, затем переформулируйте или примите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).

1087* Если вы не можете определить, какой ход вызвал это, запустите `/clear` для начала новой разговора в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в `/resume`.1087* Если вы не можете определить, какой ход вызвал это, запустите `/clear` для начала новой разговора в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в `/resume`.

1088* В [non-interactive mode](/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным prompt в новой сессии без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с `--model` также может разрешить отказ в некоторых случаях.1088* В [non-interactive mode](/docs/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным prompt в новой сессии без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с `--model` также может разрешить отказ в некоторых случаях.

1089 1089 

1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">

1091 Safety measures flagged a cybersecurity topic1091 Safety measures flagged a cybersecurity topic


1103 1103 

1104То, что вы видите, зависит от вашего поставщика и режима:1104То, что вы видите, зависит от вашего поставщика и режима:

1105 1105 

1106* На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) и [Microsoft Foundry](/ru/microsoft-foundry) флаг кибербезопасности производит сообщение [Usage Policy refusal](#usage-policy-refusal) вместо этого.1106* На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) флаг кибербезопасности производит сообщение [Usage Policy refusal](#usage-policy-refusal) вместо этого.

1107* [Non-interactive mode](/ru/headless) опускает предложение `/feedback`.1107* [Non-interactive mode](/docs/ru/headless) опускает предложение `/feedback`.

1108 1108 

1109{/* max-version: 2.1.202 */}До v2.1.203 сообщение читалось `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` с последующей ссылкой на форму исключения.1109До v2.1.203 сообщение читалось `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` с последующей ссылкой на форму исключения.

1110 1110 

1111**Что делать:**1111**Что делать:**

1112 1112 

1113* Если ваша работа требует этого содержимого, подайте заявку на доступ через [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)1113* Если ваша работа требует этого содержимого, подайте заявку на доступ через [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)

1114* Если ваш запрос не был о теме кибербезопасности, запустите `/feedback` для сообщения о ложном срабатывании1114* Если ваш запрос не был о теме кибербезопасности, запустите `/feedback` для сообщения о ложном срабатывании

1115* Чтобы продолжить работу в той же сессии, нажмите Esc дважды или запустите `/rewind` для возврата к контрольной точке перед ходом, который вызвал флаг, затем примите другой подход. Смотрите [Checkpointing](/ru/checkpointing).1115* Чтобы продолжить работу в той же сессии, нажмите Esc дважды или запустите `/rewind` для возврата к контрольной точке перед ходом, который вызвал флаг, затем примите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).

1116 1116 

1117<h2 id="installation-errors">1117<h2 id="installation-errors">

1118 Ошибки установки1118 Ошибки установки

1119</h2>1119</h2>

1120 1120 

1121Эти ошибки появляются при установке или обновлении Claude Code из [скрипта установки](/ru/setup#install-claude-code), `claude install` или `claude update`. Для проблем с `command not found`, PATH, разрешениями и TLS во время установки см. [Устранение неполадок установки и входа](/ru/troubleshoot-install).1121Эти ошибки появляются при установке или обновлении Claude Code из [скрипта установки](/docs/ru/setup#install-claude-code), `claude install` или `claude update`. Для проблем с `command not found`, PATH, разрешениями и TLS во время установки см. [Устранение неполадок установки и входа](/docs/ru/troubleshoot-install).

1122 1122 

1123<h3 id="installation-was-killed-before-it-could-finish">1123<h3 id="installation-was-killed-before-it-could-finish">

1124 Установка была прервана до завершения1124 Установка была прервана до завершения


1136**Что делать:**1136**Что делать:**

1137 1137 

1138* Остановите другие процессы, чтобы освободить память, затем повторно запустите установщик1138* Остановите другие процессы, чтобы освободить память, затем повторно запустите установщик

1139* Добавьте пространство подкачки или перейдите на экземпляр большего размера. См. [Установка прервана на серверах Linux с низким объёмом памяти](/ru/troubleshoot-install#install-killed-on-low-memory-linux-servers) для команд файла подкачки.1139* Добавьте пространство подкачки или перейдите на экземпляр большего размера. См. [Установка прервана на серверах Linux с низким объёмом памяти](/docs/ru/troubleshoot-install#install-killed-on-low-memory-linux-servers) для команд файла подкачки.

1140 1140 

1141<h3 id="the-connection-dropped-while-downloading-the-update">1141<h3 id="the-connection-dropped-while-downloading-the-update">

1142 Соединение разорвалось при загрузке обновления1142 Соединение разорвалось при загрузке обновления

1143</h3>1143</h3>

1144 1144 

1145Соединение с сервером загрузки закрылось, пока `claude install`, `claude update` или [автоматический обновитель](/ru/setup#auto-updates) загружал двоичный файл Claude Code, и повторные попытки не восстановили соединение. Claude Code повторяет загрузку, когда соединение разрывается, передача зависает или загруженный файл не проходит проверку контрольной суммы, всего до трёх попыток. Завершённая ошибка HTTP, такая как 404, не повторяется, потому что сервер уже ответил. {/* min-version: 2.1.202 */}До версии 2.1.202 одно разорванное соединение немедленно приводило к сбою загрузки с простой ошибкой `aborted` вместо повторной попытки.1145Соединение с сервером загрузки закрылось, пока `claude install`, `claude update` или [автоматический обновитель](/docs/ru/setup#auto-updates) загружал двоичный файл Claude Code, и повторные попытки не восстановили соединение. Claude Code повторяет загрузку, когда соединение разрывается, передача зависает или загруженный файл не проходит проверку контрольной суммы, всего до трёх попыток. Завершённая ошибка HTTP, такая как 404, не повторяется, потому что сервер уже ответил. До версии 2.1.202 одно разорванное соединение немедленно приводило к сбою загрузки с простой ошибкой `aborted` вместо повторной попытки.

1146 1146 

1147```text theme={null}1147```text theme={null}

1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.


1157**Что делать:**1157**Что делать:**

1158 1158 

1159* Запустите `claude update` снова. На в остальном здоровой сети загрузка обычно успешна при следующем запуске. Для сообщения об истечении времени запустите его снова из более быстрой или менее ограниченной сети.1159* Запустите `claude update` снова. На в остальном здоровой сети загрузка обычно успешна при следующем запуске. Для сообщения об истечении времени запустите его снова из более быстрой или менее ограниченной сети.

1160* Если ваша сеть требует прокси, установите `HTTPS_PROXY` перед запуском установщика или `claude update`. См. [Проверка подключения к сети](/ru/troubleshoot-install#check-network-connectivity).1160* Если ваша сеть требует прокси, установите `HTTPS_PROXY` перед запуском установщика или `claude update`. См. [Проверка подключения к сети](/docs/ru/troubleshoot-install#check-network-connectivity).

1161* Если корпоративный прокси продолжает закрывать передачу, попросите вашу команду сети разрешить полную загрузку с `downloads.claude.ai`. См. [Требования к доступу в сеть](/ru/network-config#network-access-requirements).1161* Если корпоративный прокси продолжает закрывать передачу, попросите вашу команду сети разрешить полную загрузку с `downloads.claude.ai`. См. [Требования к доступу в сеть](/docs/ru/network-config#network-access-requirements).

1162* Запустите `claude doctor` из вашей оболочки для диагностики установки1162* Запустите `claude doctor` из вашей оболочки для диагностики установки

1163 1163 

1164<h2 id="command-line-errors">1164<h2 id="command-line-errors">


1171 Конфликт между --bg и --print1171 Конфликт между --bg и --print

1172</h3>1172</h3>

1173 1173 

1174Это сообщение требует Claude Code v2.1.198 или позже. Вы объединили `--bg` с `-p` или `--print` в одном вызове `claude`. `--bg` запускает [фоновый сеанс](/ru/agent-view#from-your-shell), к которому вы позже подключаетесь с помощью `claude agents`, а `--print` запускает [неинтерактивно](/ru/headless) и никогда не запускает интерактивный сеанс, к которому подключается `claude agents`. До версии v2.1.198 эта комбинация молча создавала фоновое задание, которое никогда не могло быть подключено.1174Это сообщение требует Claude Code v2.1.198 или позже. Вы объединили `--bg` с `-p` или `--print` в одном вызове `claude`. `--bg` запускает [фоновый сеанс](/docs/ru/agent-view#from-your-shell), к которому вы позже подключаетесь с помощью `claude agents`, а `--print` запускает [неинтерактивно](/docs/ru/headless) и никогда не запускает интерактивный сеанс, к которому подключается `claude agents`. До версии v2.1.198 эта комбинация молча создавала фоновое задание, которое никогда не могло быть подключено.

1175 1175 

1176```text theme={null}1176```text theme={null}

1177--bg и --print конфликтуют: --print никогда не запускает интерактивный сеанс, к которому подключается `claude agents`, поэтому задание было бы недоступным. Запрос — это позиционный аргумент — удалите --print: `claude --bg '<task>'`.1177--bg и --print конфликтуют: --print никогда не запускает интерактивный сеанс, к которому подключается `claude agents`, поэтому задание было бы недоступным. Запрос — это позиционный аргумент — удалите --print: `claude --bg '<task>'`.


1179 1179 

1180**Что делать:**1180**Что делать:**

1181 1181 

1182* Удалите `-p` или `--print`. `--bg` принимает запрос в качестве позиционного аргумента, поэтому `claude --bg "<task>"` — это полная команда. См. [Dispatch new agents from your shell](/ru/agent-view#from-your-shell).1182* Удалите `-p` или `--print`. `--bg` принимает запрос в качестве позиционного аргумента, поэтому `claude --bg "<task>"` — это полная команда. См. [Dispatch new agents from your shell](/docs/ru/agent-view#from-your-shell).

1183* Чтобы запустить запрос неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`1183* Чтобы запустить запрос неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`

1184 1184 

1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

1186 Значение --json-schema не является допустимой JSON Schema1186 Значение --json-schema не является допустимой JSON Schema

1187</h3>1187</h3>

1188 1188 

1189Схема, которую вы передали в [`--json-schema`](/ru/cli-reference#cli-flags) в [неинтерактивном режиме](/ru/headless#get-structured-output), не прошла компиляцию JSON Schema, поэтому `claude` завершает работу с кодом 1 вместо запуска запроса. До версии v2.1.205 недопустимая схема выдавала неструктурированный вывод без ошибки, и любая схема, использующая ключевое слово `format`, считалась недопустимой.1189Схема, которую вы передали в [`--json-schema`](/docs/ru/cli-reference#cli-flags) в [неинтерактивном режиме](/docs/ru/headless#get-structured-output), не прошла компиляцию JSON Schema, поэтому `claude` завершает работу с кодом 1 вместо запуска запроса. До версии v2.1.205 недопустимая схема выдавала неструктурированный вывод без ошибки, и любая схема, использующая ключевое слово `format`, считалась недопустимой.

1190 1190 

1191```text theme={null}1191```text theme={null}

1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values


1200 1200 

1201* Исправьте часть схемы, которую указывает диагностика, затем повторно запустите команду1201* Исправьте часть схемы, которую указывает диагностика, затем повторно запустите команду

1202* Если диагностика — `schema too large`, уменьшите вложенность схемы и повторное использование `$ref`1202* Если диагностика — `schema too large`, уменьшите вложенность схемы и повторное использование `$ref`

1203* См. [Get structured output](/ru/headless#get-structured-output) для рабочей схемы и команды1203* См. [Get structured output](/docs/ru/headless#get-structured-output) для рабочей схемы и команды

1204 1204 

1205<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">

1206 Не удалось импортировать сервер из Claude Desktop1206 Не удалось импортировать сервер из Claude Desktop


1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

1213```1213```

1214 1214 

1215Текст после имени сервера — это причина. Наиболее распространённая — это проверка имени: Claude Desktop допускает символы в именах серверов, такие как пробелы и точки, которые `claude mcp` ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не прошла валидацию, и сервер, заблокированный [политикой MCP](/ru/managed-mcp) вашей организации.1215Текст после имени сервера — это причина. Наиболее распространённая — это проверка имени: Claude Desktop допускает символы в именах серверов, такие как пробелы и точки, которые `claude mcp` ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не прошла валидацию, и сервер, заблокированный [политикой MCP](/docs/ru/managed-mcp) вашей организации.

1216 1216 

1217**Что делать:**1217**Что делать:**

1218 1218 

1219* Переименуйте сервер в `claude_desktop_config.json`, используя только буквы, цифры, дефисы и подчёркивания, затем снова запустите `claude mcp add-from-claude-desktop`1219* Переименуйте сервер в `claude_desktop_config.json`, используя только буквы, цифры, дефисы и подчёркивания, затем снова запустите `claude mcp add-from-claude-desktop`

1220* Добавьте этот сервер напрямую с помощью `claude mcp add` или `claude mcp add-json` под допустимым именем. См. [Import MCP servers from Claude Desktop](/ru/mcp#import-mcp-servers-from-claude-desktop).1220* Добавьте этот сервер напрямую с помощью `claude mcp add` или `claude mcp add-json` под допустимым именем. См. [Import MCP servers from Claude Desktop](/docs/ru/mcp#import-mcp-servers-from-claude-desktop).

1221 1221 

1222<h3 id="mcp-permission-prompt-tool-not-found">1222<h3 id="mcp-permission-prompt-tool-not-found">

1223 Инструмент запроса разрешения MCP не найден1223 Инструмент запроса разрешения MCP не найден

1224</h3>1224</h3>

1225 1225 

1226Инструмент, который вы передали в [`--permission-prompt-tool`](/ru/cli-reference#cli-flags), не был среди подключённых инструментов MCP, когда запуск впервые нуждался в решении о разрешении, либо потому, что его сервер никогда не подключался, либо потому, что ни один подключённый сервер не предоставляет инструмент с таким именем. Claude Code по-прежнему отправляет ваш запрос: [неинтерактивный](/ru/headless) запуск завершается с этой ошибкой и кодом выхода 1 при первом вызове инструмента, который требует одобрения, поэтому он не выдаёт ответ, хотя запрос был сделан. Перед первым запросом Claude Code ждёт до 30 секунд, установленного [`MCP_TIMEOUT`](/ru/env-vars) для подключения этого сервера. {/* min-version: 2.1.206 */}До версии v2.1.206 запуск не ждал завершения подключения сервера, поэтому медленно запускающийся, но здоровый сервер также выдавал эту ошибку.1226Инструмент, который вы передали в [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags), не был среди подключённых инструментов MCP, когда запуск впервые нуждался в решении о разрешении, либо потому, что его сервер никогда не подключался, либо потому, что ни один подключённый сервер не предоставляет инструмент с таким именем. Claude Code по-прежнему отправляет ваш запрос: [неинтерактивный](/docs/ru/headless) запуск завершается с этой ошибкой и кодом выхода 1 при первом вызове инструмента, который требует одобрения, поэтому он не выдаёт ответ, хотя запрос был сделан. Перед первым запросом Claude Code ждёт до 30 секунд, установленного [`MCP_TIMEOUT`](/docs/ru/env-vars) для подключения этого сервера. До версии v2.1.206 запуск не ждал завершения подключения сервера, поэтому медленно запускающийся, но здоровый сервер также выдавал эту ошибку.

1227 1227 

1228```text theme={null}1228```text theme={null}

1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none


1235 1235 

1236* Проверьте, что сервер запускается и остаётся подключённым: запустите `claude mcp list` в том же каталоге и подтвердите, что сервер указан как подключённый1236* Проверьте, что сервер запускается и остаётся подключённым: запустите `claude mcp list` в том же каталоге и подтвердите, что сервер указан как подключённый

1237* Подтвердите, что имя инструмента совпадает с именем `mcp__<server>__<tool>`, которое предоставляет сервер1237* Подтвердите, что имя инструмента совпадает с именем `mcp__<server>__<tool>`, которое предоставляет сервер

1238* Если серверу требуется более 30 секунд для запуска, увеличьте [`MCP_TIMEOUT`](/ru/env-vars)1238* Если серверу требуется более 30 секунд для запуска, увеличьте [`MCP_TIMEOUT`](/docs/ru/env-vars)

1239 1239 

1240<h2 id="plugin-errors">1240<h2 id="plugin-errors">

1241 Ошибки плагинов1241 Ошибки плагинов

1242</h2>1242</h2>

1243 1243 

1244Эти ошибки возникают из конфигурации [плагина](/ru/plugins) и [маркетплейса](/ru/plugin-marketplaces). Для проблем с плагинами, которые не выдают одно из сообщений на этой странице, например маркетплейс, который не загружается, или плагин, который устанавливается, но не отображается, см. [Устранение неполадок плагинов](/ru/discover-plugins#troubleshooting).1244Эти ошибки возникают из конфигурации [плагина](/docs/ru/plugins) и [маркетплейса](/docs/ru/plugin-marketplaces). Для проблем с плагинами, которые не выдают одно из сообщений на этой странице, например маркетплейс, который не загружается, или плагин, который устанавливается, но не отображается, см. [Устранение неполадок плагинов](/docs/ru/discover-plugins#troubleshooting).

1245 1245 

1246<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">

1247 Marketplace is registered from an untrusted source1247 Marketplace is registered from an untrusted source

1248</h3>1248</h3>

1249 1249 

1250Маркетплейс зарегистрирован под именем, которое [зарезервировано для официальных маркетплейсов Anthropic](/ru/plugin-marketplaces#marketplace-schema), но его зарегистрированный источник не является репозиторием GitHub `anthropics`. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии 2.1.205 имя проверялось только при добавлении маркетплейса, поэтому запись, зарегистрированная до того, как её имя было зарезервировано, продолжала загружаться.1250Маркетплейс зарегистрирован под именем, которое [зарезервировано для официальных маркетплейсов Anthropic](/docs/ru/plugin-marketplaces#marketplace-schema), но его зарегистрированный источник не является репозиторием GitHub `anthropics`. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии 2.1.205 имя проверялось только при добавлении маркетплейса, поэтому запись, зарегистрированная до того, как её имя было зарезервировано, продолжала загружаться.

1251 1251 

1252```text theme={null}1252```text theme={null}

1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.


1257 1257 

1258* Выполните `claude plugin marketplace remove <name>`, затем снова добавьте маркетплейс из официального репозитория `github.com/anthropics`1258* Выполните `claude plugin marketplace remove <name>`, затем снова добавьте маркетплейс из официального репозитория `github.com/anthropics`

1259* Если вы публикуете маркетплейс третьей стороны, который использовал это имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей добавить его из вашего источника1259* Если вы публикуете маркетплейс третьей стороны, который использовал это имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей добавить его из вашего источника

1260* См. список зарезервированных имён в разделе [Marketplace schema](/ru/plugin-marketplaces#marketplace-schema)1260* См. список зарезервированных имён в разделе [Marketplace schema](/docs/ru/plugin-marketplaces#marketplace-schema)

1261 1261 

1262<h3 id="plugin-command-references-user-config">1262<h3 id="plugin-command-references-user-config">

1263 Plugin command references user\_config in a shell command1263 Plugin command references user\_config in a shell command

1264</h3>1264</h3>

1265 1265 

1266Хук плагина, [monitor](/ru/plugins-reference#monitors), или MCP команда [`headersHelper`](/ru/mcp#use-dynamic-headers-for-custom-authentication) ссылается на [опцию плагина](/ru/plugins-reference#user-configuration) `${user_config.KEY}`, и подставленная строка будет передана в оболочку. Настроенное значение, содержащее `$(...)`, обратные кавычки или `;`, будет выполнено как код там, поэтому Claude Code отказывается запускать компонент вместо подстановки значения. Проверка выполняется на шаблоне команды, поэтому ошибка появляется даже когда значение ещё не настроено. До версии 2.1.207 значение подставлялось в команду оболочки.1266Хук плагина, [monitor](/docs/ru/plugins-reference#monitors), или MCP команда [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication) ссылается на [опцию плагина](/docs/ru/plugins-reference#user-configuration) `${user_config.KEY}`, и подставленная строка будет передана в оболочку. Настроенное значение, содержащее `$(...)`, обратные кавычки или `;`, будет выполнено как код там, поэтому Claude Code отказывается запускать компонент вместо подстановки значения. Проверка выполняется на шаблоне команды, поэтому ошибка появляется даже когда значение ещё не настроено. До версии 2.1.207 значение подставлялось в команду оболочки.

1267 1267 

1268Формулировка зависит от того, какая поверхность ссылалась на опцию. Хук в форме оболочки сообщает:1268Формулировка зависит от того, какая поверхность ссылалась на опцию. Хук в форме оболочки сообщает:

1269 1269 


1285 1285 

1286**Что делать:**1286**Что делать:**

1287 1287 

1288* Для хука добавьте массив `args`, чтобы он выполнялся в [exec форме](/ru/hooks#exec-form-and-shell-form), где каждый `${user_config.KEY}` становится одним аргументом без оболочки между ними. Или удалите ссылку и прочитайте переменную окружения `$CLAUDE_PLUGIN_OPTION_<KEY>` внутри скрипта1288* Для хука добавьте массив `args`, чтобы он выполнялся в [exec форме](/docs/ru/hooks#exec-form-and-shell-form), где каждый `${user_config.KEY}` становится одним аргументом без оболочки между ними. Или удалите ссылку и прочитайте переменную окружения `$CLAUDE_PLUGIN_OPTION_<KEY>` внутри скрипта

1289* Для monitor удалите ссылку и пусть скрипт monitor прочитает значение из файла конфигурации1289* Для monitor удалите ссылку и пусть скрипт monitor прочитает значение из файла конфигурации

1290* Для `headersHelper` переместите `${user_config.KEY}` в поле `headers` сервера, которое не анализируется оболочкой, или прочитайте значение внутри скрипта помощника1290* Для `headersHelper` переместите `${user_config.KEY}` в поле `headers` сервера, которое не анализируется оболочкой, или прочитайте значение внутри скрипта помощника

1291 1291 


1299 Agent would be spawned with zero tools1299 Agent would be spawned with zero tools

1300</h3>1300</h3>

1301 1301 

1302Ничего в [списке `tools` подагента](/ru/sub-agents#supported-frontmatter-fields) не разрешилось в инструмент, поэтому Claude Code отказывается запускать подагента, а не запускать его без возможности действовать. Сообщение группирует записи по причине, по которой они не разрешились: неизвестный инструмент, инструмент, который недоступен подагентам, или распознанный, но не соответствующий ни одному инструменту в текущей сессии. Пропуск поля `tools` никогда не вызывает этот отказ. Шаблон сервера MCP, такой как `mcp__github__*`, не исключён: когда ни один подключённый инструмент не поступает с этого сервера, запуск отказывается с шаблоном в группе, которая ничего не совпала. До версии 2.1.208 подагент запускался без инструментов и возвращал пустой или запутанный результат.1302Ничего в [списке `tools` подагента](/docs/ru/sub-agents#supported-frontmatter-fields) не разрешилось в инструмент, поэтому Claude Code отказывается запускать подагента, а не запускать его без возможности действовать. Сообщение группирует записи по причине, по которой они не разрешились: неизвестный инструмент, инструмент, который недоступен подагентам, или распознанный, но не соответствующий ни одному инструменту в текущей сессии. Пропуск поля `tools` никогда не вызывает этот отказ. Шаблон сервера MCP, такой как `mcp__github__*`, не исключён: когда ни один подключённый инструмент не поступает с этого сервера, запуск отказывается с шаблоном в группе, которая ничего не совпала. До версии 2.1.208 подагент запускался без инструментов и возвращал пустой или запутанный результат.

1303 1303 

1304```text theme={null}1304```text theme={null}

1305Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.1305Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.


1307 1307 

1308**Что делать:**1308**Что делать:**

1309 1309 

1310* Исправьте каждую запись, которую ошибка называет, в соответствии с [инструментами, доступными подагентам](/ru/sub-agents#available-tools)1310* Исправьте каждую запись, которую ошибка называет, в соответствии с [инструментами, доступными подагентам](/docs/ru/sub-agents#available-tools)

1311* Удалите записи для инструментов, которые сессия не имеет, такие как инструменты MCP с сервера, который не подключён1311* Удалите записи для инструментов, которые сессия не имеет, такие как инструменты MCP с сервера, который не подключён

1312* Чтобы дать подагенту каждый инструмент, который есть у родителя, удалите поле `tools` вместо перечисления инструментов1312* Чтобы дать подагенту каждый инструмент, который есть у родителя, удалите поле `tools` вместо перечисления инструментов

1313 1313 


1315 File is covered by a Read deny rule1315 File is covered by a Read deny rule

1316</h3>1316</h3>

1317 1317 

1318Инструмент Edit был вызван на пути, соответствующем [правилу отказа `Read`](/ru/permissions#read-and-edit), включая создание нового файла по этому пути. Редактирование переписывает содержимое, которое Claude должен иметь возможность прочитать обратно, поэтому вызов отказывается до любого доступа к файлу. Правило блокирует только инструмент Edit: Write и NotebookEdit не охватываются правилами отказа `Read`. До версии 2.1.208 только правило отказа `Edit` блокировало редактирование, и правило отказа `Read` само по себе не блокировало.1318Инструмент Edit был вызван на пути, соответствующем [правилу отказа `Read`](/docs/ru/permissions#read-and-edit), включая создание нового файла по этому пути. Редактирование переписывает содержимое, которое Claude должен иметь возможность прочитать обратно, поэтому вызов отказывается до любого доступа к файлу. Правило блокирует только инструмент Edit: Write и NotebookEdit не охватываются правилами отказа `Read`. До версии 2.1.208 только правило отказа `Edit` блокировало редактирование, и правило отказа `Read` само по себе не блокировало.

1319 1319 

1320```text theme={null}1320```text theme={null}

1321File is covered by a Read deny rule in your permission settings and cannot be edited.1321File is covered by a Read deny rule in your permission settings and cannot be edited.


1323 1323 

1324**Что делать:**1324**Что делать:**

1325 1325 

1326* Если Claude должен иметь возможность редактировать файл, удалите или сузьте правило отказа `Read` в `/permissions` или в [параметрах](/ru/settings#permission-settings)1326* Если Claude должен иметь возможность редактировать файл, удалите или сузьте правило отказа `Read` в `/permissions` или в [параметрах](/docs/ru/settings#permission-settings)

1327* Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа `Edit` для того же пути, чтобы инструменты Write и NotebookEdit также были заблокированы1327* Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа `Edit` для того же пути, чтобы инструменты Write и NotebookEdit также были заблокированы

1328 1328 

1329<h2 id="background-session-errors">1329<h2 id="background-session-errors">

1330 Ошибки фоновой сессии1330 Ошибки фоновой сессии

1331</h2>1331</h2>

1332 1332 

1333[Фоновые сессии](/ru/agent-view) работают без собственного интерактивного терминала, поэтому команды, которым он требуется, ведут себя там иначе. Эти сообщения появляются в стенограмме фоновой сессии в представлении агента или после присоединения.1333[Фоновые сессии](/docs/ru/agent-view) работают без собственного интерактивного терминала, поэтому команды, которым он требуется, ведут себя там иначе. Эти сообщения появляются в стенограмме фоновой сессии в представлении агента или после присоединения.

1334 1334 

1335<h3 id="commands-refused-in-a-background-session">1335<h3 id="commands-refused-in-a-background-session">

1336 Команды, отклоненные в фоновой сессии1336 Команды, отклоненные в фоновой сессии

1337</h3>1337</h3>

1338 1338 

1339Команды, которые открывают интерактивное диалоговое окно, отклоняются в фоновой сессии с сообщением, в котором указывается форма, которая там работает, или вам предлагается запустить команду из обычного терминала. `/install-github-app`, список параметров `/mcp` и действия аутентификации в меню сервера MCP все отклоняются таким образом. До версии 2.1.208 они открывали свое диалоговое окно внутри фоновой сессии.1339Команды, которые открывают интерактивное диалоговое окно, отклоняются в фоновой сессии с сообщением, в котором указывается форма, которая там работает, или вам предлагается запустить команду из обычного терминала. `/install-github-app`, список параметров `/mcp` и действия аутентификации в меню сервера MCP все отклоняются таким образом. До версии 2.1.208 они открывали свое диалоговое окно внутри фоновой сессии.

1340{/* max-version: 2.1.208 */}В версии 2.1.208 только средство выбора `/model` также было отклонено в фоновой сессии, а `/upgrade` вывел URL обновления вместо открытия браузера.1340В версии 2.1.208 только средство выбора `/model` также было отклонено в фоновой сессии, а `/upgrade` вывел URL обновления вместо открытия браузера.

1341 1341 

1342Формулировка указывает команду, которая была отклонена. Список параметров `/mcp` сообщает:1342Формулировка указывает команду, которая была отклонена. Список параметров `/mcp` сообщает:

1343 1343 


1354 Ошибки средства запуска CLAUDE\_CODE\_PROCESS\_WRAPPER1354 Ошибки средства запуска CLAUDE\_CODE\_PROCESS\_WRAPPER

1355</h3>1355</h3>

1356 1356 

1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/ru/corporate-launcher) установлен, и его значение невозможно использовать, поэтому Claude Code отказывается запускать затронутый процесс вместо того, чтобы запустить его без средства запуска. Проблемы конфигурации сообщаются сообщением, которое начинается с имени переменной и указывает причину, например:1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/ru/corporate-launcher) установлен, и его значение невозможно использовать, поэтому Claude Code отказывается запускать затронутый процесс вместо того, чтобы запустить его без средства запуска. Проблемы конфигурации сообщаются сообщением, которое начинается с имени переменной и указывает причину, например:

1358 1358 

1359```text theme={null}1359```text theme={null}

1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file


1364 1364 

1365**Что делать:**1365**Что делать:**

1366 1366 

1367* Установите переменную на абсолютный путь исполняемого файла, который заканчивается вызовом `exec "$@"`. Полный контракт см. в разделе [контракт средства запуска](/ru/corporate-launcher#the-launcher-contract)1367* Установите переменную на абсолютный путь исполняемого файла, который заканчивается вызовом `exec "$@"`. Полный контракт см. в разделе [контракт средства запуска](/docs/ru/corporate-launcher#the-launcher-contract)

1368* Проверьте `/status`, который показывает разрешенную команду запуска в записи Self-exec и предупреждает, когда работающая фоновая служба не совпадает с ней, или запустите `claude daemon status` из оболочки1368* Проверьте `/status`, который показывает разрешенную команду запуска в записи Self-exec и предупреждает, когда работающая фоновая служба не совпадает с ней, или запустите `claude daemon status` из оболочки

1369* После исправления значения в блоке `env` [параметров](/ru/corporate-launcher#set-up-the-launcher) перезагрузите фоновую службу с помощью `claude daemon stop --any`, чтобы следующая отправка запустила завернутую1369* После исправления значения в блоке `env` [параметров](/docs/ru/corporate-launcher#set-up-the-launcher) перезагрузите фоновую службу с помощью `claude daemon stop --any`, чтобы следующая отправка запустила завернутую

1370 1370 

1371<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">

1372 Предупреждения о конфигурации1372 Предупреждения о конфигурации


1378 Рабочее пространство не было доверено1378 Рабочее пространство не было доверено

1379</h3>1379</h3>

1380 1380 

1381Claude Code обнаружил правила `permissions.allow` или записи `permissions.additionalDirectories` в файле `.claude/settings.json` или `.claude/settings.local.json` проекта и не применил их, потому что [правила разрешения из параметров проекта требуют доверия рабочему пространству](/ru/permissions#project-allow-rules-and-workspace-trust). Количество, имя параметра и имя файла в сообщении варьируются в зависимости от вашей конфигурации. На правила `deny` и `ask` это не влияет.1381Claude Code обнаружил правила `permissions.allow` или записи `permissions.additionalDirectories` в файле `.claude/settings.json` или `.claude/settings.local.json` проекта и не применил их, потому что [правила разрешения из параметров проекта требуют доверия рабочему пространству](/docs/ru/permissions#project-allow-rules-and-workspace-trust). Количество, имя параметра и имя файла в сообщении варьируются в зависимости от вашей конфигурации. На правила `deny` и `ask` это не влияет.

1382 1382 

1383```text theme={null}1383```text theme={null}

1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.


1386 1386 

1387**Что делать:**1387**Что делать:**

1388 1388 

1389* Запустите `claude` в каталоге и примите диалоговое окно доверия. {/* min-version: 2.1.200 */}Диалоговое окно появляется даже если родительский каталог уже доверен, отображает удерживаемые правила и позволяет вам отклонить их и продолжить работу без них. До версии 2.1.200 диалоговое окно не появлялось в этой ситуации, поэтому этот шаг не мог быть завершен там.1389* Запустите `claude` в каталоге и примите диалоговое окно доверия. Диалоговое окно появляется даже если родительский каталог уже доверен, отображает удерживаемые правила и позволяет вам отклонить их и продолжить работу без них. До версии 2.1.200 диалоговое окно не появлялось в этой ситуации, поэтому этот шаг не мог быть завершен там.

1390* В [неинтерактивном режиме](/ru/headless) с флагом `-p` диалоговое окно не отображается. Установите запись `hasTrustDialogAccepted` в `~/.claude.json`, используя точный ключ `projects`, который выводит сообщение.1390* В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` диалоговое окно не отображается. Установите запись `hasTrustDialogAccepted` в `~/.claude.json`, используя точный ключ `projects`, который выводит сообщение.

1391* {/* min-version: 2.1.200 */}Если сообщение указывает на `.claude/settings.local.json` и вы запустили Claude Code вне репозитория git или в вашем домашнем каталоге, обновитесь до версии 2.1.200 или более поздней. Версии 2.1.196 по 2.1.199 рассматривали ваш собственный `.claude/settings.local.json` как предоставленный репозиторием в этих рабочих пространствах. {/* min-version: 2.1.207 */}На версии 2.1.207 и более поздних обновление недостаточно вне репозитория git, если вы не доверили папке: определение того, что папка находится вне репозитория, запускает git, и Claude Code запускает эту проверку только после того, как вы примете диалоговое окно доверия, поэтому используйте первый шаг. Ваш домашний каталог и любой другой [домашний каталог конфигурации](/ru/permissions#project-allow-rules-and-workspace-trust) исключены и не ждут диалогового окна. См. [Правила разрешения проекта и доверие рабочему пространству](/ru/permissions#project-allow-rules-and-workspace-trust).1391* Если сообщение указывает на `.claude/settings.local.json` и вы запустили Claude Code вне репозитория git или в вашем домашнем каталоге, обновитесь до версии 2.1.200 или более поздней. Версии 2.1.196 по 2.1.199 рассматривали ваш собственный `.claude/settings.local.json` как предоставленный репозиторием в этих рабочих пространствах. На версии 2.1.207 и более поздних обновление недостаточно вне репозитория git, если вы не доверили папке: определение того, что папка находится вне репозитория, запускает git, и Claude Code запускает эту проверку только после того, как вы примете диалоговое окно доверия, поэтому используйте первый шаг. Ваш домашний каталог и любой другой [домашний каталог конфигурации](/docs/ru/permissions#project-allow-rules-and-workspace-trust) исключены и не ждут диалогового окна. См. [Правила разрешения проекта и доверие рабочему пространству](/docs/ru/permissions#project-allow-rules-and-workspace-trust).

1392 1392 

1393<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">

1394 Ответы кажутся менее качественными, чем обычно1394 Ответы кажутся менее качественными, чем обычно


1396 1396 

1397Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно заключается в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии модели. Он может переключиться на резервную модель в трёх конкретных случаях:1397Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно заключается в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии модели. Он может переключиться на резервную модель в трёх конкретных случаях:

1398 1398 

1399* Настроенный [`--fallback-model`](/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке1399* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке

1400* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна1400* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна

1401* [Автоматический fallback модели](/ru/model-config#automatic-model-fallback) на Fable 5 переводит сеанс на модель Opus по умолчанию и показывает уведомление в расшифровке1401* [Автоматический fallback модели](/docs/ru/model-config#automatic-model-fallback) на Fable 5 переводит сеанс на модель Opus по умолчанию и показывает уведомление в расшифровке

1402 1402 

1403Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/ru/model-config) объясняет, когда применяется каждый fallback.1403Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый fallback.

1404 1404 

1405Сначала проверьте следующее:1405Сначала проверьте следующее:

1406 1406 

1407* **Выбор модели**: запустите `/model`, чтобы подтвердить, что вы используете ожидаемую модель. Предыдущий выбор `/model` или переменная окружения `ANTHROPIC_MODEL` могут привести вас к меньшей модели, чем вы предполагали.1407* **Выбор модели**: запустите `/model`, чтобы подтвердить, что вы используете ожидаемую модель. Предыдущий выбор `/model` или переменная окружения `ANTHROPIC_MODEL` могут привести вас к меньшей модели, чем вы предполагали.

1408* **Уровень усилий**: запустите `/effort`, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или работы над дизайном. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед тем, как предполагать, что вы ниже максимума. См. [Adjust effort level](/ru/model-config#adjust-effort-level) для значений по умолчанию для каждой модели и сокращение `ultrathink`.1408* **Уровень усилий**: запустите `/effort`, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или работы над дизайном. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед тем, как предполагать, что вы ниже максимума. См. [Adjust effort level](/docs/ru/model-config#adjust-effort-level) для значений по умолчанию для каждой модели и сокращение `ultrathink`.

1409* **Давление контекста**: запустите `/context`, чтобы увидеть, насколько заполнено окно. Если оно близко к ёмкости, запустите `/compact` в естественной точке разрыва или `/clear`, чтобы начать заново. См. [Explore the context window](/ru/context-window) для того, как auto-compact влияет на предыдущие ходы.1409* **Давление контекста**: запустите `/context`, чтобы увидеть, насколько заполнено окно. Если оно близко к ёмкости, запустите `/compact` в естественной точке разрыва или `/clear`, чтобы начать заново. См. [Explore the context window](/docs/ru/context-window) для того, как auto-compact влияет на предыдущие ходы.

1410* **Устаревшие инструкции**: большие или устаревшие файлы `CLAUDE.md` и определения инструментов MCP потребляют контекст и могут направлять ответы. {/* min-version: 2.1.205 */}Проверка `/doctor` отмечает файлы памяти большого размера и неиспользуемые расширения, а `/context` показывает использование токенов инструментов MCP. До версии 2.1.205 `/doctor` открывал экран диагностики, который отмечал файлы памяти большого размера и определения подагентов.1410* **Устаревшие инструкции**: большие или устаревшие файлы `CLAUDE.md` и определения инструментов MCP потребляют контекст и могут направлять ответы. Проверка `/doctor` отмечает файлы памяти большого размера и неиспользуемые расширения, а `/context` показывает использование токенов инструментов MCP. До версии 2.1.205 `/doctor` открывал экран диагностики, который отмечал файлы памяти большого размера и определения подагентов.

1411 1411 

1412Когда ответ идёт неправильно, откат обычно работает лучше, чем ответ с исправлениями. Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к моменту перед неправильным ходом, затем переформулируйте подсказку с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. [Checkpointing](/ru/checkpointing).1412Когда ответ идёт неправильно, откат обычно работает лучше, чем ответ с исправлениями. Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к моменту перед неправильным ходом, затем переформулируйте подсказку с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. [Checkpointing](/docs/ru/checkpointing).

1413 1413 

1414Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде.1414Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде.

1415 1415 

1416Если Claude предупреждает о подозреваемой инъекции подсказки или отказывает в запросе из-за подозреваемой инъекции, и текст, который называет предупреждение, — это контекст, который Claude Code добавляет в разговор автоматически, а не содержимое файла или веб-сайта, запустите `claude update` и повторите попытку. Если предупреждение повторяется после обновления, [сообщите об этом](#report-an-error) вместо того, чтобы вставлять отмеченное содержимое обратно в подсказку. {/* min-version: 2.1.201 */}До версии 2.1.201 Sonnet 5 отказывал в некоторых запросах таким же образом.1416Если Claude предупреждает о подозреваемой инъекции подсказки или отказывает в запросе из-за подозреваемой инъекции, и текст, который называет предупреждение, — это контекст, который Claude Code добавляет в разговор автоматически, а не содержимое файла или веб-сайта, запустите `claude update` и повторите попытку. Если предупреждение повторяется после обновления, [сообщите об этом](#report-an-error) вместо того, чтобы вставлять отмеченное содержимое обратно в подсказку. До версии 2.1.201 Sonnet 5 отказывал в некоторых запросах таким же образом.

1417 1417 

1418<h2 id="report-an-error">1418<h2 id="report-an-error">

1419 Сообщить об ошибке1419 Сообщить об ошибке


1421 1421 

1422Для ошибок компонентов, которые не рассматриваются на этой странице, см. соответствующее руководство:1422Для ошибок компонентов, которые не рассматриваются на этой странице, см. соответствующее руководство:

1423 1423 

1424* Серверу MCP не удалось подключиться или пройти аутентификацию: [MCP](/ru/mcp)1424* Серверу MCP не удалось подключиться или пройти аутентификацию: [MCP](/docs/ru/mcp)

1425* Скрипт hook не выполнился или заблокировал инструмент: [Debug hooks](/ru/hooks#debug-hooks)1425* Скрипт hook не выполнился или заблокировал инструмент: [Debug hooks](/docs/ru/hooks#debug-hooks)

1426* Отказано в доступе или ошибки файловой системы при установке: [Troubleshoot installation and login](/ru/troubleshoot-install)1426* Отказано в доступе или ошибки файловой системы при установке: [Troubleshoot installation and login](/docs/ru/troubleshoot-install)

1427 1427 

1428Если ошибка не указана здесь или предложенное исправление не помогает:1428Если ошибка не указана здесь или предложенное исправление не помогает:

1429 1429 

1430* Запустите `/feedback` внутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. Отправка в Anthropic требует [аутентификации](/ru/authentication). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и других сторонних поставщиков, или когда учетные данные Anthropic не настроены, `/feedback` сохраняет локальный архив, который вы можете отправить представителю вашей учетной записи Anthropic.1430* Запустите `/feedback` внутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. Отправка в Anthropic требует [аутентификации](/docs/ru/authentication). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и других сторонних поставщиков, или когда учетные данные Anthropic не настроены, `/feedback` сохраняет локальный архив, который вы можете отправить представителю вашей учетной записи Anthropic.

1431* Запустите `claude doctor` из вашей оболочки для диагностики только для чтения вашей установки или запустите проверку `/doctor` внутри Claude Code, чтобы найти и исправить проблемы настройки1431* Запустите `claude doctor` из вашей оболочки для диагностики только для чтения вашей установки или запустите проверку `/doctor` внутри Claude Code, чтобы найти и исправить проблемы настройки

1432* Проверьте [status.claude.com](https://status.claude.com) на наличие активных инцидентов1432* Проверьте [status.claude.com](https://status.claude.com) на наличие активных инцидентов

1433* Поищите [существующие проблемы](https://github.com/anthropics/claude-code/issues) на GitHub1433* Поищите [существующие проблемы](https://github.com/anthropics/claude-code/issues) на GitHub

fast-mode.md +11 −11

Details

32Включайте быстрый режим одним из следующих способов:32Включайте быстрый режим одним из следующих способов:

33 33 

34* Введите `/fast` и нажмите Tab для включения или отключения34* Введите `/fast` и нажмите Tab для включения или отключения

35* Установите `"fastMode": true` в вашем [файле пользовательских настроек](/ru/settings)35* Установите `"fastMode": true` в вашем [файле пользовательских настроек](/docs/ru/settings)

36 36 

37По умолчанию быстрый режим, который вы включаете в интерактивном сеансе, сохраняется между сеансами. {/* min-version: 2.1.205 */}В [неинтерактивном режиме](/ru/headless) с флагом `-p` команда `/fast` работает только в сеансе, запущенном с быстрым режимом в его значении [`--settings`](/ru/cli-reference#cli-flags), например `claude -p --settings '{"fastMode": true}'`; переключение затем применяется только к этому сеансу и не сохраняется как ваше значение по умолчанию, а в любом другом неинтерактивном сеансе команда сообщает, что быстрый режим недоступен. Вы можете настроить быстрый режим на сброс каждого сеанса. Подробности см. в разделе [обязательное согласие за сеанс](#require-per-session-opt-in).37По умолчанию быстрый режим, который вы включаете в интерактивном сеансе, сохраняется между сеансами. В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` команда `/fast` работает только в сеансе, запущенном с быстрым режимом в его значении [`--settings`](/docs/ru/cli-reference#cli-flags), например `claude -p --settings '{"fastMode": true}'`; переключение затем применяется только к этому сеансу и не сохраняется как ваше значение по умолчанию, а в любом другом неинтерактивном сеансе команда сообщает, что быстрый режим недоступен. Вы можете настроить быстрый режим на сброс каждого сеанса. Подробности см. в разделе [обязательное согласие за сеанс](#require-per-session-opt-in).

38 38 

39Для лучшей экономичности включайте быстрый режим в начале сеанса, а не переключайтесь в середине разговора. Подробности см. в разделе [понимание компромисса стоимости](#understand-the-cost-tradeoff).39Для лучшей экономичности включайте быстрый режим в начале сеанса, а не переключайтесь в середине разговора. Подробности см. в разделе [понимание компромисса стоимости](#understand-the-cost-tradeoff).

40 40 


47 47 

48Когда вы отключаете быстрый режим с помощью `/fast` снова, вы остаетесь на Opus. Модель не возвращается к вашей предыдущей модели. Чтобы переключиться на другую модель, используйте `/model`.48Когда вы отключаете быстрый режим с помощью `/fast` снова, вы остаетесь на Opus. Модель не возвращается к вашей предыдущей модели. Чтобы переключиться на другую модель, используйте `/model`.

49 49 

50Переключение на модель, которая не поддерживает быстрый режим, отключает быстрый режим. {/* min-version: 2.1.208 */}Переключение обратно на поддерживаемую модель Opus включает его снова, когда ваше сохраненное предпочтение быстрого режима включено, то же самое предпочтение, с которого новый сеанс начинается по умолчанию. С настроенным [обязательным согласием за сеанс](#require-per-session-opt-in) переключение обратно не включает быстрый режим снова; запустите `/fast` для его повторного включения. Быстрый режим никогда не включается для сеанса, чье сохраненное предпочтение отключено, и значок `↯` и подтверждение "Fast mode ON" появляются всякий раз, когда он активируется. До версии v2.1.208 быстрый режим оставался отключенным после переключения обратно, пока вы снова не запустили `/fast`.50Переключение на модель, которая не поддерживает быстрый режим, отключает быстрый режим. Переключение обратно на поддерживаемую модель Opus включает его снова, когда ваше сохраненное предпочтение быстрого режима включено, то же самое предпочтение, с которого новый сеанс начинается по умолчанию. С настроенным [обязательным согласием за сеанс](#require-per-session-opt-in) переключение обратно не включает быстрый режим снова; запустите `/fast` для его повторного включения. Быстрый режим никогда не включается для сеанса, чье сохраненное предпочтение отключено, и значок `↯` и подтверждение "Fast mode ON" появляются всякий раз, когда он активируется. До версии v2.1.208 быстрый режим оставался отключенным после переключения обратно, пока вы снова не запустили `/fast`.

51 51 

52Opus 4.8 является стандартным режимом быстрого режима в Claude Code v2.1.154 и позже. На версиях v2.1.142 по v2.1.153 быстрый режим по умолчанию использует Opus 4.7.52Opus 4.8 является стандартным режимом быстрого режима в Claude Code v2.1.154 и позже. На версиях v2.1.142 по v2.1.153 быстрый режим по умолчанию использует Opus 4.7.

53 53 


64 64 

65Цены на быстрый режим одинаковы по всему контекстному окну из 1M токенов. Для сравнения со стандартной ставкой Opus см. [справочник по ценам Claude](https://platform.claude.com/docs/ru/about-claude/pricing).65Цены на быстрый режим одинаковы по всему контекстному окну из 1M токенов. Для сравнения со стандартной ставкой Opus см. [справочник по ценам Claude](https://platform.claude.com/docs/ru/about-claude/pricing).

66 66 

67Первый раз, когда вы включаете быстрый режим в разговоре, вы платите полную цену быстрого режима без кэша за входные токены для всего контекста разговора. Чем глубже вы находитесь в разговоре, тем больше это стоит, поэтому включение быстрого режима с самого начала дешевле. Стоимость применяется один раз за разговор, поэтому отключение и повторное включение быстрого режима позже не повторяет её. Для механизма см. [как быстрый режим взаимодействует с кэшем подсказок](/ru/prompt-caching#turning-on-fast-mode).67Первый раз, когда вы включаете быстрый режим в разговоре, вы платите полную цену быстрого режима без кэша за входные токены для всего контекста разговора. Чем глубже вы находитесь в разговоре, тем больше это стоит, поэтому включение быстрого режима с самого начала дешевле. Стоимость применяется один раз за разговор, поэтому отключение и повторное включение быстрого режима позже не повторяет её. Для механизма см. [как быстрый режим взаимодействует с кэшем подсказок](/docs/ru/prompt-caching#turning-on-fast-mode).

68 68 

69<h2 id="decide-when-to-use-fast-mode">69<h2 id="decide-when-to-use-fast-mode">

70 Решение о том, когда использовать быстрый режим70 Решение о том, когда использовать быстрый режим


93| **Быстрый режим** | Одинаковое качество модели, меньшая задержка, более высокая стоимость |93| **Быстрый режим** | Одинаковое качество модели, меньшая задержка, более высокая стоимость |

94| **Более низкий уровень усилий** | Меньше времени на размышление, более быстрые ответы, потенциально более низкое качество на сложных задачах |94| **Более низкий уровень усилий** | Меньше времени на размышление, более быстрые ответы, потенциально более низкое качество на сложных задачах |

95 95 

96Вы можете комбинировать оба: используйте быстрый режим с более низким [уровнем усилий](/ru/model-config#adjust-effort-level) для максимальной скорости на простых задачах.96Вы можете комбинировать оба: используйте быстрый режим с более низким [уровнем усилий](/docs/ru/model-config#adjust-effort-level) для максимальной скорости на простых задачах.

97 97 

98<h2 id="requirements">98<h2 id="requirements">

99 Требования99 Требования


111* **Включение администратором для Team и Enterprise**: быстрый режим отключен по умолчанию для организаций Team и Enterprise. Администратор должен явно [включить быстрый режим](#enable-fast-mode-for-your-organization) перед тем, как пользователи смогут получить к нему доступ.111* **Включение администратором для Team и Enterprise**: быстрый режим отключен по умолчанию для организаций Team и Enterprise. Администратор должен явно [включить быстрый режим](#enable-fast-mode-for-your-organization) перед тем, как пользователи смогут получить к нему доступ.

112 112 

113<Note>113<Note>

114 Если быстрый режим не был включен для вашей организации, команда `/fast` покажет "Fast mode has been disabled by your organization." Если список разрешенных моделей вашей организации [`availableModels`](/ru/model-config#restrict-model-selection) исключает модель быстрого режима Opus, `/fast` отклоняется с сообщением "is not in your organization's allowed models". Исключением является сеанс, уже работающий на разрешенной модели Opus, которая поддерживает быстрый режим: `/fast` затем включает быстрый режим на вашей текущей модели вместо переключения моделей.114 Если быстрый режим не был включен для вашей организации, команда `/fast` покажет "Fast mode has been disabled by your organization." Если список разрешенных моделей вашей организации [`availableModels`](/docs/ru/model-config#restrict-model-selection) исключает модель быстрого режима Opus, `/fast` отклоняется с сообщением "is not in your organization's allowed models". Исключением является сеанс, уже работающий на разрешенной модели Opus, которая поддерживает быстрый режим: `/fast` затем включает быстрый режим на вашей текущей модели вместо переключения моделей.

115</Note>115</Note>

116 116 

117<h3 id="enable-fast-mode-for-your-organization">117<h3 id="enable-fast-mode-for-your-organization">


123* **Console** (клиенты API): администратор включает это в [Параметрах Claude Code](https://platform.claude.com/claude-code/preferences)123* **Console** (клиенты API): администратор включает это в [Параметрах Claude Code](https://platform.claude.com/claude-code/preferences)

124* **Claude AI** (Team и Enterprise): администратор включает это в [Admin Settings > Claude Code](https://claude.ai/admin-settings/claude-code)124* **Claude AI** (Team и Enterprise): администратор включает это в [Admin Settings > Claude Code](https://claude.ai/admin-settings/claude-code)

125 125 

126Другой вариант полного отключения быстрого режима — установить `CLAUDE_CODE_DISABLE_FAST_MODE=1`. См. [Переменные окружения](/ru/env-vars).126Другой вариант полного отключения быстрого режима — установить `CLAUDE_CODE_DISABLE_FAST_MODE=1`. См. [Переменные окружения](/docs/ru/env-vars).

127 127 

128<h3 id="require-per-session-opt-in">128<h3 id="require-per-session-opt-in">

129 Обязательное согласие за сеанс129 Обязательное согласие за сеанс

130</h3>130</h3>

131 131 

132По умолчанию быстрый режим, который пользователь включает в интерактивном сеансе, сохраняется между сеансами: он остается включенным в будущих сеансах. Чтобы изменить это, установите `fastModePerSessionOptIn` на `true` в любом [файле параметров](/ru/settings#settings-files), что приводит к тому, что каждый сеанс начинается с отключенным быстрым режимом и требует от пользователей явного включения его с помощью `/fast`. Администраторы на планах [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) или [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) могут развернуть это организационно через [параметры, управляемые сервером](/ru/server-managed-settings).132По умолчанию быстрый режим, который пользователь включает в интерактивном сеансе, сохраняется между сеансами: он остается включенным в будущих сеансах. Чтобы изменить это, установите `fastModePerSessionOptIn` на `true` в любом [файле параметров](/docs/ru/settings#settings-files), что приводит к тому, что каждый сеанс начинается с отключенным быстрым режимом и требует от пользователей явного включения его с помощью `/fast`. Администраторы на планах [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) или [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) могут развернуть это организационно через [параметры, управляемые сервером](/docs/ru/server-managed-settings).

133 133 

134```json theme={null}134```json theme={null}

135{135{


168 См. также168 См. также

169</h2>169</h2>

170 170 

171* [Конфигурация модели](/ru/model-config): переключение моделей и регулировка уровней усилий171* [Конфигурация модели](/docs/ru/model-config): переключение моделей и регулировка уровней усилий

172* [Эффективное управление затратами](/ru/costs): отслеживание использования токенов и снижение затрат172* [Эффективное управление затратами](/docs/ru/costs): отслеживание использования токенов и снижение затрат

173* [Конфигурация строки состояния](/ru/statusline): отображение информации о модели и контексте173* [Конфигурация строки состояния](/docs/ru/statusline): отображение информации о модели и контексте

Details

6 6 

7> Сравните, какие функции Claude Code доступны в планах подписки Anthropic, Anthropic Console, Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry.7> Сравните, какие функции Claude Code доступны в планах подписки Anthropic, Anthropic Console, Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry.

8 8 

9CLI Claude Code и всё, что работает локально, функционирует одинаково у каждого поставщика. Инструкции по настройке для каждого поставщика см. в разделе [Обзор развёртывания для предприятий](/ru/third-party-integrations). Чтобы сразу перейти к тому, что отсутствует у вашего поставщика, см. вкладки [сводки по поставщикам](#summary-by-provider).9CLI Claude Code и всё, что работает локально, функционирует одинаково у каждого поставщика. Инструкции по настройке для каждого поставщика см. в разделе [Обзор развёртывания для предприятий](/docs/ru/third-party-integrations). Чтобы сразу перейти к тому, что отсутствует у вашего поставщика, см. вкладки [сводки по поставщикам](#summary-by-provider).

10 10 

11В таблицах ниже ✓ означает доступно, ✗ означает недоступно, а «See note» ссылается на сноску для частичной поддержки. Квалификатор после ✓ сужает доступность до этого подмножества, а «Admin-enabled» означает, что функция отключена до тех пор, пока администратор организации её не включит.11В таблицах ниже ✓ означает доступно, ✗ означает недоступно, а «See note» ссылается на сноску для частичной поддержки. Квалификатор после ✓ сужает доступность до этого подмножества, а «Admin-enabled» означает, что функция отключена до тех пор, пока администратор организации её не включит.

12 12 


18 18 

19* **Подписка Claude**: вы входите с учётной записью claude.ai в плане Pro, Max, Team или Enterprise19* **Подписка Claude**: вы входите с учётной записью claude.ai в плане Pro, Max, Team или Enterprise

20* **Anthropic Console**: вы аутентифицируетесь с помощью ключа API Anthropic20* **Anthropic Console**: вы аутентифицируетесь с помощью ключа API Anthropic

21* **Amazon Bedrock**: вы используете модели Claude из каталога моделей Bedrock и устанавливаете `CLAUDE_CODE_USE_BEDROCK`. [Конечная точка Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) охватывается этим столбцом21* **Amazon Bedrock**: вы используете модели Claude из каталога моделей Bedrock и устанавливаете `CLAUDE_CODE_USE_BEDROCK`. [Конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) (`CLAUDE_CODE_USE_MANTLE`) охватывается этим столбцом

22* **Claude Platform на AWS**: вы приобрели Claude через AWS Marketplace, но вызываете API Anthropic и устанавливаете `CLAUDE_CODE_USE_ANTHROPIC_AWS`22* **Claude Platform на AWS**: вы приобрели Claude через AWS Marketplace, но вызываете API Anthropic и устанавливаете `CLAUDE_CODE_USE_ANTHROPIC_AWS`

23* **Google Cloud's Agent Platform**: управляется Google; вы устанавливаете `CLAUDE_CODE_USE_VERTEX`23* **Google Cloud's Agent Platform**: управляется Google; вы устанавливаете `CLAUDE_CODE_USE_VERTEX`

24* **Microsoft Foundry**: управляется Anthropic на Azure; вы устанавливаете `CLAUDE_CODE_USE_FOUNDRY`24* **Microsoft Foundry**: управляется Anthropic на Azure; вы устанавливаете `CLAUDE_CODE_USE_FOUNDRY`


29 29 

30Они работают у каждого поставщика:30Они работают у каждого поставщика:

31 31 

32* [CLI](/ru/quickstart) и [Agent SDK](/ru/agent-sdk/overview)32* [CLI](/docs/ru/quickstart) и [Agent SDK](/docs/ru/agent-sdk/overview)

33* Расширения [VS Code](/ru/vs-code) и [JetBrains](/ru/jetbrains)33* Расширения [VS Code](/docs/ru/vs-code) и [JetBrains](/docs/ru/jetbrains)

34* [Subagents](/ru/sub-agents), [hooks](/ru/hooks-guide), [commands](/ru/commands) и [skills](/ru/skills)34* [Subagents](/docs/ru/sub-agents), [hooks](/docs/ru/hooks-guide), [commands](/docs/ru/commands) и [skills](/docs/ru/skills)

35* [Память CLAUDE.md](/ru/memory), [plugins](/ru/plugins) и [MCP servers](/ru/mcp)35* [Память CLAUDE.md](/docs/ru/memory), [plugins](/docs/ru/plugins) и [MCP servers](/docs/ru/mcp)

36* [Checkpoints](/ru/checkpointing), [sandboxing](/ru/sandboxing) и [Workflows](/ru/workflows)36* [Checkpoints](/docs/ru/checkpointing), [sandboxing](/docs/ru/sandboxing) и [Workflows](/docs/ru/workflows)

37* [Метрики OpenTelemetry](/ru/monitoring-usage) и [управляемый файл параметров](/ru/settings#settings-files)37* [Метрики OpenTelemetry](/docs/ru/monitoring-usage) и [управляемый файл параметров](/docs/ru/settings#settings-files)

38 38 

39Три из них имеют различия, зависящие от поставщика:39Три из них имеют различия, зависящие от поставщика:

40 40 

41* **MCP servers**: [коннекторы из claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) загружаются только когда ваша подписка claude.ai является активным методом аутентификации, и [поиск инструментов](/ru/mcp#configure-tool-search) отключён по умолчанию на Google Cloud's Agent Platform и когда `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий первой стороне41* **MCP servers**: [коннекторы из claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) загружаются только когда ваша подписка claude.ai является активным методом аутентификации, и [поиск инструментов](/docs/ru/mcp#configure-tool-search) отключён по умолчанию на Google Cloud's Agent Platform и когда `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий первой стороне

42* **Subagents**: встроенный [Explore subagent](/ru/sub-agents#built-in-subagents) ограничивает унаследованную модель до Opus на Claude API и наследует модель основного разговора напрямую у любого другого поставщика, включая Claude Platform на AWS42* **Subagents**: встроенный [Explore subagent](/docs/ru/sub-agents#built-in-subagents) ограничивает унаследованную модель до Opus на Claude API и наследует модель основного разговора напрямую у любого другого поставщика, включая Claude Platform на AWS

43* **[Commands](/ru/commands#all-commands)**: `/design-sync` и `/radio` недоступны на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS, а `/voice` требует учётную запись claude.ai43* **[Commands](/docs/ru/commands#all-commands)**: `/design-sync` и `/radio` недоступны на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS, а `/voice` требует учётную запись claude.ai

44 44 

45<h3 id="features-that-require-a-claude-subscription">45<h3 id="features-that-require-a-claude-subscription">

46 Функции, требующие подписку Claude46 Функции, требующие подписку Claude


48 48 

49Они требуют входа с учётной записью claude.ai и недоступны с ключом API Anthropic Console или от поставщика третьей стороны:49Они требуют входа с учётной записью claude.ai и недоступны с ключом API Anthropic Console или от поставщика третьей стороны:

50 50 

51* [Claude Code в веб-версии](/ru/claude-code-on-the-web), Claude Code на мобильном устройстве и [Claude Code в Slack](/ru/slack)51* [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), Claude Code на мобильном устройстве и [Claude Code в Slack](/docs/ru/slack)

52* [Claude Code Desktop](/ru/desktop)52* [Claude Code Desktop](/docs/ru/desktop)

53* [Routines](/ru/routines) (`/schedule`)53* [Routines](/docs/ru/routines) (`/schedule`)

54* [Ultraplan](/ru/ultraplan) и [Ultrareview](/ru/ultrareview)54* [Ultraplan](/docs/ru/ultraplan) и [Ultrareview](/docs/ru/ultrareview)

55* [Code Review](/ru/code-review): планы Team и Enterprise55* [Code Review](/docs/ru/code-review): планы Team и Enterprise

56* [Remote Control](/ru/remote-control)56* [Remote Control](/docs/ru/remote-control)

57* [Расширение Chrome](/ru/chrome)57* [Расширение Chrome](/docs/ru/chrome)

58* [Computer use](/ru/computer-use): планы Pro и Max58* [Computer use](/docs/ru/computer-use): планы Pro и Max

59* [Artifacts](/ru/artifacts): планы Pro, Max, Team и Enterprise59* [Artifacts](/docs/ru/artifacts): планы Pro, Max, Team и Enterprise

60* [Voice dictation](/ru/voice-dictation)60* [Voice dictation](/docs/ru/voice-dictation)

61 61 

62Desktop — частичное исключение: [маршрутизация шлюза может быть настроена в приложении или администратором](/ru/llm-gateway-connect#desktop-app), развёртывания Enterprise могут маршрутизировать Desktop на Google Cloud's Agent Platform или поставщика шлюза через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration), а [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview) запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM. Для доступности этих функций по плану см. [Доступность по плану подписки](#availability-by-subscription-plan).62Desktop — частичное исключение: [маршрутизация шлюза может быть настроена в приложении или администратором](/docs/ru/llm-gateway-connect#desktop-app), развёртывания Enterprise могут маршрутизировать Desktop на Google Cloud's Agent Platform или поставщика шлюза через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration), а [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview) запускает вкладку Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM. Для доступности этих функций по плану см. [Доступность по плану подписки](#availability-by-subscription-plan).

63 63 

64<h3 id="cli-capabilities-that-vary-by-provider">64<h3 id="cli-capabilities-that-vary-by-provider">

65 Возможности CLI, которые различаются по поставщикам65 Возможности CLI, которые различаются по поставщикам


82 82 

83 <tbody>83 <tbody>

84 <tr>84 <tr>

85 <td>[Web search](/ru/tools-reference#websearch-tool-behavior)</td>85 <td>[Web search](/docs/ru/tools-reference#websearch-tool-behavior)</td>

86 <td>✓</td>86 <td>✓</td>

87 <td>✓</td>87 <td>✓</td>

88 <td>✗</td>88 <td>✗</td>


92 </tr>92 </tr>

93 93 

94 <tr>94 <tr>

95 <td>[Fast mode](/ru/fast-mode)</td>95 <td>[Fast mode](/docs/ru/fast-mode)</td>

96 <td>✓</td>96 <td>✓</td>

97 <td>✓</td>97 <td>✓</td>

98 <td>✗</td>98 <td>✗</td>


102 </tr>102 </tr>

103 103 

104 <tr>104 <tr>

105 <td>[Auto mode](/ru/auto-mode-config)</td>105 <td>[Auto mode](/docs/ru/auto-mode-config)</td>

106 <td>✓</td>106 <td>✓</td>

107 <td>✓</td>107 <td>✓</td>

108 <td>См. примечание <sup><a href="#fn2">2</a></sup></td>108 <td>См. примечание <sup><a href="#fn2">2</a></sup></td>


112 </tr>112 </tr>

113 113 

114 <tr>114 <tr>

115 <td>[Advisor](/ru/advisor)</td>115 <td>[Advisor](/docs/ru/advisor)</td>

116 <td>✓</td>116 <td>✓</td>

117 <td>✓</td>117 <td>✓</td>

118 <td>✗</td>118 <td>✗</td>


122 </tr>122 </tr>

123 123 

124 <tr>124 <tr>

125 <td>[Channels](/ru/channels)</td>125 <td>[Channels](/docs/ru/channels)</td>

126 <td>✓</td>126 <td>✓</td>

127 <td>✓</td>127 <td>✓</td>

128 <td>✗</td>128 <td>✗</td>


132 </tr>132 </tr>

133 133 

134 <tr>134 <tr>

135 <td>[`/loop` scheduled tasks](/ru/scheduled-tasks)</td>135 <td>[`/loop` scheduled tasks](/docs/ru/scheduled-tasks)</td>

136 <td>✓</td>136 <td>✓</td>

137 <td>✓</td>137 <td>✓</td>

138 <td>См. примечание <sup><a href="#fn3">3</a></sup></td>138 <td>См. примечание <sup><a href="#fn3">3</a></sup></td>


142 </tr>142 </tr>

143 143 

144 <tr>144 <tr>

145 <td>[GitHub Actions](/ru/github-actions) и [GitLab CI/CD](/ru/gitlab-ci-cd)</td>145 <td>[GitHub Actions](/docs/ru/github-actions) и [GitLab CI/CD](/docs/ru/gitlab-ci-cd)</td>

146 <td>✓</td>146 <td>✓</td>

147 <td>✓</td>147 <td>✓</td>

148 <td>✓</td>148 <td>✓</td>


174 174 

175 <tbody>175 <tbody>

176 <tr>176 <tr>

177 <td>[Analytics dashboard и API](/ru/analytics)</td>177 <td>[Analytics dashboard и API](/docs/ru/analytics)</td>

178 <td>✓ (панель управления: Team и Enterprise; API: Enterprise)</td>178 <td>✓ (панель управления: Team и Enterprise; API: Enterprise)</td>

179 <td>✓ <sup><a href="#fn5">5</a></sup></td>179 <td>✓ <sup><a href="#fn5">5</a></sup></td>

180 <td>✗</td>180 <td>✗</td>


184 </tr>184 </tr>

185 185 

186 <tr>186 <tr>

187 <td>[Server-managed settings](/ru/server-managed-settings)</td>187 <td>[Server-managed settings](/docs/ru/server-managed-settings)</td>

188 <td>✓ (Team и Enterprise)</td>188 <td>✓ (Team и Enterprise)</td>

189 <td>✓ (Team и Enterprise)</td>189 <td>✓ (Team и Enterprise)</td>

190 <td>✗</td>190 <td>✗</td>


194 </tr>194 </tr>

195 195 

196 <tr>196 <tr>

197 <td>[Zero Data Retention](/ru/zero-data-retention)</td>197 <td>[Zero Data Retention](/docs/ru/zero-data-retention)</td>

198 <td>✓ (квалифицированные Enterprise аккаунты)</td>198 <td>✓ (квалифицированные Enterprise аккаунты)</td>

199 <td>✓ (квалифицированные аккаунты)</td>199 <td>✓ (квалифицированные аккаунты)</td>

200 <td>См. примечание <sup><a href="#fn4">4</a></sup></td>200 <td>См. примечание <sup><a href="#fn4">4</a></sup></td>


206</table>206</table>

207 207 

208<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> На Google Cloud's Agent Platform веб-поиск доступен для моделей Claude 4 и более поздних версий.<br />208<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> На Google Cloud's Agent Platform веб-поиск доступен для моделей Claude 4 и более поздних версий.<br />

209<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> На этих поставщиках auto mode поддерживает только Claude Sonnet 5, Opus 4.7 и Opus 4.8. См. [Конфигурация Auto mode](/ru/auto-mode-config). {/* min-version: 2.1.207 */}В v2.1.158 через v2.1.206 auto mode на этих поставщиках также требовал установки `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.<br />209<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> На этих поставщиках auto mode поддерживает только Claude Sonnet 5, Opus 4.7 и Opus 4.8. См. [Конфигурация Auto mode](/docs/ru/auto-mode-config). В v2.1.158 через v2.1.206 auto mode на этих поставщиках также требовал установки `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.<br />

210<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Явные интервалы, такие как `/loop every 2 hours`, работают у каждого поставщика. На Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry `/loop` не может выбрать свой собственный интервал или предоставить подсказку обслуживания по умолчанию, поэтому подсказка без интервала выполняется каждые 10 минут, а `/loop` без аргументов показывает сообщение об использовании. См. [Scheduled tasks](/ru/scheduled-tasks).<br />210<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> Явные интервалы, такие как `/loop every 2 hours`, работают у каждого поставщика. На Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform и Microsoft Foundry `/loop` не может выбрать свой собственный интервал или предоставить подсказку обслуживания по умолчанию, поэтому подсказка без интервала выполняется каждые 10 минут, а `/loop` без аргументов показывает сообщение об использовании. См. [Scheduled tasks](/docs/ru/scheduled-tasks).<br />

211<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> В соответствии с вашим соглашением с поставщиком облачных услуг.<br />211<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> В соответствии с вашим соглашением с поставщиком облачных услуг.<br />

212<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Только панель управления и API. [Contribution metrics](/ru/analytics#enable-contribution-metrics) требует организацию claude.ai Team или Enterprise.212<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> Только панель управления и API. [Contribution metrics](/docs/ru/analytics#enable-contribution-metrics) требует организацию claude.ai Team или Enterprise.

213 213 

214<Note>214<Note>

215 Если вы аутентифицируетесь через [LLM gateway](/ru/llm-gateway), доступность функций соответствует базовому поставщику, на который шлюз перенаправляет запросы. Некоторые функции, доступные только для Anthropic, такие как [Advisor](/ru/advisor), работают только если шлюз перенаправляет запросы без изменений на API Anthropic.215 Если вы аутентифицируетесь через [LLM gateway](/docs/ru/llm-gateway), доступность функций соответствует базовому поставщику, на который шлюз перенаправляет запросы. Некоторые функции, доступные только для Anthropic, такие как [Advisor](/docs/ru/advisor), работают только если шлюз перенаправляет запросы без изменений на API Anthropic.

216</Note>216</Note>

217 217 

218<h3 id="summary-by-provider">218<h3 id="summary-by-provider">

219 Сводка по поставщикам219 Сводка по поставщикам

220</h3>220</h3>

221 221 

222Каждая вкладка содержит список того, что недоступно или частично поддерживается у этого поставщика, с альтернативами, где они существуют. Всё, что не указано, работает так же, как в подписке Claude, кроме [различий, зависящих от поставщика](#features-available-on-every-provider), отмеченных выше. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS отчёты об ошибках и телеметрия для Anthropic отключены по умолчанию. См. [поведение по умолчанию по поставщику API](/ru/data-usage#default-behaviors-by-api-provider) для информации о том, какой трафик всё ещё достигает Anthropic и как отказаться.222Каждая вкладка содержит список того, что недоступно или частично поддерживается у этого поставщика, с альтернативами, где они существуют. Всё, что не указано, работает так же, как в подписке Claude, кроме [различий, зависящих от поставщика](#features-available-on-every-provider), отмеченных выше. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS отчёты об ошибках и телеметрия для Anthropic отключены по умолчанию. См. [поведение по умолчанию по поставщику API](/docs/ru/data-usage#default-behaviors-by-api-provider) для информации о том, какой трафик всё ещё достигает Anthropic и как отказаться.

223 223 

224<Tabs>224<Tabs>

225 <Tab title="Amazon Bedrock">225 <Tab title="Amazon Bedrock">

226 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [веб-поиск](/ru/tools-reference#websearch-tool-behavior), [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [панель управления аналитики](/ru/analytics), [server-managed settings](/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/ru/commands#all-commands).226 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [веб-поиск](/docs/ru/tools-reference#websearch-tool-behavior), [fast mode](/docs/ru/fast-mode), [Advisor](/docs/ru/advisor), [Channels](/docs/ru/channels), [панель управления аналитики](/docs/ru/analytics), [server-managed settings](/docs/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/docs/ru/commands#all-commands).

227 227 

228 **Частичная поддержка:**228 **Частичная поддержка:**

229 229 

230 * [Desktop](/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)230 * [Desktop](/docs/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

231 * [Auto mode](/ru/auto-mode-config): только Sonnet 5, Opus 4.7 и Opus 4.8231 * [Auto mode](/docs/ru/auto-mode-config): только Sonnet 5, Opus 4.7 и Opus 4.8

232 * [`/loop`](/ru/scheduled-tasks): только явные интервалы232 * [`/loop`](/docs/ru/scheduled-tasks): только явные интервалы

233 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением AWS233 * [Zero Data Retention](/docs/ru/zero-data-retention): в соответствии с вашим соглашением AWS

234 234 

235 **Альтернативы:** для планирования используйте [`/loop`](/ru/scheduled-tasks) с явным интервалом вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/ru/github-actions) или [GitLab CI/CD](/ru/gitlab-ci-cd). Для веб-поиска используйте инструмент [WebFetch](/ru/tools-reference#webfetch-tool-behavior) с конкретным URL.235 **Альтернативы:** для планирования используйте [`/loop`](/docs/ru/scheduled-tasks) с явным интервалом вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/docs/ru/github-actions) или [GitLab CI/CD](/docs/ru/gitlab-ci-cd). Для веб-поиска используйте инструмент [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) с конкретным URL.

236 </Tab>236 </Tab>

237 237 

238 <Tab title="Claude Platform на AWS">238 <Tab title="Claude Platform на AWS">

239 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [панель управления аналитики](/ru/analytics), [server-managed settings](/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/ru/commands#all-commands).239 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/docs/ru/fast-mode), [Advisor](/docs/ru/advisor), [Channels](/docs/ru/channels), [панель управления аналитики](/docs/ru/analytics), [server-managed settings](/docs/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/docs/ru/commands#all-commands).

240 240 

241 **Доступно** там, где Amazon Bedrock недоступен: [веб-поиск](/ru/tools-reference#websearch-tool-behavior).241 **Доступно** там, где Amazon Bedrock недоступен: [веб-поиск](/docs/ru/tools-reference#websearch-tool-behavior).

242 242 

243 **Частичная поддержка:**243 **Частичная поддержка:**

244 244 

245 * [`/loop`](/ru/scheduled-tasks): только явные интервалы245 * [`/loop`](/docs/ru/scheduled-tasks): только явные интервалы

246 246 

247 **Альтернативы:** для планирования используйте [`/loop`](/ru/scheduled-tasks) с явным интервалом вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/ru/github-actions) или [GitLab CI/CD](/ru/gitlab-ci-cd).247 **Альтернативы:** для планирования используйте [`/loop`](/docs/ru/scheduled-tasks) с явным интервалом вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/docs/ru/github-actions) или [GitLab CI/CD](/docs/ru/gitlab-ci-cd).

248 </Tab>248 </Tab>

249 249 

250 <Tab title="Google Cloud's Agent Platform">250 <Tab title="Google Cloud's Agent Platform">

251 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [панель управления аналитики](/ru/analytics), [server-managed settings](/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/ru/commands#all-commands).251 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/docs/ru/fast-mode), [Advisor](/docs/ru/advisor), [Channels](/docs/ru/channels), [панель управления аналитики](/docs/ru/analytics), [server-managed settings](/docs/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/docs/ru/commands#all-commands).

252 252 

253 **Частичная поддержка:**253 **Частичная поддержка:**

254 254 

255 * [Desktop](/ru/desktop): через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration) или [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)255 * [Desktop](/docs/ru/desktop): через [управляемые параметры](https://claude.com/docs/third-party/claude-desktop/configuration) или [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

256 * [Web search](/ru/tools-reference#websearch-tool-behavior): модели Claude 4 и более поздние256 * [Web search](/docs/ru/tools-reference#websearch-tool-behavior): модели Claude 4 и более поздние

257 * [Auto mode](/ru/auto-mode-config): только Sonnet 5, Opus 4.7 и Opus 4.8257 * [Auto mode](/docs/ru/auto-mode-config): только Sonnet 5, Opus 4.7 и Opus 4.8

258 * [`/loop`](/ru/scheduled-tasks): только явные интервалы258 * [`/loop`](/docs/ru/scheduled-tasks): только явные интервалы

259 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением Google Cloud259 * [Zero Data Retention](/docs/ru/zero-data-retention): в соответствии с вашим соглашением Google Cloud

260 260 

261 **Альтернативы:** для планирования используйте [`/loop`](/ru/scheduled-tasks) с явным интервалом вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/ru/github-actions) или [GitLab CI/CD](/ru/gitlab-ci-cd).261 **Альтернативы:** для планирования используйте [`/loop`](/docs/ru/scheduled-tasks) с явным интервалом вместо `/schedule`. Для облачных сеансов используйте [GitHub Actions](/docs/ru/github-actions) или [GitLab CI/CD](/docs/ru/gitlab-ci-cd).

262 </Tab>262 </Tab>

263 263 

264 <Tab title="Microsoft Foundry">264 <Tab title="Microsoft Foundry">

265 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/ru/fast-mode), [Advisor](/ru/advisor), [Channels](/ru/channels), [GitHub Actions](/ru/github-actions) и [GitLab CI/CD](/ru/gitlab-ci-cd), [панель управления аналитики](/ru/analytics), [server-managed settings](/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/ru/commands#all-commands).265 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription), плюс [fast mode](/docs/ru/fast-mode), [Advisor](/docs/ru/advisor), [Channels](/docs/ru/channels), [GitHub Actions](/docs/ru/github-actions) и [GitLab CI/CD](/docs/ru/gitlab-ci-cd), [панель управления аналитики](/docs/ru/analytics), [server-managed settings](/docs/ru/server-managed-settings) и [команды `/design-sync` и `/radio`](/docs/ru/commands#all-commands).

266 266 

267 **Частичная поддержка:**267 **Частичная поддержка:**

268 268 

269 * [Desktop](/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)269 * [Desktop](/docs/ru/desktop): только через [Claude Desktop на 3P](https://claude.com/docs/third-party/claude-desktop/overview)

270 * [Auto mode](/ru/auto-mode-config): только Sonnet 5, Opus 4.7 и Opus 4.8270 * [Auto mode](/docs/ru/auto-mode-config): только Sonnet 5, Opus 4.7 и Opus 4.8

271 * [`/loop`](/ru/scheduled-tasks): только явные интервалы271 * [`/loop`](/docs/ru/scheduled-tasks): только явные интервалы

272 * [Zero Data Retention](/ru/zero-data-retention): в соответствии с вашим соглашением Azure272 * [Zero Data Retention](/docs/ru/zero-data-retention): в соответствии с вашим соглашением Azure

273 273 

274 **Альтернативы:** для планирования используйте [`/loop`](/ru/scheduled-tasks) с явным интервалом вместо `/schedule`.274 **Альтернативы:** для планирования используйте [`/loop`](/docs/ru/scheduled-tasks) с явным интервалом вместо `/schedule`.

275 </Tab>275 </Tab>

276 276 

277 <Tab title="Anthropic Console">277 <Tab title="Anthropic Console">

278 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription).278 **Недоступно:** все [функции, требующие подписку Claude](#features-that-require-a-claude-subscription).

279 279 

280 Всё в разделе [Возможности CLI, которые различаются по поставщикам](#cli-capabilities-that-vary-by-provider) доступно, как и [server-managed settings](/ru/server-managed-settings) когда ключ API принадлежит организации Team или Enterprise.280 Всё в разделе [Возможности CLI, которые различаются по поставщикам](#cli-capabilities-that-vary-by-provider) доступно, как и [server-managed settings](/docs/ru/server-managed-settings) когда ключ API принадлежит организации Team или Enterprise.

281 </Tab>281 </Tab>

282</Tabs>282</Tabs>

283 283 


289 289 

290| Функция | Pro | Max | Team | Enterprise |290| Функция | Pro | Max | Team | Enterprise |

291| :-------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |291| :-------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |

292| [Claude Code в веб-версии](/ru/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |292| [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |

293| [Routines](/ru/routines) | ✓ | ✓ | ✓ | ✓ |293| [Routines](/docs/ru/routines) | ✓ | ✓ | ✓ | ✓ |

294| [Remote Control](/ru/remote-control) | ✓ | ✓ | Admin-enabled | Admin-enabled |294| [Remote Control](/docs/ru/remote-control) | ✓ | ✓ | Admin-enabled | Admin-enabled |

295| [Channels](/ru/channels) | ✓ | ✓ | Admin-enabled | Admin-enabled |295| [Channels](/docs/ru/channels) | ✓ | ✓ | Admin-enabled | Admin-enabled |

296| [Computer use](/ru/computer-use) | ✓ | ✓ | ✗ | ✗ |296| [Computer use](/docs/ru/computer-use) | ✓ | ✓ | ✗ | ✗ |

297| Dispatch ([Desktop](/ru/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |297| Dispatch ([Desktop](/docs/ru/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

298| [Code Review](/ru/code-review) | ✗ | ✗ | ✓ | ✓ |298| [Code Review](/docs/ru/code-review) | ✗ | ✗ | ✓ | ✓ |

299| [Artifacts](/ru/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |299| [Artifacts](/docs/ru/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |

300| [Analytics dashboard and contribution metrics](/ru/analytics) | ✗ | ✗ | ✓ | ✓ |300| [Analytics dashboard and contribution metrics](/docs/ru/analytics) | ✗ | ✗ | ✓ | ✓ |

301| [Enterprise Analytics API](/ru/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |301| [Enterprise Analytics API](/docs/ru/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |

302| [Server-managed settings](/ru/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |302| [Server-managed settings](/docs/ru/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

303| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |303| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

304| SCIM | ✗ | ✗ | ✗ | ✓ |304| SCIM | ✗ | ✗ | ✗ | ✓ |

305| [Compliance API](https://platform.claude.com/docs/en/api/compliance) | ✗ | ✗ | ✗ | ✓ |305| [Compliance API](https://platform.claude.com/docs/en/api/compliance) | ✗ | ✗ | ✗ | ✓ |

306| [Zero Data Retention](/ru/zero-data-retention) | ✗ | ✗ | ✗ | ✓ <sup><a href="#fn7">7</a></sup> |306| [Zero Data Retention](/docs/ru/zero-data-retention) | ✗ | ✗ | ✗ | ✓ <sup><a href="#fn7">7</a></sup> |

307 307 

308<span id="fn6" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>6</sup> На Enterprise требуется премиум-место или место Chat + Claude Code. См. [Claude Code в веб-версии](/ru/claude-code-on-the-web).<br />308<span id="fn6" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>6</sup> На Enterprise требуется премиум-место или место Chat + Claude Code. См. [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web).<br />

309<span id="fn7" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>7</sup> Не включено в стандартный план Enterprise. Требует отдельного включения Anthropic для квалифицированных аккаунтов. См. [Zero Data Retention](/ru/zero-data-retention).309<span id="fn7" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>7</sup> Не включено в стандартный план Enterprise. Требует отдельного включения Anthropic для квалифицированных аккаунтов. См. [Zero Data Retention](/docs/ru/zero-data-retention).

310 310 

311Для информации о ценах и полного сравнения планов см. [Team plans](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) и [Enterprise plans](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).311Для информации о ценах и полного сравнения планов см. [Team plans](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) и [Enterprise plans](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).

312 312 


314 Доступность моделей314 Доступность моделей

315</h2>315</h2>

316 316 

317Для информации о том, какие модели Claude и размеры контекстного окна доступны для каждого поставщика и региона, см. [Model configuration](/ru/model-config) и [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF input и extended thinking — это возможности модели, а не функции Claude Code, и работают у каждого поставщика, который предлагает модель. [Prompt caching](/ru/prompt-caching) работает одинаково у большинства поставщиков; на Amazon Bedrock поддержка варьируется в зависимости от модели.317Для информации о том, какие модели Claude и размеры контекстного окна доступны для каждого поставщика и региона, см. [Model configuration](/docs/ru/model-config) и [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vision, PDF input и extended thinking — это возможности модели, а не функции Claude Code, и работают у каждого поставщика, который предлагает модель. [Prompt caching](/docs/ru/prompt-caching) работает одинаково у большинства поставщиков; на Amazon Bedrock поддержка варьируется в зависимости от модели.

318 318 

319<h2 id="related-resources">319<h2 id="related-resources">

320 Связанные ресурсы320 Связанные ресурсы

321</h2>321</h2>

322 322 

323* [Обзор развёртывания для предприятий](/ru/third-party-integrations): сравните аутентификацию, выставление счётов и регионы у поставщиков323* [Обзор развёртывания для предприятий](/docs/ru/third-party-integrations): сравните аутентификацию, выставление счётов и регионы у поставщиков

324* Руководства по настройке поставщиков: [Amazon Bedrock](/ru/amazon-bedrock), [Claude Platform на AWS](/ru/claude-platform-on-aws), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry)324* Руководства по настройке поставщиков: [Amazon Bedrock](/docs/ru/amazon-bedrock), [Claude Platform на AWS](/docs/ru/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry)

325* [Platforms and integrations](/ru/platforms): где работает Claude Code, включая CLI, Desktop, расширения IDE, веб, мобильные устройства и CI/CD325* [Platforms and integrations](/docs/ru/platforms): где работает Claude Code, включая CLI, Desktop, расширения IDE, веб, мобильные устройства и CI/CD

fullscreen.md +14 −14

Details

22 Включение полноэкранной визуализации22 Включение полноэкранной визуализации

23</h2>23</h2>

24 24 

25Запустите `/tui fullscreen` в любом диалоге Claude Code. CLI сохраняет параметр [`tui`](/ru/settings#available-settings) и перезагружается в полноэкранный режим с вашим диалогом в целости, поэтому вы можете переключаться в середине сеанса без потери контекста. Запустите `/tui default` для переключения обратно на классический рендерер или `/tui` без аргумента для вывода информации о том, какой рендерер активен.25Запустите `/tui fullscreen` в любом диалоге Claude Code. CLI сохраняет параметр [`tui`](/docs/ru/settings#available-settings) и перезагружается в полноэкранный режим с вашим диалогом в целости, поэтому вы можете переключаться в середине сеанса без потери контекста. Запустите `/tui default` для переключения обратно на классический рендерер или `/tui` без аргумента для вывода информации о том, какой рендерер активен.

26 26 

27Перезагруженный сеанс сохраняет диалог в том виде, в котором он отображается на экране. Если вы ранее запустили [`/rewind`](/ru/checkpointing#rewind-and-summarize) в этом сеансе, перезагрузка возобновляется с точки перемотки, а не с более длинной стенограммы, сохраненной на диске. До версии v2.1.207 переключение рендереров после перемотки восстанавливало диалог, который перемотка удалила.27Перезагруженный сеанс сохраняет диалог в том виде, в котором он отображается на экране. Если вы ранее запустили [`/rewind`](/docs/ru/checkpointing#rewind-and-summarize) в этом сеансе, перезагрузка возобновляется с точки перемотки, а не с более длинной стенограммы, сохраненной на диске. До версии v2.1.207 переключение рендереров после перемотки восстанавливало диалог, который перемотка удалила.

28 28 

29Вы также можете установить переменную окружения `CLAUDE_CODE_NO_FLICKER` перед запуском Claude Code:29Вы также можете установить переменную окружения `CLAUDE_CODE_NO_FLICKER` перед запуском Claude Code:

30 30 


58 58 

59* **Клик в поле ввода подсказки** для позиционирования курсора в любом месте вводимого вами текста.59* **Клик в поле ввода подсказки** для позиционирования курсора в любом месте вводимого вами текста.

60* **Клик по предложению в команде `/` или списке файлов `@`** для его принятия. Наведение курсора выделяет строку под вашим курсором.60* **Клик по предложению в команде `/` или списке файлов `@`** для его принятия. Наведение курсора выделяет строку под вашим курсором.

61* **Клик по опции в меню выбора** для её выбора. Это охватывает запросы разрешений, `/model`, `/config` и другие диалоги, которые показывают список опций. Наведение курсора показывает указатель на строке под вашим курсором. {/* min-version: 2.1.187 */}Требуется Claude Code v2.1.187 или позже.61* **Клик по опции в меню выбора** для её выбора. Это охватывает запросы разрешений, `/model`, `/config` и другие диалоги, которые показывают список опций. Наведение курсора показывает указатель на строке под вашим курсором. Требуется Claude Code v2.1.187 или позже.

62* **Клик по опции в меню множественного выбора** для её переключения, и клик по кнопке отправки для подтверждения ваших выборов. Клик по строке свободного текста, такой как строка `Other` в вопросе с множественным выбором, фокусирует её поле ввода, чтобы вы могли ввести ответ. {/* min-version: 2.1.208 */}Требуется Claude Code v2.1.208 или позже.62* **Клик по опции в меню множественного выбора** для её переключения, и клик по кнопке отправки для подтверждения ваших выборов. Клик по строке свободного текста, такой как строка `Other` в вопросе с множественным выбором, фокусирует её поле ввода, чтобы вы могли ввести ответ. Требуется Claude Code v2.1.208 или позже.

63* **Клик по свёрнутому результату инструмента** для его развёртывания и просмотра полного выходного сигнала. Клик снова для свёртывания. Вызов инструмента и его результат развёртываются вместе. Кликабельны только сообщения, которые имеют больше для отображения.63* **Клик по свёрнутому результату инструмента** для его развёртывания и просмотра полного выходного сигнала. Клик снова для свёртывания. Вызов инструмента и его результат развёртываются вместе. Кликабельны только сообщения, которые имеют больше для отображения.

64* **Удерживайте `Cmd` на macOS или `Ctrl` на Linux и Windows и клик по URL или пути к файлу** для его открытия. Пути к файлам в выходных данных инструмента, такие как те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простые `http://` и `https://` URL открываются в вашем браузере. {/* min-version: 2.1.181 */}Начиная с версии 2.1.181, простой клик без удержания `Cmd` или `Ctrl` больше не открывает ссылки, что соответствует поведению встроенного терминала. Некоторые терминалы macOS перенаправляют `Cmd`+клик запущенному приложению вместо открытия ссылки самостоятельно, и протокол мыши терминала не имеет способа кодировать клавишу `Cmd`, поэтому Claude Code получает это как простой клик. В Ghostty и {/* min-version: 2.1.198 */}начиная с версии 2.1.198 в Warp на macOS, Claude Code это обнаруживает и позволяет простому клику по ссылке открыть её, а удержание `Cmd` всё ещё работает. Во встроенном терминале VS Code и аналогичных терминалах на основе xterm.js Claude Code уступает собственному обработчику ссылок терминала, который использует тот же жест.64* **Удерживайте `Cmd` на macOS или `Ctrl` на Linux и Windows и клик по URL или пути к файлу** для его открытия. Пути к файлам в выходных данных инструмента, такие как те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простые `http://` и `https://` URL открываются в вашем браузере. Начиная с версии 2.1.181, простой клик без удержания `Cmd` или `Ctrl` больше не открывает ссылки, что соответствует поведению встроенного терминала. Некоторые терминалы macOS перенаправляют `Cmd`+клик запущенному приложению вместо открытия ссылки самостоятельно, и протокол мыши терминала не имеет способа кодировать клавишу `Cmd`, поэтому Claude Code получает это как простой клик. В Ghostty и начиная с версии 2.1.198 в Warp на macOS, Claude Code это обнаруживает и позволяет простому клику по ссылке открыть её, а удержание `Cmd` всё ещё работает. Во встроенном терминале VS Code и аналогичных терминалах на основе xterm.js Claude Code уступает собственному обработчику ссылок терминала, который использует тот же жест.

65* **Клик и перетаскивание** для выделения текста в любом месте диалога. Двойной клик выделяет слово, соответствуя границам слов iTerm2, поэтому путь к файлу выделяется как одна единица. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, двойной клик по URL выделяет весь URL, включая схему. Тройной клик выделяет строку.65* **Клик и перетаскивание** для выделения текста в любом месте диалога. Двойной клик выделяет слово, соответствуя границам слов iTerm2, поэтому путь к файлу выделяется как одна единица. Начиная с версии 2.1.198, двойной клик по URL выделяет весь URL, включая схему. Тройной клик выделяет строку.

66* **Прокрутка колесом мыши** для перемещения по диалогу.66* **Прокрутка колесом мыши** для перемещения по диалогу.

67 67 

68Выделенный текст копируется в буфер обмена автоматически при отпускании мыши. Чтобы отключить это, переключите Copy on select в `/config`.68Выделенный текст копируется в буфер обмена автоматически при отпускании мыши. Чтобы отключить это, переключите Copy on select в `/config`.


90* Прокрутите в конец колесом мыши для возобновления следования.90* Прокрутите в конец колесом мыши для возобновления следования.

91* Переназначьте `scroll:bottom` на сочетание клавиш, которое может отправить ваша клавиатура.91* Переназначьте `scroll:bottom` на сочетание клавиш, которое может отправить ваша клавиатура.

92 92 

93Эти действия переназначаемы. Смотрите [Scroll actions](/ru/keybindings#scroll-actions) для полного списка имён действий, включая варианты с половиной страницы и полной страницей, которые не имеют привязки по умолчанию.93Эти действия переназначаемы. Смотрите [Scroll actions](/docs/ru/keybindings#scroll-actions) для полного списка имён действий, включая варианты с половиной страницы и полной страницей, которые не имеют привязки по умолчанию.

94 94 

95<h3 id="auto-follow">95<h3 id="auto-follow">

96 Автоследование96 Автоследование


100 100 

101Пока автоследование приостановлено, представление также остаётся там, где вы его прокрутили, когда ответ заканчивает потоковую передачу. До версии 2.1.207 представление могло прыгнуть выше начала ответа, когда длинный ответ заканчивал потоковую передачу.101Пока автоследование приостановлено, представление также остаётся там, где вы его прокрутили, когда ответ заканчивает потоковую передачу. До версии 2.1.207 представление могло прыгнуть выше начала ответа, когда длинный ответ заканчивал потоковую передачу.

102 102 

103Подсказка клавиатуры кнопки отражает то, что может отправить ваша клавиатура. На macOS она предлагает нажать, или `Fn+↓` для прокрутки, потому что `Ctrl+End` не достигает Claude Code с клавиатуры Mac. Переназначьте [`scroll:bottom`](/ru/keybindings#scroll-actions) и кнопка показывает ваше сочетание клавиш на каждой платформе. До версии 2.1.206 кнопка предлагала `Ctrl+End` на macOS.103Подсказка клавиатуры кнопки отражает то, что может отправить ваша клавиатура. На macOS она предлагает нажать, или `Fn+↓` для прокрутки, потому что `Ctrl+End` не достигает Claude Code с клавиатуры Mac. Переназначьте [`scroll:bottom`](/docs/ru/keybindings#scroll-actions) и кнопка показывает ваше сочетание клавиш на каждой платформе. До версии 2.1.206 кнопка предлагала `Ctrl+End` на macOS.

104 104 

105На терминале, слишком узком для полной метки, кнопка сокращает подсказку вместо переноса на строку стенограммы ниже. До версии 2.1.206 длинная метка могла переноситься на стенограмму.105На терминале, слишком узком для полной метки, кнопка сокращает подсказку вместо переноса на строку стенограммы ниже. До версии 2.1.206 длинная метка могла переноситься на стенограмму.

106 106 


126 126 

127Команда записывает то же значение, которое устанавливает переменная окружения `CLAUDE_CODE_SCROLL_SPEED`, сохраняемое в `~/.claude/settings.json`. Команда недоступна в терминале IDE JetBrains.127Команда записывает то же значение, которое устанавливает переменная окружения `CLAUDE_CODE_SCROLL_SPEED`, сохраняемое в `~/.claude/settings.json`. Команда недоступна в терминале IDE JetBrains.

128 128 

129Отдельно от базовой скорости Claude Code ускоряет скорость прокрутки, когда вы быстро крутите колесо, поэтому быстрое вращение охватывает большее расстояние, чем то же количество медленных щелчков. Чтобы отключить ускорение и сохранить постоянную скорость на щелчок, установите `wheelScrollAccelerationEnabled` на `false` в [`settings.json`](/ru/settings#available-settings). Этот параметр требует Claude Code v2.1.174 или более поздней версии.129Отдельно от базовой скорости Claude Code ускоряет скорость прокрутки, когда вы быстро крутите колесо, поэтому быстрое вращение охватывает большее расстояние, чем то же количество медленных щелчков. Чтобы отключить ускорение и сохранить постоянную скорость на щелчок, установите `wheelScrollAccelerationEnabled` на `false` в [`settings.json`](/docs/ru/settings#available-settings). Этот параметр требует Claude Code v2.1.174 или более поздней версии.

130 130 

131<h3 id="scroll-in-the-jetbrains-ide-terminal">131<h3 id="scroll-in-the-jetbrains-ide-terminal">

132 Прокрутка в терминале IDE JetBrains132 Прокрутка в терминале IDE JetBrains


187 187 

188Не каждая версия tmux применяет синхронизированный вывод из приложений, поэтому вы можете видеть больше мерцания во время перерисовки под tmux, чем при запуске Claude Code непосредственно в вашем терминале. Если мерцание заметно, особенно по SSH, обновитесь до последней версии tmux или запустите Claude Code в отдельной вкладке терминала вне tmux. Проверьте версию tmux с помощью `tmux -V`.188Не каждая версия tmux применяет синхронизированный вывод из приложений, поэтому вы можете видеть больше мерцания во время перерисовки под tmux, чем при запуске Claude Code непосредственно в вашем терминале. Если мерцание заметно, особенно по SSH, обновитесь до последней версии tmux или запустите Claude Code в отдельной вкладке терминала вне tmux. Проверьте версию tmux с помощью `tmux -V`.

189 189 

190{/* min-version: 2.1.200 */}Claude Code автоматически включает синхронизированный вывод, когда обнаруживает tmux 3.4 или позже из переменной `TERM_PROGRAM_VERSION`, и переходит к прямому запросу терминала для поддержки синхронизированного вывода, когда версия не может быть определена. Становятся ли перерисовки действительно атомарными, зависит от того, соблюдает ли ваша версия tmux синхронизированный вывод; если вы всё ещё видите мерцание под tmux 3.4 или позже, обновитесь до последней версии tmux. Это обнаружение требует Claude Code v2.1.200 или позже.190Claude Code автоматически включает синхронизированный вывод, когда обнаруживает tmux 3.4 или позже из переменной `TERM_PROGRAM_VERSION`, и переходит к прямому запросу терминала для поддержки синхронизированного вывода, когда версия не может быть определена. Становятся ли перерисовки действительно атомарными, зависит от того, соблюдает ли ваша версия tmux синхронизированный вывод; если вы всё ещё видите мерцание под tmux 3.4 или позже, обновитесь до последней версии tmux. Это обнаружение требует Claude Code v2.1.200 или позже.

191 191 

192<h2 id="keep-native-text-selection">192<h2 id="keep-native-text-selection">

193 Сохранение встроенного выделения текста193 Сохранение встроенного выделения текста


203 203 

204Внутри tmux он также записывает в буфер вставки tmux. По SSH он возвращается к последовательностям escape OSC 52. Claude Code выводит уведомление после каждого копирования, сообщая вам, какой путь он использовал.204Внутри tmux он также записывает в буфер вставки tmux. По SSH он возвращается к последовательностям escape OSC 52. Claude Code выводит уведомление после каждого копирования, сообщая вам, какой путь он использовал.

205 205 

206Некоторые терминалы блокируют OSC 52 по умолчанию. iTerm2 блокирует его до тех пор, пока вы не включите Settings → General → Selection → Applications in terminal may access clipboard; запуск [`/terminal-setup`](/ru/terminal-config) в iTerm2 включает это для вас.206Некоторые терминалы блокируют OSC 52 по умолчанию. iTerm2 блокирует его до тех пор, пока вы не включите Settings → General → Selection → Applications in terminal may access clipboard; запуск [`/terminal-setup`](/docs/ru/terminal-config) в iTerm2 включает это для вас.

207 207 

208Для одноразового встроенного выделения клавиша, которую нужно использовать, зависит от вашего терминала:208Для одноразового встроенного выделения клавиша, которую нужно использовать, зависит от вашего терминала:

209 209 


238 238 

239Fullscreen rendering sends only the cells that changed between frames. Some terminals, most commonly Windows Terminal and other ConPTY-backed hosts, coalesce these positioned writes incorrectly and leave fragments of earlier output on screen until you resize the window.239Fullscreen rendering sends only the cells that changed between frames. Some terminals, most commonly Windows Terminal and other ConPTY-backed hosts, coalesce these positioned writes incorrectly and leave fragments of earlier output on screen until you resize the window.

240 240 

241Set [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/ru/env-vars) to repaint every cell on every frame instead of sending incremental updates.241Set [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/docs/ru/env-vars) to repaint every cell on every frame instead of sending incremental updates.

242 242 

243On Windows PowerShell:243On Windows PowerShell:

244 244 


253CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude253CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude

254```254```

255 255 

256On Windows, Claude Code already enables full repaint automatically for background sessions and [agent view](/ru/agent-view), so you only need to set the variable for an interactive fullscreen session you launched directly.256On Windows, Claude Code already enables full repaint automatically for background sessions and [agent view](/docs/ru/agent-view), so you only need to set the variable for an interactive fullscreen session you launched directly.

257 257 

258<h2 id="research-preview">258<h2 id="research-preview">

259 Исследовательский предпросмотр259 Исследовательский предпросмотр


265 265 

266Чтобы отключить полноэкранную визуализацию, запустите `/tui default`, или отмените установку `CLAUDE_CODE_NO_FLICKER`, если вы включили её таким образом. Чтобы принудительно использовать классический рендерер независимо от сохранённого параметра `tui`, установите `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1`. Классический рендерер сохраняет беседу в собственной истории прокрутки вашего терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно.266Чтобы отключить полноэкранную визуализацию, запустите `/tui default`, или отмените установку `CLAUDE_CODE_NO_FLICKER`, если вы включили её таким образом. Чтобы принудительно использовать классический рендерер независимо от сохранённого параметра `tui`, установите `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1`. Классический рендерер сохраняет беседу в собственной истории прокрутки вашего терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно.

267 267 

268Фоновые сеансы, открытые из [представления агента](/ru/agent-view) или `claude attach`, всегда используют полноэкранную визуализацию. Присоединяемый терминал входит в буфер альтернативного экрана для отображения сеанса, и классический рендерер не имеет там истории прокрутки или обработки мыши, поэтому параметр `tui` и `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` не применяются к ним.268Фоновые сеансы, открытые из [представления агента](/docs/ru/agent-view) или `claude attach`, всегда используют полноэкранную визуализацию. Присоединяемый терминал входит в буфер альтернативного экрана для отображения сеанса, и классический рендерер не имеет там истории прокрутки или обработки мыши, поэтому параметр `tui` и `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` не применяются к ним.

Details

108 </Step>108 </Step>

109 109 

110 <Step title="Следуйте подсказкам мастера">110 <Step title="Следуйте подсказкам мастера">

111 Выберите способ аутентификации в Google Cloud: Application Default Credentials из `gcloud`, файл ключа сервисного аккаунта или учетные данные, уже находящиеся в вашей среде. Мастер обнаруживает ваш проект и регион, проверяет, какие модели Claude может вызывать ваш проект, и позволяет вам их закрепить. Результат сохраняется в блок `env` вашего [файла пользовательских настроек](/ru/settings), поэтому вам не нужно самостоятельно экспортировать переменные окружения.111 Выберите способ аутентификации в Google Cloud: Application Default Credentials из `gcloud`, файл ключа сервисного аккаунта или учетные данные, уже находящиеся в вашей среде. Мастер обнаруживает ваш проект и регион, проверяет, какие модели Claude может вызывать ваш проект, и позволяет вам их закрепить. Результат сохраняется в блок `env` вашего [файла пользовательских настроек](/docs/ru/settings), поэтому вам не нужно самостоятельно экспортировать переменные окружения.

112 </Step>112 </Step>

113</Steps>113</Steps>

114 114 

115После входа запустите `/setup-vertex` в любое время, чтобы снова открыть мастер и изменить учетные данные, проект, регион или закрепления моделей. Шаг закрепления модели начинается с ваших текущих закрепленных моделей. Мастер записывает данные в `~/.claude/settings.json` или в `$CLAUDE_CONFIG_DIR/settings.json`, когда установлена переменная [`CLAUDE_CONFIG_DIR`](/ru/env-vars#variables).115После входа запустите `/setup-vertex` в любое время, чтобы снова открыть мастер и изменить учетные данные, проект, регион или закрепления моделей. Шаг закрепления модели начинается с ваших текущих закрепленных моделей. Мастер записывает данные в `~/.claude/settings.json` или в `$CLAUDE_CONFIG_DIR/settings.json`, когда установлена переменная [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars#variables).

116 116 

117<h2 id="region-configuration">117<h2 id="region-configuration">

118 Конфигурация региона118 Конфигурация региона


212export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1212export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

213```213```

214 214 

215Большинство версий моделей имеют соответствующую переменную `VERTEX_REGION_CLAUDE_*`. Полный список см. в [справочнике переменных окружения](/ru/env-vars). Проверьте [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), чтобы определить, какие модели поддерживают глобальные конечные точки в сравнении с региональными только.215Большинство версий моделей имеют соответствующую переменную `VERTEX_REGION_CLAUDE_*`. Полный список см. в [справочнике переменных окружения](/docs/ru/env-vars). Проверьте [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), чтобы определить, какие модели поддерживают глобальные конечные точки в сравнении с региональными только.

216 216 

217[Кэширование запросов](/ru/prompt-caching) включается автоматически. Чтобы отключить его, установите `DISABLE_PROMPT_CACHING=1`. Чтобы запросить TTL кэша на 1 час вместо стандартного 5-минутного, установите `ENABLE_PROMPT_CACHING_1H=1`; записи кэша с TTL на 1 час тарифицируются по более высокому тарифу. Для повышенных лимитов скорости обратитесь в поддержку Google Cloud. При использовании Google Cloud's Agent Platform команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные Google Cloud.217[Кэширование запросов](/docs/ru/prompt-caching) включается автоматически. Чтобы отключить его, установите `DISABLE_PROMPT_CACHING=1`. Чтобы запросить TTL кэша на 1 час вместо стандартного 5-минутного, установите `ENABLE_PROMPT_CACHING_1H=1`; записи кэша с TTL на 1 час тарифицируются по более высокому тарифу. Для повышенных лимитов скорости обратитесь в поддержку Google Cloud. При использовании Google Cloud's Agent Platform команда `/logout` недоступна, так как аутентификация обрабатывается через учетные данные Google Cloud.

218 218 

219Claude Code отключает [поиск инструментов MCP](/ru/mcp#scale-with-mcp-tool-search) по умолчанию на Google Cloud's Agent Platform, поэтому определения инструментов MCP загружаются заранее. Google Cloud's Agent Platform поддерживает поиск инструментов для Claude Sonnet 4.5 и позже, а также Claude Opus 4.5 и позже. Установите `ENABLE_TOOL_SEARCH=true`, чтобы включить его на этих моделях. Более ранние модели на Google Cloud's Agent Platform не принимают требуемый бета-заголовок, и запросы не выполняются, если вы включите поиск инструментов с ними.219Claude Code отключает [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) по умолчанию на Google Cloud's Agent Platform, поэтому определения инструментов MCP загружаются заранее. Google Cloud's Agent Platform поддерживает поиск инструментов для Claude Sonnet 4.5 и позже, а также Claude Opus 4.5 и позже. Установите `ENABLE_TOOL_SEARCH=true`, чтобы включить его на этих моделях. Более ранние модели на Google Cloud's Agent Platform не принимают требуемый бета-заголовок, и запросы не выполняются, если вы включите поиск инструментов с ними.

220 220 

221<h3 id="5-pin-model-versions">221<h3 id="5-pin-model-versions">

222 5. Закрепите версии моделей222 5. Закрепите версии моделей


236export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'236export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

237```237```

238 238 

239Для текущих и устаревших ID моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Полный список переменных окружения см. в разделе [Конфигурация моделей](/ru/model-config#pin-models-for-third-party-deployments).239Для текущих и устаревших ID моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Полный список переменных окружения см. в разделе [Конфигурация моделей](/docs/ru/model-config#pin-models-for-third-party-deployments).

240 240 

241Claude Code использует эти модели по умолчанию, когда переменные закрепления не установлены:241Claude Code использует эти модели по умолчанию, когда переменные закрепления не установлены:

242 242 


254 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развертывание, которое не закрепляет основную модель, будет тарифицироваться по тарифу Opus после обновления до версии 2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развертывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.254 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развертывание, которое не закрепляет основную модель, будет тарифицироваться по тарифу Opus после обновления до версии 2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развертывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.

255</Warning>255</Warning>

256 256 

257{/* min-version: 2.1.207 */}До версии 2.1.207 основная модель на Google Cloud's Agent Platform по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался в Opus 4.6, а фоновые задачи всегда использовали основную модель.257До версии 2.1.207 основная модель на Google Cloud's Agent Platform по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался в Opus 4.6, а фоновые задачи всегда использовали основную модель.

258 258 

259Для дальнейшей настройки моделей:259Для дальнейшей настройки моделей:

260 260 


269 269 

270Когда Claude Code запускается с настроенной платформой Google Cloud Agent Platform, он проверяет, что модели, которые он намеревается использовать, доступны в вашем проекте.270Когда Claude Code запускается с настроенной платформой Google Cloud Agent Platform, он проверяет, что модели, которые он намеревается использовать, доступны в вашем проекте.

271 271 

272Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваш проект может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл пользовательских настроек](/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию.272Если вы закрепили версию модели, которая старше текущего значения по умолчанию Claude Code, и ваш проект может вызывать более новую версию, Claude Code предлагает вам обновить закрепление. Принятие записывает новый ID модели в ваш [файл пользовательских настроек](/docs/ru/settings) и перезапускает Claude Code. Отклонение запоминается до следующего изменения версии по умолчанию.

273 273 

274Если вы не закрепили модель и текущее значение по умолчанию недоступно в вашем проекте, Claude Code откатывается на предыдущую версию для текущего сеанса и показывает уведомление. Сначала он пытается использовать более ранние версии модели по умолчанию и, когда модель по умолчанию является моделью Opus и ни одна версия Opus недоступна, откатывается на модель Sonnet по умолчанию. Откат не сохраняется. Включите более новую модель в [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) или [закрепите версию](#5-pin-model-versions), чтобы сделать выбор постоянным.274Если вы не закрепили модель и текущее значение по умолчанию недоступно в вашем проекте, Claude Code откатывается на предыдущую версию для текущего сеанса и показывает уведомление. Сначала он пытается использовать более ранние версии модели по умолчанию и, когда модель по умолчанию является моделью Opus и ни одна версия Opus недоступна, откатывается на модель Sonnet по умолчанию. Откат не сохраняется. Включите более новую модель в [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) или [закрепите версию](#5-pin-model-versions), чтобы сделать выбор постоянным.

275 275 


297 297 

298Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [контекстное окно с 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на платформе Agent Platform Google Cloud. Sonnet 5 всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное контекстное окно при выборе варианта модели с 1M.298Claude Sonnet 5, Opus 4.6 и более поздние версии, а также Sonnet 4.6 поддерживают [контекстное окно с 1M токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) на платформе Agent Platform Google Cloud. Sonnet 5 всегда работает с окном 1M, без варианта `[1m]` для выбора. Для других моделей Claude Code автоматически включает расширенное контекстное окно при выборе варианта модели с 1M.

299 299 

300[Мастер установки](#sign-in-with-agent-platform) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развертываний третьих сторон](/ru/model-config#pin-models-for-third-party-deployments).300[Мастер установки](#sign-in-with-agent-platform) предлагает опцию контекстного окна с 1M при закреплении моделей. Чтобы включить его для вручную закрепленной модели, добавьте `[1m]` к ID модели. Подробности см. в разделе [Закрепите модели для развертываний третьих сторон](/docs/ru/model-config#pin-models-for-third-party-deployments).

301 301 

302<h2 id="troubleshooting">302<h2 id="troubleshooting">

303 Устранение неполадок303 Устранение неполадок

headless.md +23 −23

Details

6 6 

7> Используйте Agent SDK для программного запуска Claude Code из CLI, Python или TypeScript.7> Используйте Agent SDK для программного запуска Claude Code из CLI, Python или TypeScript.

8 8 

9[Agent SDK](/ru/agent-sdk/overview) предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code. Он доступен как CLI для скриптов и CI/CD, или как пакеты [Python](/ru/agent-sdk/python) и [TypeScript](/ru/agent-sdk/typescript) для полного программного управления.9[Agent SDK](/docs/ru/agent-sdk/overview) предоставляет вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code. Он доступен как CLI для скриптов и CI/CD, или как пакеты [Python](/docs/ru/agent-sdk/python) и [TypeScript](/docs/ru/agent-sdk/typescript) для полного программного управления.

10 10 

11Чтобы запустить Claude Code в неинтерактивном режиме, передайте `-p` с вашим запросом и любыми [параметрами CLI](/ru/cli-reference):11Чтобы запустить Claude Code в неинтерактивном режиме, передайте `-p` с вашим запросом и любыми [параметрами CLI](/docs/ru/cli-reference):

12 12 

13```bash theme={null}13```bash theme={null}

14claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"14claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"

15```15```

16 16 

17На этой странице рассматривается использование Agent SDK через CLI (`claude -p`). Для пакетов Python и TypeScript SDK со структурированными выходами, обратными вызовами одобрения инструментов и собственными объектами сообщений см. [полную документацию Agent SDK](/ru/agent-sdk/overview).17На этой странице рассматривается использование Agent SDK через CLI (`claude -p`). Для пакетов Python и TypeScript SDK со структурированными выходами, обратными вызовами одобрения инструментов и собственными объектами сообщений см. [полную документацию Agent SDK](/docs/ru/agent-sdk/overview).

18 18 

19<h2 id="basic-usage">19<h2 id="basic-usage">

20 Базовое использование20 Базовое использование

21</h2>21</h2>

22 22 

23Добавьте флаг `-p` (или `--print`) к любой команде `claude` для запуска её в неинтерактивном режиме. Все [параметры CLI](/ru/cli-reference) работают с `-p`, включая:23Добавьте флаг `-p` (или `--print`) к любой команде `claude` для запуска её в неинтерактивном режиме. Все [параметры CLI](/docs/ru/cli-reference) работают с `-p`, включая:

24 24 

25* `--continue` для [продолжения разговоров](#continue-conversations)25* `--continue` для [продолжения разговоров](#continue-conversations)

26* `--allowedTools` для [автоматического одобрения инструментов](#auto-approve-tools)26* `--allowedTools` для [автоматического одобрения инструментов](#auto-approve-tools)


36 Начните быстрее с режимом bare36 Начните быстрее с режимом bare

37</h3>37</h3>

38 38 

39Добавьте `--bare` для сокращения времени запуска путём пропуска автоматического обнаружения hooks, skills, plugins, MCP серверов, автоматической памяти и CLAUDE.md. Без этого `claude -p` загружает тот же [контекст](/ru/how-claude-code-works#the-context-window), что и интерактивная сессия, включая всё, что настроено в рабочем каталоге или `~/.claude`.39Добавьте `--bare` для сокращения времени запуска путём пропуска автоматического обнаружения hooks, skills, plugins, MCP серверов, автоматической памяти и CLAUDE.md. Без этого `claude -p` загружает тот же [контекст](/docs/ru/how-claude-code-works#the-context-window), что и интерактивная сессия, включая всё, что настроено в рабочем каталоге или `~/.claude`.

40 40 

41Режим bare полезен для CI и скриптов, где вам нужен одинаковый результат на каждой машине. Hook в `~/.claude` коллеги или MCP сервер в `.mcp.json` проекта не будут запущены, потому что режим bare никогда их не читает. Действуют только явно переданные флаги.41Режим bare полезен для CI и скриптов, где вам нужен одинаковый результат на каждой машине. Hook в `~/.claude` коллеги или MCP сервер в `.mcp.json` проекта не будут запущены, потому что режим bare никогда их не читает. Действуют только явно переданные флаги.

42 42 


66 Фоновые задачи при выходе66 Фоновые задачи при выходе

67</h3>67</h3>

68 68 

69Если Claude запускает [фоновую задачу Bash](/ru/tools-reference#bash-tool-behavior) во время выполнения `claude -p`, например сервер разработки или сборку с отслеживанием, эта задача завершается примерно через пять секунд после того, как Claude вернул свой окончательный результат и stdin закрыт. Период ожидания позволяет задаче, которая завершается сразу после результата, всё ещё доставить свой вывод. До версии v2.1.163 никогда не завершающийся фоновый процесс держал бы вызов `claude -p` открытым неопределённо долго.69Если Claude запускает [фоновую задачу Bash](/docs/ru/tools-reference#bash-tool-behavior) во время выполнения `claude -p`, например сервер разработки или сборку с отслеживанием, эта задача завершается примерно через пять секунд после того, как Claude вернул свой окончательный результат и stdin закрыт. Период ожидания позволяет задаче, которая завершается сразу после результата, всё ещё доставить свой вывод. До версии v2.1.163 никогда не завершающийся фоновый процесс держал бы вызов `claude -p` открытым неопределённо долго.

70 70 

71Фоновые [подагенты](/ru/sub-agents) и рабочие процессы освобождены от пятисекундного периода ожидания, потому что их результат является частью окончательного вывода, поэтому `claude -p` ждёт их завершения. Начиная с версии v2.1.182, это ожидание ограничено десятью минутами по умолчанию, чтобы застрявший фоновый агент не мог держать процесс открытым неопределённо долго. Отрегулируйте ограничение с помощью [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/ru/env-vars) или установите его на `0`, чтобы ждать без ограничений.71Фоновые [подагенты](/docs/ru/sub-agents) и рабочие процессы освобождены от пятисекундного периода ожидания, потому что их результат является частью окончательного вывода, поэтому `claude -p` ждёт их завершения. Начиная с версии v2.1.182, это ожидание ограничено десятью минутами по умолчанию, чтобы застрявший фоновый агент не мог держать процесс открытым неопределённо долго. Отрегулируйте ограничение с помощью [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/docs/ru/env-vars) или установите его на `0`, чтобы ждать без ограничений.

72 72 

73<h2 id="examples">73<h2 id="examples">

74 Примеры74 Примеры


88cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt88cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

89```89```

90 90 

91С `--output-format json` полезная нагрузка ответа включает `total_cost_usd` и разбивку затрат по моделям, поэтому скриптовые вызывающие стороны могут отслеживать расходы на вызов без обращения к [панели использования](/ru/costs).91С `--output-format json` полезная нагрузка ответа включает `total_cost_usd` и разбивку затрат по моделям, поэтому скриптовые вызывающие стороны могут отслеживать расходы на вызов без обращения к [панели использования](/docs/ru/costs).

92 92 

93<Note>93<Note>

94 Начиная с Claude Code v2.1.128, piped stdin ограничен 10MB. Если вы превысите лимит, Claude Code выходит с чётким сообщением об ошибке и ненулевым статусом. Для работы с большими входными данными запишите содержимое в файл и ссылайтесь на путь файла в вашем запросе вместо передачи через pipe.94 Начиная с Claude Code v2.1.128, piped stdin ограничен 10MB. Если вы превысите лимит, Claude Code выходит с чётким сообщением об ошибке и ненулевым статусом. Для работы с большими входными данными запишите содержимое в файл и ссылайтесь на путь файла в вашем запросе вместо передачи через pipe.


163claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages163claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages

164```164```

165 165 

166Последняя строка потока — это сообщение `result` с финальным текстом ответа, стоимостью и метаданными сессии. {/* min-version: 2.1.208 */}До версии v2.1.208 передача большого ответа могла обрезать финальную строку и опустить сообщение `result`.166Последняя строка потока — это сообщение `result` с финальным текстом ответа, стоимостью и метаданными сессии. До версии v2.1.208 передача большого ответа могла обрезать финальную строку и опустить сообщение `result`.

167 167 

168Следующий пример использует [jq](https://jqlang.github.io/jq/) для фильтрации текстовых дельт и отображения только потокового текста. Флаг `-r` выводит необработанные строки (без кавычек), а `-j` объединяет без новых строк, чтобы токены передавались непрерывно:168Следующий пример использует [jq](https://jqlang.github.io/jq/) для фильтрации текстовых дельт и отображения только потокового текста. Флаг `-r` выводит необработанные строки (без кавычек), а `-j` объединяет без новых строк, чтобы токены передавались непрерывно:

169 169 


188 188 

189Событие `system/init` сообщает метаданные сессии, включая модель, инструменты, MCP серверы и загруженные плагины. Это первое событие в потоке, если не установлены события запуска:189Событие `system/init` сообщает метаданные сессии, включая модель, инструменты, MCP серверы и загруженные плагины. Это первое событие в потоке, если не установлены события запуска:

190 190 

191* события `plugin_install`, когда установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ru/env-vars).191* события `plugin_install`, когда установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/ru/env-vars).

192* {/* min-version: 2.1.204 */}[события `hook_started`, `hook_progress` и `hook_response`](/ru/agent-sdk/typescript#sdkhookstartedmessage), пока работает настроенный hook [`SessionStart`](/ru/hooks#sessionstart) или [`Setup`](/ru/hooks#setup). Они передаются потоком по мере их создания. Claude Code v2.1.169 через v2.1.203 доставлял их одной партией после завершения hook, всё ещё впереди `system/init`; v2.1.204 восстановил живую доставку.192* [события `hook_started`, `hook_progress` и `hook_response`](/docs/ru/agent-sdk/typescript#sdkhookstartedmessage), пока работает настроенный hook [`SessionStart`](/docs/ru/hooks#sessionstart) или [`Setup`](/docs/ru/hooks#setup). Они передаются потоком по мере их создания. Claude Code v2.1.169 через v2.1.203 доставлял их одной партией после завершения hook, всё ещё впереди `system/init`; v2.1.204 восстановил живую доставку.

193 193 

194Событие также содержит опциональный массив `capabilities` строк, называющих поведения протокола, которые реализует эта версия Claude Code, такие как `interrupt_receipt_v1`. Проверьте его для обнаружения функций вместо сравнения строк версий и игнорируйте значения, которые вы не распознаёте. Поле требует Claude Code v2.1.205 или позже и отсутствует в более ранних версиях. См. [`SDKSystemMessage`](/ru/agent-sdk/typescript#sdksystemmessage) для списка возможностей.194Событие также содержит опциональный массив `capabilities` строк, называющих поведения протокола, которые реализует эта версия Claude Code, такие как `interrupt_receipt_v1`. Проверьте его для обнаружения функций вместо сравнения строк версий и игнорируйте значения, которые вы не распознаёте. Поле требует Claude Code v2.1.205 или позже и отсутствует в более ранних версиях. См. [`SDKSystemMessage`](/docs/ru/agent-sdk/typescript#sdksystemmessage) для списка возможностей.

195 195 

196Используйте поля плагина для отказа CI, когда плагин не загрузился:196Используйте поля плагина для отказа CI, когда плагин не загрузился:

197 197 


200| `plugins` | массив | плагины, которые успешно загрузились, каждый с `name` и `path` |200| `plugins` | массив | плагины, которые успешно загрузились, каждый с `name` и `path` |

201| `plugin_errors` | массив | ошибки загрузки плагина, каждая с `plugin`, `type` и `message`. Включает неудовлетворённые версии зависимостей и ошибки загрузки `--plugin-dir`, такие как отсутствующий путь или недействительный архив. Затронутые плагины понижены в приоритете и отсутствуют в `plugins`. Ключ опускается, когда ошибок нет |201| `plugin_errors` | массив | ошибки загрузки плагина, каждая с `plugin`, `type` и `message`. Включает неудовлетворённые версии зависимостей и ошибки загрузки `--plugin-dir`, такие как отсутствующий путь или недействительный архив. Затронутые плагины понижены в приоритете и отсутствуют в `plugins`. Ключ опускается, когда ошибок нет |

202 202 

203Когда установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ru/env-vars), Claude Code выдаёт события `system/plugin_install` во время установки плагинов marketplace перед первым ходом. Используйте их для отображения прогресса установки в вашем собственном пользовательском интерфейсе.203Когда установлена [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/ru/env-vars), Claude Code выдаёт события `system/plugin_install` во время установки плагинов marketplace перед первым ходом. Используйте их для отображения прогресса установки в вашем собственном пользовательском интерфейсе.

204 204 

205| Поле | Тип | Описание |205| Поле | Тип | Описание |

206| ------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |206| ------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |


212| `uuid` | строка | уникальный идентификатор события |212| `uuid` | строка | уникальный идентификатор события |

213| `session_id` | строка | сессия, к которой принадлежит событие |213| `session_id` | строка | сессия, к которой принадлежит событие |

214 214 

215Для программной потоковой передачи с обратными вызовами и объектами сообщений см. [Stream responses in real-time](/ru/agent-sdk/streaming-output) в документации Agent SDK.215Для программной потоковой передачи с обратными вызовами и объектами сообщений см. [Stream responses in real-time](/docs/ru/agent-sdk/streaming-output) в документации Agent SDK.

216 216 

217<h3 id="auto-approve-tools">217<h3 id="auto-approve-tools">

218 Автоматическое одобрение инструментов218 Автоматическое одобрение инструментов


225 --allowedTools "Bash,Read,Edit"225 --allowedTools "Bash,Read,Edit"

226```226```

227 227 

228Чтобы установить базовый уровень для всей сессии вместо перечисления отдельных инструментов, передайте [режим разрешений](/ru/permission-modes). `dontAsk` отклоняет всё, что не входит в ваши правила `permissions.allow` или [набор команд только для чтения](/ru/permissions#read-only-commands), что полезно для заблокированных CI запусков. `AskUserQuestion`, инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), отклоняются даже когда правило разрешения совпадает.228Чтобы установить базовый уровень для всей сессии вместо перечисления отдельных инструментов, передайте [режим разрешений](/docs/ru/permission-modes). `dontAsk` отклоняет всё, что не входит в ваши правила `permissions.allow` или [набор команд только для чтения](/docs/ru/permissions#read-only-commands), что полезно для заблокированных CI запусков. `AskUserQuestion`, инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), отклоняются даже когда правило разрешения совпадает.

229 229 

230`acceptEdits` позволяет Claude писать файлы без запроса и также автоматически одобряет общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp`. Другие команды оболочки и сетевые запросы по-прежнему требуют записи `--allowedTools` или правила `permissions.allow`, иначе запуск прерывается при попытке выполнить одну из них:230`acceptEdits` позволяет Claude писать файлы без запроса и также автоматически одобряет общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp`. Другие команды оболочки и сетевые запросы по-прежнему требуют записи `--allowedTools` или правила `permissions.allow`, иначе запуск прерывается при попытке выполнить одну из них:

231 231 


244 --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"244 --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"

245```245```

246 246 

247Флаг `--allowedTools` использует [синтаксис правил разрешений](/ru/settings#permission-rule-syntax). Завершающий ` *` включает сопоставление префиксов, поэтому `Bash(git diff *)` разрешает любую команду, начинающуюся с `git diff`. Пробел перед `*` важен: без него `Bash(git diff*)` также совпадал бы с `git diff-index`.247Флаг `--allowedTools` использует [синтаксис правил разрешений](/docs/ru/settings#permission-rule-syntax). Завершающий ` *` включает сопоставление префиксов, поэтому `Bash(git diff *)` разрешает любую команду, начинающуюся с `git diff`. Пробел перед `*` важен: без него `Bash(git diff*)` также совпадал бы с `git diff-index`.

248 248 

249<Note>249<Note>

250 Вызываемые пользователем [skills](/ru/skills) и пользовательские команды работают в режиме `-p`: включите `/skill-name` в строку запроса, и Claude Code развернёт её перед запуском. Встроенные команды, которые только работают в интерфейсе терминала, такие как `/login`, недоступны в режиме `-p`. {/* min-version: 2.1.205 */}`/model`, `/effort`, `/fast`, `/color` и `/rename` принимают значение как аргумент, например `/model sonnet`, и `/mcp` без аргумента выводит текстовую сводку статуса сервера; эти формы требуют Claude Code v2.1.205 или позже и следуют [примечаниям доступности](/ru/commands#all-commands) каждой команды. {/* min-version: 2.1.181 */}Чтобы изменить параметр из вызова `-p`, передайте `key=value` в `/config`, например `/config thinking=false`.250 Вызываемые пользователем [skills](/docs/ru/skills) и пользовательские команды работают в режиме `-p`: включите `/skill-name` в строку запроса, и Claude Code развернёт её перед запуском. Встроенные команды, которые только работают в интерфейсе терминала, такие как `/login`, недоступны в режиме `-p`. `/model`, `/effort`, `/fast`, `/color` и `/rename` принимают значение как аргумент, например `/model sonnet`, и `/mcp` без аргумента выводит текстовую сводку статуса сервера; эти формы требуют Claude Code v2.1.205 или позже и следуют [примечаниям доступности](/docs/ru/commands#all-commands) каждой команды. Чтобы изменить параметр из вызова `-p`, передайте `key=value` в `/config`, например `/config thinking=false`.

251</Note>251</Note>

252 252 

253<h3 id="customize-the-system-prompt">253<h3 id="customize-the-system-prompt">


262 --output-format json262 --output-format json

263```263```

264 264 

265См. [флаги системного запроса](/ru/cli-reference#system-prompt-flags) для получения дополнительных параметров, включая `--system-prompt` для полной замены запроса по умолчанию.265См. [флаги системного запроса](/docs/ru/cli-reference#system-prompt-flags) для получения дополнительных параметров, включая `--system-prompt` для полной замены запроса по умолчанию.

266 266 

267<h3 id="continue-conversations">267<h3 id="continue-conversations">

268 Продолжение разговоров268 Продолжение разговоров


286claude -p "Continue that review" --resume "$session_id"286claude -p "Continue that review" --resume "$session_id"

287```287```

288 288 

289Запустите обе команды из одного каталога: поиск ID сессии ограничен текущим каталогом проекта и его git worktrees. См. [Resume a session](/ru/sessions#resume-a-session) для полного набора правил области видимости.289Запустите обе команды из одного каталога: поиск ID сессии ограничен текущим каталогом проекта и его git worktrees. См. [Resume a session](/docs/ru/sessions#resume-a-session) для полного набора правил области видимости.

290 290 

291<h2 id="next-steps">291<h2 id="next-steps">

292 Следующие шаги292 Следующие шаги

293</h2>293</h2>

294 294 

295* [Agent SDK quickstart](/ru/agent-sdk/quickstart): создайте своего первого агента с помощью Python или TypeScript295* [Agent SDK quickstart](/docs/ru/agent-sdk/quickstart): создайте своего первого агента с помощью Python или TypeScript

296* [CLI reference](/ru/cli-reference): все флаги и параметры CLI296* [CLI reference](/docs/ru/cli-reference): все флаги и параметры CLI

297* [GitHub Actions](/ru/github-actions): используйте Agent SDK в рабочих процессах GitHub297* [GitHub Actions](/docs/ru/github-actions): используйте Agent SDK в рабочих процессах GitHub

298* [GitLab CI/CD](/ru/gitlab-ci-cd): используйте Agent SDK в конвейерах GitLab298* [GitLab CI/CD](/docs/ru/gitlab-ci-cd): используйте Agent SDK в конвейерах GitLab

hooks.md +9 −9

Details

326 326 

327Все совпадающие hooks запускаются параллельно, и идентичные обработчики автоматически дедублируются. Command hooks дедублируются по строке команды и `args`, а HTTP hooks дедублируются по URL.327Все совпадающие hooks запускаются параллельно, и идентичные обработчики автоматически дедублируются. Command hooks дедублируются по строке команды и `args`, а HTTP hooks дедублируются по URL.

328 328 

329Обработчики запускаются в текущем каталоге с окружением Claude Code. Переменная окружения `$CLAUDE_CODE_REMOTE` устанавливается на `"true"` в удалённых веб-окружениях и не устанавливается в локальном CLI. {/* min-version: 2.1.199 */}Начиная с v2.1.199, [`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/docs/ru/env-vars) устанавливается на ID сеанса [Remote Control](/docs/ru/remote-control) пока локальный сеанс имеет активное соединение Remote Control.329Обработчики запускаются в текущем каталоге с окружением Claude Code. Переменная окружения `$CLAUDE_CODE_REMOTE` устанавливается на `"true"` в удалённых веб-окружениях и не устанавливается в локальном CLI. Начиная с v2.1.199, [`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/docs/ru/env-vars) устанавливается на ID сеанса [Remote Control](/docs/ru/remote-control) пока локальный сеанс имеет активное соединение Remote Control.

330 330 

331<h4 id="common-fields">331<h4 id="common-fields">

332 Common fields332 Common fields


644| Поле | Описание |644| Поле | Описание |

645| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |645| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

646| `session_id` | Текущий идентификатор сеанса |646| `session_id` | Текущий идентификатор сеанса |

647| `prompt_id` | UUID, идентифицирующий пользовательский запрос, который в настоящее время обрабатывается. Совпадает с атрибутом [`prompt.id` на событиях OpenTelemetry](/docs/ru/monitoring-usage#event-correlation-attributes), поэтому вы можете коррелировать выход hook с телеметрией для одного запроса. Отсутствует до первого пользовательского ввода. {/* min-version: 2.1.196 */}Требует Claude Code v2.1.196 или позже |647| `prompt_id` | UUID, идентифицирующий пользовательский запрос, который в настоящее время обрабатывается. Совпадает с атрибутом [`prompt.id` на событиях OpenTelemetry](/docs/ru/monitoring-usage#event-correlation-attributes), поэтому вы можете коррелировать выход hook с телеметрией для одного запроса. Отсутствует до первого пользовательского ввода. Требует Claude Code v2.1.196 или позже |

648| `transcript_path` | Путь к JSON разговора. Файл транскрипта записывается асинхронно и может отставать от разговора в памяти, поэтому он может ещё не включать самые последние сообщения текущего хода, когда срабатывает hook. Hooks, которым нужен финальный текст ассистента текущего хода, должны использовать `last_assistant_message` на [Stop](#stop) и [SubagentStop](#subagentstop) вместо чтения транскрипта |648| `transcript_path` | Путь к JSON разговора. Файл транскрипта записывается асинхронно и может отставать от разговора в памяти, поэтому он может ещё не включать самые последние сообщения текущего хода, когда срабатывает hook. Hooks, которым нужен финальный текст ассистента текущего хода, должны использовать `last_assistant_message` на [Stop](#stop) и [SubagentStop](#subagentstop) вместо чтения транскрипта |

649| `cwd` | Текущий рабочий каталог при вызове hook |649| `cwd` | Текущий рабочий каталог при вызове hook |

650| `permission_mode` | Текущий [режим разрешения](/docs/ru/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` или `"bypassPermissions"`. Режим, обозначенный как **Manual**, поступает как `"default"`, никогда не как `"manual"`, поэтому скрипты, которые совпадают с `"default"`, продолжают работать. Не все события получают это поле. Проверьте пример JSON в каждом разделе [hook event](#hook-events) |650| `permission_mode` | Текущий [режим разрешения](/docs/ru/permissions#permission-modes): `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, `"dontAsk"` или `"bypassPermissions"`. Режим, обозначенный как **Manual**, поступает как `"default"`, никогда не как `"manual"`, поэтому скрипты, которые совпадают с `"default"`, продолжают работать. Не все события получают это поле. Проверьте пример JSON в каждом разделе [hook event](#hook-events) |


1567В `PostToolUse`, `tool_response` для завершённого вызова Agent содержит финальный текст subagent вместе с телеметрией использования. Читайте эти поля для записи затрат для каждого subagent из hook:1567В `PostToolUse`, `tool_response` для завершённого вызова Agent содержит финальный текст subagent вместе с телеметрией использования. Читайте эти поля для записи затрат для каждого subagent из hook:

1568 1568 

1569| Поле | Тип | Пример | Описание |1569| Поле | Тип | Пример | Описание |

1570| :------------------ | :----- | :---------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1570| :------------------ | :----- | :---------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1571| `status` | string | `"completed"` | `"completed"` для синхронных вызовов, `"async_launched"` для фоновых subagents. {/* min-version: 2.1.198 */}Начиная с v2.1.198, subagents запускаются в фоне по умолчанию, поэтому опущенный `run_in_background` также производит `"async_launched"` |1571| `status` | string | `"completed"` | `"completed"` для синхронных вызовов, `"async_launched"` для фоновых subagents. Начиная с v2.1.198, subagents запускаются в фоне по умолчанию, поэтому опущенный `run_in_background` также производит `"async_launched"` |

1572| `agentId` | string | `"a4d2c8f1e0b3a297"` | Идентификатор для запуска subagent |1572| `agentId` | string | `"a4d2c8f1e0b3a297"` | Идентификатор для запуска subagent |

1573| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Финальные текстовые блоки subagent |1573| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Финальные текстовые блоки subagent |

1574| `resolvedModel` | string | `"claude-sonnet-4-5"` | Модель, на которой запустился subagent, которая может отличаться от запрошенной модели. {/* min-version: 2.1.174 */}Требует Claude Code v2.1.174 или позже |1574| `resolvedModel` | string | `"claude-sonnet-4-5"` | Модель, на которой запустился subagent, которая может отличаться от запрошенной модели. Требует Claude Code v2.1.174 или позже |

1575| `totalTokens` | number | `12450` | Всего токенов, выставленных счётом по ходам subagent |1575| `totalTokens` | number | `12450` | Всего токенов, выставленных счётом по ходам subagent |

1576| `totalDurationMs` | number | `48211` | Реальная длительность запуска subagent |1576| `totalDurationMs` | number | `48211` | Реальная длительность запуска subagent |

1577| `totalToolUseCount` | number | `7` | Количество вызовов инструментов, которые сделал subagent |1577| `totalToolUseCount` | number | `7` | Количество вызовов инструментов, которые сделал subagent |


1601Представляет план и просит пользователя одобрить его перед тем, как Claude покинет [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude записывает план в файл на диск перед вызовом инструмента, поэтому буквальный `tool_input` от модели обычно пуст. Claude Code внедряет содержимое плана и путь файла перед передачей входных данных в hooks.1601Представляет план и просит пользователя одобрить его перед тем, как Claude покинет [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude записывает план в файл на диск перед вызовом инструмента, поэтому буквальный `tool_input` от модели обычно пуст. Claude Code внедряет содержимое плана и путь файла перед передачей входных данных в hooks.

1602 1602 

1603| Поле | Тип | Пример | Описание |1603| Поле | Тип | Пример | Описание |

1604| :--------------- | :----- | :------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1604| :--------------- | :----- | :------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1605| `plan` | string | `"## Refactor auth\n1. Extract..."` | Содержимое плана в Markdown. Внедрено из файла плана на диске |1605| `plan` | string | `"## Refactor auth\n1. Extract..."` | Содержимое плана в Markdown. Внедрено из файла плана на диске |

1606| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Путь к файлу плана. Внедрено |1606| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Путь к файлу плана. Внедрено |

1607| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | {/* min-version: 2.1.205 */}Устарело. Claude Code принимает поле, но игнорирует его. До v2.1.205 оно содержало разрешения на основе подсказки, которые Claude запрашивал для реализации плана |1607| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Устарело. Claude Code принимает поле, но игнорирует его. До v2.1.205 оно содержало разрешения на основе подсказки, которые Claude запрашивал для реализации плана |

1608 1608 

1609В `PostToolUse`, `tool_response` — это объект с полями `plan` и `filePath`, содержащими одобренный план, плюс внутренние флаги статуса. Читайте `tool_response.plan` для содержимого плана, а не перечитывайте файл с диска.1609В `PostToolUse`, `tool_response` — это объект с полями `plan` и `filePath`, содержащими одобренный план, плюс внутренние флаги статуса. Читайте `tool_response.plan` для содержимого плана, а не перечитывайте файл с диска.

1610 1610 


1762Поле выхода `updatedPermissions` и поле входа [`permission_suggestions`](#permissionrequest-input) оба используют один и тот же массив объектов записей. Каждая запись имеет `type`, который определяет её другие поля, и `destination`, который управляет тем, где применяется изменение.1762Поле выхода `updatedPermissions` и поле входа [`permission_suggestions`](#permissionrequest-input) оба используют один и тот же массив объектов записей. Каждая запись имеет `type`, который определяет её другие поля, и `destination`, который управляет тем, где применяется изменение.

1763 1763 

1764| `type` | Поля | Эффект |1764| `type` | Поля | Эффект |

1765| :------------------ | :--------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1765| :------------------ | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1766| `addRules` | `rules`, `behavior`, `destination` | Добавляет правила разрешения. `rules` — это массив объектов `{toolName, ruleContent?}`. Опустите `ruleContent` для совпадения со всем инструментом. `behavior` — это `"allow"`, `"deny"` или `"ask"` |1766| `addRules` | `rules`, `behavior`, `destination` | Добавляет правила разрешения. `rules` — это массив объектов `{toolName, ruleContent?}`. Опустите `ruleContent` для совпадения со всем инструментом. `behavior` — это `"allow"`, `"deny"` или `"ask"` |

1767| `replaceRules` | `rules`, `behavior`, `destination` | Заменяет все правила данного `behavior` в `destination` предоставленными `rules` |1767| `replaceRules` | `rules`, `behavior`, `destination` | Заменяет все правила данного `behavior` в `destination` предоставленными `rules` |

1768| `removeRules` | `rules`, `behavior`, `destination` | Удаляет совпадающие правила данного `behavior` |1768| `removeRules` | `rules`, `behavior`, `destination` | Удаляет совпадающие правила данного `behavior` |

1769| `setMode` | `mode`, `destination` | Изменяет режим разрешения. Допустимые режимы — `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` и {/* min-version: 2.1.200 */}`manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже |1769| `setMode` | `mode`, `destination` | Изменяет режим разрешения. Допустимые режимы — `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` и `manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже |

1770| `addDirectories` | `directories`, `destination` | Добавляет рабочие каталоги. `directories` — это массив строк пути |1770| `addDirectories` | `directories`, `destination` | Добавляет рабочие каталоги. `directories` — это массив строк пути |

1771| `removeDirectories` | `directories`, `destination` | Удаляет рабочие каталоги |1771| `removeDirectories` | `directories`, `destination` | Удаляет рабочие каталоги |

1772 1772 

hooks-guide.md +1 −1

Details

654}654}

655```655```

656 656 

657Matcher `"Edit|Write"` срабатывает только, когда Claude использует инструмент `Edit` или `Write`, а не когда он использует `Bash`, `Read` или любой другой инструмент. {/* min-version: 2.1.191 */}На Claude Code v2.1.191 или позже запятая разделяет альтернативы так же, поэтому `"Edit, Write"` эквивалентна. См. [Matcher patterns](/docs/ru/hooks#matcher-patterns) для того, как простые имена и регулярные выражения оцениваются.657Matcher `"Edit|Write"` срабатывает только, когда Claude использует инструмент `Edit` или `Write`, а не когда он использует `Bash`, `Read` или любой другой инструмент. На Claude Code v2.1.191 или позже запятая разделяет альтернативы так же, поэтому `"Edit, Write"` эквивалентна. См. [Matcher patterns](/docs/ru/hooks#matcher-patterns) для того, как простые имена и регулярные выражения оцениваются.

658 658 

659<Note>659<Note>

660 Claude может также создавать или изменять файлы, запуская команды оболочки через инструмент `Bash`. Если ваш hook должен видеть каждое изменение файла, например для сканирования соответствия или логирования аудита, добавьте hook [`Stop`](/docs/ru/hooks#stop), который сканирует рабочее дерево один раз за ход. Для покрытия за вызов вместо этого также соответствуйте `Bash` и пусть ваш скрипт перечисляет изменённые и неотслеживаемые файлы с помощью `git status --porcelain`.660 Claude может также создавать или изменять файлы, запуская команды оболочки через инструмент `Bash`. Если ваш hook должен видеть каждое изменение файла, например для сканирования соответствия или логирования аудита, добавьте hook [`Stop`](/docs/ru/hooks#stop), который сканирует рабочее дерево один раз за ход. Для покрытия за вызов вместо этого также соответствуйте `Bash` и пусть ваш скрипт перечисляет изменённые и неотслеживаемые файлы с помощью `git status --porcelain`.

Details

11</h2>11</h2>

12 12 

13<Note>13<Note>

14 Сочетания клавиш могут отличаться в зависимости от платформы и терминала. В [полноэкранном режиме](/ru/fullscreen) нажмите `?` в просмотре транскрипции, чтобы увидеть доступные сочетания клавиш там.14 Сочетания клавиш могут отличаться в зависимости от платформы и терминала. В [полноэкранном режиме](/docs/ru/fullscreen) нажмите `?` в просмотре транскрипции, чтобы увидеть доступные сочетания клавиш там.

15 15 

16 **Пользователи macOS**: сочетания клавиш с клавишей Option/Alt (`Alt+B`, `Alt+F`, `Alt+Y`, `Alt+M`, `Alt+P`) требуют настройки Option как Meta в вашем терминале:16 **Пользователи macOS**: сочетания клавиш с клавишей Option/Alt (`Alt+B`, `Alt+F`, `Alt+Y`, `Alt+M`, `Alt+P`) требуют настройки Option как Meta в вашем терминале:

17 17 


19 * **Apple Terminal**: Settings → Profiles → Keyboard → отметьте "Use Option as Meta Key"19 * **Apple Terminal**: Settings → Profiles → Keyboard → отметьте "Use Option as Meta Key"

20 * **VS Code**: установите `"terminal.integrated.macOptionIsMeta": true` в параметрах VS Code20 * **VS Code**: установите `"terminal.integrated.macOptionIsMeta": true` в параметрах VS Code

21 21 

22 Подробнее см. в разделе [Конфигурация терминала](/ru/terminal-config).22 Подробнее см. в разделе [Конфигурация терминала](/docs/ru/terminal-config).

23</Note>23</Note>

24 24 

25<h3 id="general-controls">25<h3 id="general-controls">


27</h3>27</h3>

28 28 

29| Сочетание клавиш | Описание | Контекст |29| Сочетание клавиш | Описание | Контекст |

30| :-------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |30| :-------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

31| `Ctrl+C` | Прервать или очистить ввод | Прерывает выполняемую операцию. Если ничего не выполняется, первое нажатие очищает ввод запроса, а второе нажатие выходит из Claude Code |31| `Ctrl+C` | Прервать или очистить ввод | Прерывает выполняемую операцию. Если ничего не выполняется, первое нажатие очищает ввод запроса, а второе нажатие выходит из Claude Code |

32| `Ctrl+X Ctrl+K` | Завершить всех выполняющихся [фоновых подагентов](/ru/sub-agents#run-subagents-in-foreground-or-background) в этом сеансе. Нажмите дважды в течение 3 секунд для подтверждения | Управление подагентами |32| `Ctrl+X Ctrl+K` | Завершить всех выполняющихся [фоновых подагентов](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) в этом сеансе. Нажмите дважды в течение 3 секунд для подтверждения | Управление подагентами |

33| `Ctrl+D` | Выход из сеанса Claude Code | Сигнал EOF |33| `Ctrl+D` | Выход из сеанса Claude Code | Сигнал EOF |

34| `Ctrl+G` или `Ctrl+X Ctrl+E` | Открыть в текстовом редакторе по умолчанию | Отредактируйте ваш запрос или пользовательский ответ в текстовом редакторе по умолчанию. `Ctrl+X Ctrl+E` — это встроенная привязка readline. Включите Show last response in external editor в `/config` для добавления предыдущего ответа Claude в виде контекста с комментариями `#` выше вашего запроса; блок комментариев удаляется при сохранении |34| `Ctrl+G` или `Ctrl+X Ctrl+E` | Открыть в текстовом редакторе по умолчанию | Отредактируйте ваш запрос или пользовательский ответ в текстовом редакторе по умолчанию. `Ctrl+X Ctrl+E` — это встроенная привязка readline. Включите Show last response in external editor в `/config` для добавления предыдущего ответа Claude в виде контекста с комментариями `#` выше вашего запроса; блок комментариев удаляется при сохранении |

35| `Ctrl+L` | Перерисовать экран | Принудительно выполняет полную перерисовку терминала. Ввод и история разговора сохраняются. Используйте это для восстановления, если дисплей становится искаженным или частично пустым |35| `Ctrl+L` | Перерисовать экран | Принудительно выполняет полную перерисовку терминала. Ввод и история разговора сохраняются. Используйте это для восстановления, если дисплей становится искаженным или частично пустым |


37| `Ctrl+R` | Поиск в истории команд в обратном порядке | Интерактивный поиск по предыдущим командам |37| `Ctrl+R` | Поиск в истории команд в обратном порядке | Интерактивный поиск по предыдущим командам |

38| `Ctrl+V` или `Cmd+V` (iTerm2) или `Alt+V` (Windows и WSL) | Вставить изображение из буфера обмена | Вставляет чип `[Image #N]` в позицию курсора, чтобы вы могли ссылаться на него позиционно в вашем запросе. На WSL оба `Ctrl+V` и `Alt+V` привязаны; используйте `Alt+V`, если ваш терминал перехватывает `Ctrl+V` |38| `Ctrl+V` или `Cmd+V` (iTerm2) или `Alt+V` (Windows и WSL) | Вставить изображение из буфера обмена | Вставляет чип `[Image #N]` в позицию курсора, чтобы вы могли ссылаться на него позиционно в вашем запросе. На WSL оба `Ctrl+V` и `Alt+V` привязаны; используйте `Alt+V`, если ваш терминал перехватывает `Ctrl+V` |

39| `Ctrl+B` | Фоновое выполнение задач | Переводит bash команды и агентов в фоновый режим. Пользователи Tmux нажимают дважды |39| `Ctrl+B` | Фоновое выполнение задач | Переводит bash команды и агентов в фоновый режим. Пользователи Tmux нажимают дважды |

40| `Ctrl+T` | Переключить список задач Claude | Показать или скрыть [список задач Claude](#task-list) в области статуса. Это не просмотр фоновых задач; используйте [`/tasks`](/ru/commands) для просмотра выполняющихся оболочек и подагентов |40| `Ctrl+T` | Переключить список задач Claude | Показать или скрыть [список задач Claude](#task-list) в области статуса. Это не просмотр фоновых задач; используйте [`/tasks`](/docs/ru/commands) для просмотра выполняющихся оболочек и подагентов |

41| `Left/Right arrows` | Переключение между вкладками диалога | Навигация между вкладками в диалогах разрешений и меню |41| `Left/Right arrows` | Переключение между вкладками диалога | Навигация между вкладками в диалогах разрешений и меню |

42| `Up/Down arrows` или `Ctrl+P`/`Ctrl+N` | Переместить курсор или навигировать по истории команд | Когда ввод занимает более одной визуальной строки, будь то обернутый или многострочный, сначала перемещает курсор внутри запроса. Когда курсор находится на первой или последней визуальной строке, повторное нажатие навигирует по истории команд. {/* min-version: 2.1.169 */}Начиная с версии 2.1.169, обернутый однострочный ввод ведет себя так же, как многострочный |42| `Up/Down arrows` или `Ctrl+P`/`Ctrl+N` | Переместить курсор или навигировать по истории команд | Когда ввод занимает более одной визуальной строки, будь то обернутый или многострочный, сначала перемещает курсор внутри запроса. Когда курсор находится на первой или последней визуальной строке, повторное нажатие навигирует по истории команд. Начиная с версии 2.1.169, обернутый однострочный ввод ведет себя так же, как многострочный |

43| `Esc` | Прервать Claude или закрыть диалог | Остановите текущий ответ или вызов инструмента в середине хода, чтобы вы могли перенаправить. Claude сохраняет выполненную работу. Когда открыт диалог, такой как запрос разрешения, `Esc` закрывает диалог, а не прерывает Claude. {/* min-version: 2.1.202 */}До версии 2.1.202 `Esc` в некоторых диалогах прерывал Claude и оставлял диалог открытым |43| `Esc` | Прервать Claude или закрыть диалог | Остановите текущий ответ или вызов инструмента в середине хода, чтобы вы могли перенаправить. Claude сохраняет выполненную работу. Когда открыт диалог, такой как запрос разрешения, `Esc` закрывает диалог, а не прерывает Claude. До версии 2.1.202 `Esc` в некоторых диалогах прерывал Claude и оставлял диалог открытым |

44| `Esc` + `Esc` | Очистить черновик ввода или перемотать | Когда ввод запроса содержит текст, двойное нажатие `Esc` очищает его и сохраняет черновик в историю, чтобы `Up` мог его вспомнить. Когда ввод пуст, двойное нажатие `Esc` открывает [меню перемотки](/ru/checkpointing) для восстановления или резюме кода и разговора из предыдущей точки |44| `Esc` + `Esc` | Очистить черновик ввода или перемотать | Когда ввод запроса содержит текст, двойное нажатие `Esc` очищает его и сохраняет черновик в историю, чтобы `Up` мог его вспомнить. Когда ввод пуст, двойное нажатие `Esc` открывает [меню перемотки](/docs/ru/checkpointing) для восстановления или резюме кода и разговора из предыдущей точки |

45| `Shift+Tab` или `Alt+M` (некоторые конфигурации) | Переключить режимы разрешений | Переключайтесь между `default` (обозначено как Manual в индикаторе режима), `acceptEdits`, `plan` и любыми включенными вами режимами, такими как `auto` или `bypassPermissions`. См. [режимы разрешений](/ru/permission-modes). |45| `Shift+Tab` или `Alt+M` (некоторые конфигурации) | Переключить режимы разрешений | Переключайтесь между `default` (обозначено как Manual в индикаторе режима), `acceptEdits`, `plan` и любыми включенными вами режимами, такими как `auto` или `bypassPermissions`. См. [режимы разрешений](/docs/ru/permission-modes). |

46| `Option+P` (macOS) или `Alt+P` (Windows/Linux) | Переключить модель | Переключайте модели без очистки вашего запроса |46| `Option+P` (macOS) или `Alt+P` (Windows/Linux) | Переключить модель | Переключайте модели без очистки вашего запроса |

47| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключить расширенное мышление | Включите или отключите режим расширенного мышления. Не влияет на Fable 5, который всегда использует расширенное мышление. {/* min-version: 2.1.132 */}Начиная с версии 2.1.132 это сочетание клавиш работает на macOS без настройки Option как Meta |47| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключить расширенное мышление | Включите или отключите режим расширенного мышления. Не влияет на Fable 5, который всегда использует расширенное мышление. Начиная с версии 2.1.132 это сочетание клавиш работает на macOS без настройки Option как Meta |

48| `Option+O` (macOS) или `Alt+O` (Windows/Linux) | Переключить быстрый режим | Включите или отключите [быстрый режим](/ru/fast-mode) |48| `Option+O` (macOS) или `Alt+O` (Windows/Linux) | Переключить быстрый режим | Включите или отключите [быстрый режим](/docs/ru/fast-mode) |

49 49 

50<h3 id="text-editing">50<h3 id="text-editing">

51 Редактирование текста51 Редактирование текста


78| Метод | Сочетание клавиш | Контекст |78| Метод | Сочетание клавиш | Контекст |

79| :----------------------------- | :---------------- | :--------------------------------------------------------------------------------------------------- |79| :----------------------------- | :---------------- | :--------------------------------------------------------------------------------------------------- |

80| Быстрый выход | `\` + `Enter` | Работает во всех терминалах |80| Быстрый выход | `\` + `Enter` | Работает во всех терминалах |

81| Клавиша Option | `Option+Enter` | После включения [Option как Meta](/ru/terminal-config#enable-option-key-shortcuts-on-macos) на macOS |81| Клавиша Option | `Option+Enter` | После включения [Option как Meta](/docs/ru/terminal-config#enable-option-key-shortcuts-on-macos) на macOS |

82| Shift+Enter | `Shift+Enter` | Встроено в iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal |82| Shift+Enter | `Shift+Enter` | Встроено в iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal |

83| Управляющая последовательность | `Ctrl+J` | Работает в любом терминале без конфигурации |83| Управляющая последовательность | `Ctrl+J` | Работает в любом терминале без конфигурации |

84| Режим вставки | Вставить напрямую | Для блоков кода, логов |84| Режим вставки | Вставить напрямую | Для блоков кода, логов |


93 93 

94| Сочетание клавиш | Описание | Примечания |94| Сочетание клавиш | Описание | Примечания |

95| :--------------- | :---------------------- | :------------------------------------------------------------------------------------------- |95| :--------------- | :---------------------- | :------------------------------------------------------------------------------------------- |

96| `/` в начале | Команда или skill | См. [команды](#commands) и [skills](/ru/skills) |96| `/` в начале | Команда или skill | См. [команды](#commands) и [skills](/docs/ru/skills) |

97| `!` в начале | Режим Bash | Запускайте команды напрямую, добавляйте их вывод в сеанс и позволяйте Claude ответить на них |97| `!` в начале | Режим Bash | Запускайте команды напрямую, добавляйте их вывод в сеанс и позволяйте Claude ответить на них |

98| `@` | Упоминание пути к файлу | Запустить автодополнение пути к файлу |98| `@` | Упоминание пути к файлу | Запустить автодополнение пути к файлу |

99 99 


101 Просмотр транскрипции101 Просмотр транскрипции

102</h3>102</h3>

103 103 

104Когда просмотр транскрипции открыт (переключается с помощью `Ctrl+O`), доступны эти сочетания клавиш. В [полноэкранном режиме](/ru/fullscreen) нажмите `?` для отображения полной справочной панели сочетаний клавиш внутри просмотра. `Ctrl+E` можно переназначить через [`transcript:toggleShowAll`](/ru/keybindings).104Когда просмотр транскрипции открыт (переключается с помощью `Ctrl+O`), доступны эти сочетания клавиш. В [полноэкранном режиме](/docs/ru/fullscreen) нажмите `?` для отображения полной справочной панели сочетаний клавиш внутри просмотра. `Ctrl+E` можно переназначить через [`transcript:toggleShowAll`](/docs/ru/keybindings).

105 105 

106| Сочетание клавиш | Описание |106| Сочетание клавиш | Описание |

107| :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |107| :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

108| `?` | Переключить панель справки по сочетаниям клавиш. Требует [полноэкранного режима](/ru/fullscreen) |108| `?` | Переключить панель справки по сочетаниям клавиш. Требует [полноэкранного режима](/docs/ru/fullscreen) |

109| `{` / `}` | Перейти к предыдущему или следующему запросу пользователя, как движение абзаца в vim. Требует [полноэкранного режима](/ru/fullscreen) |109| `{` / `}` | Перейти к предыдущему или следующему запросу пользователя, как движение абзаца в vim. Требует [полноэкранного режима](/docs/ru/fullscreen) |

110| `Ctrl+E` | Переключить показ всего содержимого |110| `Ctrl+E` | Переключить показ всего содержимого |

111| `[` | Записать полный разговор в собственный буфер прокрутки вашего терминала, чтобы `Cmd+F`, режим копирования tmux и другие встроенные инструменты могли его искать. Требует [полноэкранного режима](/ru/fullscreen#search-and-review-the-conversation) |111| `[` | Записать полный разговор в собственный буфер прокрутки вашего терминала, чтобы `Cmd+F`, режим копирования tmux и другие встроенные инструменты могли его искать. Требует [полноэкранного режима](/docs/ru/fullscreen#search-and-review-the-conversation) |

112| `v` | Записать разговор во временный файл и открыть его в `$VISUAL` или `$EDITOR`. Требует [полноэкранного режима](/ru/fullscreen) |112| `v` | Записать разговор во временный файл и открыть его в `$VISUAL` или `$EDITOR`. Требует [полноэкранного режима](/docs/ru/fullscreen) |

113| `q`, `Ctrl+C`, `Esc` | Выход из просмотра транскрипции. Все три можно переназначить через [`transcript:exit`](/ru/keybindings) |113| `q`, `Ctrl+C`, `Esc` | Выход из просмотра транскрипции. Все три можно переназначить через [`transcript:exit`](/docs/ru/keybindings) |

114 114 

115<h3 id="voice-input">115<h3 id="voice-input">

116 Голосовой ввод116 Голосовой ввод


118 118 

119| Сочетание клавиш | Описание | Примечания |119| Сочетание клавиш | Описание | Примечания |

120| :-------------------------------- | :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |120| :-------------------------------- | :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

121| Удерживайте или нажимайте `Space` | Голосовая диктовка | Требует включения [голосовой диктовки](/ru/voice-dictation). Удерживайте для записи, или запустите `/voice tap` для переключения нажатием. [Переназначаемо](/ru/voice-dictation#rebind-the-dictation-key) |121| Удерживайте или нажимайте `Space` | Голосовая диктовка | Требует включения [голосовой диктовки](/docs/ru/voice-dictation). Удерживайте для записи, или запустите `/voice tap` для переключения нажатием. [Переназначаемо](/docs/ru/voice-dictation#rebind-the-dictation-key) |

122 122 

123<h2 id="commands">123<h2 id="commands">

124 Команды124 Команды

125</h2>125</h2>

126 126 

127Введите `/` в Claude Code, чтобы увидеть все доступные команды, или введите `/` с последующими буквами для фильтрации. Меню `/` показывает все, что вы можете вызвать: встроенные команды, встроенные и созданные пользователем [skills](/ru/skills), и команды, предоставленные [plugins](/ru/plugins) и [MCP servers](/ru/mcp#use-mcp-prompts-as-commands). Не все встроенные команды видны каждому пользователю, так как некоторые зависят от вашей платформы или плана.127Введите `/` в Claude Code, чтобы увидеть все доступные команды, или введите `/` с последующими буквами для фильтрации. Меню `/` показывает все, что вы можете вызвать: встроенные команды, встроенные и созданные пользователем [skills](/docs/ru/skills), и команды, предоставленные [plugins](/docs/ru/plugins) и [MCP servers](/docs/ru/mcp#use-mcp-prompts-as-commands). Не все встроенные команды видны каждому пользователю, так как некоторые зависят от вашей платформы или плана.

128 128 

129В [полноэкранном режиме отображения](/ru/fullscreen#use-the-mouse) меню команд `/` и список предложений файлов `@` также реагируют на мышь: наведение выделяет строку, а щелчок принимает её.129В [полноэкранном режиме отображения](/docs/ru/fullscreen#use-the-mouse) меню команд `/` и список предложений файлов `@` также реагируют на мышь: наведение выделяет строку, а щелчок принимает её.

130 130 

131Полный список команд, включенных в Claude Code, см. в [справочнике команд](/ru/commands).131Полный список команд, включенных в Claude Code, см. в [справочнике команд](/docs/ru/commands).

132 132 

133<h2 id="vim-editor-mode">133<h2 id="vim-editor-mode">

134 Режим редактора Vim134 Режим редактора Vim


156 Переназначение последовательностей клавиш в режиме INSERT156 Переназначение последовательностей клавиш в режиме INSERT

157</h3>157</h3>

158 158 

159Параметр [`vimInsertModeRemaps`](/ru/settings#available-settings) отображает двухклавишную последовательность режима INSERT на Escape, поэтому такое отображение, как `jj`, возвращает вас в режим NORMAL. {/* min-version: 2.1.208 */}Требуется Claude Code v2.1.208 или позже.159Параметр [`vimInsertModeRemaps`](/docs/ru/settings#available-settings) отображает двухклавишную последовательность режима INSERT на Escape, поэтому такое отображение, как `jj`, возвращает вас в режим NORMAL. Требуется Claude Code v2.1.208 или позже.

160 160 

161Следующий пример `~/.claude/settings.json` включает режим vim и отображает `jj` на Escape:161Следующий пример `~/.claude/settings.json` включает режим vim и отображает `jj` на Escape:

162 162 


171 171 

172Ввод первого символа последовательности вставляет его обычным образом. Нажатие второго символа в течение одной секунды удаляет этот ожидающий символ и переключается в режим NORMAL, оставляя оба символа вне вашего ввода. После окна в одну секунду или если следует другая клавиша, оба символа остаются как буквальный текст, поэтому вы всё ещё можете ввести слово, содержащее последовательность, сделав паузу между двумя клавишами.172Ввод первого символа последовательности вставляет его обычным образом. Нажатие второго символа в течение одной секунды удаляет этот ожидающий символ и переключается в режим NORMAL, оставляя оба символа вне вашего ввода. После окна в одну секунду или если следует другая клавиша, оба символа остаются как буквальный текст, поэтому вы всё ещё можете ввести слово, содержащее последовательность, сделав паузу между двумя клавишами.

173 173 

174Claude Code читает этот параметр из вашего файла пользовательских параметров, флага `--settings` и [управляемых параметров](/ru/permissions#managed-settings) только. Записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются, поэтому проверенный репозиторий не может переназначить ваши нажатия клавиш.174Claude Code читает этот параметр из вашего файла пользовательских параметров, флага `--settings` и [управляемых параметров](/docs/ru/permissions#managed-settings) только. Записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются, поэтому проверенный репозиторий не может переназначить ваши нажатия клавиш.

175 175 

176<h3 id="navigation-normal-mode">176<h3 id="navigation-normal-mode">

177 Навигация (режим NORMAL)177 Навигация (режим NORMAL)

178</h3>178</h3>

179 179 

180| Команда | Действие |180| Команда | Действие |

181| :-------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |181| :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

182| `h`/`j`/`k`/`l` | Переместиться влево/вниз/вверх/вправо |182| `h`/`j`/`k`/`l` | Переместиться влево/вниз/вверх/вправо |

183| `Space` | Переместиться вправо |183| `Space` | Переместиться вправо |

184| `w` | Следующее слово |184| `w` | Следующее слово |


195| `T{char}` | Перейти прямо после предыдущего вхождения символа |195| `T{char}` | Перейти прямо после предыдущего вхождения символа |

196| `;` | Повторить последнее движение f/F/t/T |196| `;` | Повторить последнее движение f/F/t/T |

197| `,` | Повторить последнее движение f/F/t/T в обратном порядке |197| `,` | Повторить последнее движение f/F/t/T в обратном порядке |

198| `/` | Открыть поиск по истории в обратном порядке, то же самое, что `Ctrl+R`. {/* min-version: 2.1.191 */}Начиная с версии 2.1.191, пустая подсказка поиска показывает подсказку: нажмите `Esc`, затем `i`, затем `/` для открытия меню команд вместо этого |198| `/` | Открыть поиск по истории в обратном порядке, то же самое, что `Ctrl+R`. Начиная с версии 2.1.191, пустая подсказка поиска показывает подсказку: нажмите `Esc`, затем `i`, затем `/` для открытия меню команд вместо этого |

199 199 

200<Note>200<Note>

201 В режиме vim normal, если курсор находится в начале или конце ввода и не может двигаться дальше, клавиши `j`/`k` и стрелки вместо этого навигируют по истории команд.201 В режиме vim normal, если курсор находится в начале или конце ввода и не может двигаться дальше, клавиши `j`/`k` и стрелки вместо этого навигируют по истории команд.


316 316 

317* Вывод записывается в файл и Claude может получить его с помощью инструмента Read317* Вывод записывается в файл и Claude может получить его с помощью инструмента Read

318* Фоновые задачи имеют уникальные ID для отслеживания и получения вывода318* Фоновые задачи имеют уникальные ID для отслеживания и получения вывода

319* Фоновые задачи автоматически очищаются при выходе из Claude Code. Фоновое выполнение сеанса вместо выхода передает их фоновому сеансу, где они продолжают работать. См. [фоновое выполнение работающего сеанса](/ru/agent-view#from-inside-a-session)319* Фоновые задачи автоматически очищаются при выходе из Claude Code. Фоновое выполнение сеанса вместо выхода передает их фоновому сеансу, где они продолжают работать. См. [фоновое выполнение работающего сеанса](/docs/ru/agent-view#from-inside-a-session)

320* Фоновые задачи автоматически завершаются, если вывод превышает 5GB, с примечанием в stderr, объясняющим почему320* Фоновые задачи автоматически завершаются, если вывод превышает 5GB, с примечанием в stderr, объясняющим почему

321* {/* min-version: 2.1.193 */}Начиная с версии 2.1.193, на macOS и Linux работающие фоновые задачи завершаются, когда операционная система сигнализирует о нехватке памяти, при условии, что сеанс был неактивен не менее 30 минут без выполнения хода или подагента. Установите [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/ru/env-vars) на `1`, чтобы отключить это321* Начиная с версии 2.1.193, на macOS и Linux работающие фоновые задачи завершаются, когда операционная система сигнализирует о нехватке памяти, при условии, что сеанс был неактивен не менее 30 минут без выполнения хода или подагента. Установите [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/ru/env-vars) на `1`, чтобы отключить это

322 322 

323Чтобы отключить всю функциональность фоновых задач, установите переменную окружения `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1`. Подробнее см. в разделе [Переменные окружения](/ru/env-vars).323Чтобы отключить всю функциональность фоновых задач, установите переменную окружения `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1`. Подробнее см. в разделе [Переменные окружения](/docs/ru/env-vars).

324 324 

325**Обычные фоновые команды:**325**Обычные фоновые команды:**

326 326 


349* Поддерживает то же самое `Ctrl+B` фоновое выполнение для долгоживущих команд349* Поддерживает то же самое `Ctrl+B` фоновое выполнение для долгоживущих команд

350* Не требует интерпретации или одобрения команды Claude350* Не требует интерпретации или одобрения команды Claude

351* Поддерживает автодополнение на основе истории: введите частичную команду и нажмите `Tab` для завершения из предыдущих команд `!` в текущем проекте351* Поддерживает автодополнение на основе истории: введите частичную команду и нажмите `Tab` для завершения из предыдущих команд `!` в текущем проекте

352* {/* min-version: 2.1.193 */}Поддерживает автодополнение пути к файлу в реальном времени начиная с версии 2.1.193 на всех платформах: введите токен, содержащий прямую косую черту, такой как `./src/` или `~/`, чтобы увидеть раскрывающийся список совпадающих файлов и каталогов, затем нажмите `Tab` для принятия. Используйте прямые косые черты на Windows тоже; раскрывающийся список вызывается `/`, а не `\`352* Поддерживает автодополнение пути к файлу в реальном времени начиная с версии 2.1.193 на всех платформах: введите токен, содержащий прямую косую черту, такой как `./src/` или `~/`, чтобы увидеть раскрывающийся список совпадающих файлов и каталогов, затем нажмите `Tab` для принятия. Используйте прямые косые черты на Windows тоже; раскрывающийся список вызывается `/`, а не `\`

353* Выход с помощью `Escape`, `Backspace` или `Ctrl+U` на пустом запросе353* Выход с помощью `Escape`, `Backspace` или `Ctrl+U` на пустом запросе

354* Вставка текста, начинающегося с `!`, в пустой запрос автоматически входит в режим bash, соответствуя поведению введенного `!`354* Вставка текста, начинающегося с `!`, в пустой запрос автоматически входит в режим bash, соответствуя поведению введенного `!`

355 355 

356Начиная с версии 2.1.186, Claude автоматически отвечает на вывод команды, как только он появляется в расшифровке, поэтому вы можете запустить `! npm test` и получить объяснение ошибок без второго запроса. Ответ стоит столько же, сколько отправка обычного запроса. Чтобы восстановить более раннее поведение, при котором вывод добавляется в контекст без ответа, установите [`respondToBashCommands`](/ru/settings#available-settings) на `false` в `settings.json`. До версии 2.1.186 режим bash всегда добавлял вывод в контекст без ответа.356Начиная с версии 2.1.186, Claude автоматически отвечает на вывод команды, как только он появляется в расшифровке, поэтому вы можете запустить `! npm test` и получить объяснение ошибок без второго запроса. Ответ стоит столько же, сколько отправка обычного запроса. Чтобы восстановить более раннее поведение, при котором вывод добавляется в контекст без ответа, установите [`respondToBashCommands`](/docs/ru/settings#available-settings) на `false` в `settings.json`. До версии 2.1.186 режим bash всегда добавлял вывод в контекст без ответа.

357 357 

358Это полезно для быстрых операций оболочки при сохранении контекста разговора.358Это полезно для быстрых операций оболочки при сохранении контекста разговора.

359 359 


370 370 

371Предложение запускается как фоновый запрос, который повторно использует кэш запроса родительского разговора, поэтому дополнительная стоимость минимальна. Claude Code пропускает генерацию предложений, когда кэш холодный, чтобы избежать ненужных затрат.371Предложение запускается как фоновый запрос, который повторно использует кэш запроса родительского разговора, поэтому дополнительная стоимость минимальна. Claude Code пропускает генерацию предложений, когда кэш холодный, чтобы избежать ненужных затрат.

372 372 

373Предложения автоматически пропускаются после первого хода разговора и в режиме плана. В режиме печати они отключены по умолчанию. Передайте [`--prompt-suggestions`](/ru/cli-reference#cli-flags) с `--output-format stream-json --verbose` для отправки сообщения `prompt_suggestion` после каждого хода вместо этого.373Предложения автоматически пропускаются после первого хода разговора и в режиме плана. В режиме печати они отключены по умолчанию. Передайте [`--prompt-suggestions`](/docs/ru/cli-reference#cli-flags) с `--output-format stream-json --verbose` для отправки сообщения `prompt_suggestion` после каждого хода вместо этого.

374 374 

375Чтобы полностью отключить предложения запросов, установите переменную окружения или переключите параметр в `/config`:375Чтобы полностью отключить предложения запросов, установите переменную окружения или переключите параметр в `/config`:

376 376 


403| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |403| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

404| `Space`, `Enter`, `Escape` | Отклонить ответ и вернуться к запросу |404| `Space`, `Enter`, `Escape` | Отклонить ответ и вернуться к запросу |

405| `Up` / `Down` | Прокрутить ответ |405| `Up` / `Down` | Прокрутить ответ |

406| `Left` / `Right` | {/* min-version: 2.1.187 */}Переключаться между этим ответом и вашими более ранними ответами `/btw` из сеанса. `Left` переходит к более старым ответам, а `Right` возвращается к текущему. Требуется Claude Code v2.1.187 или позже |406| `Left` / `Right` | Переключаться между этим ответом и вашими более ранними ответами `/btw` из сеанса. `Left` переходит к более старым ответам, а `Right` возвращается к текущему. Требуется Claude Code v2.1.187 или позже |

407| `c` | Скопировать ответ в буфер обмена как исходный Markdown. Используйте это вместо выделения мышью, которое захватывает жесткий перенос терминала, а не исходный текст |407| `c` | Скопировать ответ в буфер обмена как исходный Markdown. Используйте это вместо выделения мышью, которое захватывает жесткий перенос терминала, а не исходный текст |

408| `f` | Разветвить в новый сеанс. Разветвление наследует родительский разговор плюс этот вопрос и ответ как реальные ходы транскрипта, поэтому вы можете продолжить с полным доступом к инструментам. Исходный сеанс сохраняется под [`/resume`](/ru/commands). Доступно только в локальных сеансах |408| `f` | Разветвить в новый сеанс. Разветвление наследует родительский разговор плюс этот вопрос и ответ как реальные ходы транскрипта, поэтому вы можете продолжить с полным доступом к инструментам. Исходный сеанс сохраняется под [`/resume`](/docs/ru/commands). Доступно только в локальных сеансах |

409| `x` | Очистить список более ранних обменов `/btw`, показанный выше текущего ответа |409| `x` | Очистить список более ранних обменов `/btw`, показанный выше текущего ответа |

410 410 

411`/btw` является противоположностью [subagent](/ru/sub-agents): он видит ваш полный разговор, но не имеет инструментов, в то время как subagent имеет полные инструменты, но начинает с пустым контекстом. Используйте `/btw` для вопросов о том, что Claude уже знает из этого сеанса; используйте subagent для поиска чего-то нового.411`/btw` является противоположностью [subagent](/docs/ru/sub-agents): он видит ваш полный разговор, но не имеет инструментов, в то время как subagent имеет полные инструменты, но начинает с пустым контекстом. Используйте `/btw` для вопросов о том, что Claude уже знает из этого сеанса; используйте subagent для поиска чего-то нового.

412 412 

413<h2 id="task-list">413<h2 id="task-list">

414 Список задач414 Список задач

415</h2>415</h2>

416 416 

417Список задач — это контрольный список Claude: элементы, которые Claude создал для планирования многошаговой работы, с индикаторами, показывающими, что ожидает выполнения, выполняется или завершено. Это отличается от представления фоновых задач. Чтобы увидеть запущенные оболочки и подагентов, используйте [`/tasks`](/ru/commands) вместо этого.417Список задач — это контрольный список Claude: элементы, которые Claude создал для планирования многошаговой работы, с индикаторами, показывающими, что ожидает выполнения, выполняется или завершено. Это отличается от представления фоновых задач. Чтобы увидеть запущенные оболочки и подагентов, используйте [`/tasks`](/docs/ru/commands) вместо этого.

418 418 

419* Нажмите `Ctrl+T` для переключения представления списка задач. Отображение показывает до пяти задач одновременно. Когда Claude еще не создал никаких элементов контрольного списка, переключение не имеет видимого эффекта, потому что нечего отображать419* Нажмите `Ctrl+T` для переключения представления списка задач. Отображение показывает до пяти задач одновременно. Когда Claude еще не создал никаких элементов контрольного списка, переключение не имеет видимого эффекта, потому что нечего отображать

420* Чтобы увидеть все задачи или очистить их, спросите Claude напрямую: "show me all tasks" или "clear all tasks"420* Чтобы увидеть все задачи или очистить их, спросите Claude напрямую: "show me all tasks" или "clear all tasks"


452 См. также452 См. также

453</h2>453</h2>

454 454 

455* [Skills](/ru/skills) - Пользовательские запросы и рабочие процессы455* [Skills](/docs/ru/skills) - Пользовательские запросы и рабочие процессы

456* [Checkpointing](/ru/checkpointing) - Перемотка редактирования Claude и восстановление предыдущих состояний456* [Checkpointing](/docs/ru/checkpointing) - Перемотка редактирования Claude и восстановление предыдущих состояний

457* [Справочник CLI](/ru/cli-reference) - Флаги и опции командной строки457* [Справочник CLI](/docs/ru/cli-reference) - Флаги и опции командной строки

458* [Параметры](/ru/settings) - Опции конфигурации458* [Параметры](/docs/ru/settings) - Опции конфигурации

459* [Управление памятью](/ru/memory) - Управление файлами CLAUDE.md459* [Управление памятью](/docs/ru/memory) - Управление файлами CLAUDE.md

keybindings.md +11 −11

Details

68| `Plugin` | Диалог plugin (обзор, обнаружение, управление) |68| `Plugin` | Диалог plugin (обзор, обнаружение, управление) |

69| `Scroll` | Прокрутка разговора и выделение текста в полноэкранном режиме |69| `Scroll` | Прокрутка разговора и выделение текста в полноэкранном режиме |

70 70 

71{/* max-version: 2.1.204 */}До версии 2.1.205 контекст `Doctor` и действие `doctor:fix` существовали для экрана диагностики `/doctor`.71До версии 2.1.205 контекст `Doctor` и действие `doctor:fix` существовали для экрана диагностики `/doctor`.

72 72 

73<h2 id="available-actions">73<h2 id="available-actions">

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


87| `app:interrupt` | Ctrl+C | Отменить текущую операцию |87| `app:interrupt` | Ctrl+C | Отменить текущую операцию |

88| `app:exit` | Ctrl+D | Выход из Claude Code |88| `app:exit` | Ctrl+D | Выход из Claude Code |

89| `app:redraw` | (не привязано) | Принудительно перерисовать терминал |89| `app:redraw` | (не привязано) | Принудительно перерисовать терминал |

90| `app:toggleTodos` | Ctrl+T | Переключить видимость списка задач Claude. Это не представление фоновых задач [`/tasks`](/ru/commands) |90| `app:toggleTodos` | Ctrl+T | Переключить видимость списка задач Claude. Это не представление фоновых задач [`/tasks`](/docs/ru/commands) |

91| `app:toggleTranscript` | Ctrl+O | Переключить подробную стенограмму |91| `app:toggleTranscript` | Ctrl+O | Переключить подробную стенограмму |

92 92 

93<h3 id="history-actions">93<h3 id="history-actions">


111| Действие | По умолчанию | Описание |111| Действие | По умолчанию | Описание |

112| :-------------------- | :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |112| :-------------------- | :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

113| `chat:cancel` | Escape | Отменить текущий ввод |113| `chat:cancel` | Escape | Отменить текущий ввод |

114| `chat:clearInput` | Ctrl+L | Принудительно перерисовать весь экран, сохраняя ввод. В [полноэкранном рендеринге](/ru/fullscreen#clear-the-conversation) нажмите дважды в течение двух секунд для запуска `/clear` |114| `chat:clearInput` | Ctrl+L | Принудительно перерисовать весь экран, сохраняя ввод. В [полноэкранном рендеринге](/docs/ru/fullscreen#clear-the-conversation) нажмите дважды в течение двух секунд для запуска `/clear` |

115| `chat:clearScreen` | Cmd+K | В [полноэкранном рендеринге](/ru/fullscreen#clear-the-conversation) нажмите дважды в течение двух секунд для запуска `/clear` |115| `chat:clearScreen` | Cmd+K | В [полноэкранном рендеринге](/docs/ru/fullscreen#clear-the-conversation) нажмите дважды в течение двух секунд для запуска `/clear` |

116| `chat:killAgents` | Ctrl+X Ctrl+K | Завершить всех фоновых [подагентов](/ru/sub-agents#run-subagents-in-foreground-or-background) в этом сеансе |116| `chat:killAgents` | Ctrl+X Ctrl+K | Завершить всех фоновых [подагентов](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) в этом сеансе |

117| `chat:cycleMode` | Shift+Tab\* | Циклический перебор режимов разрешений |117| `chat:cycleMode` | Shift+Tab\* | Циклический перебор режимов разрешений |

118| `chat:modelPicker` | Meta+P | Открыть выбор модели |118| `chat:modelPicker` | Meta+P | Открыть выбор модели |

119| `chat:fastMode` | Meta+O | Переключить быстрый режим |119| `chat:fastMode` | Meta+O | Переключить быстрый режим |


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

201 201 

202| Действие | По умолчанию | Описание |202| Действие | По умолчанию | Описание |

203| :---------------- | :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |203| :---------------- | :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |

204| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Переместить текущую задачу в фон. {/* min-version: 2.1.169 */}Сочетание клавиш Ctrl+X Ctrl+B требует v2.1.169 или более позднюю версию и избегает конфликта с префиксом tmux |204| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Переместить текущую задачу в фон. Сочетание клавиш Ctrl+X Ctrl+B требует v2.1.169 или более позднюю версию и избегает конфликта с префиксом tmux |

205 205 

206<h3 id="theme-actions">206<h3 id="theme-actions">

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


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

358</h3>358</h3>

359 359 

360Действия, доступные в контексте `Chat` при включённой [диктовке голосом](/ru/voice-dictation):360Действия, доступные в контексте `Chat` при включённой [диктовке голосом](/docs/ru/voice-dictation):

361 361 

362| Действие | По умолчанию | Описание |362| Действие | По умолчанию | Описание |

363| :----------------- | :----------- | :--------------------------------------------------------------------------- |363| :----------------- | :----------- | :--------------------------------------------------------------------------- |


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

368</h3>368</h3>

369 369 

370Действия, доступные в контексте `Scroll` при включённом [полноэкранном рендеринге](/ru/fullscreen):370Действия, доступные в контексте `Scroll` при включённом [полноэкранном рендеринге](/docs/ru/fullscreen):

371 371 

372| Действие | По умолчанию | Описание |372| Действие | По умолчанию | Описание |

373| :-------------------------- | :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |373| :-------------------------- | :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |


526* **Сочетания клавиш** обрабатывают действия на уровне компонента (переключение задач, отправка и т. д.)526* **Сочетания клавиш** обрабатывают действия на уровне компонента (переключение задач, отправка и т. д.)

527* Клавиша Escape в режиме vim переключает INSERT в NORMAL режим; она не запускает `chat:cancel`527* Клавиша Escape в режиме vim переключает INSERT в NORMAL режим; она не запускает `chat:cancel`

528* Большинство сочетаний Ctrl+клавиша проходят через режим vim в систему сочетаний клавиш528* Большинство сочетаний Ctrl+клавиша проходят через режим vim в систему сочетаний клавиш

529* Клавиши vim не переназначаются через файл сочетаний клавиш. Чтобы сопоставить двухклавишную последовательность в режиме INSERT, такую как `jj`, с клавишей Escape, используйте параметр [`vimInsertModeRemaps`](/ru/interactive-mode#remap-insert-mode-key-sequences)529* Клавиши vim не переназначаются через файл сочетаний клавиш. Чтобы сопоставить двухклавишную последовательность в режиме INSERT, такую как `jj`, с клавишей Escape, используйте параметр [`vimInsertModeRemaps`](/docs/ru/interactive-mode#remap-insert-mode-key-sequences)

530* В режиме vim NORMAL `?` показывает меню справки (поведение vim)530* В режиме vim NORMAL `?` показывает меню справки (поведение vim)

531* В режиме vim NORMAL `/` открывает поиск по истории, то же самое, что Ctrl+R в стандартном режиме531* В режиме vim NORMAL `/` открывает поиск по истории, то же самое, что Ctrl+R в стандартном режиме

532 532 


542* Конфликтов мультиплексоров терминала542* Конфликтов мультиплексоров терминала

543* Дублирующихся привязок в одном контексте543* Дублирующихся привязок в одном контексте

544 544 

545Claude Code сообщает о предупреждениях при загрузке файла и записывает каждое в журнал отладки. Запустите Claude Code с [`--debug`](/ru/cli-reference#cli-flags) для просмотра деталей.545Claude Code сообщает о предупреждениях при загрузке файла и записывает каждое в журнал отладки. Запустите Claude Code с [`--debug`](/docs/ru/cli-reference#cli-flags) для просмотра деталей.

Details

6 6 

7> Направьте Claude Code на шлюз LLM вашей организации. Проверьте, уже ли администратор его настроил, или установите базовый URL и учетные данные самостоятельно, затем проверьте соединение и исправьте ошибки шлюза.7> Направьте Claude Code на шлюз LLM вашей организации. Проверьте, уже ли администратор его настроил, или установите базовый URL и учетные данные самостоятельно, затем проверьте соединение и исправьте ошибки шлюза.

8 8 

9[Шлюз LLM](/ru/llm-gateway) — это прокси, который ваша организация запускает между Claude Code и поставщиком модели. Когда ваша организация использует его, Claude Code аутентифицируется на шлюзе с учетными данными, которые выдает ваша организация, вместо вашего личного входа claude.ai.9[Шлюз LLM](/docs/ru/llm-gateway) — это прокси, который ваша организация запускает между Claude Code и поставщиком модели. Когда ваша организация использует его, Claude Code аутентифицируется на шлюзе с учетными данными, которые выдает ваша организация, вместо вашего личного входа claude.ai.

10 10 

11Эта страница предназначена для разработчиков, запускающих Claude Code через шлюз, который управляет их организация. Она охватывает два пути: [проверка того, уже ли администратор его настроил для вас](#check-for-an-existing-configuration), и [самостоятельная настройка](#configure-claude-code-yourself), если он этого не сделал.11Эта страница предназначена для разработчиков, запускающих Claude Code через шлюз, который управляет их организация. Она охватывает два пути: [проверка того, уже ли администратор его настроил для вас](#check-for-an-existing-configuration), и [самостоятельная настройка](#configure-claude-code-yourself), если он этого не сделал.

12 12 

13<Note>13<Note>

14 * Чтобы развернуть шлюз для вашей организации, см. [Развертывание шлюза LLM](/ru/llm-gateway-rollout)14 * Чтобы развернуть шлюз для вашей организации, см. [Развертывание шлюза LLM](/docs/ru/llm-gateway-rollout)

15 * Для информации о том, что Claude Code отправляет на шлюз, см. [справочник протокола шлюза](/ru/llm-gateway-protocol)15 * Для информации о том, что Claude Code отправляет на шлюз, см. [справочник протокола шлюза](/docs/ru/llm-gateway-protocol)

16</Note>16</Note>

17 17 

18<h2 id="check-for-an-existing-configuration">18<h2 id="check-for-an-existing-configuration">

19 Проверка существующей конфигурации19 Проверка существующей конфигурации

20</h2>20</h2>

21 21 

22Администраторы могут распространять адрес шлюза и учетные данные через [управляемые параметры](/ru/settings#settings-files), управление устройствами или [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper), чтобы Claude Code подхватил их при запуске без каких-либо действий с вашей стороны. Чтобы проверить, уже ли ваша организация это сделала:22Администраторы могут распространять адрес шлюза и учетные данные через [управляемые параметры](/docs/ru/settings#settings-files), управление устройствами или [`apiKeyHelper`](#rotate-credentials-with-apikeyhelper), чтобы Claude Code подхватил их при запуске без каких-либо действий с вашей стороны. Чтобы проверить, уже ли ваша организация это сделала:

23 23 

24<Steps>24<Steps>

25 <Step title="Запустите Claude Code">25 <Step title="Запустите Claude Code">


107 Установка в файле параметров107 Установка в файле параметров

108</h4>108</h4>

109 109 

110Чтобы конфигурация применялась везде, где работает Claude Code, без зависимости от вашей оболочки, установите переменные в блоке `env` [файла параметров](/ru/settings). Файлы параметров имеют разные области:110Чтобы конфигурация применялась везде, где работает Claude Code, без зависимости от вашей оболочки, установите переменные в блоке `env` [файла параметров](/docs/ru/settings). Файлы параметров имеют разные области:

111 111 

112* `~/.claude/settings.json` применяется ко всем вашим проектам. На Windows путь — `%USERPROFILE%\.claude\settings.json`112* `~/.claude/settings.json` применяется ко всем вашим проектам. На Windows путь — `%USERPROFILE%\.claude\settings.json`

113* `.claude/settings.local.json` применяется к одному проекту. Claude Code добавляет его в ваш gitignore при создании файла; если вы создаете его самостоятельно, сначала добавьте его в gitignore вручную, чтобы случайно не зафиксировать ваши учетные данные113* `.claude/settings.local.json` применяется к одному проекту. Claude Code добавляет его в ваш gitignore при создании файла; если вы создаете его самостоятельно, сначала добавьте его в gitignore вручную, чтобы случайно не зафиксировать ваши учетные данные


194 Расширение VS Code194 Расширение VS Code

195</h3>195</h3>

196 196 

197Установите переменные шлюза для [расширения VS Code](/ru/vs-code) в `claudeCode.environmentVariables` в собственных параметрах пользователя VS Code, открытых командой **Preferences: Open User Settings (JSON)**. Расширение проверяет учетные данные из этого параметра перед запуском, поэтому это надежное место для учетных данных шлюза; значения в `~/.claude/settings.json` достигают порожденного процесса, но не проверку входа самого расширения.197Установите переменные шлюза для [расширения VS Code](/docs/ru/vs-code) в `claudeCode.environmentVariables` в собственных параметрах пользователя VS Code, открытых командой **Preferences: Open User Settings (JSON)**. Расширение проверяет учетные данные из этого параметра перед запуском, поэтому это надежное место для учетных данных шлюза; значения в `~/.claude/settings.json` достигают порожденного процесса, но не проверку входа самого расширения.

198 198 

199```json theme={null}199```json theme={null}

200{200{


211 211 

212Настольное приложение читает маршрутизацию шлюза из [конфигурации сторонних поставщиков](https://claude.com/docs/third-party/claude-desktop/gateway), а не из `ANTHROPIC_BASE_URL` или `settings.json`. Эта конфигурация может поступить от вашей организации или из формы в самом приложении:212Настольное приложение читает маршрутизацию шлюза из [конфигурации сторонних поставщиков](https://claude.com/docs/third-party/claude-desktop/gateway), а не из `ANTHROPIC_BASE_URL` или `settings.json`. Эта конфигурация может поступить от вашей организации или из формы в самом приложении:

213 213 

214* **Распределено администратором**: если ваша организация [развернула конфигурацию](/ru/llm-gateway-rollout#distribute-through-managed-settings), настольное приложение маршрутизирует через шлюз без каких-либо действий с вашей стороны214* **Распределено администратором**: если ваша организация [развернула конфигурацию](/docs/ru/llm-gateway-rollout#distribute-through-managed-settings), настольное приложение маршрутизирует через шлюз без каких-либо действий с вашей стороны

215* **Настроено локально**: для устройств без распределенной администратором конфигурации откройте Help → Troubleshooting → Включить режим разработчика, который перезагружает приложение с меню Developer. Затем откройте Developer → Configure Third-Party Inference и введите базовый URL вашего шлюза. Распределенная администратором конфигурация имеет приоритет и делает эту форму доступной только для чтения215* **Настроено локально**: для устройств без распределенной администратором конфигурации откройте Help → Troubleshooting → Включить режим разработчика, который перезагружает приложение с меню Developer. Затем откройте Developer → Configure Third-Party Inference и введите базовый URL вашего шлюза. Распределенная администратором конфигурация имеет приоритет и делает эту форму доступной только для чтения

216 216 

217При активной конфигурации шлюза настольное приложение запускает сеансы только на вашем локальном компьютере: средство выбора окружения не предлагает сеансы SSH или размещенные в облаке окружения Anthropic, и [Remote Control](/ru/remote-control) недоступен. Чтобы использовать Claude Code на удаленном хосте через шлюз, запустите CLI на этом хосте с установленными [`ANTHROPIC_BASE_URL` и учетными данными шлюза](#set-the-base-url-and-credential).217При активной конфигурации шлюза настольное приложение запускает сеансы только на вашем локальном компьютере: средство выбора окружения не предлагает сеансы SSH или размещенные в облаке окружения Anthropic, и [Remote Control](/docs/ru/remote-control) недоступен. Чтобы использовать Claude Code на удаленном хосте через шлюз, запустите CLI на этом хосте с установленными [`ANTHROPIC_BASE_URL` и учетными данными шлюза](#set-the-base-url-and-credential).

218 218 

219Если настольное приложение показывает `Gateway was unreachable`, приложение не смогло достичь настроенный базовый URL при запуске; проверьте URL и сетевой путь с помощью [теста curl выше](#verify-the-connection).219Если настольное приложение показывает `Gateway was unreachable`, приложение не смогло достичь настроенный базовый URL при запуске; проверьте URL и сетевой путь с помощью [теста curl выше](#verify-the-connection).

220 220 


222 GitHub Actions222 GitHub Actions

223</h3>223</h3>

224 224 

225[Claude Code GitHub Actions](/ru/github-actions) читает `ANTHROPIC_BASE_URL` и `ANTHROPIC_CUSTOM_HEADERS` из блока `env` рабочего процесса. Передайте учетные данные как вход `anthropic_api_key` действия; действие устанавливает его как `ANTHROPIC_API_KEY`, поэтому он достигает шлюза в заголовке `x-api-key`.225[Claude Code GitHub Actions](/docs/ru/github-actions) читает `ANTHROPIC_BASE_URL` и `ANTHROPIC_CUSTOM_HEADERS` из блока `env` рабочего процесса. Передайте учетные данные как вход `anthropic_api_key` действия; действие устанавливает его как `ANTHROPIC_API_KEY`, поэтому он достигает шлюза в заголовке `x-api-key`.

226 226 

227Для шлюза `x-api-key` установите базовый URL в `env` и передайте ключ шлюза как вход:227Для шлюза `x-api-key` установите базовый URL в `env` и передайте ключ шлюза как вход:

228 228 


249 anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}249 anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

250```250```

251 251 

252Для других вариантов аутентификации действия, включая `CLAUDE_CODE_OAUTH_TOKEN` и федерацию рабочей нагрузки, см. [Claude Code GitHub Actions](/ru/github-actions) и [README](https://github.com/anthropics/claude-code-action#readme) действия.252Для других вариантов аутентификации действия, включая `CLAUDE_CODE_OAUTH_TOKEN` и федерацию рабочей нагрузки, см. [Claude Code GitHub Actions](/docs/ru/github-actions) и [README](https://github.com/anthropics/claude-code-action#readme) действия.

253 253 

254<h3 id="agent-sdk">254<h3 id="agent-sdk">

255 Agent SDK255 Agent SDK

256</h3>256</h3>

257 257 

258[Agent SDK](/ru/agent-sdk/overview) не имеет опций, специфичных для шлюза; он передает переменные окружения процессу Claude Code, который он порождает. Каждый SDK принимает опцию `env`, которая устанавливает окружение порожденного процесса, и SDK TypeScript и Python обрабатывают это по-разному:258[Agent SDK](/docs/ru/agent-sdk/overview) не имеет опций, специфичных для шлюза; он передает переменные окружения процессу Claude Code, который он порождает. Каждый SDK принимает опцию `env`, которая устанавливает окружение порожденного процесса, и SDK TypeScript и Python обрабатывают это по-разному:

259 259 

260* TypeScript: порожденный процесс по умолчанию наследует родительское окружение, но установка `options.env` полностью заменяет окружение. Распределите `process.env` в него, чтобы сохранить переменные шлюза.260* TypeScript: порожденный процесс по умолчанию наследует родительское окружение, но установка `options.env` полностью заменяет окружение. Распределите `process.env` в него, чтобы сохранить переменные шлюза.

261* Python: `ClaudeAgentOptions(env=...)` объединяется поверх унаследованного окружения, поэтому переменные шлюза, установленные в родительском процессе, проходят без распределения.261* Python: `ClaudeAgentOptions(env=...)` объединяется поверх унаследованного окружения, поэтому переменные шлюза, установленные в родительском процессе, проходят без распределения.


288 Slack, веб и Remote Control288 Slack, веб и Remote Control

289</h3>289</h3>

290 290 

291[Claude Code в Slack](/ru/slack) и [Claude Code на веб](/ru/claude-code-on-the-web) — это размещенные Anthropic продукты, которые всегда используют API Anthropic; они не являются частью развертывания шлюза. Переменные шлюза, установленные в конфигурации окружения облачного сеанса, не применяются. Если ваш трафик должен оставаться на шлюзе, не включайте эти поверхности для этих пользователей.291[Claude Code в Slack](/docs/ru/slack) и [Claude Code на веб](/docs/ru/claude-code-on-the-web) — это размещенные Anthropic продукты, которые всегда используют API Anthropic; они не являются частью развертывания шлюза. Переменные шлюза, установленные в конфигурации окружения облачного сеанса, не применяются. Если ваш трафик должен оставаться на шлюзе, не включайте эти поверхности для этих пользователей.

292 292 

293[Remote Control](/ru/remote-control) и [голосовая диктовка](/ru/voice-dictation) оба полагаются на идентичность claude.ai: Remote Control для связи живого сеанса с вашей учетной записью, и голосовая диктовка для достижения конечной точки транскрипции claude.ai. Они недоступны, пока активны `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, Remote Control также отключен, пока `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий Anthropic, поэтому входа с claude.ai недостаточно само по себе.293[Remote Control](/docs/ru/remote-control) и [голосовая диктовка](/docs/ru/voice-dictation) оба полагаются на идентичность claude.ai: Remote Control для связи живого сеанса с вашей учетной записью, и голосовая диктовка для достижения конечной точки транскрипции claude.ai. Они недоступны, пока активны `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`. Начиная с версии 2.1.196, Remote Control также отключен, пока `ANTHROPIC_BASE_URL` указывает на хост, не принадлежащий Anthropic, поэтому входа с claude.ai недостаточно само по себе.

294 294 

295Чтобы восстановить любую из этих функций, войдите с claude.ai и отмените установку переменных шлюза, которые проверяет эта функция. Раздел Remote Control в `claude doctor` называет переменную учетных данных для отмены установки.295Чтобы восстановить любую из этих функций, войдите с claude.ai и отмените установку переменных шлюза, которые проверяет эта функция. Раздел Remote Control в `claude doctor` называет переменную учетных данных для отмены установки.

296 296 


307 Отправка дополнительных заголовков307 Отправка дополнительных заголовков

308</h3>308</h3>

309 309 

310Некоторые шлюзы маршрутизируют или помечают запросы, используя пользовательский заголовок в дополнение к учетным данным, например идентификатор клиента или ключ маршрутизации. Чтобы отправить один, установите [`ANTHROPIC_CUSTOM_HEADERS`](/ru/env-vars) с одной парой `Name: Value` на строку. Пример ниже добавляет заголовок маршрутизации с именем `X-Org-Route`:310Некоторые шлюзы маршрутизируют или помечают запросы, используя пользовательский заголовок в дополнение к учетным данным, например идентификатор клиента или ключ маршрутизации. Чтобы отправить один, установите [`ANTHROPIC_CUSTOM_HEADERS`](/docs/ru/env-vars) с одной парой `Name: Value` на строку. Пример ниже добавляет заголовок маршрутизации с именем `X-Org-Route`:

311 311 

312<Tabs>312<Tabs>

313 <Tab title="Bash или Zsh">313 <Tab title="Bash или Zsh">


341 341 

342Включите его, если ваш шлюз обслуживает имена моделей, которых нет в встроенном списке Claude Code, и вы хотите выбрать их из средства выбора. Если встроенные модели — это то, что вы используете, вам не нужно обнаружение; администратор также мог уже включить его через управляемые параметры.342Включите его, если ваш шлюз обслуживает имена моделей, которых нет в встроенном списке Claude Code, и вы хотите выбрать их из средства выбора. Если встроенные модели — это то, что вы используете, вам не нужно обнаружение; администратор также мог уже включить его через управляемые параметры.

343 343 

344Чтобы включить его, установите `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` в вашей оболочке или в блоке `env` `~/.claude/settings.json`. Обнаружение требует Claude Code v2.1.129 или позже. {/* min-version: 2.1.129 */}344Чтобы включить его, установите `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` в вашей оболочке или в блоке `env` `~/.claude/settings.json`. Обнаружение требует Claude Code v2.1.129 или позже.&#x20;

345 345 

346Обнаруженные модели появляются как дополнительные записи `/model`, помеченные `From gateway`. Чтобы подтвердить, что обнаружение запустилось, запустите `claude --debug` и ищите строки `[gatewayDiscovery]`: успех регистрирует, сколько моделей было кэшировано, и `404`, timeout или перенаправление также записываются там. Для того, когда запускается обнаружение, что оно фильтрует и формат ответа, который обслуживают шлюзы, см. [справочник обнаружения модели](/ru/llm-gateway-protocol#model-discovery).346Обнаруженные модели появляются как дополнительные записи `/model`, помеченные `From gateway`. Чтобы подтвердить, что обнаружение запустилось, запустите `claude --debug` и ищите строки `[gatewayDiscovery]`: успех регистрирует, сколько моделей было кэшировано, и `404`, timeout или перенаправление также записываются там. Для того, когда запускается обнаружение, что оно фильтрует и формат ответа, который обслуживают шлюзы, см. [справочник обнаружения модели](/docs/ru/llm-gateway-protocol#model-discovery).

347 347 

348<h3 id="rotate-credentials-with-apikeyhelper">348<h3 id="rotate-credentials-with-apikeyhelper">

349 Ротация учетных данных с apiKeyHelper349 Ротация учетных данных с apiKeyHelper


353 353 

354Используйте помощника, когда учетные данные истекают по расписанию, поступают из хранилища или команды SSO, или администратор сказал вам настроить один. Если ваши учетные данные — это фиксированная строка, которую вы устанавливаете один раз, [переменная учетных данных](#set-the-credential-variable) — это все, что вам нужно, и вы можете пропустить этот раздел.354Используйте помощника, когда учетные данные истекают по расписанию, поступают из хранилища или команды SSO, или администратор сказал вам настроить один. Если ваши учетные данные — это фиксированная строка, которую вы устанавливаете один раз, [переменная учетных данных](#set-the-credential-variable) — это все, что вам нужно, и вы можете пропустить этот раздел.

355 355 

356Помощник — это любая команда оболочки, которая выводит текущие учетные данные на stdout. Claude Code запускает ее через вашу системную оболочку, поэтому на Windows это может быть исполняемый файл или вызов PowerShell. Напишите скрипт, сделайте его исполняемым и ссылайтесь на него из `apiKeyHelper` в вашем [файле параметров](/ru/settings):356Помощник — это любая команда оболочки, которая выводит текущие учетные данные на stdout. Claude Code запускает ее через вашу системную оболочку, поэтому на Windows это может быть исполняемый файл или вызов PowerShell. Напишите скрипт, сделайте его исполняемым и ссылайтесь на него из `apiKeyHelper` в вашем [файле параметров](/docs/ru/settings):

357 357 

358<Tabs>358<Tabs>

359 <Tab title="Bash или Zsh">359 <Tab title="Bash или Zsh">


419Установка переменной имеет эти эффекты и ограничения:419Установка переменной имеет эти эффекты и ограничения:

420 420 

421* Она отключает автоматические обновления, поэтому планируйте другой путь обновления, такой как ваш менеджер пакетов или управляемое распределение.421* Она отключает автоматические обновления, поэтому планируйте другой путь обновления, такой как ваш менеджер пакетов или управляемое распределение.

422* Она подавляет проверку доступности [быстрого режима](/ru/fast-mode). Если предыдущая проверка уже не включила быстрый режим на машине, `/fast` сообщает, что быстрый режим недоступен.422* Она подавляет проверку доступности [быстрого режима](/docs/ru/fast-mode). Если предыдущая проверка уже не включила быстрый режим на машине, `/fast` сообщает, что быстрый режим недоступен.

423* Она отключает [обнаружение модели шлюза](#add-gateway-models-to-the-model-picker), хотя обнаружение запрашивает сам шлюз. Ранее обнаруженные модели остаются доступными из локального кэша, но список не обновляется.423* Она отключает [обнаружение модели шлюза](#add-gateway-models-to-the-model-picker), хотя обнаружение запрашивает сам шлюз. Ранее обнаруженные модели остаются доступными из локального кэша, но список не обновляется.

424* Проверка безопасности домена инструмента WebFetch не затрагивается и по-прежнему вызывает `api.anthropic.com`. Отключите ее отдельно с помощью `skipWebFetchPreflight: true` в [параметрах](/ru/settings), если ваша сеть блокирует этот хост.424* Проверка безопасности домена инструмента WebFetch не затрагивается и по-прежнему вызывает `api.anthropic.com`. Отключите ее отдельно с помощью `skipWebFetchPreflight: true` в [параметрах](/docs/ru/settings), если ваша сеть блокирует этот хост.

425* Для каждого потока телеметрии и переменной, которая его контролирует, см. [сервисы телеметрии](/ru/data-usage#telemetry-services).425* Для каждого потока телеметрии и переменной, которая его контролирует, см. [сервисы телеметрии](/docs/ru/data-usage#telemetry-services).

426 426 

427<h3 id="route-to-a-cloud-provider-through-a-gateway">427<h3 id="route-to-a-cloud-provider-through-a-gateway">

428 Маршрутизация к облачному поставщику через шлюз428 Маршрутизация к облачному поставщику через шлюз


432 432 

433Используйте один только если команда шлюза специально назвала Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS. Если [запрос проверки](#verify-the-connection) выше вернул JSON, вы можете пропустить этот раздел.433Используйте один только если команда шлюза специально назвала Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS. Если [запрос проверки](#verify-the-connection) выше вернул JSON, вы можете пропустить этот раздел.

434 434 

435Установите блок для поставщика, которого назвала команда шлюза. Переменные skip-auth говорят Claude Code не подписывать запросы с учетными данными поставщика, так как шлюз их держит. Если шлюзу нужен свой собственный токен, добавьте `ANTHROPIC_AUTH_TOKEN` после блока, кроме Microsoft Foundry, который использует `ANTHROPIC_FOUNDRY_API_KEY`, как показано. {/* min-version: 2.1.203 */}Шлюз Microsoft Foundry, который ожидает токен-носитель, может использовать [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/ru/env-vars) вместо этого; он имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY`, когда оба установлены. `ANTHROPIC_FOUNDRY_AUTH_TOKEN` требует Claude Code v2.1.203 или позже.435Установите блок для поставщика, которого назвала команда шлюза. Переменные skip-auth говорят Claude Code не подписывать запросы с учетными данными поставщика, так как шлюз их держит. Если шлюзу нужен свой собственный токен, добавьте `ANTHROPIC_AUTH_TOKEN` после блока, кроме Microsoft Foundry, который использует `ANTHROPIC_FOUNDRY_API_KEY`, как показано. Шлюз Microsoft Foundry, который ожидает токен-носитель, может использовать [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/docs/ru/env-vars) вместо этого; он имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY`, когда оба установлены. `ANTHROPIC_FOUNDRY_AUTH_TOKEN` требует Claude Code v2.1.203 или позже.

436 436 

437<h4 id="amazon-bedrock">437<h4 id="amazon-bedrock">

438 Amazon Bedrock438 Amazon Bedrock


486 Microsoft Foundry486 Microsoft Foundry

487</h4>487</h4>

488 488 

489Поместите учетные данные шлюза в `ANTHROPIC_FOUNDRY_API_KEY`; они отправляются на шлюз как заголовок `x-api-key`. {/* min-version: 2.1.203 */}Шлюз, который ожидает токен-носитель, может принять [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/ru/env-vars) вместо этого. Claude Code отправляет это значение как заголовок `Authorization: Bearer`, и оно имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY`, когда оба установлены. Требует Claude Code v2.1.203 или позже.489Поместите учетные данные шлюза в `ANTHROPIC_FOUNDRY_API_KEY`; они отправляются на шлюз как заголовок `x-api-key`. Шлюз, который ожидает токен-носитель, может принять [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/docs/ru/env-vars) вместо этого. Claude Code отправляет это значение как заголовок `Authorization: Bearer`, и оно имеет приоритет над `ANTHROPIC_FOUNDRY_API_KEY`, когда оба установлены. Требует Claude Code v2.1.203 или позже.

490 490 

491Для шлюза, который внедряет свой собственный заголовок `Authorization`, установите `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` и оставьте обе переменные учетных данных неустановленными. Claude Code затем отправляет запросы без учетных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например через `ANTHROPIC_CUSTOM_HEADERS`. {/* min-version: 2.1.203 */}До v2.1.203, `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` без ключа API оставлял клиент Microsoft Foundry неспособным отправлять запросы.491Для шлюза, который внедряет свой собственный заголовок `Authorization`, установите `CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` и оставьте обе переменные учетных данных неустановленными. Claude Code затем отправляет запросы без учетных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например через `ANTHROPIC_CUSTOM_HEADERS`. До v2.1.203, `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` без ключа API оставлял клиент Microsoft Foundry неспособным отправлять запросы.

492 492 

493<Tabs>493<Tabs>

494 <Tab title="Bash или Zsh">494 <Tab title="Bash или Zsh">


512 Claude Platform на AWS512 Claude Platform на AWS

513</h4>513</h4>

514 514 

515См. [Claude Platform на AWS](/ru/claude-platform-on-aws) для ID рабочего пространства.515См. [Claude Platform на AWS](/docs/ru/claude-platform-on-aws) для ID рабочего пространства.

516 516 

517<Tabs>517<Tabs>

518 <Tab title="Bash или Zsh">518 <Tab title="Bash или Zsh">


544| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |544| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

545| Предупреждение при запуске, называющее два источника учетных данных и заканчивающееся на `auth may not work as expected`. Более старые версии показывают `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` вместо этого. | Учетные данные шлюза и сохраненный вход оба активны; переменная используется для запросов, но устаревший вход может вызвать неожиданное поведение аутентификации | Отмените установку переменной, чтобы использовать сохраненный вход, или запустите `/logout`, чтобы использовать учетные данные шлюза |545| Предупреждение при запуске, называющее два источника учетных данных и заканчивающееся на `auth may not work as expected`. Более старые версии показывают `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` вместо этого. | Учетные данные шлюза и сохраненный вход оба активны; переменная используется для запросов, но устаревший вход может вызвать неожиданное поведение аутентификации | Отмените установку переменной, чтобы использовать сохраненный вход, или запустите `/logout`, чтобы использовать учетные данные шлюза |

546| Ошибки `401`, называющие недействительный или неузнанный токен | Учетные данные не являются теми, которые выдал шлюз, или они находятся в заголовке, который шлюз не читает | Подтвердите, что переменная соответствует вашему типу учетных данных в [таблице учетных данных](#set-the-credential-variable), и переустановите ключ на шлюзе, если он был отозван |546| Ошибки `401`, называющие недействительный или неузнанный токен | Учетные данные не являются теми, которые выдал шлюз, или они находятся в заголовке, который шлюз не читает | Подтвердите, что переменная соответствует вашему типу учетных данных в [таблице учетных данных](#set-the-credential-variable), и переустановите ключ на шлюзе, если он был отозван |

547| `Your apiKeyHelper script is failing` | Команда в параметре [`apiKeyHelper`](/ru/settings#available-settings) завершилась с ошибкой, истекла по времени или не вывела ничего, поэтому запросы содержат заполнитель ключа | Запустите команду напрямую, чтобы увидеть, почему она не работает, и повторно аутентифицируйтесь у поставщика учетных данных, если он сообщает об истекшем сеансе; см. [справочник по ошибкам](/ru/errors#your-apikeyhelper-script-is-failing) |547| `Your apiKeyHelper script is failing` | Команда в параметре [`apiKeyHelper`](/docs/ru/settings#available-settings) завершилась с ошибкой, истекла по времени или не вывела ничего, поэтому запросы содержат заполнитель ключа | Запустите команду напрямую, чтобы увидеть, почему она не работает, и повторно аутентифицируйтесь у поставщика учетных данных, если он сообщает об истекшем сеансе; см. [справочник по ошибкам](/docs/ru/errors#your-apikeyhelper-script-is-failing) |

548| `Unable to connect to API (ConnectionRefused)` или `(ECONNREFUSED)` из установок npm, часто после молчаливой паузы, пока Claude Code [повторяет с отступом](/ru/errors#automatic-retries) | Ничто не ответило на базовый URL: адрес неправильный или VPN или брандмауэр блокирует путь к шлюзу | Запустите [тест curl выше](#verify-the-connection), который немедленно не проходит с той же причиной, и подтвердите URL и сетевой путь с командой шлюза |548| `Unable to connect to API (ConnectionRefused)` или `(ECONNREFUSED)` из установок npm, часто после молчаливой паузы, пока Claude Code [повторяет с отступом](/docs/ru/errors#automatic-retries) | Ничто не ответило на базовый URL: адрес неправильный или VPN или брандмауэр блокирует путь к шлюзу | Запустите [тест curl выше](#verify-the-connection), который немедленно не проходит с той же причиной, и подтвердите URL и сетевой путь с командой шлюза |

549| `API returned an empty or malformed response (HTTP 200)` | Шлюз или промежуточный прокси вернул ответ, отличный от API, часто HTML-ошибку или страницу входа | Протестируйте с [запросом curl выше](#verify-the-connection); исправьте маршрут шлюза, который возвращает не-JSON |549| `API returned an empty or malformed response (HTTP 200)` | Шлюз или промежуточный прокси вернул ответ, отличный от API, часто HTML-ошибку или страницу входа | Протестируйте с [запросом curl выше](#verify-the-connection); исправьте маршрут шлюза, который возвращает не-JSON |

550| Ошибки `400`, называющие `context_management`, `Extra inputs are not permitted` или другие неузнанные поля | Шлюз пересылает запросы на вышестоящий, который отклоняет поля, которые Claude Code отправляет на конечные точки формата Anthropic | Установите `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`, что подавляет большинство полей предварительного выпуска; см. [передача функций](/ru/llm-gateway-protocol#feature-pass-through). Некоторые бета-версии не управляются этим флагом; для них установите соответствующую переменную поставщика `CLAUDE_CODE_USE_*`, чтобы Claude Code отправлял только то, что этот поставщик принимает |550| Ошибки `400`, называющие `context_management`, `Extra inputs are not permitted` или другие неузнанные поля | Шлюз пересылает запросы на вышестоящий, который отклоняет поля, которые Claude Code отправляет на конечные точки формата Anthropic | Установите `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`, что подавляет большинство полей предварительного выпуска; см. [передача функций](/docs/ru/llm-gateway-protocol#feature-pass-through). Некоторые бета-версии не управляются этим флагом; для них установите соответствующую переменную поставщика `CLAUDE_CODE_USE_*`, чтобы Claude Code отправлял только то, что этот поставщик принимает |

551| Ошибки `400`, называющие `thinking` или `adaptive`, такие как `Input tag 'adaptive' found` | Сборка вышестоящей модели не принимает адаптивное рассуждение, которое Claude Code запрашивает для моделей Claude 4.6 и позже | Обновите вышестоящий шлюз. На Opus 4.6 и Sonnet 4.6 вместо этого работает `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`. Переменные возможностей [конфигурации модели](/ru/model-config) применяются только к конфигурациям поставщика, таким как `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_VERTEX`, а не за шлюзом `ANTHROPIC_BASE_URL` |551| Ошибки `400`, называющие `thinking` или `adaptive`, такие как `Input tag 'adaptive' found` | Сборка вышестоящей модели не принимает адаптивное рассуждение, которое Claude Code запрашивает для моделей Claude 4.6 и позже | Обновите вышестоящий шлюз. На Opus 4.6 и Sonnet 4.6 вместо этого работает `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`. Переменные возможностей [конфигурации модели](/docs/ru/model-config) применяются только к конфигурациям поставщика, таким как `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_VERTEX`, а не за шлюзом `ANTHROPIC_BASE_URL` |

552| Ошибки `400`, указывающие контекст или лимит токена в собственных словах шлюза, такие как `ContextWindowExceededError` или `prompt token count of N exceeds the limit of M` | Шлюз применяет меньший контекст, чем собственное окно модели, и переписывает ошибку вышестоящего, поэтому автоматическое сжатие и повтор, которое соответствует формулировке `prompt is too long` Anthropic, не срабатывает | Запустите `/compact`, чтобы восстановить сеанс. Чтобы предотвратить это, установите `CLAUDE_CODE_AUTO_COMPACT_WINDOW` на лимит шлюза; значение зажимается как минимум на 100,000 токенов и максимум на контекстное окно модели, поэтому лимит шлюза ниже 100,000 не может быть согласован и `/compact` остается восстановлением там. Также установите `CLAUDE_CODE_MAX_OUTPUT_TOKENS` ниже лимита вывода модели шлюза |552| Ошибки `400`, указывающие контекст или лимит токена в собственных словах шлюза, такие как `ContextWindowExceededError` или `prompt token count of N exceeds the limit of M` | Шлюз применяет меньший контекст, чем собственное окно модели, и переписывает ошибку вышестоящего, поэтому автоматическое сжатие и повтор, которое соответствует формулировке `prompt is too long` Anthropic, не срабатывает | Запустите `/compact`, чтобы восстановить сеанс. Чтобы предотвратить это, установите `CLAUDE_CODE_AUTO_COMPACT_WINDOW` на лимит шлюза; значение зажимается как минимум на 100,000 токенов и максимум на контекстное окно модели, поэтому лимит шлюза ниже 100,000 не может быть согласован и `/compact` остается восстановлением там. Также установите `CLAUDE_CODE_MAX_OUTPUT_TOKENS` ниже лимита вывода модели шлюза |

553| Модели отсутствуют в средстве выбора `/model` | Имена моделей шлюза отсутствуют в встроенном списке Claude Code | Включите [обнаружение модели шлюза](#add-gateway-models-to-the-model-picker) или добавьте имена с переменными [конфигурации модели](/ru/model-config) |553| Модели отсутствуют в средстве выбора `/model` | Имена моделей шлюза отсутствуют в встроенном списке Claude Code | Включите [обнаружение модели шлюза](#add-gateway-models-to-the-model-picker) или добавьте имена с переменными [конфигурации модели](/docs/ru/model-config) |

554| Claude Code просит вас войти, даже если [тест curl](#verify-the-connection) успешен | CLI не имеет собственных учетных данных: достижимый базовый URL не является одним, и блок `env` в `.claude/settings.json` или `.claude/settings.local.json` проекта применяется только после мастера первого запуска и подсказки доверия | Установите `ANTHROPIC_AUTH_TOKEN` где-то, где Claude Code читает перед первоначальной настройкой: экспорт оболочки, блок `env` в `~/.claude/settings.json` или управляемые параметры |554| Claude Code просит вас войти, даже если [тест curl](#verify-the-connection) успешен | CLI не имеет собственных учетных данных: достижимый базовый URL не является одним, и блок `env` в `.claude/settings.json` или `.claude/settings.local.json` проекта применяется только после мастера первого запуска и подсказки доверия | Установите `ANTHROPIC_AUTH_TOKEN` где-то, где Claude Code читает перед первоначальной настройкой: экспорт оболочки, блок `env` в `~/.claude/settings.json` или управляемые параметры |

555| `ANTHROPIC_API_KEY` установлен, но игнорируется, без подсказки | Ключ требует одобрения один раз в интерактивных сеансах, и ранее отклоненный ключ игнорируется без повторного запроса | Включите его под `/config` с опцией `Use custom API key` |555| `ANTHROPIC_API_KEY` установлен, но игнорируется, без подсказки | Ключ требует одобрения один раз в интерактивных сеансах, и ранее отклоненный ключ игнорируется без повторного запроса | Включите его под `/config` с опцией `Use custom API key` |

556| `This machine's managed settings require a first-party login` | Управляемые параметры включают `forceLoginMethod` или `forceLoginOrgUUID`, которые на Claude Code v2.1.146 и позже не могут сосуществовать с `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` | Администратор должен удалить `forceLoginMethod` и `forceLoginOrgUUID` из управляемых параметров, чтобы использовать учетные данные шлюза, или удалить учетные данные шлюза, чтобы использовать вход первой стороны. Эти два не могут быть объединены |556| `This machine's managed settings require a first-party login` | Управляемые параметры включают `forceLoginMethod` или `forceLoginOrgUUID`, которые на Claude Code v2.1.146 и позже не могут сосуществовать с `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper` | Администратор должен удалить `forceLoginMethod` и `forceLoginOrgUUID` из управляемых параметров, чтобы использовать учетные данные шлюза, или удалить учетные данные шлюза, чтобы использовать вход первой стороны. Эти два не могут быть объединены |

557| `403` с телом HTML, такое как `403 Forbidden`, когда собственные журналы шлюза не показывают полученный запрос | Веб-приложение брандмауэра или обратный прокси перед шлюзом заблокировал тело запроса перед тем, как оно достигло шлюза. Подсказки Claude Code включают теги в стиле XML и исходный код, которые соответствуют правилам тела межсайтового скриптинга, поэтому короткий тест curl проходит, а реальный сеанс нет | Исключите путь `/v1/messages` шлюза из проверки тела запроса. На AWS WAF это управляемое правило `CrossSiteScripting_Body`; на nginx с ModSecurity это эквивалентные правила тела OWASP CRS |557| `403` с телом HTML, такое как `403 Forbidden`, когда собственные журналы шлюза не показывают полученный запрос | Веб-приложение брандмауэра или обратный прокси перед шлюзом заблокировал тело запроса перед тем, как оно достигло шлюза. Подсказки Claude Code включают теги в стиле XML и исходный код, которые соответствуют правилам тела межсайтового скриптинга, поэтому короткий тест curl проходит, а реальный сеанс нет | Исключите путь `/v1/messages` шлюза из проверки тела запроса. На AWS WAF это управляемое правило `CrossSiteScripting_Body`; на nginx с ModSecurity это эквивалентные правила тела OWASP CRS |

558| Ошибки сертификата или TLS, такие как `SSL certificate verification failed` или `Self-signed certificate detected`, когда [тест curl](#verify-the-connection) успешен | Среда выполнения Claude Code не доверяет тому же центру сертификации, что и `curl`. Обычно за корпоративными прокси-серверами проверки TLS | Установите `NODE_EXTRA_CA_CERTS` на путь пакета CA; см. [хранилище сертификатов CA](/ru/network-config#ca-certificate-store) |558| Ошибки сертификата или TLS, такие как `SSL certificate verification failed` или `Self-signed certificate detected`, когда [тест curl](#verify-the-connection) успешен | Среда выполнения Claude Code не доверяет тому же центру сертификации, что и `curl`. Обычно за корпоративными прокси-серверами проверки TLS | Установите `NODE_EXTRA_CA_CERTS` на путь пакета CA; см. [хранилище сертификатов CA](/docs/ru/network-config#ca-certificate-store) |

559 559 

560Если Claude Code повторно просит вас войти после удаления конфигурации шлюза, причина обычно в хранилище учетных данных, а не в шлюзе; см. [ошибки аутентификации](/ru/errors#authentication-errors).560Если Claude Code повторно просит вас войти после удаления конфигурации шлюза, причина обычно в хранилище учетных данных, а не в шлюзе; см. [ошибки аутентификации](/docs/ru/errors#authentication-errors).

561 561 

562<h2 id="related-resources">562<h2 id="related-resources">

563 Связанные ресурсы563 Связанные ресурсы

564</h2>564</h2>

565 565 

566* [Обзор шлюзов LLM](/ru/llm-gateway): что такое шлюз и как он взаимодействует с подписками claude.ai566* [Обзор шлюзов LLM](/docs/ru/llm-gateway): что такое шлюз и как он взаимодействует с подписками claude.ai

567* [Развертывание шлюза LLM для вашей организации](/ru/llm-gateway-rollout): контрольный список, обращенный к администратору, для развертывания и распределения конфигурации шлюза567* [Развертывание шлюза LLM для вашей организации](/docs/ru/llm-gateway-rollout): контрольный список, обращенный к администратору, для развертывания и распределения конфигурации шлюза

568* [Справочник протокола шлюза](/ru/llm-gateway-protocol): что Claude Code отправляет на шлюз, включая заголовки и поля, которые шлюз должен пересылать568* [Справочник протокола шлюза](/docs/ru/llm-gateway-protocol): что Claude Code отправляет на шлюз, включая заголовки и поля, которые шлюз должен пересылать

569* [Параметры](/ru/settings): где находятся файлы параметров и как читается блок `env`569* [Параметры](/docs/ru/settings): где находятся файлы параметров и как читается блок `env`

570* [Аутентификация](/ru/authentication): как переменные учетных данных, `apiKeyHelper` и вход OAuth взаимодействуют570* [Аутентификация](/docs/ru/authentication): как переменные учетных данных, `apiKeyHelper` и вход OAuth взаимодействуют

Details

8 8 

9На этой странице документированы запросы, которые Claude Code отправляет на gateway, включая вызываемые конечные точки, заголовки и поля тела, которые gateway должен пересылать, и какие функции перестают работать, если этого не происходит. Она написана для операторов, настраивающих продукт gateway для работы с Claude Code.9На этой странице документированы запросы, которые Claude Code отправляет на gateway, включая вызываемые конечные точки, заголовки и поля тела, которые gateway должен пересылать, и какие функции перестают работать, если этого не происходит. Она написана для операторов, настраивающих продукт gateway для работы с Claude Code.

10 10 

11Работающий [Claude apps gateway](/ru/claude-apps-gateway) предоставляет машиночитаемую версию этого контракта по адресу `GET /protocol`, охватывающую те же требования пересылки плюс специфичные для Claude apps gateway конечные точки для входа SSO, доставки управляемых параметров и телеметрии. Claude apps gateway работает из того же двоичного файла `claude`, что и CLI, поэтому [быстрый старт Claude apps gateway](/ru/claude-apps-gateway#quickstart) — это кратчайший путь к работающему экземпляру, из которого вы можете получить спецификацию.11Работающий [Claude apps gateway](/docs/ru/claude-apps-gateway) предоставляет машиночитаемую версию этого контракта по адресу `GET /protocol`, охватывающую те же требования пересылки плюс специфичные для Claude apps gateway конечные точки для входа SSO, доставки управляемых параметров и телеметрии. Claude apps gateway работает из того же двоичного файла `claude`, что и CLI, поэтому [быстрый старт Claude apps gateway](/docs/ru/claude-apps-gateway#quickstart) — это кратчайший путь к работающему экземпляру, из которого вы можете получить спецификацию.

12 12 

13<Note>13<Note>

14 * Чтобы развернуть существующий или сторонний gateway для вашей организации, см. [Развертывание LLM gateway](/ru/llm-gateway-rollout)14 * Чтобы развернуть существующий или сторонний gateway для вашей организации, см. [Развертывание LLM gateway](/docs/ru/llm-gateway-rollout)

15 * Если вы отдельный разработчик, аутентифицирующий Claude Code на gateway с учетными данными, которые вам были предоставлены, см. [Подключение Claude Code к LLM gateway](/ru/llm-gateway-connect)15 * Если вы отдельный разработчик, аутентифицирующий Claude Code на gateway с учетными данными, которые вам были предоставлены, см. [Подключение Claude Code к LLM gateway](/docs/ru/llm-gateway-connect)

16</Note>16</Note>

17 17 

18На этой странице рассматриваются:18На этой странице рассматриваются:


46 Foundry и Claude Platform on AWS46 Foundry и Claude Platform on AWS

47</h3>47</h3>

48 48 

49Microsoft Foundry и [Claude Platform on AWS](/ru/claude-platform-on-aws) реализуют формат Anthropic Messages. Claude Code маршрутизирует их через собственные переменные, `ANTHROPIC_FOUNDRY_BASE_URL` и `ANTHROPIC_AWS_BASE_URL`, но gateway, находящийся перед ними, реализует строку Anthropic Messages выше. Gateway, находящийся перед Claude Platform on AWS, также должен пересылать заголовок `anthropic-workspace-id`, который [эта платформа требует для каждого запроса](/ru/claude-platform-on-aws).49Microsoft Foundry и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) реализуют формат Anthropic Messages. Claude Code маршрутизирует их через собственные переменные, `ANTHROPIC_FOUNDRY_BASE_URL` и `ANTHROPIC_AWS_BASE_URL`, но gateway, находящийся перед ними, реализует строку Anthropic Messages выше. Gateway, находящийся перед Claude Platform on AWS, также должен пересылать заголовок `anthropic-workspace-id`, который [эта платформа требует для каждого запроса](/docs/ru/claude-platform-on-aws).

50 50 

51<h3 id="optional-endpoints-and-startup-traffic">51<h3 id="optional-endpoints-and-startup-traffic">

52 Опциональные конечные точки и трафик при запуске52 Опциональные конечные точки и трафик при запуске


77 Заголовки запроса77 Заголовки запроса

78</h2>78</h2>

79 79 

80Claude Code включает эти заголовки в запросы API. Имена заголовков не чувствительны к регистру на проводе. Пересылайте `anthropic-version` и `anthropic-beta` без изменений, плюс `anthropic-workspace-id` когда upstream — это [Claude Platform on AWS](/ru/claude-platform-on-aws); остальное gateway может использовать для маршрутизации, атрибуции и трассировки и не обязан пересылать.80Claude Code включает эти заголовки в запросы API. Имена заголовков не чувствительны к регистру на проводе. Пересылайте `anthropic-version` и `anthropic-beta` без изменений, плюс `anthropic-workspace-id` когда upstream — это [Claude Platform on AWS](/docs/ru/claude-platform-on-aws); остальное gateway может использовать для маршрутизации, атрибуции и трассировки и не обязан пересылать.

81 81 

82| Заголовок | Описание |82| Заголовок | Описание |

83| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

84| `Authorization`, `x-api-key` | Учетные данные gateway разработчика, в одном или обоих заголовках в зависимости от того, какую [переменную учетных данных](/ru/llm-gateway-connect#set-the-credential-variable) они установили |84| `Authorization`, `x-api-key` | Учетные данные gateway разработчика, в одном или обоих заголовках в зависимости от того, какую [переменную учетных данных](/docs/ru/llm-gateway-connect#set-the-credential-variable) они установили |

85| `anthropic-version` | Версия API, в настоящее время `2023-06-01`. Запросы формата Amazon Bedrock и Google Cloud's Agent Platform также содержат поле тела `anthropic_version`, значение которого — строка диалекта поставщика, а не значение этого заголовка |85| `anthropic-version` | Версия API, в настоящее время `2023-06-01`. Запросы формата Amazon Bedrock и Google Cloud's Agent Platform также содержат поле тела `anthropic_version`, значение которого — строка диалекта поставщика, а не значение этого заголовка |

86| `anthropic-beta` | Значения возможностей, разделенные запятыми, для запроса. Пересылайте заголовок дословно; не создавайте список разрешений отдельных значений, потому что набор изменяется с выпусками Claude Code. Когда разработчик аутентифицируется с помощью входа claude.ai, что возможно, когда `ANTHROPIC_BASE_URL` установлен без переменной учетных данных gateway, этот заголовок также содержит возможность OAuth, которую требует upstream, и удаление его приводит к отказу этих запросов с `401` |86| `anthropic-beta` | Значения возможностей, разделенные запятыми, для запроса. Пересылайте заголовок дословно; не создавайте список разрешений отдельных значений, потому что набор изменяется с выпусками Claude Code. Когда разработчик аутентифицируется с помощью входа claude.ai, что возможно, когда `ANTHROPIC_BASE_URL` установлен без переменной учетных данных gateway, этот заголовок также содержит возможность OAuth, которую требует upstream, и удаление его приводит к отказу этих запросов с `401` |

87| `x-claude-code-session-id` | Уникальный идентификатор текущего сеанса Claude Code. Используйте его для агрегирования всех запросов из одного сеанса без анализа тел запросов |87| `x-claude-code-session-id` | Уникальный идентификатор текущего сеанса Claude Code. Используйте его для агрегирования всех запросов из одного сеанса без анализа тел запросов |

88| `x-claude-code-agent-id` | Идентификатор [подагента](/ru/sub-agents), который выдал запрос, присутствует только в запросах от агента, порожденного Claude Code внутри сеанса. Используйте его с идентификатором сеанса для отнесения затрат к параллельным агентам |88| `x-claude-code-agent-id` | Идентификатор [подагента](/docs/ru/sub-agents), который выдал запрос, присутствует только в запросах от агента, порожденного Claude Code внутри сеанса. Используйте его с идентификатором сеанса для отнесения затрат к параллельным агентам |

89| `x-claude-code-parent-agent-id` | Идентификатор агента, который породил запрашивающего агента, присутствует только для вложенных агентов |89| `x-claude-code-parent-agent-id` | Идентификатор агента, который породил запрашивающего агента, присутствует только для вложенных агентов |

90 90 

91Идентификаторы подагентов генерируются заново для каждого порождения. Агенты товарищей, названные члены [команды агентов](/ru/agent-teams), повторно используют стабильный идентификатор на основе имени при переподключениях. В обоих случаях идентификатор идентифицирует агента, а не человека или устройство, поэтому не рассматривайте заголовок идентификатора агента как идентификатор пользователя.91Идентификаторы подагентов генерируются заново для каждого порождения. Агенты товарищей, названные члены [команды агентов](/docs/ru/agent-teams), повторно используют стабильный идентификатор на основе имени при переподключениях. В обоих случаях идентификатор идентифицирует агента, а не человека или устройство, поэтому не рассматривайте заголовок идентификатора агента как идентификатор пользователя.

92 92 

93Если ваши разработчики установили `ANTHROPIC_CUSTOM_HEADERS`, эти заголовки также появляются в запросах.93Если ваши разработчики установили `ANTHROPIC_CUSTOM_HEADERS`, эти заголовки также появляются в запросах.

94 94 


112 112 

113* Пересылайте массив `system` точно так, как он был получен, сохраняя блок первым: добавление другого системного блока в начало, переупорядочение массива или преобразование его в одну строку нарушает удаление, и блок затем достигает модели и ключа кеша приглашений.113* Пересылайте массив `system` точно так, как он был получен, сохраняя блок первым: добавление другого системного блока в начало, переупорядочение массива или преобразование его в одну строку нарушает удаление, и блок затем достигает модели и ключа кеша приглашений.

114* Сохраняйте блок в собственной записи массива: конечная точка рассматривает объединённый блок, который начинается с заголовка атрибуции, как атрибуцию в целом и удаляет всё объединённое в него, включая остальную часть системного приглашения.114* Сохраняйте блок в собственной записи массива: конечная точка рассматривает объединённый блок, который начинается с заголовка атрибуции, как атрибуцию в целом и удаляет всё объединённое в него, включая остальную часть системного приглашения.

115* Если ваш шлюз должен переформатировать системное содержимое, установите [`CLAUDE_CODE_ATTRIBUTION_HEADER=0`](/ru/env-vars), чтобы Claude Code опустил блок. Anthropic и конечные точки Claude облачных поставщиков читают блок для атрибуции, поэтому опустите его на клиенте, а не удаляйте или перемещайте его в шлюзе.115* Если ваш шлюз должен переформатировать системное содержимое, установите [`CLAUDE_CODE_ATTRIBUTION_HEADER=0`](/docs/ru/env-vars), чтобы Claude Code опустил блок. Anthropic и конечные точки Claude облачных поставщиков читают блок для атрибуции, поэтому опустите его на клиенте, а не удаляйте или перемещайте его в шлюзе.

116 116 

117Запросы, которые достигают конечной точки без изменений, не затронуты.117Запросы, которые достигают конечной точки без изменений, не затронуты.

118 118 

119{/* min-version: 2.1.181 */}Начиная с Claude Code v2.1.181, блок стабилен в течение всего времени жизни разговора, когда запросы маршрутизируются через пользовательский базовый URL, поэтому кеш приглашений gateway на основе полного тела запроса работает без отключения его. До v2.1.181 блок включал токен для каждого запроса; на этих версиях установите `CLAUDE_CODE_ATTRIBUTION_HEADER=0`, если ваш gateway реализует такой кеш.119Начиная с Claude Code v2.1.181, блок стабилен в течение всего времени жизни разговора, когда запросы маршрутизируются через пользовательский базовый URL, поэтому кеш приглашений gateway на основе полного тела запроса работает без отключения его. До v2.1.181 блок включал токен для каждого запроса; на этих версиях установите `CLAUDE_CODE_ATTRIBUTION_HEADER=0`, если ваш gateway реализует такой кеш.

120 120 

121<h2 id="feature-pass-through">121<h2 id="feature-pass-through">

122 Сквозная передача функций122 Сквозная передача функций


126 126 

127Возможности, которые добавляют поля тела, связывают их с бета-заголовком, и пара путешествует вместе. Gateway, который удаляет заголовок при передаче тела или пересылает тело формата Anthropic на upstream с другой схемой, создает жесткие ошибки `400`; только когда обе половины отсутствуют вместе, функция отключается тихо. Gateway, который переписывает или редактирует тела запросов для проверки содержимого, нарушает связь так же, как удаление, поэтому проверяйте без изменения. Таблица отмечает, где функция отклоняется от связи.127Возможности, которые добавляют поля тела, связывают их с бета-заголовком, и пара путешествует вместе. Gateway, который удаляет заголовок при передаче тела или пересылает тело формата Anthropic на upstream с другой схемой, создает жесткие ошибки `400`; только когда обе половины отсутствуют вместе, функция отключается тихо. Gateway, который переписывает или редактирует тела запросов для проверки содержимого, нарушает связь так же, как удаление, поэтому проверяйте без изменения. Таблица отмечает, где функция отклоняется от связи.

128 128 

129Потоковая передача инструментов с точной детализацией — одно из значений по умолчанию для прямого соединения: она отключена по умолчанию, когда запросы маршрутизируются через пользовательский базовый URL, и gateway получает ее, когда разработчики установили [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/ru/env-vars).129Потоковая передача инструментов с точной детализацией — одно из значений по умолчанию для прямого соединения: она отключена по умолчанию, когда запросы маршрутизируются через пользовательский базовый URL, и gateway получает ее, когда разработчики установили [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/docs/ru/env-vars).

130 130 

131| Функция | Заголовок и связь тела | Симптом при нарушении | Исправление |131| Функция | Заголовок и связь тела | Симптом при нарушении | Исправление |

132| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |132| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

133| [Адаптивное рассуждение](/ru/model-config#adjust-effort-level) | Нет бета-заголовка. Claude Code отправляет `thinking: {"type": "adaptive"}` для Claude 4.6 и позже и рассматривает имена моделей, которые он не распознает, такие как псевдонимы gateway, как текущие модели, которые получают поле | `400` с указанием поля `thinking` или тега `adaptive`, когда сборка модели upstream его не принимает | Обновите upstream. На Opus 4.6 и Sonnet 4.6 разработчики могут вместо этого установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` |133| [Адаптивное рассуждение](/docs/ru/model-config#adjust-effort-level) | Нет бета-заголовка. Claude Code отправляет `thinking: {"type": "adaptive"}` для Claude 4.6 и позже и рассматривает имена моделей, которые он не распознает, такие как псевдонимы gateway, как текущие модели, которые получают поле | `400` с указанием поля `thinking` или тега `adaptive`, когда сборка модели upstream его не принимает | Обновите upstream. На Opus 4.6 и Sonnet 4.6 разработчики могут вместо этого установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` |

134| [Управление контекстом](https://platform.claude.com/docs/en/build-with-claude/context-management) | Бета-заголовок управления контекстом связан с полем тела `context_management` | `400` с `Extra inputs are not permitted`. Часто встречается, когда gateway принимает запросы формата Anthropic, но пересылает их на Amazon Bedrock | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ru/env-vars) |134| [Управление контекстом](https://platform.claude.com/docs/en/build-with-claude/context-management) | Бета-заголовок управления контекстом связан с полем тела `context_management` | `400` с `Extra inputs are not permitted`. Часто встречается, когда gateway принимает запросы формата Anthropic, но пересылает их на Amazon Bedrock | Пересылайте оба или [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) |

135| [Расширенный контекст](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) и [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | Только бета-заголовки, нет поля тела | Молча недоступно, когда заголовок удален; upstream никогда не видит запрос возможности | Пересылайте `anthropic-beta` дословно |135| [Расширенный контекст](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) и [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | Только бета-заголовки, нет поля тела | Молча недоступно, когда заголовок удален; upstream никогда не видит запрос возможности | Пересылайте `anthropic-beta` дословно |

136| Бета [поля инструментов](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Бета-заголовки, связанные с инструментами, связаны с полями схемы инструментов, такими как `strict` и `defer_loading` | `400` с указанием неузнанного поля схемы инструмента, когда тело проходит без его заголовка | Пересылайте оба или `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |136| Бета [поля инструментов](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Бета-заголовки, связанные с инструментами, связаны с полями схемы инструментов, такими как `strict` и `defer_loading` | `400` с указанием неузнанного поля схемы инструмента, когда тело проходит без его заголовка | Пересылайте оба или `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |

137| [Усилие](https://platform.claude.com/docs/en/build-with-claude/effort) и [структурированные выходы](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Поле тела `output_config` содержит усилие, формат структурированного вывода и параметры бюджета задачи; каждое связано с собственным бета-заголовком | `400` с указанием `output_config`, часто `Extra inputs are not permitted`, на upstream-ах Amazon Bedrock и Google Cloud's Agent Platform | Пересылайте поле и его заголовки вместе |137| [Усилие](https://platform.claude.com/docs/en/build-with-claude/effort) и [структурированные выходы](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Поле тела `output_config` содержит усилие, формат структурированного вывода и параметры бюджета задачи; каждое связано с собственным бета-заголовком | `400` с указанием `output_config`, часто `Extra inputs are not permitted`, на upstream-ах Amazon Bedrock и Google Cloud's Agent Platform | Пересылайте поле и его заголовки вместе |

138| [Подсчет токенов](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Нет бета-связи; использует конечную точку `count_tokens` | Claude Code возвращается к локальной оценке использования контекста | Предоставьте конечную точку, если вы хотите точные подсчеты |138| [Подсчет токенов](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Нет бета-связи; использует конечную точку `count_tokens` | Claude Code возвращается к локальной оценке использования контекста | Предоставьте конечную точку, если вы хотите точные подсчеты |

139 139 

140Переменные `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [объявляют](/ru/model-config) возможности модели только в конфигурациях поставщика: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` и [`CLAUDE_CODE_USE_MANTLE`](/ru/amazon-bedrock#use-the-mantle-endpoint). Они не имеют эффекта позади gateway `ANTHROPIC_BASE_URL`.140Переменные `ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [объявляют](/docs/ru/model-config) возможности модели только в конфигурациях поставщика: `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY` и [`CLAUDE_CODE_USE_MANTLE`](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Они не имеют эффекта позади gateway `ANTHROPIC_BASE_URL`.

141 141 

142<h3 id="automatic-retry-and-error-forwarding">142<h3 id="automatic-retry-and-error-forwarding">

143 Автоматический повтор и пересылка ошибок143 Автоматический повтор и пересылка ошибок


161 161 

162Когда `ANTHROPIC_BASE_URL` указывает на gateway, который предоставляет формат Anthropic Messages, Claude Code может запросить конечную точку `/v1/models` gateway при запуске и добавить возвращаемые модели в средство выбора `/model`.162Когда `ANTHROPIC_BASE_URL` указывает на gateway, который предоставляет формат Anthropic Messages, Claude Code может запросить конечную точку `/v1/models` gateway при запуске и добавить возвращаемые модели в средство выбора `/model`.

163 163 

164Разработчики включают это, установив [`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`](/ru/env-vars) в своей собственной среде или через управляемые параметры. Обнаружение отключено по умолчанию, чтобы gateway-ы, поддерживаемые общим ключом API, не выводили каждую модель, к которой ключ может получить доступ, каждому пользователю. Это требует Claude Code v2.1.129 или позже.164Разработчики включают это, установив [`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`](/docs/ru/env-vars) в своей собственной среде или через управляемые параметры. Обнаружение отключено по умолчанию, чтобы gateway-ы, поддерживаемые общим ключом API, не выводили каждую модель, к которой ключ может получить доступ, каждому пользователю. Это требует Claude Code v2.1.129 или позже.

165 165 

166<h3 id="when-discovery-runs">166<h3 id="when-discovery-runs">

167 Когда выполняется обнаружение167 Когда выполняется обнаружение


171 171 

172* Установлена любая переменная поставщика `CLAUDE_CODE_USE_*`, даже если также установлен `ANTHROPIC_BASE_URL`172* Установлена любая переменная поставщика `CLAUDE_CODE_USE_*`, даже если также установлен `ANTHROPIC_BASE_URL`

173* `ANTHROPIC_BASE_URL` не установлен или указывает на `api.anthropic.com`173* `ANTHROPIC_BASE_URL` не установлен или указывает на `api.anthropic.com`

174* Несущественный трафик отключен через [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ru/env-vars) или политику организации174* Несущественный трафик отключен через [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars) или политику организации

175 175 

176<h3 id="request-and-response">176<h3 id="request-and-response">

177 Запрос и ответ177 Запрос и ответ


182Запрос обнаружения отправляет ровно один заголовок учетных данных:182Запрос обнаружения отправляет ровно один заголовок учетных данных:

183 183 

184* `ANTHROPIC_AUTH_TOKEN` как токен носителя, когда установлен184* `ANTHROPIC_AUTH_TOKEN` как токен носителя, когда установлен

185* В противном случае разрешенный ключ API, включая значение [`apiKeyHelper`](/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper), в заголовке `x-api-key`185* В противном случае разрешенный ключ API, включая значение [`apiKeyHelper`](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper), в заголовке `x-api-key`

186 186 

187Это отличается от запросов вывода, которые отправляют значение помощника в обоих заголовках. Gateway, который аутентифицирует `/v1/models`, должен принимать `x-api-key` для развертываний помощника. Любые заголовки из `ANTHROPIC_CUSTOM_HEADERS` также включены.187Это отличается от запросов вывода, которые отправляют значение помощника в обоих заголовках. Gateway, который аутентифицирует `/v1/models`, должен принимать `x-api-key` для развертываний помощника. Любые заголовки из `ANTHROPIC_CUSTOM_HEADERS` также включены.

188 188 


201 Записи средства выбора и кеширование201 Записи средства выбора и кеширование

202</h3>202</h3>

203 203 

204Средство выбора — это интерактивный список моделей, который открывается, когда разработчик запускает `/model` в Claude Code. Каждая обнаруженная запись помечена "From gateway" и использует `display_name` при предоставлении. Управляемый параметр [`availableModels`](/ru/settings#available-settings) ограничивает то, что может добавить обнаружение.204Средство выбора — это интерактивный список моделей, который открывается, когда разработчик запускает `/model` в Claude Code. Каждая обнаруженная запись помечена "From gateway" и использует `display_name` при предоставлении. Управляемый параметр [`availableModels`](/docs/ru/settings#available-settings) ограничивает то, что может добавить обнаружение.

205 205 

206Обнаруженный ID пропускается, когда он точно совпадает со строкой, уже находящейся в средстве выбора, или когда оба обнаруженный и существующий ID разрешаются в [Fable](/ru/model-config#work-with-fable-5). {/* min-version: 2.1.197 */}Начиная с Claude Code v2.1.197, обнаруженный явный ID также объединяется со встроенной записью, когда оба разрешаются в одну и ту же модель. Встроенные строки ключены по псевдонимам, таким как `sonnet`, поэтому обнаруженный явный ID модели, на которую псевдоним в настоящее время разрешается, такой как `claude-sonnet-5`, объединяется в строку `sonnet`, в то время как ID, на который псевдоним не разрешается, такой как `claude-sonnet-4-6`, по-прежнему добавляет собственную строку "From gateway" рядом со встроенной записью.206Обнаруженный ID пропускается, когда он точно совпадает со строкой, уже находящейся в средстве выбора, или когда оба обнаруженный и существующий ID разрешаются в [Fable](/docs/ru/model-config#work-with-fable-5). Начиная с Claude Code v2.1.197, обнаруженный явный ID также объединяется со встроенной записью, когда оба разрешаются в одну и ту же модель. Встроенные строки ключены по псевдонимам, таким как `sonnet`, поэтому обнаруженный явный ID модели, на которую псевдоним в настоящее время разрешается, такой как `claude-sonnet-5`, объединяется в строку `sonnet`, в то время как ID, на который псевдоним не разрешается, такой как `claude-sonnet-4-6`, по-прежнему добавляет собственную строку "From gateway" рядом со встроенной записью.

207 207 

208Результаты кешируются в `~/.claude/cache/gateway-models.json` или `%USERPROFILE%\.claude\cache\gateway-models.json` на Windows и обновляются при каждом запуске. Если запрос не выполняется или gateway не реализует `/v1/models`, средство выбора возвращается к кешированному списку из предыдущего запуска или к встроенному списку моделей. Если ваш gateway обслуживает модели Claude под псевдонимами, которые не совпадают с фильтром обнаружения, разработчики могут добавить эти псевдонимы вручную с помощью переменных [конфигурации модели](/ru/model-config).208Результаты кешируются в `~/.claude/cache/gateway-models.json` или `%USERPROFILE%\.claude\cache\gateway-models.json` на Windows и обновляются при каждом запуске. Если запрос не выполняется или gateway не реализует `/v1/models`, средство выбора возвращается к кешированному списку из предыдущего запуска или к встроенному списку моделей. Если ваш gateway обслуживает модели Claude под псевдонимами, которые не совпадают с фильтром обнаружения, разработчики могут добавить эти псевдонимы вручную с помощью переменных [конфигурации модели](/docs/ru/model-config).

209 209 

210<h2 id="related-resources">210<h2 id="related-resources">

211 Связанные ресурсы211 Связанные ресурсы


213 213 

214Для остальной документации gateway и базовых справочников API:214Для остальной документации gateway и базовых справочников API:

215 215 

216* [Обзор gateway](/ru/gateways): что такое gateway и как выбрать между Claude apps gateway и другим продуктом216* [Обзор gateway](/docs/ru/gateways): что такое gateway и как выбрать между Claude apps gateway и другим продуктом

217* [Другие LLM gateway](/ru/llm-gateway): как развернуть gateway, который работает в вашей организации, и как он взаимодействует с подписками claude.ai217* [Другие LLM gateway](/docs/ru/llm-gateway): как развернуть gateway, который работает в вашей организации, и как он взаимодействует с подписками claude.ai

218* [Развертывание LLM gateway для вашей организации](/ru/llm-gateway-rollout): контрольный список администратора, который использует этот контракт218* [Развертывание LLM gateway для вашей организации](/docs/ru/llm-gateway-rollout): контрольный список администратора, который использует этот контракт

219* [Подключение Claude Code к LLM gateway](/ru/llm-gateway-connect): конфигурация для каждого разработчика и таблица устранения неполадок219* [Подключение Claude Code к LLM gateway](/docs/ru/llm-gateway-connect): конфигурация для каждого разработчика и таблица устранения неполадок

220* [Справочник бета-заголовков](https://platform.claude.com/docs/en/api/beta-headers): текущий набор значений `anthropic-beta`220* [Справочник бета-заголовков](https://platform.claude.com/docs/en/api/beta-headers): текущий набор значений `anthropic-beta`

221* [Messages API](https://platform.claude.com/docs/en/api/messages): формат API, который реализует gateway формата Anthropic221* [Messages API](https://platform.claude.com/docs/en/api/messages): формат API, который реализует gateway формата Anthropic

Details

9На этой странице администратор пройдет через развертывание LLM-шлюза для Claude Code. Предполагается, что у вас уже развернут продукт шлюза, соответствующий [требованиям шлюза](#gateway-requirements). Развертывание или эксплуатация какого-либо конкретного продукта здесь не рассматривается; разверните свой продукт, следуя документации его поставщика.9На этой странице администратор пройдет через развертывание LLM-шлюза для Claude Code. Предполагается, что у вас уже развернут продукт шлюза, соответствующий [требованиям шлюза](#gateway-requirements). Развертывание или эксплуатация какого-либо конкретного продукта здесь не рассматривается; разверните свой продукт, следуя документации его поставщика.

10 10 

11<Note>11<Note>

12 * Чтобы подключить Claude Code на вашей машине к существующему шлюзу, см. [Подключение Claude Code к LLM-шлюзу](/ru/llm-gateway-connect)12 * Чтобы подключить Claude Code на вашей машине к существующему шлюзу, см. [Подключение Claude Code к LLM-шлюзу](/docs/ru/llm-gateway-connect)

13 * Информацию о том, что Claude Code отправляет на шлюз и что перенаправлять, см. в [справочнике протокола шлюза](/ru/llm-gateway-protocol)13 * Информацию о том, что Claude Code отправляет на шлюз и что перенаправлять, см. в [справочнике протокола шлюза](/docs/ru/llm-gateway-protocol)

14</Note>14</Note>

15 15 

16<h2 id="prerequisites">16<h2 id="prerequisites">


22* Шлюз, развернутый на вашей инфраструктуре, обслуживающий HTTPS по точному адресу, который вы будете распределять разработчикам, а не адресу, который перенаправляет на него, и настроенный для маршрутизации имен моделей Claude к вашему поставщику22* Шлюз, развернутый на вашей инфраструктуре, обслуживающий HTTPS по точному адресу, который вы будете распределять разработчикам, а не адресу, который перенаправляет на него, и настроенный для маршрутизации имен моделей Claude к вашему поставщику

23* Учетные данные поставщика для шлюза для перенаправления:23* Учетные данные поставщика для шлюза для перенаправления:

24 * Для Anthropic API: ключ API из [Claude Console](https://platform.claude.com/settings/keys)24 * Для Anthropic API: ключ API из [Claude Console](https://platform.claude.com/settings/keys)

25 * Для облачного поставщика: облачные учетные данные с доступом к моделям. См. предварительные требования на странице [Amazon Bedrock](/ru/amazon-bedrock#prerequisites), [Google Cloud's Agent Platform](/ru/google-vertex-ai#prerequisites) или [Microsoft Foundry](/ru/microsoft-foundry#prerequisites)25 * Для облачного поставщика: облачные учетные данные с доступом к моделям. См. предварительные требования на странице [Amazon Bedrock](/docs/ru/amazon-bedrock#prerequisites), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai#prerequisites) или [Microsoft Foundry](/docs/ru/microsoft-foundry#prerequisites)

26* Способ доставки файлов параметров на машины разработчиков, например MDM или управление конфигурацией26* Способ доставки файлов параметров на машины разработчиков, например MDM или управление конфигурацией

27 * Если у вас его еще нет, [как параметры достигают устройств](/ru/admin-setup#decide-how-settings-reach-devices) сравнивает варианты27 * Если у вас его еще нет, [как параметры достигают устройств](/docs/ru/admin-setup#decide-how-settings-reach-devices) сравнивает варианты

28 28 

29<h3 id="gateway-requirements">29<h3 id="gateway-requirements">

30 Требования к шлюзу30 Требования к шлюзу


32 32 

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

34 34 

35* **Принимать поддерживаемый формат API**: один из форматов в [таблице форматов API](/ru/llm-gateway-protocol#api-formats). Шаги развертывания ниже предполагают Anthropic Messages API в `POST /v1/messages`, который обслуживает большинство шлюзов35* **Принимать поддерживаемый формат API**: один из форматов в [таблице форматов API](/docs/ru/llm-gateway-protocol#api-formats). Шаги развертывания ниже предполагают Anthropic Messages API в `POST /v1/messages`, который обслуживает большинство шлюзов

36* **Потоковая передача ответов**: передавать события, отправляемые сервером, по мере их поступления вместо буферизации всего ответа36* **Потоковая передача ответов**: передавать события, отправляемые сервером, по мере их поступления вместо буферизации всего ответа

37* **Маршрутизация имен моделей Claude**: сопоставлять каждое имя, которое используют разработчики, с восходящей моделью. Claude Code отправляет имя модели, такое как `claude-sonnet-4-6`, в каждом запросе; в большинстве продуктов шлюза сопоставление представляет собой список моделей или таблицу маршрутизации в собственной конфигурации шлюза37* **Маршрутизация имен моделей Claude**: сопоставлять каждое имя, которое используют разработчики, с восходящей моделью. Claude Code отправляет имя модели, такое как `claude-sonnet-4-6`, в каждом запросе; в большинстве продуктов шлюза сопоставление представляет собой список моделей или таблицу маршрутизации в собственной конфигурации шлюза

38* **Перенаправлять заголовки и тело без изменений**: передавать `anthropic-beta`, `anthropic-version` и тело запроса в обоих направлениях; [таблица сквозной передачи функций](/ru/llm-gateway-protocol#feature-pass-through) сопоставляет каждый с функцией, которая нарушается без него38* **Перенаправлять заголовки и тело без изменений**: передавать `anthropic-beta`, `anthropic-version` и тело запроса в обоих направлениях; [таблица сквозной передачи функций](/docs/ru/llm-gateway-protocol#feature-pass-through) сопоставляет каждый с функцией, которая нарушается без него

39* **Возвращать ошибки восходящего потока без изменений**: автоматическое восстановление Claude Code соответствует формулировке ошибки, поэтому обертывание ошибок в собственный конверт шлюза нарушает его39* **Возвращать ошибки восходящего потока без изменений**: автоматическое восстановление Claude Code соответствует формулировке ошибки, поэтому обертывание ошибок в собственный конверт шлюза нарушает его

40* **Исключить путь из проверки тела запроса WAF**: подсказки Claude Code содержат исходный код и теги в стиле XML, которые соответствуют правилам тела для межсайтовых скриптов; WAF перед шлюзом возвращает `403` на реальных сеансах, в то время как короткие тестовые запросы проходят40* **Исключить путь из проверки тела запроса WAF**: подсказки Claude Code содержат исходный код и теги в стиле XML, которые соответствуют правилам тела для межсайтовых скриптов; WAF перед шлюзом возвращает `403` на реальных сеансах, в то время как короткие тестовые запросы проходят

41 41 

42Опционально обслуживайте `GET /v1/models`, чтобы Claude Code мог заполнить средство выбора модели из вашего шлюза с помощью [обнаружения моделей](/ru/llm-gateway-protocol#model-discovery). {/* min-version: 2.1.129 */}42Опционально обслуживайте `GET /v1/models`, чтобы Claude Code мог заполнить средство выбора модели из вашего шлюза с помощью [обнаружения моделей](/docs/ru/llm-gateway-protocol#model-discovery).&#x20;

43 43 

44<h2 id="rollout-steps">44<h2 id="rollout-steps">

45 Шаги развертывания45 Шаги развертывания


96Повторите запрос один раз для каждого имени модели Claude в конфигурации маршрутизации вашего шлюза. Имя, которое шлюз не маршрутизирует, возвращает `404` любому разработчику, который его выбирает, поэтому протестируйте каждое имя перед развертыванием.96Повторите запрос один раз для каждого имени модели Claude в конфигурации маршрутизации вашего шлюза. Имя, которое шлюз не маршрутизирует, возвращает `404` любому разработчику, который его выбирает, поэтому протестируйте каждое имя перед развертыванием.

97 97 

98<Note>98<Note>

99 Избегайте обслуживания шлюза за перенаправлением. Перенаправление может отбросить тело запроса или удалить заголовок учетных данных на запросах вывода, и [обнаружение моделей](/ru/llm-gateway-protocol#model-discovery) рассматривает любое перенаправление как сбой, поэтому учетные данные не могут утечь на цель перенаправления.99 Избегайте обслуживания шлюза за перенаправлением. Перенаправление может отбросить тело запроса или удалить заголовок учетных данных на запросах вывода, и [обнаружение моделей](/docs/ru/llm-gateway-protocol#model-discovery) рассматривает любое перенаправление как сбой, поэтому учетные данные не могут утечь на цель перенаправления.

100</Note>100</Note>

101 101 

102<h3 id="issue-developer-credentials">102<h3 id="issue-developer-credentials">


130 130 

131**Контрольная точка**: `200` с полем `content` означает, что ключ разработчика достигает шлюза и шлюз его перенаправляет. `401` здесь, когда [предыдущий шаг](#confirm-the-gateway-routes-your-models) был успешным, означает, что ключ разработчика неправильный или еще не вступил в силу на шлюзе.131**Контрольная точка**: `200` с полем `content` означает, что ключ разработчика достигает шлюза и шлюз его перенаправляет. `401` здесь, когда [предыдущий шаг](#confirm-the-gateway-routes-your-models) был успешным, означает, что ключ разработчика неправильный или еще не вступил в силу на шлюзе.

132 132 

133Выдача одного ключа на разработчика вместо общего ключа — это то, что делает возможной атрибуцию использования для каждого разработчика и отдельное удаление. Переменная окружения, которая содержит ключ, зависит от того, какой заголовок читает шлюз. Для шлюза, который проверяет учетные данные в заголовке `Authorization: Bearer`, разработчики устанавливают свой ключ в `ANTHROPIC_AUTH_TOKEN`. Для шлюза, который читает ключи из заголовка `x-api-key`, разработчики вместо этого устанавливают `ANTHROPIC_API_KEY`; [таблица учетных данных](/ru/llm-gateway-connect#set-the-credential-variable) охватывает сопоставление.133Выдача одного ключа на разработчика вместо общего ключа — это то, что делает возможной атрибуцию использования для каждого разработчика и отдельное удаление. Переменная окружения, которая содержит ключ, зависит от того, какой заголовок читает шлюз. Для шлюза, который проверяет учетные данные в заголовке `Authorization: Bearer`, разработчики устанавливают свой ключ в `ANTHROPIC_AUTH_TOKEN`. Для шлюза, который читает ключи из заголовка `x-api-key`, разработчики вместо этого устанавливают `ANTHROPIC_API_KEY`; [таблица учетных данных](/docs/ru/llm-gateway-connect#set-the-credential-variable) охватывает сопоставление.

134 134 

135<h3 id="test-claude-code-against-the-gateway">135<h3 id="test-claude-code-against-the-gateway">

136 Протестировать Claude Code против шлюза136 Протестировать Claude Code против шлюза


165* `Not logged in`: проверьте журнал шлюза, чтобы различить две причины. Если он пуст, никакие учетные данные не достигли сеанса и никакой запрос не покинул машину; повторно запустите экспорты в оболочке, которую вы тестируете. Если он показывает отклоненный запрос с `x-api-key` в теле `401`, шлюз ожидает ключи в этом заголовке вместо этого; переключитесь на `ANTHROPIC_API_KEY`165* `Not logged in`: проверьте журнал шлюза, чтобы различить две причины. Если он пуст, никакие учетные данные не достигли сеанса и никакой запрос не покинул машину; повторно запустите экспорты в оболочке, которую вы тестируете. Если он показывает отклоненный запрос с `x-api-key` в теле `401`, шлюз ожидает ключи в этом заголовке вместо этого; переключитесь на `ANTHROPIC_API_KEY`

166* `Failed to authenticate. API Error: 401` означает, что учетные данные были отправлены и отклонены, и журнал шлюза говорит где: `401`, называющий `api.anthropic.com` или конечную точку вашего поставщика, означает, что шлюз достиг восходящего потока, но его учетные данные поставщика были отклонены, поэтому ключ разработчика работал и учетные данные поставщика, которые держит шлюз, неправильные или заполнитель166* `Failed to authenticate. API Error: 401` означает, что учетные данные были отправлены и отклонены, и журнал шлюза говорит где: `401`, называющий `api.anthropic.com` или конечную точку вашего поставщика, означает, что шлюз достиг восходящего потока, но его учетные данные поставщика были отклонены, поэтому ключ разработчика работал и учетные данные поставщика, которые держит шлюз, неправильные или заполнитель

167 167 

168Неправильный или недостижимый базовый URL производит другой симптом: Claude Code [повторяет попытку подключения с отступом](/ru/errors#automatic-retries) и может сидеть без вывода в течение нескольких минут перед сообщением об ошибке. Если команда кажется зависшей, проверьте журнал шлюза вместо ожидания; отсутствие поступающего запроса означает, что `ANTHROPIC_BASE_URL` не указывает на шлюз.168Неправильный или недостижимый базовый URL производит другой симптом: Claude Code [повторяет попытку подключения с отступом](/docs/ru/errors#automatic-retries) и может сидеть без вывода в течение нескольких минут перед сообщением об ошибке. Если команда кажется зависшей, проверьте журнал шлюза вместо ожидания; отсутствие поступающего запроса означает, что `ANTHROPIC_BASE_URL` не указывает на шлюз.

169 169 

170<h3 id="distribute-the-configuration">170<h3 id="distribute-the-configuration">

171 Распределить конфигурацию171 Распределить конфигурацию

172</h3>172</h3>

173 173 

174Каждой машине разработчика нужны адрес шлюза и учетные данные. Вы можете распределять их централизованно через [управляемые параметры](/ru/settings#settings-files), чтобы разработчики ничего не настраивали, или передать разработчикам значения для самостоятельной установки.174Каждой машине разработчика нужны адрес шлюза и учетные данные. Вы можете распределять их централизованно через [управляемые параметры](/docs/ru/settings#settings-files), чтобы разработчики ничего не настраивали, или передать разработчикам значения для самостоятельной установки.

175 175 

176<h4 id="what-to-distribute">176<h4 id="what-to-distribute">

177 Что распределять177 Что распределять


186| `ANTHROPIC_CUSTOM_HEADERS` | Добавляет дополнительные HTTP-заголовки к каждому запросу API | Ваш шлюз требует заголовок клиента или маршрутизации на каждом запросе |186| `ANTHROPIC_CUSTOM_HEADERS` | Добавляет дополнительные HTTP-заголовки к каждому запросу API | Ваш шлюз требует заголовок клиента или маршрутизации на каждом запросе |

187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Запрашивает `/v1/models` шлюза при запуске и добавляет возвращаемые имена в средство выбора `/model` | Ваш шлюз обслуживает `/v1/models` и вы хотите, чтобы средства выбора разработчиков были заполнены из него |187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Запрашивает `/v1/models` шлюза при запуске и добавляет возвращаемые имена в средство выбора `/model` | Ваш шлюз обслуживает `/v1/models` и вы хотите, чтобы средства выбора разработчиков были заполнены из него |

188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Останавливает отправку Claude Code заголовков и полей тела предварительного выпуска | Ваш шлюз перенаправляет на восходящий Bedrock или Agent Platform, который отклоняет поля бета-версии; см. [Требования к шлюзу](#gateway-requirements) |188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Останавливает отправку Claude Code заголовков и полей тела предварительного выпуска | Ваш шлюз перенаправляет на восходящий Bedrock или Agent Platform, который отклоняет поля бета-версии; см. [Требования к шлюзу](#gateway-requirements) |

189| `ANTHROPIC_MODEL` или [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ru/model-config) | Установить, какое имя модели Claude Code запрашивает для основного сеанса и для фонового трафика | Ваш шлюз маршрутизирует имена моделей, которые не соответствуют значениям по умолчанию Claude Code, или вы маршрутизируете [фоновую функциональность](/ru/costs#background-token-usage) на другую модель. Маршрутизируйте как переопределенные имена, так и встроенные идентификаторы моделей Claude Code, которые запрашиваются, когда переопределение не установлено, так как некоторые подвызовы могут запросить встроенный идентификатор независимо от переопределения; [конфигурация моделей](/ru/model-config) охватывает, какую модель использует каждая часть сеанса |189| `ANTHROPIC_MODEL` или [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/ru/model-config) | Установить, какое имя модели Claude Code запрашивает для основного сеанса и для фонового трафика | Ваш шлюз маршрутизирует имена моделей, которые не соответствуют значениям по умолчанию Claude Code, или вы маршрутизируете [фоновую функциональность](/docs/ru/costs#background-token-usage) на другую модель. Маршрутизируйте как переопределенные имена, так и встроенные идентификаторы моделей Claude Code, которые запрашиваются, когда переопределение не установлено, так как некоторые подвызовы могут запросить встроенный идентификатор независимо от переопределения; [конфигурация моделей](/docs/ru/model-config) охватывает, какую модель использует каждая часть сеанса |

190| `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, `ANTHROPIC_FOUNDRY_BASE_URL` или `ANTHROPIC_AWS_BASE_URL` с [переменными для этого поставщика](/ru/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Указать Claude Code на шлюз через базовый URL, специфичный для поставщика. Bedrock и Agent Platform также переключаются на собственный формат запроса этих поставщиков | Ваш шлюз находится перед Bedrock, Agent Platform, Foundry или Claude Platform на AWS; см. [Форматы API](/ru/llm-gateway-protocol#api-formats) |190| `ANTHROPIC_BEDROCK_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, `ANTHROPIC_FOUNDRY_BASE_URL` или `ANTHROPIC_AWS_BASE_URL` с [переменными для этого поставщика](/docs/ru/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Указать Claude Code на шлюз через базовый URL, специфичный для поставщика. Bedrock и Agent Platform также переключаются на собственный формат запроса этих поставщиков | Ваш шлюз находится перед Bedrock, Agent Platform, Foundry или Claude Platform на AWS; см. [Форматы API](/docs/ru/llm-gateway-protocol#api-formats) |

191 191 

192<h4 id="distribute-through-managed-settings">192<h4 id="distribute-through-managed-settings">

193 Распределить через управляемые параметры193 Распределить через управляемые параметры

194</h4>194</h4>

195 195 

196Доставляйте переменные через блок `env` [файла управляемых параметров](/ru/settings#settings-files), отправляемого MDM, политикой реестра или управлением конфигурацией:196Доставляйте переменные через блок `env` [файла управляемых параметров](/docs/ru/settings#settings-files), отправляемого MDM, политикой реестра или управлением конфигурацией:

197 197 

198```json theme={null}198```json theme={null}

199{199{


206 206 

207Добавьте условные переменные из таблицы в тот же блок `env`. Управляемый `ANTHROPIC_BASE_URL` применяется и не может быть переопределен экспортом оболочки разработчика, так как Claude Code применяет его над переменными процесса и параметрами с более низким приоритетом.207Добавьте условные переменные из таблицы в тот же блок `env`. Управляемый `ANTHROPIC_BASE_URL` применяется и не может быть переопределен экспортом оболочки разработчика, так как Claude Code применяет его над переменными процесса и параметрами с более низким приоритетом.

208 208 

209Не включайте `forceLoginMethod` или `forceLoginOrgUUID` в управляемые параметры вместе с учетными данными шлюза. На Claude Code v2.1.146 и позже любой ключ блокирует `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` и `apiKeyHelper` при запуске, поэтому разработчики видят `This machine's managed settings require a first-party login` и не могут продолжить. {/* min-version: 2.1.146 */}209Не включайте `forceLoginMethod` или `forceLoginOrgUUID` в управляемые параметры вместе с учетными данными шлюза. На Claude Code v2.1.146 и позже любой ключ блокирует `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` и `apiKeyHelper` при запуске, поэтому разработчики видят `This machine's managed settings require a first-party login` и не могут продолжить.&#x20;

210 210 

211[Доставка управляемых параметров на сервере](/ru/server-managed-settings#platform-availability) требует прямого подключения к `api.anthropic.com`, поэтому она не достигает сеансов, маршрутизируемых через шлюз. Развертывания шлюза используют этот путь управляемых параметров на основе файлов, который применяет те же ключи.211[Доставка управляемых параметров на сервере](/docs/ru/server-managed-settings#platform-availability) требует прямого подключения к `api.anthropic.com`, поэтому она не достигает сеансов, маршрутизируемых через шлюз. Развертывания шлюза используют этот путь управляемых параметров на основе файлов, который применяет те же ключи.

212 212 

213Для учетных данных распределите одну команду [`apiKeyHelper`](/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) в файле управляемых параметров, как показано выше; команда аутентифицируется в вашем хранилище секретов как локальный разработчик, поэтому каждая машина получает свой собственный ключ. Альтернативно, доставляйте каждому разработчику его ключ через ваш существующий процесс секретов и попросите их установить `ANTHROPIC_AUTH_TOKEN` самостоятельно.213Для учетных данных распределите одну команду [`apiKeyHelper`](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) в файле управляемых параметров, как показано выше; команда аутентифицируется в вашем хранилище секретов как локальный разработчик, поэтому каждая машина получает свой собственный ключ. Альтернативно, доставляйте каждому разработчику его ключ через ваш существующий процесс секретов и попросите их установить `ANTHROPIC_AUTH_TOKEN` самостоятельно.

214 214 

215Некоторые окружения требуют отдельной доставки:215Некоторые окружения требуют отдельной доставки:

216 216 

217* Настольное приложение читает маршрутизацию шлюза только из своей конфигурации вывода третьей стороны, доставляемой MDM; разверните этот файл вместе с управляемыми параметрами, чтобы сеансы рабочего стола также маршрутизировались через шлюз. См. [документацию конфигурации рабочего стола](https://claude.com/docs/third-party/claude-desktop/configuration) и [документацию шлюза рабочего стола](https://claude.com/docs/third-party/claude-desktop/gateway)217* Настольное приложение читает маршрутизацию шлюза только из своей конфигурации вывода третьей стороны, доставляемой MDM; разверните этот файл вместе с управляемыми параметрами, чтобы сеансы рабочего стола также маршрутизировались через шлюз. См. [документацию конфигурации рабочего стола](https://claude.com/docs/third-party/claude-desktop/configuration) и [документацию шлюза рабочего стола](https://claude.com/docs/third-party/claude-desktop/gateway)

218* Бегуны CI нуждаются в `ANTHROPIC_BASE_URL` и учетных данных, установленных в [окружении бегуна](/ru/llm-gateway-connect#configure-each-surface)218* Бегуны CI нуждаются в `ANTHROPIC_BASE_URL` и учетных данных, установленных в [окружении бегуна](/docs/ru/llm-gateway-connect#configure-each-surface)

219* WSL на управляемых машинах Windows читает управляемые параметры Windows только когда [`wslInheritsWindowsSettings`](/ru/settings#available-settings) имеет значение `true`219* WSL на управляемых машинах Windows читает управляемые параметры Windows только когда [`wslInheritsWindowsSettings`](/docs/ru/settings#available-settings) имеет значение `true`

220 220 

221<h4 id="hand-developers-the-values-to-set-themselves">221<h4 id="hand-developers-the-values-to-set-themselves">

222 Передать разработчикам значения для самостоятельной установки222 Передать разработчикам значения для самостоятельной установки

223</h4>223</h4>

224 224 

225Если у вас нет распределения управляемых параметров, отправьте каждому разработчику то, что ему нужно, чтобы следовать [странице подключения](/ru/llm-gateway-connect#configure-claude-code-yourself):225Если у вас нет распределения управляемых параметров, отправьте каждому разработчику то, что ему нужно, чтобы следовать [странице подключения](/docs/ru/llm-gateway-connect#configure-claude-code-yourself):

226 226 

227* URL шлюза227* URL шлюза

228* Их личные учетные данные228* Их личные учетные данные

229* **Какую переменную поместить учетные данные в**: `ANTHROPIC_AUTH_TOKEN` для шлюза с токеном-носителем или `ANTHROPIC_API_KEY` для шлюза `x-api-key`. Сообщение разработчикам, какой из них, экономит им метод проб и ошибок, описанный на [странице подключения](/ru/llm-gateway-connect#set-the-credential-variable)229* **Какую переменную поместить учетные данные в**: `ANTHROPIC_AUTH_TOKEN` для шлюза с токеном-носителем или `ANTHROPIC_API_KEY` для шлюза `x-api-key`. Сообщение разработчикам, какой из них, экономит им метод проб и ошибок, описанный на [странице подключения](/docs/ru/llm-gateway-connect#set-the-credential-variable)

230* Любые условные переменные из [таблицы Что распределять](#what-to-distribute), с их значениями230* Любые условные переменные из [таблицы Что распределять](#what-to-distribute), с их значениями

231 231 

232[Страница подключения](/ru/llm-gateway-connect#configure-claude-code-yourself) проводит разработчиков через установку каждой.232[Страница подключения](/docs/ru/llm-gateway-connect#configure-claude-code-yourself) проводит разработчиков через установку каждой.

233 233 

234**Контрольная точка**: на машине разработчика `claude` запускает сеанс без отображения экрана входа, так как распределенные учетные данные удовлетворяют аутентификацию. Затем запустите `/status` и откройте вкладку **Status**: строка `Anthropic base URL` показывает адрес шлюза, а для управляемого распределения строка `Setting sources` включает управляемые параметры. Экран входа или отсутствующая строка `Anthropic base URL` означает, что конфигурация не достигла машины.234**Контрольная точка**: на машине разработчика `claude` запускает сеанс без отображения экрана входа, так как распределенные учетные данные удовлетворяют аутентификацию. Затем запустите `/status` и откройте вкладку **Status**: строка `Anthropic base URL` показывает адрес шлюза, а для управляемого распределения строка `Setting sources` включает управляемые параметры. Экран входа или отсутствующая строка `Anthropic base URL` означает, что конфигурация не достигла машины.

235 235 


270* Ошибки `Failed to authenticate` означают, что шлюз отклоняет запросы; его журнал говорит, какие учетные данные не прошли. Отклонение, которое сам журнал шлюза регистрирует, называет ключ разработчика, в то время как `401` от `api.anthropic.com` или конечной точки вашего поставщика означает, что учетные данные поставщика, которые держит шлюз, были отклонены270* Ошибки `Failed to authenticate` означают, что шлюз отклоняет запросы; его журнал говорит, какие учетные данные не прошли. Отклонение, которое сам журнал шлюза регистрирует, называет ключ разработчика, в то время как `401` от `api.anthropic.com` или конечной точки вашего поставщика означает, что учетные данные поставщика, которые держит шлюз, были отклонены

271* Одноразовое приглашение одобрения для ключа ожидается при первом использовании, когда шлюз ожидает ключи в заголовке `x-api-key`, установленном как `ANTHROPIC_API_KEY`. С `ANTHROPIC_AUTH_TOKEN` никакое приглашение не появляется и переменная берет на себя молча; ранее сохраненный вход claude.ai неактивен для этого сеанса271* Одноразовое приглашение одобрения для ключа ожидается при первом использовании, когда шлюз ожидает ключи в заголовке `x-api-key`, установленном как `ANTHROPIC_API_KEY`. С `ANTHROPIC_AUTH_TOKEN` никакое приглашение не появляется и переменная берет на себя молча; ранее сохраненный вход claude.ai неактивен для этого сеанса

272 272 

273Наконец, проверьте журналы шлюза на предмет отправленного вами сообщения: учетные данные идентифицируют разработчика, и [заголовок `x-claude-code-session-id`](/ru/llm-gateway-protocol#request-headers) группирует запросы по сеансам. Если функции не работают с [симптомами устранения неполадок](/ru/llm-gateway-connect#troubleshoot-gateway-errors), шлюз удаляет заголовки или переписывает ошибки; см. [требования к шлюзу](#gateway-requirements) выше.273Наконец, проверьте журналы шлюза на предмет отправленного вами сообщения: учетные данные идентифицируют разработчика, и [заголовок `x-claude-code-session-id`](/docs/ru/llm-gateway-protocol#request-headers) группирует запросы по сеансам. Если функции не работают с [симптомами устранения неполадок](/docs/ru/llm-gateway-connect#troubleshoot-gateway-errors), шлюз удаляет заголовки или переписывает ошибки; см. [требования к шлюзу](#gateway-requirements) выше.

274 274 

275<h2 id="maintain-the-gateway">275<h2 id="maintain-the-gateway">

276 Поддерживать шлюз276 Поддерживать шлюз


280 280 

281| Изменение | Симптом, когда шлюз не в курсе | Действие |281| Изменение | Симптом, когда шлюз не в курсе | Действие |

282| :-------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |282| :-------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

283| Новые выпуски Claude Code добавляют значения `anthropic-beta` и поля тела запроса | Разработчики сообщают об ошибках `400`, называющих новое поле после обновления Claude Code; см. [сквозная передача функций](/ru/llm-gateway-protocol#feature-pass-through) | Перенаправляйте заголовки `anthropic-*` и тела запроса дословно вместо внесения в список разрешений; протестируйте новые выпуски Claude Code против шлюза перед тем, как они достигнут разработчиков |283| Новые выпуски Claude Code добавляют значения `anthropic-beta` и поля тела запроса | Разработчики сообщают об ошибках `400`, называющих новое поле после обновления Claude Code; см. [сквозная передача функций](/docs/ru/llm-gateway-protocol#feature-pass-through) | Перенаправляйте заголовки `anthropic-*` и тела запроса дословно вместо внесения в список разрешений; протестируйте новые выпуски Claude Code против шлюза перед тем, как они достигнут разработчиков |

284| Становятся доступны новые модели Claude | Разработчики, выбирающие новое имя модели, получают `404`; средство выбора `/model` его не перечисляет | Добавьте имя модели в конфигурацию маршрутизации шлюза, затем повторно запустите [проверку маршрутизации](#confirm-the-gateway-routes-your-models). Если вы распределяете `ANTHROPIC_MODEL` или переменные модели по умолчанию, обновите управляемые параметры |284| Становятся доступны новые модели Claude | Разработчики, выбирающие новое имя модели, получают `404`; средство выбора `/model` его не перечисляет | Добавьте имя модели в конфигурацию маршрутизации шлюза, затем повторно запустите [проверку маршрутизации](#confirm-the-gateway-routes-your-models). Если вы распределяете `ANTHROPIC_MODEL` или переменные модели по умолчанию, обновите управляемые параметры |

285| Учетные данные истекают или требуют ротации | Все запросы разработчика начинают не работать с `401` от восходящего потока | Ротируйте учетные данные поставщика шлюза по его собственному расписанию; ключи разработчика ротируются на шлюзе, и [`apiKeyHelper`](/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) обрабатывает ротацию для каждого разработчика без перераспределения параметров |285| Учетные данные истекают или требуют ротации | Все запросы разработчика начинают не работать с `401` от восходящего потока | Ротируйте учетные данные поставщика шлюза по его собственному расписанию; ключи разработчика ротируются на шлюзе, и [`apiKeyHelper`](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) обрабатывает ротацию для каждого разработчика без перераспределения параметров |

286 286 

287При определении размера ограничений скорости для каждого ключа учитывайте [повторные попытки клиента при переходящих сбоях](/ru/errors#automatic-retries), включая ответы `429`, до 10 раз с отступом, соблюдая `Retry-After`. Держите [справочник протокола](/ru/llm-gateway-protocol) как контракт для того, что отправляет каждый выпуск Claude Code.287При определении размера ограничений скорости для каждого ключа учитывайте [повторные попытки клиента при переходящих сбоях](/docs/ru/errors#automatic-retries), включая ответы `429`, до 10 раз с отступом, соблюдая `Retry-After`. Держите [справочник протокола](/docs/ru/llm-gateway-protocol) как контракт для того, что отправляет каждый выпуск Claude Code.

288 288 

289<h2 id="related-resources">289<h2 id="related-resources">

290 Связанные ресурсы290 Связанные ресурсы

291</h2>291</h2>

292 292 

293* [Подключение Claude Code к LLM-шлюзу](/ru/llm-gateway-connect): шаги настройки для разработчиков, с конфигурацией для каждой поверхности и таблицей устранения неполадок, которую вы можете передать разработчикам293* [Подключение Claude Code к LLM-шлюзу](/docs/ru/llm-gateway-connect): шаги настройки для разработчиков, с конфигурацией для каждой поверхности и таблицей устранения неполадок, которую вы можете передать разработчикам

294* [Справочник протокола шлюза](/ru/llm-gateway-protocol): проводной контракт для операторов шлюза, охватывающий конечные точки, заголовки для перенаправления и таблицу сквозной передачи функций294* [Справочник протокола шлюза](/docs/ru/llm-gateway-protocol): проводной контракт для операторов шлюза, охватывающий конечные точки, заголовки для перенаправления и таблицу сквозной передачи функций

295* [Файлы параметров и приоритет](/ru/settings#settings-files): как управляемые, проектные и пользовательские параметры объединяются и где находится управляемый файл на каждой платформе295* [Файлы параметров и приоритет](/docs/ru/settings#settings-files): как управляемые, проектные и пользовательские параметры объединяются и где находится управляемый файл на каждой платформе

296* [Настройка Claude Code для вашей организации](/ru/admin-setup): более широкое развертывание, частью которого является этот шлюз, включая применение политики, видимость использования и обработку данных296* [Настройка Claude Code для вашей организации](/docs/ru/admin-setup): более широкое развертывание, частью которого является этот шлюз, включая применение политики, видимость использования и обработку данных

managed-mcp.md +24 −24

Details

6 6 

7> Ограничьте, какие серверы MCP пользователи могут добавлять или подключать, используя управляемые файлы конфигурации, списки разрешений и списки запретов.7> Ограничьте, какие серверы MCP пользователи могут добавлять или подключать, используя управляемые файлы конфигурации, списки разрешений и списки запретов.

8 8 

9По умолчанию любой, кто запускает Claude Code, может подключить любой [MCP сервер](/ru/mcp) по своему выбору. Anthropic проверяет соединители в соответствии с [критериями листинга](https://claude.com/docs/connectors/building/review-criteria) перед добавлением их в [Anthropic Directory](https://claude.ai/directory), но не проводит проверку безопасности и не управляет какими-либо MCP серверами. Как администратор, вы можете ограничить, какие серверы работают в вашей организации, от развертывания фиксированного одобренного набора до полного отключения MCP.9По умолчанию любой, кто запускает Claude Code, может подключить любой [MCP сервер](/docs/ru/mcp) по своему выбору. Anthropic проверяет соединители в соответствии с [критериями листинга](https://claude.com/docs/connectors/building/review-criteria) перед добавлением их в [Anthropic Directory](https://claude.ai/directory), но не проводит проверку безопасности и не управляет какими-либо MCP серверами. Как администратор, вы можете ограничить, какие серверы работают в вашей организации, от развертывания фиксированного одобренного набора до полного отключения MCP.

10 10 

11На этой странице рассматривается, как:11На этой странице рассматривается, как:

12 12 


17* [Отслеживать, какие серверы фактически использует ваша организация](#monitor-mcp-usage)17* [Отслеживать, какие серверы фактически использует ваша организация](#monitor-mcp-usage)

18 18 

19<Note>19<Note>

20 На странице [Security](/ru/security) рассматривается модель угроз MCP и способы оценки сервера перед его одобрением. [Decide what to enforce](/ru/admin-setup#decide-what-to-enforce) охватывает ограничения MCP наряду с другими административными элементами управления.20 На странице [Security](/docs/ru/security) рассматривается модель угроз MCP и способы оценки сервера перед его одобрением. [Decide what to enforce](/docs/ru/admin-setup#decide-what-to-enforce) охватывает ограничения MCP наряду с другими административными элементами управления.

21</Note>21</Note>

22 22 

23<h2 id="choose-a-pattern">23<h2 id="choose-a-pattern">


31| **Отключить MCP** | Серверы не загружаются нигде | `managed-mcp.json` с пустой картой серверов |31| **Отключить MCP** | Серверы не загружаются нигде | `managed-mcp.json` с пустой картой серверов |

32| **Фиксированное развертывание** | Каждый пользователь получает одни и те же серверы и не может добавлять другие | `managed-mcp.json` с нужными вам серверами |32| **Фиксированное развертывание** | Каждый пользователь получает одни и те же серверы и не может добавлять другие | `managed-mcp.json` с нужными вам серверами |

33| **Одобренный каталог** | Опубликуйте список одобренных серверов; пользователи добавляют нужные им, все остальное блокируется | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |33| **Одобренный каталог** | Опубликуйте список одобренных серверов; пользователи добавляют нужные им, все остальное блокируется | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |

34| **Только серверы плагинов** | Серверы могут поступать только из плагинов; пользователи не могут добавлять свои собственные | [`strictPluginOnlyCustomization`](/ru/settings#strictpluginonlycustomization) с `mcp` в списке |34| **Только серверы плагинов** | Серверы могут поступать только из плагинов; пользователи не могут добавлять свои собственные | [`strictPluginOnlyCustomization`](/docs/ru/settings#strictpluginonlycustomization) с `mcp` в списке |

35| **Мягкий список разрешений** | Применить список разрешений, который пользователи могут расширить в своих собственных настройках | `allowedMcpServers` без `allowManagedMcpServersOnly` |35| **Мягкий список разрешений** | Применить список разрешений, который пользователи могут расширить в своих собственных настройках | `allowedMcpServers` без `allowManagedMcpServersOnly` |

36| **Только список запретов** | Заблокируйте известные плохие серверы, разрешите все остальное | `deniedMcpServers` |36| **Только список запретов** | Заблокируйте известные плохие серверы, разрешите все остальное | `deniedMcpServers` |

37| **Без ограничений** | Пользователи добавляют что угодно | Не развертывайте никакую управляемую конфигурацию MCP |37| **Без ограничений** | Пользователи добавляют что угодно | Не развертывайте никакую управляемую конфигурацию MCP |

38 38 

39<Note>39<Note>

40 Claude Code не имеет встроенного реестра MCP серверов, который пользователи могут просматривать и устанавливать. Для шаблона одобренного каталога поделитесь списком одобренных серверов и его командами `claude mcp add` в месте, где его найдут ваши пользователи, например во внутренней вики, или распределите серверы как плагины через [управляемый рынок плагинов](/ru/plugin-marketplaces#managed-marketplace-restrictions), чтобы пользователи могли просматривать и устанавливать их из `/plugin`.40 Claude Code не имеет встроенного реестра MCP серверов, который пользователи могут просматривать и устанавливать. Для шаблона одобренного каталога поделитесь списком одобренных серверов и его командами `claude mcp add` в месте, где его найдут ваши пользователи, например во внутренней вики, или распределите серверы как плагины через [управляемый рынок плагинов](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions), чтобы пользователи могли просматривать и устанавливать их из `/plugin`.

41</Note>41</Note>

42 42 

43<h2 id="exclusive-control-with-managed-mcp-json">43<h2 id="exclusive-control-with-managed-mcp-json">


53 53 

54Полный порядок проверок см. в разделе [How a server is evaluated](#how-a-server-is-evaluated).54Полный порядок проверок см. в разделе [How a server is evaluated](#how-a-server-is-evaluated).

55 55 

56`managed-mcp.json` — это отдельный файл, поэтому он не может быть доставлен через [server-managed settings](/ru/server-managed-settings). Любой процесс, который может писать в системный путь с правами администратора, может развернуть его. В масштабе это обычно происходит через инструменты управления устройствами, такие как Jamf или профиль конфигурации на macOS, Group Policy или Intune на Windows, или выбранное вами управление флотом на Linux. Claude Code ищет файл по одному из этих путей:56`managed-mcp.json` — это отдельный файл, поэтому он не может быть доставлен через [server-managed settings](/docs/ru/server-managed-settings). Любой процесс, который может писать в системный путь с правами администратора, может развернуть его. В масштабе это обычно происходит через инструменты управления устройствами, такие как Jamf или профиль конфигурации на macOS, Group Policy или Intune на Windows, или выбранное вами управление флотом на Linux. Claude Code ищет файл по одному из этих путей:

57 57 

58| Платформа | Путь |58| Платформа | Путь |

59| :---------- | :--------------------------------------------------------- |59| :---------- | :--------------------------------------------------------- |


61| Linux и WSL | `/etc/claude-code/managed-mcp.json` |61| Linux и WSL | `/etc/claude-code/managed-mcp.json` |

62| Windows | `C:\Program Files\ClaudeCode\managed-mcp.json` |62| Windows | `C:\Program Files\ClaudeCode\managed-mcp.json` |

63 63 

64Файл использует тот же формат, что и файл проекта [`.mcp.json`](/ru/mcp#project-scope):64Файл использует тот же формат, что и файл проекта [`.mcp.json`](/docs/ru/mcp#project-scope):

65 65 

66```json theme={null}66```json theme={null}

67{67{


92 92 

93Любой пользователь на машине может прочитать этот файл, поэтому не сохраняйте ключи API или другие учетные данные в блоках `env`. Передавайте учетные данные для каждого пользователя одним из следующих способов:93Любой пользователь на машине может прочитать этот файл, поэтому не сохраняйте ключи API или другие учетные данные в блоках `env`. Передавайте учетные данные для каждого пользователя одним из следующих способов:

94 94 

95* [`${VAR}` расширение](/ru/mcp#environment-variable-expansion-in-mcp-json) для чтения секретов из окружения каждого пользователя.95* [`${VAR}` расширение](/docs/ru/mcp#environment-variable-expansion-in-mcp-json) для чтения секретов из окружения каждого пользователя.

96* [OAuth или заголовки для каждого пользователя](/ru/mcp#authenticate-with-remote-mcp-servers), чтобы каждый пользователь аутентифицировался как сам себя.96* [OAuth или заголовки для каждого пользователя](/docs/ru/mcp#authenticate-with-remote-mcp-servers), чтобы каждый пользователь аутентифицировался как сам себя.

97* [`headersHelper`](/ru/mcp#use-dynamic-headers-for-custom-authentication) для создания учетных данных во время подключения.97* [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication) для создания учетных данных во время подключения.

98 98 

99<h3 id="validate-the-configuration">99<h3 id="validate-the-configuration">

100 Проверка конфигурации100 Проверка конфигурации


123 Разрешить соединители claude.ai наряду с управляемым набором123 Разрешить соединители claude.ai наряду с управляемым набором

124</h3>124</h3>

125 125 

126Развертывание `managed-mcp.json` подавляет [соединители claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) по умолчанию, включая соединители, которые администратор настроил для организации в консоли администратора claude.ai. Чтобы загружать эти соединители наряду с серверами в `managed-mcp.json`, установите `"allowAllClaudeAiMcps": true` в [источнике управляемых настроек](/ru/admin-setup#decide-how-settings-reach-devices). Требуется Claude Code версии 2.1.149 или позже.126Развертывание `managed-mcp.json` подавляет [соединители claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) по умолчанию, включая соединители, которые администратор настроил для организации в консоли администратора claude.ai. Чтобы загружать эти соединители наряду с серверами в `managed-mcp.json`, установите `"allowAllClaudeAiMcps": true` в [источнике управляемых настроек](/docs/ru/admin-setup#decide-how-settings-reach-devices). Требуется Claude Code версии 2.1.149 или позже.

127 127 

128Когда параметр включен, Claude Code загружает те же соединители claude.ai, которые он загружал бы, если бы `managed-mcp.json` не был развернут. [Списки разрешений и запретов](#policy-based-control-with-allowlists-and-denylists) по-прежнему применяются к этим соединителям, поэтому вы можете заблокировать конкретные с помощью `deniedMcpServers`. Параметр влияет только на соединители claude.ai; серверы, предоставляемые плагинами, остаются подавленными.128Когда параметр включен, Claude Code загружает те же соединители claude.ai, которые он загружал бы, если бы `managed-mcp.json` не был развернут. [Списки разрешений и запретов](#policy-based-control-with-allowlists-and-denylists) по-прежнему применяются к этим соединителям, поэтому вы можете заблокировать конкретные с помощью `deniedMcpServers`. Параметр влияет только на соединители claude.ai; серверы, предоставляемые плагинами, остаются подавленными.

129 129 


133 Контроль на основе политики со списками разрешений и запретов133 Контроль на основе политики со списками разрешений и запретов

134</h2>134</h2>

135 135 

136Списки разрешений и запретов фильтруют, какие настроенные серверы разрешены для загрузки. Это не реестр: сервер все еще должен быть добавлен пользователем, плагином или `managed-mcp.json` перед тем, как список разрешений или запретов применится к нему. Чтобы развернуть серверы для пользователей, используйте [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json). Оба списка также фильтруют серверы, переданные с флагом CLI [`--mcp-config`](/ru/cli-reference#cli-flags); `--strict-mcp-config` ограничивает, какие файлы конфигурации загружаются, и не обходит ни один из списков.136Списки разрешений и запретов фильтруют, какие настроенные серверы разрешены для загрузки. Это не реестр: сервер все еще должен быть добавлен пользователем, плагином или `managed-mcp.json` перед тем, как список разрешений или запретов применится к нему. Чтобы развернуть серверы для пользователей, используйте [`managed-mcp.json`](#exclusive-control-with-managed-mcp-json). Оба списка также фильтруют серверы, переданные с флагом CLI [`--mcp-config`](/docs/ru/cli-reference#cli-flags); `--strict-mcp-config` ограничивает, какие файлы конфигурации загружаются, и не обходит ни один из списков.

137 137 

138Чтобы сделать список разрешений авторитетным, установите `allowedMcpServers` и `allowManagedMcpServersOnly: true` вместе в [источник управляемых настроек](/ru/admin-setup#decide-how-settings-reach-devices), такой как server-managed settings или развернутый файл `managed-settings.json`. [Ограничение списка разрешений только управляемыми настройками](#restrict-the-allowlist-to-managed-settings-only) показывает конфигурацию. Без `allowManagedMcpServersOnly` списки разрешений из каждого источника настроек объединяются, включая собственный `~/.claude/settings.json` пользователя, поэтому пользователь может расширить то, что разрешает ваш список разрешений. Списки запретов объединяются из каждого источника независимо.138Чтобы сделать список разрешений авторитетным, установите `allowedMcpServers` и `allowManagedMcpServersOnly: true` вместе в [источник управляемых настроек](/docs/ru/admin-setup#decide-how-settings-reach-devices), такой как server-managed settings или развернутый файл `managed-settings.json`. [Ограничение списка разрешений только управляемыми настройками](#restrict-the-allowlist-to-managed-settings-only) показывает конфигурацию. Без `allowManagedMcpServersOnly` списки разрешений из каждого источника настроек объединяются, включая собственный `~/.claude/settings.json` пользователя, поэтому пользователь может расширить то, что разрешает ваш список разрешений. Списки запретов объединяются из каждого источника независимо.

139 139 

140<Note>140<Note>

141 `allowManagedMcpServersOnly` отличается от `allowManagedPermissionRulesOnly`, который блокирует только [правила разрешений](/ru/permissions#managed-settings). Установка этого флага не применяет список разрешений MCP.141 `allowManagedMcpServersOnly` отличается от `allowManagedPermissionRulesOnly`, который блокирует только [правила разрешений](/docs/ru/permissions#managed-settings). Установка этого флага не применяет список разрешений MCP.

142</Note>142</Note>

143 143 

144<h3 id="match-servers-by-url-command-or-name">144<h3 id="match-servers-by-url-command-or-name">


160| `allowedMcpServers` | Все серверы разрешены | Серверы не разрешены | Разрешены только совпадающие серверы |160| `allowedMcpServers` | Все серверы разрешены | Серверы не разрешены | Разрешены только совпадающие серверы |

161| `deniedMcpServers` | Серверы не блокируются | Серверы не блокируются | Совпадающие серверы блокируются |161| `deniedMcpServers` | Серверы не блокируются | Серверы не блокируются | Совпадающие серверы блокируются |

162 162 

163См. [Недействительные записи в управляемых настройках](/ru/settings#invalid-entries-in-managed-settings) для информации о том, что происходит, когда запись не проходит валидацию схемы.163См. [Недействительные записи в управляемых настройках](/docs/ru/settings#invalid-entries-in-managed-settings) для информации о том, что происходит, когда запись не проходит валидацию схемы.

164 164 

165<Warning>165<Warning>

166 Запись `serverName`, в любом списке, не является элементом управления безопасностью. Имя — это метка, которую пользователь назначает при запуске `claude mcp add` или редактировании файла конфигурации, а не базовый сервер, поэтому пользователь может назвать любой сервер `github`. Для соединителей claude.ai имя — это отображаемое имя, возвращаемое claude.ai, которое может измениться. Чтобы применить, какие серверы фактически работают, добавьте записи `serverCommand` или `serverUrl`.166 Запись `serverName`, в любом списке, не является элементом управления безопасностью. Имя — это метка, которую пользователь назначает при запуске `claude mcp add` или редактировании файла конфигурации, а не базовый сервер, поэтому пользователь может назвать любой сервер `github`. Для соединителей claude.ai имя — это отображаемое имя, возвращаемое claude.ai, которое может измениться. Чтобы применить, какие серверы фактически работают, добавьте записи `serverCommand` или `serverUrl`.


168 168 

169Валидация `serverName` отличается между двумя списками:169Валидация `serverName` отличается между двумя списками:

170 170 

171* {/* min-version: 2.1.182 */}В `deniedMcpServers`, `serverName` принимает любую непустую строку, поэтому вы можете блокировать [соединители claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) по их отображаемому имени. Например, `{ "serverName": "claude.ai Slack" }` блокирует соединитель Slack. Предпочитайте запись `serverUrl`, когда вам нужно, чтобы запрет был устойчив к переименованиям, или когда имя соединителя конфликтует и получает суффикс ` (N)`.171* В `deniedMcpServers`, `serverName` принимает любую непустую строку, поэтому вы можете блокировать [соединители claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) по их отображаемому имени. Например, `{ "serverName": "claude.ai Slack" }` блокирует соединитель Slack. Предпочитайте запись `serverUrl`, когда вам нужно, чтобы запрет был устойчив к переименованиям, или когда имя соединителя конфликтует и получает суффикс ` (N)`.

172* В `allowedMcpServers`, `serverName` ограничен буквами, цифрами, дефисами и подчеркиваниями. Используйте `serverUrl` для добавления в список разрешений соединителя claude.ai.172* В `allowedMcpServers`, `serverName` ограничен буквами, цифрами, дефисами и подчеркиваниями. Используйте `serverUrl` для добавления в список разрешений соединителя claude.ai.

173 173 

174Чтобы отключить все соединители claude.ai, см. [`disableClaudeAiConnectors`](/ru/mcp#disable-claude-ai-connectors).174Чтобы отключить все соединители claude.ai, см. [`disableClaudeAiConnectors`](/docs/ru/mcp#disable-claude-ai-connectors).

175 175 

176<h3 id="how-a-server-is-evaluated">176<h3 id="how-a-server-is-evaluated">

177 Как оценивается сервер177 Как оценивается сервер


191Три правила сопоставления применяются внутри этих проверок:191Три правила сопоставления применяются внутри этих проверок:

192 192 

193* **Команды совпадают точно.** Каждый аргумент по порядку. `["npx", "-y", "server"]` не совпадает с `["npx", "server"]` или `["npx", "-y", "server", "--flag"]`.193* **Команды совпадают точно.** Каждый аргумент по порядку. `["npx", "-y", "server"]` не совпадает с `["npx", "server"]` или `["npx", "-y", "server", "--flag"]`.

194* **`serverCommand` и `serverUrl` значения расширяются перед сопоставлением.** Как запись политики, так и настроенное значение сервера проходят через то же расширение [`${VAR}` и `${VAR:-default}`](/ru/mcp#environment-variable-expansion-in-mcp-json), что и `.mcp.json`, поэтому запись, написанная как `["${HOME}/bin/server"]`, совпадает с конфигурацией сервера, которая использует либо ту же ссылку, либо расширенный путь. На Windows ссылайтесь на переменную окружения, которая установлена там, такую как `${USERPROFILE}` вместо `${HOME}`. `serverName` значения совпадают буквально и никогда не расширяются.194* **`serverCommand` и `serverUrl` значения расширяются перед сопоставлением.** Как запись политики, так и настроенное значение сервера проходят через то же расширение [`${VAR}` и `${VAR:-default}`](/docs/ru/mcp#environment-variable-expansion-in-mcp-json), что и `.mcp.json`, поэтому запись, написанная как `["${HOME}/bin/server"]`, совпадает с конфигурацией сервера, которая использует либо ту же ссылку, либо расширенный путь. На Windows ссылайтесь на переменную окружения, которая установлена там, такую как `${USERPROFILE}` вместо `${HOME}`. `serverName` значения совпадают буквально и никогда не расширяются.

195* **URL поддерживают подстановочные знаки `*`** в любом месте шаблона, включая схему. Сопоставление имени хоста не учитывает регистр и игнорирует конечную точку FQDN, поэтому `https://Mcp.Example.com/*` совпадает с `https://mcp.example.com/api`. Пути остаются чувствительными к регистру.195* **URL поддерживают подстановочные знаки `*`** в любом месте шаблона, включая схему. Сопоставление имени хоста не учитывает регистр и игнорирует конечную точку FQDN, поэтому `https://Mcp.Example.com/*` совпадает с `https://mcp.example.com/api`. Пути остаются чувствительными к регистру.

196 196 

197| Шаблон | Разрешает |197| Шаблон | Разрешает |


363 Мониторинг использования MCP363 Мониторинг использования MCP

364</h2>364</h2>

365 365 

366Когда [OpenTelemetry export](/ru/monitoring-usage) настроен, Claude Code может записывать, какие MCP серверы и инструменты вызывают пользователи. Установите `OTEL_LOG_TOOL_DETAILS=1`, чтобы включить имена MCP серверов и инструментов в события инструментов, затем агрегируйте их в вашем сборщике, чтобы увидеть, какие серверы фактически подключают ваши пользователи. См. [Monitoring](/ru/monitoring-usage) для настройки экспортера и полной схемы событий.366Когда [OpenTelemetry export](/docs/ru/monitoring-usage) настроен, Claude Code может записывать, какие MCP серверы и инструменты вызывают пользователи. Установите `OTEL_LOG_TOOL_DETAILS=1`, чтобы включить имена MCP серверов и инструментов в события инструментов, затем агрегируйте их в вашем сборщике, чтобы увидеть, какие серверы фактически подключают ваши пользователи. См. [Monitoring](/docs/ru/monitoring-usage) для настройки экспортера и полной схемы событий.

367 367 

368<h2 id="configuration-summary">368<h2 id="configuration-summary">

369 Сводка конфигурации369 Сводка конфигурации


374| Поверхность | Что она контролирует | Где она находится | Как доставить |374| Поверхность | Что она контролирует | Где она находится | Как доставить |

375| :--------------------------- | :------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |375| :--------------------------- | :------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

376| `managed-mcp.json` | Фиксированный набор серверов, исключительный контроль | Системный путь: `/Library/Application Support/ClaudeCode/`, `/etc/claude-code/` или `C:\Program Files\ClaudeCode\` | MDM, GPO, управление флотом или любой процесс с правами администратора. Не может быть установлен через server-managed settings |376| `managed-mcp.json` | Фиксированный набор серверов, исключительный контроль | Системный путь: `/Library/Application Support/ClaudeCode/`, `/etc/claude-code/` или `C:\Program Files\ClaudeCode\` | MDM, GPO, управление флотом или любой процесс с правами администратора. Не может быть установлен через server-managed settings |

377| `allowedMcpServers` | Список разрешений разрешенных серверов | Любой [файл настроек](/ru/settings#settings-files); записи из каждого источника объединяются, если не установлен `allowManagedMcpServersOnly` | Для применения, [источник управляемых настроек](/ru/admin-setup#decide-how-settings-reach-devices): server-managed settings, `managed-settings.json`, профиль MDM или реестр |377| `allowedMcpServers` | Список разрешений разрешенных серверов | Любой [файл настроек](/docs/ru/settings#settings-files); записи из каждого источника объединяются, если не установлен `allowManagedMcpServersOnly` | Для применения, [источник управляемых настроек](/docs/ru/admin-setup#decide-how-settings-reach-devices): server-managed settings, `managed-settings.json`, профиль MDM или реестр |

378| `deniedMcpServers` | Список запретов заблокированных серверов | Любой файл настроек; записи из каждого источника объединяются | То же, что `allowedMcpServers` |378| `deniedMcpServers` | Список запретов заблокированных серверов | Любой файл настроек; записи из каждого источника объединяются | То же, что `allowedMcpServers` |

379| `allowManagedMcpServersOnly` | Блокирует список разрешений только управляемыми источниками | Только источники управляемых настроек; параметр не имеет эффекта в других местах | То же, что `allowedMcpServers` |379| `allowManagedMcpServersOnly` | Блокирует список разрешений только управляемыми источниками | Только источники управляемых настроек; параметр не имеет эффекта в других местах | То же, что `allowedMcpServers` |

380| `allowAllClaudeAiMcps` | Загружает соединители claude.ai наряду с `managed-mcp.json` вместо их подавления | Только источники управляемых настроек; параметр не имеет эффекта в других местах | То же, что `allowedMcpServers` |380| `allowAllClaudeAiMcps` | Загружает соединители claude.ai наряду с `managed-mcp.json` вместо их подавления | Только источники управляемых настроек; параметр не имеет эффекта в других местах | То же, что `allowedMcpServers` |


383 Связанные ресурсы383 Связанные ресурсы

384</h2>384</h2>

385 385 

386* [Decide what to enforce](/ru/admin-setup#decide-what-to-enforce): ограничения MCP наряду с правилами разрешений, песочницей и другими элементами управления администратора386* [Decide what to enforce](/docs/ru/admin-setup#decide-what-to-enforce): ограничения MCP наряду с правилами разрешений, песочницей и другими элементами управления администратора

387* [Connect Claude Code to tools via MCP](/ru/mcp): полная справка MCP, включая транспорты, области и аутентификацию387* [Connect Claude Code to tools via MCP](/docs/ru/mcp): полная справка MCP, включая транспорты, области и аутентификацию

388* [Settings](/ru/settings): иерархия настроек и способ приоритета управляемых настроек388* [Settings](/docs/ru/settings): иерархия настроек и способ приоритета управляемых настроек

389* [Server-managed settings](/ru/server-managed-settings): доставка `allowedMcpServers` и `deniedMcpServers` из консоли администратора Claude.ai389* [Server-managed settings](/docs/ru/server-managed-settings): доставка `allowedMcpServers` и `deniedMcpServers` из консоли администратора Claude.ai

390* [Security](/ru/security): модель угроз, которую защищают эти элементы управления390* [Security](/docs/ru/security): модель угроз, которую защищают эти элементы управления

391* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, управление местами и сценарий развертывания391* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO, SCIM, управление местами и сценарий развертывания

mcp.md +36 −36

Details

10 10 

11Подключите server, когда вы обнаружите, что копируете данные в чат из другого инструмента, например из трекера проблем или панели мониторинга. После подключения Claude может читать и действовать на этой системе напрямую вместо работы с тем, что вы вставляете.11Подключите server, когда вы обнаружите, что копируете данные в чат из другого инструмента, например из трекера проблем или панели мониторинга. После подключения Claude может читать и действовать на этой системе напрямую вместо работы с тем, что вы вставляете.

12 12 

13Если вы подключаете свой первый server, начните с [MCP quickstart](/ru/mcp-quickstart) для пошагового руководства. Эта страница является полным справочником.13Если вы подключаете свой первый server, начните с [MCP quickstart](/docs/ru/mcp-quickstart) для пошагового руководства. Эта страница является полным справочником.

14 14 

15<h2 id="what-you-can-do-with-mcp">15<h2 id="what-you-can-do-with-mcp">

16 Что вы можете делать с MCP16 Что вы можете делать с MCP


23* **Запрашивать базы данных**: "Найдите адреса электронной почты 10 случайных пользователей, которые использовали функцию ENG-4521, на основе нашей базы данных PostgreSQL."23* **Запрашивать базы данных**: "Найдите адреса электронной почты 10 случайных пользователей, которые использовали функцию ENG-4521, на основе нашей базы данных PostgreSQL."

24* **Интегрировать дизайны**: "Обновите наш стандартный шаблон электронного письма на основе новых дизайнов Figma, которые были опубликованы в Slack"24* **Интегрировать дизайны**: "Обновите наш стандартный шаблон электронного письма на основе новых дизайнов Figma, которые были опубликованы в Slack"

25* **Автоматизировать рабочие процессы**: "Создайте черновики Gmail, приглашающие этих 10 пользователей на сеанс обратной связи о новой функции."25* **Автоматизировать рабочие процессы**: "Создайте черновики Gmail, приглашающие этих 10 пользователей на сеанс обратной связи о новой функции."

26* **Реагировать на внешние события**: MCP server также может действовать как [канал](/ru/channels), который отправляет сообщения в вашу сессию, поэтому Claude реагирует на сообщения Telegram, чаты Discord или события webhook, пока вас нет.26* **Реагировать на внешние события**: MCP server также может действовать как [канал](/docs/ru/channels), который отправляет сообщения в вашу сессию, поэтому Claude реагирует на сообщения Telegram, чаты Discord или события webhook, пока вас нет.

27 27 

28<h2 id="find-and-build-mcp-servers">28<h2 id="find-and-build-mcp-servers">

29 Поиск и создание MCP servers29 Поиск и создание MCP servers


32Просмотрите проверенные коннекторы в [Anthropic Directory](https://claude.ai/directory). Коннекторы Directory используют ту же инфраструктуру MCP, что и Claude Code, поэтому вы можете добавить любой удаленный server из списка с помощью `claude mcp add`.32Просмотрите проверенные коннекторы в [Anthropic Directory](https://claude.ai/directory). Коннекторы Directory используют ту же инфраструктуру MCP, что и Claude Code, поэтому вы можете добавить любой удаленный server из списка с помощью `claude mcp add`.

33 33 

34<Warning>34<Warning>

35 Убедитесь, что вы доверяете каждому server перед подключением. Servers, которые получают внешний контент, могут подвергнуть вас [риску prompt injection](/ru/security#protect-against-prompt-injection).35 Убедитесь, что вы доверяете каждому server перед подключением. Servers, которые получают внешний контент, могут подвергнуть вас [риску prompt injection](/docs/ru/security#protect-against-prompt-injection).

36</Warning>36</Warning>

37 37 

38Чтобы создать свой собственный server, см. [руководство по MCP server](https://modelcontextprotocol.io/docs/develop/build-server) для основ протокола и [документацию по созданию Claude connector](https://claude.com/docs/connectors/building) для аутентификации, тестирования и отправки в Directory.38Чтобы создать свой собственный server, см. [руководство по MCP server](https://modelcontextprotocol.io/docs/develop/build-server) для основ протокола и [документацию по созданию Claude connector](https://claude.com/docs/connectors/building) для аутентификации, тестирования и отправки в Directory.


115 115 

116Claude Code устанавливает `CLAUDE_PROJECT_DIR` в окружение порожденного server в корень проекта, поэтому ваш server может разрешать пути относительно проекта без зависимости от рабочей директории. Это та же директория, которую hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Прочитайте ее изнутри вашего процесса server, например `process.env.CLAUDE_PROJECT_DIR` в Node или `os.environ["CLAUDE_PROJECT_DIR"]` в Python.116Claude Code устанавливает `CLAUDE_PROJECT_DIR` в окружение порожденного server в корень проекта, поэтому ваш server может разрешать пути относительно проекта без зависимости от рабочей директории. Это та же директория, которую hooks получают в своей переменной `CLAUDE_PROJECT_DIR`. Прочитайте ее изнутри вашего процесса server, например `process.env.CLAUDE_PROJECT_DIR` в Node или `os.environ["CLAUDE_PROJECT_DIR"]` в Python.

117 117 

118`CLAUDE_PROJECT_DIR` — это стабильный корень проекта и не изменяется при добавлении или удалении рабочих директорий во время сеанса. Server, который ограничивает собственный доступ к файловой системе набором разрешенных директорий, должен вместо этого реализовать MCP запрос `roots/list`. Claude Code отвечает на `roots/list` с директорией запуска сеанса плюс каждая [дополнительная рабочая директория](/ru/permissions#working-directories), которую вы предоставили с помощью `--add-dir`, `/add-dir` или параметра `additionalDirectories`. Claude Code отправляет `notifications/roots/list_changed` при изменении этого набора. До версии 2.1.203 `roots/list` возвращал только директорию запуска и Claude Code не отправлял `notifications/roots/list_changed`.118`CLAUDE_PROJECT_DIR` — это стабильный корень проекта и не изменяется при добавлении или удалении рабочих директорий во время сеанса. Server, который ограничивает собственный доступ к файловой системе набором разрешенных директорий, должен вместо этого реализовать MCP запрос `roots/list`. Claude Code отвечает на `roots/list` с директорией запуска сеанса плюс каждая [дополнительная рабочая директория](/docs/ru/permissions#working-directories), которую вы предоставили с помощью `--add-dir`, `/add-dir` или параметра `additionalDirectories`. Claude Code отправляет `notifications/roots/list_changed` при изменении этого набора. До версии 2.1.203 `roots/list` возвращал только директорию запуска и Claude Code не отправлял `notifications/roots/list_changed`.

119 119 

120Эта переменная устанавливается в окружение server, а не в собственное окружение Claude Code, поэтому ссылка на нее через расширение `${VAR}` в проекте или пользовательском `.mcp.json` `command` или `args` требует значения по умолчанию, такого как `${CLAUDE_PROJECT_DIR:-.}`. Конфигурации MCP, предоставляемые плагинами, подставляют `${CLAUDE_PROJECT_DIR}` напрямую и не требуют значения по умолчанию.120Эта переменная устанавливается в окружение server, а не в собственное окружение Claude Code, поэтому ссылка на нее через расширение `${VAR}` в проекте или пользовательском `.mcp.json` `command` или `args` требует значения по умолчанию, такого как `${CLAUDE_PROJECT_DIR:-.}`. Конфигурации MCP, предоставляемые плагинами, подставляют `${CLAUDE_PROJECT_DIR}` напрямую и не требуют значения по умолчанию.

121 121 


180 180 

181Servers с областью действия проекта из `.mcp.json`, которые ожидают вашего одобрения, отображаются в `claude mcp list` как `⏸ Pending approval`. Запустите `claude` интерактивно, чтобы просмотреть и одобрить их. `claude mcp get <name>` показывает ожидающие servers как `⏸ Pending approval` и отклоненные servers как `✗ Rejected`.181Servers с областью действия проекта из `.mcp.json`, которые ожидают вашего одобрения, отображаются в `claude mcp list` как `⏸ Pending approval`. Запустите `claude` интерактивно, чтобы просмотреть и одобрить их. `claude mcp get <name>` показывает ожидающие servers как `⏸ Pending approval` и отклоненные servers как `✗ Rejected`.

182 182 

183Начиная с версии 2.1.196, `claude mcp list` и `claude mcp get` читают одобрения `.mcp.json` только из файлов параметров, которые не проверены в репозитории, пока вы не доверите рабочей области, запустив `claude` в ней и приняв диалог доверия рабочей области. Клонированный репозиторий не может одобрить свои собственные servers: [`enableAllProjectMcpServers` или `enabledMcpjsonServers`](/ru/settings#available-settings), зафиксированные в `.claude/settings.json` проекта, игнорируются в недоверенной папке, и server остается в состоянии `⏸ Pending approval` вместо подключения и проверки здоровья.183Начиная с версии 2.1.196, `claude mcp list` и `claude mcp get` читают одобрения `.mcp.json` только из файлов параметров, которые не проверены в репозитории, пока вы не доверите рабочей области, запустив `claude` в ней и приняв диалог доверия рабочей области. Клонированный репозиторий не может одобрить свои собственные servers: [`enableAllProjectMcpServers` или `enabledMcpjsonServers`](/docs/ru/settings#available-settings), зафиксированные в `.claude/settings.json` проекта, игнорируются в недоверенной папке, и server остается в состоянии `⏸ Pending approval` вместо подключения и проверки здоровья.

184 184 

185Одобрения из этих источников все еще применяются в недоверенной папке:185Одобрения из этих источников все еще применяются в недоверенной папке:

186 186 


188* управляемые параметры188* управляемые параметры

189* параметры, переданные с помощью `--settings`189* параметры, переданные с помощью `--settings`

190 190 

191Одобрения в неотслеживаемом `.claude/settings.local.json` также применяются, но только после того, как вы примете диалог доверия для этой папки или одной из ее родительских директорий: Claude Code запускает git для проверки того, отслеживается ли файл, и выполняет эту проверку только в доверенной папке. В папке, которой вы никогда не доверяли, одобрения файла ждут диалога доверия, если только папка не является вашей конфигурационной домашней директорией: вашей домашней директорией или директорией, чей `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/ru/env-vars). До версии 2.1.207 неотслеживаемый `.claude/settings.local.json` одобрял servers в папке, которой вы никогда не доверяли.191Одобрения в неотслеживаемом `.claude/settings.local.json` также применяются, но только после того, как вы примете диалог доверия для этой папки или одной из ее родительских директорий: Claude Code запускает git для проверки того, отслеживается ли файл, и выполняет эту проверку только в доверенной папке. В папке, которой вы никогда не доверяли, одобрения файла ждут диалога доверия, если только папка не является вашей конфигурационной домашней директорией: вашей домашней директорией или директорией, чей `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars). До версии 2.1.207 неотслеживаемый `.claude/settings.local.json` одобрял servers в папке, которой вы никогда не доверяли.

192 192 

193Запись `disabledMcpjsonServers` в любом файле параметров все еще отклоняет server.193Запись `disabledMcpjsonServers` в любом файле параметров все еще отклоняет server.

194 194 

195Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.195Панель `/mcp` показывает количество инструментов рядом с каждым подключенным server и отмечает servers, которые объявляют возможность tools, но не предоставляют никаких инструментов.

196 196 

197Удаленный server, конфигурация которого имеет пустой `url`, отображается как `not configured` в `/mcp`, в `claude mcp list` и в [менеджере `/plugin`](/ru/plugins), и Claude Code не пытается подключиться к нему. Плагин может включать запись-заполнитель, подобную этой, для коннектора, который вы настроите позже, поэтому Claude Code не сообщает об этом как об ошибке или проблеме настройки. Представление деталей server в `/mcp` читает `No URL configured for this server`; установите `url` записи для подключения. До версии 2.1.208 Claude Code сообщал об пустом `url` как о проблеме конфигурации с подсказкой переподключиться.197Удаленный server, конфигурация которого имеет пустой `url`, отображается как `not configured` в `/mcp`, в `claude mcp list` и в [менеджере `/plugin`](/docs/ru/plugins), и Claude Code не пытается подключиться к нему. Плагин может включать запись-заполнитель, подобную этой, для коннектора, который вы настроите позже, поэтому Claude Code не сообщает об этом как об ошибке или проблеме настройки. Представление деталей server в `/mcp` читает `No URL configured for this server`; установите `url` записи для подключения. До версии 2.1.208 Claude Code сообщал об пустом `url` как о проблеме конфигурации с подсказкой переподключиться.

198 198 

199Если ваш запрос требует инструментов от server, который все еще подключается в фоновом режиме, Claude ждет подключения этого server перед продолжением. С включенным [поиском инструментов](#scale-with-mcp-tool-search), который используется по умолчанию, ожидание происходит внутри вызова `ToolSearch`. В конфигурациях без поиска инструментов, таких как Google Cloud's Agent Platform, пользовательский `ANTHROPIC_BASE_URL` или `ENABLE_TOOL_SEARCH=false`, Claude использует инструмент `WaitForMcpServers` вместо этого.199Если ваш запрос требует инструментов от server, который все еще подключается в фоновом режиме, Claude ждет подключения этого server перед продолжением. С включенным [поиском инструментов](#scale-with-mcp-tool-search), который используется по умолчанию, ожидание происходит внутри вызова `ToolSearch`. В конфигурациях без поиска инструментов, таких как Google Cloud's Agent Platform, пользовательский `ANTHROPIC_BASE_URL` или `ENABLE_TOOL_SEARCH=false`, Claude использует инструмент `WaitForMcpServers` вместо этого.

200 200 

201Некоторые имена servers зарезервированы для встроенных servers Claude Code: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет server с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой.201Некоторые имена servers зарезервированы для встроенных servers Claude Code: `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview` и `Claude Browser`. Если ваша конфигурация определяет server с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение с просьбой переименовать его. `claude mcp add` отклоняет зарезервированное имя с ошибкой.

202 202 

203`Claude Preview` и `Claude Browser` оба называют встроенный server, который использует [панель предпросмотра приложения Claude Code desktop](/ru/desktop#preview-your-app). До версии 2.1.205 `Claude Browser` не был зарезервирован, поэтому пользовательский server мог зарегистрироваться под этим именем.203`Claude Preview` и `Claude Browser` оба называют встроенный server, который использует [панель предпросмотра приложения Claude Code desktop](/docs/ru/desktop#preview-your-app). До версии 2.1.205 `Claude Browser` не был зарезервирован, поэтому пользовательский server мог зарегистрироваться под этим именем.

204 204 

205<h3 id="dynamic-tool-updates">205<h3 id="dynamic-tool-updates">

206 Динамические обновления инструментов206 Динамические обновления инструментов


224 Отправка сообщений через каналы224 Отправка сообщений через каналы

225</h3>225</h3>

226 226 

227MCP server также может отправлять сообщения непосредственно в вашу сессию, чтобы Claude мог реагировать на внешние события, такие как результаты CI, оповещения мониторинга или сообщения чата. Чтобы включить это, ваш server объявляет возможность `claude/channel` и вы включаете ее с флагом `--channels` при запуске. См. [Каналы](/ru/channels) для использования официально поддерживаемого канала или [Справочник каналов](/ru/channels-reference) для создания собственного.227MCP server также может отправлять сообщения непосредственно в вашу сессию, чтобы Claude мог реагировать на внешние события, такие как результаты CI, оповещения мониторинга или сообщения чата. Чтобы включить это, ваш server объявляет возможность `claude/channel` и вы включаете ее с флагом `--channels` при запуске. См. [Каналы](/docs/ru/channels) для использования официально поддерживаемого канала или [Справочник каналов](/docs/ru/channels-reference) для создания собственного.

228 228 

229<Tip>229<Tip>

230 Советы:230 Советы:


241 * Используйте `/mcp` для аутентификации с удаленными servers, которые требуют аутентификацию OAuth 2.0241 * Используйте `/mcp` для аутентификации с удаленными servers, которые требуют аутентификацию OAuth 2.0

242</Tip>242</Tip>

243 243 

244Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. Для HTTP, SSE или [claude.ai connector](/ru/mcp#use-mcp-servers-from-claude-ai) server существует также второй таймер для каждого запроса, который охватывает каждый запрос до первого байта ответа server. Этот таймер составляет 60 секунд, если вы не установите timeout для каждого server или `MCP_TOOL_TIMEOUT`; установка любого из них на 60 секунд или выше повышает таймер для каждого запроса до этого значения, более низкое значение не сокращает его, и значение по умолчанию 28 часов неустановленного `MCP_TOOL_TIMEOUT` никогда не питает его. Stdio и WebSocket servers не имеют таймера для каждого запроса. {/* min-version: 2.1.162 */}До версии 2.1.162 значения ниже 1000 округлялись до одной секунды вместо этого.244Timeout для каждого server — это жесткий лимит реального времени для каждого вызова инструмента, и уведомления о прогрессе от server не продлевают его. Значения ниже 1000 игнорируются и переходят к `MCP_TOOL_TIMEOUT`, или к его значению по умолчанию примерно 28 часов, когда эта переменная не установлена. Для HTTP, SSE или [claude.ai connector](/docs/ru/mcp#use-mcp-servers-from-claude-ai) server существует также второй таймер для каждого запроса, который охватывает каждый запрос до первого байта ответа server. Этот таймер составляет 60 секунд, если вы не установите timeout для каждого server или `MCP_TOOL_TIMEOUT`; установка любого из них на 60 секунд или выше повышает таймер для каждого запроса до этого значения, более низкое значение не сокращает его, и значение по умолчанию 28 часов неустановленного `MCP_TOOL_TIMEOUT` никогда не питает его. Stdio и WebSocket servers не имеют таймера для каждого запроса. До версии 2.1.162 значения ниже 1000 округлялись до одной секунды вместо этого.

245 245 

246Timeout для каждого server не менее 1000 также действует как нижний предел для timeout неактивности, описанного ниже: Claude Code никогда не прерывает вызовы инструментов этого server из-за неактивности раньше, чем timeout для каждого server. Требуется Claude Code версии 2.1.203 или позже.246Timeout для каждого server не менее 1000 также действует как нижний предел для timeout неактивности, описанного ниже: Claude Code никогда не прерывает вызовы инструментов этого server из-за неактивности раньше, чем timeout для каждого server. Требуется Claude Code версии 2.1.203 или позже.

247 247 

248Вызов инструмента к MCP server, который не отправляет ответ и не отправляет уведомление о прогрессе в течение окна неактивности, прерывается с ошибкой вместо ожидания лимита реального времени. Timeout неактивности требует Claude Code версии 2.1.187 или позже. {/* min-version: 2.1.203 */}Он применяется к каждому типу server, кроме IDE servers и SDK in-process servers. Окно неактивности по умолчанию составляет пять минут для HTTP, SSE, WebSocket и [claude.ai connector](#use-mcp-servers-from-claude-ai) servers, и 30 минут для stdio servers. До версии 2.1.203 stdio servers были освобождены от timeout неактивности.248Вызов инструмента к MCP server, который не отправляет ответ и не отправляет уведомление о прогрессе в течение окна неактивности, прерывается с ошибкой вместо ожидания лимита реального времени. Timeout неактивности требует Claude Code версии 2.1.187 или позже. Он применяется к каждому типу server, кроме IDE servers и SDK in-process servers. Окно неактивности по умолчанию составляет пять минут для HTTP, SSE, WebSocket и [claude.ai connector](#use-mcp-servers-from-claude-ai) servers, и 30 минут для stdio servers. До версии 2.1.203 stdio servers были освобождены от timeout неактивности.

249 249 

250Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите ее на `0`, чтобы отключить проверку.250Установите переменную окружения [`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/docs/ru/env-vars) в миллисекундах, чтобы изменить окно неактивности, или установите ее на `0`, чтобы отключить проверку.

251 251 

252<h3 id="plugin-provided-mcp-servers">252<h3 id="plugin-provided-mcp-servers">

253 MCP servers, предоставляемые плагинами253 MCP servers, предоставляемые плагинами

254</h3>254</h3>

255 255 

256[Плагины](/ru/plugins) могут включать MCP servers, автоматически предоставляя инструменты и интеграции при включении плагина. Plugin MCP servers работают идентично пользовательским настроенным servers.256[Плагины](/docs/ru/plugins) могут включать MCP servers, автоматически предоставляя инструменты и интеграции при включении плагина. Plugin MCP servers работают идентично пользовательским настроенным servers.

257 257 

258**Как работают plugin MCP servers**:258**Как работают plugin MCP servers**:

259 259 


297**Функции plugin MCP**:297**Функции plugin MCP**:

298 298 

299* **Автоматический жизненный цикл**: При запуске сеанса servers для включенных плагинов подключаются автоматически. Если вы включите или отключите плагин во время сеанса, запустите `/reload-plugins` для подключения или отключения его MCP servers299* **Автоматический жизненный цикл**: При запуске сеанса servers для включенных плагинов подключаются автоматически. Если вы включите или отключите плагин во время сеанса, запустите `/reload-plugins` для подключения или отключения его MCP servers

300* **Переменные пути**: `${CLAUDE_PLUGIN_ROOT}` разрешается в директорию установки плагина, `${CLAUDE_PLUGIN_DATA}` в его [директорию постоянного состояния](/ru/plugins-reference#persistent-data-directory), и `${CLAUDE_PROJECT_DIR}` в стабильный корень проекта. Подстановка применяется к:300* **Переменные пути**: `${CLAUDE_PLUGIN_ROOT}` разрешается в директорию установки плагина, `${CLAUDE_PLUGIN_DATA}` в его [директорию постоянного состояния](/docs/ru/plugins-reference#persistent-data-directory), и `${CLAUDE_PROJECT_DIR}` в стабильный корень проекта. Подстановка применяется к:

301 * `stdio` servers: `command`, `args`, `env`301 * `stdio` servers: `command`, `args`, `env`

302 * `http`, `sse` и `ws` servers: `url`, `headers` и `headersHelper`. {/* min-version: 2.1.195 */}До версии 2.1.195 `headersHelper` передавал заполнитель как буквальную строку302 * `http`, `sse` и `ws` servers: `url`, `headers` и `headersHelper`. До версии 2.1.195 `headersHelper` передавал заполнитель как буквальную строку

303* **Доступ к переменным окружения пользователя**: доступ к тем же переменным окружения, что и вручную настроенные servers303* **Доступ к переменным окружения пользователя**: доступ к тем же переменным окружения, что и вручную настроенные servers

304* **Несколько типов транспорта**: поддержка stdio, SSE, HTTP и WebSocket транспортов, хотя поддержка транспорта может варьироваться в зависимости от server304* **Несколько типов транспорта**: поддержка stdio, SSE, HTTP и WebSocket транспортов, хотя поддержка транспорта может варьироваться в зависимости от server

305 305 


320mcp__plugin_my-plugin_database-tools__query320mcp__plugin_my-plugin_database-tools__query

321```321```

322 322 

323Используйте это полное имя при ссылке на инструмент в [правилах разрешений](/ru/permissions), в списке `allowed-tools` skill, в [поле `tools` subagent](/ru/sub-agents#available-tools) или в [matcher hook](/ru/hooks#match-mcp-tools). Matcher hook, написанный для простого ключа server, такой как `mcp__database-tools__.*`, никогда не срабатывает для plugin-bundled server.323Используйте это полное имя при ссылке на инструмент в [правилах разрешений](/docs/ru/permissions), в списке `allowed-tools` skill, в [поле `tools` subagent](/docs/ru/sub-agents#available-tools) или в [matcher hook](/docs/ru/hooks#match-mcp-tools). Matcher hook, написанный для простого ключа server, такой как `mcp__database-tools__.*`, никогда не срабатывает для plugin-bundled server.

324 324 

325Server сам регистрируется под scoped именем `plugin:<plugin-name>:<server-name>`, такой как `plugin:my-plugin:database-tools`. Используйте это имя там, где ожидается имя настроенного server, такой как [поле `server` hook `mcp_tool`](/ru/hooks#mcp-tool-hook-fields).325Server сам регистрируется под scoped именем `plugin:<plugin-name>:<server-name>`, такой как `plugin:my-plugin:database-tools`. Используйте это имя там, где ожидается имя настроенного server, такой как [поле `server` hook `mcp_tool`](/docs/ru/hooks#mcp-tool-hook-fields).

326 326 

327**Преимущества plugin MCP servers**:327**Преимущества plugin MCP servers**:

328 328 


330* **Автоматическая настройка**: не требуется ручная конфигурация MCP330* **Автоматическая настройка**: не требуется ручная конфигурация MCP

331* **Согласованность команды**: все получают одинаковые инструменты при установке плагина331* **Согласованность команды**: все получают одинаковые инструменты при установке плагина

332 332 

333См. [справочник компонентов плагина](/ru/plugins-reference#mcp-servers) для получения подробной информации о включении MCP servers в плагины.333См. [справочник компонентов плагина](/docs/ru/plugins-reference#mcp-servers) для получения подробной информации о включении MCP servers в плагины.

334 334 

335<h2 id="mcp-installation-scopes">335<h2 id="mcp-installation-scopes">

336 Области установки MCP336 Области установки MCP


351Локальная область — это область по умолчанию. Server с локальной областью загружается только в проекте, где вы его добавили, и остается приватным для вас. Claude Code хранит его в `~/.claude.json` в пути вашего проекта, поэтому один и тот же server не будет отображаться в ваших других проектах. Используйте локальную область для личных development servers, экспериментальных конфигураций или servers с учетными данными, которые вы не хотите в контроле версий.351Локальная область — это область по умолчанию. Server с локальной областью загружается только в проекте, где вы его добавили, и остается приватным для вас. Claude Code хранит его в `~/.claude.json` в пути вашего проекта, поэтому один и тот же server не будет отображаться в ваших других проектах. Используйте локальную область для личных development servers, экспериментальных конфигураций или servers с учетными данными, которые вы не хотите в контроле версий.

352 352 

353<Note>353<Note>

354 Термин "локальная область" для MCP servers отличается от общих локальных параметров. MCP servers с локальной областью хранятся в `~/.claude.json` (ваш домашний каталог), в то время как общие локальные параметры используют `.claude/settings.local.json` (в каталоге проекта). См. [Параметры](/ru/settings#settings-files) для получения подробной информации о расположении файлов параметров.354 Термин "локальная область" для MCP servers отличается от общих локальных параметров. MCP servers с локальной областью хранятся в `~/.claude.json` (ваш домашний каталог), в то время как общие локальные параметры используют `.claude/settings.local.json` (в каталоге проекта). См. [Параметры](/docs/ru/settings#settings-files) для получения подробной информации о расположении файлов параметров.

355</Note>355</Note>

356 356 

357```bash theme={null}357```bash theme={null}


4261. Локальная область4261. Локальная область

4272. Область проекта4272. Область проекта

4283. Область пользователя4283. Область пользователя

4294. [Plugin-provided servers](/ru/plugins)4294. [Plugin-provided servers](/docs/ru/plugins)

4305. [claude.ai connectors](#use-mcp-servers-from-claude-ai)4305. [claude.ai connectors](#use-mcp-servers-from-claude-ai)

431 431 

432Три области совпадают дубликаты по имени. Плагины и соединители совпадают по конечной точке, поэтому тот, который указывает на тот же URL или команду, что и server выше, рассматривается как дубликат.432Три области совпадают дубликаты по имени. Плагины и соединители совпадают по конечной точке, поэтому тот, который указывает на тот же URL или команду, что и server выше, рассматривается как дубликат.


805| :---------------------------- | :------------------------------------------------------------------------------------------------------------------ |805| :---------------------------- | :------------------------------------------------------------------------------------------------------------------ |

806| `CLAUDE_CODE_MCP_SERVER_NAME` | имя MCP server |806| `CLAUDE_CODE_MCP_SERVER_NAME` | имя MCP server |

807| `CLAUDE_CODE_MCP_SERVER_URL` | URL MCP server |807| `CLAUDE_CODE_MCP_SERVER_URL` | URL MCP server |

808| `CLAUDE_PLUGIN_ROOT` | корневой каталог плагина. Установлено только когда [плагин](/ru/plugins-reference#mcp-servers) предоставляет server |808| `CLAUDE_PLUGIN_ROOT` | корневой каталог плагина. Установлено только когда [плагин](/docs/ru/plugins-reference#mcp-servers) предоставляет server |

809 809 

810Используйте их для написания одного скрипта помощника, который служит нескольким MCP servers.810Используйте их для написания одного скрипта помощника, который служит нескольким MCP servers.

811 811 

812Для server, предоставленного плагином, помощник также запускается с его рабочим каталогом, установленным в корень плагина, поэтому относительный путь `headersHelper` разрешается внутри каталога плагина, а не в рабочем каталоге сеанса. Требует Claude Code v2.1.195 или позже.812Для server, предоставленного плагином, помощник также запускается с его рабочим каталогом, установленным в корень плагина, поэтому относительный путь `headersHelper` разрешается внутри каталога плагина, а не в рабочем каталоге сеанса. Требует Claude Code v2.1.195 или позже.

813 813 

814Помощник `headersHelper`, предоставленный плагином, не может ссылаться на значения [`${user_config.*}`](/ru/plugins-reference#user-configuration) плагина, потому что команда запускается через оболочку. Claude Code сообщает о server как о неправильно настроенном с [ошибкой](/ru/errors#plugin-command-references-user-config) и не подставляет значение. Поместите `${user_config.KEY}` в поле `headers` server вместо этого, которое не анализируется оболочкой, или попросите скрипт помощника прочитать значение из своего собственного окружения или файла конфигурации. До v2.1.207 `headersHelper` подставлял значения `${user_config.*}`.814Помощник `headersHelper`, предоставленный плагином, не может ссылаться на значения [`${user_config.*}`](/docs/ru/plugins-reference#user-configuration) плагина, потому что команда запускается через оболочку. Claude Code сообщает о server как о неправильно настроенном с [ошибкой](/docs/ru/errors#plugin-command-references-user-config) и не подставляет значение. Поместите `${user_config.KEY}` в поле `headers` server вместо этого, которое не анализируется оболочкой, или попросите скрипт помощника прочитать значение из своего собственного окружения или файла конфигурации. До v2.1.207 `headersHelper` подставлял значения `${user_config.*}`.

815 815 

816<Note>816<Note>

817 `headersHelper` выполняет произвольные команды оболочки. Когда определено в области проекта или локальной области, он запускается только после того, как вы примете диалог доверия рабочей области.817 `headersHelper` выполняет произвольные команды оболочки. Когда определено в области проекта или локальной области, он запускается только после того, как вы примете диалог доверия рабочей области.


920 920 

921Начиная с версии 2.1.161, коннекторы, в которые вы никогда не входили, свернуты за строкой `Show unused connectors` в конце раздела claude.ai, поэтому список, предоставленный организацией, не заполняет панель. Выберите строку, чтобы развернуть их. Коннектор, в который вы входили ранее, остается видимым даже если в настоящее время требуется повторная аутентификация.921Начиная с версии 2.1.161, коннекторы, в которые вы никогда не входили, свернуты за строкой `Show unused connectors` в конце раздела claude.ai, поэтому список, предоставленный организацией, не заполняет панель. Выберите строку, чтобы развернуть их. Коннектор, в который вы входили ранее, остается видимым даже если в настоящее время требуется повторная аутентификация.

922 922 

923Коннекторы из claude.ai загружаются только когда ваш активный [метод аутентификации](/ru/authentication#authentication-precedence) — это ваша подписка claude.ai. Они не загружаются, когда активны `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper` или сторонний поставщик, такой как Amazon Bedrock или Google Cloud's Agent Platform, даже если вы ранее запустили `/login`.923Коннекторы из claude.ai загружаются только когда ваш активный [метод аутентификации](/docs/ru/authentication#authentication-precedence) — это ваша подписка claude.ai. Они не загружаются, когда активны `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper` или сторонний поставщик, такой как Amazon Bedrock или Google Cloud's Agent Platform, даже если вы ранее запустили `/login`.

924 924 

925Если `/mcp` не отображает коннектор, который вы добавили, запустите `/status`, чтобы подтвердить, какой метод аутентификации активен, отмените установку этой переменной окружения или удалите параметр `apiKeyHelper`, затем запустите `/login`, чтобы выбрать вашу учетную запись claude.ai.925Если `/mcp` не отображает коннектор, который вы добавили, запустите `/status`, чтобы подтвердить, какой метод аутентификации активен, отмените установку этой переменной окружения или удалите параметр `apiKeyHelper`, затем запустите `/login`, чтобы выбрать вашу учетную запись claude.ai.

926 926 


934 934 

935Ваша организация может устанавливать управление инструментами для каждого инструмента на [claude.ai connectors](https://claude.com/docs/connectors). Claude Code читает эти параметры при запуске и применяет их локально. Запустите `/mcp`, чтобы увидеть, какой параметр применяется к каждому инструменту на connector.935Ваша организация может устанавливать управление инструментами для каждого инструмента на [claude.ai connectors](https://claude.com/docs/connectors). Claude Code читает эти параметры при запуске и применяет их локально. Запустите `/mcp`, чтобы увидеть, какой параметр применяется к каждому инструменту на connector.

936 936 

937* **Инструмент установлен на `ask`**: Claude Code запрашивает при каждом вызове с причиной `Your organization requires approval for this tool`. Запрос появляется даже в режимах `acceptEdits`, `auto` и `bypassPermissions` [permission modes](/ru/permissions#permission-modes), и никогда не предлагает опцию запомнить ваш выбор. [Allow rules](/ru/permissions), которые соответствуют инструменту, также не пропускают запрос. В режиме `dontAsk`, который никогда не запрашивает, Claude Code вместо этого отклоняет вызов.937* **Инструмент установлен на `ask`**: Claude Code запрашивает при каждом вызове с причиной `Your organization requires approval for this tool`. Запрос появляется даже в режимах `acceptEdits`, `auto` и `bypassPermissions` [permission modes](/docs/ru/permissions#permission-modes), и никогда не предлагает опцию запомнить ваш выбор. [Allow rules](/docs/ru/permissions), которые соответствуют инструменту, также не пропускают запрос. В режиме `dontAsk`, который никогда не запрашивает, Claude Code вместо этого отклоняет вызов.

938* **Инструмент установлен на `blocked`**: Claude Code фильтрует инструмент перед тем, как Claude его увидит, поэтому он никогда не появляется в списке инструментов.938* **Инструмент установлен на `blocked`**: Claude Code фильтрует инструмент перед тем, как Claude его увидит, поэтому он никогда не появляется в списке инструментов.

939 939 

940Применение этих управлений требует Claude Code версии 2.1.129 или позже. Более ранние версии игнорируют параметры и применяют стандартный поток разрешений.940Применение этих управлений требует Claude Code версии 2.1.129 или позже. Более ранние версии игнорируют параметры и применяют стандартный поток разрешений.


943 Отключите коннекторы claude.ai943 Отключите коннекторы claude.ai

944</h3>944</h3>

945 945 

946Чтобы отключить MCP servers claude.ai в Claude Code, установите [`disableClaudeAiConnectors`](/ru/settings#available-settings) на `true` в любой области параметров:946Чтобы отключить MCP servers claude.ai в Claude Code, установите [`disableClaudeAiConnectors`](/docs/ru/settings#available-settings) на `true` в любой области параметров:

947 947 

948```json theme={null}948```json theme={null}

949{949{


959ENABLE_CLAUDEAI_MCP_SERVERS=false claude959ENABLE_CLAUDEAI_MCP_SERVERS=false claude

960```960```

961 961 

962Чтобы заблокировать отдельные коннекторы claude.ai вместо всех них, добавьте их в [`deniedMcpServers`](/ru/managed-mcp) по имени или по шаблону URL. Например, запись `serverName` со значением `"claude.ai Slack"` блокирует коннектор Slack. Чтобы переключить коннектор включен или выключен только для текущего проекта, используйте панель `/mcp`.962Чтобы заблокировать отдельные коннекторы claude.ai вместо всех них, добавьте их в [`deniedMcpServers`](/docs/ru/managed-mcp) по имени или по шаблону URL. Например, запись `serverName` со значением `"claude.ai Slack"` блокирует коннектор Slack. Чтобы переключить коннектор включен или выключен только для текущего проекта, используйте панель `/mcp`.

963 963 

964<Note>964<Note>

965 Эти параметры на стороне клиента управляют локальными сеансами Claude Code. В сеансах [Claude Code в веб-версии](/ru/claude-code-on-the-web) коннекторы claude.ai предоставляются удаленным хостом и поступают как явные записи `--mcp-config`, поэтому `disableClaudeAiConnectors` не применяется там. URL коннекторов также переписываются через прокси сеанса, поэтому шаблон `serverUrl` в `deniedMcpServers`, нацеленный на URL поставщика, не будет совпадать. Управляйте тем, какие коннекторы может использовать облачный сеанс, из параметров организации claude.ai.965 Эти параметры на стороне клиента управляют локальными сеансами Claude Code. В сеансах [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) коннекторы claude.ai предоставляются удаленным хостом и поступают как явные записи `--mcp-config`, поэтому `disableClaudeAiConnectors` не применяется там. URL коннекторов также переписываются через прокси сеанса, поэтому шаблон `serverUrl` в `deniedMcpServers`, нацеленный на URL поставщика, не будет совпадать. Управляйте тем, какие коннекторы может использовать облачный сеанс, из параметров организации claude.ai.

966</Note>966</Note>

967 967 

968<h2 id="use-claude-code-as-an-mcp-server">968<h2 id="use-claude-code-as-an-mcp-server">


1095 1095 

1096Если вы создаете MCP server, вы можете отметить инструмент как требующий явного одобрения при каждом вызове, установив `_meta["anthropic/requiresUserInteraction"]` на `true` в записи инструмента в ответе `tools/list`. Значение должно быть логическим JSON `true`; любое другое значение игнорируется.1096Если вы создаете MCP server, вы можете отметить инструмент как требующий явного одобрения при каждом вызове, установив `_meta["anthropic/requiresUserInteraction"]` на `true` в записи инструмента в ответе `tools/list`. Значение должно быть логическим JSON `true`; любое другое значение игнорируется.

1097 1097 

1098Claude Code показывает приглашение разрешения этого инструмента при каждом вызове, даже в режимах разрешений `acceptEdits`, `auto` и `bypassPermissions` (/ru/permissions#permission-modes), и не предлагает опцию "не спрашивать снова" для него. [Правила разрешения](/ru/permissions#permission-rule-syntax), которые совпадают с инструментом, также не пропускают приглашение. В режиме `dontAsk`, который никогда не запрашивает, Claude Code отклоняет вызов вместо этого.1098Claude Code показывает приглашение разрешения этого инструмента при каждом вызове, даже в режимах разрешений `acceptEdits`, `auto` и `bypassPermissions` (/ru/permissions#permission-modes), и не предлагает опцию "не спрашивать снова" для него. [Правила разрешения](/docs/ru/permissions#permission-rule-syntax), которые совпадают с инструментом, также не пропускают приглашение. В режиме `dontAsk`, который никогда не запрашивает, Claude Code отклоняет вызов вместо этого.

1099 1099 

1100Приглашение должно достичь человека. В неинтерактивном режиме с [`--permission-prompt-tool`](/ru/cli-reference#cli-flags), результат `allow` из инструмента приглашения для отмеченного инструмента преобразуется в отказ с сообщением `MCP tool requires user interaction; not supported via --permission-prompt-tool`. Обратный вызов [`canUseTool`](/ru/agent-sdk/permissions) Agent SDK получает эти вызовы и может их одобрить, потому что ожидается, что хост SDK покажет их пользователю.1100Приглашение должно достичь человека. В неинтерактивном режиме с [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags), результат `allow` из инструмента приглашения для отмеченного инструмента преобразуется в отказ с сообщением `MCP tool requires user interaction; not supported via --permission-prompt-tool`. Обратный вызов [`canUseTool`](/docs/ru/agent-sdk/permissions) Agent SDK получает эти вызовы и может их одобрить, потому что ожидается, что хост SDK покажет их пользователю.

1101 1101 

1102Используйте это для инструментов, чье приглашение разрешения само по себе является целью, такие как шаг согласия или предоставления доступа, где автоматическое одобрение означало бы, что ни один человек никогда не согласился. Другие инструменты из того же server сохраняют свое нормальное поведение разрешения.1102Используйте это для инструментов, чье приглашение разрешения само по себе является целью, такие как шаг согласия или предоставления доступа, где автоматическое одобрение означало бы, что ни один человек никогда не согласился. Другие инструменты из того же server сохраняют свое нормальное поведение разрешения.

1103 1103 


1115 1115 

1116Аннотация `anthropic/requiresUserInteraction` требует Claude Code v2.1.199 или позже. Более ранние версии игнорируют ее и применяют стандартный поток разрешения.1116Аннотация `anthropic/requiresUserInteraction` требует Claude Code v2.1.199 или позже. Более ранние версии игнорируют ее и применяют стандартный поток разрешения.

1117 1117 

1118Когда сеанс подключен к [Remote Control](/ru/remote-control) или хосту SDK, Claude Code отмечает запрос разрешения как требующий взаимодействия пользователя, поэтому клиент показывает приглашение разрешения инструмента для вас, чтобы ответить, вместо действия одобрения одним касанием.1118Когда сеанс подключен к [Remote Control](/docs/ru/remote-control) или хосту SDK, Claude Code отмечает запрос разрешения как требующий взаимодействия пользователя, поэтому клиент показывает приглашение разрешения инструмента для вас, чтобы ответить, вместо действия одобрения одним касанием.

1119 1119 

1120<h2 id="respond-to-mcp-elicitation-requests">1120<h2 id="respond-to-mcp-elicitation-requests">

1121 Ответьте на запросы MCP elicitation1121 Ответьте на запросы MCP elicitation


1128* **Режим формы**: Claude Code показывает диалог с полями формы, определенными server (например, приглашение имени пользователя и пароля). Заполните поля и отправьте.1128* **Режим формы**: Claude Code показывает диалог с полями формы, определенными server (например, приглашение имени пользователя и пароля). Заполните поля и отправьте.

1129* **Режим URL**: Claude Code открывает URL браузера для аутентификации или одобрения. Завершите процесс в браузере, затем подтвердите в CLI.1129* **Режим URL**: Claude Code открывает URL браузера для аутентификации или одобрения. Завершите процесс в браузере, затем подтвердите в CLI.

1130 1130 

1131Чтобы автоматически ответить на запросы elicitation без отображения диалога, используйте [`Elicitation` hook](/ru/hooks#elicitation).1131Чтобы автоматически ответить на запросы elicitation без отображения диалога, используйте [`Elicitation` hook](/docs/ru/hooks#elicitation).

1132 1132 

1133Если вы создаете MCP server, который использует elicitation, см. [спецификацию MCP elicitation](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) для деталей протокола и примеров схемы.1133Если вы создаете MCP server, который использует elicitation, см. [спецификацию MCP elicitation](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation) для деталей протокола и примеров схемы.

1134 1134 


1195 Для авторов MCP server1195 Для авторов MCP server

1196</h3>1196</h3>

1197 1197 

1198Если вы создаете MCP server, поле инструкций server становится более полезным с включенным Tool Search. Инструкции server помогают Claude понять, когда искать ваши инструменты, аналогично тому, как работают [skills](/ru/skills).1198Если вы создаете MCP server, поле инструкций server становится более полезным с включенным Tool Search. Инструкции server помогают Claude понять, когда искать ваши инструменты, аналогично тому, как работают [skills](/docs/ru/skills).

1199 1199 

1200Добавьте четкие, описательные инструкции server, которые объясняют:1200Добавьте четкие, описательные инструкции server, которые объясняют:

1201 1201 


1211 1211 

1212Tool search включен по умолчанию: инструменты MCP откладываются и обнаруживаются по требованию. Claude Code отключает его по умолчанию на Google Cloud's Agent Platform. Он также отключен, когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной, так как большинство прокси не пересылают блоки `tool_reference`. Установите `ENABLE_TOOL_SEARCH` явно, чтобы переопределить любой резервный вариант.1212Tool search включен по умолчанию: инструменты MCP откладываются и обнаруживаются по требованию. Claude Code отключает его по умолчанию на Google Cloud's Agent Platform. Он также отключен, когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной, так как большинство прокси не пересылают блоки `tool_reference`. Установите `ENABLE_TOOL_SEARCH` явно, чтобы переопределить любой резервный вариант.

1213 1213 

1214Установка [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/ru/env-vars) сохраняет tool search отключенным, и `ENABLE_TOOL_SEARCH` не может его переопределить. Переменная удаляет заголовок бета-версии, который требуют определения инструментов `defer_loading` и блоки содержимого `tool_reference`.1214Установка [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ru/env-vars) сохраняет tool search отключенным, и `ENABLE_TOOL_SEARCH` не может его переопределить. Переменная удаляет заголовок бета-версии, который требуют определения инструментов `defer_loading` и блоки содержимого `tool_reference`.

1215 1215 

1216Tool search требует модель, которая поддерживает блоки `tool_reference`: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 и более поздние модели. См. [совместимость моделей в документации API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool#model-compatibility) для текущего списка. На Google Cloud's Agent Platform tool search поддерживается для Claude Sonnet 4.5 и позже и Claude Opus 4.5 и позже.1216Tool search требует модель, которая поддерживает блоки `tool_reference`: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 и более поздние модели. См. [совместимость моделей в документации API](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool#model-compatibility) для текущего списка. На Google Cloud's Agent Platform tool search поддерживается для Claude Sonnet 4.5 и позже и Claude Opus 4.5 и позже.

1217 1217 


1233ENABLE_TOOL_SEARCH=false claude1233ENABLE_TOOL_SEARCH=false claude

1234```1234```

1235 1235 

1236Или установите значение в поле `env` вашего [settings.json](/ru/settings#available-settings).1236Или установите значение в поле `env` вашего [settings.json](/docs/ru/settings#available-settings).

1237 1237 

1238Вы также можете отключить инструмент `ToolSearch` специально:1238Вы также можете отключить инструмент `ToolSearch` специально:

1239 1239 


1267 1267 

1268Поле `alwaysLoad` доступно на всех типах server и требует Claude Code v2.1.121 или позже. MCP server также может отметить отдельные инструменты как всегда загружаемые, включив `"anthropic/alwaysLoad": true` в объект `_meta` инструмента, что имеет тот же эффект только для этого инструмента.1268Поле `alwaysLoad` доступно на всех типах server и требует Claude Code v2.1.121 или позже. MCP server также может отметить отдельные инструменты как всегда загружаемые, включив `"anthropic/alwaysLoad": true` в объект `_meta` инструмента, что имеет тот же эффект только для этого инструмента.

1269 1269 

1270Установка `alwaysLoad: true` также блокирует запуск до подключения server, ограничено стандартным тайм-аутом подключения в 5 секунд. Это применяется даже когда MCP startup является [неблокирующим по умолчанию](/ru/env-vars), так как инструменты должны присутствовать при построении первого приглашения. Другие servers продолжают подключаться в фоновом режиме.1270Установка `alwaysLoad: true` также блокирует запуск до подключения server, ограничено стандартным тайм-аутом подключения в 5 секунд. Это применяется даже когда MCP startup является [неблокирующим по умолчанию](/docs/ru/env-vars), так как инструменты должны присутствовать при построении первого приглашения. Другие servers продолжают подключаться в фоновом режиме.

1271 1271 

1272<h2 id="use-mcp-prompts-as-commands">1272<h2 id="use-mcp-prompts-as-commands">

1273 Используйте MCP подсказки как команды1273 Используйте MCP подсказки как команды


1316 Управляемая конфигурация MCP1316 Управляемая конфигурация MCP

1317</h2>1317</h2>

1318 1318 

1319Для организаций, которым требуется централизованный контроль над тем, какие MCP servers пользователи могут подключать, см. [Managed MCP configuration](/ru/managed-mcp). Это охватывает развертывание фиксированного набора servers с помощью `managed-mcp.json`, ограничение servers с помощью `allowedMcpServers` и `deniedMcpServers`, а также то, что видят пользователи, когда server заблокирован.1319Для организаций, которым требуется централизованный контроль над тем, какие MCP servers пользователи могут подключать, см. [Managed MCP configuration](/docs/ru/managed-mcp). Это охватывает развертывание фиксированного набора servers с помощью `managed-mcp.json`, ограничение servers с помощью `allowedMcpServers` и `deniedMcpServers`, а также то, что видят пользователи, когда server заблокирован.

memory.md +23 −23

Details

22 CLAUDE.md и auto memory22 CLAUDE.md и auto memory

23</h2>23</h2>

24 24 

25Claude Code имеет две дополняющие друг друга системы памяти. Обе загружаются в начале каждого разговора. Claude рассматривает их как контекст, а не как принудительную конфигурацию. Чтобы заблокировать действие независимо от того, что решит Claude, используйте [PreToolUse hook](/ru/hooks-guide) вместо этого. Чем более конкретны и лаконичны ваши инструкции, тем последовательнее Claude их соблюдает.25Claude Code имеет две дополняющие друг друга системы памяти. Обе загружаются в начале каждого разговора. Claude рассматривает их как контекст, а не как принудительную конфигурацию. Чтобы заблокировать действие независимо от того, что решит Claude, используйте [PreToolUse hook](/docs/ru/hooks-guide) вместо этого. Чем более конкретны и лаконичны ваши инструкции, тем последовательнее Claude их соблюдает.

26 26 

27| | Файлы CLAUDE.md | Auto memory |27| | Файлы CLAUDE.md | Auto memory |

28| :------------------- | :----------------------------------------------------------- | :---------------------------------------------------------------- |28| :------------------- | :----------------------------------------------------------- | :---------------------------------------------------------------- |


34 34 

35Используйте файлы CLAUDE.md, когда вы хотите направить поведение Claude. Auto memory позволяет Claude учиться на ваших исправлениях без ручных усилий.35Используйте файлы CLAUDE.md, когда вы хотите направить поведение Claude. Auto memory позволяет Claude учиться на ваших исправлениях без ручных усилий.

36 36 

37Subagents также могут поддерживать собственную auto memory. Подробнее см. в разделе [конфигурация subagent](/ru/sub-agents#enable-persistent-memory).37Subagents также могут поддерживать собственную auto memory. Подробнее см. в разделе [конфигурация subagent](/docs/ru/sub-agents#enable-persistent-memory).

38 38 

39<h2 id="claude-md-files">39<h2 id="claude-md-files">

40 Файлы CLAUDE.md40 Файлы CLAUDE.md


53* Вы вводите одно и то же исправление или уточнение в чат, которое вводили в прошлом сеансе53* Вы вводите одно и то же исправление или уточнение в чат, которое вводили в прошлом сеансе

54* Новому члену команды потребуется тот же контекст для продуктивности54* Новому члену команды потребуется тот же контекст для продуктивности

55 55 

56Ограничивайте это фактами, которые Claude должен помнить в каждом сеансе: команды сборки, соглашения, макет проекта, правила "всегда делай X". Если запись — это многошаговая процедура или имеет значение только для одной части кодовой базы, переместите её в [skill](/ru/skills) или [правило с ограничением по пути](#organize-rules-with-claude/rules/) вместо этого. [Обзор расширений](/ru/features-overview#build-your-setup-over-time) охватывает, когда использовать каждый механизм.56Ограничивайте это фактами, которые Claude должен помнить в каждом сеансе: команды сборки, соглашения, макет проекта, правила "всегда делай X". Если запись — это многошаговая процедура или имеет значение только для одной части кодовой базы, переместите её в [skill](/docs/ru/skills) или [правило с ограничением по пути](#organize-rules-with-claude/rules/) вместо этого. [Обзор расширений](/docs/ru/features-overview#build-your-setup-over-time) охватывает, когда использовать каждый механизм.

57 57 

58<h3 id="choose-where-to-put-claude-md-files">58<h3 id="choose-where-to-put-claude-md-files">

59 Выберите, где разместить файлы CLAUDE.md59 Выберите, где разместить файлы CLAUDE.md


88 Пишите эффективные инструкции88 Пишите эффективные инструкции

89</h3>89</h3>

90 90 

91Файлы CLAUDE.md загружаются в context window в начале каждого сеанса, потребляя токены наряду с вашим разговором. [Визуализация context window](/ru/context-window) показывает, где загружается CLAUDE.md относительно остального контекста при запуске. Поскольку это контекст, а не принудительная конфигурация, то, как вы пишете инструкции, влияет на то, насколько надёжно Claude их соблюдает. Лучше всего работают конкретные, лаконичные, хорошо структурированные инструкции.91Файлы CLAUDE.md загружаются в context window в начале каждого сеанса, потребляя токены наряду с вашим разговором. [Визуализация context window](/docs/ru/context-window) показывает, где загружается CLAUDE.md относительно остального контекста при запуске. Поскольку это контекст, а не принудительная конфигурация, то, как вы пишете инструкции, влияет на то, насколько надёжно Claude их соблюдает. Лучше всего работают конкретные, лаконичные, хорошо структурированные инструкции.

92 92 

93**Размер**: целевой показатель менее 200 строк на файл CLAUDE.md. Более длинные файлы потребляют больше контекста и снижают соблюдение. Если ваши инструкции становятся большими, используйте [правила с ограничением по пути](#path-specific-rules), чтобы инструкции загружались только когда Claude работает с соответствующими файлами. Вы также можете разделить содержимое на [импорты](#import-additional-files) для организации, хотя импортированные файлы всё равно загружаются и входят в context window при запуске.93**Размер**: целевой показатель менее 200 строк на файл CLAUDE.md. Более длинные файлы потребляют больше контекста и снижают соблюдение. Если ваши инструкции становятся большими, используйте [правила с ограничением по пути](#path-specific-rules), чтобы инструкции загружались только когда Claude работает с соответствующими файлами. Вы также можете разделить содержимое на [импорты](#import-additional-files) для организации, хотя импортированные файлы всё равно загружаются и входят в context window при запуске.

94 94 


158 158 

159На Windows создание symlink требует привилегий администратора или режима разработчика, поэтому используйте импорт `@AGENTS.md` вместо этого.159На Windows создание symlink требует привилегий администратора или режима разработчика, поэтому используйте импорт `@AGENTS.md` вместо этого.

160 160 

161Запуск [`/init`](/ru/commands) в репозитории, который уже имеет `AGENTS.md`, читает его и включает соответствующие части в созданный `CLAUDE.md`. Он также читает другие конфигурации инструментов, такие как `.cursorrules`, `.devin/rules/` и `.windsurfrules`.161Запуск [`/init`](/docs/ru/commands) в репозитории, который уже имеет `AGENTS.md`, читает его и включает соответствующие части в созданный `CLAUDE.md`. Он также читает другие конфигурации инструментов, такие как `.cursorrules`, `.devin/rules/` и `.windsurfrules`.

162 162 

163<h3 id="how-claude-md-files-load">163<h3 id="how-claude-md-files-load">

164 Как загружаются файлы CLAUDE.md164 Как загружаются файлы CLAUDE.md


170 170 

171Claude также обнаруживает файлы `CLAUDE.md` и `CLAUDE.local.md` в подкаталогах под вашим текущим рабочим каталогом. Вместо загрузки при запуске они включаются, когда Claude читает файлы в этих подкаталогах.171Claude также обнаруживает файлы `CLAUDE.md` и `CLAUDE.local.md` в подкаталогах под вашим текущим рабочим каталогом. Вместо загрузки при запуске они включаются, когда Claude читает файлы в этих подкаталогах.

172 172 

173Если вы работаете в большом монорепозитории, где подбираются файлы CLAUDE.md других команд, используйте [`claudeMdExcludes`](#exclude-specific-claude-md-files) для их пропуска. Для полного макета корневых и каталог-специфичных файлов CLAUDE.md и правил см. [Монорепозитории и большие репозитории](/ru/large-codebases).173Если вы работаете в большом монорепозитории, где подбираются файлы CLAUDE.md других команд, используйте [`claudeMdExcludes`](#exclude-specific-claude-md-files) для их пропуска. Для полного макета корневых и каталог-специфичных файлов CLAUDE.md и правил см. [Монорепозитории и большие репозитории](/docs/ru/large-codebases).

174 174 

175Блочные HTML-комментарии (`<!-- maintainer notes -->`) в файлах CLAUDE.md удаляются перед внедрением содержимого в контекст Claude. Используйте их для оставления заметок для человеческих разработчиков без траты токенов контекста на них. Комментарии внутри блоков кода сохраняются. Когда вы открываете файл CLAUDE.md напрямую с помощью инструмента Read, комментарии остаются видимыми.175Блочные HTML-комментарии (`<!-- maintainer notes -->`) в файлах CLAUDE.md удаляются перед внедрением содержимого в контекст Claude. Используйте их для оставления заметок для человеческих разработчиков без траты токенов контекста на них. Комментарии внутри блоков кода сохраняются. Когда вы открываете файл CLAUDE.md напрямую с помощью инструмента Read, комментарии остаются видимыми.

176 176 


186CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config186CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

187```187```

188 188 

189Это загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md` из дополнительного каталога. `CLAUDE.local.md` пропускается, если вы исключите `local` из [`--setting-sources`](/ru/cli-reference).189Это загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md` из дополнительного каталога. `CLAUDE.local.md` пропускается, если вы исключите `local` из [`--setting-sources`](/docs/ru/cli-reference).

190 190 

191<h3 id="organize-rules-with-claude/rules/">191<h3 id="organize-rules-with-claude/rules/">

192 Организуйте правила с помощью `.claude/rules/`192 Организуйте правила с помощью `.claude/rules/`


195Для больших проектов вы можете организовать инструкции в несколько файлов, используя каталог `.claude/rules/`. Это делает инструкции модульными и облегчает их поддержку командами. Правила также могут быть [ограничены определёнными путями файлов](#path-specific-rules), поэтому они загружаются в контекст только когда Claude работает с соответствующими файлами, снижая шум и экономя пространство контекста.195Для больших проектов вы можете организовать инструкции в несколько файлов, используя каталог `.claude/rules/`. Это делает инструкции модульными и облегчает их поддержку командами. Правила также могут быть [ограничены определёнными путями файлов](#path-specific-rules), поэтому они загружаются в контекст только когда Claude работает с соответствующими файлами, снижая шум и экономя пространство контекста.

196 196 

197<Note>197<Note>

198 Правила загружаются в контекст каждый сеанс или когда открываются соответствующие файлы. Для инструкций, специфичных для задачи, которые не нужны в контексте всё время, используйте [skills](/ru/skills), которые загружаются только при их вызове или когда Claude определяет, что они имеют отношение к вашему запросу.198 Правила загружаются в контекст каждый сеанс или когда открываются соответствующие файлы. Для инструкций, специфичных для задачи, которые не нужны в контексте всё время, используйте [skills](/docs/ru/skills), которые загружаются только при их вызове или когда Claude определяет, что они имеют отношение к вашему запросу.

199</Note>199</Note>

200 200 

201<h4 id="set-up-rules">201<h4 id="set-up-rules">


235- Включите комментарии документации OpenAPI235- Включите комментарии документации OpenAPI

236```236```

237 237 

238Правила без поля `paths` загружаются безусловно и применяются ко всем файлам. Правила с ограничением по пути срабатывают, когда Claude читает файлы, соответствующие шаблону, а не при каждом использовании инструмента. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, сопоставление также работает, когда Claude достигает файла через символическую ссылку на каталог проекта, например в символически связанном checkout.238Правила без поля `paths` загружаются безусловно и применяются ко всем файлам. Правила с ограничением по пути срабатывают, когда Claude читает файлы, соответствующие шаблону, а не при каждом использовании инструмента. Начиная с версии 2.1.198, сопоставление также работает, когда Claude достигает файла через символическую ссылку на каталог проекта, например в символически связанном checkout.

239 239 

240Используйте glob-шаблоны в поле `paths` для сопоставления файлов по расширению, каталогу или любой комбинации:240Используйте glob-шаблоны в поле `paths` для сопоставления файлов по расширению, каталогу или любой комбинации:

241 241 


257---257---

258```258```

259 259 

260Синтаксис Glob рассматривает `[` как начало выражения в скобках, такого как `[abc]`. Шаблон с `[`, который не может быть прочитан как выражение в скобках, такой как `photos [2024/**`, является недействительным: он ничему не соответствует, и другие шаблоны правила продолжают работать. Чтобы сопоставить буквальный `[` в имени файла, экранируйте его как `photos \[2024/**`. {/* min-version: 2.1.207 */}До версии 2.1.207 один недействительный шаблон приводил к сбою инструмента Read для каждого файла, для которого оценивалось правило, вместо того чтобы ничему не соответствовать.260Синтаксис Glob рассматривает `[` как начало выражения в скобках, такого как `[abc]`. Шаблон с `[`, который не может быть прочитан как выражение в скобках, такой как `photos [2024/**`, является недействительным: он ничему не соответствует, и другие шаблоны правила продолжают работать. Чтобы сопоставить буквальный `[` в имени файла, экранируйте его как `photos \[2024/**`. До версии 2.1.207 один недействительный шаблон приводил к сбою инструмента Read для каждого файла, для которого оценивалось правило, вместо того чтобы ничему не соответствовать.

261 261 

262<h4 id="share-rules-across-projects-with-symlinks">262<h4 id="share-rules-across-projects-with-symlinks">

263 Делитесь правилами между проектами с помощью symlinks263 Делитесь правилами между проектами с помощью symlinks


306 </Step>306 </Step>

307 307 

308 <Step title="Развёртывание с помощью вашей системы управления конфигурацией">308 <Step title="Развёртывание с помощью вашей системы управления конфигурацией">

309 Используйте MDM, Group Policy, Ansible или аналогичные инструменты для распределения файла на машины разработчиков. Подробнее см. в разделе [управляемые настройки](/ru/permissions#managed-settings) для других параметров конфигурации на уровне организации.309 Используйте MDM, Group Policy, Ansible или аналогичные инструменты для распределения файла на машины разработчиков. Подробнее см. в разделе [управляемые настройки](/docs/ru/permissions#managed-settings) для других параметров конфигурации на уровне организации.

310 </Step>310 </Step>

311</Steps>311</Steps>

312 312 


326}326}

327```327```

328 328 

329Управляемый CLAUDE.md и [управляемые настройки](/ru/settings#settings-files) служат разным целям. Используйте настройки для технического принуждения и CLAUDE.md для поведенческого руководства:329Управляемый CLAUDE.md и [управляемые настройки](/docs/ru/settings#settings-files) служат разным целям. Используйте настройки для технического принуждения и CLAUDE.md для поведенческого руководства:

330 330 

331| Проблема | Настроить в |331| Проблема | Настроить в |

332| :------------------------------------------------------------ | :------------------------------------------------------------- |332| :------------------------------------------------------------ | :------------------------------------------------------------- |


357}357}

358```358```

359 359 

360Шаблоны сопоставляются с абсолютными путями файлов с использованием синтаксиса glob. Вы можете настроить `claudeMdExcludes` на любом [уровне настроек](/ru/settings#settings-files): пользователь, проект, локальный или управляемая политика. Массивы объединяются между уровнями.360Шаблоны сопоставляются с абсолютными путями файлов с использованием синтаксиса glob. Вы можете настроить `claudeMdExcludes` на любом [уровне настроек](/docs/ru/settings#settings-files): пользователь, проект, локальный или управляемая политика. Массивы объединяются между уровнями.

361 361 

362Файлы CLAUDE.md управляемой политики не могут быть исключены. Это гарантирует, что инструкции на уровне организации всегда применяются независимо от индивидуальных настроек.362Файлы CLAUDE.md управляемой политики не могут быть исключены. Это гарантирует, что инструкции на уровне организации всегда применяются независимо от индивидуальных настроек.

363 363 


387 387 

388Каждый проект получает свой собственный каталог памяти в `~/.claude/projects/<project>/memory/`. Путь `<project>` получается из репозитория git, поэтому все worktrees и подкаталоги в одном репозитории используют один каталог auto memory. Вне репозитория git вместо этого используется корень проекта.388Каждый проект получает свой собственный каталог памяти в `~/.claude/projects/<project>/memory/`. Путь `<project>` получается из репозитория git, поэтому все worktrees и подкаталоги в одном репозитории используют один каталог auto memory. Вне репозитория git вместо этого используется корень проекта.

389 389 

390Чтобы сохранить auto memory в другом местоположении, установите `autoMemoryDirectory` в вашем `settings.json`. Он читается из любой [области настроек](/ru/settings#settings-precedence): пользователя, проекта, локальной, политики или `--settings`.390Чтобы сохранить auto memory в другом местоположении, установите `autoMemoryDirectory` в вашем `settings.json`. Он читается из любой [области настроек](/docs/ru/settings#settings-precedence): пользователя, проекта, локальной, политики или `--settings`.

391 391 

392```json theme={null}392```json theme={null}

393{393{


456* Сделайте инструкции более конкретными. "Используйте отступ из 2 пробелов" работает лучше, чем "красиво форматируйте код".456* Сделайте инструкции более конкретными. "Используйте отступ из 2 пробелов" работает лучше, чем "красиво форматируйте код".

457* Ищите конфликтующие инструкции в файлах CLAUDE.md. Если два файла дают разные рекомендации для одного поведения, Claude может выбрать одну произвольно.457* Ищите конфликтующие инструкции в файлах CLAUDE.md. Если два файла дают разные рекомендации для одного поведения, Claude может выбрать одну произвольно.

458 458 

459Если инструкция — это что-то, что должно выполняться в определённый момент, например перед каждым коммитом или после каждого редактирования файла, напишите её как [hook](/ru/hooks-guide). Hooks выполняются как команды shell в фиксированных событиях жизненного цикла и применяются независимо от того, что решит сделать Claude.459Если инструкция — это что-то, что должно выполняться в определённый момент, например перед каждым коммитом или после каждого редактирования файла, напишите её как [hook](/docs/ru/hooks-guide). Hooks выполняются как команды shell в фиксированных событиях жизненного цикла и применяются независимо от того, что решит сделать Claude.

460 460 

461Для инструкций, которые вы хотите на уровне системного запроса, используйте [`--append-system-prompt`](/ru/cli-reference#system-prompt-flags). Это должно быть передано при каждом вызове, поэтому оно лучше подходит для скриптов и автоматизации, чем для интерактивного использования.461Для инструкций, которые вы хотите на уровне системного запроса, используйте [`--append-system-prompt`](/docs/ru/cli-reference#system-prompt-flags). Это должно быть передано при каждом вызове, поэтому оно лучше подходит для скриптов и автоматизации, чем для интерактивного использования.

462 462 

463<Tip>463<Tip>

464 Используйте hook [`InstructionsLoaded`](/ru/hooks#instructionsloaded) для логирования точно того, какие файлы инструкций загружены, когда они загружаются и почему. Это полезно для отладки правил, специфичных для пути, или ленивых загруженных файлов в подкаталогах.464 Используйте hook [`InstructionsLoaded`](/docs/ru/hooks#instructionsloaded) для логирования точно того, какие файлы инструкций загружены, когда они загружаются и почему. Это полезно для отладки правил, специфичных для пути, или ленивых загруженных файлов в подкаталогах.

465</Tip>465</Tip>

466 466 

467<h3 id="i-don’t-know-what-auto-memory-saved">467<h3 id="i-don’t-know-what-auto-memory-saved">


476 476 

477Файлы более 200 строк потребляют больше контекста и могут снизить соблюдение. Используйте [правила с областью действия пути](#path-specific-rules) для загрузки инструкций только когда Claude работает с соответствующими файлами, или сократите содержимое, которое не требуется в каждом сеансе. Разделение на [`@path` импорты](#import-additional-files) помогает организации, но не снижает контекст, так как импортированные файлы загружаются при запуске.477Файлы более 200 строк потребляют больше контекста и могут снизить соблюдение. Используйте [правила с областью действия пути](#path-specific-rules) для загрузки инструкций только когда Claude работает с соответствующими файлами, или сократите содержимое, которое не требуется в каждом сеансе. Разделение на [`@path` импорты](#import-additional-files) помогает организации, но не снижает контекст, так как импортированные файлы загружаются при запуске.

478 478 

479{/* min-version: 2.1.206 */}Проверка [`/doctor`](/ru/commands#all-commands) предлагает сокращения для проверенного CLAUDE.md: она удаляет содержимое, которое Claude может вывести из кодовой базы, такое как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет подводные камни, обоснование и соглашения, которые отличаются от стандартных инструментов. Проверка сокращения требует Claude Code v2.1.206 или более поздней версии.479Проверка [`/doctor`](/docs/ru/commands#all-commands) предлагает сокращения для проверенного CLAUDE.md: она удаляет содержимое, которое Claude может вывести из кодовой базы, такое как макеты каталогов, списки зависимостей и обзоры архитектуры, и сохраняет подводные камни, обоснование и соглашения, которые отличаются от стандартных инструментов. Проверка сокращения требует Claude Code v2.1.206 или более поздней версии.

480 480 

481<h3 id="instructions-seem-lost-after-/compact">481<h3 id="instructions-seem-lost-after-/compact">

482 Инструкции кажутся потерянными после `/compact`482 Инструкции кажутся потерянными после `/compact`


484 484 

485CLAUDE.md в корне проекта выживает при сжатии: после `/compact` Claude повторно читает его с диска и повторно вводит его в сеанс. Вложенные файлы CLAUDE.md в подкаталогах не повторно вводятся автоматически; они перезагружаются в следующий раз, когда Claude читает файл в этом подкаталоге.485CLAUDE.md в корне проекта выживает при сжатии: после `/compact` Claude повторно читает его с диска и повторно вводит его в сеанс. Вложенные файлы CLAUDE.md в подкаталогах не повторно вводятся автоматически; они перезагружаются в следующий раз, когда Claude читает файл в этом подкаталоге.

486 486 

487Если инструкция исчезла после сжатия, она была дана только в разговоре или находится в вложенном CLAUDE.md, который ещё не перезагрузился. Добавьте инструкции только для разговора в CLAUDE.md, чтобы они сохранялись. Полный список см. в разделе [Что выживает при сжатии](/ru/context-window#what-survives-compaction).487Если инструкция исчезла после сжатия, она была дана только в разговоре или находится в вложенном CLAUDE.md, который ещё не перезагрузился. Добавьте инструкции только для разговора в CLAUDE.md, чтобы они сохранялись. Полный список см. в разделе [Что выживает при сжатии](/docs/ru/context-window#what-survives-compaction).

488 488 

489Подробнее см. в разделе [Пишите эффективные инструкции](#write-effective-instructions) для рекомендаций по размеру, структуре и конкретности.489Подробнее см. в разделе [Пишите эффективные инструкции](#write-effective-instructions) для рекомендаций по размеру, структуре и конкретности.

490 490 


492 Связанные ресурсы492 Связанные ресурсы

493</h2>493</h2>

494 494 

495* [Отладка вашей конфигурации](/ru/debug-your-config): диагностируйте, почему CLAUDE.md или настройки не вступают в силу495* [Отладка вашей конфигурации](/docs/ru/debug-your-config): диагностируйте, почему CLAUDE.md или настройки не вступают в силу

496* [Skills](/ru/skills): упакуйте повторяемые рабочие процессы, которые загружаются по требованию496* [Skills](/docs/ru/skills): упакуйте повторяемые рабочие процессы, которые загружаются по требованию

497* [Settings](/ru/settings): настройте поведение Claude Code с помощью файлов настроек497* [Settings](/docs/ru/settings): настройте поведение Claude Code с помощью файлов настроек

498* [Subagent memory](/ru/sub-agents#enable-persistent-memory): позвольте subagents поддерживать собственную auto memory498* [Subagent memory](/docs/ru/sub-agents#enable-persistent-memory): позвольте subagents поддерживать собственную auto memory

Details

139 139 

140**Вариант C: Аутентификация с использованием токена Bearer**140**Вариант C: Аутентификация с использованием токена Bearer**

141 141 

142{/* min-version: 2.1.203 */}Claude Code отправляет значение `ANTHROPIC_FOUNDRY_AUTH_TOKEN` в каждом запросе в качестве заголовка `Authorization: Bearer`. Используйте этот вариант, когда другой процесс, такой как хост-приложение или скрипт входа, уже получил для вас токен доступа. Требуется Claude Code версии 2.1.203 или позже.142Claude Code отправляет значение `ANTHROPIC_FOUNDRY_AUTH_TOKEN` в каждом запросе в качестве заголовка `Authorization: Bearer`. Используйте этот вариант, когда другой процесс, такой как хост-приложение или скрипт входа, уже получил для вас токен доступа. Требуется Claude Code версии 2.1.203 или позже.

143 143 

144Установите переменную на токен Bearer, выданный Microsoft Entra ID для вашего ресурса:144Установите переменную на токен Bearer, выданный Microsoft Entra ID для вашего ресурса:

145 145 


189 189 

190Фоновые задачи, такие как генерация заголовков сеансов, используют небольшую/быструю модель, обычно модель класса Haiku. На Microsoft Foundry Claude Code по умолчанию использует основную модель, потому что не каждая учетная запись имеет развертывание Haiku. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на развертывание Haiku, доступное в вашей учетной записи, как показано выше.190Фоновые задачи, такие как генерация заголовков сеансов, используют небольшую/быструю модель, обычно модель класса Haiku. На Microsoft Foundry Claude Code по умолчанию использует основную модель, потому что не каждая учетная запись имеет развертывание Haiku. Чтобы использовать Haiku для фоновых задач, установите `ANTHROPIC_DEFAULT_HAIKU_MODEL` на развертывание Haiku, доступное в вашей учетной записи, как показано выше.

191 191 

192Для получения текущих и устаревших идентификаторов моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Полный список переменных окружения см. в разделе [Конфигурация модели](/ru/model-config#pin-models-for-third-party-deployments).192Для получения текущих и устаревших идентификаторов моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Полный список переменных окружения см. в разделе [Конфигурация модели](/docs/ru/model-config#pin-models-for-third-party-deployments).

193 193 

194[Prompt caching](/ru/prompt-caching) включен автоматически. Чтобы запросить TTL кэша в 1 час вместо стандартного 5-минутного, установите следующую переменную; записи кэша с TTL в 1 час выставляются по более высокому тарифу:194[Prompt caching](/docs/ru/prompt-caching) включен автоматически. Чтобы запросить TTL кэша в 1 час вместо стандартного 5-минутного, установите следующую переменную; записи кэша с TTL в 1 час выставляются по более высокому тарифу:

195 195 

196```bash theme={null}196```bash theme={null}

197export ENABLE_PROMPT_CACHING_1H=1197export ENABLE_PROMPT_CACHING_1H=1

model-config.md +72 −76

Details

22Рекомендации по выбору модели и уровня усилий, подходящих для различных видов работы, см. в статье [Выбор модели Claude и уровня усилий в Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) в блоге.22Рекомендации по выбору модели и уровня усилий, подходящих для различных видов работы, см. в статье [Выбор модели Claude и уровня усилий в Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) в блоге.

23 23 

24<Note>24<Note>

25 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через шлюз LLM, см. [шлюзы LLM](/ru/llm-gateway).25 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через шлюз LLM, см. [шлюзы LLM](/docs/ru/llm-gateway).

26</Note>26</Note>

27 27 

28<h3 id="model-aliases">28<h3 id="model-aliases">


39| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |39| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |

40| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |40| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |

41| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |41| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |

42| **`sonnet[1m]`** | Использует Sonnet с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов. Не имеет эффекта, когда `sonnet` уже разрешается в Sonnet 5 с его собственным окном 1M; за [LLM gateway](/ru/llm-gateway) выбирает окно 1M для Sonnet 5 |42| **`sonnet[1m]`** | Использует Sonnet с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов. Не имеет эффекта, когда `sonnet` уже разрешается в Sonnet 5 с его собственным окном 1M; за [LLM gateway](/docs/ru/llm-gateway) выбирает окно 1M для Sonnet 5 |

43| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов |43| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов |

44| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, а затем переключается на `sonnet` для выполнения |44| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, а затем переключается на `sonnet` для выполнения |

45 45 


48| Поставщик | `opus` | `sonnet` |48| Поставщик | `opus` | `sonnet` |

49| :--------------------------------------------------- | :------- | :--------- |49| :--------------------------------------------------- | :------- | :--------- |

50| Anthropic API | Opus 4.8 | Sonnet 5 |50| Anthropic API | Opus 4.8 | Sonnet 5 |

51| [Claude Platform on AWS](/ru/claude-platform-on-aws) | Opus 4.8 | Sonnet 4.6 |51| [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) | Opus 4.8 | Sonnet 4.6 |

52| Amazon Bedrock, Google Cloud's Agent Platform | Opus 4.8 | Sonnet 4.5 |52| Amazon Bedrock, Google Cloud's Agent Platform | Opus 4.8 | Sonnet 4.5 |

53| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |53| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |

54 54 

55Если псевдоним разрешается в более старую модель, более новые модели доступны путем явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.55Если псевдоним разрешается в более старую модель, более новые модели доступны путем явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.

56 56 

57{/* min-version: 2.1.207 */}До версии v2.1.207 `opus` разрешался в Opus 4.7 на Claude Platform on AWS и в Opus 4.6 на Amazon Bedrock и Google Cloud's Agent Platform.57До версии v2.1.207 `opus` разрешался в Opus 4.7 на Claude Platform on AWS и в Opus 4.6 на Amazon Bedrock и Google Cloud's Agent Platform.

58 58 

59Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определенную версию, используйте полное имя модели, например `claude-opus-4-8`, или установите соответствующую переменную окружения, такую как `ANTHROPIC_DEFAULT_OPUS_MODEL`.59Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определенную версию, используйте полное имя модели, например `claude-opus-4-8`, или установите соответствующую переменную окружения, такую как `ANTHROPIC_DEFAULT_OPUS_MODEL`.

60 60 


72 72 

73Чтобы получить максимум от Fable 5:73Чтобы получить максимум от Fable 5:

74 74 

75* **Описывайте результат, а не шаги**: передайте ей результат, который вы хотите, и позвольте ей спланировать путь. Чтобы она продолжала работать до тех пор, пока этот результат не будет достигнут, [установите цель](/ru/goal).75* **Описывайте результат, а не шаги**: передайте ей результат, который вы хотите, и позвольте ей спланировать путь. Чтобы она продолжала работать до тех пор, пока этот результат не будет достигнут, [установите цель](/docs/ru/goal).

76* **Передавайте ей неоднозначные проблемы**: исследования первопричин, отладка сбоев и решения по архитектуре — это то, где дополнительное исследование и проверка окупаются.76* **Передавайте ей неоднозначные проблемы**: исследования первопричин, отладка сбоев и решения по архитектуре — это то, где дополнительное исследование и проверка окупаются.

77* **Пропускайте напоминания о проверке**: она проверяет свою собственную работу с меньшим количеством подсказок, поэтому напоминания о тестировании или проверке обычно не требуются.77* **Пропускайте напоминания о проверке**: она проверяет свою собственную работу с меньшим количеством подсказок, поэтому напоминания о тестировании или проверке обычно не требуются.

78* **Масштабируйте более крупные задачи**: дайте ей работу, которую вы обычно разбиваете на части. Она выдерживает длительные сеансы без потери нити.78* **Масштабируйте более крупные задачи**: дайте ей работу, которую вы обычно разбиваете на части. Она выдерживает длительные сеансы без потери нити.

79 79 

80<Note>80<Note>

81 Fable 5 требует Claude Code v2.1.170 или более поздней версии. Более старые версии не показывают Fable 5 в средстве выбора модели и не могут её выбрать. Запустите `claude update` для обновления. Fable 5 недоступна при [нулевом сохранении данных](/ru/zero-data-retention), где средство выбора `/model` либо её опускает, либо показывает её отключённой.81 Fable 5 требует Claude Code v2.1.170 или более поздней версии. Более старые версии не показывают Fable 5 в средстве выбора модели и не могут её выбрать. Запустите `claude update` для обновления. Fable 5 недоступна при [нулевом сохранении данных](/docs/ru/zero-data-retention), где средство выбора `/model` либо её опускает, либо показывает её отключённой.

82</Note>82</Note>

83 83 

84<h3 id="setting-your-model">84<h3 id="setting-your-model">


97* `Enter`: переключить модель и сохранить в качестве значения по умолчанию97* `Enter`: переключить модель и сохранить в качестве значения по умолчанию

98* `s`: переключить модель только для этого сеанса98* `s`: переключить модель только для этого сеанса

99 99 

100Ввод `/model <name>` напрямую ведет себя как `Enter`. {/* min-version: 2.1.205 */}Модель, установленная с помощью `/model` в [неинтерактивном режиме](/ru/headless), с флагом `-p`, применяется только к текущему сеансу и не сохраняется в качестве значения по умолчанию. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. {/* min-version: 2.1.196 */}[Модель по умолчанию организации](#organization-default-model), которую администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.100Ввод `/model <name>` напрямую ведет себя как `Enter`. Модель, установленная с помощью `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, применяется только к текущему сеансу и не сохраняется в качестве значения по умолчанию. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. [Модель по умолчанию организации](#organization-default-model), которую администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.

101 101 

102В версиях v2.1.144 по v2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял значение по умолчанию.102В версиях v2.1.144 по v2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял значение по умолчанию.

103 103 

104Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, с которым вы их запускаете. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с собственным флагом `--model` вместо переключения с помощью `/model`.104Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, с которым вы их запускаете. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с собственным флагом `--model` вместо переключения с помощью `/model`.

105 105 

106Цены в средстве выбора `/model` отображаются, когда Claude Code взаимодействует с Anthropic API, напрямую или через [шлюз LLM](/ru/llm-gateway), который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На [сторонних поставщиках](/ru/third-party-integrations), таких как Amazon Bedrock, и на [шлюзе приложений Claude](/ru/claude-apps-gateway), ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или на то, что ваш поставщик выставляет счет. До версии v2.1.206 [Claude Platform on AWS](/ru/claude-platform-on-aws) и сеансы шлюза показывали цены в списке Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.106Цены в средстве выбора `/model` отображаются, когда Claude Code взаимодействует с Anthropic API, напрямую или через [шлюз LLM](/docs/ru/llm-gateway), который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На [сторонних поставщиках](/docs/ru/third-party-integrations), таких как Amazon Bedrock, и на [шлюзе приложений Claude](/docs/ru/claude-apps-gateway), ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или на то, что ваш поставщик выставляет счет. До версии v2.1.206 [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и сеансы шлюза показывали цены в списке Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.

107 107 

108Возобновленные сеансы, запущенные с `claude --resume`, `--continue` или средством выбора `/resume`, сохраняют модель, которую они использовали при сохранении стенограммы, независимо от текущего параметра `model`. Если эта модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сеанс переходит к обычному порядку приоритета. Это предотвращает изменение модели при возобновлении выбором `/model` другого сеанса.108Возобновленные сеансы, запущенные с `claude --resume`, `--continue` или средством выбора `/resume`, сохраняют модель, которую они использовали при сохранении стенограммы, независимо от текущего параметра `model`. Если эта модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сеанс переходит к обычному порядку приоритета. Это предотвращает изменение модели при возобновлении выбором `/model` другого сеанса.

109 109 

110Модель, которую вы выбираете для нового запуска с `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. {/* min-version: 2.1.195 */}Начиная с версии v2.1.195, то же самое относится к переменной семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables).110Модель, которую вы выбираете для нового запуска с `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии v2.1.195, то же самое относится к переменной семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables).

111 111 

112Когда активная модель при запуске поступает из параметров проекта или управляемых параметров, а не из вашего собственного выбора, заголовок при запуске показывает, какой файл параметров установил его. Запустите `/model` для переопределения; параметр проекта или управляемый параметр переприменяется при следующем запуске.112Когда активная модель при запуске поступает из параметров проекта или управляемых параметров, а не из вашего собственного выбора, заголовок при запуске показывает, какой файл параметров установил его. Запустите `/model` для переопределения; параметр проекта или управляемый параметр переприменяется при следующем запуске.

113 113 

114Когда переключение модели запрашивается через метод [Agent SDK](/ru/agent-sdk/overview) `setModel()` или приложением, таким как [Desktop app](/ru/desktop), которое запускает Claude Code CLI для вас, Claude Code проверяет, что строка является той, которую он распознает, перед её сохранением. Эта проверка требует Claude Code v2.1.200 или более поздней версии. На Anthropic API Claude Code распознает:114Когда переключение модели запрашивается через метод [Agent SDK](/docs/ru/agent-sdk/overview) `setModel()` или приложением, таким как [Desktop app](/docs/ru/desktop), которое запускает Claude Code CLI для вас, Claude Code проверяет, что строка является той, которую он распознает, перед её сохранением. Эта проверка требует Claude Code v2.1.200 или более поздней версии. На Anthropic API Claude Code распознает:

115 115 

116* псевдоним модели116* псевдоним модели

117* запись из средства выбора `/model`117* запись из средства выбора `/model`

118* любое имя, которое начинается с `claude-`118* любое имя, которое начинается с `claude-`

119* значение, которое вы сами настроили как [пользовательский вариант модели](#add-a-custom-model-option) или в [`modelOverrides`](#override-model-ids-per-version)119* значение, которое вы сами настроили как [пользовательский вариант модели](#add-a-custom-model-option) или в [`modelOverrides`](#override-model-ids-per-version)

120 120 

121Claude Code отклоняет неузнанную строку с `Model "<name>" is not a recognized model id.` и сеанс сохраняет свою текущую модель, вместо того чтобы сохранить строку и потерпеть неудачу при следующем запросе. См. [справочник ошибок](/ru/errors#model-is-not-a-recognized-model-id) для шагов восстановления.121Claude Code отклоняет неузнанную строку с `Model "<name>" is not a recognized model id.` и сеанс сохраняет свою текущую модель, вместо того чтобы сохранить строку и потерпеть неудачу при следующем запросе. См. [справочник ошибок](/docs/ru/errors#model-is-not-a-recognized-model-id) для шагов восстановления.

122 122 

123Проверка выполняется только на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/ru/claude-platform-on-aws) и за [LLM gateway](/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code передает любую строку без проверки. Проверка также не охватывает флаг `--model`, переменную окружения `ANTHROPIC_MODEL` или параметр `model`; неправильно введенное значение там производит [There's an issue with the selected model](/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе вместо этого.123Проверка выполняется только на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и за [LLM gateway](/docs/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code передает любую строку без проверки. Проверка также не охватывает флаг `--model`, переменную окружения `ANTHROPIC_MODEL` или параметр `model`; неправильно введенное значение там производит [There's an issue with the selected model](/docs/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе вместо этого.

124 124 

125Когда запрашиваемая модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрашиваемую модель. Интерактивные сеансы показывают его как уведомление при запуске. Начиная с версии v2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный в [frontmatter подагента](/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/ru/headless#get-structured-output) вместо этого.125Когда запрашиваемая модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрашиваемую модель. Интерактивные сеансы показывают его как уведомление при запуске. Начиная с версии v2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/docs/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный в [frontmatter подагента](/docs/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/docs/ru/headless#get-structured-output) вместо этого.

126 126 

127Пример использования:127Пример использования:

128 128 


149 Ограничение выбора модели149 Ограничение выбора модели

150</h2>150</h2>

151 151 

152Администраторы предприятия могут использовать `availableModels` в [управляемых или политических параметрах](/ru/settings#settings-files) для ограничения того, какие модели могут выбирать пользователи. Записи соответствуют семейству моделей, такому как `sonnet`, префиксу версии, такому как `claude-sonnet-4-5`, или полному идентификатору модели, такому как `claude-sonnet-4-5-20250929`.152Администраторы предприятия могут использовать `availableModels` в [управляемых или политических параметрах](/docs/ru/settings#settings-files) для ограничения того, какие модели могут выбирать пользователи. Записи соответствуют семейству моделей, такому как `sonnet`, префиксу версии, такому как `claude-sonnet-4-5`, или полному идентификатору модели, такому как `claude-sonnet-4-5-20250929`.

153 153 

154Когда установлен `availableModels`, список разрешений применяется везде, где пользователь может указать модель:154Когда установлен `availableModels`, список разрешений применяется везде, где пользователь может указать модель:

155 155 

156* **Модель основного сеанса**: `/model`, флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, параметр `model` и модель, восстановленная при [возобновлении сеанса](#setting-your-model)156* **Модель основного сеанса**: `/model`, флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, параметр `model` и модель, восстановленная при [возобновлении сеанса](#setting-your-model)

157* **Разрешение псевдонимов**: {/* min-version: 2.1.176 */}переменные окружения `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` и `ANTHROPIC_DEFAULT_FABLE_MODEL` не могут перенаправить разрешённый псевдоним на модель вне списка157* **Разрешение псевдонимов**: переменные окружения `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` и `ANTHROPIC_DEFAULT_FABLE_MODEL` не могут перенаправить разрешённый псевдоним на модель вне списка

158* **Быстрый режим**: {/* min-version: 2.1.176 */}`/fast` отказывает переключаться, когда это неявно переключилось бы на модель Opus вне списка, с сообщением "is not in your organization's allowed models"158* **Быстрый режим**: `/fast` отказывает переключаться, когда это неявно переключилось бы на модель Opus вне списка, с сообщением "is not in your organization's allowed models"

159* **Модели подагентов**: поле `model` в [подагенте](/ru/sub-agents#choose-a-model) frontmatter, параметр `model` инструмента Agent, `CLAUDE_CODE_SUBAGENT_MODEL`, и на v2.1.197 и более ранних версиях средство выбора модели в `/agents` {/* max-version: 2.1.197 */}159* **Модели подагентов**: поле `model` в [подагенте](/docs/ru/sub-agents#choose-a-model) frontmatter, параметр `model` инструмента Agent, `CLAUDE_CODE_SUBAGENT_MODEL`, и на v2.1.197 и более ранних версиях средство выбора модели в `/agents`&#x20;

160* **Модели навыков и команд**: frontmatter `model` в [навыках и командах](/ru/skills)160* **Модели навыков и команд**: frontmatter `model` в [навыках и командах](/docs/ru/skills)

161* **Модель советника**: настроенный параметр [`advisorModel`](/ru/advisor) и флаг `--advisor`161* **Модель советника**: настроенный параметр [`advisorModel`](/docs/ru/advisor) и флаг `--advisor`

162* **Модель фонового агента**: модель, выбранная в [средстве выбора диспетчера](/ru/agent-view)162* **Модель фонового агента**: модель, выбранная в [средстве выбора диспетчера](/docs/ru/agent-view)

163 163 

164На API Anthropic и [Claude Platform на AWS](/ru/claude-platform-on-aws) псевдоним семейства моделей, `opus`, `sonnet`, `haiku` или `fable`, разрешается на самую новую версию своего семейства, которую разрешает список разрешений. Когда список разрешений закрепляет конкретные версии, например `["sonnet", "claude-opus-4-6"]`, оба `/model opus` и `--model opus` выбирают Claude Opus 4.6, самый новый разрешённый Opus, и показывают уведомление, называющее как запрошенную, так и подставленную модели. До v2.1.205 псевдоним, самая новая выпущенная версия которого была вне списка, отклонялась или заменялась как любой другой заблокированный выбор, даже когда список разрешал более старую версию.164На API Anthropic и [Claude Platform на AWS](/docs/ru/claude-platform-on-aws) псевдоним семейства моделей, `opus`, `sonnet`, `haiku` или `fable`, разрешается на самую новую версию своего семейства, которую разрешает список разрешений. Когда список разрешений закрепляет конкретные версии, например `["sonnet", "claude-opus-4-6"]`, оба `/model opus` и `--model opus` выбирают Claude Opus 4.6, самый новый разрешённый Opus, и показывают уведомление, называющее как запрошенную, так и подставленную модели. До v2.1.205 псевдоним, самая новая выпущенная версия которого была вне списка, отклонялась или заменялась как любой другой заблокированный выбор, даже когда список разрешал более старую версию.

165 165 

166Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) используют идентификаторы развёртывания, специфичные для поставщика, а не идентификаторы моделей Anthropic, поэтому заблокированный псевдоним там следует поведению отклонения и замены ниже.166Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) используют идентификаторы развёртывания, специфичные для поставщика, а не идентификаторы моделей Anthropic, поэтому заблокированный псевдоним там следует поведению отклонения и замены ниже.

167 167 

168Claude Code обрабатывает любой другой заблокированный выбор в соответствии с тем, где была установлена модель:168Claude Code обрабатывает любой другой заблокированный выбор в соответствии с тем, где была установлена модель:

169 169 


173* **параметр `advisorModel`**: советник отключается на время сеанса173* **параметр `advisorModel`**: советник отключается на время сеанса

174* **флаг `--advisor`**: Claude Code завершает работу с ошибкой при запуске174* **флаг `--advisor`**: Claude Code завершает работу с ошибкой при запуске

175 175 

176Исключённые модели скрыты из средства выбора `/model`. {/* min-version: 2.1.199 */}Полный идентификатор модели в списке, который не имеет встроенной строки средства выбора, такой как более старая версия, которую список закрепляет, появляется в средстве выбора `/model` как собственная помеченная строка. До v2.1.199 такой идентификатор доступен для выбора только путём ввода `/model <id>`.176Исключённые модели скрыты из средства выбора `/model`. Полный идентификатор модели в списке, который не имеет встроенной строки средства выбора, такой как более старая версия, которую список закрепляет, появляется в средстве выбора `/model` как собственная помеченная строка. До v2.1.199 такой идентификатор доступен для выбора только путём ввода `/model <id>`.

177 177 

178Изменения модели, которые Claude Code делает от вашего имени, проверяются таким же образом:178Изменения модели, которые Claude Code делает от вашего имени, проверяются таким же образом:

179 179 

180* **[Цепочки резервной модели](#fallback-model-chains)**: элементы вне списка разрешений удаляются180* **[Цепочки резервной модели](#fallback-model-chains)**: элементы вне списка разрешений удаляются

181* **Обновления режима планирования**: на API Anthropic и Claude Platform на AWS обновление, такое как [`opusplan`](#opusplan-model-setting) на исключённую модель, использует самую новую разрешённую версию семейства обновления. На поставщиках с идентификаторами моделей, специфичными для поставщика, и когда версия не разрешена, обновление пропускается и планирование продолжается на модели сеанса181* **Обновления режима планирования**: на API Anthropic и Claude Platform на AWS обновление, такое как [`opusplan`](#opusplan-model-setting) на исключённую модель, использует самую новую разрешённую версию семейства обновления. На поставщиках с идентификаторами моделей, специфичными для поставщика, и когда версия не разрешена, обновление пропускается и планирование продолжается на модели сеанса

182* **[Автоматический резервный вариант модели](#automatic-model-fallback)**: резервный вариант, целевая модель которого исключена, не выполняется, поэтому помеченный запрос заканчивается отказом182* **[Автоматический резервный вариант модели](#automatic-model-fallback)**: резервный вариант, целевая модель которого исключена, не выполняется, поэтому помеченный запрос заканчивается отказом

183* **[Быстрый режим](/ru/fast-mode)**: включение быстрого режима отклоняется, когда модель, на которой сеанс будет работать впоследствии, находится вне списка разрешений183* **[Быстрый режим](/docs/ru/fast-mode)**: включение быстрого режима отклоняется, когда модель, на которой сеанс будет работать впоследствии, находится вне списка разрешений

184 184 

185```json theme={null}185```json theme={null}

186{186{


196 196 

197| Механизм доставки | CLI и IDE | Локальные сеансы Desktop | Веб-сеансы, мобильные и облачные сеансы | Agent SDK и неинтерактивные | Cowork |197| Механизм доставки | CLI и IDE | Локальные сеансы Desktop | Веб-сеансы, мобильные и облачные сеансы | Agent SDK и неинтерактивные | Cowork |

198| :------------------------------------------------------------------------------------- | :---------- | :----------------------- | :-------------------------------------- | :-------------------------- | :------------------------- |198| :------------------------------------------------------------------------------------- | :---------- | :----------------------- | :-------------------------------------- | :-------------------------- | :------------------------- |

199| [Управляемые параметры сервера](/ru/server-managed-settings) из консоли администратора | Применяется | Применяется | Применяется | Применяется | Не доставляется |199| [Управляемые параметры сервера](/docs/ru/server-managed-settings) из консоли администратора | Применяется | Применяется | Применяется | Применяется | Не доставляется |

200| [MDM или управляемые файлы параметров](/ru/settings#settings-files) | Применяется | Применяется | Не доставляется | Применяется | Применяется где развёрнуто |200| [MDM или управляемые файлы параметров](/docs/ru/settings#settings-files) | Применяется | Применяется | Не доставляется | Применяется | Применяется где развёрнуто |

201 201 

202* Облачные сеансы на [Claude Code в веб-версии](/ru/claude-code-on-the-web) или в приложении Desktop работают на управляемых Anthropic виртуальных машинах: параметры, развёрнутые на вашем устройстве, не достигают их, поэтому доставляйте список разрешений через управляемые параметры сервера. Переключение модели в середине сеанса в облачном сеансе отклоняется, когда запрошенная модель исключена списком разрешений. Отклонение на стороне сервера при создании сеанса применяется к [ограничениям модели организации](#organization-model-restrictions), а не к ключу параметров `availableModels`.202* Облачные сеансы на [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) или в приложении Desktop работают на управляемых Anthropic виртуальных машинах: параметры, развёрнутые на вашем устройстве, не достигают их, поэтому доставляйте список разрешений через управляемые параметры сервера. Переключение модели в середине сеанса в облачном сеансе отклоняется, когда запрошенная модель исключена списком разрешений. Отклонение на стороне сервера при создании сеанса применяется к [ограничениям модели организации](#organization-model-restrictions), а не к ключу параметров `availableModels`.

203* Cowork, вкладка агентской работы в приложении Claude Desktop, не является поверхностью Claude Code и по замыслу не получает управляемые параметры сервера. Управляемый файл параметров применяется к сеансам Cowork, когда он присутствует там, где работает сеанс; удалённые сеансы Cowork работают на управляемых Anthropic виртуальных машинах, где развёрнутый на устройстве файл отсутствует.203* Cowork, вкладка агентской работы в приложении Claude Desktop, не является поверхностью Claude Code и по замыслу не получает управляемые параметры сервера. Управляемый файл параметров применяется к сеансам Cowork, когда он присутствует там, где работает сеанс; удалённые сеансы Cowork работают на управляемых Anthropic виртуальных машинах, где развёрнутый на устройстве файл отсутствует.

204* Сеансы на [сторонних поставщиках](/ru/server-managed-settings#platform-availability), таких как Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и [Claude Platform на AWS](/ru/claude-platform-on-aws), не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или управляемые файлы параметров там.204* Сеансы на [сторонних поставщиках](/docs/ru/server-managed-settings#platform-availability), таких как Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и [Claude Platform на AWS](/docs/ru/claude-platform-on-aws), не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или управляемые файлы параметров там.

205* Доставка, управляемая сервером, также требует, чтобы сеанс аутентифицировался с помощью входа в организацию или напрямую настроенного ключа API. Флоты, которые генерируют ключи только через скрипт [`apiKeyHelper`](/ru/settings#available-settings), должны доставлять список разрешений через MDM или управляемые файлы параметров.205* Доставка, управляемая сервером, также требует, чтобы сеанс аутентифицировался с помощью входа в организацию или напрямую настроенного ключа API. Флоты, которые генерируют ключи только через скрипт [`apiKeyHelper`](/docs/ru/settings#available-settings), должны доставлять список разрешений через MDM или управляемые файлы параметров.

206* Вкладка Desktop Code также размещает [SSH-сеансы](/ru/desktop#ssh-sessions), которые читают управляемый файл параметров с удалённого хоста, на котором они работают. См. [Управляемые параметры Desktop](/ru/desktop#managed-settings).206* Вкладка Desktop Code также размещает [SSH-сеансы](/docs/ru/desktop#ssh-sessions), которые читают управляемый файл параметров с удалённого хоста, на котором они работают. См. [Управляемые параметры Desktop](/docs/ru/desktop#managed-settings).

207* Средства выбора модели на claude.ai и в приложении Desktop скрывают или затемняют модели, исключённые списком разрешений вашей организации. Состояние средства выбора — это удобство для пользователей; применение происходит в сеансе.207* Средства выбора модели на claude.ai и в приложении Desktop скрывают или затемняют модели, исключённые списком разрешений вашей организации. Состояние средства выбора — это удобство для пользователей; применение происходит в сеансе.

208 208 

209<h3 id="default-model-behavior">209<h3 id="default-model-behavior">


231 231 

232`enforceAvailableModels` не имеет эффекта, когда `availableModels` не установлен или пуст: с `availableModels: []` модель Default для типа учётной записи остаётся пригодной для использования, поэтому параметр не может заблокировать пользователей от каждой модели. Когда `availableModels` непуст, но ни одна запись не разрешается на разрешённую и доступную модель, применение деградирует и Default переходит к значению по умолчанию для типа учётной записи с предупреждением, видимым только под `--debug`. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.232`enforceAvailableModels` не имеет эффекта, когда `availableModels` не установлен или пуст: с `availableModels: []` модель Default для типа учётной записи остаётся пригодной для использования, поэтому параметр не может заблокировать пользователей от каждой модели. Когда `availableModels` непуст, но ни одна запись не разрешается на разрешённую и доступную модель, применение деградирует и Default переходит к значению по умолчанию для типа учётной записи с предупреждением, видимым только под `--debug`. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.

233 233 

234Развёртывайте оба ключа в [источнике управляемых параметров с наивысшим приоритетом](/ru/settings#settings-precedence): развёрнутые администратором управляемые источники не объединяются, поэтому пара, размещённая в управляемом файле параметров, игнорируется, когда консоль администратора доставляет какие-либо параметры.234Развёртывайте оба ключа в [источнике управляемых параметров с наивысшим приоритетом](/docs/ru/settings#settings-precedence): развёрнутые администратором управляемые источники не объединяются, поэтому пара, размещённая в управляемом файле параметров, игнорируется, когда консоль администратора доставляет какие-либо параметры.

235 235 

236<h3 id="control-the-model-users-run-on">236<h3 id="control-the-model-users-run-on">

237 Управление моделью, на которой работают пользователи237 Управление моделью, на которой работают пользователи


265 Поведение слияния265 Поведение слияния

266</h3>266</h3>

267 267 

268Когда источник управляемых параметров с [наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) определяет `availableModels`, применяется только этот список: записи в параметрах пользователя, проекта или локальных параметрах не могут расширить его, и развёрнутые администратором управляемые источники не объединяются друг с другом, поэтому список, развёрнутый в управляемом файле параметров, игнорируется, когда управляемые параметры сервера доставляют какие-либо ключи. В противном случае списки из параметров пользователя, проекта и локальных параметров [объединяются и дедублицируются](/ru/settings#settings-precedence) как другие параметры массива. {/* min-version: 2.1.175 */}Начиная с Claude Code v2.1.175, управляемый список заменяет записи с более низким приоритетом; более ранние версии объединяют их.268Когда источник управляемых параметров с [наивысшим приоритетом](/docs/ru/server-managed-settings#settings-precedence) определяет `availableModels`, применяется только этот список: записи в параметрах пользователя, проекта или локальных параметрах не могут расширить его, и развёрнутые администратором управляемые источники не объединяются друг с другом, поэтому список, развёрнутый в управляемом файле параметров, игнорируется, когда управляемые параметры сервера доставляют какие-либо ключи. В противном случае списки из параметров пользователя, проекта и локальных параметров [объединяются и дедублицируются](/docs/ru/settings#settings-precedence) как другие параметры массива. Начиная с Claude Code v2.1.175, управляемый список заменяет записи с более низким приоритетом; более ранние версии объединяют их.

269 269 

270В пределах эффективного списка запись, называющая конкретную модель в семействе, будь то префикс версии или полный идентификатор модели, отключает запись подстановочного знака этого семейства: `["sonnet", "claude-sonnet-4-5"]` разрешает только версии Sonnet 4.5, а не каждую модель Sonnet.270В пределах эффективного списка запись, называющая конкретную модель в семействе, будь то префикс версии или полный идентификатор модели, отключает запись подстановочного знака этого семейства: `["sonnet", "claude-sonnet-4-5"]` разрешает только версии Sonnet 4.5, а не каждую модель Sonnet.

271 271 


273 Идентификаторы моделей Mantle273 Идентификаторы моделей Mantle

274</h3>274</h3>

275 275 

276Когда включена [конечная точка Bedrock Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint), записи в `availableModels`, начинающиеся с `anthropic.`, добавляются в средство выбора `/model` как пользовательские опции и маршрутизируются на конечную точку Mantle. Это исключение из сопоставления псевдонимов, описанного в [Закрепление моделей для развёртываний третьих сторон](#pin-models-for-third-party-deployments). Параметр всё ещё ограничивает средство выбора перечисленными записями, и идентификатор Mantle встраивает имя семейства, поэтому он считается конкретной записью и отключает запись подстановочного знака этого семейства: вместе с любыми идентификаторами Mantle перечислите префиксы версий или полные идентификаторы, которые вы хотите сохранить доступными для выбора. См. [Поведение слияния](#merge-behavior).276Когда включена [конечная точка Bedrock Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), записи в `availableModels`, начинающиеся с `anthropic.`, добавляются в средство выбора `/model` как пользовательские опции и маршрутизируются на конечную точку Mantle. Это исключение из сопоставления псевдонимов, описанного в [Закрепление моделей для развёртываний третьих сторон](#pin-models-for-third-party-deployments). Параметр всё ещё ограничивает средство выбора перечисленными записями, и идентификатор Mantle встраивает имя семейства, поэтому он считается конкретной записью и отключает запись подстановочного знака этого семейства: вместе с любыми идентификаторами Mantle перечислите префиксы версий или полные идентификаторы, которые вы хотите сохранить доступными для выбора. См. [Поведение слияния](#merge-behavior).

277 277 

278<h3 id="organization-model-restrictions">278<h3 id="organization-model-restrictions">

279 Ограничения модели организации279 Ограничения модели организации


283 283 

284Ограничение применяется, когда член входит в систему или использует свой собственный ключ API. Учётные данные, ограниченные организацией, такие как ключи служб организации, не привязаны к пользователю, поэтому ограничение не применяется к ним.284Ограничение применяется, когда член входит в систему или использует свой собственный ключ API. Учётные данные, ограниченные организацией, такие как ключи служб организации, не привязаны к пользователю, поэтому ограничение не применяется к ним.

285 285 

286Claude Console не имеет управления ограничением модели. Организации без плана Claude Enterprise, включая те, члены которых аутентифицируются через API Anthropic, ограничивают модели с помощью [`availableModels`](#restrict-model-selection) в [управляемых параметрах](/ru/settings#settings-files), добавляя [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) для охвата опции Default. Эти параметры применяются самим Claude Code, а не сервером.286Claude Console не имеет управления ограничением модели. Организации без плана Claude Enterprise, включая те, члены которых аутентифицируются через API Anthropic, ограничивают модели с помощью [`availableModels`](#restrict-model-selection) в [управляемых параметрах](/docs/ru/settings#settings-files), добавляя [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) для охвата опции Default. Эти параметры применяются самим Claude Code, а не сервером.

287 287 

288Ограниченная модель скрыта из средства выбора `/model`. Выбор её по имени с помощью `--model`, переменной окружения `ANTHROPIC_MODEL` или параметра `model` показывает уведомление `Model "<name>" is restricted by your organization's settings. Using <model> instead.` и сеанс начинается на разрешённой модели. Ввод `/model <name>` для ограниченной модели отклоняется с `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` и сеанс сохраняет свою текущую модель.288Ограниченная модель скрыта из средства выбора `/model`. Выбор её по имени с помощью `--model`, переменной окружения `ANTHROPIC_MODEL` или параметра `model` показывает уведомление `Model "<name>" is restricted by your organization's settings. Using <model> instead.` и сеанс начинается на разрешённой модели. Ввод `/model <name>` для ограниченной модели отклоняется с `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` и сеанс сохраняет свою текущую модель.

289 289 


296* Модели Haiku всегда доступны и не могут быть отключены, поэтому каждый член сохраняет по крайней мере одну пригодную для использования модель.296* Модели Haiku всегда доступны и не могут быть отключены, поэтому каждый член сохраняет по крайней мере одну пригодную для использования модель.

297* Изменение доступа вступает в силу для новых запросов в течение примерно минуты; средство выбора `/model` отражает это при следующем запуске сеанса.297* Изменение доступа вступает в силу для новых запросов в течение примерно минуты; средство выбора `/model` отражает это при следующем запуске сеанса.

298 298 

299Оба механизма применяются вместе: модель доступна для выбора только когда она разрешена `availableModels` и не ограничена организацией. Ограничения организации доставляются сеансам на API Anthropic и развёртываниях [LLM gateway](/ru/llm-gateway). Сеансы на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS не получают их, поэтому используйте `availableModels` на этих поставщиках вместо этого.299Оба механизма применяются вместе: модель доступна для выбора только когда она разрешена `availableModels` и не ограничена организацией. Ограничения организации доставляются сеансам на API Anthropic и развёртываниях [LLM gateway](/docs/ru/llm-gateway). Сеансы на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS не получают их, поэтому используйте `availableModels` на этих поставщиках вместо этого.

300 300 

301<h2 id="organization-default-model">301<h2 id="organization-default-model">

302 Модель по умолчанию организации302 Модель по умолчанию организации

303</h2>303</h2>

304 304 

305{/* plan-availability: feature=org-default-model plans=enterprise */}

306 

307Администраторы организации на планах Claude Enterprise могут установить модель по умолчанию для членов Claude Code из консоли администратора claude.ai, для всей организации или для каждой пользовательской роли. Когда она установлена, опция Default разрешается к этой модели вместо [значения по умолчанию для типа учётной записи](#default-model-setting). Требует Claude Code v2.1.196 или более поздней версии.305Администраторы организации на планах Claude Enterprise могут установить модель по умолчанию для членов Claude Code из консоли администратора claude.ai, для всей организации или для каждой пользовательской роли. Когда она установлена, опция Default разрешается к этой модели вместо [значения по умолчанию для типа учётной записи](#default-model-setting). Требует Claude Code v2.1.196 или более поздней версии.

308 306 

309Строка Default в средстве выбора `/model` показывает имя модели по умолчанию организации с меткой Org default. Метка читается как Org default независимо от того, установил ли администратор значение по умолчанию для всей организации или для вашей роли. Значение по умолчанию роли охватывает членов этой пользовательской роли и имеет приоритет над значением по умолчанию для всей организации; когда несколько ваших ролей устанавливают разные значения по умолчанию, применяется наиболее мощная модель.307Строка Default в средстве выбора `/model` показывает имя модели по умолчанию организации с меткой Org default. Метка читается как Org default независимо от того, установил ли администратор значение по умолчанию для всей организации или для вашей роли. Значение по умолчанию роли охватывает членов этой пользовательской роли и имеет приоритет над значением по умолчанию для всей организации; когда несколько ваших ролей устанавливают разные значения по умолчанию, применяется наиболее мощная модель.


311Модель по умолчанию организации является отправной точкой, а не ограничением, и любой другой выбор модели имеет приоритет над ней:309Модель по умолчанию организации является отправной точкой, а не ограничением, и любой другой выбор модели имеет приоритет над ней:

312 310 

313* флаг `--model` и переменная окружения `ANTHROPIC_MODEL`311* флаг `--model` и переменная окружения `ANTHROPIC_MODEL`

314* значение `model` в [управляемых параметрах](/ru/settings#settings-files) или предоставленное через `--settings`312* значение `model` в [управляемых параметрах](/docs/ru/settings#settings-files) или предоставленное через `--settings`

315* значение `model` в ваших пользовательских, проектных или локальных параметрах, включая модель, которую вы сохраняете с помощью `/model`313* значение `model` в ваших пользовательских, проектных или локальных параметрах, включая модель, которую вы сохраняете с помощью `/model`

316 314 

317Администраторы также могут настроить модель по умолчанию организации для переопределения выбора пользователя. При включении переопределения она имеет приоритет над значением `model` в пользовательских, проектных и локальных параметрах, поэтому модель, которую вы сохраняете с помощью `/model`, применяется для текущего сеанса, и модель по умолчанию организации возвращается при следующем запуске. Когда ваш выбор отличается, `/model` показывает `Your organization's default (<model>) applies on restart`. Флаг `--model`, `ANTHROPIC_MODEL`, управляемые параметры и `--settings` по-прежнему имеют приоритет даже при включённом переопределении. Переопределение доступно для ограниченного набора организаций; спросите о доступности у команды учетной записи Anthropic.315Администраторы также могут настроить модель по умолчанию организации для переопределения выбора пользователя. При включении переопределения она имеет приоритет над значением `model` в пользовательских, проектных и локальных параметрах, поэтому модель, которую вы сохраняете с помощью `/model`, применяется для текущего сеанса, и модель по умолчанию организации возвращается при следующем запуске. Когда ваш выбор отличается, `/model` показывает `Your organization's default (<model>) applies on restart`. Флаг `--model`, `ANTHROPIC_MODEL`, управляемые параметры и `--settings` по-прежнему имеют приоритет даже при включённом переопределении. Переопределение доступно для ограниченного набора организаций; спросите о доступности у команды учетной записи Anthropic.


326 324 

327* [`availableModels`](#restrict-model-selection) сам по себе никогда не ограничивает опцию Default, поэтому модель по умолчанию организации вне списка разрешений по-прежнему применяется. Когда также установлен [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model), модель по умолчанию организации вне списка разрешений переназначается на первую запись списка разрешений, как и любой другой Default325* [`availableModels`](#restrict-model-selection) сам по себе никогда не ограничивает опцию Default, поэтому модель по умолчанию организации вне списка разрешений по-прежнему применяется. Когда также установлен [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model), модель по умолчанию организации вне списка разрешений переназначается на первую запись списка разрешений, как и любой другой Default

328* модель по умолчанию организации, которую [ограничения модели организации](#organization-model-restrictions) отклоняют для вашей учётной записи, заменяется на самую новую разрешённую модель в её семействе, или на семейство с более низкой стоимостью, когда каждая версия его ограничена326* модель по умолчанию организации, которую [ограничения модели организации](#organization-model-restrictions) отклоняют для вашей учётной записи, заменяется на самую новую разрешённую модель в её семействе, или на семейство с более низкой стоимостью, когда каждая версия его ограничена

329* модель по умолчанию организации, которая вообще недоступна для вашей учётной записи, такая как Fable 5 при [нулевом сохранении данных](/ru/zero-data-retention), пропускается, и опция Default разрешается к значению по умолчанию для типа учётной записи327* модель по умолчанию организации, которая вообще недоступна для вашей учётной записи, такая как Fable 5 при [нулевом сохранении данных](/docs/ru/zero-data-retention), пропускается, и опция Default разрешается к значению по умолчанию для типа учётной записи

330 328 

331Начиная с версии v2.1.199, когда модель по умолчанию организации является другим семейством моделей от обычного значения по умолчанию для типа учётной записи, средство выбора `/model` сохраняет отдельную строку для этого обычного семейства, поэтому вы всё ещё можете переключиться на него для сеанса. В версиях v2.1.196 по v2.1.198 эта строка отсутствует в средстве выбора.329Начиная с версии v2.1.199, когда модель по умолчанию организации является другим семейством моделей от обычного значения по умолчанию для типа учётной записи, средство выбора `/model` сохраняет отдельную строку для этого обычного семейства, поэтому вы всё ещё можете переключиться на него для сеанса. В версиях v2.1.196 по v2.1.198 эта строка отсутствует в средстве выбора.

332 330 

333Модель по умолчанию организации доставляется сеансам, аутентифицированным с помощью API Anthropic. Сеансы на развёртываниях [LLM gateway](/ru/llm-gateway), Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS не получают её. Чтобы установить значение по умолчанию на этих развёртываниях, используйте ключ `model` в [управляемых параметрах](/ru/settings#settings-files) вместо этого.331Модель по умолчанию организации доставляется сеансам, аутентифицированным с помощью API Anthropic. Сеансы на развёртываниях [LLM gateway](/docs/ru/llm-gateway), Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS не получают её. Чтобы установить значение по умолчанию на этих развёртываниях, используйте ключ `model` в [управляемых параметрах](/docs/ru/settings#settings-files) вместо этого.

334 332 

335<h2 id="organization-effort-limits">333<h2 id="organization-effort-limits">

336 Ограничения усилий организации334 Ограничения усилий организации

337</h2>335</h2>

338 336 

339{/* plan-availability: feature=org-effort-limits plans=enterprise */}

340 

341Администраторы организации на планах Claude Enterprise могут установить максимальный [уровень усилий](#adjust-effort-level) для каждой модели для каждой пользовательской роли, наряду с [ограничениями модели организации](#organization-model-restrictions) на уровне роли. Уровни выше предела не предлагаются в средстве выбора `/effort`, и указание более высокого уровня с помощью `--effort` или `/effort` работает на пределе вместо этого. В интерактивных сеансах и простых текстовых запусках `--print` предупреждение называет запрошенный и применённый уровни; с выводом `json` или `stream-json` или в фоновых агентах зажим применяется молча. Пределы зависят от модели, поэтому переключение моделей может изменить, какие уровни доступны. Когда несколько ваших ролей предоставляют одну и ту же модель, применяется наименее ограничивающий предел. Требует Claude Code v2.1.195 или более поздней версии.337Администраторы организации на планах Claude Enterprise могут установить максимальный [уровень усилий](#adjust-effort-level) для каждой модели для каждой пользовательской роли, наряду с [ограничениями модели организации](#organization-model-restrictions) на уровне роли. Уровни выше предела не предлагаются в средстве выбора `/effort`, и указание более высокого уровня с помощью `--effort` или `/effort` работает на пределе вместо этого. В интерактивных сеансах и простых текстовых запусках `--print` предупреждение называет запрошенный и применённый уровни; с выводом `json` или `stream-json` или в фоновых агентах зажим применяется молча. Пределы зависят от модели, поэтому переключение моделей может изменить, какие уровни доступны. Когда несколько ваших ролей предоставляют одну и ту же модель, применяется наименее ограничивающий предел. Требует Claude Code v2.1.195 или более поздней версии.

342 338 

343Ограничения усилий доставляются вместе с [ограничениями модели организации](#organization-model-restrictions) и следуют той же доступности поставщика: сеансы на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS не получают их.339Ограничения усилий доставляются вместе с [ограничениями модели организации](#organization-model-restrictions) и следуют той же доступности поставщика: сеансы на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform на AWS не получают их.


359 355 

360Enterprise с оплатой по мере использования означает организацию Enterprise, выставляемую счет по использованию, а не по месту подписки.356Enterprise с оплатой по мере использования означает организацию Enterprise, выставляемую счет по использованию, а не по месту подписки.

361 357 

362{/* min-version: 2.1.207 */}До v2.1.207 `default` разрешался в Opus 4.7 на Claude Platform на AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.358До v2.1.207 `default` разрешался в Opus 4.7 на Claude Platform на AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.

363 359 

364Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается к этой модели вместо значения по умолчанию для типа учётной записи выше. Требует Claude Code v2.1.196 или более поздней версии.360Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается к этой модели вместо значения по умолчанию для типа учётной записи выше. Требует Claude Code v2.1.196 или более поздней версии.

365 361 


382 378 

383Когда [`availableModels`](#restrict-model-selection) исключает новейший Opus, но разрешает более старую версию, например `["sonnet", "claude-opus-4-6"]`, `opusplan` использует новейший разрешенный Opus для планирования и остается только на Sonnet, когда исключен каждый Opus. Сеанс Haiku, который обычно обновляется до Sonnet в режиме плана, аналогично использует новейший разрешенный Sonnet и остается на Haiku только когда исключен каждый Sonnet. До v2.1.205 режим плана оставался на модели сеанса всякий раз, когда исключалась новейшая версия семейства обновлений, даже когда список разрешений разрешал более старую версию.379Когда [`availableModels`](#restrict-model-selection) исключает новейший Opus, но разрешает более старую версию, например `["sonnet", "claude-opus-4-6"]`, `opusplan` использует новейший разрешенный Opus для планирования и остается только на Sonnet, когда исключен каждый Opus. Сеанс Haiku, который обычно обновляется до Sonnet в режиме плана, аналогично использует новейший разрешенный Sonnet и остается на Haiku только когда исключен каждый Sonnet. До v2.1.205 режим плана оставался на модели сеанса всякий раз, когда исключалась новейшая версия семейства обновлений, даже когда список разрешений разрешал более старую версию.

384 380 

385Подстановка более старой разрешенной версии применяется на Anthropic API и [Claude Platform на AWS](/ru/claude-platform-on-aws). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, чьи развертывания используют идентификаторы моделей, специфичные для поставщика, режим плана остается на модели сеанса всякий раз, когда исключается модель обновления.381Подстановка более старой разрешенной версии применяется на Anthropic API и [Claude Platform на AWS](/docs/ru/claude-platform-on-aws). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, чьи развертывания используют идентификаторы моделей, специфичные для поставщика, режим плана остается на модели сеанса всякий раз, когда исключается модель обновления.

386 382 

387Для гибридного подхода, при котором Claude решает в середине задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/ru/advisor).383Для гибридного подхода, при котором Claude решает в середине задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/docs/ru/advisor).

388 384 

389<h3 id="fallback-model-chains">385<h3 id="fallback-model-chains">

390 Цепочки резервных моделей386 Цепочки резервных моделей


400claude --fallback-model sonnet,haiku396claude --fallback-model sonnet,haiku

401```397```

402 398 

403Чтобы сохранить цепочку между сеансами, установите `fallbackModel` в [параметрах](/ru/settings) как массив:399Чтобы сохранить цепочку между сеансами, установите `fallbackModel` в [параметрах](/docs/ru/settings) как массив:

404 400 

405```json theme={null}401```json theme={null}

406{402{


421 417 

422Этот раздел охватывает резервный вариант на основе содержимого из Fable 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).418Этот раздел охватывает резервный вариант на основе содержимого из Fable 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).

423 419 

424Fable 5 работает с классификаторами безопасности для содержимого кибербезопасности и биологии. Когда классификатор помечает запрос, Claude Code повторно запускает этот запрос на модели Opus вашего поставщика по умолчанию и показывает уведомление в стенограмме. На Anthropic API, развертываниях [LLM gateway](/ru/llm-gateway) и [Claude Platform на AWS](/ru/claude-platform-on-aws) эта модель — Opus 4.8. На [шлюзе приложений Claude](/ru/claude-apps-gateway) это Opus 4.7, если вы не указываете [псевдоним `opus`](#environment-variables) на другую модель.420Fable 5 работает с классификаторами безопасности для содержимого кибербезопасности и биологии. Когда классификатор помечает запрос, Claude Code повторно запускает этот запрос на модели Opus вашего поставщика по умолчанию и показывает уведомление в стенограмме. На Anthropic API, развертываниях [LLM gateway](/docs/ru/llm-gateway) и [Claude Platform на AWS](/docs/ru/claude-platform-on-aws) эта модель — Opus 4.8. На [шлюзе приложений Claude](/docs/ru/claude-apps-gateway) это Opus 4.7, если вы не указываете [псевдоним `opus`](#environment-variables) на другую модель.

425 421 

426Сеанс затем продолжается на этой модели Opus. Чтобы вернуться к Fable 5, запустите `/model fable`.422Сеанс затем продолжается на этой модели Opus. Чтобы вернуться к Fable 5, запустите `/model fable`.

427 423 


444Некоторые случаи ведут себя иначе:440Некоторые случаи ведут себя иначе:

445 441 

446* Если обе модели помечают один и тот же запрос, вы можете отредактировать подсказку и повторить попытку, или начать новый сеанс.442* Если обе модели помечают один и тот же запрос, вы можете отредактировать подсказку и повторить попытку, или начать новый сеанс.

447* На мобильных сеансах [Claude Code в веб-браузере](/ru/claude-code-on-the-web) редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сеанс из браузера рабочего стола или приложения рабочего стола.443* На мобильных сеансах [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web) редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сеанс из браузера рабочего стола или приложения рабочего стола.

448* В [неинтерактивном режиме](/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, помеченный запрос завершает ход с отказом вместо этого.444* В [неинтерактивном режиме](/docs/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, помеченный запрос завершает ход с отказом вместо этого.

449* Когда цель резервного варианта заблокирована [`availableModels`](#restrict-model-selection), подсказка не показывается. Помеченный запрос завершается с отказом, так же как автоматический резервный вариант, когда цель заблокирована.445* Когда цель резервного варианта заблокирована [`availableModels`](#restrict-model-selection), подсказка не показывается. Помеченный запрос завершается с отказом, так же как автоматический резервный вариант, когда цель заблокирована.

450 446 

451<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">447<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

452 Включение резервного варианта на Bedrock, Agent Platform и Foundry448 Включение резервного варианта на Bedrock, Agent Platform и Foundry

453</h4>449</h4>

454 450 

455На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) и [Microsoft Foundry](/ru/microsoft-foundry) идентификаторы моделей зависят от поставщика, поэтому автоматический резервный вариант работает только, когда Claude Code может идентифицировать обе задействованные модели:451На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей зависят от поставщика, поэтому автоматический резервный вариант работает только, когда Claude Code может идентифицировать обе задействованные модели:

456 452 

457* Claude Code должен распознавать текущую модель как Fable 5: идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version).453* Claude Code должен распознавать текущую модель как Fable 5: идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version).

458* Цель резервного варианта должна разрешаться в модель Opus: значение `ANTHROPIC_DEFAULT_OPUS_MODEL`, если установлено, в противном случае запись Opus 4.8 в списке моделей поставщика.454* Цель резервного варианта должна разрешаться в модель Opus: значение `ANTHROPIC_DEFAULT_OPUS_MODEL`, если установлено, в противном случае запись Opus 4.8 в списке моделей поставщика.


487 483 

488Когда вы впервые запускаете Fable 5, Opus 4.8 или Opus 4.7, Claude Code применяет усилие по умолчанию этой модели, даже если вы ранее установили другой уровень для другой модели: `high` на Fable 5 и Opus 4.8, и `xhigh` на Opus 4.7. Запустите `/effort` снова, чтобы выбрать другой уровень после переключения. Это значение по умолчанию сохраняется между сеансами, пока вы не сделаете явный выбор усилий, такой как запуск `/effort` в интерактивном сеансе или запуск с `--effort`.484Когда вы впервые запускаете Fable 5, Opus 4.8 или Opus 4.7, Claude Code применяет усилие по умолчанию этой модели, даже если вы ранее установили другой уровень для другой модели: `high` на Fable 5 и Opus 4.8, и `xhigh` на Opus 4.7. Запустите `/effort` снова, чтобы выбрать другой уровень после переключения. Это значение по умолчанию сохраняется между сеансами, пока вы не сделаете явный выбор усилий, такой как запуск `/effort` в интерактивном сеансе или запуск с `--effort`.

489 485 

490`low`, `medium`, `high` и `xhigh` сохраняются между сеансами, когда вы устанавливаете их в интерактивном сеансе. {/* min-version: 2.1.205 */}Уровень, установленный с помощью `/effort` в [неинтерактивном режиме](/ru/headless), с флагом `-p`, применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию. Неинтерактивный `/effort` также не может отменить удержание модели по умолчанию выше: на Fable 5, Opus 4.8 и Opus 4.7 он сообщает `Not applied` и сеанс остается на усилии модели по умолчанию, поэтому вместо этого передайте `--effort` при запуске. `max` обеспечивает самое глубокое рассуждение без ограничений на расходование токенов и применяется только к текущему сеансу, кроме случаев, когда установлено через переменную окружения `CLAUDE_CODE_EFFORT_LEVEL`.486`low`, `medium`, `high` и `xhigh` сохраняются между сеансами, когда вы устанавливаете их в интерактивном сеансе. Уровень, установленный с помощью `/effort` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, применяется только к текущему сеансу и не сохраняется как ваше значение по умолчанию. Неинтерактивный `/effort` также не может отменить удержание модели по умолчанию выше: на Fable 5, Opus 4.8 и Opus 4.7 он сообщает `Not applied` и сеанс остается на усилии модели по умолчанию, поэтому вместо этого передайте `--effort` при запуске. `max` обеспечивает самое глубокое рассуждение без ограничений на расходование токенов и применяется только к текущему сеансу, кроме случаев, когда установлено через переменную окружения `CLAUDE_CODE_EFFORT_LEVEL`.

491 487 

492Меню `/effort` также предлагает `ultracode`. Ultracode — это параметр Claude Code, а не уровень усилий модели: он отправляет `xhigh` модели и дополнительно позволяет Claude организовать [динамические рабочие процессы](/ru/workflows) для существенных задач. Применяется только к текущему сеансу.488Меню `/effort` также предлагает `ultracode`. Ultracode — это параметр Claude Code, а не уровень усилий модели: он отправляет `xhigh` модели и дополнительно позволяет Claude организовать [динамические рабочие процессы](/docs/ru/workflows) для существенных задач. Применяется только к текущему сеансу.

493 489 

494Вы можете включить ultracode любым из следующих способов:490Вы можете включить ultracode любым из следующих способов:

495 491 

496* **`/effort`**: запустите `/effort ultracode` или выберите его из меню492* **`/effort`**: запустите `/effort ultracode` или выберите его из меню

497* **Флаг `--effort`**: запустите с `claude --effort ultracode`, что запускает сеанс с усилием `xhigh` и включенным ultracode493* **Флаг `--effort`**: запустите с `claude --effort ultracode`, что запускает сеанс с усилием `xhigh` и включенным ultracode

498* **`--settings` или запрос управления Agent SDK**: передайте `"ultracode": true`. Запрос [`applyFlagSettings()`](/ru/agent-sdk/typescript#applyflagsettings) также принимает `effortLevel: "ultracode"`494* **`--settings` или запрос управления Agent SDK**: передайте `"ultracode": true`. Запрос [`applyFlagSettings()`](/docs/ru/agent-sdk/typescript#applyflagsettings) также принимает `effortLevel: "ultracode"`

499 495 

500Передача `ultracode` флагу `--effort` или значению Agent SDK `effortLevel` требует Claude Code v2.1.203 или более поздней версии. До v2.1.203 `--effort ultracode` выводил `Unknown --effort value 'ultracode'` и сеанс начинался с усилия по умолчанию.496Передача `ultracode` флагу `--effort` или значению Agent SDK `effortLevel` требует Claude Code v2.1.203 или более поздней версии. До v2.1.203 `--effort ultracode` выводил `Unknown --effort value 'ultracode'` и сеанс начинался с усилия по умолчанию.

501 497 

502Сохраненный параметр `effortLevel` и переменная окружения `CLAUDE_CODE_EFFORT_LEVEL` не принимают `ultracode`.498Сохраненный параметр `effortLevel` и переменная окружения `CLAUDE_CODE_EFFORT_LEVEL` не принимают `ultracode`.

503 499 

504Когда ultracode недоступен, например когда [рабочие процессы отключены](/ru/workflows#turn-workflows-off), `--effort ultracode` устанавливает только усилие `xhigh`.500Когда ultracode недоступен, например когда [рабочие процессы отключены](/docs/ru/workflows#turn-workflows-off), `--effort ultracode` устанавливает только усилие `xhigh`.

505 501 

506<h4 id="choose-an-effort-level">502<h4 id="choose-an-effort-level">

507 Выбор уровня усилий503 Выбор уровня усилий


516| `high` | Балансирует использование токенов и интеллект. По умолчанию на Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 и Sonnet 4.6 |512| `high` | Балансирует использование токенов и интеллект. По умолчанию на Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 и Sonnet 4.6 |

517| `xhigh` | Более глубокое рассуждение при более высоком расходовании токенов. По умолчанию на Opus 4.7 |513| `xhigh` | Более глубокое рассуждение при более высоком расходовании токенов. По умолчанию на Opus 4.7 |

518| `max` | Может улучшить производительность на сложных задачах, но может показать убывающую отдачу и склонен к переосмыслению. Протестируйте перед широким внедрением |514| `max` | Может улучшить производительность на сложных задачах, но может показать убывающую отдачу и склонен к переосмыслению. Протестируйте перед широким внедрением |

519| `ultracode` | Параметр Claude Code, который планирует [динамический рабочий процесс](/ru/workflows) для каждой существенной задачи с рассуждением `xhigh` для каждого сообщения. Только для сеанса |515| `ultracode` | Параметр Claude Code, который планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи с рассуждением `xhigh` для каждого сообщения. Только для сеанса |

520 516 

521Шкала усилий откалибрована для каждой модели, поэтому одно и то же имя уровня не представляет одно и то же базовое значение в разных моделях.517Шкала усилий откалибрована для каждой модели, поэтому одно и то же имя уровня не представляет одно и то же базовое значение в разных моделях.

522 518 


537* **Флаг `--effort`**: передайте имя уровня для установки его на один сеанс при запуске Claude Code533* **Флаг `--effort`**: передайте имя уровня для установки его на один сеанс при запуске Claude Code

538* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` на имя уровня или `auto`534* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` на имя уровня или `auto`

539* **Параметры**: установите `effortLevel` в `low`, `medium`, `high` или `xhigh` в файле параметров. `max` и `ultracode` являются [только для сеанса](#adjust-effort-level) и не принимаются здесь535* **Параметры**: установите `effortLevel` в `low`, `medium`, `high` или `xhigh` в файле параметров. `max` и `ultracode` являются [только для сеанса](#adjust-effort-level) и не принимаются здесь

540* **Frontmatter skill и subagent**: установите `effort` в файле markdown [skill](/ru/skills#frontmatter-reference) или [subagent](/ru/sub-agents#supported-frontmatter-fields) для переопределения уровня усилий при запуске этого skill или subagent536* **Frontmatter skill и subagent**: установите `effort` в файле markdown [skill](/docs/ru/skills#frontmatter-reference) или [subagent](/docs/ru/sub-agents#supported-frontmatter-fields) для переопределения уровня усилий при запуске этого skill или subagent

541 537 

542Переменная окружения имеет приоритет над всеми другими методами, затем ваш настроенный уровень, затем значение по умолчанию модели. Frontmatter усилие применяется, когда этот skill или subagent активен, переопределяя уровень сеанса, но не переменную окружения.538Переменная окружения имеет приоритет над всеми другими методами, затем ваш настроенный уровень, затем значение по умолчанию модели. Frontmatter усилие применяется, когда этот skill или subagent активен, переопределяя уровень сеанса, но не переменную окружения.

543 539 


551 547 

552Fable 5, Sonnet 5 и Opus 4.7 и более поздние версии всегда используют адаптивное рассуждение. Режим фиксированного бюджета мышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` не применяются к ним.548Fable 5, Sonnet 5 и Opus 4.7 и более поздние версии всегда используют адаптивное рассуждение. Режим фиксированного бюджета мышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` не применяются к ним.

553 549 

554На Opus 4.6 и Sonnet 4.6 вы можете установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` для возврата к предыдущему фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/ru/env-vars).550На Opus 4.6 и Sonnet 4.6 вы можете установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` для возврата к предыдущему фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/docs/ru/env-vars).

555 551 

556<h3 id="extended-thinking">552<h3 id="extended-thinking">

557 Расширенное мышление553 Расширенное мышление


563| :------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |559| :------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

564| Переключение для текущего сеанса | Нажмите `Option+T` на macOS или `Alt+T` на Windows и Linux |560| Переключение для текущего сеанса | Нажмите `Option+T` на macOS или `Alt+T` на Windows и Linux |

565| Установка глобального значения по умолчанию | Запустите `/config` и переключите режим мышления. Сохраняется как `alwaysThinkingEnabled` в `~/.claude/settings.json` |561| Установка глобального значения по умолчанию | Запустите `/config` и переключите режим мышления. Сохраняется как `alwaysThinkingEnabled` в `~/.claude/settings.json` |

566| Отключение независимо от усилий | Установите [`MAX_THINKING_TOKENS=0`](/ru/env-vars), что отключает мышление на Anthropic API, кроме Fable 5. На [поставщиках третьих сторон](/ru/third-party-integrations) это опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения могут все ещё думать. Другие значения применяются только с [фиксированным бюджетом мышления](#adaptive-reasoning-and-fixed-thinking-budgets) |562| Отключение независимо от усилий | Установите [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает мышление на Anthropic API, кроме Fable 5. На [поставщиках третьих сторон](/docs/ru/third-party-integrations) это опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения могут все ещё думать. Другие значения применяются только с [фиксированным бюджетом мышления](#adaptive-reasoning-and-fixed-thinking-budgets) |

567 563 

568Мышление не может быть отключено на Fable 5. Переключение сеанса, `alwaysThinkingEnabled` и `MAX_THINKING_TOKENS=0` не имеют там никакого эффекта, и Fable 5 решает на каждом шаге, сколько думать на основе уровня усилий.564Мышление не может быть отключено на Fable 5. Переключение сеанса, `alwaysThinkingEnabled` и `MAX_THINKING_TOKENS=0` не имеют там никакого эффекта, и Fable 5 решает на каждом шаге, сколько думать на основе уровня усилий.

569 565 

570Вывод мышления свернут по умолчанию. Нажмите `Ctrl+O` для переключения режима подробности и просмотра рассуждения как серого курсивного текста. Интерактивные сеансы на Anthropic API получают отредактированные блоки мышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/ru/settings), если вы хотите, чтобы полные резюме были доступны при развертывании. Вам выставляется счет за все сгенерированные токены мышления, даже если они свернуты или отредактированы.566Вывод мышления свернут по умолчанию. Нажмите `Ctrl+O` для переключения режима подробности и просмотра рассуждения как серого курсивного текста. Интерактивные сеансы на Anthropic API получают отредактированные блоки мышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/docs/ru/settings), если вы хотите, чтобы полные резюме были доступны при развертывании. Вам выставляется счет за все сгенерированные токены мышления, даже если они свернуты или отредактированы.

571 567 

572<h3 id="extended-context">568<h3 id="extended-context">

573 Расширенный контекст569 Расширенный контекст


583| Pro | Требует [дополнительного использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Требует [дополнительного использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |579| Pro | Требует [дополнительного использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Требует [дополнительного использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

584| API и оплата по мере использования | Полный доступ | Полный доступ |580| API и оплата по мере использования | Полный доступ | Полный доступ |

585 581 

586Чтобы полностью отключить контекст 1M, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Это удаляет варианты моделей 1M из средства выбора модели. См. [переменные окружения](/ru/env-vars).582Чтобы полностью отключить контекст 1M, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Это удаляет варианты моделей 1M из средства выбора модели. См. [переменные окружения](/docs/ru/env-vars).

587 583 

588Контекстное окно 1M использует стандартное ценообразование модели без премии за токены сверх 200K. Для планов, где расширенный контекст включен в вашу подписку, использование остается покрытым вашей подпиской. Для планов, которые получают доступ к расширенному контексту через дополнительное использование, токены выставляются в счет дополнительного использования.584Контекстное окно 1M использует стандартное ценообразование модели без премии за токены сверх 200K. Для планов, где расширенный контекст включен в вашу подписку, использование остается покрытым вашей подпиской. Для планов, которые получают доступ к расширенному контексту через дополнительное использование, токены выставляются в счет дополнительного использования.

589 585 


604 Контекстное окно Sonnet 5600 Контекстное окно Sonnet 5

605</h4>601</h4>

606 602 

607На Anthropic API Sonnet 5 всегда работает с контекстным окном 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора, и дополнительное использование не требуется ни на одном плане. Сеансы автоматически сжимаются до заполнения окна, по умолчанию примерно при 967K токенов; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/ru/env-vars), чтобы выбрать другой порог.603На Anthropic API Sonnet 5 всегда работает с контекстным окном 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора, и дополнительное использование не требуется ни на одном плане. Сеансы автоматически сжимаются до заполнения окна, по умолчанию примерно при 967K токенов; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars), чтобы выбрать другой порог.

608 604 

609Две конфигурации вместо этого ограничивают окно значением 200K и автоматически сжимают на этой границе:605Две конфигурации вместо этого ограничивают окно значением 200K и автоматически сжимают на этой границе:

610 606 

611* **LLM gateway**: когда `ANTHROPIC_BASE_URL` указывает на [шлюз](/ru/llm-gateway), Claude Code не может проверить поддержку 1M. Чтобы использовать полное окно, выберите Sonnet 5 (1M context) в средстве выбора модели, что соответствует `sonnet[1m]`.607* **LLM gateway**: когда `ANTHROPIC_BASE_URL` указывает на [шлюз](/docs/ru/llm-gateway), Claude Code не может проверить поддержку 1M. Чтобы использовать полное окно, выберите Sonnet 5 (1M context) в средстве выбора модели, что соответствует `sonnet[1m]`.

612* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: обрабатывает сеансы Sonnet 5 как имеющие окно 200K, для развертываний, которым нужно ограничить контекст.608* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: обрабатывает сеансы Sonnet 5 как имеющие окно 200K, для развертываний, которым нужно ограничить контекст.

613 609 

614<h2 id="checking-your-current-model">610<h2 id="checking-your-current-model">


617 613 

618Вы можете увидеть, какую модель вы используете в настоящее время, в двух местах:614Вы можете увидеть, какую модель вы используете в настоящее время, в двух местах:

619 615 

620* В [строке состояния](/ru/statusline), если у вас она настроена616* В [строке состояния](/docs/ru/statusline), если у вас она настроена

621* В `/status`, который также отображает информацию вашей учетной записи617* В `/status`, который также отображает информацию вашей учетной записи

622 618 

623<h2 id="add-a-custom-model-option">619<h2 id="add-a-custom-model-option">

624 Добавление пользовательского варианта модели620 Добавление пользовательского варианта модели

625</h2>621</h2>

626 622 

627Используйте `ANTHROPIC_CUSTOM_MODEL_OPTION` для добавления одной пользовательской записи в средство выбора `/model` без замены встроенных псевдонимов. Это полезно для тестирования идентификаторов моделей, которые Claude Code не указывает по умолчанию. Для развертываний шлюза LLM Claude Code может заполнять средство выбора из конечной точки `/v1/models` шлюза, когда установлено значение `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`, поэтому эта переменная требуется только в том случае, если обнаружение отключено или не возвращает нужную вам модель. См. [обнаружение модели шлюза](/ru/llm-gateway-protocol#model-discovery).623Используйте `ANTHROPIC_CUSTOM_MODEL_OPTION` для добавления одной пользовательской записи в средство выбора `/model` без замены встроенных псевдонимов. Это полезно для тестирования идентификаторов моделей, которые Claude Code не указывает по умолчанию. Для развертываний шлюза LLM Claude Code может заполнять средство выбора из конечной точки `/v1/models` шлюза, когда установлено значение `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`, поэтому эта переменная требуется только в том случае, если обнаружение отключено или не возвращает нужную вам модель. См. [обнаружение модели шлюза](/docs/ru/llm-gateway-protocol#model-discovery).

628 624 

629Этот пример устанавливает все три переменные, чтобы сделать развертывание Opus с маршрутизацией через шлюз выбираемым:625Этот пример устанавливает все три переменные, чтобы сделать развертывание Opus с маршрутизацией через шлюз выбираемым:

630 626 


649| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Модель для использования для `fable`, и идентификатор модели, который Claude Code распознает как Fable 5 для [автоматического переключения модели](#automatic-model-fallback) у поставщиков третьих сторон |645| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Модель для использования для `fable`, и идентификатор модели, который Claude Code распознает как Fable 5 для [автоматического переключения модели](#automatic-model-fallback) у поставщиков третьих сторон |

650| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Модель для использования для `opus`, или для `opusplan` при активном Plan Mode. |646| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Модель для использования для `opus`, или для `opusplan` при активном Plan Mode. |

651| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Модель для использования для `sonnet`, или для `opusplan` при неактивном Plan Mode. |647| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Модель для использования для `sonnet`, или для `opusplan` при неактивном Plan Mode. |

652| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования для `haiku`, или [фоновой функциональности](/ru/costs#background-token-usage) |648| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования для `haiku`, или [фоновой функциональности](/docs/ru/costs#background-token-usage) |

653| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель для использования для всех [subagents](/ru/sub-agents#choose-a-model), [agent teams](/ru/agent-teams) и агентов, которые запускает [workflow](/ru/workflows). Принимает псевдоним, такой как `haiku`, или полное имя модели, и переопределяет параметр `model` для каждого вызова и frontmatter `model` определения subagent. Установите на `inherit` для использования обычного разрешения модели вместо этого |649| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель для использования для всех [subagents](/docs/ru/sub-agents#choose-a-model), [agent teams](/docs/ru/agent-teams) и агентов, которые запускает [workflow](/docs/ru/workflows). Принимает псевдоним, такой как `haiku`, или полное имя модели, и переопределяет параметр `model` для каждого вызова и frontmatter `model` определения subagent. Установите на `inherit` для использования обычного разрешения модели вместо этого |

654 650 

655Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.651Примечание: `ANTHROPIC_SMALL_FAST_MODEL` устарел в пользу `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

656 652 


658 Закрепление моделей для развертываний третьих сторон654 Закрепление моделей для развертываний третьих сторон

659</h3>655</h3>

660 656 

661При развертывании Claude Code через [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) или [Claude Platform on AWS](/ru/claude-platform-on-aws) закрепите версии моделей перед развертыванием для пользователей.657При развертывании Claude Code через [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) или [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) закрепите версии моделей перед развертыванием для пользователей.

662 658 

663Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются в встроенный идентификатор модели по умолчанию для каждого поставщика. Это значение по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую оно указывает, может быть еще не включена в учетную запись пользователя. Когда значение по умолчанию недоступно, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление и сеанс переходит на более раннюю версию модели по умолчанию, или на модель Sonnet по умолчанию, когда значение по умолчанию является моделью Opus и нет доступной версии Opus. Пользователи Microsoft Foundry видят ошибки вместо этого, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.659Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются в встроенный идентификатор модели по умолчанию для каждого поставщика. Это значение по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую оно указывает, может быть еще не включена в учетную запись пользователя. Когда значение по умолчанию недоступно, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление и сеанс переходит на более раннюю версию модели по умолчанию, или на модель Sonnet по умолчанию, когда значение по умолчанию является моделью Opus и нет доступной версии Opus. Пользователи Microsoft Foundry видят ошибки вместо этого, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.

664 660 


689* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.685* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.

690 686 

691<Note>687<Note>

692 Список разрешений `availableModels`, доставленный через [MDM или управляемый файл параметров](/ru/settings#settings-files), все ещё применяется при использовании поставщиков третьих сторон; [параметры, управляемые сервером, не доставляются туда](/ru/server-managed-settings#platform-availability). Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются, поэтому для разрешения конкретной модели укажите ту же форму идентификатора поставщика, которую показывает средство выбора, или отобразите ее через [`modelOverrides`](#override-model-ids-per-version). Любой суффикс `[1m]` удаляется как из записи списка разрешений, так и из запрашиваемой модели перед сопоставлением.688 Список разрешений `availableModels`, доставленный через [MDM или управляемый файл параметров](/docs/ru/settings#settings-files), все ещё применяется при использовании поставщиков третьих сторон; [параметры, управляемые сервером, не доставляются туда](/docs/ru/server-managed-settings#platform-availability). Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются, поэтому для разрешения конкретной модели укажите ту же форму идентификатора поставщика, которую показывает средство выбора, или отобразите ее через [`modelOverrides`](#override-model-ids-per-version). Любой суффикс `[1m]` удаляется как из записи списка разрешений, так и из запрашиваемой модели перед сопоставлением.

693</Note>689</Note>

694 690 

695<h3 id="customize-pinned-model-display-and-capabilities">691<h3 id="customize-pinned-model-display-and-capabilities">


698 694 

699Когда вы закрепляете модель у поставщика третьей стороны, идентификатор, специфичный для поставщика, отображается как есть в средстве выбора `/model`, и Claude Code может не распознать, какие функции поддерживает модель. Вы можете переопределить отображаемое имя и объявить возможности с помощью вспомогательных переменных окружения для каждой закрепленной модели.695Когда вы закрепляете модель у поставщика третьей стороны, идентификатор, специфичный для поставщика, отображается как есть в средстве выбора `/model`, и Claude Code может не распознать, какие функции поддерживает модель. Вы можете переопределить отображаемое имя и объявить возможности с помощью вспомогательных переменных окружения для каждой закрепленной модели.

700 696 

701Эти переменные вступают в силу у поставщиков третьих сторон, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Переменные `_NAME` и `_DESCRIPTION` также вступают в силу, когда `ANTHROPIC_BASE_URL` указывает на [LLM gateway](/ru/llm-gateway). Они не имеют эффекта при прямом подключении к `api.anthropic.com`.697Эти переменные вступают в силу у поставщиков третьих сторон, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Переменные `_NAME` и `_DESCRIPTION` также вступают в силу, когда `ANTHROPIC_BASE_URL` указывает на [LLM gateway](/docs/ru/llm-gateway). Они не имеют эффекта при прямом подключении к `api.anthropic.com`.

702 698 

703| Переменная окружения | Описание |699| Переменная окружения | Описание |

704| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |700| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |


713| Значение возможности | Включает |709| Значение возможности | Включает |

714| ---------------------- | -------------------------------------------------------------------------------------------- |710| ---------------------- | -------------------------------------------------------------------------------------------- |

715| `effort` | [Уровни усилий](#adjust-effort-level) и команду `/effort` |711| `effort` | [Уровни усилий](#adjust-effort-level) и команду `/effort` |

716| `xhigh_effort` | {/* min-version: 2.1.111 */}Уровень усилий `xhigh` |712| `xhigh_effort` | Уровень усилий `xhigh` |

717| `max_effort` | Уровень усилий `max` |713| `max_effort` | Уровень усилий `max` |

718| `thinking` | [Расширенное мышление](#extended-thinking) |714| `thinking` | [Расширенное мышление](#extended-thinking) |

719| `adaptive_thinking` | Адаптивное рассуждение, которое динамически распределяет мышление на основе сложности задачи |715| `adaptive_thinking` | Адаптивное рассуждение, которое динамически распределяет мышление на основе сложности задачи |


740 736 

741Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода Amazon Bedrock, имя версии Google Cloud's Agent Platform или имя развертывания Microsoft Foundry для управления, распределения затрат или региональной маршрутизации.737Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода Amazon Bedrock, имя версии Google Cloud's Agent Platform или имя развертывания Microsoft Foundry для управления, распределения затрат или региональной маршрутизации.

742 738 

743Установите `modelOverrides` в [файле параметров](/ru/settings#settings-files):739Установите `modelOverrides` в [файле параметров](/docs/ru/settings#settings-files):

744 740 

745```json theme={null}741```json theme={null}

746{742{


756 752 

757Переопределения заменяют встроенные идентификаторы моделей, которые поддерживают каждую запись в средстве выбора `/model`. На Amazon Bedrock переопределения имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Claude Code передает значения, которые уже являются специфичными для поставщика, такие как ARN профиля вывода Amazon Bedrock или имена развертывания Microsoft Foundry, поставщику как есть.753Переопределения заменяют встроенные идентификаторы моделей, которые поддерживают каждую запись в средстве выбора `/model`. На Amazon Bedrock переопределения имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Claude Code передает значения, которые уже являются специфичными для поставщика, такие как ARN профиля вывода Amazon Bedrock или имена развертывания Microsoft Foundry, поставщику как есть.

758 754 

759{/* min-version: 2.1.200 */}Переопределения также применяются, когда вы передаете идентификатор модели Anthropic непосредственно через `--model`, переменную окружения `ANTHROPIC_MODEL` или переменную окружения `ANTHROPIC_DEFAULT_*_MODEL`. На Amazon Bedrock, Google Cloud's Agent Platform и [Mantle](/ru/amazon-bedrock#use-the-mantle-endpoint) идентификатор модели Anthropic без записи `modelOverrides` разрешается в тот же идентификатор, специфичный для поставщика, что и строка средства выбора `/model` для этой версии, когда поставщик поддерживает эту версию. Mantle поддерживает подмножество версий. Для идентификатора модели Anthropic вне этого подмножества Claude Code отправляет необработанный идентификатор Mantle без отображения, если только запись `modelOverrides` не охватывает его. До версии 2.1.200 значения `--model` и переменных окружения достигали поставщика как есть без прохождения через карту переопределений.755Переопределения также применяются, когда вы передаете идентификатор модели Anthropic непосредственно через `--model`, переменную окружения `ANTHROPIC_MODEL` или переменную окружения `ANTHROPIC_DEFAULT_*_MODEL`. На Amazon Bedrock, Google Cloud's Agent Platform и [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) идентификатор модели Anthropic без записи `modelOverrides` разрешается в тот же идентификатор, специфичный для поставщика, что и строка средства выбора `/model` для этой версии, когда поставщик поддерживает эту версию. Mantle поддерживает подмножество версий. Для идентификатора модели Anthropic вне этого подмножества Claude Code отправляет необработанный идентификатор Mantle без отображения, если только запись `modelOverrides` не охватывает его. До версии 2.1.200 значения `--model` и переменных окружения достигали поставщика как есть без прохождения через карту переопределений.

760 756 

761`modelOverrides` работает вместе с `availableModels`. Список разрешений оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как `"opus"` в `availableModels`, продолжает совпадать, даже когда версии Opus отображаются на ARN. Когда `enforceAvailableModels` установлен в управляемых параметрах, принудительное значение Default разрешается через `modelOverrides` из [источника управляемых параметров с наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) только. Отображение администратора, такое как версия, закрепленная на ARN профиля вывода, соблюдается в принудительном Default. Переопределения из параметров пользователя или проекта не влияют на него.757`modelOverrides` работает вместе с `availableModels`. Список разрешений оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как `"opus"` в `availableModels`, продолжает совпадать, даже когда версии Opus отображаются на ARN. Когда `enforceAvailableModels` установлен в управляемых параметрах, принудительное значение Default разрешается через `modelOverrides` из [источника управляемых параметров с наивысшим приоритетом](/docs/ru/server-managed-settings#settings-precedence) только. Отображение администратора, такое как версия, закрепленная на ARN профиля вывода, соблюдается в принудительном Default. Переопределения из параметров пользователя или проекта не влияют на него.

762 758 

763{/* min-version: 2.1.200 */}Когда `availableModels` установлен в [управляемых параметрах](/ru/settings#settings-files), только `modelOverrides` из этого управляемого источника применяются к идентификатору модели Anthropic, переданному непосредственно через `--model` или переменные окружения выше. Claude Code игнорирует переопределения в параметрах пользователя или проекта для этих идентификаторов и никогда не разрешает идентификатор, который исключает управляемый список, через `modelOverrides` из любого источника параметров. Это ограничение управляемого источника требует Claude Code версии 2.1.200 или позже. См. [Ограничение выбора модели](#restrict-model-selection) для того, как обрабатываются заблокированные идентификаторы.759Когда `availableModels` установлен в [управляемых параметрах](/docs/ru/settings#settings-files), только `modelOverrides` из этого управляемого источника применяются к идентификатору модели Anthropic, переданному непосредственно через `--model` или переменные окружения выше. Claude Code игнорирует переопределения в параметрах пользователя или проекта для этих идентификаторов и никогда не разрешает идентификатор, который исключает управляемый список, через `modelOverrides` из любого источника параметров. Это ограничение управляемого источника требует Claude Code версии 2.1.200 или позже. См. [Ограничение выбора модели](#restrict-model-selection) для того, как обрабатываются заблокированные идентификаторы.

764 760 

765<h3 id="prompt-caching-configuration">761<h3 id="prompt-caching-configuration">

766 Конфигурация кэширования подсказок762 Конфигурация кэширования подсказок

767</h3>763</h3>

768 764 

769Claude Code автоматически использует [кэширование подсказок](/ru/prompt-caching) для оптимизации производительности и снижения затрат. Вы можете отключить кэширование подсказок глобально или для конкретных уровней моделей:765Claude Code автоматически использует [кэширование подсказок](/docs/ru/prompt-caching) для оптимизации производительности и снижения затрат. Вы можете отключить кэширование подсказок глобально или для конкретных уровней моделей:

770 766 

771| Переменная окружения | Описание |767| Переменная окружения | Описание |

772| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |768| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |


776| `DISABLE_PROMPT_CACHING_OPUS` | Установите на `1` для отключения кэширования подсказок только для моделей Opus |772| `DISABLE_PROMPT_CACHING_OPUS` | Установите на `1` для отключения кэширования подсказок только для моделей Opus |

777| `DISABLE_PROMPT_CACHING_FABLE` | Установите на `1` для отключения кэширования подсказок только для моделей Fable |773| `DISABLE_PROMPT_CACHING_FABLE` | Установите на `1` для отключения кэширования подсказок только для моделей Fable |

778 774 

779Чтобы изменить TTL кэша или узнать, что вызывает промах кэша, см. [Как Claude Code использует кэширование подсказок](/ru/prompt-caching).775Чтобы изменить TTL кэша или узнать, что вызывает промах кэша, см. [Как Claude Code использует кэширование подсказок](/docs/ru/prompt-caching).

Details

47 Конфигурация администратора47 Конфигурация администратора

48</h2>48</h2>

49 49 

50Администраторы могут настраивать параметры OpenTelemetry для всех пользователей через [файл управляемых параметров](/ru/settings#settings-files). Это позволяет централизованно управлять параметрами телеметрии в организации. Дополнительную информацию о том, как применяются параметры, см. в разделе [приоритет параметров](/ru/settings#settings-precedence).50Администраторы могут настраивать параметры OpenTelemetry для всех пользователей через [файл управляемых параметров](/docs/ru/settings#settings-files). Это позволяет централизованно управлять параметрами телеметрии в организации. Дополнительную информацию о том, как применяются параметры, см. в разделе [приоритет параметров](/docs/ru/settings#settings-precedence).

51 51 

52Пример конфигурации управляемых параметров:52Пример конфигурации управляемых параметров:

53 53 


93| `OTEL_METRIC_EXPORT_INTERVAL` | Интервал экспорта в миллисекундах (по умолчанию: 60000) | `5000`, `60000` |93| `OTEL_METRIC_EXPORT_INTERVAL` | Интервал экспорта в миллисекундах (по умолчанию: 60000) | `5000`, `60000` |

94| `OTEL_LOGS_EXPORT_INTERVAL` | Интервал экспорта логов в миллисекундах (по умолчанию: 5000) | `1000`, `10000` |94| `OTEL_LOGS_EXPORT_INTERVAL` | Интервал экспорта логов в миллисекундах (по умолчанию: 5000) | `1000`, `10000` |

95| `OTEL_LOG_USER_PROMPTS` | Включить логирование содержимого пользовательских подсказок (по умолчанию: отключено) | `1` для включения |95| `OTEL_LOG_USER_PROMPTS` | Включить логирование содержимого пользовательских подсказок (по умолчанию: отключено) | `1` для включения |

96| `OTEL_LOG_ASSISTANT_RESPONSES` | Включить логирование текста ответа ассистента на событиях `assistant_response` (по умолчанию: отключено). Если не установлено, возвращается к значению `OTEL_LOG_USER_PROMPTS`. {/* min-version: 2.1.193 */}Требует Claude Code v2.1.193 или позже | `1` для включения, `0` для сохранения скрытым |96| `OTEL_LOG_ASSISTANT_RESPONSES` | Включить логирование текста ответа ассистента на событиях `assistant_response` (по умолчанию: отключено). Если не установлено, возвращается к значению `OTEL_LOG_USER_PROMPTS`. Требует Claude Code v2.1.193 или позже | `1` для включения, `0` для сохранения скрытым |

97| `OTEL_LOG_TOOL_DETAILS` | Включить логирование параметров инструмента и аргументов входных данных в событиях инструментов и атрибутах span трассировки: команды Bash, имена MCP сервера и инструмента, имена навыков, имена пользовательских рабочих процессов и входные данные инструмента. Также включает пользовательские, плагин и MCP имена команд на событиях `user_prompt` (по умолчанию: отключено) | `1` для включения |97| `OTEL_LOG_TOOL_DETAILS` | Включить логирование параметров инструмента и аргументов входных данных в событиях инструментов и атрибутах span трассировки: команды Bash, имена MCP сервера и инструмента, имена навыков, имена пользовательских рабочих процессов и входные данные инструмента. Также включает пользовательские, плагин и MCP имена команд на событиях `user_prompt` (по умолчанию: отключено) | `1` для включения |

98| `OTEL_LOG_TOOL_CONTENT` | Включить логирование входных и выходных данных инструмента в событиях span (по умолчанию: отключено). Требует [трассировку](#traces-beta). Содержимое усекается на 60 КБ | `1` для включения |98| `OTEL_LOG_TOOL_CONTENT` | Включить логирование входных и выходных данных инструмента в событиях span (по умолчанию: отключено). Требует [трассировку](#traces-beta). Содержимое усекается на 60 КБ | `1` для включения |

99| `OTEL_LOG_RAW_API_BODIES` | Выдавать полный JSON запроса и ответа Anthropic Messages API как события логов `api_request_body` / `api_response_body` (по умолчанию: отключено). Тела включают всю историю разговора. Включение этого подразумевает согласие со всем, что раскрыли бы `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` и `OTEL_LOG_TOOL_CONTENT` | `1` для встроенных тел, усеченных на 60 КБ, или `file:<dir>` для неусеченных тел на диске с указателем `body_ref` в событии |99| `OTEL_LOG_RAW_API_BODIES` | Выдавать полный JSON запроса и ответа Anthropic Messages API как события логов `api_request_body` / `api_response_body` (по умолчанию: отключено). Тела включают всю историю разговора. Включение этого подразумевает согласие со всем, что раскрыли бы `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS` и `OTEL_LOG_TOOL_CONTENT` | `1` для встроенных тел, усеченных на 60 КБ, или `file:<dir>` для неусеченных тел на диске с указателем `body_ref` в событии |


108 108 

109| Протокол | Переменные сертификата клиента | Доверять CA коллектора с помощью |109| Протокол | Переменные сертификата клиента | Доверять CA коллектора с помощью |

110| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------- |110| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------- |

111| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` и опционально `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. См. [Конфигурация сети](/ru/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |111| `http/protobuf`, `http/json` | `CLAUDE_CODE_CLIENT_CERT`, `CLAUDE_CODE_CLIENT_KEY` и опционально `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`. См. [Конфигурация сети](/docs/ru/network-config#mtls-authentication) | `NODE_EXTRA_CA_CERTS` |

112| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` и `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, или переопределения для каждого сигнала, такие как `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` для использования другого сертификата для каждого сигнала | `OTEL_EXPORTER_OTLP_CERTIFICATE` |112| `grpc` | `OTEL_EXPORTER_OTLP_CLIENT_KEY` и `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`, или переопределения для каждого сигнала, такие как `OTEL_EXPORTER_OTLP_METRICS_CLIENT_KEY` для использования другого сертификата для каждого сигнала | `OTEL_EXPORTER_OTLP_CERTIFICATE` |

113 113 

114Для `grpc` SDK OpenTelemetry читает стандартные переменные OTLP напрямую, поэтому существующие конфигурации, которые устанавливают переменные метрик для каждого сигнала, продолжают работать.114Для `grpc` SDK OpenTelemetry читает стандартные переменные OTLP напрямую, поэтому существующие конфигурации, которые устанавливают переменные метрик для каждого сигнала, продолжают работать.


198| `query_source` | Подсистема, которая выдала запрос, такая как `repl_main_thread` или имя подагента | |198| `query_source` | Подсистема, которая выдала запрос, такая как `repl_main_thread` или имя подагента | |

199| `agent_id` | Идентификатор подагента или товарища, который выдал запрос. Отсутствует в основном сеансе | |199| `agent_id` | Идентификатор подагента или товарища, который выдал запрос. Отсутствует в основном сеансе | |

200| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порожденных непосредственно из него | |200| `parent_agent_id` | Идентификатор агента, который породил этот. Отсутствует для основного сеанса и для агентов, порожденных непосредственно из него | |

201| `workflow.run_id` | Идентификатор запуска инструмента [Workflow](/ru/workflows), который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порожденных рабочим процессом | |201| `workflow.run_id` | Идентификатор запуска инструмента [Workflow](/docs/ru/workflows), который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порожденных рабочим процессом | |

202| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если gate не установлен | `OTEL_LOG_TOOL_DETAILS` |202| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если gate не установлен | `OTEL_LOG_TOOL_DETAILS` |

203| `speed` | `fast` или `normal` | |203| `speed` | `fast` или `normal` | |

204| `llm_request.context` | `interaction`, `tool` или `standalone` в зависимости от родительского span | |204| `llm_request.context` | `interaction`, `tool` или `standalone` в зависимости от родительского span | |


314Если помощник не удается или выводит содержимое, которое не соответствует этим требованиям, Claude Code сообщает об ошибке в:314Если помощник не удается или выводит содержимое, которое не соответствует этим требованиям, Claude Code сообщает об ошибке в:

315 315 

316* выводе `/status`316* выводе `/status`

317* журнале отладки при запуске с [`--debug`](/ru/cli-reference#cli-flags) или после запуска `/debug` в сеансе317* журнале отладки при запуске с [`--debug`](/docs/ru/cli-reference#cli-flags) или после запуска `/debug` в сеансе

318* stderr в неинтерактивных сеансах, запущенных с `-p`318* stderr в неинтерактивных сеансах, запущенных с `-p`

319 319 

320<h4 id="refresh-behavior">320<h4 id="refresh-behavior">


441| `terminal.type` | Тип терминала, такой как `iTerm.app`, `vscode`, `cursor` или `tmux` | Всегда включается при обнаружении |441| `terminal.type` | Тип терминала, такой как `iTerm.app`, `vscode`, `cursor` или `tmux` | Всегда включается при обнаружении |

442| Ключи из `OTEL_RESOURCE_ATTRIBUTES` | Пользовательские атрибуты, которые вы установили, такие как `department` или `team.id`. См. [Поддержка многокомандной организации](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (по умолчанию: true) |442| Ключи из `OTEL_RESOURCE_ATTRIBUTES` | Пользовательские атрибуты, которые вы установили, такие как `department` или `team.id`. См. [Поддержка многокомандной организации](#multi-team-organization-support) | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (по умолчанию: true) |

443 443 

444Когда Claude Code подписан на [Claude apps gateway](/ru/claude-apps-gateway), CLI помечает экспорты аутентифицированной идентичностью из сеанса gateway: `user.id` является субъектом IdP, а не анонимным идентификатором установки, `user.email` является адресом электронной почты, на который выполнен вход, и `user.groups` содержит членство в группе IdP в виде строки, разделенной запятыми. Каждый экспорт также содержит `identity.source: gateway-oidc`. Идентичность gateway применяется последней, поэтому ключи `user.*` и `identity.*`, установленные через `OTEL_RESOURCE_ATTRIBUTES`, игнорируются в сеансах gateway.444Когда Claude Code подписан на [Claude apps gateway](/docs/ru/claude-apps-gateway), CLI помечает экспорты аутентифицированной идентичностью из сеанса gateway: `user.id` является субъектом IdP, а не анонимным идентификатором установки, `user.email` является адресом электронной почты, на который выполнен вход, и `user.groups` содержит членство в группе IdP в виде строки, разделенной запятыми. Каждый экспорт также содержит `identity.source: gateway-oidc`. Идентичность gateway применяется последней, поэтому ключи `user.*` и `identity.*`, установленные через `OTEL_RESOURCE_ATTRIBUTES`, игнорируются в сеансах gateway.

445 445 

446События дополнительно включают следующие атрибуты. Они никогда не прикрепляются к метрикам, потому что они вызовут неограниченную кардинальность:446События дополнительно включают следующие атрибуты. Они никогда не прикрепляются к метрикам, потому что они вызовут неограниченную кардинальность:

447 447 

448* `prompt.id`: UUID, коррелирующий пользовательскую подсказку со всеми последующими событиями до следующей подсказки. См. [Атрибуты корреляции событий](#event-correlation-attributes).448* `prompt.id`: UUID, коррелирующий пользовательскую подсказку со всеми последующими событиями до следующей подсказки. См. [Атрибуты корреляции событий](#event-correlation-attributes).

449* `workspace.host_paths`: каталоги рабочей области хоста, выбранные в приложении для рабочего стола, как массив строк449* `workspace.host_paths`: каталоги рабочей области хоста, выбранные в приложении для рабочего стола, как массив строк

450* `workflow.run_id`: идентификатор запуска, с префиксом `wf_`, на событиях API и инструментов, выданных агентами, которые принадлежат запуску инструмента [Workflow](/ru/workflows). Фильтрация событий по одному `workflow.run_id` восстанавливает запросы API и результаты инструментов этого запуска. Идентификатор охватывает агентов, которых порождает скрипт workflow, и любых агентов, которых они порождают в свою очередь, такие как вызовы навыков. Он совпадает с идентификатором запуска, указанным в результате инструмента Workflow. Отсутствует на всех остальных событиях. Требует Claude Code v2.1.202 или позже450* `workflow.run_id`: идентификатор запуска, с префиксом `wf_`, на событиях API и инструментов, выданных агентами, которые принадлежат запуску инструмента [Workflow](/docs/ru/workflows). Фильтрация событий по одному `workflow.run_id` восстанавливает запросы API и результаты инструментов этого запуска. Идентификатор охватывает агентов, которых порождает скрипт workflow, и любых агентов, которых они порождают в свою очередь, такие как вызовы навыков. Он совпадает с идентификатором запуска, указанным в результате инструмента Workflow. Отсутствует на всех остальных событиях. Требует Claude Code v2.1.202 или позже

451* `workflow.name`: имя workflow, `meta.name` его скрипта, выданное вместе с `workflow.run_id`. Встроенные имена workflow появляются как есть при выполнении немодифицированного встроенного скрипта. Определяемые пользователем имена, включая отредактированные копии встроенных скриптов, заменяются на `custom`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`. Требует Claude Code v2.1.202 или позже451* `workflow.name`: имя workflow, `meta.name` его скрипта, выданное вместе с `workflow.run_id`. Встроенные имена workflow появляются как есть при выполнении немодифицированного встроенного скрипта. Определяемые пользователем имена, включая отредактированные копии встроенных скриптов, заменяются на `custom`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`. Требует Claude Code v2.1.202 или позже

452 452 

453<h3 id="metrics">453<h3 id="metrics">


528* `model`: Идентификатор модели (например, "claude-sonnet-5")528* `model`: Идентификатор модели (например, "claude-sonnet-5")

529* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`529* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`

530* `speed`: `"fast"` когда запрос использовал быстрый режим. Отсутствует в противном случае530* `speed`: `"fast"` когда запрос использовал быстрый режим. Отсутствует в противном случае

531* `effort`: [Уровень усилий](/ru/model-config#adjust-effort-level), применяемый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда модель не поддерживает усилия.531* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда модель не поддерживает усилия.

532* `agent.name`: Тип подагента, который выдал запрос. Встроенные имена агентов и агенты из официальных плагинов маркетплейса появляются как есть. Другие определяемые пользователем имена агентов заменяются на `"custom"`. Отсутствует, когда запрос не был выдан именованным типом подагента.532* `agent.name`: Тип подагента, который выдал запрос. Встроенные имена агентов и агенты из официальных плагинов маркетплейса появляются как есть. Другие определяемые пользователем имена агентов заменяются на `"custom"`. Отсутствует, когда запрос не был выдан именованным типом подагента.

533* `skill.name`: Навык, активный для запроса, установленный инструментом Skill, командой `/` или унаследованный порожденным подагентом. Встроенные, поставляемые, определяемые пользователем и навыки плагинов официального маркетплейса появляются как есть. Навыки плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда нет активного навыка.533* `skill.name`: Навык, активный для запроса, установленный инструментом Skill, командой `/` или унаследованный порожденным подагентом. Встроенные, поставляемые, определяемые пользователем и навыки плагинов официального маркетплейса появляются как есть. Навыки плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда нет активного навыка.

534* `plugin.name`: Владельцы плагина, когда активный навык или подагент предоставляются плагином. Имена плагинов официального маркетплейса появляются как есть. Имена плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда ни навык, ни подагент не имеют владельца плагина.534* `plugin.name`: Владельцы плагина, когда активный навык или подагент предоставляются плагином. Имена плагинов официального маркетплейса появляются как есть. Имена плагинов третьих сторон заменяются на `"third-party"`. Отсутствует, когда ни навык, ни подагент не имеют владельца плагина.


549* `model`: Идентификатор модели (например, "claude-sonnet-5")549* `model`: Идентификатор модели (например, "claude-sonnet-5")

550* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`550* `query_source`: Категория подсистемы, которая выдала запрос. Один из `"main"`, `"subagent"` или `"auxiliary"`

551* `speed`: `"fast"` когда запрос использовал быстрый режим. Отсутствует в противном случае551* `speed`: `"fast"` когда запрос использовал быстрый режим. Отсутствует в противном случае

552* `effort`: [Уровень усилий](/ru/model-config#adjust-effort-level), применяемый к запросу. Подробности см. в разделе [Счетчик затрат](#cost-counter).552* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу. Подробности см. в разделе [Счетчик затрат](#cost-counter).

553* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина и агента для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).553* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина и агента для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).

554 554 

555<h4 id="code-edit-tool-decision-counter">555<h4 id="code-edit-tool-decision-counter">


695* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.695* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.

696* `speed`: `"fast"` или `"normal"`, указывающий, был ли активен быстрый режим696* `speed`: `"fast"` или `"normal"`, указывающий, был ли активен быстрый режим

697* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента697* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента

698* `effort`: [Уровень усилий](/ru/model-config#adjust-effort-level), применяемый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда модель не поддерживает усилия.698* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу: `"low"`, `"medium"`, `"high"`, `"xhigh"` или `"max"`. Отсутствует, когда модель не поддерживает усилия.

699* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).699* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).

700 700 

701<h4 id="api-error-event">701<h4 id="api-error-event">


720* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.720* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.

721* `speed`: `"fast"` или `"normal"`, указывающий, был ли активен быстрый режим721* `speed`: `"fast"` или `"normal"`, указывающий, был ли активен быстрый режим

722* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента722* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента

723* `effort`: [Уровень усилий](/ru/model-config#adjust-effort-level), применяемый к запросу. Отсутствует, когда модель не поддерживает усилия.723* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу. Отсутствует, когда модель не поддерживает усилия.

724* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).724* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Атрибуция навыка, плагина, агента и MCP для запроса. Определения и поведение редактирования см. в разделе [Счетчик затрат](#cost-counter).

725 725 

726<h4 id="api-refusal-event">726<h4 id="api-refusal-event">


740* `model`: Идентификатор модели из запроса740* `model`: Идентификатор модели из запроса

741* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.741* `request_id`: ID запроса Anthropic API из заголовка ответа `request-id`, такой как `"req_011..."`. Присутствует только, когда API возвращает его.

742* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента. Определения см. в разделе [`api_request`](#api-request-event).742* `query_source`: Подсистема, которая выдала запрос, такая как `"repl_main_thread"`, `"compact"` или имя подагента. Определения см. в разделе [`api_request`](#api-request-event).

743* `speed`: Либо `"fast"` когда активен [Fast mode](/ru/fast-mode), либо `"normal"`743* `speed`: Либо `"fast"` когда активен [Fast mode](/docs/ru/fast-mode), либо `"normal"`

744* `attempt`: Номер попытки повтора. Первая попытка это `1`.744* `attempt`: Номер попытки повтора. Первая попытка это `1`.

745* `effort`: [Уровень усилий](/ru/model-config#adjust-effort-level), применяемый к запросу. Отсутствует, когда модель не поддерживает усилия.745* `effort`: [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу. Отсутствует, когда модель не поддерживает усилия.

746* `server_fallback_hop`: `true` когда резервный вариант модели на стороне сервера API уже повторил этот отказ на другой модели, поэтому пользователь не видел этот конкретный отказ. `false` когда запрос закончился отказом. Один ход может выдать как событие `true` hop, так и позже событие `false` final, когда модель резервного варианта также отказывает.746* `server_fallback_hop`: `true` когда резервный вариант модели на стороне сервера API уже повторил этот отказ на другой модели, поэтому пользователь не видел этот конкретный отказ. `false` когда запрос закончился отказом. Один ход может выдать как событие `true` hop, так и позже событие `false` final, когда модель резервного варианта также отказывает.

747* `has_category`: `true` когда ответ API содержал `stop_details.category` из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. `false` когда ответ не содержал категорию или значение вне этого набора. Отсутствует, когда `server_fallback_hop` это `true`, потому что hop блоки не содержат `stop_details`.747* `has_category`: `true` когда ответ API содержал `stop_details.category` из `"cyber"`, `"bio"`, `"frontier_llm"` или `"reasoning_extraction"`. `false` когда ответ не содержал категорию или значение вне этого набора. Отсутствует, когда `server_fallback_hop` это `true`, потому что hop блоки не содержат `stop_details`.

748* `has_explanation`: `true` когда ответ API содержал `stop_details.explanation`, иначе `false`. Отсутствует, когда `server_fallback_hop` это `true`.748* `has_explanation`: `true` когда ответ API содержал `stop_details.explanation`, иначе `false`. Отсутствует, когда `server_fallback_hop` это `true`.


949* `skill_path_count`: количество каталогов навыков, которые объявляет плагин949* `skill_path_count`: количество каталогов навыков, которые объявляет плагин

950* `command_path_count`: количество каталогов команд, которые объявляет плагин950* `command_path_count`: количество каталогов команд, которые объявляет плагин

951* `agent_path_count`: количество каталогов агентов, которые объявляет плагин951* `agent_path_count`: количество каталогов агентов, которые объявляет плагин

952* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/ru/cli-reference), `"false"` в противном случае. В безопасном режиме это событие сообщает только настроенный инвентарь; команды, навыки, hooks и MCP серверы плагина не загружаются. Требует Claude Code v2.1.169 или позже952* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. В безопасном режиме это событие сообщает только настроенный инвентарь; команды, навыки, hooks и MCP серверы плагина не загружаются. Требует Claude Code v2.1.169 или позже

953 953 

954<h4 id="skill-activated-event">954<h4 id="skill-activated-event">

955 Событие активации навыка955 Событие активации навыка


1027* `hook_event`: тип события hook, такой как `"PreToolUse"` или `"PostToolUse"`1027* `hook_event`: тип события hook, такой как `"PreToolUse"` или `"PostToolUse"`

1028* `hook_type`: тип реализации hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` или `"agent"`1028* `hook_type`: тип реализации hook: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"` или `"agent"`

1029* `hook_source`: где определен hook: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` или `"pluginHook"`1029* `hook_source`: где определен hook: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"` или `"pluginHook"`

1030* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/ru/cli-reference), `"false"` в противном случае. Требует Claude Code v2.1.169 или позже1030* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требует Claude Code v2.1.169 или позже

1031* `hook_matcher` (когда `OTEL_LOG_TOOL_DETAILS=1`): строка matcher из конфигурации hook, когда она установлена1031* `hook_matcher` (когда `OTEL_LOG_TOOL_DETAILS=1`): строка matcher из конфигурации hook, когда она установлена

1032* `plugin.name` (когда `hook_source` это `"pluginHook"`): имя участвующего плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`1032* `plugin.name` (когда `hook_source` это `"pluginHook"`): имя участвующего плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение `"third-party"`, если не установлен `OTEL_LOG_TOOL_DETAILS=1`

1033* `plugin_id_hash` (когда `hook_source` это `"pluginHook"`): детерминированный хеш имени плагина и маркетплейса, отправляемый только на ваш настроенный экспортер. Позволяет вам подсчитать различные участвующие плагины без записи их имен1033* `plugin_id_hash` (когда `hook_source` это `"pluginHook"`): детерминированный хеш имени плагина и маркетплейса, отправляемый только на ваш настроенный экспортер. Позволяет вам подсчитать различные участвующие плагины без записи их имен


1051* `num_hooks`: Количество соответствующих команд hook1051* `num_hooks`: Количество соответствующих команд hook

1052* `managed_only`: `"true"` когда разрешены только управляемые политики hooks1052* `managed_only`: `"true"` когда разрешены только управляемые политики hooks

1053* `hook_source`: `"policySettings"` или `"merged"`1053* `hook_source`: `"policySettings"` или `"merged"`

1054* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/ru/cli-reference), `"false"` в противном случае. Требует Claude Code v2.1.169 или позже1054* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требует Claude Code v2.1.169 или позже

1055* `hook_definitions`: JSON-сериализованная конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`1055* `hook_definitions`: JSON-сериализованная конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`

1056 1056 

1057<h4 id="hook-execution-complete-event">1057<h4 id="hook-execution-complete-event">


1078* `total_duration_ms`: Длительность в реальном времени всех соответствующих hooks1078* `total_duration_ms`: Длительность в реальном времени всех соответствующих hooks

1079* `managed_only`: `"true"` когда разрешены только управляемые политики hooks1079* `managed_only`: `"true"` когда разрешены только управляемые политики hooks

1080* `hook_source`: `"policySettings"` или `"merged"`1080* `hook_source`: `"policySettings"` или `"merged"`

1081* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/ru/cli-reference), `"false"` в противном случае. Требует Claude Code v2.1.169 или позже1081* `safe_mode`: `"true"` когда сеанс был запущен с [`--safe-mode`](/docs/ru/cli-reference), `"false"` в противном случае. Требует Claude Code v2.1.169 или позже

1082* `hook_definitions`: JSON-сериализованная конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`1082* `hook_definitions`: JSON-сериализованная конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и `OTEL_LOG_TOOL_DETAILS=1`

1083 1083 

1084<h4 id="hook-plugin-metrics-event">1084<h4 id="hook-plugin-metrics-event">


1125 Событие опроса обратной связи1125 Событие опроса обратной связи

1126</h4>1126</h4>

1127 1127 

1128Логируется, когда опрос качества сеанса показывается или на него отвечают. Дополнительную информацию о том, что собирают опросы и как их контролировать, см. в разделе [Опросы качества сеанса](/ru/data-usage#session-quality-surveys).1128Логируется, когда опрос качества сеанса показывается или на него отвечают. Дополнительную информацию о том, что собирают опросы и как их контролировать, см. в разделе [Опросы качества сеанса](/docs/ru/data-usage#session-quality-surveys).

1129 1129 

1130**Имя события**: `claude_code.feedback_survey`1130**Имя события**: `claude_code.feedback_survey`

1131 1131 


1139* `appearance_id`: Уникальный ID, связывающий события, выданные для одного экземпляра опроса1139* `appearance_id`: Уникальный ID, связывающий события, выданные для одного экземпляра опроса

1140* `survey_type`: Какой опрос произвел событие. `"session"` это подсказка рейтинга "Как работает Claude?"1140* `survey_type`: Какой опрос произвел событие. `"session"` это подсказка рейтинга "Как работает Claude?"

1141* `response`: Выбор пользователя на событиях `responded`1141* `response`: Выбор пользователя на событиях `responded`

1142* `enabled_via_override`: `true` когда установлен [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/ru/env-vars). Выдается как логическое значение, а не строка. Присутствует на событиях опроса `session`. Отфильтруйте по этому атрибуту, чтобы подтвердить, что переопределение применяется в вашем парке1142* `enabled_via_override`: `true` когда установлен [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/ru/env-vars). Выдается как логическое значение, а не строка. Присутствует на событиях опроса `session`. Отфильтруйте по этому атрибуту, чтобы подтвердить, что переопределение применяется в вашем парке

1143 1143 

1144<h2 id="interpret-metrics-and-events-data">1144<h2 id="interpret-metrics-and-events-data">

1145 Интерпретация данных метрик и событий1145 Интерпретация данных метрик и событий


1182* Необычное потребление токенов1182* Необычное потребление токенов

1183* Высокий объем сеансов от конкретных пользователей1183* Высокий объем сеансов от конкретных пользователей

1184 1184 

1185Все метрики можно сегментировать по [стандартным атрибутам](#standard-attributes). Атрибут `model` доступен на `claude_code.token.usage`, `claude_code.cost.usage` и {/* min-version: 2.1.172 */}начиная с версии 2.1.172, `claude_code.lines_of_code.count`.1185Все метрики можно сегментировать по [стандартным атрибутам](#standard-attributes). Атрибут `model` доступен на `claude_code.token.usage`, `claude_code.cost.usage` и начиная с версии 2.1.172, `claude_code.lines_of_code.count`.

1186 1186 

1187Разбивки по моделям для коммитов можно только приблизительно оценить, объединив данные с метриками токенов или затрат по `session.id`, поскольку один сеанс может охватывать несколько моделей. Отфильтруйте сторону токенов или затрат до строк, где `query_source` равен `"main"`, чтобы вспомогательные запросы и запросы подагентов не приписывали коммиты сеанса модели, которая их не создавала.1187Разбивки по моделям для коммитов можно только приблизительно оценить, объединив данные с метриками токенов или затрат по `session.id`, поскольку один сеанс может охватывать несколько моделей. Отфильтруйте сторону токенов или затрат до строк, где `query_source` равен `"main"`, чтобы вспомогательные запросы и запросы подагентов не приписывали коммиты сеанса модели, которая их не создавала.

1188 1188 


1192 1192 

1193Claude Code повторяет неудачные запросы API внутри и выдает одно событие `claude_code.api_error` только после того, как сдается, поэтому само событие является терминальным сигналом для этого запроса. Промежуточные повторные попытки не логируются как отдельные события.1193Claude Code повторяет неудачные запросы API внутри и выдает одно событие `claude_code.api_error` только после того, как сдается, поэтому само событие является терминальным сигналом для этого запроса. Промежуточные повторные попытки не логируются как отдельные события.

1194 1194 

1195Атрибут `attempt` на событии записывает общее количество попыток. `CLAUDE_CODE_MAX_RETRIES` по умолчанию равен 10 и ограничен 15; {/* min-version: 2.1.199 */}начиная с версии 2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и снимает ограничение. Когда запрос исчерпывает все повторные попытки при переходной ошибке, `attempt` равен на один больше, чем это эффективное ограничение: 11 по умолчанию и никогда не более 16, если не установлен watchdog. Более низкое значение указывает на неповторяемую ошибку, такую как ответ `400`.1195Атрибут `attempt` на событии записывает общее количество попыток. `CLAUDE_CODE_MAX_RETRIES` по умолчанию равен 10 и ограничен 15; начиная с версии 2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и снимает ограничение. Когда запрос исчерпывает все повторные попытки при переходной ошибке, `attempt` равен на один больше, чем это эффективное ограничение: 11 по умолчанию и никогда не более 16, если не установлен watchdog. Более низкое значение указывает на неповторяемую ошибку, такую как ответ `400`.

1196 1196 

1197Чтобы различить сеанс, который восстановился, от того, который застопорился, сгруппируйте события по `session.id` и проверьте, существует ли более позднее событие `api_request` после ошибки.1197Чтобы различить сеанс, который восстановился, от того, который застопорился, сгруппируйте события по `session.id` и проверьте, существует ли более позднее событие `api_request` после ошибки.

1198 1198 


1221 Атрибуция действий пользователям1221 Атрибуция действий пользователям

1222</h3>1222</h3>

1223 1223 

1224[Стандартные атрибуты](#standard-attributes) на каждом событии включают идентификацию аутентифицированного пользователя: `user.email`, `user.account_uuid`, `user.account_id` и `organization.id` при входе с учетной записью Claude, плюс `user.id` и область сеанса `session.id`. `user.id` является идентификатором, ограниченным установкой, за исключением сеансов [Claude apps gateway](/ru/claude-apps-gateway), где это субъект IdP из выданного шлюзом токена.1224[Стандартные атрибуты](#standard-attributes) на каждом событии включают идентификацию аутентифицированного пользователя: `user.email`, `user.account_uuid`, `user.account_id` и `organization.id` при входе с учетной записью Claude, плюс `user.id` и область сеанса `session.id`. `user.id` является идентификатором, ограниченным установкой, за исключением сеансов [Claude apps gateway](/docs/ru/claude-apps-gateway), где это субъект IdP из выданного шлюзом токена.

1225 1225 

1226Вызовы инструментов MCP, команды Bash и редактирование файлов поэтому приписываются разработчику, который запустил сеанс. Claude Code не действует под отдельной учетной записью сервиса; идентификация, записанная на каждом событии, это собственная учетная запись Claude разработчика или идентификация IdP разработчика в сеансе [Claude apps gateway](/ru/claude-apps-gateway).1226Вызовы инструментов MCP, команды Bash и редактирование файлов поэтому приписываются разработчику, который запустил сеанс. Claude Code не действует под отдельной учетной записью сервиса; идентификация, записанная на каждом событии, это собственная учетная запись Claude разработчика или идентификация IdP разработчика в сеансе [Claude apps gateway](/docs/ru/claude-apps-gateway).

1227 1227 

1228Когда Claude Code аутентифицируется с прямым ключом API или против Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, в сеансе нет учетной записи Claude и только `user.id` и `session.id` заполняются. В этих развертываниях прикрепите идентификацию пользователя самостоятельно с помощью `OTEL_RESOURCE_ATTRIBUTES`, установленного для каждого пользователя через файл [управляемых параметров](#administrator-configuration) или оболочку запуска. Сеансы Claude apps gateway не требуют ничего из этого: CLI автоматически проставляет идентификацию IdP, как описано в [Стандартные атрибуты](#standard-attributes).1228Когда Claude Code аутентифицируется с прямым ключом API или против Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, в сеансе нет учетной записи Claude и только `user.id` и `session.id` заполняются. В этих развертываниях прикрепите идентификацию пользователя самостоятельно с помощью `OTEL_RESOURCE_ATTRIBUTES`, установленного для каждого пользователя через файл [управляемых параметров](#administrator-configuration) или оболочку запуска. Сеансы Claude apps gateway не требуют ничего из этого: CLI автоматически проставляет идентификацию IdP, как описано в [Стандартные атрибуты](#standard-attributes).

1229 1229 


1343 Безопасность и конфиденциальность1343 Безопасность и конфиденциальность

1344</h2>1344</h2>

1345 1345 

1346* Экспорт OpenTelemetry на ваш бэкенд является добровольным и требует явной конфигурации. Информацию об отдельной операционной телеметрии Anthropic и о том, как её отключить, см. в разделе [Data usage](/ru/data-usage#telemetry-services)1346* Экспорт OpenTelemetry на ваш бэкенд является добровольным и требует явной конфигурации. Информацию об отдельной операционной телеметрии Anthropic и о том, как её отключить, см. в разделе [Data usage](/docs/ru/data-usage#telemetry-services)

1347* Содержимое файлов в исходном виде и фрагменты кода не включаются в метрики или события. Span трассировок — это отдельный путь данных: см. пункт `OTEL_LOG_TOOL_CONTENT` ниже1347* Содержимое файлов в исходном виде и фрагменты кода не включаются в метрики или события. Span трассировок — это отдельный путь данных: см. пункт `OTEL_LOG_TOOL_CONTENT` ниже

1348* При аутентификации через OAuth `user.email` включается в атрибуты телеметрии. Если это вызывает беспокойство для вашей организации, работайте с вашим бэкендом телеметрии для фильтрации или редактирования этого поля1348* При аутентификации через OAuth `user.email` включается в атрибуты телеметрии. Если это вызывает беспокойство для вашей организации, работайте с вашим бэкендом телеметрии для фильтрации или редактирования этого поля

1349* Содержимое пользовательской подсказки не собирается по умолчанию. Записывается только длина подсказки. Чтобы включить содержимое подсказки, установите `OTEL_LOG_USER_PROMPTS=1`1349* Содержимое пользовательской подсказки не собирается по умолчанию. Записывается только длина подсказки. Чтобы включить содержимое подсказки, установите `OTEL_LOG_USER_PROMPTS=1`

network-config.md +15 −15

Details

9Claude Code поддерживает различные конфигурации сети и безопасности предприятия через переменные окружения. Это включает маршрутизацию трафика через корпоративные прокси-серверы, доверие пользовательским центрам сертификации (CA) и аутентификацию с помощью сертификатов взаимного Transport Layer Security (mTLS) для повышенной безопасности.9Claude Code поддерживает различные конфигурации сети и безопасности предприятия через переменные окружения. Это включает маршрутизацию трафика через корпоративные прокси-серверы, доверие пользовательским центрам сертификации (CA) и аутентификацию с помощью сертификатов взаимного Transport Layer Security (mTLS) для повышенной безопасности.

10 10 

11<Note>11<Note>

12 Все переменные окружения, показанные на этой странице, также можно настроить в [`settings.json`](/ru/settings).12 Все переменные окружения, показанные на этой странице, также можно настроить в [`settings.json`](/docs/ru/settings).

13</Note>13</Note>

14 14 

15<h2 id="proxy-configuration">15<h2 id="proxy-configuration">


123| `api.anthropic.com` | Запросы Claude API |123| `api.anthropic.com` | Запросы Claude API |

124| `claude.ai` | Аутентификация учетной записи claude.ai |124| `claude.ai` | Аутентификация учетной записи claude.ai |

125| `platform.claude.com` | Аутентификация учетной записи Anthropic Console |125| `platform.claude.com` | Аутентификация учетной записи Anthropic Console |

126| `mcp-proxy.anthropic.com` | [MCP connectors из claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai), включая connectors, которые настраивает администратор организации. Трафик Connector маршрутизируется через этот прокси; connectors включены по умолчанию для пользователей, прошедших аутентификацию через claude.ai. Чтобы отключить, установите [`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/ru/env-vars) или параметр [`disableClaudeAiConnectors`](/ru/settings#available-settings) |126| `mcp-proxy.anthropic.com` | [MCP connectors из claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai), включая connectors, которые настраивает администратор организации. Трафик Connector маршрутизируется через этот прокси; connectors включены по умолчанию для пользователей, прошедших аутентификацию через claude.ai. Чтобы отключить, установите [`ENABLE_CLAUDEAI_MCP_SERVERS=false`](/docs/ru/env-vars) или параметр [`disableClaudeAiConnectors`](/docs/ru/settings#available-settings) |

127| `downloads.claude.ai` | Загрузки исполняемых файлов плагинов; встроенный установщик и встроенное автоматическое обновление |127| `downloads.claude.ai` | Загрузки исполняемых файлов плагинов; встроенный установщик и встроенное автоматическое обновление |

128| `storage.googleapis.com` | Счетчики установок и метаданные плагинов, отображаемые в `/plugin`. Подписанные [artifact](/ru/artifacts) загрузки сначала пытаются использовать этот хост; публикация переходит на `api.anthropic.com`, когда он заблокирован |128| `storage.googleapis.com` | Счетчики установок и метаданные плагинов, отображаемые в `/plugin`. Подписанные [artifact](/docs/ru/artifacts) загрузки сначала пытаются использовать этот хост; публикация переходит на `api.anthropic.com`, когда он заблокирован |

129| `storage.googleapis.com` | {/* max-version: 2.1.115 */}Встроенный установщик и встроенное автоматическое обновление в версиях до 2.1.116 |129| `storage.googleapis.com` | Встроенный установщик и встроенное автоматическое обновление в версиях до 2.1.116 |

130| `bridge.claudeusercontent.com` | Мост WebSocket расширения [Claude в Chrome](/ru/chrome) |130| `bridge.claudeusercontent.com` | Мост WebSocket расширения [Claude в Chrome](/docs/ru/chrome) |

131| `*.claudeusercontent.com` | Просмотр [артефактов](/ru/artifacts) на claude.ai. Средство просмотра загружает содержимое каждого артефакта из изолированного поддомена этого источника. Требуется в браузере средства просмотра, а не в самом CLI |131| `*.claudeusercontent.com` | Просмотр [артефактов](/docs/ru/artifacts) на claude.ai. Средство просмотра загружает содержимое каждого артефакта из изолированного поддомена этого источника. Требуется в браузере средства просмотра, а не в самом CLI |

132| `raw.githubusercontent.com` | Лента журнала изменений для [`/release-notes`](/ru/commands) и примечания к выпуску, отображаемые после обновления |132| `raw.githubusercontent.com` | Лента журнала изменений для [`/release-notes`](/docs/ru/commands) и примечания к выпуску, отображаемые после обновления |

133 133 

134Если вы устанавливаете Claude Code через npm или управляете собственным распределением бинарных файлов, конечным пользователям не требуется встроенный установщик и встроенное автоматическое обновление из `downloads.claude.ai`. Остальные использования в таблице применяются независимо от метода установки.134Если вы устанавливаете Claude Code через npm или управляете собственным распределением бинарных файлов, конечным пользователям не требуется встроенный установщик и встроенное автоматическое обновление из `downloads.claude.ai`. Остальные использования в таблице применяются независимо от метода установки.

135 135 

136Claude Code также отправляет дополнительную операционную телеметрию по умолчанию, которую вы можете отключить с помощью переменных окружения. См. [Услуги телеметрии](/ru/data-usage#telemetry-services), чтобы узнать, как отключить её перед окончательным формированием вашего белого списка.136Claude Code также отправляет дополнительную операционную телеметрию по умолчанию, которую вы можете отключить с помощью переменных окружения. См. [Услуги телеметрии](/docs/ru/data-usage#telemetry-services), чтобы узнать, как отключить её перед окончательным формированием вашего белого списка.

137 137 

138При использовании [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) или сеанса [шлюза приложений Claude](/ru/claude-apps-gateway) с входом, трафик модели и аутентификация идут к вашему поставщику или шлюзу вместо `api.anthropic.com`, `claude.ai` или `platform.claude.com`. Инструмент WebFetch по-прежнему вызывает `api.anthropic.com` для своей [проверки безопасности домена](/ru/data-usage#webfetch-domain-safety-check), если вы не установите `skipWebFetchPreflight: true` в [параметрах](/ru/settings).138При использовании [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) или сеанса [шлюза приложений Claude](/docs/ru/claude-apps-gateway) с входом, трафик модели и аутентификация идут к вашему поставщику или шлюзу вместо `api.anthropic.com`, `claude.ai` или `platform.claude.com`. Инструмент WebFetch по-прежнему вызывает `api.anthropic.com` для своей [проверки безопасности домена](/docs/ru/data-usage#webfetch-domain-safety-check), если вы не установите `skipWebFetchPreflight: true` в [параметрах](/docs/ru/settings).

139 139 

140[Claude Code в веб-версии](/ru/claude-code-on-the-web) и [Code Review](/ru/code-review) подключаются к вашим репозиториям из управляемой Anthropic инфраструктуры. Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, включите [наследование списка разрешенных IP для установленных GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). GitHub App Claude регистрирует свои диапазоны IP, поэтому включение этого параметра позволяет получить доступ без ручной конфигурации. Чтобы [добавить диапазоны в список разрешенных вручную](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) вместо этого, или для настройки других брандмауэров, см. [IP-адреса Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses).140[Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) и [Code Review](/docs/ru/code-review) подключаются к вашим репозиториям из управляемой Anthropic инфраструктуры. Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, включите [наследование списка разрешенных IP для установленных GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps). GitHub App Claude регистрирует свои диапазоны IP, поэтому включение этого параметра позволяет получить доступ без ручной конфигурации. Чтобы [добавить диапазоны в список разрешенных вручную](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address) вместо этого, или для настройки других брандмауэров, см. [IP-адреса Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses).

141 141 

142Для самостоятельно размещаемых экземпляров [GitHub Enterprise Server](/ru/github-enterprise-server) за брандмауэром добавьте в белый список те же [IP-адреса Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses), чтобы инфраструктура Anthropic могла достичь вашего хоста GHES для клонирования репозиториев и публикации комментариев к рецензиям.142Для самостоятельно размещаемых экземпляров [GitHub Enterprise Server](/docs/ru/github-enterprise-server) за брандмауэром добавьте в белый список те же [IP-адреса Anthropic API](https://platform.claude.com/docs/en/api/ip-addresses), чтобы инфраструктура Anthropic могла достичь вашего хоста GHES для клонирования репозиториев и публикации комментариев к рецензиям.

143 143 

144<h3 id="desktop-and-claude-ai">144<h3 id="desktop-and-claude-ai">

145 Desktop и claude.ai145 Desktop и claude.ai

146</h3>146</h3>

147 147 

148Предыдущая таблица в основном охватывает автономный CLI. Приложение Claude Desktop и claude.ai в браузере загружают код приложения с дополнительных хостов CDN Anthropic, включая `assets-proxy.anthropic.com`. Разрешение `claude.ai` при блокировке этих хостов приводит к пустой странице, а не к ошибке. См. [требования к доступу в сети](/ru/desktop#network-access-requirements) на странице Desktop.148Предыдущая таблица в основном охватывает автономный CLI. Приложение Claude Desktop и claude.ai в браузере загружают код приложения с дополнительных хостов CDN Anthropic, включая `assets-proxy.anthropic.com`. Разрешение `claude.ai` при блокировке этих хостов приводит к пустой странице, а не к ошибке. См. [требования к доступу в сети](/docs/ru/desktop#network-access-requirements) на странице Desktop.

149 149 

150<h2 id="additional-resources">150<h2 id="additional-resources">

151 Дополнительные ресурсы151 Дополнительные ресурсы

152</h2>152</h2>

153 153 

154* [Параметры Claude Code](/ru/settings)154* [Параметры Claude Code](/docs/ru/settings)

155* [Справочник переменных окружения](/ru/env-vars)155* [Справочник переменных окружения](/docs/ru/env-vars)

156* [Руководство по устранению неполадок](/ru/troubleshooting)156* [Руководство по устранению неполадок](/docs/ru/troubleshooting)

output-styles.md +15 −15

Details

10 10 

11Пользовательский output style добавляет ваши инструкции в системный prompt и позволяет вам выбрать, сохранять ли встроенные инструкции Claude Code по разработке программного обеспечения. Сохраняйте их, когда вы изменяете способ общения Claude, но все еще кодируете, например всегда отвечаете диаграммой. Исключите их, когда Claude не занимается разработкой программного обеспечения вообще, например помощник по написанию текстов или аналитик данных.11Пользовательский output style добавляет ваши инструкции в системный prompt и позволяет вам выбрать, сохранять ли встроенные инструкции Claude Code по разработке программного обеспечения. Сохраняйте их, когда вы изменяете способ общения Claude, но все еще кодируете, например всегда отвечаете диаграммой. Исключите их, когда Claude не занимается разработкой программного обеспечения вообще, например помощник по написанию текстов или аналитик данных.

12 12 

13Для инструкций о вашем проекте, соглашениях или кодовой базе используйте [CLAUDE.md](/ru/memory) вместо этого.13Для инструкций о вашем проекте, соглашениях или кодовой базе используйте [CLAUDE.md](/docs/ru/memory) вместо этого.

14 14 

15<h2 id="built-in-output-styles">15<h2 id="built-in-output-styles">

16 Встроенные output styles16 Встроенные output styles


20 20 

21Существует три дополнительных встроенных output style:21Существует три дополнительных встроенных output style:

22 22 

23* **Proactive**: Claude выполняет действия немедленно, делает разумные предположения вместо паузы для рутинных решений и предпочитает действие планированию. Это более сильное руководство по автономному выполнению, чем применяет [режим автоматизации](/ru/permission-modes#eliminate-prompts-with-auto-mode), и оно работает без изменения вашего режима разрешений, поэтому вы по-прежнему видите запросы разрешений перед запуском инструментов.23* **Proactive**: Claude выполняет действия немедленно, делает разумные предположения вместо паузы для рутинных решений и предпочитает действие планированию. Это более сильное руководство по автономному выполнению, чем применяет [режим автоматизации](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), и оно работает без изменения вашего режима разрешений, поэтому вы по-прежнему видите запросы разрешений перед запуском инструментов.

24 24 

25* **Explanatory**: предоставляет образовательные "Insights" между помощью в выполнении задач разработки программного обеспечения. Помогает вам понять выбор реализации и паттерны кодовой базы.25* **Explanatory**: предоставляет образовательные "Insights" между помощью в выполнении задач разработки программного обеспечения. Помогает вам понять выбор реализации и паттерны кодовой базы.

26 26 


30 Измените ваш output style30 Измените ваш output style

31</h2>31</h2>

32 32 

33Запустите `/config` и выберите **Output style**, чтобы выбрать стиль из меню. Ваш выбор сохраняется в `.claude/settings.local.json` на [локальном уровне проекта](/ru/settings).33Запустите `/config` и выберите **Output style**, чтобы выбрать стиль из меню. Ваш выбор сохраняется в `.claude/settings.local.json` на [локальном уровне проекта](/docs/ru/settings).

34 34 

35<Note>{/* max-version: 2.1.90 */}Автономная команда `/output-style` была объявлена устаревшей в версии 2.1.73 и удалена в версии 2.1.91. Используйте `/config` или отредактируйте параметр `outputStyle` напрямую.</Note>35<Note>Автономная команда `/output-style` была объявлена устаревшей в версии 2.1.73 и удалена в версии 2.1.91. Используйте `/config` или отредактируйте параметр `outputStyle` напрямую.</Note>

36 36 

37Чтобы установить стиль без меню, отредактируйте поле `outputStyle` непосредственно в файле настроек:37Чтобы установить стиль без меню, отредактируйте поле `outputStyle` непосредственно в файле настроек:

38 38 


42}42}

43```43```

44 44 

45Output style является частью системного prompt, который Claude Code читает один раз при запуске сеанса. Изменения вступают в силу после `/clear` или нового сеанса. См. [Как Claude Code использует prompt caching](/ru/prompt-caching#changing-output-style), чтобы узнать, что изменение output style делает с кешем.45Output style является частью системного prompt, который Claude Code читает один раз при запуске сеанса. Изменения вступают в силу после `/clear` или нового сеанса. См. [Как Claude Code использует prompt caching](/docs/ru/prompt-caching#changing-output-style), чтобы узнать, что изменение output style делает с кешем.

46 46 

47<h2 id="create-a-custom-output-style">47<h2 id="create-a-custom-output-style">

48 Создайте пользовательский output style48 Создайте пользовательский output style


56 56 

57 * Пользователь: `~/.claude/output-styles`57 * Пользователь: `~/.claude/output-styles`

58 * Проект: `.claude/output-styles`58 * Проект: `.claude/output-styles`

59 * Управляемая политика: `.claude/output-styles` внутри [управляемого каталога настроек](/ru/settings#settings-files)59 * Управляемая политика: `.claude/output-styles` внутри [управляемого каталога настроек](/docs/ru/settings#settings-files)

60 60 

61 Output styles проекта загружаются из каждого `.claude/output-styles/` между рабочей директорией и корнем репозитория. {/* min-version: 2.1.178 */}Начиная с версии 2.1.178, когда несколько из этих вложенных директорий определяют стиль с одинаковым именем, Claude Code использует тот, который находится ближе всего к рабочей директории.61 Output styles проекта загружаются из каждого `.claude/output-styles/` между рабочей директорией и корнем репозитория. Начиная с версии 2.1.178, когда несколько из этих вложенных директорий определяют стиль с одинаковым именем, Claude Code использует тот, который находится ближе всего к рабочей директории.

62 </Step>62 </Step>

63 63 

64 <Step title="Добавьте frontmatter и инструкции">64 <Step title="Добавьте frontmatter и инструкции">


86 </Step>86 </Step>

87</Steps>87</Steps>

88 88 

89[Plugins](/ru/plugins-reference) также могут поставляться с output styles в каталоге `output-styles/`.89[Plugins](/docs/ru/plugins-reference) также могут поставляться с output styles в каталоге `output-styles/`.

90 90 

91<h3 id="frontmatter">91<h3 id="frontmatter">

92 Frontmatter92 Frontmatter


122| Функция | Как это работает | Используйте это, когда |122| Функция | Как это работает | Используйте это, когда |

123| :----------------------- | :------------------------------------------------------------------------------ | :--------------------------------------------------------------------------- |123| :----------------------- | :------------------------------------------------------------------------------ | :--------------------------------------------------------------------------- |

124| Output styles | Изменяет системный prompt | Вы хотите другую роль, тон или формат ответа по умолчанию на каждом ходу |124| Output styles | Изменяет системный prompt | Вы хотите другую роль, тон или формат ответа по умолчанию на каждом ходу |

125| [CLAUDE.md](/ru/memory) | Добавляет пользовательское сообщение после системного prompt | Claude должен всегда знать соглашения вашего проекта и контекст кодовой базы |125| [CLAUDE.md](/docs/ru/memory) | Добавляет пользовательское сообщение после системного prompt | Claude должен всегда знать соглашения вашего проекта и контекст кодовой базы |

126| `--append-system-prompt` | Добавляет к системному prompt без удаления чего-либо | Вы хотите одноразовое добавление для одного вызова |126| `--append-system-prompt` | Добавляет к системному prompt без удаления чего-либо | Вы хотите одноразовое добавление для одного вызова |

127| [Agents](/ru/sub-agents) | Запускает подагента с его собственным системным prompt, моделью и инструментами | Вы хотите отдельно ограниченного помощника для сосредоточенной задачи |127| [Agents](/docs/ru/sub-agents) | Запускает подагента с его собственным системным prompt, моделью и инструментами | Вы хотите отдельно ограниченного помощника для сосредоточенной задачи |

128| [Skills](/ru/skills) | Загружает инструкции, специфичные для задачи, при вызове или при необходимости | У вас есть повторно используемый рабочий процесс |128| [Skills](/docs/ru/skills) | Загружает инструкции, специфичные для задачи, при вызове или при необходимости | У вас есть повторно используемый рабочий процесс |

129 129 

130<h2 id="related-resources">130<h2 id="related-resources">

131 Связанные ресурсы131 Связанные ресурсы

132</h2>132</h2>

133 133 

134* [Settings](/ru/settings): где находится поле `outputStyle` и как работает приоритет настроек134* [Settings](/docs/ru/settings): где находится поле `outputStyle` и как работает приоритет настроек

135* [Permission modes](/ru/permission-modes): как стиль Proactive сравнивается с режимом автоматизации135* [Permission modes](/docs/ru/permission-modes): как стиль Proactive сравнивается с режимом автоматизации

136* [Plugins](/ru/plugins): упакуйте и распространяйте output styles вместе с skills, hooks и agents136* [Plugins](/docs/ru/plugins): упакуйте и распространяйте output styles вместе с skills, hooks и agents

137* [Debug your configuration](/ru/debug-your-config): диагностируйте, почему output style не вступает в силу137* [Debug your configuration](/docs/ru/debug-your-config): диагностируйте, почему output style не вступает в силу

Details

27 27 

28Во всех режимах, кроме `bypassPermissions`, записи в [защищённые пути](#protected-paths) никогда не одобряются автоматически, защищая состояние репозитория и собственную конфигурацию Claude от случайного повреждения.28Во всех режимах, кроме `bypassPermissions`, записи в [защищённые пути](#protected-paths) никогда не одобряются автоматически, защищая состояние репозитория и собственную конфигурацию Claude от случайного повреждения.

29 29 

30Режимы устанавливают базовое поведение. Наложите [правила разрешений](/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа, явные правила запроса, [параметр организации `ask` на инструментах соединителя](/ru/mcp#organization-controls-on-connector-tools) и маркер [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool) применяются в каждом режиме, включая `bypassPermissions`. Правила разрешения не имеют эффекта в этом режиме, потому что всё остальное уже одобрено.30Режимы устанавливают базовое поведение. Наложите [правила разрешений](/docs/ru/permissions#manage-permissions) сверху, чтобы предварительно одобрить или заблокировать определённые инструменты. Правила отказа, явные правила запроса, [параметр организации `ask` на инструментах соединителя](/docs/ru/mcp#organization-controls-on-connector-tools) и маркер [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool) применяются в каждом режиме, включая `bypassPermissions`. Правила разрешения не имеют эффекта в этом режиме, потому что всё остальное уже одобрено.

31 31 

32<h2 id="switch-permission-modes">32<h2 id="switch-permission-modes">

33 Переключение режимов разрешений33 Переключение режимов разрешений


37 37 

38<Tabs>38<Tabs>

39 <Tab title="CLI">39 <Tab title="CLI">

40 **Во время сеанса**: нажмите `Shift+Tab` для циклического переключения `default` → `acceptEdits` → `plan`. Текущий режим отображается в строке состояния. {/* min-version: 2.1.203 */}Ручной режим, `default` в этом цикле, показывает серый значок `⏸ manual mode on`. До версии 2.1.203 строка состояния не показывала значок в ручном режиме.40 **Во время сеанса**: нажмите `Shift+Tab` для циклического переключения `default` → `acceptEdits` → `plan`. Текущий режим отображается в строке состояния. Ручной режим, `default` в этом цикле, показывает серый значок `⏸ manual mode on`. До версии 2.1.203 строка состояния не показывала значок в ручном режиме.

41 41 

42 Не все режимы находятся в цикле по умолчанию:42 Не все режимы находятся в цикле по умолчанию:

43 43 


53 claude --permission-mode plan53 claude --permission-mode plan

54 ```54 ```

55 55 

56 **По умолчанию**: установите `defaultMode` в [settings](/ru/settings#settings-files).56 **По умолчанию**: установите `defaultMode` в [settings](/docs/ru/settings#settings-files).

57 57 

58 ```json theme={null}58 ```json theme={null}

59 {59 {


63 }63 }

64 ```64 ```

65 65 

66 Тот же флаг `--permission-mode` работает с `-p` для [неинтерактивных запусков](/ru/headless).66 Тот же флаг `--permission-mode` работает с `-p` для [неинтерактивных запусков](/docs/ru/headless).

67 </Tab>67 </Tab>

68 68 

69 <Tab title="VS Code">69 <Tab title="VS Code">


83 83 

84 До версии 2.1.205 расширение обозначало `plan` как Plan mode и `auto` как Auto mode.84 До версии 2.1.205 расширение обозначало `plan` как Plan mode и `auto` как Auto mode.

85 85 

86 Auto mode появляется в индикаторе режима, когда ваша учётная запись соответствует каждому требованию, перечисленному в [разделе режима auto](#eliminate-prompts-with-auto-mode). Параметр `claudeCode.initialPermissionMode` не принимает `auto`. Чтобы запустить в режиме auto по умолчанию, установите `defaultMode` в вашем [пользовательском settings](/ru/settings#settings-files) вместо этого. Claude Code игнорирует `defaultMode: "auto"` в настройках проекта и локальных настройках.86 Auto mode появляется в индикаторе режима, когда ваша учётная запись соответствует каждому требованию, перечисленному в [разделе режима auto](#eliminate-prompts-with-auto-mode). Параметр `claudeCode.initialPermissionMode` не принимает `auto`. Чтобы запустить в режиме auto по умолчанию, установите `defaultMode` в вашем [пользовательском settings](/docs/ru/settings#settings-files) вместо этого. Claude Code игнорирует `defaultMode: "auto"` в настройках проекта и локальных настройках.

87 87 

88 Bypass permissions требует переключателя **Allow dangerously skip permissions** в настройках расширения перед тем, как он появится в индикаторе режима.88 Bypass permissions требует переключателя **Allow dangerously skip permissions** в настройках расширения перед тем, как он появится в индикаторе режима.

89 89 

90 Подробности, специфичные для расширения, см. в [руководстве VS Code](/ru/vs-code).90 Подробности, специфичные для расширения, см. в [руководстве VS Code](/docs/ru/vs-code).

91 </Tab>91 </Tab>

92 92 

93 <Tab title="JetBrains">93 <Tab title="JetBrains">


100 * **Auto**: появляется, когда ваша учётная запись соответствует [требованиям режима auto](#eliminate-prompts-with-auto-mode)100 * **Auto**: появляется, когда ваша учётная запись соответствует [требованиям режима auto](#eliminate-prompts-with-auto-mode)

101 * **Bypass permissions**: требует переключателя **Allow bypass permissions mode** в настройках Desktop на планах Pro и Max; на планах Team и Enterprise это контролируется политикой организации101 * **Bypass permissions**: требует переключателя **Allow bypass permissions mode** в настройках Desktop на планах Pro и Max; на планах Team и Enterprise это контролируется политикой организации

102 102 

103 Подробности, специфичные для desktop, см. в [Выбор режима разрешений](/ru/desktop#choose-a-permission-mode) в руководстве Desktop.103 Подробности, специфичные для desktop, см. в [Выбор режима разрешений](/docs/ru/desktop#choose-a-permission-mode) в руководстве Desktop.

104 104 

105 **По умолчанию**: установите `defaultMode` в [settings](/ru/settings#settings-files). Приложение desktop читает те же файлы настроек, что и CLI, и применяет режим к новым локальным сеансам.105 **По умолчанию**: установите `defaultMode` в [settings](/docs/ru/settings#settings-files). Приложение desktop читает те же файлы настроек, что и CLI, и применяет режим к новым локальным сеансам.

106 106 

107 Режим, который вы выбираете в селекторе режима, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки. Plan является исключением: его выбор применяется только к текущему сеансу.107 Режим, который вы выбираете в селекторе режима, запоминается для каждой папки и имеет приоритет над `defaultMode` для этой папки. Plan является исключением: его выбор применяется только к текущему сеансу.

108 108 


120 <Tab title="Web and mobile">120 <Tab title="Web and mobile">

121 Используйте раскрывающееся меню режима рядом с полем подсказки на [claude.ai/code](https://claude.ai/code) или в мобильном приложении. Запросы разрешений появляются в claude.ai для одобрения. Какие режимы появляются, зависит от того, где выполняется сеанс:121 Используйте раскрывающееся меню режима рядом с полем подсказки на [claude.ai/code](https://claude.ai/code) или в мобильном приложении. Запросы разрешений появляются в claude.ai для одобрения. Какие режимы появляются, зависит от того, где выполняется сеанс:

122 122 

123 * **Облачные сеансы** на [Claude Code в веб-версии](/ru/claude-code-on-the-web): Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачная среда предварительно одобряет редактирование файлов независимо от режима, поэтому раскрывающееся меню показывает Accept edits вместо Manual. Облачные сеансы по-прежнему соблюдают `defaultMode: "acceptEdits"` из настроек. Auto mode появляется только когда ваша организация это разрешает и выбранная модель это поддерживает. Bypass permissions недоступен.123 * **Облачные сеансы** на [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web): Accept edits, Plan и Auto. Accept edits соответствует режиму `default`: облачная среда предварительно одобряет редактирование файлов независимо от режима, поэтому раскрывающееся меню показывает Accept edits вместо Manual. Облачные сеансы по-прежнему соблюдают `defaultMode: "acceptEdits"` из настроек. Auto mode появляется только когда ваша организация это разрешает и выбранная модель это поддерживает. Bypass permissions недоступен.

124 * **Сеансы [Remote Control](/ru/remote-control)** на вашем локальном компьютере: Manual, Accept edits и Plan. Вы не можете выбрать Auto или Bypass permissions из приложения. {/* min-version: 2.1.202 */}Раскрывающееся меню показывает режим, в котором находится локальный сеанс, включая режим, установленный из терминала, и обновляется при изменении режима в приложении или в терминале. Единственное исключение — Bypass permissions: сеанс никогда не сообщает этот режим в claude.ai, поэтому переключение на него из терминала не изменяет то, что показывает раскрывающееся меню. До версии 2.1.202 сеансы, подключённые с помощью `/remote-control` или `claude --remote-control`, вообще не сообщали свой режим, поэтому claude.ai и мобильное приложение могли показывать режим, в котором сеанс не находился. Несоответствие влияло только на метку: Claude Code генерировал запросы разрешений из фактического режима сеанса, и они по-прежнему появлялись в приложении для одобрения.124 * **Сеансы [Remote Control](/docs/ru/remote-control)** на вашем локальном компьютере: Manual, Accept edits и Plan. Вы не можете выбрать Auto или Bypass permissions из приложения. Раскрывающееся меню показывает режим, в котором находится локальный сеанс, включая режим, установленный из терминала, и обновляется при изменении режима в приложении или в терминале. Единственное исключение — Bypass permissions: сеанс никогда не сообщает этот режим в claude.ai, поэтому переключение на него из терминала не изменяет то, что показывает раскрывающееся меню. До версии 2.1.202 сеансы, подключённые с помощью `/remote-control` или `claude --remote-control`, вообще не сообщали свой режим, поэтому claude.ai и мобильное приложение могли показывать режим, в котором сеанс не находился. Несоответствие влияло только на метку: Claude Code генерировал запросы разрешений из фактического режима сеанса, и они по-прежнему появлялись в приложении для одобрения.

125 125 

126 Для Remote Control вы также можете установить начальный режим при запуске хоста:126 Для Remote Control вы также можете установить начальный режим при запуске хоста:

127 127 


137 137 

138Режим `acceptEdits` позволяет Claude создавать и редактировать файлы в вашем рабочем каталоге без запроса. Строка состояния показывает `⏵⏵ accept edits on` пока этот режим активен.138Режим `acceptEdits` позволяет Claude создавать и редактировать файлы в вашем рабочем каталоге без запроса. Строка состояния показывает `⏵⏵ accept edits on` пока этот режим активен.

139 139 

140В дополнение к редактированию файлов, режим `acceptEdits` автоматически одобряет распространённые команды Bash файловой системы: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` и `sed`. Эти команды также автоматически одобряются при префиксе с безопасными переменными окружения, такими как `LANG=C` или `NO_COLOR=1`, или обёртками процессов, такими как `timeout`, `nice` или `nohup`. Как и редактирование файлов, автоматическое одобрение применяется только к путям внутри вашего рабочего каталога или `additionalDirectories`. Пути вне этой области, записи в [защищённые пути](#protected-paths) и все остальные команды Bash, кроме [встроенного набора только для чтения](/ru/permissions#read-only-commands), по-прежнему требуют запроса.140В дополнение к редактированию файлов, режим `acceptEdits` автоматически одобряет распространённые команды Bash файловой системы: `mkdir`, `touch`, `rm`, `rmdir`, `mv`, `cp` и `sed`. Эти команды также автоматически одобряются при префиксе с безопасными переменными окружения, такими как `LANG=C` или `NO_COLOR=1`, или обёртками процессов, такими как `timeout`, `nice` или `nohup`. Как и редактирование файлов, автоматическое одобрение применяется только к путям внутри вашего рабочего каталога или `additionalDirectories`. Пути вне этой области, записи в [защищённые пути](#protected-paths) и все остальные команды Bash, кроме [встроенного набора только для чтения](/docs/ru/permissions#read-only-commands), по-прежнему требуют запроса.

141 141 

142Когда инструмент [PowerShell](/ru/tools-reference#powershell-tool) включен, режим `acceptEdits` также автоматически одобряет `Set-Content`, `Add-Content`, `Clear-Content` и `Remove-Item` на путях в области действия, вместе с их распространёнными псевдонимами. Применяются те же правила области действия и защищённых путей.142Когда инструмент [PowerShell](/docs/ru/tools-reference#powershell-tool) включен, режим `acceptEdits` также автоматически одобряет `Set-Content`, `Add-Content`, `Clear-Content` и `Remove-Item` на путях в области действия, вместе с их распространёнными псевдонимами. Применяются те же правила области действия и защищённых путей.

143 143 

144Используйте `acceptEdits`, когда вы хотите проверить изменения в вашем редакторе или через `git diff` после того, как они будут сделаны, а не одобрять каждое редактирование в строке.144Используйте `acceptEdits`, когда вы хотите проверить изменения в вашем редакторе или через `git diff` после того, как они будут сделаны, а не одобрять каждое редактирование в строке.

145 145 


153 Анализируйте перед редактированием с режимом plan153 Анализируйте перед редактированием с режимом plan

154</h2>154</h2>

155 155 

156Plan mode указывает Claude исследовать и предложить изменения без их внесения. Claude читает файлы, запускает команды оболочки для исследования и пишет план, но не редактирует ваш исходный код. Запросы разрешений применяются так же, как в режиме Manual mode, если только [auto mode](/ru/auto-mode-config) недоступен и `useAutoModeDuringPlan` включен, что является значением по умолчанию. С активным режимом auto классификатор одобряет команды только для чтения, такие как поиск и чтение файлов, без запроса. Редактирования остаются заблокированными в любом случае, пока вы не одобрите план.156Plan mode указывает Claude исследовать и предложить изменения без их внесения. Claude читает файлы, запускает команды оболочки для исследования и пишет план, но не редактирует ваш исходный код. Запросы разрешений применяются так же, как в режиме Manual mode, если только [auto mode](/docs/ru/auto-mode-config) недоступен и `useAutoModeDuringPlan` включен, что является значением по умолчанию. С активным режимом auto классификатор одобряет команды только для чтения, такие как поиск и чтение файлов, без запроса. Редактирования остаются заблокированными в любом случае, пока вы не одобрите план.

157 157 

158Войдите в режим plan, нажав `Shift+Tab` или добавив префикс к одной подсказке с `/plan`. Вы также можете запустить в режиме plan из CLI:158Войдите в режим plan, нажав `Shift+Tab` или добавив префикс к одной подсказке с `/plan`. Вы также можете запустить в режиме plan из CLI:

159 159 


173* Одобрить и принять редактирование173* Одобрить и принять редактирование

174* Одобрить и проверить каждое редактирование вручную174* Одобрить и проверить каждое редактирование вручную

175* Продолжить планирование с обратной связью175* Продолжить планирование с обратной связью

176* Уточнить с помощью [Ultraplan](/ru/ultraplan) для проверки на основе браузера176* Уточнить с помощью [Ultraplan](/docs/ru/ultraplan) для проверки на основе браузера

177 177 

178Одобрение плана выходит из режима plan и переключает сеанс на режим разрешений, который описывает каждый вариант одобрения, поэтому Claude начинает редактирование. Чтобы снова планировать, вернитесь в режим plan с помощью `Shift+Tab` или добавьте префикс к следующей подсказке с `/plan`.178Одобрение плана выходит из режима plan и переключает сеанс на режим разрешений, который описывает каждый вариант одобрения, поэтому Claude начинает редактирование. Чтобы снова планировать, вернитесь в режим plan с помощью `Shift+Tab` или добавьте префикс к следующей подсказке с `/plan`.

179 179 

180Нажмите `Ctrl+G`, чтобы открыть предложенный план в текстовом редакторе по умолчанию и отредактировать его непосредственно перед тем, как Claude продолжит. Когда включена опция [`showClearContextOnPlanAccept`](/ru/settings#available-settings), каждый вариант одобрения также предлагает сначала очистить контекст планирования.180Нажмите `Ctrl+G`, чтобы открыть предложенный план в текстовом редакторе по умолчанию и отредактировать его непосредственно перед тем, как Claude продолжит. Когда включена опция [`showClearContextOnPlanAccept`](/docs/ru/settings#available-settings), каждый вариант одобрения также предлагает сначала очистить контекст планирования.

181 181 

182Принятие плана также автоматически называет сеанс на основе содержимого плана, если вы уже не установили имя с помощью `--name` или `/rename`.182Принятие плана также автоматически называет сеанс на основе содержимого плана, если вы уже не установили имя с помощью `--name` или `/rename`.

183 183 


199 Исключите запросы разрешений с режимом auto199 Исключите запросы разрешений с режимом auto

200</h2>200</h2>

201 201 

202Режим auto позволяет Claude выполнять действия без запросов разрешений. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя всё, что выходит за пределы вашего запроса, нацелено на неизвестную инфраструктуру или кажется вызванным враждебным содержимым, которое Claude прочитал. Явные [правила запроса](/ru/permissions#manage-permissions) по-прежнему вызывают запрос.202Режим auto позволяет Claude выполнять действия без запросов разрешений. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя всё, что выходит за пределы вашего запроса, нацелено на неизвестную инфраструктуру или кажется вызванным враждебным содержимым, которое Claude прочитал. Явные [правила запроса](/docs/ru/permissions#manage-permissions) по-прежнему вызывают запрос.

203 203 

204Удаления, нацеленные на корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, требуют одобрения вместо отправки классификатору. {/* min-version: 2.1.208 */}Этот запрос также срабатывает, когда команда содержит подстановку команд с `$(...)` или обратными кавычками, или подстановку процесса с `<(...)`, независимо от того, находится ли удаление внутри подстановки, как в `echo "$(rm -rf ~)"`, или в другом месте той же команды. До v2.1.208 команды, содержащие эти формы, отправлялись классификатору вместо запроса.204Удаления, нацеленные на корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, требуют одобрения вместо отправки классификатору. Этот запрос также срабатывает, когда команда содержит подстановку команд с `$(...)` или обратными кавычками, или подстановку процесса с `<(...)`, независимо от того, находится ли удаление внутри подстановки, как в `echo "$(rm -rf ~)"`, или в другом месте той же команды. До v2.1.208 команды, содержащие эти формы, отправлялись классификатору вместо запроса.

205 205 

206Режим auto также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude всё ещё спрашивает, когда ваш запрос или навык явно на этом полагается. Для более сильного автономного поведения при сохранении запросов разрешений установите вместо этого [Proactive output style](/ru/output-styles).206Режим auto также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude всё ещё спрашивает, когда ваш запрос или навык явно на этом полагается. Для более сильного автономного поведения при сохранении запросов разрешений установите вместо этого [Proactive output style](/docs/ru/output-styles).

207 207 

208<Warning>208<Warning>

209 Режим auto уменьшает запросы разрешений, но не гарантирует безопасность. Используйте его для задач, в которых вы доверяете общему направлению, а не как замену проверке чувствительных операций.209 Режим auto уменьшает запросы разрешений, но не гарантирует безопасность. Используйте его для задач, в которых вы доверяете общему направлению, а не как замену проверке чувствительных операций.


212Режим auto доступен только когда ваша учётная запись соответствует всем этим требованиям:212Режим auto доступен только когда ваша учётная запись соответствует всем этим требованиям:

213 213 

214* **План**: Все планы.214* **План**: Все планы.

215* **Владелец**: на Team и Enterprise владелец должен включить его в [настройках администратора Claude Code](https://claude.ai/admin-settings/claude-code) перед тем, как пользователи смогут его включить. Администраторы также могут отключить режим auto, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings). Для вкладки Code в приложении для рабочего стола `disableAutoMode` — это элемент управления на уровне организации, и переключатель в параметрах администратора не применяется.215* **Владелец**: на Team и Enterprise владелец должен включить его в [настройках администратора Claude Code](https://claude.ai/admin-settings/claude-code) перед тем, как пользователи смогут его включить. Администраторы также могут отключить режим auto, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/permissions#managed-settings). Для вкладки Code в приложении для рабочего стола `disableAutoMode` — это элемент управления на уровне организации, и переключатель в параметрах администратора не применяется.

216* **Модель**: на Anthropic API — Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах [Claude apps gateway](/ru/claude-apps-gateway) поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном поставщике.216* **Модель**: на Anthropic API — Claude Opus 4.6 или позже, или Sonnet 4.6 или позже. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном поставщике.

217* **Поставщик**: доступен по умолчанию на Anthropic API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах Claude apps gateway. {/* min-version: 2.1.207 */}В v2.1.158 через v2.1.206 режим auto был отключён на всех этих поставщиках, кроме Anthropic API, до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.217* **Поставщик**: доступен по умолчанию на Anthropic API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах Claude apps gateway. В v2.1.158 через v2.1.206 режим auto был отключён на всех этих поставщиках, кроме Anthropic API, до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`; v2.1.207 удалил это требование.

218 218 

219Если Claude Code сообщает, что режим auto недоступен, одно из этих требований не выполнено; это не временный сбой. Отдельное сообщение, которое называет модель и говорит, что режим auto "не может определить безопасность" действия, является временным сбоем классификатора; см. [справку по ошибкам](/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action).219Если Claude Code сообщает, что режим auto недоступен, одно из этих требований не выполнено; это не временный сбой. Отдельное сообщение, которое называет модель и говорит, что режим auto "не может определить безопасность" действия, является временным сбоем классификатора; см. [справку по ошибкам](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action).

220 220 

221Если вы установили `defaultMode: "auto"` в [параметрах](/ru/settings#available-settings) и сеанс начинается в режиме `default` без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. Claude Code v2.1.142 и позже игнорируют `auto` из этих файлов, поэтому репозиторий не может предоставить себе режим auto. Переместите его в `~/.claude/settings.json`.221Если вы установили `defaultMode: "auto"` в [параметрах](/docs/ru/settings#available-settings) и сеанс начинается в режиме `default` без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. Claude Code v2.1.142 и позже игнорируют `auto` из этих файлов, поэтому репозиторий не может предоставить себе режим auto. Переместите его в `~/.claude/settings.json`.

222 222 

223<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">223<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

224 Режим auto на Bedrock, Agent Platform или Foundry224 Режим auto на Bedrock, Agent Platform или Foundry

225</h3>225</h3>

226 226 

227На [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai), [Microsoft Foundry](/ru/microsoft-foundry) и подписанных сеансах [Claude apps gateway](/ru/claude-apps-gateway) режим auto появляется в цикле `Shift+Tab` по умолчанию. Появление в цикле не изменяет режим, в котором начинается сеанс: сеансы по-прежнему начинаются в вашем [`defaultMode`](/ru/settings#available-settings), который является Manual, если вы его не измените. На этих поставщиках поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8.227На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) и подписанных сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) режим auto появляется в цикле `Shift+Tab` по умолчанию. Появление в цикле не изменяет режим, в котором начинается сеанс: сеансы по-прежнему начинаются в вашем [`defaultMode`](/docs/ru/settings#available-settings), который является Manual, если вы его не измените. На этих поставщиках поддерживаются только Claude Sonnet 5, Opus 4.7 и Opus 4.8.

228 228 

229Чтобы сделать режим auto режимом запуска по умолчанию, установите `"permissions": {"defaultMode": "auto"}` в пользовательские или управляемые параметры.229Чтобы сделать режим auto режимом запуска по умолчанию, установите `"permissions": {"defaultMode": "auto"}` в пользовательские или управляемые параметры.

230 230 

231Чтобы предотвратить использование режима auto разработчиками, установите `disableAutoMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings). Это удаляет `auto` из цикла `Shift+Tab` и отклоняет `--permission-mode auto` при запуске.231Чтобы предотвратить использование режима auto разработчиками, установите `disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/permissions#managed-settings). Это удаляет `auto` из цикла `Shift+Tab` и отклоняет `--permission-mode auto` при запуске.

232 232 

233В v2.1.158 через v2.1.206 режим auto был отключён на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.233В v2.1.158 через v2.1.206 режим auto был отключён на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.

234 234 


236 Что классификатор блокирует по умолчанию236 Что классификатор блокирует по умолчанию

237</h3>237</h3>

238 238 

239Классификатор доверяет вашему рабочему каталогу и удалённым репозиториям, которые были настроены для него при запуске сеанса. {/* min-version: 2.1.200 */}Удалённый репозиторий, добавленный или переориентированный во время сеанса с помощью `git remote add` или `git remote set-url`, не является доверенным, и всё остальное рассматривается как внешнее до тех пор, пока вы не [настроите доверенную инфраструктуру](/ru/auto-mode-config). До v2.1.200 удалённые репозитории, добавленные в середине сеанса, также были доверенными.239Классификатор доверяет вашему рабочему каталогу и удалённым репозиториям, которые были настроены для него при запуске сеанса. Удалённый репозиторий, добавленный или переориентированный во время сеанса с помощью `git remote add` или `git remote set-url`, не является доверенным, и всё остальное рассматривается как внешнее до тех пор, пока вы не [настроите доверенную инфраструктуру](/docs/ru/auto-mode-config). До v2.1.200 удалённые репозитории, добавленные в середине сеанса, также были доверенными.

240 240 

241**Блокируется по умолчанию**:241**Блокируется по умолчанию**:

242 242 


248* Изменение общей инфраструктуры248* Изменение общей инфраструктуры

249* Необратимое уничтожение файлов, которые существовали до начала сеанса249* Необратимое уничтожение файлов, которые существовали до начала сеанса

250* Force push250* Force push

251* {/* min-version: 2.1.203 */}Отправка на ветвь по умолчанию репозитория, когда отправка содержит чувствительное содержимое, такое как секреты или личные или доверенные данные, содержит изменения скрытые или неправильно описанные относительно того, что вы просили, содержит содержимое перенесённое или впервые прочитанное из-за пределов репозитория, или обходит pull request, проверку или проверку, которую вы просили. Простая отправка на ветвь по умолчанию не блокируется сама по себе, и очистка отмеченной отправки требует назвать отмеченное содержимое или обойденную проверку, а не только отправку. Классификатор — это один слой: правила [`permissions.deny`](/ru/permissions#manage-permissions) применяются в каждом режиме и могут полностью блокировать отправки на ветвь по умолчанию, и защита ветвей самого удалённого репозитория по-прежнему применяется. До v2.1.203 любая прямая отправка на ветвь по умолчанию была заблокирована251* Отправка на ветвь по умолчанию репозитория, когда отправка содержит чувствительное содержимое, такое как секреты или личные или доверенные данные, содержит изменения скрытые или неправильно описанные относительно того, что вы просили, содержит содержимое перенесённое или впервые прочитанное из-за пределов репозитория, или обходит pull request, проверку или проверку, которую вы просили. Простая отправка на ветвь по умолчанию не блокируется сама по себе, и очистка отмеченной отправки требует назвать отмеченное содержимое или обойденную проверку, а не только отправку. Классификатор — это один слой: правила [`permissions.deny`](/docs/ru/permissions#manage-permissions) применяются в каждом режиме и могут полностью блокировать отправки на ветвь по умолчанию, и защита ветвей самого удалённого репозитория по-прежнему применяется. До v2.1.203 любая прямая отправка на ветвь по умолчанию была заблокирована

252* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` или `git stash clear`, которые классификатор предполагает отбросят незафиксированные изменения252* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` или `git stash clear`, которые классификатор предполагает отбросят незафиксированные изменения

253* `git commit --amend` когда коммит в HEAD не был создан в этом сеансе253* `git commit --amend` когда коммит в HEAD не был создан в этом сеансе

254* {/* min-version: 2.1.198 */}От v2.1.198 `git commit --amend` когда коммит в HEAD уже был отправлен. Переформулировка только сообщения не блокируется: `--amend -m` без ничего вновь подготовленного, на коммите, который Claude создал во время этого сеанса254* От v2.1.198 `git commit --amend` когда коммит в HEAD уже был отправлен. Переформулировка только сообщения не блокируется: `--amend -m` без ничего вновь подготовленного, на коммите, который Claude создал во время этого сеанса

255* `terraform destroy`, `pulumi destroy`, `cdk destroy` или `terragrunt destroy`, и применение плана, который уничтожает ресурсы255* `terraform destroy`, `pulumi destroy`, `cdk destroy` или `terragrunt destroy`, и применение плана, который уничтожает ресурсы

256 256 

257Claude Code v2.1.195 и позже блокируют больше категорий по умолчанию. Несколько зависят от записей [environment](/ru/auto-mode-config#define-trusted-infrastructure), таких как чувствительные удалённые цели и защищённые области IaC, которые вы можете сузить до конкретных имён.257Claude Code v2.1.195 и позже блокируют больше категорий по умолчанию. Несколько зависят от записей [environment](/docs/ru/auto-mode-config#define-trusted-infrastructure), таких как чувствительные удалённые цели и защищённые области IaC, которые вы можете сузить до конкретных имён.

258 258 

259* Запись в менеджер секретов или изменение записей DNS или сертификатов TLS259* Запись в менеджер секретов или изменение записей DNS или сертификатов TLS

260* Слияние pull request, который не одобрил ни один человек, одобрение собственного pull request Claude или отключение проверок CI260* Слияние pull request, который не одобрил ни один человек, одобрение собственного pull request Claude или отключение проверок CI


266* Интерактивные оболочки или port-forwards в чувствительную удалённую цель266* Интерактивные оболочки или port-forwards в чувствительную удалённую цель

267* Открытие туннеля или обратной оболочки, которая делает локальный сервис доступным из общедоступного интернета267* Открытие туннеля или обратной оболочки, которая делает локальный сервис доступным из общедоступного интернета

268* Вывод живого учётного данного или токена в стенограмму или файл268* Вывод живого учётного данного или токена в стенограмму или файл

269* Доступ к местоположению, указанному как чувствительное местоположение данных в вашем [environment](/ru/auto-mode-config#define-trusted-infrastructure), или копирование данных из одного. {/* min-version: 2.1.198 */}Начиная с v2.1.198 это также блокирует отправку данных из одного аудитории, которую запись исключает269* Доступ к местоположению, указанному как чувствительное местоположение данных в вашем [environment](/docs/ru/auto-mode-config#define-trusted-infrastructure), или копирование данных из одного. Начиная с v2.1.198 это также блокирует отправку данных из одного аудитории, которую запись исключает

270* Маршрутизация установки пакета вокруг вашего внутреннего реестра пакетов в общедоступный реестр. {/* min-version: 2.1.198 */}Начиная с v2.1.198 это также применяется когда вы сказали Claude, что внутренний реестр или зеркало существует в разговоре, а не только когда один указан в вашем environment270* Маршрутизация установки пакета вокруг вашего внутреннего реестра пакетов в общедоступный реестр. Начиная с v2.1.198 это также применяется когда вы сказали Claude, что внутренний реестр или зеркало существует в разговоре, а не только когда один указан в вашем environment

271* Запуск команды с флагом, который отключает защиту безопасности, например `--insecure`271* Запуск команды с флагом, который отключает защиту безопасности, например `--insecure`

272* Запуск автономного цикла агента, который работает без одобрения человека или песочницы, такой как один запущенный с `--dangerously-skip-permissions` или `--no-sandbox`. {/* min-version: 2.1.198 */}Начиная с v2.1.198 это также охватывает запуск агента третьей стороны или eval harness с отключённой изоляцией и одобрением для каждого действия, такой как runner запущенный с `--yes-always`272* Запуск автономного цикла агента, который работает без одобрения человека или песочницы, такой как один запущенный с `--dangerously-skip-permissions` или `--no-sandbox`. Начиная с v2.1.198 это также охватывает запуск агента третьей стороны или eval harness с отключённой изоляцией и одобрением для каждого действия, такой как runner запущенный с `--yes-always`

273* [Claude in Chrome](/ru/chrome) действия браузера, которые могут отправлять содержимое страницы, файлы cookie или учётные данные за пределы источника273* [Claude in Chrome](/docs/ru/chrome) действия браузера, которые могут отправлять содержимое страницы, файлы cookie или учётные данные за пределы источника

274 274 

275Claude Code v2.1.198 и позже также блокируют эти действия по умолчанию:275Claude Code v2.1.198 и позже также блокируют эти действия по умолчанию:

276 276 

277* Удаление файлов в `/tmp`, `$TMPDIR` или другом общем каталоге scratch или cache по подстановочному знаку, glob или фильтру возраста, а не по конкретному названному пути277* Удаление файлов в `/tmp`, `$TMPDIR` или другом общем каталоге scratch или cache по подстановочному знаку, glob или фильтру возраста, а не по конкретному названному пути

278* Включение чувствительных деталей в содержимое, отправленное, загруженное, опубликованное или написанное другим людям или общим системам, когда ваше собственное сообщение не авторизовало эти детали для этого получателя. {/* min-version: 2.1.200 */}Тела PR и issue, сообщения коммитов и комментарии считаются этим типом исходящего содержимого, когда репозиторий находится вне границы доверия или является общедоступным, включая собственные общедоступные репозитории вашей организации; внутренние пути файлов, кодовые имена, данные живого ответа API, такие как адреса электронной почты или идентификаторы учётных записей, и идентификаторы инфраструктуры считаются чувствительными деталями. Область действия PR, issue и сообщения коммита требует Claude Code v2.1.200 или позже. {/* min-version: 2.1.203 */}Живые личные данные из ответа API в теле PR или issue, такие как адрес электронной почты, идентификатор учётной записи или организации, или метрика использования, требуют, чтобы вы назвали эти детали и получателя независимо от видимости репозитория или границы доверия. Эта проверка требует Claude Code v2.1.203 или позже278* Включение чувствительных деталей в содержимое, отправленное, загруженное, опубликованное или написанное другим людям или общим системам, когда ваше собственное сообщение не авторизовало эти детали для этого получателя. Тела PR и issue, сообщения коммитов и комментарии считаются этим типом исходящего содержимого, когда репозиторий находится вне границы доверия или является общедоступным, включая собственные общедоступные репозитории вашей организации; внутренние пути файлов, кодовые имена, данные живого ответа API, такие как адреса электронной почты или идентификаторы учётных записей, и идентификаторы инфраструктуры считаются чувствительными деталями. Область действия PR, issue и сообщения коммита требует Claude Code v2.1.200 или позже. Живые личные данные из ответа API в теле PR или issue, такие как адрес электронной почты, идентификатор учётной записи или организации, или метрика использования, требуют, чтобы вы назвали эти детали и получателя независимо от видимости репозитория или границы доверия. Эта проверка требует Claude Code v2.1.203 или позже

279* Отправка нажатий клавиш в собственную tmux pane Claude Code для управления его собственным интерфейсом, что классификатор рассматривает как Claude изменяющий свои собственные разрешения или надзор279* Отправка нажатий клавиш в собственную tmux pane Claude Code для управления его собственным интерфейсом, что классификатор рассматривает как Claude изменяющий свои собственные разрешения или надзор

280 280 

281Claude Code v2.1.200 и позже также блокируют эти действия по умолчанию:281Claude Code v2.1.200 и позже также блокируют эти действия по умолчанию:


284* Удаление или разборка ресурса с состоянием, который Claude не создал в сеансе, когда не применяется более конкретное правило удаления и вы не назвали этот ресурс284* Удаление или разборка ресурса с состоянием, который Claude не создал в сеансе, когда не применяется более конкретное правило удаления и вы не назвали этот ресурс

285* Переориентация базового URL API, конечной точки прокси, получателя webhook или зеркала реестра на хост третьей стороны, который не соответствует задаче, включая в файлы примеров, такие как `.env.example`285* Переориентация базового URL API, конечной точки прокси, получателя webhook или зеркала реестра на хост третьей стороны, который не соответствует задаче, включая в файлы примеров, такие как `.env.example`

286* Изменение того, куда идут отправки, с помощью `git remote set-url` или `git remote add`, если вы не назвали новый удалённый репозиторий286* Изменение того, куда идут отправки, с помощью `git remote set-url` или `git remote add`, если вы не назвали новый удалённый репозиторий

287* Отправка секретов или личных или доверенных данных в репозиторий, известный как общедоступный, или отправка туда конфиденциального материала, который не является частью собственной работы этого репозитория. {/* min-version: 2.1.203 */}Собственный предмет репозитория dotfiles — единственное исключение для личных или доверенных данных, и содержимое из приватного репозитория, достигающее любой общедоступной поверхности, блокируется таким же образом; оба уточнения требуют Claude Code v2.1.203 или позже. До v2.1.203 личные данные были сгруппированы с конфиденциальным материалом и блокировались только когда они не были частью собственной работы этого репозитория. Когда видимость репозитория не установлена, классификатор не блокирует только на этом основании; вместо этого он судит содержимое по другим правилам287* Отправка секретов или личных или доверенных данных в репозиторий, известный как общедоступный, или отправка туда конфиденциального материала, который не является частью собственной работы этого репозитория. Собственный предмет репозитория dotfiles — единственное исключение для личных или доверенных данных, и содержимое из приватного репозитория, достигающее любой общедоступной поверхности, блокируется таким же образом; оба уточнения требуют Claude Code v2.1.203 или позже. До v2.1.203 личные данные были сгруппированы с конфиденциальным материалом и блокировались только когда они не были частью собственной работы этого репозитория. Когда видимость репозитория не установлена, классификатор не блокирует только на этом основании; вместо этого он судит содержимое по другим правилам

288* Открытие pull request против другого репозитория или организации, форк с помощью `gh repo fork` или отправка в репозиторий третьей стороны, если вы не назвали эту внешнюю цель288* Открытие pull request против другого репозитория или организации, форк с помощью `gh repo fork` или отправка в репозиторий третьей стороны, если вы не назвали эту внешнюю цель

289 289 

290Claude Code v2.1.203 и позже также блокируют эти действия по умолчанию:290Claude Code v2.1.203 и позже также блокируют эти действия по умолчанию:


303* Чтение `.env` и отправка учётных данных на соответствующий API303* Чтение `.env` и отправка учётных данных на соответствующий API

304* Запросы HTTP только для чтения304* Запросы HTTP только для чтения

305* Отправка на ветвь, с которой вы начали, или на ветвь, созданную Claude305* Отправка на ветвь, с которой вы начали, или на ветвь, созданную Claude

306* {/* min-version: 2.1.203 */}Обычные отправки на ветвь по умолчанию репозитория. До v2.1.203 любая прямая отправка на ветвь по умолчанию была заблокирована306* Обычные отправки на ветвь по умолчанию репозитория. До v2.1.203 любая прямая отправка на ветвь по умолчанию была заблокирована

307 307 

308Claude Code v2.1.195 и позже также разрешают эти действия по умолчанию:308Claude Code v2.1.195 и позже также разрешают эти действия по умолчанию:

309 309 

310* Удаление точных задач, которые Claude создал ранее в том же сеансе310* Удаление точных задач, которые Claude создал ранее в том же сеансе

311* Чтение, проверка или написание кода, конфигов и моделей угроз, связанных с безопасностью, как часть вашей задачи311* Чтение, проверка или написание кода, конфигов и моделей угроз, связанных с безопасностью, как часть вашей задачи

312* Сообщения между агентами, работающими вместе в одном многоагентном сеансе312* Сообщения между агентами, работающими вместе в одном многоагентном сеансе

313* Отправка данных на доверенные домены, корзины и сервисы, которые вы указываете в [`environment`](/ru/auto-mode-config#define-trusted-infrastructure). Это охватывает только поток данных, а не деструктивные или операции с учётными данными на той же инфраструктуре313* Отправка данных на доверенные домены, корзины и сервисы, которые вы указываете в [`environment`](/docs/ru/auto-mode-config#define-trusted-infrastructure). Это охватывает только поток данных, а не деструктивные или операции с учётными данными на той же инфраструктуре

314* [Claude in Chrome](/ru/chrome) навигация на доверенный внутренний домен, localhost или URL, который вы назвали314* [Claude in Chrome](/docs/ru/chrome) навигация на доверенный внутренний домен, localhost или URL, который вы назвали

315 315 

316Запросы доступа к сети в песочнице маршрутизируются через классификатор, а не разрешаются по умолчанию. {/* min-version: 2.1.198 */}Начиная с v2.1.198 классификатор повторно использует свой вердикт для сетевого хоста и порта вместо повторного запуска при каждом подключении:316Запросы доступа к сети в песочнице маршрутизируются через классификатор, а не разрешаются по умолчанию. Начиная с v2.1.198 классификатор повторно использует свой вердикт для сетевого хоста и порта вместо повторного запуска при каждом подключении:

317 317 

318* Разрешение повторно используется до тех пор, пока в разговор не поступит новое содержимое, в этот момент этот хост проверяется снова318* Разрешение повторно используется до тех пор, пока в разговор не поступит новое содержимое, в этот момент этот хост проверяется снова

319* В интерактивном CLI отказ отбрасывается когда ход заканчивается319* В интерактивном CLI отказ отбрасывается когда ход заканчивается

320* В [неинтерактивном режиме](/ru/headless) и сеансах Agent SDK нет границы хода, поэтому отказ повторно используется для остальной части запуска320* В [неинтерактивном режиме](/docs/ru/headless) и сеансах Agent SDK нет границы хода, поэтому отказ повторно используется для остальной части запуска

321* Изменение вашего режима разрешений или правил отбрасывает все кэшированные вердикты321* Изменение вашего режима разрешений или правил отбрасывает все кэшированные вердикты

322 322 

323Запустите `claude auto-mode defaults`, чтобы увидеть полные списки правил. Если обычные действия блокируются, администратор может добавить доверенные репозитории, корзины и сервисы через параметр `autoMode.environment`: см. [Настройка режима auto](/ru/auto-mode-config).323Запустите `claude auto-mode defaults`, чтобы увидеть полные списки правил. Если обычные действия блокируются, администратор может добавить доверенные репозитории, корзины и сервисы через параметр `autoMode.environment`: см. [Настройка режима auto](/docs/ru/auto-mode-config).

324 324 

325Отправка на вашу рабочую ветвь, обычная отправка на ветвь по умолчанию репозитория и создание pull request, который соответствует вашему запросу, всё это выполняется без запроса. Классификатор блокирует отправку только когда она несёт риск, такой как force push или содержимое, которое обходит проверку, которую вы установили. Чтобы требовать контрольную точку человека перед этими действиями, оставаясь в режиме auto, добавьте правила `permissions.ask`: см. [Общие границы](/ru/auto-mode-config#common-boundaries).325Отправка на вашу рабочую ветвь, обычная отправка на ветвь по умолчанию репозитория и создание pull request, который соответствует вашему запросу, всё это выполняется без запроса. Классификатор блокирует отправку только когда она несёт риск, такой как force push или содержимое, которое обходит проверку, которую вы установили. Чтобы требовать контрольную точку человека перед этими действиями, оставаясь в режиме auto, добавьте правила `permissions.ask`: см. [Общие границы](/docs/ru/auto-mode-config#common-boundaries).

326 326 

327<h3 id="boundaries-you-state-in-conversation">327<h3 id="boundaries-you-state-in-conversation">

328 Границы, которые вы указываете в разговоре328 Границы, которые вы указываете в разговоре


330 330 

331Классификатор рассматривает границы, которые вы указываете в разговоре, как сигнал блокировки. Если вы скажете Claude "не отправляй" или "подожди, пока я проверю перед развёртыванием", классификатор блокирует соответствующие действия даже когда правила по умолчанию их разрешили бы. Граница остаётся в силе до тех пор, пока вы её не снимете в более позднем сообщении. Собственное суждение Claude о том, что условие было выполнено, не снимает его.331Классификатор рассматривает границы, которые вы указываете в разговоре, как сигнал блокировки. Если вы скажете Claude "не отправляй" или "подожди, пока я проверю перед развёртыванием", классификатор блокирует соответствующие действия даже когда правила по умолчанию их разрешили бы. Граница остаётся в силе до тех пор, пока вы её не снимете в более позднем сообщении. Собственное суждение Claude о том, что условие было выполнено, не снимает его.

332 332 

333Границы не хранятся как правила. Классификатор перечитывает их из стенограммы при каждой проверке, поэтому граница может быть потеряна, если [компактирование контекста](/ru/costs#reduce-token-usage) удалит сообщение, которое её указало. Для жёсткой гарантии добавьте [правило deny](/ru/permissions#permission-rule-syntax) вместо этого.333Границы не хранятся как правила. Классификатор перечитывает их из стенограммы при каждой проверке, поэтому граница может быть потеряна, если [компактирование контекста](/docs/ru/costs#reduce-token-usage) удалит сообщение, которое её указало. Для жёсткой гарантии добавьте [правило deny](/docs/ru/permissions#permission-rule-syntax) вместо этого.

334 334 

335<h3 id="when-auto-mode-falls-back">335<h3 id="when-auto-mode-falls-back">

336 Когда режим auto откатывается336 Когда режим auto откатывается


340 340 

341Если классификатор блокирует действие 3 раза подряд или 20 раз всего, режим auto приостанавливается и Claude Code возобновляет запрос. Одобрение запрашиваемого действия возобновляет режим auto. Эти пороги не настраиваются. Любое разрешённое действие сбрасывает счётчик последовательных блокировок, в то время как счётчик всего сохраняется для сеанса и сбрасывается только когда его собственный лимит вызывает откат.341Если классификатор блокирует действие 3 раза подряд или 20 раз всего, режим auto приостанавливается и Claude Code возобновляет запрос. Одобрение запрашиваемого действия возобновляет режим auto. Эти пороги не настраиваются. Любое разрешённое действие сбрасывает счётчик последовательных блокировок, в то время как счётчик всего сохраняется для сеанса и сбрасывается только когда его собственный лимит вызывает откат.

342 342 

343В [неинтерактивном режиме](/ru/headless) с флагом `-p` повторные блокировки прерывают сеанс, так как нет пользователя для запроса.343В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` повторные блокировки прерывают сеанс, так как нет пользователя для запроса.

344 344 

345Повторные блокировки обычно означают, что классификатор не имеет контекста о вашей инфраструктуре. Используйте `/feedback` для сообщения о ложных срабатываниях или попросите администратора [настроить доверенную инфраструктуру](/ru/auto-mode-config).345Повторные блокировки обычно означают, что классификатор не имеет контекста о вашей инфраструктуре. Используйте `/feedback` для сообщения о ложных срабатываниях или попросите администратора [настроить доверенную инфраструктуру](/docs/ru/auto-mode-config).

346 346 

347<AccordionGroup>347<AccordionGroup>

348 <Accordion title="Как классификатор оценивает действия">348 <Accordion title="Как классификатор оценивает действия">

349 Каждое действие проходит через фиксированный порядок решений. Первый совпадающий шаг побеждает:349 Каждое действие проходит через фиксированный порядок решений. Первый совпадающий шаг побеждает:

350 350 

351 1. Действия, соответствующие вашим [правилам allow, ask или deny](/ru/permissions#manage-permissions), разрешаются немедленно. Записи в [защищённые пути](#protected-paths) маршрутизируются классификатору даже когда правило allow совпадает. Инструменты Connector [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), запрашивают вас напрямую даже когда правило allow совпадает. Правила ask с областью действия содержимого откатываются к запросу разрешения351 1. Действия, соответствующие вашим [правилам allow, ask или deny](/docs/ru/permissions#manage-permissions), разрешаются немедленно. Записи в [защищённые пути](#protected-paths) маршрутизируются классификатору даже когда правило allow совпадает. Инструменты Connector [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), запрашивают вас напрямую даже когда правило allow совпадает. Правила ask с областью действия содержимого откатываются к запросу разрешения

352 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищённые пути](#protected-paths)352 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищённые пути](#protected-paths)

353 3. Всё остальное идёт классификатору. Инструмент Connector [установленный вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) пропускает классификатор и запрашивает вас напрямую, поэтому одобрение, требуемое организацией, никогда не одобряется автоматически. {/* min-version: 2.1.199 */}Начиная с v2.1.199 инструмент MCP, отмеченный с [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), также пропускает классификатор и запрашивает вас напрямую, поэтому шаг согласия никогда не одобряется автоматически от имени автора инструмента353 3. Всё остальное идёт классификатору. Инструмент Connector [установленный вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) пропускает классификатор и запрашивает вас напрямую, поэтому одобрение, требуемое организацией, никогда не одобряется автоматически. Начиная с v2.1.199 инструмент MCP, отмеченный с [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), также пропускает классификатор и запрашивает вас напрямую, поэтому шаг согласия никогда не одобряется автоматически от имени автора инструмента

354 4. Если классификатор блокирует, Claude получает причину и пытается найти альтернативу354 4. Если классификатор блокирует, Claude получает причину и пытается найти альтернативу

355 355 

356 При входе в режим auto широкие правила allow, которые предоставляют произвольное выполнение кода, отбрасываются:356 При входе в режим auto широкие правила allow, которые предоставляют произвольное выполнение кода, отбрасываются:


366 </Accordion>366 </Accordion>

367 367 

368 <Accordion title="Как режим auto обрабатывает подагентов">368 <Accordion title="Как режим auto обрабатывает подагентов">

369 Классификатор проверяет работу [подагента](/ru/sub-agents) в трёх точках:369 Классификатор проверяет работу [подагента](/docs/ru/sub-agents) в трёх точках:

370 370 

371 1. Перед запуском подагента описание делегированной задачи оценивается, так что опасно выглядящая задача блокируется во время порождения.371 1. Перед запуском подагента описание делегированной задачи оценивается, так что опасно выглядящая задача блокируется во время порождения.

372 2. Пока подагент работает, каждое его действие проходит через классификатор с теми же правилами, что и родительский сеанс, и любой `permissionMode` в frontmatter подагента игнорируется.372 2. Пока подагент работает, каждое его действие проходит через классификатор с теми же правилами, что и родительский сеанс, и любой `permissionMode` в frontmatter подагента игнорируется.


376 </Accordion>376 </Accordion>

377 377 

378 <Accordion title="Стоимость и задержка">378 <Accordion title="Стоимость и задержка">

379 Классификатор работает на модели, настроенной на сервере, которая независима от вашего выбора `/model`, поэтому переключение моделей не изменяет доступность классификатора. Вызовы классификатора учитываются в использовании токенов. Каждая проверка отправляет часть стенограммы плюс ожидающее действие, добавляя круговой путь перед выполнением. Чтение и редактирование рабочего каталога вне защищённых путей пропускают классификатор, поэтому накладные расходы поступают в основном от команд оболочки и сетевых операций. {/* min-version: 2.1.198 */}Начиная с v2.1.198 вердикт песочницы для сетевого хоста и порта повторно используется вместо переклассификации при каждом подключении, поэтому повторные подключения к одному хосту не добавляют каждый раз проверку. [Что классификатор блокирует по умолчанию](#what-the-classifier-blocks-by-default) описывает как долго разрешение и отказ длятся.379 Классификатор работает на модели, настроенной на сервере, которая независима от вашего выбора `/model`, поэтому переключение моделей не изменяет доступность классификатора. Вызовы классификатора учитываются в использовании токенов. Каждая проверка отправляет часть стенограммы плюс ожидающее действие, добавляя круговой путь перед выполнением. Чтение и редактирование рабочего каталога вне защищённых путей пропускают классификатор, поэтому накладные расходы поступают в основном от команд оболочки и сетевых операций. Начиная с v2.1.198 вердикт песочницы для сетевого хоста и порта повторно используется вместо переклассификации при каждом подключении, поэтому повторные подключения к одному хосту не добавляют каждый раз проверку. [Что классификатор блокирует по умолчанию](#what-the-classifier-blocks-by-default) описывает как долго разрешение и отказ длятся.

380 </Accordion>380 </Accordion>

381</AccordionGroup>381</AccordionGroup>

382 382 


384 Разрешить только предварительно одобренные инструменты с режимом dontAsk384 Разрешить только предварительно одобренные инструменты с режимом dontAsk

385</h2>385</h2>

386 386 

387Если вы установите режим `dontAsk`, Claude Code автоматически отклоняет каждый вызов инструмента, который иначе требовал бы запроса. Claude выполняет только действия, соответствующие вашим правилам `permissions.allow`, [командам Bash только для чтения](/ru/permissions#read-only-commands) и вызовам, одобренным [hook PreToolUse](/ru/permissions#extend-permissions-with-hooks). Используйте этот режим для конвейеров CI или ограниченных сред, где вы предварительно определяете ровно то, что Claude может делать; сеанс никогда не ждёт ввода. Строка состояния показывает `⏵⏵ don't ask on`, пока этот режим активен.387Если вы установите режим `dontAsk`, Claude Code автоматически отклоняет каждый вызов инструмента, который иначе требовал бы запроса. Claude выполняет только действия, соответствующие вашим правилам `permissions.allow`, [командам Bash только для чтения](/docs/ru/permissions#read-only-commands) и вызовам, одобренным [hook PreToolUse](/docs/ru/permissions#extend-permissions-with-hooks). Используйте этот режим для конвейеров CI или ограниченных сред, где вы предварительно определяете ровно то, что Claude может делать; сеанс никогда не ждёт ввода. Строка состояния показывает `⏵⏵ don't ask on`, пока этот режим активен.

388 388 

389Claude Code отклоняет вызовы, соответствующие вашим явным правилам [`ask`](/ru/permissions#manage-permissions), а не запрашивает их. Он также отклоняет встроенный инструмент `AskUserQuestion` и инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools), даже если ваши правила разрешения совпадают. {/* min-version: 2.1.199 */}Он отклоняет инструменты MCP, отмеченные [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool) таким же образом, потому что их карточка одобрения требует ответа, который этот режим никогда не собирает; это требует Claude Code версии 2.1.199 или позже.389Claude Code отклоняет вызовы, соответствующие вашим явным правилам [`ask`](/docs/ru/permissions#manage-permissions), а не запрашивает их. Он также отклоняет встроенный инструмент `AskUserQuestion` и инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools), даже если ваши правила разрешения совпадают. Он отклоняет инструменты MCP, отмеченные [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool) таким же образом, потому что их карточка одобрения требует ответа, который этот режим никогда не собирает; это требует Claude Code версии 2.1.199 или позже.

390 390 

391Облачные сеансы на [Claude Code в веб-версии](/ru/claude-code-on-the-web) игнорируют `defaultMode: "dontAsk"`; см. [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) для получения подробной информации.391Облачные сеансы на [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) игнорируют `defaultMode: "dontAsk"`; см. [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode) для получения подробной информации.

392 392 

393Установите его при запуске с флагом:393Установите его при запуске с флагом:

394 394 


402 402 

403Режим `bypassPermissions` отключает запросы разрешений и проверки безопасности, чтобы вызовы инструментов выполнялись немедленно, включая записи в [защищённые пути](#protected-paths). До версии 2.1.126 записи в защищённые пути по-прежнему выдавали запросы в этом режиме.403Режим `bypassPermissions` отключает запросы разрешений и проверки безопасности, чтобы вызовы инструментов выполнялись немедленно, включая записи в [защищённые пути](#protected-paths). До версии 2.1.126 записи в защищённые пути по-прежнему выдавали запросы в этом режиме.

404 404 

405Явные [правила ask](/ru/permissions#manage-permissions) и инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) по-прежнему принудительно выдают запрос в этом режиме. {/* min-version: 2.1.199 */}Инструменты MCP, отмеченные с помощью [`_meta["anthropic/requiresUserInteraction"]`](/ru/mcp#require-approval-for-a-specific-tool), также по-прежнему выдают запросы; это требует Claude Code версии 2.1.199 или более поздней.405Явные [правила ask](/docs/ru/permissions#manage-permissions) и инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) по-прежнему принудительно выдают запрос в этом режиме. Инструменты MCP, отмеченные с помощью [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), также по-прежнему выдают запросы; это требует Claude Code версии 2.1.199 или более поздней.

406 406 

407Удаления, нацеленные на корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, по-прежнему выдают запросы в качестве защиты от ошибок модели. {/* min-version: 2.1.208 */}Защита также срабатывает, когда команда содержит подстановку команд с `$(...)` или обратными кавычками, или подстановку процесса с `<(...)`, независимо от того, находится ли удаление внутри подстановки, как в `echo "$(rm -rf ~)"`, или в другом месте той же команды. Простая форма, введённая как отдельная команда, выдавала запросы в этом режиме с момента введения защиты; до версии 2.1.208 команды, содержащие эти формы, не выдавали запросы.407Удаления, нацеленные на корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, по-прежнему выдают запросы в качестве защиты от ошибок модели. Защита также срабатывает, когда команда содержит подстановку команд с `$(...)` или обратными кавычками, или подстановку процесса с `<(...)`, независимо от того, находится ли удаление внутри подстановки, как в `echo "$(rm -rf ~)"`, или в другом месте той же команды. Простая форма, введённая как отдельная команда, выдавала запросы в этом режиме с момента введения защиты; до версии 2.1.208 команды, содержащие эти формы, не выдавали запросы.

408 408 

409<Warning>409<Warning>

410 Используйте этот режим только в изолированных средах, таких как контейнеры, виртуальные машины или dev containers без доступа в Интернет, где Claude Code не может повредить вашу хост-систему.410 Используйте этот режим только в изолированных средах, таких как контейнеры, виртуальные машины или dev containers без доступа в Интернет, где Claude Code не может повредить вашу хост-систему.


424--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons424--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

425```425```

426 426 

427Проверка пропускается автоматически внутри признанной песочницы. Для автономного запуска в контейнере используйте конфигурацию [dev container](/ru/devcontainer), которая запускает Claude Code от непривилегированного пользователя.427Проверка пропускается автоматически внутри признанной песочницы. Для автономного запуска в контейнере используйте конфигурацию [dev container](/docs/ru/devcontainer), которая запускает Claude Code от непривилегированного пользователя.

428 428 

429[Claude Code в веб-версии](/ru/claude-code-on-the-web) не учитывает `defaultMode: "bypassPermissions"` или `"dontAsk"` из ваших файлов параметров, поэтому проверенные в репозитории параметры не могут запустить облачный сеанс в режиме bypass-permissions. Параметр игнорируется молча, и сеанс запускается в режиме, показанном в раскрывающемся списке режимов вместо этого. См. [Переключение режимов разрешений](#switch-permission-modes) для информации о том, какие режимы предлагают облачные сеансы.429[Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) не учитывает `defaultMode: "bypassPermissions"` или `"dontAsk"` из ваших файлов параметров, поэтому проверенные в репозитории параметры не могут запустить облачный сеанс в режиме bypass-permissions. Параметр игнорируется молча, и сеанс запускается в режиме, показанном в раскрывающемся списке режимов вместо этого. См. [Переключение режимов разрешений](#switch-permission-modes) для информации о том, какие режимы предлагают облачные сеансы.

430 430 

431<Warning>431<Warning>

432 `bypassPermissions` не обеспечивает защиту от инъекции подсказок или непредвиденных действий. Для фоновых проверок безопасности с гораздо меньшим количеством запросов разрешений используйте [режим auto](#eliminate-prompts-with-auto-mode) вместо этого. Администраторы могут заблокировать этот режим, установив `permissions.disableBypassPermissionsMode` на `"disable"` в [управляемых параметрах](/ru/permissions#managed-settings).432 `bypassPermissions` не обеспечивает защиту от инъекции подсказок или непредвиденных действий. Для фоновых проверок безопасности с гораздо меньшим количеством запросов разрешений используйте [режим auto](#eliminate-prompts-with-auto-mode) вместо этого. Администраторы могут заблокировать этот режим, установив `permissions.disableBypassPermissionsMode` на `"disable"` в [управляемых параметрах](/docs/ru/permissions#managed-settings).

433</Warning>433</Warning>

434 434 

435<h2 id="protected-paths">435<h2 id="protected-paths">


445| `dontAsk` | Отклоняются |445| `dontAsk` | Отклоняются |

446| `bypassPermissions` | Разрешены |446| `bypassPermissions` | Разрешены |

447 447 

448Правила [`permissions.allow`](/ru/permissions#manage-permissions) в файлах параметров не предварительно одобряют записи в защищённые пути. Проверка безопасности выполняется до того, как Claude Code оценивает правила allow из параметров, поэтому запись вроде `Edit(.claude/**)` в `~/.claude/settings.json` или `.claude/settings.json` не изменяет результат для каждого режима в таблице выше. В режимах, которые требуют подтверждения, подсказка для записи `.claude/` предлагает **Да, и разрешить Claude редактировать свои собственные параметры для этого сеанса**, что одобряет последующие записи `.claude/` в этом сеансе без повторного запроса.448Правила [`permissions.allow`](/docs/ru/permissions#manage-permissions) в файлах параметров не предварительно одобряют записи в защищённые пути. Проверка безопасности выполняется до того, как Claude Code оценивает правила allow из параметров, поэтому запись вроде `Edit(.claude/**)` в `~/.claude/settings.json` или `.claude/settings.json` не изменяет результат для каждого режима в таблице выше. В режимах, которые требуют подтверждения, подсказка для записи `.claude/` предлагает **Да, и разрешить Claude редактировать свои собственные параметры для этого сеанса**, что одобряет последующие записи `.claude/` в этом сеансе без повторного запроса.

449 449 

450Защищённые каталоги:450Защищённые каталоги:

451 451 


476 См. также476 См. также

477</h2>477</h2>

478 478 

479* [Permissions](/ru/permissions): правила allow, ask и deny; управляемые политики479* [Permissions](/docs/ru/permissions): правила allow, ask и deny; управляемые политики

480* [Configure auto mode](/ru/auto-mode-config): скажите классификатору, какую инфраструктуру ваша организация доверяет480* [Configure auto mode](/docs/ru/auto-mode-config): скажите классификатору, какую инфраструктуру ваша организация доверяет

481* [Hooks](/ru/hooks): пользовательская логика разрешений через hooks `PreToolUse` и `PermissionRequest`481* [Hooks](/docs/ru/hooks): пользовательская логика разрешений через hooks `PreToolUse` и `PermissionRequest`

482* [Ultraplan](/ru/ultraplan): запустите режим plan в сеансе Claude Code в веб-версии с проверкой на основе браузера482* [Ultraplan](/docs/ru/ultraplan): запустите режим plan в сеансе Claude Code в веб-версии с проверкой на основе браузера

483* [Security](/ru/security): гарантии безопасности и лучшие практики483* [Security](/docs/ru/security): гарантии безопасности и лучшие практики

484* [Sandboxing](/ru/sandboxing): изоляция файловой системы и сети для команд Bash484* [Sandboxing](/docs/ru/sandboxing): изоляция файловой системы и сети для команд Bash

485* [Non-interactive mode](/ru/headless): запустите Claude Code с флагом `-p`485* [Non-interactive mode](/docs/ru/headless): запустите Claude Code с флагом `-p`

permissions.md +57 −57

Details

22 22 

23При появлении запроса разрешения Bash или PowerShell нажмите `Ctrl+E` для отображения объяснения команды: что она делает, почему Claude её выполняет и что может пойти не так, обозначено как **Low risk**, **Med risk** или **High risk**. Claude Code отправляет команду и собственное описание Claude вызова модели для создания объяснения только при нажатии `Ctrl+E`, а не при каждом запросе. Отображение объяснения не выполняет команду; нажмите `Ctrl+E` снова, чтобы скрыть его.23При появлении запроса разрешения Bash или PowerShell нажмите `Ctrl+E` для отображения объяснения команды: что она делает, почему Claude её выполняет и что может пойти не так, обозначено как **Low risk**, **Med risk** или **High risk**. Claude Code отправляет команду и собственное описание Claude вызова модели для создания объяснения только при нажатии `Ctrl+E`, а не при каждом запросе. Отображение объяснения не выполняет команду; нажмите `Ctrl+E` снова, чтобы скрыть его.

24 24 

25Чтобы отключить сочетание клавиш, установите [`permissionExplainerEnabled`](/ru/settings#global-config-settings) на `false` в `~/.claude.json`.25Чтобы отключить сочетание клавиш, установите [`permissionExplainerEnabled`](/docs/ru/settings#global-config-settings) на `false` в `~/.claude.json`.

26 26 

27<h2 id="manage-permissions">27<h2 id="manage-permissions">

28 Управление разрешениями28 Управление разрешениями


41Правила Deny ведут себя по-разному в зависимости от того, называют ли они инструмент или определяют область действия шаблона внутри него. Простое имя инструмента, такое как `Bash`, удаляет инструмент из контекста Claude полностью, поэтому Claude его никогда не видит. Правило с областью действия, такое как `Bash(rm *)`, оставляет инструмент доступным и блокирует совпадающие вызовы, когда Claude пытается их выполнить.41Правила Deny ведут себя по-разному в зависимости от того, называют ли они инструмент или определяют область действия шаблона внутри него. Простое имя инструмента, такое как `Bash`, удаляет инструмент из контекста Claude полностью, поэтому Claude его никогда не видит. Правило с областью действия, такое как `Bash(rm *)`, оставляет инструмент доступным и блокирует совпадающие вызовы, когда Claude пытается их выполнить.

42 42 

43<Note>43<Note>

44 Правила разрешений применяются Claude Code, а не моделью. Инструкции в вашем приглашении или `CLAUDE.md` определяют, что Claude пытается делать, но они не изменяют то, что позволяет Claude Code. Чтобы предоставить или отозвать доступ, используйте `/permissions`, правила, описанные здесь, [режим разрешений](/ru/permission-modes) или [hook PreToolUse](#extend-permissions-with-hooks).44 Правила разрешений применяются Claude Code, а не моделью. Инструкции в вашем приглашении или `CLAUDE.md` определяют, что Claude пытается делать, но они не изменяют то, что позволяет Claude Code. Чтобы предоставить или отозвать доступ, используйте `/permissions`, правила, описанные здесь, [режим разрешений](/docs/ru/permission-modes) или [hook PreToolUse](#extend-permissions-with-hooks).

45</Note>45</Note>

46 46 

47<h2 id="permission-modes">47<h2 id="permission-modes">

48 Режимы разрешений48 Режимы разрешений

49</h2>49</h2>

50 50 

51Claude Code поддерживает несколько режимов разрешений, которые контролируют, как он одобряет вызовы инструментов. См. [Permission modes](/ru/permission-modes) для определения того, когда использовать каждый из них. Установите `defaultMode` в ваших [файлах параметров](/ru/settings#settings-files):51Claude Code поддерживает несколько режимов разрешений, которые контролируют, как он одобряет вызовы инструментов. См. [Permission modes](/docs/ru/permission-modes) для определения того, когда использовать каждый из них. Установите `defaultMode` в ваших [файлах параметров](/docs/ru/settings#settings-files):

52 52 

53| Режим | Описание |53| Режим | Описание |

54| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |54| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

55| `default` | Стандартное поведение: запрашивает разрешение при первом использовании каждого инструмента. {/* min-version: 2.1.200 */}В CLI и расширениях VS Code и JetBrains обозначается как Manual, в приложении для рабочего стола, и Claude Code принимает `manual` как псевдоним. Метка и псевдоним требуют Claude Code v2.1.200 или более поздней версии. Метка приложения для рабочего стола не зависит от вашей версии CLI |55| `default` | Стандартное поведение: запрашивает разрешение при первом использовании каждого инструмента. В CLI и расширениях VS Code и JetBrains обозначается как Manual, в приложении для рабочего стола, и Claude Code принимает `manual` как псевдоним. Метка и псевдоним требуют Claude Code v2.1.200 или более поздней версии. Метка приложения для рабочего стола не зависит от вашей версии CLI |

56| `acceptEdits` | Автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp` для путей в рабочем каталоге или `additionalDirectories` |56| `acceptEdits` | Автоматически принимает редактирование файлов и общие команды файловой системы, такие как `mkdir`, `touch`, `mv` и `cp` для путей в рабочем каталоге или `additionalDirectories` |

57| `plan` | Claude читает файлы и запускает команды оболочки только для чтения для исследования, но не редактирует ваши исходные файлы. Обозначается как Plan в CLI и расширении VS Code |57| `plan` | Claude читает файлы и запускает команды оболочки только для чтения для исследования, но не редактирует ваши исходные файлы. Обозначается как Plan в CLI и расширении VS Code |

58| `auto` | Автоматически одобряет вызовы инструментов с проверками безопасности в фоне, которые проверяют, соответствуют ли действия вашему запросу |58| `auto` | Автоматически одобряет вызовы инструментов с проверками безопасности в фоне, которые проверяют, соответствуют ли действия вашему запросу |

59| `dontAsk` | Автоматически отклоняет инструменты, если они не предварительно одобрены через `/permissions` или правила `permissions.allow`. `AskUserQuestion`, инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), отклоняются даже если вы их разрешили |59| `dontAsk` | Автоматически отклоняет инструменты, если они не предварительно одобрены через `/permissions` или правила `permissions.allow`. `AskUserQuestion`, инструменты соединителя [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), отклоняются даже если вы их разрешили |

60| `bypassPermissions` | Пропускает запросы разрешений, за исключением тех, которые вынуждены явными правилами `ask`, инструментами соединителя [установленными вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструментами MCP, отмеченными [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool). Удаления корневого каталога и домашнего каталога, такие как `rm -rf /`, также по-прежнему запрашивают подтверждение в качестве защиты от ошибок модели |60| `bypassPermissions` | Пропускает запросы разрешений, за исключением тех, которые вынуждены явными правилами `ask`, инструментами соединителя [установленными вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструментами MCP, отмеченными [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool). Удаления корневого каталога и домашнего каталога, такие как `rm -rf /`, также по-прежнему запрашивают подтверждение в качестве защиты от ошибок модели |

61 61 

62<Warning>62<Warning>

63 Режим `bypassPermissions` пропускает запросы разрешений, включая записи в `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` и `.mvn`. Используйте этот режим только в изолированных средах, таких как контейнеры или виртуальные машины, где Claude Code не может причинить вред.63 Режим `bypassPermissions` пропускает запросы разрешений, включая записи в `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` и `.mvn`. Используйте этот режим только в изолированных средах, таких как контейнеры или виртуальные машины, где Claude Code не может причинить вред.

64 64 

65 В этом режиме по-прежнему срабатывают несколько запросов. Явные правила `ask`, инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), по-прежнему запрашивают подтверждение. Удаления, затрагивающие корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, также запрашивают подтверждение в качестве защиты от ошибок модели, {/* min-version: 2.1.208 */}включая случаи, когда команда содержит подстановку команд с `$(...)` или обратными кавычками, или подстановку процесса с `<(...)`. До версии v2.1.208 запрашивалась только простая форма, такая как `rm -rf ~`, введённая как отдельная команда; команды, которые достигали удаления через подстановку, не запрашивали подтверждение.65 В этом режиме по-прежнему срабатывают несколько запросов. Явные правила `ask`, инструменты соединителя [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), по-прежнему запрашивают подтверждение. Удаления, затрагивающие корневой каталог файловой системы или домашний каталог, такие как `rm -rf /` и `rm -rf ~`, также запрашивают подтверждение в качестве защиты от ошибок модели, включая случаи, когда команда содержит подстановку команд с `$(...)` или обратными кавычками, или подстановку процесса с `<(...)`. До версии v2.1.208 запрашивалась только простая форма, такая как `rm -rf ~`, введённая как отдельная команда; команды, которые достигали удаления через подстановку, не запрашивали подтверждение.

66</Warning>66</Warning>

67 67 

68Чтобы предотвратить использование режима `bypassPermissions` или `auto`, установите `permissions.disableBypassPermissionsMode` или `permissions.disableAutoMode` на `"disable"` в любом [файле параметров](/ru/settings#settings-files). Это наиболее полезно в [управляемых параметрах](#managed-settings), где они не могут быть переопределены.68Чтобы предотвратить использование режима `bypassPermissions` или `auto`, установите `permissions.disableBypassPermissionsMode` или `permissions.disableAutoMode` на `"disable"` в любом [файле параметров](/docs/ru/settings#settings-files). Это наиболее полезно в [управляемых параметрах](#managed-settings), где они не могут быть переопределены.

69 69 

70<h2 id="permission-rule-syntax">70<h2 id="permission-rule-syntax">

71 Синтаксис правил разрешений71 Синтаксис правил разрешений


117* Каждое правило называет один параметр. Чтобы ограничить как `model`, так и `isolation`, напишите два правила, `Agent(model:opus)` и `Agent(isolation:worktree)`, вместо того чтобы объединять их в одно правило117* Каждое правило называет один параметр. Чтобы ограничить как `model`, так и `isolation`, напишите два правила, `Agent(model:opus)` и `Agent(isolation:worktree)`, вместо того чтобы объединять их в одно правило

118* Значение поддерживает `*` как подстановочный символ, который совпадает с любой последовательностью символов, поэтому `Agent(isolation:*)` совпадает с любым явным значением изоляции. Без `*` совпадение точное118* Значение поддерживает `*` как подстановочный символ, который совпадает с любой последовательностью символов, поэтому `Agent(isolation:*)` совпадает с любым явным значением изоляции. Без `*` совпадение точное

119* Параметр, который модель опускает, никогда не совпадает, поэтому `Agent(model:*)` не совпадает с вызовом, который оставляет `model` неустановленным119* Параметр, который модель опускает, никогда не совпадает, поэтому `Agent(model:*)` не совпадает с вызовом, который оставляет `model` неустановленным

120* Значение сравнивается с буквальным входом, который отправляет Claude, до любой нормализации. `Agent(model:opus)` совпадает с псевдонимом `opus`, но не с полным ID модели. Запустите с [`--verbose`](/ru/cli-reference), чтобы увидеть точные имена параметров и значения в каждом вызове инструмента120* Значение сравнивается с буквальным входом, который отправляет Claude, до любой нормализации. `Agent(model:opus)` совпадает с псевдонимом `opus`, но не с полным ID модели. Запустите с [`--verbose`](/docs/ru/cli-reference), чтобы увидеть точные имена параметров и значения в каждом вызове инструмента

121* Пробелы вокруг двоеточия игнорируются121* Пробелы вокруг двоеточия игнорируются

122 122 

123Поля, которые инструмент уже совпадает со своими собственными правилами канонизации, не совпадают таким образом: `command` для Bash и PowerShell, `file_path` для Read, Edit и Write, `path` для Grep и Glob, `notebook_path` для NotebookEdit и `url` для WebFetch. Правило, такое как `Bash(command:rm *)`, можно было бы обойти составной командой, поэтому Claude Code игнорирует его и выдает предупреждение при запуске. Используйте `Bash(rm *)`, `Read(./path)` или `WebFetch(domain:host)` вместо этого.123Поля, которые инструмент уже совпадает со своими собственными правилами канонизации, не совпадают таким образом: `command` для Bash и PowerShell, `file_path` для Read, Edit и Write, `path` для Grep и Glob, `notebook_path` для NotebookEdit и `url` для WebFetch. Правило, такое как `Bash(command:rm *)`, можно было бы обойти составной командой, поэтому Claude Code игнорирует его и выдает предупреждение при запуске. Используйте `Bash(rm *)`, `Read(./path)` или `WebFetch(domain:host)` вместо этого.


169 169 

170Правило отказа или запроса, имя инструмента которого не совпадает ни с одним известным инструментом, выдает предупреждение при запуске, чтобы поймать опечатки. Имена инструментов, содержащие `_` или `*`, освобождаются от проверки.170Правило отказа или запроса, имя инструмента которого не совпадает ни с одним известным инструментом, выдает предупреждение при запуске, чтобы поймать опечатки. Имена инструментов, содержащие `_` или `*`, освобождаются от проверки.

171 171 

172Метка, отображаемая для инструмента в стенограмме и диалоге разрешений, может отличаться от его канонического имени. Например, инструмент с меткой `Stop Task` в стенограмме имеет каноническое имя `TaskStop`. Правила разрешений и [матчеры hook](/ru/hooks) совпадают только с каноническим именем, поэтому правило, написанное как `Stop Task`, не совпадает. Для правил отказа и запроса предупреждение при запуске выше ловит несоответствие. Используйте канонические имена, указанные в [справочнике инструментов](/ru/tools-reference).172Метка, отображаемая для инструмента в стенограмме и диалоге разрешений, может отличаться от его канонического имени. Например, инструмент с меткой `Stop Task` в стенограмме имеет каноническое имя `TaskStop`. Правила разрешений и [матчеры hook](/docs/ru/hooks) совпадают только с каноническим именем, поэтому правило, написанное как `Stop Task`, не совпадает. Для правил отказа и запроса предупреждение при запуске выше ловит несоответствие. Используйте канонические имена, указанные в [справочнике инструментов](/docs/ru/tools-reference).

173 173 

174<h2 id="tool-specific-permission-rules">174<h2 id="tool-specific-permission-rules">

175 Правила разрешений для конкретных инструментов175 Правила разрешений для конкретных инструментов


223 223 

224`cd` в путь внутри вашего рабочего каталога или [дополнительного каталога](#working-directories) также только для чтения. Составная команда, такая как `cd packages/api && ls`, запускается без запроса, когда каждая часть квалифицируется самостоятельно. Объединение `cd` с `git` в одну составную команду запрашивает, когда `cd` переходит в другой каталог, так как запуск `git` в новом каталоге может выполнить hooks этого каталога. `cd`, целевой путь которого разрешается в текущий рабочий каталог, является no-op и не вызывает этот запрос.224`cd` в путь внутри вашего рабочего каталога или [дополнительного каталога](#working-directories) также только для чтения. Составная команда, такая как `cd packages/api && ls`, запускается без запроса, когда каждая часть квалифицируется самостоятельно. Объединение `cd` с `git` в одну составную команду запрашивает, когда `cd` переходит в другой каталог, так как запуск `git` в новом каталоге может выполнить hooks этого каталога. `cd`, целевой путь которого разрешается в текущий рабочий каталог, является no-op и не вызывает этот запрос.

225 225 

226Объединение `cd` с перенаправлением вывода в одну составную команду также запрашивает, когда Claude Code не может определить, в какой каталог разрешается целевой путь перенаправления после выполнения `cd`. Команда, единственной целью перенаправления которой является `/dev/null`, такая как `cd app; grep -r pattern . 2>/dev/null`, не вызывает этот запрос, потому что `/dev/null` не зависит от рабочего каталога. {/* min-version: 2.1.207 */}До версии 2.1.207 составная команда, содержащая `cd`, запрашивала для любого перенаправления вывода, включая то, единственной целью которого был `/dev/null`.226Объединение `cd` с перенаправлением вывода в одну составную команду также запрашивает, когда Claude Code не может определить, в какой каталог разрешается целевой путь перенаправления после выполнения `cd`. Команда, единственной целью перенаправления которой является `/dev/null`, такая как `cd app; grep -r pattern . 2>/dev/null`, не вызывает этот запрос, потому что `/dev/null` не зависит от рабочего каталога. До версии 2.1.207 составная команда, содержащая `cd`, запрашивала для любого перенаправления вывода, включая то, единственной целью которого был `/dev/null`.

227 227 

228<Warning>228<Warning>

229 Шаблоны разрешений Bash, которые пытаются ограничить аргументы команды, хрупкие. Например, `Bash(curl http://github.com/ *)` предназначен для ограничения curl на URL-адреса GitHub, но не будет совпадать с вариациями, такими как:229 Шаблоны разрешений Bash, которые пытаются ограничить аргументы команды, хрупкие. Например, `Bash(curl http://github.com/ *)` предназначен для ограничения curl на URL-адреса GitHub, но не будет совпадать с вариациями, такими как:


271 Read и Edit271 Read и Edit

272</h3>272</h3>

273 273 

274Правила `Edit` применяются ко всем встроенным инструментам, которые редактируют файлы. Claude прилагает наилучшие усилия для применения правил `Read` ко всем встроенным инструментам, которые читают файлы, таким как Grep и Glob, к упоминаниям `@file` в ваших подсказках и к выделению и контексту открытого файла, которые подключенный [IDE](/ru/vs-code#the-built-in-ide-mcp-server) делится с Claude.274Правила `Edit` применяются ко всем встроенным инструментам, которые редактируют файлы. Claude прилагает наилучшие усилия для применения правил `Read` ко всем встроенным инструментам, которые читают файлы, таким как Grep и Glob, к упоминаниям `@file` в ваших подсказках и к выделению и контексту открытого файла, которые подключенный [IDE](/docs/ru/vs-code#the-built-in-ide-mcp-server) делится с Claude.

275 275 

276{/* min-version: 2.1.208 */}Правило `Read` deny также блокирует [инструмент Edit](/ru/errors#file-is-covered-by-a-read-deny-rule) на том же пути, включая создание нового файла там. Write и NotebookEdit не охватываются, поэтому добавьте правило `Edit` deny для путей, которые ни один инструмент не может изменять. Требуется Claude Code версии 2.1.208 или позже.276Правило `Read` deny также блокирует [инструмент Edit](/docs/ru/errors#file-is-covered-by-a-read-deny-rule) на том же пути, включая создание нового файла там. Write и NotebookEdit не охватываются, поэтому добавьте правило `Edit` deny для путей, которые ни один инструмент не может изменять. Требуется Claude Code версии 2.1.208 или позже.

277 277 

278<Warning>278<Warning>

279 Правила Read и Edit deny применяются к встроенным инструментам файлов Claude и к командам файлов, которые Claude Code распознает в Bash, таким как `cat`, `head`, `tail` и `sed`. Они не применяются к произвольным подпроцессам, которые косвенно читают или записывают файлы, таким как скрипт Python или Node, который открывает файлы самостоятельно. Для принудительного применения на уровне ОС, которое блокирует все процессы от доступа к пути, [включите sandbox](/ru/sandboxing).279 Правила Read и Edit deny применяются к встроенным инструментам файлов Claude и к командам файлов, которые Claude Code распознает в Bash, таким как `cat`, `head`, `tail` и `sed`. Они не применяются к произвольным подпроцессам, которые косвенно читают или записывают файлы, таким как скрипт Python или Node, который открывает файлы самостоятельно. Для принудительного применения на уровне ОС, которое блокирует все процессы от доступа к пути, [включите sandbox](/docs/ru/sandboxing).

280</Warning>280</Warning>

281 281 

282Правила Read и Edit следуют спецификации [gitignore](https://git-scm.com/docs/gitignore) с четырьмя различными типами шаблонов:282Правила Read и Edit следуют спецификации [gitignore](https://git-scm.com/docs/gitignore) с четырьмя различными типами шаблонов:


323 В шаблонах gitignore `*` совпадает в одном сегменте пути и может появляться в любой позиции в шаблоне, в то время как `**` совпадает по каталогам. Чтобы разрешить весь доступ к файлам, используйте только имя инструмента без скобок: `Read`, `Edit` или `Write`.323 В шаблонах gitignore `*` совпадает в одном сегменте пути и может появляться в любой позиции в шаблоне, в то время как `**` совпадает по каталогам. Чтобы разрешить весь доступ к файлам, используйте только имя инструмента без скобок: `Read`, `Edit` или `Write`.

324</Note>324</Note>

325 325 

326{/* min-version: 2.1.202 */}Когда вы одобряете путь к файлу с "Да, не спрашивать снова", Claude Code экранирует символы шаблона gitignore в этом пути, такие как `[`, `]` и `*`, поэтому сгенерированное правило совпадает только с буквальным путем, который вы одобрили. Правила, которые вы пишете сами, не экранируются. До версии 2.1.202 Claude Code сохранял путь без экранирования, поэтому сгенерированное правило для каталога с именем `[2024-06] Reports` могло не совпадать с его собственным путем или совпадать с непредусмотренными соседними каталогами.326Когда вы одобряете путь к файлу с "Да, не спрашивать снова", Claude Code экранирует символы шаблона gitignore в этом пути, такие как `[`, `]` и `*`, поэтому сгенерированное правило совпадает только с буквальным путем, который вы одобрили. Правила, которые вы пишете сами, не экранируются. До версии 2.1.202 Claude Code сохранял путь без экранирования, поэтому сгенерированное правило для каталога с именем `[2024-06] Reports` могло не совпадать с его собственным путем или совпадать с непредусмотренными соседними каталогами.

327 327 

328Когда Claude получает доступ к символической ссылке, правила разрешений проверяют два пути: саму символическую ссылку и файл, на который она указывает. Правила allow и deny обрабатывают эту пару по-разному: правила allow возвращаются к запросу вас, в то время как правила deny блокируют полностью.328Когда Claude получает доступ к символической ссылке, правила разрешений проверяют два пути: саму символическую ссылку и файл, на который она указывает. Правила allow и deny обрабатывают эту пару по-разному: правила allow возвращаются к запросу вас, в то время как правила deny блокируют полностью.

329 329 


354* `mcp__puppeteer__*` использует синтаксис подстановочных символов и также совпадает со всеми инструментами с сервера `puppeteer`354* `mcp__puppeteer__*` использует синтаксис подстановочных символов и также совпадает со всеми инструментами с сервера `puppeteer`

355* `mcp__puppeteer__puppeteer_navigate` совпадает с инструментом `puppeteer_navigate`, предоставленным сервером `puppeteer`355* `mcp__puppeteer__puppeteer_navigate` совпадает с инструментом `puppeteer_navigate`, предоставленным сервером `puppeteer`

356 356 

357Если ваша организация установила [инструмент соединителя claude.ai](/ru/mcp#organization-controls-on-connector-tools) на `ask`, правила allow для этого инструмента не вступают в силу: Claude Code запрашивает при каждом вызове, даже в режимах `auto` и `bypassPermissions`. В режиме `dontAsk`, который никогда не запрашивает, Claude Code отказывает в вызове вместо этого. Инструменты соединителя отображаются как `mcp__claude_ai_<server>__<tool>`.357Если ваша организация установила [инструмент соединителя claude.ai](/docs/ru/mcp#organization-controls-on-connector-tools) на `ask`, правила allow для этого инструмента не вступают в силу: Claude Code запрашивает при каждом вызове, даже в режимах `auto` и `bypassPermissions`. В режиме `dontAsk`, который никогда не запрашивает, Claude Code отказывает в вызове вместо этого. Инструменты соединителя отображаются как `mcp__claude_ai_<server>__<tool>`.

358 358 

359<h3 id="agent-subagents">359<h3 id="agent-subagents">

360 Agent (subagents)360 Agent (subagents)

361</h3>361</h3>

362 362 

363Используйте правила `Agent(AgentName)` для контроля, какие [subagents](/ru/sub-agents) может использовать Claude:363Используйте правила `Agent(AgentName)` для контроля, какие [subagents](/docs/ru/sub-agents) может использовать Claude:

364 364 

365* `Agent(Explore)` совпадает с subagent Explore365* `Agent(Explore)` совпадает с subagent Explore

366* `Agent(Plan)` совпадает с subagent Plan366* `Agent(Plan)` совпадает с subagent Plan


380 Cd380 Cd

381</h3>381</h3>

382 382 

383Правила `Cd` контролируют, в какие каталоги команда [`/cd`](/ru/commands) может переместить сеанс. `Cd` не является инструментом, вызываемым моделью: Claude не может его вызвать, и правила применяются только когда вы сами запускаете `/cd`.383Правила `Cd` контролируют, в какие каталоги команда [`/cd`](/docs/ru/commands) может переместить сеанс. `Cd` не является инструментом, вызываемым моделью: Claude не может его вызвать, и правила применяются только когда вы сами запускаете `/cd`.

384 384 

385Голое правило `Cd` deny отключает `/cd` полностью. Правило `Cd(<path-pattern>)` deny блокирует совпадающие цели. Правила deny проверяют каждое написание цели, включая каждый переход символической ссылки, через который она разрешается, поэтому правило, написанное для одного пути, также блокирует цели, которые разрешаются в него.385Голое правило `Cd` deny отключает `/cd` полностью. Правило `Cd(<path-pattern>)` deny блокирует совпадающие цели. Правила deny проверяют каждое написание цели, включая каждый переход символической ссылки, через который она разрешается, поэтому правило, написанное для одного пути, также блокирует цели, которые разрешаются в него.

386 386 


398 Расширение разрешений с помощью hooks398 Расширение разрешений с помощью hooks

399</h2>399</h2>

400 400 

401[Claude Code hooks](/ru/hooks-guide) предоставляют способ регистрации пользовательских команд оболочки для выполнения оценки разрешений во время выполнения. Когда Claude Code выполняет вызов инструмента, PreToolUse hooks запускаются перед запросом разрешения. Выход hook может отклонить вызов инструмента, принудить запрос или пропустить запрос, чтобы позволить вызову продолжиться.401[Claude Code hooks](/docs/ru/hooks-guide) предоставляют способ регистрации пользовательских команд оболочки для выполнения оценки разрешений во время выполнения. Когда Claude Code выполняет вызов инструмента, PreToolUse hooks запускаются перед запросом разрешения. Выход hook может отклонить вызов инструмента, принудить запрос или пропустить запрос, чтобы позволить вызову продолжиться.

402 402 

403Решения hook не обходят правила разрешений. Claude Code оценивает правила deny и ask независимо от того, что возвращает PreToolUse hook: совпадающее правило deny блокирует вызов, и совпадающее правило ask по-прежнему запрашивает даже когда hook вернул `"allow"` или `"ask"`. Это сохраняет приоритет deny-first, описанный в [Управление разрешениями](#manage-permissions), включая правила deny, установленные в управляемых параметрах.403Решения hook не обходят правила разрешений. Claude Code оценивает правила deny и ask независимо от того, что возвращает PreToolUse hook: совпадающее правило deny блокирует вызов, и совпадающее правило ask по-прежнему запрашивает даже когда hook вернул `"allow"` или `"ask"`. Это сохраняет приоритет deny-first, описанный в [Управление разрешениями](#manage-permissions), включая правила deny, установленные в управляемых параметрах.

404 404 

405Инструменты Connector, [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools), и инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), также по-прежнему запрашивают, когда hook возвращает `"allow"`.405Инструменты Connector, [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools), и инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), также по-прежнему запрашивают, когда hook возвращает `"allow"`.

406 406 

407Блокирующий hook также имеет приоритет над правилами allow. Hook, который выходит с кодом 2, останавливает вызов инструмента перед оценкой правил разрешений, поэтому блокировка применяется даже когда правило allow иначе позволило бы вызову продолжиться. Чтобы запустить все Bash команды без запросов, кроме нескольких, которые вы хотите заблокировать, добавьте `"Bash"` в список allow и зарегистрируйте PreToolUse hook, который отклоняет эти конкретные команды. См. [Блокировка редактирования защищённых файлов](/ru/hooks-guide#block-edits-to-protected-files) для скрипта hook, который вы можете адаптировать.407Блокирующий hook также имеет приоритет над правилами allow. Hook, который выходит с кодом 2, останавливает вызов инструмента перед оценкой правил разрешений, поэтому блокировка применяется даже когда правило allow иначе позволило бы вызову продолжиться. Чтобы запустить все Bash команды без запросов, кроме нескольких, которые вы хотите заблокировать, добавьте `"Bash"` в список allow и зарегистрируйте PreToolUse hook, который отклоняет эти конкретные команды. См. [Блокировка редактирования защищённых файлов](/docs/ru/hooks-guide#block-edits-to-protected-files) для скрипта hook, который вы можете адаптировать.

408 408 

409<h2 id="working-directories">409<h2 id="working-directories">

410 Рабочие каталоги410 Рабочие каталоги


414 414 

415* **При запуске**: используйте аргумент CLI `--add-dir <path>`415* **При запуске**: используйте аргумент CLI `--add-dir <path>`

416* **Во время сеанса**: используйте команду `/add-dir`416* **Во время сеанса**: используйте команду `/add-dir`

417* **Постоянная конфигурация**: добавьте в `additionalDirectories` в [файлы параметров](/ru/settings#settings-files)417* **Постоянная конфигурация**: добавьте в `additionalDirectories` в [файлы параметров](/docs/ru/settings#settings-files)

418 418 

419Файлы в дополнительных каталогах следуют тем же правилам разрешений, что и исходный рабочий каталог: они становятся читаемыми без запросов, и разрешения на редактирование файлов следуют текущему режиму разрешений.419Файлы в дополнительных каталогах следуют тем же правилам разрешений, что и исходный рабочий каталог: они становятся читаемыми без запросов, и разрешения на редактирование файлов следуют текущему режиму разрешений.

420 420 

421В фоновых сеансах на macOS хост сеанса запрашивает доступ к защищённым папкам, таким как `~/Desktop`, `~/Documents` и `~/Downloads`, отдельно от вашего терминала, когда Claude нужно читать или писать файлы там; если чтение там завершается с ошибкой `Operation not permitted`, см. [как предоставить доступ к папкам для фоновых сеансов](/ru/agent-view#background-sessions-can't-read-desktop-documents-or-downloads-on-macos).421В фоновых сеансах на macOS хост сеанса запрашивает доступ к защищённым папкам, таким как `~/Desktop`, `~/Documents` и `~/Downloads`, отдельно от вашего терминала, когда Claude нужно читать или писать файлы там; если чтение там завершается с ошибкой `Operation not permitted`, см. [как предоставить доступ к папкам для фоновых сеансов](/docs/ru/agent-view#background-sessions-can't-read-desktop-documents-or-downloads-on-macos).

422 422 

423Чтобы изменить основной рабочий каталог сеанса вместо добавления другого, используйте [`/cd`](/ru/commands). Команда `/cd` требует Claude Code версии 2.1.169 или позже. В отличие от `/add-dir`, она перемещает сеанс: загружается `CLAUDE.md` нового каталога и `--resume` находит сеанс оттуда.423Чтобы изменить основной рабочий каталог сеанса вместо добавления другого, используйте [`/cd`](/docs/ru/commands). Команда `/cd` требует Claude Code версии 2.1.169 или позже. В отличие от `/add-dir`, она перемещает сеанс: загружается `CLAUDE.md` нового каталога и `--resume` находит сеанс оттуда.

424 424 

425<h3 id="additional-directories-grant-file-access-not-configuration">425<h3 id="additional-directories-grant-file-access-not-configuration">

426 Дополнительные каталоги предоставляют доступ к файлам, а не конфигурацию426 Дополнительные каталоги предоставляют доступ к файлам, а не конфигурацию


434 434 

435| Конфигурация | Загружается из `--add-dir` |435| Конфигурация | Загружается из `--add-dir` |

436| :--------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |436| :--------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

437| [Skills](/ru/skills) в `.claude/skills/` | Да, с live reload |437| [Skills](/docs/ru/skills) в `.claude/skills/` | Да, с live reload |

438| [Subagents](/ru/sub-agents) в `.claude/agents/` | Да |438| [Subagents](/docs/ru/sub-agents) в `.claude/agents/` | Да |

439| [Settings](/ru/settings) в `.claude/settings.json` и `.claude/settings.local.json` | Только ключи `enabledPlugins` и `extraKnownMarketplaces` |439| [Settings](/docs/ru/settings) в `.claude/settings.json` и `.claude/settings.local.json` | Только ключи `enabledPlugins` и `extraKnownMarketplaces` |

440| [CLAUDE.md](/ru/memory) файлы, `.claude/rules/` и `CLAUDE.local.md` | Только когда установлено `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. `CLAUDE.local.md` дополнительно требует источник параметра `local`, который включен по умолчанию |440| [CLAUDE.md](/docs/ru/memory) файлы, `.claude/rules/` и `CLAUDE.local.md` | Только когда установлено `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. `CLAUDE.local.md` дополнительно требует источник параметра `local`, который включен по умолчанию |

441 441 

442Команды и стили вывода обнаруживаются из текущего рабочего каталога и его родителей, вашего пользовательского каталога в `~/.claude/` и управляемых параметров. Hooks и другие ключи `settings.json` загружаются из папки `.claude/` текущего рабочего каталога без резервного варианта для родительского каталога, наряду с вашим пользовательским файлом `~/.claude/settings.json` и управляемыми параметрами. Чтобы поделиться этой конфигурацией между проектами, используйте один из этих подходов:442Команды и стили вывода обнаруживаются из текущего рабочего каталога и его родителей, вашего пользовательского каталога в `~/.claude/` и управляемых параметров. Hooks и другие ключи `settings.json` загружаются из папки `.claude/` текущего рабочего каталога без резервного варианта для родительского каталога, наряду с вашим пользовательским файлом `~/.claude/settings.json` и управляемыми параметрами. Чтобы поделиться этой конфигурацией между проектами, используйте один из этих подходов:

443 443 

444* **Конфигурация на уровне пользователя**: поместите файлы в `~/.claude/agents/`, `~/.claude/output-styles/` или `~/.claude/settings.json`, чтобы сделать их доступными в каждом проекте444* **Конфигурация на уровне пользователя**: поместите файлы в `~/.claude/agents/`, `~/.claude/output-styles/` или `~/.claude/settings.json`, чтобы сделать их доступными в каждом проекте

445* **Плагины**: упакуйте и распространяйте конфигурацию как [плагин](/ru/plugins), который команды могут установить445* **Плагины**: упакуйте и распространяйте конфигурацию как [плагин](/docs/ru/plugins), который команды могут установить

446* **Запуск из каталога конфигурации**: запустите Claude Code из каталога, содержащего конфигурацию `.claude/`, которую вы хотите использовать446* **Запуск из каталога конфигурации**: запустите Claude Code из каталога, содержащего конфигурацию `.claude/`, которую вы хотите использовать

447 447 

448<h2 id="how-permissions-interact-with-sandboxing">448<h2 id="how-permissions-interact-with-sandboxing">

449 Как разрешения взаимодействуют с sandboxing449 Как разрешения взаимодействуют с sandboxing

450</h2>450</h2>

451 451 

452Разрешения и [sandboxing](/ru/sandboxing) являются дополняющими уровнями безопасности:452Разрешения и [sandboxing](/docs/ru/sandboxing) являются дополняющими уровнями безопасности:

453 453 

454* **Разрешения** контролируют, какие инструменты может использовать Claude Code и какие файлы или домены он может использовать. Они применяются ко всем инструментам, включая Bash, Read, Edit, WebFetch и MCP.454* **Разрешения** контролируют, какие инструменты может использовать Claude Code и какие файлы или домены он может использовать. Они применяются ко всем инструментам, включая Bash, Read, Edit, WebFetch и MCP.

455* **Sandboxing** обеспечивает принудительное применение на уровне ОС, которое ограничивает доступ инструмента Bash к файловой системе и сети. Это применяется только к Bash командам и их дочерним процессам.455* **Sandboxing** обеспечивает принудительное применение на уровне ОС, которое ограничивает доступ инструмента Bash к файловой системе и сети. Это применяется только к Bash командам и их дочерним процессам.


458 458 

459* Правила deny разрешений блокируют Claude от попытки доступа к ограниченным ресурсам459* Правила deny разрешений блокируют Claude от попытки доступа к ограниченным ресурсам

460* Ограничения sandbox предотвращают Bash команды от доступа к ресурсам вне определенных границ, даже если инъекция подсказки обходит принятие решений Claude460* Ограничения sandbox предотвращают Bash команды от доступа к ресурсам вне определенных границ, даже если инъекция подсказки обходит принятие решений Claude

461* Ограничения файловой системы в sandbox объединяют параметры [`sandbox.filesystem`](/ru/sandboxing) с правилами deny для Read и Edit; оба объединяются в финальную границу sandbox461* Ограничения файловой системы в sandbox объединяют параметры [`sandbox.filesystem`](/docs/ru/sandboxing) с правилами deny для Read и Edit; оба объединяются в финальную границу sandbox

462* Ограничения сети объединяют правила разрешений WebFetch со списками `allowedDomains` и `deniedDomains` sandbox462* Ограничения сети объединяют правила разрешений WebFetch со списками `allowedDomains` и `deniedDomains` sandbox

463 463 

464Когда sandboxing включен с `autoAllowBashIfSandboxed: true`, что является значением по умолчанию, sandboxed Bash команды запускаются без запроса даже если ваши разрешения включают простое правило ask `Bash`, или эквивалентную форму `Bash(*)` (#match-all-uses-of-a-tool): граница sandbox заменяет этот запрос для всего инструмента. Эти проверки по-прежнему применяются:464Когда sandboxing включен с `autoAllowBashIfSandboxed: true`, что является значением по умолчанию, sandboxed Bash команды запускаются без запроса даже если ваши разрешения включают простое правило ask `Bash`, или эквивалентную форму `Bash(*)` (#match-all-uses-of-a-tool): граница sandbox заменяет этот запрос для всего инструмента. Эти проверки по-прежнему применяются:


467* Явные правила deny по-прежнему применяются467* Явные правила deny по-прежнему применяются

468* Команды `rm` или `rmdir`, которые нацелены на `/`, ваш домашний каталог или другие критические пути системы, по-прежнему вызывают запрос468* Команды `rm` или `rmdir`, которые нацелены на `/`, ваш домашний каталог или другие критические пути системы, по-прежнему вызывают запрос

469 469 

470Команды, которые не будут запущены в sandboxed режиме, такие как исключенные команды, соблюдают простое правило ask `Bash` как обычно. См. [sandbox modes](/ru/sandboxing#sandbox-modes) для изменения этого поведения.470Команды, которые не будут запущены в sandboxed режиме, такие как исключенные команды, соблюдают простое правило ask `Bash` как обычно. См. [sandbox modes](/docs/ru/sandboxing#sandbox-modes) для изменения этого поведения.

471 471 

472<h2 id="managed-settings">472<h2 id="managed-settings">

473 Управляемые параметры473 Управляемые параметры

474</h2>474</h2>

475 475 

476Для организаций, которым требуется централизованный контроль над конфигурацией Claude Code, администраторы могут развернуть управляемые параметры, которые не могут быть переопределены параметрами пользователя или проекта. Эти параметры политики следуют тому же формату, что и обычные файлы параметров, и могут быть доставлены через политики MDM/уровня ОС, управляемые файлы параметров, [параметры, управляемые сервером](/ru/server-managed-settings), или самостоятельно размещаемый [Claude apps gateway](/ru/claude-apps-gateway). См. [файлы параметров](/ru/settings#settings-files) для механизмов доставки и расположения файлов.476Для организаций, которым требуется централизованный контроль над конфигурацией Claude Code, администраторы могут развернуть управляемые параметры, которые не могут быть переопределены параметрами пользователя или проекта. Эти параметры политики следуют тому же формату, что и обычные файлы параметров, и могут быть доставлены через политики MDM/уровня ОС, управляемые файлы параметров, [параметры, управляемые сервером](/docs/ru/server-managed-settings), или самостоятельно размещаемый [Claude apps gateway](/docs/ru/claude-apps-gateway). См. [файлы параметров](/docs/ru/settings#settings-files) для механизмов доставки и расположения файлов.

477 477 

478<h3 id="managed-only-settings">478<h3 id="managed-only-settings">

479 Параметры только для управления479 Параметры только для управления


483 483 

484| Параметр | Описание |484| Параметр | Описание |

485| :--------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |485| :--------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

486| `allowAllClaudeAiMcps` | Когда `true`, соединители claude.ai загружаются вместе с развернутым `managed-mcp.json` вместо того, чтобы быть подавленными его исключительным контролем. См. [Управляемая конфигурация MCP](/ru/managed-mcp) |486| `allowAllClaudeAiMcps` | Когда `true`, соединители claude.ai загружаются вместе с развернутым `managed-mcp.json` вместо того, чтобы быть подавленными его исключительным контролем. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) |

487| `allowedChannelPlugins` | Список разрешений плагинов канала, которые могут отправлять сообщения. Заменяет список разрешений Anthropic по умолчанию при установке. Требует `channelsEnabled: true`. См. [Ограничение того, какие плагины канала могут работать](/ru/channels#restrict-which-channel-plugins-can-run) |487| `allowedChannelPlugins` | Список разрешений плагинов канала, которые могут отправлять сообщения. Заменяет список разрешений Anthropic по умолчанию при установке. Требует `channelsEnabled: true`. См. [Ограничение того, какие плагины канала могут работать](/docs/ru/channels#restrict-which-channel-plugins-can-run) |

488| `allowManagedHooksOnly` | Когда `true`, только управляемые hooks, SDK hooks и hooks из плагинов, принудительно включенных в управляемых параметрах `enabledPlugins`, загружаются. Hooks пользователя, проекта и всех остальных плагинов блокируются |488| `allowManagedHooksOnly` | Когда `true`, только управляемые hooks, SDK hooks и hooks из плагинов, принудительно включенных в управляемых параметрах `enabledPlugins`, загружаются. Hooks пользователя, проекта и всех остальных плагинов блокируются |

489| `allowManagedMcpServersOnly` | Когда `true`, только `allowedMcpServers` из управляемых параметров учитываются. `deniedMcpServers` все еще объединяется из всех источников. См. [Управляемая конфигурация MCP](/ru/managed-mcp) |489| `allowManagedMcpServersOnly` | Когда `true`, только `allowedMcpServers` из управляемых параметров учитываются. `deniedMcpServers` все еще объединяется из всех источников. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) |

490| `allowManagedPermissionRulesOnly` | Когда `true`, предотвращает определение правил разрешений `allow`, `ask` или `deny` в параметрах пользователя и проекта. Применяются только правила в управляемых параметрах. Не влияет на список разрешений сервера MCP; для этого установите `allowManagedMcpServersOnly` |490| `allowManagedPermissionRulesOnly` | Когда `true`, предотвращает определение правил разрешений `allow`, `ask` или `deny` в параметрах пользователя и проекта. Применяются только правила в управляемых параметрах. Не влияет на список разрешений сервера MCP; для этого установите `allowManagedMcpServersOnly` |

491| `blockedMarketplaces` | Список блокировки источников marketplace. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) |491| `blockedMarketplaces` | Список блокировки источников marketplace. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) |

492| `channelsEnabled` | Разрешить [channels](/ru/channels) для организации. См. [элементы управления предприятием](/ru/channels#enterprise-controls) для значения по умолчанию на каждом плане |492| `channelsEnabled` | Разрешить [channels](/docs/ru/channels) для организации. См. [элементы управления предприятием](/docs/ru/channels#enterprise-controls) для значения по умолчанию на каждом плане |

493| `disableSideloadFlags` | {/* min-version: 2.1.193 */}Отклонить флаги CLI `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске. Без этого пользователи могут обойти `strictKnownMarketplaces` для одного запуска, передав эти флаги. См. [`disableSideloadFlags`](/ru/settings#available-settings). Требуется Claude Code v2.1.193 или позже |493| `disableSideloadFlags` | Отклонить флаги CLI `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске. Без этого пользователи могут обойти `strictKnownMarketplaces` для одного запуска, передав эти флаги. См. [`disableSideloadFlags`](/docs/ru/settings#available-settings). Требуется Claude Code v2.1.193 или позже |

494| `forceRemoteSettingsRefresh` | Когда `true`, блокирует запуск CLI до тех пор, пока удаленные управляемые параметры не будут свежо получены, и выходит, если получение не удается. См. [принудительное закрытие при запуске](/ru/server-managed-settings#enforce-fail-closed-startup) |494| `forceRemoteSettingsRefresh` | Когда `true`, блокирует запуск CLI до тех пор, пока удаленные управляемые параметры не будут свежо получены, и выходит, если получение не удается. См. [принудительное закрытие при запуске](/docs/ru/server-managed-settings#enforce-fail-closed-startup) |

495| `pluginTrustMessage` | Пользовательское сообщение, добавленное к предупреждению о доверии плагина, показываемому перед установкой |495| `pluginTrustMessage` | Пользовательское сообщение, добавленное к предупреждению о доверии плагина, показываемому перед установкой |

496| `sandbox.filesystem.allowManagedReadPathsOnly` | Когда `true`, только пути `filesystem.allowRead` из управляемых параметров учитываются. `denyRead` все еще объединяется из всех источников |496| `sandbox.filesystem.allowManagedReadPathsOnly` | Когда `true`, только пути `filesystem.allowRead` из управляемых параметров учитываются. `denyRead` все еще объединяется из всех источников |

497| `sandbox.network.allowManagedDomainsOnly` | Когда `true`, только `allowedDomains` и правила `WebFetch(domain:...)` allow из управляемых параметров учитываются. Недопустимые домены блокируются автоматически без запроса пользователю. Запрещенные домены все еще объединяются из всех источников |497| `sandbox.network.allowManagedDomainsOnly` | Когда `true`, только `allowedDomains` и правила `WebFetch(domain:...)` allow из управляемых параметров учитываются. Недопустимые домены блокируются автоматически без запроса пользователю. Запрещенные домены все еще объединяются из всех источников |

498| `strictKnownMarketplaces` | Контролирует, какие источники marketplace плагинов пользователи могут добавлять и устанавливать плагины из. См. [управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) |498| `strictKnownMarketplaces` | Контролирует, какие источники marketplace плагинов пользователи могут добавлять и устанавливать плагины из. См. [управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) |

499| `strictPluginOnlyCustomization` | Блокирует skills, agents, hooks и MCP servers из источников пользователя и проекта, поэтому они могут поступать только из плагинов или управляемых параметров. `true` блокирует все четыре поверхности; массив, такой как `["skills", "hooks"]`, блокирует только названные. См. [`strictPluginOnlyCustomization`](/ru/settings#strictpluginonlycustomization) |499| `strictPluginOnlyCustomization` | Блокирует skills, agents, hooks и MCP servers из источников пользователя и проекта, поэтому они могут поступать только из плагинов или управляемых параметров. `true` блокирует все четыре поверхности; массив, такой как `["skills", "hooks"]`, блокирует только названные. См. [`strictPluginOnlyCustomization`](/docs/ru/settings#strictpluginonlycustomization) |

500| `wslInheritsWindowsSettings` | Когда `true` в ключе реестра Windows HKLM или `C:\Program Files\ClaudeCode\managed-settings.json`, WSL читает управляемые параметры из цепочки политики Windows в дополнение к `/etc/claude-code`. См. [Файлы параметров](/ru/settings#settings-files) |500| `wslInheritsWindowsSettings` | Когда `true` в ключе реестра Windows HKLM или `C:\Program Files\ClaudeCode\managed-settings.json`, WSL читает управляемые параметры из цепочки политики Windows в дополнение к `/etc/claude-code`. См. [Файлы параметров](/docs/ru/settings#settings-files) |

501 501 

502`disableBypassPermissionsMode` обычно размещается в управляемых параметрах для обеспечения организационной политики, но работает из любой области. Пользователь может установить его в своих собственных параметрах, чтобы заблокировать себя из режима bypass.502`disableBypassPermissionsMode` обычно размещается в управляемых параметрах для обеспечения организационной политики, но работает из любой области. Пользователь может установить его в своих собственных параметрах, чтобы заблокировать себя из режима bypass.

503 503 

504<Note>504<Note>

505 На планах Team и Enterprise владелец включает или отключает [Remote Control](/ru/remote-control) и [веб-сеансы](/ru/claude-code-on-the-web) организации в целом в [Claude Code admin settings](https://claude.ai/admin-settings/claude-code). Remote Control может дополнительно быть отключен для каждого устройства с помощью параметра [`disableRemoteControl`](/ru/settings#available-settings). Веб-сеансы не имеют ключа управляемых параметров для каждого устройства.505 На планах Team и Enterprise владелец включает или отключает [Remote Control](/docs/ru/remote-control) и [веб-сеансы](/docs/ru/claude-code-on-the-web) организации в целом в [Claude Code admin settings](https://claude.ai/admin-settings/claude-code). Remote Control может дополнительно быть отключен для каждого устройства с помощью параметра [`disableRemoteControl`](/docs/ru/settings#available-settings). Веб-сеансы не имеют ключа управляемых параметров для каждого устройства.

506</Note>506</Note>

507 507 

508<h2 id="settings-precedence">508<h2 id="settings-precedence">

509 Приоритет параметров509 Приоритет параметров

510</h2>510</h2>

511 511 

512Правила разрешений следуют тому же [приоритету параметров](/ru/settings#settings-precedence), что и все остальные параметры Claude Code:512Правила разрешений следуют тому же [приоритету параметров](/docs/ru/settings#settings-precedence), что и все остальные параметры Claude Code:

513 513 

5141. **Управляемые параметры**: не могут быть переопределены никаким другим уровнем, включая аргументы командной строки5141. **Управляемые параметры**: не могут быть переопределены никаким другим уровнем, включая аргументы командной строки

5152. **Аргументы командной строки**: временные переопределения сеанса5152. **Аргументы командной строки**: временные переопределения сеанса


521 521 

522То же самое применяется и к областям параметров: если параметры пользователя разрешают разрешение, а параметры проекта его запрещают, правило запрета блокирует его. Обратное также верно: запрет на уровне пользователя блокирует разрешение на уровне проекта, потому что правила запрета из любой области оцениваются перед правилами разрешения.522То же самое применяется и к областям параметров: если параметры пользователя разрешают разрешение, а параметры проекта его запрещают, правило запрета блокирует его. Обратное также верно: запрет на уровне пользователя блокирует разрешение на уровне проекта, потому что правила запрета из любой области оцениваются перед правилами разрешения.

523 523 

524Хосты встраивания могут предоставлять дополнительную управляемую политику через опцию SDK `managedSettings` когда [`parentSettingsBehavior`](/ru/settings#settings-precedence) установлен на `"merge"`; значения встраивающей стороны могут ужесточить политику, но не ослабить её.524Хосты встраивания могут предоставлять дополнительную управляемую политику через опцию SDK `managedSettings` когда [`parentSettingsBehavior`](/docs/ru/settings#settings-precedence) установлен на `"merge"`; значения встраивающей стороны могут ужесточить политику, но не ослабить её.

525 525 

526<h2 id="project-allow-rules-and-workspace-trust">526<h2 id="project-allow-rules-and-workspace-trust">

527 Правила разрешений проекта и доверие рабочей области527 Правила разрешений проекта и доверие рабочей области

528</h2>528</h2>

529 529 

530Правила `permissions.allow` и записи `permissions.additionalDirectories` в файле `.claude/settings.json` проекта предоставляют возможности, поэтому Claude Code применяет их только после того, как вы примете [диалог доверия рабочей области](/ru/security#additional-safeguards) для этой рабочей области. До этого Claude Code читает правила, но не применяет их. Диалог доверия перечисляет правила разрешений и дополнительные каталоги, которые папка предоставит, чтобы вы могли их проверить перед принятием. Правила `deny` и `ask` не затрагиваются, так как они только ограничивают.530Правила `permissions.allow` и записи `permissions.additionalDirectories` в файле `.claude/settings.json` проекта предоставляют возможности, поэтому Claude Code применяет их только после того, как вы примете [диалог доверия рабочей области](/docs/ru/security#additional-safeguards) для этой рабочей области. До этого Claude Code читает правила, но не применяет их. Диалог доверия перечисляет правила разрешений и дополнительные каталоги, которые папка предоставит, чтобы вы могли их проверить перед принятием. Правила `deny` и `ask` не затрагиваются, так как они только ограничивают.

531 531 

532Claude Code сохраняет доверие для каждой рабочей области, используя в качестве ключа корень репозитория git или, вне репозитория, каталог, из которого вы запустили Claude Code. Когда вы начинаете работу в домашнем каталоге, доверие сохраняется только для текущего сеанса и не записывается на диск; см. примечание [дополнительные меры безопасности](/ru/security#additional-safeguards). Доверие к родительскому каталогу не применяет правила разрешений вложенного проекта.532Claude Code сохраняет доверие для каждой рабочей области, используя в качестве ключа корень репозитория git или, вне репозитория, каталог, из которого вы запустили Claude Code. Когда вы начинаете работу в домашнем каталоге, доверие сохраняется только для текущего сеанса и не записывается на диск; см. примечание [дополнительные меры безопасности](/docs/ru/security#additional-safeguards). Доверие к родительскому каталогу не применяет правила разрешений вложенного проекта.

533 533 

534`.claude/settings.local.json` — это ваш собственный файл, поэтому проверка доверия рабочей области обычно к нему не применяется. Когда репозиторий мог предоставить файл, например когда он зафиксирован в git или `.claude` является символической ссылкой, его правила разрешений и дополнительные каталоги проходят проверку доверия как параметры проекта.534`.claude/settings.local.json` — это ваш собственный файл, поэтому проверка доверия рабочей области обычно к нему не применяется. Когда репозиторий мог предоставить файл, например когда он зафиксирован в git или `.claude` является символической ссылкой, его правила разрешений и дополнительные каталоги проходят проверку доверия как параметры проекта.

535 535 


538Правила разрешений и дополнительные каталоги в `.claude/settings.local.json` также применяются без доверия рабочей области в двух случаях:538Правила разрешений и дополнительные каталоги в `.claude/settings.local.json` также применяются без доверия рабочей области в двух случаях:

539 539 

540* Каталог, из которого вы запустили Claude Code, находится вне репозитория git.540* Каталог, из которого вы запустили Claude Code, находится вне репозитория git.

541* Сеанс выполняется в вашем собственном конфигурационном домашнем каталоге: в вашем домашнем каталоге или в любом каталоге, чей подкаталог `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/ru/env-vars).541* Сеанс выполняется в вашем собственном конфигурационном домашнем каталоге: в вашем домашнем каталоге или в любом каталоге, чей подкаталог `.claude` вы установили как [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars).

542 542 

543В обоих случаях файл создан вами, а не репозиторием, и зафиксированный в репозитории `.claude/settings.local.json` по-прежнему требует доверия рабочей области. Версии 2.1.196–2.1.199 рассматривали файл как предоставленный репозиторием в этих рабочих областях, игнорировали его правила разрешений и выводили предупреждение [`this workspace has not been trusted`](/ru/errors#workspace-has-not-been-trusted) в stderr. Два исключения выше соответствуют v2.1.195 и более ранним версиям и были восстановлены в v2.1.200.543В обоих случаях файл создан вами, а не репозиторием, и зафиксированный в репозитории `.claude/settings.local.json` по-прежнему требует доверия рабочей области. Версии 2.1.196–2.1.199 рассматривали файл как предоставленный репозиторием в этих рабочих областях, игнорировали его правила разрешений и выводили предупреждение [`this workspace has not been trusted`](/docs/ru/errors#workspace-has-not-been-trusted) в stderr. Два исключения выше соответствуют v2.1.195 и более ранним версиям и были восстановлены в v2.1.200.

544 544 

545Также начиная с v2.1.200, рабочая область, правила разрешений или дополнительные каталоги которой по-прежнему не применяются, но которая никогда не показывала диалог доверия, потому что родительский каталог уже был доверен, показывает диалог при следующем интерактивном запуске Claude Code там. Диалог предлагает два варианта:545Также начиная с v2.1.200, рабочая область, правила разрешений или дополнительные каталоги которой по-прежнему не применяются, но которая никогда не показывала диалог доверия, потому что родительский каталог уже был доверен, показывает диалог при следующем интерактивном запуске Claude Code там. Диалог предлагает два варианта:

546 546 

547* **Yes, I trust this folder**: сохраняет доверие для этой рабочей области и применяет правила в том же сеансе.547* **Yes, I trust this folder**: сохраняет доверие для этой рабочей области и применяет правила в том же сеансе.

548* **No, continue without these permissions**: продолжает работу с игнорированием этих правил. Диалог появляется снова в следующем сеансе.548* **No, continue without these permissions**: продолжает работу с игнорированием этих правил. Диалог появляется снова в следующем сеансе.

549 549 

550В [неинтерактивном режиме](/ru/headless) с `-p` диалог не появляется и правила остаются игнорируемыми.550В [неинтерактивном режиме](/docs/ru/headless) с `-p` диалог не появляется и правила остаются игнорируемыми.

551 551 

552<h2 id="example-configurations">552<h2 id="example-configurations">

553 Примеры конфигураций553 Примеры конфигураций


559 См. также559 См. также

560</h2>560</h2>

561 561 

562* [Settings](/ru/settings): полный справочник конфигурации, включая таблицу параметров разрешений562* [Settings](/docs/ru/settings): полный справочник конфигурации, включая таблицу параметров разрешений

563* [Configure auto mode](/ru/auto-mode-config): скажите классификатору режима auto, какую инфраструктуру ваша организация доверяет563* [Configure auto mode](/docs/ru/auto-mode-config): скажите классификатору режима auto, какую инфраструктуру ваша организация доверяет

564* [Sandboxing](/ru/sandboxing): изоляция файловой системы и сети на уровне ОС для Bash команд564* [Sandboxing](/docs/ru/sandboxing): изоляция файловой системы и сети на уровне ОС для Bash команд

565* [Authentication](/ru/authentication): настройка доступа пользователей к Claude Code565* [Authentication](/docs/ru/authentication): настройка доступа пользователей к Claude Code

566* [Security](/ru/security): гарантии безопасности и лучшие практики566* [Security](/docs/ru/security): гарантии безопасности и лучшие практики

567* [Hooks](/ru/hooks-guide): автоматизация рабочих процессов и расширение оценки разрешений567* [Hooks](/docs/ru/hooks-guide): автоматизация рабочих процессов и расширение оценки разрешений

plugin-hints.md +7 −7

Details

10 10 

11Claude Code удаляет строку подсказки из вывода команды перед отправкой её модели, поэтому маркер никогда не появляется в разговоре и не учитывается при подсчёте использованных токенов. Протокол не требует дополнительных команд и не изменяет то, что ваш CLI выводит для пользователей вне Claude Code.11Claude Code удаляет строку подсказки из вывода команды перед отправкой её модели, поэтому маркер никогда не появляется в разговоре и не учитывается при подсчёте использованных токенов. Протокол не требует дополнительных команд и не изменяет то, что ваш CLI выводит для пользователей вне Claude Code.

12 12 

13Эта страница предназначена для разработчиков CLI и SDK. Если вы ищете информацию об установке плагинов, см. [Обнаружение и установка плагинов](/ru/discover-plugins).13Эта страница предназначена для разработчиков CLI и SDK. Если вы ищете информацию об установке плагинов, см. [Обнаружение и установка плагинов](/docs/ru/discover-plugins).

14 14 

15<h2 id="how-it-works">15<h2 id="how-it-works">

16 Как это работает16 Как это работает

17</h2>17</h2>

18 18 

19Claude Code устанавливает переменную окружения [`CLAUDECODE`](/ru/env-vars) в значение `1` для каждой команды, которую он запускает через инструменты Bash и PowerShell, а также для команд [hook](/ru/hooks). {/* min-version: 2.1.172 */}Начиная с версии 2.1.172, он также устанавливает [`CLAUDE_CODE_CHILD_SESSION`](/ru/env-vars) в значение `1` в этих же подпроцессах. Когда ваш CLI видит одну из этих переменных, он выводит самозакрывающийся тег `<claude-code-hint />` в stderr. В командах hook тег подсказки удаляется и игнорируется. Только вывод инструментов Bash и PowerShell запускает приглашение установки.19Claude Code устанавливает переменную окружения [`CLAUDECODE`](/docs/ru/env-vars) в значение `1` для каждой команды, которую он запускает через инструменты Bash и PowerShell, а также для команд [hook](/docs/ru/hooks). Начиная с версии 2.1.172, он также устанавливает [`CLAUDE_CODE_CHILD_SESSION`](/docs/ru/env-vars) в значение `1` в этих же подпроцессах. Когда ваш CLI видит одну из этих переменных, он выводит самозакрывающийся тег `<claude-code-hint />` в stderr. В командах hook тег подсказки удаляется и игнорируется. Только вывод инструментов Bash и PowerShell запускает приглашение установки.

20 20 

21Когда Claude Code получает вывод команды, он:21Когда Claude Code получает вывод команды, он:

22 22 


36Обусловьте вывод переменной окружения, чтобы маркер был маловероятен при прямом запуске вашего CLI пользователем, затем выведите тег в stderr на отдельной строке. Выберите, какую переменную проверять:36Обусловьте вывод переменной окружения, чтобы маркер был маловероятен при прямом запуске вашего CLI пользователем, затем выведите тег в stderr на отдельной строке. Выберите, какую переменную проверять:

37 37 

38* `CLAUDECODE`: устанавливается в каждой версии Claude Code, поэтому достигает большинства сеансов. Она также устанавливается в tmux сеансах и подпроцессах stdio MCP сервера, которые запускает Claude Code. Расширения IDE также устанавливают её в своих интегрированных терминалах, где пользователь может запускать ваш CLI напрямую.38* `CLAUDECODE`: устанавливается в каждой версии Claude Code, поэтому достигает большинства сеансов. Она также устанавливается в tmux сеансах и подпроцессах stdio MCP сервера, которые запускает Claude Code. Расширения IDE также устанавливают её в своих интегрированных терминалах, где пользователь может запускать ваш CLI напрямую.

39* {/* min-version: 2.1.172 */}`CLAUDE_CODE_CHILD_SESSION`: устанавливается только в подпроцессах, которые сам Claude Code порождает, таких как вызовы инструментов, команды hook и команды [строки состояния](/ru/statusline), поэтому тег обычно не достигает терминала пользователя. Долгоживущий процесс, запущенный внутри сеанса, такой как tmux сервер, захватывает переменную, поэтому оболочки, позже запущенные из этого процесса, всё ещё показывают необработанный тег. Требует Claude Code v2.1.172 или позже, поэтому сеансы на более старых версиях пропускают подсказку.39* `CLAUDE_CODE_CHILD_SESSION`: устанавливается только в подпроцессах, которые сам Claude Code порождает, таких как вызовы инструментов, команды hook и команды [строки состояния](/docs/ru/statusline), поэтому тег обычно не достигает терминала пользователя. Долгоживущий процесс, запущенный внутри сеанса, такой как tmux сервер, захватывает переменную, поэтому оболочки, позже запущенные из этого процесса, всё ещё показывают необработанный тег. Требует Claude Code v2.1.172 или позже, поэтому сеансы на более старых версиях пропускают подсказку.

40 40 

41Следующие примеры обусловливают `CLAUDECODE` для максимального охвата и выводят подсказку для плагина с именем `example-cli` в официальном маркетплейсе:41Следующие примеры обусловливают `CLAUDECODE` для максимального охвата и выводят подсказку для плагина с именем `example-cli` в официальном маркетплейсе:

42 42 


158 Добавьте ваш плагин в официальный маркетплейс158 Добавьте ваш плагин в официальный маркетплейс

159</h2>159</h2>

160 160 

161Протокол подсказок вступает в силу только для плагинов, которые указаны в официальном маркетплейсе Anthropic, `claude-plugins-official`. Anthropic курирует этот маркетплейс по своему усмотрению, а встроенные формы отправки добавляют плагины в [маркетплейс сообщества](/ru/plugins#submit-your-plugin-to-the-community-marketplace), который протокол подсказок не проверяет. Если вы работаете с контактом партнёра Anthropic, свяжитесь с ним для координации листинга в официальном маркетплейсе.161Протокол подсказок вступает в силу только для плагинов, которые указаны в официальном маркетплейсе Anthropic, `claude-plugins-official`. Anthropic курирует этот маркетплейс по своему усмотрению, а встроенные формы отправки добавляют плагины в [маркетплейс сообщества](/docs/ru/plugins#submit-your-plugin-to-the-community-marketplace), который протокол подсказок не проверяет. Если вы работаете с контактом партнёра Anthropic, свяжитесь с ним для координации листинга в официальном маркетплейсе.

162 162 

163<h2 id="see-also">163<h2 id="see-also">

164 См. также164 См. также

165</h2>165</h2>

166 166 

167* [Создание плагинов](/ru/plugins): создайте плагин, который рекомендует ваш CLI167* [Создание плагинов](/docs/ru/plugins): создайте плагин, который рекомендует ваш CLI

168* [Создание и распространение маркетплейса плагинов](/ru/plugin-marketplaces): размещайте плагины вне официального маркетплейса168* [Создание и распространение маркетплейса плагинов](/docs/ru/plugin-marketplaces): размещайте плагины вне официального маркетплейса

169* [Переменные окружения](/ru/env-vars): полный справочник по `CLAUDECODE` и связанным переменным169* [Переменные окружения](/docs/ru/env-vars): полный справочник по `CLAUDECODE` и связанным переменным

Details

8 8 

9**plugin marketplace** — это каталог, который позволяет вам распространять плагины другим пользователям. Marketplace обеспечивают централизованное обнаружение, отслеживание версий, автоматические обновления и поддержку нескольких типов источников, включая репозитории Git и локальные пути. Это руководство показывает, как создать собственный marketplace для совместного использования плагинов с вашей командой или сообществом.9**plugin marketplace** — это каталог, который позволяет вам распространять плагины другим пользователям. Marketplace обеспечивают централизованное обнаружение, отслеживание версий, автоматические обновления и поддержку нескольких типов источников, включая репозитории Git и локальные пути. Это руководство показывает, как создать собственный marketplace для совместного использования плагинов с вашей командой или сообществом.

10 10 

11Ищете способ установить плагины из существующего marketplace? См. [Обнаружение и установка готовых плагинов](/ru/discover-plugins).11Ищете способ установить плагины из существующего marketplace? См. [Обнаружение и установка готовых плагинов](/docs/ru/discover-plugins).

12 12 

13<h2 id="overview">13<h2 id="overview">

14 Обзор14 Обзор


16 16 

17Создание и распространение marketplace включает:17Создание и распространение marketplace включает:

18 18 

191. **Создание плагинов**: создайте один или несколько плагинов с skills, агентами, hooks, MCP servers или LSP servers. Это руководство предполагает, что у вас уже есть плагины для распространения; см. [Создание плагинов](/ru/plugins) для получения подробной информации о том, как их создавать.191. **Создание плагинов**: создайте один или несколько плагинов с skills, агентами, hooks, MCP servers или LSP servers. Это руководство предполагает, что у вас уже есть плагины для распространения; см. [Создание плагинов](/docs/ru/plugins) для получения подробной информации о том, как их создавать.

202. **Создание файла marketplace**: определите `marketplace.json`, который перечисляет ваши плагины и где их найти. См. [Создание файла marketplace](#create-the-marketplace-file).202. **Создание файла marketplace**: определите `marketplace.json`, который перечисляет ваши плагины и где их найти. См. [Создание файла marketplace](#create-the-marketplace-file).

213. **Размещение marketplace**: отправьте на GitHub, GitLab или другой хост Git. См. [Размещение и распространение marketplace](#host-and-distribute-marketplaces).213. **Размещение marketplace**: отправьте на GitHub, GitLab или другой хост Git. См. [Размещение и распространение marketplace](#host-and-distribute-marketplaces).

224. **Совместное использование с пользователями**: пользователи добавляют ваш marketplace с помощью `/plugin marketplace add` и устанавливают отдельные плагины. См. [Обнаружение и установка плагинов](/ru/discover-plugins).224. **Совместное использование с пользователями**: пользователи добавляют ваш marketplace с помощью `/plugin marketplace add` и устанавливают отдельные плагины. См. [Обнаружение и установка плагинов](/docs/ru/discover-plugins).

23 23 

24После того как ваш marketplace будет запущен, вы можете обновить его, отправив изменения в ваш репозиторий. Пользователи обновляют свою локальную копию с помощью `/plugin marketplace update`.24После того как ваш marketplace будет запущен, вы можете обновить его, отправив изменения в ваш репозиторий. Пользователи обновляют свою локальную копию с помощью `/plugin marketplace update`.

25 25 


110 </Step>110 </Step>

111</Steps>111</Steps>

112 112 

113Чтобы узнать больше о том, что могут делать плагины, включая hooks, агентов, MCP servers и LSP servers, см. [Плагины](/ru/plugins).113Чтобы узнать больше о том, что могут делать плагины, включая hooks, агентов, MCP servers и LSP servers, см. [Плагины](/docs/ru/plugins).

114 114 

115<Note>115<Note>

116 **Как устанавливаются плагины**: Когда пользователи устанавливают плагин, Claude Code копирует каталог плагина в место кэша. Это означает, что плагины не могут ссылаться на файлы вне их каталога, используя пути вроде `../shared-utils`, потому что эти файлы не будут скопированы.116 **Как устанавливаются плагины**: Когда пользователи устанавливают плагин, Claude Code копирует каталог плагина в место кэша. Это означает, что плагины не могут ссылаться на файлы вне их каталога, используя пути вроде `../shared-utils`, потому что эти файлы не будут скопированы.

117 117 

118 Если вам нужно совместно использовать файлы между плагинами, используйте символические ссылки. См. [Кэширование плагинов и разрешение файлов](/ru/plugins-reference#plugin-caching-and-file-resolution) для получения подробной информации.118 Если вам нужно совместно использовать файлы между плагинами, используйте символические ссылки. См. [Кэширование плагинов и разрешение файлов](/docs/ru/plugins-reference#plugin-caching-and-file-resolution) для получения подробной информации.

119</Note>119</Note>

120 120 

121<h2 id="create-the-marketplace-file">121<h2 id="create-the-marketplace-file">


172<Note>172<Note>

173 **Зарезервированные имена**: следующие имена marketplace зарезервированы для официального использования Anthropic и не могут использоваться сторонними marketplace: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins`, `healthcare`. Имена, которые выдают себя за официальные marketplace, такие как `official-claude-plugins` или `anthropic-plugins-v2`, также заблокированы. Резервирование этих имен предотвращает представление стороннего marketplace как источника, опубликованного Anthropic.173 **Зарезервированные имена**: следующие имена marketplace зарезервированы для официального использования Anthropic и не могут использоваться сторонними marketplace: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `claude-plugins-community`, `claude-community`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`, `claude-for-legal`, `claude-for-financial-services`, `financial-services-plugins`, `first-party-plugins`, `healthcare`. Имена, которые выдают себя за официальные marketplace, такие как `official-claude-plugins` или `anthropic-plugins-v2`, также заблокированы. Резервирование этих имен предотвращает представление стороннего marketplace как источника, опубликованного Anthropic.

174 174 

175 Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке marketplace, а не только при добавлении. Marketplace, зарегистрированный под одним из этих имен до того, как имя было зарезервировано, перестает загружаться и сообщает, что он [зарегистрирован из ненадежного источника](/ru/errors#marketplace-is-registered-from-an-untrusted-source). Удалите этот marketplace и добавьте его снова из официального источника Anthropic. Сторонний marketplace, затронутый вновь зарезервированным именем, загружается снова, как только вы добавите его под другим именем. До версии v2.1.205 `first-party-plugins` и `healthcare` не были зарезервированы, и marketplace, уже зарегистрированный под зарезервированным именем, продолжал загружаться.175 Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке marketplace, а не только при добавлении. Marketplace, зарегистрированный под одним из этих имен до того, как имя было зарезервировано, перестает загружаться и сообщает, что он [зарегистрирован из ненадежного источника](/docs/ru/errors#marketplace-is-registered-from-an-untrusted-source). Удалите этот marketplace и добавьте его снова из официального источника Anthropic. Сторонний marketplace, затронутый вновь зарезервированным именем, загружается снова, как только вы добавите его под другим именем. До версии v2.1.205 `first-party-plugins` и `healthcare` не были зарезервированы, и marketplace, уже зарегистрированный под зарезервированным именем, продолжал загружаться.

176</Note>176</Note>

177 177 

178<h3 id="owner-fields">178<h3 id="owner-fields">


189</h3>189</h3>

190 190 

191| Поле | Тип | Описание |191| Поле | Тип | Описание |

192| :------------------------------------ | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |192| :------------------------------------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

193| `$schema` | string | URL JSON Schema для автодополнения редактора и валидации. Claude Code игнорирует это поле при загрузке. |193| `$schema` | string | URL JSON Schema для автодополнения редактора и валидации. Claude Code игнорирует это поле при загрузке. |

194| `description` | string | Краткое описание marketplace |194| `description` | string | Краткое описание marketplace |

195| `version` | string | Версия манифеста marketplace |195| `version` | string | Версия манифеста marketplace |

196| `metadata.pluginRoot` | string | Базовый каталог, добавляемый к относительным путям источников плагинов (например, `"./plugins"` позволяет вам писать `"source": "formatter"` вместо `"source": "./plugins/formatter"`) |196| `metadata.pluginRoot` | string | Базовый каталог, добавляемый к относительным путям источников плагинов (например, `"./plugins"` позволяет вам писать `"source": "formatter"` вместо `"source": "./plugins/formatter"`) |

197| `allowCrossMarketplaceDependenciesOn` | array | Другие marketplace, на которые плагины в этом marketplace могут зависеть. Зависимости от marketplace, не указанного здесь, блокируются при установке. См. [Зависимость от плагина из другого marketplace](/ru/plugin-dependencies#depend-on-a-plugin-from-another-marketplace). |197| `allowCrossMarketplaceDependenciesOn` | array | Другие marketplace, на которые плагины в этом marketplace могут зависеть. Зависимости от marketplace, не указанного здесь, блокируются при установке. См. [Зависимость от плагина из другого marketplace](/docs/ru/plugin-dependencies#depend-on-a-plugin-from-another-marketplace). |

198| `renames` | object | {/* min-version: 2.1.193 */}Карта от прежнего имени плагина `name` к его текущему имени или к `null`, если плагин был удален. Позволяет существующим пользователям автоматически мигрировать при переименовании или удалении записи в `plugins`. См. [Переименование или удаление плагина](#rename-or-remove-a-plugin). Требуется Claude Code v2.1.193 или позже. |198| `renames` | object | Карта от прежнего имени плагина `name` к его текущему имени или к `null`, если плагин был удален. Позволяет существующим пользователям автоматически мигрировать при переименовании или удалении записи в `plugins`. См. [Переименование или удаление плагина](#rename-or-remove-a-plugin). Требуется Claude Code v2.1.193 или позже. |

199 199 

200`description` и `version` также принимаются в `metadata` для обратной совместимости.200`description` и `version` также принимаются в `metadata` для обратной совместимости.

201 201 


203 Записи плагинов203 Записи плагинов

204</h2>204</h2>

205 205 

206Каждая запись плагина в массиве `plugins` описывает плагин и где его найти. Вы можете включить любое поле из [схемы манифеста плагина](/ru/plugins-reference#plugin-manifest-schema), такие как `description`, `version`, `author`, `commands` и `hooks`, плюс эти поля, специфичные для marketplace: `source`, `category`, `tags`, `strict` и `relevance`.206Каждая запись плагина в массиве `plugins` описывает плагин и где его найти. Вы можете включить любое поле из [схемы манифеста плагина](/docs/ru/plugins-reference#plugin-manifest-schema), такие как `description`, `version`, `author`, `commands` и `hooks`, плюс эти поля, специфичные для marketplace: `source`, `category`, `tags`, `strict` и `relevance`.

207 207 

208<h3 id="required-fields-2">208<h3 id="required-fields-2">

209 Обязательные поля209 Обязательные поля


221**Поля стандартных метаданных:**221**Поля стандартных метаданных:**

222 222 

223| Поле | Тип | Описание |223| Поле | Тип | Описание |

224| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |224| :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

225| `displayName` | string | {/* min-version: 2.1.143 */}Удобочитаемое имя, отображаемое в интерфейсе. Возвращается к `name` при отсутствии. Может содержать пробелы и любой регистр. Не используется для пространства имён или поиска. Требуется Claude Code v2.1.143 или позже. |225| `displayName` | string | Удобочитаемое имя, отображаемое в интерфейсе. Возвращается к `name` при отсутствии. Может содержать пробелы и любой регистр. Не используется для пространства имён или поиска. Требуется Claude Code v2.1.143 или позже. |

226| `description` | string | Краткое описание плагина |226| `description` | string | Краткое описание плагина |

227| `version` | string | Версия плагина. Если установлено (здесь или в `plugin.json`), плагин закреплен на этой строке и пользователи получают обновления только при её изменении. Опустите, чтобы вернуться к SHA коммита git. См. [Разрешение версий](#version-resolution-and-release-channels). |227| `version` | string | Версия плагина. Если установлено (здесь или в `plugin.json`), плагин закреплен на этой строке и пользователи получают обновления только при её изменении. Опустите, чтобы вернуться к SHA коммита git. См. [Разрешение версий](#version-resolution-and-release-channels). |

228| `author` | object | Информация об авторе плагина (`name` обязательно, `email` опционально) |228| `author` | object | Информация об авторе плагина (`name` обязательно, `email` опционально) |


233| `category` | string | Категория плагина для организации |233| `category` | string | Категория плагина для организации |

234| `tags` | array | Теги для поиска |234| `tags` | array | Теги для поиска |

235| `strict` | boolean | Контролирует, является ли `plugin.json` авторитетом для определений компонентов (по умолчанию: true). См. [Strict mode](#strict-mode) ниже. |235| `strict` | boolean | Контролирует, является ли `plugin.json` авторитетом для определений компонентов (по умолчанию: true). См. [Strict mode](#strict-mode) ниже. |

236| `relevance` | object | {/* min-version: 2.1.152 */}Сигналы, которые сообщают Claude Code, когда предложить этот плагин пользователям. Вступает в силу только для marketplaces, которые администратор добавляет в список разрешённых в управляемых параметрах. См. [Рекомендовать плагины для вашей организации](/ru/plugin-relevance). Требуется Claude Code v2.1.152 или позже. |236| `relevance` | object | Сигналы, которые сообщают Claude Code, когда предложить этот плагин пользователям. Вступает в силу только для marketplaces, которые администратор добавляет в список разрешённых в управляемых параметрах. См. [Рекомендовать плагины для вашей организации](/docs/ru/plugin-relevance). Требуется Claude Code v2.1.152 или позже. |

237| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Включен ли плагин после установки (по умолчанию: true). Установите значение `false`, чтобы установить плагин отключённым до тех пор, пока пользователь не согласится. Имеет приоритет над тем же полем в `plugin.json` плагина. См. [Включение по умолчанию](/ru/plugins-reference#default-enablement). Требуется Claude Code v2.1.154 или позже. |237| `defaultEnabled` | boolean | Включен ли плагин после установки (по умолчанию: true). Установите значение `false`, чтобы установить плагин отключённым до тех пор, пока пользователь не согласится. Имеет приоритет над тем же полем в `plugin.json` плагина. См. [Включение по умолчанию](/docs/ru/plugins-reference#default-enablement). Требуется Claude Code v2.1.154 или позже. |

238 238 

239**Поля конфигурации компонентов:**239**Поля конфигурации компонентов:**

240 240 


510 510 

511* **`commands` и `agents`**: вы можете указать несколько каталогов или отдельные файлы. Пути относительны к корню плагина.511* **`commands` и `agents`**: вы можете указать несколько каталогов или отдельные файлы. Пути относительны к корню плагина.

512* **`${CLAUDE_PLUGIN_ROOT}`**: используйте эту переменную в командах hooks и конфигурациях MCP server для ссылки на файлы в каталоге установки плагина. Это необходимо, потому что плагины копируются в место кэша при установке.512* **`${CLAUDE_PLUGIN_ROOT}`**: используйте эту переменную в командах hooks и конфигурациях MCP server для ссылки на файлы в каталоге установки плагина. Это необходимо, потому что плагины копируются в место кэша при установке.

513 * См. [таблицу подстановки](/ru/plugins-reference#environment-variables) для того, какие поля конфигурации подставляют её для каждого типа сервера513 * См. [таблицу подстановки](/docs/ru/plugins-reference#environment-variables) для того, какие поля конфигурации подставляют её для каждого типа сервера

514 * Для зависимостей или состояния, которое должно сохраняться при обновлениях плагина, используйте [`${CLAUDE_PLUGIN_DATA}`](/ru/plugins-reference#persistent-data-directory) вместо этого514 * Для зависимостей или состояния, которое должно сохраняться при обновлениях плагина, используйте [`${CLAUDE_PLUGIN_DATA}`](/docs/ru/plugins-reference#persistent-data-directory) вместо этого

515* **`strict: false`**: поскольку это установлено на false, плагину не нужен собственный `plugin.json`. Запись marketplace определяет все. См. [Strict mode](#strict-mode) ниже.515* **`strict: false`**: поскольку это установлено на false, плагину не нужен собственный `plugin.json`. Запись marketplace определяет все. См. [Strict mode](#strict-mode) ниже.

516 516 

517По умолчанию skills плагина загружаются из каталога `skills/` в его `source`. Пути, указанные в поле `skills`, добавляются к этому сканированию:517По умолчанию skills плагина загружаются из каталога `skills/` в его `source`. Пути, указанные в поле `skills`, добавляются к этому сканированию:


575 Частные репозитории575 Частные репозитории

576</h3>576</h3>

577 577 

578Claude Code поддерживает установку плагинов из частных репозиториев. Для ручной установки и обновлений Claude Code использует ваши существующие помощники учетных данных Git, поэтому доступ HTTPS через `gh auth login`, macOS Keychain или `git-credential-store` работает так же, как в вашем терминале. Доступ SSH работает, пока хост уже находится в вашем файле `known_hosts` и ключ загружен в `ssh-agent`, так как Claude Code подавляет интерактивные подсказки SSH для отпечатка хоста и пароля ключа. Сокращение GitHub `owner/repo` по умолчанию клонирует через SSH; установите [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/ru/env-vars#variables), чтобы вместо этого клонировать их через HTTPS.578Claude Code поддерживает установку плагинов из частных репозиториев. Для ручной установки и обновлений Claude Code использует ваши существующие помощники учетных данных Git, поэтому доступ HTTPS через `gh auth login`, macOS Keychain или `git-credential-store` работает так же, как в вашем терминале. Доступ SSH работает, пока хост уже находится в вашем файле `known_hosts` и ключ загружен в `ssh-agent`, так как Claude Code подавляет интерактивные подсказки SSH для отпечатка хоста и пароля ключа. Сокращение GitHub `owner/repo` по умолчанию клонирует через SSH; установите [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ru/env-vars#variables), чтобы вместо этого клонировать их через HTTPS.

579 579 

580Фоновые автоматические обновления работают иначе. По умолчанию фоновое обновление отключает помощников учетных данных Git для своего `git pull`, поэтому pull не может аутентифицироваться в частных репозиториях через HTTPS, даже если помощник настроен. Удаленные SSH не затронуты: ключ, загруженный в `ssh-agent`, аутентифицирует фоновые pull так же, как ручные операции. Когда фоновый pull не удается, Claude Code возвращается к повторному клонированию marketplace с нуля. Повторное клонирование использует ваши сохраненные учетные данные Git, но оно может [истечь на больших репозиториях](#git-operations-time-out), поэтому автоматические обновления частного marketplace могут периодически не удаваться.580Фоновые автоматические обновления работают иначе. По умолчанию фоновое обновление отключает помощников учетных данных Git для своего `git pull`, поэтому pull не может аутентифицироваться в частных репозиториях через HTTPS, даже если помощник настроен. Удаленные SSH не затронуты: ключ, загруженный в `ssh-agent`, аутентифицирует фоновые pull так же, как ручные операции. Когда фоновый pull не удается, Claude Code возвращается к повторному клонированию marketplace с нуля. Повторное клонирование использует ваши сохраненные учетные данные Git, но оно может [истечь на больших репозиториях](#git-operations-time-out), поэтому автоматические обновления частного marketplace могут периодически не удаваться.

581 581 


619/plugin install quality-review-plugin@my-plugins619/plugin install quality-review-plugin@my-plugins

620```620```

621 621 

622Для полного диапазона команд добавления (GitHub, URL Git, локальные пути, удаленные URL), см. [Добавление marketplace](/ru/discover-plugins#add-marketplaces).622Для полного диапазона команд добавления (GitHub, URL Git, локальные пути, удаленные URL), см. [Добавление marketplace](/docs/ru/discover-plugins#add-marketplaces).

623 623 

624<h3 id="require-marketplaces-for-your-team">624<h3 id="require-marketplaces-for-your-team">

625 Требование marketplace для вашей команды625 Требование marketplace для вашей команды


651}651}

652```652```

653 653 

654Для полных параметров конфигурации см. [Параметры плагинов](/ru/settings#plugin-settings).654Для полных параметров конфигурации см. [Параметры плагинов](/docs/ru/settings#plugin-settings).

655 655 

656<Note>656<Note>

657 Если вы используете локальный источник `directory` или `file` с относительным путем, путь разрешается относительно основного checkout вашего репозитория. Когда вы запускаете Claude Code из git worktree, путь все еще указывает на основной checkout, поэтому все worktrees совместно используют одно и то же расположение marketplace. Состояние marketplace хранится один раз для каждого пользователя в `~/.claude/plugins/known_marketplaces.json`, а не для каждого проекта.657 Если вы используете локальный источник `directory` или `file` с относительным путем, путь разрешается относительно основного checkout вашего репозитория. Когда вы запускаете Claude Code из git worktree, путь все еще указывает на основной checkout, поэтому все worktrees совместно используют одно и то же расположение marketplace. Состояние marketplace хранится один раз для каждого пользователя в `~/.claude/plugins/known_marketplaces.json`, а не для каждого проекта.


699 Ограничения управляемого marketplace699 Ограничения управляемого marketplace

700</h3>700</h3>

701 701 

702Для организаций, требующих строгого контроля над источниками плагинов, администраторы могут ограничить, какие marketplace плагинов пользователи могут добавлять, используя параметр [`strictKnownMarketplaces`](/ru/settings#strictknownmarketplaces) в управляемых параметрах. Чтобы также отклонить флаги CLI, которые загружают плагины, агентов и MCP серверы для одного запуска, объедините его с [`disableSideloadFlags`](/ru/settings#available-settings). Чтобы разрешить список, какие marketplace плагинов могут появляться как предложения контекстной установки, установите [`pluginSuggestionMarketplaces`](/ru/settings#available-settings).702Для организаций, требующих строгого контроля над источниками плагинов, администраторы могут ограничить, какие marketplace плагинов пользователи могут добавлять, используя параметр [`strictKnownMarketplaces`](/docs/ru/settings#strictknownmarketplaces) в управляемых параметрах. Чтобы также отклонить флаги CLI, которые загружают плагины, агентов и MCP серверы для одного запуска, объедините его с [`disableSideloadFlags`](/docs/ru/settings#available-settings). Чтобы разрешить список, какие marketplace плагинов могут появляться как предложения контекстной установки, установите [`pluginSuggestionMarketplaces`](/docs/ru/settings#available-settings).

703 703 

704Когда `strictKnownMarketplaces` настроен в управляемых параметрах, поведение ограничения зависит от значения:704Когда `strictKnownMarketplaces` настроен в управляемых параметрах, поведение ограничения зависит от значения:

705 705 


743}743}

744```744```

745 745 

746Разрешение всех marketplace с внутреннего сервера Git с использованием сопоставления шаблонов регулярных выражений на хосте. Это рекомендуемый подход для [GitHub Enterprise Server](/ru/github-enterprise-server#plugin-marketplaces-on-ghes) или самостоятельно размещаемых экземпляров GitLab:746Разрешение всех marketplace с внутреннего сервера Git с использованием сопоставления шаблонов регулярных выражений на хосте. Это рекомендуемый подход для [GitHub Enterprise Server](/docs/ru/github-enterprise-server#plugin-marketplaces-on-ghes) или самостоятельно размещаемых экземпляров GitLab:

747 747 

748```json theme={null}748```json theme={null}

749{749{


772Используйте `".*"` как `pathPattern` для разрешения любого пути файловой системы при одновременном контроле сетевых источников с помощью `hostPattern`.772Используйте `".*"` как `pathPattern` для разрешения любого пути файловой системы при одновременном контроле сетевых источников с помощью `hostPattern`.

773 773 

774<Note>774<Note>

775 `strictKnownMarketplaces` ограничивает то, что пользователи могут добавлять, но не регистрирует marketplace самостоятельно. Чтобы сделать разрешенные marketplace доступными автоматически без запуска пользователями `/plugin marketplace add`, объедините его с [`extraKnownMarketplaces`](/ru/settings#extraknownmarketplaces) в одном файле `managed-settings.json`. См. [Использование обоих вместе](/ru/settings#strictknownmarketplaces).775 `strictKnownMarketplaces` ограничивает то, что пользователи могут добавлять, но не регистрирует marketplace самостоятельно. Чтобы сделать разрешенные marketplace доступными автоматически без запуска пользователями `/plugin marketplace add`, объедините его с [`extraKnownMarketplaces`](/docs/ru/settings#extraknownmarketplaces) в одном файле `managed-settings.json`. См. [Использование обоих вместе](/docs/ru/settings#strictknownmarketplaces).

776</Note>776</Note>

777 777 

778<h4 id="how-restrictions-work">778<h4 id="how-restrictions-work">


790 790 

791Точное сопоставление не нормализует URL: конечная косая черта, суффикс `.git` или форма `ssh://` в сравнении с `https://` рассматриваются как разные значения. Если marketplace вашей организации можно клонировать более чем одной формой URL, предпочтите запись `hostPattern` буквальному URL, чтобы все формы совпадали.791Точное сопоставление не нормализует URL: конечная косая черта, суффикс `.git` или форма `ssh://` в сравнении с `https://` рассматриваются как разные значения. Если marketplace вашей организации можно клонировать более чем одной формой URL, предпочтите запись `hostPattern` буквальному URL, чтобы все формы совпадали.

792 792 

793Поскольку `strictKnownMarketplaces` установлен в [управляемых параметрах](/ru/settings#settings-files), отдельные пользователи и конфигурации проекта не могут переопределить эти ограничения.793Поскольку `strictKnownMarketplaces` установлен в [управляемых параметрах](/docs/ru/settings#settings-files), отдельные пользователи и конфигурации проекта не могут переопределить эти ограничения.

794 794 

795Для полных деталей конфигурации, включая все поддерживаемые типы источников и сравнение с `extraKnownMarketplaces`, см. [справку strictKnownMarketplaces](/ru/settings#strictknownmarketplaces).795Для полных деталей конфигурации, включая все поддерживаемые типы источников и сравнение с `extraKnownMarketplaces`, см. [справку strictKnownMarketplaces](/docs/ru/settings#strictknownmarketplaces).

796 796 

797<h3 id="version-resolution-and-release-channels">797<h3 id="version-resolution-and-release-channels">

798 Разрешение версий и каналы выпуска798 Разрешение версий и каналы выпуска


818 Установка каналов выпуска818 Установка каналов выпуска

819</h4>819</h4>

820 820 

821Для поддержки каналов выпуска "stable" и "latest" для ваших плагинов вы можете установить два marketplace, которые указывают на разные refs или SHAs одного репозитория. Затем вы можете назначить два marketplace разным группам пользователей через [управляемые параметры](/ru/settings#settings-files).821Для поддержки каналов выпуска "stable" и "latest" для ваших плагинов вы можете установить два marketplace, которые указывают на разные refs или SHAs одного репозитория. Затем вы можете назначить два marketplace разным группам пользователей через [управляемые параметры](/docs/ru/settings#settings-files).

822 822 

823<Warning>823<Warning>

824 Каждый канал должен разрешаться в другую версию. Если вы используете явные версии, `plugin.json` должен объявлять другую `version` в каждом закрепленном ref. Если вы опустите `version`, различные SHA коммитов уже различают каналы. Если два refs разрешаются в одну и ту же строку версии, Claude Code рассматривает их как идентичные и пропускает обновление.824 Каждый канал должен разрешаться в другую версию. Если вы используете явные версии, `plugin.json` должен объявлять другую `version` в каждом закрепленном ref. Если вы опустите `version`, различные SHA коммитов уже различают каналы. Если два refs разрешаются в одну и ту же строку версии, Claude Code рассматривает их как идентичные и пропускает обновление.


898 Закрепление версий зависимостей плагинов898 Закрепление версий зависимостей плагинов

899</h4>899</h4>

900 900 

901Плагин может ограничить свои зависимости диапазоном semver, чтобы обновления зависимости не нарушили зависимый плагин. См. [Ограничение версий зависимостей плагинов](/ru/plugin-dependencies) для соглашения о тегах Git `{plugin-name}--v{version}`, синтаксиса диапазона и того, как несколько ограничений на одну и ту же зависимость объединяются.901Плагин может ограничить свои зависимости диапазоном semver, чтобы обновления зависимости не нарушили зависимый плагин. См. [Ограничение версий зависимостей плагинов](/docs/ru/plugin-dependencies) для соглашения о тегах Git `{plugin-name}--v{version}`, синтаксиса диапазона и того, как несколько ограничений на одну и ту же зависимость объединяются.

902 902 

903<h3 id="rename-or-remove-a-plugin">903<h3 id="rename-or-remove-a-plugin">

904 Переименование или удаление плагина904 Переименование или удаление плагина


968/plugin install test-plugin@marketplace-name968/plugin install test-plugin@marketplace-name

969```969```

970 970 

971Для полного диапазона рабочих процессов тестирования плагинов см. [Тестирование ваших плагинов локально](/ru/plugins#test-your-plugins-locally). Для технического устранения неполадок см. [Справка плагинов](/ru/plugins-reference).971Для полного диапазона рабочих процессов тестирования плагинов см. [Тестирование ваших плагинов локально](/docs/ru/plugins#test-your-plugins-locally). Для технического устранения неполадок см. [Справка плагинов](/docs/ru/plugins-reference).

972 972 

973<h2 id="manage-marketplaces-from-the-cli">973<h2 id="manage-marketplaces-from-the-cli">

974 Управление marketplace из CLI974 Управление marketplace из CLI


996 996 

997| Параметр | Описание | По умолчанию |997| Параметр | Описание | По умолчанию |

998| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | :----------- |998| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | :----------- |

999| `--scope <scope>` | Где объявить marketplace: `user`, `project` или `local`. См. [Области установки плагинов](/ru/plugins-reference#plugin-installation-scopes) | `user` |999| `--scope <scope>` | Где объявить marketplace: `user`, `project` или `local`. См. [Области установки плагинов](/docs/ru/plugins-reference#plugin-installation-scopes) | `user` |

1000| `--sparse <paths...>` | Ограничить checkout определенными каталогами через git sparse-checkout. Полезно для монорепозиториев | |1000| `--sparse <paths...>` | Ограничить checkout определенными каталогами через git sparse-checkout. Полезно для монорепозиториев | |

1001 1001 

1002Добавьте marketplace из GitHub, используя сокращение `owner/repo`:1002Добавьте marketplace из GitHub, используя сокращение `owner/repo`:


1077 1077 

1078| Параметр | Описание | По умолчанию |1078| Параметр | Описание | По умолчанию |

1079| :---------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ |1079| :---------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ |

1080| `--scope <scope>` | Ограничить удаление одной областью параметров: `user`, `project` или `local`. См. [Области установки плагинов](/ru/plugins-reference#plugin-installation-scopes). Если опущено, объявление удаляется из каждой редактируемой области. Если указано, удаляется только объявление этой области; общее состояние, кэш и установленные данные плагина сохраняются, когда marketplace все еще объявлен в другой области | (все области) |1080| `--scope <scope>` | Ограничить удаление одной областью параметров: `user`, `project` или `local`. См. [Области установки плагинов](/docs/ru/plugins-reference#plugin-installation-scopes). Если опущено, объявление удаляется из каждой редактируемой области. Если указано, удаляется только объявление этой области; общее состояние, кэш и установленные данные плагина сохраняются, когда marketplace все еще объявлен в другой области | (все области) |

1081 1081 

1082<Warning>1082<Warning>

1083 Удаление marketplace из его последней оставшейся области также удаляет все плагины, которые вы установили из него. Чтобы обновить marketplace без потери установленных плагинов, используйте `claude plugin marketplace update` вместо этого.1083 Удаление marketplace из его последней оставшейся области также удаляет все плагины, которые вы установили из него. Чтобы обновить marketplace без потери установленных плагинов, используйте `claude plugin marketplace update` вместо этого.


1238 1238 

1239**Причина**: Плагины копируются в каталог кэша, а не используются на месте. Пути, которые ссылаются на файлы вне каталога плагина (например, `../shared-utils`), не будут работать, потому что эти файлы не копируются.1239**Причина**: Плагины копируются в каталог кэша, а не используются на месте. Пути, которые ссылаются на файлы вне каталога плагина (например, `../shared-utils`), не будут работать, потому что эти файлы не копируются.

1240 1240 

1241**Решения**: См. [Кэширование плагинов и разрешение файлов](/ru/plugins-reference#plugin-caching-and-file-resolution) для обходных путей, включая символические ссылки и переструктурирование каталогов.1241**Решения**: См. [Кэширование плагинов и разрешение файлов](/docs/ru/plugins-reference#plugin-caching-and-file-resolution) для обходных путей, включая символические ссылки и переструктурирование каталогов.

1242 1242 

1243Для дополнительных инструментов отладки и распространенных проблем см. [Инструменты отладки и разработки](/ru/plugins-reference#debugging-and-development-tools).1243Для дополнительных инструментов отладки и распространенных проблем см. [Инструменты отладки и разработки](/docs/ru/plugins-reference#debugging-and-development-tools).

1244 1244 

1245<h2 id="see-also">1245<h2 id="see-also">

1246 См. также1246 См. также

1247</h2>1247</h2>

1248 1248 

1249* [Обнаружение и установка готовых плагинов](/ru/discover-plugins) - Установка плагинов из существующих marketplace1249* [Обнаружение и установка готовых плагинов](/docs/ru/discover-plugins) - Установка плагинов из существующих marketplace

1250* [Плагины](/ru/plugins) - Создание собственных плагинов1250* [Плагины](/docs/ru/plugins) - Создание собственных плагинов

1251* [Справка плагинов](/ru/plugins-reference) - Полные технические спецификации и схемы1251* [Справка плагинов](/docs/ru/plugins-reference) - Полные технические спецификации и схемы

1252* [Параметры плагинов](/ru/settings#plugin-settings) - Параметры конфигурации плагинов1252* [Параметры плагинов](/docs/ru/settings#plugin-settings) - Параметры конфигурации плагинов

1253* [Справка strictKnownMarketplaces](/ru/settings#strictknownmarketplaces) - Ограничения управляемого marketplace1253* [Справка strictKnownMarketplaces](/docs/ru/settings#strictknownmarketplaces) - Ограничения управляемого marketplace

Details

8 8 

9Если вы управляете marketplace plugins для вашей организации, вы можете заставить Claude Code предлагать конкретные plugins пользователям на основе того, над чем они работают. Добавьте блок `relevance` к записи plugin в `marketplace.json`, затем добавьте marketplace в список разрешённых в управляемых параметрах. Когда сеанс пользователя совпадает с одним из объявленных сигналов, Claude Code выводит предложение об установке этого plugin.9Если вы управляете marketplace plugins для вашей организации, вы можете заставить Claude Code предлагать конкретные plugins пользователям на основе того, над чем они работают. Добавьте блок `relevance` к записи plugin в `marketplace.json`, затем добавьте marketplace в список разрешённых в управляемых параметрах. Когда сеанс пользователя совпадает с одним из объявленных сигналов, Claude Code выводит предложение об установке этого plugin.

10 10 

11Предложения, объявленные на marketplace, являются добровольными для каждого marketplace через [управляемые параметры](/ru/settings#settings-files). Никакие объявления `relevance` marketplace не создают предложения, пока администратор не добавит его в список разрешённых, включая официальный marketplace Anthropic. Claude Code также включает одно встроенное предложение, которое не зависит от этого списка разрешённых; это совет и все объявленные на marketplace советы отключаются, когда [`spinnerTipsEnabled`](/ru/settings#available-settings) установлен на `false`.11Предложения, объявленные на marketplace, являются добровольными для каждого marketplace через [управляемые параметры](/docs/ru/settings#settings-files). Никакие объявления `relevance` marketplace не создают предложения, пока администратор не добавит его в список разрешённых, включая официальный marketplace Anthropic. Claude Code также включает одно встроенное предложение, которое не зависит от этого списка разрешённых; это совет и все объявленные на marketplace советы отключаются, когда [`spinnerTipsEnabled`](/docs/ru/settings#available-settings) установлен на `false`.

12 12 

13{/* min-version: 2.1.152 */}Эта функция требует Claude Code v2.1.152 или позже. Старые клиенты игнорируют поле `relevance`.13Эта функция требует Claude Code v2.1.152 или позже. Старые клиенты игнорируют поле `relevance`.

14 14 

15Эта страница предназначена для операторов marketplace и администраторов предприятия. Если вы ищете установку plugins, см. [Обнаружение и установка plugins](/ru/discover-plugins).15Эта страница предназначена для операторов marketplace и администраторов предприятия. Если вы ищете установку plugins, см. [Обнаружение и установка plugins](/docs/ru/discover-plugins).

16 16 

17<h2 id="how-it-works">17<h2 id="how-it-works">

18 Как это работает18 Как это работает


25Когда сигнал совпадает и plugin ещё не установлен, Claude Code показывает plugin в трёх местах:25Когда сигнал совпадает и plugin ещё не установлен, Claude Code показывает plugin в трёх местах:

26 26 

27* **Spinner tip**: сообщение "Working with *topic*? Install the *plugin* plugin" с командой `/plugin install` появляется под спиннером, пока Claude отвечает.27* **Spinner tip**: сообщение "Working with *topic*? Install the *plugin* plugin" с командой `/plugin install` появляется под спиннером, пока Claude отвечает.

28* **Session-start suggestion**: {/* min-version: 2.1.153 */}если сигнал `cwd` совпадает с рабочим каталогом, однострочное уведомление `plugin suggestion: <name>@<marketplace> · /plugin` появляется перед первым ходом. Эта поверхность требует Claude Code v2.1.153 или позже.28* **Session-start suggestion**: если сигнал `cwd` совпадает с рабочим каталогом, однострочное уведомление `plugin suggestion: <name>@<marketplace> · /plugin` появляется перед первым ходом. Эта поверхность требует Claude Code v2.1.153 или позже.

29* **`/plugin` Discover tab**: {/* min-version: 2.1.154 */}plugin закреплён в верхней части списка Discover с аннотацией, такой как "suggested for this directory" или "suggested for stripe commands". Эта поверхность требует Claude Code v2.1.154 или позже.29* **`/plugin` Discover tab**: plugin закреплён в верхней части списка Discover с аннотацией, такой как "suggested for this directory" или "suggested for stripe commands". Эта поверхность требует Claude Code v2.1.154 или позже.

30 30 

31Spinner tip и уведомление о начале сеанса являются частью системы spinner-tips. Оба отключаются, когда пользователь или проект устанавливает `spinnerTipsEnabled` на `false`, или когда настроен пользовательский `spinnerTipsOverride` с `excludeDefault`. Закрепление на вкладке Discover независимо от параметров советов.31Spinner tip и уведомление о начале сеанса являются частью системы spinner-tips. Оба отключаются, когда пользователь или проект устанавливает `spinnerTipsEnabled` на `false`, или когда настроен пользовательский `spinnerTipsOverride` с `excludeDefault`. Закрепление на вкладке Discover независимо от параметров советов.

32 32 


80 80 

81| Поле | Тип | Описание |81| Поле | Тип | Описание |

82| :------------- | :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |82| :------------- | :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

83| `cwd` | array of strings | {/* min-version: 2.1.153 */}Glob-шаблоны, сопоставляемые с рабочим каталогом сеанса. Сопоставляется как абсолютный путь и, когда находится в репозитории git, как путь относительно корня репозитория. Нормализовано с прямыми слешами и без учёта регистра. Каждый шаблон совпадает с самим каталогом и всем, что находится под ним, поэтому `infra`, `infra/` и `infra/**` ведут себя одинаково. Это единственный сигнал, который может совпадать при запуске сеанса, до первого хода. Максимум 10 шаблонов по 256 символов каждый. |83| `cwd` | array of strings | Glob-шаблоны, сопоставляемые с рабочим каталогом сеанса. Сопоставляется как абсолютный путь и, когда находится в репозитории git, как путь относительно корня репозитория. Нормализовано с прямыми слешами и без учёта регистра. Каждый шаблон совпадает с самим каталогом и всем, что находится под ним, поэтому `infra`, `infra/` и `infra/**` ведут себя одинаково. Это единственный сигнал, который может совпадать при запуске сеанса, до первого хода. Максимум 10 шаблонов по 256 символов каждый. |

84| `cli` | array of strings | Названия команд из shell-команд, которые Claude запустил в этом сеансе, например `["stripe"]`. Применяется на каждой платформе: команды, запущенные на Windows через PowerShell или Git Bash, записываются одинаково. Claude Code записывает одно название команды на вызов shell-инструмента: первый токен после любых назначений переменных окружения и `sudo`. Составные команды вносят только свою ведущую команду, поэтому `cd infra && terraform plan` записывает `cd`, а не `terraform`. Точное совпадение. Максимум 10 записей по 64 символа каждая. |84| `cli` | array of strings | Названия команд из shell-команд, которые Claude запустил в этом сеансе, например `["stripe"]`. Применяется на каждой платформе: команды, запущенные на Windows через PowerShell или Git Bash, записываются одинаково. Claude Code записывает одно название команды на вызов shell-инструмента: первый токен после любых назначений переменных окружения и `sudo`. Составные команды вносят только свою ведущую команду, поэтому `cd infra && terraform plan` записывает `cd`, а не `terraform`. Точное совпадение. Максимум 10 записей по 64 символа каждая. |

85| `hosts` | array of strings | Имена хостов, видимые в URL-адресах `http://` или `https://` в Bash-командах этого сеанса, например `["api.stripe.com"]`. Только голое имя хоста в нижнем регистре: без схемы, порта или пути. Точное совпадение без учёта регистра. Максимум 20 записей по 128 символов каждая. |85| `hosts` | array of strings | Имена хостов, видимые в URL-адресах `http://` или `https://` в Bash-командах этого сеанса, например `["api.stripe.com"]`. Только голое имя хоста в нижнем регистре: без схемы, порта или пути. Точное совпадение без учёта регистра. Максимум 20 записей по 128 символов каждая. |

86| `filesRead` | array of strings | {/* min-version: 2.1.153 */}Glob-шаблоны, сопоставляемые с путями файлов, которые Claude прочитал в этом сеансе, например `["**/*.tf"]`. Нормализовано с прямыми слешами и без учёта регистра. Максимум 10 шаблонов по 256 символов каждый. |86| `filesRead` | array of strings | Glob-шаблоны, сопоставляемые с путями файлов, которые Claude прочитал в этом сеансе, например `["**/*.tf"]`. Нормализовано с прямыми слешами и без учёта регистра. Максимум 10 шаблонов по 256 символов каждый. |

87| `manifestDeps` | array of objects | Зависимости, объявленные в манифестах пакетов, которые Claude прочитал в этом сеансе. Каждая запись — это `{ "file": "...", "pattern": "..." }`, где `file` — это регулярное выражение, сопоставляемое с путём файла манифеста, как записано в состояние сеанса, обычно абсолютный путь, и `pattern` — это регулярное выражение, сопоставляемое с содержимым этого файла. Якорь `file` в конце, например `[/\\\\]package\\.json$` в JSON-экранированной форме, потому что шаблон с якорем в начале никогда не совпадает с абсолютным путём. Пути не нормализуются по разделителям для этого сигнала, поэтому пути Windows используют обратные слеши. Файлы манифеста размером более 512 КБ пропускаются. Оба значения — это строки источника JavaScript `RegExp` максимум по 256 символов. `file` совпадает без учёта регистра. `pattern` чувствителен к регистру. Максимум 10 записей. |87| `manifestDeps` | array of objects | Зависимости, объявленные в манифестах пакетов, которые Claude прочитал в этом сеансе. Каждая запись — это `{ "file": "...", "pattern": "..." }`, где `file` — это регулярное выражение, сопоставляемое с путём файла манифеста, как записано в состояние сеанса, обычно абсолютный путь, и `pattern` — это регулярное выражение, сопоставляемое с содержимым этого файла. Якорь `file` в конце, например `[/\\\\]package\\.json$` в JSON-экранированной форме, потому что шаблон с якорем в начале никогда не совпадает с абсолютным путём. Пути не нормализуются по разделителям для этого сигнала, поэтому пути Windows используют обратные слеши. Файлы манифеста размером более 512 КБ пропускаются. Оба значения — это строки источника JavaScript `RegExp` максимум по 256 символов. `file` совпадает без учёта регистра. `pattern` чувствителен к регистру. Максимум 10 записей. |

88 88 

89Сигналы `cli`, `hosts`, `filesRead` и `manifestDeps` требуют истории сеанса, поэтому они могут совпадать только на spinner tip и вкладке Discover. Только `cwd` может совпадать при запуске сеанса. Сигналы `filesRead` и `manifestDeps` проверяют записанное состояние файлов сеанса, которое также включает файлы, которые Claude написал или отредактировал, и автоматически загруженные файлы памяти `CLAUDE.md`.89Сигналы `cli`, `hosts`, `filesRead` и `manifestDeps` требуют истории сеанса, поэтому они могут совпадать только на spinner tip и вкладке Discover. Только `cwd` может совпадать при запуске сеанса. Сигналы `filesRead` и `manifestDeps` проверяют записанное состояние файлов сеанса, которое также включает файлы, которые Claude написал или отредактировал, и автоматически загруженные файлы памяти `CLAUDE.md`.


116 Включите предложения в управляемых параметрах116 Включите предложения в управляемых параметрах

117</h2>117</h2>

118 118 

119Объявление `relevance` в `marketplace.json` недостаточно само по себе. Администратор должен добавить marketplace в список разрешённых в [управляемых параметрах](/ru/settings#settings-files), прежде чем его предложения появятся пользователям.119Объявление `relevance` в `marketplace.json` недостаточно само по себе. Администратор должен добавить marketplace в список разрешённых в [управляемых параметрах](/docs/ru/settings#settings-files), прежде чем его предложения появятся пользователям.

120 120 

121Добавьте название marketplace в `pluginSuggestionMarketplaces`. Для любого marketplace, кроме официального marketplace Anthropic, также объявите источник marketplace в тех же управляемых параметрах, либо как запись этого названия в `extraKnownMarketplaces`, либо как запись в `strictKnownMarketplaces`. Разрешённое название игнорируется, если marketplace, зарегистрированный на машине, поступил из другого источника. Это предотвращает регистрацию несвязанного источника под разрешённым названием для предложения его plugins по всей вашей организации.121Добавьте название marketplace в `pluginSuggestionMarketplaces`. Для любого marketplace, кроме официального marketplace Anthropic, также объявите источник marketplace в тех же управляемых параметрах, либо как запись этого названия в `extraKnownMarketplaces`, либо как запись в `strictKnownMarketplaces`. Разрешённое название игнорируется, если marketplace, зарегистрированный на машине, поступил из другого источника. Это предотвращает регистрацию несвязанного источника под разрешённым названием для предложения его plugins по всей вашей организации.

122 122 


144}144}

145```145```

146 146 

147См. [справочник параметров](/ru/settings) для `pluginSuggestionMarketplaces` и [`extraKnownMarketplaces`](/ru/settings#extraknownmarketplaces) для полных деталей конфигурации.147См. [справочник параметров](/docs/ru/settings) для `pluginSuggestionMarketplaces` и [`extraKnownMarketplaces`](/docs/ru/settings#extraknownmarketplaces) для полных деталей конфигурации.

148 148 

149<h2 id="what-the-user-sees">149<h2 id="what-the-user-sees">

150 Что видит пользователь150 Что видит пользователь


165 165 

166Предложение данного plugin появляется максимум один раз каждые три сеанса в совокупности на spinner tip и уведомлении о начале сеанса, и ни один из них не повторяется после установки plugin. Уведомление о начале сеанса дополнительно перестаёт появляться после того, как предложение было показано дважды.166Предложение данного plugin появляется максимум один раз каждые три сеанса в совокупности на spinner tip и уведомлении о начале сеанса, и ни один из них не повторяется после установки plugin. Уведомление о начале сеанса дополнительно перестаёт появляться после того, как предложение было показано дважды.

167 167 

168{/* min-version: 2.1.154 */}На вкладке `/plugin` Discover plugin закреплён выше других результатов с аннотацией, которая называет совпадающий сигнал, такой как `suggested for this directory` или `suggested for terraform commands`. Вкладка Discover закрепляет данный plugin один раз; последующие посещения перечисляют его в обычном порядке. Закрепление на вкладке Discover требует Claude Code v2.1.154 или позже. На v2.1.152 появляется только spinner tip; уведомление о начале сеанса добавляется в v2.1.153.168На вкладке `/plugin` Discover plugin закреплён выше других результатов с аннотацией, которая называет совпадающий сигнал, такой как `suggested for this directory` или `suggested for terraform commands`. Вкладка Discover закрепляет данный plugin один раз; последующие посещения перечисляют его в обычном порядке. Закрепление на вкладке Discover требует Claude Code v2.1.154 или позже. На v2.1.152 появляется только spinner tip; уведомление о начале сеанса добавляется в v2.1.153.

169 169 

170<h2 id="validate-your-marketplace">170<h2 id="validate-your-marketplace">

171 Проверьте ваш marketplace171 Проверьте ваш marketplace


183 См. также183 См. также

184</h2>184</h2>

185 185 

186* [Создание и распространение marketplace plugin](/ru/plugin-marketplaces): создайте marketplace, который размещает ваши plugins186* [Создание и распространение marketplace plugin](/docs/ru/plugin-marketplaces): создайте marketplace, который размещает ваши plugins

187* [Рекомендуйте ваш plugin из вашего CLI](/ru/plugin-hints): предложите пользователям из вашего собственного CLI вместо сигналов сеанса Claude Code187* [Рекомендуйте ваш plugin из вашего CLI](/docs/ru/plugin-hints): предложите пользователям из вашего собственного CLI вместо сигналов сеанса Claude Code

188* [Параметры](/ru/settings): полный справочник для `pluginSuggestionMarketplaces` и `extraKnownMarketplaces`188* [Параметры](/docs/ru/settings): полный справочник для `pluginSuggestionMarketplaces` и `extraKnownMarketplaces`

Details

515| Поле | Тип | Описание | Пример |515| Поле | Тип | Описание | Пример |

516| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |516| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

517| `$schema` | string | URL JSON Schema для автодополнения и валидации редактора. Claude Code игнорирует это поле при загрузке. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |517| `$schema` | string | URL JSON Schema для автодополнения и валидации редактора. Claude Code игнорирует это поле при загрузке. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |

518| `displayName` | string | {/* min-version: 2.1.143 */}Удобочитаемое имя, отображаемое в средстве выбора `/plugin` и других поверхностях пользовательского интерфейса. Возвращается к `name` при опущении. В отличие от `name`, может содержать пробелы и любой регистр. Не используется для пространства имён или поиска. Требует Claude Code v2.1.143 или более поздней версии. | `"Deployment Tools"` |518| `displayName` | string | Удобочитаемое имя, отображаемое в средстве выбора `/plugin` и других поверхностях пользовательского интерфейса. Возвращается к `name` при опущении. В отличие от `name`, может содержать пробелы и любой регистр. Не используется для пространства имён или поиска. Требует Claude Code v2.1.143 или более поздней версии. | `"Deployment Tools"` |

519| `version` | string | Опционально. Семантическая версия. Установка этого параметра закрепляет плагин на этой строке версии, поэтому пользователи получают обновления только при её изменении. Если опущено, Claude Code использует SHA коммита git, поэтому каждый коммит рассматривается как новая версия. Если также установлено в записи маркетплейса, `plugin.json` имеет приоритет. Смотрите [Управление версиями](#version-management). | `"2.1.0"` |519| `version` | string | Опционально. Семантическая версия. Установка этого параметра закрепляет плагин на этой строке версии, поэтому пользователи получают обновления только при её изменении. Если опущено, Claude Code использует SHA коммита git, поэтому каждый коммит рассматривается как новая версия. Если также установлено в записи маркетплейса, `plugin.json` имеет приоритет. Смотрите [Управление версиями](#version-management). | `"2.1.0"` |

520| `description` | string | Краткое объяснение назначения плагина | `"Deployment automation tools"` |520| `description` | string | Краткое объяснение назначения плагина | `"Deployment automation tools"` |

521| `author` | object | Информация об авторе | `{"name": "Dev Team", "email": "dev@company.com"}` |521| `author` | object | Информация об авторе | `{"name": "Dev Team", "email": "dev@company.com"}` |


523| `repository` | string | URL исходного кода | `"https://github.com/user/plugin"` |523| `repository` | string | URL исходного кода | `"https://github.com/user/plugin"` |

524| `license` | string | Идентификатор лицензии | `"MIT"`, `"Apache-2.0"` |524| `license` | string | Идентификатор лицензии | `"MIT"`, `"Apache-2.0"` |

525| `keywords` | array | Теги обнаружения | `["deployment", "ci-cd"]` |525| `keywords` | array | Теги обнаружения | `["deployment", "ci-cd"]` |

526| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Включен ли плагин в состояние включения, когда пользователь не установил его. По умолчанию `true`. Смотрите [Включение по умолчанию](#default-enablement). Требует Claude Code v2.1.154 или более поздней версии. | `false` |526| `defaultEnabled` | boolean | Включен ли плагин в состояние включения, когда пользователь не установил его. По умолчанию `true`. Смотрите [Включение по умолчанию](#default-enablement). Требует Claude Code v2.1.154 или более поздней версии. | `false` |

527 527 

528<h3 id="default-enablement">528<h3 id="default-enablement">

529 Включение по умолчанию529 Включение по умолчанию


612 612 

613До v2.1.207 эти поля подставляли значения `${user_config.KEY}`; обновите плагины, которые полагались на это.613До v2.1.207 эти поля подставляли значения `${user_config.KEY}`; обновите плагины, которые полагались на это.

614 614 

615Нечувствительные значения хранятся под ключом [`pluginConfigs`](/docs/ru/settings#pluginconfigs) в `settings.json` как `pluginConfigs[<plugin-id>].options`. {/* min-version: 2.1.207 */}Claude Code записывает ключ в параметры пользователя и читает его обратно из параметров пользователя, флага `--settings` и управляемых параметров только; записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются. До v2.1.207 Claude Code также читал параметры проекта и локальные параметры.615Нечувствительные значения хранятся под ключом [`pluginConfigs`](/docs/ru/settings#pluginconfigs) в `settings.json` как `pluginConfigs[<plugin-id>].options`. Claude Code записывает ключ в параметры пользователя и читает его обратно из параметров пользователя, флага `--settings` и управляемых параметров только; записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются. До v2.1.207 Claude Code также читал параметры проекта и локальные параметры.

616 616 

617Чувствительные значения переходят в macOS Keychain или в `~/.claude/.credentials.json` на платформах, где keychain недоступен. Хранилище Keychain общее с OAuth токенами и имеет приблизительный лимит 2 КБ, поэтому держите чувствительные значения небольшими.617Чувствительные значения переходят в macOS Keychain или в `~/.claude/.credentials.json` на платформах, где keychain недоступен. Хранилище Keychain общее с OAuth токенами и имеет приблизительный лимит 2 КБ, поэтому держите чувствительные значения небольшими.

618 618 

Details

116 116 

117Исключение — это плагин, который предоставляет [MCP серверы](/docs/ru/plugins-reference#mcp-servers). Включение или отключение одного следует тем же правилам, что и [подключение или отключение MCP сервера](#connecting-or-disconnecting-an-mcp-server): кэш сохраняется, когда инструменты сервера отложены, и следующий запрос повторно читает весь разговор, когда они загружаются в префикс.117Исключение — это плагин, который предоставляет [MCP серверы](/docs/ru/plugins-reference#mcp-servers). Включение или отключение одного следует тем же правилам, что и [подключение или отключение MCP сервера](#connecting-or-disconnecting-an-mcp-server): кэш сохраняется, когда инструменты сервера отложены, и следующий запрос повторно читает весь разговор, когда они загружаются в префикс.

118 118 

119Изменения плагина применяются при запуске [`/reload-plugins`](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting) или при запуске нового сеанса. Стоимость, будь то добавленные объявления или полное повторное чтение, отображается на первом ходе после перезагрузки, а не когда вы запускаете `/plugin install`, `/plugin enable` или `/plugin disable`. {/* min-version: 2.1.163 */}Начиная с v2.1.163, когда перезагрузка вызовет полное повторное чтение, `/reload-plugins` показывает предупреждение и не применяет перезагрузку. Передайте `--force` для применения в любом случае.119Изменения плагина применяются при запуске [`/reload-plugins`](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting) или при запуске нового сеанса. Стоимость, будь то добавленные объявления или полное повторное чтение, отображается на первом ходе после перезагрузки, а не когда вы запускаете `/plugin install`, `/plugin enable` или `/plugin disable`. Начиная с v2.1.163, когда перезагрузка вызовет полное повторное чтение, `/reload-plugins` показывает предупреждение и не применяет перезагрузку. Передайте `--force` для применения в любом случае.

120 120 

121Отключение плагина, который вы включили ранее в сеансе, восстанавливает предыдущую форму запроса. Если этот префикс все еще находится в пределах своего [времени жизни кэша](#cache-lifetime), следующий запрос читает более старую запись кэша вместо перестроения.121Отключение плагина, который вы включили ранее в сеансе, восстанавливает предыдущую форму запроса. Если этот префикс все еще находится в пределах своего [времени жизни кэша](#cache-lifetime), следующий запрос читает более старую запись кэша вместо перестроения.

122 122 

remote-control.md +38 −38

Details

14 14 

15Когда вы запускаете сеанс Remote Control на своем компьютере, Claude продолжает работать локально всё время, поэтому выполнение кода и доступ к файловой системе остаются на вашем компьютере. С помощью Remote Control вы можете:15Когда вы запускаете сеанс Remote Control на своем компьютере, Claude продолжает работать локально всё время, поэтому выполнение кода и доступ к файловой системе остаются на вашем компьютере. С помощью Remote Control вы можете:

16 16 

17* **Использовать полную локальную среду удалённо**: ваша файловая система, [MCP servers](/ru/mcp), инструменты и конфигурация проекта остаются доступными, и ввод `@` автоматически дополняет пути файлов из вашего локального проекта17* **Использовать полную локальную среду удалённо**: ваша файловая система, [MCP servers](/docs/ru/mcp), инструменты и конфигурация проекта остаются доступными, и ввод `@` автоматически дополняет пути файлов из вашего локального проекта

18* **Работать с обеих поверхностей одновременно**: беседа и прогресс [subagents](/ru/sub-agents) и [dynamic workflows](/ru/workflows) остаются синхронизированными на всех подключённых устройствах, поэтому вы можете отправлять сообщения из терминала, браузера и телефона взаимозаменяемо. {/* min-version: 2.1.207 */}До версии 2.1.207 сеансы, размещённые на [Desktop app](/ru/desktop), не отправляли прогресс subagents или workflows на подключённые устройства.18* **Работать с обеих поверхностей одновременно**: беседа и прогресс [subagents](/docs/ru/sub-agents) и [dynamic workflows](/docs/ru/workflows) остаются синхронизированными на всех подключённых устройствах, поэтому вы можете отправлять сообщения из терминала, браузера и телефона взаимозаменяемо. До версии 2.1.207 сеансы, размещённые на [Desktop app](/docs/ru/desktop), не отправляли прогресс subagents или workflows на подключённые устройства.

19* **Отправлять изображения и файлы со своего телефона или браузера**: когда вы добавляете вложение в приложение Claude или на claude.ai/code, Claude Code загружает его на ваш компьютер и передаёт его Claude как ссылку на файл `@`, с подписью или без неё. {/* min-version: 2.1.202 */}До версии 2.1.202 Claude Code мог удалить вложение, отправленное без подписи, прежде чем оно достигло сеанса.19* **Отправлять изображения и файлы со своего телефона или браузера**: когда вы добавляете вложение в приложение Claude или на claude.ai/code, Claude Code загружает его на ваш компьютер и передаёт его Claude как ссылку на файл `@`, с подписью или без неё. До версии 2.1.202 Claude Code мог удалить вложение, отправленное без подписи, прежде чем оно достигло сеанса.

20* **Пережить перебои**: если ваш ноутбук перейдёт в режим сна или сетевое соединение разорвётся, сеанс автоматически переподключится, когда ваш компьютер вернётся в сеть. Claude Code ставит в очередь обновления статуса от subagents и workflows во время восстановления соединения и доставляет их после восстановления. {/* min-version: 2.1.207 */}До версии 2.1.207 обновление, отправленное во время переподключения или обновления учётных данных, могло быть потеряно, поэтому подключённое устройство продолжало показывать завершённую задачу как выполняющуюся.20* **Пережить перебои**: если ваш ноутбук перейдёт в режим сна или сетевое соединение разорвётся, сеанс автоматически переподключится, когда ваш компьютер вернётся в сеть. Claude Code ставит в очередь обновления статуса от subagents и workflows во время восстановления соединения и доставляет их после восстановления. До версии 2.1.207 обновление, отправленное во время переподключения или обновления учётных данных, могло быть потеряно, поэтому подключённое устройство продолжало показывать завершённую задачу как выполняющуюся.

21 21 

22В отличие от [Claude Code в веб-версии](/ru/claude-code-on-the-web), которая работает на облачной инфраструктуре, сеансы Remote Control работают непосредственно на вашем компьютере и взаимодействуют с вашей локальной файловой системой. Веб- и мобильные интерфейсы — это просто окно в этот локальный сеанс.22В отличие от [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), которая работает на облачной инфраструктуре, сеансы Remote Control работают непосредственно на вашем компьютере и взаимодействуют с вашей локальной файловой системой. Веб- и мобильные интерфейсы — это просто окно в этот локальный сеанс.

23 23 

24На этой странице рассматриваются настройка, способы запуска и подключения к сеансам, а также сравнение Remote Control с Claude Code в веб-версии.24На этой странице рассматриваются настройка, способы запуска и подключения к сеансам, а также сравнение Remote Control с Claude Code в веб-версии.

25 25 


31 31 

32* **Подписка**: доступна на планах Pro, Max, Team и Enterprise. API ключи не поддерживаются. На планах Team и Enterprise владелец должен сначала включить переключатель Remote Control в [параметрах администратора Claude Code](https://claude.ai/admin-settings/claude-code).32* **Подписка**: доступна на планах Pro, Max, Team и Enterprise. API ключи не поддерживаются. На планах Team и Enterprise владелец должен сначала включить переключатель Remote Control в [параметрах администратора Claude Code](https://claude.ai/admin-settings/claude-code).

33* **Аутентификация**: запустите `claude` и используйте `/login` для входа через claude.ai, если вы ещё этого не сделали.33* **Аутентификация**: запустите `claude` и используйте `/login` для входа через claude.ai, если вы ещё этого не сделали.

34* **Конечная точка API**: недоступна на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, Remote Control также отключен, когда [`ANTHROPIC_BASE_URL`](/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, например на [LLM gateway](/ru/llm-gateway) или прокси. Отключите переменную, чтобы использовать Remote Control.34* **Конечная точка API**: недоступна на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Начиная с версии 2.1.196, Remote Control также отключен, когда [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, например на [LLM gateway](/docs/ru/llm-gateway) или прокси. Отключите переменную, чтобы использовать Remote Control.

35* **Доверие рабочей области**: запустите `claude` в каталоге вашего проекта хотя бы один раз, чтобы принять диалог доверия рабочей области.35* **Доверие рабочей области**: запустите `claude` в каталоге вашего проекта хотя бы один раз, чтобы принять диалог доверия рабочей области.

36 36 

37<h2 id="start-a-remote-control-session">37<h2 id="start-a-remote-control-session">


56 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |56 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

57 | `--name "My Project"` | Установите пользовательское название сеанса, видимое в списке сеансов на claude.ai/code. |57 | `--name "My Project"` | Установите пользовательское название сеанса, видимое в списке сеансов на claude.ai/code. |

58 | `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически сгенерированных названий сеансов, когда явное имя не установлено. По умолчанию используется имя хоста вашего компьютера, создавая названия вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта. |58 | `--remote-control-session-name-prefix <prefix>` | Префикс для автоматически сгенерированных названий сеансов, когда явное имя не установлено. По умолчанию используется имя хоста вашего компьютера, создавая названия вроде `myhost-graceful-unicorn`. Установите `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` для того же эффекта. |

59 | `-c`, `--continue` | {/* min-version: 2.1.200 */}Возобновите самый последний сеанс Remote Control, запущенный из этого каталога, вместо создания нового. Не может быть объединено с `--session-id`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требует Claude Code версии 2.1.200 или позже; более ранние версии отклоняют флаг как неизвестный аргумент. |59 | `-c`, `--continue` | Возобновите самый последний сеанс Remote Control, запущенный из этого каталога, вместо создания нового. Не может быть объединено с `--session-id`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требует Claude Code версии 2.1.200 или позже; более ранние версии отклоняют флаг как неизвестный аргумент. |

60 | `--session-id <id>` | {/* min-version: 2.1.200 */}Возобновите конкретный сеанс Remote Control по его ID. Не может быть объединено с `--continue`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требует Claude Code версии 2.1.200 или позже; более ранние версии отклоняют флаг как неизвестный аргумент. |60 | `--session-id <id>` | Возобновите конкретный сеанс Remote Control по его ID. Не может быть объединено с `--continue`, `--spawn`, `--capacity` или `--create-session-in-dir`. Требует Claude Code версии 2.1.200 или позже; более ранние версии отклоняют флаг как неизвестный аргумент. |

61 | `--spawn <mode>` | Как сервер создаёт сеансы.<br />• `same-dir` (по умолчанию): все сеансы используют текущий рабочий каталог, поэтому они могут конфликтовать при редактировании одних и тех же файлов.<br />• `worktree`: каждый сеанс по требованию получает свой собственный [git worktree](/ru/worktrees). Требует репозитория git.<br />• `session`: режим одного сеанса. Обслуживает ровно один сеанс и отклоняет дополнительные подключения. Устанавливается только при запуске.<br />Нажмите `w` во время выполнения, чтобы переключиться между `same-dir` и `worktree`. |61 | `--spawn <mode>` | Как сервер создаёт сеансы.<br />• `same-dir` (по умолчанию): все сеансы используют текущий рабочий каталог, поэтому они могут конфликтовать при редактировании одних и тех же файлов.<br />• `worktree`: каждый сеанс по требованию получает свой собственный [git worktree](/docs/ru/worktrees). Требует репозитория git.<br />• `session`: режим одного сеанса. Обслуживает ровно один сеанс и отклоняет дополнительные подключения. Устанавливается только при запуске.<br />Нажмите `w` во время выполнения, чтобы переключиться между `same-dir` и `worktree`. |

62 | `--capacity <N>` | Максимальное количество одновременных сеансов. По умолчанию 32. Не может использоваться с `--spawn=session`. |62 | `--capacity <N>` | Максимальное количество одновременных сеансов. По умолчанию 32. Не может использоваться с `--spawn=session`. |

63 | `--[no-]create-session-in-dir` | Предварительно создайте один сеанс в текущем каталоге при запуске сервера, чтобы у вас было место для ввода текста сразу же. В режиме `worktree` этот сеанс остаётся в текущем каталоге, а сеансы по требованию получают изолированные worktrees. Включено по умолчанию; передайте `--no-create-session-in-dir`, чтобы начать без них. |63 | `--[no-]create-session-in-dir` | Предварительно создайте один сеанс в текущем каталоге при запуске сервера, чтобы у вас было место для ввода текста сразу же. В режиме `worktree` этот сеанс остаётся в текущем каталоге, а сеансы по требованию получают изолированные worktrees. Включено по умолчанию; передайте `--no-create-session-in-dir`, чтобы начать без них. |

64 | `--verbose` | Показать подробные журналы подключения и сеанса. |64 | `--verbose` | Показать подробные журналы подключения и сеанса. |

65 | `--sandbox` / `--no-sandbox` | Включить или отключить [sandboxing](/ru/sandboxing) для изоляции файловой системы и сети. Отключено по умолчанию. |65 | `--sandbox` / `--no-sandbox` | Включить или отключить [sandboxing](/docs/ru/sandboxing) для изоляции файловой системы и сети. Отключено по умолчанию. |

66 </Tab>66 </Tab>

67 67 

68 <Tab title="Интерактивный сеанс">68 <Tab title="Интерактивный сеанс">


100 </Tab>100 </Tab>

101 101 

102 <Tab title="VS Code">102 <Tab title="VS Code">

103 В [расширении Claude Code VS Code](/ru/vs-code) введите `/remote-control` или `/rc` в поле подсказки или откройте меню команд с помощью `/` и выберите его.103 В [расширении Claude Code VS Code](/docs/ru/vs-code) введите `/remote-control` или `/rc` в поле подсказки или откройте меню команд с помощью `/` и выберите его.

104 104 

105 ```text theme={null}105 ```text theme={null}

106 /remote-control106 /remote-control


132* **Отсканируйте QR-код**, показанный рядом с URL сеанса, чтобы открыть его непосредственно в приложении Claude. С помощью `claude remote-control` нажмите пробел, чтобы переключить отображение QR-кода.132* **Отсканируйте QR-код**, показанный рядом с URL сеанса, чтобы открыть его непосредственно в приложении Claude. С помощью `claude remote-control` нажмите пробел, чтобы переключить отображение QR-кода.

133* **Откройте [claude.ai/code](https://claude.ai/code) или приложение Claude** и найдите сеанс по имени в списке сеансов. В мобильном приложении Claude нажмите **Code** в навигации, чтобы перейти к списку сеансов. Сеансы Remote Control показывают значок компьютера с зелёной точкой статуса при подключении.133* **Откройте [claude.ai/code](https://claude.ai/code) или приложение Claude** и найдите сеанс по имени в списке сеансов. В мобильном приложении Claude нажмите **Code** в навигации, чтобы перейти к списку сеансов. Сеансы Remote Control показывают значок компьютера с зелёной точкой статуса при подключении.

134 134 

135Когда вы подключаетесь, устройство показывает любых подагентов и рабочие процессы, которые сеанс уже имеет, работающие в фоновом режиме. {/* min-version: 2.1.208 */}До версии 2.1.208 устройство, подключающееся к сеансу, размещённому в интерактивном терминале, не показывало подагентов и рабочие процессы, которые уже были запущены, пока один из них не запустился или не остановился.135Когда вы подключаетесь, устройство показывает любых подагентов и рабочие процессы, которые сеанс уже имеет, работающие в фоновом режиме. До версии 2.1.208 устройство, подключающееся к сеансу, размещённому в интерактивном терминале, не показывало подагентов и рабочие процессы, которые уже были запущены, пока один из них не запустился или не остановился.

136 136 

137Название удалённого сеанса выбирается в следующем порядке:137Название удалённого сеанса выбирается в следующем порядке:

138 138 


1413. Последнее значимое сообщение в существующей истории беседы1413. Последнее значимое сообщение в существующей истории беседы

1424. Автоматически сгенерированное имя вроде `myhost-graceful-unicorn`, где `myhost` — это имя хоста вашего компьютера или префикс, который вы установили с помощью `--remote-control-session-name-prefix`1424. Автоматически сгенерированное имя вроде `myhost-graceful-unicorn`, где `myhost` — это имя хоста вашего компьютера или префикс, который вы установили с помощью `--remote-control-session-name-prefix`

143 143 

144Если вы не установили явное имя, название обновляется, чтобы отразить вашу подсказку после её отправки. {/* min-version: 2.1.176 */}Начиная с Claude Code версии 2.1.176, автоматически сгенерированные названия соответствуют языку вашей беседы или параметру [`language`](/ru/settings#available-settings), если он настроен. Переименование сеанса из claude.ai или приложения Claude также обновляет локальное название, показанное в `claude --resume`.144Если вы не установили явное имя, название обновляется, чтобы отразить вашу подсказку после её отправки. Начиная с Claude Code версии 2.1.176, автоматически сгенерированные названия соответствуют языку вашей беседы или параметру [`language`](/docs/ru/settings#available-settings), если он настроен. Переименование сеанса из claude.ai или приложения Claude также обновляет локальное название, показанное в `claude --resume`.

145 145 

146Если в среде уже есть активный сеанс, вас спросят, продолжить ли его или начать новый.146Если в среде уже есть активный сеанс, вас спросят, продолжить ли его или начать новый.

147 147 


151 Включение Remote Control для всех сеансов151 Включение Remote Control для всех сеансов

152</h3>152</h3>

153 153 

154Remote Control активируется только при явном запуске `claude remote-control`, `claude --remote-control` или `/remote-control`, если не включена автоподключение. Чтобы включить его автоматически для каждого интерактивного сеанса, запустите `/config` внутри Claude Code и установите **Enable Remote Control for all sessions** на `true`. Установите на `false`, чтобы никогда не автоподключаться, или оставьте без установки, чтобы следовать стандартному значению вашей организации. В приложении Desktop вы также можете переключить это в **Settings → Claude Code → Enable remote control by default**. {/* min-version: 2.1.203 */}В [расширении VS Code](/ru/vs-code#use-the-prompt-box) тот же переключатель появляется как **Enable Remote Control for all sessions** в разделе Settings меню команд; требует Claude Code версии 2.1.203 или позже.154Remote Control активируется только при явном запуске `claude remote-control`, `claude --remote-control` или `/remote-control`, если не включена автоподключение. Чтобы включить его автоматически для каждого интерактивного сеанса, запустите `/config` внутри Claude Code и установите **Enable Remote Control for all sessions** на `true`. Установите на `false`, чтобы никогда не автоподключаться, или оставьте без установки, чтобы следовать стандартному значению вашей организации. В приложении Desktop вы также можете переключить это в **Settings → Claude Code → Enable remote control by default**. В [расширении VS Code](/docs/ru/vs-code#use-the-prompt-box) тот же переключатель появляется как **Enable Remote Control for all sessions** в разделе Settings меню команд; требует Claude Code версии 2.1.203 или позже.

155 155 

156С этой настройкой каждый интерактивный процесс Claude Code регистрирует один удалённый сеанс. Если вы запустите несколько экземпляров, каждый получит свою собственную среду и сеанс. Чтобы запустить несколько одновременных сеансов из одного процесса, используйте [режим сервера](#start-a-remote-control-session) вместо этого.156С этой настройкой каждый интерактивный процесс Claude Code регистрирует один удалённый сеанс. Если вы запустите несколько экземпляров, каждый получит свою собственную среду и сеанс. Чтобы запустить несколько одновременных сеансов из одного процесса, используйте [режим сервера](#start-a-remote-control-session) вместо этого.

157 157 


163 163 

164Весь трафик проходит через API Anthropic через TLS, тот же транспортный протокол безопасности, что и любой сеанс Claude Code. Соединение использует несколько краткосрочных учётных данных, каждое из которых ограничено одной целью и истекает независимо.164Весь трафик проходит через API Anthropic через TLS, тот же транспортный протокол безопасности, что и любой сеанс Claude Code. Соединение использует несколько краткосрочных учётных данных, каждое из которых ограничено одной целью и истекает независимо.

165 165 

166Пока Remote Control подключен, стенограмма сеанса, включая ваши сообщения, ответы Claude и активность инструментов, хранится на серверах Anthropic. Сохраненная стенограмма синхронизирует беседу на всех ваших устройствах и позволяет сеансу переподключиться после разрыва сети. Выполнение и доступ к файловой системе остаются на вашем компьютере, а сохраненные стенограммы хранятся в соответствии с политикой [Использование данных](/ru/data-usage).166Пока Remote Control подключен, стенограмма сеанса, включая ваши сообщения, ответы Claude и активность инструментов, хранится на серверах Anthropic. Сохраненная стенограмма синхронизирует беседу на всех ваших устройствах и позволяет сеансу переподключиться после разрыва сети. Выполнение и доступ к файловой системе остаются на вашем компьютере, а сохраненные стенограммы хранятся в соответствии с политикой [Использование данных](/docs/ru/data-usage).

167 167 

168Чтобы полностью отключить Remote Control, используйте параметр [`disableRemoteControl`](/ru/settings#available-settings). Организации с требованиями соответствия, такими как Zero Data Retention, не могут включить Remote Control.168Чтобы полностью отключить Remote Control, используйте параметр [`disableRemoteControl`](/docs/ru/settings#available-settings). Организации с требованиями соответствия, такими как Zero Data Retention, не могут включить Remote Control.

169 169 

170<h2 id="trusted-devices">170<h2 id="trusted-devices">

171 Доверенные устройства171 Доверенные устройства


234 Remote Control в сравнении с Claude Code в веб-версии234 Remote Control в сравнении с Claude Code в веб-версии

235</h2>235</h2>

236 236 

237Remote Control и [Claude Code в веб-версии](/ru/claude-code-on-the-web) оба используют интерфейс claude.ai/code. Ключевое различие заключается в том, где работает сеанс: Remote Control выполняется на вашем компьютере, поэтому ваши локальные MCP servers, инструменты и конфигурация проекта остаются доступными. Claude Code в веб-версии выполняется в управляемой Anthropic облачной инфраструктуре.237Remote Control и [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) оба используют интерфейс claude.ai/code. Ключевое различие заключается в том, где работает сеанс: Remote Control выполняется на вашем компьютере, поэтому ваши локальные MCP servers, инструменты и конфигурация проекта остаются доступными. Claude Code в веб-версии выполняется в управляемой Anthropic облачной инфраструктуре.

238 238 

239Используйте Remote Control, когда вы находитесь в процессе локальной работы и хотите продолжить с другого устройства. Используйте Claude Code в веб-версии, когда вы хотите начать задачу без какой-либо локальной настройки, работать с репозиторием, который у вас не клонирован, или запустить несколько задач параллельно.239Используйте Remote Control, когда вы находитесь в процессе локальной работы и хотите продолжить с другого устройства. Используйте Claude Code в веб-версии, когда вы хотите начать задачу без какой-либо локальной настройки, работать с репозиторием, который у вас не клонирован, или запустить несколько задач параллельно.

240 240 


272* На iOS режимы Focus и сводки уведомлений могут подавлять или задерживать push-уведомления. Проверьте Settings → Notifications → Claude.272* На iOS режимы Focus и сводки уведомлений могут подавлять или задерживать push-уведомления. Проверьте Settings → Notifications → Claude.

273* На Android агрессивная оптимизация батареи может задержать доставку. Исключите приложение Claude из оптимизации батареи в системных параметрах.273* На Android агрессивная оптимизация батареи может задержать доставку. Исключите приложение Claude из оптимизации батареи в системных параметрах.

274 274 

275Claude Code пропускает мобильные push-уведомления, пока вы печатаете или сосредоточены на подключённом терминале. {/* min-version: 2.1.181 */}Начиная с версии v2.1.181, вы можете установить [`CLAUDE_CLIENT_PRESENCE_FILE`](/ru/env-vars) на путь файла-маркера, чтобы расширить это на любое время, когда вы находитесь у машины, даже в другом окне: уведомления пропускаются, пока файл существует. Настройте прослушиватель блокировки экрана или аналогичный инструмент для создания файла при разблокировке экрана и удаления его при блокировке экрана.275Claude Code пропускает мобильные push-уведомления, пока вы печатаете или сосредоточены на подключённом терминале. Начиная с версии v2.1.181, вы можете установить [`CLAUDE_CLIENT_PRESENCE_FILE`](/docs/ru/env-vars) на путь файла-маркера, чтобы расширить это на любое время, когда вы находитесь у машины, даже в другом окне: уведомления пропускаются, пока файл существует. Настройте прослушиватель блокировки экрана или аналогичный инструмент для создания файла при разблокировке экрана и удаления его при блокировке экрана.

276 276 

277<h2 id="limitations">277<h2 id="limitations">

278 Ограничения278 Ограничения


281* **Один удалённый сеанс на интерактивный процесс**: вне режима сервера каждый экземпляр Claude Code поддерживает один удалённый сеанс одновременно. Используйте [режим сервера](#start-a-remote-control-session) для запуска нескольких одновременных сеансов из одного процесса.281* **Один удалённый сеанс на интерактивный процесс**: вне режима сервера каждый экземпляр Claude Code поддерживает один удалённый сеанс одновременно. Используйте [режим сервера](#start-a-remote-control-session) для запуска нескольких одновременных сеансов из одного процесса.

282* **Локальный процесс должен продолжать работать**: Remote Control работает как локальный процесс. Если вы закроете терминал, выйдете из VS Code или иным образом остановите процесс `claude`, сеанс завершится.282* **Локальный процесс должен продолжать работать**: Remote Control работает как локальный процесс. Если вы закроете терминал, выйдете из VS Code или иным образом остановите процесс `claude`, сеанс завершится.

283* **Продолжительный сбой сети**: если ваш компьютер включен, но не может достичь сеть более чем примерно на 10 минут, сеанс истекает и процесс завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.283* **Продолжительный сбой сети**: если ваш компьютер включен, но не может достичь сеть более чем примерно на 10 минут, сеанс истекает и процесс завершается. Запустите `claude remote-control` снова, чтобы начать новый сеанс.

284* **Ultraplan отключает Remote Control**: запуск сеанса [ultraplan](/ru/ultraplan) отключает любой активный сеанс Remote Control, потому что обе функции занимают интерфейс claude.ai/code и одновременно может быть подключена только одна.284* **Ultraplan отключает Remote Control**: запуск сеанса [ultraplan](/docs/ru/ultraplan) отключает любой активный сеанс Remote Control, потому что обе функции занимают интерфейс claude.ai/code и одновременно может быть подключена только одна.

285* **Некоторые команды работают только локально**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, работают только из локального CLI, независимо от того, передаёте ли вы аргумент или нет. Следующие команды работают с мобильных устройств и веб-браузеров:285* **Некоторые команды работают только локально**: команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, работают только из локального CLI, независимо от того, передаёте ли вы аргумент или нет. Следующие команды работают с мобильных устройств и веб-браузеров:

286 * Команды с текстовым выводом: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits` (запускает текстовую форму вместо открытия диалога в CLI), `/recap`, `/reload-plugins`286 * Команды с текстовым выводом: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits` (запускает текстовую форму вместо открытия диалога в CLI), `/recap`, `/reload-plugins`

287 * `/model`, `/effort`, `/fast`, `/color` и `/rename`: передайте значение как аргумент, например `/model sonnet` или `/effort high`. С мобильных устройств и веб-браузеров `/model` и `/effort` принимают аргумент вместо выбора в терминале или ползунка.287 * `/model`, `/effort`, `/fast`, `/color` и `/rename`: передайте значение как аргумент, например `/model sonnet` или `/effort high`. С мобильных устройств и веб-браузеров `/model` и `/effort` принимают аргумент вместо выбора в терминале или ползунка.

288 * {/* min-version: 2.1.166 */}`/mcp`, начиная с версии 2.1.166: с мобильного приложения возвращает текстовое резюме статуса сервера вместо открытия выбора. В веб-версии `/mcp` без аргументов открывает каталог [соединителей claude.ai](/ru/mcp#use-mcp-servers-from-claude-ai) вместо возврата резюме. Подкоманды `reconnect`, `enable` и `disable` [](/ru/commands#all-commands) работают с обеих версий. В отличие от локального CLI, `/mcp reconnect` без имени сервера переподключает каждый сервер, который не работает или требует аутентификации.288 * `/mcp`, начиная с версии 2.1.166: с мобильного приложения возвращает текстовое резюме статуса сервера вместо открытия выбора. В веб-версии `/mcp` без аргументов открывает каталог [соединителей claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) вместо возврата резюме. Подкоманды `reconnect`, `enable` и `disable` [](/docs/ru/commands#all-commands) работают с обеих версий. В отличие от локального CLI, `/mcp reconnect` без имени сервера переподключает каждый сервер, который не работает или требует аутентификации.

289 * {/* min-version: 2.1.181 */}`/config`, начиная с версии 2.1.181: с мобильного приложения передайте `key=value` для установки параметра или запустите её без аргументов, чтобы вывести список ключей, которые вы можете установить. В веб-версии `/config` открывает раздел Claude Code ваших параметров и игнорирует текст после команды.289 * `/config`, начиная с версии 2.1.181: с мобильного приложения передайте `key=value` для установки параметра или запустите её без аргументов, чтобы вывести список ключей, которые вы можете установить. В веб-версии `/config` открывает раздел Claude Code ваших параметров и игнорирует текст после команды.

290 290 

291<h2 id="troubleshooting">291<h2 id="troubleshooting">

292 Устранение неполадок292 Устранение неполадок


298 298 

299Вы не аутентифицированы с помощью учётной записи claude.ai. Запустите `claude auth login` и выберите опцию claude.ai. Если в вашей среде установлена переменная `ANTHROPIC_API_KEY`, отключите её сначала.299Вы не аутентифицированы с помощью учётной записи claude.ai. Запустите `claude auth login` и выберите опцию claude.ai. Если в вашей среде установлена переменная `ANTHROPIC_API_KEY`, отключите её сначала.

300 300 

301{/* min-version: 2.1.206 */}До версии 2.1.206 запуск `/remote-control` при выходе из системы сообщал `Unknown command: /remote-control` вместо этого сообщения.301До версии 2.1.206 запуск `/remote-control` при выходе из системы сообщал `Unknown command: /remote-control` вместо этого сообщения.

302 302 

303<h3 id="remote-control-requires-a-full-scope-login-token">303<h3 id="remote-control-requires-a-full-scope-login-token">

304 "Remote Control requires a full-scope login token"304 "Remote Control requires a full-scope login token"


328 "Remote Control is only available when using Claude via api.anthropic.com"328 "Remote Control is only available when using Claude via api.anthropic.com"

329</h3>329</h3>

330 330 

331Сеанс не взаимодействует с API Anthropic напрямую, поэтому нет бэкенда claude.ai для сопряжения. Это происходит на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с v2.1.196 это также происходит, когда [`ANTHROPIC_BASE_URL`](/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/ru/llm-gateway) или прокси, даже если вы входите с помощью claude.ai. Отключите `ANTHROPIC_BASE_URL` и перезагрузите сеанс для использования Remote Control.331Сеанс не взаимодействует с API Anthropic напрямую, поэтому нет бэкенда claude.ai для сопряжения. Это происходит на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Начиная с v2.1.196 это также происходит, когда [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/docs/ru/llm-gateway) или прокси, даже если вы входите с помощью claude.ai. Отключите `ANTHROPIC_BASE_URL` и перезагрузите сеанс для использования Remote Control.

332 332 

333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

334 "Remote Control is disabled by your organization's policy"334 "Remote Control is disabled by your organization's policy"


339* **Вы аутентифицированы с помощью API ключа или учётной записи Console**: Remote Control требует OAuth claude.ai. Запустите `/login` и выберите опцию claude.ai. Если в вашей среде установлена переменная `ANTHROPIC_API_KEY`, отключите её.339* **Вы аутентифицированы с помощью API ключа или учётной записи Console**: Remote Control требует OAuth claude.ai. Запустите `/login` и выберите опцию claude.ai. Если в вашей среде установлена переменная `ANTHROPIC_API_KEY`, отключите её.

340* **Администратор не включил это для вашей организации**: Remote Control отключен по умолчанию на планах Team и Enterprise. Администратор может включить его на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code), включив переключатель **Remote Control**. Этот переключатель является параметром организации на стороне сервера.340* **Администратор не включил это для вашей организации**: Remote Control отключен по умолчанию на планах Team и Enterprise. Администратор может включить его на [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code), включив переключатель **Remote Control**. Этот переключатель является параметром организации на стороне сервера.

341* **Переключатель администратора неактивен**: ваша организация имеет конфигурацию хранения данных или соответствия, которая несовместима с Remote Control. Это не может быть изменено из панели администратора. Свяжитесь с поддержкой Anthropic для обсуждения вариантов.341* **Переключатель администратора неактивен**: ваша организация имеет конфигурацию хранения данных или соответствия, которая несовместима с Remote Control. Это не может быть изменено из панели администратора. Свяжитесь с поддержкой Anthropic для обсуждения вариантов.

342* **Ошибка упоминает `disableRemoteControl`**: ваш IT администратор отключил Remote Control на этом устройстве через [управляемые параметры](/ru/settings#settings-files), независимо от переключателя на уровне организации.342* **Ошибка упоминает `disableRemoteControl`**: ваш IT администратор отключил Remote Control на этом устройстве через [управляемые параметры](/docs/ru/settings#settings-files), независимо от переключателя на уровне организации.

343 343 

344<h3 id="remote-credentials-fetch-failed">344<h3 id="remote-credentials-fetch-failed">

345 "Remote credentials fetch failed"345 "Remote credentials fetch failed"


365 365 

366Ваш локальный сеанс продолжает работать без Remote Control. Запустите `/remote-control` для повторной попытки подключения, или запустите Claude Code без `--resume` для создания нового сеанса Remote Control.366Ваш локальный сеанс продолжает работать без Remote Control. Запустите `/remote-control` для повторной попытки подключения, или запустите Claude Code без `--resume` для создания нового сеанса Remote Control.

367 367 

368{/* min-version: 2.1.200 */}До v2.1.200 ошибка переподключения создавала новый сеанс Remote Control вместо отображения этого сообщения, что оставляло дополнительные сеансы в списке сеансов на claude.ai/code.368До v2.1.200 ошибка переподключения создавала новый сеанс Remote Control вместо отображения этого сообщения, что оставляло дополнительные сеансы в списке сеансов на claude.ai/code.

369 369 

370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

371 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"371 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"


387 387 

388| | Trigger | Claude runs on | Setup | Best for |388| | Trigger | Claude runs on | Setup | Best for |

389| :--------------------------------------------- | :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ |389| :--------------------------------------------- | :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ |

390| [Dispatch](/en/desktop#sessions-from-dispatch) | Message a task from the Claude mobile app | Your machine (Desktop) | [Pair the mobile app with Desktop](https://support.claude.com/en/articles/13947068) | Delegating work while you're away, minimal setup |390| [Dispatch](/docs/en/desktop#sessions-from-dispatch) | Message a task from the Claude mobile app | Your machine (Desktop) | [Pair the mobile app with Desktop](https://support.claude.com/en/articles/13947068) | Delegating work while you're away, minimal setup |

391| [Remote Control](/en/remote-control) | Drive a running session from [claude.ai/code](https://claude.ai/code) or the Claude mobile app | Your machine (CLI or VS Code) | Run `claude remote-control` | Steering in-progress work from another device |391| [Remote Control](/docs/en/remote-control) | Drive a running session from [claude.ai/code](https://claude.ai/code) or the Claude mobile app | Your machine (CLI or VS Code) | Run `claude remote-control` | Steering in-progress work from another device |

392| [Channels](/en/channels) | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | [Install a channel plugin](/en/channels#quickstart) or [build your own](/en/channels-reference) | Reacting to external events like CI failures or chat messages |392| [Channels](/docs/en/channels) | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | [Install a channel plugin](/docs/en/channels#quickstart) or [build your own](/docs/en/channels-reference) | Reacting to external events like CI failures or chat messages |

393| [Slack](/en/slack) | Mention `@Claude` in a team channel | Anthropic cloud | [Install the Slack app](/en/slack#setting-up-claude-code-in-slack) with [Claude Code on the web](/en/claude-code-on-the-web) enabled | PRs and reviews from team chat |393| [Slack](/docs/en/slack) | Mention `@Claude` in a team channel | Anthropic cloud | [Install the Slack app](/docs/en/slack#setting-up-claude-code-in-slack) with [Claude Code on the web](/docs/en/claude-code-on-the-web) enabled | PRs and reviews from team chat |

394| [Scheduled tasks](/en/scheduled-tasks) | Set a schedule | [CLI](/en/scheduled-tasks), [Desktop](/en/desktop-scheduled-tasks), or [cloud](/en/routines) | Pick a frequency | Recurring automation like daily reviews |394| [Scheduled tasks](/docs/en/scheduled-tasks) | Set a schedule | [CLI](/docs/en/scheduled-tasks), [Desktop](/docs/en/desktop-scheduled-tasks), or [cloud](/docs/en/routines) | Pick a frequency | Recurring automation like daily reviews |

395 395 

396<h2 id="related-resources">396<h2 id="related-resources">

397 Связанные ресурсы397 Связанные ресурсы

398</h2>398</h2>

399 399 

400* [Claude Code в веб-версии](/ru/claude-code-on-the-web): запускайте сеансы в управляемых Anthropic облачных средах вместо вашего компьютера400* [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web): запускайте сеансы в управляемых Anthropic облачных средах вместо вашего компьютера

401* [Ultraplan](/ru/ultraplan): запустите сеанс облачного планирования из вашего терминала и просмотрите план в вашем браузере401* [Ultraplan](/docs/ru/ultraplan): запустите сеанс облачного планирования из вашего терминала и просмотрите план в вашем браузере

402* [Channels](/ru/channels): перенаправьте Telegram, Discord или iMessage в сеанс, чтобы Claude реагировал на сообщения, пока вас нет402* [Channels](/docs/ru/channels): перенаправьте Telegram, Discord или iMessage в сеанс, чтобы Claude реагировал на сообщения, пока вас нет

403* [Dispatch](/ru/desktop#sessions-from-dispatch): отправьте задачу со своего телефона, и она может создать сеанс Desktop для её обработки403* [Dispatch](/docs/ru/desktop#sessions-from-dispatch): отправьте задачу со своего телефона, и она может создать сеанс Desktop для её обработки

404* [Аутентификация](/ru/authentication): настройте `/login` и управляйте учётными данными для claude.ai404* [Аутентификация](/docs/ru/authentication): настройте `/login` и управляйте учётными данными для claude.ai

405* [Справочник CLI](/ru/cli-reference): полный список флагов и команд, включая `claude remote-control`405* [Справочник CLI](/docs/ru/cli-reference): полный список флагов и команд, включая `claude remote-control`

406* [Безопасность](/ru/security): как сеансы Remote Control вписываются в модель безопасности Claude Code406* [Безопасность](/docs/ru/security): как сеансы Remote Control вписываются в модель безопасности Claude Code

407* [Использование данных](/ru/data-usage): какие данные проходят через API Anthropic во время локальных и удалённых сеансов407* [Использование данных](/docs/ru/data-usage): какие данные проходят через API Anthropic во время локальных и удалённых сеансов

sandboxing.md +44 −44

Details

9Bash sandbox позволяет Claude выполнять большинство команд оболочки без остановки для запроса разрешения. Вместо одобрения каждой команды вы определяете, какие файлы и сетевые домены могут использовать команды, и операционная система применяет эту границу для каждой команды Bash и её дочерних процессов.9Bash sandbox позволяет Claude выполнять большинство команд оболочки без остановки для запроса разрешения. Вместо одобрения каждой команды вы определяете, какие файлы и сетевые домены могут использовать команды, и операционная система применяет эту границу для каждой команды Bash и её дочерних процессов.

10 10 

11<Note>11<Note>

12 Для сравнения других подходов к изоляции, таких как dev containers, пользовательские контейнеры и виртуальные машины, см. [Sandbox environments](/ru/sandbox-environments). Чтобы уменьшить количество запросов разрешений для инструментов, отличных от Bash, см. [permission modes](/ru/permission-modes).12 Для сравнения других подходов к изоляции, таких как dev containers, пользовательские контейнеры и виртуальные машины, см. [Sandbox environments](/docs/ru/sandbox-environments). Чтобы уменьшить количество запросов разрешений для инструментов, отличных от Bash, см. [permission modes](/docs/ru/permission-modes).

13</Note>13</Note>

14 14 

15<h2 id="get-started">15<h2 id="get-started">


31 Это открывает панель sandbox с тремя вкладками:31 Это открывает панель sandbox с тремя вкладками:

32 32 

33 * **Mode**: выберите способ одобрения изолированных команд, описанный на следующем шаге33 * **Mode**: выберите способ одобрения изолированных команд, описанный на следующем шаге

34 * **Overrides**: выберите, могут ли команды, которые не работают в sandbox, вернуться к выполнению без изоляции. Это параметр [`allowUnsandboxedCommands`](/ru/settings#sandbox-settings)34 * **Overrides**: выберите, могут ли команды, которые не работают в sandbox, вернуться к выполнению без изоляции. Это параметр [`allowUnsandboxedCommands`](/docs/ru/settings#sandbox-settings)

35 * **Config**: просмотрите разрешённые параметры sandbox35 * **Config**: просмотрите разрешённые параметры sandbox

36 36 

37 Если панель показывает только вкладку Dependencies, отсутствует требуемый пакет. Установите его, как описано в разделе [Настройка Linux и WSL2](#set-up-linux-and-wsl2), перезагрузите Claude Code и снова выполните `/sandbox`.37 Если панель показывает только вкладку Dependencies, отсутствует требуемый пакет. Установите его, как описано в разделе [Настройка Linux и WSL2](#set-up-linux-and-wsl2), перезагрузите Claude Code и снова выполните `/sandbox`.


48 </Step>48 </Step>

49</Steps>49</Steps>

50 50 

51Выбор режима на панели записывает в локальные параметры вашего проекта в `.claude/settings.local.json`, которые применяются к текущему проекту и не проверяются в git. Чтобы включить sandbox во всех ваших проектах, установите [`sandbox.enabled`](/ru/settings#sandbox-settings) в `true` в ваших пользовательских параметрах в `~/.claude/settings.json`. Чтобы применить sandboxing для каждого разработчика в организации, используйте [управляемые параметры](#enforce-sandboxing-with-managed-settings).51Выбор режима на панели записывает в локальные параметры вашего проекта в `.claude/settings.local.json`, которые применяются к текущему проекту и не проверяются в git. Чтобы включить sandbox во всех ваших проектах, установите [`sandbox.enabled`](/docs/ru/settings#sandbox-settings) в `true` в ваших пользовательских параметрах в `~/.claude/settings.json`. Чтобы применить sandboxing для каждого разработчика в организации, используйте [управляемые параметры](#enforce-sandboxing-with-managed-settings).

52 52 

53<Warning>53<Warning>

54 По умолчанию, если sandbox не может запуститься из-за отсутствия зависимостей или неподдерживаемой платформы, Claude Code показывает предупреждение и выполняет команды без sandboxing. Чтобы сделать это жёстким отказом, установите [`sandbox.failIfUnavailable`](/ru/settings#sandbox-settings) в `true`. Это предназначено для управляемых развёртываний, которые требуют sandboxing в качестве шлюза безопасности.54 По умолчанию, если sandbox не может запуститься из-за отсутствия зависимостей или неподдерживаемой платформы, Claude Code показывает предупреждение и выполняет команды без sandboxing. Чтобы сделать это жёстким отказом, установите [`sandbox.failIfUnavailable`](/docs/ru/settings#sandbox-settings) в `true`. Это предназначено для управляемых развёртываний, которые требуют sandboxing в качестве шлюза безопасности.

55</Warning>55</Warning>

56 56 

57<h3 id="set-up-linux-and-wsl2">57<h3 id="set-up-linux-and-wsl2">


111 <Accordion title="Примечания WSL2">111 <Accordion title="Примечания WSL2">

112 Проверьте версию WSL с помощью `wsl -l -v` из PowerShell. Если вы видите `Sandboxing requires WSL2`, ваш дистрибьютив работает на WSL1. Обновите его на WSL2 или запустите Claude Code без sandboxing.112 Проверьте версию WSL с помощью `wsl -l -v` из PowerShell. Если вы видите `Sandboxing requires WSL2`, ваш дистрибьютив работает на WSL1. Обновите его на WSL2 или запустите Claude Code без sandboxing.

113 113 

114 На WSL2 изолированные команды не могут запускать двоичные файлы Windows, такие как `cmd.exe`, `powershell.exe` или что-либо под `/mnt/c/`. WSL передаёт их хосту Windows через Unix socket, который sandbox блокирует. Если команде требуется вызвать двоичный файл Windows, добавьте его в [`excludedCommands`](/ru/settings#sandbox-settings), чтобы он выполнялся вне sandbox.114 На WSL2 изолированные команды не могут запускать двоичные файлы Windows, такие как `cmd.exe`, `powershell.exe` или что-либо под `/mnt/c/`. WSL передаёт их хосту Windows через Unix socket, который sandbox блокирует. Если команде требуется вызвать двоичный файл Windows, добавьте его в [`excludedCommands`](/docs/ru/settings#sandbox-settings), чтобы он выполнялся вне sandbox.

115 </Accordion>115 </Accordion>

116</AccordionGroup>116</AccordionGroup>

117 117 


121 121 

122Claude Code предлагает два режима sandbox:122Claude Code предлагает два режима sandbox:

123 123 

124**Режим автоматического разрешения**: Команды Bash будут пытаться выполняться внутри sandbox и автоматически разрешаются без требования разрешения. Команды, которые не могут быть изолированы, такие как те, которые требуют сетевого доступа к неразрешённым хостам, возвращаются к обычному потоку разрешений, где Claude Code проверяет ваши [правила разрешений](/ru/permissions) и запрашивает у вас разрешение для любой команды, которую эти правила не разрешают, с запросом в режиме по умолчанию или классификатором в [режиме auto](/ru/permission-modes#eliminate-prompts-with-auto-mode).124**Режим автоматического разрешения**: Команды Bash будут пытаться выполняться внутри sandbox и автоматически разрешаются без требования разрешения. Команды, которые не могут быть изолированы, такие как те, которые требуют сетевого доступа к неразрешённым хостам, возвращаются к обычному потоку разрешений, где Claude Code проверяет ваши [правила разрешений](/docs/ru/permissions) и запрашивает у вас разрешение для любой команды, которую эти правила не разрешают, с запросом в режиме по умолчанию или классификатором в [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode).

125 125 

126Даже в режиме автоматического разрешения применяется следующее:126Даже в режиме автоматического разрешения применяется следующее:

127 127 

128* Явные [правила отказа](/ru/permissions) всегда соблюдаются128* Явные [правила отказа](/docs/ru/permissions) всегда соблюдаются

129* Команды `rm` или `rmdir`, которые нацелены на `/`, ваш домашний каталог или другие критические пути системы, по-прежнему вызывают запрос разрешения129* Команды `rm` или `rmdir`, которые нацелены на `/`, ваш домашний каталог или другие критические пути системы, по-прежнему вызывают запрос разрешения

130* [Правила ask](/ru/permissions) с областью действия контента, такие как `Bash(git push *)`, по-прежнему требуют запроса даже для изолированных команд130* [Правила ask](/docs/ru/permissions) с областью действия контента, такие как `Bash(git push *)`, по-прежнему требуют запроса даже для изолированных команд

131* Простое правило `Bash` ask, или эквивалентная форма `Bash(*)`, пропускается для команд, которые выполняются в изолированном режиме; оно по-прежнему применяется к командам, которые возвращаются к обычному потоку разрешений131* Простое правило `Bash` ask, или эквивалентная форма `Bash(*)`, пропускается для команд, которые выполняются в изолированном режиме; оно по-прежнему применяется к командам, которые возвращаются к обычному потоку разрешений

132 132 

133**Режим обычных разрешений**: Все команды Bash проходят через обычный поток разрешений, даже когда они изолированы. Это обеспечивает больше контроля, но требует больше одобрений.133**Режим обычных разрешений**: Все команды Bash проходят через обычный поток разрешений, даже когда они изолированы. Это обеспечивает больше контроля, но требует больше одобрений.


136 136 

137Каталог временных файлов сеанса доступен для записи внутри sandbox по умолчанию, наряду с рабочим каталогом. Claude Code устанавливает `$TMPDIR` в этот каталог для изолированных команд, поэтому инструменты, которые записывают временные файлы, работают без дополнительной конфигурации. Неизолированные команды наследуют `$TMPDIR` вашей оболочки без изменений, что означает, что изолированные и неизолированные команды разрешают `$TMPDIR` в разные каталоги. Чтобы передавать временные файлы между ними, записывайте их в рабочий каталог вместо этого.137Каталог временных файлов сеанса доступен для записи внутри sandbox по умолчанию, наряду с рабочим каталогом. Claude Code устанавливает `$TMPDIR` в этот каталог для изолированных команд, поэтому инструменты, которые записывают временные файлы, работают без дополнительной конфигурации. Неизолированные команды наследуют `$TMPDIR` вашей оболочки без изменений, что означает, что изолированные и неизолированные команды разрешают `$TMPDIR` в разные каталоги. Чтобы передавать временные файлы между ними, записывайте их в рабочий каталог вместо этого.

138 138 

139Некоторые команды вообще не могут выполняться внутри sandbox, такие как инструменты, несовместимые с ним, или те, которые требуют хоста, который вы не разрешили. Вместо того чтобы не выполнить задачу или потребовать отключения sandboxing, Claude Code включает механизм выхода: когда команда не выполняется из-за ограничений sandbox, Claude анализирует сбой и может повторить команду с параметром `dangerouslyDisableSandbox`. Повторная команда выполняется вне sandbox, поэтому она проходит через обычный поток разрешений: в режиме по умолчанию вы получаете запрос подтверждения; в [режиме auto](/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор оценивает базовую команду вместо того, чтобы запрашивать у вас разрешение. Чтобы получить запрос на каждый неизолированный повтор даже в режиме auto, добавьте [правило ask](/ru/permissions#match-by-input-parameter) для `Bash(dangerouslyDisableSandbox:true)`.139Некоторые команды вообще не могут выполняться внутри sandbox, такие как инструменты, несовместимые с ним, или те, которые требуют хоста, который вы не разрешили. Вместо того чтобы не выполнить задачу или потребовать отключения sandboxing, Claude Code включает механизм выхода: когда команда не выполняется из-за ограничений sandbox, Claude анализирует сбой и может повторить команду с параметром `dangerouslyDisableSandbox`. Повторная команда выполняется вне sandbox, поэтому она проходит через обычный поток разрешений: в режиме по умолчанию вы получаете запрос подтверждения; в [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатор оценивает базовую команду вместо того, чтобы запрашивать у вас разрешение. Чтобы получить запрос на каждый неизолированный повтор даже в режиме auto, добавьте [правило ask](/docs/ru/permissions#match-by-input-parameter) для `Bash(dangerouslyDisableSandbox:true)`.

140 140 

141Вы можете отключить этот механизм выхода, установив `"allowUnsandboxedCommands": false` в ваши [параметры sandbox](/ru/settings#sandbox-settings). При отключении, что панель Overrides в `/sandbox` показывает как **Strict sandbox mode**, параметр `dangerouslyDisableSandbox` полностью игнорируется и все команды должны выполняться в sandbox или быть явно указаны в `excludedCommands`.141Вы можете отключить этот механизм выхода, установив `"allowUnsandboxedCommands": false` в ваши [параметры sandbox](/docs/ru/settings#sandbox-settings). При отключении, что панель Overrides в `/sandbox` показывает как **Strict sandbox mode**, параметр `dangerouslyDisableSandbox` полностью игнорируется и все команды должны выполняться в sandbox или быть явно указаны в `excludedCommands`.

142 142 

143<Info>143<Info>

144 Режим автоматического разрешения работает независимо от вашего параметра режима разрешений. Даже если вы не находитесь в режиме "принять правки", изолированные команды Bash будут выполняться автоматически при включении автоматического разрешения. Это означает, что команды Bash, которые изменяют файлы в границах sandbox, будут выполняться без запроса, даже когда инструменты редактирования файлов обычно требуют одобрения.144 Режим автоматического разрешения работает независимо от вашего параметра режима разрешений. Даже если вы не находитесь в режиме "принять правки", изолированные команды Bash будут выполняться автоматически при включении автоматического разрешения. Это означает, что команды Bash, которые изменяют файлы в границах sandbox, будут выполняться без запроса, даже когда инструменты редактирования файлов обычно требуют одобрения.


148 Настройка sandboxing148 Настройка sandboxing

149</h2>149</h2>

150 150 

151Настройте поведение sandbox через ваш файл `settings.json`. Полную справку по конфигурации см. в разделе [Settings](/ru/settings#sandbox-settings).151Настройте поведение sandbox через ваш файл `settings.json`. Полную справку по конфигурации см. в разделе [Settings](/docs/ru/settings#sandbox-settings).

152 152 

153По умолчанию изолированные команды могут писать только в текущий рабочий каталог и временный каталог сеанса. Если команды подпроцесса, такие как `kubectl`, `terraform` или `npm`, должны писать вне этих каталогов, используйте `sandbox.filesystem.allowWrite` для предоставления доступа к определённым путям:153По умолчанию изолированные команды могут писать только в текущий рабочий каталог и временный каталог сеанса. Если команды подпроцесса, такие как `kubectl`, `terraform` или `npm`, должны писать вне этих каталогов, используйте `sandbox.filesystem.allowWrite` для предоставления доступа к определённым путям:

154 154 


165 165 

166Эти пути применяются на уровне ОС, поэтому все команды, работающие внутри sandbox, включая их дочерние процессы, соблюдают их. Это рекомендуемый подход, когда инструменту требуется доступ на запись к определённому местоположению, вместо полного исключения инструмента из sandbox с помощью `excludedCommands`.166Эти пути применяются на уровне ОС, поэтому все команды, работающие внутри sandbox, включая их дочерние процессы, соблюдают их. Это рекомендуемый подход, когда инструменту требуется доступ на запись к определённому местоположению, вместо полного исключения инструмента из sandbox с помощью `excludedCommands`.

167 167 

168Когда один и тот же массив файловой системы определён в нескольких [областях параметров](/ru/settings#settings-precedence), массивы объединяются: пути из каждой области объединяются, а не заменяются.168Когда один и тот же массив файловой системы определён в нескольких [областях параметров](/docs/ru/settings#settings-precedence), массивы объединяются: пути из каждой области объединяются, а не заменяются.

169 169 

170Префиксы пути контролируют способ разрешения путей:170Префиксы пути контролируют способ разрешения путей:

171 171 


175| `~/` | Относительно домашнего каталога | `~/.kube` становится `$HOME/.kube` |175| `~/` | Относительно домашнего каталога | `~/.kube` становится `$HOME/.kube` |

176| `./` или без префикса | Относительно корня проекта для параметров проекта или к `~/.claude` для параметров пользователя | `./output` в `.claude/settings.json` разрешается в `<project-root>/output` |176| `./` или без префикса | Относительно корня проекта для параметров проекта или к `~/.claude` для параметров пользователя | `./output` в `.claude/settings.json` разрешается в `<project-root>/output` |

177 177 

178Этот синтаксис отличается от [правил разрешений Read и Edit](/ru/permissions#read-and-edit), которые используют `//path` для абсолютных и `/path` для относительных к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` — это абсолютный путь.178Этот синтаксис отличается от [правил разрешений Read и Edit](/docs/ru/permissions#read-and-edit), которые используют `//path` для абсолютных и `/path` для относительных к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` — это абсолютный путь.

179 179 

180Вы также можете запретить доступ на запись или чтение, используя `sandbox.filesystem.denyWrite` и `sandbox.filesystem.denyRead`, и повторно разрешить определённые пути в запрещённой области, используя `sandbox.filesystem.allowRead`. Когда правила чтения перекрываются, более специфичный путь побеждает:180Вы также можете запретить доступ на запись или чтение, используя `sandbox.filesystem.denyWrite` и `sandbox.filesystem.denyRead`, и повторно разрешить определённые пути в запрещённой области, используя `sandbox.filesystem.allowRead`. Когда правила чтения перекрываются, более специфичный путь побеждает:

181 181 


230 230 

231Записи файлов поддерживают только `"mode": "deny"`. Записи переменных окружения также принимают `"mode": "mask"`, описанные ниже.231Записи файлов поддерживают только `"mode": "deny"`. Записи переменных окружения также принимают `"mode": "mask"`, описанные ниже.

232 232 

233Пути файлов следуют тем же [правилам префиксов](/ru/settings#sandbox-path-prefixes), что и параметры `sandbox.filesystem.*`, и записи `deny` из каждой [области параметров](/ru/settings#settings-precedence) объединяются. Запись `deny` только сужает доступ, поэтому любая область может добавить одну, но ни одна не может удалить ту, которую добавила другая область.233Пути файлов следуют тем же [правилам префиксов](/docs/ru/settings#sandbox-path-prefixes), что и параметры `sandbox.filesystem.*`, и записи `deny` из каждой [области параметров](/docs/ru/settings#settings-precedence) объединяются. Запись `deny` только сужает доступ, поэтому любая область может добавить одну, но ни одна не может удалить ту, которую добавила другая область.

234 234 

235Встроенного списка запрещённых учётных данных нет, поэтому ограничены только файлы и переменные, которые вы указали. Параметр влияет только на изолированные команды Bash. Чтобы удалить учётные данные Anthropic и поставщиков облачных услуг из всех подпроцессов независимо от sandboxing, установите [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ru/env-vars).235Встроенного списка запрещённых учётных данных нет, поэтому ограничены только файлы и переменные, которые вы указали. Параметр влияет только на изолированные команды Bash. Чтобы удалить учётные данные Anthropic и поставщиков облачных услуг из всех подпроцессов независимо от sandboxing, установите [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/ru/env-vars).

236 236 

237<h4 id="mask-environment-variables">237<h4 id="mask-environment-variables">

238 Маскирование переменных окружения238 Маскирование переменных окружения


242 242 

243С `mask` изолированная команда видит значение-дозорное значение для каждого сеанса вместо реального. Когда запрос покидает sandbox для одного из хостов учётных данных `injectHosts`, [прокси sandbox](#network-isolation) заменяет дозорное значение на реальное. Команда и всё, что она логирует, никогда не содержат реальные учётные данные, но её запросы по-прежнему аутентифицируются.243С `mask` изолированная команда видит значение-дозорное значение для каждого сеанса вместо реального. Когда запрос покидает sandbox для одного из хостов учётных данных `injectHosts`, [прокси sandbox](#network-isolation) заменяет дозорное значение на реальное. Команда и всё, что она логирует, никогда не содержат реальные учётные данные, но её запросы по-прежнему аутентифицируются.

244 244 

245Прокси подставляет учётные данные внутри содержимого запроса, поэтому он должен их видеть. Установите [`network.tlsTerminate`](/ru/settings#sandbox-settings) так, чтобы прокси сам завершал TLS. Без этого маскирование закрывается неудачей: команда по-прежнему видит только дозорное значение, но дозорное значение достигает сервера без изменений и аутентификация не удаётся. Claude Code сообщает об этой неправильной конфигурации при запуске.245Прокси подставляет учётные данные внутри содержимого запроса, поэтому он должен их видеть. Установите [`network.tlsTerminate`](/docs/ru/settings#sandbox-settings) так, чтобы прокси сам завершал TLS. Без этого маскирование закрывается неудачей: команда по-прежнему видит только дозорное значение, но дозорное значение достигает сервера без изменений и аутентификация не удаётся. Claude Code сообщает об этой неправильной конфигурации при запуске.

246 246 

247Пример ниже маскирует два токена. `GH_TOKEN` подставляется только на запросы к `api.github.com`, в то время как `NPM_TOKEN` не имеет `injectHosts` и подставляется на запросы ко всем хостам в `network.allowedDomains`. Каждая запись `injectHosts` сама должна быть охвачена `network.allowedDomains`.247Пример ниже маскирует два токена. `GH_TOKEN` подставляется только на запросы к `api.github.com`, в то время как `NPM_TOKEN` не имеет `injectHosts` и подставляется на запросы ко всем хостам в `network.allowedDomains`. Каждая запись `injectHosts` сама должна быть охвачена `network.allowedDomains`.

248 248 


264}264}

265```265```

266 266 

267В отличие от `deny`, маскирование уполномочивает прокси отправлять ваши реальные учётные данные на указанные хосты, поэтому оно соблюдается только из параметров, которые вы или ваш администратор контролируете: параметры пользователя, управляемые параметры и флаг CLI `--settings`. Записи `mask`, `network.tlsTerminate` и [`credentials.allowPlaintextInject`](/ru/settings#sandbox-settings) в `.claude/settings.json` или `.claude/settings.local.json` репозитория игнорируются.267В отличие от `deny`, маскирование уполномочивает прокси отправлять ваши реальные учётные данные на указанные хосты, поэтому оно соблюдается только из параметров, которые вы или ваш администратор контролируете: параметры пользователя, управляемые параметры и флаг CLI `--settings`. Записи `mask`, `network.tlsTerminate` и [`credentials.allowPlaintextInject`](/docs/ru/settings#sandbox-settings) в `.claude/settings.json` или `.claude/settings.local.json` репозитория игнорируются.

268 268 

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

270 270 


281* **Поведение записи по умолчанию**: доступ на чтение и запись к текущему рабочему каталогу и его подкаталогам, а также к временному каталогу сеанса, на который указывает `$TMPDIR`281* **Поведение записи по умолчанию**: доступ на чтение и запись к текущему рабочему каталогу и его подкаталогам, а также к временному каталогу сеанса, на который указывает `$TMPDIR`

282* **Поведение чтения по умолчанию**: доступ на чтение ко всему компьютеру, кроме определённых запрещённых каталогов. Обратите внимание, что эта политика по умолчанию всё ещё разрешает чтение файлов учётных данных, таких как `~/.aws/credentials` и `~/.ssh/`. Используйте [`sandbox.credentials`](#protect-credentials) для блокировки чтения этих файлов и отмены установки переменных окружения с секретами, или добавьте пути в `denyRead`.282* **Поведение чтения по умолчанию**: доступ на чтение ко всему компьютеру, кроме определённых запрещённых каталогов. Обратите внимание, что эта политика по умолчанию всё ещё разрешает чтение файлов учётных данных, таких как `~/.aws/credentials` и `~/.ssh/`. Используйте [`sandbox.credentials`](#protect-credentials) для блокировки чтения этих файлов и отмены установки переменных окружения с секретами, или добавьте пути в `denyRead`.

283* **Заблокированный доступ**: невозможно изменять файлы вне текущего рабочего каталога и временного каталога сеанса без явного разрешения, включая файлы конфигурации оболочки, такие как `~/.bashrc`, и системные двоичные файлы в `/bin/`283* **Заблокированный доступ**: невозможно изменять файлы вне текущего рабочего каталога и временного каталога сеанса без явного разрешения, включая файлы конфигурации оболочки, такие как `~/.bashrc`, и системные двоичные файлы в `/bin/`

284* **Git worktrees**: когда рабочий каталог является [связанным git worktree](/ru/worktrees), sandbox также разрешает запись в общий каталог `.git` основного репозитория, чтобы команды, такие как `git commit`, могли обновлять ссылки и индекс. Запись в `hooks/` и `config` внутри этого каталога остаётся запрещённой.284* **Git worktrees**: когда рабочий каталог является [связанным git worktree](/docs/ru/worktrees), sandbox также разрешает запись в общий каталог `.git` основного репозитория, чтобы команды, такие как `git commit`, могли обновлять ссылки и индекс. Запись в `hooks/` и `config` внутри этого каталога остаётся запрещённой.

285* **Настраиваемо**: определите пользовательские разрешённые и запрещённые пути через параметры285* **Настраиваемо**: определите пользовательские разрешённые и запрещённые пути через параметры

286 286 

287Вы можете предоставить доступ на запись к дополнительным путям, используя `sandbox.filesystem.allowWrite` в ваших параметрах. Эти ограничения применяются на уровне ОС, поэтому они применяются ко всем командам подпроцесса, включая инструменты, такие как `kubectl`, `terraform` и `npm`, а не только к инструментам файлов Claude.287Вы можете предоставить доступ на запись к дополнительным путям, используя `sandbox.filesystem.allowWrite` в ваших параметрах. Эти ограничения применяются на уровне ОС, поэтому они применяются ко всем командам подпроцесса, включая инструменты, такие как `kubectl`, `terraform` и `npm`, а не только к инструментам файлов Claude.


292 292 

293Доступ в сеть контролируется через прокси-сервер, работающий вне sandbox:293Доступ в сеть контролируется через прокси-сервер, работающий вне sandbox:

294 294 

295* **Ограничения домена**: домены не предварительно разрешены. Первый раз, когда команде требуется новый домен, Claude Code запрашивает одобрение. {/* min-version: 2.1.191 */}Начиная с версии 2.1.191, выбор «Да» разрешает хост для остальной части текущего сеанса, поэтому более поздние подключения к тому же хосту больше не запрашивают подтверждение. Предварительно разрешите домены с помощью [`allowedDomains`](/ru/settings#sandbox-settings), чтобы избежать запроса полностью.295* **Ограничения домена**: домены не предварительно разрешены. Первый раз, когда команде требуется новый домен, Claude Code запрашивает одобрение. Начиная с версии 2.1.191, выбор «Да» разрешает хост для остальной части текущего сеанса, поэтому более поздние подключения к тому же хосту больше не запрашивают подтверждение. Предварительно разрешите домены с помощью [`allowedDomains`](/docs/ru/settings#sandbox-settings), чтобы избежать запроса полностью.

296* **Управляемая блокировка**: если [`allowManagedDomainsOnly`](/ru/settings#sandbox-settings) установлен в управляемых параметрах, неразрешённые домены автоматически блокируются вместо запроса, и только `allowedDomains` из управляемых параметров учитываются.296* **Управляемая блокировка**: если [`allowManagedDomainsOnly`](/docs/ru/settings#sandbox-settings) установлен в управляемых параметрах, неразрешённые домены автоматически блокируются вместо запроса, и только `allowedDomains` из управляемых параметров учитываются.

297* **Поддержка пользовательского прокси**: продвинутые пользователи могут реализовать пользовательские правила для исходящего трафика297* **Поддержка пользовательского прокси**: продвинутые пользователи могут реализовать пользовательские правила для исходящего трафика

298* **Полное покрытие**: ограничения применяются ко всем скриптам, программам и подпроцессам, порожденным командами298* **Полное покрытие**: ограничения применяются ко всем скриптам, программам и подпроцессам, порожденным командами

299 299 

300<Note>300<Note>

301 Встроенный прокси применяет список разрешений на основе запрошенного имени хоста и, по умолчанию, не завершает и не проверяет трафик TLS. {/* min-version: 2.1.199 */}Экспериментальный параметр [`network.tlsTerminate`](/ru/settings#sandbox-settings), доступный в Claude Code версии 2.1.199 и позже, заставляет встроенный прокси самостоятельно завершать TLS, что требуется для [`mask` записей учётных данных](#protect-credentials). См. [Security limitations](#security-limitations) для понимания последствий поведения по умолчанию и [Custom proxy configuration](#custom-proxy-configuration), если ваша модель угроз требует проверки TLS.301 Встроенный прокси применяет список разрешений на основе запрошенного имени хоста и, по умолчанию, не завершает и не проверяет трафик TLS. Экспериментальный параметр [`network.tlsTerminate`](/docs/ru/settings#sandbox-settings), доступный в Claude Code версии 2.1.199 и позже, заставляет встроенный прокси самостоятельно завершать TLS, что требуется для [`mask` записей учётных данных](#protect-credentials). См. [Security limitations](#security-limitations) для понимания последствий поведения по умолчанию и [Custom proxy configuration](#custom-proxy-configuration), если ваша модель угроз требует проверки TLS.

302</Note>302</Note>

303 303 

304<h3 id="os-level-enforcement">304<h3 id="os-level-enforcement">


313 313 

314WSL1 не поддерживается, потому что bubblewrap требует функций ядра, доступных только в WSL2. Эти ограничения на уровне ОС гарантируют, что все дочерние процессы, порожденные командами Claude Code, наследуют одни и те же границы безопасности.314WSL1 не поддерживается, потому что bubblewrap требует функций ядра, доступных только в WSL2. Эти ограничения на уровне ОС гарантируют, что все дочерние процессы, порожденные командами Claude Code, наследуют одни и те же границы безопасности.

315 315 

316Эти же примитивы доступны как отдельный пакет [`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime), который страница [Sandbox environments](/ru/sandbox-environments#sandbox-runtime) описывает как отдельный подход для обёртывания всего процесса Claude Code.316Эти же примитивы доступны как отдельный пакет [`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime), который страница [Sandbox environments](/docs/ru/sandbox-environments#sandbox-runtime) описывает как отдельный подход для обёртывания всего процесса Claude Code.

317 317 

318<h2 id="how-sandboxing-relates-to-permissions-and-permission-modes">318<h2 id="how-sandboxing-relates-to-permissions-and-permission-modes">

319 Как sandboxing связан с разрешениями и режимами разрешений319 Как sandboxing связан с разрешениями и режимами разрешений

320</h2>320</h2>

321 321 

322Sandboxing, [правила разрешений](/ru/permissions) и [режимы разрешений](/ru/permission-modes) являются дополняющими друг друга слоями. Разделы ниже описывают, как sandbox взаимодействует с каждым.322Sandboxing, [правила разрешений](/docs/ru/permissions) и [режимы разрешений](/docs/ru/permission-modes) являются дополняющими друг друга слоями. Разделы ниже описывают, как sandbox взаимодействует с каждым.

323 323 

324<h3 id="permission-rules">324<h3 id="permission-rules">

325 Правила разрешений325 Правила разрешений


353 Режимы разрешений353 Режимы разрешений

354</h3>354</h3>

355 355 

356`/sandbox` не является [режимом разрешений](/ru/permission-modes). Режимы разрешений решают, выполняется ли вызов инструмента и запрашивается ли вас сначала, в то время как sandbox ограничивает, к чему может получить доступ команда Bash после её запуска. Они отличаются в том, что они контролируют и что заменяет запрос для каждого действия:356`/sandbox` не является [режимом разрешений](/docs/ru/permission-modes). Режимы разрешений решают, выполняется ли вызов инструмента и запрашивается ли вас сначала, в то время как sandbox ограничивает, к чему может получить доступ команда Bash после её запуска. Они отличаются в том, что они контролируют и что заменяет запрос для каждого действия:

357 357 

358| | Что контролирует | Что заменяет запрос |358| | Что контролирует | Что заменяет запрос |

359| :----------------------------------------------------------------- | :--------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |359| :----------------------------------------------------------------- | :--------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

360| `/sandbox` | К чему может получить доступ команда Bash после её запуска | Сама граница sandbox в [режиме автоматического разрешения](#sandbox-modes) |360| `/sandbox` | К чему может получить доступ команда Bash после её запуска | Сама граница sandbox в [режиме автоматического разрешения](#sandbox-modes) |

361| [Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode) | Выполняется ли каждый вызов инструмента | Классификатор, который проверяет действия |361| [Auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) | Выполняется ли каждый вызов инструмента | Классификатор, который проверяет действия |

362| `--dangerously-skip-permissions` | Выполняется ли каждый вызов инструмента | Ничего. Проверки [защищённого пути](/ru/permission-modes#protected-paths) также пропускаются; только явные [правила ask](/ru/permissions#manage-permissions), инструменты соединителя [установленные вашей организацией на `ask`](/ru/mcp#organization-controls-on-connector-tools), инструменты MCP, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), и удаление `/` или вашего домашнего каталога по-прежнему запрашивают |362| `--dangerously-skip-permissions` | Выполняется ли каждый вызов инструмента | Ничего. Проверки [защищённого пути](/docs/ru/permission-modes#protected-paths) также пропускаются; только явные [правила ask](/docs/ru/permissions#manage-permissions), инструменты соединителя [установленные вашей организацией на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools), инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), и удаление `/` или вашего домашнего каталога по-прежнему запрашивают |

363 363 

364Режим [автоматического разрешения](#sandbox-modes) sandbox отличается от [режима auto](/ru/permission-modes#eliminate-prompts-with-auto-mode): автоматическое разрешение одобряет команды Bash, потому что граница sandbox их содержит, в то время как режим auto использует классификатор для проверки действий. Два работают независимо и могут быть объединены. Чтобы выбрать границу изоляции для автоматических запусков, см. [Sandbox environments](/ru/sandbox-environments#how-isolation-relates-to-permission-modes).364Режим [автоматического разрешения](#sandbox-modes) sandbox отличается от [режима auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode): автоматическое разрешение одобряет команды Bash, потому что граница sandbox их содержит, в то время как режим auto использует классификатор для проверки действий. Два работают независимо и могут быть объединены. Чтобы выбрать границу изоляции для автоматических запусков, см. [Sandbox environments](/docs/ru/sandbox-environments#how-isolation-relates-to-permission-modes).

365 365 

366<h2 id="configure-the-sandbox-for-your-organization">366<h2 id="configure-the-sandbox-for-your-organization">

367 Настройка sandbox для вашей организации367 Настройка sandbox для вашей организации


373 Применение sandboxing с управляемыми параметрами373 Применение sandboxing с управляемыми параметрами

374</h3>374</h3>

375 375 

376Чтобы требовать sandbox для каждого разработчика, доставьте ключи `sandbox` через [управляемые параметры](/ru/settings#settings-files), либо как файл, управляемый вашей MDM, либо через [управляемые параметры сервера](/ru/server-managed-settings) на Claude.ai.376Чтобы требовать sandbox для каждого разработчика, доставьте ключи `sandbox` через [управляемые параметры](/docs/ru/settings#settings-files), либо как файл, управляемый вашей MDM, либо через [управляемые параметры сервера](/docs/ru/server-managed-settings) на Claude.ai.

377 377 

378Следующая конфигурация управляемых параметров включает sandbox, отказывает запустить Claude Code, если sandbox не может инициализироваться, и препятствует модели повторять команды вне sandbox:378Следующая конфигурация управляемых параметров включает sandbox, отказывает запустить Claude Code, если sandbox не может инициализироваться, и препятствует модели повторять команды вне sandbox:

379 379 


402 402 

403Для логических ключей, таких как `enabled` и `failIfUnavailable`, Claude Code использует управляемое значение и игнорирует всё, что разработчик устанавливает локально. Для ключей массива, таких как `excludedCommands` и `allowRead`, Claude Code объединяет записи из каждой области, поэтому разработчик может добавлять записи, которые расширяют политику.403Для логических ключей, таких как `enabled` и `failIfUnavailable`, Claude Code использует управляемое значение и игнорирует всё, что разработчик устанавливает локально. Для ключей массива, таких как `excludedCommands` и `allowRead`, Claude Code объединяет записи из каждой области, поэтому разработчик может добавлять записи, которые расширяют политику.

404 404 

405Установите `allowManagedReadPathsOnly` в `true` в управляемых параметрах, чтобы только записи `allowRead` из управляемых параметров учитывались. Записи `allowRead` пользователя, проекта и локальные игнорируются. Это препятствует разработчикам расширять доступ на чтение за пределы одобренных организацией путей. Чтобы заблокировать сетевые домены таким же образом, установите [`allowManagedDomainsOnly`](/ru/settings#sandbox-settings).405Установите `allowManagedReadPathsOnly` в `true` в управляемых параметрах, чтобы только записи `allowRead` из управляемых параметров учитывались. Записи `allowRead` пользователя, проекта и локальные игнорируются. Это препятствует разработчикам расширять доступ на чтение за пределы одобренных организацией путей. Чтобы заблокировать сетевые домены таким же образом, установите [`allowManagedDomainsOnly`](/docs/ru/settings#sandbox-settings).

406 406 

407`excludedCommands` не имеет эквивалентной блокировки только для управляемых, поэтому разработчик всегда может добавлять записи, которые выполняют дополнительные команды вне sandbox. Держите управляемый список узким.407`excludedCommands` не имеет эквивалентной блокировки только для управляемых, поэтому разработчик всегда может добавлять записи, которые выполняют дополнительные команды вне sandbox. Держите управляемый список узким.

408 408 


417* Логирования всех сетевых запросов417* Логирования всех сетевых запросов

418* Интеграции с существующей инфраструктурой безопасности418* Интеграции с существующей инфраструктурой безопасности

419 419 

420Чтобы указать Claude Code на ваш прокси, установите порты прокси в [параметрах sandbox](/ru/settings#sandbox-settings):420Чтобы указать Claude Code на ваш прокси, установите порты прокси в [параметрах sandbox](/docs/ru/settings#sandbox-settings):

421 421 

422```json theme={null}422```json theme={null}

423{423{


438 438 

439* **Команды не выполняются с ошибкой host-not-allowed**: многие инструменты CLI должны достичь определённых хостов. Предоставление разрешения при запросе добавляет хост в ваш список разрешённых, поэтому инструмент выполняется внутри sandbox в будущем.439* **Команды не выполняются с ошибкой host-not-allowed**: многие инструменты CLI должны достичь определённых хостов. Предоставление разрешения при запросе добавляет хост в ваш список разрешённых, поэтому инструмент выполняется внутри sandbox в будущем.

440* **`jest` зависает или не выполняется**: `watchman` несовместим с sandbox. Вместо этого запустите `jest --no-watchman`.440* **`jest` зависает или не выполняется**: `watchman` несовместим с sandbox. Вместо этого запустите `jest --no-watchman`.

441* **Go-based CLIs не выполняют проверку TLS на macOS**: инструменты, такие как `gh`, `gcloud` и `terraform`, могут не выполнять проверку TLS под Seatbelt. Перечислите эти инструменты в `excludedCommands`, чтобы запустить их вне sandbox. Если вы используете `httpProxyPort` с MITM прокси и пользовательским CA, установите [`enableWeakerNetworkIsolation`](/ru/settings#sandbox-settings) в `true` вместо этого.441* **Go-based CLIs не выполняют проверку TLS на macOS**: инструменты, такие как `gh`, `gcloud` и `terraform`, могут не выполнять проверку TLS под Seatbelt. Перечислите эти инструменты в `excludedCommands`, чтобы запустить их вне sandbox. Если вы используете `httpProxyPort` с MITM прокси и пользовательским CA, установите [`enableWeakerNetworkIsolation`](/docs/ru/settings#sandbox-settings) в `true` вместо этого.

442* **`open`, `osascript` или потоки аутентификации на основе браузера не выполняются с ошибкой `-600` на macOS**: sandbox по умолчанию блокирует Apple Events. Установите [`allowAppleEvents`](/ru/settings#sandbox-settings) в `true` в ваших пользовательских, управляемых или CLI параметрах, чтобы разрешить их. Параметры проекта игнорируются для этого ключа. Включение его удаляет изоляцию выполнения кода, так как изолированные команды могут затем запускать другие приложения без изоляции без запроса пользователя и отправлять команды AppleScript запущенным приложениям, подлежащим запросу автоматизации macOS (TCC). Кроме того, добавьте команду в `excludedCommands`, чтобы запустить её вне sandbox.442* **`open`, `osascript` или потоки аутентификации на основе браузера не выполняются с ошибкой `-600` на macOS**: sandbox по умолчанию блокирует Apple Events. Установите [`allowAppleEvents`](/docs/ru/settings#sandbox-settings) в `true` в ваших пользовательских, управляемых или CLI параметрах, чтобы разрешить их. Параметры проекта игнорируются для этого ключа. Включение его удаляет изоляцию выполнения кода, так как изолированные команды могут затем запускать другие приложения без изоляции без запроса пользователя и отправлять команды AppleScript запущенным приложениям, подлежащим запросу автоматизации macOS (TCC). Кроме того, добавьте команду в `excludedCommands`, чтобы запустить её вне sandbox.

443* **Команды `docker` не выполняются**: `docker` несовместим с sandbox. Добавьте `docker *` в `excludedCommands`, чтобы запустить его вне sandbox.443* **Команды `docker` не выполняются**: `docker` несовместим с sandbox. Добавьте `docker *` в `excludedCommands`, чтобы запустить его вне sandbox.

444* **Bubblewrap не запускается внутри контейнера**: в непривилегированном контейнере bubblewrap не может смонтировать свежую файловую систему `/proc`. Установите [`enableWeakerNestedSandbox`](/ru/settings#sandbox-settings) в `true`, чтобы внутренний sandbox привязал существующий `/proc` контейнера вместо этого. Используйте этот параметр только когда внешний контейнер уже обеспечивает границу изоляции, которая вам требуется, так как это раскрывает информацию о процессе для изолированных команд, которую свежее монтирование `/proc` скрыло бы.444* **Bubblewrap не запускается внутри контейнера**: в непривилегированном контейнере bubblewrap не может смонтировать свежую файловую систему `/proc`. Установите [`enableWeakerNestedSandbox`](/docs/ru/settings#sandbox-settings) в `true`, чтобы внутренний sandbox привязал существующий `/proc` контейнера вместо этого. Используйте этот параметр только когда внешний контейнер уже обеспечивает границу изоляции, которая вам требуется, так как это раскрывает информацию о процессе для изолированных команд, которую свежее монтирование `/proc` скрыло бы.

445* **Фильтр seccomp на Linux**: фильтр seccomp требуется для блокировки Unix domain sockets. Вкладка Dependencies в `/sandbox` показывает, доступен ли он. Если он отсутствует, запустите `npm install -g @anthropic-ai/sandbox-runtime` для установки помощника.445* **Фильтр seccomp на Linux**: фильтр seccomp требуется для блокировки Unix domain sockets. Вкладка Dependencies в `/sandbox` показывает, доступен ли он. Если он отсутствует, запустите `npm install -g @anthropic-ai/sandbox-runtime` для установки помощника.

446* **`--dangerously-skip-permissions` не выполняется как root**: этот флаг блокируется при запуске как root или через sudo на Linux и macOS, потому что доступ root в сочетании с отсутствием запросов разрешений может изменять любой файл или сервис в системе. Проверка автоматически пропускается внутри признанного sandbox. Чтобы запустить автономно в контейнере, используйте конфигурацию [dev container](/ru/devcontainer), которая запускает Claude Code как непривилегированного пользователя.446* **`--dangerously-skip-permissions` не выполняется как root**: этот флаг блокируется при запуске как root или через sudo на Linux и macOS, потому что доступ root в сочетании с отсутствием запросов разрешений может изменять любой файл или сервис в системе. Проверка автоматически пропускается внутри признанного sandbox. Чтобы запустить автономно в контейнере, используйте конфигурацию [dev container](/docs/ru/devcontainer), которая запускает Claude Code как непривилегированного пользователя.

447 447 

448<h2 id="limitations">448<h2 id="limitations">

449 Ограничения449 Ограничения


455 Ограничения безопасности455 Ограничения безопасности

456</h3>456</h3>

457 457 

458* **Фильтрация сети**: sandbox ограничивает домены, к которым процессы могут подключаться. По умолчанию встроенный прокси не завершает и не проверяет TLS исходящего трафика, поэтому содержимое зашифрованных соединений не проверяется. Экспериментальный параметр [`network.tlsTerminate`](/ru/settings#sandbox-settings) завершает TLS на прокси для [подстановки учётных данных `mask`](#protect-credentials), но не добавляет фильтрацию содержимого. Вы несёте ответственность за обеспечение того, чтобы в вашей политике разрешались только доверенные домены.458* **Фильтрация сети**: sandbox ограничивает домены, к которым процессы могут подключаться. По умолчанию встроенный прокси не завершает и не проверяет TLS исходящего трафика, поэтому содержимое зашифрованных соединений не проверяется. Экспериментальный параметр [`network.tlsTerminate`](/docs/ru/settings#sandbox-settings) завершает TLS на прокси для [подстановки учётных данных `mask`](#protect-credentials), но не добавляет фильтрацию содержимого. Вы несёте ответственность за обеспечение того, чтобы в вашей политике разрешались только доверенные домены.

459 459 

460<Warning>460<Warning>

461 Разрешение широких доменов, таких как `github.com`, может создать пути для экспортирования данных. Потому что прокси принимает решение о разрешении на основе предоставленного клиентом имени хоста без проверки TLS, код, работающий внутри sandbox, потенциально может использовать [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting) или аналогичные методы для достижения хостов вне списка разрешений. Если ваша модель угроз требует более сильных гарантий, настройте [пользовательский прокси](#custom-proxy-configuration), который завершает TLS и проверяет трафик, и установите его сертификат CA внутри sandbox. Более сильная изоляция сети, осведомлённая о TLS, является активной областью разработки.461 Разрешение широких доменов, таких как `github.com`, может создать пути для экспортирования данных. Потому что прокси принимает решение о разрешении на основе предоставленного клиентом имени хоста без проверки TLS, код, работающий внутри sandbox, потенциально может использовать [domain fronting](https://en.wikipedia.org/wiki/Domain_fronting) или аналогичные методы для достижения хостов вне списка разрешений. Если ваша модель угроз требует более сильных гарантий, настройте [пользовательский прокси](#custom-proxy-configuration), который завершает TLS и проверяет трафик, и установите его сертификат CA внутри sandbox. Более сильная изоляция сети, осведомлённая о TLS, является активной областью разработки.


481 481 

482Sandbox изолирует подпроцессы Bash. Другие инструменты работают в разных границах:482Sandbox изолирует подпроцессы Bash. Другие инструменты работают в разных границах:

483 483 

484* **Встроенные инструменты файлов**: Read, Edit и Write используют систему разрешений напрямую, а не работают через sandbox. См. [permissions](/ru/permissions).484* **Встроенные инструменты файлов**: Read, Edit и Write используют систему разрешений напрямую, а не работают через sandbox. См. [permissions](/docs/ru/permissions).

485* **Использование компьютера**: когда Claude открывает приложения и управляет вашим экраном, он работает на вашем фактическом рабочем столе, а не в изолированной среде. Запросы разрешений для каждого приложения контролируют каждое приложение. См. [computer use in the CLI](/ru/computer-use) или [computer use in Desktop](/ru/desktop#let-claude-use-your-computer).485* **Использование компьютера**: когда Claude открывает приложения и управляет вашим экраном, он работает на вашем фактическом рабочем столе, а не в изолированной среде. Запросы разрешений для каждого приложения контролируют каждое приложение. См. [computer use in the CLI](/docs/ru/computer-use) или [computer use in Desktop](/docs/ru/desktop#let-claude-use-your-computer).

486* **Переменные окружения**: изолированные команды Bash наследуют окружение родительского процесса по умолчанию, включая любые учётные данные, установленные там. Используйте [`sandbox.credentials`](#protect-credentials) для удаления определённых переменных для изолированных команд или установите [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ru/env-vars) для удаления учётных данных Anthropic и поставщика облака из всех подпроцессов.486* **Переменные окружения**: изолированные команды Bash наследуют окружение родительского процесса по умолчанию, включая любые учётные данные, установленные там. Используйте [`sandbox.credentials`](#protect-credentials) для удаления определённых переменных для изолированных команд или установите [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/ru/env-vars) для удаления учётных данных Anthropic и поставщика облака из всех подпроцессов.

487* **Subagents**: [subagents](/ru/sub-agents) работают в том же процессе, что и родительский сеанс, и используют ту же конфигурацию sandbox. Команды Bash внутри subagent изолированы, когда sandboxing включен в родительском сеансе.487* **Subagents**: [subagents](/docs/ru/sub-agents) работают в том же процессе, что и родительский сеанс, и используют ту же конфигурацию sandbox. Команды Bash внутри subagent изолированы, когда sandboxing включен в родительском сеансе.

488 488 

489<Warning>489<Warning>

490 Эффективный sandboxing требует как изоляции файловой системы, так и сетевой изоляции. Без сетевой изоляции скомпрометированный агент может экспортировать конфиденциальные файлы, такие как ключи SSH. Без изоляции файловой системы скомпрометированный агент может установить бэкдор в системные ресурсы для получения сетевого доступа. Когда вы расширяете значения по умолчанию, проверьте, что путь `allowWrite`, широкая запись `allowedDomains` или исключение `excludedCommands` не отменяет ограничение на другой стороне.490 Эффективный sandboxing требует как изоляции файловой системы, так и сетевой изоляции. Без сетевой изоляции скомпрометированный агент может экспортировать конфиденциальные файлы, такие как ключи SSH. Без изоляции файловой системы скомпрометированный агент может установить бэкдор в системные ресурсы для получения сетевого доступа. Когда вы расширяете значения по умолчанию, проверьте, что путь `allowWrite`, широкая запись `allowedDomains` или исключение `excludedCommands` не отменяет ограничение на другой стороне.


494 См. также494 См. также

495</h2>495</h2>

496 496 

497* [Sandbox environments](/ru/sandbox-environments): сравните встроенный sandbox с dev containers, контейнерами и ВМ497* [Sandbox environments](/docs/ru/sandbox-environments): сравните встроенный sandbox с dev containers, контейнерами и ВМ

498* [Security](/ru/security): комплексные функции безопасности и лучшие практики498* [Security](/docs/ru/security): комплексные функции безопасности и лучшие практики

499* [Permissions](/ru/permissions): конфигурация разрешений и контроль доступа499* [Permissions](/docs/ru/permissions): конфигурация разрешений и контроль доступа

500* [Settings](/ru/settings): полная справка по конфигурации500* [Settings](/docs/ru/settings): полная справка по конфигурации

501* [CLI reference](/ru/cli-reference): параметры командной строки501* [CLI reference](/docs/ru/cli-reference): параметры командной строки

scheduled-tasks.md +16 −16

Details

6 6 

7> Используйте /loop и инструменты планирования cron для повторного запуска подсказок, опроса статуса или установки одноразовых напоминаний в сеансе Claude Code.7> Используйте /loop и инструменты планирования cron для повторного запуска подсказок, опроса статуса или установки одноразовых напоминаний в сеансе Claude Code.

8 8 

9Запланированные задачи позволяют Claude автоматически повторно запускать подсказку через определённый интервал. Используйте их для опроса развёртывания, контроля pull request, проверки долгоживущей сборки или напоминания себе о чём-то позже в сеансе. Чтобы реагировать на события по мере их возникновения вместо опроса, см. [Channels](/ru/channels): ваш CI может отправить сбой непосредственно в сеанс. Чтобы продолжить работу сеанса от одного хода к другому до выполнения условия, а не через интервал, см. [`/goal`](/ru/goal).9Запланированные задачи позволяют Claude автоматически повторно запускать подсказку через определённый интервал. Используйте их для опроса развёртывания, контроля pull request, проверки долгоживущей сборки или напоминания себе о чём-то позже в сеансе. Чтобы реагировать на события по мере их возникновения вместо опроса, см. [Channels](/docs/ru/channels): ваш CI может отправить сбой непосредственно в сеанс. Чтобы продолжить работу сеанса от одного хода к другому до выполнения условия, а не через интервал, см. [`/goal`](/docs/ru/goal).

10 10 

11Задачи привязаны к сеансу: они существуют в текущем разговоре и останавливаются при запуске нового. Возобновление с помощью `--resume` или `--continue` восстанавливает любую задачу, которая не [истекла](#seven-day-expiry): повторяющуюся задачу, созданную в течение последних 7 дней, или одноразовую, чьё запланированное время ещё не наступило. Для планирования, которое сохраняется независимо от любого сеанса, используйте [Routines](/ru/routines) для создания процедуры на управляемой Anthropic инфраструктуре, установите [Desktop запланированные задачи](/ru/desktop-scheduled-tasks) или используйте [GitHub Actions](/ru/github-actions).11Задачи привязаны к сеансу: они существуют в текущем разговоре и останавливаются при запуске нового. Возобновление с помощью `--resume` или `--continue` восстанавливает любую задачу, которая не [истекла](#seven-day-expiry): повторяющуюся задачу, созданную в течение последних 7 дней, или одноразовую, чьё запланированное время ещё не наступило. Для планирования, которое сохраняется независимо от любого сеанса, используйте [Routines](/docs/ru/routines) для создания процедуры на управляемой Anthropic инфраструктуре, установите [Desktop запланированные задачи](/docs/ru/desktop-scheduled-tasks) или используйте [GitHub Actions](/docs/ru/github-actions).

12 12 

13<h2 id="compare-scheduling-options">13<h2 id="compare-scheduling-options">

14 Сравните варианты планирования14 Сравните варианты планирования


16 16 

17Claude Code offers three ways to schedule recurring or one-off work:17Claude Code offers three ways to schedule recurring or one-off work:

18 18 

19| | [Cloud](/en/routines) | [Desktop](/en/desktop-scheduled-tasks) | [`/loop`](/en/scheduled-tasks) |19| | [Cloud](/docs/en/routines) | [Desktop](/docs/en/desktop-scheduled-tasks) | [`/loop`](/docs/en/scheduled-tasks) |

20| :------------------------- | :----------------------------- | :------------------------------------- | :---------------------------------- |20| :------------------------- | :----------------------------- | :------------------------------------- | :---------------------------------- |

21| Runs on | Anthropic cloud | Your machine | Your machine |21| Runs on | Anthropic cloud | Your machine | Your machine |

22| Requires machine on | No | Yes | Yes |22| Requires machine on | No | Yes | Yes |

23| Requires open session | No | No | Yes |23| Requires open session | No | No | Yes |

24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |

25| Access to local files | No (fresh clone) | Yes | Yes |25| Access to local files | No (fresh clone) | Yes | Yes |

26| MCP servers | Connectors configured per task | [Config files](/en/mcp) and connectors | Inherits from session |26| MCP servers | Connectors configured per task | [Config files](/docs/en/mcp) and connectors | Inherits from session |

27| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |27| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |

28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |

29| Minimum interval | 1 hour | 1 minute | 1 minute |29| Minimum interval | 1 hour | 1 minute | 1 minute |


44| Только подсказка | `/loop check the deploy` | Ваша подсказка запускается с [интервалом, выбранным Claude](#let-claude-choose-the-interval) на каждой итерации |44| Только подсказка | `/loop check the deploy` | Ваша подсказка запускается с [интервалом, выбранным Claude](#let-claude-choose-the-interval) на каждой итерации |

45| Только интервал или ничего | `/loop` | Запускается [встроенная подсказка обслуживания](#run-the-built-in-maintenance-prompt) или ваш `loop.md`, если он существует |45| Только интервал или ничего | `/loop` | Запускается [встроенная подсказка обслуживания](#run-the-built-in-maintenance-prompt) или ваш `loop.md`, если он существует |

46 46 

47Вы также можете передать skill в качестве подсказки, например `/loop 20m /review-pr 1234`, чтобы повторно запустить этот skill на каждой итерации. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, запланированное срабатывание запускает только skills, которые Claude [может вызывать самостоятельно](/ru/skills#control-who-invokes-a-skill). Следующие элементы поступают к Claude как простой текст вместо выполнения:47Вы также можете передать skill в качестве подсказки, например `/loop 20m /review-pr 1234`, чтобы повторно запустить этот skill на каждой итерации. Начиная с версии 2.1.196, запланированное срабатывание запускает только skills, которые Claude [может вызывать самостоятельно](/docs/ru/skills#control-who-invokes-a-skill). Следующие элементы поступают к Claude как простой текст вместо выполнения:

48 48 

49* встроенные команды, такие как `/permissions`, `/model` или `/clear`49* встроенные команды, такие как `/permissions`, `/model` или `/clear`

50* skills, отмеченные [`disable-model-invocation: true`](/ru/skills#frontmatter-reference)50* skills, отмеченные [`disable-model-invocation: true`](/docs/ru/skills#frontmatter-reference)

51* skills, скрытые от Claude параметром [`skillOverrides`](/ru/skills#override-skill-visibility-from-settings) или правилом `Skill` [deny](/ru/skills#restrict-claude’s-skill-access)51* skills, скрытые от Claude параметром [`skillOverrides`](/docs/ru/skills#override-skill-visibility-from-settings) или правилом `Skill` [deny](/docs/ru/skills#restrict-claude’s-skill-access)

52* [MCP prompts](/ru/mcp#use-mcp-prompts-as-commands), такие как `/mcp__github__list_prs`; skills, которые предоставляет MCP сервер, всё ещё запускаются52* [MCP prompts](/docs/ru/mcp#use-mcp-prompts-as-commands), такие как `/mcp__github__list_prs`; skills, которые предоставляет MCP сервер, всё ещё запускаются

53 53 

54<h3 id="run-on-a-fixed-interval">54<h3 id="run-on-a-fixed-interval">

55 Запуск по фиксированному интервалу55 Запуск по фиксированному интервалу


77/loop check whether CI passed and address any review comments77/loop check whether CI passed and address any review comments

78```78```

79 79 

80Когда вы запрашиваете динамическое расписание `/loop`, Claude может использовать инструмент [Monitor](/ru/tools-reference#monitor-tool) напрямую. Monitor запускает фоновый скрипт и передаёт каждую строку вывода обратно, что полностью избегает опроса и часто более эффективно по токенам и отзывчиво, чем повторный запуск подсказки через интервал.80Когда вы запрашиваете динамическое расписание `/loop`, Claude может использовать инструмент [Monitor](/docs/ru/tools-reference#monitor-tool) напрямую. Monitor запускает фоновый скрипт и передаёт каждую строку вывода обратно, что полностью избегает опроса и часто более эффективно по токенам и отзывчиво, чем повторный запуск подсказки через интервал.

81 81 

82Динамически запланированный цикл появляется в вашем [списке запланированных задач](#manage-scheduled-tasks) как любая другая задача, поэтому вы можете перечислить или отменить его таким же образом. [Правила дрожания](#jitter) не применяются к нему, но [истечение через семь дней](#seven-day-expiry) применяется: цикл автоматически заканчивается через семь дней после его запуска.82Динамически запланированный цикл появляется в вашем [списке запланированных задач](#manage-scheduled-tasks) как любая другая задача, поэтому вы можете перечислить или отменить его таким же образом. [Правила дрожания](#jitter) не применяются к нему, но [истечение через семь дней](#seven-day-expiry) применяется: цикл автоматически заканчивается через семь дней после его запуска.

83 83 


141 141 

142Чтобы остановить `/loop` во время ожидания следующей итерации, нажмите `Esc`. Это очищает ожидающее пробуждение, поэтому цикл не срабатывает снова. Задачи, которые вы запланировали, [попросив Claude напрямую](#manage-scheduled-tasks), не затрагиваются `Esc` и остаются на месте до тех пор, пока вы их не удалите.142Чтобы остановить `/loop` во время ожидания следующей итерации, нажмите `Esc`. Это очищает ожидающее пробуждение, поэтому цикл не срабатывает снова. Задачи, которые вы запланировали, [попросив Claude напрямую](#manage-scheduled-tasks), не затрагиваются `Esc` и остаются на месте до тех пор, пока вы их не удалите.

143 143 

144В [режиме самостоятельного темпа](#let-claude-choose-the-interval) Claude также может завершить цикл самостоятельно, как только задача будет завершена. Claude вызывает инструмент [`ScheduleWakeup`](/ru/tools-reference) с `stop: true`, что немедленно отменяет ожидающее пробуждение. Если итерация заканчивается без переплана или остановки, Claude Code планирует одно резервное пробуждение примерно через 20 минут и завершает цикл, когда эта итерация также не переплана. До версии 2.1.202 отсутствие переплана было единственным способом, которым Claude мог завершить цикл самостоятельно.144В [режиме самостоятельного темпа](#let-claude-choose-the-interval) Claude также может завершить цикл самостоятельно, как только задача будет завершена. Claude вызывает инструмент [`ScheduleWakeup`](/docs/ru/tools-reference) с `stop: true`, что немедленно отменяет ожидающее пробуждение. Если итерация заканчивается без переплана или остановки, Claude Code планирует одно резервное пробуждение примерно через 20 минут и завершает цикл, когда эта итерация также не переплана. До версии 2.1.202 отсутствие переплана было единственным способом, которым Claude мог завершить цикл самостоятельно.

145 145 

146Циклы по фиксированному интервалу продолжают работать до тех пор, пока вы их не остановите или [не пройдёт семь дней](#seven-day-expiry).146Циклы по фиксированному интервалу продолжают работать до тех пор, пока вы их не остановите или [не пройдёт семь дней](#seven-day-expiry).

147 147 


208 Истечение через семь дней208 Истечение через семь дней

209</h3>209</h3>

210 210 

211Повторяющиеся задачи автоматически истекают через 7 дней после создания. Задача срабатывает в последний раз, а затем удаляет себя. Это ограничивает, как долго может работать забытый цикл. Если вам нужна повторяющаяся задача, которая длится дольше, отмените и пересоздайте её перед истечением срока, или используйте [Routines](/ru/routines) или [Desktop запланированные задачи](/ru/desktop-scheduled-tasks) для долговечного планирования.211Повторяющиеся задачи автоматически истекают через 7 дней после создания. Задача срабатывает в последний раз, а затем удаляет себя. Это ограничивает, как долго может работать забытый цикл. Если вам нужна повторяющаяся задача, которая длится дольше, отмените и пересоздайте её перед истечением срока, или используйте [Routines](/docs/ru/routines) или [Desktop запланированные задачи](/docs/ru/desktop-scheduled-tasks) для долговечного планирования.

212 212 

213<h2 id="cron-expression-reference">213<h2 id="cron-expression-reference">

214 Справочник выражений cron214 Справочник выражений cron


233 Отключите запланированные задачи233 Отключите запланированные задачи

234</h2>234</h2>

235 235 

236Установите `CLAUDE_CODE_DISABLE_CRON=1` в вашей среде, чтобы полностью отключить планировщик. Инструменты cron и `/loop` становятся недоступными, и любые уже запланированные задачи перестают срабатывать. См. [Переменные окружения](/ru/env-vars) для полного списка флагов отключения.236Установите `CLAUDE_CODE_DISABLE_CRON=1` в вашей среде, чтобы полностью отключить планировщик. Инструменты cron и `/loop` становятся недоступными, и любые уже запланированные задачи перестают срабатывать. См. [Переменные окружения](/docs/ru/env-vars) для полного списка флагов отключения.

237 237 

238<h2 id="limitations">238<h2 id="limitations">

239 Ограничения239 Ограничения


241 241 

242Планирование, привязанное к сеансу, имеет присущие ему ограничения:242Планирование, привязанное к сеансу, имеет присущие ему ограничения:

243 243 

244* Задачи срабатывают только во время работы Claude Code и в режиме ожидания. Закрытие терминала или выход из сеанса отменяет всё. [Перемещение сеанса в фоновый режим](/ru/agent-view#from-inside-a-session) переносит задачи `/loop` в фоновый сеанс, который продолжает работать без терминала.244* Задачи срабатывают только во время работы Claude Code и в режиме ожидания. Закрытие терминала или выход из сеанса отменяет всё. [Перемещение сеанса в фоновый режим](/docs/ru/agent-view#from-inside-a-session) переносит задачи `/loop` в фоновый сеанс, который продолжает работать без терминала.

245* Нет наверстывания пропущенных срабатываний. Если запланированное время задачи проходит, пока Claude занят долгоживущим запросом, она срабатывает один раз, когда Claude становится свободным, а не один раз за каждый пропущенный интервал.245* Нет наверстывания пропущенных срабатываний. Если запланированное время задачи проходит, пока Claude занят долгоживущим запросом, она срабатывает один раз, когда Claude становится свободным, а не один раз за каждый пропущенный интервал.

246* Запуск нового разговора очищает все задачи, привязанные к сеансу. Возобновление с помощью `claude --resume` или `claude --continue` восстанавливает задачи, которые не истекли: повторяющиеся задачи в течение семи дней после создания и одноразовые задачи, чьё запланированное время ещё не наступило. Фоновые задачи Bash и monitor никогда не восстанавливаются при возобновлении.246* Запуск нового разговора очищает все задачи, привязанные к сеансу. Возобновление с помощью `claude --resume` или `claude --continue` восстанавливает задачи, которые не истекли: повторяющиеся задачи в течение семи дней после создания и одноразовые задачи, чьё запланированное время ещё не наступило. Фоновые задачи Bash и monitor никогда не восстанавливаются при возобновлении.

247 247 

248Для автоматизации, управляемой cron, которая должна работать без присмотра:248Для автоматизации, управляемой cron, которая должна работать без присмотра:

249 249 

250* [Routines](/ru/routines): запуск на инфраструктуре, управляемой Anthropic, по расписанию, через вызов API или на события GitHub250* [Routines](/docs/ru/routines): запуск на инфраструктуре, управляемой Anthropic, по расписанию, через вызов API или на события GitHub

251* [GitHub Actions](/ru/github-actions): используйте триггер `schedule` в CI251* [GitHub Actions](/docs/ru/github-actions): используйте триггер `schedule` в CI

252* [Desktop запланированные задачи](/ru/desktop-scheduled-tasks): запуск локально на вашей машине252* [Desktop запланированные задачи](/docs/ru/desktop-scheduled-tasks): запуск локально на вашей машине

Details

10 10 

11После установки плагин работает автоматически. Нет ничего, что нужно вызывать, и нет отдельной команды, которую нужно помнить.11После установки плагин работает автоматически. Нет ничего, что нужно вызывать, и нет отдельной команды, которую нужно помнить.

12 12 

13Плагин является встроенным в сеанс компаньоном [Code Review](/ru/code-review), который работает на pull request. Этот плагин снижает объём того, что попадает в PR. Code Review ловит то, что остаётся. О том, как плагин работает вместе с проверкой по требованию и сканированием CI, см. [Как это работает с другими инструментами безопасности](#how-this-fits-with-other-security-tools).13Плагин является встроенным в сеанс компаньоном [Code Review](/docs/ru/code-review), который работает на pull request. Этот плагин снижает объём того, что попадает в PR. Code Review ловит то, что остаётся. О том, как плагин работает вместе с проверкой по требованию и сканированием CI, см. [Как это работает с другими инструментами безопасности](#how-this-fits-with-other-security-tools).

14 14 

15<h2 id="prerequisites">15<h2 id="prerequisites">

16 Предварительные требования16 Предварительные требования


26 Установка плагина26 Установка плагина

27</h2>27</h2>

28 28 

29В сеансе Claude Code установите из [официального маркетплейса Anthropic](/ru/discover-plugins#official-anthropic-marketplace):29В сеансе Claude Code установите из [официального маркетплейса Anthropic](/docs/ru/discover-plugins#official-anthropic-marketplace):

30 30 

31```text theme={null}31```text theme={null}

32/plugin install security-guidance@claude-plugins-official32/plugin install security-guidance@claude-plugins-official


44 Включение в облачных сеансах и общих репозиториях44 Включение в облачных сеансах и общих репозиториях

45</h3>45</h3>

46 46 

47Плагины с областью действия пользователя не переносятся в [Claude Code в веб-версии](/ru/claude-code-on-the-web), потому что эти сеансы работают на инфраструктуре Anthropic, а не на вашей машине. Чтобы включить плагин там или включить его для всех, кто клонирует репозиторий, объявите его в параметрах проекта, которые проверены:47Плагины с областью действия пользователя не переносятся в [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), потому что эти сеансы работают на инфраструктуре Anthropic, а не на вашей машине. Чтобы включить плагин там или включить его для всех, кто клонирует репозиторий, объявите его в параметрах проекта, которые проверены:

48 48 

49```json .claude/settings.json theme={null}49```json .claude/settings.json theme={null}

50{50{


54}54}

55```55```

56 56 

57Администраторы могут включить плагин на уровне организации, установив [`enabledPlugins`](/ru/settings#plugin-settings) в [управляемых параметрах](/ru/admin-setup).57Администраторы могут включить плагин на уровне организации, установив [`enabledPlugins`](/docs/ru/settings#plugin-settings) в [управляемых параметрах](/docs/ru/admin-setup).

58 58 

59<h2 id="what-the-plugin-checks">59<h2 id="what-the-plugin-checks">

60 Что проверяет плагин60 Что проверяет плагин


139- Use `crypto.timingSafeEqual` for token comparison instead of `===`.139- Use `crypto.timingSafeEqual` for token comparison instead of `===`.

140```140```

141 141 

142Эти правила — руководство для рецензента, а не детерминированные ограждения. Плагин выявляет нарушения как результаты для Claude, чтобы исправить, но он не блокирует записи и не гарантирует, что каждое нарушение будет выявлено. Руководство является дополнительным только: правило, которое говорит игнорировать класс уязвимостей, не подавляет эти результаты. Для жёсткого принудительного исполнения объедините плагин с [хуком, который блокирует редактирование](/ru/hooks-guide#block-edits-to-protected-files) или проверкой CI.142Эти правила — руководство для рецензента, а не детерминированные ограждения. Плагин выявляет нарушения как результаты для Claude, чтобы исправить, но он не блокирует записи и не гарантирует, что каждое нарушение будет выявлено. Руководство является дополнительным только: правило, которое говорит игнорировать класс уязвимостей, не подавляет эти результаты. Для жёсткого принудительного исполнения объедините плагин с [хуком, который блокирует редактирование](/docs/ru/hooks-guide#block-edits-to-protected-files) или проверкой CI.

143 143 

144<h3 id="add-custom-per-edit-patterns">144<h3 id="add-custom-per-edit-patterns">

145 Добавьте пользовательские шаблоны для каждого редактирования145 Добавьте пользовательские шаблоны для каждого редактирования


187 Стоимость использования187 Стоимость использования

188</h2>188</h2>

189 189 

190[Проверка шаблонов при каждом редактировании](#on-each-file-edit) не делает вызов модели и не добавляет затрат. [Проверки в конце хода](#at-the-end-of-each-turn) и [коммита](#on-each-commit-or-push-claude-makes) каждая тратит дополнительное использование модели, которое считается в вашем [использовании](/ru/costs) как любой другой запрос Claude. Проверка коммита является агентивной и может занять несколько ходов модели за коммит, ограничено 20 проверками в течение часа. Ожидайте примерно один вызов проверки за ход, который изменяет файлы, и одну более глубокую проверку за коммит, оба подлежат ограничениям выше.190[Проверка шаблонов при каждом редактировании](#on-each-file-edit) не делает вызов модели и не добавляет затрат. [Проверки в конце хода](#at-the-end-of-each-turn) и [коммита](#on-each-commit-or-push-claude-makes) каждая тратит дополнительное использование модели, которое считается в вашем [использовании](/docs/ru/costs) как любой другой запрос Claude. Проверка коммита является агентивной и может занять несколько ходов модели за коммит, ограничено 20 проверками в течение часа. Ожидайте примерно один вызов проверки за ход, который изменяет файлы, и одну более глубокую проверку за коммит, оба подлежат ограничениям выше.

191 191 

192Обе проверки на основе модели используют Claude Opus 4.7 по умолчанию. Установите `SECURITY_REVIEW_MODEL` для выбора другой модели для проверки в конце хода и `SG_AGENTIC_MODEL` для проверки коммита.192Обе проверки на основе модели используют Claude Opus 4.7 по умолчанию. Установите `SECURITY_REVIEW_MODEL` для выбора другой модели для проверки в конце хода и `SG_AGENTIC_MODEL` для проверки коммита.

193 193 


219/plugin uninstall security-guidance@claude-plugins-official219/plugin uninstall security-guidance@claude-plugins-official

220```220```

221 221 

222Если плагин был включен через `.claude/settings.json` проекта, отключение его из `/plugin` записывает переопределение в ваш `.claude/settings.local.json` вместо редактирования проверенного файла, поэтому плагин остаётся отключённым для вас, а товарищи по команде не затронуты. {/* min-version: 2.1.203 */}То же диалоговое окно также предлагает удалить плагин для всех, удалив его из общего `.claude/settings.json`; этот вариант требует Claude Code v2.1.203 или более поздней версии. Если он был включен через [управляемые параметры](/ru/admin-setup), только администратор может его отключить.222Если плагин был включен через `.claude/settings.json` проекта, отключение его из `/plugin` записывает переопределение в ваш `.claude/settings.local.json` вместо редактирования проверенного файла, поэтому плагин остаётся отключённым для вас, а товарищи по команде не затронуты. То же диалоговое окно также предлагает удалить плагин для всех, удалив его из общего `.claude/settings.json`; этот вариант требует Claude Code v2.1.203 или более поздней версии. Если он был включен через [управляемые параметры](/docs/ru/admin-setup), только администратор может его отключить.

223 223 

224<h2 id="how-the-plugin-integrates-with-claude-code">224<h2 id="how-the-plugin-integrates-with-claude-code">

225 Как плагин интегрируется с Claude Code225 Как плагин интегрируется с Claude Code

226</h2>226</h2>

227 227 

228Плагин полностью построен на [hooks](/ru/hooks), механизме для запуска вашего собственного кода в определённых точках цикла Claude. Он регистрирует:228Плагин полностью построен на [hooks](/docs/ru/hooks), механизме для запуска вашего собственного кода в определённых точках цикла Claude. Он регистрирует:

229 229 

230| Hook event | Назначение |230| Hook event | Назначение |

231| :-------------------------------------------------------------------- | :-------------------------------------------------------------------------------------- |231| :-------------------------------------------------------------------- | :-------------------------------------------------------------------------------------- |


246| Этап | Инструмент | Что он охватывает |246| Этап | Инструмент | Что он охватывает |

247| :-------------- | :--------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- |247| :-------------- | :--------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- |

248| В сеансе | Security guidance plugin | Распространённые уязвимости в коде, который пишет Claude, исправлены в одном сеансе |248| В сеансе | Security guidance plugin | Распространённые уязвимости в коде, который пишет Claude, исправлены в одном сеансе |

249| По требованию | [`/security-review`](/ru/commands#all-commands) | Однократная проверка безопасности на текущей ветке, выполняется по вашему запросу |249| По требованию | [`/security-review`](/docs/ru/commands#all-commands) | Однократная проверка безопасности на текущей ветке, выполняется по вашему запросу |

250| На pull request | [Code Review](/ru/code-review), планы Team и Enterprise | Многоагентная проверка корректности и безопасности с полным контекстом кодовой базы |250| На pull request | [Code Review](/docs/ru/code-review), планы Team и Enterprise | Многоагентная проверка корректности и безопасности с полным контекстом кодовой базы |

251| В CI | Ваши существующие статические анализаторы и сканеры зависимостей | Правила, специфичные для языка, проверки цепочки поставок и принудительное исполнение политики, которые плагин не пытается выполнять |251| В CI | Ваши существующие статические анализаторы и сканеры зависимостей | Правила, специфичные для языка, проверки цепочки поставок и принудительное исполнение политики, которые плагин не пытается выполнять |

252 252 

253Каждый более поздний этап выявляет то, что пропустили более ранние. Ценность плагина в снижении объёма, который их достигает, а не в исключении необходимости в них.253Каждый более поздний этап выявляет то, что пропустили более ранние. Ценность плагина в снижении объёма, который их достигает, а не в исключении необходимости в них.


270 270 

271Чтобы углубиться в части, которые эта страница затрагивает:271Чтобы углубиться в части, которые эта страница затрагивает:

272 272 

273* [Code Review](/ru/code-review): настройка многоагентной проверки во время PR273* [Code Review](/docs/ru/code-review): настройка многоагентной проверки во время PR

274* [Автоматизируйте действия с помощью hooks](/ru/hooks-guide): создавайте свои собственные проверки в одних и тех же точках жизненного цикла274* [Автоматизируйте действия с помощью hooks](/docs/ru/hooks-guide): создавайте свои собственные проверки в одних и тех же точках жизненного цикла

275* [Откройте и установите плагины](/ru/discover-plugins#official-anthropic-marketplace): просмотрите другие официальные плагины275* [Откройте и установите плагины](/docs/ru/discover-plugins#official-anthropic-marketplace): просмотрите другие официальные плагины

Details

28 Выбор между параметрами, управляемыми сервером, и параметрами, управляемыми конечной точкой28 Выбор между параметрами, управляемыми сервером, и параметрами, управляемыми конечной точкой

29</h2>29</h2>

30 30 

31Claude Code поддерживает два подхода к централизованной конфигурации. Параметры, управляемые сервером, доставляют конфигурацию с серверов Anthropic. [Параметры, управляемые конечной точкой](/ru/settings#settings-files) развертываются непосредственно на устройства через встроенные политики ОС (управляемые параметры macOS, реестр Windows) или управляемые файлы параметров.31Claude Code поддерживает два подхода к централизованной конфигурации. Параметры, управляемые сервером, доставляют конфигурацию с серверов Anthropic. [Параметры, управляемые конечной точкой](/docs/ru/settings#settings-files) развертываются непосредственно на устройства через встроенные политики ОС (управляемые параметры macOS, реестр Windows) или управляемые файлы параметров.

32 32 

33| Подход | Лучше всего подходит для | Модель безопасности |33| Подход | Лучше всего подходит для | Модель безопасности |

34| :------------------------------------------------------------------------ | :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |34| :------------------------------------------------------------------------ | :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |

35| **Параметры, управляемые сервером** | Организации без MDM или пользователи на неуправляемых устройствах | Параметры доставляются с серверов Anthropic во время аутентификации |35| **Параметры, управляемые сервером** | Организации без MDM или пользователи на неуправляемых устройствах | Параметры доставляются с серверов Anthropic во время аутентификации |

36| **[Параметры, управляемые конечной точкой](/ru/settings#settings-files)** | Организации с MDM или управлением конечными точками | Параметры развертываются на устройства через профили конфигурации MDM, политики реестра или управляемые файлы параметров |36| **[Параметры, управляемые конечной точкой](/docs/ru/settings#settings-files)** | Организации с MDM или управлением конечными точками | Параметры развертываются на устройства через профили конфигурации MDM, политики реестра или управляемые файлы параметров |

37 37 

38Если ваши устройства зарегистрированы в решении MDM или управления конечными точками, параметры, управляемые конечной точкой, обеспечивают более сильные гарантии безопасности, поскольку файл параметров может быть защищен от изменения пользователем на уровне ОС. Параметры, управляемые конечной точкой, не достигают [облачных сеансов](/ru/model-config#surface-coverage), поэтому организации, использующие Claude Code в веб-версии, должны также настроить параметры, управляемые сервером.38Если ваши устройства зарегистрированы в решении MDM или управления конечными точками, параметры, управляемые конечной точкой, обеспечивают более сильные гарантии безопасности, поскольку файл параметров может быть защищен от изменения пользователем на уровне ОС. Параметры, управляемые конечной точкой, не достигают [облачных сеансов](/docs/ru/model-config#surface-coverage), поэтому организации, использующие Claude Code в веб-версии, должны также настроить параметры, управляемые сервером.

39 39 

40<h2 id="configure-server-managed-settings">40<h2 id="configure-server-managed-settings">

41 Настройка параметров, управляемых сервером41 Настройка параметров, управляемых сервером


49 </Step>49 </Step>

50 50 

51 <Step title="Определите ваши параметры">51 <Step title="Определите ваши параметры">

52 Добавьте вашу конфигурацию как JSON. Все [параметры, доступные в `settings.json`](/ru/settings#available-settings), поддерживаются, за исключением тех, которые ограничены доставкой политики на уровне ОС; см. [Текущие ограничения](#current-limitations) для этого краткого списка. Это включает [hooks](/ru/hooks), [переменные окружения](/ru/env-vars) и [параметры только для управления](/ru/permissions#managed-only-settings), такие как `allowManagedPermissionRulesOnly`.52 Добавьте вашу конфигурацию как JSON. Все [параметры, доступные в `settings.json`](/docs/ru/settings#available-settings), поддерживаются, за исключением тех, которые ограничены доставкой политики на уровне ОС; см. [Текущие ограничения](#current-limitations) для этого краткого списка. Это включает [hooks](/docs/ru/hooks), [переменные окружения](/docs/ru/env-vars) и [параметры только для управления](/docs/ru/permissions#managed-only-settings), такие как `allowManagedPermissionRulesOnly`.

53 53 

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

55 55 


87 }87 }

88 ```88 ```

89 89 

90 Для настройки [классификатора режима автоматизации](/ru/permission-modes#eliminate-prompts-with-auto-mode), чтобы он знал, какие репозитории, бакеты и домены доверяет ваша организация:90 Для настройки [классификатора режима автоматизации](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), чтобы он знал, какие репозитории, бакеты и домены доверяет ваша организация:

91 91 

92 ```json theme={null}92 ```json theme={null}

93 {93 {


101 }101 }

102 ```102 ```

103 103 

104 Поскольку hooks выполняют команды оболочки, пользователи видят [диалог одобрения безопасности](#security-approval-dialogs) перед их применением. Смотрите [Настройка режима автоматизации](/ru/auto-mode-config) для информации о том, как записи `autoMode` влияют на то, что блокирует классификатор, и важные предупреждения о полях `environment`, `allow`, `soft_deny` и `hard_deny`.104 Поскольку hooks выполняют команды оболочки, пользователи видят [диалог одобрения безопасности](#security-approval-dialogs) перед их применением. Смотрите [Настройка режима автоматизации](/docs/ru/auto-mode-config) для информации о том, как записи `autoMode` влияют на то, что блокирует классификатор, и важные предупреждения о полях `environment`, `allow`, `soft_deny` и `hard_deny`.

105 </Step>105 </Step>

106 106 

107 <Step title="Сохраните и разверните">107 <Step title="Сохраните и разверните">


130 Параметры только для управления130 Параметры только для управления

131</h3>131</h3>

132 132 

133Большинство [ключей параметров](/ru/settings#available-settings) работают в любой области. Несколько ключей читаются только из управляемых параметров и не имеют эффекта при размещении в файлах параметров пользователя или проекта. Смотрите [параметры только для управления](/ru/permissions#managed-only-settings) для полного списка. Любой параметр, не входящий в этот список, все еще может быть размещен в управляемых параметрах и имеет наивысший приоритет.133Большинство [ключей параметров](/docs/ru/settings#available-settings) работают в любой области. Несколько ключей читаются только из управляемых параметров и не имеют эффекта при размещении в файлах параметров пользователя или проекта. Смотрите [параметры только для управления](/docs/ru/permissions#managed-only-settings) для полного списка. Любой параметр, не входящий в этот список, все еще может быть размещен в управляемых параметрах и имеет наивысший приоритет.

134 134 

135<h3 id="current-limitations">135<h3 id="current-limitations">

136 Текущие ограничения136 Текущие ограничения


139Параметры, управляемые сервером, имеют следующие ограничения:139Параметры, управляемые сервером, имеют следующие ограничения:

140 140 

141* Параметры применяются одинаково ко всем пользователям в организации. Конфигурации для отдельных групп еще не поддерживаются.141* Параметры применяются одинаково ко всем пользователям в организации. Конфигурации для отдельных групп еще не поддерживаются.

142* Файл [`managed-mcp.json`](/ru/managed-mcp) не может распространяться через параметры, управляемые сервером. Вместо этого доставьте там ключи политики `allowedMcpServers` и `deniedMcpServers`.142* Файл [`managed-mcp.json`](/docs/ru/managed-mcp) не может распространяться через параметры, управляемые сервером. Вместо этого доставьте там ключи политики `allowedMcpServers` и `deniedMcpServers`.

143* Параметры, ограниченные источниками политики на уровне ОС, такие как `policyHelper` и `wslInheritsWindowsSettings`, не учитываются. Разверните их через MDM или системный файл `managed-settings.json` вместо этого.143* Параметры, ограниченные источниками политики на уровне ОС, такие как `policyHelper` и `wslInheritsWindowsSettings`, не учитываются. Разверните их через MDM или системный файл `managed-settings.json` вместо этого.

144 144 

145<h2 id="settings-delivery">145<h2 id="settings-delivery">


150 Приоритет параметров150 Приоритет параметров

151</h3>151</h3>

152 152 

153Параметры, управляемые сервером, и [параметры, управляемые конечной точкой](/ru/settings#settings-files) занимают наивысший уровень в [иерархии параметров](/ru/settings#settings-precedence) Claude Code. Никакой другой уровень параметров не может их переопределить, включая аргументы командной строки.153Параметры, управляемые сервером, и [параметры, управляемые конечной точкой](/docs/ru/settings#settings-files) занимают наивысший уровень в [иерархии параметров](/docs/ru/settings#settings-precedence) Claude Code. Никакой другой уровень параметров не может их переопределить, включая аргументы командной строки.

154 154 

155В пределах управляемого уровня настроенный [`policyHelper`](/ru/settings#compute-managed-settings-with-a-policy-helper) имеет приоритет над всеми другими управляемыми источниками, включая параметры, управляемые сервером: его вывод становится единственной управляемой конфигурацией для запуска.155В пределах управляемого уровня настроенный [`policyHelper`](/docs/ru/settings#compute-managed-settings-with-a-policy-helper) имеет приоритет над всеми другими управляемыми источниками, включая параметры, управляемые сервером: его вывод становится единственной управляемой конфигурацией для запуска.

156 156 

157В противном случае Claude Code использует первый источник, который доставляет непустую конфигурацию. Параметры, управляемые сервером, проверяются первыми, затем параметры, управляемые конечной точкой. Источники не объединяются: если параметры, управляемые сервером, доставляют какие-либо ключи вообще, другие параметры, управляемые конечной точкой, игнорируются. Если параметры, управляемые сервером, не доставляют ничего, применяются параметры, управляемые конечной точкой.157В противном случае Claude Code использует первый источник, который доставляет непустую конфигурацию. Параметры, управляемые сервером, проверяются первыми, затем параметры, управляемые конечной точкой. Источники не объединяются: если параметры, управляемые сервером, доставляют какие-либо ключи вообще, другие параметры, управляемые конечной точкой, игнорируются. Если параметры, управляемые сервером, не доставляют ничего, применяются параметры, управляемые конечной точкой.

158 158 

159Применяется одно исключение: небольшой набор [ключей блокировки между источниками](/ru/settings#settings-precedence), таких как блокировки списка разрешений песочницы, соблюдается, когда любой управляемый администратором источник их устанавливает; уровень реестра HKCU, доступный для записи пользователем, исключен.159Применяется одно исключение: небольшой набор [ключей блокировки между источниками](/docs/ru/settings#settings-precedence), таких как блокировки списка разрешений песочницы, соблюдается, когда любой управляемый администратором источник их устанавливает; уровень реестра HKCU, доступный для записи пользователем, исключен.

160 160 

161Если вы очищаете конфигурацию, управляемую сервером, в консоли администратора с намерением вернуться к управляемому plist или политике реестра, управляемой конечной точкой, имейте в виду, что [кэшированные параметры](#fetch-and-caching-behavior) сохраняются на клиентских машинах до следующей успешной выборки. Запустите `/status` для просмотра того, какой управляемый источник активен.161Если вы очищаете конфигурацию, управляемую сервером, в консоли администратора с намерением вернуться к управляемому plist или политике реестра, управляемой конечной точкой, имейте в виду, что [кэшированные параметры](#fetch-and-caching-behavior) сохраняются на клиентских машинах до следующей успешной выборки. Запустите `/status` для просмотра того, какой управляемый источник активен.

162 162 


178* Claude Code выбирает свежие параметры в фоновом режиме178* Claude Code выбирает свежие параметры в фоновом режиме

179* Кэшированные параметры сохраняются при сбоях сети. Удерживаемые переменные окружения остаются удерживаемыми до тех пор, пока выборка не будет успешной179* Кэшированные параметры сохраняются при сбоях сети. Удерживаемые переменные окружения остаются удерживаемыми до тех пор, пока выборка не будет успешной

180 180 

181Начиная с версии 2.1.198, Claude Code удерживает три категории переменных в кэшированном блоке `env` до тех пор, пока сервер не подтвердит полезную нагрузку для сеанса. Это предотвращает перенаправление, перехват или повторную аутентификацию кэшированного прокси, центра сертификации, конечной точки или значения учетных данных при выборке параметров, которая подтверждает полезную нагрузку. Усиление применяется только к кэшу параметров, полученных с сервера: [параметры, управляемые конечной точкой](/ru/settings#settings-files), развернутые через MDM или `managed-settings.json`, не затронуты. Удерживаемые категории:181Начиная с версии 2.1.198, Claude Code удерживает три категории переменных в кэшированном блоке `env` до тех пор, пока сервер не подтвердит полезную нагрузку для сеанса. Это предотвращает перенаправление, перехват или повторную аутентификацию кэшированного прокси, центра сертификации, конечной точки или значения учетных данных при выборке параметров, которая подтверждает полезную нагрузку. Усиление применяется только к кэшу параметров, полученных с сервера: [параметры, управляемые конечной точкой](/docs/ru/settings#settings-files), развернутые через MDM или `managed-settings.json`, не затронуты. Удерживаемые категории:

182 182 

183* Конфигурация прокси и TLS, такая как `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` и переменные сертификата клиента mTLS `CLAUDE_CODE_CLIENT_CERT` и `CLAUDE_CODE_CLIENT_KEY`183* Конфигурация прокси и TLS, такая как `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` и переменные сертификата клиента mTLS `CLAUDE_CODE_CLIENT_CERT` и `CLAUDE_CODE_CLIENT_KEY`

184* Маршрутизация API и выбор поставщика, включая `ANTHROPIC_BASE_URL`, переменные выбора поставщика, такие как `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_VERTEX`, и URL-адреса конечных точек поставщика, такие как `ANTHROPIC_BEDROCK_BASE_URL`184* Маршрутизация API и выбор поставщика, включая `ANTHROPIC_BASE_URL`, переменные выбора поставщика, такие как `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_VERTEX`, и URL-адреса конечных точек поставщика, такие как `ANTHROPIC_BEDROCK_BASE_URL`


186 186 

187Каждый другой ключ в кэшированном блоке `env`, такой как телеметрия и конфигурация OpenTelemetry, применяется при запуске, как и раньше. После успешной выборки удерживаемые переменные применяются для остальной части сеанса.187Каждый другой ключ в кэшированном блоке `env`, такой как телеметрия и конфигурация OpenTelemetry, применяется при запуске, как и раньше. После успешной выборки удерживаемые переменные применяются для остальной части сеанса.

188 188 

189Если вашей организации требуется прокси для доступа к `api.anthropic.com`, установите его в окружении оболочки или в [параметрах пользователя](/ru/settings#settings-files), а не только в управляемом блоке `env`. Первый запуск не имеет кэша, поэтому эти источники уже требовались для начальной выборки.189Если вашей организации требуется прокси для доступа к `api.anthropic.com`, установите его в окружении оболочки или в [параметрах пользователя](/docs/ru/settings#settings-files), а не только в управляемом блоке `env`. Первый запуск не имеет кэша, поэтому эти источники уже требовались для начальной выборки.

190 190 

191Claude Code применяет обновления параметров автоматически без перезагрузки, за исключением расширенных параметров, таких как конфигурация OpenTelemetry, которые требуют полной перезагрузки для вступления в силу.191Claude Code применяет обновления параметров автоматически без перезагрузки, за исключением расширенных параметров, таких как конфигурация OpenTelemetry, которые требуют полной перезагрузки для вступления в силу.

192 192 


194 Недопустимые записи в доставленных параметрах194 Недопустимые записи в доставленных параметрах

195</h3>195</h3>

196 196 

197Доставленные полезные нагрузки анализируются с допуском, используя те же правила, что и другие управляемые источники. Когда полезная нагрузка содержит запись, которая не проходит проверку схемы, Claude Code удаляет эту запись, выводит ошибку валидации и применяет все оставшиеся допустимые параметры. См. [Недопустимые записи в управляемых параметрах](/ru/settings#invalid-entries-in-managed-settings) для поведения на уровне полей, включая то, как обрабатываются поля принудительного применения безопасности. Требуется Claude Code v2.1.169 или более поздняя версия.197Доставленные полезные нагрузки анализируются с допуском, используя те же правила, что и другие управляемые источники. Когда полезная нагрузка содержит запись, которая не проходит проверку схемы, Claude Code удаляет эту запись, выводит ошибку валидации и применяет все оставшиеся допустимые параметры. См. [Недопустимые записи в управляемых параметрах](/docs/ru/settings#invalid-entries-in-managed-settings) для поведения на уровне полей, включая то, как обрабатываются поля принудительного применения безопасности. Требуется Claude Code v2.1.169 или более поздняя версия.

198 198 

199Доставка, управляемая сервером, добавляет следующие поведения:199Доставка, управляемая сервером, добавляет следующие поведения:

200 200 


220}220}

221```221```

222 222 

223Вы также можете установить этот ключ в [управляемый конечной точкой](/ru/settings#settings-files) профиль MDM или системный файл `managed-settings.json` для принудительного применения поведения fail-closed при первом запуске, до того как будет доставлена какая-либо полезная нагрузка сервера. Начиная с версии 2.1.191, этот флаг является исключением из [правила приоритета](#settings-precedence) выше: он соблюдается при установке в любом управляемом источнике, даже если также присутствует кэшированная полезная нагрузка, управляемая сервером, поэтому значение, доставленное MDM, не игнорируется, когда существуют параметры, управляемые сервером.223Вы также можете установить этот ключ в [управляемый конечной точкой](/docs/ru/settings#settings-files) профиль MDM или системный файл `managed-settings.json` для принудительного применения поведения fail-closed при первом запуске, до того как будет доставлена какая-либо полезная нагрузка сервера. Начиная с версии 2.1.191, этот флаг является исключением из [правила приоритета](#settings-precedence) выше: он соблюдается при установке в любом управляемом источнике, даже если также присутствует кэшированная полезная нагрузка, управляемая сервером, поэтому значение, доставленное MDM, не игнорируется, когда существуют параметры, управляемые сервером.

224 224 

225Выборка параметров также отправляет заголовок `Cache-Control: no-cache`, чтобы промежуточные HTTP-прокси не обслуживали устаревший ответ.225Выборка параметров также отправляет заголовок `Cache-Control: no-cache`, чтобы промежуточные HTTP-прокси не обслуживали устаревший ответ.

226 226 


249 Доступность платформы249 Доступность платформы

250</h2>250</h2>

251 251 

252Параметры, управляемые сервером, требуют прямого подключения к `api.anthropic.com`, и доставка требует, чтобы сеанс аутентифицировался с помощью входа в организацию OAuth или напрямую настроенного ключа API. Ключи, возвращаемые скриптом [`apiKeyHelper`](/ru/settings#available-settings), не запускают выборку параметров.252Параметры, управляемые сервером, требуют прямого подключения к `api.anthropic.com`, и доставка требует, чтобы сеанс аутентифицировался с помощью входа в организацию OAuth или напрямую настроенного ключа API. Ключи, возвращаемые скриптом [`apiKeyHelper`](/docs/ru/settings#available-settings), не запускают выборку параметров.

253 253 

254Параметры, управляемые сервером, недоступны при использовании поставщиков моделей третьих сторон:254Параметры, управляемые сервером, недоступны при использовании поставщиков моделей третьих сторон:

255 255 

256* Amazon Bedrock256* Amazon Bedrock

257* Google Cloud's Agent Platform257* Google Cloud's Agent Platform

258* Microsoft Foundry258* Microsoft Foundry

259* [Claude Platform on AWS](/ru/claude-platform-on-aws)259* [Claude Platform on AWS](/docs/ru/claude-platform-on-aws)

260* Пользовательские конечные точки API через `ANTHROPIC_BASE_URL` или [LLM gateways](/ru/llm-gateway)260* Пользовательские конечные точки API через `ANTHROPIC_BASE_URL` или [LLM gateways](/docs/ru/llm-gateway)

261 261 

262Если вы экспортируете переменную поставщика `CLAUDE_CODE_USE_*` или нестандартный `ANTHROPIC_BASE_URL` в вашей оболочке, Claude Code пропускает выборку параметров для ваших сеансов. Вы не можете очистить экспорт с помощью управляемого сервером блока `env`, потому что блок поступает через выборку, которую экспорт предотвращает. Управляемый конечной точкой блок параметров `env` также не восстанавливает выборку: Claude Code проверяет приемлемость перед применением управляемых блоков `env`, поэтому переопределение изменяет выбор поставщика сеанса, но выборка остается пропущенной.262Если вы экспортируете переменную поставщика `CLAUDE_CODE_USE_*` или нестандартный `ANTHROPIC_BASE_URL` в вашей оболочке, Claude Code пропускает выборку параметров для ваших сеансов. Вы не можете очистить экспорт с помощью управляемого сервером блока `env`, потому что блок поступает через выборку, которую экспорт предотвращает. Управляемый конечной точкой блок параметров `env` также не восстанавливает выборку: Claude Code проверяет приемлемость перед применением управляемых блоков `env`, поэтому переопределение изменяет выбор поставщика сеанса, но выборка остается пропущенной.

263 263 

264Чтобы восстановить доставку, управляемую сервером, удалите экспорт из вашей оболочки или установите переменную на `""` в блоке `env` пользовательских параметров, который применяется перед проверкой приемлемости. Чтобы обеспечить политику без полагания на пользователей для изменения их оболочек, доставляйте параметры через управляемый конечной точкой канал вместо этого.264Чтобы восстановить доставку, управляемую сервером, удалите экспорт из вашей оболочки или установите переменную на `""` в блоке `env` пользовательских параметров, который применяется перед проверкой приемлемости. Чтобы обеспечить политику без полагания на пользователей для изменения их оболочек, доставляйте параметры через управляемый конечной точкой канал вместо этого.

265 265 

266Для развертываний Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry самостоятельно размещаемый [Claude apps gateway](/ru/claude-apps-gateway) обеспечивает эквивалентную доставку удаленных управляемых параметров: клиенты, вошедшие в шлюз, получают управляемые параметры из шлюза вместо `api.anthropic.com`. Семантика отказов отличается при запуске: клиент шлюза, который не может достичь шлюз, завершает работу с ошибкой вместо возврата к кэшированным параметрам, в то время как почасовое фоновое обновление открыто при отказе на обоих каналах.266Для развертываний Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry самостоятельно размещаемый [Claude apps gateway](/docs/ru/claude-apps-gateway) обеспечивает эквивалентную доставку удаленных управляемых параметров: клиенты, вошедшие в шлюз, получают управляемые параметры из шлюза вместо `api.anthropic.com`. Семантика отказов отличается при запуске: клиент шлюза, который не может достичь шлюз, завершает работу с ошибкой вместо возврата к кэшированным параметрам, в то время как почасовое фоновое обновление открыто при отказе на обоих каналах.

267 267 

268<h2 id="audit-logging">268<h2 id="audit-logging">

269 Аудит логирования269 Аудит логирования


280Параметры, управляемые сервером, обеспечивают централизованное применение политики, но они работают как элемент управления на стороне клиента, а не как граница безопасности. На неуправляемых устройствах пользователю не требуется доступ администратора или sudo для их обхода.280Параметры, управляемые сервером, обеспечивают централизованное применение политики, но они работают как элемент управления на стороне клиента, а не как граница безопасности. На неуправляемых устройствах пользователю не требуется доступ администратора или sudo для их обхода.

281 281 

282| Сценарий | Поведение |282| Сценарий | Поведение |

283| :------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |283| :------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

284| Пользователь редактирует кэшированный файл параметров | Измененный файл применяется при запуске, но правильные параметры восстанавливаются при следующей выборке с сервера. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, переменные окружения транспорта, маршрутизации API и аутентификации в блоке `env` [удерживаются до подтверждения сервером полезной нагрузки](#fetch-and-caching-behavior) |284| Пользователь редактирует кэшированный файл параметров | Измененный файл применяется при запуске, но правильные параметры восстанавливаются при следующей выборке с сервера. Начиная с версии 2.1.198, переменные окружения транспорта, маршрутизации API и аутентификации в блоке `env` [удерживаются до подтверждения сервером полезной нагрузки](#fetch-and-caching-behavior) |

285| Пользователь удаляет кэшированный файл параметров | Происходит поведение первого запуска: параметры выбираются асинхронно с кратким неприменяемым окном |285| Пользователь удаляет кэшированный файл параметров | Происходит поведение первого запуска: параметры выбираются асинхронно с кратким неприменяемым окном |

286| Пользователь запускает измененный двоичный файл Claude Code | Пользователь, который может запустить измененный клиент, может обойти любой элемент управления на стороне клиента |286| Пользователь запускает измененный двоичный файл Claude Code | Пользователь, который может запустить измененный клиент, может обойти любой элемент управления на стороне клиента |

287| Пользователь запускает более старую версию Claude Code | Версии, которые предшествуют параметрам, управляемым сервером, не выбирают и не применяют их |287| Пользователь запускает более старую версию Claude Code | Версии, которые предшествуют параметрам, управляемым сервером, не выбирают и не применяют их |

288| API недоступен | Кэшированные параметры применяются, если доступны, в противном случае управляемые параметры не применяются до следующей успешной выборки. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, переменные окружения транспорта, маршрутизации API и аутентификации в кэшированном блоке `env` [удерживаются при сбое выборки](#fetch-and-caching-behavior); остальная часть кэша все еще применяется. С `forceRemoteSettingsRefresh: true` CLI выходит вместо продолжения, за исключением [`claude auth` подкоманд](#enforce-fail-closed-startup) |288| API недоступен | Кэшированные параметры применяются, если доступны, в противном случае управляемые параметры не применяются до следующей успешной выборки. Начиная с версии 2.1.198, переменные окружения транспорта, маршрутизации API и аутентификации в кэшированном блоке `env` [удерживаются при сбое выборки](#fetch-and-caching-behavior); остальная часть кэша все еще применяется. С `forceRemoteSettingsRefresh: true` CLI выходит вместо продолжения, за исключением [`claude auth` подкоманд](#enforce-fail-closed-startup) |

289| Пользователь аутентифицируется с другой организацией | Параметры не доставляются для учетных записей вне управляемой организации |289| Пользователь аутентифицируется с другой организацией | Параметры не доставляются для учетных записей вне управляемой организации |

290| Пользователь настраивает [поставщика моделей третьей стороны](#platform-availability) | Параметры, управляемые сервером, обходятся. Это включает установку `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS` или нестандартного `ANTHROPIC_BASE_URL` |290| Пользователь настраивает [поставщика моделей третьей стороны](#platform-availability) | Параметры, управляемые сервером, обходятся. Это включает установку `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS` или нестандартного `ANTHROPIC_BASE_URL` |

291| Сетевой трафик перехватывается или перенаправляется | Отключенная проверка TLS или перехваченный трафик могут изменить параметры, которые получает клиент |291| Сетевой трафик перехватывается или перенаправляется | Отключенная проверка TLS или перехваченный трафик могут изменить параметры, которые получает клиент |

292 292 

293Для обнаружения изменений конфигурации во время выполнения используйте [`ConfigChange` hooks](/ru/hooks#configchange) для логирования изменений или блокировки несанкционированных изменений перед их вступлением в силу.293Для обнаружения изменений конфигурации во время выполнения используйте [`ConfigChange` hooks](/docs/ru/hooks#configchange) для логирования изменений или блокировки несанкционированных изменений перед их вступлением в силу.

294 294 

295Для ограничения организаций, к которым ваши пользователи могут получить доступ с учетными данными, которые предоставляет клиент, см. [Enforce network-level access control with Tenant Restrictions](https://support.claude.com/en/articles/13198485-enforce-network-level-access-control-with-tenant-restrictions) в Центре справки Claude. Для более сильных гарантий применения используйте [параметры, управляемые конечной точкой](/ru/settings#settings-files) на устройствах, зарегистрированных в решении MDM.295Для ограничения организаций, к которым ваши пользователи могут получить доступ с учетными данными, которые предоставляет клиент, см. [Enforce network-level access control with Tenant Restrictions](https://support.claude.com/en/articles/13198485-enforce-network-level-access-control-with-tenant-restrictions) в Центре справки Claude. Для более сильных гарантий применения используйте [параметры, управляемые конечной точкой](/docs/ru/settings#settings-files) на устройствах, зарегистрированных в решении MDM.

296 296 

297<h2 id="see-also">297<h2 id="see-also">

298 См. также298 См. также


300 300 

301Связанные страницы для управления конфигурацией Claude Code:301Связанные страницы для управления конфигурацией Claude Code:

302 302 

303* [Settings](/ru/settings): полный справочник конфигурации, включая все доступные параметры303* [Settings](/docs/ru/settings): полный справочник конфигурации, включая все доступные параметры

304* [Endpoint-managed settings](/ru/settings#settings-files): управляемые параметры, развертываемые на устройства IT304* [Endpoint-managed settings](/docs/ru/settings#settings-files): управляемые параметры, развертываемые на устройства IT

305* [Authentication](/ru/authentication): настройка доступа пользователей к Claude Code305* [Authentication](/docs/ru/authentication): настройка доступа пользователей к Claude Code

306* [Security](/ru/security): гарантии безопасности и лучшие практики306* [Security](/docs/ru/security): гарантии безопасности и лучшие практики

sessions.md +21 −21

Details

8 8 

9Сеанс — это сохранённый диалог, привязанный к каталогу проекта. Claude Code сохраняет его локально по мере работы, поэтому вы можете возобновить работу с того же места, создать ветвь для попытки другого подхода или переключаться между задачами.9Сеанс — это сохранённый диалог, привязанный к каталогу проекта. Claude Code сохраняет его локально по мере работы, поэтому вы можете возобновить работу с того же места, создать ветвь для попытки другого подхода или переключаться между задачами.

10 10 

11[Настольное приложение](/ru/desktop#work-in-parallel-with-sessions), [Claude Code в веб-версии](/ru/claude-code-on-the-web) и [расширение VS Code](/ru/vs-code#resume-past-conversations) каждое ведёт собственную историю сеансов. На этой странице рассматривается CLI.11[Настольное приложение](/docs/ru/desktop#work-in-parallel-with-sessions), [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) и [расширение VS Code](/docs/ru/vs-code#resume-past-conversations) каждое ведёт собственную историю сеансов. На этой странице рассматривается CLI.

12 12 

13<h2 id="resume-a-session">13<h2 id="resume-a-session">

14 Возобновление сеанса14 Возобновление сеанса


24| `claude --from-pr <number>` | Возобновляет сеанс, связанный с этим pull request |24| `claude --from-pr <number>` | Возобновляет сеанс, связанный с этим pull request |

25| `/resume` | Переключается на другой диалог из активного сеанса |25| `/resume` | Переключается на другой диалог из активного сеанса |

26 26 

27Сеансы, созданные с помощью [`claude -p`](/ru/headless) или [Agent SDK](/ru/agent-sdk/overview), не отображаются в средстве выбора сеансов, но вы всё равно можете возобновить один, передав его ID сеанса в `claude --resume <session-id>`. Запустите это из каталога, в котором был запущен сеанс: поиск ID сеанса ограничен текущим каталогом проекта и его git worktrees, поэтому сеанс, созданный в другом месте, сообщает `No conversation found with session ID: <session-id>`.27Сеансы, созданные с помощью [`claude -p`](/docs/ru/headless) или [Agent SDK](/docs/ru/agent-sdk/overview), не отображаются в средстве выбора сеансов, но вы всё равно можете возобновить один, передав его ID сеанса в `claude --resume <session-id>`. Запустите это из каталога, в котором был запущен сеанс: поиск ID сеанса ограничен текущим каталогом проекта и его git worktrees, поэтому сеанс, созданный в другом месте, сообщает `No conversation found with session ID: <session-id>`.

28 28 

29<h3 id="where-the-session-picker-looks">29<h3 id="where-the-session-picker-looks">

30 Где средство выбора сеансов ищет сеансы30 Где средство выбора сеансов ищет сеансы


32 32 

33Сеансы хранятся для каждого каталога проекта. По умолчанию средство выбора сеансов показывает интерактивные сеансы из текущего worktree, а также сеансы, запущенные в других местах, которые добавили текущий каталог с помощью `/add-dir`. Используйте `Ctrl+W` для расширения на все worktrees репозитория или `Ctrl+A` для расширения на каждый проект на этой машине.33Сеансы хранятся для каждого каталога проекта. По умолчанию средство выбора сеансов показывает интерактивные сеансы из текущего worktree, а также сеансы, запущенные в других местах, которые добавили текущий каталог с помощью `/add-dir`. Используйте `Ctrl+W` для расширения на все worktrees репозитория или `Ctrl+A` для расширения на каждый проект на этой машине.

34 34 

35{/* min-version: 2.1.169 */}Начиная с версии 2.1.169, перемещение сеанса с помощью [`/cd`](/ru/commands) переносит его в хранилище проекта нового каталога, поэтому он появляется в средстве выбора этого каталога впоследствии. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, перемещённый сеанс остаётся вне средства выбора старого каталога даже после сбоя или принудительного выхода. В более ранних версиях он также мог повторно появиться в списке старого каталога после выхода, который не был чистым, когда старый путь содержал специальные символы, такие как подчёркивания.35Начиная с версии 2.1.169, перемещение сеанса с помощью [`/cd`](/docs/ru/commands) переносит его в хранилище проекта нового каталога, поэтому он появляется в средстве выбора этого каталога впоследствии. Начиная с версии 2.1.196, перемещённый сеанс остаётся вне средства выбора старого каталога даже после сбоя или принудительного выхода. В более ранних версиях он также мог повторно появиться в списке старого каталога после выхода, который не был чистым, когда старый путь содержал специальные символы, такие как подчёркивания.

36 36 

37Выбор сеанса из другого worktree того же репозитория возобновляет его на месте. Выбор сеанса из несвязанного проекта копирует команду `cd` и команду возобновления в буфер обмена.37Выбор сеанса из другого worktree того же репозитория возобновляет его на месте. Выбор сеанса из несвязанного проекта копирует команду `cd` и команду возобновления в буфер обмена.

38 38 


54| При запуске | `claude -n auth-refactor` |54| При запуске | `claude -n auth-refactor` |

55| Во время сеанса | `/rename auth-refactor`. Имя также отображается на панели подсказок |55| Во время сеанса | `/rename auth-refactor`. Имя также отображается на панели подсказок |

56| Из средства выбора сеансов | Выделите сеанс и нажмите `Ctrl+R` |56| Из средства выбора сеансов | Выделите сеанс и нажмите `Ctrl+R` |

57| При принятии плана | Принятие плана в [режиме плана](/ru/permission-modes#analyze-before-you-edit-with-plan-mode) называет сеанс на основе содержимого плана, если вы ещё не установили имя |57| При принятии плана | Принятие плана в [режиме плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) называет сеанс на основе содержимого плана, если вы ещё не установили имя |

58 58 

59После того как сеанс назван, вернитесь к нему с помощью `claude --resume <name>` или `/resume <name>`. См. [Возобновление сеанса](#resume-a-session) для информации о том, как разрешение имён работает в worktrees.59После того как сеанс назван, вернитесь к нему с помощью `claude --resume <name>` или `/resume <name>`. См. [Возобновление сеанса](#resume-a-session) для информации о том, как разрешение имён работает в worktrees.

60 60 

61{/* min-version: 2.1.196 */}Интерактивные сеансы, которые вы никогда не называете, всё равно получают имя отображения по умолчанию при запуске. Требуется Claude Code v2.1.196 или более поздняя версия. По умолчанию используется комбинация имени рабочего каталога с двухсимвольным суффиксом, например `my-app-3f`, и идентифицирует сеанс в списках запущенных сеансов, таких как [представление агента](/ru/agent-view) и вывод `claude agents --json`.61Интерактивные сеансы, которые вы никогда не называете, всё равно получают имя отображения по умолчанию при запуске. Требуется Claude Code v2.1.196 или более поздняя версия. По умолчанию используется комбинация имени рабочего каталога с двухсимвольным суффиксом, например `my-app-3f`, и идентифицирует сеанс в списках запущенных сеансов, таких как [представление агента](/docs/ru/agent-view) и вывод `claude agents --json`.

62 62 

63Значение по умолчанию не является дескриптором возобновления: `claude --resume <name>`, `/resume <name>` и средство выбора сеансов совпадают только с именами, которые вы установили. Именование сеанса заменяет значение по умолчанию.63Значение по умолчанию не является дескриптором возобновления: `claude --resume <name>`, `/resume <name>` и средство выбора сеансов совпадают только с именами, которые вы установили. Именование сеанса заменяет значение по умолчанию.

64 64 


97/branch try-streaming-approach97/branch try-streaming-approach

98```98```

99 99 

100Если вы опустите имя, Claude Code назовёт новую ветвь в соответствии с первым запросом в диалоге. Начиная с версии v2.1.198 это также применяется после [compaction](/ru/how-claude-code-works#when-context-fills-up); более ранние версии вместо этого использовали буквальное имя `Branched conversation` вместо того, чтобы смотреть дальше сводки compaction на исходный первый запрос.100Если вы опустите имя, Claude Code назовёт новую ветвь в соответствии с первым запросом в диалоге. Начиная с версии v2.1.198 это также применяется после [compaction](/docs/ru/how-claude-code-works#when-context-fills-up); более ранние версии вместо этого использовали буквальное имя `Branched conversation` вместо того, чтобы смотреть дальше сводки compaction на исходный первый запрос.

101 101 

102Из командной строки объедините `--continue` или `--resume` с `--fork-session`:102Из командной строки объедините `--continue` или `--resume` с `--fork-session`:

103 103 


107 107 

108Исходный сеанс остаётся неизменным и остаётся доступным в средстве выбора сеансов. Подтверждение `/branch` выводит два ID сеанса: новую ветвь, в которой вы находитесь, и оригинал. Чтобы вернуться к оригиналу, передайте его ID в `/resume`, используйте средство выбора сеансов или запустите `/resume <original-name>`. Разрешения, которые вы одобрили с помощью "allow for this session", не переносятся на новую ветвь. Если вы возобновите один и тот же сеанс в двух терминалах без разветвления, сообщения из обоих будут чередоваться в одной стенограмме.108Исходный сеанс остаётся неизменным и остаётся доступным в средстве выбора сеансов. Подтверждение `/branch` выводит два ID сеанса: новую ветвь, в которой вы находитесь, и оригинал. Чтобы вернуться к оригиналу, передайте его ID в `/resume`, используйте средство выбора сеансов или запустите `/resume <original-name>`. Разрешения, которые вы одобрили с помощью "allow for this session", не переносятся на новую ветвь. Если вы возобновите один и тот же сеанс в двух терминалах без разветвления, сообщения из обоих будут чередоваться в одной стенограмме.

109 109 

110Для перемотки на основе контрольных точек в одном сеансе см. [Checkpointing](/ru/checkpointing).110Для перемотки на основе контрольных точек в одном сеансе см. [Checkpointing](/docs/ru/checkpointing).

111 111 

112<h2 id="manage-context-within-a-session">112<h2 id="manage-context-within-a-session">

113 Управление контекстом в сеансе113 Управление контекстом в сеансе


115 115 

116Эти команды управляют тем, что находится в окне контекста, не покидая сеанс:116Эти команды управляют тем, что находится в окне контекста, не покидая сеанс:

117 117 

118* **`/clear`**: начать заново с пустым контекстом. Предыдущий диалог сохраняется и может быть возобновлен с помощью `/resume`, или, в том же процессе Claude Code, {/* min-version: 2.1.191 */}из [записи предыдущего сеанса меню перемотки](/ru/checkpointing#rewind-past-a-cleared-conversation)118* **`/clear`**: начать заново с пустым контекстом. Предыдущий диалог сохраняется и может быть возобновлен с помощью `/resume`, или, в том же процессе Claude Code, из [записи предыдущего сеанса меню перемотки](/docs/ru/checkpointing#rewind-past-a-cleared-conversation)

119* **`/compact [instructions]`**: заменить историю сводкой, опционально сосредоточенной на том, что вы указали119* **`/compact [instructions]`**: заменить историю сводкой, опционально сосредоточенной на том, что вы указали

120* **`/context`**: показать, что в настоящее время потребляет контекст120* **`/context`**: показать, что в настоящее время потребляет контекст

121 121 

122О том, как уплотнение взаимодействует с CLAUDE.md, skills и правилами, см. [руководство по окну контекста](/ru/context-window). Для стратегий о том, когда очищать или уплотнять, см. [Best practices](/ru/best-practices#manage-your-session).122О том, как уплотнение взаимодействует с CLAUDE.md, skills и правилами, см. [руководство по окну контекста](/docs/ru/context-window). Для стратегий о том, когда очищать или уплотнять, см. [Best practices](/docs/ru/best-practices#manage-your-session).

123 123 

124<h2 id="export-and-locate-session-data">124<h2 id="export-and-locate-session-data">

125 Экспорт и поиск данных сеанса125 Экспорт и поиск данных сеанса


133 133 

134`/export` создает отформатированную стенограмму для чтения человеком. Интерфейсы ниже создают структурированные данные для анализа скриптом: результат JSON из запуска, путь к файлу стенограммы сеанса или живой поток событий. Выбирайте в зависимости от того, что запускает скрипт:134`/export` создает отформатированную стенограмму для чтения человеком. Интерфейсы ниже создают структурированные данные для анализа скриптом: результат JSON из запуска, путь к файлу стенограммы сеанса или живой поток событий. Выбирайте в зависимости от того, что запускает скрипт:

135 135 

136* **Запустить Claude один раз и захватить результат**: вызовите `claude -p` с [`--output-format json` или `stream-json`](/ru/headless#get-structured-output), чтобы захватить результат, ID сеанса, использование и стоимость неинтерактивного запуска как структурированный JSON.136* **Запустить Claude один раз и захватить результат**: вызовите `claude -p` с [`--output-format json` или `stream-json`](/docs/ru/headless#get-structured-output), чтобы захватить результат, ID сеанса, использование и стоимость неинтерактивного запуска как структурированный JSON.

137* **Задать вопрос существующему сеансу**: передайте ID сеанса в [`claude -p --resume`](/ru/headless#continue-conversations), чтобы отправить дополнительный запрос, например запрос на резюме, и захватить структурированный ответ.137* **Задать вопрос существующему сеансу**: передайте ID сеанса в [`claude -p --resume`](/docs/ru/headless#continue-conversations), чтобы отправить дополнительный запрос, например запрос на резюме, и захватить структурированный ответ.

138* **Реагировать на события сеанса**: прочитайте поле `transcript_path`, которое получают [hooks](/ru/hooks#common-input-fields) и [команды строки состояния](/ru/statusline#available-data) в качестве входных данных. Hook `SessionEnd` может архивировать стенограмму при завершении сеанса.138* **Реагировать на события сеанса**: прочитайте поле `transcript_path`, которое получают [hooks](/docs/ru/hooks#common-input-fields) и [команды строки состояния](/docs/ru/statusline#available-data) в качестве входных данных. Hook `SessionEnd` может архивировать стенограмму при завершении сеанса.

139* **Встроить Claude в приложение TypeScript или Python**: используйте [Agent SDK](/ru/agent-sdk/overview) для получения каждого сообщения программным способом.139* **Встроить Claude в приложение TypeScript или Python**: используйте [Agent SDK](/docs/ru/agent-sdk/overview) для получения каждого сообщения программным способом.

140 140 

141Пример ниже использует второй интерфейс. Он отправляет дополнительный запрос существующему сеансу и читает ответ с помощью `jq`:141Пример ниже использует второй интерфейс. Он отправляет дополнительный запрос существующему сеансу и читает ответ с помощью `jq`:

142 142 


154 154 

155| Для | Установить | Где |155| Для | Установить | Где |

156| --------------------------------------------------- | ------------------------------------------------------ | ---------------------- |156| --------------------------------------------------- | ------------------------------------------------------ | ---------------------- |

157| Переместить хранилище с `~/.claude` | [`CLAUDE_CONFIG_DIR`](/ru/env-vars) | Переменная окружения |157| Переместить хранилище с `~/.claude` | [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars) | Переменная окружения |

158| Изменить сохранение на 30 дней | [`cleanupPeriodDays`](/ru/settings#available-settings) | `settings.json` |158| Изменить сохранение на 30 дней | [`cleanupPeriodDays`](/docs/ru/settings#available-settings) | `settings.json` |

159| Подавить запись стенограмм во всех режимах | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ru/env-vars) | Переменная окружения |159| Подавить запись стенограмм во всех режимах | [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars) | Переменная окружения |

160| Подавить запись для одного неинтерактивного запуска | [`--no-session-persistence`](/ru/cli-reference) | Флаг CLI с `claude -p` |160| Подавить запись для одного неинтерактивного запуска | [`--no-session-persistence`](/docs/ru/cli-reference) | Флаг CLI с `claude -p` |

161 161 

162<h2 id="see-also">162<h2 id="see-also">

163 См. также163 См. также


165 165 

166На этих страницах рассматриваются связанные механики сеансов и параллелизма:166На этих страницах рассматриваются связанные механики сеансов и параллелизма:

167 167 

168* [Worktrees](/ru/worktrees): запуск изолированных параллельных сеансов на отдельных ветвях168* [Worktrees](/docs/ru/worktrees): запуск изолированных параллельных сеансов на отдельных ветвях

169* [Checkpointing](/ru/checkpointing): перемотка кода и диалога к более ранней точке169* [Checkpointing](/docs/ru/checkpointing): перемотка кода и диалога к более ранней точке

170* [Context window](/ru/context-window): что заполняет контекст и что выживает при уплотнении170* [Context window](/docs/ru/context-window): что заполняет контекст и что выживает при уплотнении

171* [Non-interactive mode](/ru/headless): поведение сеанса в `claude -p`171* [Non-interactive mode](/docs/ru/headless): поведение сеанса в `claude -p`

settings.md +149 −149

Details

6 6 

7> Настройте Claude Code с помощью глобальных и проектных параметров, а также переменных окружения.7> Настройте Claude Code с помощью глобальных и проектных параметров, а также переменных окружения.

8 8 

9Claude Code предлагает множество параметров для настройки его поведения в соответствии с вашими потребностями. Вы можете настроить Claude Code, выполнив команду `/config`, которая открывает интерфейс параметров с вкладками, где вы можете просмотреть информацию о состоянии и изменить параметры конфигурации. {/* min-version: 2.1.181 */}Начиная с версии 2.1.181, вы можете изменить один параметр без открытия интерфейса, передав `key=value` в `/config`, например `/config verbose=true`.9Claude Code предлагает множество параметров для настройки его поведения в соответствии с вашими потребностями. Вы можете настроить Claude Code, выполнив команду `/config`, которая открывает интерфейс параметров с вкладками, где вы можете просмотреть информацию о состоянии и изменить параметры конфигурации. Начиная с версии 2.1.181, вы можете изменить один параметр без открытия интерфейса, передав `key=value` в `/config`, например `/config verbose=true`.

10 10 

11<h2 id="configuration-scopes">11<h2 id="configuration-scopes">

12 Области конфигурации12 Области конфигурации


96 * `.claude/settings.json` для параметров, которые проверяются в системе управления версиями и совместно используются с вашей командой96 * `.claude/settings.json` для параметров, которые проверяются в системе управления версиями и совместно используются с вашей командой

97 * `.claude/settings.local.json` для параметров, которые не проверяются, полезны для личных предпочтений и экспериментов. Когда Claude Code создает `.claude/settings.local.json`, он настраивает git на игнорирование файла. Если вы создаете файл самостоятельно, добавьте его в gitignore вручную.97 * `.claude/settings.local.json` для параметров, которые не проверяются, полезны для личных предпочтений и экспериментов. Когда Claude Code создает `.claude/settings.local.json`, он настраивает git на игнорирование файла. Если вы создаете файл самостоятельно, добавьте его в gitignore вручную.

98 98 

99 Поскольку этот файл принадлежит вам, а не репозиторию, его правила разрешения `allow` вступают в силу без этапа [доверия рабочей области](/ru/permissions#project-allow-rules-and-workspace-trust), который требуют правила разрешения `.claude/settings.json`. Если репозиторий предоставляет файл, например путем его фиксации, доверие рабочей области по-прежнему применяется.99 Поскольку этот файл принадлежит вам, а не репозиторию, его правила разрешения `allow` вступают в силу без этапа [доверия рабочей области](/docs/ru/permissions#project-allow-rules-and-workspace-trust), который требуют правила разрешения `.claude/settings.json`. Если репозиторий предоставляет файл, например путем его фиксации, доверие рабочей области по-прежнему применяется.

100* **Управляемые параметры**: Для организаций, которым требуется централизованное управление, Claude Code поддерживает несколько механизмов доставки управляемых параметров. Все используют один и тот же формат JSON и не могут быть переопределены параметрами пользователя или проекта:100* **Управляемые параметры**: Для организаций, которым требуется централизованное управление, Claude Code поддерживает несколько механизмов доставки управляемых параметров. Все используют один и тот же формат JSON и не могут быть переопределены параметрами пользователя или проекта:

101 101 

102 * **Параметры, управляемые сервером**: доставляются удаленно при входе либо с серверов Anthropic через консоль администратора claude.ai, либо с самостоятельно размещенного [Claude apps gateway](/ru/claude-apps-gateway). См. [параметры, управляемые сервером](/ru/server-managed-settings).102 * **Параметры, управляемые сервером**: доставляются удаленно при входе либо с серверов Anthropic через консоль администратора claude.ai, либо с самостоятельно размещенного [Claude apps gateway](/docs/ru/claude-apps-gateway). См. [параметры, управляемые сервером](/docs/ru/server-managed-settings).

103 * **Политики MDM/OS-уровня**: доставляются через встроенное управление устройствами на macOS и Windows:103 * **Политики MDM/OS-уровня**: доставляются через встроенное управление устройствами на macOS и Windows:

104 * macOS: домен управляемых предпочтений `com.anthropic.claudecode`. Ключи верхнего уровня plist отражают `managed-settings.json`, с вложенными параметрами как словари и массивы как plist массивы. Развертывание через профили конфигурации в Jamf, Iru (Kandji) или аналогичных инструментах MDM.104 * macOS: домен управляемых предпочтений `com.anthropic.claudecode`. Ключи верхнего уровня plist отражают `managed-settings.json`, с вложенными параметрами как словари и массивы как plist массивы. Развертывание через профили конфигурации в Jamf, Iru (Kandji) или аналогичных инструментах MDM.

105 * Windows: ключ реестра `HKLM\SOFTWARE\Policies\ClaudeCode` со значением `Settings` (REG\_SZ или REG\_EXPAND\_SZ), содержащим JSON (развернуто через групповую политику или Intune)105 * Windows: ключ реестра `HKLM\SOFTWARE\Policies\ClaudeCode` со значением `Settings` (REG\_SZ или REG\_EXPAND\_SZ), содержащим JSON (развернуто через групповую политику или Intune)


120 120 

121 Используйте числовые префиксы для управления порядком объединения, например `10-telemetry.json` и `20-security.json`.121 Используйте числовые префиксы для управления порядком объединения, например `10-telemetry.json` и `20-security.json`.

122 122 

123 См. [управляемые параметры](/ru/permissions#managed-only-settings) и [Управляемая конфигурация MCP](/ru/managed-mcp) для получения подробной информации.123 См. [управляемые параметры](/docs/ru/permissions#managed-only-settings) и [Управляемая конфигурация MCP](/docs/ru/managed-mcp) для получения подробной информации.

124 124 

125 Этот [репозиторий](https://github.com/anthropics/claude-code/tree/main/examples/mdm) включает начальные шаблоны развертывания для Jamf, Iru (Kandji), Intune и Group Policy. Используйте их как отправные точки и адаптируйте их в соответствии с вашими потребностями.125 Этот [репозиторий](https://github.com/anthropics/claude-code/tree/main/examples/mdm) включает начальные шаблоны развертывания для Jamf, Iru (Kandji), Intune и Group Policy. Используйте их как отправные точки и адаптируйте их в соответствии с вашими потребностями.

126 126 

127 <Note>127 <Note>

128 Управляемые развертывания также могут ограничивать **добавления на marketplace plugins** с помощью `strictKnownMarketplaces`. Для получения дополнительной информации см. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions).128 Управляемые развертывания также могут ограничивать **добавления на marketplace plugins** с помощью `strictKnownMarketplaces`. Для получения дополнительной информации см. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions).

129 </Note>129 </Note>

130* **Другая конфигурация** хранится в `~/.claude.json`. Этот файл содержит ваш сеанс OAuth, конфигурации [MCP server](/ru/mcp) для областей пользователя и локальной области, состояние для каждого проекта (разрешенные инструменты, параметры доверия) и различные кэши. MCP servers с областью проекта хранятся отдельно в `.mcp.json`.130* **Другая конфигурация** хранится в `~/.claude.json`. Этот файл содержит ваш сеанс OAuth, конфигурации [MCP server](/docs/ru/mcp) для областей пользователя и локальной области, состояние для каждого проекта (разрешенные инструменты, параметры доверия) и различные кэши. MCP servers с областью проекта хранятся отдельно в `.mcp.json`.

131 131 

132<Note>132<Note>

133 Claude Code автоматически создает резервные копии файлов конфигурации с временными метками и сохраняет пять самых последних резервных копий для предотвращения потери данных.133 Claude Code автоматически создает резервные копии файлов конфигурации с временными метками и сохраняет пять самых последних резервных копий для предотвращения потери данных.


169 Когда изменения вступают в силу169 Когда изменения вступают в силу

170</h3>170</h3>

171 171 

172Claude Code отслеживает ваши файлы параметров и перезагружает их при изменении, поэтому изменения большинства ключей применяются к текущему сеансу без перезагрузки. Это включает `permissions`, `hooks` и помощники учетных данных, такие как `apiKeyHelper`. Перезагрузка охватывает параметры пользователя, проекта, локальные и управляемые параметры, и [hook `ConfigChange`](/ru/hooks#configchange) срабатывает для каждого обнаруженного изменения.172Claude Code отслеживает ваши файлы параметров и перезагружает их при изменении, поэтому изменения большинства ключей применяются к текущему сеансу без перезагрузки. Это включает `permissions`, `hooks` и помощники учетных данных, такие как `apiKeyHelper`. Перезагрузка охватывает параметры пользователя, проекта, локальные и управляемые параметры, и [hook `ConfigChange`](/docs/ru/hooks#configchange) срабатывает для каждого обнаруженного изменения.

173 173 

174Несколько ключей читаются один раз при запуске сеанса и применяются при следующей перезагрузке:174Несколько ключей читаются один раз при запуске сеанса и применяются при следующей перезагрузке:

175 175 

176* `model`: используйте [`/model`](/ru/model-config#setting-your-model) для переключения в середине сеанса176* `model`: используйте [`/model`](/docs/ru/model-config#setting-your-model) для переключения в середине сеанса

177* [`outputStyle`](/ru/output-styles): часть системного запроса, который перестраивается на `/clear` или перезагрузке177* [`outputStyle`](/docs/ru/output-styles): часть системного запроса, который перестраивается на `/clear` или перезагрузке

178 178 

179<h3 id="invalid-entries-in-managed-settings">179<h3 id="invalid-entries-in-managed-settings">

180 Недействительные записи в управляемых параметрах180 Недействительные записи в управляемых параметрах

181</h3>181</h3>

182 182 

183Управляемые параметры анализируются с допуском. Когда управляемая конфигурация содержит запись, которая не проходит валидацию схемы, Claude Code удаляет эту запись, записывает предупреждение и применяет каждую оставшуюся действительную политику. Одна опечатка не может отключить остальную политику вашей организации. Запустите [`/doctor`](/ru/debug-your-config#check-resolved-settings), чтобы увидеть список удаленных записей с их исходным файлом и полем.183Управляемые параметры анализируются с допуском. Когда управляемая конфигурация содержит запись, которая не проходит валидацию схемы, Claude Code удаляет эту запись, записывает предупреждение и применяет каждую оставшуюся действительную политику. Одна опечатка не может отключить остальную политику вашей организации. Запустите [`/doctor`](/docs/ru/debug-your-config#check-resolved-settings), чтобы увидеть список удаленных записей с их исходным файлом и полем.

184 184 

185Это поведение согласуется во всех трех механизмах доставки: [параметры, управляемые сервером](/ru/server-managed-settings), политики plist и реестра, развернутые через MDM, и файлы `managed-settings.json`. Требует Claude Code v2.1.169 или позже.185Это поведение согласуется во всех трех механизмах доставки: [параметры, управляемые сервером](/docs/ru/server-managed-settings), политики plist и реестра, развернутые через MDM, и файлы `managed-settings.json`. Требует Claude Code v2.1.169 или позже.

186 186 

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

188 188 

189| Поле | Поведение при наличии, но недействительности |189| Поле | Поведение при наличии, но недействительности |

190| :--------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |190| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

191| `allowedMcpServers` | Применяется как пустой список разрешений, поэтому MCP servers не допускаются до исправления значения. Отдельная недействительная запись удаляется и применяется действительное подмножество. |191| `allowedMcpServers` | Применяется как пустой список разрешений, поэтому MCP servers не допускаются до исправления значения. Отдельная недействительная запись удаляется и применяется действительное подмножество. |

192| `allowManagedMcpServersOnly` | Обрабатывается как `true`. |192| `allowManagedMcpServersOnly` | Обрабатывается как `true`. |

193| `availableModels` | {/* min-version: 2.1.175 */}Применяется как пустой список разрешений, поэтому доступна только модель Default до исправления значения. Отдельная запись, не являющаяся строкой, удаляется и применяется действительное подмножество. Применяется в v2.1.175 и позже. |193| `availableModels` | Применяется как пустой список разрешений, поэтому доступна только модель Default до исправления значения. Отдельная запись, не являющаяся строкой, удаляется и применяется действительное подмножество. Применяется в v2.1.175 и позже. |

194| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Обрабатывается как `true`. Применяется в v2.1.175 и позже. |194| `enforceAvailableModels` | Обрабатывается как `true`. Применяется в v2.1.175 и позже. |

195| `forceLoginOrgUUID` | Ни одна организация не может войти до исправления значения. |195| `forceLoginOrgUUID` | Ни одна организация не может войти до исправления значения. |

196| `deniedMcpServers` | Отдельная недействительная запись удаляется и применяется действительное подмножество. Полностью недействительное значение отбрасывается с предупреждением, так как отрицание каждого server заблокировало бы servers, которые политика никогда не называла. |196| `deniedMcpServers` | Отдельная недействительная запись удаляется и применяется действительное подмножество. Полностью недействительное значение отбрасывается с предупреждением, так как отрицание каждого server заблокировало бы servers, которые политика никогда не называла. |

197| `sandbox.credentials` | {/* min-version: 2.1.191 */}Отдельная недействительная запись в `files` или `envVars` удаляется с предупреждением и применяется действительное подмножество. Полностью недействительное значение `credentials` отбрасывается с предупреждением, пока остальная часть `sandbox` по-прежнему применяется. Применяется в v2.1.191 и позже. |197| `sandbox.credentials` | Отдельная недействительная запись в `files` или `envVars` удаляется с предупреждением и применяется действительное подмножество. Полностью недействительное значение `credentials` отбрасывается с предупреждением, пока остальная часть `sandbox` по-прежнему применяется. Применяется в v2.1.191 и позже. |

198 198 

199`requiredMinimumVersion` и `requiredMaximumVersion` открываются по дизайну: недействительное значение удаляется, а не применяется, поэтому плохая политика не может предотвратить запуск Claude Code.199`requiredMinimumVersion` и `requiredMaximumVersion` открываются по дизайну: недействительное значение удаляется, а не применяется, поэтому плохая политика не может предотвратить запуск Claude Code.

200 200 


202 202 

203* Интерактивные сеансы показывают диалог при запуске, перечисляющий недействительные записи.203* Интерактивные сеансы показывают диалог при запуске, перечисляющий недействительные записи.

204* Headless запуски с `-p` выводят сводку в stderr.204* Headless запуски с `-p` выводят сводку в stderr.

205* [`claude doctor`](/ru/debug-your-config) перечисляет каждую недействительную запись с ее источником и полем.205* [`claude doctor`](/docs/ru/debug-your-config) перечисляет каждую недействительную запись с ее источником и полем.

206 206 

207Проверьте изменения политики, запустив `claude doctor` на тестовой машине перед развертыванием их по всему парку.207Проверьте изменения политики, запустив `claude doctor` на тестовой машине перед развертыванием их по всему парку.

208 208 


215`settings.json` поддерживает ряд опций:215`settings.json` поддерживает ряд опций:

216 216 

217| Ключ | Описание | Пример |217| Ключ | Описание | Пример |

218| :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |218| :--------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

219| `advisorModel` | Модель для серверного [инструмента advisor](/ru/advisor). Принимает псевдоним модели, такой как `"opus"`, `"sonnet"` или `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), или полный ID модели. Записывается автоматически при запуске `/advisor`. Отключите, чтобы отключить advisor | `"opus"` |219| `advisorModel` | Модель для серверного [инструмента advisor](/docs/ru/advisor). Принимает псевдоним модели, такой как `"opus"`, `"sonnet"` или `"fable"` (v2.1.170+), или полный ID модели. Записывается автоматически при запуске `/advisor`. Отключите, чтобы отключить advisor | `"opus"` |

220| `agent` | Запустить основной поток как именованный subagent и установить агента по умолчанию для сеансов, отправленных из `claude agents`. Применяет системный запрос, ограничения инструментов и модель этого subagent. См. [Явно вызывать subagents](/ru/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |220| `agent` | Запустить основной поток как именованный subagent и установить агента по умолчанию для сеансов, отправленных из `claude agents`. Применяет системный запрос, ограничения инструментов и модель этого subagent. См. [Явно вызывать subagents](/docs/ru/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

221| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Когда [Remote Control](/ru/remote-control) подключен, разрешить Claude отправлять проактивные push-уведомления на ваш телефон, например когда длительная задача завершается. Появляется в `/config` как **Push when Claude decides**. См. [Mobile push notifications](/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |221| `agentPushNotifEnabled` | **По умолчанию**: `false`. Когда [Remote Control](/docs/ru/remote-control) подключен, разрешить Claude отправлять проактивные push-уведомления на ваш телефон, например когда длительная задача завершается. Появляется в `/config` как **Push when Claude decides**. См. [Mobile push notifications](/docs/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |

222| `allowAllClaudeAiMcps` | (Только управляемые параметры) Загружать разъемы claude.ai наряду с развернутым `managed-mcp.json`, который в противном случае берет исключительный контроль и подавляет их. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `true` |222| `allowAllClaudeAiMcps` | (Только управляемые параметры) Загружать разъемы claude.ai наряду с развернутым `managed-mcp.json`, который в противном случае берет исключительный контроль и подавляет их. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) | `true` |

223| `allowedChannelPlugins` | (Только управляемые параметры) Список разрешений channel plugins, которые могут отправлять сообщения. Заменяет список разрешений Anthropic по умолчанию при установке. Не определено = вернуться к значению по умолчанию, пустой массив = блокировать все channel plugins. Требует `channelsEnabled: true`. См. [Ограничить, какие channel plugins могут запускаться](/ru/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |223| `allowedChannelPlugins` | (Только управляемые параметры) Список разрешений channel plugins, которые могут отправлять сообщения. Заменяет список разрешений Anthropic по умолчанию при установке. Не определено = вернуться к значению по умолчанию, пустой массив = блокировать все channel plugins. Требует `channelsEnabled: true`. См. [Ограничить, какие channel plugins могут запускаться](/docs/ru/channels#restrict-which-channel-plugins-can-run) | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |

224| `allowedHttpHookUrls` | Список разрешенных URL-шаблонов, на которые могут быть направлены HTTP hooks. Поддерживает `*` как подстановочный знак. При установке hooks с несовпадающими URL-адресами блокируются. Не определено = без ограничений, пустой массив = блокировать все HTTP hooks. Массивы объединяются в разных источниках параметров. См. [Конфигурация Hook](#hook-configuration) | `["https://hooks.example.com/*"]` |224| `allowedHttpHookUrls` | Список разрешенных URL-шаблонов, на которые могут быть направлены HTTP hooks. Поддерживает `*` как подстановочный знак. При установке hooks с несовпадающими URL-адресами блокируются. Не определено = без ограничений, пустой массив = блокировать все HTTP hooks. Массивы объединяются в разных источниках параметров. См. [Конфигурация Hook](#hook-configuration) | `["https://hooks.example.com/*"]` |

225| `allowedMcpServers` | При установке в managed-settings.json, список разрешений MCP servers, которые пользователи могут настроить. Не определено = без ограничений, пустой массив = блокировка. Применяется ко всем областям. Список запретов имеет приоритет. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `[{ "serverName": "github" }]` |225| `allowedMcpServers` | При установке в managed-settings.json, список разрешений MCP servers, которые пользователи могут настроить. Не определено = без ограничений, пустой массив = блокировка. Применяется ко всем областям. Список запретов имеет приоритет. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) | `[{ "serverName": "github" }]` |

226| `allowManagedHooksOnly` | (Только управляемые параметры) Загружаются только управляемые hooks, SDK hooks и hooks из plugins, принудительно включенных в управляемых параметрах `enabledPlugins`. Пользовательские, проектные и все остальные plugin hooks блокируются. См. [Конфигурация Hook](#hook-configuration) | `true` |226| `allowManagedHooksOnly` | (Только управляемые параметры) Загружаются только управляемые hooks, SDK hooks и hooks из plugins, принудительно включенных в управляемых параметрах `enabledPlugins`. Пользовательские, проектные и все остальные plugin hooks блокируются. См. [Конфигурация Hook](#hook-configuration) | `true` |

227| `allowManagedMcpServersOnly` | (Только управляемые параметры) Только `allowedMcpServers` из управляемых параметров учитываются. `deniedMcpServers` по-прежнему объединяется из всех источников. Пользователи по-прежнему могут добавлять MCP servers, но применяется только определенный администратором список разрешений. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `true` |227| `allowManagedMcpServersOnly` | (Только управляемые параметры) Только `allowedMcpServers` из управляемых параметров учитываются. `deniedMcpServers` по-прежнему объединяется из всех источников. Пользователи по-прежнему могут добавлять MCP servers, но применяется только определенный администратором список разрешений. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) | `true` |

228| `allowManagedPermissionRulesOnly` | (Только управляемые параметры) Предотвратить определение правил разрешений `allow`, `ask` или `deny` в параметрах пользователя и проекта. Применяются только правила в управляемых параметрах. См. [Параметры только для управляемых](/ru/permissions#managed-only-settings) | `true` |228| `allowManagedPermissionRulesOnly` | (Только управляемые параметры) Предотвратить определение правил разрешений `allow`, `ask` или `deny` в параметрах пользователя и проекта. Применяются только правила в управляемых параметрах. См. [Параметры только для управляемых](/docs/ru/permissions#managed-only-settings) | `true` |

229| `alwaysThinkingEnabled` | Включить [расширенное мышление](/ru/model-config#extended-thinking) по умолчанию для всех сеансов. Обычно настраивается через команду `/config` вместо прямого редактирования. Чтобы принудительно отключить мышление независимо от этого параметра, установите [`MAX_THINKING_TOKENS=0`](/ru/env-vars) в `env`, что отключает мышление на Anthropic API, кроме Fable 5, которая не может отключить мышление. На [поставщиках третьих сторон](/ru/third-party-integrations) это опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать | `true` |229| `alwaysThinkingEnabled` | Включить [расширенное мышление](/docs/ru/model-config#extended-thinking) по умолчанию для всех сеансов. Обычно настраивается через команду `/config` вместо прямого редактирования. Чтобы принудительно отключить мышление независимо от этого параметра, установите [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars) в `env`, что отключает мышление на Anthropic API, кроме Fable 5, которая не может отключить мышление. На [поставщиках третьих сторон](/docs/ru/third-party-integrations) это опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать | `true` |

230| `apiKeyHelper` | Пользовательский скрипт, который будет выполнен в системной оболочке (`/bin/sh` на macOS и Linux, `cmd` на Windows), для создания значения аутентификации. Это значение будет отправлено как заголовки `X-Api-Key` и `Authorization: Bearer` для запросов модели. Установите интервал обновления с помощью [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/ru/env-vars) | `/bin/generate_temp_api_key.sh` |230| `apiKeyHelper` | Пользовательский скрипт, который будет выполнен в системной оболочке (`/bin/sh` на macOS и Linux, `cmd` на Windows), для создания значения аутентификации. Это значение будет отправлено как заголовки `X-Api-Key` и `Authorization: Bearer` для запросов модели. Установите интервал обновления с помощью [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/docs/ru/env-vars) | `/bin/generate_temp_api_key.sh` |

231| `askUserQuestionTimeout` | {/* min-version: 2.1.200 */}**По умолчанию**: `"never"`. Время простоя перед тем, как неотвеченный диалог [`AskUserQuestion`](/ru/tools-reference) автоматически продолжится с любыми уже выбранными вами опциями. Принимает `"60s"`, `"5m"`, `"10m"` или `"never"`. По умолчанию вопросы ждут, пока вы на них ответите. Появляется в `/config` как **Question auto-continue timeout**, который записывает этот ключ в параметры пользователя. Не читается из параметров проекта или локальных параметров. Требует Claude Code v2.1.200 или позже | `"5m"` |231| `askUserQuestionTimeout` | **По умолчанию**: `"never"`. Время простоя перед тем, как неотвеченный диалог [`AskUserQuestion`](/docs/ru/tools-reference) автоматически продолжится с любыми уже выбранными вами опциями. Принимает `"60s"`, `"5m"`, `"10m"` или `"never"`. По умолчанию вопросы ждут, пока вы на них ответите. Появляется в `/config` как **Question auto-continue timeout**, который записывает этот ключ в параметры пользователя. Не читается из параметров проекта или локальных параметров. Требует Claude Code v2.1.200 или позже | `"5m"` |

232| `attribution` | Настройте атрибуцию для коммитов git и pull requests. См. [Параметры атрибуции](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |232| `attribution` | Настройте атрибуцию для коммитов git и pull requests. См. [Параметры атрибуции](#attribution-settings) | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |

233| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `true`. Автоматически компактировать разговор, когда контекст приближается к лимиту. Появляется в `/config` как **Auto-compact**. Чтобы отключить через переменную окружения, установите [`DISABLE_AUTO_COMPACT`](/ru/env-vars) в `env` | `false` |233| `autoCompactEnabled` | **По умолчанию**: `true`. Автоматически компактировать разговор, когда контекст приближается к лимиту. Появляется в `/config` как **Auto-compact**. Чтобы отключить через переменную окружения, установите [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars) в `env` | `false` |

234| `autoMemoryDirectory` | Пользовательский каталог для хранения [автоматической памяти](/ru/memory#storage-location). Принимает абсолютный путь или путь с префиксом `~/`. Из параметров проекта или локальных параметров это учитывается только после того, как вы примете диалог доверия рабочей области, так как клонированный репозиторий может предоставить этот файл | `"~/my-memory-dir"` |234| `autoMemoryDirectory` | Пользовательский каталог для хранения [автоматической памяти](/docs/ru/memory#storage-location). Принимает абсолютный путь или путь с префиксом `~/`. Из параметров проекта или локальных параметров это учитывается только после того, как вы примете диалог доверия рабочей области, так как клонированный репозиторий может предоставить этот файл | `"~/my-memory-dir"` |

235| `autoMemoryEnabled` | **По умолчанию**: `true`. Включить [автоматическую память](/ru/memory#enable-or-disable-auto-memory). Когда `false`, Claude не читает и не записывает в каталог автоматической памяти. Вы также можете переключить это с помощью `/memory` во время сеанса. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/ru/env-vars) в `env` | `false` |235| `autoMemoryEnabled` | **По умолчанию**: `true`. Включить [автоматическую память](/docs/ru/memory#enable-or-disable-auto-memory). Когда `false`, Claude не читает и не записывает в каталог автоматической памяти. Вы также можете переключить это с помощью `/memory` во время сеанса. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/docs/ru/env-vars) в `env` | `false` |

236| `autoMode` | Настройте, что классификатор [автоматического режима](/ru/permission-modes#eliminate-prompts-with-auto-mode) блокирует и разрешает. Содержит массивы `environment`, `allow`, `soft_deny` и `hard_deny` правил в виде текста. Включите буквальную строку `"$defaults"` в массив для наследования встроенных правил в этой позиции. См. [Настройте автоматический режим](/ru/auto-mode-config). Читается из параметров пользователя, флага `--settings` и управляемых параметров только. Игнорируется в проекте `.claude/settings.json` и локальном `.claude/settings.local.json`. {/* min-version: 2.1.207 */}До v2.1.207, `.claude/settings.local.json` также читался | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |236| `autoMode` | Настройте, что классификатор [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) блокирует и разрешает. Содержит массивы `environment`, `allow`, `soft_deny` и `hard_deny` правил в виде текста. Включите буквальную строку `"$defaults"` в массив для наследования встроенных правил в этой позиции. См. [Настройте автоматический режим](/docs/ru/auto-mode-config). Читается из параметров пользователя, флага `--settings` и управляемых параметров только. Игнорируется в проекте `.claude/settings.json` и локальном `.claude/settings.local.json`. До v2.1.207, `.claude/settings.local.json` также читался | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |

237| `autoMode.classifyAllShell` | {/* min-version: 2.1.193 */}**По умолчанию**: `false`. Когда `true`, приостанавливает каждое правило разрешения Bash и PowerShell, пока активен автоматический режим, поэтому все команды shell маршрутизируются через классификатор, а не только правила, которые соответствуют шаблонам произвольного выполнения кода. См. [Маршрутизировать все команды shell через классификатор](/ru/auto-mode-config#route-all-shell-commands-through-the-classifier). Требует Claude Code v2.1.193 или позже | `true` |237| `autoMode.classifyAllShell` | **По умолчанию**: `false`. Когда `true`, приостанавливает каждое правило разрешения Bash и PowerShell, пока активен автоматический режим, поэтому все команды shell маршрутизируются через классификатор, а не только правила, которые соответствуют шаблонам произвольного выполнения кода. См. [Маршрутизировать все команды shell через классификатор](/docs/ru/auto-mode-config#route-all-shell-commands-through-the-classifier). Требует Claude Code v2.1.193 или позже | `true` |

238| `autoScrollEnabled` | **По умолчанию**: `true`. В [fullscreen rendering](/ru/fullscreen), следить за новым выводом в конец разговора. Появляется в `/config` как **Auto-scroll**. Запросы разрешений по-прежнему прокручиваются в поле зрения, когда это отключено | `false` |238| `autoScrollEnabled` | **По умолчанию**: `true`. В [fullscreen rendering](/docs/ru/fullscreen), следить за новым выводом в конец разговора. Появляется в `/config` как **Auto-scroll**. Запросы разрешений по-прежнему прокручиваются в поле зрения, когда это отключено | `false` |

239| `autoUpdatesChannel` | **По умолчанию**: `"latest"`. Канал выпуска для отслеживания обновлений. Используйте `"stable"` для версии, которая обычно примерно на неделю старше и пропускает версии с серьезными регрессиями, или `"latest"` для самого последнего выпуска. Чтобы полностью отключить автоматические обновления, установите [`DISABLE_AUTOUPDATER`](/ru/setup#disable-auto-updates) в `env` | `"stable"` |239| `autoUpdatesChannel` | **По умолчанию**: `"latest"`. Канал выпуска для отслеживания обновлений. Используйте `"stable"` для версии, которая обычно примерно на неделю старше и пропускает версии с серьезными регрессиями, или `"latest"` для самого последнего выпуска. Чтобы полностью отключить автоматические обновления, установите [`DISABLE_AUTOUPDATER`](/docs/ru/setup#disable-auto-updates) в `env` | `"stable"` |

240| `availableModels` | Ограничить, какие модели пользователи могут выбрать для основного сеанса, [subagents](/ru/sub-agents), [skills](/ru/skills) и [advisor](/ru/advisor). Не влияет на опцию Default, если также не установлен `enforceAvailableModels`. См. [Ограничить выбор модели](/ru/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |240| `availableModels` | Ограничить, какие модели пользователи могут выбрать для основного сеанса, [subagents](/docs/ru/sub-agents), [skills](/docs/ru/skills) и [advisor](/docs/ru/advisor). Не влияет на опцию Default, если также не установлен `enforceAvailableModels`. См. [Ограничить выбор модели](/docs/ru/model-config#restrict-model-selection) | `["sonnet", "haiku"]` |

241| `awaySummaryEnabled` | Показать одностроковое резюме сеанса при возврате в терминал после нескольких минут отсутствия. Установите на `false` или отключите Session recap в `/config` для отключения. То же самое, что [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/ru/env-vars) | `true` |241| `awaySummaryEnabled` | Показать одностроковое резюме сеанса при возврате в терминал после нескольких минут отсутствия. Установите на `false` или отключите Session recap в `/config` для отключения. То же самое, что [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/docs/ru/env-vars) | `true` |

242| `awsAuthRefresh` | Пользовательский скрипт, который изменяет каталог `.aws` (см. [расширенная конфигурация учетных данных](/ru/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |242| `awsAuthRefresh` | Пользовательский скрипт, который изменяет каталог `.aws` (см. [расширенная конфигурация учетных данных](/docs/ru/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |

243| `awsCredentialExport` | Пользовательский скрипт, который выводит JSON с учетными данными AWS (см. [расширенная конфигурация учетных данных](/ru/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |243| `awsCredentialExport` | Пользовательский скрипт, который выводит JSON с учетными данными AWS (см. [расширенная конфигурация учетных данных](/docs/ru/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

244| `axScreenReader` | {/* min-version: 2.1.181 */}Отображать вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Режим программы чтения с экрана всегда использует классический рендерер, поэтому параметр `tui` не имеет эффекта, пока он активен; прикрепленные [фоновые сеансы](/ru/agent-view) по-прежнему отображаются в полноэкранном режиме. Переменная окружения [`CLAUDE_AX_SCREEN_READER`](/ru/env-vars) и флаг [`--ax-screen-reader`](/ru/cli-reference#cli-flags) имеют приоритет. Требует Claude Code v2.1.181 или позже | `true` |244| `axScreenReader` | Отображать вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Режим программы чтения с экрана всегда использует классический рендерер, поэтому параметр `tui` не имеет эффекта, пока он активен; прикрепленные [фоновые сеансы](/docs/ru/agent-view) по-прежнему отображаются в полноэкранном режиме. Переменная окружения [`CLAUDE_AX_SCREEN_READER`](/docs/ru/env-vars) и флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеют приоритет. Требует Claude Code v2.1.181 или позже | `true` |

245| `blockedMarketplaces` | (Только управляемые параметры) Список запретов источников marketplace. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |245| `blockedMarketplaces` | (Только управляемые параметры) Список запретов источников marketplace. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

246| `browserExternalPageTools` | (Только управляемые параметры) Установите на `"disabled"`, чтобы предотвратить использование Claude инструментов для чтения или действия на внешних страницах в [Browser pane](/ru/desktop#browse-external-sites) приложения desktop. Пользователи по-прежнему могут самостоятельно переходить на внешние сайты, и локальные предпросмотры dev server не затронуты | `"disabled"` |246| `browserExternalPageTools` | (Только управляемые параметры) Установите на `"disabled"`, чтобы предотвратить использование Claude инструментов для чтения или действия на внешних страницах в [Browser pane](/docs/ru/desktop#browse-external-sites) приложения desktop. Пользователи по-прежнему могут самостоятельно переходить на внешние сайты, и локальные предпросмотры dev server не затронуты | `"disabled"` |

247| `channelsEnabled` | (Только управляемые параметры) Разрешить [channels](/ru/channels) для организации. На планах Claude.ai Team и Enterprise, channels блокируются, когда это не установлено или `false`. Для учетных записей [Anthropic Console](/ru/authentication#claude-console-authentication), использующих аутентификацию по ключу API, channels разрешены по умолчанию, если только ваша организация не развернула управляемые параметры, в этом случае этот ключ должен быть установлен на `true` | `true` |247| `channelsEnabled` | (Только управляемые параметры) Разрешить [channels](/docs/ru/channels) для организации. На планах Claude.ai Team и Enterprise, channels блокируются, когда это не установлено или `false`. Для учетных записей [Anthropic Console](/docs/ru/authentication#claude-console-authentication), использующих аутентификацию по ключу API, channels разрешены по умолчанию, если только ваша организация не развернула управляемые параметры, в этом случае этот ключ должен быть установлен на `true` | `true` |

248| `claudeMd` | (Только управляемые параметры) Инструкции в стиле CLAUDE.md, внедренные как организационная управляемая память. Учитываются только при установке в управляемых или политических параметрах и игнорируются в параметрах пользователя, проекта и локальных параметрах. См. [организационная CLAUDE.md](/ru/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |248| `claudeMd` | (Только управляемые параметры) Инструкции в стиле CLAUDE.md, внедренные как организационная управляемая память. Учитываются только при установке в управляемых или политических параметрах и игнорируются в параметрах пользователя, проекта и локальных параметрах. См. [организационная CLAUDE.md](/docs/ru/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |

249| `claudeMdExcludes` | Glob шаблоны или абсолютные пути файлов `CLAUDE.md` для пропуска при загрузке [памяти](/ru/memory). Шаблоны соответствуют абсолютным путям файлов. Применяется только к памяти пользователя, проекта и локальной памяти; файлы управляемой политики не могут быть исключены | `["**/vendor/**/CLAUDE.md"]` |249| `claudeMdExcludes` | Glob шаблоны или абсолютные пути файлов `CLAUDE.md` для пропуска при загрузке [памяти](/docs/ru/memory). Шаблоны соответствуют абсолютным путям файлов. Применяется только к памяти пользователя, проекта и локальной памяти; файлы управляемой политики не могут быть исключены | `["**/vendor/**/CLAUDE.md"]` |

250| `cleanupPeriodDays` | **По умолчанию**: `30` дней, минимум `1`. Claude Code удаляет [файлы сеансов и другие данные приложения](/ru/claude-directory#cleaned-up-automatically) старше этого периода при запуске. Установка `0` отклоняется с ошибкой валидации. Один и тот же возрастной порог применяется к автоматическому удалению [orphaned worktrees](/ru/worktrees#clean-up-worktrees) при запуске. {/* min-version: 2.1.203 */}Если Claude Code не может прочитать или разобрать файл параметров, он приостанавливает очистку удержания и показывает предупреждение в `/status` до тех пор, пока вы не исправите файл, если только [управляемые параметры](/ru/server-managed-settings) не предоставляют `cleanupPeriodDays`, в этом случае очистка выполняется при управляемом значении. До v2.1.203 очистка выполнялась при значении по умолчанию 30 дней в этом состоянии и могла удалить стенограммы, которые более длительный `cleanupPeriodDays` был предназначен для сохранения; файлы новее 30 дней никогда не удалялись. Чтобы полностью отключить запись стенограмм, установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ru/env-vars). В неинтерактивном режиме передайте `--no-session-persistence` вместе с `-p` или установите `persistSession: false` в Agent SDK. | `20` |250| `cleanupPeriodDays` | **По умолчанию**: `30` дней, минимум `1`. Claude Code удаляет [файлы сеансов и другие данные приложения](/docs/ru/claude-directory#cleaned-up-automatically) старше этого периода при запуске. Установка `0` отклоняется с ошибкой валидации. Один и тот же возрастной порог применяется к автоматическому удалению [orphaned worktrees](/docs/ru/worktrees#clean-up-worktrees) при запуске. Если Claude Code не может прочитать или разобрать файл параметров, он приостанавливает очистку удержания и показывает предупреждение в `/status` до тех пор, пока вы не исправите файл, если только [управляемые параметры](/docs/ru/server-managed-settings) не предоставляют `cleanupPeriodDays`, в этом случае очистка выполняется при управляемом значении. До v2.1.203 очистка выполнялась при значении по умолчанию 30 дней в этом состоянии и могла удалить стенограммы, которые более длительный `cleanupPeriodDays` был предназначен для сохранения; файлы новее 30 дней никогда не удалялись. Чтобы полностью отключить запись стенограмм, установите переменную окружения [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars). В неинтерактивном режиме передайте `--no-session-persistence` вместе с `-p` или установите `persistSession: false` в Agent SDK. | `20` |

251| `companyAnnouncements` | Объявление для отображения пользователям при запуске. Если предоставлено несколько объявлений, они будут циклически отображаться случайным образом. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |251| `companyAnnouncements` | Объявление для отображения пользователям при запуске. Если предоставлено несколько объявлений, они будут циклически отображаться случайным образом. | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |

252| `defaultShell` | **По умолчанию**: `"bash"`, или `"powershell"` на Windows, когда Bash недоступен. Оболочка по умолчанию для команд `!` в поле ввода. Принимает `"bash"` или `"powershell"`. Установка `"powershell"` направляет интерактивные команды `!` через PowerShell на Windows. Требует `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. См. [Инструмент PowerShell](/ru/tools-reference#powershell-tool) | `"powershell"` |252| `defaultShell` | **По умолчанию**: `"bash"`, или `"powershell"` на Windows, когда Bash недоступен. Оболочка по умолчанию для команд `!` в поле ввода. Принимает `"bash"` или `"powershell"`. Установка `"powershell"` направляет интерактивные команды `!` через PowerShell на Windows. Требует `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. См. [Инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) | `"powershell"` |

253| `deniedMcpServers` | При установке в managed-settings.json, список запретов MCP servers, которые явно заблокированы. Применяется ко всем областям, включая управляемые servers. Список запретов имеет приоритет над списком разрешений. См. [Управляемая конфигурация MCP](/ru/managed-mcp) | `[{ "serverName": "filesystem" }]` |253| `deniedMcpServers` | При установке в managed-settings.json, список запретов MCP servers, которые явно заблокированы. Применяется ко всем областям, включая управляемые servers. Список запретов имеет приоритет над списком разрешений. См. [Управляемая конфигурация MCP](/docs/ru/managed-mcp) | `[{ "serverName": "filesystem" }]` |

254| `disableAgentView` | Установите на `true`, чтобы отключить [фоновые агенты и представление агента](/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Обычно устанавливается в [управляемых параметрах](/ru/permissions#managed-settings). Эквивалентно установке `CLAUDE_CODE_DISABLE_AGENT_VIEW` на `1` | `true` |254| `disableAgentView` | Установите на `true`, чтобы отключить [фоновые агенты и представление агента](/docs/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Обычно устанавливается в [управляемых параметрах](/docs/ru/permissions#managed-settings). Эквивалентно установке `CLAUDE_CODE_DISABLE_AGENT_VIEW` на `1` | `true` |

255| `disableAllHooks` | Отключить все [hooks](/ru/hooks) и любую пользовательскую [строку состояния](/ru/statusline) | `true` |255| `disableAllHooks` | Отключить все [hooks](/docs/ru/hooks) и любую пользовательскую [строку состояния](/docs/ru/statusline) | `true` |

256| `disableArtifact` | Установите на `true`, чтобы отключить инструмент [Artifact](/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. Эквивалентно установке `CLAUDE_CODE_DISABLE_ARTIFACT` на `1` | `true` |256| `disableArtifact` | Установите на `true`, чтобы отключить инструмент [Artifact](/docs/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. Эквивалентно установке `CLAUDE_CODE_DISABLE_ARTIFACT` на `1` | `true` |

257| `disableAutoMode` | Установите на `"disable"`, чтобы предотвратить активацию [автоматического режима](/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет `auto` из цикла `Shift+Tab` и отклоняет `--permission-mode auto` при запуске. Наиболее полезно в [управляемых параметрах](/ru/permissions#managed-settings), где пользователи не могут его переопределить | `"disable"` |257| `disableAutoMode` | Установите на `"disable"`, чтобы предотвратить активацию [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode). Удаляет `auto` из цикла `Shift+Tab` и отклоняет `--permission-mode auto` при запуске. Наиболее полезно в [управляемых параметрах](/docs/ru/permissions#managed-settings), где пользователи не могут его переопределить | `"disable"` |

258| `disableBrowserExternalNavigation` | (Только управляемые параметры) Установите на `true`, чтобы отключить внешний просмотр в [Browser pane](/ru/desktop#browse-external-sites) приложения desktop. Ни пользователи, ни Claude не могут переходить на внешние сайты, и локальные предпросмотры dev server не затронуты. Значение должно быть JSON логическое значение `true`; строка `"true"` игнорируется | `true` |258| `disableBrowserExternalNavigation` | (Только управляемые параметры) Установите на `true`, чтобы отключить внешний просмотр в [Browser pane](/docs/ru/desktop#browse-external-sites) приложения desktop. Ни пользователи, ни Claude не могут переходить на внешние сайты, и локальные предпросмотры dev server не затронуты. Значение должно быть JSON логическое значение `true`; строка `"true"` игнорируется | `true` |

259| `disableBundledSkills` | Установите на `true`, чтобы отключить [skills](/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. `/doctor` остается доступным для ввода, как встроенные slash commands; скройте его с помощью [`DISABLE_DOCTOR_COMMAND`](/ru/env-vars) вместо этого. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно установке `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` на `1` | `true` |259| `disableBundledSkills` | Установите на `true`, чтобы отключить [skills](/docs/ru/skills) и workflows, которые поставляются с Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные slash commands, такие как `/init`, остаются доступными для ввода, но скрыты от модели. `/doctor` остается доступным для ввода, как встроенные slash commands; скройте его с помощью [`DISABLE_DOCTOR_COMMAND`](/docs/ru/env-vars) вместо этого. Skills из plugins, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно установке `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` на `1` | `true` |

260| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Отключить [claude.ai MCP connectors](/ru/mcp#use-mcp-servers-from-claude-ai), чтобы они не загружались автоматически и не подключались. Установите в любой области параметров. `true` в любом источнике имеет приоритет, поэтому проверенный в проекте `.claude/settings.json` может отключить репозиторий от облачных разъемов, но уровень проекта `false` не может переопределить уровень пользователя или политики `true`. Servers, переданные явно через `--mcp-config`, не затронуты. Чтобы запретить отдельные разъемы вместо всех, используйте [`deniedMcpServers`](/ru/managed-mcp). Требует Claude Code v2.1.182 или позже | `true` |260| `disableClaudeAiConnectors` | Отключить [claude.ai MCP connectors](/docs/ru/mcp#use-mcp-servers-from-claude-ai), чтобы они не загружались автоматически и не подключались. Установите в любой области параметров. `true` в любом источнике имеет приоритет, поэтому проверенный в проекте `.claude/settings.json` может отключить репозиторий от облачных разъемов, но уровень проекта `false` не может переопределить уровень пользователя или политики `true`. Servers, переданные явно через `--mcp-config`, не затронуты. Чтобы запретить отдельные разъемы вместо всех, используйте [`deniedMcpServers`](/docs/ru/managed-mcp). Требует Claude Code v2.1.182 или позже | `true` |

261| `disableDeepLinkRegistration` | Установите на `"disable"`, чтобы предотвратить регистрацию Claude Code обработчика протокола `claude-cli://` с операционной системой при запуске. Deep links позволяют внешним инструментам открыть сеанс Claude Code с предварительно заполненным запросом. Полезно в окружениях, где регистрация обработчика протокола ограничена или управляется отдельно | `"disable"` |261| `disableDeepLinkRegistration` | Установите на `"disable"`, чтобы предотвратить регистрацию Claude Code обработчика протокола `claude-cli://` с операционной системой при запуске. Deep links позволяют внешним инструментам открыть сеанс Claude Code с предварительно заполненным запросом. Полезно в окружениях, где регистрация обработчика протокола ограничена или управляется отдельно | `"disable"` |

262| `disabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для отклонения | `["filesystem"]` |262| `disabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для отклонения | `["filesystem"]` |

263| `disableRemoteControl` | {/* min-version: 2.1.128 */}Отключить [Remote Control](/ru/remote-control): блокирует `claude remote-control`, флаг `--remote-control`, автозапуск и переключение в сеансе. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения MDM на каждом устройстве, но работает из любой области. Требует Claude Code v2.1.128 или позже | `true` |263| `disableRemoteControl` | Отключить [Remote Control](/docs/ru/remote-control): блокирует `claude remote-control`, флаг `--remote-control`, автозапуск и переключение в сеансе. Обычно размещается в [управляемых параметрах](/docs/ru/permissions#managed-settings) для применения MDM на каждом устройстве, но работает из любой области. Требует Claude Code v2.1.128 или позже | `true` |

264| `disableSideloadFlags` | {/* min-version: 2.1.193 */}(Только управляемые параметры) Отклонить флаги CLI `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске, которые пользователи могли бы в противном случае передать для обхода [`strictKnownMarketplaces`](#strictknownmarketplaces) для одного запуска. Также отклоняет эти флаги из любой поверхности, которая порождает CLI с ними внутри, в настоящее время [Cowork](/ru/desktop) локальные сеансы в приложении desktop. `--mcp-config`, чьи servers все являются in-process записями `type: "sdk"`, по-прежнему принимается, поэтому Agent SDK и расширение VS Code продолжают работать. Не блокирует `claude mcp add`, `.mcp.json` или SDK `setMcpServers()`; объедините с [`allowedMcpServers`](/ru/managed-mcp) для управления MCP для каждого server. Требует Claude Code v2.1.193 или позже | `true` |264| `disableSideloadFlags` | (Только управляемые параметры) Отклонить флаги CLI `--plugin-dir`, `--plugin-url`, `--agents` и `--mcp-config` при запуске, которые пользователи могли бы в противном случае передать для обхода [`strictKnownMarketplaces`](#strictknownmarketplaces) для одного запуска. Также отклоняет эти флаги из любой поверхности, которая порождает CLI с ними внутри, в настоящее время [Cowork](/docs/ru/desktop) локальные сеансы в приложении desktop. `--mcp-config`, чьи servers все являются in-process записями `type: "sdk"`, по-прежнему принимается, поэтому Agent SDK и расширение VS Code продолжают работать. Не блокирует `claude mcp add`, `.mcp.json` или SDK `setMcpServers()`; объедините с [`allowedMcpServers`](/docs/ru/managed-mcp) для управления MCP для каждого server. Требует Claude Code v2.1.193 или позже | `true` |

265| `disableSkillShellExecution` | Отключить встроенное выполнение shell для `` !`...` `` и ` ```! ` блоков в [skills](/ru/skills) и пользовательских команд из источников пользователя, проекта, plugin или дополнительного каталога. Команды заменяются на `[shell command execution disabled by policy]` вместо выполнения. Встроенные и управляемые skills не затронуты. Наиболее полезно в [управляемых параметрах](/ru/permissions#managed-settings), где пользователи не могут его переопределить | `true` |265| `disableSkillShellExecution` | Отключить встроенное выполнение shell для `` !`...` `` и ` ```! ` блоков в [skills](/ru/skills) и пользовательских команд из источников пользователя, проекта, plugin или дополнительного каталога. Команды заменяются на `[shell command execution disabled by policy]` вместо выполнения. Встроенные и управляемые skills не затронуты. Наиболее полезно в [управляемых параметрах](/ru/permissions#managed-settings), где пользователи не могут его переопределить | `true` |

266| `disableWorkflows` | **По умолчанию**: `false`. Отключить [динамические workflows](/ru/workflows#turn-workflows-off) и встроенные команды workflow. Эквивалентно установке `CLAUDE_CODE_DISABLE_WORKFLOWS` на `1` | `true` |266| `disableWorkflows` | **По умолчанию**: `false`. Отключить [динамические workflows](/docs/ru/workflows#turn-workflows-off) и встроенные команды workflow. Эквивалентно установке `CLAUDE_CODE_DISABLE_WORKFLOWS` на `1` | `true` |

267| `editorMode` | **По умолчанию**: `"normal"`. Режим сочетания клавиш для входного приглашения: `"normal"` или `"vim"`. Появляется в `/config` как **Editor mode** | `"vim"` |267| `editorMode` | **По умолчанию**: `"normal"`. Режим сочетания клавиш для входного приглашения: `"normal"` или `"vim"`. Появляется в `/config` как **Editor mode** | `"vim"` |

268| `effortLevel` | Сохранить [уровень усилий](/ru/model-config#adjust-effort-level) между сеансами. Принимает `"low"`, `"medium"`, `"high"` или `"xhigh"`. Записывается автоматически при запуске `/effort` с одним из этих значений. `--effort` и [`CLAUDE_CODE_EFFORT_LEVEL`](/ru/env-vars) переопределяют это на один сеанс. См. [Отрегулировать уровень усилий](/ru/model-config#adjust-effort-level) для поддерживаемых моделей | `"xhigh"` |268| `effortLevel` | Сохранить [уровень усилий](/docs/ru/model-config#adjust-effort-level) между сеансами. Принимает `"low"`, `"medium"`, `"high"` или `"xhigh"`. Записывается автоматически при запуске `/effort` с одним из этих значений. `--effort` и [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars) переопределяют это на один сеанс. См. [Отрегулировать уровень усилий](/docs/ru/model-config#adjust-effort-level) для поддерживаемых моделей | `"xhigh"` |

269| `enableAllProjectMcpServers` | Автоматически одобрить все MCP servers, определенные в файлах проекта `.mcp.json`. {/* min-version: 2.1.196 */}Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/ru/mcp#managing-your-servers) | `true` |269| `enableAllProjectMcpServers` | Автоматически одобрить все MCP servers, определенные в файлах проекта `.mcp.json`. Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/docs/ru/mcp#managing-your-servers) | `true` |

270| `enableArtifact` | {/* min-version: 2.1.196 */}Включить или отключить инструмент [Artifact](/ru/artifacts) для этого пользователя. Когда не установлено, значение по умолчанию следует [доступности](/ru/artifacts#availability) функции для вашей учетной записи. Строка **Artifacts** в `/config` записывает этот ключ. Управляемый `disableArtifact` и [параметр администратора](/ru/artifacts#manage-artifacts-for-your-organization) вашей организации имеют приоритет, и ключ игнорируется в параметрах проекта и локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), которые репозиторий мог бы в противном случае зафиксировать. Требует Claude Code v2.1.196 или позже | `true` |270| `enableArtifact` | Включить или отключить инструмент [Artifact](/docs/ru/artifacts) для этого пользователя. Когда не установлено, значение по умолчанию следует [доступности](/docs/ru/artifacts#availability) функции для вашей учетной записи. Строка **Artifacts** в `/config` записывает этот ключ. Управляемый `disableArtifact` и [параметр администратора](/docs/ru/artifacts#manage-artifacts-for-your-organization) вашей организации имеют приоритет, и ключ игнорируется в параметрах проекта и локальных параметрах (`.claude/settings.json`, `.claude/settings.local.json`), которые репозиторий мог бы в противном случае зафиксировать. Требует Claude Code v2.1.196 или позже | `true` |

271| `enabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для одобрения. {/* min-version: 2.1.196 */}Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/ru/mcp#managing-your-servers) | `["memory", "github"]` |271| `enabledMcpjsonServers` | Список конкретных MCP servers из файлов `.mcp.json` для одобрения. Начиная с v2.1.196, `claude mcp list` и `claude mcp get` учитывают этот ключ в ненадежной папке только из [файлов параметров, которые не проверяются в репозитории](/docs/ru/mcp#managing-your-servers) | `["memory", "github"]` |

272| `enforceAvailableModels` | {/* min-version: 2.1.175 */}Расширить список разрешений `availableModels` на модель Default. Когда `true` в управляемых параметрах и `availableModels` - это непустой массив, опция Default возвращается к первой разрешенной записи, которая доступна, но только когда модель Default, которая будет разрешена (организационное значение по умолчанию, когда оно применяется, иначе значение по умолчанию для типа учетной записи), не находится в списке разрешений; разрешенное значение по умолчанию сохраняется как есть. Не имеет эффекта, когда `availableModels` не установлен или пуст. См. [Ограничить выбор модели](/ru/model-config#restrict-model-selection) для поддерживаемых моделей | `true` |272| `enforceAvailableModels` | Расширить список разрешений `availableModels` на модель Default. Когда `true` в управляемых параметрах и `availableModels` - это непустой массив, опция Default возвращается к первой разрешенной записи, которая доступна, но только когда модель Default, которая будет разрешена (организационное значение по умолчанию, когда оно применяется, иначе значение по умолчанию для типа учетной записи), не находится в списке разрешений; разрешенное значение по умолчанию сохраняется как есть. Не имеет эффекта, когда `availableModels` не установлен или пуст. См. [Ограничить выбор модели](/docs/ru/model-config#restrict-model-selection) для поддерживаемых моделей | `true` |

273| `env` | Переменные окружения, применяемые к каждому сеансу и к подпроцессам, которые Claude Code порождает из него. Установите переменную на `""`, чтобы переопределить экспорт оболочки пустой строкой, которую Claude Code обрабатывает как неустановленную для выбора поставщика. Подпроцессы по-прежнему наследуют пустое значение. `NO_COLOR` и `FORCE_COLOR`, установленные здесь, достигают только подпроцессов; чтобы изменить цвета собственного интерфейса Claude Code, установите их в вашей оболочке перед запуском `claude`. {/* min-version: 2.1.195 */}Начиная с v2.1.195, переменные идентификации, которые устанавливают окружения хостинга Claude Code, например `CLAUDE_CODE_REMOTE` и `CLAUDE_CODE_ACCOUNT_UUID`, игнорируются при установке здесь | `{"FOO": "bar"}` |273| `env` | Переменные окружения, применяемые к каждому сеансу и к подпроцессам, которые Claude Code порождает из него. Установите переменную на `""`, чтобы переопределить экспорт оболочки пустой строкой, которую Claude Code обрабатывает как неустановленную для выбора поставщика. Подпроцессы по-прежнему наследуют пустое значение. `NO_COLOR` и `FORCE_COLOR`, установленные здесь, достигают только подпроцессов; чтобы изменить цвета собственного интерфейса Claude Code, установите их в вашей оболочке перед запуском `claude`. Начиная с v2.1.195, переменные идентификации, которые устанавливают окружения хостинга Claude Code, например `CLAUDE_CODE_REMOTE` и `CLAUDE_CODE_ACCOUNT_UUID`, игнорируются при установке здесь | `{"FOO": "bar"}` |

274| `fallbackModel` | Резервная модель(и) для попытки по порядку, когда основная модель перегружена или недоступна. Claude Code переключается на следующую доступную модель в цепи для остальной части хода и показывает уведомление. `"default"` расширяется до модели по умолчанию. Цепи ограничены тремя моделями; дополнительные записи игнорируются. В отличие от большинства параметров массива, этот ключ не объединяется в разных файлах параметров: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь. Флаг [`--fallback-model`](/ru/cli-reference#cli-flags) переопределяет это на один сеанс. См. [Цепи резервных моделей](/ru/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |274| `fallbackModel` | Резервная модель(и) для попытки по порядку, когда основная модель перегружена или недоступна. Claude Code переключается на следующую доступную модель в цепи для остальной части хода и показывает уведомление. `"default"` расширяется до модели по умолчанию. Цепи ограничены тремя моделями; дополнительные записи игнорируются. В отличие от большинства параметров массива, этот ключ не объединяется в разных файлах параметров: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь. Флаг [`--fallback-model`](/docs/ru/cli-reference#cli-flags) переопределяет это на один сеанс. См. [Цепи резервных моделей](/docs/ru/model-config#fallback-model-chains) | `["claude-sonnet-5", "claude-haiku-4-5"]` |

275| `fastMode` | Включить [быстрый режим](/ru/fast-mode) для сеансов, где он доступен. Переключение с помощью `/fast` записывает `true` здесь в параметры пользователя и удаляет ключ при отключении быстрого режима | `true` |275| `fastMode` | Включить [быстрый режим](/docs/ru/fast-mode) для сеансов, где он доступен. Переключение с помощью `/fast` записывает `true` здесь в параметры пользователя и удаляет ключ при отключении быстрого режима | `true` |

276| `fastModePerSessionOptIn` | Когда `true`, быстрый режим не сохраняется между сеансами. Каждый сеанс начинается с отключенным быстрым режимом, требуя от пользователей включить его с помощью `/fast`. Предпочтение быстрого режима пользователя по-прежнему сохраняется. См. [Требовать согласие для каждого сеанса](/ru/fast-mode#require-per-session-opt-in) | `true` |276| `fastModePerSessionOptIn` | Когда `true`, быстрый режим не сохраняется между сеансами. Каждый сеанс начинается с отключенным быстрым режимом, требуя от пользователей включить его с помощью `/fast`. Предпочтение быстрого режима пользователя по-прежнему сохраняется. См. [Требовать согласие для каждого сеанса](/docs/ru/fast-mode#require-per-session-opt-in) | `true` |

277| `feedbackSurveyRate` | Вероятность (0–1) того, что [опрос качества сеанса](/ru/data-usage#session-quality-surveys) появится при наличии условий. Установите на `0`, чтобы полностью подавить, или установите [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/ru/env-vars) в `env`. Полезно при использовании Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, где частота выборки по умолчанию не применяется | `0.05` |277| `feedbackSurveyRate` | Вероятность (0–1) того, что [опрос качества сеанса](/docs/ru/data-usage#session-quality-surveys) появится при наличии условий. Установите на `0`, чтобы полностью подавить, или установите [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/docs/ru/env-vars) в `env`. Полезно при использовании Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, где частота выборки по умолчанию не применяется | `0.05` |

278| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `true`. Снимок файлов перед каждым редактированием, чтобы [`/rewind`](/ru/checkpointing) мог их восстановить. Появляется в `/config` как **Rewind code (checkpoints)**. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/ru/env-vars) в `env` | `false` |278| `fileCheckpointingEnabled` | **По умолчанию**: `true`. Снимок файлов перед каждым редактированием, чтобы [`/rewind`](/docs/ru/checkpointing) мог их восстановить. Появляется в `/config` как **Rewind code (checkpoints)**. Чтобы отключить через переменную окружения, установите [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/docs/ru/env-vars) в `env` | `false` |

279| `fileSuggestion` | Настройте пользовательский скрипт для автодополнения файлов `@`. См. [Параметры предложения файлов](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |279| `fileSuggestion` | Настройте пользовательский скрипт для автодополнения файлов `@`. См. [Параметры предложения файлов](#file-suggestion-settings) | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |

280| `footerLinksRegexes` | {/* min-version: 2.1.176 */}Отображать дополнительные кликабельные значки в нижнем колонтитуле, когда регулярное выражение совпадает с выводом хода. Каждая запись имеет `pattern`, шаблон `url` с заполняемыми `{name}` плейсхолдерами из именованных групп захвата и необязательный `label`. Читается из параметров пользователя, флага `--settings` и управляемых параметров только. См. [Значки ссылок нижнего колонтитула](#footer-link-badges) для ограничений URL, списка разрешений схемы и лимитов. Требует Claude Code v2.1.176 или позже | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |280| `footerLinksRegexes` | Отображать дополнительные кликабельные значки в нижнем колонтитуле, когда регулярное выражение совпадает с выводом хода. Каждая запись имеет `pattern`, шаблон `url` с заполняемыми `{name}` плейсхолдерами из именованных групп захвата и необязательный `label`. Читается из параметров пользователя, флага `--settings` и управляемых параметров только. См. [Значки ссылок нижнего колонтитула](#footer-link-badges) для ограничений URL, списка разрешений схемы и лимитов. Требует Claude Code v2.1.176 или позже | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |

281| `forceLoginMethod` | Используйте `claudeai` для ограничения входа учетными записями Claude.ai, `console` для ограничения входа учетными записями Claude Console, или `gateway` для ограничения входа на облачный шлюз; см. [Claude apps gateway](/ru/claude-apps-gateway). Когда установлено в управляемых параметрах, сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как ни одно значение не может быть удовлетворено без первоначальной OAuth. Сеансы поставщиков третьих сторон, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, не блокируются: они аутентифицируются против вашего облачного провайдера, а не Anthropic | `claudeai` |281| `forceLoginMethod` | Используйте `claudeai` для ограничения входа учетными записями Claude.ai, `console` для ограничения входа учетными записями Claude Console, или `gateway` для ограничения входа на облачный шлюз; см. [Claude apps gateway](/docs/ru/claude-apps-gateway). Когда установлено в управляемых параметрах, сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как ни одно значение не может быть удовлетворено без первоначальной OAuth. Сеансы поставщиков третьих сторон, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, не блокируются: они аутентифицируются против вашего облачного провайдера, а не Anthropic | `claudeai` |

282| `forceLoginGatewayUrl` | Предварительно заполняет и блокирует URL шлюза на экране `/login` Cloud gateway. Либо этот ключ, либо `forceLoginMethod: "gateway"` отображает этот экран; установите оба, чтобы URL был заполнен. Учитывается только на управляемом уровне политики; игнорируется в параметрах пользователя и проекта. См. [Claude apps gateway](/ru/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |282| `forceLoginGatewayUrl` | Предварительно заполняет и блокирует URL шлюза на экране `/login` Cloud gateway. Либо этот ключ, либо `forceLoginMethod: "gateway"` отображает этот экран; установите оба, чтобы URL был заполнен. Учитывается только на управляемом уровне политики; игнорируется в параметрах пользователя и проекта. См. [Claude apps gateway](/docs/ru/claude-apps-gateway#set-the-gateway-url) | `"https://claude-gateway.example.com"` |

283| `forceLoginOrgUUID` | Требовать, чтобы вход принадлежал определенной организации Anthropic. Принимает одну строку UUID, которая также предварительно выбирает эту организацию во время входа, или массив UUID, где любая указанная организация принимается без предварительного выбора. При установке в управляемых параметрах вход не удается, если аутентифицированная учетная запись не принадлежит указанной организации, и сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как членство в организации не может быть проверено для них. Сеансы поставщиков третьих сторон, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, не блокируются: используйте IAM вашего облачного провайдера для ограничения того, какие облачные учетные записи могут быть использованы. Пустой массив не удается закрыто и блокирует вход с сообщением о неправильной конфигурации | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` или `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |283| `forceLoginOrgUUID` | Требовать, чтобы вход принадлежал определенной организации Anthropic. Принимает одну строку UUID, которая также предварительно выбирает эту организацию во время входа, или массив UUID, где любая указанная организация принимается без предварительного выбора. При установке в управляемых параметрах вход не удается, если аутентифицированная учетная запись не принадлежит указанной организации, и сеансы, аутентифицированные по `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, блокируются при запуске, так как членство в организации не может быть проверено для них. Сеансы поставщиков третьих сторон, такие как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, не блокируются: используйте IAM вашего облачного провайдера для ограничения того, какие облачные учетные записи могут быть использованы. Пустой массив не удается закрыто и блокирует вход с сообщением о неправильной конфигурации | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` или `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |

284| `forceRemoteSettingsRefresh` | (Только управляемые параметры) Блокировать запуск CLI до тех пор, пока удаленные управляемые параметры не будут свежо получены с сервера. Если получение не удается, CLI выходит вместо продолжения с кэшированными или отсутствующими параметрами. Когда не установлено, запуск продолжается без ожидания удаленных параметров. См. [fail-closed enforcement](/ru/server-managed-settings#enforce-fail-closed-startup) | `true` |284| `forceRemoteSettingsRefresh` | (Только управляемые параметры) Блокировать запуск CLI до тех пор, пока удаленные управляемые параметры не будут свежо получены с сервера. Если получение не удается, CLI выходит вместо продолжения с кэшированными или отсутствующими параметрами. Когда не установлено, запуск продолжается без ожидания удаленных параметров. См. [fail-closed enforcement](/docs/ru/server-managed-settings#enforce-fail-closed-startup) | `true` |

285| `gcpAuthRefresh` | Пользовательский скрипт, который обновляет GCP Application Default Credentials при их истечении или невозможности загрузки. См. [расширенная конфигурация учетных данных](/ru/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |285| `gcpAuthRefresh` | Пользовательский скрипт, который обновляет GCP Application Default Credentials при их истечении или невозможности загрузки. См. [расширенная конфигурация учетных данных](/docs/ru/google-vertex-ai#advanced-credential-configuration) | `gcloud auth application-default login` |

286| `hooks` | Настройте пользовательские команды для запуска при событиях жизненного цикла. См. [документацию hooks](/ru/hooks) для формата | См. [hooks](/ru/hooks) |286| `hooks` | Настройте пользовательские команды для запуска при событиях жизненного цикла. См. [документацию hooks](/docs/ru/hooks) для формата | См. [hooks](/docs/ru/hooks) |

287| `httpHookAllowedEnvVars` | Список разрешенных имен переменных окружения, которые HTTP hooks могут интерполировать в заголовки. При установке эффективный `allowedEnvVars` каждого hook является пересечением с этим списком. Не определено = без ограничений. Массивы объединяются в разных источниках параметров. См. [Конфигурация Hook](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |287| `httpHookAllowedEnvVars` | Список разрешенных имен переменных окружения, которые HTTP hooks могут интерполировать в заголовки. При установке эффективный `allowedEnvVars` каждого hook является пересечением с этим списком. Не определено = без ограничений. Массивы объединяются в разных источниках параметров. См. [Конфигурация Hook](#hook-configuration) | `["MY_TOKEN", "HOOK_SECRET"]` |

288| `includeGitInstructions` | **По умолчанию**: `true`. Включить встроенные инструкции рабочего процесса коммита и PR и снимок статуса git в системный запрос Claude. Установите на `false`, чтобы удалить оба, например при использовании собственных skills рабочего процесса git. Переменная окружения `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` имеет приоритет над этим параметром при установке | `false` |288| `includeGitInstructions` | **По умолчанию**: `true`. Включить встроенные инструкции рабочего процесса коммита и PR и снимок статуса git в системный запрос Claude. Установите на `false`, чтобы удалить оба, например при использовании собственных skills рабочего процесса git. Переменная окружения `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` имеет приоритет над этим параметром при установке | `false` |

289| `inputNeededNotifEnabled` | {/* min-version: 2.1.119 */}**По умолчанию**: `false`. Когда [Remote Control](/ru/remote-control) подключен, отправить push-уведомление на ваш телефон, когда запрос разрешения или вопрос ожидает вашего ввода. Появляется в `/config` как **Push when actions required**. См. [Mobile push notifications](/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |289| `inputNeededNotifEnabled` | **По умолчанию**: `false`. Когда [Remote Control](/docs/ru/remote-control) подключен, отправить push-уведомление на ваш телефон, когда запрос разрешения или вопрос ожидает вашего ввода. Появляется в `/config` как **Push when actions required**. См. [Mobile push notifications](/docs/ru/remote-control#mobile-push-notifications). Требует Claude Code v2.1.119 или позже | `true` |

290| `language` | Настройте предпочитаемый язык ответов Claude (например, `"japanese"`, `"spanish"`, `"french"`). Claude будет отвечать на этом языке по умолчанию. Также устанавливает язык [голосового диктанта](/ru/voice-dictation#change-the-dictation-language) и автоматически созданных названий сеансов. {/* min-version: 2.1.176 */}Начиная с v2.1.176, когда не установлено, названия сеансов соответствуют языку вашего разговора | `"japanese"` |290| `language` | Настройте предпочитаемый язык ответов Claude (например, `"japanese"`, `"spanish"`, `"french"`). Claude будет отвечать на этом языке по умолчанию. Также устанавливает язык [голосового диктанта](/docs/ru/voice-dictation#change-the-dictation-language) и автоматически созданных названий сеансов. Начиная с v2.1.176, когда не установлено, названия сеансов соответствуют языку вашего разговора | `"japanese"` |

291| `minimumVersion` | Предотвратить понижение версии автоматического обновления ниже определенной версии. Переключение с канала `"latest"` на `"stable"` через `/config` предлагает вам остаться на текущей версии или разрешить понижение. Выбор остаться устанавливает это значение. Также полезно в [управляемых параметрах](/ru/permissions#managed-settings) для закрепления организационного минимума. Для жесткого предела, который блокирует запуск целиком, см. `requiredMinimumVersion` | `"2.1.100"` |291| `minimumVersion` | Предотвратить понижение версии автоматического обновления ниже определенной версии. Переключение с канала `"latest"` на `"stable"` через `/config` предлагает вам остаться на текущей версии или разрешить понижение. Выбор остаться устанавливает это значение. Также полезно в [управляемых параметрах](/docs/ru/permissions#managed-settings) для закрепления организационного минимума. Для жесткого предела, который блокирует запуск целиком, см. `requiredMinimumVersion` | `"2.1.100"` |

292| `model` | Переопределить модель по умолчанию для использования в Claude Code. `--model` и [`ANTHROPIC_MODEL`](/ru/model-config#environment-variables) переопределяют это на один сеанс | `"claude-sonnet-5"` |292| `model` | Переопределить модель по умолчанию для использования в Claude Code. `--model` и [`ANTHROPIC_MODEL`](/docs/ru/model-config#environment-variables) переопределяют это на один сеанс | `"claude-sonnet-5"` |

293| `modelOverrides` | Сопоставить ID моделей Anthropic с ID моделей, специфичными для поставщика, такими как ARN профилей вывода Amazon Bedrock. Каждая запись средства выбора модели использует свое сопоставленное значение при вызове API поставщика. См. [Переопределить ID моделей для каждой версии](/ru/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |293| `modelOverrides` | Сопоставить ID моделей Anthropic с ID моделей, специфичными для поставщика, такими как ARN профилей вывода Amazon Bedrock. Каждая запись средства выбора модели использует свое сопоставленное значение при вызове API поставщика. См. [Переопределить ID моделей для каждой версии](/docs/ru/model-config#override-model-ids-per-version) | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |

294| `otelHeadersHelper` | Скрипт для создания динамических заголовков OpenTelemetry. Запускается при запуске и периодически. Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/ru/env-vars). См. [Динамические заголовки](/ru/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |294| `otelHeadersHelper` | Скрипт для создания динамических заголовков OpenTelemetry. Запускается при запуске и периодически. Установите интервал обновления с помощью [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/docs/ru/env-vars). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) | `/bin/generate_otel_headers.sh` |

295| `outputStyle` | Настройте стиль вывода для корректировки системного запроса. См. [документацию стилей вывода](/ru/output-styles) | `"Explanatory"` |295| `outputStyle` | Настройте стиль вывода для корректировки системного запроса. См. [документацию стилей вывода](/docs/ru/output-styles) | `"Explanatory"` |

296| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Только управляемые параметры) **По умолчанию**: `"first-wins"`. Контролирует, применяются ли управляемые параметры, предоставленные программно процессом хоста встраивания, таким как Agent SDK или расширение IDE, когда также присутствует развернутый администратором управляемый уровень. `"first-wins"`: параметры, предоставленные родителем, отбрасываются и применяется только уровень администратора. `"merge"`: параметры, предоставленные родителем, применяются под уровнем администратора, отфильтрованные так, чтобы они могли ужесточить политику, но не ослабить ее. Не имеет эффекта, когда развернут администратором уровень. Требует Claude Code v2.1.133 или позже | `"merge"` |296| `parentSettingsBehavior` | (Только управляемые параметры) **По умолчанию**: `"first-wins"`. Контролирует, применяются ли управляемые параметры, предоставленные программно процессом хоста встраивания, таким как Agent SDK или расширение IDE, когда также присутствует развернутый администратором управляемый уровень. `"first-wins"`: параметры, предоставленные родителем, отбрасываются и применяется только уровень администратора. `"merge"`: параметры, предоставленные родителем, применяются под уровнем администратора, отфильтрованные так, чтобы они могли ужесточить политику, но не ослабить ее. Не имеет эффекта, когда развернут администратором уровень. Требует Claude Code v2.1.133 или позже | `"merge"` |

297| `permissions` | См. таблицу ниже для структуры разрешений. | |297| `permissions` | См. таблицу ниже для структуры разрешений. | |

298| `plansDirectory` | **По умолчанию**: `~/.claude/plans`. Настройте, где хранятся файлы плана. Путь относительно корня проекта. | `"./plans"` |298| `plansDirectory` | **По умолчанию**: `~/.claude/plans`. Настройте, где хранятся файлы плана. Путь относительно корня проекта. | `"./plans"` |

299| `pluginSuggestionMarketplaces` | (Только управляемые параметры) Имена marketplace, чьи plugins могут появляться как контекстные предложения установки. Ни одно предложение, объявленное marketplace, не появляется без этого списка разрешений; встроенный совет по дизайну первой стороны не затронут. Предложения поступают из объявления `relevance` каждого plugin в его записи marketplace. Имя вступает в силу только когда marketplace зарегистрирован на машине и его зарегистрированный источник также объявлен в управляемых параметрах, либо как запись `extraKnownMarketplaces` для этого имени, либо как запись `strictKnownMarketplaces`. Marketplace, зарегистрированный из другого источника под разрешенным именем, игнорируется. Официальный marketplace освобожден от требования источника: разрешение его имени одного достаточно, так как это имя может регистрироваться только из официального источника Anthropic. | `["acme-corp-plugins"]` |299| `pluginSuggestionMarketplaces` | (Только управляемые параметры) Имена marketplace, чьи plugins могут появляться как контекстные предложения установки. Ни одно предложение, объявленное marketplace, не появляется без этого списка разрешений; встроенный совет по дизайну первой стороны не затронут. Предложения поступают из объявления `relevance` каждого plugin в его записи marketplace. Имя вступает в силу только когда marketplace зарегистрирован на машине и его зарегистрированный источник также объявлен в управляемых параметрах, либо как запись `extraKnownMarketplaces` для этого имени, либо как запись `strictKnownMarketplaces`. Marketplace, зарегистрированный из другого источника под разрешенным именем, игнорируется. Официальный marketplace освобожден от требования источника: разрешение его имени одного достаточно, так как это имя может регистрироваться только из официального источника Anthropic. | `["acme-corp-plugins"]` |

300| `pluginTrustMessage` | (Только управляемые параметры) Пользовательское сообщение, добавленное к предупреждению о доверии plugin, показываемому перед установкой. Используйте это для добавления контекста, специфичного для организации, например для подтверждения того, что plugins из вашего внутреннего marketplace проверены. | `"All plugins from our marketplace are approved by IT"` |300| `pluginTrustMessage` | (Только управляемые параметры) Пользовательское сообщение, добавленное к предупреждению о доверии plugin, показываемому перед установкой. Используйте это для добавления контекста, специфичного для организации, например для подтверждения того, что plugins из вашего внутреннего marketplace проверены. | `"All plugins from our marketplace are approved by IT"` |

301| `policyHelper` | {/* min-version: 2.1.136 */}Развернутый администратором исполняемый файл, который вычисляет управляемые параметры динамически при запуске. Учитывается только из MDM или системного файла `managed-settings.json`. См. [Вычислить управляемые параметры с помощью помощника политики](#compute-managed-settings-with-a-policy-helper). Требует Claude Code v2.1.136 или позже | `{"path": "/usr/local/bin/claude-policy"}` |301| `policyHelper` | Развернутый администратором исполняемый файл, который вычисляет управляемые параметры динамически при запуске. Учитывается только из MDM или системного файла `managed-settings.json`. См. [Вычислить управляемые параметры с помощью помощника политики](#compute-managed-settings-with-a-policy-helper). Требует Claude Code v2.1.136 или позже | `{"path": "/usr/local/bin/claude-policy"}` |

302| `preferredNotifChannel` | **По умолчанию**: `"auto"`. Метод для уведомлений о завершении задачи и запросов разрешения: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"` или `"notifications_disabled"`. `"auto"` отправляет уведомление рабочего стола в iTerm2, Ghostty и Kitty и ничего не делает в других терминалах. Установите `"terminal_bell"` для звонка в любом терминале. Появляется в `/config` как **Notifications**. См. [Получить звонок терминала или уведомление](/ru/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |302| `preferredNotifChannel` | **По умолчанию**: `"auto"`. Метод для уведомлений о завершении задачи и запросов разрешения: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"` или `"notifications_disabled"`. `"auto"` отправляет уведомление рабочего стола в iTerm2, Ghostty и Kitty и ничего не делает в других терминалах. Установите `"terminal_bell"` для звонка в любом терминале. Появляется в `/config` как **Notifications**. См. [Получить звонок терминала или уведомление](/docs/ru/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |

303| `prefersReducedMotion` | Уменьшить или отключить анимацию пользовательского интерфейса (спиннеры, shimmer, эффекты вспышки) для доступности | `true` |303| `prefersReducedMotion` | Уменьшить или отключить анимацию пользовательского интерфейса (спиннеры, shimmer, эффекты вспышки) для доступности | `true` |

304| `prUrlTemplate` | Шаблон URL для значка PR, показываемого в нижнем колонтитуле и в сводках результатов инструмента. Заменяет `{host}`, `{owner}`, `{repo}`, `{number}` и `{url}` из URL PR, сообщаемого `gh`. Используйте для указания ссылок PR на внутренний инструмент проверки кода вместо `github.com`. Не влияет на автоссылки `#123` в прозе Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |304| `prUrlTemplate` | Шаблон URL для значка PR, показываемого в нижнем колонтитуле и в сводках результатов инструмента. Заменяет `{host}`, `{owner}`, `{repo}`, `{number}` и `{url}` из URL PR, сообщаемого `gh`. Используйте для указания ссылок PR на внутренний инструмент проверки кода вместо `github.com`. Не влияет на автоссылки `#123` в прозе Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

305| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}Подключить [Remote Control](/ru/remote-control) автоматически при запуске каждого интерактивного сеанса, вместо ожидания `/remote-control`. Установите на `true`, чтобы всегда автоподключаться, `false`, чтобы никогда не автоподключаться, или оставьте неустановленным, чтобы следовать значению по умолчанию вашей организации. Появляется в `/config` как **Enable Remote Control for all sessions**. См. [Enable Remote Control for all sessions](/ru/remote-control#enable-remote-control-for-all-sessions) | `false` |305| `remoteControlAtStartup` | Подключить [Remote Control](/docs/ru/remote-control) автоматически при запуске каждого интерактивного сеанса, вместо ожидания `/remote-control`. Установите на `true`, чтобы всегда автоподключаться, `false`, чтобы никогда не автоподключаться, или оставьте неустановленным, чтобы следовать значению по умолчанию вашей организации. Появляется в `/config` как **Enable Remote Control for all sessions**. См. [Enable Remote Control for all sessions](/docs/ru/remote-control#enable-remote-control-for-all-sessions) | `false` |

306| `requiredMaximumVersion` | Только управляемые параметры. Максимальная версия Claude Code, разрешенная для запуска. Если запущенная версия новее, Claude Code выходит при запуске и инструктирует пользователя установить одобренную версию через одобренный метод организации; `claude install <version>` также может работать. Фоновые автоматические обновления и `claude update` пропускают версии выше потолка, поэтому установка в диапазоне остается в диапазоне. `claude update`, `claude install` и `claude doctor` продолжают работать выше потолка, чтобы пользователи могли восстановиться. Версии, которые предшествуют этому параметру, игнорируют его | `"2.1.150"` |306| `requiredMaximumVersion` | Только управляемые параметры. Максимальная версия Claude Code, разрешенная для запуска. Если запущенная версия новее, Claude Code выходит при запуске и инструктирует пользователя установить одобренную версию через одобренный метод организации; `claude install <version>` также может работать. Фоновые автоматические обновления и `claude update` пропускают версии выше потолка, поэтому установка в диапазоне остается в диапазоне. `claude update`, `claude install` и `claude doctor` продолжают работать выше потолка, чтобы пользователи могли восстановиться. Версии, которые предшествуют этому параметру, игнорируют его | `"2.1.150"` |

307| `requiredMinimumVersion` | Только управляемые параметры. Минимальная версия Claude Code, требуемая для запуска. Если запущенная версия старше, Claude Code выходит при запуске и инструктирует пользователя обновить через одобренный метод организации. `claude update`, `claude install` и `claude doctor` продолжают работать ниже пола, чтобы пользователи могли восстановиться. Отличается от `minimumVersion`, который предотвращает понижение, но никогда не блокирует запуск. Версии, которые предшествуют этому параметру, игнорируют его | `"2.1.150"` |307| `requiredMinimumVersion` | Только управляемые параметры. Минимальная версия Claude Code, требуемая для запуска. Если запущенная версия старше, Claude Code выходит при запуске и инструктирует пользователя обновить через одобренный метод организации. `claude update`, `claude install` и `claude doctor` продолжают работать ниже пола, чтобы пользователи могли восстановиться. Отличается от `minimumVersion`, который предотвращает понижение, но никогда не блокирует запуск. Версии, которые предшествуют этому параметру, игнорируют его | `"2.1.150"` |

308| `respectGitignore` | **По умолчанию**: `true`. Контролировать, соблюдает ли средство выбора файлов `@` шаблоны `.gitignore`. Когда `true`, файлы, соответствующие шаблонам `.gitignore`, исключаются из предложений | `false` |308| `respectGitignore` | **По умолчанию**: `true`. Контролировать, соблюдает ли средство выбора файлов `@` шаблоны `.gitignore`. Когда `true`, файлы, соответствующие шаблонам `.gitignore`, исключаются из предложений | `false` |

309| `respondToBashCommands` | {/* min-version: 2.1.186 */}**По умолчанию**: `true`. Отвечает ли Claude после запуска команды shell с префиксом `!` в поле ввода. Установите на `false`, чтобы добавить вывод команды в контекст без ответа. См. [Shell mode with `!` prefix](/ru/interactive-mode#shell-mode-with-prefix). Требует Claude Code v2.1.186 или позже | `false` |309| `respondToBashCommands` | **По умолчанию**: `true`. Отвечает ли Claude после запуска команды shell с префиксом `!` в поле ввода. Установите на `false`, чтобы добавить вывод команды в контекст без ответа. См. [Shell mode with `!` prefix](/docs/ru/interactive-mode#shell-mode-with-prefix). Требует Claude Code v2.1.186 или позже | `false` |

310| `showClearContextOnPlanAccept` | **По умолчанию**: `false`. Показать опцию "очистить контекст" на экране принятия плана. Установите на `true`, чтобы восстановить опцию | `true` |310| `showClearContextOnPlanAccept` | **По умолчанию**: `false`. Показать опцию "очистить контекст" на экране принятия плана. Установите на `true`, чтобы восстановить опцию | `true` |

311| `showThinkingSummaries` | **По умолчанию**: `false`. Показать [расширенное мышление](/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false`, блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/ru/model-config#extended-thinking) вместо этого. Этот параметр не имеет эффекта в неинтерактивном режиме (`-p`), Agent SDK или расширениях IDE, таких как VS Code | `true` |311| `showThinkingSummaries` | **По умолчанию**: `false`. Показать [расширенное мышление](/docs/ru/model-config#extended-thinking) резюме в интерактивных сеансах. Когда не установлено или `false`, блоки мышления редактируются API и показываются как свернутая заглушка. Редактирование изменяет только то, что вы видите, а не то, что генерирует модель: чтобы снизить расходы на мышление, [снизьте бюджет или отключите мышление](/docs/ru/model-config#extended-thinking) вместо этого. Этот параметр не имеет эффекта в неинтерактивном режиме (`-p`), Agent SDK или расширениях IDE, таких как VS Code | `true` |

312| `showTurnDuration` | **По умолчанию**: `true`. Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". Появляется в `/config` как **Show turn duration** | `false` |312| `showTurnDuration` | **По умолчанию**: `true`. Показывать сообщения о продолжительности хода после ответов, например "Cooked for 1m 6s". Появляется в `/config` как **Show turn duration** | `false` |

313| `skillListingBudgetFraction` | **По умолчанию**: `0.01`. Доля окна контекста модели, зарезервированная для [списка skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Когда список превышает бюджет, описания для наименее используемых skills сворачиваются до простых имен, чтобы Claude все еще мог их вызывать, но не видел бы, почему. Увеличьте, чтобы сохранить больше описаний видимыми за счет большего контекста за ход. `/doctor` показывает текущее количество усечений и какие skills затронуты. Требует Claude Code v2.1.105 или позже | `0.02` |313| `skillListingBudgetFraction` | **По умолчанию**: `0.01`. Доля окна контекста модели, зарезервированная для [списка skills](/docs/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Когда список превышает бюджет, описания для наименее используемых skills сворачиваются до простых имен, чтобы Claude все еще мог их вызывать, но не видел бы, почему. Увеличьте, чтобы сохранить больше описаний видимыми за счет большего контекста за ход. `/doctor` показывает текущее количество усечений и какие skills затронуты. Требует Claude Code v2.1.105 или позже | `0.02` |

314| `skillListingMaxDescChars` | **По умолчанию**: `1536`. Ограничение количества символов для каждого skill на объединенный текст `description` и `when_to_use` в [списке skills](/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Текст длиннее этого усекается. Увеличьте, чтобы сохранить длинные описания в целости за счет большего контекста за ход; уменьшьте, чтобы вместить больше skills в рамках [`skillListingBudgetFraction`](#available-settings). Требует Claude Code v2.1.105 или позже | `2048` |314| `skillListingMaxDescChars` | **По умолчанию**: `1536`. Ограничение количества символов для каждого skill на объединенный текст `description` и `when_to_use` в [списке skills](/docs/ru/skills#skill-descriptions-are-cut-short), который видит Claude каждый ход. Текст длиннее этого усекается. Увеличьте, чтобы сохранить длинные описания в целости за счет большего контекста за ход; уменьшьте, чтобы вместить больше skills в рамках [`skillListingBudgetFraction`](#available-settings). Требует Claude Code v2.1.105 или позже | `2048` |

315| `skillOverrides` | {{/* min-version: 2.1.129 */}}Переопределения видимости для каждого skill, ключ которых - имя skill. Значение - `"on"`, `"name-only"`, `"user-invocable-only"` или `"off"`. Позволяет скрыть или свернуть skill без редактирования его SKILL.md. Не применяется к plugin skills, которые управляются через `/plugin`. Меню `/skills` записывает эти значения в `.claude/settings.local.json`. См. [Переопределить видимость skill из параметров](/ru/skills#override-skill-visibility-from-settings). Требует Claude Code v2.1.129 или позже | `{"legacy-context": "name-only", "deploy": "off"}` |315| `skillOverrides` | {{/* min-version: 2.1.129 */}}Переопределения видимости для каждого skill, ключ которых - имя skill. Значение - `"on"`, `"name-only"`, `"user-invocable-only"` или `"off"`. Позволяет скрыть или свернуть skill без редактирования его SKILL.md. Не применяется к plugin skills, которые управляются через `/plugin`. Меню `/skills` записывает эти значения в `.claude/settings.local.json`. См. [Переопределить видимость skill из параметров](/docs/ru/skills#override-skill-visibility-from-settings). Требует Claude Code v2.1.129 или позже | `{"legacy-context": "name-only", "deploy": "off"}` |

316| `skipWebFetchPreflight` | Пропустить [проверку безопасности домена WebFetch](/ru/data-usage#webfetch-domain-safety-check), которая отправляет каждое запрашиваемое имя хоста на `api.anthropic.com` перед выборкой. Установите на `true` в окружениях, которые блокируют трафик к Anthropic, таких как развертывания Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry с ограничивающим исходящим трафиком. При пропуске WebFetch пытается любой URL без консультации со списком блокировок | `true` |316| `skipWebFetchPreflight` | Пропустить [проверку безопасности домена WebFetch](/docs/ru/data-usage#webfetch-domain-safety-check), которая отправляет каждое запрашиваемое имя хоста на `api.anthropic.com` перед выборкой. Установите на `true` в окружениях, которые блокируют трафик к Anthropic, таких как развертывания Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry с ограничивающим исходящим трафиком. При пропуске WebFetch пытается любой URL без консультации со списком блокировок | `true` |

317| `spinnerTipsEnabled` | **По умолчанию**: `true`. Показывать советы в спиннере, пока Claude работает. Установите на `false`, чтобы отключить советы | `false` |317| `spinnerTipsEnabled` | **По умолчанию**: `true`. Показывать советы в спиннере, пока Claude работает. Установите на `false`, чтобы отключить советы | `false` |

318| `spinnerTipsOverride` | Переопределить советы спиннера пользовательскими строками. `tips`: массив строк советов. `excludeDefault`: если `true`, показывать только пользовательские советы; если `false` или отсутствует, пользовательские советы объединяются со встроенными советами | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |318| `spinnerTipsOverride` | Переопределить советы спиннера пользовательскими строками. `tips`: массив строк советов. `excludeDefault`: если `true`, показывать только пользовательские советы; если `false` или отсутствует, пользовательские советы объединяются со встроенными советами | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |

319| `spinnerVerbs` | Настройте глаголы действия, показываемые в спиннере во время хода. Установите `mode` на `"replace"`, чтобы использовать только ваши глаголы, или `"append"`, чтобы добавить их к значениям по умолчанию | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |319| `spinnerVerbs` | Настройте глаголы действия, показываемые в спиннере во время хода. Установите `mode` на `"replace"`, чтобы использовать только ваши глаголы, или `"append"`, чтобы добавить их к значениям по умолчанию | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |

320| `sshConfigs` | SSH подключения для отображения в раскрывающемся списке окружения [Desktop](/ru/desktop#pre-configure-ssh-connections-for-your-team). Каждая запись требует `id`, `name` и `sshHost`; `sshPort`, `sshIdentityFile` и `startDirectory` являются необязательными. При установке в управляемых параметрах подключения доступны только для чтения для пользователей. Читается только из управляемых и пользовательских параметров | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |320| `sshConfigs` | SSH подключения для отображения в раскрывающемся списке окружения [Desktop](/docs/ru/desktop#pre-configure-ssh-connections-for-your-team). Каждая запись требует `id`, `name` и `sshHost`; `sshPort`, `sshIdentityFile` и `startDirectory` являются необязательными. При установке в управляемых параметрах подключения доступны только для чтения для пользователей. Читается только из управляемых и пользовательских параметров | `[{"id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com"}]` |

321| `statusLine` | Настройте пользовательскую строку состояния для отображения контекста. Поле объекта `padding`, `refreshInterval` и `hideVimModeIndicator` управляют интервалом, периодическими повторными запусками и тем, скрыт ли встроенный индикатор режима vim ниже приглашения. См. [документацию `statusLine`](/ru/statusline#manually-configure-a-status-line) | `{"type": "command", "command": "~/.claude/statusline.sh"}` |321| `statusLine` | Настройте пользовательскую строку состояния для отображения контекста. Поле объекта `padding`, `refreshInterval` и `hideVimModeIndicator` управляют интервалом, периодическими повторными запусками и тем, скрыт ли встроенный индикатор режима vim ниже приглашения. См. [документацию `statusLine`](/docs/ru/statusline#manually-configure-a-status-line) | `{"type": "command", "command": "~/.claude/statusline.sh"}` |

322| `strictKnownMarketplaces` | (Только управляемые параметры) Список разрешений источников marketplace plugins. Не определено = без ограничений, пустой массив = блокировка. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |322| `strictKnownMarketplaces` | (Только управляемые параметры) Список разрешений источников marketplace plugins. Не определено = без ограничений, пустой массив = блокировка. Применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin, поэтому marketplace, добавленный до установки политики, не может быть использован для получения plugins. Заблокированные источники проверяются перед загрузкой, поэтому они никогда не касаются файловой системы. См. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

323| `strictPluginOnlyCustomization` | (Только управляемые параметры) Блокировать skills, agents, hooks и MCP servers из источников пользователя и проекта, поэтому они могут поступать только из plugins или управляемых параметров. `true` блокирует все четыре поверхности; массив блокирует только названные. См. [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |323| `strictPluginOnlyCustomization` | (Только управляемые параметры) Блокировать skills, agents, hooks и MCP servers из источников пользователя и проекта, поэтому они могут поступать только из plugins или управляемых параметров. `true` блокирует все четыре поверхности; массив блокирует только названные. См. [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

324| `syntaxHighlightingDisabled` | Отключить подсветку синтаксиса в дифах, блоках кода и предпросмотрах файлов | `true` |324| `syntaxHighlightingDisabled` | Отключить подсветку синтаксиса в дифах, блоках кода и предпросмотрах файлов | `true` |

325| `teammateMode` | **По умолчанию**: `in-process`. Как отображаются товарищи по [команде агентов](/ru/agent-teams): `in-process`, `auto` (разделенные панели в tmux или iTerm2, в процессе в противном случае), `tmux` (разделенные панели с использованием tmux или iTerm2, обнаруженные из вашего терминала), или {/* min-version: 2.1.186 */}}`iterm2` (iTerm2 native split panes via the `it2` CLI, added in v2.1.186). По умолчанию изменилось с `auto` в v2.1.179. `--teammate-mode` переопределяет это на один сеанс. См. [выбрать режим отображения](/ru/agent-teams#choose-a-display-mode) | `"auto"` |325| `teammateMode` | **По умолчанию**: `in-process`. Как отображаются товарищи по [команде агентов](/docs/ru/agent-teams): `in-process`, `auto` (разделенные панели в tmux или iTerm2, в процессе в противном случае), `tmux` (разделенные панели с использованием tmux или iTerm2, обнаруженные из вашего терминала), или }`iterm2` (iTerm2 native split panes via the `it2` CLI, added in v2.1.186). По умолчанию изменилось с `auto` в v2.1.179. `--teammate-mode` переопределяет это на один сеанс. См. [выбрать режим отображения](/docs/ru/agent-teams#choose-a-display-mode) | `"auto"` |

326| `terminalProgressBarEnabled` | **По умолчанию**: `true`. Показывать полосу прогресса терминала в поддерживаемых терминалах: ConEmu, Ghostty 1.2.0+ и iTerm2 3.6.6+. Появляется в `/config` как **Terminal progress bar** | `false` |326| `terminalProgressBarEnabled` | **По умолчанию**: `true`. Показывать полосу прогресса терминала в поддерживаемых терминалах: ConEmu, Ghostty 1.2.0+ и iTerm2 3.6.6+. Появляется в `/config` как **Terminal progress bar** | `false` |

327| `theme` | {{/* min-version: 2.1.119 */}}**По умолчанию**: `"dark"`. Цветовая тема для интерфейса: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` или ссылка на пользовательскую тему, такая как `"custom:<slug>"` или `"custom:<plugin-name>:<slug>"`. См. [Создать пользовательскую тему](/ru/terminal-config#create-a-custom-theme). Появляется в `/config` как **Theme** | `"dark"` |327| `theme` | {{/* min-version: 2.1.119 */}}**По умолчанию**: `"dark"`. Цветовая тема для интерфейса: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"` или ссылка на пользовательскую тему, такая как `"custom:<slug>"` или `"custom:<plugin-name>:<slug>"`. См. [Создать пользовательскую тему](/docs/ru/terminal-config#create-a-custom-theme). Появляется в `/config` как **Theme** | `"dark"` |

328| `tui` | Средство визуализации Terminal UI. Используйте `"fullscreen"` для безмерцающего [alt-screen renderer](/ru/fullscreen) с виртуализированной прокруткой. Используйте `"default"` для классического main-screen renderer. Установите через `/tui`. Вы также можете установить переменную окружения [`CLAUDE_CODE_NO_FLICKER`](/ru/env-vars). Фоновые сеансы, открытые из [представления агента](/ru/agent-view), всегда используют fullscreen renderer независимо от этого параметра | `"fullscreen"` |328| `tui` | Средство визуализации Terminal UI. Используйте `"fullscreen"` для безмерцающего [alt-screen renderer](/docs/ru/fullscreen) с виртуализированной прокруткой. Используйте `"default"` для классического main-screen renderer. Установите через `/tui`. Вы также можете установить переменную окружения [`CLAUDE_CODE_NO_FLICKER`](/docs/ru/env-vars). Фоновые сеансы, открытые из [представления агента](/docs/ru/agent-view), всегда используют fullscreen renderer независимо от этого параметра | `"fullscreen"` |

329| `ultracode` | Включить [ultracode](/ru/workflows#let-claude-decide-with-ultracode) для сеанса. Этот ключ не читается из `settings.json`. Установите через `/effort ultracode`, `--settings` или запрос управления Agent SDK. {{/* min-version: 2.1.203 */}}Чтобы запустить сеанс с уже включенным ultracode, запустите с `claude --effort ultracode`, что требует Claude Code v2.1.203 или позже | `true` |329| `ultracode` | Включить [ultracode](/docs/ru/workflows#let-claude-decide-with-ultracode) для сеанса. Этот ключ не читается из `settings.json`. Установите через `/effort ultracode`, `--settings` или запрос управления Agent SDK. {{/* min-version: 2.1.203 */}}Чтобы запустить сеанс с уже включенным ultracode, запустите с `claude --effort ultracode`, что требует Claude Code v2.1.203 или позже | `true` |

330| `useAutoModeDuringPlan` | **По умолчанию**: `true`. Использует ли Plan Mode семантику автоматического режима, когда автоматический режим доступен. Не читается из общих параметров проекта. Появляется в `/config` как "Use auto mode during plan" | `false` |330| `useAutoModeDuringPlan` | **По умолчанию**: `true`. Использует ли Plan Mode семантику автоматического режима, когда автоматический режим доступен. Не читается из общих параметров проекта. Появляется в `/config` как "Use auto mode during plan" | `false` |

331| `verbose` | {{/* min-version: 2.1.119 */}}**По умолчанию**: `false`. Показать полный вывод инструмента вместо усеченных сводок. Появляется в `/config` как **Verbose output**. Флаг `--verbose` переопределяет это на один сеанс | `true` |331| `verbose` | {{/* min-version: 2.1.119 */}}**По умолчанию**: `false`. Показать полный вывод инструмента вместо усеченных сводок. Появляется в `/config` как **Verbose output**. Флаг `--verbose` переопределяет это на один сеанс | `true` |

332| `viewMode` | Режим просмотра стенограммы по умолчанию при запуске: `"default"`, `"verbose"` или `"focus"`. Переопределяет липкий выбор `/focus` при установке. Флаг `--verbose` переопределяет это на один сеанс | `"verbose"` |332| `viewMode` | Режим просмотра стенограммы по умолчанию при запуске: `"default"`, `"verbose"` или `"focus"`. Переопределяет липкий выбор `/focus` при установке. Флаг `--verbose` переопределяет это на один сеанс | `"verbose"` |

333| `vimInsertModeRemaps` | {{/* min-version: 2.1.208 */}}Сопоставить двухклавишные последовательности режима INSERT с Escape в [режиме редактора vim](/ru/interactive-mode#vim-editor-mode). Каждый ключ - это ровно два печатаемых символа, введенные последовательно, и `"<Esc>"` - единственная поддерживаемая цель; другие записи игнорируются. Читается из параметров пользователя, флага `--settings` и управляемых параметров только, поэтому проверенные в репозитории параметры не могут переопределить ваши сочетания клавиш. Не имеет эффекта, если `editorMode` не `"vim"`. См. [Переопределить сочетания клавиш режима INSERT](/ru/interactive-mode#remap-insert-mode-key-sequences). Требует Claude Code v2.1.208 или позже | `{"jj": "<Esc>"}` |333| `vimInsertModeRemaps` | {{/* min-version: 2.1.208 */}}Сопоставить двухклавишные последовательности режима INSERT с Escape в [режиме редактора vim](/docs/ru/interactive-mode#vim-editor-mode). Каждый ключ - это ровно два печатаемых символа, введенные последовательно, и `"<Esc>"` - единственная поддерживаемая цель; другие записи игнорируются. Читается из параметров пользователя, флага `--settings` и управляемых параметров только, поэтому проверенные в репозитории параметры не могут переопределить ваши сочетания клавиш. Не имеет эффекта, если `editorMode` не `"vim"`. См. [Переопределить сочетания клавиш режима INSERT](/docs/ru/interactive-mode#remap-insert-mode-key-sequences). Требует Claude Code v2.1.208 или позже | `{"jj": "<Esc>"}` |

334| `voice` | Параметры [голосового диктанта](/ru/voice-dictation): `enabled` включает диктант, `mode` выбирает `"hold"` или `"tap"`, и `autoSubmit` отправляет запрос при отпускании клавиши в режиме hold. Записывается автоматически при запуске `/voice`. Требует учетную запись Claude.ai | `{ "enabled": true, "mode": "tap" }` |334| `voice` | Параметры [голосового диктанта](/docs/ru/voice-dictation): `enabled` включает диктант, `mode` выбирает `"hold"` или `"tap"`, и `autoSubmit` отправляет запрос при отпускании клавиши в режиме hold. Записывается автоматически при запуске `/voice`. Требует учетную запись Claude.ai | `{ "enabled": true, "mode": "tap" }` |

335| `voiceEnabled` | Устаревший псевдоним для `voice.enabled`. Предпочитайте объект `voice` | `true` |335| `voiceEnabled` | Устаревший псевдоним для `voice.enabled`. Предпочитайте объект `voice` | `true` |

336| `wheelScrollAccelerationEnabled` | {{/* min-version: 2.1.174 */}}**По умолчанию**: `true`. В [fullscreen rendering](/ru/fullscreen#mouse-wheel-scrolling), ускорить скорость прокрутки колеса мыши во время быстрой прокрутки. Установите на `false` для постоянной скорости прокрутки за один оборот колеса. Требует Claude Code v2.1.174 или позже | `false` |336| `wheelScrollAccelerationEnabled` | {{/* min-version: 2.1.174 */}}**По умолчанию**: `true`. В [fullscreen rendering](/docs/ru/fullscreen#mouse-wheel-scrolling), ускорить скорость прокрутки колеса мыши во время быстрой прокрутки. Установите на `false` для постоянной скорости прокрутки за один оборот колеса. Требует Claude Code v2.1.174 или позже | `false` |

337| `workflowKeywordTriggerEnabled` | {{/* min-version: 2.1.157 */}}**По умолчанию**: `true`. Вызывает ли слово `ultracode` в запросе [динамический workflow](/ru/workflows#ask-for-a-workflow-in-your-prompt). Установите на `false`, чтобы вводить слово без срабатывания. Ultracode, `/workflows` и сохраненные команды workflow не затронуты. Появляется в `/config` как **Ultracode keyword trigger**. Добавлено в v2.1.157; до v2.1.160 ключевое слово триггера было `workflow` | `false` |337| `workflowKeywordTriggerEnabled` | {{/* min-version: 2.1.157 */}}**По умолчанию**: `true`. Вызывает ли слово `ultracode` в запросе [динамический workflow](/docs/ru/workflows#ask-for-a-workflow-in-your-prompt). Установите на `false`, чтобы вводить слово без срабатывания. Ultracode, `/workflows` и сохраненные команды workflow не затронуты. Появляется в `/config` как **Ultracode keyword trigger**. Добавлено в v2.1.157; до v2.1.160 ключевое слово триггера было `workflow` | `false` |

338| `wslInheritsWindowsSettings` | (Только управляемые параметры Windows) Когда `true`, Claude Code на WSL читает управляемые параметры из цепочки политик Windows в дополнение к `/etc/claude-code`, с приоритетом источников Windows. Учитывается только при установке в ключе реестра HKLM или `C:\Program Files\ClaudeCode\managed-settings.json`, оба из которых требуют администратора Windows для записи. Чтобы политика HKCU также применялась на WSL, флаг должен быть дополнительно установлен в самом HKCU. Не влияет на нативный Windows | `true` |338| `wslInheritsWindowsSettings` | (Только управляемые параметры Windows) Когда `true`, Claude Code на WSL читает управляемые параметры из цепочки политик Windows в дополнение к `/etc/claude-code`, с приоритетом источников Windows. Учитывается только при установке в ключе реестра HKLM или `C:\Program Files\ClaudeCode\managed-settings.json`, оба из которых требуют администратора Windows для записи. Чтобы политика HKCU также применялась на WSL, флаг должен быть дополнительно установлен в самом HKCU. Не влияет на нативный Windows | `true` |

339 339 

340<h3 id="global-config-settings">340<h3 id="global-config-settings">


349 349 

350| Ключ | Описание | Пример |350| Ключ | Описание | Пример |

351| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |351| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |

352| `autoConnectIde` | **По умолчанию**: `false`. Автоматически подключаться к запущенной IDE при запуске Claude Code из внешнего терминала. Появляется в `/config` как **Auto-connect to IDE (external terminal)** при запуске вне терминала VS Code или JetBrains. Переменная окружения [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/ru/env-vars) переопределяет это при установке | `true` |352| `autoConnectIde` | **По умолчанию**: `false`. Автоматически подключаться к запущенной IDE при запуске Claude Code из внешнего терминала. Появляется в `/config` как **Auto-connect to IDE (external terminal)** при запуске вне терминала VS Code или JetBrains. Переменная окружения [`CLAUDE_CODE_AUTO_CONNECT_IDE`](/docs/ru/env-vars) переопределяет это при установке | `true` |

353| `autoInstallIdeExtension` | **По умолчанию**: `true`. Автоматически устанавливать расширение Claude Code IDE при запуске из терминала VS Code. Появляется в `/config` как **Auto-install IDE extension** при запуске внутри терминала VS Code или JetBrains. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/ru/env-vars) на `1` | `false` |353| `autoInstallIdeExtension` | **По умолчанию**: `true`. Автоматически устанавливать расширение Claude Code IDE при запуске из терминала VS Code. Появляется в `/config` как **Auto-install IDE extension** при запуске внутри терминала VS Code или JetBrains. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/ru/env-vars) на `1` | `false` |

354| `externalEditorContext` | **По умолчанию**: `false`. Добавить предыдущий ответ Claude как контекст с комментариями `#` при открытии внешнего редактора с помощью `Ctrl+G`. Появляется в `/config` как **Show last response in external editor** | `true` |354| `externalEditorContext` | **По умолчанию**: `false`. Добавить предыдущий ответ Claude как контекст с комментариями `#` при открытии внешнего редактора с помощью `Ctrl+G`. Появляется в `/config` как **Show last response in external editor** | `true` |

355| `permissionExplainerEnabled` | **По умолчанию**: `true`. Показать объяснение, созданное моделью, [команды](/ru/permissions#permission-system) при нажатии `Ctrl+E` на запросе разрешения Bash или PowerShell. Установите на `false`, чтобы отключить сочетание клавиш | `false` |355| `permissionExplainerEnabled` | **По умолчанию**: `true`. Показать объяснение, созданное моделью, [команды](/docs/ru/permissions#permission-system) при нажатии `Ctrl+E` на запросе разрешения Bash или PowerShell. Установите на `false`, чтобы отключить сочетание клавиш | `false` |

356| `teammateDefaultModel` | Модель по умолчанию для товарищей по [команде агентов](/ru/agent-teams) когда запрос порождения не указывает одну. Установите на псевдоним модели, такой как `"sonnet"`, или `null` для наследования текущего выбора `/model` лидера. Появляется в `/config` как **Default teammate model** | `"sonnet"` |356| `teammateDefaultModel` | Модель по умолчанию для товарищей по [команде агентов](/docs/ru/agent-teams) когда запрос порождения не указывает одну. Установите на псевдоним модели, такой как `"sonnet"`, или `null` для наследования текущего выбора `/model` лидера. Появляется в `/config` как **Default teammate model** | `"sonnet"` |

357| `workflowSizeGuideline` | {{/* min-version: 2.1.202 */}}**По умолчанию**: `unrestricted`, который не отправляет никакого руководства. Устанавливает [количество агентов, на которое Claude нацелен](/ru/workflows#set-a-size-guideline) в динамических workflows, которые он пишет. Claude Code отправляет значение Claude как совет, а не как принудительный лимит. Принимает `unrestricted`, `small`, `medium` или `large`. Появляется в `/config` как **Dynamic workflow size**. Вы также можете установить его напрямую с помощью `/config workflowSizeGuideline=small`. Требует Claude Code v2.1.202 или позже. {{/* min-version: 2.1.203 */}}Руководство по количеству агентов также заменяет порог по умолчанию для [предупреждения `Large workflow`](/ru/workflows#cost); это поведение требует Claude Code v2.1.203 или позже | `"small"` |357| `workflowSizeGuideline` | {{/* min-version: 2.1.202 */}}**По умолчанию**: `unrestricted`, который не отправляет никакого руководства. Устанавливает [количество агентов, на которое Claude нацелен](/docs/ru/workflows#set-a-size-guideline) в динамических workflows, которые он пишет. Claude Code отправляет значение Claude как совет, а не как принудительный лимит. Принимает `unrestricted`, `small`, `medium` или `large`. Появляется в `/config` как **Dynamic workflow size**. Вы также можете установить его напрямую с помощью `/config workflowSizeGuideline=small`. Требует Claude Code v2.1.202 или позже. {{/* min-version: 2.1.203 */}}Руководство по количеству агентов также заменяет порог по умолчанию для [предупреждения `Large workflow`](/docs/ru/workflows#cost); это поведение требует Claude Code v2.1.203 или позже | `"small"` |

358 358 

359<h3 id="worktree-settings">359<h3 id="worktree-settings">

360 Параметры Worktree360 Параметры Worktree


366| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |366| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

367| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/<default-branch>` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Внутри связанного worktree, `"head"` разрешается в `HEAD` этого worktree, а не в основной проверке. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |367| `worktree.baseRef` | Какой ref новые worktrees ветвятся от. `"fresh"` (по умолчанию) ветвится от `origin/<default-branch>` для чистого дерева, соответствующего удаленному. `"head"` ветвится от вашего текущего локального `HEAD`, поэтому неотправленные коммиты и состояние ветки функции присутствуют в worktree. Внутри связанного worktree, `"head"` разрешается в `HEAD` этого worktree, а не в основной проверке. Применяется к `--worktree`, инструменту `EnterWorktree` и изоляции subagent | `"head"` |

368| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |368| `worktree.symlinkDirectories` | Каталоги для создания символических ссылок из основного репозитория в каждый worktree, чтобы избежать дублирования больших каталогов на диске. По умолчанию никакие каталоги не создаются символическими ссылками | `["node_modules", ".cache"]` |

369| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях. Пока существует разреженный worktree, git включает `extensions.worktreeConfig` в общий файл `.git/config` репозитория; см. [Проверить только нужные вам каталоги](/ru/large-codebases#check-out-only-the-directories-you-need) | `["packages/my-app", "shared/utils"]` |369| `worktree.sparsePaths` | Каталоги для проверки в каждом worktree через git sparse-checkout. На диск записываются только перечисленные пути, что быстрее в больших монорепозиториях. Пока существует разреженный worktree, git включает `extensions.worktreeConfig` в общий файл `.git/config` репозитория; см. [Проверить только нужные вам каталоги](/docs/ru/large-codebases#check-out-only-the-directories-you-need) | `["packages/my-app", "shared/utils"]` |

370| `worktree.bgIsolation` | {{/* min-version: 2.1.143 */}}Режим изоляции для [фоновых сеансов](/ru/agent-view#how-file-edits-are-isolated). `"worktree"` (по умолчанию) блокирует `Edit`/`Write` в основной проверке до вызова `EnterWorktree`. {{/* min-version: 2.1.203 */}}Вне git репозитория, [hook `WorktreeCreate`](/ru/worktrees#non-git-version-control), который не удается, освобождает блок, чтобы сеанс мог редактировать рабочий каталог на месте; требует Claude Code v2.1.203 или позже. `"none"` позволяет фоновым заданиям редактировать рабочую копию напрямую. Требует Claude Code v2.1.143 или позже | `"none"` |370| `worktree.bgIsolation` | {{/* min-version: 2.1.143 */}}Режим изоляции для [фоновых сеансов](/docs/ru/agent-view#how-file-edits-are-isolated). `"worktree"` (по умолчанию) блокирует `Edit`/`Write` в основной проверке до вызова `EnterWorktree`. {{/* min-version: 2.1.203 */}}Вне git репозитория, [hook `WorktreeCreate`](/docs/ru/worktrees#non-git-version-control), который не удается, освобождает блок, чтобы сеанс мог редактировать рабочий каталог на месте; требует Claude Code v2.1.203 или позже. `"none"` позволяет фоновым заданиям редактировать рабочую копию напрямую. Требует Claude Code v2.1.143 или позже | `"none"` |

371 371 

372Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.372Чтобы скопировать файлы, игнорируемые gitignore, такие как `.env`, в новые worktrees, используйте [файл `.worktreeinclude`](/docs/ru/worktrees#copy-gitignored-files-into-worktrees) в корне вашего проекта вместо параметра.

373 373 

374<h3 id="permission-settings">374<h3 id="permission-settings">

375 Параметры разрешений375 Параметры разрешений


379| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |379| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |

380| `allow` | Массив правил разрешений для разрешения использования инструмента. Глобусы имен инструментов поддерживаются только в позиции инструмента после буквального префикса `mcp__<server>__`, такого как `mcp__github__get_*`; сегмент сервера должен быть без глобусов. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |380| `allow` | Массив правил разрешений для разрешения использования инструмента. Глобусы имен инструментов поддерживаются только в позиции инструмента после буквального префикса `mcp__<server>__`, такого как `mcp__github__get_*`; сегмент сервера должен быть без глобусов. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже для деталей сопоставления шаблонов | `[ "Bash(git diff *)" ]` |

381| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |381| `ask` | Массив правил разрешений для запроса подтверждения при использовании инструмента. См. [Синтаксис правила разрешения](#permission-rule-syntax) ниже | `[ "Bash(git push *)" ]` |

382| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. Имена инструментов принимают глобусы: `"*"` запрещает каждый инструмент и `"mcp__*"` запрещает все MCP инструменты. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |382| `deny` | Массив правил разрешений для запрета использования инструмента. Используйте это для исключения чувствительных файлов из доступа Claude Code. Имена инструментов принимают глобусы: `"*"` запрещает каждый инструмент и `"mcp__*"` запрещает все MCP инструменты. См. [Синтаксис правила разрешения](#permission-rule-syntax) и [Ограничения разрешений Bash](/docs/ru/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

383| `additionalDirectories` | Дополнительные [рабочие каталоги](/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |383| `additionalDirectories` | Дополнительные [рабочие каталоги](/docs/ru/permissions#working-directories) для доступа к файлам. Большинство конфигурации `.claude/` [не обнаруживается](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) из этих каталогов | `[ "../docs/" ]` |

384| `defaultMode` | Режим [разрешения](/ru/permission-modes) по умолчанию при открытии Claude Code. Допустимые значения: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` и {{/* min-version: 2.1.200 */}}`manual` как псевдоним для `default`, режим, обозначенный как Manual в CLI и расширениях VS Code и JetBrains. Псевдоним `manual` требует Claude Code v2.1.200 или позже. {{/* min-version: 2.1.142 */}}`auto` игнорируется при установке в параметрах проекта или локальных параметрах, поэтому репозиторий не может предоставить себе автоматический режим; установите его в `~/.claude/settings.json` вместо этого. До v2.1.142 параметры проекта могли устанавливать `auto`. Флаг CLI `--permission-mode` переопределяет этот параметр для одного сеанса | `"acceptEdits"` |384| `defaultMode` | Режим [разрешения](/docs/ru/permission-modes) по умолчанию при открытии Claude Code. Допустимые значения: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` и {{/* min-version: 2.1.200 */}}`manual` как псевдоним для `default`, режим, обозначенный как Manual в CLI и расширениях VS Code и JetBrains. Псевдоним `manual` требует Claude Code v2.1.200 или позже. {{/* min-version: 2.1.142 */}}`auto` игнорируется при установке в параметрах проекта или локальных параметрах, поэтому репозиторий не может предоставить себе автоматический режим; установите его в `~/.claude/settings.json` вместо этого. До v2.1.142 параметры проекта могли устанавливать `auto`. Флаг CLI `--permission-mode` переопределяет этот параметр для одного сеанса | `"acceptEdits"` |

385| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |385| `disableBypassPermissionsMode` | Установите на `"disable"`, чтобы предотвратить активацию режима `bypassPermissions`. Это отключает флаг командной строки `--dangerously-skip-permissions`. Обычно размещается в [управляемых параметрах](/docs/ru/permissions#managed-settings) для применения организационной политики, но работает из любой области | `"disable"` |

386| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |386| `skipDangerousModePermissionPrompt` | Пропустить подтверждение, показываемое перед входом в режим обхода разрешений через `--dangerously-skip-permissions` или `defaultMode: "bypassPermissions"`. Игнорируется при установке в параметрах проекта (`.claude/settings.json`) для предотвращения автоматического обхода подтверждения ненадежными репозиториями | `true` |

387 387 

388<h3 id="permission-rule-syntax">388<h3 id="permission-rule-syntax">

389 Синтаксис правила разрешения389 Синтаксис правила разрешения

390</h3>390</h3>

391 391 

392Правила разрешения следуют формату `Tool` или `Tool(specifier)`. Правила оцениваются по порядку: сначала правила deny, затем ask, затем allow. Первое совпадающее правило определяет результат независимо от специфичности правила. См. [порядок оценки правила разрешения](/ru/permissions#manage-permissions) для деталей.392Правила разрешения следуют формату `Tool` или `Tool(specifier)`. Правила оцениваются по порядку: сначала правила deny, затем ask, затем allow. Первое совпадающее правило определяет результат независимо от специфичности правила. См. [порядок оценки правила разрешения](/docs/ru/permissions#manage-permissions) для деталей.

393 393 

394Быстрые примеры:394Быстрые примеры:

395 395 


400| `Read(./.env)` | Соответствует чтению файла `.env` |400| `Read(./.env)` | Соответствует чтению файла `.env` |

401| `WebFetch(domain:example.com)` | Соответствует запросам fetch к example.com |401| `WebFetch(domain:example.com)` | Соответствует запросам fetch к example.com |

402 402 

403Для полного справочника синтаксиса правил, включая поведение подстановочных знаков, шаблоны, специфичные для инструментов, для Read, Edit, WebFetch, MCP и Agent правил, а также ограничения безопасности шаблонов Bash, см. [Синтаксис правила разрешения](/ru/permissions#permission-rule-syntax).403Для полного справочника синтаксиса правил, включая поведение подстановочных знаков, шаблоны, специфичные для инструментов, для Read, Edit, WebFetch, MCP и Agent правил, а также ограничения безопасности шаблонов Bash, см. [Синтаксис правила разрешения](/docs/ru/permissions#permission-rule-syntax).

404 404 

405<h3 id="sandbox-settings">405<h3 id="sandbox-settings">

406 Параметры Sandbox406 Параметры Sandbox

407</h3>407</h3>

408 408 

409Настройте расширенное поведение sandboxing. Sandboxing изолирует команды bash от вашей файловой системы и сети. См. [Sandboxing](/ru/sandboxing) для деталей.409Настройте расширенное поведение sandboxing. Sandboxing изолирует команды bash от вашей файловой системы и сети. См. [Sandboxing](/docs/ru/sandboxing) для деталей.

410 410 

411| Ключи | Описание | Пример |411| Ключи | Описание | Пример |

412| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |412| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |


418| `filesystem.allowWrite` | Дополнительные пути, где команды в sandbox могут писать. Массивы объединяются во всех областях параметров: пути пользователя, проекта и управляемые пути объединяются, не заменяются. Также объединяются с путями из правил разрешения `Edit(...)`. См. [префиксы пути sandbox](#sandbox-path-prefixes) ниже. | `["/tmp/build", "~/.kube"]` |418| `filesystem.allowWrite` | Дополнительные пути, где команды в sandbox могут писать. Массивы объединяются во всех областях параметров: пути пользователя, проекта и управляемые пути объединяются, не заменяются. Также объединяются с путями из правил разрешения `Edit(...)`. См. [префиксы пути sandbox](#sandbox-path-prefixes) ниже. | `["/tmp/build", "~/.kube"]` |

419| `filesystem.denyWrite` | Пути, где команды в sandbox не могут писать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Edit(...)`. | `["/etc", "/usr/local/bin"]` |419| `filesystem.denyWrite` | Пути, где команды в sandbox не могут писать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Edit(...)`. | `["/etc", "/usr/local/bin"]` |

420| `filesystem.denyRead` | Пути, где команды в sandbox не могут читать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Read(...)`. | `["~/.aws/credentials"]` |420| `filesystem.denyRead` | Пути, где команды в sandbox не могут читать. Массивы объединяются во всех областях параметров. Также объединяются с путями из правил разрешения `Read(...)`. | `["~/.aws/credentials"]` |

421| `filesystem.allowRead` | Пути для повторного разрешения чтения в пределах регионов `denyRead`. Путь `allowRead` повторно открывает чтение внутри более широкого региона `denyRead`, и точный путь в `denyRead` остается заблокированным внутри более широкого `allowRead`; см. [таблицу перекрытия](/ru/sandboxing#configure-sandboxing) для примеров. Массивы объединяются во всех областях параметров. Используйте это для создания шаблонов доступа для чтения только рабочей области. | `["."]` |421| `filesystem.allowRead` | Пути для повторного разрешения чтения в пределах регионов `denyRead`. Путь `allowRead` повторно открывает чтение внутри более широкого региона `denyRead`, и точный путь в `denyRead` остается заблокированным внутри более широкого `allowRead`; см. [таблицу перекрытия](/docs/ru/sandboxing#configure-sandboxing) для примеров. Массивы объединяются во всех областях параметров. Используйте это для создания шаблонов доступа для чтения только рабочей области. | `["."]` |

422| `filesystem.allowManagedReadPathsOnly` | (Только управляемые параметры) Только пути `allowRead` из управляемых параметров учитываются. `denyRead` по-прежнему объединяется из всех источников. По умолчанию: false | `true` |422| `filesystem.allowManagedReadPathsOnly` | (Только управляемые параметры) Только пути `allowRead` из управляемых параметров учитываются. `denyRead` по-прежнему объединяется из всех источников. По умолчанию: false | `true` |

423| `credentials.files` | {{/* min-version: 2.1.187 */}}Файлы учетных данных или каталоги, которые команды в sandbox не могут читать. Применяет тот же блок чтения, что и `filesystem.denyRead`; отдельный ключ держит пути учетных данных сгруппированными с `credentials.envVars` и отдельно от общих правил файловой системы. Каждая запись - это `{ "path": "...", "mode": "deny" }`, и `deny` - единственный поддерживаемый режим для файлов. Пути используют те же [префиксы](#sandbox-path-prefixes), что и параметры `filesystem.*`. Массивы объединяются во всех областях параметров. Требует Claude Code v2.1.187 или позже. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |423| `credentials.files` | {{/* min-version: 2.1.187 */}}Файлы учетных данных или каталоги, которые команды в sandbox не могут читать. Применяет тот же блок чтения, что и `filesystem.denyRead`; отдельный ключ держит пути учетных данных сгруппированными с `credentials.envVars` и отдельно от общих правил файловой системы. Каждая запись - это `{ "path": "...", "mode": "deny" }`, и `deny` - единственный поддерживаемый режим для файлов. Пути используют те же [префиксы](#sandbox-path-prefixes), что и параметры `filesystem.*`. Массивы объединяются во всех областях параметров. Требует Claude Code v2.1.187 или позже. | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

424| `credentials.envVars` | {{/* min-version: 2.1.187 */}}Переменные окружения для [защиты от команд в sandbox](/ru/sandboxing#protect-credentials). Каждая запись имеет `name` и `mode`; имя должно начинаться с буквы или подчеркивания и содержать только буквы, цифры и подчеркивания. `deny` удаляет переменную из окружения команд в sandbox. Требует Claude Code v2.1.187 или позже. {{/* min-version: 2.1.199 */}}`mask` заменяет переменную значением-дозорным для каждого сеанса внутри sandbox, пока прокси sandbox подставляет реальное значение на исходящих запросах к записям `injectHosts` этой записи; это требует `network.tlsTerminate` и Claude Code v2.1.199 или позже. Записи `mask` учитываются только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Массивы объединяются во всех областях параметров, и `deny` имеет приоритет, когда одна переменная появляется с обоими режимами. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |424| `credentials.envVars` | {{/* min-version: 2.1.187 */}}Переменные окружения для [защиты от команд в sandbox](/docs/ru/sandboxing#protect-credentials). Каждая запись имеет `name` и `mode`; имя должно начинаться с буквы или подчеркивания и содержать только буквы, цифры и подчеркивания. `deny` удаляет переменную из окружения команд в sandbox. Требует Claude Code v2.1.187 или позже. {{/* min-version: 2.1.199 */}}`mask` заменяет переменную значением-дозорным для каждого сеанса внутри sandbox, пока прокси sandbox подставляет реальное значение на исходящих запросах к записям `injectHosts` этой записи; это требует `network.tlsTerminate` и Claude Code v2.1.199 или позже. Записи `mask` учитываются только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Массивы объединяются во всех областях параметров, и `deny` имеет приоритет, когда одна переменная появляется с обоими режимами. | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

425| `credentials.envVars[].injectHosts` | Хосты, где прокси sandbox подставляет реальное значение записи `mask`. Каждый хост также должен быть покрыт `network.allowedDomains`, либо точно, либо подстановочным знаком. Когда не установлено, прокси подставляет значение на запросы каждому хосту в `network.allowedDomains`. Принимается, но игнорируется, когда `mode` - `deny`. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `["api.github.com"]` |425| `credentials.envVars[].injectHosts` | Хосты, где прокси sandbox подставляет реальное значение записи `mask`. Каждый хост также должен быть покрыт `network.allowedDomains`, либо точно, либо подстановочным знаком. Когда не установлено, прокси подставляет значение на запросы каждому хосту в `network.allowedDomains`. Принимается, но игнорируется, когда `mode` - `deny`. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `["api.github.com"]` |

426| `credentials.allowPlaintextInject` | Разрешить подстановку `mask` на простых HTTP запросах, а также на TLS-завершенных HTTPS. На простом HTTP восходящая идентификация не проверена и учетные данные путешествуют в открытом виде, поэтому оставьте это отключенным вне доверенных тестовых сетей. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. По умолчанию: false. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `true` |426| `credentials.allowPlaintextInject` | Разрешить подстановку `mask` на простых HTTP запросах, а также на TLS-завершенных HTTPS. На простом HTTP восходящая идентификация не проверена и учетные данные путешествуют в открытом виде, поэтому оставьте это отключенным вне доверенных тестовых сетей. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. По умолчанию: false. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `true` |

427| `network.allowUnixSockets` | (Только macOS) Пути Unix socket, доступные в sandbox. Игнорируется на Linux и WSL2, где фильтр seccomp не может проверить пути socket; используйте `allowAllUnixSockets` вместо этого. | `["~/.ssh/agent-socket"]` |427| `network.allowUnixSockets` | (Только macOS) Пути Unix socket, доступные в sandbox. Игнорируется на Linux и WSL2, где фильтр seccomp не может проверить пути socket; используйте `allowAllUnixSockets` вместо этого. | `["~/.ssh/agent-socket"]` |


433| `network.allowManagedDomainsOnly` | (Только управляемые параметры) Только `allowedDomains` и правила разрешения `WebFetch(domain:...)` из управляемых параметров учитываются. Домены из параметров пользователя, проекта и локальной области игнорируются. Неразрешенные домены автоматически блокируются без запроса пользователя. Запрещенные домены по-прежнему учитываются из всех источников. По умолчанию: false | `true` |433| `network.allowManagedDomainsOnly` | (Только управляемые параметры) Только `allowedDomains` и правила разрешения `WebFetch(domain:...)` из управляемых параметров учитываются. Домены из параметров пользователя, проекта и локальной области игнорируются. Неразрешенные домены автоматически блокируются без запроса пользователя. Запрещенные домены по-прежнему учитываются из всех источников. По умолчанию: false | `true` |

434| `network.httpProxyPort` | Порт HTTP прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8080` |434| `network.httpProxyPort` | Порт HTTP прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8080` |

435| `network.socksProxyPort` | Порт SOCKS5 прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8081` |435| `network.socksProxyPort` | Порт SOCKS5 прокси, используемый, если вы хотите использовать собственный прокси. Если не указано, Claude запустит собственный прокси. | `8081` |

436| `network.tlsTerminate` | Экспериментально. Завершить TLS внутри прокси sandbox, чтобы он мог читать содержимое HTTPS запросов. Требуется для [подстановки учетных данных](/ru/sandboxing#protect-credentials) `mask`. Установите `{}` для создания эфемерного центра сертификации для сеанса, или установите `caCertPath` и `caKeyPath` для использования вашего собственного. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `{}` |436| `network.tlsTerminate` | Экспериментально. Завершить TLS внутри прокси sandbox, чтобы он мог читать содержимое HTTPS запросов. Требуется для [подстановки учетных данных](/docs/ru/sandboxing#protect-credentials) `mask`. Установите `{}` для создания эфемерного центра сертификации для сеанса, или установите `caCertPath` и `caKeyPath` для использования вашего собственного. Учитывается только из параметров пользователя, управляемых или CLI `--settings`, а не из `.claude/settings.json` или `.claude/settings.local.json`. Требует Claude Code v2.1.199 или позже. {{/* min-version: 2.1.199 */}} | `{}` |

437| `enableWeakerNestedSandbox` | Включить более слабый sandbox для непривилегированных окружений Docker (только Linux и WSL2). **Снижает безопасность.** По умолчанию: false | `true` |437| `enableWeakerNestedSandbox` | Включить более слабый sandbox для непривилегированных окружений Docker (только Linux и WSL2). **Снижает безопасность.** По умолчанию: false | `true` |

438| `enableWeakerNetworkIsolation` | (Только macOS) Разрешить доступ к системной службе доверия TLS (`com.apple.trustd.agent`) в sandbox. Требуется для инструментов на основе Go, таких как `gh`, `gcloud` и `terraform`, для проверки сертификатов TLS при использовании `httpProxyPort` с MITM прокси и пользовательским CA. **Снижает безопасность** путем открытия потенциального пути утечки данных. По умолчанию: false | `true` |438| `enableWeakerNetworkIsolation` | (Только macOS) Разрешить доступ к системной службе доверия TLS (`com.apple.trustd.agent`) в sandbox. Требуется для инструментов на основе Go, таких как `gh`, `gcloud` и `terraform`, для проверки сертификатов TLS при использовании `httpProxyPort` с MITM прокси и пользовательским CA. **Снижает безопасность** путем открытия потенциального пути утечки данных. По умолчанию: false | `true` |

439| `allowAppleEvents` | (Только macOS) Разрешить команды в sandbox отправлять Apple Events. Требуется для `open`, `osascript` и инструментов, которые открывают URL в браузере, которые в противном случае не удаются с ошибкой `-600`. **Удаляет изоляцию выполнения кода.** Команды в sandbox могут запускать другие приложения без sandbox без запроса пользователя; они также могут отправлять команды AppleScript запущенным приложениям, таким как Terminal, в соответствии с запросом согласия на автоматизацию macOS для каждого приложения (TCC). Учитывается только из параметров пользователя, управляемых или CLI, а не из параметров проекта. По умолчанию: false | `true` |439| `allowAppleEvents` | (Только macOS) Разрешить команды в sandbox отправлять Apple Events. Требуется для `open`, `osascript` и инструментов, которые открывают URL в браузере, которые в противном случае не удаются с ошибкой `-600`. **Удаляет изоляцию выполнения кода.** Команды в sandbox могут запускать другие приложения без sandbox без запроса пользователя; они также могут отправлять команды AppleScript запущенным приложениям, таким как Terminal, в соответствии с запросом согласия на автоматизацию macOS для каждого приложения (TCC). Учитывается только из параметров пользователя, управляемых или CLI, а не из параметров проекта. По умолчанию: false | `true` |

440| `bwrapPath` | (Только управляемые параметры, Linux/WSL2) Абсолютный путь к двоичному файлу bubblewrap (`bwrap`). Переопределяет автоматическое обнаружение через `PATH`. Учитывается только из [управляемых параметров](/ru/settings#settings-files), а не из параметров пользователя или проекта. Полезно, когда `bwrap` установлен в нестандартном местоположении в управляемых окружениях. | `/opt/admin/bwrap` |440| `bwrapPath` | (Только управляемые параметры, Linux/WSL2) Абсолютный путь к двоичному файлу bubblewrap (`bwrap`). Переопределяет автоматическое обнаружение через `PATH`. Учитывается только из [управляемых параметров](/docs/ru/settings#settings-files), а не из параметров пользователя или проекта. Полезно, когда `bwrap` установлен в нестандартном местоположении в управляемых окружениях. | `/opt/admin/bwrap` |

441| `socatPath` | (Только управляемые параметры, Linux/WSL2) Абсолютный путь к двоичному файлу `socat`, используемому для прокси сети sandbox. Переопределяет автоматическое обнаружение через `PATH`. Учитывается только из управляемых параметров. | `/opt/admin/socat` |441| `socatPath` | (Только управляемые параметры, Linux/WSL2) Абсолютный путь к двоичному файлу `socat`, используемому для прокси сети sandbox. Переопределяет автоматическое обнаружение через `PATH`. Учитывается только из управляемых параметров. | `/opt/admin/socat` |

442 442 

443<h4 id="sandbox-path-prefixes">443<h4 id="sandbox-path-prefixes">


454 454 

455Более старый префикс `//path` для абсолютных путей по-прежнему работает. Если вы ранее использовали одиночный слэш `/path`, ожидая разрешения относительно проекта, переключитесь на `./path`.455Более старый префикс `//path` для абсолютных путей по-прежнему работает. Если вы ранее использовали одиночный слэш `/path`, ожидая разрешения относительно проекта, переключитесь на `./path`.

456 456 

457Этот синтаксис отличается от [правил разрешения Read и Edit](/ru/permissions#read-and-edit), которые используют `//path` для абсолютного и `/path` для относительного к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` - это абсолютный путь.457Этот синтаксис отличается от [правил разрешения Read и Edit](/docs/ru/permissions#read-and-edit), которые используют `//path` для абсолютного и `/path` для относительного к проекту. Пути файловой системы sandbox используют стандартные соглашения: `/tmp/build` - это абсолютный путь.

458 458 

459**Пример конфигурации:**459**Пример конфигурации:**

460 460 


544}544}

545```545```

546 546 

547Команда запускается с теми же переменными окружения, что и [hooks](/ru/hooks), включая `CLAUDE_PROJECT_DIR`. Она получает JSON через stdin с полем `query`:547Команда запускается с теми же переменными окружения, что и [hooks](/docs/ru/hooks), включая `CLAUDE_PROJECT_DIR`. Она получает JSON через stdin с полем `query`:

548 548 

549```json theme={null}549```json theme={null}

550{"query": "src/comp"}550{"query": "src/comp"}


605 605 

606Когда ход завершается, Claude Code сопоставляет регулярное выражение `pattern` каждой записи с выводом хода на основном потоке, поэтому медленное регулярное выражение блокирует пользовательский интерфейс до завершения. Влож енные квантификаторы, такие как `(a+)+$`, могут занимать экспоненциально долго против определенных входов и замораживать сеанс, поэтому держите каждый `pattern` линейным и избегайте вложения `+` или `*`.606Когда ход завершается, Claude Code сопоставляет регулярное выражение `pattern` каждой записи с выводом хода на основном потоке, поэтому медленное регулярное выражение блокирует пользовательский интерфейс до завершения. Влож енные квантификаторы, такие как `(a+)+$`, могут занимать экспоненциально долго против определенных входов и замораживать сеанс, поэтому держите каждый `pattern` линейным и избегайте вложения `+` или `*`.

607 607 

608Значки нижнего колонтитула отображаются рядом с [пользовательской строкой состояния](/ru/statusline), когда она настроена; ни один не заменяет другой. Используйте строку состояния для строки, управляемой скриптом, которая вычисляет свой собственный контент из данных сеанса, и значки нижнего колонтитула для преобразования ID из разговора в ссылки без скрипта.608Значки нижнего колонтитула отображаются рядом с [пользовательской строкой состояния](/docs/ru/statusline), когда она настроена; ни один не заменяет другой. Используйте строку состояния для строки, управляемой скриптом, которая вычисляет свой собственный контент из данных сеанса, и значки нижнего колонтитула для преобразования ID из разговора в ссылки без скрипта.

609 609 

610<h3 id="hook-configuration">610<h3 id="hook-configuration">

611 Конфигурация Hook611 Конфигурация Hook


643 Вычислить управляемые параметры с помощью помощника политики643 Вычислить управляемые параметры с помощью помощника политики

644</h3>644</h3>

645 645 

646Параметр `policyHelper` указывает на исполняемый файл, который вычисляет управляемые параметры при запуске, поэтому администраторы могут получить политику из состояния устройства, идентификации или удаленного сервиса вместо статического файла. Настройте его из MDM или системного файла `managed-settings.json`. Claude Code игнорирует `policyHelper`, когда он появляется в любой другой области, включая параметры пользователя, параметры проекта, куст реестра HKCU и [параметры, управляемые сервером](/ru/server-managed-settings).646Параметр `policyHelper` указывает на исполняемый файл, который вычисляет управляемые параметры при запуске, поэтому администраторы могут получить политику из состояния устройства, идентификации или удаленного сервиса вместо статического файла. Настройте его из MDM или системного файла `managed-settings.json`. Claude Code игнорирует `policyHelper`, когда он появляется в любой другой области, включая параметры пользователя, параметры проекта, куст реестра HKCU и [параметры, управляемые сервером](/docs/ru/server-managed-settings).

647 647 

648Параметр принимает эти ключи:648Параметр принимает эти ключи:

649 649 


673 673 

674Параметры применяются в порядке приоритета. От наивысшего к наименьшему:674Параметры применяются в порядке приоритета. От наивысшего к наименьшему:

675 675 

6761. **Управляемые параметры** ([управляемые сервером](/ru/server-managed-settings), [политики MDM/OS-уровня](#configuration-scopes) или [управляемые параметры](/ru/settings#settings-files))6761. **Управляемые параметры** ([управляемые сервером](/docs/ru/server-managed-settings), [политики MDM/OS-уровня](#configuration-scopes) или [управляемые параметры](/docs/ru/settings#settings-files))

677 * Политики, развернутые IT через доставку сервера, профили конфигурации MDM, политики реестра или файлы управляемых параметров677 * Политики, развернутые IT через доставку сервера, профили конфигурации MDM, политики реестра или файлы управляемых параметров

678 * Не могут быть переопределены никаким другим уровнем, включая аргументы командной строки678 * Не могут быть переопределены никаким другим уровнем, включая аргументы командной строки

679 * В пределах управляемого уровня приоритет: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) вывод, который при настройке является единственным используемым управляемым источником > удаленный (параметры, управляемые сервером claude.ai или [Claude apps gateway](/ru/claude-apps-gateway)-доставленные) > политики MDM/OS-уровня > на основе файлов (`managed-settings.d/*.json` и `managed-settings.json`, объединенные вместе) > реестр HKCU (только Windows). Используется только один управляемый источник; источники не объединяются в разных уровнях, с одним исключением: ключи блокировки sandbox `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`, с их связанными списками разрешений, `allowAllClaudeAiMcps` и пути двоичных файлов sandbox `sandbox.bwrapPath` и `sandbox.socatPath` учитываются, когда любой управляемый источник, контролируемый администратором, их устанавливает; уровень HKCU, доступный для записи пользователем, исключен.679 * В пределах управляемого уровня приоритет: [`policyHelper`](#compute-managed-settings-with-a-policy-helper) вывод, который при настройке является единственным используемым управляемым источником > удаленный (параметры, управляемые сервером claude.ai или [Claude apps gateway](/docs/ru/claude-apps-gateway)-доставленные) > политики MDM/OS-уровня > на основе файлов (`managed-settings.d/*.json` и `managed-settings.json`, объединенные вместе) > реестр HKCU (только Windows). Используется только один управляемый источник; источники не объединяются в разных уровнях, с одним исключением: ключи блокировки sandbox `sandbox.network.allowManagedDomainsOnly` и `sandbox.filesystem.allowManagedReadPathsOnly`, с их связанными списками разрешений, `allowAllClaudeAiMcps` и пути двоичных файлов sandbox `sandbox.bwrapPath` и `sandbox.socatPath` учитываются, когда любой управляемый источник, контролируемый администратором, их устанавливает; уровень HKCU, доступный для записи пользователем, исключен.

680 * Хосты встраивания, такие как Claude Desktop, могут предоставлять политику через опцию SDK `managedSettings`. По умолчанию это игнорируется, когда присутствует любой управляемый источник, развернутый администратором: параметры, управляемые сервером, политика MDM или OS-уровня, или файл управляемых параметров. Резервный реестр HKCU, доступный для записи пользователем, не считается управляемым источником, развернутым администратором. Администраторы могут согласиться, установив [`parentSettingsBehavior`](#available-settings) на `"merge"`. Значения встраивателя отфильтрованы, чтобы они могли ужесточить управляемую политику, но не ослабить ее.680 * Хосты встраивания, такие как Claude Desktop, могут предоставлять политику через опцию SDK `managedSettings`. По умолчанию это игнорируется, когда присутствует любой управляемый источник, развернутый администратором: параметры, управляемые сервером, политика MDM или OS-уровня, или файл управляемых параметров. Резервный реестр HKCU, доступный для записи пользователем, не считается управляемым источником, развернутым администратором. Администраторы могут согласиться, установив [`parentSettingsBehavior`](#available-settings) на `"merge"`. Значения встраивателя отфильтрованы, чтобы они могли ужесточить управляемую политику, но не ослабить ее.

681 681 

6822. **Аргументы командной строки**6822. **Аргументы командной строки**


6915. **Параметры пользователя** (`~/.claude/settings.json`)6915. **Параметры пользователя** (`~/.claude/settings.json`)

692 * Личные глобальные параметры692 * Личные глобальные параметры

693 693 

694Эта иерархия гарантирует, что организационные политики всегда применяются, при этом позволяя командам и отдельным лицам настраивать свой опыт. Один и тот же приоритет применяется независимо от того, запускаете ли вы Claude Code из CLI, [расширения VS Code](/ru/vs-code) или [JetBrains IDE](/ru/jetbrains).694Эта иерархия гарантирует, что организационные политики всегда применяются, при этом позволяя командам и отдельным лицам настраивать свой опыт. Один и тот же приоритет применяется независимо от того, запускаете ли вы Claude Code из CLI, [расширения VS Code](/docs/ru/vs-code) или [JetBrains IDE](/docs/ru/jetbrains).

695 695 

696Например, если ваши параметры пользователя установили `permissions.defaultMode` на `acceptEdits` и параметры проекта установили его на `default`, применяется значение проекта. Пример ниже охватывает, как вместо этого объединяются параметры со значениями массива, такие как правила разрешений.696Например, если ваши параметры пользователя установили `permissions.defaultMode` на `acceptEdits` и параметры проекта установили его на `default`, применяется значение проекта. Пример ниже охватывает, как вместо этого объединяются параметры со значениями массива, такие как правила разрешений.

697 697 


701 Два параметра массива не объединяются таким образом:701 Два параметра массива не объединяются таким образом:

702 702 

703 * [`fallbackModel`](#available-settings) - это упорядоченная цепь, где позиция имеет значение: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь.703 * [`fallbackModel`](#available-settings) - это упорядоченная цепь, где позиция имеет значение: файл с наивысшим приоритетом, который его определяет, предоставляет всю цепь.

704 * [`availableModels`](#available-settings): {{/* min-version: 2.1.175 */}}когда [источник управляемых параметров с наивысшим приоритетом](/ru/server-managed-settings#settings-precedence) его определяет, этот список применяется как есть и записи пользователя, проекта и локальной области не могут его расширить. В разных неуправляемых областях массивы объединяются как обычно. См. [Поведение объединения](/ru/model-config#merge-behavior).704 * [`availableModels`](#available-settings): {{/* min-version: 2.1.175 */}}когда [источник управляемых параметров с наивысшим приоритетом](/docs/ru/server-managed-settings#settings-precedence) его определяет, этот список применяется как есть и записи пользователя, проекта и локальной области не могут его расширить. В разных неуправляемых областях массивы объединяются как обычно. См. [Поведение объединения](/docs/ru/model-config#merge-behavior).

705</Note>705</Note>

706 706 

707<h3 id="verify-active-settings">707<h3 id="verify-active-settings">

708 Проверить активные параметры708 Проверить активные параметры

709</h3>709</h3>

710 710 

711Запустите `/status` внутри Claude Code, чтобы увидеть, какие источники параметров активны. Внутри меню вкладка **Status** включает строку `Setting sources`, которая перечисляет каждый уровень Claude Code, загруженный для текущего сеанса, такой как `User settings` или `Project local settings`. Когда действуют [управляемые параметры](/ru/admin-setup#decide-how-settings-reach-devices), запись показывает канал доставки в скобках, например `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)` или `(file)`. Уровень появляется в списке только когда этот источник загружается с по крайней мере одним ключом, поэтому пустой список означает, что источники параметров не были найдены.711Запустите `/status` внутри Claude Code, чтобы увидеть, какие источники параметров активны. Внутри меню вкладка **Status** включает строку `Setting sources`, которая перечисляет каждый уровень Claude Code, загруженный для текущего сеанса, такой как `User settings` или `Project local settings`. Когда действуют [управляемые параметры](/docs/ru/admin-setup#decide-how-settings-reach-devices), запись показывает канал доставки в скобках, например `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)` или `(file)`. Уровень появляется в списке только когда этот источник загружается с по крайней мере одним ключом, поэтому пустой список означает, что источники параметров не были найдены.

712 712 

713Строка `Setting sources` подтверждает, какие источники читаются. Она не показывает, какой уровень предоставил каждый отдельный ключ. Вкладка **Config** в том же диалоге - это редактор для фиксированного набора переключателей, таких как тема и подробный вывод, а не представление содержимого вашего `settings.json`.713Строка `Setting sources` подтверждает, какие источники читаются. Она не показывает, какой уровень предоставил каждый отдельный ключ. Вкладка **Config** в том же диалоге - это редактор для фиксированного набора переключателей, таких как тема и подробный вывод, а не представление содержимого вашего `settings.json`.

714 714 


762* **Subagents пользователя**: `~/.claude/agents/`, доступны во всех ваших проектах762* **Subagents пользователя**: `~/.claude/agents/`, доступны во всех ваших проектах

763* **Subagents проекта**: `.claude/agents/`, специфичны для вашего проекта и могут быть совместно использованы с вашей командой763* **Subagents проекта**: `.claude/agents/`, специфичны для вашего проекта и могут быть совместно использованы с вашей командой

764 764 

765Файлы Subagent определяют специализированных AI помощников с пользовательскими запросами и разрешениями инструментов. Узнайте больше о создании и использовании subagents в [документации subagents](/ru/sub-agents).765Файлы Subagent определяют специализированных AI помощников с пользовательскими запросами и разрешениями инструментов. Узнайте больше о создании и использовании subagents в [документации subagents](/docs/ru/sub-agents).

766 766 

767<h2 id="plugin-configuration">767<h2 id="plugin-configuration">

768 Конфигурация Plugin768 Конфигурация Plugin


798 `enabledPlugins`798 `enabledPlugins`

799</h4>799</h4>

800 800 

801Контролирует, какие plugins включены. Формат: `"plugin-name@marketplace-name": true/false`. Plugin без записи в любой области возвращается к его значению [`defaultEnabled`](/ru/plugins-reference#default-enablement).801Контролирует, какие plugins включены. Формат: `"plugin-name@marketplace-name": true/false`. Plugin без записи в любой области возвращается к его значению [`defaultEnabled`](/docs/ru/plugins-reference#default-enablement).

802 802 

803**Области**:803**Области**:

804 804 


812 812 

813 Plugins, принудительно включенные управляемыми параметрами, не могут быть отключены таким образом, так как управляемые параметры переопределяют локальные параметры.813 Plugins, принудительно включенные управляемыми параметрами, не могут быть отключены таким образом, так как управляемые параметры переопределяют локальные параметры.

814 814 

815 Включение plugin из внешнего источника, такого как репозиторий GitHub или пакет npm, в файле `.claude/settings.json` проекта не устанавливает его для других людей. Начиная с Claude Code v2.1.195, каждый путь, который загружает plugins, просит каждого пользователя [установить и доверить plugin](/ru/discover-plugins#configure-team-marketplaces) перед его запуском.815 Включение plugin из внешнего источника, такого как репозиторий GitHub или пакет npm, в файле `.claude/settings.json` проекта не устанавливает его для других людей. Начиная с Claude Code v2.1.195, каждый путь, который загружает plugins, просит каждого пользователя [установить и доверить plugin](/docs/ru/discover-plugins#configure-team-marketplaces) перед его запуском.

816</Note>816</Note>

817 817 

818**Пример**:818**Пример**:


831 `pluginConfigs`831 `pluginConfigs`

832</h4>832</h4>

833 833 

834Хранит значения параметров, не содержащих конфиденциальную информацию, которые собирает [`userConfig`](/ru/plugins-reference#user-configuration) prompt plugin, индексированные по ID plugin. Claude Code записывает этот ключ в параметры пользователя, когда вы заполняете диалоговое окно конфигурации plugin, поэтому вам не нужно редактировать его вручную. Конфиденциальные параметры хранятся в macOS Keychain вместо этого, или в `~/.claude/.credentials.json` на платформах без поддерживаемого keychain.834Хранит значения параметров, не содержащих конфиденциальную информацию, которые собирает [`userConfig`](/docs/ru/plugins-reference#user-configuration) prompt plugin, индексированные по ID plugin. Claude Code записывает этот ключ в параметры пользователя, когда вы заполняете диалоговое окно конфигурации plugin, поэтому вам не нужно редактировать его вручную. Конфиденциальные параметры хранятся в macOS Keychain вместо этого, или в `~/.claude/.credentials.json` на платформах без поддерживаемого keychain.

835 835 

836Этот пример хранит один параметр для plugin, установленного из marketplace `acme-tools`:836Этот пример хранит один параметр для plugin, установленного из marketplace `acme-tools`:

837 837 


891* `hostPattern`: Шаблон regex для сопоставления хостов marketplace (использует `hostPattern`)891* `hostPattern`: Шаблон regex для сопоставления хостов marketplace (использует `hostPattern`)

892* `settings`: встроенный marketplace, объявленный непосредственно в settings.json без отдельного размещенного репозитория (использует `name` и `plugins`)892* `settings`: встроенный marketplace, объявленный непосредственно в settings.json без отдельного размещенного репозитория (использует `name` и `plugins`)

893 893 

894Тип источника `git` работает с любым сервисом хостинга git, включая самостоятельно размещенные GitLab и Bitbucket. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этой машине: настроенные помощники учетных данных или ключи SSH. Токен поставщика, такой как `GITHUB_TOKEN`, вступает в силу только через помощника учетных данных, который его читает. См. [Приватные репозитории](/ru/plugin-marketplaces#private-repositories) для деталей настройки.894Тип источника `git` работает с любым сервисом хостинга git, включая самостоятельно размещенные GitLab и Bitbucket. Claude Code клонирует репозиторий с той же аутентификацией, которую использовал бы `git clone` на этой машине: настроенные помощники учетных данных или ключи SSH. Токен поставщика, такой как `GITHUB_TOKEN`, вступает в силу только через помощника учетных данных, который его читает. См. [Приватные репозитории](/docs/ru/plugin-marketplaces#private-repositories) для деталей настройки.

895 895 

896Для источников `github` и `git` установите `"skipLfs": true` внутри объекта `source` (рядом с `repo` или `url`) для пропуска загрузок Git LFS, когда Claude Code клонирует или обновляет репозиторий marketplace. Файлы указателей LFS остаются указателями вместо загрузки их содержимого. Используйте это, когда репозиторий содержит большие объекты LFS, не связанные с содержимым plugin. {/* min-version: 2.1.153 */}Требует Claude Code v2.1.153 или позже.896Для источников `github` и `git` установите `"skipLfs": true` внутри объекта `source` (рядом с `repo` или `url`) для пропуска загрузок Git LFS, когда Claude Code клонирует или обновляет репозиторий marketplace. Файлы указателей LFS остаются указателями вместо загрузки их содержимого. Используйте это, когда репозиторий содержит большие объекты LFS, не связанные с содержимым plugin. Требует Claude Code v2.1.153 или позже.

897 897 

898Каждая запись marketplace также принимает опциональное логическое значение `autoUpdate`. Установите `"autoUpdate": true` рядом с `source`, чтобы Claude Code обновлял этот marketplace и обновлял его установленные plugins при запуске. Если опущено, официальные marketplaces Anthropic по умолчанию имеют значение `true`, а все остальные marketplaces по умолчанию имеют значение `false`. См. [Настройка автоматических обновлений](/ru/discover-plugins#configure-auto-updates).898Каждая запись marketplace также принимает опциональное логическое значение `autoUpdate`. Установите `"autoUpdate": true` рядом с `source`, чтобы Claude Code обновлял этот marketplace и обновлял его установленные plugins при запуске. Если опущено, официальные marketplaces Anthropic по умолчанию имеют значение `true`, а все остальные marketplaces по умолчанию имеют значение `false`. См. [Настройка автоматических обновлений](/docs/ru/discover-plugins#configure-auto-updates).

899 899 

900Используйте `source: 'settings'` для объявления небольшого набора plugins встроенным образом без настройки размещенного репозитория marketplace. Plugins, указанные здесь, должны ссылаться на внешние источники, такие как GitHub или npm. Вам по-прежнему нужно включить каждый plugin отдельно в `enabledPlugins`.900Используйте `source: 'settings'` для объявления небольшого набора plugins встроенным образом без настройки размещенного репозитория marketplace. Plugins, указанные здесь, должны ссылаться на внешние источники, такие как GitHub или npm. Вам по-прежнему нужно включить каждый plugin отдельно в `enabledPlugins`.

901 901 


925 `strictKnownMarketplaces`925 `strictKnownMarketplaces`

926</h4>926</h4>

927 927 

928**Только управляемые параметры**: Контролирует, какие marketplaces plugins пользователи могут добавить и установить plugins из них. Этот параметр можно настроить только в [управляемых параметрах](/ru/settings#settings-files) и предоставляет администраторам строгий контроль над источниками marketplace.928**Только управляемые параметры**: Контролирует, какие marketplaces plugins пользователи могут добавить и установить plugins из них. Этот параметр можно настроить только в [управляемых параметрах](/docs/ru/settings#settings-files) и предоставляет администраторам строгий контроль над источниками marketplace.

929 929 

930**Местоположения файлов управляемых параметров**:930**Местоположения файлов управляемых параметров**:

931 931 


980Поля: `url` (обязательно), `headers` (опционально: HTTP заголовки для аутентифицированного доступа)980Поля: `url` (обязательно), `headers` (опционально: HTTP заголовки для аутентифицированного доступа)

981 981 

982<Note>982<Note>

983 Marketplaces на основе URL загружают только файл `marketplace.json`. Они не загружают файлы plugins с сервера. Plugins в marketplaces на основе URL должны использовать внешние источники (GitHub, npm или URL git) вместо относительных путей. Для plugins с относительными путями используйте marketplace на основе Git. См. [Troubleshooting](/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces) для деталей.983 Marketplaces на основе URL загружают только файл `marketplace.json`. Они не загружают файлы plugins с сервера. Plugins в marketplaces на основе URL должны использовать внешние источники (GitHub, npm или URL git) вместо относительных путей. Для plugins с относительными путями используйте marketplace на основе Git. См. [Troubleshooting](/docs/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces) для деталей.

984</Note>984</Note>

985 985 

9864. **Пакеты NPM**:9864. **Пакеты NPM**:


1170* Ограничение применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin. Marketplace, добавленный до установки политики, не может быть использован для установки или обновления plugins после того, как его источник больше не совпадает со списком разрешений1170* Ограничение применяется при добавлении marketplace и при установке, обновлении, обновлении и автоматическом обновлении plugin. Marketplace, добавленный до установки политики, не может быть использован для установки или обновления plugins после того, как его источник больше не совпадает со списком разрешений

1171* Управляемые параметры имеют наивысший приоритет и не могут быть переопределены1171* Управляемые параметры имеют наивысший приоритет и не могут быть переопределены

1172 1172 

1173См. [Управляемые ограничения marketplace](/ru/plugin-marketplaces#managed-marketplace-restrictions) для документации, ориентированной на пользователя.1173См. [Управляемые ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) для документации, ориентированной на пользователя.

1174 1174 

1175<h4 id="strictpluginonlycustomization">1175<h4 id="strictpluginonlycustomization">

1176 `strictPluginOnlyCustomization`1176 `strictPluginOnlyCustomization`


1193| `skills` | `~/.claude/skills/`, `.claude/skills/` | Plugin skills, встроенные skills, skills в каталоге управляемой политики |1193| `skills` | `~/.claude/skills/`, `.claude/skills/` | Plugin skills, встроенные skills, skills в каталоге управляемой политики |

1194| `agents` | `~/.claude/agents/`, `.claude/agents/` | Plugin agents, встроенные agents, agents в каталоге управляемой политики |1194| `agents` | `~/.claude/agents/`, `.claude/agents/` | Plugin agents, встроенные agents, agents в каталоге управляемой политики |

1195| `hooks` | Hooks в пользовательских, проектных и локальных `settings.json` | Plugin hooks, hooks в управляемых параметрах |1195| `hooks` | Hooks в пользовательских, проектных и локальных `settings.json` | Plugin hooks, hooks в управляемых параметрах |

1196| `mcp` | Servers в `~/.claude.json` и `.mcp.json` | Plugin MCP servers, [`managed-mcp.json`](/ru/managed-mcp) servers |1196| `mcp` | Servers в `~/.claude.json` и `.mcp.json` | Plugin MCP servers, [`managed-mcp.json`](/docs/ru/managed-mcp) servers |

1197 1197 

1198Имена поверхностей, которые версия Claude Code не распознает, игнорируются, а не вызывают ошибку файла параметров, поэтому вы можете добавить новые имена поверхностей до того, как все клиенты обновятся.1198Имена поверхностей, которые версия Claude Code не распознает, игнорируются, а не вызывают ошибку файла параметров, поэтому вы можете добавить новые имена поверхностей до того, как все клиенты обновятся.

1199 1199 


1209* Просмотрите детали plugins (skills, agents, hooks, предоставляемые)1209* Просмотрите детали plugins (skills, agents, hooks, предоставляемые)

1210* Добавьте/удалите marketplaces1210* Добавьте/удалите marketplaces

1211 1211 

1212Узнайте больше о системе plugins в [документации plugins](/ru/plugins).1212Узнайте больше о системе plugins в [документации plugins](/docs/ru/plugins).

1213 1213 

1214<h2 id="environment-variables">1214<h2 id="environment-variables">

1215 Переменные окружения1215 Переменные окружения


1217 1217 

1218Переменные окружения позволяют вам управлять поведением Claude Code без редактирования файлов параметров. Любая переменная также может быть настроена в [`settings.json`](#available-settings) под ключом `env` для применения к каждому сеансу или развертывания для вашей команды.1218Переменные окружения позволяют вам управлять поведением Claude Code без редактирования файлов параметров. Любая переменная также может быть настроена в [`settings.json`](#available-settings) под ключом `env` для применения к каждому сеансу или развертывания для вашей команды.

1219 1219 

1220См. [справочник переменных окружения](/ru/env-vars) для полного списка.1220См. [справочник переменных окружения](/docs/ru/env-vars) для полного списка.

1221 1221 

1222<h2 id="tools-available-to-claude">1222<h2 id="tools-available-to-claude">

1223 Инструменты, доступные Claude1223 Инструменты, доступные Claude


1225 1225 

1226Claude Code имеет доступ к набору инструментов для чтения, редактирования, поиска, запуска команд и организации subagents. Имена инструментов - это точные строки, которые вы используете в правилах разрешений и сопоставителях hooks.1226Claude Code имеет доступ к набору инструментов для чтения, редактирования, поиска, запуска команд и организации subagents. Имена инструментов - это точные строки, которые вы используете в правилах разрешений и сопоставителях hooks.

1227 1227 

1228См. [справочник инструментов](/ru/tools-reference) для полного списка и деталей поведения инструмента Bash.1228См. [справочник инструментов](/docs/ru/tools-reference) для полного списка и деталей поведения инструмента Bash.

1229 1229 

1230<h2 id="see-also">1230<h2 id="see-also">

1231 См. также1231 См. также

1232</h2>1232</h2>

1233 1233 

1234* [Permissions](/ru/permissions): система разрешений, синтаксис правил, шаблоны, специфичные для инструментов, и управляемые политики1234* [Permissions](/docs/ru/permissions): система разрешений, синтаксис правил, шаблоны, специфичные для инструментов, и управляемые политики

1235* [Authentication](/ru/authentication): настройка доступа пользователей к Claude Code1235* [Authentication](/docs/ru/authentication): настройка доступа пользователей к Claude Code

1236* [Debug your configuration](/ru/debug-your-config): диагностика причин, по которым параметр, hook или MCP сервер не вступают в силу1236* [Debug your configuration](/docs/ru/debug-your-config): диагностика причин, по которым параметр, hook или MCP сервер не вступают в силу

1237* [Troubleshoot installation and login](/ru/troubleshoot-install): установка, аутентификация и проблемы платформы1237* [Troubleshoot installation and login](/docs/ru/troubleshoot-install): установка, аутентификация и проблемы платформы

skills.md +47 −47

Details

11Создайте skill, когда вы постоянно вставляете один и тот же сценарий, контрольный список или многошаговую процедуру в чат, или когда раздел CLAUDE.md превратился в процедуру, а не в факт. В отличие от содержимого CLAUDE.md, тело skill загружается только при его использовании, поэтому большой справочный материал стоит почти ничего, пока вам он не понадобится.11Создайте skill, когда вы постоянно вставляете один и тот же сценарий, контрольный список или многошаговую процедуру в чат, или когда раздел CLAUDE.md превратился в процедуру, а не в факт. В отличие от содержимого CLAUDE.md, тело skill загружается только при его использовании, поэтому большой справочный материал стоит почти ничего, пока вам он не понадобится.

12 12 

13<Note>13<Note>

14 Для встроенных команд, таких как `/help` и `/compact`, и встроенных skills, таких как `/debug` и `/code-review`, см. [справочник команд](/ru/commands).14 Для встроенных команд, таких как `/help` и `/compact`, и встроенных skills, таких как `/debug` и `/code-review`, см. [справочник команд](/docs/ru/commands).

15 15 

16 **Пользовательские команды были объединены с skills.** Файл в `.claude/commands/deploy.md` и skill в `.claude/skills/deploy/SKILL.md` оба создают `/deploy` и работают одинаково. Ваши существующие файлы `.claude/commands/` продолжают работать. Skills добавляют дополнительные функции: каталог для вспомогательных файлов, frontmatter для [управления тем, кто вызывает skill](#control-who-invokes-a-skill), и возможность для Claude загружать их автоматически при необходимости.16 **Пользовательские команды были объединены с skills.** Файл в `.claude/commands/deploy.md` и skill в `.claude/skills/deploy/SKILL.md` оба создают `/deploy` и работают одинаково. Ваши существующие файлы `.claude/commands/` продолжают работать. Skills добавляют дополнительные функции: каталог для вспомогательных файлов, frontmatter для [управления тем, кто вызывает skill](#control-who-invokes-a-skill), и возможность для Claude загружать их автоматически при необходимости.

17</Note>17</Note>


22 Встроенные skills22 Встроенные skills

23</h2>23</h2>

24 24 

25Claude Code включает набор встроенных skills, которые доступны в каждой сессии, если они не отключены с помощью параметра [`disableBundledSkills`](/ru/settings#available-settings), включая `/doctor`, `/code-review`, `/batch`, `/debug`, `/loop` и `/claude-api`. В отличие от большинства встроенных команд, которые выполняют фиксированную логику напрямую, встроенные skills основаны на подсказках: они дают Claude подробные инструкции и позволяют ему организовать работу, используя свои инструменты. Вы вызываете их так же, как любой другой skill, введя `/` и затем имя skill.25Claude Code включает набор встроенных skills, которые доступны в каждой сессии, если они не отключены с помощью параметра [`disableBundledSkills`](/docs/ru/settings#available-settings), включая `/doctor`, `/code-review`, `/batch`, `/debug`, `/loop` и `/claude-api`. В отличие от большинства встроенных команд, которые выполняют фиксированную логику напрямую, встроенные skills основаны на подсказках: они дают Claude подробные инструкции и позволяют ему организовать работу, используя свои инструменты. Вы вызываете их так же, как любой другой skill, введя `/` и затем имя skill.

26 26 

27Проверка настройки [`/doctor`](/ru/commands#all-commands) является единственным исключением из `disableBundledSkills` в Claude Code v2.1.205 и позже: она остается доступной для ввода, когда этот параметр включен. Чтобы скрыть её, установите переменную окружения `DISABLE_DOCTOR_COMMAND` или запись [`skillOverrides`](#override-skill-visibility-from-settings) со значением `"doctor": "off"`. До версии v2.1.205 `/doctor` была встроенной командой, а не встроенным skill.27Проверка настройки [`/doctor`](/docs/ru/commands#all-commands) является единственным исключением из `disableBundledSkills` в Claude Code v2.1.205 и позже: она остается доступной для ввода, когда этот параметр включен. Чтобы скрыть её, установите переменную окружения `DISABLE_DOCTOR_COMMAND` или запись [`skillOverrides`](#override-skill-visibility-from-settings) со значением `"doctor": "off"`. До версии v2.1.205 `/doctor` была встроенной командой, а не встроенным skill.

28 28 

29Встроенные skills перечислены вместе со встроенными командами в [справочнике команд](/ru/commands), отмечены как **Skill** в столбце Purpose.29Встроенные skills перечислены вместе со встроенными командами в [справочнике команд](/docs/ru/commands), отмечены как **Skill** в столбце Purpose.

30 30 

31<h3 id="run-and-verify-your-app">31<h3 id="run-and-verify-your-app">

32 Запуск и проверка вашего приложения32 Запуск и проверка вашего приложения


40| `/verify` | Соберите и запустите ваше приложение, чтобы подтвердить, что изменение кода делает то, что должно, без возврата к тестам или проверкам типов |40| `/verify` | Соберите и запустите ваше приложение, чтобы подтвердить, что изменение кода делает то, что должно, без возврата к тестам или проверкам типов |

41| `/run-skill-generator` | Научите `/run` и `/verify` собирать и запускать ваш проект |41| `/run-skill-generator` | Научите `/run` и `/verify` собирать и запускать ваш проект |

42 42 

43{/* min-version: 2.1.145 */}Все три skills требуют Claude Code версии 2.1.145 или позже.43Все три skills требуют Claude Code версии 2.1.145 или позже.

44 44 

45`/run` и `/verify` работают без настройки. Они определяют запуск на основе типа вашего проекта (CLI, сервер, TUI, управляемый браузером) и того, что находится в вашем README, `package.json` или `Makefile`. Это определение становится ненадежным для проектов, которым требуется что-то большее, чем стандартный запуск: база данных, файл env, графический сеанс, многоэтапная сборка.45`/run` и `/verify` работают без настройки. Они определяют запуск на основе типа вашего проекта (CLI, сервер, TUI, управляемый браузером) и того, что находится в вашем README, `package.json` или `Makefile`. Это определение становится ненадежным для проектов, которым требуется что-то большее, чем стандартный запуск: база данных, файл env, графический сеанс, многоэтапная сборка.

46 46 


114 114 

115| Местоположение | Путь | Применяется к |115| Местоположение | Путь | Применяется к |

116| :------------- | :------------------------------------------------------- | :----------------------------------- |116| :------------- | :------------------------------------------------------- | :----------------------------------- |

117| Enterprise | См. [управляемые параметры](/ru/settings#settings-files) | Все пользователи в вашей организации |117| Enterprise | См. [управляемые параметры](/docs/ru/settings#settings-files) | Все пользователи в вашей организации |

118| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | Все ваши проекты |118| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | Все ваши проекты |

119| Project | `.claude/skills/<skill-name>/SKILL.md` | Только этот проект |119| Project | `.claude/skills/<skill-name>/SKILL.md` | Только этот проект |

120| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | Где включен плагин |120| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | Где включен плагин |


133 133 

134Когда вы или Claude вызываете неквалифицированное имя, загружается skill корня проекта, и Claude Code добавляет список квалифицированных по каталогам вариантов к его содержимому с инструкцией также вызвать любой вариант, чей каталог содержит файлы, с которыми работает Claude Code. Вложенный skill поэтому по-прежнему применяется к работе в его каталоге, когда вызывается только неквалифицированное имя. Требуется Claude Code v2.1.203 или позже.134Когда вы или Claude вызываете неквалифицированное имя, загружается skill корня проекта, и Claude Code добавляет список квалифицированных по каталогам вариантов к его содержимому с инструкцией также вызвать любой вариант, чей каталог содержит файлы, с которыми работает Claude Code. Вложенный skill поэтому по-прежнему применяется к работе в его каталоге, когда вызывается только неквалифицированное имя. Требуется Claude Code v2.1.203 или позже.

135 135 

136Запись `<skill-name>` в местоположениях enterprise, personal или project может быть символической ссылкой на каталог в другом месте на диске. Claude Code следует символической ссылке и читает `SKILL.md` из целевого каталога, и если один и тот же целевой каталог доступен из более чем одного местоположения, Claude Code загружает skill один раз. Plugin skills обрабатывают символические ссылки иначе; см. [Совместное использование файлов в marketplace с помощью символических ссылок](/ru/plugins-reference#share-files-within-a-marketplace-with-symlinks).136Запись `<skill-name>` в местоположениях enterprise, personal или project может быть символической ссылкой на каталог в другом месте на диске. Claude Code следует символической ссылке и читает `SKILL.md` из целевого каталога, и если один и тот же целевой каталог доступен из более чем одного местоположения, Claude Code загружает skill один раз. Plugin skills обрабатывают символические ссылки иначе; см. [Совместное использование файлов в marketplace с помощью символических ссылок](/docs/ru/plugins-reference#share-files-within-a-marketplace-with-symlinks).

137 137 

138<Note>138<Note>

139 Добавьте `.claude-plugin/plugin.json` в папку skill, и она загружается как [плагин](/ru/plugins-reference#skills-directory-plugins) с именем `<name>@skills-dir`, поэтому он может объединять agents, hooks и MCP servers. В `.claude/skills/` проекта это требует предварительного принятия диалога доверия рабочей области.139 Добавьте `.claude-plugin/plugin.json` в папку skill, и она загружается как [плагин](/docs/ru/plugins-reference#skills-directory-plugins) с именем `<name>@skills-dir`, поэтому он может объединять agents, hooks и MCP servers. В `.claude/skills/` проекта это требует предварительного принятия диалога доверия рабочей области.

140</Note>140</Note>

141 141 

142<h4 id="live-change-detection">142<h4 id="live-change-detection">


146Claude Code следит за каталогами skills на предмет изменений файлов. Добавление, редактирование или удаление skill в `~/.claude/skills/`, в проекте `.claude/skills/` или в `.claude/skills/` внутри каталога `--add-dir` вступает в силу в текущей сессии без перезагрузки. Создание каталога skills верхнего уровня, который не существовал при запуске сессии, требует перезагрузки Claude Code, чтобы новый каталог можно было отслеживать.146Claude Code следит за каталогами skills на предмет изменений файлов. Добавление, редактирование или удаление skill в `~/.claude/skills/`, в проекте `.claude/skills/` или в `.claude/skills/` внутри каталога `--add-dir` вступает в силу в текущей сессии без перезагрузки. Создание каталога skills верхнего уровня, который не существовал при запуске сессии, требует перезагрузки Claude Code, чтобы новый каталог можно было отслеживать.

147 147 

148<Note>148<Note>

149 Обнаружение живых изменений охватывает только текст `SKILL.md`. Для папки skill, которая также является [плагином](/ru/plugins-reference#skills-directory-plugins), изменения в `hooks/`, `.mcp.json`, `agents/` и `output-styles/` требуют `/reload-plugins` для вступления в силу.149 Обнаружение живых изменений охватывает только текст `SKILL.md`. Для папки skill, которая также является [плагином](/docs/ru/plugins-reference#skills-directory-plugins), изменения в `hooks/`, `.mcp.json`, `agents/` и `output-styles/` требуют `/reload-plugins` для вступления в силу.

150</Note>150</Note>

151 151 

152<h4 id="automatic-discovery-from-parent-and-nested-directories">152<h4 id="automatic-discovery-from-parent-and-nested-directories">


177 Skills из дополнительных каталогов177 Skills из дополнительных каталогов

178</h4>178</h4>

179 179 

180Флаг `--add-dir` и команда `/add-dir` [предоставляют доступ к файлам](/ru/permissions#additional-directories-grant-file-access-not-configuration) скорее, чем конфигурацию обнаружения, но skills — это исключение: `.claude/skills/` в добавленном каталоге загружается автоматически. Это исключение применяется только к `--add-dir` и `/add-dir`. Параметр `permissions.additionalDirectories` в `settings.json` предоставляет доступ к файлам только и не загружает skills. См. [Обнаружение живых изменений](#live-change-detection) для того, как правки подхватываются во время сессии.180Флаг `--add-dir` и команда `/add-dir` [предоставляют доступ к файлам](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) скорее, чем конфигурацию обнаружения, но skills — это исключение: `.claude/skills/` в добавленном каталоге загружается автоматически. Это исключение применяется только к `--add-dir` и `/add-dir`. Параметр `permissions.additionalDirectories` в `settings.json` предоставляет доступ к файлам только и не загружает skills. См. [Обнаружение живых изменений](#live-change-detection) для того, как правки подхватываются во время сессии.

181 181 

182Другая конфигурация `.claude/`, такая как commands и output styles, не загружается из дополнительных каталогов. См. [таблицу исключений](/ru/permissions#additional-directories-grant-file-access-not-configuration) для полного списка того, что загружается и что не загружается, и рекомендуемые способы совместного использования конфигурации между проектами.182Другая конфигурация `.claude/`, такая как commands и output styles, не загружается из дополнительных каталогов. См. [таблицу исключений](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) для полного списка того, что загружается и что не загружается, и рекомендуемые способы совместного использования конфигурации между проектами.

183 183 

184<Note>184<Note>

185 Файлы CLAUDE.md из каталогов `--add-dir` не загружаются по умолчанию. Чтобы загружать их, установите `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. См. [Загрузка из дополнительных каталогов](/ru/memory#load-from-additional-directories).185 Файлы CLAUDE.md из каталогов `--add-dir` не загружаются по умолчанию. Чтобы загружать их, установите `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. См. [Загрузка из дополнительных каталогов](/docs/ru/memory#load-from-additional-directories).

186</Note>186</Note>

187 187 

188<h2 id="configure-skills">188<h2 id="configure-skills">


229 229 

230Ваш `SKILL.md` может содержать что угодно, но размышление о том, как вы хотите вызывать skill (вы, Claude или оба) и где вы хотите его запускать (встроенно или в subagent), помогает направить, что включить. Для сложных skills вы также можете [добавить вспомогательные файлы](#add-supporting-files), чтобы сохранить основной skill сосредоточенным.230Ваш `SKILL.md` может содержать что угодно, но размышление о том, как вы хотите вызывать skill (вы, Claude или оба) и где вы хотите его запускать (встроенно или в subagent), помогает направить, что включить. Для сложных skills вы также можете [добавить вспомогательные файлы](#add-supporting-files), чтобы сохранить основной skill сосредоточенным.

231 231 

232Сохраняйте само тело кратким. После загрузки skill его содержимое [остаётся в контексте на протяжении ходов](#skill-content-lifecycle), поэтому каждая строка — это повторяющаяся стоимость токенов. Указывайте, что делать, а не рассказывайте, как или почему, и применяйте тот же тест краткости, который вы бы применили к [содержимому CLAUDE.md](/ru/best-practices#write-an-effective-claude-md).232Сохраняйте само тело кратким. После загрузки skill его содержимое [остаётся в контексте на протяжении ходов](#skill-content-lifecycle), поэтому каждая строка — это повторяющаяся стоимость токенов. Указывайте, что делать, а не рассказывайте, как или почему, и применяйте тот же тест краткости, который вы бы применили к [содержимому CLAUDE.md](/docs/ru/best-practices#write-an-effective-claude-md).

233 233 

234<h3 id="frontmatter-reference">234<h3 id="frontmatter-reference">

235 Справочник frontmatter235 Справочник frontmatter


251Все поля необязательны. Только `description` рекомендуется, чтобы Claude знал, когда использовать skill.251Все поля необязательны. Только `description` рекомендуется, чтобы Claude знал, когда использовать skill.

252 252 

253| Поле | Обязательно | Описание |253| Поле | Обязательно | Описание |

254| :------------------------- | :------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |254| :------------------------- | :------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

255| `name` | Нет | Отображаемое имя, показываемое в списках skills. По умолчанию используется имя каталога. См. [Как skill получает имя команды](#how-a-skill-gets-its-command-name), чтобы узнать, чем это отличается от имени, которое вы вводите для вызова skill. |255| `name` | Нет | Отображаемое имя, показываемое в списках skills. По умолчанию используется имя каталога. См. [Как skill получает имя команды](#how-a-skill-gets-its-command-name), чтобы узнать, чем это отличается от имени, которое вы вводите для вызова skill. |

256| `description` | Рекомендуется | Что делает skill и когда его использовать. Claude использует это, чтобы решить, когда применять skill. Если опущено, использует первый абзац содержимого markdown. Поместите основной вариант использования в первую очередь: комбинированный текст `description` и `when_to_use` усекается на 1 536 символах в списке skills для уменьшения использования контекста. |256| `description` | Рекомендуется | Что делает skill и когда его использовать. Claude использует это, чтобы решить, когда применять skill. Если опущено, использует первый абзац содержимого markdown. Поместите основной вариант использования в первую очередь: комбинированный текст `description` и `when_to_use` усекается на 1 536 символах в списке skills для уменьшения использования контекста. |

257| `when_to_use` | Нет | Дополнительный контекст для того, когда Claude должен вызвать skill, такой как фразы-триггеры или примеры запросов. Добавляется к `description` в списке skills и учитывается в лимите 1 536 символов. |257| `when_to_use` | Нет | Дополнительный контекст для того, когда Claude должен вызвать skill, такой как фразы-триггеры или примеры запросов. Добавляется к `description` в списке skills и учитывается в лимите 1 536 символов. |

258| `argument-hint` | Нет | Подсказка, показываемая при автодополнении, чтобы указать ожидаемые аргументы. Пример: `[issue-number]` или `[filename] [format]`. |258| `argument-hint` | Нет | Подсказка, показываемая при автодополнении, чтобы указать ожидаемые аргументы. Пример: `[issue-number]` или `[filename] [format]`. |

259| `arguments` | Нет | Именованные позиционные аргументы для [подстановки `$name`](#available-string-substitutions) в содержимом skill. Принимает строку, разделённую пробелами, или список YAML. Имена соответствуют позициям аргументов по порядку. |259| `arguments` | Нет | Именованные позиционные аргументы для [подстановки `$name`](#available-string-substitutions) в содержимом skill. Принимает строку, разделённую пробелами, или список YAML. Имена соответствуют позициям аргументов по порядку. |

260| `disable-model-invocation` | Нет | Установите на `true`, чтобы предотвратить автоматическую загрузку этого skill Claude. Используйте для рабочих процессов, которые вы хотите запустить вручную с помощью `/name`. Также предотвращает [предварительную загрузку skill в subagents](/ru/sub-agents#preload-skills-into-subagents). {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, также предотвращает запуск skill при срабатывании [запланированной задачи](/ru/scheduled-tasks) с skill в качестве подсказки. По умолчанию: `false`. |260| `disable-model-invocation` | Нет | Установите на `true`, чтобы предотвратить автоматическую загрузку этого skill Claude. Используйте для рабочих процессов, которые вы хотите запустить вручную с помощью `/name`. Также предотвращает [предварительную загрузку skill в subagents](/docs/ru/sub-agents#preload-skills-into-subagents). Начиная с версии 2.1.196, также предотвращает запуск skill при срабатывании [запланированной задачи](/docs/ru/scheduled-tasks) с skill в качестве подсказки. По умолчанию: `false`. |

261| `user-invocable` | Нет | Установите на `false`, чтобы скрыть из меню `/`. Используйте для фоновых знаний, которые пользователи не должны вызывать напрямую. По умолчанию: `true`. |261| `user-invocable` | Нет | Установите на `false`, чтобы скрыть из меню `/`. Используйте для фоновых знаний, которые пользователи не должны вызывать напрямую. По умолчанию: `true`. |

262| `allowed-tools` | Нет | Инструменты, которые Claude может использовать без запроса разрешения, когда этот skill активен. Принимает строку, разделённую пробелами или запятыми, или список YAML. |262| `allowed-tools` | Нет | Инструменты, которые Claude может использовать без запроса разрешения, когда этот skill активен. Принимает строку, разделённую пробелами или запятыми, или список YAML. |

263| `disallowed-tools` | Нет | Инструменты, удалённые из доступного пула Claude, пока этот skill активен. Используйте для автономных skills, которые никогда не должны вызывать определённые инструменты, такие как `AskUserQuestion` для фонового цикла. Принимает строку, разделённую пробелами или запятыми, или список YAML. Ограничение очищается при отправке вашего следующего сообщения. |263| `disallowed-tools` | Нет | Инструменты, удалённые из доступного пула Claude, пока этот skill активен. Используйте для автономных skills, которые никогда не должны вызывать определённые инструменты, такие как `AskUserQuestion` для фонового цикла. Принимает строку, разделённую пробелами или запятыми, или список YAML. Ограничение очищается при отправке вашего следующего сообщения. |

264| `model` | Нет | Модель для использования, когда этот skill активен. Переопределение применяется для остальной части текущего хода и не сохраняется в параметры; модель сессии возобновляется при вашем следующем запросе. Принимает те же значения, что и [`/model`](/ru/model-config), или `inherit`, чтобы сохранить активную модель. Значение, исключённое списком разрешений `availableModels` вашей организации, не используется, и сессия сохраняет свою текущую модель. |264| `model` | Нет | Модель для использования, когда этот skill активен. Переопределение применяется для остальной части текущего хода и не сохраняется в параметры; модель сессии возобновляется при вашем следующем запросе. Принимает те же значения, что и [`/model`](/docs/ru/model-config), или `inherit`, чтобы сохранить активную модель. Значение, исключённое списком разрешений `availableModels` вашей организации, не используется, и сессия сохраняет свою текущую модель. |

265| `effort` | Нет | [Уровень усилий](/ru/model-config#adjust-effort-level) при активном этом skill. Переопределяет уровень усилий сессии. По умолчанию: наследует из сессии. Опции: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели. |265| `effort` | Нет | [Уровень усилий](/docs/ru/model-config#adjust-effort-level) при активном этом skill. Переопределяет уровень усилий сессии. По умолчанию: наследует из сессии. Опции: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели. |

266| `context` | Нет | Установите на `fork`, чтобы запустить в контексте forked subagent. |266| `context` | Нет | Установите на `fork`, чтобы запустить в контексте forked subagent. |

267| `agent` | Нет | Какой тип subagent использовать, когда установлен `context: fork`. |267| `agent` | Нет | Какой тип subagent использовать, когда установлен `context: fork`. |

268| `hooks` | Нет | Hooks, ограниченные жизненным циклом этого skill. См. [Hooks в skills и agents](/ru/hooks#hooks-in-skills-and-agents) для формата конфигурации. |268| `hooks` | Нет | Hooks, ограниченные жизненным циклом этого skill. См. [Hooks в skills и agents](/docs/ru/hooks#hooks-in-skills-and-agents) для формата конфигурации. |

269| `paths` | Нет | Glob паттерны, которые ограничивают, когда этот skill активируется. Принимает строку, разделённую запятыми, или список YAML. Когда установлено, Claude загружает skill автоматически только при работе с файлами, соответствующими паттернам. Использует тот же формат, что и [правила, специфичные для пути](/ru/memory#path-specific-rules). |269| `paths` | Нет | Glob паттерны, которые ограничивают, когда этот skill активируется. Принимает строку, разделённую запятыми, или список YAML. Когда установлено, Claude загружает skill автоматически только при работе с файлами, соответствующими паттернам. Использует тот же формат, что и [правила, специфичные для пути](/docs/ru/memory#path-specific-rules). |

270| `shell` | Нет | Shell для использования в блоках `` !`command` `` и ` ```! ` в этом skill. Принимает `bash` (по умолчанию) или `powershell`. Установка `powershell` запускает встроенные команды shell через PowerShell на Windows. Требует `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. |270| `shell` | Нет | Shell для использования в блоках `` !`command` `` и ` ```! ` в этом skill. Принимает `bash` (по умолчанию) или `powershell`. Установка `powershell` запускает встроенные команды shell через PowerShell на Windows. Требует `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. |

271 271 

272<h4 id="how-a-skill-gets-its-command-name">272<h4 id="how-a-skill-gets-its-command-name">


283| [Вложенный](#where-skills-live) каталог `.claude/skills/`, когда имя конфликтует с другим skill | Путь подкаталога относительно рабочего каталога, затем имя каталога skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |283| [Вложенный](#where-skills-live) каталог `.claude/skills/`, когда имя конфликтует с другим skill | Путь подкаталога относительно рабочего каталога, затем имя каталога skill | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |

284| Файл в `.claude/commands/` | Имя файла без расширения | `.claude/commands/deploy.md` → `/deploy` |284| Файл в `.claude/commands/` | Имя файла без расширения | `.claude/commands/deploy.md` → `/deploy` |

285| Подкаталог `skills/` плагина | Имя каталога, с пространством имён по плагину | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review` |285| Подкаталог `skills/` плагина | Имя каталога, с пространством имён по плагину | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review` |

286| Корневой `SKILL.md` плагина | Frontmatter `name`, с именем каталога плагина в качестве резервного варианта | `my-plugin/SKILL.md` с `name: review` → `/my-plugin:review`. См. [Правила поведения пути](/ru/plugins-reference#path-behavior-rules) |286| Корневой `SKILL.md` плагина | Frontmatter `name`, с именем каталога плагина в качестве резервного варианта | `my-plugin/SKILL.md` с `name: review` → `/my-plugin:review`. См. [Правила поведения пути](/docs/ru/plugins-reference#path-behavior-rules) |

287 287 

288Случай с корневым плагином — это единственное место, где `name` устанавливает имя команды, потому что нет каталога skill, чтобы взять его оттуда. Если `name` не установлен в frontmatter, вместо этого используется имя каталога плагина.288Случай с корневым плагином — это единственное место, где `name` устанавливает имя команды, потому что нет каталога skill, чтобы взять его оттуда. Если `name` не установлен в frontmatter, вместо этого используется имя каталога плагина.

289 289 


302| `${CLAUDE_SESSION_ID}` | Текущий ID сессии. Полезно для логирования, создания файлов, специфичных для сессии, или корреляции выходных данных skill с сессиями. |302| `${CLAUDE_SESSION_ID}` | Текущий ID сессии. Полезно для логирования, создания файлов, специфичных для сессии, или корреляции выходных данных skill с сессиями. |

303| `${CLAUDE_EFFORT}` | Текущий уровень усилий: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Используйте это, чтобы адаптировать инструкции skill к активному параметру усилий. |303| `${CLAUDE_EFFORT}` | Текущий уровень усилий: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Используйте это, чтобы адаптировать инструкции skill к активному параметру усилий. |

304| `${CLAUDE_SKILL_DIR}` | Каталог, содержащий файл `SKILL.md` skill. Для plugin skills это подкаталог skill в плагине, а не корень плагина. Используйте это в командах bash injection для ссылки на скрипты или файлы, поставляемые с skill, независимо от текущего рабочего каталога. |304| `${CLAUDE_SKILL_DIR}` | Каталог, содержащий файл `SKILL.md` skill. Для plugin skills это подкаталог skill в плагине, а не корень плагина. Используйте это в командах bash injection для ссылки на скрипты или файлы, поставляемые с skill, независимо от текущего рабочего каталога. |

305| `${CLAUDE_PROJECT_DIR}` | Каталог корня проекта. Это тот же путь, который [hooks](/ru/hooks#reference-scripts-by-path) и MCP серверы получают как `CLAUDE_PROJECT_DIR`. Используйте это для ссылки на скрипты или файлы, специфичные для проекта, такие как `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, независимо от того, где установлен skill. |305| `${CLAUDE_PROJECT_DIR}` | Каталог корня проекта. Это тот же путь, который [hooks](/docs/ru/hooks#reference-scripts-by-path) и MCP серверы получают как `CLAUDE_PROJECT_DIR`. Используйте это для ссылки на скрипты или файлы, специфичные для проекта, такие как `${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh`, независимо от того, где установлен skill. |

306 306 

307Подстановка `${CLAUDE_PROJECT_DIR}` требует Claude Code версии 2.1.196 или позже. Она применяется как к телу skill, так и к frontmatter [`allowed-tools`](#frontmatter-reference), поэтому правило разрешения, такое как `Bash(${CLAUDE_PROJECT_DIR}/scripts/lint.sh *)`, разрешается в тот же путь, который использует тело skill.307Подстановка `${CLAUDE_PROJECT_DIR}` требует Claude Code версии 2.1.196 или позже. Она применяется как к телу skill, так и к frontmatter [`allowed-tools`](#frontmatter-reference), поэтому правило разрешения, такое как `Bash(${CLAUDE_PROJECT_DIR}/scripts/lint.sh *)`, разрешается в тот же путь, который использует тело skill.

308 308 


385| `user-invocable: false` | Нет | Да | Описание всегда в контексте, полный skill загружается при вызове |385| `user-invocable: false` | Нет | Да | Описание всегда в контексте, полный skill загружается при вызове |

386 386 

387<Note>387<Note>

388 В обычной сессии описания skills загружаются в контекст, чтобы Claude знал, что доступно, но полное содержимое skill загружается только при вызове. [Subagents с предварительно загруженными skills](/ru/sub-agents#preload-skills-into-subagents) работают иначе: полное содержимое skill внедряется при запуске.388 В обычной сессии описания skills загружаются в контекст, чтобы Claude знал, что доступно, но полное содержимое skill загружается только при вызове. [Subagents с предварительно загруженными skills](/docs/ru/sub-agents#preload-skills-into-subagents) работают иначе: полное содержимое skill внедряется при запуске.

389</Note>389</Note>

390 390 

391<h3 id="skill-content-lifecycle">391<h3 id="skill-content-lifecycle">


396 396 

397Когда Claude повторно вызывает skill, чьё отрендеренное содержимое идентично копии, уже находящейся в контексте, Claude Code добавляет краткую заметку о том, что skill уже загружен, вместо второй копии содержимого. Когда отрендеренное содержимое отличается, потому что аргументы изменились или команда [динамического контекста](#inject-dynamic-context) произвела новый выход, Claude Code добавляет полное содержимое снова. До версии 2.1.202 каждое повторное вызывание добавляло ещё одну полную копию инструкций skill.397Когда Claude повторно вызывает skill, чьё отрендеренное содержимое идентично копии, уже находящейся в контексте, Claude Code добавляет краткую заметку о том, что skill уже загружен, вместо второй копии содержимого. Когда отрендеренное содержимое отличается, потому что аргументы изменились или команда [динамического контекста](#inject-dynamic-context) произвела новый выход, Claude Code добавляет полное содержимое снова. До версии 2.1.202 каждое повторное вызывание добавляло ещё одну полную копию инструкций skill.

398 398 

399[Auto-compact](/ru/how-claude-code-works#when-context-fills-up) переносит вызванные skills в рамках бюджета токенов. Когда разговор суммируется для освобождения контекста, Claude Code повторно прикрепляет самый последний вызов каждого skill после сводки, сохраняя первые 5 000 токенов каждого. Повторно прикреплённые skills делят объединённый бюджет в 25 000 токенов. Claude Code заполняет этот бюджет, начиная с самого недавно вызванного skill, поэтому более старые skills могут быть полностью удалены после компактирования, если вы вызвали много в одной сессии.399[Auto-compact](/docs/ru/how-claude-code-works#when-context-fills-up) переносит вызванные skills в рамках бюджета токенов. Когда разговор суммируется для освобождения контекста, Claude Code повторно прикрепляет самый последний вызов каждого skill после сводки, сохраняя первые 5 000 токенов каждого. Повторно прикреплённые skills делят объединённый бюджет в 25 000 токенов. Claude Code заполняет этот бюджет, начиная с самого недавно вызванного skill, поэтому более старые skills могут быть полностью удалены после компактирования, если вы вызвали много в одной сессии.

400 400 

401Если skill кажется перестаёт влиять на поведение после первого ответа, содержимое обычно всё ещё присутствует, и модель выбирает другие инструменты или подходы. Усильте описание skill и инструкции, чтобы модель продолжала его предпочитать, или используйте [hooks](/ru/hooks) для детерминированного обеспечения поведения. Если skill большой или вы вызвали несколько других после него, повторно вызовите его после компактирования, чтобы восстановить полное содержимое.401Если skill кажется перестаёт влиять на поведение после первого ответа, содержимое обычно всё ещё присутствует, и модель выбирает другие инструменты или подходы. Усильте описание skill и инструкции, чтобы модель продолжала его предпочитать, или используйте [hooks](/docs/ru/hooks) для детерминированного обеспечения поведения. Если skill большой или вы вызвали несколько других после него, повторно вызовите его после компактирования, чтобы восстановить полное содержимое.

402 402 

403<h3 id="pre-approve-tools-for-a-skill">403<h3 id="pre-approve-tools-for-a-skill">

404 Предварительно одобрите инструменты для skill404 Предварительно одобрите инструменты для skill

405</h3>405</h3>

406 406 

407Поле `allowed-tools` предоставляет разрешение для перечисленных инструментов, пока skill активен, поэтому Claude может использовать их без запроса вашего одобрения. Это не ограничивает, какие инструменты доступны: каждый инструмент остаётся вызываемым, и ваши [параметры разрешений](/ru/permissions) по-прежнему управляют инструментами, которые не указаны.407Поле `allowed-tools` предоставляет разрешение для перечисленных инструментов, пока skill активен, поэтому Claude может использовать их без запроса вашего одобрения. Это не ограничивает, какие инструменты доступны: каждый инструмент остаётся вызываемым, и ваши [параметры разрешений](/docs/ru/permissions) по-прежнему управляют инструментами, которые не указаны.

408 408 

409Для skills, проверенных в каталоге `.claude/skills/` проекта, `allowed-tools` вступает в силу после того, как вы примете диалог доверия рабочей области для этой папки, так же как правила разрешений в `.claude/settings.json`. Проверьте skills проекта перед доверием к репозиторию, так как skill может предоставить себе широкий доступ к инструментам.409Для skills, проверенных в каталоге `.claude/skills/` проекта, `allowed-tools` вступает в силу после того, как вы примете диалог доверия рабочей области для этой папки, так же как правила разрешений в `.claude/settings.json`. Проверьте skills проекта перед доверием к репозиторию, так как skill может предоставить себе широкий доступ к инструментам.

410 410 


419---419---

420```420```

421 421 

422Чтобы удалить инструменты из доступного пула Claude, пока skill активен, перечислите их в `disallowed-tools` в frontmatter skill. Ограничение очищается при отправке вашего следующего сообщения. Чтобы заблокировать инструменты во всех skills и подсказках, добавьте правила отказа в ваши [параметры разрешений](/ru/permissions).422Чтобы удалить инструменты из доступного пула Claude, пока skill активен, перечислите их в `disallowed-tools` в frontmatter skill. Ограничение очищается при отправке вашего следующего сообщения. Чтобы заблокировать инструменты во всех skills и подсказках, добавьте правила отказа в ваши [параметры разрешений](/docs/ru/permissions).

423 423 

424<h3 id="pass-arguments-to-skills">424<h3 id="pass-arguments-to-skills">

425 Передайте аргументы в skills425 Передайте аргументы в skills


449 449 

450Если вы вызываете skill с аргументами, но skill не включает `$ARGUMENTS`, Claude Code добавляет `ARGUMENTS: <your input>` в конец содержимого skill, чтобы Claude всё ещё видел, что вы ввели.450Если вы вызываете skill с аргументами, но skill не включает `$ARGUMENTS`, Claude Code добавляет `ARGUMENTS: <your input>` в конец содержимого skill, чтобы Claude всё ещё видел, что вы ввели.

451 451 

452Вы также можете складывать несколько skills в начало одного сообщения. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, ввод `/code-review /fix-issue 123` загружает оба skill и передаёт конечный текст `123` как `$ARGUMENTS` каждому из них. В более ранних версиях загружался только первый skill и получал `/fix-issue 123` как буквальный текст аргумента.452Вы также можете складывать несколько skills в начало одного сообщения. Начиная с версии 2.1.199, ввод `/code-review /fix-issue 123` загружает оба skill и передаёт конечный текст `123` как `$ARGUMENTS` каждому из них. В более ранних версиях загружался только первый skill и получал `/fix-issue 123` как буквальный текст аргумента.

453 453 

454Claude Code расширяет первый skill плюс до пяти дополнительных, сложенных после него. Расширение останавливается на первом токене, который не является встроенным вызываемым пользователем skill, поэтому skill, который запускается как [forked subagent](#run-skills-in-a-subagent) или тот, чьи аргументы сами могут начинаться с команды slash, такой как `/loop`, также заканчивается там; этот токен и всё, что после него, становятся текстом аргумента для каждого расширенного skill.454Claude Code расширяет первый skill плюс до пяти дополнительных, сложенных после него. Расширение останавливается на первом токене, который не является встроенным вызываемым пользователем skill, поэтому skill, который запускается как [forked subagent](#run-skills-in-a-subagent) или тот, чьи аргументы сами могут начинаться с команды slash, такой как `/loop`, также заканчивается там; этот токен и всё, что после него, становятся текстом аргумента для каждого расширенного skill.

455 455 


530```530```

531````531````

532 532 

533Чтобы отключить это поведение для skills и пользовательских команд из источников пользователя, проекта, плагина или [дополнительного каталога](#skills-from-additional-directories), установите `"disableSkillShellExecution": true` в [параметры](/ru/settings). Каждая команда заменяется на `[shell command execution disabled by policy]` вместо запуска. Встроенные и управляемые skills не затронуты. Этот параметр наиболее полезен в [управляемых параметрах](/ru/permissions#managed-settings), где пользователи не могут его переопределить.533Чтобы отключить это поведение для skills и пользовательских команд из источников пользователя, проекта, плагина или [дополнительного каталога](#skills-from-additional-directories), установите `"disableSkillShellExecution": true` в [параметры](/docs/ru/settings). Каждая команда заменяется на `[shell command execution disabled by policy]` вместо запуска. Встроенные и управляемые skills не затронуты. Этот параметр наиболее полезен в [управляемых параметрах](/docs/ru/permissions#managed-settings), где пользователи не могут его переопределить.

534 534 

535<Tip>535<Tip>

536 Чтобы запросить более глубокое рассуждение при запуске skill, включите `ultrathink` где-нибудь в содержимое skill. См. [Используйте ultrathink для одноразового глубокого рассуждения](/ru/model-config#use-ultrathink-for-one-off-deep-reasoning).536 Чтобы запросить более глубокое рассуждение при запуске skill, включите `ultrathink` где-нибудь в содержимое skill. См. [Используйте ultrathink для одноразового глубокого рассуждения](/docs/ru/model-config#use-ultrathink-for-one-off-deep-reasoning).

537</Tip>537</Tip>

538 538 

539<h3 id="run-skills-in-a-subagent">539<h3 id="run-skills-in-a-subagent">


546 `context: fork` имеет смысл только для skills с явными инструкциями. Если ваш skill содержит рекомендации, такие как "используйте эти соглашения API" без задачи, subagent получает рекомендации, но не действенную подсказку, и возвращается без значимого выходного сигнала.546 `context: fork` имеет смысл только для skills с явными инструкциями. Если ваш skill содержит рекомендации, такие как "используйте эти соглашения API" без задачи, subagent получает рекомендации, но не действенную подсказку, и возвращается без значимого выходного сигнала.

547</Warning>547</Warning>

548 548 

549Skills и [subagents](/ru/sub-agents) работают вместе в двух направлениях:549Skills и [subagents](/docs/ru/sub-agents) работают вместе в двух направлениях:

550 550 

551| Подход | Системная подсказка | Задача | Также загружает |551| Подход | Системная подсказка | Задача | Также загружает |

552| :------------------------ | :--------------------- | :----------------------------- | :-------------------------------------------------------------- |552| :------------------------ | :--------------------- | :----------------------------- | :-------------------------------------------------------------- |

553| Skill с `context: fork` | От типа агента | Содержимое SKILL.md | CLAUDE.md, кроме случаев, когда агент является Explore или Plan |553| Skill с `context: fork` | От типа агента | Содержимое SKILL.md | CLAUDE.md, кроме случаев, когда агент является Explore или Plan |

554| Subagent с полем `skills` | Тело markdown subagent | Сообщение делегирования Claude | Предварительно загруженные skills + CLAUDE.md |554| Subagent с полем `skills` | Тело markdown subagent | Сообщение делегирования Claude | Предварительно загруженные skills + CLAUDE.md |

555 555 

556С `context: fork` вы пишете задачу в своём skill и выбираете тип агента для её выполнения. Встроенные агенты Explore и Plan [пропускают CLAUDE.md и git status](/ru/sub-agents#what-loads-at-startup), чтобы сохранить их контекст небольшим, поэтому forked skill, использующий `agent: Explore`, видит только содержимое SKILL.md и собственную системную подсказку агента. Для обратного случая, где вы определяете пользовательский subagent, который использует skills как справочный материал, см. [Subagents](/ru/sub-agents#preload-skills-into-subagents).556С `context: fork` вы пишете задачу в своём skill и выбираете тип агента для её выполнения. Встроенные агенты Explore и Plan [пропускают CLAUDE.md и git status](/docs/ru/sub-agents#what-loads-at-startup), чтобы сохранить их контекст небольшим, поэтому forked skill, использующий `agent: Explore`, видит только содержимое SKILL.md и собственную системную подсказку агента. Для обратного случая, где вы определяете пользовательский subagent, который использует skills как справочный материал, см. [Subagents](/docs/ru/sub-agents#preload-skills-into-subagents).

557 557 

558<h4 id="example-research-skill-using-explore-agent">558<h4 id="example-research-skill-using-explore-agent">

559 Пример: Research skill, используя Explore agent559 Пример: Research skill, используя Explore agent


589 Ограничьте доступ Claude к skills589 Ограничьте доступ Claude к skills

590</h3>590</h3>

591 591 

592По умолчанию Claude может вызывать любой skill, у которого не установлен `disable-model-invocation: true`. Skills, которые определяют `allowed-tools`, предоставляют Claude доступ к этим инструментам без одобрения за использование, когда skill активен. Ваши [параметры разрешений](/ru/permissions) по-прежнему управляют поведением одобрения базовой линии для всех остальных инструментов. Несколько встроенных команд также доступны через инструмент Skill, включая `/init`, `/review` и `/security-review`. Другие встроенные команды, такие как `/compact`, недоступны.592По умолчанию Claude может вызывать любой skill, у которого не установлен `disable-model-invocation: true`. Skills, которые определяют `allowed-tools`, предоставляют Claude доступ к этим инструментам без одобрения за использование, когда skill активен. Ваши [параметры разрешений](/docs/ru/permissions) по-прежнему управляют поведением одобрения базовой линии для всех остальных инструментов. Несколько встроенных команд также доступны через инструмент Skill, включая `/init`, `/review` и `/security-review`. Другие встроенные команды, такие как `/compact`, недоступны.

593 593 

594Три способа управления, какие skills может вызывать Claude:594Три способа управления, какие skills может вызывать Claude:

595 595 


600Skill600Skill

601```601```

602 602 

603**Разрешите или запретите конкретные skills**, используя [правила разрешений](/ru/permissions):603**Разрешите или запретите конкретные skills**, используя [правила разрешений](/docs/ru/permissions):

604 604 

605```text theme={null}605```text theme={null}

606# Allow only specific skills606# Allow only specific skills


623 Переопределите видимость skill из параметров623 Переопределите видимость skill из параметров

624</h3>624</h3>

625 625 

626Параметр `skillOverrides` управляет видимостью skill из ваших [параметров](/ru/settings) вместо frontmatter самого skill. Используйте его для skills, чей SKILL.md вы не хотите редактировать, например для тех, которые проверены в общем репозитории проекта или предоставлены MCP сервером. Меню `/skills` пишет его для вас: выделите skill и нажмите `Space` для циклического переключения состояний, затем `Enter` для сохранения в `.claude/settings.local.json`.626Параметр `skillOverrides` управляет видимостью skill из ваших [параметров](/docs/ru/settings) вместо frontmatter самого skill. Используйте его для skills, чей SKILL.md вы не хотите редактировать, например для тех, которые проверены в общем репозитории проекта или предоставлены MCP сервером. Меню `/skills` пишет его для вас: выделите skill и нажмите `Space` для циклического переключения состояний, затем `Enter` для сохранения в `.claude/settings.local.json`.

627 627 

628Каждый ключ — это имя skill, и каждое значение — одно из четырёх состояний:628Каждый ключ — это имя skill, и каждое значение — одно из четырёх состояний:

629 629 


634| `"user-invocable-only"` | Скрыто | Да |634| `"user-invocable-only"` | Скрыто | Да |

635| `"off"` | Скрыто | Скрыто |635| `"off"` | Скрыто | Скрыто |

636 636 

637Начиная с версии 2.1.199, `"off"` также скрывает skill из списков команд, объявленных клиентам [Remote Control](/ru/remote-control) и вызывающим [Agent SDK](/ru/agent-sdk/slash-commands), а не только из терминального меню `/`. Вызов скрытого skill по его полному имени по-прежнему возвращает ошибку `skillOverrides` вместо его запуска.637Начиная с версии 2.1.199, `"off"` также скрывает skill из списков команд, объявленных клиентам [Remote Control](/docs/ru/remote-control) и вызывающим [Agent SDK](/docs/ru/agent-sdk/slash-commands), а не только из терминального меню `/`. Вызов скрытого skill по его полному имени по-прежнему возвращает ошибку `skillOverrides` вместо его запуска.

638 638 

639Skill, отсутствующий в `skillOverrides`, рассматривается как `"on"`. Пример ниже сворачивает один skill до его имени и полностью отключает другой:639Skill, отсутствующий в `skillOverrides`, рассматривается как `"on"`. Пример ниже сворачивает один skill до его имени и полностью отключает другой:

640 640 


672После установки запустите `/reload-plugins`, чтобы сделать skills плагина доступными в текущей сессии. Затем попросите Claude оценить существующий skill, например `evaluate my summarize-changes skill with skill-creator`. Плагин проведёт вас через написание тестовых случаев и запустит цикл:672После установки запустите `/reload-plugins`, чтобы сделать skills плагина доступными в текущей сессии. Затем попросите Claude оценить существующий skill, например `evaluate my summarize-changes skill with skill-creator`. Плагин проведёт вас через написание тестовых случаев и запустит цикл:

673 673 

674* **Тестовые случаи**: сохраняет подсказки, входные файлы и ожидаемое поведение в `evals/evals.json` внутри каталога skill674* **Тестовые случаи**: сохраняет подсказки, входные файлы и ожидаемое поведение в `evals/evals.json` внутри каталога skill

675* **Изолированные запуски**: порождает [subagent](/ru/sub-agents) для каждого тестового случая, чтобы каждый запуск начинался с чистого контекста, и записывает количество токенов и продолжительность675* **Изолированные запуски**: порождает [subagent](/docs/ru/sub-agents) для каждого тестового случая, чтобы каждый запуск начинался с чистого контекста, и записывает количество токенов и продолжительность

676* **Оценка**: проверяет каждое утверждение против выходного сигнала и пишет pass или fail с доказательством в `grading.json`676* **Оценка**: проверяет каждое утверждение против выходного сигнала и пишет pass или fail с доказательством в `grading.json`

677* **Benchmark**: агрегирует процент успеха, время и токены для с-skill против без-skill в `benchmark.json`, чтобы вы могли сравнить улучшение процента успеха с накладными расходами на токены и время677* **Benchmark**: агрегирует процент успеха, время и токены для с-skill против без-skill в `benchmark.json`, чтобы вы могли сравнить улучшение процента успеха с накладными расходами на токены и время

678* **Сравнение версий**: запускает слепой A/B между двумя версиями skill, чтобы вы могли подтвердить, что правка — это улучшение перед фиксацией678* **Сравнение версий**: запускает слепой A/B между двумя версиями skill, чтобы вы могли подтвердить, что правка — это улучшение перед фиксацией


688Skills могут распространяться на разных уровнях в зависимости от вашей аудитории:688Skills могут распространяться на разных уровнях в зависимости от вашей аудитории:

689 689 

690* **Project skills**: Зафиксируйте `.claude/skills/` в контроле версий690* **Project skills**: Зафиксируйте `.claude/skills/` в контроле версий

691* **Plugins**: Создайте каталог `skills/` в вашем [плагине](/ru/plugins)691* **Plugins**: Создайте каталог `skills/` в вашем [плагине](/docs/ru/plugins)

692* **Managed**: Развёртывайте организацию-широко через [управляемые параметры](/ru/settings#settings-files)692* **Managed**: Развёртывайте организацию-широко через [управляемые параметры](/docs/ru/settings#settings-files)

693 693 

694<h3 id="generate-visual-output">694<h3 id="generate-visual-output">

695 Генерируйте визуальный выходной сигнал695 Генерируйте визуальный выходной сигнал


916 916 

917Claude Code загружает список имен skills и описаний в контекст, чтобы Claude знал, что доступно. Список всегда содержит все имена skills, но если у вас много skills, Claude Code сокращает описания, чтобы соответствовать бюджету символов списка, что может удалить ключевые слова, которые Claude нужны для совпадения с вашим запросом. Бюджет масштабируется на 1% контекстного окна модели. Когда список переполняется, Claude Code удаляет описания, начиная с skills, которые вы вызываете реже всего, поэтому skills, которые вы используете чаще всего, сохраняют полный текст.917Claude Code загружает список имен skills и описаний в контекст, чтобы Claude знал, что доступно. Список всегда содержит все имена skills, но если у вас много skills, Claude Code сокращает описания, чтобы соответствовать бюджету символов списка, что может удалить ключевые слова, которые Claude нужны для совпадения с вашим запросом. Бюджет масштабируется на 1% контекстного окна модели. Когда список переполняется, Claude Code удаляет описания, начиная с skills, которые вы вызываете реже всего, поэтому skills, которые вы используете чаще всего, сохраняют полный текст.

918 918 

919Запустите `/doctor`, чтобы получить оценку стоимости списка в контексте и его основных участников. Когда список превышает свой бюджет, Claude Code также записывает предупреждение в журнал отладки, видимый с помощью [`--debug`](/ru/cli-reference#cli-flags).919Запустите `/doctor`, чтобы получить оценку стоимости списка в контексте и его основных участников. Когда список превышает свой бюджет, Claude Code также записывает предупреждение в журнал отладки, видимый с помощью [`--debug`](/docs/ru/cli-reference#cli-flags).

920 920 

921Строка Skills в `/context` отображает размер списка после применения бюджета, поэтому он соответствует тому, что получает модель. До версии 2.1.196 строка подсчитывала полный текст каждого описания и могла показывать значение в несколько раз больше, чем настроенный бюджет.921Строка Skills в `/context` отображает размер списка после применения бюджета, поэтому он соответствует тому, что получает модель. До версии 2.1.196 строка подсчитывала полный текст каждого описания и могла показывать значение в несколько раз больше, чем настроенный бюджет.

922 922 

923Чтобы повысить бюджет, установите параметр [`skillListingBudgetFraction`](/ru/settings#available-settings) (например, `0.02` = 2%) или переменную окружения `SLASH_COMMAND_TOOL_CHAR_BUDGET` на фиксированное количество символов. Чтобы освободить бюджет для других skills, установите записи с низким приоритетом на `"name-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы они отображались без описания. Вы также можете обрезать текст `description` и `when_to_use` в источнике: поместите ключевой вариант использования в начало, так как комбинированный текст каждой записи ограничен 1 536 символами независимо от бюджета. Лимит настраивается с помощью [`skillListingMaxDescChars`](/ru/settings#available-settings).923Чтобы повысить бюджет, установите параметр [`skillListingBudgetFraction`](/docs/ru/settings#available-settings) (например, `0.02` = 2%) или переменную окружения `SLASH_COMMAND_TOOL_CHAR_BUDGET` на фиксированное количество символов. Чтобы освободить бюджет для других skills, установите записи с низким приоритетом на `"name-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы они отображались без описания. Вы также можете обрезать текст `description` и `when_to_use` в источнике: поместите ключевой вариант использования в начало, так как комбинированный текст каждой записи ограничен 1 536 символами независимо от бюджета. Лимит настраивается с помощью [`skillListingMaxDescChars`](/docs/ru/settings#available-settings).

924 924 

925<h2 id="related-resources">925<h2 id="related-resources">

926 Связанные ресурсы926 Связанные ресурсы

927</h2>927</h2>

928 928 

929* **[Отладка вашей конфигурации](/ru/debug-your-config)**: диагностируйте, почему skill не появляется или не срабатывает929* **[Отладка вашей конфигурации](/docs/ru/debug-your-config)**: диагностируйте, почему skill не появляется или не срабатывает

930* **[Evaluating skill output quality](https://agentskills.io/skill-creation/evaluating-skills)**: формат файла eval и рабочий процесс итерации на agentskills.io930* **[Evaluating skill output quality](https://agentskills.io/skill-creation/evaluating-skills)**: формат файла eval и рабочий процесс итерации на agentskills.io

931* **[Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**: рекомендации по написанию, которые применяются во всех продуктах Claude931* **[Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**: рекомендации по написанию, которые применяются во всех продуктах Claude

932* **[Subagents](/ru/sub-agents)**: делегируйте задачи специализированным агентам932* **[Subagents](/docs/ru/sub-agents)**: делегируйте задачи специализированным агентам

933* **[Plugins](/ru/plugins)**: упакуйте и распространяйте skills с другими расширениями933* **[Plugins](/docs/ru/plugins)**: упакуйте и распространяйте skills с другими расширениями

934* **[Hooks](/ru/hooks)**: автоматизируйте рабочие процессы вокруг событий инструментов934* **[Hooks](/docs/ru/hooks)**: автоматизируйте рабочие процессы вокруг событий инструментов

935* **[Memory](/ru/memory)**: управляйте файлами CLAUDE.md для постоянного контекста935* **[Memory](/docs/ru/memory)**: управляйте файлами CLAUDE.md для постоянного контекста

936* **[Commands](/ru/commands)**: справочник для встроенных команд и встроенных skills936* **[Commands](/docs/ru/commands)**: справочник для встроенных команд и встроенных skills

937* **[Permissions](/ru/permissions)**: управляйте доступом к инструментам и skills937* **[Permissions](/docs/ru/permissions)**: управляйте доступом к инструментам и skills

938* **[Claude Tag skills](https://claude.com/docs/claude-tag/admins/skills-repo)**: skills проекта, зафиксированные в репозитории, также загружаются при использовании этого репозитория в канале Claude Tag938* **[Claude Tag skills](https://claude.com/docs/claude-tag/admins/skills-repo)**: skills проекта, зафиксированные в репозитории, также загружаются при использовании этого репозитория в канале Claude Tag

statusline.md +9 −9

Details

15* Работаете в нескольких сеансах и нужно их различать15* Работаете в нескольких сеансах и нужно их различать

16* Хотите, чтобы ветка git и статус всегда были видны16* Хотите, чтобы ветка git и статус всегда были видны

17 17 

18Строка состояния отображается в собственной строке над встроенными значками нижнего колонтитула и не заменяет их. Чтобы добавить интерактивные значки ссылок в нижний колонтитул, когда в беседе появляется ID, без написания скрипта, вместо этого настройте [`footerLinksRegexes`](/ru/settings#footer-link-badges).18Строка состояния отображается в собственной строке над встроенными значками нижнего колонтитула и не заменяет их. Чтобы добавить интерактивные значки ссылок в нижний колонтитул, когда в беседе появляется ID, без написания скрипта, вместо этого настройте [`footerLinksRegexes`](/docs/ru/settings#footer-link-badges).

19 19 

20Вот пример [многострочной строки состояния](#display-multiple-lines), которая отображает информацию git в первой строке и цветовую полосу контекста во второй.20Вот пример [многострочной строки состояния](#display-multiple-lines), которая отображает информацию git в первой строке и цветовую полосу контекста во второй.

21 21 


45 Ручная настройка строки состояния45 Ручная настройка строки состояния

46</h3>46</h3>

47 47 

48Добавьте поле `statusLine` в ваши пользовательские настройки (`~/.claude/settings.json`, где `~` — это ваш домашний каталог) или [настройки проекта](/ru/settings#settings-files). Установите `type` на `"command"` и укажите `command` на путь скрипта или встроенную команду оболочки. Для полного пошагового руководства по созданию скрипта см. [Построение строки состояния пошагово](#build-a-status-line-step-by-step).48Добавьте поле `statusLine` в ваши пользовательские настройки (`~/.claude/settings.json`, где `~` — это ваш домашний каталог) или [настройки проекта](/docs/ru/settings#settings-files). Установите `type` на `"command"` и укажите `command` на путь скрипта или встроенную команду оболочки. Для полного пошагового руководства по созданию скрипта см. [Построение строки состояния пошагово](#build-a-status-line-step-by-step).

49 49 

50```json theme={null}50```json theme={null}

51{51{


160 160 

161**Размер вывода в соответствии с терминалом**161**Размер вывода в соответствии с терминалом**

162 162 

163Claude Code захватывает вывод вашего скрипта вместо прямого подключения к терминалу, поэтому `tput cols` и определение ширины на уровне языка не могут прочитать размер терминала изнутри скрипта. {/* min-version: 2.1.153 */}Вместо этого читайте переменные окружения `COLUMNS` и `LINES`. Claude Code устанавливает эти значения в соответствии с текущими размерами терминала перед запуском вашего скрипта. Требуется Claude Code v2.1.153 или позже.163Claude Code захватывает вывод вашего скрипта вместо прямого подключения к терминалу, поэтому `tput cols` и определение ширины на уровне языка не могут прочитать размер терминала изнутри скрипта. Вместо этого читайте переменные окружения `COLUMNS` и `LINES`. Claude Code устанавливает эти значения в соответствии с текущими размерами терминала перед запуском вашего скрипта. Требуется Claude Code v2.1.153 или позже.

164 164 

165<Note>Строка состояния работает локально и не потребляет токены API. Она временно скрывается во время определённых взаимодействий с пользовательским интерфейсом, включая предложения автодополнения, меню справки и запросы разрешений.</Note>165<Note>Строка состояния работает локально и не потребляет токены API. Она временно скрывается во время определённых взаимодействий с пользовательским интерфейсом, включая предложения автодополнения, меню справки и запросы разрешений.</Note>

166 166 


194| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Секунды эпохи Unix, когда окно лимита скорости за 5 часов или 7 дней сбрасывается |194| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | Секунды эпохи Unix, когда окно лимита скорости за 5 часов или 7 дней сбрасывается |

195| `session_id` | Уникальный идентификатор сеанса |195| `session_id` | Уникальный идентификатор сеанса |

196| `session_name` | Пользовательское имя сеанса, установленное с флагом `--name` или `/rename`. Отсутствует, если пользовательское имя не было установлено |196| `session_name` | Пользовательское имя сеанса, установленное с флагом `--name` или `/rename`. Отсутствует, если пользовательское имя не было установлено |

197| `prompt_id` | UUID, идентифицирующий пользовательский запрос, который в настоящее время обрабатывается. Совпадает с атрибутом [`prompt.id` на событиях OpenTelemetry](/ru/monitoring-usage#event-correlation-attributes). Отсутствует до первого ввода пользователя. Требуется Claude Code v2.1.196 или позже |197| `prompt_id` | UUID, идентифицирующий пользовательский запрос, который в настоящее время обрабатывается. Совпадает с атрибутом [`prompt.id` на событиях OpenTelemetry](/docs/ru/monitoring-usage#event-correlation-attributes). Отсутствует до первого ввода пользователя. Требуется Claude Code v2.1.196 или позже |

198| `transcript_path` | Путь к файлу стенограммы разговора |198| `transcript_path` | Путь к файлу стенограммы разговора |

199| `version` | Версия Claude Code |199| `version` | Версия Claude Code |

200| `output_style.name` | Имя текущего стиля вывода |200| `output_style.name` | Имя текущего стиля вывода |

201| `vim.mode` | Текущий режим vim (`NORMAL`, `INSERT`, `VISUAL` или `VISUAL LINE`), когда [режим vim](/ru/interactive-mode#vim-editor-mode) включен |201| `vim.mode` | Текущий режим vim (`NORMAL`, `INSERT`, `VISUAL` или `VISUAL LINE`), когда [режим vim](/docs/ru/interactive-mode#vim-editor-mode) включен |

202| `agent.name` | Имя агента при запуске с флагом `--agent` или настроенными параметрами агента |202| `agent.name` | Имя агента при запуске с флагом `--agent` или настроенными параметрами агента |

203| `pr.number`, `pr.url` | Открытый pull request для текущей ветки. Отражает значок PR в нижней строке состояния. Отсутствует до тех пор, пока PR не будет найден, когда не в git репозитории, или после того как PR будет объединён или закрыт |203| `pr.number`, `pr.url` | Открытый pull request для текущей ветки. Отражает значок PR в нижней строке состояния. Отсутствует до тех пор, пока PR не будет найден, когда не в git репозитории, или после того как PR будет объединён или закрыт |

204| `pr.review_state` | Статус проверки открытого PR: `approved`, `pending`, `changes_requested` или `draft`. Может быть независимо отсутствующим даже когда `pr` присутствует |204| `pr.review_state` | Статус проверки открытого PR: `approved`, `pending`, `changes_requested` или `draft`. Может быть независимо отсутствующим даже когда `pr` присутствует |


332* `cache_creation_input_tokens`: токены, записанные в кэш332* `cache_creation_input_tokens`: токены, записанные в кэш

333* `cache_read_input_tokens`: токены, прочитанные из кэша333* `cache_read_input_tokens`: токены, прочитанные из кэша

334 334 

335Для получения информации о том, что означают поля кэша и как они выставляются счётом, см. [проверка производительности кэша](/ru/prompt-caching#check-cache-performance).335Для получения информации о том, что означают поля кэша и как они выставляются счётом, см. [проверка производительности кэша](/docs/ru/prompt-caching#check-cache-performance).

336 336 

337Поле `used_percentage` рассчитывается только из входных токенов: `input_tokens + cache_creation_input_tokens + cache_read_input_tokens`. Оно не включает `output_tokens`.337Поле `used_percentage` рассчитывается только из входных токенов: `input_tokens + cache_creation_input_tokens + cache_read_input_tokens`. Оно не включает `output_tokens`.

338 338 


1033 Строки состояния подагентов1033 Строки состояния подагентов

1034</h2>1034</h2>

1035 1035 

1036Параметр `subagentStatusLine` отображает пользовательское тело строки для каждого [подагента](/ru/sub-agents), показанного на панели агентов ниже приглашения. Используйте его для замены строки по умолчанию `name · description · token count` на ваше собственное форматирование.1036Параметр `subagentStatusLine` отображает пользовательское тело строки для каждого [подагента](/docs/ru/sub-agents), показанного на панели агентов ниже приглашения. Используйте его для замены строки по умолчанию `name · description · token count` на ваше собственное форматирование.

1037 1037 

1038```json theme={null}1038```json theme={null}

1039{1039{


1044}1044}

1045```1045```

1046 1046 

1047Команда запускается один раз за цикл обновления со всеми видимыми строками подагентов, переданными как один объект JSON на stdin. Входные данные включают [базовые поля hooks](/ru/hooks#common-input-fields), поле `columns` с используемой шириной строки и массив `tasks`. Каждая задача имеет `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `contextWindowSize`, `tokenCount`, `tokenSamples` и `cwd`.1047Команда запускается один раз за цикл обновления со всеми видимыми строками подагентов, переданными как один объект JSON на stdin. Входные данные включают [базовые поля hooks](/docs/ru/hooks#common-input-fields), поле `columns` с используемой шириной строки и массив `tasks`. Каждая задача имеет `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `contextWindowSize`, `tokenCount`, `tokenSamples` и `cwd`.

1048 1048 

1049Поле `model` для каждой задачи — это разрешённый ID модели, на которой выполняется задача. `contextWindowSize` — это контекстное окно этой модели в токенах, вычисляемое так же, как `context_window.context_window_size` в строке состояния основного интерфейса, поэтому вы можете отобразить процент для каждой строки из `tokenCount`. Оба поля требуют Claude Code v2.1.205 или более поздней версии и опускаются для задачи, модель которой ещё не разрешена.1049Поле `model` для каждой задачи — это разрешённый ID модели, на которой выполняется задача. `contextWindowSize` — это контекстное окно этой модели в токенах, вычисляемое так же, как `context_window.context_window_size` в строке состояния основного интерфейса, поэтому вы можете отобразить процент для каждой строки из `tokenCount`. Оба поля требуют Claude Code v2.1.205 или более поздней версии и опускаются для задачи, модель которой ещё не разрешена.

1050 1050 

1051Напишите одну строку JSON в stdout для каждой строки, которую вы хотите переопределить, в форме `{"id": "<task id>", "content": "<row body>"}`. Строка `content` отображается как есть, включая цвета ANSI и гиперссылки OSC 8. Пропустите `id` задачи, чтобы сохранить отображение по умолчанию для этой строки; выведите пустую строку `content`, чтобы скрыть её.1051Напишите одну строку JSON в stdout для каждой строки, которую вы хотите переопределить, в форме `{"id": "<task id>", "content": "<row body>"}`. Строка `content` отображается как есть, включая цвета ANSI и гиперссылки OSC 8. Пропустите `id` задачи, чтобы сохранить отображение по умолчанию для этой строки; выведите пустую строку `content`, чтобы скрыть её.

1052 1052 

1053Те же ворота доверия и `disableAllHooks`, которые применяются к `statusLine`, применяются здесь. Плагины могут поставлять `subagentStatusLine` по умолчанию в своём [`settings.json`](/ru/plugins-reference#standard-plugin-layout).1053Те же ворота доверия и `disableAllHooks`, которые применяются к `statusLine`, применяются здесь. Плагины могут поставлять `subagentStatusLine` по умолчанию в своём [`settings.json`](/docs/ru/plugins-reference#standard-plugin-layout).

1054 1054 

1055<h2 id="tips">1055<h2 id="tips">

1056 Советы1056 Советы

sub-agents.md +87 −87

Details

8 8 

9Subagents — это специализированные AI-помощники, которые обрабатывают определённые типы задач. Используйте один, когда побочная задача заполнит основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться: subagent выполняет эту работу в собственном контексте и возвращает только резюме. Определите пользовательский subagent, когда вы постоянно порождаете одного и того же рабочего с одинаковыми инструкциями.9Subagents — это специализированные AI-помощники, которые обрабатывают определённые типы задач. Используйте один, когда побочная задача заполнит основной разговор результатами поиска, логами или содержимым файлов, на которые вы больше не будете ссылаться: subagent выполняет эту работу в собственном контексте и возвращает только резюме. Определите пользовательский subagent, когда вы постоянно порождаете одного и того же рабочего с одинаковыми инструкциями.

10 10 

11Каждый subagent работает в собственном контекстном окне с пользовательским системным приглашением, специфическим доступом к инструментам и независимыми разрешениями. Когда Claude встречает задачу, соответствующую описанию subagent, он делегирует её этому subagent, который работает независимо и возвращает результаты. Чтобы увидеть экономию контекста на практике, [визуализация контекстного окна](/ru/context-window) проходит через сессию, где subagent обрабатывает исследование в собственном отдельном окне.11Каждый subagent работает в собственном контекстном окне с пользовательским системным приглашением, специфическим доступом к инструментам и независимыми разрешениями. Когда Claude встречает задачу, соответствующую описанию subagent, он делегирует её этому subagent, который работает независимо и возвращает результаты. Чтобы увидеть экономию контекста на практике, [визуализация контекстного окна](/docs/ru/context-window) проходит через сессию, где subagent обрабатывает исследование в собственном отдельном окне.

12 12 

13<Note>13<Note>

14 Subagents работают в рамках одной сессии. Чтобы запустить множество независимых сессий параллельно и отслеживать их из одного места, см. [background agents](/ru/agent-view). Для сессий, которые взаимодействуют друг с другом, см. [agent teams](/ru/agent-teams).14 Subagents работают в рамках одной сессии. Чтобы запустить множество независимых сессий параллельно и отслеживать их из одного места, см. [background agents](/docs/ru/agent-view). Для сессий, которые взаимодействуют друг с другом, см. [agent teams](/docs/ru/agent-teams).

15</Note>15</Note>

16 16 

17Subagents помогают вам:17Subagents помогают вам:


42 * **Tools**: инструменты только для чтения; Write и Edit запрещены42 * **Tools**: инструменты только для чтения; Write и Edit запрещены

43 * **Purpose**: обнаружение файлов, поиск кода, исследование кодовой базы43 * **Purpose**: обнаружение файлов, поиск кода, исследование кодовой базы

44 44 

45 {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, Explore наследует модель основного разговора вместо того, чтобы всегда работать на Haiku. На Claude API унаследованная модель ограничена Opus: основной разговор на более высоком уровне запускает Explore на Opus, а основной разговор на Sonnet или Haiku запускает Explore на той же модели. На любом другом поставщике, таком как [Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform on AWS](/ru/third-party-integrations), Explore наследует модель основного разговора напрямую.45 Начиная с версии 2.1.198, Explore наследует модель основного разговора вместо того, чтобы всегда работать на Haiku. На Claude API унаследованная модель ограничена Opus: основной разговор на более высоком уровне запускает Explore на Opus, а основной разговор на Sonnet или Haiku запускает Explore на той же модели. На любом другом поставщике, таком как [Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform on AWS](/docs/ru/third-party-integrations), Explore наследует модель основного разговора напрямую.

46 46 

47 [Пользовательский или проектный subagent](#choose-the-subagent-scope) с именем `Explore` переопределяет встроенный и сохраняет собственное поле `model`, поэтому определите его с `model: haiku`, чтобы сохранить исследование на модели с более низкой стоимостью.47 [Пользовательский или проектный subagent](#choose-the-subagent-scope) с именем `Explore` переопределяет встроенный и сохраняет собственное поле `model`, поэтому определите его с `model: haiku`, чтобы сохранить исследование на модели с более низкой стоимостью.

48 48 


52 </Tab>52 </Tab>

53 53 

54 <Tab title="Plan">54 <Tab title="Plan">

55 Исследовательский агент, используемый во время [plan mode](/ru/permission-modes#analyze-before-you-edit-with-plan-mode) для сбора контекста перед представлением плана.55 Исследовательский агент, используемый во время [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) для сбора контекста перед представлением плана.

56 56 

57 * **Model**: наследуется из основного разговора57 * **Model**: наследуется из основного разговора

58 * **Tools**: инструменты только для чтения; Write и Edit запрещены58 * **Tools**: инструменты только для чтения; Write и Edit запрещены


84Встроенные subagents регистрируются по умолчанию в интерактивных сессиях. Чтобы ограничить их:84Встроенные subagents регистрируются по умолчанию в интерактивных сессиях. Чтобы ограничить их:

85 85 

86* Чтобы заблокировать определённый встроенный тип, добавьте его в `permissions.deny`, как показано в [Отключение определённых subagents](#disable-specific-subagents).86* Чтобы заблокировать определённый встроенный тип, добавьте его в `permissions.deny`, как показано в [Отключение определённых subagents](#disable-specific-subagents).

87* Чтобы предотвратить делегирование Claude к любому subagent, запретите сам инструмент `Agent` с помощью [`permissions.deny`](/ru/permissions#tool-specific-permission-rules).87* Чтобы предотвратить делегирование Claude к любому subagent, запретите сам инструмент `Agent` с помощью [`permissions.deny`](/docs/ru/permissions#tool-specific-permission-rules).

88* {/* min-version: 2.1.198 */}Чтобы удалить только встроенные subagents `Explore` и `Plan`, установите [`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1`](/ru/env-vars). Claude читает и исследует файлы напрямую вместо делегирования им. Требуется Claude Code версии 2.1.198 или позже.88* Чтобы удалить только встроенные subagents `Explore` и `Plan`, установите [`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1`](/docs/ru/env-vars). Claude читает и исследует файлы напрямую вместо делегирования им. Требуется Claude Code версии 2.1.198 или позже.

89* В [неинтерактивном режиме](/ru/headless) и [Agent SDK](/ru/agent-sdk/overview) установите [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/ru/env-vars) для удаления всех встроенных типов и предоставления только ваших собственных.89* В [неинтерактивном режиме](/docs/ru/headless) и [Agent SDK](/docs/ru/agent-sdk/overview) установите [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/ru/env-vars) для удаления всех встроенных типов и предоставления только ваших собственных.

90 90 

91Помимо этих встроенных subagents, вы можете создавать свои собственные с пользовательскими приглашениями, ограничениями инструментов, режимами разрешений, hooks и skills. В следующих разделах показано, как начать работу и настроить subagents.91Помимо этих встроенных subagents, вы можете создавать свои собственные с пользовательскими приглашениями, ограничениями инструментов, режимами разрешений, hooks и skills. В следующих разделах показано, как начать работу и настроить subagents.

92 92 


96 96 

97Subagents определяются в файлах Markdown с YAML frontmatter. Чтобы создать один, попросите Claude написать его для вас или [напишите файл самостоятельно](#write-subagent-files).97Subagents определяются в файлах Markdown с YAML frontmatter. Чтобы создать один, попросите Claude написать его для вас или [напишите файл самостоятельно](#write-subagent-files).

98 98 

99{/* min-version: 2.1.198 */}Начиная с версии v2.1.198, команда `/agents` больше не открывает интерактивный мастер создания; её запуск выводит напоминание попросить Claude или отредактировать `.claude/agents/` напрямую. Файлы subagent, поля frontmatter и местоположения `.claude/agents/` и `~/.claude/agents/` остаются неизменными; удалён только терминальный мастер.99Начиная с версии v2.1.198, команда `/agents` больше не открывает интерактивный мастер создания; её запуск выводит напоминание попросить Claude или отредактировать `.claude/agents/` напрямую. Файлы subagent, поля frontmatter и местоположения `.claude/agents/` и `~/.claude/agents/` остаются неизменными; удалён только терминальный мастер.

100 100 

101Это пошаговое руководство создаёт subagent уровня пользователя, который проверяет код и предлагает улучшения.101Это пошаговое руководство создаёт subagent уровня пользователя, который проверяет код и предлагает улучшения.

102 102 


150Вы также можете писать файлы subagent вручную, определять их через флаги CLI или распространять их через plugins. В следующих разделах рассматриваются все параметры конфигурации.150Вы также можете писать файлы subagent вручную, определять их через флаги CLI или распространять их через plugins. В следующих разделах рассматриваются все параметры конфигурации.

151 151 

152<Note>152<Note>

153 На Claude Code v2.1.197 и более ранних версиях `/agents` открывает интерактивный мастер с вкладкой **Running**, которая отображает активные subagents, и вкладкой **Library** для их создания, редактирования и удаления. {/* max-version: 2.1.197 */}153 На Claude Code v2.1.197 и более ранних версиях `/agents` открывает интерактивный мастер с вкладкой **Running**, которая отображает активные subagents, и вкладкой **Library** для их создания, редактирования и удаления.&#x20;

154</Note>154</Note>

155 155 

156<h2 id="configure-subagents">156<h2 id="configure-subagents">


167 167 

168| Location | Scope | Priority | Как создать |168| Location | Scope | Priority | Как создать |

169| :-------------------------- | :----------------- | :------------- | :------------------------------------------------ |169| :-------------------------- | :----------------- | :------------- | :------------------------------------------------ |

170| Managed settings | Организация | 1 (наивысший) | Развёрнуто через [managed settings](/ru/settings) |170| Managed settings | Организация | 1 (наивысший) | Развёрнуто через [managed settings](/docs/ru/settings) |

171| `--agents` CLI flag | Текущая сессия | 2 | Передайте JSON при запуске Claude Code |171| `--agents` CLI flag | Текущая сессия | 2 | Передайте JSON при запуске Claude Code |

172| `.claude/agents/` | Текущий проект | 3 | Попросите Claude или создайте файл вручную |172| `.claude/agents/` | Текущий проект | 3 | Попросите Claude или создайте файл вручную |

173| `~/.claude/agents/` | Все ваши проекты | 4 | Попросите Claude или создайте файл вручную |173| `~/.claude/agents/` | Все ваши проекты | 4 | Попросите Claude или создайте файл вручную |

174| Директория `agents/` plugin | Где включен plugin | 5 (наименьший) | Установлено с [plugins](/ru/plugins) |174| Директория `agents/` plugin | Где включен plugin | 5 (наименьший) | Установлено с [plugins](/docs/ru/plugins) |

175 175 

176**Project subagents** (`.claude/agents/`) идеальны для subagents, специфичных для кодовой базы. Проверьте их в систему контроля версий, чтобы ваша команда могла использовать и улучшать их совместно.176**Project subagents** (`.claude/agents/`) идеальны для subagents, специфичных для кодовой базы. Проверьте их в систему контроля версий, чтобы ваша команда могла использовать и улучшать их совместно.

177 177 

178Project subagents обнаруживаются путём прохода вверх от текущей рабочей директории, поэтому каждый `.claude/agents/` между ней и корнем репозитория сканируется. {/* min-version: 2.1.178 */}Начиная с версии 2.1.178, когда более одной из этих вложенных директорий определяет одно и то же `name`, Claude Code использует определение, ближайшее к рабочей директории.178Project subagents обнаруживаются путём прохода вверх от текущей рабочей директории, поэтому каждый `.claude/agents/` между ней и корнем репозитория сканируется. Начиная с версии 2.1.178, когда более одной из этих вложенных директорий определяет одно и то же `name`, Claude Code использует определение, ближайшее к рабочей директории.

179 179 

180Директории, добавленные с помощью `--add-dir`, также сканируются: папка `.claude/agents/` внутри добавленной директории загружается вместе с project subagents. См. [Additional directories](/ru/permissions#additional-directories-grant-file-access-not-configuration) для того, какие другие типы конфигурации загружаются из `--add-dir`. Чтобы поделиться subagents в проектах без `--add-dir`, используйте `~/.claude/agents/` или [plugin](/ru/plugins).180Директории, добавленные с помощью `--add-dir`, также сканируются: папка `.claude/agents/` внутри добавленной директории загружается вместе с project subagents. См. [Additional directories](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) для того, какие другие типы конфигурации загружаются из `--add-dir`. Чтобы поделиться subagents в проектах без `--add-dir`, используйте `~/.claude/agents/` или [plugin](/docs/ru/plugins).

181 181 

182**User subagents** (`~/.claude/agents/`) — это личные subagents, доступные во всех ваших проектах.182**User subagents** (`~/.claude/agents/`) — это личные subagents, доступные во всех ваших проектах.

183 183 

184Claude Code сканирует `.claude/agents/` и `~/.claude/agents/` рекурсивно, поэтому вы можете организовать определения в подпапки, такие как `agents/review/` или `agents/research/`. Путь подпапки не влияет на то, как идентифицируется или вызывается subagent, потому что идентичность происходит только из поля `name` frontmatter.184Claude Code сканирует `.claude/agents/` и `~/.claude/agents/` рекурсивно, поэтому вы можете организовать определения в подпапки, такие как `agents/review/` или `agents/research/`. Путь подпапки не влияет на то, как идентифицируется или вызывается subagent, потому что идентичность происходит только из поля `name` frontmatter.

185 185 

186Сохраняйте значения `name` уникальными по всему дереву: если два файла под одной директорией `.claude/agents/`, включая её подпапки, объявляют одно и то же имя, Claude Code загружает только один из них, выбранный по порядку чтения файловой системы, а не по документированному приоритету. Во вложенных директориях проекта определение, ближайшее к рабочей директории, побеждает, как описано выше. {/* min-version: 2.1.205 */}Проверка настройки [`/doctor`](/ru/commands#all-commands) сообщает о файлах в одной директории, которые имеют одно и то же имя, и предлагает переименовать или удалить все, кроме одного. До версии 2.1.205 `/doctor` открывал экран диагностики, который перечислял дубликаты и показывал, какое определение было активно.186Сохраняйте значения `name` уникальными по всему дереву: если два файла под одной директорией `.claude/agents/`, включая её подпапки, объявляют одно и то же имя, Claude Code загружает только один из них, выбранный по порядку чтения файловой системы, а не по документированному приоритету. Во вложенных директориях проекта определение, ближайшее к рабочей директории, побеждает, как описано выше. Проверка настройки [`/doctor`](/docs/ru/commands#all-commands) сообщает о файлах в одной директории, которые имеют одно и то же имя, и предлагает переименовать или удалить все, кроме одного. До версии 2.1.205 `/doctor` открывал экран диагностики, который перечислял дубликаты и показывал, какое определение было активно.

187 187 

188Директории `agents/` plugin также сканируются рекурсивно. В отличие от областей проекта и пользователя, подпапка внутри директории `agents/` plugin становится частью [scoped identifier](#invoke-subagents-explicitly): файл в `agents/review/security.md` в plugin `my-plugin` регистрируется как `my-plugin:review:security`.188Директории `agents/` plugin также сканируются рекурсивно. В отличие от областей проекта и пользователя, подпапка внутри директории `agents/` plugin становится частью [scoped identifier](#invoke-subagents-explicitly): файл в `agents/review/security.md` в plugin `my-plugin` регистрируется как `my-plugin:review:security`.

189 189 


229 229 

230Флаг `--agents` принимает JSON с теми же полями [frontmatter](#supported-frontmatter-fields), что и файловые subagents: `description`, `prompt`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `isolation` и `color`. Используйте `prompt` для системного приглашения, эквивалентного телу markdown в файловых subagents.230Флаг `--agents` принимает JSON с теми же полями [frontmatter](#supported-frontmatter-fields), что и файловые subagents: `description`, `prompt`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `isolation` и `color`. Используйте `prompt` для системного приглашения, эквивалентного телу markdown в файловых subagents.

231 231 

232**Managed subagents** развёртываются администраторами организации. Поместите файлы markdown в `.claude/agents/` внутри [директории managed settings](/ru/settings#settings-files), используя тот же формат frontmatter, что и project и user subagents. Managed определения имеют приоритет над project и user subagents с тем же именем.232**Managed subagents** развёртываются администраторами организации. Поместите файлы markdown в `.claude/agents/` внутри [директории managed settings](/docs/ru/settings#settings-files), используя тот же формат frontmatter, что и project и user subagents. Managed определения имеют приоритет над project и user subagents с тем же именем.

233 233 

234**Plugin subagents** поступают из [plugins](/ru/plugins), которые вы установили. Они загружаются вместе с вашими пользовательскими subagents и появляются в typeahead @-упоминания под их scoped name. См. [справку по компонентам plugin](/ru/plugins-reference#agents) для деталей создания plugin subagents.234**Plugin subagents** поступают из [plugins](/docs/ru/plugins), которые вы установили. Они загружаются вместе с вашими пользовательскими subagents и появляются в typeahead @-упоминания под их scoped name. См. [справку по компонентам plugin](/docs/ru/plugins-reference#agents) для деталей создания plugin subagents.

235 235 

236<Note>236<Note>

237 По соображениям безопасности plugin subagents не поддерживают поля frontmatter `hooks`, `mcpServers` или `permissionMode`. Эти поля игнорируются при загрузке агентов из plugin. Если они вам нужны, скопируйте файл агента в `.claude/agents/` или `~/.claude/agents/`. Вы также можете добавить правила в [`permissions.allow`](/ru/settings#permission-settings) в `settings.json` или `settings.local.json`, но эти правила применяются ко всей сессии, а не только к plugin subagent.237 По соображениям безопасности plugin subagents не поддерживают поля frontmatter `hooks`, `mcpServers` или `permissionMode`. Эти поля игнорируются при загрузке агентов из plugin. Если они вам нужны, скопируйте файл агента в `.claude/agents/` или `~/.claude/agents/`. Вы также можете добавить правила в [`permissions.allow`](/docs/ru/settings#permission-settings) в `settings.json` или `settings.local.json`, но эти правила применяются ко всей сессии, а не только к plugin subagent.

238</Note>238</Note>

239 239 

240Определения subagent из любой из этих областей также доступны для [agent teams](/ru/agent-teams#use-subagent-definitions-for-teammates): при порождении товарища по команде вы можете ссылаться на тип subagent, и товарищ использует его `tools` и `model`, с телом определения добавленным в качестве дополнительных инструкций к системному приглашению товарища. См. [agent teams](/ru/agent-teams#use-subagent-definitions-for-teammates) для того, какие поля frontmatter применяются на этом пути.240Определения subagent из любой из этих областей также доступны для [agent teams](/docs/ru/agent-teams#use-subagent-definitions-for-teammates): при порождении товарища по команде вы можете ссылаться на тип subagent, и товарищ использует его `tools` и `model`, с телом определения добавленным в качестве дополнительных инструкций к системному приглашению товарища. См. [agent teams](/docs/ru/agent-teams#use-subagent-definitions-for-teammates) для того, какие поля frontmatter применяются на этом пути.

241 241 

242<h3 id="write-subagent-files">242<h3 id="write-subagent-files">

243 Напишите файлы subagent243 Напишите файлы subagent


268 268 

269Frontmatter определяет метаданные и конфигурацию subagent. Тело становится системным приглашением, которое направляет поведение subagent. Subagents получают только это системное приглашение плюс базовые детали окружения, такие как рабочая директория, а не полное системное приглашение Claude Code.269Frontmatter определяет метаданные и конфигурацию subagent. Тело становится системным приглашением, которое направляет поведение subagent. Subagents получают только это системное приглашение плюс базовые детали окружения, такие как рабочая директория, а не полное системное приглашение Claude Code.

270 270 

271В [non-interactive mode](/ru/headless) флаг [`--append-subagent-system-prompt`](/ru/cli-reference#cli-flags) добавляет текст, который вы предоставляете, в конец системного приглашения каждого subagent, включая вложенные subagents. Требует Claude Code v2.1.205 или позже.271В [non-interactive mode](/docs/ru/headless) флаг [`--append-subagent-system-prompt`](/docs/ru/cli-reference#cli-flags) добавляет текст, который вы предоставляете, в конец системного приглашения каждого subagent, включая вложенные subagents. Требует Claude Code v2.1.205 или позже.

272 272 

273Subagent начинает работу в текущей рабочей директории основного разговора. В пределах subagent команды `cd` не сохраняются между вызовами инструментов Bash или PowerShell и не влияют на рабочую директорию основного разговора. Чтобы дать subagent изолированную копию репозитория вместо этого, установите [`isolation: worktree`](#supported-frontmatter-fields).273Subagent начинает работу в текущей рабочей директории основного разговора. В пределах subagent команды `cd` не сохраняются между вызовами инструментов Bash или PowerShell и не влияют на рабочую директорию основного разговора. Чтобы дать subagent изолированную копию репозитория вместо этого, установите [`isolation: worktree`](#supported-frontmatter-fields).

274 274 

275{/* min-version: 2.1.203 */}Subagent с `isolation: worktree` запускает свои команды Bash и PowerShell внутри своего worktree. Команда, рабочая директория которой разрешается в вашу основную копию вместо этого, например потому что директория worktree была удалена во время работы subagent, завершается с ошибкой. До версии 2.1.203 такая команда могла запуститься в основной копии.275Subagent с `isolation: worktree` запускает свои команды Bash и PowerShell внутри своего worktree. Команда, рабочая директория которой разрешается в вашу основную копию вместо этого, например потому что директория worktree была удалена во время работы subagent, завершается с ошибкой. До версии 2.1.203 такая команда могла запуститься в основной копии.

276 276 

277<h4 id="supported-frontmatter-fields">277<h4 id="supported-frontmatter-fields">

278 Поддерживаемые поля frontmatter278 Поддерживаемые поля frontmatter


282 282 

283| Field | Требуется | Description |283| Field | Требуется | Description |

284| :---------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |284| :---------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

285| `name` | Да | Уникальный идентификатор, использующий строчные буквы и дефисы. [Hooks](/ru/hooks#subagentstart) получают это значение как `agent_type`. Имя файла не должно совпадать |285| `name` | Да | Уникальный идентификатор, использующий строчные буквы и дефисы. [Hooks](/docs/ru/hooks#subagentstart) получают это значение как `agent_type`. Имя файла не должно совпадать |

286| `description` | Да | Когда Claude должен делегировать этому subagent |286| `description` | Да | Когда Claude должен делегировать этому subagent |

287| `tools` | Нет | [Инструменты](#available-tools), которые может использовать subagent. Наследует все инструменты, если опущено. Если ни один элемент в списке не разрешается в инструмент, subagent не запускается с ошибкой, называющей элементы. Чтобы предварительно загрузить Skills в контекст, используйте поле `skills` вместо перечисления `Skill` здесь |287| `tools` | Нет | [Инструменты](#available-tools), которые может использовать subagent. Наследует все инструменты, если опущено. Если ни один элемент в списке не разрешается в инструмент, subagent не запускается с ошибкой, называющей элементы. Чтобы предварительно загрузить Skills в контекст, используйте поле `skills` вместо перечисления `Skill` здесь |

288| `disallowedTools` | Нет | Инструменты для запрета, удалённые из унаследованного или указанного списка |288| `disallowedTools` | Нет | Инструменты для запрета, удалённые из унаследованного или указанного списка |

289| `model` | Нет | [Модель](#choose-a-model) для использования: `sonnet`, `opus`, `haiku`, `fable`, полный ID модели (например, `claude-opus-4-8`), или `inherit`. По умолчанию `inherit` |289| `model` | Нет | [Модель](#choose-a-model) для использования: `sonnet`, `opus`, `haiku`, `fable`, полный ID модели (например, `claude-opus-4-8`), или `inherit`. По умолчанию `inherit` |

290| `permissionMode` | Нет | [Режим разрешений](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, или {/* min-version: 2.1.200 */}`manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |290| `permissionMode` | Нет | [Режим разрешений](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, или `manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |

291| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой subagent |291| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой subagent |

292| `skills` | Нет | [Skills](/ru/skills) для предварительной загрузки в контекст subagent при запуске. Полное содержимое skill инжектируется, а не просто описание. Subagents по-прежнему могут вызывать неперечисленные project, user и plugin skills через инструмент Skill |292| `skills` | Нет | [Skills](/docs/ru/skills) для предварительной загрузки в контекст subagent при запуске. Полное содержимое skill инжектируется, а не просто описание. Subagents по-прежнему могут вызывать неперечисленные project, user и plugin skills через инструмент Skill |

293| `mcpServers` | Нет | [MCP servers](/ru/mcp) доступные этому subagent. Каждая запись — это либо имя сервера, ссылающееся на уже настроенный сервер (например, `"slack"`), либо встроенное определение с именем сервера в качестве ключа и полной [конфигурацией MCP server](/ru/mcp#installing-mcp-servers) в качестве значения. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |293| `mcpServers` | Нет | [MCP servers](/docs/ru/mcp) доступные этому subagent. Каждая запись — это либо имя сервера, ссылающееся на уже настроенный сервер (например, `"slack"`), либо встроенное определение с именем сервера в качестве ключа и полной [конфигурацией MCP server](/docs/ru/mcp#installing-mcp-servers) в качестве значения. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |

294| `hooks` | Нет | [Lifecycle hooks](#define-hooks-for-subagents) в области этого subagent. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |294| `hooks` | Нет | [Lifecycle hooks](#define-hooks-for-subagents) в области этого subagent. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |

295| `memory` | Нет | [Область постоянной памяти](#enable-persistent-memory): `user`, `project` или `local`. Включает кросс-сессионное обучение |295| `memory` | Нет | [Область постоянной памяти](#enable-persistent-memory): `user`, `project` или `local`. Включает кросс-сессионное обучение |

296| `background` | Нет | Установите на `true`, чтобы всегда запускать этот subagent как [фоновую задачу](#run-subagents-in-foreground-or-background), даже когда Claude нуждается в его результате прямо сейчас. Если не установлено, Claude выбирает, и {/* min-version: 2.1.198 */}начиная с версии 2.1.198 он запускает subagents в фоне по умолчанию |296| `background` | Нет | Установите на `true`, чтобы всегда запускать этот subagent как [фоновую задачу](#run-subagents-in-foreground-or-background), даже когда Claude нуждается в его результате прямо сейчас. Если не установлено, Claude выбирает, и начиная с версии 2.1.198 он запускает subagents в фоне по умолчанию |

297| `effort` | Нет | Уровень усилий, когда этот subagent активен. Переопределяет уровень усилий сессии. По умолчанию: наследуется из сессии. Параметры: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели |297| `effort` | Нет | Уровень усилий, когда этот subagent активен. Переопределяет уровень усилий сессии. По умолчанию: наследуется из сессии. Параметры: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели |

298| `isolation` | Нет | Установите на `worktree`, чтобы запустить subagent во временном [git worktree](/ru/worktrees), дав ему изолированную копию репозитория, разветвлённую по умолчанию от вашей [ветки по умолчанию](/ru/worktrees#choose-the-base-branch), а не от `HEAD` родительской сессии. Worktree автоматически очищается, если subagent не вносит изменения |298| `isolation` | Нет | Установите на `worktree`, чтобы запустить subagent во временном [git worktree](/docs/ru/worktrees), дав ему изолированную копию репозитория, разветвлённую по умолчанию от вашей [ветки по умолчанию](/docs/ru/worktrees#choose-the-base-branch), а не от `HEAD` родительской сессии. Worktree автоматически очищается, если subagent не вносит изменения |

299| `color` | Нет | Цвет отображения для subagent в списке задач и транскрипте. Принимает `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink` или `cyan` |299| `color` | Нет | Цвет отображения для subagent в списке задач и транскрипте. Принимает `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink` или `cyan` |

300| `initialPrompt` | Нет | Автоматически отправляется как первый ход пользователя, когда этот агент работает как основной агент сессии (через `--agent` или параметр `agent`). [Commands](/ru/commands) и [skills](/ru/skills) обрабатываются. Добавляется в начало любого предоставленного пользователем приглашения |300| `initialPrompt` | Нет | Автоматически отправляется как первый ход пользователя, когда этот агент работает как основной агент сессии (через `--agent` или параметр `agent`). [Commands](/docs/ru/commands) и [skills](/docs/ru/skills) обрабатываются. Добавляется в начало любого предоставленного пользователем приглашения |

301 301 

302<h3 id="choose-a-model">302<h3 id="choose-a-model">

303 Выберите модель303 Выберите модель

304</h3>304</h3>

305 305 

306Поле `model` контролирует, какую [AI модель](/ru/model-config) использует subagent:306Поле `model` контролирует, какую [AI модель](/docs/ru/model-config) использует subagent:

307 307 

308* **Model alias**: Используйте один из доступных псевдонимов: `sonnet`, `opus`, `haiku` или `fable`308* **Model alias**: Используйте один из доступных псевдонимов: `sonnet`, `opus`, `haiku` или `fable`

309* **Full model ID**: Используйте полный ID модели, такой как `claude-opus-4-8` или `claude-sonnet-5`. Принимает те же значения, что и флаг `--model`309* **Full model ID**: Используйте полный ID модели, такой как `claude-opus-4-8` или `claude-sonnet-5`. Принимает те же значения, что и флаг `--model`


312 312 

313Когда Claude вызывает subagent, он также может передать параметр `model` для этого конкретного вызова. Claude Code разрешает модель subagent в этом порядке:313Когда Claude вызывает subagent, он также может передать параметр `model` для этого конкретного вызова. Claude Code разрешает модель subagent в этом порядке:

314 314 

3151. Переменная окружения [`CLAUDE_CODE_SUBAGENT_MODEL`](/ru/model-config#environment-variables), если установлена на псевдоним модели или ID модели3151. Переменная окружения [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ru/model-config#environment-variables), если установлена на псевдоним модели или ID модели

3162. Параметр `model` для конкретного вызова3162. Параметр `model` для конкретного вызова

3173. Frontmatter `model` определения subagent3173. Frontmatter `model` определения subagent

3184. Модель основного разговора3184. Модель основного разговора

319 319 

320{/* min-version: 2.1.196 */}Начиная с версии 2.1.196, установка `CLAUDE_CODE_SUBAGENT_MODEL` на `inherit` — это то же самое, что оставить его неустановленным: разрешение продолжается с параметром `model` для конкретного вызова, затем frontmatter. В более ранних версиях `inherit` заставлял subagents использовать модель основного разговора и игнорировал оба этих источника.320Начиная с версии 2.1.196, установка `CLAUDE_CODE_SUBAGENT_MODEL` на `inherit` — это то же самое, что оставить его неустановленным: разрешение продолжается с параметром `model` для конкретного вызова, затем frontmatter. В более ранних версиях `inherit` заставлял subagents использовать модель основного разговора и игнорировал оба этих источника.

321 321 

322Переменная окружения, параметр для конкретного вызова и значения frontmatter проверяются на соответствие списку разрешений [`availableModels`](/ru/model-config#restrict-model-selection) вашей организации. Значение, которое разрешается в исключённую модель, не используется, и subagent вместо этого работает на унаследованной модели.322Переменная окружения, параметр для конкретного вызова и значения frontmatter проверяются на соответствие списку разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) вашей организации. Значение, которое разрешается в исключённую модель, не используется, и subagent вместо этого работает на унаследованной модели.

323 323 

324{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, subagents также наследуют конфигурацию [extended thinking](/ru/model-config#extended-thinking) основного разговора: если thinking включен в вашей сессии, он включен для subagent, и если он выключен, он остаётся выключенным. Нет параметра thinking для каждого subagent. До версии 2.1.198 subagents запускались с отключённым extended thinking независимо от параметра основного разговора.324Начиная с версии 2.1.198, subagents также наследуют конфигурацию [extended thinking](/docs/ru/model-config#extended-thinking) основного разговора: если thinking включен в вашей сессии, он включен для subagent, и если он выключен, он остаётся выключенным. Нет параметра thinking для каждого subagent. До версии 2.1.198 subagents запускались с отключённым extended thinking независимо от параметра основного разговора.

325 325 

326<h3 id="control-subagent-capabilities">326<h3 id="control-subagent-capabilities">

327 Контролируйте возможности subagent327 Контролируйте возможности subagent


333 Доступные инструменты333 Доступные инструменты

334</h4>334</h4>

335 335 

336Subagents наследуют [внутренние инструменты](/ru/tools-reference) и MCP инструменты, доступные в основном разговоре по умолчанию. Следующие инструменты зависят от пользовательского интерфейса основного разговора или состояния сессии и недоступны для subagents, даже если они указаны в поле `tools`:336Subagents наследуют [внутренние инструменты](/docs/ru/tools-reference) и MCP инструменты, доступные в основном разговоре по умолчанию. Следующие инструменты зависят от пользовательского интерфейса основного разговора или состояния сессии и недоступны для subagents, даже если они указаны в поле `tools`:

337 337 

338* `AskUserQuestion`338* `AskUserQuestion`

339* `EnterPlanMode`339* `EnterPlanMode`


363 363 

364Если оба установлены, `disallowedTools` применяется первым, затем `tools` разрешается против оставшегося пула. Инструмент, указанный в обоих, удаляется.364Если оба установлены, `disallowedTools` применяется первым, затем `tools` разрешается против оставшегося пула. Инструмент, указанный в обоих, удаляется.

365 365 

366Когда ничего в списке `tools` не разрешается в инструмент, например потому что каждая запись неправильно написана или называет инструмент, который недоступен для subagents, Claude Code отказывается запускать subagent и инструмент Agent возвращает ошибку, называющую неразрешённые записи. {/* min-version: 2.1.208 */}До версии 2.1.208 этот subagent запускался без инструментов и мог вернуть пустой или запутанный результат.366Когда ничего в списке `tools` не разрешается в инструмент, например потому что каждая запись неправильно написана или называет инструмент, который недоступен для subagents, Claude Code отказывается запускать subagent и инструмент Agent возвращает ошибку, называющую неразрешённые записи. До версии 2.1.208 этот subagent запускался без инструментов и мог вернуть пустой или запутанный результат.

367 367 

368Оба поля принимают паттерны уровня MCP сервера в дополнение к точным названиям инструментов: `mcp__<server>` или `mcp__<server>__*` предоставляет или удаляет каждый инструмент из названного сервера. В `disallowedTools`, `mcp__*` также удаляет каждый MCP инструмент из любого сервера. Этот пример удаляет каждый инструмент из MCP сервера `github`, сохраняя инструменты из других серверов и каждый встроенный инструмент:368Оба поля принимают паттерны уровня MCP сервера в дополнение к точным названиям инструментов: `mcp__<server>` или `mcp__<server>__*` предоставляет или удаляет каждый инструмент из названного сервера. В `disallowedTools`, `mcp__*` также удаляет каждый MCP инструмент из любого сервера. Этот пример удаляет каждый инструмент из MCP сервера `github`, сохраняя инструменты из других серверов и каждый встроенный инструмент:

369 369 


407 Область MCP servers для subagent407 Область MCP servers для subagent

408</h4>408</h4>

409 409 

410Используйте поле `mcpServers` для предоставления subagent доступа к [MCP](/ru/mcp) серверам, которые недоступны в основном разговоре. Встроенные серверы, определённые здесь, подключаются при запуске subagent и отключаются при его завершении. Строковые ссылки используют соединение родительской сессии.410Используйте поле `mcpServers` для предоставления subagent доступа к [MCP](/docs/ru/mcp) серверам, которые недоступны в основном разговоре. Встроенные серверы, определённые здесь, подключаются при запуске subagent и отключаются при его завершении. Строковые ссылки используют соединение родительской сессии.

411 411 

412<Note>412<Note>

413 Поле `mcpServers` применяется в обоих контекстах, где может работать файл агента:413 Поле `mcpServers` применяется в обоих контекстах, где может работать файл агента:


415 * Как subagent, порождённый через инструмент Agent или @-упоминание415 * Как subagent, порождённый через инструмент Agent или @-упоминание

416 * Как основная сессия, запущенная с [`--agent`](#invoke-subagents-explicitly) или параметром `agent`416 * Как основная сессия, запущенная с [`--agent`](#invoke-subagents-explicitly) или параметром `agent`

417 417 

418 Когда агент является основной сессией, встроенные определения серверов подключаются при запуске вместе с серверами из [`.mcp.json`](/ru/mcp) и файлов настроек.418 Когда агент является основной сессией, встроенные определения серверов подключаются при запуске вместе с серверами из [`.mcp.json`](/docs/ru/mcp) и файлов настроек.

419</Note>419</Note>

420 420 

421Каждая запись в списке — это либо встроенное определение сервера, либо строка, ссылающаяся на MCP сервер, уже настроенный в вашей сессии:421Каждая запись в списке — это либо встроенное определение сервера, либо строка, ссылающаяся на MCP сервер, уже настроенный в вашей сессии:


443 443 

444Начиная с версии 2.1.153, ограничения MCP, которые применяются к основной сессии, также охватывают серверы, объявленные в frontmatter subagent:444Начиная с версии 2.1.153, ограничения MCP, которые применяются к основной сессии, также охватывают серверы, объявленные в frontmatter subagent:

445 445 

446* [`--strict-mcp-config`](/ru/cli-reference) и [`--bare`](/ru/cli-reference)446* [`--strict-mcp-config`](/docs/ru/cli-reference) и [`--bare`](/docs/ru/cli-reference)

447* [Enterprise управляемая конфигурация MCP](/ru/managed-mcp)447* [Enterprise управляемая конфигурация MCP](/docs/ru/managed-mcp)

448* [`allowedMcpServers` и `deniedMcpServers` политики](/ru/managed-mcp#policy-based-control-with-allowlists-and-denylists)448* [`allowedMcpServers` и `deniedMcpServers` политики](/docs/ru/managed-mcp#policy-based-control-with-allowlists-and-denylists)

449 449 

450Когда один из них блокирует сервер, Claude Code пропускает его и показывает предупреждение с названием заблокированных серверов.450Когда один из них блокирует сервер, Claude Code пропускает его и показывает предупреждение с названием заблокированных серверов.

451 451 


461| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |461| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

462| `default` | Стандартная проверка разрешений с запросами |462| `default` | Стандартная проверка разрешений с запросами |

463| `acceptEdits` | Автоматически принимать редактирование файлов и общие команды файловой системы для путей в рабочей директории или `additionalDirectories` |463| `acceptEdits` | Автоматически принимать редактирование файлов и общие команды файловой системы для путей в рабочей директории или `additionalDirectories` |

464| `auto` | [Auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode): классификатор AI оценивает каждый вызов инструмента и записи в защищённые директории |464| `auto` | [Auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode): классификатор AI оценивает каждый вызов инструмента и записи в защищённые директории |

465| `dontAsk` | Автоматически отклонять запросы разрешений. Явно разрешённые инструменты по-прежнему работают; `AskUserQuestion`, инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), отклоняются, даже если вы их разрешили |465| `dontAsk` | Автоматически отклонять запросы разрешений. Явно разрешённые инструменты по-прежнему работают; `AskUserQuestion`, инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) и MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), отклоняются, даже если вы их разрешили |

466| `bypassPermissions` | Пропустить все проверки разрешений |466| `bypassPermissions` | Пропустить все проверки разрешений |

467| `plan` | Режим плана (исследование только для чтения) |467| `plan` | Режим плана (исследование только для чтения) |

468 468 

469<Warning>469<Warning>

470 Используйте `bypassPermissions` с осторожностью. Это пропускает все проверки разрешений, позволяя subagent выполнять любую операцию без одобрения, включая записи в `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` и `.mvn`.470 Используйте `bypassPermissions` с осторожностью. Это пропускает все проверки разрешений, позволяя subagent выполнять любую операцию без одобрения, включая записи в `.git`, `.config/git`, `.claude`, `.vscode`, `.idea`, `.husky`, `.cargo`, `.devcontainer`, `.yarn` и `.mvn`.

471 471 

472 Явные правила [`ask`](/ru/permissions#manage-permissions), инструменты соединителя [которые ваша организация установила на `ask`](/ru/mcp#organization-controls-on-connector-tools), MCP инструменты, отмеченные [`requiresUserInteraction`](/ru/mcp#require-approval-for-a-specific-tool), и удаления корневого и домашнего каталога, такие как `rm -rf /`, по-прежнему требуют подтверждения. См. [permission modes](/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для деталей.472 Явные правила [`ask`](/docs/ru/permissions#manage-permissions), инструменты соединителя [которые ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools), MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), и удаления корневого и домашнего каталога, такие как `rm -rf /`, по-прежнему требуют подтверждения. См. [permission modes](/docs/ru/permission-modes#skip-all-checks-with-bypasspermissions-mode) для деталей.

473</Warning>473</Warning>

474 474 

475Если родитель использует `bypassPermissions` или `acceptEdits`, это имеет приоритет и не может быть переопределено. Если родитель использует [auto mode](/ru/permission-modes#eliminate-prompts-with-auto-mode), subagent наследует auto mode и любой `permissionMode` в его frontmatter игнорируется: классификатор оценивает вызовы инструментов subagent с теми же правилами блокировки и разрешения, что и родительская сессия.475Если родитель использует `bypassPermissions` или `acceptEdits`, это имеет приоритет и не может быть переопределено. Если родитель использует [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), subagent наследует auto mode и любой `permissionMode` в его frontmatter игнорируется: классификатор оценивает вызовы инструментов subagent с теми же правилами блокировки и разрешения, что и родительская сессия.

476 476 

477<h4 id="preload-skills-into-subagents">477<h4 id="preload-skills-into-subagents">

478 Предварительная загрузка skills в subagents478 Предварительная загрузка skills в subagents


494 494 

495Полное содержимое каждого перечисленного skill инжектируется в контекст subagent при запуске. Это поле контролирует, какие skills предварительно загружаются, а не какие skills может использовать subagent: без него subagent по-прежнему может открывать и вызывать project, user и plugin skills через инструмент Skill во время выполнения. Чтобы предотвратить использование subagent skills полностью, опустите `Skill` из списка [`tools`](#available-tools) или добавьте его в `disallowedTools`.495Полное содержимое каждого перечисленного skill инжектируется в контекст subagent при запуске. Это поле контролирует, какие skills предварительно загружаются, а не какие skills может использовать subagent: без него subagent по-прежнему может открывать и вызывать project, user и plugin skills через инструмент Skill во время выполнения. Чтобы предотвратить использование subagent skills полностью, опустите `Skill` из списка [`tools`](#available-tools) или добавьте его в `disallowedTools`.

496 496 

497Вы не можете предварительно загружать skills, которые устанавливают [`disable-model-invocation: true`](/ru/skills#control-who-invokes-a-skill), поскольку предварительная загрузка берёт из того же набора skills, который Claude может вызывать. Если указанный skill отсутствует или отключен, Claude Code пропускает его и регистрирует предупреждение в журнал отладки.497Вы не можете предварительно загружать skills, которые устанавливают [`disable-model-invocation: true`](/docs/ru/skills#control-who-invokes-a-skill), поскольку предварительная загрузка берёт из того же набора skills, который Claude может вызывать. Если указанный skill отсутствует или отключен, Claude Code пропускает его и регистрирует предупреждение в журнал отладки.

498 498 

499<Note>499<Note>

500 Это противоположность [запуску skill в subagent](/ru/skills#run-skills-in-a-subagent). С `skills` в subagent, subagent контролирует системное приглашение и загружает содержимое skill. С `context: fork` в skill, содержимое skill инжектируется в агента, который вы указываете. Оба используют одну и ту же базовую систему.500 Это противоположность [запуску skill в subagent](/docs/ru/skills#run-skills-in-a-subagent). С `skills` в subagent, subagent контролирует системное приглашение и загружает содержимое skill. С `context: fork` в skill, содержимое skill инжектируется в агента, который вы указываете. Оба используют одну и ту же базовую систему.

501</Note>501</Note>

502 502 

503<h4 id="enable-persistent-memory">503<h4 id="enable-persistent-memory">


569---569---

570```570```

571 571 

572Claude Code [передаёт входные данные hook как JSON](/ru/hooks#pretooluse-input) через stdin командам hook. Скрипт валидации читает этот JSON, извлекает команду Bash и [выходит с кодом 2](/ru/hooks#exit-code-2-behavior-per-event) для блокировки операций записи:572Claude Code [передаёт входные данные hook как JSON](/docs/ru/hooks#pretooluse-input) через stdin командам hook. Скрипт валидации читает этот JSON, извлекает команду Bash и [выходит с кодом 2](/docs/ru/hooks#exit-code-2-behavior-per-event) для блокировки операций записи:

573 573 

574```bash theme={null}574```bash theme={null}

575#!/bin/bash575#!/bin/bash


587exit 0587exit 0

588```588```

589 589 

590См. [Hook input](/ru/hooks#pretooluse-input) для полной схемы входных данных и [exit codes](/ru/hooks#exit-code-output) для того, как коды выхода влияют на поведение. На Windows напишите скрипты hook в PowerShell и добавьте `shell: powershell` к записи hook, как показано в [запуске hooks в PowerShell](/ru/hooks#windows-powershell-tool).590См. [Hook input](/docs/ru/hooks#pretooluse-input) для полной схемы входных данных и [exit codes](/docs/ru/hooks#exit-code-output) для того, как коды выхода влияют на поведение. На Windows напишите скрипты hook в PowerShell и добавьте `shell: powershell` к записи hook, как показано в [запуске hooks в PowerShell](/docs/ru/hooks#windows-powershell-tool).

591 591 

592<h4 id="disable-specific-subagents">592<h4 id="disable-specific-subagents">

593 Отключите конкретные subagents593 Отключите конкретные subagents

594</h4>594</h4>

595 595 

596Вы можете предотвратить использование Claude конкретных subagents, добавив их в массив `deny` в ваших [settings](/ru/settings#permission-settings). Используйте формат `Agent(subagent-name)`, где `subagent-name` соответствует полю name subagent.596Вы можете предотвратить использование Claude конкретных subagents, добавив их в массив `deny` в ваших [settings](/docs/ru/settings#permission-settings). Используйте формат `Agent(subagent-name)`, где `subagent-name` соответствует полю name subagent.

597 597 

598```json theme={null}598```json theme={null}

599{599{


609claude --disallowedTools "Agent(Explore)"609claude --disallowedTools "Agent(Explore)"

610```610```

611 611 

612См. [документацию Permissions](/ru/permissions#tool-specific-permission-rules) для получения дополнительной информации о правилах разрешений.612См. [документацию Permissions](/docs/ru/permissions#tool-specific-permission-rules) для получения дополнительной информации о правилах разрешений.

613 613 

614<h3 id="define-hooks-for-subagents">614<h3 id="define-hooks-for-subagents">

615 Определите hooks для subagents615 Определите hooks для subagents

616</h3>616</h3>

617 617 

618Subagents могут определять [hooks](/ru/hooks), которые запускаются во время жизненного цикла subagent. Есть два способа настройки hooks:618Subagents могут определять [hooks](/docs/ru/hooks), которые запускаются во время жизненного цикла subagent. Есть два способа настройки hooks:

619 619 

620* **В frontmatter subagent**: Определите hooks, которые запускаются только во время активности этого subagent620* **В frontmatter subagent**: Определите hooks, которые запускаются только во время активности этого subagent

621* **В `settings.json`**: Определите hooks, которые запускаются в основной сессии при запуске или остановке subagents621* **В `settings.json`**: Определите hooks, которые запускаются в основной сессии при запуске или остановке subagents


627Определите hooks непосредственно в файле markdown subagent. Эти hooks запускаются только во время активности этого конкретного subagent и очищаются при его завершении.627Определите hooks непосредственно в файле markdown subagent. Эти hooks запускаются только во время активности этого конкретного subagent и очищаются при его завершении.

628 628 

629<Note>629<Note>

630 Frontmatter hooks срабатывают, когда агент порождается как subagent через инструмент Agent или @-упоминание, и когда агент работает как основной агент сессии через [`--agent`](#invoke-subagents-explicitly) или параметр `agent`. В случае основной сессии они запускаются вместе с любыми hooks, определёнными в [`settings.json`](/ru/hooks).630 Frontmatter hooks срабатывают, когда агент порождается как subagent через инструмент Agent или @-упоминание, и когда агент работает как основной агент сессии через [`--agent`](#invoke-subagents-explicitly) или параметр `agent`. В случае основной сессии они запускаются вместе с любыми hooks, определёнными в [`settings.json`](/docs/ru/hooks).

631</Note>631</Note>

632 632 

633Поддерживаются все [hook events](/ru/hooks#hook-events). Наиболее распространённые события для subagents:633Поддерживаются все [hook events](/docs/ru/hooks#hook-events). Наиболее распространённые события для subagents:

634 634 

635| Event | Matcher input | Когда это срабатывает |635| Event | Matcher input | Когда это срабатывает |

636| :------------ | :-------------- | :------------------------------------------------------------------------------ |636| :------------ | :-------------- | :------------------------------------------------------------------------------ |


671| `SubagentStart` | Имя типа агента | Когда subagent начинает выполнение |671| `SubagentStart` | Имя типа агента | Когда subagent начинает выполнение |

672| `SubagentStop` | Имя типа агента | Когда subagent завершает выполнение |672| `SubagentStop` | Имя типа агента | Когда subagent завершает выполнение |

673 673 

674Оба события поддерживают matchers для нацеливания на конкретные типы агентов по имени. Значение matcher — это поле frontmatter `name` для project-level и user-level subagents, или scoped identifier, такой как `my-plugin:db-agent` для [plugin subagents](/ru/plugins). Scoped name содержит двоеточие, поэтому он оценивается как [unanchored regular expression](/ru/hooks#matcher-patterns); закрепите его с помощью `^` и `$`, как в `^my-plugin:db-agent$`, чтобы соответствовать только этому агенту.674Оба события поддерживают matchers для нацеливания на конкретные типы агентов по имени. Значение matcher — это поле frontmatter `name` для project-level и user-level subagents, или scoped identifier, такой как `my-plugin:db-agent` для [plugin subagents](/docs/ru/plugins). Scoped name содержит двоеточие, поэтому он оценивается как [unanchored regular expression](/docs/ru/hooks#matcher-patterns); закрепите его с помощью `^` и `$`, как в `^my-plugin:db-agent$`, чтобы соответствовать только этому агенту.

675 675 

676Этот пример запускает скрипт установки только при запуске subagent `db-agent` и скрипт очистки при остановке любого subagent:676Этот пример запускает скрипт установки только при запуске subagent `db-agent` и скрипт очистки при остановке любого subagent:

677 677 


699 699 

700Matcher с дефисом, такой как `db-agent`, точно совпадает на Claude Code v2.1.195 или позже. На более ранних версиях он оценивается как unanchored regular expression и также срабатывает для любого типа агента, который его содержит, такого как `prod-db-agent`; закрепите его как `^db-agent$` на этих версиях.700Matcher с дефисом, такой как `db-agent`, точно совпадает на Claude Code v2.1.195 или позже. На более ранних версиях он оценивается как unanchored regular expression и также срабатывает для любого типа агента, который его содержит, такого как `prod-db-agent`; закрепите его как `^db-agent$` на этих версиях.

701 701 

702См. [Hooks](/ru/hooks) для полного формата конфигурации hook.702См. [Hooks](/docs/ru/hooks) для полного формата конфигурации hook.

703 703 

704<h2 id="work-with-subagents">704<h2 id="work-with-subagents">

705 Работа с subagents705 Работа с subagents


736 736 

737Ваше полное сообщение по-прежнему идёт Claude, который пишет приглашение задачи subagent на основе того, что вы попросили. @-упоминание контролирует, какой subagent Claude вызывает, а не какое приглашение он получает.737Ваше полное сообщение по-прежнему идёт Claude, который пишет приглашение задачи subagent на основе того, что вы попросили. @-упоминание контролирует, какой subagent Claude вызывает, а не какое приглашение он получает.

738 738 

739Subagents, предоставленные включённым [plugin](/ru/plugins), появляются в автодополнении под их именем с областью видимости, например `my-plugin:code-reviewer` или `my-plugin:review:security`, когда plugin [организует агентов в подпапки](#choose-the-subagent-scope). Именованные фоновые subagents, в настоящее время работающие в сессии, также появляются в автодополнении, показывая их статус рядом с именем.739Subagents, предоставленные включённым [plugin](/docs/ru/plugins), появляются в автодополнении под их именем с областью видимости, например `my-plugin:code-reviewer` или `my-plugin:review:security`, когда plugin [организует агентов в подпапки](#choose-the-subagent-scope). Именованные фоновые subagents, в настоящее время работающие в сессии, также появляются в автодополнении, показывая их статус рядом с именем.

740 740 

741Вы также можете ввести упоминание вручную без использования средства выбора: `@agent-<name>` для локальных subagents или `@agent-` с последующим именем с областью видимости для plugin subagents, например `@agent-my-plugin:code-reviewer`.741Вы также можете ввести упоминание вручную без использования средства выбора: `@agent-<name>` для локальных subagents или `@agent-` с последующим именем с областью видимости для plugin subagents, например `@agent-my-plugin:code-reviewer`.

742 742 

743**Запустите всю сессию как subagent.** Передайте [`--agent <name>`](/ru/cli-reference) для запуска сессии, где основной поток сам принимает системное приглашение, ограничения инструментов и модель этого subagent:743**Запустите всю сессию как subagent.** Передайте [`--agent <name>`](/docs/ru/cli-reference) для запуска сессии, где основной поток сам принимает системное приглашение, ограничения инструментов и модель этого subagent:

744 744 

745```bash theme={null}745```bash theme={null}

746claude --agent code-reviewer746claude --agent code-reviewer

747```747```

748 748 

749Системное приглашение subagent полностью заменяет системное приглашение Claude Code по умолчанию, так же как [`--system-prompt`](/ru/cli-reference) это делает. Файлы `CLAUDE.md` и память проекта по-прежнему загружаются через обычный поток сообщений. Имя агента появляется как `@<name>` в заголовке запуска, чтобы вы могли подтвердить, что он активен.749Системное приглашение subagent полностью заменяет системное приглашение Claude Code по умолчанию, так же как [`--system-prompt`](/docs/ru/cli-reference) это делает. Файлы `CLAUDE.md` и память проекта по-прежнему загружаются через обычный поток сообщений. Имя агента появляется как `@<name>` в заголовке запуска, чтобы вы могли подтвердить, что он активен.

750 750 

751Это работает с встроенными и пользовательскими subagents, и выбор сохраняется при возобновлении сессии.751Это работает с встроенными и пользовательскими subagents, и выбор сохраняется при возобновлении сессии.

752 752 


781Subagents могут работать в переднем плане или фоне:781Subagents могут работать в переднем плане или фоне:

782 782 

783* **Foreground subagents** блокируют основной разговор до завершения. Запросы разрешений передаются вам по мере их возникновения.783* **Foreground subagents** блокируют основной разговор до завершения. Запросы разрешений передаются вам по мере их возникновения.

784* **Background subagents** работают параллельно, пока вы продолжаете работать. {/* min-version: 2.1.186 */}Начиная с v2.1.186, когда фоновый subagent достигает вызова инструмента, требующего разрешения, приглашение появляется в вашей основной сессии и называет subagent, который спрашивает. Одобрите, чтобы позволить subagent продолжить, или нажмите Esc, чтобы отклонить этот вызов инструмента без остановки subagent. До v2.1.186 фоновые subagents автоматически отклоняли любой вызов инструмента, который иначе потребовал бы приглашения.784* **Background subagents** работают параллельно, пока вы продолжаете работать. Начиная с v2.1.186, когда фоновый subagent достигает вызова инструмента, требующего разрешения, приглашение появляется в вашей основной сессии и называет subagent, который спрашивает. Одобрите, чтобы позволить subagent продолжить, или нажмите Esc, чтобы отклонить этот вызов инструмента без остановки subagent. До v2.1.186 фоновые subagents автоматически отклоняли любой вызов инструмента, который иначе потребовал бы приглашения.

785 785 

786{/* min-version: 2.1.198 */}Начиная с v2.1.198, subagents работают в фоне по умолчанию. Claude запускает subagent в переднем плане, когда ему нужен результат перед продолжением. По умолчанию изменяется место выполнения subagent, а не то, что ему разрешено делать: фоновые subagents по-прежнему выводят каждый запрос разрешения в вашу основную сессию. До v2.1.198 Claude выбирал между передним планом и фоном на основе задачи.786Начиная с v2.1.198, subagents работают в фоне по умолчанию. Claude запускает subagent в переднем плане, когда ему нужен результат перед продолжением. По умолчанию изменяется место выполнения subagent, а не то, что ему разрешено делать: фоновые subagents по-прежнему выводят каждый запрос разрешения в вашу основную сессию. До v2.1.198 Claude выбирал между передним планом и фоном на основе задачи.

787 787 

788Вы также можете управлять этим самостоятельно:788Вы также можете управлять этим самостоятельно:

789 789 

790* Попросите Claude запустить задачу в фоне или в переднем плане790* Попросите Claude запустить задачу в фоне или в переднем плане

791* Нажмите **Ctrl+B** для фонового выполнения работающей задачи791* Нажмите **Ctrl+B** для фонового выполнения работающей задачи

792 792 

793{/* min-version: 2.1.208 */}Фоновый subagent, который завершается, остаётся в списке [`/tasks`](/ru/commands), отмечен как выполненный и отсортирован ниже работающих задач, пока сессия не очистит список задач. Его представление деталей остаётся открытым, когда subagent завершается. Subagents, которые не удаются или которые вы остановили, покидают список. До v2.1.208 завершённый subagent покидал список в момент завершения и его представление деталей закрывалось.793Фоновый subagent, который завершается, остаётся в списке [`/tasks`](/docs/ru/commands), отмечен как выполненный и отсортирован ниже работающих задач, пока сессия не очистит список задач. Его представление деталей остаётся открытым, когда subagent завершается. Subagents, которые не удаются или которые вы остановили, покидают список. До v2.1.208 завершённый subagent покидал список в момент завершения и его представление деталей закрывалось.

794 794 

795Чтобы отключить всю функциональность фоновых задач, установите переменную окружения `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1`. См. [Environment variables](/ru/env-vars).795Чтобы отключить всю функциональность фоновых задач, установите переменную окружения `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` на `1`. См. [Environment variables](/docs/ru/env-vars).

796 796 

797Когда [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) установлена на `1`, каждый spawn subagent работает в фоне и поле frontmatter `background` не имеет эффекта, потому что режим fork удаляет параметр `run_in_background` из инструмента `Agent`. `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` имеет приоритет над режимом fork и сохраняет spawns subagent в переднем плане.797Когда [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) установлена на `1`, каждый spawn subagent работает в фоне и поле frontmatter `background` не имеет эффекта, потому что режим fork удаляет параметр `run_in_background` из инструмента `Agent`. `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` имеет приоритет над режимом fork и сохраняет spawns subagent в переднем плане.

798 798 


800 Ошибки API в subagents800 Ошибки API в subagents

801</h3>801</h3>

802 802 

803{/* min-version: 2.1.199 */}Начиная с v2.1.199, subagent, чей запуск заканчивается ошибкой API, такой как лимит использования или повторяющаяся ошибка сервера, сообщает об этом отказе Claude вместо возврата текста ошибки, как если бы это были результаты subagent. То, что получает Claude, зависит от того, где работал subagent:803Начиная с v2.1.199, subagent, чей запуск заканчивается ошибкой API, такой как лимит использования или повторяющаяся ошибка сервера, сообщает об этом отказе Claude вместо возврата текста ошибки, как если бы это были результаты subagent. То, что получает Claude, зависит от того, где работал subagent:

804 804 

805* **Foreground**: если лимит скорости, перегрузка или ошибка сервера прерывает subagent, который уже произвёл выходные данные, инструмент Agent возвращает эти частичные выходные данные с примечанием, что subagent был прерван и не завершил свою задачу. {/* min-version: 2.1.200 */}Subagent, который не произвёл ничего, или чьим единственным выходом были вызовы инструментов, завершается с ошибкой [`Agent terminated early due to an API error`](/ru/errors#agent-terminated-early-due-to-an-api-error), за которой следует деталь ошибки. В v2.1.199 лимит скорости, перегрузка или ошибка сервера, которые прервали форму, содержащую только вызовы инструментов, возвращали пустой частичный результат, содержащий только примечание об отключении вместо этого.805* **Foreground**: если лимит скорости, перегрузка или ошибка сервера прерывает subagent, который уже произвёл выходные данные, инструмент Agent возвращает эти частичные выходные данные с примечанием, что subagent был прерван и не завершил свою задачу. Subagent, который не произвёл ничего, или чьим единственным выходом были вызовы инструментов, завершается с ошибкой [`Agent terminated early due to an API error`](/docs/ru/errors#agent-terminated-early-due-to-an-api-error), за которой следует деталь ошибки. В v2.1.199 лимит скорости, перегрузка или ошибка сервера, которые прервали форму, содержащую только вызовы инструментов, возвращали пустой частичный результат, содержащий только примечание об отключении вместо этого.

806* **Background**: subagent помечается как неудачный, и сообщение, которое Claude получает при завершении, называет ошибку API и включает последний выход subagent, поэтому частичная работа не теряется.806* **Background**: subagent помечается как неудачный, и сообщение, которое Claude получает при завершении, называет ошибку API и включает последний выход subagent, поэтому частичная работа не теряется.

807 807 

808После того как основная ошибка API исчезнет, попросите Claude повторить задачу или [возобновить subagent](#resume-subagents).808После того как основная ошибка API исчезнет, попросите Claude повторить задачу или [возобновить subagent](#resume-subagents).


837 Когда subagents завершаются, их результаты возвращаются в основной разговор. Запуск многих subagents, каждый из которых возвращает подробные результаты, может потребить значительный контекст.837 Когда subagents завершаются, их результаты возвращаются в основной разговор. Запуск многих subagents, каждый из которых возвращает подробные результаты, может потребить значительный контекст.

838</Warning>838</Warning>

839 839 

840Для задач, требующих устойчивого параллелизма или превышающих контекстное окно, [agent teams](/ru/agent-teams) дают каждому работнику собственный независимый контекст.840Для задач, требующих устойчивого параллелизма или превышающих контекстное окно, [agent teams](/docs/ru/agent-teams) дают каждому работнику собственный независимый контекст.

841 841 

842<h4 id="chain-subagents">842<h4 id="chain-subagents">

843 Цепочка subagents843 Цепочка subagents


866* Вы хотите применить конкретные ограничения инструментов или разрешений866* Вы хотите применить конкретные ограничения инструментов или разрешений

867* Работа самодостаточна и может вернуть резюме867* Работа самодостаточна и может вернуть резюме

868 868 

869Рассмотрите [Skills](/ru/skills) вместо этого, когда вы хотите переиспользуемые приглашения или рабочие процессы, которые работают в контексте основного разговора, а не в изолированном контексте subagent.869Рассмотрите [Skills](/docs/ru/skills) вместо этого, когда вы хотите переиспользуемые приглашения или рабочие процессы, которые работают в контексте основного разговора, а не в изолированном контексте subagent.

870 870 

871Для быстрого вопроса о чём-то уже в вашем разговоре используйте [`/btw`](/ru/interactive-mode#side-questions-with-%2Fbtw) вместо subagent. Он видит ваш полный контекст, но не имеет доступа к инструментам, и ответ отбрасывается, а не добавляется в историю.871Для быстрого вопроса о чём-то уже в вашем разговоре используйте [`/btw`](/docs/ru/interactive-mode#side-questions-with-%2Fbtw) вместо subagent. Он видит ваш полный контекст, но не имеет доступа к инструментам, и ответ отбрасывается, а не добавляется в историю.

872 872 

873<h3 id="spawn-nested-subagents">873<h3 id="spawn-nested-subagents">

874 Порождайте вложенные subagents874 Порождайте вложенные subagents

875</h3>875</h3>

876 876 

877{/* min-version: 2.1.172 */}Начиная с Claude Code v2.1.172, subagent может порождать собственные subagents. Используйте это, когда делегированная задача сама разбивается на параллельные подзадачи, например subagent-рецензент, который отправляет верификатор для каждого обнаружения, так что промежуточный выход никогда не достигает основного разговора. Только резюме subagent верхнего уровня возвращается вам.877Начиная с Claude Code v2.1.172, subagent может порождать собственные subagents. Используйте это, когда делегированная задача сама разбивается на параллельные подзадачи, например subagent-рецензент, который отправляет верификатор для каждого обнаружения, так что промежуточный выход никогда не достигает основного разговора. Только резюме subagent верхнего уровня возвращается вам.

878 878 

879Вложенный subagent конфигурируется так же, как subagent верхнего уровня и разрешается из тех же [областей видимости](#choose-the-subagent-scope).879Вложенный subagent конфигурируется так же, как subagent верхнего уровня и разрешается из тех же [областей видимости](#choose-the-subagent-scope).

880 880 

881Панель subagent ниже ввода приглашения показывает полное дерево: каждая строка отображает счётчик `(+N)` потомков, и {/* min-version: 2.1.193 */}начиная с v2.1.193, открытие строки показывает прямых потомков этого subagent с путём обратно к `main`.881Панель subagent ниже ввода приглашения показывает полное дерево: каждая строка отображает счётчик `(+N)` потомков, и начиная с v2.1.193, открытие строки показывает прямых потомков этого subagent с путём обратно к `main`.

882 882 

883Глубина считается количеством уровней subagent ниже основного разговора, независимо от того, работает ли каждый уровень в [переднем плане или фоне](#run-subagents-in-foreground-or-background). Subagent на глубине пять не получает инструмент Agent и не может порождать дальше. Лимит фиксирован и не конфигурируется.883Глубина считается количеством уровней subagent ниже основного разговора, независимо от того, работает ли каждый уровень в [переднем плане или фоне](#run-subagents-in-foreground-or-background). Subagent на глубине пять не получает инструмент Agent и не может порождать дальше. Лимит фиксирован и не конфигурируется.

884 884 


902 902 

903* **System prompt**: собственное приглашение агента плюс детали окружения, которые добавляет Claude Code, а не полное системное приглашение Claude Code. Пользовательские subagents определяют свои в [markdown body](#write-subagent-files) или поле `prompt`. Встроенные агенты имеют предопределённые приглашения.903* **System prompt**: собственное приглашение агента плюс детали окружения, которые добавляет Claude Code, а не полное системное приглашение Claude Code. Пользовательские subagents определяют свои в [markdown body](#write-subagent-files) или поле `prompt`. Встроенные агенты имеют предопределённые приглашения.

904* **Task message**: приглашение делегирования, которое Claude пишет при передаче работы.904* **Task message**: приглашение делегирования, которое Claude пишет при передаче работы.

905* **CLAUDE.md and memory**: каждый уровень [иерархии памяти](/ru/memory#how-claude-md-files-load), который загружает основной разговор, включая `~/.claude/CLAUDE.md`, правила проекта, `CLAUDE.local.md` и управляемые файлы политики. Встроенные агенты Explore и Plan пропускают это.905* **CLAUDE.md and memory**: каждый уровень [иерархии памяти](/docs/ru/memory#how-claude-md-files-load), который загружает основной разговор, включая `~/.claude/CLAUDE.md`, правила проекта, `CLAUDE.local.md` и управляемые файлы политики. Встроенные агенты Explore и Plan пропускают это.

906* **Git status**: снимок, сделанный в начале родительской сессии. Отсутствует, когда рабочая директория не является Git репозиторием или когда [`includeGitInstructions`](/ru/settings#available-settings) имеет значение `false`. Explore и Plan пропускают это независимо.906* **Git status**: снимок, сделанный в начале родительской сессии. Отсутствует, когда рабочая директория не является Git репозиторием или когда [`includeGitInstructions`](/docs/ru/settings#available-settings) имеет значение `false`. Explore и Plan пропускают это независимо.

907* **Preloaded skills**: полное содержание любого навыка, названного в поле [`skills`](#preload-skills-into-subagents) агента. Встроенные агенты не предзагружают навыки.907* **Preloaded skills**: полное содержание любого навыка, названного в поле [`skills`](#preload-skills-into-subagents) агента. Встроенные агенты не предзагружают навыки.

908* **Sibling roster**: системное напоминание, в котором перечислены `main` и каждый другой именованный агент в сессии, каждый является допустимым значением `to` для [`SendMessage`](#resume-subagents). {/* min-version: 2.1.206 */}Требует Claude Code v2.1.206 или позже. Реестр появляется только когда инструменты subagent включают `SendMessage` и по крайней мере один другой агент имеет имя, независимо от того, назвал ли его Claude при порождении или он работает как товарищ [agent team](/ru/agent-teams). Это снимок, сделанный при запуске subagent, поэтому агенты, названные позже, не появляются.908* **Sibling roster**: системное напоминание, в котором перечислены `main` и каждый другой именованный агент в сессии, каждый является допустимым значением `to` для [`SendMessage`](#resume-subagents). Требует Claude Code v2.1.206 или позже. Реестр появляется только когда инструменты subagent включают `SendMessage` и по крайней мере один другой агент имеет имя, независимо от того, назвал ли его Claude при порождении или он работает как товарищ [agent team](/docs/ru/agent-teams). Это снимок, сделанный при запуске subagent, поэтому агенты, названные позже, не появляются.

909 909 

910Explore и Plan — единственные subagents, которые опускают CLAUDE.md и git status. Нет поля frontmatter или параметра per-agent для изменения того, какие агенты их пропускают.910Explore и Plan — единственные subagents, которые опускают CLAUDE.md и git status. Нет поля frontmatter или параметра per-agent для изменения того, какие агенты их пропускают.

911 911 


921 921 

922Когда subagent завершается, Claude получает его ID агента. Встроенные агенты Explore и Plan — это одноразовые и не возвращают ID агента, поэтому они не могут быть возобновлены; используйте `general-purpose` или пользовательский subagent, когда вам нужно продолжить работу.922Когда subagent завершается, Claude получает его ID агента. Встроенные агенты Explore и Plan — это одноразовые и не возвращают ID агента, поэтому они не могут быть возобновлены; используйте `general-purpose` или пользовательский subagent, когда вам нужно продолжить работу.

923 923 

924Claude использует инструмент `SendMessage` с ID агента или именем агента в качестве поля `to` для возобновления его. `SendMessage` не требует включения [agent teams](/ru/agent-teams); только структурированные сообщения протокола команды, такие как `shutdown_request` и `plan_approval_response`, это требуют.924Claude использует инструмент `SendMessage` с ID агента или именем агента в качестве поля `to` для возобновления его. `SendMessage` не требует включения [agent teams](/docs/ru/agent-teams); только структурированные сообщения протокола команды, такие как `shutdown_request` и `plan_approval_response`, это требуют.

925 925 

926Чтобы возобновить subagent, попросите Claude продолжить предыдущую работу:926Чтобы возобновить subagent, попросите Claude продолжить предыдущую работу:

927 927 


935 935 

936Завершённый subagent, который получает `SendMessage`, автоматически возобновляется в фоне без новой инвокации `Agent`. То же самое применяется к subagent, который Claude остановил с помощью инструмента `TaskStop`.936Завершённый subagent, который получает `SendMessage`, автоматически возобновляется в фоне без новой инвокации `Agent`. То же самое применяется к subagent, который Claude остановил с помощью инструмента `TaskStop`.

937 937 

938{/* min-version: 2.1.191 */}Начиная с v2.1.191, subagent, который вы остановили сами, с помощью `x` в `/tasks` или запроса SDK `stop_task`, не автоматически возобновляется. Вызов `SendMessage` возвращает отказ, сообщающий Claude, что агент был отменён. Введите в транскрипт этого subagent в панели subagent, чтобы возобновить его самостоятельно, что очищает остановку, чтобы более поздние вызовы `SendMessage` могли автоматически возобновить его снова.938Начиная с v2.1.191, subagent, который вы остановили сами, с помощью `x` в `/tasks` или запроса SDK `stop_task`, не автоматически возобновляется. Вызов `SendMessage` возвращает отказ, сообщающий Claude, что агент был отменён. Введите в транскрипт этого subagent в панели subagent, чтобы возобновить его самостоятельно, что очищает остановку, чтобы более поздние вызовы `SendMessage` могли автоматически возобновить его снова.

939 939 

940Возобновление начинает новый запуск агента под тем же ID, поэтому subagent, который уже завершился или был неудачным, показывается как работающий снова в списке задач и в событиях задач Agent SDK. До v2.1.205 он продолжал показывать свой более ранний статус неудачи или завершения, пока возобновленный запуск работал.940Возобновление начинает новый запуск агента под тем же ID, поэтому subagent, который уже завершился или был неудачным, показывается как работающий снова в списке задач и в событиях задач Agent SDK. До v2.1.205 он продолжал показывать свой более ранний статус неудачи или завершения, пока возобновленный запуск работал.

941 941 

942{/* min-version: 2.1.199 */}Начиная с v2.1.199, `SendMessage` проверяет, что имя по-прежнему ссылается на того же агента, которого оно достигло ранее в разговоре. Если более новый агент взял имя, например повторно порождённый фоновый агент, который его переиспользовал, Claude Code отказывает в отправке, а не доставляет его неправильному агенту, и ошибка сообщает, какого агента имя теперь достигает, чтобы Claude мог перенаправить. Чтобы достичь более раннего агента, пока он всё ещё работает, Claude обращается к нему по ID агента из результата spawn. Проверка ограничена текущим разговором и сбрасывается на `/clear`.942Начиная с v2.1.199, `SendMessage` проверяет, что имя по-прежнему ссылается на того же агента, которого оно достигло ранее в разговоре. Если более новый агент взял имя, например повторно порождённый фоновый агент, который его переиспользовал, Claude Code отказывает в отправке, а не доставляет его неправильному агенту, и ошибка сообщает, какого агента имя теперь достигает, чтобы Claude мог перенаправить. Чтобы достичь более раннего агента, пока он всё ещё работает, Claude обращается к нему по ID агента из результата spawn. Проверка ограничена текущим разговором и сбрасывается на `/clear`.

943 943 

944{/* min-version: 2.1.198 */}Начиная с v2.1.198, subagent рассматривает сообщения от агента, который его запустил, как нормальное направление задачи, включая коррекции курса во время выполнения, и действует в соответствии с ними в рамках своих собственных параметров разрешения. Два лимита по-прежнему действуют независимо от того, кто отправил сообщение: ни одно сообщение от любого агента не считается вашим одобрением для ожидающего запроса разрешения, и ни один агент не может изменить параметры разрешения subagent, `CLAUDE.md` или конфигурацию. Только система разрешений или ваши собственные сообщения могут предоставить одобрение.944Начиная с v2.1.198, subagent рассматривает сообщения от агента, который его запустил, как нормальное направление задачи, включая коррекции курса во время выполнения, и действует в соответствии с ними в рамках своих собственных параметров разрешения. Два лимита по-прежнему действуют независимо от того, кто отправил сообщение: ни одно сообщение от любого агента не считается вашим одобрением для ожидающего запроса разрешения, и ни один агент не может изменить параметры разрешения subagent, `CLAUDE.md` или конфигурацию. Только система разрешений или ваши собственные сообщения могут предоставить одобрение.

945 945 

946Вы также можете попросить Claude ID агента, если хотите ссылаться на него явно, или найти ID в файлах транскрипта в `~/.claude/projects/{project}/{sessionId}/subagents/`. Каждый транскрипт сохраняется как `agent-{agentId}.jsonl`.946Вы также можете попросить Claude ID агента, если хотите ссылаться на него явно, или найти ID в файлах транскрипта в `~/.claude/projects/{project}/{sessionId}/subagents/`. Каждый транскрипт сохраняется как `agent-{agentId}.jsonl`.

947 947 


955 Auto-compaction955 Auto-compaction

956</h4>956</h4>

957 957 

958Subagents поддерживают автоматическое компактирование, используя ту же логику, что и основной разговор. Компактирование срабатывает при тех же условиях, и `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` применяется к subagents также. См. [environment variables](/ru/env-vars) для того, когда переопределение вступает в силу.958Subagents поддерживают автоматическое компактирование, используя ту же логику, что и основной разговор. Компактирование срабатывает при тех же условиях, и `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` применяется к subagents также. См. [environment variables](/docs/ru/env-vars) для того, когда переопределение вступает в силу.

959 959 

960События компактирования регистрируются в файлах транскрипта subagent:960События компактирования регистрируются в файлах транскрипта subagent:

961 961 


977</h2>977</h2>

978 978 

979<Note>979<Note>

980 Разветвленные subagents требуют Claude Code v2.1.117 или позже. {/* min-version: 2.1.161 */}Начиная с v2.1.161 команда `/fork` включена по умолчанию; в более ранних версиях требуется установка переменной окружения [`CLAUDE_CODE_FORK_SUBAGENT`](/ru/env-vars) на `1`. Позволение Claude самому порождать разветвления является экспериментальным и может измениться в будущих выпусках. Эта возможность также может быть включена в интерактивных сессиях как часть поэтапного развертывания.980 Разветвленные subagents требуют Claude Code v2.1.117 или позже. Начиная с v2.1.161 команда `/fork` включена по умолчанию; в более ранних версиях требуется установка переменной окружения [`CLAUDE_CODE_FORK_SUBAGENT`](/docs/ru/env-vars) на `1`. Позволение Claude самому порождать разветвления является экспериментальным и может измениться в будущих выпусках. Эта возможность также может быть включена в интерактивных сессиях как часть поэтапного развертывания.

981</Note>981</Note>

982 982 

983Fork — это subagent, который наследует весь разговор до сих пор вместо начала с нуля. Это отбрасывает входную изоляцию, которую subagents иначе предоставляют: fork видит то же системное приглашение, инструменты, модель и историю сообщений, что и основная сессия, поэтому вы можете передать ему побочную задачу без переобъяснения ситуации. Вызовы инструментов fork по-прежнему остаются вне вашего разговора и только его окончательный результат возвращается, поэтому ваше основное контекстное окно остаётся чистым. Используйте fork, когда именованный subagent потребовал бы слишком много фона, чтобы быть полезным, или когда вы хотите попробовать несколько подходов параллельно с одной и той же отправной точки.983Fork — это subagent, который наследует весь разговор до сих пор вместо начала с нуля. Это отбрасывает входную изоляцию, которую subagents иначе предоставляют: fork видит то же системное приглашение, инструменты, модель и историю сообщений, что и основная сессия, поэтому вы можете передать ему побочную задачу без переобъяснения ситуации. Вызовы инструментов fork по-прежнему остаются вне вашего разговора и только его окончательный результат возвращается, поэтому ваше основное контекстное окно остаётся чистым. Используйте fork, когда именованный subagent потребовал бы слишком много фона, чтобы быть полезным, или когда вы хотите попробовать несколько подходов параллельно с одной и той же отправной точки.

984 984 

985Чтобы управлять режимом fork независимо от поэтапного развертывания, установите [`CLAUDE_CODE_FORK_SUBAGENT`](/ru/env-vars) на `1`, чтобы явно включить его, или на `0`, чтобы отключить его. Переменная учитывается в интерактивном режиме и через SDK или `claude -p`.985Чтобы управлять режимом fork независимо от поэтапного развертывания, установите [`CLAUDE_CODE_FORK_SUBAGENT`](/docs/ru/env-vars) на `1`, чтобы явно включить его, или на `0`, чтобы отключить его. Переменная учитывается в интерактивном режиме и через SDK или `claude -p`.

986 986 

987Включение режима fork изменяет Claude Code двумя способами:987Включение режима fork изменяет Claude Code двумя способами:

988 988 


1010| `x` | Отклоните завершённый fork или остановите работающий |1010| `x` | Отклоните завершённый fork или остановите работающий |

1011| `Esc` | Верните фокус на входное приглашение |1011| `Esc` | Верните фокус на входное приглашение |

1012 1012 

1013С открытым транскриптом fork или subagent, последующие сообщения и [skills](/ru/skills) идут к этому агенту, но встроенные команды по-прежнему работают в вашем основном разговоре. {/* min-version: 2.1.199 */}Начиная с v2.1.199, ввод `/model` или `/fast` в этом представлении показывает уведомление о том, что это изменяет модель основного разговора или режим быстрого выполнения, а не просмотренного агента, вместо того чтобы запускать его молча.1013С открытым транскриптом fork или subagent, последующие сообщения и [skills](/docs/ru/skills) идут к этому агенту, но встроенные команды по-прежнему работают в вашем основном разговоре. Начиная с v2.1.199, ввод `/model` или `/fast` в этом представлении показывает уведомление о том, что это изменяет модель основного разговора или режим быстрого выполнения, а не просмотренного агента, вместо того чтобы запускать его молча.

1014 1014 

1015<h3 id="how-forks-differ-from-named-subagents">1015<h3 id="how-forks-differ-from-named-subagents">

1016 Как forks отличаются от именованных subagents1016 Как forks отличаются от именованных subagents


1026| Permissions | Запросы выводятся в вашем терминале | [Запросы выводятся в вашей основной сессии](#run-subagents-in-foreground-or-background) при запуске в фоне |1026| Permissions | Запросы выводятся в вашем терминале | [Запросы выводятся в вашей основной сессии](#run-subagents-in-foreground-or-background) при запуске в фоне |

1027| Prompt cache | Общий с основной сессией | Отдельный кэш |1027| Prompt cache | Общий с основной сессией | Отдельный кэш |

1028 1028 

1029Поскольку системное приглашение fork и определения инструментов идентичны родителю, его первый запрос повторно использует кэш приглашений родителя [prompt cache](/ru/prompt-caching#subagents-and-the-cache). Это делает forking дешевле, чем порождение свежего subagent для задач, которые нуждаются в том же контексте.1029Поскольку системное приглашение fork и определения инструментов идентичны родителю, его первый запрос повторно использует кэш приглашений родителя [prompt cache](/docs/ru/prompt-caching#subagents-and-the-cache). Это делает forking дешевле, чем порождение свежего subagent для задач, которые нуждаются в том же контексте.

1030 1030 

1031Когда Claude порождает fork через инструмент Agent, он может передать `isolation: "worktree"`, чтобы редактирования файлов fork были написаны в отдельный git worktree вместо вашего checkout.1031Когда Claude порождает fork через инструмент Agent, он может передать `isolation: "worktree"`, чтобы редактирования файлов fork были написаны в отдельный git worktree вместо вашего checkout.

1032 1032 


1034 Ограничения1034 Ограничения

1035</h3>1035</h3>

1036 1036 

1037Установка `CLAUDE_CODE_FORK_SUBAGENT=1` включает режим fork в интерактивных сессиях, [non-interactive mode](/ru/headless) и Agent SDK; установка на `0` отключает режим fork везде, включая любое развертывание на стороне сервера. Fork не может порождать дальнейшие forks.1037Установка `CLAUDE_CODE_FORK_SUBAGENT=1` включает режим fork в интерактивных сессиях, [non-interactive mode](/docs/ru/headless) и Agent SDK; установка на `0` отключает режим fork везде, включая любое развертывание на стороне сервера. Fork не может порождать дальнейшие forks.

1038 1038 

1039<h2 id="example-subagents">1039<h2 id="example-subagents">

1040 Примеры subagents1040 Примеры subagents


1197You cannot modify data. If asked to INSERT, UPDATE, DELETE, or modify schema, explain that you only have read access.1197You cannot modify data. If asked to INSERT, UPDATE, DELETE, or modify schema, explain that you only have read access.

1198```1198```

1199 1199 

1200Claude Code [передаёт входные данные hook как JSON](/ru/hooks#pretooluse-input) через stdin командам hook. Скрипт валидации читает этот JSON, извлекает выполняемую команду и проверяет её против списка операций записи SQL. Если обнаружена операция записи, скрипт [выходит с кодом 2](/ru/hooks#exit-code-2-behavior-per-event) для блокировки выполнения и возвращает сообщение об ошибке Claude через stderr.1200Claude Code [передаёт входные данные hook как JSON](/docs/ru/hooks#pretooluse-input) через stdin командам hook. Скрипт валидации читает этот JSON, извлекает выполняемую команду и проверяет её против списка операций записи SQL. Если обнаружена операция записи, скрипт [выходит с кодом 2](/docs/ru/hooks#exit-code-2-behavior-per-event) для блокировки выполнения и возвращает сообщение об ошибке Claude через stderr.

1201 1201 

1202Создайте скрипт валидации где-нибудь в вашем проекте. Путь должен соответствовать полю `command` в конфигурации hook:1202Создайте скрипт валидации где-нибудь в вашем проекте. Путь должен соответствовать полю `command` в конфигурации hook:

1203 1203 


1230chmod +x ./scripts/validate-readonly-query.sh1230chmod +x ./scripts/validate-readonly-query.sh

1231```1231```

1232 1232 

1233На Windows напишите скрипт валидации на PowerShell и добавьте `shell: powershell` к записи hook. См. [запуск hooks в PowerShell](/ru/hooks#windows-powershell-tool).1233На Windows напишите скрипт валидации на PowerShell и добавьте `shell: powershell` к записи hook. См. [запуск hooks в PowerShell](/docs/ru/hooks#windows-powershell-tool).

1234 1234 

1235Hook получает JSON через stdin с командой Bash в `tool_input.command`. Код выхода 2 блокирует операцию и передаёт сообщение об ошибке обратно Claude. См. [Hooks](/ru/hooks#exit-code-output) для деталей кодов выхода и [Hook input](/ru/hooks#pretooluse-input) для полной схемы входных данных.1235Hook получает JSON через stdin с командой Bash в `tool_input.command`. Код выхода 2 блокирует операцию и передаёт сообщение об ошибке обратно Claude. См. [Hooks](/docs/ru/hooks#exit-code-output) для деталей кодов выхода и [Hook input](/docs/ru/hooks#pretooluse-input) для полной схемы входных данных.

1236 1236 

1237<h2 id="next-steps">1237<h2 id="next-steps">

1238 Следующие шаги1238 Следующие шаги


1240 1240 

1241Теперь, когда вы понимаете subagents, изучите эти связанные функции:1241Теперь, когда вы понимаете subagents, изучите эти связанные функции:

1242 1242 

1243* [Распространяйте subagents с помощью plugins](/ru/plugins) для совместного использования subagents в командах или проектах1243* [Распространяйте subagents с помощью plugins](/docs/ru/plugins) для совместного использования subagents в командах или проектах

1244* [Запустите Claude Code программно](/ru/headless) с помощью Agent SDK для CI/CD и автоматизации1244* [Запустите Claude Code программно](/docs/ru/headless) с помощью Agent SDK для CI/CD и автоматизации

1245* [Используйте MCP servers](/ru/mcp) для предоставления subagents доступа к внешним инструментам и данным1245* [Используйте MCP servers](/docs/ru/mcp) для предоставления subagents доступа к внешним инструментам и данным

tools-reference.md +77 −77

Details

6 6 

7> Полный справочник инструментов, которые может использовать Claude Code, включая требования к разрешениям и поведение для каждого инструмента.7> Полный справочник инструментов, которые может использовать Claude Code, включая требования к разрешениям и поведение для каждого инструмента.

8 8 

9Claude Code имеет доступ к набору встроенных инструментов, которые помогают ему понять и изменить вашу кодовую базу. Названия инструментов — это точные строки, которые вы используете в [правилах разрешений](/ru/permissions#tool-specific-permission-rules), [списках инструментов subagent](/ru/sub-agents) и [сопоставителях hooks](/ru/hooks). Чтобы полностью отключить инструмент, добавьте его имя в массив `deny` в [параметрах разрешений](/ru/permissions#tool-specific-permission-rules).9Claude Code имеет доступ к набору встроенных инструментов, которые помогают ему понять и изменить вашу кодовую базу. Названия инструментов — это точные строки, которые вы используете в [правилах разрешений](/docs/ru/permissions#tool-specific-permission-rules), [списках инструментов subagent](/docs/ru/sub-agents) и [сопоставителях hooks](/docs/ru/hooks). Чтобы полностью отключить инструмент, добавьте его имя в массив `deny` в [параметрах разрешений](/docs/ru/permissions#tool-specific-permission-rules).

10 10 

11Чтобы добавить пользовательские инструменты, подключите [MCP server](/ru/mcp). Чтобы расширить Claude с помощью переиспользуемых рабочих процессов на основе подсказок, напишите [skill](/ru/skills), который работает через существующий инструмент `Skill` вместо добавления новой записи инструмента.11Чтобы добавить пользовательские инструменты, подключите [MCP server](/docs/ru/mcp). Чтобы расширить Claude с помощью переиспользуемых рабочих процессов на основе подсказок, напишите [skill](/docs/ru/skills), который работает через существующий инструмент `Skill` вместо добавления новой записи инструмента.

12 12 

13Столбец "Требуется разрешение" показывает, запрашивает ли инструмент разрешение в режиме разрешений по умолчанию для путей внутри рабочего каталога. Инструменты доступа к файлам, отмеченные "Нет", включая `Read`, `Grep` и `Glob`, по-прежнему запрашивают разрешение для путей вне [рабочего каталога и дополнительных каталогов](/ru/permissions#working-directories). `Bash` отмечен как "Да", но выполняет встроенный набор [команд только для чтения](/ru/permissions#read-only-commands) без запроса разрешения.13Столбец "Требуется разрешение" показывает, запрашивает ли инструмент разрешение в режиме разрешений по умолчанию для путей внутри рабочего каталога. Инструменты доступа к файлам, отмеченные "Нет", включая `Read`, `Grep` и `Glob`, по-прежнему запрашивают разрешение для путей вне [рабочего каталога и дополнительных каталогов](/docs/ru/permissions#working-directories). `Bash` отмечен как "Да", но выполняет встроенный набор [команд только для чтения](/docs/ru/permissions#read-only-commands) без запроса разрешения.

14 14 

15| Инструмент | Описание | Требуется разрешение |15| Инструмент | Описание | Требуется разрешение |

16| :--------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |16| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------- |

17| `Agent` | Создает [subagent](/ru/sub-agents) с собственным контекстным окном для выполнения задачи. См. [поведение инструмента Agent](#agent-tool-behavior) | Нет |17| `Agent` | Создает [subagent](/docs/ru/sub-agents) с собственным контекстным окном для выполнения задачи. См. [поведение инструмента Agent](#agent-tool-behavior) | Нет |

18| `Artifact` | Публикует HTML или Markdown файл как [artifact](/ru/artifacts): приватную интерактивную страницу на claude.ai. Вы можете делиться ею с помощью публичной ссылки или внутри вашей организации на планах Team и Enterprise, где публичный доступ требует, чтобы владелец [включил его](/ru/artifacts#control-public-sharing). {/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Требует план Pro, Max, Team или Enterprise и аутентификацию `/login`; см. [Доступность](/ru/artifacts#availability) | Да |18| `Artifact` | Публикует HTML или Markdown файл как [artifact](/docs/ru/artifacts): приватную интерактивную страницу на claude.ai. Вы можете делиться ею с помощью публичной ссылки или внутри вашей организации на планах Team и Enterprise, где публичный доступ требует, чтобы владелец [включил его](/docs/ru/artifacts#control-public-sharing). Требует план Pro, Max, Team или Enterprise и аутентификацию `/login`; см. [Доступность](/docs/ru/artifacts#availability) | Да |

19| `AskUserQuestion` | Задает вопросы с несколькими вариантами ответов для сбора требований или уточнения неоднозначности. {/* min-version: 2.1.200 */}Вопросы остаются открытыми до тех пор, пока вы на них не ответите: по умолчанию нет тайм-аута неактивности. Чтобы диалог с неактивностью продолжался автоматически, установите параметр [`askUserQuestionTimeout`](/ru/settings#available-settings) на `60s`, `5m` или `10m` либо в вашем пользовательском `settings.json`, либо из строки **Question auto-continue timeout** в `/config`. После истечения выбранного времени неактивности без ввода диалог закроется самостоятельно: он отправит все уже выбранные вами параметры и сообщит Claude, что вы можете быть вдали от клавиатуры, поэтому Claude действует по собственному суждению и может переспросить позже. Обратный отсчет появляется в течение последних 20 секунд. Любое нажатие клавиши перезапускает таймер, как и сфокусированное окно на терминалах, которые сообщают о фокусе. Тайм-аут применяется только к вопросам с несколькими вариантами ответов `AskUserQuestion`; подсказки разрешений, включая одобрение плана, никогда не разрешаются автоматически при неактивности. В версиях 2.1.198 и 2.1.199 диалог автоматически продолжался после 60 секунд неактивности по умолчанию, и [`CLAUDE_AFK_TIMEOUT_MS`](/ru/env-vars#variables) был единственным способом изменить это | Нет |19| `AskUserQuestion` | Задает вопросы с несколькими вариантами ответов для сбора требований или уточнения неоднозначности. Вопросы остаются открытыми до тех пор, пока вы на них не ответите: по умолчанию нет тайм-аута неактивности. Чтобы диалог с неактивностью продолжался автоматически, установите параметр [`askUserQuestionTimeout`](/docs/ru/settings#available-settings) на `60s`, `5m` или `10m` либо в вашем пользовательском `settings.json`, либо из строки **Question auto-continue timeout** в `/config`. После истечения выбранного времени неактивности без ввода диалог закроется самостоятельно: он отправит все уже выбранные вами параметры и сообщит Claude, что вы можете быть вдали от клавиатуры, поэтому Claude действует по собственному суждению и может переспросить позже. Обратный отсчет появляется в течение последних 20 секунд. Любое нажатие клавиши перезапускает таймер, как и сфокусированное окно на терминалах, которые сообщают о фокусе. Тайм-аут применяется только к вопросам с несколькими вариантами ответов `AskUserQuestion`; подсказки разрешений, включая одобрение плана, никогда не разрешаются автоматически при неактивности. В версиях 2.1.198 и 2.1.199 диалог автоматически продолжался после 60 секунд неактивности по умолчанию, и [`CLAUDE_AFK_TIMEOUT_MS`](/docs/ru/env-vars#variables) был единственным способом изменить это | Нет |

20| `Bash` | Выполняет команды оболочки в вашей среде. См. [поведение инструмента Bash](#bash-tool-behavior) | Да |20| `Bash` | Выполняет команды оболочки в вашей среде. См. [поведение инструмента Bash](#bash-tool-behavior) | Да |

21| `CronCreate` | Планирует повторяющуюся или одноразовую подсказку в текущем сеансе. Задачи привязаны к сеансу и восстанавливаются при `--resume` или `--continue`, если не истекли. См. [запланированные задачи](/ru/scheduled-tasks) | Нет |21| `CronCreate` | Планирует повторяющуюся или одноразовую подсказку в текущем сеансе. Задачи привязаны к сеансу и восстанавливаются при `--resume` или `--continue`, если не истекли. См. [запланированные задачи](/docs/ru/scheduled-tasks) | Нет |

22| `CronDelete` | Отменяет запланированную задачу по ID | Нет |22| `CronDelete` | Отменяет запланированную задачу по ID | Нет |

23| `CronList` | Выводит список всех запланированных задач в сеансе | Нет |23| `CronList` | Выводит список всех запланированных задач в сеансе | Нет |

24| `Edit` | Вносит целевые изменения в конкретные файлы. См. [поведение инструмента Edit](#edit-tool-behavior) | Да |24| `Edit` | Вносит целевые изменения в конкретные файлы. См. [поведение инструмента Edit](#edit-tool-behavior) | Да |

25| `EnterPlanMode` | Переключается в режим плана для разработки подхода перед кодированием | Нет |25| `EnterPlanMode` | Переключается в режим плана для разработки подхода перед кодированием | Нет |

26| `EnterWorktree` | Создает изолированный [git worktree](/ru/worktrees) и переключается в него. Передайте `path` для переключения в существующий worktree вместо создания нового. {/* min-version: 2.1.203 */}При первом входе целевой путь может быть worktree текущего репозитория или, в многорепозиторном рабочем пространстве, репозитория, вложенного в него. До версии 2.1.203 worktree вложенного репозитория был отклонен. {/* min-version: 2.1.206 */}Путь `path` вне `.claude/worktrees/` запрашивает ваше одобрение перед входом, так как он перемещает рабочий каталог сеанса и доступ на запись в это место. Создание новых worktrees и пути под `.claude/worktrees/` не запрашивают разрешение. До версии 2.1.206 Claude входил в пути вне `.claude/worktrees/` без запроса. Из сеанса worktree или из subagent с закрепленным рабочим каталогом, например [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields), доступна только форма `path`, и целевой путь должен находиться под `.claude/worktrees/` репозитория сеанса | Да |26| `EnterWorktree` | Создает изолированный [git worktree](/docs/ru/worktrees) и переключается в него. Передайте `path` для переключения в существующий worktree вместо создания нового. При первом входе целевой путь может быть worktree текущего репозитория или, в многорепозиторном рабочем пространстве, репозитория, вложенного в него. До версии 2.1.203 worktree вложенного репозитория был отклонен. Путь `path` вне `.claude/worktrees/` запрашивает ваше одобрение перед входом, так как он перемещает рабочий каталог сеанса и доступ на запись в это место. Создание новых worktrees и пути под `.claude/worktrees/` не запрашивают разрешение. До версии 2.1.206 Claude входил в пути вне `.claude/worktrees/` без запроса. Из сеанса worktree или из subagent с закрепленным рабочим каталогом, например [`isolation: worktree`](/docs/ru/sub-agents#supported-frontmatter-fields), доступна только форма `path`, и целевой путь должен находиться под `.claude/worktrees/` репозитория сеанса | Да |

27| `ExitPlanMode` | Представляет план для утверждения и выходит из режима плана | Да |27| `ExitPlanMode` | Представляет план для утверждения и выходит из режима плана | Да |

28| `ExitWorktree` | Выходит из сеанса worktree и возвращается в исходный каталог. Недоступно для subagents, которые уже работают в собственном рабочем каталоге, например с [`isolation: worktree`](/ru/sub-agents#supported-frontmatter-fields) | Нет |28| `ExitWorktree` | Выходит из сеанса worktree и возвращается в исходный каталог. Недоступно для subagents, которые уже работают в собственном рабочем каталоге, например с [`isolation: worktree`](/docs/ru/sub-agents#supported-frontmatter-fields) | Нет |

29| `Glob` | Находит файлы на основе сопоставления шаблонов. См. [поведение инструмента Glob](#glob-tool-behavior) | Нет |29| `Glob` | Находит файлы на основе сопоставления шаблонов. См. [поведение инструмента Glob](#glob-tool-behavior) | Нет |

30| `Grep` | Ищет шаблоны в содержимом файлов. См. [поведение инструмента Grep](#grep-tool-behavior) | Нет |30| `Grep` | Ищет шаблоны в содержимом файлов. См. [поведение инструмента Grep](#grep-tool-behavior) | Нет |

31| `ListMcpResourcesTool` | Выводит список ресурсов, предоставляемых подключенными [MCP servers](/ru/mcp) | Нет |31| `ListMcpResourcesTool` | Выводит список ресурсов, предоставляемых подключенными [MCP servers](/docs/ru/mcp) | Нет |

32| `LSP` | Интеллект кода через языковые серверы: переход к определениям, поиск ссылок, сообщение об ошибках типов и предупреждениях. См. [поведение инструмента LSP](#lsp-tool-behavior) | Нет |32| `LSP` | Интеллект кода через языковые серверы: переход к определениям, поиск ссылок, сообщение об ошибках типов и предупреждениях. См. [поведение инструмента LSP](#lsp-tool-behavior) | Нет |

33| `Monitor` | Запускает команду в фоне и передает каждую строку вывода обратно Claude, чтобы он мог реагировать на записи журнала, изменения файлов или опрашиваемый статус в середине разговора. Может также открыть WebSocket и рассматривать каждое входящее сообщение как событие. См. [инструмент Monitor](#monitor-tool) | Да |33| `Monitor` | Запускает команду в фоне и передает каждую строку вывода обратно Claude, чтобы он мог реагировать на записи журнала, изменения файлов или опрашиваемый статус в середине разговора. Может также открыть WebSocket и рассматривать каждое входящее сообщение как событие. См. [инструмент Monitor](#monitor-tool) | Да |

34| `NotebookEdit` | Изменяет ячейки Jupyter notebook. См. [поведение инструмента NotebookEdit](#notebookedit-tool-behavior) | Да |34| `NotebookEdit` | Изменяет ячейки Jupyter notebook. См. [поведение инструмента NotebookEdit](#notebookedit-tool-behavior) | Да |

35| `PowerShell` | Выполняет команды PowerShell изначально. См. [инструмент PowerShell](#powershell-tool) для доступности | Да |35| `PowerShell` | Выполняет команды PowerShell изначально. См. [инструмент PowerShell](#powershell-tool) для доступности | Да |

36| `PushNotification` | Отправляет уведомление на рабочий стол и push-уведомление на телефон при подключении [Remote Control](/ru/remote-control), чтобы долгоживущая задача или [запланированная задача](/ru/scheduled-tasks) могла вас достичь, когда вы отойдете. {/* plan-availability: feature=push-notifications providers=anthropic */}Доставка push-уведомлений осуществляется через инфраструктуру, размещенную на Anthropic, которая недоступна из Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |36| `PushNotification` | Отправляет уведомление на рабочий стол и push-уведомление на телефон при подключении [Remote Control](/docs/ru/remote-control), чтобы долгоживущая задача или [запланированная задача](/docs/ru/scheduled-tasks) могла вас достичь, когда вы отойдете. Доставка push-уведомлений осуществляется через инфраструктуру, размещенную на Anthropic, которая недоступна из Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |

37| `Read` | Читает содержимое файлов. См. [поведение инструмента Read](#read-tool-behavior) | Нет |37| `Read` | Читает содержимое файлов. См. [поведение инструмента Read](#read-tool-behavior) | Нет |

38| `ReadMcpResourceTool` | Читает конкретный ресурс MCP по URI | Нет |38| `ReadMcpResourceTool` | Читает конкретный ресурс MCP по URI | Нет |

39| `RemoteTrigger` | Создает, обновляет, запускает и выводит список [Routines](/ru/routines) на claude.ai. Поддерживает команду `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines находятся на claude.ai и требуют план Pro, Max, Team или Enterprise, поэтому этот инструмент недоступен из Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |39| `RemoteTrigger` | Создает, обновляет, запускает и выводит список [Routines](/docs/ru/routines) на claude.ai. Поддерживает команду `/schedule`. Routines находятся на claude.ai и требуют план Pro, Max, Team или Enterprise, поэтому этот инструмент недоступен из Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |

40| `ReportFindings` | Сообщает о результатах проверки кода как структурированный список с файлом, резюме и сценарием сбоя для каждого результата, чтобы Claude Code мог их отобразить вместо вывода в виде текста. Claude вызывает его, когда активные инструкции проверки кода говорят ему это сделать. {/* min-version: 2.1.196 */}Требует Claude Code v2.1.196 или позже. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, результат также может содержать необязательный слаг `category`, такой как `correctness` или `test-coverage`, показанный рядом с расположением файла в отображаемом списке | Нет |40| `ReportFindings` | Сообщает о результатах проверки кода как структурированный список с файлом, резюме и сценарием сбоя для каждого результата, чтобы Claude Code мог их отобразить вместо вывода в виде текста. Claude вызывает его, когда активные инструкции проверки кода говорят ему это сделать. Требует Claude Code v2.1.196 или позже. Начиная с версии 2.1.199, результат также может содержать необязательный слаг `category`, такой как `correctness` или `test-coverage`, показанный рядом с расположением файла в отображаемом списке | Нет |

41| `ScheduleWakeup` | Переносит следующую итерацию [самостоятельного `/loop`](/ru/scheduled-tasks#let-claude-choose-the-interval). Claude вызывает это в конце каждой итерации, чтобы выбрать, когда запустится следующая, между одной минутой и одним часом; вы не вызываете это напрямую. Чтобы вместо этого завершить цикл, Claude вызывает его с `stop: true`, что отменяет ожидающее пробуждение. {/* min-version: 2.1.202 */}Поле `stop` требует Claude Code v2.1.202 или позже. Ожидающее пробуждение появляется в `session_crons` в [входе Stop hook](/ru/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Недоступно на Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry, где `/loop` подсказка без интервала работает по фиксированному расписанию | Нет |41| `ScheduleWakeup` | Переносит следующую итерацию [самостоятельного `/loop`](/docs/ru/scheduled-tasks#let-claude-choose-the-interval). Claude вызывает это в конце каждой итерации, чтобы выбрать, когда запустится следующая, между одной минутой и одним часом; вы не вызываете это напрямую. Чтобы вместо этого завершить цикл, Claude вызывает его с `stop: true`, что отменяет ожидающее пробуждение. Поле `stop` требует Claude Code v2.1.202 или позже. Ожидающее пробуждение появляется в `session_crons` в [входе Stop hook](/docs/ru/hooks#stop-input). Недоступно на Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry, где `/loop` подсказка без интервала работает по фиксированному расписанию | Нет |

42| `SendMessage` | Отправляет сообщение члену [команды агентов](/ru/agent-teams), или [возобновляет subagent](/ru/sub-agents#resume-subagents) по его ID агента или имени. Завершенные subagents автоматически возобновляются в фоне; subagent, который вы остановили из `/tasks`, не возобновляется, и вызов возвращает отказ. Структурированные сообщения протокола команды требуют команды агентов. Получатель никогда не рассматривает сообщение от другого агента как ваше согласие или одобрение. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, subagent рассматривает сообщение от агента, который его запустил, как обычное направление задачи, а не как запрос от коллеги. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, отправка на имя, которое теперь разрешается в другого агента, чем раньше в разговоре, отклоняется вместо доставки; см. [Возобновление subagents](/ru/sub-agents#resume-subagents) | Нет |42| `SendMessage` | Отправляет сообщение члену [команды агентов](/docs/ru/agent-teams), или [возобновляет subagent](/docs/ru/sub-agents#resume-subagents) по его ID агента или имени. Завершенные subagents автоматически возобновляются в фоне; subagent, который вы остановили из `/tasks`, не возобновляется, и вызов возвращает отказ. Структурированные сообщения протокола команды требуют команды агентов. Получатель никогда не рассматривает сообщение от другого агента как ваше согласие или одобрение. Начиная с версии 2.1.198, subagent рассматривает сообщение от агента, который его запустил, как обычное направление задачи, а не как запрос от коллеги. Начиная с версии 2.1.199, отправка на имя, которое теперь разрешается в другого агента, чем раньше в разговоре, отклоняется вместо доставки; см. [Возобновление subagents](/docs/ru/sub-agents#resume-subagents) | Нет |

43| `SendUserFile` | Отправляет файлы из сеанса вам с необязательной подписью, чтобы созданный отчет, диаграмма, снимок экрана или построенный артефакт достигли вашего устройства вместо того, чтобы только упоминаться в стенограмме. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, необязательный ввод `display` управляет представлением: `render` открывает файл встроенным образом в клиенте, `attach` показывает только карточку загрузки, и когда не установлено, клиент решает по типу файла. Доступно при подключении клиента [Remote Control](/ru/remote-control) или когда сеанс работает в управляемой облачной среде, такой как [Claude Code в веб-версии](/ru/claude-code-on-the-web). Доставка осуществляется через инфраструктуру, размещенную на Anthropic, поэтому инструмент недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |43| `SendUserFile` | Отправляет файлы из сеанса вам с необязательной подписью, чтобы созданный отчет, диаграмма, снимок экрана или построенный артефакт достигли вашего устройства вместо того, чтобы только упоминаться в стенограмме. Начиная с версии 2.1.196, необязательный ввод `display` управляет представлением: `render` открывает файл встроенным образом в клиенте, `attach` показывает только карточку загрузки, и когда не установлено, клиент решает по типу файла. Доступно при подключении клиента [Remote Control](/docs/ru/remote-control) или когда сеанс работает в управляемой облачной среде, такой как [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web). Доставка осуществляется через инфраструктуру, размещенную на Anthropic, поэтому инструмент недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry | Нет |

44| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Загружает `ONBOARDING.md` и возвращает ссылку для общего доступа, которую товарищи по команде могут открыть в Claude Code. Вызывается из `/team-onboarding` после написания руководства. Доступно для подписчиков claude.ai на планах Pro, Max, Team и Enterprise | Да |44| `ShareOnboardingGuide` | Загружает `ONBOARDING.md` и возвращает ссылку для общего доступа, которую товарищи по команде могут открыть в Claude Code. Вызывается из `/team-onboarding` после написания руководства. Доступно для подписчиков claude.ai на планах Pro, Max, Team и Enterprise | Да |

45| `Skill` | Выполняет [skill](/ru/skills#control-who-invokes-a-skill) в основном разговоре | Да |45| `Skill` | Выполняет [skill](/docs/ru/skills#control-who-invokes-a-skill) в основном разговоре | Да |

46| `TaskCreate` | Создает новую задачу в списке задач | Нет |46| `TaskCreate` | Создает новую задачу в списке задач | Нет |

47| `TaskGet` | Получает полные сведения для конкретной задачи | Нет |47| `TaskGet` | Получает полные сведения для конкретной задачи | Нет |

48| `TaskList` | Выводит список всех задач с их текущим статусом | Нет |48| `TaskList` | Выводит список всех задач с их текущим статусом | Нет |

49| `TaskOutput` | Получает вывод из фоновой задачи. Устарело в пользу `Read` на пути к файлу вывода задачи. {/* min-version: 2.1.203 */}Когда ни одна задача не соответствует ID, ошибка выводит список выполняющихся фоновых агентов по ID и описанию. До версии 2.1.203 ошибка называла только отсутствующий ID | Нет |49| `TaskOutput` | Получает вывод из фоновой задачи. Устарело в пользу `Read` на пути к файлу вывода задачи. Когда ни одна задача не соответствует ID, ошибка выводит список выполняющихся фоновых агентов по ID и описанию. До версии 2.1.203 ошибка называла только отсутствующий ID | Нет |

50| `TaskStop` | Останавливает выполняющуюся фоновую задачу по ID. {/* min-version: 2.1.198 */}Также принимает [товарища по команде агентов](/ru/agent-teams) или именованного фонового агента по ID агента или имени. До версии 2.1.198 принимал только ID фоновой задачи. {/* min-version: 2.1.203 */}Когда ни одна задача не соответствует ID, ошибка выводит список выполняющихся фоновых агентов по ID и описанию, включая агентов, которых запустил другой агент. До версии 2.1.203 ошибка выводила список выполняющихся товарищей по команде и именованных агентов, но не фоновых агентов, которых запустил другой агент, поэтому их нельзя было идентифицировать или остановить из основного разговора | Нет |50| `TaskStop` | Останавливает выполняющуюся фоновую задачу по ID. Также принимает [товарища по команде агентов](/docs/ru/agent-teams) или именованного фонового агента по ID агента или имени. До версии 2.1.198 принимал только ID фоновой задачи. Когда ни одна задача не соответствует ID, ошибка выводит список выполняющихся фоновых агентов по ID и описанию, включая агентов, которых запустил другой агент. До версии 2.1.203 ошибка выводила список выполняющихся товарищей по команде и именованных агентов, но не фоновых агентов, которых запустил другой агент, поэтому их нельзя было идентифицировать или остановить из основного разговора | Нет |

51| `TaskUpdate` | Обновляет статус задачи, зависимости, сведения или удаляет задачи | Нет |51| `TaskUpdate` | Обновляет статус задачи, зависимости, сведения или удаляет задачи | Нет |

52| `TodoWrite` | {/* min-version: 2.1.142 */}Управляет контрольным списком задач сеанса. Отключено по умолчанию начиная с версии 2.1.142 в пользу `TaskCreate`, `TaskGet`, `TaskList` и `TaskUpdate`. Установите `CLAUDE_CODE_ENABLE_TASKS=0` для повторного включения | Нет |52| `TodoWrite` | Управляет контрольным списком задач сеанса. Отключено по умолчанию начиная с версии 2.1.142 в пользу `TaskCreate`, `TaskGet`, `TaskList` и `TaskUpdate`. Установите `CLAUDE_CODE_ENABLE_TASKS=0` для повторного включения | Нет |

53| `ToolSearch` | Ищет и загружает отложенные инструменты, когда включен [поиск инструментов](/ru/mcp#scale-with-mcp-tool-search) | Нет |53| `ToolSearch` | Ищет и загружает отложенные инструменты, когда включен [поиск инструментов](/docs/ru/mcp#scale-with-mcp-tool-search) | Нет |

54| `WaitForMcpServers` | Ожидает один или несколько [MCP servers](/ru/mcp), которые все еще подключаются в фоне, чтобы запрос мог использовать их инструменты без перезагрузки сеанса. Claude вызывает его, когда требуемый сервер еще не подключен. Появляется только когда [поиск инструментов](/ru/mcp#scale-with-mcp-tool-search) отключен, так как `ToolSearch` обрабатывает ожидание, когда он включен | Нет |54| `WaitForMcpServers` | Ожидает один или несколько [MCP servers](/docs/ru/mcp), которые все еще подключаются в фоне, чтобы запрос мог использовать их инструменты без перезагрузки сеанса. Claude вызывает его, когда требуемый сервер еще не подключен. Появляется только когда [поиск инструментов](/docs/ru/mcp#scale-with-mcp-tool-search) отключен, так как `ToolSearch` обрабатывает ожидание, когда он включен | Нет |

55| `WebFetch` | Получает содержимое с указанного URL. См. [поведение инструмента WebFetch](#webfetch-tool-behavior) | Да |55| `WebFetch` | Получает содержимое с указанного URL. См. [поведение инструмента WebFetch](#webfetch-tool-behavior) | Да |

56| `WebSearch` | Выполняет веб-поиск. См. [поведение инструмента WebSearch](#websearch-tool-behavior) | Да |56| `WebSearch` | Выполняет веб-поиск. См. [поведение инструмента WebSearch](#websearch-tool-behavior) | Да |

57| `Workflow` | Запускает [динамический рабочий процесс](/ru/workflows): скрипт, который организует множество subagents в фоне и возвращает один консолидированный результат | Да |57| `Workflow` | Запускает [динамический рабочий процесс](/docs/ru/workflows): скрипт, который организует множество subagents в фоне и возвращает один консолидированный результат | Да |

58| `Write` | Создает или перезаписывает файлы. См. [поведение инструмента Write](#write-tool-behavior) | Да |58| `Write` | Создает или перезаписывает файлы. См. [поведение инструмента Write](#write-tool-behavior) | Да |

59 59 

60<h2 id="configure-tools-with-permission-rules-and-hooks">60<h2 id="configure-tools-with-permission-rules-and-hooks">


63 63 

64В большинстве случаев Claude решает, когда использовать эти инструменты, и вам не нужно называть их самостоятельно при взаимодействии с Claude. Вы ссылаетесь на названия инструментов напрямую при определении разрешений и другой конфигурации:64В большинстве случаев Claude решает, когда использовать эти инструменты, и вам не нужно называть их самостоятельно при взаимодействии с Claude. Вы ссылаетесь на названия инструментов напрямую при определении разрешений и другой конфигурации:

65 65 

66* в [`permissions.allow` и `permissions.deny`](/ru/settings#available-settings) в параметрах и интерфейсе `/permissions`66* в [`permissions.allow` и `permissions.deny`](/docs/ru/settings#available-settings) в параметрах и интерфейсе `/permissions`

67* в флагах CLI [`--allowedTools` и `--disallowedTools`](/ru/cli-reference)67* в флагах CLI [`--allowedTools` и `--disallowedTools`](/docs/ru/cli-reference)

68* в опциях [`allowedTools` и `disallowedTools`](/ru/agent-sdk/permissions#allow-and-deny-rules) Agent SDK68* в опциях [`allowedTools` и `disallowedTools`](/docs/ru/agent-sdk/permissions#allow-and-deny-rules) Agent SDK

69* в [frontmatter `tools` или `disallowedTools`](/ru/sub-agents#supported-frontmatter-fields) subagent69* в [frontmatter `tools` или `disallowedTools`](/docs/ru/sub-agents#supported-frontmatter-fields) subagent

70* в [frontmatter `allowed-tools`](/ru/skills#frontmatter-reference) skill70* в [frontmatter `allowed-tools`](/docs/ru/skills#frontmatter-reference) skill

71* в [условии `if`](/ru/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field) hook71* в [условии `if`](/docs/ru/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field) hook

72 72 

73Все они принимают один и тот же формат правила, `ToolName(specifier)`. Спецификатор зависит от инструмента, и несколько инструментов используют один формат:73Все они принимают один и тот же формат правила, `ToolName(specifier)`. Спецификатор зависит от инструмента, и несколько инструментов используют один формат:

74 74 

75| Формат правила | Применяется к | Детали |75| Формат правила | Применяется к | Детали |

76| :----------------------------- | :------------------------ | :----------------------------------------------------------------------------- |76| :----------------------------- | :------------------------ | :----------------------------------------------------------------------------- |

77| `Bash(npm run *)` | Bash, Monitor | [Сопоставление шаблонов команд](/ru/permissions#bash) |77| `Bash(npm run *)` | Bash, Monitor | [Сопоставление шаблонов команд](/docs/ru/permissions#bash) |

78| `PowerShell(Get-ChildItem *)` | PowerShell | [Сопоставление шаблонов команд](/ru/permissions#powershell) |78| `PowerShell(Get-ChildItem *)` | PowerShell | [Сопоставление шаблонов команд](/docs/ru/permissions#powershell) |

79| `Read(~/secrets/**)` | Read, Grep, Glob, LSP | [Сопоставление шаблонов путей](/ru/permissions#read-and-edit) |79| `Read(~/secrets/**)` | Read, Grep, Glob, LSP | [Сопоставление шаблонов путей](/docs/ru/permissions#read-and-edit) |

80| `Edit(/src/**)` | Edit, Write, NotebookEdit | [Сопоставление шаблонов путей](/ru/permissions#read-and-edit) |80| `Edit(/src/**)` | Edit, Write, NotebookEdit | [Сопоставление шаблонов путей](/docs/ru/permissions#read-and-edit) |

81| `Skill(deploy *)` | Skill | [Сопоставление имени skill](/ru/skills#restrict-claude%E2%80%99s-skill-access) |81| `Skill(deploy *)` | Skill | [Сопоставление имени skill](/docs/ru/skills#restrict-claude%E2%80%99s-skill-access) |

82| `Agent(Explore)` | Agent | [Сопоставление типа subagent](/ru/permissions#agent-subagents) |82| `Agent(Explore)` | Agent | [Сопоставление типа subagent](/docs/ru/permissions#agent-subagents) |

83| `WebFetch(domain:example.com)` | WebFetch | [Сопоставление домена](/ru/permissions#webfetch) |83| `WebFetch(domain:example.com)` | WebFetch | [Сопоставление домена](/docs/ru/permissions#webfetch) |

84| `WebSearch` | WebSearch | Без спецификатора; разрешить или запретить инструмент в целом |84| `WebSearch` | WebSearch | Без спецификатора; разрешить или запретить инструмент в целом |

85 85 

86Инструменты, не указанные здесь, такие как `ExitPlanMode` или `ShareOnboardingGuide`, принимают только простое имя инструмента без спецификатора.86Инструменты, не указанные здесь, такие как `ExitPlanMode` или `ShareOnboardingGuide`, принимают только простое имя инструмента без спецификатора.

87 87 

88Правило разрешения `Edit(...)` также предоставляет доступ на чтение к тому же пути, поэтому вам не нужно соответствующее правило `Read(...)`. Правило запрета `Read(...)` также блокирует инструмент Edit на том же пути, включая создание нового файла там, потому что редактирование требует чтения результата обратно. Проверка запрета `Read` при редактировании требует Claude Code v2.1.208 или более поздней версии.88Правило разрешения `Edit(...)` также предоставляет доступ на чтение к тому же пути, поэтому вам не нужно соответствующее правило `Read(...)`. Правило запрета `Read(...)` также блокирует инструмент Edit на том же пути, включая создание нового файла там, потому что редактирование требует чтения результата обратно. Проверка запрета `Read` при редактировании требует Claude Code v2.1.208 или более поздней версии.

89 89 

90Поля `matcher` Hook используют простые названия инструментов, а не формат с скобками. См. [шаблоны сопоставления](/ru/hooks#matcher-patterns) для правил сопоставления. Для названий полей, которые каждый инструмент передает в `tool_input` в hooks, см. [справочник входных данных PreToolUse](/ru/hooks#pretooluse-input).90Поля `matcher` Hook используют простые названия инструментов, а не формат с скобками. См. [шаблоны сопоставления](/docs/ru/hooks#matcher-patterns) для правил сопоставления. Для названий полей, которые каждый инструмент передает в `tool_input` в hooks, см. [справочник входных данных PreToolUse](/docs/ru/hooks#pretooluse-input).

91 91 

92<h2 id="agent-tool-behavior">92<h2 id="agent-tool-behavior">

93 Поведение инструмента Agent93 Поведение инструмента Agent


95 95 

96Инструмент Agent создает subagent в отдельном контекстном окне. Subagent самостоятельно выполняет свою задачу, а затем возвращает один текстовый результат в родительский разговор. Родитель не видит промежуточные вызовы инструментов или выходные данные subagent, только этот финальный результат.96Инструмент Agent создает subagent в отдельном контекстном окне. Subagent самостоятельно выполняет свою задачу, а затем возвращает один текстовый результат в родительский разговор. Родитель не видит промежуточные вызовы инструментов или выходные данные subagent, только этот финальный результат.

97 97 

98Чтобы ограничить количество ходов, которые выполняет subagent, установите `maxTurns` в [определении subagent](/ru/sub-agents#supported-frontmatter-fields).98Чтобы ограничить количество ходов, которые выполняет subagent, установите `maxTurns` в [определении subagent](/docs/ru/sub-agents#supported-frontmatter-fields).

99 99 

100Тот же инструмент Agent также запускает [forked subagents](/ru/sub-agents#fork-the-current-conversation) при включении режима fork. Fork наследует полный родительский разговор вместо начала с нуля, всегда работает в фоне и по-прежнему отображает подсказки разрешений в вашем терминале. Остальная часть этого раздела описывает именованные subagents.100Тот же инструмент Agent также запускает [forked subagents](/docs/ru/sub-agents#fork-the-current-conversation) при включении режима fork. Fork наследует полный родительский разговор вместо начала с нуля, всегда работает в фоне и по-прежнему отображает подсказки разрешений в вашем терминале. Остальная часть этого раздела описывает именованные subagents.

101 101 

102Какие инструменты может использовать именованный subagent, зависит от полей `tools` и `disallowedTools` в [определении subagent](/ru/sub-agents):102Какие инструменты может использовать именованный subagent, зависит от полей `tools` и `disallowedTools` в [определении subagent](/docs/ru/sub-agents):

103 103 

104* **Ни одно поле не установлено**: subagent наследует каждый инструмент, доступный родителю.104* **Ни одно поле не установлено**: subagent наследует каждый инструмент, доступный родителю.

105* **Только `tools`**: subagent получает только перечисленные инструменты.105* **Только `tools`**: subagent получает только перечисленные инструменты.

106* **Только `disallowedTools`**: subagent получает каждый инструмент родителя, кроме перечисленных.106* **Только `disallowedTools`**: subagent получает каждый инструмент родителя, кроме перечисленных.

107* **Оба установлены**: `disallowedTools` имеет приоритет. Инструмент, указанный в обоих, удаляется.107* **Оба установлены**: `disallowedTools` имеет приоритет. Инструмент, указанный в обоих, удаляется.

108 108 

109Когда список `tools` subagent разрешается в отсутствие инструментов вообще, например, потому что каждая запись содержит опечатку или называет инструмент, который недоступен для subagents, инструмент Agent возвращает ошибку, перечисляющую эти записи, вместо запуска subagent. {/* min-version: 2.1.208 */}До версии 2.1.208 subagent запускался без инструментов и мог вернуть пустой или запутанный результат.109Когда список `tools` subagent разрешается в отсутствие инструментов вообще, например, потому что каждая запись содержит опечатку или называет инструмент, который недоступен для subagents, инструмент Agent возвращает ошибку, перечисляющую эти записи, вместо запуска subagent. До версии 2.1.208 subagent запускался без инструментов и мог вернуть пустой или запутанный результат.

110 110 

111Запуск subagent сам по себе не запрашивает разрешение. Claude Code проверяет вызовы инструментов subagent против ваших правил разрешений по мере его работы.111Запуск subagent сам по себе не запрашивает разрешение. Claude Code проверяет вызовы инструментов subagent против ваших правил разрешений по мере его работы.

112 112 

113{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, subagents работают в фоне по умолчанию; Claude запускает один на переднем плане, когда ему нужен результат перед продолжением.113Начиная с версии 2.1.198, subagents работают в фоне по умолчанию; Claude запускает один на переднем плане, когда ему нужен результат перед продолжением.

114 114 

115* **Foreground subagents** показывают те же подсказки разрешений, которые вы видели бы в основном разговоре, в момент каждого вызова инструмента.115* **Foreground subagents** показывают те же подсказки разрешений, которые вы видели бы в основном разговоре, в момент каждого вызова инструмента.

116* **Background subagents** {/* min-version: 2.1.186 */}отображают подсказки разрешений в вашем основном сеансе начиная с версии 2.1.186. Подсказка указывает, какой subagent запрашивает разрешение, и нажатие Esc отклоняет этот вызов инструмента без остановки subagent. До версии 2.1.186 background subagents автоматически отклоняли любой вызов инструмента, который иначе запросил бы подсказку, и продолжали работу без этого инструмента.116* **Background subagents** отображают подсказки разрешений в вашем основном сеансе начиная с версии 2.1.186. Подсказка указывает, какой subagent запрашивает разрешение, и нажатие Esc отклоняет этот вызов инструмента без остановки subagent. До версии 2.1.186 background subagents автоматически отклоняли любой вызов инструмента, который иначе запросил бы подсказку, и продолжали работу без этого инструмента.

117 117 

118Чтобы ограничить, что может достичь subagent с самого начала, сузьте его поле `tools`, оставьте Bash вне списка или установите правила deny в ваших параметрах, как описано в [Control subagent capabilities](/ru/sub-agents#control-subagent-capabilities). Для получения дополнительной информации о выборе между foreground и background см. [Run subagents in foreground or background](/ru/sub-agents#run-subagents-in-foreground-or-background).118Чтобы ограничить, что может достичь subagent с самого начала, сузьте его поле `tools`, оставьте Bash вне списка или установите правила deny в ваших параметрах, как описано в [Control subagent capabilities](/docs/ru/sub-agents#control-subagent-capabilities). Для получения дополнительной информации о выборе между foreground и background см. [Run subagents in foreground or background](/docs/ru/sub-agents#run-subagents-in-foreground-or-background).

119 119 

120<h2 id="bash-tool-behavior">120<h2 id="bash-tool-behavior">

121 Поведение инструмента Bash121 Поведение инструмента Bash


123 123 

124Инструмент Bash запускает каждую команду в отдельном процессе со следующим поведением сохранения:124Инструмент Bash запускает каждую команду в отдельном процессе со следующим поведением сохранения:

125 125 

126* Когда Claude запускает `cd` в основном сеансе, новый рабочий каталог переносится в более поздние команды Bash, пока он остается внутри каталога проекта или [дополнительного рабочего каталога](/ru/permissions#working-directories), который вы добавили с помощью `--add-dir`, `/add-dir` или `additionalDirectories` в параметрах. Сеансы subagent никогда не переносят изменения рабочего каталога.126* Когда Claude запускает `cd` в основном сеансе, новый рабочий каталог переносится в более поздние команды Bash, пока он остается внутри каталога проекта или [дополнительного рабочего каталога](/docs/ru/permissions#working-directories), который вы добавили с помощью `--add-dir`, `/add-dir` или `additionalDirectories` в параметрах. Сеансы subagent никогда не переносят изменения рабочего каталога.

127 * Если `cd` приводит вне этих каталогов, Claude Code сбрасывает в каталог проекта и добавляет `Shell cwd was reset to <dir>` к результату инструмента.127 * Если `cd` приводит вне этих каталогов, Claude Code сбрасывает в каталог проекта и добавляет `Shell cwd was reset to <dir>` к результату инструмента.

128 * Чтобы отключить этот перенос, чтобы каждая команда Bash начиналась в каталоге проекта, установите `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.128 * Чтобы отключить этот перенос, чтобы каждая команда Bash начиналась в каталоге проекта, установите `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.

129* Переменные окружения не сохраняются. `export` в одной команде не будет доступен в следующей.129* Переменные окружения не сохраняются. `export` в одной команде не будет доступен в следующей.

130* Псевдонимы и функции оболочки, определенные в файле запуска оболочки, доступны. При запуске сеанса Claude Code загружает `~/.zshrc`, `~/.bashrc` или `~/.profile` в зависимости от вашей оболочки, захватывает полученные псевдонимы, функции и параметры оболочки и применяет их к каждой команде Bash.130* Псевдонимы и функции оболочки, определенные в файле запуска оболочки, доступны. При запуске сеанса Claude Code загружает `~/.zshrc`, `~/.bashrc` или `~/.profile` в зависимости от вашей оболочки, захватывает полученные псевдонимы, функции и параметры оболочки и применяет их к каждой команде Bash.

131 131 

132Активируйте вашу virtualenv или conda среду перед запуском Claude Code. Чтобы переменные окружения сохранялись между командами Bash, установите [`CLAUDE_ENV_FILE`](/ru/env-vars) на скрипт оболочки перед запуском Claude Code или используйте [hook SessionStart](/ru/hooks#persist-environment-variables) для динамического заполнения.132Активируйте вашу virtualenv или conda среду перед запуском Claude Code. Чтобы переменные окружения сохранялись между командами Bash, установите [`CLAUDE_ENV_FILE`](/docs/ru/env-vars) на скрипт оболочки перед запуском Claude Code или используйте [hook SessionStart](/docs/ru/hooks#persist-environment-variables) для динамического заполнения.

133 133 

134Два ограничения ограничивают каждую команду:134Два ограничения ограничивают каждую команду:

135 135 

136* **Timeout**: два минуты по умолчанию. Claude может запросить до 10 минут на команду с параметром `timeout`. Переопределите значение по умолчанию и потолок с помощью [`BASH_DEFAULT_TIMEOUT_MS` и `BASH_MAX_TIMEOUT_MS`](/ru/env-vars).136* **Timeout**: два минуты по умолчанию. Claude может запросить до 10 минут на команду с параметром `timeout`. Переопределите значение по умолчанию и потолок с помощью [`BASH_DEFAULT_TIMEOUT_MS` и `BASH_MAX_TIMEOUT_MS`](/docs/ru/env-vars).

137* **Длина вывода**: 30 000 символов по умолчанию. Когда команда производит больше, Claude Code сохраняет полный вывод в файл в каталоге сеанса и дает Claude путь к файлу плюс короткий предпросмотр с начала. Claude читает или ищет этот файл, когда ему нужен остаток. Увеличьте лимит с помощью [`BASH_MAX_OUTPUT_LENGTH`](/ru/env-vars), до жесткого потолка в 150 000 символов.137* **Длина вывода**: 30 000 символов по умолчанию. Когда команда производит больше, Claude Code сохраняет полный вывод в файл в каталоге сеанса и дает Claude путь к файлу плюс короткий предпросмотр с начала. Claude читает или ищет этот файл, когда ему нужен остаток. Увеличьте лимит с помощью [`BASH_MAX_OUTPUT_LENGTH`](/docs/ru/env-vars), до жесткого потолка в 150 000 символов.

138 138 

139Для долгоживущих процессов, таких как dev серверы или watch сборки, Claude может установить `run_in_background: true` для запуска команды как фоновой задачи и продолжения работы во время ее выполнения. Выводите список и останавливайте фоновые задачи с помощью `/tasks`. В неинтерактивном режиме с флагом `-p` [фоновые задачи завершаются вскоре после окончательного результата запуска](/ru/headless#background-tasks-at-exit).139Для долгоживущих процессов, таких как dev серверы или watch сборки, Claude может установить `run_in_background: true` для запуска команды как фоновой задачи и продолжения работы во время ее выполнения. Выводите список и останавливайте фоновые задачи с помощью `/tasks`. В неинтерактивном режиме с флагом `-p` [фоновые задачи завершаются вскоре после окончательного результата запуска](/docs/ru/headless#background-tasks-at-exit).

140 140 

141<h2 id="edit-tool-behavior">141<h2 id="edit-tool-behavior">

142 Поведение инструмента Edit142 Поведение инструмента Edit


144 144 

145Инструмент Edit выполняет точную замену строк. Он принимает `old_string` и `new_string` и заменяет первый на второй. Он не использует regex или нечеткое сопоставление.145Инструмент Edit выполняет точную замену строк. Он принимает `old_string` и `new_string` и заменяет первый на второй. Он не использует regex или нечеткое сопоставление.

146 146 

147Три проверки должны пройти для применения редактирования. {/* min-version: 2.1.208 */}Перед любой из них путь, соответствующий [правилу deny `Read`](/ru/permissions#tool-specific-permission-rules), отклоняется, включая создание нового файла там. Отклонение требует Claude Code v2.1.208 или позже.147Три проверки должны пройти для применения редактирования. Перед любой из них путь, соответствующий [правилу deny `Read`](/docs/ru/permissions#tool-specific-permission-rules), отклоняется, включая создание нового файла там. Отклонение требует Claude Code v2.1.208 или позже.

148 148 

149* **Read-before-edit**: Claude читает файл в текущем разговоре перед редактированием, и файл, прочитанный с уведомлением [`PARTIAL view`](#read-tool-behavior), не считается. Claude Opus 4.6, Claude Haiku 4.5 и более старые модели всегда требуют чтение. Более новые модели могут редактировать непрочитанный файл при чтении, когда чтение не требует запроса разрешения и инструмент Read доступен.149* **Read-before-edit**: Claude читает файл в текущем разговоре перед редактированием, и файл, прочитанный с уведомлением [`PARTIAL view`](#read-tool-behavior), не считается. Claude Opus 4.6, Claude Haiku 4.5 и более старые модели всегда требуют чтение. Более новые модели могут редактировать непрочитанный файл при чтении, когда чтение не требует запроса разрешения и инструмент Read доступен.

150* **Match**: `old_string` должен появиться в файле точно так, как написано. Даже один символ пробела или различия в отступе достаточно, чтобы пропустить.150* **Match**: `old_string` должен появиться в файле точно так, как написано. Даже один символ пробела или различия в отступе достаточно, чтобы пропустить.

151* **Uniqueness**: `old_string` должен появиться ровно один раз. Когда он появляется более одного раза, Claude либо предоставляет более длинную строку с достаточным окружающим контекстом для определения одного вхождения, либо устанавливает `replace_all: true` для замены всех.151* **Uniqueness**: `old_string` должен появиться ровно один раз. Когда он появляется более одного раза, Claude либо предоставляет более длинную строку с достаточным окружающим контекстом для определения одного вхождения, либо устанавливает `replace_all: true` для замены всех.

152 152 

153Файл, который изменился на диске после последнего чтения Claude, все еще может быть отредактирован, когда `old_string` точно и однозначно совпадает с текущим содержимым и Claude Code может прочитать файл без запроса. Сопоставление с текущим содержимым файла обеспечивает безопасность, и результат отмечает, что файл содержит другие изменения, поэтому Claude перечитывает его перед редактированиями, которые зависят от окружающего содержимого. В любом другом случае, например при устаревшем `old_string` или при совпадении более одного раза без `replace_all`, Claude читает файл снова перед редактированием. {/* min-version: 2.1.208 */}Расслабленная обработка непрочитанных и измененных файлов требует Claude Code v2.1.208 или позже; до этого Claude Code отклонял любое редактирование файла, который он не прочитал в разговоре или который изменился на диске после чтения.153Файл, который изменился на диске после последнего чтения Claude, все еще может быть отредактирован, когда `old_string` точно и однозначно совпадает с текущим содержимым и Claude Code может прочитать файл без запроса. Сопоставление с текущим содержимым файла обеспечивает безопасность, и результат отмечает, что файл содержит другие изменения, поэтому Claude перечитывает его перед редактированиями, которые зависят от окружающего содержимого. В любом другом случае, например при устаревшем `old_string` или при совпадении более одного раза без `replace_all`, Claude читает файл снова перед редактированием. Расслабленная обработка непрочитанных и измененных файлов требует Claude Code v2.1.208 или позже; до этого Claude Code отклонял любое редактирование файла, который он не прочитал в разговоре или который изменился на диске после чтения.

154 154 

155Просмотр файла с помощью Bash также удовлетворяет требованию read-before-edit, когда команда — это `cat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep` или `fgrep` на одном файле без pipes или redirects. Piped вывод и другие команды Bash не считаются для проверки read-before-edit.155Просмотр файла с помощью Bash также удовлетворяет требованию read-before-edit, когда команда — это `cat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep` или `fgrep` на одном файле без pipes или redirects. Piped вывод и другие команды Bash не считаются для проверки read-before-edit.

156 156 

157Это влияет только на приемлемость редактирования, а не на разрешения. [Правила deny Read и Edit](/ru/permissions#tool-specific-permission-rules) также применяются к командам файлов, которые Claude Code распознает в Bash, таким как `cat`, `head`, `tail`, `sed` и `grep`, но не к произвольным подпроцессам, которые косвенно читают или записывают файлы, такие как скрипт Python или Node, который открывает файлы сам. Набор команд, распознаваемых для правил deny, не совпадает со списком read-before-edit выше: например, `egrep` и `fgrep` считаются для read-before-edit, но не проверяются против правил deny Read. Для принудительного применения на уровне ОС, охватывающего каждый процесс, [включите sandbox](/ru/sandboxing).157Это влияет только на приемлемость редактирования, а не на разрешения. [Правила deny Read и Edit](/docs/ru/permissions#tool-specific-permission-rules) также применяются к командам файлов, которые Claude Code распознает в Bash, таким как `cat`, `head`, `tail`, `sed` и `grep`, но не к произвольным подпроцессам, которые косвенно читают или записывают файлы, такие как скрипт Python или Node, который открывает файлы сам. Набор команд, распознаваемых для правил deny, не совпадает со списком read-before-edit выше: например, `egrep` и `fgrep` считаются для read-before-edit, но не проверяются против правил deny Read. Для принудительного применения на уровне ОС, охватывающего каждый процесс, [включите sandbox](/docs/ru/sandboxing).

158 158 

159<h2 id="glob-tool-behavior">159<h2 id="glob-tool-behavior">

160 Поведение инструмента Glob160 Поведение инструмента Glob


170 170 

171Glob не соблюдает `.gitignore` по умолчанию, поэтому он находит файлы, игнорируемые git, наряду с отслеживаемыми. Это отличается от [Grep](#grep-tool-behavior), который пропускает файлы, игнорируемые git. Чтобы заставить Glob соблюдать `.gitignore`, установите `CLAUDE_CODE_GLOB_NO_IGNORE=false` перед запуском Claude Code.171Glob не соблюдает `.gitignore` по умолчанию, поэтому он находит файлы, игнорируемые git, наряду с отслеживаемыми. Это отличается от [Grep](#grep-tool-behavior), который пропускает файлы, игнорируемые git. Чтобы заставить Glob соблюдать `.gitignore`, установите `CLAUDE_CODE_GLOB_NO_IGNORE=false` перед запуском Claude Code.

172 172 

173Значение `pattern` или `path`, содержащее нулевой байт, возвращает ошибку с просьбой к Claude удалить его. {/* min-version: 2.1.208 */}173Значение `pattern` или `path`, содержащее нулевой байт, возвращает ошибку с просьбой к Claude удалить его.&#x20;

174 174 

175<h2 id="grep-tool-behavior">175<h2 id="grep-tool-behavior">

176 Поведение инструмента Grep176 Поведение инструмента Grep


180 180 

181Grep построен на [ripgrep](https://github.com/BurntSushi/ripgrep) и использует синтаксис regex ripgrep, а не POSIX grep. Шаблоны, которые включают метасимволы regex, нуждаются в экранировании. Например, поиск `interface{}` в коде Go требует шаблона `interface\{\}`.181Grep построен на [ripgrep](https://github.com/BurntSushi/ripgrep) и использует синтаксис regex ripgrep, а не POSIX grep. Шаблоны, которые включают метасимволы regex, нуждаются в экранировании. Например, поиск `interface{}` в коде Go требует шаблона `interface\{\}`.

182 182 

183Шаблон, glob или тип файла, который ripgrep отклоняет, возвращает ошибку, которая включает диагностику ripgrep, поэтому Claude может исправить входные данные и выполнить поиск снова. {/* min-version: 2.1.208 */}До версии 2.1.208 Claude Code сообщал об отклоненном входе как `No files found` вместо ошибки, даже когда искомый текст существовал в целевых файлах.183Шаблон, glob или тип файла, который ripgrep отклоняет, возвращает ошибку, которая включает диагностику ripgrep, поэтому Claude может исправить входные данные и выполнить поиск снова. До версии 2.1.208 Claude Code сообщал об отклоненном входе как `No files found` вместо ошибки, даже когда искомый текст существовал в целевых файлах.

184 184 

185Три режима вывода контролируют, что возвращается:185Три режима вывода контролируют, что возвращается:

186 186 

187* `files_with_matches`: только пути к файлам, без содержимого строк. Это значение по умолчанию.187* `files_with_matches`: только пути к файлам, без содержимого строк. Это значение по умолчанию.

188* `content`: соответствующие строки с номером файла и строки.188* `content`: соответствующие строки с номером файла и строки.

189* `count`: количество совпадений на файл, за которым следует общее количество совпадений во всех соответствующих файлах. {/* min-version: 2.1.208 */}Общее количество охватывает каждое совпадение, даже когда параметры `head_limit` или `offset` инструмента усекают перечисленные записи для каждого файла. До версии 2.1.208 общее количество суммировало только перечисленные записи.189* `count`: количество совпадений на файл, за которым следует общее количество совпадений во всех соответствующих файлах. Общее количество охватывает каждое совпадение, даже когда параметры `head_limit` или `offset` инструмента усекают перечисленные записи для каждого файла. До версии 2.1.208 общее количество суммировало только перечисленные записи.

190 190 

191Claude может ограничить результаты по файлу с параметром `glob`, таким как `**/*.tsx`, или по языку с параметром `type`, таким как `py` или `rust`. По умолчанию шаблоны совпадают в одной строке. Claude может установить `multiline: true` для совпадения через границы строк.191Claude может ограничить результаты по файлу с параметром `glob`, таким как `**/*.tsx`, или по языку с параметром `type`, таким как `py` или `rust`. По умолчанию шаблоны совпадают в одной строке. Claude может установить `multiline: true` для совпадения через границы строк.

192 192 


206* Поиск реализаций интерфейса206* Поиск реализаций интерфейса

207* Трассировка иерархий вызовов207* Трассировка иерархий вызовов

208 208 

209Инструмент неактивен до тех пор, пока вы не установите [плагин интеллекта кода](/ru/discover-plugins#code-intelligence) для вашего языка. Плагин содержит конфигурацию языкового сервера, и вы устанавливаете двоичный файл сервера отдельно.209Инструмент неактивен до тех пор, пока вы не установите [плагин интеллекта кода](/docs/ru/discover-plugins#code-intelligence) для вашего языка. Плагин содержит конфигурацию языкового сервера, и вы устанавливаете двоичный файл сервера отдельно.

210 210 

211<h2 id="monitor-tool">211<h2 id="monitor-tool">

212 Инструмент Monitor212 Инструмент Monitor


224 224 

225Вы продолжаете работать в том же сеансе, и Claude вмешивается при возникновении события. Остановите монитор, попросив Claude отменить его или завершив сеанс.225Вы продолжаете работать в том же сеансе, и Claude вмешивается при возникновении события. Остановите монитор, попросив Claude отменить его или завершив сеанс.

226 226 

227Когда Monitor запускает команду, он использует те же [правила разрешений, что и Bash](/ru/permissions#tool-specific-permission-rules), поэтому шаблоны `allow` и `deny`, которые вы установили для Bash, применяются здесь также. [Источник WebSocket](#websocket-source) имеет собственное приглашение на одобрение.227Когда Monitor запускает команду, он использует те же [правила разрешений, что и Bash](/docs/ru/permissions#tool-specific-permission-rules), поэтому шаблоны `allow` и `deny`, которые вы установили для Bash, применяются здесь также. [Источник WebSocket](#websocket-source) имеет собственное приглашение на одобрение.

228 228 

229Инструмент недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Он также недоступен, когда установлены `DISABLE_TELEMETRY` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`.229Инструмент недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Он также недоступен, когда установлены `DISABLE_TELEMETRY` или `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`.

230 230 

231Плагины могут объявлять мониторы, которые запускаются автоматически при активации плагина, вместо того чтобы просить Claude запустить их. См. [мониторы плагинов](/ru/plugins-reference#monitors).231Плагины могут объявлять мониторы, которые запускаются автоматически при активации плагина, вместо того чтобы просить Claude запустить их. См. [мониторы плагинов](/docs/ru/plugins-reference#monitors).

232 232 

233<h3 id="websocket-source">233<h3 id="websocket-source">

234 Источник WebSocket234 Источник WebSocket


256 256 

257Открытие WebSocket запрашивает одобрение, и приглашение не предлагает возможность пропустить будущие приглашения для одного хоста.257Открытие WebSocket запрашивает одобрение, и приглашение не предлагает возможность пропустить будущие приглашения для одного хоста.

258 258 

259Claude Code отклоняет URL-адреса, указывающие на приватный, link-local или адрес облачных метаданных, включая имена хостов, которые разрешаются в один. Он также отклоняет хосты в `sandbox.network.deniedDomains`, и когда [`allowManagedDomainsOnly`](/ru/settings#sandbox-settings) установлен в управляемых параметрах, любой хост вне управляемого списка разрешений.259Claude Code отклоняет URL-адреса, указывающие на приватный, link-local или адрес облачных метаданных, включая имена хостов, которые разрешаются в один. Он также отклоняет хосты в `sandbox.network.deniedDomains`, и когда [`allowManagedDomainsOnly`](/docs/ru/settings#sandbox-settings) установлен в управляемых параметрах, любой хост вне управляемого списка разрешений.

260 260 

261<h2 id="notebookedit-tool-behavior">261<h2 id="notebookedit-tool-behavior">

262 Поведение инструмента NotebookEdit262 Поведение инструмента NotebookEdit


308 308 

309Три дополнительных параметра контролируют, где используется PowerShell:309Три дополнительных параметра контролируют, где используется PowerShell:

310 310 

311* `"defaultShell": "powershell"` в [`settings.json`](/ru/settings#available-settings): маршрутизирует интерактивные команды `!` через PowerShell. Требует включения инструмента PowerShell.311* `"defaultShell": "powershell"` в [`settings.json`](/docs/ru/settings#available-settings): маршрутизирует интерактивные команды `!` через PowerShell. Требует включения инструмента PowerShell.

312* `"shell": "powershell"` на отдельных [command hooks](/ru/hooks#command-hook-fields): запускает этот hook в PowerShell. Hooks запускают PowerShell напрямую, поэтому это работает независимо от `CLAUDE_CODE_USE_POWERSHELL_TOOL`.312* `"shell": "powershell"` на отдельных [command hooks](/docs/ru/hooks#command-hook-fields): запускает этот hook в PowerShell. Hooks запускают PowerShell напрямую, поэтому это работает независимо от `CLAUDE_CODE_USE_POWERSHELL_TOOL`.

313* `shell: powershell` в [frontmatter skill](/ru/skills#frontmatter-reference): запускает блоки `` !`command` `` в PowerShell. Требует включения инструмента PowerShell.313* `shell: powershell` в [frontmatter skill](/docs/ru/skills#frontmatter-reference): запускает блоки `` !`command` `` в PowerShell. Требует включения инструмента PowerShell.

314 314 

315Поведение сброса рабочего каталога основного сеанса, описанное в разделе инструмента Bash, применяется к командам PowerShell, включая переменную окружения `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.315Поведение сброса рабочего каталога основного сеанса, описанное в разделе инструмента Bash, применяется к командам PowerShell, включая переменную окружения `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.

316 316 

317{/* min-version: 2.1.196 */}Начиная с версии 2.1.196, инструмент PowerShell соответствует обработке инструментом Bash кодов выхода поиска и diff. Код выхода 1 из `grep`, `egrep`, `fgrep` и `git grep` означает отсутствие совпадений, а код выхода 1 из `git diff` означает наличие различий, поэтому эти результаты не сообщаются Claude как ошибки команд.317Начиная с версии 2.1.196, инструмент PowerShell соответствует обработке инструментом Bash кодов выхода поиска и diff. Код выхода 1 из `grep`, `egrep`, `fgrep` и `git grep` означает отсутствие совпадений, а код выхода 1 из `git diff` означает наличие различий, поэтому эти результаты не сообщаются Claude как ошибки команд.

318 318 

319<h3 id="preview-limitations">319<h3 id="preview-limitations">

320 Ограничения предварительного просмотра320 Ограничения предварительного просмотра


333 333 

334По умолчанию Read возвращает файл с начала. Когда чтение всего файла превышает лимит токенов, Read возвращает первую страницу с уведомлением `PARTIAL view`, которое сообщает Claude, какую часть файла он получил, и как читать дальше с помощью `offset` и `limit`. Чтение, которое передает явный `offset` или `limit` и все еще превышает лимит токенов, возвращает ошибку.334По умолчанию Read возвращает файл с начала. Когда чтение всего файла превышает лимит токенов, Read возвращает первую страницу с уведомлением `PARTIAL view`, которое сообщает Claude, какую часть файла он получил, и как читать дальше с помощью `offset` и `limit`. Чтение, которое передает явный `offset` или `limit` и все еще превышает лимит токенов, возвращает ошибку.

335 335 

336Чтение с явным `limit` останавливается, как только выбранные строки превышают то, что лимит токенов когда-либо мог вместить, и возвращает ошибку без загрузки остальной части диапазона. Ошибка сообщает Claude использовать меньший `limit`, или искать конкретное содержимое с помощью [Grep](#grep-tool-behavior) вместо этого, когда одна строка такая большая. {/* min-version: 2.1.208 */}До версии 2.1.208 Claude Code загружал весь диапазон в память перед его отклонением, поэтому файл с чрезвычайно длинной одной строкой мог исчерпать память.336Чтение с явным `limit` останавливается, как только выбранные строки превышают то, что лимит токенов когда-либо мог вместить, и возвращает ошибку без загрузки остальной части диапазона. Ошибка сообщает Claude использовать меньший `limit`, или искать конкретное содержимое с помощью [Grep](#grep-tool-behavior) вместо этого, когда одна строка такая большая. До версии 2.1.208 Claude Code загружал весь диапазон в память перед его отклонением, поэтому файл с чрезвычайно длинной одной строкой мог исчерпать память.

337 337 

338Чтение пустого файла возвращает уведомление о том, что файл существует, но его содержимое пусто, и `offset` за последней строкой возвращает уведомление, дающее количество строк файла. {/* min-version: 2.1.208 */}До версии 2.1.208 чтение пустого файла возвращало уведомление о конце вместо этого.338Чтение пустого файла возвращает уведомление о том, что файл существует, но его содержимое пусто, и `offset` за последней строкой возвращает уведомление, дающее количество строк файла. До версии 2.1.208 чтение пустого файла возвращало уведомление о конце вместо этого.

339 339 

340Read обрабатывает несколько типов файлов помимо простого текста:340Read обрабатывает несколько типов файлов помимо простого текста:

341 341 

342* **Изображения**: PNG, JPG и другие форматы изображений возвращаются как визуальное содержимое, которое Claude может видеть, а не как необработанные байты. Claude Code изменяет размер и переупаковывает большие изображения, чтобы они соответствовали ограничениям размера изображения модели перед отправкой, поэтому Claude может видеть уменьшенную версию большого снимка экрана. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, изображение, которое все еще больше 500KB после этого изменения размера, переупаковывается как JPEG с пониженным качеством с неизменными размерами пикселей. Если Claude пропустит детали на уровне пикселей в большом изображении, попросите его сначала обрезать интересующий регион, например с помощью ImageMagick через Bash.342* **Изображения**: PNG, JPG и другие форматы изображений возвращаются как визуальное содержимое, которое Claude может видеть, а не как необработанные байты. Claude Code изменяет размер и переупаковывает большие изображения, чтобы они соответствовали ограничениям размера изображения модели перед отправкой, поэтому Claude может видеть уменьшенную версию большого снимка экрана. Начиная с версии 2.1.196, изображение, которое все еще больше 500KB после этого изменения размера, переупаковывается как JPEG с пониженным качеством с неизменными размерами пикселей. Если Claude пропустит детали на уровне пикселей в большом изображении, попросите его сначала обрезать интересующий регион, например с помощью ImageMagick через Bash.

343* **PDFs**: Claude читает короткие файлы `.pdf` целиком. Для PDF-файлов длиннее 10 страниц он читает в диапазонах с параметром `pages`, таким как `"1-5"`, до 20 страниц за раз.343* **PDFs**: Claude читает короткие файлы `.pdf` целиком. Для PDF-файлов длиннее 10 страниц он читает в диапазонах с параметром `pages`, таким как `"1-5"`, до 20 страниц за раз.

344* **Jupyter notebooks**: файлы `.ipynb` возвращают все ячейки с их выходными данными, включая код, markdown и визуализации.344* **Jupyter notebooks**: файлы `.ipynb` возвращают все ячейки с их выходными данными, включая код, markdown и визуализации.

345 345 


360* Ответы кэшируются на 15 минут, поэтому повторные выборки одного и того же URL возвращаются быстро.360* Ответы кэшируются на 15 минут, поэтому повторные выборки одного и того же URL возвращаются быстро.

361* Когда URL перенаправляется на другой хост, WebFetch возвращает текстовый результат, который называет исходный URL и цель перенаправления вместо его следования. Claude затем получает новый URL со вторым вызовом WebFetch.361* Когда URL перенаправляется на другой хост, WebFetch возвращает текстовый результат, который называет исходный URL и цель перенаправления вместо его следования. Claude затем получает новый URL со вторым вызовом WebFetch.

362 362 

363В режимах разрешений по умолчанию и `acceptEdits`, WebFetch запрашивает в первый раз, когда он достигает нового домена, за исключением встроенного набора предварительно одобренных доменов документации, которые получают без подсказки. Чтобы разрешить домен заранее без подсказки, добавьте правило разрешения, такое как `WebFetch(domain:example.com)`. Режимы разрешений `auto` и `bypassPermissions` [permission modes](/ru/permissions#permission-modes) полностью пропускают подсказку.363В режимах разрешений по умолчанию и `acceptEdits`, WebFetch запрашивает в первый раз, когда он достигает нового домена, за исключением встроенного набора предварительно одобренных доменов документации, которые получают без подсказки. Чтобы разрешить домен заранее без подсказки, добавьте правило разрешения, такое как `WebFetch(domain:example.com)`. Режимы разрешений `auto` и `bypassPermissions` [permission modes](/docs/ru/permissions#permission-modes) полностью пропускают подсказку.

364 364 

365Явное правило `WebFetch(domain:...)` в `deny`, `ask` или `allow` имеет приоритет над предварительно одобренным набором, поэтому вы можете заблокировать предварительно одобренный домен или потребовать для него подсказку.365Явное правило `WebFetch(domain:...)` в `deny`, `ask` или `allow` имеет приоритет над предварительно одобренным набором, поэтому вы можете заблокировать предварительно одобренный домен или потребовать для него подсказку.

366 366 

367WebFetch устанавливает заголовок `User-Agent`, начинающийся с `Claude-User`, и заголовок `Accept`, который предпочитает Markdown перед HTML, чтобы серверы, поддерживающие согласование содержимого, могли возвращать Markdown напрямую.367WebFetch устанавливает заголовок `User-Agent`, начинающийся с `Claude-User`, и заголовок `Accept`, который предпочитает Markdown перед HTML, чтобы серверы, поддерживающие согласование содержимого, могли возвращать Markdown напрямую.

368 368 

369Вы настраиваете [sandbox](/ru/sandboxing) правила сети отдельно, поэтому домен, который вы хотите, чтобы процесс в песочнице достиг, по-прежнему нуждается в явном правиле разрешения песочницы.369Вы настраиваете [sandbox](/docs/ru/sandboxing) правила сети отдельно, поэтому домен, который вы хотите, чтобы процесс в песочнице достиг, по-прежнему нуждается в явном правиле разрешения песочницы.

370 370 

371<h2 id="websearch-tool-behavior">371<h2 id="websearch-tool-behavior">

372 Поведение инструмента WebSearch372 Поведение инструмента WebSearch


376 376 

377Инструмент может выполнить до восьми поисков на бэкенде на вызов, уточняя поиск внутри перед возвращением результатов. Claude может ограничить результаты с помощью `allowed_domains` для включения только определенных хостов или `blocked_domains` для их исключения. Два списка не могут быть объединены в одном вызове.377Инструмент может выполнить до восьми поисков на бэкенде на вызов, уточняя поиск внутри перед возвращением результатов. Claude может ограничить результаты с помощью `allowed_domains` для включения только определенных хостов или `blocked_domains` для их исключения. Два списка не могут быть объединены в одном вызове.

378 378 

379Бэкенд поиска не настраивается. Чтобы выполнить поиск с другим поставщиком, добавьте [MCP server](/ru/mcp), который предоставляет инструмент поиска.379Бэкенд поиска не настраивается. Чтобы выполнить поиск с другим поставщиком, добавьте [MCP server](/docs/ru/mcp), который предоставляет инструмент поиска.

380 380 

381Правила разрешений WebSearch не принимают спецификатор. Запись `WebSearch` в `allow` или `deny` — это единственная форма.381Правила разрешений WebSearch не принимают спецификатор. Запись `WebSearch` в `allow` или `deny` — это единственная форма.

382 382 

383<Note>383<Note>

384 WebSearch доступен на Claude API, [Claude Platform on AWS](/ru/claude-platform-on-aws) и Microsoft Foundry. На Google Cloud's Agent Platform он работает с моделями Claude 4 и более поздними версиями, включая Opus, Sonnet и Haiku. Amazon Bedrock не предоставляет инструмент веб-поиска на стороне сервера.384 WebSearch доступен на Claude API, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и Microsoft Foundry. На Google Cloud's Agent Platform он работает с моделями Claude 4 и более поздними версиями, включая Opus, Sonnet и Haiku. Amazon Bedrock не предоставляет инструмент веб-поиска на стороне сервера.

385</Note>385</Note>

386 386 

387<h2 id="write-tool-behavior">387<h2 id="write-tool-behavior">


409Claude дает разговорное резюме. Для точных имен инструментов MCP запустите `/mcp`.409Claude дает разговорное резюме. Для точных имен инструментов MCP запустите `/mcp`.

410 410 

411<Note>411<Note>

412 [Инструмент advisor](/ru/advisor) — это [серверный инструмент](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool), который запускает API, а не инструмент, который реализует Claude Code. Он не имеет имени, на которое вы можете ссылаться в правилах разрешений или сопоставителях hooks.412 [Инструмент advisor](/docs/ru/advisor) — это [серверный инструмент](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool), который запускает API, а не инструмент, который реализует Claude Code. Он не имеет имени, на которое вы можете ссылаться в правилах разрешений или сопоставителях hooks.

413</Note>413</Note>

414 414 

415<h2 id="see-also">415<h2 id="see-also">

416 См. также416 См. также

417</h2>417</h2>

418 418 

419* [MCP servers](/ru/mcp): добавляйте пользовательские инструменты, подключая внешние серверы419* [MCP servers](/docs/ru/mcp): добавляйте пользовательские инструменты, подключая внешние серверы

420* [Разрешения](/ru/permissions): система разрешений, синтаксис правил и шаблоны для конкретных инструментов420* [Разрешения](/docs/ru/permissions): система разрешений, синтаксис правил и шаблоны для конкретных инструментов

421* [Subagents](/ru/sub-agents): настройка доступа к инструментам для subagents421* [Subagents](/docs/ru/sub-agents): настройка доступа к инструментам для subagents

422* [Hooks](/ru/hooks-guide): запуск пользовательских команд до или после выполнения инструмента422* [Hooks](/docs/ru/hooks-guide): запуск пользовательских команд до или после выполнения инструмента

Details

6 6 

7> Исправьте ошибки command not found, PATH, разрешений, сети и аутентификации при установке или входе в Claude Code.7> Исправьте ошибки command not found, PATH, разрешений, сети и аутентификации при установке или входе в Claude Code.

8 8 

9Если установка не удалась или вы не можете войти, найдите вашу ошибку ниже. Для проблем во время выполнения после того, как Claude Code работает, см. [Troubleshooting](/ru/troubleshooting). Для проблем конфигурации, таких как неприменение параметров или неработающие hooks, см. [Debug your configuration](/ru/debug-your-config).9Если установка не удалась или вы не можете войти, найдите вашу ошибку ниже. Для проблем во время выполнения после того, как Claude Code работает, см. [Troubleshooting](/docs/ru/troubleshooting). Для проблем конфигурации, таких как неприменение параметров или неработающие hooks, см. [Debug your configuration](/docs/ru/debug-your-config).

10 10 

11<h2 id="find-your-error">11<h2 id="find-your-error">

12 Найдите вашу ошибку12 Найдите вашу ошибку


41| `OAuth error` или `403 Forbidden` | [Исправьте аутентификацию](#login-and-authentication) |41| `OAuth error` или `403 Forbidden` | [Исправьте аутентификацию](#login-and-authentication) |

42| `Could not load the default credentials` или `Could not load credentials from any providers` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |42| `Could not load the default credentials` или `Could not load credentials from any providers` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

43| `ChainedTokenCredential authentication failed` или `CredentialUnavailableError` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |43| `ChainedTokenCredential authentication failed` или `CredentialUnavailableError` | [Учетные данные Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

44| `API Error: 500`, `529 Overloaded`, `429` или другие ошибки 4xx и 5xx, не указанные выше | См. [справочник ошибок](/ru/errors) |44| `API Error: 500`, `529 Overloaded`, `429` или другие ошибки 4xx и 5xx, не указанные выше | См. [справочник ошибок](/docs/ru/errors) |

45 45 

46Если вашей проблемы нет в списке, выполните диагностические проверки ниже, чтобы сузить причину.46Если вашей проблемы нет в списке, выполните диагностические проверки ниже, чтобы сузить причину.

47 47 

48<Tip>48<Tip>

49 Если вы предпочитаете полностью избежать терминала, [Claude Code Desktop app](/ru/desktop-quickstart) позволяет вам установить и использовать Claude Code через графический интерфейс. Загрузите его для [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) или [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) и начните кодировать без какой-либо настройки командной строки. На Linux установите приложение с помощью apt, следуя [инструкциям по установке Linux](/ru/desktop-linux).49 Если вы предпочитаете полностью избежать терминала, [Claude Code Desktop app](/docs/ru/desktop-quickstart) позволяет вам установить и использовать Claude Code через графический интерфейс. Загрузите его для [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs) или [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) и начните кодировать без какой-либо настройки командной строки. На Linux установите приложение с помощью apt, следуя [инструкциям по установке Linux](/docs/ru/desktop-linux).

50</Tip>50</Tip>

51 51 

52<h2 id="run-diagnostic-checks">52<h2 id="run-diagnostic-checks">


100Если установка прошла успешно, но вы получаете ошибку `command not found` или `not recognized` при запуске `claude`, директория установки не находится в вашем PATH. Ваша оболочка ищет программы в директориях, указанных в PATH, и установщик размещает `claude` в `~/.local/bin/claude` на macOS/Linux или `%USERPROFILE%\.local\bin\claude.exe` на Windows.100Если установка прошла успешно, но вы получаете ошибку `command not found` или `not recognized` при запуске `claude`, директория установки не находится в вашем PATH. Ваша оболочка ищет программы в директориях, указанных в PATH, и установщик размещает `claude` в `~/.local/bin/claude` на macOS/Linux или `%USERPROFILE%\.local\bin\claude.exe` на Windows.

101 101 

102<Note>102<Note>

103 Расширение [VS Code](/ru/vs-code) не размещает `claude` в этом месте. Оно содержит приватную копию CLI внутри директории расширения для своей собственной панели чата и не добавляет её в PATH. Если вы установили только расширение, `~/.local/bin/claude` не будет существовать. Запустите [автономную установку](/ru/setup), чтобы использовать `claude` из терминала, а затем продолжите ниже.103 Расширение [VS Code](/docs/ru/vs-code) не размещает `claude` в этом месте. Оно содержит приватную копию CLI внутри директории расширения для своей собственной панели чата и не добавляет её в PATH. Если вы установили только расширение, `~/.local/bin/claude` не будет существовать. Запустите [автономную установку](/docs/ru/setup), чтобы использовать `claude` из терминала, а затем продолжите ниже.

104</Note>104</Note>

105 105 

106Проверьте, находится ли директория установки в вашем PATH, перечислив записи PATH и фильтруя по `local/bin`:106Проверьте, находится ли директория установки в вашем PATH, перечислив записи PATH и фильтруя по `local/bin`:


196 ls -la ~/.local/bin/claude196 ls -la ~/.local/bin/claude

197 ```197 ```

198 198 

199 Встроенная установка показывает символическую ссылку в `~/.local/share/claude/versions/`. Скрипт или символическая ссылка, которую вы создали сами в этом пути, — это пользовательский запускатель, который [автоматическое обновление оставляет на месте](/ru/setup#auto-updates).199 Встроенная установка показывает символическую ссылку в `~/.local/share/claude/versions/`. Скрипт или символическая ссылка, которую вы создали сами в этом пути, — это пользовательский запускатель, который [автоматическое обновление оставляет на месте](/docs/ru/setup#auto-updates).

200 200 

201 Если какая-либо команда `ls` выводит `No such file or directory`, это не ошибка. Это означает, что ничего не установлено в этом месте, поэтому переходите к следующей проверке.201 Если какая-либо команда `ls` выводит `No such file or directory`, это не ошибка. Это означает, что ничего не установлено в этом месте, поэтому переходите к следующей проверке.

202 202 


294Get-Command claude | Select-Object Source294Get-Command claude | Select-Object Source

295```295```

296 296 

297На Linux проверьте отсутствующие общие библиотеки. Если `ldd` показывает отсутствующие библиотеки, вам может потребоваться установить системные пакеты. На Alpine Linux и других дистрибутивах на основе musl см. [Alpine Linux setup](/ru/setup#alpine-linux-and-musl-based-distributions).297На Linux проверьте отсутствующие общие библиотеки. Если `ldd` показывает отсутствующие библиотеки, вам может потребоваться установить системные пакеты. На Alpine Linux и других дистрибутивах на основе musl см. [Alpine Linux setup](/docs/ru/setup#alpine-linux-and-musl-based-distributions).

298 298 

299```bash theme={null}299```bash theme={null}

300ldd "$(command -v claude)" | grep "not found"300ldd "$(command -v claude)" | grep "not found"


413brew install --cask claude-code413brew install --cask claude-code

414```414```

415 415 

416Если Homebrew устанавливает более старую версию Claude Code, чем вы ожидаете, обычно причина в том же устаревшем индексе. Cask `claude-code` отслеживает стабильный канал и обычно отстаёт на неделю от последнего выпуска; для самой новой версии запустите вместо этого `brew install --cask claude-code@latest`. См. [Настройка канала выпуска](/ru/setup#configure-release-channel) для различия между двумя cask.416Если Homebrew устанавливает более старую версию Claude Code, чем вы ожидаете, обычно причина в том же устаревшем индексе. Cask `claude-code` отслеживает стабильный канал и обычно отстаёт на неделю от последнего выпуска; для самой новой версии запустите вместо этого `brew install --cask claude-code@latest`. См. [Настройка канала выпуска](/docs/ru/setup#configure-release-channel) для различия между двумя cask.

417 417 

418<h3 id="tls-or-ssl-connection-errors">418<h3 id="tls-or-ssl-connection-errors">

419 TLS or SSL connection errors419 TLS or SSL connection errors


468 curl -sI https://downloads.claude.ai/claude-code-releases/latest468 curl -sI https://downloads.claude.ai/claude-code-releases/latest

469 ```469 ```

470 470 

4712. **Если за прокси**, установите `HTTPS_PROXY` так, чтобы установщик мог маршрутизировать через него. См. [конфигурация прокси](/ru/network-config#proxy-configuration) для деталей.4712. **Если за прокси**, установите `HTTPS_PROXY` так, чтобы установщик мог маршрутизировать через него. См. [конфигурация прокси](/docs/ru/network-config#proxy-configuration) для деталей.

472 ```bash theme={null}472 ```bash theme={null}

473 export HTTPS_PROXY=http://proxy.example.com:8080473 export HTTPS_PROXY=http://proxy.example.com:8080

474 curl -fsSL https://claude.ai/install.sh | bash474 curl -fsSL https://claude.ai/install.sh | bash


551 551 

552До v2.1.200 скрипт выходил только с голой строкой `Killed` оболочки и без объяснения.552До v2.1.200 скрипт выходил только с голой строкой `Killed` оболочки и без объяснения.

553 553 

554Установка требует примерно 512 МБ свободной памяти, а запуск Claude Code требует больше. См. [системные требования](/ru/setup#system-requirements).554Установка требует примерно 512 МБ свободной памяти, а запуск Claude Code требует больше. См. [системные требования](/docs/ru/setup#system-requirements).

555 555 

556**Решения:**556**Решения:**

557 557 


607 Claude Code on Windows requires either Git for Windows (for bash) or PowerShell607 Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

608</h3>608</h3>

609 609 

610Git for Windows является опциональным. Claude Code использует [PowerShell tool](/ru/tools-reference#powershell-tool) при отсутствии Git Bash, поэтому эта ошибка означает, что ни одна оболочка не была найдена.610Git for Windows является опциональным. Claude Code использует [PowerShell tool](/docs/ru/tools-reference#powershell-tool) при отсутствии Git Bash, поэтому эта ошибка означает, что ни одна оболочка не была найдена.

611 611 

612**Если PowerShell отсутствует в вашем PATH**, его местоположение по умолчанию — `C:\Windows\System32\WindowsPowerShell\v1.0\`. Добавьте эту директорию в ваш `PATH`, или установите [PowerShell 7](https://aka.ms/powershell), который предоставляет `pwsh`.612**Если PowerShell отсутствует в вашем PATH**, его местоположение по умолчанию — `C:\Windows\System32\WindowsPowerShell\v1.0\`. Добавьте эту директорию в ваш `PATH`, или установите [PowerShell 7](https://aka.ms/powershell), который предоставляет `pwsh`.

613 613 

614**Чтобы вместо этого установить Git for Windows**, загрузите его с [git-scm.com/downloads/win](https://git-scm.com/downloads/win). Во время установки выберите "Add to PATH." Перезагрузите ваш терминал после установки. Установка его включает инструмент Bash, полезный при работе со скриптами и инструментами на основе Bash.614**Чтобы вместо этого установить Git for Windows**, загрузите его с [git-scm.com/downloads/win](https://git-scm.com/downloads/win). Во время установки выберите "Add to PATH." Перезагрузите ваш терминал после установки. Установка его включает инструмент Bash, полезный при работе со скриптами и инструментами на основе Bash.

615 615 

616**Если Git уже установлен**, но Claude Code не может его найти, установите путь в вашем [settings.json file](/ru/settings):616**Если Git уже установлен**, но Claude Code не может его найти, установите путь в вашем [settings.json file](/docs/ru/settings):

617 617 

618```json theme={null}618```json theme={null}

619{619{


641 641 

642Если это выводит `True`, ваша операционная система в порядке. Закройте окно, откройте `Windows PowerShell` без суффикса x86 и запустите команду установки снова.642Если это выводит `True`, ваша операционная система в порядке. Закройте окно, откройте `Windows PowerShell` без суффикса x86 и запустите команду установки снова.

643 643 

644Если это выводит `False`, вы находитесь на 32-битном издании Windows. Claude Code требует 64-битную операционную систему. См. [системные требования](/ru/setup#system-requirements).644Если это выводит `False`, вы находитесь на 32-битном издании Windows. Claude Code требует 64-битную операционную систему. См. [системные требования](/docs/ru/setup#system-requirements).

645 645 

646<h3 id="linux-musl-or-glibc-binary-mismatch">646<h3 id="linux-musl-or-glibc-binary-mismatch">

647 Linux musl or glibc binary mismatch647 Linux musl or glibc binary mismatch


737 npm install errors in WSL737 npm install errors in WSL

738</h3>738</h3>

739 739 

740Эти проблемы применяются, если вы установили Claude Code с `npm install -g` внутри WSL. Если вы использовали [native installer](/ru/setup), пропустите этот раздел.740Эти проблемы применяются, если вы установили Claude Code с `npm install -g` внутри WSL. Если вы использовали [native installer](/docs/ru/setup), пропустите этот раздел.

741 741 

742**Проблемы обнаружения ОС или платформы.** Если npm сообщает о несоответствии платформы во время установки, WSL вероятно выбирает Windows `npm`. Сначала запустите `npm config set os linux`, затем установите с `npm install -g @anthropic-ai/claude-code --force`. Не используйте `sudo`.742**Проблемы обнаружения ОС или платформы.** Если npm сообщает о несоответствии платформы во время установки, WSL вероятно выбирает Windows `npm`. Сначала запустите `npm config set os linux`, затем установите с `npm install -g @anthropic-ai/claude-code --force`. Не используйте `sudo`.

743 743 


786Пакет npm `@anthropic-ai/claude-code` получает встроенный бинарный файл через зависимость, специфичную для платформы, такую как `@anthropic-ai/claude-code-darwin-arm64`. Если запуск `claude` после установки выводит `Could not find native binary package "@anthropic-ai/claude-code-<platform>"`, проверьте следующие причины:786Пакет npm `@anthropic-ai/claude-code` получает встроенный бинарный файл через зависимость, специфичную для платформы, такую как `@anthropic-ai/claude-code-darwin-arm64`. Если запуск `claude` после установки выводит `Could not find native binary package "@anthropic-ai/claude-code-<platform>"`, проверьте следующие причины:

787 787 

788* **Опциональные зависимости отключены.** Удалите `--omit=optional` из вашей команды npm install, `--no-optional` из pnpm или `--ignore-optional` из yarn, и проверьте, что `.npmrc` не устанавливает `optional=false`. Затем переустановите. Встроенный бинарный файл доставляется только как опциональная зависимость, поэтому нет JavaScript fallback, если он пропущен.788* **Опциональные зависимости отключены.** Удалите `--omit=optional` из вашей команды npm install, `--no-optional` из pnpm или `--ignore-optional` из yarn, и проверьте, что `.npmrc` не устанавливает `optional=false`. Затем переустановите. Встроенный бинарный файл доставляется только как опциональная зависимость, поэтому нет JavaScript fallback, если он пропущен.

789* **Неподдерживаемая платформа.** Предварительно собранные бинарные файлы опубликованы для `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` и `win32-arm64`. Claude Code не поставляет бинарный файл для других платформ; см. [системные требования](/ru/setup#system-requirements). {/* min-version: 2.1.205 */}На FreeBSD установщик сообщает платформу как неподдерживаемую. До v2.1.205 он рассматривал FreeBSD как Linux и загружал бинарный файл, который не мог работать.789* **Неподдерживаемая платформа.** Предварительно собранные бинарные файлы опубликованы для `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64` и `win32-arm64`. Claude Code не поставляет бинарный файл для других платформ; см. [системные требования](/docs/ru/setup#system-requirements). На FreeBSD установщик сообщает платформу как неподдерживаемую. До v2.1.205 он рассматривал FreeBSD как Linux и загружал бинарный файл, который не мог работать.

790* **Корпоративное зеркало npm отсутствуют пакеты платформы.** Убедитесь, что ваш реестр зеркалирует все восемь пакетов `@anthropic-ai/claude-code-*` платформы в дополнение к мета-пакету.790* **Корпоративное зеркало npm отсутствуют пакеты платформы.** Убедитесь, что ваш реестр зеркалирует все восемь пакетов `@anthropic-ai/claude-code-*` платформы в дополнение к мета-пакету.

791 791 

792Установка с `--ignore-scripts` не вызывает эту ошибку. Шаг postinstall, который связывает бинарный файл на место, пропускается, поэтому Claude Code возвращается к обёртке, которая находит и порождает бинарный файл платформы при каждом запуске. Это работает, но запускается медленнее; переустановите со скриптами, включёнными для прямого выполнения.792Установка с `--ignore-scripts` не вызывает эту ошибку. Шаг postinstall, который связывает бинарный файл на место, пропускается, поэтому Claude Code возвращается к обёртке, которая находит и порождает бинарный файл платформы при каждом запуске. Это работает, но запускается медленнее; переустановите со скриптами, включёнными для прямого выполнения.


829 829 

830* **Пользователи Claude Pro/Max**: проверьте, что ваша подписка активна на [claude.ai/settings](https://claude.ai/settings)830* **Пользователи Claude Pro/Max**: проверьте, что ваша подписка активна на [claude.ai/settings](https://claude.ai/settings)

831* **Пользователи Anthropic Console**: подтвердите, что ваша учётная запись имеет роль "Claude Code" или "Developer". Администраторы назначают это в Anthropic Console под Settings → Members.831* **Пользователи Anthropic Console**: подтвердите, что ваша учётная запись имеет роль "Claude Code" или "Developer". Администраторы назначают это в Anthropic Console под Settings → Members.

832* **За прокси**: корпоративные прокси могут помешать запросам API. См. [network configuration](/ru/network-config) для настройки прокси.832* **За прокси**: корпоративные прокси могут помешать запросам API. См. [network configuration](/docs/ru/network-config) для настройки прокси.

833 833 

834<h3 id="this-organization-has-been-disabled-with-an-active-subscription">834<h3 id="this-organization-has-been-disabled-with-an-active-subscription">

835 This organization has been disabled with an active subscription835 This organization has been disabled with an active subscription


837 837 

838Если вы видите `API Error: 400 ... "This organization has been disabled"` несмотря на активную подписку Claude, переменная окружения `ANTHROPIC_API_KEY` переопределяет вашу подписку. Это обычно происходит, когда старый API ключ от предыдущего работодателя или проекта всё ещё установлен в вашем профиле оболочки.838Если вы видите `API Error: 400 ... "This organization has been disabled"` несмотря на активную подписку Claude, переменная окружения `ANTHROPIC_API_KEY` переопределяет вашу подписку. Это обычно происходит, когда старый API ключ от предыдущего работодателя или проекта всё ещё установлен в вашем профиле оболочки.

839 839 

840Когда `ANTHROPIC_API_KEY` присутствует и вы его одобрили, Claude Code использует этот ключ вместо учётных данных OAuth вашей подписки. В неинтерактивном режиме с флагом `-p` ключ всегда используется, когда присутствует. См. [authentication precedence](/ru/authentication#authentication-precedence) для полного порядка разрешения.840Когда `ANTHROPIC_API_KEY` присутствует и вы его одобрили, Claude Code использует этот ключ вместо учётных данных OAuth вашей подписки. В неинтерактивном режиме с флагом `-p` ключ всегда используется, когда присутствует. См. [authentication precedence](/docs/ru/authentication#authentication-precedence) для полного порядка разрешения.

841 841 

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

843 843 


907 907 

908Если учётные данные работают в вашем терминале, но не в расширении VS Code или JetBrains, процесс IDE вероятно не унаследовал вашу среду оболочки. Установите переменные окружения провайдера в собственных параметрах IDE или запустите IDE из терминала, где они уже экспортированы.908Если учётные данные работают в вашем терминале, но не в расширении VS Code или JetBrains, процесс IDE вероятно не унаследовал вашу среду оболочки. Установите переменные окружения провайдера в собственных параметрах IDE или запустите IDE из терминала, где они уже экспортированы.

909 909 

910См. [Amazon Bedrock](/ru/amazon-bedrock), [Google Cloud's Agent Platform](/ru/google-vertex-ai) или [Microsoft Foundry](/ru/microsoft-foundry) для полной настройки провайдера.910См. [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) или [Microsoft Foundry](/docs/ru/microsoft-foundry) для полной настройки провайдера.

911 911 

912<h2 id="still-stuck">912<h2 id="still-stuck">

913 Still stuck913 Still stuck

ultraplan.md +0 −96 deleted

File Deleted View Diff

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# Планирование в облаке с ultraplan

6 

7> Запустите план из CLI, создайте его в Claude Code в веб-интерфейсе, а затем выполните его удалённо или вернитесь в терминал

8 

9<Note>

10 Ultraplan находится в исследовательском предпросмотре. Поведение и возможности могут измениться на основе обратной связи.

11</Note>

12 

13Ultraplan передаёт задачу планирования из вашего локального CLI в сеанс [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web), работающий в [режиме планирования](/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude создаёт план в облаке, пока вы продолжаете работать в терминале. Когда план готов, вы открываете его в браузере, чтобы оставить комментарии к отдельным разделам, попросить изменения и выбрать место выполнения.

14 

15Это полезно, когда вам нужна более богатая поверхность для проверки, чем предлагает терминал:

16 

17* **Целевая обратная связь**: оставляйте комментарии к отдельным разделам плана вместо ответа на весь план целиком

18* **Удалённое создание**: план создаётся удалённо, поэтому ваш терминал остаётся свободным для другой работы

19* **Гибкое выполнение**: одобрите план для запуска в веб-интерфейсе и откройте pull request, или отправьте его обратно в терминал

20 

21Ultraplan требует учётную запись [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web) и репозиторий GitHub. Поскольку он работает на облачной инфраструктуре Anthropic, он недоступен при использовании Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Облачный сеанс работает в [облачной среде](/ru/claude-code-on-the-web#the-cloud-environment) по умолчанию вашей учётной записи. Если у вас ещё нет облачной среды, ultraplan создаст её автоматически при первом запуске.

22 

23<h2 id="launch-ultraplan-from-the-cli">

24 Запуск ultraplan из CLI

25</h2>

26 

27Из вашего локального сеанса CLI вы можете запустить ultraplan тремя способами:

28 

29* **Команда**: выполните `/ultraplan` с последующей подсказкой

30* **Ключевое слово**: включите слово `ultraplan` в обычную подсказку где угодно

31* **Из локального плана**: когда Claude завершит локальный план и покажет диалог одобрения, выберите **No, refine with Ultraplan on Claude Code on the web**, чтобы отправить черновик в облако для дальнейшей итерации

32 

33Например, чтобы спланировать миграцию сервиса с помощью команды:

34 

35```

36/ultraplan migrate the auth service from sessions to JWTs

37```

38 

39Пути команды и ключевого слова открывают диалог подтверждения перед запуском. Путь локального плана пропускает этот диалог, потому что этот выбор уже служит подтверждением. Если активен [Remote Control](/ru/remote-control), он отключится при запуске ultraplan, потому что обе функции занимают интерфейс claude.ai/code и одновременно может быть подключена только одна.

40 

41После запуска облачного сеанса ввод подсказки вашего CLI показывает индикатор статуса, пока работает облачный сеанс:

42 

43| Статус | Значение |

44| :----------------------------- | :---------------------------------------------------------------- |

45| `◇ ultraplan` | Claude исследует ваш репозиторий и создаёт план |

46| `◇ ultraplan needs your input` | Claude имеет уточняющий вопрос; откройте ссылку сеанса для ответа |

47| `◆ ultraplan ready` | План готов к проверке в вашем браузере |

48 

49Выполните `/tasks` и выберите запись ultraplan, чтобы открыть подробный вид со ссылкой сеанса, активностью агента и действием **Stop ultraplan**. Остановка архивирует облачный сеанс и очищает индикатор; ничего не сохраняется в ваш терминал.

50 

51<h2 id="review-and-revise-the-plan-in-your-browser">

52 Проверка и пересмотр плана в браузере

53</h2>

54 

55Когда статус изменится на `◆ ultraplan ready`, откройте ссылку сеанса, чтобы просмотреть план на claude.ai. План появляется в специальном представлении для проверки:

56 

57* **Встроенные комментарии**: выделите любой отрывок и оставьте комментарий для Claude, чтобы он его рассмотрел

58* **Реакции эмодзи**: реагируйте на раздел, чтобы сигнализировать об одобрении или озабоченности без написания полного комментария

59* **Боковая панель структуры**: переходите между разделами плана

60 

61Когда вы просите Claude обратить внимание на ваши комментарии, он пересматривает план и представляет обновленный черновик. Вы можете повторять столько раз, сколько необходимо, прежде чем выбрать место выполнения.

62 

63<h2 id="choose-where-to-execute">

64 Выбор места выполнения

65</h2>

66 

67Когда план выглядит правильно, вы выбираете в браузере, должен ли Claude реализовать его в том же облачном сеансе или отправить его обратно в ожидающий терминал.

68 

69<h3 id="execute-on-the-web">

70 Выполнение в веб-интерфейсе

71</h3>

72 

73Выберите **Approve Claude's plan and start coding** в браузере, чтобы Claude реализовал его в том же сеансе Claude Code в веб-интерфейсе. Ваш терминал показывает подтверждение, индикатор статуса очищается, и работа продолжается в облаке. Когда реализация завершится, [просмотрите различия](/ru/claude-code-on-the-web#review-changes) и создайте pull request из веб-интерфейса.

74 

75<h3 id="send-the-plan-back-to-your-terminal">

76 Отправка плана обратно в терминал

77</h3>

78 

79Выберите **Approve plan and teleport back to terminal** в браузере, чтобы реализовать план локально с полным доступом к вашей среде. Этот параметр появляется, когда сеанс был запущен из вашего CLI и терминал всё ещё опрашивается. Веб-сеанс архивируется, поэтому он не продолжает работать параллельно.

80 

81Ваш терминал показывает план в диалоговом окне с названием **Ultraplan approved** с тремя вариантами:

82 

83* **Implement here**: внедрите план в вашу текущую беседу и продолжайте с того места, где вы остановились

84* **Start new session**: очистите текущую беседу и начните заново только с плана в качестве контекста

85* **Cancel**: сохраните план в файл без выполнения; Claude выводит путь к файлу, чтобы вы могли вернуться к нему позже

86 

87Если вы начнёте новый сеанс, Claude выведет команду `claude --resume` в верхней части, чтобы вы могли вернуться к предыдущей беседе позже.

88 

89<h2 id="related-resources">

90 Связанные ресурсы

91</h2>

92 

93* [Claude Code в веб-интерфейсе](/ru/claude-code-on-the-web): облачная инфраструктура, на которой работает ultraplan

94* [Режим планирования](/ru/permission-modes#analyze-before-you-edit-with-plan-mode): как работает планирование в локальном сеансе

95* [Поиск ошибок с ultrareview](/ru/ultrareview): аналог ultraplan для проверки кода для выявления проблем перед слиянием

96* [Remote Control](/ru/remote-control): используйте интерфейс claude.ai/code с сеансом, работающим на вашей собственной машине

voice-dictation.md +16 −16

Details

12 Режим нажатия требует Claude Code v2.1.116 или более поздней версии. Проверьте вашу версию с помощью `claude --version`.12 Режим нажатия требует Claude Code v2.1.116 или более поздней версии. Проверьте вашу версию с помощью `claude --version`.

13</Note>13</Note>

14 14 

15Диктовка также работает в [представлении агента](/ru/agent-view#peek-and-reply). Удерживайте или нажимайте вашу клавишу push-to-talk, пока сфокусирован ввод диспетчера или ответ в панели просмотра, чтобы диктовать в фоновый сеанс.15Диктовка также работает в [представлении агента](/docs/ru/agent-view#peek-and-reply). Удерживайте или нажимайте вашу клавишу push-to-talk, пока сфокусирован ввод диспетчера или ответ в панели просмотра, чтобы диктовать в фоновый сеанс.

16 16 

17<h2 id="requirements">17<h2 id="requirements">

18 Требования18 Требования


22 22 

23* **Учетная запись Claude.ai**: служба преобразования речи в текст доступна только при аутентификации с помощью учетной записи Claude.ai и недоступна, когда Claude Code настроен на использование ключа Anthropic API напрямую, Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.23* **Учетная запись Claude.ai**: служба преобразования речи в текст доступна только при аутентификации с помощью учетной записи Claude.ai и недоступна, когда Claude Code настроен на использование ключа Anthropic API напрямую, Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.

24* **Организация без включенного соответствия HIPAA**: `/voice` показывает `Voice mode is disabled by your organization's policy`, когда применяется это ограничение.24* **Организация без включенного соответствия HIPAA**: `/voice` показывает `Voice mode is disabled by your organization's policy`, когда применяется это ограничение.

25* **Локальный микрофон**: голосовой ввод не работает в удаленных окружениях, таких как [Claude Code в веб-браузере](/ru/claude-code-on-the-web) или сеансы SSH.25* **Локальный микрофон**: голосовой ввод не работает в удаленных окружениях, таких как [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web) или сеансы SSH.

26* **WSLg, если вы запускаете Claude Code в WSL**: WSLg включен в WSL2 при установке из Microsoft Store на Windows 10 или 11. Если WSLg недоступен, например на WSL1, запустите Claude Code в собственной Windows.26* **WSLg, если вы запускаете Claude Code в WSL**: WSLg включен в WSL2 при установке из Microsoft Store на Windows 10 или 11. Если WSLg недоступен, например на WSL1, запустите Claude Code в собственной Windows.

27 27 

28Транскрибирование не потребляет сообщения Claude или токены и не учитывается в пределах, показанных в `/usage`. См. [использование данных](/ru/data-usage), чтобы узнать, как Anthropic обрабатывает ваши данные.28Транскрибирование не потребляет сообщения Claude или токены и не учитывается в пределах, показанных в `/usage`. См. [использование данных](/docs/ru/data-usage), чтобы узнать, как Anthropic обрабатывает ваши данные.

29 29 

30Запись аудио использует встроенный собственный модуль на macOS, Linux и Windows. На Linux, если собственный модуль не может загрузиться, Claude Code переходит на `arecord` из ALSA utils или `rec` из SoX. Если ни один из них недоступен, `/voice` выводит команду установки для вашего менеджера пакетов.30Запись аудио использует встроенный собственный модуль на macOS, Linux и Windows. На Linux, если собственный модуль не может загрузиться, Claude Code переходит на `arecord` из ALSA utils или `rec` из SoX. Если ни один из них недоступен, `/voice` выводит команду установки для вашего менеджера пакетов.

31 31 

32Расширение Claude Code [VS Code](/ru/vs-code) также поддерживает голосовой ввод с тем же требованием учетной записи Claude.ai. Оно недоступно в сеансах VS Code Remote, включая SSH, Dev Containers и Codespaces, потому что микрофон находится на вашем локальном компьютере, а расширение работает на удаленном хосте.32Расширение Claude Code [VS Code](/docs/ru/vs-code) также поддерживает голосовой ввод с тем же требованием учетной записи Claude.ai. Оно недоступно в сеансах VS Code Remote, включая SSH, Dev Containers и Codespaces, потому что микрофон находится на вашем локальном компьютере, а расширение работает на удаленном хосте.

33 33 

34<h2 id="enable-voice-dictation">34<h2 id="enable-voice-dictation">

35 Включение голосового ввода35 Включение голосового ввода


51| `/voice tap` | Включить в [режиме нажатия](#tap-to-record-and-send) |51| `/voice tap` | Включить в [режиме нажатия](#tap-to-record-and-send) |

52| `/voice off` | Отключить |52| `/voice off` | Отключить |

53 53 

54Голосовой ввод сохраняется между сеансами. Установите его непосредственно в [файле пользовательских настроек](/ru/settings) вместо запуска `/voice`:54Голосовой ввод сохраняется между сеансами. Установите его непосредственно в [файле пользовательских настроек](/docs/ru/settings) вместо запуска `/voice`:

55 55 

56```json theme={null}56```json theme={null}

57{57{


62}62}

63```63```

64 64 

65Пока голосовой ввод включен, нижний колонтитул ввода показывает подсказку `hold space to speak` (удерживайте пробел для речи), когда запрос пуст. Подсказка отражает ваше текущее сочетание клавиш `voice:pushToTalk` и обновляется, если вы [переназначите клавишу диктовки](#rebind-the-dictation-key). Текст подсказки одинаков в обоих режимах и не отображается, если у вас настроена [пользовательская строка состояния](/ru/statusline).65Пока голосовой ввод включен, нижний колонтитул ввода показывает подсказку `hold space to speak` (удерживайте пробел для речи), когда запрос пуст. Подсказка отражает ваше текущее сочетание клавиш `voice:pushToTalk` и обновляется, если вы [переназначите клавишу диктовки](#rebind-the-dictation-key). Текст подсказки одинаков в обоих режимах и не отображается, если у вас настроена [пользовательская строка состояния](/docs/ru/statusline).

66 66 

67Транскрибирование настроено для словаря кодирования в обоих режимах. Распространенные термины разработки, такие как `regex`, `OAuth`, `JSON` и `localhost`, распознаются правильно, а название вашего текущего проекта и имя ветки git автоматически добавляются как подсказки распознавания.67Транскрибирование настроено для словаря кодирования в обоих режимах. Распространенные термины разработки, такие как `regex`, `OAuth`, `JSON` и `localhost`, распознаются правильно, а название вашего текущего проекта и имя ветки git автоматически добавляются как подсказки распознавания.

68 68 


108 Изменение языка диктовки108 Изменение языка диктовки

109</h2>109</h2>

110 110 

111Голосовой ввод использует тот же [параметр `language`](/ru/settings), который управляет языком ответов Claude. Если этот параметр пуст, диктовка по умолчанию использует английский язык. В расширении VS Code, если `language` пуст, диктовка использует параметр `accessibility.voice.speechLanguage` VS Code перед переходом на английский язык по умолчанию.111Голосовой ввод использует тот же [параметр `language`](/docs/ru/settings), который управляет языком ответов Claude. Если этот параметр пуст, диктовка по умолчанию использует английский язык. В расширении VS Code, если `language` пуст, диктовка использует параметр `accessibility.voice.speechLanguage` VS Code перед переходом на английский язык по умолчанию.

112 112 

113<Accordion title="Поддерживаемые языки диктовки">113<Accordion title="Поддерживаемые языки диктовки">

114 | Язык | Код |114 | Язык | Код |


149 Переназначение клавиши диктовки149 Переназначение клавиши диктовки

150</h2>150</h2>

151 151 

152Клавиша диктовки привязана к `voice:pushToTalk` в контексте `Chat` и по умолчанию установлена на `Space`. Одна и та же привязка управляет обоими режимами удержания и нажатия. Переназначьте ее в [`~/.claude/keybindings.json`](/ru/keybindings):152Клавиша диктовки привязана к `voice:pushToTalk` в контексте `Chat` и по умолчанию установлена на `Space`. Одна и та же привязка управляет обоими режимами удержания и нажатия. Переназначьте ее в [`~/.claude/keybindings.json`](/docs/ru/keybindings):

153 153 

154```json theme={null}154```json theme={null}

155{155{


169 169 

170В режиме удержания избегайте привязки простой буквенной клавиши, такой как `v`, так как обнаружение удержания зависит от повтора клавиши, и буква печатается в запрос во время прогрева. Используйте `Space` или комбинацию модификаторов, такую как `meta+k`, для начала записи при первом нажатии клавиши без прогрева. Режим нажатия не имеет прогрева, поэтому работает большинство клавиш.170В режиме удержания избегайте привязки простой буквенной клавиши, такой как `v`, так как обнаружение удержания зависит от повтора клавиши, и буква печатается в запрос во время прогрева. Используйте `Space` или комбинацию модификаторов, такую как `meta+k`, для начала записи при первом нажатии клавиши без прогрева. Режим нажатия не имеет прогрева, поэтому работает большинство клавиш.

171 171 

172Некоторые клавиши не доставляются в приложения терминала и вообще не могут быть привязаны. Например, `Caps Lock` показывает ошибку, если вы попытаетесь привязать его. См. [настройка сочетаний клавиш](/ru/keybindings) для полного синтаксиса привязки клавиш и списка зарезервированных сочетаний.172Некоторые клавиши не доставляются в приложения терминала и вообще не могут быть привязаны. Например, `Caps Lock` показывает ошибку, если вы попытаетесь привязать его. См. [настройка сочетаний клавиш](/docs/ru/keybindings) для полного синтаксиса привязки клавиш и списка зарезервированных сочетаний.

173 173 

174<h2 id="troubleshooting">174<h2 id="troubleshooting">

175 Устранение неполадок175 Устранение неполадок


181* **`Voice mode is disabled by your organization's policy`**: голосовой ввод отключен политикой вашей организации, как описано в [Требования](#requirements). Обратитесь к администратору вашей организации, чтобы подтвердить, доступен ли голосовой ввод для вашей организации.181* **`Voice mode is disabled by your organization's policy`**: голосовой ввод отключен политикой вашей организации, как описано в [Требования](#requirements). Обратитесь к администратору вашей организации, чтобы подтвердить, доступен ли голосовой ввод для вашей организации.

182* **`Microphone access is denied`**: предоставьте разрешение микрофона вашему терминалу в системных параметрах. На macOS перейдите в System Settings → Privacy & Security → Microphone и включите приложение вашего терминала, затем запустите `/voice` снова. На Windows перейдите в Settings → Privacy & security → Microphone и включите доступ к микрофону для приложений рабочего стола, затем запустите `/voice` снова. Если ваш терминал не указан в параметрах macOS Microphone, см. [Терминал не указан в параметрах macOS Microphone](#terminal-not-listed-in-macos-microphone-settings).182* **`Microphone access is denied`**: предоставьте разрешение микрофона вашему терминалу в системных параметрах. На macOS перейдите в System Settings → Privacy & Security → Microphone и включите приложение вашего терминала, затем запустите `/voice` снова. На Windows перейдите в Settings → Privacy & security → Microphone и включите доступ к микрофону для приложений рабочего стола, затем запустите `/voice` снова. Если ваш терминал не указан в параметрах macOS Microphone, см. [Терминал не указан в параметрах macOS Microphone](#terminal-not-listed-in-macos-microphone-settings).

183* **`No audio recording tool found`** на Linux: собственный модуль аудио не может загрузиться и резервный вариант не установлен. Установите SoX с помощью команды, показанной в сообщении об ошибке, например `sudo apt-get install sox`.183* **`No audio recording tool found`** на Linux: собственный модуль аудио не может загрузиться и резервный вариант не установлен. Установите SoX с помощью команды, показанной в сообщении об ошибке, например `sudo apt-get install sox`.

184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX установлен, но хост не имеет устройства захвата аудио, например безголовый сервер или контейнер. Запустите Claude Code на машине с микрофоном. {/* min-version: 2.1.195 */}Начиная с версии 2.1.195, Claude Code на Linux выводит это сообщение в такой ситуации; более ранние версии просили вас установить SoX даже когда он уже был установлен.184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX установлен, но хост не имеет устройства захвата аудио, например безголовый сервер или контейнер. Запустите Claude Code на машине с микрофоном. Начиная с версии 2.1.195, Claude Code на Linux выводит это сообщение в такой ситуации; более ранние версии просили вас установить SoX даже когда он уже был установлен.

185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg маршрутизирует аудио через PulseAudio вместо устройства ALSA, поэтому SoX требует явной установки его бэкенда PulseAudio. Запустите `sudo apt install sox libsox-fmt-pulse`. Установка только `sox` подтягивает бэкенд ALSA, который не может записывать на WSL, потому что нет устройства `/dev/snd`.185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg маршрутизирует аудио через PulseAudio вместо устройства ALSA, поэтому SoX требует явной установки его бэкенда PulseAudio. Запустите `sudo apt install sox libsox-fmt-pulse`. Установка только `sox` подтягивает бэкенд ALSA, который не может записывать на WSL, потому что нет устройства `/dev/snd`.

186* **`Voice input is failing repeatedly and has been paused`**: голосовой ввод столкнулся с несколькими сбоями при запуске подряд и прекратил попытки новых сеансов до тех пор, пока один не будет успешным. Сбой считается независимо от того, не удается ли микрофону запуститься или рекордер запускается, а затем останавливается без создания какого-либо аудио. Это обычно означает, что микрофон или звуковой стек на этом хосте не может захватить аудио, например безголовый сервер, удаленная оболочка без передачи аудио или запрещенное разрешение микрофона. Подтвердите работающее устройство ввода, исправьте основную причину из записей выше, затем снова активируйте голосовой ввод. {/* min-version: 2.1.202 */}До версии 2.1.202 только сбои при запуске учитывались при паузе.186* **`Voice input is failing repeatedly and has been paused`**: голосовой ввод столкнулся с несколькими сбоями при запуске подряд и прекратил попытки новых сеансов до тех пор, пока один не будет успешным. Сбой считается независимо от того, не удается ли микрофону запуститься или рекордер запускается, а затем останавливается без создания какого-либо аудио. Это обычно означает, что микрофон или звуковой стек на этом хосте не может захватить аудио, например безголовый сервер, удаленная оболочка без передачи аудио или запрещенное разрешение микрофона. Подтвердите работающее устройство ввода, исправьте основную причину из записей выше, затем снова активируйте голосовой ввод. До версии 2.1.202 только сбои при запуске учитывались при паузе.

187* **Ничего не происходит при удержании `Space` в режиме удержания**: смотрите на поле ввода запроса, пока вы удерживаете. Если пробелы продолжают накапливаться, голосовой ввод, вероятно, отключен; запустите `/voice hold` для включения. Если появляется только один или два пробела, а затем ничего, голосовой ввод включен, но обнаружение удержания не срабатывает. Обнаружение удержания требует, чтобы ваш терминал отправлял события повтора клавиш, поэтому он не может обнаружить удерживаемую клавишу, если повтор клавиш отключен на уровне ОС. Переключитесь на режим нажатия с помощью `/voice tap`, чтобы избежать требования повтора клавиш.187* **Ничего не происходит при удержании `Space` в режиме удержания**: смотрите на поле ввода запроса, пока вы удерживаете. Если пробелы продолжают накапливаться, голосовой ввод, вероятно, отключен; запустите `/voice hold` для включения. Если появляется только один или два пробела, а затем ничего, голосовой ввод включен, но обнаружение удержания не срабатывает. Обнаружение удержания требует, чтобы ваш терминал отправлял события повтора клавиш, поэтому он не может обнаружить удерживаемую клавишу, если повтор клавиш отключен на уровне ОС. Переключитесь на режим нажатия с помощью `/voice tap`, чтобы избежать требования повтора клавиш.

188* **Нажатие `Space` печатает пробел вместо записи в режиме нажатия**: первое нажатие начинает запись только при пустом поле ввода запроса. Сначала очистите ввод или проверьте, что вы находитесь в режиме нажатия, запустив `/voice tap`.188* **Нажатие `Space` печатает пробел вместо записи в режиме нажатия**: первое нажатие начинает запись только при пустом поле ввода запроса. Сначала очистите ввод или проверьте, что вы находитесь в режиме нажатия, запустив `/voice tap`.

189* **`No audio detected from microphone`**: запись началась, но захватила молчание. Подтвердите, что правильное устройство ввода установлено по умолчанию в системе и что его уровень ввода не отключен и не близок к нулю. На Windows откройте Settings → System → Sound → Input и выберите ваш микрофон. На macOS откройте System Settings → Sound → Input.189* **`No audio detected from microphone`**: запись началась, но захватила молчание. Подтвердите, что правильное устройство ввода установлено по умолчанию в системе и что его уровень ввода не отключен и не близок к нулю. На Windows откройте Settings → System → Sound → Input и выберите ваш микрофон. На macOS откройте System Settings → Sound → Input.

190* **`Voice connection failed`**: ваша запись никогда не достигла сервиса транскрибирования, потому что соединение не удалось. Проверьте вашу сеть и попробуйте снова. {/* min-version: 2.1.200 */}Запись, которая не захватывает аудио, выводит `No audio detected from microphone` вместо этого сообщения. До версии 2.1.200 тихий микрофон мог выводить ошибку соединения, что предполагало проблему с сетью, когда фактическая проблема была в устройстве ввода.190* **`Voice connection failed`**: ваша запись никогда не достигла сервиса транскрибирования, потому что соединение не удалось. Проверьте вашу сеть и попробуйте снова. Запись, которая не захватывает аудио, выводит `No audio detected from microphone` вместо этого сообщения. До версии 2.1.200 тихий микрофон мог выводить ошибку соединения, что предполагало проблему с сетью, когда фактическая проблема была в устройстве ввода.

191* **`No speech detected`**: аудио достигло сервиса транскрибирования, но слова не были распознаны. Говорите ближе к микрофону, уменьшите фоновый шум и подтвердите, что ваш [язык диктовки](#change-the-dictation-language) соответствует языку, на котором вы говорите.191* **`No speech detected`**: аудио достигло сервиса транскрибирования, но слова не были распознаны. Говорите ближе к микрофону, уменьшите фоновый шум и подтвердите, что ваш [язык диктовки](#change-the-dictation-language) соответствует языку, на котором вы говорите.

192* **Транскрибирование искажено или на неправильном языке**: диктовка по умолчанию использует английский язык. Если вы диктуете на другом языке, установите его в `/config` сначала. См. [Изменение языка диктовки](#change-the-dictation-language).192* **Транскрибирование искажено или на неправильном языке**: диктовка по умолчанию использует английский язык. Если вы диктуете на другом языке, установите его в `/config` сначала. См. [Изменение языка диктовки](#change-the-dictation-language).

193 193 


219 См. также219 См. также

220</h2>220</h2>

221 221 

222* [Настройка сочетаний клавиш](/ru/keybindings): переназначьте `voice:pushToTalk` и другие действия клавиатуры CLI222* [Настройка сочетаний клавиш](/docs/ru/keybindings): переназначьте `voice:pushToTalk` и другие действия клавиатуры CLI

223* [Настройка параметров](/ru/settings): полный справочник для ключей `voice`, `language` и других параметров223* [Настройка параметров](/docs/ru/settings): полный справочник для ключей `voice`, `language` и других параметров

224* [Интерактивный режим](/ru/interactive-mode): сочетания клавиш, режимы ввода и управление сеансом224* [Интерактивный режим](/docs/ru/interactive-mode): сочетания клавиш, режимы ввода и управление сеансом

225* [Команды](/ru/commands): справочник для `/voice`, `/config` и всех других команд225* [Команды](/docs/ru/commands): справочник для `/voice`, `/config` и всех других команд

vs-code.md +35 −35

Details

19Перед установкой убедитесь, что у вас есть:19Перед установкой убедитесь, что у вас есть:

20 20 

21* VS Code версии 1.98.0 или выше21* VS Code версии 1.98.0 или выше

22* Учётная запись Anthropic: подойдёт любая платная подписка Claude (Pro, Max, Team или Enterprise) или учётная запись Claude Console, API ключ не требуется. Вы [войдёте](/ru/authentication#log-in-to-claude-code) с помощью этой учётной записи при первом открытии расширения. Если вы получаете доступ к Claude через поставщика услуг третьей стороны, такого как Amazon Bedrock или Google Cloud's Agent Platform, см. [Использование поставщиков третьей стороны](#use-third-party-providers) для инструкций по настройке.22* Учётная запись Anthropic: подойдёт любая платная подписка Claude (Pro, Max, Team или Enterprise) или учётная запись Claude Console, API ключ не требуется. Вы [войдёте](/docs/ru/authentication#log-in-to-claude-code) с помощью этой учётной записи при первом открытии расширения. Если вы получаете доступ к Claude через поставщика услуг третьей стороны, такого как Amazon Bedrock или Google Cloud's Agent Platform, см. [Использование поставщиков третьей стороны](#use-third-party-providers) для инструкций по настройке.

23 23 

24<Tip>24<Tip>

25 Расширение включает собственную копию CLI (интерфейс командной строки) для панели чата. Чтобы запустить `claude` во встроенном терминале VS Code, вам также нужна [автономная установка CLI](/ru/setup). Подробности см. в разделе [Расширение VS Code и Claude Code CLI](#vs-code-extension-vs-claude-code-cli).25 Расширение включает собственную копию CLI (интерфейс командной строки) для панели чата. Чтобы запустить `claude` во встроенном терминале VS Code, вам также нужна [автономная установка CLI](/docs/ru/setup). Подробности см. в разделе [Расширение VS Code и Claude Code CLI](#vs-code-extension-vs-claude-code-cli).

26</Tip>26</Tip>

27 27 

28<h2 id="install-the-extension">28<h2 id="install-the-extension">


36 36 

37Или в VS Code нажмите `Cmd+Shift+X` (Mac) или `Ctrl+Shift+X` (Windows/Linux), чтобы открыть представление расширений, найдите "Claude Code" и нажмите **Установить**.37Или в VS Code нажмите `Cmd+Shift+X` (Mac) или `Ctrl+Shift+X` (Windows/Linux), чтобы открыть представление расширений, найдите "Claude Code" и нажмите **Установить**.

38 38 

39Расширение также устанавливается в других форках VS Code, таких как Devin Desktop или Kiro. Найдите "Claude Code" в представлении расширений вашего редактора или установите из [реестра Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Если ваш редактор не может установить расширение, [установите CLI](/ru/quickstart) и запустите `claude` в его встроенном терминале. CLI работает в любом терминале.39Расширение также устанавливается в других форках VS Code, таких как Devin Desktop или Kiro. Найдите "Claude Code" в представлении расширений вашего редактора или установите из [реестра Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Если ваш редактор не может установить расширение, [установите CLI](/docs/ru/quickstart) и запустите `claude` в его встроенном терминале. CLI работает в любом терминале.

40 40 

41<Note>Если расширение не появляется после установки, перезагрузите VS Code или выполните "Developer: Reload Window" из палитры команд.</Note>41<Note>Если расширение не появляется после установки, перезагрузите VS Code или выполните "Developer: Reload Window" из палитры команд.</Note>

42 42 


90 </Step>90 </Step>

91</Steps>91</Steps>

92 92 

93Для получения дополнительных идей о том, что вы можете делать с Claude Code, см. [Распространённые рабочие процессы](/ru/common-workflows).93Для получения дополнительных идей о том, что вы можете делать с Claude Code, см. [Распространённые рабочие процессы](/docs/ru/common-workflows).

94 94 

95<Tip>95<Tip>

96 Выполните "Claude Code: Open Walkthrough" из палитры команд для пошагового руководства по основам.96 Выполните "Claude Code: Open Walkthrough" из палитры команд для пошагового руководства по основам.


102 102 

103Поле ввода запроса поддерживает несколько функций:103Поле ввода запроса поддерживает несколько функций:

104 104 

105* **Режимы разрешений**: нажмите на индикатор режима в нижней части поля ввода запроса, чтобы переключать режимы, или установите значение по умолчанию в параметрах VS Code в разделе `claudeCode.initialPermissionMode`. Подробнее см. в разделе [режимы разрешений](/ru/permission-modes#switch-permission-modes) для каждого режима, который предлагает индикатор.105* **Режимы разрешений**: нажмите на индикатор режима в нижней части поля ввода запроса, чтобы переключать режимы, или установите значение по умолчанию в параметрах VS Code в разделе `claudeCode.initialPermissionMode`. Подробнее см. в разделе [режимы разрешений](/docs/ru/permission-modes#switch-permission-modes) для каждого режима, который предлагает индикатор.

106 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством команд shell.106 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством команд shell.

107 * **Plan Mode**: Claude описывает, что он будет делать, и ждёт одобрения перед внесением изменений. VS Code автоматически открывает план как полный документ Markdown, где вы можете добавлять встроенные комментарии, чтобы дать обратную связь перед началом работы Claude.107 * **Plan Mode**: Claude описывает, что он будет делать, и ждёт одобрения перед внесением изменений. VS Code автоматически открывает план как полный документ Markdown, где вы можете добавлять встроенные комментарии, чтобы дать обратную связь перед началом работы Claude.

108 * **Edit automatically**: Claude вносит правки без запроса.108 * **Edit automatically**: Claude вносит правки без запроса.

109* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей, переключение расширенного мышления, просмотр использования плана (`/usage`) и запуск сеанса [Remote Control](/ru/remote-control) (`/remote-control`). Раздел Customize предоставляет доступ к MCP servers, hooks, памяти, разрешениям и plugins. Элементы со значком терминала открываются во встроенном терминале.109* **Меню команд**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей, переключение расширенного мышления, просмотр использования плана (`/usage`) и запуск сеанса [Remote Control](/docs/ru/remote-control) (`/remote-control`). Раздел Customize предоставляет доступ к MCP servers, hooks, памяти, разрешениям и plugins. Элементы со значком терминала открываются во встроенном терминале.

110 * {/* min-version: 2.1.203 */}Раздел Settings включает **Enable Remote Control for all sessions**, который устанавливает [`remoteControlAtStartup`](/ru/settings#available-settings), поэтому [каждый новый интерактивный сеанс автоматически подключается к Remote Control](/ru/remote-control#enable-remote-control-for-all-sessions). Требуется Claude Code v2.1.203 или позже.110 * Раздел Settings включает **Enable Remote Control for all sessions**, который устанавливает [`remoteControlAtStartup`](/docs/ru/settings#available-settings), поэтому [каждый новый интерактивный сеанс автоматически подключается к Remote Control](/docs/ru/remote-control#enable-remote-control-for-all-sessions). Требуется Claude Code v2.1.203 или позже.

111* **Индикатор контекста**: поле ввода запроса показывает, сколько контекстного окна Claude вы используете. Claude автоматически выполняет компактизацию при необходимости, или вы можете выполнить `/compact` вручную.111* **Индикатор контекста**: поле ввода запроса показывает, сколько контекстного окна Claude вы используете. Claude автоматически выполняет компактизацию при необходимости, или вы можете выполнить `/compact` вручную.

112* **Расширенное мышление**: позволяет Claude потратить больше времени на рассуждение о сложных проблемах. Включите его через меню команд (`/`). Рассуждение Claude появляется в беседе как свёрнутые блоки: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть каждый блок мышления в сеансе. Подробности см. в разделе [Расширенное мышление](/ru/model-config#extended-thinking).112* **Расширенное мышление**: позволяет Claude потратить больше времени на рассуждение о сложных проблемах. Включите его через меню команд (`/`). Рассуждение Claude появляется в беседе как свёрнутые блоки: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть каждый блок мышления в сеансе. Подробности см. в разделе [Расширенное мышление](/docs/ru/model-config#extended-thinking).

113* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного текста "Other" диалогов вопросов.113* **Многострочный ввод**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в поле свободного текста "Other" диалогов вопросов.

114 114 

115<h3 id="reference-files-and-folders">115<h3 id="reference-files-and-folders">


133 Возобновление прошлых бесед133 Возобновление прошлых бесед

134</h3>134</h3>

135 135 

136Нажмите на кнопку **Session history** в верхней части панели Claude Code, чтобы получить доступ к истории вашей беседы. Вы можете искать по ключевому слову или просматривать по времени (Today, Yesterday, Last 7 days и т. д.). Нажмите на любую беседу, чтобы возобновить её с полной историей сообщений. Новые сеансы получают названия, созданные AI, на основе вашего первого сообщения. Наведите указатель на сеанс, чтобы открыть действия переименования и удаления: переименуйте, чтобы дать ему описательное название, или удалите, чтобы удалить его из списка. Дополнительную информацию о возобновлении сеансов см. в разделе [Управление сеансами](/ru/sessions).136Нажмите на кнопку **Session history** в верхней части панели Claude Code, чтобы получить доступ к истории вашей беседы. Вы можете искать по ключевому слову или просматривать по времени (Today, Yesterday, Last 7 days и т. д.). Нажмите на любую беседу, чтобы возобновить её с полной историей сообщений. Новые сеансы получают названия, созданные AI, на основе вашего первого сообщения. Наведите указатель на сеанс, чтобы открыть действия переименования и удаления: переименуйте, чтобы дать ему описательное название, или удалите, чтобы удалить его из списка. Дополнительную информацию о возобновлении сеансов см. в разделе [Управление сеансами](/docs/ru/sessions).

137 137 

138<h3 id="resume-cloud-sessions-from-claude-ai">138<h3 id="resume-cloud-sessions-from-claude-ai">

139 Возобновление удалённых сеансов из Claude.ai139 Возобновление удалённых сеансов из Claude.ai

140</h3>140</h3>

141 141 

142Если вы используете [Claude Code в веб-версии](/ru/claude-code-on-the-web), вы можете возобновить эти удалённые сеансы непосредственно в VS Code. Это требует входа с помощью **Claude.ai Subscription**, а не Anthropic Console.142Если вы используете [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), вы можете возобновить эти удалённые сеансы непосредственно в VS Code. Это требует входа с помощью **Claude.ai Subscription**, а не Anthropic Console.

143 143 

144<Steps>144<Steps>

145 <Step title="Откройте историю сеансов">145 <Step title="Откройте историю сеансов">


167 167 

168Диалог также разбивает то, что способствует вашим лимитам плана. Он отмечает поведение, которое составляет 10% или более недавнего использования, такое как промахи кэша, длинный контекст и сеансы с интенсивным использованием подагентов или высокой параллелизацией, каждый с советом по его снижению. Таблицы атрибуции показывают, сколько использования пришло из каждого skill, подагента, plugin и MCP server. Требуется Claude Code v2.1.174 или позже.168Диалог также разбивает то, что способствует вашим лимитам плана. Он отмечает поведение, которое составляет 10% или более недавнего использования, такое как промахи кэша, длинный контекст и сеансы с интенсивным использованием подагентов или высокой параллелизацией, каждый с советом по его снижению. Таблицы атрибуции показывают, сколько использования пришло из каждого skill, подагента, plugin и MCP server. Требуется Claude Code v2.1.174 или позже.

169 169 

170Используйте переключатель Day и Week для переключения между последними 24 часами и последними 7 днями. Цифры являются приблизительными и вычисляются из локальных сеансов на этом компьютере, поэтому использование с других устройств или claude.ai не включено. Дополнительную информацию об отслеживании и снижении использования см. в разделе [Отслеживание ваших затрат](/ru/costs#track-your-costs).170Используйте переключатель Day и Week для переключения между последними 24 часами и последними 7 днями. Цифры являются приблизительными и вычисляются из локальных сеансов на этом компьютере, поэтому использование с других устройств или claude.ai не включено. Дополнительную информацию об отслеживании и снижении использования см. в разделе [Отслеживание ваших затрат](/docs/ru/costs#track-your-costs).

171 171 

172<h2 id="customize-your-workflow">172<h2 id="customize-your-workflow">

173 Настройка вашего рабочего процесса173 Настройка вашего рабочего процесса


209 Управление plugins209 Управление plugins

210</h2>210</h2>

211 211 

212Расширение VS Code включает графический интерфейс для установки и управления [plugins](/ru/plugins). Введите `/plugins` в поле ввода запроса, чтобы открыть интерфейс **Manage plugins**.212Расширение VS Code включает графический интерфейс для установки и управления [plugins](/docs/ru/plugins). Введите `/plugins` в поле ввода запроса, чтобы открыть интерфейс **Manage plugins**.

213 213 

214<h3 id="install-plugins">214<h3 id="install-plugins">

215 Установка plugins215 Установка plugins


246 Управление plugins в VS Code использует те же команды CLI под капотом. Plugins и marketplaces, которые вы настраиваете в расширении, также доступны в CLI, и наоборот.246 Управление plugins в VS Code использует те же команды CLI под капотом. Plugins и marketplaces, которые вы настраиваете в расширении, также доступны в CLI, и наоборот.

247</Note>247</Note>

248 248 

249Дополнительную информацию о системе plugins см. в разделах [Plugins](/ru/plugins) и [Plugin marketplaces](/ru/plugin-marketplaces).249Дополнительную информацию о системе plugins см. в разделах [Plugins](/docs/ru/plugins) и [Plugin marketplaces](/docs/ru/plugin-marketplaces).

250 250 

251<h2 id="automate-browser-tasks-with-chrome">251<h2 id="automate-browser-tasks-with-chrome">

252 Автоматизация задач браузера с помощью Chrome252 Автоматизация задач браузера с помощью Chrome


264 264 

265Claude открывает новые вкладки для задач браузера и делится состоянием входа вашего браузера, поэтому он может получить доступ к любому сайту, на который вы уже вошли.265Claude открывает новые вкладки для задач браузера и делится состоянием входа вашего браузера, поэтому он может получить доступ к любому сайту, на который вы уже вошли.

266 266 

267Инструкции по настройке, полный список возможностей и устранение неполадок см. в разделе [Использование Claude Code с Chrome](/ru/chrome).267Инструкции по настройке, полный список возможностей и устранение неполадок см. в разделе [Использование Claude Code с Chrome](/docs/ru/chrome).

268 268 

269<h2 id="vs-code-commands-and-shortcuts">269<h2 id="vs-code-commands-and-shortcuts">

270 Команды и сочетания клавиш VS Code270 Команды и сочетания клавиш VS Code


332| Параметр | Описание |332| Параметр | Описание |

333| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |333| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

334| `prompt` | Текст для предварительного заполнения в поле ввода запроса. Должен быть закодирован в URL. Запрос предварительно заполняется, но не отправляется автоматически. |334| `prompt` | Текст для предварительного заполнения в поле ввода запроса. Должен быть закодирован в URL. Запрос предварительно заполняется, но не отправляется автоматически. |

335| `session` | ID сеанса для возобновления вместо начала новой беседы. Сеанс должен принадлежать рабочему пространству, открытому в VS Code. Если сеанс не найден, вместо этого начинается свежая беседа. Если сеанс уже открыт на вкладке, эта вкладка получает фокус. Чтобы программно захватить ID сеанса, см. [Continue conversations](/ru/headless#continue-conversations). |335| `session` | ID сеанса для возобновления вместо начала новой беседы. Сеанс должен принадлежать рабочему пространству, открытому в VS Code. Если сеанс не найден, вместо этого начинается свежая беседа. Если сеанс уже открыт на вкладке, эта вкладка получает фокус. Чтобы программно захватить ID сеанса, см. [Continue conversations](/docs/ru/headless#continue-conversations). |

336 336 

337Например, чтобы открыть вкладку с предварительно заполненным "review my changes":337Например, чтобы открыть вкладку с предварительно заполненным "review my changes":

338 338 


340vscode://anthropic.claude-code/open?prompt=review%20my%20changes340vscode://anthropic.claude-code/open?prompt=review%20my%20changes

341```341```

342 342 

343Чтобы запустить сеанс терминала вместо вкладки VS Code, используйте обработчик CLI `claude-cli://`. См. [Launch sessions from links](/ru/deep-links).343Чтобы запустить сеанс терминала вместо вкладки VS Code, используйте обработчик CLI `claude-cli://`. См. [Launch sessions from links](/docs/ru/deep-links).

344 344 

345<h2 id="configure-settings">345<h2 id="configure-settings">

346 Настройка параметров346 Настройка параметров


349Расширение имеет два типа параметров:349Расширение имеет два типа параметров:

350 350 

351* **Параметры расширения** в VS Code: управляют поведением расширения в VS Code. Откройте с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в Extensions → Claude Code. Вы также можете ввести `/` и выбрать **General Config**, чтобы открыть параметры.351* **Параметры расширения** в VS Code: управляют поведением расширения в VS Code. Откройте с помощью `Cmd+,` (Mac) или `Ctrl+,` (Windows/Linux), затем перейдите в Extensions → Claude Code. Вы также можете ввести `/` и выбрать **General Config**, чтобы открыть параметры.

352* **Параметры Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте для разрешённых команд, переменных окружения, hooks и MCP servers. Подробности см. в разделе [Settings](/ru/settings).352* **Параметры Claude Code** в `~/.claude/settings.json`: общие для расширения и CLI. Используйте для разрешённых команд, переменных окружения, hooks и MCP servers. Подробности см. в разделе [Settings](/docs/ru/settings).

353 353 

354<Tip>354<Tip>

355 Добавьте `"$schema": "https://json.schemastore.org/claude-code-settings.json"` в ваш `settings.json`, чтобы получить автодополнение и встроенную проверку для всех доступных параметров непосредственно в VS Code.355 Добавьте `"$schema": "https://json.schemastore.org/claude-code-settings.json"` в ваш `settings.json`, чтобы получить автодополнение и встроенную проверку для всех доступных параметров непосредственно в VS Code.


362| Параметр | По умолчанию | Описание |362| Параметр | По умолчанию | Описание |

363| ----------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |363| ----------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

364| `useTerminal` | `false` | Запустить Claude в режиме терминала вместо графической панели |364| `useTerminal` | `false` | Запустить Claude в режиме терминала вместо графической панели |

365| `initialPermissionMode` | `default` | Управляет запросами одобрения для новых бесед: `default`, `plan`, `acceptEdits` или `bypassPermissions`. {/* min-version: 2.1.200 */}`manual` — это псевдоним для `default` и выбирает режим, обозначенный как **Manual** в индикаторе режима. Требует Claude Code v2.1.200 или позже. Подробности см. в разделе [режимы разрешений](/ru/permission-modes). |365| `initialPermissionMode` | `default` | Управляет запросами одобрения для новых бесед: `default`, `plan`, `acceptEdits` или `bypassPermissions`. `manual` — это псевдоним для `default` и выбирает режим, обозначенный как **Manual** в индикаторе режима. Требует Claude Code v2.1.200 или позже. Подробности см. в разделе [режимы разрешений](/docs/ru/permission-modes). |

366| `preferredLocation` | `panel` | Где открывается Claude: `sidebar` (справа) или `panel` (новая вкладка) |366| `preferredLocation` | `panel` | Где открывается Claude: `sidebar` (справа) или `panel` (новая вкладка) |

367| `autosave` | `true` | Автоматически сохранять файлы перед тем, как Claude их читает или записывает |367| `autosave` | `true` | Автоматически сохранять файлы перед тем, как Claude их читает или записывает |

368| `useCtrlEnterToSend` | `false` | Использовать Ctrl/Cmd+Enter вместо Enter для отправки запросов |368| `useCtrlEnterToSend` | `false` | Использовать Ctrl/Cmd+Enter вместо Enter для отправки запросов |


374| `environmentVariables` | `[]` | Установить переменные окружения для процесса Claude. Используйте параметры Claude Code вместо этого для общей конфигурации. |374| `environmentVariables` | `[]` | Установить переменные окружения для процесса Claude. Используйте параметры Claude Code вместо этого для общей конфигурации. |

375| `disableLoginPrompt` | `false` | Пропустить запросы аутентификации (для настроек поставщика третьей стороны) |375| `disableLoginPrompt` | `false` | Пропустить запросы аутентификации (для настроек поставщика третьей стороны) |

376| `allowDangerouslySkipPermissions` | `false` | Добавляет Bypass permissions к селектору режимов. Используйте только в песочницах без доступа в интернет. |376| `allowDangerouslySkipPermissions` | `false` | Добавляет Bypass permissions к селектору режимов. Используйте только в песочницах без доступа в интернет. |

377| `claudeProcessWrapper` | - | Исполняемый файл, используемый для запуска процесса Claude. Путь к встроенному двоичному файлу передаётся в качестве аргумента при наличии. Установите это значение на отдельно установленный двоичный файл `claude`, если сборка расширения не включает его для вашей платформы. Ошибка "Unsupported platform" при активации означает, что для вашей платформы не включен двоичный файл; см. [какие платформы имеют предварительно собранные двоичные файлы](/ru/troubleshoot-install#native-binary-not-found-after-npm-install). |377| `claudeProcessWrapper` | - | Исполняемый файл, используемый для запуска процесса Claude. Путь к встроенному двоичному файлу передаётся в качестве аргумента при наличии. Установите это значение на отдельно установленный двоичный файл `claude`, если сборка расширения не включает его для вашей платформы. Ошибка "Unsupported platform" при активации означает, что для вашей платформы не включен двоичный файл; см. [какие платформы имеют предварительно собранные двоичные файлы](/docs/ru/troubleshoot-install#native-binary-not-found-after-npm-install). |

378 378 

379<h2 id="vs-code-extension-vs-claude-code-cli">379<h2 id="vs-code-extension-vs-claude-code-cli">

380 Расширение VS Code и Claude Code CLI380 Расширение VS Code и Claude Code CLI

381</h2>381</h2>

382 382 

383Claude Code доступен как расширение VS Code (графическая панель), так и CLI (интерфейс командной строки в терминале). Некоторые функции доступны только в CLI. Если вам нужна функция, доступная только в CLI, выполните `claude` во встроенном терминале VS Code. Это требует [автономной установки CLI](/ru/setup): расширение не добавляет `claude` в ваш PATH. См. [Запуск CLI в VS Code](#run-cli-in-vs-code).383Claude Code доступен как расширение VS Code (графическая панель), так и CLI (интерфейс командной строки в терминале). Некоторые функции доступны только в CLI. Если вам нужна функция, доступная только в CLI, выполните `claude` во встроенном терминале VS Code. Это требует [автономной установки CLI](/docs/ru/setup): расширение не добавляет `claude` в ваш PATH. См. [Запуск CLI в VS Code](#run-cli-in-vs-code).

384 384 

385| Функция | CLI | Расширение VS Code |385| Функция | CLI | Расширение VS Code |

386| ------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------- |386| ------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------- |

387| Команды и skills | [Все](/ru/commands) | Подмножество (введите `/`, чтобы увидеть доступные) |387| Команды и skills | [Все](/docs/ru/commands) | Подмножество (введите `/`, чтобы увидеть доступные) |

388| Конфигурация MCP server | Да | Частично (добавьте серверы через CLI; управляйте существующими серверами с помощью `/mcp` на панели чата) |388| Конфигурация MCP server | Да | Частично (добавьте серверы через CLI; управляйте существующими серверами с помощью `/mcp` на панели чата) |

389| Checkpoints | Да | Да |389| Checkpoints | Да | Да |

390| Сочетание клавиш `!` bash | Да | Нет |390| Сочетание клавиш `!` bash | Да | Нет |


400* **Rewind code to here**: отменить изменения файлов до этой точки в беседе, сохраняя полную историю беседы400* **Rewind code to here**: отменить изменения файлов до этой точки в беседе, сохраняя полную историю беседы

401* **Fork conversation and rewind code**: начать новую ветку беседы и отменить изменения файлов до этой точки401* **Fork conversation and rewind code**: начать новую ветку беседы и отменить изменения файлов до этой точки

402 402 

403Полные подробности о том, как работают checkpoints и их ограничения, см. в разделе [Checkpointing](/ru/checkpointing).403Полные подробности о том, как работают checkpoints и их ограничения, см. в разделе [Checkpointing](/docs/ru/checkpointing).

404 404 

405<h3 id="run-cli-in-vs-code">405<h3 id="run-cli-in-vs-code">

406 Запуск CLI в VS Code406 Запуск CLI в VS Code


408 408 

409Чтобы использовать CLI, оставаясь в VS Code, откройте встроенный терминал (`` Ctrl+` `` на Windows/Linux или `` Cmd+` `` на Mac) и выполните `claude`. CLI автоматически интегрируется с вашей IDE для функций, таких как просмотр diff и обмен диагностикой.409Чтобы использовать CLI, оставаясь в VS Code, откройте встроенный терминал (`` Ctrl+` `` на Windows/Linux или `` Cmd+` `` на Mac) и выполните `claude`. CLI автоматически интегрируется с вашей IDE для функций, таких как просмотр diff и обмен диагностикой.

410 410 

411Установка расширения не добавляет `claude` в ваш PATH оболочки. Расширение содержит приватную копию CLI для своей панели чата, но ввод `claude` в терминал требует [автономной установки CLI](/ru/setup). Выполните установку один раз, и команды на этой странице, включая `claude mcp add` и `claude --resume`, будут работать в любом терминале. Если `claude` всё ещё не найден после установки, [проверьте ваш PATH](/ru/troubleshoot-install#verify-your-path).411Установка расширения не добавляет `claude` в ваш PATH оболочки. Расширение содержит приватную копию CLI для своей панели чата, но ввод `claude` в терминал требует [автономной установки CLI](/docs/ru/setup). Выполните установку один раз, и команды на этой странице, включая `claude mcp add` и `claude --resume`, будут работать в любом терминале. Если `claude` всё ещё не найден после установки, [проверьте ваш PATH](/docs/ru/troubleshoot-install#verify-your-path).

412 412 

413Если вы используете внешний терминал, выполните `/ide` внутри Claude Code, чтобы подключить его к VS Code.413Если вы используете внешний терминал, выполните `/ide` внутри Claude Code, чтобы подключить его к VS Code.

414 414 


445 445 

446После настройки попросите Claude использовать инструменты (например, "Review PR #456").446После настройки попросите Claude использовать инструменты (например, "Review PR #456").

447 447 

448Чтобы управлять MCP servers, не выходя из VS Code, введите `/mcp` на панели чата. Диалог управления MCP позволяет вам включать или отключать серверы, переподключаться к серверу и управлять аутентификацией OAuth. Доступные серверы см. в [документации MCP](/ru/mcp).448Чтобы управлять MCP servers, не выходя из VS Code, введите `/mcp` на панели чата. Диалог управления MCP позволяет вам включать или отключать серверы, переподключаться к серверу и управлять аутентификацией OAuth. Доступные серверы см. в [документации MCP](/docs/ru/mcp).

449 449 

450<h2 id="work-with-git">450<h2 id="work-with-git">

451 Работа с git451 Работа с git


477claude --worktree feature-auth477claude --worktree feature-auth

478```478```

479 479 

480Каждый worktree сохраняет независимое состояние файлов при совместном использовании истории git. Это предотвращает помехи между экземплярами Claude при работе над различными задачами. Дополнительные подробности см. в разделе [Запуск параллельных сеансов с Git worktrees](/ru/worktrees).480Каждый worktree сохраняет независимое состояние файлов при совместном использовании истории git. Это предотвращает помехи между экземплярами Claude при работе над различными задачами. Дополнительные подробности см. в разделе [Запуск параллельных сеансов с Git worktrees](/docs/ru/worktrees).

481 481 

482<h2 id="use-third-party-providers">482<h2 id="use-third-party-providers">

483 Использование поставщиков третьей стороны483 Использование поставщиков третьей стороны


495 <Step title="Настройте вашего поставщика">495 <Step title="Настройте вашего поставщика">

496 Следуйте руководству по настройке для вашего поставщика:496 Следуйте руководству по настройке для вашего поставщика:

497 497 

498 * [Claude Code на Amazon Bedrock](/ru/amazon-bedrock)498 * [Claude Code на Amazon Bedrock](/docs/ru/amazon-bedrock)

499 * [Claude Code на Google Cloud's Agent Platform](/ru/google-vertex-ai)499 * [Claude Code на Google Cloud's Agent Platform](/docs/ru/google-vertex-ai)

500 * [Claude Code на Microsoft Foundry](/ru/microsoft-foundry)500 * [Claude Code на Microsoft Foundry](/docs/ru/microsoft-foundry)

501 501 

502 Эти руководства охватывают настройку вашего поставщика в `~/.claude/settings.json`, что обеспечивает совместное использование ваших параметров между расширением VS Code и CLI.502 Эти руководства охватывают настройку вашего поставщика в `~/.claude/settings.json`, что обеспечивает совместное использование ваших параметров между расширением VS Code и CLI.

503 </Step>503 </Step>


507 Безопасность и конфиденциальность507 Безопасность и конфиденциальность

508</h2>508</h2>

509 509 

510Ваш код остаётся приватным. Claude Code обрабатывает ваш код для предоставления помощи, но не использует его для обучения моделей. Подробности об обработке данных и о том, как отказаться от логирования, см. в разделе [Data and privacy](/ru/data-usage).510Ваш код остаётся приватным. Claude Code обрабатывает ваш код для предоставления помощи, но не использует его для обучения моделей. Подробности об обработке данных и о том, как отказаться от логирования, см. в разделе [Data and privacy](/docs/ru/data-usage).

511 511 

512С включёнными разрешениями на автоматическое редактирование Claude Code может изменять файлы конфигурации VS Code (такие как `settings.json` или `tasks.json`), которые VS Code может выполнять автоматически. Чтобы снизить риск при работе с ненадёжным кодом:512С включёнными разрешениями на автоматическое редактирование Claude Code может изменять файлы конфигурации VS Code (такие как `settings.json` или `tasks.json`), которые VS Code может выполнять автоматически. Чтобы снизить риск при работе с ненадёжным кодом:

513 513 


523 523 

524Сервер называется `ide` и скрыт от `/mcp`, потому что нечего настраивать. Однако если ваша организация использует hook `PreToolUse` для разрешения MCP tools, вам нужно знать, что он существует.524Сервер называется `ide` и скрыт от `/mcp`, потому что нечего настраивать. Однако если ваша организация использует hook `PreToolUse` для разрешения MCP tools, вам нужно знать, что он существует.

525 525 

526**Выделение и контекст открытого файла.** Во время подключения CLI включает ваше текущее выделение в редакторе и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку `⧉ Selected N lines from <file>` когда это происходит. Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [`Read` правило отказа](/ru/permissions#read-and-edit) для его пути. Соответствующее правило отказа предотвращает как выбранный текст, так и уведомление об открытом файле для этого файла от достижения Claude.526**Выделение и контекст открытого файла.** Во время подключения CLI включает ваше текущее выделение в редакторе и путь активного файла в качестве контекста для каждого отправляемого вами запроса. Стенограмма показывает строку `⧉ Selected N lines from <file>` когда это происходит. Чтобы исключить конфиденциальный файл, такой как `.env`, добавьте [`Read` правило отказа](/docs/ru/permissions#read-and-edit) для его пути. Соответствующее правило отказа предотвращает как выбранный текст, так и уведомление об открытом файле для этого файла от достижения Claude.

527 527 

528**Транспорт и аутентификация.** Сервер привязывается к `127.0.0.1` на случайном порту в диапазоне 10000–65535, и порт не настраивается. Транспорт — это незашифрованный `ws://`; поскольку сокет является только локальным, любой процесс, который может перехватить трафик, также может прочитать токен из файла блокировки, поэтому TLS не добавит защиту. Каждая активация расширения генерирует свежий случайный токен аутентификации, записывает его в файл блокировки в `~/.claude/ide/<port>.lock`, и CLI должен предоставить его как заголовок `X-Claude-Code-Ide-Authorization` для подключения. Файл блокировки имеет разрешения `0600` в каталоге `0700`, поэтому только пользователь, запускающий VS Code, может его прочитать. Если установлена переменная `CLAUDE_CONFIG_DIR`, файл блокировки записывается в `$CLAUDE_CONFIG_DIR/ide/` вместо этого.528**Транспорт и аутентификация.** Сервер привязывается к `127.0.0.1` на случайном порту в диапазоне 10000–65535, и порт не настраивается. Транспорт — это незашифрованный `ws://`; поскольку сокет является только локальным, любой процесс, который может перехватить трафик, также может прочитать токен из файла блокировки, поэтому TLS не добавит защиту. Каждая активация расширения генерирует свежий случайный токен аутентификации, записывает его в файл блокировки в `~/.claude/ide/<port>.lock`, и CLI должен предоставить его как заголовок `X-Claude-Code-Ide-Authorization` для подключения. Файл блокировки имеет разрешения `0600` в каталоге `0700`, поэтому только пользователь, запускающий VS Code, может его прочитать. Если установлена переменная `CLAUDE_CONFIG_DIR`, файл блокировки записывается в `$CLAUDE_CONFIG_DIR/ide/` вместо этого.

529 529 


6022. Найдите "Claude Code"6022. Найдите "Claude Code"

6033. Нажмите **Uninstall**6033. Нажмите **Uninstall**

604 604 

605Запуск `claude` в интегрированном терминале VS Code автоматически переустанавливает расширение. Чтобы оно оставалось удалённым, отключите **Auto-install IDE extension** в `/config` или установите [`autoInstallIdeExtension`](/ru/settings#global-config-settings) в значение `false`. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/ru/env-vars) в значение `1`.605Запуск `claude` в интегрированном терминале VS Code автоматически переустанавливает расширение. Чтобы оно оставалось удалённым, отключите **Auto-install IDE extension** в `/config` или установите [`autoInstallIdeExtension`](/docs/ru/settings#global-config-settings) в значение `false`. Вы также можете установить переменную окружения [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/ru/env-vars) в значение `1`.

606 606 

607Чтобы также удалить данные расширения и сбросить все параметры, удалите каталог хранилища расширения для вашей платформы.607Чтобы также удалить данные расширения и сбросить все параметры, удалите каталог хранилища расширения для вашей платформы.

608 608 


624Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"624Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

625```625```

626 626 

627Для дополнительной помощи см. [руководство по устранению неполадок](/ru/troubleshooting).627Для дополнительной помощи см. [руководство по устранению неполадок](/docs/ru/troubleshooting).

628 628 

629<h2 id="next-steps">629<h2 id="next-steps">

630 Следующие шаги630 Следующие шаги


632 632 

633Теперь, когда у вас есть Claude Code, установленный в VS Code:633Теперь, когда у вас есть Claude Code, установленный в VS Code:

634 634 

635* [Изучите распространённые рабочие процессы](/ru/common-workflows), чтобы максимально использовать Claude Code635* [Изучите распространённые рабочие процессы](/docs/ru/common-workflows), чтобы максимально использовать Claude Code

636* [Настройте MCP servers](/ru/mcp), чтобы расширить возможности Claude с помощью внешних инструментов. Добавьте серверы, используя CLI, затем управляйте ими с помощью `/mcp` на панели чата.636* [Настройте MCP servers](/docs/ru/mcp), чтобы расширить возможности Claude с помощью внешних инструментов. Добавьте серверы, используя CLI, затем управляйте ими с помощью `/mcp` на панели чата.

637* [Настройте параметры Claude Code](/ru/settings), чтобы настроить разрешённые команды, hooks и многое другое. Эти параметры общие для расширения и CLI.637* [Настройте параметры Claude Code](/docs/ru/settings), чтобы настроить разрешённые команды, hooks и многое другое. Эти параметры общие для расширения и CLI.

web-quickstart.md +25 −25

Details

21* **Задачи, которые не требуют частого управления**: отправьте четко определенную задачу, займитесь чем-то другим и просмотрите результат, когда Claude закончит21* **Задачи, которые не требуют частого управления**: отправьте четко определенную задачу, займитесь чем-то другим и просмотрите результат, когда Claude закончит

22* **Вопросы о коде и исследование**: поймите кодовую базу или проследите, как реализована функция, без локального клона22* **Вопросы о коде и исследование**: поймите кодовую базу или проследите, как реализована функция, без локального клона

23 23 

24Для работы, которая требует вашей локальной конфигурации, инструментов или окружения, запуск Claude Code локально или использование [Remote Control](/ru/remote-control) — лучший вариант.24Для работы, которая требует вашей локальной конфигурации, инструментов или окружения, запуск Claude Code локально или использование [Remote Control](/docs/ru/remote-control) — лучший вариант.

25 25 

26<h2 id="how-sessions-run">26<h2 id="how-sessions-run">

27 Как работают сеансы27 Как работают сеансы


29 29 

30Когда вы отправляете задачу:30Когда вы отправляете задачу:

31 31 

321. **Клонирование и подготовка**: ваш репозиторий клонируется на управляемую Anthropic ВМ, и ваш [скрипт настройки](/ru/claude-code-on-the-web#setup-scripts) запускается, если он настроен.321. **Клонирование и подготовка**: ваш репозиторий клонируется на управляемую Anthropic ВМ, и ваш [скрипт настройки](/docs/ru/claude-code-on-the-web#setup-scripts) запускается, если он настроен.

332. **Настройка сети**: доступ в интернет устанавливается на основе [уровня доступа](/ru/claude-code-on-the-web#access-levels) вашего окружения.332. **Настройка сети**: доступ в интернет устанавливается на основе [уровня доступа](/docs/ru/claude-code-on-the-web#access-levels) вашего окружения.

343. **Работа**: Claude анализирует код, вносит изменения, запускает тесты и проверяет свою работу. Вы можете наблюдать и управлять на протяжении всего процесса или отойти и вернуться, когда это будет сделано.343. **Работа**: Claude анализирует код, вносит изменения, запускает тесты и проверяет свою работу. Вы можете наблюдать и управлять на протяжении всего процесса или отойти и вернуться, когда это будет сделано.

354. **Отправка ветки**: когда Claude достигает точки остановки, он отправляет свою ветку на GitHub. Вы просматриваете diff, оставляете встроенные комментарии, создаете PR или отправляете еще одно сообщение, чтобы продолжить.354. **Отправка ветки**: когда Claude достигает точки остановки, он отправляет свою ветку на GitHub. Вы просматриваете diff, оставляете встроенные комментарии, создаете PR или отправляете еще одно сообщение, чтобы продолжить.

36 36 


47| **Код выполняется на** | Облачной ВМ Anthropic | Вашей машине | Вашей машине | Вашей машине или облачной ВМ |47| **Код выполняется на** | Облачной ВМ Anthropic | Вашей машине | Вашей машине | Вашей машине или облачной ВМ |

48| **Вы общаетесь с** | claude.ai или мобильного приложения | claude.ai или мобильного приложения | Вашего терминала | Интерфейса Desktop |48| **Вы общаетесь с** | claude.ai или мобильного приложения | claude.ai или мобильного приложения | Вашего терминала | Интерфейса Desktop |

49| **Использует вашу локальную конфигурацию** | Нет, только репозиторий | Да | Да | Да для локального, нет для облачного |49| **Использует вашу локальную конфигурацию** | Нет, только репозиторий | Да | Да | Да для локального, нет для облачного |

50| **Требует GitHub** | Да, или [отправьте локальный репозиторий](/ru/claude-code-on-the-web#send-local-repositories-without-github) через `--cloud` | Нет | Нет | Только для облачных сеансов |50| **Требует GitHub** | Да, или [отправьте локальный репозиторий](/docs/ru/claude-code-on-the-web#send-local-repositories-without-github) через `--cloud` | Нет | Нет | Только для облачных сеансов |

51| **Продолжает работать при отключении** | Да | Пока терминал остается открытым | Нет | Зависит от типа сеанса |51| **Продолжает работать при отключении** | Да | Пока терминал остается открытым | Нет | Зависит от типа сеанса |

52| **[Режимы разрешений](/ru/permission-modes)** | Принять правки, Plan, Auto | Спросить, Автоматическое принятие правок, Plan | Все режимы | Зависит от типа сеанса |52| **[Режимы разрешений](/docs/ru/permission-modes)** | Принять правки, Plan, Auto | Спросить, Автоматическое принятие правок, Plan | Все режимы | Зависит от типа сеанса |

53| **Доступ в сеть** | Настраивается для каждого окружения | Сеть вашей машины | Сеть вашей машины | Зависит от типа сеанса |53| **Доступ в сеть** | Настраивается для каждого окружения | Сеть вашей машины | Сеть вашей машины | Зависит от типа сеанса |

54 54 

55Смотрите документацию [быстрого старта терминала](/ru/quickstart), [приложения Desktop](/ru/desktop) или [Remote Control](/ru/remote-control) для их настройки.55Смотрите документацию [быстрого старта терминала](/docs/ru/quickstart), [приложения Desktop](/docs/ru/desktop) или [Remote Control](/docs/ru/remote-control) для их настройки.

56 56 

57<h2 id="connect-github-and-create-an-environment">57<h2 id="connect-github-and-create-an-environment">

58 Подключение GitHub и создание окружения58 Подключение GitHub и создание окружения


70 </Step>70 </Step>

71 71 

72 <Step title="Создайте ваше окружение">72 <Step title="Создайте ваше окружение">

73 После подключения GitHub вам будет предложено создать облачное окружение. Окружение контролирует, какой доступ в сеть имеет Claude во время сеансов и что запускается при создании нового сеанса. Смотрите [Установленные инструменты](/ru/claude-code-on-the-web#installed-tools) для того, что доступно без какой-либо конфигурации.73 После подключения GitHub вам будет предложено создать облачное окружение. Окружение контролирует, какой доступ в сеть имеет Claude во время сеансов и что запускается при создании нового сеанса. Смотрите [Установленные инструменты](/docs/ru/claude-code-on-the-web#installed-tools) для того, что доступно без какой-либо конфигурации.

74 74 

75 Форма содержит эти поля:75 Форма содержит эти поля:

76 76 

77 * **Name**: метка отображения. Полезно, когда у вас есть несколько окружений для разных проектов или уровней доступа.77 * **Name**: метка отображения. Полезно, когда у вас есть несколько окружений для разных проектов или уровней доступа.

78 * **Network access**: контролирует, что сеанс может достичь в интернете. По умолчанию `Trusted` позволяет подключения к [общим реестрам пакетов](/ru/claude-code-on-the-web#default-allowed-domains) как npm, PyPI и RubyGems, блокируя общий доступ в интернет.78 * **Network access**: контролирует, что сеанс может достичь в интернете. По умолчанию `Trusted` позволяет подключения к [общим реестрам пакетов](/docs/ru/claude-code-on-the-web#default-allowed-domains) как npm, PyPI и RubyGems, блокируя общий доступ в интернет.

79 * **Environment variables**: необязательные переменные, доступные в каждом сеансе, в формате `.env`. Не оборачивайте значения в кавычки, так как кавычки сохраняются как часть значения. Они видны всем, кто может редактировать это окружение.79 * **Environment variables**: необязательные переменные, доступные в каждом сеансе, в формате `.env`. Не оборачивайте значения в кавычки, так как кавычки сохраняются как часть значения. Они видны всем, кто может редактировать это окружение.

80 * **Setup script**: необязательный Bash скрипт, который запускается перед запуском Claude Code. Используйте его для установки системных инструментов, которые облачная ВМ не включает, например `apt install -y gh`. Результат [кэшируется](/ru/claude-code-on-the-web#environment-caching), поэтому скрипт не переустанавливается в каждом сеансе. Смотрите [Скрипты настройки](/ru/claude-code-on-the-web#setup-scripts) для примеров и советов по отладке.80 * **Setup script**: необязательный Bash скрипт, который запускается перед запуском Claude Code. Используйте его для установки системных инструментов, которые облачная ВМ не включает, например `apt install -y gh`. Результат [кэшируется](/docs/ru/claude-code-on-the-web#environment-caching), поэтому скрипт не переустанавливается в каждом сеансе. Смотрите [Скрипты настройки](/docs/ru/claude-code-on-the-web#setup-scripts) для примеров и советов по отладке.

81 81 

82 Для первого проекта оставьте значения по умолчанию и нажмите **Create environment**. Вы можете [отредактировать его позже или создать дополнительные окружения](/ru/claude-code-on-the-web#configure-your-environment) для разных проектов.82 Для первого проекта оставьте значения по умолчанию и нажмите **Create environment**. Вы можете [отредактировать его позже или создать дополнительные окружения](/docs/ru/claude-code-on-the-web#configure-your-environment) для разных проектов.

83 </Step>83 </Step>

84</Steps>84</Steps>

85 85 


87 Подключение из терминала87 Подключение из терминала

88</h3>88</h3>

89 89 

90Если вы уже используете GitHub CLI (`gh`), вы можете настроить Claude Code в веб-версии без открытия браузера. Это требует [Claude Code CLI](/ru/quickstart). `/web-setup` читает ваш локальный токен `gh`, связывает его с вашей учетной записью Claude и создает облачное окружение по умолчанию, если у вас его нет.90Если вы уже используете GitHub CLI (`gh`), вы можете настроить Claude Code в веб-версии без открытия браузера. Это требует [Claude Code CLI](/docs/ru/quickstart). `/web-setup` читает ваш локальный токен `gh`, связывает его с вашей учетной записью Claude и создает облачное окружение по умолчанию, если у вас его нет.

91 91 

92<Note>92<Note>

93 Организации с включенным [Zero Data Retention](/ru/zero-data-retention) не могут использовать `/web-setup` или другие функции облачных сеансов. Если GitHub CLI не установлен или не аутентифицирован, `/web-setup` открывает поток встроенной настройки браузера.93 Организации с включенным [Zero Data Retention](/docs/ru/zero-data-retention) не могут использовать `/web-setup` или другие функции облачных сеансов. Если GitHub CLI не установлен или не аутентифицирован, `/web-setup` открывает поток встроенной настройки браузера.

94</Note>94</Note>

95 95 

96<Steps>96<Steps>


113 /web-setup113 /web-setup

114 ```114 ```

115 115 

116 Это синхронизирует ваш токен `gh` с вашей учетной записью Claude. Если у вас еще нет облачного окружения, `/web-setup` создает его с доступом в сеть Trusted и без скрипта настройки. Вы можете [отредактировать окружение или добавить переменные](/ru/claude-code-on-the-web#configure-your-environment) позже. После завершения `/web-setup` вы можете запускать облачные сеансы из терминала с помощью [`--cloud`](/ru/claude-code-on-the-web#from-terminal-to-web) или настроить повторяющиеся задачи с помощью [`/schedule`](/ru/routines).116 Это синхронизирует ваш токен `gh` с вашей учетной записью Claude. Если у вас еще нет облачного окружения, `/web-setup` создает его с доступом в сеть Trusted и без скрипта настройки. Вы можете [отредактировать окружение или добавить переменные](/docs/ru/claude-code-on-the-web#configure-your-environment) позже. После завершения `/web-setup` вы можете запускать облачные сеансы из терминала с помощью [`--cloud`](/docs/ru/claude-code-on-the-web#from-terminal-to-web) или настроить повторяющиеся задачи с помощью [`/schedule`](/docs/ru/routines).

117 </Step>117 </Step>

118</Steps>118</Steps>

119 119 


129 </Step>129 </Step>

130 130 

131 <Step title="Выберите режим разрешений">131 <Step title="Выберите режим разрешений">

132 Раскрывающееся меню режима рядом с вводом по умолчанию установлено на **Accept edits**, где Claude вносит изменения и отправляет ветку без остановки для одобрения. Переключитесь на **Plan Mode**, если вы хотите, чтобы Claude предложил подход и дождался вашего одобрения перед редактированием файлов. Облачные сеансы не предлагают разрешения Manual или разрешения Bypass. Смотрите [полный список режимов разрешений](/ru/permission-modes#available-modes) для того, что позволяет каждый из них.132 Раскрывающееся меню режима рядом с вводом по умолчанию установлено на **Accept edits**, где Claude вносит изменения и отправляет ветку без остановки для одобрения. Переключитесь на **Plan Mode**, если вы хотите, чтобы Claude предложил подход и дождался вашего одобрения перед редактированием файлов. Облачные сеансы не предлагают разрешения Manual или разрешения Bypass. Смотрите [полный список режимов разрешений](/docs/ru/permission-modes#available-modes) для того, что позволяет каждый из них.

133 </Step>133 </Step>

134 134 

135 <Step title="Опишите задачу и отправьте">135 <Step title="Опишите задачу и отправьте">


182 </Step>182 </Step>

183 183 

184 <Step title="Продолжайте итерацию после PR">184 <Step title="Продолжайте итерацию после PR">

185 Сеанс остается активным после создания PR. Вставьте вывод ошибки CI или комментарии рецензента в чат и попросите Claude их решить. Чтобы Claude автоматически отслеживал PR, смотрите [Auto-fix pull requests](/ru/claude-code-on-the-web#auto-fix-pull-requests).185 Сеанс остается активным после создания PR. Вставьте вывод ошибки CI или комментарии рецензента в чат и попросите Claude их решить. Чтобы Claude автоматически отслеживал PR, смотрите [Auto-fix pull requests](/docs/ru/claude-code-on-the-web#auto-fix-pull-requests).

186 </Step>186 </Step>

187</Steps>187</Steps>

188 188 


194 После подключения GitHub не появляются репозитории194 После подключения GitHub не появляются репозитории

195</h3>195</h3>

196 196 

197Облачный сеанс может использовать любой репозиторий, который подключенная учетная запись GitHub может видеть, независимо от того, на каких репозиториях установлено приложение Claude GitHub. Если репозиторий отсутствует, убедитесь, что подключенная учетная запись GitHub имеет доступ к нему на GitHub. Если вы также хотите [Auto-fix](/ru/claude-code-on-the-web#auto-fix-pull-requests) для репозитория, установите приложение на него: на github.com откройте **Settings → Applications → Claude → Configure** и убедитесь, что репозиторий указан в **Repository access**. Приватные репозитории требуют такой же авторизации, как и публичные.197Облачный сеанс может использовать любой репозиторий, который подключенная учетная запись GitHub может видеть, независимо от того, на каких репозиториях установлено приложение Claude GitHub. Если репозиторий отсутствует, убедитесь, что подключенная учетная запись GitHub имеет доступ к нему на GitHub. Если вы также хотите [Auto-fix](/docs/ru/claude-code-on-the-web#auto-fix-pull-requests) для репозитория, установите приложение на него: на github.com откройте **Settings → Applications → Claude → Configure** и убедитесь, что репозиторий указан в **Repository access**. Приватные репозитории требуют такой же авторизации, как и публичные.

198 198 

199<h3 id="the-page-only-shows-a-github-login-button">199<h3 id="the-page-only-shows-a-github-login-button">

200 На странице отображается только кнопка входа GitHub200 На странице отображается только кнопка входа GitHub

201</h3>201</h3>

202 202 

203Облачные сеансы требуют подключенной учетной записи GitHub. Подключитесь через поток браузера выше или запустите `/web-setup` из терминала, если вы используете GitHub CLI. Если вы предпочитаете вообще не подключать GitHub, смотрите [Remote Control](/ru/remote-control) для запуска Claude Code на вашей машине и мониторинга его из веб-версии.203Облачные сеансы требуют подключенной учетной записи GitHub. Подключитесь через поток браузера выше или запустите `/web-setup` из терминала, если вы используете GitHub CLI. Если вы предпочитаете вообще не подключать GitHub, смотрите [Remote Control](/docs/ru/remote-control) для запуска Claude Code на вашей машине и мониторинга его из веб-версии.

204 204 

205<h3 id="not-available-for-the-selected-organization">205<h3 id="not-available-for-the-selected-organization">

206 "Not available for the selected organization"206 "Not available for the selected organization"


220 "Could not create a cloud environment" или "No cloud environment available" при использовании `--cloud` или ultraplan220 "Could not create a cloud environment" или "No cloud environment available" при использовании `--cloud` или ultraplan

221</h3>221</h3>

222 222 

223Функции удаленного сеанса автоматически создают облачное окружение по умолчанию, если у вас его нет. Если вы видите "Could not create a cloud environment", автоматическое создание не удалось. {/* max-version: 2.1.100 */}Если вы видите "No cloud environment available", ваш CLI предшествует автоматическому созданию. В любом случае запустите `/web-setup` в Claude Code CLI для создания вручную или посетите [claude.ai/code](https://claude.ai/code) и следуйте шагу **Create your environment** выше.223Функции удаленного сеанса автоматически создают облачное окружение по умолчанию, если у вас его нет. Если вы видите "Could not create a cloud environment", автоматическое создание не удалось. Если вы видите "No cloud environment available", ваш CLI предшествует автоматическому созданию. В любом случае запустите `/web-setup` в Claude Code CLI для создания вручную или посетите [claude.ai/code](https://claude.ai/code) и следуйте шагу **Create your environment** выше.

224 224 

225<h3 id="setup-script-failed">225<h3 id="setup-script-failed">

226 Скрипт настройки не удался226 Скрипт настройки не удался


228 228 

229Скрипт настройки завершился с ненулевым статусом, что блокирует запуск сеанса. Распространенные причины:229Скрипт настройки завершился с ненулевым статусом, что блокирует запуск сеанса. Распространенные причины:

230 230 

231* Установка пакета не удалась, потому что реестр не находится на вашем [уровне доступа в сеть](/ru/claude-code-on-the-web#access-levels). `Trusted` охватывает большинство менеджеров пакетов; `None` блокирует их все.231* Установка пакета не удалась, потому что реестр не находится на вашем [уровне доступа в сеть](/docs/ru/claude-code-on-the-web#access-levels). `Trusted` охватывает большинство менеджеров пакетов; `None` блокирует их все.

232* Скрипт ссылается на файл или путь, который не существует в свежем клоне.232* Скрипт ссылается на файл или путь, который не существует в свежем клоне.

233* Команда, которая работает локально, требует другого вызова на Ubuntu.233* Команда, которая работает локально, требует другого вызова на Ubuntu.

234 234 


238 Новые сеансы зависают или истекает время ожидания во время настройки238 Новые сеансы зависают или истекает время ожидания во время настройки

239</h3>239</h3>

240 240 

241Если новые сеансы зависают на шаге скрипта настройки или не удаются с общей ошибкой контейнера перед завершением скрипта, скрипт, вероятно, превышает примерно пятиминутный бюджет времени для построения [кэша окружения](/ru/claude-code-on-the-web#environment-caching). Тяжелые шаги, такие как извлечение больших образов Docker, синхронизация полных деревьев зависимостей или загрузка весов модели, часто превышают лимит, особенно когда они выполняются один за другим.241Если новые сеансы зависают на шаге скрипта настройки или не удаются с общей ошибкой контейнера перед завершением скрипта, скрипт, вероятно, превышает примерно пятиминутный бюджет времени для построения [кэша окружения](/docs/ru/claude-code-on-the-web#environment-caching). Тяжелые шаги, такие как извлечение больших образов Docker, синхронизация полных деревьев зависимостей или загрузка весов модели, часто превышают лимит, особенно когда они выполняются один за другим.

242 242 

243Чтобы исправить это, обрежьте скрипт так, чтобы он надежно завершался менее чем за пять минут:243Чтобы исправить это, обрежьте скрипт так, чтобы он надежно завершался менее чем за пять минут:

244 244 

245* Запускайте независимые установки параллельно с `&` и финальным `wait` вместо их последовательного выполнения.245* Запускайте независимые установки параллельно с `&` и финальным `wait` вместо их последовательного выполнения.

246* Переместите самые большие загрузки из скрипта настройки в [SessionStart hook](/ru/claude-code-on-the-web#setup-scripts-vs-sessionstart-hooks), который запускает их в фоновом режиме, чтобы сеанс стал пригодным для использования, пока они завершаются.246* Переместите самые большие загрузки из скрипта настройки в [SessionStart hook](/docs/ru/claude-code-on-the-web#setup-scripts-vs-sessionstart-hooks), который запускает их в фоновом режиме, чтобы сеанс стал пригодным для использования, пока они завершаются.

247* Удалите длинные повторные попытки сна из скрипта настройки, так как зависший цикл повторных попыток учитывается в бюджете.247* Удалите длинные повторные попытки сна из скрипта настройки, так как зависший цикл повторных попыток учитывается в бюджете.

248 248 

249<h3 id="session-keeps-running-after-closing-the-tab">249<h3 id="session-keeps-running-after-closing-the-tab">

250 Сеанс продолжает работать после закрытия вкладки250 Сеанс продолжает работать после закрытия вкладки

251</h3>251</h3>

252 252 

253Это сделано специально. Закрытие вкладки или навигация не останавливает сеанс. Он продолжает работать в фоновом режиме до тех пор, пока Claude не закончит текущую задачу, затем переходит в режим ожидания. На боковой панели вы можете [архивировать сеанс](/ru/claude-code-on-the-web#archive-sessions), чтобы скрыть его из списка, или [удалить его](/ru/claude-code-on-the-web#delete-sessions), чтобы удалить его навсегда.253Это сделано специально. Закрытие вкладки или навигация не останавливает сеанс. Он продолжает работать в фоновом режиме до тех пор, пока Claude не закончит текущую задачу, затем переходит в режим ожидания. На боковой панели вы можете [архивировать сеанс](/docs/ru/claude-code-on-the-web#archive-sessions), чтобы скрыть его из списка, или [удалить его](/docs/ru/claude-code-on-the-web#delete-sessions), чтобы удалить его навсегда.

254 254 

255<h2 id="next-steps">255<h2 id="next-steps">

256 Следующие шаги256 Следующие шаги


258 258 

259Теперь, когда вы можете отправлять и просматривать задачи, эти страницы охватывают, что дальше: запуск облачных сеансов из терминала, планирование повторяющейся работы и предоставление Claude постоянных инструкций.259Теперь, когда вы можете отправлять и просматривать задачи, эти страницы охватывают, что дальше: запуск облачных сеансов из терминала, планирование повторяющейся работы и предоставление Claude постоянных инструкций.

260 260 

261* [Использование Claude Code в веб-версии](/ru/claude-code-on-the-web): полный справочник, включая телепортацию сеансов в ваш терминал, скрипты настройки, переменные окружения и конфигурацию сети261* [Использование Claude Code в веб-версии](/docs/ru/claude-code-on-the-web): полный справочник, включая телепортацию сеансов в ваш терминал, скрипты настройки, переменные окружения и конфигурацию сети

262* [Routines](/ru/routines): автоматизируйте работу по расписанию, через вызов API или в ответ на события GitHub262* [Routines](/docs/ru/routines): автоматизируйте работу по расписанию, через вызов API или в ответ на события GitHub

263* [CLAUDE.md](/ru/memory): дайте Claude постоянные инструкции и контекст, которые загружаются в начале каждого сеанса263* [CLAUDE.md](/docs/ru/memory): дайте Claude постоянные инструкции и контекст, которые загружаются в начале каждого сеанса

264* Установите мобильное приложение Claude для [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) или [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) для мониторинга сеансов с телефона. Из Claude Code CLI `/mobile` показывает QR-код.264* Установите мобильное приложение Claude для [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) или [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) для мониторинга сеансов с телефона. Из Claude Code CLI `/mobile` показывает QR-код.

workflows.md +19 −21

Details

6 6 

7> Dynamic workflows оркестрируют множество подагентов из скрипта, который пишет Claude, и вы можете его переиспользовать. Используйте их для аудитов кодовой базы, крупных миграций и перекрёстной проверки исследований.7> Dynamic workflows оркестрируют множество подагентов из скрипта, который пишет Claude, и вы можете его переиспользовать. Используйте их для аудитов кодовой базы, крупных миграций и перекрёстной проверки исследований.

8 8 

9{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}

10 

11<Note>9<Note>

12 Dynamic workflows требуют Claude Code v2.1.154 или позже и доступны на всех платных планах, с доступом к Anthropic API, а также на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. На Pro включите их из строки Dynamic workflows в `/config`.10 Dynamic workflows требуют Claude Code v2.1.154 или позже и доступны на всех платных планах, с доступом к Anthropic API, а также на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. На Pro включите их из строки Dynamic workflows в `/config`.

13</Note>11</Note>

14 12 

15Dynamic workflow — это JavaScript-скрипт, который оркестрирует [подагентов](/ru/sub-agents) в масштабе. Claude пишет скрипт для описанной вами задачи, а runtime выполняет его в фоне, пока ваша сессия остаётся отзывчивой.13Dynamic workflow — это JavaScript-скрипт, который оркестрирует [подагентов](/docs/ru/sub-agents) в масштабе. Claude пишет скрипт для описанной вами задачи, а runtime выполняет его в фоне, пока ваша сессия остаётся отзывчивой.

16 14 

17Используйте workflow, когда задача требует больше агентов, чем может координировать одна беседа, или когда вы хотите, чтобы оркестрация была закодирована в скрипт, который вы можете прочитать и переиспользовать. Примеры включают сквозную проверку кодовой базы на ошибки, миграцию 500 файлов, исследовательский вопрос, который требует перекрёстной проверки источников друг против друга, и сложный план, стоящий того, чтобы его разработать с нескольких независимых углов перед тем, как вы примете решение.15Используйте workflow, когда задача требует больше агентов, чем может координировать одна беседа, или когда вы хотите, чтобы оркестрация была закодирована в скрипт, который вы можете прочитать и переиспользовать. Примеры включают сквозную проверку кодовой базы на ошибки, миграцию 500 файлов, исследовательский вопрос, который требует перекрёстной проверки источников друг против друга, и сложный план, стоящий того, чтобы его разработать с нескольких независимых углов перед тем, как вы примете решение.

18 16 


20 Когда использовать workflow18 Когда использовать workflow

21</h2>19</h2>

22 20 

23[Подагенты](/ru/sub-agents), [skills](/ru/skills), [команды агентов](/ru/agent-teams) и workflows могут все запустить многошаговую задачу. Разница в том, кто держит план:21[Подагенты](/docs/ru/sub-agents), [skills](/docs/ru/skills), [команды агентов](/docs/ru/agent-teams) и workflows могут все запустить многошаговую задачу. Разница в том, кто держит план:

24 22 

25| | Подагенты | Skills | Команды агентов | Workflows |23| | Подагенты | Skills | Команды агентов | Workflows |

26| :--------------------------------- | :------------------------------------ | :--------------------------------- | :------------------------------------------ | :-------------------------------- |24| :--------------------------------- | :------------------------------------ | :--------------------------------- | :------------------------------------------ | :-------------------------------- |


69 <Step title="Прочитать отчёт">67 <Step title="Прочитать отчёт">

70 Когда запуск завершится, отчёт попадает в вашу сессию. Он цитирует источники, из которых каждое утверждение пришло, с утверждениями, которые не пережили перекрёстную проверку, уже отфильтрованными.68 Когда запуск завершится, отчёт попадает в вашу сессию. Он цитирует источники, из которых каждое утверждение пришло, с утверждениями, которые не пережили перекрёстную проверку, уже отфильтрованными.

71 69 

72 {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, когда агенты-верификаторы не могут проверить утверждение, например после ограничения скорости или ошибки API, отчёт указывает это утверждение как непроверенное вместо того, чтобы считать его опровергнутым.70 Начиная с версии 2.1.196, когда агенты-верификаторы не могут проверить утверждение, например после ограничения скорости или ошибки API, отчёт указывает это утверждение как непроверенное вместо того, чтобы считать его опровергнутым.

73 </Step>71 </Step>

74</Steps>72</Steps>

75 73 


83 81 

84| Команда | Что она делает |82| Команда | Что она делает |

85| :-------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :-------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

86| `/deep-research <question>` | Распределяет веб-поиски по вопросу по нескольким углам, получает и перекрёстно проверяет найденные источники, голосует по каждому утверждению и возвращает цитируемый отчёт с утверждениями, которые не пережили перекрёстную проверку, отфильтрованными. Требует, чтобы инструмент [WebSearch](/ru/tools-reference#websearch-tool-behavior) был доступен |84| `/deep-research <question>` | Распределяет веб-поиски по вопросу по нескольким углам, получает и перекрёстно проверяет найденные источники, голосует по каждому утверждению и возвращает цитируемый отчёт с утверждениями, которые не пережили перекрёстную проверку, отфильтрованными. Требует, чтобы инструмент [WebSearch](/docs/ru/tools-reference#websearch-tool-behavior) был доступен |

87 85 

88[Workflows, которые вы сохраняете](#save-the-workflow-for-reuse) сами, становятся командами таким же образом и появляются в автодополнении `/` рядом с встроенными.86[Workflows, которые вы сохраняете](#save-the-workflow-for-reuse) сами, становятся командами таким же образом и появляются в автодополнении `/` рядом с встроенными.

89 87 


105| `Enter` или `→` | Углубиться в выбранную фазу, затем в агента для чтения его подсказки, недавних вызовов инструментов и результата |103| `Enter` или `→` | Углубиться в выбранную фазу, затем в агента для чтения его подсказки, недавних вызовов инструментов и результата |

106| `Esc` или `←` | Вернуться на один уровень назад. В версиях v2.1.203 по v2.1.205 `←` не позволял вернуться из фазы или агента; используйте `Esc` на этих версиях |104| `Esc` или `←` | Вернуться на один уровень назад. В версиях v2.1.203 по v2.1.205 `←` не позволял вернуться из фазы или агента; используйте `Esc` на этих версиях |

107| `j` / `k` | Прокручивать в деталях агента, когда это переполняется |105| `j` / `k` | Прокручивать в деталях агента, когда это переполняется |

108| `f` | {/* min-version: 2.1.186 */}Фильтровать список агентов в выбранной фазе по статусу. Нажмите снова для циклирования |106| `f` | Фильтровать список агентов в выбранной фазе по статусу. Нажмите снова для циклирования |

109| `p` | Приостановить или возобновить запуск |107| `p` | Приостановить или возобновить запуск |

110| `x` | Остановить выбранного агента или остановить весь workflow, когда фокус находится на запуске |108| `x` | Остановить выбранного агента или остановить весь workflow, когда фокус находится на запуске |

111| `r` | Перезапустить выбранного работающего агента |109| `r` | Перезапустить выбранного работающего агента |


142 Позволить Claude решить с ultracode140 Позволить Claude решить с ultracode

143</h3>141</h3>

144 142 

145Ultracode — это параметр Claude Code, который объединяет `xhigh` [усилие рассуждения](/ru/model-config#adjust-effort-level) с автоматической оркестрацией workflow. С ним включённым, Claude планирует workflow для каждой существенной задачи вместо того, чтобы ждать, пока вы попросите.143Ultracode — это параметр Claude Code, который объединяет `xhigh` [усилие рассуждения](/docs/ru/model-config#adjust-effort-level) с автоматической оркестрацией workflow. С ним включённым, Claude планирует workflow для каждой существенной задачи вместо того, чтобы ждать, пока вы попросите.

146 144 

147```text theme={null}145```text theme={null}

148/effort ultracode146/effort ultracode


152 150 

153С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий.151С ultracode включённым, Claude решает, когда задача требует workflow. Один запрос может превратиться в несколько workflows подряд: один для понимания кода, один для внесения изменения и один для его проверки. Это применяется к каждой задаче в сессии, поэтому каждый запрос использует больше токенов и занимает больше времени, чем на более низких уровнях усилий.

154 152 

155Ultracode длится для текущей сессии и сбрасывается, когда вы начинаете новую. Вернитесь с `/effort high`, когда вы вернётесь к рутинной работе. Это доступно на моделях, которые поддерживают `xhigh` [усилие](/ru/model-config#adjust-effort-level); на других моделях меню `/effort` не предлагает это.153Ultracode длится для текущей сессии и сбрасывается, когда вы начинаете новую. Вернитесь с `/effort high`, когда вы вернётесь к рутинной работе. Это доступно на моделях, которые поддерживают `xhigh` [усилие](/docs/ru/model-config#adjust-effort-level); на других моделях меню `/effort` не предлагает это.

156 154 

157<h3 id="approve-the-plan-before-it-runs">155<h3 id="approve-the-plan-before-it-runs">

158 Одобрить план перед его запуском156 Одобрить план перед его запуском


167 165 

168`Ctrl+G` открывает скрипт в вашем редакторе. `Tab` позволяет вам отрегулировать подсказку перед запуском.166`Ctrl+G` открывает скрипт в вашем редакторе. `Tab` позволяет вам отрегулировать подсказку перед запуском.

169 167 

170Видите ли вы эту подсказку, зависит от вашего [режима разрешений](/ru/permission-modes):168Видите ли вы эту подсказку, зависит от вашего [режима разрешений](/docs/ru/permission-modes):

171 169 

172| Режим разрешений | Когда вас спрашивают |170| Режим разрешений | Когда вас спрашивают |

173| :----------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |171| :----------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


177 175 

178В приложении Desktop карточка одобрения показывает имя workflow, список фаз и предупреждение об использовании токенов, с действиями **Once**, **Always** и **Deny**. Представление прогресса появляется в боковой панели Background tasks.176В приложении Desktop карточка одобрения показывает имя workflow, список фаз и предупреждение об использовании токенов, с действиями **Once**, **Always** и **Deny**. Представление прогресса появляется в боковой панели Background tasks.

179 177 

180Ваш режим разрешений контролирует только подсказку запуска выше. Подагенты, которые создаёт workflow, всегда работают в режиме `acceptEdits` и наследуют ваш [список разрешённых инструментов](/ru/settings#permission-settings), независимо от режима вашей сессии. Редактирования файлов автоматически одобрены.178Ваш режим разрешений контролирует только подсказку запуска выше. Подагенты, которые создаёт workflow, всегда работают в режиме `acceptEdits` и наследуют ваш [список разрешённых инструментов](/docs/ru/settings#permission-settings), независимо от режима вашей сессии. Редактирования файлов автоматически одобрены.

181 179 

182Команды shell, веб-выборки и MCP-инструменты, которые не в вашем списке разрешённых, всё ещё могут вас спросить во время запуска. Чтобы избежать этого на длительном запуске, добавьте команды, которые нужны агентам, в ваш список разрешённых перед запуском.180Команды shell, веб-выборки и MCP-инструменты, которые не в вашем списке разрешённых, всё ещё могут вас спросить во время запуска. Чтобы избежать этого на длительном запуске, добавьте команды, которые нужны агентам, в ваш список разрешённых перед запуском.

183 181 


192Запустите `/workflows`, выберите запуск, который вы хотите сохранить, и нажмите `s`. В диалоге сохранения Tab переключается между двумя местами сохранения:190Запустите `/workflows`, выберите запуск, который вы хотите сохранить, и нажмите `s`. В диалоге сохранения Tab переключается между двумя местами сохранения:

193 191 

194* `.claude/workflows/` в вашем проекте: общее с каждым, кто клонирует репо192* `.claude/workflows/` в вашем проекте: общее с каждым, кто клонирует репо

195* `~/.claude/workflows/` в вашем домашнем каталоге: доступно в каждом проекте, видимо только вам. Если вы установили [`CLAUDE_CONFIG_DIR`](/ru/env-vars), это местоположение — это каталог `workflows/` под этим путём.193* `~/.claude/workflows/` в вашем домашнем каталоге: доступно в каждом проекте, видимо только вам. Если вы установили [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars), это местоположение — это каталог `workflows/` под этим путём.

196 194 

197{/* min-version: 2.1.208 */}Диалог сохранения показывает разрешённый путь для личного местоположения. До версии 2.1.208 он показывал `~/.claude/workflows/` даже когда был установлен `CLAUDE_CONFIG_DIR`; файл всё ещё сохранялся под настроенным каталогом.195Диалог сохранения показывает разрешённый путь для личного местоположения. До версии 2.1.208 он показывал `~/.claude/workflows/` даже когда был установлен `CLAUDE_CONFIG_DIR`; файл всё ещё сохранялся под настроенным каталогом.

198 196 

199Нажмите Enter для сохранения. Workflow запускается как `/<name>` в будущих сессиях из любого места.197Нажмите Enter для сохранения. Workflow запускается как `/<name>` в будущих сессиях из любого места.

200 198 

201{/* min-version: 2.1.178 */}В монорепо с несколькими каталогами `.claude/` вы можете хранить workflows рядом с пакетом, к которому они применяются. Начиная с версии 2.1.178, сохранение в местоположение проекта записывает в ближайший каталог `.claude/workflows/`, который уже существует между вашей рабочей директорией и корнем репозитория, или в корень репозитория, если ни один ещё не существует. Workflows проекта также загружаются из каждого `.claude/workflows/` вдоль этого пути, и когда более одного определяет одно имя, Claude Code запускает тот, который ближе всего к рабочей директории.199В монорепо с несколькими каталогами `.claude/` вы можете хранить workflows рядом с пакетом, к которому они применяются. Начиная с версии 2.1.178, сохранение в местоположение проекта записывает в ближайший каталог `.claude/workflows/`, который уже существует между вашей рабочей директорией и корнем репозитория, или в корень репозитория, если ни один ещё не существует. Workflows проекта также загружаются из каждого `.claude/workflows/` вдоль этого пути, и когда более одного определяет одно имя, Claude Code запускает тот, который ближе всего к рабочей директории.

202 200 

203Если project workflow и personal workflow имеют одно имя, запускается project.201Если project workflow и personal workflow имеют одно имя, запускается project.

204 202 


305return audits.filter(Boolean)303return audits.filter(Boolean)

306```304```

307 305 

308Тело — это простой JavaScript с top-level `await`. `agent()` создаёт один подагент и `pipeline()` запускает один на элемент в списке. Если вы хотите отредактировать скрипт вручную, попросите Claude провести вас через изменение, или смотрите запись инструмента Workflow в [справочнике Agent SDK](/ru/agent-sdk/typescript) для полного набора опций.306Тело — это простой JavaScript с top-level `await`. `agent()` создаёт один подагент и `pipeline()` запускает один на элемент в списке. Если вы хотите отредактировать скрипт вручную, попросите Claude провести вас через изменение, или смотрите запись инструмента Workflow в [справочнике Agent SDK](/docs/ru/agent-sdk/typescript) для полного набора опций.

309 307 

310<h2 id="how-a-workflow-runs">308<h2 id="how-a-workflow-runs">

311 Как работает workflow309 Как работает workflow


359* Если вы [установите рекомендацию по размеру](#set-a-size-guideline), количество агентов рекомендации заменяет порог в 25 агентов.357* Если вы [установите рекомендацию по размеру](#set-a-size-guideline), количество агентов рекомендации заменяет порог в 25 агентов.

360* Сессии с включённым [ultracode](#let-claude-decide-with-ultracode) не показывают предупреждение, потому что включение ultracode уже означает согласие на крупные запуски.358* Сессии с включённым [ultracode](#let-claude-decide-with-ultracode) не показывают предупреждение, потому что включение ultracode уже означает согласие на крупные запуски.

361 359 

362Каждый агент в workflow использует модель вашей сессии, если скрипт не маршрутизирует этап на другую или переменная окружения [`CLAUDE_CODE_SUBAGENT_MODEL`](/ru/model-config#environment-variables) не установлена, что переопределяет оба варианта. Чтобы контролировать стоимость модели:360Каждый агент в workflow использует модель вашей сессии, если скрипт не маршрутизирует этап на другую или переменная окружения [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ru/model-config#environment-variables) не установлена, что переопределяет оба варианта. Чтобы контролировать стоимость модели:

363 361 

364* Проверьте `/model` перед крупным запуском, если вы обычно переключаетесь на меньшую модель для рутинной работы362* Проверьте `/model` перед крупным запуском, если вы обычно переключаетесь на меньшую модель для рутинной работы

365* Попросите Claude использовать меньшую модель для этапов, которые не требуют самой сильной, когда вы описываете задачу363* Попросите Claude использовать меньшую модель для этапов, которые не требуют самой сильной, когда вы описываете задачу


385 Отключить workflows383 Отключить workflows

386</h3>384</h3>

387 385 

388Workflows доступны в CLI, приложении Desktop, расширениях IDE, [неинтерактивном режиме](/ru/headless) с `claude -p` и [Agent SDK](/ru/agent-sdk/overview). Те же параметры отключения применяются на каждой поверхности.386Workflows доступны в CLI, приложении Desktop, расширениях IDE, [неинтерактивном режиме](/docs/ru/headless) с `claude -p` и [Agent SDK](/docs/ru/agent-sdk/overview). Те же параметры отключения применяются на каждой поверхности.

389 387 

390Чтобы отключить workflows для себя:388Чтобы отключить workflows для себя:

391 389 


393* Установите `"disableWorkflows": true` в `~/.claude/settings.json`. Сохраняется между сессиями.391* Установите `"disableWorkflows": true` в `~/.claude/settings.json`. Сохраняется между сессиями.

394* Установите `CLAUDE_CODE_DISABLE_WORKFLOWS=1`. Читается при запуске, поэтому применяется везде, где вы это установите.392* Установите `CLAUDE_CODE_DISABLE_WORKFLOWS=1`. Читается при запуске, поэтому применяется везде, где вы это установите.

395 393 

396Чтобы отключить workflows для всей вашей организации, установите `"disableWorkflows": true` в [управляемые параметры](/ru/server-managed-settings), или используйте переключатель на странице [параметров администратора Claude Code](https://claude.ai/admin-settings/claude-code).394Чтобы отключить workflows для всей вашей организации, установите `"disableWorkflows": true` в [управляемые параметры](/docs/ru/server-managed-settings), или используйте переключатель на странице [параметров администратора Claude Code](https://claude.ai/admin-settings/claude-code).

397 395 

398Когда workflows отключены, встроенные команды workflow недоступны, ключевое слово `ultracode` больше не запускает запуск, и `ultracode` удаляется из меню `/effort`.396Когда workflows отключены, встроенные команды workflow недоступны, ключевое слово `ultracode` больше не запускает запуск, и `ultracode` удаляется из меню `/effort`.

399 397 


401 Связанные ресурсы399 Связанные ресурсы

402</h2>400</h2>

403 401 

404* [Запустить агентов параллельно](/ru/agents): сравнить подагентов, представление агента, команды агентов и workflows402* [Запустить агентов параллельно](/docs/ru/agents): сравнить подагентов, представление агента, команды агентов и workflows

405* [Создать пользовательские подагенты](/ru/sub-agents): примитив рабочего, который оркестрируют workflows403* [Создать пользовательские подагенты](/docs/ru/sub-agents): примитив рабочего, который оркестрируют workflows

406* [Управлять затратами](/ru/costs): как многоагентные запуски считаются в сторону ограничений использования404* [Управлять затратами](/docs/ru/costs): как многоагентные запуски считаются в сторону ограничений использования

worktrees.md +21 −21

Details

8 8 

9[git worktree](https://git-scm.com/docs/git-worktree) — это отдельный рабочий каталог с собственными файлами и веткой, использующий ту же историю репозитория и удалённый сервер, что и ваша основная копия. Запуск каждого сеанса Claude Code в собственном worktree означает, что правки в одном сеансе никогда не затрагивают файлы в другом, поэтому вы можете одновременно работать с Claude, который создаёт функцию в одном терминале и исправляет ошибку во втором.9[git worktree](https://git-scm.com/docs/git-worktree) — это отдельный рабочий каталог с собственными файлами и веткой, использующий ту же историю репозитория и удалённый сервер, что и ваша основная копия. Запуск каждого сеанса Claude Code в собственном worktree означает, что правки в одном сеансе никогда не затрагивают файлы в другом, поэтому вы можете одновременно работать с Claude, который создаёт функцию в одном терминале и исправляет ошибку во втором.

10 10 

11На этой странице рассматривается изоляция worktree в CLI. Всё ниже предполагает наличие git-репозитория. Для других систем контроля версий см. [Не-git системы контроля версий](#non-git-version-control). [Десктопное приложение](/ru/desktop#work-in-parallel-with-sessions) автоматически создаёт worktree для каждого нового сеанса.11На этой странице рассматривается изоляция worktree в CLI. Всё ниже предполагает наличие git-репозитория. Для других систем контроля версий см. [Не-git системы контроля версий](#non-git-version-control). [Десктопное приложение](/docs/ru/desktop#work-in-parallel-with-sessions) автоматически создаёт worktree для каждого нового сеанса.

12 12 

13Worktrees — один из нескольких способов запуска Claude параллельно. Они изолируют правки файлов, в то время как [subagents](/ru/sub-agents) и [agent teams](/ru/agent-teams) координируют саму работу. См. [Запуск агентов параллельно](/ru/agents), чтобы сравнить подходы, или перейдите к [Изолируйте subagents с помощью worktrees](#isolate-subagents-with-worktrees), чтобы использовать worktrees и subagents вместе.13Worktrees — один из нескольких способов запуска Claude параллельно. Они изолируют правки файлов, в то время как [subagents](/docs/ru/sub-agents) и [agent teams](/docs/ru/agent-teams) координируют саму работу. См. [Запуск агентов параллельно](/docs/ru/agents), чтобы сравнить подходы, или перейдите к [Изолируйте subagents с помощью worktrees](#isolate-subagents-with-worktrees), чтобы использовать worktrees и subagents вместе.

14 14 

15<h2 id="start-claude-in-a-worktree">15<h2 id="start-claude-in-a-worktree">

16 Запустите Claude в worktree16 Запустите Claude в worktree


34claude --worktree34claude --worktree

35```35```

36 36 

37Вы также можете попросить Claude "работать в worktree" во время сеанса, и он создаст один с помощью инструмента [`EnterWorktree`](/ru/tools-reference). После входа в worktree Claude может переключиться непосредственно на другой worktree в `.claude/worktrees/`, вызвав `EnterWorktree` с целевым путём. Предыдущий worktree остаётся на диске нетронутым.37Вы также можете попросить Claude "работать в worktree" во время сеанса, и он создаст один с помощью инструмента [`EnterWorktree`](/docs/ru/tools-reference). После входа в worktree Claude может переключиться непосредственно на другой worktree в `.claude/worktrees/`, вызвав `EnterWorktree` с целевым путём. Предыдущий worktree остаётся на диске нетронутым.

38 38 

39Вход в путь вне каталога `.claude/worktrees/` репозитория требует вашего одобрения в первую очередь, потому что это перемещает рабочий каталог сеанса, доступ на запись и конфигурацию проекта, такую как `CLAUDE.md` и settings, в это место. Правило разрешения `EnterWorktree` [permission rule](/ru/permissions) или выбор "не спрашивать снова" не подавляет это приглашение; только режим `bypassPermissions` пропускает его. До версии 2.1.206 Claude мог войти в любой существующий путь worktree без запроса.39Вход в путь вне каталога `.claude/worktrees/` репозитория требует вашего одобрения в первую очередь, потому что это перемещает рабочий каталог сеанса, доступ на запись и конфигурацию проекта, такую как `CLAUDE.md` и settings, в это место. Правило разрешения `EnterWorktree` [permission rule](/docs/ru/permissions) или выбор "не спрашивать снова" не подавляет это приглашение; только режим `bypassPermissions` пропускает его. До версии 2.1.206 Claude мог войти в любой существующий путь worktree без запроса.

40 40 

41{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, вход или выход из worktree также перемещает стенограмму сеанса в хранилище проекта этого каталога, так же как это делает [`/cd`](/ru/commands), поэтому `/desktop` и `--resume` находят сеанс там после этого. Worktrees, созданные hook [`WorktreeCreate`](#non-git-version-control), исключены и сохраняют стенограмму в каталоге запуска.41Начиная с версии 2.1.198, вход или выход из worktree также перемещает стенограмму сеанса в хранилище проекта этого каталога, так же как это делает [`/cd`](/docs/ru/commands), поэтому `/desktop` и `--resume` находят сеанс там после этого. Worktrees, созданные hook [`WorktreeCreate`](#non-git-version-control), исключены и сохраняют стенограмму в каталоге запуска.

42 42 

43Worktrees работают с включённым [sandboxing](/ru/sandboxing#filesystem-isolation): песочница позволяет записывать в общий каталог `.git` основного репозитория, поэтому команды, такие как `git commit`, могут обновлять refs и индекс изнутри связанного worktree.43Worktrees работают с включённым [sandboxing](/docs/ru/sandboxing#filesystem-isolation): песочница позволяет записывать в общий каталог `.git` основного репозитория, поэтому команды, такие как `git commit`, могут обновлять refs и индекс изнутри связанного worktree.

44 44 

45Перед использованием `--worktree` интерактивно в каталоге в первый раз примите диалог доверия рабочей области, запустив `claude` один раз в этом каталоге. Если доверие ещё не было принято, `--worktree` завершится с ошибкой и предложит вам сначала запустить `claude` в каталоге. Неинтерактивные запуски с `-p` пропускают [проверку доверия](/ru/security), поэтому `claude -p --worktree` продолжает работу без неё.45Перед использованием `--worktree` интерактивно в каталоге в первый раз примите диалог доверия рабочей области, запустив `claude` один раз в этом каталоге. Если доверие ещё не было принято, `--worktree` завершится с ошибкой и предложит вам сначала запустить `claude` в каталоге. Неинтерактивные запуски с `-p` пропускают [проверку доверия](/docs/ru/security), поэтому `claude -p --worktree` продолжает работу без неё.

46 46 

47Если Claude Code не может войти в каталог worktree при запуске, например потому что hook [`WorktreeCreate`](/ru/hooks#worktreecreate) вывел что-то другое, чем каталог, который он создал, или потому что каталог был удалён после его настройки, Claude Code выводит ошибку с указанием пути и завершается с кодом 1. До версии 2.1.205 это приводило к сбою сеанса, а с `-p` это зависало примерно на 30 секунд перед выходом с кодом 0.47Если Claude Code не может войти в каталог worktree при запуске, например потому что hook [`WorktreeCreate`](/docs/ru/hooks#worktreecreate) вывел что-то другое, чем каталог, который он создал, или потому что каталог был удалён после его настройки, Claude Code выводит ошибку с указанием пути и завершается с кодом 1. До версии 2.1.205 это приводило к сбою сеанса, а с `-p` это зависало примерно на 30 секунд перед выходом с кодом 0.

48 48 

49{/* min-version: 2.1.200 */}Плагины, установленные в [области проекта](/ru/plugins-reference#plugin-installation-scopes) из основной копии, также загружаются в worktrees того же репозитория, поэтому вам не нужно переустанавливать их для каждого worktree. Это применяется независимо от того, создаёте ли вы worktree с помощью `--worktree` или с помощью `git worktree add`. Требуется Claude Code версии 2.1.200 или позже.49Плагины, установленные в [области проекта](/docs/ru/plugins-reference#plugin-installation-scopes) из основной копии, также загружаются в worktrees того же репозитория, поэтому вам не нужно переустанавливать их для каждого worktree. Это применяется независимо от того, создаёте ли вы worktree с помощью `--worktree` или с помощью `git worktree add`. Требуется Claude Code версии 2.1.200 или позже.

50 50 

51<Tip>51<Tip>

52 Добавьте `.claude/worktrees/` в ваш `.gitignore`, чтобы содержимое worktree не отображалось как неотслеживаемые файлы в вашей основной копии.52 Добавьте `.claude/worktrees/` в ваш `.gitignore`, чтобы содержимое worktree не отображалось как неотслеживаемые файлы в вашей основной копии.


60 60 

61Обновление требует Claude Code версии 2.1.208 или позже; до этого новый worktree использовал то, что уже было кэшировано локально в `origin/HEAD`.61Обновление требует Claude Code версии 2.1.208 или позже; до этого новый worktree использовал то, что уже было кэшировано локально в `origin/HEAD`.

62 62 

63Чтобы всегда ветвиться от локальной `HEAD`, установите `worktree.baseRef` на `"head"` в [settings](/ru/settings#worktree-settings). Установка `baseRef` на `"head"` делает новые worktrees содержащими ваши неотправленные коммиты и состояние ветки функции, что полезно при изоляции subagents, которым нужно работать с незавершённой работой. Когда сеанс работает внутри связанного worktree, `"head"` разрешается в `HEAD` этого worktree, а не в основной копии. Параметр принимает только `"fresh"` или `"head"`, а не произвольные git refs:63Чтобы всегда ветвиться от локальной `HEAD`, установите `worktree.baseRef` на `"head"` в [settings](/docs/ru/settings#worktree-settings). Установка `baseRef` на `"head"` делает новые worktrees содержащими ваши неотправленные коммиты и состояние ветки функции, что полезно при изоляции subagents, которым нужно работать с незавершённой работой. Когда сеанс работает внутри связанного worktree, `"head"` разрешается в `HEAD` этого worktree, а не в основной копии. Параметр принимает только `"fresh"` или `"head"`, а не произвольные git refs:

64 64 

65```json theme={null}65```json theme={null}

66{66{


76claude --worktree "#1234"76claude --worktree "#1234"

77```77```

78 78 

79Для полного контроля над тем, как создаются worktrees, настройте hook [`WorktreeCreate`](/ru/hooks#worktreecreate), который полностью заменяет логику `git worktree` по умолчанию.79Для полного контроля над тем, как создаются worktrees, настройте hook [`WorktreeCreate`](/docs/ru/hooks#worktreecreate), который полностью заменяет логику `git worktree` по умолчанию.

80 80 

81<h3 id="reuse-a-worktree-name">81<h3 id="reuse-a-worktree-name">

82 Повторное использование имени worktree82 Повторное использование имени worktree


108config/secrets.json108config/secrets.json

109```109```

110 110 

111Это применяется к worktrees, созданным с помощью `--worktree`, [worktrees subagent](#isolate-subagents-with-worktrees) и параллельным сеансам в [десктопном приложении](/ru/desktop#work-in-parallel-with-sessions).111Это применяется к worktrees, созданным с помощью `--worktree`, [worktrees subagent](#isolate-subagents-with-worktrees) и параллельным сеансам в [десктопном приложении](/docs/ru/desktop#work-in-parallel-with-sessions).

112 112 

113<h2 id="isolate-subagents-with-worktrees">113<h2 id="isolate-subagents-with-worktrees">

114 Изолируйте subagents с помощью worktrees114 Изолируйте subagents с помощью worktrees

115</h2>115</h2>

116 116 

117Subagents могут работать в собственных worktrees, чтобы параллельные правки не конфликтовали. Попросите Claude "использовать worktrees для ваших агентов" или установите это постоянно на [пользовательском subagent](/ru/sub-agents#supported-frontmatter-fields), добавив `isolation: worktree` в frontmatter. Каждый subagent получает временный worktree, который автоматически удаляется, когда subagent завершает работу без изменений.117Subagents могут работать в собственных worktrees, чтобы параллельные правки не конфликтовали. Попросите Claude "использовать worktrees для ваших агентов" или установите это постоянно на [пользовательском subagent](/docs/ru/sub-agents#supported-frontmatter-fields), добавив `isolation: worktree` в frontmatter. Каждый subagent получает временный worktree, который автоматически удаляется, когда subagent завершает работу без изменений.

118 118 

119Worktrees subagents используют ту же [базовую ветку](#choose-the-base-branch), что и `--worktree`, поэтому они ветвятся от ветки по умолчанию вашего репозитория, если только `worktree.baseRef` не установлен на `"head"`.119Worktrees subagents используют ту же [базовую ветку](#choose-the-base-branch), что и `--worktree`, поэтому они ветвятся от ветки по умолчанию вашего репозитория, если только `worktree.baseRef` не установлен на `"head"`.

120 120 


124 124 

125Когда вы выходите из сеанса worktree, очистка зависит от того, внесли ли вы изменения:125Когда вы выходите из сеанса worktree, очистка зависит от того, внесли ли вы изменения:

126 126 

127* **Нет неотправленных изменений, нет неотслеживаемых файлов и нет новых коммитов**: worktree и его ветка удаляются автоматически. Если сеанс имеет [имя](/ru/sessions#name-your-sessions), Claude вместо этого предлагает вам сохранить worktree на потом127* **Нет неотправленных изменений, нет неотслеживаемых файлов и нет новых коммитов**: worktree и его ветка удаляются автоматически. Если сеанс имеет [имя](/docs/ru/sessions#name-your-sessions), Claude вместо этого предлагает вам сохранить worktree на потом

128* **Существуют неотправленные изменения, неотслеживаемые файлы или новые коммиты**: Claude предлагает вам сохранить или удалить worktree. Сохранение сохраняет каталог и ветку, чтобы вы могли вернуться позже. Удаление удаляет каталог worktree и его ветку, отбрасывая все неотправленные изменения, неотслеживаемые файлы и коммиты128* **Существуют неотправленные изменения, неотслеживаемые файлы или новые коммиты**: Claude предлагает вам сохранить или удалить worktree. Сохранение сохраняет каталог и ветку, чтобы вы могли вернуться позже. Удаление удаляет каталог worktree и его ветку, отбрасывая все неотправленные изменения, неотслеживаемые файлы и коммиты

129* **Неинтерактивные запуски**: worktrees, созданные с помощью `--worktree` вместе с `-p`, не очищаются автоматически, так как нет подсказки выхода. Удалите их с помощью `git worktree remove`129* **Неинтерактивные запуски**: worktrees, созданные с помощью `--worktree` вместе с `-p`, не очищаются автоматически, так как нет подсказки выхода. Удалите их с помощью `git worktree remove`

130 130 

131Worktrees, которые Claude создал для subagents и [фоновых сеансов](/ru/agent-view#how-file-edits-are-isolated), удаляются автоматически, как только они становятся старше вашего параметра [`cleanupPeriodDays`](/ru/settings#available-settings), при условии, что они не имеют неотправленных изменений, неотслеживаемых файлов и неотправленных коммитов. Worktrees, которые вы создаёте с помощью `--worktree`, никогда не удаляются этой очисткой.131Worktrees, которые Claude создал для subagents и [фоновых сеансов](/docs/ru/agent-view#how-file-edits-are-isolated), удаляются автоматически, как только они становятся старше вашего параметра [`cleanupPeriodDays`](/docs/ru/settings#available-settings), при условии, что они не имеют неотправленных изменений, неотслеживаемых файлов и неотправленных коммитов. Worktrees, которые вы создаёте с помощью `--worktree`, никогда не удаляются этой очисткой.

132 132 

133Пока агент работает, Claude запускает `git worktree lock` на его worktree, чтобы одновременная очистка не могла его удалить. Блокировка снимается, когда агент завершает работу. Чтобы очистить worktree, который очистка сохраняет, запустите `git worktree remove`, добавив `--force`, если worktree содержит неотправленные изменения или неотслеживаемые файлы.133Пока агент работает, Claude запускает `git worktree lock` на его worktree, чтобы одновременная очистка не могла его удалить. Блокировка снимается, когда агент завершает работу. Чтобы очистить worktree, который очистка сохраняет, запустите `git worktree remove`, добавив `--force`, если worktree содержит неотправленные изменения или неотслеживаемые файлы.

134 134 


176 Не-git системы контроля версий176 Не-git системы контроля версий

177</h2>177</h2>

178 178 

179Изоляция worktrees использует git по умолчанию. Для SVN, Perforce, Mercurial или других систем настройте hooks [`WorktreeCreate` и `WorktreeRemove`](/ru/hooks#worktreecreate), чтобы предоставить пользовательскую логику создания и очистки. Поскольку hook заменяет поведение git по умолчанию, [`.worktreeinclude`](#copy-gitignored-files-into-worktrees) не обрабатывается при использовании `--worktree`. Скопируйте любые локальные файлы конфигурации внутри вашего скрипта hook вместо этого.179Изоляция worktrees использует git по умолчанию. Для SVN, Perforce, Mercurial или других систем настройте hooks [`WorktreeCreate` и `WorktreeRemove`](/docs/ru/hooks#worktreecreate), чтобы предоставить пользовательскую логику создания и очистки. Поскольку hook заменяет поведение git по умолчанию, [`.worktreeinclude`](#copy-gitignored-files-into-worktrees) не обрабатывается при использовании `--worktree`. Скопируйте любые локальные файлы конфигурации внутри вашего скрипта hook вместо этого.

180 180 

181Этот hook `WorktreeCreate` читает имя worktree из stdin, проверяет свежую рабочую копию SVN и выводит путь каталога, чтобы Claude Code мог использовать его как рабочий каталог сеанса:181Этот hook `WorktreeCreate` читает имя worktree из stdin, проверяет свежую рабочую копию SVN и выводит путь каталога, чтобы Claude Code мог использовать его как рабочий каталог сеанса:

182 182 


197}197}

198```198```

199 199 

200Объедините его с hook `WorktreeRemove` для очистки при завершении сеанса. Схему входных данных и пример удаления см. в [справочнике hooks](/ru/hooks#worktreecreate).200Объедините его с hook `WorktreeRemove` для очистки при завершении сеанса. Схему входных данных и пример удаления см. в [справочнике hooks](/docs/ru/hooks#worktreecreate).

201 201 

202<h2 id="see-also">202<h2 id="see-also">

203 См. также203 См. также


205 205 

206Worktrees обрабатывают изоляцию файлов. Связанные страницы ниже охватывают делегирование работы в эти изолированные копии и переключение между созданными вами сеансами:206Worktrees обрабатывают изоляцию файлов. Связанные страницы ниже охватывают делегирование работы в эти изолированные копии и переключение между созданными вами сеансами:

207 207 

208* [Subagents](/ru/sub-agents): делегируйте работу изолированным агентам внутри сеанса208* [Subagents](/docs/ru/sub-agents): делегируйте работу изолированным агентам внутри сеанса

209* [Agent teams](/ru/agent-teams): координируйте несколько сеансов Claude автоматически209* [Agent teams](/docs/ru/agent-teams): координируйте несколько сеансов Claude автоматически

210* [Manage sessions](/ru/sessions): назовите, возобновите и переключайтесь между беседами210* [Manage sessions](/docs/ru/sessions): назовите, возобновите и переключайтесь между беседами

211* [Desktop parallel sessions](/ru/desktop#work-in-parallel-with-sessions): сеансы на основе worktree в десктопном приложении211* [Desktop parallel sessions](/docs/ru/desktop#work-in-parallel-with-sessions): сеансы на основе worktree в десктопном приложении