An entry is only as true as the day it was written.
Flags move on the server after a release ships. Anthropic's own notes land days later and their documentation later still. Sometimes an entry turns out to be wrong and gets corrected by hand. All of that is recorded against the entry it happened to, and this is the whole of it in the order it happened.
Nothing here replaces an entry. Every line links to the page its release published, still saying what that release said, because a correction is added and dated rather than swapped in.
| When | Entry | What happened |
|---|---|---|
v2.1.300set_permission_mode |
Documentation arrivedAnthropic's documentation has since written up set_permission_mode, on Configure permissions.
the line in the docs* **To return to auto mode**: switch to a supported model, then call `set_permission_mode("auto")` or `setPermissionMode("auto")`. If you switch the model back without making that call, the session stays in `default` mode. While the unsupp… |
|
v2.1.300set_permission_mode |
Documentation arrivedAnthropic's documentation has since written up set_permission_mode, on Configure permissions.
the line in the docs* **To return to auto mode**: switch to a supported model, then call `set_permission_mode("auto")` or `setPermissionMode("auto")`. If you switch the model back without making that call, the session stays in `default` mode. While the unsupp… |
|
v2.1.296set_model |
Documentation arrivedAnthropic's documentation has since written up set_model, on Configure permissions.
the line in the docsIf you switch a session that's in auto mode to a model that auto mode doesn't support, using [`set_model()`](/docs/en/agent-sdk/python#claudesdkclient), [`setModel()`](/docs/en/agent-sdk/typescript#query-object), or [`applyFlagSettings()`]… |
|
v2.1.296set_model |
Documentation arrivedAnthropic's documentation has since written up set_model, on Configure permissions.
the line in the docsIf you switch a session that's in auto mode to a model that auto mode doesn't support, using [`set_model()`](/docs/en/agent-sdk/python#claudesdkclient), [`setModel()`](/docs/en/agent-sdk/typescript#query-object), or [`applyFlagSettings()`]… |
|
v2.1.296set_model |
Documentation arrivedAnthropic's documentation has since written up set_model, on Configure permissions.
the line in the docsIf you switch a session that's in auto mode to a model that auto mode doesn't support, using [`set_model()`](/docs/en/agent-sdk/python#claudesdkclient), [`setModel()`](/docs/en/agent-sdk/typescript#query-object), or [`applyFlagSettings()`]… |
|
v2.1.290set_model |
Documentation arrivedAnthropic's documentation has since written up set_model, on Configure permissions.
the line in the docsIf you switch a session that's in auto mode to a model that auto mode doesn't support, using [`set_model()`](/docs/en/agent-sdk/python#claudesdkclient), [`setModel()`](/docs/en/agent-sdk/typescript#query-object), or [`applyFlagSettings()`]… |
|
v2.1.299WebFetch |
Documentation arrivedA small documentation edit on Intercept and control agent behavior with hooks touched a line naming WebFetch after this was published.
the line in the docs| `matcher` | `string` | `undefined` | Pattern matched against the event's filter field, following the [rules for matchers in settings files](/docs/en/hooks#matcher-patterns). For tool hooks, that field is the tool name. Built-in tools inc… |
|
v2.1.299WebFetch |
Documentation arrivedA small documentation edit on Intercept and control agent behavior with hooks touched a line naming WebFetch after this was published.
the line in the docs| `matcher` | `string` | `undefined` | Pattern matched against the event's filter field, following the [rules for matchers in settings files](/docs/en/hooks#matcher-patterns). For tool hooks, that field is the tool name. Built-in tools inc… |
|
v2.1.274dimColor |
Documentation arrivedA small documentation edit on Draw in the interface with a mod touched a line naming dimColor after this was published.
the line in the docs| `Text` | Styled text. Takes `color`, `bold`, `dimColor`, `italic`, `wrap`, and others such as [`weight`](/docs/en/plugins/mods/reference#text-typography). A `color` is a theme key or a color such as `'red'`. A `wrap` is `'wrap'`, `'trunc… |
|
v2.1.301--plugin-dir |
Documentation arrivedAnthropic's documentation has since written up --plugin-dir, on Claude Code changelog.
the line in the docs* Windows: Fixed every file write being refused or asked about for projects on exFAT or FAT32 drives, including in sessions started with `--plugin-dir` |
|
v2.1.287claude plugin details |
Documentation arrivedAnthropic's documentation has since written up claude plugin details, on Claude Code changelog.
the line in the docs* Fixed `claude plugin details <name>@builtin` suggesting `claude plugin list`, which never shows built-in plugins, when the plugin isn't found; it now points to `/plugin` |
|
v2.1.300/autocompact |
Documentation arrivedAnthropic's documentation has since written up /autocompact, on Claude Code changelog.
the line in the docs* Fixed `/autocompact` and `/effort` saving to the wrong model when a gateway names Opus 4 or 4.1 with a prefix, such as `anthropic/claude-opus-4-1` |
|
v2.1.299/effort |
Documentation arrivedAnthropic's documentation has since written up /effort, on Claude Code changelog.
the line in the docs* Fixed `/autocompact` and `/effort` saving to the wrong model when a gateway names Opus 4 or 4.1 with a prefix, such as `anthropic/claude-opus-4-1` |
|
v2.1.299claude mcp serve |
Documentation arrivedAnthropic's documentation has since written up claude mcp serve, on Claude Code changelog.
the line in the docs* Changed fork subagents (`subagent_type: "fork"`) to be on by default in `claude -p`, the Agent SDK, the desktop app and VS Code, as they already are in the terminal; `CLAUDE_CODE_FORK_SUBAGENT=0` turns them off, and `claude mcp serve` ne… |
|
v2.1.295claude mcp serve |
Documentation arrivedAnthropic's documentation has since written up claude mcp serve, on Claude Code changelog.
the line in the docs* Changed fork subagents (`subagent_type: "fork"`) to be on by default in `claude -p`, the Agent SDK, the desktop app and VS Code, as they already are in the terminal; `CLAUDE_CODE_FORK_SUBAGENT=0` turns them off, and `claude mcp serve` ne… |
|
v2.1.295claude mcp serve |
Documentation arrivedAnthropic's documentation has since written up claude mcp serve, on Claude Code changelog.
the line in the docs* Changed fork subagents (`subagent_type: "fork"`) to be on by default in `claude -p`, the Agent SDK, the desktop app and VS Code, as they already are in the terminal; `CLAUDE_CODE_FORK_SUBAGENT=0` turns them off, and `claude mcp serve` ne… |
|
v2.1.295claude mcp serve |
Documentation arrivedAnthropic's documentation has since written up claude mcp serve, on Claude Code changelog.
the line in the docs* Changed fork subagents (`subagent_type: "fork"`) to be on by default in `claude -p`, the Agent SDK, the desktop app and VS Code, as they already are in the terminal; `CLAUDE_CODE_FORK_SUBAGENT=0` turns them off, and `claude mcp serve` ne… |
|
v2.1.300--permission-mode |
Documentation arrivedAnthropic's documentation has since written up --permission-mode, on Claude Code changelog.
the line in the docs* Changed `claude -p` and Agent SDK sessions with no permission mode to start in `default` mode on third-party providers, with telemetry off or on a fresh install; `--permission-mode auto` keeps auto |
|
v2.1.284/design |
Documentation arrivedAnthropic's documentation has since written up /design, on Claude Code changelog.
the line in the docs* Added a notice to `/design-sync` and `/design-login` that standalone Claude Design (claude.ai/design) closes by December 14, 2026 |
|
v2.1.284/design |
Documentation arrivedAnthropic's documentation has since written up /design, on Claude Code changelog.
the line in the docs* Added a notice to `/design-sync` and `/design-login` that standalone Claude Design (claude.ai/design) closes by December 14, 2026 |
|
v2.1.299--resume |
Documentation arrivedA small documentation edit on Manage multiple agents with agent view touched a line naming --resume after this was published.
the line in the docsExcept in the kept cases covered in [What deleting a session removes](#what-deleting-a-session-removes), deleting removes the session from the list, and a worktree Claude created for it is removed, kept, or left in place depending on how y… |
|
v2.1.299--resume |
Documentation arrivedA small documentation edit on Manage multiple agents with agent view touched a line naming --resume after this was published.
the line in the docsExcept in the kept cases covered in [What deleting a session removes](#what-deleting-a-session-removes), deleting removes the session from the list, and a worktree Claude created for it is removed, kept, or left in place depending on how y… |
|
v2.1.301/tasks |
Documentation arrivedAnthropic's documentation has since written up /tasks, on Orchestrate teams of Claude Code sessions.
the line in the docs* **Task list**: `~/.claude/tasks/{team-name}/`. This directory stays on disk after the session ends. To change [how long Claude Code keeps it](/docs/en/claude-directory#cleaned-up-automatically), set [`cleanupPeriodDays`](/docs/en/setting… |
|
v2.1.301rows |
Documentation arrivedA small documentation edit on Deploy Claude Desktop on 3P with the Claude API touched a line naming rows after this was published.
the line in the docs| <span id="inferenceanthropicapikey" />Claude API key<br />`inferenceAnthropicApiKey` | `string` | MDM + Bootstrap<br />Added in 1.8089.0 | — | Leave blank to sign in with your browser, or to supply the key via a credential helper. | |
|
v2.1.301rows |
Documentation arrivedA small documentation edit on Deploy Claude Desktop on 3P with the Claude API touched a line naming rows after this was published.
the line in the docs| <span id="inferenceanthropicapikey" />Claude API key<br />`inferenceAnthropicApiKey` | `string` | MDM + Bootstrap<br />Added in 1.8089.0 | — | Leave blank to sign in with your browser, or to supply the key via a credential helper. | |
|
v2.1.301rows |
Documentation arrivedA small documentation edit on Deploy Claude Desktop on 3P with the Claude API touched a line naming rows after this was published.
the line in the docs| <span id="inferenceanthropicapikey" />Claude API key<br />`inferenceAnthropicApiKey` | `string` | MDM + Bootstrap<br />Added in 1.8089.0 | — | Leave blank to sign in with your browser, or to supply the key via a credential helper. | |
|
v2.1.299/btw |
Documentation arrivedAnthropic's documentation has since written up /btw, on Changelog.
the line in the docs* Changed `/btw` in local sessions to open a side chat in a pane beside the session, with a tab for each side chat (not yet in third-party deployments). |
|
v2.1.301PreToolUse |
Documentation arrivedA small documentation edit on Hooks reference touched a line naming PreToolUse after this was published.
the line in the docsAn [Agent SDK callback hook](/docs/en/agent-sdk/hooks) on `PreToolUse` that exceeds its timeout blocks the tool call, and Claude receives an error result naming the timeout. |
|
v2.1.301PreToolUse |
Documentation arrivedA small documentation edit on Hooks reference touched a line naming PreToolUse after this was published.
the line in the docsAn [Agent SDK callback hook](/docs/en/agent-sdk/hooks) on `PreToolUse` that exceeds its timeout blocks the tool call, and Claude receives an error result naming the timeout. |
|
v2.1.300PreToolUse |
Documentation arrivedA small documentation edit on Hooks reference touched a line naming PreToolUse after this was published.
the line in the docsAn [Agent SDK callback hook](/docs/en/agent-sdk/hooks) on `PreToolUse` that exceeds its timeout blocks the tool call, and Claude receives an error result naming the timeout. |
|
v2.1.300PreToolUse |
Documentation arrivedA small documentation edit on Hooks reference touched a line naming PreToolUse after this was published.
the line in the docsAn [Agent SDK callback hook](/docs/en/agent-sdk/hooks) on `PreToolUse` that exceeds its timeout blocks the tool call, and Claude receives an error result naming the timeout. |
|
v2.1.299PreToolUse |
Documentation arrivedA small documentation edit on Hooks reference touched a line naming PreToolUse after this was published.
the line in the docsAn [Agent SDK callback hook](/docs/en/agent-sdk/hooks) on `PreToolUse` that exceeds its timeout blocks the tool call, and Claude receives an error result naming the timeout. |
|
v2.1.299PreToolUse |
Documentation arrivedA small documentation edit on Hooks reference touched a line naming PreToolUse after this was published.
the line in the docsAn [Agent SDK callback hook](/docs/en/agent-sdk/hooks) on `PreToolUse` that exceeds its timeout blocks the tool call, and Claude receives an error result naming the timeout. |
|
v2.1.300UserPromptExpansion |
Documentation arrivedAnthropic's documentation has since written up UserPromptExpansion, on Intercept and control agent behavior with hooks.
the line in the docs* `UserPromptSubmit` and [`UserPromptExpansion`](/docs/en/hooks#userpromptexpansion): Claude Code blocks the prompt with a message naming the hook and the timeout, and the session continues. Before v2.1.208, Claude Code ended the query wit… |
|
v2.1.300UserPromptSubmit |
Documentation arrivedAnthropic's documentation has since written up UserPromptSubmit, on Intercept and control agent behavior with hooks.
the line in the docs* `UserPromptSubmit` and [`UserPromptExpansion`](/docs/en/hooks#userpromptexpansion): Claude Code blocks the prompt with a message naming the hook and the timeout, and the session continues. Before v2.1.208, Claude Code ended the query wit… |
|
v2.1.300UserPromptSubmit |
Documentation arrivedAnthropic's documentation has since written up UserPromptSubmit, on Intercept and control agent behavior with hooks.
the line in the docs* `UserPromptSubmit` and [`UserPromptExpansion`](/docs/en/hooks#userpromptexpansion): Claude Code blocks the prompt with a message naming the hook and the timeout, and the session continues. Before v2.1.208, Claude Code ended the query wit… |
|
v2.1.299UserPromptSubmit |
Documentation arrivedAnthropic's documentation has since written up UserPromptSubmit, on Intercept and control agent behavior with hooks.
the line in the docs* `UserPromptSubmit` and [`UserPromptExpansion`](/docs/en/hooks#userpromptexpansion): Claude Code blocks the prompt with a message naming the hook and the timeout, and the session continues. Before v2.1.208, Claude Code ended the query wit… |
|
v2.1.299UserPromptSubmit |
Documentation arrivedAnthropic's documentation has since written up UserPromptSubmit, on Intercept and control agent behavior with hooks.
the line in the docs* `UserPromptSubmit` and [`UserPromptExpansion`](/docs/en/hooks#userpromptexpansion): Claude Code blocks the prompt with a message naming the hook and the timeout, and the session continues. Before v2.1.208, Claude Code ended the query wit… |
|
v2.1.299UserPromptSubmit |
Documentation arrivedAnthropic's documentation has since written up UserPromptSubmit, on Intercept and control agent behavior with hooks.
the line in the docs* `UserPromptSubmit` and [`UserPromptExpansion`](/docs/en/hooks#userpromptexpansion): Claude Code blocks the prompt with a message naming the hook and the timeout, and the session continues. Before v2.1.208, Claude Code ended the query wit… |
|
v2.1.299UserPromptSubmit |
Documentation arrivedAnthropic's documentation has since written up UserPromptSubmit, on Intercept and control agent behavior with hooks.
the line in the docs* `UserPromptSubmit` and [`UserPromptExpansion`](/docs/en/hooks#userpromptexpansion): Claude Code blocks the prompt with a message naming the hook and the timeout, and the session continues. Before v2.1.208, Claude Code ended the query wit… |
|
v2.1.300updatedInput |
Documentation arrivedAnthropic's documentation has since written up updatedInput, on Intercept and control agent behavior with hooks.
the line in the docsThis example intercepts Write tool calls and rewrites the `file_path` argument to prepend `/sandbox`. The callback returns `updatedInput` with the modified path and `permissionDecision: 'allow'` to auto-approve the rewritten operation: |
|
v2.1.300updatedInput |
Documentation arrivedAnthropic's documentation has since written up updatedInput, on Intercept and control agent behavior with hooks.
the line in the docsThis example intercepts Write tool calls and rewrites the `file_path` argument to prepend `/sandbox`. The callback returns `updatedInput` with the modified path and `permissionDecision: 'allow'` to auto-approve the rewritten operation: |
|
v2.1.300PostToolUse |
Documentation arrivedAnthropic's documentation has since written up PostToolUse, on Intercept and control agent behavior with hooks.
the line in the docs| `PostToolUse` | Yes | Yes | Tool execution result | Log file changes to an audit trail | |
|
v2.1.299file_path |
Documentation arrivedAnthropic's documentation has since written up file_path, on Intercept and control agent behavior with hooks.
the line in the docsThe hook denies a Write or Edit call whose `file_path` ends in `/.env`, in any letter case. On Windows, `file_path` uses backslashes, such as `C:\project\.env`, and this hook allows a Write or Edit call to `C:\project\.env`. |
|
v2.1.299file_path |
Documentation arrivedAnthropic's documentation has since written up file_path, on Intercept and control agent behavior with hooks.
the line in the docsThe hook denies a Write or Edit call whose `file_path` ends in `/.env`, in any letter case. On Windows, `file_path` uses backslashes, such as `C:\project\.env`, and this hook allows a Write or Edit call to `C:\project\.env`. |
|
v2.1.299onFailure |
Documentation arrivedAnthropic's documentation has since written up onFailure, on MCP, plugins, skills, and hooks.
the line in the docsA [`PreToolUse`](https://code.claude.com/docs/en/hooks#pretooluse) hook that runs this way and has no `onFailure` field blocks the tool call when it fails or times out. The hook error that Claude receives includes `blocking because Git Bas… |
|
v2.1.296onFailure |
Documentation arrivedAnthropic's documentation has since written up onFailure, on MCP, plugins, skills, and hooks.
the line in the docsA [`PreToolUse`](https://code.claude.com/docs/en/hooks#pretooluse) hook that runs this way and has no `onFailure` field blocks the tool call when it fails or times out. The hook error that Claude receives includes `blocking because Git Bas… |
|
v2.1.301PreToolUse |
Documentation arrivedAnthropic's documentation has since written up PreToolUse, on MCP, plugins, skills, and hooks.
the line in the docsA [`PreToolUse`](https://code.claude.com/docs/en/hooks#pretooluse) hook that runs this way and has no `onFailure` field blocks the tool call when it fails or times out. The hook error that Claude receives includes `blocking because Git Bas… |
|
v2.1.301PreToolUse |
Documentation arrivedAnthropic's documentation has since written up PreToolUse, on MCP, plugins, skills, and hooks.
the line in the docsA [`PreToolUse`](https://code.claude.com/docs/en/hooks#pretooluse) hook that runs this way and has no `onFailure` field blocks the tool call when it fails or times out. The hook error that Claude receives includes `blocking because Git Bas… |
|
v2.1.300excludedCommands |
Documentation arrivedAnthropic's documentation has since written up excludedCommands, on SSH remote sessions in Claude Desktop on 3P.
the line in the docs* **Shell commands that Claude runs with its Bash tool**: Claude Code's sandbox keeps them from writing under the path on a host where it runs, which on Linux needs Claude Code's [sandbox dependencies](https://code.claude.com/docs/en/sandb… |