SpyBara
Go Premium

Documentation 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC

78 files changed +2,324 −1,579. View all changes and history on the product overview
2026
Fri 25 23:58 Thu 24 22:57 Wed 23 23:57 Tue 22 23:59 Mon 21 22:59 Sun 20 23:59 Sat 19 23:57 Fri 18 23:58 Tue 15 23:58 Mon 14 22:58 Sun 13 21:00 Sat 12 03:02 Thu 10 23:00 Wed 9 22:58 Tue 8 20:00 Tue 1 21:02

admin-setup.md +1 −1

Details

167 167 

168* [Quickstart](/docs/ru/quickstart): пошаговое руководство первого сеанса от установки до работы с проектом168* [Quickstart](/docs/ru/quickstart): пошаговое руководство первого сеанса от установки до работы с проектом

169* [Common workflows](/docs/ru/common-workflows): шаблоны для повседневных задач, таких как проверка кода, рефакторинг и отладка169* [Common workflows](/docs/ru/common-workflows): шаблоны для повседневных задач, таких как проверка кода, рефакторинг и отладка

170* [Claude 101](https://anthropic.skilljar.com/claude-101) и [Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action): самостоятельные курсы Anthropic Academy170* [Claude Code 101](https://academy.claude.com/courses/claude-code-101) и [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action): бесплатные самостоятельные курсы на [Claude Academy](https://academy.claude.com/)

171 171 

172Для проблем с входом направьте разработчиков на [troubleshooting аутентификации](/docs/ru/troubleshoot-install#login-and-authentication). Наиболее распространенные исправления:172Для проблем с входом направьте разработчиков на [troubleshooting аутентификации](/docs/ru/troubleshoot-install#login-and-authentication). Наиболее распространенные исправления:

173 173 

advisor.md +10 −8

Details

56* Запустите `/advisor` с моделью, например `/advisor opus`, чтобы установить её.56* Запустите `/advisor` с моделью, например `/advisor opus`, чтобы установить её.

57* Запустите `/advisor off`, чтобы отключить его.57* Запустите `/advisor off`, чтобы отключить его.

58 58 

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

60 

61Claude Code по-прежнему сохраняет советника, которого не поддерживает ваша текущая основная модель. Этот советник активируется после переключения на [совместимую основную модель](#choose-an-advisor-model) с помощью [`/model`](/docs/ru/model-config#setting-your-model). Если API уже отклонил сохранённого советника в текущем разговоре, он остаётся отключённым до `/clear` или `/compact`, даже после переключения моделей.

60 62 

61На некоторых планах использование Fable в качестве советника также требует вашего одноразового [согласия на выставление счёта за использование Fable на основе кредитов использования](/docs/ru/model-config#fable-and-usage-credits). О том, что делает `/advisor fable` до того, как вы дали это согласие, см. [Советник Fable и кредиты использования](#fable-advisor-and-usage-credits).63На некоторых планах использование Fable в качестве советника также требует вашего одноразового [согласия на выставление счёта за использование Fable на основе кредитов использования](/docs/ru/model-config#fable-and-usage-credits). О том, что делает `/advisor fable` до того, как вы дали это согласие, см. [Советник Fable и кредиты использования](#fable-advisor-and-usage-credits).

62 64 

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

99 101 

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

101| --------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------- |103| --------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------- |

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

103| Sonnet 4.6 | Fable, Opus, Sonnet | |105| Sonnet 4.6 | Fable, Opus, Sonnet | |

104| Sonnet 5 | Fable, Opus 4.7 или позже, Sonnet 5 | Советник Sonnet 4.6 отклоняется, и запросы с советником Opus 4.6 завершаются с ошибкой API |106| Sonnet 5 | Fable, Opus 4.7 или позже, Sonnet 5 | Советник Sonnet 4.6 отклоняется, и API отклоняет советника Opus 4.6 |

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

106| Opus 4.7 или Opus 4.8 | Fable и Opus 4.7 или позже | Советник Opus 4.6 или Sonnet отклоняется |108| Opus 4.7 или Opus 4.8 | Fable и Opus 4.7 или позже | Советник Opus 4.6 или Sonnet отклоняется |

107| Opus 5 | Fable, Opus 5 | Советник Opus 4.6 или Sonnet отклоняется, и запросы с советником Opus 4.7 или Opus 4.8 завершаются с ошибкой API |109| Opus 5.5 или Opus 5 | Fable и Opus 5 или позже | Советник Opus 4.6 или Sonnet отклоняется, и API отклоняет советника Opus 4.7 или Opus 4.8 |

108| Fable 5 | Fable 5.1 или Fable 5 | Советник Opus или Sonnet отклоняется |110| Fable 5 | Fable 5.1 или Fable 5 | Советник Opus или Sonnet отклоняется |

109| Fable 5.1 | Fable 5.1 | Советник Opus или Sonnet отклоняется, и запросы с советником Fable 5 завершаются с ошибкой API |111| Fable 5.1 | Fable 5.1 | Советник Opus или Sonnet отклоняется, и API отклоняет советника Fable 5 |

110 112 

111Fable 5.1 требует Claude Code v2.1.257 или более поздней версии. Обе модели Fable требуют [доступ к Fable](/docs/ru/model-config#work-with-fable).113Fable 5.1 требует Claude Code v2.1.257 или более поздней версии. Обе модели Fable требуют [доступ к Fable](/docs/ru/model-config#work-with-fable).

112 114 

113Установите советника как `fable`, `opus` или `sonnet`. Эти псевдонимы разрешаются в встроенную версию Claude Code по умолчанию для каждого семейства моделей, которая обновляется с новыми выпусками Claude Code. Вы также можете передать полный ID модели, например `claude-opus-5`.115Установите советника как `fable`, `opus` или `sonnet`. Эти псевдонимы разрешаются в встроенную версию Claude Code по умолчанию для каждого семейства моделей, которая обновляется с новыми выпусками Claude Code. Вы также можете передать полный ID модели, например `claude-opus-5-5`.

114 116 

115Подагенты наследуют настроенного советника и применяют ту же проверку пары к своей собственной модели.117Подагенты наследуют настроенного советника и применяют ту же проверку пары к своей собственной модели.

116 118 

117Claude Code проверяет пару перед отправкой запроса, и API проверяет её снова:119Claude Code проверяет пару перед отправкой запроса, и API проверяет её снова:

118 120 

119* Для советника, который таблица указывает как отклоняемый, Claude Code не присоединяет его к запросам основной модели. Вывод команды `/advisor` и уведомление показывают это. Подагенты, чья собственная модель удовлетворяет требованиям пары, могут по-прежнему использовать советника.121* Для советника, который таблица указывает как отклоняемый, Claude Code не присоединяет его к запросам основной модели. Вывод команды `/advisor` и уведомление показывают это. Подагенты, чья собственная модель удовлетворяет требованиям пары, могут по-прежнему использовать советника.

120* Для советника, который таблица указывает как завершающийся с ошибкой API, Claude Code присоединяет его, и API отклоняет его. Каждый запрос завершается с ошибкой `'<модель советника>' не может использоваться в качестве советника, когда модель запроса — '<основная модель>'` до тех пор, пока вы не измените советника с помощью `/advisor` или не отключите его.122* Для советника, который таблица указывает как отклоняемый API, Claude Code присоединяет его, и API отклоняет его. Claude Code затем повторно отправляет этот запрос без советника, и остальная часть разговора выполняется без него, поэтому вы не видите ошибку и не получаете вызовы советника. Выберите принятого советника с помощью `/advisor`; изменение вступает в силу после `/clear` или `/compact` и в новых сессиях.

121* Если основная модель или советник — это модель, которую Claude Code не распознает, советник не присоединяется.123* Если основная модель или советник — это модель, которую Claude Code не распознает, советник не присоединяется.

122 124 

123<h3 id="fable-advisor-and-usage-credits">125<h3 id="fable-advisor-and-usage-credits">

195 197 

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

197 199 

198* **Только 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.200* **Только 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. Если шлюз или его вышестоящий источник не распознают инструмент advisor, см. [Автоматический повтор и пересылка ошибок](/docs/ru/llm-gateway-protocol#automatic-retry-and-error-forwarding) для информации о том, как Claude Code реагирует.

199* **Поддерживаемая основная модель**: Fable, Opus 4.6 или позже, Sonnet 4.6 или позже, или Haiku 4.5. См. [Выбор модели advisor](#choose-an-advisor-model) для информации о том, какие советники принимает каждая модель.201* **Поддерживаемая основная модель**: Fable, Opus 4.6 или позже, Sonnet 4.6 или позже, или Haiku 4.5. См. [Выбор модели advisor](#choose-an-advisor-model) для информации о том, какие советники принимает каждая модель.

200* **Получение флага функции**: Claude Code включает советника через флаг функции, который он получает от Anthropic. В сеансе, где установлена переменная, отключающая получение флага, такая как `DISABLE_TELEMETRY`, советник остаётся отключённым. См. [Функции, требующие получения флага функции](/docs/ru/env-vars#features-that-need-feature-flag-fetching).202* **Получение флага функции**: Claude Code включает советника через флаг функции, который он получает от Anthropic. В сеансе, где установлена переменная, отключающая получение флага, такая как `DISABLE_TELEMETRY`, советник остаётся отключённым. См. [Функции, требующие получения флага функции](/docs/ru/env-vars#features-that-need-feature-flag-fetching).

201 203 

Details

189TypeScript также имеет `applyFlagSettings()` и `updateSettings()`:189TypeScript также имеет `applyFlagSettings()` и `updateSettings()`:

190 190 

191* **`applyFlagSettings()`**: применяет настройки во время выполнения, как в `await session.applyFlagSettings({ effortLevel: "high" })`. Метод принимает ключи файла настроек, а не поля параметров, поэтому проверьте [справочник `applyFlagSettings()`](/docs/ru/agent-sdk/typescript#applyflagsettings) для схемы и для того, какие ключи вступают в силу во время сеанса.191* **`applyFlagSettings()`**: применяет настройки во время выполнения, как в `await session.applyFlagSettings({ effortLevel: "high" })`. Метод принимает ключи файла настроек, а не поля параметров, поэтому проверьте [справочник `applyFlagSettings()`](/docs/ru/agent-sdk/typescript#applyflagsettings) для схемы и для того, какие ключи вступают в силу во время сеанса.

192* **`updateSettings()`**: записывает разрешённый набор ключей в локальный файл настроек проекта, как в `await session.updateSettings("localSettings", { outputStyle: "Explanatory" })`. Записанные ключи вступают в силу при следующем запросе сеанса и сохраняются для более поздних сеансов, которые загружают настройки `local`. Строка метода в [таблице методов](/docs/ru/agent-sdk/typescript#methods) называет разрешённые ключи и минимальную версию.192* **`updateSettings()`**: записывает один разрешённый ключ в файл настроек. [Справочник `updateSettings()`](/docs/ru/agent-sdk/typescript#updatesettings) называет ключ, который принимает каждый источник, и минимальные версии.

193 * Передайте `"localSettings"` для записи в файл локальных настроек проекта, как в `await session.updateSettings("localSettings", { outputStyle: "Explanatory" })`. Записанный ключ вступает в силу при следующем запросе сеанса и сохраняется для более поздних сеансов, которые загружают настройки `local`.

194 * Передайте `"userSettings"` для записи `effortLevel`, единственного ключа, который принимает этот источник. Claude Code сохраняет его как уровень усилий по умолчанию для текущей модели сеанса, и усилия работающего сеанса не изменяются.

193 195 

194Пример ниже запускает двухходовой сеанс, изменяет конфигурацию между ходами и выводит модель, которая ответила на каждый ход. В TypeScript поток подсказок удерживает второе сообщение до тех пор, пока установщики не будут запущены, и второй ход выполняется на новой модели.196Пример ниже запускает двухходовой сеанс, изменяет конфигурацию между ходами и выводит модель, которая ответила на каждый ход. В TypeScript поток подсказок удерживает второе сообщение до тех пор, пока установщики не будут запущены, и второй ход выполняется на новой модели.

195 197 

Details

37 37 

38* **Вызов `query()`:** одно вызывание функции `query()` SDK. Один вызов может включать несколько шагов: Claude отвечает, использует инструменты, получает результаты и отвечает снова. Каждый вызов создает одно сообщение [`result`](/docs/ru/agent-sdk/typescript#sdkresultmessage) в конце, за исключением [режима потоковой передачи входных данных](/docs/ru/agent-sdk/streaming-vs-single-mode), где один вызов `query()` содержит несколько ходов пользователя и каждый ход выдает свое собственное сообщение `result`.38* **Вызов `query()`:** одно вызывание функции `query()` SDK. Один вызов может включать несколько шагов: Claude отвечает, использует инструменты, получает результаты и отвечает снова. Каждый вызов создает одно сообщение [`result`](/docs/ru/agent-sdk/typescript#sdkresultmessage) в конце, за исключением [режима потоковой передачи входных данных](/docs/ru/agent-sdk/streaming-vs-single-mode), где один вызов `query()` содержит несколько ходов пользователя и каждый ход выдает свое собственное сообщение `result`.

39* **Шаг:** один цикл запроса/ответа в рамках вызова `query()`. Каждый шаг создает сообщения ассистента с использованием токенов.39* **Шаг:** один цикл запроса/ответа в рамках вызова `query()`. Каждый шаг создает сообщения ассистента с использованием токенов.

40* **Сеанс:** серия вызовов `query()`, связанных идентификатором сеанса (с использованием опции `resume`). Каждый вызов `query()` в рамках сеанса сообщает о своей стоимости независимо.40* **Сеанс:** серия вызовов `query()`, связанных идентификатором сеанса через опцию `resume`. Результаты возобновленного вызова сообщают об общих расходах сеанса, а не только о расходах этого вызова. См. [Накопление стоимости при нескольких вызовах](#accumulate-costs-across-multiple-calls) для получения информации о том, как переносятся итоги.

41 41 

42На следующей диаграмме показан поток сообщений от одного вызова `query()` с использованием токенов, указанным на каждом шаге и совокупной оценкой в конце:42На следующей диаграмме показан поток сообщений от одного вызова `query()` с использованием токенов, указанным на каждом шаге и совокупной оценкой в конце:

43 43 

51 </Step>51 </Step>

52 52 

53 <Step title="Результирующее сообщение предоставляет совокупную оценку">53 <Step title="Результирующее сообщение предоставляет совокупную оценку">

54 Когда вызов `query()` завершается, SDK выдает результирующее сообщение с `total_cost_usd` и совокупным `usage`, типизированное как [`SDKResultMessage`](/docs/ru/agent-sdk/typescript#sdkresultmessage) в TypeScript и [`ResultMessage`](/docs/ru/agent-sdk/python#resultmessage) в Python. Если вы делаете несколько вызовов `query()`, например в многоходовом сеансе, каждый результат отражает только стоимость этого отдельного вызова. Если вам нужна только предполагаемая сумма, вы можете игнорировать использование по шагам и прочитать это единственное значение.54 Когда вызов `query()` завершается, SDK выдает результирующее сообщение с `total_cost_usd` и совокупным `usage`, типизированное как [`SDKResultMessage`](/docs/ru/agent-sdk/typescript#sdkresultmessage) в TypeScript и [`ResultMessage`](/docs/ru/agent-sdk/python#resultmessage) в Python. Если вам нужна только предполагаемая сумма, вы можете игнорировать использование по шагам и прочитать это единственное значение.

55 

56 Если вы делаете несколько независимых вызовов `query()`, каждый результат отражает только стоимость этого отдельного вызова. Вызов, который возобновляет сеанс, также учитывает более ранние расходы сеанса.

55 57 

56 В режиме потоковой передачи входных данных каждый ход выдает свое собственное результирующее сообщение. См. [Отслеживание стоимости в режиме потоковой передачи входных данных](#track-costs-in-streaming-input-mode) для получения информации о том, как читать итоги вызовов в этом режиме.58 В режиме потоковой передачи входных данных каждый ход выдает свое собственное результирующее сообщение. См. [Отслеживание стоимости в режиме потоковой передачи входных данных](#track-costs-in-streaming-input-mode) для получения информации о том, как читать итоги вызовов в этом режиме.

57 </Step>59 </Step>

64В [режиме потоковой передачи входных данных](/docs/ru/agent-sdk/streaming-vs-single-mode) один вызов `query()` содержит несколько ходов пользователя, и каждый ход выдает собственное сообщение результата. Поля результата различаются по области действия:66В [режиме потоковой передачи входных данных](/docs/ru/agent-sdk/streaming-vs-single-mode) один вызов `query()` содержит несколько ходов пользователя, и каждый ход выдает собственное сообщение результата. Поля результата различаются по области действия:

65 67 

66* **`usage`**: охватывает только этот ход и в его пределах только основной цикл агента, а не какие-либо подагенты, которые он запустил.68* **`usage`**: охватывает только этот ход и в его пределах только основной цикл агента, а не какие-либо подагенты, которые он запустил.

67* **`total_cost_usd` и `modelUsage`, или `model_usage` в Python**: содержат текущий итог для всего вызова на данный момент.69* **`total_cost_usd` и `modelUsage`, или `model_usage` в Python**: содержат текущий итог для всего вызова на данный момент, плюс любые расходы, восстановленные при возобновлении вызовом сеанса.

68 70 

69В вызове, где ваше приложение никогда не отправляет `/clear`, `/reset` или `/new`, прочитайте последний результат для итогов вызова, а не суммируйте результаты.71В вызове, где ваше приложение никогда не отправляет `/clear`, `/reset` или `/new`, прочитайте последний результат для итогов вызова, а не суммируйте результаты.

70 72 

78 80 

79В TypeScript SDK также выдает [`SDKConversationResetMessage`](/docs/ru/agent-sdk/typescript#sdkconversationresetmessage) при каждом сбросе, поэтому вы можете обнаружить сбросы из потока. В Python SDK аналогично выдает `ConversationResetMessage`. До версии Python SDK v0.2.137 итератор Python отбрасывал это сообщение, поэтому в этих версиях считайте сбросы самостоятельно из ходов `/clear`, которые отправляет ваше приложение.81В TypeScript SDK также выдает [`SDKConversationResetMessage`](/docs/ru/agent-sdk/typescript#sdkconversationresetmessage) при каждом сбросе, поэтому вы можете обнаружить сбросы из потока. В Python SDK аналогично выдает `ConversationResetMessage`. До версии Python SDK v0.2.137 итератор Python отбрасывал это сообщение, поэтому в этих версиях считайте сбросы самостоятельно из ходов `/clear`, которые отправляет ваше приложение.

80 82 

81`maxBudgetUsd` (TypeScript) или `max_budget_usd` (Python) сравнивается с тем же текущим итогом, поэтому `/clear` также начинает бюджет заново.83`maxBudgetUsd` (TypeScript) или `max_budget_usd` (Python) считает только расходы самого вызова: итоги, восстановленные из возобновленного сеанса, не учитываются в нем, и `/clear` начинает бюджет заново.

82 84 

83<h2 id="get-the-total-cost-of-a-query">85<h2 id="get-the-total-cost-of-a-query">

84 Получить общую стоимость запроса86 Получить общую стоимость запроса

85</h2>87</h2>

86 88 

87Результирующее сообщение, типизированное как [`SDKResultMessage`](/docs/ru/agent-sdk/typescript#sdkresultmessage) в TypeScript и [`ResultMessage`](/docs/ru/agent-sdk/python#resultmessage) в Python, отмечает конец цикла агента для вызова `query()`. Оно включает `total_cost_usd`, совокупную предполагаемую стоимость всех шагов в этом вызове. В Python это поле типизировано как опциональное, поэтому проверьте, что оно не равно `None` перед его чтением. Результаты успеха и ошибки оба содержат его, хотя финальный результат [сбоя сеанса](#recover-totals-after-a-session-crash) может содержать его обнуленным.89Результирующее сообщение, типизированное как [`SDKResultMessage`](/docs/ru/agent-sdk/typescript#sdkresultmessage) в TypeScript и [`ResultMessage`](/docs/ru/agent-sdk/python#resultmessage) в Python, отмечает конец цикла агента для вызова `query()`. Оно включает `total_cost_usd`, совокупную предполагаемую стоимость всех шагов в этом вызове. Вызов, который возобновляет сеанс, также учитывает более ранние расходы сеанса. При чтении значения применяются два предостережения:

90 

91* В Python это поле типизировано как опциональное, поэтому проверьте, что оно не равно `None` перед его чтением.

92* Результаты успеха и ошибки оба содержат его, хотя финальный результат [сбоя сеанса](#recover-totals-after-a-session-crash) может содержать его обнуленным.

88 93 

89Если вы используете сеансы для выполнения нескольких вызовов `query()`, каждый результат отражает только стоимость этого отдельного вызова. В режиме потоковой передачи входных данных читайте итоги вызовов, как описано в [Отслеживание затрат в режиме потоковой передачи входных данных](#track-costs-in-streaming-input-mode).94В режиме потоковой передачи входных данных читайте итоги вызовов, как описано в [Отслеживание затрат в режиме потоковой передачи входных данных](#track-costs-in-streaming-input-mode).

90 95 

91Три поля на уровне результата отличаются тем, что они считают, когда агент порождает [подагентов](/docs/ru/agent-sdk/subagents). Используйте `modelUsage` или `model_usage` в Python для учета токенов всего дерева; поле `usage` недосчитывает, как только происходит вложение.96Три поля на уровне результата отличаются тем, что они считают, когда агент порождает [подагентов](/docs/ru/agent-sdk/subagents). Используйте `modelUsage` или `model_usage` в Python для учета токенов всего дерева; поле `usage` недосчитывает, как только происходит вложение.

92 97 

232 Накопление затрат при нескольких вызовах237 Накопление затрат при нескольких вызовах

233</h2>238</h2>

234 239 

235Каждый вызов `query()` возвращает свой собственный `total_cost_usd`. SDK не предоставляет общую сумму на уровне сеанса, поэтому если ваше приложение выполняет несколько вызовов `query()`, например в многоходовом сеансе или для разных пользователей, накапливайте итоги самостоятельно. В режиме потоковой передачи входных данных прочитайте общую сумму каждого вызова, как описано в разделе [Отслеживание затрат в режиме потоковой передачи входных данных](#track-costs-in-streaming-input-mode). Для вызова, который завершился сбоем, см. раздел [Восстановление итогов после сбоя сеанса](#recover-totals-after-a-session-crash).240Каждый вызов `query()` возвращает `total_cost_usd` в своих результатах. Способ объединения значений зависит от того, используют ли вызовы один сеанс:

241 

242* **Независимые вызовы без опции `resume` или `continue`**: каждый результат охватывает только свой собственный вызов, поэтому складывайте итоги самостоятельно, как это делается в примерах ниже.

243* **Вызовы, которые возобновляют один и тот же сеанс**: Claude Code сохраняет итоги сеанса в его [транскрипт](/docs/ru/sessions#where-transcripts-are-stored) при нормальном завершении процесса и восстанавливает их, когда последующий вызов возобновляет или разветвляет сеанс. Каждый результат уже включает более ранние расходы сеанса. Прочитайте последний результат для получения общей суммы сеанса; суммирование результатов приводит к двойному подсчёту восстановленных расходов. До версии 2.1.277 сеанс, который вы возобновили через SDK или `claude -p`, начинал свои итоги с нуля, поэтому результаты каждого вызова охватывали только этот вызов.

244 

245В режиме потоковой передачи входных данных прочитайте общую сумму каждого вызова, как описано в разделе [Отслеживание затрат в режиме потоковой передачи входных данных](#track-costs-in-streaming-input-mode). Для вызова, который завершился сбоем, см. раздел [Восстановление итогов после сбоя сеанса](#recover-totals-after-a-session-crash).

236 246 

237В следующих примерах выполняются два вызова `query()` последовательно, каждый `total_cost_usd` вызова добавляется к текущему итогу, и выводятся как стоимость для каждого вызова, так и общая стоимость:247В следующих примерах выполняются два вызова `query()` последовательно, каждый `total_cost_usd` вызова добавляется к текущему итогу, и выводятся как стоимость для каждого вызова, так и общая стоимость:

238 248 

338 348 

339Когда процесс Claude Code падает, он выдает финальный результат `error_during_execution` и выходит как в режиме одноразового ввода, так и в режиме потокового ввода. Этот результат может содержать обнуленные `usage`, `total_cost_usd` и `modelUsage`, поэтому восстановите итоги вызова из того, что пришло до него. Шаг 1 восстанавливает полные итоги всякий раз, когда существует более ранний результат; резервный вариант на шаге 2 восстанавливает только входные токены и токены кеша основного цикла.349Когда процесс Claude Code падает, он выдает финальный результат `error_during_execution` и выходит как в режиме одноразового ввода, так и в режиме потокового ввода. Этот результат может содержать обнуленные `usage`, `total_cost_usd` и `modelUsage`, поэтому восстановите итоги вызова из того, что пришло до него. Шаг 1 восстанавливает полные итоги всякий раз, когда существует более ранний результат; резервный вариант на шаге 2 восстанавливает только входные токены и токены кеша основного цикла.

340 350 

3411. Используйте результат хода перед сбоем. В режиме потокового ввода он содержит текущий итог с начала вызова или с момента последнего [`/clear`](#track-costs-in-streaming-input-mode). Перейдите к шагу 2, если этот результат не может вам помочь:3511. Используйте результат хода перед сбоем. В режиме потокового ввода он содержит текущий итог, описанный в [Track costs in streaming input mode](#track-costs-in-streaming-input-mode). Перейдите к шагу 2, если этот результат не может вам помочь:

342 * Вызов был одноразовым, поэтому более ранний результат не существует.352 * Вызов был одноразовым, поэтому более ранний результат не существует.

343 * Сбой произошел на первом ходу.353 * Сбой произошел на первом ходу.

344 * Ход перед сбоем был самим `/clear`, поэтому его результат охватывает только сброс.354 * Ход перед сбоем был самим `/clear`, поэтому его результат охватывает только сброс.

Details

10 10 

11На этой странице рассматривается самостоятельное размещение на вашей собственной инфраструктуре. Для развертываемых Dockerfile и манифестов Kubernetes см. [hosting cookbook](https://github.com/anthropics/claude-cookbooks/tree/main/claude_agent_sdk/hosting).11На этой странице рассматривается самостоятельное размещение на вашей собственной инфраструктуре. Для развертываемых Dockerfile и манифестов Kubernetes см. [hosting cookbook](https://github.com/anthropics/claude-cookbooks/tree/main/claude_agent_sdk/hosting).

12 12 

13Если вам не требуется контроль инфраструктуры, пользовательская изоляция или собственная плоскость данных, рассмотрите вместо этого [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview): размещенный REST API, где Anthropic запускает агент и песочницу, поэтому ваше приложение отправляет события и получает результаты обратно без необходимости управления инфраструктурой размещения.13Если вам не требуется запускать сам цикл агента на вашей собственной инфраструктуре, рассмотрите вместо этого [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview). Anthropic размещает цикл агента, и ваше приложение отправляет события и получает потоковые результаты через клиентские SDK или REST API. Выполнение инструментов происходит в управляемой Anthropic облачной песочнице или в [самостоятельно размещаемой песочнице](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes) на вашей собственной инфраструктуре.

14 14 

15<h2 id="the-subprocess-model">15<h2 id="the-subprocess-model">

16 Модель подпроцесса16 Модель подпроцесса

Details

387* Если вы включите маркер более одного раза, первый — это разделение и SDK удаляет остальные.387* Если вы включите маркер более одного раза, первый — это разделение и SDK удаляет остальные.

388* Если вы опустите маркер, SDK объединяет все строки в один блок, то же самое, что передача одной строки.388* Если вы опустите маркер, SDK объединяет все строки в один блок, то же самое, что передача одной строки.

389 389 

390С флагами CLI [`--system-prompt` или `--system-prompt-file`](/docs/ru/cli-reference#system-prompt-flags), подсказка — это одна строка, поэтому нет массива для переноса маркера. Включите строку, содержащую только `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__`, между статической и частью для каждого запроса вместо этого. Claude Code разделяет подсказку на первой такой строке на те же два блока и удаляет эту строку. Требует Claude Code v2.1.275 или позже.

391 

392В SDK предпочитайте форму массива, которая переносит границу без строки маркера.

393 

390<h3 id="change-the-prompt-of-an-existing-session">394<h3 id="change-the-prompt-of-an-existing-session">

391 Изменение подсказки существующего сеанса395 Изменение подсказки существующего сеанса

392</h3>396</h3>

Details

12 Сравнение Agent SDK с другими инструментами Claude12 Сравнение Agent SDK с другими инструментами Claude

13</h2>13</h2>

14 14 

15Agent SDK, CLI, Client SDK и Managed Agents подходят для разных потребностей. Используйте таблицу, чтобы найти тот, который соответствует тому, что вы создаёте.15Agent SDK, CLI, Client SDK и Managed Agents отличаются тем, кто запускает агента, что входит в комплект и как вы его используете. Найдите строку, которая соответствует тому, как вы хотите создавать и запускать свой агент.

16 16 

17| Если вы... | Используйте | Почему |17| Что вы хотите | Используйте | Что вы получаете |

18| ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |18| ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

19| Создаёте агента без самостоятельной реализации цикла инструментов | **Agent SDK** | Библиотека Python или TypeScript, которая запускает цикл агента для вас. |19| Встроить агента Claude Code в собственное приложение Python или TypeScript, в процессе, который вы контролируете | **Agent SDK** | Библиотека, которая запускает бинарный файл Claude Code, с [возможностями](#capabilities) Claude Code, такими как встроенные инструменты, разрешения, сессии и hooks. |

20| Занимаетесь интерактивной разработкой или запускаете одноразовые задачи из терминала | [**Claude Code CLI**](/docs/ru/overview) | Интерфейс терминала, созданный для ежедневного интерактивного использования. |20| Выполнять интерактивную разработку или запускать одноразовые задачи из терминала | [**Claude Code CLI**](/docs/ru/overview) | Интерфейс терминала, созданный для ежедневного интерактивного использования. |

21| Вызываете API напрямую и реализуете цикл инструментов самостоятельно | [**Client SDK**](https://platform.claude.com/docs/en/api/client-sdks) | Прямой доступ к API Anthropic вместо Claude Code. Вы реализуете цикл инструментов самостоятельно. |21| Вызывать Claude API непосредственно из собственного кода | [**Client SDK**](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) | Прямой доступ к Claude API из любого из языков Client SDK. Вы сами пишете цикл инструментов или позволяете бета-версии [tool runner](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner) Client SDK управлять им. |

22| Запускаете долгоживущих или асинхронных агентов без управления собственной инфраструктурой sandbox или сессии | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | Размещённый REST API, отдельный продукт от Agent SDK. Anthropic запускает агента и sandbox. |22| Разместить агента в Anthropic, настроенного через Claude API | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | Размещённая оболочка агента, которая запускает цикл агента, с сессиями в управляемой Anthropic облачной песочнице или [самостоятельно размещённой песочнице](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes) на вашей собственной инфраструктуре. Используйте её из [SDK для вашего языка](https://platform.claude.com/docs/en/managed-agents/quickstart#install-the-sdk), CLI `ant` или REST API. |

23 23 

24SDK доступен как библиотека только для Python и TypeScript. Чтобы запустить тот же цикл агента из другого языка, [запустите CLI как подпроцесс](/docs/ru/headless) с флагом `-p` и `--output-format json`.24Чтобы запустить тот же цикл агента из языка, отличного от Python или TypeScript, [запустите CLI как подпроцесс](/docs/ru/headless) с флагом `-p` и `--output-format json`.

25 25 

26<h2 id="capabilities">26<h2 id="capabilities">

27 Возможности27 Возможности

Details

1485Используйте с полем `betas` в `ClaudeAgentOptions` для включения функций бета-версии.1485Используйте с полем `betas` в `ClaudeAgentOptions` для включения функций бета-версии.

1486 1486 

1487<Warning>1487<Warning>

1488 Бета-версия `context-1m-2025-08-07` снята с производства по состоянию на 30 апреля 2026 года. Передача этого заголовка с Claude Sonnet 4.5 или Sonnet 4 не имеет эффекта, и запросы, превышающие стандартное окно контекста 200k-токенов, возвращают ошибку. Чтобы использовать окно контекста 1M-токенов, перейдите на [Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7 или Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), которые включают контекст 1M по стандартной цене без требования заголовка бета-версии.1488 Бета-версия `context-1m-2025-08-07` снята с производства по состоянию на 30 апреля 2026 года. Передача этого заголовка с Claude Sonnet 4.5 или Sonnet 4 не имеет эффекта, и запросы, превышающие стандартное окно контекста 200k-токенов, возвращают ошибку. Чтобы использовать окно контекста 1M-токенов, перейдите на [Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.7 или Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview), которые включают контекст 1M по стандартной цене без требования заголовка бета-версии.

1489</Warning>1489</Warning>

1490 1490 

1491<h3 id="mcpsdkserverconfig">1491<h3 id="mcpsdkserverconfig">

1797 1797 

1798Словарь `model_usage` отображает имена моделей на использование для каждой модели. Он охватывает каждый вызов модели, сделанный через конвейер запроса: основной цикл, подагентов и внутренние вызовы, такие как компактирование и агентов Workflow. Вспомогательные вызовы вне этого конвейера, такие как классификатор разрешений и запросы подсчета токенов, исключены из `model_usage`. Рассматривайте `model_usage` как оценку, а не как выписку по счету.1798Словарь `model_usage` отображает имена моделей на использование для каждой модели. Он охватывает каждый вызов модели, сделанный через конвейер запроса: основной цикл, подагентов и внутренние вызовы, такие как компактирование и агентов Workflow. Вспомогательные вызовы вне этого конвейера, такие как классификатор разрешений и запросы подсчета токенов, исключены из `model_usage`. Рассматривайте `model_usage` как оценку, а не как выписку по счету.

1799 1799 

1800В [режиме потоковой передачи входных данных](/docs/ru/agent-sdk/streaming-vs-single-mode) `model_usage` и `total_cost_usd` являются кумулятивными по ходам, поэтому читайте последний результат вместо суммирования по результатам. См. [Track costs in streaming input mode](/docs/ru/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) для сбросов и [Recover totals after a session crash](/docs/ru/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) для обнуленных результатов.1800В [режиме потоковой передачи входных данных](/docs/ru/agent-sdk/streaming-vs-single-mode) `model_usage` и `total_cost_usd` являются кумулятивными по ходам, поэтому читайте последний результат вместо суммирования по результатам. Вызов, который возобновляет сеанс, также учитывает [итоги, восстановленные из более ранних вызовов сеанса](/docs/ru/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). См. [Track costs in streaming input mode](/docs/ru/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) для сбросов и [Recover totals after a session crash](/docs/ru/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) для обнуленных результатов.

1801 1801 

1802Каждое значение в `model_usage` - это TypedDict `ModelUsage`, импортируемый через `from claude_agent_sdk.types import ModelUsage`. Его ключи используют camelCase, потому что SDK передает значение без изменений из базового процесса CLI, соответствуя типу TypeScript [`ModelUsage`](/docs/ru/agent-sdk/typescript#modelusage):1802Каждое значение в `model_usage` - это TypedDict `ModelUsage`, импортируемый через `from claude_agent_sdk.types import ModelUsage`. Его ключи используют camelCase, потому что SDK передает значение без изменений из базового процесса CLI, соответствуя типу TypeScript [`ModelUsage`](/docs/ru/agent-sdk/typescript#modelusage):

1803 1803 

2921 "command": str | None, # Скрипт оболочки; каждая строка stdout является событием, выход завершает наблюдение2921 "command": str | None, # Скрипт оболочки; каждая строка stdout является событием, выход завершает наблюдение

2922 "ws": dict | None, # Источник WebSocket: {"url": str, "protocols": list[str] | None}; каждый текстовый фрейм является событием2922 "ws": dict | None, # Источник WebSocket: {"url": str, "protocols": list[str] | None}; каждый текстовый фрейм является событием

2923 "description": str, # Краткое описание, показываемое в уведомлениях2923 "description": str, # Краткое описание, показываемое в уведомлениях

2924 "timeout_ms": int | None, # Завершить после этого срока (по умолчанию 300000, макс 3600000)2924 "timeout_ms": int | None, # Завершить после этого срока (по умолчанию 300000, макс 3600000; эффективный срок составляет максимум 1800000)

2925 "persistent": bool | None, # Запускать в течение всего времени сеанса; остановить с помощью TaskStop

2926}2925}

2927```2926```

2928 2927 

2931```python theme={null}2930```python theme={null}

2932{2931{

2933 "taskId": str, # ID фоновой задачи мониторинга2932 "taskId": str, # ID фоновой задачи мониторинга

2934 "timeoutMs": int, # Срок тайм-аута в миллисекундах (0 при постоянном режиме)2933 "timeoutMs": int, # Эффективный срок тайм-аута в миллисекундах

2935 "persistent": bool | None, # True при выполнении до TaskStop или конца сеанса2934 "persistent": bool | None, # False: каждое наблюдение имеет срок

2936}2935}

2937```2936```

2938 2937 

3348 TaskOutput3347 TaskOutput

3349</h3>3348</h3>

3350 3349 

3351**Имя инструмента:** `TaskOutput`. Предыдущее имя `BashOutput` по-прежнему принимается как псевдоним.3350Удалено в Claude Code v2.1.277. Ранее получало вывод из запущенной или завершенной фоновой задачи, с `BashOutput`, принимаемым как псевдоним; Claude читает выходной файл фоновой задачи с помощью `Read` вместо этого.

3352 3351 

3353<Note>`TaskOutput` устарело; предпочитайте `Read` на пути выходного файла задачи. Приведенные ниже схемы остаются действительными для hooks и обработчиков разрешений, которые встречают инструмент.</Note>3352Запись `disallowed_tools` или правило отказа, которое по-прежнему называет любое имя, игнорируется без предупреждения.

3354 

3355**Ввод:**

3356 

3357```python theme={null}

3358{

3359 "task_id": str, # ID задачи для получения вывода

3360 "block": bool, # Ждать ли завершения (по умолчанию True)

3361 "timeout": int, # Максимальное время ожидания в мс (по умолчанию 30000)

3362}

3363```

3364 

3365**Вывод:**

3366 

3367```python theme={null}

3368{

3369 "retrieval_status": "success" | "timeout" | "not_ready", # Был ли получен вывод

3370 "task": dict | None, # Детали задачи: task_id, task_type, status, description, output, плюс поля, специфичные для типа, такие как exitCode

3371}

3372```

3373 3353 

3374<h3 id="taskstop">3354<h3 id="taskstop">

3375 TaskStop3355 TaskStop

3627```3607```

3628 3608 

3629| Property | Type | Default | Description |3609| Property | Type | Default | Description |

3630| :-------------------------- | :---------------------------------------------------- | :------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3610| :-------------------------- | :---------------------------------------------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

3631| `enabled` | `bool` | `False` | Включить режим sandbox для выполнения команд |3611| `enabled` | `bool` | `False` | Включить режим sandbox для выполнения команд |

3632| `autoAllowBashIfSandboxed` | `bool` | `True` | Автоматически одобрять bash команды, когда sandbox включен |3612| `autoAllowBashIfSandboxed` | `bool` | `True` | Автоматически одобрять bash команды, когда sandbox включен |

3633| `excludedCommands` | `list[str]` | `[]` | Команды, которые всегда обходят ограничения sandbox (например, `["docker"]`). Они выполняются без sandbox автоматически без участия модели |3613| `excludedCommands` | `list[str]` | `[]` | Команды, которые обходят ограничения sandbox, такие как `["docker *"]`. Они выполняются без sandbox автоматически без участия модели; [`sandbox.excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands) описывает, когда применяется запись |

3634| `allowUnsandboxedCommands` | `bool` | `True` | Разрешить модели запрашивать выполнение команд вне sandbox. Когда `True`, модель может установить `dangerouslyDisableSandbox` в входных данных инструмента, что переходит к [системе разрешений](#permissions-fallback-for-unsandboxed-commands) |3614| `allowUnsandboxedCommands` | `bool` | `True` | Разрешить модели запрашивать выполнение команд вне sandbox. Когда `True`, модель может установить `dangerouslyDisableSandbox` в входных данных инструмента, что переходит к [системе разрешений](#permissions-fallback-for-unsandboxed-commands) |

3635| `network` | [`SandboxNetworkConfig`](#sandboxnetworkconfig) | `None` | Конфигурация sandbox для сети |3615| `network` | [`SandboxNetworkConfig`](#sandboxnetworkconfig) | `None` | Конфигурация sandbox для сети |

3636| `ignoreViolations` | [`SandboxIgnoreViolations`](#sandboxignoreviolations) | `None` | Настройка того, какие нарушения sandbox игнорировать |3616| `ignoreViolations` | [`SandboxIgnoreViolations`](#sandboxignoreviolations) | `None` | Настройка того, какие нарушения sandbox игнорировать |

3735 Fallback системы разрешений для команд без Sandbox3715 Fallback системы разрешений для команд без Sandbox

3736</h3>3716</h3>

3737 3717 

3738Когда `allowUnsandboxedCommands` включен, модель может запросить выполнение команд вне sandbox, установив `dangerouslyDisableSandbox: True` во входных данных инструмента. Эти запросы переходят к существующей системе разрешений, что означает, что ваш обработчик `can_use_tool` будет вызван, позволяя вам реализовать пользовательскую логику авторизации. Команды, указанные в `excludedCommands`, вместо этого автоматически обходят sandbox без участия модели; см. [`SandboxSettings`](#sandboxsettings).3718Когда `allowUnsandboxedCommands` включен, модель может запросить выполнение команд вне sandbox, установив `dangerouslyDisableSandbox: True` во входных данных инструмента. Эти запросы переходят к существующей системе разрешений, что означает, что ваш обработчик `can_use_tool` будет вызван, позволяя вам реализовать пользовательскую логику авторизации.

3719 

3720Ваши записи `excludedCommands` вместо этого выводят команду из sandbox без участия модели; [`sandbox.excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands) описывает, когда применяется запись.

3739 3721 

3740Следующий пример регистрирует каждый запрос без sandbox и отклоняет его, если только ваша собственная логика авторизации не разрешит это:3722Следующий пример регистрирует каждый запрос без sandbox и отклоняет его, если только ваша собственная логика авторизации не разрешит это:

3741 3723 

Details

747 747 

748Если Claude выполняет задачи напрямую вместо делегирования вашему подагенту:748Если Claude выполняет задачи напрямую вместо делегирования вашему подагенту:

749 749 

750* **Используйте явное указание**: упомяните подагента по имени в своем промпте, например "Use the code-reviewer agent to..."750* **Используйте явное указание**: упомяните подагента по имени в своем промпте, например "Use the code-reviewer agent to check the authentication module"

751* **Напишите четкое описание**: объясните ровно, когда следует использовать подагента, чтобы Claude мог правильно сопоставить задачи751* **Напишите четкое описание**: объясните ровно, когда следует использовать подагента, чтобы Claude мог правильно сопоставить задачи

752 752 

753<h3 id="filesystem-based-agents-not-loading">753<h3 id="filesystem-based-agents-not-loading">

Details

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

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

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

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

313| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного подагента](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), `agentId` подагента, который его запустил. `null` для сообщений основной сессии, сообщений от подагентов верхнего уровня и более старых сессий. Требуется Claude Code v2.1.202 или позже |313| `parent_agent_id` | `string \| null` | Для сообщений от [вложенного подагента](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), `agentId` подагента, который его запустил. `null` для сообщений основной сессии, сообщений от подагентов верхнего уровня и более старых сессий. Требуется Claude Code v2.1.202 или позже |

314 314 

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

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

505| `fallbackModel` | `string` | `undefined` | Модель для использования, если основная модель не работает. Принимает список, разделенный запятыми. Для порядка и ограничения см. [Цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains). Для рекомендаций см. [Выберите модель](/docs/ru/agent-sdk/configuration#choose-a-model) |505| `fallbackModel` | `string` | `undefined` | Модель для использования, если основная модель не работает. Принимает список, разделенный запятыми. Для порядка и ограничения см. [Цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains). Для рекомендаций см. [Выберите модель](/docs/ru/agent-sdk/configuration#choose-a-model) |

506| `forkSession` | `boolean` | `false` | При возобновлении с `resume` разветвить на новый ID сеанса вместо продолжения исходного сеанса |506| `forkSession` | `boolean` | `false` | При возобновлении с `resume` разветвить на новый ID сеанса вместо продолжения исходного сеанса |

507| `forwardSubagentText` | `boolean` | `false` | Пересылать текст подагента и блоки мышления как сообщения помощника и пользователя с установленным `parent_tool_use_id`, чтобы потребители могли отобразить вложенную стенограмму. Без этого параметра Claude Code выдает блоки `tool_use` и `tool_result` подагента, но не текст или мышление. Сообщения от подагентов на каждой глубине вложенности пересылаются на Claude Code v2.1.219 и позже; до v2.1.219 появлялись только сообщения от подагентов глубины 1 |507| `forwardSubagentText` | `boolean` | `false` | Пересылать текст подагента и блоки мышления как сообщения помощника и пользователя с установленным `parent_tool_use_id`, чтобы потребители могли отобразить вложенную стенограмму. Без этого параметра Claude Code выдает блоки `tool_use` и `tool_result` подагента, но не текст или мышление. Сообщения от подагентов на каждой глубине вложенности пересылаются на Claude Code v2.1.219 и позже; до v2.1.219 появлялись только сообщения от подагентов глубины 1. Сообщения подагентов, которые разветвленный навык порождает, и вложенные разветвленные навыки требуют v2.1.275 или позже |

508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Обратные вызовы hook для событий |508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | Обратные вызовы hook для событий |

509| `includeHookEvents` | `boolean` | `false` | Включить события жизненного цикла hook в поток сообщений как [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage) и [`SDKHookResponseMessage`](#sdkhookresponsemessage). События жизненного цикла для hook `SessionStart` и `Setup` всегда включены и не требуют этого параметра. Некоторые события hook, такие как `Notification`, `SessionEnd`, `PreCompact` и `PostCompact`, никогда не создают `SDKHookStartedMessage`, даже с этим параметром. Для этих событий Claude Code все еще выдает `SDKHookProgressMessage`, пока hook команды работает более одной секунды, и выдает `SDKHookResponseMessage` только когда hook [работающий в фоновом режиме](/docs/ru/hooks#run-hooks-in-the-background) завершается |509| `includeHookEvents` | `boolean` | `false` | Включить события жизненного цикла hook в поток сообщений как [`SDKHookStartedMessage`](#sdkhookstartedmessage), [`SDKHookProgressMessage`](#sdkhookprogressmessage) и [`SDKHookResponseMessage`](#sdkhookresponsemessage). События жизненного цикла для hook `SessionStart` и `Setup` всегда включены и не требуют этого параметра. Некоторые события hook, такие как `Notification`, `SessionEnd`, `PreCompact` и `PostCompact`, никогда не создают `SDKHookStartedMessage`, даже с этим параметром. Для этих событий Claude Code все еще выдает `SDKHookProgressMessage`, пока hook команды работает более одной секунды, и выдает `SDKHookResponseMessage` только когда hook [работающий в фоновом режиме](/docs/ru/hooks#run-hooks-in-the-background) завершается |

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

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

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

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

528| `projectConfigRoot` | `string` | `undefined` | Абсолютный путь доверенного checkout, который `cwd` является worktree. Claude Code читает параметры проекта, `.mcp.json` и команды, агентов, навыки, рабочие процессы, процедуры и стили вывода проекта `.claude/` из этого каталога вместо `cwd`, и устанавливает `CLAUDE_PROJECT_DIR` на него. hooks, вспомогательные скрипты, такие как `apiKeyHelper`, и stdio MCP серверы начинают с этого каталога как их рабочего каталога. Файлы `CLAUDE.md` и `.claude/rules/` по-прежнему загружаются из `cwd`. Требует Claude Code v2.1.275 или позже |

528| `promptSuggestions` | `boolean` | `false` | Включить предложения подсказок. После хода Claude Code выдает сообщение `prompt_suggestion`, содержащее предсказанную следующую подсказку пользователя. Claude Code не генерирует предложение для некоторых ходов, например, когда ваша учетная запись близка к лимиту использования или находится на нем. См. [Когда Claude Code пропускает предложения](/docs/ru/interactive-mode#when-claude-code-skips-suggestions) |529| `promptSuggestions` | `boolean` | `false` | Включить предложения подсказок. После хода Claude Code выдает сообщение `prompt_suggestion`, содержащее предсказанную следующую подсказку пользователя. Claude Code не генерирует предложение для некоторых ходов, например, когда ваша учетная запись близка к лимиту использования или находится на нем. См. [Когда Claude Code пропускает предложения](/docs/ru/interactive-mode#when-claude-code-skips-suggestions) |

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

530| `resumeDropsTurn` | `string` | `undefined` | С `resumeSessionAt`: UUID подсказки хода, который усеченное возобновление намеревается отбросить. Claude Code отказывает в возобновлении, когда отброшенный диапазон содержит что-либо, не относящееся к этому ходу, такое как поглощенные сообщения в очереди или уведомления о задачах, и называет флаг `--resume-drops-turn` в сообщении об отказе. Только Agent SDK и возобновления в режиме печати читают пару. Требует Claude Code v2.1.223 или позже |531| `resumeDropsTurn` | `string` | `undefined` | С `resumeSessionAt`: UUID подсказки хода, который усеченное возобновление намеревается отбросить. Claude Code отказывает в возобновлении, когда отброшенный диапазон содержит что-либо, не относящееся к этому ходу, такое как поглощенные сообщения в очереди или уведомления о задачах, и называет флаг `--resume-drops-turn` в сообщении об отказе. Только Agent SDK и возобновления в режиме печати читают пару. Требует Claude Code v2.1.223 или позже |

600 : Settings[K] | null;601 : Settings[K] | null;

601 }): Promise<void>;602 }): Promise<void>;

602 updateSettings(603 updateSettings(

603 source: 'localSettings',604 source: 'localSettings' | 'userSettings',

604 settings: Record<string, unknown>,605 settings: Record<string, unknown>,

605 ): Promise<void>;606 ): Promise<void>;

606 initializationResult(): Promise<SDKControlInitializeResponse>;607 initializationResult(): Promise<SDKControlInitializeResponse>;

639| `setModel()` | Изменяет модель (доступно только в режиме потокового ввода). Передача `undefined` или строки `"default"` сбрасывает на [модель Claude Code по умолчанию](/docs/ru/model-config) |640| `setModel()` | Изменяет модель (доступно только в режиме потокового ввода). Передача `undefined` или строки `"default"` сбрасывает на [модель Claude Code по умолчанию](/docs/ru/model-config) |

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

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

642| `updateSettings(source, settings)` | Объединяет параметры в файл локальных параметров проекта, `.claude/settings.local.json`; они вступают в силу при следующем запросе. Принимает только `source: 'localSettings'` и список разрешенных ключей, в настоящее время `outputStyle`, со строковыми значениями; удаление ключа не поддерживается. Отклоняет удаленные транспорты и сеансы, чьи [`settingSources`](#options) исключают `local`. Требует TypeScript SDK v0.3.257 или позже, который поставляется с Claude Code v2.1.257 |643| `updateSettings(source, settings)` | Записывает один разрешенный ключ в файл локальных параметров проекта или файл параметров пользователя, чтобы значение сохранялось для последующих сеансов. См. [`updateSettings()`](#updatesettings). Требует TypeScript SDK v0.3.257 или позже, который поставляется с Claude Code v2.1.257 |

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

644| `reinitialize()` | Повторно отправляет запрос управления `initialize` на работающий CLI и возвращает свежий результат вместо кэшированного результата первого подключения. Используйте его после разрыва транспорта, например, переподключение к сеансу после отключения, чтобы ожидающие запросы разрешений снова достигли вашего обратного вызова `canUseTool`. Сделайте обратный вызов идемпотентным для каждого ID запроса, потому что запрос, чей ответ был потерян, отправляется снова. Требует Claude Code v2.1.195 или позже |645| `reinitialize()` | Повторно отправляет запрос управления `initialize` на работающий CLI и возвращает свежий результат вместо кэшированного результата первого подключения. Используйте его после разрыва транспорта, например, переподключение к сеансу после отключения, чтобы ожидающие запросы разрешений снова достигли вашего обратного вызова `canUseTool`. Сделайте обратный вызов идемпотентным для каждого ID запроса, потому что запрос, чей ответ был потерян, отправляется снова. Требует Claude Code v2.1.195 или позже |

645| `supportedCommands()` | Возвращает доступные команды. Из Agent SDK v0.3.216 список отражает изменения команд в середине сеанса; см. [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |646| `supportedCommands()` | Возвращает доступные команды. Из Agent SDK v0.3.216 список отражает изменения команд в середине сеанса; см. [`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) |

673 674 

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

675 676 

676Последовательные вызовы выполняют поверхностное слияние ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не глубоко объединяется в него. Чтобы очистить ключ из уровня флага, передайте `null` для этого ключа. Большинство ключей затем возвращаются к источникам с более низким приоритетом. Очищенный `model` сбрасывается на [модель Claude Code по умолчанию](/docs/ru/model-config), даже когда файл параметров устанавливает `model`. Передача `undefined` не имеет эффекта, потому что сериализация JSON удаляет ее.677Последовательные вызовы выполняют поверхностное слияние ключей верхнего уровня. Второй вызов с `{ permissions: {...} }` заменяет весь объект `permissions` из предыдущего вызова, а не глубоко объединяется в него.

678 

679Чтобы очистить ключ, который вы установили с помощью `applyFlagSettings()`, передайте `null` для этого ключа. Большинство ключей затем возвращаются к значению, которое параметр `settings` функции `query()` установил при запуске, затем к источникам с более низким приоритетом. Очищенный `model` сбрасывается на [модель Claude Code по умолчанию](/docs/ru/model-config), даже когда файл параметров устанавливает `model`. Передача `undefined` не имеет эффекта, потому что сериализация JSON удаляет ее.

680 

681Три ключа помимо `model` сбрасывают состояние сеанса вместо возврата:

682 

683* `effortLevel: null` возвращает сеанс к уровню усилий модели по умолчанию, а не к параметру `effort` функции `query()` или `effortLevel` из файла параметров.

684* `agent: null` запускает основной поток без агента, начиная со следующего хода, а не восстанавливает параметр `agent` функции `query()` или `agent` из файла параметров. Если очищенный агент применил свою собственную модель, сеанс возвращается к модели, которую он разрешил при запуске.

685* `ultracode: null` отключает ultracode, как это делает `false`, а не восстанавливает значение `ultracode` из файла параметров. Сеанс сохраняет свой текущий уровень усилий, поэтому передайте `effortLevel` в том же вызове, чтобы его изменить.

677 686 

678Доступно только в режиме потокового ввода, то же ограничение, что и `setModel()` и `setPermissionMode()`.687Доступно только в режиме потокового ввода, то же ограничение, что и `setModel()` и `setPermissionMode()`.

679 688 

695 `applyFlagSettings()` только для TypeScript. Python SDK не предоставляет эквивалентный метод.704 `applyFlagSettings()` только для TypeScript. Python SDK не предоставляет эквивалентный метод.

696</Note>705</Note>

697 706 

707<h4 id="updatesettings">

708 `updateSettings()`

709</h4>

710 

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

712 

713* **`"localSettings"`**: принимает `outputStyle` и объединяет его в файл локальных параметров проекта, `.claude/settings.local.json`. Новый стиль вступает в силу при следующем запросе сеанса.

714* **`"userSettings"`**: принимает `effortLevel` и сохраняет его как [уровень усилий](/docs/ru/model-config#adjust-effort-level) по умолчанию для текущей модели сеанса, под [`modelSettings`](/docs/ru/settings-reference#modelsettings) в файле параметров пользователя. Передача `max` ничего не записывает, потому что `max` только для сеанса. Работающий сеанс сохраняет свой текущий уровень усилий в любом случае, поэтому вызовите [`applyFlagSettings()`](#applyflagsettings) когда вы также хотите это изменить. Этот источник требует TypeScript SDK v0.3.277 или позже, который поставляется с Claude Code v2.1.277.

715 

716Вызов отклоняется, когда запрос содержит любой другой ключ, когда сеанс работает через удаленный транспорт, и когда [`settingSources`](#options) сеанса исключают источник, который вы назвали. Удаление ключа не поддерживается.

717 

698<h3 id="warmquery">718<h3 id="warmquery">

699 `WarmQuery`719 `WarmQuery`

700</h3>720</h3>

1368 uuid?: UUID;1388 uuid?: UUID;

1369 session_id?: string;1389 session_id?: string;

1370 message: MessageParam; // From Anthropic SDK1390 message: MessageParam; // From Anthropic SDK

1391 pasted_content?: MessageParam["content"][];

1371 parent_tool_use_id: string | null;1392 parent_tool_use_id: string | null;

1372 isSynthetic?: boolean;1393 isSynthetic?: boolean;

1373 shouldQuery?: boolean;1394 shouldQuery?: boolean;

1376};1397};

1377```1398```

1378 1399 

1400Установите `pasted_content` для отправки содержимого, которое пользователь вставил в ваш пользовательский интерфейс подсказки, а не напечатал, одна запись на вставку, каждая — строка или массив блоков содержимого. Claude Code добавляет текст каждой записи после напечатанного текста по порядку и может обернуть каждую вставку в теги `<pasted_content>`. Блоки, отличные от текста, игнорируются, поэтому отправляйте изображения и документы в `message.content`. Требует Agent SDK v0.3.277 или позже.

1401 

1379Установите `shouldQuery` в `false`, чтобы добавить сообщение в стенограмму без запуска хода ассистента. Сообщение удерживается и объединяется со следующим пользовательским сообщением, которое запускает ход. Используйте это для внедрения контекста, такого как вывод команды, которую вы запустили вне полосы, без затрат вызова модели на это.1402Установите `shouldQuery` в `false`, чтобы добавить сообщение в стенограмму без запуска хода ассистента. Сообщение удерживается и объединяется со следующим пользовательским сообщением, которое запускает ход. Используйте это для внедрения контекста, такого как вывод команды, которую вы запустили вне полосы, без затрат вызова модели на это.

1380 1403 

1381На сообщении, которое содержит блок `tool_result`, `tool_use_result` — это структурированный объект вывода инструмента, а не текст, отправленный модели. Его форма зависит от инструмента, названного соответствующим блоком `tool_use`, поэтому поле типизировано как `unknown`; встроенные формы перечислены в разделе [Tool Output Types](#tool-output-types).1404На сообщении, которое содержит блок `tool_result`, `tool_use_result` — это структурированный объект вывода инструмента, а не текст, отправленный модели. Его форма зависит от инструмента, названного соответствующим блоком `tool_use`, поэтому поле типизировано как `unknown`; встроенные формы перечислены в разделе [Tool Output Types](#tool-output-types).

1488* `first_content_frame_ms`: время в миллисекундах до первого события потока `content_block_start` или `content_block_delta`, считая блоки мышления как содержимое. Присутствует только на ветви успеха, когда `is_error` имеет значение false. Требует Agent SDK v0.3.260 или позже.1511* `first_content_frame_ms`: время в миллисекундах до первого события потока `content_block_start` или `content_block_delta`, считая блоки мышления как содержимое. Присутствует только на ветви успеха, когда `is_error` имеет значение false. Требует Agent SDK v0.3.260 или позже.

1489* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: сроки загрузки первого события потока хода. Claude Code записывает их только в сеансах, которые он потоком передаёт на claude.ai, такие как [облачные сеансы](/docs/ru/claude-code-on-the-web), и результаты, которые выдаёт `query()`, их не содержат. Требует Agent SDK v0.3.260 или позже.1512* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: сроки загрузки первого события потока хода. Claude Code записывает их только в сеансах, которые он потоком передаёт на claude.ai, такие как [облачные сеансы](/docs/ru/claude-code-on-the-web), и результаты, которые выдаёт `query()`, их не содержат. Требует Agent SDK v0.3.260 или позже.

1490* `usage`: только основной цикл агента. Исключает вызовы подагента и вспомогательной модели и является за ход в сеансах с потоковым вводом. Предпочитайте `modelUsage` для учёта токенов/затрат.1513* `usage`: только основной цикл агента. Исключает вызовы подагента и вспомогательной модели и является за ход в сеансах с потоковым вводом. Предпочитайте `modelUsage` для учёта токенов/затрат.

1491* `modelUsage`: итоги по моделям для каждого вызова модели, сделанного через конвейер запросов во время этого вызова `query()`, включая основной цикл, подагентов и внутренние вызовы, такие как компактирование и агентов Workflow. Вспомогательные вызовы вне этого конвейера, такие как классификатор разрешений и запросы подсчёта токенов, исключены. В сеансах с потоковым вводом итоги накапливаются по ходам, поэтому читайте последний результат, а не суммируйте по результатам. См. [Track costs in streaming input mode](/docs/ru/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) для сбросов и [Recover totals after a session crash](/docs/ru/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) для обнулённых результатов.1514* `modelUsage`: итоги по моделям для каждого вызова модели, сделанного через конвейер запросов во время этого вызова `query()`, включая основной цикл, подагентов и внутренние вызовы, такие как компактирование и агентов Workflow. Вспомогательные вызовы вне этого конвейера, такие как классификатор разрешений и запросы подсчёта токенов, исключены. Вызов, который возобновляет сеанс, также учитывает [итоги по моделям, восстановленные из более ранних вызовов сеанса](/docs/ru/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). В сеансах с потоковым вводом итоги накапливаются по ходам, поэтому читайте последний результат, а не суммируйте по результатам. См. [Track costs in streaming input mode](/docs/ru/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) для сбросов и [Recover totals after a session crash](/docs/ru/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) для обнулённых результатов.

1492* `total_cost_usd`: кумулятивная предполагаемая стоимость в USD для этого вызова `query()`, охватывающая те же вызовы, что и `modelUsage`, и сбрасываемая в тех же точках. Это оценка, а не выписка по счёту. См. [Track cost and usage](/docs/ru/agent-sdk/cost-tracking) для предостережений по точности.1515* `total_cost_usd`: кумулятивная предполагаемая стоимость в USD, охватывающая те же вызовы, что и `modelUsage`, и сбрасываемая в тех же точках. Вызов, который возобновляет сеанс, также учитывает [итоги, восстановленные из более ранних вызовов сеанса](/docs/ru/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Это оценка, а не выписка по счёту. См. [Track cost and usage](/docs/ru/agent-sdk/cost-tracking) для предостережений по точности.

1493* `queued_turn_count`: количество сообщений, которые вы отправили с `origin: { kind: "human" }`, которые всё ещё ожидают, когда Claude Code создал результат. См. [`queued_turn_count`](#queued_turn_count) для того, что говорят вам `0` и отсутствующее поле.1516* `queued_turn_count`: количество сообщений, которые вы отправили с `origin: { kind: "human" }`, которые всё ещё ожидают, когда Claude Code создал результат. См. [`queued_turn_count`](#queued_turn_count) для того, что говорят вам `0` и отсутствующее поле.

1494* `startup_failure_reason`: почему Claude Code отказался запускаться, на результате `error_during_execution`, который он записывает перед выходом при известной ошибке запуска. См. [`startup_failure_reason`](#startup_failure_reason) для значений и того, какие ошибки его содержат. Требует Agent SDK v0.3.274 или позже.1517* `startup_failure_reason`: почему Claude Code отказался запускаться, на результате `error_during_execution`, который он записывает перед выходом при известной ошибке запуска. См. [`startup_failure_reason`](#startup_failure_reason) для значений и того, какие ошибки его содержат. Требует Agent SDK v0.3.274 или позже.

1495* `terminal_reason`: почему цикл завершился. Одно из значений: `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"` или `"turn_setup_failed"`.1518* `terminal_reason`: почему цикл завершился. Одно из значений: `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"` или `"turn_setup_failed"`.

1515 1538 

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

1517 1540 

1541Когда несколько завершений фоновой задачи ставятся в очередь вместе, Claude Code может ответить на них в одном ходу, а не в одном ходу каждый. Каждое завершение всё ещё создаёт свой результат с этим происхождением. Все, кроме последнего из завершений, на которые Claude Code отвечает вместе, создают пустые результаты с `num_turns: 0` по порядку, и результат последнего содержит ход, который отвечает на них все.

1542 

1518Это поле отсутствует для результатов, выданных перед любым пользовательским ходом, такие как ошибки запуска.1543Это поле отсутствует для результатов, выданных перед любым пользовательским ходом, такие как ошибки запуска.

1519 1544 

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

2858 | ReadMcpResourceInput2883 | ReadMcpResourceInput

2859 | RefreshMcpToolsInput2884 | RefreshMcpToolsInput

2860 | RemoteTriggerInput2885 | RemoteTriggerInput

2861 | REPLInput

2862 | ReportFindingsInput2886 | ReportFindingsInput

2863 | ScheduleWakeupInput2887 | ScheduleWakeupInput

2864 | ShowOnboardingRolePickerInput2888 | ShowOnboardingRolePickerInput

2865 | TaskCreateInput2889 | TaskCreateInput

2866 | TaskGetInput2890 | TaskGetInput

2867 | TaskListInput2891 | TaskListInput

2868 | TaskOutputInput

2869 | TaskStopInput2892 | TaskStopInput

2870 | TaskUpdateInput2893 | TaskUpdateInput

2871 | TodoWriteInput2894 | TodoWriteInput

2960 2983 

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

2962 2985 

2963`timeout_ms` — это крайний срок наблюдения в миллисекундах. По умолчанию он равен 300000, а эффективный крайний срок составляет максимум 1800000, что составляет 30 минут. В крайний срок наблюдение заканчивается и Claude получает одно уведомление, чтобы он мог начать новое наблюдение, если оно ему всё ещё нужно.2986`timeout_ms` — это крайний срок наблюдения в миллисекундах. По умолчанию он равен 300000 и принимает значения до 3600000. Эффективный крайний срок составляет максимум 1800000, что составляет 30 минут, поэтому большее принятое значение сокращается до этого. В крайний срок наблюдение заканчивается и Claude получает одно уведомление, чтобы он мог начать новое наблюдение, если оно ему всё ещё нужно.

2964 2987 

2965Экспортированный тип отмечает `timeout_ms` как обязательный, потому что схема заполняет значение по умолчанию; вызов, который его опускает, проходит валидацию.2988Экспортированный тип отмечает `timeout_ms` как обязательный, потому что схема заполняет значение по умолчанию; вызов, который его опускает, проходит валидацию.

2966 2989 

2970 TaskOutput2993 TaskOutput

2971</h3>2994</h3>

2972 2995 

2973**Имя tool:** `TaskOutput`2996Удалено в Claude Code v2.1.277 вместе с его типом `TaskOutputInput`. Ранее получало вывод из выполняющейся или завершённой фоновой задачи; Claude читает выходной файл фоновой задачи с помощью `Read` вместо этого.

2974 2997 

2975<Note>`TaskOutput` устарело; предпочитайте `Read` на пути выходного файла задачи. Приведённые ниже схемы остаются действительными для hooks и обработчиков разрешений, которые встречают tool.</Note>2998Запись `disallowedTools` или правило отказа, которое всё ещё называет `TaskOutput`, игнорируется без предупреждения.

2976 

2977```typescript theme={null}

2978type TaskOutputInput = {

2979 task_id: string;

2980 block: boolean;

2981 timeout: number;

2982};

2983```

2984 

2985Получает вывод из выполняющейся или завершённой фоновой задачи.

2986 2999 

2987<h3 id="edit">3000<h3 id="edit">

2988 Edit3001 Edit

3477 REPL3490 REPL

3478</h3>3491</h3>

3479 3492 

3480**Имя tool:** `REPL`3493Удалено в v2.1.275. До v2.1.274 экспериментальный tool `REPL` можно было включить с помощью `CLAUDE_CODE_REPL=1` в опции [`env`](#options).

3481 

3482```typescript theme={null}

3483type REPLInput = {

3484 code: string;

3485 description?: string;

3486 timeout?: number;

3487};

3488```

3489 

3490Выполняет код JavaScript в постоянном REPL. Состояние сохраняется между вызовами и поддерживается top-level await. `timeout` в миллисекундах, по умолчанию 30000 и максимум 600000.

3491 

3492Типы экспортируются, но tool отключён в сессиях SDK, если вы не установите `CLAUDE_CODE_REPL=1` в опции [`env`](#options). Он также требует исполняемый файл `claude` на основе Bun, который предоставляет встроенный установщик.

3493 3494 

3494<h3 id="reportfindings">3495<h3 id="reportfindings">

3495 ReportFindings3496 ReportFindings

3535 action?: "publish" | "list";3536 action?: "publish" | "list";

3536 file_path?: string;3537 file_path?: string;

3537 favicon?: string;3538 favicon?: string;

3539 icon?: string;

3538 limit?: number;3540 limit?: number;

3539 scope?: "mine" | "shared" | "all";3541 scope?: "mine" | "shared" | "all";

3540 title?: string;3542 title?: string;

3547};3549};

3548```3550```

3549 3551 

3550Публикует локальный файл `.html` или `.md` как размещённую страницу артефакта или перечисляет опубликованные артефакты пользователя. Опустите `action` или передайте `"publish"` для публикации `file_path`, который обязателен для действия публикации вместе с `favicon`, одним или двумя эмодзи, которые отмечают артефакт в галерее пользователя. `title` называет опубликованную страницу на вкладке браузера и в галерее, когда HTML файл не имеет тега `<title>`. `url` нацеливается на существующий артефакт для обновления на месте вместо создания нового.3552Публикует локальный файл `.html` или `.md` как размещённую страницу артефакта или перечисляет опубликованные артефакты пользователя. Опустите `action` или передайте `"publish"` для публикации `file_path`, который обязателен для действия публикации. Каждое поле ниже применяется к публикации:

3553 

3554* `icon`: одно короткое общее слово для значка артефакта на вкладке браузера, такое как `chart` или `map`. Claude включает его при первой публикации и опускает при обновлении, что сохраняет сохранённый значок артефакта.

3555* `favicon`: устарело, и Claude его опускает.

3556* `title`: называет опубликованную страницу на вкладке браузера и в галерее, когда HTML файл не имеет тега `<title>`.

3557* `url`: нацеливается на существующий артефакт для обновления на месте вместо создания нового.

3551 3558 

3552`force` — это последняя мера перезаписи, которая отбрасывает более новую версию, опубликованную другой сессией. При конфликте неудачная публикация возвращает более новое содержимое; Claude объединяет его изменения с этим содержимым или повторно читает артефакт и публикует снова. Передавайте `force` только, когда пользователь явно просит отбросить эту версию.3559`force` — это последняя мера перезаписи, которая отбрасывает более новую версию, опубликованную другой сессией. При конфликте неудачная публикация возвращает более новое содержимое; Claude объединяет его изменения с этим содержимым или повторно читает артефакт и публикует снова. Передавайте `force` только, когда пользователь явно просит отбросить эту версию.

3553 3560 

3684 | ReadMcpResourceOutput3691 | ReadMcpResourceOutput

3685 | RefreshMcpToolsOutput3692 | RefreshMcpToolsOutput

3686 | RemoteTriggerOutput3693 | RemoteTriggerOutput

3687 | REPLOutput

3688 | ReportFindingsOutput3694 | ReportFindingsOutput

3689 | ScheduleWakeupOutput3695 | ScheduleWakeupOutput

3690 | ShowOnboardingRolePickerOutput3696 | ShowOnboardingRolePickerOutput

4534 4540 

4535Возвращает детали доставки, включая отправлено ли push или локальное уведомление и почему доставка была пропущена.4541Возвращает детали доставки, включая отправлено ли push или локальное уведомление и почему доставка была пропущена.

4536 4542 

4537<h3 id="repl-2">

4538 REPL

4539</h3>

4540 

4541**Имя инструмента:** `REPL`

4542 

4543```typescript theme={null}

4544type REPLOutput = {

4545 code: string;

4546 result: {

4547 [k: string]: unknown;

4548 };

4549 stdout: string;

4550 stderr: string;

4551 error?: string;

4552 registeredTools?: string[];

4553 images?: {

4554 base64: string;

4555 mediaType: string;

4556 }[];

4557 documents?: {

4558 base64: string;

4559 }[];

4560};

4561```

4562 

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

4564 

4565<h3 id="reportfindings-2">4543<h3 id="reportfindings-2">

4566 ReportFindings4544 ReportFindings

4567</h3>4545</h3>

4900 description: string;4878 description: string;

4901 argumentHint: string;4879 argumentHint: string;

4902 aliases?: string[];4880 aliases?: string[];

4881 builtin?: boolean;

4903};4882};

4904```4883```

4905 4884 

4885`builtin` это `true` в строке, когда команда является собственной Claude Code и ввод `/name` её запускает. Она отсутствует для команды, определённой пользователем, проектом, плагином или MCP сервером, и для встроенной команды, которую один из них [заменяет по имени](/docs/ru/skills#resolve-skills-that-share-a-name). Требует Agent SDK v0.3.277 или позже.

4886 

4906<h3 id="modelinfo">4887<h3 id="modelinfo">

4907 `ModelInfo`4888 `ModelInfo`

4908</h3>4889</h3>

5759```5740```

5760 5741 

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

5762| :-------------------------- | :---------------------------------------------------- | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |5743| :-------------------------- | :---------------------------------------------------- | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

5763| `enabled` | `boolean` | `false` | Включите режим sandbox для выполнения команд |5744| `enabled` | `boolean` | `false` | Включите режим sandbox для выполнения команд |

5764| `failIfUnavailable` | `boolean` | `true` | Остановитесь при запуске, если `enabled` имеет значение `true`, но sandbox не может запуститься. Установите `false` для возврата к выполнению без sandbox с предупреждением на stderr |5745| `failIfUnavailable` | `boolean` | `true` | Остановитесь при запуске, если `enabled` имеет значение `true`, но sandbox не может запуститься. Установите `false` для возврата к выполнению без sandbox с предупреждением на stderr |

5765| `autoAllowBashIfSandboxed` | `boolean` | `true` | Автоматически одобряйте bash команды, когда sandbox включён |5746| `autoAllowBashIfSandboxed` | `boolean` | `true` | Автоматически одобряйте bash команды, когда sandbox включён |

5766| `excludedCommands` | `string[]` | `[]` | Команды, которые всегда обходят ограничения sandbox (например, `['docker']`). Они работают без sandbox автоматически без участия модели |5747| `excludedCommands` | `string[]` | `[]` | Команды, которые обходят ограничения sandbox, такие как `['docker *']`. Они работают без sandbox автоматически без участия модели; [`sandbox.excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands) описывает, когда применяется запись |

5767| `allowUnsandboxedCommands` | `boolean` | `true` | Разрешите модели запрашивать выполнение команд вне sandbox. Когда `true`, модель может установить `dangerouslyDisableSandbox` в входных данных tool, что переходит к [системе разрешений](#permissions-fallback-for-unsandboxed-commands) |5748| `allowUnsandboxedCommands` | `boolean` | `true` | Разрешите модели запрашивать выполнение команд вне sandbox. Когда `true`, модель может установить `dangerouslyDisableSandbox` в входных данных tool, что переходит к [системе разрешений](#permissions-fallback-for-unsandboxed-commands) |

5768| `network` | [`SandboxNetworkConfig`](#sandboxnetworkconfig) | `undefined` | Конфигурация sandbox, специфичная для сети |5749| `network` | [`SandboxNetworkConfig`](#sandboxnetworkconfig) | `undefined` | Конфигурация sandbox, специфичная для сети |

5769| `filesystem` | [`SandboxFilesystemConfig`](#sandboxfilesystemconfig) | `undefined` | Конфигурация sandbox, специфичная для файловой системы, для ограничений чтения/записи |5750| `filesystem` | [`SandboxFilesystemConfig`](#sandboxfilesystemconfig) | `undefined` | Конфигурация sandbox, специфичная для файловой системы, для ограничений чтения/записи |

5870 Fallback разрешений для команд вне Sandbox5851 Fallback разрешений для команд вне Sandbox

5871</h3>5852</h3>

5872 5853 

5873Когда `allowUnsandboxedCommands` включён, модель может запросить выполнение команд вне sandbox, установив `dangerouslyDisableSandbox: true` во входных данных tool. Эти запросы переходят к существующей системе разрешений, что означает, что ваш обработчик `canUseTool` вызывается, позволяя вам реализовать пользовательскую логику авторизации. Команды, указанные в `excludedCommands`, вместо этого автоматически обходят sandbox, без участия модели; см. [`SandboxSettings`](#sandboxsettings).5854Когда `allowUnsandboxedCommands` включён, модель может запросить выполнение команд вне sandbox, установив `dangerouslyDisableSandbox: true` во входных данных tool. Эти запросы переходят к существующей системе разрешений, что означает, что ваш обработчик `canUseTool` вызывается, позволяя вам реализовать пользовательскую логику авторизации.

5855 

5856Ваши записи `excludedCommands` вместо этого автоматически обходят sandbox без участия модели; [`sandbox.excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands) описывает, когда применяется запись.

5874 5857 

5875В примере ниже `isCommandAuthorized` служит заместителем для проверки авторизации, которую вы определяете.5858В примере ниже `isCommandAuthorized` служит заместителем для проверки авторизации, которую вы определяете.

5876 5859 

agent-teams.md +0 −4

Details

14 14 

15Перед тем как настраивать команду, проверьте, подойдет ли вам более легкий вариант. [Subagents](/docs/ru/sub-agents) работают в одном сеансе, а с помощью [cross-session messaging](/docs/ru/cross-session-messaging) Claude может передавать результаты между сеансами, которые вы запускаете самостоятельно.15Перед тем как настраивать команду, проверьте, подойдет ли вам более легкий вариант. [Subagents](/docs/ru/sub-agents) работают в одном сеансе, а с помощью [cross-session messaging](/docs/ru/cross-session-messaging) Claude может передавать результаты между сеансами, которые вы запускаете самостоятельно.

16 16 

17<Note>

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>

20 

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

22 Когда использовать команды агентов18 Когда использовать команды агентов

23</h2>19</h2>

Details

291 291 

292Установите эти переменные окружения на конкретные ID моделей Amazon Bedrock.292Установите эти переменные окружения на конкретные ID моделей Amazon Bedrock.

293 293 

294Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Amazon Bedrock разрешается в Opus 5, а без `ANTHROPIC_DEFAULT_SONNET_MODEL` псевдоним `sonnet` разрешается в Sonnet 4.5. Этот пример закрепляет каждый псевдоним на конкретную версию:294Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Amazon Bedrock разрешается в Opus 5.5, а без `ANTHROPIC_DEFAULT_SONNET_MODEL` псевдоним `sonnet` разрешается в Sonnet 4.5. Этот пример закрепляет каждый псевдоним на конкретную версию:

295 295 

296```bash theme={null}296```bash theme={null}

297export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'297export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'

304Чтобы сохранить встроенные модели по умолчанию и изменить только их предпочтительный префикс, установите [`ANTHROPIC_BEDROCK_REGION_PREFIX`](#cross-region-inference-profile-prefixes) вместо закрепления. Разница видна в том, на что разрешается псевдоним `opus`:304Чтобы сохранить встроенные модели по умолчанию и изменить только их предпочтительный префикс, установите [`ANTHROPIC_BEDROCK_REGION_PREFIX`](#cross-region-inference-profile-prefixes) вместо закрепления. Разница видна в том, на что разрешается псевдоним `opus`:

305 305 

306| Вы установили | Псевдоним `opus` разрешается в |306| Вы установили | Псевдоним `opus` разрешается в |

307| :------------------------------------------------------------ | :------------------------------------------------------------------------------------------------ |307| :------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |

308| `ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` | `us.anthropic.claude-opus-4-8`, точный ID, который вы закрепили |308| `ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` | `us.anthropic.claude-opus-4-8`, точный ID, который вы закрепили |

309| `ANTHROPIC_BEDROCK_REGION_PREFIX=eu` | `eu.anthropic.claude-opus-5`, встроенное значение по умолчанию с вашим предпочтительным префиксом |309| `ANTHROPIC_BEDROCK_REGION_PREFIX=eu` | `eu.anthropic.claude-opus-5-5`, встроенное значение по умолчанию с вашим предпочтительным префиксом |

310 310 

311Для текущих и устаревших ID моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для полного списка переменных окружения закрепления см. [Конфигурация модели](/docs/ru/model-config#pin-models-for-third-party-deployments).311Для текущих и устаревших ID моделей см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для полного списка переменных окружения закрепления см. [Конфигурация модели](/docs/ru/model-config#pin-models-for-third-party-deployments).

312 312 

314 314 

315| Тип модели | Модель по умолчанию |315| Тип модели | Модель по умолчанию |

316| :---------------- | :----------------------------------------------------------------------------------- |316| :---------------- | :----------------------------------------------------------------------------------- |

317| Основная модель | Opus 5, например `us.anthropic.claude-opus-5` в регионе `us-*` |317| Основная модель | Opus 5.5, например `us.anthropic.claude-opus-5-5` в регионе `us-*` |

318| Модель small/fast | Sonnet 4.5, например `us.anthropic.claude-sonnet-4-5-20250929-v1:0` в регионе `us-*` |318| Модель small/fast | Sonnet 4.5, например `us.anthropic.claude-sonnet-4-5-20250929-v1:0` в регионе `us-*` |

319 319 

320Фоновые задачи, такие как генерация заголовка сеанса, используют модель small/fast, обычно модель класса Haiku. На Amazon Bedrock Claude Code использует модель Sonnet по умолчанию для фоновых задач, потому что Haiku может быть не включён в каждом аккаунте или регионе. Два выбора изменяют, какая модель их выполняет:320Фоновые задачи, такие как генерация заголовка сеанса, используют модель small/fast, обычно модель класса Haiku. На Amazon Bedrock Claude Code использует модель Sonnet по умолчанию для фоновых задач, потому что Haiku может быть не включён в каждом аккаунте или регионе. Два выбора изменяют, какая модель их выполняет:

326 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развёртывание, которое не закрепляет основную модель, будет выставлено по цене Opus после обновления до v2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развёртывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.326 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развёртывание, которое не закрепляет основную модель, будет выставлено по цене Opus после обновления до v2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развёртывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.

327</Warning>327</Warning>

328 328 

329На v2.1.207 через v2.1.218 основная модель на Amazon Bedrock по умолчанию была Opus 4.8, и псевдоним `opus` разрешался в Opus 4.8. До v2.1.207 основная модель по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался в Opus 4.6, и фоновые задачи всегда использовали основную модель.329До v2.1.280 основная модель на Amazon Bedrock по умолчанию была Opus 5, и псевдоним `opus` разрешался в Opus 5 с v2.1.219. На v2.1.207 через v2.1.218 основная модель на Amazon Bedrock по умолчанию была Opus 4.8, и псевдоним `opus` разрешался в Opus 4.8. До v2.1.207 основная модель по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался в Opus 4.6, и фоновые задачи всегда использовали основную модель.

330 330 

331Чтобы дополнительно настроить модели, используйте один из этих методов:331Чтобы дополнительно настроить модели, используйте один из этих методов:

332 332 

405```bash theme={null}405```bash theme={null}

406export ANTHROPIC_BEDROCK_REGION_PREFIX=global406export ANTHROPIC_BEDROCK_REGION_PREFIX=global

407# В регионе us-*, основная модель теперь разрешается на407# В регионе us-*, основная модель теперь разрешается на

408# global.anthropic.claude-opus-5 вместо us.anthropic.claude-opus-5408# global.anthropic.claude-opus-5-5 вместо us.anthropic.claude-opus-5-5

409```409```

410 410 

411Предпочитаемый префикс — это предпочтение, а не гарантия, независимо от того, исходит ли оно из вашего региона или из переменной. То, как Claude Code его применяет, зависит от того, может ли он проверить доступность профиля в вашей учётной записи:411Предпочитаемый префикс — это предпочтение, а не гарантия, независимо от того, исходит ли оно из вашего региона или из переменной. То, как Claude Code его применяет, зависит от того, может ли он проверить доступность профиля в вашей учётной записи:

artifacts.md +2 −2

Details

347Артефакты требуют каждого условия ниже. Когда одно из них не выполнено, Claude записывает локальный файл HTML или говорит, что не может опубликовать вместо этого.347Артефакты требуют каждого условия ниже. Когда одно из них не выполнено, Claude записывает локальный файл HTML или говорит, что не может опубликовать вместо этого.

348 348 

349| Requirement | Available when |349| Requirement | Available when |

350| :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |350| :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

351| Plan | Pro, Max, Team или Enterprise. На планах Pro и Max артефакты являются приватными для вас до тех пор, пока вы их не поделитесь, и управление администратором не применяется. На планах Team артефакты включены по умолчанию. На планах Enterprise владелец [включает их](#manage-artifacts-for-your-organization) в параметрах администратора claude.ai. |351| Plan | Pro, Max, Team или Enterprise. На планах Pro и Max артефакты являются приватными для вас до тех пор, пока вы их не поделитесь, и управление администратором не применяется. На планах Team артефакты включены по умолчанию. На планах Enterprise владелец [включает их](#manage-artifacts-for-your-organization) в параметрах администратора claude.ai. |

352| Authentication | Сеанс поддерживается учётной записью claude.ai: войдите с помощью `/login` в CLI или приложении для рабочего стола. Сеансы Claude Tag вошли через идентификацию агента, поэтому никаких шагов не требуется. Сеансы, использующие ключ API, [токен шлюза](/docs/ru/llm-gateway) или учётные данные поставщика облачных услуг, не могут публиковать. |352| Authentication | Сеанс поддерживается учётной записью claude.ai: войдите с помощью `/login` в CLI или приложении для рабочего стола. Сеансы Claude Tag вошли через идентификацию агента, поэтому никаких шагов не требуется. Сеансы, использующие ключ API, [токен шлюза](/docs/ru/llm-gateway) или учётные данные поставщика облачных услуг, не могут публиковать. |

353| 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). |353| 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). |

354| Organization policy | Ключи шифрования, управляемые клиентом (CMEK), HIPAA и [Zero Data Retention](/docs/ru/zero-data-retention) не включены для организации. |354| Organization policy | Ключи шифрования, управляемые клиентом (CMEK), HIPAA и [Zero Data Retention](/docs/ru/zero-data-retention) не включены для организации. |

355| 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). |355| Surface | Claude Code CLI или приложение 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). |

356 356 

357<h2 id="disable-artifacts">357<h2 id="disable-artifacts">

358 Отключение артефактов358 Отключение артефактов

Details

53 53 

54[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) и [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) обеспечивают лучший опыт для организаций, использующих Claude Code. Члены команды получают доступ как к Claude Code, так и к Claude в веб-версии с централизованным выставлением счетов и управлением командой.54[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) и [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) обеспечивают лучший опыт для организаций, использующих Claude Code. Члены команды получают доступ как к Claude Code, так и к Claude в веб-версии с централизованным выставлением счетов и управлением командой.

55 55 

56* **Claude for Teams**: план самообслуживания с функциями сотрудничества, инструментами администратора и управлением выставлением счетов. Лучше всего подходит для небольших команд.56* **Claude for Teams**: план самообслуживания с функциями сотрудничества, инструментами администратора, SSO, управлением выставлением счетов и [параметрами, управляемыми сервером](/docs/ru/server-managed-settings) для конфигурации Claude Code на уровне организации. Лучше всего подходит для небольших команд.

57* **Claude for Enterprise**: добавляет SSO, захват домена, разрешения на основе ролей, API соответствия и управляемые параметры политики для конфигураций Claude Code на уровне организации. Лучше всего подходит для крупных организаций с требованиями безопасности и соответствия.57* **Claude for Enterprise**: добавляет захват домена, разрешения на основе ролей и API соответствия. Лучше всего подходит для крупных организаций с требованиями безопасности и соответствия.

58 58 

59<Steps>59<Steps>

60 <Step title="Подпишитесь">60 <Step title="Подпишитесь">

Details

94| `id_token_signed_response_alg` | Нет | Ожидаемый алгоритм подписи id\_token. По умолчанию `RS256`. Установите для IdP, которые подписывают с помощью ES256, PS256 или EdDSA. |94| `id_token_signed_response_alg` | Нет | Ожидаемый алгоритм подписи id\_token. По умолчанию `RS256`. Установите для IdP, которые подписывают с помощью ES256, PS256 или EdDSA. |

95| `additional_authorized_parties` | Нет | Дополнительные значения `azp` для принятия помимо `client_id`, для потоков брокера Keycloak и обмена токенами |95| `additional_authorized_parties` | Нет | Дополнительные значения `azp` для принятия помимо `client_id`, для потоков брокера Keycloak и обмена токенами |

96| `discovery_url` | Нет | Получите документ обнаружения из этого URL вместо его получения из `issuer`, для IdP за прокси, который переписывает хост издателя. Путь должен содержать `/.well-known/`. |96| `discovery_url` | Нет | Получите документ обнаружения из этого URL вместо его получения из `issuer`, для IdP за прокси, который переписывает хост издателя. Путь должен содержать `/.well-known/`. |

97| `use_proxy` | Нет | Отправьте собственные запросы gateway к IdP через прямой прокси в `HTTPS_PROXY` или `HTTP_PROXY`, соблюдая `NO_PROXY`. Не установлено или `false`, эти запросы идут напрямую. Требует v2.1.227 или позже; см. [Запросы IdP через прямой прокси](#idp-requests-through-a-forward-proxy) ниже. |97| `use_proxy` | Нет | Отправьте собственные запросы gateway к IdP через прямой прокси в `HTTPS_PROXY` или `HTTP_PROXY`, соблюдая `NO_PROXY`. `false` держит эти запросы прямыми. Требует v2.1.227 или позже; см. [Запросы IdP через прямой прокси](#idp-requests-through-a-forward-proxy) ниже. |

98| `form_action_origins` | Нет | Дополнительные происхождения для директивы `Content-Security-Policy: form-action` страницы `/device`. Gateway уже разрешает `'self'` и обнаруженное происхождение `authorization_endpoint`, но Chrome применяет `form-action` ко всей цепочке перенаправления. Если ваш IdP перенаправляет через второй хост, такой как Azure AD, объединённый с ADFS, hub-spoke Okta или корпоративный перехватчик SSO, перечислите каждое происхождение, через которое может перенаправляться запрос авторизации. |98| `form_action_origins` | Нет | Дополнительные происхождения для директивы `Content-Security-Policy: form-action` страницы `/device`. Gateway уже разрешает `'self'` и обнаруженное происхождение `authorization_endpoint`, но Chrome применяет `form-action` ко всей цепочке перенаправления. Если ваш IdP перенаправляет через второй хост, такой как Azure AD, объединённый с ADFS, hub-spoke Okta или корпоративный перехватчик SSO, перечислите каждое происхождение, через которое может перенаправляться запрос авторизации. |

99| `ca_cert_pem` | Нет | PEM-кодированный сертификат CA, а не путь к файлу. Он заменяет хранилище доверия системы только для запросов IdP. Для загрузки смонтированного файла напишите `${file:/etc/gateway/idp-ca.pem}`. Используйте для Keycloak или Dex за корпоративной PKI. |99| `ca_cert_pem` | Нет | PEM-кодированный сертификат CA, а не путь к файлу. Он заменяет хранилище доверия системы только для запросов IdP. Для загрузки смонтированного файла напишите `${file:/etc/gateway/idp-ca.pem}`. Используйте для Keycloak или Dex за корпоративной PKI. |

100 100 

106 106 

107С `use_proxy: true`, pod разрешает имя хоста каждой конечной точки IdP сам и просит прокси `CONNECT` к разрешённому IP адресу, поэтому прокси должен принять `CONNECT` к IP адресу каждого хоста, который называет документ обнаружения, не только издателя. Используйте URL прокси `http://`. `ca_cert_pem` и [защита SSRF](/docs/ru/claude-apps-gateway-deploy#threat-model-summary) применяются на проксированном пути также.107С `use_proxy: true`, pod разрешает имя хоста каждой конечной точки IdP сам и просит прокси `CONNECT` к разрешённому IP адресу, поэтому прокси должен принять `CONNECT` к IP адресу каждого хоста, который называет документ обнаружения, не только издателя. Используйте URL прокси `http://`. `ca_cert_pem` и [защита SSRF](/docs/ru/claude-apps-gateway-deploy#threat-model-summary) применяются на проксированном пути также.

108 108 

109[Прокси-только egress](#proxy-only-egress) изменяет оба из них: пока он активен, запросы IdP следуют прокси, если вы не установите `use_proxy: false`, и gateway передаёт прокси каждое имя хоста IdP без разрешения его в первую очередь.

110 

111<h4 id="proxy-only-egress">

112 Прокси-только egress

113</h4>

114 

115Установите `CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1` в окружении gateway, рядом с `HTTPS_PROXY`, когда pod достигает других хостов только через этот прямой прокси и не может разрешить имена общедоступных DNS сам, или когда прокси отказывает `CONNECT` к IP адресу. Требует v2.1.277 или позже. Это переменная окружения, а не ключ `gateway.yaml`, поэтому ничто в файле конфигурации не может ослабить проверку адреса gateway.

116 

117```bash theme={null}

118export HTTPS_PROXY=http://proxy.corp.example.com:3128

119export NO_PROXY=

120export no_proxy=

121export CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1

122```

123 

124Gateway логирует одну строку `network:` при загрузке пока прокси-только egress активен.

125 

126Каждая строка ниже — это один класс исходящего запроса на gateway с установленным `HTTPS_PROXY`, по умолчанию и пока прокси-только egress активен.

127 

128| Исходящий запрос | По умолчанию | Прокси-только egress активен |

129| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |

130| `provider: anthropic` upstream, обмен токенов Workload Identity Federation, экспорты `telemetry.forward_to` | Разрешены и проверены локально, затем `CONNECT` к проверенному IP адресу через прокси. Сборщик телеметрии, указанный в `NO_PROXY`, достигается напрямую вместо этого | Имя хоста передано прокси |

131| Обнаружение IdP, JWKS, токен и userinfo | Прямо, если не [`oidc.use_proxy: true`](#idp-requests-through-a-forward-proxy), затем `CONNECT` к проверенному IP адресу | Имя хоста передано прокси, если не `oidc.use_proxy: false` держит внутренний IdP прямым |

132| Amazon Bedrock, Claude Platform on AWS, Agent Platform Google Cloud и Microsoft Foundry upstream; поиск групп Google | Имя хоста передано прокси | Без изменений |

133 

134Прокси-только egress остаётся выключенным, если окружение gateway не соответствует всем трём из этих условий:

135 

136* `HTTPS_PROXY` или `HTTP_PROXY` установлены.

137* `NO_PROXY` и `no_proxy` пусты. Если ваша платформа вводит любой из них в pods, установите оба на пустое значение на контейнере gateway. Указание сборщика телеметрии в `NO_PROXY` держит прокси-только egress выключенным.

138* `CLAUDE_GATEWAY_ALLOW_LOOPBACK` не включен. Сборщик или IdP на собственном loopback пода не может быть объединён с прокси-только egress, потому что адрес loopback, переданный прокси, будет собственным хостом прокси, поэтому дайте этим сервисам адрес, который прокси может достичь вместо этого. По той же причине gateway отказывает имена в стиле `localhost` полностью пока прокси-только egress активен.

139 

140Когда одно из этих условий не выполнено, gateway логирует предупреждение при загрузке, называя переменную, которая его остановила, и держит поведение по умолчанию.

141 

142Как только прокси-только egress активен, разрешите каждое назначение в прокси, включая внутренний сборщик и любой хост, настроенный по IP адресу. Вы всё ещё можете держать внутренний IdP прямым с [`oidc.use_proxy: false`](#idp-requests-through-a-forward-proxy).

143 

144<Warning>

145 Включайте это только когда список разрешений прокси по крайней мере такой же строгий, как собственная проверка gateway. Прокси должен отказать конечным точкам метаданных облака, таким как `169.254.169.254` и `metadata.google.internal`, адресам link-local и собственному loopback хоста прокси, и он должен отказать им по адресу, на который разрешается имя, а не только по имени, потому что gateway больше не ловит имя хоста, которое разрешается на один из них. Прокси, который подключается куда угодно, где его просят, удаляет [защиту SSRF](/docs/ru/claude-apps-gateway-deploy#threat-model-summary) gateway для этих запросов.

146</Warning>

147 

109<h3 id="session">148<h3 id="session">

110 `session`149 `session`

111</h3>150</h3>

124Блок `store` указывает gateway на его базу данных PostgreSQL, которая содержит гранты устройств и счётчики ограничения скорости.163Блок `store` указывает gateway на его базу данных PostgreSQL, которая содержит гранты устройств и счётчики ограничения скорости.

125 164 

126| Поле | Обязательно | Описание |165| Поле | Обязательно | Описание |

127| ----------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |166| ------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

128| `postgres_url` | Да | URL `postgres://` или `postgresql://`. Требуется: встреча грантов устройств, где обратный вызов браузера пишет и опрашивающий CLI читает, нуждается в состоянии между репликами. Gateway запускает свои собственные миграции схемы при загрузке и при обновлении, поэтому роль нуждается в правах для создания и изменения таблиц на целевой схеме. См. [Обновления](/docs/ru/claude-apps-gateway-deploy#upgrades) и [Postgres](/docs/ru/claude-apps-gateway-deploy#postgres). |167| `postgres_url` | Да | URL `postgres://` или `postgresql://`. Требуется: встреча грантов устройств, где обратный вызов браузера пишет и опрашивающий CLI читает, нуждается в состоянии между репликами. Gateway запускает свои собственные миграции схемы при загрузке и при обновлении, поэтому роль нуждается в правах для создания и изменения таблиц на целевой схеме. См. [Обновления](/docs/ru/claude-apps-gateway-deploy#upgrades) и [Postgres](/docs/ru/claude-apps-gateway-deploy#postgres). |

129| `username` | Нет | Переопределяет пользователя в `postgres_url` |168| `username` | Нет | Переопределяет пользователя в `postgres_url` |

130| `password` | Нет | Учётные данные базы данных. Установите здесь, а не в `postgres_url`, чтобы учётные данные оставались вне URL. Принимает любые символы и имеет приоритет над учётными данными URL. |169| `password` | Нет | Учётные данные базы данных. Установите здесь, а не в `postgres_url`, чтобы учётные данные оставались вне URL. Принимает любые символы и имеет приоритет над учётными данными URL. |

131| `max_connections` | Нет | Размер пула соединений Postgres на реплику. По умолчанию `5`, что консервативно и дружелюбно к общим базам данных. С включёнными [лимитами расходов](#admin) горячий путь выполняет несколько операций на запрос вывода, поэтому повысьте его для выделенной базы данных под нагрузкой и держите реплики × это ниже `max_connections` базы данных. |170| `max_connections` | Нет | Размер пула соединений Postgres на реплику. По умолчанию `5`, что консервативно и дружелюбно к общим базам данных. С включёнными [лимитами расходов](#admin) горячий путь выполняет несколько операций на запрос вывода, поэтому повысьте его для выделенной базы данных под нагрузкой и держите реплики × это ниже `max_connections` базы данных. |

171| `connect_timeout_seconds` | Нет | Секунды, которые gateway ждёт, когда открывает соединение Postgres. Целое число от `1` до `60`, по умолчанию `5`. Повысьте, если попытки соединения истекают по времени, когда новый экземпляр gateway запускается. Требует Claude Code v2.1.274 или позже на сервере gateway. Более ранние версии отказываются запускаться, когда ключ установлен. |

132 172 

133Для локальной разработки укажите `postgres_url` на одноразовый контейнер Postgres, например `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`.173Для локальной разработки укажите `postgres_url` на одноразовый контейнер Postgres, например `docker run --rm -p 5432:5432 -e POSTGRES_HOST_AUTH_METHOD=trust postgres`.

134 174 

365| ACI / App Service | Включите управляемую идентификацию, назначенную системой или пользователем, на ресурсе. `use_azure_ad: true` подхватывает это. |405| ACI / App Service | Включите управляемую идентификацию, назначенную системой или пользователем, на ресурсе. `use_azure_ad: true` подхватывает это. |

366| Где-либо ещё | `auth: { api_key: "${FOUNDRY_API_KEY}" }`. Заключите `${…}` в кавычки внутри `{ }`. |406| Где-либо ещё | `auth: { api_key: "${FOUNDRY_API_KEY}" }`. Заключите `${…}` в кавычки внутри `{ }`. |

367 407 

408<h4 id="static-headers-on-upstream-requests">

409 Статические заголовки на запросах upstream

410</h4>

411 

412Чтобы добавить фиксированные заголовки к запросам, которые gateway отправляет одному upstream, установите `headers:` на этом upstream. Используйте это, когда прокси, который вы запускаете перед поставщиком, маршрутизирует или атрибутирует трафик по заголовку.

413 

414`headers:` требует Claude Code v2.1.277 или позже на сервере gateway. Более ранний gateway отказывается запускаться, когда находит ключ. Обновите каждую реплику перед добавлением ключа и удалите ключ перед откатом на более раннюю версию.

415 

416Заголовки идут на сервер, который называет `base_url`, или на собственную конечную точку поставщика, когда `base_url` не установлен. Поставщик получает их тоже, если ваш прокси их не удаляет.

417 

418Этот пример достигает upstream `provider: vertex` через прокси в `upstream-proxy.internal.example.com`. Он устанавливает заголовок `x-source`, который прокси читает, и отправляет токен из переменной окружения `PROXY_TOKEN` как `x-proxy-token`:

419 

420```yaml theme={null}

421upstreams:

422 - provider: vertex

423 region: us-east5

424 project_id: example-prod

425 base_url: https://upstream-proxy.internal.example.com

426 auth: {}

427 headers:

428 x-source: claude-apps-gateway

429 x-proxy-token: ${PROXY_TOKEN}

430```

431 

432Значения — это печатаемый ASCII текст без пробела на обоих концах. Заключите число, `true` или `false` в кавычки, чтобы YAML читал это как текст.

433 

434Чтобы держать секрет вне файла конфигурации, используйте [расширение секрета](#secret-expansion) для загрузки значения из переменной окружения с `${VAR}` или из файла с `${file:/path}`. `${VAR}`, который разрешается на пустое значение, останавливает запуск gateway.

435 

436`headers:` работает на каждом поставщике, и каждый upstream отправляет только свой.

437 

438Не каждый запрос, который gateway отправляет upstream, несёт их:

439 

440| Запрос, который gateway отправляет этому upstream | Несёт `headers:` |

441| ---------------------------------------------------------------------- | ------------------------------------ |

442| `/v1/messages`, потоковый или нет, и `/v1/messages/count_tokens` | Да |

443| Запрос, который не удался перейти с другого upstream | Да, только `headers:` этого upstream |

444| Вызов `CountTokens` Amazon Bedrock для запроса, который клиент отказал | Нет |

445| Обмен токенов Workload Identity Federation | Нет |

446 

447На upstream Amazon Bedrock или Claude Platform on AWS, который подписывает запросы с AWS SigV4, эти заголовки являются частью подписи, поэтому ваш прокси должен передать их без изменений.

448 

449Если вы используете имя, которое gateway зарезервировал, он отказывается запускаться, и ошибка запуска называет заголовок. Зарезервированные имена включают:

450 

451* `authorization` и `x-api-key`

452* `host`, `content-type` и `user-agent`

453* Любое имя, начинающееся с `anthropic-`, `x-goog-`, `x-amz-` или `x-amzn-`

454 

368<h4 id="multiple-upstreams">455<h4 id="multiple-upstreams">

369 Несколько upstream456 Несколько upstream

370</h4>457</h4>

375 462 

376`429` — это пропускная способность для каждого upstream, поэтому истощение выделенной пропускной способности (PT) переходит на по требованию. Если вы установите [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) на upstream, `429` к запросу, который нёс электронную почту разработчика, — это отказ на пользователя вместо этого и не переходит.463`429` — это пропускная способность для каждого upstream, поэтому истощение выделенной пропускной способности (PT) переходит на по требованию. Если вы установите [`forward_user_identity: true`](#per-user-identity-headers-for-a-proxy-you-run) на upstream, `429` к запросу, который нёс электронную почту разработчика, — это отказ на пользователя вместо этого и не переходит.

377 464 

465Каждый запрос начинается с первого upstream. Запрос достигает более позднего upstream только когда каждый upstream перед ним не удался или не служит запрошенной модели.

466 

467Gateway не ведёт запись о неудачных upstream, поэтому пока upstream не работает, каждый запрос, который достигает его, всё ещё пробует его и ждёт его отказа перед переходом.

468 

469Для upstream Anthropic API, [`timeouts.upstream_ttfb_ms`](#http-tuning) ограничивает ожидание на неработающем upstream. Этот параметр не применяется к другим поставщикам, где gateway ждёт до одного часа, пока upstream начнёт отвечать.

470 

378`404` — это доступность модели для каждого upstream, поэтому upstream, который не включил модель, не блокирует более поздний upstream, который её служит. Upstream, который не может разрешить запрошенную модель, пропускается без сетевого раундтрипа.471`404` — это доступность модели для каждого upstream, поэтому upstream, который не включил модель, не блокирует более поздний upstream, который её служит. Upstream, который не может разрешить запрошенную модель, пропускается без сетевого раундтрипа.

379 472 

380Этот пример маршрутизирует выделенное выделение пропускной способности Bedrock в первую очередь, переполнение на по требованию и вторую учётную запись, и переходит на Anthropic API в последнюю очередь:473Этот пример маршрутизирует выделенное выделение пропускной способности Bedrock в первую очередь, переполнение на по требованию и вторую учётную запись, и переходит на Anthropic API в последнюю очередь:

797 890 

798[Claude Desktop](#claude-desktop-overlay) и сеансы Cowork, подписанные через gateway, штампуют свою телеметрию с `user.email` и `user.groups` наряду с `enduser.id`, поэтому вы можете охватить использование терминала, Desktop и Cowork одним запросом на `user.email` или `user.groups`. `user.groups` — это список групп IdP, разделённый запятыми.891[Claude Desktop](#claude-desktop-overlay) и сеансы Cowork, подписанные через gateway, штампуют свою телеметрию с `user.email` и `user.groups` наряду с `enduser.id`, поэтому вы можете охватить использование терминала, Desktop и Cowork одним запросом на `user.email` или `user.groups`. `user.groups` — это список групп IdP, разделённый запятыми.

799 892 

893Desktop и Cowork телеметрия также несёт `enduser.sub`, утверждение `sub`, которое выдаёт ваш поставщик идентификации для пользователя, которое остаётся тем же, когда электронная почта пользователя изменяется. Сеансы терминала штампуют то же значение под `user.id`, поэтому запрос, который соответствует `enduser.sub` против терминала `user.id`, охватывает использование одного пользователя терминала, Desktop и Cowork вместе. На экспортах Desktop и Cowork `user.id` — это анонимный идентификатор, а не субъект.

894 

800Как и все данные OpenTelemetry из Claude Code, эти атрибуты идут только на назначения, которые настраивает ваша организация, никогда на Anthropic.895Как и все данные OpenTelemetry из Claude Code, эти атрибуты идут только на назначения, которые настраивает ваша организация, никогда на Anthropic.

801 896 

802Если список групп пользователя длиннее 255 символов после процентного кодирования, или имя группы содержит запятую или знак равенства, gateway оставляет `user.groups` из телеметрии Desktop и Cowork этого пользователя, а не усекает его. Сеансы терминала этого пользователя всё ещё несут полный список.897Если список групп пользователя длиннее 255 символов после процентного кодирования, или имя группы содержит запятую или знак равенства, gateway оставляет `user.groups` из телеметрии Desktop и Cowork этого пользователя, а не усекает его. Сеансы терминала этого пользователя всё ещё несут полный список.

803 898 

899Gateway оставляет `enduser.sub` отключённым, когда субъект длиннее 255 символов после процентного кодирования, или содержит пробел, символ вне печатного ASCII, или один из `,` `;` `=` `\` `"` `%`. Телеметрия Desktop и Cowork этого пользователя сохраняет свои другие атрибуты.

900 

804Вам нужен Claude Code v2.1.265 или позже на сервере gateway для `user.email` и `user.groups` на телеметрии Desktop и Cowork, и Claude Desktop 1.24012 или позже на машине каждого разработчика для `user.groups`.901Вам нужен Claude Code v2.1.265 или позже на сервере gateway для `user.email` и `user.groups` на телеметрии Desktop и Cowork, и Claude Desktop 1.24012 или позже на машине каждого разработчика для `user.groups`.

805 902 

903Вам нужен Claude Code v2.1.274 или позже на сервере gateway для `enduser.sub`.

904 

806```yaml theme={null}905```yaml theme={null}

807telemetry:906telemetry:

808 forward_to:907 forward_to:

834 933 

835Для сборщика в кластере выставьте его по HTTPS на его собственный внутренний адрес или запустите его как sidecar с установленной переменной.934Для сборщика в кластере выставьте его по HTTPS на его собственный внутренний адрес или запустите его как sidecar с установленной переменной.

836 935 

936Когда `HTTPS_PROXY` установлен, gateway отправляет экспорты через этот прокси.

937 

938Чтобы достичь внутреннего сборщика напрямую, добавьте его в `NO_PROXY` по имени хоста или по домену с ведущей точкой, такой как `.internal.example.com`, что требует Claude Code v2.1.277 или позже на сервере gateway. Убедитесь, что gateway может достичь сборщика без прокси. Запись без ведущей точки соответствует только этому точному имени, а не именам под ним. Диапазоны CIDR не соответствуют.

939 

940С включённым [прокси-только исходящим трафиком](#proxy-only-egress), разрешите сборщик в прокси вместо этого, так как любая запись `NO_PROXY` отключает прокси-только исходящий трафик.

941 

837Телеметрия отключена в CLI по умолчанию. Когда вы устанавливаете оба `telemetry.forward_to` и `listen.public_url`, gateway включает её для подключённых клиентов, отправляя шесть переменных окружения через `/managed/settings`:942Телеметрия отключена в CLI по умолчанию. Когда вы устанавливаете оба `telemetry.forward_to` и `listen.public_url`, gateway включает её для подключённых клиентов, отправляя шесть переменных окружения через `/managed/settings`:

838 943 

839* `CLAUDE_CODE_ENABLE_TELEMETRY=1`944* `CLAUDE_CODE_ENABLE_TELEMETRY=1`

908| `limits` | `max_request_header_bytes` | не установлено | Когда установлено, заголовки большего размера возвращают `431` |1013| `limits` | `max_request_header_bytes` | не установлено | Когда установлено, заголовки большего размера возвращают `431` |

909| `limits` | `max_url_length` | не установлено | Когда установлено, слишком длинный URL возвращает `414` |1014| `limits` | `max_url_length` | не установлено | Когда установлено, слишком длинный URL возвращает `414` |

910| `timeouts` | `upstream_ttfb_ms` | 120000 | Максимальное ожидание заголовков ответа upstream (время до первого байта). Тело ответа затем потоком без ограничения по стене часов. Применяется к прямому пути upstream Anthropic; каждый другой поставщик ограничен собственным timeout SDK поставщика. |1015| `timeouts` | `upstream_ttfb_ms` | 120000 | Максимальное ожидание заголовков ответа upstream (время до первого байта). Тело ответа затем потоком без ограничения по стене часов. Применяется к прямому пути upstream Anthropic; каждый другой поставщик ограничен собственным timeout SDK поставщика. |

911| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Ограничение скорости по IP на неаутентифицированной конечной точке авторизации устройства. Повысьте для большой организации за общим исходящим IP или NAT. Эти ограничения применяются только к потоку входа грантов устройств, а не к выводу `/v1/messages`. См. [Сопротивление перебору пользовательского кода](/docs/ru/claude-apps-gateway-deploy#user-code-brute-force-resistance). |1016| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | Ограничение скорости по IP на неаутентифицированной конечной точке авторизации устройства. Повысьте для большой организации за общим исходящим IP или NAT. [Большие развёртывания](/docs/ru/claude-apps-gateway-deploy#large-rollouts) показывает, как его размер. Эти ограничения применяются только к потоку входа грантов устройств, а не к выводу `/v1/messages`. См. [Сопротивление перебору пользовательского кода](/docs/ru/claude-apps-gateway-deploy#user-code-brute-force-resistance). |

912| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Ограничение скорости по IP на отправки `user_code` в `/device` |1017| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | Ограничение скорости по IP на отправки `user_code` в `/device`. Это то, что останавливает кого-то от угадывания кода другого разработчика. [Большие развёртывания](/docs/ru/claude-apps-gateway-deploy#large-rollouts) показывает, как далеко его повысить. |

913 1018 

914Если вы оставите оба списка `access_control` пустыми, что является значением по умолчанию, gateway обслуживает любой адрес клиента, поэтому только ваша сеть ограничивает, кто может его достичь. Это важно, потому что gateway может отправлять [управляемые параметры](#managed), которые запускают команды на машинах разработчиков.1019Если вы оставите оба списка `access_control` пустыми, что является значением по умолчанию, gateway обслуживает любой адрес клиента, поэтому только ваша сеть ограничивает, кто может его достичь. Это важно, потому что gateway может отправлять [управляемые параметры](#managed), которые запускают команды на машинах разработчиков.

915 1020 

973store:1078store:

974 postgres_url: ${GATEWAY_POSTGRES_URL}1079 postgres_url: ${GATEWAY_POSTGRES_URL}

975 # max_connections: 51080 # max_connections: 5

1081 # connect_timeout_seconds: 5

976 1082 

977# Включает /v1/organizations/spend_limits (отражает публичный Admin API Anthropic)1083# Включает /v1/organizations/spend_limits (отражает публичный Admin API Anthropic)

978# и применение расходов для каждого разработчика на /v1/messages. Опустите для отключения.1084# и применение расходов для каждого разработчика на /v1/messages. Опустите для отключения.

Details

250 250 

251Облачные сеансы поддерживают [встроенные команды](/docs/ru/commands), которые выводят текстовый результат. Команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, недоступны. Команды, которые открывают средство выбора или панель в терминале, ведут себя иначе в облачных сеансах:251Облачные сеансы поддерживают [встроенные команды](/docs/ru/commands), которые выводят текстовый результат. Команды, которые работают только в интерфейсе терминала, такие как `/plugin` или `/resume`, недоступны. Команды, которые открывают средство выбора или панель в терминале, ведут себя иначе в облачных сеансах:

252 252 

253* **`/model`, `/effort`, `/color` и `/rename`**: передайте значение как аргумент, например `/model sonnet`, вместо открытия средства выбора терминала или ползунка. Формы аргументов требуют Claude Code v2.1.205 или более поздней версии в окружении сеанса и следуют [примечаниям доступности](/docs/ru/commands#all-commands) каждой команды: `/effort` сообщает `Not applied` пока [запуск-стандартное удержание уровня усилий](/docs/ru/model-config#adjust-effort-level) действует.253* **`/model`, `/effort`, `/color` и `/rename`**: передайте значение как аргумент, например `/model sonnet`, вместо открытия средства выбора терминала или ползунка. Формы аргументов требуют Claude Code v2.1.205 или более поздней версии в окружении сеанса и следуют [примечаниям доступности](/docs/ru/commands#all-commands) каждой команды.

254* **`/fast`**: переключает [быстрый режим](/docs/ru/fast-mode#use-fast-mode-in-cloud-sessions) для сеанса, когда быстрый режим [доступен в вашей учётной записи](/docs/ru/fast-mode#requirements). Требует Claude Code v2.1.271 или более поздней версии в окружении сеанса.254* **`/fast`**: переключает [быстрый режим](/docs/ru/fast-mode#use-fast-mode-in-cloud-sessions) для сеанса, когда быстрый режим [доступен в вашей учётной записи](/docs/ru/fast-mode#requirements). Требует Claude Code v2.1.271 или более поздней версии в окружении сеанса.

255* **`/config`**: в веб-версии открывает раздел Claude Code ваших параметров вместо установки значения, и текст после команды, включая `key=value`, игнорируется. Чтобы изменить параметр облачного сеанса, установите [переменную окружения](/docs/ru/cloud-environments#set-environment-variables) в окружении или в сеансе с одним репозиторием зафиксируйте ключ в файле `.claude/settings.json` этого репозитория. [Параметры в облачных сеансах](/docs/ru/settings#settings-in-cloud-sessions) перечисляет, что читает каждый сеанс.255* **`/config`**: в веб-версии открывает раздел Claude Code ваших параметров вместо установки значения, и текст после команды, включая `key=value`, игнорируется. Чтобы изменить параметр облачного сеанса, установите [переменную окружения](/docs/ru/cloud-environments#set-environment-variables) в окружении или в сеансе с одним репозиторием зафиксируйте ключ в файле `.claude/settings.json` этого репозитория. [Параметры в облачных сеансах](/docs/ru/settings#settings-in-cloud-sessions) перечисляет, что читает каждый сеанс.

256 256 

Details

1450 1450 

1451Обозреватель охватывает файлы, которые вы создаёте и редактируете. Несколько связанных файлов находятся в других местах:1451Обозреватель охватывает файлы, которые вы создаёте и редактируете. Несколько связанных файлов находятся в других местах:

1452 1452 

1453| Файл | Местоположение | Назначение |1453| Файл | Расположение | Назначение |

1454| ----------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1454| ----------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1455| `managed-settings.json` | Системный уровень, варьируется в зависимости от ОС | Параметры, установленные предприятием, которые вы не можете переопределить, за исключением [узких исключений](/docs/ru/settings#security-keys-where-the-stricter-value-applies). См. [где сохранить файл](/docs/ru/managed-settings#deploy-a-managed-settings-file) и [какой управляемый источник использует Claude Code](/docs/ru/managed-settings#precedence-within-the-managed-tier). |1455| `managed-settings.json` | Уровень системы, варьируется в зависимости от ОС | Параметры, установленные предприятием, которые вы не можете переопределить, за исключением [узких исключений](/docs/ru/settings#security-keys-where-the-stricter-value-applies). См. [где сохранить файл](/docs/ru/managed-settings#deploy-a-managed-settings-file) и [какой управляемый источник использует Claude Code](/docs/ru/managed-settings#precedence-within-the-managed-tier). |

1456| `CLAUDE.local.md` | Корень проекта | Ваши личные предпочтения для этого проекта, загруженные вместе с CLAUDE.md. Создайте его вручную и добавьте в `.gitignore`. |1456| `CLAUDE.local.md` | Корень проекта | Ваши личные предпочтения для этого проекта, загружаемые вместе с CLAUDE.md. Создайте его вручную и добавьте в `.gitignore`. |

1457| `AGENTS.md` | Корень проекта, `.claude/` или любой каталог | Инструкции проекта, которые вы пишете для AI-агентов кодирования. Claude Code может [загружать его](/docs/ru/memory#agents-md) самостоятельно или вместе с `CLAUDE.md`. |1457| `AGENTS.md` | Корень проекта, `.claude/` или любой каталог | Инструкции проекта, которые вы пишете для агентов AI кодирования. Claude Code может [загрузить его](/docs/ru/memory#agents-md) самостоятельно или вместе с `CLAUDE.md`. |

1458| Установленные plugins | `~/.claude/plugins` | Клонированные маркетплейсы, установленные версии plugins и данные для каждого plugin, управляемые командами `claude plugin`. Для plugin, установленного из маркетплейса с источником [`command`](/docs/ru/plugin-marketplaces#command-sources) в режиме ссылки, Claude Code сохраняет здесь ссылки вместо копии, и файлы plugin остаются в каталоге, который выводит команда. Источник `command` требует Claude Code версии 2.1.229 или более поздней. Plugin, указанный относительным путём в локальном маркетплейсе каталога, также [загружается на месте](/docs/ru/plugins-reference#plugin-caching-and-file-resolution) из своего исходного каталога, а не из копии кэша. См. [кэширование plugins](/docs/ru/plugins-reference#plugin-caching-and-file-resolution) для информации о том, как удаляются потерянные версии. |1458| Установленные plugins | `~/.claude/plugins` | Клонированные маркетплейсы, установленные версии plugins, запись установки `installed_plugins.json`, и данные для каждого plugin, управляемые командами `claude plugin`. Plugins [синхронизированные с вашей учётной записью claude.ai](/docs/ru/plugins-reference#synced-plugins) загружаются в `~/.claude/plugins/synced/`. Для plugin, установленного из маркетплейса с источником [`command`](/docs/ru/plugin-marketplaces#command-sources) в режиме ссылки, Claude Code хранит здесь ссылки вместо копии, и файлы plugin остаются в каталоге, который выводит команда. Источник `command` требует Claude Code v2.1.229 или позже. Plugin, указанный относительным путём в локальном маркетплейсе каталога, также [загружается на месте](/docs/ru/plugins-reference#plugin-caching-and-file-resolution) из своего исходного каталога, а не из копии кэша. См. [кэширование plugins](/docs/ru/plugins-reference#plugin-caching-and-file-resolution) для того, как очищаются заброшенные версии. |

1459 1459 

1460`~/.claude` также содержит данные, которые Claude Code записывает во время работы: стенограммы, историю подсказок, снимки файлов, кэши и журналы. См. [данные приложения](#application-data) ниже.1460`~/.claude` также содержит данные, которые Claude Code записывает во время работы: стенограммы, историю подсказок, снимки файлов, кэши и журналы. См. [данные приложения](#application-data) ниже.

1461 1461 

1515| [`keybindings.json`](#ce-keybindings) | Только глобально | | Пользовательские сочетания клавиш | [Keybindings](/docs/ru/keybindings) |1515| [`keybindings.json`](#ce-keybindings) | Только глобально | | Пользовательские сочетания клавиш | [Keybindings](/docs/ru/keybindings) |

1516| [`themes/*.json`](#ce-themes) | Только глобально | | Пользовательские цветовые темы | [Пользовательские темы](/docs/ru/terminal-config#create-a-custom-theme) |1516| [`themes/*.json`](#ce-themes) | Только глобально | | Пользовательские цветовые темы | [Пользовательские темы](/docs/ru/terminal-config#create-a-custom-theme) |

1517 1517 

1518<h2 id="frontmatter-fields-by-file">

1519 Frontmatter fields by file

1520</h2>

1521 

1522Skills, command files, subagents, output styles, and rules read their configuration from YAML [frontmatter](/docs/ru/glossary#frontmatter) at the top of the file, and each accepts its own set of fields. This table lists the field names for each file and links to the reference that describes them.

1523 

1524| File | Frontmatter fields | Reference |

1525| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |

1526| `skills/<name>/SKILL.md` | `name`, `description`, `when_to_use`, `argument-hint`, `arguments`, `disable-model-invocation`, `user-invocable`, `allowed-tools`, `disallowed-tools`, `model`, `effort`, `context`, `agent`, `background`, `hooks`, `paths`, `shell`, `metadata`, `license`, `compatibility` | [Skill frontmatter](/docs/ru/skills#frontmatter-reference) |

1527| `commands/*.md` | The skill fields except `name` and `paths` | [Skill frontmatter](/docs/ru/skills#frontmatter-reference) |

1528| `agents/*.md` | `name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental` | [Subagent frontmatter](/docs/ru/sub-agents#supported-frontmatter-fields) |

1529| `output-styles/*.md` | `name`, `description`, `keep-coding-instructions`, `force-for-plugin` | [Output style frontmatter](/docs/ru/output-styles#frontmatter) |

1530| `rules/*.md` | `paths` | [Rule frontmatter](/docs/ru/memory#rules-frontmatter-reference) |

1531 

1532Agents shipped in a [plugin](/docs/ru/plugins-reference#plugin-agent-frontmatter) honor a subset of the subagent fields.

1533 

1518<h2 id="troubleshoot-configuration">1534<h2 id="troubleshoot-configuration">

1519 Устранение неполадок конфигурации1535 Устранение неполадок конфигурации

1520</h2>1536</h2>

1534Claude Code удаляет файлы в путях ниже, как только им исполняется больше [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), при условии, что он может безопасно определить период хранения. По умолчанию это 30 дней, минимум — 1; установка `0` приводит к ошибке валидации. Тот же возрастной порог применяется к автоматическому удалению [orphaned worktrees](/docs/ru/worktrees#clean-up-subagent-and-background-session-worktrees).1550Claude Code удаляет файлы в путях ниже, как только им исполняется больше [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), при условии, что он может безопасно определить период хранения. По умолчанию это 30 дней, минимум — 1; установка `0` приводит к ошибке валидации. Тот же возрастной порог применяется к автоматическому удалению [orphaned worktrees](/docs/ru/worktrees#clean-up-subagent-and-background-session-worktrees).

1535 1551 

1536| Путь под `~/.claude/` | Содержимое |1552| Путь под `~/.claude/` | Содержимое |

1537| ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1553| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1538| `projects/<project>/<session>.jsonl` | Полная стенограмма разговора: каждое сообщение, вызов инструмента и результат инструмента |1554| `projects/<project>/<session>.jsonl` | Полная стенограмма разговора: каждое сообщение, вызов инструмента и результат инструмента |

1539| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Предыдущая стенограмма для сеанса, которую Claude Code отложил вместо перезаписи или удаления. Она не появляется в средстве выбора сеансов |1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>` | Предыдущая стенограмма для сеанса, которую Claude Code отложил вместо перезаписи или удаления. Она не появляется в средстве выбора сеансов |

1540| `projects/<project>/<session>/subagents/` | Стенограммы разговоров [Subagent](/docs/ru/sub-agents), удаляемые вместе со стенограммой родительского сеанса, когда она устаревает |1556| `projects/<project>/<session>/subagents/` | Стенограммы разговоров [Subagent](/docs/ru/sub-agents), удаляемые вместе со стенограммой родительского сеанса, когда она устаревает |

1543| `plans/` | Файлы плана, написанные во время [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) |1559| `plans/` | Файлы плана, написанные во время [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) |

1544| `debug/` | Журналы отладки для каждого сеанса, написанные при включённом логировании отладки, например при запуске с [`--debug`](/docs/ru/cli-reference#cli-flags) или запуске `/debug` |1560| `debug/` | Журналы отладки для каждого сеанса, написанные при включённом логировании отладки, например при запуске с [`--debug`](/docs/ru/cli-reference#cli-flags) или запуске `/debug` |

1545| `paste-cache/` | Содержимое больших вставок |1561| `paste-cache/` | Содержимое больших вставок |

1546| `image-cache/<session>/` | Прикреплённые изображения. При каждой очистке Claude Code удаляет директории всех остальных сеансов, независимо от их возраста. |1562| `image-cache/<session>/` | Прикреплённые изображения, сохранённые Claude Code v2.1.274 и более ранними версиями. Более поздние версии сохраняют вставленные и прикреплённые изображения вне `~/.claude`, в директории `images/` для каждого сеанса в временной директории, которую контролирует [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars). Очистка удаляет оставшиеся директории других сеансов здесь, независимо от их возраста. |

1547| `uploads/<session>/` | Файлы, которые вы прикрепляете из веб-приложения или мобильного приложения, и фотографии, которые вы прикрепляете из мобильного приложения, при отправке сообщения в сеанс [Remote Control](/docs/ru/remote-control). Вложение в [облачный сеанс](/docs/ru/claude-code-on-the-web) сохраняется в собственной облачной среде этого сеанса, а не на вашей машине. |1563| `uploads/<session>/` | Файлы, которые вы прикрепляете из веб-приложения или мобильного приложения, и фотографии, которые вы прикрепляете из мобильного приложения, при отправке сообщения в сеанс [Remote Control](/docs/ru/remote-control). Вложение в [облачный сеанс](/docs/ru/claude-code-on-the-web) сохраняется в собственной облачной среде этого сеанса, а не на вашей машине. |

1548| `session-env/` | Метаданные окружения для каждого сеанса |1564| `session-env/` | Метаданные окружения для каждого сеанса |

1549| `tasks/` | Списки задач, написанные инструментами задач, одна директория на список |1565| `tasks/` | Списки задач, написанные инструментами задач, одна директория на список |

1552| `feedback-bundles/` | Отредактированные архивы стенограмм, написанные `/feedback` на сторонних поставщиков или когда не настроены учётные данные Anthropic, для отправки команде вашего аккаунта Anthropic |1568| `feedback-bundles/` | Отредактированные архивы стенограмм, написанные `/feedback` на сторонних поставщиков или когда не настроены учётные данные Anthropic, для отправки команде вашего аккаунта Anthropic |

1553| `feedback/drafts/` | Очередь [Claude-drafted feedback](/docs/ru/tools-reference#sendfeedback-tool-behavior), ожидающая вашего рассмотрения в `/feedback`. Очищается после `cleanupPeriodDays` или 30 дней, в зависимости от того, что меньше. Когда очередь достигает лимита в 10 черновиков, Claude Code удаляет самый старый черновик, чтобы освободить место. |1569| `feedback/drafts/` | Очередь [Claude-drafted feedback](/docs/ru/tools-reference#sendfeedback-tool-behavior), ожидающая вашего рассмотрения в `/feedback`. Очищается после `cleanupPeriodDays` или 30 дней, в зависимости от того, что меньше. Когда очередь достигает лимита в 10 черновиков, Claude Code удаляет самый старый черновик, чтобы освободить место. |

1554| `usage-data/` | `report.html` и копии отчётов с временными метками, написанные [`/insights`](/docs/ru/costs#analyze-your-usage-patterns), плюс кэшированные данные анализа для каждого сеанса, используемые для их построения |1570| `usage-data/` | `report.html` и копии отчётов с временными метками, написанные [`/insights`](/docs/ru/costs#analyze-your-usage-patterns), плюс кэшированные данные анализа для каждого сеанса, используемые для их построения |

1555| `skills/.trash/`, `plugins/.trash/` | [Skills](/docs/ru/skills#how-synced-skills-behave) и [plugins](/docs/ru/plugins-reference#synced-plugins) синхронизированные из claude.ai, которые Claude Code удалил. Перемещены сюда вместо удаления, чтобы вы могли восстановить файлы |1571| `skills/.trash/`, `plugins/.trash/` | [Skills](/docs/ru/skills#how-synced-skills-behave) и [plugins](/docs/ru/plugins-reference#synced-plugins), которые синхронизация claude.ai удалила, например после отключения одного на claude.ai или остановки синхронизации. Файлы остаются здесь, чтобы вы могли их восстановить, пока очистка их не удалит |

1556| `todos/`, `statsig/`, `logs/` | Устаревшие директории из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустую директорию. |1572| `todos/`, `statsig/`, `logs/` | Устаревшие директории из более старых версий. Больше не записываются. Очистка удаляет их содержимое, а затем пустую директорию. |

1557 1573 

1558Файлы сеансов в `sessions/`, автоматическая память и стенограммы Claude Desktop и Cowork следуют своим собственным правилам хранения:1574Файлы сеансов в `sessions/`, автоматическая память и стенограммы Claude Desktop и Cowork следуют своим собственным правилам хранения:

1610* Соответствующие строки подсказок в `history.jsonl`1626* Соответствующие строки подсказок в `history.jsonl`

1611* Запись проекта в `~/.claude.json`1627* Запись проекта в `~/.claude.json`

1612 1628 

1629Изображения, которые вы вставили или прикрепили в сеансах проекта, хранятся в временной директории Claude Code, а не в `~/.claude`, поэтому очистка их не удаляет. [Очистка хранения](#cleaned-up-automatically) удаляет их, как только они становятся старше `cleanupPeriodDays`.

1630 

1613Команда выводит полный план удаления и запрашивает подтверждение перед удалением чего-либо.1631Команда выводит полный план удаления и запрашивает подтверждение перед удалением чего-либо.

1614 1632 

1615Примеры ниже используют `~/work/my-repo` как заполнитель. Замените его на путь к вашему проекту. Если никакое состояние не соответствует пути, команда выводит ошибку и выходит со статусом 1.1633Примеры ниже используют `~/work/my-repo` как заполнитель. Замените его на путь к вашему проекту. Если никакое состояние не соответствует пути, команда выводит ошибку и выходит со статусом 1.

1660Вы также можете удалить любой из путей данных приложения выше вручную, за исключением [файлов состояния для сохранения](#state-files-to-keep). Новые сеансы не затронуты. Таблица ниже показывает, что вы потеряете для прошлых сеансов.1678Вы также можете удалить любой из путей данных приложения выше вручную, за исключением [файлов состояния для сохранения](#state-files-to-keep). Новые сеансы не затронуты. Таблица ниже показывает, что вы потеряете для прошлых сеансов.

1661 1679 

1662| Удалить | Вы потеряете |1680| Удалить | Вы потеряете |

1663| ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1681| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1664| `~/.claude/projects/` | Возобновление, продолжение и перемотка для прошлых сеансов, и автоматическую память для каждого проекта |1682| `~/.claude/projects/` | Возобновление, продолжение и перемотка для прошлых сеансов, и автоматическую память для каждого проекта |

1665| `~/.claude/history.jsonl` | Отзыв подсказки стрелки вверх, поиск истории `Ctrl+R` и завершение команды оболочки `!` |1683| `~/.claude/history.jsonl` | Отзыв подсказки стрелки вверх, поиск истории `Ctrl+R` и завершение команды оболочки `!` |

1666| `~/.claude/paste-cache/` | Вставленный текст в вспомненных подсказках; см. [вставка большого содержимого](/docs/ru/terminal-config#paste-large-content) |1684| `~/.claude/paste-cache/` | Вставленный текст в вспомненных подсказках; см. [вставка большого содержимого](/docs/ru/terminal-config#paste-large-content) |

1675| `~/.claude/policy-limits.json` | Ничего. Обновляется автоматически. |1693| `~/.claude/policy-limits.json` | Ничего. Обновляется автоматически. |

1676| `~/.claude/tasks/` | Списки задач, которые возобновлённый сеанс подхватит |1694| `~/.claude/tasks/` | Списки задач, которые возобновлённый сеанс подхватит |

1677| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | Возможность восстановления [синхронизированных skills](/docs/ru/skills#how-synced-skills-behave) и [синхронизированных plugins](/docs/ru/plugins-reference#synced-plugins), которые Claude Code удалил |1695| `~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/` | Возможность восстановления [синхронизированных skills](/docs/ru/skills#how-synced-skills-behave) и [синхронизированных plugins](/docs/ru/plugins-reference#synced-plugins), которые Claude Code удалил |

1678| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/image-cache/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Ничего, видимого пользователю |1696| `~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/` | Ничего, видимого пользователю |

1679| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/` | Ничего. Устаревшие директории, не записываемые текущими версиями. |1697| `~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/` | Ничего. Устаревшие директории, не записываемые текущими версиями. |

1680 1698 

1681Не удаляйте `~/.claude.json`, `~/.claude/settings.json` или `~/.claude/plugins/`: они содержат вашу аутентификацию, предпочтения и установленные plugins.1699Не удаляйте `~/.claude.json`, `~/.claude/settings.json` или `~/.claude/plugins/`: они содержат вашу аутентификацию, предпочтения и установленные plugins.

1682 1700 

Details

282 282 

283Claude Platform on AWS использует те же идентификаторы моделей, что и прямой API Claude.283Claude Platform on AWS использует те же идентификаторы моделей, что и прямой API Claude.

284 284 

285Псевдонимы по умолчанию `fable`, `opus`, `sonnet` и `haiku` разрешаются в встроенные значения по умолчанию Claude Code для Claude Platform on AWS, которые могут отставать от последнего выпуска. Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` разрешается в Opus 5. До версии v2.1.219 он разрешался в Opus 4.8, а до версии v2.1.207 в Opus 4.7.285Псевдонимы по умолчанию `fable`, `opus`, `sonnet` и `haiku` разрешаются в встроенные значения по умолчанию Claude Code для Claude Platform on AWS, которые могут отставать от последнего выпуска. Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` разрешается в Opus 5.5. До версии v2.1.280 он разрешался в Opus 5 с версии v2.1.219, в Opus 4.8 с версии v2.1.207, и в Opus 4.7 до этого.

286 286 

287Если вы развертываете Claude Code для команды, явно закрепите идентификаторы моделей, чтобы новый выпуск не переместил всех сразу:287Если вы развертываете Claude Code для команды, явно закрепите идентификаторы моделей, чтобы новый выпуск не переместил всех сразу:

288 288 

Details

56* **Потоки**: рабочие. Каждый — это отдельный [облачный сеанс](/docs/ru/claude-code-on-the-web) с собственным контекстным окном, который выполняет одну часть работы на собственной ветке, открывает pull request, когда работа это требует, и сообщает обратно в разговор, когда завершается.56* **Потоки**: рабочие. Каждый — это отдельный [облачный сеанс](/docs/ru/claude-code-on-the-web) с собственным контекстным окном, который выполняет одну часть работы на собственной ветке, открывает pull request, когда работа это требует, и сообщает обратно в разговор, когда завершается.

57* **С чего начинает каждый поток**:57* **С чего начинает каждый поток**:

58 * Репозитории и файлы проекта, плюс его [инструкции и память](#give-a-project-standing-context)58 * Репозитории и файлы проекта, плюс его [инструкции и память](#give-a-project-standing-context)

59 * `CLAUDE.md`, skills и plugins в [каждом из репозиториев проекта](#what-threads-pick-up-from-your-repositories), и в проекте с одним репозиторием также правила разрешений и hooks этого репозитория59 * `CLAUDE.md` и skills в [каждом из репозиториев проекта](#what-threads-pick-up-from-your-repositories), и в проекте с одним репозиторием также правила разрешений и hooks этого репозитория

60 * [Connectors](#get-skills-plugins-connectors-and-tools-into-threads) на вашем аккаунте claude.ai60 * [Connectors](#get-skills-plugins-connectors-and-tools-into-threads) на вашем аккаунте claude.ai

61 * [Облачная среда](#choose-an-environment-for-threads), которая устанавливает его сетевой доступ, переменные окружения, учетные данные API и установленные инструменты61 * [Облачная среда](#choose-an-environment-for-threads), которая устанавливает его сетевой доступ, переменные окружения, учетные данные API и установленные инструменты

62* **Панель Overview**: где вы [видите все потоки сразу](#see-what-needs-you-in-overview) и какие из них вам нужны. Его другие вкладки — **Library** для добавленных вами файлов и файлов, созданных потоками, **Pull requests** для открытых потоками, и **Routines** для запланированной работы в проекте.62* **Панель Overview**: где вы [видите все потоки сразу](#see-what-needs-you-in-overview) и какие из них вам нужны. Его другие вкладки — **Library** для добавленных вами файлов и файлов, созданных потоками, **Pull requests** для открытых потоками, и **Routines** для запланированной работы в проекте.

333 Что потоки берут из ваших репозиториев333 Что потоки берут из ваших репозиториев

334</h3>334</h3>

335 335 

336Каждый поток клонирует каждый репозиторий в проекте и загружает `CLAUDE.md`, skills и plugins из всех них. Правила разрешений, hooks и `env` поступают только из `.claude/settings.json` в директории, где поток начинается: внутри репозитория, когда проект имеет один, и выше клонов, когда он имеет несколько, где файл ни одного репозитория не читается для них.336Каждый поток клонирует каждый репозиторий в проекте и загружает `CLAUDE.md` и skills из всех них. Правила разрешений, hooks и `env` поступают только из `.claude/settings.json` в директории, где поток начинается: внутри репозитория, когда проект имеет один, и выше клонов, когда он имеет несколько, где файл ни одного репозитория не читается для них.

337 337 

338| В каждом репозитории | Один репозиторий | Несколько репозиториев |338| В каждом репозитории | Один репозиторий | Несколько репозиториев |

339| :------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------- |339| :------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------- |

340| `CLAUDE.md` | Загружается при запуске потока | Загружается из каждого репозитория при запуске потока |340| `CLAUDE.md` | Загружается при запуске потока | Загружается из каждого репозитория при запуске потока |

341| Skills, agents и команды в `.claude/` | Загружаются | Загружаются из каждого репозитория |341| Skills, agents и команды в `.claude/` | Загружаются | Загружаются из каждого репозитория |

342| Plugins, включенные в `.claude/settings.json` | Загружаются | Загружаются из каждого репозитория. Если два репозитория не согласны о plugin, установите его в **Project settings > Plugins**, что имеет приоритет |342| Plugins, включенные в `.claude/settings.json` | Не загружаются. Добавьте plugin в **Project settings > Plugins** вместо этого | Не загружаются. Добавьте plugin в **Project settings > Plugins** вместо этого |

343| Правила разрешений, hooks и `env`, определенные в `.claude/settings.json` | Применяются к потоку, кроме ключей `env`, которые [ни один облачный сеанс не соблюдает](/docs/ru/cloud-environments#what-carries-over-from-your-setup) | Не применяются |343| Правила разрешений, hooks и `env`, определенные в `.claude/settings.json` | Применяются к потоку, кроме ключей `env`, которые [ни один облачный сеанс не соблюдает](/docs/ru/cloud-environments#what-carries-over-from-your-setup) | Не применяются |

344 344 

345В проекте с несколькими репозиториями каждый клон прикреплен к потоку как [дополнительная директория](/docs/ru/memory#load-from-additional-directories) с включенной загрузкой `CLAUDE.md`, что является причиной того, что `CLAUDE.md` и skills каждого репозитория загружаются при запуске, даже несмотря на то, что поток начинается выше них. В любом случае, hooks, которые предоставляет включенный plugin, все еще работают, так как plugins загружаются из каждого репозитория. В проекте с несколькими репозиториями поместите постоянные правила в инструкции проекта и дайте потокам переменные окружения через [облачную среду](#choose-an-environment-for-threads).345В проекте с несколькими репозиториями каждый клон прикреплен к потоку как [дополнительная директория](/docs/ru/memory#load-from-additional-directories) с включенной загрузкой `CLAUDE.md`, что является причиной того, что `CLAUDE.md` и skills каждого репозитория загружаются при запуске, даже несмотря на то, что поток начинается выше них. В таком проекте поместите постоянные правила в инструкции проекта и дайте потокам переменные окружения через [облачную среду](#choose-an-environment-for-threads).

346 346 

347<h3 id="choose-an-environment-for-threads">347<h3 id="choose-an-environment-for-threads">

348 Выбор среды для потоков348 Выбор среды для потоков

359Потоки — это облачные сеансы, поэтому они не имеют skills, MCP servers, plugins и инструментов, установленных только на вашей машине. Чтобы сделать каждый из них доступным для потоков:359Потоки — это облачные сеансы, поэтому они не имеют skills, MCP servers, plugins и инструментов, установленных только на вашей машине. Чтобы сделать каждый из них доступным для потоков:

360 360 

361* Skills, subagents и команды: зафиксируйте их в репозитории, который вы добавили в проект, например skill в `.claude/skills/<skill-name>/SKILL.md`. Каждый поток клонирует каждый репозиторий в проекте и загружает `.claude/skills/`, `.claude/agents/` и `.claude/commands/` из каждого из них, поэтому skill, зафиксированный в одном репозитории, доступен в каждом новом потоке. Потоки также загружают skills, которые вы включаете для вашего аккаунта claude.ai.361* Skills, subagents и команды: зафиксируйте их в репозитории, который вы добавили в проект, например skill в `.claude/skills/<skill-name>/SKILL.md`. Каждый поток клонирует каждый репозиторий в проекте и загружает `.claude/skills/`, `.claude/agents/` и `.claude/commands/` из каждого из них, поэтому skill, зафиксированный в одном репозитории, доступен в каждом новом потоке. Потоки также загружают skills, которые вы включаете для вашего аккаунта claude.ai.

362* Plugins: добавьте их в **Project settings > Plugins**; они загружаются в каждый новый поток. Plugins, которые репозиторий объявляет в его `.claude/settings.json`, также загружаются; см. [Что переносится из вашей настройки](/docs/ru/cloud-environments#what-carries-over-from-your-setup).362* Plugins: добавьте их в **Project settings > Plugins**; они загружаются в каждый новый поток. Plugins, которые репозиторий объявляет в его `.claude/settings.json`, [не загружаются в потоки](/docs/ru/cloud-environments#what-carries-over-from-your-setup), потому что потоки — это облачные сеансы.

363* MCP servers: потоки получают свои MCP инструменты из connectors на вашем аккаунте claude.ai, которые являются MCP servers, которые вы подключаете один раз в [claude.ai/customize/connectors](https://claude.ai/customize/connectors) или через ссылку **Manage connectors** в **Project settings > Environment**. Каждый поток может использовать все их без настройки для каждого проекта. Разговор проекта сам по себе не имеет connectors, поэтому отправляйте работу, которая требует один, как задачу для потока. В проекте с одним репозиторием потоки также загружают MCP servers из [`.mcp.json`](/docs/ru/cloud-environments#what-carries-over-from-your-setup) этого репозитория. [Как connectors достигают Claude Code](/docs/ru/mcp#how-connectors-reach-claude-code) перечисляет правила для облачных сеансов и параметры, которые отключают connectors.363* MCP servers: потоки получают свои MCP инструменты из connectors на вашем аккаунте claude.ai, которые являются MCP servers, которые вы подключаете один раз в [claude.ai/customize/connectors](https://claude.ai/customize/connectors) или через ссылку **Manage connectors** в **Project settings > Environment**. Каждый поток может использовать все их без настройки для каждого проекта. Разговор проекта сам по себе не имеет connectors, поэтому отправляйте работу, которая требует один, как задачу для потока. В проекте с одним репозиторием потоки также загружают MCP servers из [`.mcp.json`](/docs/ru/cloud-environments#what-carries-over-from-your-setup) этого репозитория. [Как connectors достигают Claude Code](/docs/ru/mcp#how-connectors-reach-claude-code) перечисляет правила для облачных сеансов и параметры, которые отключают connectors.

364* Инструменты командной строки и пакеты: установите их в [скрипт настройки](/docs/ru/cloud-environments#setup-scripts) среды.364* Инструменты командной строки и пакеты: установите их в [скрипт настройки](/docs/ru/cloud-environments#setup-scripts) среды.

365 365 

Details

93| `--exec` | Запустить команду shell как фоновое задание с поддержкой PTY вместо запуска сеанса Claude. Используйте с `--bg` для запуска из shell | `claude --bg --exec 'pytest -x'` |93| `--exec` | Запустить команду shell как фоновое задание с поддержкой PTY вместо запуска сеанса Claude. Используйте с `--bg` для запуска из shell | `claude --bg --exec 'pytest -x'` |

94| `--fallback-model` | Включить автоматический переход на указанную модель (модели) при перегрузке или недоступности основной модели, например снятая с производства модель. Принимает разделённый запятыми список, пробуемый по порядку. См. [Цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains). Чтобы сохранить цепочку между сеансами, используйте параметр [`fallbackModel`](/docs/ru/settings-reference#fallbackmodel), который этот флаг переопределяет | `claude --fallback-model sonnet,haiku` |94| `--fallback-model` | Включить автоматический переход на указанную модель (модели) при перегрузке или недоступности основной модели, например снятая с производства модель. Принимает разделённый запятыми список, пробуемый по порядку. См. [Цепочки резервных моделей](/docs/ru/model-config#fallback-model-chains). Чтобы сохранить цепочку между сеансами, используйте параметр [`fallbackModel`](/docs/ru/settings-reference#fallbackmodel), который этот флаг переопределяет | `claude --fallback-model sonnet,haiku` |

95| `--fork-session` | При возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с `--resume` или `--continue`) | `claude --resume abc123 --fork-session` |95| `--fork-session` | При возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с `--resume` или `--continue`) | `claude --resume abc123 --fork-session` |

96| `--forward-subagent-text` | Выдать текст [subagent](/docs/ru/sub-agents) и блоки thinking в выходной поток как сообщения `assistant` и `user` с установленным `parent_tool_use_id`, чтобы вы могли восстановить транскрипт каждого subagent. Без этого флага Claude Code опускает текст и блоки thinking subagent, который работает на [переднем плане](/docs/ru/sub-agents#run-subagents-in-foreground-or-background). Требует `--print` и `--output-format stream-json`. Claude Code также пересылает сообщения от [вложенных subagents](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), устанавливая `parent_tool_use_id` на ID вызова инструмента Agent, который порождает каждый; это требует Claude Code v2.1.219 или позже. Переменная окружения [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ru/env-vars) включает то же поведение. Требует Claude Code v2.1.211 или позже | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |96| `--forward-subagent-text` | Выдать текст [subagent](/docs/ru/sub-agents) и блоки thinking в выходной поток как сообщения `assistant` и `user` с установленным `parent_tool_use_id`, чтобы вы могли восстановить транскрипт каждого subagent. Без этого флага Claude Code опускает текст и блоки thinking subagent, который работает на [переднем плане](/docs/ru/sub-agents#run-subagents-in-foreground-or-background). Требует `--print` и `--output-format stream-json`. Claude Code также пересылает сообщения от [вложенных subagents](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), устанавливая `parent_tool_use_id` на ID вызова инструмента Agent или Skill, который порождает каждый; это требует Claude Code v2.1.219 или позже, и сообщения subagents, которые forked skill порождает, и вложенных forked skills, требуют v2.1.275 или позже. Переменная окружения [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ru/env-vars) включает то же поведение. Требует Claude Code v2.1.211 или позже | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |

97| `--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` |97| `--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` |

98| `--ide` | Автоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDE | `claude --ide` |98| `--ide` | Автоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDE | `claude --ide` |

99| `--init` | Запустить [Setup hooks](/docs/ru/hooks#setup) с matcher `init` перед сеансом (только режим печати) | `claude -p --init "query"` |99| `--init` | Запустить [Setup hooks](/docs/ru/hooks#setup) с matcher `init` перед сеансом (только режим печати) | `claude -p --init "query"` |

103| `--input-format` | Указать формат входных данных для режима печати (опции: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |103| `--input-format` | Указать формат входных данных для режима печати (опции: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |

104| `--json-schema` | Получить проверенный вывод JSON, соответствующий JSON Schema после завершения рабочего процесса агента (только режим печати). См. [структурированные выходы](/docs/ru/agent-sdk/structured-outputs). Claude Code выходит с ошибкой при недействительной схеме и принимает ключевое слово `format` как аннотацию без проверки на стороне клиента | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |104| `--json-schema` | Получить проверенный вывод JSON, соответствующий JSON Schema после завершения рабочего процесса агента (только режим печати). См. [структурированные выходы](/docs/ru/agent-sdk/structured-outputs). Claude Code выходит с ошибкой при недействительной схеме и принимает ключевое слово `format` как аннотацию без проверки на стороне клиента | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

105| `--maintenance` | Запустить [Setup hooks](/docs/ru/hooks#setup) с matcher `maintenance` перед сеансом (только режим печати) | `claude -p --maintenance "query"` |105| `--maintenance` | Запустить [Setup hooks](/docs/ru/hooks#setup) с matcher `maintenance` перед сеансом (только режим печати) | `claude -p --maintenance "query"` |

106| `--max-budget-usd` | Максимальная сумма в долларах для расходования на вызовы API перед остановкой (только режим печати). Расходы от [subagents](/docs/ru/sub-agents) считаются в сторону лимита. Как только расходы достигают лимита, порождение другого subagent не удаётся с `Budget limit reached`, и Claude Code останавливает фоновые subagents, которые всё ещё работают; поведения принудительного применения лимита требуют Claude Code v2.1.217 или позже | `claude -p --max-budget-usd 5.00 "query"` |106| `--max-budget-usd` | Максимальная сумма в долларах для расходования на вызовы API перед остановкой (только режим печати). Расходы от [subagents](/docs/ru/sub-agents) считаются в сторону лимита. Когда вы возвращаетесь к беседе с `--continue` или `--resume`, итоги [восстановленные из более ранних запусков](/docs/ru/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) не считаются в сторону него. Как только расходы достигают лимита, порождение другого subagent не удаётся с `Budget limit reached`, и Claude Code останавливает фоновые subagents, которые всё ещё работают; поведения принудительного применения лимита требуют Claude Code v2.1.217 или позже | `claude -p --max-budget-usd 5.00 "query"` |

107| `--max-turns` | Ограничить количество агентских ходов (только режим печати). Выходит с ошибкой при достижении лимита. По умолчанию нет лимита. С `--input-format stream-json` сообщение, всё ещё находящееся в очереди, когда лимит заканчивает ход, остаётся в очереди и начинает новый ход с собственным лимитом | `claude -p --max-turns 3 "query"` |107| `--max-turns` | Ограничить количество агентских ходов (только режим печати). Выходит с ошибкой при достижении лимита. По умолчанию нет лимита. С `--input-format stream-json` сообщение, всё ещё находящееся в очереди, когда лимит заканчивает ход, остаётся в очереди и начинает новый ход с собственным лимитом | `claude -p --max-turns 3 "query"` |

108| `--mcp-config` | Загрузить MCP серверы из JSON файлов или строк (разделённые пробелом). Когда вы передаёте этот флаг с `-p`, Claude Code ждёт, пока всё ещё ожидающие серверы подключатся перед запуском первого хода, до стартового таймаута [`MCP_TIMEOUT`](/docs/ru/env-vars), 30 секунд по умолчанию; сервер с [кэшированным списком инструментов](/docs/ru/mcp#managing-your-servers) пропускает ожидание и подключается при первом использовании. Ожидание требует Claude Code v2.1.221 или позже | `claude --mcp-config ./mcp.json` |108| `--mcp-config` | Загрузить MCP серверы из JSON файлов или строк (разделённые пробелом). Когда вы передаёте этот флаг с `-p`, Claude Code ждёт, пока всё ещё ожидающие серверы подключатся перед запуском первого хода, до стартового таймаута [`MCP_TIMEOUT`](/docs/ru/env-vars), 30 секунд по умолчанию; сервер с [кэшированным списком инструментов](/docs/ru/mcp#managing-your-servers) пропускает ожидание и подключается при первом использовании. Ожидание требует Claude Code v2.1.221 или позже | `claude --mcp-config ./mcp.json` |

109| `--model` | Устанавливает модель для текущего сеанса с [псевдонимом модели](/docs/ru/model-config#model-aliases), таким как `sonnet`, `opus`, `haiku` или `fable`, или полным именем модели. Переопределяет параметр [`model`](/docs/ru/settings-reference#model) и [`ANTHROPIC_MODEL`](/docs/ru/model-config#environment-variables) | `claude --model claude-sonnet-5` |109| `--model` | Устанавливает модель для текущего сеанса с [псевдонимом модели](/docs/ru/model-config#model-aliases), таким как `sonnet`, `opus`, `haiku` или `fable`, или полным именем модели. Переопределяет параметр [`model`](/docs/ru/settings-reference#model) и [`ANTHROPIC_MODEL`](/docs/ru/model-config#environment-variables) | `claude --model claude-sonnet-5` |

157 157 

158`--system-prompt` и `--system-prompt-file` являются взаимоисключающими. Флаги добавления можно комбинировать с любым флагом замены.158`--system-prompt` и `--system-prompt-file` являются взаимоисключающими. Флаги добавления можно комбинировать с любым флагом замены.

159 159 

160Когда текст замены объединяет инструкции, которые одинаковы при каждом запуске, с контекстом, который изменяется при каждом запуске, добавьте строку, содержащую только `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` между инструкциями и контекстом. Claude Code разделяет приглашение в первой такой строке и удаляет эту строку, поэтому часть выше неё остаётся кэшированной, а часть ниже изменяется. Требует Claude Code v2.1.275 или позже. [Кэшировать статическую часть пользовательского приглашения](/docs/ru/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt) перечисляет конфигурации, где применяется разделение.

161 

160Выбирайте в зависимости от того, подходит ли стандартная идентичность Claude Code для вашей задачи. Используйте флаг добавления, когда Claude должен оставаться помощником по кодированию, который также следует вашим дополнительным правилам: инструкции для каждого вызова, форматирование вывода или контекст домена для скрипта `-p`. Добавление сохраняет стандартное руководство по инструментам, инструкции безопасности и соглашения кодирования, поэтому вы предоставляете только то, что отличается. Используйте флаг замены, когда поверхность, идентичность или модель разрешения отличаются от Claude Code, например некодирующий агент в конвейере, который не смотрит ни один человек. Замена удаляет весь стандартный запрос, включая руководство по инструментам и инструкции безопасности, поэтому вы берёте на себя ответственность за всё, что вашей задаче всё ещё нужно.162Выбирайте в зависимости от того, подходит ли стандартная идентичность Claude Code для вашей задачи. Используйте флаг добавления, когда Claude должен оставаться помощником по кодированию, который также следует вашим дополнительным правилам: инструкции для каждого вызова, форматирование вывода или контекст домена для скрипта `-p`. Добавление сохраняет стандартное руководство по инструментам, инструкции безопасности и соглашения кодирования, поэтому вы предоставляете только то, что отличается. Используйте флаг замены, когда поверхность, идентичность или модель разрешения отличаются от Claude Code, например некодирующий агент в конвейере, который не смотрит ни один человек. Замена удаляет весь стандартный запрос, включая руководство по инструментам и инструкции безопасности, поэтому вы берёте на себя ответственность за всё, что вашей задаче всё ещё нужно.

161 163 

162Для постоянных персон, которые вы можете переключать и делиться между проектом, используйте [стили вывода](/docs/ru/output-styles). Для соглашений проекта, которые Claude должен всегда соблюдать, используйте [CLAUDE.md](/docs/ru/memory). [Руководство Agent SDK по системным приглашениям](/docs/ru/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) охватывает то же решение более подробно.164Для постоянных персон, которые вы можете переключать и делиться между проектом, используйте [стили вывода](/docs/ru/output-styles). Для соглашений проекта, которые Claude должен всегда соблюдать, используйте [CLAUDE.md](/docs/ru/memory). [Руководство Agent SDK по системным приглашениям](/docs/ru/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) охватывает то же решение более подробно.

Details

300| Ваши репозитория `.mcp.json` MCP серверы | Да, в сеансе с одним репозиторием | Часть клона, найденная из рабочего каталога сеанса |300| Ваши репозитория `.mcp.json` MCP серверы | Да, в сеансе с одним репозиторием | Часть клона, найденная из рабочего каталога сеанса |

301| Ваши репозитория `.claude/rules/` | Да | Часть клона |301| Ваши репозитория `.claude/rules/` | Да | Часть клона |

302| Ваши репозитория `.claude/skills/`, `.claude/agents/`, `.claude/commands/` | Да | Часть клона |302| Ваши репозитория `.claude/skills/`, `.claude/agents/`, `.claude/commands/` | Да | Часть клона |

303| Плагины, объявленные в `.claude/settings.json` | Да | Установлены при запуске сеанса из [marketplace](/docs/ru/plugin-marketplaces), который вы объявили. Требует сетевого доступа для достижения источника marketplace |303| Плагины и marketplaces, объявленные в `.claude/settings.json` вашего репозитория | Нет | Облачный сеанс не устанавливает плагины, которые репозиторий включает в [`enabledPlugins`](/docs/ru/settings-reference#enabledplugins), включая те из marketplaces, которые он перечисляет в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces). Включите плагин для вашей учётной записи claude.ai вместо этого, чтобы Claude Code загружал его как [синхронизированный плагин](/docs/ru/plugins-reference#synced-plugins) |

304| [Параметры, управляемые сервером](/docs/ru/server-managed-settings) вашей организации | Да | Получены с серверов Anthropic при запуске сеанса. Смотрите [Охват поверхности](/docs/ru/model-config#surface-coverage) для того, как `availableModels` применяется в облачных сеансах. Параметры, развёрнутые на вашем устройстве через MDM или файлы управляемых параметров, не применяются, потому что сеанс работает на управляемой Anthropic виртуальной машине; в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) сеансы также читают файл управляемых параметров в образе runner, согласно [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) |304| [Параметры, управляемые сервером](/docs/ru/server-managed-settings) вашей организации | Да | Получены с серверов Anthropic при запуске сеанса. Смотрите [Охват поверхности](/docs/ru/model-config#surface-coverage) для того, как `availableModels` применяется в облачных сеансах. Параметры, развёрнутые на вашем устройстве через MDM или файлы управляемых параметров, не применяются, потому что сеанс работает на управляемой Anthropic виртуальной машине; в [самостоятельно размещённой среде](/docs/ru/self-hosted-environments) сеансы также читают файл управляемых параметров в образе runner, согласно [как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) |

305| Ваш пользовательский `~/.claude/CLAUDE.md` | Нет | Находится на вашей машине, не в репозитории |305| Ваш пользовательский `~/.claude/CLAUDE.md` | Нет | Находится на вашей машине, не в репозитории |

306| Ваши пользовательские `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | Нет | Находятся на вашей машине, не в репозитории. Зафиксируйте их в каталоге `.claude/` репозитория вместо этого. Облачные сеансы автоматически загружают skills, которые вы включаете на claude.ai |306| Ваши пользовательские `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | Нет | Находятся на вашей машине, не в репозитории. Зафиксируйте их в каталоге `.claude/` репозитория вместо этого. Облачные сеансы автоматически загружают skills, которые вы включаете на claude.ai |

307| Плагины, включённые только в ваши пользовательские параметры | Нет | Пользовательский `enabledPlugins` находится в `~/.claude/settings.json`. Объявите их в `.claude/settings.json` репозитория вместо этого, или включите их для вашей учётной записи claude.ai, чтобы Claude Code загружал их как [синхронизированные плагины](/docs/ru/plugins-reference#synced-plugins) |307| Плагины, включённые только в ваши пользовательские параметры | Нет | Пользовательский `enabledPlugins` находится в `~/.claude/settings.json` на вашей машине. Включите их для вашей учётной записи claude.ai вместо этого, чтобы Claude Code загружал их как [синхронизированные плагины](/docs/ru/plugins-reference#synced-plugins) |

308| MCP серверы, которые вы добавили с `claude mcp add` в область по умолчанию local или область пользователя | Нет | Те записывают в `~/.claude.json` на вашей машине, не в репозитории. Добавьте сервер с `claude mcp add --scope project`, который записывает [`.mcp.json`](/docs/ru/mcp#project-scope) репозитория, и зафиксируйте этот файл. Сеанс с одним репозиторием загружает его |308| MCP серверы, которые вы добавили с `claude mcp add` в область по умолчанию local или область пользователя | Нет | Те записывают в `~/.claude.json` на вашей машине, не в репозитории. Добавьте сервер с `claude mcp add --scope project`, который записывает [`.mcp.json`](/docs/ru/mcp#project-scope) репозитория, и зафиксируйте этот файл. Сеанс с одним репозиторием загружает его |

309| Переменные транспорта в блоке `env` вашего `.claude/settings.json` репозитория, такие как `NODE_EXTRA_CA_CERTS` и [переменные сертификата клиента mTLS](/docs/ru/network-config#mtls-authentication) | Нет | Среда хостинга управляет соединением API сеанса, поэтому Claude Code игнорирует эти ключи и отмечает каждый игнорируемый ключ в журнале отладки сеанса |309| Переменные транспорта в блоке `env` вашего `.claude/settings.json` репозитория, такие как `NODE_EXTRA_CA_CERTS` и [переменные сертификата клиента mTLS](/docs/ru/network-config#mtls-authentication) | Нет | Среда хостинга управляет соединением API сеанса, поэтому Claude Code игнорирует эти ключи и отмечает каждый игнорируемый ключ в журнале отладки сеанса |

310| Ключи API и токены для сервисов, которые Claude вызывает | На планах Pro и Max, как [учётные данные API](#add-api-credentials) | Вы добавляете ключ один раз в среду и прокси агента прикрепляет его к запросам для хостов, которые вы перечисляете. Ключ, который прокси агента [не может прикрепить](#requests-that-never-get-the-credential), или любой ключ на плане Team или Enterprise, остаётся в переменной окружения |310| Ключи API и токены для сервисов, которые Claude вызывает | На планах Pro и Max, как [учётные данные API](#add-api-credentials) | Вы добавляете ключ один раз в среду и прокси агента прикрепляет его к запросам для хостов, которые вы перечисляете. Ключ, который прокси агента [не может прикрепить](#requests-that-never-get-the-credential), или любой ключ на плане Team или Enterprise, остаётся в переменной окружения |

commands.md +5 −4

Details

26 26 

27**Запустите работу параллельно.** Claude делегирует побочные задачи [подагентам](/docs/ru/sub-agents), а `/tasks` выводит список фоновой работы текущего сеанса, включая завершённых подагентов. `/background` отделяет весь сеанс, чтобы он продолжал работать как [фоновый агент](/docs/ru/agent-view) и освобождает ваш терминал. Для крупного изменения, охватывающего всю кодовую базу, `/batch` разбивает его на независимые единицы и запускает каждую в своём [worktree](/docs/ru/worktrees). Смотрите [Запуск агентов параллельно](/docs/ru/agents), чтобы понять, как эти подходы связаны.27**Запустите работу параллельно.** Claude делегирует побочные задачи [подагентам](/docs/ru/sub-agents), а `/tasks` выводит список фоновой работы текущего сеанса, включая завершённых подагентов. `/background` отделяет весь сеанс, чтобы он продолжал работать как [фоновый агент](/docs/ru/agent-view) и освобождает ваш терминал. Для крупного изменения, охватывающего всю кодовую базу, `/batch` разбивает его на независимые единицы и запускает каждую в своём [worktree](/docs/ru/worktrees). Смотрите [Запуск агентов параллельно](/docs/ru/agents), чтобы понять, как эти подходы связаны.

28 28 

29**Перед развёртыванием.** `/diff` показывает, что изменилось. `/code-review` проверяет текущий diff на ошибки корректности и очистку и может применить результаты с помощью `--fix`; передайте номер PR, например `/code-review high 1234`, чтобы вместо этого проверить pull request. `/review` — это псевдоним. `/code-review ultra` запускает многоагентную проверку в облаке. `/security-review` проверяет diff на уязвимости безопасности.29**Перед развёртыванием.** `/diff` показывает, что изменилось. `/code-review` проверяет текущий diff на ошибки корректности и может применить результаты с помощью `--fix`; передайте номер PR, например `/code-review high 1234`, чтобы вместо этого проверить pull request. `/review` — это псевдоним. `/code-review ultra` запускает многоагентную проверку в облаке. `/security-review` проверяет diff на уязвимости безопасности.

30 30 

31**Между сеансами.** `/clear` начинает заново с новой задачи, сохраняя память проекта. `/resume` возвращает к более ранней беседе, `/branch` ветвит текущую, чтобы попробовать другое направление, а `/fork` копирует её в новый [фоновый сеанс](/docs/ru/agent-view). `/teleport` переносит веб-сеанс в этот терминал, а `/remote-control` позволяет продолжить этот локальный сеанс с другого устройства.31**Между сеансами.** `/clear` начинает заново с новой задачи, сохраняя память проекта. `/resume` возвращает к более ранней беседе, `/branch` ветвит текущую, чтобы попробовать другое направление, а `/fork` копирует её в новый [фоновый сеанс](/docs/ru/agent-view). `/teleport` переносит веб-сеанс в этот терминал, а `/remote-control` позволяет продолжить этот локальный сеанс с другого устройства.

32 32 

69| `/chrome` | Настроить параметры [Claude в Chrome](/docs/ru/chrome) |69| `/chrome` | Настроить параметры [Claude в Chrome](/docs/ru/chrome) |

70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/ru/skills#bundled-skills).** Загрузить справочный материал [Claude API](https://platform.claude.com/docs/en/api/overview) и [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) для языка вашего проекта. Также активируется автоматически, когда ваш код импортирует `anthropic` или `@anthropic-ai/sdk`. Запустите `migrate` для обновления существующего кода Claude API на более новую модель. Запустите `upgrade` для перемещения зависимости Anthropic SDK вашего проекта через основную версию, в настоящее время пакет Python `anthropic` с 0.x на 1.x. Запустите `managed-agents-onboard` для пошагового руководства, которое создаёт нового Managed Agent. Запустите `prompt-audit` для отмечания инструкций, написанных для более старых моделей в ваших подсказках, skills и описаниях инструментов, и предложения исправлений как diff. Запустите `cost-optimize` для профилирования того, куда идут расходы Claude API вашего проекта, и предложения сбережений из опций, таких как prompt caching, обрезка ненужных входных и выходных токенов, пакетная обработка, усилие и выбор модели, по одному изменению за раз. Запустите `build-eval` для создания набора eval для вашего приложения на базе Claude, и `hillclimb` для итеративного улучшения приложения против существующего eval. Подкоманда `prompt-audit` требует Claude Code версии 2.1.221 или позже, `upgrade` требует версии 2.1.236 или позже, `cost-optimize` требует версии 2.1.247 или позже, а `build-eval` и `hillclimb` требуют версии 2.1.259 или позже |70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/ru/skills#bundled-skills).** Загрузить справочный материал [Claude API](https://platform.claude.com/docs/en/api/overview) и [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) для языка вашего проекта. Также активируется автоматически, когда ваш код импортирует `anthropic` или `@anthropic-ai/sdk`. Запустите `migrate` для обновления существующего кода Claude API на более новую модель. Запустите `upgrade` для перемещения зависимости Anthropic SDK вашего проекта через основную версию, в настоящее время пакет Python `anthropic` с 0.x на 1.x. Запустите `managed-agents-onboard` для пошагового руководства, которое создаёт нового Managed Agent. Запустите `prompt-audit` для отмечания инструкций, написанных для более старых моделей в ваших подсказках, skills и описаниях инструментов, и предложения исправлений как diff. Запустите `cost-optimize` для профилирования того, куда идут расходы Claude API вашего проекта, и предложения сбережений из опций, таких как prompt caching, обрезка ненужных входных и выходных токенов, пакетная обработка, усилие и выбор модели, по одному изменению за раз. Запустите `build-eval` для создания набора eval для вашего приложения на базе Claude, и `hillclimb` для итеративного улучшения приложения против существующего eval. Подкоманда `prompt-audit` требует Claude Code версии 2.1.221 или позже, `upgrade` требует версии 2.1.236 или позже, `cost-optimize` требует версии 2.1.247 или позже, а `build-eval` и `hillclimb` требуют версии 2.1.259 или позже |

71| `/clear [name]` | Начать новый разговор с пустым контекстом. Передайте имя для обозначения предыдущего разговора в средстве выбора `/resume`. Чтобы освободить контекст, продолжая тот же разговор, используйте `/compact`. Возобновите предыдущий разговор с помощью `/resume`, или, в том же процессе Claude Code, восстановите его из [записи предыдущего сеанса меню перемотки](/docs/ru/checkpointing#rewind-past-a-cleared-conversation). Запись перемотки требует Claude Code версии 2.1.191 или позже. Псевдонимы: `/reset`, `/new` |71| `/clear [name]` | Начать новый разговор с пустым контекстом. Передайте имя для обозначения предыдущего разговора в средстве выбора `/resume`. Чтобы освободить контекст, продолжая тот же разговор, используйте `/compact`. Возобновите предыдущий разговор с помощью `/resume`, или, в том же процессе Claude Code, восстановите его из [записи предыдущего сеанса меню перемотки](/docs/ru/checkpointing#rewind-past-a-cleared-conversation). Запись перемотки требует Claude Code версии 2.1.191 или позже. Псевдонимы: `/reset`, `/new` |

72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ru/skills#bundled-skills).** Проверить текущий diff, или PR номер, ветку или путь, который вы передаёте, на ошибки корректности и возможности очистки. Передайте `--fix` для применения результатов, `--comment` для публикации их на GitHub PR или GitLab merge request, или `ultra` для запуска глубокой [облачной проверки](/docs/ru/ultrareview). Публикация в GitLab merge request требует Claude Code версии 2.1.257 или позже. С `ultra` на целевом `github.com` PR передайте `--post` для предварительного выбора [публикации завершённых результатов на PR](/docs/ru/ultrareview#post-findings-to-the-pull-request) в диалоге запуска; `--post` требует Claude Code версии 2.1.227 или позже. См. [Проверить diff локально](/docs/ru/code-review#review-a-diff-locally) для уровней усилий, нацеливания и того, как это связано с `/simplify`. Псевдоним: `/review` |72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ru/skills#bundled-skills).** Проверить текущий diff, или PR номер, ветку или путь, который вы передаёте, на ошибки корректности. В зависимости от вашей модели и уровня усилий, проверка также охватывает возможности очистки. Передайте `--fix` для применения результатов, `--comment` для публикации их на GitHub PR или GitLab merge request, или `ultra` для запуска глубокой [облачной проверки](/docs/ru/ultrareview). Публикация в GitLab merge request требует Claude Code версии 2.1.257 или позже. С `ultra` на целевом `github.com` PR передайте `--post` для предварительного выбора [публикации завершённых результатов на PR](/docs/ru/ultrareview#post-findings-to-the-pull-request) в диалоге запуска; `--post` требует Claude Code версии 2.1.227 или позже. См. [Проверить diff локально](/docs/ru/code-review#review-a-diff-locally) для уровней усилий, нацеливания и того, как это связано с `/simplify`. Псевдоним: `/review` |

73| `/color [color\|default]` | Установить цвет строки подсказки для текущего сеанса. Доступные цвета: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Используйте `default` для сброса, или запустите без аргумента для выбора случайного цвета. Когда [Remote Control](/docs/ru/remote-control) подключён, цвет синхронизируется с claude.ai/code. Также доступно в неинтерактивном режиме (`-p`); требует Claude Code версии 2.1.205 или позже |73| `/color [color\|default]` | Установить цвет строки подсказки для текущего сеанса. Доступные цвета: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Используйте `default` для сброса, или запустите без аргумента для выбора случайного цвета. Когда [Remote Control](/docs/ru/remote-control) подключён, цвет синхронизируется с claude.ai/code. Также доступно в неинтерактивном режиме (`-p`); требует Claude Code версии 2.1.205 или позже |

74| `/compact [instructions]` | Освободить контекст путём суммирования разговора до сих пор. Опционально передайте инструкции фокуса для суммирования. См. [как компактификация обрабатывает правила, skills и файлы памяти](/docs/ru/context-window#what-survives-compaction) |74| `/compact [instructions]` | Освободить контекст путём суммирования разговора до сих пор. Опционально передайте инструкции фокуса для суммирования. См. [как компактификация обрабатывает правила, skills и файлы памяти](/docs/ru/context-window#what-survives-compaction) |

75| `/config [key=value ...]` | Открыть интерфейс [Параметры](/docs/ru/settings) для настройки темы, модели, [стиля вывода](/docs/ru/output-styles) и других предпочтений. Передайте одну или несколько пар `key=value` для установки параметра напрямую без открытия интерфейса, например `/config thinking=false`, `/config theme=dark` или `/config model=sonnet`. Форма `key=value` также работает в неинтерактивном режиме (`-p`) и из мобильного приложения Claude через [Remote Control](/docs/ru/remote-control). Форма `key=value` не может включить параметр, который требует вашего подтверждения на панели, такой как [`autoContinueAtUsageLimit`](/docs/ru/interactive-mode#turn-automatic-continue-off), хотя может его отключить. Запустите `/config --help` для списка ключей, которые он принимает. Псевдоним: `/settings` |75| `/config [key=value ...]` | Открыть интерфейс [Параметры](/docs/ru/settings) для настройки темы, модели, [стиля вывода](/docs/ru/output-styles) и других предпочтений. Передайте одну или несколько пар `key=value` для установки параметра напрямую без открытия интерфейса, например `/config thinking=false`, `/config theme=dark` или `/config model=sonnet`. Форма `key=value` также работает в неинтерактивном режиме (`-p`) и из мобильного приложения Claude через [Remote Control](/docs/ru/remote-control). Форма `key=value` не может включить параметр, который требует вашего подтверждения на панели, такой как [`autoContinueAtUsageLimit`](/docs/ru/interactive-mode#turn-automatic-continue-off), хотя может его отключить. Запустите `/config --help` для списка ключей, которые он принимает. Псевдоним: `/settings` |

85| `/desktop` | Продолжить текущий сеанс в приложении Claude Code Desktop. Требует macOS или x64 Windows и подписку Claude. Псевдоним: `/app` |85| `/desktop` | Продолжить текущий сеанс в приложении Claude Code Desktop. Требует macOS или x64 Windows и подписку Claude. Псевдоним: `/app` |

86| `/diff` | Просмотреть изменения в вашем рабочем дереве, включая правки, которые Claude сделал до сих пор. См. [Просмотреть изменения с /diff](/docs/ru/interactive-mode#review-changes-with-%2Fdiff) |86| `/diff` | Просмотреть изменения в вашем рабочем дереве, включая правки, которые Claude сделал до сих пор. См. [Просмотреть изменения с /diff](/docs/ru/interactive-mode#review-changes-with-%2Fdiff) |

87| `/doctor` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить проверку настройки, которая диагностирует проблемы и может их исправить. Проверяет здоровье установки, включая дублирующиеся или оставшиеся установки, проблемы `PATH` и непарсируемые файлы параметров. Находит неиспользуемые skills, MCP серверы и плагины в сравнении с их стоимостью контекста, отмечает медленные [hooks](/docs/ru/hooks) и проверяет наличие более новой версии на вашем [канале выпуска](/docs/ru/setup#configure-release-channel). Дедублирует локальные файлы `CLAUDE.md` против проверенных, обрезает проверенные файлы [`CLAUDE.md`](/docs/ru/memory#my-claude-md-is-too-large) путём вырезания контента, который Claude может вывести из кодовой базы, и переносит оставшееся всегда загружаемое руководство в [skills](/docs/ru/skills) и вложенные файлы `CLAUDE.md`, которые загружаются по требованию. Также предлагает сделать [auto mode](/docs/ru/permissions#permission-modes) вашим по умолчанию и [предварительно одобрить](/docs/ru/permissions) часто отклоняемые команды только для чтения. Сообщает результаты в первую очередь и просит подтверждение перед изменением чего-либо. Из терминала `claude doctor` выводит диагностику установки только для чтения без запуска сеанса. Псевдоним: `/checkup`. Проверка обрезки `CLAUDE.md` требует Claude Code версии 2.1.206 или позже. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения и нажатие `f` отправляло отчёт Claude |87| `/doctor` | **[Skill](/docs/ru/skills#bundled-skills).** Запустить проверку настройки, которая диагностирует проблемы и может их исправить. Проверяет здоровье установки, включая дублирующиеся или оставшиеся установки, проблемы `PATH` и непарсируемые файлы параметров. Находит неиспользуемые skills, MCP серверы и плагины в сравнении с их стоимостью контекста, отмечает медленные [hooks](/docs/ru/hooks) и проверяет наличие более новой версии на вашем [канале выпуска](/docs/ru/setup#configure-release-channel). Дедублирует локальные файлы `CLAUDE.md` против проверенных, обрезает проверенные файлы [`CLAUDE.md`](/docs/ru/memory#my-claude-md-is-too-large) путём вырезания контента, который Claude может вывести из кодовой базы, и переносит оставшееся всегда загружаемое руководство в [skills](/docs/ru/skills) и вложенные файлы `CLAUDE.md`, которые загружаются по требованию. Также предлагает сделать [auto mode](/docs/ru/permissions#permission-modes) вашим по умолчанию и [предварительно одобрить](/docs/ru/permissions) часто отклоняемые команды только для чтения. Сообщает результаты в первую очередь и просит подтверждение перед изменением чего-либо. Из терминала `claude doctor` выводит диагностику установки только для чтения без запуска сеанса. Псевдоним: `/checkup`. Проверка обрезки `CLAUDE.md` требует Claude Code версии 2.1.206 или позже. До версии 2.1.205 `/doctor` открывал экран диагностики только для чтения и нажатие `f` отправляло отчёт Claude |

88| `/effort [level\|auto\|status]` | Установить [уровень усилий](/docs/ru/model-config#adjust-effort-level): `low` до `xhigh`, `max`, [`ultracode`](/docs/ru/workflows#let-claude-decide-with-ultracode), или `auto`; `status` выводит его. `max` и `ultracode` только для сеанса; ключ [`ultracode`](/docs/ru/settings-reference#ultracode) сохраняется. Запустите её во время ответа Claude и, после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code показывает его, Claude Code применяет новый уровень к следующему запросу в этом ходу. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сеансе, который не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), такой как на [стороннем поставщике](/docs/ru/third-party-integrations). Работает в `-p` вне [удержания усилий](/docs/ru/model-config#adjust-effort-level) |88| `/effort [level\|auto\|status]` | Установить [уровень усилий](/docs/ru/model-config#adjust-effort-level): `low` до `xhigh`, `max`, [`ultracode`](/docs/ru/workflows#let-claude-decide-with-ultracode), или `auto`; `status` выводит его. `max` и `ultracode` только для сеанса; ключ [`ultracode`](/docs/ru/settings-reference#ultracode) сохраняется. Запустите её во время ответа Claude и, после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code показывает его, Claude Code применяет новый уровень к следующему запросу в этом ходу. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сеансе, который не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), такой как на [стороннем поставщике](/docs/ru/third-party-integrations). Работает в `-p` |

89| `/exit` | Выйти из CLI. В прикреплённом [фоновом сеансе](/docs/ru/agent-view#attach-to-a-session) это отсоединяет и сеанс продолжает работать. Псевдоним: `/quit` |89| `/exit` | Выйти из CLI. В прикреплённом [фоновом сеансе](/docs/ru/agent-view#attach-to-a-session) это отсоединяет и сеанс продолжает работать. Псевдоним: `/quit` |

90| `/export [filename]` | Экспортировать текущий разговор как простой текст. С именем файла записывает напрямую в этот файл. Без него открывает диалог для копирования в буфер обмена или сохранения в файл |90| `/export [filename]` | Экспортировать текущий разговор как простой текст. С именем файла записывает напрямую в этот файл. Без него открывает диалог для копирования в буфер обмена или сохранения в файл |

91| `/fast [on\|off]` | Переключить [быстрый режим](/docs/ru/fast-mode) включен или выключен. Запустите её во время ответа Claude и Claude Code переключает быстрый режим без ожидания завершения хода, хотя текущий ход завершается с его исходной скоростью. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сеансе, который не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Доступность в неинтерактивном режиме с `-p` ограничена; см. [Переключить быстрый режим](/docs/ru/fast-mode#toggle-fast-mode). Требует Claude Code версии 2.1.205 или позже |91| `/fast [on\|off]` | Переключить [быстрый режим](/docs/ru/fast-mode) включен или выключен. Запустите её во время ответа Claude и Claude Code переключает быстрый режим без ожидания завершения хода, хотя текущий ход завершается с его исходной скоростью. До версии 2.1.242 Claude Code решал из флага функции, который он получал от Anthropic, запускать ли команду в середине хода или ставить её в очередь до завершения хода, и всегда ставил её в очередь в сеансе, который не [получает флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Доступность в неинтерактивном режиме с `-p` ограничена; см. [Переключить быстрый режим](/docs/ru/fast-mode#toggle-fast-mode). Требует Claude Code версии 2.1.205 или позже |

156| `/theme` | Изменить цветовую тему. Включает опцию `auto`, которая соответствует светлому или тёмному фону вашего терминала, светлые и тёмные варианты, доступные для дальтоников (далтонизированные) темы, ANSI темы, которые используют палитру цветов вашего терминала, и любые [пользовательские темы](/docs/ru/terminal-config#create-a-custom-theme) из `~/.claude/themes/` или плагинов. Выберите **New custom theme…** для создания одной |156| `/theme` | Изменить цветовую тему. Включает опцию `auto`, которая соответствует светлому или тёмному фону вашего терминала, светлые и тёмные варианты, доступные для дальтоников (далтонизированные) темы, ANSI темы, которые используют палитру цветов вашего терминала, и любые [пользовательские темы](/docs/ru/terminal-config#create-a-custom-theme) из `~/.claude/themes/` или плагинов. Выберите **New custom theme…** для создания одной |

157| `/tui [default\|fullscreen]` | Установить рендерер терминального UI и перезагрузиться в него с вашим разговором нетронутым. `fullscreen` включает [рендерер alt-screen без мерцания](/docs/ru/fullscreen). Без аргумента выводит активный рендерер |157| `/tui [default\|fullscreen]` | Установить рендерер терминального UI и перезагрузиться в него с вашим разговором нетронутым. `fullscreen` включает [рендерер alt-screen без мерцания](/docs/ru/fullscreen). Без аргумента выводит активный рендерер |

158| `/ultraplan <prompt>` | Удалено. Используйте [Plan Mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) вместо этого. Ранее отправляла задачу планирования в сеанс [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) для проверки в вашем браузере |158| `/ultraplan <prompt>` | Удалено. Используйте [Plan Mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) вместо этого. Ранее отправляла задачу планирования в сеанс [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) для проверки в вашем браузере |

159| `/ultrareview [PR or branch]` | Запустить глубокую, многоагентную проверку кода в облачной песочнице с [ultrareview](/docs/ru/ultrareview). Передайте ссылку PR для проверки этого pull request, или имя ветки для изменения базы сравнения. Предпочтительный вызов теперь `/code-review ultra`, и `/ultrareview` остаётся как псевдоним. Включает 3 бесплатных запуска на Pro и Max, затем требует [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |159| `/ultrareview [PR or branch]` | Запустить глубокую, многоагентную проверку кода в облачной песочнице с [ultrareview](/docs/ru/ultrareview). Передайте ссылку PR для проверки этого pull request, или имя ветки или коммита для изменения базы сравнения. Предпочтительный вызов — `/code-review ultra`, и `/ultrareview` — это псевдоним. Включает 3 бесплатных запуска на Pro и Max, затем требует [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

160| `/update-config [request]` | **[Skill](/docs/ru/skills#bundled-skills).** Опишите изменение параметров, такое как разрешение команды, установка переменной окружения или добавление [hook](/docs/ru/hooks), и Claude редактирует соответствующий файл [`settings.json`](/docs/ru/settings). Для опций, таких как тема и модель, используйте `/config` вместо этого |

160| `/upgrade` | Открыть страницу обновления в вашем браузере для переключения на более высокий уровень плана. Когда браузер не открывается, команда показывает подсказку входа без вывода URL |161| `/upgrade` | Открыть страницу обновления в вашем браузере для переключения на более высокий уровень плана. Когда браузер не открывается, команда показывает подсказку входа без вывода URL |

161| `/usage` | Показать стоимость сеанса, лимиты использования плана и статистику активности. На плане Pro, Max, Team или Enterprise, включает [разбор того, что считается против ваших лимитов плана](/docs/ru/costs#plan-usage-breakdown). `/cost` и `/stats` — псевдонимы |162| `/usage` | Показать стоимость сеанса, лимиты использования плана и статистику активности. На плане Pro, Max, Team или Enterprise, включает [разбор того, что считается против ваших лимитов плана](/docs/ru/costs#plan-usage-breakdown). `/cost` и `/stats` — псевдонимы |

162| `/usage-credits` | Настроить кредиты использования, или запросить их у вашего администратора, когда вы достигаете лимита. Открывает ваши [параметры биллинга кредитов использования](/docs/ru/costs#add-usage-credits-to-your-subscription) в браузере, кроме того, что члены Team и Enterprise без доступа к биллингу вместо этого отправляют запрос кредитов использования своему администратору из CLI, после подтверждения в диалоге, что запрос уведомляет их администраторов. Когда браузер не может открыть страницу биллинга, например через SSH, команда выводит URL для посещения вместо этого; это требует Claude Code версии 2.1.205 или позже, и более ранние версии ничего не показывали в этом случае. Ранее `/extra-usage` |163| `/usage-credits` | Настроить кредиты использования, или запросить их у вашего администратора, когда вы достигаете лимита. Открывает ваши [параметры биллинга кредитов использования](/docs/ru/costs#add-usage-credits-to-your-subscription) в браузере, кроме того, что члены Team и Enterprise без доступа к биллингу вместо этого отправляют запрос кредитов использования своему администратору из CLI, после подтверждения в диалоге, что запрос уведомляет их администраторов. Когда браузер не может открыть страницу биллинга, например через SSH, команда выводит URL для посещения вместо этого; это требует Claude Code версии 2.1.205 или позже, и более ранние версии ничего не показывали в этом случае. Ранее `/extra-usage` |

Details

102 📚 Quickstart · VS Code · Бесплатный курс на 1 час102 📚 Quickstart · VS Code · Бесплатный курс на 1 час

103 https://code.claude.com/docs/ru/quickstart103 https://code.claude.com/docs/ru/quickstart

104 https://code.claude.com/docs/ru/vs-code104 https://code.claude.com/docs/ru/vs-code

105 https://anthropic.skilljar.com/claude-code-in-action105 https://academy.claude.com/courses/claude-code-in-action

106 106 

107 Вопросы → в этой ветке. [Владелец] на точке.107 Вопросы → в этой ветке. [Владелец] на точке.

108 ```108 ```

229*Fable* — это самая229*Fable* — это самая

230способная модель для ваших самых сложных, долгоживущих задач; это не230способная модель для ваших самых сложных, долгоживущих задач; это не

231значение по умолчанию, поэтому выберите его с помощью `/model fable`, и обратите внимание, что содержимое кибербезопасности и231значение по умолчанию, поэтому выберите его с помощью `/model fable`, и обратите внимание, что содержимое кибербезопасности и

232биологии автоматически переходит на Opus. Opus 5 запускает свои собственные232биологии автоматически переходит на Opus. Opus 5.5 и Opus 5 запускают свои собственные

233проверки, поэтому отмеченное содержимое кибербезопасности переключает модели и отмеченное233проверки: отмеченное содержимое переключается на более ранний Opus, за исключением

234содержимое биологии отклоняется.234того, что отмеченное содержимое биологии на Opus 5 отклоняется.

235 235 

236*Попробуйте сейчас:* введите `/model` и выберите Sonnet, если вы еще этого не сделали. Это236*Попробуйте сейчас:* введите `/model` и выберите Sonnet, если вы еще этого не сделали. Это

237правильное значение по умолчанию для большинства задач.237правильное значение по умолчанию для большинства задач.

240```240```

241 241 

242| Модель | Лучше всего для |242| Модель | Лучше всего для |

243| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |243| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

244| Fable | Самые сложные, долгоживущие задачи. Только по выбору: выберите его с помощью `/model fable`. Содержимое кибербезопасности или биологии вызывает [автоматический переход на Opus](/docs/ru/model-config#automatic-model-fallback) |244| Fable | Самые сложные, долгоживущие задачи. Только по выбору: выберите его с помощью `/model fable`. Содержимое кибербезопасности или биологии вызывает [автоматический переход на Opus](/docs/ru/model-config#automatic-model-fallback) |

245| Opus | Крупномасштабные рефакторинги, сложная отладка, архитектурные решения, высокорисковые изменения. На Opus 5 содержимое кибербезопасности или биологии вызывает [автоматический переход или отказ](/docs/ru/model-config#automatic-model-fallback) |245| Opus | Крупномасштабные рефакторинги, сложная отладка, архитектурные решения, высокорисковые изменения. На Opus 5.5 и Opus 5 содержимое кибербезопасности или биологии вызывает [автоматический переход или отказ](/docs/ru/model-config#automatic-model-fallback) |

246| Sonnet | Повседневная работа с функциями, исправления ошибок, тесты, документация, обзор кода. Рекомендуемое значение по умолчанию. |246| Sonnet | Повседневная работа с функциями, исправления ошибок, тесты, документация, обзор кода. Рекомендуемое значение по умолчанию. |

247| Haiku | Быстрые вопросы, форматирование, механические правки, быстрая итерация |247| Haiku | Быстрые вопросы, форматирование, механические правки, быстрая итерация |

248 248 

Details

35 tokens: 280,35 tokens: 280,

36 color: '#6B6964',36 color: '#6B6964',

37 vis: 'hidden',37 vis: 'hidden',

38 desc: 'Working directory, platform, shell, OS version, and whether this is a git repo. Git branch, status, and recent commits load as a separate block at the very end of the system prompt.',38 desc: 'Working directory, platform, shell, OS version, and whether this is a git repo. Git branch, status, and recent commits load as a separate block.',

39 link: null39 link: null

40 }, {40 }, {

41 t: 0.08,41 t: 0.08,

1589* **Перед тем, как вы что-либо введёте**: CLAUDE.md, автоматическая память, имена инструментов MCP и описания skills загружаются в контекст. [Файлы AGENTS.md](/docs/ru/memory#agents-md) также могут загружаться, самостоятельно или вместе с CLAUDE.md. Ваша собственная настройка может добавить больше здесь, например [стиль вывода](/docs/ru/output-styles) или текст из [`--append-system-prompt`](/docs/ru/cli-reference).1589* **Перед тем, как вы что-либо введёте**: CLAUDE.md, автоматическая память, имена инструментов MCP и описания skills загружаются в контекст. [Файлы AGENTS.md](/docs/ru/memory#agents-md) также могут загружаться, самостоятельно или вместе с CLAUDE.md. Ваша собственная настройка может добавить больше здесь, например [стиль вывода](/docs/ru/output-styles) или текст из [`--append-system-prompt`](/docs/ru/cli-reference).

1590* **Во время работы Claude**: каждое чтение файла добавляется в контекст, [правила с областью действия пути](/docs/ru/memory#path-specific-rules) загружаются автоматически вместе с соответствующими файлами, и [hook PostToolUse](/docs/ru/hooks-guide) срабатывает после каждого редактирования.1590* **Во время работы Claude**: каждое чтение файла добавляется в контекст, [правила с областью действия пути](/docs/ru/memory#path-specific-rules) загружаются автоматически вместе с соответствующими файлами, и [hook PostToolUse](/docs/ru/hooks-guide) срабатывает после каждого редактирования.

1591* **Последующий prompt**: [subagent](/docs/ru/sub-agents) обрабатывает исследование в своём собственном отдельном контекстном окне, поэтому большие чтения файлов остаются вне вашего. Только резюме и небольшой трейлер метаданных возвращаются.1591* **Последующий prompt**: [subagent](/docs/ru/sub-agents) обрабатывает исследование в своём собственном отдельном контекстном окне, поэтому большие чтения файлов остаются вне вашего. Только резюме и небольшой трейлер метаданных возвращаются.

1592* **В конце**: `/compact` заменяет историю разговора структурированным резюме. Большая часть содержимого при запуске перезагружается автоматически; таблица ниже показывает, что происходит с каждым механизмом.1592* **В конце прохождения**: вы запускаете `/compact`, который заменяет историю разговора структурированным резюме. Большая часть содержимого при запуске перезагружается автоматически; таблица ниже показывает, что происходит с каждым механизмом.

1593 1593 

1594<h2 id="what-survives-compaction">1594<h2 id="what-survives-compaction">

1595 Что сохраняется при компактировании1595 Что сохраняется при компактировании

1602| Системный prompt и стиль вывода | Оба по-прежнему применяются |1602| Системный prompt и стиль вывода | Оба по-прежнему применяются |

1603| CLAUDE.md в корне проекта и правила без области действия | Переинжектированы с диска |1603| CLAUDE.md в корне проекта и правила без области действия | Переинжектированы с диска |

1604| Автоматическая память | Переинжектирована с диска |1604| Автоматическая память | Переинжектирована с диска |

1605| [Git status snapshot](/docs/ru/settings-reference#includegitinstructions) | Claude Code читает свежий снимок из вашего репозитория |

1605| План, который Claude написал в [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) | Переинжектирован с диска |1606| План, который Claude написал в [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) | Переинжектирован с диска |

1606| Правила с frontmatter `paths:` | Claude Code перезагружает их по мере чтения файлов, которые они соответствуют |1607| Правила с frontmatter `paths:` | Claude Code перезагружает их по мере чтения файлов, которые они соответствуют |

1607| Вложенный CLAUDE.md в подкаталогах | Claude Code перезагружает их по мере чтения файлов в этом подкаталоге |1608| Вложенный CLAUDE.md в подкаталогах | Claude Code перезагружает их по мере чтения файлов в этом подкаталоге |

costs.md +2 −2

Details

275 Выберите правильную модель275 Выберите правильную модель

276</h3>276</h3>

277 277 

278Sonnet хорошо справляется с большинством задач кодирования и стоит дешевле, чем Opus. Зарезервируйте Opus для сложных архитектурных решений или многошаговых рассуждений. Используйте `/model` для переключения моделей в середине сессии или установите значение по умолчанию в `/config`. Для простых задач subagent укажите `model: haiku` в вашей [конфигурации subagent](/docs/ru/sub-agents#choose-a-model).278Sonnet хорошо справляется с большинством задач кодирования и стоит дешевле, чем Opus. Зарезервируйте Opus для сложных архитектурных решений или многошаговых рассуждений. Используйте `/model` для переключения моделей в середине сессии или установите значение по умолчанию в `/config`. Переключение на Opus также применяется к [subagents, которые наследуют модель вашей сессии](/docs/ru/model-config#setting-your-model). Для простых задач subagent укажите `model: haiku` в вашей [конфигурации subagent](/docs/ru/sub-agents#choose-a-model).

279 279 

280<h3 id="reduce-mcp-server-overhead">280<h3 id="reduce-mcp-server-overhead">

281 Снижение накладных расходов MCP server281 Снижение накладных расходов MCP server

359 359 

360Расширенное мышление включено по умолчанию, потому что оно значительно улучшает производительность на сложных задачах планирования и рассуждения. Токены мышления выставляются как выходные токены, и бюджет по умолчанию может быть десятки тысяч токенов на запрос в зависимости от модели.360Расширенное мышление включено по умолчанию, потому что оно значительно улучшает производительность на сложных задачах планирования и рассуждения. Токены мышления выставляются как выходные токены, и бюджет по умолчанию может быть десятки тысяч токенов на запрос в зависимости от модели.

361 361 

362Для более простых задач, где глубокое рассуждение не требуется, вы можете снизить затраты, понизив [уровень усилий](/docs/ru/model-config#adjust-effort-level) с помощью `/effort` или в `/model`, или отключив мышление в `/config`. Вы не можете отключить мышление на Fable моделях, которые всегда используют расширенное мышление.362Для более простых задач, где глубокое рассуждение не требуется, вы можете снизить затраты, понизив [уровень усилий](/docs/ru/model-config#adjust-effort-level) с помощью `/effort` или в `/model`, или отключив мышление в `/config`. Вы не можете отключить мышление на Opus 5.5 или моделях Fable, которые всегда используют расширенное мышление.

363 363 

364На моделях с [фиксированным бюджетом мышления](/docs/ru/model-config#adaptive-reasoning-and-fixed-thinking-budgets), вы также можете понизить бюджет путём установки переменной окружения `MAX_THINKING_TOKENS` [environment variable](/docs/ru/env-vars), например `MAX_THINKING_TOKENS=8000`. Модели адаптивного рассуждения игнорируют ненулевые бюджеты, поэтому используйте вместо этого уровни усилий.364На моделях с [фиксированным бюджетом мышления](/docs/ru/model-config#adaptive-reasoning-and-fixed-thinking-budgets), вы также можете понизить бюджет путём установки переменной окружения `MAX_THINKING_TOKENS` [environment variable](/docs/ru/env-vars), например `MAX_THINKING_TOKENS=8000`. Модели адаптивного рассуждения игнорируют ненулевые бюджеты, поэтому используйте вместо этого уровни усилий.

365 365 

desktop.md +2 −2

Details

508 508 

509Вы можете ограничить плагины вашей учётной записью пользователя, конкретным проектом или только локально. Если ваша организация управляет плагинами централизованно, эти плагины доступны в сеансах desktop так же, как они есть в CLI.509Вы можете ограничить плагины вашей учётной записью пользователя, конкретным проектом или только локально. Если ваша организация управляет плагинами централизованно, эти плагины доступны в сеансах desktop так же, как они есть в CLI.

510 510 

511Браузер плагинов недоступен в облачных сеансах, и плагины, которые вы устанавливаете из приложения desktop, недоступны для облачных сеансов. Чтобы использовать плагин в облачном сеансе, либо объявите его в `.claude/settings.json` репозитория под [`enabledPlugins`](/docs/ru/settings-reference#enabledplugins), чтобы Claude Code [установил его при запуске сеанса](/docs/ru/cloud-environments#what-carries-over-from-your-setup), либо включите его для вашей учётной записи claude.ai, чтобы Claude Code загрузил его как [синхронизированный плагин](/docs/ru/plugins-reference#synced-plugins). Плагины недоступны в WSL сеансах. Для полного справочника плагинов, включая создание собственных плагинов, см. [plugins](/docs/ru/plugins).511Браузер плагинов недоступен в облачных сеансах, и плагины, которые вы устанавливаете из приложения desktop, недоступны для облачных сеансов. Облачный сеанс также не устанавливает плагины, которые объявляет `.claude/settings.json` репозитория, как описано в [Что переносится из вашей установки](/docs/ru/cloud-environments#what-carries-over-from-your-setup). Чтобы использовать плагин в облачном сеансе, включите его для вашей учётной записи claude.ai, чтобы Claude Code загрузил его как [синхронизированный плагин](/docs/ru/plugins-reference#synced-plugins). Плагины недоступны в WSL сеансах. Для полного справочника плагинов, включая создание собственных плагинов, см. [plugins](/docs/ru/plugins).

512 512 

513<h3 id="configure-preview-servers">513<h3 id="configure-preview-servers">

514 Конфигурация серверов предпросмотра514 Конфигурация серверов предпросмотра

735 735 

736Чтобы установить переменные окружения для локальных сеансов и dev-серверов на любой платформе, откройте раскрывающийся список окружения в поле подсказки, наведите курсор на **Local** и нажмите значок шестерёнки, чтобы открыть локальный редактор окружения. Переменные, которые вы сохраняете здесь, хранятся в зашифрованном виде на вашей машине и применяются к каждому локальному сеансу и серверу предпросмотра, который вы запускаете. Вы также можете добавить переменные к ключу `env` в вашем файле `~/.claude/settings.json`, хотя они достигают только сеансов Claude, а не dev-серверов. См. [переменные окружения](/docs/ru/env-vars) для полного списка поддерживаемых переменных.736Чтобы установить переменные окружения для локальных сеансов и dev-серверов на любой платформе, откройте раскрывающийся список окружения в поле подсказки, наведите курсор на **Local** и нажмите значок шестерёнки, чтобы открыть локальный редактор окружения. Переменные, которые вы сохраняете здесь, хранятся в зашифрованном виде на вашей машине и применяются к каждому локальному сеансу и серверу предпросмотра, который вы запускаете. Вы также можете добавить переменные к ключу `env` в вашем файле `~/.claude/settings.json`, хотя они достигают только сеансов Claude, а не dev-серверов. См. [переменные окружения](/docs/ru/env-vars) для полного списка поддерживаемых переменных.

737 737 

738[Extended thinking](/docs/ru/model-config#extended-thinking) включен по умолчанию, что улучшает производительность на сложных задачах рассуждения, но использует дополнительные токены. На API Anthropic установите `MAX_THINKING_TOKENS` на `0` в локальном редакторе окружения, чтобы отключить thinking; это не влияет на модели Fable, которые всегда используют extended thinking. С отключённым thinking на API Anthropic Claude Code отправляет effort `high` вместо более высокого уровня моделям, которые, как известно, [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.738[Extended thinking](/docs/ru/model-config#extended-thinking) включен по умолчанию, что улучшает производительность на сложных задачах рассуждения, но использует дополнительные токены. На API Anthropic установите `MAX_THINKING_TOKENS` на `0` в локальном редакторе окружения, чтобы отключить thinking; это не влияет на Opus 5.5 или модели Fable, которые всегда используют extended thinking. С отключённым thinking на API Anthropic Claude Code отправляет effort `high` вместо более высокого уровня моделям, которые, как известно, [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.

739 739 

740На моделях с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) значения `MAX_THINKING_TOKENS`, отличные от `0`, игнорируются, потому что адаптивное рассуждение контролирует глубину thinking вместо этого. На Opus 4.6 и Sonnet 4.6 установите `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` на `1`, чтобы использовать фиксированный бюджет thinking; модели Fable, Sonnet 5 и Opus 4.7 и более поздние версии всегда используют адаптивное рассуждение и не имеют режима фиксированного бюджета.740На моделях с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) значения `MAX_THINKING_TOKENS`, отличные от `0`, игнорируются, потому что адаптивное рассуждение контролирует глубину thinking вместо этого. На Opus 4.6 и Sonnet 4.6 установите `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` на `1`, чтобы использовать фиксированный бюджет thinking; модели Fable, Sonnet 5 и Opus 4.7 и более поздние версии всегда используют адаптивное рассуждение и не имеют режима фиксированного бюджета.

741 741 

Details

16 Требования16 Требования

17</h2>17</h2>

18 18 

19* Ubuntu 22.04 или более поздняя версия, или Debian 12 или более поздняя версия19* Дистрибутив на основе Debian: Ubuntu 22.04 или более поздняя версия, или Debian 12 или более поздняя версия

20* x86\_64 или arm6420* x86\_64 или arm64

21 21 

22Другие дистрибутивы на основе Debian, соответствующие этим требованиям, могут работать, но официально не тестируются. На дистрибутивах, которые не основаны на Debian, таких как Fedora или Arch, запустите [CLI](/docs/ru/setup#system-requirements) вместо этого. Если вы работаете на Windows с WSL 2, установите приложение Windows Desktop и запускайте сеансы внутри вашего дистрибутива; см. [Claude Code Desktop в WSL](/docs/ru/desktop-wsl).22Другие дистрибутивы на основе Debian, соответствующие этим требованиям, могут работать, но официально не тестируются. На дистрибутивах, которые не основаны на Debian, таких как Fedora или Arch, запустите [CLI](/docs/ru/setup#system-requirements) вместо этого. Если вы работаете на Windows с WSL 2, установите приложение Windows Desktop и запускайте сеансы внутри вашего дистрибутива; см. [Claude Code Desktop в WSL](/docs/ru/desktop-wsl).

Details

42/plugin install github@claude-plugins-official42/plugin install github@claude-plugins-official

43```43```

44 44 

45`/plugin` открывает интерактивную панель в терминале CLI. Если Claude сообщает, что `/plugin` недоступен в этой среде, используйте [браузер плагинов](/docs/ru/desktop#install-plugins) в приложении Claude для рабочего стола или объявите плагин в [`enabledPlugins`](/docs/ru/settings-reference#enabledplugins) в `.claude/settings.json` для облачных сеансов.45`/plugin` открывает интерактивную панель в терминале CLI. Если Claude сообщает, что `/plugin` недоступен в этой среде, установите плагин другим способом:

46 

47* **Приложение Claude для рабочего стола**: используйте [браузер плагинов](/docs/ru/desktop#install-plugins).

48* **Расширение VS Code**: установите из [диалога **Manage plugins**](/docs/ru/vs-code#manage-plugins).

49* **Облачные сеансы**: включите плагин для вашей учётной записи claude.ai, чтобы Claude Code загружал его как [синхронизированный плагин](/docs/ru/plugins-reference#synced-plugins).

46 50 

47Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:51Если установка не удалась, сопоставьте сообщение, которое сообщает Claude Code:

48 52 

323 327 

324В сеансах терминала, где [плагины синхронизируются с вашей учетной записью claude.ai](/docs/ru/plugins-reference#synced-plugins), claude.ai также может перечислять маркетплейсы для вас, такие как библиотека плагинов вашей организации и ваши собственные загрузки на claude.ai. `claude plugin marketplace list` выводит их в разделе `From claude.ai:`, и вкладка `/plugin` **Marketplaces** их отображает. Выберите один там, чтобы добавить его. Добавление маркетплейса из claude.ai требует Claude Code v2.1.273 или более поздней версии.328В сеансах терминала, где [плагины синхронизируются с вашей учетной записью claude.ai](/docs/ru/plugins-reference#synced-plugins), claude.ai также может перечислять маркетплейсы для вас, такие как библиотека плагинов вашей организации и ваши собственные загрузки на claude.ai. `claude plugin marketplace list` выводит их в разделе `From claude.ai:`, и вкладка `/plugin` **Marketplaces** их отображает. Выберите один там, чтобы добавить его. Добавление маркетплейса из claude.ai требует Claude Code v2.1.273 или более поздней версии.

325 329 

326Чтобы добавить его из вашей оболочки, запустите `claude plugin marketplace add` с флагом `--claudeai` и именем, показанным в списке:330Чтобы добавить маркетплейс из этого списка в вашей оболочке, запустите `claude plugin marketplace add` с флагом `--claudeai` и именем, показанным в списке:

327 331 

328```bash theme={null}332```bash theme={null}

329claude plugin marketplace add --claudeai claudeai-organization-library333claude plugin marketplace add --claudeai claudeai-organization-library

360Claude Code ищет плагин в своей локальной копии каталога маркетплейса. То, как вы назовёте плагин, контролирует, обновит ли Claude Code эту копию в первую очередь:364Claude Code ищет плагин в своей локальной копии каталога маркетплейса. То, как вы назовёте плагин, контролирует, обновит ли Claude Code эту копию в первую очередь:

361 365 

362* **С именем маркетплейса**: когда вы устанавливаете `plugin-name@marketplace-name`, в сеансе или с помощью `claude plugin install`, Claude Code обновляет этот маркетплейс перед поиском. Claude Code запускает обновление даже если вы отключили [автоматическое обновление](#configure-auto-updates) для маркетплейса или установили `DISABLE_AUTOUPDATER`. До версии 2.1.232 Claude Code не обновлял маркетплейс перед поиском. Claude Code пропускает это обновление, когда:366* **С именем маркетплейса**: когда вы устанавливаете `plugin-name@marketplace-name`, в сеансе или с помощью `claude plugin install`, Claude Code обновляет этот маркетплейс перед поиском. Claude Code запускает обновление даже если вы отключили [автоматическое обновление](#configure-auto-updates) для маркетплейса или установили `DISABLE_AUTOUPDATER`. До версии 2.1.232 Claude Code не обновлял маркетплейс перед поиском. Claude Code пропускает это обновление, когда:

363 * Маркетплейс не был [добавлен из GitHub, другого хоста Git или удалённого URL](#add-marketplaces).367 * Маркетплейс не был [добавлен из GitHub, другого хоста Git или удалённого URL](#add-marketplaces) или [claude.ai](#add-from-claude-ai).

364 * [Начальный каталог](/docs/ru/plugin-marketplaces#pre-populate-plugins-for-containers) предоставляет маркетплейс.368 * [Начальный каталог](/docs/ru/plugin-marketplaces#pre-populate-plugins-for-containers) предоставляет маркетплейс.

365 * Claude Code обновил маркетплейс в течение последних 30 секунд.369 * Claude Code обновил маркетплейс в течение последних 30 секунд.

366 * Вы установили [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars).370 * Вы установили [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars).

395 399 

396Источник принимает [те же формы, что и `/plugin marketplace add`](#add-marketplaces), такие как GitHub `owner/repo`, URL git или локальный путь, за исключением того, что он не может содержать пробелы. Укажите имя плагина без суффикса `@marketplace`.400Источник принимает [те же формы, что и `/plugin marketplace add`](#add-marketplaces), такие как GitHub `owner/repo`, URL git или локальный путь, за исключением того, что он не может содержать пробелы. Укажите имя плагина без суффикса `@marketplace`.

397 401 

398Если вы ещё не добавили этот маркетплейс, Claude Code показывает разрешённый источник и просит вас подтвердить перед добавлением. Отказ отменяет установку и ничего не добавляет. После добавления маркетплейса открываются детали плагина и вы выбираете [область установки](/docs/ru/settings#where-settings-live).402Claude Code показывает разрешённый источник и просит вас подтвердить перед добавлением маркетплейса. Отказ отменяет установку и ничего не добавляет. После добавления маркетплейса открываются детали плагина и вы выбираете [область установки](/docs/ru/settings#where-settings-live). Если источник совпадает с маркетплейсом, который вы уже добавили, Claude Code пропускает подтверждение и открывает детали плагина в этом маркетплейсе.

399 403 

400<h2 id="manage-installed-plugins">404<h2 id="manage-installed-plugins">

401 Управление установленными плагинами405 Управление установленными плагинами

env-vars.md +301 −297

Details

142</Note>142</Note>

143 143 

144| Переменная | Назначение |144| Переменная | Назначение |

145| :------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |145| :------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

146| `ANTHROPIC_API_KEY` | Ключ API отправляется как заголовок `X-Api-Key`. Если установлен, этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии. В интерактивном режиме вас просят одобрить ключ один раз перед тем, как он переопределит вашу подписку. Чтобы использовать вашу подписку, запустите `unset ANTHROPIC_API_KEY` |146| `ANTHROPIC_API_KEY` | Ключ API отправляется как заголовок `X-Api-Key`. Если установлен, этот ключ используется вместо вашей подписки Claude Pro, Max, Team или Enterprise, даже если вы вошли в систему. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии. В интерактивном режиме вам предлагается одобрить ключ один раз перед тем, как он переопределит вашу подписку. Чтобы использовать вашу подписку, запустите `unset ANTHROPIC_API_KEY` |

147| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (значение, которое вы установите здесь, будет дополнено префиксом `Bearer `) |147| `ANTHROPIC_AUTH_TOKEN` | Пользовательское значение для заголовка `Authorization` (значение, которое вы установите здесь, будет дополнено префиксом `Bearer `) |

148| `ANTHROPIC_AWS_API_KEY` | Ключ API рабочей области для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), созданный в консоли AWS. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |148| `ANTHROPIC_AWS_API_KEY` | Ключ API рабочей области для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), созданный в консоли AWS. Отправляется как `x-api-key` и имеет приоритет над AWS SigV4 |

149| `ANTHROPIC_AWS_BASE_URL` | Переопределить URL конечной точки [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{region}.api.aws`. Claude Code разрешает регион с [той же приоритетностью, что и на Amazon Bedrock](/docs/ru/amazon-bedrock#3-configure-claude-code) |149| `ANTHROPIC_AWS_BASE_URL` | Переопределить URL конечной точки [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Используйте для пользовательских регионов или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). По умолчанию `https://aws-external-anthropic.{region}.api.aws`. Claude Code разрешает регион с [той же приоритетностью, что и на Amazon Bedrock](/docs/ru/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | Требуется для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Отправляется в каждом запросе как заголовок `anthropic-workspace-id` |150| `ANTHROPIC_AWS_WORKSPACE_ID` | Требуется для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). Отправляется при каждом запросе как заголовок `anthropic-workspace-id` |

151| `ANTHROPIC_BASE_URL` | Переопределить конечную точку API для маршрутизации запросов через прокси или шлюз. Если установлено на хост, не являющийся первой стороной, [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен по умолчанию. Установите `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. Начиная с версии 2.1.196, [Remote Control](/docs/ru/remote-control#requirements) отключен, когда это указывает на хост, отличный от `api.anthropic.com`, что соответствует его поведению на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |151| `ANTHROPIC_BASE_URL` | Переопределить конечную точку API для маршрутизации запросов через прокси или шлюз. Если установлено на хост, не являющийся первой стороной, [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search) отключен по умолчанию. Установите `ENABLE_TOOL_SEARCH=true`, если ваш прокси пересылает блоки `tool_reference`. Начиная с версии 2.1.196, [Remote Control](/docs/ru/remote-control#requirements) отключен, когда это указывает на хост, отличный от `api.anthropic.com`, что соответствует его поведению на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock. Используйте для пользовательских конечных точек Amazon Bedrock или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Amazon Bedrock](/docs/ru/amazon-bedrock) |152| `ANTHROPIC_BEDROCK_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock. Используйте для пользовательских конечных точек Amazon Bedrock или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Amazon Bedrock](/docs/ru/amazon-bedrock) |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock Mantle. См. [Конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Переопределить URL конечной точки Amazon Bedrock Mantle. См. [Конечная точка Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Префикс профиля кросс-региональной логической обработки (`us`, `eu`, `apac`, `jp`, `au` или `global`) Claude Code пытается сначала вместо того, который получен из региона AWS. Игнорируется в регионах AWS GovCloud. Требует Claude Code версии 2.1.224 или позже. См. [Amazon Bedrock](/docs/ru/amazon-bedrock#cross-region-inference-profile-prefixes) |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Префикс профиля кросс-региональной логической обработки (`us`, `eu`, `apac`, `jp`, `au` или `global`) Claude Code пытается сначала вместо того, который получен из региона AWS. Игнорируется в регионах AWS GovCloud. Требует Claude Code версии 2.1.224 или позже. См. [Amazon Bedrock](/docs/ru/amazon-bedrock#cross-region-inference-profile-prefixes) |

155| `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) |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Уровень обслуживания](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) Amazon Bedrock (`default`, `flex` или `priority`). Отправляется как заголовок `X-Amzn-Bedrock-Service-Tier`. См. [Amazon Bedrock](/docs/ru/amazon-bedrock#service-tiers) |

156| `ANTHROPIC_BETAS` | Разделенный запятыми список дополнительных значений заголовка `anthropic-beta` для включения в запросы API. Claude Code уже отправляет необходимые ему бета-заголовки; используйте это для участия в [бета-версии Anthropic API](https://platform.claude.com/docs/en/api/beta-headers) перед тем, как Claude Code добавит встроенную поддержку. В отличие от флага [`--betas`](/docs/ru/cli-reference#cli-flags), который требует аутентификации с помощью ключа API, эта переменная работает со всеми методами аутентификации, включая подписку Claude.ai |156| `ANTHROPIC_BETAS` | Разделённый запятыми список дополнительных значений заголовка `anthropic-beta` для включения в запросы API. Claude Code уже отправляет необходимые ему бета-заголовки; используйте это для участия в [бета-версии Anthropic API](https://platform.claude.com/docs/en/api/beta-headers) перед тем, как Claude Code добавит встроенную поддержку. В отличие от флага [`--betas`](/docs/ru/cli-reference#cli-flags), который требует аутентификации с помощью ключа API, эта переменная работает со всеми методами аутентификации, включая подписку Claude.ai |

157| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки для добавления к запросам (формат `Name: Value`, разделенные новой строкой для нескольких заголовков). Если имя или значение содержит символ, который HTTP-заголовок не может нести, например фигурную кавычку или пробел нулевой ширины, запрос завершается с ошибкой, которая определяет пару по позиции. Требует Claude Code версии 2.1.227 или позже. [Invalid request header value](/docs/ru/errors#invalid-request-header-value) перечисляет точный набор символов и где выполняется проверка. Значение, которое устанавливает учетные данные, организацию или тенант, маршрутизацию или заголовок поведения API, такой как `Authorization` или `Host`, считается [параметром, требующим одобрения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog), когда управляемые на сервере параметры доставляют его. Из параметров проекта или локальных параметров такое значение следует [правилам для применения значений `env`](/docs/ru/settings-reference#when-claude-code-applies-env-values) |157| `ANTHROPIC_CUSTOM_HEADERS` | Пользовательские заголовки для добавления к запросам (формат `Name: Value`, разделённые новыми строками для нескольких заголовков). Если имя или значение содержит символ, который HTTP-заголовок не может нести, например фигурную кавычку или пробел нулевой ширины, запрос не выполняется с ошибкой, которая определяет пару по позиции. Требует Claude Code версии 2.1.227 или позже. [Invalid request header value](/docs/ru/errors#invalid-request-header-value) перечисляет точный набор символов и где выполняется проверка. Значение, которое устанавливает учётные данные, организацию или тенант, маршрутизацию или заголовок поведения API, такой как `Authorization` или `Host`, считается [параметром, требующим одобрения](/docs/ru/server-managed-settings#environment-variables-and-the-approval-dialog), когда управляемые на сервере параметры его доставляют. Из параметров проекта или локальных параметров такое значение следует [правилам для применения значений `env`](/docs/ru/settings-reference#when-claude-code-applies-env-values) |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели для добавления в качестве пользовательской записи в средство выбора `/model`. Используйте это, чтобы сделать нестандартную или специфичную для шлюза модель выбираемой без замены встроенных псевдонимов. См. [Конфигурация модели](/docs/ru/model-config#add-a-custom-model-option) |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID модели для добавления в качестве пользовательской записи в средство выбора `/model`. Используйте это, чтобы сделать нестандартную или специфичную для шлюза модель выбираемой без замены встроенных псевдонимов. См. [Конфигурация модели](/docs/ru/model-config#add-a-custom-model-option) |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Описание отображения для пользовательской записи модели в средстве выбора `/model`. По умолчанию `Custom model (<model-id>)`, если не установлено |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Описание отображения для пользовательской записи модели в средстве выбора `/model`. По умолчанию `Custom model (<model-id>)`, если не установлено |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Имя отображения для пользовательской записи модели в средстве выбора `/model`. Если не установлено, запись показывает имя модели, если Claude Code [распознает ID](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), и ID модели в противном случае |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Имя отображения для пользовательской записи модели в средстве выбора `/model`. Если не установлено, запись показывает имя модели, если Claude Code [распознаёт ID](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), и ID модели в противном случае |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает пользовательская модель, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает пользовательская модель, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID модели, на которую разрешается псевдоним `fable`, и ID, который Claude Code распознает как модель Fable для [автоматического переключения модели](/docs/ru/model-config#automatic-model-fallback) на сторонних поставщиков. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID модели, на которую разрешается псевдоним `fable`, и ID, который Claude Code распознаёт как модель Fable для [автоматического переключения модели](/docs/ru/model-config#automatic-model-fallback) на сторонних поставщиков. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Fable в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Fable model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Описание отображения для закреплённой модели Fable в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Fable model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Имя отображения для закрепленной модели Fable в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Имя отображения для закреплённой модели Fable в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознаёт закреплённый ID, и закреплённый ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Fable, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закреплённая модель Fable, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID модели, на которую разрешается псевдоним `haiku`, также используется для [фоновой функциональности](/docs/ru/costs#background-token-usage). См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID модели, на которую разрешается псевдоним `haiku`, также используется для [фоновой функциональности](/docs/ru/costs#background-token-usage). См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Haiku в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Haiku model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Описание отображения для закреплённой модели Haiku в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Haiku model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Имя отображения для закрепленной модели Haiku в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Имя отображения для закреплённой модели Haiku в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознаёт закреплённый ID, и закреплённый ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Haiku, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закреплённая модель Haiku, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

170| `ANTHROPIC_DEFAULT_MODEL` | Модель, на которой новые сеансы начинаются по умолчанию. Требует Claude Code версии 2.1.236 или позже. См. [Установить модель по умолчанию для новых сеансов](/docs/ru/model-config#set-a-default-model-for-new-sessions) |170| `ANTHROPIC_DEFAULT_MODEL` | Модель, на которой новые сеансы начинаются по умолчанию. Требует Claude Code версии 2.1.236 или позже. См. [Установить модель по умолчанию для новых сеансов](/docs/ru/model-config#set-a-default-model-for-new-sessions) |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID модели, на которую разрешается псевдоним `opus`, и которую использует `opusplan` во время активного режима Plan Mode. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID модели, на которую разрешается псевдоним `opus`, и которую использует `opusplan` во время активного Plan Mode. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Opus в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Opus model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Описание отображения для закреплённой модели Opus в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Opus model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Имя отображения для закрепленной модели Opus в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Имя отображения для закреплённой модели Opus в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознаёт закреплённый ID, и закреплённый ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Opus, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закреплённая модель Opus, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID модели, на которую разрешается псевдоним `sonnet`, и которую использует `opusplan`, когда режим Plan Mode не активен. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID модели, на которую разрешается псевдоним `sonnet`, и которую использует `opusplan`, когда Plan Mode не активен. См. [Конфигурация модели](/docs/ru/model-config#environment-variables) |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Описание отображения для закрепленной модели Sonnet в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Sonnet model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Описание отображения для закреплённой модели Sonnet в средстве выбора `/model`. Если не установлено, строка показывает описание по умолчанию, начинающееся с `Custom Sonnet model`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Имя отображения для закрепленной модели Sonnet в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознает закрепленный ID, и закрепленный ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Имя отображения для закреплённой модели Sonnet в средстве выбора `/model`. Если не установлено, строка показывает имя модели, если Claude Code распознаёт закреплённый ID, и закреплённый ID в противном случае. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Разделенный запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закрепленная модель Sonnet, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Разделённый запятыми список [возможностей](/docs/ru/model-config#customize-pinned-model-display-and-capabilities), которые поддерживает закреплённая модель Sonnet, например `effort,thinking`. См. [Конфигурация модели](/docs/ru/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_FEDERATION_RULE_ID` | ID правила федерации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Когда вы устанавливаете его вместе с `ANTHROPIC_ORGANIZATION_ID`, Claude Code выбирает учетные данные федерации, которые имеют приоритет над вашим учетным данным `/login`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |179| `ANTHROPIC_FEDERATION_RULE_ID` | ID правила федерации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Когда вы устанавливаете его вместе с `ANTHROPIC_ORGANIZATION_ID`, Claude Code выбирает учётные данные федерации, которые имеют приоритет над вашим учётным данным `/login`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |

180| `ANTHROPIC_FOUNDRY_API_KEY` | Ключ API для аутентификации Microsoft Foundry (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |180| `ANTHROPIC_FOUNDRY_API_KEY` | Ключ API для аутентификации Microsoft Foundry (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |

181| `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 версии 2.1.203 или позже |181| `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 версии 2.1.203 или позже |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | Полный базовый URL для ресурса Microsoft Foundry (например, `https://my-resource.services.ai.azure.com/anthropic`). Альтернатива `ANTHROPIC_FOUNDRY_RESOURCE` (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |182| `ANTHROPIC_FOUNDRY_BASE_URL` | Полный базовый URL для ресурса Microsoft Foundry (например, `https://my-resource.services.ai.azure.com/anthropic`). Альтернатива `ANTHROPIC_FOUNDRY_RESOURCE` (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Microsoft Foundry (например, `my-resource`). Требуется, если `ANTHROPIC_FOUNDRY_BASE_URL` не установлен (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Имя ресурса Microsoft Foundry (например, `my-resource`). Требуется, если `ANTHROPIC_FOUNDRY_BASE_URL` не установлен (см. [Microsoft Foundry](/docs/ru/microsoft-foundry)) |

184| `ANTHROPIC_MODEL` | Имя параметра модели для использования (см. [Конфигурация модели](/docs/ru/model-config#environment-variables)) |184| `ANTHROPIC_MODEL` | Имя параметра модели для использования (см. [Конфигурация модели](/docs/ru/model-config#environment-variables)) |

185| `ANTHROPIC_ORGANIZATION_ID` | ID организации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите его вместе с `ANTHROPIC_FEDERATION_RULE_ID`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |185| `ANTHROPIC_ORGANIZATION_ID` | ID организации для [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите его вместе с `ANTHROPIC_FEDERATION_RULE_ID`. См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |

186| `ANTHROPIC_PROFILE` | Имя профиля Anthropic для аутентификации, такой как созданный [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) или [входом в учетную запись Console без ключа API](/docs/ru/authentication#sign-in-without-an-api-key). См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |186| `ANTHROPIC_PROFILE` | Имя профиля Anthropic для аутентификации, такого как созданный [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) или [входом в учётную запись Console без ключа API](/docs/ru/authentication#sign-in-without-an-api-key). См. [приоритет аутентификации](/docs/ru/authentication#authentication-precedence) |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Имя [модели класса Haiku для фоновых задач](/docs/ru/costs) |187| `ANTHROPIC_SMALL_FAST_MODEL` | \[УСТАРЕЛО] Имя [модели класса Haiku для фоновых задач](/docs/ru/costs) |

188| `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 в противном случае запускает фоновые задачи на [модели Sonnet по умолчанию или основной модели](/docs/ru/amazon-bedrock#4-pin-model-versions) в регионе сеанса |188| `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 в противном случае запускает фоновые задачи на [модели Sonnet по умолчанию или основной модели](/docs/ru/amazon-bedrock#4-pin-model-versions) в регионе сеанса |

189| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Google Cloud's Agent Platform. Используйте для пользовательских конечных точек Google Cloud's Agent Platform или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |189| `ANTHROPIC_VERTEX_BASE_URL` | Переопределить URL конечной точки Google Cloud's Agent Platform. Используйте для пользовательских конечных точек Google Cloud's Agent Platform или при маршрутизации через [LLM gateway](/docs/ru/llm-gateway). См. [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP, на который адресованы запросы Google Cloud's Agent Platform. См. [Настройка учетных данных GCP](/docs/ru/google-vertex-ai#3-configure-gcp-credentials) |190| `ANTHROPIC_VERTEX_PROJECT_ID` | ID проекта GCP, на который адресованы запросы Google Cloud's Agent Platform. См. [Настройка учётных данных GCP](/docs/ru/google-vertex-ai#3-configure-gcp-credentials) |

191| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, на какую рабочую область ориентироваться |191| `ANTHROPIC_WORKSPACE_ID` | ID рабочей области для [федерации рабочей нагрузки](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Установите это, когда ваше правило федерации охватывает более одной рабочей области, чтобы обмен токенов знал, на какую рабочую область ориентироваться |

192| `API_FORCE_IDLE_TIMEOUT` | Переопределить таймаут простоя тела в 5 минут, который прерывает потоковый ответ модели, когда байты не поступают. Установите `0` для отключения таймаута, например, когда медленный [шлюз](/docs/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами, или `1` для его включения для каждого поставщика. Если не установлено, таймаут активен на поставщиках, отличных от прямого API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) работают независимо от него и прерывают длительную молчаливую паузу даже при установке `0` здесь |192| `API_FORCE_IDLE_TIMEOUT` | Переопределить таймаут простоя тела в 5 минут, который прерывает потоковый ответ модели, когда байты не поступают. Установите на `0`, чтобы отключить таймаут, например, когда медленный [шлюз](/docs/ru/llm-gateway) или локальная модель делает паузу дольше 5 минут между фрагментами, или `1`, чтобы держать его включённым для каждого поставщика. Если не установлено, таймаут активен на поставщиках, отличных от прямого API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). [Сторожи потока](/docs/ru/network-config#streaming-idle-watchdogs) работают независимо от него и прерывают длительную молчаливую паузу даже при установке `0` здесь |

193| `API_TIMEOUT_MS` | Таймаут для запросов API в миллисекундах (по умолчанию: 600000 или 10 минут; максимум: 2147483647). Увеличьте это при истечении времени ожидания запросов в медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |193| `API_TIMEOUT_MS` | Таймаут для запросов API в миллисекундах (по умолчанию: 600000 или 10 минут; максимум: 2147483647). Увеличьте это, когда запросы истекают на медленных сетях или при маршрутизации через прокси. Значения выше максимума переполняют базовый таймер и вызывают немедленный отказ запросов |

194| `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/)) |194| `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/)) |

195| `BASH_DEFAULT_TIMEOUT_MS` | Таймаут по умолчанию для долгоживущих команд bash (по умолчанию: 120000 или 2 минуты) |195| `BASH_DEFAULT_TIMEOUT_MS` | Таймаут по умолчанию для долгоживущих команд bash (по умолчанию: 120000 или 2 минуты) |

196| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов вывода bash, которое Claude Code читает обратно в результат команды (по умолчанию: 30000; максимум: 150000). Если вы установите параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars), Claude Code игнорирует эту переменную. См. [Ограничения вывода](/docs/ru/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Максимальное количество символов вывода bash, которое Claude Code читает обратно в результат команды (по умолчанию: 30000; максимум: 150000). Если вы установите параметр [`bashOutputMaxChars`](/docs/ru/settings-reference#bashoutputmaxchars), Claude Code игнорирует эту переменную. См. [Ограничения вывода](/docs/ru/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Максимальный таймаут, который модель может установить для долгоживущих команд bash (по умолчанию: 600000 или 10 минут). Эффективный потолок — это больший из этого и `BASH_DEFAULT_TIMEOUT_MS` |197| `BASH_MAX_TIMEOUT_MS` | Максимальный таймаут, который модель может установить для долгоживущих команд bash (по умолчанию: 600000 или 10 минут). Эффективный потолок — это больший из этого и `BASH_DEFAULT_TIMEOUT_MS` |

198| `BETA_TRACING_ENDPOINT` | Конечная точка OTLP для [детального бета-трассирования](/docs/ru/monitoring-usage#traces-beta): с `ENABLE_BETA_TRACING_DETAILED=1` логи и трассировки идут туда вместо настроенных экспортеров. Установите его в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |198| `BETA_TRACING_ENDPOINT` | Конечная точка OTLP для [детального бета-трассирования](/docs/ru/monitoring-usage#traces-beta): с `ENABLE_BETA_TRACING_DETAILED=1` логи и трассировки идут туда вместо настроенных экспортёров. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Установите `1` для принудительного [`claude --cloud`](/docs/ru/claude-code-on-the-web#send-local-repositories-without-github) для упаковки и загрузки вашего локального репозитория вместо клонирования из его удаленного источника |199| `CCR_FORCE_BUNDLE` | Установите на `1`, чтобы заставить [`claude --cloud`](/docs/ru/claude-code-on-the-web#send-local-repositories-without-github) упаковать и загрузить ваш локальный репозиторий вместо клонирования из его удалённого источника |

200| `CLAUDECODE` | Установите `1` в подпроцессах, которые порождает Claude Code (инструменты Bash и PowerShell, сеансы tmux, [hook](/docs/ru/hooks) команды, [строка состояния](/docs/ru/statusline) команды, подпроцессы [MCP server](/docs/ru/mcp) stdio). Расширения IDE также устанавливают это в своих интегрированных терминалах. Используйте для обнаружения, когда скрипт работает внутри подпроцесса, порожденного Claude Code. Чтобы проверить, был ли текущий процесс порожден непосредственно вызовом инструмента или hook, а не внутри сервера MCP stdio, который запустил Claude Code, используйте `CLAUDE_CODE_CHILD_SESSION` вместо этого |200| `CLAUDECODE` | Установите на `1` в подпроцессах, которые порождает Claude Code (инструменты Bash и PowerShell, сеансы tmux, команды [hook](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline), подпроцессы [MCP сервера](/docs/ru/mcp) stdio). Расширения IDE также устанавливают это в своих интегрированных терминалах. Используйте для обнаружения, когда скрипт работает внутри подпроцесса, порождённого Claude Code. Чтобы проверить, был ли текущий процесс порождён непосредственно вызовом инструмента или hook, а не внутри MCP сервера stdio, который запустил Claude Code, используйте `CLAUDE_CODE_CHILD_SESSION` вместо этого |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Сколько миллисекунд перед автопродолжением появляется обратный отсчет на экране на диалоговом окне [`AskUserQuestion`](/docs/ru/tools-reference) без ответа. По умолчанию `20000` (20 секунд), ограничено таймаутом автопродолжения. Не имеет эффекта, если автопродолжение отключено; см. параметр [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout) и `CLAUDE_AFK_TIMEOUT_MS`. Требует Claude Code версии 2.1.198 или позже |201| `CLAUDE_AFK_COUNTDOWN_MS` | Сколько миллисекунд перед автопродолжением появляется обратный отсчёт на экране в диалоговом окне [`AskUserQuestion`](/docs/ru/tools-reference) без ответа. По умолчанию `20000` (20 секунд), ограничено таймаутом автопродолжения. Не имеет эффекта, если автопродолжение отключено; см. параметр [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout) и `CLAUDE_AFK_TIMEOUT_MS`. Требует Claude Code версии 2.1.198 или позже |

202| `CLAUDE_AFK_TIMEOUT_MS` | Сколько миллисекунд времени простоя перед диалоговым окном [`AskUserQuestion`](/docs/ru/tools-reference) без ответа автопродолжается без вас. Автопродолжение отключено по умолчанию; включите его с помощью параметра [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout). Эта переменная является переопределением для демонстраций и автоматических тестов: при установке она имеет приоритет над этим параметром и включает автопродолжение даже при отсутствии параметра или `never`. Установка `0` не отключает таймаут; она закрывает диалоговое окно немедленно. В версиях 2.1.198 и 2.1.199 автопродолжение было включено по умолчанию с таймаутом `60000` (60 секунд). Требует Claude Code версии 2.1.198 или позже |202| `CLAUDE_AFK_TIMEOUT_MS` | Сколько миллисекунд времени простоя перед тем, как диалоговое окно [`AskUserQuestion`](/docs/ru/tools-reference) без ответа автоматически продолжится без вас. Автопродолжение отключено по умолчанию; включите его с помощью параметра [`askUserQuestionTimeout`](/docs/ru/settings-reference#askuserquestiontimeout). Эта переменная является переопределением для демонстраций и автоматизированных тестов: при установке она имеет приоритет над этим параметром и включает автопродолжение даже при отсутствии параметра или значении `never`. Установка `0` не отключает таймаут; она закрывает диалоговое окно немедленно. В версиях 2.1.198 и 2.1.199 автопродолжение было включено по умолчанию с таймаутом `60000` (60 секунд). Требует Claude Code версии 2.1.198 или позже |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Установите `1` для отключения всех встроенных типов [subagent](/docs/ru/sub-agents), таких как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно для пользователей SDK, которые хотят чистый лист. Это также удаляет `general-purpose`, subagent, который Claude Code запускает, когда вызов инструмента Agent опускает `subagent_type`. Такой вызов затем завершается с ошибкой [`subagent_type is required`](/docs/ru/errors#subagent-type-is-required) |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Установите на `1`, чтобы отключить все встроенные типы [подагентов](/docs/ru/sub-agents), такие как Explore и Plan. Применяется только в неинтерактивном режиме (флаг `-p`). Полезно для пользователей SDK, которые хотят чистый лист. Это также удаляет `general-purpose`, подагента, который Claude Code запускает, когда вызов инструмента Agent опускает `subagent_type`. Такой вызов затем не выполняется с [`subagent_type is required`](/docs/ru/errors#subagent-type-is-required) |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Установите `1` для пропуска префикса `mcp__<server>__` на именах инструментов из серверов MCP, созданных SDK. Инструменты используют свои исходные имена. Только использование SDK |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Установите на `1`, чтобы пропустить префикс `mcp__<server>__` на именах инструментов из MCP серверов, созданных SDK. Инструменты используют свои исходные имена. Только использование SDK |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Таймаут стагнации в миллисекундах для subagents. По умолчанию `600000` (10 минут); если вы повысите `CLAUDE_STREAM_IDLE_TIMEOUT_MS` при включенном сторожевом таймере потока, значение по умолчанию повысится вместе с ним, как описано в [Обработка медленных или зависших ответов API](/docs/ru/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Таймер сбрасывается при каждом событии потока прогресса; если прогресс не поступает в течение окна, Claude Code прерывает subagent и сообщает о стагнации родителю |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Таймаут стагнации в миллисекундах для подагентов. По умолчанию `600000` (10 минут); если вы повысите `CLAUDE_STREAM_IDLE_TIMEOUT_MS` при включённом стороже потока, по умолчанию он повысится вместе с ним, как описано в [Обработка медленных или зависших ответов API](/docs/ru/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Таймер сбрасывается при каждом событии потока прогресса; если прогресс не поступает в течение окна, Claude Code прерывает подагента и сообщает о стагнации родителю |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Установите процент (1-100) окна автокомпактирования, при котором срабатывает автокомпактирование. Используйте более низкие значения, такие как `50`, для более раннего компактирования; переменная не может повысить порог, поэтому значения выше процента по умолчанию игнорируются. Применяется только в сеансах, которые [компактируют перед пределом контекста модели](/docs/ru/model-config#context-window-and-auto-compaction). Применяется к основным разговорам и subagents |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Установите процент (1-100) окна автокомпактирования, при котором срабатывает автокомпактирование. Используйте более низкие значения, такие как `50`, для более раннего компактирования; переменная не может повысить порог, поэтому значения выше процента по умолчанию игнорируются. Применяется только в сеансах, которые [компактируют перед пределом контекста модели](/docs/ru/model-config#context-window-and-auto-compaction). Применяется к основным разговорам и подагентам |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Установите `1` для принудительного включения автоматического фонового выполнения долгоживущих задач агента. Если включено, subagents переводятся в фоновый режим после работы примерно две минуты. Также включает [автоматическое фоновое выполнение долгих вызовов инструментов MCP](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) в неинтерактивном режиме на Claude Code версии 2.1.212 или позже |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | Установите на `1`, чтобы принудительно включить автоматическое фоновое выполнение долгоживущих задач агента. Когда включено, подагенты перемещаются в фон после работы примерно две минуты. Также включает [автоматическое фоновое выполнение долгих вызовов инструментов MCP](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) в неинтерактивном режиме на Claude Code версии 2.1.212 или позже |

208| `CLAUDE_AX_PREPARK_MS` | В [режиме чтения с экрана](/docs/ru/accessibility#what-your-screen-reader-hears) сколько миллисекунд Claude Code ждет, с курсором в начале строки, перед тем как написать новую или измененную строку. По умолчанию `50`. Установите `0` для немедленной записи. Claude Code ограничивает ожидание `5000`. Требует Claude Code версии 2.1.233 или позже |208| `CLAUDE_AX_PREPARK_MS` | В [режиме чтения с экрана](/docs/ru/accessibility#what-your-screen-reader-hears) сколько миллисекунд Claude Code ждёт, с курсором в начале строки, перед тем как написать новую или изменённую строку. По умолчанию `50`. Установите `0` для немедленной записи. Claude Code ограничивает ожидание на `5000`. Требует Claude Code версии 2.1.233 или позже |

209| `CLAUDE_AX_SCREEN_READER` | Установите `1` для отображения вывода, удобного для чтения с экрана: плоский текст без декоративных границ или анимаций. Установите `0` для принудительного отключения режима чтения с экрана даже при `axScreenReader` [`true`](/docs/ru/settings-reference#axscreenreader). Флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеет приоритет. Требует Claude Code версии 2.1.181 или позже |209| `CLAUDE_AX_SCREEN_READER` | Установите на `1` для отображения, удобного для чтения с экрана: плоский текст без декоративных границ или анимаций. Установите на `0`, чтобы принудительно отключить режим чтения с экрана, даже если [`axScreenReader`](/docs/ru/settings-reference#axscreenreader) имеет значение `true`. Флаг [`--ax-screen-reader`](/docs/ru/cli-reference#cli-flags) имеет приоритет. Требует Claude Code версии 2.1.181 или позже |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | В [режиме чтения с экрана](/docs/ru/accessibility) сколько миллисекунд Claude Code удерживает первый рендер интерфейса после строки подтверждения запуска, чтобы ваш чтец с экрана мог полностью произнести строку перед тем, как новый вывод прервет ее. По умолчанию `3000`. Установите `0` для немедленного рендеринга. Claude Code ограничивает удержание `600000` (10 минут). Ваше первое нажатие клавиши завершает удержание раньше. Требует Claude Code версии 2.1.217 или позже |210| `CLAUDE_AX_STARTUP_QUIET_MS` | В [режиме чтения с экрана](/docs/ru/accessibility) сколько миллисекунд Claude Code удерживает первый рендер интерфейса после строки подтверждения запуска, чтобы ваш чтец с экрана мог полностью произнести строку перед тем, как новый вывод её прервёт. По умолчанию `3000`. Установите `0` для немедленного рендера. Claude Code ограничивает удержание на `600000` (10 минут). Ваше первое нажатие клавиши завершает удержание раньше. Требует Claude Code версии 2.1.217 или позже |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Вернуться в исходный рабочий каталог после каждой команды Bash или PowerShell в основном сеансе |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Вернуться в исходный рабочий каталог после каждой команды Bash или PowerShell в основном сеансе |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах для сторожевого таймера потока на уровне байтов; при установке он имеет приоритет над `CLAUDE_STREAM_IDLE_TIMEOUT_MS` для этого сторожевого таймера и оставляет сторожевой таймер на уровне событий без изменений. Claude Code зажимает эту переменную между 10 секундами и 30 минутами. Требует Claude Code версии 2.1.210 или позже |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах для сторожа простоя потока на уровне байтов; при установке он имеет приоритет над `CLAUDE_STREAM_IDLE_TIMEOUT_MS` для этого сторожа и оставляет сторожа на уровне событий без изменений. Claude Code зажимает эту переменную между 10 секундами и 30 минутами. Требует Claude Code версии 2.1.210 или позже |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | Путь к файлу, который внешний инструмент, такой как слушатель блокировки экрана, создает при разблокировке экрана и удаляет при его блокировке. Пока файл существует, Claude Code пропускает [мобильные push-уведомления Remote Control](/docs/ru/remote-control#mobile-push-notifications), поэтому вы перестаете получать push-уведомления при активном использовании компьютера. Когда файл отсутствует или нечитаем, уведомления отправляются как обычно. Claude Code проверяет файл один раз за событие, вызывающее push-уведомление, а не опрашивает его. Требует Claude Code версии 2.1.181 или позже |213| `CLAUDE_CLIENT_PRESENCE_FILE` | Путь к файлу, который внешний инструмент, такой как слушатель блокировки экрана, создаёт при разблокировке экрана и удаляет при его блокировке. Пока файл существует, Claude Code пропускает [мобильные push-уведомления Remote Control](/docs/ru/remote-control#mobile-push-notifications), поэтому вы перестаёте получать push-уведомления, пока активно используете компьютер. Когда файл отсутствует или нечитаем, уведомления отправляются как обычно. Claude Code проверяет файл один раз за событие, вызывающее push, а не опрашивает его. Требует Claude Code версии 2.1.181 или позже |

214| `CLAUDE_CODE_ACCESSIBILITY` | Установите `1` для сохранения видимого курсора собственного терминала и отключения индикатора курсора с инвертированным текстом. Позволяет увеличителям экрана, таким как macOS Zoom, отслеживать положение курсора |214| `CLAUDE_CODE_ACCESSIBILITY` | Установите на `1`, чтобы сохранить видимый собственный курсор терминала и отключить индикатор курсора с инвертированным текстом. Позволяет увеличителям экрана, таким как macOS Zoom, отслеживать положение курсора |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Установите `1` для загрузки файлов памяти из каталогов, указанных с помощью `--add-dir`. Загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md`. По умолчанию дополнительные каталоги не загружают файлы памяти |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Установите на `1`, чтобы загружать файлы памяти из каталогов, указанных с помощью `--add-dir`. Загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md`. По умолчанию дополнительные каталоги не загружают файлы памяти |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Установите `1` для перерисовки всего экрана на каждом кадре в [полноэкранном рендеринге](/docs/ru/fullscreen) вместо отправки добавочных обновлений. Используйте это, если полноэкранный режим показывает устаревшие или неправильно размещенные фрагменты текста. Claude Code включает это автоматически для фоновых сеансов и [представления агента](/docs/ru/agent-view) на Windows |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Установите на `1`, чтобы перерисовать весь экран при каждом кадре в [полноэкранном рендере](/docs/ru/fullscreen) вместо отправки добавочных обновлений. Используйте это, если полноэкранный режим показывает устаревшие или неправильно размещённые фрагменты текста. Claude Code включает это автоматически для фоновых сеансов и [представления агента](/docs/ru/agent-view) на Windows |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Установите `1` для отправки параметра [effort](/docs/ru/model-config#adjust-effort-level) с каждым запросом, даже когда Claude Code не распознает ID модели как поддерживающий effort. Используйте это при маршрутизации через [LLM gateway](/docs/ru/llm-gateway) или сторонний поставщик, который обслуживает модели под пользовательскими идентификаторами. Модели, которые отклоняют параметр effort в API, включая модели Claude 3, Sonnet 4.0 и 4.5, Opus 4.0 и 4.1 и Haiku 4.5, по-прежнему исключены, чтобы запросы не завершались с ошибкой |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Установите на `1`, чтобы отправлять параметр [effort](/docs/ru/model-config#adjust-effort-level) при каждом запросе, даже когда Claude Code не распознаёт ID модели как поддерживающий effort. Используйте это при маршрутизации через [LLM gateway](/docs/ru/llm-gateway) или сторонний поставщик, который обслуживает модели под пользовательскими идентификаторами. Модели, которые отклоняют параметр effort в API, включая модели Claude 3, Sonnet 4.0 и 4.5, Opus 4.0 и 4.1 и Haiku 4.5, по-прежнему исключены, чтобы запросы не не выполнялись |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Интервал в миллисекундах, при котором учетные данные должны быть обновлены (при использовании [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper)) |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Интервал в миллисекундах, при котором учётные данные должны быть обновлены (при использовании [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper)) |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Установите `0` для остановки Claude Code от автоматического открытия браузера при публикации нового [artifact](/docs/ru/artifacts#create-an-artifact) |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Установите на `0`, чтобы остановить Claude Code от автоматического открытия браузера при публикации нового [артефакта](/docs/ru/artifacts#create-an-artifact) |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Установите `0` для остановки чтения Claude и ответа на [комментарии к artifact](/docs/ru/artifacts#collect-comments-on-an-artifact). Не имеет эффекта, когда `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [отключил artifacts](/docs/ru/artifacts#availability). Требует Claude Code версии 2.1.221 или позже |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Установите на `0`, чтобы остановить Claude от чтения и ответа на [комментарии к артефакту](/docs/ru/artifacts#collect-comments-on-an-artifact). Не имеет эффекта, когда `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` [отключил артефакты](/docs/ru/artifacts#availability). Требует Claude Code версии 2.1.221 или позже |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Установите `0` для остановки Claude [самостоятельного ответа на комментарии, отправленные ему](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own). Требует Claude Code версии 2.1.228 или позже |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Установите на `0`, чтобы остановить Claude от [самостоятельного ответа на комментарии, отправленные ему](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own). Требует Claude Code версии 2.1.228 или позже |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Установите `0` для пропуска [блока атрибуции](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block), который содержит версию клиента и отпечаток подсказки, с начала системной подсказки. Кэширование при прямом подключении к API Anthropic не затронуто в любом случае. В некоторых прямых конфигурациях подключения Claude Code сохраняет блок в запросах классификатора [режима auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) даже при установке `0`. В [Блок атрибуции системной подсказки](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block) проверьте, какие подключения и учетные данные это охватывает. До версии 2.1.181 блок включал токен для каждого запроса на пользовательские базовые URL и подключения Microsoft Foundry, поэтому на этих версиях установите его на `0`, когда ваш LLM gateway кэширует на теле запроса или пересылает запросы сторонним поставщикам, или когда вы подключаетесь к Microsoft Foundry напрямую |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Установите на `0`, чтобы опустить [блок атрибуции](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block), который несёт версию клиента и отпечаток подсказки, из начала системной подсказки. Кэширование при прямом подключении к API Anthropic не затронуто в любом случае. В некоторых прямых установках Claude Code сохраняет блок на запросах классификатора [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) даже при установке `0`. В [Блок атрибуции системной подсказки](/docs/ru/llm-gateway-protocol#system-prompt-attribution-block) проверьте, какие подключения и учётные данные это охватывает. До версии 2.1.181 блок включал токен для каждого запроса на пользовательских базовых URL и подключениях Microsoft Foundry, поэтому на этих версиях установите его на `0`, когда ваш LLM gateway кэширует на теле запроса или пересылает запросы сторонним поставщикам, или когда вы подключаетесь к Microsoft Foundry напрямую |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Когда `CLAUDE_AUTO_BACKGROUND_TASKS` включен, секунды между напоминаниями Claude проверить [фоновые subagents](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которые все еще работают. Принимает простое целое число от `1` до `86400` только; любое другое значение или написание читается как неустановленное. Если не установлено, напоминаний о проверке нет. Требует Claude Code версии 2.1.248 или позже |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Когда `CLAUDE_AUTO_BACKGROUND_TASKS` включен, секунды между напоминаниями Claude проверить [фоновые подагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background), которые всё ещё работают. Принимает простое целое число от `1` до `86400` только; любое другое значение или написание читается как не установленное. Если не установлено, напоминаний о проверке нет. Требует Claude Code версии 2.1.248 или позже |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Установить [окно автокомпактирования](/docs/ru/model-config#set-the-auto-compact-window) в токенах, от `100000` до `1000000`. Принимает простое целое число, такое как `500000` только: значение, такое как `500k`, читается как `500` и зажимается до минимума 100K. Эффективное окно также ограничено окном контекста модели. Имеет приоритет над командой `/autocompact`, флагом `--autocompact` и параметром `autoCompactWindow`. Процент `used_percentage` в строке состояния всегда измеряется относительно полного окна контекста модели, поэтому после установки этой переменной этот процент больше не указывает, когда будет запущено компактирование |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Установить [окно автокомпактирования](/docs/ru/model-config#set-the-auto-compact-window) в токенах, от `100000` до `1000000`. Принимает простое целое число, такое как `500000` только: значение, такое как `500k`, читается как `500` и зажимается на минимум 100K. Эффективное окно также ограничено окном контекста модели. Имеет приоритет над командой `/autocompact`, флагом `--autocompact` и параметром `autoCompactWindow`. Процент `used_percentage` в строке состояния всегда измеряется относительно полного окна контекста модели, поэтому после установки этой переменной этот процент больше не указывает, когда будет запущено компактирование |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Переопределить автоматическое [подключение IDE](/docs/ru/vs-code). По умолчанию Claude Code подключается автоматически при запуске внутри интегрированного терминала поддерживаемой IDE. Установите `false` для предотвращения этого. Установите `true` для принудительной попытки подключения, когда автоопределение не работает, например, когда tmux скрывает родительский терминал. Имеет приоритет над глобальным параметром конфигурации [`autoConnectIde`](/docs/ru/settings-reference#autoconnectide) |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Переопределить автоматическое [подключение IDE](/docs/ru/vs-code). По умолчанию Claude Code подключается автоматически при запуске внутри интегрированного терминала поддерживаемой IDE. Установите на `false`, чтобы предотвратить это. Установите на `true`, чтобы принудительно попытаться подключиться, когда автоопределение не работает, например, когда tmux скрывает родительский терминал. Имеет приоритет над глобальным параметром конфигурации [`autoConnectIde`](/docs/ru/settings-reference#autoconnectide) |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Контролирует, просит ли Claude Code сервер [проверить действия режима auto](/docs/ru/permission-modes#server-side-classifier-review). Если не установлено, Claude Code просит сервер на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform on AWS, и когда вы указываете `ANTHROPIC_BASE_URL` на LLM gateway или прокси. Установите `0` для использования собственных запросов классификатора Claude Code вместо этого. Не читается при прямом подключении к API Anthropic. Требует Claude Code версии 2.1.271 или позже; запрос сервера по умолчанию требует версии 2.1.278 или позже |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Контролирует, просит ли Claude Code сервер [проверить действия автоматического режима](/docs/ru/permission-modes#server-side-classifier-review). Если не установлено, Claude Code просит сервер на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform on AWS, и когда вы указываете `ANTHROPIC_BASE_URL` на LLM gateway или прокси. Установите на `0`, чтобы использовать вместо этого собственные запросы классификатора Claude Code. Не читается при прямом подключении к API Anthropic. Требует Claude Code версии 2.1.271 или позже; запрос сервера по умолчанию требует версии 2.1.278 или позже |

227| `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`). Повысьте это, когда шаг в вашей цепочке законно требует больше времени, например вход на основе браузера через обертку, такую как `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 версии 2.1.207 или позже |227| `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`). Повысьте это, когда шаг в вашей цепочке законно нуждается в большем времени, например вход на основе браузера через обёртку, такую как `aws-vault`, с MFA. Применяется везде, где 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 версии 2.1.207 или позже |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Установите `0` для отключения [diff файлов, которые изменила команда Bash](/docs/ru/hooks#bash), или `1` для его записи в каждом режиме разрешений. Имеет приоритет над параметром [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled). Требует Claude Code версии 2.1.269 или позже |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Установите на `0`, чтобы отключить [diff файлов, которые изменились во время выполнения команды Bash](/docs/ru/hooks#bash), или `1`, чтобы записать его в каждом режиме разрешений. Имеет приоритет над параметром [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled). Требует Claude Code версии 2.1.269 или позже |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Установите `0` для того, чтобы неинтерактивный сеанс сообщал статус простоя своему хосту в конце каждого хода, даже если фоновая работа все еще выполняется. По умолчанию сеанс продолжает сообщать статус выполнения после конца хода, пока фоновая работа, такая как фоновый агент или [workflow](/docs/ru/workflows), все еще активна. Это предотвращает объявление хостом, который наблюдает статус, такой как список удаленных сеансов, что Claude ждет вашего ввода во время работы. Фоновые команды оболочки, такие как сервер разработки, не удерживают статус выполнения. Статус выполнения по умолчанию и отказ от `0` требуют Claude Code версии 2.1.269 или позже; на более ранних версиях установите `1` для удержания статуса выполнения |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Установите на `0`, чтобы неинтерактивный сеанс сообщал статус простоя своему хосту при каждом завершении хода, даже если фоновая работа всё ещё выполняется. По умолчанию сеанс продолжает сообщать статус выполнения после завершения хода, пока фоновая работа, такая как фоновый агент или запуск [workflow](/docs/ru/workflows), всё ещё активна. Это удерживает хост, который наблюдает статус, такой как список удалённых сеансов, от объявления, что Claude ждёт вашего ввода во время работы. Фоновые команды оболочки, такие как сервер разработки, не удерживают статус выполнения. Статус выполнения по умолчанию и отказ `0` требуют Claude Code версии 2.1.269 или позже; на более ранних версиях установите `1`, чтобы удержать статус выполнения |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Установите автоматически в подпроцессах инструмента Bash и [hook command](/docs/ru/hooks) пока сеанс имеет активное подключение [Remote Control](/docs/ru/remote-control), и удалено при завершении подключения. Значение — это ID сеанса в форме `session_`, тот же идентификатор, который появляется в URL `claude.ai/code` сеанса, поэтому скрипт может ссылаться обратно на сеанс, который его запустил. Требует Claude Code версии 2.1.199 или позже. В [облачных сеансах](/docs/ru/claude-code-on-the-web) читайте `CLAUDE_CODE_REMOTE_SESSION_ID` вместо этого |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Установите автоматически в подпроцессах инструмента Bash и [команды hook](/docs/ru/hooks) пока сеанс имеет активное подключение [Remote Control](/docs/ru/remote-control), и удалено при завершении подключения. Значение — это ID сеанса в форме `session_`, тот же идентификатор, который появляется в URL `claude.ai/code` сеанса, поэтому скрипт может ссылаться обратно на сеанс, который его запустил. Требует Claude Code версии 2.1.199 или позже. В [облачных сеансах](/docs/ru/claude-code-on-the-web) вместо этого читайте `CLAUDE_CODE_REMOTE_SESSION_ID` |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Установите `0` для чтения Claude Code байта `0x08`, также написанного `^H`, как простой Backspace, или `1` для чтения его как Ctrl+Backspace. Любое значение заменяет платформу по умолчанию. По умолчанию Claude Code читает его как Ctrl+Backspace на Windows, за исключением случаев, когда `TERM_PROGRAM` — это `mintty` или `TERM` — это `cygwin`, и как простой Backspace на macOS и Linux. Установите `0` в терминале Windows, где [Backspace удаляет целое слово](/docs/ru/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Установите на `0`, чтобы Claude Code читал байт `0x08`, также написанный `^H`, как простой Backspace, или `1`, чтобы читать его как Ctrl+Backspace. Любое значение заменяет платформу по умолчанию. По умолчанию Claude Code читает его как Ctrl+Backspace на Windows, за исключением случаев, когда `TERM_PROGRAM` — это `mintty` или `TERM` — это `cygwin`, и как простой Backspace на macOS и Linux. Установите `0` в терминале Windows, где [Backspace удаляет целое слово](/docs/ru/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

232| `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` |232| `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` |

233| `CLAUDE_CODE_CHILD_SESSION` | Установите `1` в подпроцессах, которые Claude Code порождает через инструменты Bash, PowerShell и Monitor, [hook](/docs/ru/hooks) команды и [status line](/docs/ru/statusline) команды. Не установлено для подпроцессов [MCP server](/docs/ru/mcp) stdio, которые долгоживущие и пережидают сеанс, который их порождает. В отличие от `CLAUDECODE`, это устанавливается только самим Claude Code при запуске подпроцесса, а не расширениями IDE, поэтому надежно отличает вложенный сеанс от верхнего уровня `claude`, запущенного в интегрированном терминале IDE. Вложенный интерактивный `claude` TUI, запущенный таким образом, автоматически исключается из `--resume`, `--continue`, истории стрелок вверх и списка `claude agents`. Неинтерактивные сеансы `claude -p` по-прежнему сохраняются. Установите `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` для переопределения этого исключения. Требует Claude Code версии 2.1.172 или позже |233| `CLAUDE_CODE_CHILD_SESSION` | Установите на `1` в подпроцессах, которые Claude Code порождает через инструменты Bash, PowerShell и Monitor, команды [hook](/docs/ru/hooks) и команды [строки состояния](/docs/ru/statusline). Не установлено для подпроцессов [MCP сервера](/docs/ru/mcp) stdio, которые долгоживущие и пережидают сеанс, который их порождает. В отличие от `CLAUDECODE`, это устанавливается только самим Claude Code при запуске подпроцесса, а не расширениями IDE, поэтому надёжно отличает вложенный сеанс от верхнего уровня `claude`, запущенного в интегрированном терминале IDE. Вложенный интерактивный TUI `claude`, запущенный таким образом, автоматически исключается из `--resume`, `--continue`, истории со стрелкой вверх и списка `claude agents`. Неинтерактивные сеансы `claude -p` по-прежнему сохраняются. Установите `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`, чтобы переопределить это исключение. Требует Claude Code версии 2.1.172 или позже |

234| `CLAUDE_CODE_CLIENT_CERT` | Путь к файлу сертификата клиента для аутентификации mTLS |234| `CLAUDE_CODE_CLIENT_CERT` | Путь к файлу сертификата клиента для аутентификации mTLS |

235| `CLAUDE_CODE_CLIENT_KEY` | Путь к файлу приватного ключа клиента для аутентификации mTLS |235| `CLAUDE_CODE_CLIENT_KEY` | Путь к файлу приватного ключа клиента для аутентификации mTLS |

236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Парольная фраза для зашифрованного CLAUDE\_CODE\_CLIENT\_KEY (опционально) |236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Парольная фраза для зашифрованного CLAUDE\_CODE\_CLIENT\_KEY (опционально) |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Удалено в версии 2.1.186 и теперь не работает. Ранее устанавливало отдельный таймаут для фазы подключения, TLS и заголовка ответа потокового запроса API. Используйте `API_TIMEOUT_MS` для таймаута для каждого запроса. Для фазы заголовка ответа потокового запроса см. `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Удалено в версии 2.1.186 и теперь не работает. Ранее устанавливало отдельный таймаут для фазы подключения, TLS и заголовка ответа потокового запроса API. Используйте `API_TIMEOUT_MS` для таймаута для каждого запроса. Для фазы заголовка ответа потокового запроса см. `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Переопределить путь файла журнала отладки. Несмотря на имя, это путь к файлу, а не каталог. Требует отдельного включения режима отладки через `--debug`, `/debug` или переменную окружения `DEBUG`: установка только этой переменной не включает логирование. Флаг [`--debug-file`](/docs/ru/cli-reference#cli-flags) делает оба сразу. По умолчанию `~/.claude/debug/<session-id>.txt` |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Переопределить путь файла журнала отладки. Несмотря на имя, это путь к файлу, а не каталог. Требует отдельного включения режима отладки через `--debug`, `/debug` или переменную окружения `DEBUG`: установка только этой переменной не включает логирование. Флаг [`--debug-file`](/docs/ru/cli-reference#cli-flags) делает оба сразу. По умолчанию `~/.claude/debug/<session-id>.txt` |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Минимальный уровень логирования, записываемый в файл журнала отладки. Значения: `verbose`, `debug` (по умолчанию), `info`, `warn`, `error`. Установите `verbose` для включения высокообъемной диагностики, такой как полный вывод команды строки состояния, или повысьте до `error` для уменьшения шума |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Минимальный уровень логирования, записываемый в файл журнала отладки. Значения: `verbose`, `debug` (по умолчанию), `info`, `warn`, `error`. Установите на `verbose`, чтобы включить высокообъёмную диагностику, такую как полный вывод команды строки состояния, или повысьте на `error`, чтобы уменьшить шум |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Установите `1` для отключения поддержки [окна контекста 1M](/docs/ru/model-config#extended-context). Если установлено, варианты модели 1M недоступны в средстве выбора модели, и Claude Code удерживает сеансы на моделях с собственным окном 1M, таких как [Sonnet 5](/docs/ru/model-config#sonnet-5-context-window) и модели Fable, до окна 200K; см. [Расширенный контекст](/docs/ru/model-config#extended-context) для того, как применяется удержание. Полезно для корпоративных сред с требованиями соответствия. Для его роли в исправлении окна для неузнанного ID модели `[1m]` см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Установите на `1`, чтобы отключить поддержку [окна контекста 1M](/docs/ru/model-config#extended-context). Если установлено, варианты модели 1M недоступны в средстве выбора модели, и Claude Code удерживает сеансы на моделях с собственным окном 1M, таких как [Sonnet 5](/docs/ru/model-config#sonnet-5-context-window) и модели Fable, на окне 200K; см. [Расширенный контекст](/docs/ru/model-config#extended-context) для того, как применяется удержание. Полезно для корпоративных сред с требованиями соответствия. Для его роли в исправлении окна для нераспознанного ID модели `[1m]` см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Установите `1` для отключения [адаптивного рассуждения](/docs/ru/model-config#adjust-effort-level) на Opus 4.6 и Sonnet 4.6 и возврата к фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. Не имеет эффекта на [модели Fable](/docs/ru/model-config#extended-thinking), Sonnet 5 или Opus 4.7 и позже, которые всегда используют адаптивное рассуждение |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Установите на `1`, чтобы отключить [адаптивное рассуждение](/docs/ru/model-config#adjust-effort-level) на Opus 4.6 и Sonnet 4.6 и вернуться к фиксированному бюджету мышления, контролируемому `MAX_THINKING_TOKENS`. Не имеет эффекта на [модели Fable](/docs/ru/model-config#extended-thinking), Sonnet 5 или Opus 4.7 и позже, которые всегда используют адаптивное рассуждение |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Установите `1` для остановки Claude Code от объединения [управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier) блоков `env` для каждого ключа по источникам администратора, поэтому применяется только весь блок `env` источника с наивысшим приоритетом, как до версии 2.1.223. Установите его в окружении, которое запускает Claude Code, так как Claude Code игнорирует копию, доставленную через блок параметров `env`. Требует Claude Code версии 2.1.223 или позже |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Установите на `1`, чтобы остановить Claude Code от объединения [управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier) блоков `env` для каждого ключа между источниками администратора, поэтому применяется только весь блок `env` источника с наивысшим приоритетом, как до версии 2.1.223. Установите это в окружении, которое запускает Claude Code, так как Claude Code игнорирует копию, доставленную через блок параметров `env`. Требует Claude Code версии 2.1.223 или позже |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Установите `1` для отключения [инструмента advisor](/docs/ru/advisor). Команда `/advisor` становится недоступной, любой настроенный `advisorModel` игнорируется, и флаг `--advisor` принимается, но не имеет эффекта, поэтому существующие скрипты, которые его передают, продолжают работать без ошибок |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Установите на `1`, чтобы отключить [инструмент советника](/docs/ru/advisor). Команда `/advisor` становится недоступной, любой настроенный `advisorModel` игнорируется, и флаг `--advisor` принимается, но не имеет эффекта, поэтому существующие скрипты, которые его передают, продолжают работать без ошибок |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Установите `1` для отключения [фоновых агентов и представления агента](/docs/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Эквивалентно параметру [`disableAgentView`](/docs/ru/settings-reference#disableagentview) |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Установите на `1`, чтобы отключить [фоновые агенты и представление агента](/docs/ru/agent-view): `claude agents`, `--bg`, `/background` и супервизор по требованию. Эквивалентно параметру [`disableAgentView`](/docs/ru/settings-reference#disableagentview) |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Установите `1` для отключения [полноэкранного рендеринга](/docs/ru/fullscreen) и использования классического рендерера основного экрана. Разговор остается в собственной прокрутке терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно. Имеет приоритет над `CLAUDE_CODE_NO_FLICKER` и параметром [`tui`](/docs/ru/settings-reference#tui). Вы также можете переключаться с помощью `/tui default`. Не применяется к фоновым сеансам, открытым из [представления агента](/docs/ru/agent-view), которые всегда используют полноэкранный рендеринг |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Установите на `1`, чтобы отключить [полноэкранный рендер](/docs/ru/fullscreen) и использовать классический рендер основного экрана. Разговор остаётся в собственной прокрутке вашего терминала, поэтому `Cmd+f` и режим копирования tmux работают как обычно. Имеет приоритет над `CLAUDE_CODE_NO_FLICKER` и параметром [`tui`](/docs/ru/settings-reference#tui). Вы также можете переключаться с помощью `/tui default`. Не применяется к фоновым сеансам, открытым из [представления агента](/docs/ru/agent-view), которые всегда используют полноэкранный рендер |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Установите `1` для отключения инструмента [Artifact](/docs/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. После установки этого параметра ни один файл параметров не включает инструмент обратно. Чтобы отключить инструмент из файла параметров, установите [`enableArtifact`](/docs/ru/settings-reference#enableartifact) на `false`; устаревший ключ [`disableArtifact`](/docs/ru/settings-reference#disableartifact) также отключает его |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | Установите на `1`, чтобы отключить инструмент [Artifact](/docs/ru/artifacts), который публикует вывод сеанса как приватную веб-страницу на claude.ai. После установки ни один файл параметров не включит инструмент обратно. Чтобы вместо этого отключить инструмент из файла параметров, установите [`enableArtifact`](/docs/ru/settings-reference#enableartifact) на `false`; устаревший ключ [`disableArtifact`](/docs/ru/settings-reference#disableartifact) также отключает его |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Установите `1` для отключения обработки вложений. Упоминания файлов с синтаксисом `@` отправляются как простой текст вместо расширения в содержимое файла |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Установите на `1`, чтобы отключить обработку вложений. Упоминания файлов с синтаксисом `@` отправляются как простой текст вместо расширения в содержимое файла |

248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Установите `1` для отключения [автоматической памяти](/docs/ru/memory#auto-memory). Установите `0` для принудительного включения автоматической памяти даже при режиме `--bare` или [`autoMemoryEnabled: false`](/docs/ru/settings-reference#automemoryenabled) иначе отключили бы его. Если отключено, Claude не создает и не загружает файлы автоматической памяти |248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Установите на `1`, чтобы отключить [автоматическую память](/docs/ru/memory#auto-memory). Установите на `0`, чтобы принудительно включить автоматическую память, даже если режим `--bare` или [`autoMemoryEnabled: false`](/docs/ru/settings-reference#automemoryenabled) в противном случае отключили бы её. Когда отключено, Claude не создаёт и не загружает файлы автоматической памяти |

249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Установите `1` для отключения всей функциональности фоновых задач, включая параметр `run_in_background` на инструментах Bash и subagent, автоматическое фоновое выполнение и сочетание клавиш Ctrl+B |249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Установите на `1`, чтобы отключить всю функциональность фоновых задач, включая параметр `run_in_background` на инструментах Bash и подагента, автофоновое выполнение и сочетание клавиш Ctrl+B |

250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Установите `1` для остановки Claude Code от обработки потокового ответа [Amazon Bedrock](/docs/ru/amazon-bedrock) с отсутствующим или пустым заголовком `Content-Type` как двоичного потока событий Amazon Bedrock. По умолчанию Claude Code предполагает, что шлюз удалил заголовок из иначе неизмененного ответа, поэтому он декодирует тело и потоковая передача продолжает работать. Установите это только для шлюза, который также повторно выдает поток как события, отправляемые сервером; Claude Code затем читает тело без заголовка как события, отправляемые сервером, вместо этого. Требует Claude Code версии 2.1.239 или позже |250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Установите на `1`, чтобы остановить Claude Code от обработки потокового ответа [Amazon Bedrock](/docs/ru/amazon-bedrock) с отсутствующим или пустым заголовком `Content-Type` как двоичного потока событий Amazon Bedrock. По умолчанию Claude Code предполагает, что шлюз удалил заголовок из иначе неизменённого ответа, поэтому он декодирует тело и потоковая передача продолжает работать. Установите это только для шлюза, который также повторно выдаёт поток как события, отправляемые сервером; Claude Code затем читает тело без заголовка как события, отправляемые сервером, вместо этого. Требует Claude Code версии 2.1.239 или позже |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Установите `1` для пропуска проверки того, что потоковый ответ [Amazon Bedrock](/docs/ru/amazon-bedrock) имеет тип содержимого `application/vnd.amazon.eventstream`. Без этой переменной, когда ответ имеет другой тип содержимого, Claude Code завершает запрос с ошибкой, называя этот тип, что означает [шлюз или прокси преобразует ответ](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Настройте шлюз для пересылки заголовка `Content-Type` и тела без изменений, а не устанавливайте эту переменную. Требует Claude Code версии 2.1.208 или позже |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Установите на `1`, чтобы пропустить проверку того, что потоковый ответ [Amazon Bedrock](/docs/ru/amazon-bedrock) несёт тип содержимого `application/vnd.amazon.eventstream`. Без этой переменной, когда ответ несёт другой тип содержимого, Claude Code не выполняет запрос с ошибкой, называющей этот тип, что означает [шлюз или прокси преобразует ответ](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Настройте шлюз для пересылки заголовка `Content-Type` и тела без изменений, а не устанавливайте эту переменную. Требует Claude Code версии 2.1.208 или позже |

252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Установите `1` для остановки [фонового сеанса](/docs/ru/agent-view) запущенных фоновых команд оболочки, динамических workflows, и, начиная с версии 2.1.198, фоновых subagents при остановке, перезагрузке или обновлении [супервизором](/docs/ru/agent-view#the-supervisor-process) процесса этого сеанса, вместо передачи их следующему процессу сеанса. Влияет только на эту передачу: фоновое выполнение сеанса с `←` или [`/background`](/docs/ru/agent-view#from-inside-a-session) по-прежнему переносит текущую работу, и `CLAUDE_DISABLE_ADOPT` отключает оба. Требует Claude Code версии 2.1.196 или позже |252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Установите на `1`, чтобы остановить запущенные фоновые команды оболочки [фонового сеанса](/docs/ru/agent-view), динамические workflows, и, начиная с версии 2.1.198, фоновые подагенты, когда [супервизор](/docs/ru/agent-view#the-supervisor-process) останавливает, перезапускает или обновляет процесс этого сеанса, вместо передачи их следующему процессу сеанса. Влияет только на эту передачу: фоновое выполнение сеанса с `←` или [`/background`](/docs/ru/agent-view#from-inside-a-session) по-прежнему переносит текущую работу, и `CLAUDE_DISABLE_ADOPT` отключает оба. Требует Claude Code версии 2.1.196 или позже |

253| `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 версии 2.1.193 или позже |253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Установите на `1`, чтобы остановить Claude Code от завершения [фоновых команд оболочки](/docs/ru/interactive-mode#background-bash-commands) под давлением памяти. По умолчанию на macOS и Linux Claude Code завершает фоновые оболочки, когда операционная система сообщает о критическом давлении памяти и сеанс был неактивен 30 минут без хода или запущенного подагента. Windows не имеет сигнала давления памяти, поэтому эта переменная не имеет эффекта там. Требует Claude Code версии 2.1.193 или позже |

254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Установите `1` для отключения [skills](/docs/ru/skills) и workflows, включенных в Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные команды, такие как `/init`, остаются типируемыми, но скрыты от модели. `/doctor` остается типируемым, как встроенные команды; скройте его с помощью `DISABLE_DOCTOR_COMMAND` вместо этого. Skills из плагинов, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно параметру [`disableBundledSkills`](/docs/ru/settings-reference#disablebundledskills) |254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Установите на `1`, чтобы отключить [skills](/docs/ru/skills) и workflows, включённые в Claude Code: встроенные skills и workflows полностью удаляются, в то время как встроенные команды, такие как `/init`, остаются типируемыми, но скрыты от модели. `/doctor` остаётся типируемым, как встроенные команды; скройте его с помощью `DISABLE_DOCTOR_COMMAND` вместо этого. Skills из плагинов, `.claude/skills/` и `.claude/commands/` не затронуты. Эквивалентно параметру [`disableBundledSkills`](/docs/ru/settings-reference#disablebundledskills) |

255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Установите `1` для сохранения доступности инструментов [Claude in Chrome](/docs/ru/chrome) при пропуске раздела Chrome системной подсказки и [bundled skill](/docs/ru/skills#bundled-skills) `/claude-in-chrome`. Для хостов, которые встраивают Claude Code и предоставляют свое собственное руководство браузера. Требует Claude Code версии 2.1.257 или позже |255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Установите на `1`, чтобы сохранить инструменты браузера [Claude in Chrome](/docs/ru/chrome) доступными, опуская раздел Chrome системной подсказки и `/claude-in-chrome` [встроенный skill](/docs/ru/skills#bundled-skills). Для хостов, которые встраивают Claude Code и предоставляют свои собственные рекомендации браузера. Требует Claude Code версии 2.1.257 или позже |

256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите `1` для предотвращения загрузки любых файлов памяти CLAUDE.md в контекст, включая файлы памяти пользователя, проекта и автоматической памяти |256| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Установите на `1`, чтобы предотвратить загрузку любых файлов памяти CLAUDE.md в контекст, включая файлы памяти пользователя, проекта и автоматической памяти |

257| `CLAUDE_CODE_DISABLE_CRON` | Установите `1` для отключения [запланированных задач](/docs/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными, и любые уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сеанса |257| `CLAUDE_CODE_DISABLE_CRON` | Установите на `1`, чтобы отключить [запланированные задачи](/docs/ru/scheduled-tasks). Skill `/loop` и инструменты cron становятся недоступными, и любые уже запланированные задачи перестают срабатывать, включая задачи, которые уже выполняются в середине сеанса |

258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите `1` для удаления заголовков запроса `anthropic-beta`, специфичных для Anthropic, и полей схемы инструмента бета-версии (таких как `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`. На Claude Code версии 2.1.227 или позже [управляемые параметры](/docs/ru/managed-settings) могут сохранить поиск инструментов включенным. [Отключить возможности предварительного выпуска](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает, где применяется переопределение |258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Установите на `1`, чтобы удалить заголовки запроса `anthropic-beta`, специфичные для Anthropic, и поля схемы инструмента бета-версии (такие как `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`. На Claude Code версии 2.1.227 или позже [управляемые параметры](/docs/ru/managed-settings) могут сохранить поиск инструментов включённым. [Отключить предварительные возможности](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает, где применяется переопределение |

259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Установите `1` для отключения встроенных [subagents Explore и Plan](/docs/ru/sub-agents#built-in-subagents). Claude исследует с помощью своих инструментов поиска или subagent общего назначения вместо этого, и [режим plan](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) читает файлы напрямую, а не запускает агентов Explore и Plan. Пользовательские subagents с именами `Explore` или `Plan` не затронуты. Чтобы удалить каждый встроенный тип subagent в Agent SDK или неинтерактивном режиме, используйте `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` вместо этого. Требует Claude Code версии 2.1.198 или позже |259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Установите на `1`, чтобы отключить встроенные [подагенты Explore и Plan](/docs/ru/sub-agents#built-in-subagents). Claude исследует с помощью своих инструментов поиска или подагента общего назначения вместо этого, и [режим плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) читает файлы напрямую, а не запускает агентов Explore и Plan. Пользовательские подагенты с именами `Explore` или `Plan` не затронуты. Чтобы удалить каждый встроенный тип подагента в Agent SDK или неинтерактивном режиме, используйте `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` вместо этого. Требует Claude Code версии 2.1.198 или позже |

260| `CLAUDE_CODE_DISABLE_FAST_MODE` | Установите `1` для отключения [fast mode](/docs/ru/fast-mode) |260| `CLAUDE_CODE_DISABLE_FAST_MODE` | Установите на `1`, чтобы отключить [быстрый режим](/docs/ru/fast-mode) |

261| `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-reference#feedbacksurveyrate). См. [Опросы качества сеанса](/docs/ru/data-usage#session-quality-surveys) |261| `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-reference#feedbacksurveyrate). См. [Опросы качества сеанса](/docs/ru/data-usage#session-quality-surveys) |

262| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите `1` для отключения файла [checkpointing](/docs/ru/checkpointing). Команда `/rewind` не сможет восстановить изменения кода. Переопределяет параметр [`fileCheckpointingEnabled`](/docs/ru/settings-reference#filecheckpointingenabled) |262| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Установите на `1`, чтобы отключить файл [checkpointing](/docs/ru/checkpointing). Команда `/rewind` не сможет восстановить изменения кода. Переопределяет параметр [`fileCheckpointingEnabled`](/docs/ru/settings-reference#filecheckpointingenabled) |

263| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите `1` для удаления встроенных инструкций рабочего процесса commit и PR и снимка статуса git из системной подсказки Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) при установке |263| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Установите на `1`, чтобы удалить встроенные инструкции рабочего процесса commit и PR и снимок статуса git из системной подсказки Claude. Полезно при использовании собственных skills рабочего процесса git. Имеет приоритет над параметром [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) при установке |

264| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите `1` для предотвращения автоматического переназначения Opus 4.0 и 4.1 на текущую версию Opus на API Anthropic. Используйте, когда вы намеренно хотите закрепить более старую модель. Переназначение не выполняется на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |264| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Установите на `1`, чтобы предотвратить автоматическое переотображение Opus 4.0 и 4.1 на текущую версию Opus на API Anthropic. Используйте, когда вы намеренно хотите закрепить более старую модель. Переотображение не выполняется на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry |

265| `CLAUDE_CODE_DISABLE_MOUSE` | Установите `1` для отключения отслеживания мыши в [полноэкранном рендеринге](/docs/ru/fullscreen). Прокрутка с клавиатуры с помощью `PgUp` и `PgDn` по-прежнему работает. Используйте это для сохранения поведения выделения при копировании собственного терминала |265| `CLAUDE_CODE_DISABLE_MOUSE` | Установите на `1`, чтобы отключить отслеживание мыши в [полноэкранном рендере](/docs/ru/fullscreen). Прокрутка клавиатуры с `PgUp` и `PgDn` по-прежнему работает. Используйте это, чтобы сохранить собственное поведение копирования при выборе вашего терминала |

266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Установите `1` для отключения обработки щелчков, перетаскивания и наведения в [полноэкранном рендеринге](/docs/ru/fullscreen) при сохранении прокрутки колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет при установке обоих. Требует Claude Code версии 2.1.195 или позже |266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Установите на `1`, чтобы отключить обработку щелчков, перетаскивания и наведения в [полноэкранном рендере](/docs/ru/fullscreen), сохраняя прокрутку колеса мыши. Используйте это, когда вы хотите, чтобы прокрутка колеса работала внутри Claude Code, но не хотите, чтобы щелчки позиционировали курсор, расширяли вывод инструмента или открывали ссылки. `CLAUDE_CODE_DISABLE_MOUSE` имеет приоритет при установке обоих. Требует Claude Code версии 2.1.195 или позже |

267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Установите `1` для остановки Claude Code от повторного чтения [сертификата и ключа клиента mTLS](/docs/ru/network-config#mtls-authentication) при завершении запроса API с ошибкой на уровне подключения, такой как сброс подключения или ошибка TLS handshake. С отключенной перезагрузкой Claude Code загружает повернутые файлы только при следующем применении параметров или при следующем запуске. Требует Claude Code версии 2.1.232 или позже |267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Установите на `1`, чтобы остановить Claude Code от повторного чтения [сертификата и ключа клиента mTLS](/docs/ru/network-config#mtls-authentication) при отказе запроса API с ошибкой на уровне подключения, такой как сброс подключения или ошибка TLS handshake. С отключённой перезагрузкой Claude Code загружает повёрнутые файлы только при следующем применении параметров или при следующем запуске. Требует Claude Code версии 2.1.232 или позже |

268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Установите на любое непустое значение, такое как `1`, для отключения несущественного сетевого трафика: автоматические обновления, телеметрия, отчеты об ошибках, команда `/feedback`, [обратная связь, составленная Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), примечания к выпуску, проверки [значка статуса PR и MR](/docs/ru/interactive-mode#pr-review-status) и проверки доступности, такие как проверка [fast mode](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Это также останавливает [фоновые запуски источников команд плагина](/docs/ru/plugin-marketplaces#when-claude-code-re-runs-the-command), которые являются локальными командами, а не сетевым трафиком, потому что они могут вызвать установку зависимостей. **Установка его на `0` или `false` по-прежнему отключает этот трафик**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы разрешить это снова. Также отключает получение флагов функций, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, требующие получения флагов функций](#features-that-need-feature-flag-fetching) недоступными. Автоустановка официального рынка плагинов не охватывается; отключите ее с помощью `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Не влияет на [обнаружение модели шлюза](/docs/ru/llm-gateway-connect#add-gateway-models-to-the-model-picker), которое имеет свой собственный opt-in |268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Установите на любое непустое значение, такое как `1`, чтобы отключить несущественный сетевой трафик: автообновления, телеметрию, отчёты об ошибках, команду `/feedback`, [отзывы, составленные Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), примечания к выпуску, проверки [значка статуса PR и MR](/docs/ru/interactive-mode#pr-review-status) и проверки доступности, такие как проверка [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Это также останавливает [фоновые запуски источников команд плагина](/docs/ru/plugin-marketplaces#when-claude-code-re-runs-the-command), которые являются локальными командами, а не сетевым трафиком, потому что они могут вызвать установку зависимостей. **Установка на `0` или `false` по-прежнему отключает этот трафик**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы разрешить её снова. Также отключает получение флагов функций, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, которые нуждаются в получении флагов функций](#features-that-need-feature-flag-fetching) недоступными. Автоустановка официального рынка плагинов не охватывается; отключите её с помощью `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Не влияет на [обнаружение модели шлюза](/docs/ru/llm-gateway-connect#add-gateway-models-to-the-model-picker), которое имеет свой собственный opt-in |

269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Установите `1` для отключения резервного варианта без потоковой передачи при сбое потокового запроса в середине потока. Ошибки потоковой передачи распространяются на уровень повтора вместо этого. Полезно, когда прокси или шлюз вызывает резервный вариант для создания дублирующегося выполнения инструмента |269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Установите на `1`, чтобы отключить резервный вариант без потока, когда потоковый запрос не выполняется в середине потока. Ошибки потока распространяются на уровень повтора вместо этого. Полезно, когда прокси или шлюз вызывает резервный вариант для создания дублирующегося выполнения инструмента |

270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Установите `1` для отправки уведомления рабочего стола инструмента `PushNotification` даже при вводе текста в терминал или его фокусировке. По умолчанию инструмент пропускает как уведомление рабочего стола, так и [мобильный push](/docs/ru/remote-control#mobile-push-notifications) при обнаружении недавней активности клавиатуры или фокуса терминала. Эта переменная отключает только эту локальную проверку, поэтому сервер все еще может подавить мобильный push при обнаружении вашей активности. Требует Claude Code версии 2.1.193 или позже |270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Установите на `1`, чтобы отправить уведомление рабочего стола инструмента `PushNotification` даже во время ввода текста в терминал или его фокусировки. По умолчанию инструмент пропускает как уведомление рабочего стола, так и [мобильный push](/docs/ru/remote-control#mobile-push-notifications), когда обнаруживает недавнюю активность клавиатуры или фокус терминала. Эта переменная отключает только эту локальную проверку, поэтому сервер по-прежнему может подавить мобильный push, когда обнаруживает, что вы активны. Требует Claude Code версии 2.1.193 или позже |

271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Установите `1` для отключения автоматической регистрации официального рынка плагинов. Claude Code читает переменную, когда собирается зарегистрировать рынок, обычно при первом интерактивном запуске машины. Если переменная установлена в этот момент, Claude Code постоянно пропускает регистрацию. Отмена установки переменной позже не отменяет пропуск. Запустите `claude plugin marketplace add anthropics/claude-plugins-official` для регистрации рынка в любое время |271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Установите на `1`, чтобы отключить автоматическую регистрацию официального рынка плагинов. Claude Code читает переменную, когда собирается зарегистрировать рынок, обычно при первом интерактивном запуске машины. Если переменная установлена в этот момент, Claude Code постоянно пропускает регистрацию. Отмена установки переменной позже не отменяет пропуск. Запустите `claude plugin marketplace add anthropics/claude-plugins-official` для регистрации рынка в любое время |

272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Установите `1` для остановки Claude Code от запуска ваших [`Notification` hooks для неотвеченных запросов разрешений](/docs/ru/hooks#notification) в сеансах, где Claude Code отправляет их обратному вызову `canUseTool` Agent SDK, что является тем, как Claude Desktop и расширение VS Code размещают Claude Code. Не имеет эффекта в сеансах терминала. Требует Claude Code версии 2.1.233 или позже |272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Установите на `1`, чтобы остановить Claude Code от запуска ваших [hooks Notification для неотвеченных запросов разрешений](/docs/ru/hooks#notification) в сеансах, где Claude Code отправляет их обратному вызову `canUseTool` Agent SDK, что является тем, как Claude Desktop и расширение VS Code размещают Claude Code. Не имеет эффекта в сеансах терминала. Требует Claude Code версии 2.1.233 или позже |

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Установите `1` для пропуска загрузки skills из системного каталога управляемых skills. Полезно для контейнерных или CI сеансов, которые не должны загружать skills, предоставленные оператором |273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Установите на `1`, чтобы пропустить загрузку skills из системного каталога управляемых skills. Полезно для сеансов контейнера или CI, которые не должны загружать skills, предоставленные оператором |

274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Установите `1` для отключения автоматических обновлений заголовка терминала на основе контекста разговора. В сеансах Agent SDK и `claude -p` это также пропускает фоновый запрос модели small/fast для создания заголовка сеанса |274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Установите на `1`, чтобы отключить автоматические обновления заголовка терминала на основе контекста разговора. Это также пропускает фоновый запрос модели small/fast для [создания заголовка сеанса](/docs/ru/sessions#name-your-sessions) |

275| `CLAUDE_CODE_DISABLE_THINKING` | Установите `1` для полного пропуска параметра `thinking` из запросов API. Это опция совместимости для прокси и шлюзов, которые отклоняют параметр. На моделях, которые думают по умолчанию, пропуск параметра означает, что модель все еще может думать. Чтобы явно отключить [расширенное мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) на API Anthropic, используйте `MAX_THINKING_TOKENS=0` вместо этого. Ни одна переменная не отключает мышление на моделях Fable, которые не могут иметь отключенное мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `MAX_THINKING_TOKENS=0` аналогично пропускает параметр, поэтому две переменные ведут себя одинаково там |275| `CLAUDE_CODE_DISABLE_THINKING` | Установите на `1`, чтобы полностью опустить параметр `thinking` из запросов API. Это вариант совместимости для прокси и шлюзов, которые отклоняют параметр. На моделях, которые думают по умолчанию, опущение параметра означает, что модель может всё ещё думать. Чтобы явно отключить [расширенное мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) на API Anthropic, используйте `MAX_THINKING_TOKENS=0` вместо этого. Ни одна переменная не отключает мышление на моделях Fable, которые не могут иметь отключённое мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `MAX_THINKING_TOKENS=0` аналогично опускает параметр, поэтому две переменные ведут себя одинаково там |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Установите `1` для пропуска проактивного [автокомпактирования](/docs/ru/costs#reduce-token-usage) когда Claude Code не распознает ID модели, такой как [LLM gateway](/docs/ru/llm-gateway) псевдоним. Без этой переменной Claude Code компактирует в окне контекста, которое он предполагает для ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` может исправить предполагаемое окно вместо этого; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) для того, когда каждая переменная применяется. Требует Claude Code версии 2.1.223 или позже |276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Установите на `1`, чтобы пропустить проактивное [автокомпактирование](/docs/ru/costs#reduce-token-usage) когда Claude Code не распознаёт ID модели, такой как [LLM gateway](/docs/ru/llm-gateway) псевдоним. Без этой переменной Claude Code компактирует при окне контекста, которое он предполагает для ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` может вместо этого исправить предполагаемое окно; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) для того, когда каждая переменная применяется. Требует Claude Code версии 2.1.223 или позже |

277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите `1` для отключения виртуальной прокрутки в [полноэкранном рендеринге](/docs/ru/fullscreen) и рендеринга каждого сообщения в стенограмме. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появляться сообщения |277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Установите на `1`, чтобы отключить виртуальную прокрутку в [полноэкранном рендере](/docs/ru/fullscreen) и отобразить каждое сообщение в стенограмме. Используйте это, если прокрутка в полноэкранном режиме показывает пустые области, где должны появиться сообщения |

278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Установите `1` для запуска команд [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool) на Windows напрямую вместо использования средства запуска `cmd.exe`. По умолчанию средство запуска позволяет команде PowerShell [работающей в фоновом режиме](/docs/ru/tools-reference#background-commands) [переносить в процесс следующего сеанса](/docs/ru/agent-view#the-supervisor-process), например, когда вы [фоновый сеанс](/docs/ru/agent-view#from-inside-a-session). Если вы установите переменную, фоновая команда PowerShell останавливается при выходе процесса сеанса. Команды Bash не затронуты. Требует Claude Code версии 2.1.269 или позже |278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Установите на `1`, чтобы запустить команды [инструмента PowerShell](/docs/ru/tools-reference#powershell-tool) на Windows напрямую вместо использования средства запуска `cmd.exe`. По умолчанию средство запуска позволяет команде PowerShell [работающей в фоне](/docs/ru/tools-reference#background-commands) [переносить на процесс следующего сеанса](/docs/ru/agent-view#the-supervisor-process), например, когда вы [фоновый сеанс](/docs/ru/agent-view#from-inside-a-session). Если вы установите переменную, фоновая команда PowerShell останавливается при выходе процесса сеанса. Команды Bash не затронуты. Требует Claude Code версии 2.1.269 или позже |

279| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите `1` для отключения [workflows](/docs/ru/workflows#turn-workflows-off). Эквивалентно параметру [`disableWorkflows`](/docs/ru/settings-reference#disableworkflows) |279| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Установите на `1`, чтобы отключить [workflows](/docs/ru/workflows#turn-workflows-off). Эквивалентно параметру [`disableWorkflows`](/docs/ru/settings-reference#disableworkflows) |

280| `CLAUDE_CODE_EFFORT_LEVEL` | Установить уровень effort для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования значения по умолчанию модели. Доступные уровни зависят от модели. Имеет приоритет над `--effort`, `/effort` и параметрами `modelSettings` и `effortLevel`. Ограничение [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) по-прежнему применяется. См. [Отрегулировать уровень effort](/docs/ru/model-config#adjust-effort-level) |280| `CLAUDE_CODE_EFFORT_LEVEL` | Установить уровень усилий для поддерживаемых моделей. Значения: `low`, `medium`, `high`, `xhigh`, `max` или `auto` для использования модели по умолчанию. Доступные уровни зависят от модели. Имеет приоритет над `--effort`, `/effort` и параметрами `modelSettings` и `effortLevel`. Ограничение [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) по-прежнему применяется. См. [Отрегулировать уровень усилий](/docs/ru/model-config#adjust-effort-level) |

281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Принято для совместимости со старыми выпусками и не имеет эффекта. Режим auto доступен по умолчанию на каждом поставщике, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансы [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом. В версиях 2.1.158 через 2.1.206 установка этого на `1` была необходима для доступности [режима auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) на этих поставщиках |281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Принято для совместимости со старыми выпусками и не имеет эффекта. Автоматический режим доступен по умолчанию на каждом поставщике, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансы [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом. В версиях 2.1.158 через 2.1.206 установка на `1` была необходима для доступности [автоматического режима](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) на этих поставщиках |

282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сеанса](/docs/ru/interactive-mode#session-recap). Установите `0` для принудительного отключения сводок независимо от переключателя `/config`. Установите `1` для принудительного включения сводок, когда [`awaySummaryEnabled`](/docs/ru/settings-reference#awaysummaryenabled) — это `false`. Имеет приоритет над параметром и переключателем `/config` |282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Переопределить доступность [сводки сеанса](/docs/ru/interactive-mode#session-recap). Установите на `0`, чтобы принудительно отключить сводки независимо от переключателя `/config`. Установите на `1`, чтобы принудительно включить сводки, когда [`awaySummaryEnabled`](/docs/ru/settings-reference#awaysummaryenabled) имеет значение `false`. Имеет приоритет над параметром и переключателем `/config` |

283| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите `1` для обновления состояния плагина на границах хода в [неинтерактивном режиме](/docs/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системную подсказку в середине сеанса, что делает недействительным [кэширование подсказок](/docs/ru/prompt-caching) для этого хода |283| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Установите на `1`, чтобы обновить состояние плагина на границах хода в [неинтерактивном режиме](/docs/ru/headless) после завершения фоновой установки. Отключено по умолчанию, потому что обновление изменяет системную подсказку в середине сеанса, что делает недействительным [кэширование подсказок](/docs/ru/prompt-caching) для этого хода |

284| `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` и политика обратной связи организации имеют приоритет |284| `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` и политика отзывов организации имеют приоритет |

285| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Контролирует, передаются ли входные данные вызова инструмента из API по мере их создания Claude. При отключении большой вход инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на API Anthropic. На Amazon Bedrock и Google Cloud's Agent Platform включено для каждой модели, где развернутый контейнер это поддерживает. Установите `0` для отказа. Установите `1` для принудительного включения при маршрутизации через прокси через `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` или `ANTHROPIC_BEDROCK_BASE_URL`. Отключено по умолчанию на Microsoft Foundry и подключениях [gateway](/docs/ru/gateways) |285| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Контролирует, потоком ли входные данные вызова инструмента из API по мере их создания Claude. При отключении большой вход инструмента, такой как длинная запись файла, поступает только после завершения создания Claude, что может выглядеть как зависание. Включено по умолчанию на API Anthropic. На 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) |

286| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите `1` для заполнения средства выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, иначе показали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются списком разрешений [`availableModels`](/docs/ru/settings-reference#availablemodels), который получает сеанс; доставьте список через [MDM или файл управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), так как [доставка, управляемая сервером, недоступна в конфигурациях шлюза](/docs/ru/server-managed-settings#platform-availability) |286| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Установите на `1`, чтобы заполнить средство выбора `/model` из конечной точки `/v1/models` вашего шлюза, когда `ANTHROPIC_BASE_URL` указывает на совместимый с Anthropic шлюз, такой как LiteLLM, Kong или внутренний прокси. Отключено по умолчанию, потому что шлюзы, поддерживаемые общим ключом API, в противном случае показали бы каждому пользователю каждую модель, к которой может получить доступ ключ. Обнаруженные модели по-прежнему фильтруются по [`availableModels`](/docs/ru/settings-reference#availablemodels) списку разрешений, который получает сеанс; доставьте список через [MDM или файл управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), так как [доставка, управляемая сервером, недоступна на конфигурациях шлюза](/docs/ru/server-managed-settings#platform-availability) |

287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Удалено в версии 2.1.142, когда [fast mode](/docs/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Удалено в версии 2.1.142, когда [быстрый режим](/docs/ru/fast-mode) по умолчанию переместился с Opus 4.6 на Opus 4.7 |

288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите `false` для отключения предложений подсказок, затемненных предсказаний, которые появляются в вводе подсказки. Имеет приоритет над параметром [`promptSuggestionEnabled`](/docs/ru/settings-reference#promptsuggestionenabled), который записывает переключатель **Prompt suggestions** в `/config`. Claude Code также [приостанавливает предложения, пока ваша учетная запись близка к пределу использования или находится на нем](/docs/ru/interactive-mode#when-claude-code-skips-suggestions). Установите `true` для сохранения их включенными до достижения лимита. Требует Claude Code версии 2.1.238 или позже. См. [Предложения подсказок](/docs/ru/interactive-mode#prompt-suggestions) |288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Установите на `false`, чтобы отключить предложения подсказок, серые предсказания, которые появляются в вводе подсказки. Имеет приоритет над параметром [`promptSuggestionEnabled`](/docs/ru/settings-reference#promptsuggestionenabled), который записывает переключатель **Prompt suggestions** в `/config`. Claude Code также [приостанавливает предложения, пока ваша учётная запись близка к или находится на пределе использования](/docs/ru/interactive-mode#when-claude-code-skips-suggestions). Установите на `true`, чтобы сохранить их включёнными до достижения лимита. Требует Claude Code версии 2.1.238 или позже. См. [Предложения подсказок](/docs/ru/interactive-mode#prompt-suggestions) |

289| `CLAUDE_CODE_ENABLE_TASKS` | Выбирает, какие инструменты отслеживания задач Claude Code предоставляет в [сеансах, которые их имеют](/docs/ru/tools-reference#task-tool-availability). По умолчанию Claude Code предоставляет инструменты Task `TaskCreate`, `TaskUpdate`, `TaskGet` и `TaskList`. Установите `0` для получения устаревшего инструмента `TodoWrite` вместо этого. См. [Список задач](/docs/ru/interactive-mode#task-list) |289| `CLAUDE_CODE_ENABLE_TASKS` | Выбирает, какие инструменты отслеживания задач Claude Code предоставляет в [сеансах, которые их имеют](/docs/ru/tools-reference#task-tool-availability). По умолчанию Claude Code предоставляет инструменты Task `TaskCreate`, `TaskUpdate`, `TaskGet` и `TaskList`. Установите на `0`, чтобы получить вместо этого устаревший инструмент `TodoWrite`. См. [Список задач](/docs/ru/interactive-mode#task-list) |

290| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите `1` для включения сбора данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортеров OTel. См. [Мониторинг](/docs/ru/monitoring-usage) |290| `CLAUDE_CODE_ENABLE_TELEMETRY` | Установите на `1`, чтобы включить сбор данных OpenTelemetry для метрик и логирования. Требуется перед настройкой экспортёров OTel. См. [Мониторинг](/docs/ru/monitoring-usage) |

291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Установите `1` для получения инструментов отслеживания задач на каждой модели. Без этого Claude Code предоставляет их по умолчанию только на моделях, перечисленных в [Доступность инструмента Task](/docs/ru/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` по-прежнему выбирает инструменты Task или `TodoWrite`. Требует Claude Code версии 2.1.233 или позже |291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Установите на `1`, чтобы получить инструменты отслеживания задач на каждой модели. Без этого Claude Code предоставляет их по умолчанию только на моделях, перечисленных в [Доступность инструмента Task](/docs/ru/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` по-прежнему выбирает инструменты Task или `TodoWrite`. Требует Claude Code версии 2.1.233 или позже |

292| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Время в миллисекундах для ожидания после того, как цикл запроса становится неактивным, перед автоматическим выходом. Полезно для автоматизированных рабочих процессов и скриптов, использующих режим SDK |292| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Время в миллисекундах для ожидания после того, как цикл запроса становится неактивным, перед автоматическим выходом. Полезно для автоматизированных рабочих процессов и скриптов, использующих режим SDK |

293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Установите `1` для включения [команд агентов](/docs/ru/agent-teams). Команды агентов являются экспериментальными и отключены по умолчанию |293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Установите на `1`, чтобы включить [команды агентов](/docs/ru/agent-teams). Команды агентов являются экспериментальными и отключены по умолчанию |

294| `CLAUDE_CODE_EXTRA_BODY` | Объект JSON для объединения на верхний уровень каждого тела запроса API. Полезно для передачи параметров, специфичных для поставщика, которые Claude Code не предоставляет напрямую. Значение, экспортированное в вашей оболочке, также применяется к [фоновым сеансам](/docs/ru/agent-view), которые вы отправляете с помощью `claude agents` или `--bg`. До версии 2.1.206 фоновые сеансы игнорировали экспортированное значение оболочки и использовали любую копию, которую унаследовал процесс супервизора фона |294| `CLAUDE_CODE_EXTRA_BODY` | JSON объект для объединения на верхний уровень каждого тела запроса API. Полезно для передачи параметров, специфичных для поставщика, которые Claude Code не предоставляет напрямую. Значение, экспортированное в вашей оболочке, также применяется к [фоновым сеансам](/docs/ru/agent-view), которые вы отправляете с помощью `claude agents` или `--bg`. До версии 2.1.206 фоновые сеансы игнорировали экспортированное значение оболочки и использовали любую копию, которую унаследовал процесс супервизора фона |

295| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Переопределить ограничение токенов по умолчанию для чтения файлов. Полезно, когда вам нужно прочитать большие файлы полностью |295| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Переопределить ограничение токенов по умолчанию для чтения файлов. Полезно, когда вам нужно прочитать большие файлы полностью |

296| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Установите `1` для принудительного сохранения стенограммы, истории подсказок и регистрации `claude agents` даже когда этот `claude` был запущен изнутри другого сеанса Claude Code. Используйте, когда унаследованное значение `CLAUDE_CODE_CHILD_SESSION`, например из сеанса `screen` или фонового средства запуска, впервые запущенного инструментом Bash Claude Code, вызывает неправильную классификацию подлинного верхнего сеанса как вложенного. Начиная с версии 2.1.178, Claude Code автоматически обнаруживает случай tmux и игнорирует унаследованный маркер, поэтому tmux больше не нуждается в этой переменной. Также соблюдается на версиях 2.1.169 и ранее; не имеет эффекта на версиях 2.1.170 и 2.1.171, где удалено обнаружение вложенного сеанса, которое оно переопределяет |296| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Установите на `1`, чтобы принудительно сохранить стенограмму, историю подсказок и регистрацию `claude agents`, даже когда этот `claude` был запущен изнутри другого сеанса Claude Code. Используйте, когда унаследованное значение `CLAUDE_CODE_CHILD_SESSION`, например из сеанса `screen` или фонового средства запуска, впервые запущенного инструментом Bash Claude Code, вызывает неправильную классификацию подлинного сеанса верхнего уровня как вложенного. Начиная с версии 2.1.178, Claude Code автоматически обнаруживает случай tmux и игнорирует унаследованный маркер, поэтому tmux больше не нуждается в этой переменной. Также соблюдается на версиях 2.1.169 и ранее; не имеет эффекта на версиях 2.1.170 и 2.1.171, где обнаружение вложенного сеанса, которое оно переопределяет, было удалено |

297| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Установите `1` для принудительного рендеринга зачеркивания для `~~text~~` в ответах Claude, когда ваш терминал это поддерживает, но не автоопределяется, например, через SSH без пересылки `TERM_PROGRAM`. Без этого необнаруженные терминалы показывают буквальные маркеры `~~` вместо рендеринга текста как зачеркивания. Требует Claude Code версии 2.1.186 или позже |297| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Установите на `1`, чтобы принудительно отобразить зачёркивание для `~~text~~` в ответах Claude, когда ваш терминал это поддерживает, но не автоопределён, например, через SSH без пересылки `TERM_PROGRAM`. Без этого необнаруженные терминалы показывают буквальные маркеры `~~` вместо отображения текста как зачёркнутого. Требует Claude Code версии 2.1.186 или позже |

298| `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), это не изменяет рендерер |298| `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), это не изменяет рендер |

299| `CLAUDE_CODE_FORK_SUBAGENT` | Контролирует [режим fork](/docs/ru/sub-agents#turn-fork-mode-on-or-off), который позволяет Claude порождать [разветвленные subagents](/docs/ru/sub-agents#fork-the-current-conversation) сам и включен по умолчанию только в интерактивных сеансах. Установите `1` для включения в `claude -p` и Agent SDK также, или `0` для отключения в каждом виде сеанса. Вы можете запустить `/subtask` независимо от того, включен ли режим fork. Интерактивное значение по умолчанию требует Claude Code версии 2.1.232 или позже; на более ранних версиях установите переменную на `1` для включения режима fork |299| `CLAUDE_CODE_FORK_SUBAGENT` | Контролирует [режим fork](/docs/ru/sub-agents#turn-fork-mode-on-or-off), который позволяет Claude порождать [разветвлённые подагенты](/docs/ru/sub-agents#fork-the-current-conversation) сам и включен по умолчанию только в интерактивных сеансах. Установите на `1`, чтобы включить его в `claude -p` и Agent SDK также, или `0`, чтобы отключить его в каждом виде сеанса. Вы можете запустить `/subtask` независимо от того, включён ли режим fork. Интерактивное значение по умолчанию требует Claude Code версии 2.1.232 или позже; на более ранних версиях установите переменную на `1`, чтобы включить режим fork |

300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Установите `1` для выдачи [subagent](/docs/ru/sub-agents) текста и блоков мышления в выводе `claude -p --output-format stream-json`, то же поведение, что и флаг [`--forward-subagent-text`](/docs/ru/cli-reference#cli-flags). Используйте переменную, когда harness вызывает `claude` и не может передать флаг сам. В отличие от флага, который выходит с ошибкой вне неинтерактивного режима с выводом stream-json, переменная игнорируется там, чтобы вложенные вызовы продолжали работать при установке процесса. Требует Claude Code версии 2.1.211 или позже |300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Установите на `1`, чтобы выдавать блоки текста и мышления [подагента](/docs/ru/sub-agents) в выводе `claude -p --output-format stream-json`, то же поведение, что и флаг [`--forward-subagent-text`](/docs/ru/cli-reference#cli-flags). Используйте переменную, когда средство запуска вызывает `claude` и не может передать флаг сам. В отличие от флага, который выходит с ошибкой вне неинтерактивного режима с выводом stream-json, переменная игнорируется там, чтобы вложенные вызовы продолжали работать при установке процесса. Требует Claude Code версии 2.1.211 или позже |

301| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Таймаут в миллисекундах для запроса [обнаружения модели шлюза](/docs/ru/llm-gateway-protocol#model-discovery), который включает `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (по умолчанию: `3000`). Повысьте это, когда вашему шлюзу требуется больше трех секунд для ответа на `/v1/models` при запуске. Принимает только простые цифры; `0`, отрицательные значения и другие написания сохраняют значение по умолчанию. Требует Claude Code версии 2.1.269 или позже |301| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Установите на `1`, чтобы отправлять [заголовки подсказок шлюза](/docs/ru/llm-gateway-protocol#gateway-hint-headers), такие как `x-claude-code-request-class` и `x-claude-code-compaction`, на пользовательский прокси или сторонний поставщик, такой как Amazon Bedrock или Claude Platform on AWS. Установите на `0`, чтобы остановить их отправку при каждом подключении, включая прямое подключение к API Anthropic, где Claude Code отправляет их по умолчанию. Требует Claude Code версии 2.1.273 или позже |

302| `CLAUDE_CODE_GIT_BASH_PATH` | Только Windows: путь к исполняемому файлу Git Bash (`bash.exe`). Используйте, когда Git Bash установлен, но не в вашем PATH. Если путь не существует или файл не назван `bash.exe`, `sh.exe`, `bash` или `sh`, Claude Code игнорирует переменную и автоопределяет Git Bash, как если бы она была неустановлена, логируя предупреждение, видимое с `--debug`. До версии 2.1.219 Claude Code выходил при запуске, когда путь не существовал, и использовал любой существующий файл как оболочку без проверки того, что это bash или sh. См. [Настройка Windows](/docs/ru/setup#set-up-on-windows) |302| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Таймаут в миллисекундах для запроса [обнаружения модели шлюза](/docs/ru/llm-gateway-protocol#model-discovery), который включает `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (по умолчанию: `3000`). Повысьте это, когда ваш шлюз нуждается в большем времени, чем три секунды, чтобы ответить на `/v1/models` при запуске. Принимает только простые цифры; `0`, отрицательные значения и другие написания сохраняют значение по умолчанию. Требует Claude Code версии 2.1.269 или позже |

303| `CLAUDE_CODE_GLOB_HIDDEN` | Установите `false` для исключения скрытых файлов из результатов, когда Claude вызывает [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior). Включено по умолчанию. Не влияет на автодополнение файлов `@`, `ls`, Grep или Read |303| `CLAUDE_CODE_GIT_BASH_PATH` | Только Windows: путь к исполняемому файлу Git Bash (`bash.exe`). Используйте, когда Git Bash установлен, но не в вашем PATH. Если путь не существует или файл не назван `bash.exe`, `sh.exe`, `bash` или `sh`, Claude Code игнорирует переменную и автоопределяет Git Bash, как если бы она была не установлена, логируя предупреждение, видимое с `--debug`. До версии 2.1.219 Claude Code выходил при запуске, когда путь не существовал, и использовал любой существующий файл как оболочку без проверки, что это bash или sh. См. [Настройка Windows](/docs/ru/setup#set-up-on-windows) |

304| `CLAUDE_CODE_GLOB_NO_IGNORE` | Установите `false` для того, чтобы [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior) соблюдал шаблоны `.gitignore`. По умолчанию Glob возвращает все совпадающие файлы, включая игнорируемые git. Не влияет на автодополнение файлов `@`, которое имеет свой собственный параметр [`respectGitignore`](/docs/ru/settings-reference#respectgitignore) |304| `CLAUDE_CODE_GLOB_HIDDEN` | Установите на `false`, чтобы исключить скрытые файлы из результатов, когда Claude вызывает [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior). Включено по умолчанию. Не влияет на автодополнение файлов `@`, `ls`, Grep или Read |

305| `CLAUDE_CODE_GLOB_NO_IGNORE` | Установите на `false`, чтобы заставить [инструмент Glob](/docs/ru/tools-reference#glob-tool-behavior) соблюдать шаблоны `.gitignore`. По умолчанию Glob возвращает все совпадающие файлы, включая игнорируемые git. Не влияет на автодополнение файлов `@`, которое имеет свой собственный параметр [`respectGitignore`](/docs/ru/settings-reference#respectgitignore) |

305| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Таймаут в секундах для обнаружения файлов инструмента Glob. По умолчанию 20 секунд на большинстве платформ и 60 секунд на WSL |306| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Таймаут в секундах для обнаружения файлов инструмента Glob. По умолчанию 20 секунд на большинстве платформ и 60 секунд на WSL |

306| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Сколько минут фоновая работа может держать активную цель в ожидании перед тем, как Claude Code [попросит Claude проверить ее](/docs/ru/goal#background-work-defers-evaluation). По умолчанию `30`. Установите `0` для отключения проверок. Дайте целые минуты в простых цифрах, максимум `10080`, что составляет одну неделю. Claude Code обрабатывает любое другое значение как неустановленное и использует значение по умолчанию. Требует Claude Code версии 2.1.234 или позже |307| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Сколько минут фоновая работа может держать активную цель в ожидании перед тем, как Claude Code [попросит Claude проверить её](/docs/ru/goal#background-work-defers-evaluation). По умолчанию `30`. Установите `0`, чтобы отключить проверки. Дайте целые минуты в простых цифрах, максимум `10080`, что составляет одну неделю. Claude Code обрабатывает любое другое значение как не установленное и использует значение по умолчанию. Требует Claude Code версии 2.1.234 или позже |

307| `CLAUDE_CODE_HIDE_CWD` | Установите `1` для скрытия рабочего каталога в логотипе запуска. Полезно для скринширов или записей, где путь раскрывает имя пользователя вашей ОС |308| `CLAUDE_CODE_HIDE_CWD` | Установите на `1`, чтобы скрыть рабочий каталог в логотипе запуска. Полезно для скринширов или записей, где путь раскрывает имя пользователя вашей ОС |

308| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Переопределить адрес хоста, используемый для подключения к расширению IDE. По умолчанию Claude Code автоопределяет правильный адрес, включая маршрутизацию WSL-to-Windows |309| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Переопределить адрес хоста, используемый для подключения к расширению IDE. По умолчанию Claude Code автоопределяет правильный адрес, включая маршрутизацию WSL-to-Windows |

309| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Установите `1` для пропуска автоустановки расширений IDE. Эквивалентно установке [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) на `false` |310| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Установите на `1`, чтобы пропустить автоустановку расширений IDE. Эквивалентно установке [`autoInstallIdeExtension`](/docs/ru/settings-reference#autoinstallideextension) на `false` |

310| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Установите `1` для пропуска проверки записей файла блокировки IDE при подключении. Используйте, когда автоподключение не может найти вашу IDE, несмотря на то, что она работает |311| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Установите на `1`, чтобы пропустить проверку записей файла блокировки IDE при подключении. Используйте, когда автоподключение не может найти вашу IDE, несмотря на её работу |

311| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Сколько [subagents](/docs/ru/sub-agents#concurrent-subagent-limit) может работать в одном сеансе перед тем, как инструмент Agent откажется порождать другой (по умолчанию: 20). Принимает положительное целое число в простых цифрах; что-либо еще игнорируется, поэтому переменная может отрегулировать ограничение, но не может его отключить. Требует Claude Code версии 2.1.217 или позже |312| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Сколько [подагентов](/docs/ru/sub-agents#concurrent-subagent-limit) может работать в одном сеансе перед тем, как инструмент Agent откажется порождать другого (по умолчанию: 20). Принимает положительное целое число в простых цифрах; всё остальное игнорируется, поэтому переменная может отрегулировать ограничение, но не может отключить его. Требует Claude Code версии 2.1.217 или позже |

312| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Переопределить размер окна контекста, который Claude Code предполагает для активной модели. Начиная с версии 2.1.193, как это применяется, зависит от того, как Claude Code разрешает ID модели; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Используйте это при маршрутизации к модели через `ANTHROPIC_BASE_URL`, чье окно контекста не соответствует встроенному размеру для его имени |313| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Переопределить размер окна контекста, который Claude Code предполагает для активной модели. Начиная с версии 2.1.193, как это применяется, зависит от того, как Claude Code разрешает ID модели; см. [Исправить окно для ID шлюза или пользовательской модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Используйте это при маршрутизации к модели через `ANTHROPIC_BASE_URL`, чьё окно контекста не совпадает с встроенным размером для её имени |

313| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Установить максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и ограничения варьируются по модели; см. [максимальные выходные токены](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code по умолчанию использует 32000 для ID моделей, которые он не распознает, такие как имена, специфичные для шлюза, и понижает значения выше ограничения модели до ограничения. Увеличение этого значения уменьшает эффективное окно контекста, доступное перед [автокомпактированием](/docs/ru/costs#reduce-token-usage) |314| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Установить максимальное количество выходных токенов для большинства запросов. Значения по умолчанию и ограничения варьируются по модели; см. [максимальные выходные токены](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code по умолчанию использует 32000 для ID моделей, которые он не распознаёт, такие как имена, специфичные для шлюза, и понижает значения выше ограничения модели до ограничения. Увеличение этого значения уменьшает эффективное окно контекста, доступное перед срабатыванием [автокомпактирования](/docs/ru/costs#reduce-token-usage) |

314| `CLAUDE_CODE_MAX_RETRIES` | Переопределить количество раз для повтора неудачных запросов API (по умолчанию: 10). Ограничено 15 начиная с версии 2.1.186; начиная с версии 2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Для неконтролируемых сеансов, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG` вместо этого |315| `CLAUDE_CODE_MAX_RETRIES` | Переопределить количество раз для повтора неудачных запросов API (по умолчанию: 10). Ограничено 15 начиная с версии 2.1.186; начиная с версии 2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Для неконтролируемых сеансов, которым нужно ждать через более длительные сбои, установите `CLAUDE_CODE_RETRY_WATCHDOG` вместо этого |

315| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Удалено в версии 2.1.224 и теперь не работает. Ранее ограничивало общее количество [subagents](/docs/ru/sub-agents), которых Claude мог порождать с помощью инструмента Agent в одном сеансе (по умолчанию: 200); порождение сверх ограничения завершалось с ошибкой `Subagent spawn limit reached`. [Ограничение одновременного subagent](/docs/ru/sub-agents#concurrent-subagent-limit) и [ограничение глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) по-прежнему применяются |316| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Удалено в версии 2.1.224 и теперь не работает. Ранее ограничивало общее количество [подагентов](/docs/ru/sub-agents), которых Claude мог порождать с инструментом Agent в одном сеансе (по умолчанию: 200); порождение сверх ограничения не выполнялось с `Subagent spawn limit reached`. [Ограничение одновременных подагентов](/docs/ru/sub-agents#concurrent-subagent-limit) и [ограничение глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) по-прежнему применяются |

316| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Количество [слоев subagent](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) разрешено ниже основного разговора (по умолчанию: 3). При значении по умолчанию subagents могут порождать собственные subagents, и subagent на третьем слое не может порождать дальше; установите `1` для отключения вложения. В версиях 2.1.217 через 2.1.218 значение по умолчанию было 1, поэтому subagent не мог порождать свой собственный, если вы не повысили ограничение; версия 2.1.219 повысила значение по умолчанию до 3. Принимает положительное целое число в простых цифрах; что-либо еще игнорируется, поэтому ограничение может быть отрегулировано, но не удалено. Требует Claude Code версии 2.1.217 или позже |317| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Количество [слоёв подагентов](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), разрешённых ниже основного разговора (по умолчанию: 3). При значении по умолчанию подагенты могут порождать своих собственных подагентов, и подагент на третьем слое не может порождать дальше; установите `1`, чтобы отключить вложение. В версиях 2.1.217 через 2.1.218 значение по умолчанию было 1, поэтому подагент не мог порождать своего собственного, если вы не повысили ограничение; версия 2.1.219 повысила значение по умолчанию до 3. Принимает положительное целое число в простых цифрах; всё остальное игнорируется, поэтому ограничение может быть отрегулировано, но не удалено. Требует Claude Code версии 2.1.217 или позже |

317| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и subagents, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |318| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Максимальное количество инструментов только для чтения и подагентов, которые могут выполняться параллельно (по умолчанию: 10). Более высокие значения увеличивают параллелизм, но потребляют больше ресурсов |

318| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентивных ходов, когда явное ограничение не передано. Эквивалентно передаче [`--max-turns`](/docs/ru/cli-reference#cli-flags), которая имеет приоритет при установке обоих. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не обрабатывается как отсутствие ограничения |319| `CLAUDE_CODE_MAX_TURNS` | Ограничить количество агентивных ходов, когда явное ограничение не передано. Эквивалентно передаче [`--max-turns`](/docs/ru/cli-reference#cli-flags), которая имеет приоритет при установке обоих. Значение, которое не является положительным целым числом, отклоняется при запуске с ошибкой, а не обрабатывается как отсутствие ограничения |

319| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Ограничение на общее количество вызовов [WebSearch](/docs/ru/tools-reference#websearch-tool-behavior), которые один сеанс может сделать (по умолчанию: 200). Когда Claude достигает ограничения, дальнейшие вызовы WebSearch возвращают уведомление, говорящее ему продолжить с информацией, которую он уже собрал. Принимает положительное целое число без верхнего ограничения. Что-либо еще игнорируется и применяется значение по умолчанию, поэтому ограничение может быть повышено, но не отключено. Требует Claude Code версии 2.1.212 или позже |320| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Ограничение на общее количество вызовов [WebSearch](/docs/ru/tools-reference#websearch-tool-behavior), которые один сеанс может сделать (по умолчанию: 200). Когда Claude достигает ограничения, дальнейшие вызовы WebSearch возвращают уведомление, говорящее ему продолжить с информацией, которую он уже собрал. Принимает положительное целое число без верхнего ограничения. Всё остальное игнорируется и применяется значение по умолчанию, поэтому ограничение может быть повышено, но не отключено. Требует Claude Code версии 2.1.212 или позже |

320| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите `1` для порождения серверов MCP stdio с только безопасной базовой средой плюс настроенная `env` сервера, вместо наследования окружения вашей оболочки |321| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Установите на `1`, чтобы порождать серверы stdio MCP с только безопасной базовой окружением плюс настроенная окружение сервера, вместо наследования окружения вашей оболочки |

321| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Прошедшее время в миллисекундах перед тем, как все еще работающий вызов инструмента MCP [переместится в фоновую задачу](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) (по умолчанию: 120000 или 2 минуты). Установите `0` для отключения автоматического фонового выполнения. Требует Claude Code версии 2.1.212 или позже |322| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Прошедшее время в миллисекундах перед тем, как всё ещё работающий вызов инструмента MCP [переместится в фоновую задачу](/docs/ru/mcp#automatic-backgrounding-of-long-tool-calls) (по умолчанию: 120000 или 2 минуты). Установите на `0`, чтобы отключить автоматическое фоновое выполнение. Требует Claude Code версии 2.1.212 или позже |

322| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Как долго в миллисекундах первый ход [неинтерактивного](/docs/ru/headless) сеанса ждет серверов MCP, которые все еще подключаются, вместо [ожидания первого хода](/docs/ru/agent-sdk/mcp#connection-timing) по умолчанию. Если установлено, ожидание охватывает каждый ожидающий сервер. Установите `0` для пропуска ожидания. Сервер [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) сохраняет свое собственное ожидание `MCP_TIMEOUT` независимо от значения. Требует Claude Code версии 2.1.274 или позже |323| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Как долго в миллисекундах первый ход [неинтерактивного](/docs/ru/headless) сеанса ждёт серверов MCP, которые всё ещё подключаются, вместо [ожидания первого хода](/docs/ru/agent-sdk/mcp#connection-timing) по умолчанию. При установке ожидание охватывает каждый ожидающий сервер. Установите на `0`, чтобы пропустить ожидание. Сервер [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) сохраняет своё собственное ожидание `MCP_TIMEOUT` независимо от значения. Требует Claude Code версии 2.1.274 или позже |

323| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Таймаут простоя в миллисекундах для вызовов инструментов MCP. Когда сервер MCP stdio, HTTP, SSE, WebSocket или [claude.ai connector](/docs/ru/mcp#use-mcp-servers-from-claude-ai) не отправляет ответ и уведомление о прогрессе в течение этого времени, вызов инструмента прерывается с ошибкой вместо ожидания общего `MCP_TOOL_TIMEOUT`. Переопределяет значения по умолчанию для каждого транспорта 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для серверов stdio. Установите `0` для отключения проверки простоя. Значения ниже 1000 повышаются до одной секунды, и значение ограничено эффективным `MCP_TOOL_TIMEOUT`. Сервер `timeout` в `.mcp.json` по крайней мере 1000 повышает окно простоя этого сервера по крайней мере до значения `timeout`. Не применяется к серверам IDE или серверам в процессе SDK. Требует Claude Code версии 2.1.187 или позже. До версии 2.1.203 серверы stdio были освобождены от таймаута простоя |324| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Таймаут простоя в миллисекундах для вызовов инструментов MCP. Когда сервер stdio, HTTP, SSE, WebSocket или [соединитель claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai) MCP не отправляет ответ и уведомление о прогрессе в течение этого времени, вызов инструмента прерывается с ошибкой вместо ожидания общего `MCP_TOOL_TIMEOUT`. Переопределяет значения по умолчанию для каждого транспорта 300000 (5 минут) для сетевых серверов и 1800000 (30 минут) для серверов stdio. Установите на `0`, чтобы отключить проверку простоя. Значения ниже 1000 повышаются до одной секунды, и значение ограничено эффективным `MCP_TOOL_TIMEOUT`. Сервер для каждого сервера `timeout` в `.mcp.json` по крайней мере 1000 повышает окно простоя этого сервера по крайней мере до значения `timeout`. Не применяется к серверам IDE или внутрипроцессным серверам SDK. Требует Claude Code версии 2.1.187 или позже. До версии 2.1.203 серверы stdio были освобождены от таймаута простоя |

324| `CLAUDE_CODE_MESSAGING_SOCKET` | Установлено Claude Code, а не вами: в сеансах, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует путь этого сокета к hooks и командам Bash при привязке сокета. В сеансе, который начинается с включенной передачей сообщений, Claude Code привязывает сокет перед запуском любого hook. Другие сеансы на машине доставляют сообщения на этот путь. Каждый сеанс экспортирует свой собственный сокет, а не унаследованный от родителя, и сообщения, поступающие на него, проходят через [входящие элементы управления](/docs/ru/cross-session-messaging#control-inbound-messages) сеанса. Блоки параметров `env` не могут его установить. Требует Claude Code версии 2.1.224 или позже |325| `CLAUDE_CODE_MESSAGING_SOCKET` | Установлено Claude Code, не вами: в сеансах, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует путь этого сокета к hooks и командам Bash, когда привязывает сокет. В сеансе, который начинается с включённого обмена сообщениями, Claude Code привязывает сокет перед запуском любого hook. Другие сеансы на машине доставляют сообщения на этот путь. Каждый сеанс экспортирует свой собственный сокет, а не унаследованный от родителя, и сообщения, поступающие на него, проходят через [входящие элементы управления](/docs/ru/cross-session-messaging#control-inbound-messages) сеанса. Блоки параметров `env` не могут его установить. Требует Claude Code версии 2.1.224 или позже |

325| `CLAUDE_CODE_MESSAGING_TOKEN` | Установлено Claude Code, а не вами: в сеансах, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует этот токен для каждого сеанса к hooks и командам Bash рядом с `CLAUDE_CODE_MESSAGING_SOCKET`. Скрипт, отправляющий на сокет, может отправить `{"type":"auth","token":"<token>"}` как первую строку для доказательства того, что он принадлежит сеансу. На собственном Windows Claude Code требует эту строку и закрывает любое подключение, которое не открывается с действительной. [Правила собственного дочернего элемента](/docs/ru/cross-session-messaging#the-sessions-inbox-socket) говорят, когда Claude Code консультирует токен. Каждый сеанс экспортирует свой собственный токен, никогда не унаследованный от родительского сеанса. Блоки параметров `env` не могут его установить. Требует Claude Code версии 2.1.228 или позже |326| `CLAUDE_CODE_MESSAGING_TOKEN` | Установлено Claude Code, не вами: в сеансах, которые привязывают [сокет входящих сообщений](/docs/ru/cross-session-messaging#the-sessions-inbox-socket), Claude Code экспортирует этот токен для каждого сеанса к hooks и командам Bash рядом с `CLAUDE_CODE_MESSAGING_SOCKET`. Скрипт, публикующий на сокет, может отправить `{"type":"auth","token":"<token>"}` как первую строку, чтобы доказать, что он принадлежит сеансу. На собственном Windows Claude Code требует эту строку и закрывает любое подключение, которое не открывается с действительной. [Правила собственного дочернего элемента](/docs/ru/cross-session-messaging#the-sessions-inbox-socket) говорят, когда Claude Code консультирует токен. Каждый сеанс экспортирует свой собственный токен, никогда не унаследованный от родительского сеанса. Блоки параметров `env` не могут его установить. Требует Claude Code версии 2.1.228 или позже |

326| `CLAUDE_CODE_NATIVE_CURSOR` | Установите `1` для отображения собственного курсора терминала в каретке ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |327| `CLAUDE_CODE_NATIVE_CURSOR` | Установите на `1`, чтобы показать собственный курсор терминала в позиции каретки ввода вместо нарисованного блока. Курсор соблюдает параметры мигания, формы и фокуса терминала |

327| `CLAUDE_CODE_NEW_INIT` | Установите `1` для запуска `/init` интерактивного потока настройки. Поток спрашивает, какие файлы создавать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` автоматически создает CLAUDE.md без запроса |328| `CLAUDE_CODE_NEW_INIT` | Установите на `1`, чтобы заставить `/init` запустить интерактивный поток настройки. Поток спрашивает, какие файлы создавать, включая CLAUDE.md, skills и hooks, перед исследованием кодовой базы и их написанием. Без этой переменной `/init` создаёт CLAUDE.md автоматически без запроса |

328| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Установите `1` для записи вывода терминала через второй неблокирующий дескриптор файла, поэтому терминал, который перестает читать, такой как приостановленная панель управления tmux или зависшее подключение SSH, не может заморозить Claude Code в середине сеанса. Применяется на macOS, Linux и WSL, когда stdout является терминалом. Требует Claude Code версии 2.1.261 или позже |329| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Установите на `1`, чтобы писать вывод терминала через второй неблокирующий дескриптор файла, поэтому терминал, который перестаёт читать, такой как приостановленная панель управления tmux или зависшее SSH подключение, не может заморозить Claude Code в середине сеанса. Применяется на macOS, Linux и WSL, когда stdout — это терминал. Требует Claude Code версии 2.1.261 или позже |

329| `CLAUDE_CODE_NO_FLICKER` | Установите `1` для включения [полноэкранного рендеринга](/docs/ru/fullscreen), исследовательского предпросмотра, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Переопределяет параметр [`tui`](/docs/ru/settings-reference#tui); вы также можете переключаться с помощью `/tui fullscreen` |330| `CLAUDE_CODE_NO_FLICKER` | Установите на `1`, чтобы включить [полноэкранный рендер](/docs/ru/fullscreen), исследовательский предпросмотр, который уменьшает мерцание и сохраняет память плоской в длинных разговорах. Переопределяет параметр [`tui`](/docs/ru/settings-reference#tui); вы также можете переключаться с помощью `/tui fullscreen` |

330| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Токен обновления OAuth для аутентификации Claude.ai. Если установлен, `claude auth login` обменивает этот токен напрямую вместо открытия браузера. Требует `CLAUDE_CODE_OAUTH_SCOPES`. Полезно для предоставления аутентификации в автоматизированных окружениях |331| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Токен обновления OAuth для аутентификации Claude.ai. При установке `claude auth login` обменивает этот токен напрямую вместо открытия браузера. Требует `CLAUDE_CODE_OAUTH_SCOPES`. Полезно для предоставления аутентификации в автоматизированных окружениях |

331| `CLAUDE_CODE_OAUTH_SCOPES` | Разделенные пробелом области OAuth, с которыми был выдан токен обновления, такие как `"user:profile user:inference user:sessions:claude_code"`. Требуется при установке `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |332| `CLAUDE_CODE_OAUTH_SCOPES` | Разделённые пробелом области OAuth, с которыми был выдан токен обновления, такие как `"user:profile user:inference user:sessions:claude_code"`. Требуется при установке `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |

332| `CLAUDE_CODE_OAUTH_TOKEN` | Токен доступа OAuth для аутентификации claude.ai. Альтернатива `/login` для SDK и автоматизированных окружений. Имеет приоритет над учетными данными, хранящимися в цепочке ключей. Создайте один с помощью [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token). Если вы не запустите [`/login`](/docs/ru/authentication#authentication-precedence), Claude Code использует установленный вами токен для всего сеанса. Чтобы заменить истекший токен, создайте новый и перезагрузитесь |333| `CLAUDE_CODE_OAUTH_TOKEN` | Токен доступа OAuth для аутентификации claude.ai. Альтернатива `/login` для SDK и автоматизированных окружений. Имеет приоритет над учётными данными, хранящимися в цепочке ключей. Создайте один с помощью [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token). Если вы не запустите [`/login`](/docs/ru/authentication#authentication-precedence), Claude Code использует установленный вами токен для всего сеанса. Чтобы заменить истёкший токен, создайте новый и перезагрузитесь |

333| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Удалено в версии 2.1.160 и теперь не работает. Ранее закреплял [fast mode](/docs/ru/fast-mode) на Claude Opus 4.6 вместо текущего значения по умолчанию. Opus 4.6 больше не поддерживает fast mode |334| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Удалено в версии 2.1.160 и теперь не работает. Ранее закреплял [быстрый режим](/docs/ru/fast-mode) на Claude Opus 4.6 вместо текущего значения по умолчанию. Opus 4.6 больше не поддерживает быстрый режим |

334| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Максимальная длина атрибутов OpenTelemetry, содержащих содержимое (ответы модели, содержимое инструмента, системные подсказки, необработанные тела API), маркер усечения включен, в единицах кода UTF-16 (по умолчанию: 61440, т.е. 60 КБ). Повысьте это только, если ваш бэкэнд телеметрии принимает значения атрибутов больше 64 КБ, или понизьте для сокращения объема телеметрии. Требует Claude Code версии 2.1.214 или позже. См. [Мониторинг](/docs/ru/monitoring-usage) |335| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Максимальная длина атрибутов OpenTelemetry, несущих содержимое (ответы модели, содержимое инструмента, системные подсказки, необработанные тела API), маркер усечения включён, в единицах кода UTF-16 (по умолчанию: 61440, т.е. 60 КБ). Повысьте это только, если ваш бэкэнд телеметрии принимает значения атрибутов больше 64 КБ, или понизьте, чтобы сократить объём телеметрии. Требует Claude Code версии 2.1.214 или позже. См. [Мониторинг](/docs/ru/monitoring-usage) |

335| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Установите `1` для записи диагностических ошибок экспортера OpenTelemetry в stderr. По умолчанию эти ошибки появляются только с `--debug`, поэтому неправильно настроенный экспортер, такой как столкновение портов Prometheus, иначе завершается молча. Требует Claude Code версии 2.1.179 или позже. См. [Мониторинг](/docs/ru/monitoring-usage) |336| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Установите на `1`, чтобы писать диагностические ошибки экспортёра OpenTelemetry в stderr. По умолчанию эти ошибки появляются только с `--debug`, поэтому неправильно настроенный экспортёр, такой как столкновение портов Prometheus, в противном случае молча не выполняется. Требует Claude Code версии 2.1.179 или позже. См. [Мониторинг](/docs/ru/monitoring-usage) |

336| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Таймаут в миллисекундах для сброса ожидающих spans OpenTelemetry (по умолчанию: 5000). См. [Мониторинг](/docs/ru/monitoring-usage) |337| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Таймаут в миллисекундах для сброса ожидающих пролётов OpenTelemetry (по умолчанию: 5000). См. [Мониторинг](/docs/ru/monitoring-usage) |

337| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал для обновления динамических заголовков OpenTelemetry в миллисекундах (по умолчанию: 1740000 / 29 минут). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) |338| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Интервал для обновления динамических заголовков OpenTelemetry в миллисекундах (по умолчанию: 1740000 / 29 минут). См. [Динамические заголовки](/docs/ru/monitoring-usage#dynamic-headers) |

338| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Таймаут в миллисекундах для завершения экспортера OpenTelemetry при выключении (по умолчанию: 2000). Увеличьте, если метрики отбрасываются при выходе. См. [Мониторинг](/docs/ru/monitoring-usage) |339| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Таймаут в миллисекундах для завершения экспортёра OpenTelemetry при выключении (по умолчанию: 2000). Увеличьте, если метрики отбрасываются при выходе. См. [Мониторинг](/docs/ru/monitoring-usage) |

339| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите `1` для разрешения Claude Code запускать команду обновления вашего менеджера пакетов в фоновом режиме, когда доступна новая версия. Применяется к установкам Homebrew и WinGet. Другие менеджеры пакетов продолжают показывать команду обновления без запуска. См. [Автоматические обновления](/docs/ru/setup#auto-updates) |340| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Установите на `1`, чтобы позволить Claude Code запустить команду обновления вашего менеджера пакетов в фоне, когда доступна новая версия. Применяется к установкам Homebrew и WinGet. Другие менеджеры пакетов продолжают показывать команду обновления без её запуска. См. [Автообновления](/docs/ru/setup#auto-updates) |

340| `CLAUDE_CODE_PERFORCE_MODE` | Установите `1` для включения защиты от записи с учетом Perforce. Если установлено, Edit, Write и NotebookEdit завершаются с подсказкой `p4 edit <file>`, если целевой файл не имеет бита owner-write, который Perforce очищает на синхронизированных файлах до `p4 edit` их открывает. Это предотвращает обход Claude Code отслеживания изменений Perforce |341| `CLAUDE_CODE_PERFORCE_MODE` | Установите на `1`, чтобы включить защиту записи, осведомлённую о Perforce. При установке Edit, Write и NotebookEdit не выполняются с подсказкой `p4 edit <file>`, если целевой файл не имеет бита владельца-записи, который Perforce очищает на синхронизированных файлах до `p4 edit` их открытия. Это предотвращает Claude Code от обхода отслеживания изменений Perforce |

341| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределить корневой каталог плагинов. Несмотря на имя, это устанавливает родительский каталог, а не сам кэш: рынки и кэш плагинов находятся в подкаталогах под этим путем. По умолчанию `~/.claude/plugins` |342| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Переопределить корневой каталог плагинов. Несмотря на имя, это устанавливает родительский каталог, а не сам кэш: рынки и кэш плагинов находятся в подкаталогах под этим путём. По умолчанию `~/.claude/plugins` |

342| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Таймаут в миллисекундах для операций git при установке или обновлении плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. [Операции Git истекают](/docs/ru/plugin-marketplaces#git-operations-time-out) |343| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Таймаут в миллисекундах для операций git при установке или обновлении плагинов (по умолчанию: 120000). Увеличьте это значение для больших репозиториев или медленных сетевых подключений. См. [Операции Git истекают](/docs/ru/plugin-marketplaces#git-operations-time-out) |

343| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите `1` для пропуска попытки повторного клонирования и сохранения использования существующей проверки рынка, когда обновление рынка не может достичь или аутентифицироваться на удаленном. Полезно в автономных или изолированных окружениях, где повторное клонирование завершилось бы так же. См. [Обновления рынка завершаются в автономных окружениях](/docs/ru/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |344| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Установите на `1`, чтобы пропустить попытку повторного клонирования и продолжить использование существующего клона рынка, когда обновление рынка не может достичь или аутентифицироваться на удалённом источнике. Полезно в автономных или изолированных окружениях, где повторное клонирование не выполнилось бы так же. См. [Обновления рынка не выполняются в автономных окружениях](/docs/ru/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |

344| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите `1` для клонирования сокращенных источников GitHub `owner/repo` через HTTPS вместо SSH. Применяется к установке и обновлению плагина, а также к `/plugin marketplace add` и `update`. Полезно в CI runners, контейнерах или любом окружении без настроенного ключа SSH для `github.com` |345| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Установите на `1`, чтобы клонировать сокращённые источники GitHub `owner/repo` через HTTPS вместо SSH. Применяется к установке и обновлению плагина, а также к `/plugin marketplace add` и `update`. Полезно в средах CI, контейнерах или любом окружении без настроенного ключа SSH для `github.com` |

345| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким каталогам seed плагинов только для чтения, разделенным `:` на Unix или `;` на Windows. Используйте это для объединения предварительно заполненного катал ога плагинов в образ контейнера. Claude Code регистрирует рынки из этих каталогов при запуске и использует предварительно кэшированные плагины без повторного клонирования. См. [Предварительное заполнение плагинов для контейнеров](/docs/ru/plugin-marketplaces#pre-populate-plugins-for-containers) |346| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Путь к одному или нескольким каталогам семян плагинов только для чтения, разделённым `:` на Unix или `;` на Windows. Используйте это, чтобы упаковать предварительно заполненный каталог плагинов в образ контейнера. Claude Code регистрирует рынки из этих каталогов при запуске и использует предварительно кэшированные плагины без повторного клонирования. См. [Предварительно заполнить плагины для контейнеров](/docs/ru/plugin-marketplaces#pre-populate-plugins-for-containers) |

346| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите `1` для остановки Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и соблюдения политики выполнения машины вместо этого. По умолчанию Claude Code обходит политику выполнения в области процесса, чтобы скрипты `.ps1` и импорты модулей работали на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |347| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Установите на `1`, чтобы остановить Claude Code от передачи `-ExecutionPolicy Bypass` при порождении PowerShell для вызовов инструментов, hooks и команд строки состояния, и вместо этого соблюдать эффективную политику выполнения машины. По умолчанию Claude Code обходит политику выполнения в области процесса, поэтому скрипты `.ps1` и импорты модулей работают на установках Windows с ограничением по умолчанию. Обход области процесса никогда не переопределяет Group Policy `MachinePolicy` или `UserPolicy` независимо от этого параметра |

347| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Потолок в миллисекундах на ожидание простоя для фоновых subagents и workflows после финального хода в [неинтерактивном режиме](/docs/ru/headless#background-tasks-at-exit) с флагом `-p`. Ожидание простоя начинается заново каждый раз, когда Claude берет ход для обработки результата фона. По умолчанию: `600000` или 10 минут. Когда ожидание простоя достигает потолка, Claude Code перестает ждать оставшихся фоновых задач и выходит. Установите `0` для неопределенного ожидания. Этот ограничение отделено от пятисекундного периода благодарности, который применяется к простым фоновым оболочкам. Требует Claude Code версии 2.1.182 или позже |348| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Потолок в миллисекундах на ожидание простоя для фоновых подагентов и workflows после финального хода в [неинтерактивном режиме](/docs/ru/headless#background-tasks-at-exit) с флагом `-p`. Ожидание простоя начинается заново каждый раз, когда Claude берёт ход для обработки результата фона. По умолчанию: `600000` или 10 минут. Когда ожидание простоя достигает потолка, Claude Code перестаёт ждать оставшихся фоновых задач и выходит. Установите на `0`, чтобы ждать бесконечно. Этот потолок отделён от пятисекундного периода благодарности, который применяется к простым фоновым оболочкам. Требует Claude Code версии 2.1.182 или позже |

348| `CLAUDE_CODE_PROCESS_WRAPPER` | Запустить процессы, которые Claude Code запускает из своего собственного двоичного файла, такие как фоновый сервис, который размещает сеансы [представления агента](/docs/ru/agent-view), через корпоративный средство запуска, заданное как префикс argv, такой как `/opt/corp/launcher`. Установите его в блоке `env` пользовательских или [управляемых параметров](/docs/ru/managed-settings), а не как экспорт оболочки, чтобы отделенный фоновый сервис его унаследовал; параметры проекта и локальные параметры не могут его установить. Эквивалентно параметру [`processWrapper`](/docs/ru/settings-reference#processwrapper), который требует Claude Code версии 2.1.210 или позже; эта переменная имеет приоритет при установке обоих. Расширение VS Code настраивает свой собственный средство запуска отдельно через параметр `claudeProcessWrapper`. Игнорируется на Windows. См. [Запустить Claude Code за корпоративным средством запуска](/docs/ru/corporate-launcher) для формата значения, что охватывает средство запуска и контракт, который должно удовлетворять средство запуска. Требует Claude Code версии 2.1.208 или позже |349| `CLAUDE_CODE_PROCESS_WRAPPER` | Запустить процессы, которые Claude Code запускает из своего собственного двоичного файла, такие как фоновый сервис, который размещает сеансы [представления агента](/docs/ru/agent-view), через корпоративный средство запуска, заданное как префикс argv, такой как `/opt/corp/launcher`. Установите это в блоке `env` пользовательских или [управляемых параметров](/docs/ru/managed-settings), а не как экспорт оболочки, поэтому отделённый фоновый сервис его наследует; параметры проекта и локальные параметры не могут его установить. Эквивалентно параметру [`processWrapper`](/docs/ru/settings-reference#processwrapper), который требует Claude Code версии 2.1.210 или позже; эта переменная имеет приоритет при установке обоих. Расширение VS Code настраивает свой собственный средство запуска отдельно через параметр `claudeProcessWrapper`. Игнорируется на Windows. См. [Запустить Claude Code за корпоративным средством запуска](/docs/ru/corporate-launcher) для формата значения, что охватывает средство запуска и контракт, который должно удовлетворять средство запуска. Требует Claude Code версии 2.1.208 или позже |

349| `CLAUDE_CODE_PROJECT_DIR_NAME` | Установите вместе с `CLAUDE_CONFIG_DIR` для выбора имени каталога `projects/`, в котором Claude Code хранит стенограммы этого сеанса и автоматическую память, вместо одного, полученного из пути рабочего каталога. Например, запуск Claude Code с `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` хранит их в `/srv/tenant-a/projects/work/`. Claude Code игнорирует эту переменную, когда `CLAUDE_CONFIG_DIR` не установлен, и читает ее только из окружения, из которого вы запускаете `claude`, никогда из блока параметров `env` [параметров](#in-settings-files). См. [Назовите каталог проекта сами](/docs/ru/sessions#name-the-project-directory-yourself). Требует Claude Code версии 2.1.234 или позже |350| `CLAUDE_CODE_PROJECT_DIR_NAME` | Установите вместе с `CLAUDE_CONFIG_DIR`, чтобы выбрать имя каталога `projects/`, в котором Claude Code хранит стенограммы этого сеанса и автоматическую память, вместо одного, полученного из пути рабочего каталога. Например, запуск Claude Code с `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` хранит их в `/srv/tenant-a/projects/work/`. Claude Code игнорирует эту переменную, когда `CLAUDE_CONFIG_DIR` не установлен, и читает её только из окружения, которое вы запускаете `claude` из, никогда из блока параметров `env` [параметров файла](#in-settings-files). См. [Назовите каталог проекта сами](/docs/ru/sessions#name-the-project-directory-yourself). Требует Claude Code версии 2.1.234 или позже |

350| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, для выбора [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для основного разговора: ваши интерактивные, `-p` и SDK ходы, плюс помощники, которые работают встроенно с ними. Имеет приоритет над параметром `promptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет его. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |351| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, чтобы выбрать [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для основного разговора: ваши интерактивные, `-p` и SDK ходы, плюс помощники, которые работают встроенно с ними. Имеет приоритет над параметром `promptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет его. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |

351| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Установите `1` для распространения контекста трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к API Anthropic. Добавлено в версии 2.1.152. См. [Трассировки (бета)](/docs/ru/monitoring-usage#traces-beta) |352| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Установите на `1`, чтобы распространять контекст трассировки W3C, когда `ANTHROPIC_BASE_URL` указывает на пользовательский прокси. Распространение охватывает заголовок `traceparent` на запросах модели и HTTP MCP и переменную окружения `TRACEPARENT` для подпроцессов Bash, PowerShell и hook. По умолчанию распространение включено только при прямом подключении к API Anthropic. Добавлено в версии 2.1.152. См. [Трассировки (бета)](/docs/ru/monitoring-usage#traces-beta) |

352| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. Если установлено, Claude Code игнорирует переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, поэтому пользовательские параметры не могут переопределить маршрутизацию хоста. Claude Code также игнорирует ключи выбора модели, такие как `model`, `fallbackModel` и `modelOverrides` в [управляемых параметрах](/docs/ru/managed-settings), какой бы управляемый источник их не доставлял, поэтому конфигурация модели хоста имеет приоритет над устаревшей закрепленной моделью. Claude Code также игнорирует переменные выбора модели, такие как `ANTHROPIC_MODEL` и семейство `ANTHROPIC_DEFAULT_*_MODEL` в управляемом блоке `env`; список разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) в управляемых параметрах по-прежнему применяется, если только хост не предоставляет свой собственный. Claude Code также пропускает автоматический отказ от телеметрии, который он иначе применяет на сторонних поставщиках, таких как Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/docs/ru/data-usage#default-behaviors-by-api-provider) |353| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Установлено хост-платформами, которые встраивают Claude Code и управляют маршрутизацией поставщика модели от его имени. При установке Claude Code игнорирует переменные выбора поставщика, конечной точки и аутентификации, такие как `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` и `ANTHROPIC_API_KEY` в файлах параметров, поэтому пользовательские параметры не могут переопределить маршрутизацию хоста. Claude Code также игнорирует ключи выбора модели, такие как `model`, `fallbackModel` и `modelOverrides` в [управляемых параметрах](/docs/ru/managed-settings), какой бы управляемый источник их не доставлял, поэтому конфигурация модели хоста имеет приоритет над устаревшей закреплённой моделью. Claude Code также игнорирует переменные выбора модели, такие как `ANTHROPIC_MODEL` и семейство `ANTHROPIC_DEFAULT_*_MODEL` в управляемом блоке `env`; список разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) в управляемых параметрах по-прежнему применяется, если только хост не предоставляет свой собственный. Claude Code также пропускает автоматический отказ от телеметрии, который он в противном случае применяет на сторонних поставщиках, таких как Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry, поэтому телеметрия следует стандартному отказу `DISABLE_TELEMETRY`. См. [Поведение по умолчанию по поставщику API](/docs/ru/data-usage#default-behaviors-by-api-provider) |

353| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите `1` для разрешения прокси выполнять разрешение DNS вместо вызывающей стороны. Opt-in для окружений, где прокси должен обрабатывать разрешение имен хостов |354| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Установите на `1`, чтобы позволить прокси выполнять разрешение DNS вместо вызывающей стороны. Opt-in для окружений, где прокси должен обрабатывать разрешение имён хостов |

354| `CLAUDE_CODE_REMOTE` | Установите автоматически на `true`, когда Claude Code работает как [облачный сеанс](/docs/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки для обнаружения, находитесь ли вы в облачном сеансе |355| `CLAUDE_CODE_REMOTE` | Установлено автоматически на `true`, когда Claude Code работает как [облачный сеанс](/docs/ru/claude-code-on-the-web). Прочитайте это из hook или скрипта настройки, чтобы обнаружить, находитесь ли вы в облачном сеансе |

355| `CLAUDE_CODE_REMOTE_SESSION_ID` | Установите автоматически в [облачных сеансах](/docs/ru/claude-code-on-the-web) на ID текущего сеанса. Прочитайте это для построения ссылки обратно на стенограмму сеанса. См. [Ссылка вывода обратно на сеанс](/docs/ru/cloud-environments#link-output-back-to-the-session) |356| `CLAUDE_CODE_REMOTE_SESSION_ID` | Установлено автоматически в [облачных сеансах](/docs/ru/claude-code-on-the-web) на ID текущего сеанса. Прочитайте это, чтобы построить ссылку обратно на стенограмму сеанса. См. [Ссылка вывода обратно на сеанс](/docs/ru/cloud-environments#link-output-back-to-the-session) |

356| `CLAUDE_CODE_RESTRICTED` | Установите `1` для запуска сеанса в ограниченном режиме, то же самое, что передача [`--restricted`](/docs/ru/cli-reference#cli-flags). Claude Code игнорирует эту переменную в блоке `env` файла параметров. Требует Claude Code версии 2.1.248 или позже |357| `CLAUDE_CODE_RESTRICTED` | Установите на `1`, чтобы запустить сеанс в ограниченном режиме, то же самое, что передача [`--restricted`](/docs/ru/cli-reference#cli-flags). Claude Code игнорирует эту переменную в блоке `env` файла параметров. Требует Claude Code версии 2.1.248 или позже |

357| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите `1` для автоматического возобновления, если предыдущий сеанс завершился в середине хода. Используется в режиме SDK, чтобы модель продолжала без требования SDK повторно отправлять подсказку. Чтобы отключить это, отмените установку переменной или установите ее на `0`. До версии 2.1.221 Claude Code игнорировал `0` и другие ложные значения, поэтому установка `0` по-прежнему вызывала возобновление в неинтерактивном режиме, и отмена установки переменной была единственным способом отключить это |358| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Установите на `1`, чтобы автоматически возобновить, если предыдущий сеанс закончился в середине хода. Используется в режиме SDK, поэтому модель продолжает без требования SDK повторно отправить подсказку. Чтобы отключить это, отмените установку переменной или установите её на `0`. До версии 2.1.221 Claude Code игнорировал `0` и другие ложные значения, поэтому установка `0` по-прежнему срабатывала возобновление в неинтерактивном режиме и отмена установки переменной была единственным способом отключить это |

358| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Максимальный возраст в миллисекундах последнего сообщения стенограммы для сеанса, который завершился в середине хода, для автоматического продолжения при возобновлении. Когда последнее сообщение старше этого ограничения, Claude Code пропускает как автоматическое возобновление `CLAUDE_CODE_RESUME_INTERRUPTED_TURN`, так и введенное сообщение продолжения `CLAUDE_CODE_RESUME_PROMPT`, и сеанс начинается неактивным, чтобы вы продолжили явно. Отсутствие или `0` означает отсутствие ограничения, за исключением того, что ход, чей последний запрос завершился с ошибкой API, возобновляется только пока эта ошибка менее шести часов. Положительное значение ограничивает каждый ход, включая те; отрицательное или нечисловое значение применяет ограничение в один час. Скрипты порождения для долгоживущих агентов могут установить это, чтобы перезагрузка против старой стенограммы не повторно запускала устаревшую подсказку. Claude Code устанавливает ограничение в один час сам, когда перезагружает сбойный сеанс [представления агента](/docs/ru/agent-view), который унаследовал свой разговор из интерактивного сеанса. Требует Claude Code версии 2.1.211 или позже |359| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Максимальный возраст в миллисекундах последнего сообщения стенограммы для сеанса, который закончился в середине хода, чтобы автоматически продолжить при возобновлении. Когда последнее сообщение старше этого ограничения, Claude Code пропускает как автоматическое возобновление `CLAUDE_CODE_RESUME_INTERRUPTED_TURN`, так и введённое сообщение продолжения `CLAUDE_CODE_RESUME_PROMPT`, и сеанс начинается неактивным, чтобы вы продолжили явно. Отсутствие или `0` означает отсутствие ограничения, за исключением того, что ход, чей последний запрос не выполнился с ошибкой API, возобновляется только пока эта ошибка менее шести часов. Положительное значение ограничивает каждый ход, включая те; отрицательное или нечисловое значение применяет ограничение в один час. Скрипты порождения для долгоживущих агентов могут установить это, чтобы перезагрузка против старой стенограммы не повторно запускала устаревшую подсказку. Claude Code устанавливает ограничение в один час сам, когда перезагружает сбойный сеанс [представления агента](/docs/ru/agent-view), который унаследовал свой разговор из интерактивного сеанса. Требует Claude Code версии 2.1.211 или позже |

359| `CLAUDE_CODE_RESUME_PROMPT` | Переопределить сообщение продолжения, введенное при возобновлении сеанса, который завершился в середине хода. По умолчанию `Continue from where you left off.`. Скрипты порождения для долгоживущих агентов могут установить это на более директивное сообщение загрузки. Пустая строка использует значение по умолчанию |360| `CLAUDE_CODE_RESUME_PROMPT` | Переопределить сообщение продолжения, введённое при возобновлении сеанса, который закончился в середине хода. По умолчанию `Continue from where you left off.`. Скрипты порождения для долгоживущих агентов могут установить это на более директивное сообщение загрузки. Пустая строка использует значение по умолчанию |

360| `CLAUDE_CODE_RETRY_WATCHDOG` | Установите `1` для неконтролируемых сеансов, таких как harnesses eval, CI jobs или удаленные рабочие. Повторяет ошибки емкости `429` и `529` неопределенно вместо отказа после попыток `CLAUDE_CODE_MAX_RETRIES`. Claude Code завершается сразу, когда запрос стандартной скорости получает `429`, который сообщает об ограничении расходов или исчерпанных кредитах использования, даже один из [ограничения расходов шлюза](/docs/ru/errors#spend-limit-reached), который сбрасывается по расписанию. До версии 2.1.239 сторожевой таймер повторял эти неопределенно. Для запросов fast mode см. [Обработка ограничений скорости](/docs/ru/fast-mode#handle-rate-limits). Сторожевой таймер отступает до 5 минут между попытками или до сброса ограничения, когда ответ несет время сброса ограничения скорости, поэтому сеанс, который попадает на ограничение использования, ждет оставшегося окна. На версии 2.1.199 или позже он также повышает количество повторов по умолчанию для других переходных ошибок, таких как ошибки сервера, таймауты и отброшенные подключения, до 300, примерно три часа отступления, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. Требует Claude Code версии 2.1.186 или позже |361| `CLAUDE_CODE_RETRY_WATCHDOG` | Установите на `1` для неконтролируемых сеансов, таких как оценочные средства, задачи CI или удалённые рабочие. Повторяет ошибки ёмкости `429` и `529` бесконечно вместо отказа после попыток `CLAUDE_CODE_MAX_RETRIES`. Claude Code не выполняется сразу, когда запрос стандартной скорости получает `429`, который сообщает об ограничении расходов или исчерпанных кредитах использования, даже один из [ограничения расходов шлюза](/docs/ru/errors#spend-limit-reached), который сбрасывается по расписанию. До версии 2.1.239 сторож повторял эти бесконечно. Для запросов быстрого режима см. [Обработка ограничений скорости](/docs/ru/fast-mode#handle-rate-limits). Сторож отступает до 5 минут между попытками или до сброса ограничения, когда ответ несёт время сброса ограничения скорости, поэтому сеанс, который попадает на ограничение использования, ждёт оставшегося окна. На версии 2.1.199 или позже он также повышает количество повторов по умолчанию для других переходных ошибок, таких как ошибки сервера, таймауты и отброшенные подключения, до 300, примерно три часа отступления, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. Требует Claude Code версии 2.1.186 или позже |

361| `CLAUDE_CODE_SAFE_MODE` | Установите `1` для запуска в безопасном режиме: CLAUDE.md, skills, плагины, hooks, серверы MCP, пользовательские команды и агенты, стили вывода, workflows, пользовательские темы, пользовательские сочетания клавиш, команды строки состояния и предложения файлов, серверы LSP и автоматическая память не загружаются для устранения неполадок сломанной конфигурации. Политика управляемых параметров по-прежнему применяется, включая hooks, настроенные политикой, строку состояния и команды предложения файлов; управляемые плагины, управляемые skills, управляемые CLAUDE.md и серверы MCP, настроенные политикой, не загружаются. Эквивалентно передаче [`--safe-mode`](/docs/ru/cli-reference#cli-flags). Непосредственно порожденные дочерние процессы наследуют переменную |362| `CLAUDE_CODE_SAFE_MODE` | Установите на `1`, чтобы запустить в безопасном режиме: CLAUDE.md, skills, плагины, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, workflows, пользовательские темы, пользовательские сочетания клавиш, команды строки состояния и предложения файлов, LSP серверы и автоматическая память не загружаются для устранения неполадок сломанной конфигурации. Политика управляемых параметров по-прежнему применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые плагины, управляемые skills, управляемые CLAUDE.md и настроенные политикой MCP серверы не загружаются. Эквивалентно передаче [`--safe-mode`](/docs/ru/cli-reference#cli-flags). Непосредственно порождённые дочерние процессы наследуют переменную |

362| `CLAUDE_CODE_SCRIPT_CAPS` | Объект JSON, ограничивающий, сколько раз конкретные скрипты могут быть вызваны за сеанс, когда установлен `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Ключи — это подстроки, сопоставленные с текстом команды; значения — это ограничения количества вызовов. Например, `{"deploy.sh": 2}` позволяет `deploy.sh` быть вызванным максимум дважды. Сопоставление основано на подстроке, поэтому трюки расширения оболочки, такие как `./scripts/deploy.sh $(evil)`, по-прежнему считаются против ограничения. Разветвление во время выполнения через `xargs` или `find -exec` не обнаруживается; это контроль защиты в глубину |363| `CLAUDE_CODE_SCRIPT_CAPS` | JSON объект, ограничивающий, сколько раз конкретные скрипты могут быть вызваны за сеанс, когда установлен `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Ключи — это подстроки, совпадающие с текстом команды; значения — это ограничения количества вызовов. Например, `{"deploy.sh": 2}` позволяет `deploy.sh` быть вызванным максимум дважды. Совпадение основано на подстроке, поэтому трюки расширения оболочки, такие как `./scripts/deploy.sh $(evil)`, по-прежнему считаются против ограничения. Веерное расширение во время выполнения через `xargs` или `find -exec` не обнаруживается; это контроль защиты в глубину |

363| `CLAUDE_CODE_SCROLL_SPEED` | Установить множитель скорости прокрутки колеса мыши в [полноэкранном рендеринге](/docs/ru/fullscreen#mouse-wheel-scrolling). Принимает любое положительное значение до 20, включая дробные значения ниже 1, такие как `0.5`, для замедления ускоренной прокрутки трекпада и колеса в терминалах, которые уже усиливают события колеса. Установите `3` для соответствия `vim`, если ваш терминал отправляет одно событие колеса за выемку без усиления. Игнорируется в интегрированном терминале JetBrains IDE, где Claude Code использует свою собственную обработку прокрутки |364| `CLAUDE_CODE_SCROLL_SPEED` | Установить множитель скорости прокрутки колеса мыши в [полноэкранном рендере](/docs/ru/fullscreen#mouse-wheel-scrolling). Принимает любое положительное значение до 20, включая дробные значения ниже 1, такие как `0.5`, чтобы замедлить ускоренную прокрутку трекпада и колеса в терминалах, которые уже усиливают события колеса. Установите на `3`, чтобы совпадать с `vim`, если ваш терминал отправляет одно событие колеса за зубец без усиления. Игнорируется в интегрированном терминале JetBrains IDE, где Claude Code использует свою собственную обработку прокрутки |

364| `CLAUDE_CODE_SEND_FEEDBACK` | Установите `0` для отключения [обратной связи, составленной Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior) для сеанса. Установите `1` для включения там, где ваша учетная запись уже имеет доступ; переменная не может предоставить доступ сама, и другие переключатели, которые отключают обратную связь, такие как `DISABLE_FEEDBACK_COMMAND` и значение `off` параметра [`feedbackDrafts`](/docs/ru/settings-reference#feedbackdrafts), по-прежнему применяются |365| `CLAUDE_CODE_SEND_FEEDBACK` | Установите на `0`, чтобы отключить [отзывы, составленные Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior) для сеанса. Установите на `1`, чтобы включить это там, где ваша учётная запись уже имеет доступ; переменная не может предоставить доступ сама, и другие переключатели, которые отключают отзывы, такие как `DISABLE_FEEDBACK_COMMAND` и значение `off` параметра [`feedbackDrafts`](/docs/ru/settings-reference#feedbackdrafts), по-прежнему применяются |

365| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Переопределить бюджет времени в миллисекундах для [SessionEnd](/docs/ru/hooks#sessionend) hooks. Значение также является таймаутом для каждого hook, который не устанавливает свой собственный `timeout`. Применяется к выходу сеанса, `/clear` и переключению сеансов через интерактивный `/resume`. По умолчанию бюджет составляет 1.5 секунды, автоматически повышается до наивысшего настроенного `timeout` для каждого hook в файлах параметров, до 60 секунд. Таймауты на hooks, предоставленные плагинами, не повышают бюджет |366| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Переопределить бюджет времени в миллисекундах для [SessionEnd](/docs/ru/hooks#sessionend) hooks. Значение также является таймаутом для каждого hook, который не устанавливает свой собственный `timeout`. Применяется к выходу сеанса, `/clear` и переключению сеансов через интерактивный `/resume`. По умолчанию бюджет составляет 1.5 секунды, автоматически повышается до наивысшего настроенного `timeout` для каждого hook в файлах параметров, до 60 секунд. Таймауты на hooks, предоставленные плагинами, не повышают бюджет |

366| `CLAUDE_CODE_SESSION_ID` | Установите автоматически на текущий ID сеанса в подпроцессах инструментов Bash и PowerShell, подпроцессах [hook command](/docs/ru/hooks) и подпроцессах [MCP server](/docs/ru/mcp) stdio. Для Bash, PowerShell и hooks это соответствует полю `session_id` в входных данных JSON hook и обновляется на `/clear`. Подпроцесс сервера MCP сохраняет ID, с которым он был порожден. На `--resume <session-id>` он получает возобновленный ID, соответствующий hooks и Bash. На `--continue` или `--resume` без явного ID он может получить начальный ID запуска вместо этого. Используйте для корреляции скриптов и внешних инструментов с сеансом Claude Code, который их запустил |367| `CLAUDE_CODE_SESSION_ID` | Установлено автоматически на текущий ID сеанса в подпроцессах инструментов Bash и PowerShell, подпроцессах [команды hook](/docs/ru/hooks) и подпроцессах [MCP сервера](/docs/ru/mcp) stdio. Для Bash, PowerShell и hooks это совпадает с полем `session_id` в входных данных JSON hook и обновляется на `/clear`. Подпроцесс MCP сервера сохраняет ID, с которым он был порождён. На `--resume <session-id>` он получает возобновленный ID, совпадающий с hooks и Bash. На `--continue` или `--resume` без явного ID он может получить начальный ID запуска вместо этого. Используйте для корреляции скриптов и внешних инструментов с сеансом Claude Code, который их запустил |

367| `CLAUDE_CODE_SHELL` | Установить оболочку, которую Claude Code использует для запуска команд инструмента Bash. Принимает путь к двоичному файлу `bash` или `zsh`, например `/opt/homebrew/bin/bash`. Другие оболочки, такие как `fish`, не поддерживаются. Если значение не является рабочим путем `bash` или `zsh`, Claude Code игнорирует его и возвращается к автоопределению. Автоопределение использует ваш `$SHELL`, когда он указывает на `bash` или `zsh`, в противном случае он выбирает первый рабочий `zsh`, затем `bash`, найденный на вашем `PATH` и стандартных местах установки |368| `CLAUDE_CODE_SHELL` | Установить оболочку, которую Claude Code использует для запуска команд инструмента Bash. Принимает путь к двоичному файлу `bash` или `zsh`, например `/opt/homebrew/bin/bash`. Другие оболочки, такие как `fish`, не поддерживаются. Если значение не является рабочим путём `bash` или `zsh`, Claude Code игнорирует его и возвращается к автоопределению. Автоопределение использует ваш `$SHELL`, когда он указывает на `bash` или `zsh`, в противном случае он выбирает первый рабочий `zsh`, затем `bash`, найденный на вашем `PATH` и стандартных местах установки |

368| `CLAUDE_CODE_SHELL_PREFIX` | Префикс команды, который оборачивает команды оболочки, которые Claude Code порождает: вызовы инструмента Bash, [hook](/docs/ru/hooks) команды, [status line](/docs/ru/statusline) команды и команды запуска [MCP server](/docs/ru/mcp) stdio. Hooks PowerShell и hooks в форме exec работают без префикса. Полезно для логирования или аудита. Установка пути к простому исполняемому файлу, такого как `/path/to/logger.sh`, запускает каждую команду как `/path/to/logger.sh '<command>'`. Обертка получает командную строку как один аргумент, заключенный в кавычки оболочки, в `$1`, поэтому обертка должна повторно оценить `$1` с помощью оболочки, например `exec bash -c "$1"`. Обработка `$1` как пути к простому исполняемому файлу нарушает серверы MCP stdio, которые передают аргументы, такие как `npx -y <package>`. Для вызовов инструмента Bash `$1` содержит полный вызов оболочки, который Claude Code собирает, включая настройку окружения, а не только команду, которую запустил Claude |369| `CLAUDE_CODE_SHELL_PREFIX` | Префикс команды, который оборачивает команды оболочки, которые Claude Code порождает: вызовы инструмента Bash, команды [hook](/docs/ru/hooks), команды [строки состояния](/docs/ru/statusline) и команды запуска [MCP сервера](/docs/ru/mcp) stdio. Hooks PowerShell и hooks в форме exec работают без префикса. Полезно для логирования или аудита. Установка пути к голому исполняемому файлу, такому как `/path/to/logger.sh`, запускает каждую команду как `/path/to/logger.sh '<command>'`. Обёртка получает командную строку как один аргумент, заключённый в кавычки оболочки, в `$1`, поэтому обёртка должна повторно оценить `$1` с оболочкой, например `exec bash -c "$1"`. Обработка `$1` как пути к голому исполняемому файлу нарушает серверы stdio MCP, которые передают аргументы, такие как `npx -y <package>`. Для вызовов инструмента Bash `$1` содержит полный вызов оболочки, который Claude Code собирает, включая настройку окружения, а не только команду, которую запустил Claude |

369| `CLAUDE_CODE_SIMPLE` | Установите `1` для запуска с минимальной системной подсказкой и только инструментами Bash, чтения файлов и редактирования файлов. Инструменты MCP из `--mcp-config` по-прежнему доступны. Отключает автоопределение hooks, skills, пользовательских команд, subagents, плагинов, серверов MCP, автоматической памяти и CLAUDE.md. Skills в каталоге, который вы передаете с помощью `--add-dir`, по-прежнему загружаются. Токены OAuth и учетные данные цепочки ключей не читаются, поэтому аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалентно передаче [`--bare`](/docs/ru/headless#start-faster-with-bare-mode) |370| `CLAUDE_CODE_SIMPLE` | Установите на `1`, чтобы запустить с минимальной системной подсказкой и только инструментами Bash, чтения файлов и редактирования файлов. Инструменты MCP из `--mcp-config` по-прежнему доступны. Отключает автоопределение hooks, skills, пользовательских команд, подагентов, плагинов, MCP серверов, автоматической памяти и CLAUDE.md. Skills в каталоге, который вы передаёте с помощью `--add-dir`, по-прежнему загружаются. Токены OAuth и учётные данные цепочки ключей не читаются, поэтому аутентификация Anthropic должна поступать из `ANTHROPIC_API_KEY` или `apiKeyHelper` в `--settings`. Эквивалентно передаче [`--bare`](/docs/ru/headless#start-faster-with-bare-mode) |

370| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Установите `1` для использования более короткой системной подсказки и сокращенных описаний инструментов на любой модели. Установите `0`, `false`, `no` или `off` для отказа даже на моделях, где эксперимент или конфигурация сервера иначе включили бы это. Полный набор инструментов, обнаружение hooks, серверы MCP и обнаружение CLAUDE.md остаются включенными |371| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Установите на `1`, чтобы использовать более короткую системную подсказку и сокращённые описания инструментов на любой модели. Установите на `0`, `false`, `no` или `off`, чтобы отказаться, даже если эксперимент или конфигурация сервера в противном случае включили бы это. Полный набор инструментов, hooks, MCP серверы и обнаружение CLAUDE.md остаются включёнными |

371| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропустить аутентификацию на стороне клиента для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), для шлюзов, которые подписывают запросы сами |372| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Пропустить аутентификацию на стороне клиента для [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), для шлюзов, которые подписывают запросы сами |

372| `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 версии 2.1.207 или позже |373| `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 версии 2.1.207 или позже |

373| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock (например, при использовании LLM gateway) |374| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock (например, при использовании LLM gateway) |

374| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Установите `1` для обработки неудачной проверки доступности [fast mode](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) как доступной для сетей, которые блокируют прямой запрос проверки на `api.anthropic.com`. Claude Code по-прежнему соблюдает ответ "отключено вашей организацией" |375| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Установите на `1`, чтобы обработать неудачную проверку доступности [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) как доступную для сетей, которые блокируют прямой запрос проверки к `api.anthropic.com`. Claude Code по-прежнему соблюдает ответ "отключено вашей организацией" |

375| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Установите `1` для пропуска проверки доступности [fast mode](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) на стороне клиента для прокси, которые перехватывают запрос проверки, а не отказывают в нем. API по-прежнему отклоняет запросы fast mode, когда ваша организация отключила fast mode |376| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Установите на `1`, чтобы пропустить проверку доступности [быстрого режима](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) на стороне клиента для прокси, которые перехватывают запрос проверки, а не отказывают в нём. API по-прежнему отклоняет запросы быстрого режима, когда ваша организация отключила быстрый режим |

376| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry для прокси или шлюза, который вводит свой собственный заголовок `Authorization`. Claude Code отправляет запросы без учетных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например через `ANTHROPIC_CUSTOM_HEADERS`. Игнорируется, когда установлены `ANTHROPIC_FOUNDRY_API_KEY` или `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. До версии 2.1.203 эта переменная оставляла клиент Microsoft Foundry неспособным отправлять запросы, если ключ API также не был установлен |377| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Пропустить аутентификацию Azure для Microsoft Foundry, для прокси или шлюза, который вводит свой собственный заголовок `Authorization`. Claude Code отправляет запросы без учётных данных Azure и сохраняет заголовок `Authorization`, который вы предоставляете, например, через `ANTHROPIC_CUSTOM_HEADERS`. Игнорируется, когда установлены `ANTHROPIC_FOUNDRY_API_KEY` или `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. До версии 2.1.203 эта переменная оставляла клиент Microsoft Foundry неспособным отправлять запросы, если ключ API также не был установлен |

377| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании LLM gateway) |378| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Пропустить аутентификацию AWS для Amazon Bedrock Mantle (например, при использовании LLM gateway) |

378| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите `1` для пропуска записи истории подсказок и стенограмм сеансов на диск. Сеансы, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории стрелок вверх. Полезно для эфемерных скриптовых сеансов |379| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Установите на `1`, чтобы пропустить запись истории подсказок и стенограмм сеансов на диск. Сеансы, запущенные с этой переменной, не появляются в `--resume`, `--continue` или истории со стрелкой вверх. Полезно для эфемерных скриптовых сеансов |

379| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Google Cloud's Agent Platform (например, при использовании LLM gateway) |380| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Пропустить аутентификацию Google для Google Cloud's Agent Platform (например, при использовании LLM gateway) |

380| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Установите `1` для того, чтобы сеанс, запущенный с `--output-format stream-json`, написал [сообщение результата, называющее причину отказа Claude Code в запуске](/docs/ru/agent-sdk/typescript#startup_failure_reason) для сбоев запуска, которые иначе заканчиваются только stderr. Требует Claude Code версии 2.1.274 или позже |381| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Установите на `1`, чтобы сеанс, запущенный с `--output-format stream-json`, написал [сообщение результата, называющее, почему Claude Code отказался запустить](/docs/ru/agent-sdk/typescript#startup_failure_reason) для отказов при запуске, которые в противном случае заканчиваются только stderr. Требует Claude Code версии 2.1.274 или позже |

381| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Максимальное количество последовательных раз, когда [Stop](/docs/ru/hooks#stop) или [SubagentStop](/docs/ru/hooks#subagentstop) hook может блокировать завершение хода перед тем, как Claude Code переопределит его и завершит ход в любом случае (по умолчанию: 8). Установите `0` для отключения ограничения. Повысьте это, если ваш hook законно требует больше итераций для разрешения |382| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Максимальное количество последовательных раз, когда [Stop](/docs/ru/hooks#stop) или [SubagentStop](/docs/ru/hooks#subagentstop) hook может блокировать завершение хода перед тем, как Claude Code переопределит его и завершит ход в любом случае (по умолчанию: 8). Установите на `0`, чтобы отключить ограничение. Повысьте это, если ваш hook законно нуждается в большем количестве итераций для разрешения |

382| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [subagents](/docs/ru/sub-agents#choose-a-model), товарищей [команды агентов](/docs/ru/agent-teams#specify-teammates-and-models) и [workflow](/docs/ru/workflows) агентов, которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Два источника имеют приоритет над ним: модель, которую Claude передает при порождении агента, и поле `model` в определении агента, включая `inherit`. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model). См. [Выбрать модель](/docs/ru/sub-agents#choose-a-model) для полного порядка. Установка его на `inherit` — это то же самое, что оставить его неустановленным. До версии 2.1.251 эта переменная переопределяла как модель для каждого вызова, так и поле `model` определения |383| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [подагентов](/docs/ru/sub-agents#choose-a-model), товарищей [команды агентов](/docs/ru/agent-teams#specify-teammates-and-models) и агентов [workflow](/docs/ru/workflows), которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Два источника имеют приоритет над ней: модель, которую Claude передаёт при порождении агента, и поле `model` в определении агента, включая `inherit`. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model). См. [Выбрать модель](/docs/ru/sub-agents#choose-a-model) для полного порядка. Установка на `inherit` — это то же самое, что оставить её не установленной. До версии 2.1.251 эта переменная переопределяла как модель для каждого вызова, так и поле `model` определения |

383| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Установите `1` для принудительного применения одной модели к subagents, товарищам и агентам workflow. [Запустить каждый subagent на одной модели](/docs/ru/sub-agents#run-every-subagent-on-one-model) говорит, какая модель это. Требует Claude Code версии 2.1.257 или позже |384| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Установите на `1`, чтобы принудительно применить одну модель к подагентам, товарищам и агентам workflow. [Запустить каждый подагент на одной модели](/docs/ru/sub-agents#run-every-subagent-on-one-model) говорит, какая это модель. Требует Claude Code версии 2.1.257 или позже |

384| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, для выбора [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для запросов вне основного разговора, таких как [subagents](/docs/ru/sub-agents), workflows и фоновая работа. Имеет приоритет над параметром `subagentPromptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет его. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |385| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Установите `5m` или `1h`, единственные значения, которые Claude Code принимает, чтобы выбрать [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) для запросов вне основного разговора, таких как [подагенты](/docs/ru/sub-agents), workflows и фоновая работа. Имеет приоритет над параметром `subagentPromptCacheTtl` и над `ENABLE_PROMPT_CACHING_1H`, и `FORCE_PROMPT_CACHING_5M` переопределяет его. API выставляет счета за записи кэша на 1 час по более высокой ставке. Требует Claude Code версии 2.1.242 или позже |

385| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите `1` для удаления учетных данных из окружений подпроцессов (инструмент Bash, hooks, серверы MCP stdio): учетные данные Anthropic и облачного поставщика, любая другая переменная, которую Claude Code распознает как учетные данные, и учетные данные, встроенные в URL реестра пакетов. Родительский процесс Claude сохраняет эти учетные данные для вызовов API, но дочерние процессы не могут их читать, снижая воздействие атак внедрения подсказок, которые пытаются экспортировать секреты через расширение оболочки. На версии 2.1.251 или позже скраб также удаляет переменные указателя хранилища конфигурации Claude Code (такие как `CLAUDE_CONFIG_DIR`), поэтому дочерний процесс не может найти перемещенный каталог конфигурации. Оставьте скраб неустановленным, если подпроцесс нуждается в этих переменных. На Linux это также запускает подпроцессы Bash в изолированном пространстве имен PID, поэтому они не могут читать окружения хост-процессов через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать хост-процессам. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |386| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Установите на `1`, чтобы удалить учётные данные из окружений подпроцессов (инструмент Bash, hooks, серверы stdio MCP): учётные данные Anthropic и облачного поставщика, любую другую переменную, которую Claude Code распознаёт как учётные данные, и учётные данные, встроенные в URL реестра пакетов. Родительский процесс Claude сохраняет эти учётные данные для вызовов API, но дочерние процессы не могут их читать, уменьшая воздействие атак внедрения подсказок, которые пытаются экспортировать секреты через расширение оболочки. На версии 2.1.251 или позже скраб также удаляет переменные указателя хранилища конфигурации Claude Code (такие как `CLAUDE_CONFIG_DIR`), поэтому дочерний процесс не может найти переместённый каталог конфигурации. Оставьте скраб не установленным, если подпроцесс нуждается в этих переменных. На Linux это также запускает подпроцессы Bash в изолированном пространстве имён PID, поэтому они не могут читать окружения хост-процессов через `/proc`; как побочный эффект, `ps`, `pgrep` и `kill` не могут видеть или сигнализировать хост-процессам. `claude-code-action` устанавливает это автоматически, когда настроен `allowed_non_write_users` |

386| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Установите `1` в неинтерактивном режиме (флаг `-p`) для ожидания завершения установки плагина перед первым запросом. Без этого плагины устанавливаются в фоновом режиме и могут быть недоступны на первом ходе. Объедините с `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` для ограничения ожидания |387| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Установите на `1` в неинтерактивном режиме (флаг `-p`), чтобы ждать завершения установки плагина перед первым запросом. Без этого плагины устанавливаются в фоне и могут быть недоступны на первом ходу. Объедините с `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`, чтобы ограничить ожидание |

387| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для синхронной установки плагина. При превышении Claude Code продолжает без плагинов и логирует ошибку. Нет значения по умолчанию: без этой переменной синхронная установка ждет до завершения |388| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для синхронной установки плагина. При превышении Claude Code продолжает без плагинов и логирует ошибку. Нет значения по умолчанию: без этой переменной синхронная установка ждёт до завершения |

388| `CLAUDE_CODE_SYNC_SKILLS` | Установите `1` в неинтерактивном режиме с флагом `-p` для того, чтобы Claude Code загрузил skills, включенные для вашей учетной записи claude.ai в этом запуске, и ждал список их, до `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, перед запуском первого запроса. Сами загрузки завершаются в фоновом режиме, и Claude ждет загрузки skill, когда он его вызывает. Требует аутентификацию claude.ai. Сеансы терминала, где вы входите с вашей учетной записью claude.ai, [загружают эти skills](/docs/ru/skills#where-synced-skills-load) в `~/.claude/skills/synced/` и повторно синхронизируют примерно каждые 10 минут без этой переменной, поэтому установите ее только, когда запуск `-p` нуждается в ваших текущих skills на его первом запросе. До версии 2.1.273 сеансы терминала загружали их только в запуске `-p` с этой переменной. Имя папки `synced` [зарезервировано для этой загрузки](/docs/ru/skills#where-skills-live). До версии 2.1.227 skills загружались в `~/.claude/skills/` напрямую. Claude Code применяет [дополнительные правила к загруженным skills](/docs/ru/skills#how-synced-skills-behave), такие как отсутствие запуска их команд `!` на вашей машине |389| `CLAUDE_CODE_SYNC_SKILLS` | Установите на `1` в неинтерактивном режиме с флагом `-p`, чтобы Claude Code загрузил skills, включённые для вашей учётной записи claude.ai в этом запуске и ждал список их, до `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, перед запуском первого запроса. Сами загрузки завершаются в фоне, и Claude ждёт загрузки skill, когда его вызывает. Требует аутентификацию claude.ai. Сеансы терминала, где вы входите с вашей учётной записью claude.ai, [загружают эти skills](/docs/ru/skills#where-synced-skills-load) в `~/.claude/skills/synced/` и повторно синхронизируют примерно каждые 10 минут без этой переменной, поэтому установите её только, когда запуск `-p` нуждается в ваших текущих skills на его первом запросе. До версии 2.1.273 сеансы терминала загружали их только в запуске `-p` с этой переменной. Имя папки `synced` [зарезервировано для этой загрузки](/docs/ru/skills#where-skills-live). До версии 2.1.227 skills загружались в `~/.claude/skills/` напрямую. Claude Code применяет [дополнительные правила к загруженным skills](/docs/ru/skills#how-synced-skills-behave), такие как отсутствие запуска их команд `!` на вашей машине |

389| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для повторной синхронизации skills, которая работает в середине сеанса, когда приложение, построенное на [Agent SDK](/docs/ru/agent-sdk/typescript#query-object), перезагружает skills (по умолчанию: 30000). При превышении перезагрузка продолжается с какими бы skills ни прибыли, и оставшиеся загрузки завершаются в фоновом режиме |390| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Таймаут в миллисекундах для повторной синхронизации skills, которая работает в середине сеанса, когда приложение, построенное на [Agent SDK](/docs/ru/agent-sdk/typescript#query-object), перезагружает skills (по умолчанию: 30000). При превышении перезагрузка продолжает с какими бы skills ни прибыли, и оставшиеся загрузки завершаются в фоне |

390| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Таймаут в миллисекундах для первого запроса для ожидания начального списка skill, когда установлен `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 5000). При превышении первый запрос работает с какими бы skills ни прибыли. Загрузки завершаются в фоновом режиме в любом случае, и Claude ждет загрузки skill, когда он его вызывает |391| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Таймаут в миллисекундах для первого запроса, чтобы ждать начального списка skills, когда установлен `CLAUDE_CODE_SYNC_SKILLS` (по умолчанию: 5000). При превышении первый запрос работает с какими бы skills ни прибыли. Загрузки завершаются в фоне в любом случае, и Claude ждёт загрузки skill, когда его вызывает |

391| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Установите `false` для отключения подсветки синтаксиса в выводе diff. Полезно, когда цвета мешают вашей настройке терминала. Чтобы также отключить подсветку в блоках кода и предпросмотрах файлов, используйте параметр [`syntaxHighlightingDisabled`](/docs/ru/settings-reference#syntaxhighlightingdisabled) |392| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Установите на `false`, чтобы отключить подсветку синтаксиса в выводе diff. Полезно, когда цвета мешают вашей настройке терминала. Чтобы также отключить подсветку в блоках кода и предпросмотрах файлов, используйте параметр [`syntaxHighlightingDisabled`](/docs/ru/settings-reference#syntaxhighlightingdisabled) |

392| `CLAUDE_CODE_TASK_LIST_ID` | Поделиться списком задач между сеансами. Установите один и тот же ID в нескольких экземплярах Claude Code для координации на общем списке задач в [сеансах, которые имеют инструменты Task](/docs/ru/tools-reference#task-tool-availability). См. [Список задач](/docs/ru/interactive-mode#task-list) |393| `CLAUDE_CODE_TASK_LIST_ID` | Поделиться списком задач между сеансами. Установите один и тот же ID в несколько экземпляров Claude Code, чтобы координировать общий список задач в [сеансах, которые имеют инструменты Task](/docs/ru/tools-reference#task-tool-availability). См. [Список задач](/docs/ru/interactive-mode#task-list) |

393| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Переопределить в миллисекундах, как долго неинтерактивный сеанс ждет при выходе, пока его [команда агентов](/docs/ru/agent-teams) завершит разборку. Принимает 1000 до 60000; значение вне диапазона игнорируется и применяется значение по умолчанию 10000. Требует Claude Code версии 2.1.206 или позже |394| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Переопределить в миллисекундах, как долго неинтерактивный сеанс ждёт при выходе, пока его [команда агентов](/docs/ru/agent-teams) завершит разборку. Принимает 1000 до 60000; значение вне диапазона игнорируется и применяется значение по умолчанию 10000. Требует Claude Code версии 2.1.206 или позже |

394| `CLAUDE_CODE_TMPDIR` | Переопределить временный каталог, используемый для внутренних временных файлов. Claude Code добавляет `/claude-{uid}/` на Unix или `/claude/` на Windows к этому пути. По умолчанию: `/tmp` на macOS, `os.tmpdir()` на Linux и Windows. На macOS и Linux [изолированные](/docs/ru/sandboxing) подпроцессы Bash получают короткий резервный `$TMPDIR` под системным значением по умолчанию, когда ваше переопределение — это длинный путь, так как некоторые инструменты завершаются с ошибкой, когда пути временных файлов становятся слишком длинными. Неизолированные команды Bash наследуют `$TMPDIR` вашей оболочки без изменений. Собственные временные файлы Claude Code всегда используют ваше переопределение. Установите его в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |395| `CLAUDE_CODE_TMPDIR` | Переопределить временный каталог, используемый для внутренних временных файлов. Claude Code добавляет `/claude-{uid}/` на Unix или `/claude/` на Windows к этому пути. По умолчанию: `/tmp` на macOS, `os.tmpdir()` на Linux и Windows. На macOS и Linux [изолированные](/docs/ru/sandboxing) подпроцессы Bash получают короткий резервный `$TMPDIR` под системным значением по умолчанию, когда ваше переопределение — это длинный путь, так как некоторые инструменты не выполняются, когда пути временных файлов становятся слишком длинными. Неизолированные команды Bash наследуют `$TMPDIR` вашей оболочки, когда он установлен. Собственные временные файлы Claude Code всегда используют ваше переопределение. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

395| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите на любое непустое значение, такое как `1`, для разрешения вывода 24-битного truecolor внутри tmux. **Установка его на `0` или `false` по-прежнему разрешает truecolor**, в отличие от большинства переменных включения/отключения; отмените установку переменной для восстановления зажима 256 цветов. По умолчанию Claude Code зажимает до 256 цветов, когда установлен `$TMUX`, потому что tmux не пропускает последовательности escape truecolor, если не настроен. Установите это после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. См. [Конфигурация терминала](/docs/ru/terminal-config) для других параметров tmux |396| `CLAUDE_CODE_TMUX_TRUECOLOR` | Установите на любое непустое значение, такое как `1`, чтобы позволить вывод 24-битного truecolor внутри tmux. **Установка на `0` или `false` по-прежнему позволяет truecolor**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы восстановить зажим 256 цветов. По умолчанию Claude Code зажимает до 256 цветов, когда установлен `$TMUX`, потому что tmux не пропускает последовательности выхода truecolor, если не настроен. Установите это после добавления `set -ga terminal-overrides ',*:Tc'` в ваш `~/.tmux.conf`. См. [Конфигурация терминала](/docs/ru/terminal-config) для других параметров tmux |

396| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | На Linux и WSL установите на разделенный запятыми список видов процессов Claude Code [исключает из ограничения памяти инструмента](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), такие как `mcp` или `lsp`. Установите `none` для ограничения каждого вида или `all-new` для ограничения только команд инструментов Bash, PowerShell и Monitor. Claude Code сохраняет команды инструментов Bash, PowerShell и Monitor под ограничением, что бы вы ни перечислили. Требует Claude Code версии 2.1.246 или позже |397| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | На Linux и WSL установите на разделённый запятыми список видов процессов Claude Code [исключает из ограничения памяти инструмента](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), такие как `mcp` или `lsp`. Установите `none`, чтобы ограничить каждый вид, или `all-new`, чтобы ограничить только команды инструментов Bash, PowerShell и Monitor. Claude Code сохраняет команды инструментов Bash, PowerShell и Monitor под ограничением, что бы вы ни перечислили. Требует Claude Code версии 2.1.246 или позже |

397| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | На Linux и WSL установите на размер, такой как `4G`, для [ограничения памяти, которую могут использовать команды инструментов Bash и PowerShell](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), и команды инструмента Monitor на версии 2.1.246 или позже. Напишите размер в простых цифрах, отдельно для количества байтов или с суффиксом `K`, `M`, `G` или `T`. Установите `0` или `off` для отключения ограничения. После того, как первый процесс Claude Code запустил ограничение или отключил его, измененное значение вступает в силу при следующем запуске `claude`. Требует Claude Code версии 2.1.233 или позже |398| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | На Linux и WSL установите на размер, такой как `4G`, чтобы [ограничить память, которую команды инструментов Bash и PowerShell могут использовать](/docs/ru/tools-reference#memory-limit-on-linux-and-wsl), и команды инструмента Monitor на версии 2.1.246 или позже. Напишите размер в простых цифрах, одних для количества байтов или с суффиксом `K`, `M`, `G` или `T`. Установите `0` или `off`, чтобы отключить ограничение. После того, как первый процесс Claude Code запустил ограничение включённым или отключённым, изменённое значение вступает в силу при следующем запуске `claude`. Требует Claude Code версии 2.1.233 или позже |

398| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Крайний срок в миллисекундах перед тем, как Claude Code отменит диалоговое окно, которое оно пересылает удаленному клиенту, такому как [Remote Control](/docs/ru/remote-control) или хост SDK, или диалоговое окно одобрения для [удерживаемого кросс-сеансового сообщения](/docs/ru/cross-session-messaging#control-inbound-messages); запросы разрешений и вопросы `AskUserQuestion` используют свои собственные потоки и не управляются им. На Claude Code версии 2.1.236 или позже он также ограничивает подсказку согласия на использование кредитов [Fable](/docs/ru/model-config#fable-and-usage-credits) в сеансе, который может работать без присмотра. [Контроль входящих сообщений](/docs/ru/cross-session-messaging#control-inbound-messages) и [неинтерактивные сеансы](/docs/ru/cross-session-messaging#non-interactive-sessions) охватывают полные правила истечения удерживаемого сообщения, включая случаи, когда крайний срок не применяется. Переопределяет параметр [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry). `0` или отрицательное значение отключает крайний срок |399| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Крайний срок в миллисекундах перед тем, как Claude Code отменит диалоговое окно, которое оно пересылает удалённому клиенту, такому как [Remote Control](/docs/ru/remote-control) или хост SDK, или диалоговое окно одобрения для [удерживаемого кросс-сеансового сообщения](/docs/ru/cross-session-messaging#control-inbound-messages); запросы разрешений и вопросы `AskUserQuestion` используют свои собственные потоки и не управляются им. На Claude Code версии 2.1.236 или позже он также ограничивает запрос согласия на использование кредитов [Fable](/docs/ru/model-config#fable-and-usage-credits) в сеансе, который может работать без присмотра. [Контроль входящих сообщений](/docs/ru/cross-session-messaging#control-inbound-messages) и [неинтерактивные сеансы](/docs/ru/cross-session-messaging#non-interactive-sessions) охватывают полные правила истечения удерживаемого сообщения, включая случаи, когда крайний срок не применяется. Переопределяет параметр [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry). `0` или отрицательное значение отключает крайний срок |

399| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Использовать [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) |400| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Использовать [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) |

400| `CLAUDE_CODE_USE_BEDROCK` | Использовать [Amazon Bedrock](/docs/ru/amazon-bedrock) |401| `CLAUDE_CODE_USE_BEDROCK` | Использовать [Amazon Bedrock](/docs/ru/amazon-bedrock) |

401| `CLAUDE_CODE_USE_FOUNDRY` | Использовать [Microsoft Foundry](/docs/ru/microsoft-foundry) |402| `CLAUDE_CODE_USE_FOUNDRY` | Использовать [Microsoft Foundry](/docs/ru/microsoft-foundry) |

402| `CLAUDE_CODE_USE_MANTLE` | Использовать [конечную точку Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) Amazon Bedrock |403| `CLAUDE_CODE_USE_MANTLE` | Использовать [конечную точку Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) Amazon Bedrock |

403| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите `1` для обнаружения пользовательских команд, subagents и стилей вывода с использованием API файлов Node.js вместо ripgrep. Установите это, если встроенный двоичный файл ripgrep недоступен или заблокирован в вашем окружении. Не влияет на инструменты Grep или поиск файлов |404| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Установите на `1`, чтобы обнаруживать пользовательские команды, подагентов и стили вывода, используя API файлов Node.js вместо ripgrep. Установите это, если встроенный двоичный файл ripgrep недоступен или заблокирован в вашем окружении. Не влияет на инструменты Grep или поиск файлов |

404| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Контролирует инструмент PowerShell. На Windows без Git Bash инструмент включен автоматически; установите `0` для отключения. На Windows с установленным Git Bash инструмент включен по умолчанию для учетных записей claude.ai и Console; установите `1` для включения в сеансах Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry или `0` для отключения. На Linux, macOS и WSL установите `1` для включения, что требует `pwsh` на вашем `PATH`. Если включено на Windows, Claude может запускать команды PowerShell изначально вместо маршрутизации через Git Bash. См. [Инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) |405| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Контролирует инструмент PowerShell. На Windows без Git Bash инструмент включен автоматически; установите на `0`, чтобы отключить его. На Windows с установленным Git Bash инструмент включен по умолчанию для учётных записей claude.ai и Console; установите на `1`, чтобы включить его в сеансах Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, или `0`, чтобы отключить его. На Linux, macOS и WSL установите на `1`, чтобы включить его, что требует `pwsh` на вашем `PATH`. При включении на Windows Claude может запускать команды PowerShell изначально вместо маршрутизации через Git Bash. См. [Инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) |

405| `CLAUDE_CODE_USE_VERTEX` | Использовать [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |406| `CLAUDE_CODE_USE_VERTEX` | Использовать [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) |

406| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Установите на количество миллисекунд [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) сохраняет кэш ответа каждого полученного URL. По умолчанию `900000`, что составляет 15 минут. Принимает только простые цифры; `0`, десятичное число или любое другое написание сохраняет значение по умолчанию. Claude Code читает значение один раз за запуск, поэтому изменение в блоке параметров `env` применяется при следующем запуске `claude`. Требует Claude Code версии 2.1.233 или позже |407| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Установите на количество миллисекунд [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) сохраняет кэш ответа каждого полученного URL. По умолчанию `900000`, что составляет 15 минут. Принимает только простые цифры; `0`, десятичное число или любое другое написание сохраняет значение по умолчанию. Claude Code читает значение один раз за запуск, поэтому изменение в блоке параметров `env` применяется при следующем запуске `claude`. Требует Claude Code версии 2.1.233 или позже |

407| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Верхняя граница в миллисекундах того, как долго [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) ждет загрузки страницы, включая любые перенаправления, которые она следует. Загрузка, которая не завершена к этому времени, завершается с ошибкой крайнего срока. По умолчанию `300000`, что составляет пять минут. Установите `0` для удаления ограничения. Принимает только простые цифры; десятичное число или любое другое написание сохраняет значение по умолчанию. Требует Claude Code версии 2.1.268 или позже |408| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Верхняя граница в миллисекундах, как долго [WebFetch](/docs/ru/tools-reference#webfetch-tool-behavior) ждёт загрузки страницы, включая любые перенаправления, которые она следует. Загрузка, которая не завершена к этому времени, не выполняется с ошибкой крайнего срока. По умолчанию `300000`, что составляет пять минут. Установите на `0`, чтобы удалить ограничение. Принимает только простые цифры; десятичное число или любое другое написание сохраняет значение по умолчанию. Требует Claude Code версии 2.1.268 или позже |

408| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Сколько агентов один запуск [workflow](/docs/ru/workflows) выполняет одновременно, от `1` до `256`. По умолчанию запуск выполняет до 16 агентов одновременно, меньше, когда Claude Code имеет меньше доступных CPU; очередные вызовы `agent()` ждут свободного слота. Стенограмма каждого работающего агента остается в памяти Claude Code, поэтому более высокие значения повышают использование памяти. Принимает только простые цифры; значения вне диапазона и другие написания сохраняют значение по умолчанию. Требует Claude Code версии 2.1.269 или позже |409| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Сколько агентов один запуск [workflow](/docs/ru/workflows) выполняет одновременно, от `1` до `256`. По умолчанию запуск выполняет до 16 агентов одновременно, меньше, когда Claude Code имеет меньше доступных CPU; очередные вызовы `agent()` ждут свободного слота. Стенограмма каждого работающего агента остаётся в памяти Claude Code, поэтому более высокие значения повышают использование памяти. Принимает только простые цифры; значения вне диапазона и другие написания сохраняют значение по умолчанию. Требует Claude Code версии 2.1.269 или позже |

409| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Верхняя граница в миллисекундах того, как долго агент [workflow](/docs/ru/workflows) ждет, пока сиблинг с одинаковым префиксом начнет свой первый ответ, перед отправкой своего собственного первого запроса. Когда fan-out запускает несколько агентов, которые делят [префикс кэша подсказок](/docs/ru/workflows#prompt-caching-in-a-fan-out), Claude Code удерживает всех, кроме первого агента, до этого времени, чтобы остальные читали кэшированный префикс вместо каждого обработки его без кэша. По умолчанию `5000`. Установите `0` для отключения ожидания. Когда установлен `DISABLE_PROMPT_CACHING`, агенты никогда не ждут. Требует Claude Code версии 2.1.229 или позже |410| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Верхняя граница в миллисекундах, как долго агент [workflow](/docs/ru/workflows) ждёт первого ответа товарища с одинаковым префиксом перед отправкой своего собственного первого запроса. Когда веерное расширение запускает несколько агентов, которые делят [префикс кэша подсказок](/docs/ru/workflows#prompt-caching-in-a-fan-out), Claude Code удерживает всех, кроме первого агента, до этого времени, чтобы остальные читали кэшированный префикс вместо каждого обработки его без кэша. По умолчанию `5000`. Установите на `0`, чтобы отключить ожидание. Когда установлен `DISABLE_PROMPT_CACHING`, агенты никогда не ждут. Требует Claude Code версии 2.1.229 или позже |

410| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, история сеансов и плагины хранятся под этим путем. Для учетных данных см. [где Claude Code хранит учетные данные](/docs/ru/authentication#credential-management). Полезно для запуска нескольких учетных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Установите его в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |411| `CLAUDE_CONFIG_DIR` | Переопределить каталог конфигурации (по умолчанию: `~/.claude`). Все параметры, история сеансов и плагины хранятся под этим путём. Для учётных данных см. [где Claude Code хранит учётные данные](/docs/ru/authentication#credential-management). Полезно для запуска нескольких учётных записей рядом: например, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

411| `CLAUDE_DISABLE_ADOPT` | Установите `1` для остановки текущей фоновой работы вместо ее переноса, когда вы фоновый сеанс, нажав `←` или с [`/background`](/docs/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые иначе переносились бы. Требует Claude Code версии 2.1.195 или позже |412| `CLAUDE_DISABLE_ADOPT` | Установите на `1`, чтобы остановить текущую фоновую работу вместо её переноса, когда вы фоновый сеанс, нажав `←` или с [`/background`](/docs/ru/agent-view#from-inside-a-session). Claude Code просит вас подтвердить перед фоновым выполнением, затем останавливает задачи, которые в противном случае переносились бы. Требует Claude Code версии 2.1.195 или позже |

412| `CLAUDE_EFFORT` | Установите автоматически в подпроцессах инструмента Bash и команды hook на [уровень effort](/docs/ru/model-config#adjust-effort-level) в силе при запуске подпроцесса: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщает как `xhigh`. Соответствует полю `effort.level`, переданному [hooks](/docs/ru/hooks). Установлено только, когда текущая модель поддерживает параметр effort |413| `CLAUDE_EFFORT` | Установлено автоматически в подпроцессах инструмента Bash и командах hook на [уровень усилий](/docs/ru/model-config#adjust-effort-level), действующий при запуске подпроцесса: `low`, `medium`, `high`, `xhigh` или `max`. Ultracode не является отдельным уровнем и сообщается как `xhigh`. Совпадает с полем `effort.level`, переданным [hooks](/docs/ru/hooks). Установлено только, когда текущая модель поддерживает параметр усилий |

413| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите `1` для принудительного включения сторожевого таймера потока на уровне байтов или установите `0` для принудительного отключения. `0` также отключает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на подключениях, где этот крайний срок работает. Если не установлено, сторожевой таймер включен по умолчанию для прямых подключений API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), и для потоковых ответов на подключениях [gateway](/docs/ru/gateways), достигнутых через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`; до версии 2.1.222 он не работал на этих подключениях шлюза, поэтому сторожевой таймер на уровне событий мог сообщить о стагнации там, даже пока приходили пинги keep-alive. Для таймаутов и того, как таймеры взаимодействуют, см. [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) |414| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Установите на `1`, чтобы принудительно включить сторожа простоя потока на уровне байтов, или установите на `0`, чтобы принудительно отключить его. `0` также отключает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на подключениях, где этот крайний срок работает. Если не установлено, сторож включен по умолчанию для прямых подключений API Anthropic и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), и для потоковых ответов на подключениях [шлюза](/docs/ru/gateways), достигнутых через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`; до версии 2.1.222 он не работал на этих подключениях шлюза, поэтому сторож на уровне событий мог сообщить о стагнации там, даже если ping для поддержания соединения прибывали. Для таймаутов и того, как таймеры взаимодействуют, см. [Сторожи простоя потока](/docs/ru/network-config#streaming-idle-watchdogs) |

414| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите `1` для включения сторожевого таймера потока на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`, что также включает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на потоковых запросах Bedrock. Отключено по умолчанию. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |415| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Установите на `1`, чтобы включить сторожа простоя потока на уровне байтов на ответах Amazon Bedrock `vnd.amazon.eventstream`, что также включает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs) на потоковых запросах Bedrock. Отключено по умолчанию. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

415| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите `0` для принудительного отключения сторожевого таймера потока на уровне событий или установите `1` для принудительного включения. Если не установлено, сторожевой таймер включен по умолчанию для всех поставщиков. До версии 2.1.196 неустановленное значение по умолчанию было управляемым сервером на прямом API Anthropic и отключено на других поставщиках. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; для других таймаутов стагнации, которые работают рядом с этим, см. [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) |416| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Установите на `0`, чтобы принудительно отключить сторожа простоя потока на уровне событий, или установите на `1`, чтобы принудительно включить его. Если не установлено, сторож включен по умолчанию для всех поставщиков. До версии 2.1.196 значение по умолчанию без установки было управляемо сервером на прямом API Anthropic и отключено на других поставщиках. Настройте таймаут с помощью `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; для других таймеров стагнации, которые работают рядом с этим, см. [Сторожи простоя потока](/docs/ru/network-config#streaming-idle-watchdogs) |

416| `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 |417| `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 |

417| `CLAUDE_JOB_DIR` | Установите Claude Code в каждом [фоновом сеансе](/docs/ru/agent-view) на каталог `~/.claude/jobs/<id>` этого сеанса. Команды оболочки, которые сеанс запускает, наследуют его. Напишите временные файлы в [`$CLAUDE_JOB_DIR/tmp`](/docs/ru/agent-view#where-state-is-stored). Вызовы Claude `Write` и `Edit` там не запрашивают разрешение, и каталог удаляется при удалении сеанса |418| `CLAUDE_JOB_DIR` | Установлено Claude Code в каждом [фоновом сеансе](/docs/ru/agent-view) на каталог `~/.claude/jobs/<id>` этого сеанса. Команды оболочки, которые сеанс запускает, наследуют его. Напишите временные файлы в [`$CLAUDE_JOB_DIR/tmp`](/docs/ru/agent-view#where-state-is-stored). Вызовы `Write` и `Edit` Claude там не запрашивают разрешение, и каталог удаляется при удалении сеанса |

418| `CLAUDE_PID` | Claude Code устанавливает это на свой собственный ID процесса в подпроцессах, которые он порождает: команды инструментов Bash и PowerShell и команды hook. На Linux интеграция оболочки инструмента Bash использует его для отказа в шаблоне `pkill`, который соответствовал бы самому процессу Claude Code; см. [справку по ошибкам](/docs/ru/errors#pkill-pattern-matches-the-claude-code-process). Прочитайте его из своих собственных скриптов для определения или сигнализации родительскому процессу Claude Code намеренно. Требует Claude Code версии 2.1.214 или позже |419| `CLAUDE_PID` | Claude Code устанавливает это на свой собственный ID процесса в подпроцессах, которые он порождает: команды инструментов Bash и PowerShell и команды hook. На Linux интеграция оболочки инструмента Bash использует это, чтобы отказать шаблону `pkill`, который совпадал бы с самим процессом Claude Code; см. [справку по ошибкам](/docs/ru/errors#pkill-pattern-matches-the-claude-code-process). Прочитайте это из своих собственных скриптов, чтобы определить или сигнализировать родительский процесс Claude Code намеренно. Требует Claude Code версии 2.1.214 или позже |

419| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически созданных имен сеансов [Remote Control](/docs/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |420| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Префикс для автоматически создаваемых имён сеансов [Remote Control](/docs/ru/remote-control), когда явное имя не предоставлено. По умолчанию имя хоста вашей машины, создавая имена, такие как `myhost-graceful-unicorn`. Флаг CLI `--remote-control-session-name-prefix` устанавливает то же значение для одного вызова |

420| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Крайний срок в миллисекундах для первого байта ответа потокового запроса на подключениях, где работает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs). Для того, как Claude Code его зажимает, дополнительное время, которое он добавляет для больших тел запроса, и как он выбирает крайний срок, когда вы оставляете это неустановленным, см. [Нет ответа от API](/docs/ru/errors#no-response-from-api). Требует Claude Code версии 2.1.242 или позже |421| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Крайний срок в миллисекундах для первого байта ответа потокового запроса на подключениях, где работает [крайний срок первого байта](/docs/ru/network-config#streaming-idle-watchdogs). Для того, как Claude Code его зажимает, дополнительное время, которое он добавляет для больших тел запроса, и как он выбирает крайний срок, когда вы оставляете это не установленным, см. [Нет ответа от API](/docs/ru/errors#no-response-from-api). Требует Claude Code версии 2.1.242 или позже |

421| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах перед тем, как сторожевые таймеры потока на уровне событий и байтов закроют зависшее подключение. Когда вы явно устанавливаете эту переменную, минимум составляет `300000` (5 минут); более низкие значения молча зажимаются для поглощения пауз расширенного мышления и буферизации прокси, и сторожевой таймер на уровне байтов ограничивает значение до 30 минут. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` имеет приоритет над этой переменной для сторожевого таймера на уровне байтов. Для неустановленных значений по умолчанию для каждого сторожевого таймера см. [Потоковые сторожевые таймеры](/docs/ru/network-config#streaming-idle-watchdogs) |422| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Таймаут в миллисекундах перед тем, как сторожи простоя потока на уровне событий и байтов закроют зависшее подключение. Когда вы явно устанавливаете эту переменную, минимум составляет `300000` (5 минут); более низкие значения молча зажимаются, чтобы поглотить паузы расширенного мышления и буферизацию прокси, и сторож на уровне байтов ограничивает значение на 30 минут. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` имеет приоритет над этой переменной для сторожа на уровне байтов. Для значений по умолчанию без установки для каждого сторожа см. [Сторожи простоя потока](/docs/ru/network-config#streaming-idle-watchdogs) |

422| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Удалено в версии 2.1.260 и теперь не работает. Ранее ограничивало, как долго [фоновая команда оболочки](/docs/ru/interactive-mode#background-bash-commands), которую запустил [subagent](/docs/ru/sub-agents), могла работать, в миллисекундах, с 60-минутным значением по умолчанию. См. [правила времени жизни фоновой команды](/docs/ru/tools-reference#background-commands) |423| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Удалено в версии 2.1.260 и теперь не работает. Ранее ограничивало, как долго [фоновая команда оболочки](/docs/ru/interactive-mode#background-bash-commands), которую запустил [подагент](/docs/ru/sub-agents), могла работать, в миллисекундах, с 60-минутным значением по умолчанию. См. [правила времени жизни фоновой команды](/docs/ru/tools-reference#background-commands) |

423| `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:*`, установленные для других инструментов, не вызывают его |424| `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:*`, установленные для других инструментов, не срабатывают |

424| `DISABLE_AUTOUPDATER` | Установите `1` для отключения автоматических фоновых обновлений. Ручной `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES` для блокировки обоих |425| `DISABLE_AUTOUPDATER` | Установите на `1`, чтобы отключить автоматические фоновые обновления. Ручной `claude update` по-прежнему работает. Используйте `DISABLE_UPDATES`, чтобы заблокировать оба |

425| `DISABLE_AUTO_COMPACT` | Установите `1` для отключения автоматического компактирования при приближении к пределу контекста. Ручная команда `/compact` остается доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит компактирование. Переопределяет параметр [`autoCompactEnabled`](/docs/ru/settings-reference#autocompactenabled) |426| `DISABLE_AUTO_COMPACT` | Установите на `1`, чтобы отключить автоматическое компактирование при приближении к пределу контекста. Ручная команда `/compact` остаётся доступной. Используйте, когда вы хотите явный контроль над тем, когда происходит компактирование. Переопределяет параметр [`autoCompactEnabled`](/docs/ru/settings-reference#autocompactenabled) |

426| `DISABLE_COMPACT` | Установите `1` для отключения всего компактирования: как автоматического компактирования, так и ручной команды `/compact` |427| `DISABLE_COMPACT` | Установите на `1`, чтобы отключить все компактирование: как автоматическое компактирование, так и ручную команду `/compact` |

427| `DISABLE_COST_WARNINGS` | Установите `1` для отключения сообщений предупреждения о стоимости |428| `DISABLE_COST_WARNINGS` | Установите на `1`, чтобы отключить сообщения предупреждения о стоимости |

428| `DISABLE_DOCTOR_COMMAND` | Установите `1` для скрытия skill [`/doctor`](/docs/ru/commands#all-commands) проверки настройки и его псевдонима `/checkup`. Полезно для управляемых развертываний, где пользователи не должны запускать диагностику настройки из сеанса. Не влияет на команду терминала `claude doctor`. До версии 2.1.205 эта переменная скрывала экран диагностики `/doctor` |429| `DISABLE_DOCTOR_COMMAND` | Установите на `1`, чтобы скрыть skill [`/doctor`](/docs/ru/commands#all-commands) проверки настройки и его псевдоним `/checkup`. Полезно для управляемых развёртываний, где пользователи не должны запускать диагностику настройки из сеанса. Не влияет на команду терминала `claude doctor`. До версии 2.1.205 эта переменная скрывала экран диагностики `/doctor` |

429| `DISABLE_ERROR_REPORTING` | Установите на любое непустое значение, такое как `1`, для отказа от отчетов об ошибках. **Установка его на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной для повторного включения отчетов об ошибках |430| `DISABLE_ERROR_REPORTING` | Установите на любое непустое значение, такое как `1`, чтобы отказаться от отчётов об ошибках. **Установка на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы включить отчёты об ошибках обратно |

430| `DISABLE_EXTRA_USAGE_COMMAND` | Установите `1` для скрытия команды `/usage-credits`, которая позволяет пользователям покупать дополнительное использование сверх ограничений скорости |431| `DISABLE_EXTRA_USAGE_COMMAND` | Установите на `1`, чтобы скрыть команду `/usage-credits`, которая позволяет пользователям покупать дополнительное использование сверх ограничений скорости |

431| `DISABLE_FEEDBACK_COMMAND` | Установите `1` для отключения команды `/feedback` и [обратной связи, составленной Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior). Также отключает `/bug` и `/share`, которые сообщают через тот же путь; до версии 2.1.212 они были псевдонимами `/feedback`, поэтому команда была отключена под каждым именем. Также принимается старое имя `DISABLE_BUG_COMMAND` |432| `DISABLE_FEEDBACK_COMMAND` | Установите на `1`, чтобы отключить команду `/feedback` и [отзывы, составленные Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior). Также отключает `/bug` и `/share`, которые сообщают через тот же путь; до версии 2.1.212 они были псевдонимами `/feedback`, поэтому команда была отключена под каждым именем. Старое имя `DISABLE_BUG_COMMAND` также принимается |

432| `DISABLE_GROWTHBOOK` | Установите `1` или `true` для отключения получения флагов функций GrowthBook и использования кодовых значений по умолчанию для каждого флага. Это делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, требующие получения флагов функций](#features-that-need-feature-flag-fetching) недоступными. Установка его на `0` или `false` оставляет получение включенным. Логирование событий телеметрии остается включенным, если только `DISABLE_TELEMETRY` также не установлен |433| `DISABLE_GROWTHBOOK` | Установите на `1` или `true`, чтобы отключить получение флагов функций GrowthBook и использовать значения по умолчанию кода для каждого флага. Это делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, которые нуждаются в получении флагов функций](#features-that-need-feature-flag-fetching) недоступными. Установка на `0` или `false` оставляет получение включённым. Логирование событий телеметрии остаётся включённым, если только `DISABLE_TELEMETRY` также не установлен |

433| `DISABLE_INSTALLATION_CHECKS` | Установите `1` для отключения предупреждений об установке. Используйте только при ручном управлении местоположением установки, так как это может скрыть проблемы со стандартными установками |434| `DISABLE_INSTALLATION_CHECKS` | Установите на `1`, чтобы отключить предупреждения об установке. Используйте только при ручном управлении местоположением установки, так как это может скрыть проблемы со стандартными установками |

434| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Установите `1` для скрытия команды `/install-github-app`. Уже скрыта при использовании сторонних поставщиков (Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry) |435| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Установите на `1`, чтобы скрыть команду `/install-github-app`. Уже скрыта при использовании сторонних поставщиков (Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry) |

435| `DISABLE_INTERLEAVED_THINKING` | Установите `1` для предотвращения отправки заголовка бета-версии interleaved-thinking. Полезно, когда ваш LLM gateway или поставщик не поддерживает [interleaved thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |436| `DISABLE_INTERLEAVED_THINKING` | Установите на `1`, чтобы предотвратить отправку заголовка бета-версии чередующегося мышления. Полезно, когда ваш LLM шлюз или поставщик не поддерживает [чередующееся мышление](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

436| `DISABLE_LOGIN_COMMAND` | Установите `1` для скрытия команды `/login`. Полезно, когда аутентификация обрабатывается внешне через ключи API или `apiKeyHelper` |437| `DISABLE_LOGIN_COMMAND` | Установите на `1`, чтобы скрыть команду `/login`. Полезно, когда аутентификация обрабатывается внешне через ключи API или `apiKeyHelper` |

437| `DISABLE_LOGOUT_COMMAND` | Установите `1` для скрытия команды `/logout` |438| `DISABLE_LOGOUT_COMMAND` | Установите на `1`, чтобы скрыть команду `/logout` |

438| `DISABLE_PROMPT_CACHING` | Установите `1` для отключения [кэширования подсказок](/docs/ru/prompt-caching#disable-prompt-caching) для всех моделей (имеет приоритет над параметрами для каждой модели) |439| `DISABLE_PROMPT_CACHING` | Установите на `1`, чтобы отключить [кэширование подсказок](/docs/ru/prompt-caching#disable-prompt-caching) для всех моделей (имеет приоритет над параметрами для каждой модели) |

439| `DISABLE_PROMPT_CACHING_FABLE` | Установите `1` для отключения кэширования подсказок для моделей Fable |440| `DISABLE_PROMPT_CACHING_FABLE` | Установите на `1`, чтобы отключить кэширование подсказок для моделей Fable |

440| `DISABLE_PROMPT_CACHING_HAIKU` | Установите `1` для отключения кэширования подсказок для моделей Haiku |441| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1`, чтобы отключить кэширование подсказок для моделей Haiku |

441| `DISABLE_PROMPT_CACHING_OPUS` | Установите `1` для отключения кэширования подсказок для моделей Opus |442| `DISABLE_PROMPT_CACHING_OPUS` | Установите на `1`, чтобы отключить кэширование подсказок для моделей Opus |

442| `DISABLE_PROMPT_CACHING_SONNET` | Установите `1` для отключения кэширования подсказок для моделей Sonnet |443| `DISABLE_PROMPT_CACHING_SONNET` | Установите на `1`, чтобы отключить кэширование подсказок для моделей Sonnet |

443| `DISABLE_TELEMETRY` | Установите на любое непустое значение, такое как `1`, для отказа от телеметрии. **Установка его на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной для повторного включения телеметрии. События телеметрии не включают пользовательские данные, такие как код, пути файлов или команды bash. Также отключает получение флагов функций с тем же эффектом, что и `DISABLE_GROWTHBOOK`, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, требующие получения флагов функций](#features-that-need-feature-flag-fetching) недоступными. См. [Отключить телеметрию для вашей организации](/docs/ru/managed-settings#turn-telemetry-off-for-your-organization) |444| `DISABLE_TELEMETRY` | Установите на любое непустое значение, такое как `1`, чтобы отказаться от телеметрии. **Установка на `0` или `false` по-прежнему отказывает**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы включить телеметрию обратно. События телеметрии не включают пользовательские данные, такие как код, пути файлов или команды bash. Также отключает получение флагов функций с тем же эффектом, что и `DISABLE_GROWTHBOOK`, что делает [Remote Control](/docs/ru/remote-control#requirements) и другие [функции, которые нуждаются в получении флагов функций](#features-that-need-feature-flag-fetching) недоступными. См. [Отключить телеметрию для вашей организации](/docs/ru/managed-settings#turn-telemetry-off-for-your-organization) |

444| `DISABLE_UPDATES` | Установите `1` для блокировки всех обновлений, включая ручной `claude update` и `claude install`. Строже, чем `DISABLE_AUTOUPDATER`. Используйте при распределении Claude Code через ваши собственные каналы и пользователи не должны самостоятельно обновляться |445| `DISABLE_UPDATES` | Установите на `1`, чтобы заблокировать все обновления, включая ручной `claude update` и `claude install`. Строже, чем `DISABLE_AUTOUPDATER`. Используйте при распределении Claude Code через ваши собственные каналы и пользователи не должны самостоятельно обновляться |

445| `DISABLE_UPGRADE_COMMAND` | Установите `1` для скрытия команды `/upgrade` |446| `DISABLE_UPGRADE_COMMAND` | Установите на `1`, чтобы скрыть команду `/upgrade` |

446| `DO_NOT_TRACK` | Установите `1` для отказа от телеметрии с тем же эффектом, что и `DISABLE_TELEMETRY`, включая недоступность [Remote Control](/docs/ru/remote-control#requirements) и других [функций, требующих получения флагов функций](#features-that-need-feature-flag-fetching). Claude Code читает эту переменную как стандартный логический, поэтому `0` оставляет телеметрию включенной и соблюдает ее как кросс-инструментальное соглашение, признанное многими CLI разработчиков |447| `DO_NOT_TRACK` | Установите на `1`, чтобы отказаться от телеметрии, с тем же эффектом, что и `DISABLE_TELEMETRY`, включая недоступность [Remote Control](/docs/ru/remote-control#requirements) и других [функций, которые нуждаются в получении флагов функций](#features-that-need-feature-flag-fetching). Claude Code читает эту переменную как стандартный логический, поэтому `0` оставляет телеметрию включённой и соблюдает её как кросс-инструментальное соглашение, признанное многими CLI разработчиков |

447| `ENABLE_BETA_TRACING_DETAILED` | Установите `1` вместе с `BETA_TRACING_ENDPOINT` для включения [детального бета-трассирования](/docs/ru/monitoring-usage#traces-beta), которое добавляет атрибуты span, содержащие содержимое, и span `claude_code.hook`. Интерактивные сеансы CLI также требуют, чтобы ваша организация была в списке разрешений для бета-версии. Обе переменные игнорируются в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |448| `ENABLE_BETA_TRACING_DETAILED` | Установите на `1` вместе с `BETA_TRACING_ENDPOINT`, чтобы включить [детальное бета-трассирование](/docs/ru/monitoring-usage#traces-beta), которое добавляет атрибуты пролётов, несущие содержимое, и пролёт `claude_code.hook`. Интерактивные сеансы CLI также требуют, чтобы ваша организация была в списке разрешений для бета-версии. Обе переменные игнорируются в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env) |

448| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите `false` для остановки Claude Code от получения [серверов MCP claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai). Включено по умолчанию для вошедших в систему пользователей. Чтобы отключить для каждого проекта или организации, установите [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors) в параметрах вместо этого |449| `ENABLE_CLAUDEAI_MCP_SERVERS` | Установите на `false`, чтобы остановить Claude Code от получения [MCP серверов claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai). Включено по умолчанию для вошедших в систему пользователей. Чтобы отключить для каждого проекта или организации, установите [`disableClaudeAiConnectors`](/docs/ru/settings-reference#disableclaudeaiconnectors) в параметрах вместо этого |

449| `ENABLE_PROMPT_CACHING_1H` | Установите `1` для запроса [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) в 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 час автоматически на [основном разговоре](/docs/ru/prompt-caching#which-ttl-each-request-gets). Пользователи подписки, использующие [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), могут установить это для сохранения TTL в 1 час. Записи кэша на 1 час выставляются по более высокой ставке. Чтобы выбрать TTL для каждого ведра запроса вместо этого, используйте `CLAUDE_CODE_PROMPT_CACHE_TTL` и `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, которые имеют приоритет над этой переменной |450| `ENABLE_PROMPT_CACHING_1H` | Установите на `1`, чтобы запросить [TTL кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) в 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 час автоматически на [основном разговоре](/docs/ru/prompt-caching#which-ttl-each-request-gets). Пользователи подписки, использующие [кредиты использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), могут установить это, чтобы сохранить TTL в 1 час. Записи кэша на 1 час выставляются по более высокой ставке. Чтобы выбрать TTL для каждого ведра запроса вместо этого, используйте `CLAUDE_CODE_PROMPT_CACHE_TTL` и `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, которые имеют приоритет над этой переменной |

450| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |451| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Устарело. Используйте `ENABLE_PROMPT_CACHING_1H` вместо этого |

451| `ENABLE_TOOL_SEARCH` | Контролирует [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search). Если не установлено, Claude Code откладывает все инструменты MCP по умолчанию. Он по-прежнему загружает их заранее на моделях Google Cloud's Agent Platform ранее поколения Claude 4.5, на развертывании Microsoft Foundry, размещенном на Azure, и когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной. `true` всегда откладывает и отправляет заголовок бета-версии, за исключением этих же моделей Agent Platform и развертываний Microsoft Foundry; запросы завершаются на прокси, которые не поддерживают `tool_reference`. `auto` загружает заранее, когда определения инструментов подходят в пределах 10% контекста. `auto:N` устанавливает пользовательский порог, такой как `auto:5` для 5%. `false` загружает все инструменты заранее. Значение, которое вы устанавливаете сами, игнорируется, когда установлен `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. До версии 2.1.221 Claude Code отключал поиск инструментов для всех моделей на Google Cloud's Agent Platform, если вы не установили эту переменную на `true` |452| `ENABLE_TOOL_SEARCH` | Контролирует [поиск инструментов MCP](/docs/ru/mcp#scale-with-mcp-tool-search). Если не установлено, Claude Code откладывает все инструменты MCP по умолчанию. Он по-прежнему загружает их заранее на моделях Google Cloud's Agent Platform ранее поколения Claude 4.5, на развёртывании Microsoft Foundry, размещённом на Azure, и когда `ANTHROPIC_BASE_URL` указывает на хост, не являющийся первой стороной. `true` всегда откладывает и отправляет заголовок бета-версии, за исключением этих же моделей Agent Platform и развёртываний Microsoft Foundry; запросы не выполняются на прокси, которые не поддерживают `tool_reference`. `auto` загружает заранее, когда определения инструментов подходят в 10% контекста. `auto:N` устанавливает пользовательский порог, такой как `auto:5` для 5%. `false` загружает все инструменты заранее. Значение, которое вы установили сами, игнорируется, когда установлен `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. До версии 2.1.221 Claude Code отключал поиск инструментов для всех моделей на Google Cloud's Agent Platform, если вы не установили эту переменную на `true` |

452| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, такое как `1`, для того, чтобы Claude Code перестал повторять попытки при повторных ошибках перегрузки для каждой модели, когда не настроена резервная модель. **Установка его на `0` или `false` по-прежнему включает это**, в отличие от большинства переменных включения/отключения; отмените установку переменной для восстановления поведения повтора по умолчанию. Без этого Claude Code перестает повторять попытки таким образом на моделях, которые он распознает как модели Opus, Fable или Mythos, когда вы аутентифицируетесь с помощью ключа API или [сторонних поставщиков](/docs/ru/third-party-integrations), а не подписки Claude. На Claude Code версии 2.1.160 или позже Claude Code переключается на вашу настроенную [цепочку резервных моделей](/docs/ru/model-config#fallback-model-chains) при повторных ошибках перегрузки для любой основной модели, поэтому эта переменная не влияет на переключение на резервную модель |453| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Установите на любое непустое значение, такое как `1`, чтобы заставить Claude Code остановить повторные попытки при повторных ошибках перегрузки для каждой модели, когда не настроена модель резервного варианта. **Установка на `0` или `false` по-прежнему включает это**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы восстановить поведение повтора по умолчанию. Без этого Claude Code останавливает повторные попытки таким образом на моделях, которые он распознаёт как модели Opus, Fable или Mythos, когда вы аутентифицируетесь с помощью ключа API или [сторонним поставщиком](/docs/ru/third-party-integrations), а не подписки Claude. На Claude Code версии 2.1.160 или позже Claude Code переключается на вашу настроенную [цепочку модели резервного варианта](/docs/ru/model-config#fallback-model-chains) при повторных ошибках перегрузки для любой основной модели, поэтому эта переменная не влияет на переключение на модель резервного варианта |

453| `FORCE_AUTOUPDATE_PLUGINS` | Установите `1` для принудительного автоматического обновления плагинов даже при отключении основного автоматического обновления через `DISABLE_AUTOUPDATER` |454| `FORCE_AUTOUPDATE_PLUGINS` | Установите на `1`, чтобы принудительно обновить плагины, даже если основной автоматический обновитель отключен через `DISABLE_AUTOUPDATER` |

454| `FORCE_HYPERLINK` | Установите `1` для включения кликабельных гиперссылок OSC 8, когда ваш терминал их поддерживает, но не автоопределяется, или `0` для отключения. Если не установлено, Claude Code включает гиперссылки только при обнаружении поддержки терминала. Claude Code анализирует это значение как число, а не логический, поэтому значение, такое как `false`, `no` или `off`, включает гиперссылки, а не отключает их. Значок [статуса PR или merge request](/docs/ru/interactive-mode#pr-review-status) в нижнем колонтитуле отображается как гиперссылка даже при невозможности обнаружения поддержки терминала, например через SSH. Установите `0` для отображения значка как простого текста |455| `FORCE_HYPERLINK` | Установите на `1`, чтобы включить кликабельные гиперссылки OSC 8, когда ваш терминал их поддерживает, но не автоопределён, или `0`, чтобы отключить их. Если не установлено, Claude Code включает гиперссылки только, когда обнаруживает поддержку терминала. Claude Code анализирует это значение как число, а не логический, поэтому значение, такое как `false`, `no` или `off`, включает гиперссылки, а не отключает их. Значок [статуса PR или merge request](/docs/ru/interactive-mode#pr-review-status) в нижнем колонтитуле отображается как гиперссылка, даже когда Claude Code не может обнаружить поддержку терминала, например, через SSH. Установите `0`, чтобы отобразить значок как простой текст |

455| `FORCE_PROMPT_CACHING_5M` | Установите `1` для принудительного применения TTL кэша подсказок в 5 минут даже при применении TTL в 1 час. Переопределяет `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` и параметры `promptCacheTtl` и `subagentPromptCacheTtl` |456| `FORCE_PROMPT_CACHING_5M` | Установите на `1`, чтобы принудительно применить TTL кэша подсказок в 5 минут, даже когда TTL в 1 час в противном случае применялся бы. Переопределяет `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` и параметры `promptCacheTtl` и `subagentPromptCacheTtl` |

456| `HTTP_PROXY` | Укажите сервер HTTP прокси для сетевых подключений |457| `HTTP_PROXY` | Укажите сервер HTTP прокси для сетевых подключений |

457| `HTTPS_PROXY` | Укажите сервер HTTPS прокси для сетевых подключений |458| `HTTPS_PROXY` | Укажите сервер HTTPS прокси для сетевых подключений |

458| `IS_DEMO` | Установите на любое непустое значение, такое как `1`, для включения режима демонстрации: скрывает ваш адрес электронной почты и имя организации из заголовка и вывода `/status`, и пропускает onboarding. **Установка его на `0` или `false` по-прежнему включает режим демонстрации**, в отличие от большинства переменных включения/отключения; отмените установку переменной для отключения. Полезно при потоковой передаче или записи сеанса |459| `IS_DEMO` | Установите на любое непустое значение, такое как `1`, чтобы включить режим демонстрации: скрывает ваш адрес электронной почты и имя организации из заголовка и вывода `/status`, и пропускает адаптацию. **Установка на `0` или `false` по-прежнему включает режим демонстрации**, в отличие от большинства переменных включения/отключения; отмените установку переменной, чтобы отключить его. Полезно при потоковой передаче или записи сеанса |

459| `MAX_MCP_OUTPUT_TOKENS` | Максимальное количество токенов, разрешенных в ответах инструментов MCP. Claude Code отображает предупреждение, когда вывод превышает 10 000 токенов. Инструменты, которые объявляют [`anthropic/maxResultSizeChars`](/docs/ru/mcp#raise-the-limit-for-a-specific-tool), используют это ограничение символов для текстового содержимого вместо этого, но содержимое изображения из этих инструментов по-прежнему подлежит этой переменной (по умолчанию: 25000) |460| `MAX_MCP_OUTPUT_TOKENS` | Максимальное количество токенов, разрешённых в ответах инструментов MCP. Claude Code отображает предупреждение, когда вывод превышает 10,000 токенов. Инструменты, которые объявляют [`anthropic/maxResultSizeChars`](/docs/ru/mcp#raise-the-limit-for-a-specific-tool), используют это ограничение символов для текстового содержимого вместо этого, но содержимое изображения из этих инструментов по-прежнему подчиняется этой переменной (по умолчанию: 25000) |

460| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток Claude Code разрешает, когда ответ модели не проходит проверку против [`--json-schema`](/docs/ru/cli-reference#cli-flags) в неинтерактивном режиме с флагом `-p`; после такого количества неудачных попыток без действительного вывода запуск завершается. То же ограничение применяется, когда структурированный вывод [subagent workflow](/docs/ru/workflows) не проходит проверку. По умолчанию 5, первая попытка плюс четыре повтора |461| `MAX_STRUCTURED_OUTPUT_RETRIES` | Количество попыток Claude Code позволяет, когда ответ модели не выполняет проверку против [`--json-schema`](/docs/ru/cli-reference#cli-flags) в неинтерактивном режиме с флагом `-p`; после такого количества неудачных попыток без действительного вывода запуск не выполняется. То же ограничение применяется, когда структурированный вывод подагента [workflow](/docs/ru/workflows) не выполняет проверку. По умолчанию 5, первая попытка плюс четыре повтора |

461| `MAX_THINKING_TOKENS` | Фиксированный бюджет токенов для [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code ограничивает его одним токеном ниже максимального выходного токена запроса и никогда ниже 1,024. См. `CLAUDE_CODE_MAX_OUTPUT_TOKENS` для того, как устанавливается это ограничение. Если не установлено и мышление включено, модели с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) выбирают свою собственную глубину мышления, и другие модели используют ограничение. Установите `0` для отключения мышления на API Anthropic, за исключением моделей Fable, которые не могут иметь отключенное мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `0` пропускает параметр `thinking` вместо этого. При отключенном мышлении на API Anthropic Claude Code отправляет effort `high` вместо более высокого уровня на моделях, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5. Claude Code игнорирует ненулевые значения на моделях адаптивного рассуждения, за исключением моделей, где `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` отключает адаптивное рассуждение |462| `MAX_THINKING_TOKENS` | Фиксированный бюджет токенов для [расширенного мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code ограничивает его на один токен ниже максимального выходного токена запроса и никогда ниже 1,024. См. `CLAUDE_CODE_MAX_OUTPUT_TOKENS` для того, как устанавливается это ограничение. Если не установлено и мышление включено, модели с [адаптивным рассуждением](/docs/ru/model-config#adjust-effort-level) выбирают свою собственную глубину мышления, и другие модели используют ограничение. Установите на `0`, чтобы отключить мышление на API Anthropic, за исключением моделей Fable, которые не могут иметь отключённое мышление. На [сторонних поставщиках](/docs/ru/third-party-integrations) `0` опускает параметр `thinking` вместо этого. С отключённым мышлением на API Anthropic Claude Code отправляет усилие `high` вместо более высокого уровня на моделях, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5. Claude Code игнорирует ненулевые значения на моделях адаптивного рассуждения, за исключением моделей, где `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` отключает адаптивное рассуждение |

462| `MCP_CLIENT_SECRET` | Секрет клиента OAuth для серверов MCP, которые требуют [предварительно настроенные учетные данные](/docs/ru/mcp#use-pre-configured-oauth-credentials). Избегает интерактивного запроса при добавлении сервера с `--client-secret` |463| `MCP_CLIENT_SECRET` | Секрет клиента OAuth для MCP серверов, которые требуют [предварительно настроенные учётные данные](/docs/ru/mcp#use-pre-configured-oauth-credentials). Избегает интерактивного запроса при добавлении сервера с `--client-secret` |

463| `MCP_CONNECTION_NONBLOCKING` | Контролирует, ждет ли запуск подключения серверов MCP перед первым запросом. Запуск MCP неблокирующий по умолчанию: серверы подключаются в фоновом режиме и их инструменты становятся доступными по мере завершения. Установите `0` для ожидания подключения серверов перед первым запросом. Серверы, настроенные с [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral), по-прежнему заставляют запуск ждать независимо, за исключением случаев, когда они обслуживаются из [кэша обнаружения](/docs/ru/mcp#server-status-detail), так как их инструменты должны присутствовать при построении первой подсказки. В неинтерактивном режиме (`-p`) без `--input-format stream-json` Claude Code также ждет все еще ожидающих серверов перед первым ходом независимо от этой переменной. Когда вы передаете [`--mcp-config`](/docs/ru/cli-reference#cli-flags) явно, ожидание имеет более длительный крайний срок; см. запись этого флага для исключения кэшированного сервера |464| `MCP_CONNECTION_NONBLOCKING` | Контролирует, ждёт ли запуск MCP серверов подключения перед первым запросом. Запуск MCP неблокирующий по умолчанию: серверы подключаются в фоне и их инструменты становятся доступными по мере завершения. Установите на `0`, чтобы Claude Code ждал подключения серверов перед первым запросом. Серверы, настроенные с [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral), по-прежнему заставляют запуск ждать независимо, за исключением случаев, когда обслуживаются из [кэша обнаружения](/docs/ru/mcp#server-status-detail), так как их инструменты должны присутствовать при построении первой подсказки. В неинтерактивном режиме (`-p`) без `--input-format stream-json` Claude Code также ждёт всё ещё ожидающих серверов перед первым ходом независимо от этой переменной. Когда вы передаёте [`--mcp-config`](/docs/ru/cli-reference#cli-flags) явно, ожидание имеет более длительный крайний срок; см. запись этого флага для исключения кэшированного сервера |

464| `MCP_CONNECT_TIMEOUT_MS` | Как долго блокирующий запуск MCP ждет, в миллисекундах, пакета подключения перед снимком списка инструментов (по умолчанию: 5000). Применяется, когда `MCP_CONNECTION_NONBLOCKING=0` или для серверов, отмеченных [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral). Серверы все еще ожидающие на крайнем сроке продолжают подключаться в фоновом режиме. Отличается от `MCP_TIMEOUT`, который ограничивает попытку подключения отдельного сервера |465| `MCP_CONNECT_TIMEOUT_MS` | Как долго блокирующий запуск MCP ждёт, в миллисекундах, пакета подключения перед снимком списка инструментов (по умолчанию: 5000). Применяется, когда `MCP_CONNECTION_NONBLOCKING=0` или для серверов, отмеченных [`alwaysLoad: true`](/docs/ru/mcp#exempt-a-server-from-deferral). Серверы, всё ещё ожидающие на крайнем сроке, продолжают подключаться в фоне. Отличается от `MCP_TIMEOUT`, который ограничивает попытку подключения отдельного сервера |

465| `MCP_DISCOVERY_CACHE` | Включает или отключает [кэш обнаружения MCP](/docs/ru/mcp#server-status-detail). С включенным кэшем удаленный HTTP или SSE сервер, который вы использовали раньше, может показать [статус `cached`](/docs/ru/mcp#server-status-detail), и Claude Code подключает его при первом вызове инструмента вместо запуска. Кэш отключен по умолчанию, если постепенный rollout не включил его для вашей учетной записи. Установите `1` для включения или `0` для сохранения отключенным даже при включении rollout. До версии 2.1.238 кэш был включен по умолчанию. Статус `cached` требует Claude Code версии 2.1.221 или позже |466| `MCP_DISCOVERY_CACHE` | Включает или отключает [кэш обнаружения MCP](/docs/ru/mcp#server-status-detail). С включённым кэшем удалённый HTTP или SSE сервер, который вы использовали раньше, может показать [статус `cached`](/docs/ru/mcp#server-status-detail), и Claude Code подключает его при первом вызове инструмента вместо запуска. Кэш отключен по умолчанию, если постепенное развёртывание не включило его для вашей учётной записи. Установите на `1`, чтобы включить его, или `0`, чтобы сохранить его отключённым, даже если развёртывание включило его. До версии 2.1.238 кэш был включен по умолчанию. Статус `cached` требует Claude Code версии 2.1.221 или позже |

466| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Максимальный возраст в секундах записи [кэша обнаружения](/docs/ru/mcp#server-status-detail) (по умолчанию: 14400 или 4 часа). При запуске, где запись старше этого, Claude Code отбрасывает ее и подключает сервер при запуске, как при отключенном кэше. Claude Code ограничивает значение до 7 дней. До версии 2.1.238 значение по умолчанию было 86400 или 24 часа, и Claude Code не ограничивал значение |467| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Максимальный возраст в секундах записи [кэша обнаружения](/docs/ru/mcp#server-status-detail) (по умолчанию: 14400 или 4 часа). При запуске, где запись старше этого, Claude Code отбрасывает её и подключает сервер при запуске, как при отключённом кэше. Claude Code ограничивает значение на 7 дней. До версии 2.1.238 значение по умолчанию было 86400 или 24 часа, и Claude Code не ограничивал значение |

467| `MCP_DISCOVERY_CACHE_STRIKES` | При запуске, где запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) старше `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code обновляет ее в фоновом режиме. Эта переменная устанавливает, сколько обновлений подряд может завершиться с ошибкой перед тем, как Claude Code отбросит запись и подключит сервер при следующем запуске вместо этого (по умолчанию: 1). Повысьте это, если ваше сетевое подключение иногда отключается, чтобы одно неудачное обновление не отбросило запись. Требует Claude Code версии 2.1.238 или позже |468| `MCP_DISCOVERY_CACHE_STRIKES` | При запуске, где запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) старше `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code обновляет её в фоне. Эта переменная устанавливает, сколько обновлений подряд может не выполниться перед тем, как Claude Code отбросит запись и подключит сервер при следующем запуске вместо этого (по умолчанию: 1). Повысьте это, если ваше сетевое подключение иногда отключается, чтобы одно неудачное обновление не отбросило запись. Требует Claude Code версии 2.1.238 или позже |

468| `MCP_DISCOVERY_CACHE_TTL_S` | Секунды, в течение которых Claude Code использует запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) без обновления (по умолчанию: 900). При запуске, где запись старше этого, Claude Code по-прежнему использует ее, но обновляет ее в фоновом режиме. После того, как запись старше `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code отбрасывает ее вместо этого. Claude Code ограничивает значение до `MCP_DISCOVERY_CACHE_MAX_STALE_S`, что составляет 4 часа по умолчанию. До версии 2.1.238 Claude Code не ограничивал значение |469| `MCP_DISCOVERY_CACHE_TTL_S` | Секунды, в течение которых Claude Code использует запись [кэша обнаружения](/docs/ru/mcp#server-status-detail) без обновления (по умолчанию: 900). При запуске, где запись старше этого, Claude Code по-прежнему использует её, но обновляет её в фоне. После того, как запись старше `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code отбрасывает её вместо этого. Claude Code ограничивает значение на `MCP_DISCOVERY_CACHE_MAX_STALE_S`, что составляет 4 часа по умолчанию. До версии 2.1.238 Claude Code не ограничивал значение |

469| `MCP_OAUTH_CALLBACK_PORT` | Фиксированный порт для обратного вызова перенаправления OAuth, как альтернатива `--callback-port` при добавлении сервера MCP с [предварительно настроенными учетными данными](/docs/ru/mcp#use-pre-configured-oauth-credentials) |470| `MCP_OAUTH_CALLBACK_PORT` | Фиксированный порт для обратного вызова OAuth, как альтернатива `--callback-port` при добавлении MCP сервера с [предварительно настроенными учётными данными](/docs/ru/mcp#use-pre-configured-oauth-credentials) |

470| `MCP_PROTOCOL_NEGOTIATION` | На [v2 MCP client runtime](/docs/ru/mcp#mcp-client-runtimes) только, проверяет ли Claude Code серверы на ревизию протокола MCP 2026-07-28. Установите `auto` для проверки HTTP, claude.ai connector и серверов stdio; сервер, который не отвечает на зонд, подключается на более ранний протокол вместо этого, как серверы SSE и WebSocket всегда делают. Установите `legacy` для пропуска зонда для каждого сервера. Без переменной Claude Code проверяет HTTP серверы и также проверяет серверы claude.ai connector в сеансах, где он [получает флаги функций](#features-that-need-feature-flag-fetching). Любое другое значение игнорируется с предупреждением в журнале отладки. Требует Claude Code версии 2.1.221 или позже |471| `MCP_PROTOCOL_NEGOTIATION` | Только на [v2 MCP клиентском рантайме](/docs/ru/mcp#mcp-client-runtimes), зондирует ли Claude Code серверы для пересмотра протокола MCP 2026-07-28. Установите `auto`, чтобы зондировать HTTP, соединители claude.ai и серверы stdio; сервер, который не отвечает на зонд, подключается на более раннем протоколе вместо этого, как серверы SSE и WebSocket всегда делают. Установите `legacy`, чтобы пропустить зонд для каждого сервера. Без переменной Claude Code зондирует HTTP серверы и также зондирует серверы соединителей claude.ai в сеансах, где он [получает флаги функций](#features-that-need-feature-flag-fetching). Любое другое значение игнорируется с предупреждением в журнале отладки. Требует Claude Code версии 2.1.221 или позже |

471| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удаленных серверов MCP (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |472| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество удалённых MCP серверов (HTTP/SSE) для подключения параллельно при запуске (по умолчанию: 20) |

472| `MCP_SDK_GENERATION` | Закрепить, какой [MCP client runtime](/docs/ru/mcp#mcp-client-runtimes) этот процесс подключает к серверам MCP: `v1`, построенный на MCP TypeScript SDK 1.x, или `v2`, построенный на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Без переменной Claude Code использует v2, начиная с версий, перечисленных в этом разделе. На Claude Code версии 2.1.221 или позже v2 runtime проверяет издателя, который сервер OAuth MCP возвращает в своем ответе авторизации, и завершает вход с ошибкой, которая начинается с `Issuer mismatch in authorization response`, когда он не совпадает. V1 runtime не выполняет эту проверку. Если вы установите неузнанное значение, Claude Code игнорирует его и записывает предупреждение в журнал отладки. Claude Code читает значение один раз за процесс. Требует Claude Code версии 2.1.218 или позже |473| `MCP_SDK_GENERATION` | Закрепить, какой [MCP клиентский рантайм](/docs/ru/mcp#mcp-client-runtimes) этот процесс подключает к MCP серверам: `v1`, построенный на MCP TypeScript SDK 1.x, или `v2`, построенный на [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Без переменной Claude Code использует v2, начиная с версий, перечисленных в этом разделе. На Claude Code версии 2.1.221 или позже рантайм v2 проверяет издателя, который MCP OAuth сервер возвращает в своём ответе авторизации, и не выполняет вход с ошибкой, которая начинается с `Issuer mismatch in authorization response`, когда он не совпадает. Рантайм v1 не выполняет эту проверку. Если вы установите неузнанное значение, Claude Code игнорирует его и пишет предупреждение в журнал отладки. Claude Code читает значение один раз за процесс. Требует Claude Code версии 2.1.218 или позже |

473| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных серверов MCP (stdio) для подключения параллельно при запуске (по умолчанию: 3) |474| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Максимальное количество локальных MCP серверов (stdio) для подключения параллельно при запуске (по умолчанию: 3) |

474| `MCP_TIMEOUT` | Таймаут в миллисекундах для запуска сервера MCP (по умолчанию: 30000 или 30 секунд) |475| `MCP_TIMEOUT` | Таймаут в миллисекундах для запуска MCP сервера (по умолчанию: 30000 или 30 секунд) |

475| `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 версии 2.1.203 или позже. Для переменной окружения значения ниже 1000 ограничены до одной секунды; для поля для каждого сервера значения ниже 1000 игнорируются |476| `MCP_TOOL_TIMEOUT` | Таймаут в миллисекундах для выполнения инструмента MCP (по умолчанию: 100000000, примерно 28 часов). Для HTTP, SSE или сервера соединителя claude.ai каждый запрос также истекает после 60 секунд по умолчанию; установите эту переменную или сервер для каждого `timeout` выше 60000, чтобы повысить это ограничение для каждого запроса. Более низкое значение по-прежнему сокращает общий таймаут выполнения инструмента, но оставляет ограничение для каждого запроса на 60 секунд. Серверы Stdio и WebSocket не имеют таймера для каждого запроса. Поле `timeout` для каждого сервера в `.mcp.json` переопределяет это для этого сервера. Сервер для каждого сервера `timeout` по крайней мере 1000 также устанавливает минимальное окно простоя для вызовов инструментов этого сервера, поэтому `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` никогда не прерывает их раньше; этот пол требует Claude Code версии 2.1.203 или позже. Для переменной окружения значения ниже 1000 ограничены одной секундой; для поля для каждого сервера значения ниже 1000 игнорируются |

476| `NO_PROXY` | Список доменов и IP-адресов, на которые запросы будут выданы напрямую, обходя прокси |477| `NO_PROXY` | Список доменов и IP, на которые запросы будут выданы напрямую, обходя прокси |

477| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Стандартное ограничение SDK OpenTelemetry на длину значения атрибута. Claude Code ограничивает атрибуты телеметрии, содержащие содержимое, меньшим из этого и `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, поэтому маркер усечения остается в пределах ограничения SDK. Claude Code читает варианты `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` и `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` так же, и наименьшее установленное значение применяется ко всем сигналам. Требует Claude Code версии 2.1.214 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#common-configuration-variables) |478| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Стандартное ограничение SDK OpenTelemetry на длину значения атрибута. Claude Code ограничивает атрибуты телеметрии, несущие содержимое, на меньшее из этого и `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, поэтому маркер усечения остаётся в пределах ограничения SDK. Claude Code читает варианты `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` и `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` так же и применяется наименьшее установленное значение ко всем сигналам. Требует Claude Code версии 2.1.214 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#common-configuration-variables) |

478| `OTEL_LOG_ASSISTANT_RESPONSES` | Установите `1` для включения текста ответа модели в события журнала OpenTelemetry `assistant_response`. Если не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите `0` для сохранения ответов отредактированными даже при установке `OTEL_LOG_USER_PROMPTS`. Требует Claude Code версии 2.1.193 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#assistant-response-event) |479| `OTEL_LOG_ASSISTANT_RESPONSES` | Установите на `1`, чтобы включить текст ответа модели на событиях журнала OpenTelemetry `assistant_response`. Если не установлено, используется значение `OTEL_LOG_USER_PROMPTS`. Установите на `0`, чтобы сохранить ответы отредактированными, даже если установлен `OTEL_LOG_USER_PROMPTS`. Требует Claude Code версии 2.1.193 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#assistant-response-event) |

479| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа API Anthropic Messages как события журнала `api_request_body` / `api_response_body`. Установите `1` для встроенных тел, усеченных на пределе содержимого, или `file:<dir>` для записи неусеченных тел на диск и выдачи пути `body_ref` вместо этого. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` настраивает предел содержимого, 60 КБ по умолчанию. Отключено по умолчанию; тела включают всю историю разговора. Установите его в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). См. [Мониторинг](/docs/ru/monitoring-usage#api-request-body-event) |480| `OTEL_LOG_MANAGED_SETTINGS` | Установите на `1`, чтобы добавить отредактированные управляемые параметры и дайджест SHA-256 параметров перед редактированием к событиям журнала OpenTelemetry `managed_settings_resolved`. Отключено по умолчанию. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах; значение в параметрах проекта или локальных параметрах не включает это. Требует Claude Code версии 2.1.274 или позже. См. [Мониторинг](/docs/ru/monitoring-usage#managed-settings-resolved-event) |

480| `OTEL_LOG_TOOL_CONTENT` | Установите `1` для включения содержимого инструмента в событие span OpenTelemetry `tool.output`. Атрибуты span переносят содержимое инструмента в [их собственные ворота](/docs/ru/monitoring-usage#new-context-gates). Требует [трассировку](/docs/ru/monitoring-usage#traces-beta). Отключено по умолчанию для защиты конфиденциальных данных. См. [Мониторинг](/docs/ru/monitoring-usage#tool-output-span-event) |481| `OTEL_LOG_RAW_API_BODIES` | Выдавать JSON запроса и ответа API Anthropic Messages как события журнала `api_request_body` / `api_response_body`. Установите на `1` для встроенных тел, усечённых на пределе содержимого, или `file:<dir>`, чтобы написать неусечённые тела на диск и выдать путь `body_ref` вместо этого. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` настраивает предел содержимого, 60 КБ по умолчанию. Отключено по умолчанию; тела включают всю историю разговора. Установите это в вашей оболочке, пользовательских параметрах или управляемых параметрах. Игнорируется в [параметрах проекта и локальных параметрах](/docs/ru/settings-reference#variables-claude-code-ignores-in-env). См. [Мониторинг](/docs/ru/monitoring-usage#api-request-body-event) |

481| `OTEL_LOG_TOOL_DETAILS` | Установите `1` для включения аргументов входных данных инструмента, имен серверов MCP, имен workflow, созданных пользователем, необработанных строк ошибок при сбоях инструмента, категории отказа на событиях `api_refusal` и других деталей инструмента в трассировках и журналах OpenTelemetry. Отключено по умолчанию для защиты PII. См. [Мониторинг](/docs/ru/monitoring-usage) |482| `OTEL_LOG_TOOL_CONTENT` | Установите на `1`, чтобы включить содержимое инструмента в событие пролёта OpenTelemetry `tool.output`. Атрибуты пролётов несут содержимое инструмента под [их собственными воротами](/docs/ru/monitoring-usage#new-context-gates). Требует [трассировку](/docs/ru/monitoring-usage#traces-beta). Отключено по умолчанию для защиты чувствительных данных. См. [Мониторинг](/docs/ru/monitoring-usage#tool-output-span-event) |

482| `OTEL_LOG_USER_PROMPTS` | Установите `1` для включения текста подсказки пользователя в трассировки и журналы OpenTelemetry. Отключено по умолчанию (подсказки отредактированы). См. [Мониторинг](/docs/ru/monitoring-usage) |483| `OTEL_LOG_TOOL_DETAILS` | Установите на `1`, чтобы включить аргументы входа инструмента, имена MCP серверов, имена workflows, созданные пользователем, необработанные строки ошибок при отказах инструментов, категорию отказа `category` на событиях `api_refusal` и другие детали инструментов в трассировках и журналах OpenTelemetry. Отключено по умолчанию для защиты PII. См. [Мониторинг](/docs/ru/monitoring-usage) |

483| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Установите `false` для исключения UUID учетной записи из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |484| `OTEL_LOG_USER_PROMPTS` | Установите на `1`, чтобы включить текст подсказки пользователя в трассировки и журналы OpenTelemetry. Отключено по умолчанию (подсказки отредактированы). См. [Мониторинг](/docs/ru/monitoring-usage) |

484| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Установите `true` для включения точки входа сеанса в атрибуты метрик (по умолчанию: исключено). Добавлено в версии 2.1.152. См. [Мониторинг](/docs/ru/monitoring-usage) |485| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Установите на `false`, чтобы исключить UUID учётной записи из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |

485| `OTEL_METRICS_INCLUDE_REPOSITORY` | Установите `true` для тегирования метрик и событий OpenTelemetry атрибутами `vcs.*`, определяющими репозиторий сеанса (по умолчанию: исключено). Требует Claude Code версии 2.1.269 или позже. См. [Атрибуты репозитория](/docs/ru/monitoring-usage#repository-attributes) |486| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Установите на `true`, чтобы включить точку входа сеанса в атрибуты метрик (по умолчанию: исключено). Добавлено в версии 2.1.152. См. [Мониторинг](/docs/ru/monitoring-usage) |

486| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Начиная с версии 2.1.161, Claude Code прикрепляет ключи `OTEL_RESOURCE_ATTRIBUTES` к меткам точек данных метрик. Установите `false` для исключения их (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage#multi-team-organization-support) |487| `OTEL_METRICS_INCLUDE_REPOSITORY` | Установите на `true`, чтобы пометить метрики и события OpenTelemetry атрибутами `vcs.*`, определяющими репозиторий сеанса (по умолчанию: исключено). Требует Claude Code версии 2.1.269 или позже. См. [Атрибуты репозитория](/docs/ru/monitoring-usage#repository-attributes) |

487| `OTEL_METRICS_INCLUDE_SESSION_ID` | Установите `false` для исключения ID сеанса из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |488| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | Начиная с версии 2.1.161, Claude Code присоединяет ключи `OTEL_RESOURCE_ATTRIBUTES` к меткам точек данных метрик. Установите на `false`, чтобы исключить их (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage#multi-team-organization-support) |

488| `OTEL_METRICS_INCLUDE_VERSION` | Установите `true` для включения версии Claude Code в атрибуты метрик (по умолчанию: исключено). См. [Мониторинг](/docs/ru/monitoring-usage) |489| `OTEL_METRICS_INCLUDE_SESSION_ID` | Установите на `false`, чтобы исключить ID сеанса из атрибутов метрик (по умолчанию: включено). См. [Мониторинг](/docs/ru/monitoring-usage) |

489| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределить бюджет символов для метаданных skill, показанных [инструменту Skill](/docs/ru/skills#control-who-invokes-a-skill). Бюджет масштабируется динамически на 1% окна контекста с резервным значением 8,000 символов. Имя, сохраненное для обратной совместимости |490| `OTEL_METRICS_INCLUDE_VERSION` | Установите на `true`, чтобы включить версию Claude Code в атрибуты метрик (по умолчанию: исключено). См. [Мониторинг](/docs/ru/monitoring-usage) |

490| `TASK_MAX_OUTPUT_LENGTH` | Максимальное количество символов вывода [фоновой задачи](/docs/ru/tools-reference#background-commands), которое инструмент `TaskOutput` сохраняет (по умолчанию: 32000; максимум: 160000). Если вы установите параметр [`taskOutputMaxChars`](/docs/ru/settings-reference#taskoutputmaxchars), Claude Code игнорирует эту переменную |491| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Переопределить бюджет символов для метаданных skill, показанных [инструменту Skill](/docs/ru/skills#control-who-invokes-a-skill). Бюджет масштабируется динамически на 1% окна контекста с резервным значением 8,000 символов. Устаревшее имя сохранено для обратной совместимости |

491| `USE_BUILTIN_RIPGREP` | Установите `0` для использования установленного в системе `rg` вместо `rg`, включенного в Claude Code |492| `TASK_MAX_OUTPUT_LENGTH` | Удалено в версии 2.1.277 и теперь не работает, вместе с инструментом `TaskOutput`, который он размер. Ранее устанавливал максимальное количество символов вывода [фоновой задачи](/docs/ru/tools-reference#background-commands), которое инструмент `TaskOutput` сохранял. Claude читает вывод фоновой задачи с помощью `Read` вместо этого |

493| `USE_BUILTIN_RIPGREP` | Установите на `0`, чтобы использовать установленный в системе `rg` вместо `rg`, включённого в Claude Code |

492| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределить регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |494| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Переопределить регион для Claude 3.5 Haiku при использовании Google Cloud's Agent Platform |

493| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Переопределить регион для Claude 3.5 Sonnet при использовании Google Cloud's Agent Platform |495| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Переопределить регион для Claude 3.5 Sonnet при использовании Google Cloud's Agent Platform |

494| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Переопределить регион для Claude 3.7 Sonnet при использовании Google Cloud's Agent Platform |496| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Переопределить регион для Claude 3.7 Sonnet при использовании Google Cloud's Agent Platform |

501| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Переопределить регион для Claude Sonnet 4.6 при использовании Google Cloud's Agent Platform |503| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Переопределить регион для Claude Sonnet 4.6 при использовании Google Cloud's Agent Platform |

502| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Переопределить регион для Claude Opus 4.7 при использовании Google Cloud's Agent Platform |504| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Переопределить регион для Claude Opus 4.7 при использовании Google Cloud's Agent Platform |

503| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Переопределить регион для Claude Opus 4.8 при использовании Google Cloud's Agent Platform |505| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Переопределить регион для Claude Opus 4.8 при использовании Google Cloud's Agent Platform |

506| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Переопределить регион для Claude Opus 5.5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.280 |

504| `VERTEX_REGION_CLAUDE_5_OPUS` | Переопределить регион для Claude Opus 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.219 |507| `VERTEX_REGION_CLAUDE_5_OPUS` | Переопределить регион для Claude Opus 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.219 |

505| `VERTEX_REGION_CLAUDE_5_SONNET` | Переопределить регион для Claude Sonnet 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.197 |508| `VERTEX_REGION_CLAUDE_5_SONNET` | Переопределить регион для Claude Sonnet 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.197 |

506| `VERTEX_REGION_CLAUDE_FABLE_5` | Переопределить регион для Claude Fable 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.170 |509| `VERTEX_REGION_CLAUDE_FABLE_5` | Переопределить регион для Claude Fable 5 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.170 |

507| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Переопределить регион для Claude Fable 5.1 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.257 |510| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Переопределить регион для Claude Fable 5.1 при использовании Google Cloud's Agent Platform. Добавлено в версии 2.1.257 |

508| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Переопределить регион для Claude Haiku 4.5 при использовании Google Cloud's Agent Platform |511| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Переопределить регион для Claude Haiku 4.5 при использовании Google Cloud's Agent Platform |

509 512 

510Также поддерживаются стандартные переменные экспортера 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) для деталей конфигурации.513Также поддерживаются стандартные переменные экспортёра 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) для деталей конфигурации.

511 514 

512<h2 id="features-that-need-feature-flag-fetching">515<h2 id="features-that-need-feature-flag-fetching">

513 Функции, требующие получения флагов функций516 Функции, требующие получения флагов функций

535* Иметь Claude Code, зондирующий серверы соединителя claude.ai для [MCP протокола версии 2026-07-28](/docs/ru/mcp#mcp-client-runtimes), если вы не установите `MCP_PROTOCOL_NEGOTIATION=auto`538* Иметь Claude Code, зондирующий серверы соединителя claude.ai для [MCP протокола версии 2026-07-28](/docs/ru/mcp#mcp-client-runtimes), если вы не установите `MCP_PROTOCOL_NEGOTIATION=auto`

536* Получить [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) по умолчанию для учётных записей claude.ai и Console на Windows с установленным Git Bash; Claude Code маршрутизирует команды оболочки через Git Bash, если вы не установите `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. На Windows без Git Bash инструмент остаётся включённым539* Получить [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) по умолчанию для учётных записей claude.ai и Console на Windows с установленным Git Bash; Claude Code маршрутизирует команды оболочки через Git Bash, если вы не установите `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. На Windows без Git Bash инструмент остаётся включённым

537* Получить [отзыв, составленный Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), который Claude Code включает через полученный флаг540* Получить [отзыв, составленный Claude](/docs/ru/tools-reference#sendfeedback-tool-behavior), который Claude Code включает через полученный флаг

541* Иметь Claude [обрабатывающий большие вставки как вставленный, а не введённый текст](/docs/ru/terminal-config#how-claude-treats-pasted-text); содержимое за заполнителем `[Pasted text #N]` достигает Claude без отметки

538* Иметь Claude Code [исключающий инструменты MCP, чья схема входных данных будет отклонена API](/docs/ru/mcp#tools-with-invalid-input-schemas); он отправляет схему в любом случае, и запрос, который её включает, завершается с ошибкой [400, указывающей инструмент по его позиции](/docs/ru/errors#tool-input-schema-is-invalid)542* Иметь Claude Code [исключающий инструменты MCP, чья схема входных данных будет отклонена API](/docs/ru/mcp#tools-with-invalid-input-schemas); он отправляет схему в любом случае, и запрос, который её включает, завершается с ошибкой [400, указывающей инструмент по его позиции](/docs/ru/errors#tool-input-schema-is-invalid)

539 543 

540<h3 id="first-session-after-an-install-or-upgrade">544<h3 id="first-session-after-an-install-or-upgrade">

errors.md +158 −12

Details

71| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |71| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |

72| `Login expired · Please run /login` | [Authentication](#login-expired) |72| `Login expired · Please run /login` | [Authentication](#login-expired) |

73| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |73| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |

74| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |

74| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |75| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |

75| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |76| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |

76| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |77| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |

87| `Issuer mismatch in authorization response (RFC 9207)` | [Authentication](#issuer-mismatch-in-authorization-response) |88| `Issuer mismatch in authorization response (RFC 9207)` | [Authentication](#issuer-mismatch-in-authorization-response) |

88| `Cloud gateway session expired — run /login to reconnect.` | [Authentication](#cloud-gateway-session-expired) |89| `Cloud gateway session expired — run /login to reconnect.` | [Authentication](#cloud-gateway-session-expired) |

89| `Cloud gateway <url> no longer accepts this session` | [Authentication](#cloud-gateway-session-expired) |90| `Cloud gateway <url> no longer accepts this session` | [Authentication](#cloud-gateway-session-expired) |

91| `Sign-in timed out while waiting for you to continue. Try again.` | [Authentication](#sign-in-timed-out-while-waiting-for-you-to-continue) |

90| `AWS credentials expired or invalid` | [Authentication](#aws-credentials-expired-or-invalid) |92| `AWS credentials expired or invalid` | [Authentication](#aws-credentials-expired-or-invalid) |

91| `AWS authentication failed` | [Authentication](#aws-authentication-failed) |93| `AWS authentication failed` | [Authentication](#aws-authentication-failed) |

92| `Google Cloud credentials expired or invalid` | [Authentication](#google-cloud-credentials-expired-or-invalid) |94| `Google Cloud credentials expired or invalid` | [Authentication](#google-cloud-credentials-expired-or-invalid) |

149| `effort '<level>' is not supported when thinking is disabled` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |151| `effort '<level>' is not supported when thinking is disabled` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |

150| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |152| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |

151| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |153| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |

154| `API Error: 400 orphaned tool_result in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |

155| `API Error: 400 duplicate tool_use ID in conversation history` | [Request errors](#tool-use-or-thinking-block-mismatch) |

152| `[Unsupported tool content removed]` | [Request errors](#unsupported-tool-content-removed) |156| `[Unsupported tool content removed]` | [Request errors](#unsupported-tool-content-removed) |

153| `server_tool_use.name: Input should be` on every turn of a resumed session | [Request errors](#unsupported-tool-content-removed) |157| `server_tool_use.name: Input should be` on every turn of a resumed session | [Request errors](#unsupported-tool-content-removed) |

154| `<model> can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |158| `<model> can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |

155| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |159| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |

156| `<model>'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |160| `<model>'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |

161| `Opus 5.5's safeguards flagged this session` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |

157| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |162| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |

158| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |163| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |

159| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |164| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |

199| `No conversation found with session ID: <session-id>` | [Command-line errors](#no-conversation-found-with-the-session-id) |204| `No conversation found with session ID: <session-id>` | [Command-line errors](#no-conversation-found-with-the-session-id) |

200| `Cannot switch renderers in this session` | [Command-line errors](#cannot-switch-renderers-in-this-session) |205| `Cannot switch renderers in this session` | [Command-line errors](#cannot-switch-renderers-in-this-session) |

201| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |206| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |

207| `Couldn't open Claude Desktop` | [Command-line errors](#couldnt-open-claude-desktop) |

208| `Failed to open Claude Desktop. Please try opening it manually.` | [Command-line errors](#couldnt-open-claude-desktop) |

202| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |209| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |

203| `Your Zed keymap isn't a readable list of keybindings` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |210| `Your Zed keymap isn't a readable list of keybindings` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |

204| `Skill usage reports are not available on this connection.` | [Command-line errors](#skill-usage-reports-are-not-available-on-this-connection) |211| `Skill usage reports are not available on this connection.` | [Command-line errors](#skill-usage-reports-are-not-available-on-this-connection) |

206| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |213| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |

207| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |214| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |

208| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |215| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |

216| `Marketplace "<name>" is already added from a different source` | [Plugin errors](#marketplace-is-already-added-from-a-different-source) |

209| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |217| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |

210| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |218| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |

211| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |219| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |

216| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |224| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |

217| `Failed to load marketplace configuration` | [Plugin errors](#failed-to-load-marketplace-configuration) |225| `Failed to load marketplace configuration` | [Plugin errors](#failed-to-load-marketplace-configuration) |

218| `Marketplace configuration file is corrupted` | [Plugin errors](#failed-to-load-marketplace-configuration) |226| `Marketplace configuration file is corrupted` | [Plugin errors](#failed-to-load-marketplace-configuration) |

227| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [Plugin errors](#plugin-is-required-by-your-organization) |

219| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |228| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |

220| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |229| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |

221| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |230| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |

246| `Can't open MCP settings in a background session` | [Background session errors](#commands-refused-in-a-background-session) |255| `Can't open MCP settings in a background session` | [Background session errors](#commands-refused-in-a-background-session) |

247| `blocked because the path is spelled in a form that cannot be safely resolved` | [Background session errors](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |256| `blocked because the path is spelled in a form that cannot be safely resolved` | [Background session errors](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |

248| `blocked because the path is network-shaped` | [Background session errors](#write-or-command-blocked-because-the-path-names-a-network-location) |257| `blocked because the path is network-shaped` | [Background session errors](#write-or-command-blocked-because-the-path-names-a-network-location) |

258| `is isolated in the worktree <path>, but this command <reason>. Refusing to run it` | [Background session errors](#command-blocked-by-the-worktree-isolation-checks) |

259| `too complex to verify that it stays inside the worktree` | [Background session errors](#command-blocked-by-the-worktree-isolation-checks) |

249| `This session has no saved transcript` | [Background session errors](#this-session-has-no-saved-transcript) |260| `This session has no saved transcript` | [Background session errors](#this-session-has-no-saved-transcript) |

250| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |261| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |

251| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |262| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |

281| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |292| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |

282| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |293| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

283| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |294| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

295| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |

284| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |296| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |

285| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |297| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |

286| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |298| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |

624**Что делать:**636**Что делать:**

625 637 

626* Запустите `/model` и выберите вариант без суффикса `[1m]`, чтобы вернуться к стандартному окну контекста638* Запустите `/model` и выберите вариант без суффикса `[1m]`, чтобы вернуться к стандартному окну контекста

627* Где сообщение называет `/usage-credits`, запустите его, чтобы включить поэтапное выставление счётов для варианта 1M на Pro и Max, или запросить кредиты использования у администратора на Team и Enterprise. Перезагрузите Claude Code после включения кредитов использования. До перезагрузки сеанс остаётся на стандартном лимите контекста.639* Где сообщение называет `/usage-credits`, запустите его, чтобы включить поэтапное выставление счётов для варианта 1M на Pro и Max, или запросить кредиты использования у администратора на Team и Enterprise. После включения кредитов использования перезагрузите Claude Code или начните новый сеанс, в зависимости от того, что говорит сообщение. До этого сеанс остаётся на стандартном лимите контекста.

628* Если ошибка сохраняется после `/model`, ID модели 1M может быть установлен в другом месте. См. [Setting your model](/docs/ru/model-config#setting-your-model) для проверки мест конфигурации в порядке приоритета.640* Если ошибка сохраняется после `/model`, ID модели 1M может быть установлен в другом месте. См. [Setting your model](/docs/ru/model-config#setting-your-model) для проверки мест конфигурации в порядке приоритета.

629* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars)641* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars)

630 642 

861* Запустите команду, настроенную в `apiKeyHelper`, напрямую в вашей оболочке, чтобы воспроизвести сбой873* Запустите команду, настроенную в `apiKeyHelper`, напрямую в вашей оболочке, чтобы воспроизвести сбой

862* Если команда сообщает об истекшем сеансе, повторно аутентифицируйтесь у вашего поставщика учетных данных, например, снова войдя в свой SSO или хранилище секретов874* Если команда сообщает об истекшем сеансе, повторно аутентифицируйтесь у вашего поставщика учетных данных, например, снова войдя в свой SSO или хранилище секретов

863* Исправьте команду так, чтобы она выводила только ключ на stdout как один токен печатаемого ASCII до 16 384 символов и выходила с кодом 0. См. [rotate credentials with apiKeyHelper](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) для рабочей установки.875* Исправьте команду так, чтобы она выводила только ключ на stdout как один токен печатаемого ASCII до 16 384 символов и выходила с кодом 0. См. [rotate credentials with apiKeyHelper](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) для рабочей установки.

864* Запустите `/status`, чтобы подтвердить, что `apiKeyHelper` является активным источником учетных данных. Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки появляются в панели `Authentication` в терминале. До v2.1.212 панель была озаглавлена `Cloud authentication`.876* Запустите `/status`, чтобы подтвердить, что `apiKeyHelper` является активным источником учетных данных. Строка `apiKeyHelper` показывает `Failing` с деталью последнего сбоя, такой как код выхода и вывод ошибки команды, и исчезает после следующего успешного запуска. До v2.1.274 `/status` показал только источник учетных данных, а не сбой.

877* Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки также появляются в панели `Authentication` в терминале. До v2.1.212 панель была озаглавлена `Cloud authentication`.

865 878 

866<h3 id="invalid-request-header-value">879<h3 id="invalid-request-header-value">

867 Invalid request header value880 Invalid request header value

969 Routines are disabled by your organization's policy982 Routines are disabled by your organization's policy

970</h3>983</h3>

971 984 

972Владелец в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, например из пользовательского интерфейса [Routines](/docs/ru/routines) на claude.ai/code. На Claude Code v2.1.227 или более поздней версии тот же параметр также [hides `/schedule`](/docs/ru/routines#troubleshooting) в CLI.985An Owner в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, например из пользовательского интерфейса [Routines](/docs/ru/routines) на claude.ai/code. На Claude Code v2.1.227 или более поздней версии тот же параметр также [hides `/schedule`](/docs/ru/routines#troubleshooting) в CLI.

973 986 

974```text theme={null}987```text theme={null}

975Routines are disabled by your organization's policy.988Routines are disabled by your organization's policy.

1167 1180 

1168* Запустите `/login`, завершите вход, затем запустите сеанс снова1181* Запустите `/login`, завершите вход, затем запустите сеанс снова

1169 1182 

1183<h3 id="artifacts-need-a-claude-ai-login">

1184 Artifacts need a claude.ai login

1185</h3>

1186 

1187Claude Code отказал [artifact](/docs/ru/artifacts) публикации или чтению, потому что сеанс не имеет входа claude.ai, который он может использовать для артефактов.

1188 

1189Каждая форма сообщения начинается с одних и тех же слов, за которыми следует средство, которое зависит от того, как ваш сеанс аутентифицируется. Без конкурирующего учетного данного он читается:

1190 

1191```text theme={null}

1192Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

1193```

1194 

1195**Что делать:**

1196 

1197* Запустите `/login` и выберите **Claude account with subscription**. Опция **Anthropic Console account** не предоставляет учетные данные claude.ai.

1198* Когда сообщение называет учетное данное, которое имеет приоритет, такое как `ANTHROPIC_API_KEY`, параметр `apiKeyHelper` или ключ Console, сохраненный предыдущим `/login`, удалите его так, как говорит сообщение, затем запустите `/login`

1199* Когда сообщение говорит, что этот удаленный сеанс аутентифицируется через машину, которая его запустила, войдите в claude.ai на этой машине, затем переподключите сеанс

1200* Когда сообщение говорит, что учетные данные вводятся окружением хоста сеанса, вы не можете изменить их в этом сеансе; запустите сеанс, который подписан на claude.ai

1201* См. [Availability](/docs/ru/artifacts#availability) для других требований, которые имеют артефакты, такие как план, поставщик модели и политика организации

1202 

1170<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1203<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">

1171 Administrator policy requires a Cloud gateway sign-in1204 Administrator policy requires a Cloud gateway sign-in

1172</h3>1205</h3>

1535* Запустите `/login` в сеансе и завершите вход в браузер1568* Запустите `/login` в сеансе и завершите вход в браузер

1536* Для неинтерактивного запуска запустите `claude` в том же окружении, запустите `/login`, затем перезапустите вашу команду1569* Для неинтерактивного запуска запустите `claude` в том же окружении, запустите `/login`, затем перезапустите вашу команду

1537 1570 

1571<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">

1572 Sign-in timed out while waiting for you to continue

1573</h3>

1574 

1575Во время [Claude apps gateway](/docs/ru/claude-apps-gateway) входа шлюз назвал учетную запись, которая вошла, и Claude Code попросил вас подтвердить ее перед сохранением учетных данных. Вы оставили подтверждение открытым после истечения входа, и шлюз не выдал токен обновления, который мог бы его обновить, поэтому Claude Code ничего не сохранил, когда вы продолжили:

1576 

1577```text theme={null}

1578Sign-in timed out while waiting for you to continue. Try again.

1579```

1580 

1581**Что делать:**

1582 

1583* Запустите `/login` снова и подтвердите учетную запись перед истечением входа

1584 

1538<h3 id="gateway-refused-the-request">1585<h3 id="gateway-refused-the-request">

1539 Gateway refused the request1586 Gateway refused the request

1540</h3>1587</h3>

2268 2315 

2269**Что делать:**2316**Что делать:**

2270 2317 

2271* Запустите `claude update` и перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже. Opus 5 требует v2.1.219 или позже2318* Запустите `claude update` и перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже. Opus 5 требует v2.1.219 или позже. Opus 5.5 требует v2.1.280 или позже

2272* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого2319* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого

2273* Если вы столкнулись с этим в [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 или позже. Opus 5 требует TypeScript SDK v0.3.219 или позже2320* Если вы столкнулись с этим в [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 или позже. Opus 5 требует TypeScript SDK v0.3.219 или позже. Opus 5.5 требует TypeScript SDK v0.3.280 или позже

2274 2321 

2275<h3 id="effort-isnt-available-with-thinking-turned-off">2322<h3 id="effort-isnt-available-with-thinking-turned-off">

2276 Effort isn't available with thinking turned off2323 Effort isn't available with thinking turned off

2314 2361 

2315```text theme={null}2362```text theme={null}

2316API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.2363API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.

2364API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.

2365API Error: 400 duplicate tool_use ID in conversation history. Run /rewind to recover the conversation.

2317API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks2366API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks

2318API Error: 400 ... thinking blocks ... cannot be modified2367API Error: 400 ... thinking blocks ... cannot be modified

2319```2368```

2320 2369 

2321Все три варианта означают одно и то же: последовательность блоков `tool_use`, `tool_result` и `thinking` в истории больше не соответствует тому, что ожидает API.2370Все варианты означают одно и то же: последовательность блоков `tool_use`, `tool_result` и `thinking` в истории больше не соответствует тому, что ожидает API.

2322 2371 

2323**Что делать:**2372**Что делать:**

2324 2373 

2376API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude2425API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

2377```2426```

2378 2427 

2379Сообщение ссылается на [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), который предоставляет доступ для законной работы в области кибербезопасности.2428Сообщение ссылается на [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), который предоставляет доступ для законной работы в области кибербезопасности. На Opus 5.5, который требует v2.1.280 или позже, сообщение открывается с `Opus 5.5's safeguards flagged this session` вместо этого. Когда отмеченная категория имеет доступную резервную модель, Claude Code [переключает модели](/docs/ru/model-config#automatic-model-fallback) вместо показа этой ошибки.

2380 2429 

2381На [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).2430На [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).

2382 2431 

3087**Что делать:**3136**Что делать:**

3088 3137 

3089* Запустите `claude --resume <session-id>` с ID сеанса из сообщения для повторной попытки3138* Запустите `claude --resume <session-id>` с ID сеанса из сообщения для повторной попытки

3139* Если каждая повторная попытка не работает так же, запустите `claude update` и возобновите снова. Версии до v2.1.275 не работают при возобновлении, когда сохранённая стенограмма содержит запись, которую они не могут прочитать.

3090* Если повторная попытка снова не работает, запустите `claude` для запуска нового сеанса3140* Если повторная попытка снова не работает, запустите `claude` для запуска нового сеанса

3091 3141 

3092<h3 id="no-conversation-found-with-the-session-id">3142<h3 id="no-conversation-found-with-the-session-id">

3139 3189 

3140* В сеансе, запущенном без этих ограничений, запустите `/tui fullscreen` или `/tui default` для переключения обратно. Claude Code сохраняет параметр [`tui`](/docs/ru/settings-reference#tui) там3190* В сеансе, запущенном без этих ограничений, запустите `/tui fullscreen` или `/tui default` для переключения обратно. Claude Code сохраняет параметр [`tui`](/docs/ru/settings-reference#tui) там

3141 3191 

3192<h3 id="couldnt-open-claude-desktop">

3193 Не удалось открыть Claude Desktop

3194</h3>

3195 

3196Вы запустили [`/desktop`](/docs/ru/desktop#coming-from-the-cli), или его псевдоним `/app`, и системная команда, которую Claude Code использует для открытия Claude Desktop, не работала. Сеанс остаётся в терминале.

3197 

3198```text theme={null}

3199Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.

3200```

3201 

3202**Что делать:**

3203 

3204* Откройте Claude Desktop самостоятельно, затем запустите `/desktop` снова

3205* Чтобы прочитать полный вывод ошибки этой команды, включите отладочное логирование с помощью `/debug`, запустите `/desktop` снова и проверьте журнал отладки

3206 

3207До версии 2.1.275 сообщение было `Failed to open Claude Desktop. Please try opening it manually.` и не говорило, что не прошло.

3208 

3142<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3209<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3143 /terminal-setup оставил вашу раскладку клавиш Zed без изменений3210 /terminal-setup оставил вашу раскладку клавиш Zed без изменений

3144</h3>3211</h3>

3256* Если вы публикуете сторонний маркетплейс, который использовал это имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей добавить его снова из вашего источника3323* Если вы публикуете сторонний маркетплейс, который использовал это имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей добавить его снова из вашего источника

3257* См. список зарезервированных имён в разделе [Marketplace schema](/docs/ru/plugin-marketplaces#marketplace-schema)3324* См. список зарезервированных имён в разделе [Marketplace schema](/docs/ru/plugin-marketplaces#marketplace-schema)

3258 3325 

3326<h3 id="marketplace-is-already-added-from-a-different-source">

3327 Marketplace is already added from a different source

3328</h3>

3329 

3330Вы подтвердили добавление маркетплейса через [`/plugin install <plugin> --marketplace <source>`](/docs/ru/discover-plugins#add-a-marketplace-and-install-in-one-command), и каталог, который Claude Code получил из этого источника, называет себя так же, как маркетплейс, который вы уже добавили из другого источника. Claude Code сохраняет существующий маркетплейс вместо его замены, и плагин не устанавливается.

3331 

3332```text theme={null}

3333Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

3334```

3335 

3336**Что делать:**

3337 

3338* Если маркетплейс, который вы уже добавили, это тот, который вам нужен, установите из него по имени: `/plugin install <plugin>@<name>`

3339* Чтобы переключиться на новый источник, запустите `/plugin marketplace remove <name>`, затем повторите попытку установки

3340 

3259<h3 id="plugin-command-references-user-config">3341<h3 id="plugin-command-references-user-config">

3260 Plugin command references user\_config in a shell command3342 Plugin command references user\_config in a shell command

3261</h3>3343</h3>

3330commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform3412commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform

3331```3413```

3332 3414 

3333До версии v2.1.251 Claude Code загружал путь `commands`, объявленный в записи маркетплейса, даже когда он указывал вне директории плагина. Claude Code уже отклонял пути, объявленные в `plugin.json`, и другие пути компонентов в записи маркетплейса.3415До версии v2.1.251 Claude Code загружала путь `commands`, объявленный в записи маркетплейса, даже когда он указывал вне директории плагина. Claude Code уже отклоняла пути, объявленные в `plugin.json`, и другие пути компонентов в записи маркетплейса.

3334 3416 

3335До версии v2.1.257 проверка смотрела только на написание пути, а не на то, где ведёт символическая ссылка.3417До версии v2.1.257 проверка смотрела только на написание пути, а не на то, где ведёт символическая ссылка.

3336 3418 

3380[Запись маркетплейса](/docs/ru/plugin-marketplaces#plugin-entries) плагина объявляет путь источника, который Claude Code не может разрешить в расположение внутри собственной директории маркетплейса, поэтому плагин не устанавливается и не загружается. Отказ охватывает:3462[Запись маркетплейса](/docs/ru/plugin-marketplaces#plugin-entries) плагина объявляет путь источника, который Claude Code не может разрешить в расположение внутри собственной директории маркетплейса, поэтому плагин не устанавливается и не загружается. Отказ охватывает:

3381 3463 

3382* Путь записи, который является абсолютным, поднимается из маркетплейса с помощью `..`, или написан как сетевой путь3464* Путь записи, который является абсолютным, поднимается из маркетплейса с помощью `..`, или написан как сетевой путь

3465* На macOS и Linux путь записи, который содержит обратную косую черту где-либо после начального `./`

3383* Запись в маркетплейсе, полученном из удалённого источника, такого как git или URL, которая достигает своей цели через символическую ссылку, разрешающуюся вне директории маркетплейса3466* Запись в маркетплейсе, полученном из удалённого источника, такого как git или URL, которая достигает своей цели через символическую ссылку, разрешающуюся вне директории маркетплейса

3384* Относительная запись в маркетплейсе, добавленном из прямого URL-адреса его `marketplace.json`: Claude Code загружает только этот файл, поэтому локальные файлы плагинов не существуют для пути, чтобы назвать. См. [Plugins with relative paths fail in URL-based marketplaces](/docs/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)3467* Относительная запись в маркетплейсе, добавленном из прямого URL-адреса его `marketplace.json`: Claude Code загружает только этот файл, поэтому локальные файлы плагинов не существуют для пути, чтобы назвать. См. [Plugins with relative paths fail in URL-based marketplaces](/docs/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)

3385 3468 

3397 3480 

3398**Что делать:**3481**Что делать:**

3399 3482 

3400* Если вы поддерживаете маркетплейс, напишите `source` записи как простой относительный путь, такой как `./plugins/my-plugin`, и держите любую символическую ссылку, которую он пересекает, указывающей внутри директории маркетплейса3483* Если вы поддерживаете маркетплейс, напишите `source` записи как простой относительный путь с прямыми косыми чертами, например `./plugins/my-plugin`, и держите любую символическую ссылку, которую он пересекает, указывающей внутри директории маркетплейса

3401* Если вы добавили маркетплейс из прямого URL-адреса, относительные записи не могут разрешиться. Попросите автора маркетплейса использовать [другой источник плагина](/docs/ru/plugin-marketplaces#plugin-sources), или добавьте маркетплейс из его репозитория git вместо этого3484* Если вы добавили маркетплейс из прямого URL-адреса, относительные записи не могут разрешиться. Попросите автора маркетплейса использовать [другой источник плагина](/docs/ru/plugin-marketplaces#plugin-sources), или добавьте маркетплейс из его репозитория git вместо этого

3402 3485 

3403<h3 id="failed-to-load-marketplace-configuration">3486<h3 id="failed-to-load-marketplace-configuration">

3417✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF3500✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF

3418```3501```

3419 3502 

3420До версии v2.1.246 `claude plugin install` не сообщал об этой ошибке.3503До версии v2.1.246 `claude plugin install` не сообщала об этой ошибке.

3421 3504 

3422**Что делать:**3505**Что делать:**

3423 3506 

3424* Откройте `~/.claude/plugins/known_marketplaces.json` и исправьте JSON, или исправьте записи, которые сообщение называет как не соответствующие схеме реестра3507* Откройте `~/.claude/plugins/known_marketplaces.json` и исправьте JSON, или исправьте записи, которые сообщение называет как не соответствующие схеме реестра

3425* Если вы не можете исправить это, удалите файл или замените его содержимое на `{}`, затем добавьте каждый маркетплейс снова с помощью `claude plugin marketplace add <source>`. Claude Code повторно регистрирует маркетплейсы, которые ваш пользователь или управляемые параметры объявляют в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces), в следующий раз, когда вы запустите его в папке, которую вы доверили.3508* Если вы не можете исправить это, удалите файл или замените его содержимое на `{}`, затем добавьте каждый маркетплейс снова с помощью `claude plugin marketplace add <source>`. Claude Code повторно регистрирует маркетплейсы, которые ваш пользователь или управляемые параметры объявляют в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces), в следующий раз, когда вы запустите его в папке, которую вы доверили.

3426 3509 

3510<h3 id="plugin-is-required-by-your-organization">

3511 Plugin is required by your organization

3512</h3>

3513 

3514Вы запустили `claude plugin disable`, или использовали вкладку `/plugin` **Installed**, чтобы отключить [плагин, синхронизированный с claude.ai](/docs/ru/plugins-reference#synced-plugins), который ваша организация отмечает как обязательный:

3515 

3516```text theme={null}

3517Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.

3518```

3519 

3520Claude Code ничего не сохраняет и плагин остаётся включённым.

3521 

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

3523 

3524**Что делать:**

3525 

3526* Попросите администратора вашей организации claude.ai изменить статус обязательности плагина на claude.ai

3527 

3427<h2 id="tool-errors">3528<h2 id="tool-errors">

3428 Ошибки инструментов3529 Ошибки инструментов

3429</h2>3530</h2>

3452 3553 

3453* Исправьте каждую запись, которую называет ошибка, в соответствии с [инструментами, доступными подагентам](/docs/ru/sub-agents#available-tools)3554* Исправьте каждую запись, которую называет ошибка, в соответствии с [инструментами, доступными подагентам](/docs/ru/sub-agents#available-tools)

3454* Удалите записи для инструментов, которые сеанс не имеет, например инструменты MCP с сервера, который не подключён3555* Удалите записи для инструментов, которые сеанс не имеет, например инструменты MCP с сервера, который не подключён

3455* Для инструмента, который [фоновые подагенты отбрасывают](/docs/ru/sub-agents#available-tools), например `LSP`, удалите запись. Чтобы сохранить инструмент, [отключите режим fork](/docs/ru/sub-agents#turn-fork-mode-on-or-off) и попросите Claude запустить подагента на переднем плане3556* Для инструмента, который [фоновые подагенты отбрасывают](/docs/ru/sub-agents#available-tools), например `CronCreate`, удалите запись. Чтобы сохранить инструмент, [отключите режим fork](/docs/ru/sub-agents#turn-fork-mode-on-or-off) и попросите Claude запустить подагента на переднем плане

3456* Удалите поле `tools` вместо перечисления инструментов, чтобы дать подагенту каждый [инструмент, доступный подагентам](/docs/ru/sub-agents#available-tools)3557* Удалите поле `tools` вместо перечисления инструментов, чтобы дать подагенту каждый [инструмент, доступный подагентам](/docs/ru/sub-agents#available-tools)

3457* Для списка `tools`, содержащего только `Agent`, повысьте [предел глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) или дайте агенту по крайней мере один другой инструмент: Claude Code скрывает `Agent` на этом пределе, поэтому список с ничем другим в нём разрешается в отсутствие инструментов3558* Для списка `tools`, содержащего только `Agent`, повысьте [предел глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) или дайте агенту по крайней мере один другой инструмент: Claude Code скрывает `Agent` на этом пределе, поэтому список с ничем другим в нём разрешается в отсутствие инструментов

3458 3559 

3812* Обычно ничего: Claude повторяет попытку с локальным написанием, которое просит сообщение3913* Обычно ничего: Claude повторяет попытку с локальным написанием, которое просит сообщение

3813* Если файл находится на сетевом ресурсе, а не на локальном файле, написанном с сетевым путём, он находится вне локального рабочего пространства сеанса; отредактируйте его из обычного интерактивного сеанса вместо этого3914* Если файл находится на сетевом ресурсе, а не на локальном файле, написанном с сетевым путём, он находится вне локального рабочего пространства сеанса; отредактируйте его из обычного интерактивного сеанса вместо этого

3814 3915 

3916<h3 id="command-blocked-by-the-worktree-isolation-checks">

3917 Команда заблокирована проверками изоляции worktree

3918</h3>

3919 

3920Claude запустил команду Bash или Monitor в [сеансе, изолированном в worktree](/docs/ru/worktrees#how-claude-code-enforces-isolation), и Claude Code отклонил её по одной из двух причин:

3921 

3922* Команда указывает git на основную проверку.

3923* Claude Code не может проверить из текста команды, что любой git, который запускает команда, остаётся внутри worktree. Команда, которая никогда не называет git, всё ещё может быть отклонена по этой причине, потому что расширение косвенного обращения переменной, такого как `${!name}`, или запуск подстановки функции Bash, такой как `${ command; }`, производит значение во время выполнения, которое само может быть командой.

3924 

3925Середина сообщения называет то, что не могло быть проверено:

3926 

3927```text wrap theme={null}

3928This session is isolated in the worktree /path/to/worktree, but this command evaluates ${!x@P} arithmetically inside a construct too complex to verify, which can run a command hidden in a variable's value. Refusing to run it — a worktree-isolated session's git operations must target its own worktree. Split it into plain, separate commands and run them from /path/to/worktree.

3929```

3930 

3931**Что делать:**

3932 

3933* Обычно ничего: Claude читает сообщение и переписывает команду так, как просит его последнее предложение

3934* Если команда, которую вы просили, продолжает отклоняться, напишите отмеченное значение буквально: замените косвенное обращение или подстановку его значением и запустите git как отдельную простую команду из внутри worktree

3935* Чтобы действовать на основной проверке намеренно, запустите команду самостоятельно в терминале вне сеанса

3936 

3815<h3 id="this-session-has-no-saved-transcript">3937<h3 id="this-session-has-no-saved-transcript">

3816 Этот сеанс не имеет сохранённой стенограммы3938 Этот сеанс не имеет сохранённой стенограммы

3817</h3>3939</h3>

4201 4323 

4202Claude Code удаляет резервные копии сеанса при [очистке хранения](/docs/ru/claude-directory#cleaned-up-automatically), по умолчанию примерно через 30 дней после того, как сеанс последний раз их сохранил. Если вы возобновите сеанс после этого, `/rewind` по-прежнему будет отображать его контрольные точки, но восстановление одной из них может завершиться ошибкой. Если сообщение также говорит `N paths were skipped for link safety`, см. раздел [Restored the code, but skipped files](#restored-the-code-but-skipped-files) для этих путей.4324Claude Code удаляет резервные копии сеанса при [очистке хранения](/docs/ru/claude-directory#cleaned-up-automatically), по умолчанию примерно через 30 дней после того, как сеанс последний раз их сохранил. Если вы возобновите сеанс после этого, `/rewind` по-прежнему будет отображать его контрольные точки, но восстановление одной из них может завершиться ошибкой. Если сообщение также говорит `N paths were skipped for link safety`, см. раздел [Restored the code, but skipped files](#restored-the-code-but-skipped-files) для этих путей.

4203 4325 

4326Когда вы создаёте ветвь сеанса, например с помощью [`--fork-session`](/docs/ru/cli-reference#cli-flags) или [`/branch`](/docs/ru/sessions#branch-a-session), Claude Code копирует резервные копии исходного сеанса в ветвь. Когда Claude Code не может скопировать резервную копию, например потому что диск заполнен, эта резервная копия отсутствует в ветви. Восстановление контрольной точки, которая её требует, может завершиться этой ошибкой.

4327 

4204**Что делать:**4328**Что делать:**

4205 4329 

4206* Отмените изменения другим способом: попросите Claude отменить его редактирование или восстановите файлы из системы контроля версий. Когда резервные копии удалены, повторный запуск `/rewind` завершится с той же ошибкой.4330* Отмените изменения другим способом: попросите Claude отменить его редактирование или восстановите файлы из системы контроля версий. Когда резервные копии удалены, повторный запуск `/rewind` завершится с той же ошибкой.

4458* Если вы администрируете машину, исправьте названный документ так, чтобы он анализировался как объект JSON, или удалите файл, профиль или значение реестра. Пустой `managed-settings.json` считается `{}` и не блокирует запуск.4582* Если вы администрируете машину, исправьте названный документ так, чтобы он анализировался как объект JSON, или удалите файл, профиль или значение реестра. Пустой `managed-settings.json` считается `{}` и не блокирует запуск.

4459* Если нет, попросите вашего администратора исправить развёрнутый документ. Ничто в ваших собственных файлах параметров не вызывает и не очищает эту ошибку.4583* Если нет, попросите вашего администратора исправить развёрнутый документ. Ничто в ваших собственных файлах параметров не вызывает и не очищает эту ошибку.

4460 4584 

4585<h3 id="otelheadershelper-failed">

4586 otelHeadersHelper failed

4587</h3>

4588 

4589Claude Code показывает это предупреждение как уведомление в интерфейсе терминала, один раз за интерактивный сеанс, когда скрипт [`otelHeadersHelper`](/docs/ru/settings-reference#otelheadershelper) не удаётся или выводит результат, который не соответствует [требованиям скрипта](/docs/ru/monitoring-usage#script-requirements).

4590 

4591Пока скрипт продолжает не удаваться, экспорты не удаются и ваш backend телеметрии не получает ничего из сеанса.

4592 

4593Текст после `See /status:` говорит, что не удалось, например код выхода скрипта, за которым следует его вывод ошибки:

4594 

4595```text theme={null}

4596otelHeadersHelper failed; telemetry is not being exported. See /status: exited 1: token service unreachable

4597```

4598 

4599**Что делать:**

4600 

4601* Выполните `/status` для чтения деталей отказа.

4602* Исправьте скрипт так, чтобы он выходил 0 в течение 30 секунд и выводил объект JSON значений заголовков строк на stdout. См. [требования скрипта](/docs/ru/monitoring-usage#script-requirements).

4603* Если ваша организация развёртывает скрипт через [managed settings](/docs/ru/managed-settings), попросите того, кто их поддерживает, исправить это.

4604 

4605В [non-interactive mode](/docs/ru/headless) с `-p`, тот же отказ появляется на stderr как `otelHeadersHelper failed (OpenTelemetry export headers unavailable): <error>` вместо этого.

4606 

4461<h3 id="headershelper-not-run">4607<h3 id="headershelper-not-run">

4462 headersHelper not run4608 headersHelper not run

4463</h3>4609</h3>

4652 4798 

4653* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке4799* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке

4654* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна4800* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна

4655* [Автоматический переход на резервную модель](/docs/ru/model-config#automatic-model-fallback) на Fable 5.1, Fable 5 и Opus 5 переводит сеанс на резервную модель категории с флагом, когда у этой категории она есть, и показывает уведомление в расшифровке4801* [Автоматический переход на резервную модель](/docs/ru/model-config#automatic-model-fallback) на Fable 5.1, Fable 5, Opus 5.5 и Opus 5 переводит сеанс на резервную модель категории с флагом, когда у этой категории она есть, и показывает уведомление в расшифровке

4656 4802 

4657Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый переход на резервную модель.4803Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый переход на резервную модель.

4658 4804 

fast-mode.md +12 −7

Details

12 12 

13Быстрый режим — это высокоскоростная конфигурация для Claude Opus, которая делает модель в 2,5 раза быстрее при более высокой стоимости за токен. Включайте его с помощью `/fast`, когда вам нужна скорость для интерактивной работы, такой как быстрая итерация или живая отладка, и отключайте, когда стоимость важнее, чем задержка.13Быстрый режим — это высокоскоростная конфигурация для Claude Opus, которая делает модель в 2,5 раза быстрее при более высокой стоимости за токен. Включайте его с помощью `/fast`, когда вам нужна скорость для интерактивной работы, такой как быстрая итерация или живая отладка, и отключайте, когда стоимость важнее, чем задержка.

14 14 

15Быстрый режим — это не другая модель. Он использует Claude Opus с другой конфигурацией API, которая приоритизирует скорость над экономичностью. Вы получаете идентичное качество и возможности с более быстрыми ответами. Быстрый режим поддерживается на Opus 5 и Opus 4.8. Он недоступен на Sonnet, Haiku или других моделях.15Быстрый режим — это не другая модель. Он использует Claude Opus с другой конфигурацией API, которая приоритизирует скорость над экономичностью. Вы получаете идентичное качество и возможности с более быстрыми ответами. Быстрый режим поддерживается на Opus 5.5, Opus 5 и Opus 4.8. Он недоступен на Sonnet, Haiku или других моделях.

16 16 

17Claude Code рассматривает Opus 4.7 как любую другую модель без поддержки быстрого режима: переключение на неё отключает быстрый режим. Быстрый режим для Opus 4.7 был объявлен устаревшим 25 июня 2026 года и удален 24 июля 2026 года.17Opus 4.7 не поддерживает быстрый режим, поэтому переключение на него отключает быстрый режим. Быстрый режим для Opus 4.7 был объявлен устаревшим 25 июня 2026 года и удален 24 июля 2026 года.

18 18 

19Что нужно знать:19Что нужно знать:

20 20 

21* Используйте `/fast` для включения быстрого режима в Claude Code CLI. Расширение VS Code следует вашей настройке [`fastMode`](#toggle-fast-mode) и предлагает команду **Toggle fast mode** при выборе модели, которая поддерживает быстрый режим.21* Используйте `/fast` для включения быстрого режима в Claude Code CLI. Расширение [VS Code](/docs/ru/vs-code) предлагает команду **Toggle fast mode** при выборе модели, которая поддерживает быстрый режим. Claude Code сохраняет этот переключатель в вашей настройке [`fastMode`](#toggle-fast-mode).

22* Цены на быстрый режим составляют \$10/\$50 за MTok входа/выхода на Opus 5 и Opus 4.8.22* Цены на быстрый режим составляют \$8/\$40 за MTok входа/выхода на Opus 5.5 и \$10/\$50 на Opus 5 и Opus 4.8.

23* Доступно пользователям Claude Code на планах подписки (Pro/Max/Team/Enterprise) и на Claude Console. Организациям Team и Enterprise требуется, чтобы Owner сначала это включил, а организациям Console требуется сначала предоставить доступ, оба варианта описаны в разделе [Requirements](#requirements).23* Доступно пользователям Claude Code на планах подписки (Pro/Max/Team/Enterprise) и на Claude Console. Организациям Team и Enterprise требуется, чтобы Owner сначала это включил, а организациям Console требуется сначала предоставить доступ, оба варианта описаны в разделе [Requirements](#requirements).

24* Для пользователей Claude Code на планах подписки (Pro/Max/Team/Enterprise) быстрый режим доступен только через кредиты использования и не включен в лимиты скорости подписки.24* Для пользователей Claude Code на планах подписки (Pro/Max/Team/Enterprise) быстрый режим доступен только через кредиты использования и не включен в лимиты скорости подписки.

25 25 

29 29 

30В CLI включайте быстрый режим одним из следующих способов:30В CLI включайте быстрый режим одним из следующих способов:

31 31 

32* Введите `/fast` и нажмите Tab для включения или отключения32* Запустите `/fast`, нажмите Space для включения или отключения, затем нажмите Enter для подтверждения

33* Установите `"fastMode": true` в вашем [файле пользовательских настроек](/docs/ru/settings)33* Установите `"fastMode": true` в вашем [файле пользовательских настроек](/docs/ru/settings)

34 34 

35По умолчанию быстрый режим, который вы включаете в интерактивном сеансе, сохраняется между сеансами. Вы можете настроить быстрый режим на сброс каждого сеанса. Подробности см. в разделе [обязательное согласие за сеанс](#require-per-session-opt-in).35По умолчанию быстрый режим, который вы включаете в интерактивном сеансе, сохраняется между сеансами. Вы можете настроить быстрый режим на сброс каждого сеанса. Подробности см. в разделе [обязательное согласие за сеанс](#require-per-session-opt-in).

47* Рядом с приглашением появляется небольшой значок `↯` во время активного быстрого режима47* Рядом с приглашением появляется небольшой значок `↯` во время активного быстрого режима

48* Запустите `/fast` снова в любое время, чтобы проверить, включен или отключен быстрый режим48* Запустите `/fast` снова в любое время, чтобы проверить, включен или отключен быстрый режим

49 49 

50Opus 5 является стандартным режимом быстрого режима в Claude Code v2.1.219 и позже. До версии v2.1.219 быстрый режим по умолчанию использовал Opus 4.8 на версиях v2.1.154 по v2.1.218 и Opus 4.7 на версиях v2.1.142 по v2.1.153.50Opus 5.5 является стандартным режимом быстрого режима в Claude Code v2.1.280 и позже. До версии v2.1.280 быстрый режим по умолчанию использовал Opus 5 с версии v2.1.219, Opus 4.8 на версиях v2.1.154 по v2.1.218 и Opus 4.7 на версиях v2.1.142 по v2.1.153.

51 51 

52Когда вы отключаете быстрый режим с помощью `/fast` снова, вы остаетесь на Opus. Чтобы переключиться на другую модель, используйте `/model`.52Когда вы отключаете быстрый режим с помощью `/fast` снова, вы остаетесь на Opus. Чтобы переключиться на другую модель, используйте `/model`.

53 53 

80 80 

81| Модель | Входные данные (MTok) | Выходные данные (MTok) |81| Модель | Входные данные (MTok) | Выходные данные (MTok) |

82| -------- | --------------------- | ---------------------- |82| -------- | --------------------- | ---------------------- |

83| Opus 5.5 | \$8 | \$40 |

83| Opus 5 | \$10 | \$50 |84| Opus 5 | \$10 | \$50 |

84| Opus 4.8 | \$10 | \$50 |85| Opus 4.8 | \$10 | \$50 |

85 86 

145* **Включение владельцем для Team и Enterprise**: быстрый режим отключен по умолчанию для организаций Team и Enterprise. Владелец должен явно [включить быстрый режим](#enable-fast-mode-for-your-organization) перед тем, как пользователи смогут получить к нему доступ.146* **Включение владельцем для Team и Enterprise**: быстрый режим отключен по умолчанию для организаций Team и Enterprise. Владелец должен явно [включить быстрый режим](#enable-fast-mode-for-your-organization) перед тем, как пользователи смогут получить к нему доступ.

146 147 

147<Note>148<Note>

148 Два параметра организации могут заблокировать включение быстрого режима с помощью `/fast`:149 Четыре параметра организации могут заблокировать включение быстрого режима с помощью `/fast`:

149 150 

150 * **Быстрый режим не включен**: если быстрый режим не был включен для вашей организации, включение быстрого режима с помощью `/fast` показывает "Fast mode has been disabled by your organization."151 * **Быстрый режим не включен**: если быстрый режим не был включен для вашей организации, включение быстрого режима с помощью `/fast` показывает "Fast mode has been disabled by your organization."

152 * **Быстрый режим отключен управляемыми параметрами**: если ваша организация развертывает [управляемые параметры](/docs/ru/managed-settings), которые устанавливают [`fastMode: false`](/docs/ru/settings-reference#fastmode), включение быстрого режима с помощью `/fast` показывает то же сообщение "Fast mode has been disabled by your organization".

153 * **Требуется явное согласие для каждого сеанса**: управляемые параметры, которые устанавливают [`fastModePerSessionOptIn: true`](#require-per-session-opt-in), отклоняют `/fast on` с тем же сообщением везде, кроме интерактивного сеанса терминала.

151 * **Модель быстрого режима не разрешена**: если список разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) вашей организации исключает модель Opus быстрого режима, включение отклоняется с "is not in your organization's allowed models". В сеансе, уже работающем на разрешенной модели Opus, поддерживающей быстрый режим, `/fast` вместо этого включает быстрый режим на вашей текущей модели без переключения моделей.154 * **Модель быстрого режима не разрешена**: если список разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) вашей организации исключает модель Opus быстрого режима, включение отклоняется с "is not in your organization's allowed models". В сеансе, уже работающем на разрешенной модели Opus, поддерживающей быстрый режим, `/fast` вместо этого включает быстрый режим на вашей текущей модели без переключения моделей.

152</Note>155</Note>

153 156 

204 207 

205Это полезно для контроля затрат в организациях, где пользователи запускают несколько одновременных сеансов. Предпочтение быстрого режима пользователя все еще сохраняется, поэтому удаление этого параметра восстанавливает поведение по умолчанию с сохранением.208Это полезно для контроля затрат в организациях, где пользователи запускают несколько одновременных сеансов. Предпочтение быстрого режима пользователя все еще сохраняется, поэтому удаление этого параметра восстанавливает поведение по умолчанию с сохранением.

206 209 

210Когда управляемые параметры устанавливают ключ, `/fast on` работает только в интерактивном сеансе терминала. Везде еще, включая [неинтерактивный режим](/docs/ru/headless), [расширение VS Code](/docs/ru/vs-code) и [облачные сеансы](#use-fast-mode-in-cloud-sessions), это отклоняется с сообщением, что ваша организация отключила быстрый режим.

211 

207<h2 id="handle-rate-limits">212<h2 id="handle-rate-limits">

208 Обработка лимитов скорости213 Обработка лимитов скорости

209</h2>214</h2>

Details

21Расширения подключаются к различным частям цикла агента:21Расширения подключаются к различным частям цикла агента:

22 22 

23* **[CLAUDE.md](/docs/ru/memory)** добавляет постоянный контекст, который Claude видит в каждой сессии23* **[CLAUDE.md](/docs/ru/memory)** добавляет постоянный контекст, который Claude видит в каждой сессии

24* **[Output styles](/docs/ru/output-styles)** устанавливают роль Claude, тон и формат ответа для каждого ответа в сессии

24* **[Skills](/docs/ru/skills)** добавляют переиспользуемые знания и вызываемые рабочие процессы25* **[Skills](/docs/ru/skills)** добавляют переиспользуемые знания и вызываемые рабочие процессы

25* **[Code intelligence](/docs/ru/tools-reference#lsp-tool-behavior)** подключает Claude к языковому серверу для навигации на уровне символов и ошибок типов в реальном времени26* **[Code intelligence](/docs/ru/tools-reference#lsp-tool-behavior)** подключает Claude к языковому серверу для навигации на уровне символов и ошибок типов в реальном времени

26* **[MCP](/docs/ru/mcp)** подключает Claude к внешним сервисам и инструментам27* **[MCP](/docs/ru/mcp)** подключает Claude к внешним сервисам и инструментам

36 Сопоставьте функции с вашей целью37 Сопоставьте функции с вашей целью

37</h2>38</h2>

38 39 

39Функции варьируются от всегда включённого контекста, который Claude видит в каждой сессии, до возможностей по требованию, которые вы или Claude можете вызвать, до фоновой автоматизации, которая работает при определённых событиях. Таблица ниже показывает, что доступно и когда каждое имеет смысл.40Функции варьируются от всегда включённого контекста, который Claude видит в каждой сессии, до функций по требованию, которые вы или Claude можете вызвать, до фоновой автоматизации, которая запускается при определённых событиях. В таблице ниже показано, что доступно и когда каждое имеет смысл.

40 41 

41| Функция | Что она делает | Когда её использовать | Пример |42| Функция | Что она делает | Когда её использовать | Пример |

42| -------------------------------------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |43| -------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |

43| **CLAUDE.md** | Постоянный контекст, загружаемый в каждом разговоре | Соглашения проекта, правила "всегда делай X" | "Используйте pnpm, а не npm. Запускайте тесты перед коммитом." |44| **CLAUDE.md** | Постоянный контекст, загружаемый в каждый разговор | Соглашения проекта, правила «всегда делай X» | «Используй pnpm, а не npm. Запускай тесты перед коммитом.» |

44| **Skill** | Инструкции, знания и рабочие процессы, которые может использовать Claude | Переиспользуемый контент, справочные документы, повторяющиеся задачи | `/deploy` запускает ваш контрольный список развёртывания; skill с документацией API с шаблонами конечных точек |45| **[Output style](/docs/ru/output-styles)** | Инструкции, которые устанавливают роль Claude, тон и формат ответа для целой сессии | Голос, длину или формат, который вы хотите в каждом ответе, или Claude, работающий как что-то другое, чем инженер-программист | Встроенный стиль Concise для более коротких ответов; пользовательский стиль, который отвечает на каждый вопрос с диаграммой в первую очередь |

45| **Subagent** | Изолированный контекст выполнения, который возвращает обобщённые результаты | Изоляция контекста, параллельные задачи, специализированные работники | Задача исследования, которая читает много файлов, но возвращает только ключевые выводы |46| **Skill** | Инструкции, знания и рабочие процессы, которые может использовать Claude | Переиспользуемый контент, справочные документы, повторяющиеся задачи | `/deploy` запускает твой контрольный список развёртывания; skill с документацией API с шаблонами конечных точек |

46| **[Dynamic workflow](/docs/ru/workflows)** | Скрипт, который пишет Claude и запускает много subagents в фоне | Работа, которая превосходит несколько subagents, или выводы, которые вы хотите перепроверить | Аудит всей кодовой базы, со вторым набором агентов, проверяющих каждый вывод |47| **Subagent** | Изолированный контекст выполнения, который возвращает обобщённые результаты | Изоляция контекста, параллельные задачи, специализированные рабочие | Задача исследования, которая читает много файлов, но возвращает только ключевые выводы |

47| **[Cross-session messaging](/docs/ru/cross-session-messaging)** | Claude доставляет сообщение из одной из ваших сессий в другую | Сессии, которые вы запускаете сами и которым нужны выводы друг друга в середине задачи | Одна сессия предупреждает другую, что изменение, которое она сделала, нарушает то, на чём строится другая |48| **[Dynamic workflow](/docs/ru/workflows)** | Скрипт, который пишет Claude и запускает много subagent'ов в фоне | Работа, которая переросла несколько subagent'ов, или выводы, которые ты хочешь перепроверить | Проверь весь кодовую базу, со вторым набором агентов, проверяющих каждый вывод |

48| **[Code intelligence](/docs/ru/tools-reference#lsp-tool-behavior)** | Навигация языкового сервера и диагностика | Типизированные языки, большие кодовые базы, где grep медленен или неточен | Перейти к определению символа вместо чтения всего файла |49| **[Cross-session messaging](/docs/ru/cross-session-messaging)** | Claude доставляет сообщение из одной из твоих сессий в другую | Сессии, которые ты запускаешь сам и которым нужны выводы друг друга в середине задачи | Одна сессия предупреждает другую, что изменение, которое она сделала, нарушает то, на чём строится другая |

49| **MCP** | Подключение к внешним сервисам | Внешние данные или действия | Запрос к вашей базе данных, отправка в Slack, управление браузером |50| **[Code intelligence](/docs/ru/tools-reference#lsp-tool-behavior)** | Навигация и диагностика языкового сервера | Типизированные языки, большие кодовые базы, где grep медленен или неточен | Перейди к определению символа вместо чтения всего файла |

50| **Hook** | Скрипт, HTTP запрос, вызов инструмента MCP, prompt или subagent, запущенные событиями | Автоматизация, которая должна работать при каждом соответствующем событии | Запуск ESLint после каждого редактирования файла |51| **MCP** | Подключись к внешним сервисам | Внешние данные или действия | Запроси свою базу данных, опубликуй в Slack, управляй браузером |

51| **[Artifact](/docs/ru/artifacts)** | Опубликуйте вывод сессии как приватную интерактивную веб-страницу | Вывод, который вы хотите увидеть или поделиться визуально, а не как текст терминала | Временная шкала инцидента, которая обновляется по мере исследования Claude |52| **Hook** | Скрипт, HTTP-запрос, вызов инструмента MCP, подсказка или subagent, запущенные событиями | Автоматизация, которая должна запуститься при каждом совпадающем событии | Запусти ESLint после каждого редактирования файла |

52 53| **[Artifact](/docs/ru/artifacts)** | Опубликуй вывод сессии как приватную интерактивную веб-страницу | Вывод, который ты хочешь увидеть или поделиться визуально, а не как текст терминала | Временная шкала инцидента, которая обновляется по мере того, как Claude расследует |

53**[Plugins](/docs/ru/plugins)** — это уровень упаковки. Plugin объединяет skills, hooks, subagents и MCP servers в единый устанавливаемый модуль. Plugin skills имеют пространство имён (например, `/my-plugin:review`), поэтому несколько plugins могут сосуществовать. Используйте plugins, когда вы хотите переиспользовать одну и ту же настройку в нескольких репозиториях или распространять другим через **[marketplace](/docs/ru/plugin-marketplaces)**.54 

55**[Plugins](/docs/ru/plugins)** — это уровень упаковки. Plugin объединяет skills, hooks, subagent'ов и MCP-серверы в один устанавливаемый модуль. Skills плагина имеют пространство имён (например `/my-plugin:review`), поэтому несколько плагинов могут сосуществовать. Используй плагины, когда ты хочешь переиспользовать одну и ту же настройку в нескольких репозиториях или распространять другим через **[marketplace](/docs/ru/plugin-marketplaces)**.

54 56 

55<h3 id="build-your-setup-over-time">57<h3 id="build-your-setup-over-time">

56 Сформируйте вашу настройку со временем58 Строй свою настройку со временем

57</h3>59</h3>

58 60 

59Вам не нужно настраивать всё заранее. Каждая функция имеет узнаваемый триггер, и большинство команд добавляют их примерно в таком порядке:61Тебе не нужно настраивать всё заранее. Каждая функция имеет узнаваемый триггер, и большинство команд добавляют их примерно в таком порядке:

60 62 

61| Триггер | Добавить |63| Триггер | Добавь |

62| :--------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------- |64| :---------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |

63| Claude дважды неправильно применяет соглашение или команду | Добавьте в [CLAUDE.md](/docs/ru/memory) |65| Claude дважды неправильно применяет соглашение или команду | Добавь это в [CLAUDE.md](/docs/ru/memory) |

64| Вы постоянно вводите один и тот же prompt для начала задачи | Сохраните как вызываемый пользователем [skill](/docs/ru/skills) |66| Вы постоянно просите Claude быть короче, объяснять больше или отвечать в одном формате | Установите [output style](/docs/ru/output-styles) |

65| Вы вставляете один и тот же playbook или многошаговую процедуру в чат в третий раз | Захватите как [skill](/docs/ru/skills) |67| Ты постоянно печатаешь одну и ту же подсказку, чтобы начать задачу | Сохрани её как вызываемый пользователем [skill](/docs/ru/skills) |

66| Вы постоянно копируете данные из вкладки браузера, которую Claude не видит | Подключите эту систему как [MCP server](/docs/ru/mcp) |68| Ты вставляешь один и тот же сценарий или многошаговую процедуру в чат в третий раз | Захвати это как [skill](/docs/ru/skills) |

67| Claude читает много файлов, чтобы найти, где определён или используется символ | Установите [плагин code intelligence](/docs/ru/discover-plugins#code-intelligence) для вашего языка |69| Ты постоянно копируешь данные из вкладки браузера, которую Claude не видит | Подключи эту систему как [MCP-сервер](/docs/ru/mcp) |

68| Побочная задача заполняет ваш разговор выводом, на который вы больше не будете ссылаться | Маршрутизируйте через [subagent](/docs/ru/sub-agents) |70| Claude читает много файлов, чтобы найти, где определён или используется символ | Установи [плагин code intelligence](/docs/ru/discover-plugins#code-intelligence) для твоего языка |

69| Вы хотите, чтобы что-то происходило каждый раз без запроса | Напишите [hook](/docs/ru/hooks-guide) |71| Побочная задача заполняет твой разговор выводом, на который ты больше не будешь ссылаться | Маршрутизируй его через [subagent](/docs/ru/sub-agents) |

70| Второй репозиторий нуждается в одной и той же настройке | Упакуйте как [plugin](/docs/ru/plugins) |72| Ты хочешь, чтобы что-то происходило каждый раз без просьбы | Напиши [hook](/docs/ru/hooks-guide) |

73| Второй репозиторий нуждается в одной и той же настройке | Упакуй это как [plugin](/docs/ru/plugins) |

71 74 

72Те же триггеры говорят вам, когда обновлять то, что у вас уже есть. Повторяющаяся ошибка или повторяющийся комментарий рецензии — это редактирование CLAUDE.md, а не одноразовое исправление в чате. Рабочий процесс, который вы постоянно подправляете вручную, — это skill, который нуждается в другой редакции.75Те же триггеры говорят тебе, когда обновить то, что у тебя уже есть. Повторяющаяся ошибка или повторяющийся комментарий при проверке — это редактирование CLAUDE.md, а не одноразовое исправление в чате. Рабочий процесс, который ты постоянно подправляешь вручную, — это skill, который нуждается в другой редакции.

73 76 

74<h3 id="compare-similar-features">77<h3 id="compare-similar-features">

75 Сравните похожие функции78 Сравни похожие функции

76</h3>79</h3>

77 80 

78Некоторые функции могут казаться похожими. Для более глубокого разбора выбора между ними см. [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) в блоге. Вот как их различить.81Некоторые функции могут казаться похожими. Для более глубокого разбора выбора между ними см. [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) в блоге. Вот как их различить.

79 82 

80<Tabs>83<Tabs>

81 <Tab title="Skill vs Subagent">84 <Tab title="Skill vs Subagent">

82 Skills и subagents решают разные проблемы:85 Skills и subagent'ы решают разные проблемы:

83 86 

84 * **Skills** — это переиспользуемый контент, который вы можете загрузить в любой контекст87 * **Skills** — это переиспользуемый контент, который ты можешь загрузить в любой контекст

85 * **Subagents** — это изолированные работники, которые работают отдельно от вашего основного разговора88 * **Subagent'ы** — это изолированные рабочие, которые запускаются отдельно от твоего основного разговора

86 89 

87 | Аспект | Skill | Subagent |90 | Аспект | Skill | Subagent |

88 | --------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------- |91 | --------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------ |

89 | **Что это** | Переиспользуемые инструкции, знания или рабочие процессы | Изолированный работник со своим собственным контекстом |92 | **Что это** | Переиспользуемые инструкции, знания или рабочие процессы | Изолированный рабочий со своим собственным контекстом |

90 | **Ключевое преимущество** | Поделитесь контентом между контекстами | Изоляция контекста. Работа происходит отдельно, возвращается только резюме |93 | **Ключевое преимущество** | Поделись контентом между контекстами | Изоляция контекста. Работа происходит отдельно, возвращается только резюме |

91 | **[Влияние на окно контекста](/docs/ru/context-window)** | Добавляется в ваше основное окно | Использует отдельное окно со своими входными и выходными токенами |94 | **Влияние на [context window](/docs/ru/context-window)** | Добавляется в твоё основное окно | Использует отдельное окно со своими входными и выходными токенами |

92 | **Лучше всего для** | Справочный материал, вызываемые рабочие процессы | Задачи, которые читают много файлов, параллельная работа, специализированные работники |95 | **Лучше всего для** | Справочный материал, вызываемые рабочие процессы | Задачи, которые читают много файлов, параллельная работа, специализированные рабочие |

93 96 

94 **Skills могут быть справочными или действенными.** Справочные skills предоставляют знания, которые Claude использует на протяжении вашей сессии (например, ваше руководство по стилю API). Action skills говорят Claude сделать что-то конкретное (например, `/deploy`, который запускает ваш рабочий процесс развёртывания).97 **Skills могут быть справочными или действенными.** Справочные skills предоставляют знания, которые Claude использует на протяжении твоей сессии (например, твой справочник стиля API). Action skills говорят Claude сделать что-то конкретное (например, `/deploy`, который запускает твой рабочий процесс развёртывания).

95 98 

96 **Используйте subagent**, когда вам нужна изоляция контекста или когда ваше окно контекста переполняется. Subagent может читать десятки файлов или выполнять обширные поиски, но ваш основной разговор получает только резюме. Поскольку работа subagent не потребляет ваш основной контекст, это также полезно, когда вам не нужно, чтобы промежуточная работа оставалась видимой. Пользовательские subagents могут иметь свои собственные инструкции и могут предварительно загружать skills.99 **Используй subagent**, когда тебе нужна изоляция контекста или когда твоё окно контекста переполняется. Subagent может читать десятки файлов или запускать обширные поиски, но твой основной разговор получает только резюме. Поскольку работа subagent'а не потребляет твой основной контекст, это также полезно, когда тебе не нужна промежуточная работа, чтобы оставаться видимой. Пользовательские subagent'ы могут иметь свои собственные инструкции и могут предварительно загружать skills.

97 100 

98 **Они могут объединяться.** Subagent может предварительно загружать определённые skills (поле `skills:`). Skill может работать в изолированном контексте, используя `context: fork`. Подробнее см. в разделе [Skills](/docs/ru/skills).101 **Они могут объединяться.** Subagent может предварительно загружать определённые skills (поле `skills:`). Skill может запускаться в изолированном контексте, используя `context: fork`. Подробнее см. в [Skills](/docs/ru/skills).

99 </Tab>102 </Tab>

100 103 

101 <Tab title="CLAUDE.md vs Skill">104 <Tab title="CLAUDE.md vs Skill">

106 | **Загружается** | Каждая сессия, автоматически | По требованию |109 | **Загружается** | Каждая сессия, автоматически | По требованию |

107 | **Может включать файлы** | Да, с импортами `@path` | Да, с импортами `@path` |110 | **Может включать файлы** | Да, с импортами `@path` | Да, с импортами `@path` |

108 | **Может запускать рабочие процессы** | Нет | Да, с `/<name>` |111 | **Может запускать рабочие процессы** | Нет | Да, с `/<name>` |

109 | **Лучше всего для** | Правила "всегда делай X" | Справочный материал, вызываемые рабочие процессы |112 | **Лучше всего для** | Правила «всегда делай X» | Справочный материал, вызываемые рабочие процессы |

110 113 

111 **Поместите в CLAUDE.md**, если Claude должен всегда это знать: соглашения кодирования, команды сборки, структура проекта, правила "никогда не делай X".114 **Поместите это в CLAUDE.md**, если Claude должен всегда это знать: соглашения кодирования, команды сборки, структура проекта, правила «никогда не делай X».

112 115 

113 **Поместите в skill**, если это справочный материал, который Claude иногда нужен (документация API, руководства по стилю) или рабочий процесс, который вы запускаете с помощью `/<name>` (развёртывание, рецензирование, выпуск).116 **Поместите это в skill**, если это справочный материал, который Claude иногда нужен (документация API, справочники стилей) или рабочий процесс, который ты запускаешь с `/<name>` (развёртывание, проверка, выпуск).

114 117 

115 **Практическое правило:** Держите CLAUDE.md под 200 строк. Если он растёт, переместите справочный контент в skills или разделите на файлы [`.claude/rules/`](/docs/ru/memory#organize-rules-with-claude%2Frules%2F).118 **Правило большого пальца:** Держите CLAUDE.md под 200 строк. Если он растёт, переместите справочный контент в skills или разделите на файлы [`.claude/rules/`](/docs/ru/memory#organize-rules-with-claude/rules/).

119 </Tab>

120 

121 <Tab title="CLAUDE.md vs Output style">

122 Оба дают Claude постоянные инструкции. CLAUDE.md содержит то, что Claude должен знать, и output style устанавливает, как Claude отвечает.

123 

124 | Аспект | CLAUDE.md | Output style |

125 | ------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |

126 | **Содержит** | Факты и правила о вашем проекте | Роль, тон и формат ответа |

127 | **Переключение** | Всегда загружается | Один активный одновременно; [переключайте стили](/docs/ru/output-styles#change-your-output-style) когда угодно |

128 | **Лучше всего для** | Команды сборки, соглашения, правила «никогда не делай X» | Более короткие ответы, объяснения рядом с кодом, роль, отличная от инженера |

129 

130 **Поместите это в CLAUDE.md**, если это верно для проекта в любом стиле: соглашения кодирования, команды сборки, структура проекта.

131 

132 **Используйте output style**, если это о самом ответе и вы можете захотеть его отключить: длина, формат, сколько Claude объясняет, или другая роль, такая как помощник по письму. Claude Code включает [встроенные стили](/docs/ru/output-styles#built-in-output-styles), и вы можете написать свои собственные.

133 

134 **Они объединяются.** CLAUDE.md остаётся загруженным, какой бы стиль вы ни выбрали. Claude следует обоим как инструкциям, поэтому ни один не применяется. Для чего-либо, что должно происходить каждый раз, используйте [hook](/docs/ru/hooks-guide).

116 </Tab>135 </Tab>

117 136 

118 <Tab title="CLAUDE.md vs Rules vs Skills">137 <Tab title="CLAUDE.md vs Rules vs Skills">

119 Все три хранят инструкции, но они загружаются по-разному:138 Все три хранят инструкции, но они загружаются по-разному:

120 139 

121 | Аспект | CLAUDE.md | `.claude/rules/` | Skill |140 | Аспект | CLAUDE.md | `.claude/rules/` | Skill |

122 | ------------------- | ------------------------------------ | ---------------------------------------------------------- | --------------------------------------------------- |141 | ------------------- | ------------------------------------ | ------------------------------------------------------ | --------------------------------------------------- |

123 | **Загружается** | Каждая сессия | Каждая сессия, или когда открываются соответствующие файлы | По требованию, при вызове или релевантности |142 | **Загружается** | Каждая сессия | Каждая сессия, или когда открываются совпадающие файлы | По требованию, когда вызывается или релевантно |

124 | **Область** | Весь проект | Может быть ограничена путями файлов | Специфична для задачи |143 | **Область** | Весь проект | Может быть ограничена путями файлов | Специфична для задачи |

125 | **Лучше всего для** | Основные соглашения и команды сборки | Рекомендации, специфичные для языка или каталога | Справочный материал, повторяющиеся рабочие процессы |144 | **Лучше всего для** | Основные соглашения и команды сборки | Рекомендации, специфичные для языка или каталога | Справочный материал, повторяющиеся рабочие процессы |

126 145 

127 **Используйте CLAUDE.md** для инструкций, которые нужны каждой сессии: команды сборки, соглашения тестирования, архитектура проекта.146 **Используй CLAUDE.md** для инструкций, которые каждая сессия нуждается: команды сборки, соглашения тестирования, архитектура проекта.

128 147 

129 **Используйте rules**, чтобы сосредоточить CLAUDE.md. Rules с [frontmatter `paths`](/docs/ru/memory#path-specific-rules) загружаются только, когда Claude работает с соответствующими файлами, экономя контекст.148 **Используй rules**, чтобы держать CLAUDE.md сосредоточенным. Rules с [frontmatter `paths`](/docs/ru/memory#path-specific-rules) загружаются только когда Claude работает с совпадающими файлами, экономя контекст.

130 149 

131 **Используйте skills** для контента, который Claude нужен только иногда, например документация API или контрольный список развёртывания, который вы запускаете с помощью `/<name>`.150 **Используй skills** для контента, который Claude нужен только иногда, например документация API или контрольный список развёртывания, который ты запускаешь с `/<name>`.

132 </Tab>151 </Tab>

133 152 

134 <Tab title="Subagent vs Dynamic workflow">153 <Tab title="Subagent vs Dynamic workflow">

135 Оба выполняют работу вне вашего основного разговора. С subagents Claude решает поворот за поворотом, что запускается дальше. В workflow скрипт решает:154 Оба выполняют работу вне твоего основного разговора. С subagent'ами Claude решает поворот за поворотом, что запускается дальше. В рабочем процессе скрипт решает:

136 155 

137 * **Subagents** — это работники, которых Claude запускает, каждый возвращая резюме в разговор, который его запустил156 * **Subagent'ы** — это рабочие, которых Claude запускает, каждый возвращая резюме в разговор, который его запустил

138 * **[Dynamic workflows](/docs/ru/workflows)** — это скрипты, которые пишет Claude и запускают много subagents в фоне и возвращают один результат157 * **[Dynamic workflows](/docs/ru/workflows)** — это скрипты, которые пишет Claude и запускают много subagent'ов в фоне и возвращают один результат

139 158 

140 **Используйте subagent**, когда вам нужен быстрый, сосредоточенный работник: исследуйте вопрос, проверьте утверждение, рецензируйте файл. Subagent выполняет работу и возвращает резюме, поэтому ваш основной разговор остаётся чистым. Subagents, которых Claude назвал при их запуске, также могут [обмениваться сообщениями друг с другом](/docs/ru/sub-agents#what-loads-at-startup).159 **Используй subagent**, когда тебе нужен быстрый, сосредоточенный рабочий: исследуй вопрос, проверь утверждение, проверь файл. Subagent выполняет работу и возвращает резюме, поэтому твой основной разговор остаётся чистым. Subagent'ы, которых Claude назвал при их запуске, также могут [обмениваться сообщениями друг с другом](/docs/ru/sub-agents#what-loads-at-startup).

141 160 

142 **Используйте dynamic workflow**, когда работа [превосходит несколько subagents](/docs/ru/workflows#when-to-use-a-workflow), или когда вы хотите, чтобы выводы были перепроверены перед тем, как вы их увидите, такие как аудит всей кодовой базы, крупная миграция или план, разработанный с нескольких углов. Чтобы начать один, [попросите workflow в вашем prompt](/docs/ru/workflows#ask-for-a-workflow-in-your-prompt).161 **Используй dynamic workflow**, когда работа [переросла несколько subagent'ов](/docs/ru/workflows#when-to-use-a-workflow), или когда ты хочешь, чтобы выводы были перепроверены перед тем, как ты их увидишь, например аудит всей кодовой базы, крупная миграция или план, составленный с нескольких углов. Чтобы начать один, [попроси рабочий процесс в своей подсказке](/docs/ru/workflows#ask-for-a-workflow-in-your-prompt).

143 162 

144 **Чтобы передать вывод из одной из ваших сессий в другую**, попросите Claude первой сессии отправить его. Claude доставляет его с помощью [cross-session messaging](/docs/ru/cross-session-messaging). [Запуск агентов параллельно](/docs/ru/agents) сравнивает другие способы запуска более чем одного Claude одновременно, включая сессии, которые вы передаёте и проверяете позже.163 **Чтобы передать вывод из одной из твоих сессий в другую**, попроси Claude первой сессии отправить его. Claude доставляет его с помощью [cross-session messaging](/docs/ru/cross-session-messaging). [Run agents in parallel](/docs/ru/agents) сравнивает другие способы запуска более чем одного Claude одновременно, включая сессии, которые ты передаёшь и проверяешь позже.

145 </Tab>164 </Tab>

146 165 

147 <Tab title="MCP vs Skill">166 <Tab title="MCP vs Skill">

148 MCP подключает Claude к внешним сервисам. Skills расширяют то, что знает Claude, включая то, как эффективно использовать эти сервисы.167 MCP подключает Claude к внешним сервисам. Skills расширяют то, что знает Claude, включая то, как эффективно использовать эти сервисы.

149 168 

150 | Аспект | MCP | Skill |169 | Аспект | MCP | Skill |

151 | ----------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |170 | ----------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------- |

152 | **Что это** | Протокол для подключения к внешним сервисам | Знания, рабочие процессы и справочный материал |171 | **Что это** | Протокол для подключения к внешним сервисам | Знания, рабочие процессы и справочный материал |

153 | **Предоставляет** | Инструменты и доступ к данным | Знания, рабочие процессы, справочный материал |172 | **Предоставляет** | Инструменты и доступ к данным | Знания, рабочие процессы, справочный материал |

154 | **Примеры** | Интеграция Slack, запросы к базе данных, управление браузером | Контрольный список рецензирования кода, рабочий процесс развёртывания, руководство по стилю API |173 | **Примеры** | Интеграция Slack, запросы к базе данных, управление браузером | Контрольный список проверки кода, рабочий процесс развёртывания, справочник стиля API |

155 174 

156 Они решают разные проблемы и хорошо работают вместе:175 Они решают разные проблемы и хорошо работают вместе:

157 176 

158 **MCP** даёт Claude возможность взаимодействовать с внешними системами. Без MCP Claude не может запросить вашу базу данных или отправить сообщение в Slack.177 **MCP** даёт Claude специально разработанные инструменты для внешней системы, с подключением и аутентификацией, обработанными сервером.

159 178 

160 **Skills** дают Claude знания о том, как эффективно использовать эти инструменты, плюс рабочие процессы, которые вы можете запустить с помощью `/<name>`. Skill может включать схему базы данных вашей команды и шаблоны запросов, или рабочий процесс `/post-to-slack` с правилами форматирования сообщений вашей команды.179 **Skills** дают Claude знания о том, как эффективно использовать эти инструменты, плюс рабочие процессы, которые ты можешь запустить с `/<name>`. Skill может включать схему базы данных твоей команды и шаблоны запросов, или рабочий процесс `/post-to-slack` с правилами форматирования сообщений твоей команды.

161 </Tab>180 </Tab>

162 181 

163 <Tab title="Hook vs Skill">182 <Tab title="Hook vs Skill">

164 Hook срабатывает при событии жизненного цикла; skill загружается в контекст для применения Claude.183 Claude Code запускает hook при событии жизненного цикла; он загружает skill в контекст для Claude, чтобы применить.

165 184 

166 | Аспект | Hook | Skill |185 | Аспект | Hook | Skill |

167 | ----------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |186 | ----------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |

168 | **Запускает** | Команду shell, HTTP запрос, вызов инструмента MCP, LLM prompt или subagent | Инструкции, которые Claude читает и следует им |187 | **Запускает** | Команду shell, HTTP-запрос, вызов инструмента MCP, подсказку LLM или subagent'а | Инструкции, которые Claude читает и следует |

169 | **Запущено** | [События жизненного цикла](/docs/ru/hooks#hook-events) такие как `PostToolUse` или `SessionStart` | Вы вводите `/<name>`, или Claude сопоставляет описание с вашей задачей |188 | **Запущено** | [События жизненного цикла](/docs/ru/hooks#hook-events), такие как `PostToolUse` или `SessionStart` | Ты печатаешь `/<name>`, или Claude соответствует описанию твоей задаче |

170 | **Детерминизм** | Всегда срабатывает при своём событии; триггер гарантирован | Claude интерпретирует инструкции; результат может варьироваться |189 | **Детерминизм** | Всегда срабатывает при своём событии; триггер гарантирован | Claude интерпретирует инструкции; результат может варьироваться |

171 | **Стоимость контекста** | Ноль, если hook не возвращает вывод | Описание загружается каждую сессию; полный контент загружается при использовании |190 | **Стоимость контекста** | Ноль, если hook не возвращает вывод | Описание загружается каждую сессию; полный контент загружается при использовании |

172 | **Лучше всего для** | Линтинг после редактирования, блокирование небезопасных команд, логирование, уведомления | Рабочие процессы, которые нуждаются в рассуждении, справочный материал, многошаговые задачи |191 | **Лучше всего для** | Линтинг после редактирования, блокирование небезопасных команд, логирование, уведомления | Рабочие процессы, которые нуждаются в рассуждении, справочный материал, многошаговые задачи |

173 192 

174 **Используйте hook**, когда действие должно происходить одинаково каждый раз и не нуждается в размышлении Claude. Например: форматирование при сохранении, отклонение `rm -rf /`, отправка сообщения Slack при завершении сессии.193 **Используй hook**, когда действие должно происходить одинаково каждый раз и не нуждается в размышлении Claude. Например: форматирование при сохранении, отклонение `rm -rf /`, отправка сообщения Slack при завершении сессии.

175 194 

176 **Используйте skill**, когда Claude должен решить, как применить шаги, или когда контент — это знание, а не скрипт. Например: контрольный список `/release`, ваше руководство по стилю API, playbook отладки.195 **Используй skill**, когда Claude должен решить, как применить шаги, или когда контент — это знание, а не скрипт. Например: контрольный список `/release`, твой справочник стиля API, сценарий отладки.

177 196 

178 **Поместите guardrails в hooks.** Инструкция типа "никогда не редактируйте `.env`" в CLAUDE.md или skill — это запрос, а не гарантия. Hook `PreToolUse`, который блокирует редактирование, — это принуждение. Если правило должно выполняться каждый раз, сделайте его hook, а не инструкцию prompt.197 **Поместите guardrails в hooks.** Инструкция типа «никогда не редактируй `.env`» в CLAUDE.md или skill — это просьба, а не гарантия. Hook `PreToolUse`, который блокирует редактирование, — это принуждение. Если правило должно выполняться каждый раз, сделай его hook, а не инструкцию подсказки.

179 198 

180 **Вывод Hook попадает в контекст.** Hook `PostToolUse`, который запускает ваш linter, возвращает результаты как текст, который читает Claude; skill `/fix-lint` говорит Claude, как их разрешить.199 **Вывод Hook попадает в контекст.** Hook `PostToolUse`, который запускает твой линтер, возвращает результаты как текст, который читает Claude; skill `/fix-lint` говорит Claude, как их разрешить.

181 </Tab>200 </Tab>

182</Tabs>201</Tabs>

183 202 

185 Поймите, как функции слоятся204 Поймите, как функции слоятся

186</h3>205</h3>

187 206 

188Функции могут быть определены на нескольких уровнях: для всех пользователей, для каждого проекта, через plugins или через управляемые политики. Вы также можете вложить файлы CLAUDE.md в подкаталоги или разместить skills в определённых пакетах monorepo. Когда одна и та же функция существует на нескольких уровнях, вот как они слоятся:207Функции могут быть определены на нескольких уровнях: для всех пользователей, для каждого проекта, через плагины или через управляемые политики. Ты также можешь вложить файлы CLAUDE.md в подкаталоги или разместить skills в определённых пакетах монорепо. Когда одна и та же функция существует на нескольких уровнях, вот как они слоятся:

189 208 

190* **Файлы CLAUDE.md** являются аддитивными: все уровни одновременно вносят контент в контекст Claude. Файлы из вашего рабочего каталога и выше загружаются при запуске; подкаталоги загружаются по мере работы в них. Когда инструкции конфликтуют, Claude использует суждение для их согласования, при этом более специфичные инструкции обычно имеют приоритет. Подробнее см. в разделе [как загружаются файлы CLAUDE.md](/docs/ru/memory#how-claude-md-files-load).209* **Файлы CLAUDE.md** являются аддитивными: все уровни вносят контент в контекст Claude одновременно. Файлы из твоего рабочего каталога и выше загружаются при запуске; подкаталоги загружаются по мере того, как ты работаешь в них. Когда инструкции конфликтуют, Claude использует суждение, чтобы их согласовать. Подробнее см. в [как загружаются файлы CLAUDE.md](/docs/ru/memory#how-claude-md-files-load).

191* **Skills и subagents** переопределяют по имени: когда одно и то же имя существует на нескольких уровнях, одно определение побеждает на основе приоритета (управляемый > пользователь > проект для skills; управляемый > флаг CLI > проект > пользователь > plugin для subagents). Plugin skills имеют [пространство имён](/docs/ru/plugins#add-skills-to-your-plugin) для избежания конфликтов. Подробнее см. в разделах [обнаружение skills](/docs/ru/skills#resolve-skills-that-share-a-name) и [область subagent](/docs/ru/sub-agents#choose-the-subagent-scope).210* **Skills и subagent'ы** переопределяют по имени: когда одно и то же имя существует на нескольких уровнях, одно определение побеждает на основе приоритета (managed > user > project для skills; managed > CLI flag > project > user > plugin для subagent'ов). Skills плагина [имеют пространство имён](/docs/ru/plugins#add-skills-to-your-plugin), чтобы избежать конфликтов. Подробнее см. в [обнаружение skills](/docs/ru/skills#resolve-skills-that-share-a-name) и [область subagent'а](/docs/ru/sub-agents#choose-the-subagent-scope).

192* **MCP servers** переопределяют по имени: локальный > проект > пользователь. Подробнее см. в разделе [область MCP](/docs/ru/mcp#scope-hierarchy-and-precedence).211* **MCP-серверы** переопределяют по имени: local > project > user. Подробнее см. в [область MCP](/docs/ru/mcp#scope-hierarchy-and-precedence).

193* **Hooks** объединяются: все зарегистрированные hooks срабатывают для своих соответствующих событий независимо от источника. Подробнее см. в разделе [Hooks](/docs/ru/hooks).212* **Hooks** объединяются: все зарегистрированные hooks срабатывают для своих совпадающих событий независимо от источника. Подробнее см. в [hooks](/docs/ru/hooks).

194 213 

195<h3 id="combine-features">214<h3 id="combine-features">

196 Объедините функции215 Объедини функции

197</h3>216</h3>

198 217 

199Каждое расширение решает разную проблему: CLAUDE.md обрабатывает всегда включённый контекст, skills обрабатывают знания и рабочие процессы по требованию, MCP обрабатывает внешние подключения, subagents обрабатывают изоляцию, а hooks обрабатывают автоматизацию. Реальные настройки объединяют их на основе вашего рабочего процесса.218Каждое расширение решает разную проблему: CLAUDE.md обрабатывает всегда включённый контекст, skills обрабатывают знания и рабочие процессы по требованию, MCP обрабатывает внешние подключения, subagent'ы обрабатывают изоляцию, и hooks обрабатывают автоматизацию. Реальные настройки объединяют их на основе твоего рабочего процесса.

200 219 

201Например, вы можете использовать CLAUDE.md для соглашений проекта, skill для вашего рабочего процесса развёртывания, MCP для подключения к вашей базе данных и hook для запуска линтинга после каждого редактирования. Каждая функция обрабатывает то, в чём она лучше всего.220Например, ты можешь использовать CLAUDE.md для соглашений проекта, skill для твоего рабочего процесса развёртывания, MCP для подключения к твоей базе данных и hook для запуска линтинга после каждого редактирования. Каждая функция обрабатывает то, в чём она лучше всего.

202 221 

203| Паттерн | Как это работает | Пример |222| Паттерн | Как это работает | Пример |

204| ---------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |223| ---------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |

205| **Skill + MCP** | MCP обеспечивает подключение; skill учит Claude, как его хорошо использовать | MCP подключается к вашей базе данных, skill документирует вашу схему и шаблоны запросов |224| **Skill + MCP** | MCP предоставляет подключение; skill учит Claude, как его хорошо использовать | MCP подключается к твоей базе данных, skill документирует твою схему и шаблоны запросов |

206| **Skill + Subagent** | Skill запускает subagents для параллельной работы | Skill `/audit` запускает subagents безопасности, производительности и стиля, которые работают в изолированном контексте |225| **Skill + Subagent** | Skill запускает subagent'ов для параллельной работы | Skill `/audit` запускает subagent'ов безопасности, производительности и стиля, которые работают в изолированном контексте |

207| **CLAUDE.md + Skills** | CLAUDE.md содержит всегда включённые правила; skills содержат справочный материал, загружаемый по требованию | CLAUDE.md говорит "следуйте нашим соглашениям API", skill содержит полное руководство по стилю API |226| **CLAUDE.md + Skills** | CLAUDE.md содержит всегда включённые правила; skills содержат справочный материал, загружаемый по требованию | CLAUDE.md говорит «следуй нашим соглашениям API», skill содержит полный справочник стиля API |

208| **Hook + MCP** | Hook запускает внешние действия через MCP | Hook после редактирования отправляет уведомление Slack, когда Claude изменяет критические файлы |227| **Hook + MCP** | Hook запускает внешние действия через MCP | Hook после редактирования отправляет уведомление Slack, когда Claude изменяет критические файлы |

209 228 

210<h2 id="understand-context-costs">229<h2 id="understand-context-costs">

220Каждая функция имеет разную стратегию загрузки и стоимость контекста:239Каждая функция имеет разную стратегию загрузки и стоимость контекста:

221 240 

222| Функция | Когда загружается | Что загружается | Стоимость контекста |241| Функция | Когда загружается | Что загружается | Стоимость контекста |

223| --------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |242| --------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |

224| **CLAUDE.md** | Начало сессии | Полный контент | Каждый запрос |243| **CLAUDE.md** | Начало сессии | Полный контент | Каждый запрос |

244| **Output styles** | Начало сессии и снова при переключении стилей | Полные инструкции активного стиля; ничего для стиля Default | Каждый запрос |

225| **Skills** | Начало сессии + при использовании | Описания в начале, полный контент при использовании | Низкая (описания каждый запрос)\* |245| **Skills** | Начало сессии + при использовании | Описания в начале, полный контент при использовании | Низкая (описания каждый запрос)\* |

226| **MCP servers** | Начало сессии | Имена инструментов; полные схемы по требованию | Низкая до использования инструмента |246| **MCP servers** | Начало сессии | Имена инструментов; полные схемы по требованию | Низкая до использования инструмента |

227| **Code intelligence** | После редактирования файлов и по требованию | Диагностика после редактирования; расположение символов при поиске | Низкая; снижает чтение файлов в других местах |247| **Code intelligence** | После редактирования файлов и по требованию | Диагностика после редактирования; расположение символов при поиске | Низкая; снижает чтение файлов в других местах |

fullscreen.md +2 −2

Details

234 234 

235Выполните `/clear` для начала новой беседы.235Выполните `/clear` для начала новой беседы.

236 236 

237Чтобы очистить экран и сохранить беседу, нажмите `Ctrl+L`. Предыдущие сообщения прокручиваются вверх из поля зрения, и вы можете прокрутить назад с помощью `PgUp` или колеса мыши, чтобы прочитать их снова. До версии 2.1.260 `Ctrl+L` перерисовывал экран без его очистки. До версии 2.1.238 двойное нажатие в течение двух секунд выполняло `/clear`.237Если экран выглядит искажённым или частично пустым, нажмите `Ctrl+L` для перерисовки экрана. Перерисовка сохраняет беседу и ваш ввод на месте.

238 238 

239`Cmd+K` делает то же самое, что `Ctrl+L`, когда ваш терминал передает его в Claude Code. iTerm2 и Terminal.app обрабатывают `Cmd+K` самостоятельно, и Claude Code перерисовывает беседу вместо её очистки, поэтому нажимайте `Ctrl+L` на этих терминалах.239`Cmd+K` делает то же самое, что `Ctrl+L`, когда ваш терминал передает его в Claude Code. iTerm2 и Terminal.app обрабатывают `Cmd+K` самостоятельно и очищают свой собственный экран, а Claude Code обнаруживает очищенный экран и перерисовывает беседу. До версии 2.1.280, начиная с версии 2.1.260, нажатие `Ctrl+L` или `Cmd+K`, где оно достигает Claude Code, очищало экран при полноэкранной визуализации. До версии 2.1.238 двойное нажатие `Ctrl+L` в течение двух секунд выполняло `/clear`.

240 240 

241<h2 id="use-with-tmux">241<h2 id="use-with-tmux">

242 Использование с tmux242 Использование с tmux

Details

300 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}300 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

301 prompt: "Generate a summary of yesterday's commits and open issues"301 prompt: "Generate a summary of yesterday's commits and open issues"

302 claude_args: |302 claude_args: |

303 --model claude-opus-4-8303 --model claude-opus-5-5

304 --allowedTools "mcp__github__list_commits,mcp__github__list_issues"304 --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

305```305```

306 306 

glossary.md +12 −0

Details

208 208 

209Подробнее: [Use extended thinking](/docs/ru/model-config#extended-thinking)209Подробнее: [Use extended thinking](/docs/ru/model-config#extended-thinking)

210 210 

211<h2 id="f">

212 F

213</h2>

214 

215<h3 id="frontmatter">

216 Frontmatter

217</h3>

218 

219Блок параметров YAML в самом начале файла Markdown, между открывающей строкой `---` и закрывающей строкой `---`. Skills, subagents, output styles и rules читают свою конфигурацию из frontmatter, например `description` skill или `tools` subagent, и рассматривают всё после закрывающей `---` как инструкции. Открывающая `---` должна быть первой строкой файла. Каждый тип файла принимает свой собственный набор полей.

220 

221Узнайте больше: [Skill frontmatter](/docs/ru/skills#frontmatter-reference), [Subagent frontmatter](/docs/ru/sub-agents#supported-frontmatter-fields), [Output style frontmatter](/docs/ru/output-styles#frontmatter), [Rule frontmatter](/docs/ru/memory#rules-frontmatter-reference)

222 

211<h2 id="h">223<h2 id="h">

212 H224 H

213</h2>225</h2>

Details

238 238 

239Установите эти переменные окружения на конкретные ID моделей Google Cloud's Agent Platform.239Установите эти переменные окружения на конкретные ID моделей Google Cloud's Agent Platform.

240 240 

241Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Google Cloud's Agent Platform разрешается в Opus 5, а без `ANTHROPIC_DEFAULT_SONNET_MODEL` псевдоним `sonnet` разрешается в Sonnet 4.5. Этот пример закрепляет каждый псевдоним на конкретную версию:241Без `ANTHROPIC_DEFAULT_OPUS_MODEL` псевдоним `opus` на Google Cloud's Agent Platform разрешается в Opus 5.5, а без `ANTHROPIC_DEFAULT_SONNET_MODEL` псевдоним `sonnet` разрешается в Sonnet 4.5. Этот пример закрепляет каждый псевдоним на конкретную версию:

242 242 

243```bash theme={null}243```bash theme={null}

244export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'244export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'

252 252 

253| Тип модели | Значение по умолчанию |253| Тип модели | Значение по умолчанию |

254| :------------------- | :--------------------------- |254| :------------------- | :--------------------------- |

255| Основная модель | `claude-opus-5` |255| Основная модель | `claude-opus-5-5` |

256| Малая/быстрая модель | `claude-sonnet-4-5@20250929` |256| Малая/быстрая модель | `claude-sonnet-4-5@20250929` |

257 257 

258Фоновые задачи, такие как генерация названия сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Google Cloud's Agent Platform Claude Code использует модель Sonnet по умолчанию для фоновых задач, потому что Haiku может быть не включен в каждом проекте или регионе. Два выбора изменяют, какая модель их выполняет:258Фоновые задачи, такие как генерация названия сеанса, используют малую/быструю модель, обычно модель класса Haiku. На Google Cloud's Agent Platform Claude Code использует модель Sonnet по умолчанию для фоновых задач, потому что Haiku может быть не включен в каждом проекте или регионе. Два выбора изменяют, какая модель их выполняет:

264 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развертывание, которое не закрепляет основную модель, будет тарифицироваться по тарифу Opus после обновления до версии 2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развертывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.264 Модели Opus имеют более высокую цену за токен, чем модели Sonnet, поэтому развертывание, которое не закрепляет основную модель, будет тарифицироваться по тарифу Opus после обновления до версии 2.1.207 или позже. Чтобы сохранить Sonnet 4.5 в качестве основной модели, установите `ANTHROPIC_MODEL` на его полный ID модели. Развертывание, которое управляет значением по умолчанию с помощью `ANTHROPIC_DEFAULT_SONNET_MODEL` и не устанавливает `ANTHROPIC_DEFAULT_OPUS_MODEL`, сохраняет свою управляемую модель Sonnet в качестве значения по умолчанию.

265</Warning>265</Warning>

266 266 

267На версиях 2.1.207 по 2.1.218 основная модель на Google Cloud's Agent Platform по умолчанию была Opus 4.8, и псевдоним `opus` разрешался в Opus 4.8. До версии 2.1.207 основная модель по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался в Opus 4.6, и фоновые задачи всегда использовали основную модель.267До версии 2.1.280 основная модель на Google Cloud's Agent Platform по умолчанию была Opus 5, и псевдоним `opus` разрешался в Opus 5 с версии 2.1.219. На версиях 2.1.207 по 2.1.218 основная модель на Google Cloud's Agent Platform по умолчанию была Opus 4.8, и псевдоним `opus` разрешался в Opus 4.8. До версии 2.1.207 основная модель по умолчанию была Sonnet 4.5, псевдоним `opus` разрешался в Opus 4.6, и фоновые задачи всегда использовали основную модель.

268 268 

269Для дальнейшей настройки моделей:269Для дальнейшей настройки моделей:

270 270 

headless.md +2 −2

Details

109cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt109cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

110```110```

111 111 

112С `--output-format json` полезная нагрузка ответа включает `total_cost_usd` и разбивку затрат по моделям, поэтому скриптовые вызывающие стороны могут отслеживать расходы на вызов без обращения к [панели использования](/docs/ru/costs). Обе цифры являются [оценками на стороне клиента](/docs/ru/agent-sdk/cost-tracking) и могут отличаться от вашего фактического счёта.112С `--output-format json` полезная нагрузка ответа включает `total_cost_usd` и разбивку затрат по моделям, поэтому скриптовые вызывающие стороны могут отслеживать расходы без обращения к [панели использования](/docs/ru/costs). Когда вы продолжаете более ранний разговор с `--continue` или `--resume`, запуск сообщает общую сумму разговора, [включая расходы более ранних запусков](/docs/ru/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Обе цифры являются [оценками на стороне клиента](/docs/ru/agent-sdk/cost-tracking) и могут отличаться от вашего фактического счёта.

113 113 

114<Note>114<Note>

115 Передача данных через stdin ограничена 10 МБ. Если вы превысите лимит, Claude Code выйдет с понятной ошибкой и ненулевым статусом. Для работы с большими входными данными запишите содержимое в файл и ссылайтесь на путь файла в вашем приглашении вместо передачи данных через pipe.115 Передача данных через stdin ограничена 10 МБ. Если вы превысите лимит, Claude Code выйдет с понятной ошибкой и ненулевым статусом. Для работы с большими входными данными запишите содержимое в файл и ссылайтесь на путь файла в вашем приглашении вместо передачи данных через pipe.

212* **По умолчанию**: блоки `tool_use` и `tool_result` подагента.212* **По умолчанию**: блоки `tool_use` и `tool_result` подагента.

213* **С [`--forward-subagent-text`](/docs/ru/cli-reference#cli-flags) или [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ru/env-vars)**: также текстовые и thinking блоки подагента, чтобы вы могли восстановить транскрипт каждого подагента. Это требует Claude Code версии 2.1.211 или позже.213* **С [`--forward-subagent-text`](/docs/ru/cli-reference#cli-flags) или [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ru/env-vars)**: также текстовые и thinking блоки подагента, чтобы вы могли восстановить транскрипт каждого подагента. Это требует Claude Code версии 2.1.211 или позже.

214 214 

215Когда вы включаете любой из этих параметров, Claude Code пересылает сообщения от [подагентов на каждом уровне вложенности](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents): когда подагент порождает собственного подагента, сообщения вложенного подагента содержат ID вызова Agent инструмента, который его породил, в `parent_tool_use_id`, поэтому вы можете перестроить полное дерево вложенности, следуя этим ID. До версии 2.1.219 сообщения от вложенных подагентов не появлялись в потоке.215Когда вы включаете любой из этих параметров, Claude Code пересылает сообщения от [подагентов на каждом уровне вложенности](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents), независимо от того, был ли каждый порождён инструментом Agent или запущен как [разветвлённый skill](/docs/ru/skills#run-skills-in-a-subagent). Сообщения подагентов, которых разветвлённый skill порождает, и разветвлённых skills, запущенных внутри подагента или другого разветвлённого skill, требуют Claude Code версии 2.1.275 или позже. В `parent_tool_use_id` сообщения вложенного подагента содержат ID вызова инструмента Agent или Skill, который его запустил, поэтому вы можете перестроить полное дерево вложенности, следуя этим ID. До версии 2.1.219 сообщения от вложенных подагентов не появлялись в потоке.

216 216 

217Skills, которые [работают в подагенте](/docs/ru/skills#run-skills-in-a-subagent), появляются в потоке так же: первое сообщение разветвлённого skill — это сообщение `user`, содержащее содержимое skill, которое управляет запуском. Если вы включаете любой из этих параметров, поток также содержит текстовые и thinking блоки разветвлённого skill. До версии 2.1.265 в потоке появлялись только блоки `tool_use` и `tool_result` разветвлённого skill.217Skills, которые [работают в подагенте](/docs/ru/skills#run-skills-in-a-subagent), появляются в потоке так же: первое сообщение разветвлённого skill — это сообщение `user`, содержащее содержимое skill, которое управляет запуском. Если вы включаете любой из этих параметров, поток также содержит текстовые и thinking блоки разветвлённого skill. До версии 2.1.265 в потоке появлялись только блоки `tool_use` и `tool_result` разветвлённого skill.

218 218 

hooks.md +449 −444

Details

268| [Skill](/docs/ru/skills) frontmatter | Остаток сеанса после вызова skill. См. [Hooks in skills and agents](#hooks-in-skills-and-agents) | Да, определено в файле skill |268| [Skill](/docs/ru/skills) frontmatter | Остаток сеанса после вызова skill. См. [Hooks in skills and agents](#hooks-in-skills-and-agents) | Да, определено в файле skill |

269| [Subagent](/docs/ru/sub-agents) frontmatter | Пока этот subagent работает | Да, определено в файле subagent |269| [Subagent](/docs/ru/sub-agents) frontmatter | Пока этот subagent работает | Да, определено в файле subagent |

270 270 

271Облачные сеансы на [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) не читают ваш локальный `~/.claude/settings.json`; hooks там поступают из репозитория, что означает его `.claude/settings.json` в сеансе с одним репозиторием и плагины, которые он объявляет в любом сеансе, и из управляемых на сервере параметров вашей организации. В [самостоятельно размещённой среде](/docs/ru/self-hosted-environments-configuration#permissions-and-tool-approval), Claude Code также запускает hooks, которые оператор инициализировал из `~/.claude/` хоста runner, и запускает hooks в файле управляемых параметров образа runner, когда этот файл находится среди [управляемых источников, которые применяет Claude Code](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), что по умолчанию означает только когда ни управляемые на сервере параметры, ни доставленная MDM политика Claude Code не предоставляют управляемый уровень. См. [что переносится из вашей установки](/docs/ru/cloud-environments#what-carries-over-from-your-setup) для того, какие файлы достигают облачного сеанса.271Облачные сеансы на [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web) не читают ваш локальный `~/.claude/settings.json`; hooks там поступают из репозитория `.claude/settings.json` в сеансе с одним репозиторием, из плагинов [синхронизированных с вашего аккаунта claude.ai](/docs/ru/plugins-reference#synced-plugins) и из управляемых на сервере параметров вашей организации. В [самостоятельно размещённой среде](/docs/ru/self-hosted-environments-configuration#permissions-and-tool-approval), Claude Code также запускает hooks, которые оператор инициализировал из `~/.claude/` хоста runner, и запускает hooks в файле управляемых параметров образа runner, когда этот файл находится среди [управляемых источников, которые применяет Claude Code](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), что по умолчанию означает только когда ни управляемые на сервере параметры, ни доставленная MDM политика Claude Code не предоставляют управляемый уровень. См. [что переносится из вашей установки](/docs/ru/cloud-environments#what-carries-over-from-your-setup) для того, какие файлы достигают облачного сеанса.

272 272 

273Для получения подробной информации о разрешении файлов настроек см. [settings](/docs/ru/settings).273Для получения подробной информации о разрешении файлов настроек см. [settings](/docs/ru/settings).

274 274 

1181 События hooks1181 События hooks

1182</h2>1182</h2>

1183 1183 

1184Каждое событие соответствует точке в жизненном цикле Claude Code, где могут выполняться hooks. Разделы ниже упорядочены в соответствии с жизненным циклом: от настройки сеанса через агентский цикл до завершения сеанса. Каждый раздел описывает, когда срабатывает событие, какие matchers оно поддерживает, какой JSON-ввод оно получает и как управлять поведением через вывод.1184Каждое событие соответствует точке в жизненном цикле Claude Code, где могут выполняться hooks. Разделы ниже упорядочены в соответствии с жизненным циклом: от настройки сеанса через агентский цикл к завершению сеанса. Каждый раздел описывает, когда срабатывает событие, какие matchers оно поддерживает, какой JSON-ввод оно получает и как управлять поведением через вывод.

1185 1185 

1186<h3 id="sessionstart">1186<h3 id="sessionstart">

1187 SessionStart1187 SessionStart

1188</h3>1188</h3>

1189 1189 

1190Запускается, когда Claude Code начинает новый сеанс или возобновляет существующий сеанс. Полезно для загрузки контекста разработки, такого как существующие проблемы или недавние изменения в вашей кодовой базе, или для установки переменных окружения. Для статического контекста, который не требует скрипта, используйте [CLAUDE.md](/docs/ru/memory) вместо этого.1190Запускается, когда Claude Code начинает новый сеанс или возобновляет существующий сеанс. Полезно для загрузки контекста разработки, такого как существующие проблемы или недавние изменения в вашей кодовой базе, или для установки переменных окружения. Для статического контекста, который не требует скрипта, используйте вместо этого [CLAUDE.md](/docs/ru/memory).

1191 1191 

1192SessionStart запускается в каждом сеансе, поэтому держите эти hooks быстрыми. Поддерживаются только hooks `type: "command"` и `type: "mcp_tool"`. См. [MCP tool hook fields](#mcp-tool-hook-fields) для информации о том, когда выполняются hooks `mcp_tool`.1192SessionStart запускается в каждом сеансе, поэтому держите эти hooks быстрыми. Поддерживаются только hooks `type: "command"` и `type: "mcp_tool"`. См. [MCP tool hook fields](#mcp-tool-hook-fields) для информации о том, когда выполняются hooks `mcp_tool`.

1193 1193 

1203 1203 

1204До версии 2.1.214 разветвленные сеансы сообщали источник `"resume"`.1204До версии 2.1.214 разветвленные сеансы сообщали источник `"resume"`.

1205 1205 

1206Когда вы запускаете интерактивный сеанс, возобновляете разговор при запуске с `--continue` или `--resume` или запускаете `/clear`, hooks SessionStart выполняются в фоне. Вы можете сразу же печатать, и возобновленный разговор появляется без ожидания завершения hooks. Первый ответ Claude все еще ждет завершения hooks, поэтому их контекст достигает Claude.1206Когда вы запускаете интерактивный сеанс, возобновляете разговор при запуске с `--continue` или `--resume` или запускаете `/clear`, hooks SessionStart выполняются в фоновом режиме. Вы можете сразу же печатать, и возобновленный разговор появляется без ожидания hooks. Первый ответ Claude все еще ждет завершения hooks, поэтому их контекст достигает Claude.

1207 1207 

1208Когда вы переключаете разговоры с `/resume` внутри сеанса, переключение ждет завершения hooks. Если вы запустите `/clear` или переключитесь на другой разговор, пока фоновые hooks все еще выполняются, ничего из того, что они возвращают, не применяется к сеансу.1208Когда вы переключаете разговоры с `/resume` внутри сеанса, переключение ждет завершения hooks. Если вы запустите `/clear` или переключитесь на другой разговор, пока фоновые hooks все еще выполняются, ничего из того, что они возвращают, не применяется к сеансу.

1209 1209 

1210То же самое ожидание применяется при запуске, включая возобновленный сеанс: подсказка, которую вы отправляете, пока SessionStart hooks все еще выполняются, не достигает Claude до их завершения.1210То же самое ожидание применяется при запуске, включая возобновленный сеанс: подсказка, которую вы отправляете, пока hooks SessionStart все еще выполняются, не достигает Claude до их завершения.

1211 1211 

1212Во время ожидания нажмите `Esc`, чтобы вернуть подсказку в ввод без отправки. Hooks продолжают выполняться.1212Во время любого ожидания нажмите `Esc`, чтобы вернуть подсказку в ввод без отправки. Hooks продолжают выполняться.

1213 1213 

1214<h4 id="sessionstart-input">1214<h4 id="sessionstart-input">

1215 SessionStart input1215 Ввод SessionStart

1216</h4>1216</h4>

1217 1217 

1218Помимо [common input fields](#common-input-fields), hooks SessionStart получают `source` и опционально `model`, `agent_type` и `session_title`:1218Помимо [общих полей ввода](#common-input-fields), hooks SessionStart получают `source` и опционально `model`, `agent_type` и `session_title`:

1219 1219 

1220| Field | Description |1220| Поле | Описание |

1221| :-------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1221| :-------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1222| `source` | Как был запущен сеанс: `"startup"` для новых сеансов, `"resume"` для возобновленных сеансов, `"clear"` после `/clear`, `"compact"` после сжатия или `"fork"` для нового сеанса, разветвленного из существующего |1222| `source` | Как был запущен сеанс: `"startup"` для новых сеансов, `"resume"` для возобновленных сеансов, `"clear"` после `/clear`, `"compact"` после сжатия или `"fork"` для нового сеанса, разветвленного из существующего |

1223| `model` | Идентификатор активной модели. Может быть опущен, например после `/clear` или когда сеанс восстанавливается через восстановление разговора, поэтому проверьте наличие поля перед его чтением |1223| `model` | Идентификатор активной модели. Может быть опущен, например после `/clear` или когда сеанс восстанавливается через восстановление разговора, поэтому проверьте наличие поля перед его чтением |

1224| `agent_type` | Имя агента, присутствует при запуске Claude Code с `claude --agent <name>` |1224| `agent_type` | Имя агента, присутствует при запуске Claude Code с `claude --agent <name>` |

1225| `session_title` | Текущее название сеанса, если оно уже установлено, например через `--name` или `/rename`. Hook, который выдает `sessionTitle`, может сначала проверить `session_title`, чтобы избежать перезаписи названия, которое пользователь установил явно |1225| `session_title` | Текущее название сеанса, если оно уже установлено, например через `--name` или `/rename`. Hook, который выдает `sessionTitle`, может сначала проверить `session_title`, чтобы избежать перезаписи названия, установленного пользователем явно |

1226 1226 

1227Когда `source` имеет значение `"resume"` или `"fork"` и транскрипт содержит по крайней мере один ответ от Claude, hooks SessionStart также получают четыре поля ниже. Ваш hook может использовать их для сообщения о стоимости возобновления устаревшего разговора перед первым запросом, например в [`systemMessage`](#json-output). Эти поля требуют Claude Code v2.1.251 или позже.1227Когда `source` имеет значение `"resume"` или `"fork"` и транскрипт содержит по крайней мере один ответ от Claude, hooks SessionStart также получают четыре поля ниже. Ваш hook может использовать их для сообщения о стоимости возобновления устаревшего разговора перед первым запросом, например в [`systemMessage`](#json-output). Эти поля требуют Claude Code v2.1.251 или позже.

1228 1228 

1229| Field | Description |1229| Поле | Описание |

1230| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |1230| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1231| `seconds_since_last_response` | Настоящее время в секундах с момента последнего ответа в возобновленном транскрипте |1231| `seconds_since_last_response` | Настоящее время в секундах с момента последнего ответа в возобновленном транскрипте |

1232| `context_tokens` | Токены, которые первый запрос возобновленного сеанса повторно отправляет как его подсказка |1232| `context_tokens` | Токены, которые первый запрос возобновленного сеанса повторно отправляет как его подсказка |

1233| `prompt_cache_likely_expired` | `true`, когда последний ответ старше [lifetime кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) сеанса или более позднее сжатие заменило кэшированный разговор |1233| `prompt_cache_likely_expired` | `true`, когда последний ответ старше [времени жизни кэша подсказок](/docs/ru/prompt-caching#cache-lifetime) сеанса или более позднее сжатие заменило кэшированный разговор |

1234| `estimated_cache_write_usd` | Предполагаемая стоимость в долларах США записи `context_tokens` в кэш подсказок на модели сеанса, исключая ответ |1234| `estimated_cache_write_usd` | Предполагаемая стоимость в долларах США записи `context_tokens` в кэш подсказок на модели сеанса, исключая ответ |

1235 1235 

1236Этот пример показывает ввод для сеанса, возобновленного через 90 минут после его последнего ответа:1236Этот пример показывает ввод для сеанса, возобновленного через 90 минут после его последнего ответа:

1251```1251```

1252 1252 

1253<h4 id="sessionstart-decision-control">1253<h4 id="sessionstart-decision-control">

1254 SessionStart decision control1254 Управление решением SessionStart

1255</h4>1255</h4>

1256 1256 

1257Claude Code добавляет stdout, который он [рассматривает как простой текст](#exit-code-0), в контекст Claude. Помимо [JSON output fields](#json-output), доступных всем hooks, вы можете вернуть эти поля, специфичные для события:1257Claude Code добавляет stdout, который он [рассматривает как простой текст](#exit-code-0), в контекст Claude. Помимо [полей JSON-вывода](#json-output), доступных всем hooks, вы можете вернуть эти поля, специфичные для события:

1258 1258 

1259| Field | Description |1259| Поле | Описание |

1260| :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1260| :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1261| `additionalContext` | Строка, добавленная в контекст Claude в начале разговора, перед первой подсказкой. См. [Add context for Claude](#add-context-for-claude) для информации о том, как доставляется текст и что в него поместить |1261| `additionalContext` | Строка, добавленная в контекст Claude в начале разговора, перед первой подсказкой. См. [Add context for Claude](#add-context-for-claude) для информации о том, как доставляется текст и что в него поместить |

1262| `initialUserMessage` | Строка, используемая как первое сообщение пользователя сеанса. Применяется в [non-interactive mode](/docs/ru/headless) с флагом `-p`, где она становится первым ходом, даже если подсказка не предоставлена. Если подсказка предоставлена, она следует как следующий ход. В отличие от `additionalContext`, который присоединяется к существующему ходу, это создает ход |1262| `initialUserMessage` | Строка, используемая как первое сообщение пользователя сеанса. Применяется в [неинтерактивном режиме](/docs/ru/headless) с флагом `-p`, где она становится первым ходом, даже если подсказка не предоставлена. Если подсказка предоставлена, она следует как следующий ход. В отличие от `additionalContext`, который присоединяется к существующему ходу, это создает ход |

1263| `sessionTitle` | Устанавливает название сеанса с тем же эффектом, что и `/rename`. Используйте для автоматического именования сеансов из папки запуска, ветки git или имени worktree. Применяется, когда `source` имеет значение `"startup"`, `"resume"` или `"fork"`; игнорируется на `"clear"` и `"compact"` |1263| `sessionTitle` | Устанавливает название сеанса с тем же эффектом, что и `/rename`. Используйте для автоматического именования сеансов из папки запуска, ветки git или имени worktree. Применяется, когда `source` имеет значение `"startup"`, `"resume"` или `"fork"`; игнорируется на `"clear"` и `"compact"` |

1264| `watchPaths` | Массив абсолютных путей для наблюдения за событиями [FileChanged](#filechanged) во время этого сеанса |1264| `watchPaths` | Массив абсолютных путей для отслеживания событий [FileChanged](#filechanged) во время этого сеанса |

1265| `reloadSkills` | Boolean. Когда `true`, Claude Code повторно сканирует [skill](/docs/ru/skills) и командные директории после завершения hooks SessionStart, поэтому skills, установленные hook, доступны в том же сеансе, начиная с первой подсказки |1265| `reloadSkills` | Логическое значение. Когда `true`, Claude Code повторно сканирует [skill](/docs/ru/skills) и директории команд после завершения hooks SessionStart, поэтому skills, установленные hook, доступны в том же сеансе, начиная с первой подсказки |

1266 1266 

1267```json theme={null}1267```json theme={null}

1268{1268{

1290URL репозитория является заполнителем; замените его на URL вашего репозитория skills. С заполнителем клонирование не удается и выводит сообщение `fatal:` в stderr. Stderr из hook SessionStart, который выходит с кодом 0, только информационный, поэтому запрос `reloadSkills` все еще применяется.1290URL репозитория является заполнителем; замените его на URL вашего репозитория skills. С заполнителем клонирование не удается и выводит сообщение `fatal:` в stderr. Stderr из hook SessionStart, который выходит с кодом 0, только информационный, поэтому запрос `reloadSkills` все еще применяется.

1291 1291 

1292<h4 id="persist-environment-variables">1292<h4 id="persist-environment-variables">

1293 Persist environment variables1293 Сохранение переменных окружения

1294</h4>1294</h4>

1295 1295 

1296Hooks SessionStart имеют доступ к переменной окружения `CLAUDE_ENV_FILE`, которая предоставляет путь к файлу, где вы можете сохранить переменные окружения для последующих команд Bash.1296Hooks SessionStart имеют доступ к переменной окружения `CLAUDE_ENV_FILE`, которая предоставляет путь к файлу, где вы можете сохранить переменные окружения для последующих команд Bash.

1336 Setup1336 Setup

1337</h3>1337</h3>

1338 1338 

1339Срабатывает только при запуске Claude Code с `--init-only` или с `--init` или `--maintenance` в [non-interactive mode](/docs/ru/headless) с флагом `-p`. Не срабатывает при нормальном запуске. Используйте для одноразовой установки зависимостей или запланированной очистки, которую вы явно запускаете из CI или скриптов, отдельно от нормального запуска сеанса. Для инициализации для каждого сеанса используйте [SessionStart](#sessionstart) вместо этого.1339Срабатывает только при запуске Claude Code с `--init-only` или с `--init` или `--maintenance` в [неинтерактивном режиме](/docs/ru/headless) с флагом `-p`. Не срабатывает при нормальном запуске. Используйте для одноразовой установки зависимостей или запланированной очистки, которую вы явно запускаете из CI или скриптов, отдельно от нормального запуска сеанса. Для инициализации для каждого сеанса используйте вместо этого [SessionStart](#sessionstart).

1340 1340 

1341Значение matcher соответствует флагу CLI, который запустил hook:1341Значение matcher соответствует флагу CLI, который запустил hook:

1342 1342 

1347 1347 

1348Когда вы запускаете `claude --init-only`, Claude Code запускает hooks Setup и hooks `SessionStart` с matcher `startup`, затем выходит без запуска разговора.1348Когда вы запускаете `claude --init-only`, Claude Code запускает hooks Setup и hooks `SessionStart` с matcher `startup`, затем выходит без запуска разговора.

1349 1349 

1350Когда вы запускаете или продолжаете разговор с `-p`, вам также нужно предоставить подсказку как аргумент или через stdin. Вы можете пропустить подсказку, когда hook `SessionStart` предоставляет [`initialUserMessage`](#sessionstart-decision-control) или когда вы возобновляете сеанс с [deferred tool call](#defer-a-tool-call-for-later).1350Когда вы запускаете или продолжаете разговор с `-p`, вам также нужно предоставить подсказку как аргумент или через stdin. Вы можете пропустить подсказку, когда hook `SessionStart` предоставляет [`initialUserMessage`](#sessionstart-decision-control) или когда вы возобновляете сеанс с [отложенным вызовом инструмента](#defer-a-tool-call-for-later).

1351 1351 

1352При успехе `--init-only` ничего не выводит на терминал. Чтобы подтвердить, что hooks выполнились, запустите с `claude --debug-file <path> --init-only`, заменив `<path>` на местоположение файла журнала, и проверьте журнал на наличие записей hooks Setup и SessionStart.1352При успехе `--init-only` ничего не выводит на терминал. Чтобы подтвердить, что hooks выполнились, начните с `claude --debug-file <path> --init-only`, заменив `<path>` на местоположение файла журнала, и проверьте журнал на наличие записей hooks Setup и SessionStart.

1353 1353 

1354Поскольку Setup не срабатывает при каждом запуске, plugin, которому нужна установленная зависимость, не может полагаться только на Setup. Практический паттерн — проверить зависимость при первом использовании и установить при отсутствии, например hook или skill, который тестирует `${CLAUDE_PLUGIN_DATA}/node_modules` и запускает `npm install`, если отсутствует. См. [persistent data directory](/docs/ru/plugins-reference#persistent-data-directory) для информации о том, где хранить установленные зависимости. Если вы распространяете свой plugin через marketplace, вам может не понадобиться этот паттерн: Claude Code [автоматически устанавливает подходящие зависимости пакетов Node.js](/docs/ru/plugins-reference#node-js-package-dependencies) при кэшировании plugin.1354Поскольку Setup не срабатывает при каждом запуске, плагин, которому нужна установленная зависимость, не может полагаться только на Setup. Практический паттерн — проверить зависимость при первом использовании и установить при отсутствии, например hook или skill, который тестирует `${CLAUDE_PLUGIN_DATA}/node_modules` и запускает `npm install`, если отсутствует. См. [persistent data directory](/docs/ru/plugins-reference#persistent-data-directory) для информации о том, где хранить установленные зависимости. Если вы распространяете свой плагин через marketplace, вам может не понадобиться этот паттерн: Claude Code [автоматически устанавливает подходящие зависимости пакетов Node.js](/docs/ru/plugins-reference#node-js-package-dependencies) при кэшировании плагина.

1355 1355 

1356<h4 id="setup-input">1356<h4 id="setup-input">

1357 Setup input1357 Ввод Setup

1358</h4>1358</h4>

1359 1359 

1360Помимо [common input fields](#common-input-fields), hooks Setup получают поле `trigger`, установленное либо на `"init"`, либо на `"maintenance"`:1360Помимо [общих полей ввода](#common-input-fields), hooks Setup получают поле `trigger`, установленное либо на `"init"`, либо на `"maintenance"`:

1361 1361 

1362```json theme={null}1362```json theme={null}

1363{1363{

1370```1370```

1371 1371 

1372<h4 id="setup-decision-control">1372<h4 id="setup-decision-control">

1373 Setup decision control1373 Управление решением Setup

1374</h4>1374</h4>

1375 1375 

1376Hooks Setup не могут блокировать; выполнение продолжается при любом коде выхода. При каждом коде выхода Claude Code отбрасывает [JSON output fields](#json-output) hook Setup, такие как `systemMessage`, `continue` и `hookSpecificOutput.additionalContext`. С `-p` stdout, stderr и код выхода hook Setup появляются в выводе запуска только как [`hook_response` events](/docs/ru/headless#read-session-metadata) при запуске с `--output-format stream-json --verbose`.1376Hooks Setup не могут блокировать; выполнение продолжается при любом коде выхода. При каждом коде выхода Claude Code отбрасывает [поля JSON-вывода](#json-output) hook Setup, такие как `systemMessage`, `continue` и `hookSpecificOutput.additionalContext`. С `-p` stdout, stderr и код выхода hook Setup появляются в выводе запуска только как [`hook_response` события](/docs/ru/headless#read-session-metadata) при запуске с `--output-format stream-json --verbose`.

1377 1377 

1378Hooks Setup имеют доступ к `CLAUDE_ENV_FILE`. Переменные, записанные в этот файл, сохраняются в последующих командах Bash для сеанса, как в [SessionStart hooks](#persist-environment-variables). Только hooks `type: "command"` выполняются на `Setup`. Hook `type: "mcp_tool"` на `Setup` всегда пропускается, как описано в [MCP tool hook fields](#mcp-tool-hook-fields).1378Hooks Setup имеют доступ к `CLAUDE_ENV_FILE`. Переменные, записанные в этот файл, сохраняются в последующих командах Bash для сеанса, как и в [hooks SessionStart](#persist-environment-variables). На `Setup` выполняются только hooks `type: "command"`. Hook `type: "mcp_tool"` на `Setup` всегда пропускается, как описано в [MCP tool hook fields](#mcp-tool-hook-fields).

1379 1379 

1380<h3 id="instructionsloaded">1380<h3 id="instructionsloaded">

1381 InstructionsLoaded1381 InstructionsLoaded

1382</h3>1382</h3>

1383 1383 

1384Срабатывает, когда файл `CLAUDE.md` или `.claude/rules/*.md` загружается в контекст. Это событие срабатывает при запуске сеанса для нетерпеливо загруженных файлов и снова позже, когда файлы загружаются лениво, например когда Claude получает доступ к подпапке, которая содержит вложенный `CLAUDE.md`, или когда условные правила с frontmatter `paths:` совпадают. Hook не поддерживает блокирование или управление решением. Он выполняется асинхронно в целях наблюдаемости.1384Срабатывает, когда файл `CLAUDE.md` или `.claude/rules/*.md` загружается в контекст. Это событие срабатывает при запуске сеанса для файлов, загружаемых с нетерпением, и снова позже, когда файлы загружаются с нетерпением, например когда Claude получает доступ к подпапке, содержащей вложенный `CLAUDE.md`, или когда условные правила с frontmatter `paths:` совпадают. Hook не поддерживает блокировку или управление решением. Он выполняется асинхронно в целях наблюдаемости.

1385 1385 

1386Это событие не срабатывает, когда Claude [читает `AGENTS.md` напрямую](/docs/ru/memory#agents-md) через параметр **Project instructions**. Оно срабатывает, когда `CLAUDE.md` импортирует ваш `AGENTS.md`, с `load_reason`, установленным на `include`, как для любого другого импортированного файла, и когда `CLAUDE.md` является symlink на него, как обычная загрузка `CLAUDE.md`.1386Это событие не срабатывает, когда Claude [читает `AGENTS.md` напрямую](/docs/ru/memory#agents-md) через параметр **Project instructions**. Оно срабатывает, когда `CLAUDE.md` импортирует ваш `AGENTS.md` с `load_reason`, установленным на `include`, как для любого другого импортированного файла, и когда `CLAUDE.md` является символической ссылкой на него, как нормальная загрузка `CLAUDE.md`.

1387 1387 

1388Matcher выполняется против `load_reason`. Например, используйте `"matcher": "session_start"` для срабатывания только для файлов, загруженных при запуске сеанса, или `"matcher": "path_glob_match|nested_traversal"` для срабатывания только для ленивых загрузок.1388Matcher выполняется против `load_reason`. Например, используйте `"matcher": "session_start"` для срабатывания только для файлов, загруженных при запуске сеанса, или `"matcher": "path_glob_match|nested_traversal"` для срабатывания только для ленивых загрузок.

1389 1389 

1390<h4 id="instructionsloaded-input">1390<h4 id="instructionsloaded-input">

1391 InstructionsLoaded input1391 Ввод InstructionsLoaded

1392</h4>1392</h4>

1393 1393 

1394Помимо [common input fields](#common-input-fields), hooks InstructionsLoaded получают эти поля:1394Помимо [общих полей ввода](#common-input-fields), hooks InstructionsLoaded получают эти поля:

1395 1395 

1396| Field | Description |1396| Поле | Описание |

1397| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1397| :------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1398| `file_path` | Абсолютный путь к файлу инструкций, который был загружен |1398| `file_path` | Абсолютный путь к файлу инструкций, который был загружен |

1399| `memory_type` | Область действия файла: `"User"`, `"Project"`, `"Local"` или `"Managed"` |1399| `memory_type` | Область действия файла: `"User"`, `"Project"`, `"Local"` или `"Managed"` |

1400| `load_reason` | Почему файл был загружен: `"session_start"`, `"nested_traversal"`, `"path_glob_match"`, `"include"` или `"compact"`. Значение `"compact"` срабатывает, когда файлы инструкций перезагружаются после события сжатия |1400| `load_reason` | Почему файл был загружен: `"session_start"`, `"nested_traversal"`, `"path_glob_match"`, `"include"` или `"compact"`. Значение `"compact"` срабатывает, когда файлы инструкций перезагружаются после события сжатия |

1401| `globs` | Шаблоны glob пути из frontmatter `paths:` файла, если есть. Присутствует только для загрузок `path_glob_match` |1401| `globs` | Шаблоны глобов путей из frontmatter `paths:` файла, если они есть. Присутствует только для загрузок `path_glob_match` |

1402| `trigger_file_path` | Путь к файлу, доступ к которому запустил эту загрузку, для ленивых загрузок |1402| `trigger_file_path` | Путь к файлу, доступ к которому запустил эту загрузку, для ленивых загрузок |

1403| `parent_file_path` | Путь к родительскому файлу инструкций, который включил этот, для загрузок `include` |1403| `parent_file_path` | Путь к файлу инструкций родителя, который включил этот, для загрузок `include` |

1404 1404 

1405```json theme={null}1405```json theme={null}

1406{1406{

1415```1415```

1416 1416 

1417<h4 id="instructionsloaded-decision-control">1417<h4 id="instructionsloaded-decision-control">

1418 InstructionsLoaded decision control1418 Управление решением InstructionsLoaded

1419</h4>1419</h4>

1420 1420 

1421Hooks InstructionsLoaded не имеют управления решением. Они не могут блокировать или изменять загрузку инструкций. Claude Code отбрасывает их [JSON output fields](#json-output), такие как `systemMessage` и `continue`. Используйте это событие для аудита логирования, отслеживания соответствия или наблюдаемости.1421Hooks InstructionsLoaded не имеют управления решением. Они не могут блокировать или изменять загрузку инструкций. Claude Code отбрасывает их [поля JSON-вывода](#json-output), такие как `systemMessage` и `continue`. Используйте это событие для аудита логирования, отслеживания соответствия или наблюдаемости.

1422 1422 

1423<h3 id="userpromptsubmit">1423<h3 id="userpromptsubmit">

1424 UserPromptSubmit1424 UserPromptSubmit

1426 1426 

1427Запускается, когда пользователь отправляет подсказку, перед обработкой Claude. Это позволяет вам добавить дополнительный контекст на основе подсказки/разговора, проверить подсказки или заблокировать определенные типы подсказок.1427Запускается, когда пользователь отправляет подсказку, перед обработкой Claude. Это позволяет вам добавить дополнительный контекст на основе подсказки/разговора, проверить подсказки или заблокировать определенные типы подсказок.

1428 1428 

1429Hooks `UserPromptSubmit` имеют стандартный timeout 30 секунд для типов `command`, `http` и `mcp_tool`, короче, чем стандартный 600-секундный timeout для этих типов на большинстве других событий. Поскольку этот hook выполняется перед каждой подсказкой и блокирует обработку модели до его завершения, зависший hook замораживает сеанс. Если вашему hook нужно больше времени, установите поле `timeout` в записи hook.1429Hooks `UserPromptSubmit` имеют тайм-аут по умолчанию 30 секунд для типов `command`, `http` и `mcp_tool`, короче, чем 600-секундный стандарт для этих типов на большинстве других событий. Поскольку этот hook выполняется перед каждой подсказкой и блокирует обработку модели до его завершения, застрявший hook замораживает сеанс. Если вашему hook нужно больше времени, установите поле `timeout` в записи hook.

1430 1430 

1431Помимо command hook, который вы запускаете с [`async: true`](#run-hooks-in-the-background), hook `UserPromptSubmit` command, HTTP или MCP tool, который достигает своего timeout, отменяется и его вывод, включая любой `additionalContext`, отбрасывается. Подсказка все еще достигает Claude без этого контекста. Транскрипт показывает уведомление, называющее hook, timeout, который сработал, и что вывод был отброшен.1431Помимо command hook, который вы запускаете с [`async: true`](#run-hooks-in-the-background), hook `UserPromptSubmit` command, HTTP или MCP tool, который достигает своего тайм-аута, отменяется и его вывод, включая любой `additionalContext`, отбрасывается. Подсказка все еще достигает Claude без этого контекста. Транскрипт показывает уведомление с названием hook, тайм-аутом, который сработал, и что вывод был отброшен.

1432 1432 

1433[Agent SDK callback hook](/docs/ru/agent-sdk/hooks) на `UserPromptSubmit`, который достигает своего timeout, блокирует подсказку сообщением, называющим hook и timeout, потому что callback там может действовать как политический шлюз, который не должен отказывать открыто. Сеанс продолжается. До версии 2.1.208 callback timeout на этом событии заканчивал ход с ошибкой выполнения.1433[Callback hook Agent SDK](/docs/ru/agent-sdk/hooks) на `UserPromptSubmit`, который достигает своего тайм-аута, блокирует подсказку сообщением с названием hook и тайм-аутом, потому что callback там может действовать как политический шлюз, который не должен открываться при отказе. Сеанс продолжается. До версии 2.1.208 тайм-аут callback на этом событии заканчивал ход с ошибкой выполнения.

1434 1434 

1435<h4 id="userpromptsubmit-input">1435<h4 id="userpromptsubmit-input">

1436 UserPromptSubmit input1436 Ввод UserPromptSubmit

1437</h4>1437</h4>

1438 1438 

1439Помимо [common input fields](#common-input-fields), hooks UserPromptSubmit получают поле `prompt`, содержащее текст, отправленный пользователем.1439Помимо [общих полей ввода](#common-input-fields), hooks UserPromptSubmit получают поле `prompt`, содержащее текст, отправленный пользователем. Вставленный контент, который свернулся в заполнитель `[Pasted text #N]`, прибывает развернутым на месте. В сеансах, где Claude Code [отмечает вставленный текст для Claude](/docs/ru/terminal-config#how-claude-treats-pasted-text), этот развернутый контент находится между строкой `<pasted_content id="…">` и строкой `</pasted_content id="…">`, поэтому учитывайте эти строки, если ваш hook анализирует подсказку.

1440 1440 

1441```json theme={null}1441```json theme={null}

1442{1442{

1450```1450```

1451 1451 

1452<h4 id="userpromptsubmit-decision-control">1452<h4 id="userpromptsubmit-decision-control">

1453 UserPromptSubmit decision control1453 Управление решением UserPromptSubmit

1454</h4>1454</h4>

1455 1455 

1456Hooks `UserPromptSubmit` могут управлять тем, обрабатывается ли подсказка пользователя, и добавлять контекст. Все [JSON output fields](#json-output) доступны.1456Hooks `UserPromptSubmit` могут управлять тем, обрабатывается ли подсказка пользователя, и добавлять контекст. Все [поля JSON-вывода](#json-output) доступны.

1457 1457 

1458Есть два способа добавить контекст к разговору при коде выхода 0:1458Есть два способа добавить контекст к разговору при коде выхода 0:

1459 1459 

1460* **Plain text stdout**: Claude Code добавляет stdout, который он [рассматривает как простой текст](#exit-code-0), в контекст Claude1460* **Простой текст stdout**: Claude Code добавляет stdout, который он [рассматривает как простой текст](#exit-code-0), в контекст Claude

1461* **JSON с `additionalContext`**: используйте формат JSON ниже для большего контроля. Поле `additionalContext` добавляется как контекст1461* **JSON с `additionalContext`**: используйте формат JSON ниже для большего контроля. Значение `additionalContext` добавляется как контекст

1462 1462 

1463Ни один канал не создает видимую запись в транскрипте. Plain stdout и значение `additionalContext` каждое вводятся как системное напоминание, которое начинается с имени hook; Claude читает оба. Чтобы подтвердить доставку, проверьте [debug log](#debug-hooks).1463Ни один канал не создает видимую запись в транскрипте. Простой stdout и значение `additionalContext` каждый вводятся как системное напоминание, которое начинается с названия hook; Claude читает оба. Чтобы подтвердить доставку, проверьте [debug log](#debug-hooks).

1464 1464 

1465Чтобы заблокировать подсказку, верните JSON объект с `decision`, установленным на `"block"`:1465Чтобы заблокировать подсказку, верните объект JSON с `decision`, установленным на `"block"`:

1466 1466 

1467| Field | Description |1467| Поле | Описание |

1468| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |1468| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |

1469| `decision` | `"block"` предотвращает обработку подсказки и стирает ее из контекста. Опустите, чтобы позволить подсказке продолжить |1469| `decision` | `"block"` предотвращает обработку подсказки и стирает ее из контекста. Опустите, чтобы позволить подсказке продолжить |

1470| `reason` | Показано пользователю, когда `decision` имеет значение `"block"`. Не добавляется в контекст |1470| `reason` | Показано пользователю, когда `decision` имеет значение `"block"`. Не добавляется в контекст |

1472| `sessionTitle` | Устанавливает название сеанса. Используйте для автоматического именования сеансов на основе содержания подсказки |1472| `sessionTitle` | Устанавливает название сеанса. Используйте для автоматического именования сеансов на основе содержания подсказки |

1473| `suppressOriginalPrompt` | Если `true`, когда `decision` имеет значение `"block"`, опускает исходный текст подсказки из сообщения блокировки, показанного пользователю |1473| `suppressOriginalPrompt` | Если `true`, когда `decision` имеет значение `"block"`, опускает исходный текст подсказки из сообщения блокировки, показанного пользователю |

1474 1474 

1475Hook, который блокирует выходом 2, маршрутизируется так же, как `reason`: сообщение блокировки показывает текст stderr пользователю, и он не добавляется в контекст.1475Hook, который блокирует выходом 2, маршрутизируется так же, как `reason`: сообщение блокировки показывает текст stderr пользователю и не добавляется в контекст.

1476 1476 

1477```json theme={null}1477```json theme={null}

1478{1478{

1490 UserPromptExpansion1490 UserPromptExpansion

1491</h3>1491</h3>

1492 1492 

1493Запускается, когда команда, введенная пользователем, расширяется в подсказку перед достижением Claude. Используйте это для блокирования определенных команд от прямого вызова, внедрения контекста для определенного skill или логирования того, какие команды вызывают пользователи. Например, hook, соответствующий `deploy`, может заблокировать `/deploy`, если файл одобрения отсутствует, или hook, соответствующий skill проверки, может добавить контрольный список проверки команды как `additionalContext`.1493Запускается, когда команда, введенная пользователем, расширяется в подсказку перед достижением Claude. Используйте это для блокировки определенных команд от прямого вызова, внедрения контекста для определенного skill или логирования того, какие команды вызывают пользователи. Например, hook, соответствующий `deploy`, может заблокировать `/deploy`, если отсутствует файл одобрения, или hook, соответствующий skill проверки, может добавить контрольный список проверки команды как `additionalContext`.

1494 1494 

1495Это событие охватывает путь, который `PreToolUse` не охватывает: hook `PreToolUse`, соответствующий инструменту `Skill`, срабатывает только, когда Claude вызывает инструмент, но ввод `/skillname` напрямую обходит `PreToolUse`. `UserPromptExpansion` срабатывает на этом прямом пути.1495Это событие охватывает путь, который `PreToolUse` не охватывает: hook `PreToolUse`, соответствующий инструменту `Skill`, срабатывает только, когда Claude вызывает инструмент, но ввод `/skillname` напрямую обходит `PreToolUse`. `UserPromptExpansion` срабатывает на этом прямом пути.

1496 1496 

1497Совпадает с `command_name`. Оставьте matcher пустым для срабатывания на каждой команде типа подсказки.1497Совпадает с `command_name`. Оставьте matcher пустым для срабатывания на каждой команде типа подсказки.

1498 1498 

1499<h4 id="userpromptexpansion-input">1499<h4 id="userpromptexpansion-input">

1500 UserPromptExpansion input1500 Ввод UserPromptExpansion

1501</h4>1501</h4>

1502 1502 

1503Помимо [common input fields](#common-input-fields), hooks UserPromptExpansion получают `expansion_type`, `command_name`, `command_args`, `command_source` и исходную строку `prompt`. Поле `expansion_type` имеет значение `slash_command` для skill и пользовательских команд или `mcp_prompt` для подсказок MCP сервера.1503Помимо [общих полей ввода](#common-input-fields), hooks UserPromptExpansion получают `expansion_type`, `command_name`, `command_args`, `command_source` и исходную строку `prompt`. Поле `expansion_type` имеет значение `slash_command` для skill и пользовательских команд или `mcp_prompt` для подсказок сервера MCP.

1504 1504 

1505```json theme={null}1505```json theme={null}

1506{1506{

1518```1518```

1519 1519 

1520<h4 id="userpromptexpansion-decision-control">1520<h4 id="userpromptexpansion-decision-control">

1521 UserPromptExpansion decision control1521 Управление решением UserPromptExpansion

1522</h4>1522</h4>

1523 1523 

1524Hooks `UserPromptExpansion` могут заблокировать расширение или добавить контекст. Все [JSON output fields](#json-output) доступны.1524Hooks `UserPromptExpansion` могут блокировать расширение или добавлять контекст. Все [поля JSON-вывода](#json-output) доступны.

1525 1525 

1526| Field | Description |1526| Поле | Описание |

1527| :------------------ | :-------------------------------------------------------------------------------------------------------------------------- |1527| :------------------ | :-------------------------------------------------------------------------------------------------------------------------- |

1528| `decision` | `"block"` предотвращает расширение команды. Опустите, чтобы позволить ей продолжить |1528| `decision` | `"block"` предотвращает расширение команды. Опустите, чтобы позволить ей продолжить |

1529| `reason` | Показано пользователю, когда `decision` имеет значение `"block"` |1529| `reason` | Показано пользователю, когда `decision` имеет значение `"block"` |

1530| `additionalContext` | Строка, добавленная в контекст Claude рядом с расширенной подсказкой. См. [Add context for Claude](#add-context-for-claude) |1530| `additionalContext` | Строка, добавленная в контекст Claude рядом с развернутой подсказкой. См. [Add context for Claude](#add-context-for-claude) |

1531 1531 

1532Hook, который блокирует выходом 2, маршрутизируется так же, как `reason`: сообщение блокировки показывает текст stderr пользователю.1532Hook, который блокирует выходом 2, маршрутизируется так же, как `reason`: сообщение блокировки показывает текст stderr пользователю.

1533 1533 

1546 MessageDisplay1546 MessageDisplay

1547</h3>1547</h3>

1548 1548 

1549Запускается, пока сообщение помощника транслируется на экран. Claude Code отображает сообщение порциями: каждый раз, когда партия новых завершенных строк готова к отображению, hook выполняется один раз с этими строками, и Claude Code отображает текст замены hook вместо них. Длинное сообщение создает несколько вызовов; короткое сообщение может создать только один.1549Запускается, пока сообщение помощника транслируется на экран. Claude Code отображает сообщение порциями: каждый раз, когда партия новых завершенных строк готова к отрисовке, hook выполняется один раз с этими строками, и Claude Code отображает текст замены hook на их месте. Длинное сообщение создает несколько вызовов; короткое сообщение может создать только один.

1550 1550 

1551Используйте MessageDisplay для:1551Используйте MessageDisplay для:

1552 1552 

1553* удаления markdown для минимального отображения1553* удаления markdown для минимального отображения

1554* преобразования текста, который приложение Agent SDK показывает своим пользователям1554* преобразования текста, который приложение Agent SDK показывает своим пользователям

1555* редактирования API ключей или внутренних имен хостов из ответов Claude1555* редактирования ключей API или внутренних имен хостов из ответов Claude

1556 1556 

1557Claude Code удерживает каждую партию до возврата вашего hook, поэтому держите hook быстрым. Если hook не удается или истекает timeout, Claude Code отображает исходный текст. Стандартный timeout для этого события составляет 10 секунд; если вашему hook нужно больше времени, установите поле `timeout` в записи hook.1557Claude Code удерживает каждую партию до возврата вашего hook, поэтому держите hook быстрым. Если hook не удается или истекает время ожидания, Claude Code отображает исходный текст. Тайм-аут по умолчанию для этого события составляет 10 секунд; если вашему hook нужно больше времени, установите поле `timeout` в записи hook.

1558 1558 

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

1560 1560 

1561MessageDisplay не поддерживает matchers и срабатывает для каждого сообщения помощника, которое транслирует текст; сообщения без текста, такие как ответы только с вызовом инструмента, не запускают его.1561MessageDisplay не поддерживает matchers и срабатывает для каждого сообщения помощника, которое транслирует текст; сообщения без текста, такие как ответы только с вызовом инструмента, не запускают его.

1562 1562 

1563В неинтерактивных запусках, включая запросы Agent SDK и `claude -p`, MessageDisplay выполняется один раз на сообщение помощника вместо один раз на партию строк. Один вызов приходит после завершения сообщения и несет полный текст сообщения: `index` имеет значение `0`, `final` имеет значение `true`, и `delta` содержит все сообщение. Hook, который собирает текст `delta` для каждого сообщения, получает одинаковый общий текст в обоих режимах.1563В неинтерактивных запусках, включая запросы Agent SDK и `claude -p`, MessageDisplay выполняется один раз для каждого сообщения помощника вместо один раз для каждой партии строк. Один вызов прибывает после завершения сообщения и несет полный текст сообщения: `index` имеет значение `0`, `final` имеет значение `true`, и `delta` содержит все сообщение. Hook, который собирает текст `delta` для каждого сообщения, получает одинаковый общий текст в обоих режимах.

1564 1564 

1565<h4 id="messagedisplay-input">1565<h4 id="messagedisplay-input">

1566 MessageDisplay input1566 Ввод MessageDisplay

1567</h4>1567</h4>

1568 1568 

1569Помимо [common input fields](#common-input-fields), hooks MessageDisplay получают идентификаторы для хода и сообщения, позицию этого вызова в сообщении и новый текст в `delta`. Границы партий зависят от того, как транслируется текст, поэтому используйте `index` и `final` для отслеживания прогресса через сообщение, а не ожидайте, что строки будут сгруппированы определенным образом.1569Помимо [общих полей ввода](#common-input-fields), hooks MessageDisplay получают идентификаторы для хода и сообщения, позицию этого вызова в сообщении и новый текст в `delta`. Границы партий зависят от того, как транслируется текст, поэтому используйте `index` и `final` для отслеживания прогресса через сообщение, а не ожидайте, что строки будут сгруппированы определенным образом.

1570 1570 

1571| Field | Description |1571| Поле | Описание |

1572| :----------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1572| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1573| `turn_id` | UUID текущего хода |1573| `turn_id` | UUID текущего хода |

1574| `message_id` | UUID сообщения помощника, которое отображается. Стабилен во всех партиях одного сообщения. Это не API `msg_…` id, поэтому его нельзя коррелировать с id сообщений транскрипта |1574| `message_id` | UUID сообщения помощника, которое отображается. Стабилен для каждой партии одного сообщения. Это не API `msg_…` id, поэтому его нельзя коррелировать с id сообщений транскрипта |

1575| `index` | Индекс этой партии в сообщении, начиная с нуля |1575| `index` | Индекс этой партии в сообщении, начиная с нуля |

1576| `final` | `true` на последней партии сообщения. Каждое сообщение имеет ровно одну финальную партию |1576| `final` | `true` на последней партии сообщения. Каждое сообщение имеет ровно одну финальную партию |

1577| `delta` | Новые завершенные строки с момента предыдущей партии, включая завершающие новые строки. Всегда целые строки, кроме финальной партии, которая может заканчиваться в середине строки. В интерактивных запусках delta финальной партии пуста, когда сообщение заканчивается новой строкой, поэтому рассматривайте `final`, а не непустой delta, как сигнал конца сообщения. В запусках Agent SDK и `claude -p` один вызов несет все сообщение |1577| `delta` | Новые завершенные строки с момента предыдущей партии, включая завершающие новые строки. Всегда целые строки, кроме финальной партии, которая может заканчиваться в середине строки. В интерактивных запусках delta финальной партии пуст, когда сообщение заканчивается на новой строке, поэтому рассматривайте `final`, а не непустой delta, как сигнал конца сообщения. В запусках Agent SDK и `claude -p` один вызов несет все сообщение |

1578 1578 

1579```json theme={null}1579```json theme={null}

1580{1580{

1591```1591```

1592 1592 

1593<h4 id="messagedisplay-output">1593<h4 id="messagedisplay-output">

1594 MessageDisplay output1594 Вывод MessageDisplay

1595</h4>1595</h4>

1596 1596 

1597Помимо [JSON output fields](#json-output), доступных всем hooks, hooks MessageDisplay могут вернуть `displayContent` для замены delta на экране:1597Помимо [полей JSON-вывода](#json-output), доступных всем hooks, hooks MessageDisplay могут вернуть `displayContent` для замены delta на экране:

1598 1598 

1599| Field | Description |1599| Поле | Описание |

1600| :--------------- | :------------------------------------------------------------------- |1600| :--------------- | :------------------------------------------------------------------- |

1601| `displayContent` | Текст, отображаемый вместо delta. Опустите для отображения исходного |1601| `displayContent` | Текст, отображаемый вместо delta. Опустите для отображения исходного |

1602 1602 

1603Hooks MessageDisplay не имеют управления решением. Они не могут заблокировать сообщение или изменить то, что хранится в транскрипте или отправляется Claude. Claude Code действует на `displayContent` из их JSON вывода и отбрасывает `systemMessage` и `continue`.1603Hooks MessageDisplay не имеют управления решением. Они не могут блокировать сообщение или изменять то, что хранится в транскрипте или отправляется Claude. Claude Code действует на `displayContent` из их JSON-вывода и отбрасывает `systemMessage` и `continue`.

1604 1604 

1605Этот пример удаляет форматирование markdown из ответов Claude для отображения простого текста. Скрипт читает каждую партию из stdin, удаляет маркеры жирного шрифта и обратные кавычки встроенного кода из `delta` и возвращает результат как `displayContent`.1605Этот пример удаляет форматирование markdown из ответов Claude для отображения простого текста. Скрипт читает каждую партию из stdin, удаляет маркеры жирного шрифта и обратные кавычки встроенного кода из `delta` и возвращает результат как `displayContent`.

1606 1606 

1607<Tabs>1607<Tabs>

1608 <Tab title="macOS/Linux">1608 <Tab title="macOS/Linux">

1609 Зарегистрируйте command hook для события в файле настроек:1609 Зарегистрируйте command hook для события в файле параметров:

1610 1610 

1611 ```json theme={null}1611 ```json theme={null}

1612 {1612 {

1661 }1661 }

1662 ```1662 ```

1663 1663 

1664 Флаг `-NoProfile` пропускает загрузку вашего профиля PowerShell, поэтому hook запускается быстро, а `-ExecutionPolicy Bypass` позволяет PowerShell запустить локальный файл скрипта.1664 Флаг `-NoProfile` пропускает загрузку вашего профиля PowerShell, чтобы hook запустился быстро, а `-ExecutionPolicy Bypass` позволяет PowerShell запустить локальный файл скрипта.

1665 1665 

1666 Сохраните этот скрипт в `.claude/hooks/plain-display.ps1` в вашем проекте:1666 Сохраните этот скрипт в `.claude/hooks/plain-display.ps1` в вашем проекте:

1667 1667 

1684 PreToolUse1684 PreToolUse

1685</h3>1685</h3>

1686 1686 

1687Запускается после того, как Claude создает параметры инструмента и перед обработкой вызова инструмента. Совпадает с любым именем инструмента, кроме `EndConversation`: встроенные инструменты, такие как `Bash`, `PowerShell`, `Edit`, `Write`, `Read`, `Glob`, `Grep`, `Agent`, `Workflow`, `WebFetch`, `WebSearch`, `AskUserQuestion` и `ExitPlanMode`, и любые [MCP tool names](#match-mcp-tools).1687Запускается после того, как Claude создает параметры инструмента и перед обработкой вызова инструмента. Совпадает с любым названием инструмента, кроме `EndConversation`: встроенные инструменты, такие как `Bash`, `PowerShell`, `Edit`, `Write`, `Read`, `Glob`, `Grep`, `Agent`, `Workflow`, `WebFetch`, `WebSearch`, `AskUserQuestion` и `ExitPlanMode`, и любые [имена инструментов MCP](#match-mcp-tools).

1688 1688 

1689Чтобы запустить hook, когда определенный файл изменяется на диске, независимо от того, что его написало, используйте [FileChanged](#filechanged) вместо соответствия инструментам редактирования файлов по имени. В отличие от PreToolUse, Claude Code запускает hooks FileChanged после изменения, и они не имеют управления решением, поэтому они не могут заблокировать запись.1689Чтобы запустить hook, когда определенный файл изменяется на диске, независимо от того, что его написало, используйте вместо этого [FileChanged](#filechanged). В отличие от PreToolUse, Claude Code запускает hooks FileChanged после изменения, и они не имеют управления решением, поэтому они не могут блокировать запись.

1690 1690 

1691<Warning>1691<Warning>

1692 PreToolUse запускается только, когда Claude вызывает инструмент. Файлы, которые вы [ссылаетесь с `@` в вашей подсказке](/docs/ru/common-workflows#reference-files-and-directories), добавляются без вызова инструмента: Claude Code вставляет их содержимое при построении подсказки, поэтому никакой hook PreToolUse не срабатывает для них, включая hooks, соответствующие `Read`. Чтобы заблокировать определенные пути от ссылок `@`, используйте [правило отказа `Read`](/docs/ru/permissions#read-and-edit) вместо этого.1692 PreToolUse запускается только, когда Claude вызывает инструмент. Файлы, которые вы [ссылаетесь с `@` в вашей подсказке](/docs/ru/common-workflows#reference-files-and-directories), добавляются без вызова инструмента: Claude Code вставляет их содержимое при построении подсказки, поэтому для них не срабатывает hook PreToolUse, включая hooks, соответствующие `Read`. Чтобы заблокировать определенные пути от ссылок `@`, используйте вместо этого [`Read` deny rule](/docs/ru/permissions#read-and-edit).

1693 1693 

1694 PreToolUse также не срабатывает для [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior).1694 PreToolUse также не срабатывает для [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior).

1695</Warning>1695</Warning>

1696 1696 

1697Используйте [PreToolUse decision control](#pretooluse-decision-control) для разрешения, отказа, запроса или отсрочки вызова инструмента.1697Используйте [управление решением PreToolUse](#pretooluse-decision-control) для разрешения, отказа, запроса или отложения вызова инструмента.

1698 1698 

1699[Agent SDK callback hook](/docs/ru/agent-sdk/hooks) на `PreToolUse`, который превышает свой timeout, блокирует вызов инструмента, и Claude получает результат ошибки, называющий timeout. Явный отказ, возвращенный другим hook, все еще имеет приоритет.1699[Callback hook Agent SDK](/docs/ru/agent-sdk/hooks) на `PreToolUse`, который превышает свой тайм-аут, блокирует вызов инструмента, и Claude получает результат ошибки с названием тайм-аута. Явный отказ, возвращенный другим hook, все еще имеет приоритет.

1700 1700 

1701<h4 id="pretooluse-input">1701<h4 id="pretooluse-input">

1702 PreToolUse input1702 Ввод PreToolUse

1703</h4>1703</h4>

1704 1704 

1705Помимо [common input fields](#common-input-fields), hooks PreToolUse получают `tool_name`, `tool_input` и `tool_use_id`.1705Помимо [общих полей ввода](#common-input-fields), hooks PreToolUse получают `tool_name`, `tool_input` и `tool_use_id`.

1706 1706 

1707Для [MCP tool](#match-mcp-tools), ввод также несет `mcp_server`, объект с `name` сервера и `source`, который говорит, откуда пришло определение сервера. Значения `source` включают `plugin`, `sdk` и области конфигурации, такие как `user` и `project`. [`McpServerProvenance`](/docs/ru/agent-sdk/typescript#mcpserverprovenance) в справочнике Agent SDK перечисляет их все и говорит, как рассматривать тот, который вы не узнаете. Основывайте решения о доверии на `source`, а не на `name` или префиксе инструмента `mcp__<server>__`. Поле `mcp_server` требует Claude Code v2.1.274 или позже.1707Для [инструмента MCP](#match-mcp-tools) ввод также несет `mcp_server`, объект с `name` сервера и `source`, который говорит, откуда пришло определение сервера. Значения `source` включают `plugin`, `sdk` и области конфигурации, такие как `user` и `project`. [`McpServerProvenance`](/docs/ru/agent-sdk/typescript#mcpserverprovenance) в справочнике Agent SDK перечисляет их все и говорит, как рассматривать тот, который вы не узнаете. Основывайте решения о доверии на `source`, а не на `name` или префиксе инструмента `mcp__<server>__`. Поле `mcp_server` требует Claude Code v2.1.274 или позже.

1708 1708 

1709Для инструментов файлов `Write`, `Edit` и `Read`, `tool_input.file_path` всегда абсолютен:1709Для инструментов файлов `Write`, `Edit` и `Read`, `tool_input.file_path` всегда абсолютен:

1710 1710 

1711* Claude Code расширяет `~` и относительные пути перед выполнением hooks, поэтому hook, который совпадает с путями, не может быть обойден через `~` или относительное написание того же пути1711* Claude Code расширяет `~` и относительные пути перед выполнением hooks, поэтому hook, который совпадает с путями, не может быть обойден через `~` или относительное написание одного пути

1712* На Windows путь приходит с разделителями обратной косой черты, даже когда ваш hook выполняется под Git Bash, где `$PWD` выглядит как `/c/project`1712* На Windows путь прибывает с разделителями обратной косой черты, даже когда ваш hook выполняется под Git Bash, где `$PWD` выглядит как `/c/project`

1713* Сравнение, написанное с прямыми косыми чертами, такое как проверка `/src/`, никогда не совпадает с путем обратной косой черты, и вызов инструмента продолжается, как если бы hook не имел ничего для блокировки1713* Сравнение, написанное с прямыми косыми чертами, такое как проверка `/src/`, никогда не совпадает с путем обратной косой черты, и вызов инструмента продолжается, как если бы hook не имел ничего для блокировки

1714* Нормализуйте разделители перед сравнением: `FILE_PATH="${FILE_PATH//\\//}"` в Bash или `file_path.replace("\\", "/")` в Python, затем совпадайте с сегментом пути, такой как `/src/`, а не якорем с `^`, так как путь абсолютен1714* Нормализуйте разделители перед сравнением: `FILE_PATH="${FILE_PATH//\\//}"` в Bash или `file_path.replace("\\", "/")` в Python, затем совпадайте с сегментом пути, такой как `/src/`, а не якорем с `^`, так как путь абсолютен

1715 1715 

1735 Bash1735 Bash

1736</h5>1736</h5>

1737 1737 

1738Выполняет команды shell.1738Выполняет команды оболочки.

1739 1739 

1740| Field | Type | Example | Description |1740| Поле | Тип | Пример | Описание |

1741| :------------------ | :------ | :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |1741| :------------------ | :------ | :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |

1742| `command` | string | `"npm test"` | Команда shell для выполнения |1742| `command` | string | `"npm test"` | Команда оболочки для выполнения |

1743| `description` | string | `"Run test suite"` | Опциональное описание того, что делает команда |1743| `description` | string | `"Run test suite"` | Опциональное описание того, что делает команда |

1744| `timeout` | number | `120000` | Опциональный timeout в миллисекундах. Значения выше [максимума](/docs/ru/tools-reference#bash-tool-behavior) уменьшаются до максимума, а не отклоняются |1744| `timeout` | number | `120000` | Опциональный тайм-аут в миллисекундах. Значения выше [максимума](/docs/ru/tools-reference#bash-tool-behavior) уменьшаются до максимума, а не отклоняются |

1745| `run_in_background` | boolean | `false` | Выполнять ли команду в фоне |1745| `run_in_background` | boolean | `false` | Выполнять ли команду в фоновом режиме |

1746 1746 

1747Когда команда Bash изменяет файлы в репозитории Git, Claude Code может записать, что изменилось. Он записывает изменения в каждом режиме разрешений, когда параметр [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled) включает запись; запись этого параметра говорит, какие файлы могут его установить. В противном случае он записывает их только в режиме auto и режиме `bypassPermissions`, и только когда Claude Code направляет Claude редактировать файлы через Bash. Установите `bashEditDiffEnabled` на `false`, чтобы отключить запись. Фоновые команды и команды только для чтения не несут diff.1747Когда команда Bash изменяет файлы в репозитории Git, Claude Code может записать, что изменилось. Он записывает изменения в каждом режиме разрешений, когда параметр [`bashEditDiffEnabled`](/docs/ru/settings-reference#basheditdiffenabled) включает запись; запись этого параметра говорит, какие файлы могут его установить. В противном случае он записывает их только в режиме auto и режиме `bypassPermissions`, и только когда Claude Code направляет Claude на редактирование файлов через Bash. Установите `bashEditDiffEnabled` на `false`, чтобы отключить запись. Фоновые команды и команды только для чтения не несут diff.

1748 1748 

1749Ваш [PostToolUse hook](#posttooluse) затем получает измененные файлы в `tool_response.bashEditDiff`. Список охватывает то, что изменилось в репозитории, пока выполнялась команда. Файлы, которые Git игнорирует, и файлы в подмодулях не указаны. Требует Claude Code v2.1.269 или позже.1749Ваш [hook PostToolUse](#posttooluse) затем получает измененные файлы в `tool_response.bashEditDiff`. Список охватывает то, что изменилось в репозитории, пока выполнялась команда. Файлы, которые Git игнорирует, и файлы в подмодулях не указаны. Требует Claude Code v2.1.269 или позже.

1750 1750 

1751<Note>1751<Note>

1752 Список лучше всего усилен и находится в публичной бета-версии. Claude Code может пропустить изменение, включить файл, который другой процесс изменил одновременно, или остановиться на его пределах размера. Форма поля может измениться. Используйте список для поиска того, что нужно проверить, а не для применения политики.1752 Список лучше всего усилен и находится в публичной бета-версии. Claude Code может пропустить изменение, включить файл, который другой процесс изменил одновременно, или остановиться на его пределах размера. Форма поля может измениться. Используйте список для поиска того, что нужно проверить, а не для применения политики.

1753</Note>1753</Note>

1754 1754 

1755`changedFiles` и `files` указывают, что изменила команда; остальные поля говорят, насколько полон и надежен этот список.1755`changedFiles` и `files` перечисляют то, что команда изменила; остальные поля говорят, насколько полон и надежен этот список.

1756 1756 

1757| Field | Type | Example | Description |1757| Поле | Тип | Пример | Описание |

1758| :------------- | :------ | :------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1758| :------------- | :------ | :------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1759| `changedFiles` | array | `["/path/to/src/app.ts"]` | Абсолютные пути файлов, которые команда изменила, максимум 200. Присутствует, когда `files` содержит diff или `moreFiles` выше нуля |1759| `changedFiles` | array | `["/path/to/src/app.ts"]` | Абсолютные пути файлов, которые команда изменила, максимум 200. Присутствует, когда `files` содержит diff или `moreFiles` выше нуля |

1760| `files` | array | `[{"filePath": "/path/to/src/app.ts", "hunks": [...]}]` | Diffs до 5 измененных файлов для отображения. `created` или `deleted` имеет значение `true` для файла, который команда добавила или удалила |1760| `files` | array | `[{"filePath": "/path/to/src/app.ts", "hunks": [...]}]` | Diffs до 5 измененных файлов для отображения. `created` или `deleted` имеет значение `true` для файла, который команда добавила или удалила |

1769 PowerShell1769 PowerShell

1770</h5>1770</h5>

1771 1771 

1772Выполняет команды PowerShell. См. [PowerShell tool](/docs/ru/tools-reference#powershell-tool) для доступности по платформе.1772Выполняет команды PowerShell. См. [инструмент PowerShell](/docs/ru/tools-reference#powershell-tool) для доступности по платформе.

1773 1773 

1774Поля совпадают с инструментом Bash, со строкой команды в `command`:1774Поля совпадают с инструментом Bash, со строкой команды в `command`:

1775 1775 

1776| Field | Type | Example | Description |1776| Поле | Тип | Пример | Описание |

1777| :------------------ | :------ | :------------------------- | :--------------------------------------------- |1777| :------------------ | :------ | :------------------------- | :--------------------------------------------- |

1778| `command` | string | `"Get-ChildItem -Recurse"` | Команда PowerShell для выполнения |1778| `command` | string | `"Get-ChildItem -Recurse"` | Команда PowerShell для выполнения |

1779| `description` | string | `"List files recursively"` | Опциональное описание того, что делает команда |1779| `description` | string | `"List files recursively"` | Опциональное описание того, что делает команда |

1780| `timeout` | number | `120000` | Опциональный timeout в миллисекундах |1780| `timeout` | number | `120000` | Опциональный тайм-аут в миллисекундах |

1781| `run_in_background` | boolean | `false` | Выполнять ли команду в фоне |1781| `run_in_background` | boolean | `false` | Выполнять ли команду в фоновом режиме |

1782 1782 

1783Совпадайте с `Bash|PowerShell` в hooks, которые проверяют команды shell, поэтому они охватывают оба инструмента:1783Совпадайте с `Bash|PowerShell` в hooks, которые проверяют команды оболочки, чтобы они охватывали оба инструмента:

1784 1784 

1785* На Windows, везде, где включен инструмент PowerShell, Claude рассматривает PowerShell как основной shell и маршрутизирует команды shell через него.1785* На Windows, везде, где включен инструмент PowerShell, Claude рассматривает PowerShell как основную оболочку и маршрутизирует команды оболочки через него.

1786* На Windows без Git Bash инструмент включен автоматически, и Claude Code вообще не регистрирует инструмент Bash.1786* На Windows без Git Bash инструмент включен автоматически и Claude Code не регистрирует инструмент Bash вообще.

1787* Hook, который совпадает только с `Bash`, никогда не срабатывает там.1787* Hook, который совпадает только с `Bash`, никогда не срабатывает там.

1788 1788 

1789<h5 id="write">1789<h5 id="write">

1792 1792 

1793Создает или перезаписывает файл.1793Создает или перезаписывает файл.

1794 1794 

1795| Field | Type | Example | Description |1795| Поле | Тип | Пример | Описание |

1796| :---------- | :----- | :-------------------- | :--------------------------------- |1796| :---------- | :----- | :-------------------- | :--------------------------------- |

1797| `file_path` | string | `"/path/to/file.txt"` | Абсолютный путь к файлу для записи |1797| `file_path` | string | `"/path/to/file.txt"` | Абсолютный путь к файлу для записи |

1798| `content` | string | `"file content"` | Содержимое для записи в файл |1798| `content` | string | `"file content"` | Содержимое для записи в файл |

1803 1803 

1804Заменяет строку в существующем файле.1804Заменяет строку в существующем файле.

1805 1805 

1806| Field | Type | Example | Description |1806| Поле | Тип | Пример | Описание |

1807| :------------ | :------ | :-------------------- | :----------------------------------------- |1807| :------------ | :------ | :-------------------- | :----------------------------------------- |

1808| `file_path` | string | `"/path/to/file.txt"` | Абсолютный путь к файлу для редактирования |1808| `file_path` | string | `"/path/to/file.txt"` | Абсолютный путь к файлу для редактирования |

1809| `old_string` | string | `"original text"` | Текст для поиска и замены |1809| `old_string` | string | `"original text"` | Текст для поиска и замены |

1816 1816 

1817Читает содержимое файла.1817Читает содержимое файла.

1818 1818 

1819| Field | Type | Example | Description |1819| Поле | Тип | Пример | Описание |

1820| :---------- | :----- | :-------------------- | :------------------------------------------ |1820| :---------- | :----- | :-------------------- | :------------------------------------------ |

1821| `file_path` | string | `"/path/to/file.txt"` | Абсолютный путь к файлу для чтения |1821| `file_path` | string | `"/path/to/file.txt"` | Абсолютный путь к файлу для чтения |

1822| `offset` | number | `10` | Опциональный номер строки для начала чтения |1822| `offset` | number | `10` | Опциональный номер строки для начала чтения |

1828 1828 

1829Находит файлы, соответствующие шаблону glob.1829Находит файлы, соответствующие шаблону glob.

1830 1830 

1831| Field | Type | Example | Description |1831| Поле | Тип | Пример | Описание |

1832| :-------- | :----- | :--------------- | :-------------------------------------------------------------------------- |1832| :-------- | :----- | :--------------- | :-------------------------------------------------------------------------- |

1833| `pattern` | string | `"**/*.ts"` | Шаблон glob для соответствия файлам |1833| `pattern` | string | `"**/*.ts"` | Шаблон glob для совпадения файлов |

1834| `path` | string | `"/path/to/dir"` | Опциональная директория для поиска. По умолчанию текущая рабочая директория |1834| `path` | string | `"/path/to/dir"` | Опциональная директория для поиска. По умолчанию текущая рабочая директория |

1835 1835 

1836<h5 id="grep">1836<h5 id="grep">

1837 Grep1837 Grep

1838</h5>1838</h5>

1839 1839 

1840Ищет содержимое файлов с помощью регулярных выражений.1840Ищет содержимое файлов с регулярными выражениями.

1841 1841 

1842| Field | Type | Example | Description |1842| Поле | Тип | Пример | Описание |

1843| :------------ | :------ | :--------------- | :------------------------------------------------------------------------------------- |1843| :------------ | :------ | :--------------- | :------------------------------------------------------------------------------------- |

1844| `pattern` | string | `"TODO.*fix"` | Шаблон регулярного выражения для поиска |1844| `pattern` | string | `"TODO.*fix"` | Шаблон регулярного выражения для поиска |

1845| `path` | string | `"/path/to/dir"` | Опциональный файл или директория для поиска |1845| `path` | string | `"/path/to/dir"` | Опциональный файл или директория для поиска |

1846| `glob` | string | `"*.ts"` | Опциональный шаблон glob для фильтрации файлов |1846| `glob` | string | `"*.ts"` | Опциональный шаблон glob для фильтрации файлов |

1847| `output_mode` | string | `"content"` | `"content"`, `"files_with_matches"` или `"count"`. По умолчанию `"files_with_matches"` |1847| `output_mode` | string | `"content"` | `"content"`, `"files_with_matches"` или `"count"`. По умолчанию `"files_with_matches"` |

1848| `-i` | boolean | `true` | Поиск без учета регистра |1848| `-i` | boolean | `true` | Поиск без учета регистра |

1849| `multiline` | boolean | `false` | Включить многострочное соответствие |1849| `multiline` | boolean | `false` | Включить многострочное совпадение |

1850 1850 

1851<h5 id="webfetch">1851<h5 id="webfetch">

1852 WebFetch1852 WebFetch

1853</h5>1853</h5>

1854 1854 

1855Получает и обрабатывает веб-содержимое.1855Получает и обрабатывает веб-контент.

1856 1856 

1857| Field | Type | Example | Description |1857| Поле | Тип | Пример | Описание |

1858| :------- | :----- | :---------------------------- | :--------------------------------------------- |1858| :------- | :----- | :---------------------------- | :------------------------------------------- |

1859| `url` | string | `"https://example.com/api"` | URL для получения содержимого |1859| `url` | string | `"https://example.com/api"` | URL для получения контента |

1860| `prompt` | string | `"Extract the API endpoints"` | Подсказка для запуска на полученном содержимом |1860| `prompt` | string | `"Extract the API endpoints"` | Подсказка для запуска на полученном контенте |

1861 1861 

1862<h5 id="websearch">1862<h5 id="websearch">

1863 WebSearch1863 WebSearch

1865 1865 

1866Ищет в веб.1866Ищет в веб.

1867 1867 

1868| Field | Type | Example | Description |1868| Поле | Тип | Пример | Описание |

1869| :---------------- | :----- | :----------------------------- | :------------------------------------------------------ |1869| :---------------- | :----- | :----------------------------- | :------------------------------------------------------ |

1870| `query` | string | `"react hooks best practices"` | Поисковый запрос |1870| `query` | string | `"react hooks best practices"` | Поисковый запрос |

1871| `allowed_domains` | array | `["docs.example.com"]` | Опциональный: включить результаты только с этих доменов |1871| `allowed_domains` | array | `["docs.example.com"]` | Опциональный: включить результаты только с этих доменов |

1875 Agent1875 Agent

1876</h5>1876</h5>

1877 1877 

1878Порождает [subagent](/docs/ru/sub-agents).1878Порождает [подагента](/docs/ru/sub-agents).

1879 1879 

1880| Field | Type | Example | Description |1880| Поле | Тип | Пример | Описание |

1881| :-------------- | :----- | :------------------------- | :--------------------------------------------------------- |1881| :-------------- | :----- | :------------------------- | :------------------------------------------------------------- |

1882| `prompt` | string | `"Find all API endpoints"` | Задача для выполнения агентом |1882| `prompt` | string | `"Find all API endpoints"` | Задача для выполнения агентом |

1883| `description` | string | `"Find API endpoints"` | Краткое описание задачи |1883| `description` | string | `"Find API endpoints"` | Краткое описание задачи |

1884| `subagent_type` | string | `"Explore"` | Тип специализированного агента для использования |1884| `subagent_type` | string | `"Explore"` | Тип специализированного агента для использования |

1885| `model` | string | `"sonnet"` | Опциональный alias модели для переопределения по умолчанию |1885| `model` | string | `"sonnet"` | Опциональный псевдоним модели для переопределения стандартного |

1886 1886 

1887Когда вызов Agent переднего плана завершается, ваш [PostToolUse hook](#posttooluse) получает финальный текст подагента и телеметрию запуска в `tool_response`. Прочитайте эти поля для проверки запуска; для сводок токенов и затрат по подагентам используйте [token and cost counters](/docs/ru/monitoring-usage#token-counter), отфильтрованные по `query_source` `"subagent"`, так как `totalTokens` и `usage` охватывают только финальный запрос:1887Когда вызов Agent переднего плана завершается, ваш [hook PostToolUse](#posttooluse) получает результат подагента и телеметрию запуска в `tool_response`. Прочитайте эти поля для проверки запуска; для сводок токенов и затрат по подагентам используйте [счетчики токенов и затрат](/docs/ru/monitoring-usage#token-counter), отфильтрованные по `query_source` `"subagent"`, так как `totalTokens` и `usage` охватывают только финальный запрос:

1888 1888 

1889| Field | Type | Example | Description |1889| Поле | Тип | Пример | Описание |

1890| :------------------ | :----- | :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1890| :------------------ | :----- | :---------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1891| `status` | string | `"completed"` | `"completed"` для подагентов переднего плана, `"async_launched"` для подагентов фонового плана. Начиная с v2.1.198, подагенты выполняются в фоне по умолчанию, поэтому опущенный `run_in_background` также создает `"async_launched"` |1891| `status` | string | `"completed"` | `"completed"` для подагентов переднего плана, `"async_launched"` для подагентов фонового плана. Начиная с версии 2.1.198, подагенты выполняются в фоновом режиме по умолчанию, поэтому опущенный `run_in_background` также создает `"async_launched"` |

1892| `agentId` | string | `"a4d2c8f1e0b3a297"` | Идентификатор для запуска подагента |1892| `agentId` | string | `"a4d2c8f1e0b3a297"` | Идентификатор для запуска подагента |

1893| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Финальные текстовые блоки подагента, или, для подагента, чей отчет проходит через `SubagentHandback`, краткая заметка об этой передаче вместо них |1893| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | Финальные текстовые блоки подагента или, для подагента, чей отчет проходит через `SubagentHandback`, краткая заметка об этой передаче на их месте |

1894| `resolvedModel` | string | `"claude-sonnet-4-5"` | Модель, на которой подагент начал, которая может отличаться от запрошенной модели |1894| `resolvedModel` | string | `"claude-sonnet-4-5"` | Модель, на которой подагент начал, которая может отличаться от запрошенной модели |

1895| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | Модели, используемые по порядку, с последовательными повторениями свернутыми; установлено только, когда модель была переключена во время запуска. Требует Claude Code v2.1.212 или позже |1895| `modelsUsed` | array | `["claude-sonnet-4-5", "claude-haiku-4-5"]` | Модели, используемые по порядку, с последовательными повторениями свернутыми; установлено только, когда модель была переключена во время запуска. Требует Claude Code v2.1.212 или позже |

1896| `totalTokens` | number | `12450` | Количество токенов из финального API запроса подагента: входные, выходные и кэшированные токены в сумме. Это не общее количество по всему запуску |1896| `totalTokens` | number | `12450` | Количество токенов из финального API запроса подагента: входные, выходные и кэшированные токены в сумме. Это не общее количество по всему запуску |

1898| `totalToolUseCount` | number | `7` | Количество вызовов инструментов, которые сделал подагент |1898| `totalToolUseCount` | number | `7` | Количество вызовов инструментов, которые сделал подагент |

1899| `usage` | object | `{"input_tokens": 8320, ...}` | Разбор токенов по типам финального API запроса: `input_tokens`, `output_tokens`, `cache_creation_input_tokens`, `cache_read_input_tokens` |1899| `usage` | object | `{"input_tokens": 8320, ...}` | Разбор токенов по типам финального API запроса: `input_tokens`, `output_tokens`, `cache_creation_input_tokens`, `cache_read_input_tokens` |

1900 1900 

1901На Claude Code v2.1.271 или позже подагент, который выполняется с инструментом [`SubagentHandback`](/docs/ru/tools-reference), который Claude Code предоставляет в [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), доставляет свой отчет через этот инструмент, а не возвращает его как текст. Поле `content` его результата `completed` затем несет краткую заметку об этой передаче, а не сам отчет. Чтобы прочитать отчет, совпадайте с hook `PreToolUse` или `PostToolUse` на `SubagentHandback` и прочитайте `tool_input.message`.1901На Claude Code v2.1.271 или позже подагент, который выполняется с инструментом [`SubagentHandback`](/docs/ru/tools-reference), который Claude Code предоставляет в [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), доставляет свой отчет через этот инструмент, а не возвращает его как текст. Поле `content` его результата `completed` затем несет краткую заметку об этой передаче, а не сам отчет. Чтобы прочитать отчет, совпадайте с hook `PreToolUse` или `PostToolUse` на `SubagentHandback` и прочитайте `tool_input.message`.

1902 1902 

1903Для подагентов фонового плана инструмент возвращается, когда задача переходит в фон, поэтому `tool_response` не несет полей использования: фоновый запуск возвращается немедленно, и задача переднего плана, которую Claude Code переводит в фон во время запуска, возвращается при этом переходе. Он имеет `status: "async_launched"`, `agentId`, `description`, `prompt`, `outputFile` и `resolvedModel`.1903Для подагентов фонового плана инструмент возвращается, когда задача переходит в фоновый режим, поэтому `tool_response` не несет полей использования: фоновый запуск возвращается немедленно, и задача переднего плана, которую Claude Code переводит в фоновый режим во время запуска, возвращается при этом переходе. Он имеет `status: "async_launched"`, `agentId`, `description`, `prompt`, `outputFile` и `resolvedModel`.

1904 1904 

1905На ответе `completed`, `resolvedModel` называет модель, на которой подагент начал, что может отличаться от значения `model` в `tool_input`, такого как когда `availableModels` или другое переопределение применяется. На ответе `async_launched`, `resolvedModel` называет модель в использовании, когда агент переходит в фон, поэтому переключение, которое произошло перед переходом в фон, отражается там. `modelsUsed` и поведение `resolvedModel` во время перехода в фон требуют Claude Code v2.1.212 или позже.1905На ответе `completed`, `resolvedModel` называет модель, на которой подагент начал, которая может отличаться от значения `model` в `tool_input`, такой как когда `availableModels` или другое переопределение применяется. На ответе `async_launched`, `resolvedModel` называет модель в использовании, когда агент перешел в фоновый режим, поэтому переключение, которое произошло перед переходом в фоновый режим, отражается там. `modelsUsed` и поведение `resolvedModel` во время перехода в фоновый режим требуют Claude Code v2.1.212 или позже.

1906 1906 

1907<a id="askuserquestion" />1907<a id="askuserquestion" />

1908 1908 

1912 1912 

1913Задает пользователю один-четыре вопроса с множественным выбором.1913Задает пользователю один-четыре вопроса с множественным выбором.

1914 1914 

1915| Field | Type | Example | Description |1915| Поле | Тип | Пример | Описание |

1916| :---------- | :----- | :----------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1916| :---------- | :----- | :----------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1917| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React"}], "multiSelect": false}]` | Вопросы для представления, каждый с строкой `question`, коротким `header`, массивом `options` и опциональным флагом `multiSelect` |1917| `questions` | array | `[{"question": "Which framework?", "header": "Framework", "options": [{"label": "React"}], "multiSelect": false}]` | Вопросы для представления, каждый с строкой `question`, коротким `header`, массивом `options` и опциональным флагом `multiSelect` |

1918| `answers` | object | `{"Which framework?": "React"}` | Опциональный. Отображает текст вопроса на выбранный label опции. Ответы с множественным выбором объединяют labels запятыми. Claude не устанавливает это поле; предоставьте его через `updatedInput` для программного ответа |1918| `answers` | object | `{"Which framework?": "React"}` | Опциональный. Отображает текст вопроса на выбранный ярлык опции. Ответы с множественным выбором объединяют ярлыки запятыми. Claude не устанавливает это поле; предоставьте его через `updatedInput` для программного ответа |

1919 1919 

1920<h5 id="exitplanmode">1920<h5 id="exitplanmode">

1921 ExitPlanMode1921 ExitPlanMode

1922</h5>1922</h5>

1923 1923 

1924Представляет план и просит пользователя одобрить его перед тем, как Claude покидает [plan mode](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude записывает план в файл на диск перед вызовом инструмента, поэтому буквальный `tool_input` из модели обычно пуст. Claude Code вводит содержимое плана и путь к файлу перед передачей ввода в hooks.1924Представляет план и просит пользователя одобрить его перед тем, как Claude покинет [режим плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode). Claude записывает план в файл на диск перед вызовом инструмента, поэтому буквальный `tool_input` из модели обычно пуст. Claude Code вводит содержимое плана и путь к файлу перед передачей ввода в hooks.

1925 1925 

1926| Field | Type | Example | Description |1926| Поле | Тип | Пример | Описание |

1927| :--------------- | :----- | :------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |1927| :--------------- | :----- | :------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1928| `plan` | string | `"## Refactor auth\n1. Extract..."` | Содержимое плана в Markdown. Введено из файла плана на диске |1928| `plan` | string | `"## Refactor auth\n1. Extract..."` | Содержимое плана в Markdown. Введено из файла плана на диске |

1929| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Путь к файлу плана. Введено |1929| `planFilePath` | string | `"/Users/.../plans/refactor-auth.md"` | Путь к файлу плана. Введено |

1930| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Устарело. Claude Code принимает поле, но игнорирует его. До v2.1.205 оно несло разрешения на основе подсказок, которые Claude запросил для реализации плана |1930| `allowedPrompts` | array | `[{"tool": "Bash", "prompt": "run tests"}]` | Устарело. Claude Code принимает поле, но игнорирует его. До версии 2.1.205 оно несло разрешения на основе подсказок, которые Claude запросил для реализации плана |

1931 1931 

1932В `PostToolUse`, `tool_response` — это объект с полями `plan` и `filePath`, содержащими одобренный план, плюс внутренние флаги статуса. Прочитайте `tool_response.plan` для содержимого плана, а не перечитывайте файл с диска.1932В `PostToolUse`, `tool_response` — это объект с полями `plan` и `filePath`, содержащими одобренный план, плюс внутренние флаги статуса. Прочитайте `tool_response.plan` для содержимого плана, а не перечитывайте файл с диска.

1933 1933 

1934<h4 id="pretooluse-decision-control">1934<h4 id="pretooluse-decision-control">

1935 PreToolUse decision control1935 Управление решением PreToolUse

1936</h4>1936</h4>

1937 1937 

1938Hooks `PreToolUse` могут управлять тем, продолжается ли вызов инструмента. В отличие от других hooks, которые используют поле `decision` верхнего уровня, PreToolUse возвращает свое решение внутри объекта `hookSpecificOutput`. Это дает ему более богатый контроль: четыре результата (разрешить, отказать, спросить или отсрочить) плюс возможность изменить ввод инструмента перед выполнением.1938Hooks `PreToolUse` могут управлять тем, продолжается ли вызов инструмента. В отличие от других hooks, которые используют поле `decision` верхнего уровня, PreToolUse возвращает свое решение внутри объекта `hookSpecificOutput`. Это дает ему более богатый контроль: четыре результата (разрешить, отказать, спросить или отложить) плюс возможность изменить ввод инструмента перед выполнением.

1939 1939 

1940| Field | Description |1940| Поле | Описание |

1941| :------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1941| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1942| `permissionDecision` | `"allow"` пропускает подсказку разрешения, кроме [actions no mode auto-approves](/docs/ru/permission-modes#actions-no-mode-auto-approves) и для `AskUserQuestion` и `ExitPlanMode`, которым нужен [`updatedInput` в паре с ним](#allow-with-updatedinput). `"deny"` предотвращает вызов инструмента. `"ask"` подсказывает пользователю подтвердить. `"defer"` выходит корректно, чтобы инструмент можно было возобновить позже. [Deny and ask rules](/docs/ru/permissions#manage-permissions) все еще оцениваются независимо от того, что возвращает hook |1942| `permissionDecision` | `"allow"` пропускает подсказку разрешения, кроме [действий, которые ни один режим не одобряет автоматически](/docs/ru/permission-modes#actions-no-mode-auto-approves) и для `AskUserQuestion` и `ExitPlanMode`, которым нужна [`updatedInput`, связанная с ней](#allow-with-updatedinput). `"deny"` предотвращает вызов инструмента. `"ask"` подсказывает пользователю подтвердить. `"defer"` выходит корректно, чтобы инструмент можно было возобновить позже. [Правила отказа и запроса](/docs/ru/permissions#manage-permissions) все еще оцениваются независимо от того, что возвращает hook |

1943| `permissionDecisionReason` | Для `"allow"` и `"ask"`, показано пользователю, но не Claude. Для `"deny"`, показано Claude. Для `"defer"`, игнорируется |1943| `permissionDecisionReason` | Для `"allow"` и `"ask"`, показано пользователю, но не Claude. Для `"deny"`, показано Claude. Для `"defer"`, игнорируется |

1944| `updatedInput` | Изменяет параметры ввода инструмента перед выполнением. Заменяет весь объект ввода, поэтому включите неизмененные поля рядом с измененными. Claude Code оценивает правила разрешений и [auto-background eligibility](/docs/ru/tools-reference#background-commands) команды Bash против ввода, который возвращает ваш hook, а не ввода, который отправил Claude. Объедините с `"allow"` для автоматического одобрения или `"ask"` для показа измененного ввода пользователю. Для `"defer"`, игнорируется |1944| `updatedInput` | Изменяет параметры ввода инструмента перед выполнением. Заменяет весь объект ввода, поэтому включите неизменные поля рядом с измененными. Claude Code оценивает правила разрешения и [автоматическую фоновую приемлемость](/docs/ru/tools-reference#background-commands) команды Bash против ввода, который возвращает ваш hook, а не ввода, который отправил Claude. Объедините с `"allow"` для автоматического одобрения или с `"ask"` для показа измененного ввода пользователю. Для `"defer"`, игнорируется |

1945| `additionalContext` | Строка, добавленная в контекст Claude рядом с результатом инструмента. Игнорируется, когда `permissionDecision` имеет значение `"defer"`. См. [Add context for Claude](#add-context-for-claude) |1945| `additionalContext` | Строка, добавленная в контекст Claude рядом с результатом инструмента. Игнорируется, когда `permissionDecision` имеет значение `"defer"`. См. [Add context for Claude](#add-context-for-claude) |

1946 1946 

1947Когда несколько hooks PreToolUse возвращают разные решения, приоритет — `deny` > `defer` > `ask` > `allow`.1947Когда несколько hooks PreToolUse возвращают разные решения, приоритет — `deny` > `defer` > `ask` > `allow`.

1948 1948 

1949Hook, который блокирует выходом 2, маршрутизируется так же, как `"deny"`: Claude видит сообщение stderr как причину отказа.1949Hook, который блокирует выходом 2, маршрутизируется так же, как `"deny"`: Claude видит сообщение stderr как причину отказа.

1950 1950 

1951Когда hook возвращает `"ask"`, подсказка разрешения, отображаемая пользователю, включает метку, определяющую, откуда пришел hook: `[settings]` для hook из любого файла настроек или из frontmatter агента, `[plugin:<name>]` для hook plugin или `[skill]` для hook из frontmatter skill. Это помогает пользователям понять, какой источник конфигурации запрашивает подтверждение.1951Когда hook возвращает `"ask"`, подсказка разрешения, отображаемая пользователю, включает ярлык, определяющий, откуда пришел hook: `[settings]` для hook из любого файла параметров или из frontmatter агента, `[plugin:<name>]` для hook плагина или `[skill]` для hook из frontmatter skill. Это помогает пользователям понять, какой источник конфигурации запрашивает подтверждение.

1952 1952 

1953`"ask"` hook также принуждает подсказку разрешения в [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode): классификатор все еще может отказать вызов инструмента, но он не может одобрить вызов молча. До версии 2.1.211 классификатор мог одобрить команду Bash, выполняющуюся вне [sandbox](/docs/ru/sandboxing), без показа подсказки, которую запросил hook; классификатор все еще применял свои собственные правила безопасности к этой команде, и hook `"deny"` всегда соблюдался.1953`"ask"` hook также принуждает подсказку разрешения в [режиме auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode): классификатор все еще может отказать вызову инструмента, но не может одобрить вызов молча. До версии 2.1.211 классификатор мог одобрить команду Bash, выполняющуюся вне [sandbox](/docs/ru/sandboxing), без показа подсказки, которую запросил hook; классификатор все еще применял свои собственные правила безопасности к этой команде, и hook `"deny"` всегда соблюдался.

1954 1954 

1955```json theme={null}1955```json theme={null}

1956{1956{

1968 1968 

1969<span id="allow-with-updatedinput" />1969<span id="allow-with-updatedinput" />

1970 1970 

1971В [non-interactive mode](/docs/ru/headless) с флагом `-p`, Claude Code предлагает `AskUserQuestion` и `ExitPlanMode` только, когда запуск имеет [permission host](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs) для получения подсказки, такой как callback Agent SDK `canUseTool`. Эти инструменты требуют взаимодействия с пользователем. Возврат `permissionDecision: "allow"` вместе с `updatedInput` удовлетворяет это требование: hook читает ввод инструмента из stdin, собирает ответ через ваш собственный UI и возвращает его в `updatedInput`, чтобы инструмент выполнялся без подсказки. Возврат только `"allow"` недостаточен для этих инструментов. Для `AskUserQuestion`, повторите исходный массив `questions` и добавьте объект [`answers`](#askuserquestion), отображающий текст каждого вопроса на выбранный ответ.1971В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` Claude Code предлагает `AskUserQuestion` и `ExitPlanMode` только, когда запуск имеет [хост разрешений](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs) для получения подсказки, такой как callback `canUseTool` Agent SDK. Эти инструменты требуют взаимодействия с пользователем. Возврат `permissionDecision: "allow"` вместе с `updatedInput` удовлетворяет это требование: hook читает ввод инструмента из stdin, собирает ответ через ваш собственный UI и возвращает его в `updatedInput`, чтобы инструмент выполнялся без подсказки. Возврат только `"allow"` недостаточен для этих инструментов. Для `AskUserQuestion` повторите исходный массив `questions` и добавьте объект [`answers`](#askuserquestion), отображающий текст каждого вопроса на выбранный ответ.

1972 1972 

1973Начиная с версии 2.1.199, инструмент MCP, чей сервер отмечает его с помощью [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), более строг: hook не может пропустить его подсказку одобрения с `"allow"`, с `updatedInput` или без него, потому что Claude Code не может подтвердить, что hook собрал взаимодействие, которое требует инструмент.1973Начиная с версии 2.1.199, инструмент MCP, сервер которого отмечает его с помощью [`_meta["anthropic/requiresUserInteraction"]`](/docs/ru/mcp#require-approval-for-a-specific-tool), более строг: hook не может пропустить его подсказку одобрения с `"allow"`, с `updatedInput` или без него, потому что Claude Code не может подтвердить, что hook собрал взаимодействие, которое требует инструмент.

1974 1974 

1975<Note>1975<Note>

1976 PreToolUse ранее использовал поля `decision` и `reason` верхнего уровня, но они устарели для этого события. Используйте `hookSpecificOutput.permissionDecision` и `hookSpecificOutput.permissionDecisionReason` вместо этого. Устаревшие значения `"approve"` и `"block"` отображаются на `"allow"` и `"deny"` соответственно. Другие события, такие как PostToolUse и Stop, продолжают использовать `decision` и `reason` верхнего уровня как их текущий формат.1976 PreToolUse ранее использовал поля `decision` и `reason` верхнего уровня, но они устарели для этого события. Используйте вместо этого `hookSpecificOutput.permissionDecision` и `hookSpecificOutput.permissionDecisionReason`. Устаревшие значения `"approve"` и `"block"` отображаются на `"allow"` и `"deny"` соответственно. Другие события, такие как PostToolUse и Stop, продолжают использовать `decision` и `reason` верхнего уровня как их текущий формат.

1977</Note>1977</Note>

1978 1978 

1979<h4 id="defer-a-tool-call-for-later">1979<h4 id="defer-a-tool-call-for-later">

1980 Defer a tool call for later1980 Отложить вызов инструмента на потом

1981</h4>1981</h4>

1982 1982 

1983`"defer"` предназначен для интеграций, которые запускают `claude -p` как подпроцесс и читают его JSON вывод, такие как приложение Agent SDK или пользовательский UI, построенный на основе Claude Code. Это позволяет этому вызывающему процессу приостановить Claude при вызове инструмента, собрать ввод через его собственный интерфейс и возобновить с того же места. Claude Code соблюдает это значение только в [non-interactive mode](/docs/ru/headless) с флагом `-p`. В интерактивных сеансах он логирует предупреждение и игнорирует результат hook.1983`"defer"` предназначен для интеграций, которые запускают `claude -p` как подпроцесс и читают его JSON-вывод, такие как приложение Agent SDK или пользовательский UI, построенный на основе Claude Code. Это позволяет этому вызывающему процессу приостановить Claude при вызове инструмента, собрать ввод через его собственный интерфейс и возобновить, где он остановился. Claude Code соблюдает это значение только в [неинтерактивном режиме](/docs/ru/headless) с флагом `-p`. В интерактивных сеансах он логирует предупреждение и игнорирует результат hook.

1984 1984 

1985Типичный случай — инструмент `AskUserQuestion`: Claude хочет что-то спросить у пользователя, но нет терминала для ответа. Запуск `-p` предлагает `AskUserQuestion` только, когда он имеет [permission host](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs), такой как инструмент MCP, который вы передаете с `--permission-prompt-tool`, поэтому запустите запуск с одним. Круговой путь работает так:1985Инструмент `AskUserQuestion` — типичный случай: Claude хочет что-то спросить у пользователя, но нет терминала для ответа. Запуск `-p` предлагает `AskUserQuestion` только, когда он имеет [хост разрешений](/docs/ru/headless#turn-off-permission-prompts-in-unattended-runs), такой как инструмент MCP, который вы передаете с `--permission-prompt-tool`, поэтому начните запуск с одного. Круговой путь работает так:

1986 1986 

19871. Claude вызывает `AskUserQuestion`. Срабатывает hook `PreToolUse`.19871. Claude вызывает `AskUserQuestion`. Срабатывает hook `PreToolUse`.

19882. Hook возвращает `permissionDecision: "defer"`. Инструмент не выполняется. Процесс выходит с `stop_reason: "tool_deferred"` и сохраненным вызовом инструмента в транскрипте.19882. Hook возвращает `permissionDecision: "defer"`. Инструмент не выполняется. Процесс выходит с `stop_reason: "tool_deferred"` и отложенный вызов инструмента сохраняется в транскрипте.

19893. Вызывающий процесс читает `deferred_tool_use` из результата SDK, выводит вопрос в своем собственном UI и ждет ответа.19893. Вызывающий процесс читает `deferred_tool_use` из результата SDK, выводит вопрос в своем собственном UI и ждет ответа.

19904. Вызывающий процесс запускает `claude -p --resume <session-id>` с тем же permission host. Тот же вызов инструмента срабатывает `PreToolUse` снова.19904. Вызывающий процесс запускает `claude -p --resume <session-id>` с тем же хостом разрешений. Тот же вызов инструмента срабатывает `PreToolUse` снова.

19915. Hook возвращает `permissionDecision: "allow"` с ответом в `updatedInput`. Инструмент выполняется и Claude продолжает.19915. Hook возвращает `permissionDecision: "allow"` с ответом в `updatedInput`. Инструмент выполняется и Claude продолжает.

1992 1992 

1993Поле `deferred_tool_use` несет `id`, `name` и `input` инструмента. `input` — это параметры, которые Claude сгенерировал для вызова инструмента, захваченные перед выполнением:1993Поле `deferred_tool_use` несет `id`, `name` и `input` инструмента. `input` — это параметры, которые Claude сгенерировал для вызова инструмента, захваченные перед выполнением:

2006}2006}

2007```2007```

2008 2008 

2009Нет timeout или лимита повторных попыток. Сеанс остается на диске до возобновления, подлежит [retention sweep rules](/docs/ru/claude-directory#cleaned-up-automatically) [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), которая удаляет файлы сеанса через 30 дней по умолчанию. Если ответ не готов при возобновлении, hook может вернуть `"defer"` снова и процесс выходит так же. Вызывающий процесс управляет тем, когда разорвать цикл, в конечном итоге возвращая `"allow"` или `"deny"` из hook.2009Нет тайм-аута или лимита повторных попыток. Сеанс остается на диске до возобновления, подлежит [правилам очистки](/docs/ru/claude-directory#cleaned-up-automatically) [retention sweep](/docs/ru/settings-reference#cleanupperioddays), которая удаляет файлы сеанса через 30 дней по умолчанию. Если ответ не готов при возобновлении, hook может вернуть `"defer"` снова и процесс выходит так же. Вызывающий процесс управляет тем, когда разорвать цикл, в конечном итоге возвращая `"allow"` или `"deny"` из hook.

2010 2010 

2011`"defer"` работает только, когда Claude делает один вызов инструмента в ходе. Если Claude делает несколько вызовов инструментов одновременно, `"defer"` игнорируется с предупреждением и инструмент проходит через нормальный поток разрешений. Ограничение существует, потому что возобновление может повторно запустить только один инструмент: нет способа отсрочить один вызов из партии без оставления других неразрешенными.2011`"defer"` работает только, когда Claude делает один вызов инструмента в ходе. Если Claude делает несколько вызовов инструментов одновременно, `"defer"` игнорируется с предупреждением и инструмент проходит через нормальный поток разрешений. Ограничение существует, потому что возобновление может повторно запустить только один инструмент: нет способа отложить один вызов из партии без оставления других неразрешенными.

2012 2012 

2013Если отсроченный инструмент больше не доступен при возобновлении, процесс выходит с `stop_reason: "tool_deferred_unavailable"` и `is_error: true` перед срабатыванием hook. Это происходит, когда сервер MCP, который предоставил инструмент, не подключен для возобновленного сеанса. Полезная нагрузка `deferred_tool_use` все еще включена, чтобы вы могли определить, какой инструмент исчез.2013Если отложенный инструмент больше не доступен при возобновлении, процесс выходит с `stop_reason: "tool_deferred_unavailable"` и `is_error: true` перед срабатыванием hook. Это происходит, когда сервер MCP, который предоставил инструмент, не подключен для возобновленного сеанса. Полезная нагрузка `deferred_tool_use` все еще включена, чтобы вы могли определить, какой инструмент исчез.

2014 2014 

2015<Note>2015<Note>

2016 Чтобы возобновить отсроченный сеанс в режиме плана, передайте [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) вместе с `--resume`, чтобы Claude Code мог представить план для одобрения. Без него Claude Code не восстанавливает режим плана. Требует Claude Code v2.1.246 или позже.2016 Чтобы возобновить отложенный сеанс в режиме плана, передайте [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) вместе с `--resume`, чтобы Claude Code мог представить план для одобрения. Без него Claude Code не восстанавливает режим плана. Требует Claude Code v2.1.246 или позже.

2017 2017 

2018 Когда вы возобновляете с `-p`, Claude Code не восстанавливает никакой другой сохраненный режим разрешений. Он запускает запуск в режиме разрешений, который новый запуск `claude -p` запустил бы, поэтому передайте `--permission-mode` или `--dangerously-skip-permissions` снова, если отсроченный сеанс использовал один. Когда вы возобновляете с `claude --resume <session-id>` без `-p`, Claude Code восстанавливает сохраненный режим разрешений, с исключениями, перечисленными в [permission mode on resume](/docs/ru/sessions#permission-mode-on-resume).2018 Когда вы возобновляете с `-p`, Claude Code не восстанавливает никакой другой сохраненный режим разрешений. Он запускает запуск в режиме разрешений, который новый запуск `claude -p` запустил бы, поэтому передайте `--permission-mode` или `--dangerously-skip-permissions` снова, если отложенный сеанс использовал один. Когда вы возобновляете с `claude --resume <session-id>` без `-p`, Claude Code восстанавливает сохраненный режим разрешений, с исключениями, перечисленными в [режим разрешений при возобновлении](/docs/ru/sessions#permission-mode-on-resume).

2019</Note>2019</Note>

2020 2020 

2021<h3 id="permissionrequest">2021<h3 id="permissionrequest">

2022 PermissionRequest2022 PermissionRequest

2023</h3>2023</h3>

2024 2024 

2025Запускается, когда Claude Code собирается попросить у вас разрешение на использование инструмента. В сеансах, которые не могут показать подсказку, такие как фоновые подагенты в [non-interactive mode](/docs/ru/headless), Claude Code все еще запускает эти hooks, и если ни один hook не возвращает решение, он отказывает вызову инструмента.2025Запускается, когда Claude Code собирается попросить вас разрешение на использование инструмента. В сеансах, которые не могут показать подсказку, такие как фоновые подагенты в [неинтерактивном режиме](/docs/ru/headless), Claude Code все еще запускает эти hooks, и если ни один hook не возвращает решение, он отказывает вызову инструмента.

2026Используйте [PermissionRequest decision control](#permissionrequest-decision-control) для разрешения или отказа от имени пользователя.2026Используйте [управление решением PermissionRequest](#permissionrequest-decision-control) для разрешения или отказа от имени пользователя.

2027 2027 

2028Используйте это событие, когда вам нужен сигнал в момент, когда Claude просит разрешение на использование инструмента. Claude Code запускает [Notification](#notification) hook с типом `permission_prompt` только после того, как подсказка ждала около шести секунд.2028Используйте это событие, когда вам нужен сигнал в момент, когда Claude просит разрешение на использование инструмента. Claude Code запускает hook [Notification](#notification) с типом `permission_prompt` только после того, как подсказка ждала около шести секунд.

2029 2029 

2030Claude Code не запускает hooks PermissionRequest для [network request](/docs/ru/sandboxing#network-isolation) изолированной команды. Чтобы получить сигнал для этой подсказки, используйте тип уведомления `permission_prompt`.2030Claude Code не запускает hooks PermissionRequest для [сетевого запроса](/docs/ru/sandboxing#network-isolation) изолированной команды. Чтобы получить сигнал для этой подсказки, используйте тип уведомления `permission_prompt`.

2031 2031 

2032Совпадает с именем инструмента, те же значения, что и PreToolUse.2032Совпадает с названием инструмента, те же значения, что и PreToolUse.

2033 2033 

2034<h4 id="permissionrequest-input">2034<h4 id="permissionrequest-input">

2035 PermissionRequest input2035 Ввод PermissionRequest

2036</h4>2036</h4>

2037 2037 

2038Hooks PermissionRequest получают поля `tool_name` и `tool_input`, как hooks PreToolUse, но без `tool_use_id`. Для инструмента MCP они также получают объект [`mcp_server`](#pretooluse-input). Опциональный массив `permission_suggestions` содержит [permission updates](#permission-update-entries), которые Claude Code предлагает для этого запроса, такие как добавление правила разрешения или изменение режима разрешений.2038Hooks PermissionRequest получают поля `tool_name` и `tool_input`, как hooks PreToolUse, но без `tool_use_id`. Для инструмента MCP они также получают объект [`mcp_server`](#pretooluse-input). Опциональный массив `permission_suggestions` содержит [обновления разрешений](#permission-update-entries), которые Claude Code предлагает для этого запроса, такие как добавление правила разрешения или изменение режима разрешений.

2039 2039 

2040Массив `permission_suggestions` не является точным списком опций, которые вы видите, потому что каждый диалог разрешений строит свои собственные опции. Некоторые диалоги, такие как для редактирования файлов, вообще не читают массив и получают свои опции из самого запроса. Диалог, который читает его, все еще может удержать опцию, чье предложение остается в массиве, например, когда [`allowManagedPermissionRulesOnly`](/docs/ru/settings-reference#allowmanagedpermissionrulesonly) скрывает опции сохранения правил. Он также может предложить опции, которые не имеют записи предложения, такие как [**Yes, and switch to auto mode**](/docs/ru/permission-modes#switch-permission-modes), которая изменяет режим разрешений напрямую, а не через обновление разрешений.2040Массив `permission_suggestions` не является точным списком опций, которые вы видите, потому что каждый диалог разрешений строит свои собственные опции. Некоторые диалоги, такие как диалог для редактирования файлов, вообще не читают массив и получают свои опции из самого запроса. Диалог, который читает его, все еще может скрыть опцию, чье предложение остается в массиве, например, когда [`allowManagedPermissionRulesOnly`](/docs/ru/settings-reference#allowmanagedpermissionrulesonly) скрывает опции сохранения правил. Он также может предложить опции, которые не имеют записи предложения, такие как [**Yes, and switch to auto mode**](/docs/ru/permission-modes#switch-permission-modes), которая изменяет режим разрешений напрямую, а не через обновление разрешений.

2041 2041 

2042Hooks PreToolUse запускаются перед каждым вызовом инструмента, независимо от того, нужно ли ему разрешение. Hooks PermissionRequest запускаются только, когда Claude Code собирается попросить у вас разрешение, или когда он в противном случае автоматически отказал бы вызову, который не может подсказать. Ни одно событие не срабатывает для [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior).2042Hooks PreToolUse запускаются перед каждым вызовом инструмента, независимо от того, нужно ли ему разрешение. Hooks PermissionRequest запускаются только, когда Claude Code собирается попросить вас разрешение, или когда он в противном случае автоматически отказал бы вызову, который не может подсказать. Ни одно событие не срабатывает для [`EndConversation`](/docs/ru/tools-reference#endconversation-tool-behavior).

2043 2043 

2044```json theme={null}2044```json theme={null}

2045{2045{

2065```2065```

2066 2066 

2067<h4 id="permissionrequest-decision-control">2067<h4 id="permissionrequest-decision-control">

2068 PermissionRequest decision control2068 Управление решением PermissionRequest

2069</h4>2069</h4>

2070 2070 

2071Hooks `PermissionRequest` могут разрешить или отказать запросы разрешений. Помимо [JSON output fields](#json-output), доступных всем hooks, ваш скрипт hook может вернуть объект `decision` с этими полями, специфичными для события:2071Hooks `PermissionRequest` могут разрешить или отказать запросы разрешений. Помимо [полей JSON-вывода](#json-output), доступных всем hooks, ваш скрипт hook может вернуть объект `decision` с этими полями, специфичными для события:

2072 2072 

2073| Field | Description |2073| Поле | Описание |

2074| :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |2074| :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

2075| `behavior` | `"allow"` предоставляет разрешение, `"deny"` отказывает в нем. [Deny and ask rules](/docs/ru/permissions#manage-permissions) все еще оцениваются, поэтому hook, возвращающий `"allow"`, не переопределяет соответствующее правило отказа |2075| `behavior` | `"allow"` предоставляет разрешение, `"deny"` отказывает его. [Правила отказа и запроса](/docs/ru/permissions#manage-permissions) все еще оцениваются, поэтому hook, возвращающий `"allow"`, не переопределяет соответствующее правило отказа |

2076| `updatedInput` | Для `"allow"` только: изменяет параметры ввода инструмента перед выполнением. Заменяет весь объект ввода, поэтому включите неизмененные поля рядом с измененными. Измененный ввод повторно оценивается против правил отказа и запроса |2076| `updatedInput` | Для `"allow"` только: изменяет параметры ввода инструмента перед выполнением. Заменяет весь объект ввода, поэтому включите неизменные поля рядом с измененными. Измененный ввод повторно оценивается против правил отказа и запроса |

2077| `updatedPermissions` | Для `"allow"` только: массив [permission update entries](#permission-update-entries) для применения, такой как добавление правила разрешения или изменение режима разрешений сеанса |2077| `updatedPermissions` | Для `"allow"` только: массив [записей обновления разрешений](#permission-update-entries) для применения, такие как добавление правила разрешения или изменение режима разрешений сеанса |

2078| `message` | Для `"deny"` только: говорит Claude, почему разрешение было отказано |2078| `message` | Для `"deny"` только: говорит Claude, почему разрешение было отказано |

2079| `interrupt` | Для `"deny"` только: если `true`, останавливает Claude |2079| `interrupt` | Для `"deny"` только: если `true`, останавливает Claude |

2080 2080 

2095```2095```

2096 2096 

2097<h4 id="permission-update-entries">2097<h4 id="permission-update-entries">

2098 Permission update entries2098 Записи обновления разрешений

2099</h4>2099</h4>

2100 2100 

2101Поле вывода `updatedPermissions` и поле ввода [`permission_suggestions`](#permissionrequest-input) оба используют один и тот же массив объектов записей. Каждая запись имеет `type`, который определяет ее другие поля, и `destination`, который управляет тем, где записывается изменение.2101Поле вывода `updatedPermissions` и поле ввода [`permission_suggestions`](#permissionrequest-input) оба используют один и тот же массив объектов записей. Каждая запись имеет `type`, который определяет ее другие поля, и `destination`, который управляет тем, где записывается изменение.

2102 2102 

2103| `type` | Fields | Effect |2103| `type` | Поля | Эффект |

2104| :------------------ | :--------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2104| :------------------ | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

2105| `addRules` | `rules`, `behavior`, `destination` | Добавляет правила разрешений. `rules` — это массив объектов `{toolName, ruleContent?}`. Опустите `ruleContent` для соответствия всему инструменту. `behavior` — это `"allow"`, `"deny"` или `"ask"` |2105| `addRules` | `rules`, `behavior`, `destination` | Добавляет правила разрешений. `rules` — это массив объектов `{toolName, ruleContent?}`. Опустите `ruleContent` для совпадения со всем инструментом. `behavior` — это `"allow"`, `"deny"` или `"ask"` |

2106| `replaceRules` | `rules`, `behavior`, `destination` | Заменяет все правила данного `behavior` в `destination` предоставленными `rules` |2106| `replaceRules` | `rules`, `behavior`, `destination` | Заменяет все правила данного `behavior` в `destination` предоставленными `rules` |

2107| `removeRules` | `rules`, `behavior`, `destination` | Удаляет соответствующие правила данного `behavior` |2107| `removeRules` | `rules`, `behavior`, `destination` | Удаляет соответствующие правила данного `behavior` |

2108| `setMode` | `mode`, `destination` | Изменяет режим разрешений. Допустимые режимы — `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` и `manual` как alias для `default`. Alias `manual` требует Claude Code v2.1.200 или позже |2108| `setMode` | `mode`, `destination` | Изменяет режим разрешений. Допустимые режимы — `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` и `manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже |

2109| `addDirectories` | `directories`, `destination` | Добавляет рабочие директории. `directories` — это массив строк пути |2109| `addDirectories` | `directories`, `destination` | Добавляет рабочие директории. `directories` — это массив строк путей |

2110| `removeDirectories` | `directories`, `destination` | Удаляет рабочие директории |2110| `removeDirectories` | `directories`, `destination` | Удаляет рабочие директории |

2111 2111 

2112<Note>2112<Note>

2113 `setMode` с `bypassPermissions` вступает в силу только, если вы запустили сеанс с режимом bypass, уже доступным: `--dangerously-skip-permissions`, `--permission-mode bypassPermissions`, `--allow-dangerously-skip-permissions` или `permissions.defaultMode: "bypassPermissions"` в [user, `--settings` или managed settings](/docs/ru/settings-reference#permissions-defaultmode). В противном случае обновление — это no-op. Обновление также является no-op, когда [`permissions.disableBypassPermissionsMode`](/docs/ru/permissions#managed-settings) отключает режим или когда сеанс запускается в [restricted mode](/docs/ru/cli-reference#cli-flags).2113 `setMode` с `bypassPermissions` вступает в силу только, если вы запустили сеанс с режимом обхода, уже доступным: `--dangerously-skip-permissions`, `--permission-mode bypassPermissions`, `--allow-dangerously-skip-permissions` или `permissions.defaultMode: "bypassPermissions"` в [пользовательских, `--settings` или управляемых параметрах](/docs/ru/settings-reference#permissions-defaultmode). В противном случае обновление — это no-op. Обновление также является no-op, когда [`permissions.disableBypassPermissionsMode`](/docs/ru/permissions#managed-settings) отключает режим или когда сеанс запускается в [restricted mode](/docs/ru/cli-reference#cli-flags).

2114 2114 

2115 `bypassPermissions` никогда не сохраняется как `defaultMode` независимо от `destination`.2115 `bypassPermissions` никогда не сохраняется как `defaultMode` независимо от `destination`.

2116</Note>2116</Note>

2117 2117 

2118Поле `destination` на каждой записи определяет, остается ли изменение в памяти или сохраняется в файл настроек.2118Поле `destination` на каждой записи определяет, остается ли изменение в памяти или сохраняется в файл параметров.

2119 2119 

2120| `destination` | Writes to |2120| `destination` | Записывает в |

2121| :---------------- | :--------------------------------------------------- |2121| :---------------- | :--------------------------------------------------- |

2122| `session` | только в памяти, отбрасывается при завершении сеанса |2122| `session` | только в памяти, отбрасывается при завершении сеанса |

2123| `localSettings` | `.claude/settings.local.json` |2123| `localSettings` | `.claude/settings.local.json` |

2124| `projectSettings` | `.claude/settings.json` |2124| `projectSettings` | `.claude/settings.json` |

2125| `userSettings` | `~/.claude/settings.json` |2125| `userSettings` | `~/.claude/settings.json` |

2126 2126 

2127Hook может повторить один из `permission_suggestions`, которые он получил, как свой собственный вывод `updatedPermissions`.2127Hook может повторить одно из `permission_suggestions`, которые он получил, как свой собственный вывод `updatedPermissions`.

2128 2128 

2129<h3 id="posttooluse">2129<h3 id="posttooluse">

2130 PostToolUse2130 PostToolUse

2132 2132 

2133Запускается сразу после успешного завершения инструмента.2133Запускается сразу после успешного завершения инструмента.

2134 2134 

2135Совпадает с именем инструмента, те же значения, что и PreToolUse.2135Совпадает с названием инструмента, те же значения, что и PreToolUse.

2136 2136 

2137Совпадайте более широко, когда имя инструмента не является правильным фильтром:2137Совпадайте более широко, когда название инструмента не является правильным фильтром:

2138 2138 

2139* Чтобы запустить hook после завершения любого инструмента успешно, опустите `matcher` или установите его на `"*"`. Ваш hook может затем обнаружить, что изменилось сам, например, запустив `git status --porcelain`, который также указывает неотслеживаемые файлы, которые `git diff` пропускает. Для вызовов инструментов, которые не удаются, добавьте тот же hook под [PostToolUseFailure](#posttoolusefailure).2139* Чтобы запустить hook после завершения любого инструмента успешно, опустите `matcher` или установите его на `"*"`. Ваш hook может затем обнаружить, что изменилось сам, например, запустив `git status --porcelain`, который также перечисляет неотслеживаемые файлы, которые `git diff` пропускает. Для вызовов инструментов, которые не удаются, добавьте тот же hook под [PostToolUseFailure](#posttoolusefailure).

2140* Чтобы запустить hook, когда определенный файл изменяется на диске, независимо от того, что его написало, используйте [FileChanged](#filechanged). Claude Code не запускает hook `PostToolUse`, соответствующий `Edit|Write`, когда команда `Bash` или процесс вне Claude Code переписывает тот же файл.2140* Чтобы запустить hook, когда определенный файл изменяется на диске, независимо от того, что его написало, используйте [FileChanged](#filechanged). Claude Code не запускает hook `PostToolUse`, соответствующий `Edit|Write`, когда команда `Bash` или процесс вне Claude Code переписывает тот же файл.

2141 2141 

2142<h4 id="posttooluse-input">2142<h4 id="posttooluse-input">

2143 PostToolUse input2143 Ввод PostToolUse

2144</h4>2144</h4>

2145 2145 

2146Hooks `PostToolUse` срабатывают после того, как инструмент уже выполнился успешно. Ввод включает как `tool_input`, аргументы, отправленные инструменту, так и `tool_response`, результат, который он вернул. Точная схема для обоих зависит от инструмента. Пути инструментов файлов `tool_input` приходят в том же формате, что и для [PreToolUse](#pretooluse-input): всегда абсолютные, с собственными разделителями платформы, поэтому обратные косые черты на Windows. Для инструмента MCP ввод также несет объект [`mcp_server`](#pretooluse-input).2146Hooks `PostToolUse` срабатывают после того, как инструмент уже выполнился успешно. Ввод включает как `tool_input`, аргументы, отправленные инструменту, так и `tool_response`, результат, который он вернул. Точная схема для обоих зависит от инструмента. Пути `tool_input` инструментов файлов прибывают в том же формате, что и для [PreToolUse](#pretooluse-input): всегда абсолютные, с собственными разделителями платформы, поэтому обратные косые черты на Windows. Для инструмента MCP ввод также несет объект [`mcp_server`](#pretooluse-input).

2147 2147 

2148```json theme={null}2148```json theme={null}

2149{2149{

2166}2166}

2167```2167```

2168 2168 

2169| Field | Description |2169| Поле | Описание |

2170| :------------ | :---------------------------------------------------------------------------------------------------------------------------------- |2170| :------------ | :---------------------------------------------------------------------------------------------------------------------------------- |

2171| `duration_ms` | Опциональный. Время выполнения инструмента в миллисекундах. Исключает время, потраченное на подсказки разрешений и hooks PreToolUse |2171| `duration_ms` | Опциональный. Время выполнения инструмента в миллисекундах. Исключает время, потраченное на подсказки разрешений и hooks PreToolUse |

2172 2172 

2173<h4 id="posttooluse-decision-control">2173<h4 id="posttooluse-decision-control">

2174 PostToolUse decision control2174 Управление решением PostToolUse

2175</h4>2175</h4>

2176 2176 

2177Hooks `PostToolUse` могут предоставить обратную связь Claude после выполнения инструмента. Помимо [JSON output fields](#json-output), доступных всем hooks, ваш скрипт hook может вернуть эти поля, специфичные для события:2177Hooks `PostToolUse` могут предоставить обратную связь Claude после выполнения инструмента. Помимо [полей JSON-вывода](#json-output), доступных всем hooks, ваш скрипт hook может вернуть эти поля, специфичные для события:

2178 2178 

2179| Field | Description |2179| Поле | Описание |

2180| :--------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2180| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

2181| `decision` | `"block"` добавляет `reason` рядом с результатом инструмента. Claude все еще видит исходный вывод; чтобы заменить его, используйте `updatedToolOutput` |2181| `decision` | `"block"` добавляет `reason` рядом с результатом инструмента. Claude все еще видит исходный вывод; чтобы заменить его, используйте `updatedToolOutput` |

2182| `reason` | Объяснение, показанное Claude, когда `decision` имеет значение `"block"` |2182| `reason` | Объяснение, показанное Claude, когда `decision` имеет значение `"block"` |

2183| `additionalContext` | Строка, добавленная в контекст Claude рядом с результатом инструмента. См. [Add context for Claude](#add-context-for-claude) |2183| `additionalContext` | Строка, добавленная в контекст Claude рядом с результатом инструмента. См. [Add context for Claude](#add-context-for-claude) |

2184| `classifierContext` | Краткая заметка об этом результате вызова для [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатора, а не для Claude. См. [Annotate a result for the auto mode classifier](#annotate-a-result-for-the-auto-mode-classifier). Требует Claude Code v2.1.236 или позже |2184| `classifierContext` | Краткая заметка об этом результате вызова для [классификатора режима auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), а не для Claude. См. [Annotate a result for the auto mode classifier](#annotate-a-result-for-the-auto-mode-classifier). Требует Claude Code v2.1.236 или позже |

2185| `updatedToolOutput` | Заменяет вывод инструмента предоставленным значением перед отправкой Claude. Значение должно совпадать с формой вывода инструмента |2185| `updatedToolOutput` | Заменяет вывод инструмента предоставленным значением перед отправкой Claude. Значение должно совпадать с формой вывода инструмента |

2186| `updatedMCPToolOutput` | Заменяет вывод для [MCP tools](#match-mcp-tools) только. Предпочитайте `updatedToolOutput`, который работает для всех инструментов |2186| `updatedMCPToolOutput` | Заменяет вывод для [инструментов MCP](#match-mcp-tools) только. Предпочитайте `updatedToolOutput`, который работает для всех инструментов |

2187 2187 

2188Пример ниже заменяет вывод вызова `Bash`. Значение замены совпадает с формой вывода инструмента `Bash`:2188Пример ниже заменяет вывод вызова `Bash`. Значение замены совпадает с формой вывода инструмента `Bash`:

2189 2189 

2203```2203```

2204 2204 

2205<Warning>2205<Warning>

2206 `updatedToolOutput` только изменяет то, что видит Claude. Инструмент уже выполнился к моменту срабатывания hook, поэтому любые написанные файлы, выполненные команды или отправленные сетевые запросы уже вступили в силу. Телеметрия, такая как spans инструментов OpenTelemetry и события аналитики, также захватывает исходный вывод перед выполнением hook. Чтобы предотвратить или изменить вызов инструмента перед его выполнением, используйте hook [PreToolUse](#pretooluse) вместо этого.2206 `updatedToolOutput` только изменяет то, что видит Claude. Инструмент уже выполнился к моменту срабатывания hook, поэтому любые написанные файлы, выполненные команды или отправленные сетевые запросы уже вступили в силу. Телеметрия, такая как spans инструментов OpenTelemetry и события аналитики, также захватывает исходный вывод перед выполнением hook. Чтобы предотвратить или изменить вызов инструмента перед его выполнением, используйте вместо этого hook [PreToolUse](#pretooluse).

2207 2207 

2208 Значение замены должно совпадать с формой вывода инструмента. Встроенные инструменты возвращают структурированные объекты, а не простые строки. Например, `Bash` возвращает объект с полями `stdout`, `stderr`, `interrupted` и `isImage`. Для встроенных инструментов значение, которое не совпадает со схемой вывода инструмента, игнорируется и используется исходный вывод. Вывод инструмента MCP передается без проверки схемы. Удаление деталей ошибок, которые нужны Claude, может привести к тому, что он продолжит с ложным предположением.2208 Значение замены должно совпадать с формой вывода инструмента. Встроенные инструменты возвращают структурированные объекты, а не простые строки. Например, `Bash` возвращает объект с полями `stdout`, `stderr`, `interrupted` и `isImage`. Для встроенных инструментов значение, которое не совпадает со схемой вывода инструмента, игнорируется и используется исходный вывод. Вывод инструмента MCP передается без проверки схемы. Удаление деталей ошибок, которые нужны Claude, может привести к тому, что он продолжит с ложным предположением.

2209</Warning>2209</Warning>

2210 2210 

2211<h4 id="annotate-a-result-for-the-auto-mode-classifier">2211<h4 id="annotate-a-result-for-the-auto-mode-classifier">

2212 Annotate a result for the auto mode classifier2212 Аннотирование результата для классификатора режима auto

2213</h4>2213</h4>

2214 2214 

2215Верните `classifierContext` для отправки краткой заметки об этом результате вызова инструмента [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) классификатору, а не Claude. Классификатор [никогда не получает результаты инструментов сами](/docs/ru/permission-modes#how-the-classifier-evaluates-actions), поэтому это поле — поддерживаемый способ сказать ему что-то о том, что вернул вызов, перед тем как он проверит более поздние действия. Поле требует Claude Code v2.1.236 или позже.2215Верните `classifierContext` для отправки краткой заметки об этом результате вызова инструмента [классификатору режима auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), а не Claude. Классификатор [никогда не получает сами результаты инструментов](/docs/ru/permission-modes#how-the-classifier-evaluates-actions), поэтому это поле — поддерживаемый способ рассказать ему что-то о том, что вернул вызов, перед тем как он проверит более поздние действия. Поле требует Claude Code v2.1.236 или позже.

2216 2216 

2217Пример ниже говорит классификатору, откуда пришел вывод запроса:2217Пример ниже говорит классификатору, откуда пришел вывод запроса:

2218 2218 

2227 2227 

2228Сколько веса классификатор дает заметке, зависит от того, где вы настроили hook:2228Сколько веса классификатор дает заметке, зависит от того, где вы настроили hook:

2229 2229 

2230* **Hooks, настроенные в Claude Code**: для hooks из файлов настроек, plugins, skills и frontmatter агента, классификатор рассматривает заметку как непроверенный, предоставленный приложением контекст. Заметка никогда не устанавливает намерение пользователя, и если она утверждает, что вы одобрили или запросили что-то, классификатор проверяет это утверждение против ваших собственных сообщений в разговоре2230* **Hooks, настроенные в Claude Code**: для hooks из файлов параметров, плагинов, skills и frontmatter агента классификатор рассматривает заметку как непроверенный, предоставленный приложением контекст. Заметка никогда не устанавливает намерение пользователя, и если она утверждает, что вы одобрили или запросили что-то, классификатор проверяет это утверждение против ваших собственных сообщений в разговоре

2231* **In-process Agent SDK callbacks**: когда приложение, встраивающее Claude Code, регистрирует hook как [TypeScript SDK callback](/docs/ru/agent-sdk/hooks) и возвращает заметку во время живого сеанса, классификатор может взвесить утверждение пользователя, переданное в заметке, как намерение пользователя. Такое утверждение может удовлетворить требование согласия, которое классификатор принял бы из сообщения, которое вы отправляете, но оно никогда не снимает блокировку, которую ваше собственное сообщение не могло бы снять. После возобновления сеанса Claude Code рассматривает восстановленные заметки как непроверенный контекст. Когда hooks из обеих групп аннотируют один и тот же вызов, классификатор рассматривает объединенную заметку как непроверенный контекст2231* **In-process callbacks Agent SDK**: когда приложение, встраивающее Claude Code, регистрирует hook как [callback TypeScript SDK](/docs/ru/agent-sdk/hooks) и возвращает заметку во время живого сеанса, классификатор может взвесить утверждение пользователя, переданное в заметке, как намерение пользователя. Такое утверждение может удовлетворить требование согласия, которое классификатор принял бы из сообщения, которое вы отправляете, но оно никогда не снимает блокировку, которую ваше собственное сообщение не могло бы снять. После возобновления сеанса Claude Code рассматривает восстановленные заметки как непроверенный контекст. Когда hooks из обеих групп аннотируют один и тот же вызов, классификатор рассматривает объединенную заметку как непроверенный контекст

2232 2232 

2233Claude Code применяет эти ограничения при доставке заметки:2233Claude Code применяет эти ограничения при доставке заметки:

2234 2234 

2235* **Длина**: Claude Code ограничивает заметки для одного вызова инструмента на 2000 символов и усекает остальное. Ограничение делится между каждым hook, который отвечает на этот вызов2235* **Длина**: Claude Code ограничивает заметки для одного вызова инструмента 2000 символами и усекает остальное. Ограничение делится между каждым hook, который отвечает на этот вызов

2236* **Только синхронные ответы**: Claude Code игнорирует поле в ответе hook, который [выполняется в фоне](#run-hooks-in-the-background), потому что этот ответ приходит после того, как Claude Code записывает результат инструмента2236* **Только синхронные ответы**: Claude Code игнорирует поле в ответе hook, который [выполняется в фоновом режиме](#run-hooks-in-the-background), потому что этот ответ прибывает после того, как Claude Code записывает результат инструмента

2237* **Вызовы, которые классификатор не записывает**: транскрипт классификатора опускает поиски только для чтения, такие как чтение файлов и поиски. Claude Code отбрасывает заметку, прикрепленную к одному из этих вызовов2237* **Вызовы, которые классификатор не записывает**: транскрипт классификатора опускает поиски только для чтения, такие как чтение файлов и поиски. Claude Code отбрасывает заметку, прикрепленную к одному из этих вызовов

2238* **Взаимодействие с переписыванием**: когда заметка описывает вывод, который вы заменяете с помощью `updatedToolOutput`, верните оба поля в одном ответе hook. Claude Code отбрасывает заметку, если это переписывание отклонено или переписывание другого hook заменяет его. Claude Code доставляет заметку, которую вы возвращаете без переписывания, даже когда другой hook переписывает вывод2238* **Взаимодействие с переписыванием**: когда заметка описывает вывод, который вы заменяете с помощью `updatedToolOutput`, верните оба поля в одном ответе hook. Claude Code отбрасывает заметку, если это переписывание отклонено или переписывание другого hook заменяет его. Claude Code доставляет заметку, которую вы возвращаете без переписывания, даже когда другой hook переписывает вывод

2239 2239 

2240<Warning>2240<Warning>

2241 Классификатор читает содержимое, которое вы помещаете в `classifierContext`, как информацию от приложения, размещающего сеанс, поэтому не копируйте ненадежный вывод инструмента или текст третьих сторон в него. Держите заметку к краткому утверждению об этом одном вызове, такому как факт о его происхождении или утверждение пользователя о нем; не используйте поле для доставки несвязанных сообщений или потока событий.2241 Классификатор читает содержимое, которое вы помещаете в `classifierContext`, как информацию от приложения, размещающего сеанс, поэтому не копируйте в него ненадежный вывод инструмента или текст третьих сторон. Держите заметку к краткому утверждению об этом одном вызове, такому как факт о его происхождении или утверждение пользователя о нем; не используйте поле для доставки несвязанных сообщений или потока событий.

2242</Warning>2242</Warning>

2243 2243 

2244<h3 id="posttoolusefailure">2244<h3 id="posttoolusefailure">

2247 2247 

2248Запускается, когда инструмент, который начал выполняться, не удается: инструмент выбросил ошибку или инструмент MCP вернул результат ошибки. Используйте это для логирования сбоев, отправки оповещений или предоставления исправляющей обратной связи Claude.2248Запускается, когда инструмент, который начал выполняться, не удается: инструмент выбросил ошибку или инструмент MCP вернул результат ошибки. Используйте это для логирования сбоев, отправки оповещений или предоставления исправляющей обратной связи Claude.

2249 2249 

2250Совпадает с именем инструмента, те же значения, что и PreToolUse.2250Совпадает с названием инструмента, те же значения, что и PreToolUse.

2251 2251 

2252<Note>2252<Note>

2253 Это событие не срабатывает для вызовов инструментов, отклоненных перед выполнением: неизвестное имя инструмента, ввод, который не проходит проверку схемы или инструмента, или отказ в разрешении. Отказы проверки возвращаются как результаты `tool_use_error` и происходят перед выполнением hooks, поэтому они не срабатывают ни `PreToolUse`, ни `PostToolUseFailure`. Отказы в разрешении срабатывают `PreToolUse`, но не это событие; см. [PermissionDenied](#permissiondenied).2253 Это событие не срабатывает для вызовов инструментов, отклоненных перед выполнением: неизвестное название инструмента, ввод, который не проходит проверку схемы или инструмента, или отказ в разрешении. Отказы в проверке возвращаются как результаты `tool_use_error` и происходят перед выполнением hooks, поэтому они не срабатывают ни `PreToolUse`, ни `PostToolUseFailure`. Отказы в разрешении срабатывают `PreToolUse`, но не это событие; см. [PermissionDenied](#permissiondenied).

2254</Note>2254</Note>

2255 2255 

2256<h4 id="posttoolusefailure-input">2256<h4 id="posttoolusefailure-input">

2257 PostToolUseFailure input2257 Ввод PostToolUseFailure

2258</h4>2258</h4>

2259 2259 

2260Hooks PostToolUseFailure получают те же поля `tool_name` и `tool_input`, что и PostToolUse, вместе с информацией об ошибке как полями верхнего уровня. Для инструмента MCP они также получают объект [`mcp_server`](#pretooluse-input). Например, неудачная команда `npm test` может доставить:2260Hooks PostToolUseFailure получают те же поля `tool_name` и `tool_input`, что и PostToolUse, вместе с информацией об ошибке как полями верхнего уровня. Для инструмента MCP они также получают объект [`mcp_server`](#pretooluse-input). Например, неудачная команда `npm test` может доставить:

2278}2278}

2279```2279```

2280 2280 

2281| Field | Description |2281| Поле | Описание |

2282| :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2282| :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

2283| `error` | Строка, описывающая, что пошло не так. Формат зависит от инструмента, который не удался |2283| `error` | Строка, описывающая, что пошло не так. Формат зависит от инструмента, который не удался |

2284| `is_interrupt` | Опциональный boolean. True, когда сбой достиг Claude Code как прерывание, а не как ошибка, которую сообщил инструмент. Отмена выполняющегося инструмента не срабатывает этот hook; результат инструмента несет сообщение прерывания вместо этого |2284| `is_interrupt` | Опциональное логическое значение. True, когда сбой достиг Claude Code как прерывание, а не как ошибка, которую сообщил инструмент. Отмена выполняющегося инструмента не срабатывает этот hook; результат инструмента несет сообщение прерывания вместо этого |

2285| `duration_ms` | Опциональный. Время выполнения инструмента в миллисекундах. Исключает время, потраченное на подсказки разрешений и hooks PreToolUse |2285| `duration_ms` | Опциональный. Время выполнения инструмента в миллисекундах. Исключает время, потраченное на подсказки разрешений и hooks PreToolUse |

2286 2286 

2287Строка `error` обычно является тем же текстом, который Claude получает как результат неудачного инструмента. Его формат варьируется по инструменту и сбою. Ключ вашего hook на `tool_name`, `is_interrupt` и первой строке `Exit code N`; рассматривайте остальную строку как текст отображения, а не стабильный формат.2287Строка `error` обычно является тем же текстом, который Claude получает как результат неудачного инструмента. Его формат варьируется в зависимости от инструмента и сбоя. Ключ вашего hook на `tool_name`, `is_interrupt` и первой строке `Exit code N`; рассматривайте остальную строку как текст отображения, а не стабильный формат.

2288 2288 

2289* Для Bash и PowerShell команда, которая выполнилась и вышла, создает первую строку `Exit code N`, затем любой вывод, который команда создала, как один блок с stdout и stderr перемешанными2289* Для Bash и PowerShell команда, которая выполнилась и вышла, создает первую строку `Exit code N`, затем любой вывод, который команда создала, как один блок с stdout и stderr перемешанными

2290* Полезная нагрузка также может нести сообщение об ошибке без строки кода выхода, когда Claude Code не мог запустить сам процесс shell2290* Полезная нагрузка также может нести сообщение об ошибке без строки кода выхода, когда Claude Code не мог запустить сам процесс оболочки

2291* Claude Code усекает длинные строки в середине вокруг маркера `... [N characters truncated] ...` и может вставлять свои собственные строки, такие как `Command timed out after 2m 0s`2291* Claude Code усекает длинные строки в середине вокруг маркера `... [N characters truncated] ...` и может вставлять свои собственные строки, такие как `Command timed out after 2m 0s`

2292 2292 

2293<h4 id="posttoolusefailure-decision-control">2293<h4 id="posttoolusefailure-decision-control">

2294 PostToolUseFailure decision control2294 Управление решением PostToolUseFailure

2295</h4>2295</h4>

2296 2296 

2297Hooks `PostToolUseFailure` могут предоставить контекст Claude после сбоя инструмента. Помимо [JSON output fields](#json-output), доступных всем hooks, ваш скрипт hook может вернуть эти поля, специфичные для события:2297Hooks `PostToolUseFailure` могут предоставить контекст Claude после сбоя инструмента. Помимо [полей JSON-вывода](#json-output), доступных всем hooks, ваш скрипт hook может вернуть эти поля, специфичные для события:

2298 2298 

2299| Field | Description |2299| Поле | Описание |

2300| :------------------ | :----------------------------------------------------------------------------------------------------------- |2300| :------------------ | :----------------------------------------------------------------------------------------------------------- |

2301| `additionalContext` | Строка, добавленная в контекст Claude рядом с ошибкой. См. [Add context for Claude](#add-context-for-claude) |2301| `additionalContext` | Строка, добавленная в контекст Claude рядом с ошибкой. См. [Add context for Claude](#add-context-for-claude) |

2302 2302 

2313 PostToolBatch2313 PostToolBatch

2314</h3>2314</h3>

2315 2315 

2316Запускается один раз после того, как каждый вызов инструмента в партии разрешится, перед отправкой Claude Code следующего запроса модели. `PostToolUse` срабатывает один раз на инструмент, что означает, что он срабатывает одновременно, когда Claude делает параллельные вызовы инструментов. `PostToolBatch` срабатывает ровно один раз со всей партией, поэтому это правильное место для внедрения контекста, который зависит от набора инструментов, которые выполнились, а не от любого одного инструмента. Нет matcher для этого события.2316Запускается один раз после того, как каждый вызов инструмента в партии разрешится, перед тем как Claude Code отправит следующий запрос модели. `PostToolUse` срабатывает один раз для каждого инструмента, что означает, что он срабатывает одновременно, когда Claude делает параллельные вызовы инструментов. `PostToolBatch` срабатывает ровно один раз со всей партией, поэтому это правильное место для внедрения контекста, который зависит от набора инструментов, которые выполнились, а не от любого одного инструмента. Нет matcher для этого события.

2317 2317 

2318<h4 id="posttoolbatch-input">2318<h4 id="posttoolbatch-input">

2319 PostToolBatch input2319 Ввод PostToolBatch

2320</h4>2320</h4>

2321 2321 

2322Помимо [common input fields](#common-input-fields), hooks PostToolBatch получают `tool_calls`, массив, описывающий каждый вызов инструмента в партии:2322Помимо [общих полей ввода](#common-input-fields), hooks PostToolBatch получают `tool_calls`, массив, описывающий каждый вызов инструмента в партии:

2323 2323 

2324```json theme={null}2324```json theme={null}

2325{2325{

2345}2345}

2346```2346```

2347 2347 

2348`tool_response` содержит то же содержимое, которое модель получает в соответствующем блоке `tool_result`. Значение — это сериализованная строка или массив блоков содержимого, ровно как инструмент выдал его. Для `Read` это означает текст с префиксом номера строки, а не исходное содержимое файла. Ответы могут быть большими, поэтому анализируйте только нужные вам поля.2348`tool_response` содержит то же содержимое, которое модель получает в соответствующем блоке `tool_result`. Значение — это сериализованная строка или массив блоков контента, ровно как инструмент выдал его. Для `Read` это означает текст с префиксом номера строки, а не необработанное содержимое файла. Ответы могут быть большими, поэтому анализируйте только нужные вам поля.

2349 2349 

2350<Note>2350<Note>

2351 Форма `tool_response` отличается от `PostToolUse`. `PostToolUse` передает структурированный объект `Output` инструмента, такой как `{filePath: "...", type: "create"}` для `Write`; `PostToolBatch` передает сериализованное содержимое `tool_result`, которое видит модель.2351 Форма `tool_response` отличается от `PostToolUse`. `PostToolUse` передает структурированный объект `Output` инструмента, такой как `{filePath: "...", type: "create"}` для `Write`; `PostToolBatch` передает сериализованное содержимое `tool_result`, которое видит модель.

2352</Note>2352</Note>

2353 2353 

2354<h4 id="posttoolbatch-decision-control">2354<h4 id="posttoolbatch-decision-control">

2355 PostToolBatch decision control2355 Управление решением PostToolBatch

2356</h4>2356</h4>

2357 2357 

2358Hooks `PostToolBatch` могут внедрить контекст для Claude. Помимо [JSON output fields](#json-output), доступных всем hooks, ваш скрипт hook может вернуть эти поля, специфичные для события:2358Hooks `PostToolBatch` могут внедрить контекст для Claude. Помимо [полей JSON-вывода](#json-output), доступных всем hooks, ваш скрипт hook может вернуть эти поля, специфичные для события:

2359 2359 

2360| Field | Description |2360| Поле | Описание |

2361| :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |2361| :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

2362| `additionalContext` | Строка контекста, внедренная один раз перед следующим вызовом модели. См. [Add context for Claude](#add-context-for-claude) для деталей доставки, что в нее поместить и как возобновленные сеансы обрабатывают прошлые значения |2362| `additionalContext` | Строка контекста, внедренная один раз перед следующим вызовом модели. См. [Add context for Claude](#add-context-for-claude) для деталей доставки, что в нее поместить и как возобновленные сеансы обрабатывают прошлые значения |

2363 2363 

2376 PermissionDenied2376 PermissionDenied

2377</h3>2377</h3>

2378 2378 

2379Запускается, когда [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) отказывает в вызове инструмента, включая когда он отказывает без вердикта классификатора, потому что [проверка безопасности, отдельная от auto mode, отказала в запросе классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) или его ответ не был проанализирован. Этот hook срабатывает только в режиме auto: он не запускается, когда вы вручную отказываете диалогу разрешений, когда hook `PreToolUse` блокирует вызов или когда совпадает правило `deny`. Используйте его для логирования отказов, корректировки конфигурации или сообщения модели, что она может повторить вызов инструмента.2379Запускается, когда [режим auto](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) отказывает вызову инструмента, включая когда он отказывает без вердикта классификатора, потому что [проверка безопасности, отдельная от режима auto, отказала в запросе классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) или его ответ не был проанализирован. Этот hook срабатывает только в режиме auto: он не запускается, когда вы вручную отказываете диалогу разрешений, когда hook `PreToolUse` блокирует вызов или когда совпадает правило `deny`. Используйте его для логирования отказов, настройки конфигурации или сообщения модели, что она может повторить попытку вызова инструмента.

2380 2380 

2381Совпадает с именем инструмента, те же значения, что и PreToolUse.2381Совпадает с названием инструмента, те же значения, что и PreToolUse.

2382 2382 

2383<h4 id="permissiondenied-input">2383<h4 id="permissiondenied-input">

2384 PermissionDenied input2384 Ввод PermissionDenied

2385</h4>2385</h4>

2386 2386 

2387Помимо [common input fields](#common-input-fields), hooks PermissionDenied получают `tool_name`, `tool_input`, `tool_use_id` и `reason`. Для инструмента MCP они также получают объект [`mcp_server`](#pretooluse-input).2387Помимо [общих полей ввода](#common-input-fields), hooks PermissionDenied получают `tool_name`, `tool_input`, `tool_use_id` и `reason`. Для инструмента MCP они также получают объект [`mcp_server`](#pretooluse-input).

2388 2388 

2389```json theme={null}2389```json theme={null}

2390{2390{

2403}2403}

2404```2404```

2405 2405 

2406| Field | Description |2406| Поле | Описание |

2407| :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2407| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

2408| `reason` | Причина отказа. Для вердикта классификатора в большинстве сеансов он называет совпадающее правило в квадратных скобках, такое как `[Data Exfiltration]`; см. [Review denials](/docs/ru/auto-mode-config#review-denials) для других форм. Для [no-verdict denial](#permissiondenied-decision-control) он начинается с `Auto mode could not evaluate this action and is blocking it for safety`. Для отказа, потому что модель классификатора была недоступна, это фиксированный текст `Classifier unavailable` |2408| `reason` | Причина отказа. Для вердикта классификатора в большинстве сеансов он называет совпадающее правило в квадратных скобках, такое как `[Data Exfiltration]`; см. [Review denials](/docs/ru/auto-mode-config#review-denials) для других форм. Для [отказа без вердикта](#permissiondenied-decision-control) он начинается с `Auto mode could not evaluate this action and is blocking it for safety`. Для отказа, потому что модель классификатора была недоступна, это фиксированный текст `Classifier unavailable` |

2409 2409 

2410<h4 id="permissiondenied-decision-control">2410<h4 id="permissiondenied-decision-control">

2411 PermissionDenied decision control2411 Управление решением PermissionDenied

2412</h4>2412</h4>

2413 2413 

2414Hooks PermissionDenied могут сказать модели, что она может повторить отклоненный вызов инструмента. Верните JSON объект с `hookSpecificOutput.retry`, установленным на `true`:2414Hooks PermissionDenied могут сказать модели, что она может повторить попытку отклоненного вызова инструмента. Верните объект JSON с `hookSpecificOutput.retry`, установленным на `true`:

2415 2415 

2416```json theme={null}2416```json theme={null}

2417{2417{

2422}2422}

2423```2423```

2424 2424 

2425Когда `retry` имеет значение `true`, Claude Code добавляет сообщение в разговор, говорящее модели, что она может повторить вызов инструмента. Claude Code не отменяет сам отказ. Если ваш hook не возвращает JSON или возвращает `retry: false`, отказ остается и модель получает исходное сообщение отказа.2425Когда `retry` имеет значение `true`, Claude Code добавляет сообщение в разговор, говорящее модели, что она может повторить попытку вызова инструмента. Claude Code не отменяет сам отказ. Если ваш hook не возвращает JSON или возвращает `retry: false`, отказ остается и модель получает исходное сообщение отказа.

2426 2426 

2427Claude Code игнорирует `retry: true`, когда классификатор создал [no verdict on the action](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action): его ответ не был проанализирован или проверка безопасности, отдельная от auto mode, отказала в запросе классификатора. Для этих отказов Claude Code уже говорит модели в сообщении отказа, повторить ли позже или продолжить.2427Claude Code игнорирует `retry: true`, когда классификатор создал [отсутствие вердикта на действие](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action): его ответ не был проанализирован или проверка безопасности, отдельная от режима auto, отказала в запросе классификатора. Для этих отказов Claude Code уже говорит модели в сообщении отказа, повторить ли попытку позже или продолжить.

2428 2428 

2429<h3 id="notification">2429<h3 id="notification">

2430 Notification2430 Notification

2432 2432 

2433Запускается, когда Claude Code отправляет уведомления. Совпадает с типом уведомления. Опустите matcher для запуска hooks для всех типов уведомлений.2433Запускается, когда Claude Code отправляет уведомления. Совпадает с типом уведомления. Опустите matcher для запуска hooks для всех типов уведомлений.

2434 2434 

2435Вы получаете эти события hook даже с отключенными уведомлениями рабочего стола: параметр `preferredNotifChannel`, включая `notifications_disabled`, изменяет только то, как вы получаете оповещение, а не срабатывает ли ваш hook.2435Вы получаете эти события hook даже с отключенными уведомлениями рабочего стола: параметр `preferredNotifChannel`, включая `notifications_disabled`, изменяет только то, как вас оповещают, а не запускается ли ваш hook.

2436 2436 

2437| Matcher | Когда срабатывает |2437| Matcher | Когда срабатывает |

2438| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2438| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

2439| `permission_prompt` | Claude нуждается в вашем разрешении на использование инструмента или [network request](/docs/ru/sandboxing#network-isolation) изолированной команды, и подсказка ждала около шести секунд |2439| `permission_prompt` | Claude нуждается в вашем разрешении на использование инструмента или [сетевого запроса](/docs/ru/sandboxing#network-isolation) изолированной команды, и подсказка ждала около шести секунд |

2440| `idle_prompt` | Claude закончил отвечать около 60 секунд назад и вы не печатали с тех пор |2440| `idle_prompt` | Claude закончил отвечать около 60 секунд назад и вы не печатали с тех пор |

2441| `auth_success` | Аутентификация завершена |2441| `auth_success` | Аутентификация завершена |

2442| `elicitation_dialog` | Сервер MCP открывает форму запроса и вы не печатали около шести секунд |2442| `elicitation_dialog` | Сервер MCP открывает форму запроса и вы не печатали около шести секунд |

2443| `elicitation_url_dialog` | Сервер MCP просит вас открыть URL браузера и вы не печатали около шести секунд |2443| `elicitation_url_dialog` | Сервер MCP просит вас открыть URL браузера и вы не печатали около шести секунд |

2444| `elicitation_complete` | Сервер MCP сообщает, что [URL-mode elicitation](#elicitation-input) завершена |2444| `elicitation_complete` | Сервер MCP сообщает, что [URL-режим запроса](#elicitation-input) завершен |

2445| `elicitation_response` | Ответ на запрос MCP отправляется обратно на сервер |2445| `elicitation_response` | Ответ запроса MCP отправляется обратно на сервер |

2446| `agent_needs_input` | Фоновый сеанс начинает ждать вашего ввода, пока [agent view](/docs/ru/agent-view) открыт в терминале, или текущий сеанс просит вас вопрос [agent team](/docs/ru/agent-teams) товарища по команде и вы не печатали около шести секунд |2446| `agent_needs_input` | Фоновый сеанс начинает ждать вашего ввода, пока [agent view](/docs/ru/agent-view) открыт в терминале, или текущий сеанс задает вам вопрос [настройки терминала товарища команды агентов](/docs/ru/agent-teams#choose-a-display-mode) и вы не печатали около шести секунд |

2447| `agent_completed` | Фоновый сеанс завершается или не удается. Срабатывает только, пока [agent view](/docs/ru/agent-view) открыт в терминале |2447| `agent_completed` | Фоновый сеанс завершается или не удается. Срабатывает только, пока [agent view](/docs/ru/agent-view) открыт в терминале |

2448| `quota_auto_resume_fired` | Claude Code продолжает вашу задачу после того, как лимит использования claude.ai приостановил его: при сбросе или раньше, когда что-то, что вы делаете в Claude Code во время ожидания, такое как добавление кредитов использования, обновление вашего плана или переключение моделей, снова делает использование доступным |2448| `quota_auto_resume_fired` | Claude Code продолжает вашу задачу после того, как лимит использования claude.ai приостановил его: при сбросе или раньше, когда что-то, что вы делаете в Claude Code во время ожидания, такое как добавление кредитов использования, обновление вашего плана или переключение моделей, снова делает использование доступным, с [исключением параметра модели](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset) |

2449| `quota_auto_resume_stale` | Лимит использования claude.ai сбросился, пока ваш компьютер спал более чем около 30 минут. Claude Code ждет, пока вы нажмете `Enter` вместо продолжения. После более короткого сна он продолжает и срабатывает `quota_auto_resume_fired` вместо этого |2449| `quota_auto_resume_stale` | Лимит использования claude.ai сбросился, пока ваш компьютер спал более чем около 30 минут. Claude Code ждет, пока вы нажмете `Enter`, вместо продолжения. После более короткого сна он продолжает и срабатывает `quota_auto_resume_fired` вместо этого |

2450| `quota_auto_resume_disabled` | Claude Code заканчивает свое ожидание лимита использования claude.ai без продолжения вашей задачи: [`autoContinueAtUsageLimit`](/docs/ru/settings-reference#autocontinueatusagelimit) отключен или сброс переместился более чем на 24 часа во время ожидания, которое Claude Code запустил самостоятельно, продолженная задача продолжала попадать на лимит или продолжение было заблокировано перед достижением модели. Не срабатывает, когда вы нажимаете `Esc` или `Ctrl+C` или выбираете **Don't continue automatically** |2450| `quota_auto_resume_disabled` | Claude Code заканчивает свое ожидание лимита использования claude.ai без продолжения вашей задачи: [`autoContinueAtUsageLimit`](/docs/ru/settings-reference#autocontinueatusagelimit) отключен или сброс переместился более чем на 24 часа во время ожидания, которое Claude Code запустил самостоятельно, продолженная задача продолжала попадать на лимит или продолжение было заблокировано перед достижением модели. Не срабатывает, когда вы нажимаете `Esc` или `Ctrl+C` или выбираете **Don't continue automatically** |

2451 2451 

2452Типы `agent_needs_input` и `agent_completed` требуют Claude Code v2.1.198 или позже.2452Типы `agent_needs_input` и `agent_completed` требуют Claude Code v2.1.198 или позже.

2453 2453 

2454Типы `quota_auto_resume_fired`, `quota_auto_resume_stale` и `quota_auto_resume_disabled` требуют Claude Code v2.1.234 или позже.2454Типы `quota_auto_resume_fired`, `quota_auto_resume_stale` и `quota_auto_resume_disabled` требуют Claude Code v2.1.234 или позже.

2455 2455 

2456В сеансах терминала, `permission_prompt` для [network request](/docs/ru/sandboxing#network-isolation) изолированной команды требует Claude Code v2.1.246 или позже.2456В сеансах терминала `permission_prompt` для [сетевого запроса](/docs/ru/sandboxing#network-isolation) изолированной команды требует Claude Code v2.1.246 или позже.

2457 2457 

2458`agent_needs_input` для вопроса настройки терминала товарища по команде требует Claude Code v2.1.248 или позже.2458`agent_needs_input` для вопроса настройки терминала товарища требует Claude Code v2.1.248 или позже.

2459 2459 

2460<Note>2460<Note>

2461 Типы `permission_prompt`, `idle_prompt`, `elicitation_dialog` и `elicitation_url_dialog` делят свое время с уведомлениями рабочего стола, поэтому в сеансах терминала вы видите их только, когда вы кажетесь отсутствующим от терминала:2461 Типы `permission_prompt`, `idle_prompt`, `elicitation_dialog` и `elicitation_url_dialog` делят свое время с уведомлениями рабочего стола, поэтому в сеансах терминала вы видите их только, когда вы кажетесь отсутствующим от терминала:

2462 2462 

2463 * Ожидайте `permission_prompt` один раз, когда вы не печатали около шести секунд. Таймер начинается, когда появляется подсказка разрешения, и каждый нажатие клавиши откладывает его. Чтобы запустить hook немедленно, когда Claude просит разрешение на использование инструмента, используйте [PermissionRequest](#permissionrequest) вместо этого.2463 * Ожидайте `permission_prompt` один раз, когда вы не печатали около шести секунд. Таймер начинается, когда появляется подсказка разрешения, и каждый нажатие клавиши откладывает его. Чтобы запустить hook немедленно, когда Claude просит разрешение на использование инструмента, используйте вместо этого [PermissionRequest](#permissionrequest).

2464 * Ожидайте `idle_prompt` около 60 секунд после того, как Claude закончит отвечать, и только если вы не печатали с тех пор. Claude Code не отправляет `idle_prompt`, пока ждет сброса лимита использования claude.ai. Когда ожидание заканчивается самостоятельно, один из типов `quota_auto_resume_*` срабатывает вместо этого.2464 * Ожидайте `idle_prompt` около 60 секунд после того, как Claude закончит отвечать, и только если вы не печатали с тех пор. Claude Code не отправляет `idle_prompt`, пока ждет сброса лимита использования claude.ai. Когда ожидание заканчивается самостоятельно, один из типов `quota_auto_resume_*` срабатывает вместо этого.

2465 * Ожидайте `elicitation_dialog` для формы запроса или `elicitation_url_dialog` для запроса URL браузера один раз, когда вы не печатали около шести секунд. Оба делят один и тот же шестисекундный шлюз как `permission_prompt`: таймер начинается, когда появляется диалог, и каждый нажатие клавиши откладывает его.2465 * Ожидайте `elicitation_dialog` для формы запроса или `elicitation_url_dialog` для запроса URL браузера один раз, когда вы не печатали около шести секунд. Оба делят один и тот же шестисекундный шлюз как `permission_prompt`: таймер начинается, когда появляется диалог, и каждый нажатие клавиши откладывает его.

2466 2466 

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

2468</Note>2468</Note>

2469 2469 

2470Claude Code рассчитывает `permission_prompt` по-другому в сеансах, где он отправляет запросы разрешений на callback Agent SDK [`canUseTool`](/docs/ru/agent-sdk/user-input), что является тем, как Claude Desktop и расширение VS Code размещают Claude Code:2470Claude Code рассчитывает `permission_prompt` по-другому в сеансах, где он отправляет запросы разрешений на callback [`canUseTool`](/docs/ru/agent-sdk/user-input) Agent SDK, что является тем, как Claude Desktop и расширение VS Code размещают Claude Code:

2471 2471 

2472* Ожидайте `permission_prompt` около шести секунд после того, как Claude просит разрешение. Claude Code не откладывает его, пока вы печатаете.2472* Ожидайте `permission_prompt` около шести секунд после того, как Claude просит разрешение. Claude Code не откладывает его, пока вы печатаете.

2473* Если вы или hook [PermissionRequest](#permissionrequest) ответите раньше, Claude Code не запускает `permission_prompt`.2473* Если вы или hook [PermissionRequest](#permissionrequest) ответите раньше, Claude Code не запускает `permission_prompt`.

2474* Установите [`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`](/docs/ru/env-vars) на `1` для отключения `permission_prompt` в этих сеансах.2474* Установите [`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`](/docs/ru/env-vars) на `1`, чтобы отключить `permission_prompt` в этих сеансах.

2475 2475 

2476До версии 2.1.233, `permission_prompt` не срабатывал в этих сеансах.2476До версии 2.1.233 `permission_prompt` не срабатывал в этих сеансах.

2477 2477 

2478Используйте отдельные matchers для запуска разных обработчиков в зависимости от типа уведомления. Эта конфигурация запускает скрипт оповещения, специфичный для разрешения, когда Claude нуждается в одобрении разрешения, и другое уведомление, когда Claude был неактивен:2478Используйте отдельные matchers для запуска разных обработчиков в зависимости от типа уведомления. Эта конфигурация запускает скрипт оповещения, специфичный для разрешения, когда Claude нуждается в одобрении разрешения, и другое уведомление, когда Claude был неактивен:

2479 2479 

2505```2505```

2506 2506 

2507<h4 id="notification-input">2507<h4 id="notification-input">

2508 Notification input2508 Ввод Notification

2509</h4>2509</h4>

2510 2510 

2511Помимо [common input fields](#common-input-fields), hooks Notification получают `message` с текстом уведомления, опциональный `title` и `notification_type`, указывающий, какой тип срабатывает.2511Помимо [общих полей ввода](#common-input-fields), hooks Notification получают `message` с текстом уведомления, опциональный `title` и `notification_type`, указывающий, какой тип срабатывает.

2512 2512 

2513```json theme={null}2513```json theme={null}

2514{2514{

2522}2522}

2523```2523```

2524 2524 

2525Hooks Notification не могут блокировать или изменять уведомления. Claude Code отбрасывает их поля `systemMessage` и `continue`, но все еще выдает [`terminalSequence`](#emit-terminal-notifications), на которое полагается пример уведомления рабочего стола. Hooks Notification предназначены для побочных эффектов, таких как пересылка уведомления во внешний сервис.2525Hooks Notification не могут блокировать или изменять уведомления. Claude Code отбрасывает их поля `systemMessage` и `continue`, но все еще выдает [`terminalSequence`](#emit-terminal-notifications), на которую полагается пример уведомления рабочего стола. Hooks Notification предназначены для побочных эффектов, таких как пересылка уведомления на внешний сервис.

2526 2526 

2527<h3 id="subagentstart">2527<h3 id="subagentstart">

2528 SubagentStart2528 SubagentStart

2529</h3>2529</h3>

2530 2530 

2531Запускается, когда Claude порождает подагента с инструментом Agent, когда Claude [возобновляет подагента](/docs/ru/sub-agents#resume-subagents) и каждый раз, когда товарищ по команде [agent team](/docs/ru/agent-teams) в процессе обрабатывает новое сообщение. Поддерживает matchers для фильтрации по имени типа агента. Для встроенных агентов это имя агента, такое как `general-purpose`, `Explore` или `Plan`. Для [custom subagents](/docs/ru/sub-agents), это поле `name` из frontmatter агента, а не имя файла.2531Запускается, когда Claude порождает подагента с инструментом Agent, когда Claude [возобновляет подагента](/docs/ru/sub-agents#resume-subagents) и каждый раз, когда товарищ [команды агентов](/docs/ru/agent-teams) в процессе обрабатывает новое сообщение. Поддерживает matchers для фильтрации по названию типа агента. Для встроенных агентов это имя агента, такое как `general-purpose`, `Explore` или `Plan`. Для [пользовательских подагентов](/docs/ru/sub-agents) это поле `name` из frontmatter агента, а не имя файла.

2532 2532 

2533Для подагентов, поставляемых [plugin](/docs/ru/plugins), тип агента — это идентификатор с областью действия plugin, такой как `my-plugin:reviewer`, а не голое имя frontmatter. Двоеточие помещает имя с областью действия plugin на путь регулярного выражения, поэтому якорьте matcher с `^` и `$` для точного совпадения: `^my-plugin:reviewer$`.2533Для подагентов, поставляемых [плагином](/docs/ru/plugins), тип агента — это идентификатор с областью плагина, такой как `my-plugin:reviewer`, а не голое имя frontmatter. Двое точка помещает имя с областью плагина на путь регулярного выражения, поэтому якорьте matcher с `^` и `$` для точного совпадения: `^my-plugin:reviewer$`.

2534 2534 

2535<h4 id="subagentstart-input">2535<h4 id="subagentstart-input">

2536 SubagentStart input2536 Ввод SubagentStart

2537</h4>2537</h4>

2538 2538 

2539Помимо [common input fields](#common-input-fields), hooks SubagentStart получают `agent_id` с уникальным идентификатором для подагента и `agent_type` с именем агента, который matcher фильтрует.2539Помимо [общих полей ввода](#common-input-fields), hooks SubagentStart получают `agent_id` с уникальным идентификатором подагента и `agent_type` с названием агента, который matcher фильтрует.

2540 2540 

2541```json theme={null}2541```json theme={null}

2542{2542{

2549}2549}

2550```2550```

2551 2551 

2552Hooks SubagentStart не могут блокировать создание подагента, но они могут внедрить контекст в подагента. Помимо [JSON output fields](#json-output), доступных всем hooks, вы можете вернуть:2552Hooks SubagentStart не могут блокировать создание подагента, но они могут внедрить контекст в подагента. Помимо [полей JSON-вывода](#json-output), доступных всем hooks, вы можете вернуть:

2553 2553 

2554| Field | Description |2554| Поле | Описание |

2555| :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------- |2555| :------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------- |

2556| `additionalContext` | Строка, добавленная в контекст подагента в начале его разговора, перед его первой подсказкой. См. [Add context for Claude](#add-context-for-claude) |2556| `additionalContext` | Строка, добавленная в контекст подагента в начале его разговора, перед его первой подсказкой. См. [Add context for Claude](#add-context-for-claude) |

2557 2557 

2564}2564}

2565```2565```

2566 2566 

2567Когда hook запускается снова для того же подагента, Claude Code внедряет возвращенный контекст только, когда контекст подагента уже не содержит копию из более раннего запуска. Копия, внедренная при запуске, остается на месте, оставляя [prompt cache](/docs/ru/prompt-caching#subagents-and-the-cache) подагента нетронутым. После [auto-compaction](/docs/ru/sub-agents#auto-compaction) отбрасывает эту копию, Claude Code внедряет контекст следующего запуска снова.2567Когда hook запускается снова для того же подагента, Claude Code внедряет возвращенный контекст только, когда контекст подагента уже не содержит копию из более раннего запуска. Копия, внедренная при запуске, остается на месте, оставляя [кэш подсказок](/docs/ru/prompt-caching#subagents-and-the-cache) подагента нетронутым. После [автоматического сжатия](/docs/ru/sub-agents#auto-compaction) отбрасывает эту копию, Claude Code внедряет контекст следующего запуска снова.

2568 2568 

2569<h3 id="subagentstop">2569<h3 id="subagentstop">

2570 SubagentStop2570 SubagentStop

2573Запускается, когда подагент Claude Code закончил отвечать. Совпадает с типом агента, те же значения, что и SubagentStart.2573Запускается, когда подагент Claude Code закончил отвечать. Совпадает с типом агента, те же значения, что и SubagentStart.

2574 2574 

2575<h4 id="subagentstop-input">2575<h4 id="subagentstop-input">

2576 SubagentStop input2576 Ввод SubagentStop

2577</h4>2577</h4>

2578 2578 

2579Помимо [common input fields](#common-input-fields), hooks SubagentStop получают `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path` и `last_assistant_message`. Поле `agent_type` — это значение, используемое для фильтрации matcher. `transcript_path` — это транскрипт основного сеанса, в то время как `agent_transcript_path` — это собственный транскрипт подагента, хранящийся в вложенной папке `subagents/`. Поле `last_assistant_message` содержит текстовое содержимое финального ответа подагента, поэтому hooks могут получить доступ к нему без анализа файла транскрипта.2579Помимо [общих полей ввода](#common-input-fields), hooks SubagentStop получают `stop_hook_active`, `agent_id`, `agent_type`, `agent_transcript_path` и `last_assistant_message`. Поле `agent_type` — это значение, используемое для фильтрации matcher. `transcript_path` — это транскрипт основного сеанса, пока `agent_transcript_path` — это собственный транскрипт подагента, хранящийся в вложенной папке `subagents/`. Поле `last_assistant_message` содержит текстовое содержимое финального ответа подагента, поэтому hooks могут получить доступ к нему без анализа файла транскрипта.

2580 2580 

2581На Claude Code v2.1.271 или позже подагент, который выполняется с инструментом [`SubagentHandback`](/docs/ru/tools-reference), доставляет свой отчет через этот инструмент перед остановкой. Поле `last_assistant_message` затем содержит закрывающий текст подагента, если есть, который не является доставленным отчетом. Отчет — это ввод `message` этого вызова, который hook `PreToolUse` или `PostToolUse`, совпадающий на `SubagentHandback`, получает как `tool_input.message`.2581Не каждое событие SubagentStop поступает от подагента, который Claude порождает. Claude Code также запускает внутренних агентов для некоторых своих собственных функций, таких как [предложения подсказок](/docs/ru/interactive-mode#prompt-suggestions) и [`/btw` побочные вопросы](/docs/ru/interactive-mode#side-questions-with-%2Fbtw), и SubagentStop срабатывает, когда один из них завершается. Для этих событий `agent_type` — это имя агента, который запускает сам сеанс, такой как один, установленный с [`--agent`](/docs/ru/cli-reference#cli-flags) или параметром [`agent`](/docs/ru/settings-reference#agent), и пустая строка, когда сеанс запускается без одного.

2582 

2583`matcher`, который называет типы агентов, не совпадает с пустым `agent_type`. Hook, чей matcher опущен, `""` или `"*"`, или является регулярным выражением, которое совпадает с пустой строкой, запускается для событий с пустым `agent_type` тоже.

2584 

2585На Claude Code v2.1.271 или позже подагент, который выполняется с инструментом [`SubagentHandback`](/docs/ru/tools-reference), доставляет свой отчет через этот инструмент перед остановкой. Поле `last_assistant_message` затем содержит закрывающий текст подагента, если он есть, который не является доставленным отчетом. Отчет — это ввод `message` этого вызова, который hook `PreToolUse` или `PostToolUse`, соответствующий `SubagentHandback`, получает как `tool_input.message`.

2582 2586 

2583Hooks SubagentStop также получают массивы `background_tasks` и `session_crons`, описанные в [Stop input](#stop-input). Оба массива ограничены родительским сеансом, а не подагентом.2587Hooks SubagentStop также получают массивы `background_tasks` и `session_crons`, описанные в [Stop input](#stop-input). Оба массива ограничены родительским сеансом, а не подагентом.

2584 2588 

2599}2603}

2600```2604```

2601 2605 

2602Hooks SubagentStop используют тот же формат управления решением, что и [Stop hooks](#stop-decision-control), включая `hookSpecificOutput.additionalContext` с `hookEventName`, установленным на `"SubagentStop"`, для обратной связи без ошибок, которая держит подагента работающим. Возврат `decision: "block"` с `reason` держит подагента работающим и доставляет `reason` подагенту как его следующую инструкцию. Hook, который блокирует выходом 2, доставляет его сообщение stderr так же. Чтобы внедрить контекст в родительский сеанс после возврата подагента, используйте hook [`PostToolUse`](#posttooluse) на инструменте `Agent` вместо этого.2606Hooks SubagentStop используют тот же формат управления решением, что и [hooks Stop](#stop-decision-control), включая `hookSpecificOutput.additionalContext` с `hookEventName`, установленным на `"SubagentStop"`, для обратной связи без ошибок, которая держит подагента работающим. Возврат `decision: "block"` с `reason` держит подагента работающим и доставляет `reason` подагенту как его следующую инструкцию. Hook, который блокирует выходом 2, доставляет его сообщение stderr так же. Чтобы внедрить контекст в родительский сеанс после возврата подагента, используйте вместо этого hook [`PostToolUse`](#posttooluse) на инструменте `Agent`.

2603 2607 

2604<h3 id="taskcreated">2608<h3 id="taskcreated">

2605 TaskCreated2609 TaskCreated

2606</h3>2610</h3>

2607 2611 

2608Запускается, когда задача создается через инструмент `TaskCreate`. Используйте это для применения соглашений об именовании, требования описаний задач или предотвращения создания определенных задач. В [сеансе без инструментов Task](/docs/ru/tools-reference#task-tool-availability), это событие не срабатывает.2612Запускается, когда задача создается через инструмент `TaskCreate`. Используйте это для применения соглашений об именовании, требования описаний задач или предотвращения создания определенных задач. В [сеансе без инструментов Task](/docs/ru/tools-reference#task-tool-availability) это событие не срабатывает.

2609 2613 

2610Hooks TaskCreated не поддерживают matchers и срабатывают при каждом возникновении.2614Hooks TaskCreated не поддерживают matchers и срабатывают при каждом возникновении.

2611 2615 

2612<h4 id="taskcreated-input">2616<h4 id="taskcreated-input">

2613 TaskCreated input2617 Ввод TaskCreated

2614</h4>2618</h4>

2615 2619 

2616Помимо [common input fields](#common-input-fields), hooks TaskCreated получают `task_id`, `task_subject` и опционально `task_description`, `teammate_name` и `team_name`.2620Помимо [общих полей ввода](#common-input-fields), hooks TaskCreated получают `task_id`, `task_subject` и опционально `task_description`, `teammate_name` и `team_name`.

2617 2621 

2618```json theme={null}2622```json theme={null}

2619{2623{

2629}2633}

2630```2634```

2631 2635 

2632| Field | Description |2636| Поле | Описание |

2633| :----------------- | :--------------------------------------------------------------------------- |2637| :----------------- | :--------------------------------------------------------------------------- |

2634| `task_id` | Идентификатор создаваемой задачи |2638| `task_id` | Идентификатор создаваемой задачи |

2635| `task_subject` | Название задачи |2639| `task_subject` | Название задачи |

2636| `task_description` | Подробное описание задачи. Может быть отсутствующим |2640| `task_description` | Подробное описание задачи. Может отсутствовать |

2637| `teammate_name` | Имя товарища по команде, создающего задачу. Может быть отсутствующим |2641| `teammate_name` | Имя товарища, создающего задачу. Может отсутствовать |

2638| `team_name` | Устарело. Имя команды, полученное из сеанса; будет удалено в будущем выпуске |2642| `team_name` | Устарело. Имя команды, полученное из сеанса; будет удалено в будущем выпуске |

2639 2643 

2640<h4 id="taskcreated-decision-control">2644<h4 id="taskcreated-decision-control">

2641 TaskCreated decision control2645 Управление решением TaskCreated

2642</h4>2646</h4>

2643 2647 

2644Hook TaskCreated может заблокировать создание двумя способами. В любом случае Claude Code удаляет задачу и возвращает ваше сообщение Claude как ошибку инструмента. Claude Code игнорирует `continue: false` из этого события и Claude продолжает работать.2648Hook TaskCreated может заблокировать создание двумя способами. В любом случае Claude Code удаляет задачу и возвращает ваше сообщение Claude как ошибку инструмента. Claude Code игнорирует `continue: false` из этого события и Claude продолжает работать.

2645 2649 

2646* **Exit code 2**: Claude Code возвращает текст stderr как сообщение.2650* **Код выхода 2**: Claude Code возвращает текст stderr как сообщение.

2647* **JSON `{"decision": "block", "reason": "..."}`**: Claude Code возвращает `reason` как сообщение.2651* **JSON `{"decision": "block", "reason": "..."}`**: Claude Code возвращает `reason` как сообщение.

2648 2652 

2649Этот пример блокирует задачи, чьи названия не следуют требуемому формату:2653Этот пример блокирует задачи, чьи названия не следуют требуемому формату:

2665 TaskCompleted2669 TaskCompleted

2666</h3>2670</h3>

2667 2671 

2668Запускается, когда задача отмечается как завершенная. Это срабатывает в двух ситуациях: когда любой агент явно отмечает задачу как завершенную через инструмент TaskUpdate или когда товарищ по команде [agent team](/docs/ru/agent-teams) завершает свой ход с выполняющимися задачами. Используйте это для применения критериев завершения, таких как прохождение тестов или проверок lint, перед закрытием задачи.2672Запускается, когда задача отмечается как завершенная. Это срабатывает в двух ситуациях: когда любой агент явно отмечает задачу как завершенную через инструмент TaskUpdate или когда товарищ [команды агентов](/docs/ru/agent-teams) завершает свой ход с выполняющимися задачами. Используйте это для применения критериев завершения, таких как прохождение тестов или проверок lint, перед закрытием задачи.

2669 2673 

2670Hooks TaskCompleted не поддерживают matchers и срабатывают при каждом возникновении.2674Hooks TaskCompleted не поддерживают matchers и срабатывают при каждом возникновении.

2671 2675 

2672<h4 id="taskcompleted-input">2676<h4 id="taskcompleted-input">

2673 TaskCompleted input2677 Ввод TaskCompleted

2674</h4>2678</h4>

2675 2679 

2676Помимо [common input fields](#common-input-fields), hooks TaskCompleted получают `task_id`, `task_subject` и опционально `task_description`, `teammate_name` и `team_name`.2680Помимо [общих полей ввода](#common-input-fields), hooks TaskCompleted получают `task_id`, `task_subject` и опционально `task_description`, `teammate_name` и `team_name`.

2677 2681 

2678```json theme={null}2682```json theme={null}

2679{2683{

2690}2694}

2691```2695```

2692 2696 

2693| Field | Description |2697| Поле | Описание |

2694| :----------------- | :--------------------------------------------------------------------------- |2698| :----------------- | :--------------------------------------------------------------------------- |

2695| `task_id` | Идентификатор завершаемой задачи |2699| `task_id` | Идентификатор завершаемой задачи |

2696| `task_subject` | Название задачи |2700| `task_subject` | Название задачи |

2697| `task_description` | Подробное описание задачи. Может быть отсутствующим |2701| `task_description` | Подробное описание задачи. Может отсутствовать |

2698| `teammate_name` | Имя товарища по команде, завершающего задачу. Может быть отсутствующим |2702| `teammate_name` | Имя товарища, завершающего задачу. Может отсутствовать |

2699| `team_name` | Устарело. Имя команды, полученное из сеанса; будет удалено в будущем выпуске |2703| `team_name` | Устарело. Имя команды, полученное из сеанса; будет удалено в будущем выпуске |

2700 2704 

2701<h4 id="taskcompleted-decision-control">2705<h4 id="taskcompleted-decision-control">

2702 TaskCompleted decision control2706 Управление решением TaskCompleted

2703</h4>2707</h4>

2704 2708 

2705Hooks TaskCompleted поддерживают два способа управления завершением задачи:2709Hooks TaskCompleted поддерживают два способа управления завершением задачи:

2706 2710 

2707* **Exit code 2**: задача не отмечается как завершенная и сообщение stderr передается обратно модели как обратная связь.2711* **Код выхода 2**: задача не отмечается как завершенная и сообщение stderr передается обратно модели как обратная связь.

2708* **JSON `{"continue": false, "stopReason": "..."}`**: когда событие запустил товарищ по команде, завершающий свой ход, полностью останавливает товарища по команде, совпадая с поведением hook `Stop`. `stopReason` показывается пользователю. Когда событие запустил инструмент `TaskUpdate`, Claude Code игнорирует `continue: false`; выход 2 все еще блокирует завершение.2712* **JSON `{"continue": false, "stopReason": "..."}`**: когда товарищ, завершающий свой ход, запустил событие, полностью останавливает товарища, совпадая с поведением hook `Stop`. `stopReason` показывается пользователю. Когда инструмент `TaskUpdate` запустил событие, Claude Code игнорирует `continue: false`; код выхода 2 все еще блокирует завершение.

2709 2713 

2710Этот пример запускает тесты и блокирует завершение задачи, если они не проходят:2714Этот пример запускает тесты и блокирует завершение задачи, если они не пройдут:

2711 2715 

2712```bash theme={null}2716```bash theme={null}

2713#!/bin/bash2717#!/bin/bash

2727 Stop2731 Stop

2728</h3>2732</h3>

2729 2733 

2730Запускается, когда основной агент Claude Code закончил отвечать. Не запускается, если остановка произошла из-за прерывания пользователем. Ошибки API срабатывают [StopFailure](#stopfailure) вместо этого.2734Запускается, когда основной агент Claude Code закончил отвечать. Не запускается, если остановка произошла из-за прерывания пользователем. Ошибки API срабатывают вместо этого [StopFailure](#stopfailure).

2731 2735 

2732<Tip>2736<Tip>

2733 Команда [`/goal`](/docs/ru/goal) — это встроенный ярлык для hook Stop с областью действия сеанса на основе подсказки. Используйте его, когда вы хотите, чтобы Claude продолжал работать над условием без написания конфигурации hook.2737 Команда [`/goal`](/docs/ru/goal) — это встроенный ярлык для hook Stop с областью сеанса на основе подсказки. Используйте его, когда вы хотите, чтобы Claude продолжал работать над условием без написания конфигурации hook.

2734</Tip>2738</Tip>

2735 2739 

2736<h4 id="stop-input">2740<h4 id="stop-input">

2737 Stop input2741 Ввод Stop

2738</h4>2742</h4>

2739 2743 

2740Помимо [common input fields](#common-input-fields), hooks Stop получают `stop_hook_active`, `last_assistant_message`, `background_tasks` и `session_crons`. Поле `stop_hook_active` имеет значение `true`, когда Claude Code уже продолжает в результате hook stop. Проверьте это значение или обработайте транскрипт, чтобы избежать блокирования на условии, которое никогда не разрешится. Claude Code переопределяет hook и заканчивает ход после 8 последовательных блокировок.2744Помимо [общих полей ввода](#common-input-fields), hooks Stop получают `stop_hook_active`, `last_assistant_message`, `background_tasks` и `session_crons`. Поле `stop_hook_active` имеет значение `true`, когда Claude Code уже продолжает в результате hook stop. Проверьте это значение или обработайте транскрипт, чтобы избежать блокировки на условии, которое никогда не разрешится. Claude Code переопределяет hook и заканчивает ход после 8 последовательных блокировок.

2741 2745 

2742Поле `last_assistant_message` содержит текстовое содержимое финального ответа Claude, поэтому hooks могут получить доступ к нему без анализа файла транскрипта. Для hooks, которые действуют на только что завершенный ход, такие как hooks чтения вслух или уведомления, используйте это поле, а не читайте `transcript_path`: файл транскрипта не гарантируется включать финальное сообщение в момент Stop на всех версиях.2746Поле `last_assistant_message` содержит текстовое содержимое финального ответа Claude, поэтому hooks могут получить доступ к нему без анализа файла транскрипта. Для hooks, которые действуют на только что завершенный ход, такие как hooks чтения вслух или уведомления, используйте это поле, а не читайте `transcript_path`: файл транскрипта не гарантируется включать финальное сообщение во время Stop на всех версиях.

2743 2747 

2744Массивы `background_tasks` и `session_crons` позволяют hooks различать "сеанс завершен" от "сеанс приостановлен в ожидании фоновой работы для пробуждения его обратно". Оба массива присутствуют, когда реестр задач доступен и пусты, когда ничего не выполняется или не запланировано.2748Массивы `background_tasks` и `session_crons` позволяют hooks различать "сеанс завершен" от "сеанс приостановлен, ожидая фоновой работы для пробуждения его обратно". Оба массива присутствуют, когда реестр задач доступен и пусты, когда ничего не выполняется или не запланировано.

2745 2749 

2746Каждая запись в `background_tasks` описывает одну выполняющуюся задачу и использует эти поля:2750Каждая запись в `background_tasks` описывает одну выполняющуюся задачу и использует эти поля:

2747 2751 

2748| Field | Description |2752| Поле | Описание |

2749| :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2753| :------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

2750| `id` | Идентификатор задачи |2754| `id` | Идентификатор задачи |

2751| `type` | Дружественный label типа задачи, такой как `shell`, `subagent`, `monitor`, `workflow`, `teammate`, `cloud session` или `MCP task`. Каждый label определяет, какая функция Claude Code создала задачу. Возвращается к сырому дискриминанту для неизвестных типов |2755| `type` | Дружественный ярлык типа задачи, такой как `shell`, `subagent`, `monitor`, `workflow`, `teammate`, `cloud session` или `MCP task`. Каждый ярлык определяет, какая функция Claude Code создала задачу. Возвращается к необработанному дискриминанту для неизвестных типов |

2752| `status` | Текущий статус задачи |2756| `status` | Текущий статус задачи |

2753| `description` | Описание в свободной форме, ограниченное 1000 символами с маркером `… [+N chars]` в строке при обрезании |2757| `description` | Описание в свободной форме, ограниченное 1000 символами с маркером `… [+N chars]` в строке при обрезке |

2754| `command` | Командная строка shell, ограниченная 1000 символами. Присутствует только для задач `shell` |2758| `command` | Командная строка оболочки, ограниченная 1000 символами. Присутствует только для задач `shell` |

2755| `agent_type` | Имя типа подагента. Присутствует только для задач `subagent` |2759| `agent_type` | Имя типа подагента. Присутствует только для задач `subagent` |

2756| `server` | Имя сервера MCP. Присутствует только для задач `monitor` и `MCP task` |2760| `server` | Имя сервера MCP. Присутствует только для задач `monitor` и `MCP task` |

2757| `tool` | Имя инструмента MCP. Присутствует только для задач `monitor` и `MCP task` |2761| `tool` | Имя инструмента MCP. Присутствует только для задач `monitor` и `MCP task` |

2758| `name` | Имя workflow. Присутствует только для задач `workflow` |2762| `name` | Имя workflow. Присутствует только для задач `workflow` |

2759 2763 

2760Каждая запись в `session_crons` описывает одно запланированное пробуждение с областью действия сеанса, полученное из `CronCreate`, `ScheduleWakeup` и `/loop`:2764Каждая запись в `session_crons` описывает одно запланированное пробуждение с областью сеанса, полученное из `CronCreate`, `ScheduleWakeup` и `/loop`:

2761 2765 

2762| Field | Description |2766| Поле | Описание |

2763| :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |2767| :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |

2764| `id` | Идентификатор задачи Cron |2768| `id` | Идентификатор задачи Cron |

2765| `schedule` | Выражение Cron, например `0 9 * * 1-5` |2769| `schedule` | Выражение Cron, например `0 9 * * 1-5` |

2798```2802```

2799 2803 

2800<h4 id="stop-decision-control">2804<h4 id="stop-decision-control">

2801 Stop decision control2805 Управление решением Stop

2802</h4>2806</h4>

2803 2807 

2804Hooks `Stop` и `SubagentStop` могут управлять тем, продолжает ли Claude. Помимо [JSON output fields](#json-output), доступных всем hooks, ваш скрипт hook может вернуть эти поля, специфичные для события:2808Hooks `Stop` и `SubagentStop` могут управлять тем, продолжает ли Claude. Помимо [полей JSON-вывода](#json-output), доступных всем hooks, ваш скрипт hook может вернуть эти поля, специфичные для события:

2805 2809 

2806| Field | Description |2810| Поле | Описание |

2807| :------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2811| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

2808| `decision` | `"block"` предотвращает остановку Claude. Опустите, чтобы позволить Claude остановиться |2812| `decision` | `"block"` предотвращает остановку Claude. Опустите, чтобы позволить Claude остановиться |

2809| `reason` | Требуется, когда `decision` имеет значение `"block"`. Говорит Claude, почему он должен продолжить |2813| `reason` | Требуется, когда `decision` имеет значение `"block"`. Говорит Claude, почему он должен продолжить |

2810| `hookSpecificOutput.additionalContext` | Обратная связь без ошибок для Claude. Разговор продолжается, чтобы Claude мог действовать на нее, но в отличие от `decision: "block"`, она показана в транскрипте как обратная связь hook, а не ошибка hook |2814| `hookSpecificOutput.additionalContext` | Обратная связь без ошибок для Claude. Разговор продолжается, чтобы Claude мог действовать на ней, но в отличие от `decision: "block"` она показана в транскрипте как обратная связь hook, а не ошибка hook |

2811 2815 

2812Hook, который блокирует выходом 2, маршрутизируется так же, как `reason`: Claude получает сообщение stderr как объяснение того, почему он должен продолжить.2816Hook, который блокирует выходом 2, маршрутизируется так же, как `reason`: Claude получает сообщение stderr как объяснение того, почему он должен продолжить.

2813 2817 

2818}2822}

2819```2823```

2820 2824 

2821Используйте `additionalContext`, когда hook работает как задумано и дает Claude руководство, такое как "запустить набор тестов перед завершением". Это держит разговор идущим через те же защиты цикла, что и `decision: "block"`, а именно ввод `stop_hook_active` и ограничение 8 последовательных продолжений, но транскрипт помечает его как `Stop hook feedback` и никакое уведомление об ошибке hook не показывается:2825Используйте `additionalContext`, когда hook работает как задумано и дает Claude руководство, такое как "запустить набор тестов перед завершением". Это держит разговор идущим через те же защиты цикла, что и `decision: "block"`, а именно ввод `stop_hook_active` и ограничение 8-последовательного продолжения, но транскрипт помечает его `Stop hook feedback` и уведомление об ошибке hook не показывается:

2822 2826 

2823```json theme={null}2827```json theme={null}

2824{2828{

2836Запускается вместо [Stop](#stop), когда ход заканчивается из-за ошибки API. Claude Code игнорирует вывод и код выхода hook, кроме [`terminalSequence`](#emit-terminal-notifications). Используйте это для логирования сбоев, отправки оповещений или принятия действий восстановления, когда Claude не может завершить ответ из-за ограничений скорости, проблем аутентификации или других ошибок API.2840Запускается вместо [Stop](#stop), когда ход заканчивается из-за ошибки API. Claude Code игнорирует вывод и код выхода hook, кроме [`terminalSequence`](#emit-terminal-notifications). Используйте это для логирования сбоев, отправки оповещений или принятия действий восстановления, когда Claude не может завершить ответ из-за ограничений скорости, проблем аутентификации или других ошибок API.

2837 2841 

2838<h4 id="stopfailure-input">2842<h4 id="stopfailure-input">

2839 StopFailure input2843 Ввод StopFailure

2840</h4>2844</h4>

2841 2845 

2842Помимо [common input fields](#common-input-fields), hooks StopFailure получают `error`, опциональный `error_details` и опциональный `last_assistant_message`. Поле `error` определяет тип ошибки и используется для фильтрации matcher.2846Помимо [общих полей ввода](#common-input-fields), hooks StopFailure получают `error`, опциональный `error_details` и опциональный `last_assistant_message`. Поле `error` определяет тип ошибки и используется для фильтрации matcher.

2843 2847 

2844| Field | Description |2848| Поле | Описание |

2845| :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |2849| :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

2846| `error` | Тип ошибки: `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, `cloud_credential_error` или `unknown` |2850| `error` | Тип ошибки: `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, `cloud_credential_error` или `unknown` |

2847| `error_details` | Дополнительные детали об ошибке, когда доступны |2851| `error_details` | Дополнительные детали об ошибке, когда доступны |

2865 TeammateIdle2869 TeammateIdle

2866</h3>2870</h3>

2867 2871 

2868Запускается, когда товарищ по команде [agent team](/docs/ru/agent-teams) собирается перейти в режим ожидания после завершения своего хода. Используйте это для применения шлюзов качества перед остановкой товарища по команде, такие как требование прохождения проверок lint или проверка существования выходных файлов.2872Запускается, когда товарищ [команды агентов](/docs/ru/agent-teams) собирается перейти в режим ожидания после завершения своего хода. Используйте это для применения шлюзов качества перед остановкой товарища, такие как требование прохождения проверок lint или проверка существования выходных файлов.

2869 2873 

2870Hooks TeammateIdle не поддерживают matchers и срабатывают при каждом возникновении.2874Hooks TeammateIdle не поддерживают matchers и срабатывают при каждом возникновении.

2871 2875 

2872<h4 id="teammateidle-input">2876<h4 id="teammateidle-input">

2873 TeammateIdle input2877 Ввод TeammateIdle

2874</h4>2878</h4>

2875 2879 

2876Помимо [common input fields](#common-input-fields), hooks TeammateIdle получают `teammate_name` и `team_name`.2880Помимо [общих полей ввода](#common-input-fields), hooks TeammateIdle получают `teammate_name` и `team_name`.

2877 2881 

2878```json theme={null}2882```json theme={null}

2879{2883{

2887}2891}

2888```2892```

2889 2893 

2890| Field | Description |2894| Поле | Описание |

2891| :-------------- | :--------------------------------------------------------------------------- |2895| :-------------- | :--------------------------------------------------------------------------- |

2892| `teammate_name` | Имя товарища по команде, который собирается перейти в режим ожидания |2896| `teammate_name` | Имя товарища, который собирается перейти в режим ожидания |

2893| `team_name` | Устарело. Имя команды, полученное из сеанса; будет удалено в будущем выпуске |2897| `team_name` | Устарело. Имя команды, полученное из сеанса; будет удалено в будущем выпуске |

2894 2898 

2895<h4 id="teammateidle-decision-control">2899<h4 id="teammateidle-decision-control">

2896 TeammateIdle decision control2900 Управление решением TeammateIdle

2897</h4>2901</h4>

2898 2902 

2899Hooks TeammateIdle поддерживают два способа управления поведением товарища по команде:2903Hooks TeammateIdle поддерживают два способа управления поведением товарища:

2900 2904 

2901* **Exit code 2**: товарищ по команде получает сообщение stderr как обратную связь и продолжает работать вместо перехода в режим ожидания.2905* **Код выхода 2**: товарищ получает сообщение stderr как обратную связь и продолжает работать вместо перехода в режим ожидания.

2902* **JSON `{"continue": false, "stopReason": "..."}`**: полностью останавливает товарища по команде, совпадая с поведением hook `Stop`. `stopReason` показывается пользователю.2906* **JSON `{"continue": false, "stopReason": "..."}`**: полностью останавливает товарища, совпадая с поведением hook `Stop`. `stopReason` показывается пользователю.

2903 2907 

2904Этот пример проверяет, что артефакт сборки существует перед разрешением товарищу по команде перейти в режим ожидания:2908Этот пример проверяет, что артефакт сборки существует перед разрешением товарищу перейти в режим ожидания:

2905 2909 

2906```bash theme={null}2910```bash theme={null}

2907#!/bin/bash2911#!/bin/bash

2918 ConfigChange2922 ConfigChange

2919</h3>2923</h3>

2920 2924 

2921Запускается, когда файл конфигурации изменяется во время сеанса. Используйте это для аудита изменений настроек, применения политик безопасности или блокирования несанкционированных изменений файлов конфигурации.2925Запускается, когда файл конфигурации изменяется во время сеанса. Используйте это для аудита изменений параметров, применения политик безопасности или блокировки несанкционированных изменений файлов конфигурации.

2922 2926 

2923Claude Code запускает hooks ConfigChange, когда файл настроек, файл управляемой политики или файл skill изменяется. Для управляемой политики он запускает их только, когда `managed-settings.json` или файл в `managed-settings.d/` изменяется. Он применяет [server-managed settings](/docs/ru/server-managed-settings) и изменения в macOS управляемых предпочтениях или политике реестра Windows без запуска их. На WSL с [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings), он также применяет измененный файл управляемых настроек Windows на его опросе политики без запуска их.2927Claude Code запускает hooks ConfigChange, когда файл параметров, файл управляемой политики или файл skill изменяется. Для управляемой политики он запускает их только, когда `managed-settings.json` или файл в `managed-settings.d/` изменяется. Он применяет [параметры, управляемые сервером](/docs/ru/server-managed-settings) и изменения в macOS управляемых предпочтениях или политике реестра Windows без их запуска. На WSL с [`wslInheritsWindowsSettings`](/docs/ru/settings-reference#wslinheritswindowssettings) он также применяет измененный файл управляемых параметров Windows на его опросе политики без их запуска.

2924 2928 

2925Matcher фильтрует по источнику конфигурации:2929Matcher фильтрует по источнику конфигурации:

2926 2930 

2953```2957```

2954 2958 

2955<h4 id="configchange-input">2959<h4 id="configchange-input">

2956 ConfigChange input2960 Ввод ConfigChange

2957</h4>2961</h4>

2958 2962 

2959Помимо [common input fields](#common-input-fields), hooks ConfigChange получают `source` и опционально `file_path`. Поле `source` указывает, какой тип конфигурации изменился, и `file_path` предоставляет путь к конкретному файлу, который был изменен.2963Помимо [общих полей ввода](#common-input-fields), hooks ConfigChange получают `source` и опционально `file_path`. Поле `source` указывает, какой тип конфигурации изменился, и `file_path` предоставляет путь к конкретному файлу, который был изменен.

2960 2964 

2961```json theme={null}2965```json theme={null}

2962{2966{

2970```2974```

2971 2975 

2972<h4 id="configchange-decision-control">2976<h4 id="configchange-decision-control">

2973 ConfigChange decision control2977 Управление решением ConfigChange

2974</h4>2978</h4>

2975 2979 

2976Hooks ConfigChange могут заблокировать изменения конфигурации от вступления в силу. Используйте выход 2 или JSON `decision` для предотвращения изменения. При блокировании новые настройки не применяются к работающему сеансу.2980Hooks ConfigChange могут блокировать изменения конфигурации от вступления в силу. Используйте код выхода 2 или JSON `decision` для предотвращения изменения. При блокировке новые параметры не применяются к работающему сеансу.

2977 2981 

2978| Field | Description |2982| Поле | Описание |

2979| :--------- | :--------------------------------------------------------------------------------------------- |2983| :--------- | :--------------------------------------------------------------------------------------------- |

2980| `decision` | `"block"` предотвращает применение изменения конфигурации. Опустите, чтобы позволить изменению |2984| `decision` | `"block"` предотвращает применение изменения конфигурации. Опустите, чтобы позволить изменению |

2981| `reason` | Принято, но никогда не показано |2985| `reason` | Принято, но никогда не показано |

2987}2991}

2988```2992```

2989 2993 

2990Изменения `policy_settings` не могут быть заблокированы. Hooks все еще срабатывают для источников `policy_settings`, когда файл управляемых настроек на машине изменяется, поэтому вы можете использовать их для логирования этих редактирований, но любое решение блокировки игнорируется. Это гарантирует, что параметры, управляемые предприятием, всегда вступают в силу. Claude Code не запускает hooks `ConfigChange`, когда [server-managed settings](/docs/ru/server-managed-settings) приходят или обновляются.2994Изменения `policy_settings` не могут быть заблокированы. Hooks все еще срабатывают для источников `policy_settings`, когда файл управляемых параметров на машине изменяется, поэтому вы можете использовать их для логирования этих редактирований, но любое решение блокировки игнорируется. Это гарантирует, что параметры, управляемые предприятием, всегда вступают в силу. Claude Code не запускает hooks `ConfigChange`, когда прибывают или обновляются [параметры, управляемые сервером](/docs/ru/server-managed-settings).

2991 2995 

2992Claude Code действует на решение блокировки из JSON вывода hook ConfigChange и отбрасывает `systemMessage` и `continue`. Заблокированное изменение не выводит никакого сообщения вам или Claude, независимо от того, блокируете ли вы с `reason` или с stderr при выходе 2. Claude Code только пишет строку в debug log.2996Claude Code действует на решение блокировки из JSON-вывода hook ConfigChange и отбрасывает `systemMessage` и `continue`. Заблокированное изменение не выводит никакого сообщения вам или Claude, независимо от того, блокируете ли вы с `reason` или с stderr при выходе 2. Claude Code только записывает строку в debug log.

2993 2997 

2994<h3 id="cwdchanged">2998<h3 id="cwdchanged">

2995 CwdChanged2999 CwdChanged

2996</h3>3000</h3>

2997 3001 

2998Запускается, когда команда shell в основном разговоре изменяет рабочую директорию, например когда Claude выполняет команду `cd`. Используйте это для реакции на изменения директории: перезагрузка переменных окружения, активация цепочек инструментов, специфичных для проекта, или автоматический запуск скриптов настройки. Пары с [FileChanged](#filechanged) для инструментов, таких как [direnv](https://direnv.net/), которые управляют окружением для каждой директории.3002Запускается, когда команда оболочки в основном разговоре изменяет рабочую директорию, например когда Claude выполняет команду `cd`. Используйте это для реакции на изменения директории: перезагрузка переменных окружения, активация цепочек инструментов для конкретного проекта или автоматический запуск скриптов настройки. Пары с [FileChanged](#filechanged) для инструментов, таких как [direnv](https://direnv.net/), которые управляют окружением для каждой директории.

2999 3003 

3000Hooks CwdChanged имеют доступ к [`CLAUDE_ENV_FILE`](#persist-environment-variables). Переменные, записанные в этот файл, сохраняются в последующих командах Bash до следующего события CwdChanged, когда Claude Code очищает их.3004Hooks CwdChanged имеют доступ к [`CLAUDE_ENV_FILE`](#persist-environment-variables). Переменные, записанные в этот файл, сохраняются в последующих командах Bash до следующего события CwdChanged, когда Claude Code их очищает.

3001 3005 

3002CwdChanged не поддерживает matchers и срабатывает при каждом возникновении.3006CwdChanged не поддерживает matchers и срабатывает при каждом возникновении.

3003 3007 

3004<h4 id="cwdchanged-input">3008<h4 id="cwdchanged-input">

3005 CwdChanged input3009 Ввод CwdChanged

3006</h4>3010</h4>

3007 3011 

3008Помимо [common input fields](#common-input-fields), hooks CwdChanged получают `old_cwd` и `new_cwd`.3012Помимо [общих полей ввода](#common-input-fields), hooks CwdChanged получают `old_cwd` и `new_cwd`.

3009 3013 

3010```json theme={null}3014```json theme={null}

3011{3015{

3019```3023```

3020 3024 

3021<h4 id="cwdchanged-output">3025<h4 id="cwdchanged-output">

3022 CwdChanged output3026 Вывод CwdChanged

3023</h4>3027</h4>

3024 3028 

3025Помимо [JSON output fields](#json-output), доступных всем hooks, hooks CwdChanged могут вернуть `watchPaths` для динамической установки того, какие пути файлов [FileChanged](#filechanged) наблюдает:3029Помимо [полей JSON-вывода](#json-output), доступных всем hooks, hooks CwdChanged могут вернуть `watchPaths` для динамической установки того, какие пути файлов [FileChanged](#filechanged) отслеживает:

3026 3030 

3027| Field | Description |3031| Поле | Описание |

3028| :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3032| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

3029| `watchPaths` | Массив абсолютных путей. Заменяет текущий динамический список наблюдения. Пути из конфигурации вашего `matcher` всегда наблюдаются. Возврат пустого массива очищает динамический список, что типично при входе в новую директорию |3033| `watchPaths` | Массив абсолютных путей. Заменяет текущий динамический список отслеживания. Пути из конфигурации вашего `matcher` всегда отслеживаются. Возврат пустого массива очищает динамический список, что типично при входе в новую директорию |

3030 3034 

3031Hooks CwdChanged не имеют управления решением. Они не могут заблокировать изменение директории.3035Hooks CwdChanged не имеют управления решением. Они не могут блокировать изменение директории.

3032 3036 

3033Claude Code читает `watchPaths` и `systemMessage` из их JSON вывода и отбрасывает `continue`. В интерактивных сеансах он показывает `systemMessage` как краткое уведомление терминала. Сообщение не достигает потока сообщений SDK.3037Claude Code читает `watchPaths` и `systemMessage` из их JSON-вывода и отбрасывает `continue`. В интерактивных сеансах он показывает `systemMessage` как краткое уведомление терминала. Сообщение не достигает потока сообщений SDK.

3034 3038 

3035<h3 id="directoryadded">3039<h3 id="directoryadded">

3036 DirectoryAdded3040 DirectoryAdded

3037</h3>3041</h3>

3038 3042 

3039Запускается после добавления рабочей директории во время сеанса с командой `/add-dir` или после добавления SDK клиентом с запросом управления `register_repo_root`. Используйте это для подготовки вновь добавленного репозитория, например установкой его зависимостей.3043Запускается после добавления рабочей директории во время сеанса с командой `/add-dir` или после добавления клиентом SDK с запросом управления `register_repo_root`. Используйте это для подготовки вновь добавленного репозитория, например установки его зависимостей.

3040 3044 

3041Claude Code не срабатывает это событие, когда:3045Claude Code не срабатывает это событие, когда:

3042 3046 

3044* Вы добавляете директорию на вкладку `/permissions` Workspace3048* Вы добавляете директорию на вкладку `/permissions` Workspace

3045* Вы добавляете директорию, которая уже является рабочей директорией или находится внутри одной3049* Вы добавляете директорию, которая уже является рабочей директорией или находится внутри одной

3046 3050 

3047Claude Code срабатывает DirectoryAdded после обновления состояния sandbox и разрешений, поэтому изолированные инструменты уже видят новую директорию, когда выполняется ваш hook. Команды hook сами выполняются неизолированными.3051Claude Code срабатывает DirectoryAdded после обновления состояния sandbox и разрешений, поэтому изолированные инструменты уже видят новую директорию, когда выполняется ваш hook. Команды hook сами выполняются без изоляции.

3048 3052 

3049Claude Code не ждет hook: добавление завершается немедленно, и hook выполняется в фоне с стандартным timeout 600 секунд.3053Claude Code не ждет hook: добавление завершается немедленно, и hook выполняется в фоновом режиме с тайм-аутом по умолчанию 600 секунд.

3050 3054 

3051Matcher фильтрует по тому, как была добавлена директория:3055Matcher фильтрует по тому, как была добавлена директория:

3052 3056 

3053| Matcher | Когда срабатывает |3057| Matcher | Когда срабатывает |

3054| :------------------- | :------------------------------------------------------------------------- |3058| :------------------- | :------------------------------------------------------------------------- |

3055| `slash_command` | Вы добавляете директорию с `/add-dir` |3059| `slash_command` | Вы добавляете директорию с `/add-dir` |

3056| `register_repo_root` | SDK клиент добавляет директорию с запросом управления `register_repo_root` |3060| `register_repo_root` | Клиент SDK добавляет директорию с запросом управления `register_repo_root` |

3057 3061 

3058<h4 id="directoryadded-input">3062<h4 id="directoryadded-input">

3059 DirectoryAdded input3063 Ввод DirectoryAdded

3060</h4>3064</h4>

3061 3065 

3062Помимо [common input fields](#common-input-fields), hooks DirectoryAdded получают `directory` и `source`.3066Помимо [общих полей ввода](#common-input-fields), hooks DirectoryAdded получают `directory` и `source`.

3063 3067 

3064| Field | Description |3068| Поле | Описание |

3065| :---------- | :-------------------------------------------------------------------------------------------------------------------- |3069| :---------- | :-------------------------------------------------------------------------------------------------------------------- |

3066| `directory` | Абсолютный путь директории, которая была добавлена |3070| `directory` | Абсолютный путь директории, которая была добавлена |

3067| `source` | Как была добавлена директория, `"slash_command"` для `/add-dir` или `"register_repo_root"` для запроса управления SDK |3071| `source` | Как была добавлена директория, `"slash_command"` для `/add-dir` или `"register_repo_root"` для запроса управления SDK |

3077}3081}

3078```3082```

3079 3083 

3080Hooks DirectoryAdded не имеют управления решением. Они не могут заблокировать добавление, которое уже завершилось, когда выполняется hook. Claude Code отбрасывает поле `continue` из их JSON вывода и выводит остальное по-другому в зависимости от источника:3084Hooks DirectoryAdded не имеют управления решением. Они не могут блокировать добавление, которое уже завершилось. Claude Code отбрасывает поле `continue` из их JSON-вывода и выводит остальное по-разному в зависимости от источника:

3081 3085 

3082* `slash_command`: Claude Code доставляет вывод `systemMessage` hook Claude как контекст на следующем ходе разговора, а не показывает вам. Количество неудачных hooks появляется в транскрипте. Полный вывод сбоя идет в debug log3086* `slash_command`: Claude Code доставляет `systemMessage` hook Claude как контекст на следующем ходе разговора, а не показывает вам. Количество неудачных hooks появляется в транскрипте. Полный вывод сбоя идет в debug log

3083* `register_repo_root`: Claude Code пишет вывод `systemMessage` и вывод сбоя в debug log только3087* `register_repo_root`: Claude Code записывает вывод `systemMessage` и вывод сбоя только в debug log

3084 3088 

3085<h3 id="filechanged">3089<h3 id="filechanged">

3086 FileChanged3090 FileChanged

3087</h3>3091</h3>

3088 3092 

3089Запускается, когда наблюдаемый файл изменяется на диске. Claude Code обнаруживает изменения с помощью наблюдателя файловой системы, а не путем проверки вызовов инструментов, поэтому он запускает hook независимо от того, что изменило файл: вызов инструмента `Edit` или `Write`, скрипт, который Claude запускает с `Bash`, или процесс вне Claude Code. Обычное использование — перезагрузка переменных окружения, когда изменяются файлы конфигурации проекта.3093Запускается, когда отслеживаемый файл изменяется на диске. Claude Code обнаруживает изменения с помощью наблюдателя файловой системы, а не путем проверки вызовов инструментов, поэтому он запускает hook независимо от того, что изменило файл: вызов инструмента `Edit` или `Write`, скрипт, который Claude запускает с `Bash`, или процесс вне Claude Code полностью. Обычное использование — перезагрузка переменных окружения при изменении файлов конфигурации проекта.

3090 3094 

3091`matcher` для этого события служит двум целям:3095`matcher` для этого события служит двум целям:

3092 3096 

3093* **Build the watch list**: значение разделяется на `|` и каждый сегмент регистрируется как буквальное имя файла в рабочей директории, поэтому `".envrc|.env"` наблюдает ровно эти два файла. Шаблоны regex не полезны здесь: значение, такое как `^\.env`, наблюдало бы файл буквально названный `^\.env`.3097* **Построить список отслеживания**: значение разделяется на `|` и каждый сегмент регистрируется как буквальное имя файла в рабочей директории, поэтому `".envrc|.env"` отслеживает ровно эти два файла. Шаблоны regex не полезны здесь: значение, такое как `^\.env`, отслеживало бы файл буквально названный `^\.env`.

3094* **Filter which hooks run**: когда наблюдаемый файл изменяется, то же значение фильтрует, какие группы hook запускаются, используя стандартные [matcher rules](#matcher-patterns) против базового имени измененного файла.3098* **Фильтровать, какие hooks запускаются**: когда отслеживаемый файл изменяется, то же значение фильтрует, какие группы hook запускаются, используя стандартные [правила matcher](#matcher-patterns) против базового имени измененного файла.

3095 3099 

3096Этот пример нормализует окончания строк в `data.csv` после любого изменения, включая вызов инструмента `Bash` или внешний скрипт, переписывающий файл:3100Этот пример нормализует окончания строк в `data.csv` после любого изменения, включая команду `Bash` или внешний скрипт, переписывающий файл:

3097 3101 

3098```json theme={null}3102```json theme={null}

3099{3103{

3113}3117}

3114```3118```

3115 3119 

3116Hook читает абсолютный путь измененного файла из поля `file_path` [JSON input](#filechanged-input) на stdin. Его guard `grep` тестирует то же самое, что `perl` удаляет, CR в конце строки, поэтому запуск после нормализации выходит без касания файла. Более слабый guard зацикливается навсегда, потому что `perl -i` переписывает файл даже когда он ничего не подставляет и Claude Code запускает hook снова после каждой переписи. Сохраните этот скрипт в `/path/to/normalize-line-endings.sh` и сделайте его исполняемым:3120Hook читает абсолютный путь измененного файла из поля `file_path` JSON-ввода на stdin. Его охрана `grep` тестирует то же самое, что `perl` удаляет, CR в конце строки, поэтому запуск после нормализации выходит без касания файла. Более слабая охрана зацикливается навсегда, потому что `perl -i` переписывает файл, даже когда он ничего не заменяет, и Claude Code запускает hook снова после каждой переписи. Сохраните этот скрипт в `/path/to/normalize-line-endings.sh` и сделайте его исполняемым:

3117 3121 

3118```bash theme={null}3122```bash theme={null}

3119#!/bin/bash3123#!/bin/bash

3125 3129 

3126Чтобы подтвердить, что hook работает, попросите Claude добавить строку CRLF в `data.csv` с командой `Bash`. Claude Code запускает hook и файл заканчивается с окончаниями LF.3130Чтобы подтвердить, что hook работает, попросите Claude добавить строку CRLF в `data.csv` с командой `Bash`. Claude Code запускает hook и файл заканчивается с окончаниями LF.

3127 3131 

3128Чтобы наблюдать файлы, которые вы не можете назвать заранее, верните [`watchPaths`](#filechanged-output) из hook для динамического обновления списка наблюдения. Claude Code запускает наблюдатель только, когда что-то называет файл для наблюдения, поэтому посейте список с группой FileChanged, чей matcher называет по крайней мере один файл, или с hook [SessionStart](#sessionstart-decision-control) или [CwdChanged](#cwdchanged), который возвращает `watchPaths`. Matcher все еще фильтрует, какие группы hook запускаются, когда наблюдаемый файл изменяется, поэтому дайте группе, которая обрабатывает динамические пути, опущенный matcher, который совпадает с каждым наблюдаемым файлом и ничего не добавляет в список наблюдения. Matcher `"*"` также совпадает с каждым файлом, но Claude Code регистрирует его в списке наблюдения, как любое другое значение, как буквальный файл названный `*`.3132Чтобы отслеживать файлы, которые вы не можете назвать заранее, верните [`watchPaths`](#filechanged-output) из hook для динамического обновления списка отслеживания. Claude Code запускает наблюдатель только, когда что-то называет файл для отслеживания, поэтому заполните список группой FileChanged, чей matcher называет по крайней мере один файл, или с hook [SessionStart](#sessionstart-decision-control) или [CwdChanged](#cwdchanged), который возвращает `watchPaths`. Matcher все еще фильтрует, какие группы hook запускаются, когда отслеживаемый файл изменяется, поэтому дайте группе, которая обрабатывает динамические пути, опущенный matcher, который совпадает с каждым отслеживаемым файлом и ничего не добавляет в список отслеживания. Matcher `"*"` также совпадает с каждым файлом, но Claude Code регистрирует его в списке отслеживания, как любое другое значение, как буквальный файл названный `*`.

3129 3133 

3130Hooks FileChanged имеют доступ к [`CLAUDE_ENV_FILE`](#persist-environment-variables). Переменные, записанные в этот файл, сохраняются в последующих командах Bash до следующего события [CwdChanged](#cwdchanged), когда Claude Code очищает их.3134Hooks FileChanged имеют доступ к [`CLAUDE_ENV_FILE`](#persist-environment-variables). Переменные, записанные в этот файл, сохраняются в последующих командах Bash до следующего события [CwdChanged](#cwdchanged), когда Claude Code их очищает.

3131 3135 

3132<h4 id="filechanged-input">3136<h4 id="filechanged-input">

3133 FileChanged input3137 Ввод FileChanged

3134</h4>3138</h4>

3135 3139 

3136Помимо [common input fields](#common-input-fields), hooks FileChanged получают `file_path` и `event`.3140Помимо [общих полей ввода](#common-input-fields), hooks FileChanged получают `file_path` и `event`.

3137 3141 

3138| Field | Description |3142| Поле | Описание |

3139| :---------- | :---------------------------------------------------------------------------------------------------------------- |3143| :---------- | :---------------------------------------------------------------------------------------------------------------- |

3140| `file_path` | Абсолютный путь к файлу, который изменился |3144| `file_path` | Абсолютный путь к файлу, который изменился |

3141| `event` | Что произошло: `"change"` для измененного файла, `"add"` для созданного файла или `"unlink"` для удаленного файла |3145| `event` | Что произошло: `"change"` для измененного файла, `"add"` для созданного файла или `"unlink"` для удаленного файла |

3152```3156```

3153 3157 

3154<h4 id="filechanged-output">3158<h4 id="filechanged-output">

3155 FileChanged output3159 Вывод FileChanged

3156</h4>3160</h4>

3157 3161 

3158Помимо [JSON output fields](#json-output), доступных всем hooks, hooks FileChanged могут вернуть `watchPaths` для динамического обновления того, какие пути файлов наблюдаются:3162Помимо [полей JSON-вывода](#json-output), доступных всем hooks, hooks FileChanged могут вернуть `watchPaths` для динамического обновления того, какие пути файлов отслеживаются:

3159 3163 

3160| Field | Description |3164| Поле | Описание |

3161| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |3165| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

3162| `watchPaths` | Массив абсолютных путей. Заменяет текущий динамический список наблюдения. Пути из конфигурации вашего `matcher` всегда наблюдаются. Используйте это, когда ваш скрипт hook обнаруживает дополнительные файлы для наблюдения на основе измененного файла |3166| `watchPaths` | Массив абсолютных путей. Заменяет текущий динамический список отслеживания. Пути из конфигурации вашего `matcher` всегда отслеживаются. Используйте это, когда ваш скрипт hook обнаруживает дополнительные файлы для отслеживания на основе измененного файла |

3163 3167 

3164Hooks FileChanged не имеют управления решением. Они не могут заблокировать изменение файла от возникновения.3168Hooks FileChanged не имеют управления решением. Они не могут блокировать изменение файла от возникновения.

3165 3169 

3166Claude Code читает `watchPaths` и `systemMessage` из их JSON вывода и отбрасывает `continue`. В интерактивных сеансах он показывает `systemMessage` как краткое уведомление терминала. Сообщение не достигает потока сообщений SDK.3170Claude Code читает `watchPaths` и `systemMessage` из их JSON-вывода и отбрасывает `continue`. В интерактивных сеансах он показывает `systemMessage` как краткое уведомление терминала. Сообщение не достигает потока сообщений SDK.

3167 3171 

3168<h3 id="worktreecreate">3172<h3 id="worktreecreate">

3169 WorktreeCreate3173 WorktreeCreate

3170</h3>3174</h3>

3171 3175 

3172Запускается, когда создается worktree, будь то из `claude --worktree`, из [subagent using `isolation: "worktree"`](/docs/ru/sub-agents#choose-the-subagent-scope) или для [background session](/docs/ru/agent-view#how-file-edits-are-isolated), которую Claude Code изолирует в своем собственном worktree. По умолчанию Claude Code создает изолированную рабочую копию с `git worktree`. Настройка hook WorktreeCreate заменяет это поведение git по умолчанию, позволяя вам использовать другую систему контроля версий, такую как SVN, Perforce или Mercurial.3176Запускается, когда создается worktree, будь то из `claude --worktree`, из [подагента, использующего `isolation: "worktree"`](/docs/ru/sub-agents#choose-the-subagent-scope), или для [фонового сеанса](/docs/ru/agent-view#how-file-edits-are-isolated), который Claude Code изолирует в своем собственном worktree. По умолчанию Claude Code создает изолированную рабочую копию с `git worktree`. Настройка hook WorktreeCreate заменяет это поведение git по умолчанию, позволяя вам использовать другую систему контроля версий, такую как SVN, Perforce или Mercurial.

3173 3177 

3174Поскольку hook заменяет поведение по умолчанию полностью, [`.worktreeinclude`](/docs/ru/worktrees#copy-gitignored-files-into-worktrees) не обрабатывается. Если вам нужно скопировать локальные файлы конфигурации, такие как `.env`, в новый worktree, сделайте это внутри вашего скрипта hook.3178Поскольку hook заменяет поведение по умолчанию полностью, [`.worktreeinclude`](/docs/ru/worktrees#copy-gitignored-files-into-worktrees) не обрабатывается. Если вам нужно скопировать локальные файлы конфигурации, такие как `.env`, в новый worktree, сделайте это внутри вашего скрипта hook.

3175 3179 

3196}3200}

3197```3201```

3198 3202 

3199Hook читает имя worktree `name` из JSON ввода на stdin, проверяет свежую копию в новую директорию и выводит путь директории. `echo` на последней строке — это то, что Claude Code читает как путь worktree. Перенаправьте любой другой вывод в stderr, чтобы он не мешал пути.3203Hook читает `name` worktree из JSON-ввода на stdin, проверяет свежую копию в новую директорию и выводит путь директории. `echo` на последней строке — это то, что Claude Code читает как путь worktree. Перенаправьте любой другой вывод в stderr, чтобы он не мешал пути.

3200 3204 

3201<h4 id="worktreecreate-input">3205<h4 id="worktreecreate-input">

3202 WorktreeCreate input3206 Ввод WorktreeCreate

3203</h4>3207</h4>

3204 3208 

3205Помимо [common input fields](#common-input-fields), hooks WorktreeCreate получают поле `name`. Это идентификатор slug для нового worktree, либо указанный пользователем, либо автоматически сгенерированный, например `bold-oak-a3f2`.3209Помимо [общих полей ввода](#common-input-fields), hooks WorktreeCreate получают поле `name`. Это идентификатор slug для нового worktree, либо указанный пользователем, либо автоматически сгенерированный, например `bold-oak-a3f2`.

3206 3210 

3207```json theme={null}3211```json theme={null}

3208{3212{

3215```3219```

3216 3220 

3217<h4 id="worktreecreate-output">3221<h4 id="worktreecreate-output">

3218 WorktreeCreate output3222 Вывод WorktreeCreate

3219</h4>3223</h4>

3220 3224 

3221Hooks WorktreeCreate не используют стандартную модель решения разрешить/заблокировать. Вместо этого успех или сбой hook определяет результат. Hook должен вернуть путь к созданной директории worktree:3225Hooks WorktreeCreate не используют стандартную модель решения разрешить/блокировать. Вместо этого успех или сбой hook определяет результат. Hook должен вернуть путь к созданной директории worktree:

3222 3226 

3223* **Command hooks** (`type: "command"`): выведите путь как последнюю непустую строку stdout. Claude Code удаляет коды ANSI перед чтением этой строки, поэтому баннеры запуска shell, выведенные перед вашим `echo`, игнорируются. Перенаправьте любой другой вывод hook в stderr.3227* **Command hooks** (`type: "command"`): выведите путь как последнюю непустую строку stdout. Claude Code удаляет коды ANSI перед чтением этой строки, поэтому баннеры запуска оболочки, выведенные перед вашим `echo`, игнорируются. Перенаправьте любой другой вывод hook в stderr.

3224* **HTTP hooks** (`type: "http"`): верните `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` в теле ответа.3228* **HTTP hooks** (`type: "http"`): верните `{ "hookSpecificOutput": { "hookEventName": "WorktreeCreate", "worktreePath": "/absolute/path" } }` в теле ответа.

3225 3229 

3226Если hook не удается или не создает путь, создание worktree не удается с ошибкой.3230Если hook не удается или не создает путь, создание worktree не удается с ошибкой.

3227 3231 

3228Claude Code разрешает относительный путь против директории, в которой выполнялся hook, свернув любые сегменты `.` или `..` в нем. Если результирующий путь не является директорией, которую Claude Code может ввести, сеанс выводит ошибку, называющую путь, и выходит с кодом 1.3232Claude Code разрешает относительный путь против директории, в которой выполнялся hook, свернув любые сегменты `.` или `..` в нем. Если результирующий путь не является директорией, которую Claude Code может ввести, сеанс выводит ошибку с названием пути и выходит с кодом 1.

3229 3233 

3230Claude Code отказывает абсолютному пути, который содержит сегменты `.` или `..`, и любому пути, который проходит через symlink ниже корня репозитория, потому что symlink, зафиксированный в репозитории, может перенаправить worktree вне его. Ошибка называет отклоненный компонент. Верните нормализованный путь, который не проходит через symlink внутри репозитория. До версии 2.1.216 создание worktree следовало пути hook без этого скрининга.3234Claude Code отказывает абсолютному пути, который содержит сегменты `.` или `..`, и любому пути, который проходит через символическую ссылку ниже корня репозитория, потому что символическая ссылка, зафиксированная в репозитории, может перенаправить worktree вне его. Ошибка называет отклоненный компонент. Верните нормализованный путь, который не проходит через символическую ссылку внутри репозитория. До версии 2.1.216 создание worktree следовало пути hook без этого скрининга.

3231 3235 

3232<h3 id="worktreeremove">3236<h3 id="worktreeremove">

3233 WorktreeRemove3237 WorktreeRemove

3237 3241 

3238* вы выходите из сеанса `--worktree` и выбираете его удаление3242* вы выходите из сеанса `--worktree` и выбираете его удаление

3239* подагент с `isolation: "worktree"` завершается3243* подагент с `isolation: "worktree"` завершается

3240* вы удаляете [background session](/docs/ru/agent-view#what-deleting-a-session-removes), чей worktree создал hook3244* вы удаляете [фоновый сеанс](/docs/ru/agent-view#what-deleting-a-session-removes), чей worktree создал hook

3241 3245 

3242Для git-based worktrees Claude Code обрабатывает очистку автоматически с `git worktree remove`. Если вы настроили hook WorktreeCreate для системы контроля версий, не основанной на git, соедините его с hook WorktreeRemove для обработки очистки. Без него директория worktree остается на диске.3246Для git-based worktrees Claude Code обрабатывает очистку автоматически с `git worktree remove`. Если вы настроили hook WorktreeCreate для системы контроля версий, не основанной на git, свяжите его с hook WorktreeRemove для обработки очистки. Без него директория worktree остается на диске.

3243 3247 

3244Claude Code отбрасывает [JSON output fields](#json-output) hook WorktreeRemove, такие как `systemMessage` и `continue`.3248Claude Code отбрасывает [поля JSON-вывода](#json-output) hook WorktreeRemove, такие как `systemMessage` и `continue`.

3245 3249 

3246Для удаления сеанса фонового плана Claude Code проверяет сохраненный путь worktree перед запуском hook и отказывает пути, который является symlink или проходит через один ниже корня репозитория. Hook запускается для worktree, который все еще содержит файлы только, когда вы подтверждаете удаление в [agent view](/docs/ru/agent-view#what-deleting-a-session-removes); для такого worktree, [`claude rm`](/docs/ru/agent-view#manage-sessions-from-the-shell) сохраняет сеанс и worktree вместо этого. До версии 2.1.216 hook запускался на сохраненном пути без этих проверок.3250Для удаления фонового сеанса Claude Code проверяет сохраненный путь worktree перед запуском hook и отказывает пути, который является символической ссылкой или проходит через одну ниже корня репозитория. Hook запускается для worktree, который все еще содержит файлы только, когда вы подтверждаете удаление в [agent view](/docs/ru/agent-view#what-deleting-a-session-removes); для такого worktree [`claude rm`](/docs/ru/agent-view#manage-sessions-from-the-shell) сохраняет сеанс и worktree вместо этого. До версии 2.1.216 hook запускался на сохраненном пути без этих проверок.

3247 3251 

3248Claude Code передает путь, возвращенный WorktreeCreate, как `worktree_path` в ввод hook. Этот пример читает этот путь и удаляет директорию:3252Claude Code передает путь, возвращенный WorktreeCreate, как `worktree_path` в ввод hook. Этот пример читает этот путь и удаляет директорию:

3249 3253 

3265```3269```

3266 3270 

3267<h4 id="worktreeremove-input">3271<h4 id="worktreeremove-input">

3268 WorktreeRemove input3272 Ввод WorktreeRemove

3269</h4>3273</h4>

3270 3274 

3271Помимо [common input fields](#common-input-fields), hooks WorktreeRemove получают поле `worktree_path`, которое является абсолютным путем к удаляемому worktree.3275Помимо [общих полей ввода](#common-input-fields), hooks WorktreeRemove получают поле `worktree_path`, которое является абсолютным путем к удаляемому worktree.

3272 3276 

3273```json theme={null}3277```json theme={null}

3274{3278{

3283Код выхода hook WorktreeRemove определяет результат. Когда hook выходит с ненулевым кодом и директория в `worktree_path` все еще существует после этого, удаление не удается:3287Код выхода hook WorktreeRemove определяет результат. Когда hook выходит с ненулевым кодом и директория в `worktree_path` все еще существует после этого, удаление не удается:

3284 3288 

3285* Worktree остается на диске, и команда hook и stderr идут в [debug log](#debug-hooks).3289* Worktree остается на диске, и команда hook и stderr идут в [debug log](#debug-hooks).

3286* Если вы удаляли фоновый сеанс, сеанс также остается. Сообщение отказа в [agent view](/docs/ru/agent-view#what-deleting-a-session-removes) сообщает, как закончился hook, такой как `exited 1`, цитирует начало его stderr и говорит, удаляет ли удаление сеанса снова директорию в любом случае.3290* Если вы удаляли фоновый сеанс, сеанс остается тоже. Сообщение отказа в [agent view](/docs/ru/agent-view#what-deleting-a-session-removes) сообщает, как закончился hook, такой как `exited 1`, цитирует начало его stderr и говорит, удаляет ли удаление сеанса снова директорию в любом случае.

3287 3291 

3288<h3 id="precompact">3292<h3 id="precompact">

3289 PreCompact3293 PreCompact

3294Значение matcher указывает, было ли сжатие запущено вручную или автоматически:3298Значение matcher указывает, было ли сжатие запущено вручную или автоматически:

3295 3299 

3296| Matcher | Когда срабатывает |3300| Matcher | Когда срабатывает |

3297| :------- | :--------------------------------------------------------------------------------------------------------- |3301| :------- | :------------------------------------------------------------------------------------------------------- |

3298| `manual` | `/compact` |3302| `manual` | `/compact` |

3299| `auto` | Auto-compact, когда разговор достигает [auto-compact window](/docs/ru/model-config#set-the-auto-compact-window) |3303| `auto` | Auto-compact, когда разговор достигает [окна auto-compact](/docs/ru/model-config#set-the-auto-compact-window) |

3300 3304 

3301Выход с кодом 2 для блокирования сжатия. Для ручного `/compact`, сообщение stderr показывается пользователю. Вы также можете заблокировать, возвращая JSON с `"decision": "block"`.3305Выйдите с кодом 2 для блокировки сжатия. Для ручного `/compact` сообщение stderr показывается пользователю. Вы также можете блокировать, возвращая JSON с `"decision": "block"`.

3302 3306 

3303Блокирование автоматического сжатия имеет разные эффекты в зависимости от того, когда оно срабатывает. Если сжатие было запущено упреждающе перед пределом контекста, Claude Code пропускает его и разговор продолжается несжатым. Если сжатие было запущено для восстановления от ошибки лимита контекста, уже возвращенной API, основная ошибка выводится и текущий запрос не удается.3307Блокировка автоматического сжатия имеет разные эффекты в зависимости от того, когда оно срабатывает. Если сжатие было запущено упреждающе перед пределом контекста, Claude Code пропускает его и разговор продолжается несжатым. Если сжатие было запущено для восстановления от ошибки лимита контекста, уже возвращенной API, основная ошибка выводится и текущий запрос не удается.

3304 3308 

3305Claude Code отбрасывает поля `systemMessage` и `continue` hook PreCompact.3309Claude Code отбрасывает поля `systemMessage` и `continue` hook PreCompact.

3306 3310 

3307<h4 id="precompact-input">3311<h4 id="precompact-input">

3308 PreCompact input3312 Ввод PreCompact

3309</h4>3313</h4>

3310 3314 

3311Помимо [common input fields](#common-input-fields), hooks PreCompact получают `trigger` и `custom_instructions`. Для `manual`, `custom_instructions` содержит то, что пользователь передает в `/compact` и имеет значение `null`, когда они ничего не передают. Для `auto`, `custom_instructions` имеет значение `null`.3315Помимо [общих полей ввода](#common-input-fields), hooks PreCompact получают `trigger` и `custom_instructions`. Для `manual`, `custom_instructions` содержит то, что пользователь передает в `/compact` и имеет значение `null`, когда они ничего не передают. Для `auto`, `custom_instructions` имеет значение `null`.

3312 3316 

3313```json theme={null}3317```json theme={null}

3314{3318{

3325 PostCompact3329 PostCompact

3326</h3>3330</h3>

3327 3331 

3328Запускается после завершения операции compact Claude Code. Используйте это событие для реакции на новое сжатое состояние, например для логирования сгенерированной сводки или обновления внешнего состояния. Claude Code отбрасывает поля `systemMessage` и `continue` hook PostCompact.3332Запускается после завершения операции compact Claude Code. Используйте это событие для реакции на новое сжатое состояние, например для логирования сгенерированного резюме или обновления внешнего состояния. Claude Code отбрасывает поля `systemMessage` и `continue` hook PostCompact.

3329 3333 

3330Те же значения matcher применяются, как для `PreCompact`:3334Те же значения matcher применяются, как для `PreCompact`:

3331 3335 

3332| Matcher | Когда срабатывает |3336| Matcher | Когда срабатывает |

3333| :------- | :--------------------------------------------------------------------------------------------------------------- |3337| :------- | :------------------------------------------------------------------------------------------------------------- |

3334| `manual` | После `/compact` |3338| `manual` | После `/compact` |

3335| `auto` | После auto-compact, когда разговор достигает [auto-compact window](/docs/ru/model-config#set-the-auto-compact-window) |3339| `auto` | После auto-compact, когда разговор достигает [окна auto-compact](/docs/ru/model-config#set-the-auto-compact-window) |

3336 3340 

3337<h4 id="postcompact-input">3341<h4 id="postcompact-input">

3338 PostCompact input3342 Ввод PostCompact

3339</h4>3343</h4>

3340 3344 

3341Помимо [common input fields](#common-input-fields), hooks PostCompact получают `trigger` и `compact_summary`. Поле `compact_summary` содержит сводку разговора, сгенерированную операцией compact.3345Помимо [общих полей ввода](#common-input-fields), hooks PostCompact получают `trigger` и `compact_summary`. Поле `compact_summary` содержит резюме разговора, сгенерированное операцией compact.

3342 3346 

3343```json theme={null}3347```json theme={null}

3344{3348{

3357 PreModelSwitch3361 PreModelSwitch

3358</h3>3362</h3>

3359 3363 

3360Запускается перед применением переключения модели, которое вы или клиент запросили. Используйте это для блокирования переключения, требования подтверждения или показа стоимости переключения перед его выполнением.3364Запускается перед применением переключения модели, которое вы или клиент запросили. Используйте это для блокировки переключения, требования подтверждения или показа стоимости переключения перед его выполнением.

3361 3365 

3362PreModelSwitch требует Claude Code v2.1.251 или позже. Claude Code запускает его для этих запросов:3366PreModelSwitch требует Claude Code v2.1.251 или позже. Claude Code запускает его для этих запросов:

3363 3367 

3367* Включение [fast mode](/docs/ru/fast-mode), когда это изменяет модель сеанса3371* Включение [fast mode](/docs/ru/fast-mode), когда это изменяет модель сеанса

3368* Запрос `set_model` или изменение модели в запросе `apply_flag_settings` от хоста [Agent SDK](/docs/ru/agent-sdk/typescript#query-object) или [Remote Control](/docs/ru/remote-control)3372* Запрос `set_model` или изменение модели в запросе `apply_flag_settings` от хоста [Agent SDK](/docs/ru/agent-sdk/typescript#query-object) или [Remote Control](/docs/ru/remote-control)

3369 3373 

3370Claude Code не запускает hooks PreModelSwitch для переключений, которые он делает самостоятельно, такие как [automatic model fallback](/docs/ru/model-config#automatic-model-fallback) или восстановление модели при возобновлении сеанса. Эти изменения достигают [PostModelSwitch](#postmodelswitch) только.3374Claude Code не запускает hooks PreModelSwitch для переключений, которые он делает самостоятельно, такие как [автоматический fallback модели](/docs/ru/model-config#automatic-model-fallback) или восстановление модели при возобновлении сеанса. Эти изменения достигают [PostModelSwitch](#postmodelswitch) только.

3371 3375 

3372Claude Code сравнивает matcher против канонического имени модели, на которую сеанс переключается, игнорируя любой суффикс `[1m]`. Alias, такой как `opus`, датированный ID модели и ID, специфичный для поставщика, такой как ID модели Amazon Bedrock, все совпадают с одним каноническим именем, на которое они разрешаются, поэтому `claude-opus-5` охватывает каждое написание Opus 5.3376Claude Code сравнивает matcher против канонического имени модели, на которую сеанс переключается, игнорируя любой суффикс `[1m]`. Псевдоним, такой как `opus`, датированный ID модели и ID, специфичный для поставщика, такой как ID модели Amazon Bedrock, все совпадают с одним каноническим именем, на которое они разрешаются, поэтому `claude-opus-5` охватывает каждое написание Opus 5.

3373 3377 

3374Когда Claude Code не может определить каноническое имя для цели, например пользовательский ID модели, который знает только ваш [LLM gateway](/docs/ru/llm-gateway), он запускает каждый hook PreModelSwitch независимо от matcher. Hook, который блокирует, должен поэтому проверить `to_model` из своего ввода, а не полагаться только на matcher.3378Когда Claude Code не может определить каноническое имя для цели, например пользовательский ID модели, который знает только ваш [LLM gateway](/docs/ru/llm-gateway), он запускает каждый hook PreModelSwitch независимо от matcher. Hook, который блокирует, должен поэтому проверить `to_model` из своего ввода, а не полагаться только на matcher.

3375 3379 

3442Чтобы подтвердить, что hook работает, запустите `/model claude-opus-4-6` из сеанса, работающего на другой модели. Claude Code сохраняет текущую модель и сообщает, что hook PreModelSwitch заблокировал переключение, с вашим сообщением как причиной.3446Чтобы подтвердить, что hook работает, запустите `/model claude-opus-4-6` из сеанса, работающего на другой модели. Claude Code сохраняет текущую модель и сообщает, что hook PreModelSwitch заблокировал переключение, с вашим сообщением как причиной.

3443 3447 

3444<h4 id="premodelswitch-input">3448<h4 id="premodelswitch-input">

3445 PreModelSwitch input3449 Ввод PreModelSwitch

3446</h4>3450</h4>

3447 3451 

3448Помимо [common input fields](#common-input-fields), hooks PreModelSwitch получают поля в этой таблице. Последние пять описывают, что стоит повторная отправка разговора на новую модель, поэтому hook может показать эту цифру перед переключением.3452Помимо [общих полей ввода](#common-input-fields), hooks PreModelSwitch получают поля в этой таблице. Последние пять описывают, что стоит повторная отправка разговора на новую модель, поэтому hook может показать эту цифру перед переключением.

3449 3453 

3450| Field | Type | Description |3454| Поле | Тип | Описание |

3451| :-------------------------- | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3455| :-------------------------- | :---------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3452| `from_model` | string | ID модели, на которую переключается |3456| `from_model` | string | ID модели, на которую переключается |

3453| `to_model` | string | ID модели, на которую переключается. Matcher сравнивает против канонического имени этой модели |3457| `to_model` | string | ID модели, на которую переключается. Matcher сравнивает против канонического имени этой модели |

3454| `requested_model` | string or `null` | Модель, которую назвал запрос: alias, такой как `opus`, полный ID модели или `null`, когда запрос был для модели по умолчанию |3458| `requested_model` | string или `null` | Модель, которую назвал запрос: псевдоним, такой как `opus`, полный ID модели или `null`, когда запрос был для модели по умолчанию |

3455| `source` | string | Откуда пришел запрос: `"command"` для `/model <name>`, параметра Model в `/config` или включения fast mode; `"picker"` для средства выбора модели; `"sdk"` для запроса `set_model` или изменения модели в запросе `apply_flag_settings` от хоста Agent SDK или Remote Control |3459| `source` | string | Откуда пришел запрос: `"command"` для `/model <name>`, параметра Model в `/config` или включения fast mode; `"picker"` для средства выбора модели; `"sdk"` для запроса `set_model` или изменения модели в запросе `apply_flag_settings` от хоста Agent SDK или Remote Control |

3456| `context_tokens` | number | Токены, которые следующий запрос повторно отправляет как его подсказка: входные, кэш чтения, кэш создания и выходные токены последнего ответа в основном разговоре, в сумме. `0` перед первым ответом |3460| `context_tokens` | number | Токены, которые следующий запрос повторно отправляет как его подсказка: входные, кэш-чтение, кэш-создание и выходные токены последнего ответа в основном разговоре, в сумме. `0` перед первым ответом |

3457| `prompt_cache_warm` | boolean | Вероятно ли, что кэш подсказок текущей модели все еще теплый, означая, что переключение его теряет |3461| `prompt_cache_warm` | boolean | Теплый ли кэш подсказок текущей модели, означая, что переключение его теряет |

3458| `cache_ttl` | string | [Prompt cache lifetime](/docs/ru/prompt-caching#cache-lifetime), который Claude Code запрашивает для этого сеанса: `"5m"` или `"1h"` |3462| `cache_ttl` | string | [Время жизни кэша подсказок](/docs/ru/prompt-caching#cache-lifetime), которое Claude Code запрашивает для этого сеанса: `"5m"` или `"1h"` |

3459| `estimated_cache_write_usd` | number | Предполагаемая стоимость в долларах США записи `context_tokens` в кэш подсказок на `to_model` при скорости `cache_ttl`, исключая следующий ответ. Сервер может не нуждаться в повторном кэшировании всего контекста, поэтому рассматривайте это как оценку |3463| `estimated_cache_write_usd` | number | Предполагаемая стоимость в долларах США записи `context_tokens` в кэш подсказок на `to_model` при ставке `cache_ttl`, исключая следующий ответ. Сервер может не нуждаться в повторном кэшировании всего контекста, поэтому рассматривайте это как оценку |

3460| `pricing` | string | Как Claude Code оценил `estimated_cache_write_usd`: `"configured"` по вашим собственным ставкам организации, когда она их настроила, `"catalog"` по цене списка или `"default"`, когда `to_model` не имеет известной цены и Claude Code предположил стандартную ставку |3464| `pricing` | string | Как Claude Code оценил `estimated_cache_write_usd`: `"configured"` по вашим собственным ставкам организации, когда она их настроила, `"catalog"` по цене списка или `"default"`, когда `to_model` не имеет известной цены и Claude Code предположил ставку по умолчанию |

3461 3465 

3462Этот пример показывает ввод для `/model opus` в сеансе, работающем на Sonnet 5:3466Этот пример показывает ввод для `/model opus` в сеансе, работающем на Sonnet 5:

3463 3467 

3480```3484```

3481 3485 

3482<h4 id="premodelswitch-decision-control">3486<h4 id="premodelswitch-decision-control">

3483 PreModelSwitch decision control3487 Управление решением PreModelSwitch

3484</h4>3488</h4>

3485 3489 

3486Hooks `PreModelSwitch` могут отменить переключение, попросить пользователя подтвердить его или позволить ему продолжить. Выход 2 или `decision: "block"` верхнего уровня отменяет переключение.3490Hooks `PreModelSwitch` могут отменить переключение, попросить пользователя подтвердить его или позволить ему продолжить. Код выхода 2 или `decision: "block"` верхнего уровня отменяет переключение.

3487 3491 

3488Для более тонкого контроля, верните `permissionDecision` и `permissionDecisionReason` в объекте `hookSpecificOutput`, как на [PreToolUse](#pretooluse-decision-control). `PreModelSwitch` принимает `"allow"`, `"deny"` и `"ask"`. Он не принимает `"defer"`, `updatedInput` или `additionalContext`. Таблица ниже описывает оба поля:3492Для более тонкого управления, верните `permissionDecision` и `permissionDecisionReason` в объекте `hookSpecificOutput`, как на [PreToolUse](#pretooluse-decision-control). `PreModelSwitch` принимает `"allow"`, `"deny"` и `"ask"`. Он не принимает `"defer"`, `updatedInput` или `additionalContext`. Таблица ниже описывает оба поля:

3489 3493 

3490| Field | Description |3494| Поле | Описание |

3491| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |3495| :------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3492| `permissionDecision` | `"allow"` продолжает и пропускает [confirmation Claude Code shows while the prompt cache is warm](/docs/ru/prompt-caching#switching-models). `"deny"` отменяет переключение. `"ask"` подсказывает пользователю подтвердить его |3496| `permissionDecision` | `"allow"` продолжает и пропускает [подтверждение, которое Claude Code показывает, пока кэш подсказок теплый](/docs/ru/prompt-caching#switching-models). `"deny"` отменяет переключение. `"ask"` подсказывает пользователю подтвердить его |

3493| `permissionDecisionReason` | Для `"deny"`, показано пользователю как причина блокирования переключения или возвращено как ошибка для запроса `set_model`. Для `"ask"`, показано в подсказке подтверждения. Игнорируется для `"allow"` |3497| `permissionDecisionReason` | Для `"deny"`, показано пользователю как причина блокировки переключения или возвращено как ошибка для запроса `set_model`. Для `"ask"`, показано в подсказке подтверждения. Игнорируется для `"allow"` |

3494 3498 

3495Только `/model` в интерактивном сеансе может показать подсказку `"ask"`. На каждой другой поверхности, включая неинтерактивный режим с флагом `-p`, `/config` и запросы `set_model`, Claude Code рассматривает `"ask"` как отказ.3499Только `/model` в интерактивном сеансе может показать подсказку `"ask"`. На каждой другой поверхности, включая неинтерактивный режим с флагом `-p`, `/config` и запросы `set_model`, Claude Code рассматривает `"ask"` как отказ.

3496 3500 

3508 3512 

3509Когда несколько hooks PreModelSwitch возвращают разные решения, приоритет — `deny` > `ask` > `allow`.3513Когда несколько hooks PreModelSwitch возвращают разные решения, приоритет — `deny` > `ask` > `allow`.

3510 3514 

3511Claude Code показывает пользователю любой `systemMessage`, который возвращает ваш hook, независимо от решения, поэтому hook отчета стоимости может вернуть `{"systemMessage": "..."}` и выход 0.3515Claude Code показывает пользователю любой `systemMessage`, который возвращает ваш hook, независимо от решения, поэтому hook отчета стоимости может вернуть `{"systemMessage": "..."}` и выйти 0.

3512 3516 

3513Hook PreModelSwitch, который не отвечает перед своим timeout, блокирует переключение. На [PreToolUse](#timeouts), напротив, hook command, который истекает timeout, позволяет вызову инструмента продолжить. Стандартный timeout для этого события составляет 30 секунд. `PreModelSwitch` запускает только hooks `command`, `http` и `mcp_tool`, поэтому стандартные значения `prompt` и `agent` не применяются.3517Hook PreModelSwitch, который не отвечает перед своим тайм-аутом, блокирует переключение. На [PreToolUse](#timeouts), в отличие от этого, тайм-аут command hook позволяет вызову инструмента продолжить. Тайм-аут по умолчанию для этого события составляет 30 секунд. `PreModelSwitch` запускает только hooks `command`, `http` и `mcp_tool`, поэтому стандарты `prompt` и `agent` не применяются.

3514 3518 

3515Hook, который выходит с кодом, отличным от 0 или 2, и не выводит JSON решение, не блокирует: Claude Code показывает его stderr и применяет переключение, как описано в [Other exit codes](#other-exit-codes).3519Hook, который выходит с кодом, отличным от 0 или 2, и не выводит JSON решение, не блокирует: Claude Code показывает его stderr и применяет переключение, как описано в [Other exit codes](#other-exit-codes).

3516 3520 

3518 PostModelSwitch3522 PostModelSwitch

3519</h3>3523</h3>

3520 3524 

3521Запускается после изменения модели сеанса. Используйте это для предоставления руководства, специфичного для модели, без редактирования каждого CLAUDE.md, например инструкции на уровне организации, которая применяется на определенных моделях.3525Запускается после изменения модели сеанса. Используйте это для предоставления руководства, специфичного для модели, без редактирования каждого CLAUDE.md, например организационной инструкции, которая применяется на определенных моделях.

3522 3526 

3523PostModelSwitch требует Claude Code v2.1.251 или позже. Он не может блокировать, потому что модель уже изменилась. Claude Code запускает hooks PostModelSwitch после любого из этих изменений:3527PostModelSwitch требует Claude Code v2.1.251 или позже. Он не может блокировать, потому что модель уже изменилась. Claude Code запускает hooks PostModelSwitch после любого из этих изменений:

3524 3528 

3525* Переключение, которое вы или клиент запросили3529* Переключение, которое вы или клиент запросили

3526* [Automatic model fallback](/docs/ru/model-config#automatic-model-fallback), которое изменяет модель сеанса3530* [Автоматический fallback модели](/docs/ru/model-config#automatic-model-fallback), который изменяет модель сеанса

3527* Параметр, такой как [`opusplan`](/docs/ru/model-config#opusplan-model-setting), входящий или выходящий из режима плана3531* Параметр, такой как [`opusplan`](/docs/ru/model-config#opusplan-model-setting), входящий или выходящий из режима плана

3528* Claude Code восстанавливает модель при возобновлении сеанса3532* Claude Code восстанавливает модель при возобновлении сеанса

3529 3533 

3530Claude Code не запускает hooks PostModelSwitch, когда модель из [fallback model chain](/docs/ru/model-config#fallback-model-chains) служит ходу, потому что это замещение длится один ход и оставляет модель сеанса неизменной.3534Claude Code не запускает hooks PostModelSwitch, когда модель из [цепочки fallback модели](/docs/ru/model-config#fallback-model-chains) обслуживает ход, потому что эта замена длится один ход и оставляет модель сеанса неизменной.

3531 3535 

3532Matcher следует тем же правилам, что и [PreModelSwitch](#premodelswitch): Claude Code сравнивает его против канонического имени модели, на которую переключился сеанс.3536Matcher следует тем же правилам, что и [PreModelSwitch](#premodelswitch): Claude Code сравнивает его против канонического имени модели, на которую переключился сеанс.

3533 3537 

3551}3555}

3552```3556```

3553 3557 

3554Чтобы подтвердить, что hook работает, переключитесь на модель Opus из сеанса, работающего на другой модели, например запустите `/model opus` из сеанса Sonnet, затем попросите Claude, какое руководство оно имеет о текущей модели.3558Чтобы подтвердить, что hook работает, переключитесь на модель Opus из сеанса, работающего на другой модели, например запустите `/model opus` из сеанса Sonnet, затем спросите Claude, какое руководство оно имеет о текущей модели.

3555 3559 

3556<h4 id="postmodelswitch-input">3560<h4 id="postmodelswitch-input">

3557 PostModelSwitch input3561 Ввод PostModelSwitch

3558</h4>3562</h4>

3559 3563 

3560Hooks PostModelSwitch получают те же поля, что и [PreModelSwitch](#premodelswitch-input), с `hook_event_name`, установленным на `"PostModelSwitch"`, и двумя дополнительными значениями `source`: `"auto"` для автоматического fallback или другого изменения, которое Claude Code сделал самостоятельно, и `"resume"` для модели, восстановленной при возобновлении сеанса.3564Hooks PostModelSwitch получают те же поля, что и [PreModelSwitch](#premodelswitch-input), с `hook_event_name`, установленным на `"PostModelSwitch"`, и двумя дополнительными значениями `source`: `"auto"` для автоматического fallback или другого изменения, которое Claude Code сделал самостоятельно, и `"resume"` для модели, восстановленной при возобновлении сеанса.

3562`requested_model` имеет значение `null`, когда `source` имеет значение `"auto"`. Когда `source` имеет значение `"resume"`, это сохраненный параметр модели, который Claude Code восстановил.3566`requested_model` имеет значение `null`, когда `source` имеет значение `"auto"`. Когда `source` имеет значение `"resume"`, это сохраненный параметр модели, который Claude Code восстановил.

3563 3567 

3564<h4 id="postmodelswitch-decision-control">3568<h4 id="postmodelswitch-decision-control">

3565 PostModelSwitch decision control3569 Управление решением PostModelSwitch

3566</h4>3570</h4>

3567 3571 

3568Claude Code берет ваш вывод hook [plain-text stdout](#exit-code-0) при выходе 0 или `additionalContext` из JSON вывода и доставляет его Claude со следующим запросом после переключения. Помимо [JSON output fields](#json-output), доступных всем hooks, вы можете вернуть:3572Claude Code берет ваш [простой текст stdout](#exit-code-0) hook при выходе 0 или `additionalContext` из JSON-вывода и доставляет его Claude со следующим запросом после переключения. Помимо [полей JSON-вывода](#json-output), доступных всем hooks, вы можете вернуть:

3569 3573 

3570| Field | Description |3574| Поле | Описание |

3571| :------------------ | :----------------------------------------------------------------------------------------------------------------- |3575| :------------------ | :----------------------------------------------------------------------------------------------------------------- |

3572| `additionalContext` | Строка, добавленная в контекст Claude со следующим запросом. См. [Add context for Claude](#add-context-for-claude) |3576| `additionalContext` | Строка, добавленная в контекст Claude со следующим запросом. См. [Add context for Claude](#add-context-for-claude) |

3573 3577 

3574Если hook не завершится в течение пяти секунд после отправки следующей подсказки, Claude Code отправляет этот запрос без вывода и прикрепляет его к следующему запросу вместо этого. Если модель изменяется несколько раз перед следующим запросом, Claude Code доставляет только вывод для последнего переключения целевой модели.3578Если hook не завершится в течение пяти секунд после отправки следующей подсказки, Claude Code отправляет этот запрос без вывода и прикрепляет его к следующему запросу вместо этого. Если модель изменяется несколько раз перед следующим запросом, Claude Code доставляет только вывод для переключения целевой модели последнего.

3575 3579 

3576<h3 id="sessionend">3580<h3 id="sessionend">

3577 SessionEnd3581 SessionEnd

3581 3585 

3582Поле `reason` в ввод hook указывает, почему сеанс закончился:3586Поле `reason` в ввод hook указывает, почему сеанс закончился:

3583 3587 

3584| Reason | Description |3588| Причина | Описание |

3585| :---------------------------- | :-------------------------------------------------------------------------------------------- |3589| :---------------------------- | :-------------------------------------------------------------------------------------------------- |

3586| `clear` | Сеанс очищен с помощью команды `/clear` |3590| `clear` | Сеанс очищен с командой `/clear` |

3587| `resume` | Сеанс переключен через интерактивный `/resume` |3591| `resume` | Сеанс переключен через интерактивный `/resume` |

3588| `logout` | Пользователь вышел |3592| `logout` | Пользователь вышел |

3589| `prompt_input_exit` | Пользователь вышел, пока ввод подсказки был видимым |3593| `prompt_input_exit` | Пользователь вышел, пока ввод подсказки был видимым |

3590| `other` | Другие причины выхода |3594| `other` | Другие причины выхода |

3591| `bypass_permissions_disabled` | Удалено в v2.1.234; Claude Code не отправляет его. Удалите его из ваших matchers `SessionEnd` |3595| `bypass_permissions_disabled` | Удалено в версии 2.1.234; Claude Code не отправляет его. Удалите его из ваших matchers `SessionEnd` |

3592 3596 

3593<h4 id="sessionend-input">3597<h4 id="sessionend-input">

3594 SessionEnd input3598 Ввод SessionEnd

3595</h4>3599</h4>

3596 3600 

3597Помимо [common input fields](#common-input-fields), hooks SessionEnd получают поле `reason`, указывающее, почему сеанс закончился. См. таблицу [reason](#sessionend) выше для всех значений.3601Помимо [общих полей ввода](#common-input-fields), hooks SessionEnd получают поле `reason`, указывающее, почему сеанс закончился. См. [таблицу причин](#sessionend) выше для всех значений.

3598 3602 

3599```json theme={null}3603```json theme={null}

3600{3604{

3606}3610}

3607```3611```

3608 3612 

3609Hooks SessionEnd не имеют управления решением. Они не могут заблокировать завершение сеанса, но могут выполнять задачи очистки. Claude Code отбрасывает их [JSON output fields](#json-output), такие как `systemMessage`.3613Hooks SessionEnd не имеют управления решением. Они не могут блокировать завершение сеанса, но могут выполнять задачи очистки. Claude Code отбрасывает их [поля JSON-вывода](#json-output), такие как `systemMessage`.

3610 3614 

3611Hooks SessionEnd имеют стандартный timeout 1.5 секунды. Он применяется, когда вы выходите, запускаете `/clear` или переключаете сеансы с интерактивным `/resume`. Вы можете дать hook больше времени двумя способами:3615Hooks SessionEnd имеют тайм-аут по умолчанию 1.5 секунды. Он применяется, когда вы выходите, запускаете `/clear` или переключаете сеансы с интерактивным `/resume`. Вы можете дать hook больше времени двумя способами:

3612 3616 

3613* **Per-hook `timeout`**: установите `timeout` в конфигурации этого hook. Общий бюджет автоматически повышается, чтобы совпадать с наивысшим `timeout` для каждого hook в ваших файлах настроек, до 60 секунд. Если вы повышаете бюджет таким образом, hook без своего собственного `timeout` все еще сохраняет стандартный. Timeouts, установленные на hooks, предоставленные plugin, не повышают бюджет.3617* **Per-hook `timeout`**: установите `timeout` в конфигурации этого hook. Общий бюджет автоматически повышается, чтобы совпадать с наивысшим `timeout` per-hook в ваших файлах параметров, до 60 секунд. Если вы повышаете бюджет таким образом, hook без своего собственного `timeout` все еще сохраняет стандарт. Тайм-ауты, установленные на hooks, предоставленные плагином, не повышают бюджет.

3614* **`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`**: установите эту переменную окружения в миллисекундах для явного переопределения бюджета. Значение, которое вы установили, также становится timeout для каждого hook без своего собственного `timeout`.3618* **`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`**: установите эту переменную окружения в миллисекундах для явного переопределения бюджета. Значение, которое вы установили, также становится тайм-аутом для каждого hook без своего собственного `timeout`.

3615 3619 

3616Этот пример устанавливает бюджет на 5 секунд:3620Этот пример устанавливает бюджет на 5 секунд:

3617 3621 

3619CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=5000 claude3623CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=5000 claude

3620```3624```

3621 3625 

3622До версии 2.1.268, `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` повышал только общий бюджет, и hook без своего собственного `timeout` все еще отменялся после 1.5 секунды.3626До версии 2.1.268 `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` повышал только общий бюджет, и hook без своего собственного `timeout` все еще отменялся через 1.5 секунды.

3623 3627 

3624<h3 id="elicitation">3628<h3 id="elicitation">

3625 Elicitation3629 Elicitation

3627 3631 

3628Запускается, когда сервер MCP запрашивает ввод пользователя во время задачи. По умолчанию Claude Code показывает интерактивный диалог для ответа пользователя. Hooks могут перехватить этот запрос и ответить программно, полностью пропустив диалог.3632Запускается, когда сервер MCP запрашивает ввод пользователя во время задачи. По умолчанию Claude Code показывает интерактивный диалог для ответа пользователя. Hooks могут перехватить этот запрос и ответить программно, полностью пропустив диалог.

3629 3633 

3630Поле matcher совпадает с именем сервера MCP.3634Поле matcher совпадает с названием сервера MCP.

3631 3635 

3632<h4 id="elicitation-input">3636<h4 id="elicitation-input">

3633 Elicitation input3637 Ввод Elicitation

3634</h4>3638</h4>

3635 3639 

3636Помимо [common input fields](#common-input-fields), hooks Elicitation получают `mcp_server_name`, `message` и опциональные поля `mode`, `url`, `elicitation_id` и `requested_schema`.3640Помимо [общих полей ввода](#common-input-fields), hooks Elicitation получают `mcp_server_name`, `message` и опциональные `mode`, `url`, `elicitation_id` и `requested_schema` поля.

3637 3641 

3638Для запроса в режиме формы, наиболее распространенный случай:3642Для запроса в режиме формы, наиболее распространенный случай:

3639 3643 

3671```3675```

3672 3676 

3673<h4 id="elicitation-output">3677<h4 id="elicitation-output">

3674 Elicitation output3678 Вывод Elicitation

3675</h4>3679</h4>

3676 3680 

3677Чтобы ответить программно без показа диалога, верните JSON объект с `hookSpecificOutput`:3681Чтобы ответить программно без показа диалога, верните объект JSON с `hookSpecificOutput`:

3678 3682 

3679```json theme={null}3683```json theme={null}

3680{3684{

3688}3692}

3689```3693```

3690 3694 

3691| Field | Values | Description |3695| Поле | Значения | Описание |

3692| :-------- | :---------------------------- | :--------------------------------------------------------------------------------------------- |3696| :-------- | :---------------------------- | :--------------------------------------------------------------------------------------------- |

3693| `action` | `accept`, `decline`, `cancel` | Принять ли, отклонить или отменить запрос |3697| `action` | `accept`, `decline`, `cancel` | Принять ли, отклонить или отменить запрос |

3694| `content` | object | Значения полей формы для отправки. Используется только, когда `action` имеет значение `accept` |3698| `content` | object | Значения полей формы для отправки. Используется только, когда `action` имеет значение `accept` |

3695 3699 

3696Выход 2 отклоняет запрос. Claude Code не показывает ваше сообщение stderr нигде.3700Код выхода 2 отклоняет запрос. Claude Code не показывает ваше сообщение stderr нигде.

3697 3701 

3698Claude Code действует на `hookSpecificOutput` из JSON вывода hook Elicitation и отбрасывает `systemMessage` и `continue`.3702Claude Code действует на `hookSpecificOutput` из JSON-вывода hook Elicitation и отбрасывает `systemMessage` и `continue`.

3699 3703 

3700<h3 id="elicitationresult">3704<h3 id="elicitationresult">

3701 ElicitationResult3705 ElicitationResult

3702</h3>3706</h3>

3703 3707 

3704Запускается после ответа пользователя на запрос MCP. Hooks могут наблюдать, изменять или блокировать ответ перед его отправкой обратно на сервер MCP.3708Запускается после того, как пользователь ответит на запрос MCP. Hooks могут наблюдать, изменять или блокировать ответ перед его отправкой обратно на сервер MCP.

3705 3709 

3706Поле matcher совпадает с именем сервера MCP.3710Поле matcher совпадает с названием сервера MCP.

3707 3711 

3708<h4 id="elicitationresult-input">3712<h4 id="elicitationresult-input">

3709 ElicitationResult input3713 Ввод ElicitationResult

3710</h4>3714</h4>

3711 3715 

3712Помимо [common input fields](#common-input-fields), hooks ElicitationResult получают `mcp_server_name`, `action` и опциональные поля `mode`, `elicitation_id` и `content`.3716Помимо [общих полей ввода](#common-input-fields), hooks ElicitationResult получают `mcp_server_name`, `action` и опциональные `mode`, `elicitation_id` и `content` поля.

3713 3717 

3714```json theme={null}3718```json theme={null}

3715{3719{

3726```3730```

3727 3731 

3728<h4 id="elicitationresult-output">3732<h4 id="elicitationresult-output">

3729 ElicitationResult output3733 Вывод ElicitationResult

3730</h4>3734</h4>

3731 3735 

3732Чтобы переопределить ответ пользователя, верните JSON объект с `hookSpecificOutput`:3736Чтобы переопределить ответ пользователя, верните объект JSON с `hookSpecificOutput`:

3733 3737 

3734```json theme={null}3738```json theme={null}

3735{3739{

3741}3745}

3742```3746```

3743 3747 

3744| Field | Values | Description |3748| Поле | Значения | Описание |

3745| :-------- | :---------------------------- | :---------------------------------------------------------------------------------------------- |3749| :-------- | :---------------------------- | :---------------------------------------------------------------------------------------------- |

3746| `action` | `accept`, `decline`, `cancel` | Переопределяет действие пользователя |3750| `action` | `accept`, `decline`, `cancel` | Переопределяет действие пользователя |

3747| `content` | object | Переопределяет значения полей формы. Имеет смысл только, когда `action` имеет значение `accept` |3751| `content` | object | Переопределяет значения полей формы. Имеет смысл только, когда `action` имеет значение `accept` |

3748 3752 

3749Выход 2 блокирует ответ, изменяя эффективное действие на `decline`. Claude Code не показывает ваше сообщение stderr нигде.3753Код выхода 2 блокирует ответ, изменяя эффективное действие на `decline`. Claude Code не показывает ваше сообщение stderr нигде.

3750 3754 

3751Claude Code действует на `hookSpecificOutput` из JSON вывода hook ElicitationResult и отбрасывает `systemMessage` и `continue`.3755Claude Code действует на `hookSpecificOutput` из JSON-вывода hook ElicitationResult и отбрасывает `systemMessage` и `continue`.

3752 3756 

3753<h2 id="prompt-based-hooks">3757<h2 id="prompt-based-hooks">

3754 Prompt-based hooks3758 Prompt-based hooks

3759События, которые поддерживают все пять типов hook (`command`, `http`, `mcp_tool`, `prompt` и `agent`):3763События, которые поддерживают все пять типов hook (`command`, `http`, `mcp_tool`, `prompt` и `agent`):

3760 3764 

3761* `PermissionDenied`3765* `PermissionDenied`

3762* `PermissionRequest`

3763* `PostToolBatch`3766* `PostToolBatch`

3764* `PostToolUse`3767* `PostToolUse`

3765* `PostToolUseFailure`3768* `PostToolUseFailure`

3772* `UserPromptExpansion`3775* `UserPromptExpansion`

3773* `UserPromptSubmit`3776* `UserPromptSubmit`

3774 3777 

3778`PermissionRequest` поддерживает `command`, `http`, `mcp_tool` и `prompt` hooks, но не `agent` hooks. Если вы настроите agent hook на этом событии, Claude Code пропустит его и поток разрешений продолжится без изменений. Чтобы разрешить или отклонить из hook, верните [объект решения](#permissionrequest-decision-control) из command или HTTP hook.

3779 

3775События, которые поддерживают `command`, `http` и `mcp_tool` hooks, но не `prompt` или `agent`:3780События, которые поддерживают `command`, `http` и `mcp_tool` hooks, но не `prompt` или `agent`:

3776 3781 

3777* `ConfigChange`3782* `ConfigChange`

3904 Agent hooks являются экспериментальными. Поведение и конфигурация могут измениться в будущих выпусках. Для рабочих процессов в производстве предпочитайте [command hooks](#command-hook-fields).3909 Agent hooks являются экспериментальными. Поведение и конфигурация могут измениться в будущих выпусках. Для рабочих процессов в производстве предпочитайте [command hooks](#command-hook-fields).

3905</Warning>3910</Warning>

3906 3911 

3907Agent-based hooks (`type: "agent"`) похожи на prompt-based hooks, но с многооборотным доступом к инструментам. Вместо одного вызова LLM, agent hook порождает subagent, который может читать файлы, искать код и проверять кодовую базу для проверки условий. Agent hooks поддерживают те же события, что и prompt-based hooks.3912Agent-based hooks (`type: "agent"`) похожи на prompt-based hooks, но с многооборотным доступом к инструментам. Вместо одного вызова LLM, agent hook порождает subagent, который может читать файлы, искать код и проверять кодовую базу для проверки условий. Agent hooks поддерживают те же события, что и [prompt-based hooks](#prompt-based-hooks), за исключением `PermissionRequest`.

3908 3913 

3909<h3 id="how-agent-hooks-work">3914<h3 id="how-agent-hooks-work">

3910 How agent hooks work3915 How agent hooks work

Details

24 24 

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

26 26 

27Агентивный цикл питается двумя компонентами: [моделями](#models), которые рассуждают, и [инструментами](#tools), которые действуют. Claude Code служит **агентивной оболочкой** вокруг Claude: он предоставляет инструменты, управление контекстом и среду выполнения, которые превращают языковую модель в способного агента кодирования.27Агентивный цикл питается двумя компонентами: [моделями](#models), которые рассуждают, и [инструментами](#tools), которые действуют. Claude Code — это слой вокруг модели, который предоставляет инструменты и управляет контекстом, который видит модель. Этот окружающий слой — это то, что означает термин agentic harness.

28 28 

29<h3 id="models">29<h3 id="models">

30 Модели30 Модели

238 Прерывание и управление238 Прерывание и управление

239</h4>239</h4>

240 240 

241Вы можете перенаправить Claude в любой момент без ожидания завершения хода или начала заново:241Вы можете перенаправить Claude в любой момент без начала заново. Сделайте одно из следующего:

242 242 

243* **Нажмите `Esc`**, чтобы остановить Claude немедленно. Выполняемый вызов инструмента отменяется, и Claude ожидает вашей следующей инструкции. Если у вас есть сообщения в очереди, Claude Code [отправляет их далее](/docs/ru/interactive-mode#queue-messages-while-claude-works).243* **Нажмите `Esc`**, чтобы остановить Claude немедленно. Выполняемый вызов инструмента отменяется, и Claude ожидает вашей следующей инструкции. Если у вас есть сообщения в очереди, Claude Code [отправляет их далее](/docs/ru/interactive-mode#queue-messages-while-claude-works).

244* **Введите коррекцию и нажмите `Enter`**, чтобы отправить её без остановки выполняемого инструмента. Claude прочитает её, как только текущее действие завершится, и скорректирует свой подход перед тем, как решить следующий шаг.244* **Введите коррекцию и нажмите `Enter`** без остановки Claude. Сообщение отображается как поставленное в очередь над полем ввода. Если Claude выполняет вызовы инструментов, он прочитает сообщение, как только эти вызовы завершатся, в рамках того же хода, и скорректирует перед своим следующим шагом. [Поставьте сообщения в очередь, пока Claude работает](/docs/ru/interactive-mode#queue-messages-while-claude-works) охватывает, когда отправляются другие поставленные в очередь записи.

245 245 

246<h3 id="delegate-don’t-dictate">246<h3 id="delegate-don’t-dictate">

247 Делегируйте, не диктуйте247 Делегируйте, не диктуйте

Details

26| `Ctrl+X Ctrl+K` | Остановить все работающие [фоновые подагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) в этом сеансе и отключить [автоматические ответы артефактов](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own) на остаток сеанса. Нажмите дважды в течение 3 секунд для подтверждения | Управление подагентом |26| `Ctrl+X Ctrl+K` | Остановить все работающие [фоновые подагенты](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) в этом сеансе и отключить [автоматические ответы артефактов](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own) на остаток сеанса. Нажмите дважды в течение 3 секунд для подтверждения | Управление подагентом |

27| `Ctrl+D` | Выход из сеанса Claude Code | Первое нажатие показывает подсказку подтверждения, а второе нажатие в течение 800 мс завершает работу. Когда подсказка содержит текст, `Ctrl+D` удаляет символ после курсора |27| `Ctrl+D` | Выход из сеанса Claude Code | Первое нажатие показывает подсказку подтверждения, а второе нажатие в течение 800 мс завершает работу. Когда подсказка содержит текст, `Ctrl+D` удаляет символ после курсора |

28| `Ctrl+G` или `Ctrl+X Ctrl+E` | Открыть в текстовом редакторе по умолчанию | Отредактируйте свою подсказку или пользовательский ответ в текстовом редакторе по умолчанию. `Ctrl+X Ctrl+E` — это встроенное в readline сочетание. Включите **Show last response in external editor** в `/config`, чтобы добавить предыдущий ответ Claude в виде контекста с комментариями `#` выше вашей подсказки; Claude Code удаляет блок комментариев при сохранении |28| `Ctrl+G` или `Ctrl+X Ctrl+E` | Открыть в текстовом редакторе по умолчанию | Отредактируйте свою подсказку или пользовательский ответ в текстовом редакторе по умолчанию. `Ctrl+X Ctrl+E` — это встроенное в readline сочетание. Включите **Show last response in external editor** в `/config`, чтобы добавить предыдущий ответ Claude в виде контекста с комментариями `#` выше вашей подсказки; Claude Code удаляет блок комментариев при сохранении |

29| `Ctrl+L` | Перерисовка или очистка экрана | Принудительно выполняет полную перерисовку терминала, сохраняя ввод и историю разговора. Используйте это для восстановления, если дисплей становится искаженным или частично пустым. В [полноэкранном режиме](/docs/ru/fullscreen#clear-the-conversation) он также очищает экран, и вы можете прокрутить вверх, чтобы увидеть более ранние сообщения |29| `Ctrl+L` | Перерисовка экрана | Принудительно выполняет полную перерисовку терминала, сохраняя ввод и историю разговора. Используйте это для восстановления, если дисплей становится искаженным или частично пустым. См. [Очистить разговор](/docs/ru/fullscreen#clear-the-conversation) для полноэкранного режима |

30| `Ctrl+O` | Переключение средства просмотра стенограммы | Показывает подробное использование инструментов и выполнение с временной меткой и используемой моделью в каждом сообщении помощника. Также расширяет строки, которые по умолчанию сворачиваются, такие как вызовы MCP, отображаемые как одна строка `Called slack 3 times`, и [сообщения из ваших других сеансов](/docs/ru/cross-session-messaging#what-a-message-looks-like), отображаемые как предпросмотр в одну строку `Message from @<sender>` |30| `Ctrl+O` | Переключение средства просмотра стенограммы | Показывает подробное использование инструментов и выполнение с временной меткой и используемой моделью в каждом сообщении помощника. Также расширяет строки, которые по умолчанию сворачиваются, такие как вызовы MCP, отображаемые как одна строка `Called slack 3 times`, и [сообщения из ваших других сеансов](/docs/ru/cross-session-messaging#what-a-message-looks-like), отображаемые как предпросмотр в одну строку `Message from @<sender>` |

31| `Ctrl+R` | Поиск в истории команд в обратном порядке | Интерактивный поиск по предыдущим командам |31| `Ctrl+R` | Поиск в истории команд в обратном порядке | Интерактивный поиск по предыдущим командам |

32| `Ctrl+V` или `Cmd+V` (iTerm2) или `Alt+V` (Windows и WSL) | Вставить изображение из буфера обмена | Вставляет чип `[Image #N]` в позицию курсора, чтобы вы могли ссылаться на него позиционно в своей подсказке. На WSL привязаны оба `Ctrl+V` и `Alt+V`; используйте `Alt+V`, если ваш терминал перехватывает `Ctrl+V` |32| `Ctrl+V` или `Cmd+V` (iTerm2) или `Alt+V` (Windows и WSL) | Вставить изображение из буфера обмена | Вставляет чип `[Image #N]` в позицию курсора, чтобы вы могли ссылаться на него позиционно в своей подсказке. На WSL привязаны оба `Ctrl+V` и `Alt+V`; используйте `Alt+V`, если ваш терминал перехватывает `Ctrl+V` |

42| `Ctrl+Enter` или `Ctrl+X Ctrl+S` | Отправить очередные сообщения сейчас | Прерывает текущий ход, чтобы ваши [очередные сообщения](#queue-messages-while-claude-works) и ваш черновик с ними отправились сразу же, а не когда ход закончится. В [режиме shell](#shell-mode-with-prefix) клавиша ставит вашу команду в очередь без прерывания. В терминалах, которые не сообщают о расширенных клавишах, `Ctrl+Enter` приходит как простой `Enter`; `Ctrl+X Ctrl+S` работает в любом терминале. Требует Claude Code v2.1.275 или более поздней версии |42| `Ctrl+Enter` или `Ctrl+X Ctrl+S` | Отправить очередные сообщения сейчас | Прерывает текущий ход, чтобы ваши [очередные сообщения](#queue-messages-while-claude-works) и ваш черновик с ними отправились сразу же, а не когда ход закончится. В [режиме shell](#shell-mode-with-prefix) клавиша ставит вашу команду в очередь без прерывания. В терминалах, которые не сообщают о расширенных клавишах, `Ctrl+Enter` приходит как простой `Enter`; `Ctrl+X Ctrl+S` работает в любом терминале. Требует Claude Code v2.1.275 или более поздней версии |

43| `Shift+Tab`, или `Alt+M` на Windows, когда среда выполнения Node или Bun не включает режим ввода VT | Циклический переход по режимам разрешений | Циклический переход через `default` (помечено как Manual в индикаторе режима), `acceptEdits`, `plan` и, если доступно, `bypassPermissions` и затем `auto`. Из `auto` первое нажатие переключается на `default`. См. [режимы разрешений](/docs/ru/permission-modes). На подсказке разрешения файла то же самое ключевое слово закрывает открытое [поле комментария](/docs/ru/permissions#add-a-comment-when-you-answer-a-permission-prompt). Без открытого поля выбирает параметр, который разрешает действие на остаток сеанса, когда подсказка предлагает этот параметр |43| `Shift+Tab`, или `Alt+M` на Windows, когда среда выполнения Node или Bun не включает режим ввода VT | Циклический переход по режимам разрешений | Циклический переход через `default` (помечено как Manual в индикаторе режима), `acceptEdits`, `plan` и, если доступно, `bypassPermissions` и затем `auto`. Из `auto` первое нажатие переключается на `default`. См. [режимы разрешений](/docs/ru/permission-modes). На подсказке разрешения файла то же самое ключевое слово закрывает открытое [поле комментария](/docs/ru/permissions#add-a-comment-when-you-answer-a-permission-prompt). Без открытого поля выбирает параметр, который разрешает действие на остаток сеанса, когда подсказка предлагает этот параметр |

44| `Option+P` (macOS) или `Alt+P` (Windows/Linux) | Переключение модели | Переключение моделей без очистки подсказки |44| `Option+P` (macOS) или `Alt+P` (Windows/Linux) | Переключение модели | Переключение моделей без очистки подсказки |

45| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключение расширенного мышления | Включение или отключение режима расширенного мышления. Не влияет на Fable 5.1 или Fable 5, которые всегда используют расширенное мышление. Работает на macOS без настройки Option как Meta |45| `Option+T` (macOS) или `Alt+T` (Windows/Linux) | Переключение расширенного мышления | Включение или отключение режима расширенного мышления. Не влияет на Opus 5.5 или модели Fable, которые всегда используют расширенное мышление. Работает на macOS без настройки Option как Meta |

46| `Option+O` (macOS) или `Alt+O` (Windows/Linux) | Переключение быстрого режима | Включение или отключение [быстрого режима](/docs/ru/fast-mode) |46| `Option+O` (macOS) или `Alt+O` (Windows/Linux) | Переключение быстрого режима | Включение или отключение [быстрого режима](/docs/ru/fast-mode) |

47 47 

48<h3 id="text-editing">48<h3 id="text-editing">

593 593 

594Чтобы узнать, что произошло, запустите `claude --debug` с включенной проверкой орфографии и введите слово. Затем найдите строки `[spellcheck]` в журнале отладки в `~/.claude/debug/<session-id>.txt`. Одна строка называет программу, которую запустил Claude Code, или перечисляет те, которые он искал и не нашел. Более поздние строки говорят, почему он остановился. Ошибка отсутствующего словаря там означает, что checker не имеет словаря для вашего значения `language`, или нет словаря по умолчанию, когда `language` не установлен. Установите один или установите `language` на словарь, который у вас есть.594Чтобы узнать, что произошло, запустите `claude --debug` с включенной проверкой орфографии и введите слово. Затем найдите строки `[spellcheck]` в журнале отладки в `~/.claude/debug/<session-id>.txt`. Одна строка называет программу, которую запустил Claude Code, или перечисляет те, которые он искал и не нашел. Более поздние строки говорят, почему он остановился. Ошибка отсутствующего словаря там означает, что checker не имеет словаря для вашего значения `language`, или нет словаря по умолчанию, когда `language` не установлен. Установите один или установите `language` на словарь, который у вас есть.

595 595 

596<h2 id="invisible-characters-in-prompts">

597 Невидимые символы в подсказках

598</h2>

599 

600Вставленный текст может содержать символы Unicode, которые терминал не отображает вообще, такие как символы тегов, двунаправленные управляющие символы и пробелы нулевой ширины, поэтому подсказка может содержать текст, который вы никогда не видите. Чтобы скопированный текст не содержал инструкций, которые ваш терминал не отображает, Claude Code удаляет эти символы при нажатии Enter, прежде чем что-либо отправлять. Он очищает как саму подсказку, так и содержимое любой свёрнутой [ссылки на вставленный текст](/docs/ru/terminal-config#paste-large-content), которую включает подсказка. Claude Code сохраняет соединители, которые используют персидский и индийский шрифты, а также селекторы внутри последовательностей эмодзи.

601 

602Если Claude Code что-то удалил, то нажатие Enter ничего не отправляет. Очищенная подсказка возвращается в поле ввода с уведомлением, например `Удалено 3 невидимых символа · просмотрите и нажмите Enter для отправки`, и повторное нажатие Enter отправляет текст в том виде, в котором он показан.

603 

604Когда вы передаёте подсказку в командной строке, например `claude "fix the login bug"`, или передаёте её в интерактивный сеанс, Claude Code не ждёт второго нажатия Enter. Он удаляет символы, показывает уведомление и отправляет очищенную подсказку. Если очищенная подсказка начинается с `/`, Claude Code помещает её в поле ввода для вашего просмотра и отправки.

605 

596<h2 id="review-changes-with-/diff">606<h2 id="review-changes-with-/diff">

597 Просмотр изменений с помощью /diff607 Просмотр изменений с помощью /diff

598</h2>608</h2>

keybindings.md +30 −4

Details

114| Действие | По умолчанию | Описание |114| Действие | По умолчанию | Описание |

115| :-------------------- | :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |115| :-------------------- | :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

116| `chat:cancel` | Escape | Отменить текущий ввод |116| `chat:cancel` | Escape | Отменить текущий ввод |

117| `chat:clearInput` | Ctrl+L | Принудительно перерисовать весь экран, сохраняя ввод и разговор. В [полноэкранном рендеринге](/docs/ru/fullscreen#clear-the-conversation) также очистить экран |117| `chat:clearInput` | Ctrl+L | Принудительно перерисовать весь экран, сохраняя ввод и разговор |

118| `chat:clearScreen` | Cmd+K | То же, что `chat:clearInput`. См. [Очистить разговор](/docs/ru/fullscreen#clear-the-conversation) для информации о поведении Cmd+K в iTerm2 и Terminal.app |118| `chat:clearScreen` | Cmd+K | То же, что `chat:clearInput`. См. [Очистить разговор](/docs/ru/fullscreen#clear-the-conversation) для информации о поведении Cmd+K в iTerm2 и Terminal.app |

119| `chat:killAgents` | Ctrl+X Ctrl+K | Остановить всех работающих [фоновых подагентов](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) в этом сеансе и отключить [автоматические ответы артефактов](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own) на остаток сеанса |119| `chat:killAgents` | Ctrl+X Ctrl+K | Остановить всех работающих [фоновых подагентов](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) в этом сеансе и отключить [автоматические ответы артефактов](/docs/ru/artifacts#let-claude-reply-to-comments-on-its-own) на остаток сеанса |

120| `chat:cycleMode` | Shift+Tab\* | Циклический перебор режимов разрешений |120| `chat:cycleMode` | Shift+Tab\* | Циклический перебор режимов разрешений |

153 153 

154| Действие | По умолчанию | Описание |154| Действие | По умолчанию | Описание |

155| :---------------------- | :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |155| :---------------------- | :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

156| `confirm:yes` | Y, Enter | Подтвердить действие |156| `confirm:yes` | Enter | Подтвердить действие |

157| `confirm:no` | N, Escape | Отклонить действие |157| `confirm:no` | Escape | Отклонить действие |

158| `confirm:previous` | Up | Предыдущий вариант |158| `confirm:previous` | Up | Предыдущий вариант |

159| `confirm:next` | Down | Следующий вариант |159| `confirm:next` | Down | Следующий вариант |

160| `confirm:nextField` | Tab | Следующее поле |160| `confirm:nextField` | Tab | Следующее поле |

166 166 

167До v2.1.257 действие `confirm:toggleExplanation`, привязанное к `Ctrl+E` по умолчанию, показывало сгенерированное моделью объяснение команды в подсказках разрешений Bash и PowerShell.167До v2.1.257 действие `confirm:toggleExplanation`, привязанное к `Ctrl+E` по умолчанию, показывало сгенерированное моделью объяснение команды в подсказках разрешений Bash и PowerShell.

168 168 

169Диалоги используют `confirm:yes` и `confirm:no` для принятия и отмены даже когда они не задают вопрос да или нет. Если вы привяжете простую букву, такую как `y` или `n`, в этом контексте, буква также действует на диалоги, которые никогда не показывают её как клавишу. Диалог, который показывает `y` и `n` как его клавиши, читает эти буквы сам и не требует привязки.

170 

171Этот пример привязывает `y` к `confirm:yes` и `n` к `confirm:no`:

172 

173```json theme={null}

174{

175 "bindings": [

176 {

177 "context": "Confirmation",

178 "bindings": {

179 "y": "confirm:yes",

180 "n": "confirm:no"

181 }

182 }

183 ]

184}

185```

186 

187До v2.1.280 `y` также была привязана к `confirm:yes` и `n` к `confirm:no` по умолчанию. Если вы создали свой `keybindings.json` с помощью `/keybindings` до v2.1.280, файл содержит обе привязки и они остаются в силе, пока вы не удалите эти две строки.

188 

169<h3 id="permission-actions">189<h3 id="permission-actions">

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

171</h3>191</h3>

275| `footer:clearSelection` | Escape | Очистить выбор нижнего колонтитула |295| `footer:clearSelection` | Escape | Очистить выбор нижнего колонтитула |

276| `footer:dismiss` | Backspace, Delete | Удалить выбранную ссылку [артефакта](/docs/ru/artifacts) из нижнего колонтитула; сам опубликованный артефакт не затронут. На других строках нижнего колонтитула эти клавиши не имеют эффекта. Требует v2.1.217 или более позднюю версию |296| `footer:dismiss` | Backspace, Delete | Удалить выбранную ссылку [артефакта](/docs/ru/artifacts) из нижнего колонтитула; сам опубликованный артефакт не затронут. На других строках нижнего колонтитула эти клавиши не имеют эффекта. Требует v2.1.217 или более позднюю версию |

277 297 

298Пока элемент нижнего колонтитула выбран, например строка в панели агента ниже подсказки, `Enter` открывает его даже если вы переназначили `Enter` в контексте `Chat` на `chat:queueSubmit` или `chat:newline`.

299 

300Привязки `Chat` на клавишах, которые контекст `Footer` не привязывает, такие как `Shift+Tab` для `chat:cycleMode`, продолжают работать пока элемент выбран.

301 

278<h3 id="message-selector-actions">302<h3 id="message-selector-actions">

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

280</h3>304</h3>

370| `select:accept` | Enter | Принять выбор |394| `select:accept` | Enter | Принять выбор |

371| `select:cancel` | Escape | Отменить выбор |395| `select:cancel` | Escape | Отменить выбор |

372 396 

373Claude Code применяет ваши привязки `select:pageUp`, `select:pageDown`, `select:first` и `select:last` в меню `/skills`. В большинстве других списков, таких как выбор модели `/model`, Claude Code разбивает на страницы с помощью PageUp и PageDown независимо от ваших привязок и игнорирует Home и End.397Claude Code применяет ваши привязки `select:pageUp`, `select:pageDown`, `select:first` и `select:last` в меню `/skills`. В большинстве других списков, таких как выбор модели `/model`, ваши привязки `select:first` и `select:last` применяются. PageUp и PageDown разбивают на страницы параметры в этих списках независимо от ваших привязок.

398 

399До v2.1.280 эти другие списки игнорировали Home, End и ваши привязки `select:first` и `select:last`.

374 400 

375<h3 id="plugin-actions">401<h3 id="plugin-actions">

376 Действия plugin402 Действия plugin

Details

255 255 

256Это особенно полезно для [изоляции worktree подагента](/docs/ru/worktrees#isolate-subagents-with-worktrees). Подагенты — это параллельные экземпляры Claude, порождённые для подзадач, и каждый, который работает в worktree, получает лёгкий checkout вместо полного дерева. Все worktrees в сеансе используют одни и те же `sparsePaths`, поэтому если один подагент нуждается в `packages/api/` и другой нуждается в `packages/web/`, перечислите оба.256Это особенно полезно для [изоляции worktree подагента](/docs/ru/worktrees#isolate-subagents-with-worktrees). Подагенты — это параллельные экземпляры Claude, порождённые для подзадач, и каждый, который работает в worktree, получает лёгкий checkout вместо полного дерева. Все worktrees в сеансе используют одни и те же `sparsePaths`, поэтому если один подагент нуждается в `packages/api/` и другой нуждается в `packages/web/`, перечислите оба.

257 257 

258Перечислите каталоги в `sparsePaths`, а не отдельные файлы. Файлы на уровне корня, такие как `package.json`, `tsconfig.base.json` и файлы блокировки, всегда проверяются наряду с каталогами, которые вы перечисляете. Каталоги на уровне корня нет, поэтому включите `.claude` в список, если вы хотите, чтобы `.claude/settings.json`, `.claude/rules/` или `.claude/skills/` корня репозитория были доступны внутри worktree.258Перечислите каталоги в `sparsePaths`, а не отдельные файлы. Файлы на уровне корня, такие как `package.json`, `tsconfig.base.json` и файлы блокировки, всегда проверяются наряду с каталогами, которые вы перечисляете. Каталоги на уровне корня нет, поэтому включите `.claude` в список, если вы хотите, чтобы `.claude/settings.json` или `.claude/rules/` корня репозитория были доступны внутри worktree. Для project skills, agents и commands см. [What worktrees share with the main checkout](/docs/ru/worktrees#what-worktrees-share-with-the-main-checkout).

259 259 

260Разреженный checkout требует, чтобы git включил `extensions.worktreeConfig` в общем файле `.git/config` репозитория, пока существует разреженный worktree. Claude Code удаляет эту запись после удаления последнего worktree, но только если Claude Code её добавил. Он никогда не удаляет значение, которое вы установили сами. До версии 2.1.207 запись оставалась после удаления последнего worktree, и инструменты на основе go-git, такие как `tea`, не могли открыть репозиторий, пока вы не запустили `git config --unset extensions.worktreeConfig`.260Разреженный checkout требует, чтобы git включил `extensions.worktreeConfig` в общем файле `.git/config` репозитория, пока существует разреженный worktree. Claude Code удаляет эту запись после удаления последнего worktree, но только если Claude Code её добавил. Он никогда не удаляет значение, которое вы установили сами. До версии 2.1.207 запись оставалась после удаления последнего worktree, и инструменты на основе go-git, такие как `tea`, не могли открыть репозиторий, пока вы не запустили `git config --unset extensions.worktreeConfig`.

261 261 

Details

578Это наиболее распространенные ошибки при запуске Claude Code через шлюз, с причиной на стороне шлюза и исправлением:578Это наиболее распространенные ошибки при запуске Claude Code через шлюз, с причиной на стороне шлюза и исправлением:

579 579 

580| Ошибка | Причина | Исправление |580| Ошибка | Причина | Исправление |

581| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |581| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

582| Предупреждение при запуске, называющее два источника учетных данных и заканчивающееся на `auth may not work as expected`. Более старые версии показывают `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` вместо этого. | Учетные данные шлюза и сохраненный вход оба активны; переменная используется для запросов, но устаревший вход может вызвать неожиданное поведение аутентификации | Отмените установку переменной, чтобы использовать сохраненный вход, или запустите `/logout`, чтобы использовать учетные данные шлюза |582| Предупреждение при запуске, называющее два источника учетных данных и заканчивающееся на `auth may not work as expected`. Более старые версии показывают `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` вместо этого. | Учетные данные шлюза и сохраненный вход оба активны; переменная используется для запросов, но устаревший вход может вызвать неожиданное поведение аутентификации | Отмените установку переменной, чтобы использовать сохраненный вход, или запустите `/logout`, чтобы использовать учетные данные шлюза |

583| Ошибки `401`, называющие недействительный или неузнанный токен | Учетные данные не являются теми, которые выдал шлюз, или они находятся в заголовке, который шлюз не читает | Подтвердите, что переменная соответствует вашему типу учетных данных в [таблице учетных данных](#set-the-credential-variable), и переустановите ключ на шлюзе, если он был отозван |583| Ошибки `401`, называющие недействительный или неузнанный токен | Учетные данные не являются теми, которые выдал шлюз, или они находятся в заголовке, который шлюз не читает | Подтвердите, что переменная соответствует вашему типу учетных данных в [таблице учетных данных](#set-the-credential-variable), и переустановите ключ на шлюзе, если он был отозван |

584| `Your apiKeyHelper script is failing`, или `apiKeyHelper failed:` на stderr в неинтерактивном режиме | Команда в параметре [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) не выдала пригодный ключ, поэтому запросы содержат заполнитель ключа | Запустите команду напрямую, чтобы увидеть, почему она не работает, и повторно аутентифицируйтесь у поставщика учетных данных, если он сообщает об истекшем сеансе; см. [справочник по ошибкам](/docs/ru/errors#your-apikeyhelper-script-is-failing) |584| `Your apiKeyHelper script is failing`, или `apiKeyHelper failed:` на stderr в неинтерактивном режиме | Команда в параметре [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) не выдала пригодный ключ, поэтому запросы содержат заполнитель ключа | Запустите команду напрямую, чтобы увидеть, почему она не работает, и повторно аутентифицируйтесь у поставщика учетных данных, если он сообщает об истекшем сеансе; см. [справочник по ошибкам](/docs/ru/errors#your-apikeyhelper-script-is-failing) |

588| Ошибки `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` |588| Ошибки `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` |

589| Ошибки `400`, указывающие контекст или лимит токена в собственных словах шлюза, такие как `ContextWindowExceededError` или `prompt token count of N exceeds the limit of M` | Шлюз применяет меньший контекст, чем собственное окно модели, и переписывает ошибку вышестоящего, поэтому Claude Code не распознает это как [слишком длинную ошибку](/docs/ru/errors#prompt-is-too-long) и не выполняет автоматическое сжатие и повтор | Запустите `/compact`, чтобы восстановить сеанс. Чтобы предотвратить это, установите `CLAUDE_CODE_AUTO_COMPACT_WINDOW` на лимит шлюза; Claude Code зажимает значение как минимум на 100 000 токенов и максимум на контекстное окно модели, поэтому лимит шлюза ниже 100 000 не может быть согласован, и `/compact` остается восстановлением там. Также установите `CLAUDE_CODE_MAX_OUTPUT_TOKENS` ниже лимита вывода модели шлюза |589| Ошибки `400`, указывающие контекст или лимит токена в собственных словах шлюза, такие как `ContextWindowExceededError` или `prompt token count of N exceeds the limit of M` | Шлюз применяет меньший контекст, чем собственное окно модели, и переписывает ошибку вышестоящего, поэтому Claude Code не распознает это как [слишком длинную ошибку](/docs/ru/errors#prompt-is-too-long) и не выполняет автоматическое сжатие и повтор | Запустите `/compact`, чтобы восстановить сеанс. Чтобы предотвратить это, установите `CLAUDE_CODE_AUTO_COMPACT_WINDOW` на лимит шлюза; Claude Code зажимает значение как минимум на 100 000 токенов и максимум на контекстное окно модели, поэтому лимит шлюза ниже 100 000 не может быть согласован, и `/compact` остается восстановлением там. Также установите `CLAUDE_CODE_MAX_OUTPUT_TOKENS` ниже лимита вывода модели шлюза |

590| Ошибки `400` на каждом запросе, в собственных словах шлюза отклоняющие входную схему инструмента или его `pattern`, на Claude Code v2.1.265 через v2.1.267 | При постепенном развертывании на этих версиях схема [инструмента Artifact](/docs/ru/artifacts#availability) содержит регулярное выражение с классами символов Unicode `\p{...}`. API Anthropic его принимает, но шлюз или вышестоящий, который проверяет `pattern` каждой схемы инструмента с помощью собственного механизма regex, отклоняет весь запрос | Обновитесь до v2.1.268 или позже, которая не отправляет регулярное выражение. На затронутой версии [отключите артефакты](/docs/ru/artifacts#disable-artifacts), что удаляет инструмент и его схему из запросов |590| Ошибки `400` на каждом запросе, в собственных словах шлюза отклоняющие входную схему инструмента или его `pattern`, на Claude Code v2.1.265 через v2.1.267 | При постепенном развертывании на этих версиях схема [инструмента Artifact](/docs/ru/artifacts#availability) содержит регулярное выражение с классами символов Unicode `\p{...}`. API Anthropic его принимает, но шлюз или вышестоящий, который проверяет `pattern` каждой схемы инструмента с помощью собственного механизма regex, отклоняет весь запрос | Обновитесь до v2.1.268 или позже, которая не отправляет регулярное выражение. На затронутой версии [отключите артефакты](/docs/ru/artifacts#disable-artifacts), что удаляет инструмент и его схему из запросов |

591| Ошибки `400` на каждом запросе, в собственных словах шлюза отклоняющие неузнанный тип инструмента, такие как `Input tag 'advisor_20260301'`, на Claude Code v2.1.275 | При постепенном развертывании на этой версии запросы содержат запись [инструмента advisor](/docs/ru/advisor) даже с отключенным advisor. API Anthropic его принимает, но шлюз или вышестоящий, который проверяет типы инструментов, отклоняет весь запрос; тот, который [пересылает поля тела запроса без изменений](/docs/ru/llm-gateway-protocol#forward-as-open-lists), пропускает его без влияния. Запись является объявлением, которое не содержит содержимого разговора | Обновитесь до v2.1.276 или позже, которая не отправляет запись за шлюзом `ANTHROPIC_BASE_URL`, если вы не включите advisor. На v2.1.275 установите [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`](/docs/ru/env-vars), что удаляет запись из запросов |

591| Модели отсутствуют в средстве выбора `/model` | Имена моделей шлюза отсутствуют во встроенном списке Claude Code, или Claude Code показывает [`modelPicker`](/docs/ru/settings-reference#modelpicker) набор, который заменяет встроенные параметры | Включите [обнаружение модели шлюза](#add-gateway-models-to-the-model-picker) или добавьте имена с переменными [конфигурации модели](/docs/ru/model-config). Если Claude Code показывает заменяющий набор `modelPicker`, добавьте модели шлюза в него, или попросите администратора добавить их, когда управляемые параметры его предоставляют |592| Модели отсутствуют в средстве выбора `/model` | Имена моделей шлюза отсутствуют во встроенном списке Claude Code, или Claude Code показывает [`modelPicker`](/docs/ru/settings-reference#modelpicker) набор, который заменяет встроенные параметры | Включите [обнаружение модели шлюза](#add-gateway-models-to-the-model-picker) или добавьте имена с переменными [конфигурации модели](/docs/ru/model-config). Если Claude Code показывает заменяющий набор `modelPicker`, добавьте модели шлюза в него, или попросите администратора добавить их, когда управляемые параметры его предоставляют |

592| `/fast` сообщает `Fast mode unavailable due to network connectivity issues` в то время как запросы вывода работают | Проверка доступности [быстрого режима](/docs/ru/fast-mode) идет непосредственно на `api.anthropic.com` и не следует `ANTHROPIC_BASE_URL`, поэтому заблокированный прямой исходящий трафик не проходит проверку. То же сообщение появляется в открытой сети, когда проверка представляет ключ, выданный шлюзом, из `ANTHROPIC_API_KEY` или `apiKeyHelper`, и Anthropic его отклоняет | Добавьте в список разрешений `api.anthropic.com`, если исходящий трафик заблокирован, или установите переменную пропуска; для отклоненного ключа шлюза помогают только переменные пропуска. См. [использование быстрого режима за прокси и LLM шлюзами](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |593| `/fast` сообщает `Fast mode unavailable due to network connectivity issues` в то время как запросы вывода работают | Проверка доступности [быстрого режима](/docs/ru/fast-mode) идет непосредственно на `api.anthropic.com` и не следует `ANTHROPIC_BASE_URL`, поэтому заблокированный прямой исходящий трафик не проходит проверку. То же сообщение появляется в открытой сети, когда проверка представляет ключ, выданный шлюзом, из `ANTHROPIC_API_KEY` или `apiKeyHelper`, и Anthropic его отклоняет | Добавьте в список разрешений `api.anthropic.com`, если исходящий трафик заблокирован, или установите переменную пропуска; для отклоненного ключа шлюза помогают только переменные пропуска. См. [использование быстрого режима за прокси и LLM шлюзами](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

593| `/fast` сообщает `Fast mode has been disabled by your organization` в сеансе, аутентифицированном с помощью `ANTHROPIC_AUTH_TOKEN`, даже если организация имеет включенный быстрый режим | Проверка доступности требует входа claude.ai или ключа API Anthropic; только с токеном-носителем Claude Code рассматривает быстрый режим как отключенный без отправки проверки | Установите `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; см. [использование быстрого режима за прокси и LLM шлюзами](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |594| `/fast` сообщает `Fast mode has been disabled by your organization` в сеансе, аутентифицированном с помощью `ANTHROPIC_AUTH_TOKEN`, даже если организация имеет включенный быстрый режим | Проверка доступности требует входа claude.ai или ключа API Anthropic; только с токеном-носителем Claude Code рассматривает быстрый режим как отключенный без отправки проверки | Установите `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; см. [использование быстрого режима за прокси и LLM шлюзами](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) |

Details

144 144 

145Если ваши разработчики установили `ANTHROPIC_CUSTOM_HEADERS`, эти заголовки также появляются в запросах.145Если ваши разработчики установили `ANTHROPIC_CUSTOM_HEADERS`, эти заголовки также появляются в запросах.

146 146 

147<h3 id="gateway-hint-headers">

148 Заголовки подсказок Gateway

149</h3>

150 

151Claude Code также может отправлять подсказки маршрутизации: факты для каждого запроса, которые gateway или маршрутизатор может использовать для планирования, кэширования или отнесения запроса. Требуется Claude Code v2.1.273 или позже.

152 

153Наличие их в запросе зависит от того, куда Claude Code его отправляет:

154 

155* Прямое подключение к API Anthropic: отправляются по умолчанию

156* Пользовательский базовый URL: отключено по умолчанию, потому что прокси, который отклоняет неизвестные заголовки, приведет к отказу запроса. Чтобы их получить, установите [`CLAUDE_CODE_GATEWAY_HINT_HEADERS=1`](/docs/ru/env-vars) для ваших разработчиков, например в блоке `env` [управляемых параметров](/docs/ru/managed-settings)

157* Любой другой backend, включая Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform on AWS: отправляются только когда установлено `CLAUDE_CODE_GATEWAY_HINT_HEADERS=1`

158 

159Установка `CLAUDE_CODE_GATEWAY_HINT_HEADERS` на `0` останавливает заголовки на каждом подключении.

160 

161Заголовки содержат только то, что указано в строках ниже: фиксированные словари, имена инструментов и длительности, никогда текст подсказки или содержимое файлов. Каждое значение — это печатаемый ASCII.

162 

163| Заголовок | Описание |

164| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

165| `x-claude-code-request-class` | Какой тип запроса это: `main` для хода основного разговора, `subagent` для хода [подагента](/docs/ru/sub-agents), `workflow` для агента, работающего внутри workflow, `compaction` для запроса суммирования, который компактирует разговор, или `auxiliary` для побочных запросов, таких как названия сеансов, классификаторы и резюме. Отправляется на каждом запросе |

166| `x-claude-code-agent-type` | Тип подагента, который выдал запрос: встроенное имя типа агента, такое как `Explore`, `Plan` или `general-purpose`, или `custom` для определяемого пользователем агента, `teammate` для члена [команды агентов](/docs/ru/agent-teams), работающего в процессе лидера, или `fork` для [ветвления](/docs/ru/sub-agents#fork-the-current-conversation) текущего разговора. Присутствует только на собственных ходах подагента; запросы компактирования или побочные запросы подагента сохраняют идентификатор агента, но не содержат тип. Имя агента, выбранное пользователем, никогда не отправляется |

167| `x-claude-code-compaction` | Присутствует в запросе, который суммирует разговор во время [компактирования](/docs/ru/prompt-caching#compacting-the-conversation). Значение говорит, что его вызвало: `auto` когда окно контекста приближалось к емкости, `manual` для `/compact`, или `reactive` когда API отклонил запрос как слишком длинный. Отсутствует на каждом другом запросе |

168| `x-claude-code-context-compacted` | Присутствует один раз, на первом запросе основного разговора после компактирования, с теми же значениями, что и `x-claude-code-compaction`. Префикс разговора перед этим запросом больше не используется, поэтому кэш, основанный на нем, может быть удален |

169| `x-claude-code-prev-tool-durations` | Измеренное время выполнения вызовов инструментов, результаты которых содержит этот запрос, как `<name>=<ms>;<name>=<ms>`, например `Bash=742;Read=9`. Отправляется на следующем запросе того же разговора после пакета вызовов инструментов, из основного сеанса или подагента |

170 

171Перед анализом `x-claude-code-prev-tool-durations` проверьте, как Claude Code строит значение и что оно опускает:

172 

173* Записи: одна на каждый выполненный вызов инструмента, в порядке сбора его результата, в целых миллисекундах

174* Ограничение: Claude Code отправляет максимум 32 записи и 4 КБ, сохраняя первые записи

175* Кодирование: имена инструментов кодируются в процентах, охватывая `%`, `;`, `=`, запятую, пробел и любой символ вне печатаемого ASCII

176* Анализ: разделите на `;`, затем на `=`, и декодируйте каждое имя

177* Отсутствие: вызовы компактирования, побочные запросы и первый запрос нового подсказки никогда его не содержат. Не читайте отсутствующий заголовок как ход, который не запустил никакие инструменты

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

179 

147<h3 id="forward-as-open-lists">180<h3 id="forward-as-open-lists">

148 Пересылка как открытые списки181 Пересылка как открытые списки

149</h3>182</h3>

221 254 

222* Когда вышестоящий сервер отклоняет поле `thinking`, системное сообщение в середине разговора или маркер `cache_control` на таком сообщении, Claude Code повторяет запрос и отключает отклоненную возможность для остальной части разговора255* Когда вышестоящий сервер отклоняет поле `thinking`, системное сообщение в середине разговора или маркер `cache_control` на таком сообщении, Claude Code повторяет запрос и отключает отклоненную возможность для остальной части разговора

223* Когда вышестоящий сервер отклоняет [подпись мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking), включая ошибку `400`, сообщение которой говорит, что блок `bound to a different conversation`, Claude Code удаляет более ранние блоки мышления из запроса, повторяет и исключает их из каждого последующего запроса. Новые ответы по-прежнему включают мышление256* Когда вышестоящий сервер отклоняет [подпись мышления](https://platform.claude.com/docs/en/build-with-claude/extended-thinking), включая ошибку `400`, сообщение которой говорит, что блок `bound to a different conversation`, Claude Code удаляет более ранние блоки мышления из запроса, повторяет и исключает их из каждого последующего запроса. Новые ответы по-прежнему включают мышление

257* Когда шлюз или его вышестоящий сервер отклоняет запись [инструмента-советника](/docs/ru/advisor) в `tools` как неизвестный тип инструмента, Claude Code повторяет запрос один раз без этой записи и ее значения `anthropic-beta`. Более поздние запросы к этому базовому URL оставляют советника без внимания до выхода Claude Code, и `/advisor` недоступен разработчику в течение этого времени. Claude Code распознает это отклонение по ответу `400` или `422`, сообщение которого называет тип инструмента после `Input tag`, например `Input tag 'advisor_20260301'`. До версии v2.1.280 Claude Code не повторял это отклонение

224* Claude Code не повторяет отклонения управления контекстом или полей схемы инструментов, поэтому эти ошибки `400` достигают разработчика258* Claude Code не повторяет отклонения управления контекстом или полей схемы инструментов, поэтому эти ошибки `400` достигают разработчика

225 259 

226Отклонение `bound to a different conversation` поступает из проверки [сохраненного мышления](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking) API, которая не срабатывает, когда содержимое `system`, `tools` или более ранних `messages` отличается от запроса, который создал мышление. Шлюз, который переписывает любое из этого содержимого, может вызвать само отклонение; [Libraries, proxies, and gateways](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways) охватывает то, что нужно пересылать без изменений.260Отклонение `bound to a different conversation` поступает из проверки [сохраненного мышления](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking) API, которая не срабатывает, когда содержимое `system`, `tools` или более ранних `messages` отличается от запроса, который создал мышление. Шлюз, который переписывает любое из этого содержимого, может вызвать само отклонение; [Libraries, proxies, and gateways](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways) охватывает то, что нужно пересылать без изменений.

Details

184| `ANTHROPIC_BASE_URL` | Отправляет запросы API Claude Code на шлюз вместо `api.anthropic.com` | Всегда |184| `ANTHROPIC_BASE_URL` | Отправляет запросы API Claude Code на шлюз вместо `api.anthropic.com` | Всегда |

185| `apiKeyHelper`, или учетные данные в `ANTHROPIC_AUTH_TOKEN` или `ANTHROPIC_API_KEY` | Аутентифицирует каждый запрос к шлюзу. Помощник запускает команду для получения ключа; переменные содержат статический ключ, отправляемый как `Authorization: Bearer` и `x-api-key` соответственно | Всегда; один из трех |185| `apiKeyHelper`, или учетные данные в `ANTHROPIC_AUTH_TOKEN` или `ANTHROPIC_API_KEY` | Аутентифицирует каждый запрос к шлюзу. Помощник запускает команду для получения ключа; переменные содержат статический ключ, отправляемый как `Authorization: Bearer` и `x-api-key` соответственно | Всегда; один из трех |

186| `ANTHROPIC_CUSTOM_HEADERS` | Добавляет дополнительные HTTP-заголовки к каждому запросу API | Ваш шлюз требует заголовок клиента или маршрутизации на каждом запросе |186| `ANTHROPIC_CUSTOM_HEADERS` | Добавляет дополнительные HTTP-заголовки к каждому запросу API | Ваш шлюз требует заголовок клиента или маршрутизации на каждом запросе |

187| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Отправляет [заголовки подсказок шлюза](/docs/ru/llm-gateway-protocol#gateway-hint-headers), которые классифицируют каждый запрос для решений маршрутизации и планирования на шлюзе. Требует Claude Code v2.1.273 или позже | Ваш шлюз читает заголовки подсказок |

187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Запрашивает `/v1/models` шлюза при запуске и добавляет возвращаемые имена в средство выбора `/model` | Ваш шлюз обслуживает `/v1/models` и вы хотите, чтобы средства выбора разработчиков были заполнены из него |188| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Запрашивает `/v1/models` шлюза при запуске и добавляет возвращаемые имена в средство выбора `/model` | Ваш шлюз обслуживает `/v1/models` и вы хотите, чтобы средства выбора разработчиков были заполнены из него |

188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Останавливает отправку Claude Code заголовков и полей тела предварительного выпуска. [Отключить предварительные возможности](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает точный объем | Ваш шлюз перенаправляет на восходящий Amazon Bedrock или Google Cloud's Agent Platform, который отклоняет поля бета-версии. См. [Требования к шлюзу](#gateway-requirements) |189| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Останавливает отправку Claude Code заголовков и полей тела предварительного выпуска. [Отключить предварительные возможности](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает точный объем | Ваш шлюз перенаправляет на восходящий Amazon Bedrock или Google Cloud's Agent Platform, который отклоняет поля бета-версии. См. [Требования к шлюзу](#gateway-requirements) |

189| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` или `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Восстанавливает [быстрый режим](/docs/ru/fast-mode), когда его проверка доступности, которая вызывает `api.anthropic.com` напрямую, а не следует `ANTHROPIC_BASE_URL`, не работает, перехватывается или пропускается из-за отсутствия учетных данных Anthropic | Ваша организация использует быстрый режим, и разработчики аутентифицируются только с `ANTHROPIC_AUTH_TOKEN`, с ключом, выданным шлюзом в `ANTHROPIC_API_KEY` или из `apiKeyHelper`, или ваша сеть блокирует или перехватывает прямые запросы к `api.anthropic.com`; [использовать быстрый режим за прокси и LLM шлюзами](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) охватывает, какая из двух переменных соответствует вашей конфигурации |190| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` или `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Восстанавливает [быстрый режим](/docs/ru/fast-mode), когда его проверка доступности, которая вызывает `api.anthropic.com` напрямую, а не следует `ANTHROPIC_BASE_URL`, не работает, перехватывается или пропускается из-за отсутствия учетных данных Anthropic | Ваша организация использует быстрый режим, и разработчики аутентифицируются только с `ANTHROPIC_AUTH_TOKEN`, с ключом, выданным шлюзом в `ANTHROPIC_API_KEY` или из `apiKeyHelper`, или ваша сеть блокирует или перехватывает прямые запросы к `api.anthropic.com`; [использовать быстрый режим за прокси и LLM шлюзами](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) охватывает, какая из двух переменных соответствует вашей конфигурации |

Details

361Несколько ключей применения не отбрасываются, когда они неправильны. Claude Code применяет более строгое резервное значение, пока значение не будет исправлено; таблица показывает, что оно применяет для каждого ключа:361Несколько ключей применения не отбрасываются, когда они неправильны. Claude Code применяет более строгое резервное значение, пока значение не будет исправлено; таблица показывает, что оно применяет для каждого ключа:

362 362 

363| Поле | Поведение, когда присутствует, но неправильно |363| Поле | Поведение, когда присутствует, но неправильно |

364| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |364| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

365| `allowedMcpServers` | Применяется как пустой список разрешений, пока значение не будет исправлено, поэтому никакие MCP серверы, которые добавляют пользователи, не допускаются. Серверы, которые ваша организация доставляет через [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers), все еще загружаются, и серверы `managed-mcp.json` загружаются в соответствии с [Как сервер оценивается](/docs/ru/managed-mcp#how-a-server-is-evaluated). Отдельная неправильная запись удаляется и применяется действительное подмножество. |365| `allowedMcpServers` | Применяется как пустой список разрешений, пока значение не будет исправлено, поэтому никакие MCP серверы, которые добавляют пользователи, не допускаются. Серверы, которые ваша организация доставляет через [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers), все еще загружаются, и серверы `managed-mcp.json` загружаются в соответствии с [Как сервер оценивается](/docs/ru/managed-mcp#how-a-server-is-evaluated). Отдельная неправильная запись удаляется и применяется действительное подмножество. |

366| `allowedHttpHookUrls` | Claude Code применяет пустой [список разрешений](/docs/ru/settings-reference#allowedhttphookurls), пока вы не исправите значение, поэтому HTTP hook запускается только если другой файл параметров перечисляет его URL. Если только отдельная запись неправильна, Claude Code удаляет эту запись и применяет остальное. |366| `allowedHttpHookUrls` | Claude Code применяет пустой [список разрешений](/docs/ru/settings-reference#allowedhttphookurls), пока вы не исправите значение, поэтому HTTP hook запускается только если другой файл параметров перечисляет его URL. Если только отдельная запись неправильна, Claude Code удаляет эту запись и применяет остальное. |

367| `httpHookAllowedEnvVars` | Claude Code применяет пустой [список разрешений](/docs/ru/settings-reference#httphookallowedenvvars), пока вы не исправите значение, поэтому переменная заголовка интерполируется только если другой файл параметров называет ее. Если только отдельная запись неправильна, Claude Code удаляет эту запись и применяет остальное. |367| `httpHookAllowedEnvVars` | Claude Code применяет пустой [список разрешений](/docs/ru/settings-reference#httphookallowedenvvars), пока вы не исправите значение, поэтому переменная заголовка интерполируется только если другой файл параметров называет ее. Если только отдельная запись неправильна, Claude Code удаляет эту запись и применяет остальное. |

368| `allowedChannelPlugins` | Claude Code применяет пустой список разрешений, пока вы не исправите значение, поэтому никакой плагин канала, переданный в `--channels`, не допускается. Если только отдельная запись неправильна, она удаляет эту запись и применяет остальное. |368| `allowedChannelPlugins` | Claude Code применяет пустой список разрешений, пока вы не исправите значение, поэтому никакой плагин канала, переданный в `--channels`, не допускается. Если только отдельная запись неправильна, она удаляет эту запись и применяет остальное. |

369| `strictKnownMarketplaces` | Применяется как пустой список разрешений, пока значение не будет исправлено, поэтому никакой [источник marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) не допускается. Отдельная запись, которая неправильна или не может быть применена, такая как регулярное выражение `hostPattern`, которое не компилируется, удаляется и применяется действительное подмножество. |

369| `allowManagedHooksOnly` | Обрабатывается как `true`, пока не будет исправлено: [ограничения hook](/docs/ru/settings-reference#allowmanagedhooksonly) применяются и, если `disableCommandPluginSources` явно не `false`, плагины, полученные из команд, отключены. |370| `allowManagedHooksOnly` | Обрабатывается как `true`, пока не будет исправлено: [ограничения hook](/docs/ru/settings-reference#allowmanagedhooksonly) применяются и, если `disableCommandPluginSources` явно не `false`, плагины, полученные из команд, отключены. |

370| `allowManagedMcpServersOnly` | Обрабатывается как `true`. |371| `allowManagedMcpServersOnly` | Обрабатывается как `true`. |

371| `disableCommandPluginSources` | Обрабатывается как `true`, поэтому плагины, полученные из команд, остаются отключены, пока значение не будет исправлено. |372| `disableCommandPluginSources` | Обрабатывается как `true`, поэтому плагины, полученные из команд, остаются отключены, пока значение не будет исправлено. |

373| `disableSideloadFlags` | Обрабатывается как `true`, пока значение не будет исправлено, с эффектами, перечисленными для [`disableSideloadFlags`](/docs/ru/settings-reference#disablesideloadflags). |

372| `availableModels` | Применяется как пустой список разрешений, пока не будет исправлено, поэтому доступна только модель Default; запись, не являющаяся строкой, удаляется и применяется действительное подмножество. |374| `availableModels` | Применяется как пустой список разрешений, пока не будет исправлено, поэтому доступна только модель Default; запись, не являющаяся строкой, удаляется и применяется действительное подмножество. |

373| `enforceAvailableModels` | Обрабатывается как `true`. |375| `enforceAvailableModels` | Обрабатывается как `true`. |

376| `syncClaudeAiPlugins` | Обрабатывается как `false`, поэтому синхронизация [плагинов claude.ai](/docs/ru/settings-reference#syncclaudeaiplugins) отключена, пока значение не будет исправлено. |

374| `forceLoginOrgUUID` | Никакой организации не разрешается входить, пока значение не будет исправлено. |377| `forceLoginOrgUUID` | Никакой организации не разрешается входить, пока значение не будет исправлено. |

375| `gatewayInternalNetworks` | Когда неправильное значение поступает из наивысшего управляемого источника на машине, `/login` отказывает каждому новому входу [облачного шлюза](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) на этой машине, пока значение не будет исправлено. |378| `gatewayInternalNetworks` | Когда неправильное значение поступает из наивысшего управляемого источника на машине, `/login` отказывает каждому новому входу [облачного шлюза](/docs/ru/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) на этой машине, пока значение не будет исправлено. |

376| `crossSessionInbound` | Обрабатывается как `refuse`, самое строгое значение, поэтому входящие [кросс-сеансовые сообщения](/docs/ru/cross-session-messaging#control-inbound-messages) отказываются, пока значение не будет исправлено. Разработчик видит [предупреждение](/docs/ru/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |379| `crossSessionInbound` | Обрабатывается как `refuse`, самое строгое значение, поэтому входящие [кросс-сеансовые сообщения](/docs/ru/cross-session-messaging#control-inbound-messages) отказываются, пока значение не будет исправлено. Разработчик видит [предупреждение](/docs/ru/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse). |

377| `deniedMcpServers` | Отдельная неправильная запись удаляется и применяется действительное подмножество. Полностью неправильное значение отбрасывается с предупреждением, так как отрицание каждого сервера заблокировало бы серверы, которые политика никогда не называла. |380| `deniedMcpServers` | Отдельная неправильная запись удаляется и применяется действительное подмножество. Полностью неправильное значение отбрасывается с предупреждением, так как отрицание каждого сервера заблокировало бы серверы, которые политика никогда не называла. |

381| `blockedMarketplaces` | Отдельная неправильная запись удаляется и применяется действительное подмножество. Запись, которая анализируется, но никогда не может совпадать, такая как регулярное выражение `hostPattern`, которое не компилируется, сохраняется с предупреждением. Она ничего не блокирует, пока не будет исправлена, но [ограничения marketplace](/docs/ru/plugin-marketplaces#managed-marketplace-restrictions) остаются активными. Полностью неправильное значение отбрасывается с предупреждением, так как блокирование каждого marketplace заблокировало бы источники, которые политика никогда не называла. |

378| `sandbox.credentials` | Восстанавливаемая неправильная запись деградирует до `mode: "deny"` с предупреждением; невосстанавливаемая удаляется; действительные записи остаются применяемыми. См. [неправильные записи учетных данных](/docs/ru/settings-reference#invalid-credential-entries-in-managed-settings) |382| `sandbox.credentials` | Восстанавливаемая неправильная запись деградирует до `mode: "deny"` с предупреждением; невосстанавливаемая удаляется; действительные записи остаются применяемыми. См. [неправильные записи учетных данных](/docs/ru/settings-reference#invalid-credential-entries-in-managed-settings) |

379 383 

380`allowedHttpHookUrls` и `httpHookAllowedEnvVars` объединяются в файлах параметров, поэтому записи в ваших пользовательских, проектных или локальных параметрах все еще применяются, пока управляемый список пуст. Резервные значения для этих двух ключей и для `allowedChannelPlugins` требуют Claude Code v2.1.267 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна.384`allowedHttpHookUrls` и `httpHookAllowedEnvVars` объединяются в файлах параметров, поэтому записи в ваших пользовательских, проектных или локальных параметрах все еще применяются, пока управляемый список пуст.

385 

386Резервные значения для этих двух ключей и для `allowedChannelPlugins` требуют Claude Code v2.1.267 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна. Резервные значения для `strictKnownMarketplaces`, `blockedMarketplaces` и `disableSideloadFlags` требуют Claude Code v2.1.277 или позже; более ранние версии отбрасывают весь ключ, когда его значение или любая запись неправильна.

381 387 

382`requiredMinimumVersion` и `requiredMaximumVersion` не удаются открыто по замыслу: неправильное значение отбрасывается, а не применяется.388`requiredMinimumVersion` и `requiredMaximumVersion` не удаются открыто по замыслу: неправильное значение отбрасывается, а не применяется.

383 389 

memory.md +24 −7

Details

82<Tip>82<Tip>

83 Запустите `/init` для автоматического создания начального CLAUDE.md. Claude анализирует вашу кодовую базу и создаёт файл с командами сборки, инструкциями тестирования и соглашениями проекта, которые он обнаруживает. Если CLAUDE.md уже существует, `/init` предлагает улучшения вместо перезаписи. Уточните оттуда с помощью инструкций, которые Claude не обнаружит самостоятельно.83 Запустите `/init` для автоматического создания начального CLAUDE.md. Claude анализирует вашу кодовую базу и создаёт файл с командами сборки, инструкциями тестирования и соглашениями проекта, которые он обнаруживает. Если CLAUDE.md уже существует, `/init` предлагает улучшения вместо перезаписи. Уточните оттуда с помощью инструкций, которые Claude не обнаружит самостоятельно.

84 84 

85 Установите `CLAUDE_CODE_NEW_INIT=1` для включения интерактивного многофазного потока. `/init` спрашивает, какие артефакты настроить: файлы CLAUDE.md, skills и hooks. Затем он исследует вашу кодовую базу с помощью подагента, заполняет пробелы с помощью дополнительных вопросов и представляет проверяемое предложение перед написанием каких-либо файлов.85 Для интерактивного многофазного потока установите переменную окружения `CLAUDE_CODE_NEW_INIT` в значение `1` перед запуском `/init`. Установите её в вашей оболочке или в блоке `env` файла настроек, как показано в [Установка переменных окружения](/docs/ru/env-vars#set-environment-variables). С установленной переменной `/init` спрашивает, какие артефакты настроить: файлы CLAUDE.md, skills и hooks. Затем он исследует вашу кодовую базу с помощью подагента, заполняет пробелы с помощью дополнительных вопросов и представляет проверяемое предложение перед написанием каких-либо файлов. Переменная только изменяет способ работы `/init`, поэтому вы можете оставить её установленной.

86</Tip>86</Tip>

87 87 

88<h3 id="write-effective-instructions">88<h3 id="write-effective-instructions">

165CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config165CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

166```166```

167 167 

168Встроенная форма устанавливает переменную для этого одного запуска в Bash или Zsh. Чтобы оставить её включённой для каждой сессии, добавьте её в блок `env` в `~/.claude/settings.json`, как показано в [Установка переменных окружения](/docs/ru/env-vars#set-environment-variables).

169 

168Это загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md` из дополнительного каталога. `CLAUDE.local.md` пропускается, если вы исключите `local` из [`--setting-sources`](/docs/ru/cli-reference).170Это загружает `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` и `CLAUDE.local.md` из дополнительного каталога. `CLAUDE.local.md` пропускается, если вы исключите `local` из [`--setting-sources`](/docs/ru/cli-reference).

169 171 

170<h3 id="organize-rules-with-claude/rules/">172<h3 id="organize-rules-with-claude/rules/">

244 246 

245Синтаксис Glob рассматривает `[` как начало выражения скобок, такого как `[abc]`. Шаблон с `[`, который не может быть прочитан как выражение скобок, такой как `photos [2024/**`, является недействительным: он не совпадает ни с какими файлами, и другие шаблоны правила продолжают работать. Чтобы совпадать с буквальным `[` в имени файла, экранируйте его как `photos \[2024/**`. До v2.1.207 один недействительный шаблон заставлял инструмент Read не работать для каждого файла, для которого оценивалось правило, вместо того чтобы не совпадать ни с чем.247Синтаксис Glob рассматривает `[` как начало выражения скобок, такого как `[abc]`. Шаблон с `[`, который не может быть прочитан как выражение скобок, такой как `photos [2024/**`, является недействительным: он не совпадает ни с какими файлами, и другие шаблоны правила продолжают работать. Чтобы совпадать с буквальным `[` в имени файла, экранируйте его как `photos \[2024/**`. До v2.1.207 один недействительный шаблон заставлял инструмент Read не работать для каждого файла, для которого оценивалось правило, вместо того чтобы не совпадать ни с чем.

246 248 

249<h4 id="rules-frontmatter-reference">

250 Справочник frontmatter правил

251</h4>

252 

253Настройте правило с помощью YAML [frontmatter](/docs/ru/glossary#frontmatter) между маркерами `---` в начале файла. `paths` — это единственное поле, которое Claude Code читает из правила; любое другое поле игнорируется без ошибки. Claude Code удаляет frontmatter перед загрузкой правила в контекст.

254 

255| Поле | Обязательно | Описание |

256| :------ | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------- |

257| `paths` | Нет | Glob шаблоны, которые [ограничивают правило совпадающими файлами](#path-specific-rules). Принимает список YAML или строку, разделённую запятыми |

258 

259Если YAML между маркерами не анализируется, Claude Code игнорирует frontmatter и загружает правило, как если бы оно не имело `paths`. Запустите `claude --debug` для просмотра ошибки анализа.

260 

247<h4 id="share-rules-across-projects-with-symlinks">261<h4 id="share-rules-across-projects-with-symlinks">

248 Поделитесь правилами между проектами с помощью символических ссылок262 Поделитесь правилами между проектами с помощью символических ссылок

249</h4>263</h4>

271└── workflows.md # Your preferred workflows285└── workflows.md # Your preferred workflows

272```286```

273 287 

274Правила уровня пользователя загружаются перед правилами проекта, давая правилам проекта более высокий приоритет.288Claude Code загружает правила уровня пользователя перед правилами проекта, поэтому правило проекта появляется позже в контексте Claude, чем правило пользователя. Ни один набор не переопределяет другой: если правило пользователя и правило проекта конфликтуют, Claude может следовать любому из них, поэтому держите эти два согласованными.

275 289 

276<h3 id="manage-claude-md-for-large-teams">290<h3 id="manage-claude-md-for-large-teams">

277 Управляйте CLAUDE.md для больших команд291 Управляйте CLAUDE.md для больших команд

424* Вы используете Claude Code версии до v2.1.277438* Вы используете Claude Code версии до v2.1.277

425* Ваш сеанс не [получает флаги функций от Anthropic](/docs/ru/env-vars#features-that-need-feature-flag-fetching), например потому что вы используете Amazon Bedrock или другого поставщика третьей стороны, или вы отключили телеметрию. Связанный раздел содержит полный список439* Ваш сеанс не [получает флаги функций от Anthropic](/docs/ru/env-vars#features-that-need-feature-flag-fetching), например потому что вы используете Amazon Bedrock или другого поставщика третьей стороны, или вы отключили телеметрию. Связанный раздел содержит полный список

426* Это ваш [первый сеанс после установки или обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade) до версии с поддержкой `AGENTS.md`. Claude читает `AGENTS.md` со следующего сеанса440* Это ваш [первый сеанс после установки или обновления](/docs/ru/env-vars#first-session-after-an-install-or-upgrade) до версии с поддержкой `AGENTS.md`. Claude читает `AGENTS.md` со следующего сеанса

427* Вы или ваша организация установили [`disableAllHooks`](/docs/ru/settings-reference#disableallhooks) или [`allowManagedHooksOnly`](/docs/ru/settings-reference#allowmanagedhooksonly), или вы отключили встроенный плагин `agents-md` в `/plugin`441* Вы отключили встроенный плагин `agents-md` в `/plugin`

428 442 

429Чтобы дать Claude ваш `AGENTS.md` в этих сеансах, [импортируйте его из `CLAUDE.md`](#share-one-file-with-other-coding-tools).443Чтобы дать Claude ваш `AGENTS.md` в этих сеансах, [импортируйте его из `CLAUDE.md`](#share-one-file-with-other-coding-tools).

430 444 

435`AGENTS.md`, который Claude читает через параметр **Project instructions**, отличается от `CLAUDE.md` в этих местах:449`AGENTS.md`, который Claude читает через параметр **Project instructions**, отличается от `CLAUDE.md` в этих местах:

436 450 

437| | `CLAUDE.md` | `AGENTS.md` read through the setting |451| | `CLAUDE.md` | `AGENTS.md` read through the setting |

438| :------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |452| :------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |

439| `/memory` and the **Memory files** list in `/context` | Listed | Not listed. To confirm Claude read it, look for the [`AGENTS.md loaded` line](#when-claude-code-reads-agents-md) under the default value, or ask Claude what its project instructions say |

440| [`InstructionsLoaded` hooks](/docs/ru/hooks#instructionsloaded) | Fire | Don't fire. They fire as usual for an `AGENTS.md` that a `CLAUDE.md` imports or symlinks to |453| [`InstructionsLoaded` hooks](/docs/ru/hooks#instructionsloaded) | Fire | Don't fire. They fire as usual for an `AGENTS.md` that a `CLAUDE.md` imports or symlinks to |

441| Directories you add with `--add-dir` while [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) is set | Their `CLAUDE.md` loads | Their `AGENTS.md` doesn't load |454| Directories you add with `--add-dir` while [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) is set | Their `CLAUDE.md` loads | Their `AGENTS.md` doesn't load |

442| An `@path` import of a file outside your working directory | Claude Code asks you to approve [external imports](#import-additional-files) | Loads only if you already approved external imports for this project, with no prompt |455| An `@path` import of a file outside your working directory | Claude Code asks you to approve [external imports](#import-additional-files) | Loads only if you already approved external imports for this project, with no prompt |

604 617 

605Для отладки:618Для отладки:

606 619 

607* Запустите `/context` и проверьте список под **Memory files**, чтобы убедиться, что ваши файлы CLAUDE.md и CLAUDE.local.md загружены. Если файл `CLAUDE.md` отсутствует там, Claude не может его видеть. Файл `AGENTS.md` появляется там только когда `CLAUDE.md` его импортирует, а не когда Claude [читает его напрямую](#where-agents-md-differs-from-claude-md). Используйте `/memory` для открытия и редактирования файлов.620* Запустите `/context` и проверьте список под **Memory files**, чтобы убедиться, что ваши файлы CLAUDE.md и CLAUDE.local.md загружены. Если файл `CLAUDE.md` отсутствует там, Claude не может его видеть. Используйте `/memory` для открытия и редактирования файлов.

608* Проверьте, что соответствующий CLAUDE.md находится в местоположении, которое загружается для вашего сеанса (см. [Выберите, где разместить файлы CLAUDE.md](#choose-where-to-put-claude-md-files)).621* Проверьте, что соответствующий CLAUDE.md находится в местоположении, которое загружается для вашего сеанса (см. [Выберите, где разместить файлы CLAUDE.md](#choose-where-to-put-claude-md-files)).

609* Сделайте инструкции более конкретными. "Используйте отступ из 2 пробелов" работает лучше, чем "красиво форматируйте код".622* Сделайте инструкции более конкретными. "Используйте отступ из 2 пробелов" работает лучше, чем "красиво форматируйте код".

610* Ищите конфликтующие инструкции в файлах CLAUDE.md. Если два файла дают разные рекомендации для одного поведения, Claude может выбрать одну произвольно.623* Ищите конфликтующие инструкции в файлах CLAUDE.md. Если два файла дают разные рекомендации для одного поведения, Claude может выбрать одну произвольно.

6283. Проверьте, является ли ваш сеанс одним из тех, которые [не могут загружать `AGENTS.md`](#when-agents-md-support-is-unavailable), например сеанс у стороннего поставщика или с отключённой телеметрией.6413. Проверьте, является ли ваш сеанс одним из тех, которые [не могут загружать `AGENTS.md`](#when-agents-md-support-is-unavailable), например сеанс у стороннего поставщика или с отключённой телеметрией.

6294. Введите `/config` в вашем сеансе, чтобы открыть панель параметров и подтвердить, что **Project instructions** не установлен на `claude-md` или `managed-only`. Если вы вообще не видите этот параметр, ваш сеанс — это один из тех, которые [не могут загружать `AGENTS.md`](#when-agents-md-support-is-unavailable).6424. Введите `/config` в вашем сеансе, чтобы открыть панель параметров и подтвердить, что **Project instructions** не установлен на `claude-md` или `managed-only`. Если вы вообще не видите этот параметр, ваш сеанс — это один из тех, которые [не могут загружать `AGENTS.md`](#when-agents-md-support-is-unavailable).

630 643 

631`AGENTS.md` не появляется в `/memory` или `/context`, когда Claude читает его напрямую, поэтому проверьте строку `AGENTS.md loaded` или спросите Claude, что говорят его инструкции проекта. Если вы хотите сохранить найденный `CLAUDE.md` или ваш сеанс не может загружать `AGENTS.md`, [добавьте `CLAUDE.md` рядом с вашим `AGENTS.md`, который его импортирует](#share-one-file-with-other-coding-tools).644Чтобы проверить, прочитал ли Claude ваш `AGENTS.md`, запустите `/memory` и ищите его путь в списке.

645 

646До версии v2.1.280 `/memory` и `/context` не выводили список `AGENTS.md`, который Claude читал напрямую. На этих версиях вместо этого спросите Claude, что говорят его инструкции проекта.

647 

648Если вы хотите сохранить найденный `CLAUDE.md` или ваш сеанс не может загружать `AGENTS.md`, [добавьте `CLAUDE.md` рядом с вашим `AGENTS.md`, который его импортирует](#share-one-file-with-other-coding-tools).

632 649 

633<h3 id="i-don’t-know-what-auto-memory-saved">650<h3 id="i-don’t-know-what-auto-memory-saved">

634 Я не знаю, что сохранила auto memory651 Я не знаю, что сохранила auto memory

model-config.md +34 −36

Details

47 47 

48| Поставщик | `opus` | `sonnet` |48| Поставщик | `opus` | `sonnet` |

49| :--------------------------------------------------- | :------- | :--------- |49| :--------------------------------------------------- | :------- | :--------- |

50| Anthropic API | Opus 5 | Sonnet 5 |50| Anthropic API | Opus 5.5 | Sonnet 5 |

51| [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) | Opus 5 | Sonnet 4.6 |51| [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) | Opus 5.5 | Sonnet 4.6 |

52| Amazon Bedrock, Google Cloud's Agent Platform | Opus 5 | Sonnet 4.5 |52| Amazon Bedrock, Google Cloud's Agent Platform | Opus 5.5 | Sonnet 4.5 |

53| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |53| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |

54 54 

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

60 60 

61Если псевдоним разрешается на более старую модель, более новые модели доступны путём явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.61Если псевдоним разрешается на более старую модель, более новые модели доступны путём явного выбора полного имени модели или установки `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`.

62 62 

63До версии 2.1.219 `opus` разрешался на Opus 4.8 в Anthropic API начиная с версии 2.1.154 и на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform начиная с версии 2.1.207. До версии 2.1.207 `opus` разрешался на Opus 4.7 на Claude Platform on AWS и на Opus 4.6 на Amazon Bedrock и Google Cloud's Agent Platform.63До версии 2.1.280 `opus` разрешался на Opus 5 в Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform начиная с версии 2.1.219. До версии 2.1.219 `opus` разрешался на Opus 4.8 в Anthropic API начиная с версии 2.1.154 и на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform начиная с версии 2.1.207. До версии 2.1.207 `opus` разрешался на Opus 4.7 на Claude Platform on AWS и на Opus 4.6 на Amazon Bedrock и Google Cloud's Agent Platform.

64 64 

65Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определённую версию, используйте полное имя модели, например `claude-opus-5`, или установите соответствующую переменную окружения, например `ANTHROPIC_DEFAULT_OPUS_MODEL`.65Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определённую версию, используйте полное имя модели, например `claude-opus-5-5`, или установите соответствующую переменную окружения, например `ANTHROPIC_DEFAULT_OPUS_MODEL`.

66 66 

67<Note>67<Note>

68 Opus 5 требует Claude Code версии 2.1.219 или позже. Sonnet 5 требует версии 2.1.197 или позже. Opus 4.8 требует версии 2.1.154 или позже. Запустите `claude update` для обновления.68 Opus 5.5 требует Claude Code версии 2.1.280 или позже. Opus 5 требует версии 2.1.219 или позже. Sonnet 5 требует версии 2.1.197 или позже. Запустите `claude update` для обновления.

69</Note>69</Note>

70 70 

71<h3 id="work-with-fable">71<h3 id="work-with-fable">

94 Fable 5.1 требует Claude Code версии 2.1.257 или позже. Если запрос для неё из более старой версии не удаётся, см. [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Запустите `claude update` для обновления. Для доступности при нулевом сохранении данных см. [Model availability under ZDR](/docs/ru/zero-data-retention#model-availability-under-zdr).94 Fable 5.1 требует Claude Code версии 2.1.257 или позже. Если запрос для неё из более старой версии не удаётся, см. [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Запустите `claude update` для обновления. Для доступности при нулевом сохранении данных см. [Model availability under ZDR](/docs/ru/zero-data-retention#model-availability-under-zdr).

95</Note>95</Note>

96 96 

97В Anthropic API средство выбора `/model` отображает модель Fable только после того, как сервер сообщит о её доступности для вашей организации. Когда вы вводите `/model fable` или ID модели Fable, Claude Code проверяет доступность непосредственно с сервером, поэтому типизированный выбор может быть успешным даже если средство выбора не отображает запись.97В Anthropic API средство выбора `/model` отображает модель Fable, если [`availableModels`](#restrict-model-selection) или [ограничения модели организации](#organization-model-restrictions) её не исключают. Когда ваша организация вообще не может использовать Fable, например при [нулевом сохранении данных](/docs/ru/zero-data-retention#model-availability-under-zdr), строка остаётся в средстве выбора неактивной с примечанием о причине.

98 98 

99<h4 id="fable-and-usage-credits">99<h4 id="fable-and-usage-credits">

100 Fable и кредиты использования100 Fable и кредиты использования

138 138 

139Ввод `/model <name>` напрямую ведёт себя как `Enter`. Чтобы переключиться только для этого сеанса, откройте средство выбора с `/model` и нажмите `s` в строке модели.139Ввод `/model <name>` напрямую ведёт себя как `Enter`. Чтобы переключиться только для этого сеанса, откройте средство выбора с `/model` и нажмите `s` в строке модели.

140 140 

141Если вы переключаете модели с `/model`, переключение также достигает [подагентов, которые наследуют модель основного разговора](/docs/ru/sub-agents#choose-a-model), потому что Claude Code разрешает их модель из той, которую использует ваш сеанс, когда Claude их запускает. Переключитесь на Opus перед тем, как Claude делегирует исследование или тестовые запуски одному из них, и эта работа также будет выполняться на Opus. Чтобы сохранить пользовательского подагента на меньшей модели, установите `model` в его определении.

142 

141Если вы установите модель с `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущему сеансу и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.143Если вы установите модель с `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущему сеансу и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.

142 144 

143В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял стандартную.145В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял стандартную.

443 445 

444Поведение `default` зависит от типа вашей учетной записи:446Поведение `default` зависит от типа вашей учетной записи:

445 447 

446* **Max, Team Premium, Enterprise и Anthropic API**: по умолчанию Opus 5448* **Pro, Max, Team, Enterprise и Anthropic API**: по умолчанию Opus 5.5

447* **Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 5449* **Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 5.5

448* **Pro и Team Standard**: по умолчанию Sonnet 5

449* **Microsoft Foundry**: по умолчанию Sonnet 4.5450* **Microsoft Foundry**: по умолчанию Sonnet 4.5

450 451 

451До версии 2.1.219 `default` разрешался в Opus 4.8 на Anthropic API, Max, Team Premium и Enterprise с оплатой по мере использования с версии 2.1.154, а также на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.207. До версии 2.1.207 `default` разрешался в Opus 4.7 на Claude Platform on AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.452До версии 2.1.280 `default` разрешался в Sonnet 5 на Pro и Team Standard, а в Opus 5 на Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.219. До версии 2.1.219 `default` разрешался в Opus 4.8 на Anthropic API, Max, Team Premium и Enterprise с оплатой по мере использования с версии 2.1.154, а также на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.207. До версии 2.1.207 `default` разрешался в Opus 4.7 на Claude Platform on AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.

452 453 

453Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учетной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе.454Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учетной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе.

454 455 

512 Автоматический резервный вариант модели513 Автоматический резервный вариант модели

513</h3>514</h3>

514 515 

515Этот раздел охватывает резервный вариант на основе содержимого из моделей Fable и Opus 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).516Этот раздел охватывает резервный вариант на основе содержимого из моделей Fable, Opus 5.5 и Opus 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).

516 517 

517Модели Fable и Opus 5 работают с классификаторами безопасности, которые чаще всего отмечают содержимое кибербезопасности и биологии. Когда классификатор отмечает запрос и отмеченная категория имеет резервную модель, Claude Code повторно запускает запрос на этой модели и показывает уведомление в стенограмме. Для этих двух категорий резервная модель зависит от того, какая модель отказала:518Модели Fable, Opus 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего отмечают содержимое кибербезопасности и биологии. Когда классификатор отмечает запрос и отмеченная категория имеет резервную модель, Claude Code повторно запускает запрос на этой модели и показывает уведомление в стенограмме. Для этих двух категорий резервная модель зависит от того, какая модель отказала:

518 519 

519* **Fable 5.1 и Fable 5**: запросы, отмеченные биологией, повторно запускаются на Opus 5, а запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8.520* **Fable 5.1, Fable 5 и Opus 5.5**: запросы, отмеченные биологией, повторно запускаются на Opus 5, а запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8.

520* **Opus 5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8. Запросы, отмеченные биологией, заканчиваются отказом, потому что Opus 5 запускает свои собственные классификаторы биологии без резервной модели.521* **Opus 5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8. Запросы, отмеченные биологией, заканчиваются отказом, потому что Opus 5 запускает свои собственные классификаторы биологии без резервной модели.

521 522 

522На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code разрешает эти цели через ваше развертывание, и если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, категории, которые имеют резервный вариант, повторно запускаются на закрепленной модели; см. [Включение резервного варианта на Bedrock, Agent Platform и Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).523На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code разрешает эти цели через ваше развертывание, и если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, категории, которые имеют резервный вариант, повторно запускаются на закрепленной модели; см. [Включение резервного варианта на Bedrock, Agent Platform и Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

555 556 

556На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей специфичны для поставщика, поэтому автоматический резервный вариант работает только когда Claude Code может идентифицировать обе задействованные модели:557На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей специфичны для поставщика, поэтому автоматический резервный вариант работает только когда Claude Code может идентифицировать обе задействованные модели:

557 558 

558* Claude Code должен распознавать текущую модель как источник резервного варианта. Fable 5.1 и Fable 5 распознаются, когда идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version). Opus 5 распознается по его идентификатору модели поставщика или сопоставлению [`modelOverrides`](#override-model-ids-per-version).559* Claude Code должен распознавать текущую модель как источник резервного варианта. Fable 5.1 и Fable 5 распознаются, когда идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version). Opus 5.5 и Opus 5 распознаются по их идентификатору модели поставщика или сопоставлению [`modelOverrides`](#override-model-ids-per-version).

559* Резервная модель должна разрешаться в вашем развертывании. Если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, отмеченные запросы повторно запускаются на этой модели для каждой категории, которая имеет резервный вариант; флаг биологии на Opus 5 по-прежнему заканчивается отказом. Если вы не установите его, запросы, отмеченные кибербезопасностью, повторно запускаются на записи Opus 4.8 в списке моделей поставщика, а запросы, отмеченные биологией, из модели Fable на записи Opus 5.560* Резервная модель должна разрешаться в вашем развертывании. Если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, отмеченные запросы повторно запускаются на этой модели для каждой категории, которая имеет резервный вариант; флаг биологии на Opus 5 по-прежнему заканчивается отказом. Если вы не установите его, запросы, отмеченные кибербезопасностью, повторно запускаются на записи Opus 4.8 в списке моделей поставщика, а запросы, отмеченные биологией, из модели Fable или Opus 5.5 на записи Opus 5.

560 561 

561Если какая-либо модель не может быть идентифицирована, Claude Code не переключается автоматически. Отмеченный запрос заканчивается сообщением об отказе, и вы можете переключить модели с помощью [`/model`](#setting-your-model) и повторить попытку. Установка `ANTHROPIC_DEFAULT_FABLE_MODEL` на идентификатор вашей модели Fable включает распознавание Fable. Установка `ANTHROPIC_DEFAULT_OPUS_MODEL` на идентификатор модели Opus дает отмеченным категориям цель резервного варианта, если только закрепление не называет модель вне семейства Opus или модель, которая отказала; затем Claude Code не переключается и отказ остается в силе.562Если какая-либо модель не может быть идентифицирована, Claude Code не переключается автоматически. Отмеченный запрос заканчивается сообщением об отказе, и вы можете переключить модели с помощью [`/model`](#setting-your-model) и повторить попытку. Установка `ANTHROPIC_DEFAULT_FABLE_MODEL` на идентификатор вашей модели Fable включает распознавание Fable. Установка `ANTHROPIC_DEFAULT_OPUS_MODEL` на идентификатор модели Opus дает отмеченным категориям цель резервного варианта, если только закрепление не называет модель вне семейства Opus или модель, которая отказала; затем Claude Code не переключается и отказ остается в силе.

562 563 

564 Исследование безопасности и рабочие нагрузки биологии565 Исследование безопасности и рабочие нагрузки биологии

565</h4>566</h4>

566 567 

567Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, смежные с биологией, часто вызывают резервный вариант, часто при первом запросе. Для существенной работы по биологии на Fable 5.1 или Fable 5 Claude Code перемещает сеанс на Opus 5 при первом отмеченном запросе, и более поздние запросы, отмеченные биологией, заканчиваются отказами там, потому что Opus 5 не имеет резервного варианта биологии. На Opus 5 вы получаете эти отказы с первого отмеченного запроса.568Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, смежные с биологией, часто вызывают резервный вариант, часто при первом запросе. Для существенной работы по биологии на Fable 5.1, Fable 5 или Opus 5.5 Claude Code перемещает сеанс на Opus 5 при первом отмеченном запросе, и более поздние запросы, отмеченные биологией, заканчиваются отказами там, потому что Opus 5 не имеет резервного варианта биологии. На Opus 5 вы получаете эти отказы с первого отмеченного запроса.

568 569 

569Это ожидаемая маршрутизация для этих областей, а не флаг учетной записи. Если вашей организации требуется возможность класса Fable для этой работы, обратитесь к команде учетной записи Anthropic о программах доверенного доступа.570Это ожидаемая маршрутизация для этих областей, а не флаг учетной записи. Если вашей организации требуется возможность класса Fable для этой работы, обратитесь к команде учетной записи Anthropic о программах доверенного доступа.

570 571 

577Доступные уровни усилий зависят от модели. Модели, не указанные здесь, не поддерживают усилия:578Доступные уровни усилий зависят от модели. Модели, не указанные здесь, не поддерживают усилия:

578 579 

579| Модель | Уровни |580| Модель | Уровни |

580| :------------------------------------ | :-------------------------------------- |581| :---------------------------------------------- | :-------------------------------------- |

581| Fable 5.1 и Fable 5 | `low`, `medium`, `high`, `xhigh`, `max` |582| Fable 5.1 и Fable 5 | `low`, `medium`, `high`, `xhigh`, `max` |

582| Opus 5, Sonnet 5, Opus 4.8 и Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |583| Opus 5.5, Opus 5, Sonnet 5, Opus 4.8 и Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |

583| Opus 4.6 и Sonnet 4.6 | `low`, `medium`, `high`, `max` |584| Opus 4.6 и Sonnet 4.6 | `low`, `medium`, `high`, `max` |

584 585 

585Если вы установите уровень, который активная модель не поддерживает, Claude Code переходит на наивысший поддерживаемый уровень на или ниже установленного. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные параметры также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).586Если вы установите уровень, который активная модель не поддерживает, Claude Code переходит на наивысший поддерживаемый уровень на или ниже установленного. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные параметры также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).

587С параметром [`ultracode`](/docs/ru/settings-reference#ultracode) отключенным, Claude Code разрешает уровень усилий сеанса в этом порядке, принимая первый применимый:588С параметром [`ultracode`](/docs/ru/settings-reference#ultracode) отключенным, Claude Code разрешает уровень усилий сеанса в этом порядке, принимая первый применимый:

588 589 

5891. Явный выбор: переменная окружения [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars#variables), запуск с `--effort` или `/effort` в сеансе ([неинтерактивный `/effort` имеет более узкий эффект](#non-interactive-effort))5901. Явный выбор: переменная окружения [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars#variables), запуск с `--effort` или `/effort` в сеансе ([неинтерактивный `/effort` имеет более узкий эффект](#non-interactive-effort))

5902. Уровень усилий модели по умолчанию на Fable 5, Opus 4.8 или Opus 4.7: с первого раза, когда вы запускаете одну из этих моделей, Claude Code сохраняет уровень усилий этой модели между сеансами, даже когда ваши параметры разрешают другой уровень. Opus 5 и Fable 5.1 не имеют такого сохранения. Заканчивает ли уровень, который вы установили, это сохранение, зависит от того, как вы его установили, например:5912. Ваши параметры: уровень, который вы сохранили для модели или ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel), с приоритетом между ними и между файлами параметров, указанным в [`modelSettings`](/docs/ru/settings-reference#modelsettings)

591 * **Заканчивает сохранение**: подтверждение уровня интерактивно, с `Enter` в ползунке `/effort` или средстве выбора `/model` или с уровнем, введенным после `/effort`, или выбор уровня из управления усилиями [Remote Control](/docs/ru/remote-control#what-connected-devices-see) подключенного устройства5923. Уровень усилий модели по умолчанию: `high` на каждой модели, которая поддерживает усилия, за исключением того, что Opus 5.5 по умолчанию имеет `medium`, Opus 4.7 по умолчанию имеет `xhigh` и, когда ваша организация устанавливает уровень усилий по умолчанию для своей [модели по умолчанию организации](#organization-default-model), этот уровень является стандартным при запуске этой модели

592 * **Оставляет сохранение на месте для более поздних сеансов**: `--effort` при запуске или `s` в ползунке `/effort` или средстве выбора `/model`593 

5933. Ваши параметры: уровень, который вы сохранили для модели или ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel), с приоритетом между ними и между файлами параметров, указанным в [`modelSettings`](/docs/ru/settings-reference#modelsettings)594Opus 5.5 начинает с `medium`, если один из источников выше не устанавливает уровень для него, и верхний уровень `effortLevel` в файле параметров пользователя не считается для Opus 5.5. Этот ключ — это более старая форма, которую `/effort` писал перед тем, как Claude Code сохранял уровни для каждой модели: он продолжает применяться там, где применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях, в то время как Opus 5.5 и модели, выпущенные после него, начинают со своего собственного стандарта, пока вы не выберете уровень для них с помощью `/effort` или средства выбора `/model`. Верхний уровень `effortLevel` в параметрах проекта, локальных или управляемых параметрах, или переданный с `--settings`, применяется к каждой модели.

5944. Уровень усилий модели по умолчанию: `high` на каждой модели, которая поддерживает усилия, за исключением того, что Opus 4.7 по умолчанию имеет `xhigh` и, когда ваша организация устанавливает уровень усилий по умолчанию для своей [модели по умолчанию организации](#organization-default-model), этот уровень является стандартным при запуске этой модели

595 595 

596Когда вы устанавливаете `low`, `medium`, `high` или `xhigh` в интерактивном сеансе на вашей машине, вы выбираете, как долго это длится, подтверждая это:596Когда вы устанавливаете `low`, `medium`, `high` или `xhigh` в интерактивном сеансе на вашей машине, вы выбираете, как долго это длится, подтверждая это:

597 597 

608 608 

609<span id="non-interactive-effort" />609<span id="non-interactive-effort" />

610 610 

611Когда вы устанавливаете уровень с `/effort` в запуске [`-p`](/docs/ru/headless), Claude Code применяет его только к этому сеансу и не сохраняет его как стандартный. На Fable 5, Opus 4.8 и Opus 4.7 этот уровень также ни не заканчивает сохранение уровня усилий модели по умолчанию, ни не переопределяет его для сеанса. Пока это сохранение действует, неинтерактивный `/effort` сообщает `Not applied`, поэтому вместо этого передайте `--effort` при запуске.611Когда вы устанавливаете уровень с `/effort` в запуске [`-p`](/docs/ru/headless), Claude Code применяет его только к этому сеансу и не сохраняет его как стандартный.

612 612 

613Меню `/effort` также предлагает `ultracode`. Ultracode — это параметр Claude Code, а не уровень усилий модели: он отправляет `xhigh` модели и дополнительно имеет Claude оркестрирует [динамические рабочие процессы](/docs/ru/workflows) для существенных задач. Для того, где это можно установить постоянно, см. параметр [`ultracode`](/docs/ru/settings-reference#ultracode).613Меню `/effort` также предлагает `ultracode`. Ultracode — это параметр Claude Code, а не уровень усилий модели: он отправляет `xhigh` модели и дополнительно имеет Claude оркестрирует [динамические рабочие процессы](/docs/ru/workflows) для существенных задач. Для того, где это можно установить постоянно, см. параметр [`ultracode`](/docs/ru/settings-reference#ultracode).

614 614 

642| Уровень | Когда его использовать |642| Уровень | Когда его использовать |

643| :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- |643| :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

644| `low` | Зарезервируйте для коротких, ограниченных, чувствительных к задержкам задач, которые не требуют интеллекта |644| `low` | Зарезервируйте для коротких, ограниченных, чувствительных к задержкам задач, которые не требуют интеллекта |

645| `medium` | Снижает использование токенов для работы, чувствительной к затратам, которая может пожертвовать некоторым интеллектом |645| `medium` | Снижает использование токенов для работы, чувствительной к затратам, которая может пожертвовать некоторым интеллектом. Стандартный на Opus 5.5 |

646| `high` | Балансирует использование токенов и интеллект. Стандартный на каждой модели, кроме Opus 4.7 |646| `high` | Балансирует использование токенов и интеллект. Стандартный на каждой модели, кроме Opus 5.5 и Opus 4.7 |

647| `xhigh` | Более глубокое рассуждение при более высоких расходах токенов. Стандартный на Opus 4.7 |647| `xhigh` | Более глубокое рассуждение при более высоких расходах токенов. Стандартный на Opus 4.7 |

648| `max` | Может улучшить производительность на сложных задачах, но может показать убывающую отдачу и склонен к чрезмерному размышлению. Протестируйте перед широким внедрением |648| `max` | Может улучшить производительность на сложных задачах, но может показать убывающую отдачу и склонен к чрезмерному размышлению. Протестируйте перед широким внедрением |

649| `ultracode` | Параметр Claude Code, который планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи с рассуждением `xhigh` для каждого сообщения |649| `ultracode` | Параметр Claude Code, который планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи с рассуждением `xhigh` для каждого сообщения |

667* **Флаг `--effort`**: передайте имя уровня, чтобы установить его для одного сеанса при запуске Claude Code667* **Флаг `--effort`**: передайте имя уровня, чтобы установить его для одного сеанса при запуске Claude Code

668* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` на имя уровня или `auto`668* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` на имя уровня или `auto`

669* **Параметры**: установите уровень для каждой модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) или установите [`effortLevel`](/docs/ru/settings-reference#effortlevel) на `low`, `medium`, `high` или `xhigh` как стандартный для моделей без одного. `max` не принимается как уровень ни в одном ключе, и `ultracode` имеет свой собственный ключ [`ultracode`](/docs/ru/settings-reference#ultracode)669* **Параметры**: установите уровень для каждой модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) или установите [`effortLevel`](/docs/ru/settings-reference#effortlevel) на `low`, `medium`, `high` или `xhigh` как стандартный для моделей без одного. `max` не принимается как уровень ни в одном ключе, и `ultracode` имеет свой собственный ключ [`ultracode`](/docs/ru/settings-reference#ultracode)

670* **С подключенного устройства**: в сеансе [Remote Control](/docs/ru/remote-control#what-connected-devices-see) выберите уровень из управления усилиями на вашем телефоне или в браузере. Уровень применяется только к текущему сеансу, хотя он также заканчивает [сохранение уровня усилий модели по умолчанию](#adjust-effort-level). Требуется Claude Code версии 2.1.234 или позже670* **С подключенного устройства**: в сеансе [Remote Control](/docs/ru/remote-control#what-connected-devices-see) выберите уровень из управления усилиями на вашем телефоне или в браузере. Уровень применяется только к текущему сеансу. Требуется Claude Code версии 2.1.234 или позже

671* **Frontmatter skill и subagent**: установите `effort` в файле markdown [skill](/docs/ru/skills#frontmatter-reference) или [subagent](/docs/ru/sub-agents#supported-frontmatter-fields), чтобы переопределить уровень усилий при запуске этого skill или subagent671* **Frontmatter skill и subagent**: установите `effort` в файле markdown [skill](/docs/ru/skills#frontmatter-reference) или [subagent](/docs/ru/sub-agents#supported-frontmatter-fields), чтобы переопределить уровень усилий при запуске этого skill или subagent

672 672 

673Frontmatter усилия применяются, когда этот skill или subagent активен, переопределяя уровень сеанса, но не переменную окружения. [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) или [ограничение усилий организации](#organization-effort-limits) по-прежнему ограничивает уровень, на котором работает skill или subagent.673Frontmatter усилия применяются, когда этот skill или subagent активен, переопределяя уровень сеанса, но не переменную окружения. [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) или [ограничение усилий организации](#organization-effort-limits) по-прежнему ограничивает уровень, на котором работает skill или subagent.

674 674 

675На Fable 5, Opus 4.8 и Opus 4.7 frontmatter усилия также применяются, пока [сохранение уровня усилий модели по умолчанию](#adjust-effort-level) действует. До версии 2.1.267 сохранение имело приоритет и Claude Code игнорировал уровень frontmatter, пока сохранение было активно.

676 

677Если вы установите `effortLevel` в [управляемых параметрах](/docs/ru/managed-settings), Claude Code применяет его на этапе параметров [порядка разрешения усилий](#adjust-effort-level), и пользователи все еще могут изменять уровень с помощью `/effort` или `--effort`. Чтобы держать пользователей на или ниже уровня, установите [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel).675Если вы установите `effortLevel` в [управляемых параметрах](/docs/ru/managed-settings), Claude Code применяет его на этапе параметров [порядка разрешения усилий](#adjust-effort-level), и пользователи все еще могут изменять уровень с помощью `/effort` или `--effort`. Чтобы держать пользователей на или ниже уровня, установите [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel).

678 676 

679Ползунок усилий появляется в `/model`, когда выбрана поддерживаемая модель. Текущий уровень усилий также показывается в заголовке сеанса рядом с именем модели, например "with low effort", поэтому вы можете подтвердить, какой параметр активен, без открытия `/model`. Нижний колонтитул также кратко показывает уровень усилий при запуске и при его изменении.677Ползунок усилий появляется в `/model`, когда выбрана поддерживаемая модель. Текущий уровень усилий также показывается в заголовке сеанса рядом с именем модели, например "with low effort", поэтому вы можете подтвердить, какой параметр активен, без открытия `/model`. Нижний колонтитул также кратко показывает уровень усилий при запуске и при его изменении.

695Расширенное размышление — это рассуждение, которое Claude выдает перед ответом. На моделях, которые поддерживают [адаптивное рассуждение](#adjust-effort-level), уровень усилий является основным управлением тем, сколько размышления происходит; параметры ниже включают или отключают размышление и управляют тем, как оно отображается. С отключенным размышлением на Anthropic API Claude Code отправляет усилия `high` вместо более высокого уровня моделям, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.693Расширенное размышление — это рассуждение, которое Claude выдает перед ответом. На моделях, которые поддерживают [адаптивное рассуждение](#adjust-effort-level), уровень усилий является основным управлением тем, сколько размышления происходит; параметры ниже включают или отключают размышление и управляют тем, как оно отображается. С отключенным размышлением на Anthropic API Claude Code отправляет усилия `high` вместо более высокого уровня моделям, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.

696 694 

697| Управление | Как его установить |695| Управление | Как его установить |

698| :------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |696| :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

699| Переключение для текущего сеанса | Нажмите `Option+T` на macOS или `Alt+T` на Windows и Linux |697| Переключение для текущего сеанса | Нажмите `Option+T` на macOS или `Alt+T` на Windows и Linux |

700| Установка глобального стандартного | Запустите `/config` и переключите режим размышления. Сохранено как `alwaysThinkingEnabled` в `~/.claude/settings.json` |698| Установка глобального стандартного | Запустите `/config` и переключите режим размышления. Сохранено как `alwaysThinkingEnabled` в `~/.claude/settings.json` |

701| Отключение через переменную окружения | Установите [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает размышление на Anthropic API, кроме моделей Fable. На [сторонних поставщиках](/docs/ru/third-party-integrations) Claude Code опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать. Другие значения применяются только с [фиксированным бюджетом размышления](#adaptive-reasoning-and-fixed-thinking-budgets) |699| Отключение через переменную окружения | Установите [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает размышление на Anthropic API, кроме Opus 5.5 и моделей Fable. На [сторонних поставщиках](/docs/ru/third-party-integrations) Claude Code опускает параметр `thinking` вместо этого, и модели адаптивного рассуждения все еще могут думать. Другие значения применяются только с [фиксированным бюджетом размышления](#adaptive-reasoning-and-fixed-thinking-budgets) |

702 700 

703Вы не можете отключить размышление на моделях Fable. Переключение сеанса, `alwaysThinkingEnabled` и `MAX_THINKING_TOKENS=0` не имеют эффекта там, и модель Fable решает на каждом шаге, сколько думать на основе уровня усилий.701Вы не можете отключить размышление на Opus 5.5 или моделях Fable. Переключение сеанса, `alwaysThinkingEnabled` и `MAX_THINKING_TOKENS=0` не имеют эффекта там, и модель решает на каждом шаге, сколько думать на основе уровня усилий.

704 702 

705Claude Code сворачивает вывод размышления по умолчанию. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждение как серый курсивный текст. Интерактивные сеансы на Anthropic API получают отредактированные блоки размышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/docs/ru/settings), если вы хотите, чтобы полные резюме были доступны при расширении. Вам выставляется счет за все сгенерированные токены размышления, даже когда они свернуты или отредактированы.703Claude Code сворачивает вывод размышления по умолчанию. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждение как серый курсивный текст. Интерактивные сеансы на Anthropic API получают отредактированные блоки размышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/docs/ru/settings), если вы хотите, чтобы полные резюме были доступны при расширении. Вам выставляется счет за все сгенерированные токены размышления, даже когда они свернуты или отредактированы.

706 704 

786Если вы не установите окно auto-compact, Claude Code выполняет компактирование, когда разговор достигает предела контекста модели, за исключением этих сеансов:784Если вы не установите окно auto-compact, Claude Code выполняет компактирование, когда разговор достигает предела контекста модели, за исключением этих сеансов:

787 785 

788* [Cloud sessions](/docs/ru/claude-code-on-the-web) выполняют компактирование по мере приближения разговора к пределу модели786* [Cloud sessions](/docs/ru/claude-code-on-the-web) выполняют компактирование по мере приближения разговора к пределу модели

789* Sonnet 4.6 и Opus 4.6 без [extended context](#extended-context) выполняют компактирование на границе 200K, как и Opus 4.8 и Opus 5 при работе с контекстным окном 200K, например на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry787* Sonnet 4.6 и Opus 4.6 без [extended context](#extended-context) выполняют компактирование на границе 200K, как и Opus 4.8 и более поздние версии при работе с контекстным окном 200K, например на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry

790* Когда вы установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют компактирование на границе 200K788* Когда вы установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют компактирование на границе 200K

791* Модели, работающие с собственным окном 1M, такие как Sonnet 5, модели Fable и Opus 4.7 и более поздние версии на Anthropic API, выполняют компактирование перед заполнением окна, примерно на 967K токенов по умолчанию. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry раздел [Pin models for third-party deployments](#pin-models-for-third-party-deployments) указывает, какие модели работают с этим окном; для конфигураций, которые бюджетируют Sonnet 5 на 200K, см. [Sonnet 5 context window](#sonnet-5-context-window)789* Модели, работающие с собственным окном 1M, такие как Sonnet 5, модели Fable и Opus 4.7 и более поздние версии на Anthropic API, выполняют компактирование перед заполнением окна, примерно на 967K токенов по умолчанию. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry раздел [Pin models for third-party deployments](#pin-models-for-third-party-deployments) указывает, какие модели работают с этим окном; для конфигураций, которые бюджетируют Sonnet 5 на 200K, см. [Sonnet 5 context window](#sonnet-5-context-window)

792* Сеансы на ID модели, которую Claude Code не распознаёт, такие как псевдоним [LLM gateway](/docs/ru/llm-gateway), выполняют компактирование при контекстном окне, которое Claude Code предполагает для ID; см. [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)790* Сеансы на ID модели, которую Claude Code не распознаёт, такие как псевдоним [LLM gateway](/docs/ru/llm-gateway), выполняют компактирование при контекстном окне, которое Claude Code предполагает для ID; см. [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)

831Этот пример устанавливает все три переменные, чтобы сделать развертывание Opus с маршрутизацией через шлюз выбираемым. Claude Code читает переменные окружения при запуске, поэтому запустите экспорты перед запуском `claude` или перезагрузите существующий сеанс, чтобы их применить:829Этот пример устанавливает все три переменные, чтобы сделать развертывание Opus с маршрутизацией через шлюз выбираемым. Claude Code читает переменные окружения при запуске, поэтому запустите экспорты перед запуском `claude` или перезагрузите существующий сеанс, чтобы их применить:

832 830 

833```bash theme={null}831```bash theme={null}

834export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5"832export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5-5"

835export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"833export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"

836export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"834export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

837```835```

847 845 

848Когда установлено значение [`availableModels`](#restrict-model-selection), включите пользовательский идентификатор модели в список разрешений. В противном случае Claude Code фильтрует пользовательскую запись из средства выбора и отклоняет выбор `--model` для неё, как и для любой другой исключённой модели.846Когда установлено значение [`availableModels`](#restrict-model-selection), включите пользовательский идентификатор модели в список разрешений. В противном случае Claude Code фильтрует пользовательскую запись из средства выбора и отклоняет выбор `--model` для неё, как и для любой другой исключённой модели.

849 847 

850Пользовательский идентификатор, который встраивает имя семейства, такой как `my-gateway/claude-opus-5`, считается конкретной записью для этого семейства и отключает его подстановочный знак, поэтому также перечислите версии, которые вы намереваетесь оставить выбираемыми. См. [Поведение слияния](#merge-behavior).848Пользовательский идентификатор, который встраивает имя семейства, такой как `my-gateway/claude-opus-5-5`, считается конкретной записью для этого семейства и отключает его подстановочный знак, поэтому также перечислите версии, которые вы намереваетесь оставить выбираемыми. См. [Поведение слияния](#merge-behavior).

851 849 

852<h2 id="environment-variables">850<h2 id="environment-variables">

853 Переменные окружения851 Переменные окружения

Details

123| `OTEL_LOG_ASSISTANT_RESPONSES` | Включить логирование текста ответа ассистента на событиях `assistant_response` (по умолчанию: отключено). Если не установлено, возвращается к значению `OTEL_LOG_USER_PROMPTS`. Требует Claude Code v2.1.193 или позже | `1` для включения, `0` для сохранения скрытым |123| `OTEL_LOG_ASSISTANT_RESPONSES` | Включить логирование текста ответа ассистента на событиях `assistant_response` (по умолчанию: отключено). Если не установлено, возвращается к значению `OTEL_LOG_USER_PROMPTS`. Требует Claude Code v2.1.193 или позже | `1` для включения, `0` для сохранения скрытым |

124| `OTEL_LOG_TOOL_DETAILS` | Включить логирование параметров инструмента и аргументов входных данных в событиях инструментов и атрибутах span трассировки: команды Bash, имена MCP сервера и инструмента, имена навыков, имена пользовательских рабочих процессов и входные данные инструмента. Также включает пользовательские, плагин и MCP имена команд на событиях `user_prompt` (по умолчанию: отключено). Для встроенных серверов Claude Desktop в сеансах, которыми владеет Claude Desktop, `mcp_server_name`/`mcp_tool_name` выдаются на `tool_decision`/`tool_result` даже с отключенным флагом. Исключение требует Claude Code v2.1.214 или позже | `1` для включения |124| `OTEL_LOG_TOOL_DETAILS` | Включить логирование параметров инструмента и аргументов входных данных в событиях инструментов и атрибутах span трассировки: команды Bash, имена MCP сервера и инструмента, имена навыков, имена пользовательских рабочих процессов и входные данные инструмента. Также включает пользовательские, плагин и MCP имена команд на событиях `user_prompt` (по умолчанию: отключено). Для встроенных серверов Claude Desktop в сеансах, которыми владеет Claude Desktop, `mcp_server_name`/`mcp_tool_name` выдаются на `tool_decision`/`tool_result` даже с отключенным флагом. Исключение требует Claude Code v2.1.214 или позже | `1` для включения |

125| `OTEL_LOG_TOOL_CONTENT` | Включить логирование содержимого инструмента в событии span [`tool.output`](#tool-output-span-event) (по умолчанию: отключено). Атрибуты span несут содержимое инструмента под [их собственными вентилями](#new-context-gates). Требует [трассировку](#traces-beta). Содержимое усекается на лимит содержимого (60 КБ по умолчанию) | `1` для включения |125| `OTEL_LOG_TOOL_CONTENT` | Включить логирование содержимого инструмента в событии span [`tool.output`](#tool-output-span-event) (по умолчанию: отключено). Атрибуты span несут содержимое инструмента под [их собственными вентилями](#new-context-gates). Требует [трассировку](#traces-beta). Содержимое усекается на лимит содержимого (60 КБ по умолчанию) | `1` для включения |

126| `OTEL_LOG_MANAGED_SETTINGS` | Добавить скрытые управляемые параметры и дайджест SHA-256 параметров перед скрытием в события [управляемые параметры разрешены](#managed-settings-resolved-event) (по умолчанию: отключено). Значение в параметрах проекта или локальных параметрах не включает его. Требует Claude Code v2.1.274 или позже | `1` для включения |

126| `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` в событии |127| `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` в событии |

127| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Лимит содержимого: максимальная длина атрибутов, содержащих содержимое, таких как ответы модели, содержимое инструмента, системные подсказки и тела сырого API, включая маркер усечения, в единицах кода UTF-16 (по умолчанию: 61440, т.е. 60 КБ). По умолчанию размер рассчитан для бэкендов, которые ограничивают значения атрибутов на 64 КБ; увеличивайте его только если ваш бэкенд принимает большие значения, или уменьшайте его для снижения объема телеметрии. Когда установлен лимит атрибутов OpenTelemetry SDK, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` или один из его вариантов logrecord и span, Claude Code усекает на это меньшее значение, чтобы маркер `[TRUNCATED ...]` оставался в пределах лимита SDK. Требует Claude Code v2.1.214 или позже | `262144` |128| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Лимит содержимого: максимальная длина атрибутов, содержащих содержимое, таких как ответы модели, содержимое инструмента, системные подсказки и тела сырого API, включая маркер усечения, в единицах кода UTF-16 (по умолчанию: 61440, т.е. 60 КБ). По умолчанию размер рассчитан для бэкендов, которые ограничивают значения атрибутов на 64 КБ; увеличивайте его только если ваш бэкенд принимает большие значения, или уменьшайте его для снижения объема телеметрии. Когда установлен лимит атрибутов OpenTelemetry SDK, `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` или один из его вариантов logrecord и span, Claude Code усекает на это меньшее значение, чтобы маркер `[TRUNCATED ...]` оставался в пределах лимита SDK. Требует Claude Code v2.1.214 или позже | `262144` |

128| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Предпочтение временности метрик (по умолчанию: `delta`). Установите на `cumulative`, если ваш бэкенд ожидает кумулятивную временность | `delta`, `cumulative` |129| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | Предпочтение временности метрик (по умолчанию: `delta`). Установите на `cumulative`, если ваш бэкенд ожидает кумулятивную временность | `delta`, `cumulative` |

241| `workflow.run_id` | Идентификатор запуска инструмента [Workflow](/docs/ru/workflows), который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порожденных рабочим процессом | |242| `workflow.run_id` | Идентификатор запуска инструмента [Workflow](/docs/ru/workflows), который породил этого агента, с префиксом `wf_`. Отсутствует для агентов, не порожденных рабочим процессом | |

242| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если gate не установлен | `OTEL_LOG_TOOL_DETAILS` |243| `workflow.name` | Имя рабочего процесса, который породил этого агента. Имена, созданные пользователем, заменяются на `custom`, если gate не установлен | `OTEL_LOG_TOOL_DETAILS` |

243| `speed` | `fast` или `normal` | |244| `speed` | `fast` или `normal` | |

245| `effort` | [Уровень усилий](/docs/ru/model-config#adjust-effort-level), применяемый к запросу: `low`, `medium`, `high`, `xhigh` или `max`. Отсутствует, когда Claude Code не отправляет уровень усилий, например на модели, которая не поддерживает усилия. Требует Claude Code v2.1.274 или позже | |

244| `llm_request.context` | `interaction`, `tool` или `standalone` в зависимости от родительского span | |246| `llm_request.context` | `interaction`, `tool` или `standalone` в зависимости от родительского span | |

245| `duration_ms` | Длительность в реальном времени, включая повторные попытки | |247| `duration_ms` | Длительность в реальном времени, включая повторные попытки | |

246| `ttft_ms` | Время до первого токена в миллисекундах | |248| `ttft_ms` | Время до первого токена в миллисекундах | |

385echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"387echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

386```388```

387 389 

388Если помощник не удается или выводит содержимое, которое не соответствует этим требованиям, Claude Code сообщает об ошибке в:390Если помощник не удается или выводит содержимое, которое не соответствует этим требованиям, экспорты не удаются и ваш бэкенд телеметрии не получает ничего из сеанса до тех пор, пока помощник не будет работать снова. Claude Code сообщает об ошибке в:

389 391 

392* Уведомлении предупреждения в интерактивных сеансах, [`otelHeadersHelper failed; telemetry is not being exported`](/docs/ru/errors#otelheadershelper-failed), показано один раз за сеанс, когда помощник впервые не удается

390* выводе `/status`393* выводе `/status`

391* журнале отладки при запуске с [`--debug`](/docs/ru/cli-reference#cli-flags) или после запуска `/debug` в сеансе394* журнале отладки при запуске с [`--debug`](/docs/ru/cli-reference#cli-flags) или после запуска `/debug` в сеансе

392* stderr в неинтерактивных сеансах, запущенных с `-p`395* stderr в неинтерактивных сеансах, запущенных с `-p`

712| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |715| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

713| `prompt.id` | Идентификатор UUID v4, связывающий все события, созданные при обработке одной пользовательской подсказки |716| `prompt.id` | Идентификатор UUID v4, связывающий все события, созданные при обработке одной пользовательской подсказки |

714| `event.sequence` | Счетчик на основе 0 для упорядочивания событий, подсчитываемый для каждого процесса Claude Code, а не для каждого сеанса |717| `event.sequence` | Счетчик на основе 0 для упорядочивания событий, подсчитываемый для каждого процесса Claude Code, а не для каждого сеанса |

715| `message.uuid` | UUID сообщения, как сохраненного в транскрипте сеанса, файлы `~/.claude/projects/*/*.jsonl`. Присутствует на `assistant_response` и на `user_prompt`, кроме отправок команд, которые могут создавать ноль или много сообщений. На `assistant_response` это финальная запись транскрипта ответа, от которой цепляется `parentUuid` следующего хода. Требует Claude Code v2.1.214 или позже |718| `message.uuid` | UUID сообщения, как сохраненного в транскрипте сеанса, файлы `~/.claude/projects/*/*.jsonl`. Присутствует на `assistant_response`, на `api_response_body` и на `user_prompt`, кроме отправок команд, которые могут создавать ноль или много сообщений. На `assistant_response` и `api_response_body` это финальная запись транскрипта ответа, от которой цепляется `parentUuid` следующего хода. Требует Claude Code v2.1.214 или позже, или v2.1.274 или позже на `api_response_body` |

716| `client_request_id` | UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Присутствует на `api_request` и `api_error` на подключениях API первой стороны; отсутствует на бэкендах поставщиков третьих сторон и когда запрос был повторен через резервный вариант без потоковой передачи. Связывает запрос с его ответом и остается доступным для сбоев, таких как тайм-ауты, которые никогда не создали `request_id` сервера. Совпадает с тем же атрибутом на span трассировки `llm_request`. Требует Claude Code v2.1.214 или позже |719| `client_request_id` | UUID, созданный клиентом, отправленный как заголовок запроса `x-client-request-id`. Присутствует на `api_request` и `api_error` на подключениях API первой стороны; отсутствует на бэкендах поставщиков третьих сторон и когда запрос был повторен через резервный вариант без потоковой передачи. Связывает запрос с его ответом и остается доступным для сбоев, таких как тайм-ауты, которые никогда не создали `request_id` сервера. Совпадает с тем же атрибутом на span трассировки `llm_request`. Требует Claude Code v2.1.214 или позже |

717 720 

718Чтобы отследить всю активность, вызванную одной подсказкой, отфильтруйте события по определенному значению `prompt.id`. Это возвращает событие user\_prompt, любые события api\_request и любые события tool\_result, которые произошли при обработке этой подсказки.721Чтобы отследить всю активность, вызванную одной подсказкой, отфильтруйте события по определенному значению `prompt.id`. Это возвращает событие user\_prompt, любые события api\_request и любые события tool\_result, которые произошли при обработке этой подсказки.

721 724 

722Для восстановления на уровне сообщений каждый класс событий содержит ключ, который совпадает с полем в транскрипте сеанса. Формат записи транскрипта [внутренний для Claude Code](/docs/ru/sessions#where-transcripts-are-stored) и изменяется между версиями, поэтому конвейер, который объединяет эти поля, может сломаться при любом выпуске; рассматривайте объединения как специфичные для версии, а не как стабильный контракт:725Для восстановления на уровне сообщений каждый класс событий содержит ключ, который совпадает с полем в транскрипте сеанса. Формат записи транскрипта [внутренний для Claude Code](/docs/ru/sessions#where-transcripts-are-stored) и изменяется между версиями, поэтому конвейер, который объединяет эти поля, может сломаться при любом выпуске; рассматривайте объединения как специфичные для версии, а не как стабильный контракт:

723 726 

724* `message.uuid` на `user_prompt` и `assistant_response`727* `message.uuid` на `user_prompt`, `assistant_response` и `api_response_body`

725* `request_id` на событиях API, сохраненный как `requestId` на записях помощника транскрипта728* `request_id` на событиях API, сохраненный как `requestId` на записях помощника транскрипта

726* `tool_use_id` на событиях `tool_result` и `tool_decision`729* `tool_use_id` на событиях `tool_result` и `tool_decision`

727 730 

1342* `files_past_cutoff`: Файлы, старше чем период удержания, которые очистка не смогла удалить, например из-за ошибки разрешения или файла, удерживаемого открытым. Значение выше нуля означает, что файлы пережили настроенный период удержания; ноль не является доказательством того, что они не были, потому что неудачное удаление целого каталога учитывается в `error_count` вместо этого1345* `files_past_cutoff`: Файлы, старше чем период удержания, которые очистка не смогла удалить, например из-за ошибки разрешения или файла, удерживаемого открытым. Значение выше нуля означает, что файлы пережили настроенный период удержания; ноль не является доказательством того, что они не были, потому что неудачное удаление целого каталога учитывается в `error_count` вместо этого

1343* `error_count`: Количество ошибок, которые очистка встретила при перечислении или удалении файлов1346* `error_count`: Количество ошибок, которые очистка встретила при перечислении или удалении файлов

1344 1347 

1348<h4 id="managed-settings-resolved-event">

1349 Событие разрешения управляемых параметров

1350</h4>

1351 

1352Логируется с [управляемыми параметрами](/docs/ru/managed-settings), которые сеанс разрешил: один раз при запуске сеанса, снова когда либо управляемые параметры, либо состояние [помощника политики](/docs/ru/managed-settings#compute-the-policy-with-a-helper-program) изменяется во время сеанса, и когда Claude Code отказывает в запуске или завершает сеанс по одной из причин, которые список атрибутов `error.type`.

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

1354Требует Claude Code v2.1.274 или позже.

1355 

1356По умолчанию событие содержит управляемые источники и состояние помощника политики, но не сами параметры. Чтобы добавить отредактированный атрибут `managed_settings.settings` и дайджест `managed_settings.resolved_sha256`, установите `OTEL_LOG_MANAGED_SETTINGS=1`:

1357 

1358* Установите его в блоке `env` управляемых параметров, параметров пользователя или `--settings`, или в окружении, в котором вы запускаете Claude Code. Значение в параметрах проекта или локальных параметрах не включает его, потому что клонированный репозиторий может их писать.

1359* Управляемые параметры сервера могут установить его без отображения [диалога одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs), потому что переменная только добавляет вашу собственную отредактированную политику организации к событию, которое ваша организация уже получает.

1360 

1361В интерактивном сеансе в папке, которую вы не [доверили](/docs/ru/permissions#what-runs-before-you-trust-a-folder), Claude Code не экспортирует событие отказа, потому что параметры проекта и локальные параметры могут указать экспорт на другой сборщик перед доверием.

1362 

1363**Имя события**: `claude_code.managed_settings_resolved`

1364 

1365**Атрибуты**:

1366 

1367* Все [стандартные атрибуты](#standard-attributes)

1368* `event.name`: `"managed_settings_resolved"`

1369* `event.timestamp`: Временная метка ISO 8601

1370* `event.sequence`: счетчик для каждого процесса для упорядочивания событий, описанный в разделе [Атрибуты корреляции событий](#event-correlation-attributes)

1371* `managed_settings.trigger`: `"startup"` для события запуска сеанса, `"change"` когда управляемые параметры или состояние помощника политики изменились позже в сеансе, или `"refused"` когда политика управляемых параметров остановила сеанс. Claude Code отправляет событие `change` только когда атрибут отличается от последнего события, которое он отправил, и измененное значение параметра считается даже когда `OTEL_LOG_MANAGED_SETTINGS` отключен

1372* `error.type`: почему Claude Code остановил сеанс. Присутствует только на событиях `refused`:

1373 * `"helper_failed"`: [запуск помощника политики не удался](/docs/ru/settings-reference#helper-failures)

1374 * `"policy_invalid"`: управляемые параметры содержат ошибку, которая останавливает Claude Code от запуска, или источник администратора не удалось загрузить, поэтому Claude Code не может проверить принудительное входа организации

1375 * `"consent_rejected"`: пользователь отклонил [диалог одобрения безопасности](/docs/ru/server-managed-settings#security-approval-dialogs) для управляемых параметров сервера

1376 * `"force_refresh_failed"`: выборка параметров, которую требует [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh), не удалась

1377 * `"gateway_rejected"`: [Claude apps gateway](/docs/ru/claude-apps-gateway) ответил на загрузку управляемых параметров с HTTP 403

1378 * `"version_below_minimum"`: эта версия Claude Code ниже [`requiredMinimumVersion`](/docs/ru/settings-reference#requiredminimumversion) или выше [`requiredMaximumVersion`](/docs/ru/settings-reference#requiredmaximumversion)

1379 * `"_OTHER"`: загрузка управляемых параметров Claude apps gateway не удалась по другой причине

1380* `managed_settings.sources`: каждый управляемый источник, который доставляет как минимум один [ключ политики](/docs/ru/managed-settings#how-claude-code-combines-managed-sources), наивысший приоритет первым, включая источники, чьи ключи не вступают в силу в `first-wins`. Значения это `"remote"`, `"plist"` или `"hklm"` для политики MDM или уровня ОС, `"file"` для управляемых файлов параметров и drop-ins, `"parent"` когда [хост встраивания](/docs/ru/managed-settings#let-an-embedding-host-add-policy) поставляет параметры, и `"hkcu"` для [значения реестра Windows HKCU](/docs/ru/managed-settings#where-each-mechanism-stores-the-policy) когда Claude Code [читает его](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Источник, который содержит только ключи управления, или который Claude Code не мог прочитать, не указан. Выдается как массив строк, пусто когда ни один управляемый источник не доставляет ключ политики

1381* `managed_settings.source_behavior`: значение [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior), которое Claude Code прочитал, `"first-wins"` или `"merge"`. `"first-wins"` когда ни один источник не устанавливает ключ

1382* `managed_settings.helper.state`: состояние помощника политики, который выбранный источник MDM или файла настраивает:

1383 * `"ok"`: выход помощника служит управляемыми параметрами

1384 * `"bad_path"`, `"not_a_file"`, `"exit_nonzero"`, `"timed_out"`, `"oversize"`, `"parse_failed"`, `"envelope_invalid"` или `"schema_rejected"`: последний запуск помощника не удался. [Сбои помощника](/docs/ru/settings-reference#helper-failures) описывает случаи

1385 * `"none"`: помощник не настроен, или источник, который его настраивает, не является политикой MDM или файлом управляемых параметров

1386* `managed_settings.helper.applied`: `"output"` пока выход помощника служит управляемыми параметрами, `"none"` когда он не служит

1387* `managed_settings.helper.entry`: `"policyHelper"` когда Claude Code выбрал [`policyHelper`](/docs/ru/settings-reference#policyhelper). Отсутствует когда он выбрал помощника

1388* `managed_settings.helper.path`: путь помощника [`path`](/docs/ru/settings-reference#policyhelper-path). Присутствует всякий раз, когда Claude Code выбрал помощника, независимо от того, установлен ли `OTEL_LOG_MANAGED_SETTINGS`

1389* `managed_settings.resolved_sha256` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): SHA-256 разрешенных управляемых параметров перед редактированием, сериализованный как JSON с ключами, отсортированными рекурсивно и без пробелов. Машины с одинаковым дайджестом запускают одну и ту же политику. Claude Code отправляет дайджест только с opt-in, потому что короткая политика может быть восстановлена путем хеширования предположений. Отсутствует когда управляемые параметры не разрешены, и на событиях `refused`

1390* `managed_settings.settings` (когда `OTEL_LOG_MANAGED_SETTINGS=1`): имена и форма разрешенных управляемых параметров как JSON строка, с отредактированными значениями. Отсутствует на событиях `refused`. Claude Code строит его из своей схемы параметров:

1391 

1392 * Имя параметра, которое схема объявляет, экспортируется, и ключ, который она не объявляет, опускается

1393 * Логические значения, числа и строковые значения, которые схема ограничивает фиксированным набором опций, такие как `permissions.defaultMode`, экспортируются как есть. `sandbox.network.httpProxyPort` и `sandbox.network.socksProxyPort` экспортируются как `"[REDACTED]"`

1394 * Каждая другая строка, такая как `model`, `apiKeyHelper`, каждое значение `env`, каждый URL и каждая команда, экспортируется как `"[REDACTED]"`

1395 * Имена записей карт, такие как имена переменных `env` и ID плагинов, экспортируются как есть. Параметр, чьи записи схема не типирует, такой как `vimInsertModeRemaps`, экспортируется как одно `"[REDACTED]"`, и `sandbox.ignoreViolations` экспортируется как список его списков путей без шаблонов команд

1396 * Список сохраняет свою длину, с каждой записью отредактированной по тем же правилам

1397 * Правило `permissions.allow`, `permissions.deny` или `permissions.ask` экспортируется как его имя инструмента с отредактированным содержимым, такой как `Read([REDACTED])`, когда инструмент встроен в эту версию Claude Code или является ссылкой `mcp__`, такой как `mcp__jira__create_issue`. Любое другое правило экспортируется как `"[REDACTED]"`

1398 * Hooks следуют тем же правилам, поэтому поля с фиксированными опциями и числовые поля, такие как `type` и `timeout`, показываются, пока каждая команда, URL, `matcher` и условие `if` экспортируется как `"[REDACTED]"`

1399 

1400 Например, управляемые параметры с `apiKeyHelper`, двумя переменными `env` и правилом отказа экспортируются как `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.

1401 

1402 Claude Code обрезает значение на 8 КБ UTF-8, и обрезанное значение не является действительным JSON

1403* `managed_settings.settings_truncated` (когда `managed_settings.settings` присутствует): `true` когда Claude Code обрезал `managed_settings.settings` на 8 КБ, `false` в противном случае. Выдается как логическое значение, а не строка.

1404 

1345<h2 id="interpret-metrics-and-events-data">1405<h2 id="interpret-metrics-and-events-data">

1346 Интерпретация данных метрик и событий1406 Интерпретация данных метрик и событий

1347</h2>1407</h2>

1461При построении правил обнаружения найдите сигнал, который вы хотите отслеживать, и запросите ваш бэкенд для соответствующего события и атрибутов:1521При построении правил обнаружения найдите сигнал, который вы хотите отслеживать, и запросите ваш бэкенд для соответствующего события и атрибутов:

1462 1522 

1463| Сигнал | Событие | Ключевые атрибуты |1523| Сигнал | Событие | Ключевые атрибуты |

1464| ------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------ |1524| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1465| Вызов инструмента разрешен или отклонен, и почему | `tool_decision` | `decision`, `source`, `tool_name`, `tool_parameters` |1525| Вызов инструмента разрешен или отклонен, и почему | `tool_decision` | `decision`, `source`, `tool_name`, `tool_parameters` |

1466| Эскалация режима разрешений | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |1526| Эскалация режима разрешений | `permission_mode_changed` | `from_mode`, `to_mode`, `trigger` |

1467| Hook политики заблокировал действие | `hook_execution_complete` | `hook_event`, `num_blocking` |1527| Hook политики заблокировал действие | `hook_execution_complete` | `hook_event`, `num_blocking` |

1469| Подключение MCP сервера или сбой | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |1529| Подключение MCP сервера или сбой | `mcp_server_connection` | `status`, `server_name`, `is_plugin`, `error_code` |

1470| Установленный плагин и его источник | `plugin_installed` | `plugin.name`, `marketplace.name`, `marketplace.is_official` |1530| Установленный плагин и его источник | `plugin_installed` | `plugin.name`, `marketplace.name`, `marketplace.is_official` |

1471| Запущенные команды и затронутые файлы | `tool_result` (выполнено) или `tool_decision` (отклонено) с `OTEL_LOG_TOOL_DETAILS=1` | `tool_parameters`; `tool_input` (только `tool_result`) |1531| Запущенные команды и затронутые файлы | `tool_result` (выполнено) или `tool_decision` (отклонено) с `OTEL_LOG_TOOL_DETAILS=1` | `tool_parameters`; `tool_input` (только `tool_result`) |

1532| Какие источники управляемых параметров запускает машина, здорова ли её помощник политики и почему машина отказалась запускаться | `managed_settings_resolved` | `managed_settings.trigger`, `managed_settings.sources`, `managed_settings.source_behavior`, `managed_settings.helper.state`, `error.type`; `managed_settings.settings` и `managed_settings.resolved_sha256` с `OTEL_LOG_MANAGED_SETTINGS=1` |

1472 1533 

1473Claude Code выдает только поток исходных событий. Обнаружение аномалий, базирование, корреляция между сеансами и оповещение являются ответственностью вашего SIEM или бэкенда наблюдаемости.1534Claude Code выдает только поток исходных событий. Обнаружение аномалий, базирование, корреляция между сеансами и оповещение являются ответственностью вашего SIEM или бэкенда наблюдаемости.

1474 1535 

network-config.md +15 −14

Details

230 Требования к доступу в сеть230 Требования к доступу в сеть

231</h2>231</h2>

232 232 

233Claude Code требует доступа к следующим URL-адресам. Добавьте их в белый список в конфигурации прокси и правилах брандмауэра, особенно в контейнеризованных или ограниченных сетевых средах. Проверка подключения при первом запуске указывает на эти адреса, когда не может достичь `api.anthropic.com` или `platform.claude.com`; см. [Unable to connect to Anthropic services](/docs/ru/errors#unable-to-connect-to-anthropic-services) для сообщений проверки и шагов восстановления.233Claude Code требует доступа к следующим URL-адресам. Добавьте их в белый список конфигурации прокси и правил брандмауэра, особенно в контейнеризованных или ограниченных сетевых средах. Проверка подключения при первом запуске указывает сюда, когда не может достичь `api.anthropic.com` или `platform.claude.com`; см. [Unable to connect to Anthropic services](/docs/ru/errors#unable-to-connect-to-anthropic-services) для сообщений проверки и шагов восстановления.

234 234 

235| URL | Требуется для |235| URL | Требуется для |

236| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |236| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

242| `downloads.claude.ai` | Загрузки исполняемых файлов плагинов; собственный установщик, собственный автоматический обновитель и проверки версий обновлений |242| `downloads.claude.ai` | Загрузки исполняемых файлов плагинов; собственный установщик, собственный автоматический обновитель и проверки версий обновлений |

243| `storage.googleapis.com` | Количество установок плагинов и метаданные, показанные в `/plugin` |243| `storage.googleapis.com` | Количество установок плагинов и метаданные, показанные в `/plugin` |

244| `storage.googleapis.com` | Собственный установщик и собственный автоматический обновитель в версиях до 2.1.116 |244| `storage.googleapis.com` | Собственный установщик и собственный автоматический обновитель в версиях до 2.1.116 |

245| `registry.npmjs.org` | Установки плагинов (получение пакетов плагинов из npm-источника и установка зависимостей пакетов Node.js плагинов), MCP-серверы, запущенные через `npx`, и реестр пакетов для установок npm и bun самого Claude Code |245| `registry.npmjs.org` | Установки плагинов (получение пакетов плагинов из источника npm и установка зависимостей пакетов Node.js плагинов), MCP-серверы, запущенные через `npx`, и реестр пакетов для установок npm и bun самого Claude Code |

246| `bridge.claudeusercontent.com` | [Claude in Chrome](/docs/ru/chrome) расширение WebSocket bridge |246| `bridge.claudeusercontent.com` | [Claude in Chrome](/docs/ru/chrome) расширение WebSocket bridge |

247| `*.frame.claudeusercontent.com` | [Artifact](/docs/ru/artifacts) чтение содержимого. CLI получает файлы артефакта с этого хоста, когда Claude открывает его, и только когда инструмент Artifact [доступен](/docs/ru/artifacts#availability) для вашей учетной записи. Чтобы отключить инструмент и удалить это требование, установите [`"enableArtifact": false`](/docs/ru/settings-reference#enableartifact) или [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/ru/env-vars); Claude Code также соблюдает устаревший параметр [`disableArtifact`](/docs/ru/settings-reference#disableartifact). См. [Disable artifacts](/docs/ru/artifacts#disable-artifacts) для того, как эти параметры взаимодействуют |247| `*.frame.claudeusercontent.com` | [Artifact](/docs/ru/artifacts) чтение содержимого. CLI получает файлы артефакта с этого хоста, когда Claude открывает его, и только когда инструмент Artifact [доступен](/docs/ru/artifacts#availability) для вашей учетной записи. Чтобы отключить инструмент и удалить это требование, установите [`"enableArtifact": false`](/docs/ru/settings-reference#enableartifact) или [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/ru/env-vars); Claude Code также соблюдает устаревший параметр [`disableArtifact`](/docs/ru/settings-reference#disableartifact). См. [Disable artifacts](/docs/ru/artifacts#disable-artifacts) для того, как эти параметры взаимодействуют |

248| `github.com` | Клонирование размещенных на GitHub [plugin marketplaces](/docs/ru/plugin-marketplaces) и плагинов, включая официальный рынок Anthropic, через HTTPS или SSH. Чтобы клонировать источники GitHub `owner/repo` только через HTTPS, установите [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ru/env-vars) |

248| `raw.githubusercontent.com` | Лента изменений для [`/release-notes`](/docs/ru/commands). В интерактивных сеансах Claude Code также получает ее в фоновом режиме при запуске, когда его кэшированная лента изменений еще не охватывает запущенную версию, например при первом запуске после обновления; неинтерактивные и облачные сеансы никогда не получают ее |249| `raw.githubusercontent.com` | Лента изменений для [`/release-notes`](/docs/ru/commands). В интерактивных сеансах Claude Code также получает ее в фоновом режиме при запуске, когда его кэшированная лента изменений еще не охватывает запущенную версию, например при первом запуске после обновления; неинтерактивные и облачные сеансы никогда не получают ее |

249| `*-review.googlesource.com` | Поиск изменений Gerrit для рабочих копий с `googlesource.com`. Когда сеанс вкладки Claude Desktop Code запускается или возобновляется в [доверенной](/docs/ru/permissions#project-allow-rules-and-workspace-trust) рабочей копии, чей `origin` является хостом `googlesource.com`, Claude Code анонимно запрашивает сервер `-review` этого хоста для открытого изменения, соответствующего `Change-Id` HEAD, один раз за запуск или возобновление. Другие типы сеансов пропускают поиск, и никакой другой хост Gerrit не контактируется. Опционально: отключите с помощью [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars) |250| `*-review.googlesource.com` | Поиск изменений Gerrit на checkouts `googlesource.com`. Когда сеанс вкладки Claude Desktop Code запускается или возобновляется на [доверенном](/docs/ru/permissions#project-allow-rules-and-workspace-trust) checkout, чей `origin` является хостом `googlesource.com`, Claude Code анонимно запрашивает сервер `-review` этого хоста для открытого изменения, соответствующего `Change-Id` HEAD, один раз за запуск или возобновление. Другие типы сеансов пропускают поиск, и никакой другой хост Gerrit не контактируется. Опционально: отключите с помощью [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars) |

250| `http-intake.logs.us5.datadoghq.com` | События операционной телеметрии, отправляются только когда CLI использует Anthropic API напрямую, никогда для Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Опционально: отключите с помощью [`DISABLE_TELEMETRY`](/docs/ru/data-usage#telemetry-services) или `DO_NOT_TRACK` |251| `http-intake.logs.us5.datadoghq.com` | События операционной телеметрии, отправляемые только когда CLI использует Anthropic API напрямую, никогда для Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Опционально: отключите с помощью [`DISABLE_TELEMETRY`](/docs/ru/data-usage#telemetry-services) или `DO_NOT_TRACK` |

251| `browser-intake-us5-datadoghq.com` | Отчеты об операционных ошибках, отправляются когда CLI использует Anthropic API напрямую и вентиль развертывания на стороне сервера их включает. Опционально: отключите с помощью `DISABLE_ERROR_REPORTING` или `DISABLE_TELEMETRY`; см. [Telemetry services](/docs/ru/data-usage#telemetry-services) |252| `browser-intake-us5-datadoghq.com` | Отчеты об операционных ошибках, отправляемые когда CLI использует Anthropic API напрямую и вентиль развертывания на стороне сервера их включает. Опционально: отключите с помощью `DISABLE_ERROR_REPORTING` или `DISABLE_TELEMETRY`; см. [Telemetry services](/docs/ru/data-usage#telemetry-services) |

252| `formulae.brew.sh` | Проверки версий обновлений при установке Homebrew. Другие методы установки не контактируют с этим хостом |253| `formulae.brew.sh` | Проверки версий обновлений при установке Homebrew. Другие методы установки не контактируют этот хост |

253| `code.claude.com` | Поиски документации Claude Code встроенным агентом claude-code-guide и предварительно одобренными запросами WebFetch. Блокировка этого хоста влияет только на поиски документации |254| `code.claude.com` | Поиски документации Claude Code встроенным агентом claude-code-guide и предварительно одобренными запросами WebFetch. Блокировка этого хоста влияет только на поиски документации |

254 255 

255Если вы устанавливаете Claude Code через npm или управляете собственным распределением двоичных файлов, конечным пользователям не нужны использования собственного установщика и автоматического обновителя `downloads.claude.ai`, но установки npm и bun нуждаются в реестре пакетов, `registry.npmjs.org`, если только ваша организация его не зеркалирует. Другие использования в таблице применяются независимо от метода установки.256Если вы устанавливаете Claude Code через npm или управляете собственным распределением двоичных файлов, конечным пользователям не нужны собственный установщик и использование автоматического обновителя `downloads.claude.ai`, но установки npm и bun нуждаются в реестре пакетов, `registry.npmjs.org`, если только ваша организация его не зеркалирует. Другие использования в таблице применяются независимо от метода установки.

256 257 

257Два хоста приема Datadog содержат только опциональную операционную телеметрию, и установка [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars) отключает обе. Сеансы на сторонних поставщиках никогда не отправляют на эти хосты, даже когда платформа устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars) и метрики телеметрии включены по умолчанию. См. [Telemetry services](/docs/ru/data-usage#telemetry-services) для всего, что отправляет Claude Code и как это отключить перед финализацией вашего белого списка.258Два хоста приема Datadog содержат только опциональную операционную телеметрию, и установка [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars) отключает обе. Сеансы на сторонних поставщиках никогда не отправляют на эти хосты, даже когда платформа устанавливает [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars) и метрики телеметрии включены по умолчанию. См. [Telemetry services](/docs/ru/data-usage#telemetry-services) для всего, что отправляет Claude Code и как это отключить перед финализацией вашего белого списка.

258 259 

259При использовании [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), трафик модели и аутентификация идут к вашему поставщику или шлюзу вместо `api.anthropic.com`, `claude.ai` или `platform.claude.com`. Инструмент WebFetch по-прежнему вызывает `api.anthropic.com` для своей [domain safety check](/docs/ru/data-usage#webfetch-domain-safety-check) проверки безопасности домена, если вы не установите `skipWebFetchPreflight: true` в [settings](/docs/ru/settings).260При использовании [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), трафик модели и аутентификация идут к вашему поставщику или шлюзу вместо `api.anthropic.com`, `claude.ai` или `platform.claude.com`. Инструмент WebFetch по-прежнему вызывает `api.anthropic.com` для своей [проверки безопасности домена](/docs/ru/data-usage#webfetch-domain-safety-check), если вы не установите `skipWebFetchPreflight: true` в [settings](/docs/ru/settings).

260 261 

261При маршрутизации через [LLM gateway](/docs/ru/llm-gateway) с [`ANTHROPIC_BASE_URL`](/docs/ru/llm-gateway-connect#set-the-base-url-and-credential), проверка доступности [fast mode](/docs/ru/fast-mode) по-прежнему вызывает `api.anthropic.com` вместо базового URL шлюза. Проверка соблюдает настроенный HTTP-прокси, поэтому там, где причина является сетевой блокировкой, запись белого списка для `api.anthropic.com` в прокси является исправлением. Сетевая блокировка не проходит проверку только там, где хост недостижим даже через прокси, и быстрый режим затем сообщает об ошибке подключения. Та же ошибка подключения появляется, когда проверка представляет выданный шлюзом учетные данные, которые Anthropic отклоняет; белый список не помогает там, так как ничего не блокируется. См. [use fast mode behind proxies and LLM gateways](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) для переменных, которые его восстанавливают.262При маршрутизации через [LLM gateway](/docs/ru/llm-gateway) с [`ANTHROPIC_BASE_URL`](/docs/ru/llm-gateway-connect#set-the-base-url-and-credential), проверка доступности [fast mode](/docs/ru/fast-mode) по-прежнему вызывает `api.anthropic.com` вместо базового URL шлюза. Проверка соблюдает настроенный HTTP-прокси, поэтому там, где причиной является блокировка сети, запись белого списка для `api.anthropic.com` в прокси является исправлением. Блокировка сети не проходит проверку только там, где хост недостижим даже через прокси, и fast mode затем сообщает об ошибке подключения. Та же ошибка подключения появляется, когда проверка представляет выданное шлюзом учетные данные, которые Anthropic отклоняет; белый список не помогает там, так как ничего не блокируется. См. [use fast mode behind proxies and LLM gateways](/docs/ru/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) для переменных, которые его восстанавливают.

262 263 

263<h3 id="organization-ip-allowlists-and-proxy-egress">264<h3 id="organization-ip-allowlists-and-proxy-egress">

264 Белые списки IP организации и выход прокси265 Белые списки IP организации и выход прокси

272 Белые списки GitHub и брандмауэры273 Белые списки GitHub и брандмауэры

273</h3>274</h3>

274 275 

275[Cloud sessions](/docs/ru/claude-code-on-the-web) в размещенных Anthropic средах и [Code Review](/docs/ru/code-review) подключаются к вашим репозиториям из управляемой Anthropic инфраструктуры; сеансы в [self-hosted environment](/docs/ru/self-hosted-environments) подключаются изнутри вашей сети, если только исполнитель не согласится на [Anthropic git proxy](/docs/ru/self-hosted-environments-deploy#use-the-anthropic-git-proxy), который получает с стороны Anthropic.276[Cloud sessions](/docs/ru/claude-code-on-the-web) в размещенных Anthropic средах и [Code Review](/docs/ru/code-review) подключаются к вашим репозиториям из управляемой Anthropic инфраструктуры; сеансы в [self-hosted environment](/docs/ru/self-hosted-environments) подключаются изнутри вашей сети, если только runner не согласится на [Anthropic git proxy](/docs/ru/self-hosted-environments-deploy#use-the-anthropic-git-proxy), который получает со стороны Anthropic.

276 277 

277Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, включите [IP allow list inheritance for installed 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) и также [add an allow list entry](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-адресов](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) Anthropic. Наследование охватывает только запросы, которые делает приложение Claude GitHub как установка, а не запросы, которые оно делает от имени ваших пользователей. Для других брандмауэров см. [Anthropic API IP addresses](https://platform.claude.com/docs/en/api/ip-addresses).278Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, включите [IP allow list inheritance for installed 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) и также [add an allow list entry](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-адресов](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) Anthropic. Наследование охватывает только запросы, которые делает Claude GitHub App как установка, а не запросы, которые она делает от имени ваших пользователей. Для других брандмауэров см. [Anthropic API IP addresses](https://platform.claude.com/docs/en/api/ip-addresses).

278 279 

279Для самостоятельно размещенных экземпляров [GitHub Enterprise Server](/docs/ru/github-enterprise-server) за брандмауэром добавьте в белый список [исходящие IP-адреса](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) Anthropic, чтобы инфраструктура Anthropic могла достичь вашего хоста GHES для клонирования репозиториев и публикации комментариев рецензии. Сеансы в [self-hosted environment](/docs/ru/self-hosted-environments-deploy#configure-git) достигают вашего хоста GHES изнутри вашей сети вместо этого, поэтому это воздействие применяется только к сеансам, размещенным в Anthropic, к размещенным предварительным потокам сеанса, таким как средство выбора репозитория, и к самостоятельно размещенным исполнителям, которые согласились на [Anthropic git proxy](/docs/ru/self-hosted-environments-deploy#use-the-anthropic-git-proxy), который получает с стороны Anthropic. Для хоста GHES, который маршрутизируется только внутри вашей сети, [SCM connector](/docs/ru/self-hosted-environments-reference#scm-connector-flags) переносит размещенные предварительные потоки сеанса через исходящее соединение вместо этого, поэтому белый список не требуется для них.280Для размещенных на собственном сервере экземпляров [GitHub Enterprise Server](/docs/ru/github-enterprise-server) за брандмауэром добавьте в белый список [исходящие IP-адреса](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses) Anthropic, чтобы инфраструктура Anthropic могла достичь вашего хоста GHES для клонирования репозиториев и публикации комментариев рецензии. Сеансы в [self-hosted environment](/docs/ru/self-hosted-environments-deploy#configure-git) достигают вашего хоста GHES изнутри вашей сети вместо этого, поэтому это воздействие применяется только к сеансам, размещенным на Anthropic, к размещенным предварительным потокам сеанса, таким как средство выбора репозитория, и к размещенным на собственном сервере runners, которые согласятся на [Anthropic git proxy](/docs/ru/self-hosted-environments-deploy#use-the-anthropic-git-proxy), который получает со стороны Anthropic. Для хоста GHES, который маршрутизируется только внутри вашей сети, [SCM connector](/docs/ru/self-hosted-environments-reference#scm-connector-flags) переносит размещенные предварительные потоки сеанса через исходящее соединение вместо этого, поэтому белый список не требуется для них.

280 281 

281<h3 id="desktop-and-claude-ai">282<h3 id="desktop-and-claude-ai">

282 Desktop и claude.ai283 Desktop и claude.ai

284 285 

285Предыдущая таблица охватывает автономный CLI. Приложение Claude Desktop и claude.ai в браузере загружают код приложения и содержимое пользователя из дополнительных хостов CDN Anthropic, включая `assets-proxy.anthropic.com` и другие источники `*.claudeusercontent.com`, которые обслуживают [artifacts](/docs/ru/artifacts) в этих приложениях. Разрешение `claude.ai` при блокировке этих хостов создает пустую страницу вместо ошибки. См. [network access requirements](/docs/ru/desktop#network-access-requirements) на странице Desktop.286Предыдущая таблица охватывает автономный CLI. Приложение Claude Desktop и claude.ai в браузере загружают код приложения и содержимое пользователя из дополнительных хостов CDN Anthropic, включая `assets-proxy.anthropic.com` и другие источники `*.claudeusercontent.com`, которые обслуживают [artifacts](/docs/ru/artifacts) в этих приложениях. Разрешение `claude.ai` при блокировке этих хостов создает пустую страницу вместо ошибки. См. [network access requirements](/docs/ru/desktop#network-access-requirements) на странице Desktop.

286 287 

287[Artifact](/docs/ru/artifacts), который загружает шрифт из [Google Fonts](/docs/ru/artifacts#improve-the-visual-design), также запрашивает `fonts.googleapis.com` и `fonts.gstatic.com`. Оба хоста опциональны. Если вы их блокируете, артефакты отображаются в резервных шрифтах. Блокируйте с быстрым отклонением, а не с молчаливым отбросом, чтобы запрос шрифта не прошел немедленно вместо задержки первого отображения страницы.288[Artifact](/docs/ru/artifacts), который загружает шрифт из [Google Fonts](/docs/ru/artifacts#improve-the-visual-design), также запрашивает `fonts.googleapis.com` и `fonts.gstatic.com`. Оба хоста опциональны. Если вы их блокируете, артефакты отображаются в резервных шрифтах. Блокируйте с быстрым отклонением, а не с молчаливым отбросом, чтобы запрос шрифта немедленно не прошел вместо задержки первого отображения страницы.

288 289 

289Артефакты также могут загружать библиотеки JavaScript, такие как React или пакет диаграмм, из `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com` и `code.jquery.com`, и ни с какого другого внешнего хоста. Если вы блокируете эти хосты, части артефакта, которые зависят от библиотеки, не работают, и в отличие от заблокированного шрифта, заблокированная библиотека не имеет резервного варианта. Блокируйте с быстрым отклонением и здесь, чтобы заблокированный запрос библиотеки не прошел сразу, а не зависал до истечения времени ожидания.290Артефакты также могут загружать библиотеки JavaScript, такие как React или пакет диаграмм, из `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com`, `code.jquery.com` и `unpkg.com`, и ни с какого другого внешнего хоста. Если вы блокируете эти хосты, части артефакта, которые зависят от библиотеки, не работают, и в отличие от заблокированного шрифта, заблокированная библиотека не имеет резервного варианта. Блокируйте с быстрым отклонением и здесь, чтобы заблокированный запрос библиотеки немедленно не прошел вместо зависания до истечения времени ожидания.

290 291 

291<h2 id="additional-resources">292<h2 id="additional-resources">

292 Дополнительные ресурсы293 Дополнительные ресурсы

output-styles.md +124 −42

Details

4 4 

5# Output styles5# Output styles

6 6 

7> Адаптируйте Claude Code для использования за пределами разработки программного обеспечения7> Измените роль, тон и формат ответов Claude Code с помощью встроенного стиля вывода, такого как Concise или Explanatory, или напишите собственный стиль.

8 8 

9Output styles изменяют способ ответа Claude, а не то, что Claude знает. Они устанавливают роль Claude, тон и формат вывода для каждого ответа. Используйте один из них, когда вы постоянно переформулируете запросы для одного и того же голоса или формата на каждом ходу, или когда вы хотите, чтобы Claude действовал как что-то другое, чем инженер-программист.9Output style — это набор инструкций, которые устанавливают роль Claude, тон и формат ответов для каждого ответа в сеансе. Claude Code включает четыре встроенных стиля помимо стиля по умолчанию, и вы можете написать свой собственный.

10 10 

11Пользовательский output style предоставляет Claude ваши собственные инструкции и позволяет вам выбрать, сохранять ли встроенные инструкции Claude Code по разработке программного обеспечения. Сохраняйте их, когда вы изменяете способ общения Claude, но все еще кодируете, например всегда отвечаете диаграммой. Исключите их, когда Claude не занимается разработкой программного обеспечения вообще, например помощник по написанию текстов или аналитик данных.11Используйте output style, чтобы изменить способ ответа Claude и работы с вами на протяжении всего сеанса, чтобы вам не нужно было повторять запрос в каждом приглашении. Например, встроенный стиль может сделать ответы короче, добавить объяснение каждого изменения или заставить Claude начать работу без задания рутинных вопросов. Пользовательский стиль также может превратить Claude в что-то другое, чем инженер-программист, например в помощника по написанию текстов или аналитика данных.

12 12 

13Для инструкций о вашем проекте, соглашениях или кодовой базе используйте [CLAUDE.md](/docs/ru/memory) вместо этого.13* Чтобы использовать встроенный стиль, выберите один из [встроенных output styles](#built-in-output-styles) и [переключитесь на него](#change-your-output-style).

14* Чтобы написать свои собственные инструкции, [создайте пользовательский output style](#create-a-custom-output-style).

15 

16<Note>

17 Output style дает Claude инструкции для выполнения. Это не гарантирует, что что-то всегда происходит или никогда не происходит. Некоторые потребности соответствуют другой функции:

18 

19 * Для того, что Claude должен знать о вашем проекте, используйте [CLAUDE.md](/docs/ru/memory).

20 * Для чего-то, что должно происходить каждый раз, например форматирование после каждого редактирования или блокирование команды, используйте [hook](/docs/ru/hooks-guide).

21 * Для skills, subagents и других опций см. [Choose between an output style and other features](#choose-between-an-output-style-and-other-features).

22</Note>

14 23 

15<h2 id="built-in-output-styles">24<h2 id="built-in-output-styles">

16 Встроенные output styles25 Встроенные output styles

17</h2>26</h2>

18 27 

19**Default** output style Claude Code — это его стандартный набор инструкций, разработанный для эффективного выполнения задач разработки программного обеспечения.28Claude Code начинает работу в стиле [**Default**](#default), его стандартном наборе инструкций для выполнения задач разработки программного обеспечения. Каждый из четырёх других встроенных стилей сохраняет эти инструкции и добавляет свои собственные.

29 

30В этой таблице показано, что изменяет каждый стиль в сеансе и когда его использовать:

31 

32| Стиль | Что изменяется | Используйте, когда |

33| :-------------------------- | :---------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

34| [Proactive](#proactive) | Claude начинает работу сразу же и делает разумные предположения вместо того, чтобы спрашивать о рутинных решениях | Вы хотите, чтобы Claude продолжал работать через рутинные решения, и вы исправите курс, если предположение окажется неправильным |

35| [Concise](#concise) | Ответы начинаются с результата и опускают преамбулу, повествование и резюме | Ответы по умолчанию длиннее, чем вам нужно |

36| [Explanatory](#explanatory) | Claude добавляет короткие блоки `Insight`, которые объясняют выбор, стоящий за написанным им кодом | Вы знакомитесь с кодовой базой или хотите получить обоснование вместе с изменением |

37| [Learning](#learning) | Claude объясняет свой выбор и оставляет небольшие фрагменты кода для самостоятельного написания | Вы хотите получить практику кодирования, пока задача всё ещё выполняется |

38 

39<h3 id="default">

40 Default

41</h3>

42 

43Default означает, что не выбран никакой output style. Claude Code не добавляет инструкции стиля, и Claude работает из стандартного системного приглашения Claude Code, которое написано для задач разработки программного обеспечения.

44 

45`default` появляется в списке `/output-style` вместе с другими стилями, поэтому вы [выбираете его так же](#change-your-output-style).

46 

47<h3 id="proactive">

48 Proactive

49</h3>

50 

51В стиле Proactive Claude начинает реализацию сразу же после отправки задачи. Он делает разумные предположения о рутинных решениях вместо того, чтобы останавливаться и спрашивать, и не переходит в режим плана, если вы не попросите план. Вы можете перенаправить его в любой момент.

52 

53Инструкции стиля также говорят Claude проверить с вами в разговоре перед действием, которое удаляет данные или изменяет общую или производственную систему. Эта проверка — это инструкция, которую Claude следует, и она отделена от запросов разрешения.

54 

55Переключение на стиль Proactive не изменяет ваш [режим разрешений](/docs/ru/permission-modes). Ваш режим разрешений по-прежнему решает, какие вызовы инструментов выполняются без запроса, поэтому запросы разрешения появляются так же, как они появлялись до переключения.

56 

57<h3 id="concise">

58 Concise

59</h3>

60 

61В стиле Concise первое предложение ответа указывает, что произошло или какой ответ. Claude опускает вводную часть, пошаговое повествование и закрывающее резюме, и отвечает на простой вопрос в одно-три предложения. Он выполняет инженерную работу так же тщательно, как в стиле Default. Требует Claude Code v2.1.237 или позже.

62 

63Claude по-прежнему пишет в полном объёме в этих случаях:

64 

65* **Всё, что вы просите**: когда вы просите объяснение или больше деталей, Claude отвечает в полном объёме.

66* **Всё, что вам нужно для безопасного действия**: отчёты об ошибках, вывод неудачных тестов, предупреждения безопасности и подтверждения деструктивных действий сохраняют своё полное содержание.

67 

68<h3 id="explanatory">

69 Explanatory

70</h3>

71 

72В стиле Explanatory Claude выполняет задачу так же, как в стиле Default, и добавляет краткие объяснения того, почему он сделал выбор, который он сделал. Каждое объяснение появляется в разговоре, до или после кода, к которому оно относится, в блоке с меткой `Insight`. Объяснения не записываются в ваши файлы как комментарии.

20 73 

21Существует четыре дополнительных встроенных output style:74Блок `Insight` содержит две или три точки о вашей кодовой базе или коде, который написал Claude, например, этот после добавления конечной точки API:

22 75 

23* **Proactive**: Claude выполняет действия немедленно, делает разумные предположения вместо паузы для рутинных решений и предпочитает действие планированию. Это более сильное руководство по автономному выполнению, чем применяет [режим автоматизации](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode), и оно работает без изменения вашего режима разрешений, поэтому ваш режим разрешений по-прежнему решает, что запускается без запроса.76```text theme={null}

77★ Insight ─────────────────────────────────────

78- Каждый маршрут в этом репозитории проходит через обёртку withAuth, поэтому новая конечная точка получает проверки сеанса без собственного промежуточного ПО.

79- Ограничения скорости устанавливаются для каждого маршрута в limits.ts, поэтому это изменение добавляет запись там, а не глобальное значение по умолчанию.

80─────────────────────────────────────────────────

81```

82 

83<h3 id="learning">

84 Learning

85</h3>

24 86 

25* **Concise**: Claude начинает с результата, пропускает преамбулу и повествование, и по умолчанию держит ответы краткими, при этом выполняя инженерную работу так же тщательно, как в стиле Default. Когда вы просите объяснение или больше деталей, Claude отвечает полностью. Claude всегда сохраняет полное содержание отчётов об ошибках, предупреждений безопасности и подтверждений деструктивных действий. Требует Claude Code v2.1.237 или позже.87В стиле Learning Claude добавляет те же блоки `Insight`, что и [стиль Explanatory](#explanatory), и также просит вас написать часть кода. Claude сам обрабатывает рутинную реализацию. Когда он достигает фрагмента с реальным решением проектирования, такого как обработка ошибок, структура данных или бизнес-логика с более чем одним допустимым подходом, он оставляет несколько строк для вас.

26 88 

27* **Explanatory**: предоставляет образовательные "Insights" между помощью в выполнении задач разработки программного обеспечения. Помогает вам понять выбор реализации и паттерны кодовой базы.89Claude отмечает место комментарием `TODO(human)` в файле, а затем отправляет запрос, который говорит, что уже построено, что написать и что учесть:

28 90 

29* **Learning**: совместный режим обучения на практике, в котором Claude не только будет делиться "Insights" во время кодирования, но также попросит вас внести небольшие, стратегические фрагменты кода самостоятельно. Claude Code добавит маркеры `TODO(human)` в ваш код для реализации.91```text theme={null}

92● Learn by Doing

93 

94Context: The upload form is in place and calls validateFile() before accepting a file. Size and type checks work for images, but the switch statement has no handling for documents yet.

95 

96Your Task: In upload.js, implement the case "document" branch inside validateFile(). Look for TODO(human).

97 

98Guidance: Decide on a size limit for documents and whether the file extension has to match the MIME type. Return {valid: boolean, error?: string}.

99```

100 

101Claude затем останавливается и ждёт. Напишите свой код в комментарии `TODO(human)` и скажите Claude, когда вы закончите. Claude отвечает с одним `Insight` о вашем коде и продолжает задачу.

30 102 

31<h2 id="change-your-output-style">103<h2 id="change-your-output-style">

32 Измените ваш output style104 Измените ваш output style

33</h2>105</h2>

34 106 

35Выберите стиль одним из следующих способов:107Выберите стиль с помощью команды, меню или файла настроек. Команда и оба меню сохраняют ваш выбор в `.claude/settings.local.json` на [локальном уровне проекта](/docs/ru/settings).

36 108 

37* **`/output-style` command**: запустите `/output-style <style>` для переключения, например `/output-style concise`. Без аргумента команда выводит список доступных стилей и отмечает текущий. Claude Code сохраняет ваш выбор в `.claude/settings.local.json` на [локальном уровне проекта](/docs/ru/settings).109* **`/output-style` command**: запустите `/output-style <style>` для переключения, например `/output-style concise`. Без аргумента команда выводит список доступных стилей и отмечает текущий.

38 110 

39 Команда также работает в [неинтерактивном режиме](/docs/ru/headless) и сеансах Agent SDK, а также из мобильного приложения или веб-версии через [Remote Control](/docs/ru/remote-control#limitations), где вы можете просмотреть и выбрать только [встроенные стили](#built-in-output-styles). Требуется Claude Code версии 2.1.269 или позже.111 Команда также работает в [неинтерактивном режиме](/docs/ru/headless) и сеансах Agent SDK, а также из мобильного приложения или веб-версии через [Remote Control](/docs/ru/remote-control#limitations), где вы можете просмотреть и выбрать только [встроенные стили](#built-in-output-styles). Требуется Claude Code версии 2.1.269 или позже.

40* **Terminal**: запустите `/config` и выберите **Output style**, чтобы выбрать стиль из меню. Claude Code сохраняет ваш выбор в `.claude/settings.local.json` на [локальном уровне проекта](/docs/ru/settings).112* **Terminal menu**: запустите `/config` и выберите **Output style**, чтобы выбрать стиль из меню.

41* **VS Code extension**: откройте [меню команд](/docs/ru/vs-code#use-the-prompt-box) с помощью `/` и выберите **Output styles**, чтобы выбрать стиль, включая ваши пользовательские стили. Claude Code сохраняет ваш выбор в `.claude/settings.local.json`, в тот же файл, в который пишет меню терминала. Требуется Claude Code версии 2.1.257 или позже.113* **VS Code extension**: откройте [меню команд](/docs/ru/vs-code#use-the-prompt-box) с помощью `/` и выберите **Output styles**, чтобы выбрать стиль, включая ваши пользовательские стили. Требуется Claude Code версии 2.1.257 или позже.

42* **Desktop app**: установите поле `outputStyle` в файле настроек, например `.claude/settings.local.json`, файл, в который пишет меню терминала. Когда вы запустите `/config` там, Claude Code [открывает **Settings > Claude Code**](/docs/ru/desktop#what%E2%80%99s-not-available-in-desktop) вместо меню.114* **Desktop app**: установите поле `outputStyle` в файле настроек, например `.claude/settings.local.json`, файл, в который пишет меню терминала. Когда вы запустите `/config` там, Claude Code [открывает **Settings > Claude Code**](/docs/ru/desktop#what%E2%80%99s-not-available-in-desktop) вместо меню.

43 115 

44Чтобы установить стиль без меню, отредактируйте поле `outputStyle` непосредственно в файле настроек:116Чтобы установить стиль без меню, отредактируйте поле `outputStyle` непосредственно в файле настроек:

49}121}

50```122```

51 123 

124Значение чувствительно к регистру, поэтому пишите встроенные имена как `Proactive`, `Concise`, `Explanatory` и `Learning`. Значение, которое не совпадает точно с именем стиля, например `explanatory`, дает вам стиль Default. Команда `/output-style` игнорирует регистр.

125 

126Чтобы сделать стиль своим стилем по умолчанию во всех проектах, установите `outputStyle` в `~/.claude/settings.json`. Собственные файлы настроек проекта [имеют приоритет](/docs/ru/settings#settings-precedence) над этим значением.

127 

52Когда вы переключаете стили в середине сеанса, Claude использует новый стиль, начиная со следующего сообщения. Информацию о том, что стоит первое сообщение в prompt caching, см. в разделе [Изменение output style](/docs/ru/prompt-caching#changing-output-style). До версии 2.1.251 новый стиль применялся только после того, как вы запустили `/clear` или начали новый сеанс.128Когда вы переключаете стили в середине сеанса, Claude использует новый стиль, начиная со следующего сообщения. Информацию о том, что стоит первое сообщение в prompt caching, см. в разделе [Изменение output style](/docs/ru/prompt-caching#changing-output-style). До версии 2.1.251 новый стиль применялся только после того, как вы запустили `/clear` или начали новый сеанс.

53 129 

54<h2 id="create-a-custom-output-style">130<h2 id="create-a-custom-output-style">

98[Plugins](/docs/ru/plugins-reference) также могут поставляться с output styles в каталоге `output-styles/`.174[Plugins](/docs/ru/plugins-reference) также могут поставляться с output styles в каталоге `output-styles/`.

99 175 

100<h3 id="frontmatter">176<h3 id="frontmatter">

101 Frontmatter177 Справочник Frontmatter

102</h3>178</h3>

103 179 

104Файлы output style поддерживают эти поля frontmatter:180Настройте output style с помощью YAML [frontmatter](/docs/ru/glossary#frontmatter) между маркерами `---` в начале файла. Все поля являются необязательными, и имена полей используют строчные слова, разделенные дефисами. Неправильно написанное поле игнорируется без ошибки. Если YAML не анализируется, стиль все равно загружается под своим именем файла без установленных полей; запустите `claude --debug`, чтобы увидеть ошибку анализа.

105 181 

106| Frontmatter | Назначение | По умолчанию |182| Поле | Обязательно | Описание |

107| :------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------- |183| :------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

108| `name` | Имя output style, если не имя файла | Наследуется из имени файла |184| `name` | Нет | Имя output style, отображаемое в средстве выбора `/config`. По умолчанию: имя файла |

109| `description` | Описание output style, отображаемое в средстве выбора `/config` | Нет |185| `description` | Нет | Описание output style, отображаемое в средстве выбора `/config` |

110| `keep-coding-instructions` | Сохранять встроенные инструкции Claude Code по разработке программного обеспечения | `false` |186| `keep-coding-instructions` | Нет | Установите значение `true`, чтобы сохранить встроенные инструкции Claude Code по разработке программного обеспечения вместе с вашим стилем. По умолчанию: `false` |

111| `force-for-plugin` | Только для output styles плагинов: применять этот стиль автоматически всякий раз, когда плагин включен, без необходимости выбора пользователем. Переопределяет параметр `outputStyle` пользователя. Если несколько включенных плагинов установят это, Claude Code использует первый загруженный. | `false` |187| `force-for-plugin` | Нет | Только для output styles плагинов. Установите значение `true`, чтобы применить этот стиль автоматически всякий раз, когда плагин включен, без необходимости выбора пользователем. Переопределяет параметр `outputStyle` пользователя. Если несколько включенных плагинов установят это, Claude Code использует первый загруженный. По умолчанию: `false` |

112 188 

113<h2 id="how-output-styles-work">189<span id="comparisons-to-related-features" />

114 Как работают output styles190 

191<h2 id="choose-between-an-output-style-and-other-features">

192 Выбор между output style и другими функциями

115</h2>193</h2>

116 194 

117Output style изменяет инструкции, которые Claude Code отправляет Claude.195Output style применяется к каждому ответу в сеансе. Это инструкция, которую следует Claude, поэтому ничто её не гарантирует. Когда то, что вам нужно, уже́ чем каждый ответ, или должно произойти без сбоев, другая функция подходит лучше.

118 196 

119* Claude Code отправляет инструкции активного стиля с каждым запросом.197Эта таблица соответствует тому, что вам нужно, функции, которая это делает:

120* Когда вы [выбираете стиль, отличный от Default](#change-your-output-style), Claude Code также напоминает Claude о стиле во время разговора.

121* Пользовательские output styles исключают встроенные инструкции Claude Code по разработке программного обеспечения, такие как определение области изменений, написание комментариев и проверка работы, если только `keep-coding-instructions` не установлен в `true`.

122 198 

123Output styles применяются к основному разговору и к [fork](/docs/ru/sub-agents#fork-the-current-conversation), который наследует полный разговор и системный prompt родителя. Другие [subagents запускают свой собственный системный prompt](/docs/ru/sub-agents#what-loads-at-startup), поэтому стили не изменяют способ их ответов.199| Вам нужно | Используйте | Почему это подходит |

200| :-------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ |

201| Каждый ответ в определённом стиле, длине или формате, или Claude в другой роли | An output style | Это применяется ко всему сеансу, и вы переключаете стили одной командой |

202| Claude должен знать соглашения, команды и структуру вашего проекта | [CLAUDE.md](/docs/ru/memory) | Это содержит то, что Claude должен знать о кодовой базе, и остаётся загруженным независимо от выбранного стиля |

203| Инструкции для одного вида задачи, такой как контрольный список выпуска или процедура проверки | A [skill](/docs/ru/skills) | Claude загружает её только при вызове или совпадении задачи, поэтому она не влияет на несвязанные ответы |

204| Что-то, что должно происходить каждый раз без исключения, например форматирование после каждого редактирования или блокирование команды | A [hook](/docs/ru/hooks-guide) | Claude Code запускает hook сам при событии жизненного цикла, поэтому это не зависит от того, следует ли Claude инструкции |

205| Помощник со своими инструкциями, моделью и инструментами для сосредоточенной задачи | A [subagent](/docs/ru/sub-agents) | Он работает в отдельном контексте со своим собственным системным prompt и возвращает сводку в ваш разговор |

206| Дополнение к инструкциям Claude, которое вы передаёте при запуске Claude Code | [`--append-system-prompt`](/docs/ru/cli-reference#system-prompt-flags) | Это добавляется к системному prompt без удаления чего-либо |

124 207 

125Использование токенов зависит от стиля. Инструкции стиля добавляют входные токены, хотя prompt caching снижает эту стоимость после первого запроса в сеансе.208Эти функции комбинируются. Например, вы можете использовать CLAUDE.md для того, что Claude должен знать, output style для того, как он отвечает, и hook для всего, что должно быть гарантировано. [Расширьте Claude Code](/docs/ru/features-overview) сравнивает остальные функции расширения.

126 209 

127Встроенные стили Explanatory и Learning по замыслу производят более длинные ответы, чем Default, что увеличивает выходные токены. Стиль Concise делает противоположное, инструктируя Claude по умолчанию держать ответы короткими. Для пользовательских стилей использование выходных токенов зависит от того, что ваши инструкции говорят Claude производить.210<h2 id="how-output-styles-work">

128 211 Как работают стили вывода

129<h2 id="comparisons-to-related-features">

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

131</h2>212</h2>

132 213 

133Несколько функций настраивают поведение Claude Code. Output styles изменяют системный prompt Claude Code по умолчанию и применяются к каждому ответу. Остальные добавляют инструкции без изменения значений по умолчанию или ограничивают их конкретной задачей.214Стиль вывода изменяет инструкции, которые Claude Code отправляет Claude.

134 215 

135| Функция | Как это работает | Используйте это, когда |216* Claude Code отправляет инструкции активного стиля с каждым запросом.

136| :----------------------- | :------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------- |217* Пользовательские стили вывода исключают встроенные инструкции Claude Code по разработке программного обеспечения, такие как определение области изменений, написание комментариев и проверка работы, если только `keep-coding-instructions` не установлен на `true`.

137| Output styles | Изменяет системный prompt Claude Code по умолчанию | Вы хотите другую роль, тон или формат ответа по умолчанию на каждом ходу |218 

138| [CLAUDE.md](/docs/ru/memory) | Добавляет пользовательское сообщение после системного prompt | Claude должен всегда знать соглашения вашего проекта и контекст кодовой базы |219Стили вывода применяются к основному диалогу и к [форку](/docs/ru/sub-agents#fork-the-current-conversation), который наследует полный диалог и системный prompt родителя. Другие [подагенты запускают свой собственный системный prompt](/docs/ru/sub-agents#what-loads-at-startup), поэтому стили не изменяют способ их ответов.

139| `--append-system-prompt` | Добавляет к системному prompt без удаления чего-либо | Вы хотите одноразовое добавление, переданное как [флаг CLI](/docs/ru/cli-reference#system-prompt-flags) при запуске |220 

140| [Agents](/docs/ru/sub-agents) | Запускает подагента с его собственным системным prompt, моделью и инструментами | Вы хотите отдельно ограниченного помощника для сосредоточенной задачи |221Использование токенов зависит от стиля. Инструкции стиля добавляют входные токены, хотя кэширование prompt снижает эту стоимость после первого запроса в сеансе.

141| [Skills](/docs/ru/skills) | Загружает инструкции, специфичные для задачи, при вызове или при необходимости | У вас есть повторно используемый рабочий процесс |222 

223Встроенные стили Explanatory и Learning по замыслу производят более длинные ответы, чем Default, что увеличивает выходные токены. Стиль Concise делает противоположное, инструктируя Claude по умолчанию держать ответы короткими. Для пользовательских стилей использование выходных токенов зависит от того, что ваши инструкции говорят Claude производить.

142 224 

143<h2 id="related-resources">225<h2 id="related-resources">

144 Связанные ресурсы226 Связанные ресурсы

overview.md +2 −1

Details

226 226 

227Помимо сред [Terminal](/docs/ru/quickstart), [VS Code](/docs/ru/vs-code), [JetBrains](/docs/ru/jetbrains), [Desktop](/docs/ru/desktop) и [Web](/docs/ru/claude-code-on-the-web) выше, Claude Code интегрируется с CI/CD, чатом и рабочими процессами браузера:227Помимо сред [Terminal](/docs/ru/quickstart), [VS Code](/docs/ru/vs-code), [JetBrains](/docs/ru/jetbrains), [Desktop](/docs/ru/desktop) и [Web](/docs/ru/claude-code-on-the-web) выше, Claude Code интегрируется с CI/CD, чатом и рабочими процессами браузера:

228 228 

229| Я хочу... | Лучший вариант |229| Что я хочу сделать | Лучший вариант |

230| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |230| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |

231| Продолжить локальный сеанс со своего телефона или другого устройства | [Remote Control](/docs/ru/remote-control) |231| Продолжить локальный сеанс со своего телефона или другого устройства | [Remote Control](/docs/ru/remote-control) |

232| Отправить события из Telegram, Discord, iMessage или моих собственных webhooks в сеанс | [Channels](/docs/ru/channels) |232| Отправить события из Telegram, Discord, iMessage или моих собственных webhooks в сеанс | [Channels](/docs/ru/channels) |

247* [Quickstart](/docs/ru/quickstart): пройдите через вашу первую реальную задачу, от изучения кодовой базы до коммита исправления247* [Quickstart](/docs/ru/quickstart): пройдите через вашу первую реальную задачу, от изучения кодовой базы до коммита исправления

248* [Сохраняйте инструкции и воспоминания](/docs/ru/memory): дайте Claude постоянные инструкции с файлами CLAUDE.md и auto memory248* [Сохраняйте инструкции и воспоминания](/docs/ru/memory): дайте Claude постоянные инструкции с файлами CLAUDE.md и auto memory

249* [Common workflows](/docs/ru/common-workflows) и [best practices](/docs/ru/best-practices): шаблоны для получения максимума от Claude Code249* [Common workflows](/docs/ru/common-workflows) и [best practices](/docs/ru/best-practices): шаблоны для получения максимума от Claude Code

250* [Claude Academy](https://academy.claude.com/): бесплатные самостоятельные курсы, включая [Claude Code 101](https://academy.claude.com/courses/claude-code-101) и [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action)

250* [A harness for every task](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code): как команда Claude Code использует [dynamic workflows](/docs/ru/workflows) для организации подагентов в масштабе251* [A harness for every task](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code): как команда Claude Code использует [dynamic workflows](/docs/ru/workflows) для организации подагентов в масштабе

251* [Settings](/docs/ru/settings): настройте Claude Code для вашего рабочего процесса252* [Settings](/docs/ru/settings): настройте Claude Code для вашего рабочего процесса

252* [Troubleshooting](/docs/ru/troubleshooting): решения для распространенных проблем253* [Troubleshooting](/docs/ru/troubleshooting): решения для распространенных проблем

permission-modes.md +131 −114

Details

267 267 

268Когда план готов, Claude представляет его и спрашивает, как действовать дальше. Из этого запроса вы можете выбрать:268Когда план готов, Claude представляет его и спрашивает, как действовать дальше. Из этого запроса вы можете выбрать:

269 269 

270* **Да, и использовать режим auto**: одобрить и запустить в [режиме auto](#eliminate-prompts-with-auto-mode). Когда режим auto недоступен, эта опция читается как **Да, автоматически принять редактирование**. Если вы запустили сеанс с включёнными разрешениями на обход, опция читается как **Да, и переключиться на BYPASS PERMISSIONS (без дальнейших запросов) для этого сеанса** вместо этого.270* **Да, и использовать режим auto**: одобрить и запустить в [режиме auto](#eliminate-prompts-with-auto-mode). Если режим auto недоступен [для вашего сеанса](#eliminate-prompts-with-auto-mode), например потому что ваша организация его отключила, эта опция читается как **Да, автоматически принять редактирование**. Если вы запустили сеанс с включёнными разрешениями на обход, опция читается как **Да, и переключиться на BYPASS PERMISSIONS (без дальнейших запросов) для этого сеанса** вместо этого.

271* **Да, вручную одобрить редактирование**: одобрить и проверить каждое редактирование отдельно.271* **Да, вручную одобрить редактирование**: одобрить и проверить каждое редактирование отдельно.

272* **Нет, продолжить планирование**: остаться в режиме plan и сказать Claude, что изменить.272* **Нет, продолжить планирование**: остаться в режиме plan и сказать Claude, что изменить.

273 273 

284Чтобы сделать режим plan значением по умолчанию для сеансов терминала проекта, установите `defaultMode` на `plan` в `.claude/settings.json`, размещённый как пример в [Начните в другом режиме разрешений](#start-in-a-different-mode) показывает. Разговоры, которые [расширение VS Code](/docs/ru/vs-code) запускает, не читают параметры проекта для начального режима разрешений. Там установите `claudeCode.initialPermissionMode` на `plan` в параметрах пользователя VS Code вместо этого.284Чтобы сделать режим plan значением по умолчанию для сеансов терминала проекта, установите `defaultMode` на `plan` в `.claude/settings.json`, размещённый как пример в [Начните в другом режиме разрешений](#start-in-a-different-mode) показывает. Разговоры, которые [расширение VS Code](/docs/ru/vs-code) запускает, не читают параметры проекта для начального режима разрешений. Там установите `claudeCode.initialPermissionMode` на `plan` в параметрах пользователя VS Code вместо этого.

285 285 

286<h2 id="eliminate-prompts-with-auto-mode">286<h2 id="eliminate-prompts-with-auto-mode">

287 Исключите запросы разрешений с режимом auto287 Исключение запросов разрешения с помощью автоматического режима

288</h2>288</h2>

289 289 

290Режим auto позволяет Claude выполнять действия без обычных запросов разрешений. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя всё, что выходит за пределы вашего запроса, нацелено на неизвестную инфраструктуру или кажется вызванным враждебным содержимым, которое Claude прочитал. Явные [правила ask](/docs/ru/permissions#manage-permissions) по-прежнему вынуждают запрос.290Автоматический режим позволяет Claude выполнять действия без обычных запросов разрешения. Отдельная модель классификатора проверяет действия перед их выполнением, блокируя все, что выходит за рамки вашего запроса, нацелено на неизвестную инфраструктуру или выглядит как результат враждебного контента, который прочитал Claude. Явные [правила запроса](/docs/ru/permissions#manage-permissions) по-прежнему вызывают запрос.

291 291 

292На планах Pro, Max и Team режим auto — это [встроенный начальный режим разрешений](#which-mode-a-session-starts-in).292На планах Pro, Max и Team автоматический режим является [встроенным начальным режимом разрешений](#which-mode-a-session-starts-in).

293 293 

294Классификатор также проверяет каждое сообщение, которое Claude отправляет другому агенту с помощью [`SendMessage`](/docs/ru/tools-reference), будь то простой текст или структурированное сообщение [команды агентов](/docs/ru/agent-teams), перед тем как Claude Code его доставляет, как в режиме auto, так и в [режиме plan, пока классификатор проверяет команды](#analyze-before-you-edit-with-plan-mode); проверка отправки требует Claude Code v2.1.222 или позже.294Классификатор также проверяет каждое сообщение, которое Claude отправляет другому агенту с помощью [`SendMessage`](/docs/ru/tools-reference), будь то простой текст или структурированное сообщение [команды агентов](/docs/ru/agent-teams), перед тем как Claude Code его доставит, как в автоматическом режиме, так и в [режиме плана, пока классификатор проверяет команды](#analyze-before-you-edit-with-plan-mode); проверка отправки требует Claude Code v2.1.222 или более поздней версии.

295 295 

296Классификатор также проверяет и одобряет или блокирует удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths), такие как `rm -rf /` и `rm -rf ~`, включая когда удаление находится внутри подстановки команд или подстановки процесса.296Классификатор также проверяет и одобряет или блокирует удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths), такие как `rm -rf /` и `rm -rf ~`, включая случаи, когда удаление находится внутри подстановки команды или процесса.

297 297 

298Режим auto также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude по-прежнему спрашивает, когда ваш запрос или навык явно на этом полагается. Для более сильного автономного поведения в режиме, который по-прежнему запрашивает вас, установите [Proactive output style](/docs/ru/output-styles) вместо этого.298Автоматический режим также побуждает Claude продолжать работу без остановки для уточняющих вопросов, хотя Claude по-прежнему спрашивает, когда ваш запрос или навык явно на этом основаны. Для более сильного автономного поведения в режиме, который по-прежнему вас спрашивает, установите [стиль вывода Proactive](/docs/ru/output-styles).

299 299 

300<Warning>300<Warning>

301 Режим auto уменьшает запросы разрешений, но не гарантирует безопасность. Используйте его для задач, в которых вы доверяете общему направлению, а не как замену проверке чувствительных операций.301 Автоматический режим снижает количество запросов разрешения, но не гарантирует безопасность. Используйте его для задач, в которых вы доверяете общему направлению, а не как замену проверке при чувствительных операциях.

302</Warning>302</Warning>

303 303 

304Режим auto доступен только когда ваша учётная запись соответствует всем этим требованиям:304Автоматический режим доступен только при соблюдении всех следующих требований вашей учетной записи:

305 305 

306* **План**: Все планы.306* **План**: Все планы.

307* **Организация**: на Team и Enterprise режим auto доступен по умолчанию. Администраторы могут отключить его для организации, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings).307* **Организация**: на Team и Enterprise автоматический режим доступен по умолчанию. Администраторы могут отключить его для организации, установив `permissions.disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings).

308* **Модель**: на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Claude Opus 4.6 или позже, Sonnet 4.6 или позже, или [модель Fable](/docs/ru/model-config#work-with-fable). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway), только Claude Sonnet 5, Opus 4.7 или позже и модели Fable. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном поставщике.308* **Модель**: на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Claude Opus 4.6 или более поздней версии, Sonnet 4.6 или более поздней версии, или [модель Fable](/docs/ru/model-config#work-with-fable). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) с входом, только Claude Sonnet 5, Opus 4.7 или более поздней версии и модели Fable. Более старые модели, включая Sonnet 4.5, Opus 4.5, Haiku и модели claude-3, не поддерживаются ни на одном поставщике.

309* **Поставщик**: доступен по умолчанию на Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и подписанных сеансах Claude apps gateway.309* **Поставщик**: доступен по умолчанию на Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и сеансах Claude apps gateway с входом.

310 310 

311Если Claude Code сообщает, что режим auto недоступен, сначала проверьте эти требования и не устанавливает ли какой-либо файл параметров [`disableAutoMode`](/docs/ru/settings-reference#disableautomode). Anthropic также может отключить режим auto на стороне сервера, или сервер может отклонить режим auto для вашей учётной записи. Сеанс, который получил любой из этих ответов, держит режим auto отключённым до конца сеанса, поэтому запустите новый сеанс позже.311Если Claude Code сообщает, что автоматический режим недоступен, сначала проверьте эти требования и не устанавливает ли какой-либо файл параметров [`disableAutoMode`](/docs/ru/settings-reference#disableautomode). Anthropic также может отключить автоматический режим на стороне сервера, или сервер может отклонить автоматический режим для вашей учетной записи. Сеанс, получивший любой из этих ответов, держит автоматический режим отключенным до конца сеанса, поэтому позже начните новый сеанс.

312 312 

313Отдельное сообщение, которое называет модель и говорит, что режим auto "не может определить безопасность" действия, означает, что запрос классификатора не удался. Этот сбой обычно временный, но на Amazon Bedrock он может повторяться до тех пор, пока ваша учётная запись не сможет вызывать названную модель. См. [справку по ошибкам](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) для причин и что делать.313Отдельное сообщение, которое называет модель и говорит, что автоматический режим "не может определить безопасность" действия, означает, что запрос классификатора не удался. Этот сбой обычно временный, но на Amazon Bedrock он может повторяться до тех пор, пока ваша учетная запись не сможет вызвать названную модель. Смотрите [справочник ошибок](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action) для причин и что делать.

314 314 

315Если вы установили `defaultMode: "auto"` в [параметры](/docs/ru/settings-reference#all-settings) и сеанс терминала запускается в режиме Manual без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. `auto` не вступает в силу из этих файлов. Переместите его в `~/.claude/settings.json`. Для разговора, который запустило расширение VS Code, проверьте собственный список расширения в [Переключение режимов разрешений](#switch-permission-modes) вместо этого.315Если вы установили `defaultMode: "auto"` в [параметрах](/docs/ru/settings-reference#all-settings) и сеанс терминала начинается в режиме Manual без ошибки, параметр, вероятно, находится в `.claude/settings.json` или `.claude/settings.local.json`. `auto` не вступает в силу из этих файлов. Переместите его в `~/.claude/settings.json`. Для разговора, который запустило расширение VS Code, вместо этого проверьте собственный список расширения в [Переключение режимов разрешений](#switch-permission-modes).

316 316 

317<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">317<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

318 Режим auto на Bedrock, Agent Platform или Foundry318 Автоматический режим на Bedrock, Agent Platform или Foundry

319</h3>319</h3>

320 320 

321На [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-reference#permissions-defaultmode), который является Manual, если вы его не измените, и разговоры в [расширении VS Code](/docs/ru/vs-code) начинаются в режиме Manual, если `claudeCode.initialPermissionMode` или режим, который вы выбрали в расширении, не устанавливает один. На этих поставщиках поддерживаются только Claude Sonnet 5, Opus 4.7 или позже и модели Fable.321На [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) с входом автоматический режим появляется в цикле `Shift+Tab` по умолчанию. Появление в цикле не изменяет режим разрешений, в котором начинается сеанс: на этих поставщиках сеансы терминала начинаются в вашем [`defaultMode`](/docs/ru/settings-reference#permissions-defaultmode), который является Manual, если вы его не измените, и разговоры в [расширении VS Code](/docs/ru/vs-code) начинаются в Manual, если `claudeCode.initialPermissionMode` или выбранный вами режим в расширении не устанавливает один. На этих поставщиках поддерживаются только Claude Sonnet 5, Opus 4.7 или более поздней версии и модели Fable.

322 322 

323Чтобы сделать режим auto начальным режимом разрешений по умолчанию, установите `"permissions": {"defaultMode": "auto"}` в пользовательские или управляемые параметры. В сеансах, которые запускает расширение VS Code, выберите **Auto** из индикатора режима вместо этого. [Переключение режимов разрешений](#switch-permission-modes) охватывает то, что превосходит этот выбор.323Чтобы сделать автоматический режим режимом разрешений по умолчанию при запуске, установите `"permissions": {"defaultMode": "auto"}` в пользовательские или управляемые параметры. В сеансах, которые запускает расширение VS Code, вместо этого выберите **Auto** из индикатора режима. [Переключение режимов разрешений](#switch-permission-modes) охватывает то, что имеет приоритет над этим выбором.

324 324 

325Проверка [`/doctor`](/docs/ru/commands#all-commands) предлагает этот пользовательский параметр по умолчанию на этих поставщиках так же, как на Anthropic API.325Проверка [`/doctor`](/docs/ru/commands#all-commands) предлагает этот пользовательский параметр по умолчанию на этих поставщиках так же, как на Anthropic API.

326 326 

327Чтобы предотвратить использование режима auto разработчиками, установите `disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings). Это удаляет `auto` из цикла `Shift+Tab`, и сеанс, запущенный с `--permission-mode auto`, запускается в режиме Manual вместо этого. Сеанс, уже работающий в режиме auto, покидает его, когда параметр достигает этого сеанса из [источника, развёрнутого администратором](/docs/ru/managed-settings#which-managed-source-claude-code-uses), и показывает `auto mode disabled by settings`. До v2.1.251 работающий сеанс держал режим auto до конца.327Чтобы предотвратить использование автоматического режима разработчиками, установите `disableAutoMode` на `"disable"` в [управляемых параметрах](/docs/ru/managed-settings). Это удаляет `auto` из цикла `Shift+Tab`, и сеанс, запущенный с `--permission-mode auto`, начинается в Manual. Сеанс, уже работающий в автоматическом режиме, выходит из него, когда параметр достигает этого сеанса из [источника, развернутого администратором](/docs/ru/managed-settings#which-managed-source-claude-code-uses), и показывает `auto mode disabled by settings`. До v2.1.251 работающий сеанс оставался в автоматическом режиме до конца.

328 328 

329В v2.1.158 через v2.1.206 режим auto был отключён на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.329В v2.1.158 через v2.1.206 автоматический режим был отключен на этих поставщиках до тех пор, пока вы не установили `CLAUDE_CODE_ENABLE_AUTO_MODE=1`, и Claude Code игнорировал `defaultMode: "auto"` на этих поставщиках, если переменная также не была установлена. Переменная по-прежнему принимается для совместимости и не имеет эффекта с v2.1.207 и далее.

330 330 

331<h3 id="server-side-classifier-review">331<h3 id="server-side-classifier-review">

332 Проверка классификатора на стороне сервера332 Проверка классификатора на стороне сервера

333</h3>333</h3>

334 334 

335На планах Enterprise и на учётных записях, которые используют Claude API, на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, и когда вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway или proxy](/docs/ru/llm-gateway), Claude Code в режиме auto просит сервер проверить [действия, которые идут к классификатору](#how-the-classifier-evaluates-actions) как часть запросов модели сеанса. Где сервер их проверяет, его вердикты решают эти действия. Где он этого не делает, обычно потому что gateway или proxy мешает трафику, или потому что платформа, регион или учётные данные ещё не имеют проверок на стороне сервера, Claude Code откатывается к собственным запросам классификатора, и как только этот откат держится для остальной части сеанса, он показывает [уведомление о расходах на запросы классификатора](/docs/ru/auto-mode-classifier-billing) на учётных записях, где эти запросы выставляются счётом. Чтобы пропустить запрос к серверу и всегда использовать собственные запросы классификатора Claude Code, установите [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ru/env-vars). Переменная не читается при прямом подключении к Anthropic API. Если вы установите `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` и оставите `CLAUDE_CODE_AUTO_MODE_SERVER` неустановленным, Claude Code также перестаёт запрашивать сервер.335На планах Enterprise и учетных записях, которые используют Claude API, на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, и всякий раз, когда вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway или proxy](/docs/ru/llm-gateway), Claude Code в автоматическом режиме просит сервер проверить [действия, которые идут к классификатору](#how-the-classifier-evaluates-actions) как часть запросов модели сеанса. Где сервер их проверяет, его вердикты решают эти действия. Где он этого не делает, чаще всего потому, что LLM gateway или proxy мешает трафику, или потому, что платформа, регион или учетные данные еще не имеют проверок на стороне сервера, Claude Code возвращается к своим собственным запросам классификатора, и как только этот откат сохраняется для остальной части сеанса, он показывает [уведомление о расходах на запросы классификатора](/docs/ru/auto-mode-classifier-billing) на учетных записях, где эти запросы выставляются счетом. Чтобы пропустить запрос к серверу и всегда использовать собственные запросы классификатора Claude Code, установите [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ru/env-vars). Переменная не читается при прямом подключении к Anthropic API. Если вы установили `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` и оставили `CLAUDE_CODE_AUTO_MODE_SERVER` неустановленным, Claude Code также перестает запрашивать сервер.

336 336 

337Запрос к серверу по умолчанию требует Claude Code v2.1.278 или позже.337Запрос к серверу по умолчанию требует Claude Code v2.1.278 или более поздней версии.

338 338 

339<h3 id="what-the-classifier-blocks-by-default">339<h3 id="what-the-classifier-blocks-by-default">

340 Что классификатор блокирует по умолчанию340 Что классификатор блокирует по умолчанию

341</h3>341</h3>

342 342 

343Классификатор доверяет вашему рабочему каталогу и удалённым репозиториям, которые были настроены для него при запуске сеанса. Удалённый репозиторий, добавленный или переориентированный во время сеанса с помощью `git remote add` или `git remote set-url`, не является доверенным, и всё остальное рассматривается как внешнее до тех пор, пока вы не [настроите доверенную инфраструктуру](/docs/ru/auto-mode-config). До v2.1.200 удалённые репозитории, добавленные в середине сеанса, также были доверенными.343Классификатор доверяет вашему рабочему каталогу и удаленным хранилищам, которые были для него настроены при запуске сеанса. Удаленное хранилище, добавленное или переориентированное во время сеанса с помощью `git remote add` или `git remote set-url`, не является доверенным, и все остальное рассматривается как внешнее до тех пор, пока вы не [настроите доверенную инфраструктуру](/docs/ru/auto-mode-config). До v2.1.200 удаленные хранилища, добавленные в середине сеанса, также были доверенными.

344 344 

345**Блокируется по умолчанию**:345**Блокируется по умолчанию**:

346 346 

347* Загрузка и выполнение кода, например `curl | bash`347* Загрузка и выполнение кода, например `curl | bash`

348* Отправка чувствительных данных на внешние конечные точки348* Отправка чувствительных данных на внешние конечные точки

349* Развертывание и миграция в производство349* Развертывание и миграция в production

350* Массовое удаление в облачном хранилище350* Массовое удаление в облачном хранилище

351* Предоставление разрешений IAM или репозитория351* Предоставление разрешений IAM или репозитория

352* Изменение общей инфраструктуры352* Изменение общей инфраструктуры

353* Необратимое уничтожение файлов, которые существовали до начала сеанса353* Необратимое уничтожение файлов, которые существовали до сеанса

354* Force push354* Force push

355* Коммит или отправка изменения, которое отправило бы секреты или чувствительные данные вне репозитория при его запуске, или расширило бы то, что развёртывание раскрывает. Это охватывает рабочий процесс CI или конфигурацию развёртывания, которая передаёт секрет месту назначения, которое его ещё не получает, скрипт или шаг настройки, который читает хранилище секретов и отправляет данные, и изменение конфигурации, которое расширяет то, что развёртывание публикует, такое как реестр, видимость, артефакт или параметр sourcemap. Проверка применяется на любой ветви, применяется даже когда репозиторий является общедоступным, и срабатывает, когда изменение приземляется, независимо от того, запускает ли это конвейер; очистка требует назвать эффект выполнения, а не только коммит или отправку. До v2.1.211 эта проверка была ограничена ветвью по умолчанию вместо этого: отправка туда была заблокирована, когда она несла чувствительное содержимое, изменения скрытые или неправильно описанные относительно того, что вы просили, содержимое перенесённое из-за пределов репозитория или обходящее проверку, которую вы просили355* Фиксация или отправка изменения, которое отправило бы секреты или чувствительные данные за пределы репозитория при его запуске, или расширило бы то, что развертывание раскрывает. Это охватывает рабочий процесс CI или конфигурацию развертывания, которая передает секрет на назначение, которое его еще не получает, скрипт или шаг настройки, который читает хранилище секретов и отправляет данные, и изменение конфигурации, которое расширяет то, что развертывание публикует, такое как реестр, видимость, артефакт или параметр sourcemap. Проверка применяется на любой ветке, применяется даже когда репозиторий является общедоступным, и срабатывает при фиксации или отправке изменения, независимо от того, запускает ли эта фиксация или отправка конвейер; очистка требует назвать эффект выполнения, а не только фиксацию или отправку. До v2.1.211 эта проверка была ограничена ветвью по умолчанию: отправка туда была заблокирована, когда она содержала чувствительное содержимое, изменения скрытые или неправильно описанные относительно того, что вы просили, содержимое перенесенное из-за пределов репозитория или направленное вокруг проверки, которую вы просили

356* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` или `git stash clear`, которые классификатор предполагает отбросят незафиксированные изменения356* `git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop` или `git stash clear`, которые классификатор предполагает отбросили бы незафиксированные изменения

357* `git commit --amend`, когда коммит в HEAD не был создан в этом сеансе357* `git commit --amend` когда фиксация в HEAD не была создана в этом сеансе

358* От v2.1.198 `git commit --amend`, когда коммит в HEAD уже был отправлен. Переформулировка только сообщения не блокируется: `--amend -m` без ничего вновь подготовленного, на коммите, который Claude создал во время этого сеанса358* С v2.1.198, `git commit --amend` когда фиксация в HEAD уже была отправлена. Переформулировка только сообщения не блокируется: `--amend -m` без ничего вновь поставленного на сцену, на фиксации, которую Claude создал во время этого сеанса

359* `terraform destroy`, `pulumi destroy`, `cdk destroy` или `terragrunt destroy`, и применение плана, который уничтожает ресурсы359* `terraform destroy`, `pulumi destroy`, `cdk destroy` или `terragrunt destroy`, и применение плана, который уничтожает ресурсы

360 360 

361Claude Code v2.1.195 и позже блокируют больше категорий по умолчанию. Несколько зависят от записей [environment](/docs/ru/auto-mode-config#define-trusted-infrastructure), таких как чувствительные удалённые цели и защищённые области IaC, которые вы можете сузить до конкретных имён.361Claude Code v2.1.195 и более поздние версии блокируют больше категорий по умолчанию. Несколько зависят от записей [окружения](/docs/ru/auto-mode-config#define-trusted-infrastructure), таких как чувствительные удаленные цели и защищенные области IaC, которые вы можете сузить до конкретных имен.

362 362 

363* Запись в менеджер секретов или изменение записей DNS или сертификатов TLS363* Запись в менеджер секретов или изменение записей DNS или сертификатов TLS

364* Слияние pull request, который не одобрил ни один человек, одобрение собственного pull request Claude или отключение проверок CI364* Слияние pull request, который не одобрил ни один человек, одобрение собственного pull request Claude или отключение проверок CI

365* Публикация комментария, который сам по себе является командой для автоматизации, такой как `atlantis apply` или `/deploy` или `/merge` бота365* Размещение комментария, который сам по себе является командой для автоматизации, такой как `atlantis apply` или `/deploy` или `/merge` бота

366* Переключение, постепенное развёртывание или удаление флага функции в производстве366* Переключение, постепенное развертывание или удаление флага функции production

367* Применение изменений инфраструктуры к защищённой области IaC или осушение и удаление узлов кластера367* Применение изменений инфраструктуры к защищенной области IaC или осушение и удаление узлов кластера

368* Записи в общий вычислительный кластер, которые выходят за пределы названного вами ресурса, такие как селектор меток или `--all`, который захватывает задания других пользователей368* Записи в общий вычислительный кластер, которые выходят за пределы названного вами ресурса, такие как селектор меток или `--all`, который захватывает задания других пользователей

369* Создание ресурсов Kubernetes, которые работают на каждом узле или перехватывают трафик кластера, такие как DaemonSets и admission webhooks369* Создание ресурсов Kubernetes, которые работают на каждом узле или перехватывают трафик кластера, такие как DaemonSets и admission webhooks

370* Интерактивные оболочки или port-forwards в чувствительную удалённую цель370* Интерактивные оболочки или port-forwards в чувствительную удаленную цель

371* Открытие туннеля или обратной оболочки, которая делает локальный сервис доступным из общедоступного интернета371* Открытие туннеля или обратной оболочки, которая делает локальный сервис доступным из общедоступного интернета

372* Вывод живого учётного данного или токена в стенограмму или файл372* Вывод живого учетного данного или токена в стенограмму или файл

373* Доступ к местоположению, указанному как чувствительное местоположение данных в вашем [environment](/docs/ru/auto-mode-config#define-trusted-infrastructure), или копирование данных из одного. Начиная с v2.1.198 это также блокирует отправку данных из одного аудитории, которую запись исключает373* Доступ к местоположению, указанному как местоположение чувствительных данных в вашем [окружении](/docs/ru/auto-mode-config#define-trusted-infrastructure), или копирование данных из него. Начиная с v2.1.198, это также блокирует отправку данных из одного на аудиторию, которую запись исключает

374* Маршрутизация установки пакета вокруг вашего внутреннего реестра пакетов в общедоступный реестр. Начиная с v2.1.198 это также применяется когда вы сказали Claude, что внутренний реестр или зеркало существует в разговоре, а не только когда один указан в вашем environment374* Маршрутизация установки пакета вокруг вашего внутреннего реестра пакетов на общедоступный реестр. Начиная с v2.1.198, это также применяется, когда вы сказали Claude, что внутренний реестр или зеркало существует в разговоре, а не только когда один указан в вашем окружении

375* Запуск команды с флагом, который отключает защиту безопасности, например `--insecure`375* Запуск команды с флагом, который отключает защиту безопасности, например `--insecure`

376* Запуск автономного цикла агента, который работает без одобрения человека или песочницы, такой как один запущенный с `--dangerously-skip-permissions` или `--no-sandbox`. Начиная с v2.1.198 это также охватывает запуск агента третьей стороны или eval harness с отключённой изоляцией и одобрением для каждого действия, такой как runner запущенный с `--yes-always`376* Запуск цикла автономного агента, который работает без одобрения человека или песочницы, такой как запущенный с `--dangerously-skip-permissions` или `--no-sandbox`. Начиная с v2.1.198, это также охватывает запуск стороннего агента или eval harness с отключенной изоляцией и одобрением для каждого действия, такой как runner, запущенный с `--yes-always`

377* [Claude in Chrome](/docs/ru/chrome) действия браузера, которые могут отправлять содержимое страницы, файлы cookie или учётные данные за пределы источника377* [Claude in Chrome](/docs/ru/chrome) действия браузера, которые могут отправить содержимое страницы, cookies или учетные данные за пределы origin

378 378 

379Claude Code v2.1.198 и позже также блокируют эти действия по умолчанию:379Claude Code v2.1.198 и более поздние версии также блокируют эти по умолчанию:

380 380 

381* Удаление файлов в `/tmp`, `$TMPDIR` или другом общем каталоге scratch или cache по подстановочному знаку, glob или фильтру возраста, а не по конкретному названному пути381* Удаление файлов в `/tmp`, `$TMPDIR` или другом общем каталоге scratch или cache по подстановочному знаку, glob или фильтру возраста, а не по конкретному названному пути

382* Включение чувствительных деталей в содержимое, отправленное, загруженное, опубликованное или написанное другим людям или общим системам, когда ваше собственное сообщение не авторизовало эти детали для этого получателя. Тела PR и issue, сообщения коммитов и комментарии считаются этим типом исходящего содержимого, когда репозиторий находится вне границы доверия или является общедоступным, включая собственные общедоступные репозитории вашей организации; внутренние пути файлов, кодовые имена, данные живого ответа API, такие как адреса электронной почты или идентификаторы учётных записей, и идентификаторы инфраструктуры считаются чувствительными деталями. Область действия PR, issue и сообщения коммита требует Claude Code v2.1.200 или позже. Живые личные данные из ответа API в теле PR или issue, такие как адрес электронной почты, идентификатор учётной записи или организации, или метрика использования, требуют, чтобы вы назвали эти детали и получателя независимо от видимости репозитория или границы доверия. Эта проверка требует Claude Code v2.1.203 или позже382* Включение чувствительных деталей в содержимое, отправленное, загруженное, опубликованное или написанное другим людям или общим системам, когда ваше собственное сообщение не авторизовало эти детали для этого получателя. Тела PR и issues, сообщения фиксации и комментарии считаются этим видом исходящего содержимого, когда репозиторий находится вне границы доверия или является общедоступным, включая собственные общедоступные репозитории вашей организации; внутренние пути файлов, кодовые имена, данные живого ответа API, такие как электронные письма или идентификаторы учетных записей, и идентификаторы инфраструктуры считаются чувствительными деталями. Область PR, issue и сообщения фиксации требует Claude Code v2.1.200 или более поздней версии. Живые личные данные из ответа API в теле PR или issue, такие как адрес электронной почты, идентификатор учетной записи или организации или метрика использования, требуют, чтобы вы назвали эти детали и получателя независимо от видимости репозитория или границы доверия. Эта проверка требует Claude Code v2.1.203 или более поздней версии

383* Отправка нажатий клавиш в собственную tmux pane Claude Code для управления его собственным интерфейсом, что классификатор рассматривает как Claude изменяющий свои собственные разрешения или надзор383* Отправка нажатий клавиш на собственную панель tmux Claude Code для управления его собственным интерфейсом, что классификатор рассматривает как Claude, изменяющий свои собственные разрешения или надзор

384 384 

385Claude Code v2.1.200 и позже также блокируют эти действия по умолчанию:385Claude Code v2.1.200 и более поздние версии также блокируют эти по умолчанию:

386 386 

387* Комментирование, удаление или принудительное прохождение теста или утверждения, которое защищает поведение безопасности, такое как аутентификация, контроль доступа, валидация входных данных или песочница387* Комментирование, удаление или force-passing теста или утверждения, которое охраняет поведение безопасности, такое как аутентификация, контроль доступа, валидация входных данных или песочница

388* Удаление или разборка ресурса с состоянием, который Claude не создал в сеансе, когда не применяется более конкретное правило удаления и вы не назвали этот ресурс388* Удаление или разборка stateful ресурса, который Claude не создал в сеансе, когда не применяется более конкретное правило удаления и вы не назвали этот ресурс

389* Переориентация базового URL API, конечной точки прокси, получателя webhook или зеркала реестра на хост третьей стороны, который не соответствует задаче, включая в файлы примеров, такие как `.env.example`389* Переориентирование базового URL API, конечной точки proxy, получателя webhook или зеркала реестра на хост третьей стороны, который не подходит для задачи, включая в файлы примеров, такие как `.env.example`

390* Изменение того, куда идут отправки, с помощью `git remote set-url` или `git remote add`, если вы не назвали новый удалённый репозиторий390* Изменение того, куда идут отправки с помощью `git remote set-url` или `git remote add`, если вы не назвали новое удаленное хранилище

391* Отправка секретов или личных или доверенных данных в репозиторий, известный как общедоступный, или отправка туда конфиденциального материала, который не является частью собственной работы этого репозитория. Собственный предмет репозитория dotfiles — единственное исключение для личных или доверенных данных, и содержимое из приватного репозитория, достигающее любой общедоступной поверхности, блокируется таким же образом; оба уточнения требуют Claude Code v2.1.203 или позже. До v2.1.203 личные данные были сгруппированы с конфиденциальным материалом и блокировались только когда они не были частью собственной работы этого репозитория. Когда видимость репозитория не установлена, классификатор не блокирует только на этом основании; вместо этого он судит содержимое по другим правилам391* Отправка секретов или личных или доверенных данных в репозиторий, известный как общедоступный, или отправка конфиденциального материала туда, который не является частью собственной работы этого репозитория. Собственный предмет репозитория dotfiles является единственным исключением для личных или доверенных данных, и содержимое из приватного репозитория, достигающее любой общедоступной поверхности, блокируется так же; оба уточнения требуют Claude Code v2.1.203 или более поздней версии. До v2.1.203 личные данные были сгруппированы с конфиденциальным материалом и блокировались только когда они не были частью собственной работы этого репозитория. Когда видимость репозитория не установлена, классификатор не блокирует только на этом; он судит содержимое по другим правилам вместо этого

392* Открытие pull request против другого репозитория или организации, форк с помощью `gh repo fork` или отправка в репозиторий третьей стороны, если вы не назвали эту внешнюю цель392* Открытие pull request против другого репозитория или организации, форк с помощью `gh repo fork` или отправка в репозиторий третьей стороны, если вы не назвали эту внешнюю цель

393 393 

394Claude Code v2.1.203 и позже также блокируют эти действия по умолчанию:394Claude Code v2.1.203 и более поздние версии также блокируют эти по умолчанию:

395 395 

396* Содержимое из чувствительного локального хранилища или из файла, имя, путь или тип которого отмечает его как чувствительный, входящее в коммит, отправку, текст PR или issue, gist или paste, или публикацию пакета, если вы не назвали как источник, так и назначение. Стенограммы сеансов и журналы разговоров, папки конфигурации и учётных данных, такие как ключи SSH, облачные учётные данные, профили браузера и история оболочки, и экспорты пользовательских данных, все считаются, и приватность репозитория это не очищает396* Содержимое из чувствительного локального хранилища или из файла, имя, путь или тип которого отмечает его как чувствительный, входящее в фиксацию, отправку, текст PR или issue, gist или paste или публикацию пакета, если вы не назвали как источник, так и назначение. Стенограммы сеансов и журналы разговоров, папки с точками учетных данных и конфигурации, такие как ключи SSH, облачные учетные данные, профили браузера и история оболочки, и экспорты пользовательских данных, все считаются, и приватность репозитория не очищает это

397 397 

398Claude Code v2.1.205 и позже также блокируют эти действия по умолчанию:398Claude Code v2.1.205 и более поздние версии также блокируют эти по умолчанию:

399 399 

400* Запись в стенограммы сеансов Claude Code, файлы истории `.jsonl` в `~/.claude/projects/` или в ваш настроенный каталог конфигурации, прямо или через команду оболочки. Правило также охватывает строки метаданных, которые Claude Code добавляет к каждой записи стенограммы для своих собственных проверок. Чтение стенограммы не блокируется400* Запись в стенограммы сеансов Claude Code, файлы истории `.jsonl` в `~/.claude/projects/` или вашем настроенном каталоге конфигурации, прямо или через команду оболочки. Правило также охватывает строки метаданных, которые Claude Code добавляет к каждой записи стенограммы для своих собственных проверок. Чтение стенограммы не блокируется

401* Рекурсивное принудительное удаление, такое как `rm -rf "$VAR"` или `Remove-Item -Recurse -Force $dir`, чей целевой объект — переменная оболочки, или glob с корнем в одной, которая не назначена нигде в разговоре, который видит классификатор. Значение поступило только из более ранних выходных данных команды, которые классификатор никогда не получает, поэтому классификатор не может проверить целевой объект удаления по другим правилам удаления. Блокировка очищается, когда вы называете точный удаляемый путь, или когда Claude повторно запускает удаление с разрешённым буквальным путём, написанным в команду. Удаления, чей целевой объект классификатор может разрешить, не затронуты. Цели `Remove-Item`, которые являются голым `*` или заканчиваются на `/*` или `\*`, никогда не достигают классификатора: Claude Code [отклоняет их сразу](#remove-item-in-powershell)401* Рекурсивное принудительное удаление, такое как `rm -rf "$VAR"` или `Remove-Item -Recurse -Force $dir`, цель которого является переменной оболочки или glob, укорененным в одной, которая не назначена где-либо в разговоре, который видит классификатор. Значение пришло только из более раннего вывода команды, который классификатор никогда не получает, поэтому классификатор не может проверить цель удаления по другим правилам удаления. Блок очищается, когда вы называете точный удаляемый путь, или когда Claude повторно запускает удаление с разрешенным буквальным путем, написанным в команду. Удаления, цель которых классификатор может разрешить, не затронуты. Цели `Remove-Item`, которые являются голым `*` или заканчиваются на `/*` или `\*`, никогда не достигают классификатора: Claude Code [отклоняет их сразу](#remove-item-in-powershell)

402 402 

403Claude Code v2.1.257 и позже также блокируют эти действия по умолчанию:403Claude Code v2.1.257 и более поздние версии также блокируют эти по умолчанию:

404 404 

405* Запрос учётных данных из конечной точки метаданных облачного экземпляра, такой как `169.254.169.254`, или явная аутентификация облачного, кластерного или реестрового вызова с собственным удостоверением сервис-аккаунта или узла машины405* Запрос учетных данных из конечной точки метаданных облачного экземпляра, такой как `169.254.169.254`, или явная аутентификация облачного, кластерного или реестрового вызова с собственной учетной записью обслуживания машины или идентичностью узла

406* Достижение общедоступного хоста маршрутом, отличным от прямого запроса, такой как туннель, обратная оболочка или конфигурация resolver или proxy, переписанная на указание вне406* Достижение общедоступного хоста маршрутом, отличным от прямого запроса, такой как туннель, обратная оболочка или конфигурация resolver или proxy, переписанная для указания за пределы

407* Чтение учётных данных, которые принадлежат хосту, а не вашей задаче, такие как сертификаты узла или auth реестра контейнеров узла407* Чтение учетных данных, которые принадлежат хосту, а не вашей задаче, такие как сертификаты узла или auth реестра контейнеров узла

408* Подключение к или сканирование соседних контейнеров, pods или виртуальных машин, которые Claude не запустил, или узла под контейнером408* Подключение к или сканирование соседних контейнеров, подов или ВМ, которые Claude не запустил, или узла под контейнером

409 409 

410Если Claude Code работает где-то, что предназначено для разрешения одного из них, опишите эту конфигурацию в записи [Host containment](/docs/ru/auto-mode-config#define-trusted-infrastructure) в `autoMode.environment`.410Если Claude Code работает где-то, что предназначено для разрешения одного из этих, опишите эту настройку в записи [Host containment](/docs/ru/auto-mode-config#define-trusted-infrastructure) в `autoMode.environment`.

411 411 

412Claude Code v2.1.261 и позже также блокируют эти действия по умолчанию:412Claude Code v2.1.261 и более поздние версии также блокируют эти по умолчанию:

413 413 

414* Публикация или запись ссылки на общедоступный paste, диаграмму или сервис обмена данными в сообщение, текст PR или issue, документ или где-либо ещё, где ссылка будет открыта или получена, когда сам URL несёт обмениваемое содержимое, если вы не назвали этот сервис414* Размещение или запись ссылки на общедоступный paste, диаграмму или сервис обмена данными в сообщение, текст PR или issue, документ или где-либо еще, где ссылка будет открыта или получена, когда сам URL несет обмениваемое содержимое, если вы не назвали этот сервис

415 415 

416**Разрешается по умолчанию**:416**Разрешено по умолчанию**:

417 417 

418* Локальные операции с файлами в вашем рабочем каталоге418* Локальные операции с файлами в вашем рабочем каталоге

419* Установка зависимостей, объявленных в ваших файлах блокировки или манифестах419* Установка зависимостей, объявленных в ваших файлах блокировки или манифестах

420* Чтение `.env` и отправка учётных данных на соответствующий API420* Чтение `.env` и отправка учетных данных на их соответствующий API

421* Запросы HTTP только для чтения421* Запросы HTTP только для чтения

422* Отправка на любую ветвь репозитория, в котором вы работаете, включая ветвь по умолчанию. Ветвь, не являющаяся ветвью по умолчанию, чьё имя отмечает её как цель развёртывания или публикации, такая как `production` или `gh-pages`, не охватывается: классификатор судит отправку туда на её собственных условиях. Содержимое отправки по-прежнему проверяется по другим правилам, [правила `permissions.deny`](/docs/ru/permissions#manage-permissions) по-прежнему могут блокировать команды push [как написано](/docs/ru/permissions#bash-rule-limits) в каждом режиме, и защита ветвей самого удалённого репозитория по-прежнему применяется. До v2.1.211 только отправки на ветвь, с которой вы начали, ветви, созданные Claude, и обычные отправки на ветвь по умолчанию были разрешены по умолчанию, и до v2.1.203 любая прямая отправка на ветвь по умолчанию была заблокирована422* Отправка на любую ветку репозитория, в котором вы работаете, включая ветку по умолчанию. Ветка, не являющаяся веткой по умолчанию, имя которой отмечает ее как цель развертывания или публикации, такая как `production` или `gh-pages`, не охватывается: классификатор судит отправку туда по ее собственным условиям. Содержимое отправки по-прежнему проверяется по другим правилам, [`permissions.deny` правила](/docs/ru/permissions#manage-permissions) по-прежнему могут блокировать команды push [как написано](/docs/ru/permissions#bash-rule-limits) в каждом режиме, и собственная защита ветки удаленного хранилища по-прежнему применяется. До v2.1.211 разрешены были только отправки на ветку, на которой вы начали, ветки, которые создал Claude, и обычные отправки на ветку по умолчанию, и до v2.1.203 любая прямая отправка на ветку по умолчанию была заблокирована

423 423 

424Claude Code v2.1.195 и позже также разрешают эти действия по умолчанию:424Claude Code v2.1.195 и более поздние версии также разрешают эти по умолчанию:

425 425 

426* Удаление точных задач, которые Claude создал ранее в том же сеансе426* Удаление точных заданий, которые Claude создал ранее в том же сеансе

427* Чтение, проверка или написание кода, конфигов и моделей угроз, связанных с безопасностью, как часть вашей задачи427* Чтение, проверка или запись кода, конфигов и моделей угроз, связанных с безопасностью, как часть вашей задачи

428* Сообщения между агентами, работающими вместе в одном многоагентном сеансе428* Сообщения между агентами, работающими вместе в одном многоагентном сеансе

429* Отправка данных на доверенные домены, корзины и сервисы, которые вы указываете в [`environment`](/docs/ru/auto-mode-config#define-trusted-infrastructure). Это охватывает только поток данных, а не деструктивные или операции с учётными данными на той же инфраструктуре429* Отправка данных на доверенные домены, buckets и сервисы, которые вы указываете в [`environment`](/docs/ru/auto-mode-config#define-trusted-infrastructure). Это охватывает только поток данных, а не деструктивные или операции с учетными данными на той же инфраструктуре

430* [Claude in Chrome](/docs/ru/chrome) навигация на доверенный внутренний домен, localhost или URL, который вы назвали430* [Claude in Chrome](/docs/ru/chrome) навигация на доверенный внутренний домен, localhost или URL, который вы назвали

431 431 

432Запросы доступа к сети в песочнице не получают доступ к сети по умолчанию. Claude называет хосты, которые команде нужны на самой команде, классификатор проверяет их с командой, и одобренный список открывает эти хосты только для этой одной команды. [Per-command allowed domains](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode) охватывает то, что список может и не может открыть и что происходит, когда команда достигает неуказанного хоста.432Команды в песочнице не получают доступ в сеть по умолчанию. Claude называет хосты, которые команде нужны, на самой команде, классификатор проверяет их с командой, и одобренный список открывает эти хосты только для этой одной команды. [Разрешенные домены для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode) охватывает то, что список может и не может открыть и что происходит, когда команда достигает неуказанного хоста.

433 433 

434Запустите `claude auto-mode defaults`, чтобы вывести полные списки правил как JSON. Если обычные действия блокируются, администратор может добавить доверенные репозитории, корзины и сервисы через параметр `autoMode.environment`: см. [Настройка режима auto](/docs/ru/auto-mode-config).434Запустите `claude auto-mode defaults` для вывода полных списков правил как JSON. Если обычные действия блокируются, администратор может добавить доверенные репозитории, buckets и сервисы через параметр `autoMode.environment`: смотрите [Настройка автоматического режима](/docs/ru/auto-mode-config).

435 435 

436Отправка на любую ветвь репозитория, в котором вы работаете, и создание pull request, который соответствует вашему запросу, выполняются без запроса, если только отправка или pull request не попадают под [список блокировок](#what-the-classifier-blocks-by-default), такой как секреты или чувствительные данные, покидающие репозиторий, или pull request, нацеленный на другой репозиторий или организацию. Чтобы требовать контрольную точку человека перед этими командами, оставаясь в режиме auto, добавьте правила `permissions.ask`, которые соответствуют команде [как написано](/docs/ru/permissions#bash-rule-limits): см. [Общие границы](/docs/ru/auto-mode-config#common-boundaries).436Отправка на любую ветку репозитория, в котором вы работаете, и создание pull request, который соответствует вашему запросу, выполняются без запроса, если только отправка или pull request не попадают под [список блокировок](#what-the-classifier-blocks-by-default), такой как секреты или чувствительные данные, покидающие репозиторий, или pull request, нацеленный на другой репозиторий или организацию. Чтобы требовать контрольную точку человека перед этими командами, оставаясь в автоматическом режиме, добавьте правила `permissions.ask`, которые соответствуют команде [как написано](/docs/ru/permissions#bash-rule-limits): смотрите [Общие границы](/docs/ru/auto-mode-config#common-boundaries).

437 437 

438<h3 id="first-read-outside-the-working-directories">438<h3 id="first-read-outside-the-working-directories">

439 Первое чтение вне рабочих каталогов439 Первое чтение вне рабочих каталогов

440</h3>440</h3>

441 441 

442Пока [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) отключено, чтение файлов выполняется без запроса в режиме auto, включая чтение вне [рабочих каталогов](/docs/ru/permissions#working-directories). В первый раз, когда Claude использует инструмент Read, Grep или Glob на пути вне них, Claude Code спрашивает вас, следует ли продолжать разрешать эти чтения.442Пока [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) отключен, чтения файлов выполняются без запроса в автоматическом режиме, включая чтения вне [рабочих каталогов](/docs/ru/permissions#working-directories). Первый раз, когда Claude использует инструмент Read, Grep или Glob на пути вне них, Claude Code спрашивает вас, продолжать ли разрешать эти чтения.

443 443 

444Запрос не появляется в неинтерактивных запусках `-p` или фоновых сеансах; чтения там выполняются как раньше.444Запрос не появляется в неинтерактивных запусках `-p` или фоновых сеансах; чтения там выполняются как раньше.

445 445 

446Что бы вы ни ответили, Claude продолжает работать:446Независимо от вашего ответа, Claude продолжает работать:

447 447 

448* **Продолжить разрешение**: чтение выполняется, более поздние чтения вне рабочих каталогов выполняются как раньше, и Claude Code записывает ваш ответ, чтобы запрос не появился снова448* **Продолжить разрешение**: чтение выполняется, более поздние чтения вне рабочих каталогов выполняются как раньше, и Claude Code записывает ваш ответ, чтобы запрос больше не появлялся

449* **Блокировать с этого момента**: чтение отклоняется, и Claude Code устанавливает [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) на `true` в ваши пользовательские параметры, что делает инструменты файлов отклоняющими такие чтения в каждом более позднем сеансе и каждом режиме разрешений. Чтобы позволить Claude читать такой путь позже, добавьте его каталог с `/add-dir` или удалите параметр.449* **Блокировать с этого момента**: чтение отклоняется, и Claude Code устанавливает [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ru/settings-reference#permissions-blockreadsoutsideworkingdirectories) на `true` в ваши пользовательские параметры, что заставляет инструменты файлов отклонять такие чтения в каждом более позднем сеансе и каждом режиме разрешений. Чтобы позволить Claude позже прочитать такой путь, добавьте его каталог с `/add-dir` или удалите параметр.

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

451 451 

452<h3 id="boundaries-you-state-in-conversation">452<h3 id="boundaries-you-state-in-conversation">

453 Границы, которые вы указываете в разговоре453 Границы, которые вы указываете в разговоре

454</h3>454</h3>

455 455 

456Классификатор рассматривает границы, которые вы указываете в разговоре, как сигнал блокировки. Если вы скажете Claude "не отправляй" или "подожди, пока я проверю перед развёртыванием", классификатор блокирует соответствующие действия даже когда правила по умолчанию их разрешили бы. Граница остаётся в силе до тех пор, пока вы её не снимете в более позднем сообщении. Собственное суждение Claude о том, что условие было выполнено, не снимает его.456Классификатор рассматривает границы, которые вы указываете в разговоре, как сигнал блокировки. Если вы скажете Claude "не отправляй" или "подожди, пока я проверю перед развертыванием", классификатор блокирует соответствующие действия, даже когда правила по умолчанию их разрешали бы. Граница остается в силе до тех пор, пока вы не снимете ее в более позднем сообщении. Собственное суждение Claude о том, что условие было выполнено, не снимает его.

457 457 

458Границы не хранятся как правила. Классификатор перечитывает их из стенограммы при каждой проверке, поэтому граница может быть потеряна, если [компактирование контекста](/docs/ru/costs#reduce-token-usage) удалит сообщение, которое её указало. Для жёсткой гарантии добавьте [правило deny](/docs/ru/permissions#permission-rule-syntax) вместо этого.458Границы не хранятся как правила. Классификатор перечитывает их из стенограммы при каждой проверке, поэтому граница может быть потеряна, если [компактирование контекста](/docs/ru/costs#reduce-token-usage) удаляет сообщение, которое ее указало. Для жесткой гарантии добавьте вместо этого [правило отказа](/docs/ru/permissions#permission-rule-syntax).

459 

460<h3 id="approvals-you-state-in-conversation">

461 Одобрения, которые вы указываете в разговоре

462</h3>

463 

464Если вы скажете Claude, что заблокированное действие разрешено, классификатор читает это как ваше одобрение и может снять блок. То, как вы это сформулировали, решает, выполняется ли действие и как далеко распространяется одобрение:

465 

466* **Назовите действие и его специфику**: ваше сообщение должно назвать действие и конкретную вещь, которая делает его опасным, такую как ветка force push. Название только глагола ничего не очищает, поэтому "вы можете force-push" оставляет блок на месте.

467* **Ожидайте, что это охватит одно действие**: одобрение охватывает деструктивное действие, которое вы назвали, поэтому более позднее действие снова блокируется, если вы не предоставили одобрение как постоянное. Чтобы перестать одобрять обычный паттерн одно действие за раз, добавьте его в [`autoMode.allow`](/docs/ru/auto-mode-config#override-the-block-and-allow-rules).

468* **Некоторые блоки остаются на месте**: [порядок приоритета классификатора](/docs/ru/auto-mode-config#override-the-block-and-allow-rules) устанавливает, какие блоки может достичь ваше одобрение. Чтобы запустить шаг, который оно не очистит, [выйдите из автоматического режима](#switch-permission-modes) и ответьте на запрос разрешения.

459 469 

460<h3 id="when-auto-mode-falls-back">470<h3 id="when-auto-mode-falls-back">

461 Когда режим auto откатывается471 Когда автоматический режим возвращается

462</h3>472</h3>

463 473 

464Когда режим auto не может одобрить действия вашего сеанса, что происходит, зависит от случая:474Когда автоматический режим не может одобрить действия вашего сеанса, что происходит, зависит от случая:

465 475 

466* **Заблокированное действие**: Claude Code показывает уведомление и перечисляет действие в `/permissions` на вкладке **Recently denied**, где вы можете нажать `r`, чтобы повторить его с ручным одобрением. Когда классификатор производит [нет вердикта на действие](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action), потому что проверка безопасности, отдельная от режима auto, отклонила запрос классификатора или его ответ не был разобран, Claude Code отклоняет действие без уведомления или записи **Recently denied**.476* **Заблокированное действие**: Claude Code показывает уведомление и перечисляет действие в `/permissions` на вкладке **Recently denied**, где вы можете нажать `r` для повторной попытки с ручным одобрением. Когда классификатор выдает [отсутствие вердикта по действию](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action), потому что проверка безопасности, отдельная от автоматического режима, отклонила собственный запрос классификатора или его ответ не был разобран, Claude Code отклоняет действие без уведомления или записи **Recently denied**.

467* **Повторные блокировки**: если классификатор блокирует действие 3 раза подряд или 20 раз всего, режим auto приостанавливается и Claude Code возобновляет запрос. Одобрение запрашиваемого действия возобновляет режим auto. Эти пороги не настраиваются. Любое разрешённое действие сбрасывает счётчик последовательных блокировок, в то время как счётчик всего сохраняется для сеанса и сбрасывается только когда его собственный лимит вызывает откат. Claude Code не считает отказ к любому пороговому значению, когда [проверка безопасности, отдельная от режима auto, отклоняет запрос классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action); связанная запись охватывает, как Claude Code обрабатывает эти отказы.477* **Повторные блоки**: если классификатор блокирует действие 3 раза подряд или 20 раз всего, автоматический режим приостанавливается и Claude Code возобновляет запросы. Одобрение запрошенного действия возобновляет автоматический режим. Эти пороги не настраиваются. Любое разрешенное действие сбрасывает счетчик последовательных, пока счетчик всего сохраняется для сеанса и сбрасывается только когда его собственный предел запускает откат. Claude Code не считает отказ к любому пороговому значению, когда [проверка безопасности, отдельная от автоматического режима, отклоняет собственный запрос классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action); связанная запись охватывает, как Claude Code обрабатывает эти отказы.

468* **Сеансы, которые не могут запрашивать**: [неинтерактивный](/docs/ru/headless) запуск `-p` без [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) не имеет запроса для отката. Когда повторные блокировки достигают порога, действие не выполняется и Claude продолжает работу. То же самое применяется, когда [проверка безопасности, отдельная от режима auto, отклоняет запрос классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action). Claude Code не останавливает запуск ни в одном случае.478* **Сеансы, которые не могут спрашивать**: [неинтерактивный](/docs/ru/headless) запуск `-p` без [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) не имеет запроса для возврата. Когда повторные блоки достигают порога, действие не выполняется и Claude продолжает работать. То же самое применяется, когда [проверка безопасности, отдельная от автоматического режима, отклоняет запрос классификатора](/docs/ru/errors#auto-mode-cannot-determine-the-safety-of-an-action). Claude Code не останавливает запуск ни в одном случае.

469* **Переключение режима во время проверки**: если вы переключите режимы разрешений, пока проверка классификатора ожидает, Claude Code отбрасывает вердикт, который новый режим не запросил бы, вместо применения его: вы запрашиваетесь для одобрения вместо этого, или действие автоматически отклоняется в [режиме `dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).479* **Переключение режима во время проверки**: если вы переключаете режимы разрешений, пока проверка классификатора ожидает, Claude Code отклоняет вердикт, который новый режим не запросил бы, вместо его применения: вместо этого вас спрашивают для одобрения, или действие автоматически отклоняется в [`dontAsk` режиме](#allow-only-pre-approved-tools-with-dontask-mode).

470 480 

471Повторные блокировки обычно означают, что классификатор не имеет контекста о вашей инфраструктуре. Используйте `/feedback` для сообщения о ложных срабатываниях, или попросите администратора [настроить доверенную инфраструктуру](/docs/ru/auto-mode-config).481Повторные блоки обычно означают, что классификатор упускает контекст о вашей инфраструктуре. Используйте `/feedback` для сообщения о ложных срабатываниях, или пусть администратор [настроит доверенную инфраструктуру](/docs/ru/auto-mode-config).

472 482 

473<span id="how-the-classifier-evaluates-actions" />483<span id="how-the-classifier-evaluates-actions" />

474 484 

475<AccordionGroup>485<AccordionGroup>

476 <Accordion title="Как классификатор оценивает действия">486 <Accordion title="Как классификатор оценивает действия">

477 Каждое действие проходит через фиксированный порядок решений. Первый совпадающий шаг побеждает:487 Каждое действие проходит через фиксированный порядок решений. Первый соответствующий шаг побеждает:

478 488 

479 1. Действия, соответствующие вашим [правилам allow, ask или deny](/docs/ru/permissions#manage-permissions), разрешаются немедленно, с этими исключениями:489 1. Действия, соответствующие вашим [правилам разрешения, запроса или отказа](/docs/ru/permissions#manage-permissions), разрешаются немедленно, с этими исключениями:

480 * Записи в [защищённые пути](#protected-paths) маршрутизируются классификатору даже когда правило allow совпадает, и так же удаления `rm` и `rmdir`, нацеленные на [критический путь](#critical-paths) в Claude Code v2.1.218 и позже490 * Записи в [защищенные пути](#protected-paths) маршрутизируются к классификатору, даже когда правило разрешения соответствует, и так же `rm` и `rmdir` удаления, нацеленные на [критический путь](#critical-paths) в Claude Code v2.1.218 и более поздних версиях

481 * Инструменты MCP, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), запрашивают вас напрямую даже когда правило allow совпадает, и так же инструменты соединителя [ваша организация установила на `ask`](/docs/ru/mcp#organization-controls-on-connector-tools) в сеансах, где это параметр достигает Claude Code491 * MCP инструменты, отмеченные [`requiresUserInteraction`](/docs/ru/mcp#require-approval-for-a-specific-tool), спрашивают вас напрямую, даже когда правило разрешения соответствует, и так же инструменты connector, которые ваша организация установила на `ask`]\(/ru/mcp#organization-controls-on-connector-tools) в сеансах, где эта параметр достигает Claude Code

482 * Команда shell, которая несёт [per-command allowed domains](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), также маршрутизируется классификатору даже когда правило allow совпадает, потому что правило одобряет команду, а не её хосты492 * Команда оболочки, которая несет [разрешенные домены для каждой команды](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), также маршрутизируется к классификатору, даже когда правило разрешения соответствует, потому что правило одобряет команду, а не ее хосты

483 * Правила ask, которые совпадают на содержимом команды, такие как `Bash(git push *)`, откатываются к запросу разрешения493 * Правила запроса, которые соответствуют содержимому команды, такие как `Bash(git push *)`, возвращаются к запросу разрешения

484 2. Действия только для чтения и редактирование файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищённые пути](#protected-paths) и [первого чтения вне рабочих каталогов](#first-read-outside-the-working-directories), которое запрашивает вас494 2. Действия только для чтения и редактирования файлов в вашем рабочем каталоге автоматически одобряются, кроме записей в [защищенные пути](#protected-paths) и [первое чтение вне рабочих каталогов](#first-read-outside-the-working-directories), которое вас спрашивает

485 3. Всё остальное идёт классификатору. Инструменты соединителя и инструменты MCP `requiresUserInteraction`, которые запрашивают вас напрямую на шаге 1, никогда не достигают классификатора, поэтому ни одобрение, требуемое организацией, ни шаг согласия не одобряются автоматически495 3. Все остальное идет к классификатору. Инструменты connector и MCP инструменты `requiresUserInteraction`, которые спрашивают вас напрямую на шаге 1, никогда не достигают классификатора, поэтому ни одобрение, требуемое организацией, ни шаг согласия не автоматически одобряются

486 4. Если классификатор блокирует, Claude получает причину и пытается найти альтернативу. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, а не даёт письменное объяснение; см. [Проверка отказов](/docs/ru/auto-mode-config#review-denials)496 4. Если классификатор блокирует, Claude получает причину и пытается альтернативу. В большинстве сеансов причина называет правило, которое классификатор совпал, такое как `[Data Exfiltration]`, вместо того чтобы давать письменное объяснение; смотрите [Проверка отказов](/docs/ru/auto-mode-config#review-denials)

487 497 

488 При входе в режим auto широкие правила allow, которые предоставляют произвольное выполнение кода, отбрасываются:498 При входе в автоматический режим широкие правила разрешения, которые предоставляют произвольное выполнение кода, отбрасываются:

489 499 

490 * Неограниченный `Bash(*)` или `PowerShell(*)`500 * Blanket `Bash(*)` или `PowerShell(*)`

491 * Подстановочные интерпретаторы, такие как `Bash(python*)`501 * Подстановочные интерпретаторы, такие как `Bash(python*)`

492 * Команды запуска менеджера пакетов502 * Команды запуска менеджера пакетов

493 * Правила `Agent` allow503 * Правила `Agent`

494 * [`Monitor`](/docs/ru/tools-reference#monitor-tool) правила allow, потому что Claude Code запускает команды Monitor через оболочку504 * [`Monitor`](/docs/ru/tools-reference#monitor-tool) правила разрешения, потому что Claude Code запускает команды Monitor через оболочку

495 505 

496 Узкие правила, такие как `Bash(npm test)`, переносятся. Claude Code восстанавливает отброшенные правила при выходе из режима auto. До v2.1.236 Claude Code оставлял правила `Monitor` allow в силе в режиме auto, поэтому правило, которое совпадало со всем инструментом, одобряло команды Monitor без проверки классификатора.506 Узкие правила, такие как `Bash(npm test)`, остаются в силе. Claude Code восстанавливает отброшенные правила, когда вы выходите из автоматического режима. До v2.1.236 Claude Code оставлял правила `Monitor` разрешения в силе в автоматическом режиме, поэтому правило, которое совпадало со всем инструментом, одобряло команды Monitor без проверки классификатора.

497 507 

498 Claude Code также запускает `git status` сам перед командой, которая отбросила бы незафиксированную работу, такой как `git reset --hard` или `rm -rf`, и показывает классификатору, присутствует ли подготовленная, изменённая или неотслеживаемая работа. Claude Code сообщает неотслеживаемые файлы в этой проверке даже когда конфигурация git репозитория устанавливает `status.showUntrackedFiles=no`.508 Claude Code также запускает `git status` сам перед командой, которая отбросила бы незафиксированную работу, такой как `git reset --hard` или `rm -rf`, и показывает классификатору, присутствует ли поставленная на сцену, измененная или неотслеживаемая работа. Claude Code сообщает неотслеживаемые файлы в этой проверке, даже когда конфигурация git репозитория устанавливает `status.showUntrackedFiles=no`.

499 509 

500 В запросах классификатора, отправленных самим Claude Code, классификатор видит сообщения пользователя, вызовы инструментов, отличные от чтения только для чтения, таких как чтение файлов и поиск, и содержимое вашего CLAUDE.md. Результаты инструментов удаляются, поэтому враждебное содержимое в файле или веб-странице не может манипулировать классификатором напрямую. Вы можете аннотировать результат вызова с помощью поля [`classifierContext`](/docs/ru/hooks#annotate-a-result-for-the-auto-mode-classifier) hook `PostToolUse`, который классификатор читает как контекст, предоставленный приложением.510 В запросах классификатора, отправленных самим Claude Code, классификатор видит пользовательские сообщения, вызовы инструментов, отличные от чтений только для чтения, такие как чтения файлов и поиски, и содержимое вашего CLAUDE.md. Результаты инструментов удаляются из этих запросов, поэтому враждебное содержимое в файле или веб-странице не может напрямую манипулировать классификатором.

501 511 

502 Отдельный зонд на стороне сервера сканирует входящие результаты инструментов и отмечает подозрительное содержимое перед тем, как Claude его прочитает. Для получения дополнительной информации о том, как эти слои работают вместе, см. [объявление режима auto](https://claude.com/blog/auto-mode) и [инженерный анализ](https://www.anthropic.com/engineering/claude-code-auto-mode).512 Вы можете аннотировать результат вызова с помощью поля [`classifierContext`](/docs/ru/hooks#annotate-a-result-for-the-auto-mode-classifier) hook PostToolUse, которое классификатор читает как контекст, предоставленный приложением. Поле требует Claude Code v2.1.236 или более поздней версии.

503 </Accordion>

504 513 

505 <Accordion title="Как режим auto обрабатывает подагентов">514 Отдельный зонд на стороне сервера сканирует входящие результаты инструментов и отмечает подозрительное содержимое перед тем как Claude его прочитает. Для получения дополнительной информации о том, как эти слои работают вместе, смотрите [объявление автоматического режима](https://claude.com/blog/auto-mode) и [инженерное углубленное погружение](https://www.anthropic.com/engineering/claude-code-auto-mode).

506 Классификатор проверяет работу [подагента](/docs/ru/sub-agents) в трёх точках:515 </Accordion>

507 516 

508 1. Перед запуском подагента описание делегированной задачи оценивается, так что опасно выглядящая задача блокируется во время порождения.517 <Accordion title="Как автоматический режим обрабатывает подагентов">

509 2. Пока подагент работает, каждое его действие проходит через классификатор с теми же правилами, что и родительский сеанс, и любой `permissionMode` в frontmatter подагента игнорируется.518 Классификатор проверяет работу [подагента](/docs/ru/sub-agents) в трех точках:

510 3. Когда подагент завершается, классификатор проверяет его работу и его финальный отчёт перед тем как родитель прочитает отчёт. Когда классификатор отмечает работу подагента или отчёт, или отдельная проверка безопасности API отклоняет саму проверку, отчёт по-прежнему доставляется, предваренный предупреждением безопасности. Когда классификатор недоступен для проверки, отчёт прибывает с примечанием проверить работу подагента перед действием на его основе.

511 519 

512 Шаг 1 требует Claude Code v2.1.178 или позже. Более ранние версии применяли классификатор на шагах 2 и 3, но не оценивали описание задачи перед запуском подагента.520 1. Перед запуском подагента описание делегированной задачи оценивается, поэтому опасно выглядящая задача блокируется во время создания.

521 2. Пока подагент работает, каждое из его действий проходит через классификатор с теми же правилами, что и родительский сеанс, и любой `permissionMode` в frontmatter подагента игнорируется.

522 3. Когда подагент завершается, классификатор проверяет его работу и его финальный отчет перед тем как родитель прочитает отчет. Когда классификатор отмечает работу подагента или отчет, или отдельная проверка безопасности API отклоняет проверку, отчет все еще доставляется, предваренный предупреждением безопасности. Когда классификатор недоступен для проверки, отчет прибывает с примечанием для проверки работы подагента перед действием на его основе.

513 </Accordion>523 </Accordion>

514 524 

515 <Accordion title="Стоимость и задержка">525 <Accordion title="Стоимость и задержка">

516 Классификатор работает на Claude Sonnet 5 по умолчанию, а не на вашем выборе `/model`. Модель классификатора, которую Anthropic настраивает на стороне сервера, имеет приоритет над этим значением по умолчанию. Когда модель вашего сеанса — Claude Sonnet 4.6, или когда [`availableModels`](/docs/ru/model-config#restrict-model-selection) исключает Sonnet 5, классификатор работает на модели вашего сеанса вместо этого, или на модели Opus, когда сеанс работает на [модели Fable](/docs/ru/model-config#work-with-fable); на поставщиках, отличных от Anthropic API, этот fallback Opus — модель Opus поставщика по умолчанию.526 Классификатор работает на Claude Sonnet 5 по умолчанию, а не на выборе вашего `/model`. Модель классификатора, которую Anthropic настраивает на стороне сервера, имеет приоритет над этим по умолчанию. Когда модель вашего сеанса является Claude Sonnet 4.6, или когда [`availableModels`](/docs/ru/model-config#restrict-model-selection) исключает Sonnet 5, классификатор работает на модели вашего сеанса вместо этого, или на модели Opus, когда сеанс работает на [модели Fable](/docs/ru/model-config#work-with-fable); на поставщиках, отличных от Anthropic API, этот fallback Opus является моделью Opus по умолчанию поставщика.

517 527 

518 Первый запрос режима auto сеанса проверяет значение по умолчанию Sonnet 5: если запрос успешен, Sonnet 5 остаётся моделью классификатора сеанса, и если он не удаётся, потому что модель недоступна, сеанс использует fallback вместо этого. После того как эта проверка урегулируется, модель классификатора не изменяется для сеанса.528 Первый запрос автоматического режима сеанса проверяет по умолчанию Sonnet 5: если запрос успешен, Sonnet 5 остается моделью классификатора сеанса, и если он не удается, потому что модель недоступна, сеанс использует fallback вместо этого. После того как эта проверка урегулируется, модель классификатора не изменяется для сеанса.

519 529 

520 На планах Enterprise и на учётных записях, которые используют Claude API, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, вызовы классификатора учитываются в использовании токенов. Каждая проверка отправляет часть стенограммы плюс ожидающее действие, добавляя круговой путь перед выполнением. Чтение и редактирование рабочего каталога вне защищённых путей пропускают классификатор, поэтому накладные расходы поступают в основном от команд оболочки и сетевых операций. Где сервер проверяет действия как часть запросов модели сеанса, нет отдельных вызовов классификатора для подсчёта; см. [Server-side classifier review](#server-side-classifier-review).530 На планах Enterprise и на учетных записях, которые используют Claude API, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, вызовы классификатора считаются в сторону использования вашего токена. Каждая проверка отправляет часть стенограммы плюс ожидающее действие, добавляя round-trip перед выполнением. Чтения и редактирования рабочего каталога вне защищенных путей пропускают классификатор, поэтому накладные расходы поступают в основном из команд оболочки и сетевых операций. Где сервер проверяет действия как часть запросов модели сеанса, нет отдельных вызовов классификатора для подсчета; смотрите [Проверка классификатора на стороне сервера](#server-side-classifier-review).

521 531 

522 Доступ к сети в песочнице не добавляет запросы классификатора для каждого подключения. Классификатор судит [хосты, которые команда называет](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode) вместе с командой в одной проверке, и Claude Code проверяет каждое подключение против одобренного списка без повторного вызова классификатора.532 Доступ в песочницу в сеть не добавляет запросы классификатора для каждого соединения. Классификатор судит [хосты, которые команда называет](/docs/ru/sandboxing#per-command-allowed-domains-in-auto-mode), вместе с командой в одной проверке, и Claude Code проверяет каждое соединение по одобренному списку без повторного вызова классификатора.

523 </Accordion>533 </Accordion>

524</AccordionGroup>534</AccordionGroup>

525 535 

660 670 

661Claude Code также рассматривает glob или косую черту непосредственно под переменной оболочки, такую как `rm -rf "$DIR"/*`, как удаление критического пути, потому что команда становится удалением из корня файловой системы, когда переменная пуста.671Claude Code также рассматривает glob или косую черту непосредственно под переменной оболочки, такую как `rm -rf "$DIR"/*`, как удаление критического пути, потому что команда становится удалением из корня файловой системы, когда переменная пуста.

662 672 

663Скрытие удаления внутри подстановки команд с `$(...)` или обратными кавычками, или подстановки процесса с `<(...)`, не пропускает проверку. Claude Code находит удаление критического пути, находится ли оно внутри подстановки, как в `(rm -rf ~)` или `echo "$(rm -rf ~)"`, или в другом месте той же команды.673Подсказка для этого случая переменной называет помеченную команду `rm` и говорит, как переписать её, чтобы проверка прошла:

674 

675* Для переменной, такой как `$DIR`, защитите каждое расширение так, чтобы оболочка остановилась с ошибкой, когда переменная не установлена или пуста, как в `rm -rf "${DIR:?}"/*`, или используйте буквальный путь

676* Для переменной, которая обычно установлена, такой как `$HOME`, используйте буквальный путь

677 

678Удаление, чьи расширения защищены таким образом, не является удалением критического пути, поэтому в режиме `bypassPermissions` оно выполняется без подсказки.

679 

680Скрытие удаления внутри подстановки с `(...)`, группы в фигурных скобках с `{ ...; }`, подстановки команд с `$(...)` или обратными кавычками, или подстановки процесса с `<(...)`, не пропускает проверку. Claude Code находит удаление критического пути, находится ли оно внутри вложенной формы, как в `(rm -rf ~)` или `echo "$(rm -rf ~)"`, или в другом месте той же команды.

664 681 

665<h3 id="remove-item-in-powershell">682<h3 id="remove-item-in-powershell">

666 Remove-Item в PowerShell683 Remove-Item в PowerShell

permissions.md +2 −10

Details

26 26 

27До версии 2.1.211 Claude Code всегда сохранял правило в начальном каталоге, поэтому одобрение, предоставленное в worktree или подкаталоге, не применялось к остальной части репозитория. Правила, которые более ранние версии сохранили в подкаталоге или worktree, по-прежнему применяются к сеансам, запущенным там.27До версии 2.1.211 Claude Code всегда сохранял правило в начальном каталоге, поэтому одобрение, предоставленное в worktree или подкаталоге, не применялось к остальной части репозитория. Правила, которые более ранние версии сохранили в подкаталоге или worktree, по-прежнему применяются к сеансам, запущенным там.

28 28 

29Иногда запрос разрешения предлагает только одноразовое одобрение, без опции "не спрашивать снова" и без опции разрешить действие на остаток сеанса. Claude Code предлагает эти опции только когда запрос может показать вам всё, что они позволили бы, поэтому правило, которое вы сохраняете из запроса, охватывает только то, что названо его опцией.29Иногда запрос разрешения предлагает только одноразовое одобрение, без опции "не спрашивать снова" и без опции разрешить действие на остаток сеанса. Claude Code предлагает эти опции только когда запрос может показать вам всё, что они позволили бы, поэтому правило, которое вы сохраняете из запроса, охватывает только то, что названо его опцией. Когда запрос предлагает только одноразовое одобрение, одобрите действие один раз или добавьте правило самостоятельно в [`/permissions`](#manage-permissions).

30 

31Когда каталог, в котором вы запустили Claude Code, делает метку опции слишком длинной, Claude Code сокращает её в метке, заменяя ваш домашний каталог на `~` и затем конец пути на `…`, и сохраняет опцию. Вы по-прежнему сохраняете то же правило. Claude Code исключает опции в трёх случаях:

32 

33* **Команда или редактирование:** слишком большое для полного отображения.

34* **Команды или пути, которые охватывает правило:** метка не может вместить их все.

35* **Начальный каталог слишком длинный, не сокращённый:** он содержит символы, которые Claude Code не может безопасно отобразить, или даже его начало не подходит.

36 

37Одобрите действие один раз или добавьте правило самостоятельно в [`/permissions`](#manage-permissions).

38 30 

39<h3 id="add-a-comment-when-you-answer-a-permission-prompt">31<h3 id="add-a-comment-when-you-answer-a-permission-prompt">

40 Добавьте комментарий при ответе на запрос разрешения32 Добавьте комментарий при ответе на запрос разрешения

224 216 

225Правила разрешения принимают glob-шаблоны имён инструментов только после буквального префикса `mcp__<server>__`. Сегмент сервера должен быть свободен от glob, поэтому правило называет конкретный сервер, который вы настроили. `mcp__puppeteer__*` совпадает с каждым инструментом с сервера `puppeteer`, и `mcp__github__get_*` совпадает с его инструментами `get_`. Неякорированный glob разрешения, такой как `"*"`, `"B*"` или `"mcp__*"`, пропускается с предупреждением и не одобряет ничего автоматически.217Правила разрешения принимают glob-шаблоны имён инструментов только после буквального префикса `mcp__<server>__`. Сегмент сервера должен быть свободен от glob, поэтому правило называет конкретный сервер, который вы настроили. `mcp__puppeteer__*` совпадает с каждым инструментом с сервера `puppeteer`, и `mcp__github__get_*` совпадает с его инструментами `get_`. Неякорированный glob разрешения, такой как `"*"`, `"B*"` или `"mcp__*"`, пропускается с предупреждением и не одобряет ничего автоматически.

226 218 

227Правило отказа или запроса, имя инструмента которого не совпадает ни с одним известным инструментом, выдает предупреждение при запуске, чтобы поймать опечатки. Имена инструментов, содержащие `_` или `*`, освобождаются от проверки.219Правило отказа или запроса, имя инструмента которого не совпадает ни с одним известным инструментом, выдает предупреждение при запуске, чтобы поймать опечатки. Имена инструментов, содержащие `_` или `*`, освобождаются от проверки, и так же как и имена инструментов, которые Claude Code удалил, такие как `TaskOutput`.

228 220 

229Метка, отображаемая для инструмента в стенограмме и диалоге разрешений, может отличаться от его канонического имени. Например, инструмент с меткой `Stop Task` в стенограмме имеет каноническое имя `TaskStop`. Правила разрешений и [матчеры hook](/docs/ru/hooks) не совпадают с меткой, поэтому правило, написанное как `Stop Task`, не совпадает. Для правил отказа и запроса предупреждение при запуске выше ловит несоответствие. Используйте канонические имена, указанные в [справочнике инструментов](/docs/ru/tools-reference).221Метка, отображаемая для инструмента в стенограмме и диалоге разрешений, может отличаться от его канонического имени. Например, инструмент с меткой `Stop Task` в стенограмме имеет каноническое имя `TaskStop`. Правила разрешений и [матчеры hook](/docs/ru/hooks) не совпадают с меткой, поэтому правило, написанное как `Stop Task`, не совпадает. Для правил отказа и запроса предупреждение при запуске выше ловит несоответствие. Используйте канонические имена, указанные в [справочнике инструментов](/docs/ru/tools-reference).

230 222 

plugin-evals.md +3 −1

Details

339 Предоставьте инструменты339 Предоставьте инструменты

340</h3>340</h3>

341 341 

342Запуски никогда не останавливаются, чтобы попросить разрешение. Встроенные инструменты, которые нуждаются в гранте, который вы не дали, такие как `Bash`, `Write`, `Edit`, `WebFetch` и `WebSearch`, удаляются из сессии, поэтому Claude не может их вызывать вообще. Allowlist — это инструменты только для чтения, которые кейс перечисляет в `allowed_tools`, из `Read`, `Glob`, `Grep`, `NotebookRead`, `Skill`, `Agent`, `TodoWrite` и инструменты задач `TaskCreate`, `TaskGet`, `TaskList`, `TaskUpdate`, `TaskStop` и `TaskOutput`, плюс все, что вы предоставляете с `--allow-tools`, что применяется к каждому кейсу в запуске. Чтобы позволить кейсам использовать `Bash`, `Write`, `Edit`, `WebFetch` или `WebSearch`, предоставьте их сами:342Запуски никогда не останавливаются, чтобы попросить разрешение. Встроенные инструменты, которые нуждаются в гранте, который вы не дали, такие как `Bash`, `Write`, `Edit`, `WebFetch` и `WebSearch`, удаляются из сессии, поэтому Claude не может их вызывать вообще.

343 

344Allowlist — это инструменты только для чтения, которые кейс перечисляет в `allowed_tools`, из `Read`, `Glob`, `Grep`, `NotebookRead`, `Skill`, `Agent`, `TodoWrite` и инструменты задач `TaskCreate`, `TaskGet`, `TaskList`, `TaskUpdate` и `TaskStop`, плюс все, что вы предоставляете с `--allow-tools`. Этот грант применяется к каждому кейсу в запуске. Чтобы позволить кейсам использовать `Bash`, `Write`, `Edit`, `WebFetch` или `WebSearch`, предоставьте их сами:

343 345 

344```bash theme={null}346```bash theme={null}

345claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"347claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"

Details

71Detailed system prompt for the agent describing its role, expertise, and behavior.71Detailed system prompt for the agent describing its role, expertise, and behavior.

72```72```

73 73 

74Агенты плагинов поддерживают поля frontmatter `name`, `description`, `model`, `effort`, `maxTurns`, `tools`, `disallowedTools`, `skills`, `memory`, `background`, [`omitClaudeMd`](/docs/ru/sub-agents#supported-frontmatter-fields) и `isolation`. Единственное допустимое значение `isolation` — это `"worktree"`.74<h4 id="plugin-agent-frontmatter">

75 Frontmatter агента плагина

76</h4>

77 

78Файл агента плагина использует те же [поля frontmatter, что и файл подагента](/docs/ru/sub-agents#supported-frontmatter-fields), за исключением того, что Claude Code учитывает только некоторые из них, когда агент поступает из плагина:

79 

80* **Поддерживаемые**: `name`, `description`, `model`, `effort`, `maxTurns`, `tools`, `disallowedTools`, `skills`, `memory`, `background`, `omitClaudeMd`, `isolation`, `color` и `experimental`. Единственное допустимое значение `isolation` — это `"worktree"`.

81* **Не поддерживаемые по соображениям безопасности**: `hooks`, `mcpServers` и `permissionMode`. Claude Code игнорирует их при загрузке агента из плагина. Чтобы их использовать, скопируйте файл агента в `.claude/agents/` или `~/.claude/agents/`.

82* **Не поддерживаемые**: `initialPrompt`.

75 83 

76По соображениям безопасности агенты, поставляемые плагинами, не поддерживают `hooks`, `mcpServers` или `permissionMode`.84Вы можете поместить файлы агента плагина в подпапки `agents/`. Claude Code [загружает их рекурсивно](/docs/ru/sub-agents#choose-the-subagent-scope) и объединяет имя плагина, каждое имя подпапки и имя файла с двоеточиями для формирования scoped имени агента. Например, `agents/review/security.md` в плагине с именем `my-plugin` загружается как `my-plugin:review:security`. Два параметра изменяют это имя:

85 

86* Frontmatter `name`: он заменяет только имя файла, поэтому `name: audit` в `agents/review/security.md` загружается как `my-plugin:review:audit`

87* Поле манифеста [`agents`](#component-path-fields): файл, который вы там указываете, загружается без имён подпапок, поэтому `"agents": "./custom/review/security.md"` загружается как `my-plugin:security`

77 88 

78Claude Code загружает агента плагина даже когда его frontmatter не имеет `name` или не анализируется:89Claude Code загружает агента плагина даже когда его frontmatter не имеет `name` или не анализируется:

79 90 

471***482***

472 483 

473<h2 id="plugin-manifest-schema">484<h2 id="plugin-manifest-schema">

474 Схема манифеста плагина485 Схема манифеста plugin

475</h2>486</h2>

476 487 

477Файл `.claude-plugin/plugin.json` определяет метаданные и конфигурацию вашего плагина.488Файл `.claude-plugin/plugin.json` определяет метаданные и конфигурацию вашего plugin.

478 489 

479Манифест является необязательным. Если он опущен, Claude Code автоматически обнаруживает компоненты в [местоположениях по умолчанию](#file-locations-reference) и выводит имя плагина из имени каталога. Используйте манифест, когда вам нужно предоставить метаданные или пользовательские пути компонентов.490Манифест является необязательным. Если он опущен, Claude Code автоматически обнаруживает компоненты в [местоположениях по умолчанию](#file-locations-reference) и выводит имя plugin из имени каталога. Используйте манифест, когда вам нужно предоставить метаданные или пользовательские пути компонентов.

480 491 

481<h3 id="complete-schema">492<h3 id="complete-schema">

482 Полная схема493 Полная схема

524Если вы включаете манифест, `name` — единственное обязательное поле.535Если вы включаете манифест, `name` — единственное обязательное поле.

525 536 

526| Поле | Тип | Описание | Пример |537| Поле | Тип | Описание | Пример |

527| :----- | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |538| :----- | :----- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |

528| `name` | string | Уникальный идентификатор в kebab-case без пробелов, управляющих символов или символов двунаправленного форматирования. Когда [запись на маркетплейсе](/docs/ru/plugin-marketplaces#plugin-entries) указывает плагин под другим именем, имя записи маркетплейса — это то, что используют ключи `enabledPlugins` и `/plugin` | `"deployment-tools"` |539| `name` | string | Уникальный идентификатор в kebab-case без пробелов, управляющих символов или символов двунаправленного форматирования. Когда [запись marketplace](/docs/ru/plugin-marketplaces#plugin-entries) указывает plugin под другим именем, имя записи marketplace — это то, что используют ключи `enabledPlugins` и `/plugin` | `"deployment-tools"` |

529 540 

530Это имя используется для пространства имён компонентов. Например, в пользовательском интерфейсе агент `agent-creator` для плагина с именем `plugin-dev` будет отображаться как `plugin-dev:agent-creator`.541Это имя используется для пространства имён компонентов. Например, в пользовательском интерфейсе agent `agent-creator` для plugin с именем `plugin-dev` будет отображаться как `plugin-dev:agent-creator`.

531 542 

532<h3 id="unrecognized-fields">543<h3 id="unrecognized-fields">

533 Нераспознанные поля544 Нераспознанные поля

534</h3>545</h3>

535 546 

536Claude Code игнорирует поля верхнего уровня, которые он не распознаёт. Вы можете сохранить метаданные из другой экосистемы в `plugin.json`, и плагин всё равно загрузится. Это позволяет практично поддерживать один манифест, который одновременно служит манифестом расширения VS Code или Cursor, `package.json` npm или манифестом пакета MCPB/DXT.547Claude Code игнорирует поля верхнего уровня, которые он не распознаёт. Вы можете сохранить метаданные из другой экосистемы в `plugin.json`, и plugin всё равно загрузится. Это позволяет практично поддерживать один манифест, который одновременно служит манифестом расширения VS Code или Cursor, npm `package.json` или манифестом bundle MCPB/DXT.

537 548 

538`claude plugin validate` сообщает о нераспознанных полях как о предупреждениях, а не об ошибках. Если поле отличается на один или два символа от распознанного, предупреждение предлагает вероятное предполагаемое имя. Плагин только с предупреждениями о нераспознанных полях всё равно проходит валидацию и загружается во время выполнения.549`claude plugin validate` сообщает о нераспознанных полях как о предупреждениях, а не об ошибках. Если поле отличается на один или два символа от распознанного, предупреждение предлагает вероятное предполагаемое имя. Plugin только с предупреждениями о нераспознанных полях всё равно проходит валидацию и загружается во время выполнения.

539 550 

540То, как Claude Code обрабатывает распознанное поле, значение которого имеет неправильный тип, зависит от поля:551То, как Claude Code обрабатывает распознанное поле, значение которого имеет неправильный тип, зависит от поля:

541 552 

542* **Большинство полей**: плагин не загружается. Например, значение `keywords`, которое является строкой вместо массива, является ошибкой загрузки, и `claude plugin validate` сообщает об этом.553* **Большинство полей**: plugin не загружается. Например, значение `keywords`, которое является строкой вместо массива, является ошибкой загрузки, и `claude plugin validate` сообщает об этом.

543* **`experimental` и `metadata`**: Claude Code игнорирует значение, которое не является объектом, и `claude plugin validate` сообщает предупреждение.554* **`experimental` и `metadata`**: Claude Code игнорирует значение, которое не является объектом, и `claude plugin validate` сообщает предупреждение.

544 555 

545Передайте `--strict`, чтобы рассматривать предупреждения как ошибки. Используйте это в CI, чтобы перехватить опечатку в имени поля или поле, оставшееся от манифеста другого инструмента перед публикацией, даже если плагин загружался бы во время выполнения.556Передайте `--strict`, чтобы рассматривать предупреждения как ошибки. Используйте это в CI, чтобы перехватить неправильно написанное имя поля или поле, оставшееся от манифеста другого инструмента перед публикацией, даже если plugin загружается во время выполнения.

546 557 

547```bash theme={null}558```bash theme={null}

548claude plugin validate ./my-plugin --strict559claude plugin validate ./my-plugin --strict

553</h3>564</h3>

554 565 

555| Поле | Тип | Описание | Пример |566| Поле | Тип | Описание | Пример |

556| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |567| :--------------- | :------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

557| `$schema` | string | URL JSON Schema для автодополнения и валидации редактора. Claude Code игнорирует это поле во время загрузки. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |568| `$schema` | string | URL JSON Schema для автодополнения и валидации редактора. Claude Code игнорирует это поле во время загрузки. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |

558| `displayName` | string | Читаемое имя, отображаемое в средстве выбора `/plugin` и других поверхностях пользовательского интерфейса. Для плагина, установленного с маркетплейса, `displayName` в [записи маркетплейса](/docs/ru/plugin-marketplaces#optional-plugin-fields) имеет приоритет над этим значением. Когда имя отображения не установлено ни в одном месте, пользователи видят `name`. В отличие от `name`, может содержать пробелы и любой регистр. Не используется для пространства имён или поиска. | `"Deployment Tools"` |569| `displayName` | string | Удобочитаемое имя, отображаемое в средстве выбора `/plugin` и других поверхностях пользовательского интерфейса. Для plugin, установленного из marketplace, `displayName` в [записи marketplace](/docs/ru/plugin-marketplaces#optional-plugin-fields) имеет приоритет над этим значением. Когда имя отображения не установлено ни в одном месте, пользователи видят `name`. В отличие от `name`, может содержать пробелы и любой регистр. Не используется для пространства имён или поиска. | `"Deployment Tools"` |

559| `version` | string | Необязательно. Семантическая версия. Установка этого параметра закрепляет плагин на этой строке версии, поэтому пользователи получают обновления только при её изменении, за исключением [источника `command`](/docs/ru/plugin-marketplaces#command-sources) или плагина [загруженного на месте](#plugin-caching-and-file-resolution); см. [Управление версиями](#version-management). Если также установлено в записи маркетплейса, `plugin.json` имеет приоритет. Если опущено, версия берётся из следующего источника в [Управлении версиями](#version-management). | `"2.1.0"` |570| `version` | string | Необязательно. Семантическая версия. Установка этого параметра закрепляет plugin на этой строке версии, поэтому пользователи получают обновления только при её изменении, за исключением [источника `command`](/docs/ru/plugin-marketplaces#command-sources) или plugin [загруженного на месте](#plugin-caching-and-file-resolution); см. [Управление версиями](#version-management). Если также установлено в записи marketplace, `plugin.json` имеет приоритет. Если опущено, версия берётся из следующего источника в [Управлении версиями](#version-management). | `"2.1.0"` |

560| `description` | string | Краткое объяснение назначения плагина | `"Deployment automation tools"` |571| `description` | string | Краткое объяснение назначения plugin | `"Deployment automation tools"` |

561| `author` | object | Информация об авторе | `{"name": "Dev Team", "email": "dev@company.com"}` |572| `author` | object | Информация об авторе | `{"name": "Dev Team", "email": "dev@company.com"}` |

562| `homepage` | string | URL документации | `"https://docs.example.com"` |573| `homepage` | string | URL документации | `"https://docs.example.com"` |

563| `repository` | string | URL исходного кода | `"https://github.com/user/plugin"` |574| `repository` | string | URL исходного кода | `"https://github.com/user/plugin"` |

564| `license` | string | Идентификатор лицензии | `"MIT"`, `"Apache-2.0"` |575| `license` | string | Идентификатор лицензии | `"MIT"`, `"Apache-2.0"` |

565| `keywords` | array | Теги обнаружения | `["deployment", "ci-cd"]` |576| `keywords` | array | Теги обнаружения | `["deployment", "ci-cd"]` |

566| `metadata` | object | Объект произвольной формы для ваших собственных данных, таких как поля прав доступа или каталога. Claude Code не читает его, поэтому значения никогда не влияют на поведение плагина. Claude Code игнорирует значение, которое не является объектом, и `claude plugin validate` сообщает об этом как о предупреждении. До версии 2.1.222 Claude Code рассматривал ключ как [нераспознанное поле](#unrecognized-fields). | `{"catalogId": "cat-123"}` |577| `metadata` | object | Объект произвольной формы для ваших собственных данных, таких как поля прав доступа или каталога. Claude Code не читает его, поэтому значения никогда не влияют на поведение plugin. Claude Code игнорирует значение, которое не является объектом, и `claude plugin validate` сообщает об этом как о предупреждении. До v2.1.222 Claude Code рассматривал ключ как [нераспознанное поле](#unrecognized-fields). | `{"catalogId": "cat-123"}` |

567| `defaultEnabled` | boolean | Включен ли плагин в состояние по умолчанию, когда пользователь не установил его. По умолчанию `true`. См. [Включение по умолчанию](#default-enablement). | `false` |578| `defaultEnabled` | boolean | Включен ли plugin в состояние по умолчанию, когда пользователь не установил его. По умолчанию `true`. См. [Включение по умолчанию](#default-enablement). | `false` |

568 579 

569<h3 id="default-enablement">580<h3 id="default-enablement">

570 Включение по умолчанию581 Включение по умолчанию

571</h3>582</h3>

572 583 

573Установите `defaultEnabled: false` в `plugin.json`, чтобы доставить плагин, который устанавливается отключённым. Пользователь включает его с помощью `claude plugin enable <plugin>` или интерфейса `/plugin`. Используйте это для плагинов, которые добавляют стоимость или область, в которую пользователь должен явно согласиться, например для плагина, который подключается к внешнему сервису.584Установите `defaultEnabled: false` в `plugin.json`, чтобы отправить plugin, который устанавливается отключённым. Пользователь включает его с помощью `claude plugin enable <plugin>` или интерфейса `/plugin`. Используйте это для plugin, которые добавляют стоимость или область, в которую пользователь должен согласиться, например для plugin, который подключается к внешнему сервису.

574 585 

575`defaultEnabled` — это резервный вариант, когда ничто другое не определило состояние плагина. Два фактора имеют приоритет над ним:586`defaultEnabled` — это резервный вариант, когда ничто другое не решило состояние plugin. Параметр пользователя и требование зависимости имеют приоритет над ним:

576 587 

577* **Параметр пользователя**: запись для плагина в `enabledPlugins` в любой области параметров. После записи она сохраняется при обновлениях и переустановках плагина, поэтому изменение `defaultEnabled` в более позднем выпуске не переключает существующего пользователя.588* **Параметр пользователя**: запись для plugin в `enabledPlugins` в любой области параметров. После записи она сохраняется при обновлениях и переустановках plugin, поэтому изменение `defaultEnabled` в более позднем выпуске не переключает существующего пользователя.

578* **Требование зависимости**: когда плагин требуется другим активным плагином, Claude Code записывает `true` для него во время установки или включения. Это даёт ему явный параметр, поэтому его собственное значение по умолчанию больше не применяется. См. [Включение или отключение плагина с зависимостями](/docs/ru/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies).589* **Требование зависимости**: когда plugin требуется другим, который активен, Claude Code записывает `true` для него во время установки или включения. Это даёт ему явный параметр, поэтому его собственное значение по умолчанию больше не применяется. См. [Включение или отключение plugin с зависимостями](/docs/ru/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies).

579 590 

580То же поле может появиться в записи маркетплейса плагина, где оно имеет приоритет над значением в `plugin.json`. См. [Необязательные поля плагина](/docs/ru/plugin-marketplaces#optional-plugin-fields).591То же поле может появиться в записи marketplace plugin, где оно имеет приоритет над значением в `plugin.json`. См. [Необязательные поля plugin](/docs/ru/plugin-marketplaces#optional-plugin-fields).

581 592 

582<h3 id="component-path-fields">593<h3 id="component-path-fields">

583 Поля пути компонента594 Поля пути компонента

584</h3>595</h3>

585 596 

586| Поле | Тип | Описание | Пример |597| Поле | Тип | Описание | Пример |

587| :---------------------- | :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |598| :---------------------- | :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

588| `skills` | string\|array | Пользовательские каталоги skills, содержащие `<name>/SKILL.md`. Добавляет к сканированию по умолчанию `skills/`. См. [Правила поведения пути](#path-behavior-rules) для исключения корня маркетплейса | `"./custom/skills/"` |599| `skills` | string\|array | Пользовательские каталоги skills, содержащие `<name>/SKILL.md`. Добавляет к сканированию `skills/` по умолчанию. См. [Правила поведения пути](#path-behavior-rules) для исключения корня marketplace | `"./custom/skills/"` |

589| `commands` | string\|array | Пользовательские плоские файлы `.md` skills или каталоги (заменяет значение по умолчанию `commands/`) | `"./custom/cmd.md"` или `["./cmd1.md"]` |600| `commands` | string\|array | Пользовательские плоские файлы `.md` skill или каталоги (заменяет `commands/` по умолчанию) | `"./custom/cmd.md"` или `["./cmd1.md"]` |

590| `agents` | string\|array | Пользовательские файлы агентов (заменяет значение по умолчанию `agents/`) | `"./custom/agents/reviewer.md"` |601| `agents` | string\|array | Пользовательские файлы agent (заменяет `agents/` по умолчанию) | `"./custom/agents/reviewer.md"` |

591| `workflows` | string\|array | Пользовательские файлы [workflow](/docs/ru/workflows) скриптов или каталоги (заменяет значение по умолчанию `workflows/`) | `"./custom/workflows/"` |602| `workflows` | string\|array | Пользовательские файлы скриптов [workflow](/docs/ru/workflows) или каталоги (заменяет `workflows/` по умолчанию) | `"./custom/workflows/"` |

592| `hooks` | string\|array\|object | Пути конфигурации hooks или встроенная конфигурация | `"./my-extra-hooks.json"` |603| `hooks` | string\|array\|object | Пути конфигурации hooks или встроенная конфигурация | `"./my-extra-hooks.json"` |

593| `mcpServers` | string\|array\|object | Пути конфигурации MCP или встроенная конфигурация | `"./my-extra-mcp-config.json"` |604| `mcpServers` | string\|array\|object | Пути конфигурации MCP или встроенная конфигурация | `"./my-extra-mcp-config.json"` |

594| `outputStyles` | string\|array | Пользовательские файлы стилей вывода/каталоги (заменяет значение по умолчанию `output-styles/`) | `"./styles/"` |605| `outputStyles` | string\|array | Пользовательские файлы стилей вывода/каталоги (заменяет `output-styles/` по умолчанию) | `"./styles/"` |

595| `lspServers` | string\|array\|object | Конфигурации [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) для интеллекта кода (перейти к определению, найти ссылки и т. д.) | `"./.lsp.json"` |606| `lspServers` | string\|array\|object | Конфигурации [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) для интеллекта кода (перейти к определению, найти ссылки и т. д.) | `"./.lsp.json"` |

596| `experimental.themes` | string\|array | Файлы цветовых тем/каталоги (заменяет значение по умолчанию `themes/`). См. [Темы](#themes) | `"./themes/"` |607| `experimental.themes` | string\|array | Файлы цветовой темы/каталоги (заменяет `themes/` по умолчанию). См. [Темы](#themes) | `"./themes/"` |

597| `experimental.monitors` | string\|array | Конфигурации фонового [Monitor](/docs/ru/tools-reference#monitor-tool), которые запускаются автоматически при активном плагине. См. [Мониторы](#monitors) | `"./monitors.json"` |608| `experimental.monitors` | string\|array | Конфигурации фонового [Monitor](/docs/ru/tools-reference#monitor-tool), которые запускаются автоматически, когда plugin активен. См. [Мониторы](#monitors) | `"./monitors.json"` |

598| `experimental.evals` | string\|array | Каталог ниже корня плагина, который содержит [тестовые случаи eval](/docs/ru/plugin-evals#use-a-different-eval-directory) плагина, когда это не каталог по умолчанию `evals/`. `claude plugin eval --eval-dir` переопределяет его | `"quality/evals"` |609| `experimental.evals` | string\|array | Каталог ниже корня plugin, который содержит [случаи eval](/docs/ru/plugin-evals#use-a-different-eval-directory) plugin, когда это не `evals/` по умолчанию. `claude plugin eval --eval-dir` переопределяет его | `"quality/evals"` |

599| `userConfig` | object | Значения, настраиваемые пользователем, запрашиваемые при включении. См. [Конфигурация пользователя](#user-configuration) | |610| `userConfig` | object | Значения, настраиваемые пользователем, запрашиваемые при включении. См. [Конфигурация пользователя](#user-configuration) | |

600| `channels` | array | Объявления каналов для внедрения сообщений (стиль Telegram, Slack, Discord). См. [Каналы](#channels) | |611| `channels` | array | Объявления каналов для внедрения сообщений (стиль Telegram, Slack, Discord). См. [Каналы](#channels) | |

601| `dependencies` | array | Другие плагины, которые требует этот плагин, опционально с ограничениями версии semver. См. [Ограничение версий зависимостей плагина](/docs/ru/plugin-dependencies) | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |612| `dependencies` | array | Другие plugin, которые требует этот plugin, опционально с ограничениями версии semver. См. [Ограничение версий зависимостей plugin](/docs/ru/plugin-dependencies) | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |

602 613 

603<h3 id="experimental-components">614<h3 id="experimental-components">

604 Экспериментальные компоненты615 Экспериментальные компоненты

610 Конфигурация пользователя621 Конфигурация пользователя

611</h3>622</h3>

612 623 

613Поле `userConfig` объявляет значения, которые Claude Code запрашивает у пользователя при включении плагина. Используйте это вместо требования пользователям вручную редактировать `settings.json`.624Поле `userConfig` объявляет значения, которые Claude Code запрашивает у пользователя при включении plugin. Используйте это вместо требования пользователям вручную редактировать `settings.json`.

614 625 

615```json theme={null}626```json theme={null}

616{627{

633Ключи должны быть допустимыми идентификаторами. Каждый параметр поддерживает эти поля:644Ключи должны быть допустимыми идентификаторами. Каждый параметр поддерживает эти поля:

634 645 

635| Поле | Обязательно | Описание |646| Поле | Обязательно | Описание |

636| :------------ | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |647| :------------ | :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

637| `type` | Да | Одно из `string`, `number`, `boolean`, `directory` или `file` |648| `type` | Да | Один из `string`, `number`, `boolean`, `directory` или `file` |

638| `title` | Да | Метка, отображаемая в диалоговом окне конфигурации |649| `title` | Да | Метка, отображаемая в диалоговом окне конфигурации |

639| `description` | Да | Справочный текст, отображаемый под полем |650| `description` | Да | Справочный текст, отображаемый под полем |

640| `sensitive` | Нет | Если `true`, скрывает ввод и сохраняет значение в защищённом хранилище вместо `settings.json` |651| `sensitive` | Нет | Если `true`, скрывает ввод и сохраняет значение в защищённом хранилище вместо `settings.json` |

641| `required` | Нет | Если `true`, валидация не пройдёт, когда поле пусто |652| `required` | Нет | Если `true`, валидация не пройдёт, когда поле пусто |

642| `default` | Нет | Значение, используемое, когда пользователь ничего не предоставляет |653| `default` | Нет | Значение, используемое, когда пользователь ничего не предоставляет |

643| `options` | Нет | Для типа `string`, значения, которые принимает поле, отображаемые в `/config` как средство выбора над ними. Требует Claude Code v2.1.271 или позже |654| `options` | Нет | Для типа `string`, значения, которые принимает поле, отображаемые в `/config` как средство выбора над ними. См. [Ограничение поля фиксированными параметрами](#limit-a-field-to-fixed-options). Требуется Claude Code v2.1.271 или позже |

644| `multiple` | Нет | Для типа `string`, разрешить массив строк |655| `multiple` | Нет | Для типа `string`, разрешить массив строк |

645| `min` / `max` | Нет | Границы для типа `number` |656| `min` / `max` | Нет | Границы для типа `number` |

646 657 

647За исключением полей `sensitive` и списков `multiple`, каждое поле каждого включённого плагина также отображается как строка на панели `/config`. Строки требуют Claude Code v2.1.269 или позже.658За исключением полей `sensitive` и списков `multiple`, каждое поле каждого включённого plugin также отображается как строка на панели `/config`. Строки требуют Claude Code v2.1.269 или позже.

648 659 

649Каждое значение доступно для подстановки как `${user_config.KEY}` в конфигурациях MCP и LSP серверов и командах hooks. Нечувствительные значения также могут быть подставлены в содержимое skills и agents. Все значения экспортируются в процессы hooks как переменные окружения `CLAUDE_PLUGIN_OPTION_<KEY>`, где `<KEY>` — это ключ параметра в верхнем регистре.660Каждое значение доступно для подстановки как `${user_config.KEY}` в конфигурациях MCP и LSP серверов и команды hooks. Нечувствительные значения также могут быть подставлены в содержимое skill и agent. Все значения экспортируются в процессы hook как переменные окружения `CLAUDE_PLUGIN_OPTION_<KEY>`, где `<KEY>` — это ключ параметра в верхнем регистре.

650 661 

651Поля, которые работают в оболочке, отклоняют `${user_config.*}`: подстановка настроенного значения в команду оболочки позволила бы оболочке запустить всё, что содержит это значение, поэтому компонент не работает с [ошибкой](/docs/ru/errors#plugin-command-references-user-config). Каждое отклонённое поле имеет альтернативный способ передачи значения:662Поля, которые работают в shell, отклоняют `${user_config.*}`: подстановка настроенного значения в команду shell позволит shell запустить всё, что содержит это значение, поэтому компонент не работает с [ошибкой](/docs/ru/errors#plugin-command-references-user-config). Каждое отклонённое поле имеет альтернативный способ передачи значения:

652 663 

653| Отклонённое поле | Как передать значение |664| Отклонённое поле | Как передать значение |

654| :--------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- |665| :--------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |

655| Команды hooks в форме оболочки | Используйте [форму exec](/docs/ru/hooks#exec-form-and-shell-form) с `args` или прочитайте `CLAUDE_PLUGIN_OPTION_<KEY>` из окружения hooks |666| Команды hooks в форме shell | Используйте [форму exec](/docs/ru/hooks#exec-form-and-shell-form) с `args` или прочитайте `CLAUDE_PLUGIN_OPTION_<KEY>` из окружения hook |

656| Команды [Monitor](#monitors) | Прочитайте значение из файла конфигурации в скрипте |667| Команды [Monitor](#monitors) | Прочитайте значение из файла конфигурации в скрипте |

657| MCP [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication) | Прочитайте значение из файла конфигурации в скрипте |668| MCP [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication) | Прочитайте значение из файла конфигурации в скрипте |

658 669 

659До версии 2.1.207 эти поля подставляли значения `${user_config.KEY}`; обновите плагины, которые полагались на это.670До v2.1.207 эти поля подставляли значения `${user_config.KEY}`; обновите plugin, которые полагались на это.

660 671 

661Нечувствительные значения хранятся под ключом [`pluginConfigs`](/docs/ru/settings-reference#pluginconfigs) в вашем пользовательском `settings.json` как `pluginConfigs[<plugin-id>].options`.672Нечувствительные значения хранятся под ключом [`pluginConfigs`](/docs/ru/settings-reference#pluginconfigs) в вашем пользовательском `settings.json` как `pluginConfigs[<plugin-id>].options`.

662 673 

663На macOS Claude Code хранит чувствительные значения в macOS Keychain, переходя на `~/.claude/.credentials.json`, когда Keychain отклоняет запись. На платформах без поддерживаемого keychain он хранит их в `~/.claude/.credentials.json`. Хранилище Keychain совместно используется с токенами OAuth и имеет приблизительный общий лимит в 2 КБ, поэтому держите чувствительные значения небольшими.674На macOS Claude Code хранит чувствительные значения в macOS Keychain, переходя на `~/.claude/.credentials.json`, когда Keychain отклоняет запись. На платформах без поддерживаемого keychain он хранит их в `~/.claude/.credentials.json`. Хранилище Keychain используется совместно с токенами OAuth и имеет приблизительный общий лимит в 2 КБ, поэтому держите чувствительные значения небольшими.

664 675 

665Claude Code читает все значения `pluginConfigs` только из трёх источников параметров:676Claude Code читает все значения `pluginConfigs` только из трёх источников параметров:

666 677 

667* **Параметры пользователя**: `~/.claude/settings.json`, файл, в который записывает приглашение во время включения678* **Параметры пользователя**: `~/.claude/settings.json`, файл, в который записывает подсказка во время включения

668* **`--settings`**: флаг CLI или встроенные параметры SDK679* **`--settings`**: флаг CLI или встроенные параметры SDK

669* **Управляемые параметры**: [контролируемая организацией политика](/docs/ru/permissions#managed-settings)680* **Управляемые параметры**: [политика, контролируемая организацией](/docs/ru/permissions#managed-settings)

670 681 

671Когда более одного источника устанавливает один и тот же ключ, управляемые параметры имеют приоритет, затем `--settings`, затем параметры пользователя. Единственный источник, который вы можете удалить из этого списка, — это параметры пользователя: передайте [`--setting-sources`](/docs/ru/cli-reference#cli-flags) без `user`, и Claude Code пропустит их. Управляемые параметры и `--settings` остаются тем, что вы передали. Опция [`settingSources`](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) SDK устанавливает тот же список.682Когда более одного источника устанавливает один и тот же ключ, управляемые параметры имеют приоритет, затем `--settings`, затем параметры пользователя. Единственный источник, который вы можете удалить из этого списка, — это параметры пользователя: передайте [`--setting-sources`](/docs/ru/cli-reference#cli-flags) без `user`, и Claude Code пропустит их. Управляемые параметры и `--settings` остаются тем, что вы передали. Опция [`settingSources`](/docs/ru/agent-sdk/claude-code-features#what-settingsources-does-not-control) SDK устанавливает тот же список.

672 683 

673Записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются. Оба файла находятся в рабочей области, поэтому клонированный репозиторий может предоставить значения там, и эти значения будут поступать в команды hooks плагина, конфигурации MCP серверов, команды LSP и команды мониторов. До версии 2.1.207 эти записи читались. Ограничение специфично для `pluginConfigs`: [`enabledPlugins`](/docs/ru/settings-reference#enabledplugins) по-прежнему учитывает параметры проекта и локальные параметры.684Записи в `.claude/settings.json` или `.claude/settings.local.json` проекта игнорируются. Оба файла находятся в рабочей области, поэтому клонированный репозиторий может предоставить значения там, и эти значения будут поступать в команды hook plugin, конфигурации MCP сервера, команды LSP и команды monitor. До v2.1.207 эти записи читались. Ограничение специфично для `pluginConfigs`: [`enabledPlugins`](/docs/ru/settings-reference#enabledplugins) по-прежнему учитывает параметры проекта и локальные параметры.

685 

686<h4 id="limit-a-field-to-fixed-options">

687 Ограничение поля фиксированными параметрами

688</h4>

689 

690Установите `options` на поле `userConfig`, чтобы пользователи выбирали его значение из фиксированного списка.

691 

692Чтобы ограничить поле `tone` тремя параметрами, перечислите их в `options` и установите `default` на один из них:

693 

694```json theme={null}

695{

696 "userConfig": {

697 "tone": {

698 "type": "string",

699 "title": "Tone",

700 "description": "Voice for generated replies",

701 "options": ["neutral", "warm", "formal"],

702 "default": "neutral"

703 }

704 }

705}

706```

707 

708Если вы объявляете `options` на любом поле, пользователи на версиях Claude Code до v2.1.271 не смогут загрузить plugin.

709 

710Когда вы устанавливаете `options` на поле, следуйте этим правилам:

711 

712* Установите `type` на `string`

713* Не устанавливайте `multiple` или `sensitive` на `true`

714* Установите `default` на один из параметров

715* Если вы оставляете `default` неустановленным, установите `required` на `true`

716* Перечислите по крайней мере один параметр, каждый от 1 до 64 символов в длину

717* Не начинайте и не заканчивайте параметр пробелом

718* Не используйте управляющие символы, невидимые символы, символы, которые изменяют направление текста, или пробелы, отличные от обычного пробела в параметре

719* Не перечисляйте один и тот же параметр дважды, даже в другом регистре букв

720 

721Если вы нарушите любое из этих правил, plugin не загрузится. Запустите `claude plugin validate`, чтобы увидеть, какое поле нарушает какое правило.

674 722 

675<h3 id="channels">723<h3 id="channels">

676 Каналы724 Каналы

677</h3>725</h3>

678 726 

679Поле `channels` позволяет плагину объявить один или несколько каналов сообщений, которые внедряют содержимое в разговор. Каждый канал привязывается к MCP серверу, который предоставляет плагин.727Поле `channels` позволяет plugin объявить один или несколько каналов сообщений, которые внедряют содержимое в разговор. Каждый канал привязывается к MCP серверу, который предоставляет plugin.

680 728 

681```json theme={null}729```json theme={null}

682{730{

701}749}

702```750```

703 751 

704Поле `server` обязательно и должно совпадать с ключом в `mcpServers` плагина. Необязательный `userConfig` для каждого канала использует ту же схему, что и поле верхнего уровня, позволяя плагину запрашивать токены ботов или идентификаторы владельцев при включении плагина.752Поле `server` обязательно и должно совпадать с ключом в `mcpServers` plugin. Необязательный `userConfig` для каждого канала использует ту же схему, что и поле верхнего уровня, позволяя plugin запрашивать токены бота или ID владельца при включении plugin.

705 753 

706<h3 id="path-behavior-rules">754<h3 id="path-behavior-rules">

707 Правила поведения пути755 Правила поведения пути

708</h3>756</h3>

709 757 

710Заменяет ли пользовательский путь или расширяет каталог по умолчанию плагина, зависит от поля:758Заменяет ли пользовательский путь или расширяет каталог plugin по умолчанию, зависит от поля:

711 759 

712* **Заменяет значение по умолчанию**: `commands`, `agents`, `workflows`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Например, когда манифест указывает `commands`, каталог `commands/` по умолчанию не сканируется. Чтобы сохранить значение по умолчанию и добавить больше, перечислите его явно: `"commands": ["./commands/", "./extras/"]`760* **Заменяет значение по умолчанию**: `commands`, `agents`, `workflows`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Например, когда манифест указывает `commands`, каталог `commands/` по умолчанию не сканируется. Чтобы сохранить значение по умолчанию и добавить больше, перечислите его явно: `"commands": ["./commands/", "./extras/"]`

713* **Добавляет к значению по умолчанию**: `skills`. Каталог `skills/` по умолчанию всегда сканируется, и каталоги, указанные в `skills`, загружаются вместе с ним. Исключение: для [записи маркетплейса, чей `source` разрешается в корень маркетплейса](/docs/ru/plugin-marketplaces#advanced-plugin-entries), объявление определённых подкаталогов заменяет сканирование `skills/` по умолчанию761* **Добавляет к значению по умолчанию**: `skills`. Каталог `skills/` по умолчанию всегда сканируется, и каталоги, перечисленные в `skills`, загружаются вместе с ним. Исключение: для [записи marketplace, чей `source` разрешается в корень marketplace](/docs/ru/plugin-marketplaces#advanced-plugin-entries), объявление определённых подкаталогов заменяет сканирование `skills/` по умолчанию

714* **Собственные правила слияния**: [hooks](#hooks), [MCP серверы](#mcp-servers) и [LSP серверы](#lsp-servers). См. каждый раздел для того, как несколько источников объединяются762* **Собственные правила слияния**: [hooks](#hooks), [MCP серверы](#mcp-servers) и [LSP серверы](#lsp-servers). См. каждый раздел для того, как несколько источников объединяются

715 763 

716Когда плагин имеет как папку по умолчанию, так и соответствующий ключ манифеста, Claude Code предупреждает об игнорируемой папке в `claude plugin list` и в представлении деталей `/plugin`. Плагин всё равно загружается с использованием путей манифеста. Claude Code не предупреждает, когда ключ манифеста указывает на папку по умолчанию, например `"commands": ["./commands/deploy.md"]`, потому что этот путь явно называет папку.764Когда plugin имеет как папку по умолчанию, так и соответствующий ключ манифеста, Claude Code предупреждает об игнорируемой папке в `claude plugin list` и в представлении деталей `/plugin`. Plugin всё равно загружается с использованием путей манифеста. Claude Code не предупреждает, когда ключ манифеста указывает в папку по умолчанию, например `"commands": ["./commands/deploy.md"]`, потому что этот путь явно называет папку.

717 765 

718Для всех полей пути:766Для всех полей пути:

719 767 

720* Все пути должны быть относительны к корню плагина и начинаться с `./`, за исключением того, что поле `skills` также принимает `"."`768* Все пути должны быть относительны к корню plugin и начинаться с `./`, за исключением того, что поле `skills` также принимает `"."`

721 * Оба `"."` и `"./"` обозначают сам корень плагина769 * Оба `"."` и `"./"` обозначают сам корень plugin

722 * До версии 2.1.221 `"."` не прошёл валидацию манифеста и плагин не загружался, поэтому используйте `"./"` для поддержки более ранних версий770 * До v2.1.221 `"."` не прошёл валидацию манифеста и plugin не загрузился, поэтому используйте `"./"` для поддержки более ранних версий

723* Компоненты из пользовательских путей используют те же правила именования и пространства имён771* Компоненты из пользовательских путей используют те же правила именования и пространства имён, за исключением файлов agent. См. [Agents](#agents) для того, как работают имена agent

724* Несколько путей можно указать как массивы772* Несколько путей можно указать как массивы

725* Путь skill может указывать на каталог, который содержит `SKILL.md` непосредственно, например `"skills": ["."]` для корня плагина773* Путь skill может указывать на каталог, который содержит `SKILL.md` непосредственно, например `"skills": ["."]` для корня plugin

726 * Claude Code берёт имя вызова skill из поля frontmatter `name` в `SKILL.md`, поэтому имя остаётся стабильным независимо от того, как называется каталог установки774 * Claude Code берёт имя вызова skill из поля frontmatter `name` в `SKILL.md`, поэтому имя остаётся стабильным, независимо от того, как называется каталог установки

727 * Если `name` не установлено в frontmatter, Claude Code переходит на имя каталога по умолчанию775 * Если `name` не установлен в frontmatter, Claude Code переходит на имя базового каталога

728 776 

729Плагин, который имеет `SKILL.md` в своём корне, не имеет подкаталога `skills/` и не имеет поля манифеста `skills`, автоматически загружается как плагин с одним skill. Вам не нужно устанавливать `"skills": ["./"]` в `plugin.json` для этого макета.777Plugin, который имеет `SKILL.md` в своём корне, не имеет подкаталога `skills/` и не имеет поля манифеста `skills`, автоматически загружается как plugin с одним skill. Вам не нужно устанавливать `"skills": ["./"]` в `plugin.json` для этого макета.

730 778 

731**Примеры путей**:779**Примеры пути**:

732 780 

733```json theme={null}781```json theme={null}

734{782{

750Claude Code предоставляет три переменные для ссылки на пути:798Claude Code предоставляет три переменные для ссылки на пути:

751 799 

752| Переменная | Разрешается в | Используйте для |800| Переменная | Разрешается в | Используйте для |

753| :---------------------- | :------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |801| :---------------------- | :------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------- |

754| `${CLAUDE_PLUGIN_ROOT}` | Абсолютный путь к каталогу установки плагина | Скрипты, двоичные файлы и файлы конфигурации, поставляемые с плагином |802| `${CLAUDE_PLUGIN_ROOT}` | Абсолютный путь к каталогу установки plugin | Скрипты, двоичные файлы и файлы конфигурации, поставляемые с plugin |

755| `${CLAUDE_PLUGIN_DATA}` | [Постоянный каталог](#persistent-data-directory), который сохраняется при обновлениях плагина, создаётся при первой ссылке | Установленные зависимости, такие как `node_modules` или виртуальные окружения Python, сгенерированный код и кэши |803| `${CLAUDE_PLUGIN_DATA}` | [Постоянный каталог](#persistent-data-directory), который сохраняется при обновлениях plugin, создаётся при первой ссылке | Установленные зависимости, такие как `node_modules` или виртуальные окружения Python, сгенерированный код и кэши |

756| `${CLAUDE_PROJECT_DIR}` | Корень проекта | Локальные скрипты и файлы конфигурации проекта |804| `${CLAUDE_PROJECT_DIR}` | Корень проекта | Локальные скрипты и файлы конфигурации проекта |

757 805 

758Все три экспортируются как переменные окружения в процессы hooks и в подпроцессы MCP и LSP серверов. Они не присутствуют в окружении команд, которые Claude запускает через инструмент Bash, в основном сеансе или в подагенте. В содержимом плагина напишите заполнитель вместо этого, и Claude Code подставит путь встроенно при загрузке содержимого. Какие поля подставляют их встроенно, зависит от компонента плагина:806Все три экспортируются как переменные окружения в процессы hook и в подпроцессы MCP и LSP серверов. Они отсутствуют в окружении команд, которые Claude запускает через инструмент Bash, в основной сессии или в подагенте. В содержимом plugin напишите заполнитель вместо этого, и Claude Code подставит путь встроенно при загрузке содержимого. Какие поля подставляют их встроенно, зависит от компонента plugin:

759 807 

760| Компонент плагина | Поля, где разрешаются заполнители |808| Компонент plugin | Поля, где заполнители разрешаются |

761| :------------------------------ | :------------------------------------------ |809| :------------------------------ | :------------------------------------------ |

762| Содержимое skill и agent | Везде, где появляется заполнитель |810| Содержимое skill и agent | Везде, где появляется заполнитель |

763| Команды hook и monitor | Везде, где появляется заполнитель |811| Команды hook и monitor | Везде, где появляется заполнитель |

765| MCP `http`, `sse`, `ws` серверы | `url`, `headers`, `headersHelper` |813| MCP `http`, `sse`, `ws` серверы | `url`, `headers`, `headersHelper` |

766| LSP серверы | `command`, `args`, `env`, `workspaceFolder` |814| LSP серверы | `command`, `args`, `env`, `workspaceFolder` |

767 815 

768В командах hooks используйте [форму exec](/docs/ru/hooks#exec-form-and-shell-form) с `args`, чтобы каждый путь передавался как один аргумент без кавычек. В hooks в форме оболочки и командах мониторов оберните переменные в двойные кавычки, как в `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. Этот hook в форме оболочки запускает скрипт, поставляемый с плагином:816В командах hook используйте [форму exec](/docs/ru/hooks#exec-form-and-shell-form) с `args`, чтобы каждый путь передавался как один аргумент без кавычек. В hooks в форме shell и командах monitor оберните переменные в двойные кавычки, как в `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. Этот hook в форме shell запускает скрипт, поставляемый с plugin:

769 817 

770```json theme={null}818```json theme={null}

771{819{

784}832}

785```833```

786 834 

787`${CLAUDE_PLUGIN_ROOT}` изменяется при обновлении плагина. Каталог предыдущей версии остаётся на диске в течение периода благодати после обновления, но рассматривайте его как эфемерный и не записывайте состояние туда. См. [кэширование плагина](#plugin-caching-and-file-resolution) для того, какие плагины копируются и для семантики очистки.835Для скопированного plugin `${CLAUDE_PLUGIN_ROOT}` изменяется при обновлении plugin. Каталог предыдущей версии остаётся на диске в течение периода благодати после обновления, но рассматривайте его как эфемерный и не записывайте состояние туда. Для plugin, загруженного на месте из marketplace локального каталога, переменная указывает на стабильный исходный каталог. См. [кэширование plugin](#plugin-caching-and-file-resolution) для того, какие plugin копируются и для семантики очистки.

788 836 

789Когда плагин обновляется в середине сеанса, команды hooks, мониторы, MCP серверы и LSP серверы продолжают использовать путь предыдущей версии. Запустите `/reload-plugins`, чтобы переключить hooks, MCP серверы и LSP серверы на новый путь; мониторы требуют перезагрузки сеанса. В сеансе без интерактивного терминала перезагрузка оставляет MCP серверы плагина на старом пути до следующего сеанса.837Когда скопированный plugin обновляется в середине сессии, команды hook, мониторы, MCP серверы и LSP серверы продолжают использовать путь предыдущей версии. Запустите `/reload-plugins`, чтобы переключить hooks, MCP серверы и LSP серверы на новый путь; мониторы требуют перезагрузки сессии. В сессии без интерактивного терминала перезагрузка оставляет MCP серверы plugin на старом пути до следующей сессии.

790 838 

791Для плагина с источником `command` Claude Code [может перезагрузить сам плагин](/docs/ru/plugin-marketplaces#when-claude-code-re-runs-the-command).839Для plugin с источником `command`, Claude Code [может перезагрузить сам plugin](/docs/ru/plugin-marketplaces#when-claude-code-re-runs-the-command).

792 840 

793MCP серверы также могут вызвать запрос `roots/list` для чтения рабочих каталогов сеанса во время выполнения. См. [что возвращает `roots/list` и когда Claude Code уведомляет сервер об изменениях](/docs/ru/mcp#option-3-add-a-local-stdio-server).841MCP серверы также могут вызвать запрос `roots/list` для чтения рабочих каталогов сессии во время выполнения. См. [что возвращает `roots/list` и когда Claude Code уведомляет сервер об изменениях](/docs/ru/mcp#option-3-add-a-local-stdio-server).

794 842 

795<h4 id="persistent-data-directory">843<h4 id="persistent-data-directory">

796 Постоянный каталог данных844 Постоянный каталог данных

797</h4>845</h4>

798 846 

799Каталог `${CLAUDE_PLUGIN_DATA}` разрешается в `~/.claude/plugins/data/{id}/`, где `{id}` — это идентификатор плагина с символами вне `a-z`, `A-Z`, `0-9`, `_` и `-`, заменённые на `-`. Для плагина, установленного как `formatter@my-marketplace`, каталог — это `~/.claude/plugins/data/formatter-my-marketplace/`.847Каталог `${CLAUDE_PLUGIN_DATA}` разрешается в `~/.claude/plugins/data/{id}/`, где `{id}` — это идентификатор plugin с символами вне `a-z`, `A-Z`, `0-9`, `_` и `-`, заменённые на `-`. Для plugin, установленного как `formatter@my-marketplace`, каталог — это `~/.claude/plugins/data/formatter-my-marketplace/`.

800 848 

801Обычное использование — установка зависимостей языка один раз и их повторное использование в сеансах и обновлениях плагина. Используйте его для зависимостей Python, зависимостей, заблокированных с помощью Yarn или pnpm, и пакетов, чьи скрипты жизненного цикла должны работать. Для плагина, установленного с маркетплейса, вам может вообще не понадобиться: Claude Code автоматически устанавливает подходящие [зависимости пакета Node.js](#node-js-package-dependencies) при кэшировании плагина.849Обычное использование — установка зависимостей языка один раз и их повторное использование в сессиях и обновлениях plugin. Используйте его для зависимостей Python, зависимостей, заблокированных с помощью Yarn или pnpm, и пакетов, чьи скрипты жизненного цикла должны работать. Для plugin, установленного из marketplace, вам может вообще не понадобиться: Claude Code автоматически устанавливает подходящие [зависимости пакета Node.js](#node-js-package-dependencies) при кэшировании plugin.

802 850 

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

804 852 

805Этот hook `SessionStart` устанавливает `node_modules` при первом запуске и снова всякий раз, когда обновление плагина включает изменённый `package.json`:853Этот hook `SessionStart` устанавливает `node_modules` при первом запуске и снова, когда обновление plugin включает изменённый `package.json`:

806 854 

807```json theme={null}855```json theme={null}

808{856{

821}869}

822```870```

823 871 

824`diff` выходит с ненулевым кодом, когда сохранённая копия отсутствует или отличается от поставляемой, охватывая как первый запуск, так и обновления, изменяющие зависимости. Если `npm install` не удаётся, завершающий `rm` удаляет скопированный манифест, чтобы следующий сеанс повторил попытку.872`diff` выходит с ненулевым кодом, когда сохранённая копия отсутствует или отличается от поставляемой, охватывая как первый запуск, так и обновления, изменяющие зависимости. Если `npm install` не удаётся, завершающий `rm` удаляет скопированный манифест, чтобы следующая сессия повторила попытку.

825 873 

826Скрипты, поставляемые в `${CLAUDE_PLUGIN_ROOT}`, затем могут работать с сохранённым `node_modules`:874Скрипты, поставляемые в `${CLAUDE_PLUGIN_ROOT}`, затем могут работать с сохранённым `node_modules`:

827 875 

839}887}

840```888```

841 889 

842Каталог данных удаляется автоматически при удалении плагина из последней области, где он установлен. Интерфейс `/plugin` показывает размер каталога и запрашивает перед удалением. CLI удаляет по умолчанию; передайте [`--keep-data`](#plugin-uninstall), чтобы сохранить его.890Каталог данных удаляется автоматически при удалении plugin из последней области, где он установлен. Интерфейс `/plugin` показывает размер каталога и запрашивает перед удалением. CLI удаляет по умолчанию; передайте [`--keep-data`](#plugin-uninstall), чтобы сохранить его.

843 891 

844***892***

845 893 

959├── agents/ # Определения подагентов1007├── agents/ # Определения подагентов

960│ ├── security-reviewer.md1008│ ├── security-reviewer.md

961│ ├── performance-tester.md1009│ ├── performance-tester.md

962│ └── compliance-checker.md1010│ ├── compliance-checker.md

1011│ └── review/ # Агенты здесь загружаются как enterprise-plugin:review:<name>

1012│ └── accessibility.md

963├── workflows/ # Скрипты рабочих процессов1013├── workflows/ # Скрипты рабочих процессов

964│ └── release-audit.js1014│ └── release-audit.js

965├── output-styles/ # Определения стилей вывода1015├── output-styles/ # Определения стилей вывода

999| **Манифест** | `.claude-plugin/plugin.json` | Метаданные и конфигурация плагина (опционально) |1049| **Манифест** | `.claude-plugin/plugin.json` | Метаданные и конфигурация плагина (опционально) |

1000| **Skills** | `skills/` | Skills со структурой `<name>/SKILL.md` |1050| **Skills** | `skills/` | Skills со структурой `<name>/SKILL.md` |

1001| **Команды** | `commands/` | Skills как плоские файлы Markdown. Используйте `skills/` для новых плагинов |1051| **Команды** | `commands/` | Skills как плоские файлы Markdown. Используйте `skills/` для новых плагинов |

1002| **Агенты** | `agents/` | Файлы Markdown подагентов |1052| **Агенты** | `agents/` | Файлы Markdown подагентов. Подпапки являются частью [имени агента](#agents) |

1003| **Рабочие процессы** | `workflows/` | Файлы скриптов [Workflow](/docs/ru/workflows) |1053| **Рабочие процессы** | `workflows/` | Файлы скриптов [Workflow](/docs/ru/workflows) |

1004| **Стили вывода** | `output-styles/` | Определения стилей вывода |1054| **Стили вывода** | `output-styles/` | Определения стилей вывода |

1005| **Темы** | `themes/` | Определения цветовых тем |1055| **Темы** | `themes/` | Определения цветовых тем |

Details

96 96 

97Параметр модели [`opusplan`](/docs/ru/model-config#opusplan-model-setting) разрешается в Opus во время режима плана и Sonnet во время выполнения, поэтому каждое переключение режима плана является переключением модели и запускает свежий кэш.97Параметр модели [`opusplan`](/docs/ru/model-config#opusplan-model-setting) разрешается в Opus во время режима плана и Sonnet во время выполнения, поэтому каждое переключение режима плана является переключением модели и запускает свежий кэш.

98 98 

99[Automatic model fallback](/docs/ru/model-config#automatic-model-fallback) на моделях Fable и Opus 5 также является переключением модели. Когда классификатор безопасности помечает запрос в категории, которая имеет резервную модель, Claude Code повторно запускает запрос на этой модели и сеанс продолжается там.99[Automatic model fallback](/docs/ru/model-config#automatic-model-fallback) на моделях Fable, Opus 5.5 и Opus 5 также является переключением модели. Когда классификатор безопасности помечает запрос в категории, которая имеет резервную модель, Claude Code повторно запускает запрос на этой модели и сеанс продолжается там.

100 100 

101Когда frontmatter навыка или команды указывает [`model`](/docs/ru/skills#frontmatter-reference), отличный от текущей модели сеанса, этот ход также является переключением модели: следующий запрос читает всю историю разговора без попаданий в кэш. Модель сеанса возобновляется при вашем следующем запросе. Навык `context: fork` устанавливает [модель разветвленного подагента](/docs/ru/skills#run-skills-in-a-subagent) вместо этого.101Когда frontmatter навыка или команды указывает [`model`](/docs/ru/skills#frontmatter-reference), отличный от текущей модели сеанса, этот ход также является переключением модели: следующий запрос читает всю историю разговора без попаданий в кэш. Модель сеанса возобновляется при вашем следующем запросе. Навык `context: fork` устанавливает [модель разветвленного подагента](/docs/ru/skills#run-skills-in-a-subagent) вместо этого.

102 102 

Details

1384* [Как команды Anthropic используют Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code): реальные рабочие процессы из команд инженерии, продукта, дизайна и данных, с глубокими погружениями в [legal](https://claude.com/blog/how-anthropic-uses-claude-legal), [marketing](https://claude.com/blog/how-anthropic-uses-claude-marketing) и [cybersecurity](https://claude.com/blog/how-anthropic-uses-claude-cybersecurity)1384* [Как команды Anthropic используют Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code): реальные рабочие процессы из команд инженерии, продукта, дизайна и данных, с глубокими погружениями в [legal](https://claude.com/blog/how-anthropic-uses-claude-legal), [marketing](https://claude.com/blog/how-anthropic-uses-claude-marketing) и [cybersecurity](https://claude.com/blog/how-anthropic-uses-claude-cybersecurity)

1385* [Руководство по масштабированию агентного кодирования](https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf): руководство по внедрению на уровне предприятия1385* [Руководство по масштабированию агентного кодирования](https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf): руководство по внедрению на уровне предприятия

1386 1386 

1387Для видеопрохождений этих паттернов, см. бесплатный курс [Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action) на Anthropic Academy.1387Для видеопрохождений этих паттернов, см. бесплатный курс [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action) на [Claude Academy](https://academy.claude.com/).

1388 1388 

1389<h2 id="related-resources">1389<h2 id="related-resources">

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

quickstart.md +2 −1

Details

377 Получение помощи377 Получение помощи

378</h2>378</h2>

379 379 

380* **В Claude Code**: Введите `/help` или спросите "how do I..."380* **В Claude Code**: Введите `/help` или спросите "how do I" вопрос

381* **Документация**: Вы здесь! Просмотрите другие руководства381* **Документация**: Вы здесь! Просмотрите другие руководства

382* **Курсы**: Пройдите [Claude Code 101](https://academy.claude.com/courses/claude-code-101) и другие бесплатные самостоятельные курсы на [Claude Academy](https://academy.claude.com/)

382* **Сообщество**: Присоединитесь к нашему [Discord](https://www.anthropic.com/discord) для советов и поддержки383* **Сообщество**: Присоединитесь к нашему [Discord](https://www.anthropic.com/discord) для советов и поддержки

Details

187* **Извлечение сеанса с помощью `/teleport`**: когда вы извлекаете [сеанс Claude Code в веб-версии](/docs/ru/claude-code-on-the-web#from-cloud-to-terminal) в свой терминал с помощью `/teleport`, подключённое устройство не получает более раннюю историю извлечённой беседы. Новые сообщения в обе стороны идут в извлечённую беседу, которая теперь открыта в вашем терминале.187* **Извлечение сеанса с помощью `/teleport`**: когда вы извлекаете [сеанс Claude Code в веб-версии](/docs/ru/claude-code-on-the-web#from-cloud-to-terminal) в свой терминал с помощью `/teleport`, подключённое устройство не получает более раннюю историю извлечённой беседы. Новые сообщения в обе стороны идут в извлечённую беседу, которая теперь открыта в вашем терминале.

188* **Сообщения из ваших других сеансов**: с [кросс-сеансовой передачей сообщений](/docs/ru/cross-session-messaging) одно и то же соединение переносит сообщения между вашими собственными сеансами на разных машинах и из ваших [сеансов Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), через серверы Anthropic, как и остальной трафик Remote Control. [Отправка сообщений в сеансы на других машинах](/docs/ru/cross-session-messaging#message-sessions-on-other-machines) охватывает правила доставки, а [Управление входящими сообщениями](/docs/ru/cross-session-messaging#control-inbound-messages) охватывает управление входящими. Требует Claude Code версии 2.1.224 или позже.188* **Сообщения из ваших других сеансов**: с [кросс-сеансовой передачей сообщений](/docs/ru/cross-session-messaging) одно и то же соединение переносит сообщения между вашими собственными сеансами на разных машинах и из ваших [сеансов Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), через серверы Anthropic, как и остальной трафик Remote Control. [Отправка сообщений в сеансы на других машинах](/docs/ru/cross-session-messaging#message-sessions-on-other-machines) охватывает правила доставки, а [Управление входящими сообщениями](/docs/ru/cross-session-messaging#control-inbound-messages) охватывает управление входящими. Требует Claude Code версии 2.1.224 или позже.

189* **Подсказки, которые вы отправляете в середине хода**: когда вы отправляете подсказку с подключённого устройства до завершения текущего хода, Claude Code ставит её в очередь и сохраняет её в стенограмме устройства после завершения этого хода.189* **Подсказки, которые вы отправляете в середине хода**: когда вы отправляете подсказку с подключённого устройства до завершения текущего хода, Claude Code ставит её в очередь и сохраняет её в стенограмме устройства после завершения этого хода.

190* **Diff ваших изменений**: когда каталог сеанса находится в репозитории git, панель diff подключённого устройства показывает diff ваших незафиксированных изменений. Устройство запрашивает diff по соединению, и Claude Code вычисляет его на вашем компьютере. Когда ваше рабочее дерево чистое, Claude Code вместо этого обслуживает изменения вашей ветки с момента её расхождения с ветвью по умолчанию. До версии 2.1.247 Claude Code сообщал diff подключённым устройствам только в сеансах, обслуживаемых `claude remote-control`.190* **Diff ваших изменений**: когда каталог сеанса находится в репозитории git, панель diff подключённого устройства показывает ваши изменения. Устройство запрашивает diff по соединению, и Claude Code вычисляет его на вашем компьютере. На ветке, которая имеет коммиты впереди ветви по умолчанию репозитория, панель показывает изменения с момента расхождения ветви, включая ваши незафиксированные правки. На самой ветви по умолчанию или на ветви, которая не впереди неё, панель показывает только ваши незафиксированные изменения. До версии 2.1.247 Claude Code сообщал diff подключённым устройствам только в сеансах, обслуживаемых `claude remote-control`.

191* **Модель**: когда вы выбираете [модель](/docs/ru/model-config) с подключённого устройства, Claude Code запускает сеанс на этой модели. Средство выбора `/model` терминала, `/status` и `/config` показывают эту модель. Требует Claude Code версии 2.1.238 или позже.191* **Модель**: когда вы выбираете [модель](/docs/ru/model-config) с подключённого устройства, Claude Code запускает сеанс на этой модели. Средство выбора `/model` терминала, `/status` и `/config` показывают эту модель. Требует Claude Code версии 2.1.238 или позже.

192 * Модель, которую вы выбираете из управления моделью устройства, применяется только к текущему сеансу. Когда вы отправляете `/model <name>` с устройства в интерактивный сеанс, Claude Code также устанавливает вашу стандартную модель для новых сеансов.192 * Модель, которую вы выбираете из управления моделью устройства, применяется только к текущему сеансу. Когда вы отправляете `/model <name>` с устройства в интерактивный сеанс, Claude Code также устанавливает вашу стандартную модель для новых сеансов.

193 * Если вы отправляете имя, которое Claude Code не распознаёт, например отображаемое имя, где ожидается ID модели, Claude Code [отказывает в выборе](/docs/ru/errors#model-is-not-a-recognized-model-id) и сеанс сохраняет свою текущую модель. До версии 2.1.260 Claude Code сохранял нераспознанный выбор из управления моделью устройства, и ваше следующее сообщение не удавалось.193 * Если вы отправляете имя, которое Claude Code не распознаёт, например отображаемое имя, где ожидается ID модели, Claude Code [отказывает в выборе](/docs/ru/errors#model-is-not-a-recognized-model-id) и сеанс сохраняет свою текущую модель. До версии 2.1.260 Claude Code сохранял нераспознанный выбор из управления моделью устройства, и ваше следующее сообщение не удавалось.

sandboxing.md +12 −6

Details

179 Временные каталоги179 Временные каталоги

180</h4>180</h4>

181 181 

182Каталог временных файлов сеанса доступен для записи внутри sandbox по умолчанию, наряду с рабочим каталогом. Если вы не [отключите изоляцию файловой системы](#disable-filesystem-isolation), Claude Code устанавливает `$TMPDIR` в этот каталог для изолированных команд, поэтому инструменты, которые записывают временные файлы, работают без дополнительной конфигурации. Неизолированные команды наследуют `$TMPDIR` вашей оболочки без изменений, поэтому пока изоляция файловой системы включена, изолированные и неизолированные команды разрешают `$TMPDIR` в разные каталоги. Чтобы передавать временные файлы между ними, записывайте их в рабочий каталог вместо этого.182Каталог временных файлов сеанса доступен для записи внутри sandbox по умолчанию, наряду с рабочим каталогом. Если вы не [отключите изоляцию файловой системы](#disable-filesystem-isolation), Claude Code устанавливает `$TMPDIR` в этот каталог для изолированных команд, поэтому инструменты, которые записывают временные файлы, работают без дополнительной конфигурации.

183 

184Неизолированные команды наследуют `$TMPDIR` вашей оболочки, когда она установлена, поэтому пока изоляция файловой системы включена, изолированные и неизолированные команды разрешают `$TMPDIR` в разные каталоги. Если ваша оболочка оставляет `$TMPDIR` неустановленной или пустой, неизолированная команда, которая ссылается на `$TMPDIR`, получает ваше переопределение [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) или временный каталог операционной системы, когда вы не установили его или переопределение является длинным путём, поэтому переменная не расширяется в пустую строку. Чтобы передавать временные файлы между ними, записывайте их в рабочий каталог вместо этого.

183 185 

184<h2 id="configure-sandboxing">186<h2 id="configure-sandboxing">

185 Настройка изоляции в песочнице187 Настройка изоляции в песочнице

309 311 

310* Команды в песочнице наследуют `$TMPDIR` вашей оболочки вместо временного каталога сеанса, потому что каждый временный каталог доступен для записи и Claude Code больше не перенаправляет команды в сеансовый.312* Команды в песочнице наследуют `$TMPDIR` вашей оболочки вместо временного каталога сеанса, потому что каждый временный каталог доступен для записи и Claude Code больше не перенаправляет команды в сеансовый.

311 313 

312 На Linux переменная часто не установлена в родительской оболочке, поэтому она может расширяться пусто внутри команд в песочнице; Claude Code сообщает Claude через руководство инструмента Bash создавать временные каталоги с помощью `mktemp -d` вместо полагания на `$TMPDIR`.314 На Linux переменная часто не установлена в родительской оболочке. Руководство инструмента Bash сообщает Claude создавать временные каталоги с помощью `mktemp -d` вместо полагания на `$TMPDIR`.

313* [`autoAllowBashIfSandboxed`](/docs/ru/settings-reference#sandbox-autoallowbashifsandboxed) по-прежнему по умолчанию `true`, поэтому команды в песочнице продолжают работать без подсказок. Установите его в `false`, чтобы получать подсказки для команд в песочнице.315* [`autoAllowBashIfSandboxed`](/docs/ru/settings-reference#sandbox-autoallowbashifsandboxed) по-прежнему по умолчанию `true`, поэтому команды в песочнице продолжают работать без подсказок. Установите его в `false`, чтобы получать подсказки для команд в песочнице.

314 316 

315<h3 id="protect-credentials">317<h3 id="protect-credentials">

743 745 

744* **Команды не выполняются с ошибкой host-not-allowed**: многие инструменты CLI должны достичь определённых хостов. Предоставление разрешения при запросе добавляет хост в ваш список разрешённых, поэтому инструмент выполняется внутри sandbox в будущем.746* **Команды не выполняются с ошибкой host-not-allowed**: многие инструменты CLI должны достичь определённых хостов. Предоставление разрешения при запросе добавляет хост в ваш список разрешённых, поэтому инструмент выполняется внутри sandbox в будущем.

745* **`jest` зависает или не выполняется**: `watchman` несовместим с sandbox. Вместо этого запустите `jest --no-watchman`.747* **`jest` зависает или не выполняется**: `watchman` несовместим с sandbox. Вместо этого запустите `jest --no-watchman`.

746* **Go-based CLIs не выполняют проверку TLS на macOS**: инструменты, такие как `gh`, `gcloud` и `terraform`, могут не выполнять проверку TLS под Seatbelt. Перечислите эти инструменты в `excludedCommands`, чтобы запустить их вне sandbox. Если вы используете `httpProxyPort` с MITM прокси и пользовательским CA, установите [`enableWeakerNetworkIsolation`](/docs/ru/settings-reference#sandbox-enableweakernetworkisolation) в `true` вместо этого.748* **Go-based CLIs не выполняют проверку TLS на macOS**: инструменты, такие как `gh`, `gcloud` и `terraform`, могут не выполнять проверку TLS под Seatbelt. Перечислите эти инструменты в [`excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands). Если вы используете `httpProxyPort` с MITM прокси и пользовательским CA, установите [`enableWeakerNetworkIsolation`](/docs/ru/settings-reference#sandbox-enableweakernetworkisolation) в `true` вместо этого.

747* **`open`, `osascript` или потоки аутентификации на основе браузера не выполняются с ошибкой `-600` на macOS**: sandbox по умолчанию блокирует Apple Events. Установите [`allowAppleEvents`](/docs/ru/settings-reference#sandbox-allowappleevents) в `true` в ваших пользовательских, управляемых или CLI параметрах, чтобы разрешить их. Параметры проекта игнорируются для этого ключа. Включение его удаляет изоляцию выполнения кода, так как изолированные команды могут затем запускать другие приложения без изоляции без запроса пользователя и отправлять команды AppleScript запущенным приложениям, подлежащим запросу автоматизации macOS (TCC). Кроме того, добавьте команду в `excludedCommands`, чтобы запустить её вне sandbox.749* **`open`, `osascript` или потоки аутентификации на основе браузера не выполняются с ошибкой `-600` на macOS**: sandbox по умолчанию блокирует Apple Events. Установите [`allowAppleEvents`](/docs/ru/settings-reference#sandbox-allowappleevents) в `true` в ваших пользовательских, управляемых или CLI параметрах, чтобы разрешить их. Параметры проекта игнорируются для этого ключа. Включение его удаляет изоляцию выполнения кода, так как изолированные команды могут затем запускать другие приложения без изоляции без запроса пользователя и отправлять команды AppleScript запущенным приложениям, подлежащим запросу автоматизации macOS (TCC). Кроме того, добавьте команду в [`excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands).

748* **Команды `docker` не выполняются**: `docker` несовместим с sandbox. Добавьте `docker *` в `excludedCommands`, чтобы запустить его вне sandbox.750* **Команды `docker` не выполняются**: `docker` несовместим с sandbox. Добавьте `docker *` в [`excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands).

749* **`pbcopy`, `xclip` или `wl-copy` не обновляют буфер обмена**: эти утилиты буфера обмена могут не достичь системного буфера обмена изнутри sandbox, в этом случае текст, переданный в них, не поступает. Чтобы поместить вывод Claude в ваш буфер обмена, попросите Claude напечатать его в своём ответе, затем запустите [`/copy`](/docs/ru/commands), который записывает в буфер обмена из процесса Claude Code, а не из изолированной команды. Кроме того, добавьте `pbcopy *`, `wl-copy *` или `xclip *` в `excludedCommands`, чтобы запустить команду вне sandbox.751* **`pbcopy`, `xclip` или `wl-copy` не обновляют буфер обмена**: эти утилиты буфера обмена могут не достичь системного буфера обмена изнутри sandbox, в этом случае текст, переданный в них, не поступает.

752 

753 Чтобы поместить вывод Claude в ваш буфер обмена, попросите Claude напечатать его в своём ответе, затем запустите [`/copy`](/docs/ru/commands). `/copy` записывает в буфер обмена из процесса Claude Code, а не из изолированной команды.

754 

755 Когда Claude передаёт текст одному из этих инструментов, добавление инструмента в [`excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands) не выводит этот вызов из sandbox самостоятельно.

750* **Команда git не выполняется с ошибкой `unable to unlink old`**: `git merge`, `git checkout` и подобные команды не выполняются таким образом, когда им нужно заменить файл, в который sandbox запрещает запись, независимо от того, находится ли этот файл под [защищённым путём](#protected-paths), таким как `.claude/skills`, под одной из ваших записей `denyWrite` или вне каталогов, в которые sandbox позволяет командам писать вообще. На Linux и WSL2 ошибка заканчивается на `Read-only file system`.756* **Команда git не выполняется с ошибкой `unable to unlink old`**: `git merge`, `git checkout` и подобные команды не выполняются таким образом, когда им нужно заменить файл, в который sandbox запрещает запись, независимо от того, находится ли этот файл под [защищённым путём](#protected-paths), таким как `.claude/skills`, под одной из ваших записей `denyWrite` или вне каталогов, в которые sandbox позволяет командам писать вообще. На Linux и WSL2 ошибка заканчивается на `Read-only file system`.

751 757 

752 После сбоя Claude может [предложить повторно запустить команду вне sandbox](#the-unsandboxed-retry-escape-hatch); одобрите этот повтор или запустите команду git самостоятельно в другом терминале. Если вы установили `allowUnsandboxedCommands` в `false`, Claude не может предложить повтор, поэтому запустите команду самостоятельно. Если одна и та же команда git часто не выполняется, добавьте её в [`excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands).758 После сбоя Claude может [предложить повторно запустить команду вне sandbox](#the-unsandboxed-retry-escape-hatch); одобрите этот повтор или запустите команду git самостоятельно в другом терминале. Если вы установили `allowUnsandboxedCommands` в `false`, Claude не может предложить повтор, поэтому запустите команду самостоятельно. Если одна и та же команда git часто не выполняется, добавьте её в [`excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands).

Details

31/plugin install security-guidance@claude-plugins-official31/plugin install security-guidance@claude-plugins-official

32```32```

33 33 

34`/plugin` открывает интерактивную панель и доступен только в терминальном CLI. Если Claude сообщит, что `/plugin` недоступен в этой среде, установите другим способом:34`/plugin` открывает интерактивную панель в терминальном CLI. Если Claude сообщит, что `/plugin` недоступен в этой среде, установите другим способом:

35 35 

36* **Приложение Claude для рабочего стола, локальный или SSH сеанс**: откройте [браузер плагинов](/docs/ru/desktop#install-plugins), нажав кнопку **+** рядом с приглашением, затем **Plugins**, затем **Add plugin**36* **Приложение Claude для рабочего стола, локальный или SSH сеанс**: откройте [браузер плагинов](/docs/ru/desktop#install-plugins), нажав кнопку **+** рядом с приглашением, затем **Plugins**, затем **Add plugin**

37* **Облачные сеансы**: объявите плагин в `.claude/settings.json`, как показано в разделе [Enable in cloud sessions](#enable-in-cloud-sessions-and-shared-repositories)37* **Расширение VS Code**: установите из [диалога **Manage plugins**](/docs/ru/vs-code#manage-plugins)

38* **Облачные сеансы**: включите плагин для вашей учетной записи claude.ai, чтобы Claude Code загружал его как [синхронизированный плагин](/docs/ru/plugins-reference#synced-plugins). Облачный сеанс не загружает плагины из ваших пользовательских параметров или из файла `.claude/settings.json` репозитория, как объясняется в разделе [What carries over from your setup](/docs/ru/cloud-environments#what-carries-over-from-your-setup)

38 39 

39Установка в терминале запрашивает область действия. Выберите область действия пользователя, чтобы записать плагин в ваши пользовательские параметры, поэтому он загружается в каждом новом локальном сеансе, который вы запускаете на этой машине.40Установка в терминале запрашивает область действия. Выберите область действия пользователя, чтобы записать плагин в ваши пользовательские параметры, поэтому он загружается в каждом новом локальном сеансе, который вы запускаете на этой машине.

40 41 

45 46 

46Проверьте сводку установки. Если она сообщает `Run /reload-plugins to activate.`, см. [Apply plugin changes without restarting](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting), чтобы активировать плагин в вашем текущем сеансе.47Проверьте сводку установки. Если она сообщает `Run /reload-plugins to activate.`, см. [Apply plugin changes without restarting](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting), чтобы активировать плагин в вашем текущем сеансе.

47 48 

48<h3 id="enable-in-cloud-sessions-and-shared-repositories">49<h3 id="enable-for-your-team-in-local-sessions">

49 Включение в облачных сеансах и общих репозиториях50 Включение для вашей команды в локальных сеансах

50</h3>51</h3>

51 52 

52Плагины с областью действия пользователя не переносятся в [облачные сеансы](/docs/ru/claude-code-on-the-web), потому что эти сеансы не работают на вашей машине. Чтобы включить плагин там или включить его для всех, кто клонирует репозиторий, объявите его в параметрах проекта, которые проверены:53Чтобы включить плагин в локальных сеансах, которые ваши коллеги запускают в репозитории, объявите его в параметрах проекта, которые проверены:

53 54 

54```json .claude/settings.json theme={null}55```json .claude/settings.json theme={null}

55{56{

Details

184 184 

185Прокси требует `--capacity 1`, потому что URL прокси зависит от сеанса, и git 2.32 или новее, потому что более старый git игнорирует механизм конфигурации, который прокси использует для изоляции сеансов друг от друга. Runner отказывается запускаться, если какое-либо требование не выполнено. Поскольку прокси получает со стороны Anthropic, ваш git-хост должен быть доступен из инфраструктуры Anthropic, то же требование, что и для сеансов, размещаемых Anthropic; для git-хоста, который маршрутизируется только внутри вашей сети, используйте вместо этого [`checkout` lifecycle hook](/docs/ru/self-hosted-environments-configuration#checkout). Каждый процесс runner обрабатывает один сеанс за раз, поэтому запускайте больше реплик для параллелизма. Когда прокси включен, `--git-host-rewrite` и `--git-ssh-rewrite` не имеют эффекта: URL прокси указывает на `api.anthropic.com`, а не на ваш git-хост.185Прокси требует `--capacity 1`, потому что URL прокси зависит от сеанса, и git 2.32 или новее, потому что более старый git игнорирует механизм конфигурации, который прокси использует для изоляции сеансов друг от друга. Runner отказывается запускаться, если какое-либо требование не выполнено. Поскольку прокси получает со стороны Anthropic, ваш git-хост должен быть доступен из инфраструктуры Anthropic, то же требование, что и для сеансов, размещаемых Anthropic; для git-хоста, который маршрутизируется только внутри вашей сети, используйте вместо этого [`checkout` lifecycle hook](/docs/ru/self-hosted-environments-configuration#checkout). Каждый процесс runner обрабатывает один сеанс за раз, поэтому запускайте больше реплик для параллелизма. Когда прокси включен, `--git-host-rewrite` и `--git-ssh-rewrite` не имеют эффекта: URL прокси указывает на `api.anthropic.com`, а не на ваш git-хост.

186 186 

187Runner также сообщает согласие Anthropic при регистрации, печатая `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` при запуске. Каждый сеанс на согласившемся runner затем использует либо управляемый Anthropic git, либо URL прокси для каждого сеанса. Когда сеанс использует URL прокси для каждого сеанса, runner регистрирует одну строку `[runner:warn]`, говорящую об этом.187Runner также сообщает согласие Anthropic при регистрации, печатая `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` при запуске. Сообщение о согласии требует Claude Code v2.1.267 или позже, и более ранние версии принимают флаг без сообщения об этом или печати этой строки. Каждый сеанс на согласившемся runner затем использует либо управляемый Anthropic git, либо URL прокси для каждого сеанса. Когда сеанс использует URL прокси для каждого сеанса, runner регистрирует одну строку `[runner:warn]`, говорящую об этом.

188 188 

189<h3 id="rewrite-git-urls-for-private-networks">189<h3 id="rewrite-git-urls-for-private-networks">

190 Переписывайте URL git для приватных сетей190 Переписывайте URL git для приватных сетей

223Замените `linux-x64` на `linux-arm64`, если ваши узлы ARM, или на `linux-x64-musl` или `linux-arm64-musl` на образе на основе musl, таком как Alpine; см. [Alpine Linux setup](/docs/ru/setup#alpine-linux-and-musl-based-distributions) для дополнительных пакетов, которые нужны образам musl. URL является стандартным местоположением выпуска Claude Code, поэтому вы можете проверить загруженный бинарный файл против подписанного манифеста выпуска, как описано в [Binary integrity and code signing](/docs/ru/setup#binary-integrity-and-code-signing). Постройте образ с версией Claude Code 2.1.224 или позже, затем отправьте его в ваш реестр и ссылайтесь на него в рецептах ниже:223Замените `linux-x64` на `linux-arm64`, если ваши узлы ARM, или на `linux-x64-musl` или `linux-arm64-musl` на образе на основе musl, таком как Alpine; см. [Alpine Linux setup](/docs/ru/setup#alpine-linux-and-musl-based-distributions) для дополнительных пакетов, которые нужны образам musl. URL является стандартным местоположением выпуска Claude Code, поэтому вы можете проверить загруженный бинарный файл против подписанного манифеста выпуска, как описано в [Binary integrity and code signing](/docs/ru/setup#binary-integrity-and-code-signing). Постройте образ с версией Claude Code 2.1.224 или позже, затем отправьте его в ваш реестр и ссылайтесь на него в рецептах ниже:

224 224 

225```bash theme={null}225```bash theme={null}

226docker build --build-arg CLAUDE_CODE_VERSION=2.1.224 -t <your-registry>/claude-runner:latest .226docker build --build-arg CLAUDE_CODE_VERSION=2.1.267 -t <your-registry>/claude-runner:latest .

227```227```

228 228 

229<h2 id="size-cpu-and-memory-for-sessions">229<h2 id="size-cpu-and-memory-for-sessions">

Details

149 Приоритет параметров149 Приоритет параметров

150</h3>150</h3>

151 151 

152Параметры, управляемые сервером, и [параметры, управляемые конечной точкой](/docs/ru/managed-settings#delivery-mechanisms) занимают наивысший уровень в [иерархии параметров](/docs/ru/settings#settings-precedence) Claude Code. Никакой другой уровень параметров не может их переопределить, включая аргументы командной строки, за исключением [исключений из приоритета управляемых параметров](/docs/ru/settings#exceptions-to-managed-settings-precedence).152Управляемые сервером параметры и [управляемые конечной точкой параметры](/docs/ru/managed-settings#delivery-mechanisms) занимают наивысший уровень в иерархии [параметров](/docs/ru/settings#settings-precedence) Claude Code. Никакой другой уровень параметров не может их переопределить, включая аргументы командной строки, за исключением [исключений из приоритета управляемых параметров](/docs/ru/settings#exceptions-to-managed-settings-precedence).

153 153 

154В пределах управляемого уровня Claude Code по умолчанию использует первый источник, который доставляет хотя бы один ключ политики, проверяя сначала параметры, управляемые сервером, а затем параметры, управляемые конечной точкой, за исключением [ключей исключений, рассмотренных далее](#per-key-exceptions-across-managed-sources). [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#precedence-within-the-managed-tier) содержит полный рейтинг, исключение для ключей управления и согласие, которое применяется к каждому источнику.154В пределах управляемого уровня Claude Code по умолчанию использует первый источник, который доставляет хотя бы один ключ политики, сначала проверяя управляемые сервером параметры, а затем управляемые конечной точкой параметры, за исключением [ключей исключений, рассмотренных далее](#per-key-exceptions-across-managed-sources). [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#precedence-within-the-managed-tier) содержит полный рейтинг, исключение для ключей управления и согласие, которое применяется к каждому источнику.

155 155 

156Если выбранный источник — это политика MDM или файл управляемых параметров, чей [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры, вывод помощника заменяет этот источник как единственную управляемую конфигурацию для запуска. Claude Code не обращается к `policyHelper`, настроенному в параметрах MDM или на основе файлов, пока параметры, управляемые сервером, доставляют ключ политики.156Если выбранный источник — это политика MDM или файл управляемых параметров, чей [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры, выходные данные помощника заменяют этот источник как единственную управляемую конфигурацию для запуска. Claude Code не обращается к `policyHelper`, настроенному в MDM или файловых параметрах, пока управляемые сервером параметры доставляют ключ политики.

157 157 

158Если более поздняя выборка обнаруживает удаленные параметры, управляемые сервером, Claude Code сразу же запускает этот помощник вместо следующего запуска. Запись [`policyHelper`](/docs/ru/settings-reference#policyhelper) охватывает то, что происходит, когда этот запуск не удается.158Если более поздняя выборка обнаруживает удаление управляемых сервером параметров, Claude Code сразу же запускает этот помощник вместо следующего запуска. Запись [`policyHelper`](/docs/ru/settings-reference#policyhelper) охватывает то, что происходит при сбое этого запуска.

159 159 

160Если вы очищаете конфигурацию, управляемую сервером, в консоли администратора с намерением вернуться к управляемому plist или политике реестра, управляемой конечной точкой, имейте в виду, что [кэшированные параметры](#fetch-and-caching-behavior) сохраняются на клиентских машинах до следующей успешной выборки, и ключи, которые [применяются только при следующем запуске](#fetch-and-caching-behavior), такие как `model`, остаются в силе до тех пор, пока каждый клиент не перезагрузится. Запустите `/status` для просмотра того, какой управляемый источник активен.160Если вы очищаете конфигурацию управляемых сервером параметров в консоли администратора с намерением вернуться к управляемой конечной точкой plist или политике реестра, имейте в виду, что [кэшированные параметры](#fetch-and-caching-behavior) сохраняются на клиентских машинах до следующей успешной выборки, и ключи, которые [применяются только при следующем запуске](#fetch-and-caching-behavior), такие как `model`, остаются в силе до перезагрузки каждого клиента. Запустите `/status`, чтобы увидеть, какой управляемый источник активен.

161 161 

162<h3 id="per-key-exceptions-across-managed-sources">162<h3 id="per-key-exceptions-across-managed-sources">

163 Исключения для отдельных ключей в управляемых источниках163 Исключения для отдельных ключей в управляемых источниках

167 167 

168* **Ключи блокировки между источниками**: небольшой набор ключей, таких как блокировки списка разрешений песочницы, [указанные на странице управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier). Claude Code соблюдает их, когда любой управляемый администратором источник их устанавливает; уровень реестра HKCU, доступный для записи пользователем, исключен.168* **Ключи блокировки между источниками**: небольшой набор ключей, таких как блокировки списка разрешений песочницы, [указанные на странице управляемых параметров](/docs/ru/managed-settings#precedence-within-the-managed-tier). Claude Code соблюдает их, когда любой управляемый администратором источник их устанавливает; уровень реестра HKCU, доступный для записи пользователем, исключен.

169 169 

170 Когда [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры, его вывод является единственным источником, который эти проверки читают, за исключением [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh), который Claude Code читает из источников администратора непосредственно при запуске.170 Когда [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры, его выходные данные — это единственный источник, который эти проверки читают, за исключением [`forceRemoteSettingsRefresh`](/docs/ru/settings-reference#forceremotesettingsrefresh), который Claude Code читает из источников администратора непосредственно при запуске.

171* **Блок `env`**: помимо единицы телеметрии и переменных маршрутизации, связанных с ключом учетных данных, оба рассмотрены ниже, он объединяется для каждого ключа в управляемых источниках, контролируемых администратором. Для каждой переменной окружения источник с наивысшим приоритетом, определяющий ее, побеждает, и источники администратора с более низким приоритетом заполняют переменные, которые источники с более высоким приоритетом оставляют неустановленными. Запись `env`, управляемая конечной точкой, поэтому применяется всякий раз, когда конфигурация, управляемая сервером, оставляет эту переменную неустановленной, или пока кэшированное значение сервера для нее [удерживается в ожидании подтверждения сервером](#fetch-and-caching-behavior). Требуется Claude Code v2.1.223 или более поздняя версия. До v2.1.223 Claude Code применяет только весь блок `env` выбранного источника.171* **Блок `env`**: помимо единицы телеметрии и переменных маршрутизации, связанных с ключом учетных данных, оба рассмотрены ниже, он объединяется по ключам в управляемых администратором источниках. Для каждой переменной окружения источник с наивысшим приоритетом, определяющий ее, побеждает, а источники администратора с более низким приоритетом заполняют переменные, которые источники с более высоким приоритетом оставляют неустановленными. Запись `env`, управляемая конечной точкой, поэтому применяется всякий раз, когда конфигурация управляемых сервером параметров оставляет эту переменную неустановленной, или пока кэшированное значение сервера для нее [удерживается в ожидании подтверждения сервером](#fetch-and-caching-behavior). Требуется Claude Code v2.1.223 или более поздняя версия. До v2.1.223 Claude Code применяет только весь блок `env` выбранного источника.

172 * **Единица телеметрии**: ключи экспортера `OTEL_EXPORTER_OTLP_*`, переключатели захвата содержимого `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` и переменные бета-трассировки `ENABLE_BETA_TRACING_DETAILED` и `BETA_TRACING_ENDPOINT` следуют источнику с наивысшим приоритетом, который устанавливает любой из них как единицу. Источник, который доставляет ключ учетных данных `otelHeadersHelper`, также претендует на единицу, но размещает эти переменные только когда он является выбранным источником: источник, который не выбран, но доставляет ключ, не вносит ни один из них и все еще блокирует источники с более низким приоритетом от их заполнения. В любом случае конечная точка экспортера из одного источника никогда не может быть связана с учетными данными из другого.172 * **Единица телеметрии**: ключи экспортера `OTEL_EXPORTER_OTLP_*`, переключатели захвата содержимого `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` и бета-переменные трассировки `ENABLE_BETA_TRACING_DETAILED` и `BETA_TRACING_ENDPOINT` следуют источнику с наивысшим приоритетом, который устанавливает любой из них как единицу. Источник, который доставляет ключ учетных данных `otelHeadersHelper`, также претендует на единицу, но размещает эти переменные только когда он является выбранным источником: источник, который не выбран, но доставляет ключ, не вносит ни один из них и все еще блокирует более низкие источники от их заполнения. В любом случае конечная точка экспортера из одного источника никогда не может быть связана с учетными данными из другого.

173 * **Маршрутизация, связанная с учетными данными**: источник, который связывает переменные маршрутизации с ключом учетных данных, применяемым только для выбранного источника, таким как `apiKeyHelper` или `otelHeadersHelper`, вносит эти переменные маршрутизации только когда он выигрывает слот.173 * **Маршрутизация с привязкой к учетным данным**: источник, который связывает переменные маршрутизации с ключом учетных данных, доступным только для выбранного источника, такой как `apiKeyHelper` или `otelHeadersHelper`, вносит эти переменные маршрутизации только когда он выигрывает слот.

174* **Ключи входа через шлюз**: Claude Code никогда не читает [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl) или значение `"gateway"` из [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) из параметров, управляемых сервером, поэтому выбор параметров, управляемых сервером, ни предоставляет вход через шлюз, ни скрывает тот, который установлен в политике MDM или файле управляемых параметров. Запись [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) указывает, какой управляемый администратором источник на машине их предоставляет.174* **Ключи входа в шлюз**: Claude Code никогда не читает [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/ru/settings-reference#gatewayinternalnetworks) или значение `"gateway"` [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) из управляемых сервером параметров, поэтому значение там ни не применяется, ни не скрывает значение, установленное в политике MDM или файле управляемых параметров. Запись [`managedSourcesBehavior`](/docs/ru/settings-reference#managedsourcesbehavior) указывает, какой источник администратора на машине их предоставляет.

175 175 

176<h3 id="fetch-and-caching-behavior">176<h3 id="fetch-and-caching-behavior">

177 Поведение выборки и кэширования177 Поведение выборки и кэширования

178</h3>178</h3>

179 179 

180Claude Code выбирает параметры с серверов Anthropic при запуске и опрашивает обновления каждый час во время активных сеансов.180Claude Code выполняет выборку параметров с серверов Anthropic при запуске и опрашивает обновления каждый час во время активных сеансов.

181 181 

182Клиент, вошедший через [шлюз приложений Claude](#platform-availability), выбирает свои параметры из шлюза и ждет этой выборки перед началом сеанса, поэтому выборка в списках ниже к нему не применяется. [Принудительное закрытие при запуске](#enforce-fail-closed-startup) охватывает то, что происходит, когда эта выборка не удается.182Клиент, вошедший через [шлюз приложений Claude](#platform-availability), выполняет выборку параметров из шлюза и ждет завершения этой выборки перед началом сеанса, поэтому выборка в списках ниже к нему не применяется. [Принудительный отказ при запуске](#enforce-fail-closed-startup) охватывает то, что происходит при сбое этой выборки.

183 183 

184**Первый запуск без кэшированных параметров:**184**Первый запуск без кэшированных параметров:**

185 185 

186* Когда разработчик входит при запуске, например при первом запуске или после `/logout`, Claude Code ждет до пяти секунд выборки перед открытием сеанса. Когда политика прибывает вовремя, Claude Code применяет ее с первого экрана и показывает ваши [`companyAnnouncements`](/docs/ru/settings-reference#companyannouncements) на нем. Когда полезная нагрузка требует [одобрения безопасности](#security-approval-dialogs), Claude Code завершает ожидание и применяет полезную нагрузку после одобрения разработчиком186* Когда разработчик входит при запуске, например при первом запуске или после `/logout`, Claude Code ждет до пяти секунд выборки перед открытием сеанса. Когда политика поступает вовремя, Claude Code применяет ее с первого экрана и показывает ваши [`companyAnnouncements`](/docs/ru/settings-reference#companyannouncements) на нем. Когда полезная нагрузка требует [одобрения безопасности](#security-approval-dialogs), Claude Code завершает ожидание и применяет полезную нагрузку после одобрения разработчиком

187* При любом другом запуске и когда истекает пятисекундное ожидание, Claude Code открывает сеанс, пока выборка продолжается, поэтому краткое окно проходит перед загрузкой параметров и вступлением в силу ограничений187* При любом другом запуске и когда истекает пятисекундное ожидание, Claude Code открывает сеанс, пока выборка продолжается, поэтому краткое окно проходит перед загрузкой параметров и вступлением в силу ограничений

188* Если выборка не удается, Claude Code продолжает без параметров, управляемых сервером, и предупреждает в интерактивных сеансах, что удаленная политика не применяется; параметры, управляемые конечной точкой, все еще применяются. Если управляемый источник устанавливает [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup), Claude Code вместо этого выходит188* Если выборка не удается, Claude Code продолжает работу без управляемых сервером параметров и предупреждает в интерактивных сеансах, что удаленная политика не применяется; управляемые конечной точкой параметры все еще применяются. Если управляемый источник устанавливает [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup), Claude Code вместо этого выходит

189 189 

190**Последующие запуски с кэшированными параметрами:**190**Последующие запуски с кэшированными параметрами:**

191 191 

192* Кэшированные параметры применяются немедленно при запуске, за исключением кэшированных значений `modelPricing` и `managedMcpServers` и переменных окружения, которые Claude Code удерживает до подтверждения полезной нагрузки сервером192* Кэшированные параметры применяются немедленно при запуске, за исключением кэшированных значений `modelPricing` и `managedMcpServers` и переменных окружения, которые Claude Code удерживает до подтверждения полезной нагрузки сервером

193* Кэшированный [`modelPricing`](/docs/ru/settings-reference#modelpricing) не применяется до тех пор, пока выборка сеанса не подтвердит полезную нагрузку. До этого цифры затрат, которые разработчики видят в `/usage` и в строке состояния, находятся по цене списка193* Кэшированный [`modelPricing`](/docs/ru/settings-reference#modelpricing) не применяется до тех пор, пока выборка сеанса не подтвердит полезную нагрузку. До этого момента цифры затрат, которые разработчики видят в `/usage` и в строке состояния, находятся по цене списка

194* Кэшированный блок [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers) не применяется до тех пор, пока выборка сеанса не подтвердит полезную нагрузку. Claude Code ждет до 30 секунд для этой выборки перед подключением серверов MCP. Если выборка не удается или истекает время ожидания, сеанс начинается без серверов организации, `/status` это указывает, и они подключаются после подтверждения более поздней выборкой. См. [Когда предоставленные серверы подключаются](/docs/ru/managed-mcp#when-provided-servers-connect) для полного поведения, включая первый запуск. Требуется Claude Code v2.1.259 или более поздняя версия194* Кэшированный блок [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers) не применяется до тех пор, пока выборка сеанса не подтвердит полезную нагрузку. Claude Code ждет до 30 секунд для этой выборки перед подключением серверов MCP. Если выборка не удается или истекает время ожидания, сеанс начинается без серверов организации, `/status` это указывает, и они подключаются после подтверждения более поздней выборкой. Полное поведение см. в разделе [Когда предоставленные серверы подключаются](/docs/ru/managed-mcp#when-provided-servers-connect), включая первый запуск. Требуется Claude Code v2.1.259 или более поздняя версия

195* Claude Code выбирает свежие параметры в фоновом режиме195* Claude Code выполняет выборку свежих параметров в фоновом режиме

196* Кэшированные параметры сохраняются при сбоях сети. Если выборка при запуске не удается, Claude Code предупреждает в интерактивных сеансах, что кэшированная политика действует196* Кэшированные параметры сохраняются при сбоях сети. Если выборка при запуске не удается, Claude Code предупреждает в интерактивных сеансах, что кэшированная политика действует

197* До тех пор, пока выборка не будет успешной, удерживаемые значения остаются удерживаемыми197* До успешной выборки удерживаемые значения при запуске остаются удерживаемыми

198 198 

199Claude Code удерживает несколько категорий переменных в кэшированном блоке `env` до тех пор, пока сервер не подтвердит полезную нагрузку для сеанса. Это предотвращает перенаправление, перехват или повторную аутентификацию кэшированного прокси, центра сертификации, конечной точки или значения учетных данных при выборке параметров, которая подтверждает полезную нагрузку. Усиление применяется только к кэшу параметров, полученных с сервера: [параметры, управляемые конечной точкой](/docs/ru/managed-settings#delivery-mechanisms), развернутые через MDM или `managed-settings.json`, не затронуты. Удерживание требует Claude Code v2.1.198 или более поздней версии; до v2.1.198 весь кэшированный блок `env` применяется при запуске. Удерживаемые категории включают:199Claude Code удерживает несколько категорий переменных в кэшированном блоке `env` до подтверждения полезной нагрузки сервером для сеанса. Это предотвращает перенаправление, перехват или повторную аутентификацию кэшированного прокси, центра сертификации, конечной точки или значения учетных данных при выборке параметров, которая подтверждает полезную нагрузку. Усиление применяется только к кэшу параметров, полученных с сервера: [управляемые конечной точкой параметры](/docs/ru/managed-settings#delivery-mechanisms), развернутые через MDM или `managed-settings.json`, не затронуты. Удержание требует Claude Code v2.1.198 или более поздней версии; до v2.1.198 весь кэшированный блок `env` применяется при запуске. Удерживаемые категории включают:

200 200 

201* Конфигурация прокси и TLS, такая как `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` и переменные сертификата клиента mTLS `CLAUDE_CODE_CLIENT_CERT` и `CLAUDE_CODE_CLIENT_KEY`201* Конфигурация прокси и TLS, такая как `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` и переменные сертификата клиента mTLS `CLAUDE_CODE_CLIENT_CERT` и `CLAUDE_CODE_CLIENT_KEY`

202* Маршрутизация API и выбор поставщика, включая `ANTHROPIC_BASE_URL`, переменные выбора поставщика, такие как `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_VERTEX`, и URL-адреса конечных точек поставщика, такие как `ANTHROPIC_BEDROCK_BASE_URL`202* Маршрутизация API и выбор поставщика, включая `ANTHROPIC_BASE_URL`, переменные выбора поставщика, такие как `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_VERTEX`, и URL-адреса конечных точек поставщика, такие как `ANTHROPIC_BEDROCK_BASE_URL`

204* Селектор каталога конфигурации `CLAUDE_CONFIG_DIR`204* Селектор каталога конфигурации `CLAUDE_CONFIG_DIR`

205* Селекторы источника учетных данных и каталога конфигурации в Claude Code v2.1.223 или более поздней версии: переменные Workload Identity Federation, такие как `ANTHROPIC_FEDERATION_RULE_ID` и `ANTHROPIC_IDENTITY_TOKEN`, селекторы профиля и каталога конфигурации `ANTHROPIC_PROFILE` и `ANTHROPIC_CONFIG_DIR`, и переменные каталога операционной системы `HOME`, `XDG_CONFIG_HOME`, `APPDATA` и `USERPROFILE`205* Селекторы источника учетных данных и каталога конфигурации в Claude Code v2.1.223 или более поздней версии: переменные Workload Identity Federation, такие как `ANTHROPIC_FEDERATION_RULE_ID` и `ANTHROPIC_IDENTITY_TOKEN`, селекторы профиля и каталога конфигурации `ANTHROPIC_PROFILE` и `ANTHROPIC_CONFIG_DIR`, и переменные каталога операционной системы `HOME`, `XDG_CONFIG_HOME`, `APPDATA` и `USERPROFILE`

206 206 

207Claude Code читает переменные Workload Identity Federation и селекторы `ANTHROPIC_PROFILE` и `ANTHROPIC_CONFIG_DIR` только при запуске, поэтому значение, доставленное сервером для них, не переключает источник учетных данных сеанса даже после успешной выборки. Для доставки этих селекторов на Claude Code v2.1.223 или более поздней версии используйте [параметры, управляемые конечной точкой](/docs/ru/managed-settings#delivery-mechanisms), такие как MDM или `managed-settings.json`. Для `CLAUDE_CONFIG_DIR` и переменных каталога операционной системы само удерживание является защитой: кэшированное значение остается вне окружения до тех пор, пока сервер не подтвердит полезную нагрузку.207Claude Code читает переменные Workload Identity Federation и селекторы `ANTHROPIC_PROFILE` и `ANTHROPIC_CONFIG_DIR` только при запуске, поэтому значение, доставленное сервером для них, не переключает источник учетных данных сеанса даже после успешной выборки. Для доставки этих селекторов на Claude Code v2.1.223 или более поздней версии используйте [управляемые конечной точкой параметры](/docs/ru/managed-settings#delivery-mechanisms), такие как MDM или `managed-settings.json`. Для `CLAUDE_CONFIG_DIR` и переменных каталога операционной системы само удержание является защитой: кэшированное значение остается вне окружения до подтверждения полезной нагрузки сервером.

208 208 

209Каждый другой ключ в кэшированном блоке `env` применяется при запуске. После подтверждения сервером полезной нагрузки и вашего одобрения, если она требует [одобрения безопасности](#security-approval-dialogs), удерживаемые переменные применяются для остальной части сеанса.209Каждый другой ключ в кэшированном блоке `env` применяется при запуске. После подтверждения полезной нагрузки сервером и вашего одобрения, если оно требует [одобрения безопасности](#security-approval-dialogs), удерживаемые переменные применяются для остальной части сеанса.

210 210 

211Если вашей организации требуется прокси для доступа к `api.anthropic.com`, удерживание влияет только на сам блок `env`, доставленный сервером: прокси, установленный в [управляемом конечной точкой](/docs/ru/managed-settings#delivery-mechanisms) блоке `env` через MDM или `managed-settings.json`, в окружении оболочки или в [параметрах пользователя](/docs/ru/settings#where-settings-live), достигает выборки параметров. Источник, управляемый конечной точкой, требует Claude Code v2.1.223 или более поздней версии: кэшированное значение прокси, управляемое сервером, удерживается до тех пор, пока выборка не подтвердит его, поэтому значение, управляемое конечной точкой, заполняется для каждого ключа и достигает самой выборки. До v2.1.223 используйте окружение оболочки или параметры пользователя, чтобы прокси применялся вместе с кэшированной полезной нагрузкой, управляемой сервером. Первый запуск не имеет кэша, поэтому источник, управляемый конечной точкой, окружение оболочки или параметры пользователя все еще требуются для начальной выборки.211Если вашей организации требуется прокси для доступа к `api.anthropic.com`, удержание влияет только на сам доставленный блок `env`: прокси, установленный в [управляемом конечной точкой](/docs/ru/managed-settings#delivery-mechanisms) блоке `env` через MDM или `managed-settings.json`, в окружении оболочки или в [пользовательских параметрах](/docs/ru/settings#where-settings-live), достигает выборки параметров. Источник, управляемый конечной точкой, требует Claude Code v2.1.223 или более поздней версии: кэшированное значение прокси, управляемое сервером, удерживается до подтверждения выборкой, поэтому значение, управляемое конечной точкой, заполняется по ключам и достигает самой выборки. До v2.1.223 используйте окружение оболочки или пользовательские параметры, чтобы прокси применялся вместе с кэшированной полезной нагрузкой сервера. Первый запуск не имеет кэша, поэтому источник, управляемый конечной точкой, окружение оболочки или пользовательские параметры все еще требуются для начальной выборки.

212 212 

213Claude Code применяет большинство обновлений параметров к работающим сеансам без перезагрузки. Некоторые обновления применяются только при следующем запуске, включая конфигурацию экспортера OpenTelemetry, ключ `model` и удаление переменной из блока `env`.213Claude Code применяет большинство обновлений параметров к работающим сеансам без перезагрузки. Некоторые обновления применяются только при следующем запуске, включая конфигурацию экспортера OpenTelemetry, ключ `model` и удаление переменной из блока `env`.

214 214 

215<h3 id="invalid-entries-in-delivered-settings">215<h3 id="invalid-entries-in-delivered-settings">

216 Недопустимые записи в доставленных параметрах216 Недействительные записи в доставленных параметрах

217</h3>217</h3>

218 218 

219Когда часть полезной нагрузки не проходит проверку схемы, Claude Code выводит ошибку валидации и применяет каждый оставшийся допустимый параметр; [Недопустимые записи в управляемых параметрах](/docs/ru/managed-settings#invalid-entries-in-managed-settings) указывает, что оно удаляет и какие ключи возвращаются к более строгому значению. Требуется Claude Code v2.1.169 или более поздняя версия.219Когда часть полезной нагрузки не проходит проверку схемы, Claude Code выводит ошибку валидации и применяет каждый оставшийся действительный параметр; [Недействительные записи в управляемых параметрах](/docs/ru/managed-settings#invalid-entries-in-managed-settings) указывает, что он отбрасывает и какие ключи возвращаются к более строгому значению. Требуется Claude Code v2.1.169 или более поздняя версия.

220 220 

221Доставка, управляемая сервером, добавляет следующие поведения:221Доставка, управляемая сервером, добавляет эти поведения:

222 222 

223* Кэш в `~/.claude/remote-settings.json` сохраняет спасенную полезную нагрузку с удаленными недопустимыми записями, за исключением недопустимых значений `cleanupPeriodDays` и `desktopSessionCleanupPeriodDays`, которые остаются в кэшированной копии и никогда не применяются.223* Кэш в `~/.claude/remote-settings.json` хранит спасенную полезную нагрузку с удаленными недействительными записями, за исключением недействительных значений `cleanupPeriodDays` и `desktopSessionCleanupPeriodDays`, которые остаются в кэшированной копии и никогда не применяются.

224* Когда ни одно поле в полезной нагрузке не может быть спасено и полезная нагрузка не содержит только эти ключи удержания, Claude Code отклоняет полезную нагрузку, сохраняет последние принятые кэшированные параметры и записывает `Remote settings: Settings validation failed - no fields could be salvaged` в журнал отладки. С установленным `forceRemoteSettingsRefresh` CLI вместо этого выходит.224* Когда ни одно поле в полезной нагрузке не может быть спасено и полезная нагрузка не содержит только эти ключи хранения, Claude Code отклоняет полезную нагрузку, сохраняет последние принятые кэшированные параметры и записывает `Remote settings: Settings validation failed - no fields could be salvaged` в журнал отладки. Если установлен `forceRemoteSettingsRefresh`, CLI вместо этого выходит.

225* [Диалог одобрения безопасности](#security-approval-dialogs) оценивает спасенную полезную нагрузку, поэтому удаленная недопустимая запись никогда не представляется для одобрения и никогда не выполняется.225* [Диалог одобрения безопасности](#security-approval-dialogs) оценивает спасенную полезную нагрузку, поэтому удаленная недействительная запись никогда не представляется для одобрения и никогда не выполняется.

226 226 

227Для отладки проблем доставки запустите `claude --debug-file <path>` и найдите в журнале `Remote settings`. Проверьте изменение полезной нагрузки с помощью `claude doctor` на тестовой машине перед развертыванием в организации.227Для отладки проблем доставки запустите `claude --debug-file <path>` и найдите в журнале `Remote settings`. Проверьте изменение полезной нагрузки с помощью `claude doctor` на тестовой машине перед развертыванием в организации.

228 228 

229<h3 id="enforce-fail-closed-startup">229<h3 id="enforce-fail-closed-startup">

230 Принудительное закрытие при запуске230 Принудительный отказ при запуске

231</h3>231</h3>

232 232 

233По умолчанию, если выборка удаленных параметров не удается при запуске, CLI продолжает работу с параметрами, кэшированными из последней успешной выборки, за исключением [значений, которые Claude Code удерживает](#fetch-and-caching-behavior) до успешной выборки. На машине, которая никогда их не выбирала, CLI продолжает работу без параметров, управляемых сервером, и все еще применяет любые [параметры, управляемые конечной точкой](/docs/ru/managed-settings#delivery-mechanisms) на устройстве.233По умолчанию, если выборка удаленных параметров не удается при запуске, CLI продолжает работу с параметрами, кэшированными из последней успешной выборки, за исключением [значений, которые Claude Code удерживает](#fetch-and-caching-behavior) до успешной выборки. На машине, которая никогда их не выполняла, CLI продолжает работу без управляемых сервером параметров и все еще применяет любые [управляемые конечной точкой параметры](/docs/ru/managed-settings#delivery-mechanisms) на устройстве.

234 234 

235Чтобы остановить клиентов от запуска на кэшированных или отсутствующих параметрах, управляемых сервером, установите `forceRemoteSettingsRefresh: true` в ваших управляемых параметрах.235Чтобы остановить клиентов от запуска с кэшированными или отсутствующими управляемыми сервером параметрами, установите `forceRemoteSettingsRefresh: true` в ваших управляемых параметрах.

236 236 

237Клиенты, вошедшие через [шлюз приложений Claude](#platform-availability), ждут выборки при запуске независимо от того, установлен ли этот параметр, и обрабатывают неудачную выборку следующим образом:237Клиенты, вошедшие через [шлюз приложений Claude](#platform-availability), ждут выборки при запуске независимо от того, установлен ли этот параметр, и обрабатывают сбой выборки следующим образом:

238 238 

239* Если шлюз отвечает на посещаемый интерактивный запуск с `401` и этот параметр отключен, шлюз завершил этот вход. Claude Code выводит [`Cloud gateway session expired — run /login to reconnect.`](/docs/ru/errors#cloud-gateway-session-expired) и открывает сеанс, вышедший из шлюза, до тех пор, пока пользователь не запустит `/login`.239* Если шлюз отвечает на посещаемый интерактивный запуск с `401` и этот параметр отключен, шлюз завершил этот вход. Claude Code выводит [`Cloud gateway session expired — run /login to reconnect.`](/docs/ru/errors#cloud-gateway-session-expired) и открывает сеанс без входа в шлюз до тех пор, пока пользователь не запустит `/login`.

240* Когда выборка не удается каким-либо другим способом, или в любом другом типе запуска, кроме подкоманды `claude auth`, клиент выходит с ошибкой.240* Когда выборка не удается каким-либо другим способом или в любом другом типе запуска, кроме подкоманды `claude auth`, клиент выходит с ошибкой.

241 241 

242Когда этот параметр активен в сеансе, который выбирает параметры, управляемые сервером, CLI блокируется при запуске до тех пор, пока удаленные параметры не будут свежо выбраны. Если выборка не удается, CLI выходит вместо продолжения без политики. Этот параметр самовоспроизводится: после доставки с сервера он также кэшируется локально, чтобы последующие запуски применяли то же поведение даже перед первой успешной выборкой нового сеанса. Сеанс, который [не выбирает параметры, управляемые сервером](#platform-availability), начинается без ожидания.242Когда этот параметр активен в сеансе, который выполняет выборку управляемых сервером параметров, CLI блокируется при запуске до тех пор, пока удаленные параметры не будут свежо выбраны. Если выборка не удается, CLI выходит вместо продолжения без политики. Этот параметр самовоспроизводится: после доставки с сервера он также кэшируется локально, чтобы последующие запуски применяли то же поведение даже перед первой успешной выборкой нового сеанса. Сеанс, который [не выполняет выборку управляемых сервером параметров](#platform-availability), начинается без ожидания.

243 243 

244Чтобы включить это, добавьте ключ в конфигурацию управляемых параметров:244Чтобы включить это, добавьте ключ в конфигурацию управляемых параметров:

245 245 

249}249}

250```250```

251 251 

252Вы также можете установить этот ключ в [управляемый конечной точкой](/docs/ru/managed-settings#delivery-mechanisms) профиль MDM или системный файл `managed-settings.json` для принудительного применения поведения fail-closed при первом запуске, до того как будет доставлена какая-либо полезная нагрузка сервера. В Claude Code v2.1.191 или более поздней версии этот флаг является исключением из [правила приоритета](#settings-precedence) выше: Claude Code соблюдает его, когда любой управляемый администратором источник его устанавливает, даже если также присутствует кэшированная полезная нагрузка, управляемая сервером, поэтому значение, доставленное MDM, не игнорируется, когда существуют параметры, управляемые сервером.252Вы также можете установить этот ключ в [управляемом конечной точкой](/docs/ru/managed-settings#delivery-mechanisms) профиле MDM или системном файле `managed-settings.json` для применения поведения отказа при запуске, перед поступлением любой полезной нагрузки сервера. В Claude Code v2.1.191 или более поздней версии этот флаг является исключением из [правила приоритета](#settings-precedence) выше: Claude Code соблюдает его, когда любой управляемый администратором источник его устанавливает, даже если также присутствует кэшированная полезная нагрузка, управляемая сервером, поэтому он не игнорирует значение, доставленное MDM, когда существуют управляемые сервером параметры.

253 253 

254Когда [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры, его вывод заменяет каждый другой управляемый источник для ключей, которые Claude Code читает после запуска. Для источников, из которых Claude Code читает этот ключ, см. [его запись параметров](/docs/ru/settings-reference#forceremotesettingsrefresh). Запись `policyHelper` указывает, из каких источников Claude Code читает помощника и когда он запускается.254Когда [`policyHelper`](/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры, его выходные данные заменяют каждый другой управляемый источник для ключей, которые Claude Code читает после запуска. Для источников, из которых Claude Code читает этот ключ, см. [его запись параметров](/docs/ru/settings-reference#forceremotesettingsrefresh). Запись `policyHelper` указывает, из каких источников Claude Code читает помощника и когда он запускается.

255 255 

256Выборка параметров также отправляет заголовок `Cache-Control: no-cache`, чтобы промежуточные HTTP-прокси не обслуживали устаревший ответ.256Выборка параметров также отправляет заголовок `Cache-Control: no-cache`, чтобы промежуточные HTTP-прокси не обслуживали устаревший ответ.

257 257 

258Перед включением этого параметра убедитесь, что ваши сетевые политики позволяют подключение к `api.anthropic.com`. Если эта конечная точка недоступна, CLI выходит при запуске и пользователи не могут запустить Claude Code.258Перед включением этого параметра убедитесь, что ваши сетевые политики разрешают подключение к `api.anthropic.com`. Если эта конечная точка недоступна, CLI выходит при запуске и пользователи не могут запустить Claude Code.

259 259 

260Подкоманды `claude auth`, такие как `claude auth login`, освобождены от этой проверки и от выхода при запуске шлюза, поэтому пользователи могут повторно пройти аутентификацию, когда истекшие учетные данные являются причиной сбоя выборки параметров.260Подкоманды `claude auth`, такие как `claude auth login`, освобождены от этой проверки и от выхода при запуске шлюза, поэтому пользователи могут повторно аутентифицироваться, когда истекшие учетные данные являются причиной сбоя выборки параметров.

261 261 

262<h3 id="security-approval-dialogs">262<h3 id="security-approval-dialogs">

263 Диалоги одобрения безопасности263 Диалоги одобрения безопасности

265 265 

266Определенные параметры, которые могут представлять риск безопасности, требуют явного одобрения пользователя перед применением Claude Code в интерактивном сеансе:266Определенные параметры, которые могут представлять риск безопасности, требуют явного одобрения пользователя перед применением Claude Code в интерактивном сеансе:

267 267 

268* **Параметры команд оболочки**: параметры, которые выполняют команды оболочки, такие как `apiKeyHelper`, `statusLine` и `otelHeadersHelper`268* **Параметры команды оболочки**: параметры, которые выполняют команды оболочки, такие как `apiKeyHelper`, `statusLine` и `otelHeadersHelper`

269* **Параметры двоичных файлов песочницы**: `sandbox.bwrapPath`, `sandbox.socatPath` и `sandbox.ripgrep`. Каждый из этих параметров указывает на исполняемый файл, и Claude Code запускает этот исполняемый файл269* **Параметры двоичного файла песочницы**: `sandbox.bwrapPath`, `sandbox.socatPath` и `sandbox.ripgrep`. Каждый из этих параметров указывает на исполняемый файл, и Claude Code запускает этот исполняемый файл

270* **Параметры сети и изоляции песочницы**: параметры [песочницы](/docs/ru/sandboxing), которые позволяют прокси песочницы читать, перенаправлять или аутентифицировать трафик, или которые ослабляют изоляцию песочницы: `sandbox.network.tlsTerminate`, `sandbox.network.httpProxyPort`, `sandbox.network.socksProxyPort`, `sandbox.credentials`, `sandbox.allowAppleEvents`, `sandbox.enableWeakerNestedSandbox`, `sandbox.enableWeakerNetworkIsolation`, `sandbox.filesystem.disabled`, `sandbox.network.allowAllUnixSockets`, `sandbox.network.allowUnixSockets` и `sandbox.network.allowMachLookup`. Блок `sandbox.credentials`, содержащий только правила `deny`, не требует одобрения, так как он ограничивает песочницу без предоставления прокси учетных данных. До v2.1.251 Claude Code применял эти параметры без одобрения270* **Параметры сети и изоляции песочницы**: параметры [песочницы](/docs/ru/sandboxing), которые позволяют прокси песочницы читать, перенаправлять или аутентифицировать трафик, или которые ослабляют изоляцию песочницы: `sandbox.network.tlsTerminate`, `sandbox.network.httpProxyPort`, `sandbox.network.socksProxyPort`, `sandbox.credentials`, `sandbox.allowAppleEvents`, `sandbox.enableWeakerNestedSandbox`, `sandbox.enableWeakerNetworkIsolation`, `sandbox.filesystem.disabled`, `sandbox.network.allowAllUnixSockets`, `sandbox.network.allowUnixSockets` и `sandbox.network.allowMachLookup`. Блок `sandbox.credentials`, содержащий только правила `deny`, не требует одобрения, так как он ограничивает песочницу без предоставления прокси учетных данных. До v2.1.251 Claude Code применял эти параметры без одобрения

271* **Пользовательские переменные окружения**: доставленные переменные `env`, требующие одобрения пользователя, такие как переменные прокси и базового URL; см. [Переменные окружения и диалог одобрения](#environment-variables-and-the-approval-dialog)271* **Пользовательские переменные окружения**: доставленные переменные `env`, требующие одобрения пользователя, такие как переменные прокси и базового URL; см. [Переменные окружения и диалог одобрения](#environment-variables-and-the-approval-dialog)

272* **Конфигурации hooks**: любое определение hooks272* **Конфигурации hooks**: любое определение hooks

273 273 

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

275 275 

276Управляемый CLAUDE.md, доставленный через ключ [`claudeMd`](/docs/ru/settings-reference#claudemd), не требует одобрения, потому что это текст инструкций для Claude, а не команда, которую запускает Claude Code. Claude Code все еще проверяет [разрешения](/docs/ru/permissions) для инструментов, которые Claude использует при следовании этим инструкциям. До v2.1.260 значение `claudeMd` требовало одобрения.276Управляемый CLAUDE.md, доставленный через ключ [`claudeMd`](/docs/ru/settings-reference#claudemd), не требует одобрения, потому что это текст инструкций для Claude, а не команда, которую запускает Claude Code. Claude Code все еще проверяет [разрешения](/docs/ru/permissions) для инструментов, которые Claude использует при следовании этим инструкциям. До v2.1.260 значение `claudeMd` также требовало одобрения.

277 277 

278<h4 id="approval-memory">278<h4 id="approval-memory">

279 Память одобрения279 Память одобрения

280</h4>280</h4>

281 281 

282Claude Code записывает ваше одобрение в каталог конфигурации, `~/.claude`, если вы не установили [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars). То, что оно записывает, зависит от учетных данных, которые использует выборка параметров:282Claude Code записывает ваше одобрение в каталог конфигурации, `~/.claude`, если вы не установили [`CLAUDE_CONFIG_DIR`](/docs/ru/env-vars). Что он записывает, зависит от учетных данных, которые использует выборка параметров:

283 283 

284* **Вход claude.ai, сохраненный `/login` или `claude auth login`, или [вход в консоль без ключа](/docs/ru/authentication#sign-in-without-an-api-key)**: одно одобрение на организацию, удерживаемое учетной записью, которая одобрила последней.284* **Вход claude.ai, сохраненный `/login` или `claude auth login`, или [вход в консоль без ключа](/docs/ru/authentication#sign-in-without-an-api-key)**: одно одобрение на организацию, удерживаемое учетной записью, которая одобрила последней.

285* **Вход через [шлюз приложений Claude](/docs/ru/claude-apps-gateway)**: одно одобрение на шлюз.285* **Вход [шлюза приложений Claude](/docs/ru/claude-apps-gateway)**: одно одобрение на шлюз.

286 286 

287 Если вы выходите и снова входите в тот же шлюз, Claude Code не показывает диалог снова, пока параметры, требующие одобрения, не изменятся. Claude Code показывает его снова, когда эти параметры изменяются, когда вы входите в другой шлюз и когда вы принимаете новый сертификат для того же шлюза.287 Если вы выходите и снова входите в тот же шлюз, Claude Code не показывает диалог снова, пока параметры, требующие одобрения, не изменятся. Claude Code показывает его снова, когда эти параметры изменяются, когда вы входите в другой шлюз и когда вы принимаете новый сертификат для того же шлюза.

288 288 

289 Claude Code не сохраняет одобрение для шлюза разработки обратной связи, доступного по простому HTTP, поэтому диалог появляется снова после каждого входа.289 Claude Code не сохраняет одобрение для шлюза разработки обратной связи, доступного через простой HTTP, поэтому диалог появляется снова после каждого входа.

290* **Любые другие учетные данные**, такие как ключ API или `CLAUDE_CODE_OAUTH_TOKEN`: одно одобрение для доставленных параметров, сохраняемое с кэшированной копией параметров в этом каталоге конфигурации. Claude Code показывает диалог снова, когда параметры, требующие одобрения, изменяются, и после запуска `/logout` или `claude auth logout`, любой из которых удаляет кэшированную копию.290* **Любые другие учетные данные**, такие как ключ API или `CLAUDE_CODE_OAUTH_TOKEN`: одно одобрение для доставленных параметров, сохраняемое с кэшированной копией параметров в этом каталоге конфигурации. Claude Code показывает диалог снова, когда параметры, требующие одобрения, изменяются, и после запуска `/logout` или `claude auth logout`, каждый из которых удаляет кэшированную копию.

291 291 

292Одобрение для `sandbox.credentials` или `sandbox.network.tlsTerminate` также охватывает записи [`sandbox.network.allowedDomains`](/docs/ru/settings-reference#sandbox-network-alloweddomains) в этих же доставленных параметрах, потому что оба параметра действуют на этот список разрешений. Диалог появляется снова, когда ваш администратор добавляет или удаляет одну из этих записей, даже хотя `sandbox.network.allowedDomains` не требует одобрения сам по себе.292Одобрение для `sandbox.credentials` или `sandbox.network.tlsTerminate` также охватывает записи [`sandbox.network.allowedDomains`](/docs/ru/settings-reference#sandbox-network-alloweddomains) в этих же доставленных параметрах, потому что оба параметра действуют на этот список разрешений. Диалог появляется снова, когда ваш администратор добавляет или удаляет одну из этих записей, даже хотя `sandbox.network.allowedDomains` не требует одобрения сам по себе.

293 293 

299Claude Code не всегда может показать диалог. Каждый случай ниже указывает, какие параметры применяются, когда он не может, и когда вы снова видите диалог:299Claude Code не всегда может показать диалог. Каждый случай ниже указывает, какие параметры применяются, когда он не может, и когда вы снова видите диалог:

300 300 

301* **Интерактивный сеанс, который не может показать диалог**: Claude Code не применяет доставленные параметры и сохраняет последние одобренные параметры. Диалог появляется в следующем сеансе, который может его показать. Требуется Claude Code v2.1.211 или более поздняя версия.301* **Интерактивный сеанс, который не может показать диалог**: Claude Code не применяет доставленные параметры и сохраняет последние одобренные параметры. Диалог появляется в следующем сеансе, который может его показать. Требуется Claude Code v2.1.211 или более поздняя версия.

302* **`claude install` или `claude update`**: Claude Code не показывает диалог во время любой команды. Команда запускается с последними одобренными параметрами, и диалог появляется в вашем следующем интерактивном сеансе. Если Claude Code ждет выборки параметров при запуске, такой как с установленным [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) или при развертывании [шлюза приложений Claude](/docs/ru/claude-apps-gateway), он показывает диалог во время команды вместо этого, и запуск установки из трубы не удается; см. [`Raw mode is not supported` during install](/docs/ru/troubleshoot-install#raw-mode-is-not-supported-during-install). До v2.1.246 Claude Code пытался показать диалог во время этих команд тоже.302* **`claude install` или `claude update`**: Claude Code не показывает диалог во время любой команды. Команда запускается с последними одобренными параметрами, и диалог появляется в вашем следующем интерактивном сеансе. Если Claude Code ждет выборки параметров при запуске, например с установленным [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) или при развертывании [шлюза приложений Claude](/docs/ru/claude-apps-gateway), он показывает диалог во время команды вместо этого, и запуск установки из трубы не удается; см. [`Raw mode is not supported` during install](/docs/ru/troubleshoot-install#raw-mode-is-not-supported-during-install). До v2.1.246 Claude Code пытался показать диалог во время этих команд тоже.

303* **Ошибка закрывает диалог перед ответом**: Claude Code не применяет доставленные параметры и сохраняет последние одобренные параметры. Он показывает диалог снова в следующем сеансе, который может его показать.303* **Ошибка закрывает диалог перед вашим ответом**: Claude Code не применяет доставленные параметры и сохраняет последние одобренные параметры. Он показывает диалог снова в следующем сеансе, который может его показать.

304* **Неинтерактивный запуск**, такой как `claude -p` или сеанс Agent SDK: Claude Code не может показать диалог, поэтому когда доставленные параметры требуют одобрения, он применяет их только для этого запуска. Он не записывает их как одобренные и не записывает их в [локальный кэш](#fetch-and-caching-behavior), и следующий интерактивный сеанс показывает диалог. До тех пор, пока пользователь не одобрит в интерактивном сеансе, каждый неинтерактивный запуск выбирает параметры снова при запуске. До v2.1.207 неинтерактивный запуск сохранял параметры как одобренные, поэтому более поздние интерактивные сеансы никогда не показывали для них диалог.304* **Неинтерактивный запуск**, такой как `claude -p` или сеанс Agent SDK: Claude Code не может показать диалог, поэтому когда доставленные параметры требуют одобрения, он применяет их только для этого запуска. Он не записывает их как одобренные и не записывает их в [локальный кэш](#fetch-and-caching-behavior), и следующий интерактивный сеанс показывает диалог. До одобрения пользователем в интерактивном сеансе каждый неинтерактивный запуск выполняет выборку параметров снова при запуске. До v2.1.207 неинтерактивный запуск сохранял параметры как одобренные, поэтому более поздние интерактивные сеансы никогда не показывали диалог для них.

305 305 

306<h4 id="environment-variables-and-the-approval-dialog">306<h4 id="environment-variables-and-the-approval-dialog">

307 Переменные окружения и диалог одобрения307 Переменные окружения и диалог одобрения

310Claude Code применяет некоторые доставленные переменные `env` без показа пользователю диалога одобрения, включая:310Claude Code применяет некоторые доставленные переменные `env` без показа пользователю диалога одобрения, включая:

311 311 

312* Переключатели функций и команд312* Переключатели функций и команд

313* Выбор модели и параметры поведения, такие как `ANTHROPIC_MODEL`, `DISABLE_PROMPT_CACHING` и `CLAUDE_CODE_EFFORT_LEVEL`313* Параметры выбора и поведения модели, такие как `ANTHROPIC_MODEL`, `DISABLE_PROMPT_CACHING` и `CLAUDE_CODE_EFFORT_LEVEL`

314* Параметры окна контекста и компактности, такие как `DISABLE_AUTO_COMPACT`314* Параметры окна контекста и компактности, такие как `DISABLE_AUTO_COMPACT`

315* Параметры пользовательского интерфейса терминала и доступности315* Параметры пользовательского интерфейса терминала и доступности

316* Числовые ограничения, бюджеты и тайм-ауты316* Числовые ограничения, бюджеты и тайм-ауты

321 321 

322Claude Code также решает, требует ли [`API_FORCE_IDLE_TIMEOUT`](/docs/ru/env-vars) одобрения по доставленному значению: истинное значение только включает [тайм-аут простоя тела](/docs/ru/network-config#streaming-idle-watchdogs), поэтому Claude Code применяет его без запроса пользователя. Для любого другого непустого значения Claude Code показывает диалог. До v2.1.248 любое непустое значение вызывало диалог.322Claude Code также решает, требует ли [`API_FORCE_IDLE_TIMEOUT`](/docs/ru/env-vars) одобрения по доставленному значению: истинное значение только включает [тайм-аут простоя тела](/docs/ru/network-config#streaming-idle-watchdogs), поэтому Claude Code применяет его без запроса пользователя. Для любого другого непустого значения Claude Code показывает диалог. До v2.1.248 любое непустое значение вызывало диалог.

323 323 

324Требует ли [`ANTHROPIC_CUSTOM_HEADERS`](/docs/ru/env-vars#variables) одобрения, также зависит от доставленного значения. Заголовки, которые только помечают запросы, такие как `Accept-Language`, применяются без диалога. Строка, которая называет учетные данные, селектор организации или клиента, переопределение маршрутизации или хоста или заголовок поведения API, такой как `Authorization`, `X-Api-Key`, `Host`, `anthropic-beta` или заголовки `X-Amzn-Bedrock-*`, требует одобрения. Также требует одобрения строка, чье имя не является допустимым токеном заголовка HTTP, или чье значение содержит символ, который заголовок HTTP не может нести. Проверка совпадает со словами внутри имени заголовка, поэтому `X-Client-Version`, которое содержит `client` и `version`, требует одобрения тоже. До v2.1.251 любое значение `ANTHROPIC_CUSTOM_HEADERS` применялось без него.324Требует ли [`ANTHROPIC_CUSTOM_HEADERS`](/docs/ru/env-vars#variables) одобрения, также зависит от доставленного значения. Заголовки, которые только помечают запросы, такие как `Accept-Language`, применяются без диалога. Строка, которая называет учетные данные, селектор организации или клиента, переменную маршрутизации или переопределения хоста, или заголовок поведения API, такой как `Authorization`, `X-Api-Key`, `Host`, `anthropic-beta` или заголовки `X-Amzn-Bedrock-*`, требует одобрения. Строка также требует одобрения, когда ее имя не является действительным токеном заголовка HTTP или ее значение содержит символ, который заголовок HTTP не может нести. Проверка совпадает со словами внутри имени заголовка, поэтому `X-Client-Version`, которая содержит `client` и `version`, также требует одобрения. До v2.1.251 любое значение `ANTHROPIC_CUSTOM_HEADERS` применялось без него.

325 325 

326Ложное значение, такое как `0` или `false`, для [`ENABLE_BETA_TRACING_DETAILED`](/docs/ru/env-vars#variables) или [`OTEL_LOG_RAW_API_BODIES`](/docs/ru/env-vars#variables), применяется без диалога, потому что оно только отключает детальную трассировку или захват тела сырого API. Любое другое непустое значение для любой переменной требует одобрения.326Ложное значение, такое как `0` или `false`, для [`ENABLE_BETA_TRACING_DETAILED`](/docs/ru/env-vars#variables) или [`OTEL_LOG_RAW_API_BODIES`](/docs/ru/env-vars#variables), применяется без диалога, потому что оно только отключает детальную трассировку или захват тела сырого API. Любое другое непустое значение для любой переменной требует одобрения.

327 327 

sessions.md +23 −17

Details

120| `/resume <name>` | Возобновляет напрямую | Сообщает об ошибке; запустите `/resume` без аргументов, чтобы открыть средство выбора сеансов |120| `/resume <name>` | Возобновляет напрямую | Сообщает об ошибке; запустите `/resume` без аргументов, чтобы открыть средство выбора сеансов |

121 121 

122<h2 id="name-your-sessions">122<h2 id="name-your-sessions">

123 Именование ваших сеансов123 Назовите ваши сессии

124</h2>124</h2>

125 125 

126Дайте сеансам описательные имена, чтобы их можно было найти в средстве выбора сеансов и возобновить по имени. Это особенно важно, когда вы работаете над несколькими задачами параллельно.126Дайте сессиям описательные имена, чтобы их было легко найти в средстве выбора сессий и возобновить по имени. Это особенно важно, когда вы работаете над несколькими задачами параллельно.

127 127 

128| Когда | Как установить имя |128| Когда | Как установить имя |

129| :--------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |129| :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

130| При запуске | `claude -n auth-refactor` |130| При запуске | `claude -n auth-refactor` |

131| Во время сеанса | `/rename auth-refactor`. Имя также отображается на панели подсказок |131| Во время сессии | `/rename auth-refactor`. Имя также отображается на панели подсказок |

132| Из средства выбора сеансов | Выделите сеанс и нажмите `Ctrl+R` |132| Из средства выбора сессий | Выделите сессию и нажмите `Ctrl+R` |

133| При принятии плана | Принятие плана в [режиме плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) дает сеансу сгенерированное название на основе плана, если вы ещё не установили имя |133| При принятии плана | Принятие плана в [режиме плана](/docs/ru/permission-modes#analyze-before-you-edit-with-plan-mode) дает сессии сгенерированное название на основе плана, если вы еще не назвали её |

134| Из claude.ai или приложения Claude | Переименуйте [сеанс удаленного управления](/docs/ru/remote-control#connect-from-another-device); Claude Code применяет то же имя в CLI. Требуется Claude Code v2.1.221 или более поздняя версия |134| Из claude.ai или приложения Claude | Переименуйте [сессию удаленного управления](/docs/ru/remote-control#connect-from-another-device); Claude Code применяет то же имя в CLI. Требуется Claude Code v2.1.221 или позже |

135| Из приложения для рабочего стола | Переименуйте сеанс в [приложении для рабочего стола](/docs/ru/desktop#work-in-parallel-with-sessions) |135| Из приложения для рабочего стола | Переименуйте сессию в [приложении для рабочего стола](/docs/ru/desktop#work-in-parallel-with-sessions) |

136 136 

137После того как вы назовете сеанс через маршрут CLI или из claude.ai, вернитесь к нему с помощью `claude --resume <name>` или `/resume <name>`; сеанс приложения для рабочего стола возобновляется в приложении, которое ведет собственную историю сеансов. См. [Возобновление сеанса](#resume-a-session) для информации о том, как разрешение имён работает в worktrees.137После того как вы назовете сессию через маршрут CLI или из claude.ai, вернитесь к ней с помощью `claude --resume <name>` или `/resume <name>`; сессия приложения для рабочего стола возобновляется в приложении, которое ведет свою собственную историю сессий. Смотрите [Возобновить сессию](#resume-a-session), чтобы узнать, как разрешение имен работает в worktrees.

138 138 

139Когда вы запускаете или возобновляете интерактивный сеанс с именем, которое уже использует другой активный сеанс на этой машине, или переименовываете сеанс в такое имя, Claude Code оставляет имя с сеансом, который его уже имеет, переименовывает ваш в вариант с двусловным суффиксом, например `auth-refactor-graceful-unicorn`, и сообщает вам об этом. Запустите `/rename` с новым именем, если вы предпочитаете выбрать его самостоятельно. До версии v2.1.232 оба сеанса сохраняли имя.139Когда вы запускаете или возобновляете интерактивную сессию с именем, которое уже использует другая активная сессия на этой машине, или переименовываете сессию в такое имя, Claude Code оставляет имя с сессией, которая его уже имеет, переименовывает вашу в вариант с двусловным суффиксом, например `auth-refactor-graceful-unicorn`, и сообщает вам об этом. Запустите `/rename` с новым именем, если вы предпочитаете выбрать его сами. До версии v2.1.232 обе сессии сохраняли имя.

140 140 

141В трех случаях Claude Code не переименовывает дубликат, поэтому вы все еще можете видеть два сеанса с одинаковым именем в списках:141В трех случаях Claude Code не переименовывает дубликат, поэтому вы все еще можете видеть две сессии с одинаковым именем в списках:

142 142 

143* Он не проверяет названия, сгенерированные ИИ, или имена отображения по умолчанию.143* Он не проверяет сгенерированные AI названия или имена отображения по умолчанию.

144* Он не проверяет `--name` [фонового](/docs/ru/agent-view#from-your-shell) или `-p` сеанса при запуске.144* Он не проверяет `--name` [фоновой](/docs/ru/agent-view#from-your-shell) или `-p` сессии при запуске.

145* Он не может переименовать сеанс в более ранней версии Claude Code.145* Он не может переименовать сессию в более ранней версии Claude Code.

146 146 

147Сеансы, которые вы не называете, все еще получают два ярлыка, которые назначает Claude Code. Только сгенерированное название работает как дескриптор возобновления:147Сессии, которые вы не назвали, все еще получают два ярлыка, которые назначает Claude Code. Только сгенерированное название работает как дескриптор возобновления:

148 148 

149* Имя отображения по умолчанию: интерактивные сеансы, которые вы никогда не называете, все еще получают имя отображения по умолчанию при запуске. Требуется Claude Code v2.1.196 или более поздняя версия. По умолчанию используется комбинация имени рабочего каталога с двухсимвольным суффиксом, например `my-app-3f`, и идентифицирует сеанс в списках запущенных сеансов, таких как [представление агента](/docs/ru/agent-view) и вывод `claude agents --json`. По умолчанию это не дескриптор возобновления. Если вы передадите его в `claude --resume` или `/resume`, Claude Code не найдет сеанс. Именование сеанса заменяет значение по умолчанию в этих списках, как и принятие плана.149* Имя отображения по умолчанию: интерактивные сессии, которые вы никогда не назвали, все еще получают имя отображения по умолчанию при запуске. Требуется Claude Code v2.1.196 или позже. Значение по умолчанию объединяет имя рабочего каталога с двухсимвольным суффиксом, например `my-app-3f`, и идентифицирует сессию в списках запущенных сессий, таких как [представление агента](/docs/ru/agent-view) и вывод `claude agents --json`. Значение по умолчанию не является дескриптором возобновления. Если вы передадите его в `claude --resume` или `/resume`, Claude Code не найдет сессию. Именование сессии заменяет значение по умолчанию в этих списках, как и принятие плана.

150* Сгенерированное название: если вы не называете сеанс, Claude Code генерирует для него название сеанса. Название — это краткое резюме вашего первого запроса, написанное фоновым запросом к небольшой/быстрой модели, обычно модели класса Haiku. Принятие плана заменяет его названием на основе плана. Именование сеанса заменяет сгенерированное название. Вы видите название первого запроса в [средстве выбора сеансов](#use-the-session-picker) и в поле [`session_name`](/docs/ru/statusline) строки состояния, когда имя не установлено. Название плана отображается в тех же двух местах, а также в списках запущенных сеансов, где оно занимает место имени отображения по умолчанию. Вы можете передать любое название в `claude --resume` или `/resume`, и Claude Code разрешит его так же, как имя, которое вы установили.150* Сгенерированное название: если вы не назовете сессию, Claude Code генерирует для неё название сессии. Название — это краткое резюме вашей первой подсказки, написанное фоновым запросом к небольшой/быстрой модели, обычно модели класса Haiku. Запуск `claude -p`, который вы запускаете непосредственно из оболочки или скрипта, не получает его.

151 

152 Принятие плана заменяет название первой подсказки на название на основе плана. Именование сессии также его заменяет.

153 

154 Вы видите название первой подсказки в [средстве выбора сессий](#use-the-session-picker) и в поле [`session_name`](/docs/ru/statusline) строки состояния, когда имя не установлено. Название плана отображается в тех же двух местах, а также в списках запущенных сессий, где оно занимает место имени отображения по умолчанию.

155 

156 Вы можете передать любое название в `claude --resume` или `/resume`, и Claude Code разрешит его так же, как имя, которое вы установили.

151 157 

152<h2 id="use-the-session-picker">158<h2 id="use-the-session-picker">

153 Использование средства выбора сеансов159 Использование средства выбора сеансов

settings.md +3 −3

Details

468 Держите личные параметры вне репозитория468 Держите личные параметры вне репозитория

469</h3>469</h3>

470 470 

471Чтобы изменить параметр для себя в одном проекте без изменения его для товарищей по команде, сохраните его в `.claude/settings.local.json` внутри проекта. Claude Code применяет этот файл поверх зафиксированного `.claude/settings.json`, поэтому если файл вашей команды устанавливает `"model": "claude-sonnet-5"` и вы хотите Opus, поместите `"model": "claude-opus-4-8"` в ваш локальный файл и только ваши сеансы изменятся.471Чтобы изменить параметр для себя в одном проекте без изменения его для товарищей по команде, сохраните его в `.claude/settings.local.json` внутри проекта. Claude Code применяет этот файл поверх зафиксированного `.claude/settings.json`, поэтому если файл вашей команды устанавливает `"model": "claude-sonnet-5"` и вы хотите Opus, поместите `"model": "claude-opus-5-5"` в ваш локальный файл и только ваши сеансы изменятся.

472 472 

473Claude Code также записывает в этот файл, держит его вне ваших коммитов и применяет его правила разрешений без шага доверия:473Claude Code также записывает в этот файл, держит его вне ваших коммитов и применяет его правила разрешений без шага доверия:

474 474 

598Например, чтобы запустить один сеанс на Opus без изменения вашего значения по умолчанию:598Например, чтобы запустить один сеанс на Opus без изменения вашего значения по умолчанию:

599 599 

600```bash theme={null}600```bash theme={null}

601claude --settings '{"model": "claude-opus-4-8"}'601claude --settings '{"model": "claude-opus-5-5"}'

602```602```

603 603 

604<h3 id="when-edits-take-effect">604<h3 id="when-edits-take-effect">

803 803 

804[Облачный сеанс](/docs/ru/claude-code-on-the-web) работает в [облачной среде](/docs/ru/cloud-environments) на свежем клоне вашего репозитория, не на вашей машине. Это изменяет, какие параметры его достигают:804[Облачный сеанс](/docs/ru/claude-code-on-the-web) работает в [облачной среде](/docs/ru/cloud-environments) на свежем клоне вашего репозитория, не на вашей машине. Это изменяет, какие параметры его достигают:

805 805 

806* **Общие параметры проекта** (`.claude/settings.json`): читаются в сеансе с одним репозиторием, потому что файл является частью клона и сеанс начинается внутри него. Зафиксируйте параметр там, чтобы применить его в этих сеансах. Сеанс с несколькими репозиториями начинается выше клонов, поэтому из файла `.claude/settings.json` каждого репозитория он загружает только плагины и маркетплейсы, которые файл объявляет, но не правила разрешений, hooks, `env` или другие ключи; см. [Что переносится из вашей установки](/docs/ru/cloud-environments#what-carries-over-from-your-setup).806* **Общие параметры проекта** (`.claude/settings.json`): читаются в сеансе с одним репозиторием, потому что файл является частью клона и сеанс начинается внутри него. Зафиксируйте параметр там, чтобы применить его в этих сеансах. Сеанс с несколькими репозиториями начинается выше клонов и читает только ключи `enabledPlugins` и `extraKnownMarketplaces` из файла `.claude/settings.json` каждого репозитория, но не правила разрешений, hooks, `env` или другие ключи. Маркетплейсы и плагины, которые эти два ключа объявляют, по-прежнему [не загружаются в облачном сеансе](/docs/ru/cloud-environments#what-carries-over-from-your-setup).

807* **Параметры пользователя и локальные параметры проекта** (`~/.claude/settings.json` и `.claude/settings.local.json`): не читаются. Оба остаются на вашей машине, и локальный файл не находится в клоне.807* **Параметры пользователя и локальные параметры проекта** (`~/.claude/settings.json` и `.claude/settings.local.json`): не читаются. Оба остаются на вашей машине, и локальный файл не находится в клоне.

808* **Managed settings**: только [параметры, управляемые сервером](/docs/ru/server-managed-settings) достигают облачного сеанса; файл `managed-settings.json` или профиль MDM на вашем устройстве не достигают. [Самостоятельно размещенная среда](/docs/ru/self-hosted-environments) также читает файл управляемых параметров в образе своего runner. [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) говорит, когда этот файл применяется.808* **Managed settings**: только [параметры, управляемые сервером](/docs/ru/server-managed-settings) достигают облачного сеанса; файл `managed-settings.json` или профиль MDM на вашем устройстве не достигают. [Самостоятельно размещенная среда](/docs/ru/self-hosted-environments) также читает файл управляемых параметров в образе своего runner. [Как Claude Code объединяет управляемые источники](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) говорит, когда этот файл применяется.

809* **`/config`**: в вашем браузере на claude.ai/code открывает раздел Claude Code ваших параметров claude.ai вместо изменения значения. Чтобы изменить параметр для облачного сеанса, установите [переменную окружения](/docs/ru/cloud-environments#set-environment-variables) в среде или в сеансе с одним репозиторием зафиксируйте ключ в файле `.claude/settings.json` этого репозитория.809* **`/config`**: в вашем браузере на claude.ai/code открывает раздел Claude Code ваших параметров claude.ai вместо изменения значения. Чтобы изменить параметр для облачного сеанса, установите [переменную окружения](/docs/ru/cloud-environments#set-environment-variables) в среде или в сеансе с одним репозиторием зафиксируйте ключ в файле `.claude/settings.json` этого репозитория.

Details

29 ```json ~/.claude/settings.json theme={null}29 ```json ~/.claude/settings.json theme={null}

30 {30 {

31 "model": "claude-sonnet-5",31 "model": "claude-sonnet-5",

32 "effortLevel": "xhigh",32 "modelSettings": {

33 "claude-sonnet-5": { "effortLevel": "xhigh" }

34 },

33 "editorMode": "vim",35 "editorMode": "vim",

34 "theme": "light-daltonized",36 "theme": "light-daltonized",

35 "statusLine": {37 "statusLine": {

58 {60 {

59 // Начинайте каждый сеанс на Sonnet 561 // Начинайте каждый сеанс на Sonnet 5

60 "model": "claude-sonnet-5",62 "model": "claude-sonnet-5",

61 // Рассуждайте глубже, чем уровень по умолчанию на моделях без сохраненного уровня; /effort сохраняет уровень для каждой модели, а --effort устанавливает уровень для одного сеанса63 // Запускайте Sonnet 5 выше его уровня по умолчанию; /effort сохраняет уровень для каждой модели, а --effort устанавливает уровень для одного сеанса

62 "effortLevel": "xhigh",64 "modelSettings": {

65 "claude-sonnet-5": { "effortLevel": "xhigh" }

66 },

63 // Сочетания клавиш Vim в приглашении67 // Сочетания клавиш Vim в приглашении

64 "editorMode": "vim",68 "editorMode": "vim",

65 // Светлая тема, удобная для дальтоников69 // Светлая тема, удобная для дальтоников

Details

685| [`hooks`](#hooks) | Запускайте свои собственные команды как [hooks](/docs/ru/hooks) в точках жизненного цикла Claude Code | Hooks and automation | Any file |685| [`hooks`](#hooks) | Запускайте свои собственные команды как [hooks](/docs/ru/hooks) в точках жизненного цикла Claude Code | Hooks and automation | Any file |

686| [`httpHookAllowedEnvVars`](#httphookallowedenvvars) | Ограничьте, какие переменные окружения [HTTP hooks](/docs/ru/hooks) могут помещать в заголовки | Hooks and automation | Any file |686| [`httpHookAllowedEnvVars`](#httphookallowedenvvars) | Ограничьте, какие переменные окружения [HTTP hooks](/docs/ru/hooks) могут помещать в заголовки | Hooks and automation | Any file |

687| [`includeCoAuthoredBy`](#includecoauthoredby) | Устарело; используйте `attribution` для скрытия или изменения атрибуции коммита и PR | Git and attribution | Any file |687| [`includeCoAuthoredBy`](#includecoauthoredby) | Устарело; используйте `attribution` для скрытия или изменения атрибуции коммита и PR | Git and attribution | Any file |

688| [`includeGitInstructions`](#includegitinstructions) | Удалите встроенные инструкции коммита и PR из [системной подсказки](/docs/ru/sub-agents#what-loads-at-startup) | Git and attribution | Any file |688| [`includeGitInstructions`](#includegitinstructions) | Удалите встроенные инструкции коммита и PR из контекста Claude | Git and attribution | Any file |

689| [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Получайте [push-уведомление](/docs/ru/remote-control#mobile-push-notifications), когда Claude ждёт вас | Remote, desktop, and notifications | Any file |689| [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Получайте [push-уведомление](/docs/ru/remote-control#mobile-push-notifications), когда Claude ждёт вас | Remote, desktop, and notifications | Any file |

690| [`isolatePeerMachines`](#isolatepeermachines) | Спросите вас перед тем, как Claude [отправит сообщение одному из ваших сеансов на другой машине](/docs/ru/cross-session-messaging#require-approval-for-cross-machine-messages) | Agents, sessions, and worktrees | Any file |690| [`isolatePeerMachines`](#isolatepeermachines) | Спросите вас перед тем, как Claude [отправит сообщение одному из ваших сеансов на другой машине](/docs/ru/cross-session-messaging#require-approval-for-cross-machine-messages) | Agents, sessions, and worktrees | Any file |

691| [`keybindingFlavor`](#keybindingflavor) | Устарело и не имеет эффекта; сочетания клавиш для редактирования слов всегда [следуют соглашениям readline](/docs/ru/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |691| [`keybindingFlavor`](#keybindingflavor) | Устарело и не имеет эффекта; сочетания клавиш для редактирования слов всегда [следуют соглашениям readline](/docs/ru/interactive-mode#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file |

797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Остановите загрузку [плагинов, включённых в вашу учётную запись claude.ai](/docs/ru/plugins-reference#synced-plugins) и скройте уже синхронизированные | Plugins and skills | User, local, or managed |797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Остановите загрузку [плагинов, включённых в вашу учётную запись claude.ai](/docs/ru/plugins-reference#synced-plugins) и скройте уже синхронизированные | Plugins and skills | User, local, or managed |

798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Остановите загрузку [навыков, включённых в вашу учётную запись claude.ai](/docs/ru/skills#how-synced-skills-behave) и скройте уже синхронизированные | Plugins and skills | User, local, or managed |798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | Остановите загрузку [навыков, включённых в вашу учётную запись claude.ai](/docs/ru/skills#how-synced-skills-behave) и скройте уже синхронизированные | Plugins and skills | User, local, or managed |

799| [`syntaxHighlightingDisabled`](#syntaxhighlightingdisabled) | Отключите выделение синтаксиса в дифах и блоках кода | Interface and terminal | Any file |799| [`syntaxHighlightingDisabled`](#syntaxhighlightingdisabled) | Отключите выделение синтаксиса в дифах и блоках кода | Interface and terminal | Any file |

800| [`taskOutputMaxChars`](#taskoutputmaxchars) | Установите, сколько [вывода фоновой задачи](/docs/ru/tools-reference#background-commands) Claude получает встроенным образом | Memory and context | Any file |800| [`taskOutputMaxChars`](#taskoutputmaxchars) | Удалено в v2.1.277 вместе с инструментом `TaskOutput`, который оно определяло | Memory and context | Any file |

801| [`teammateDefaultModel`](#teammatedefaultmodel) | Удалено в v2.1.234; см. [Укажите товарищей по команде и модели](/docs/ru/agent-teams#specify-teammates-and-models) для того, как Claude Code выбирает модель товарища по команде | Global config settings | Global config |801| [`teammateDefaultModel`](#teammatedefaultmodel) | Удалено в v2.1.234; см. [Укажите товарищей по команде и модели](/docs/ru/agent-teams#specify-teammates-and-models) для того, как Claude Code выбирает модель товарища по команде | Global config settings | Global config |

802| [`teammateMode`](#teammatemode) | Выберите, как [товарищи по команде агентов отображаются](/docs/ru/agent-teams#choose-a-display-mode) | Agents, sessions, and worktrees | Any file |802| [`teammateMode`](#teammatemode) | Выберите, как [товарищи по команде агентов отображаются](/docs/ru/agent-teams#choose-a-display-mode) | Agents, sessions, and worktrees | Any file |

803| [`terminalProgressBarEnabled`](#terminalprogressbarenabled) | Скройте полосу прогресса терминала в терминалах, которые её поддерживают | Interface and terminal | Any file |803| [`terminalProgressBarEnabled`](#terminalprogressbarenabled) | Скройте полосу прогресса терминала в терминалах, которые её поддерживают | Interface and terminal | Any file |

840Если ваша учётная запись требует [согласия на использование кредитов](/docs/ru/advisor#fable-advisor-and-usage-credits), сначала примите его, запустив `/model fable`. До этого выбор Fable в `/advisor` ничего не сохраняет, и Claude Code говорит вам запустить `/model fable` сначала.840Если ваша учётная запись требует [согласия на использование кредитов](/docs/ru/advisor#fable-advisor-and-usage-credits), сначала примите его, запустив `/model fable`. До этого выбор Fable в `/advisor` ничего не сохраняет, и Claude Code говорит вам запустить `/model fable` сначала.

841 841 

842* **Область действия**: [`Any file`](#scopes)842* **Область действия**: [`Any file`](#scopes)

843* **Тип**: строка, один из псевдонимов `"fable"`, `"opus"` или `"sonnet"`, которые разрешаются в текущую версию Claude Code этого семейства моделей по умолчанию, или полный ID модели, такой как `"claude-opus-5"`843* **Тип**: строка, один из псевдонимов `"fable"`, `"opus"` или `"sonnet"`, которые разрешаются в текущую версию Claude Code этого семейства моделей по умолчанию, или полный ID модели, такой как `"claude-opus-5-5"`

844* **По умолчанию**: не установлено, поэтому advisor отключён844* **По умолчанию**: не установлено, поэтому advisor отключён

845* **Переопределения для каждого сеанса**: `--advisor` имеет приоритет над этим ключом для одного сеанса. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/ru/env-vars) отключает advisor, и этот ключ не может его включить обратно845* **Переопределения для каждого сеанса**: `--advisor` имеет приоритет над этим ключом для одного сеанса. [`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`](/docs/ru/env-vars) отключает advisor, и этот ключ не может его включить обратно

846 846 

858 858 

859Отключите [расширенное мышление](/docs/ru/model-config#extended-thinking) для каждого сеанса, установив это значение на `false`. Мышление включено по умолчанию, поэтому `true` ничего не меняет. Большинство людей устанавливают это через `/config` вместо редактирования файла.859Отключите [расширенное мышление](/docs/ru/model-config#extended-thinking) для каждого сеанса, установив это значение на `false`. Мышление включено по умолчанию, поэтому `true` ничего не меняет. Большинство людей устанавливают это через `/config` вместо редактирования файла.

860 860 

861На моделях, которые всегда думают, таких как модели Fable, `false` не имеет эффекта. На [сторонних поставщиках](/docs/ru/third-party-integrations) Claude Code опускает параметр `thinking` вместо отключения мышления, поэтому модели адаптивного рассуждения могут всё ещё думать. При отключении мышления на Anthropic API Claude Code отправляет усилие `high` вместо более высокого уровня моделям, которые, как известно, [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), таким как Opus 5.861На моделях, которые всегда думают, таких как Opus 5.5 и модели Fable, `false` не имеет эффекта. На [сторонних поставщиках](/docs/ru/third-party-integrations) Claude Code опускает параметр `thinking` вместо отключения мышления, поэтому модели адаптивного рассуждения могут всё ещё думать. При отключении мышления на Anthropic API Claude Code отправляет усилие `high` вместо более высокого уровня моделям, которые, как известно, [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), таким как Opus 5.

862 862 

863* **Область действия**: [`Any file`](#scopes)863* **Область действия**: [`Any file`](#scopes)

864* **Тип**: Boolean864* **Тип**: Boolean

903 903 

904В одном файле параметров Claude Code использует сохранённый уровень модели вместо этого ключа. [`modelSettings`](#modelsettings) указывает приоритет между файлами.904В одном файле параметров Claude Code использует сохранённый уровень модели вместо этого ключа. [`modelSettings`](#modelsettings) указывает приоритет между файлами.

905 905 

906В сеансе, подключённом к удалённому рабочему процессу, `/effort` применяется только к этому сеансу. В запуске `-p` или Agent SDK это также применяется только к этому сеансу, [если только не действует удержание на усилии модели по умолчанию](/docs/ru/model-config#non-interactive-effort). [Отрегулируйте уровень усилия](/docs/ru/model-config#adjust-effort-level) перечисляет интерактивные выборы, которые также применяются только к этому сеансу. Сообщение, которое печатает `/effort`, говорит, что произошло.906В сеансе, подключённом к удалённому рабочему процессу, в запуске `-p` и в Agent SDK `/effort` применяется только к этому сеансу. [Отрегулируйте уровень усилия](/docs/ru/model-config#adjust-effort-level) перечисляет интерактивные выборы, которые также применяются только к этому сеансу. Сообщение, которое печатает `/effort`, говорит, что произошло.

907 907 

908* **Область действия**: [`Any file`](#scopes)908* **Область действия**: [`Any file`](#scopes)

909* **Тип**: строка, один из:909* **Тип**: строка, один из:

920}920}

921```921```

922 922 

923На Opus 4.7, Opus 4.8 и Fable 5 Claude Code удерживает усилие этой модели по умолчанию, установленное организацией или встроенное; [Отрегулируйте уровень усилия](/docs/ru/model-config#adjust-effort-level) указывает, какие способы установки уровня заканчивают удержание и какие оставляют его на месте. После того как удержание заканчивается, Claude Code разрешает усилие по приоритету, указанному в [`modelSettings`](#modelsettings).923В вашем файле параметров пользователя, `~/.claude/settings.json`, этот ключ — это более старая форма, которую `/effort` записывал до того, как он сохранял уровни для каждой модели, и он продолжает применяться там, где он применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях. Opus 5.5 и модели, выпущенные после него, игнорируют его и начинают со своего собственного значения по умолчанию, пока вы не сохраните уровень для них, который `/effort` записывает под [`modelSettings`](#modelsettings). В параметрах проекта, локальных и управляемых, а также с `--settings`, этот ключ применяется к каждой модели.

924 924 

925<h3 id="enforceavailablemodels">925<h3 id="enforceavailablemodels">

926 `enforceAvailableModels`926 `enforceAvailableModels`

974 `fastMode`974 `fastMode`

975</h3>975</h3>

976 976 

977Включите [быстрый режим](/docs/ru/fast-mode) для сеансов, где он доступен, для интерактивной работы, такой как быстрая итерация или живая отладка, где вы хотите скорость при более высокой стоимости за токен. Обычно вы не редактируете этот ключ вручную: запуск `/fast` записывает `fastMode: true` в `~/.claude/settings.json`, и запуск его снова, чтобы отключить быстрый режим, удаляет ключ. Быстрый режим работает только на Opus 5 и Opus 4.8: включение его с другой модели переключает вас на Opus, а переключение на неподдерживаемую модель отключает его. См. [Переключайте модели, пока быстрый режим включён](/docs/ru/fast-mode#switch-models-while-fast-mode-is-on).977Включите [быстрый режим](/docs/ru/fast-mode) для сеансов, где он доступен, для интерактивной работы, такой как быстрая итерация или живая отладка, где вы хотите скорость при более высокой стоимости за токен. Обычно вы не редактируете этот ключ вручную: запуск `/fast` записывает `fastMode: true` в `~/.claude/settings.json`, и запуск его снова, чтобы отключить быстрый режим, удаляет ключ. Быстрый режим работает только на Opus 5.5, Opus 5 и Opus 4.8: включение его с другой модели переключает вас на Opus, а переключение на неподдерживаемую модель отключает его. См. [Переключайте модели, пока быстрый режим включён](/docs/ru/fast-mode#switch-models-while-fast-mode-is-on).

978 978 

979* **Область действия**: [`Any file`](#scopes)979* **Область действия**: [`Any file`](#scopes)

980* **Тип**: Boolean980* **Тип**: Boolean

993 `fastModePerSessionOptIn`993 `fastModePerSessionOptIn`

994</h3>994</h3>

995 995 

996Обычно запуск `/fast` сохраняет [`fastMode`](#fastmode) в параметры пользователя человека, поэтому быстрый режим включён в начале каждого последующего сеанса. Установите этот ключ на `true`, чтобы остановить это: сохранённый `fastMode: true` больше не включает быстрый режим в начале сеанса, и каждый человек должен запустить `/fast` в каждом сеансе, в котором они его хотят. Claude Code оставляет ключ `fastMode` в их файле, поэтому отключение этого ключа восстанавливает старое поведение. Владельцы планов Team или Enterprise могут развернуть его организационно через [параметры, управляемые сервером](/docs/ru/server-managed-settings).996Обычно запуск `/fast` сохраняет [`fastMode`](#fastmode) в параметры пользователя человека, поэтому быстрый режим включён в начале каждого последующего сеанса. Установите этот ключ на `true`, чтобы остановить это: сохранённый `fastMode: true` больше не включает быстрый режим в начале сеанса, и каждый человек должен запустить `/fast` в каждом сеансе, в котором они его хотят. Claude Code оставляет ключ `fastMode` в их файле, поэтому отключение этого ключа восстанавливает старое поведение.

997 

998Владельцы планов Team или Enterprise могут развернуть его организационно через [параметры, управляемые сервером](/docs/ru/server-managed-settings). Когда управляемые параметры устанавливают ключ, `/fast on` отклоняется вне интерактивных сеансов терминала и сообщает, что ваша организация отключила быстрый режим. Это охватывает [неинтерактивный режим](/docs/ru/headless), [расширение VS Code](/docs/ru/vs-code) и [облачные сеансы](/docs/ru/claude-code-on-the-web).

997 999 

998* **Область действия**: [`Any file`](#scopes)1000* **Область действия**: [`Any file`](#scopes)

999* **Тип**: Boolean1001* **Тип**: Boolean

1208 `modelSettings`1210 `modelSettings`

1209</h3>1211</h3>

1210 1212 

1211Сохраните [уровень усилия](/docs/ru/model-config#adjust-effort-level) для каждой модели, которую вы используете. В интерактивном сеансе на вашей машине, когда вы сохраняете `low`, `medium`, `high` или `xhigh` как свой уровень по умолчанию с помощью `/effort` или ползунка усилия средства выбора `/model`, Claude Code записывает этот уровень здесь под моделью, которую вы используете, поэтому вы редко редактируете этот ключ самостоятельно. Запись [`effortLevel`](#effortlevel) перечисляет сеансы, где `/effort` применяется только к этому сеансу. Требует Claude Code версии 2.1.251 или позже.1213Сохраните [уровень усилия](/docs/ru/model-config#adjust-effort-level) для каждой модели, которую вы используете. Требует Claude Code версии 2.1.251 или позже.

1214 

1215В интерактивном сеансе на вашей машине, когда вы сохраняете `low`, `medium`, `high` или `xhigh` как свой уровень по умолчанию с помощью `/effort` или ползунка усилия средства выбора `/model`, Claude Code записывает этот уровень здесь под моделью, которую вы используете, поэтому вы редко редактируете этот ключ самостоятельно. Когда вы выбираете один из этих уровней в [средстве выбора модели расширения VS Code](/docs/ru/vs-code#use-the-prompt-box), Claude Code сохраняет его здесь таким же образом. Запись [`effortLevel`](#effortlevel) перечисляет сеансы, где `/effort` применяется только к этому сеансу.

1212 1216 

1213Отредактируйте ключ вручную, чтобы изменить или удалить уровень, который вы сохранили.1217Отредактируйте ключ вручную, чтобы изменить или удалить уровень, который вы сохранили.

1214 1218 

1215`effortLevel` модели здесь имеет приоритет над верхним уровнем [`effortLevel`](#effortlevel) в том же файле параметров. Между файлами Claude Code разрешает каждую модель отдельно: файл [параметров](/docs/ru/settings#settings-precedence) с наивысшим приоритетом, который устанавливает либо `effortLevel` для этой модели, либо верхний уровень `effortLevel`, решает, поэтому `effortLevel` в управляемых параметрах превосходит уровень, который вы сохранили в параметрах пользователя. [Отрегулируйте уровень усилия](/docs/ru/model-config#adjust-effort-level) перечисляет, что ещё может переопределить сохранённый уровень, такой как `--effort` при запуске.1219`effortLevel` модели здесь имеет приоритет над верхним уровнем [`effortLevel`](#effortlevel) в том же файле параметров. Между файлами Claude Code разрешает каждую модель отдельно: файл [параметров](/docs/ru/settings#settings-precedence) с наивысшим приоритетом, который устанавливает либо `effortLevel` для этой модели, либо верхний уровень `effortLevel`, который [применяется к этой модели](#effortlevel), решает, поэтому `effortLevel` в управляемых параметрах превосходит уровень, который вы сохранили в параметрах пользователя. [Отрегулируйте уровень усилия](/docs/ru/model-config#adjust-effort-level) перечисляет, что ещё может переопределить сохранённый уровень, такой как `--effort` при запуске.

1216 1220 

1217Чтобы ограничить усилие одной модели вместо установки её уровня, добавьте поле [`maxEffortLevel`](#maxeffortlevel) в запись этой модели. Поле требует Claude Code версии 2.1.267 или позже.1221Чтобы ограничить усилие одной модели вместо установки её уровня, добавьте поле [`maxEffortLevel`](#maxeffortlevel) в запись этой модели. Поле требует Claude Code версии 2.1.267 или позже.

1218 1222 

1220* **Тип**: объект, сопоставляющий имя модели с объектом с полем `effortLevel`, один из `"low"`, `"medium"`, `"high"` или `"xhigh"`, полем [`maxEffortLevel`](#maxeffortlevel) или обоими1224* **Тип**: объект, сопоставляющий имя модели с объектом с полем `effortLevel`, один из `"low"`, `"medium"`, `"high"` или `"xhigh"`, полем [`maxEffortLevel`](#maxeffortlevel) или обоими

1221* **По умолчанию**: не установлено1225* **По умолчанию**: не установлено

1222 1226 

1223Claude Code записывает каждую запись под каноническим именем модели, таким как `claude-opus-5`, и сопоставляет псевдоним этой модели, с датой, `[1m]` и признанные ID, специфичные для поставщика, с той же записью.1227Claude Code записывает каждую запись под каноническим именем модели, таким как `claude-opus-5-5`, и сопоставляет псевдоним этой модели, с датой, `[1m]` и признанные ID, специфичные для поставщика, с той же записью.

1224 1228 

1225Этот пример сохраняет Opus 5 на `medium`, пока другие модели используют свои собственные сохранённые или уровни по умолчанию:1229Этот пример сохраняет Opus 5.5 на `high`, пока другие модели используют свои собственные сохранённые или уровни по умолчанию:

1226 1230 

1227```json settings.json theme={null}1231```json settings.json theme={null}

1228{1232{

1229 "modelSettings": {1233 "modelSettings": {

1230 "claude-opus-5": {1234 "claude-opus-5-5": {

1231 "effortLevel": "medium"1235 "effortLevel": "high"

1232 }1236 }

1233 }1237 }

1234}1238}

1839 `sandbox.excludedCommands`1843 `sandbox.excludedCommands`

1840</h3>1844</h3>

1841 1845 

1842Назовите команды, которые Claude Code всегда выполняет вне песочницы, такие как инструменты, которые не работают под ней. Каждая запись использует тот же синтаксис, что и содержимое правила разрешения `Bash(...)` [permission rule](/docs/ru/permissions#permission-rule-syntax): точная команда, префикс, такой как `docker *`, или шаблон подстановки. Когда любая часть составной команды совпадает с записью, Claude Code выполняет всю команду без изоляции.1846Назовите команды, которые Claude Code выполняет вне песочницы, такие как инструменты, которые не работают под ней. Каждая запись использует тот же синтаксис, что и содержимое правила разрешения `Bash(...)` [permission rule](/docs/ru/permissions#permission-rule-syntax): точная команда, префикс, такой как `docker *`, или шаблон подстановки.

1847 

1848Ваши записи выводят вызов Bash из песочницы только когда они охватывают каждую команду в нем, и некоторые формы вызова остаются изолированными даже тогда. Запись `docker *` одна не выводит `npm ci && docker build .` из песочницы.

1843 1849 

1844* **Scope**: [`Any file`](#scopes)1850* **Scope**: [`Any file`](#scopes)

1845* **Type**: array of command patterns1851* **Type**: array of command patterns

1853}1859}

1854```1860```

1855 1861 

1862Claude Code сохраняет вызов Bash в изоляции, когда он имеет одну из этих форм, среди прочих:

1863 

1864* Команда, начинающаяся с `sudo`, `eval` или `xargs`

1865* `cd`, `pushd` или `popd`, где бы они ни появлялись в вызове

1866* Подстановка команды, подоболочка или блок управления потоком, такой как `if` или `for`

1867* Перенаправление, такое как `docker build . > build.log`, кроме того, которое только дублирует дескриптор файла, как `2>&1`

1868* Имя команды, которое поступает из переменной

1869 

1870Например, `cd build && docker compose up` остается изолированным под записью `docker *`, и добавление записи `cd` это не меняет.

1871 

1856Исключенные команды по-прежнему проходят обычный поток разрешений. Исключение — это удобство, а не граница безопасности: предпочитайте [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite), когда инструменту нужно писать только в определенное место. Claude Code объединяет записи во всех областях параметров, которые загружает сеанс, и нет управляемой блокировки для этого списка, поэтому держите управляемый список узким.1872Исключенные команды по-прежнему проходят обычный поток разрешений. Исключение — это удобство, а не граница безопасности: предпочитайте [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite), когда инструменту нужно писать только в определенное место. Claude Code объединяет записи во всех областях параметров, которые загружает сеанс, и нет управляемой блокировки для этого списка, поэтому держите управляемый список узким.

1857 1873 

1858<h3 id="sandbox-allowunsandboxedcommands">1874<h3 id="sandbox-allowunsandboxedcommands">

3066 `taskOutputMaxChars`3082 `taskOutputMaxChars`

3067</h3>3083</h3>

3068 3084 

3069Установите, сколько символов вывода [фонового задания](/docs/ru/tools-reference#background-commands) Claude получает встроенным образом, когда Claude читает задание с помощью инструмента `TaskOutput`. Когда вывод завершённого задания длиннее, Claude получает самые последние символы. Увеличьте лимит, когда ваши фоновые задания регулярно производят больше вывода, чем значение по умолчанию. Требуется Claude Code v2.1.261 или позже.3085<Warning>

3070 3086 Удалено в v2.1.277 вместе с инструментом `TaskOutput`, который он определял. Установка этого параметра не влияет на текущие версии. Claude читает [файл вывода](/docs/ru/tools-reference#background-commands) фонового задания с помощью `Read` вместо этого.

3071* **Scope**: [`Any file`](#scopes)3087</Warning>

3072* **Type**: количество символов, положительное целое число. Claude Code ограничивает значение диапазоном `4000` на `128000`

3073* **Default**: не установлено, поэтому Claude получает до 32 000 символов встроенным образом

3074 

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

3076{

3077 "taskOutputMaxChars": 100000

3078}

3079```

3080 3088 

3081Когда вы устанавливаете этот ключ, Claude Code игнорирует переменную окружения [`TASK_MAX_OUTPUT_LENGTH`](/docs/ru/env-vars).3089До v2.1.276 вы устанавливали этот ключ на количество символов вывода [фонового задания](/docs/ru/tools-reference#background-commands), которое Claude получал встроенным образом, когда читал задание с помощью инструмента `TaskOutput`.

3082 3090 

3083<h2 id="interface-and-terminal">3091<h2 id="interface-and-terminal">

3084 Интерфейс и терминал3092 Интерфейс и терминал

3994 4002 

3995Чтобы скрыть всю атрибуцию, установите [`commit`](#attribution-commit) и [`pr`](#attribution-pr) в пустые строки и [`sessionUrl`](#attribution-sessionurl) в `false`. После того как вы установите `commit` или `pr`, Claude Code игнорирует устаревший параметр `includeCoAuthoredBy` и использует текст по умолчанию для того из двух, который вы оставили без установки.4003Чтобы скрыть всю атрибуцию, установите [`commit`](#attribution-commit) и [`pr`](#attribution-pr) в пустые строки и [`sessionUrl`](#attribution-sessionurl) в `false`. После того как вы установите `commit` или `pr`, Claude Code игнорирует устаревший параметр `includeCoAuthoredBy` и использует текст по умолчанию для того из двух, который вы оставили без установки.

3996 4004 

4005Claude Code сообщает Claude, что ваши собственные инструкции об атрибуции, такие как CLAUDE.md или правило [memory](/docs/ru/memory), имеют приоритет над этими строками коммита и PR, если только строка не установлена в [управляемых параметрах](/docs/ru/managed-settings).

4006 

3997<h3 id="includecoauthoredby">4007<h3 id="includecoauthoredby">

3998 `includeCoAuthoredBy`4008 `includeCoAuthoredBy`

3999</h3>4009</h3>

4022 `includeGitInstructions`4032 `includeGitInstructions`

4023</h3>4033</h3>

4024 4034 

4025При запуске сеанса Claude Code добавляет две связанные с git части в подсказку Claude: встроенные инструкции по написанию коммитов и pull request'ов в описании инструмента Bash и снимок состояния git вашего репозитория в системной подсказке, что означает текущую ветку, основную ветку, вывод `git status` и недавние коммиты. Установите этот ключ в `false`, чтобы исключить оба, например когда вы используете свои собственные skills рабочего процесса git.4035Claude Code предоставляет Claude две связанные с git части контекста: встроенные инструкции по написанию коммитов и pull request'ов в описании инструмента Bash и снимок состояния git вашего репозитория. Снимок содержит текущую ветку, основную ветку, вывод `git status` и недавние коммиты. Claude Code читает его при запуске разговора.

4036 

4037Установите этот ключ в `false`, чтобы исключить оба, например когда вы используете свои собственные skills рабочего процесса git.

4026 4038 

4027* **Область действия**: [`Any file`](#scopes)4039* **Область действия**: [`Any file`](#scopes)

4028* **Тип**: логическое значение4040* **Тип**: логическое значение

5940Предотвратите фоновые автоматические обновления и `claude update` от установки любой версии ниже этой, поэтому переход на канал `"stable"` не понизит вас с более новой сборки `"latest"`. Claude Code записывает этот ключ для вас, когда вы выбираете остаться на текущей версии при переключении каналов в `/config`, и очищает его, когда вы переключаетесь обратно на `"latest"`.5952Предотвратите фоновые автоматические обновления и `claude update` от установки любой версии ниже этой, поэтому переход на канал `"stable"` не понизит вас с более новой сборки `"latest"`. Claude Code записывает этот ключ для вас, когда вы выбираете остаться на текущей версии при переключении каналов в `/config`, и очищает его, когда вы переключаетесь обратно на `"latest"`.

5941 5953 

5942* **Область действия**: [`Any file`](#scopes). Установите это в управляемых параметрах, чтобы закрепить минимум на уровне организации, который пользовательские и проектные параметры не могут снизить.5954* **Область действия**: [`Any file`](#scopes). Установите это в управляемых параметрах, чтобы закрепить минимум на уровне организации, который пользовательские и проектные параметры не могут снизить.

5943* **Тип**: строка, номер версии, такой как `"2.1.100"`5955* **Тип**: строка, номер версии, такой как `"2.1.100"`; значение, которое не является допустимой версией, игнорируется

5944* **По умолчанию**: не установлено, поэтому обновления могут установить любую версию, которую предлагает канал5956* **По умолчанию**: не установлено, поэтому обновления могут установить любую версию, которую предлагает канал

5945 5957 

5946Этот пример следует стабильному каналу и отказывается устанавливать любую версию ниже 2.1.100:5958Этот пример следует стабильному каналу и отказывается устанавливать любую версию ниже 2.1.100:

skills.md +55 −51

Details

123Место сохранения skill определяет, какие сеансы его загружают. Сохраните его в домашнем каталоге, чтобы получить его во всех проектах, зафиксируйте его в репозитории, чтобы поделиться им со всеми, кто там работает, или распространяйте его через plugin или управляемые параметры, чтобы охватить всю команду.123Место сохранения skill определяет, какие сеансы его загружают. Сохраните его в домашнем каталоге, чтобы получить его во всех проектах, зафиксируйте его в репозитории, чтобы поделиться им со всеми, кто там работает, или распространяйте его через plugin или управляемые параметры, чтобы охватить всю команду.

124 124 

125| Расположение | Путь | Загружается в |125| Расположение | Путь | Загружается в |

126| :------------------- | :------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |126| :------------------- | :------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

127| Enterprise | `.claude/skills/<skill-name>/SKILL.md` в [каталоге управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms) | Все пользователи на машинах, где ваша организация его развертывает |127| Enterprise | `.claude/skills/<skill-name>/SKILL.md` в [каталоге управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms) | Все пользователи на машинах, где ваша организация его развертывает |

128| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | Все ваши проекты на этой машине, но не [Cowork или облачные сеансы](#skills-in-cowork-and-cloud-sessions) |128| Personal | `~/.claude/skills/<skill-name>/SKILL.md` | Все ваши проекты на этой машине, но не в [сеансах Cowork или облачных сеансах](#skills-in-cowork-and-cloud-sessions) |

129| Project | `.claude/skills/<skill-name>/SKILL.md` | Сеансы в этом репозитории. Зафиксируйте его, чтобы ваша команда тоже его получила |129| Project | `.claude/skills/<skill-name>/SKILL.md` | Сеансы в этом репозитории. Зафиксируйте его, чтобы ваша команда тоже его получила |

130| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | Сеансы, запущенные в `<subdir>` или ниже. Сеанс, запущенный выше, загружает skill один раз, когда Claude работает с файлами там. См. [monorepos и подкаталоги](#discovery-from-parent-and-nested-directories) |130| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | Сеансы, запущенные в `<subdir>` или ниже. Сеанс, запущенный выше, загружает skill один раз, когда Claude работает с файлами там. См. [монорепозитории и подкаталоги](#discovery-from-parent-and-nested-directories) |

131| Additional directory | `.claude/skills/<skill-name>/SKILL.md` в каталоге, который вы передаете с `--add-dir` | Этот сеанс. См. [каталоги вне проекта](#skills-from-additional-directories) |131| Additional directory | `.claude/skills/<skill-name>/SKILL.md` в каталоге, который вы передаете с `--add-dir` | Этот сеанс. См. [каталоги вне проекта](#skills-from-additional-directories) |

132| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | Везде, где [plugin](/docs/ru/plugins) включен, как `/plugin-name:skill-name` |132| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | Везде, где [plugin](/docs/ru/plugins) включен, как `/plugin-name:skill-name` |

133| claude.ai account | Skills, которые вы включаете в параметрах claude.ai | Cowork и облачные сеансы, а также сеансы терминала, где вы входите с этой учетной записью. См. [Skills синхронизированные с claude.ai](#how-synced-skills-behave) |133| claude.ai account | Skills, включенные для вашей учетной записи claude.ai | Сеансы Cowork, облачные сеансы и сеансы терминала, в которых вы входите с этой учетной записью. См. [Skills, синхронизированные с claude.ai](#how-synced-skills-behave) |

134 134 

135Папки Skill также следуют этим правилам:135Папки skill также следуют этим правилам:

136 136 

137* **Symlinked folders**: запись `<skill-name>` в расположении enterprise, personal или project может быть символической ссылкой на каталог в другом месте на диске. Claude Code читает `SKILL.md` из целевого объекта и загружает skill один раз, даже если несколько расположений указывают на один и тот же целевой объект. Plugin skills [обрабатывают символические ссылки по-другому](/docs/ru/plugins-reference#share-files-within-a-marketplace-with-symlinks).137* **Символические ссылки на папки**: запись `<skill-name>` в расположении enterprise, personal или project может быть символической ссылкой на каталог в другом месте на диске. Claude Code читает `SKILL.md` из целевого объекта и загружает skill один раз, даже если несколько расположений указывают на один и тот же целевой объект. Plugin skills [обрабатывают символические ссылки по-другому](/docs/ru/plugins-reference#share-files-within-a-marketplace-with-symlinks).

138* **Reserved name**: не называйте папку skill `synced` в любом регистре. Claude Code использует `~/.claude/skills/synced/` для [skills загруженных с claude.ai](#where-synced-skills-load) и пропускает skill, который вы создаете с этим именем в расположениях enterprise, personal и project.138* **Зарезервированное имя**: не называйте папку skill `synced` в любом регистре. Claude Code использует `~/.claude/skills/synced/` для [skills, загруженных с claude.ai](#where-synced-skills-load), и пропускает skill, который вы создали с этим именем в расположениях enterprise, personal и project.

139* **Command files**: файл Markdown в `.claude/commands/` — это более старый формат, который все еще работает. Он поддерживает то же [frontmatter](#frontmatter-reference), кроме `name` и `paths`. Чтобы найти имя, которое вы вводите для его вызова, см. [Как skill получает имя команды](#how-a-skill-gets-its-command-name). Предпочитайте skill для новой работы, так как skills также поддерживают [вспомогательные файлы](#add-supporting-files).139* **Файлы команд**: файл Markdown в `.claude/commands/` — это более старый формат, который все еще работает. Он поддерживает то же [frontmatter](#frontmatter-reference), кроме `name` и `paths`. Чтобы найти имя, которое вы вводите для его вызова, см. [Как skill получает имя команды](#how-a-skill-gets-its-command-name). Предпочитайте skill для новой работы, так как skills также поддерживают [вспомогательные файлы](#add-supporting-files).

140* **Skill folder as a plugin**: добавьте `.claude-plugin/plugin.json` в папку skill, и она загружается как [plugin](/docs/ru/plugins-reference#skills-directory-plugins) с именем `<name>@skills-dir`, поэтому она может объединять agents, hooks и MCP servers. В `.claude/skills/` проекта это требует сначала принять диалог доверия рабочей области.140* **Папка skill как plugin**: добавьте `.claude-plugin/plugin.json` в папку skill, и она загружается как [plugin](/docs/ru/plugins-reference#skills-directory-plugins) с именем `<name>@skills-dir`, поэтому она может объединять agents, hooks и MCP servers. В `.claude/skills/` проекта это требует предварительного принятия диалога доверия рабочей области.

141 141 

142<h3 id="discovery-from-parent-and-nested-directories">142<h3 id="discovery-from-parent-and-nested-directories">

143 Загружайте skills в monorepos и подкаталоги143 Загружайте skills в монорепозиториях и подкаталогах

144</h3>144</h3>

145 145 

146Claude Code загружает project skills из `.claude/skills/` в каталоге, где вы его запускаете, и в каждом родительском каталоге вплоть до корня репозитория, поэтому запуск в `packages/frontend/` все еще подхватывает skills, определенные в корне. Когда вы [перемещаете сеанс с `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на v2.1.246 или позже, Claude Code добавляет project skills нового каталога.146Claude Code загружает project skills из `.claude/skills/` в каталоге, где вы его запускаете, и в каждом родительском каталоге вплоть до корня репозитория, поэтому запуск в `packages/frontend/` все еще подхватывает skills, определенные в корне. Когда вы [перемещаете сеанс с `/cd`](/docs/ru/permissions#move-the-session-to-another-directory) на v2.1.246 или позже, Claude Code добавляет project skills нового каталога.

147 147 

148Skills в каталоге `.claude/skills/` ниже того места, где вы начали, не загружаются при запуске. Они загружаются в первый раз, когда Claude читает или редактирует файл в этом подкаталоге, и остаются доступными для остальной части сеанса. До этого они не появляются в меню `/` и вы не можете вызвать их по имени. Чтобы загрузить их раньше, запустите `/add-dir` с путем подкаталога, что требует Claude Code v2.1.257 или позже.148В сеансе, работающем в связанном [git worktree](/docs/ru/worktrees), Claude Code ищет родительские каталоги только до корня worktree. На Claude Code v2.1.277 или позже, когда checkout worktree не имеет каталога `.claude/skills` в его корне, Claude Code вместо этого загружает project skills основного checkout. См. [Что worktrees совместно используют с основным checkout](/docs/ru/worktrees#what-worktrees-share-with-the-main-checkout).

149 

150Skills в каталоге `.claude/skills/` ниже того места, где вы запустили, не загружаются при запуске. Они загружаются в первый раз, когда Claude читает или редактирует файл в этом подкаталоге, и остаются доступными для остальной части сеанса. До этого они не появляются в меню `/` и вы не можете вызвать их по имени. Чтобы загрузить их раньше, запустите `/add-dir` с путем подкаталога, что требует Claude Code v2.1.257 или позже.

149 151 

150Когда вложенный skill имеет то же имя, что и другой skill, оба остаются доступными. С skill `deploy` в корне репозитория и другим в `apps/web/.claude/skills/`:152Когда вложенный skill имеет то же имя, что и другой skill, оба остаются доступными. С skill `deploy` в корне репозитория и другим в `apps/web/.claude/skills/`:

151 153 

152* `/deploy` запускает root skill. Claude Code также перечисляет варианты с квалификацией каталога для Claude с инструкцией вызвать тот, чей каталог содержит файлы, над которыми он работает, поэтому вложенный skill все еще применяется к работе в `apps/web/`.154* `/deploy` запускает skill корня. Claude Code также перечисляет варианты с квалификацией каталога для Claude с инструкцией вызвать тот, чей каталог содержит файлы, над которыми он работает, поэтому вложенный skill все еще применяется к работе в `apps/web/`.

153* `/apps/web:deploy` запускает вложенный skill самостоятельно. Его описание называет каталог, к которому он применяется.155* `/apps/web:deploy` запускает вложенный skill самостоятельно. Его описание называет каталог, к которому он применяется.

154 156 

155<h3 id="skills-from-additional-directories">157<h3 id="skills-from-additional-directories">

163Эти загрузки зависят от источника параметра `project` [setting source](/docs/ru/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources), который включен по умолчанию. Политика [`strictPluginOnlyCustomization`](/docs/ru/settings-reference#strictpluginonlycustomization), [bare mode](/docs/ru/headless#start-faster-with-bare-mode) и [`--safe-mode`](/docs/ru/cli-reference#cli-flags) каждая ограничивает их дальше, как описано на этих страницах. См. [Дополнительные каталоги предоставляют доступ к файлам, а не конфигурацию](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) для полной таблицы того, что загружает добавленный каталог, включая `CLAUDE.md` и параметры plugin.165Эти загрузки зависят от источника параметра `project` [setting source](/docs/ru/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources), который включен по умолчанию. Политика [`strictPluginOnlyCustomization`](/docs/ru/settings-reference#strictpluginonlycustomization), [bare mode](/docs/ru/headless#start-faster-with-bare-mode) и [`--safe-mode`](/docs/ru/cli-reference#cli-flags) каждая ограничивает их дальше, как описано на этих страницах. См. [Дополнительные каталоги предоставляют доступ к файлам, а не конфигурацию](/docs/ru/permissions#additional-directories-grant-file-access-not-configuration) для полной таблицы того, что загружает добавленный каталог, включая `CLAUDE.md` и параметры plugin.

164 166 

165<h3 id="resolve-skills-that-share-a-name">167<h3 id="resolve-skills-that-share-a-name">

166 Разрешайте skills, которые имеют одинаковое имя168 Разрешайте skills, которые имеют одно имя

167</h3>169</h3>

168 170 

169Когда два skills имеют одинаковое имя, откуда каждый из них пришел, решает, какой из них запускает `/name`. Таблица охватывает расположения enterprise, personal, project, nested, plugin и claude.ai, встроенные skills и command files:171Когда два skills имеют одно имя, откуда каждый из них пришел, определяет, какой из них запускает `/name`. Таблица охватывает расположения enterprise, personal, project, nested, plugin и claude.ai, встроенные skills и файлы команд:

170 172 

171| Одинаковое имя в | Какой из них запускается |173| Одно имя в | Какой из них запускается |

172| :-------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |174| :-------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

173| Два из enterprise, personal и project | Enterprise над personal, и personal над project. С `deploy` в обоих `~/.claude/skills/` и `.claude/skills/` проекта, `/deploy` запускает personal |175| Два из enterprise, personal и project | Enterprise над personal, и personal над project. С `deploy` в обоих `~/.claude/skills/` и `.claude/skills/` проекта, `/deploy` запускает personal |

174| Любое из этих расположений и [встроенный skill](#bundled-skills) | Ваш skill заменяет встроенную команду, но не ее aliases. Project skill `code-review` заменяет `/code-review`, и встроенный alias `/review` никогда не запускает ваш skill |176| Любое из этих расположений и [встроенный skill](#bundled-skills) | Ваш skill заменяет встроенную команду, но не ее aliases. Project skill `code-review` заменяет `/code-review`, и встроенный alias `/review` никогда не запускает ваш skill |

175| Skill и файл в `.claude/commands/` | Skill |177| Skill и файл в `.claude/commands/` | Skill |

176| Project-root skill и вложенный skill | Оба загружаются. См. [monorepos и подкаталоги](#discovery-from-parent-and-nested-directories) |178| Project-root skill и вложенный skill | Оба загружаются. См. [монорепозитории и подкаталоги](#discovery-from-parent-and-nested-directories) |

177| Plugin skill и skill в любом из расположений выше | Оба загружаются, потому что plugin skills имеют пространство имен как `/plugin-name:skill-name` |179| Plugin skill и skill в любом из расположений выше | Оба загружаются, потому что plugin skills имеют пространство имен как `/plugin-name:skill-name` |

178| Любое из вышеперечисленного и skill [синхронизированный с вашей учетной записью claude.ai](#how-synced-skills-behave) | Другой skill или команда. Синхронизированный skill все еще запускается как `/anthropic-skills:<name>`. См. [Когда имя синхронизированного skill совпадает с другой командой](#when-a-synced-skill-name-matches-another-command) |180| Любое из вышеперечисленного и skill [синхронизированный с вашей учетной записью claude.ai](#how-synced-skills-behave) | Другой skill или команда. Синхронизированный skill все еще запускается как `/anthropic-skills:<name>`. См. [Когда имя синхронизированного skill совпадает с другой командой](#when-a-synced-skill-name-matches-another-command) |

179 181 

180<h3 id="skills-in-cowork-and-cloud-sessions">182<h3 id="skills-in-cowork-and-cloud-sessions">

181 Используйте skills в Cowork и облачных сеансах183 Используйте skills в сеансах Cowork и облачных сеансах

182</h3>184</h3>

183 185 

184Сеансы [Cowork](https://claude.com/product/cowork) и [облачные сеансы](/docs/ru/cloud-environments#what-carries-over-from-your-setup), включая [routines](/docs/ru/routines), не читают `~/.claude/skills/` на вашей машине. Как интерактивные, так и запланированные сеансы Cowork загружают skills, включенные для вашей учетной записи claude.ai, синхронизированные при запуске сеанса; управляйте ими из **Customize** в боковой панели Desktop app или из параметров skills на claude.ai. Облачные сеансы дополнительно загружают project skills, зафиксированные в `.claude/skills/` клонированного репозитория.186Сеансы [Cowork](https://claude.com/product/cowork) и [облачные сеансы](/docs/ru/cloud-environments#what-carries-over-from-your-setup), включая [routines](/docs/ru/routines), не читают `~/.claude/skills/` на вашей машине. Как интерактивные, так и запланированные сеансы Cowork загружают skills, включенные для вашей учетной записи claude.ai, синхронизированные при запуске сеанса; управляйте ими из **Customize** в боковой панели Desktop app или из параметров skills на claude.ai. Облачные сеансы дополнительно загружают project skills, зафиксированные в `.claude/skills/` клонированного репозитория.

185 187 

186Если skill существует только в `~/.claude/skills/` на вашей машине, Claude Code сообщает, что skill не найден, когда [routine](/docs/ru/routines) его вызывает, потому что каждый запуск routine запускается как свежий облачный сеанс. Чтобы сделать personal skill доступным в этих сеансах:188Если skill существует только в `~/.claude/skills/` на вашей машине, Claude Code сообщает, что skill не найден, когда [routine](/docs/ru/routines) его вызывает, потому что каждый запуск routine запускается как свежий облачный сеанс. Чтобы сделать personal skill доступным в этих сеансах:

187 189 

188* Для Cowork и облачных сеансов включите skill для вашей учетной записи claude.ai.190* Для сеансов Cowork и облачных сеансов включите skill для вашей учетной записи claude.ai.

189* Для облачных сеансов вы можете вместо этого зафиксировать skill в `.claude/skills/` репозитория или отправить его в plugin, объявленном в `.claude/settings.json` репозитория. Plugins, объявленные в репозитории, [устанавливаются при запуске сеанса](/docs/ru/cloud-environments#what-carries-over-from-your-setup); plugins, включенные только в параметрах пользователя, не передаются.191* Для облачных сеансов вы можете вместо этого зафиксировать skill в `.claude/skills/` репозитория. Plugins, объявленные в `.claude/settings.json` репозитория и plugins, включенные только в ваши пользовательские параметры, [не загружаются в облачных сеансах](/docs/ru/cloud-environments#what-carries-over-from-your-setup).

190 192 

191[Desktop scheduled tasks](/docs/ru/desktop-scheduled-tasks) запускаются локально на вашей машине, поэтому они загружают `~/.claude/skills/`.193[Desktop scheduled tasks](/docs/ru/desktop-scheduled-tasks) запускаются локально на вашей машине, поэтому они загружают `~/.claude/skills/`.

192 194 

193<h3 id="how-synced-skills-behave">195<h3 id="how-synced-skills-behave">

194 Skills синхронизированные с claude.ai196 Skills, синхронизированные с claude.ai

195</h3>197</h3>

196 198 

197Этот раздел применяется к вам, если вы используете Cowork или облачные сеансы, или входите в Claude Code в вашем терминале с учетной записью claude.ai. В этих сеансах Claude Code загружает skills, включенные для вашей учетной записи claude.ai, без какой-либо настройки на вашей части, как описано в [Где загружаются синхронизированные skills](#where-synced-skills-load). Эти skills включают те, которые вы создаете или включаете в параметрах claude.ai, skills, которые предоставляет ваша организация там, и встроенные skills Anthropic, такие как `pdf` и `xlsx`.199Этот раздел применяется к вам, если вы используете сеансы Cowork или облачные сеансы, или входите в Claude Code в своем терминале с учетной записью claude.ai. В этих сеансах Claude Code загружает skills, включенные для вашей учетной записи claude.ai, без какой-либо настройки с вашей стороны, как описано в [Где загружаются синхронизированные skills](#where-synced-skills-load). Эти skills включают те, которые вы создаете или включаете в своих параметрах claude.ai, skills, которые предоставляет ваша организация, и встроенные skills Anthropic, такие как `pdf` и `xlsx`.

198 200 

199Claude Code загружает синхронизированный skill с вашей учетной записи, а не читает файл, который вы написали на машине, где запускается сеанс, поэтому он применяет правила к синхронизированным skills, которые не применяются к skills, которые вы храните в [расположениях skills](#where-skills-live).201Claude Code загружает синхронизированный skill с вашей учетной записи, а не читает файл, который вы написали на машине, где работает сеанс, поэтому он применяет правила к синхронизированным skills, которые не применяются к skills, которые вы храните в [расположениях skills](#where-skills-live).

200 202 

201<h4 id="where-synced-skills-load">203<h4 id="where-synced-skills-load">

202 Где загружаются синхронизированные skills204 Где загружаются синхронизированные skills

203</h4>205</h4>

204 206 

205В Cowork или облачном сеансе Claude Code загружает skills, включенные для вашей учетной записи claude.ai, и [Skills в Cowork и облачных сеансах](#skills-in-cowork-and-cloud-sessions) говорит, как выбрать, какие skills получают эти сеансы.207В сеансе Cowork или облачном сеансе Claude Code загружает skills, включенные для вашей учетной записи claude.ai, и [Skills в сеансах Cowork и облачных сеансах](#skills-in-cowork-and-cloud-sessions) говорит, как выбрать, какие skills получают эти сеансы.

206 208 

207В вашем терминале Claude Code синхронизирует эти skills в сеансах, где вы входите с вашей учетной записью claude.ai. Когда сеанс запускается, Claude Code загружает skills вашей учетной записи в `~/.claude/skills/synced/` в фоновом режиме, затем проверяет claude.ai на предмет изменений примерно каждые 10 минут во время работы сеанса. Когда проверка обнаруживает, что skill был добавлен, отредактирован или отключен на claude.ai, Claude Code добавляет, обновляет или удаляет его в работающем сеансе без перезагрузки. Синхронизация в сеансах терминала требует Claude Code v2.1.273 или позже.209В вашем терминале Claude Code синхронизирует эти skills в сеансах, в которых вы входите с вашей учетной записью claude.ai. Когда сеанс запускается, Claude Code загружает skills вашей учетной записи в `~/.claude/skills/synced/` в фоновом режиме, затем проверяет claude.ai на предмет изменений примерно каждые 10 минут во время работы сеанса. Когда проверка обнаруживает, что skill был добавлен, отредактирован или отключен на claude.ai, Claude Code добавляет, обновляет или удаляет его в работающем сеансе без перезагрузки. Синхронизация в сеансах терминала требует Claude Code v2.1.273 или позже.

208 210 

209Синхронизация никогда не задерживает запуск, потому что Claude ждет загрузки skill только когда он вызывает этот skill. Короткий [неинтерактивный](/docs/ru/headless) запуск может поэтому завершиться до того, как недавно добавленный skill загрузится, в этом случае более поздний сеанс загружает его. Чтобы сделать неинтерактивный запуск загружающим ваши skills и ожидающим список перед ответом на prompt, установите [`CLAUDE_CODE_SYNC_SKILLS`](/docs/ru/env-vars#variables) на `1`.211Синхронизация никогда не задерживает запуск, потому что Claude ждет загрузки skill только при его вызове. Короткий [неинтерактивный](/docs/ru/headless) запуск может поэтому завершиться до загрузки вновь добавленного skill, в этом случае более поздний сеанс его загружает. Чтобы неинтерактивный запуск загрузил ваши skills и дождался списка перед ответом на подсказку, установите [`CLAUDE_CODE_SYNC_SKILLS`](/docs/ru/env-vars#variables) на `1`.

210 212 

211Claude Code синхронизирует только в сеансе, который входит с вашей учетной записью claude.ai и [получает флаги функций от Anthropic](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Он не синхронизирует в этих сеансах:213Claude Code синхронизирует только в сеансе, который входит с вашей учетной записью claude.ai и [получает флаги функций от Anthropic](/docs/ru/env-vars#features-that-need-feature-flag-fetching). Он не синхронизирует в этих сеансах:

212 214 

213* Сеанс, который не использует sign-in, сохраненный `/login`, такой как тот, который аутентифицируется с API key, или тот, где `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN` или скрипт `apiKeyHelper` предоставляет учетные данные215* Сеанс, который не использует вход, сохраненный `/login`, например тот, который аутентифицируется с помощью API key, или тот, где `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN` или скрипт `apiKeyHelper` предоставляет учетные данные

214* Сеанс, который не получает флаги функций, такой как тот на Amazon Bedrock или тот, где вы установили `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`216* Сеанс, который не получает флаги функций, например тот, что на Amazon Bedrock, или тот, где вы установили `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

215* Сеанс в [bare mode](/docs/ru/headless#start-faster-with-bare-mode) или тот, который вы запускаете с `--safe-mode`217* Сеанс в [bare mode](/docs/ru/headless#start-faster-with-bare-mode) или тот, который вы запускаете с `--safe-mode`

216* Сеанс, где управляемые параметры вашей организации [блокируют skills на источники plugin](/docs/ru/settings-reference#strictpluginonlycustomization-skills), или тот, который вы запускаете со списком [`--setting-sources`](/docs/ru/cli-reference#cli-flags), который исключает `user`218* Сеанс, где управляемые параметры вашей организации [блокируют skills для источников plugin](/docs/ru/settings-reference#strictpluginonlycustomization-skills), или тот, который вы запускаете со списком [`--setting-sources`](/docs/ru/cli-reference#cli-flags), который исключает `user`

217 219 

218Если вы входите с `/login` во время сеанса, перезапустите Claude Code, чтобы начать синхронизацию.220Если вы входите с `/login` во время сеанса, перезапустите Claude Code, чтобы начать синхронизацию.

219 221 

220Skills, которые синхронизировал более ранний сеанс, остаются на диске. Claude Code загружает их в более поздних сеансах, вошедших в ту же учетную запись, даже когда он не может достичь claude.ai.222Skills, которые синхронизировал более ранний сеанс, остаются на диске. Claude Code загружает их в более поздних сеансах, вошедших в ту же учетную запись, даже когда он не может достичь claude.ai.

221 223 

224Claude Code загружает синхронизированные skills и никогда их не выгружает. Если вы или Claude отредактируете файл в `~/.claude/skills/synced/`, изменение не сохраняется в вашу учетную запись claude.ai, и более поздняя синхронизация может перезаписать или удалить его. Чтобы изменить синхронизированный skill, обновите его на claude.ai; следующая синхронизация загружает новую версию.

225 

222Чтобы увидеть, какие skills синхронизировались, запустите `/skills`. Меню перечисляет их под `claude.ai sync`.226Чтобы увидеть, какие skills синхронизировались, запустите `/skills`. Меню перечисляет их под `claude.ai sync`.

223 227 

224Некоторые skills Anthropic, такие как `pdf` и `xlsx`, всегда синхронизируются. Для остальных включите или отключите skill в параметрах skills на claude.ai, чтобы изменить, синхронизируется ли он.228Некоторые skills Anthropic, такие как `pdf` и `xlsx`, всегда синхронизируются. Для остальных включите или отключите skill в параметрах skills на claude.ai, чтобы изменить, синхронизируется ли он.

225 229 

226Чтобы остановить синхронизацию на машине, установите [`syncClaudeAiSkills`](/docs/ru/settings-reference#syncclaudeaiskills) на `false` в параметрах пользователя. Claude Code прекращает загрузку, и в следующий раз при запуске он перемещает skills, которые он уже синхронизировал, в `~/.claude/skills/.trash/` и больше их не загружает. Ваша организация может отключить синхронизацию для всех, отключив Skills на claude.ai. Чтобы остановить синхронизацию, оставляя Skills включенными, она может установить тот же ключ в [управляемые параметры](/docs/ru/managed-settings).230Чтобы остановить синхронизацию на машине, установите [`syncClaudeAiSkills`](/docs/ru/settings-reference#syncclaudeaiskills) на `false` в ваших пользовательских параметрах. Claude Code прекращает загрузку, и при следующем запуске он перемещает skills, которые он уже синхронизировал, в `~/.claude/skills/.trash/` и больше их не загружает. Ваша организация может отключить синхронизацию для всех, отключив Skills на claude.ai. Чтобы остановить синхронизацию, оставляя Skills включенными, она может установить тот же ключ в [управляемые параметры](/docs/ru/managed-settings).

227 231 

228Если ваша организация отключит Skills на claude.ai, Claude Code удалит загруженные skills и они перестанут загружаться. Удаленные skills перемещаются в `~/.claude/skills/.trash/`, где вы можете восстановить файлы до того, как [retention sweep](/docs/ru/claude-directory#cleaned-up-automatically) их удалит. После того как ваша организация снова включит Skills, Claude Code загружает skills, которые вы включили при следующей синхронизации.232Если ваша организация отключит Skills на claude.ai, Claude Code удалит загруженные skills и они перестанут загружаться. Удаленные skills перемещаются в `~/.claude/skills/.trash/`, где вы можете восстановить файлы до того, как [sweep удержания](/docs/ru/claude-directory#cleaned-up-automatically) их удалит. Как только ваша организация снова включит Skills, Claude Code загружает skills, которые вы включили при следующей синхронизации.

229 233 

230<h4 id="when-a-synced-skill-name-matches-another-command">234<h4 id="when-a-synced-skill-name-matches-another-command">

231 Когда имя синхронизированного skill совпадает с другой командой235 Когда имя синхронизированного skill совпадает с другой командой

232</h4>236</h4>

233 237 

234Вы можете вызвать синхронизированный skill по его полному имени, `/anthropic-skills:<name>`, или по его короткому имени, `/<name>`. Когда другая команда использует это короткое имя, `/<name>` запускает другую команду, и синхронизированный skill запускается только как `/anthropic-skills:<name>`. С локальным skill `deploy` и синхронизированным `deploy`, `/deploy` запускает локальный skill и `/anthropic-skills:deploy` запускает синхронизированный. До v2.1.269 синхронизированный skill имел только его короткое имя.238Вы можете вызвать синхронизированный skill по его полному имени, `/anthropic-skills:<name>`, или по его короткому имени, `/<name>`. Когда другая команда использует это короткое имя, `/<name>` запускает другую команду, и синхронизированный skill запускается только как `/anthropic-skills:<name>`. С локальным skill `deploy` и синхронизированным `deploy`, `/deploy` запускает локальный skill и `/anthropic-skills:deploy` запускает синхронизированный. До v2.1.269 синхронизированный skill имел только свое короткое имя.

235 239 

236Другая команда может быть любой из этих:240Другая команда может быть любой из этих:

237 241 

238* Встроенная команда или [встроенный skill](#bundled-skills), включая тот, который недоступен в вашем сеансе, например после того, как вы отключите встроенные skills242* Встроенная команда или [встроенный skill](#bundled-skills), включая тот, который недоступен в вашем сеансе, например после отключения встроенных skills

239* Skill на любом [локальном уровне](#where-skills-live) или файл в `.claude/commands/`243* Skill на любом [локальном уровне](#where-skills-live) или файл в `.claude/commands/`

240* Plugin skill244* Plugin skill

241* [MCP prompt](/docs/ru/mcp#use-mcp-prompts-as-commands)245* [MCP prompt](/docs/ru/mcp#use-mcp-prompts-as-commands)

242 246 

243Claude Code помечает синхронизированные skills, чтобы вы могли сказать, откуда они пришли. Меню `/skills` и `/context` группируют синхронизированные skills под `claude.ai sync`, и меню команды `/` помечают их как поступающие с claude.ai.247Claude Code помечает синхронизированные skills, чтобы вы могли сказать, откуда они пришли. Меню `/skills` и `/context` группируют синхронизированные skills под `claude.ai sync`, и меню команды `/` помечает их как поступающие с claude.ai.

244 248 

245При сравнении имен Claude Code игнорирует регистр, пробелы и невидимые символы и рассматривает формы совместимости, такие как полноширинные буквы и варианты тире, как их простые эквиваленты. Например, синхронизированный skill с именем `Commit` и локальный skill с именем `commit` считаются одним и тем же именем, поэтому `/commit` продолжает запускать ваш локальный skill.249При сравнении имен Claude Code игнорирует регистр, пробелы и невидимые символы и рассматривает формы совместимости, такие как полноширинные буквы и варианты тире, как их простые эквиваленты. Например, синхронизированный skill с именем `Commit` и локальный skill с именем `commit` считаются одним и тем же именем, поэтому `/commit` продолжает запускать ваш локальный skill.

246 250 

252 256 

253Claude Code применяет два правила к frontmatter синхронизированного skill:257Claude Code применяет два правила к frontmatter синхронизированного skill:

254 258 

255* Claude Code соблюдает frontmatter в каждом виде сеанса, поэтому грант `allowed-tools` проходит через нормальный [permission flow](/docs/ru/permissions).259* Claude Code соблюдает frontmatter в каждом виде сеанса, поэтому грант `allowed-tools` проходит через нормальный [поток разрешений](/docs/ru/permissions).

256* Claude Code санитизирует отображаемый текст, который предоставляет skill, такой как его описание. Он удаляет управляющие символы, и в тексте, который достигает Claude, такой как описание, он также экранирует угловые скобки, чтобы текст не мог имитировать внутреннее форматирование Claude Code. Эта санитизация требует Claude Code v2.1.228 или позже.260* Claude Code санитизирует отображаемый текст, который предоставляет skill, такой как его описание. Он удаляет управляющие символы, и в тексте, который достигает Claude, такой как описание, он также экранирует угловые скобки, чтобы текст не мог имитировать внутреннее форматирование Claude Code. Эта санитизация требует Claude Code v2.1.228 или позже.

257 261 

258<h4 id="how-claude-code-handles-the-body-of-a-synced-skill">262<h4 id="how-claude-code-handles-the-body-of-a-synced-skill">

259 Как Claude Code обрабатывает тело синхронизированного skill263 Как Claude Code обрабатывает тело синхронизированного skill

260</h4>264</h4>

261 265 

262То, что Claude Code делает с телом синхронизированного skill, зависит от того, где запускается сеанс:266То, что Claude Code делает с телом синхронизированного skill, зависит от того, где работает сеанс:

263 267 

264* В облачном сеансе тело сохраняет поведение, которое имеет локальный skill, потому что сеанс запускается в изолированном контейнере.268* В облачном сеансе тело сохраняет поведение, которое имеет локальный skill, потому что сеанс работает в изолированном контейнере.

265* В Cowork сеансе на вашем рабочем столе тело сохраняет поведение локального skill, за исключением того, что Claude Code заменяет каждую строку команды `!` на заполнитель [`disableSkillShellExecution`](#inject-dynamic-context), как он делает для каждого skill, который вы предоставляете там.269* В сеансе Cowork на вашем рабочем столе тело сохраняет поведение локального skill, за исключением того, что Claude Code заменяет каждую строку команды `!` на заполнитель [`disableSkillShellExecution`](#inject-dynamic-context), как это делается для каждого skill, который вы предоставляете там.

266* В любом другом сеансе на вашей машине Claude Code не запускает [`!` команды](#inject-dynamic-context), не прикрепляет файлы, которые `@` ссылки называют так же, как для локального skill, и не подставляет заполнители `${CLAUDE_PROJECT_DIR}` и `${CLAUDE_SESSION_ID}`, поэтому `@` ссылки и оба заполнителя достигают Claude как буквальный текст. Строка команды `!` также достигает Claude как буквальный текст, или как этот заполнитель, когда `disableSkillShellExecution` включен. Эта обработка требует Claude Code v2.1.228 или позже.270* В любом другом сеансе на вашей машине Claude Code не запускает команды [`!`](#inject-dynamic-context), не прикрепляет файлы, которые ссылки `@` называют так же, как для локального skill, и не подставляет заполнители `${CLAUDE_PROJECT_DIR}` и `${CLAUDE_SESSION_ID}`, поэтому ссылки `@` и оба заполнителя достигают Claude как буквальный текст. Строка команды `!` также достигает Claude как буквальный текст, или как этот заполнитель, когда `disableSkillShellExecution` включен. Эта обработка требует Claude Code v2.1.228 или позже.

267 271 

268<h3 id="live-change-detection">272<h3 id="live-change-detection">

269 Редактируйте skill во время сеанса273 Редактируйте skill во время сеанса

270</h3>274</h3>

271 275 

272Claude Code отслеживает каталоги skills на предмет изменений файлов, кроме как в [bare mode](/docs/ru/headless#start-faster-with-bare-mode). Когда вы добавляете, редактируете или удаляете skill под `~/.claude/skills/`, project `.claude/skills/` или `.claude/skills/` внутри каталога `--add-dir`, Claude Code подхватывает изменение в текущем сеансе без перезагрузки. Если вы создаете каталог skills верхнего уровня, который не существовал при запуске сеанса, перезапустите Claude Code, чтобы он мог отслеживать новый каталог.276Claude Code отслеживает каталоги skills на предмет изменений файлов, кроме [bare mode](/docs/ru/headless#start-faster-with-bare-mode). Когда вы добавляете, редактируете или удаляете skill в `~/.claude/skills/`, project `.claude/skills/` или `.claude/skills/` внутри каталога `--add-dir`, Claude Code подхватывает изменение в текущем сеансе без перезагрузки. Если вы создаете каталог skills верхнего уровня, который не существовал при запуске сеанса, перезапустите Claude Code, чтобы он мог отслеживать новый каталог.

273 277 

274Live change detection охватывает только текст `SKILL.md`. Для папки skill, которая также является [plugin](/docs/ru/plugins-reference#skills-directory-plugins), изменения в `hooks/`, `.mcp.json`, `agents/` и `output-styles/` требуют `/reload-plugins` для вступления в силу.278Обнаружение изменений в реальном времени охватывает только текст `SKILL.md`. Для папки skill, которая также является [plugin](/docs/ru/plugins-reference#skills-directory-plugins), изменения в `hooks/`, `.mcp.json`, `agents/` и `output-styles/` требуют `/reload-plugins` для вступления в силу.

275 279 

276<h3 id="remove-a-skill">280<h3 id="remove-a-skill">

277 Удалите skill281 Удалите skill

279 283 

280Способ удаления skill зависит от того, откуда он пришел:284Способ удаления skill зависит от того, откуда он пришел:

281 285 

282* **Personal или project skill**: удалите каталог skill, `~/.claude/skills/<skill-name>/` или `.claude/skills/<skill-name>/`. Claude Code [удаляет его из `/skills` в текущем сеансе](#live-change-detection); содержимое, которое Claude Code уже загрузил из него, следует [skill content lifecycle](#skill-content-lifecycle).286* **Personal или project skill**: удалите каталог skill, `~/.claude/skills/<skill-name>/` или `.claude/skills/<skill-name>/`. Claude Code [удаляет его из `/skills` в текущем сеансе](#live-change-detection); содержимое, которое Claude Code уже загрузил из него, следует [жизненному циклу содержимого skill](#skill-content-lifecycle).

283* **Enterprise skill**: администратор удаляет каталог skill из `.claude/skills/` внутри [каталога управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), например `/etc/claude-code/.claude/skills/<skill-name>/` на Linux.287* **Enterprise skill**: администратор удаляет каталог skill из `.claude/skills/` внутри [каталога управляемых параметров](/docs/ru/managed-settings#delivery-mechanisms), например `/etc/claude-code/.claude/skills/<skill-name>/` на Linux.

284* **Plugin skill**: отключите или удалите plugin, который его предоставляет, из меню `/plugin` или с помощью `/plugin uninstall <plugin-name>@<marketplace-name>`. Claude Code выгружает skills plugin, когда [изменение применяется](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting) или когда вы перезагружаетесь.288* **Plugin skill**: отключите или удалите plugin, который его предоставляет, из меню `/plugin` или с помощью `/plugin uninstall <plugin-name>@<marketplace-name>`. Claude Code выгружает skills plugin, когда [изменение применяется](/docs/ru/discover-plugins#apply-plugin-changes-without-restarting) или когда вы перезагружаетесь.

285* **Skill синхронизированный с claude.ai**: отключите skill для вашей учетной записи claude.ai в том же месте, где вы его [включили](#skills-in-cowork-and-cloud-sessions). Claude Code удаляет его из `~/.claude/skills/synced/` в следующий раз, когда он [синхронизирует ваши skills](#where-synced-skills-load). Если вы удалите каталог вручную, следующая синхронизация загрузит его снова, пока skill остается включенным на claude.ai.289* **Skill, синхронизированный с claude.ai**: отключите skill для вашей учетной записи claude.ai в том же месте, где вы его [включили](#skills-in-cowork-and-cloud-sessions). Claude Code удаляет его из `~/.claude/skills/synced/` при следующей [синхронизации ваших skills](#where-synced-skills-load). Если вы вместо этого удалите каталог вручную, следующая синхронизация загружает его снова, пока skill остается включенным на claude.ai.

286* **Bundled skill**: установите [`disableBundledSkills`](#bundled-skills) на `true`, чтобы отключить встроенные skills, или установите один skill на `"off"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы скрыть его.290* **Встроенный skill**: установите [`disableBundledSkills`](#bundled-skills) на `true`, чтобы отключить встроенные skills, или установите один skill на `"off"` в [`skillOverrides`](#override-skill-visibility-from-settings), чтобы скрыть его.

287 291 

288Чтобы сохранить personal или project skill, но остановить Claude от его автоматического вызова, установите [`disable-model-invocation: true`](#control-who-invokes-a-skill) в его frontmatter, или `"user-invocable-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), когда вы не хотите редактировать файл.292Чтобы сохранить personal или project skill, но остановить Claude от его вызова самостоятельно, установите [`disable-model-invocation: true`](#control-who-invokes-a-skill) в его frontmatter, или `"user-invocable-only"` в [`skillOverrides`](#override-skill-visibility-from-settings), когда вы не хотите редактировать файл.

289 293 

290<h2 id="configure-skills">294<h2 id="configure-skills">

291 Настройка skills295 Настройка skills

335 Справочник Frontmatter339 Справочник Frontmatter

336</h3>340</h3>

337 341 

338Помимо содержимого markdown, вы можете настроить поведение skill, используя поля YAML frontmatter между маркерами `---` в начале вашего файла `SKILL.md`:342Настройте skill с помощью YAML [frontmatter](/docs/ru/glossary#frontmatter) между маркерами `---` в начале `SKILL.md`, и напишите инструкции skill как Markdown после закрывающего `---`. Имена полей используют строчные слова, разделенные дефисами, за исключением `when_to_use`. [Файл команды](#where-skills-live) в `.claude/commands/` принимает те же поля, кроме `name` и `paths`. Этот пример устанавливает четыре поля:

339 343 

340```yaml theme={null}344```yaml theme={null}

341---345---

348Your skill instructions here...352Your skill instructions here...

349```353```

350 354 

351Все поля являются необязательными. Рекомендуется только `description`, чтобы Claude знал, когда использовать skill.355Все поля являются необязательными. Рекомендуется только `description`, чтобы Claude знал, когда использовать skill. Имя поля должно точно совпадать с таблицей, включая дефисы: Claude Code игнорирует поле, которое не распознает, без сообщения об ошибке.

352 356 

353Claude Code читает frontmatter только когда открывающий `---` является первой строкой файла. В противном случае он обрабатывает весь файл, включая маркеры `---`, как содержимое skill.357Claude Code читает frontmatter только когда открывающий `---` является первой строкой файла. В противном случае он обрабатывает весь файл, включая маркеры `---`, как содержимое skill. Если YAML между маркерами не анализируется, skill все равно загружается без установленных полей; см. [Skill не срабатывает](#skill-not-triggering), чтобы найти и исправить ошибку.

354 358 

355Логические поля принимают `yes`, `no`, `on`, `off`, `1` и `0` в любом регистре, в дополнение к `true` и `false`. До v2.1.218 Claude Code распознавал только `true` и `false`.359Логические поля принимают `yes`, `no`, `on`, `off`, `1` и `0` в любом регистре, в дополнение к `true` и `false`. До v2.1.218 Claude Code распознавал только `true` и `false`.

356 360 

388| Claude Code skills на [любом уровне](#where-skills-live), включая [plugin](/docs/ru/plugins) skills | Каждое поле в таблице выше |392| Claude Code skills на [любом уровне](#where-skills-live), включая [plugin](/docs/ru/plugins) skills | Каждое поле в таблице выше |

389| Загрузки skills на claude.ai, Skills API и упаковка с `package_skill.py` из [anthropics/skills](https://github.com/anthropics/skills) | `name`, `description`, `license`, `compatibility`, `metadata`, `allowed-tools` |393| Загрузки skills на claude.ai, Skills API и упаковка с `package_skill.py` из [anthropics/skills](https://github.com/anthropics/skills) | `name`, `description`, `license`, `compatibility`, `metadata`, `allowed-tools` |

390 394 

391Когда вы включаете личный skill для [сеансов Cowork и cloud](#skills-in-cowork-and-cloud-sessions), включая процедуры, вы загружаете его на claude.ai, поэтому применяются те же правила.395Когда вы включаете личный skill для вашего аккаунта claude.ai, например для использования в [сеансах Cowork и cloud](#skills-in-cowork-and-cloud-sessions) и процедурах, вы загружаете его на claude.ai, поэтому применяются те же правила.

392 396 

393Если вы включите какое-либо поле, которое спецификация не разрешает, упаковка или загрузка завершится с жесткой ошибкой вместо игнорирования поля:397Если вы включите какое-либо поле, которое спецификация не разрешает, упаковка или загрузка завершится с жесткой ошибкой вместо игнорирования поля:

394 398 

790Когда этот навык запускается:794Когда этот навык запускается:

791 795 

7921. Создается новый изолированный контекст7961. Создается новый изолированный контекст

7932. Подагент получает содержимое навыка в качестве его подсказки ("Research \$ARGUMENTS thoroughly...")7972. Подагент получает содержимое навыка в качестве его подсказки (инструкции "Research \$ARGUMENTS thoroughly")

7943. Поле `agent` определяет среду выполнения (модель, инструменты и разрешения)7983. Поле `agent` определяет среду выполнения (модель, инструменты и разрешения)

7954. Подагент суммирует свои результаты и возвращает их в ваш основной разговор при завершении7994. Подагент суммирует свои результаты и возвращает их в ваш основной разговор при завершении

796 800 

804 808 

805Три способа контролировать, какие навыки может вызывать Claude:809Три способа контролировать, какие навыки может вызывать Claude:

806 810 

807**Отключить все навыки**, отклонив инструмент Skill в `/permissions`:811**Отключить все навыки** отклонив инструмент Skill в `/permissions`:

808 812 

809```text theme={null}813```text theme={null}

810# Add to deny rules:814# Add to deny rules:

828 832 

829Claude Code совпадает с правилом `allow` только с собственным именем навыка и именем в вызове Claude.833Claude Code совпадает с правилом `allow` только с собственным именем навыка и именем в вызове Claude.

830 834 

831**Скрыть отдельные навыки**, добавив `disable-model-invocation: true` в их frontmatter. Это полностью удаляет навык из контекста Claude.835**Скрыть отдельные навыки** добавив `disable-model-invocation: true` в их frontmatter. Это полностью удаляет навык из контекста Claude.

832 836 

833<Note>837<Note>

834 С `user-invocable: false` вы не можете вызвать навык, но Claude все еще может. Чтобы предотвратить вызов Claude через инструмент Skill, установите `disable-model-invocation: true`.838 С `user-invocable: false` вы не можете вызвать навык, но Claude все еще может. Чтобы предотвратить вызов Claude через инструмент Skill, установите `disable-model-invocation: true`.

statusline.md +2 −2

Details

192| `workspace.git_worktree` | Имя Git worktree, когда текущий каталог находится внутри связанного worktree, созданного с помощью `git worktree add`. Отсутствует в основном рабочем дереве. Заполняется для любого git worktree, в отличие от `worktree.*`, который присутствует только во время сеанса в [worktree сеансе](/docs/ru/worktrees) |192| `workspace.git_worktree` | Имя Git worktree, когда текущий каталог находится внутри связанного worktree, созданного с помощью `git worktree add`. Отсутствует в основном рабочем дереве. Заполняется для любого git worktree, в отличие от `worktree.*`, который присутствует только во время сеанса в [worktree сеансе](/docs/ru/worktrees) |

193| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Идентификация репозитория, проанализированная из удалённого хранилища `origin`, например `"github.com"`, `"anthropics"`, `"claude-code"`. Отсутствует вне git репозитория или когда удалённое хранилище `origin` не настроено. Для проекта gitlab.com, вложенного в подгруппы, `owner` — это полный путь пространства имён с косыми чертами, например `"group/subgroup"`. До версии 2.1.260 `workspace.repo` отсутствовал для этих проектов |193| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Идентификация репозитория, проанализированная из удалённого хранилища `origin`, например `"github.com"`, `"anthropics"`, `"claude-code"`. Отсутствует вне git репозитория или когда удалённое хранилище `origin` не настроено. Для проекта gitlab.com, вложенного в подгруппы, `owner` — это полный путь пространства имён с косыми чертами, например `"group/subgroup"`. До версии 2.1.260 `workspace.repo` отсутствовал для этих проектов |

194| `cost.total_cost_usd` | Предполагаемая стоимость сеанса в USD, вычисляется на клиенте по цене списка, если не действует таблица [`modelPricing`](/docs/ru/settings-reference#modelpricing). Может отличаться от вашего фактического счёта. Сбрасывается на \$0 при запуске нового сеанса с помощью `/clear`. До версии 2.1.211 общая стоимость переносилась после `/clear` |194| `cost.total_cost_usd` | Предполагаемая стоимость сеанса в USD, вычисляется на клиенте по цене списка, если не действует таблица [`modelPricing`](/docs/ru/settings-reference#modelpricing). Может отличаться от вашего фактического счёта. Сбрасывается на \$0 при запуске нового сеанса с помощью `/clear`. До версии 2.1.211 общая стоимость переносилась после `/clear` |

195| `cost.total_duration_ms` | Общее реальное время с момента начала сеанса в миллисекундах |195| `cost.total_duration_ms` | Общее реальное время, в течение которого сеанс работал, в миллисекундах. Накапливается при возобновлении и не включает время, когда сеанс не работает |

196| `cost.total_api_duration_ms` | Общее время, потраченное на ожидание ответов API в миллисекундах |196| `cost.total_api_duration_ms` | Общее время, потраченное на ожидание ответов API в миллисекундах |

197| `cost.total_lines_added`, `cost.total_lines_removed` | Строки кода, которые были изменены |197| `cost.total_lines_added`, `cost.total_lines_removed` | Строки кода, которые были изменены |

198| `context_window.total_input_tokens`, `context_window.total_output_tokens` | Количество токенов, находящихся в контекстном окне, из последнего ответа API. Входные данные включают чтение и запись кэша |198| `context_window.total_input_tokens`, `context_window.total_output_tokens` | Количество токенов, находящихся в контекстном окне, из последнего ответа API. Входные данные включают чтение и запись кэша |

236 "prompt_id": "550e8400-e29b-41d4-a716-446655440000",236 "prompt_id": "550e8400-e29b-41d4-a716-446655440000",

237 "transcript_path": "/path/to/transcript.jsonl",237 "transcript_path": "/path/to/transcript.jsonl",

238 "model": {238 "model": {

239 "id": "claude-opus-5",239 "id": "claude-opus-5-5",

240 "display_name": "Opus"240 "display_name": "Opus"

241 },241 },

242 "workspace": {242 "workspace": {

sub-agents.md +30 −16

Details

32 32 

33Claude Code включает встроенные subagents, которые Claude автоматически использует при необходимости. Каждый наследует разрешения родительского разговора; большинство работают с ограниченным набором инструментов.33Claude Code включает встроенные subagents, которые Claude автоматически использует при необходимости. Каждый наследует разрешения родительского разговора; большинство работают с ограниченным набором инструментов.

34 34 

35Explore и Plan пропускают ваши файлы CLAUDE.md и статус git родительской сессии, чтобы исследование было быстрым и экономичным. Все остальные встроенные и [пользовательские subagents](#configure-subagents) загружают оба, если только их определение не устанавливает поле [`omitClaudeMd`](#supported-frontmatter-fields) для пропуска файлов CLAUDE.md пользователя, проекта и локального. Для полного разбора того, что достигает subagent, см. [что загружается при запуске](#what-loads-at-startup).35Explore и Plan пропускают ваши файлы CLAUDE.md и снимок статуса git, чтобы исследование было быстрым и экономичным. Все остальные встроенные и [пользовательские subagents](#configure-subagents) загружают оба, если только их определение не устанавливает поле [`omitClaudeMd`](#supported-frontmatter-fields) для пропуска файлов CLAUDE.md пользователя, проекта и локального. Для полного разбора того, что достигает subagent, см. [что загружается при запуске](#what-loads-at-startup).

36 36 

37<Tabs>37<Tabs>

38 <Tab title="Explore">38 <Tab title="Explore">

230 </Tab>230 </Tab>

231</Tabs>231</Tabs>

232 232 

233Флаг `--agents` принимает JSON с полем `prompt` плюс эти поля [frontmatter](#supported-frontmatter-fields): `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` и `isolation`. Используйте `prompt` для системного приглашения, эквивалентного телу markdown в файловых subagents.233Флаг `--agents` принимает JSON с полем `prompt` плюс эти поля [frontmatter](#supported-frontmatter-fields): `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` и `isolation`. Используйте `prompt` для системного приглашения, эквивалентного телу markdown в файловых subagents. `color` и `experimental` не принимаются здесь и игнорируются, а не отклоняются.

234 234 

235Каждый ключ верхнего уровня в JSON — это имя агента. Не начинайте имя с `-`.235Каждый ключ верхнего уровня в JSON — это имя агента. Не начинайте имя с `-`.

236 236 

295 295 

296Когда основной разговор сам работает изолированно в worktree, Claude Code применяет те же проверки к сессии и к каждому subagent, который он порождает, включая subagents без `isolation: worktree`; см. [How Claude Code enforces isolation](/docs/ru/worktrees#how-claude-code-enforces-isolation).296Когда основной разговор сам работает изолированно в worktree, Claude Code применяет те же проверки к сессии и к каждому subagent, который он порождает, включая subagents без `isolation: worktree`; см. [How Claude Code enforces isolation](/docs/ru/worktrees#how-claude-code-enforces-isolation).

297 297 

298<h4 id="supported-frontmatter-fields">298<h3 id="supported-frontmatter-fields">

299 Поддерживаемые поля frontmatter299 Справочник Frontmatter

300</h4>300</h3>

301 

302Настройте subagent с помощью YAML [frontmatter](/docs/ru/glossary#frontmatter) между маркерами `---` в верхней части его файла, и напишите его системное приглашение как Markdown после закрывающего `---`. Требуются только `name` и `description`.

301 303 

302Следующие поля могут использоваться в YAML frontmatter. Требуются только `name` и `description`.304Многословные имена полей используют camelCase, такие как `maxTurns` и `disallowedTools`, и должны точно совпадать с таблицей: Claude Code игнорирует поле, которое он не распознаёт, без сообщения об ошибке. Чтобы узнать, почему файл subagent не загрузился, см. [Subagent files Claude Code skips](#subagent-files-claude-code-skips).

303 305 

304| Field | Требуется | Description |306| Field | Требуется | Description |

305| :---------------- | :-------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |307| :---------------- | :-------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

306| `name` | Да | Уникальный идентификатор, использующий строчные буквы и дефисы. [Hooks](/docs/ru/hooks#subagentstart) получают это значение как `agent_type`. Имя файла может с ним не совпадать. Имена не могут содержать `:`, который зарезервирован для [plugin-scoped identifiers](/docs/ru/plugins), таких как `my-plugin:reviewer`. Claude Code не загружает файл, чьё имя содержит один, и регистрирует ошибку в журнал отладки. До версии 2.1.218 такие имена были приняты |308| `name` | Да | Уникальный идентификатор, такой как `code-reviewer` или `reviewer-v2`. [Hooks](/docs/ru/hooks#subagentstart) получают это значение как `agent_type`. Имя файла не должно совпадать. Имена не могут содержать `:`, который зарезервирован для [plugin-scoped identifiers](/docs/ru/plugins), таких как `my-plugin:reviewer`. Claude Code не загружает файл, чьё имя содержит один, и регистрирует ошибку в журнал отладки. До версии 2.1.218 такие имена были приняты |

307| `description` | Да | Когда Claude должен делегировать этому subagent |309| `description` | Да | Когда Claude должен делегировать этому subagent |

308| `tools` | Нет | [Инструменты](#available-tools), которые может использовать subagent. Наследует каждый инструмент, доступный для subagents, если опущено. Если ни один элемент в списке не разрешается в инструмент, subagent обычно [не запускается](/docs/ru/errors#agent-would-be-spawned-with-zero-tools) с ошибкой, называющей элементы. Чтобы предварительно загрузить Skills в контекст, используйте поле `skills` вместо перечисления `Skill` здесь |310| `tools` | Нет | [Инструменты](#available-tools), которые может использовать subagent, как строка, разделённая запятыми, такая как `Read, Grep, Bash` или список YAML. Наследует каждый инструмент, доступный для subagents, если опущено. Если ни один элемент в списке не разрешается в инструмент, subagent обычно [не запускается](/docs/ru/errors#agent-would-be-spawned-with-zero-tools) с ошибкой, называющей элементы. Чтобы предварительно загрузить Skills в контекст, используйте поле `skills` вместо перечисления `Skill` здесь |

309| `disallowedTools` | Нет | Инструменты для запрета, удалённые из унаследованного или указанного списка. Запись со спецификатором, такая как `Bash(git push *)`, по-прежнему [удаляет весь инструмент](#available-tools) |311| `disallowedTools` | Нет | Инструменты для запрета, удалённые из унаследованного или указанного списка. Тот же формат, что и `tools`. Запись со спецификатором, такая как `Bash(git push *)`, по-прежнему [удаляет весь инструмент](#available-tools) |

310| `model` | Нет | [Модель](#choose-a-model) для использования: `sonnet`, `opus`, `haiku`, `fable`, полный ID модели, такой как `claude-opus-5`, или `inherit`. Когда вы опускаете его, Claude Code выбирает модель в [subagent model order](#choose-a-model) |312| `model` | Нет | [Модель](#choose-a-model) для использования: `sonnet`, `opus`, `haiku`, `fable`, полный ID модели, такой как `claude-opus-5-5`, или `inherit`. Когда вы опускаете его, Claude Code выбирает модель в [subagent model order](#choose-a-model) |

311| `permissionMode` | Нет | [Режим разрешений](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, или `manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |313| `permissionMode` | Нет | [Режим разрешений](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, или `manual` как псевдоним для `default`. Псевдоним `manual` требует Claude Code v2.1.200 или позже. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |

312| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой subagent. Когда subagent достигает лимита, Claude Code возвращает его вывод, отмеченный как частичный, и Claude может [возобновить его](#resume-subagents) для продолжения. Частичная маркировка требует Claude Code v2.1.246 или позже |314| `maxTurns` | Нет | Максимальное количество агентских ходов перед остановкой subagent. Когда subagent достигает лимита, Claude Code возвращает его вывод, отмеченный как частичный, и Claude может [возобновить его](#resume-subagents) для продолжения. Частичная маркировка требует Claude Code v2.1.246 или позже |

313| `skills` | Нет | [Skills](/docs/ru/skills) для предварительной загрузки в контекст subagent при запуске. Полное содержимое skill инжектируется, а не просто описание. Subagents по-прежнему могут вызывать неперечисленные project, user и plugin skills через инструмент Skill |315| `skills` | Нет | [Skills](/docs/ru/skills) для предварительной загрузки в контекст subagent при запуске. Полное содержимое skill инжектируется, а не просто описание. Subagents по-прежнему могут вызывать неперечисленные project, user и plugin skills через инструмент Skill |

319| `effort` | Нет | Уровень усилий, когда этот subagent активен. Переопределяет уровень усилий сессии. По умолчанию: наследуется из сессии. Параметры: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели |321| `effort` | Нет | Уровень усилий, когда этот subagent активен. Переопределяет уровень усилий сессии. По умолчанию: наследуется из сессии. Параметры: `low`, `medium`, `high`, `xhigh`, `max`; доступные уровни зависят от модели |

320| `isolation` | Нет | Установите на `worktree`, чтобы запустить subagent во временном [git worktree](/docs/ru/worktrees), дав ему изолированную копию репозитория, разветвлённую по умолчанию от вашей [ветки по умолчанию](/docs/ru/worktrees#choose-the-base-branch), а не от `HEAD` родительской сессии. Worktree автоматически очищается, если subagent не вносит изменения |322| `isolation` | Нет | Установите на `worktree`, чтобы запустить subagent во временном [git worktree](/docs/ru/worktrees), дав ему изолированную копию репозитория, разветвлённую по умолчанию от вашей [ветки по умолчанию](/docs/ru/worktrees#choose-the-base-branch), а не от `HEAD` родительской сессии. Worktree автоматически очищается, если subagent не вносит изменения |

321| `color` | Нет | Цвет отображения для subagent в списке задач и транскрипте. Принимает `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink` или `cyan` |323| `color` | Нет | Цвет отображения для subagent в списке задач и транскрипте. Принимает `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink` или `cyan` |

322| `initialPrompt` | Нет | Автоматически отправляется как первый ход пользователя, когда этот агент работает как основной агент сессии (через `--agent` или параметр `agent`). [Commands](/docs/ru/commands) и [skills](/docs/ru/skills) обрабатываются. Добавляется в начало любого предоставленного пользователем приглашения |324| `initialPrompt` | Нет | Автоматически отправляется как первый ход пользователя, когда этот агент работает как основной агент сессии (через `--agent` или параметр `agent`). [Commands](/docs/ru/commands) и [skills](/docs/ru/skills) обрабатываются. Добавляется в начало любого предоставленного пользователем приглашения. Игнорируется для [plugin subagents](#choose-the-subagent-scope) |

323| `experimental` | Нет | Карта экспериментальных опций. Установите её ключ `cacheTtl` на `5m` или `1h` для выбора [lifetime кэша приглашения](/docs/ru/prompt-caching#choose-the-ttl-yourself) для запросов этого subagent, в месте frontmatter в [cache lifetime precedence](/docs/ru/prompt-caching#choose-the-ttl-yourself). Claude Code игнорирует любое другое значение, игнорирует `1h` пока ваша подписка Claude использует кредиты использования, и читает поле только из файлов subagent. Требует Claude Code v2.1.248 или позже |325| `experimental` | Нет | Карта экспериментальных опций. Установите её ключ `cacheTtl` на `5m` или `1h` для выбора [lifetime кэша приглашения](/docs/ru/prompt-caching#choose-the-ttl-yourself) для запросов этого subagent, в месте frontmatter в [cache lifetime precedence](/docs/ru/prompt-caching#choose-the-ttl-yourself). Claude Code игнорирует любое другое значение, игнорирует `1h` пока ваша подписка Claude использует кредиты использования, и читает поле только из файлов subagent. Требует Claude Code v2.1.248 или позже |

324 326 

325Напишите `cacheTtl` внутри карты `experimental`, а не на верхнем уровне frontmatter.327Напишите `cacheTtl` внутри карты `experimental`, а не на верхнем уровне frontmatter.

362Поле `model` контролирует, какую модель использует subagent:364Поле `model` контролирует, какую модель использует subagent:

363 365 

364* **Model alias**: используйте один из доступных псевдонимов: `sonnet`, `opus`, `haiku` или `fable`366* **Model alias**: используйте один из доступных псевдонимов: `sonnet`, `opus`, `haiku` или `fable`

365* **Full model ID**: используйте полный ID модели, такой как `claude-opus-5` или `claude-sonnet-5`. Принимает те же значения, что и флаг `--model`367* **Full model ID**: используйте полный ID модели, такой как `claude-opus-5-5` или `claude-sonnet-5`. Принимает те же значения, что и флаг `--model`

366* **inherit**: используйте ту же модель, что и основной разговор368* **inherit**: используйте ту же модель, что и основной разговор

367 369 

368Когда Claude вызывает subagent, он также может передать параметр `model` для этого конкретного вызова. Claude Code разрешает модель subagent в этом порядке:370Когда Claude вызывает subagent, он также может передать параметр `model` для этого конкретного вызова. Claude Code разрешает модель subagent в этом порядке:

3723. Переменная окружения [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ru/model-config#environment-variables), когда вы устанавливаете её на псевдоним модели или ID модели3743. Переменная окружения [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ru/model-config#environment-variables), когда вы устанавливаете её на псевдоним модели или ID модели

3734. Модель основного разговора3754. Модель основного разговора

374 376 

377В двух случаях семейный псевдоним, такой как `opus`, в параметре для конкретного вызова или frontmatter разрешается в модель основного разговора вместо [версии, на которую указывает псевдоним](/docs/ru/model-config#model-aliases):

378 

379* **Модель основного разговора принадлежит этому семейству**: subagent работает на точной модели основного разговора, включая любой суффикс `[1m]`, поэтому он получает то же [extended context](/docs/ru/model-config#extended-context) окно, что и основной разговор.

380* **Claude Code не может определить семейство модели основного разговора, на [поставщике, отличном от Anthropic API](/docs/ru/third-party-integrations)**: это может произойти с [application inference profile ARN](/docs/ru/amazon-bedrock#iam-configuration) на Amazon Bedrock, который Claude Code не разрешил в резервную модель. Этот случай охватывает только псевдоним `opus` и не применяется, когда вы устанавливаете [`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/ru/model-config#environment-variables), поскольку `opus` затем разрешается в модель, которую вы установили.

381 

382Псевдоним в `CLAUDE_CODE_SUBAGENT_MODEL` всегда разрешается в версию, на которую указывает псевдоним, даже когда он называет семейство основного разговора.

383 

375Установка `CLAUDE_CODE_SUBAGENT_MODEL` сама по себе не изменяет модель, на которой работают встроенные subagents Explore и Plan. Чтобы изменить её, см. [Run every subagent on one model](#run-every-subagent-on-one-model).384Установка `CLAUDE_CODE_SUBAGENT_MODEL` сама по себе не изменяет модель, на которой работают встроенные subagents Explore и Plan. Чтобы изменить её, см. [Run every subagent on one model](#run-every-subagent-on-one-model).

376 385 

377До версии 2.1.251 `CLAUDE_CODE_SUBAGENT_MODEL` был первым в этом порядке и переопределял как параметр для конкретного вызова, так и frontmatter, включая `model: inherit`.386До версии 2.1.251 `CLAUDE_CODE_SUBAGENT_MODEL` был первым в этом порядке и переопределял как параметр для конкретного вызова, так и frontmatter, включая `model: inherit`.

438* `EnterPlanMode`447* `EnterPlanMode`

439* `ExitPlanMode`, если только [`permissionMode`](#permission-modes) subagent не является `plan`448* `ExitPlanMode`, если только [`permissionMode`](#permission-modes) subagent не является `plan`

440* `ScheduleWakeup`449* `ScheduleWakeup`

441* `TaskOutput`

442* `WaitForMcpServers`450* `WaitForMcpServers`

443* `Workflow`451* `Workflow`

444 452 

445Второй фильтр применяется к subagents, работающим в фоне. Кроме `Agent` и `ExitPlanMode`, которые следуют условиям первого фильтра везде, где работает subagent, фоновый subagent сохраняет каждый MCP инструмент, но только эти встроенные инструменты: `Read`, `Grep`, `Glob`, `Bash`, `PowerShell`, `Edit`, `Write`, `NotebookEdit`, `WebFetch`, `WebSearch`, `TodoWrite`, `Skill`, `ToolSearch`, `EnterWorktree`, `ExitWorktree`, `Monitor`, `TaskStop`, `SendMessage` и `Artifact`, плюс [`SubagentHandback`](/docs/ru/tools-reference) для subagent, который сообщает через него. Claude Code удаляет каждый другой встроенный инструмент из фонового subagent, унаследованный или указанный в поле `tools`, поэтому одно и то же определение может разрешаться в разные инструменты на переднем плане и в фоне. Удаление сообщает об ошибке только в том случае, если после него список `tools` [оказывается пустым](/docs/ru/errors#agent-would-be-spawned-with-zero-tools).453Второй фильтр применяется к subagents, работающим в фоне. Кроме `Agent` и `ExitPlanMode`, которые следуют условиям первого фильтра везде, где работает subagent, фоновый subagent сохраняет каждый MCP инструмент, но только эти встроенные инструменты: `Read`, `Grep`, `Glob`, `LSP`, `Bash`, `PowerShell`, `Edit`, `Write`, `NotebookEdit`, `WebFetch`, `WebSearch`, `TodoWrite`, `Skill`, `ToolSearch`, `EnterWorktree`, `ExitWorktree`, `Monitor`, `TaskStop`, `SendMessage` и `Artifact`, плюс [`SubagentHandback`](/docs/ru/tools-reference) для subagent, который сообщает через него. Claude Code удаляет каждый другой встроенный инструмент из фонового subagent, унаследованный или указанный в поле `tools`, поэтому одно и то же определение может разрешаться в разные инструменты на переднем плане и в фоне. Удаление сообщает об ошибке только в том случае, если после него список `tools` [оказывается пустым](/docs/ru/errors#agent-would-be-spawned-with-zero-tools).

454 

455До версии 2.1.280 фоновые subagents не могли использовать `LSP`.

446 456 

447[`ListAgents`](/docs/ru/cross-session-messaging) следует этим фильтрам как любой встроенный инструмент: передний subagent наследует его в сессиях, где включен кросс-сессионный обмен сообщениями, и фоновый subagent его не сохраняет.457[`ListAgents`](/docs/ru/cross-session-messaging) следует этим фильтрам как любой встроенный инструмент: передний subagent наследует его в сессиях, где включен кросс-сессионный обмен сообщениями, и фоновый subagent его не сохраняет.

448 458 

989 999 

990Сканирование не судит, является ли содержание вредоносным, и оно не изменяет то, что инструкция в отчёте может сделать: вызов инструмента, который отчёт приводит Claude к выполнению, всё ещё проходит через [проверки разрешений](/docs/ru/permissions) сессии и [sandboxing](/docs/ru/sandboxing). Это не замена для [ограничения того, что может достичь subagent](#control-subagent-capabilities).1000Сканирование не судит, является ли содержание вредоносным, и оно не изменяет то, что инструкция в отчёте может сделать: вызов инструмента, который отчёт приводит Claude к выполнению, всё ещё проходит через [проверки разрешений](/docs/ru/permissions) сессии и [sandboxing](/docs/ru/sandboxing). Это не замена для [ограничения того, что может достичь subagent](#control-subagent-capabilities).

991 1001 

1002Отчёт, который возвращается Claude как результат subagent, также прибывает под заголовком, отмечающим его как выход subagent. Заголовок указывает, что инструкции или утверждения об одобрении внутри отчёта — это слова subagent и не несут никакого авторитета от вас.

1003 

1004Отчёт [фонового subagent](#run-subagents-in-foreground-or-background) прибывает внутри уведомления о завершении, которое отмечается как автоматизированное событие, а не сообщение от вас.

1005 

992<Note>1006<Note>

993 Сканирование выхода Subagent требует Claude Code v2.1.210 или позже.1007 Сканирование выхода Subagent требует Claude Code v2.1.210 или позже.

994</Note>1008</Note>

1117* **System prompt**: собственное приглашение агента плюс детали окружения, которые добавляет Claude Code, а не системное приглашение Claude Code. Пользовательские subagents определяют свои в [markdown body](#write-subagent-files) или поле `prompt`. Встроенные агенты имеют предопределённые приглашения.1131* **System prompt**: собственное приглашение агента плюс детали окружения, которые добавляет Claude Code, а не системное приглашение Claude Code. Пользовательские subagents определяют свои в [markdown body](#write-subagent-files) или поле `prompt`. Встроенные агенты имеют предопределённые приглашения.

1118* **Task message**: приглашение делегирования, которое Claude пишет при передаче работы.1132* **Task message**: приглашение делегирования, которое Claude пишет при передаче работы.

1119* **CLAUDE.md files**: каждый уровень [иерархии CLAUDE.md](/docs/ru/memory#how-claude-md-files-load), который загружает основной разговор, включая `~/.claude/CLAUDE.md`, правила проекта, `CLAUDE.local.md`, управляемые файлы политики и любые [`AGENTS.md` файлы](/docs/ru/memory#agents-md), загруженные как инструкции проекта. Встроенные агенты Explore и Plan пропускают это. Subagent, чьё определение устанавливает [`omitClaudeMd`](#supported-frontmatter-fields), загружает только управляемые файлы политики, или ничего вообще, когда определение поступает из [managed settings](#choose-the-subagent-scope).1133* **CLAUDE.md files**: каждый уровень [иерархии CLAUDE.md](/docs/ru/memory#how-claude-md-files-load), который загружает основной разговор, включая `~/.claude/CLAUDE.md`, правила проекта, `CLAUDE.local.md`, управляемые файлы политики и любые [`AGENTS.md` файлы](/docs/ru/memory#agents-md), загруженные как инструкции проекта. Встроенные агенты Explore и Plan пропускают это. Subagent, чьё определение устанавливает [`omitClaudeMd`](#supported-frontmatter-fields), загружает только управляемые файлы политики, или ничего вообще, когда определение поступает из [managed settings](#choose-the-subagent-scope).

1120* **Git status**: снимок, сделанный в начале родительской сессии. Отсутствует, когда рабочая директория не является Git репозиторием или когда [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions) имеет значение `false`. Explore и Plan пропускают это независимо.1134* **Git status**: снимок, который Claude Code читает из вашего репозитория при запуске subagent. Отсутствует вне Git репозитория или когда снимок отключен; см. [`includeGitInstructions`](/docs/ru/settings-reference#includegitinstructions). Explore и Plan пропускают это независимо.

1121* **Preloaded skills**: полное содержание любого навыка, названного в поле [`skills`](#preload-skills-into-subagents) агента. Встроенные агенты не предзагружают навыки.1135* **Preloaded skills**: полное содержание любого навыка, названного в поле [`skills`](#preload-skills-into-subagents) агента. Встроенные агенты не предзагружают навыки.

1122* **Sibling roster**: системное напоминание, в котором перечислены `main` и каждый другой именованный агент в сессии, каждый является допустимым значением `to` для [`SendMessage`](#resume-subagents). Требует Claude Code v2.1.206 или позже. Реестр появляется только когда инструменты subagent включают `SendMessage` и по крайней мере один другой агент имеет имя, независимо от того, назвал ли его Claude при порождении или он работает как товарищ [agent team](/docs/ru/agent-teams). Это снимок, сделанный при запуске subagent, поэтому агенты, названные позже, не появляются.1136* **Sibling roster**: системное напоминание, в котором перечислены `main` и каждый другой именованный агент в сессии, каждый является допустимым значением `to` для [`SendMessage`](#resume-subagents). Требует Claude Code v2.1.206 или позже. Реестр появляется только когда инструменты subagent включают `SendMessage` и по крайней мере один другой агент имеет имя, независимо от того, назвал ли его Claude при порождении или он работает как товарищ [agent team](/docs/ru/agent-teams). Это снимок, сделанный при запуске subagent, поэтому агенты, названные позже, не появляются.

1123 1137 

Details

343 Вставка большого содержимого343 Вставка большого содержимого

344</h2>344</h2>

345 345 

346Когда вы вставляете более 800 символов или более трёх строк в подсказку, Claude Code сворачивает ввод в заполнитель, например `[Pasted text #1 +120 lines]`, чтобы поле ввода оставалось удобным для использования. В окне терминала высотой менее 12 строк лимит строк снижается, поэтому Claude Code сворачивает трёхстрочную вставку при 11 строках и любую многострочную вставку при 10 строках или меньше. Claude Code по-прежнему отправляет полное содержимое при отправке.346Когда вы вставляете более 800 символов или более трёх строк в подсказку, Claude Code сворачивает ввод в заполнитель, например `[Pasted text #1 +120 lines]`, чтобы поле ввода оставалось удобным для использования, и по-прежнему отправляет полное содержимое при отправке. Для очень больших входных данных, таких как целые файлы или длинные журналы, запишите содержимое в файл и попросите Claude прочитать его вместо вставки. Стенограмма разговора остаётся читаемой, и Claude может ссылаться на файл по пути в более поздних ходах. Интегрированный терминал VS Code также может отбросить символы из очень больших вставок, прежде чем они достигнут Claude Code, поэтому используйте там файл.

347 347 

348Когда вы удаляете с помощью сочетания клавиш для слова или строки, такого как `Ctrl+W` или `Ctrl+K`, или с помощью удаления vim через движение `f`/`t`, такое как `df]`, и удаляемый диапазон достигает внутри заполнителя, Claude Code удаляет заполнитель целиком. Вы можете вставить удаление обратно, чтобы восстановить его, с помощью [`Ctrl+Y`](/docs/ru/interactive-mode#text-editing) после сочетания клавиш для слова или строки, или с помощью [`p` в режиме NORMAL](/docs/ru/interactive-mode#editing-normal-mode) после удаления vim.348Если вставка содержит [невидимые символы Unicode](/docs/ru/interactive-mode#invisible-characters-in-prompts), Claude Code удаляет их при нажатии Enter и возвращает очищенную подсказку в поле ввода для отправки с помощью другого Enter.

349 349 

350Claude Code хранит свёрнутое содержимое в `~/.claude/paste-cache/`, поэтому когда вы вызываете подсказку из [истории команд](/docs/ru/interactive-mode#command-history) и повторно отправляете её, Claude Code отправляет полное вставленное содержимое снова, включая в более позднем сеансе, пока развёртка очистки не удалит файл кэша.350<h3 id="how-claude-treats-pasted-text">

351 Как Claude обрабатывает вставленный текст

352</h3>

353 

354При отправке Claude видит содержимое за каждым заполнителем `[Pasted text #N]`, отмеченным как текст, который вы вставили откуда-то, а не напечатали. Claude сообщается, что вставка может содержать инструкции, которые вы не писали, и следовать инструкциям внутри неё только там, где сообщение, которое вы напечатали, это просит. В сеансах, которые не [получают флаги функций](/docs/ru/env-vars#features-that-need-feature-flag-fetching), вставки не отмечаются.

351 355 

352Claude Code удаляет файлы кэша старше [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), следуя [правилам развёртки очистки](/docs/ru/claude-directory#cleaned-up-automatically), поэтому вызванная подсказка может ссылаться на вставленный текст, который больше не существует. Когда вы отправляете такую подсказку, Claude Code никогда не отправляет буквальную строку `[Pasted text #N]` и показывает уведомление с названием отсутствующей вставки:356<h3 id="delete-and-restore-a-collapsed-paste">

357 Удаление и восстановление свёрнутой вставки

358</h3>

359 

360Когда вы удаляете с помощью сочетания клавиш для слова или строки, такого как `Ctrl+W` или `Ctrl+K`, или с помощью удаления vim через движение `f`/`t`, такое как `df]`, и удаляемый диапазон достигает внутри заполнителя `[Pasted text #N]`, Claude Code удаляет заполнитель целиком. Чтобы восстановить его, вставьте удаление обратно с помощью [`Ctrl+Y`](/docs/ru/interactive-mode#text-editing) после сочетания клавиш для слова или строки, или с помощью [`p` в режиме NORMAL](/docs/ru/interactive-mode#editing-normal-mode) после удаления vim.

361 

362<h3 id="recall-a-prompt-that-had-pasted-text">

363 Вызов подсказки с вставленным текстом

364</h3>

365 

366Claude Code хранит содержимое за каждым заполнителем `[Pasted text #N]` в `~/.claude/paste-cache/`, поэтому когда вы вызываете подсказку из [истории команд](/docs/ru/interactive-mode#command-history) и повторно отправляете её, полное вставленное содержимое отправляется снова, включая в более позднем сеансе.

367 

368Файлы кэша старше [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays) удаляются в соответствии с [правилами развёртки очистки](/docs/ru/claude-directory#cleaned-up-automatically), поэтому вызванная подсказка может ссылаться на вставленный текст, который больше не существует. Когда вы отправляете такую подсказку, Claude Code никогда не отправляет буквальную строку `[Pasted text #N]` и показывает уведомление с названием отсутствующей вставки:

353 369 

354* В простой подсказке с оставшимся текстом Claude Code удаляет заполнитель и отправляет оставшийся текст.370* В простой подсказке с оставшимся текстом Claude Code удаляет заполнитель и отправляет оставшийся текст.

355* В [команде режима shell](/docs/ru/interactive-mode#shell-mode-with-prefix) или команде `/`, где удаление изменило бы то, что выполняется, и в любой подсказке, где удаление оставляет пусто, Claude Code отменяет отправку и сохраняет исходный текст в вводе с заполнителем, всё ещё находящимся в нём. Удалите заполнитель или отредактируйте команду, затем повторно отправьте.371* В [команде режима shell](/docs/ru/interactive-mode#shell-mode-with-prefix) или команде `/`, где удаление изменило бы то, что выполняется, и в любой подсказке, где удаление оставляет пусто, Claude Code отменяет отправку и сохраняет исходный текст в вводе с заполнителем, всё ещё находящимся в нём. Удалите заполнитель или отредактируйте команду, затем повторно отправьте.

356 372 

357Интегрированный терминал VS Code может отбросить символы из очень больших вставок, прежде чем они достигнут Claude Code, поэтому предпочитайте там рабочие процессы на основе файлов. Для очень больших входных данных, таких как целые файлы или длинные журналы, запишите содержимое в файл и попросите Claude прочитать его вместо вставки. Это сохраняет стенограмму разговора читаемой и позволяет Claude ссылаться на файл по пути в более поздних ходах.

358 

359<h2 id="edit-prompts-with-vim-keybindings">373<h2 id="edit-prompts-with-vim-keybindings">

360 Редактирование подсказок с сочетаниями клавиш Vim374 Редактирование подсказок с сочетаниями клавиш Vim

361</h2>375</h2>

Details

86 86 

87Для большинства организаций Claude for Teams или Claude for Enterprise обеспечивает лучший опыт. Члены команды получают доступ как к Claude Code, так и к Claude в веб-версии с одной подпиской, централизованным выставлением счетов и без необходимости настройки инфраструктуры.87Для большинства организаций Claude for Teams или Claude for Enterprise обеспечивает лучший опыт. Члены команды получают доступ как к Claude Code, так и к Claude в веб-версии с одной подпиской, централизованным выставлением счетов и без необходимости настройки инфраструктуры.

88 88 

89**Claude for Teams** — это самообслуживаемое решение, которое включает функции сотрудничества, инструменты администратора и управление выставлением счетов. Лучше всего подходит для небольших команд, которым нужно быстро начать работу.89**Claude for Teams** — это самообслуживаемое решение, которое включает функции сотрудничества, инструменты администратора, SSO, управление выставлением счетов и [управляемые параметры сервера](/docs/ru/server-managed-settings) для конфигурации Claude Code на уровне организации. Лучше всего подходит для небольших команд, которым нужно быстро начать работу.

90 90 

91**Claude for Enterprise** добавляет SSO и захват домена, разрешения на основе ролей, доступ к API соответствия требованиям и управляемые параметры политики для развертывания конфигураций Claude Code на уровне организации. Лучше всего подходит для крупных организаций с требованиями безопасности и соответствия требованиям.91**Claude for Enterprise** добавляет захват домена, разрешения на основе ролей и доступ к API соответствия требованиям. Лучше всего подходит для крупных организаций с требованиями безопасности и соответствия требованиям.

92 92 

93Узнайте больше о [планах Team](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) и [планах Enterprise](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).93Узнайте больше о [планах Team](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) и [планах Enterprise](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan).

94 94 

Details

24| `Raw mode is not supported` во время установки | [Повторно запустите установщик](#raw-mode-is-not-supported-during-install) |24| `Raw mode is not supported` во время установки | [Повторно запустите установщик](#raw-mode-is-not-supported-during-install) |

25| `TLS connect error` или `SSL/TLS secure channel` | [Обновите сертификаты CA](#tls-or-ssl-connection-errors) |25| `TLS connect error` или `SSL/TLS secure channel` | [Обновите сертификаты CA](#tls-or-ssl-connection-errors) |

26| `Failed to fetch version` или невозможно достичь сервера загрузки | [Проверьте параметры сети и прокси](#check-network-connectivity) |26| `Failed to fetch version` или невозможно достичь сервера загрузки | [Проверьте параметры сети и прокси](#check-network-connectivity) |

27| `irm is not recognized` или `&& is not valid` | [Используйте правильную команду для вашей оболочки](#wrong-install-command-on-windows) |27| `irm is not recognized` или `The token '&&' is not a valid statement separator` | [Используйте правильную команду для вашей оболочки](#wrong-install-command-on-windows) |

28| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Обновите Homebrew](#homebrew-cask-unavailable-or-outdated) |28| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Обновите Homebrew](#homebrew-cask-unavailable-or-outdated) |

29| `'bash' is not recognized as the name of a cmdlet` | [Используйте команду установщика Windows](#wrong-install-command-on-windows) |29| `'bash' is not recognized as the name of a cmdlet` | [Используйте команду установщика Windows](#wrong-install-command-on-windows) |

30| `A parameter cannot be found that matches parameter name 'fsSL'` | [Используйте команду установщика Windows](#wrong-install-command-on-windows) |30| `A parameter cannot be found that matches parameter name 'fsSL'` | [Используйте команду установщика Windows](#wrong-install-command-on-windows) |

512 Wrong install command on Windows512 Wrong install command on Windows

513</h3>513</h3>

514 514 

515Если вы видите `'irm' is not recognized`, `The token '&&' is not valid`, `A parameter cannot be found that matches parameter name 'fsSL'` или `'bash' is not recognized as the name of a cmdlet`, вы скопировали команду установки для другой оболочки или операционной системы. Если команда выводит текст скрипта вместо установки чего-либо, вы запустили только часть его.515Если вы видите `'irm' is not recognized`, `The token '&&' is not a valid statement separator`, `A parameter cannot be found that matches parameter name 'fsSL'` или `'bash' is not recognized as the name of a cmdlet`, вы скопировали команду установки для другой оболочки или операционной системы. Если команда выводит текст скрипта вместо установки чего-либо, вы запустили только часть его.

516 516 

517* **`irm` не распознан**: вы находитесь в CMD, а не PowerShell. У вас есть два варианта:517* **`irm` не распознан**: вы находитесь в CMD, а не PowerShell. У вас есть два варианта:

518 518 

Details

413. Рассмотрите добавление больших директорий сборки в ваш файл `.gitignore`413. Рассмотрите добавление больших директорий сборки в ваш файл `.gitignore`

424. Перезагрузитесь с помощью [`claude --safe-mode`](/docs/ru/cli-reference#cli-flags), чтобы проверить, является ли источником plugin, MCP server или hook. Это отключает все настройки на время сеанса; если использование снизится, см. [Debug your configuration](/docs/ru/debug-your-config#test-against-a-clean-configuration), чтобы найти, какой именно424. Перезагрузитесь с помощью [`claude --safe-mode`](/docs/ru/cli-reference#cli-flags), чтобы проверить, является ли источником plugin, MCP server или hook. Это отключает все настройки на время сеанса; если использование снизится, см. [Debug your configuration](/docs/ru/debug-your-config#test-against-a-clean-configuration), чтобы найти, какой именно

43 43 

44Если использование памяти в куче сеанса превышает 2.5GB, появляется критическое предупреждение об использовании памяти. Чтобы освободить память, перезагрузите Claude Code и запустите [`claude --continue`](/docs/ru/cli-reference#cli-flags), чтобы возобновить разговор в новом процессе.

45 

46Вне [полноэкранного рендеринга](/docs/ru/fullscreen) запуск `/compact` также освобождает память. Предупреждение исчезает, как только использование памяти упадёт ниже 2.5GB.

47 

44Если использование памяти остаётся высоким после этих шагов, запустите `/heapdump`, чтобы записать два файла на `~/Desktop`: снимок кучи JavaScript с именем `<session-id>.heapsnapshot` и разбор памяти с именем `<session-id>-diagnostics.json`. Claude Code [скрывает команду из меню команд](/docs/ru/commands#how-the-command-menu-matches-what-you-type); введите её полностью. На Linux без папки Desktop файлы записываются в вашу домашнюю директорию.48Если использование памяти остаётся высоким после этих шагов, запустите `/heapdump`, чтобы записать два файла на `~/Desktop`: снимок кучи JavaScript с именем `<session-id>.heapsnapshot` и разбор памяти с именем `<session-id>-diagnostics.json`. Claude Code [скрывает команду из меню команд](/docs/ru/commands#how-the-command-menu-matches-what-you-type); введите её полностью. На Linux без папки Desktop файлы записываются в вашу домашнюю директорию.

45 49 

46<Warning>50<Warning>

108 112 

109Чтобы поместить вывод Claude в ваш буфер обмена, попросите Claude вывести содержимое в его ответе, затем запустите [`/copy`](/docs/ru/commands). `/copy` записывает в буфер обмена из самого процесса Claude Code, а не из изолированной команды, поэтому sandboxing не блокирует это. Он может копировать один блок кода вместо всего ответа, и он также записывает то, что он скопировал, в файл и выводит путь, что даёт вам резервный вариант, когда запись в буфер обмена не достигает вашего терминала, например через SSH.113Чтобы поместить вывод Claude в ваш буфер обмена, попросите Claude вывести содержимое в его ответе, затем запустите [`/copy`](/docs/ru/commands). `/copy` записывает в буфер обмена из самого процесса Claude Code, а не из изолированной команды, поэтому sandboxing не блокирует это. Он может копировать один блок кода вместо всего ответа, и он также записывает то, что он скопировал, в файл и выводит путь, что даёт вам резервный вариант, когда запись в буфер обмена не достигает вашего терминала, например через SSH.

110 114 

111Чтобы позволить переданной команде достичь буфера обмена напрямую, добавьте `pbcopy *`, `wl-copy *` или `xclip *` в [`excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands), чтобы команда работала вне изоляции.115Когда Claude передаёт текст в один из этих инструментов, добавление `pbcopy *`, `wl-copy *` или `xclip *` в [`excludedCommands`](/docs/ru/settings-reference#sandbox-excludedcommands) не выводит этот вызов из sandbox самостоятельно.

112 116 

113<h3 id="copied-text-doesn’t-reach-your-local-clipboard-over-ssh">117<h3 id="copied-text-doesn’t-reach-your-local-clipboard-over-ssh">

114 Скопированный текст не достигает вашего локального буфера обмена через SSH118 Скопированный текст не достигает вашего локального буфера обмена через SSH

ultrareview.md +10 −3

Details

50 50 

51Базовая ветвь не должна существовать в вашем локальном клоне; Claude Code получает её из `origin`. Если имя содержит опечатку, Claude Code предлагает ближайшее имя ветви в ошибке.51Базовая ветвь не должна существовать в вашем локальном клоне; Claude Code получает её из `origin`. Если имя содержит опечатку, Claude Code предлагает ближайшее имя ветви в ошибке.

52 52 

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

54 

53<h3 id="review-a-pull-request">55<h3 id="review-a-pull-request">

54 Анализ запроса на слияние56 Анализ запроса на слияние

55</h3>57</h3>

114Ultrareview проверяет diff перед началом любой работы по анализу и сообщает вам, когда он не может анализировать его как есть:116Ultrareview проверяет diff перед началом любой работы по анализу и сообщает вам, когда он не может анализировать его как есть:

115 117 

116* **Diff слишком большой**: анализ ветки может включать до 500 измененных файлов и 8000 измененных строк по умолчанию. Точные значения могут измениться, и [отказ](/docs/ru/errors#diff-is-too-large-for-ultrareview) указывает на действующие значения, размер вашего diff и файлы с наибольшим количеством измененных строк. Claude Code отказывает в анализе слишком большого запроса на слияние таким же образом, указывая количество файлов и строк, но не разбивку по файлам118* **Diff слишком большой**: анализ ветки может включать до 500 измененных файлов и 8000 измененных строк по умолчанию. Точные значения могут измениться, и [отказ](/docs/ru/errors#diff-is-too-large-for-ultrareview) указывает на действующие значения, размер вашего diff и файлы с наибольшим количеством измененных строк. Claude Code отказывает в анализе слишком большого запроса на слияние таким же образом, указывая количество файлов и строк, но не разбивку по файлам

117* **Нечего анализировать**: когда diff относительно базы пуст, Claude Code говорит об этом и предлагает подготовить или зафиксировать локальные правки или передать другую базу119* **Нечего анализировать**: когда diff относительно базы пуст, ultrareview отказывает и указывает на ветвь или коммит, с которым он сравнивал, и случай, в котором вы находитесь, например, находитесь на самой базовой ветви без ничего незафиксированного, или ветвь, чьи коммиты уже являются частью базы. Он также предлагает способ выхода для этого случая, например переключение на ветвь с вашей работой, подготовка или фиксация локальных правок или передача другой базы

118* **Нет базы слияния**: когда ваша ветвь не имеет общей истории с базовой ветвью, Claude Code переходит на анализ каждого отслеживаемого файла в репозитории; резервный вариант требует полного клона и применяет те же ограничения размера. При проверке без ветвей или других ссылок, такой как отсоединенный HEAD, созданный путем проверки `FETCH_HEAD` после получения URL, Claude Code [отказывает в анализе](/docs/ru/errors#your-checkout-has-no-branches) и предлагает сначала создать ветвь120* **Первый коммит**: первый коммит репозитория не имеет ничего более раннего для сравнения, поэтому ultrareview анализирует каждый файл в нем после вашего подтверждения в диалоговом окне запуска. Если у вас есть неотслеживаемые файлы, он отказывает вместо этого и говорит вам `git add` те, которые вы хотите анализировать. Применяются те же ограничения размера.

121 

122 Первый коммит анализируется целиком только после этого подтверждения, поэтому подкоманда `claude ultrareview` и `claude -p` отказывают в нем и указывают вам на интерактивную сессию вместо этого. Требует Claude Code версии 2.1.277 или позже

123* **Нет базы слияния**: когда ваша ветвь не имеет общей истории с базовой ветвью, или репозиторий не имеет базовой ветви для сравнения, ultrareview анализирует каждый отслеживаемый файл в репозитории вместо этого. Резервный вариант требует полного клона и применяет те же ограничения размера. Он запускается только когда вы подтверждаете в диалоговом окне запуска или запускаете подкоманду `claude ultrareview` самостоятельно. В `claude -p` и везде, где ни то, ни другое не происходит, ultrareview отказывает, говорит, что анализ охватит каждый файл, и указывает вам на интерактивную сессию.

124 

125 При проверке без ветвей или других ссылок, такой как отсоединенный HEAD, созданный путем проверки `FETCH_HEAD` после получения URL, Claude Code [отказывает в анализе](/docs/ru/errors#your-checkout-has-no-branches) и предлагает сначала создать ветвь

119 126 

120<h2 id="pricing-and-free-runs">127<h2 id="pricing-and-free-runs">

121 Цены и бесплатные запуски128 Цены и бесплатные запуски

166 173 

167Без аргументов подкоманда анализирует разницу между вашей текущей ветвью и ветвью по умолчанию, с тем же [резервным вариантом для всего репозитория](#diff-limits-and-fallbacks), что и `/code-review ultra`, когда база слияния не существует. Передайте номер PR для анализа запроса на слияние или базовую ветвь для анализа против нее; [обработка базовой ветви](#review-against-a-different-base) соответствует интерактивной команде.174Без аргументов подкоманда анализирует разницу между вашей текущей ветвью и ветвью по умолчанию, с тем же [резервным вариантом для всего репозитория](#diff-limits-and-fallbacks), что и `/code-review ultra`, когда база слияния не существует. Передайте номер PR для анализа запроса на слияние или базовую ветвь для анализа против нее; [обработка базовой ветви](#review-against-a-different-base) соответствует интерактивной команде.

168 175 

169Вы даете согласие на резервный вариант для всего репозитория и на подсказку выставления счетов и условий при запуске подкоманды, поэтому запуск начинается без ожидания ввода.176Вы даете согласие на резервный вариант для всего репозитория и на подсказку выставления счетов и условий при запуске подкоманды, поэтому запуск начинается без ожидания ввода. Запуск его самостоятельно — это то, что считается согласием. Когда Claude запускает подкоманду для вас вместо этого, например через инструмент Bash, Claude Code отказывает в анализе всего репозитория.

170 177 

171В Claude Code v2.1.218 или позже вы также можете запустить облачный анализ, запустив `/code-review ultra` в неинтерактивной сессии, например `claude -p '/code-review ultra'`. Claude Code запускает анализ и выводит ссылку отслеживания без ожидания результатов, в отличие от `claude ultrareview`, который блокирует до их получения. Когда анализ будет выставлять счета за использование кредитов, Claude Code останавливается перед запуском и указывает вам на `claude ultrareview`, потому что подтверждение выставления счетов требует интерактивной сессии. До v2.1.218 `/code-review ultra` в неинтерактивной сессии запускал локальный анализ.178В Claude Code v2.1.218 или позже вы также можете запустить облачный анализ, запустив `/code-review ultra` в неинтерактивной сессии, например `claude -p '/code-review ultra'`. Claude Code запускает анализ и выводит ссылку отслеживания без ожидания результатов, в отличие от `claude ultrareview`, который блокирует до их получения. Когда анализ будет выставлять счета за использование кредитов, Claude Code останавливается перед запуском и указывает вам на `claude ultrareview`, потому что подтверждение выставления счетов требует интерактивной сессии. До v2.1.218 `/code-review ultra` в неинтерактивной сессии запускал локальный анализ.

172 179 

vs-code.md +80 −15

Details

90 * В режиме Manual, когда Claude хочет отредактировать файл, он показывает сравнение исходного и предложенного изменений рядом, а затем запрашивает разрешение. Вы можете принять, отклонить или сказать Claude, что делать вместо этого. Если вы отредактируете предложенное содержимое непосредственно в представлении diff перед принятием, Claude будет уведомлен, что вы его изменили, поэтому он не будет предполагать, что файл соответствует его исходному предложению.90 * В режиме Manual, когда Claude хочет отредактировать файл, он показывает сравнение исходного и предложенного изменений рядом, а затем запрашивает разрешение. Вы можете принять, отклонить или сказать Claude, что делать вместо этого. Если вы отредактируете предложенное содержимое непосредственно в представлении diff перед принятием, Claude будет уведомлен, что вы его изменили, поэтому он не будет предполагать, что файл соответствует его исходному предложению.

91 91 

92 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code showing a diff of Claude's proposed changes with a permission prompt asking whether to make the edit" width="3292" height="1876" data-path="images/vs-code-edits.png" />92 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code showing a diff of Claude's proposed changes with a permission prompt asking whether to make the edit" width="3292" height="1876" data-path="images/vs-code-edits.png" />

93 

94 Чтобы проверить предложенное редактирование по одному изменению за раз, используйте кнопки **Accept this change** и **Reject this change** под каждым изменением в diff. Отклонение изменения отменяет его в предложенном содержимом; принятие отмечает его как проверенное. Принятие или отклонение всего файла все равно завершает проверку. Diff с более чем 100 изменениями открывается без кнопок для каждого изменения, поэтому проверьте его как целый файл. Проверка по изменениям требует Claude Code v2.1.275 или более поздней версии.

95 

96 Те же действия доступны в курсоре из контекстного меню редактора и из Command Palette как **Claude Code: Accept Change at Cursor** и **Claude Code: Reject Change at Cursor**.

93 </Step>97 </Step>

94</Steps>98</Steps>

95 99 

110 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством команд оболочки.114 * **Manual**: Claude запрашивает разрешение перед редактированием файлов и большинством команд оболочки.

111 * **Plan**: Claude описывает, что он будет делать, и ждет одобрения перед внесением изменений. VS Code автоматически открывает план как полный документ Markdown, где вы можете добавлять встроенные комментарии, чтобы дать обратную связь перед началом работы Claude.115 * **Plan**: Claude описывает, что он будет делать, и ждет одобрения перед внесением изменений. VS Code автоматически открывает план как полный документ Markdown, где вы можете добавлять встроенные комментарии, чтобы дать обратную связь перед началом работы Claude.

112 * **Edit automatically**: Claude вносит изменения без запроса.116 * **Edit automatically**: Claude вносит изменения без запроса.

113* **Model**: выберите **Switch model…** из меню команд, чтобы изменить модель во время сеанса. Вы также можете нажать на имя модели в нижней части поля ввода подсказки, чтобы открыть тот же выбор. Когда текущая модель поддерживает [уровни усилий](/docs/ru/model-config#adjust-effort-level), выбор также показывает строку **Effort** и кнопка имени модели показывает выбранный уровень. Кнопка имени модели и строка **Effort** требуют Claude Code v2.1.257 или позже.117* **Model**: выберите **Switch model…** из меню команд, чтобы изменить модель во время сеанса. Вы также можете нажать на имя модели в нижней части поля ввода подсказки, чтобы открыть тот же выбор.

114* **Command menu**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей и переключение расширенного мышления. Раздел Customize предоставляет доступ к серверам MCP, slash commands, стилям вывода, hooks, памяти, разрешениям и плагинам. Элементы со значком терминала открываются в интегрированном терминале.118 

119 Когда текущая модель поддерживает [уровни усилий](/docs/ru/model-config#adjust-effort-level), выбор также показывает строку **Effort** и кнопка имени модели показывает выбранный уровень. Когда вы выбираете уровень, отличный от `max`, Claude Code сохраняет его для текущей модели как ваше значение по умолчанию в разделе [`modelSettings`](/docs/ru/settings-reference#modelsettings) в ваших пользовательских параметрах; `max` применяется только к текущему сеансу. Кнопка имени модели и строка **Effort** требуют Claude Code v2.1.257 или позже.

120* **Command menu**: нажмите `/` или введите `/`, чтобы открыть меню команд. Опции включают присоединение файлов, переключение моделей и переключение расширенного мышления.

121 

122 Раздел Customize предоставляет доступ к серверам MCP, slash commands, стилям вывода, hooks, памяти, инструкциям, разрешениям и плагинам. Элементы со значком терминала открываются в интегрированном терминале.

123 

115 * Для просмотра команд, таких как `/usage` или [`/remote-control`](/docs/ru/remote-control), выберите **Slash commands** в разделе Customize. Диалог отображает их с полем фильтра. Выберите один для его запуска. Ввод `/` в поле ввода подсказки по-прежнему предлагает команды встроенным образом. Требует Claude Code v2.1.257 или позже.124 * Для просмотра команд, таких как `/usage` или [`/remote-control`](/docs/ru/remote-control), выберите **Slash commands** в разделе Customize. Диалог отображает их с полем фильтра. Выберите один для его запуска. Ввод `/` в поле ввода подсказки по-прежнему предлагает команды встроенным образом. Требует Claude Code v2.1.257 или позже.

116 * Выберите **Output styles** в разделе Customize, чтобы выбрать [стиль вывода](/docs/ru/output-styles), включая ваши пользовательские стили. Требует Claude Code v2.1.257 или позже.125 * Выберите **Output styles** в разделе Customize, чтобы выбрать [стиль вывода](/docs/ru/output-styles), включая ваши пользовательские стили. Требует Claude Code v2.1.257 или позже.

117 126 

118 Чтобы создать пользовательский стиль, выберите **Build a custom style** из меню **Output styles**. Claude Code записывает [файл стиля](/docs/ru/output-styles#create-a-custom-output-style) для вас на уровне проекта или пользователя. Требует Claude Code v2.1.261 или позже.127 Чтобы создать пользовательский стиль, выберите **Build a custom style** из меню **Output styles**. Claude Code записывает [файл стиля](/docs/ru/output-styles#create-a-custom-output-style) для вас на уровне проекта или пользователя. Требует Claude Code v2.1.261 или позже.

119 * Выберите **Hooks** в разделе Customize, чтобы просмотреть [hooks](/docs/ru/hooks), загруженные в сеанс, сгруппированные по событиям. Вы можете добавлять, редактировать или удалять hooks, сохраненные в ваших файлах пользовательских, проектных и локальных параметров. Hooks из других источников, таких как управляемые параметры или плагины, доступны только для чтения. Требует Claude Code v2.1.269 или позже.128 * Выберите **Hooks** в разделе Customize, чтобы просмотреть [hooks](/docs/ru/hooks), загруженные в сеанс, сгруппированные по событиям. Вы можете добавлять, редактировать или удалять hooks, сохраненные в ваших файлах пользовательских, проектных и локальных параметров. Hooks из других источников, таких как управляемые параметры или плагины, доступны только для чтения. Требует Claude Code v2.1.269 или позже.

120 * Выберите **Permissions** в разделе Customize, чтобы просмотреть [правила разрешений](/docs/ru/permissions) сеанса, сгруппированные в Allow, Ask и Deny. Вы можете добавлять правила в ваши пользовательские, проектные или локальные параметры и удалять правила, сохраненные там. Правила из других источников, таких как управляемые параметры или одобрения, сделанные только для этого сеанса, доступны только для чтения. Требует Claude Code v2.1.269 или позже.129 * Выберите **Permissions** в разделе Customize, чтобы просмотреть [правила разрешений](/docs/ru/permissions) сеанса, сгруппированные в Allow, Ask и Deny. Вы можете добавлять правила в ваши пользовательские, проектные или локальные параметры и удалять правила, сохраненные там. Правила из других источников, таких как управляемые параметры или одобрения, сделанные только для этого сеанса, доступны только для чтения. Требует Claude Code v2.1.269 или позже.

130 * Выберите **Memory** в разделе Customize, чтобы включить или отключить [автоматическую память](/docs/ru/memory#auto-memory). Пока она включена, вы также можете просматривать воспоминания, которые Claude сохранил, и открывать папки, в которых они хранятся, в вашем файловом менеджере. Требует Claude Code v2.1.274 или позже.

131 

132 Нажмите на сохраненное воспоминание, чтобы прочитать его в диалоге, где вы можете редактировать текст, удалить воспоминание или открыть его файл в редакторе. Просмотр, редактирование и удаление воспоминания в диалоге требуют Claude Code v2.1.275 или позже.

133 * Выберите **Instructions** в разделе Customize, чтобы отредактировать [файлы CLAUDE.md](/docs/ru/memory#claude-md-files), которые читает Claude. Выберите файл, чтобы открыть его в редакторе. Если файл еще не существует, Claude Code создает его сначала. Требует Claude Code v2.1.274 или позже.

121 * Раздел Settings включает **Enable Remote Control for all sessions**, который устанавливает [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) для управления тем, [подключаются ли новые интерактивные сеансы к Remote Control автоматически](/docs/ru/remote-control#enable-remote-control-for-all-sessions). Требует Claude Code v2.1.203 или позже.134 * Раздел Settings включает **Enable Remote Control for all sessions**, который устанавливает [`remoteControlAtStartup`](/docs/ru/settings-reference#remotecontrolatstartup) для управления тем, [подключаются ли новые интерактивные сеансы к Remote Control автоматически](/docs/ru/remote-control#enable-remote-control-for-all-sessions). Требует Claude Code v2.1.203 или позже.

122 135 

123 Когда вы включаете или выключаете переключатель в окне VS Code, изменение применяется к сеансам, уже открытым в этом окне VS Code, а не только к сеансам, которые вы запускаете позже. Если вы его выключите, открытые сеансы отключатся. С Claude Code v2.1.261 или позже изменение также достигает сеансов, открытых в ваших других окнах VS Code.136 Когда вы включаете или выключаете переключатель в окне VS Code, изменение применяется к сеансам, уже открытым в этом окне VS Code, а не только к сеансам, которые вы запускаете позже. Если вы его выключите, открытые сеансы отключатся. С Claude Code v2.1.261 или позже изменение также достигает сеансов, открытых в ваших других окнах VS Code.

124 * Раздел Settings также включает **Focus view**, который скрывает вызовы инструментов, результаты инструментов и мышление за расширяемыми строками, оставляя ваши подсказки и ответы Claude. Переключайте его там, с `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), или из Command Palette с **Claude Code: Toggle Focus view**. Изменение применяется к каждому открытому сеансу и сохраняется между сеансами. Требует Claude Code v2.1.221 или позже.137 * Раздел Settings также включает **Focus view**, который скрывает вызовы инструментов, результаты инструментов и мышление за расширяемыми строками, оставляя ваши подсказки и ответы Claude. Переключайте его там, с `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), или из Command Palette с **Claude Code: Toggle Focus view**. Изменение применяется к каждому открытому сеансу и сохраняется между сеансами. Требует Claude Code v2.1.221 или позже.

125 138 

126 Последний список дел Claude остается видимым, как и текст, о котором задает вопрос ожидающий вопрос от Claude; это требует Claude Code v2.1.225 или позже. Пока Claude запускает [подагентов](/docs/ru/sub-agents), строки прямого прогресса с их последней активностью появляются под группой вызовов инструментов, которая их запустила. Это требует Claude Code v2.1.269 или позже.139 Последний список дел Claude остается видимым, как и текст, о котором задает вопрос ожидающий вопрос от Claude; это требует Claude Code v2.1.225 или позже. Пока Claude запускает [подагентов](/docs/ru/sub-agents), строки прямого прогресса с их последней активностью появляются под группой вызовов инструментов, которая их запустила. Это требует Claude Code v2.1.269 или позже.

140 * Чтобы выйти из своей учетной записи Anthropic, выберите **Sign out** в разделе Settings, или введите `/logout`. На [поставщике третьей стороны](#use-third-party-providers) меню не предлагает ни того, ни другого. Требует Claude Code v2.1.277 или позже.

127 * Чтобы сообщить об ошибке, нажмите **Report a problem** в нижней части меню, или введите `/bug` или `/feedback` с необязательным описанием, которое предварительно заполняет отчет. Когда вы отправляете отчет и вы вошли в Anthropic на подключении первой стороны, Claude Code отправляет его в Anthropic. У поставщика третьей стороны или без учетных данных Anthropic диалог все еще открывается, но отправка показывает ошибку и ничего не отправляет: в отличие от `/bug` CLI, расширение не записывает локальный архив. Требует Claude Code v2.1.229 или позже.141 * Чтобы сообщить об ошибке, нажмите **Report a problem** в нижней части меню, или введите `/bug` или `/feedback` с необязательным описанием, которое предварительно заполняет отчет. Когда вы отправляете отчет и вы вошли в Anthropic на подключении первой стороны, Claude Code отправляет его в Anthropic. У поставщика третьей стороны или без учетных данных Anthropic диалог все еще открывается, но отправка показывает ошибку и ничего не отправляет: в отличие от `/bug` CLI, расширение не записывает локальный архив. Требует Claude Code v2.1.229 или позже.

128 142 

129 Если политика вашей организации отключает отзывы о продукте, **Report a problem** не появляется в меню, и `/bug` и `/feedback` показывают уведомление `Feedback is turned off by your organization's policy or this environment's settings.` вместо открытия отчета.143 Если политика вашей организации отключает отзывы о продукте, **Report a problem** не появляется в меню, и `/bug` и `/feedback` показывают уведомление `Feedback is turned off by your organization's policy or this environment's settings.` вместо открытия отчета.

130* **Side questions**: введите `/btw` с последующим вопросом, чтобы задать вопрос о вашем сеансе [без добавления в разговор](/docs/ru/interactive-mode#side-questions-with-%2Fbtw). Ответ открывается в панели рядом с чатом, где вы можете задавать дополнительные вопросы. Поток сохраняется при перезагрузке окна. Claude Code сохраняет новейшие 20 обменов и истекает сохраненные потоки по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), пока Claude Code может [безопасно определить период хранения](/docs/ru/claude-directory#cleaned-up-automatically). Чтобы очистить поток, нажмите на значок корзины в панели. Требует Claude Code v2.1.227 или позже.144* **Side questions**: введите `/btw` с последующим вопросом, чтобы задать вопрос о вашем сеансе [без добавления в разговор](/docs/ru/interactive-mode#side-questions-with-%2Fbtw). Ответ открывается в панели рядом с чатом, где вы можете задавать дополнительные вопросы. Поток сохраняется при перезагрузке окна. Claude Code сохраняет новейшие 20 обменов и истекает сохраненные потоки по расписанию [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays), пока Claude Code может [безопасно определить период хранения](/docs/ru/claude-directory#cleaned-up-automatically). Чтобы очистить поток, нажмите на значок корзины в панели. Требует Claude Code v2.1.227 или позже.

145* **Copy a response**: наведите курсор на ответ и нажмите **Copy response**, чтобы скопировать его в буфер обмена, или введите `/copy`, чтобы скопировать последний ответ. `/copy 2` копирует второй с конца. Требует Claude Code v2.1.277 или позже.

131* **Context indicator**: поле ввода подсказки показывает, сколько контекстного окна Claude вы используете. Claude автоматически компактирует при необходимости, или вы можете запустить `/compact` вручную.146* **Context indicator**: поле ввода подсказки показывает, сколько контекстного окна Claude вы используете. Claude автоматически компактирует при необходимости, или вы можете запустить `/compact` вручную.

132* **Prompt cache clock**: значок часов рядом с индикатором контекста оценивает, сколько времени осталось у [prompt cache](/docs/ru/prompt-caching) разговора перед его истечением. Он отсчитывает от [времени жизни](/docs/ru/prompt-caching#cache-lifetime) кэша в пять минут или один час, и каждый ответ, который использует кэш, перезапускает обратный отсчет. Помимо компактирования, [действия, которые делают кэш недействительным](/docs/ru/prompt-caching#actions-that-invalidate-the-cache), не сбрасывают часы, поэтому они все еще могут показывать оставшиеся минуты после переключения моделей.147* **Prompt cache clock**: значок часов рядом с индикатором контекста оценивает, сколько времени осталось у [prompt cache](/docs/ru/prompt-caching) разговора перед его истечением. Он отсчитывает от [времени жизни](/docs/ru/prompt-caching#cache-lifetime) кэша в пять минут или один час, и каждый ответ, который использует кэш, перезапускает обратный отсчет. Помимо компактирования, [действия, которые делают кэш недействительным](/docs/ru/prompt-caching#actions-that-invalidate-the-cache), не сбрасывают часы, поэтому они все еще могут показывать оставшиеся минуты после переключения моделей.

133 * До истечения обратного отсчета значок показывает оставшиеся минуты, такие как **12m**.148 * До истечения обратного отсчета значок показывает оставшиеся минуты, такие как **12m**.

136* **Agent map**: когда разговор включает [подагентов](/docs/ru/sub-agents), счетчик агентов, такой как **2 agents**, появляется в нижней части поля ввода подсказки. Его точка показывает, работает ли какой-либо подагент или ожидает вашего разрешения.151* **Agent map**: когда разговор включает [подагентов](/docs/ru/sub-agents), счетчик агентов, такой как **2 agents**, появляется в нижней части поля ввода подсказки. Его точка показывает, работает ли какой-либо подагент или ожидает вашего разрешения.

137 152 

138 Нажмите на счетчик агентов, чтобы открыть карту агентов, которая рисует подагентов разговора как дерево под главным агентом, каждый с его статусом, прошедшим временем и счетчиком токенов. Нажмите на подагента, чтобы увидеть его подсказку и вызовы инструментов, открыть его транскрипт только для чтения или остановить его во время работы. Требует Claude Code v2.1.269 или позже.153 Нажмите на счетчик агентов, чтобы открыть карту агентов, которая рисует подагентов разговора как дерево под главным агентом, каждый с его статусом, прошедшим временем и счетчиком токенов. Нажмите на подагента, чтобы увидеть его подсказку и вызовы инструментов, открыть его транскрипт только для чтения или остановить его во время работы. Требует Claude Code v2.1.269 или позже.

154 

155 Карта также отображает другие [фоновые задачи](/docs/ru/tools-reference#background-commands) сеанса, такие как фоновые команды оболочки и [мониторы](/docs/ru/tools-reference#monitor-tool), ниже агентов. Нажмите на строку, чтобы открыть карточку задачи и остановить ее там.

156 

157 Чтобы открыть карту, когда счетчик агентов не отображается, например когда Claude запустил фоновую команду оболочки, но нет подагентов, введите `/tasks` в поле ввода подсказки. Фоновые задачи на карте и введенная `/tasks` требуют Claude Code v2.1.277 или позже.

139* **Extended thinking**: позволяет Claude потратить больше времени на рассуждение о сложных проблемах. Переключайте его через меню команд (`/`). Рассуждение Claude появляется в разговоре как свернутые блоки: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть каждый блок мышления в сеансе. Смотрите [Extended thinking](/docs/ru/model-config#extended-thinking) для деталей.158* **Extended thinking**: позволяет Claude потратить больше времени на рассуждение о сложных проблемах. Переключайте его через меню команд (`/`). Рассуждение Claude появляется в разговоре как свернутые блоки: нажмите на блок, чтобы прочитать его, или нажмите `Ctrl+O`, чтобы развернуть или свернуть каждый блок мышления в сеансе. Смотрите [Extended thinking](/docs/ru/model-config#extended-thinking) для деталей.

140* **Multi-line input**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в вводе свободного текста "Other" диалогов вопросов.159* **Multi-line input**: нажмите `Shift+Enter`, чтобы добавить новую строку без отправки. Это также работает в вводе свободного текста "Other" диалогов вопросов.

141 160 

154 173 

155Когда вы выбираете текст в редакторе, Claude может видеть ваш выделенный код автоматически. Нижняя часть поля ввода подсказки показывает, сколько строк выбрано. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы вставить @-упоминание с путем файла и номерами строк (например, `@app.ts#5-10`). Нажмите **X** на индикаторе выделения, чтобы удалить его, чтобы Claude не получал выделение. Индикатор появляется снова, когда вы выбираете другой текст.174Когда вы выбираете текст в редакторе, Claude может видеть ваш выделенный код автоматически. Нижняя часть поля ввода подсказки показывает, сколько строк выбрано. Нажмите `Option+K` (Mac) / `Alt+K` (Windows/Linux), чтобы вставить @-упоминание с путем файла и номерами строк (например, `@app.ts#5-10`). Нажмите **X** на индикаторе выделения, чтобы удалить его, чтобы Claude не получал выделение. Индикатор появляется снова, когда вы выбираете другой текст.

156 175 

176Расширение скрывает выбранный текст из некоторых файлов. Когда файл находится внутри вашего рабочего пространства и соответствует вашим параметрам `files.exclude` или `search.exclude`, Claude получает максимум путь файла и не получает текст, который вы выбрали. То же самое применяется к файлу, который игнорирует git, пока параметр `search.useIgnoreFiles` VS Code и параметр [`respectGitIgnore`](#extension-settings) расширения оба включены, что является значением по умолчанию. Этот фильтр охватывает только панель чата: когда Claude Code работает в интегрированном терминале, CLI отправляет ваш выбранный текст независимо от файла, поэтому добавьте [правило отрицания `Read`](#the-built-in-ide-mcp-server), чтобы содержимое файла не попало к Claude там.

177 

157Claude также видит, какой файл у вас открыт в редакторе, даже когда ничего не выбрано, и поле ввода подсказки показывает его имя. Чтобы добавить только выбранный текст, отключите [параметр Attach Open File](vscode://settings/claudeCode.attachOpenFile). Параметр требует Claude Code v2.1.271 или позже.178Claude также видит, какой файл у вас открыт в редакторе, даже когда ничего не выбрано, и поле ввода подсказки показывает его имя. Чтобы добавить только выбранный текст, отключите [параметр Attach Open File](vscode://settings/claudeCode.attachOpenFile). Параметр требует Claude Code v2.1.271 или позже.

158 179 

159Чтобы прикрепить изображение, вставьте его из буфера обмена в поле ввода подсказки. Вы также можете удерживать `Shift` при перетаскивании файлов в поле ввода подсказки, чтобы добавить их как вложения. Нажмите X на любом вложении, чтобы удалить его из контекста.180Вы также можете прикреплять изображения и файлы к вашему сообщению:

181 

182* Чтобы прикрепить изображение, вставьте его из буфера обмена в поле ввода подсказки.

183* Чтобы прикрепить файлы, удерживайте `Shift` при перетаскивании их в поле ввода подсказки.

184* Чтобы удалить вложение из контекста, нажмите X на нем.

160 185 

161<h3 id="resume-past-conversations">186<h3 id="resume-past-conversations">

162 Возобновление прошлых разговоров187 Возобновление прошлых разговоров

171 196 

172По умолчанию сеанс без активности в течение 14 дней переходит в **Archived sessions** автоматически, если только он не открыт, не прочитан или не находится в [группе](#organize-sessions-into-groups). Автоматическое архивирование требует Claude Code v2.1.265 или позже. Чтобы изменить период или отключить его, откройте [Archive Inactive Sessions setting](vscode://settings/claudeCode.archiveInactiveSessions) и выберите количество дней или **Never**.197По умолчанию сеанс без активности в течение 14 дней переходит в **Archived sessions** автоматически, если только он не открыт, не прочитан или не находится в [группе](#organize-sessions-into-groups). Автоматическое архивирование требует Claude Code v2.1.265 или позже. Чтобы изменить период или отключить его, откройте [Archive Inactive Sessions setting](vscode://settings/claudeCode.archiveInactiveSessions) и выберите количество дней или **Never**.

173 198 

174Чтобы восстановить архивированный сеанс, разверните **Archived sessions** и нажмите **Unarchive session**. До v2.1.257 действие было **Delete session**, которое скрывало сеанс без возможности его восстановления. Сеансы, которые вы удалили, появляются в **Archived sessions** после обновления.199Чтобы восстановить архивированный сеанс, разверните **Archived sessions** и нажмите **Unarchive session**. Чтобы восстановить каждый архивированный сеанс сразу, наведите курсор на заголовок **Archived sessions** в списке сеансов в Activity Bar и нажмите его значок разархивирования, что требует Claude Code v2.1.277 или позже. До v2.1.257 действие было **Delete session**, которое скрывало сеанс без возможности его восстановления. Сеансы, которые вы удалили, появляются в **Archived sessions** после обновления.

175 200 

176Когда разговор, который вы возобновляете, закончился в режиме плана, Claude Code восстанавливает режим плана. Требует Claude Code v2.1.246 или позже. Claude Code не восстанавливает его в двух случаях:201Когда разговор, который вы возобновляете, закончился в режиме плана, Claude Code восстанавливает режим плана. Требует Claude Code v2.1.246 или позже. Claude Code не восстанавливает его в двух случаях:

177 202 

206 Проверка учетной записи и использования231 Проверка учетной записи и использования

207</h3>232</h3>

208 233 

209Запустите `/usage`, чтобы открыть диалог Account & usage. Диалог требует входа в claude.ai, поэтому он не предлагается у [поставщика третьей стороны](#use-third-party-providers). Он показывает вашу учетную запись, в которую вы вошли, ваш план и полосы использования для ограничений вашего плана, таких как текущий сеанс и неделя. Каждая полоса показывает, как долго до сброса ее лимита.234Запустите `/usage`, чтобы открыть диалог Account & usage. Он показывает вашу учетную запись, в которую вы вошли, и использование отличается в зависимости от входа:

210 235 

211Диалог также разбивает то, что способствует ограничениям вашего плана. Он отмечает поведение, которое составляет 10% или более недавнего использования, такое как промахи кэша, длинный контекст и сеансы с большим количеством подагентов или высокой параллелизацией, каждый с советом по его снижению. Таблицы атрибуции показывают, сколько использования пришло из каждого skill, подагента, плагина и сервера MCP.236* **claude.ai plan**: полосы использования для ограничений вашего плана, таких как текущий сеанс и неделя. Каждая полоса показывает, как долго до сброса ее лимита.

212 237 

213Используйте переключатель Day и Week для переключения между последними 24 часами и последними 7 днями. Цифры являются приблизительными и вычисляются из локальных сеансов на этой машине, поэтому использование с других устройств или claude.ai не включено. Для получения дополнительной информации об отслеживании и снижении использования смотрите [Track your costs](/docs/ru/costs#track-your-costs).238 Диалог также разбивает то, что способствует ограничениям вашего плана. Он отмечает поведение, которое составляет 10% или более недавнего использования, такое как промахи кэша, длинный контекст и сеансы с большим количеством подагентов или высокой параллелизацией, каждый с советом по его снижению. Таблицы атрибуции показывают, сколько использования пришло из каждого skill, подагента, плагина и сервера MCP.

239 

240 Используйте переключатель Day и Week для переключения между последними 24 часами и последними 7 днями. Цифры являются приблизительными и вычисляются из локальных сеансов на этой машине, поэтому использование с других устройств или claude.ai не включено.

241* **Other sign-ins**: когда ограничения плана не применяются к вашему входу, например на [поставщике третьей стороны](#use-third-party-providers) или с ключом API, раздел Usage показывает стоимость сеанса и использование токенов вместо этого. `/usage` CLI показывает те же итоги в его [Session block](/docs/ru/costs#track-your-costs). Список сеансов в Activity Bar также показывает итоги активного сеанса под его заголовком **Account & usage**. Требует Claude Code v2.1.277 или позже.

242 

243Для получения дополнительной информации об отслеживании и снижении использования смотрите [Track your costs](/docs/ru/costs#track-your-costs).

214 244 

215<h2 id="customize-your-workflow">245<h2 id="customize-your-workflow">

216 Настройте свой рабочий процесс246 Настройте свой рабочий процесс

228* **Основная боковая панель**: левая боковая панель со значками для Explorer, Search и т. д.258* **Основная боковая панель**: левая боковая панель со значками для Explorer, Search и т. д.

229* **Область редактора**: открывает Claude как вкладку рядом с вашими файлами. Полезно для дополнительных задач.259* **Область редактора**: открывает Claude как вкладку рядом с вашими файлами. Полезно для дополнительных задач.

230 260 

261Когда Claude открывает вкладку в новой группе редактора, расширение блокирует эту группу, поэтому файлы, которые вы открываете, пока вкладка Claude сфокусирована, переходят в другую группу вместо того, чтобы находиться рядом с ней.

262 

263Чтобы остановить блокировку групп расширением, отключите [параметр Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Группы, которые уже заблокированы, остаются заблокированными, пока вы их не разблокируете. Этот параметр требует Claude Code v2.1.274 или позже.

264 

231<Tip>265<Tip>

232 Используйте боковую панель для вашего основного сеанса Claude и открывайте дополнительные вкладки для дополнительных задач. Claude запоминает ваше предпочтительное местоположение. Значок списка сеансов на панели действий отделён от панели Claude: список сеансов всегда виден на панели действий, а значок панели Claude появляется там только при закреплении панели на левой боковой панели.266 Используйте боковую панель для вашего основного сеанса Claude и открывайте дополнительные вкладки для дополнительных задач. Claude запоминает ваше предпочтительное местоположение. Значок списка сеансов на панели действий отделён от панели Claude: список сеансов всегда виден на панели действий, а значок панели Claude появляется там только при закреплении панели на левой боковой панели.

233</Tip>267</Tip>

237* **Вкладка редактора**: разговор возвращается с его вкладкой.271* **Вкладка редактора**: разговор возвращается с его вкладкой.

238* **Боковая панель**: разговор возвращается, если вы отправили сообщение или Claude ответил в нём в течение последних 10 минут. Если он не возвращается, возобновите разговор из [истории сеансов](#resume-past-conversations).272* **Боковая панель**: разговор возвращается, если вы отправили сообщение или Claude ответил в нём в течение последних 10 минут. Если он не возвращается, возобновите разговор из [истории сеансов](#resume-past-conversations).

239 273 

274Если перезагрузка прервала Claude в середине шага, Claude продолжит этот шаг, когда разговор вернётся, и уведомление в чате отметит продолжение. Требуется Claude Code v2.1.274 или позже. Если шаг был прерван более часа назад или сеанс открыт в другом месте, разговор вернётся в неактивном состоянии.

275 

276Чтобы отключить продолжение, откройте [параметр Continue After Reload](vscode://settings/claudeCode.continueAfterReload) и снимите флажок.

277 

240<h3 id="run-multiple-conversations">278<h3 id="run-multiple-conversations">

241 Запустите несколько разговоров279 Запустите несколько разговоров

242</h3>280</h3>

304URL принимает два параметра запроса:342URL принимает два параметра запроса:

305 343 

306| Параметр | Описание |344| Параметр | Описание |

307| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |345| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

308| `plugin` | Имя плагина, как его указывает маркетплейс. Обязательно. |346| `plugin` | Имя плагина, как его указывает маркетплейс. Обязательно. |

309| `marketplace` | Источник плагина в любой форме, которую принимает [вкладка Маркетплейсы](#manage-marketplaces), например GitHub `owner/repo` или git URL. Закодируйте его в URL, если он содержит символы, такие как `&`. По умолчанию используется `anthropics/claude-plugins-official`, если не указано. |347| `marketplace` | Источник плагина: репозиторий GitHub `owner/repo`, URL `https://` или git SSH URL, например `git@github.com:owner/repo.git`. По умолчанию используется `anthropics/claude-plugins-official`, если не указано. |

348 

349Некоторые значения, которые принимает [вкладка Маркетплейсы](#manage-marketplaces), не работают в ссылке, например локальный путь или адрес `http://`. Для них VS Code показывает сообщение об ошибке и диалоговое окно не открывается.

310 350 

311Два случая заканчиваются сообщением в диалоговом окне вместо выбора области:351Два случая заканчиваются сообщением в диалоговом окне вместо выбора области:

312 352 

364</Note>404</Note>

365 405 

366| Команда | Сочетание клавиш | Описание |406| Команда | Сочетание клавиш | Описание |

367| -------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |407| -------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

368| Focus Input | `Cmd+Esc` (Mac) / `Ctrl+Esc` (Windows/Linux) | Переключение фокуса между редактором и Claude |408| Focus Input | `Cmd+Esc` (Mac) / `Ctrl+Esc` (Windows/Linux) | Переключение фокуса между редактором и Claude |

409| Focus last message | - | Переместить фокус клавиатуры на самое новое сообщение в разговоре или на ожидающий запрос разрешения, чтобы вы могли читать оттуда с помощью клавиатуры или программы чтения с экрана. Недоступно в [режиме терминала](#switch-to-terminal-mode). Требует Claude Code v2.1.268 или позже |

369| Open in Side Bar | - | Открыть Claude на боковой панели |410| Open in Side Bar | - | Открыть Claude на боковой панели |

370| Open in Terminal | - | Открыть Claude в режиме терминала |411| Open in Terminal | - | Открыть Claude в режиме терминала |

371| Open in New Tab | `Cmd+Shift+Esc` (Mac) / `Ctrl+Shift+Esc` (Windows/Linux) | Открыть новый разговор в виде вкладки редактора |412| Open in New Tab | `Cmd+Shift+Esc` (Mac) / `Ctrl+Shift+Esc` (Windows/Linux) | Открыть новый разговор в виде вкладки редактора |

373| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Начать новый разговор. Требует, чтобы Claude был в фокусе и `enableNewConversationShortcut` был установлен на `true` |414| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Начать новый разговор. Требует, чтобы Claude был в фокусе и `enableNewConversationShortcut` был установлен на `true` |

374| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Повторно открыть самую недавно закрытую вкладку сеанса Claude. Переходит к обычному переоткрытию закрытого редактора VS Code, если последняя закрытая вкладка не была сеансом Claude. Отключить с помощью `enableReopenClosedSessionShortcut` |415| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Повторно открыть самую недавно закрытую вкладку сеанса Claude. Переходит к обычному переоткрытию закрытого редактора VS Code, если последняя закрытая вкладка не была сеансом Claude. Отключить с помощью `enableReopenClosedSessionShortcut` |

375| Insert @-Mention Reference | `Option+K` (Mac) / `Alt+K` (Windows/Linux) | Вставить ссылку на текущий файл и выделение (требует, чтобы редактор был в фокусе) |416| Insert @-Mention Reference | `Option+K` (Mac) / `Alt+K` (Windows/Linux) | Вставить ссылку на текущий файл и выделение (требует, чтобы редактор был в фокусе) |

417| Accept Change at Cursor | - | Принять изменение в позиции курсора при [проверке предложенного редактирования](#get-started) одно изменение за раз. Требует Claude Code v2.1.275 или позже |

418| Reject Change at Cursor | - | Отменить изменение в позиции курсора при проверке предложенного редактирования одно изменение за раз. Требует Claude Code v2.1.275 или позже |

376| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Скрыть или показать активность инструментов в разговоре. Работает, когда видна панель Claude или боковая панель. Требует Claude Code v2.1.221 или позже |419| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Скрыть или показать активность инструментов в разговоре. Работает, когда видна панель Claude или боковая панель. Требует Claude Code v2.1.221 или позже |

377| Rename Session Tab | - | Переименовать сеанс на активной вкладке Claude. Требует Claude Code v2.1.257 или позже |420| Rename Session Tab | - | Переименовать сеанс на активной вкладке Claude. Требует Claude Code v2.1.257 или позже |

378| Add Session Tab to Group | - | Добавить сеанс на активной вкладке Claude в [группу сеансов](#organize-sessions-into-groups), которую вы выберете или создадите. Требует Claude Code v2.1.257 или позже |421| Add Session Tab to Group | - | Добавить сеанс на активной вкладке Claude в [группу сеансов](#organize-sessions-into-groups), которую вы выберете или создадите. Требует Claude Code v2.1.257 или позже |

457| `useTerminal` | `false` | Запустить Claude в режиме терминала вместо графической панели |500| `useTerminal` | `false` | Запустить Claude в режиме терминала вместо графической панели |

458| `initialPermissionMode` | - | Управляет запросами одобрения для новых бесед: `default`, `plan`, `acceptEdits` или `bypassPermissions`. `manual` является псевдонимом для `default` и выбирает режим, обозначенный как **Manual** в индикаторе режима. Если оставить его неустановленным, расширение выбирает начальный режим разрешений, как описано в [Switch permission modes](/docs/ru/permission-modes#switch-permission-modes). |501| `initialPermissionMode` | - | Управляет запросами одобрения для новых бесед: `default`, `plan`, `acceptEdits` или `bypassPermissions`. `manual` является псевдонимом для `default` и выбирает режим, обозначенный как **Manual** в индикаторе режима. Если оставить его неустановленным, расширение выбирает начальный режим разрешений, как описано в [Switch permission modes](/docs/ru/permission-modes#switch-permission-modes). |

459| `preferredLocation` | `panel` | Где открывается Claude: `sidebar` (справа) или `panel` (новая вкладка) |502| `preferredLocation` | `panel` | Где открывается Claude: `sidebar` (справа) или `panel` (новая вкладка) |

503| `lockEditorGroups` | `true` | [Заблокировать группы редактора, которые Claude запускает для своих вкладок](#choose-where-claude-lives), чтобы файлы, которые вы открываете, когда вкладка Claude сфокусирована, переходили в другую группу. Когда отключено, расширение никогда не блокирует группу редактора. Требуется Claude Code v2.1.274 или позже |

460| `autosave` | `true` | Автоматически сохранять файлы перед тем, как Claude их читает или записывает |504| `autosave` | `true` | Автоматически сохранять файлы перед тем, как Claude их читает или записывает |

461| `attachOpenFile` | `true` | Добавить файл, открытый в редакторе, к вашим сообщениям и показать его в поле подсказки. Когда отключено, добавляется только выбранный текст. Требуется Claude Code v2.1.271 или позже |505| `attachOpenFile` | `true` | Добавить файл, открытый в редакторе, к вашим сообщениям и показать его в поле подсказки. Когда отключено, добавляется только выбранный текст. Требуется Claude Code v2.1.271 или позже |

462| `useCtrlEnterToSend` | `false` | Использовать Ctrl/Cmd+Enter вместо Enter для отправки подсказок |506| `useCtrlEnterToSend` | `false` | Использовать Ctrl/Cmd+Enter вместо Enter для отправки подсказок |

507| `scrollToBottomOnSend` | `true` | Прокручивать беседу в конец при отправке сообщения. Когда отключено, беседа остаётся там, где вы её оставили. Требуется Claude Code v2.1.275 или позже |

463| `enableNewConversationShortcut` | `false` | Включить Cmd/Ctrl+N для начала новой беседы |508| `enableNewConversationShortcut` | `false` | Включить Cmd/Ctrl+N для начала новой беседы |

464| `enableReopenClosedSessionShortcut` | `true` | Использовать Cmd/Ctrl+Shift+T для повторного открытия самой недавно закрытой вкладки сеанса Claude. Когда последняя закрытая вкладка не была сеансом Claude, сочетание клавиш запускает обычную команду VS Code для повторного открытия закрытого редактора. |509| `enableReopenClosedSessionShortcut` | `true` | Использовать Cmd/Ctrl+Shift+T для повторного открытия самой недавно закрытой вкладки сеанса Claude. Когда последняя закрытая вкладка не была сеансом Claude, сочетание клавиш запускает обычную команду VS Code для повторного открытия закрытого редактора. |

465| `archiveInactiveSessions` | `14` | [Архивировать сеанс автоматически](#resume-past-conversations) после этого количества дней без активности: `1`, `2`, `7` или `14`. Установите `0` для отключения. Требуется Claude Code v2.1.265 или позже |510| `archiveInactiveSessions` | `14` | [Архивировать сеанс автоматически](#resume-past-conversations) после этого количества дней без активности: `1`, `2`, `7` или `14`. Установите `0` для отключения. Требуется Claude Code v2.1.265 или позже |

511| `continueAfterReload` | `true` | После перезагрузки окна Claude [продолжает шаг, который был прерван](#choose-where-claude-lives) в восстановленном сеансе. Требуется Claude Code v2.1.274 или позже |

466| `hideOnboarding` | `false` | Скрыть контрольный список адаптации (значок академической шапки) |512| `hideOnboarding` | `false` | Скрыть контрольный список адаптации (значок академической шапки) |

467| `focusView` | `false` | Скрыть вызовы инструментов, результаты инструментов и мышление за расширяемыми строками, оставляя ваши подсказки и ответы Claude. Последний список дел Claude остаётся видимым; это требует Claude Code v2.1.225 или позже. Вы также можете переключить Focus view из меню команд. Требуется Claude Code v2.1.221 или позже |513| `focusView` | `false` | Скрыть вызовы инструментов, результаты инструментов и мышление за расширяемыми строками, оставляя ваши подсказки и ответы Claude. Последний список дел Claude остаётся видимым; это требует Claude Code v2.1.225 или позже. Вы также можете переключить Focus view из меню команд. Требуется Claude Code v2.1.221 или позже |

468| `respectGitIgnore` | `true` | Исключить шаблоны .gitignore из поиска файлов |514| `respectGitIgnore` | `true` | Исключить шаблоны .gitignore из поиска файлов и из [контекста выбора](#reference-files-and-folders) |

469| `usePythonEnvironment` | `true` | Активировать окружение Python рабочей области при запуске Claude. Требуется расширение Python. |515| `usePythonEnvironment` | `true` | Активировать окружение Python рабочей области при запуске Claude. Требуется расширение Python. |

470| `environmentVariables` | `[]` | Установить переменные окружения для процесса Claude. Используйте параметры Claude Code вместо этого для общей конфигурации. |516| `environmentVariables` | `[]` | Установить переменные окружения для процесса Claude. Используйте параметры Claude Code вместо этого для общей конфигурации. |

471| `disableLoginPrompt` | `false` | Пропустить запросы аутентификации (для настроек сторонних поставщиков) |517| `disableLoginPrompt` | `false` | Пропустить запросы аутентификации (для настроек сторонних поставщиков) |

487* **Изменения статуса**: расширение объявляет, когда Claude начинает работать, когда Claude готов к вашему вводу и когда Claude Code начинает сжимать разговор.533* **Изменения статуса**: расширение объявляет, когда Claude начинает работать, когда Claude готов к вашему вводу и когда Claude Code начинает сжимать разговор.

488* **Ошибки и подсказки модели**: расширение объявляет об ошибках в разговоре и объявляет, когда появляется [диалоговое окно согласия на использование кредитов](/docs/ru/model-config#fable-and-usage-credits) или [диалоговое окно помеченного запроса](/docs/ru/model-config#ask-before-switching).534* **Ошибки и подсказки модели**: расширение объявляет об ошибках в разговоре и объявляет, когда появляется [диалоговое окно согласия на использование кредитов](/docs/ru/model-config#fable-and-usage-credits) или [диалоговое окно помеченного запроса](/docs/ru/model-config#ask-before-switching).

489 535 

490Каждый ход в стенограмме начинается с визуально скрытого заголовка, помеченного подсказкой, которая начала ход, поэтому вы можете переходить между ходами с помощью навигации по заголовкам вашей программы чтения с экрана. Вы также можете переместить фокус на саму стенограмму с помощью `Tab`, так как расширение предоставляет ее как помеченный регион, и читать ее в своем собственном темпе. Пока Claude работает, ваша программа чтения с экрана читает текстовую метку вместо анимации спиннера прогресса.536Пока Claude работает, ваша программа чтения с экрана читает текстовую метку вместо анимации спиннера прогресса.

491 537 

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

493 539 

540<h3 id="use-the-chat-panel-from-the-keyboard">

541 Использование панели чата с клавиатуры

542</h3>

543 

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

545 

546В пределах хода ваша программа чтения с экрана объявляет, чье сообщение вы читаете, когда вы перемещаетесь по нему:

547 

548* **Ваши сообщения**: "Вы"

549* **Сообщения Claude**: "Claude"

550* **Шаги инструмента**: "Claude" плюс имя инструмента, например "Claude, Bash"

551* **Блоки размышления**: "Claude, thinking"

552 

553Поскольку расширение предоставляет стенограмму как помеченный регион, вы также можете переместить фокус на саму стенограмму с помощью `Tab` и читать ее в своем собственном темпе. Чтобы вместо этого переместить фокус на последнее сообщение или ожидающий запрос разрешения, запустите **Claude Code: Focus last message** из [Command Palette](#vs-code-commands-and-shortcuts).

554 

555Когда опция в диалоговом окне разрешения сохраняет правило разрешения или доступ к каталогу, ее метка заканчивается названием места сохранения одобрения, например "все проекты" или "этот сеанс". Когда опция сфокусирована, нажмите клавишу `Left` или `Right` для изменения назначения, и расширение объявляет каждое назначение по мере того, как вы на него переходите. Вы также можете щелкнуть на назначение в метке. Клавиши со стрелками требуют Claude Code версии 2.1.268 или более поздней.

556 

494<h2 id="vs-code-extension-vs-claude-code-cli">557<h2 id="vs-code-extension-vs-claude-code-cli">

495 Расширение VS Code и Claude Code CLI558 Расширение VS Code и Claude Code CLI

496</h2>559</h2>

502| Команды и skills | [Все](/docs/ru/commands) | Подмножество (введите `/` для просмотра доступных) |565| Команды и skills | [Все](/docs/ru/commands) | Подмножество (введите `/` для просмотра доступных) |

503| Конфигурация MCP server | Да | Да ([добавление и управление серверами](#connect-to-external-tools-with-mcp) с помощью `/mcp` на панели чата) |566| Конфигурация MCP server | Да | Да ([добавление и управление серверами](#connect-to-external-tools-with-mcp) с помощью `/mcp` на панели чата) |

504| Checkpoints | Да | Да |567| Checkpoints | Да | Да |

505| Сочетание клавиш `!` bash | Да | Нет |568| Сочетание клавиш `!` Bash | Да | Нет |

506| Автодополнение Tab | Да | Нет |569| Автодополнение Tab | Да | Нет |

507 570 

508<h3 id="rewind-with-checkpoints">571<h3 id="rewind-with-checkpoints">

543 Мониторинг фоновых процессов606 Мониторинг фоновых процессов

544</h3>607</h3>

545 608 

546Видимость фоновых задач в расширении ограничена по сравнению с CLI. Для лучшей видимости попросите Claude вывести команду, чтобы вы могли запустить её во встроенном терминале VS Code.609Введите `/tasks` в поле подсказки, чтобы открыть [карту агента](#use-the-prompt-box), которая отображает фоновые задачи сеанса, такие как сервер разработки, который Claude оставил запущенным в качестве фоновой команды shell. Нажмите на задачу, чтобы открыть её карточку и остановить её там. Требуется Claude Code v2.1.277 или более поздняя версия.

547 610 

548<h3 id="connect-to-external-tools-with-mcp">611<h3 id="connect-to-external-tools-with-mcp">

549 Подключение к внешним инструментам с помощью MCP612 Подключение к внешним инструментам с помощью MCP

610 </Step>673 </Step>

611</Steps>674</Steps>

612 675 

613На сторонних поставщиках расширение не предлагает функции, требующие учетной записи claude.ai, такие как отслеживание использования, [голосовой ввод](/docs/ru/voice-dictation) и вкладка Web для [облачных сеансов](#resume-cloud-sessions-from-claude-ai). Вход в claude.ai, оставшийся с более ранней версии `/login`, остается неиспользованным: расширение не отправляет его ни с одним запросом.676На сторонних поставщиках расширение не предлагает функции, требующие учетной записи claude.ai, такие как отслеживание использования, [голосовой ввод](/docs/ru/voice-dictation) и вкладка Web для [облачных сеансов](#resume-cloud-sessions-from-claude-ai). Для информации о том, что показывает диалог Account & usage при этих входах, см. [Проверка учетной записи и использования](#check-account-and-usage).

677 

678Вход в claude.ai, оставшийся с более ранней версии `/login`, остается неиспользованным: расширение не отправляет его ни с одним запросом.

614 679 

615<h2 id="security-and-privacy">680<h2 id="security-and-privacy">

616 Безопасность и конфиденциальность681 Безопасность и конфиденциальность

worktrees.md +10 −5

Details

59 Очистка worktrees59 Очистка worktrees

60</h2>60</h2>

61 61 

62Когда вы выходите из интерактивного сеанса worktree, Claude проверяет worktree на наличие работы, которая будет удалена при удалении: изменённые или неотслеживаемые файлы и новые коммиты.62Когда вы выходите из интерактивного сеанса worktree, Claude проверяет worktree на наличие работы, которая будет удалена при удалении: изменённые или неотслеживаемые файлы, незафиксированная работа внутри проверенных подмодулей и новые коммиты.

63 63 

64* **Worktree чист**: для безымянного сеанса Claude автоматически удаляет worktree и его ветку. [Именованный](/docs/ru/sessions#name-your-sessions) сеанс сначала предлагает вам, чтобы вы могли сохранить worktree на потом64* **Worktree чист**: для безымянного сеанса Claude автоматически удаляет worktree и его ветку. [Именованный](/docs/ru/sessions#name-your-sessions) сеанс сначала предлагает вам, чтобы вы могли сохранить worktree на потом

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

66* **Состояние worktree не может быть проверено**: когда Claude Code не может подсчитать изменения worktree или не может проверить проверки его подмодулей, он предлагает вам вместо автоматического удаления worktree. Подсказка указывает, что он не смог проверить

66 67 

67Неинтерактивные запуски с `-p` не имеют подсказки выхода, поэтому Claude не очищает их worktrees, и Claude Code оставляет блокировку, которую он взял на каждый при создании, на месте до тех пор, пока более поздний сеанс [очистка устаревших блокировок](#clean-up-subagent-and-background-session-worktrees) не освободит её. Чтобы удалить один, запустите `git worktree remove`; если git отказывает, потому что worktree заблокирован, сначала запустите `git worktree unlock` на нём.68Неинтерактивные запуски с `-p` не имеют подсказки выхода, поэтому Claude не очищает их worktrees, и Claude Code оставляет блокировку, которую он взял на каждый при создании, на месте до тех пор, пока более поздний сеанс [очистка устаревших блокировок](#clean-up-subagent-and-background-session-worktrees) не освободит её. Чтобы удалить один, запустите `git worktree remove`; если git отказывает, потому что worktree заблокирован, сначала запустите `git worktree unlock` на нём.

68 69 

101* **Правки файлов**: Claude Code блокирует `Edit`, `Write` или `NotebookEdit`, который нацелен на путь в основной копии.102* **Правки файлов**: Claude Code блокирует `Edit`, `Write` или `NotebookEdit`, который нацелен на путь в основной копии.

102* **Рабочий каталог команды**: Claude Code блокирует команду Bash, PowerShell или Monitor, чей рабочий каталог разрешается в основную копию, или чей рабочий каталог он не может проверить, остаётся вне неё.103* **Рабочий каталог команды**: Claude Code блокирует команду Bash, PowerShell или Monitor, чей рабочий каталог разрешается в основную копию, или чей рабочий каталог он не может проверить, остаётся вне неё.

103* **Перенаправления git**: Claude Code блокирует команду Bash или Monitor, которая перенаправляет git в основную копию. Перенаправление может поступать через `git -C`, `--git-dir`, переменную `GIT_DIR` или `GIT_WORK_TREE` или `cd` в основную копию перед запуском git.104* **Перенаправления git**: Claude Code блокирует команду Bash или Monitor, которая перенаправляет git в основную копию. Перенаправление может поступать через `git -C`, `--git-dir`, переменную `GIT_DIR` или `GIT_WORK_TREE` или `cd` в основную копию перед запуском git.

104* **Форма команды**: Claude Code блокирует команду Bash или Monitor, когда он не может проверить из текста команды, что любой git, который запускает команда, остаётся внутри worktree, например когда имя команды вычисляется во время выполнения или синтаксис не может быть проанализирован. Claude Code сообщает Claude, как переписать отказанную команду, например разделив её на простые отдельные команды. Вы не можете отключить эту проверку.105* **Форма команды**: Claude Code блокирует команду Bash или Monitor, когда он не может проверить из текста команды, что любой git, который запускает команда, остаётся внутри worktree. Это происходит, например, когда имя команды вычисляется во время выполнения, когда синтаксис не может быть проанализирован, или когда расширение, такое как `${!name}` или `${ command; }`, может запустить команду, которую текст не указывает явно. Claude Code сообщает Claude, как переписать отказанную команду, например разделив её на простые отдельные команды. Вы не можете отключить эту проверку.

105 106 

106Проверки применяются к репозиторию, из которого вы запустили Claude Code. Они также охватывают основную копию, на которую ссылается связанный worktree. Для команд PowerShell Claude Code применяет только проверку рабочего каталога.107Проверки применяются к репозиторию, из которого вы запустили Claude Code. Они также охватывают основную копию, на которую ссылается связанный worktree. Для команд PowerShell Claude Code применяет только проверку рабочего каталога.

107 108 

108Claude видит каждый отказ как ошибку инструмента, которая называет worktree и говорит, как продолжить.109Claude видит каждый отказ как ошибку инструмента, которая называет worktree и говорит, как продолжить. Для отказанной команды см. [что означает сообщение об отказе и как его очистить](/docs/ru/errors#command-blocked-by-the-worktree-isolation-checks).

109 110 

110<h2 id="isolate-subagents-with-worktrees">111<h2 id="isolate-subagents-with-worktrees">

111 Изолируйте subagents с помощью worktrees112 Изолируйте subagents с помощью worktrees

139Когда вы [отправляете в фон](/docs/ru/agent-view#send-the-session-to-the-background) сеанс `--worktree`, его worktree становится worktree фонового сеанса, который очистка может удалить. Очистка оставляет worktree на месте в этих случаях:140Когда вы [отправляете в фон](/docs/ru/agent-view#send-the-session-to-the-background) сеанс `--worktree`, его worktree становится worktree фонового сеанса, который очистка может удалить. Очистка оставляет worktree на месте в этих случаях:

140 141 

141* Worktree по-прежнему содержит работу: изменённые или неотслеживаемые файлы или неотправленные коммиты.142* Worktree по-прежнему содержит работу: изменённые или неотслеживаемые файлы или неотправленные коммиты.

143* Проверенный submodule в worktree содержит изменённые или неотслеживаемые файлы, или Claude Code не может проверить submodules worktree. Эта проверка требует Claude Code v2.1.274 или более позднюю версию.

142* Один из [четырёх случаев, которые также блокируют создание worktree](#git-lfs-content-is-missing-from-a-worktree-claude-code-created) применяется: Claude Code не может определить, какие драйверы фильтров определяет конфигурация репозитория, или находит там параметр, который не может отключить.144* Один из [четырёх случаев, которые также блокируют создание worktree](#git-lfs-content-is-missing-from-a-worktree-claude-code-created) применяется: Claude Code не может определить, какие драйверы фильтров определяет конфигурация репозитория, или находит там параметр, который не может отключить.

143* Worktree принадлежит сеансу `--worktree`, который вы не отправили в фон, независимо от его возраста.145* Worktree принадлежит сеансу `--worktree`, который вы не отправили в фон, независимо от его возраста.

144* Вы создали worktree самостоятельно с `git worktree add`, даже если вы затем запустили сеанс `--worktree <name>` в нём и отправили этот сеанс в фон.146* Вы создали worktree самостоятельно с `git worktree add`, даже если вы затем запустили сеанс `--worktree <name>` в нём и отправили этот сеанс в фон.

251 Что worktrees делят с основной копией253 Что worktrees делят с основной копией

252</h2>254</h2>

253 255 

254Worktree получает собственные файлы и ветку, но делит каталог `.git` репозитория, плагины области проекта и сохранённые одобрения разрешений с основной копией:256Worktree получает собственные файлы и ветку, но делит следующее с основной копией:

255 257 

256* **Каталог `.git` репозитория**: команды git в worktree записывают в общий каталог `.git` основного репозитория, и [sandboxing](/docs/ru/sandboxing#filesystem-isolation) позволяет эти записи, поэтому команды, такие как `git commit`, работают из worktree с включённой песочницей.258* **Каталог `.git` репозитория**: команды git в worktree записывают в общий каталог `.git` основного репозитория, и [sandboxing](/docs/ru/sandboxing#filesystem-isolation) позволяет эти записи, поэтому команды, такие как `git commit`, работают из worktree с включённой песочницей.

257* **Плагины**: плагины, установленные в [области проекта](/docs/ru/plugins-reference#plugin-installation-scopes) из основной копии, также загружаются в worktrees того же репозитория, поэтому вам не нужно переустанавливать их для каждого worktree. Требуется Claude Code версии 2.1.200 или позже.259* **Плагины**: плагины, установленные в [области проекта](/docs/ru/plugins-reference#plugin-installation-scopes) из основной копии, также загружаются в worktrees того же репозитория, поэтому вам не нужно переустанавливать их для каждого worktree. Требуется Claude Code версии 2.1.200 или позже.

258* **Одобрения разрешений**: выбор "Да, и больше не спрашивать" для команды Bash в сеансе worktree сохраняет правило в `.claude/settings.local.json` основной копии, поэтому оно применяется в основной копии и в каждом другом worktree репозитория, и оно выживает удаление worktree. На Windows и в других случаях, когда Claude Code [не использует корень репозитория](/docs/ru/settings#where-claude-code-looks-for-each-file), правило остаётся с этим worktree. До версии 2.1.211 одобрение, предоставленное в worktree, было сохранено внутри этого worktree, не применялось в другом месте и было потеряно при удалении worktree. См. [где сохраняются одобрения](/docs/ru/permissions#permission-system).260* **Одобрения разрешений**: выбор "Да, и больше не спрашивать" для команды Bash в сеансе worktree сохраняет правило в `.claude/settings.local.json` основной копии, поэтому оно применяется в основной копии и в каждом другом worktree репозитория, и оно выживает удаление worktree. На Windows и в других случаях, когда Claude Code [не использует корень репозитория](/docs/ru/settings#where-claude-code-looks-for-each-file), правило остаётся с этим worktree. До версии 2.1.211 одобрение, предоставленное в worktree, было сохранено внутри этого worktree, не применялось в другом месте и было потеряно при удалении worktree. См. [где сохраняются одобрения](/docs/ru/permissions#permission-system).

261* **Неотслеживаемые skills, agents и commands**: когда копия worktree не имеет каталога `.claude/skills` в своём корне, например потому что ваш `.claude/skills` находится в gitignore, Claude Code загружает [project skills](/docs/ru/skills#where-skills-live) основной копии в сеансе worktree. В worktree с собственным каталогом `.claude/skills` загружается только эта копия.

259 262 

260Все три применяются независимо от того, создаёте ли вы worktree с `--worktree`, с `git worktree add` или через [десктопное приложение](/docs/ru/desktop#work-in-parallel-with-sessions).263 То же самое применяется к `.claude/agents` и `.claude/commands`. Для skills это требует Claude Code версии 2.1.277 или позже.

264 

265Все это применяется независимо от того, создаёте ли вы worktree с `--worktree`, с `git worktree add` или через [десктопное приложение](/docs/ru/desktop#work-in-parallel-with-sessions).

261 266 

262<h2 id="manage-worktrees-manually">267<h2 id="manage-worktrees-manually">

263 Управляйте worktrees вручную268 Управляйте worktrees вручную