# Managed Settings File

> A file of settings that a company puts on each machine. It beats yours.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** managed-settings.json, managed settings

## Think of it like

It is like the school's own rules. A class cannot change them.

## Definition

The managed settings file is managed-settings.json. A company puts it in a system folder on each machine. It is at the top of the order. So your own files and flags cannot win over it, apart from a few safety keys. It is one of a few ways a company can send its settings.

## Example

Emma's company blocks web fetches on every laptop. IT puts a managed settings file in place, and no one can turn the block off.

## Example code

```json
{
  "permissions": {
    "deny": ["WebFetch"]
  },
  "allowManagedPermissionRulesOnly": true
}
```

On Linux the file goes in /etc/claude-code. This one blocks web fetches.

## Why it matters

It is how a company makes a rule that holds on each machine.

## Common mistake

Trying to undo it with your own settings. A managed key wins over every file and flag you control.

## Three principles

- **Set by the org.** A system folder.
- **Top of the order.** Cannot override.
- **One of several ways.** Also MDM, server.

## Related terms

- [Claude Code Settings Precedence](https://learn.benibix.com/term/ai/settings-precedence)
- [User Settings File](https://learn.benibix.com/term/ai/user-settings-file)
- [Claude Code Settings File](https://learn.benibix.com/term/ai/claude-code-settings-file)

---

Source: https://learn.benibix.com/term/ai/managed-settings-file
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
