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
152 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,531 of the ledger's changes in claude-code. Show every change
ReadSourcePageWhatLines
4 Sep 2026
54 pages
+849 −748 lines
claude-code
llm-gateway-protocol
±changed
+5−5
claude-codechanged
llm-gateway-protocol
# Gateway protocol reference
> The API contract between Claude Code and an LLM gateway: endpoints, headers and body fields to forward, feature degradation when fields are stripped, attribution headers for cost
# Claude Code gateway compatibility guide
+5 −5 lines
Recorded here 4 Sep 2026 02:37 UTC
claude-code
llm-gateway-connect
±changed
+2−2
claude-codechanged
llm-gateway-connect
* For what Claude Code sends to a gateway, see the [gateway protocol reference](/docs/en/llm-gateway-protocol)
* For what Claude Code sends to a gateway, see the [gateway compatibility guide](/docs/en/llm-gateway-protocol)
* [Gateway protocol reference](/docs/en/llm-gateway-protocol): what Claude Code sends to a gateway, including the headers and fields the gateway must forward
* [Gateway compatibility guide](/docs/en/llm-gateway-protocol): what Claude Code sends to a gateway, including the headers and fields the gateway must forward
+2 −2 lines
Recorded here 4 Sep 2026 02:37 UTC
claude-code
llm-gateway
±changed
+3−3
claude-codechanged
llm-gateway
* If you're configuring a gateway product: the [gateway protocol reference](/docs/en/llm-gateway-protocol)
* If you're configuring a gateway product: the [gateway compatibility guide](/docs/en/llm-gateway-protocol)
The tradeoff is that the gateway becomes infrastructure your organization operates. Claude Code adds capabilities with each release, and a gateway that doesn't forward them breaks
The tradeoff is that the gateway becomes infrastructure your organization operates. Claude Code adds capabilities with each release, and a gateway that doesn't forward them breaks
* [Gateway protocol reference](/docs/en/llm-gateway-protocol): what Claude Code sends to a gateway, for operators configuring one, covering endpoints, headers to forward, and featu
+3 −3 lines
Recorded here 4 Sep 2026 02:37 UTC
claude-code
gateways
±changed
+1−1
claude-codechanged
gateways
The next page depends on who runs the gateway. Anthropic's gateway runs from the `claude` binary and has its own setup guide; a gateway your organization already runs has a protoco
The next page depends on who runs the gateway. Anthropic's gateway runs from the `claude` binary and has its own setup guide; a gateway your organization already runs has a compati
+1 −1 lines
Recorded here 4 Sep 2026 02:37 UTC
claude-code
claude-apps-gateway
±changed
+1−1
claude-codechanged
claude-apps-gateway
The [gateway protocol reference](/docs/en/llm-gateway-protocol) documents the contract Claude Code expects from any gateway: the endpoints it calls, the headers and body fields to
The [gateway compatibility guide](/docs/en/llm-gateway-protocol) documents what Claude Code expects from any gateway: the endpoints it calls, the headers and body fields to forward
+1 −1 lines
Recorded here 4 Sep 2026 02:37 UTC
claude-code
advisor
±changed
+1−1
claude-codechanged
advisor
Enabling or disabling the advisor mid-session does not invalidate your main model's [prompt cache](/docs/en/prompt-caching). Unlike [changing model or effort level](/docs/en/prompt
Enabling or disabling the advisor mid-session does not invalidate your main model's [prompt cache](/docs/en/prompt-caching). Unlike [switching models](/docs/en/prompt-caching#switc
+1 −1 lines
Recorded here 4 Sep 2026 02:37 UTC
claude-code
whats-new/2026-w34
±changed
+15−15
claude-codechanged
whats-new/2026-w34
<span>Releases <a href="/docs/docs/en/changelog#2-1-234">v2.1.234 → v2.1.239</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-234">v2.1.234 → v2.1.239</a></span>
<a className="digest-feature-link" href="/docs/docs/en/artifacts#availability">Where artifacts are available</a>
<a className="digest-feature-link" href="/docs/en/artifacts#availability">Where artifacts are available</a>
<a className="digest-feature-link" href="/docs/docs/en/output-styles#built-in-output-styles">Built-in output styles</a>
+15 −15 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w33
±changed
+15−15
claude-codechanged
whats-new/2026-w33
<span>Releases <a href="/docs/docs/en/changelog#2-1-225">v2.1.225 → v2.1.233</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-225">v2.1.225 → v2.1.233</a></span>
<a className="digest-feature-link" href="/docs/docs/en/errors#youve-hit-your-session-limit">What to do when you hit a usage limit</a>
<a className="digest-feature-link" href="/docs/en/errors#youve-hit-your-session-limit">What to do when you hit a usage limit</a>
<a className="digest-feature-link" href="/docs/docs/en/sub-agents#turn-fork-mode-on-or-off">Turn fork mode on or off</a>
+15 −15 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w32
±changed
+15−15
claude-codechanged
whats-new/2026-w32
<span>Releases <a href="/docs/docs/en/changelog#2-1-220">v2.1.220 → v2.1.224</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-220">v2.1.220 → v2.1.224</a></span>
<a className="digest-feature-link" href="/docs/docs/en/cross-session-messaging#message-another-session">Message another session</a>
<a className="digest-feature-link" href="/docs/en/cross-session-messaging#message-another-session">Message another session</a>
<a className="digest-feature-link" href="/docs/docs/en/self-hosted-environments-quickstart#set-up-an-environment-and-runner">Self-hosted environments quickstart</a>
+15 −15 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w30
±changed
+11−11
claude-codechanged
whats-new/2026-w30
<span>Releases <a href="/docs/docs/en/changelog#2-1-214">v2.1.214 → v2.1.219</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-214">v2.1.214 → v2.1.219</a></span>
<p className="digest-feature-lede">Claude Opus 5 is the new default Opus model in Claude Code. It's the default on Max, Team Premium, Enterprise pay-as-you-go, and the Anthropic
<p className="digest-feature-lede">Claude Opus 5 is the new default Opus model in Claude Code. It's the default on Max, Team Premium, Enterprise pay-as-you-go, and the Anthropic
<a className="digest-feature-link" href="/docs/docs/en/model-config#available-models">Model configuration</a>
+11 −11 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w29
±changed
+6−6
claude-codechanged
whats-new/2026-w29
<span>Releases <a href="/docs/docs/en/changelog#2-1-207">v2.1.207 → v2.1.212</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-207">v2.1.207 → v2.1.212</a></span>
<a className="digest-feature-link" href="/docs/docs/en/artifacts#pull-live-data-with-mcp-connectors">Pull live data with MCP connectors</a>
<a className="digest-feature-link" href="/docs/en/artifacts#pull-live-data-with-mcp-connectors">Pull live data with MCP connectors</a>
<a className="digest-feature-link" href="/docs/docs/en/accessibility#turn-on-screen-reader-mode">Turn on screen reader mode</a>
+6 −6 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w28
±changed
+3−3
claude-codechanged
whats-new/2026-w28
<span>Releases <a href="/docs/docs/en/changelog#2-1-202">v2.1.202 → v2.1.206</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-202">v2.1.202 → v2.1.206</a></span>
<a className="digest-feature-link" href="/docs/docs/en/desktop#browse-external-sites">Browse external sites</a>
<a className="digest-feature-link" href="/docs/en/desktop#browse-external-sites">Browse external sites</a>
<a className="digest-feature-link" href="/docs/docs/en/commands#all-commands">All commands</a>
+3 −3 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w27
±changed
+8−8
claude-codechanged
whats-new/2026-w27
<span>Releases <a href="/docs/docs/en/changelog#2-1-195">v2.1.195 → v2.1.201</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-195">v2.1.195 → v2.1.201</a></span>
<a className="digest-feature-link" href="/docs/docs/en/model-config#available-models">Model configuration</a>
<a className="digest-feature-link" href="/docs/en/model-config#available-models">Model configuration</a>
<a className="digest-feature-link" href="/docs/docs/en/chrome">Use Claude Code with Chrome</a>
+8 −8 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w26
±changed
+3−3
claude-codechanged
whats-new/2026-w26
<span>Releases <a href="/docs/docs/en/changelog#2-1-185">v2.1.185 → v2.1.193</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-185">v2.1.185 → v2.1.193</a></span>
<a className="digest-feature-link" href="/docs/docs/en/mcp#authenticate-from-the-command-line">Authenticate from the command line</a>
<a className="digest-feature-link" href="/docs/en/mcp#authenticate-from-the-command-line">Authenticate from the command line</a>
<a className="digest-feature-link" href="/docs/docs/en/interactive-mode#shell-mode-with-prefix">Shell mode with the ! prefix</a>
+3 −3 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w25
±changed
+4−4
claude-codechanged
whats-new/2026-w25
<span>Releases <a href="/docs/docs/en/changelog#2-1-178">v2.1.178 → v2.1.183</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-178">v2.1.178 → v2.1.183</a></span>
<a className="digest-feature-link" href="/docs/docs/en/artifacts#create-an-artifact">Create an artifact</a>
<a className="digest-feature-link" href="/docs/en/artifacts#create-an-artifact">Create an artifact</a>
<a className="digest-feature-link" href="/docs/docs/en/permissions#match-by-input-parameter">Match by input parameter</a>
+4 −4 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w24
±changed
+5−5
claude-codechanged
whats-new/2026-w24
<span>Releases <a href="/docs/docs/en/changelog#2-1-166">v2.1.166 → v2.1.176</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-166">v2.1.166 → v2.1.176</a></span>
<a className="digest-feature-link" href="/docs/docs/en/commands#all-commands">Commands reference</a>
<a className="digest-feature-link" href="/docs/en/commands#all-commands">Commands reference</a>
<a className="digest-feature-link" href="/docs/docs/en/sub-agents#let-subagents-spawn-their-own-subagents">Spawn nested subagents</a>
+5 −5 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w23
±changed
+7−7
claude-codechanged
whats-new/2026-w23
<span>Releases <a href="/docs/docs/en/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>
<a className="digest-feature-link" href="/docs/docs/en/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry">Auto mode on third-party providers</a>
<a className="digest-feature-link" href="/docs/en/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry">Auto mode on third-party providers</a>
<a className="digest-feature-link" href="/docs/docs/en/permission-modes#protected-paths">Protected paths</a>
+7 −7 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w22
±changed
+5−5
claude-codechanged
whats-new/2026-w22
<span>Releases <a href="/docs/docs/en/changelog#2-1-150">v2.1.150 → v2.1.157</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-150">v2.1.150 → v2.1.157</a></span>
<a className="digest-feature-link" href="/docs/docs/en/model-config#available-models">Model configuration</a>
<a className="digest-feature-link" href="/docs/en/model-config#available-models">Model configuration</a>
<a className="digest-feature-link" href="/docs/docs/en/workflows">Dynamic workflows</a>
+5 −5 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w21
±changed
+4−4
claude-codechanged
whats-new/2026-w21
<span>Releases <a href="/docs/docs/en/changelog#2-1-143">v2.1.143 → v2.1.149</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-143">v2.1.143 → v2.1.149</a></span>
<a className="digest-feature-link" href="/docs/docs/en/permission-modes#eliminate-prompts-with-auto-mode">Auto mode requirements</a>
<a className="digest-feature-link" href="/docs/en/permission-modes#eliminate-prompts-with-auto-mode">Auto mode requirements</a>
<div><a href="/docs/docs/en/costs#track-your-costs"><code>/usage</code></a> now shows a per-category breakdown of what's driving your plan limits, attributing recent usage to s
+4 −4 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w20
±changed
+4−4
claude-codechanged
whats-new/2026-w20
<span>Releases <a href="/docs/docs/en/changelog#2-1-139">v2.1.139 → v2.1.142</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-139">v2.1.139 → v2.1.142</a></span>
<a className="digest-feature-link" href="/docs/docs/en/agent-view">Agent view</a>
<a className="digest-feature-link" href="/docs/en/agent-view">Agent view</a>
<a className="digest-feature-link" href="/docs/docs/en/goal">Goals</a>
+4 −4 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w19
±changed
+3−3
claude-codechanged
whats-new/2026-w19
<span>Releases <a href="/docs/docs/en/changelog#2-1-128">v2.1.128 → v2.1.136</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-128">v2.1.128 → v2.1.136</a></span>
<a className="digest-feature-link" href="/docs/docs/en/plugins">Plugins guide</a>
<a className="digest-feature-link" href="/docs/en/plugins">Plugins guide</a>
<a className="digest-feature-link" href="/docs/docs/en/interactive-mode#command-history">Interactive mode: command history</a>
+3 −3 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w18
±changed
+6−6
claude-codechanged
whats-new/2026-w18
<span>Releases <a href="/docs/docs/en/changelog#2-1-120">v2.1.120 → v2.1.126</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-120">v2.1.120 → v2.1.126</a></span>
<a className="digest-feature-link" href="/docs/docs/en/cli-reference#cli-commands">CLI reference</a>
<a className="digest-feature-link" href="/docs/en/cli-reference#cli-commands">CLI reference</a>
<a className="digest-feature-link" href="/docs/docs/en/cli-reference">CLI reference</a>
+6 −6 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w17
±changed
+13−13
claude-codechanged
whats-new/2026-w17
<span>Releases <a href="/docs/docs/en/changelog#2-1-114">v2.1.114 → v2.1.119</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-114">v2.1.114 → v2.1.119</a></span>
<a className="digest-feature-link" href="/docs/docs/en/ultrareview">Ultrareview guide</a>
<a className="digest-feature-link" href="/docs/en/ultrareview">Ultrareview guide</a>
<a className="digest-feature-link" href="/docs/docs/en/interactive-mode#session-recap">Interactive mode: session recap</a>
+13 −13 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w16
±changed
+10−10
claude-codechanged
whats-new/2026-w16
<span>Releases <a href="/docs/docs/en/changelog#2-1-105">v2.1.105 → v2.1.113</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-105">v2.1.105 → v2.1.113</a></span>
<a className="digest-feature-link" href="/docs/docs/en/model-config#adjust-effort-level">Model config: effort levels</a>
<a className="digest-feature-link" href="/docs/en/model-config#adjust-effort-level">Model config: effort levels</a>
<a className="digest-feature-link" href="/docs/docs/en/routines">Routines guide</a>
+10 −10 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w15
±changed
+6−6
claude-codechanged
whats-new/2026-w15
<span>Releases <a href="/docs/docs/en/changelog#2-1-92">v2.1.92 → v2.1.101</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-92">v2.1.92 → v2.1.101</a></span>
<a className="digest-feature-link" href="/docs/docs/en/ultraplan">Ultraplan guide</a>
<a className="digest-feature-link" href="/docs/en/ultraplan">Ultraplan guide</a>
<a className="digest-feature-link" href="/docs/docs/en/tools-reference#monitor-tool">Monitor tool reference</a>
+6 −6 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w14
±changed
+6−6
claude-codechanged
whats-new/2026-w14
<span>Releases <a href="/docs/docs/en/changelog#2-1-86">v2.1.86 → v2.1.91</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-86">v2.1.86 → v2.1.91</a></span>
<a className="digest-feature-link" href="/docs/docs/en/computer-use">Computer use guide</a>
<a className="digest-feature-link" href="/docs/en/computer-use">Computer use guide</a>
<a className="digest-feature-link" href="/docs/docs/en/commands">Commands reference</a>
+6 −6 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w13
±changed
+7−7
claude-codechanged
whats-new/2026-w13
<span>Releases <a href="/docs/docs/en/changelog#2-1-83">v2.1.83 → v2.1.85</a></span>
<span>Releases <a href="/docs/en/changelog#2-1-83">v2.1.83 → v2.1.85</a></span>
<a className="digest-feature-link" href="/docs/docs/en/permission-modes">Permission modes guide</a>
<a className="digest-feature-link" href="/docs/en/permission-modes">Permission modes guide</a>
<a className="digest-feature-link" href="/docs/docs/en/desktop#let-claude-use-your-computer">Computer use guide</a>
+7 −7 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
headless
±changed
+20−0
claude-codechanged
headless
### Turn off permission prompts in unattended runs
Pass `--permission-prompts none` when nobody is available to answer permission prompts, for example in a scheduled job. The flag matters most when your run has a permission host: a
With the flag, your run doesn't consult the host or wait on it. Anything that would prompt is denied unless a `PermissionRequest` hook allows it, Claude is told that nobody can app
+20 −0 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
cli-reference
±changed
+1−0
claude-codechanged
cli-reference
| `--permission-prompts` | Set who answers permission prompts in print mode. With the default `host`, Claude Code sends them to the Agent SDK host or the `
+1 −0 lines
Recorded here 4 Sep 2026 00:37 UTC
claude-code
whats-new/2026-w34
±changed
+6−6
claude-codechanged
whats-new/2026-w34
Releases [v2.1.234 → v2.1.239](/docs/en/changelog#2-1-234)
Releases [v2.1.234 → v2.1.239](/docs/en/changelog.md#2-1-234)
[Where artifacts are available](/docs/en/artifacts#availability)
[Where artifacts are available](/docs/en/artifacts.md#availability)
[Built-in output styles](/docs/en/output-styles#built-in-output-styles)
+6 −6 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
whats-new/2026-w29
±changed
+5−5
claude-codechanged
whats-new/2026-w29
Releases [v2.1.207 → v2.1.212](/docs/en/changelog#2-1-207)
Releases [v2.1.207 → v2.1.212](/docs/en/changelog.md#2-1-207)
[Pull live data with MCP connectors](/docs/en/artifacts#pull-live-data-with-mcp-connectors)
[Pull live data with MCP connectors](/docs/en/artifacts.md#pull-live-data-with-mcp-connectors)
[Turn on screen reader mode](/docs/en/accessibility#turn-on-screen-reader-mode)
+5 −5 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
whats-new/2026-w28
±changed
+4−4
claude-codechanged
whats-new/2026-w28
Releases [v2.1.202 → v2.1.206](/docs/en/changelog#2-1-202)
Releases [v2.1.202 → v2.1.206](/docs/en/changelog.md#2-1-202)
[Browse external sites](/docs/en/desktop#browse-external-sites)
[Browse external sites](/docs/en/desktop.md#browse-external-sites)
[All commands](/docs/en/commands#all-commands)
+4 −4 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
whats-new/2026-w27
±changed
+8−8
claude-codechanged
whats-new/2026-w27
Releases [v2.1.195 → v2.1.201](/docs/en/changelog#2-1-195)
Releases [v2.1.195 → v2.1.201](/docs/en/changelog.md#2-1-195)
[Model configuration](/docs/en/model-config#available-models)
[Model configuration](/docs/en/model-config.md#available-models)
[Use Claude Code with Chrome](/docs/en/chrome)
+8 −8 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
whats-new/2026-w26
±changed
+4−4
claude-codechanged
whats-new/2026-w26
Releases [v2.1.185 → v2.1.193](/docs/en/changelog#2-1-185)
Releases [v2.1.185 → v2.1.193](/docs/en/changelog.md#2-1-185)
[Authenticate from the command line](/docs/en/mcp#authenticate-from-the-command-line)
[Authenticate from the command line](/docs/en/mcp.md#authenticate-from-the-command-line)
[Shell mode with the ! prefix](/docs/en/interactive-mode#shell-mode-with-prefix)
+4 −4 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
whats-new/2026-w25
±changed
+5−5
claude-codechanged
whats-new/2026-w25
Releases [v2.1.178 → v2.1.183](/docs/en/changelog#2-1-178)
Releases [v2.1.178 → v2.1.183](/docs/en/changelog.md#2-1-178)
[Create an artifact](/docs/en/artifacts#create-an-artifact)
[Create an artifact](/docs/en/artifacts.md#create-an-artifact)
[Match by input parameter](/docs/en/permissions#match-by-input-parameter)
+5 −5 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
whats-new/2026-w24
±changed
+5−5
claude-codechanged
whats-new/2026-w24
Releases [v2.1.166 → v2.1.176](/docs/en/changelog#2-1-166)
Releases [v2.1.166 → v2.1.176](/docs/en/changelog.md#2-1-166)
[Commands reference](/docs/en/commands#all-commands)
[Commands reference](/docs/en/commands.md#all-commands)
[Spawn nested subagents](/docs/en/sub-agents#let-subagents-spawn-their-own-subagents)
+5 −5 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
whats-new/2026-w15
±changed
+6−6
claude-codechanged
whats-new/2026-w15
Releases [v2.1.92 → v2.1.101](/docs/en/changelog#2-1-92)
Releases [v2.1.92 → v2.1.101](/docs/en/changelog.md#2-1-92)
[Monitor tool reference](/docs/en/tools-reference#monitor-tool)
[Monitor tool reference](/docs/en/tools-reference.md#monitor-tool)
[Auto-fix pull requests](/docs/en/claude-code-on-the-web#auto-fix-pull-requests)
+6 −6 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
whats-new/2026-w34
±changed
+36−72
claude-codechanged
whats-new/2026-w34
<div className="digest-meta">
<span>Releases <a href="/docs/en/changelog#2-1-234">v2.1.234 → v2.1.239</a></span>
<span>3 features · August 17–21</span>
</div>
Releases [v2.1.234 → v2.1.239](/docs/en/changelog#2-1-234)
+36 −72 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
whats-new/2026-w29
±changed
+21−47
claude-codechanged
whats-new/2026-w29
<div className="digest-meta">
<span>Releases <a href="/docs/en/changelog#2-1-207">v2.1.207 → v2.1.212</a></span>
<span>2 features · July 13–17</span>
</div>
Releases [v2.1.207 → v2.1.212](/docs/en/changelog#2-1-207)
+21 −47 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
whats-new/2026-w28
±changed
+17−42
claude-codechanged
whats-new/2026-w28
<div className="digest-meta">
<span>Releases <a href="/docs/en/changelog#2-1-202">v2.1.202 → v2.1.206</a></span>
<span>2 features · July 6–10</span>
</div>
Releases [v2.1.202 → v2.1.206](/docs/en/changelog#2-1-202)
+17 −42 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
whats-new/2026-w27
±changed
+33−71
claude-codechanged
whats-new/2026-w27
<div className="digest-meta">
<span>Releases <a href="/docs/en/changelog#2-1-195">v2.1.195 → v2.1.201</a></span>
<span>5 features · June 29 – July 3</span>
</div>
Releases [v2.1.195 → v2.1.201](/docs/en/changelog#2-1-195)
+33 −71 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
whats-new/2026-w26
±changed
+20−44
claude-codechanged
whats-new/2026-w26
<div className="digest-meta">
<span>Releases <a href="/docs/en/changelog#2-1-185">v2.1.185 → v2.1.193</a></span>
<span>2 features · June 22–26</span>
</div>
Releases [v2.1.185 → v2.1.193](/docs/en/changelog#2-1-185)
+20 −44 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
whats-new/2026-w25
±changed
+31−61
claude-codechanged
whats-new/2026-w25
<div className="digest-meta">
<span>Releases <a href="/docs/en/changelog#2-1-178">v2.1.178 → v2.1.183</a></span>
<span>3 features · June 15–19</span>
</div>
Releases [v2.1.178 → v2.1.183](/docs/en/changelog#2-1-178)
+31 −61 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
whats-new/2026-w24
±changed
+28−57
claude-codechanged
whats-new/2026-w24
<div className="digest-meta">
<span>Releases <a href="/docs/en/changelog#2-1-166">v2.1.166 → v2.1.176</a></span>
<span>3 features · June 8–12</span>
</div>
Releases [v2.1.166 → v2.1.176](/docs/en/changelog#2-1-166)
+28 −57 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
whats-new/2026-w15
±changed
+43−82
claude-codechanged
whats-new/2026-w15
<div className="digest-meta">
<span>Releases <a href="/docs/en/changelog#2-1-92">v2.1.92 → v2.1.101</a></span>
<span>4 features · April 6–10</span>
</div>
Releases [v2.1.92 → v2.1.101](/docs/en/changelog#2-1-92)
+43 −82 lines
Upstream edited 4 Sep 2026 00:23 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
server-managed-settings
±changed
+1−1
claude-codechanged
server-managed-settings
Delivered payloads parse tolerantly with the same rules as the other managed sources. When part of a payload fails schema validation, Claude Code surfaces a validation error and ap
When part of a payload fails schema validation, Claude Code surfaces a validation error and applies every remaining valid setting; [Invalid entries in managed settings](/docs/en/ma
+1 −1 lines
Recorded here 4 Sep 2026 00:07 UTC
claude-code
monitoring-usage
±changed
+1−1
claude-codechanged
monitoring-usage
When Claude Code can't safely determine the retention period, it pauses the sweep and emits the event with `result` set to `"skipped"` and a `skip_reason`. When [managed settings](
When Claude Code can't safely determine the retention period, it pauses the sweep and emits the event with `result` set to `"skipped"` and a `skip_reason`. When [managed settings](
+1 −1 lines
Recorded here 4 Sep 2026 00:07 UTC
claude-code
managed-settings
±changed
+20−4
claude-codechanged
managed-settings
* **The line is missing**: Claude Code found no managed source that delivers a policy key. If you deployed a managed settings file, check that it sits at the path for the OS, that
* **The line is missing**: Claude Code found no managed source that delivers a policy key.
If you deployed a managed settings file, check that it sits at the path for the OS and that it contains a [policy key](#how-claude-code-combines-managed-sources) rather than only
When a managed settings file, MDM profile, registry value, or server-managed payload fails schema validation, Claude Code first skips the individual entries it can repair, such as
+20 −4 lines
Recorded here 4 Sep 2026 00:07 UTC
claude-code
hooks
±changed
+4−2
claude-codechanged
hooks
PermissionRequest hooks receive `tool_name` and `tool_input` fields like PreToolUse hooks, but without `tool_use_id`. An optional `permission_suggestions` array contains the "alway
PermissionRequest hooks receive `tool_name` and `tool_input` fields like PreToolUse hooks, but without `tool_use_id`. An optional `permission_suggestions` array contains the [permi
The permission dialog builds its "always allow" options from these suggestions, but the array isn't an exact list of the options you see. The dialog can withhold an option whose su
A hook can echo one of the `permission_suggestions` it received as its own `updatedPermissions` output, which is equivalent to the user selecting that "always allow" option in the
+4 −2 lines
Recorded here 4 Sep 2026 00:07 UTC
claude-code
errors
±changed
+31−0
claude-codechanged
errors
| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.`
| `Managed settings drop-in directory could not be read`
<h3 id="managed-settings-document-could-not-be-parsed">
Managed settings document could not be parsed
</h3>
+31 −0 lines
Recorded here 4 Sep 2026 00:07 UTC
claude-code
changelog
±changed
+69−0
claude-codechanged
changelog
<Update label="2.1.260" description="September 3, 2026">
* Added a diff panel that opens beside the conversation in fullscreen mode and shows your uncommitted changes as Claude edits; toggle it with `/diff`
* Added a likely cause for prompt-cache misses (e.g. tool definitions or system prompt changed, idle past the TTL) to `/cost` and the status line's `prompt_cache` field
* Added `/reload-plugins` to headless sessions, so it appears in the Claude Code Desktop and SDK command lists
+69 −0 lines
Recorded here 4 Sep 2026 00:07 UTC
3 Sep 2026
19 pages
+444 −269 lines
claude-code
sub-agents
±changed
+5−1
claude-codechanged
sub-agents
When something [cuts off a subagent's response mid-stream](/docs/en/errors#the-response-above-may-be-incomplete), and the partial response contains text but no tool calls, Claude C
As of v2.1.191, a subagent you stopped yourself, with `x` in `/tasks` or an SDK `stop_task` request, doesn't auto-resume. The `SendMessage` call returns a refusal telling Claude th
A subagent you stopped yourself, with `x` in `/tasks` or an SDK `stop_task` request, doesn't auto-resume. If Claude sends it a message, the message is refused and Claude is told th
+5 −1 lines
Recorded here 3 Sep 2026 23:37 UTC
claude-code
settings-reference
±changed
+253−226
claude-codechanged
settings-reference
| Key | Description
| :---------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------
| [`advisorModel`](#advisormodel) | Pick which model answers when Claude asks the [advisor tool](/docs/en/advisor)
| [`agent`](#agent) | Start every session as a named [subagent](/docs/en/sub-agents) with its prompt,
| [`agentPushNotifEnabled`](#agentpushnotifenabled) | Let Claude send a [push notification to your phone](/docs/en/remote-control#mobi
+253 −226 lines
Recorded here 3 Sep 2026 23:37 UTC
claude-code
security
±changed
+1−1
claude-codechanged
security
* **Working directory boundary**: In Manual mode, Claude Code can only write to the folder where it was started and its subfolders, and can't modify files in parent directories wit
* **Working directory boundary**: In Manual mode, Claude Code can only write to the folder where it was started and its subfolders, and can't modify files in parent directories wit
+1 −1 lines
Recorded here 3 Sep 2026 23:37 UTC
claude-code
sandboxing
±changed
+4−2
claude-codechanged
sandboxing
When a command can be sandboxed, Claude Code runs it inside the sandbox and approves it automatically, without asking your permission. Commands that cannot be sandboxed, such as th
When a command can be sandboxed, Claude Code runs it inside the sandbox and approves it automatically, without asking your permission. Commands that cannot be sandboxed, such as th
The retried command runs outside the sandbox, so it goes through the regular permission flow: in Manual mode you get a confirmation prompt; in [auto mode](/docs/en/permission-modes
The retried command runs outside the sandbox, so it goes through the regular permission flow. In Manual mode you get a confirmation prompt. In [auto mode](/docs/en/permission-modes
+4 −2 lines
Recorded here 3 Sep 2026 23:37 UTC
claude-code
permissions
±changed
+4−2
claude-codechanged
permissions
Claude Code recognizes a built-in set of Bash commands as read-only and runs them without a permission prompt in every mode. These include `ls`, `cat`, `echo`, `pwd`, `head`, `tail
Claude Code recognizes a built-in set of Bash commands as read-only and runs them without a permission prompt in every mode, except for a path that [`permissions.blockReadsOutsideW
Set [`permissions.blockReadsOutsideWorkingDirectories`](/docs/en/settings-reference#permissions-blockreadsoutsideworkingdirectories) to make the file tools refuse the paths it fenc
In [plan mode](/docs/en/permission-modes#analyze-before-you-edit-with-plan-mode), Claude Code skips this substitution. Without an ask rule, the built-in read-only commands still ru
+4 −2 lines
Recorded here 3 Sep 2026 23:37 UTC
claude-code
permission-modes
±changed
+16−1
claude-codechanged
permission-modes
* Reads outside the working directories while [`permissions.blockReadsOutsideWorkingDirectories`](/docs/en/settings-reference#permissions-blockreadsoutsideworkingdirectories) is on
<h3 id="first-read-outside-the-working-directories">
The first read outside the working directories
</h3>
+16 −1 lines
Recorded here 3 Sep 2026 23:37 UTC
claude-code
network-config
±changed
+3−1
claude-codechanged
network-config
When a watchdog aborts a stalled stream, Claude Code treats it as a mid-stream failure: depending on how far the response had got, it retries the request or ends the turn with an e
When a watchdog aborts a stalled stream, Claude Code treats the abort as a mid-stream failure, and what you see depends on how far the response had got. Claude Code retries the req
In a [non-interactive session](/docs/en/headless), and for a subagent's response in any session, Claude Code may first prompt Claude to continue the cut-off response; [that notice'
+3 −1 lines
Recorded here 3 Sep 2026 23:37 UTC
claude-code
errors
±changed
+3−2
claude-codechanged
errors
* After Claude has completed a block of text or a tool call, or started one after finishing its thinking, but before Claude has finished the response, Claude Code keeps what Claude
* After Claude has completed a block of text or a tool call, or started one after finishing its thinking, but before Claude has finished the response, Claude Code keeps what Claude
In three cases, Claude Code handles the failure without showing this notice right away:
In four cases, Claude Code handles the failure without showing this notice right away:
* In a [subagent](/docs/en/sub-agents#api-errors-in-subagents), whether the session is interactive or not: when its cut-off response contains text but no tool calls, Claude Code pr
+3 −2 lines
Recorded here 3 Sep 2026 23:37 UTC
claude-code
agent-sdk/typescript
±changed
+2−2
claude-codechanged
agent-sdk/typescript
| `supportedCommands()` | Returns available slash commands. From Agent SDK v0.3.216 the list reflects mid-session command changes; see [`SDKCommandsChangedMessage`
| `supportedCommands()` | Returns available commands. From Agent SDK v0.3.216 the list reflects mid-session command changes; see [`SDKCommandsChangedMessage`](#sdk
Information about an available slash command.
Information about an available command.
+2 −2 lines
Recorded here 3 Sep 2026 16:37 UTC
claude-code
agent-sdk/python
±changed
+1−1
claude-codechanged
agent-sdk/python
* `terminal_reason`: why the query loop ended, such as `"completed"`, `"max_turns"`, `"api_error"`, `"aborted_streaming"`, or `"aborted_tools"`. A value of `"aborted_streaming"` or
* `terminal_reason`: why the query loop ended, such as `"completed"`, `"max_turns"`, `"api_error"`, `"aborted_streaming"`, or `"aborted_tools"`. A value of `"aborted_streaming"` or
+1 −1 lines
Recorded here 3 Sep 2026 16:37 UTC
claude-code
sub-agents
±changed
+31−6
claude-codechanged
sub-agents
* **Model**: inherits from the main conversation, capped at Opus on the Claude API, so Explore never runs on a more expensive model than the one you already chose for the sessi
* **Model**: inherits from the main conversation, capped at Opus on the Claude API, so Explore never runs on a more expensive model than the one you already chose for the sessi
* **Model**: inherits from the main conversation, unless you [force `CLAUDE_CODE_SUBAGENT_MODEL` onto it](#choose-a-model)
* **Model**: inherits from the main conversation, unless you set `CLAUDE_CODE_SUBAGENT_MODEL` and [force it onto every subagent](#run-every-subagent-on-one-model)
* **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
+31 −6 lines
Recorded here 3 Sep 2026 03:37 UTC
claude-code
model-config
±changed
+7−7
claude-codechanged
model-config
| Environment variable | Description
| -------------------------------- | -----------------------------------------------------------------------------------------------------------------------------------------------
| `ANTHROPIC_DEFAULT_FABLE_MODEL` | The model to use for `fable`, and the model ID Claude Code recognizes as a Fable model for [automatic model fallback](#automatic-model-fallback
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | The model to use for `opus`, or for `opusplan` when Plan Mode is active.
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | The model to use for `sonnet`, or for `opusplan` when Plan Mode is not active.
+7 −7 lines
Recorded here 3 Sep 2026 03:37 UTC
claude-code
env-vars
±changed
+2−2
claude-codechanged
env-vars
| `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_FORCE` | Set to `1` to force one model onto subagents, teammates, and workflow agents. [Choose a model](/docs/en/sub-agents#choos
| `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_FORCE` | Set to `1` to force one model onto subagents, teammates, and workflow agents. [Run every subagent on one model](/docs/en
+2 −2 lines
Recorded here 3 Sep 2026 03:37 UTC
claude-code
agent-teams
±changed
+1−1
claude-codechanged
agent-teams
[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/en/sub-agents#choose-a-model) applies to teammates as well as to subagents.
[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/en/sub-agents#run-every-subagent-on-one-model) applies to teammates as well as to subagents.
+1 −1 lines
Recorded here 3 Sep 2026 03:37 UTC
claude-code
settings-reference
±changed
+2−2
claude-codechanged
settings-reference
Point the PR links Claude Code renders, in the footer badge and in tool-result summaries, at an internal code-review tool instead of `github.com`. Claude Code substitutes `{host}`,
Point the PR links Claude Code renders, in the footer badge and in tool-result summaries, at an internal code-review tool instead of `github.com`. Claude Code substitutes `{host}`,
* **Default**: unset, so links use the `gh`-reported URL
* **Default**: unset
+2 −2 lines
Recorded here 3 Sep 2026 03:07 UTC
claude-code
self-hosted-environments-reference
±changed
+1−1
claude-codechanged
self-hosted-environments-reference
| `--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` | Terminate a session child once it has lived N minu
+1 −1 lines
Recorded here 3 Sep 2026 03:07 UTC
claude-code
self-hosted-environments-deploy
±changed
+2−0
claude-codechanged
self-hosted-environments-deploy
`--kill-session-after-min` is a backstop for runaway sessions. The runner terminates any session that reaches the limit, even one someone is still using, so set the flag well above
+2 −0 lines
Recorded here 3 Sep 2026 03:07 UTC
claude-code
plugins-reference
±changed
+34−0
claude-codechanged
plugins-reference
### plugin validate
Check a plugin or a marketplace for syntax and schema errors before publishing.
The command exits 0 when validation passes, 1 when it fails, and 2 when the validation run itself fails, such as when the path you pass is unreadable.
+34 −0 lines
Recorded here 3 Sep 2026 03:07 UTC
claude-code
interactive-mode
±changed
+15−8
claude-codechanged
interactive-mode
The badge disappears once the pull request merges or closes. `Cmd+click` (macOS) or `Ctrl+click` (Windows/Linux) the link to open the pull request in your browser. How often Claude
* **Anthropic API with [feature-flag fetching](/docs/en/env-vars#features-that-need-feature-flag-fetching) on**: about every 90 seconds while you're active in the session, and less
* **Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS, or feature-flag fetching off**: every 60 seconds
+15 −8 lines
Recorded here 3 Sep 2026 03:07 UTC
claude-code
env-vars
±changed
+1−2
claude-codechanged
env-vars
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Set to any non-empty value, such as `1`, to disable nonessential network traffic: auto-updates, telemetry, error reporti
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Set to any non-empty value, such as `1`, to disable nonessential network traffic: auto-updates, telemetry, error reporti
* Have Claude Code refresh the [PR review status badge](/docs/en/interactive-mode#pr-review-status) less often while you're idle; Claude Code refreshes it every 60 seconds instead
+1 −2 lines
Recorded here 3 Sep 2026 03:07 UTC
claude-code
prompt-caching
±changed
+16−1
claude-codechanged
prompt-caching
* [Accumulating many images](#accumulating-many-images)
### Accumulating many images
The API limits how many images and PDFs each request can carry. For the current numbers, see [Request limits](https://platform.claude.com/docs/en/build-with-claude/vision#request-l
+16 −1 lines
Recorded here 3 Sep 2026 02:37 UTC
claude-code
changelog
±changed
+40−0
claude-codechanged
changelog
<Update label="2.1.259" description="September 2, 2026">
* Added `managedMcpServers` managed setting: organizations can provide HTTP/SSE MCP servers to every user (same entry shape as `.mcp.json`); entries that name a command to run ar
* Added `--permission-prompts none` for unattended headless hosts: anything that would prompt is denied automatically while the active permission mode (including auto mode) keeps
* Added recognition of `glab mr create/merge/close/reopen/note/update` so GitLab merge requests show as `MR !N` in the collapsed tool summary and refresh the footer MR badge
+40 −0 lines
Recorded here 3 Sep 2026 00:37 UTC
2 Sep 2026
25 pages
+282 −217 lines
claude-code
desktop-ios-simulator
±changed
+2−2
claude-codechanged
desktop-ios-simulator
The iOS Simulator pane is in public beta in Claude Code Desktop on macOS. It's available on Pro, Max, Team, and Enterprise plans, except in Enterprise organizations that have a H
The iOS Simulator pane is in public beta in Claude Code Desktop on macOS. It's available on Pro, Max, Team, and Enterprise plans, except in Enterprise organizations that have a H
* If you're in an Enterprise organization that has a HIPAA configuration or ZDR enabled, the simulator pane isn't available to you.
* If you're in an Enterprise organization that has a HIPAA configuration enabled, the simulator pane isn't available to you.
+2 −2 lines
Recorded here 2 Sep 2026 05:07 UTC
claude-code
vs-code
±changed
+32−17
claude-codechanged
vs-code
* **Command menu**: click `/` or type `/` to open the command menu. Options include attaching files, switching models, toggling extended thinking, viewing plan usage (`/usage`), an
* **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
* **Command menu**: click `/` or type `/` to open the command menu. Options include attaching files, switching models, and toggling extended thinking. The Customize section provide
* To browse commands such as `/usage` or [`/remote-control`](/docs/en/remote-control), select **Slash commands** in the Customize section. A dialog lists them with a filter box.
* Select **Output styles** in the Customize section to pick an [output style](/docs/en/output-styles), including your custom styles. Requires Claude Code v2.1.257 or later.
+32 −17 lines
Recorded here 2 Sep 2026 02:07 UTC
claude-code
remote-control
±changed
+1−1
claude-codechanged
remote-control
In the [Claude Code VS Code extension](/docs/en/vs-code), type `/remote-control` or `/rc` in the prompt box, or open the command menu with `/` and select it.
In the [Claude Code VS Code extension](/docs/en/vs-code), type `/remote-control` or `/rc` in the prompt box.
+1 −1 lines
Recorded here 2 Sep 2026 02:07 UTC
claude-code
output-styles
±changed
+1−0
claude-codechanged
output-styles
* **VS Code extension**: open the [command menu](/docs/en/vs-code#use-the-prompt-box) with `/` and select **Output styles** to pick a style, including your custom styles. Claude Co
+1 −0 lines
Recorded here 2 Sep 2026 02:07 UTC
claude-code
llm-gateway-connect
±changed
+1−1
claude-codechanged
llm-gateway-connect
If you export the gateway only in your shell, it doesn't reliably reach background agents hosted by the [supervisor](/docs/en/agent-view#how-background-sessions-are-hosted); see [h
If you export the gateway only in your shell, it doesn't reliably reach background agents hosted by the [supervisor](/docs/en/agent-view#how-background-sessions-are-hosted); see [h
+1 −1 lines
Recorded here 2 Sep 2026 02:07 UTC
claude-code
cross-session-messaging
±changed
+1−1
claude-codechanged
cross-session-messaging
* **Your other local sessions**: Claude Code sessions running on the same machine, including [background sessions](/docs/en/agent-view). A session appears only when it binds an [in
* **Your other local sessions**: Claude Code sessions running on the same machine, including [background sessions](/docs/en/agent-view). A session appears only when it binds an [in
+1 −1 lines
Recorded here 2 Sep 2026 02:07 UTC
claude-code
claude-directory
±changed
+20−19
claude-codechanged
claude-directory
| Path under `~/.claude/` | Contents
| -------------------------------------------- | -----------------------------------------------------------------------------------------------------------------------------------
| `projects/<project>/<session>.jsonl` | Full conversation transcript: every message, tool call, and tool result
| `projects/<project>/<session>/subagents/` | [Subagent](/docs/en/sub-agents) conversation transcripts, removed with the parent session transcript when it ages out
| `projects/<project>/<session>/tool-results/` | Large tool outputs spilled to separate files
+20 −19 lines
Recorded here 2 Sep 2026 02:07 UTC
claude-code
agent-view
±changed
+32−68
claude-codechanged
agent-view
A background session reads its [settings](/docs/en/settings) from the directory it runs in, the same as if you had started `claude` there. This includes [`env` values](/docs/en/set
Cloud provider selection, such as `CLAUDE_CODE_USE_BEDROCK` or `CLAUDE_CODE_USE_VERTEX`, and `ANTHROPIC_DEFAULT_*_MODEL` aliases follow the shell that dispatched the session. If yo
A background session reads its [settings](/docs/en/settings) from the directory it runs in, the same as if you had started `claude` there. This includes [`env` values](/docs/en/set
+32 −68 lines
Recorded here 2 Sep 2026 02:07 UTC
claude-code
settings-reference
±changed
+17−19
claude-codechanged
settings-reference
| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Make [managed settings](/docs/en/managed-settings) the only source of [permissio
| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Make [managed settings](/docs/en/managed-settings) the only settings source of [
| [`permissionExplainerEnabled`](#permissionexplainerenabled) | Turn off the Ctrl+E command explanation on shell [permission prompts](/docs/en/p
| [`permissionExplainerEnabled`](#permissionexplainerenabled) | Removed in v2.1.257, together with the `Ctrl+E` command explanation on shell per
Make managed settings the only source of `allow`, `ask`, and `deny` permission rules. Claude Code then ignores rules in user, project, local, and `--settings` files, ignores `--all
+17 −19 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
settings-example
±changed
+2−2
claude-codechanged
settings-example
* `allowManagedPermissionRulesOnly` and `allowManagedMcpServersOnly` make the managed permission and MCP allowlists the only ones that apply
* [`allowManagedPermissionRulesOnly`](/docs/en/settings-reference#allowmanagedpermissionrulesonly) and [`allowManagedMcpServersOnly`](/docs/en/settings-reference#allowmanagedmcpser
// Only managed permission rules apply
// Ignore permission rules from user, project, and local settings
+2 −2 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
sessions
±changed
+9−9
claude-codechanged
sessions
| Session ended in | How you resume | Permission mode after you resume
| :------------------ | :------------------------------------------------------------------------- | :------------------------------------------------------------------------------
| `bypassPermissions` | Terminal | The permission mode a new session would start in. To [bypass permissions](/docs
| `plan` | Terminal | The permission mode a new session would start in
| `auto` | Terminal | `auto`, only when your account still meets the [auto mode requirements](/docs/e
+9 −9 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
permissions
±changed
+3−5
claude-codechanged
permissions
On a Bash or PowerShell permission prompt, press `Ctrl+E` to show an explanation of the command: what it does, why Claude is running it, and what could go wrong, labeled **Low risk
To turn the shortcut off, set [`permissionExplainerEnabled`](/docs/en/settings-reference#permissionexplainerenabled) to `false` in `~/.claude.json`.
For organizations that need centralized control, administrators deploy managed settings that user and project settings can't override, apart from a few [security-sensitive keys](/d
+3 −5 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
permission-modes
±changed
+8−4
claude-codechanged
permission-modes
2. `permissions.defaultMode` in a [settings file](/docs/en/settings#where-settings-live). An `"auto"` value in `.claude/settings.json` or `.claude/settings.local.json` doesn't take
2. `permissions.defaultMode` in a [settings file](/docs/en/settings#where-settings-live)
If you set `"auto"` in `.claude/settings.json` or `.claude/settings.local.json`, the value doesn't take effect, and Claude Code then uses the built-in default rather than a `def
+8 −4 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
managed-settings
±changed
+1−1
claude-codechanged
managed-settings
| [`allowManagedPermissionRulesOnly`](/docs/en/settings-reference#allowmanagedpermissionrulesonly) | Only managed permission rules apply; the entry lists
| [`allowManagedPermissionRulesOnly`](/docs/en/settings-reference#allowmanagedpermissionrulesonly) | Makes managed settings the only settings source of pe
+1 −1 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
keybindings
±changed
+12−11
claude-codechanged
keybindings
| Action | Default | Description
| :-------------------------- | :---------- | :-------------------------------------------------------------------------------------------------------------------------------------
| `confirm:yes` | Y, Enter | Confirm action
| `confirm:no` | N, Escape | Decline action
| `confirm:previous` | Up | Previous option
+12 −11 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
hooks-guide
±changed
+3−1
claude-codechanged
hooks-guide
`bypassPermissions` only applies if the session was launched with bypass mode already available: `--dangerously-skip-permissions`, `--permission-mode bypassPermissions`, `--allow
`bypassPermissions` only applies if you started the session with bypass mode already available: `--dangerously-skip-permissions`, `--permission-mode bypassPermissions`, `--allow-
Claude Code never saves it as `defaultMode`.
+3 −1 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
hooks
±changed
+3−1
claude-codechanged
hooks
`setMode` with `bypassPermissions` only takes effect if the session was launched with bypass mode already available: `--dangerously-skip-permissions`, `--permission-mode bypassPe
`setMode` with `bypassPermissions` only takes effect if you launched the session with bypass mode already available: `--dangerously-skip-permissions`, `--permission-mode bypassPe
`bypassPermissions` is never persisted as `defaultMode` regardless of `destination`.
+3 −1 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
env-vars
±changed
+2−1
claude-codechanged
env-vars
| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall timeout in milliseconds for background subagents. Default `600000` (10 minutes). The timer resets on each streamin
| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Stall timeout in milliseconds for subagents. Default `600000` (10 minutes); if you raise `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Set to `1` to keep the [Claude in Chrome](/docs/en/chrome) browser tools available while omitting the Chrome section of
+2 −1 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
claude-apps-gateway-config
±changed
+8−8
claude-codechanged
claude-apps-gateway-config
| Key | Enforced by | Effect
| ------------------------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------
| `availableModels` | Gateway + CLI | Model allowlist. Also checked at `/v1/messages`, so a patched client can't bypass it.
| `permissions.allow` / `.deny` | CLI | Tool and command rules. See [Permissions](/docs/en/permissions).
| `permissions.disableBypassPermissionsMode` | CLI | Set to `disable` to block [`bypassPermissions`](/docs/en/permission-modes#skip-all-checks-with-bypasspermissions-mode
+8 −8 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
agent-sdk/typescript
±changed
+80−17
claude-codechanged
agent-sdk/typescript
* **`defaultMode`**: the snapshot returns `permissions.defaultMode` as-is from every tier. A live session [ignores `defaultMode: 'auto'` from project and local settings](/docs/en/p
* **`defaultMode`**: the snapshot returns `permissions.defaultMode` as-is from every tier, so it can include the `'auto'` and `'bypassPermissions'` values from project and local se
* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: stall watchdog for subagents launched with `run_in_background`. Default `600000`. Resets on each stream event; on stall it aborts the subag
* `CLAUDE_ENABLE_STREAM_WATCHDOG` with `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborts the request when headers have arrived but the response body stops streaming. The watchdog is on by de
* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: stall watchdog for subagents. While the stream watchdog is on, the default is `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 minutes, which comes t
+80 −17 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
agent-sdk/python
±changed
+27−14
claude-codechanged
agent-sdk/python
* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: stall watchdog for subagents launched with `run_in_background`. Default `600000`. Resets on each stream event; on stall it aborts the subag
* `CLAUDE_ENABLE_STREAM_WATCHDOG` with `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborts the request when headers have arrived but the response body stops streaming. The watchdog is on by de
* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: stall watchdog for subagents. While the stream watchdog is on, the default is `CLAUDE_STREAM_IDLE_TIMEOUT_MS` plus 5 minutes, which comes t
The timer resets on each stream event. On a stall, Claude Code aborts the subagent and reports the stall to the parent. For a background subagent, it also marks the task failed a
+27 −14 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
agent-sdk/hosting
±changed
+6−6
claude-codechanged
agent-sdk/hosting
| Limitation | What to do
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------
| No top-level session timeout | A session does not time out on its own. Set `maxTurns` in TypeScript or `max_turns` in Python to bound how many tool-use rou
| Memory growth over long sessions | Cap session length or recycle subprocesses periodically. See [Scaling and concurrency](#scaling-and-concurrency).
| Large parallel-subagent fanouts can hit rate limits | Break work into smaller batches rather than issuing one wide dispatch.
+6 −6 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
agent-sdk/custom-tools
±changed
+3−1
claude-codechanged
agent-sdk/custom-tools
The `content` array in a tool result accepts `text`, `image`, `audio`, `resource`, and `resource_link` blocks. You can mix them in the same response. In TypeScript, the SDK saves a
The `content` array in a tool result accepts `text`, `image`, `audio`, `resource`, and `resource_link` blocks. You can mix them in the same response. In TypeScript, the SDK saves a
Claude receives each resource link block as a text block containing the link's name, URI, and description. In TypeScript, your application also receives the links themselves as [`r
+3 −1 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
agent-sdk/agent-loop
±changed
+7−7
claude-codechanged
agent-sdk/agent-loop
| Level | Behavior | Good for |
| :--------- | :-------------------------------- | :------------------------------------------------------------------------ |
| `"low"` | Minimal reasoning, fast responses | File lookups, listing directories |
| `"medium"` | Balanced reasoning | Routine edits, standard tasks |
| `"high"` | Thorough analysis | Refactors, debugging |
+7 −7 lines
Recorded here 2 Sep 2026 01:07 UTC
claude-code
admin-setup
±changed
+1−1
claude-codechanged
admin-setup
| [Permission lockdown](/docs/en/permissions#managed-only-settings) | Only managed permission rules apply; disable `--dangerously-skip-permissions`
| [Permission lockdown](/docs/en/permissions#managed-only-settings) | Make managed settings the [only settings source of permission rules](/docs/en/settin
+1 −1 lines
Recorded here 2 Sep 2026 01:07 UTC
1 Sep 2026
39 pages
+462 −205 lines
claude-code
changelog
±changed
+5−0
claude-codechanged
changelog
<Update label="2.1.258" description="September 1, 2026">
* Fixed Claude Code failing to launch on macOS 12 (Monterey), a regression introduced in 2.1.255
* Fixed remote and scheduled sessions failing with "user messages must have non-empty content" after a re-sent permission approval could not be applied
</Update>
+5 −0 lines
Recorded here 1 Sep 2026 23:07 UTC
claude-code
sub-agents
±changed
+5−3
claude-codechanged
sub-agents
* **Model**: inherits from the main conversation, capped at Opus on the Claude API, so Explore never runs on a more expensive model than the one you already chose for the sessi
* **Model**: inherits from the main conversation, capped at Opus on the Claude API, so Explore never runs on a more expensive model than the one you already chose for the sessi
* **Model**: inherits from the main conversation
* **Model**: inherits from the main conversation, unless you [force `CLAUDE_CODE_SUBAGENT_MODEL` onto it](#choose-a-model)
* **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
+5 −3 lines
Recorded here 1 Sep 2026 21:07 UTC
Nothing on this page matches that. Press Enter to search every page of the ledger.