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
812pages tracked
765 changed this week · last read 23 Oct 2026
Claude Code CLI
228pages tracked
145 changed this week · last read 22 Oct 2026
Claude Documentation
280pages tracked
77 changed this week · last read 23 Oct 2026
Model Context Protocol
357pages tracked
171 changed this week · last read 22 Oct 2026
100 on this page
5,550 of the ledger's changes in claude-code. Show every change
ReadSourcePageWhatLines
10 Sep 2026
55 pages
+679 −383 lines
claude-code
analytics
±changed
+0−4
claude-codechanged
analytics
#### Tagging criteria
PRs are tagged as "with Claude Code" if they contain at least one line of code written during a Claude Code session. The system uses conservative matching: only code where there is
+0 −4 lines
Recorded here 10 Sep 2026 21:37 UTC
claude-code
amazon-bedrock
±changed
+3−3
claude-codechanged
amazon-bedrock
* As of v2.1.172, you only need to set `AWS_REGION` to override your AWS profile's region or when your profile has no region. Claude Code resolves the region in this order:
* You only need to set `AWS_REGION` to override your AWS profile's region or when your profile has no region. Claude Code resolves the region in this order:
Run `/status` to see the resolved region. When the region came from your AWS config files or the default fallback, Claude Code also notes the source in the `/status` output. On v
Run `/status` to see the resolved region. When the region came from your AWS config files or the default fallback, Claude Code also notes the source in the `/status` output.
Claude Code constructs the endpoint URL from the AWS region. As of v2.1.172, the region is resolved with the same precedence as [Amazon Bedrock above](#3-configure-claude-code); ea
+3 −3 lines
Recorded here 10 Sep 2026 21:37 UTC
claude-code
agents
±changed
+1−1
claude-codechanged
agents
* [Worktrees](/docs/en/worktrees) give each session a separate git checkout, so parallel sessions never edit the same files. Use them for sessions you run yourself. Agent view move
* [Worktrees](/docs/en/worktrees) give each session a separate git checkout, so parallel sessions never edit the same files. Use them for sessions you run yourself. A session you d
+1 −1 lines
Recorded here 10 Sep 2026 21:37 UTC
claude-code
agent-teams
±changed
+6−6
claude-codechanged
agent-teams
To start a team, ask Claude for teammates. Claude launches a teammate when it calls the [Agent tool](/docs/en/tools-reference) with a [`name`](/docs/en/sub-agents#subagent-names) w
If you want subagents instead, [turn agent teams off](#claude-spawns-teammates-instead-of-subagents).
To start a team, ask Claude for teammates. Claude launches a teammate when it calls the [Agent tool](/docs/en/tools-reference) with a [`name`](/docs/en/sub-agents#subagent-names) w
+6 −6 lines
Recorded here 10 Sep 2026 21:37 UTC
claude-code
advisor
±changed
+1−1
claude-codechanged
advisor
Fable 5.1 requires Claude Code v2.1.257 or later, and Fable 5 requires v2.1.170 or later. Both require [Fable access](/docs/en/model-config#work-with-fable).
Fable 5.1 requires Claude Code v2.1.257 or later. Both Fable models require [Fable access](/docs/en/model-config#work-with-fable).
+1 −1 lines
Recorded here 10 Sep 2026 21:37 UTC
claude-code
analytics
±changed
+3−3
claude-codechanged
analytics
| Plan | Dashboard URL | Includes
| ----------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------
| Plan | Dashboard URL | Includes | Read more |
| - | - | - | - |
| API (Claude Console) | [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | Usage metrics, spend tracking, team insights
+3 −3 lines
Upstream edited 10 Sep 2026 19:45 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
workflows
±changed
+1−1
claude-codechanged
workflows
`/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
`/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
+1 −1 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
vs-code
±changed
+5−3
claude-codechanged
vs-code
* **Model**: select **Switch model…** from the command menu to change the model mid-session. You can also click the model name at the bottom of the prompt box to open the same pick
* **Model**: select **Switch model…** from the command menu to change the model mid-session. You can also click the model name at the bottom of the prompt box to open the same pick
You can also hold `Shift` while dragging files into the prompt box to add them as attachments. Click the X on any attachment to remove it from context.
To attach an image, paste it from your clipboard into the prompt box. You can also hold `Shift` while dragging files into the prompt box to add them as attachments. Click the X on
Click the **Session history** button at the top of the Claude Code panel to access your conversation history. You can search by keyword or browse by time. Click any conversation to
+5 −3 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
settings-reference
±changed
+6−3
claude-codechanged
settings-reference
Cap the [effort level](/docs/en/model-config#adjust-effort-level) a session can use, leaving lower levels available. Any higher level runs at the cap instead, including one from `/
Cap the [effort level](/docs/en/model-config#adjust-effort-level) a session can use, leaving lower levels available. Any higher level runs at the cap instead, including one from `/
* **Effect on ultracode**: a cap below `xhigh` makes [ultracode](#ultracode) unavailable on the models the cap applies to
* **Type**: array of objects, each with `marketplace` and `plugin` strings
* **Type**: array of objects, each with `marketplace` and `plugin` strings. An entry can instead be a `"plugin@marketplace"` string such as `"telegram@claude-plugins-official"`, wh
+6 −3 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
remote-control
±changed
+1−1
claude-codechanged
remote-control
All traffic travels through the Anthropic API over TLS, the same transport security as any Claude Code session. The connection uses multiple short-lived credentials, each scoped to
All traffic travels through the Anthropic API over TLS, the same transport security as any Claude Code session. The connection uses multiple short-lived credentials, each scoped to
+1 −1 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
model-config
±changed
+10−2
claude-codechanged
model-config
When ultracode isn't available, for example when [workflows are turned off](/docs/en/workflows#turn-workflows-off), `--effort ultracode` sets `xhigh` effort only.
<span id="when-ultracode-is-available" />
Ultracode is unavailable when:
+10 −2 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
managed-settings
±changed
+3−3
claude-codechanged
managed-settings
| `allowedHttpHookUrls` | Claude Code enforces an empty [allowlist](/docs/en/settings-reference#allowedhttphookurls) until you fix the value. If only an individual entry is
| `httpHookAllowedEnvVars` | Claude Code enforces an empty [allowlist](/docs/en/settings-reference#httphookallowedenvvars) until you fix the value. If only an individual entry
| `allowedHttpHookUrls` | Claude Code enforces an empty managed [allowlist](/docs/en/settings-reference#allowedhttphookurls) until you fix the value, so an HTTP hook runs o
| `httpHookAllowedEnvVars` | Claude Code enforces an empty managed [allowlist](/docs/en/settings-reference#httphookallowedenvvars) until you fix the value, so a header variabl
Before v2.1.267, Claude Code dropped `allowedHttpHookUrls`, `httpHookAllowedEnvVars`, or `allowedChannelPlugins` whole when the value or any one entry was invalid, and behaved as i
+3 −3 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
errors
±changed
+50−7
claude-codechanged
errors
| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text`
| `the source file has the replacement character U+FFFD`
| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)`
```
+50 −7 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
cloud-environments
±changed
+4−4
claude-codechanged
cloud-environments
The agent proxy attaches a credential to a request when the request's host matches one you listed on that credential. Sessions can reach those hosts even when the environment's [ne
The agent proxy attaches a credential to a request when the request's host matches one you listed on that credential. Sessions can reach those hosts even when the environment's [ne
* **The Anthropic API and public package registries**: requests to `api.anthropic.com`, `registry.npmjs.org`, `jsr.io`, `npm.jsr.io`, `pypi.org`, `files.pythonhosted.org`, `index.c
* **The Anthropic API and public package registries**: `api.anthropic.com`, `registry.npmjs.org`, `jsr.io`, `npm.jsr.io`, `pypi.org`, `files.pythonhosted.org`, `index.crates.io`, a
* The hosts you listed on the environment's [API credentials](#add-api-credentials), except the [hosts the agent proxy skips](#requests-that-never-get-the-credential)
+4 −4 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
cli-reference
±changed
+1−1
claude-codechanged
cli-reference
| `--effort` | Set the [effort level](/docs/en/model-config#adjust-effort-level) for the current session. Options: `low`, `medium`, `high`, `xh
| `--effort` | Set the [effort level](/docs/en/model-config#adjust-effort-level) for the current session. Options: `low`, `medium`, `high`, `xh
+1 −1 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
artifacts
±changed
+1−1
claude-codechanged
artifacts
| Source file types | The published file must be `.html`, `.htm`, or `.md`. Markdown files render as styled HTML.
| Source file types | The published file must be `.html`, `.htm`, or `.md`, and must decode as UTF-8, or as little-endian UTF-16 by its byte-order mark. Markdown files render as st
+1 −1 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
agent-sdk/typescript
±changed
+1−1
claude-codechanged
agent-sdk/typescript
`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which runs the session at `xhigh` effort and turns on [ultra
`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/work
+1 −1 lines
Recorded here 10 Sep 2026 18:07 UTC
claude-code
monitoring-usage
±changed
+1−1
claude-codechanged
monitoring-usage
* When authenticated via OAuth, `user.email` is included in telemetry attributes. If this is a concern for your organization, work with your telemetry backend to filter or redact t
* When authenticated via OAuth, `user.email` is included in telemetry attributes, sent only to the OTel endpoint you configure, never to Anthropic. If this is a concern for your or
+1 −1 lines
Recorded here 10 Sep 2026 17:07 UTC
claude-code
workflows
±changed
+1−1
claude-codechanged
workflows
An `agent()` call resolves to `null` if you stop it mid-run or it hits an unrecoverable API error. `pipeline()` keeps that `null` in the results array, which is why the example end
An `agent()` call resolves to `null` if you stop it mid-run or it hits an unrecoverable API error. In [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode), the c
+1 −1 lines
Recorded here 10 Sep 2026 14:37 UTC
claude-code
plugin-marketplaces
±changed
+1−1
claude-codechanged
plugin-marketplaces
Paths resolve relative to the marketplace root, which is the directory containing `.claude-plugin/`. In the example above, `./plugins/my-plugin` points to `<repo>/plugins/my-plugin
Paths resolve relative to the marketplace root, which is the directory containing `.claude-plugin/`. In the example above, `./plugins/my-plugin` points to `<repo>/plugins/my-plugin
+1 −1 lines
Recorded here 10 Sep 2026 14:37 UTC
claude-code
model-config
±changed
+2−0
claude-codechanged
model-config
On Fable 5, Opus 4.8, and Opus 4.7, frontmatter effort also applies while the [hold on the model's default effort](#adjust-effort-level) is in effect. Before v2.1.267, the hold too
+2 −0 lines
Recorded here 10 Sep 2026 14:37 UTC
claude-code
fullscreen
±changed
+2−0
claude-codechanged
fullscreen
While you're scrolled up, a dim header row at the top of the conversation shows the most recent prompt that has scrolled above the view. Click the row to jump to that prompt.
+2 −0 lines
Recorded here 10 Sep 2026 14:37 UTC
claude-code
settings-reference
±changed
+6−2
claude-codechanged
settings-reference
An entry written with the trailing dot that marks a fully qualified domain name, such as `example.com.`, blocks the same connections as `example.com`.
When server-managed settings deliver the policy at launch, they take precedence over the helper's source and the helper doesn't run. If a later settings fetch reports the server-ma
When server-managed settings deliver the policy at launch, they take precedence over the helper's source and the helper doesn't run.
+6 −2 lines
Recorded here 10 Sep 2026 04:37 UTC
claude-code
server-managed-settings
±changed
+6−3
claude-codechanged
server-managed-settings
Every other key in the cached `env` block applies at startup. Once the server confirms the payload, and you approve it if it needs [security approval](#security-approval-dialogs),
Every other key in the cached `env` block applies at startup. Once the server confirms the payload, and you approve it if it needs [security approval](#security-approval-dialogs),
Clients signed in through a [Claude apps gateway](#platform-availability) wait for the startup fetch whether or not you set this. If the gateway answers an attended interactive lau
Clients signed in through a [Claude apps gateway](#platform-availability) wait for the startup fetch whether or not you set this, and handle a failed fetch as follows:
+6 −3 lines
Recorded here 10 Sep 2026 04:37 UTC
claude-code
managed-settings
±changed
+2−2
claude-codechanged
managed-settings
* A new or changed [`policyHelper`](/docs/en/settings-reference#policyhelper) entry takes effect at the next launch, except that a helper shadowed at launch by server-managed set
* A new or changed [`policyHelper`](/docs/en/settings-reference#policyhelper) entry takes effect at the next launch. If server-managed settings shadow the helper at that launch,
This table shows how Claude Code combines each kind of key under `"merge"`. The [`managedSourcesBehavior` entry](/docs/en/settings-reference#managedsourcesbehavior) names every key
This table shows how Claude Code combines each kind of key under `"merge"`. The [`managedSourcesBehavior` entry](/docs/en/settings-reference#managedsourcesbehavior) names every key
+2 −2 lines
Recorded here 10 Sep 2026 04:37 UTC
claude-code
self-hosted-environments-reference
±changed
+1−1
claude-codechanged
self-hosted-environments-reference
| `--use-anthropic-git-proxy` | `CLAUDE_RUNNER_USE_GIT_PROXY=1` | off | Clone via Anthropic's git proxy instead of custome
| `--use-anthropic-git-proxy` | `CLAUDE_RUNNER_USE_GIT_PROXY=1` | off | Clone via the [Anthropic git proxy](/docs/en/self-
+1 −1 lines
Recorded here 10 Sep 2026 04:07 UTC
claude-code
self-hosted-environments-deploy
±changed
+2−0
claude-codechanged
self-hosted-environments-deploy
The runner also reports the opt-in to Anthropic when it registers, printing `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` at startup. Each session
+2 −0 lines
Recorded here 10 Sep 2026 04:07 UTC
9 Sep 2026
84 pages
+2130 −948 lines
claude-code
settings-reference
±changed
+7−3
claude-codechanged
settings-reference
When a managed source on the machine sets `"gateway"`, Claude Code doesn't use a leftover login, API key, or `apiKeyHelper` credential. See [Administrator policy requires a Cloud g
Set the gateway URL the `/login` Cloud gateway screen connects to, so people reach your [cloud gateway](/docs/en/claude-apps-gateway) without typing its address. The screen has no
Set the gateway URL the `/login` Cloud gateway screen connects to, so people reach your [cloud gateway](/docs/en/claude-apps-gateway) without typing its address. The screen has no
+7 −3 lines
Recorded here 9 Sep 2026 23:07 UTC
claude-code
llm-gateway-rollout
±changed
+1−1
claude-codechanged
llm-gateway-rollout
Do not include `forceLoginMethod` or `forceLoginOrgUUID` in managed settings alongside a gateway credential. Either key, with any value, blocks `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH
Don't include `forceLoginMethod` or `forceLoginOrgUUID` in managed settings alongside a gateway credential. Either key, with any value, blocks `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_
+1 −1 lines
Recorded here 9 Sep 2026 23:07 UTC
claude-code
llm-gateway-protocol
±changed
+12−3
claude-codechanged
llm-gateway-protocol
Token-counting endpoints are the only optional ones: when they're absent, Claude Code falls back to counting context usage through the inference endpoint instead. Inference request
Token-counting endpoints are the only optional ones: when they're absent, Claude Code falls back to a character-based estimate of context usage.
Match on the path, not the full URL:
+12 −3 lines
Recorded here 9 Sep 2026 23:07 UTC
claude-code
errors
±changed
+34−1
claude-codechanged
errors
| `Not signed in to the Cloud gateway — run /login.`
| `Administrator policy requires a Cloud gateway sign-in on this machine`
| `Claude Code may not be enabled for your organization` after a Claude apps gateway sign-in
* If `/status` shows an `API key` row, an approved [`ANTHROPIC_API_KEY`](/docs/en/authentication#authentication-precedence) is the active credential and takes precedence over your
* If `/status` shows an `API key` row that isn't marked as not in use, an approved [`ANTHROPIC_API_KEY`](/docs/en/authentication#authentication-precedence) is the active credential
+34 −1 lines
Recorded here 9 Sep 2026 23:07 UTC
claude-code
claude-apps-gateway-on-aws
±changed
+4−2
claude-codechanged
claude-apps-gateway-on-aws
* **IAM role** with `bedrock:InvokeModel` and `bedrock:InvokeModelWithResponseStream`, attached as the ECS task role or bound via IAM Roles for Service Accounts (IRSA) on EKS
* **IAM role** with `bedrock:InvokeModel`, `bedrock:InvokeModelWithResponseStream`, and `bedrock:CountTokens`, attached as the ECS task role or bound via IAM Roles for Service Acco
"Action": ["bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream"],
"Action": ["bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream", "bedrock:CountTokens"],
+4 −2 lines
Recorded here 9 Sep 2026 23:07 UTC
claude-code
claude-apps-gateway-deploy
±changed
+40−31
claude-codechanged
claude-apps-gateway-deploy
Don't redirect requests to the gateway's device-authorization and token endpoints. Claude Code doesn't follow redirects on those requests, so an ingress rule that redirects them, s
Don't redirect requests to the gateway's device-authorization and token endpoints, for example with an HTTP-to-HTTPS or host-canonicalization rewrite at the ingress. Claude Code do
Once the gateway is serving, push `forceLoginMethod`, `forceLoginGatewayUrl`, and `parentSettingsBehavior: "merge"` to each developer's machine through managed settings, via MDM or
Once the gateway is serving, push `forceLoginMethod`, `forceLoginGatewayUrl`, and `parentSettingsBehavior: "merge"` to each developer's machine through managed settings, via MDM or
+40 −31 lines
Recorded here 9 Sep 2026 23:07 UTC
claude-code
claude-apps-gateway
±changed
+6−4
claude-codechanged
claude-apps-gateway
The Amazon Bedrock upstream needs an AWS principal with `bedrock:InvokeModel` and `bedrock:InvokeModelWithResponseStream` on both the `inference-profile/us.anthropic.*` ARNs
The Amazon Bedrock upstream needs an AWS principal with `bedrock:InvokeModel` and `bedrock:InvokeModelWithResponseStream` on both the `inference-profile/us.anthropic.*` ARNs
Supply the credential with IRSA on EKS, an ECS task role, or an EC2 instance profile rather than static keys. The [`upstreams` reference](/docs/en/claude-apps-gateway-config#
The developer presses Enter to connect. The [first-connect TLS fingerprint prompt](#connect-developers) still appears.
+6 −4 lines
Recorded here 9 Sep 2026 23:07 UTC
claude-code
authentication
±changed
+8−4
claude-codechanged
authentication
If you have an active Claude subscription but also have `ANTHROPIC_API_KEY` set in your environment, the API key takes precedence once approved. This can cause authentication failu
If your machine's [managed settings](/docs/en/managed-settings) set [`forceLoginMethod`](/docs/en/settings-reference#forceloginmethod) to `"gateway"` or set [`forceLoginGatewayUrl`
If you have an active Claude subscription but also have `ANTHROPIC_API_KEY` set in your environment, Claude Code uses the API key once you approve it. This can cause authentication
+8 −4 lines
Recorded here 9 Sep 2026 23:07 UTC
claude-code
sub-agents
±changed
+1−1
claude-codechanged
sub-agents
This works with built-in and custom subagents, and the choice persists when you resume the session: Claude Code restores the agent's system prompt, tool restrictions, and model alo
This works with built-in and custom subagents, and the choice persists when you resume the session: Claude Code restores the agent's tool restrictions and model along with the conv
+1 −1 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
settings-reference
±changed
+3−3
claude-codechanged
settings-reference
Select an [output style](/docs/en/output-styles) by name. An output style is a saved set of instructions that Claude Code adds to the system prompt to change Claude's role, tone, a
If you change this key during a session, Claude uses the new style starting with your next message. That message rebuilds the [prompt cache](/docs/en/prompt-caching#changing-output
Select an [output style](/docs/en/output-styles) by name. An output style is a saved set of instructions that changes Claude's role, tone, and output format, such as the built-in E
+3 −3 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
sessions
±changed
+2−2
claude-codechanged
sessions
* Agent: a session started with [`--agent`](/docs/en/sub-agents#invoke-subagents-explicitly) or the `agent` setting continues as that agent, keeping its system prompt, tool restric
* Agent: a session started with [`--agent`](/docs/en/sub-agents#invoke-subagents-explicitly) or the `agent` setting continues as that agent, keeping its tool restrictions and model
Not every configuration flag from the original launch is restored. If the session depended on `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model`, or directories added
Not every configuration flag from the original launch is restored. If the session depended on `--mcp-config`, `--settings`, `--plugin-dir`, `--fallback-model`, or directories added
+2 −2 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
sandboxing
±changed
+3−0
claude-codechanged
sandboxing
* **0-byte read-only files appear at `.claude` settings paths, and "Yes, and don't ask again" doesn't save**: on Linux and WSL2, the sandbox holds a write denial on a file that doe
Run `claude doctor` to list the leftover placeholder files. The [`Stale sandbox mask files left by a killed session`](/docs/en/errors#stale-sandbox-mask-files-left-by-a-killed-se
+3 −0 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
prompt-caching
±changed
+8−6
claude-codechanged
prompt-caching
| Layer | Content | Changes when |
| --------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| System prompt | Core instructions, tool definitions, output style | The set of loaded tool definitions changes, you switch output style, or Claude Code is upgraded |
| Project context | CLAUDE.md, auto memory, unscoped rules | Session starts, or after `/clear` or `/compact` |
| Conversation | Your messages, Claude's responses, tool results | Every turn |
+8 −6 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
plugins-reference
±changed
+3−1
claude-codechanged
plugins-reference
| `displayName` | string | Human-readable name shown in the `/plugin` picker and other UI surfaces. Falls back to `name` when omitted. Unlike `name`, may contain spaces and any
| `displayName` | string | Human-readable name shown in the `/plugin` picker and other UI surfaces. For a marketplace-installed plugin, a `displayName` on the [marketplace entr
On macOS and Linux, Claude Code also rejects a component path that contains a backslash anywhere in it, even when the path stays inside the plugin. Components declared with backsla
+3 −1 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
plugin-marketplaces
±changed
+12−5
claude-codechanged
plugin-marketplaces
**Reserved names**: the following marketplace names are reserved for official Anthropic use and can't be used by third-party marketplaces: `claude-code-marketplace`, `claude-code
Claude Code re-checks reserved names every time it loads a marketplace, not only when you add one. A marketplace that was registered under one of these names before the name beca
**Reserved names**: the following marketplace names are reserved for official Anthropic use and can't be used by third-party marketplaces: `claude-code-marketplace`, `claude-code
+12 −5 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
output-styles
±changed
+21−17
claude-codechanged
output-styles
Output styles change how Claude responds, not what Claude knows. They modify the system prompt to set role, tone, and output format. Use one when you keep re-prompting for the same
Output styles change how Claude responds, not what Claude knows. They set Claude's role, tone, and output format for every response. Use one when you keep re-prompting for the same
A custom output style adds your instructions to the system prompt and lets you choose whether to keep Claude Code's built-in software engineering instructions. Keep them when you'r
A custom output style gives Claude your own instructions and lets you choose whether to keep Claude Code's built-in software engineering instructions. Keep them when you're changin
Claude Code's **Default** output style is the existing system prompt, designed to help you complete software engineering tasks efficiently.
+21 −17 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
network-config
±changed
+1−0
claude-codechanged
network-config
| `*-review.googlesource.com` | Gerrit change lookup on `googlesource.com` checkouts. When a Claude Desktop Code tab session starts or resumes on a [trusted](/docs/en/perm
+1 −0 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
memory
±changed
+1−1
claude-codechanged
memory
For instructions you want at the system prompt level, use [`--append-system-prompt`](/docs/en/cli-reference#system-prompt-flags). This must be passed every invocation, so it's bett
For instructions you want at the system prompt level, use [`--append-system-prompt`](/docs/en/cli-reference#system-prompt-flags). You pass it at launch, so it's better suited to sc
+1 −1 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
glossary
±changed
+1−1
claude-codechanged
glossary
A configuration that modifies Claude's system prompt to change response behavior, tone, or format. Unlike [CLAUDE.md](#claude-md), which Claude Code delivers as a user message afte
A configuration that changes the instructions Claude Code gives Claude, to set response behavior, tone, or format. Unlike [CLAUDE.md](#claude-md), which adds project context alongs
+1 −1 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
errors
±changed
+118−2
claude-codechanged
errors
| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded`
| `path could not be checked`
| `its marketplace entry path does not stay inside the marketplace directory`
| `Plugin source path refused`
| `Command killed: its output file was replaced or could no longer be verified`
+118 −2 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
env-vars
±changed
+1−0
claude-codechanged
env-vars
* Have a resumed conversation [keep its recorded system prompt](/docs/en/cli-reference#system-prompt-flags-in-resumed-conversations); Claude Code rebuilds the prompt on every reque
+1 −0 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
discover-plugins
±changed
+1−1
claude-codechanged
discover-plugins
URL-based marketplaces have some limitations compared to Git-based marketplaces. If you encounter "path not found" errors when installing plugins, see [Troubleshooting](/docs/en/
URL-based marketplaces have some limitations compared to Git-based marketplaces. If plugin installs from a URL-based marketplace fail, see [Troubleshooting](/docs/en/plugin-marke
+1 −1 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
context-window
±changed
+2−2
claude-codechanged
context-window
* **Before you type anything**: CLAUDE.md, auto memory, MCP tool names, and skill descriptions all load into context. Your own setup may add more here, like an [output style](/docs
* **Before you type anything**: CLAUDE.md, auto memory, MCP tool names, and skill descriptions all load into context. Your own setup may add more here, like an [output style](/docs
| System prompt and output style | Unchanged; not part of message history
| System prompt and output style | Both still apply
+2 −2 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
cli-reference
±changed
+18−8
claude-codechanged
cli-reference
| `--system-prompt-snapshot` | Pass `off` to rebuild the system prompt on every request instead of reusing the prompt [recorded on the conversation's first req
Claude Code provides four flags for customizing the system prompt. All four work in both interactive and non-interactive modes.
Claude Code provides five flags for customizing the system prompt. Four set its text, and with `--system-prompt-snapshot` you control whether a conversation keeps the text it start
| Flag | Behavior | Example |
| :---------------------------- | :------------------------------------------ | :------------------------------------------------------ |
+18 −8 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
claude-directory
±changed
+8−8
claude-codechanged
claude-directory
contains: [<><A href="/docs/en/permissions">permissions</A>: allow, deny, or prompt before Claude uses specific tools or commands</>, <><A href="/docs/en/hooks">hooks</A>
contains: [<><A href="/docs/en/permissions">permissions</A>: allow, deny, or prompt before Claude uses specific tools or commands</>, <><A href="/docs/en/hooks">hooks</A>
when: 'Files read at startup; the style you select with outputStyle is added to the system prompt every turn',
when: 'Files read at startup; the style you select with outputStyle applies to every response',
oneLiner: 'Custom system-prompt sections that adjust how Claude works',
+8 −8 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
claude-code-on-the-web
±changed
+2−2
claude-codechanged
claude-code-on-the-web
Claude Code computes these diffs, including the per-file diffs shown as Claude edits, from raw git blob content, so diff drivers and `textconv` filters configured in the repository
Claude Code computes these diffs, including the per-file diffs shown as Claude edits, from raw git blob content, so diff drivers and `textconv` filters configured in the repository
Cloud sessions stop after a period of inactivity and the session's VM is reclaimed. On the web, the session is marked expired in the session list.
Cloud sessions stop after a period of inactivity and the session's VM is reclaimed. A session counts as inactive while it waits for you to approve an [MCP connector](/docs/en/cloud
+2 −2 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
agent-view
±changed
+1−1
claude-codechanged
agent-view
When the backgrounded session later resumes or restarts, Claude Code restores the agent's system prompt and tool restrictions. It searches the session's own directory for the agent
When the backgrounded session later resumes or restarts, Claude Code restores the agent and its tool restrictions; for its system prompt, see [System prompt flags in resumed conver
+1 −1 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
agent-sdk/typescript
±changed
+67−67
claude-codechanged
agent-sdk/typescript
| Property | Type | Default
| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------- | :----------------------
| `abortController` | `AbortController` | `new AbortController()`
| `additionalDirectories` | `string[]` | `[]`
| `agent` | `string` | `undefined`
+67 −67 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
agent-sdk/modifying-system-prompts
±changed
+10−2
claude-codechanged
agent-sdk/modifying-system-prompts
Output styles, `append`, and a custom prompt string each change the system prompt directly. CLAUDE.md takes a different path: the SDK reads it and injects its content into the conv
`append` and a custom prompt string each change the system prompt directly, and an output style changes the instructions Claude Code gives Claude for every response. CLAUDE.md take
Output styles are saved configurations that modify Claude's system prompt. They're stored as markdown files and can be reused across sessions and projects.
Output styles are saved sets of instructions that change Claude's role, tone, and output format. They're stored as markdown files and can be reused across sessions and projects.
+10 −2 lines
Recorded here 9 Sep 2026 22:37 UTC
claude-code
vs-code
±changed
+11−2
claude-codechanged
vs-code
New sessions receive AI-generated titles based on your first message. Hover over a session to reveal rename and archive actions: rename to give it a descriptive title, or archive t
* **Session titles**: new sessions receive AI-generated titles based on your first message.
* **Rename and archive**: hover over a session to reveal these actions. Rename to give it a descriptive title, or archive to move it to the **Archived sessions** group at the botto
By default, a session with no activity for 14 days moves to **Archived sessions** automatically, unless it is open, unread, or in a [group](#organize-sessions-into-groups). Automat
+11 −2 lines
Recorded here 9 Sep 2026 21:07 UTC
claude-code
settings-reference
±changed
+40−13
claude-codechanged
settings-reference
| [`maxEffortLevel`](#maxeffortlevel) | Cap the [effort level](/docs/en/model-config#adjust-effort-level) for ever
| [`modelSettings`](#modelsettings) | Keep a saved [effort level](/docs/en/model-config#adjust-effort-level) per
| [`modelSettings`](#modelsettings) | Keep a saved [effort level](/docs/en/model-config#adjust-effort-level) per
You don't usually edit this key by hand. Run `/advisor` to open a picker that shows the current choice, the models that can advise, and **No advisor**. Claude Code saves your pick
You don't usually edit this key by hand. Run `/advisor` to open a picker that shows the current choice, the models that can advise, and **No advisor**. Claude Code saves your pick
+40 −13 lines
Recorded here 9 Sep 2026 21:07 UTC
claude-code
remote-control
±changed
+3−1
claude-codechanged
remote-control
* **Forwarded dialogs expire**: Claude Code keeps permission prompts and `AskUserQuestion` questions open until you answer them. When Claude Code forwards another kind of dialog to
* **Forwarded dialogs expire**: Claude Code keeps permission prompts and `AskUserQuestion` questions open until you answer them. When Claude Code forwards another kind of dialog to
* **The Fable usage-credits consent prompt isn't forwarded**: Claude Code shows the mid-session [Fable usage-credits consent prompt](/docs/en/model-config#fable-and-usage-credits)
* `/advisor`, from v2.1.260: pass the model as an argument, for example `/advisor opus`, or pass `off` to turn the advisor off. Both forms apply to the current session only and l
+3 −1 lines
Recorded here 9 Sep 2026 21:07 UTC
claude-code
model-config
±changed
+8−6
claude-codechanged
model-config
Typing `/model <name>` directly behaves like `Enter`. A model set with `/model` in [non-interactive mode](/docs/en/headless), with the `-p` flag, applies to the current session onl
Typing `/model <name>` directly behaves like `Enter`. If you set a model with `/model` in [non-interactive mode](/docs/en/headless), with the `-p` flag, your choice applies to the
Your organization can cap the [effort level](#adjust-effort-level) in two ways. On a Claude Enterprise plan, organization admins set per-role effort limits, described below. On any
The plan-mode Opus phase uses the same context window as the `opus` model setting. On subscription tiers where Opus is [automatically upgraded to 1M context](#extended-context), `o
+8 −6 lines
Recorded here 9 Sep 2026 21:07 UTC
claude-code
managed-settings
±changed
+1−0
claude-codechanged
managed-settings
* [`maxEffortLevel`](/docs/en/settings-reference#maxeffortlevel), where the lowest cap in any admin source applies. If a developer sets a lower cap in their own settings or with `-
+1 −0 lines
Recorded here 9 Sep 2026 21:07 UTC
claude-code
env-vars
±changed
+1−1
claude-codechanged
env-vars
| `CLAUDE_CODE_EFFORT_LEVEL` | Set the effort level for supported models. Values: `low`, `medium`, `high`, `xhigh`, `max`, or `auto` to use the model d
| `CLAUDE_CODE_EFFORT_LEVEL` | Set the effort level for supported models. Values: `low`, `medium`, `high`, `xhigh`, `max`, or `auto` to use the model d
+1 −1 lines
Recorded here 9 Sep 2026 21:07 UTC
claude-code
commands
±changed
+1−1
claude-codechanged
commands
| `/advisor [model\|off]` | Enable or disable the [advisor tool](/docs/en/advisor), which consu
| `/advisor [model\|off]` | Enable or disable the [advisor tool](/docs/en/advisor), which consu
+1 −1 lines
Recorded here 9 Sep 2026 21:07 UTC
claude-code
advisor
±changed
+14−3
claude-codechanged
advisor
The command confirms with `Advisor set to` followed by the advisor model name. Your selection is saved to `advisorModel` in your user settings and persists across sessions.
The command confirms with `Advisor set to` followed by the advisor model name. Your selection is saved to `advisorModel` in your user settings and persists across sessions, except
The command also works where there is no terminal picker: in [non-interactive mode](/docs/en/headless) with `-p`, in the Agent SDK, in the desktop app, and over [Remote Control](/d
+14 −3 lines
Recorded here 9 Sep 2026 21:07 UTC
claude-code
admin-setup
±changed
+8−1
claude-codechanged
admin-setup
| [Effort cap](/docs/en/settings-reference#maxeffortlevel) | Cap the [effort level](/docs/en/model-config#adjust-effort-level) for every model or
Organizations whose members authenticate through claude.ai or the Anthropic API can also govern models without deploying settings: [organization model restrictions](/docs/en/model-
If your members sign in through claude.ai or the Anthropic API and you're on a Claude Enterprise plan, you can also govern models from your organization's admin settings without de
* [Organization model restrictions](/docs/en/model-config#organization-model-restrictions): disable individual models. Enforced server-side.
+8 −1 lines
Recorded here 9 Sep 2026 21:07 UTC
claude-code
sub-agents
±changed
+9−12
claude-codechanged
sub-agents
Set `permissionMode` to choose the permission mode a subagent runs in. Use the modes' config values, so Manual mode is `default`. If you leave it unset, the subagent inherits the m
Set `permissionMode` to choose the permission mode a subagent runs in. Use the modes' config values, so Manual mode is `default`. If you leave it unset, the subagent inherits the m
The main conversation's permission mode decides whether Claude Code uses the value you set:
+9 −12 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
settings-reference
±changed
+2−2
claude-codechanged
settings-reference
List the tool uses Claude Code blocks. Use it for files that hold API keys, secrets, or environment values: Claude Code excludes matching files from file discovery and search resul
List the tool uses Claude Code blocks. Use it for files that hold API keys, secrets, or environment values: Claude Code excludes matching files from file discovery and search resul
Tool names accept glob patterns, so `"*"` denies every tool and `"mcp__*"` denies every MCP tool. Claude Code ignores a deny rule for the [`EndConversation`](/docs/en/tools-referen
Tool names accept glob patterns, so `"*"` denies every tool and `"mcp__*"` denies every MCP tool. Claude Code ignores a deny rule for the [`EndConversation`](/docs/en/tools-referen
+2 −2 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
settings-example
±changed
+6−5
claude-codechanged
settings-example
One team's shared settings, committed to the repository so everyone who clones it gets the same permissions, hooks, telemetry, and plugin marketplace. Save a file like this at `.cl
One team's shared settings, committed to the repository so everyone who clones it gets the same permissions, hooks, telemetry, and plugin marketplace. Save a file like this at `.cl
* **Rules match the command and path as written.** `Bash(git push *)` doesn't match [`git -C . push`](/docs/en/permissions#bash-rule-limits). `Read(./.env)` on its own stops the fi
// Always confirm before pushing
// Confirm before git push commands
+6 −5 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
server-managed-settings
±changed
+1−1
claude-codechanged
server-managed-settings
This example enforces a permission deny list, prevents users from bypassing permissions, and restricts permission rules to those defined in managed settings:
This example enforces a permission deny list, prevents users from bypassing permissions, and restricts permission rules to those defined in managed settings. The `Bash(curl *)`
+1 −1 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
self-hosted-environments-reference
±changed
+11−7
claude-codechanged
self-hosted-environments-reference
| `--configure-git` | `SELF_HOSTED_RUNNER_CONFIGURE_GIT=1` | off | Write global git identity and enable Anthropic com
| `--configure-git` | `SELF_HOSTED_RUNNER_CONFIGURE_GIT=1` | off | At startup, write global git identity, enable Anth
| `--kill-session-after-min <n>` | `SELF_HOSTED_RUNNER_MAX_LIFETIME_MS` | `0` | Terminate a session child once it has lived N minu
| `--kill-session-after-min <n>` | `SELF_HOSTED_RUNNER_MAX_LIFETIME_MS` | `0` | Limit a session to N minutes wall-clock, as a safe
| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | Bounds how long a `--kill-session-after-min` kill is deferred while waiting for an in-flight turn to finish
+11 −7 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
self-hosted-environments-deploy
±changed
+16−4
claude-codechanged
self-hosted-environments-deploy
* `push.negotiate = true`, so git asks your git host which commits it already has before packing a push. Requires Claude Code v2.1.257 or later.
* `core.hooksPath` pointing at a runner-managed hooks directory. Its `commit-msg` and `prepare-commit-msg` hooks add a `Co-authored-by:` trailer for the session's creator to each c
* **For the first `n` minutes**: the runner serves its sessions normally and keeps enforcing `--startup-timeout-min` and `--kill-session-after-min`. If you also set [`--release-idl
* **For the first `n` minutes**: the runner serves its sessions normally and keeps enforcing `--startup-timeout-min` and `--kill-session-after-min`. If you also set [`--release-idl
Anthropic calls connector tools, such as GitHub, Slack, Linear, and the other claude.ai connectors, from its own infrastructure rather than from your runner, so when Claude uses a
+16 −4 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
self-hosted-environments-configuration
±changed
+9−7
claude-codechanged
self-hosted-environments-configuration
* `completed`: a clean exit, including a session archived or deleted while the child was still connected.
* `failed`: a child crash or a setup failure after spawn.
* `interrupted`: an idle release, startup timeout, server deassign, drain, or watchdog kill.
* `abandoned`: reserved for sessions another runner claimed; the hook doesn't currently fire in that case.
+9 −7 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
security
±changed
+1−1
claude-codechanged
security
* **Network command approval**: Commands that fetch content from the web such as `curl` and `wget` are not auto-approved by default. In Manual mode they prompt like any other non-r
* **Network command approval**: Commands that fetch content from the web such as `curl` and `wget` are not auto-approved by default. In Manual mode they prompt like any other non-r
+1 −1 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
remote-control
±changed
+1−4
claude-codechanged
remote-control
* **The message doesn't say to contact your organization admin**: your organization has a HIPAA configuration that is incompatible with Remote Control, and `/status` lists `HIPAA`
### "Remote Control isn't available for your organization due to its compliance policy"
Your organization has a data retention or compliance configuration that is incompatible with Remote Control; the parenthetical at the end of the message names it. In this state the
+1 −4 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
permissions
±changed
+20−4
claude-codechanged
permissions
Write the command you want Claude to run without asking, and replace the parts that vary with `*`. With this configuration, Claude Code runs npm scripts and git commits without ask
Write the command you want Claude to run without asking, and replace the parts that vary with `*`. With this configuration, Claude Code runs npm scripts and git commits without ask
Bash rules match the whole command text, with `*` standing in for any text. [Wildcard patterns](#wildcard-patterns) shows which commands each rule shape matches and where to put th
Bash rules match the whole command text, with `*` standing in for any text. [Wildcard patterns](#wildcard-patterns) shows which commands each rule shape matches and where to put th
+20 −4 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
permission-modes
±changed
+2−2
claude-codechanged
permission-modes
* Pushing to any branch of the repository you're working in, including the default branch. A non-default branch whose name marks it as a deploy or publication target, such as `prod
* Pushing to any branch of the repository you're working in, including the default branch. A non-default branch whose name marks it as a deploy or publication target, such as `prod
Pushing to any branch of the repository you're working in and creating a pull request that matches your request run without a prompt, unless the push or pull request falls under th
Pushing to any branch of the repository you're working in and creating a pull request that matches your request run without a prompt, unless the push or pull request falls under th
+2 −2 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
mcp
±changed
+7−3
claude-codechanged
mcp
Some services still expose only an SSE endpoint. Use the same command as the HTTP transport, with `--transport sse`:
Some services still expose only an SSE endpoint. Add these with the same `claude mcp add --transport http <name> <url>` command as [an HTTP server](#option-1-add-a-remote-http-serv
On an earlier version, or to connect over SSE directly, pass `--transport sse` instead:
A URL means the server is remote. For an `https://` endpoint, add it with `--transport http`, or with `--transport sse` when the instructions say the endpoint uses SSE. For a `wss:
+7 −3 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
managed-settings
±changed
+5−0
claude-codechanged
managed-settings
| `allowedHttpHookUrls` | Claude Code enforces an empty [allowlist](/docs/en/settings-reference#allowedhttphookurls) until you fix the value. If only an individual entry is
| `httpHookAllowedEnvVars` | Claude Code enforces an empty [allowlist](/docs/en/settings-reference#httphookallowedenvvars) until you fix the value. If only an individual entry
| `allowedChannelPlugins` | Claude Code enforces an empty allowlist until you fix the value, so no channel plugin passed to `--channels` is admitted. If only an individual en
Before v2.1.267, Claude Code dropped `allowedHttpHookUrls`, `httpHookAllowedEnvVars`, or `allowedChannelPlugins` whole when the value or any one entry was invalid, and behaved as i
+5 −0 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
hooks-guide
±changed
+1−1
claude-codechanged
hooks-guide
| `StopFailure` | error type
| `StopFailure` | error type
+1 −1 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
hooks
±changed
+4−2
claude-codechanged
hooks
| `StopFailure` | error type
| `StopFailure` | error type
Matching `StopFailure` on `cloud_credential_error` requires Claude Code v2.1.267 or later, the first version that reports credential-load failures under that value rather than `ser
| `error` | Error type: `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model
+4 −2 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
headless
±changed
+3−3
claude-codechanged
headless
| `max_retries` | integer | total retries permitted
| `max_retries` | integer | total retries permitted for this failure's cause, which can be fewer than the session-wide budget
| `error_status` | integer or null | HTTP status code, or `null` for connection errors with no HTTP response
| `error_status` | integer or null | HTTP status code of the failed attempt, or `null` when the attempt got no HTTP response from the API
| `error` | string | error category: `authentication_failed`, `oauth_org_not_allowed`, `billing_error`, `rate_limit`, `overloaded`, `invalid_request`, `model_not
+3 −3 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
errors
±changed
+177−15
claude-codechanged
errors
| `Could not load AWS credentials` / `Could not load Google Cloud credentials`
| `Could not load the default credentials` on Google Cloud's Agent Platform
| `Timed out after 60s waiting for AWS`
| `A request to AWS timed out. Check your network and proxy settings, then try again.`
| `Could not load the default credentials` on Google Cloud's Agent Platform
+177 −15 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
debug-your-config
±changed
+1−1
claude-codechanged
debug-your-config
| `Bash(rm *)` deny rule doesn't block `/bin/rm` or `find -delete` | Prefix rules match the literal command string, not the underlying executable
| `Bash(rm *)` deny rule doesn't block `/bin/rm` or `find -delete` | Bash rules match the literal command string, not the underlying executable; see [what a Bash rule doesn't m
+1 −1 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
cli-reference
±changed
+1−1
claude-codechanged
cli-reference
| `--disallowedTools`, `--disallowed-tools` | Deny rules. A bare tool name removes the matching tools from Claude's context: `"Edit"` removes Edit, `"*"` removes every tool,
| `--disallowedTools`, `--disallowed-tools` | Deny rules. A bare tool name removes the matching tools from Claude's context: `"Edit"` removes Edit, `"*"` removes every tool,
+1 −1 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
changelog
±changed
+56−0
claude-codechanged
changelog
<Update label="2.1.267" description="September 9, 2026">
* Added `maxEffortLevel` setting (top-level or per model under `modelSettings`): caps the effort level on every provider, including Bedrock, Vertex and Foundry; users can still p
* Added `--system-prompt-snapshot off` to render the system prompt fresh on every request instead of reusing the conversation's recorded prompt (for iterating on prompt text)
* Fixed Cowork scheduled tasks in the cloud failing at startup for organizations whose managed settings require sandboxing
+56 −0 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
auto-mode-config
±changed
+4−2
claude-codechanged
auto-mode-config
If you want a human checkpoint before every push or pull request, add permission rules: the [recipes below](#add-a-human-checkpoint) keep auto mode on for everything else.
If you want a human checkpoint before Claude's push and pull request commands, add permission rules: the [recipes below](#add-a-human-checkpoint) keep auto mode on for everything e
These rules match commands that begin with `git push` or `gh pr create`. A push Claude writes another way, such as `git -C <dir> push` or `git -c <key>=<value> push`, [doesn't matc
| Prompt before the action | `permissions.ask` | Always prompts for content-scoped rules like the recipe above. The classifier can
+4 −2 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
amazon-bedrock
±changed
+17−0
claude-codechanged
amazon-bedrock
Except when you authenticate with an Amazon Bedrock API key, the [setup wizard](#sign-in-with-bedrock) applies the same limit to each AWS call it makes while verifying your credent
### Certificate errors behind a TLS-inspecting proxy
Claude Code applies your [CA certificate store](/docs/en/network-config#ca-certificate-store) configuration to its requests to AWS, including:
+17 −0 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
agent-sdk/typescript
±changed
+11−6
claude-codechanged
agent-sdk/typescript
| `disallowedTools` | `string[]` | `[]`
| `disallowedTools` | `string[]` | `[]`
| `permissionMode` | No | Permission mode for tool execution within this agent. See [`PermissionMode`](#permissionmode)
| `permissionMode` | No | Permission mode for tool execution within this agent. The [subagent inheritance rules](/docs/en/agent-sdk/permissions#available
`SDKAssistantMessageError` is one of: `'authentication_failed'`, `'oauth_org_not_allowed'`, `'account_on_hold'`, `'billing_error'`, `'rate_limit'`, `'overloaded'`, `'invalid_reques
+11 −6 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
agent-sdk/subagents
±changed
+1−1
claude-codechanged
agent-sdk/subagents
| `permissionMode` | `PermissionMode` | No | Permission mode for tool execution within this agent
| `permissionMode` | `PermissionMode` | No | Permission mode for tool execution within this agent. The [subagent inheritance rules
+1 −1 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
agent-sdk/python
±changed
+3−3
claude-codechanged
agent-sdk/python
| `disallowed_tools` | `list[str]` | `[]` | Tools to deny. A bare
| `disallowed_tools` | `list[str]` | `[]` | Tools to deny. A bare
| `permissionMode` | No | Permission mode for tool execution within this agent. See [`PermissionMode`](#permissionmode)
| `permissionMode` | No | Permission mode for tool execution within this agent. The [subagent inheritance rules](/docs/en/agent-sdk/permissions#available-modes) decide when
"mode": "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan" | None, # Deprecated; ignored. Subagents inherit the parent session's permission mode; ag
+3 −3 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
agent-sdk/permissions
±changed
+7−7
claude-codechanged
agent-sdk/permissions
| Option | Effect
| :-------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------
| `allowed_tools=["Read", "Grep"]` | `Read` and `Grep` are auto-approved. Other tools not listed here still exist and fall through to the permission mode and `canUseTool`.
| `disallowed_tools=["Bash"]` | The `Bash` tool definition is removed from the request. Claude does not see the tool and cannot attempt it.
| `disallowed_tools=["Bash(rm *)"]` | `Bash` stays available. Calls matching `rm *` are denied in every permission mode, including `bypassPermissions`. Other `Bash` calls fall thro
+7 −7 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
agent-sdk/mcp
±changed
+3−1
claude-codechanged
agent-sdk/mcp
The SDK applies the same MCP output limit as Claude Code. When a tool result is larger than 25,000 tokens, the full output is saved to a file and the tool result is replaced with a
The SDK applies the same MCP output limit as Claude Code. When a tool result with no image content is larger than 25,000 tokens, Claude Code saves the output to a file and replaces
Raise the limit with the [`MAX_MCP_OUTPUT_TOKENS`](/docs/en/env-vars) environment variable. See [MCP output limits and warnings](/docs/en/mcp#mcp-output-limits-and-warnings) for th
+3 −1 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
agent-sdk/custom-tools
±changed
+6−6
claude-codechanged
agent-sdk/custom-tools
| Option | Layer | Effect
| :------------------------ | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------
| `tools: ["Read", "Grep"]` | Availability | Only the listed built-ins are in Claude's context. Unlisted built-ins are removed. MCP tools are unaffected.
| `tools: []` | Availability | All built-ins are removed. Claude can only use your MCP tools.
| allowed tools | Permission | Listed tools run without a permission prompt. Other unlisted tools remain available; calls go through the [permission flow](/docs/en/ag
+6 −6 lines
Recorded here 9 Sep 2026 20:37 UTC
claude-code
interactive-mode
±changed
+18−0
claude-codechanged
interactive-mode
## Issue reference links
When Claude mentions an issue as `owner/repo#123`, you can click the reference to open it, as long as your terminal supports hyperlinks. If Claude Code doesn't detect hyperlink sup
You get a link only for the two-part `owner/repo#123` form. These stay plain text:
+18 −0 lines
Recorded here 9 Sep 2026 20:07 UTC
claude-code
agent-sdk/streaming-output
±changed
+8−4
claude-codechanged
agent-sdk/streaming-output
By default, the Agent SDK yields complete `AssistantMessage` objects after Claude finishes generating each response. To receive incremental updates as text and tool calls are gener
By default, the Agent SDK yields a complete `AssistantMessage` for each non-empty content block, such as a text block or a tool call, after Claude finishes generating that block. T
user_message_uuid?: string;
Claude Code sets `user_message_uuid` on the turn's first non-ping stream event, and again when the message the turn is answering changes, under the conditions in [`user_message_uui
+8 −4 lines
Recorded here 9 Sep 2026 20:07 UTC
claude-code
agent-sdk/agent-loop
±changed
+19−7
claude-codechanged
agent-sdk/agent-loop
2. **Evaluate and respond.** Claude evaluates the current state and determines how to proceed. It may respond with text, request one or more tool calls, or both. The SDK yields an
2. **Evaluate and respond.** Claude evaluates the current state and determines how to proceed. It may respond with text, request one or more tool calls, or both. The SDK yields one
2. **Turn 2:** Claude calls `Read` on `auth.ts` and `auth.test.ts`. The SDK returns the file contents and yields an `AssistantMessage`.
3. **Turn 3:** Claude calls `Edit` to fix `auth.ts`, then calls `Bash` to re-run `npm test`. All three tests pass. The SDK yields an `AssistantMessage`.
2. **Turn 2:** Claude calls `Read` on `auth.ts` and `auth.test.ts`. The SDK yields an `AssistantMessage` for each call and returns the file contents.
+19 −7 lines
Recorded here 9 Sep 2026 20:07 UTC
claude-code
workflows
±changed
+10−2
claude-codechanged
workflows
| `Enter` or `→` | Drill into the selected phase, then into an agent to read its prompt, recent tool calls, and result |
| `Enter` or `→` | Drill into the selected phase, then into an agent's detail. In the detail, `Enter` expands or collapses it |
The agent detail lists the agent's prompt, its recent tool calls, and its result. Each call shows its state, such as still running or failed. When the agent keeps a task list of it
+10 −2 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
tools-reference
±changed
+2−1
claude-codechanged
tools-reference
* When Claude runs `cd` in the main session, the new working directory carries over to later Bash commands as long as it stays inside the project directory or an [additional workin
* When Claude runs `cd` in the main session, the new working directory carries over to later Bash commands as long as it stays inside the project directory or an [additional workin
* Subagent sessions never carry over working directory changes.
+2 −1 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
sub-agents
±changed
+7−3
claude-codechanged
sub-agents
The second filter applies to subagents running in the background. Apart from `Agent` and `ExitPlanMode`, which follow the first filter's conditions wherever the subagent runs, a ba
The second filter applies to subagents running in the background. Apart from `Agent` and `ExitPlanMode`, which follow the first filter's conditions wherever the subagent runs, a ba
[`ListAgents`](/docs/en/cross-session-messaging) follows these filters like any built-in tool: a foreground subagent inherits it in sessions where cross-session messaging is enable
Background subagents run with a [smaller built-in tool set](#available-tools) than foreground subagents, except for conversation forks, and they surface every permission prompt in
+7 −3 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
settings-reference
±changed
+9−5
claude-codechanged
settings-reference
Set the deadline for dialogs Claude Code [forwards to a remote client](/docs/en/remote-control#limitations), such as a Remote Control or SDK host, for the approval dialog for a [he
Set the deadline for dialogs Claude Code [forwards to a remote client](/docs/en/remote-control#limitations), such as a Remote Control or SDK host, and for the approval dialog for a
Show or hide the turn duration message after each response, such as "Cooked for 1m 6s". Appears in `/config` as **Show turn duration**.
Show or hide the turn duration message after each response, such as "Cooked for 1m 6s · done 6:05 PM". The clock after "done" shows when the turn finished; [`timeFormat`](#timeform
Some terminals can show a progress indicator on the tab or in the taskbar for the program running in them. While Claude is working, Claude Code reports an in-progress state to the
+9 −5 lines
Recorded here 9 Sep 2026 19:37 UTC
Nothing on this page matches that. Press Enter to search every page of the ledger.