129 Claude Code читает `managed-mcp.json`, развернутый по его [системному пути](https://code.claude.com/docs/ru/managed-mcp.md#exclusive-control-with-managed-mcp-json), отдельно от уровня управляемых параметров, поэтому файл все еще применяется, когда действуют параметры, управляемые сервером.129 Claude Code читает `managed-mcp.json`, развернутый по его [системному пути](https://code.claude.com/docs/ru/managed-mcp.md#exclusive-control-with-managed-mcp-json), отдельно от уровня управляемых параметров, поэтому файл все еще применяется, когда действуют параметры, управляемые сервером.
130* Параметры, ограниченные источниками политики на уровне ОС, такие как `policyHelper` и `wslInheritsWindowsSettings`, не учитываются. Разверните их через MDM или системный файл `managed-settings.json` вместо этого. `policyHelper`, развернутый таким образом, работает только тогда, когда его источник является выбранным в [приоритете в пределах управляемого уровня](https://code.claude.com/docs/ru/managed-settings.md#precedence-within-the-managed-tier).130* Параметры, ограниченные источниками политики на уровне ОС, такие как `policyHelper` и `wslInheritsWindowsSettings`, не учитываются. Разверните их через MDM или системный файл `managed-settings.json` вместо этого. `policyHelper`, развернутый таким образом, работает только тогда, когда его источник является выбранным в [приоритете в пределах управляемого уровня](https://code.claude.com/docs/ru/managed-settings.md#precedence-within-the-managed-tier).
131 131
132## Доставка параметров132## Доставка настроек
133 133
134### Приоритет параметров134### Приоритет настроек
135 135
136Управляемые сервером настройки и [управляемые на эндпоинте настройки](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms) занимают наивысший уровень в [иерархии настроек](https://code.claude.com/docs/ru/settings.md#settings-precedence) Claude Code. Ключ, который вы задаёте здесь, имеет приоритет над тем же ключом в собственных файлах настроек пользователя или в значении `--settings`, за исключением [исключений из приоритета управляемых настроек](https://code.claude.com/docs/ru/settings.md#exceptions-to-managed-settings-precedence).136Настройки, управляемые сервером, и [настройки, управляемые на уровне конечного устройства](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms), занимают высший уровень в [иерархии настроек](https://code.claude.com/docs/ru/settings.md#settings-precedence) Claude Code. Ключ, который вы задаёте здесь, имеет приоритет над тем же ключом в собственных файлах настроек пользователя или в значении `--settings`, за исключением [исключений из приоритета управляемых настроек](https://code.claude.com/docs/ru/settings.md#exceptions-to-managed-settings-precedence).
137 137
138В пределах управляемого уровня Claude Code по умолчанию использует первый источник, который доставляет хотя бы один ключ политики, сначала проверяя управляемые сервером параметры, а затем управляемые конечной точкой параметры, за исключением [ключей исключений, рассмотренных далее](#per-key-exceptions-across-managed-sources). [Как Claude Code объединяет управляемые источники](https://code.claude.com/docs/ru/managed-settings.md#precedence-within-the-managed-tier) содержит полный рейтинг, исключение для ключей управления и согласие, которое применяется к каждому источнику.138На управляемом уровне Claude Code по умолчанию использует первый источник, который доставляет хотя бы один ключ политики: сначала проверяются настройки, управляемые сервером, а затем настройки, управляемые на уровне конечного устройства, за исключением [ключей-исключений, описанных далее](#per-key-exceptions-across-managed-sources). В разделе [Как Claude Code объединяет управляемые источники](https://code.claude.com/docs/ru/managed-settings.md#precedence-within-the-managed-tier) приведены полный порядок приоритета, особый порядок для управляющих ключей и необязательная настройка, при включении которой Claude Code применяет все источники.
139 139
140Если выбранный источник — это политика MDM или файл управляемых параметров, чей [`policyHelper`](https://code.claude.com/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры, выходные данные помощника заменяют этот источник как единственную управляемую конфигурацию для запуска. Claude Code не обращается к `policyHelper`, настроенному в MDM или файловых параметрах, пока управляемые сервером параметры доставляют ключ политики.140Если выбранный источник — это политика MDM или файл управляемых настроек, чей [`policyHelper`](https://code.claude.com/docs/ru/settings-reference#policyhelper) предоставляет управляемые настройки, вывод этого хелпера заменяет данный источник и становится единственной управляемой конфигурацией для запуска. Claude Code не обращается к `policyHelper`, настроенному в MDM или в настройках на основе файлов, пока настройки, управляемые сервером, доставляют ключ политики.
141 141
142Если более поздняя выборка обнаруживает удаление управляемых сервером параметров, Claude Code сразу же запускает этот помощник вместо следующего запуска. Запись [`policyHelper`](https://code.claude.com/docs/ru/settings-reference#policyhelper) охватывает то, что происходит при сбое этого запуска.142Если при последующем получении выясняется, что настройки, управляемые сервером, удалены, Claude Code запускает этот хелпер сразу, а не при следующем запуске. В записи [`policyHelper`](https://code.claude.com/docs/ru/settings-reference#policyhelper) описано, что происходит, если этот запуск завершается неудачно.
143 143
144Если вы очищаете конфигурацию управляемых сервером параметров в консоли администратора с намерением вернуться к управляемой конечной точкой plist или политике реестра, имейте в виду, что [кэшированные параметры](#fetch-and-caching-behavior) сохраняются на клиентских машинах до следующей успешной выборки, и ключи, которые [применяются только при следующем запуске](#fetch-and-caching-behavior), такие как `model`, остаются в силе до перезагрузки каждого клиента. Запустите `/status`, чтобы увидеть, какой управляемый источник активен.144Если вы очищаете конфигурацию, управляемую сервером, в консоли администратора, чтобы вернуться к политике plist или реестра, управляемой на уровне конечного устройства, учтите, что [кэшированные настройки](#fetch-and-caching-behavior) сохраняются на клиентских машинах до следующего успешного получения, а ключи, которые [применяются только при следующем запуске](#fetch-and-caching-behavior), например `model`, остаются в силе, пока каждый клиент не будет перезапущен. Выполните `/status`, чтобы увидеть, какой управляемый источник активен.
145 145
146### Исключения для отдельных ключей в управляемых источниках146### Исключения для отдельных ключей в управляемых источниках
147 147
148Эти ключи являются исключениями из правила отсутствия объединения:148Эти ключи являются исключениями из правила отсутствия объединения:
149 149
150* **Ключи блокировки между источниками**: небольшой набор ключей, таких как блокировки списка разрешений песочницы, [указанные на странице управляемых параметров](https://code.claude.com/docs/ru/managed-settings.md#precedence-within-the-managed-tier). Claude Code соблюдает их, когда любой управляемый администратором источник их устанавливает; уровень реестра HKCU, доступный для записи пользователем, исключен.150* **Ключи блокировки, действующие во всех источниках**: небольшой набор ключей, например блокировки списка разрешённых для песочницы, [перечисленных на странице управляемых настроек](https://code.claude.com/docs/ru/managed-settings.md#precedence-within-the-managed-tier). Claude Code учитывает их, когда их задаёт любой управляемый источник, контролируемый администратором; уровень реестра HKCU, доступный пользователю для записи, исключён.
151 151
152 Когда [`policyHelper`](https://code.claude.com/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры, его выходные данные — это единственный источник, который эти проверки читают, за исключением [`forceRemoteSettingsRefresh`](https://code.claude.com/docs/ru/settings-reference#forceremotesettingsrefresh), который Claude Code читает из источников администратора непосредственно при запуске.152 Когда [`policyHelper`](https://code.claude.com/docs/ru/settings-reference#policyhelper) предоставляет управляемые настройки, его вывод — единственный источник, который читают эти проверки, за исключением [`forceRemoteSettingsRefresh`](https://code.claude.com/docs/ru/settings-reference#forceremotesettingsrefresh), который Claude Code читает непосредственно из источников администратора при запуске.
153* **Блок `env`**: помимо единицы телеметрии и переменных маршрутизации, связанных с ключом учетных данных, оба рассмотрены ниже, он объединяется по ключам в управляемых администратором источниках. Для каждой переменной окружения источник с наивысшим приоритетом, определяющий ее, побеждает, а источники администратора с более низким приоритетом заполняют переменные, которые источники с более высоким приоритетом оставляют неустановленными. Запись `env`, управляемая конечной точкой, поэтому применяется всякий раз, когда конфигурация управляемых сервером параметров оставляет эту переменную неустановленной, или пока кэшированное значение сервера для нее [удерживается в ожидании подтверждения сервером](#fetch-and-caching-behavior). Требуется Claude Code v2.1.223 или более поздняя версия. До v2.1.223 Claude Code применяет только весь блок `env` выбранного источника.153* **Блок `env`**: за исключением единого блока телеметрии и переменных маршрутизации, связанных с ключом учётных данных (оба описаны ниже), он объединяется по ключам между источниками, контролируемыми администратором. Для каждой переменной окружения побеждает источник с наивысшим приоритетом, который её определяет, а источники администратора с более низким приоритетом заполняют переменные, которые источники с более высоким приоритетом оставляют незаданными. Поэтому запись `env`, управляемая на уровне конечного устройства, применяется всякий раз, когда конфигурация, управляемая сервером, оставляет эту переменную незаданной, или пока кэшированное серверное значение для неё [удерживается в ожидании подтверждения сервером](#fetch-and-caching-behavior). Требуется Claude Code v2.1.223 или более поздней версии. До v2.1.223 Claude Code применяет только весь блок `env` выбранного источника.
154 * **Единица телеметрии**: ключи экспортера `OTEL_EXPORTER_OTLP_*`, переключатели захвата содержимого `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` и бета-переменные трассировки `ENABLE_BETA_TRACING_DETAILED` и `BETA_TRACING_ENDPOINT` следуют источнику с наивысшим приоритетом, который устанавливает любой из них как единицу. Источник, который доставляет ключ учетных данных `otelHeadersHelper`, также претендует на единицу, но размещает эти переменные только когда он является выбранным источником: источник, который не выбран, но доставляет ключ, не вносит ни один из них и все еще блокирует более низкие источники от их заполнения. В любом случае конечная точка экспортера из одного источника никогда не может быть связана с учетными данными из другого.154 * **Единый блок телеметрии**: ключи экспортера `OTEL_EXPORTER_OTLP_*`, переключатели захвата содержимого `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER` и переменные бета-трассировки `ENABLE_BETA_TRACING_DETAILED` и `BETA_TRACING_ENDPOINT` берутся как единое целое из источника с наивысшим приоритетом, задающего любую из них. Источник, доставляющий ключ учётных данных `otelHeadersHelper`, тоже претендует на этот блок, но устанавливает эти переменные только тогда, когда он является выбранным источником: источник, который не выбран, но доставляет этот ключ, не предоставляет ни одной из них и всё равно не позволяет источникам с более низким приоритетом их заполнить. В любом случае эндпоинт экспортера из одного источника никогда не может сочетаться с учётными данными из другого.
155 * **Маршрутизация с привязкой к учетным данным**: источник, который связывает переменные маршрутизации с ключом учетных данных, доступным только для выбранного источника, такой как `apiKeyHelper` или `otelHeadersHelper`, вносит эти переменные маршрутизации только когда он выигрывает слот.155 * **Маршрутизация, связанная с учётными данными**: источник, который сочетает переменные маршрутизации с ключом учётных данных, действующим только для выбранного источника, например `apiKeyHelper` или `otelHeadersHelper`, предоставляет эти переменные маршрутизации, только если он занимает эту позицию.
156* **`allowedProviders`**: список, установленный на машине, и список, управляемый сервером, объединяются как [указано в примечании Scope этой записи](https://code.claude.com/docs/ru/settings-reference.md#allowedproviders). Требуется Claude Code v2.1.285 или более поздняя версия156* **`allowedProviders`**: список, заданный на машине, и список, управляемый сервером, объединяются так, как указано в [примечании об области действия в его записи](https://code.claude.com/docs/ru/settings-reference.md#allowedproviders). Требуется Claude Code v2.1.285 или более поздней версии
157* **Ключи собственного входа**: [`forceLoginOrgUUID`](https://code.claude.com/docs/ru/settings-reference#forceloginorguuid) и значения `"claudeai"` и `"console"` для [`forceLoginMethod`](https://code.claude.com/docs/ru/settings-reference#forceloginmethod). Если вы также развёртываете политику MDM или файл управляемых настроек, задавайте их и там, и в управляемых сервером настройках на claude.ai, пока на всех клиентах не будет v2.1.299 или новее. О том, где задавать эти ключи после этого и значение какого источника применяется, см. в разделе [Какой управляемый источник предоставляет ключи входа](https://code.claude.com/docs/ru/managed-settings.md#which-managed-source-supplies-login-keys).157* **Ключи входа в собственные сервисы Anthropic**: [`forceLoginOrgUUID`](https://code.claude.com/docs/ru/settings-reference#forceloginorguuid) и значения `"claudeai"` и `"console"` ключа [`forceLoginMethod`](https://code.claude.com/docs/ru/settings-reference#forceloginmethod). Если вы также развёртываете политику MDM или файл управляемых настроек, задайте их и там, и в настройках, управляемых сервером, на claude.ai, пока все клиенты не будут работать на v2.1.299 или более поздней версии. О том, где задавать эти ключи после этого и значение из какого источника применяется, см. [Какой управляемый источник предоставляет ключи входа](https://code.claude.com/docs/ru/managed-settings.md#which-managed-source-supplies-login-keys).
158* **Ключи входа в шлюз**: Claude Code никогда не читает [`forceLoginGatewayUrl`](https://code.claude.com/docs/ru/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/ru/settings-reference#gatewayinternalnetworks) или значение `"gateway"` [`forceLoginMethod`](https://code.claude.com/docs/ru/settings-reference#forceloginmethod) из управляемых сервером параметров, поэтому значение там ни не применяется, ни не скрывает значение, установленное в политике MDM или файле управляемых параметров. Запись [`managedSourcesBehavior`](https://code.claude.com/docs/ru/settings-reference#managedsourcesbehavior) указывает, какой источник администратора на машине их предоставляет.158* **Ключи входа через шлюз**: Claude Code никогда не читает [`forceLoginGatewayUrl`](https://code.claude.com/docs/ru/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](https://code.claude.com/docs/ru/settings-reference#gatewayinternalnetworks) или значение `"gateway"` ключа [`forceLoginMethod`](https://code.claude.com/docs/ru/settings-reference#forceloginmethod) из настроек, управляемых сервером, поэтому значение там не применяется и не скрывает значение, заданное в политике MDM или файле управляемых настроек. В [записи `managedSourcesBehavior`](https://code.claude.com/docs/ru/settings-reference#managedsourcesbehavior) указано, какой источник администратора на машине их предоставляет.
159 159
160#### Когда `apiKeyHelper` машины не действует160#### Когда `apiKeyHelper` машины не действует
161 161
162Когда ваши управляемые сервером настройки являются выбранным источником, `apiKeyHelper` в файле управляемых настроек или политике MDM машины не действует. В этом случае Claude Code [отклоняет промпты](https://code.claude.com/docs/ru/errors.md#claude-code-didnt-send-your-claude-ai-login) в сессии, которая использовала бы сохранённый вход claude.ai, если выполняются оба условия:162Когда выбранным источником являются ваши настройки, управляемые сервером, `apiKeyHelper` в файле управляемых настроек или политике MDM машины не действует. В этом случае Claude Code [отклоняет промпты](https://code.claude.com/docs/ru/errors.md#claude-code-didnt-send-your-claude-ai-login) в сессии, которая использовала бы сохранённый вход claude.ai, при выполнении обоих условий:
163 163
164* Файл или политика включает облачного провайдера, либо любой источник задаёт адрес API, отличный от адреса Anthropic164* Файл или политика включает облачного провайдера, или какой-либо источник задаёт адрес API, отличный от адреса Anthropic
165* Управляемые сервером настройки не задают помощника и не указывают адрес API Anthropic165* Настройки, управляемые сервером, не задают хелпер и не указывают адрес API Anthropic
166 166
167Чтобы снять отказ, сохраните действие помощника и его адреса API, укажите адрес API Anthropic в управляемых сервером настройках или удалите помощника из политики машины. Для отказа требуется Claude Code v2.1.314 или новее.167Чтобы снять отказ, сохраните действие хелпера и его адреса API, укажите адрес API Anthropic в настройках, управляемых сервером, или удалите хелпер из политики машины. Отказ требует Claude Code v2.1.314 или более поздней версии.
168 168
169### Поведение выборки и кэширования169### Получение и кэширование
170 170
171Claude Code выполняет выборку параметров с серверов Anthropic при запуске и опрашивает обновления каждый час во время активных сеансов.171Claude Code получает настройки с серверов Anthropic при запуске и ежечасно проверяет наличие обновлений во время активных сессий.
172 172
173Клиент, вошедший через [шлюз приложений Claude](#platform-availability), выполняет выборку параметров из шлюза и ждет завершения этой выборки перед началом сеанса, поэтому выборка в списках ниже к нему не применяется. [Принудительный отказ при запуске](#enforce-fail-closed-startup) охватывает то, что происходит при сбое этой выборки.173Клиент, вошедший через [шлюз приложений Claude](#platform-availability), получает настройки от шлюза и дожидается этого получения до начала сессии, поэтому описанное в списках ниже получение к нему не относится. Что происходит при сбое этого получения, описано в разделе [Принудительный запуск с отказом при сбое](#enforce-fail-closed-startup).
174 174
175**Первый запуск без кэшированных параметров:**175> [!NOTE]
176>
177> При входе в claude.ai с тарифом Team или Enterprise, сохранённом на машине, Anthropic может требовать настройки вашей организации до начала сессии. В этом случае, независимо от того, что сказано в списках ниже, разработчик [не может начать сессию](https://code.claude.com/docs/ru/errors.md#couldnt-load-your-organizations-settings), например в таких случаях:
178>
179> * Срок действия его входа истёк — до тех пор, пока он не выполнит `claude auth login`
180> * У Claude Code нет ни настроек, ни недавней кэшированной копии. Проверьте, может ли машина подключиться к `api.anthropic.com`
181>
182> Сообщение при запуске с `before a session can start` или `Your Claude session has expired` означает, что это требование действует.
183
184**Первый запуск без кэшированных настроек:**
176 185
177* Когда разработчик входит при запуске, например при первом запуске или после `/logout`, Claude Code ждет до пяти секунд выборки перед открытием сеанса. Когда политика поступает вовремя, Claude Code применяет ее с первого экрана и показывает ваши [`companyAnnouncements`](https://code.claude.com/docs/ru/settings-reference#companyannouncements) на нем. Когда полезная нагрузка требует [одобрения безопасности](#security-approval-dialogs), Claude Code завершает ожидание и применяет полезную нагрузку после одобрения разработчиком186* Когда разработчик входит при запуске, например при первом запуске или после `/logout`, Claude Code ждёт получения до пяти секунд, прежде чем открыть сессию. Если политика приходит вовремя, Claude Code применяет её с первого экрана и показывает на нём ваши [`companyAnnouncements`](https://code.claude.com/docs/ru/settings-reference#companyannouncements). Если данные требуют [подтверждения безопасности](#security-approval-dialogs), Claude Code прекращает ожидание и применяет данные после подтверждения разработчиком
178* При любом другом запуске и когда истекает пятисекундное ожидание, Claude Code открывает сеанс, пока выборка продолжается, поэтому краткое окно проходит перед загрузкой параметров и вступлением в силу ограничений187* При любом другом запуске, а также когда пятисекундное ожидание истекает, Claude Code открывает сессию, пока получение продолжается, поэтому проходит короткий промежуток времени, прежде чем настройки загрузятся и ограничения вступят в силу
179* Если выборка не удается, Claude Code продолжает работу без управляемых сервером параметров и предупреждает в интерактивных сеансах, что удаленная политика не применяется; управляемые конечной точкой параметры все еще применяются. Если управляемый источник устанавливает [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup), Claude Code вместо этого выходит188* Если получение завершается неудачно, Claude Code продолжает работу без настроек, управляемых сервером, и в интерактивных сессиях, а также на [вкладке Code в Claude Desktop](https://code.claude.com/docs/ru/desktop.md) предупреждает, что удалённая политика не применяется; настройки, управляемые на уровне конечного устройства, по-прежнему применяются. Если управляемый источник задаёт [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup), Claude Code вместо этого завершает работу
180 189
181**Последующие запуски с кэшированными параметрами:**190**Последующие запуски с кэшированными настройками:**
182 191
183* Кэшированные настройки применяются сразу при запуске, за исключением кэшированных значений `modelPricing` и `managedMcpServers`; переменных окружения, которые Claude Code удерживает до подтверждения полезной нагрузки сервером; удаления, перемещения или отключения [встроенного стража](https://code.claude.com/docs/ru/plugins/mods/admin.md#know-what-happens-by-default) кэшированным списком плагинов; а также, на машине, где управляемый на эндпоинте источник перечисляет или включает собственные плагины, [статуса организации](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods) для плагина, который включает только кэшированный список192* Кэшированные настройки применяются сразу при запуске, за исключением кэшированных значений `modelPricing` и `managedMcpServers`; переменных окружения, которые Claude Code удерживает до подтверждения данных сервером; удаления, перемещения или отключения [встроенного стража](https://code.claude.com/docs/ru/plugins/mods/admin.md#know-what-happens-by-default) кэшированным списком плагинов; а также, на машине, где источник, управляемый на уровне конечного устройства, перечисляет или включает собственные плагины, [статуса организации](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods) для плагина, который включён только кэшированным списком
184* Кэшированный [`modelPricing`](https://code.claude.com/docs/ru/settings-reference#modelpricing) не применяется до тех пор, пока выборка сеанса не подтвердит полезную нагрузку. До этого момента цифры затрат, которые разработчики видят в `/usage` и в строке состояния, находятся по цене списка193* Кэшированный [`modelPricing`](https://code.claude.com/docs/ru/settings-reference#modelpricing) не применяется, пока получение в рамках сессии не подтвердит данные. До этого показатели стоимости, которые разработчики видят в `/usage` и строке состояния, рассчитываются по прейскурантной цене
185* Кэшированный блок [`managedMcpServers`](https://code.claude.com/docs/ru/settings-reference#managedmcpservers) не применяется до тех пор, пока выборка сеанса не подтвердит полезную нагрузку. Claude Code ждет до 30 секунд для этой выборки перед подключением серверов MCP. Если выборка не удается или истекает время ожидания, сеанс начинается без серверов организации, `/status` это указывает, и они подключаются после подтверждения более поздней выборкой. Полное поведение см. в разделе [Когда предоставленные серверы подключаются](https://code.claude.com/docs/ru/managed-mcp.md#when-provided-servers-connect), включая первый запуск. Требуется Claude Code v2.1.259 или более поздняя версия194* Кэшированный блок [`managedMcpServers`](https://code.claude.com/docs/ru/settings-reference#managedmcpservers) не применяется, пока получение в рамках сессии не подтвердит данные. Claude Code ждёт этого получения до 30 секунд, прежде чем подключать MCP-серверы. Если получение завершается неудачно или по таймауту, сессия начинается без серверов организации, `/status` сообщает об этом, а серверы подключаются, как только последующее получение их подтвердит. Полное описание поведения, включая первый запуск, см. в разделе [Когда подключаются предоставленные серверы](https://code.claude.com/docs/ru/managed-mcp.md#when-provided-servers-connect). Требуется Claude Code v2.1.259 или более поздней версии
186* Кэшированное значение [`prependPlugins`](https://code.claude.com/docs/ru/settings-reference#prependplugins), [`appendPlugins`](https://code.claude.com/docs/ru/settings-reference#appendplugins) или [`enabledPlugins`](https://code.claude.com/docs/ru/settings-reference#enabledplugins) не может удалить встроенный страж, изменить его позицию или отключить его, пока выборка сессии не подтвердит полезную нагрузку195* Кэшированное значение [`prependPlugins`](https://code.claude.com/docs/ru/settings-reference#prependplugins), [`appendPlugins`](https://code.claude.com/docs/ru/settings-reference#appendplugins) или [`enabledPlugins`](https://code.claude.com/docs/ru/settings-reference#enabledplugins) не может удалить встроенного стража, изменить его позицию или отключить его, пока получение в рамках сессии не подтвердит данные
187* На машине, где [управляемый на эндпоинте источник](https://code.claude.com/docs/ru/managed-settings.md#choose-a-delivery-mechanism) перечисляет или включает собственные плагины, плагин, который включает только кэшированный список, считается [плагином пользователя](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods), а не вашей организации, пока выборка не подтвердит полезную нагрузку196* На машине, где [источник, управляемый на уровне конечного устройства](https://code.claude.com/docs/ru/managed-settings.md#choose-a-delivery-mechanism), перечисляет или включает собственные плагины, плагин, который включён только кэшированным списком, считается [плагином пользователя](https://code.claude.com/docs/ru/plugins/mods/admin.md#install-your-organizations-mods), а не вашей организации, пока получение не подтвердит данные
188* Claude Code выполняет выборку свежих параметров в фоновом режиме197* Claude Code получает свежие настройки в фоновом режиме
189* Кэшированные параметры сохраняются при сбоях сети. Если выборка при запуске не удается, Claude Code предупреждает в интерактивных сеансах, что кэшированная политика действует198* Кэшированные настройки сохраняются при сбоях сети. Если получение при запуске завершается неудачно, Claude Code предупреждает в интерактивных сессиях и на вкладке Code, что действует кэшированная политика
190* До успешной выборки удерживаемые значения при запуске остаются удерживаемыми199* Пока получение не завершится успешно, значения, удержанные при запуске, остаются удержанными
191 200
192Claude Code удерживает несколько категорий переменных в кэшированном блоке `env`, пока сервер не подтвердит данные для сессии. Это не позволяет кэшированному значению прокси, центра сертификации, эндпоинта или учётных данных перенаправить, перехватить или повторно аутентифицировать получение настроек, которое подтверждает данные. Эта защита применяется только к кэшу настроек, полученных с сервера: [управляемые на эндпоинте настройки](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms), развёрнутые через MDM или `managed-settings.json`, не затрагиваются. Удерживаемые категории включают:201Claude Code удерживает несколько категорий переменных в кэшированном блоке `env`, пока сервер не подтвердит данные для сессии. Это не позволяет кэшированному значению прокси, центра сертификации, эндпоинта или учётных данных перенаправить, перехватить или повторно аутентифицировать получение настроек, которое подтверждает данные. Эта защита применяется только к кэшу настроек, полученных с сервера: [настройки, управляемые на уровне конечного устройства](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms) и развёрнутые через MDM или `managed-settings.json`, не затрагиваются. Удерживаемые категории включают:
193 202
194* Конфигурация прокси и TLS, такая как `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` и переменные сертификата клиента mTLS `CLAUDE_CODE_CLIENT_CERT` и `CLAUDE_CODE_CLIENT_KEY`203* Конфигурацию прокси и TLS, например `HTTPS_PROXY`, `NODE_EXTRA_CA_CERTS` и переменные клиентского сертификата mTLS `CLAUDE_CODE_CLIENT_CERT` и `CLAUDE_CODE_CLIENT_KEY`
195* Маршрутизация API и выбор поставщика, включая `ANTHROPIC_BASE_URL`, переменные выбора поставщика, такие как `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_VERTEX`, и URL-адреса конечных точек поставщика, такие как `ANTHROPIC_BEDROCK_BASE_URL`204* Маршрутизацию API и выбор провайдера, включая `ANTHROPIC_BASE_URL`, переменные выбора провайдера, такие как `CLAUDE_CODE_USE_BEDROCK` и `CLAUDE_CODE_USE_VERTEX`, и URL-адреса эндпоинтов провайдеров, такие как `ANTHROPIC_BEDROCK_BASE_URL`
196* Учетные данные аутентификации, такие как `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` и `CLAUDE_CODE_OAUTH_TOKEN`205* Учётные данные аутентификации, например `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` и `CLAUDE_CODE_OAUTH_TOKEN`
197* Селектор каталога конфигурации `CLAUDE_CONFIG_DIR`206* Селектор каталога конфигурации `CLAUDE_CONFIG_DIR`
198* Селекторы источника учетных данных и каталога конфигурации в 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`207* Селекторы источника учётных данных и каталога конфигурации в 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`
199 208
200Claude Code читает переменные Workload Identity Federation и селекторы `ANTHROPIC_PROFILE` и `ANTHROPIC_CONFIG_DIR` только при запуске, поэтому значение, доставленное сервером для них, не переключает источник учетных данных сеанса даже после успешной выборки. Для доставки этих селекторов на Claude Code v2.1.223 или более поздней версии используйте [управляемые конечной точкой параметры](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms), такие как MDM или `managed-settings.json`. Для `CLAUDE_CONFIG_DIR` и переменных каталога операционной системы само удержание является защитой: кэшированное значение остается вне окружения до подтверждения полезной нагрузки сервером.209Claude Code читает переменные Workload Identity Federation и селекторы `ANTHROPIC_PROFILE` и `ANTHROPIC_CONFIG_DIR` только при запуске, поэтому значение, доставленное сервером, не переключает источник учётных данных сессии даже после успешного получения. Чтобы доставить эти селекторы в Claude Code v2.1.223 или более поздней версии, используйте [настройки, управляемые на уровне конечного устройства](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms), например MDM или `managed-settings.json`. Для `CLAUDE_CONFIG_DIR` и переменных каталогов операционной системы защитой служит само удержание: кэшированное значение не попадает в окружение, пока сервер не подтвердит данные.
201 210
202Каждый другой ключ в кэшированном блоке `env` применяется при запуске. После подтверждения полезной нагрузки сервером и вашего одобрения, если оно требует [одобрения безопасности](#security-approval-dialogs), удерживаемые переменные применяются для остальной части сеанса.211Все остальные ключи в кэшированном блоке `env` применяются при запуске. Как только сервер подтвердит данные и вы их одобрите, если они требуют [подтверждения безопасности](#security-approval-dialogs), удержанные переменные применяются до конца сессии.
203 212
204Если вашей организации требуется прокси для доступа к `api.anthropic.com`, удержание влияет только на сам доставленный блок `env`: прокси, установленный в [управляемом конечной точкой](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms) блоке `env` через MDM или `managed-settings.json`, в окружении оболочки или в [пользовательских параметрах](https://code.claude.com/docs/ru/settings.md#where-settings-live), достигает выборки параметров. Источник, управляемый конечной точкой, требует Claude Code v2.1.223 или более поздней версии: кэшированное значение прокси, управляемое сервером, удерживается до подтверждения выборкой, поэтому значение, управляемое конечной точкой, заполняется по ключам и достигает самой выборки. До v2.1.223 используйте окружение оболочки или пользовательские параметры, чтобы прокси применялся вместе с кэшированной полезной нагрузкой сервера. Первый запуск не имеет кэша, поэтому источник, управляемый конечной точкой, окружение оболочки или пользовательские параметры все еще требуются для начальной выборки.213Если вашей организации нужен прокси для доступа к `api.anthropic.com`, удержание затрагивает только сам блок `env`, доставленный сервером: прокси, заданный в [управляемом на уровне конечного устройства](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms) блоке `env` через MDM или `managed-settings.json`, в окружении оболочки или в [пользовательских настройках](https://code.claude.com/docs/ru/settings.md#where-settings-live), используется при получении настроек. Источник, управляемый на уровне конечного устройства, требует Claude Code v2.1.223 или более поздней версии: кэшированное значение прокси, управляемое сервером, удерживается, пока получение его не подтвердит, поэтому значение, управляемое на уровне конечного устройства, подставляется по ключу и используется при самом получении. До v2.1.223 используйте окружение оболочки или пользовательские настройки, чтобы прокси применялся вместе с кэшированными серверными данными. При первом запуске кэша нет, поэтому для начального получения по-прежнему требуется источник, управляемый на уровне конечного устройства, окружение оболочки или пользовательские настройки.
205 214
206Claude Code применяет большинство обновлений параметров к работающим сеансам без перезагрузки. Некоторые обновления применяются только при следующем запуске, включая конфигурацию экспортера OpenTelemetry, ключ `model` и удаление переменной из блока `env`.215Claude Code применяет большинство обновлений настроек к работающим сессиям без перезапуска. Некоторые обновления применяются только при следующем запуске, включая конфигурацию экспортера OpenTelemetry, ключ `model` и удаление переменной из блока `env`.
207 216
208### Недействительные записи в доставленных параметрах217### Недопустимые записи в доставленных настройках
209 218
210Когда часть полезной нагрузки не проходит проверку схемы, Claude Code выводит ошибку валидации и применяет каждый оставшийся действительный параметр; [Недействительные записи в управляемых параметрах](https://code.claude.com/docs/ru/managed-settings.md#invalid-entries-in-managed-settings) указывает, что он отбрасывает и какие ключи возвращаются к более строгому значению. Требуется Claude Code v2.1.169 или более поздняя версия.219Когда часть данных не проходит проверку по схеме, Claude Code сообщает об ошибке проверки и применяет все остальные допустимые настройки; в разделе [Недопустимые записи в управляемых настройках](https://code.claude.com/docs/ru/managed-settings.md#invalid-entries-in-managed-settings) указано, что отбрасывается и какие ключи возвращаются к более строгому значению. Требуется Claude Code v2.1.169 или более поздней версии.
211 220
212Доставка, управляемая сервером, добавляет эти поведения:221Доставка, управляемая сервером, добавляет следующее поведение:
213 222
214* Запуск, который работает на кэше в `~/.claude/remote-settings.json`, обрабатывает недействительные записи так же, как выборка, которая написала кэш:223* Запуск, использующий кэш в `~/.claude/remote-settings.json`, обрабатывает недопустимые записи так же, как получение, записавшее этот кэш:
215 * Записи, которые не прошли валидацию, остаются отброшенными.224 * Записи, не прошедшие проверку, остаются отброшенными.
216 * [Ключи, которые отказывают закрыто](https://code.claude.com/docs/ru/managed-settings.md#keys-that-fail-closed), сохраняют свои более строгие значения.225 * [Ключи с отказом при сбое](https://code.claude.com/docs/ru/managed-settings.md#keys-that-fail-closed) сохраняют свои более строгие значения.
217 * Недействительное значение `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` остается в кэшированной копии и никогда не применяется.226 * Недопустимое значение `cleanupPeriodDays` или `desktopSessionCleanupPeriodDays` остаётся в кэшированной копии и никогда не применяется.
218* Claude Code не применяет ничего из полезной нагрузки и оставляет кэш без изменений, когда все три из этих условий верны:227* Claude Code ничего не применяет из данных и оставляет кэш без изменений, когда выполняются все три условия:
219 228
220 * Каждый параметр в полезной нагрузке не проходит валидацию.229 * Каждая настройка в данных не проходит проверку.
221 * Ни один из них не возвращается к более строгому значению.230 * Ни одна из них не возвращается к более строгому значению.
222 * Полезная нагрузка содержит ключ, отличный от этих двух ключей хранения.231 * Данные содержат ключ, отличный от этих двух ключей хранения.
223 232
224 Уведомление при запуске, `/status` и `claude doctor` затем сообщают о [неудачной загрузке](https://code.claude.com/docs/ru/errors.md#remote-managed-settings-failed-to-load) с причиной `no setting in the server response could be applied as written`, и эта запись указывает, на какой политике работает сеанс. Клиенты, которые [применяют принудительный отказ при запуске](#enforce-fail-closed-startup), вместо этого выходят при запуске.233 В этом случае уведомление при запуске, `/status` и `claude doctor` сообщают о [неудачной загрузке](https://code.claude.com/docs/ru/errors.md#remote-managed-settings-failed-to-load) с причиной `no setting in the server response could be applied as written`, а в этой записи указано, на какой политике работает сессия. Клиенты, которые [применяют запуск с отказом при сбое](#enforce-fail-closed-startup), вместо этого завершают работу при запуске. Если запуск прерывается с сообщением о том, что вашей организации требуются её настройки `before a session can start`, см. [Claude Code не смог загрузить настройки вашей организации](https://code.claude.com/docs/ru/errors.md#couldnt-load-your-organizations-settings).
225* [Диалог одобрения безопасности](#security-approval-dialogs) оценивает спасенную полезную нагрузку, поэтому удаленная недействительная запись никогда не представляется для одобрения и никогда не выполняется.234* [Диалог подтверждения безопасности](#security-approval-dialogs) оценивает очищенные данные, поэтому удалённая недопустимая запись никогда не предлагается для подтверждения и никогда не выполняется.
226 235
227Для отладки проблем доставки запустите `claude --debug-file <path>` и найдите в журнале `Remote settings`. Проверьте изменение полезной нагрузки с помощью `claude doctor` на тестовой машине перед развертыванием в организации.236Чтобы отладить проблемы с доставкой, выполните `claude --debug-file <path>` и найдите в логе `Remote settings`. Проверьте изменение данных с помощью `claude doctor` на тестовой машине, прежде чем развёртывать его в организации.
228 237
229### Принудительный отказ при запуске238### Принудительный запуск с отказом при сбое
230 239
231По умолчанию, если выборка удаленных параметров не удается при запуске, CLI продолжает работу с параметрами, кэшированными из последней успешной выборки, за исключением [значений, которые Claude Code удерживает](#fetch-and-caching-behavior) до успешной выборки. На машине, которая никогда их не выполняла, CLI продолжает работу без управляемых сервером параметров и все еще применяет любые [управляемые конечной точкой параметры](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms) на устройстве.240По умолчанию, если получение удалённых настроек при запуске завершается неудачно, CLI продолжает работу с настройками, кэшированными при последнем успешном получении. [Значения, которые Claude Code удерживает](#fetch-and-caching-behavior), остаются удержанными, пока получение не завершится успешно. На машине, которая ни разу их не получала, CLI продолжает работу без настроек, управляемых сервером, и по-прежнему применяет все [настройки, управляемые на уровне конечного устройства](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms), на устройстве. Вместо этого [Anthropic может требовать наличия настроек](#fetch-and-caching-behavior).
232 241
233Чтобы остановить клиентов от запуска с кэшированными или отсутствующими управляемыми сервером параметрами, установите `forceRemoteSettingsRefresh: true` в ваших управляемых параметрах.242Чтобы клиенты не запускались с кэшированными или отсутствующими настройками, управляемыми сервером, задайте `forceRemoteSettingsRefresh: true` в управляемых настройках.
234 243
235Клиенты, вошедшие через [шлюз приложений Claude](#platform-availability), ждут выборки при запуске независимо от того, установлен ли этот параметр, и обрабатывают сбой выборки следующим образом:244Клиенты, вошедшие через [шлюз приложений Claude](#platform-availability), ждут получения при запуске независимо от того, задана ли эта настройка, и обрабатывают неудачное получение следующим образом:
236 245
237* Если шлюз отвечает на посещаемый интерактивный запуск с `401` и этот параметр отключен, шлюз завершил этот вход. Claude Code выводит [`Cloud gateway session expired — run /login to reconnect.`](https://code.claude.com/docs/ru/errors#cloud-gateway-session-expired) и открывает сеанс без входа в шлюз до тех пор, пока пользователь не запустит `/login`.246* Если шлюз отвечает на интерактивный запуск с участием пользователя кодом `401`, а эта настройка отключена, значит, шлюз завершил этот вход. Claude Code выводит [`Cloud gateway session expired — run /login to reconnect.`](https://code.claude.com/docs/ru/errors#cloud-gateway-session-expired) и открывает сессию без входа в шлюз, пока пользователь не выполнит `/login`.
238* Когда выборка не удается каким-либо другим способом или в любом другом типе запуска, кроме подкоманды `claude auth`, клиент выходит с ошибкой.247* Если получение завершается неудачно любым другим образом или при запуске любого другого типа, кроме подкоманды `claude auth`, клиент завершает работу с ошибкой.
239 248
240Когда этот параметр активен в сеансе, который выполняет выборку управляемых сервером параметров, CLI блокируется при запуске до тех пор, пока удаленные параметры не будут свежо выбраны. Если выборка не удается, CLI выходит вместо продолжения без политики. Этот параметр самовоспроизводится: после доставки с сервера он также кэшируется локально, чтобы последующие запуски применяли то же поведение даже перед первой успешной выборкой нового сеанса. Сеанс, который [не выполняет выборку управляемых сервером параметров](#platform-availability), начинается без ожидания.249Когда эта настройка активна в сессии, которая получает настройки, управляемые сервером, CLI блокируется при запуске, пока удалённые настройки не будут заново получены. Если получение завершается неудачно, CLI завершает работу, а не продолжает без политики. Эта настройка самовоспроизводится: после доставки с сервера она также кэшируется локально, так что последующие запуски применяют то же поведение ещё до первого успешного получения в новой сессии. Сессия, которая [не получает настройки, управляемые сервером](#platform-availability), запускается без ожидания.
241 250
242Чтобы включить это, добавьте ключ в конфигурацию управляемых параметров:251Чтобы включить эту возможность, добавьте ключ в конфигурацию управляемых настроек:
243 252
244```json theme={null}253```json theme={null}
245{254{
247}256}
248```257```
249 258
250Вы также можете установить этот ключ в [управляемом конечной точкой](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms) профиле MDM или системном файле `managed-settings.json` для применения поведения отказа при запуске, перед поступлением любой полезной нагрузки сервера. Этот флаг является исключением из [правила приоритета](#settings-precedence) выше: Claude Code соблюдает его, когда любой управляемый администратором источник его устанавливает, даже если также присутствует кэшированная полезная нагрузка, управляемая сервером, поэтому он не игнорирует значение, доставленное MDM, когда существуют управляемые сервером параметры.259Вы также можете задать этот ключ в [управляемом на уровне конечного устройства](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms) профиле MDM или системном файле `managed-settings.json`, чтобы применить поведение с отказом при сбое при первом запуске, до поступления каких-либо данных с сервера. Этот флаг является исключением из описанного выше [правила приоритета](#settings-precedence): Claude Code учитывает его, когда его задаёт любой управляемый источник, контролируемый администратором, даже если также присутствуют кэшированные данные, управляемые сервером, поэтому значение, доставленное через MDM, не игнорируется при наличии настроек, управляемых сервером.
251 260
252Когда [`policyHelper`](https://code.claude.com/docs/ru/settings-reference#policyhelper) предоставляет управляемые параметры, его выходные данные заменяют каждый другой управляемый источник для ключей, которые Claude Code читает после запуска. Для источников, из которых Claude Code читает этот ключ, см. [его запись параметров](https://code.claude.com/docs/ru/settings-reference.md#forceremotesettingsrefresh). Запись `policyHelper` указывает, из каких источников Claude Code читает помощника и когда он запускается.261Когда [`policyHelper`](https://code.claude.com/docs/ru/settings-reference#policyhelper) предоставляет управляемые настройки, его вывод заменяет все остальные управляемые источники для ключей, которые Claude Code читает после запуска. Об источниках, из которых Claude Code читает этот ключ, см. [его запись в справочнике настроек](https://code.claude.com/docs/ru/settings-reference.md#forceremotesettingsrefresh). В записи `policyHelper` указано, из каких источников Claude Code читает хелпер и когда он запускается.
253 262
254Выборка параметров также отправляет заголовок `Cache-Control: no-cache`, чтобы промежуточные HTTP-прокси не обслуживали устаревший ответ.263При получении настроек также отправляется заголовок `Cache-Control: no-cache`, чтобы промежуточные HTTP-прокси не отдавали устаревший ответ.
255 264
256Перед включением этого параметра убедитесь, что ваши сетевые политики разрешают подключение к `api.anthropic.com`. Если эта конечная точка недоступна, CLI выходит при запуске и пользователи не могут запустить Claude Code.265Прежде чем включать эту настройку, убедитесь, что сетевые политики разрешают подключение к `api.anthropic.com`. Если этот эндпоинт недоступен, CLI завершает работу при запуске, и пользователи не могут запустить Claude Code.
257 266
258Подкоманды `claude auth`, такие как `claude auth login`, освобождены от этой проверки и от выхода при запуске шлюза, поэтому пользователи могут повторно аутентифицироваться, когда истекшие учетные данные являются причиной сбоя выборки параметров.267Подкоманды `claude auth`, такие как `claude auth login`, освобождены от этой проверки и от завершения при запуске через шлюз, чтобы пользователи могли повторно пройти аутентификацию, когда причиной неудачного получения настроек являются истёкшие учётные данные.
259 268
260### Диалоги одобрения безопасности269### Диалоги подтверждения безопасности
261 270
262Определенные параметры, которые могут представлять риск безопасности, требуют явного одобрения пользователя перед применением Claude Code в интерактивном сеансе:271Некоторые настройки, которые могут представлять угрозу безопасности, требуют явного подтверждения пользователя, прежде чем Claude Code применит их в интерактивной сессии:
263 272
264* **Параметры команды оболочки**: параметры, которые выполняют команды оболочки, такие как `apiKeyHelper`, `statusLine` и `otelHeadersHelper`273* **Настройки shell-команд**: настройки, выполняющие shell-команды, например `apiKeyHelper`, `statusLine` и `otelHeadersHelper`
265* **Параметры двоичного файла песочницы**: `sandbox.bwrapPath`, `sandbox.socatPath` и `sandbox.ripgrep`. Каждый из этих параметров указывает на исполняемый файл, и Claude Code запускает этот исполняемый файл274* **Настройки исполняемых файлов песочницы**: `sandbox.bwrapPath`, `sandbox.socatPath` и `sandbox.ripgrep`. Каждая из этих настроек указывает на исполняемый файл, и Claude Code запускает этот исполняемый файл
266* **Настройки сети и изоляции песочницы**: настройки [песочницы](https://code.claude.com/docs/ru/sandboxing.md), которые позволяют прокси песочницы читать, перенаправлять или аутентифицировать трафик либо ослабляют изоляцию песочницы: `sandbox.network.tlsTerminate`, `sandbox.network.httpProxyPort`, `sandbox.network.socksProxyPort`, `sandbox.credentials`, `sandbox.allowAppleEvents`, `sandbox.allowNestedUserNamespaces`, `sandbox.enableWeakerNestedSandbox`, `sandbox.enableWeakerNetworkIsolation`, `sandbox.filesystem.disabled`, `sandbox.network.allowAllUnixSockets`, `sandbox.network.allowUnixSockets` и `sandbox.network.allowMachLookup`. Блок `sandbox.credentials`, содержащий только правила `deny`, не требует подтверждения, так как он ограничивает песочницу, не передавая прокси учётные данные. До v2.1.251 Claude Code применял эти настройки без подтверждения275* **Настройки сети и изоляции песочницы**: настройки [песочницы](https://code.claude.com/docs/ru/sandboxing.md), которые позволяют прокси песочницы читать, перенаправлять или аутентифицировать трафик или ослабляют изоляцию песочницы: `sandbox.network.tlsTerminate`, `sandbox.network.httpProxyPort`, `sandbox.network.socksProxyPort`, `sandbox.credentials`, `sandbox.allowAppleEvents`, `sandbox.allowNestedUserNamespaces`, `sandbox.enableWeakerNestedSandbox`, `sandbox.enableWeakerNetworkIsolation`, `sandbox.filesystem.disabled`, `sandbox.network.allowAllUnixSockets`, `sandbox.network.allowUnixSockets` и `sandbox.network.allowMachLookup`. Блок `sandbox.credentials`, содержащий только правила `deny`, не требует подтверждения, поскольку он ограничивает песочницу, не предоставляя прокси учётных данных. До v2.1.251 Claude Code применял эти настройки без подтверждения
267* **Пользовательские переменные окружения**: доставленные переменные `env`, требующие одобрения пользователя, такие как переменные прокси и базового URL; см. [Переменные окружения и диалог одобрения](#environment-variables-and-the-approval-dialog)276* **Пользовательские переменные окружения**: доставленные переменные `env`, требующие подтверждения пользователя, например переменные прокси и базового URL; см. [Переменные окружения и диалог подтверждения](#environment-variables-and-the-approval-dialog)
268* **Конфигурации hooks**: любое определение hooks277* **Конфигурации хуков**: любое определение хука
269 278
270Когда эти параметры присутствуют, пользователи видят диалог безопасности, объясняющий, что настраивается. Пользователи должны одобрить для продолжения. Если пользователь отклоняет параметры, Claude Code выходит.279Когда эти настройки присутствуют, пользователи видят диалог безопасности с объяснением того, что настраивается. Чтобы продолжить, пользователи должны дать подтверждение. Если пользователь отклоняет настройки, Claude Code завершает работу.
271 280
272Управляемый CLAUDE.md, доставленный через ключ [`claudeMd`](https://code.claude.com/docs/ru/settings-reference#claudemd), не требует одобрения, потому что это текст инструкций для Claude, а не команда, которую запускает Claude Code. Claude Code все еще проверяет [разрешения](https://code.claude.com/docs/ru/permissions.md) для инструментов, которые Claude использует при следовании этим инструкциям. До v2.1.260 значение `claudeMd` также требовало одобрения.281Управляемый CLAUDE.md, доставленный через ключ [`claudeMd`](https://code.claude.com/docs/ru/settings-reference#claudemd), не требует подтверждения, поскольку это текст инструкций для Claude, а не команда, которую запускает Claude Code. Claude Code по-прежнему проверяет [разрешения](https://code.claude.com/docs/ru/permissions.md) для инструментов, которые Claude использует, следуя этим инструкциям. До v2.1.260 значение `claudeMd` также требовало подтверждения.
273 282
274#### Память одобрения283#### Запоминание подтверждения
275 284
276Claude Code записывает ваше одобрение в каталог конфигурации, `~/.claude`, если вы не установили [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ru/env-vars). Что он записывает, зависит от учетных данных, которые использует выборка параметров:285Claude Code записывает ваше подтверждение в каталог конфигурации — `~/.claude`, если вы не задали [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ru/env-vars). Что именно записывается, зависит от учётных данных, которые использует получение настроек:
277 286
278* **Вход claude.ai, сохраненный `/login` или `claude auth login`, или [вход в консоль без ключа](https://code.claude.com/docs/ru/authentication.md#sign-in-without-an-api-key)**: одно одобрение на организацию, удерживаемое учетной записью, которая одобрила последней.287* **Вход claude.ai, сохранённый с помощью `/login` или `claude auth login`, или [вход в Console без ключа](https://code.claude.com/docs/ru/authentication.md#sign-in-without-an-api-key)**: одно подтверждение на организацию, которое принадлежит аккаунту, давшему подтверждение последним.
279* **Вход [шлюза приложений Claude](https://code.claude.com/docs/ru/claude-apps-gateway)**: одно одобрение на шлюз.288* **Вход через [шлюз приложений Claude](https://code.claude.com/docs/ru/claude-apps-gateway)**: одно подтверждение на шлюз.
280 289
281 Если вы выходите и снова входите в тот же шлюз, Claude Code не показывает диалог снова, пока параметры, требующие одобрения, не изменятся. Claude Code показывает его снова, когда эти параметры изменяются, когда вы входите в другой шлюз и когда вы принимаете новый сертификат для того же шлюза.290 Если вы выходите и снова входите в тот же шлюз, Claude Code не показывает диалог повторно, пока настройки, требующие подтверждения, не изменились. Claude Code показывает его снова, когда эти настройки меняются, когда вы входите в другой шлюз и когда вы принимаете новый сертификат для того же шлюза.
282 291
283 Claude Code не сохраняет одобрение для шлюза разработки обратной связи, доступного через простой HTTP, поэтому диалог появляется снова после каждого входа.292 Claude Code не сохраняет подтверждение для loopback-шлюза разработки, доступного по обычному HTTP, поэтому диалог появляется снова после каждого входа.
284* **Любые другие учетные данные**, такие как ключ API или `CLAUDE_CODE_OAUTH_TOKEN`: одно одобрение для доставленных параметров, сохраняемое с кэшированной копией параметров в этом каталоге конфигурации. Claude Code показывает диалог снова, когда параметры, требующие одобрения, изменяются, и после запуска `/logout` или `claude auth logout`, каждый из которых удаляет кэшированную копию.293* **Любые другие учётные данные**, например API-ключ или `CLAUDE_CODE_OAUTH_TOKEN`: одно подтверждение для доставленных настроек, хранящееся вместе с кэшированной копией настроек в этом каталоге конфигурации. Claude Code показывает диалог снова, когда меняются настройки, требующие подтверждения, и после того, как вы выполните `/logout` или `claude auth logout` — любая из этих команд удаляет кэшированную копию.
285 294
286Одобрение для `sandbox.credentials` или `sandbox.network.tlsTerminate` также охватывает записи [`sandbox.network.allowedDomains`](https://code.claude.com/docs/ru/settings-reference#sandbox-network-alloweddomains) в этих же доставленных параметрах, потому что оба параметра действуют на этот список разрешений. Диалог появляется снова, когда ваш администратор добавляет или удаляет одну из этих записей, даже хотя `sandbox.network.allowedDomains` не требует одобрения сам по себе.295Подтверждение для `sandbox.credentials` или `sandbox.network.tlsTerminate` также распространяется на записи [`sandbox.network.allowedDomains`](https://code.claude.com/docs/ru/settings-reference#sandbox-network-alloweddomains) в тех же доставленных настройках, поскольку обе настройки действуют на этот список разрешённых доменов. Диалог появляется снова, когда администратор добавляет или удаляет одну из этих записей, даже несмотря на то что `sandbox.network.allowedDomains` сам по себе не требует подтверждения.
287 296
288С сохраненным входом claude.ai:297При сохранённом входе claude.ai:
289 298
290* Если вы выходите и снова входите, или переключаетесь на другую организацию и позже возвращаетесь, Claude Code не показывает диалог снова, пока эти параметры не изменятся, если только другая учетная запись не одобрила их для этой организации в том же каталоге конфигурации в промежутке.299* Если вы выходите и снова входите или переключаетесь на другую организацию, а затем возвращаетесь, Claude Code не показывает диалог повторно, пока эти настройки не изменились, если только в промежутке другой аккаунт не подтвердил их для этой организации в том же каталоге конфигурации.
291* Если вы входите в ту же организацию с другой учетной записью, Claude Code показывает диалог снова, даже когда параметры не изменяются. Одобрение этой учетной записи заменяет предыдущее, поэтому когда вы переключаетесь обратно, Claude Code показывает диалог еще раз.300* Если вы входите в ту же организацию с другим аккаунтом, Claude Code показывает диалог снова, даже если настройки не изменились. Подтверждение этого аккаунта заменяет предыдущее, поэтому при обратном переключении Claude Code снова показывает диалог.
292 301
293Claude Code не всегда может показать диалог. Каждый случай ниже указывает, какие параметры применяются, когда он не может, и когда вы снова видите диалог:302Claude Code не всегда может показать диалог. В каждом из случаев ниже указано, какие настройки применяются, когда это невозможно, и когда вы увидите диалог в следующий раз:
294 303
295* **Интерактивная сессия, которая не может показать диалог**: Claude Code не применяет доставленные настройки и сохраняет последние подтверждённые. Диалог появляется в следующей сессии, которая может его показать.304* **Интерактивная сессия, которая не может показать диалог**: Claude Code не применяет доставленные настройки и сохраняет последние подтверждённые настройки. Диалог появляется в следующей сессии, которая может его показать.
296* **`claude install` или `claude update`**: Claude Code не показывает диалог во время любой команды. Команда запускается с последними одобренными параметрами, и диалог появляется в вашем следующем интерактивном сеансе. Если Claude Code ждет выборки параметров при запуске, например с установленным [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) или при развертывании [шлюза приложений Claude](https://code.claude.com/docs/ru/claude-apps-gateway), он показывает диалог во время команды вместо этого, и запуск установки из трубы не удается; см. [`Raw mode is not supported` during install](https://code.claude.com/docs/ru/troubleshoot-install#raw-mode-is-not-supported-during-install). До v2.1.246 Claude Code пытался показать диалог во время этих команд тоже.305* **`claude install` или `claude update`**: Claude Code не показывает диалог во время выполнения этих команд. Команда выполняется с последними подтверждёнными настройками, а диалог появляется в вашей следующей интерактивной сессии. Если Claude Code ждёт получения настроек при запуске, например когда задан [`forceRemoteSettingsRefresh`](#enforce-fail-closed-startup) или при развёртывании [шлюза приложений Claude](https://code.claude.com/docs/ru/claude-apps-gateway), он вместо этого показывает диалог во время выполнения команды, и установка, запущенная из канала, завершается неудачно; см. [`Raw mode is not supported` во время установки](https://code.claude.com/docs/ru/troubleshoot-install#raw-mode-is-not-supported-during-install). До v2.1.246 Claude Code также пытался показать диалог во время этих команд.
297* **Команда `claude plugin`, которая выводит данные в терминал, но не может читать ввод с клавиатуры**: если Claude Code не дожидается получения настроек при запуске, команда не применяет доставленные настройки. Без [кэшированных настроек](#fetch-and-caching-behavior) команда, изменяющая ваши плагины или маркетплейсы, [останавливается с ошибкой](https://code.claude.com/docs/ru/errors.md#managed-settings-need-your-approval). При наличии кэшированных настроек она выполняется с последними подтверждёнными настройками. Диалог появляется, когда вы в следующий раз запустите `claude` в терминале.306* **Команда `claude plugin`, которая выводит данные в терминал, но не может читать с клавиатуры**: когда Claude Code не ждёт получения настроек при запуске, команда не применяет доставленные настройки. Без [кэшированных настроек](#fetch-and-caching-behavior) команда, изменяющая ваши плагины или маркетплейсы, [останавливается с ошибкой](https://code.claude.com/docs/ru/errors.md#managed-settings-need-your-approval). С кэшированными настройками она выполняется с последними подтверждёнными настройками. Диалог появляется, когда вы в следующий раз запустите `claude` в терминале.
298 307
299 Команда не может читать ввод с клавиатуры, когда вы передаёте её ввод через конвейер или перенаправляете его и, в macOS и Linux, она также не может открыть `/dev/tty`. Если вы также передаёте через конвейер или перенаправляете её вывод, запуск считается неинтерактивным, и доставленные настройки применяются только для этого запуска.308 Команда не может читать с клавиатуры, когда вы передаёте ей ввод через канал или перенаправляете его и, в macOS и Linux, она также не может открыть `/dev/tty`. Если вы также передаёте через канал или перенаправляете её вывод, запуск становится неинтерактивным, и доставленные настройки применяются только для этого запуска.
300* **Ошибка закрывает диалог перед вашим ответом**: Claude Code не применяет доставленные параметры и сохраняет последние одобренные параметры. Он показывает диалог снова в следующем сеансе, который может его показать.309* **Ошибка закрывает диалог до того, как вы ответите**: Claude Code не применяет доставленные настройки и сохраняет последние подтверждённые настройки. Он снова показывает диалог в следующей сессии, которая может его показать.
301* **Неинтерактивный запуск**, такой как `claude -p`, сессия Agent SDK или сессия в панели чата расширения VS Code или на вкладке Code настольного приложения: Claude Code не может показать диалог. Если доставленные настройки требуют подтверждения, они применяются только для этого запуска.310* **Неинтерактивный запуск**, например `claude -p`, сессия Agent SDK или сессия на панели чата расширения VS Code либо на вкладке Code настольного приложения: Claude Code не может показать диалог. Если доставленные настройки требуют подтверждения, они применяются только для этого запуска.
302 311
303 Claude Code не отмечает настройки как подтверждённые и не записывает их в [локальный кэш](#fetch-and-caching-behavior), а следующая интерактивная сессия показывает диалог. Пока пользователь не подтвердит их в интерактивной сессии, каждый неинтерактивный запуск заново выполняет выборку настроек при старте.312 Claude Code не отмечает настройки как подтверждённые и не записывает их в [локальный кэш](#fetch-and-caching-behavior), а следующая интерактивная сессия показывает диалог. Пока пользователь не даст подтверждение в интерактивной сессии, каждый неинтерактивный запуск заново получает настройки при запуске.
304 313
305#### Переменные окружения и диалог одобрения314#### Переменные окружения и диалог подтверждения
306 315
307Claude Code применяет некоторые доставленные переменные `env` без показа пользователю диалога одобрения, включая:316Claude Code применяет некоторые доставленные переменные `env`, не показывая пользователю диалог подтверждения, в том числе:
308 317
309* Переключатели функций и команд318* Переключатели функций и команд
310* Параметры выбора и поведения модели, такие как `ANTHROPIC_MODEL`, `DISABLE_PROMPT_CACHING` и `CLAUDE_CODE_EFFORT_LEVEL`319* Настройки выбора и поведения модели, например `ANTHROPIC_MODEL`, `DISABLE_PROMPT_CACHING` и `CLAUDE_CODE_EFFORT_LEVEL`
311* Настройки контекстного окна и сжатия контекста, такие как `DISABLE_AUTO_COMPACT`, но не `CLAUDE_CODE_DISABLE_1M_CONTEXT`320* Настройки контекстного окна и сжатия контекста, например `DISABLE_AUTO_COMPACT`, но не `CLAUDE_CODE_DISABLE_1M_CONTEXT`
312* Параметры пользовательского интерфейса терминала и доступности321* Параметры пользовательского интерфейса терминала и специальных возможностей
313* Числовые ограничения, бюджеты и тайм-ауты322* Числовые ограничения, бюджеты и таймауты
314 323
315Другие доставленные переменные могут требовать подтверждения пользователя, прежде чем вступят в силу. Например, в интерактивных сессиях подтверждение всегда требуется при любом непустом значении для следующих переменных:324Другие доставленные переменные могут требовать подтверждения пользователя, прежде чем вступят в силу. Например, в интерактивных сессиях следующие переменные всегда требуют его при любом непустом значении:
316 325
317* Переменная прокси или базового URL326* Переменная прокси или базового URL
318* `OTEL_EXPORTER_OTLP_ENDPOINT`327* `OTEL_EXPORTER_OTLP_ENDPOINT`
319* `CLAUDE_CODE_DISABLE_1M_CONTEXT`328* `CLAUDE_CODE_DISABLE_1M_CONTEXT`
320 329
321Когда доставленная переменная требует подтверждения, диалог называет её, поэтому пользователь видит, что именно политика просит установить.330Когда доставленной переменной требуется подтверждение, диалог называет её, чтобы пользователь точно видел, что политика пытается задать.
322 331
323Для четырёх переключателей конфиденциальности Claude Code определяет необходимость подтверждения по доставленному значению, а не по имени переменной: `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_ERROR_REPORTING`, `DISABLE_TELEMETRY` и `DO_NOT_TRACK`. Истинное значение, такое как `1` или `true`, только отключает отслеживание, отчёты об ошибках или другой несущественный трафик, поэтому Claude Code применяет его, не спрашивая пользователя. Для любого другого непустого значения Claude Code показывает диалог.332Для четырёх переключателей конфиденциальности Claude Code решает, нужно ли подтверждение, по доставленному значению, а не по имени переменной: `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_ERROR_REPORTING`, `DISABLE_TELEMETRY` и `DO_NOT_TRACK`. Истинное значение, например `1` или `true`, лишь отключает отслеживание, отправку отчётов или другой необязательный трафик, поэтому Claude Code применяет его, не спрашивая пользователя. Для любого другого непустого значения Claude Code показывает диалог.
324 333
325Claude Code также решает, требует ли [`API_FORCE_IDLE_TIMEOUT`](https://code.claude.com/docs/ru/env-vars) одобрения по доставленному значению: истинное значение только включает [тайм-аут простоя тела](https://code.claude.com/docs/ru/network-config.md#streaming-idle-watchdogs), поэтому Claude Code применяет его без запроса пользователя. Для любого другого непустого значения Claude Code показывает диалог. До v2.1.248 любое непустое значение вызывало диалог.334Для [`API_FORCE_IDLE_TIMEOUT`](https://code.claude.com/docs/ru/env-vars) Claude Code также решает, нужно ли подтверждение, по доставленному значению: истинное значение лишь включает [таймаут простоя тела ответа](https://code.claude.com/docs/ru/network-config.md#streaming-idle-watchdogs), поэтому Claude Code применяет его, не спрашивая пользователя. Для любого другого непустого значения Claude Code показывает диалог. До v2.1.248 любое непустое значение вызывало диалог.
326 335
327Требует ли [`ANTHROPIC_CUSTOM_HEADERS`](https://code.claude.com/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` применялось без него.336Нужно ли подтверждение для [`ANTHROPIC_CUSTOM_HEADERS`](https://code.claude.com/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` применялось без него.
328 337
329Ложное значение, такое как `0` или `false`, для [`ENABLE_BETA_TRACING_DETAILED`](https://code.claude.com/docs/ru/env-vars#variables) или [`OTEL_LOG_RAW_API_BODIES`](https://code.claude.com/docs/ru/env-vars#variables), применяется без диалога, потому что оно только отключает детальную трассировку или захват тела сырого API. Любое другое непустое значение для любой переменной требует одобрения.338Ложное значение, например `0` или `false`, для [`ENABLE_BETA_TRACING_DETAILED`](https://code.claude.com/docs/ru/env-vars#variables) или [`OTEL_LOG_RAW_API_BODIES`](https://code.claude.com/docs/ru/env-vars#variables) применяется без диалога, поскольку оно лишь отключает подробную трассировку или захват необработанных тел запросов API. Любое другое непустое значение для любой из этих переменных требует подтверждения.
330 339
331## Доступность платформы340## Доступность платформы
332 341
370| Пользователь удаляет кэшированный файл параметров | Происходит [поведение первого запуска](#fetch-and-caching-behavior) |379| Пользователь удаляет кэшированный файл параметров | Происходит [поведение первого запуска](#fetch-and-caching-behavior) |
371| Пользователь запускает измененный двоичный файл Claude Code | Пользователь, который может запустить измененный клиент, может обойти любой элемент управления на стороне клиента |380| Пользователь запускает измененный двоичный файл Claude Code | Пользователь, который может запустить измененный клиент, может обойти любой элемент управления на стороне клиента |
372| Пользователь запускает более старую версию Claude Code | Версии, которые предшествуют параметрам, управляемым сервером, не выбирают и не применяют их |381| Пользователь запускает более старую версию Claude Code | Версии, которые предшествуют параметрам, управляемым сервером, не выбирают и не применяют их |
373| API недоступен | Кэшированные параметры применяются, если доступны, за исключением [значений, которые Claude Code удерживает](#fetch-and-caching-behavior) до успешной выборки. Без кэша Claude Code не применяет параметры, управляемые сервером, до следующей успешной выборки, и по-прежнему применяет любые [параметры, управляемые конечной точкой](https://code.claude.com/docs/ru/managed-settings.md#delivery-mechanisms) на устройстве. С `forceRemoteSettingsRefresh: true` CLI выходит вместо продолжения, за исключением [`claude auth` подкоманд](#enforce-fail-closed-startup). Клиенты, вошедшие через [шлюз приложений Claude](#platform-availability), выходят при запуске без этого параметра, с той же исключением `claude auth` |382| API недоступен | Кэшированные настройки применяются, если доступны. Без кэша Claude Code не применяет настройки, управляемые сервером, до следующей успешной выборки. В разделе [Поведение выборки и кэширования](#fetch-and-caching-behavior) перечислены исключения, в том числе случай, когда Anthropic требует эти настройки. С `forceRemoteSettingsRefresh: true` CLI завершает работу вместо продолжения, за исключением [подкоманд `claude auth`](#enforce-fail-closed-startup). Клиенты, вошедшие через [шлюз приложений Claude](#platform-availability), завершают работу при запуске и без этой настройки, с тем же исключением для `claude auth` |
374| Пользователь аутентифицируется с другой организацией | Настройки не доставляются для учётных записей вне управляемой организации, включая сессию, которая аутентифицируется с помощью [API-ключа Console](#platform-availability) |383| Пользователь аутентифицируется с другой организацией | Настройки не доставляются для учётных записей вне управляемой организации, включая сессию, которая аутентифицируется с помощью [API-ключа Console](#platform-availability) |
375| Пользователь настраивает [поставщика моделей третьей стороны](#platform-availability) | Параметры, управляемые сервером, обходятся. Это включает установку `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS` или нестандартного `ANTHROPIC_BASE_URL` |384| Пользователь настраивает [поставщика моделей третьей стороны](#platform-availability) | Параметры, управляемые сервером, обходятся. Это включает установку `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS` или нестандартного `ANTHROPIC_BASE_URL` |
376| Сетевой трафик перехватывается или перенаправляется | Отключенная проверка TLS или перехваченный трафик могут изменить параметры, которые получает клиент |385| Сетевой трафик перехватывается или перенаправляется | Отключенная проверка TLS или перехваченный трафик могут изменить параметры, которые получает клиент |
