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.281blockReadsOutsideWorkingDirectories |
Documentation arrivedA small documentation edit on Configure permissions touched a line naming blockReadsOutsideWorkingDirectories after this was published.
the line in the docsClaude Code recognizes a built-in set of Bash commands as read-only and runs them without a permission prompt in every mode, except as [`permissions.blockReadsOutsideWorkingDirectories`](/docs/en/settings-reference#permissions-blockreadsou… |
|
v2.1.281CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT |
Documentation arrivedAnthropic's documentation has since written up CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT, on Choose a permission mode.
the line in the docsTo turn off the check on a target that is only command substitution output, set [`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1`](/docs/en/env-vars#variables) in the environment that launches Claude Code. |
|
v2.1.281TMPDIR |
Documentation arrivedAnthropic's documentation has since written up TMPDIR, on Choose a permission mode.
the line in the docs| A shell variable followed by one common top-level directory name, such as `mnt`, `tmp`, `usr`, or `Users` | `rm -rf "$TMPDIR/mnt"` | When the variable expands empty, the command removes `/mnt` | |
|
v2.1.281bypassPermissions |
Documentation arrivedAnthropic's documentation has since written up bypassPermissions, on Choose a permission mode.
the line in the docs* **A glob or trailing slash under a variable such as `$DIR`**: guard each expansion so the shell stops with an error when the variable is unset or empty, as in `rm -rf "${DIR:?}"/*`, or use a literal path. A removal whose expansions are a… |
|
v2.1.284/feedback |
Documentation arrivedAnthropic's documentation has since written up /feedback, on Error reference.
the line in the docs* To use browser sign-in on this machine instead, Claude Code must be able to listen on `127.0.0.1`. If it runs inside a sandbox, check that the sandbox's policy allows listening on local ports, then run `/login` again. If it should be abl… |
|
v2.1.281/feedback |
Documentation arrivedAnthropic's documentation has since written up /feedback, on Error reference.
the line in the docs* To use browser sign-in on this machine instead, Claude Code must be able to listen on `127.0.0.1`. If it runs inside a sandbox, check that the sandbox's policy allows listening on local ports, then run `/login` again. If it should be abl… |
|
v2.1.284/login |
Documentation arrivedAnthropic's documentation has since written up /login, on Error reference.
the line in the docsWhen `/login`, `claude auth login`, or `claude setup-token` signs you in through the browser, Claude Code opens a listening port on `127.0.0.1` so your browser can return the sign-in result to it. This message means Claude Code couldn't op… |
|
v2.1.265--fallback-model |
Documentation arrivedA small documentation edit on Week 22 · May 25–29, 2026 touched a line naming --fallback-model after this was published.
the line in the docs<div>Claude Code now switches to your configured `--fallback-model` for the rest of the session when the primary model is not found, instead of failing every request</div> |
|
v2.1.281--json |
Documentation arrivedA small documentation edit on Week 21 · May 18–22, 2026 touched a line naming --json after this was published.
the line in the docs<div>`claude agents --json` lists live sessions as JSON for scripting, such as status bars and session pickers</div> |
|
v2.1.282/code-review |
Documentation arrivedA small documentation edit on Week 21 · May 18–22, 2026 touched a line naming /code-review after this was published.
the line in the docs<div>New <a href="/docs/en/code-review"><code>/code-review</code></a> command reports correctness bugs at a chosen effort level such as <code>/code-review high</code>, and `--comment` posts findings as inline GitHub PR comments. <code>/sim… |
|
v2.1.257/simplify |
Documentation arrivedA small documentation edit on Week 21 · May 18–22, 2026 touched a line naming /simplify after this was published.
the line in the docs<div>New <a href="/docs/en/code-review"><code>/code-review</code></a> command reports correctness bugs at a chosen effort level such as <code>/code-review high</code>, and `--comment` posts findings as inline GitHub PR comments. <code>/sim… |
|
v2.1.281--mcp-config |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --mcp-config after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.281claude agents |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming claude agents after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.283--plugin-dir |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --plugin-dir after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.281--plugin-dir |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --plugin-dir after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.282--settings |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --settings after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.282--settings |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --settings after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.281--settings |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --settings after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.281--settings |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --settings after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.259--settings |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --settings after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.281--permission-mode |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --permission-mode after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.259--permission-mode |
Documentation arrivedA small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --permission-mode after this was published.
the line in the docs<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a… |
|
v2.1.281--worktree |
Documentation arrivedA small documentation edit on Week 19 · May 4–8, 2026 touched a line naming --worktree after this was published.
the line in the docs<div>New <code>worktree.baseRef</code> setting (<code>fresh</code> | <code>head</code>) controls whether `--worktree`, the <code>EnterWorktree</code> tool, and agent-isolation worktrees branch from the remote default branch or local <code>… |
|
v2.1.281--worktree |
Documentation arrivedA small documentation edit on Week 19 · May 4–8, 2026 touched a line naming --worktree after this was published.
the line in the docs<div>New <code>worktree.baseRef</code> setting (<code>fresh</code> | <code>head</code>) controls whether `--worktree`, the <code>EnterWorktree</code> tool, and agent-isolation worktrees branch from the remote default branch or local <code>… |
|
v2.1.281--worktree |
Documentation arrivedA small documentation edit on Week 19 · May 4–8, 2026 touched a line naming --worktree after this was published.
the line in the docs<div>New <code>worktree.baseRef</code> setting (<code>fresh</code> | <code>head</code>) controls whether `--worktree`, the <code>EnterWorktree</code> tool, and agent-isolation worktrees branch from the remote default branch or local <code>… |
|
v2.1.283--resume |
Documentation arrivedA small documentation edit on Week 14 · March 30 – April 3, 2026 touched a line naming --resume after this was published.
the line in the docs<div>New <code>defer</code> value for <code>permissionDecision</code> in <code>PreToolUse</code> hooks: <code>-p</code> sessions pause at a tool call and exit with a <code>deferred\_tool\_use</code> payload so an SDK app or custom UI can s… |
|
v2.1.281--json |
Documentation arrivedAnthropic's documentation has since written up --json, on Error reference.
the line in the docs| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#the-json-schema-value-is-not-a-valid-json-schema) | |
|
v2.1.268WorktreeRemove |
Documentation arrivedA small documentation edit on Run parallel sessions with worktrees touched a line naming WorktreeRemove after this was published.
the line in the docsWhen you exit an interactive worktree session, Claude checks the worktree for work that removal would delete: changed or untracked files, uncommitted work inside checked-out submodules, and new commits. These rules apply to worktrees Claud… |
|
v2.1.265WorktreeRemove |
Documentation arrivedA small documentation edit on Run parallel sessions with worktrees touched a line naming WorktreeRemove after this was published.
the line in the docsWhen you exit an interactive worktree session, Claude checks the worktree for work that removal would delete: changed or untracked files, uncommitted work inside checked-out submodules, and new commits. These rules apply to worktrees Claud… |
|
v2.1.281--worktree |
Documentation arrivedAnthropic's documentation has since written up --worktree, on Hooks reference.
the line in the docs* **No WorktreeRemove hook**: when you exit a `--worktree` session and choose removal, Claude Code falls back to `git worktree remove --force` on the path your WorktreeCreate hook returned, so a worktree git recognizes is removed. A worktr… |
|
v2.1.281/config |
Documentation arrivedA small documentation edit on Config at the tenant level touched a line naming /config after this was published.
the line in the docs**Group priority order.** You set the priority order between directory groups on the [Identity and access](/docs/government/tenant-admin/identity-and-access#directory-groups) page. Organization owners see this order for reference but canno… |
|
v2.1.283/ide |
Documentation arrivedA small documentation edit on How Config works touched a line naming /ide after this was published.
the line in the docsA tenant administrator sets the priority order on the [Identity and access](/docs/government/tenant-admin/identity-and-access#directory-groups) page. The same priority order is used wherever configuration is resolved for a person; seat-tie… |
|
v2.1.281/ide |
Documentation arrivedA small documentation edit on How Config works touched a line naming /ide after this was published.
the line in the docsA tenant administrator sets the priority order on the [Identity and access](/docs/government/tenant-admin/identity-and-access#directory-groups) page. The same priority order is used wherever configuration is resolved for a person; seat-tie… |
|
v2.1.274CLAUDE_CODE_REMOTE_SESSION_ID |
Documentation arrivedAnthropic's documentation has since written up CLAUDE_CODE_REMOTE_SESSION_ID, on Monitoring.
the line in the docsBy default, metrics and events from a cloud session carry the [standard attributes](#standard-attributes), including `session.id`, `ccr.session.id`, and `organization.id`, so you can filter by session or organization without extra configur… |
|
v2.1.277CLAUDE_CODE_REMOTE |
Documentation arrivedAnthropic's documentation has since written up CLAUDE_CODE_REMOTE, on Monitoring.
the line in the docsBy default, metrics and events from a cloud session carry the [standard attributes](#standard-attributes), including `session.id`, `ccr.session.id`, and `organization.id`, so you can filter by session or organization without extra configur… |
|
v2.1.275CLAUDE_CODE_REMOTE |
Documentation arrivedAnthropic's documentation has since written up CLAUDE_CODE_REMOTE, on Monitoring.
the line in the docsBy default, metrics and events from a cloud session carry the [standard attributes](#standard-attributes), including `session.id`, `ccr.session.id`, and `organization.id`, so you can filter by session or organization without extra configur… |
|
v2.1.273CLAUDE_CODE_REMOTE |
Documentation arrivedAnthropic's documentation has since written up CLAUDE_CODE_REMOTE, on Monitoring.
the line in the docsBy default, metrics and events from a cloud session carry the [standard attributes](#standard-attributes), including `session.id`, `ccr.session.id`, and `organization.id`, so you can filter by session or organization without extra configur… |
|
v2.1.281CLAUDE_CODE_ENABLE_TELEMETRY |
Documentation arrivedAnthropic's documentation has since written up CLAUDE_CODE_ENABLE_TELEMETRY, on Monitoring.
the line in the docsTo export telemetry from those sessions, set `CLAUDE_CODE_ENABLE_TELEMETRY` and the `OTEL_*` variables, using the same keys as the [administrator configuration](#administrator-configuration) example, in one of two places: |
|
v2.1.281/mcp |
Documentation arrivedA small documentation edit on Connect Claude Code to tools via MCP touched a line naming /mcp after this was published.
the line in the docsIf `/mcp` shows a connector as `session token rejected`, or its detail view shows [`claude.ai rejected the session token`](/docs/en/errors#claude-ai-rejected-the-session-token), claude.ai rejected the token from your Claude Code login. Aut… |
|
v2.1.281/install-github-app |
Documentation arrivedAnthropic's documentation has since written up /install-github-app, on Error reference.
the line in the docsCommands that open an interactive dialog can't do so while no terminal is attached to a background session. `/install-github-app`, the `/mcp` settings list, and the authentication actions in the MCP server menu respond with a message. For … |
|
v2.1.281/plugin |
Documentation arrivedAnthropic's documentation has since written up /plugin, on Error reference.
the line in the docsThe marketplace is registered under a name that is [reserved for official Anthropic marketplaces](/docs/en/plugins/marketplace-reference#marketplace-file), but its registered source isn't an `anthropics` GitHub repository. Claude Code re-c… |
|
v2.1.281/plugin |
Documentation arrivedAnthropic's documentation has since written up /plugin, on Error reference.
the line in the docsThe marketplace is registered under a name that is [reserved for official Anthropic marketplaces](/docs/en/plugins/marketplace-reference#marketplace-file), but its registered source isn't an `anthropics` GitHub repository. Claude Code re-c… |
|
v2.1.281/plugin |
Documentation arrivedAnthropic's documentation has since written up /plugin, on Error reference.
the line in the docsThe marketplace is registered under a name that is [reserved for official Anthropic marketplaces](/docs/en/plugins/marketplace-reference#marketplace-file), but its registered source isn't an `anthropics` GitHub repository. Claude Code re-c… |
|
v2.1.281/plugin |
Documentation arrivedAnthropic's documentation has since written up /plugin, on Error reference.
the line in the docsThe marketplace is registered under a name that is [reserved for official Anthropic marketplaces](/docs/en/plugins/marketplace-reference#marketplace-file), but its registered source isn't an `anthropics` GitHub repository. Claude Code re-c… |
|
v2.1.281/plugin |
Documentation arrivedAnthropic's documentation has since written up /plugin, on Error reference.
the line in the docsThe marketplace is registered under a name that is [reserved for official Anthropic marketplaces](/docs/en/plugins/marketplace-reference#marketplace-file), but its registered source isn't an `anthropics` GitHub repository. Claude Code re-c… |
|
v2.1.281/plugin |
Documentation arrivedAnthropic's documentation has since written up /plugin, on Error reference.
the line in the docsThe marketplace is registered under a name that is [reserved for official Anthropic marketplaces](/docs/en/plugins/marketplace-reference#marketplace-file), but its registered source isn't an `anthropics` GitHub repository. Claude Code re-c… |
|
v2.1.281/plugin |
Documentation arrivedAnthropic's documentation has since written up /plugin, on Error reference.
the line in the docsThe marketplace is registered under a name that is [reserved for official Anthropic marketplaces](/docs/en/plugins/marketplace-reference#marketplace-file), but its registered source isn't an `anthropics` GitHub repository. Claude Code re-c… |
|
v2.1.281/plugin |
Documentation arrivedAnthropic's documentation has since written up /plugin, on Error reference.
the line in the docsThe marketplace is registered under a name that is [reserved for official Anthropic marketplaces](/docs/en/plugins/marketplace-reference#marketplace-file), but its registered source isn't an `anthropics` GitHub repository. Claude Code re-c… |
|
v2.1.281MCP_TIMEOUT |
Documentation arrivedAnthropic's documentation has since written up MCP_TIMEOUT, on Error reference.
the line in the docsThe tool you passed to [`--permission-prompt-tool`](/docs/en/cli-reference#cli-flags) wasn't among the connected MCP tools when the run first needed a permission decision, either because its server never connected or because no connected s… |
|
v2.1.281--settings |
Documentation arrivedAnthropic's documentation has since written up --settings, on Error reference.
the line in the docsThe file you passed to [`--settings`](/docs/en/cli-reference#cli-flags) is larger than 2 MiB, so `claude` exits with code 1 at startup instead of loading it. Before v2.1.214, Claude Code read the file with no size check, and a multi-gigaby… |