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
768 changed this week · last read 22 Oct 2026
Claude Code CLI
228pages tracked
152 changed this week · last read 22 Oct 2026
Claude Documentation
280pages tracked
85 changed this week · last read 22 Oct 2026
Model Context Protocol
357pages tracked
171 changed this week · last read 22 Oct 2026
100 on this page
5,550 of the ledger's changes in claude-code. Show every change
ReadSourcePageWhatLines
17 Aug 2026
32 pages
+360 −269 lines
claude-code
agents
±changed
+1−1
claude-codechanged
agents
* A [forked subagent](/docs/en/sub-agents#fork-the-current-conversation), started with `/subtask`, is a subagent that inherits your full conversation context instead of starting fr
* A [forked subagent](/docs/en/sub-agents#fork-the-current-conversation) is a subagent that inherits your full conversation context instead of starting fresh. It's a way to spawn a
+1 −1 lines
Recorded here 17 Aug 2026 22:37 UTC
claude-code
changelog
±changed
+54−0
claude-codechanged
changelog
<Update label="2.1.234" description="August 17, 2026">
* Added the optional `CLAUDE_CODE_PROJECT_DIR_NAME` environment variable: hosts that give each session its own config directory can choose a short name for the per-project transc
* Added the `selection:clear` keybinding action, so a key can be bound to clear an in-app text selection; also works in the agents view
* Added a GitLab merge request badge to the footer and statusline: repos with a GitLab remote and an authenticated glab CLI show MR !N with draft/pending/green states
+54 −0 lines
Recorded here 17 Aug 2026 21:07 UTC
claude-code
sub-agents
±changed
+4−11
claude-codechanged
sub-agents
Directories added with `--add-dir` are also scanned: a `.claude/agents/` folder inside an added directory loads alongside project subagents. See [Additional directories](/docs/en/p
When you add a directory with `--add-dir` or `/add-dir`, Claude Code also loads its `.claude/agents/` folder, alongside your project subagents. See [Additional directories](/docs/e
Two cases still need a restart:
Three cases still need a restart:
* Claude Code doesn't watch `.claude/agents/` inside directories added with `--add-dir` or `/add-dir`, so after adding or editing a subagent there, restart to load the change.
+4 −11 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
skills
±changed
+3−3
claude-codechanged
skills
The `--add-dir` flag and `/add-dir` command [grant file access](/docs/en/permissions#additional-directories-grant-file-access-not-configuration) rather than configuration discovery
Other `.claude/` configuration such as output styles is not loaded from additional directories. See the [exceptions table](/docs/en/permissions#additional-directories-grant-file-ac
The `--add-dir` flag and `/add-dir` command [grant file access](/docs/en/permissions#additional-directories-grant-file-access-not-configuration) rather than configuration discovery
+3 −3 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
sandboxing
±changed
+6−6
claude-codechanged
sandboxing
* `rm` or `rmdir` commands that target `/`, your home directory, or other critical system paths still go through the regular permission flow
* `rm` or `rmdir` commands that target a [critical path](/docs/en/permission-modes#critical-paths) still go through the regular permission flow
| | What it controls | What replaces the prompt
| :----------------------------------------------------------------- | :------------------------------------------ | :--------------------------------------------------------------
| `/sandbox` | What a Bash command can access once it runs | The sandbox boundary itself, in [auto-allow mode](#sandbox-mode
+6 −6 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
sandbox-environments
±changed
+1−7
claude-codechanged
sandbox-environments
When you pass `--dangerously-skip-permissions`, Claude acts without asking you first. Claude Code still prompts you only for:
* Explicit [ask rules](/docs/en/permissions#manage-permissions)
* Connector tools [your organization set to `ask`](/docs/en/mcp#organization-controls-on-connector-tools)
* MCP tools marked [`requiresUserInteraction`](/docs/en/mcp#require-approval-for-a-specific-tool)
+1 −7 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
permissions
±changed
+11−13
claude-codechanged
permissions
| Mode | Description
| :------------------ | :-----------------------------------------------------------------------------------------------------------------------------------------------------------
| `default` | Prompts for permission on first use of each tool. Labeled Manual in the CLI, the VS Code and JetBrains extensions, and the desktop app, and Claude Code acce
| `acceptEdits` | Automatically accepts file edits and common filesystem commands such as `mkdir`, `touch`, `mv`, and `cp` for paths in the working directory or `additionalDi
| `plan` | Claude reads files and runs read-only shell commands to explore but doesn't edit your source files; with [auto mode](/docs/en/permission-modes#eliminate-pro
+11 −13 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
permission-modes
±changed
+84−41
claude-codechanged
permission-modes
A permission mode sets which actions Claude can take in a session without asking you first. In Manual mode, Claude Code stops and asks you before most actions that edit files, run
A permission mode sets which actions Claude can take in a session without asking you first. In Manual mode, Claude Code stops and asks you before most actions that edit files, run
Writes to [protected paths](#protected-paths) are never auto-approved except in `bypassPermissions` mode and in planning sessions with bypass permissions available.
Modes set the baseline. Layer [permission rules](/docs/en/permissions#manage-permissions) on top to pre-approve or block specific tools. These controls apply in every mode, includi
+84 −41 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
hooks
±changed
+8−6
claude-codechanged
hooks
| Field | Description
| :------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------
| `permissionDecision` | `"allow"` skips the permission prompt, except for [tools that require user interaction](#pretooluse-decision-control) and connector tools [your organ
| `permissionDecisionReason` | For `"allow"` and `"ask"`, shown to the user but not Claude. For `"deny"`, shown to Claude. For `"defer"`, ignored
| `updatedInput` | Modifies the tool's input parameters before execution. Replaces the entire input object, so include unchanged fields alongside modified ones. Combine
+8 −6 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
headless
±changed
+1−1
claude-codechanged
headless
`acceptEdits` lets Claude write files without prompting and also auto-approves common filesystem commands such as `mkdir`, `touch`, `mv`, and `cp`. Apart from the [read-only comman
`acceptEdits` lets Claude write files without prompting and also auto-approves common filesystem commands such as `mkdir`, `touch`, `mv`, and `cp`. The [actions no mode auto-approv
+1 −1 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
desktop
±changed
+7−7
claude-codechanged
desktop
| Mode | Settings key | Behavior
| ---------------------- | ------------------- | -----------------------------------------------------------------------------------------------------------------------------------
| **Manual** | `default` | Claude asks before editing files or running commands. You see a diff and can accept or reject each change.
| **Accept edits** | `acceptEdits` | Claude auto-accepts file edits and common filesystem commands like `mkdir`, `touch`, and `mv`, but still asks before running other
| **Plan** | `plan` | Claude reads files and runs commands to explore, then proposes a plan without editing your source code. Good for complex tasks wher
+7 −7 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
channels
±changed
+1−7
claude-codechanged
channels
If Claude hits a permission prompt while you're away from the terminal, the session pauses until you respond. Channel servers that declare the [permission relay capability](/docs/e
* Explicit ask rules
* Connector tools [your organization set to `ask`](/docs/en/mcp#organization-controls-on-connector-tools)
* MCP tools marked [`requiresUserInteraction`](/docs/en/mcp#require-approval-for-a-specific-tool)
+1 −7 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
agent-sdk/user-input
±changed
+3−3
claude-codechanged
agent-sdk/user-input
**The callback never fires for auto-approved tools.** Any approval earlier in the [permission evaluation flow](/docs/en/agent-sdk/permissions#how-permissions-are-evaluated), an a
`AskUserQuestion`, MCP tools marked [`requiresUserInteraction`](/docs/en/mcp#require-approval-for-a-specific-tool), and connector tools [your organization set to `ask`](/docs/en/
**The callback never fires for auto-approved tools.** Any approval earlier in the [permission evaluation flow](/docs/en/agent-sdk/permissions#how-permissions-are-evaluated), an a
+3 −3 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
agent-sdk/typescript
±changed
+3−3
claude-codechanged
agent-sdk/typescript
| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined`
| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined`
`AskUserQuestion`, MCP tools marked [`requiresUserInteraction`](/docs/en/mcp#require-approval-for-a-specific-tool), and connector tools [your organization set to `ask`](/docs/en/mc
An allow rule doesn't pre-approve the [actions no mode auto-approves](/docs/en/permission-modes#actions-no-mode-auto-approves); see [How permissions are evaluated](/docs/en/agent-s
If `permissionMode` is set to `bypassPermissions` and `allowUnsandboxedCommands` is enabled, the model can autonomously execute commands outside the sandbox without approval prom
+3 −3 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
agent-sdk/subagents
±changed
+1−0
claude-codechanged
agent-sdk/subagents
* **A file under an added directory**: Claude Code loads `.claude/agents/` from directories added with the `add_dirs` (Python) or `additionalDirectories` (TypeScript) option, or th
+1 −0 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
agent-sdk/secure-deployment
±changed
+1−1
claude-codechanged
agent-sdk/secure-deployment
* **Command parsing for permissions**: Before executing bash commands, Claude Code parses them into an AST and matches the result against your permission rules. Commands that canno
* **Command parsing for permissions**: Before executing bash commands, Claude Code parses them into an AST and matches the result against your permission rules. Commands that canno
+1 −1 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
agent-sdk/python
±changed
+51−51
claude-codechanged
agent-sdk/python
| Property | Type | Default | Description
| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :--------------------
| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Tools configuration.
| `allowed_tools` | `list[str]` | `[]` | Tools to auto-approve
| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | System prompt configu
+51 −51 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
agent-sdk/permissions
±changed
+22−22
claude-codechanged
agent-sdk/permissions
Run [hooks](/docs/en/agent-sdk/hooks) first. A hook can deny the call outright or pass it on. A hook that returns `allow` does not skip the deny and ask rules below; those are
Run [hooks](/docs/en/agent-sdk/hooks) first. A hook can deny the call outright or pass it on. A hook that returns `allow` does not skip the deny and ask rules below; those are
Apply the active [permission mode](#permission-modes). `bypassPermissions` approves everything that reaches this step. `acceptEdits` approves file operations. `plan` routes fil
Apply the active [permission mode](#permission-modes). `bypassPermissions` approves everything that reaches this step except `rm` and `rmdir` removals targeting a [critical pat
Check `allow` rules (from `allowed_tools` and settings.json). If a rule matches, the tool is approved.
+22 −22 lines
Recorded here 17 Aug 2026 20:07 UTC
claude-code
slack
±changed
+0−4
claude-codechanged
slack
### App Home
The App Home tab shows your connection status and allows you to connect or disconnect your Claude account from Slack.
+0 −4 lines
Recorded here 17 Aug 2026 17:37 UTC
claude-code
remote-control
±changed
+0−2
claude-codechanged
remote-control
If the environment already has an active session, you'll be asked whether to continue it or start a new one.
+0 −2 lines
Recorded here 17 Aug 2026 17:37 UTC
claude-code
plugins-reference
±changed
+1−1
claude-codechanged
plugins-reference
| `displayName` | string | Human-readable name shown in the `/plugin` picker and other UI surfaces. Falls back to `name` when omitted. Unlike `name`, may contain spaces and any
| `displayName` | string | Human-readable name shown in the `/plugin` picker and other UI surfaces. Falls back to `name` when omitted. Unlike `name`, may contain spaces and any
+1 −1 lines
Recorded here 17 Aug 2026 17:37 UTC
claude-code
plugin-marketplaces
±changed
+1−1
claude-codechanged
plugin-marketplaces
| `displayName` | string | Human-readable name shown in UI surfaces. Falls back to `name` when omitted. May contain spaces and any casing. Not used for namespacing or lookup. R
| `displayName` | string | Human-readable name shown in UI surfaces. Falls back to `name` when omitted. May contain spaces and any casing. Not used for namespacing or lookup.
+1 −1 lines
Recorded here 17 Aug 2026 17:37 UTC
claude-code
plugin-dependencies
±changed
+1−1
claude-codechanged
plugin-dependencies
Enabling a plugin also enables the plugins it depends on, and disabling a plugin is blocked if another enabled plugin still needs it. Both behaviors require Claude Code v2.1.143 or
Enabling a plugin also enables the plugins it depends on, and disabling a plugin is blocked if another enabled plugin still needs it.
+1 −1 lines
Recorded here 17 Aug 2026 17:37 UTC
claude-code
desktop
±changed
+1−4
claude-codechanged
desktop
Claude Code reads `autoMode` from user settings, the `--settings` flag, and managed settings, but not from `.claude/settings.json` or `.claude/settings.local.json`: both files live
| `--dangerously-skip-permissions` | CLI flag | Bypass permissions mode. On Pro and Max p
* **Third-party providers**: Desktop connects to Anthropic's API by default. To route Desktop through a gateway, see [connect the desktop app to a gateway](/docs/en/llm-gateway-con
* **Third-party providers**: Desktop connects to Anthropic's API by default. To route Desktop through a gateway, or to run the Code tab on Amazon Bedrock, Google Cloud's Agent Plat
+1 −4 lines
Recorded here 17 Aug 2026 17:37 UTC
claude-code
cloud-environments
±changed
+0−4
claude-codechanged
cloud-environments
Shared environments add to members' selectors rather than replacing them.
To persist environment variables for subsequent Bash commands, write to the file at `$CLAUDE_ENV_FILE`. See [SessionStart hooks](/docs/en/hooks#sessionstart) for details.
+0 −4 lines
Recorded here 17 Aug 2026 17:37 UTC
claude-code
claude-code-on-the-web
±changed
+0−4
claude-codechanged
claude-code-on-the-web
The GitHub App is required for [Auto-fix](#auto-fix-pull-requests), which uses the App to receive PR webhooks. If you connect with `/web-setup` and later want Auto-fix, install the
This pattern gives you control over the strategy while letting Claude execute autonomously in the cloud.
+0 −4 lines
Recorded here 17 Aug 2026 17:37 UTC
16 Aug 2026
18 pages
+162 −72 lines
claude-code
tools-reference
±changed
+11−1
claude-codechanged
tools-reference
### Memory limit on Linux and WSL
On Linux and WSL, set [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/en/env-vars#variables) to a size such as `4G` to cap the memory that Bash and PowerShell tool commands can use, so one
* Write the size as a number of bytes or with a `K`, `M`, `G`, or `T` suffix. Set `0`, `off`, `false`, `no`, or `none` to turn the cap off. Claude Code ignores any other value it c
+11 −1 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
settings
±changed
+14−1
claude-codechanged
settings
| `strictKnownMarketplaces` | (Managed settings only) Allowlist of plugin marketplace sources. Undefined = no restrictions, empty array = lockdown. Enforced on marketplace
| `strictKnownMarketplaces` | (Managed settings only) Allowlist of plugin marketplace sources. Undefined = no restrictions, empty array = lockdown. Enforced on marketplace
<a id="marketplace-key-aliases" />
##### Marketplace key aliases
+14 −1 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
server-managed-settings
±changed
+3−17
claude-codechanged
server-managed-settings
This approach is designed for organizations that don't have device management infrastructure in place, or that need to manage settings for users on unmanaged devices.
To configure the [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode) classifier so it knows which repos, buckets, and domains your organization trusts:
```json theme={null}
+3 −17 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
self-hosted-environments-deploy
±changed
+1−1
claude-codechanged
self-hosted-environments-deploy
Connector tools, such as GitHub, Slack, Linear, and the other claude.ai connectors, are called from Anthropic's side rather than from your runner, so when a self-hosted session use
Anthropic calls connector tools, such as GitHub, Slack, Linear, and the other claude.ai connectors, from its own infrastructure rather than from your runner, so when Claude uses a
+1 −1 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
permissions
±changed
+1−1
claude-codechanged
permissions
| [Settings](/docs/en/settings) in `.claude/settings.json` and `.claude/settings.local.json` | `enabledPlugins` and `extraKnownMarketplaces` keys only
| [Settings](/docs/en/settings) in `.claude/settings.json` and `.claude/settings.local.json` | `enabledPlugins` and [`extraKnownMarketplaces`](/docs/en/settings#extraknownmarketpla
+1 −1 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
llm-gateway-protocol
±changed
+0−2
claude-codechanged
llm-gateway-protocol
Requests that reach the endpoint unmodified are unaffected.
+0 −2 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
hooks-guide
±changed
+5−3
claude-codechanged
hooks-guide
| `permission_prompt` | Claude needs you to approve a tool use and you haven't typed for about 6 seconds |
| `permission_prompt` | Claude needs you to approve a tool use and the prompt has waited about six seconds |
| `elicitation_dialog` | An MCP server opens an elicitation form and you haven't typed for about 6 seconds |
| `elicitation_url_dialog` | An MCP server asks you to open a browser URL and you haven't typed for about 6 seconds |
| `elicitation_dialog` | An MCP server opens an elicitation form and you haven't typed for about six seconds |
+5 −3 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
hooks
±changed
+16−8
claude-codechanged
hooks
Use this event when you need a signal the moment Claude asks for permission. The [Notification](#notification) event's `permission_prompt` type reaches you only after about 6 secon
Use this event when you need a signal the moment Claude asks for permission. The [Notification](#notification) event's `permission_prompt` type reaches you only after the prompt ha
| `permission_prompt` | Claude needs you to approve a tool use and you haven't typed for about 6 seconds |
| `permission_prompt` | Claude needs you to approve a tool use and the prompt has waited about six seconds |
| `elicitation_dialog` | An MCP server opens an elicitation form and you haven't typed for about 6 seconds |
+16 −8 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
env-vars
±changed
+3−0
claude-codechanged
env-vars
| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Set to `1` to stop Claude Code from running your [`Notification` hooks for unanswered permission requests](/docs/en/hook
| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | On Linux and WSL, set to a size such as `4G` to [cap the memory that Bash and PowerShell tool commands can use](/docs/en
| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Set to the number of milliseconds [WebFetch](/docs/en/tools-reference#webfetch-tool-behavior) keeps each fetched URL's r
+3 −0 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
claude-apps-gateway-spend-limits
±changed
+0−2
claude-codechanged
claude-apps-gateway-spend-limits
`identity_retention_days` is deliberately shorter than `spend_retention_months`: a deprovisioned identity stops refreshing and ages out, while its anonymous spend counters remain f
+0 −2 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
claude-apps-gateway-on-aws
±changed
+1−1
claude-codechanged
claude-apps-gateway-on-aws
Run the collector as its own internal service reachable over `https://`: the gateway accepts plaintext `http://` only for loopback URLs, and even then its [SSRF guard](/docs/en/cla
Run the collector as its own internal service reachable over `https://`; the [`telemetry` reference](/docs/en/claude-apps-gateway-config#telemetry) covers the loopback exception an
+1 −1 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
claude-apps-gateway-deploy
±changed
+2−12
claude-codechanged
claude-apps-gateway-deploy
For support with an identity provider not covered above, see [Troubleshooting](#troubleshooting).
<Note>
**Workload identity**
+2 −12 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
claude-apps-gateway-config
±changed
+1−6
claude-codechanged
claude-apps-gateway-config
# Per-upstream model IDs are keyed on the upstream's `name:`; an upstream
# without a `name:` defaults to its provider string (e.g. `bedrock`). For a
# built-in Claude model, an upstream you leave out of the map still serves it
# with that provider's default ID; list the upstream to override the ID, for
# example with a provisioned-throughput ARN. Only a custom `id` that isn't a
+1 −6 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
claude-apps-gateway
±changed
+0−4
claude-codechanged
claude-apps-gateway
The gateway server requires the native `claude` binary; download a pinned release as described in [Install Claude Code](/docs/en/setup). The server uses runtime features that aren'
The CLI's gateway-session beta set omits first-party-only betas and the extended-cache-ttl beta, which is why those rows below show as not available.
+0 −4 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
agent-sdk/typescript
±changed
+97−2
claude-codechanged
agent-sdk/typescript
Return type of [`getContextUsage()`](#query-object). This is the same payload the `/context` command renders in an interactive session, so alongside the token counts it carries dis
Return type of [`getContextUsage()`](#query-object). This is the same payload Claude Code renders for the `/context` command in an interactive session, so alongside the token count
When you send `/context` as a prompt instead of calling the method, Claude Code attaches an [`SDKContextUsage`](#sdkcontextusage) payload to the `context_usage` field of the assist
`totalTokens` is the session's current context usage, and `maxTokens` is the window that usage is measured against. That window is the model's context window, or the lower auto-com
+97 −2 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
agent-sdk/session-storage
±changed
+1−1
claude-codechanged
agent-sdk/session-storage
* **TypeScript**: credentials, `.claude.json`, and your user `settings.json`. From `settings.json` it strips the three keys that misbehave under a temporary config directory: `enab
* **TypeScript**: credentials, `.claude.json`, and your user `settings.json`. From `settings.json` it strips the keys that misbehave under a temporary config directory: `enabledPlu
+1 −1 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
agent-sdk/hooks
±changed
+6−8
claude-codechanged
agent-sdk/hooks
Use `Notification` hooks to receive system notifications from the agent and forward them to external services. Notifications fire for event types such as:
* `permission_prompt` when Claude needs permission
* `idle_prompt` when Claude is waiting for input
* `auth_success` when authentication completes
+6 −8 lines
Recorded here 16 Aug 2026 14:37 UTC
claude-code
admin-setup
±changed
+0−2
claude-codechanged
admin-setup
See [Server-managed settings](/docs/en/server-managed-settings) and [Settings files and precedence](/docs/en/settings#settings-files).
+0 −2 lines
Recorded here 16 Aug 2026 14:37 UTC
15 Aug 2026
30 pages
+408 −179 lines
claude-code
sub-agents
±changed
+2−2
claude-codechanged
sub-agents
A background subagent that completes stays listed in [`/tasks`](/docs/en/commands), marked done and sorted below running work, until the session cleans up its task list. Its detail
A background subagent that completes stays listed in [`/tasks`](/docs/en/commands), marked done and sorted below running work, for the same window as the footer hint above. Its det
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
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
+2 −2 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
model-config
±changed
+3−1
claude-codechanged
model-config
The check runs only on the Anthropic API. On Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/en/claude-platform-on-aws), and behind
The check runs only on the Anthropic API. On Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/en/claude-platform-on-aws), and behind
To stop the `[claude-code:unrecognized_model]` [diagnostic line](/docs/en/errors#unrecognized-model-id-on-a-request) for an ID such as a gateway alias, add an entry with that ID as
+3 −1 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
errors
±changed
+48−3
claude-codechanged
errors
| `[claude-code:unrecognized_model]`
* The check runs only on the Anthropic API. On any other provider or gateway, including a custom `ANTHROPIC_BASE_URL`, the provider defines the model names, so Claude Code accepts
* The check runs only on the Anthropic API. On any other provider or gateway, including a custom `ANTHROPIC_BASE_URL`, the provider defines the model names, so Claude Code accepts
* For a tool that [background subagents drop](/docs/en/sub-agents#available-tools), such as `LSP` or `TaskCreate`, remove the entry. To keep the tool, [turn fork mode off](/docs/en
* For a tool that [background subagents drop](/docs/en/sub-agents#available-tools), such as `LSP`, remove the entry. To keep the tool, [turn fork mode off](/docs/en/sub-agents#turn
+48 −3 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
cli-reference
±changed
+2−2
claude-codechanged
cli-reference
| `--allowedTools`, `--allowed-tools` | Tools that execute without prompting for permission. See [permission rule syntax](/docs/en/settings#permission-rule-syntax) for
| `--allowedTools`, `--allowed-tools` | Tools that execute without prompting for permission. See [permission rule syntax](/docs/en/settings#permission-rule-syntax) for
| `--tools` | Restrict which built-in tools Claude can use. Use `""` to disable all, `"default"` for all, or tool names like `"Bash,Edit,Read"
| `--tools` | Restrict which built-in tools Claude can use. Use `""` to disable all, `"default"` for all, or tool names like `"Bash,Edit,Read"
+2 −2 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
claude-code-on-the-web
±changed
+1−1
claude-codechanged
claude-code-on-the-web
[Subagents](/docs/en/sub-agents) work the same way they do locally. Claude can spawn them with the Task tool to offload research or parallel work into a separate context window, ke
[Subagents](/docs/en/sub-agents) work the same way they do locally. Claude can spawn them with the Agent tool to offload research or parallel work into a separate context window, k
+1 −1 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
agents
±changed
+1−1
claude-codechanged
agents
* **Do the workers need to talk to each other?** Subagents report results back to the conversation that spawned them, and agent view sessions report only to you, though separate se
* **Do the workers need to talk to each other?** Subagents report results back to the conversation that spawned them, and agent view sessions report only to you, though separate se
+1 −1 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
agent-teams
±changed
+2−2
claude-codechanged
agent-teams
From there, Claude populates a [shared task list](/docs/en/interactive-mode#task-list), spawns teammates for each perspective, has them explore the problem, and synthesizes finding
From there, Claude populates a [shared task list](/docs/en/interactive-mode#task-list) in a [session that has the Task tools](/docs/en/tools-reference#task-tool-availability), spaw
* **Shared task list**: all agents can see task status and claim available work.
* **Shared task list**: [agents that have the Task tools](/docs/en/tools-reference#task-tool-availability) can see task status and claim available work.
+2 −2 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
agent-sdk/typescript
±changed
+1−1
claude-codechanged
agent-sdk/typescript
| `allowedTools` | `string[]` | `[]`
| `allowedTools` | `string[]` | `[]`
+1 −1 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
agent-sdk/todo-tracking
±changed
+1−1
claude-codechanged
agent-sdk/todo-tracking
Claude creates todos for most multi-step work, such as:
In a [session that has the task-tracking tools](#model-availability), Claude creates todos for most multi-step work, such as:
+1 −1 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
agent-sdk/python
±changed
+1−1
claude-codechanged
agent-sdk/python
| `allowed_tools` | `list[str]` | `[]` | Tools to auto-approve
| `allowed_tools` | `list[str]` | `[]` | Tools to auto-approve
+1 −1 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
agent-sdk/permissions
±changed
+3−3
claude-codechanged
agent-sdk/permissions
`allowed_tools` and `disallowed_tools` (TypeScript: `allowedTools` / `disallowedTools`) add entries to the allow and deny rule lists in the evaluation flow above. Allow rules only
`allowed_tools` and `disallowed_tools` (TypeScript: `allowedTools` / `disallowedTools`) add entries to the allow and deny rule lists in the evaluation flow above. If you name one o
| `allowed_tools=["Read", "Grep"]` | `Read` and `Grep` are auto-approved. Tools not listed here still exist and fall through to the permission mode and `canUseTool`.
| `allowed_tools=["Read", "Grep"]` | `Read` and `Grep` are auto-approved. Other tools not listed here still exist and fall through to the permission mode and `canUseTool`.
**`allowed_tools` does not constrain `bypassPermissions`.** `allowed_tools` only pre-approves the tools you list. Unlisted tools are not matched by any allow rule and fall throug
+3 −3 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
agent-sdk/observability
±changed
+1−1
claude-codechanged
agent-sdk/observability
The `llm_request`, `tool`, and `hook` spans are children of the enclosing `claude_code.interaction` span. When the agent spawns a subagent through the Task tool, the subagent's `ll
The `llm_request`, `tool`, and `hook` spans are children of the enclosing `claude_code.interaction` span. When the agent spawns a subagent through the Agent tool, the subagent's `l
+1 −1 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
agent-sdk/hooks
±changed
+1−1
claude-codechanged
agent-sdk/hooks
| `TaskCompleted` | No | Yes | Background task completes
| [`TaskCompleted`](/docs/en/hooks#taskcompleted) | No | Yes | A task is marked completed
+1 −1 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
agent-sdk/custom-tools
±changed
+2−2
claude-codechanged
agent-sdk/custom-tools
The `tools` option and the allowed/disallowed lists affect two layers: availability, which controls whether a tool appears in Claude's context, and permission, which controls wheth
The `tools` option and the allowed/disallowed lists affect two layers: availability, which controls whether a tool appears in Claude's context, and permission, which controls wheth
| allowed tools | Permission | Listed tools run without a permission prompt. Unlisted tools remain available; calls go through the [permission flow](/docs/en/agent-sd
| allowed tools | Permission | Listed tools run without a permission prompt. Other unlisted tools remain available; calls go through the [permission flow](/docs/en/ag
+2 −2 lines
Recorded here 15 Aug 2026 15:37 UTC
claude-code
tools-reference
±changed
+20−5
claude-codechanged
tools-reference
| `TaskCreate` | Creates a new task in the task list
| `TaskGet` | Retrieves full details for a specific task
| `TaskList` | Lists all tasks with their current status
| `TaskCreate` | Creates a new task in the task list. Claude Code leaves it out on the models listed under [Task tool availability](#task-tool-availability) unless you op
| `TaskGet` | Retrieves full details for a specific task. Claude Code leaves it out on the models listed under [Task tool availability](#task-tool-availability) unless
+20 −5 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
sub-agents
±changed
+2−0
claude-codechanged
sub-agents
In a [session without the Task tools](/docs/en/tools-reference#task-tool-availability), Claude Code doesn't provide the task tools to subagents either, even when the subagent runs
+2 −0 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
interactive-mode
±changed
+2−0
claude-codechanged
interactive-mode
On [Opus 4.8, Sonnet 5, Fable 5, Mythos 5, and later versions of those families](/docs/en/tools-reference#task-tool-availability), Claude keeps track of multi-step work without a w
+2 −0 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
hooks
±changed
+1−1
claude-codechanged
hooks
Runs when a task is being created via the `TaskCreate` tool. Use this to enforce naming conventions, require task descriptions, or prevent certain tasks from being created.
Runs when a task is being created via the `TaskCreate` tool. Use this to enforce naming conventions, require task descriptions, or prevent certain tasks from being created. In a [s
+1 −1 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
features-overview
±changed
+8−8
claude-codechanged
features-overview
* **[Agent teams](/docs/en/agent-teams)** coordinate multiple independent sessions with shared tasks and peer-to-peer messaging
* **[Agent teams](/docs/en/agent-teams)** coordinate multiple independent sessions with peer-to-peer messaging, plus a shared task list for [agents that have the Task tools](/docs/
| Aspect | Subagent | Agent team |
| ----------------- | ------------------------------------------------ | --------------------------------------------------- |
| **Context** | Own context window; results return to the caller | Own context window; fully independent |
+8 −8 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
env-vars
±changed
+3−2
claude-codechanged
env-vars
| `CLAUDE_CODE_ENABLE_TASKS` | Controls whether sessions use the structured Task tools (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) or the legac
| `CLAUDE_CODE_ENABLE_TASKS` | Selects which task-tracking tools Claude Code provides in [sessions that have them](/docs/en/tools-reference#task-tool-a
| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Set to `1` to get the task-tracking tools on the models listed under [Task tool availability](/docs/en/tools-reference#t
| `CLAUDE_CODE_TASK_LIST_ID` | Share a task list across sessions. Set the same ID in multiple Claude Code instances to coordinate on a shared task list
| `CLAUDE_CODE_TASK_LIST_ID` | Share a task list across sessions. Set the same ID in multiple Claude Code instances to coordinate on a shared task list
+3 −2 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
agent-teams
±changed
+10−8
claude-codechanged
agent-teams
| | Subagents | Agent teams |
| :---------------- | :----------------------------------------------- | :-------------------------------------------------- |
| **Context** | Own context window; results return to the caller | Own context window; fully independent |
| **Communication** | Report results back to the main agent only | Teammates message each other directly |
| **Coordination** | Main agent manages all work | Shared task list with self-coordination |
+10 −8 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
agent-sdk/typescript
±changed
+22−2
claude-codechanged
agent-sdk/typescript
As of TypeScript Agent SDK 0.3.142, `TodoWrite` is disabled by default. Use `TaskCreate`, `TaskGet`, `TaskUpdate`, and `TaskList` instead. See [Migrate to Task tools](/docs/en/ag
On TypeScript Agent SDK 0.3.233 and later, the following tools aren't available on Opus 4.8, Sonnet 5, Fable 5, Mythos 5, or later versions of those families unless you opt in:
* `TodoWrite`
* `TaskCreate`
+22 −2 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
agent-sdk/todo-tracking
±changed
+35−13
claude-codechanged
agent-sdk/todo-tracking
As of TypeScript Agent SDK 0.3.142 and Claude Code v2.1.142, sessions use the structured Task tools `TaskCreate`, `TaskUpdate`, `TaskGet`, and `TaskList` instead of `TodoWrite`.
On TypeScript Agent SDK 0.3.233 and later, or Python Agent SDK 0.2.139 and later, the following tools aren't available on Opus 4.8, Sonnet 5, Fable 5, Mythos 5, or later versions
* `TodoWrite`
* `TaskCreate`
+35 −13 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
agent-sdk/python
±changed
+11−1
claude-codechanged
agent-sdk/python
As of Claude Code v2.1.142, `TodoWrite` is disabled by default. Use `TaskCreate`, `TaskGet`, `TaskUpdate`, and `TaskList` instead. See [Migrate to Task tools](/docs/en/agent-sdk/
On Python Agent SDK 0.2.139 and later, the following tools aren't available on Opus 4.8, Sonnet 5, Fable 5, Mythos 5, or later versions of those families unless you opt in:
* `TodoWrite`
* `TaskCreate`
+11 −1 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
agent-sdk/agent-loop
±changed
+2−0
claude-codechanged
agent-sdk/agent-loop
On the [models that don't get the task-tracking tools](/docs/en/agent-sdk/todo-tracking#model-availability), Claude Code provides `TaskCreate` and `TaskUpdate` only when you opt in
+2 −0 lines
Recorded here 15 Aug 2026 05:07 UTC
claude-code
worktrees
±changed
+18−3
claude-codechanged
worktrees
To branch from a specific pull request, pass `--worktree` the PR number prefixed with `#`, or a full GitHub pull request URL. Claude Code fetches `pull/<number>/head` from `origin`
To branch from a specific pull request or merge request, pass `--worktree` the number prefixed with `#`, a GitHub pull request URL, or a GitLab merge request URL such as `https://g
Claude Code reads only the number from the URL. It always fetches from your repository's `origin` remote, and picks the fetch path by `origin`'s host:
+18 −3 lines
Recorded here 15 Aug 2026 02:07 UTC
claude-code
cli-reference
±changed
+1−1
claude-codechanged
cli-reference
| `--worktree`, `-w` | Start Claude in an isolated [git worktree](/docs/en/worktrees) at `<repo>/.claude/worktrees/<name>`. If no name is given, one is
| `--worktree`, `-w` | Start Claude in an isolated [git worktree](/docs/en/worktrees) at `<repo>/.claude/worktrees/<name>`. If you don't give a name, C
+1 −1 lines
Recorded here 15 Aug 2026 02:07 UTC
claude-code
agent-view
±changed
+22−17
claude-codechanged
agent-view
The `#N` label that can appear at the right edge of a row is a [pull request the session is linked to](#pull-request-status), not part of the state icon.
The `#N` or `!N` label that can appear at the right edge of a row is a link to the session's [pull request or merge request](#pull-request-status), not part of the state icon.
When a session opens a pull request, a `#1234` label appears at the right edge of the row, linked to the pull request. Claude Code emits the link even when it can't detect hyperlin
When a session [opens a pull request](#how-file-edits-are-isolated), Claude Code adds a label at the right edge of the row, linked to the pull request:
+22 −17 lines
Recorded here 15 Aug 2026 02:07 UTC
claude-code
sub-agents
±changed
+18−9
claude-codechanged
sub-agents
Claude Code clears a background subagent's row from the subagent panel below the prompt input in one of two ways, depending on how the subagent ended:
* When a subagent finishes successfully, Claude Code removes its row immediately and, except in [screen reader mode](/docs/en/accessibility), shows `/tasks to see subagents` in the
* When a subagent fails or you stop it, Claude Code keeps its row for 30 seconds. To clear the row sooner, select it and press `x`.
+18 −9 lines
Recorded here 15 Aug 2026 01:37 UTC
claude-code
settings
±changed
+1−1
claude-codechanged
settings
When a repository's `.claude/settings.json` includes `extraKnownMarketplaces`, Claude Code adds those marketplaces for a team member after they accept the workspace trust dialog fo
When a repository's `.claude/settings.json` includes `extraKnownMarketplaces`, Claude Code adds those marketplaces for a team member after they accept the workspace trust dialog fo
+1 −1 lines
Recorded here 15 Aug 2026 01:37 UTC
claude-code
env-vars
±changed
+14−14
claude-codechanged
env-vars
Claude Code turns some features on through feature flags it fetches from Anthropic. `DISABLE_GROWTHBOOK`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, and `CLAUDE_CODE_DISABLE_NONESSENTIAL
* [The auto-mode starting default](/docs/en/permission-modes#which-mode-a-session-starts-in) on Pro, Max, and Team plans; sessions start in Manual instead
* In the VS Code extension, [reading settings files for the starting mode](/docs/en/permission-modes#switch-permission-modes)
* [Remote Control](/docs/en/remote-control#requirements)
+14 −14 lines
Recorded here 15 Aug 2026 01:07 UTC
claude-code
settings
±changed
+11−11
claude-codechanged
settings
| `disableAutoMode` | Set to `"disable"` to prevent [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode) from being activated. Removes `auto` fr
| `disableAutoMode` | Set to `"disable"` to prevent [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode) from being activated. Removes `auto` fr
| Keys | Description
| :---------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------
| `allow` | Array of permission rules to allow tool use. Tool-name globs are supported only in the tool position after a literal `mcp__<server>__` prefi
+11 −11 lines
Recorded here 15 Aug 2026 00:37 UTC
claude-code
sessions
±changed
+4−1
claude-codechanged
sessions
* Permission mode: the mode the session was in. `plan` and `bypassPermissions` are never restored; [bypassing permissions](/docs/en/permission-modes#skip-all-checks-with-bypassperm
* Permission mode: the mode the session was in, with these exceptions. Pass `--permission-mode` to override the restored mode.
* `plan` and `bypassPermissions` are never restored; a session that was in one of them resumes in the mode a new session would start in. To [bypass permissions](/docs/en/permissi
* `auto` is restored only when your account still meets the [auto mode requirements](/docs/en/permission-modes#eliminate-prompts-with-auto-mode)
* Manual is restored as Manual when a new session would start in auto mode from the [built-in default](/docs/en/permission-modes#which-mode-a-session-starts-in); when a `defaultM
+4 −1 lines
Recorded here 15 Aug 2026 00:37 UTC
claude-code
self-hosted-environments-deploy
±changed
+7−1
claude-codechanged
self-hosted-environments-deploy
Connector tools, such as GitHub, Slack, Linear, and the other claude.ai connectors, are called from Anthropic's side rather than from your runner, so when a self-hosted session use
Connector tools, such as GitHub, Slack, Linear, and the other claude.ai connectors, are called from Anthropic's side rather than from your runner, so when a self-hosted session use
* `https://api.anthropic.com/v2/ccr-sessions/*`
* `https://api.anthropic.com/v1/code/sessions/*`
+7 −1 lines
Recorded here 15 Aug 2026 00:37 UTC
claude-code
permissions
±changed
+5−5
claude-codechanged
permissions
Claude Code uses a tiered permission system to balance power and safety:
Claude Code uses a tiered permission system to balance power and safety. The table shows, for each tool type, whether Manual mode asks before the action runs. The other [permission
Claude Code supports several permission modes that control how it approves tool calls. See [Permission modes](/docs/en/permission-modes) for when to use each one. Set the `defaultM
Claude Code supports several permission modes that control how it approves tool calls. See [Permission modes](/docs/en/permission-modes) for when to use each one. To change the mod
| `default` | Standard behavior: prompts for permission on first use of each tool. Labeled Manual in the CLI, the VS Code and JetBrains extensions, and the desktop app, a
+5 −5 lines
Recorded here 15 Aug 2026 00:37 UTC
claude-code
permission-modes
±changed
+105−47
claude-codechanged
permission-modes
When Claude wants to edit a file, run a shell command, or make a network request, it pauses and asks you to approve the action. Permission modes control how often that pause happen
A permission mode sets which actions Claude can take in a session without asking you first. In Manual mode, Claude Code stops and asks you before most actions that edit files, run
On Pro, Max, and Team plans, the built-in starting mode is auto mode. [Which mode a session starts in](#which-mode-a-session-starts-in) covers the surfaces and settings that change
Each mode makes a different tradeoff between convenience and oversight. The table below shows what Claude can do without a permission prompt in each mode.
+105 −47 lines
Recorded here 15 Aug 2026 00:37 UTC
claude-code
network-config
±changed
+2−0
claude-codechanged
network-config
An [artifact](/docs/en/artifacts) that loads a typeface from [Google Fonts](/docs/en/artifacts#improve-the-visual-design) also requests `fonts.googleapis.com` and `fonts.gstatic.co
+2 −0 lines
Recorded here 15 Aug 2026 00:37 UTC
claude-code
env-vars
±changed
+2−0
claude-codechanged
env-vars
* [The auto-mode starting default](/docs/en/permission-modes#which-mode-a-session-starts-in) on Pro, Max, and Team plans; sessions start in Manual instead
* In the VS Code extension, [reading settings files for the starting mode](/docs/en/permission-modes#switch-permission-modes)
+2 −0 lines
Recorded here 15 Aug 2026 00:37 UTC
claude-code
desktop
±changed
+2−0
claude-codechanged
desktop
An [artifact](/docs/en/artifacts) that loads a typeface from [Google Fonts](/docs/en/artifacts#improve-the-visual-design) also requests `fonts.googleapis.com` and `fonts.gstatic.co
+2 −0 lines
Recorded here 15 Aug 2026 00:37 UTC
claude-code
artifacts
±changed
+11−7
claude-codechanged
artifacts
For typography, Claude can load a typeface from Google Fonts, the one external font source an artifact page can load from. Claude inlines any other typeface as a `@font-face` data
| Constraint | Effect
| :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------
| No external requests | The CSP blocks scripts, stylesheets, fonts, and images loaded from any other host, along with `fetch`, XHR, and WebSocket calls. Claude inlines CSS and Jav
+11 −7 lines
Recorded here 15 Aug 2026 00:37 UTC
14 Aug 2026
48 pages
+378 −341 lines
claude-code
tools-reference
±changed
+4−4
claude-codechanged
tools-reference
The `Permission required` column shows whether the tool prompts in the default permission mode for paths inside the working directory. File-access tools marked No, including `Rea
On Pro, Max, and Team plans, Claude Code starts sessions in [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode), where a classifier decides most of these prom
When Monitor runs a command, it uses the same [permission rules as Bash](/docs/en/permissions#tool-specific-permission-rules), so `allow` and `deny` patterns you have set for Bash
When Monitor runs a command, it uses the same [permission rules as Bash](/docs/en/permissions#tool-specific-permission-rules), so `allow` and `deny` patterns you have set for Bash
Opening a WebSocket prompts for approval, and the prompt doesn't offer an option to skip future prompts for the same host.
+4 −4 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
terminal-config
±changed
+1−1
claude-codechanged
terminal-config
| `promptBorder` | Input box border in the default permission mode |
| `promptBorder` | Input box border in Manual mode |
+1 −1 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
sub-agents
±changed
+7−7
claude-codechanged
sub-agents
| Agent | Model | When Claude uses it
| :---------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------
| claude | Inherits | When a task doesn't fit a more specialized agent. A catch-all with every tool [available to subagents](#available-tools). Also the [default age
| statusline-setup | Sonnet | When you run `/statusline` to configure your status line
| claude-code-guide | Haiku | When you ask questions about Claude Code features
+7 −7 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
skills
±changed
+1−1
claude-codechanged
skills
To keep a command from aborting at the default permission prompt, pre-approve it with [`allowed-tools`](#pre-approve-tools-for-a-skill). A matching ask or deny rule still aborts th
To keep an unmatched command from aborting here, pre-approve it with [`allowed-tools`](#pre-approve-tools-for-a-skill). A matching ask or deny rule still aborts the invocation rega
+1 −1 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
self-hosted-environments-configuration
±changed
+1−1
claude-codechanged
self-hosted-environments-configuration
Only enable auto mode on an environment whose session containers run with [default-deny network egress](/docs/en/self-hosted-environments-deploy#default-deny-egress) and the rest
Only pin auto mode on an environment whose session containers run with [default-deny network egress](/docs/en/self-hosted-environments-deploy#default-deny-egress) and the rest of
+1 −1 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
sandboxing
±changed
+5−5
claude-codechanged
sandboxing
Ask Claude to run a command, such as a build or a test suite. By default, commands inside the sandbox can write only to the working directory and the session temp directory. Th
Ask Claude to run a command, such as a build or a test suite. By default, commands inside the sandbox can write only to the working directory and the session temp directory. 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
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
Auto-allow mode works independently of your permission mode setting, with one exception: [plan mode](/docs/en/permission-modes#analyze-before-you-edit-with-plan-mode). Even if yo
+5 −5 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
prompt-caching
±changed
+1−1
claude-codechanged
prompt-caching
Switching between [permission modes](/docs/en/permission-modes), such as from default to accept edits, does not change the system prompt or tool definitions, so mode changes are ca
Switching between [permission modes](/docs/en/permission-modes), such as from Manual to accept edits, does not change the system prompt or tool definitions, so mode changes are cac
+1 −1 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
network-config
±changed
+15−6
claude-codechanged
network-config
Claude Code reads the certificate and key files at startup and re-reads them each time it applies settings. It doesn't watch those paths during a session, so it keeps presenting th
To rotate the certificate and key:
* **Running session**: replace the files at the same paths, then restart Claude Code so it picks up the new pair. A mid-session settings application, such as a remote managed-setti
+15 −6 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
hooks-guide
±changed
+1−1
claude-codechanged
hooks-guide
Press `Esc` to return to the CLI. Ask Claude to do something that requires permission, then switch away from the terminal. You should receive a desktop notification.
Press `Esc` to return to the CLI. Press `Shift+Tab` until the status bar shows `⏸ manual mode on`, ask Claude to do something that requires permission, then switch away from th
+1 −1 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
goal
±changed
+1−1
claude-codechanged
goal
A goal doesn't change permissions. In the default permission mode, Claude still asks before tool calls that your settings don't already allow, such as the test command above. To le
A goal doesn't change your permission mode. To let goal turns run unattended, run `/goal` in [auto mode](/docs/en/auto-mode-config). In [Manual mode](/docs/en/permission-modes), Cl
+1 −1 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
errors
±changed
+1−1
claude-codechanged
errors
* `Shell command permission check failed for pattern "..."`: the command's permission check returned something other than allow. Injected commands never prompt, so the invocation a
* `Shell command permission check failed for pattern "..."`: the command's permission check returned something other than allow. Injected commands never prompt, so the invocation a
+1 −1 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
env-vars
±changed
+1−0
claude-codechanged
env-vars
| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Set to `1` to stop Claude Code from re-reading the [mTLS client certificate and key](/docs/en/network-config#mtls-authen
+1 −0 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
desktop-quickstart
±changed
+9−5
claude-codechanged
desktop-quickstart
* **Code**: An interactive coding assistant with direct access to your local files. You review and approve each change in real time.
* **Code**: An interactive coding assistant with direct access to your local files. Depending on the permission mode, you approve each change as Claude proposes it or review the ch
By default, the Code tab starts in [Manual mode](/docs/en/desktop#choose-a-permission-mode), where Claude proposes changes and waits for your approval before applying them. You
What happens next depends on the [permission mode](/docs/en/desktop#choose-a-permission-mode) shown in the selector next to the send button:
+9 −5 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
desktop
±changed
+13−13
claude-codechanged
desktop
Permission modes control how much autonomy Claude has during a session: whether it asks before editing files, running commands, or both. You can switch modes at any time using the
Permission modes control how much autonomy Claude has during a session: whether it asks before editing files, running commands, or both. You can switch modes at any time using the
| **Manual** | `default` | Claude asks before editing files or running commands. You see a diff and can accept or reject each change. Recommended for new user
| **Manual** | `default` | Claude asks before editing files or running commands. You see a diff and can accept or reject each change.
| Key | Description
+13 −13 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
claude-apps-gateway-config
±changed
+23−18
claude-codechanged
claude-apps-gateway-config
* Disabled tools, from bare tool-name `permissions.deny` entries
* The egress allowlist, from `sandbox.network.allowedDomains`
* Disabled tools, from bare tool-name `permissions.deny` entries. If you set `disabledBuiltinTools` in the policy's `desktop` block, the gateway serves the union of your value and
* The egress allowlist, from `sandbox.network.allowedDomains`. If you set `coworkEgressAllowedHosts` in the policy's `desktop` block, the gateway uses that value instead of the der
To set `disabledBuiltinTools` or `coworkEgressAllowedHosts` in a policy's `desktop` block, you need Claude Code v2.1.232 or later on the gateway server.
+23 −18 lines
Recorded here 14 Aug 2026 22:37 UTC
claude-code
changelog
±changed
+23−0
claude-codechanged
changelog
<Update label="2.1.233" description="August 14, 2026">
* Added GitLab merge request URL support to the `--worktree` flag and the `claude agents` view (where MRs display as `!N`)
* Added an opt-in `forward_user_identity` apps gateway setting on Anthropic upstreams that sends the signed-in user's identity as headers, so a proxy behind the gateway can attri
* Added opt-in memory cgroup support for Bash tool commands on Linux (`CLAUDE_CODE_TOOL_MEMORY_LIMIT`) so a runaway build can't stall the session
+23 −0 lines
Recorded here 14 Aug 2026 22:37 UTC
Nothing on this page matches that. Press Enter to search every page of the ledger.