HomeDocs changes
Documentation changes
What the docs quietly changed.
Anthropic's published documentation, fetched on a schedule and diffed against the last copy. Every edit dated, including the ones that never made a release note.
Last poll read all 4 cleanly: Claude Code CLI, Claude Developer Platform, Claude Documentation, Model Context Protocol. A date here is when this site noticed, not when Anthropic edited.
Claude Developer Platform
808pages tracked
587 changed this week · last read 22 Oct 2026
Claude Code CLI
228pages tracked
146 changed this week · last read 22 Oct 2026
Claude Documentation
278pages tracked
74 changed this week · last read 22 Oct 2026
Model Context Protocol
357pages tracked
163 changed this week · last read 21 Oct 2026
100 on this page
5,287 of the ledger's changes in claude-code. Show every change
ReadSourcePageWhatLines
22 Aug 2026
60 pages
+625 −320 lines
claude-code
statusline
±changed
+1−1
claude-codechanged
statusline
Claude Code runs your script and pipes [JSON session data](#available-data) to it via stdin. Your script reads the JSON, extracts what it needs, and prints text to stdout. Claude C
Claude Code runs your script with [JSON session data](#available-data) on stdin and displays whatever the script prints to stdout.
+1 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
slack
±changed
+1−1
claude-codechanged
slack
When you mention @Claude in a Slack channel or thread, Claude automatically analyzes your message to determine if it's a coding task. If Claude detects coding intent, it will route
In Code + Chat routing mode, when you mention @Claude in a Slack channel or thread, Claude automatically detects whether your message is a coding task. Coding tasks go to Claude Co
+1 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
settings-reference
±changed
+5−3
claude-codechanged
settings-reference
Reject the `--plugin-dir`, `--plugin-url`, `--agents`, and `--mcp-config` CLI flags at startup, which users could otherwise pass to bypass [`strictKnownMarketplaces`](#strictknownm
Reject the `--plugin-dir`, `--plugin-url`, `--agents`, and `--mcp-config` CLI flags at startup, which users could otherwise pass to bypass [`strictKnownMarketplaces`](#strictknownm
* `true`: Claude Code rejects `--plugin-dir`, `--plugin-url`, `--agents`, and `--mcp-config` at startup and exits with an error naming them
* `true`: Claude Code rejects `--plugin-dir`, `--plugin-url`, `--agents`, and `--mcp-config` at startup and exits with an error naming them, except that in cloud sessions it drop
A `--mcp-config` whose servers are all in-process `type: "sdk"` entries is still accepted, so the Agent SDK and VS Code extension keep working. This key doesn't block `claude mcp a
+5 −3 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
prompt-caching
±changed
+1−4
claude-codechanged
prompt-caching
When you run `/model` at the terminal, Claude Code asks you to confirm the switch only while the current cache hasn't expired. Whether the cache has expired depends on how long it
* **Less than one [cache TTL](#cache-lifetime) ago**: the cache is still warm.
* **One cache TTL or longer ago**: the cache has already expired, so Claude Code switches without asking.
When you run `/model` at the terminal, Claude Code asks you to confirm the switch only while the cache is still warm. The cache stays warm for one [cache TTL](#cache-lifetime) afte
+1 −4 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
memory
±changed
+1−1
claude-codechanged
memory
Claude Code reads CLAUDE.md files by walking up the directory tree from your current working directory, checking each directory along the way for `CLAUDE.md` and `CLAUDE.local.md`
Claude Code loads `CLAUDE.md` and `CLAUDE.local.md` from your current working directory and every directory above it. Run Claude Code in `foo/bar/` and it loads instructions from `
+1 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
mcp
±changed
+1−1
claude-codechanged
mcp
When a token refresh fails because the server rejects the stored refresh token, Claude Code immediately shows a notice pointing at `/mcp`. The connected server's menu there offers
When the server rejects the stored refresh token, Claude Code immediately shows a notice pointing at `/mcp`. Open `/mcp` and select **Re-authenticate** on the server to sign in aga
+1 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
managed-settings
±changed
+1−1
claude-codechanged
managed-settings
| [`disableSideloadFlags`](/docs/en/settings-reference#disablesideloadflags) | Reject the `--plugin-dir`, `--plugin-url`, `--agents`
| [`disableSideloadFlags`](/docs/en/settings-reference#disablesideloadflags) | Reject the `--plugin-dir`, `--plugin-url`, `--agents`
+1 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
llm-gateway-protocol
±changed
+3−1
claude-codechanged
llm-gateway-protocol
A gateway must expose at least one of the following API formats to Claude Code clients. Which format Claude Code speaks is determined by the client's configuration: the variable in
A gateway must expose at least one of the following API formats to Claude Code clients. A client picks a format and points Claude Code at your gateway with the variables in the Sel
Google Cloud's Agent Platform is Google Cloud's Claude endpoint, formerly Vertex AI; its variable names keep the `VERTEX` spelling.
+3 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
headless
±changed
+1−1
claude-codechanged
headless
Without `--bare`, Claude Code runs the hooks in a project's `.claude/settings.json` even in a folder you've never trusted, because a `-p` session shows no workspace trust dialog. I
Without `--bare`, a `-p` session runs the hooks in a project's `.claude/settings.json` and connects the servers in its `.mcp.json`, even in a folder you've never trusted. A `-p` se
+1 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
deep-links
±changed
+1−2
claude-codechanged
deep-links
* Each time you run `claude` in a Git repository, Claude Code records that directory's path against the repository's GitHub `owner/name` slug.
* When a deep link arrives, `repo` opens whichever matching path you used most recently. Claude Code tracks multiple clones and worktrees separately, so it picks the one you worked
* `repo` opens the linked repository's clone or worktree where you most recently ran `claude`. Each time you run `claude` in a Git repository, Claude Code records that directory's
+1 −2 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
computer-use
±changed
+1−1
claude-codechanged
computer-use
Only one session at a time can use your computer. Claude Code takes a machine-wide lock when a session performs its first computer use action. Claude Code releases it when that ses
Only one session at a time can use your computer. A session takes a machine-wide lock at its first computer use action and releases it when the session exits, not when the task fin
+1 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
common-workflows
±changed
+1−1
claude-codechanged
common-workflows
When Claude creates the PR with `gh pr create` or `glab mr create`, Claude Code links the session to the PR. Claude Code also links the session when Claude [works on an existing PR
To find the session later, run `claude --from-pr 1234` with your own PR number, which opens the session picker filtered to sessions linked to that PR, or paste the PR URL into the
+1 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
cloud-environments
±changed
+14−24
claude-codechanged
cloud-environments
Onboarding sets up the **Default** environment for you, whether you connect through [the web](/docs/en/web-quickstart#connect-github) or a CLI flow such as `/web-setup`; if web onb
If you don't have an environment yet, onboarding sets up the **Default** environment for you, whether you connect through [the web](/docs/en/web-quickstart#connect-github) or a CLI
| **PHP** | 8.4 with Composer |
| **PHP** | 8.3 with Composer |
| **Go** | latest stable with module support |
+14 −24 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
claude-code-on-the-web
±changed
+1−1
claude-codechanged
claude-code-on-the-web
Every cloud session runs in a [cloud environment](/docs/en/cloud-environments), the saved configuration that controls network access, environment variables, and setup scripts. When
Every cloud session runs in a [cloud environment](/docs/en/cloud-environments), the saved configuration that controls network access, environment variables, and setup scripts. If y
+1 −1 lines
Recorded here 22 Aug 2026 03:37 UTC
claude-code
settings-reference
±changed
+9−22
claude-codechanged
settings-reference
This reference page lists each key Claude Code reads from a settings file, plus the [short group of keys](#global-config-settings) it keeps in `~/.claude.json` instead.
Use the [index](#all-settings) to find a key by name or purpose and to see its topic and scope, then open the key's linked entry for what it lets you do, where Claude Code reads it
For how to apply these settings, which settings file to use, and which value Claude Code uses when a key is set in more than one place, see [Claude Code settings](/docs/en/settings
+9 −22 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
server-managed-settings
±changed
+6−6
claude-codechanged
server-managed-settings
| Approach | Best for | Security model
| :------------------------------------------------------------------------ | :------------------------------------------------------- | :------------------------------------------
| **Server-managed settings** | Organizations without MDM, or users on unmanaged devices | Settings delivered from Anthropic's servers
| **[Endpoint-managed settings](/docs/en/managed-settings#delivery-mechanisms)** | Organizations with MDM or endpoint management | Settings deployed to devices via MDM c
| Approach | Best for | Security model
+6 −6 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
self-hosted-environments-deploy
±changed
+1−1
claude-codechanged
self-hosted-environments-deploy
| `storage.googleapis.com` | 443 | At session runtime, for marketplace plugin catalog fetches and Artifact publishing when the Artifact tool is enabled; Artifact publi
| `storage.googleapis.com` | 443 | At session runtime, for the plugin install counts and metadata shown in `/plugin`.
+1 −1 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
plugin-marketplaces
±changed
+14−10
claude-codechanged
plugin-marketplaces
| `metadata.pluginRoot` | string | Base directory prepended to relative plugin source paths (for example, `"./plugins"` lets you write `"source": "formatter"` inste
| `metadata.pluginRoot` | string | Directory that Claude Code resolves bare plugin source names under. See [Relative paths](#relative-paths). Requires Claude Code v
| Source | Type | Fields | Notes
| ------------- | ------------------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------
| Relative path | `string` (e.g. `"./my-plugin"`) | none | Local directory within the marketplace repo. Must start with `./`. Resolved relative to the
+14 −10 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
network-config
±changed
+1−1
claude-codechanged
network-config
| `storage.googleapis.com` | Install counts and plugin metadata shown in `/plugin`. Signed [artifact](/docs/en/artifacts) uploads try this host first; publishing falls
| `storage.googleapis.com` | Plugin install counts and metadata shown in `/plugin`
+1 −1 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
managed-settings
±changed
+21−21
claude-codechanged
managed-settings
| Setting | Description
| :-------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------
| [`allowAllClaudeAiMcps`](/docs/en/settings-reference#allowallclaudeaimcps) | Load the claude.ai connectors alongside a deployed `m
| [`allowedChannelPlugins`](/docs/en/settings-reference#allowedchannelplugins) | Allowlist of channel plugins that may push messages.
| [`allowManagedHooksOnly`](/docs/en/settings-reference#allowmanagedhooksonly) | When `true`, restricts which hooks run; see [what run
+21 −21 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
jetbrains
±changed
+2−2
claude-codechanged
jetbrains
* **Diagnostic sharing**: after Claude edits a file, Claude Code pulls the IDE's new diagnostics for that file, such as lint and syntax errors, into the conversation, so Claude not
* **Diagnostic sharing**: Claude reads the IDE's inspection diagnostics, such as lint and syntax errors, by calling the [`getDiagnostics` tool](#the-built-in-ide-mcp-server); Claud
When the plugin is active, it runs a local MCP server that the CLI connects to automatically. This is how the CLI opens diffs in the IDE's native diff viewer, reads your current se
When the plugin is active, it runs a local MCP server that the CLI connects to automatically. This is how the CLI opens diffs in the IDE's native diff viewer, reads your current se
+2 −2 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
interactive-mode
±changed
+11−5
claude-codechanged
interactive-mode
**macOS users**: Option/Alt key shortcuts (`Alt+B`, `Alt+F`, `Alt+Y`, `Alt+P`) require configuring Option as Meta in your terminal. See [Enable Option key shortcuts on macOS](/do
**macOS users**: Option/Alt key shortcuts (`Alt+B`, `Alt+F`, `Alt+D`, `Alt+Y`, `Alt+P`) require configuring Option as Meta in your terminal. See [Enable Option key shortcuts on m
| `Ctrl+Y` | Paste deleted text | Paste text deleted with `Ctrl+K`, `Ctrl+U`, or `Ctrl+W`
| `Ctrl+Y` | Paste deleted text | Paste text deleted with `Ctrl+K`, `Ctrl+U`, `Ctrl+W`, or, under [`keybindingFlavor: "readline"`](#make-ctrl-w-
| `Alt+F` | Move cursor forward one word | Word navigation. Requires [Option as Meta](#keyboard-shortcuts) on macOS
+11 −5 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
goal
±changed
+8−4
claude-codechanged
goal
A goal that was still active when a session ended is restored when you resume that session with `--resume` or `--continue`. The condition carries over, but the turn count, timer, a
When you resume a session, Claude Code restores a goal that was still active when the session ended. Claude Code restores it on every resume route: `--continue`, `--resume` with a
Claude Code carries the condition over but resets the turn count, timer, and token-spend baseline. It doesn't restore a goal that was already achieved or cleared.
Once background work has kept the goal waiting for 30 minutes, a check-in is due. In the check-in, Claude Code lists the running tasks and asks Claude to read their output, keep wa
+8 −4 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
fullscreen
±changed
+26−6
claude-codechanged
fullscreen
Fullscreen rendering is a [research preview](#research-preview). If you first used Claude Code on or after May 6, 2026, Claude Code renders fullscreen by default; run `/tui defau
Fullscreen rendering is a [research preview](#research-preview). Whether you [start in fullscreen or in the classic renderer](#fullscreen-by-default) depends on your setup. Run `
<Note>
If you first used Claude Code before May 6, 2026 and haven't saved a `tui` setting, Claude Code may open a dialog at startup offering the switch. If you accept, Claude Code relau
</Note>
+26 −6 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
errors
±changed
+5−5
claude-codechanged
errors
| Variable | Default | Effect
| :------------------------------------------- | :------ | :------------------------------------------------------------------------------------------------------------------------
| [`CLAUDE_CODE_MAX_RETRIES`](/docs/en/env-vars) | 10 | Number of retry attempts. Capped at 15 as of v2.1.186; as of v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` raises the defaul
| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/en/env-vars) | unset | Set to `1` in unattended sessions such as CI jobs to retry `429` and `529` capacity errors indefinitely instead of f
| [`API_TIMEOUT_MS`](/docs/en/env-vars) | 600000 | Per-request timeout in milliseconds. Raise it for slow networks or proxies.
+5 −5 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
env-vars
±changed
+1−1
claude-codechanged
env-vars
| `CLAUDE_CODE_RETRY_WATCHDOG` | Set to `1` for unattended sessions such as eval harnesses, CI jobs, or remote workers. Retries `429` and `529` capacity
| `CLAUDE_CODE_RETRY_WATCHDOG` | Set to `1` for unattended sessions such as eval harnesses, CI jobs, or remote workers. Retries `429` and `529` capacity
+1 −1 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
agent-sdk/typescript
±changed
+1−1
claude-codechanged
agent-sdk/typescript
* `CLAUDE_CODE_MAX_RETRIES`: maximum API retries. Default `10`, capped at `15`. Each retry gets its own `API_TIMEOUT_MS` window, so worst-case wall time is roughly `API_TIMEOUT_MS
* `CLAUDE_CODE_MAX_RETRIES`: maximum API retries. Default `10`, capped at `15`. Each retry gets its own `API_TIMEOUT_MS` window, so worst-case wall time is roughly `API_TIMEOUT_MS
+1 −1 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
agent-sdk/python
±changed
+1−1
claude-codechanged
agent-sdk/python
* `CLAUDE_CODE_MAX_RETRIES`: maximum API retries. Default `10`, capped at `15`. Each retry gets its own `API_TIMEOUT_MS` window, so worst-case wall time is roughly `API_TIMEOUT_MS
* `CLAUDE_CODE_MAX_RETRIES`: maximum API retries. Default `10`, capped at `15`. Each retry gets its own `API_TIMEOUT_MS` window, so worst-case wall time is roughly `API_TIMEOUT_MS
+1 −1 lines
Recorded here 22 Aug 2026 03:07 UTC
claude-code
tools-reference
±changed
+1−1
claude-codechanged
tools-reference
| `ListAgents` | Lists the agents Claude can message with `SendMessage`, apart from [agent team](/docs/en/agent-teams) teammates, which Claude reaches through the team's
| `ListAgents` | Lists the agents Claude can message with `SendMessage`: subagents in the session, [agent team](/docs/en/agent-teams) teammates, your other local Claude C
+1 −1 lines
Recorded here 22 Aug 2026 02:37 UTC
claude-code
cross-session-messaging
±changed
+12−8
claude-codechanged
cross-session-messaging
* Claude addresses the message to this session's own name, as described under [See which sessions Claude can reach](#see-which-sessions-claude-can-reach).
Claude finds a message's target on its own, so you don't need to run anything before asking it to send. To see for yourself which sessions Claude can reach, run the `/list-agents`
* **Subagents**: agents running inside the current session. [Agent team](/docs/en/agent-teams) teammates aren't listed; Claude messages them through the team's own roster.
Claude finds a message's target on its own, so you don't need to run anything before asking it to send. To see for yourself which sessions Claude can reach, run the `/list-agents`
+12 −8 lines
Recorded here 22 Aug 2026 02:37 UTC
claude-code
commands
±changed
+1−1
claude-codechanged
commands
| `/list-agents` | List the subagents and other Claude Code sessions Claude can message, with the nam
| `/list-agents` | List the subagents, [agent team](/docs/en/agent-teams) teammates, and other Claude
+1 −1 lines
Recorded here 22 Aug 2026 02:37 UTC
21 Aug 2026
114 pages
+8034 −1455 lines
claude-code
prompt-caching
±changed
+14−4
claude-codechanged
prompt-caching
System context that Claude Code appends mid-conversation, such as file-change notices, is cached on Amazon Bedrock and its [Mantle endpoint](/docs/en/amazon-bedrock#use-the-mantle-
When your requests pass through an [LLM gateway](/docs/en/llm-gateway) or a custom `ANTHROPIC_BASE_URL`, Claude Code marks that appended system context for caching the same way, an
Claude Code also appends system context mid-conversation, such as file-change notices. Whether that block is cached depends on how your requests reach the provider.
+14 −4 lines
Recorded here 21 Aug 2026 23:37 UTC
claude-code
llm-gateway-rollout
±changed
+1−1
claude-codechanged
llm-gateway-rollout
* **Return upstream errors unmodified**: Claude Code's automatic recovery matches on error wording, so wrapping errors in the gateway's own envelope breaks it
* **Return upstream errors unmodified**: Claude Code's automatic recovery matches on error wording, so wrapping errors in the gateway's own envelope breaks it, unless the envelope'
+1 −1 lines
Recorded here 21 Aug 2026 23:37 UTC
claude-code
llm-gateway-protocol
±changed
+1−1
claude-codechanged
llm-gateway-protocol
The retry logic matches on the upstream's error wording, so forward error response bodies unmodified. A gateway that wraps upstream errors in its own envelope breaks the recovery p
The retry logic matches on the upstream's error wording, so forward error response bodies unmodified. A gateway that wraps upstream errors in its own envelope breaks the recovery p
+1 −1 lines
Recorded here 21 Aug 2026 23:37 UTC
claude-code
llm-gateway-connect
±changed
+18−18
claude-codechanged
llm-gateway-connect
| Error
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| A startup warning naming two credential sources and ending in `auth may not work as expected`. Older versions show `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) a
| `401` errors naming an invalid or unrecognized token
| `Your apiKeyHelper script is failing`
+18 −18 lines
Recorded here 21 Aug 2026 23:37 UTC
claude-code
legal-and-compliance
±changed
+16−3
claude-codechanged
legal-and-compliance
* [Commercial Terms](https://www.anthropic.com/legal/commercial-terms) - for Team, Enterprise, and Claude API users
* [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms) - for Team, Enterprise, and Claude API users
### Can customers offer Claude Code in their products?
Unless we've mutually agreed otherwise, preinstalling or running Claude Code in your products or services (e.g. in hosted sandboxes or other agent infrastructure) requires agreeing
+16 −3 lines
Recorded here 21 Aug 2026 23:37 UTC
claude-code
errors
±changed
+30−0
claude-codechanged
errors
| `API returned an empty or malformed response`
| `capability_rejected: prompt_too_long` on a Claude apps gateway session
| `upstream rejected the request` / `request too large for this upstream` on a Claude apps gateway session
| `upstream rate limit exceeded` on a Claude apps gateway session
| `all upstreams failed (N attempted)` on a Claude apps gateway session
+30 −0 lines
Recorded here 21 Aug 2026 23:37 UTC
claude-code
claude-apps-gateway-config
±changed
+19−0
claude-codechanged
claude-apps-gateway-config
#### Upstream error messages
The gateway returns one upstream's error response, or its own `502`, depending on how the upstreams answered:
+19 −0 lines
Recorded here 21 Aug 2026 23:37 UTC
claude-code
claude-apps-gateway
±changed
+2−1
claude-codechanged
claude-apps-gateway
| Standard prompt caching | Available | `cache_control` breakpoints a
| [Remote Control](/docs/en/remote-control) | Not available | The CLI shows [an error
| Standard prompt caching | Available | The gateway forwards `cache_c
+2 −1 lines
Recorded here 21 Aug 2026 23:37 UTC
claude-code
worktrees
±changed
+4−4
claude-codechanged
worktrees
A periodic sweep removes worktrees that Claude created for subagents and [background sessions](/docs/en/agent-view#how-file-edits-are-isolated) once they are older than your [`clea
A periodic sweep removes worktrees that Claude created for subagents and [background sessions](/docs/en/agent-view#how-file-edits-are-isolated) once they are older than your [`clea
New worktrees branch from the repository's default branch, so most sessions don't need this setting. Set `worktree.baseRef` in [settings](/docs/en/settings#worktree-settings) to br
New worktrees branch from the repository's default branch, so most sessions don't need this setting. Set `worktree.baseRef` in [settings](/docs/en/settings-reference#worktree) to b
* **Permission approvals**: choosing "Yes, and don't ask again" for a Bash command in a worktree session saves the rule to the main checkout's `.claude/settings.local.json`, so it
+4 −4 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
workflows
±changed
+3−3
claude-codechanged
workflows
Ultracode lasts for the current session and resets when you start a new one. Drop back with `/effort high` when you return to routine work. It's available on models that support `x
`/effort ultracode` lasts for the current session; to have every session start with it, set the [`ultracode`](/docs/en/settings-reference#ultracode) setting. Drop back with `/effor
Your permission mode controls only the launch prompt above. The subagents the workflow spawns always run in `acceptEdits` mode and inherit your [tool allowlist](/docs/en/settings#p
Your permission mode controls only the launch prompt above. The subagents the workflow spawns always run in `acceptEdits` mode and inherit your [tool allowlist](/docs/en/settings-r
To change the guideline, pick a value for the Dynamic workflow size setting in `/config`, or run `/config workflowSizeGuideline=small`. On v2.1.219 and later, you can also set the
+3 −3 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
vs-code
±changed
+3−3
claude-codechanged
vs-code
* The Settings section includes **Enable Remote Control for all sessions**, which sets [`remoteControlAtStartup`](/docs/en/settings#available-settings) to control whether [new in
* The Settings section includes **Enable Remote Control for all sessions**, which sets [`remoteControlAtStartup`](/docs/en/settings-reference#remotecontrolatstartup) to control w
* **Side questions**: type `/btw` followed by a question, or pick it from the command menu, to ask about your session [without adding to the conversation](/docs/en/interactive-mode
* **Side questions**: type `/btw` followed by a question, or pick it from the command menu, to ask about your session [without adding to the conversation](/docs/en/interactive-mode
If you run `claude` in a VS Code integrated terminal, Claude Code reinstalls the extension automatically. To keep it uninstalled, turn off **Auto-install IDE extension** in `/confi
+3 −3 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
voice-dictation
±changed
+2−2
claude-codechanged
voice-dictation
Voice dictation uses the same [`language` setting](/docs/en/settings) that controls Claude's response language. If that setting is empty, dictation defaults to English. In the VS C
Voice dictation uses the same [`language` setting](/docs/en/settings-reference#language) that controls Claude's response language. If that setting is empty, dictation defaults to E
* [Configure settings](/docs/en/settings): full reference for `voice`, `language`, and other settings keys
* [Settings reference](/docs/en/settings-reference#voice): the `voice`, `language`, and other settings keys
+2 −2 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
troubleshooting
±changed
+1−1
claude-codechanged
troubleshooting
Then set `USE_BUILTIN_RIPGREP` to `0`, either in your shell [environment](/docs/en/env-vars) or in the `env` block of your [`settings.json`](/docs/en/settings#available-settings):
Then set `USE_BUILTIN_RIPGREP` to `0`, either in your shell [environment](/docs/en/env-vars) or in the `env` block of your [`settings.json`](/docs/en/settings-reference#all-setting
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
tools-reference
±changed
+6−6
claude-codechanged
tools-reference
* in [`permissions.allow` and `permissions.deny`](/docs/en/settings#available-settings) in settings, and the `/permissions` interface
* in [`permissions.allow`](/docs/en/settings-reference#permissions-allow) and [`permissions.deny`](/docs/en/settings-reference#permissions-deny) in settings, and the `/permissions`
Questions stay open until you answer them. If you want a question you leave unanswered to eventually close and let Claude continue without you, set the [`askUserQuestionTimeout`](/
Questions stay open until you answer them. If you want a question you leave unanswered to eventually close and let Claude continue without you, set the [`askUserQuestionTimeout`](/
Claude Code denies URLs that point at a private, link-local, or cloud-metadata address, including hostnames that resolve to one. It also denies hosts in `sandbox.network.deniedDoma
+6 −6 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
terminal-config
±changed
+4−4
claude-codechanged
terminal-config
By default Claude Code sends a desktop notification only in Ghostty, Kitty, and iTerm2. In other terminals, set [`preferredNotifChannel`](/docs/en/settings#available-settings) to `
By default Claude Code sends a desktop notification only in Ghostty, Kitty, and iTerm2. In other terminals, set [`preferredNotifChannel`](/docs/en/settings-reference#preferrednotif
When Claude Code runs inside tmux, two things break by default: Shift+Enter submits instead of inserting a newline, and desktop notifications and the [progress bar](/docs/en/settin
When Claude Code runs inside tmux, two things break by default: Shift+Enter submits instead of inserting a newline, and desktop notifications and the [progress bar](/docs/en/settin
Claude Code deletes cache files older than [`cleanupPeriodDays`](/docs/en/settings#available-settings), following the [retention sweep rules](/docs/en/claude-directory#cleaned-up-a
+4 −4 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
sub-agents
±changed
+4−4
claude-codechanged
sub-agents
**Managed subagents** are deployed by organization administrators. Place markdown files in `.claude/agents/` inside the [managed settings directory](/docs/en/settings#settings-file
**Managed subagents** are deployed by organization administrators. Place markdown files in `.claude/agents/` inside the [managed settings directory](/docs/en/managed-settings#deliv
For security reasons, plugin subagents don't support the `hooks`, `mcpServers`, or `permissionMode` frontmatter fields. These fields are ignored when loading agents from a plugin
For security reasons, plugin subagents don't support the `hooks`, `mcpServers`, or `permissionMode` frontmatter fields. These fields are ignored when loading agents from a plugin
You can prevent Claude from using specific subagents by adding them to the `deny` array in your [settings](/docs/en/settings#permission-settings). Use the format `Agent(subagent-na
+4 −4 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
statusline
±changed
+5−5
claude-codechanged
statusline
The status line renders in its own row above the built-in footer badges and does not replace them. With a custom status line configured, Claude Code stops showing most of the foote
The status line renders in its own row above the built-in footer badges and does not replace them. With a custom status line configured, Claude Code stops showing most of the foote
Add a `statusLine` field to your user settings (`~/.claude/settings.json`, where `~` is your home directory) or [project settings](/docs/en/settings#settings-files). Set `type` to
Add a `statusLine` field to your user settings (`~/.claude/settings.json`, where `~` is your home directory) or [project settings](/docs/en/settings#where-settings-live). Set `type
The same trust, `disableAllHooks`, and [`allowManagedHooksOnly`](/docs/en/settings#hook-configuration) gates that apply to `statusLine` apply here. Plugins can ship a default `suba
+5 −5 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
skills
±changed
+12−12
claude-codechanged
skills
Bundled skills are available in every session. To turn them off, use the [`disableBundledSkills`](/docs/en/settings#available-settings) setting, which disables every bundled skill
Bundled skills are available in every session. To turn them off, use the [`disableBundledSkills`](/docs/en/settings-reference#disablebundledskills) setting, which disables every bu
| Location | Path | Applies to |
| :--------- | :-------------------------------------------------- | :----------------------------- |
| Enterprise | See [managed settings](/docs/en/settings#settings-files) | All users in your organization |
+12 −12 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
setup
±changed
+7−7
claude-codechanged
setup
When Git for Windows is installed, the PowerShell tool is rolling out progressively as an additional option alongside Bash. Set `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` to opt in or `0`
When Git for Windows is installed, the PowerShell tool is available alongside Bash: on by default for claude.ai and Console accounts, and enabled with `CLAUDE_CODE_USE_POWERSHELL_T
Then set `USE_BUILTIN_RIPGREP` to `0` in your [`settings.json`](/docs/en/settings#available-settings) file:
Then set `USE_BUILTIN_RIPGREP` to `0` in your [`settings.json`](/docs/en/settings-reference#all-settings) file:
For enterprise deployments, you can enforce a consistent release channel across your organization using [managed settings](/docs/en/permissions#managed-settings).
+7 −7 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
settings-reference
+new page
+5350−0
claude-codenew page
settings-reference
No line of the body moved in this read.
+5350 −0 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
settings-example
+new page
+389−0
claude-codenew page
settings-example
No line of the body moved in this read.
+389 −0 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
sessions
±changed
+8−8
claude-codechanged
sessions
* `plan` and `bypassPermissions` are never restored; a session that was in one of them resumes in the mode a new session would start in. To [bypass permissions](/docs/en/permissi
* `plan` and `bypassPermissions` are never restored; a session that was in one of them resumes in the mode a new session would start in. To [bypass permissions](/docs/en/permissi
| To | Set | Where |
| ------------------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------- |
| Move storage off `~/.claude` | [`CLAUDE_CONFIG_DIR`](/docs/en/env-vars) | Environment variable |
+8 −8 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
server-managed-settings
±changed
+40−40
claude-codechanged
server-managed-settings
Server-managed settings let organization Owners centrally configure Claude Code from [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-c
Server-managed settings let organization Owners centrally configure Claude Code from [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-c
Claude Code supports two approaches for centralized configuration. Server-managed settings deliver configuration from Anthropic's servers. [Endpoint-managed settings](/docs/en/sett
| Approach | Best for | Security model
+40 −40 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
self-hosted-environments-testing
±changed
+1−1
claude-codechanged
self-hosted-environments-testing
The flag takes precedence over the [`remote.defaultEnvironmentId`](/docs/en/settings#available-settings) setting. It doesn't support `--output-format stream-json`, and can't be com
The flag takes precedence over the [`remote.defaultEnvironmentId`](/docs/en/settings-reference#remote-defaultenvironmentid) setting. It doesn't support `--output-format stream-json
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
self-hosted-environments-configuration
±changed
+2−2
claude-codechanged
self-hosted-environments-configuration
Repository-committed `.claude/settings.json` layers on top as project settings. Sessions also read [`managed-settings.json`](/docs/en/settings#settings-files) from the standard sys
Repository-committed `.claude/settings.json` layers on top as project settings. Sessions also read [`managed-settings.json`](/docs/en/settings#where-settings-live) from the standar
* **What still governs them**: hooks delivered through `--settings` enter the ordinary merged hook configuration, not the managed tier, so your managed settings still apply. `disab
* **What still governs them**: hooks delivered through `--settings` enter the ordinary merged hook configuration, not the managed tier, so your managed settings still apply. `disab
+2 −2 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
security-guidance
±changed
+1−1
claude-codechanged
security-guidance
Administrators can enable the plugin organization-wide by setting [`enabledPlugins`](/docs/en/settings#plugin-settings) in [managed settings](/docs/en/admin-setup).
Administrators can enable the plugin organization-wide by setting [`enabledPlugins`](/docs/en/settings-reference#enabledplugins) in [managed settings](/docs/en/admin-setup).
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
security
±changed
+1−1
claude-codechanged
security
* Use [managed settings](/docs/en/settings#settings-files) to enforce organizational standards
* Use [managed settings](/docs/en/settings#where-settings-live) to enforce organizational standards
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
sandboxing
±changed
+39−39
claude-codechanged
sandboxing
* **Overrides**: choose whether commands that fail under the sandbox can fall back to running unsandboxed. This is the [`allowUnsandboxedCommands`](/docs/en/settings#sandbox-se
* **Overrides**: choose whether commands that fail under the sandbox can fall back to running unsandboxed. This is the [`allowUnsandboxedCommands`](/docs/en/settings-reference#
When you select a mode in the panel, Claude Code saves it to your project's local settings at `.claude/settings.local.json`, which apply to the current project. Claude Code adds th
When you select a mode in the panel, Claude Code saves it to your project's local settings at `.claude/settings.local.json`, which apply to the current project. Claude Code adds th
By default, if the sandbox cannot start because dependencies are missing or the platform is unsupported, Claude Code shows a warning and runs commands without sandboxing. To make
+39 −39 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
sandbox-environments
±changed
+2−2
claude-codechanged
sandbox-environments
* **Built-in Bash sandbox**: the only approach Claude Code enforces itself. Deliver the `sandbox` settings keys through [managed settings](/docs/en/settings#settings-files), either
* **Built-in Bash sandbox**: the only approach Claude Code enforces itself. Deliver the `sandbox` settings keys through [managed settings](/docs/en/managed-settings#delivery-mechan
* [Settings](/docs/en/settings#sandbox-settings): all sandbox configuration keys, including managed settings delivery
* [Settings](/docs/en/settings-reference#sandbox-settings): all sandbox configuration keys, including managed settings delivery
+2 −2 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
routines
±changed
+1−1
claude-codechanged
routines
* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, or `DISABLE_GROWTHBOOK` is set in your shell environment or in the `env` block of a [`settings.js
* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, or `DISABLE_GROWTHBOOK` is set in your shell environment or in the `env` block of a [`settings.js
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
remote-control
±changed
+8−8
claude-codechanged
remote-control
* **Feature-flag evaluation**: [`DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, and `DISABLE_GROWTHBOOK`](/docs/en/env-vars) each disable the featu
* **Feature-flag evaluation**: [`DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, and `DISABLE_GROWTHBOOK`](/docs/en/env-vars) each disable the featu
If you didn't set an explicit name, Claude Code updates the title to reflect your prompt once you send one. Claude Code matches auto-generated titles to the language of your conver
If you didn't set an explicit name, Claude Code updates the title to reflect your prompt once you send one. Claude Code matches auto-generated titles to the language of your conver
* **`false`**: turn auto-connect off, though a `true` from [managed settings](/docs/en/settings#settings-files) outranks it, because Claude Code saves the choice to your user setti
+8 −8 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
quickstart
±changed
+5−5
claude-codechanged
quickstart
```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
```bash theme={null}
```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme=
```powershell theme={null}
```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null
+5 −5 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
prompt-caching
±changed
+2−2
claude-codechanged
prompt-caching
Set `FORCE_PROMPT_CACHING_5M=1` to force the five-minute TTL regardless of authentication. This is useful when you're debugging cache behavior, comparing the two TTLs, or overridin
Set `FORCE_PROMPT_CACHING_5M=1` to force the five-minute TTL regardless of authentication. This is useful when you're debugging cache behavior, comparing the two TTLs, or overridin
To set caching policy across an organization, put any of these or the [TTL variables](#cache-lifetime) in the `env` block of [managed settings](/docs/en/settings#settings-files). F
To set caching policy across an organization, put any of these or the [TTL variables](#cache-lifetime) in the `env` block of [managed settings](/docs/en/managed-settings). For norm
+2 −2 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
plugins-reference
±changed
+10−10
claude-codechanged
plugins-reference
| Scope | Settings file | Use case |
| :-------- | :---------------------------------------------- | :-------------------------------------------------------------------------- |
| `user` | `~/.claude/settings.json` | Personal plugins available across all projects (default) |
| `project` | `.claude/settings.json` | Team plugins shared via version control |
| `local` | `.claude/settings.local.json` | Project-specific plugins, gitignored when Claude Code saves a setting to it |
+10 −10 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
plugin-relevance
±changed
+3−3
claude-codechanged
plugin-relevance
Marketplace-declared suggestions are opt-in per marketplace through [managed settings](/docs/en/settings#settings-files). No marketplace's `relevance` declarations produce suggesti
Marketplace-declared suggestions are opt-in per marketplace through [managed settings](/docs/en/managed-settings). No marketplace's `relevance` declarations produce suggestions unt
Declaring `relevance` in `marketplace.json` is not enough on its own. An administrator must allowlist the marketplace in [managed settings](/docs/en/settings#settings-files) before
Declaring `relevance` in `marketplace.json` is not enough on its own. An administrator must allowlist the marketplace in [managed settings](/docs/en/managed-settings) before its su
* [Settings](/docs/en/settings): full reference for `pluginSuggestionMarketplaces` and `extraKnownMarketplaces`
+3 −3 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
plugin-marketplaces
±changed
+19−19
claude-codechanged
plugin-marketplaces
If you register the marketplace from a URL source with `headers`, such as an [`extraKnownMarketplaces` entry](/docs/en/settings#extraknownmarketplaces), Claude Code sends those hea
If you register the marketplace from a URL source with `headers`, such as an [`extraKnownMarketplaces` entry](/docs/en/settings-reference#extraknownmarketplaces), Claude Code sends
Administrators can block command sources across an organization with the managed setting [`disableCommandPluginSources`](/docs/en/settings#available-settings). If an organization s
Administrators can block command sources across an organization with the managed setting [`disableCommandPluginSources`](/docs/en/settings-reference#disablecommandpluginsources). I
For full configuration options, see [Plugin settings](/docs/en/settings#plugin-settings).
+19 −19 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
plugin-dependencies
±changed
+1−1
claude-codechanged
plugin-dependencies
To roll bundles out across an organization, add the bundle plugin to `enabledPlugins` in [managed settings](/docs/en/settings#enabledplugins).
To roll bundles out across an organization, add the bundle plugin to `enabledPlugins` in [managed settings](/docs/en/settings-reference#enabledplugins).
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
permissions
±changed
+23−48
claude-codechanged
permissions
When you choose "Yes, and don't ask again" and the approval saves permanently, such as for a Bash command or a WebFetch domain, Claude Code saves the rule to `.claude/settings.loca
When you choose "Yes, and don't ask again" and the approval saves permanently, such as for a Bash command or a WebFetch domain, Claude Code saves the rule to `.claude/settings.loca
To turn the shortcut off, set [`permissionExplainerEnabled`](/docs/en/settings#global-config-settings) to `false` in `~/.claude.json`.
To turn the shortcut off, set [`permissionExplainerEnabled`](/docs/en/settings-reference#permissionexplainerenabled) to `false` in `~/.claude.json`.
Claude Code supports several permission modes that control how it approves tool calls. See [Permission modes](/docs/en/permission-modes) for when to use each one. To change the mod
+23 −48 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
permission-modes
±changed
+26−26
claude-codechanged
permission-modes
| You want to | Start with
| :------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------
| Review every action yourself | Manual mode: `claude --permission-mode default`
| Iterate locally with fewer prompts, without a classifier | Manual mode plus the Bash sandbox in [auto-allow mode](/docs/en/sandboxing#sandbox-modes): `claude --permission-mode de
| Explore before changing anything | `claude --permission-mode plan`
+26 −26 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
overview
±changed
+5−5
claude-codechanged
overview
```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={n
```bash theme={null}
```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} th
```powershell theme={null}
```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={
+5 −5 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
output-styles
±changed
+1−1
claude-codechanged
output-styles
* Managed policy: `.claude/output-styles` inside the [managed settings directory](/docs/en/settings#settings-files)
* Managed policy: `.claude/output-styles` inside the [managed settings directory](/docs/en/managed-settings#delivery-mechanisms)
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
network-config
±changed
+20−20
claude-codechanged
network-config
In [Claude Desktop](/docs/en/desktop) sessions where the app manages the provider connection, such as the Code tab on a [third-party provider](/docs/en/third-party-integrations) an
In [Claude Desktop](/docs/en/desktop) sessions where the app manages the provider connection, such as the Code tab on a [third-party provider](/docs/en/third-party-integrations) an
Set the [`processWrapper`](/docs/en/settings#available-settings) setting to prefix the supervisor, its workers, and the other background processes listed under [What the launcher c
Set the [`processWrapper`](/docs/en/settings-reference#processwrapper) setting to prefix the supervisor, its workers, and the other background processes listed under [What the laun
| URL | Required for
+20 −20 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
monitoring-usage
±changed
+3−3
claude-codechanged
monitoring-usage
Administrators can configure OpenTelemetry settings for all users through the [managed settings file](/docs/en/settings#settings-files). See the [settings precedence](/docs/en/sett
Administrators can configure OpenTelemetry settings for all users through the [managed settings file](/docs/en/managed-settings#delivery-mechanisms). See the [settings precedence](
* **Exporter selectors**: `OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, and the beta `OTEL_TRACES_EXPORTER` follow normal per-key precedence. A developer's setting can still disab
* **Exporter selectors**: `OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, and the beta `OTEL_TRACES_EXPORTER` follow normal per-key precedence. A developer's setting can still disab
Logged once per run of the retention cleanup sweep, which deletes [session transcripts and other application data](/docs/en/claude-directory#cleaned-up-automatically) older than th
+3 −3 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
model-config
±changed
+29−29
claude-codechanged
model-config
In a session with [Remote Control](/docs/en/remote-control) connected, a [background session](/docs/en/agent-view), or an [agent team](/docs/en/agent-teams) teammate's session, nob
In a session with [Remote Control](/docs/en/remote-control) connected, a [background session](/docs/en/agent-view), or an [agent team](/docs/en/agent-teams) teammate's session, nob
When the active model at startup comes from project or managed settings rather than your own selection, the startup header shows which settings file set it. Run `/model` to overrid
When the active model at startup comes from project or managed settings rather than your own selection, the startup header shows which settings file set it. Run `/model` to overrid
Enterprise administrators can use `availableModels` in [managed or policy settings](/docs/en/settings#settings-files) to restrict which models users can select. Entries match a mod
+29 −29 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
memory
±changed
+4−4
claude-codechanged
memory
Use MDM, Group Policy, Ansible, or similar tools to distribute the file across developer machines. See [managed settings](/docs/en/permissions#managed-settings) for other organ
Use MDM, Group Policy, Ansible, or similar tools to distribute the file across developer machines. See [managed settings](/docs/en/managed-settings) for other organization-wide
A managed CLAUDE.md and [managed settings](/docs/en/settings#settings-files) serve different purposes. Use settings for technical enforcement and CLAUDE.md for behavioral guidance:
A managed CLAUDE.md and [managed settings](/docs/en/managed-settings) serve different purposes. Use settings for technical enforcement and CLAUDE.md for behavioral guidance:
Patterns are matched against absolute file paths using glob syntax. You can configure `claudeMdExcludes` at any [settings layer](/docs/en/settings#settings-files): user, project, l
+4 −4 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
mcp
±changed
+7−7
claude-codechanged
mcp
As of v2.1.196, `claude mcp list` and `claude mcp get` read `.mcp.json` approvals only from settings files that aren't checked into the repository until you trust the workspace by
As of v2.1.196, `claude mcp list` and `claude mcp get` read `.mcp.json` approvals only from settings files that aren't checked into the repository until you trust the workspace by
`disabledMcpServers` and `enabledMcpServers` are unrelated to [`enabledMcpjsonServers` and `disabledMcpjsonServers`](/docs/en/settings#available-settings), which control approval o
`disabledMcpServers` and `enabledMcpServers` are unrelated to [`enabledMcpjsonServers`](/docs/en/settings-reference#enabledmcpjsonservers) and [`disabledMcpjsonServers`](/docs/en/s
The term "local scope" for MCP servers differs from general local settings. MCP local-scoped servers are stored in `~/.claude.json` (your home directory), while general local set
+7 −7 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
managed-settings
+new page
+295−0
claude-codenew page
managed-settings
No line of the body moved in this read.
+295 −0 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
managed-mcp
±changed
+17−17
claude-codechanged
managed-mcp
| Pattern | What it does | Configure
| :---------------------- | :-------------------------------------------------------------------------------------------------------------------- | :-------------------------------
| **Disable MCP** | No servers load, apart from the [VS Code extension's own in-process server](#exclusive-control-with-managed-mcp-json) | `managed-mcp.json` with an empty
| **Fixed deployment** | Every user gets the same servers and can't add others | `managed-mcp.json` with the serv
| **Approved catalog** | Publish a list of approved servers; users add the ones they want, anything else is blocked | `allowedMcpServers` + `allowMana
+17 −17 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
llm-gateway-rollout
±changed
+5−4
claude-codechanged
llm-gateway-rollout
Every developer machine needs the gateway address and a credential. You can distribute them centrally through [managed settings](/docs/en/settings#settings-files), so developers co
Every developer machine needs the gateway address and a credential. You can distribute them centrally through [managed settings](/docs/en/managed-settings#delivery-mechanisms), so
Deliver the variables through the `env` block of a [managed settings file](/docs/en/settings#settings-files), pushed by MDM, registry policy, or configuration management:
Deliver the variables through the `env` block of a [managed settings file](/docs/en/managed-settings#delivery-mechanisms), pushed by MDM, registry policy, or configuration manageme
* WSL on managed Windows machines reads the Windows managed settings only when [`wslInheritsWindowsSettings`](/docs/en/settings#available-settings) is `true`
+5 −4 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
llm-gateway-protocol
±changed
+2−2
claude-codechanged
llm-gateway-protocol
On Claude Code v2.1.227 or later, your organization can keep [MCP tool search](/docs/en/mcp#scale-with-mcp-tool-search) on under this variable through [managed settings](/docs/en/s
On Claude Code v2.1.227 or later, your organization can keep [MCP tool search](/docs/en/mcp#scale-with-mcp-tool-search) on under this variable through [managed settings](/docs/en/m
The picker is the interactive model list that opens when a developer runs `/model` in Claude Code. Each discovered entry is labeled "From gateway" and uses `display_name` when prov
The picker is the interactive model list that opens when a developer runs `/model` in Claude Code. Each discovered entry is labeled "From gateway" and uses `display_name` when prov
+2 −2 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
llm-gateway-connect
±changed
+2−2
claude-codechanged
llm-gateway-connect
Administrators can distribute the gateway address and credential through [managed settings](/docs/en/settings#settings-files), device management, or an [`apiKeyHelper`](#rotate-cre
Administrators can distribute the gateway address and credential through [managed settings](/docs/en/managed-settings), device management, or an [`apiKeyHelper`](#rotate-credential
| `Your apiKeyHelper script is failing`
| `Your apiKeyHelper script is failing`
+2 −2 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
llm-gateway
±changed
+1−1
claude-codechanged
llm-gateway
3. Distribute the configuration through a [managed settings file](/docs/en/settings#settings-files) and your secrets tooling, so every machine receives the base URL and a credentia
3. Distribute the configuration through a [managed settings file](/docs/en/managed-settings#delivery-mechanisms) and your secrets tooling, so every machine receives the base URL an
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
large-codebases
±changed
+5−5
claude-codechanged
large-codebases
Managed policy CLAUDE.md files cannot be excluded, so organization-wide instructions always apply. You can set `claudeMdExcludes` at any [settings scope](/docs/en/settings#configur
Managed policy CLAUDE.md files cannot be excluded, so organization-wide instructions always apply. You can set `claudeMdExcludes` at any [settings scope](/docs/en/settings#where-se
* **Yourself only**: use `.claude/settings.local.json` at the repository root, which loads in every CLI session inside the repository regardless of starting directory. Relative pat
* **Everyone, enforced in every session**: set the rules in [managed settings](/docs/en/settings#settings-files), which user and project settings cannot override.
* **Yourself only**: use `.claude/settings.local.json` at the repository root, which loads in every CLI session inside the repository regardless of starting directory, except in th
+5 −5 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
jetbrains
±changed
+1−1
claude-codechanged
jetbrains
The **Diff tool** entry appears in `/config` only when Claude Code is connected to the IDE, so run `claude` from the JetBrains terminal or run [`/ide`](/docs/en/commands) first fro
The **Diff tool** entry appears in `/config` only when Claude Code is connected to the IDE, so run `claude` from the JetBrains terminal or run [`/ide`](/docs/en/commands) first fro
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
interactive-mode
±changed
+20−20
claude-codechanged
interactive-mode
By default, `Ctrl+W` deletes the previous word, stopping at punctuation such as `/`. Set [`keybindingFlavor`](/docs/en/settings#available-settings) to `"readline"` to make `Ctrl+W`
By default, `Ctrl+W` deletes the previous word, stopping at punctuation such as `/`. Set [`keybindingFlavor`](/docs/en/settings-reference#keybindingflavor) to `"readline"` to make
The [`vimInsertModeRemaps`](/docs/en/settings#available-settings) setting maps a two-key INSERT-mode sequence to Escape, so a mapping like `jj` returns you to NORMAL mode. Requires
The [`vimInsertModeRemaps`](/docs/en/settings-reference#viminsertmoderemaps) setting maps a two-key INSERT-mode sequence to Escape, so a mapping like `jj` returns you to NORMAL mod
Claude Code reads this setting from your user settings file, the `--settings` flag, and [managed settings](/docs/en/permissions#managed-settings) only. Entries in a project's `.cla
+20 −20 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
hooks
±changed
+7−7
claude-codechanged
hooks
* Claude Code also narrows your [`statusLine`](/docs/en/statusline), [`fileSuggestion`](/docs/en/settings#file-suggestion-settings), and [`subagentStatusLine`](/docs/en/statusline#
* Claude Code also disables plugins with a [`command` source](/docs/en/plugin-marketplaces#command-sources), including plugins force-enabled in managed settings `enabledPlugins`, u
See [Hook configuration](/docs/en/settings#hook-configuration).
* Claude Code also narrows your [`statusLine`](/docs/en/statusline), [`fileSuggestion`](/docs/en/settings-reference#filesuggestion), and [`subagentStatusLine`](/docs/en/statusline#
+7 −7 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
headless
±changed
+1−1
claude-codechanged
headless
The `--allowedTools` flag uses [permission rule syntax](/docs/en/settings#permission-rule-syntax). The trailing ` *` enables prefix matching, so `Bash(git diff *)` allows any comma
The `--allowedTools` flag uses [permission rule syntax](/docs/en/settings-reference#permission-rule-syntax). The trailing ` *` enables prefix matching, so `Bash(git diff *)` allows
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
google-vertex-ai
±changed
+1−1
claude-codechanged
google-vertex-ai
When you start the session on a specific Sonnet or Opus version, for example with `--model`, `ANTHROPIC_MODEL`, or the [`model` setting](/docs/en/settings), that version acts as th
When you start the session on a specific Sonnet or Opus version, for example with `--model`, `ANTHROPIC_MODEL`, or the [`model` setting](/docs/en/settings-reference#model), that ve
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
goal
±changed
+1−1
claude-codechanged
goal
Claude Code makes `/goal` available under the same [workspace trust rule as hooks in settings files](/docs/en/permissions#what-runs-before-you-trust-a-folder), because the evaluato
Claude Code makes `/goal` available under the same [workspace trust rule as hooks in settings files](/docs/en/permissions#what-runs-before-you-trust-a-folder), because the evaluato
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
glossary
±changed
+2−2
claude-codechanged
glossary
Learn more: [Server-managed settings](/docs/en/server-managed-settings) · [Settings files](/docs/en/settings#settings-files)
Learn more: [Server-managed settings](/docs/en/server-managed-settings) · [Settings files](/docs/en/settings#where-settings-live)
Learn more: [Settings files](/docs/en/settings#settings-files)
Learn more: [Settings files](/docs/en/settings#where-settings-live)
+2 −2 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
github-enterprise-server
±changed
+4−4
claude-codechanged
github-enterprise-server
The `extraKnownMarketplaces` setting pre-registers a marketplace so developers get it without manual setup. It works from [any settings file](/docs/en/settings#extraknownmarketplac
The `extraKnownMarketplaces` setting pre-registers a marketplace so developers get it without manual setup. It works from [any settings file](/docs/en/settings-reference#extraknown
* **Confirm the setting reaches each machine.** A managed settings file only takes effect on machines it's deployed to, for example through your device management system. See [mana
* **Confirm the setting reaches each machine.** A managed settings file only takes effect on machines it's deployed to, for example through your device management system. See [Depl
If your organization uses [managed settings](/docs/en/settings) to restrict which marketplaces developers can add, use the `hostPattern` source type to allow all marketplaces from
+4 −4 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
gateways
±changed
+1−1
claude-codechanged
gateways
Claude apps gateway is Anthropic's self-hosted gateway, included in the `claude` binary. It routes to Amazon Bedrock, Claude Platform on AWS, Google Cloud, Microsoft Foundry, or th
Claude apps gateway is Anthropic's self-hosted gateway, included in the `claude` binary. It routes to Amazon Bedrock, Claude Platform on AWS, Google Cloud, Microsoft Foundry, or th
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
fullscreen
±changed
+3−3
claude-codechanged
fullscreen
Run `/tui fullscreen` inside any Claude Code conversation. The CLI saves the [`tui` setting](/docs/en/settings#available-settings) and relaunches into fullscreen with your conversa
Run `/tui fullscreen` inside any Claude Code conversation. The CLI saves the [`tui` setting](/docs/en/settings-reference#tui) and relaunches into fullscreen with your conversation
Either one turns fullscreen rendering on. After a [failed fullscreen start](#fullscreen-renderer-didnt-finish-starting), Claude Code still honors the variable but not the setting.
For how the [`tui`](/docs/en/settings-reference#tui) setting and the variable combine when both are set, see the setting's entry. After a [failed fullscreen start](#fullscreen-rend
Separately from the base speed, Claude Code accelerates the scroll rate when you spin the wheel quickly, so a fast spin covers more distance than the same number of slow notches. T
+3 −3 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
feature-availability
±changed
+1−1
claude-codechanged
feature-availability
* [OpenTelemetry metrics](/docs/en/monitoring-usage) and the [managed settings file](/docs/en/settings#settings-files)
* [OpenTelemetry metrics](/docs/en/monitoring-usage) and the [managed settings file](/docs/en/managed-settings#delivery-mechanisms)
+1 −1 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
fast-mode
±changed
+2−2
claude-codechanged
fast-mode
The same connectivity message appears on an open network when the check reaches `api.anthropic.com` but presents a credential Anthropic rejects. A session whose resolved key is a g
The same connectivity message appears on an open network when the check reaches `api.anthropic.com` but presents a credential Anthropic rejects. A session whose resolved key is a g
By default, fast mode a user turns on in an interactive session persists across sessions. To change this, set `fastModePerSessionOptIn` to `true` in any [settings file](/docs/en/se
By default, fast mode a user turns on in an interactive session persists across sessions. To change this, set `fastModePerSessionOptIn` to `true` in any [settings file](/docs/en/se
+2 −2 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
errors
±changed
+15−15
claude-codechanged
errors
This happens in [Remote Control](/docs/en/remote-control) sessions, [background sessions](/docs/en/agent-view), and [agent team](/docs/en/agent-teams) teammate sessions. Claude Cod
This happens in [Remote Control](/docs/en/remote-control) sessions, [background sessions](/docs/en/agent-view), and [agent team](/docs/en/agent-teams) teammate sessions. Claude Cod
* To give yourself more time to reach that terminal, set [`dialogExpiry`](/docs/en/settings#available-settings) to a longer value or `"never"`
* To give yourself more time to reach that terminal, set [`dialogExpiry`](/docs/en/settings-reference#dialogexpiry) to a longer value or `"never"`
* For CI or automation where interactive login is not possible, configure an [`apiKeyHelper`](/docs/en/settings#available-settings) script that fetches a key at startup
+15 −15 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
env-vars
±changed
+345−345
claude-codechanged
env-vars
No line of the body moved in this read.
+345 −345 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
discover-plugins
±changed
+11−11
claude-codechanged
discover-plugins
`/plugin` opens an interactive panel in the terminal CLI. If Claude replies that `/plugin` isn't available in this environment, use the [plugin browser](/docs/en/desktop#install-pl
`/plugin` opens an interactive panel in the terminal CLI. If Claude replies that `/plugin` isn't available in this environment, use the [plugin browser](/docs/en/desktop#install-pl
Go to the **Discover** tab to see plugins from the marketplace you just added. When your administrator has allowlisted the marketplace via the [`pluginSuggestionMarketplaces`](
Go to the **Discover** tab to see plugins from the marketplace you just added. When your administrator has allowlisted the marketplace via the [`pluginSuggestionMarketplaces`](
See [Configuration scopes](/docs/en/settings#configuration-scopes) to learn more about scopes.
+11 −11 lines
Recorded here 21 Aug 2026 23:07 UTC
claude-code
devcontainer
±changed
+4−4
claude-codechanged
devcontainer
By default, the container's home directory is discarded on rebuild, so engineers must sign in again each time. Claude Code stores its authentication token, user settings, and sessi
By default, the container's home directory is discarded on rebuild, so engineers must sign in again each time. Claude Code stores its authentication token, user settings, and sessi
Claude Code reads `/etc/claude-code/managed-settings.json` on Linux and applies it at the highest precedence in the [settings hierarchy](/docs/en/settings#how-scopes-interact), so
Claude Code reads `/etc/claude-code/managed-settings.json` on Linux and applies it at the highest precedence in the [settings hierarchy](/docs/en/settings#settings-precedence), so
Because the Dockerfile lives in the repository, anyone with write access can change or remove this step. For policy that engineers cannot bypass by editing repository files, delive
+4 −4 lines
Recorded here 21 Aug 2026 23:07 UTC
Nothing on this page matches that. Press Enter to search every page of the ledger.