Managed settings are the admin tier of agent configuration: they sit above user and project files and cannot be overridden locally. Use them to lock permission rules, require managed hooks, restrict MCP servers and plugin marketplaces, pin a minimum client version and force telemetry on. Verify on a device that the policy actually applied.
Read in this order
- OfficialDeploy managed settings (Claude Code docs)Start here: delivery options and which keys users cannot override.
- OfficialExample settings files (Claude Code docs)Sample settings files you can copy as a starting policy.
- OfficialManaged configuration (OpenAI Codex docs)Codex's equivalent, to map one policy to two formats.