Развертывание управляемых параметров

​

Развертывание файла управляемых параметров

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

​

Выберите механизм доставки

• Элементы управления доставкой: policyHelper, wslInheritsWindowsSettings и managedSourcesBehavior
• Ключи входа шлюза: forceLoginGatewayUrl и значение "gateway" forceLoginMethod

​

Где и когда политика применяется

• Поверхности: на машине разработчика, в терминале, расширениях VS Code и JetBrains, вкладке Code настольного приложения и сеансах Agent SDK читают все эти источники. Сеансы Agent SDK загружают управляемые параметры даже когда settingSources исключает файлы пользователя, проекта и локального.
• Облачные сеансы: сеанс в среде, размещенной Anthropic, не читает профиль MDM устройства или файл, поэтому политика для него должна поступать из управляемых параметров сервера. Сеанс в самостоятельно размещенной среде также читает файл управляемых параметров в образе своего runner, по умолчанию только когда управляемые параметры сервера не доставляют ключ политики, кроме ключей, которые Claude Code читает из каждого источника администратора. Как Claude Code объединяет управляемые источники охватывает согласие, которое применяет оба.
• Сеансы Cowork: Cowork в приложении Claude Desktop запускает свои сеансы на Claude Code. В сеансе Cowork Claude Code никогда не получает управляемые параметры сервера из консоли администратора claude.ai, даже когда пользователь входит с учетной записью Team или Enterprise, поэтому то, какая политика применяется, зависит от того, где запускается сеанс:
  • На машине пользователя: по умолчанию Claude Code в сеансе Cowork читает политику MDM или уровня ОС и файл управляемых параметров на этом устройстве, поэтому развертывайте политику там.
  • В полной песочнице VM: когда ваша управляемая конфигурация Claude Desktop устанавливает requireCoworkFullVmSandbox, Claude Code работает внутри виртуальной машины, где политика MDM устройства и файл управляемых параметров отсутствуют.
  • Удаленные сеансы Cowork: они работают на управляемых Anthropic виртуальных машинах, где Claude Code не может читать политику устройства.
  Таблица покрытие поверхности сравнивает Cowork с другими поверхностями.
• Запущенные сеансы: большинство изменений достигают запущенного сеанса по расписанию в таблице механизма доставки, без перезагрузки.
  • Изменения forceRemoteSettingsRefresh, requiredMinimumVersion и некоторых редактируемых пользователем ключей вступают в силу при следующем запуске сеанса.
  • Новая или измененная запись policyHelper вступает в силу при следующем запуске, кроме того, что помощник, затененный при запуске управляемыми параметрами сервера, запускается как только выборка сообщает об удалении этих параметров.
• Изменения, требующие одобрения: кроме обновлений, которые ждут следующего запуска, изменение управляемого сервером параметра, который требует одобрения, такого как hook или переменная env, ждет, пока разработчик примет диалог в интерактивном сеансе, и применяется для текущего запуска в сеансе, который размещает расширение IDE или Agent SDK. Другие изменения управляемого сервером применяются при следующем опросе.
• Долгоживущие сеансы: сеанс, оставленный открытым на недели, все еще может отставать от развертывания. requiredMinimumVersion блокирует запуск устаревшего двоичного файла и не завершает сеанс, который уже работает.

​

Где каждый механизм хранит политику

• Управляемые сервером: серверы Anthropic или ваш шлюз содержат политику. Claude Code хранит локальный кэш, который применяет при запуске и заменяет при каждой успешной выборке.
• Профиль конфигурации macOS: домен управляемых предпочтений com.anthropic.claudecode. Используйте те же ключи верхнего уровня, что и managed-settings.json, с вложенными параметрами как словари и списки как массивы plist.
• Реестр Windows HKLM: JSON как значение REG_SZ или REG_EXPAND_SZ с именем Settings под HKLM\SOFTWARE\Policies\ClaudeCode.
• На основе файла: managed-settings.json, необязательный каталог managed-settings.d/ и managed-mcp.json в системном каталоге: /Library/Application Support/ClaudeCode/ на macOS, /etc/claude-code/ на Linux и WSL и C:\Program Files\ClaudeCode\ на Windows. Claude Code не читает устаревший путь Windows C:\ProgramData\ClaudeCode\managed-settings.json.
• Реестр Windows HKCU: то же значение Settings под HKCU\SOFTWARE\Policies\ClaudeCode.

​

Разделите политику на основе файла между командами

• Одиночные значения, такие как "model": "opus" или "cleanupPeriodDays": 7: значение более позднего файла заменяет более раннее
• Списки, такие как permissions.deny или sandbox.network.allowedDomains: два списка объединяются, с удаленными дубликатами
• Вложенные блоки, такие как env или sandbox: два блока объединяются ключ за ключом, и каждый ключ внутри следует этим же правилам
• fallbackModel: более поздняя цепь заменяет более раннюю целиком
• extraKnownMarketplaces и managedMcpServers: более поздняя запись с тем же именем заменяет более раннюю целиком
• modelPicker: более поздний набор заменяет более ранний целиком

​

Как Claude Code объединяет управляемые источники

• "first-wins", по умолчанию: Claude Code использует источник с наивысшим рейтингом, который доставляет по крайней мере один ключ политики, и игнорирует остальные, а не объединяет их, кроме нескольких ключей в Ключи, читаемые из каждого источника администратора. Claude Code не показывает предупреждение для источников, которые он пропускает; /status называет источник, который он использовал, и те, которые он пропустил.
• "merge": Claude Code применяет каждый источник администратора, который доставляет ключ политики, и объединяет их по типу ключа: на большинстве ключей значение источника с более высоким рейтингом применяется, списки объединяются, и блокировки принимают самое строгое значение. Составьте каждый управляемый источник говорит, где установить ключ и как каждый тип ключа объединяется. Требует Claude Code v2.1.242 или позже.

• Ключ политики: любой ключ параметров, кроме двух ключей управления, wslInheritsWindowsSettings и managedSourcesBehavior. Файл управляемых параметров или политика MDM, которые содержат только эти, не учитываются, и Claude Code переходит к следующему источнику.
• Источник администратора: один из первых трех источников ниже. Реестр HKCU доступен для записи пользователем и не является одним из них.

1. Удаленные параметры, доставленные из claude.ai как управляемые параметры сервера или шлюзом Claude apps. Claude Code получает этот источник только когда сеанс аутентифицируется в API Anthropic напрямую с подходящим входом или ключом, или входит в шлюз с /login. На других поставщиках или когда ANTHROPIC_BASE_URL указывает на что-то другое, чем API Anthropic, он начинает со следующего источника
2. Политики MDM или уровня ОС: plist macOS или ключ реестра HKLM
3. Файлы управляемых параметров, managed-settings.d/*.json и managed-settings.json объединены вместе
4. Реестр HKCU, на Windows и на WSL, как только реестр HKLM или файл управляемых параметров Windows включает wslInheritsWindowsSettings и значение HKCU также его устанавливает. Claude Code читает его только когда никакой источник выше него не доставляет ключ политики и никакие параметры родителя, предоставленные хостом, не предоставляют ограничивающий ключ

​

Ключи, читаемые из каждого источника администратора

• sandbox.network.allowManagedDomainsOnly и sandbox.filesystem.allowManagedReadPathsOnly: true в любом источнике администратора включает блокировку. Пока блокировка включена, Claude Code объединяет список разрешений, который она блокирует, sandbox.network.allowedDomains вместе с правилами разрешения WebFetch(domain:...), или sandbox.filesystem.allowRead, по всем источникам администратора. Без блокировки Claude Code обрабатывает список разрешений как любой другой ключ, поэтому при "first-wins" список разрешений невыбранного источника администратора игнорируется
• allowAllClaudeAiMcps
• Пути двоичных файлов песочницы sandbox.bwrapPath и sandbox.socatPath
• Двоичный файл ripgrep песочницы, sandbox.ripgrep
• sandbox.filesystem.disabled и sandbox.network.strictAllowlist
• useAutoModeDuringPlan и syncClaudeAiSkills, где false из любого источника администратора отключает поведение. false в параметрах пользователя или локальных параметрах разработчика также отключает его; каждый ключ может только отрицать
• enableArtifact, где false из любого источника администратора отключает инструмент Artifact. false в параметрах пользователя, проекта или локальных параметрах разработчика также отключает его, и никакой источник не включает его обратно; см. какие значения более низкого уровня все еще учитываются. Требует Claude Code v2.1.242 или позже
• maxEffortLevel, где применяется самый низкий предел в любом источнике администратора. Если разработчик устанавливает более низкий предел в своих собственных параметрах или с --settings, Claude Code применяет этот; никакой источник не может повысить предел. Требует Claude Code v2.1.267 или позже
• Отказ от трейлера коммита в attribution или в устаревшем includeCoAuthoredBy из любого уровня
• forceRemoteSettingsRefresh
• env, объединенный по переменной по источникам администратора: каждая переменная поступает из источника с наивысшим приоритетом, который ее определяет, поэтому более низкие источники заполняют переменные, которые более высокие оставляют неустановленными. Несколько переменных следуют своим собственным правилам; Исключения для каждого ключа по управляемым источникам называет каждое. Требует Claude Code v2.1.223 или позже. До v2.1.223 Claude Code применял весь блок env выбранного источника только

​

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

​

Вычислите политику с помощью программы-помощника

• Выданный объект managedSettings — это единственные управляемые параметры для сеанса, включая ключи, которые он иначе читает из каждого источника администратора, кроме forceRemoteSettingsRefresh, который имеет свое собственное правило запуска

​

Позвольте хосту встраивания добавить политику

• Когда любой источник администратора устанавливает allowManagedPermissionRulesOnly, Claude Code отбрасывает предоставленные родителем правила разрешения и additionalDirectories по мере их чтения, даже когда источник с более высоким приоритетом оставляет ключ неустановленным. Эффект ключа на ваши собственные правила разрешения поступает из управляемых параметров, которые применяет Claude Code, или из параметров родителя, которые вы выбрали для объединения
• Claude Code применяет значение forceLoginOrgUUID или allowedMcpServers в управляемых параметрах, которые он применяет, и блокирует предоставленное родителем. Значение в более низком источнике администратора, который Claude Code не применяет, ни применяется, ни блокирует родительское. Запись managedSourcesBehavior говорит, какой источник предоставляет каждый ключ при "merge". До v2.1.223 значение в любом источнике администратора блокировало родительское
• Значение availableModels следует тому же правилу, что и allowedMcpServers

​

Сохраните доступ к папке Cowork, когда применяются только управляемые правила

{
  "allowManagedPermissionRulesOnly": true,
  "permissions": {
    "allow": [
      "Edit(~/CoworkProjects/**)"
    ]
  }
}

​

Что может изменить разработчик

• Модель для сеанса: управляемая model — это значение по умолчанию, а не блокировка. --model и ANTHROPIC_MODEL все еще выбирают модель для этого сеанса, поэтому разверните availableModels для ограничения выбора.
• Локальные права администратора: разработчик, который является администратором на машине, может редактировать сам управляемый источник, поэтому инструменты MDM могут повторно развертывать профиль или файл по расписанию и почему существуют реестр HKLM и домен управляемых предпочтений macOS.
• Кэш управляемых параметров сервера: управляемые параметры сервера поступают с серверов Anthropic, и редактирование локального кэша длится только до следующей успешной выборки.
• Другие инструменты: управляемые параметры связывают только Claude Code. Разработчик, который вызывает API из другого инструмента, не находится под ними.

​

Проверьте, что политика действует

​

Прочитайте источник в /status

• (remote): управляемые параметры сервера из claude.ai или шлюза
• (plist) или (HKLM): политика MDM или ОС
• (file), (drop-ins) или (file + drop-ins): managed-settings.json, каталог drop-in или оба
• (remote + file, merged) или другой список, заканчивающийся на , merged: ваша организация составляет каждый управляемый источник, и Claude Code объединил перечисленные источники в политику. Более низкий источник все еще может предоставлять переменные env без появления в списке. Требует Claude Code v2.1.242 или позже
• (HKCU): резервный реестр, доступный для записи пользователем
• (parent process): хост встраивания предоставил ограничивающие параметры
• (helper): policyHelper, настроенный выбранным источником MDM или файла

• Строка отсутствует: Claude Code не нашел управляемый источник, который доставляет ключ политики. Если вы развернули файл управляемых параметров, проверьте, что он находится по пути для ОС и что он содержит ключ политики, а не только ключи управления. Файл, который не является действительным JSON, не производит это состояние; Claude Code отказывается запускаться вместо этого. Когда вы развернули через управляемые параметры сервера вместо этого, запустите claude doctor, который сообщает результат выборки.
• Строка называет источник, отличный от того, который вы развернули: источник с более высоким приоритетом присутствует и Claude Code игнорировал ваш, и Skipped sources его перечисляет. Как Claude Code объединяет управляемые источники дает порядок.

​

Найдите записи, которые Claude Code отбросил

• Файл управляемых параметров или файл drop-in: файл не является действительным JSON или его верхний уровень не является объектом
• Plist MDM: plutil macOS сообщает plist неправильно сформированным или его преобразованное содержимое не является объектом JSON
• Значение реестра HKLM: значение Settings не является строкой, пусто или не содержит объект JSON

• Отсутствующий файл, профиль или значение реестра не является сбоем; Claude Code работает без этого источника.
• Пустой файл управляемых параметров считается {}.
• Неправильное значение в доступном для записи пользователем ключе реестра HKCU никогда не блокирует запуск. Claude Code сообщает об этом как уведомление в /status и claude doctor вместо этого.

• Интерактивные сеансы показывают диалог при запуске, перечисляющий неправильные записи.
• Неинтерактивные запуски с -p печатают сводку в stderr.
• claude doctor перечисляет каждую неправильную запись с ее источником и полем.

​

Ключи, которые не удаются закрыто

​

Ключи, которые может установить только управляемый источник

​

Отключите телеметрию для вашей организации

{
  "env": {
    "DISABLE_TELEMETRY": "1"
  }
}

​

Смотрите также

• Настройте Claude Code для вашей организации: решите, что применять и как
• Управляемые параметры сервера: доставляйте политику из консоли claude.ai или шлюза
• Управляемая конфигурация MCP: контролируйте, какие MCP серверы могут использовать разработчики
• Все параметры: каждый ключ, с указанием, может ли управляемый источник его установить
• Примеры файлов параметров: полный managed-settings.json, показывающий форму управляемых ключей