{"name":"policyHelper","slug":"policyhelper","family":"setting","title":"Settings keys","noun":"settings key","description":"Run an executable that computes [managed settings](\/docs\/en\/managed-settings.md#compute-the-policy-with-a-helper-program) at startup","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.138","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.309","builds":126,"mined_builds":150,"first_cited":{"version":"2.1.228","released_at":"2026-08-11 17:45:45","spans":16}},"aliases":[],"entries":[{"version":"2.1.296","anchor":"gateway-login-method-now-counts-as-gateway-required","heading":"Setting forceLoginMethod to gateway now leads to the gateway login","line":"With forceLoginMethod set to \"gateway\" and no forceLoginGatewayUrl, Claude Code now treats gateway login as required","released_at":"2026-10-09 16:58:10","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"machine-plugin-key-load-records-policy","heading":"New check on plugin settings loaded from machine-level files","line":"Claude Code now checks plugin-related settings that come from settings files users cannot write to","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"new-policy-helper-predicate-requires-a-verified-gateway-host","heading":"New policy-helper predicate requires a verified gateway host (hostVerdict)","line":"A new check passes only when the gateway host has been verified and a policy helper is configured","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"policyhelper-refresh-now-reports-retry-attempt-counts-on-fai","heading":"policyHelper refresh now reports retry attempt counts on failure","line":"Telemetry for a failed background policyHelper refresh now includes how many attempts were made","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"new-retryable-policy-helper-execution-engine-with-backoff-a","heading":"New retryable policy-helper execution engine with backoff, added under 'settings_policy_helpers_per_os'","line":"Claude Code adds a retryable engine for organization-managed 'policyHelper' settings scripts, with backoff on transient failures","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text, named in this entry"},{"version":"2.1.265","anchor":"policyhelpers-per-source-shadowing-warning-gated-behind-man","heading":"policyHelpers per-source shadowing warning gated behind managedSourcesBehavior: \"merge\"","line":"Claude Code now warns when multiple managed settings sources define conflicting policy helper config under merge mode","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"policyhelpers-per-entry-onfailure-and-retries-settings-now-v","heading":"policyHelpers per-entry onFailure and retries settings now validated for effect","line":"Claude Code now flags policy helpers that require success but have no fallback settings","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"policyhelper-singular-field-now-also-warns-for-ignored-onfai","heading":"policyHelper singular field now also warns for ignored onFailure\/retries","line":"Claude Code now warns if onFailure or retries is set on the singular policyHelper entry, since those are ignored there","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text, named in this entry"},{"version":"2.1.265","anchor":"policyhelpers-onfailureretries-per-os-validation-messag","heading":"policyHelpers onFailure \/ retries per-OS validation messages added","line":"Claude Code now warns when `onFailure` or `retries` are set on the wrong `policyHelper` key, and can refuse to start if an OS-admin helper fails","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"},{"version":"2.1.265","anchor":"policyhelpers-now-honored-from-remote-managed-settings-too","heading":"policyHelpers now honored from remote managed settings too","line":"policyHelpers can now be delivered via remote managed settings, not just admin-controlled policy sources","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text"}],"entries_total":26,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":true},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"claude-apps-gateway","title":"Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry","documented":false},{"source":"claude-code","path":"claude-apps-gateway-config","title":"Claude apps gateway configuration","documented":false},{"source":"claude-code","path":"managed-settings","title":"Deploy managed settings","documented":false},{"source":"claude-code","path":"monitoring-usage","title":"Monitoring","documented":false},{"source":"claude-code","path":"server-managed-settings","title":"Configure server-managed settings","documented":false}],"docs_total":8,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/policyhelper","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}