31 pages for --settings.

Orchestrate teams of Claude Code sessions Claude Code CLI · in the page agent-teams …precedence settings files**: project settings, local settings, and a `--settings` payload apply after user settings, so an `env` entry that sets the variable to `1` in any of them wins. See [Settings… Manage multiple agents with agent view Claude Code CLI · in the page agent-view …gs) * the view was opened with a flag such as `--permission-mode` or `--settings` Completed sessions that don't fit on screen fold into a `… N more` row. Failures and sessions with an open pull reque… Share session output as artifacts Claude Code CLI · in the page artifacts …| Once you turn artifacts off in a [`--settings`](/docs/en/cli-reference#cli-flags) file or with `CLAUDE_CODE_DISABLE_ARTIFACT`, or your administrator turns them off i… Configure auto mode Claude Code CLI · in the page auto-mode-config …settings) | Trusted infrastructure distributed to all developers | | `--settings` flag or Agent SDK | Inline JSON | Per-invocation overrides for automation… Claude Code changelog Claude Code CLI · in the page changelog …Changed `sandbox.ripgrep` to be honored only from user, managed, and `--settings` settings; project settings can no longer override the sandbox's ripgrep binary * Removed the startup tip suggesting… Deploy Claude apps gateway on AWS Claude Code CLI · in the page claude-apps-gateway-on-aws …luster with `aws ecs update-cluster-settings --cluster claude-gateway --settings name=containerInsights,value=enabled` for per-task CPU, memory, and network. On EKS, install the Amazon CloudWatch Obse… Explore the .claude directory Claude Code CLI · in the page claude-directory …naged-settings-precedence) * CLI flags like `--permission-mode` or `--settings` override `settings.json` for that session * Some environment variables take precedence over their equivalent setting… CLI reference Claude Code CLI · in the page cli-reference …ions](/docs/en/agent-view#permission-mode-model-and-effort). Accepts `--settings`, `--add-dir`, `--plugin-dir`, and `--mcp-config` like the top-level `claude` command. Opening agent view requires an i… Commands Claude Code CLI · in the page commands …, or skills with a `skillOverrides` entry in managed settings or the `--settings` flag… Manage costs effectively Claude Code CLI · in the page costs …ude Code ignores the key in user, project, and local settings and in `--settings`. </Step> </Steps> To confirm the rates are in effect, run `/usage` in a session that has [received the managed sett… Message your other Claude Code sessions Claude Code CLI · in the page cross-session-messaging …e v2.1.232 or later and doesn't appear while managed settings or the `--settings` flag sets the key, since a user-settings value wouldn't apply then. Claude Code rejects the `/config crossSessionInbou… Error reference Claude Code CLI · in the page errors …d ### Settings file exceeds the 2MiB limit The file you passed to [`--settings`](/docs/en/cli-reference#cli-flags) is larger than 2 MiB, so `claude` exits with code 1 at startup instead of loading i… Speed up responses with fast mode Claude Code CLI · in the page fast-mode …lag, `/fast` works only in a session launched with fast mode in its [`--settings`](/docs/en/cli-reference#cli-flags) value, for example `claude -p --settings '{"fastMode": true}'`; the toggle then app… Run Claude Code programmatically Claude Code CLI · in the page headless …le](https://platform.claude.com), or supply an `apiKeyHelper` in the `--settings` JSON. Amazon Bedrock, Google Cloud's Agent Platform, and Microsoft Foundry continue to read their own provider credent… Hooks reference Claude Code CLI · in the page hooks …turn hooks off for one run whatever the project's settings say, pass `--settings '{"disableAllHooks": true}'`, which takes precedence over project and local settings. There is no way to disable an ind… Interactive mode Claude Code CLI · in the page interactive-mode …s. Claude Code reads this setting from your user settings file, the `--settings` flag, and [managed settings](/docs/en/managed-settings) only. Entries in a project's `.claude/settings.json` or `.clau… Deploy managed settings Claude Code CLI · in the page managed-settings …applies them above every other level, so no user, project, local, or `--settings` value overrides them, apart from a few [security-sensitive exceptions](/docs/en/settings#exceptions-to-managed-setting… Connect Claude Code to tools via MCP Claude Code CLI · in the page mcp …`~/.claude/settings.json` * managed settings * settings passed with `--settings` Claude Code also applies approvals from an untracked `.claude/settings.local.json`, but it runs git to check whether… How Claude remembers your project Claude Code CLI · in the page memory …s/en/settings#settings-precedence): user, project, local, policy, or `--settings`. ```json theme={null} { "autoMemoryDirectory": "~/my-custom-memory-dir" } ``` The value must be an absolute path o… Model configuration Claude Code CLI · in the page model-config …in [managed settings](/docs/en/managed-settings) or supplied through `--settings` * a `model` value in your user, project, or local settings, including a model you save with `/model` Admins can also… Configure permissions Claude Code CLI · in the page permissions …on` | `~/.claude/path` | | A file passed with `--settings <file>` | `<directory of file>/path` | | CLI flags or session rules | `<primary w… Create and distribute a plugin marketplace Claude Code CLI · in the page plugin-marketplaces …Code doesn't apply this removal to a command set in user settings, a `--settings` file, or managed settings. * **Variables Claude Code sets**: `CLAUDE_CODE_MARKETPLACE_URL` and `CLAUDE_CODE_MARKETPLAC… Recommend plugins for your org Claude Code CLI · in the page plugin-relevance …ide`](/docs/en/settings-reference#spinnertipsoverride) keys in user, `--settings`, and managed settings and those keys configure at least one tip or a `tipsFile`. The Discover-tab pin is independent… Plugins reference Claude Code CLI · in the page plugins-reference …claude/settings.json`, the file the enable-time prompt writes to * **`--settings`**: the CLI flag or SDK inline settings * **Managed settings**: [organization-controlled policy](/docs/en/permissions#m… Choose a sandbox environment Claude Code CLI · in the page sandbox-environments …configuration in `~/.srt-settings.json`, or in a file you pass with `--settings`. The package [README](https://github.com/anthropic-experimental/sandbox-runtime) documents the full configuration sche… Configure the sandboxed Bash tool Claude Code CLI · in the page sandboxing …e settings sources only: * User settings, managed settings, and the `--settings` CLI flag can set it. Project settings in `.claude/settings.json` and `.claude/settings.local.json` can't, so a checked… Customize sessions in self-hosted environments Claude Code CLI · in the page self-hosted-environments-configuration …he scripts in a separate settings file it passes to the session with `--settings`, leaving the seeded `settings.json` and your own scripts at `hooks/<name>` untouched. The runner recreates the reserve… Manage sessions Claude Code CLI · in the page sessions …ginal launch is restored. If the session depended on `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model`, or directories added with `--add-dir`, pass them again when you resume; directori… Claude Code settings Claude Code CLI · in the page settings …auto mode](/docs/en/auto-mode-config). Read from user settings, the `--settings` flag, and managed settings only. Ignored in project `.claude/settings.json` and local `.claude/settings.local.json`. B… Claude Code settings reference Claude Code CLI · in the page settings-reference …-hosted `ccpool_` ID is read only from user and managed settings and `--settings` | Remote, desktop, and notifications | Any file | | [`… Week 20 · May 11–15, 2026 Claude Code CLI · in the page whats-new/2026-w20 …de agents</code> gained dispatch flags (<code>--add-dir</code>, <code>--settings</code>, <code>--mcp-config</code>, <code>--plugin-dir</code>, <code>--permission-mode</code>, <code>--model</code>, <co…