# policyHelper

> A program IT runs to work out the rules each time Claude Code starts.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** policyHelper setting

## Think of it like

It is like a guard who looks at each guest, then says which rooms they may use.

## Definition

policyHelper is a key for managed settings. It runs a program at start to work out the managed settings. The program can look at the laptop, the person or a web service. What it prints becomes the managed settings for that session. The key holds path, timeoutMs and refreshIntervalMs. Settings sent from the server win over it.

## Example

Emma's work trusts its locked laptops more. The helper checks each laptop and prints looser rules for those.

## Example code

```json
{
  "policyHelper": {
    "path": "/opt/acme/claude-policy",
    "timeoutMs": 5000,
    "refreshIntervalMs": 300000
  }
}
```

Run it now, and run it again each five minutes.

## Why it matters

A file stays the same for all, but a program can fit each laptop and each person.

## Common mistake

Setting it in the settings sent from the server. Claude Code skips it there, so put it in the managed file instead.

## Three principles

- **Runs at startup.** Before the first prompt.
- **Prints the settings.** For this session.
- **Can run again.** refreshIntervalMs.

## Related terms

- [Managed Settings File](https://learn.benibix.com/term/ai/managed-settings-file)
- [apiKeyHelper](https://learn.benibix.com/term/ai/api-key-helper-setting)

![How policyHelper works: at startup Claude Code runs the company's program, and the settings it prints become the managed settings for that session.](https://learn.benibix.com/diagrams/policy-helper-flow.svg)

---

Source: https://learn.benibix.com/term/ai/policy-helper-setting
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.
