38 pages for --settings.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
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` If you typed anything after `/resume`, retype without it. If you used one of those flags, run `claude agents` in your…
Share session output as artifacts
Claude Code CLI · in the page
artifacts
…Artifact` to `permissions.deny` | 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 | The classifier doesn't read `autoMode` fr…
Claude Code changelog
Claude Code CLI · in the page
changelog
…EADER` in a settings `env` block to apply only from user, managed or `--settings` settings (since 2.1.305) * Self-hosted runner: Changed checkout hooks to be stopped after 30 minutes by default, faili…
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
…y OS | Enterprise-enforced settings that your own settings files and `--settings` values can't override, apart from [narrow exceptions](/docs/en/settings#exceptions-to-managed-settings-precedence). Se…
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`. To confirm the rates are in effect, run `/usage` in a session that has [received the managed settings](/docs/en/mana…
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…
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…
Glossary
Claude Code CLI · in the page
glossary
…est: [managed policy](#managed-settings), settings you pass with the `--settings` flag, local settings at `.claude/settings.local.json`, project settings at `.claude/settings.json`, then user settings…
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…
Automate actions with hooks
Claude Code CLI · in the page
hooks-guide
…ssions`, or `permissions.defaultMode: "bypassPermissions"` in [user, `--settings`, or managed settings](/docs/en/settings-reference#permissions-defaultmode). It doesn't apply if bypass mode is disable…
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.md`. Claude Code reads the entry from `~/.claude/settings.json`, a `--settings` file, or [managed settings](/docs/en/managed-settings), and ignores it in project and local settings files. This examp…
Model configuration
Claude Code CLI · in the page
model-config
…y. If you set either one in user, project, or local settings or with `--settings`, Claude Code ignores it with a warning. ### Organization model restrictions Organization admins on Claude Enterprise…
Monitoring
Claude Code CLI · in the page
monitoring-usage
…such as `OTEL_LOGS_EXPORTER`, to `none`, unless managed settings, a `--settings` file, or the environment you start Claude Code from sets that variable. Claude Code doesn't pass `OTEL_*` environment…
Choose a permission mode
Claude Code CLI · in the page
permission-modes
…ssions`, or `permissions.defaultMode: "bypassPermissions"` in [user, `--settings`, or managed settings](/docs/en/settings-reference#permissions-defaultmode). The `--allow-` variant adds the permission…
Configure permissions
Claude Code CLI · in the page
permissions
…`~/.claude/settings.json` | `~/.claude/path` | | A file passed with `--settings <file>` | `<directory of file>/path` | | CLI flags or session rules | `<primary working directory>/path` | A rule you…
Host and maintain a marketplace
Claude Code CLI · in the page
plugins/host-marketplace
…ore. This removal doesn't apply 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…
Plugin loading reference
Claude Code CLI · in the page
plugins/loading
…settings.local.json` | You, in this repository only | | `flag` | The `--settings` value you pass at launch | This session only | | `managed` | [Managed settings](/docs/en/managed-settings) | Every use…
Manage mods for your organization
Claude Code CLI · in the page
plugins/mods/admin
…in a user, project, or local settings file, or in a file passed with `--settings`, changes nothing * **A file or MDM policy covers every provider**: when you deliver the option as a file or through MD…
Continue local sessions from any device with Remote Control
Claude Code CLI · in the page
remote-control
…an do, such as `--verbose` or `--model`. For any other flag, such as `--settings`, Claude Code [refuses to start](/docs/en/errors#not-carried-over-to-the-sessions-remote-control-starts) and names the…
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/anthropics/sandbox-runtime) documents the configuration schema. Allow write…
Configure the sandboxed Bash tool
Claude Code CLI · in the page
sandboxing
…session without writing to a settings file, start Claude Code with [`--settings`](/docs/en/settings#change-a-setting-for-one-session). For example, this command starts a sandboxed session in which Cl…
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…
Configure server-managed settings
Claude Code CLI · in the page
server-managed-settings
…precedence over the same key in a user's own settings files or in a `--settings` value, apart from the [exceptions to managed settings precedence](/docs/en/settings#exceptions-to-managed-settings-pre…
Manage sessions
Claude Code CLI · in the page
sessions
…at configure the session, such as `--permission-mode`, `--model`, or `--settings` * Flags that read the output, such as `--output-format json` or `--json-schema` * Flags that limit or rewind the r…
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…
All settings
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 | | [`remoteControlAtStartup`](#remotecontrolatstartup) | Connect [Rem…
Extend Claude with skills
Claude Code CLI · in the page
skills
…settings](/docs/en/managed-settings) or in a file you pass with the `--settings` flag, Claude Code applies it to the skill behind the alias. You can only restrict a skill further through an alias, ne…
Week 20 · May 11–15, 2026
Claude Code CLI · in the page
whats-new/2026-w20
…ff) Other wins `claude agents` gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to conf…
Week 35 · August 24–28, 2026
Claude Code CLI · in the page
whats-new/2026-w35
…le tools to the working directories, loads only managed settings and `--settings`, and refuses the `bypassPermissions` permission mode. Run a non-interactive query without the command-running tools:…