# --settings Flag

> It loads extra settings for one session from JSON.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude --settings, Inline settings

## Think of it like

It is like a note for just today. It says, wear the red shirt.

## Definition

--settings loads extra settings for this session, from a JSON file or a JSON string. Its values win over the same keys in your settings.json files. Keys it leaves out keep their usual values. Your admin's managed settings still win over it. The file must be a normal file of 2 MiB or less.

## Example

Emma's CI keeps one settings file with its own permission rules. Each job starts claude with --settings pointing at it, and no one's own files change.

## Example code

```bash
claude --settings ./ci-settings.json
```

Use the CI settings for this run only.

## Why it matters

A run can get its own settings, and no one has to edit the shared files.

## Common mistake

Expecting it to beat managed settings. Your admin's rules still come first.

## Three principles

- **File or string.** JSON.
- **Wins over your files.** For these keys.
- **Managed still wins.** Over it.

## Related terms

- [--setting-sources Flag](https://learn.benibix.com/term/ai/setting-sources-flag)
- [/config Command](https://learn.benibix.com/term/ai/config-command)
- [Permission Rule](https://learn.benibix.com/term/ai/permission-rule)

## Told apart from

- [--settings vs --setting-sources](https://learn.benibix.com/compare/settings-flag-vs-setting-sources-flag): People think --settings and --setting-sources do one job, and they do not. --settings adds one more layer of settings from a file or a string, and its values win over your files. --setting-sources picks which of your own files load at all: user, project or local. A CI run often uses both.

## Taught in

- [Tool and Settings Flags](https://learn.benibix.com/learn/ai-claude-code-commands/tool-and-settings-flags): Claude Code Commands, 15/17

![Settings in layers: managed on top, then --settings, then local, project and user.](https://learn.benibix.com/diagrams/flag-settings-layers.svg)

---

Source: https://learn.benibix.com/term/ai/settings-flag
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.
