Настройка параметров, управляемых сервером

Централизованно настраивайте Claude Code для вашей организации через параметры, доставляемые сервером, без необходимости инфраструктуры управления устройствами.

Параметры, управляемые сервером, позволяют администраторам организации централизованно настраивать Claude Code из Admin Settings > Claude Code > Managed settings в консоли claude.ai. Клиенты Claude Code автоматически получают эти параметры при аутентификации пользователей с использованием подходящих учетных данных на платформе, где поддерживается доставка параметров, управляемых сервером. См. Доступность платформы для получения информации об учетных данных и платформах, которые соответствуют требованиям.

Требования

Для использования параметров, управляемых сервером, вам необходимо:

• План Claude for Teams или Claude for Enterprise
• Роль Owner или Primary Owner в вашей организации Claude для просмотра и редактирования конфигурации
• Сетевой доступ к api.anthropic.com

Выбор между параметрами, управляемыми сервером, и параметрами, управляемыми конечной точкой

Claude Code поддерживает два подхода к централизованной конфигурации. Параметры, управляемые сервером, доставляют конфигурацию с серверов Anthropic. Параметры, управляемые конечной точкой развертываются непосредственно на устройства через встроенные политики ОС (управляемые параметры macOS, реестр Windows) или управляемые файлы параметров.

Если ваши устройства зарегистрированы в решении MDM или управления конечными точками, параметры, управляемые конечной точкой, обеспечивают более сильные гарантии безопасности, поскольку файл параметров может быть защищен от изменения пользователем на уровне ОС. Параметры, управляемые конечной точкой, не достигают облачных сеансов в размещенных в Anthropic средах, поэтому организации, использующие Claude Code в веб-версии, должны также настроить параметры, управляемые сервером. Сеансы в самостоятельно размещенной среде также читают управляемый файл параметров в образе runner. Приоритет параметров ниже указывает, когда этот файл применяется.

Настройка параметров, управляемых сервером

{
"permissions": {
"deny": [
"Bash(curl *)",
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)"
],
"disableBypassPermissionsMode": "disable"
},
"allowManagedPermissionRulesOnly": true
}

{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{ "type": "command", "command": "/usr/local/bin/audit-edit.sh" }
]
}
]
}
}

Проверка доставки параметров

Чтобы подтвердить, что параметры применяются, попросите пользователя перезагрузить Claude Code. Если конфигурация включает параметры, которые запускают диалог одобрения безопасности, пользователь видит подсказку, описывающую управляемые параметры при следующей загрузке параметров Claude Code: при следующем запуске или в течение часа в работающем интерактивном сеансе. Вы также можете проверить, что активны управляемые правила разрешений, попросив пользователя запустить /permissions для просмотра его эффективных правил разрешений.

Чтобы проверить результат загрузки на конкретной машине, попросите пользователя запустить claude doctor и прочитать строку Managed settings (remote). Требуется Claude Code v2.1.248 или позже. Строка сообщает об одном из четырех результатов:

• Доставленные параметры загружены
• Ваша организация не имеет настроенных параметров, управляемых сервером
• Загрузка не удалась, с указанием причины и того, применяется ли кэшированная политика
• Claude Code пропустил загрузку, с указанием причины. См. Доступность платформы для поставщиков и конфигураций, которые пропускают её

Пока загрузка еще выполняется, строка сообщает об этом вместо этого.

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

Контроль доступа

Следующие роли могут управлять параметрами, управляемыми сервером:

• Primary Owner
• Owner

Ограничьте доступ доверенному персоналу, так как изменения параметров применяются ко всем пользователям в организации.

Параметры только для управления

Большинство ключей параметров работают в любой области. Несколько ключей читаются только из управляемых параметров и не имеют эффекта при размещении в файлах параметров пользователя или проекта. См. параметры только для управления для элементов управления разрешениями и плагинами, или прочитайте столбец Scope в индексе Все параметры для полного набора.

Текущие ограничения

Параметры, управляемые сервером, имеют следующие ограничения:

• Параметры применяются одинаково ко всем пользователям в организации. Конфигурации для отдельных групп еще не поддерживаются.

• Вы не можете распространять файл managed-mcp.json через параметры, управляемые сервером. Вместо этого доставьте там ключи политики allowedMcpServers и deniedMcpServers. На Claude Code v2.1.259 или позже вы также можете предоставить удаленные серверы с помощью managedMcpServers, который принимает только серверы http и sse и не берет исключительный контроль так, как это делает файл.

  Claude Code читает managed-mcp.json, развернутый по его системному пути, отдельно от уровня управляемых параметров, поэтому файл все еще применяется, когда действуют параметры, управляемые сервером.

• Параметры, ограниченные источниками политики на уровне ОС, такие как policyHelper и wslInheritsWindowsSettings, не учитываются. Разверните их через MDM или системный файл managed-settings.json вместо этого. policyHelper, развернутый таким образом, работает только тогда, когда его источник является выбранным в приоритете в пределах управляемого уровня.

Доставка параметров

Приоритет параметров

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

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

Если выбранный источник — это политика MDM или файл управляемых параметров, чей policyHelper предоставляет управляемые параметры, вывод помощника заменяет этот источник как единственную управляемую конфигурацию для запуска. Claude Code не обращается к policyHelper, настроенному в параметрах MDM или на основе файлов, пока параметры, управляемые сервером, доставляют ключ политики.

Если более поздняя выборка обнаруживает удаленные параметры, управляемые сервером, Claude Code сразу же запускает этот помощник вместо следующего запуска. Запись policyHelper охватывает то, что происходит, когда этот запуск не удается.

Если вы очищаете конфигурацию, управляемую сервером, в консоли администратора с намерением вернуться к управляемому plist или политике реестра, управляемой конечной точкой, имейте в виду, что кэшированные параметры сохраняются на клиентских машинах до следующей успешной выборки, и ключи, которые применяются только при следующем запуске, такие как model, остаются в силе до тех пор, пока каждый клиент не перезагрузится. Запустите /status для просмотра того, какой управляемый источник активен.

Исключения для отдельных ключей в управляемых источниках

Три вида ключей являются исключениями из правила отсутствия объединения:

• Ключи блокировки между источниками: небольшой набор ключей, таких как блокировки списка разрешений песочницы, указанные на странице управляемых параметров. Claude Code соблюдает их, когда любой управляемый администратором источник их устанавливает; уровень реестра HKCU, доступный для записи пользователем, исключен. Когда policyHelper предоставляет управляемые параметры, его вывод является единственным источником, который эти проверки читают, за исключением forceRemoteSettingsRefresh, который Claude Code читает из источников администратора непосредственно при запуске.
• Блок env: помимо единицы телеметрии и переменных маршрутизации, связанных с ключом учетных данных, оба рассмотрены ниже, он объединяется для каждого ключа в управляемых источниках, контролируемых администратором. Для каждой переменной окружения источник с наивысшим приоритетом, определяющий ее, побеждает, и источники администратора с более низким приоритетом заполняют переменные, которые источники с более высоким приоритетом оставляют неустановленными. Запись env, управляемая конечной точкой, поэтому применяется всякий раз, когда конфигурация, управляемая сервером, оставляет эту переменную неустановленной, или пока кэшированное значение сервера для нее удерживается в ожидании подтверждения сервером. Требуется Claude Code v2.1.223 или более поздняя версия. До v2.1.223 Claude Code применяет только весь блок env выбранного источника.
  • Единица телеметрии: ключи экспортера OTEL_EXPORTER_OTLP_*, переключатели захвата содержимого OTEL_LOG_*, OTEL_LOGS_EXPORTER и переменные бета-трассировки ENABLE_BETA_TRACING_DETAILED и BETA_TRACING_ENDPOINT следуют источнику с наивысшим приоритетом, который устанавливает любой из них как единицу. Источник, который доставляет ключ учетных данных otelHeadersHelper, также претендует на единицу, но размещает эти переменные только когда он является выбранным источником: источник, который не выбран, но доставляет ключ, не вносит ни один из них и все еще блокирует источники с более низким приоритетом от их заполнения. В любом случае конечная точка экспортера из одного источника никогда не может быть связана с учетными данными из другого.
  • Маршрутизация, связанная с учетными данными: источник, который связывает переменные маршрутизации с ключом учетных данных, применяемым только для выбранного источника, таким как apiKeyHelper или otelHeadersHelper, вносит эти переменные маршрутизации только когда он выигрывает слот.
• Ключи входа через шлюз: Claude Code никогда не читает forceLoginGatewayUrl или значение "gateway" из forceLoginMethod из параметров, управляемых сервером, поэтому выбор параметров, управляемых сервером, ни предоставляет вход через шлюз, ни скрывает тот, который установлен в политике MDM или файле управляемых параметров. Запись managedSourcesBehavior указывает, какой управляемый администратором источник на машине их предоставляет.

Поведение выборки и кэширования

Claude Code выбирает параметры с серверов Anthropic при запуске и опрашивает обновления каждый час во время активных сеансов.

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

Первый запуск без кэшированных параметров:

• Когда разработчик входит при запуске, например при первом запуске или после /logout, Claude Code ждет до пяти секунд выборки перед открытием сеанса. Когда политика прибывает вовремя, Claude Code применяет ее с первого экрана и показывает ваши companyAnnouncements на нем. Когда полезная нагрузка требует одобрения безопасности, Claude Code завершает ожидание и применяет полезную нагрузку после одобрения разработчиком
• При любом другом запуске и когда истекает пятисекундное ожидание, Claude Code открывает сеанс, пока выборка продолжается, поэтому краткое окно проходит перед загрузкой параметров и вступлением в силу ограничений
• Если выборка не удается, Claude Code продолжает без параметров, управляемых сервером, и предупреждает в интерактивных сеансах, что удаленная политика не применяется; параметры, управляемые конечной точкой, все еще применяются. Если управляемый источник устанавливает forceRemoteSettingsRefresh, Claude Code вместо этого выходит

Последующие запуски с кэшированными параметрами:

• Кэшированные параметры применяются немедленно при запуске, за исключением кэшированных значений modelPricing и managedMcpServers и переменных окружения, которые Claude Code удерживает до подтверждения полезной нагрузки сервером
• Кэшированный modelPricing не применяется до тех пор, пока выборка сеанса не подтвердит полезную нагрузку. До этого цифры затрат, которые разработчики видят в /usage и в строке состояния, находятся по цене списка
• Кэшированный блок managedMcpServers не применяется до тех пор, пока выборка сеанса не подтвердит полезную нагрузку. Claude Code ждет до 30 секунд для этой выборки перед подключением серверов MCP. Если выборка не удается или истекает время ожидания, сеанс начинается без серверов организации, /status это указывает, и они подключаются после подтверждения более поздней выборкой. См. Когда предоставленные серверы подключаются для полного поведения, включая первый запуск. Требуется Claude Code v2.1.259 или более поздняя версия
• Claude Code выбирает свежие параметры в фоновом режиме
• Кэшированные параметры сохраняются при сбоях сети. Если выборка при запуске не удается, Claude Code предупреждает в интерактивных сеансах, что кэшированная политика действует
• До тех пор, пока выборка не будет успешной, удерживаемые значения остаются удерживаемыми

Claude Code удерживает несколько категорий переменных в кэшированном блоке env до тех пор, пока сервер не подтвердит полезную нагрузку для сеанса. Это предотвращает перенаправление, перехват или повторную аутентификацию кэшированного прокси, центра сертификации, конечной точки или значения учетных данных при выборке параметров, которая подтверждает полезную нагрузку. Усиление применяется только к кэшу параметров, полученных с сервера: параметры, управляемые конечной точкой, развернутые через MDM или managed-settings.json, не затронуты. Удерживание требует Claude Code v2.1.198 или более поздней версии; до v2.1.198 весь кэшированный блок env применяется при запуске. Удерживаемые категории включают:

• Конфигурация прокси и TLS, такая как HTTPS_PROXY, NODE_EXTRA_CA_CERTS и переменные сертификата клиента mTLS CLAUDE_CODE_CLIENT_CERT и CLAUDE_CODE_CLIENT_KEY
• Маршрутизация API и выбор поставщика, включая ANTHROPIC_BASE_URL, переменные выбора поставщика, такие как CLAUDE_CODE_USE_BEDROCK и CLAUDE_CODE_USE_VERTEX, и URL-адреса конечных точек поставщика, такие как ANTHROPIC_BEDROCK_BASE_URL
• Учетные данные аутентификации, такие как ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN и CLAUDE_CODE_OAUTH_TOKEN
• Селектор каталога конфигурации CLAUDE_CONFIG_DIR
• Селекторы источника учетных данных и каталога конфигурации в 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

Claude Code читает переменные Workload Identity Federation и селекторы ANTHROPIC_PROFILE и ANTHROPIC_CONFIG_DIR только при запуске, поэтому значение, доставленное сервером для них, не переключает источник учетных данных сеанса даже после успешной выборки. Для доставки этих селекторов на Claude Code v2.1.223 или более поздней версии используйте параметры, управляемые конечной точкой, такие как MDM или managed-settings.json. Для CLAUDE_CONFIG_DIR и переменных каталога операционной системы само удерживание является защитой: кэшированное значение остается вне окружения до тех пор, пока сервер не подтвердит полезную нагрузку.

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

Если вашей организации требуется прокси для доступа к api.anthropic.com, удерживание влияет только на сам блок env, доставленный сервером: прокси, установленный в управляемом конечной точкой блоке env через MDM или managed-settings.json, в окружении оболочки или в параметрах пользователя, достигает выборки параметров. Источник, управляемый конечной точкой, требует Claude Code v2.1.223 или более поздней версии: кэшированное значение прокси, управляемое сервером, удерживается до тех пор, пока выборка не подтвердит его, поэтому значение, управляемое конечной точкой, заполняется для каждого ключа и достигает самой выборки. До v2.1.223 используйте окружение оболочки или параметры пользователя, чтобы прокси применялся вместе с кэшированной полезной нагрузкой, управляемой сервером. Первый запуск не имеет кэша, поэтому источник, управляемый конечной точкой, окружение оболочки или параметры пользователя все еще требуются для начальной выборки.

Claude Code применяет большинство обновлений параметров к работающим сеансам без перезагрузки. Некоторые обновления применяются только при следующем запуске, включая конфигурацию экспортера OpenTelemetry, ключ model и удаление переменной из блока env.

Недопустимые записи в доставленных параметрах

Когда часть полезной нагрузки не проходит проверку схемы, Claude Code выводит ошибку валидации и применяет каждый оставшийся допустимый параметр; Недопустимые записи в управляемых параметрах указывает, что оно удаляет и какие ключи возвращаются к более строгому значению. Требуется Claude Code v2.1.169 или более поздняя версия.

Доставка, управляемая сервером, добавляет следующие поведения:

• Кэш в ~/.claude/remote-settings.json сохраняет спасенную полезную нагрузку с удаленными недопустимыми записями, за исключением недопустимых значений cleanupPeriodDays и desktopSessionCleanupPeriodDays, которые остаются в кэшированной копии и никогда не применяются.
• Когда ни одно поле в полезной нагрузке не может быть спасено и полезная нагрузка не содержит только эти ключи удержания, Claude Code отклоняет полезную нагрузку, сохраняет последние принятые кэшированные параметры и записывает Remote settings: Settings validation failed - no fields could be salvaged в журнал отладки. С установленным forceRemoteSettingsRefresh CLI вместо этого выходит.
• Диалог одобрения безопасности оценивает спасенную полезную нагрузку, поэтому удаленная недопустимая запись никогда не представляется для одобрения и никогда не выполняется.

Для отладки проблем доставки запустите claude --debug-file <path> и найдите в журнале Remote settings. Проверьте изменение полезной нагрузки с помощью claude doctor на тестовой машине перед развертыванием в организации.

Принудительное закрытие при запуске

По умолчанию, если выборка удаленных параметров не удается при запуске, CLI продолжает работу с параметрами, кэшированными из последней успешной выборки, за исключением значений, которые Claude Code удерживает до успешной выборки. На машине, которая никогда их не выбирала, CLI продолжает работу без параметров, управляемых сервером, и все еще применяет любые параметры, управляемые конечной точкой на устройстве.

Чтобы остановить клиентов от запуска на кэшированных или отсутствующих параметрах, управляемых сервером, установите forceRemoteSettingsRefresh: true в ваших управляемых параметрах.

Клиенты, вошедшие через шлюз приложений Claude, ждут выборки при запуске независимо от того, установлен ли этот параметр, и обрабатывают неудачную выборку следующим образом:

• Если шлюз отвечает на посещаемый интерактивный запуск с 401 и этот параметр отключен, шлюз завершил этот вход. Claude Code выводит Cloud gateway session expired — run /login to reconnect. и открывает сеанс, вышедший из шлюза, до тех пор, пока пользователь не запустит /login.
• Когда выборка не удается каким-либо другим способом, или в любом другом типе запуска, кроме подкоманды claude auth, клиент выходит с ошибкой.

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

Чтобы включить это, добавьте ключ в конфигурацию управляемых параметров:

{
  "forceRemoteSettingsRefresh": true
}

Вы также можете установить этот ключ в управляемый конечной точкой профиль MDM или системный файл managed-settings.json для принудительного применения поведения fail-closed при первом запуске, до того как будет доставлена какая-либо полезная нагрузка сервера. В Claude Code v2.1.191 или более поздней версии этот флаг является исключением из правила приоритета выше: Claude Code соблюдает его, когда любой управляемый администратором источник его устанавливает, даже если также присутствует кэшированная полезная нагрузка, управляемая сервером, поэтому значение, доставленное MDM, не игнорируется, когда существуют параметры, управляемые сервером.

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

Выборка параметров также отправляет заголовок Cache-Control: no-cache, чтобы промежуточные HTTP-прокси не обслуживали устаревший ответ.

Перед включением этого параметра убедитесь, что ваши сетевые политики позволяют подключение к api.anthropic.com. Если эта конечная точка недоступна, CLI выходит при запуске и пользователи не могут запустить Claude Code.

Подкоманды claude auth, такие как claude auth login, освобождены от этой проверки и от выхода при запуске шлюза, поэтому пользователи могут повторно пройти аутентификацию, когда истекшие учетные данные являются причиной сбоя выборки параметров.

Диалоги одобрения безопасности

Определенные параметры, которые могут представлять риск безопасности, требуют явного одобрения пользователя перед применением Claude Code в интерактивном сеансе:

• Параметры команд оболочки: параметры, которые выполняют команды оболочки, такие как apiKeyHelper, statusLine и otelHeadersHelper
• Параметры двоичных файлов песочницы: sandbox.bwrapPath, sandbox.socatPath и sandbox.ripgrep. Каждый из этих параметров указывает на исполняемый файл, и Claude Code запускает этот исполняемый файл
• Параметры сети и изоляции песочницы: параметры песочницы, которые позволяют прокси песочницы читать, перенаправлять или аутентифицировать трафик, или которые ослабляют изоляцию песочницы: 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 применял эти параметры без одобрения
• Пользовательские переменные окружения: доставленные переменные env, требующие одобрения пользователя, такие как переменные прокси и базового URL; см. Переменные окружения и диалог одобрения
• Конфигурации hooks: любое определение hooks

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

Управляемый CLAUDE.md, доставленный через ключ claudeMd, не требует одобрения, потому что это текст инструкций для Claude, а не команда, которую запускает Claude Code. Claude Code все еще проверяет разрешения для инструментов, которые Claude использует при следовании этим инструкциям. До v2.1.260 значение claudeMd требовало одобрения.

Память одобрения

Claude Code записывает ваше одобрение в каталог конфигурации, ~/.claude, если вы не установили CLAUDE_CONFIG_DIR. То, что оно записывает, зависит от учетных данных, которые использует выборка параметров:

• Вход claude.ai, сохраненный /login или claude auth login, или вход в консоль без ключа: одно одобрение на организацию, удерживаемое учетной записью, которая одобрила последней.

• Вход через шлюз приложений Claude: одно одобрение на шлюз.

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

  Claude Code не сохраняет одобрение для шлюза разработки обратной связи, доступного по простому HTTP, поэтому диалог появляется снова после каждого входа.

• Любые другие учетные данные, такие как ключ API или CLAUDE_CODE_OAUTH_TOKEN: одно одобрение для доставленных параметров, сохраняемое с кэшированной копией параметров в этом каталоге конфигурации. Claude Code показывает диалог снова, когда параметры, требующие одобрения, изменяются, и после запуска /logout или claude auth logout, любой из которых удаляет кэшированную копию.

Одобрение для sandbox.credentials или sandbox.network.tlsTerminate также охватывает записи sandbox.network.allowedDomains в этих же доставленных параметрах, потому что оба параметра действуют на этот список разрешений. Диалог появляется снова, когда ваш администратор добавляет или удаляет одну из этих записей, даже хотя sandbox.network.allowedDomains не требует одобрения сам по себе.

С сохраненным входом claude.ai:

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

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

• Интерактивный сеанс, который не может показать диалог: Claude Code не применяет доставленные параметры и сохраняет последние одобренные параметры. Диалог появляется в следующем сеансе, который может его показать. Требуется Claude Code v2.1.211 или более поздняя версия.
• claude install или claude update: Claude Code не показывает диалог во время любой команды. Команда запускается с последними одобренными параметрами, и диалог появляется в вашем следующем интерактивном сеансе. Если Claude Code ждет выборки параметров при запуске, такой как с установленным forceRemoteSettingsRefresh или при развертывании шлюза приложений Claude, он показывает диалог во время команды вместо этого, и запуск установки из трубы не удается; см. Raw mode is not supported during install. До v2.1.246 Claude Code пытался показать диалог во время этих команд тоже.
• Ошибка закрывает диалог перед ответом: Claude Code не применяет доставленные параметры и сохраняет последние одобренные параметры. Он показывает диалог снова в следующем сеансе, который может его показать.
• Неинтерактивный запуск, такой как claude -p или сеанс Agent SDK: Claude Code не может показать диалог, поэтому когда доставленные параметры требуют одобрения, он применяет их только для этого запуска. Он не записывает их как одобренные и не записывает их в локальный кэш, и следующий интерактивный сеанс показывает диалог. До тех пор, пока пользователь не одобрит в интерактивном сеансе, каждый неинтерактивный запуск выбирает параметры снова при запуске. До v2.1.207 неинтерактивный запуск сохранял параметры как одобренные, поэтому более поздние интерактивные сеансы никогда не показывали для них диалог.

Переменные окружения и диалог одобрения

Claude Code применяет некоторые доставленные переменные env без показа пользователю диалога одобрения, включая:

• Переключатели функций и команд
• Выбор модели и параметры поведения, такие как ANTHROPIC_MODEL, DISABLE_PROMPT_CACHING и CLAUDE_CODE_EFFORT_LEVEL
• Параметры окна контекста и компактности, такие как DISABLE_AUTO_COMPACT
• Параметры пользовательского интерфейса терминала и доступности
• Числовые ограничения, бюджеты и тайм-ауты

Другие доставленные переменные могут требовать одобрения пользователя перед вступлением в силу; непустое значение прокси, базового URL или OTEL_EXPORTER_OTLP_ENDPOINT всегда требует. Когда доставленная переменная требует одобрения, диалог называет ее, поэтому пользователь видит ровно то, что политика просит установить. До v2.1.218 Claude Code применял меньше переменных без запроса пользователя, поэтому параметры, такие как DISABLE_AUTO_COMPACT, вызывали диалог при любом непустом значении.

Claude Code решает, требуют ли четыре переключателя конфиденциальности одобрения по доставленному значению, а не по имени переменной: CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_ERROR_REPORTING, DISABLE_TELEMETRY и DO_NOT_TRACK. Истинное значение, такое как 1 или true, только отключает отслеживание, отчеты об ошибках или другой ненужный трафик, поэтому Claude Code применяет его без запроса пользователя. Для любого другого непустого значения Claude Code показывает диалог. До v2.1.218 все они, кроме DO_NOT_TRACK, применялись без одобрения при любом значении, и DO_NOT_TRACK вызывал диалог при любом непустом значении.

Claude Code также решает, требует ли API_FORCE_IDLE_TIMEOUT одобрения по доставленному значению: истинное значение только включает тайм-аут простоя тела, поэтому Claude Code применяет его без запроса пользователя. Для любого другого непустого значения Claude Code показывает диалог. До v2.1.248 любое непустое значение вызывало диалог.

Требует ли ANTHROPIC_CUSTOM_HEADERS одобрения, также зависит от доставленного значения. Заголовки, которые только помечают запросы, такие как 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 применялось без него.

Ложное значение, такое как 0 или false, для ENABLE_BETA_TRACING_DETAILED или OTEL_LOG_RAW_API_BODIES, применяется без диалога, потому что оно только отключает детальную трассировку или захват тела сырого API. Любое другое непустое значение для любой переменной требует одобрения.

Доступность платформы

Параметры, управляемые сервером, требуют прямого подключения к api.anthropic.com. Доставка также требует, чтобы сеанс аутентифицировался с помощью одного из этих учетных данных:

• Вход в организацию Team или Enterprise через OAuth
• Токен OAuth, предоставленный через CLAUDE_CODE_OAUTH_TOKEN
• Напрямую настроенный ключ API
• Профиль user_oauth Anthropic, если только профиль не устанавливает base_url, отличный от Anthropic API. Требуется Claude Code v2.1.257 или позже.

Ни ключи, возвращаемые скриптом apiKeyHelper, ни учетные данные Workload Identity Federation не запускают выборку параметров.

В сеансе Cowork в приложении Claude Desktop Claude Code не получает параметры, управляемые сервером, из консоли администратора claude.ai, даже если пользователь входит с учетной записью Team или Enterprise. Где и когда применяется политика охватывает, какая политика достигает сеансов Cowork на машине пользователя и удаленных сеансов Cowork.

Если вы экспортируете переменную поставщика CLAUDE_CODE_USE_* или нестандартный ANTHROPIC_BASE_URL в вашей оболочке, Claude Code пропускает выборку параметров для ваших сеансов. claude doctor и /status сообщают о пропущенной выборке и ее причине.

Вы не можете очистить экспорт с помощью управляемого сервером блока env, потому что блок поступает через выборку, которую экспорт предотвращает. Блок параметров env, управляемый конечной точкой](/ru/managed-settings#delivery-mechanisms), также не восстанавливает выборку: Claude Code проверяет приемлемость перед применением управляемых блоков env, поэтому значение, управляемое конечной точкой, изменяет выбор поставщика сеанса, но выборка остается пропущенной.

Чтобы восстановить доставку, управляемую сервером, удалите экспорт из вашей оболочки или установите переменную на "" в блоке env пользовательских параметров, который применяется перед проверкой приемлемости. Чтобы обеспечить политику без полагания на пользователей для изменения их оболочек, доставляйте параметры через управляемый конечной точкой канал вместо этого.

Для развертываний Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Claude Platform on AWS, самостоятельно размещаемый Claude apps gateway обеспечивает эквивалентную доставку удаленных управляемых параметров: клиенты, вошедшие в шлюз, получают управляемые параметры из шлюза вместо api.anthropic.com. Семантика отказов отличается при запуске: клиент шлюза, который не может достичь шлюз, завершает работу с ошибкой вместо возврата к кэшированным параметрам, в то время как почасовое фоновое обновление открыто при отказе на обоих каналах.

Аудит логирования

События журнала аудита для изменений параметров доступны через API соответствия или экспорт журнала аудита. Свяжитесь с вашей командой учета Anthropic для получения доступа.

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

Соображения безопасности

Параметры, управляемые сервером, обеспечивают централизованное применение политики, но они работают как элемент управления на стороне клиента, а не как граница безопасности. На неуправляемых устройствах пользователю не требуется доступ администратора или sudo для их обхода.

Для логирования изменений локальных файлов параметров, включая managed-settings.json, используйте ConfigChange hooks. Claude Code не запускает их при поступлении параметров, управляемых сервером, или при их обновлении, или при изменении профиля MDM или политики реестра, и hook не может заблокировать изменение policy_settings.

Для ограничения организаций, к которым ваши пользователи могут получить доступ с учетными данными, которые предоставляет клиент, см. Enforce network-level access control with Tenant Restrictions в Центре справки Claude. Для более сильных гарантий применения используйте параметры, управляемые конечной точкой на устройствах, зарегистрированных в решении MDM.

См. также

Связанные страницы для управления конфигурацией Claude Code:

• Все параметры: каждый ключ параметров
• Управляемые параметры Endpoint: управляемые параметры, развертываемые на устройства IT
• Аутентификация: настройка доступа пользователей к Claude Code
• Безопасность: гарантии безопасности и лучшие практики