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
587 changed this week · last read 22 Oct 2026
Claude Code CLI
228pages tracked
146 changed this week · last read 22 Oct 2026
Claude Documentation
278pages tracked
74 changed this week · last read 22 Oct 2026
Model Context Protocol
357pages tracked
163 changed this week · last read 21 Oct 2026
100 on this page
5,287 of the ledger's changes in claude-code. Show every change
ReadSourcePageWhatLines
18 Aug 2026
53 pages
+1013 −986 lines
claude-code
settings
±changed
+1−1
claude-codechanged
settings
| `teammateDefaultModel` | Default model for [agent team](/docs/en/agent-teams) teammates when the spawn prompt doesn't specify one. Set to a model alias such as `"sonnet"`,
| `teammateDefaultModel` | Removed in v2.1.234; Claude Code ignores a leftover value. See [Specify teammates and models](/docs/en/agent-teams#specify-teammates-and-models)
+1 −1 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
sandboxing
±changed
+1−1
claude-codechanged
sandboxing
The sandbox's [auto-allow mode](#sandbox-modes) is separate from [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode): auto-allow approves Bash commands because
The sandbox's [auto-allow mode](#sandbox-modes) is separate from [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode): auto-allow approves Bash commands because
+1 −1 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
permissions
±changed
+12−10
claude-codechanged
permissions
| Tool type | Example | Approval required | "Yes, don't ask again" behavior |
| :---------------- | :--------------- | :---------------------------------------------------------------------------------- | :------------------------------------- |
| Read-only | File reads, Grep | No, within the [working directory and additional directories](#working-directories) | N/A |
| Bash commands | Shell execution | Yes, except a built-in set of [read-only commands](#read-only-commands) | Permanently per repository and command |
| File modification | Edit/write files | Yes | Until session end |
+12 −10 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
permission-modes
±changed
+15−0
claude-codechanged
permission-modes
## Common setups
Permission modes decide whether Claude asks before an action, and the [Bash sandbox](/docs/en/sandboxing) and outer [isolation boundaries](/docs/en/sandbox-environments) decide wha
+15 −0 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
model-config
±changed
+2−2
claude-codechanged
model-config
* **Subagent and teammate models**: the `model` field in [subagent](/docs/en/sub-agents#choose-a-model) frontmatter, the Agent tool's `model` parameter, [agent team](/docs/en/agent
* **Subagent and teammate models**: the `model` field in [subagent](/docs/en/sub-agents#choose-a-model) frontmatter, the Agent tool's `model` parameter, [agent team](/docs/en/agent
* **Subagent or teammate override**: Claude Code falls back to the [subagent's inherited model](/docs/en/sub-agents#choose-a-model) or the [default teammate model](/docs/en/agent-t
* **Subagent or teammate override**: Claude Code falls back to the [subagent's inherited model](/docs/en/sub-agents#choose-a-model) or the [lead's model for a teammate](/docs/en/ag
+2 −2 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
hooks-guide
±changed
+1−1
claude-codechanged
hooks-guide
| `SessionEnd` | why the session
| `SessionEnd` | why the session
+1 −1 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
hooks
±changed
+9−9
claude-codechanged
hooks
| `SessionEnd` | why the session ended
| `SessionEnd` | why the session ended
| Reason | Description |
| :---------------------------- | :----------------------------------------- |
| `clear` | Session cleared with `/clear` command |
+9 −9 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
fullscreen
±changed
+19−1
claude-codechanged
fullscreen
The relaunched session keeps the conversation as it appears on screen. Claude Code also carries over the model you last picked with [`/model`](/docs/en/model-config#setting-your-mo
Claude Code carries these into the relaunched session:
* The conversation as it appears on screen. After a [`/rewind`](/docs/en/checkpointing#rewind-and-summarize), that means:
* If you rewound earlier in the session, Claude Code relaunches from the rewound point, not from the longer transcript saved on disk. For example, if you rewound past your last t
+19 −1 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
errors
±changed
+27−1
claude-codechanged
errors
| `Cannot switch renderers in this session`
| `Cannot switch renderers while work is running in the background`
These errors come from the `claude` command line, its subcommands, and commands such as `/security-review` that gather context by running shell commands before their prompt runs.
These errors come from the `claude` command line, its subcommands, and commands such as `/security-review` that gather context by running shell commands before their prompt runs. S
+27 −1 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
agent-teams
±changed
+8−4
claude-codechanged
agent-teams
Teammates don't inherit the lead's `/model` selection by default. To change the model used when the prompt doesn't specify one, set **Default teammate model** in `/config`. Pick **
Claude Code checks each teammate's model, whether requested in your prompt or set through **Default teammate model**, against your organization's [`availableModels`](/docs/en/model
When your prompt doesn't name a model for a teammate, Claude Code runs the teammate on the lead's current model, unless [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/en/model-config#environ
+8 −4 lines
Recorded here 18 Aug 2026 01:07 UTC
claude-code
skills
±changed
+12−0
claude-codechanged
skills
### Remove a skill
How you remove a skill depends on where it came from:
+12 −0 lines
Recorded here 18 Aug 2026 00:37 UTC
claude-code
settings
±changed
+7−7
claude-codechanged
settings
| Feature | User location | Project location | Local location |
| :-------------- | :------------------------ | :--------------------------------- | :----------------------------- |
| **Settings** | `~/.claude/settings.json` | `.claude/settings.json` | `.claude/settings.local.json` |
| **Subagents** | `~/.claude/agents/` | `.claude/agents/` | None |
| **MCP servers** | `~/.claude.json` | `.mcp.json` | `~/.claude.json` (per-project) |
+7 −7 lines
Recorded here 18 Aug 2026 00:37 UTC
claude-code
prompt-caching
±changed
+1−1
claude-codechanged
prompt-caching
Adding a bare tool name like `Bash` or `WebFetch` as a [deny rule](/docs/en/permissions#manage-permissions) removes that tool from Claude's context entirely. Built-in tool definiti
Adding a bare tool name like `Bash` or `WebFetch` as a [deny rule](/docs/en/permissions#manage-permissions) removes that tool from Claude's context entirely. Built-in tool definiti
+1 −1 lines
Recorded here 18 Aug 2026 00:37 UTC
claude-code
permissions
±changed
+3−1
claude-codechanged
permissions
You can view and manage Claude Code's tool permissions with `/permissions`. This UI lists all permission rules and the `settings.json` file each rule comes from.
You can view and manage Claude Code's tool permissions with `/permissions`. The dialog lists all permission rules and the `settings.json` file each rule comes from. You can open th
To block Claude's file tools from reading a file or directory, add a `Read` deny rule for its path, such as `Read(./.env)` or `Read(./secrets/**)`; [Exclude sensitive files](/docs/
+3 −1 lines
Recorded here 18 Aug 2026 00:37 UTC
claude-code
errors
±changed
+10−7
claude-codechanged
errors
| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile`
* In the Code tab of the [Desktop app](/docs/en/desktop), the session-limit card shows an **Auto-continue when limits reset** checkbox. The weekly-limit card doesn't offer it. When
Your Console organization has run out of prepaid credits.
Your Console organization has run out of prepaid credits, or Claude Code is sending your requests with a Console API key when you meant to use your subscription.
* If you have a Pro, Max, Team, or Enterprise plan and see this, run `/status` and check the `API key` row. An approved `ANTHROPIC_API_KEY` in your environment routes requests thro
+10 −7 lines
Recorded here 18 Aug 2026 00:37 UTC
claude-code
commands
±changed
+5−5
claude-codechanged
commands
If you send a command while Claude is responding, it queues and runs after the current turn finishes. Some commands, such as `/status`, `/tasks`, and `/usage`, run immediately with
If you send a command while Claude is responding, Claude Code queues it and runs it after the current turn finishes. Claude Code runs some commands immediately without interrupting
| `/add-dir <path>` | Add a working directory for file access during the current session. Type a partial
| `/add-dir <path>` | Add a working directory for file access during the current session. Type a partial
| `/bug [report]` | Report a bug or share your conversation. You choose how much session history to in
+5 −5 lines
Recorded here 18 Aug 2026 00:37 UTC
claude-code
statusline
±changed
+1−1
claude-codechanged
statusline
* Because `statusLine` executes a shell command, Claude Code runs it under the same [workspace trust rule as hooks in settings files](/docs/en/permissions#what-runs-before-you-trus
* Because `statusLine` executes a shell command, Claude Code runs it under the same [workspace trust rule as hooks in settings files](/docs/en/permissions#what-runs-before-you-trus
+1 −1 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
plugin-marketplaces
±changed
+3−1
claude-codechanged
plugin-marketplaces
When a user adds an `https://` repository URL that Claude Code [clones rather than fetches](/docs/en/discover-plugins#add-from-other-git-hosts), such as a bare `github.com` or `git
Exact matching doesn't normalize URLs: a trailing slash, `.git` suffix, or `ssh://` versus `https://` form are treated as different values. If your organization's marketplace can b
The allowlist's exact matching doesn't normalize URLs: a trailing slash, `.git` suffix, or `ssh://` versus `https://` form are treated as different values. If your organization's m
+3 −1 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
permissions
±changed
+7−3
claude-codechanged
permissions
Claude Code saves trust per workspace, keyed on the git repository root or, outside a repository, the directory you started Claude Code from. When you start in your home directory,
Claude Code keys and stores the trust you accept according to where you start it:
* In a repository, Claude Code keys the trust on the git repository root, so the trust covers the whole repository apart from any git repository nested inside it, such as a submodu
* Outside a repository, Claude Code keys the trust on the directory you started it from, and the trust covers any subdirectory of that directory apart from a git repository nested
+7 −3 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
network-config
±changed
+2−1
claude-codechanged
network-config
| `*.frame.claudeusercontent.com` | [Artifact](/docs/en/artifacts) content reads. The CLI fetches an artifact's files from this host when Claude opens one, and only when the A
The preceding table covers the standalone CLI. The Claude Desktop app and claude.ai in a browser load their application code and user content from additional Anthropic CDN hosts, i
The preceding table covers the standalone CLI. The Claude Desktop app and claude.ai in a browser load their application code and user content from additional Anthropic CDN hosts, i
+2 −1 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
mcp
±changed
+1−1
claude-codechanged
mcp
Approvals in an untracked `.claude/settings.local.json` also apply, but only after you accept a trust dialog for that folder or one of its parent directories: Claude Code runs git
Claude Code also applies approvals from an untracked `.claude/settings.local.json`, but it runs git to check whether the file is tracked, and it runs that check only in a [trusted
+1 −1 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
hooks
±changed
+1−1
claude-codechanged
hooks
* **Interactive session**: Claude Code holds back hooks from every settings file, including your own `~/.claude/settings.json`, until you accept the [workspace trust dialog](/docs/
* **Interactive session**: Claude Code holds back hooks from every settings file, including your own `~/.claude/settings.json`, until you accept the [workspace trust dialog](/docs/
+1 −1 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
google-vertex-ai
±changed
+5−0
claude-codechanged
google-vertex-ai
If a region value isn't shaped like a region or location name, Claude Code treats it as unset. For example, Claude Code treats a value containing a slash, dot, or space as unset. C
* `VERTEX_REGION_CLAUDE_*`: Claude Code falls back to `CLOUD_ML_REGION`.
* `CLOUD_ML_REGION`: Claude Code falls back to `us-east5`.
+5 −0 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
errors
±changed
+1−1
claude-codechanged
errors
* Run `claude` in the directory and accept the trust dialog. The dialog appears even when a parent directory is already trusted, lists the rules being held back, and lets you decli
* Run `claude` in the directory and accept the trust dialog. [Project allow rules and workspace trust](/docs/en/permissions#project-allow-rules-and-workspace-trust) says which fold
+1 −1 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
env-vars
±changed
+1−1
claude-codechanged
env-vars
| `ANTHROPIC_AWS_BASE_URL` | Override the [Claude Platform on AWS](/docs/en/claude-platform-on-aws) endpoint URL. Use for custom regions or when rout
| `ANTHROPIC_AWS_BASE_URL` | Override the [Claude Platform on AWS](/docs/en/claude-platform-on-aws) endpoint URL. Use for custom regions or when rout
+1 −1 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
discover-plugins
±changed
+14−5
claude-codechanged
discover-plugins
Add any git repository by providing the full URL. This works with any Git host, including GitLab, Bitbucket, and self-hosted servers. Include the `.git` suffix so Claude Code clone
Include the `https://` prefix as well. Claude Code v2.1.196 and later reject a host typed without it, such as `gitlab.com/company/plugins.git`, as an invalid GitHub `owner/repo` sh
Add a git marketplace repository by providing its full URL. For an `https://` URL, whether to include the `.git` suffix depends on the host:
+14 −5 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
cloud-environments
±changed
+2−0
claude-codechanged
cloud-environments
If sessions in the environment work with [artifacts](/docs/en/artifacts), include `*.frame.claudeusercontent.com` in your list. Claude Code fetches artifact content from that host.
+2 −0 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
claude-platform-on-aws
±changed
+3−1
claude-codechanged
claude-platform-on-aws
`ANTHROPIC_AWS_WORKSPACE_ID` is required and is sent on every request as the `anthropic-workspace-id` header. Replace the example `wrkspc_01ABCDEFGHIJKLMN` value with your own work
`ANTHROPIC_AWS_WORKSPACE_ID` is required. Claude Code sends it on every request as the `anthropic-workspace-id` header. Replace the example `wrkspc_01ABCDEFGHIJKLMN` value with you
Claude Code computes the base URL as `https://aws-external-anthropic.{region}.api.aws` from the AWS region, which it resolves with the [same precedence as Amazon Bedrock](/docs/en/
+3 −1 lines
Recorded here 18 Aug 2026 00:07 UTC
claude-code
amazon-bedrock
±changed
+5−1
claude-codechanged
amazon-bedrock
The active profile is `AWS_PROFILE` if set, otherwise `default`. Set `AWS_SHARED_CREDENTIALS_FILE` or `AWS_CONFIG_FILE` to point at non-default file paths. Run `/status` to see t
If a value from any of these sources isn't shaped like a region name, Claude Code treats it as unset and continues down the order. For example, Claude Code treats a value contain
The active profile is `AWS_PROFILE` if set, otherwise `default`. Set `AWS_SHARED_CREDENTIALS_FILE` or `AWS_CONFIG_FILE` to point at non-default file paths.
+5 −1 lines
Recorded here 18 Aug 2026 00:07 UTC
17 Aug 2026
32 pages
+360 −269 lines
claude-code
tools-reference
±changed
+2−2
claude-codechanged
tools-reference
Where a subagent's permission prompts appear depends on whether it runs in the foreground or the background. Claude Code runs subagents in the background by default. For the cases
Where you see a subagent's permission prompts depends on whether it runs in the foreground or the background. Claude Code runs subagents in the background by default, apart from th
To limit what a subagent can reach in the first place, narrow its `tools` field, leave Bash off the list, or set deny rules in your settings, as described in [Control subagent capa
To [limit what a subagent can reach](/docs/en/sub-agents#control-subagent-capabilities) in the first place, narrow its `tools` field, for example by leaving Bash off the list, or s
+2 −2 lines
Recorded here 17 Aug 2026 22:37 UTC
claude-code
sub-agents
±changed
+9−7
claude-codechanged
sub-agents
* **Background subagents** run concurrently while you continue working. As of v2.1.186, when a background subagent reaches a tool call that needs permission, the prompt surfaces in
For each subagent Claude spawns, Claude Code picks the mode from the first of these cases that applies:
* **Background subagents** run concurrently while you continue working. When a background subagent reaches a tool call that needs permission, Claude Code surfaces the prompt in you
+9 −7 lines
Recorded here 17 Aug 2026 22:37 UTC
claude-code
statusline
±changed
+40−39
claude-codechanged
statusline
| Field | Description
| -------------------------------------------------------------------------------- | -----------------------------------------------------------------------------------------------
| `model.id`, `model.display_name` | Current model identifier and display name
| `cwd`, `workspace.current_dir` | Current working directory. Both fields contain the same value; `workspace.current_dir` is prefe
| `workspace.project_dir` | Directory where Claude Code was launched, which may differ from `cwd` if the working directory
+40 −39 lines
Recorded here 17 Aug 2026 22:37 UTC
claude-code
settings
±changed
+1−1
claude-codechanged
settings
| `prUrlTemplate` | URL template for the PR badge shown in the footer and in tool-result summaries. Substitutes `{host}`, `{owner}`, `{repo}`, `{number}`, and `{
| `prUrlTemplate` | URL template for the PR badge shown in the footer and in tool-result summaries. Substitutes `{host}`, `{owner}`, `{repo}`, `{number}`, and `{
+1 −1 lines
Recorded here 17 Aug 2026 22:37 UTC
claude-code
interactive-mode
±changed
+25−2
claude-codechanged
interactive-mode
The badge disappears once the pull request merges or closes. `Cmd+click` (macOS) or `Ctrl+click` (Windows/Linux) the link to open the pull request in your browser. The status refre
The badge disappears once the pull request merges or closes. `Cmd+click` (macOS) or `Ctrl+click` (Windows/Linux) the link to open the pull request in your browser. How often Claude
* **Anthropic API with [feature-flag fetching](/docs/en/env-vars#features-that-need-feature-flag-fetching) on**: about every 90 seconds while you're active in the session, and less
* **Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS, or feature-flag fetching off**: every 60 seconds
+25 −2 lines
Recorded here 17 Aug 2026 22:37 UTC
claude-code
how-claude-code-works
±changed
+1−1
claude-codechanged
how-claude-code-works
[Subagents](/docs/en/sub-agents) get their own fresh context, completely separate from your main conversation. Their work doesn't bloat your context. When done, they return a summa
[Subagents](/docs/en/sub-agents) work in their own context window. A subagent starts fresh unless it's a [fork](/docs/en/sub-agents#fork-the-current-conversation), which starts wit
+1 −1 lines
Recorded here 17 Aug 2026 22:37 UTC
claude-code
features-overview
±changed
+13−11
claude-codechanged
features-overview
| Feature | When it loads | What loads | Context cost |
| --------------------- | ------------------------------ | --------------------------------------------------- | -------------------------------------------- |
| **CLAUDE.md** | Session start | Full content | Every request |
| **Skills** | Session start + when used | Descriptions at start, full content when used | Low (descriptions every request)\* |
| **MCP servers** | Session start | Tool names; full schemas on demand | Low until a tool is used |
+13 −11 lines
Recorded here 17 Aug 2026 22:37 UTC
claude-code
env-vars
±changed
+3−2
claude-codechanged
env-vars
| `CLAUDE_CODE_FORK_SUBAGENT` | Controls [fork mode](/docs/en/sub-agents#turn-fork-mode-on-or-off), which lets Claude spawn [forked subagents](/docs/en/
| `CLAUDE_CODE_FORK_SUBAGENT` | Controls [fork mode](/docs/en/sub-agents#turn-fork-mode-on-or-off), which lets Claude spawn [forked subagents](/docs/en/
| `FORCE_HYPERLINK` | Set to `1` to enable clickable OSC 8 hyperlinks when your terminal supports them but isn't auto-detected, or `0` to disa
| `FORCE_HYPERLINK` | Set to `1` to enable clickable OSC 8 hyperlinks when your terminal supports them but isn't auto-detected, or `0` to disa
* Have Claude Code refresh the [PR review status badge](/docs/en/interactive-mode#pr-review-status) less often while you're idle; Claude Code refreshes it every 60 seconds instead
+3 −2 lines
Recorded here 17 Aug 2026 22:37 UTC
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
Nothing on this page matches that. Press Enter to search every page of the ledger.