[BUG] Wrong Policy File Reference for Enterprise Managed Policy Settings

Environment

• Platform (select one):
• [ ] Anthropic API
• [x] AWS Bedrock
• [ ] Google Vertex AI
• [ ] Other: <!-- specify -->
• Claude CLI version: 1.0.18
• Operating System: macOS 15.4.1
• Terminal: Ghostty

Bug Description

The official documentation at https://docs.anthropic.com/en/docs/claude-code/settings states that enterprise managed policy settings are read from /Library/Application Support/ClaudeCode/policies.json.

For enterprise deployments of Claude Code, we also support enterprise managed policy settings. These take precedence over user and project settings. System administrators can deploy policies to /Library/Application Support/ClaudeCode/policies.json on macOS and /etc/claude-code/policies.json on Linux and Windows via WSL.

However, in practice, the CLI appears to read from managed-settings.json instead.

This discrepancy may indicate either a bug in the code or an error in the documentation.

Steps to Reproduce

1. Follow the documentation to set enterprise policies by creating /Library/Application Support/ClaudeCode/policies.json
2. Launch or configure Claude CLI
3. Observe that settings in policies.json are not applied.
4. Place the same configuration in managed-settings.json .
5. Observe that the settings are now applied correctly.

Expected Behavior

The settings should be applied from policies.json as stated in the documentation.

Actual Behavior

The settings are ignored when placed in policies.json, but are applied correctly when placed in managed-settings.json.

Additional Context

This issue is being reported for awareness, as it's unclear whether the issue lies with the CLI implementation or the documentation. Clarification or correction would be helpful for users managing enterprise deployments.