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.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… |
|
v2.1.281--agents |
Documentation arrivedAnthropic's documentation has since written up --agents, on Error reference.
the line in the docsThe value you passed to `--agents` is invalid, so `claude` exits with code 1 instead of starting the session. When you pass `--safe-mode` or set [`CLAUDE_CODE_SAFE_MODE`](/docs/en/env-vars#variables), Claude Code ignores `--agents` entirel… |
|
v2.1.281--agents |
Documentation arrivedAnthropic's documentation has since written up --agents, on Error reference.
the line in the docsThe value you passed to `--agents` is invalid, so `claude` exits with code 1 instead of starting the session. When you pass `--safe-mode` or set [`CLAUDE_CODE_SAFE_MODE`](/docs/en/env-vars#variables), Claude Code ignores `--agents` entirel… |
|
v2.1.281/mcp |
Documentation arrivedAnthropic's documentation has since written up /mcp, on Error reference.
the line in the docsA [claude.ai connector](/docs/en/mcp#use-mcp-servers-from-claude-ai) request failed because claude.ai rejected the token from your Claude Code login. The rejected token is your login, not the connector's own authorization in claude.ai, so … |
|
v2.1.281/model |
Documentation arrivedAnthropic's documentation has since written up /model, on Configure cloud environments.
the line in the docs| Your organization's [server-managed settings](/docs/en/server-managed-settings) | Yes, except in [Claude Tag](https://claude.com/docs/claude-tag/overview) sessions | Fetched from Anthropic's servers when the session starts. See [Surface … |
|
v2.1.281/model |
Documentation arrivedAnthropic's documentation has since written up /model, on Configure cloud environments.
the line in the docs| Your organization's [server-managed settings](/docs/en/server-managed-settings) | Yes, except in [Claude Tag](https://claude.com/docs/claude-tag/overview) sessions | Fetched from Anthropic's servers when the session starts. See [Surface … |
|
v2.1.206tengu_umber_kestrel |
Flag reading movedThe flag server now returns off for tengu_umber_kestrel, read as this account. | |
v2.1.239tengu_toasty_breeze |
Flag reading movedThe flag server now returns {"enabled":false,"version":0} for tengu_toasty_breeze, read as this account. | |
v2.1.239tengu_toasty_breeze |
Flag reading movedThe flag server now returns {"enabled":false,"version":0} for tengu_toasty_breeze, read as this account. | |
v2.1.248tengu_nifty_lemur |
Flag reading movedThe flag server now returns {"enabled":false,"version":0} for tengu_nifty_lemur, read as this account. | |
v2.1.248tengu_nifty_lemur |
Flag reading movedThe flag server now returns {"enabled":false,"version":0} for tengu_nifty_lemur, read as this account. | |
v2.1.221tengu_mcp_protocol_negotiation_stdio |
Flag reading movedThe flag server now returns off for tengu_mcp_protocol_negotiation_stdio, read as this account. | |
v2.1.221tengu_mcp_protocol_negotiation_stdio |
Flag reading movedThe flag server now returns off for tengu_mcp_protocol_negotiation_stdio, read as this account. | |
v2.1.274tengu_mcp_protocol_negotiation_stdio |
Flag reading movedThe flag server now returns off for tengu_mcp_protocol_negotiation_stdio, read as this account. | |
v2.1.284tengu_lantern_wick_text |
Flag reading movedThe flag server now returns null for tengu_lantern_wick_text, read as this account. | |
v2.1.223tengu_juniper_relay |
Flag reading movedThe flag server now returns off for tengu_juniper_relay, read as this account. | |
v2.1.251tengu_juniper_relay |
Flag reading movedThe flag server now returns off for tengu_juniper_relay, read as this account. | |
v2.1.206tengu_umber_kestrel |
Flag reading movedThe flag server now returns on for tengu_umber_kestrel, read as this account. | |
v2.1.239tengu_toasty_breeze |
Flag reading movedThe flag server now returns {"allowanceNote":"{percent} allowance left","budgetExhaustedCopy":"You've used this week's lower-priority allowance","cooloffMinutes":10,"enabled":true,"label":"Continue now at lower priority","noticeLine":"/low-priority to continue now at lower priority · uses your weekly limit","statusLine":"Lower priority until {reset}","version":3,"waitBanner":"Working at lower priority · waiting for capacity"} for tengu_toasty_breeze, read as this account. | |
v2.1.239tengu_toasty_breeze |
Flag reading movedThe flag server now returns {"allowanceNote":"{percent} allowance left","budgetExhaustedCopy":"You've used this week's lower-priority allowance","cooloffMinutes":10,"enabled":true,"label":"Continue now at lower priority","noticeLine":"/low-priority to continue now at lower priority · uses your weekly limit","statusLine":"Lower priority until {reset}","version":3,"waitBanner":"Working at lower priority · waiting for capacity"} for tengu_toasty_breeze, read as this account. | |
v2.1.248tengu_nifty_lemur |
Flag reading movedThe flag server now returns {"autoContinue":true,"enabled":true,"label":"Reset your session limit now","noticeLine":"/limit-reset to reset your session limit now · uses weekly limit · 1/week","spentLine":"Weekly reset used · available again {date}","successLine":"Session limit reset · next reset available {date} · your weekly limit still applies","unavailableLine":"Couldn't reset your session limit right now · try again in a moment","version":1} for tengu_nifty_lemur, read as this account. |