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
757 changed this week · last read 22 Oct 2026
Claude Code CLI
228pages tracked
151 changed this week · last read 22 Oct 2026
Claude Documentation
279pages tracked
76 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,527 of the ledger's changes in claude-code. Show every change
ReadSourcePageWhatLines
1 Sep 2026
39 pages
+462 −205 lines
claude-code
zero-data-retention
±changed
+3−3
claude-codechanged
zero-data-retention
ZDR covers model inference calls made through Claude Code on Claude for Enterprise. When you use Claude Code in your terminal, the prompts you send and the responses Claude generat
ZDR covers model inference calls made through Claude Code on Claude for Enterprise. When you use Claude Code in your terminal, the prompts you send and the responses Claude generat
Claude Fable 5 is not available for organizations with zero data retention enabled. This model class [requires data retention](https://platform.claude.com/docs/en/manage-claude/api
Claude Fable 5.1 and Fable 5 are [Covered Models](https://support.claude.com/en/articles/15425695-covered-models) that [require data retention](https://platform.claude.com/docs/en/
Other models remain available under ZDR. Fable 5 is not the default model, and the `best` alias, which resolves to Fable 5 where it is available, resolves to Opus for organizations
+3 −3 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
vs-code
±changed
+1−1
claude-codechanged
vs-code
* **Errors and model prompts**: the extension announces errors in the conversation, and announces when the [usage-credits consent prompt](/docs/en/model-config#fable-5-and-usage-cr
* **Errors and model prompts**: the extension announces errors in the conversation, and announces when the [usage-credits consent prompt](/docs/en/model-config#fable-and-usage-cred
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
settings-reference
±changed
+4−4
claude-codechanged
settings-reference
To pick Fable, first accept the [usage-credits consent](/docs/en/advisor#fable-advisor-and-usage-credits) by running `/model fable`. Until you do, picking Fable in `/advisor` saves
If your account requires the [usage-credits consent](/docs/en/advisor#fable-advisor-and-usage-credits), accept it first by running `/model fable`. Until you do, picking Fable in `/
The key has no effect on Amazon Bedrock, Google Cloud's Agent Platform, or Microsoft Foundry. `"fable"` requires [Fable 5 access](/docs/en/advisor#choose-an-advisor-model).
The key has no effect on Amazon Bedrock, Google Cloud's Agent Platform, or Microsoft Foundry. `"fable"` requires [Fable access](/docs/en/advisor#choose-an-advisor-model).
On models that always think, such as Fable 5, `false` has no effect. On [third-party providers](/docs/en/third-party-integrations) Claude Code omits the `thinking` parameter instea
+4 −4 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
remote-control
±changed
+1−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
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
prompt-caching
±changed
+1−1
claude-codechanged
prompt-caching
[Automatic model fallback](/docs/en/model-config#automatic-model-fallback) on Fable 5 and Opus 5 is also a model switch. When a safety classifier flags a request and the flagged ca
[Automatic model fallback](/docs/en/model-config#automatic-model-fallback) on Fable 5.1, Fable 5, and Opus 5 is also a model switch. When a safety classifier flags a request and th
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
permission-modes
±changed
+3−3
claude-codechanged
permission-modes
* **Model**: on the Anthropic API and [Claude Platform on AWS](/docs/en/claude-platform-on-aws), Claude Opus 4.6 or later, Sonnet 4.6 or later, or [Fable 5](/docs/en/model-config#w
* **Model**: on the Anthropic API and [Claude Platform on AWS](/docs/en/claude-platform-on-aws), Claude Opus 4.6 or later, Sonnet 4.6 or later, or a [Fable model](/docs/en/model-co
On [Amazon Bedrock](/docs/en/amazon-bedrock), [Google Cloud's Agent Platform](/docs/en/google-vertex-ai), [Microsoft Foundry](/docs/en/microsoft-foundry), and signed-in [Claude app
On [Amazon Bedrock](/docs/en/amazon-bedrock), [Google Cloud's Agent Platform](/docs/en/google-vertex-ai), [Microsoft Foundry](/docs/en/microsoft-foundry), and signed-in [Claude app
The classifier runs on Claude Sonnet 5 by default rather than on your `/model` selection. A classifier model that Anthropic configures server-side takes precedence over that de
+3 −3 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
model-config
±changed
+60−51
claude-codechanged
model-config
| **`best`** | Uses Fable 5 where your organization has access to it, otherwise the latest Opus model
| **`fable`** | Uses Claude Fable 5 for your hardest and longest-running tasks
| **`best`** | Uses the latest Fable model where it's available to you, otherwise the same model as `opus`
| **`fable`** | Uses the latest Fable model for your hardest and longest-running tasks
Unless you set `ANTHROPIC_DEFAULT_FABLE_MODEL`, the `fable` alias resolves to Fable 5.1. Before v2.1.255, it resolved to Fable 5.
+60 −51 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
llm-gateway-protocol
±changed
+1−1
claude-codechanged
llm-gateway-protocol
A discovered ID is skipped when it exactly matches a row already in the picker, or when both the discovered and existing IDs resolve to [Fable](/docs/en/model-config#work-with-fabl
A discovered ID is skipped when it exactly matches a row already in the picker, or when the discovered and existing IDs are spellings of the same [Fable](/docs/en/model-config#work
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
interactive-mode
±changed
+1−1
claude-codechanged
interactive-mode
| `Option+T` (macOS) or `Alt+T` (Windows/Linux) | Toggle extended thinking
| `Option+T` (macOS) or `Alt+T` (Windows/Linux) | Toggle extended thinking
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
glossary
±changed
+1−1
claude-codechanged
glossary
A setting that controls how much of the adaptive-reasoning thinking budget Claude uses on each turn. Higher effort means more thinking tokens and deeper reasoning; lower effort is
A setting that controls how much of the adaptive-reasoning thinking budget Claude uses on each turn. Higher effort means more thinking tokens and deeper reasoning; lower effort is
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
feature-availability
±changed
+4−4
claude-codechanged
feature-availability
<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> On these providers, auto mode supports only Claude Sonnet 5, Opus 4.7 or later, and Fa
<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> On these providers, auto mode supports only Claude Sonnet 5, Opus 4.7 or later, and th
* [Auto mode](/docs/en/auto-mode-config): Sonnet 5, Opus 4.7 or later, and Fable 5 only
* [Auto mode](/docs/en/auto-mode-config): Sonnet 5, Opus 4.7 or later, and Fable models only
* [Auto mode](/docs/en/auto-mode-config): Sonnet 5, Opus 4.7 or later, and Fable 5 only
+4 −4 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
errors
±changed
+24−8
claude-codechanged
errors
| `Claude Code ... does not support this model; version ... or newer is required`
On plans where Fable 5 usage [bills to usage credits](/docs/en/model-config#fable-5-and-usage-credits), Claude Code asks you to confirm before a request bills them. When nobody ans
```text theme={null}
Fable 5 limit reached · continuing on Fable 5 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model
+24 −8 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
env-vars
±changed
+8−7
claude-codechanged
env-vars
| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Model ID that the `fable` alias resolves to, and the ID Claude Code recognizes as Fable 5 for [automatic model fallback]
| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Model ID that the `fable` alias resolves to, and the ID Claude Code recognizes as a Fable model for [automatic model fal
| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Set to `1` to disable [1M context window](/docs/en/model-config#extended-context) support. When set, 1M model variants a
| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Set to `1` to disable [adaptive reasoning](/docs/en/model-config#adjust-effort-level) on Opus 4.6 and Sonnet 4.6 and fal
| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Set to `1` to disable [1M context window](/docs/en/model-config#extended-context) support. When set, 1M model variants a
+8 −7 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
desktop
±changed
+4−4
claude-codechanged
desktop
Auto mode is available to all users on the Anthropic API and requires Claude Opus 4.6 or later, Sonnet 4.6 or later, or Fable 5. Organization administrators can turn auto mode off
Auto mode is available to all users on the Anthropic API and requires Claude Opus 4.6 or later, Sonnet 4.6 or later, or a Fable model. Organization administrators can turn auto mod
[Extended thinking](/docs/en/model-config#extended-thinking) is enabled by default, which improves performance on complex reasoning tasks but uses additional tokens. On the Anthrop
On models with [adaptive reasoning](/docs/en/model-config#adjust-effort-level), `MAX_THINKING_TOKENS` values other than `0` are ignored because adaptive reasoning controls thinking
+4 −4 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
costs
±changed
+1−1
claude-codechanged
costs
Extended thinking is enabled by default because it significantly improves performance on complex planning and reasoning tasks. Thinking tokens are billed as output tokens, and the
Extended thinking is enabled by default because it significantly improves performance on complex planning and reasoning tasks. Thinking tokens are billed as output tokens, and the
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
context-window
±changed
+1−1
claude-codechanged
context-window
If you need a larger window rather than a smaller conversation, Fable 5, Sonnet 5, Opus 4.6 and later, and Sonnet 4.6 support a 1 million token context window. See [Extended contex
If you need a larger window rather than a smaller conversation, Fable 5.1, Fable 5, Sonnet 5, Opus 4.6 and later, and Sonnet 4.6 support a 1 million token context window. See [Exte
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
communications-kit
±changed
+7−7
claude-codechanged
communications-kit
formatting, and mechanical edits where speed wins. *Fable 5* is the most
formatting, and mechanical edits where speed wins. *Fable* is the most
| Model | Best for
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| Fable 5 | The hardest, longest-running tasks. Opt-in only: select it with `/model fable`. Cybersecurity or biology content [falls back to Opus](/docs/en/model-config#automatic-mo
+7 −7 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
commands
±changed
+1−1
claude-codechanged
commands
| `/advisor [model\|off]` | Enable or disable the [advisor tool](/docs/en/advisor), which consults a second mo
| `/advisor [model\|off]` | Enable or disable the [advisor tool](/docs/en/advisor), which consults a second mo
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
cli-reference
±changed
+2−2
claude-codechanged
cli-reference
| `--advisor <model>` | Enable the server-side [advisor tool](/docs/en/advisor) for this session with a model alias, `fable`, `opus`, or `sonnet`, or a
| `--advisor <model>` | Enable the server-side [advisor tool](/docs/en/advisor) for this session with a model alias, `fable`, `opus`, or `sonnet`, or a
| `--model` | Sets the model for the current session with an alias for the latest model (`sonnet`, `opus`, `haiku`, or `fable`) or a model's f
| `--model` | Sets the model for the current session with a [model alias](/docs/en/model-config#model-aliases) such as `sonnet`, `opus`, `haik
+2 −2 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
claude-security
±changed
+1−1
claude-codechanged
claude-security
**You may see "Fable 5's safeguards flagged this message" when using Fable 5.** Due to Fable 5's cybersecurity safety classifiers, certain model activities will be blocked and auto
**You may see "Fable 5.1's safeguards flagged this message" or "Fable 5's safeguards flagged this message" when using a Fable model.** Due to Fable's cybersecurity safety classifie
+1 −1 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
changelog
±changed
+107−0
claude-codechanged
changelog
<Update label="2.1.257" description="September 1, 2026">
* Added Claude Fable 5.1 (`claude-fable-5-1`), now the default Fable model — 1M context, $10/$50 per Mtok with \$0.25/Mtok cache reads
* Added "Time format" (`timeFormat`) and `timeZone` settings: 12-hour, 24-hour, 24-hour UTC, or a strftime pattern for the turn-end clock and transcript-view timestamps
* Added a Containment Escape rule to auto mode so cloud metadata-credential fetches, egress evasion, and cross-tenant reach are no longer auto-approved unless your environment ma
+107 −0 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
advisor
±changed
+23−23
claude-codechanged
advisor
On some plans, Fable as the advisor also needs your one-time [consent to bill Fable 5 usage to usage credits](/docs/en/model-config#fable-5-and-usage-credits). For what happens bef
On some plans, Fable as the advisor also needs your one-time [consent to bill Fable usage to usage credits](/docs/en/model-config#fable-and-usage-credits). For what happens before
On some plans, Fable as the advisor also needs your one-time [consent to bill Fable 5 usage to usage credits](/docs/en/model-config#fable-5-and-usage-credits). For what `/advisor f
On some plans, Fable as the advisor also needs your one-time [consent to bill Fable usage to usage credits](/docs/en/model-config#fable-and-usage-credits). For what `/advisor fable
| Main model | Accepted advisors | Notes
+23 −23 lines
Recorded here 1 Sep 2026 18:07 UTC
claude-code
sandboxing
±changed
+4−2
claude-codechanged
sandboxing
There is no built-in credential deny list, so only the files and variables you list are restricted. The setting affects sandboxed Bash commands only. To strip Anthropic and cloud p
There is no built-in credential deny list, so only the files and variables you list are restricted.
`sandbox.credentials` affects sandboxed Bash commands only. To strip credentials from all subprocesses regardless of sandboxing, set [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/en/e
* **Environment variables**: sandboxed Bash commands inherit the parent process environment by default, including any credentials set there. Use [`sandbox.credentials`](#protect-cr
+4 −2 lines
Recorded here 1 Sep 2026 15:07 UTC
claude-code
mcp
±changed
+1−1
claude-codechanged
mcp
Apart from Git's `GIT_CONFIG_KEY_<n>` variables, Claude Code removes every variable from your environment whose name has `TOKEN`, `SECRET`, `PASSWORD`, `PASSWD`, `PASSPHRASE`, `KEY
Apart from Git's `GIT_CONFIG_KEY_<n>` variables, Claude Code removes every variable from your environment whose name looks like a credential, such as a name with `TOKEN`, `SECRET`,
+1 −1 lines
Recorded here 1 Sep 2026 15:07 UTC
claude-code
env-vars
±changed
+1−1
claude-codechanged
env-vars
| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Set to `1` to strip Anthropic and cloud provider credentials from subprocess environments (Bash tool, hooks, MCP stdio s
| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Set to `1` to strip credentials from subprocess environments (Bash tool, hooks, MCP stdio servers): Anthropic and cloud
+1 −1 lines
Recorded here 1 Sep 2026 15:07 UTC
claude-code
ultrareview
±changed
+12−2
claude-codechanged
ultrareview
Use `/tasks` to see running and completed reviews, open the detail view for a review, or stop a review that is in progress. If you stop a review, Claude Code archives the cloud ses
Use `/tasks` to see running and completed reviews, open the detail view for a review, or stop a review that is in progress. If you stop a review, Claude Code archives the cloud ses
When the review finishes, Claude Code shows the verified findings as a notification in your session. Each finding includes the file location and an explanation of the issue so you
Running `claude ultrareview` requires the same authentication and usage credit configuration as `/code-review ultra`. The subcommand exits with code 0 when the review completes wit
+12 −2 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
tools-reference
±changed
+1−1
claude-codechanged
tools-reference
| `RemoteTrigger` | Creates, updates, runs, and lists [Routines](/docs/en/routines) on claude.ai. Backs the `/schedule` command. The [`RemoteTrigger` input reference](/docs/
| `RemoteTrigger` | Creates, updates, runs, and lists [Routines](/docs/en/routines) on claude.ai. Backs the `/schedule` command. The [`RemoteTrigger` input reference](/docs/
+1 −1 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
sub-agents
±changed
+28−23
claude-codechanged
sub-agents
The frontmatter defines the subagent's metadata and configuration. The body becomes the system prompt that guides the subagent's behavior. Subagents receive only this system prompt
The frontmatter defines the subagent's metadata and configuration. The body becomes the system prompt that guides the subagent's behavior. Subagents receive only this system prompt
| Field | Required | Description
| :---------------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------
| `name` | Yes | Unique identifier using lowercase letters and hyphens. [Hooks](/docs/en/hooks#subagentstart) receive this value as `agent_type`. The filename doesn
+28 −23 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
settings-reference
±changed
+5−3
claude-codechanged
settings-reference
Redaction only changes what you see, not what the model generates: to reduce thinking spend, [lower the budget or disable thinking](/docs/en/model-config#extended-thinking) instead
Redaction changes only what you see, not what the model generates. To reduce thinking spend, [lower the budget or disable thinking](/docs/en/model-config#extended-thinking) instead
Place a `.` entry in project settings: it resolves to the project root there and to `~/.claude` in user settings. Claude Code merges entries across every settings file the session
Claude Code resolves a `.` entry to the project root in project settings and to `~/.claude` in user settings. Claude Code merges entries across every settings file the session load
An empty array in a managed source blocks every login with a misconfiguration message, and so does a value Claude Code can't parse. See [Restrict login to your organization](/docs/
+5 −3 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
server-managed-settings
±changed
+12−4
claude-codechanged
server-managed-settings
* **The `env` block**: apart from the telemetry unit and routing variables paired with a credential key, both covered below, it merges per key across the admin-controlled sources.
* **Telemetry unit**: the `OTEL_EXPORTER_OTLP_*` exporter keys, the `OTEL_LOG_*` content-capture toggles, `OTEL_LOGS_EXPORTER`, and the beta tracing variables `ENABLE_BETA_TRACIN
* **Credential-paired routing**: a source that pairs routing variables with a winner-only credential key, such as `apiKeyHelper` or `otelHeadersHelper`, contributes those routing
* **The `env` block**: apart from the telemetry unit and routing variables paired with a credential key, both covered below, it merges per key across the admin-controlled sources.
* **Telemetry unit**: the `OTEL_EXPORTER_OTLP_*` exporter keys, the `OTEL_LOG_*` content-capture toggles, `OTEL_LOGS_EXPORTER`, and the beta tracing variables `ENABLE_BETA_TRACIN
+12 −4 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
sandboxing
±changed
+17−5
claude-codechanged
sandboxing
When you define the same filesystem array in multiple [settings scopes](/docs/en/settings#settings-precedence), Claude Code merges them, combining paths from every scope rather tha
When you define the same filesystem array in multiple [settings scopes](/docs/en/settings#settings-precedence), Claude Code merges them, combining paths from every scope rather tha
If you exclude a source with [`--setting-sources`](/docs/en/cli-reference) on the CLI or [`settingSources`](/docs/en/agent-sdk/claude-code-features#control-filesystem-settings-with
* Sandboxed commands inherit your shell's `$TMPDIR` instead of the session temp directory, because every temp directory is writable and Claude Code no longer redirects commands to
+17 −5 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
routines
±changed
+0−5
claude-codechanged
routines
<Note>
One-off scheduling from the CLI is rolling out gradually and may not be available on your account yet. If `/schedule` only offers recurring schedules, create the one-off run from
</Note>
* `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
+0 −5 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
monitoring-usage
±changed
+2−0
claude-codechanged
monitoring-usage
When a `PreToolUse` hook [defers a tool call](/docs/en/hooks#defer-a-tool-call-for-later), Claude Code saves the trace context of the turn that deferred it. When you resume the ses
+2 −0 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
llm-gateway-connect
±changed
+2−0
claude-codechanged
llm-gateway-connect
Routing and tenant header names like these count as [headers that need approval](/docs/en/server-managed-settings#environment-variables-and-the-approval-dialog). When the headers c
+2 −0 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
hooks-guide
±changed
+1−1
claude-codechanged
hooks-guide
| `StopFailure` | error type
| `StopFailure` | error type
+1 −1 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
hooks
±changed
+2−2
claude-codechanged
hooks
| `StopFailure` | error type
| `StopFailure` | error type
| `error` | Error type: `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `billing_error`, `invalid_request`, `model_not_found`, `serve
| `error` | Error type: `rate_limit`, `overloaded`, `authentication_failed`, `oauth_org_not_allowed`, `account_on_hold`, `billing_error`, `invalid_request`, `model
+2 −2 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
errors
±changed
+27−7
claude-codechanged
errors
| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted`
| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted`
* Run `/usage-credits` to turn on metered billing for the 1M variant on Pro and Max, or to request it from your admin on Team and Enterprise
* Where the message names `/usage-credits`, run it to turn on metered billing for the 1M variant on Pro and Max, or to request usage credits from your admin on Team and Enterprise
Claude Code tried to renew your saved claude.ai or Claude Console login and the OAuth service rejected the stored refresh token, so Claude Code cleared the saved credentials. After
+27 −7 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
env-vars
±changed
+4−4
claude-codechanged
env-vars
| `ANTHROPIC_CUSTOM_HEADERS` | Custom headers to add to requests (`Name: Value` format, newline-separated for multiple headers). If a name or value con
| `ANTHROPIC_CUSTOM_HEADERS` | Custom headers to add to requests (`Name: Value` format, newline-separated for multiple headers). If a name or value con
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Set the [auto-compact window](/docs/en/model-config#set-the-auto-compact-window) in tokens, from `100000` to `1000000`.
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Set the [auto-compact window](/docs/en/model-config#set-the-auto-compact-window) in tokens, from `100000` to `1000000`.
| `DISABLE_TELEMETRY` | Set to any non-empty value, such as `1`, to opt out of telemetry. **Setting it to `0` or `false` still opts out**, unlik
+4 −4 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
costs
±changed
+1−1
claude-codechanged
costs
[Usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) let you keep working past your plan's usage limit. To manage them, run `/usage-cr
[Usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) let you keep working past your plan's usage limit. To manage them, run `/usage-cr
+1 −1 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
context-window
±changed
+2−2
claude-codechanged
context-window
tip: 'Output JSON with `additionalContext` to send info to Claude. For PostToolUse hooks, exit code 2 surfaces stderr as an error but cannot block since the tool already ran. K
tip: 'Output JSON with `additionalContext` to send info to Claude. For PostToolUse hooks, exit code 2 surfaces stderr as an error but cannot block since the tool already ran. O
link: '/en/interactive-mode#bash-mode-with-prefix'
link: '/en/interactive-mode#shell-mode-with-prefix'
+2 −2 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
claude-apps-gateway-config
±changed
+1−0
claude-codechanged
claude-apps-gateway-config
* Sandbox settings that intercept traffic, inject credentials, or weaken isolation, such as `sandbox.network.tlsTerminate` and the proxy port settings. [Security approval dialogs](
+1 −0 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
claude-apps-gateway
±changed
+1−1
claude-codechanged
claude-apps-gateway
When the certificate rotates, every developer sees the trust prompt again, so treat rotations as a planned event and republish the fingerprint.
When the certificate rotates, every developer sees the trust prompt again, so treat rotations as a planned event and republish the fingerprint. If your gateway policy includes [set
+1 −1 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
authentication
±changed
+1−1
claude-codechanged
authentication
Once the stored login expires and can't be refreshed, each request fails with [`Login expired · Please run /login`](/docs/en/errors#login-expired) until you sign in again. Before v
Once the stored login expires and can't be refreshed, each model request fails with [`Login expired · Please run /login`](/docs/en/errors#login-expired) until you sign in again. Be
+1 −1 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
amazon-bedrock
±changed
+2−0
claude-codechanged
amazon-bedrock
If your organization delivers the guardrail headers through a [Claude apps gateway](/docs/en/claude-apps-gateway) policy instead, they count as [settings that need approval](/docs/
+2 −0 lines
Recorded here 1 Sep 2026 03:37 UTC
claude-code
agent-sdk/typescript
±changed
+2−2
claude-codechanged
agent-sdk/typescript
`SDKAssistantMessageError` is one of: `'authentication_failed'`, `'oauth_org_not_allowed'`, `'billing_error'`, `'rate_limit'`, `'overloaded'`, `'invalid_request'`, `'model_not_foun
`SDKAssistantMessageError` is one of: `'authentication_failed'`, `'oauth_org_not_allowed'`, `'account_on_hold'`, `'billing_error'`, `'rate_limit'`, `'overloaded'`, `'invalid_reques
This tool is available only when the session is authenticated with a claude.ai account on a plan with Routines enabled, and is absent when your organization's policy disables [Clau
This tool is available only when the session is authenticated with a claude.ai account on a plan with Routines enabled, and is absent when your organization's policy disables [Clau
+2 −2 lines
Recorded here 1 Sep 2026 03:37 UTC
31 Aug 2026
46 pages
+592 −347 lines
claude-code
agent-sdk/subagents
±changed
+11−19
claude-codechanged
agent-sdk/subagents
This guide explains how to define and use subagents in the SDK using the `agents` parameter.
Define subagents directly in your code using the `agents` parameter. Claude invokes subagents through the `Agent` tool, so include `Agent` in `allowedTools` to auto-approve subagen
Define subagents directly in your code using the `agents` parameter. Claude invokes subagents through the `Agent` tool.
# Auto-approve these tools, including Agent for subagent invocation
+11 −19 lines
Recorded here 31 Aug 2026 23:07 UTC
claude-code
changelog
±changed
+7−0
claude-codechanged
changelog
<Update label="2.1.252" description="August 31, 2026">
* Fixed Bash commands failing with "task output swap refused (tasks dir moved or linked)" on some Macs
* Fixed "always allow" not saving in a project that has no .claude/settings.local.json yet
* Fixed Remote Control sessions hosted by Claude Desktop or VS Code stalling for minutes after a tool finished when the connection to claude.ai was degraded
+7 −0 lines
Recorded here 31 Aug 2026 20:07 UTC
claude-code
sub-agents
±changed
+2−3
claude-codechanged
sub-agents
| `model` | No | [Model](#choose-a-model) to use: `sonnet`, `opus`, `haiku`, `fable`, a full model ID such as `claude-opus-5`, or `inherit`. When you omit it, the s
| `model` | No | [Model](#choose-a-model) to use: `sonnet`, `opus`, `haiku`, `fable`, a full model ID such as `claude-opus-5`, or `inherit`. When you omit it, Claud
* **inherit**: use the same model as the main conversation, even when you set `CLAUDE_CODE_SUBAGENT_MODEL`
* **Omitted**: use the model from the [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/en/model-config#environment-variables) environment variable, or the main conversation's model when you ha
* **inherit**: use the same model as the main conversation
+2 −3 lines
Recorded here 31 Aug 2026 16:07 UTC
claude-code
monitoring-usage
±changed
+1−1
claude-codechanged
monitoring-usage
This span appears only when detailed beta tracing is active, which requires `ENABLE_BETA_TRACING_DETAILED=1` and `BETA_TRACING_ENDPOINT`. Set the pair in your shell, user settings,
This span appears only when detailed beta tracing is active, which requires `ENABLE_BETA_TRACING_DETAILED=1` and `BETA_TRACING_ENDPOINT`, a pair that also [changes where your logs
+1 −1 lines
Recorded here 31 Aug 2026 16:07 UTC
claude-code
hooks
±changed
+1−1
claude-codechanged
hooks
A hook process inherits the parent environment, apart from the `OTEL_*` exporter variables that Claude Code [removes from every subprocess it spawns](/docs/en/monitoring-usage#admi
A hook process inherits the parent environment, apart from the `OTEL_*` exporter variables that Claude Code [removes from every subprocess it spawns](/docs/en/monitoring-usage#admi
+1 −1 lines
Recorded here 31 Aug 2026 16:07 UTC
claude-code
gateways
±changed
+1−1
claude-codechanged
gateways
* **Client telemetry**: Claude Code disables its Anthropic-bound client analytics when a session signs in to a Claude apps gateway. To keep pre-sign-in startup analytics off as wel
* **Client telemetry**: Claude Code disables its Anthropic-bound client analytics when a session signs in to a Claude apps gateway. To keep pre-sign-in startup analytics off as wel
+1 −1 lines
Recorded here 31 Aug 2026 16:07 UTC
claude-code
env-vars
±changed
+2−2
claude-codechanged
env-vars
| `ANTHROPIC_PROFILE` | Name of the Anthropic profile to authenticate with, such as one created by [`ant auth login`](https://platform.claude.co
| `ANTHROPIC_PROFILE` | Name of the Anthropic profile to authenticate with, such as one created by [`ant auth login`](https://platform.claude.co
| `CLAUDE_CODE_SUBAGENT_MODEL` | The default model for [subagents](/docs/en/sub-agents#choose-a-model), [agent team](/docs/en/agent-teams#specify-teammat
| `CLAUDE_CODE_SUBAGENT_MODEL` | The default model for [subagents](/docs/en/sub-agents#choose-a-model), [agent team](/docs/en/agent-teams#specify-teammat
+2 −2 lines
Recorded here 31 Aug 2026 16:07 UTC
claude-code
claude-apps-gateway-deploy
±changed
+1−1
claude-codechanged
claude-apps-gateway-deploy
* **Client analytics**: the CLI disables its own usage analytics and error reporting while signed in to a gateway. Before the first sign-in, the CLI still sends startup events to A
* **Client analytics**: the CLI disables its own usage analytics and error reporting while signed in to a gateway. Before the first sign-in, the CLI still sends startup events to A
+1 −1 lines
Recorded here 31 Aug 2026 16:07 UTC
claude-code
agent-teams
±changed
+1−1
claude-codechanged
agent-teams
`teammateDefaultModel` was removed in v2.1.234; Claude Code ignores a leftover value. Name the model in your prompt or set `CLAUDE_CODE_SUBAGENT_MODEL` instead.
`teammateDefaultModel` was removed in v2.1.234; Claude Code ignores a leftover value. Name the model in your prompt instead.
+1 −1 lines
Recorded here 31 Aug 2026 16:07 UTC
claude-code
agent-sdk/typescript
±changed
+21−21
claude-codechanged
agent-sdk/typescript
| Field | Required | Description
| :------------------------------------ | :------- | :------------------------------------------------------------------------------------------------------------------------------
| `description` | Yes | Natural language description of when to use this agent
| `tools` | No | Array of allowed tool names. If omitted, inherits every [tool available to subagents](/docs/en/sub-agents#available-tools). To
| `disallowedTools` | No | Array of tool names to explicitly disallow for this agent. MCP server-level patterns are also accepted: `mcp__server` or `mcp__
+21 −21 lines
Recorded here 31 Aug 2026 16:07 UTC
claude-code
agent-sdk/subagents
±changed
+15−15
claude-codechanged
agent-sdk/subagents
| Field | Type | Required | Description
| :---------------- | :---------------------------------------------------------- | :------- | :------------------------------------------------------------------------------------
| `description` | `string` | Yes | Natural language description of when to use this agent
| `prompt` | `string` | Yes | The agent's system prompt defining its role and behavior
| `tools` | `string[]` | No | Array of allowed tool names. If omitted, inherits every [tool available to subagents]
+15 −15 lines
Recorded here 31 Aug 2026 16:07 UTC
claude-code
agent-sdk/observability
±changed
+1−1
claude-codechanged
agent-sdk/observability
* **`claude_code.hook`:** wraps each [hook](/docs/en/agent-sdk/hooks) execution. Requires detailed beta tracing (`ENABLE_BETA_TRACING_DETAILED=1` and `BETA_TRACING_ENDPOINT`).
* **`claude_code.hook`:** wraps each [hook](/docs/en/agent-sdk/hooks) execution. Requires detailed beta tracing (`ENABLE_BETA_TRACING_DETAILED=1` and `BETA_TRACING_ENDPOINT`), a pa
+1 −1 lines
Recorded here 31 Aug 2026 16: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}
```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}
```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}
+5 −5 lines
Recorded here 31 Aug 2026 15:37 UTC
claude-code
sub-agents
±changed
+1−1
claude-codechanged
sub-agents
The `model` field controls which [AI model](/docs/en/model-config) the subagent uses:
The `model` field controls which model the subagent uses:
+1 −1 lines
Recorded here 31 Aug 2026 10:37 UTC
claude-code
workflows
±changed
+3−1
claude-codechanged
workflows
Every agent in a workflow uses your session's model unless the script routes a stage to a different one or the [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/en/model-config#environment-vari
Claude Code picks each workflow agent's model in the same [order it uses for subagents](/docs/en/sub-agents#choose-a-model). A model the script names for a stage counts as the per-
To control the model cost:
+3 −1 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
troubleshoot-install
±changed
+25−1
claude-codechanged
troubleshoot-install
On macOS, login can also fail when the Keychain is locked or its password is out of sync with your account password, which prevents Claude Code from saving credentials. Run `claude
On macOS, Claude Code saves credentials to the login Keychain. When the Keychain rejects the write, such as when it's locked in an SSH session or its password is out of sync with y
To make the Keychain writable again and move your login back into the encrypted Keychain:
+25 −1 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
third-party-integrations
±changed
+1−1
claude-codechanged
third-party-integrations
<td>API key</td>
<td>API key or a [Console sign-in without one](/docs/en/authentication#sign-in-without-an-api-key)</td>
+1 −1 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
sub-agents
±changed
+20−16
claude-codechanged
sub-agents
* **Model**: inherits from the main conversation
* **Model**: the [`CLAUDE_CODE_SUBAGENT_MODEL`](#choose-a-model) model if you set one and nothing assigns a model another way, otherwise the main conversation's model; [Choose
| Agent | Model | When Claude uses it
| :---------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------
| claude | Inherits | When a task doesn't fit a more specialized agent. A catch-all with every tool [available to subagents](#available-tools). Also the default agen
+20 −16 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
settings-reference
±changed
+12−6
claude-codechanged
settings-reference
| [`teammateDefaultModel`](#teammatedefaultmodel) | Removed in v2.1.234; [teammates](/docs/en/agent-teams#specify-teammates-and-mode
| [`teammateDefaultModel`](#teammatedefaultmodel) | Removed in v2.1.234; see [Specify teammates and models](/docs/en/agent-teams#spe
* Variables Claude Code classifies as safe, such as model selection, timeouts and limits, feature toggles, and telemetry settings: at startup from every settings file.
* Variables Claude Code classifies as safe, such as model selection, timeouts and limits, feature toggles, and telemetry settings: at startup from every settings file, apart from t
* Project and local settings can't set a few variables, such as `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR`
+12 −6 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
self-hosted-environments-testing
±changed
+4−2
claude-codechanged
self-hosted-environments-testing
Run `claude auth login` once interactively on the machine that executes the script, using a dedicated user account for automation. The token lives in the OS keychain on macOS, or i
Run `claude auth login` once interactively on the machine that executes the script, using a dedicated user account for automation. Claude Code stores the token in the OS keychain o
The CLI refreshes the short-lived access token automatically on each invocation, but the underlying refresh-token grant is capped at 30 days from the initial login, so re-run `clau
* **Mint it**: run `claude auth login` with an account that holds an Owner role, then read the current access token from the OS keychain on macOS or `~/.claude/.credentials.json` o
+4 −2 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
plugins-reference
±changed
+1−1
claude-codechanged
plugins-reference
Sensitive values go to the macOS Keychain, or to `~/.claude/.credentials.json` on platforms where no supported keychain is available. Keychain storage is shared with OAuth tokens a
On macOS, Claude Code stores sensitive values in the macOS Keychain, falling back to `~/.claude/.credentials.json` when the Keychain rejects the write. On platforms without a suppo
+1 −1 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
monitoring-usage
±changed
+16−2
claude-codechanged
monitoring-usage
* **Beta tracing endpoints**: with [detailed beta tracing](#traces-beta) active, Claude Code exports logs and traces to `BETA_TRACING_ENDPOINT` instead of through the logs and trac
* A generic or logs/traces endpoint or credential
* An [`otelHeadersHelper`](/docs/en/settings-reference#otelheadershelper)
* A logs or traces exporter selector set to `none`, `console`, or empty, values that keep the signal off a collector
+16 −2 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
model-config
±changed
+14−12
claude-codechanged
model-config
* **Subagent or teammate override**: Claude Code falls back to the [subagent's inherited model](/docs/en/sub-agents#choose-a-model) or the [lead's model for a teammate](/docs/en/ag
* **Subagent or teammate override**: Claude Code runs the subagent or teammate on a fallback model rather than failing the request. See [Choose a model](/docs/en/sub-agents#choose-
In interactive sessions, Claude Code warns you when it substitutes a subagent's model, by this fallback or by the newest-permitted-version substitution above, naming the requeste
+14 −12 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
mcp
±changed
+5−3
claude-codechanged
mcp
When Claude Code can't produce a schema the API accepts, or on a deployment that doesn't receive the remote configuration that enables the rewrite, such as an offline machine, it s
When Claude Code can't produce a schema the API accepts, or on a deployment that doesn't receive the remote configuration that enables the rewrite, it skips that one tool, records
The Claude API checks every tool's input schema in a request and rejects the whole request when any one schema fails, so a single MCP tool with a malformed schema would make every
The Claude API checks every tool's input schema in a request and rejects the whole request when any one schema fails, so a single MCP tool with a malformed schema would make every
On a deployment that doesn't receive the remote configuration that enables the exclusion, Claude Code still runs the checks and records in the server's log which tool would be reje
+5 −3 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
gateways
±changed
+3−1
claude-codechanged
gateways
* **Client telemetry**: on a Claude apps gateway session, Claude Code sends no client analytics to Anthropic. It disables the Anthropic-bound analytics when the session signs in. F
* **Client telemetry**: Claude Code disables its Anthropic-bound client analytics when a session signs in to a Claude apps gateway. To keep pre-sign-in startup analytics off as wel
* **Client telemetry on other gateways**: whether Claude Code sends the optional client telemetry stream depends on your provider, and the [telemetry defaults table](/docs/en/data-
* **Telemetry destinations**: where Claude Code sends a gateway session's telemetry depends on how the session signed in, and [What's enforced on developers](/docs/en/claude-apps-g
+3 −1 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
feature-availability
±changed
+1−1
claude-codechanged
feature-availability
* **Anthropic Console**: you authenticate with an Anthropic API key
* **Anthropic Console**: you authenticate with an Anthropic API key or by [signing in to a Console account without one](/docs/en/authentication#sign-in-without-an-api-key)
+1 −1 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
errors
±changed
+13−9
claude-codechanged
errors
If you are prompted to log in repeatedly, see [Not logged in or token expired](/docs/en/troubleshoot-install#not-logged-in-or-token-expired) for system clock and macOS Keychain fix
If you are prompted to log in repeatedly, see [Not logged in or token expired](/docs/en/troubleshoot-install#not-logged-in-or-token-expired) for system clock checks and macOS crede
* For repeated prompts to log in across launches, see the system clock and macOS Keychain checks in [Troubleshooting](/docs/en/troubleshoot-install#not-logged-in-or-token-expired)
* For repeated prompts to log in across launches, see the system clock checks and macOS credential-storage recovery steps in [Troubleshooting](/docs/en/troubleshoot-install#not-log
This appears only when the active credential comes from an Anthropic credential profile, one you select with the `ANTHROPIC_PROFILE` environment variable or that Claude Code discov
+13 −9 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
env-vars
±changed
+8−5
claude-codechanged
env-vars
| `ANTHROPIC_PROFILE` | Name of the Anthropic profile to authenticate with, such as one created by [`ant auth login`](https://platform.claude.co
| `ANTHROPIC_PROFILE` | Name of the Anthropic profile to authenticate with, such as one created by [`ant auth login`](https://platform.claude.co
| `BETA_TRACING_ENDPOINT` | OTLP endpoint for [detailed beta tracing](/docs/en/monitoring-usage#traces-beta): with `ENABLE_BETA_TRACING_DETAILED=1`,
| `CLAUDE_CODE_SUBAGENT_MODEL` | The model Claude Code uses for all [subagents](/docs/en/sub-agents#choose-a-model), [agent teams](/docs/en/agent-teams),
| `CLAUDE_CODE_SUBAGENT_MODEL` | The default model for [subagents](/docs/en/sub-agents#choose-a-model), [agent team](/docs/en/agent-teams#specify-teammat
+8 −5 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
debug-your-config
±changed
+1−2
claude-codechanged
debug-your-config
* On Linux and Windows, you'll be prompted to log in again because credentials are stored under the configuration directory
* On macOS, credentials are in the Keychain and carry over to the clean session
* You'll be prompted to log in again
+1 −2 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
claude-apps-gateway-deploy
±changed
+2−2
claude-codechanged
claude-apps-gateway-deploy
* **Client analytics**: the CLI disables its own usage analytics and error reporting while signed in to a gateway. Before the sign-in, including on a first run where a [managed set
* **Client analytics**: the CLI disables its own usage analytics and error reporting while signed in to a gateway. Before the first sign-in, the CLI still sends startup events to A
* **Survey ratings**: gateway sign-in disables the Anthropic-bound rating sink from the same point as the analytics streams, so ratings aren't sent to Anthropic.
* **Survey ratings**: while signed in to a gateway, the CLI disables the Anthropic-bound rating upload together with the analytics streams, so it doesn't send ratings to Anthropic.
+2 −2 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
claude-apps-gateway
±changed
+2−2
claude-codechanged
claude-apps-gateway
<Step title="Check which source won">
Call the Agent SDK's [`resolveSettings()`](/docs/en/agent-sdk/typescript#resolvesettings). Its result includes a `sources` list; the managed policy entry there carries a `polic
<Step title="Check which source is selected">
On a machine that only runs Claude Desktop, call the Agent SDK's [`resolveSettings()`](/docs/en/agent-sdk/typescript#resolvesettings) and read `policyOrigin` on the `managed` e
+2 −2 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
authentication
±changed
+35−6
claude-codechanged
authentication
* **Claude Console**: log in with your Console credentials. Your admin must have [invited you](#claude-console-authentication) first.
* **Claude Console**: log in with your Console credentials. Your admin must have [invited you](#claude-console-authentication) first. You can sign in with or without [creating an A
#### Sign in without an API key
You can sign in to your Console account without creating an API key, even when your organization doesn't let developers create them. Choose the Anthropic Console account at the `/l
+35 −6 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
agent-teams
±changed
+8−6
claude-codechanged
agent-teams
1. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/en/model-config#environment-variables), when it's set to anything other than `inherit`.
2. The model your spawn prompt names for that teammate.
3. For an in-process teammate spawned from a [subagent definition](#use-subagent-definitions-for-teammates), the definition's `model`.
1. The model your spawn prompt names for that teammate.
2. For a teammate spawned from a [subagent definition](#use-subagent-definitions-for-teammates), the definition's `model`, where `inherit` selects the lead's model.
+8 −6 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
agent-sdk/typescript
±changed
+34−28
claude-codechanged
agent-sdk/typescript
This function is alpha and its API may change before stabilization. It reads MDM sources, including macOS plist and Windows HKLM/HKCU, for parity with CLI startup, but does not e
This function is alpha and its API may change before stabilization.
The snapshot differs from what a live `query()` session applies:
+34 −28 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
agent-sdk/subagents
±changed
+15−15
claude-codechanged
agent-sdk/subagents
| Field | Type | Required | Description
| :---------------- | :---------------------------------------------------------- | :------- | :------------------------------------------------------------------------------------
| `description` | `string` | Yes | Natural language description of when to use this agent
| `prompt` | `string` | Yes | The agent's system prompt defining its role and behavior
| `tools` | `string[]` | No | Array of allowed tool names. If omitted, inherits every [tool available to subagents]
+15 −15 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
agent-sdk/python
±changed
+15−15
claude-codechanged
agent-sdk/python
| Field | Required | Description
| :---------------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------
| `description` | Yes | Natural language description of when to use this agent
| `prompt` | Yes | The agent's system prompt
| `tools` | No | Array of allowed tool names. If omitted, inherits every [tool available to subagents](/docs/en/sub-agents#available-tools)
+15 −15 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
agent-sdk/observability
±changed
+1−1
claude-codechanged
agent-sdk/observability
* **`claude_code.hook`:** wraps each [hook](/docs/en/agent-sdk/hooks) execution. Requires detailed beta tracing (`ENABLE_BETA_TRACING_DETAILED=1` and `BETA_TRACING_ENDPOINT`) in ad
* **`claude_code.hook`:** wraps each [hook](/docs/en/agent-sdk/hooks) execution. Requires detailed beta tracing (`ENABLE_BETA_TRACING_DETAILED=1` and `BETA_TRACING_ENDPOINT`).
+1 −1 lines
Recorded here 31 Aug 2026 06:07 UTC
claude-code
whats-new/2026-w34
±changed
+1−1
claude-codechanged
whats-new/2026-w34
<p className="digest-feature-lede">The <code>/design</code> skill brings Claude Design's artboard workflow into the CLI and Claude Code Desktop, built on artifacts. Run it with a
<p className="digest-feature-lede">The <code>/design</code> skill brings Claude Design's artboard workflow into the CLI and Claude Code Desktop, built on artifacts. Run it with a
+1 −1 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
terminal-config
±changed
+1−1
claude-codechanged
terminal-config
When you paste more than 800 characters or more than two lines into the prompt, Claude Code collapses the input to a placeholder such as `[Pasted text #1 +120 lines]` so the input
When you paste more than 800 characters or more than three lines into the prompt, Claude Code collapses the input to a placeholder such as `[Pasted text #1 +120 lines]` so the inpu
+1 −1 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
settings-reference
±changed
+12−12
claude-codechanged
settings-reference
Claude Code takes a Boolean key's value from the highest-precedence settings file that sets it, so a managed `enabled` or `failIfUnavailable` overrides anything a developer sets. I
Claude Code takes a Boolean key's value from the highest-precedence settings scope that sets it, so a managed `enabled` or `failIfUnavailable` overrides anything a developer sets.
Excluded commands still go through the regular permission flow. Exclusion is a convenience, not a security boundary: prefer [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite
Excluded commands still go through the regular permission flow. Exclusion is a convenience, not a security boundary: prefer [`filesystem.allowWrite`](#sandbox-filesystem-allowwrite
Claude Code merges entries across every settings file the session loads: user, project, local, and managed paths combine rather than replace each other, and Claude Code adds the pa
+12 −12 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
commands
±changed
+1−0
claude-codechanged
commands
| `/design [brief]` | **[Skill](/docs/en/skills#bundled-skills).** Draft UI mockups, screen flows, landi
+1 −0 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
claude-security
±changed
+4−2
claude-codechanged
claude-security
* Python 3.9.6 or later available on your `PATH` as `python3`. Check with `python3 --version`. The plugin's tooling uses only the Python standard library, so nothing is installed.
* Python 3.9 or later available on your `PATH` as `python3`. Check with `python3 --version`. The plugin's tooling uses only the Python standard library, so nothing is installed.
The command opens the plugin's details, where you choose an [installation scope](/docs/en/discover-plugins#install-plugins) to start the install.
**The `/claude-security` menu opens with a Python warning.** The plugin needs `python3` 3.9.6 or later on your `PATH`. When it can't find `python3` at all, the menu warns that Clau
+4 −2 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
claude-apps-gateway
±changed
+8−6
claude-codechanged
claude-apps-gateway
Settings passed by a launching process are parent settings. Claude Code ignores parent settings on any machine that has an admin-deployed managed source, unless the highest-priorit
Settings passed by a launching process are parent settings. Claude Code ignores parent settings on any machine that has an admin-deployed managed source, unless the [source that de
Machines where developers sign in through `/login` don't need it; every Claude Code invocation fetches its policy from the gateway directly. Fleets whose [`policyHelper`](/docs/en/
Machines where developers sign in through `/login` don't need it; each Claude Code session fetches its policy from the gateway.
+8 −6 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
artifacts
±changed
+12−0
claude-codechanged
artifacts
## Draft a design canvas
To mock up a UI, a screen flow, a landing page, or a poster rather than build a page, run `/design` with a brief. Claude drafts the design as artboards on one canvas and publishes
+12 −0 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
agent-view
±changed
+1−1
claude-codechanged
agent-view
Pasted text longer than 800 characters or more than two lines collapses to a `[Pasted text #N]` placeholder so the input stays on one line; the full text is sent when you dispatch.
Pasted text longer than 800 characters or more than three lines collapses to a `[Pasted text #N]` placeholder so the input stays on one line; the full text is sent when you dispatc
+1 −1 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
agent-sdk/typescript
±changed
+65−65
claude-codechanged
agent-sdk/typescript
| Property | Type | Default
| :-------------------------------- | :------------------------------------------------------------------------------------------------------- | :----------------------------------
| `abortController` | `AbortController` | `new AbortController()`
| `additionalDirectories` | `string[]` | `[]`
| `agent` | `string` | `undefined`
+65 −65 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
agent-sdk/modifying-system-prompts
±changed
+38−1
claude-codechanged
agent-sdk/modifying-system-prompts
`excludeDynamicSections` requires `@anthropic-ai/claude-agent-sdk` v0.2.98 or later, or `claude-agent-sdk` v0.1.58 or later for Python. It applies only to the preset object form
`excludeDynamicSections` requires `@anthropic-ai/claude-agent-sdk` v0.2.98 or later, or `claude-agent-sdk` v0.1.58 or later for Python. Set it on the preset object form only. The
#### Cache the static part of a custom prompt
+38 −1 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
agent-sdk/mcp
±changed
+6−4
claude-codechanged
agent-sdk/mcp
Pass MCP servers directly in the `mcpServers` option:
Pass MCP servers directly in the `mcpServers` option. This example starts a local filesystem MCP server for `/Users/me/projects`. Replace that path with a directory on your machine
Create a `.mcp.json` file at your project root. The file is picked up when the `project` setting source is enabled, which it is for default `query()` options. If you set `settingSo
Create a `.mcp.json` file at your project root. The file is picked up when the `project` setting source is enabled, which it is for default `query()` options. If you set `settingSo
Local processes that communicate via stdin/stdout. Use this for MCP servers you run on the same machine. For the `.mcp.json` form, use the same fields shown at [From a config file]
+6 −4 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
agent-sdk/hosting
±changed
+29−5
claude-codechanged
agent-sdk/hosting
One agent session maps to one subprocess. Running N concurrent sessions means N subprocesses, each with its own process tree and transcript file. By default they all inherit your a
One agent session maps to one subprocess. Running N concurrent sessions means N subprocesses, each with its own process tree and transcript file. By default they all inherit your a
query({ prompt, options: { cwd: "/work/session-a" } })
import { query } from "@anthropic-ai/claude-agent-sdk";
+29 −5 lines
Recorded here 31 Aug 2026 05:37 UTC
claude-code
workflows
±changed
+2−0
claude-codechanged
workflows
To turn it on while you choose a model, move the `/model` picker's effort slider to `ultracode` with the arrow keys. [Adjust effort level](/docs/en/model-config#adjust-effort-level
+2 −0 lines
Recorded here 31 Aug 2026 05:07 UTC
claude-code
terminal-config
±changed
+1−1
claude-codechanged
terminal-config
When you paste more than 800 characters or more than two lines into the prompt, Claude Code collapses the input to a placeholder such as `[Pasted text #1 +120 lines]` so the input
When you paste more than 800 characters or more than two lines into the prompt, Claude Code collapses the input to a placeholder such as `[Pasted text #1 +120 lines]` so the input
+1 −1 lines
Recorded here 31 Aug 2026 05:07 UTC
claude-code
skills
±changed
+1−1
claude-codechanged
skills
In [non-interactive sessions](/docs/en/headless), Claude Code doesn't reserve the names `help` and `feedback` for their terminal-only built-in commands, so a plugin skill with one
In [non-interactive sessions](/docs/en/headless), the names `help` and `feedback` aren't reserved for their terminal-only built-in commands, so a plugin skill with one of those nam
+1 −1 lines
Recorded here 31 Aug 2026 05:07 UTC
claude-code
settings-reference
±changed
+9−1
claude-codechanged
settings-reference
Claude Code caches the value and reruns the command after the interval you set with [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/docs/en/env-vars). In interactive sessions, when the comm
Claude Code caches the value and reruns the command in these cases:
* After the cache lifetime, five minutes by default or the interval you set with [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/docs/en/env-vars).
* When a request to the Anthropic API, directly or through an [LLM gateway](/docs/en/llm-gateway), fails with `401` or `403`.
+9 −1 lines
Recorded here 31 Aug 2026 05:07 UTC
claude-code
model-config
±changed
+1−0
claude-codechanged
model-config
* **`/model` picker**: move the effort slider to `ultracode` with the arrow keys while you choose a model. Claude Code turns it on for the current session, even when you save that
+1 −0 lines
Recorded here 31 Aug 2026 05:07 UTC
claude-code
memory
±changed
+2−0
claude-codechanged
memory
To exclude a rules file you reach through a [symlink](#share-rules-across-projects-with-symlinks), whether the file or its directory is the link, write the pattern against either p
+2 −0 lines
Recorded here 31 Aug 2026 05:07 UTC
Nothing on this page matches that. Press Enter to search every page of the ledger.