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
10 Oct 2026
57 pages
+1352 −1008 lines
claude-code
plugins/host-marketplace
±changed
+5−0
claude-codechanged
plugins/host-marketplace
Tell users without a GitHub SSH key to set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` even though some of them can install without it:
* Without it, `claude plugin install` run from the shell can still install a plugin with a `github` source. When SSH to github.com is refused for a missing key or an untrusted host
* An install started inside a session and a plugin update also stay on SSH, and fail on a machine with no GitHub SSH key.
+5 −0 lines
Upstream edited 10 Oct 2026 16:33 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
plugins/components
±changed
+2−0
claude-codechanged
plugins/components
When another enabled plugin has the same name, one of the two registers its `hooks/hooks.json` hooks and the other's are left out. See [Hooks when two enabled plugins share a name]
+2 −0 lines
Upstream edited 10 Oct 2026 16:33 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
errors
±changed
+21−0
claude-codechanged
errors
| `Cannot add marketplace "<name>": Claude Code reserves this name and cannot register a marketplace under it` | [Plugin troubleshooting](/docs/en/plugins/troubleshooting#claude-co
| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Tool errors](#file-is-not-valid-utf-8) |
<h3 id="file-is-not-valid-utf-8">
File is not valid UTF-8
</h3>
+21 −0 lines
Upstream edited 10 Oct 2026 16:33 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
tools-reference
±changed
+24−11
claude-codechanged
tools-reference
Three checks must pass for an edit to apply. Before any of them, a path matched by a [`Read` deny rule](/docs/en/permissions#tool-specific-permission-rules) is refused, including c
* **Read-before-edit**: Claude reads the file in the current conversation before editing it, and a read cut short with a [`PARTIAL view` notice](#read-tool-behavior) doesn't count.
These checks must pass for an edit to apply. Before any of them, a path matched by a [`Read` deny rule](/docs/en/permissions#tool-specific-permission-rules) is refused, including c
+24 −11 lines
Upstream edited 10 Oct 2026 16:27 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
terminal-config
±changed
+11−0
claude-codechanged
terminal-config
## See session status in your terminal
If your terminal implements the OSC 7501 Program Status Protocol, it can show whether each interactive Claude Code session is working, waiting on you, or done, which helps when you
+11 −0 lines
Upstream edited 10 Oct 2026 16:27 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
settings-reference
±changed
+3−3
claude-codechanged
settings-reference
| [`copyFullResponse`](#copyfullresponse) | Make [`/copy`](/docs/en/commands) copy the full response without showing the code block picker | Global config settings | Global config
| [`copyFullResponse`](#copyfullresponse) | Make [`/copy`](/docs/en/commands) copy the full response without showing the picker | Global config settings | Global config |
Make [`/copy`](/docs/en/commands) copy the full response every time, without the picker it otherwise shows when the response contains code blocks. Selecting **Always copy full resp
Make [`/copy`](/docs/en/commands) copy the full response every time, without showing the picker. Selecting **Always copy full response** in that picker sets this key to `true`. App
* `false`: when the response contains code blocks, `/copy` shows a picker where you choose one code block or the full response
+3 −3 lines
Upstream edited 10 Oct 2026 16:27 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
interactive-mode
±changed
+1−1
claude-codechanged
interactive-mode
| `Ctrl+C` | Interrupt, or clear input | Interrupts a running operation. If nothing is running, the first press clears the prompt input and a second press exits Claude Code |
| `Ctrl+C` | Interrupt, or clear input | Interrupts a running operation. If nothing is running, the first press clears the prompt input and a second press exits Claude Code. Press
+1 −1 lines
Upstream edited 10 Oct 2026 16:27 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
checkpointing
±changed
+2−2
claude-codechanged
checkpointing
When a message you [queue while Claude works](/docs/en/interactive-mode#queue-messages-while-claude-works) reaches Claude within the running turn, it joins that turn instead of sta
In the rewind menu, a message you [typed while Claude was still working](/docs/en/interactive-mode#queue-messages-while-claude-works) can be marked **No code restore**. Claude read
To undo the edits Claude made after such a message, rewind to the prompt that started the turn. That rewinds the whole turn, including the work Claude did before your message arriv
You don't need to do anything about the message itself. To undo the file changes from that part of the session, select the prompt that started the turn and choose **Restore code**
+2 −2 lines
Upstream edited 10 Oct 2026 16:27 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
agent-view
±changed
+2−0
claude-codechanged
agent-view
An attached session doesn't [report its status to your terminal](/docs/en/terminal-config#see-session-status-in-your-terminal).
+2 −0 lines
Upstream edited 10 Oct 2026 16:27 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
self-hosted-environments-configuration
±changed
+5−3
claude-codechanged
self-hosted-environments-configuration
# before v2.1.280 so does core.sshCommand; if the hook holds credentials
# the session didn't, see the note below the script.
# before v2.1.280 so does core.sshCommand; see the note below the script
# before you give this push a credential.
The hook pushes with whatever git credentials are available in its own environment on the runner host. Under the [no-credentials-in-the-image posture](/docs/en/self-hosted-environm
+5 −3 lines
Upstream edited 10 Oct 2026 16:23 UTC Recorded here 10 Oct 2026 16:37 UTC
claude-code
claude-tag
±changed
+2−2
claude-codechanged
claude-tag
No line of the body moved in this read.
+2 −2 lines
Recorded here 10 Oct 2026 16:07 UTC
claude-code
self-hosted-environments-deploy
±changed
+2−0
claude-codechanged
self-hosted-environments-deploy
* **Credentials for the session's repositories only**: Anthropic supplies git credentials for the repositories that are part of the session, not for other repositories on the same
* **Branch pushes only**: a push that deletes a branch fails, and so does a push to any other kind of ref, such as a tag. For which branches a push can update, see [GitHub proxy](/
+2 −0 lines
Upstream edited 10 Oct 2026 16:03 UTC Recorded here 10 Oct 2026 16:07 UTC
claude-code
claude-apps-gateway-deploy
±changed
+15−15
claude-codechanged
claude-apps-gateway-deploy
<Info>
**Plan your gateway's network first.** At sign-in, Claude Code refuses a Claude apps gateway whose hostname resolves to a public IP address, even one the internet can't reach.
A Claude apps gateway can push settings to users' machines, including hooks that run shell commands. The check helps keep users from accidentally signing in to a malicious gatewa
+15 −15 lines
Upstream edited 10 Oct 2026 15:50 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
settings-reference
±changed
+5−5
claude-codechanged
settings-reference
| [`forceLoginGatewayUrl`](#forcelogingatewayurl) | Set the [gateway URL](/docs/en/claude-apps-gateway#set-the-gateway-url) the login screen connects to | Authentication and provid
| [`forceLoginGatewayUrl`](#forcelogingatewayurl) | Set the [gateway URL](/docs/en/claude-apps-gateway#set-the-gateway-url) the login screen connects to | Authentication and provid
* **Scope**: [`Any file`](#scopes). Claude Code honors `"gateway"` only from a managed source on the machine: `managed-settings.json`, the macOS plist or Windows HKLM registry, or
* **Scope**: [`Any file`](#scopes). Claude Code honors `"gateway"` from the same sources as [`forceLoginGatewayUrl`](#forcelogingatewayurl) and treats it as unset everywhere else.
Either this key or `forceLoginMethod: "gateway"` makes the machine gateway-only, except for sessions that select a cloud provider with `CLAUDE_CODE_USE_*`. `/login` then opens on t
+5 −5 lines
Upstream edited 10 Oct 2026 15:50 UTC Recorded here 10 Oct 2026 16:07 UTC
claude-code
errors
±changed
+2−0
claude-codechanged
errors
Claude Code also skips the check on a machine with no managed settings when your own `~/.claude/settings.json` [names a gateway](/docs/en/claude-apps-gateway#set-the-gateway-url-in
+2 −0 lines
Upstream edited 10 Oct 2026 15:50 UTC Recorded here 10 Oct 2026 16:07 UTC
claude-code
claude-apps-gateway-deploy
±changed
+1−1
claude-codechanged
claude-apps-gateway-deploy
Once the gateway is serving, push `forceLoginMethod`, `forceLoginGatewayUrl`, and `parentSettingsBehavior: "merge"` to each developer's machine through managed settings, via MDM or
Once the gateway is serving, push `forceLoginMethod`, `forceLoginGatewayUrl`, and `parentSettingsBehavior: "merge"` to each developer's machine through managed settings, via MDM or
+1 −1 lines
Upstream edited 10 Oct 2026 15:50 UTC Recorded here 10 Oct 2026 16:07 UTC
claude-code
claude-apps-gateway-config
±changed
+1−1
claude-codechanged
claude-apps-gateway-config
Claude Code honors [`forceLoginGatewayUrl`](/docs/en/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/en/settings-reference#gatewayinternalnetworks), and
Claude Code honors [`forceLoginGatewayUrl`](/docs/en/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/en/settings-reference#gatewayinternalnetworks), and
+1 −1 lines
Upstream edited 10 Oct 2026 15:50 UTC Recorded here 10 Oct 2026 16:07 UTC
claude-code
claude-apps-gateway
±changed
+19−3
claude-codechanged
claude-apps-gateway
Developers connect from their own laptops with one browser sign-in, using their corporate work account. They don't need a claude.ai account, an API key, or a subscription, because
Developers connect from their own laptops with one browser sign-in, using their corporate work account. They don't need a claude.ai account, an API key, or a subscription, because
Three keys go in the per-OS [managed settings file](/docs/en/managed-settings#delivery-mechanisms) you deploy via MDM or directly on disk. `forceLoginMethod` and `forceLoginGateway
Three keys go in the per-OS [managed settings file](/docs/en/managed-settings#delivery-mechanisms) you deploy via MDM or directly on disk. For a machine with no managed settings, s
A developer can't set this up manually. The login picker has no gateway option, and `forceLoginGatewayUrl` is ignored in a developer's own settings files. `forceLoginMethod` alone,
+19 −3 lines
Upstream edited 10 Oct 2026 15:50 UTC Recorded here 10 Oct 2026 16:07 UTC
claude-code
claude-tag
±changed
+1−1
claude-codechanged
claude-tag
No line of the body moved in this read.
+1 −1 lines
Recorded here 10 Oct 2026 02:07 UTC
claude-code
errors
±changed
+45−8
claude-codechanged
errors
| `Claude Code couldn't restart` | [Command-line errors](#claude-code-couldnt-restart) |
| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [Background session errors](#restarted-after-its-next-loop-wakeup-was-due) |
| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/en/env-vars) | unset | Maximum time in milliseconds that each API request spends waiting out `429` and `529` errors when `CLAUDE_
<h3 id="claude-code-couldnt-restart">
+45 −8 lines
Upstream edited 10 Oct 2026 01:38 UTC Recorded here 10 Oct 2026 02:07 UTC
claude-code
claude-tag
±changed
+2−2
claude-codechanged
claude-tag
No line of the body moved in this read.
+2 −2 lines
Recorded here 10 Oct 2026 01:07 UTC
claude-code
vs-code
±changed
+1−1
claude-codechanged
vs-code
To have each session connect to your browser as it starts, without typing `@browser`, see [Enable Chrome by default](/docs/en/chrome#enable-chrome-by-default). For when Claude Code
To have each session connect to your browser as it starts, without typing `@browser`, see [Enable Chrome by default](/docs/en/chrome#enable-chrome-by-default). For when Claude Code
+1 −1 lines
Upstream edited 10 Oct 2026 00:47 UTC Recorded here 10 Oct 2026 01:07 UTC
claude-code
chrome
±changed
+4−5
claude-codechanged
chrome
In a VS Code session, whether Claude Code asks you before a browser action depends on how the session connected to your browser:
* **You typed `@browser`**: the extension approves each browser action that Claude Code would otherwise ask you about.
* **The [Enabled by default](#enable-chrome-by-default) setting connected it at start**: Claude Code asks you before browser actions on a site you haven't allowed, in Manual, Edit
In a VS Code session, when Claude Code asks before a browser action, the prompt appears as a card in the chat panel. When the action targets a site you haven't allowed, the card al
+4 −5 lines
Upstream edited 10 Oct 2026 00:47 UTC Recorded here 10 Oct 2026 01:07 UTC
claude-code
claude-tag
±changed
+2−2
claude-codechanged
claude-tag
No line of the body moved in this read.
+2 −2 lines
Recorded here 10 Oct 2026 00:07 UTC
9 Oct 2026
65 pages
+3192 −2164 lines
claude-code
self-hosted-environments-testing
±changed
+3−3
claude-codechanged
self-hosted-environments-testing
<Note>
Self-hosted environments are in public beta on Team and Enterprise plans; [Availability and limitations](/docs/en/self-hosted-environments#availability-and-limitations) covers th
</Note>
> [!NOTE]
>
+3 −3 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
self-hosted-environments-identity
±changed
+107−111
claude-codechanged
self-hosted-environments-identity
<Note>
Self-hosted environments are in public beta on Team and Enterprise plans; an [Owner](/docs/en/cloud-environments#organization-shared-environments) enables them by turning on **Al
</Note>
> [!NOTE]
>
+107 −111 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
skills
±changed
+1−1
claude-codechanged
skills
* For Cowork and cloud sessions, enable the skill for your claude.ai account.
* For Cowork and cloud sessions, enable the skill for your claude.ai account. [Some sessions in a self-hosted environment](/docs/en/self-hosted-environments-configuration#how-each-
+1 −1 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
self-hosted-environments-testing
±changed
+14−4
claude-codechanged
self-hosted-environments-testing
1. Creates a session on the test environment with `claude -p "<prompt>" --environment <environment-id> --output-format json`, run from a git checkout so the CLI can auto-detect the
1. Creates a session on the test environment with `claude -p "<prompt>" --environment <environment-id> --output-format json`. Run the command from a git checkout so the CLI can aut
* **Session created**: one line of JSON such as `{"ok":true,"session_id":"session_...","title":"...","url":"...","pool_id":"..."}`
* **Session creation failed**: the line `{"ok":false,"error":"..."}`, and the command exits with status 1
* **Some earlier errors**, such as cloud sessions being unavailable for your organization or a missing prompt: the error on stderr with no JSON line, and the command exits with
+14 −4 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
self-hosted-environments-reference
±changed
+24−6
claude-codechanged
self-hosted-environments-reference
| `--server-auto-mode-lists <mode>` | `SELF_HOSTED_RUNNER_SERVER_AUTO_MODE_LISTS` | `no-allow` | Which of the [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode
| `--startup-timeout-min <n>` | `SELF_HOSTED_RUNNER_STARTUP_TIMEOUT_MS` | `15` | Release a session slot if the child hasn't signaled that it initialized within N minutes of spawn.
| `--startup-timeout-min <n>` | `SELF_HOSTED_RUNNER_STARTUP_TIMEOUT_MS` | `15` | Release a session slot if the child hasn't signaled that it initialized within N minutes of spawn.
| `--use-anthropic-git-proxy` | `CLAUDE_RUNNER_USE_GIT_PROXY=1` | off | Clone via the [Anthropic git proxy](/docs/en/self-hosted-environments-deploy#use-the-anthropic-git-proxy) in
| `--use-anthropic-git-proxy` | `CLAUDE_RUNNER_USE_GIT_PROXY=1` | off | Clone repositories on github.com via the [Anthropic git proxy](/docs/en/self-hosted-environments-deploy#use-
+24 −6 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
self-hosted-environments-quickstart
±changed
+39−7
claude-codechanged
self-hosted-environments-quickstart
* A repository for the test session: a public one, or one this host can already clone by its HTTPS URL without being asked for credentials.
Claude Code includes a guided setup: an interactive Claude Code session that walks you through creating the environment in the admin UI, starts a local runner with the secret file
Use either the [guided setup](#run-the-guided-setup) or the [manual steps](#set-up-manually). The guided setup is a single command that starts an interactive Claude Code session an
### Run the guided setup
+39 −7 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
self-hosted-environments-identity
±changed
+3−1
claude-codechanged
self-hosted-environments-identity
Use `jq -re` rather than `jq -r` so a missing claim causes a non-zero exit. With `-r` alone, a missing claim prints the literal string `null` and exits zero, which silently passes
Use `jq -re` rather than `jq -r` so a missing claim causes a non-zero exit. With `-r` alone, a missing claim prints the literal string `null` and exits zero, which silently passes
If `decode-token` can't fetch the keys from the JWKS endpoint or can't verify the token, it prints the reason to stderr, prints no claims, and exits with code 1. Pass `--no-verify`
+3 −1 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
self-hosted-environments-deploy
±changed
+129−20
claude-codechanged
self-hosted-environments-deploy
* **No broad credentials in the image**: don't include long-lived SSH keys, cloud-provider credentials, or personal access tokens that grant more than a session needs. Mint credent
* **No broad credentials in the image**: don't include long-lived SSH keys, cloud-provider credentials, or personal access tokens that grant more than a session needs. Mint credent
* **Keep the host's GitHub credentials away from sessions**: Claude can use any GitHub credential a session can read, with whatever access that credential grants. Keep the runner h
* **With [Anthropic-managed git](#use-the-anthropic-git-proxy)**: with such a credential, Claude reaches GitHub directly instead of through Anthropic-managed git.
* **Without Anthropic-managed git**: a clone credential can stay in the image if you scope it as tightly as [Ship git config in your image](#ship-git-config-in-your-image) descri
+129 −20 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
self-hosted-environments-configuration
±changed
+122−28
claude-codechanged
self-hosted-environments-configuration
| `CCR_SESSION_ACCOUNT_EMAIL` | The session creator's email, pre-extracted by the runner from the token's `act.email` claim without signature verification. Suitable for labelling,
| `CLAUDE_RUNNER_CLIENT_PLATFORM` | The client surface that created the session, such as `web_claude_ai`, `desktop_app`, `ios`, `claude_code_cli`, or `scheduled_trigger`. Anthropic
| `CCR_SESSION_ACCOUNT_EMAIL` | The session creator's email, pre-extracted by the runner from the token's `act.email` claim without signature verification. Suitable for labelling,
| `CLAUDE_RUNNER_CLIENT_PLATFORM` | The client surface that created the session, such as `web_claude_ai`, `desktop_app`, `ios`, `claude_code_cli`, or `scheduled_trigger`. Anthropic
| `CLAUDE_CODE_REMOTE_SLACK_THREAD_URL` | For a [Claude Tag](https://claude.com/docs/claude-tag/overview) session that belongs to one Slack thread, the link to that thread. Unset f
+122 −28 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
self-hosted-environments
±changed
+5−3
claude-codechanged
self-hosted-environments
* **SCM connector**: the optional orchestrator [SCM connector](/docs/en/self-hosted-environments-reference#scm-connector-flags) tunnel is the only WebSocket connection.
* **Git**: the runner clones from and pushes to your git host over HTTPS or SSH, authenticated with credentials your deployment provides; [Configure git](/docs/en/self-hosted-envir
* **Session child**: the child Claude Code process holds the session's event stream to `api.anthropic.com`, and makes its own outbound calls for model inference and for git command
* **Git**: the runner clones from and pushes to your git host over HTTPS or SSH, authenticated with credentials your deployment provides. See [Configure git](/docs/en/self-hosted-e
* **Session child**: the child Claude Code process holds the session's event stream to `api.anthropic.com`, and makes its own outbound calls for model inference and for git command
+5 −3 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
headless
±changed
+1−1
claude-codechanged
headless
Use the MCP server fields the same way. When you pass [`--mcp-config`](/docs/en/cli-reference#cli-flags) with `-p`, Claude Code waits for still-pending servers before running the f
Use the MCP server fields the same way. When you pass [`--mcp-config`](/docs/en/cli-reference#cli-flags) with `-p`, Claude Code waits for still-pending servers before running the f
+1 −1 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
cloud-environments
±changed
+1−1
claude-codechanged
cloud-environments
| Your user `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | No | Live on your machine, not in the repo. Commit them to the repo's `.claude/` directory instead. Cl
| Your user `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | No | Live on your machine, not in the repo. Commit them to the repo's `.claude/` directory instead. Cl
+1 −1 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
claude-projects
±changed
+12−6
claude-codechanged
claude-projects
Each approval covers that prompt, or the rest of that thread if you choose the broader option. To let every thread run certain commands without asking, or to block some, add [permi
Each approval covers that prompt, or the rest of that thread if you choose the broader option.
To let every thread run certain commands without asking, or to block some, add [permission rules](/docs/en/permissions) to the repository's `.claude/settings.json`. Check that clou
+12 −6 lines
Upstream edited 9 Oct 2026 23:38 UTC Recorded here 10 Oct 2026 00:07 UTC
claude-code
claude-tag
±changed
+1−1
claude-codechanged
claude-tag
No line of the body moved in this read.
+1 −1 lines
Recorded here 9 Oct 2026 23:37 UTC
claude-code
agent-sdk/streaming-output
±changed
+228−234
claude-codechanged
agent-sdk/streaming-output
<Tip>
This page covers output streaming (receiving tokens in real-time). For input modes (how you send messages), see [Send messages to agents](/docs/en/agent-sdk/streaming-vs-single-m
</Tip>
> [!TIP]
>
+228 −234 lines
Upstream edited 9 Oct 2026 23:17 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
headless
±changed
+2−0
claude-codechanged
headless
When stderr is a terminal and the run has waited five seconds, Claude Code prints a line to stderr that starts with `Waiting for background work to finish` and names the work. With
+2 −0 lines
Upstream edited 9 Oct 2026 23:17 UTC Recorded here 9 Oct 2026 23:37 UTC
claude-code
agent-sdk/typescript
±changed
+15−10
claude-codechanged
agent-sdk/typescript
Claude Code sets `user_message_uuid` and `user_message_uuids` on the turn's first assistant message, under the conditions in [`user_message_uuid`](#user_message_uuid). When Claude
Claude Code sets `user_message_uuid` and `user_message_uuids` on the turn's first assistant message, under the conditions in [`user_message_uuid`](#user_message_uuid). When the tur
Each paste field has a size limit:
+15 −10 lines
Upstream edited 9 Oct 2026 23:17 UTC Recorded here 9 Oct 2026 23:37 UTC
claude-code
agent-sdk/streaming-output
±changed
+6−0
claude-codechanged
agent-sdk/streaming-output
### Handle a stream that's cut off
If a stream is cut off mid-message, such as when you interrupt the turn or the connection drops, you still receive that message's `message_stop` before the turn ends. A cut text or
Before Claude Code v2.1.290, a cut stream could end the turn without `message_stop`, so a reply you render from stream events could stay shown as in progress. The TypeScript Agent
+6 −0 lines
Upstream edited 9 Oct 2026 23:17 UTC Recorded here 9 Oct 2026 23:37 UTC
claude-code
claude-apps-gateway-config
±changed
+2−2
claude-codechanged
claude-apps-gateway-config
A policy's Claude Code settings, such as a rule that denies reading `.env` files, go in a block under the `cli` or `code` key. Both keys take the same contents. The key decides whe
A policy's Claude Code settings, such as a rule that denies reading `.env` files, go in a block under the `cli` or `code` key. `code` is the recommended key, and `cli` is the legac
The choice is whether these settings should also cover the Code tab. If not, change nothing. A file that uses `cli` works as it did, and a gateway that finds `cli` in a policy with
A file that uses `cli` works as it did, and a gateway that finds `cli` in a policy with a [`desktop`](#claude-desktop-overlay) key warns at boot and starts anyway. Switch to `code`
+2 −2 lines
Upstream edited 9 Oct 2026 23:13 UTC Recorded here 9 Oct 2026 23:37 UTC
claude-code
claude-tag
±changed
+1−1
claude-codechanged
claude-tag
No line of the body moved in this read.
+1 −1 lines
Recorded here 9 Oct 2026 22:37 UTC
claude-code
managed-settings
±changed
+40−70
claude-codechanged
managed-settings
<Steps>
<Step title="Write managed-settings.json">
Write a `managed-settings.json` that holds the keys you've decided to enforce, in the same JSON shape as `settings.json`. The [Decide what to enforce](/docs/en/admin-setup#deci
```json managed-settings.json theme={null}
+40 −70 lines
Upstream edited 9 Oct 2026 22:32 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
claude-apps-gateway-on-aws
±changed
+407−413
claude-codechanged
claude-apps-gateway-on-aws
<Note>
This page walks through one way to run Claude apps gateway on AWS. The configuration is a working example for customer-managed infrastructure rather than a supported production d
</Note>
> [!NOTE]
>
+407 −413 lines
Upstream edited 9 Oct 2026 22:32 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
managed-settings
±changed
+1−1
claude-codechanged
managed-settings
1. Remote settings, delivered from claude.ai as [server-managed settings](/docs/en/server-managed-settings) or by a [Claude apps gateway](/docs/en/claude-apps-gateway). Claude Code
1. Remote settings, delivered from claude.ai as [server-managed settings](/docs/en/server-managed-settings) or by a [Claude apps gateway](/docs/en/claude-apps-gateway). Claude Code
+1 −1 lines
Upstream edited 9 Oct 2026 22:32 UTC Recorded here 9 Oct 2026 22:37 UTC
claude-code
claude-apps-gateway-on-aws
±changed
+1−1
claude-codechanged
claude-apps-gateway-on-aws
The gateway is now running, but developers can't reach it from `/login` until the gateway URL is on their machines. Set `forceLoginMethod` and `forceLoginGatewayUrl` in the [ma
The gateway is now running, but developers can't reach it from `/login` until the gateway URL is on their machines. Deploy the full [managed settings snippet](/docs/en/claude-a
+1 −1 lines
Upstream edited 9 Oct 2026 22:32 UTC Recorded here 9 Oct 2026 22:37 UTC
claude-code
claude-apps-gateway-deploy
±changed
+1−1
claude-codechanged
claude-apps-gateway-deploy
The first registration can run before the developer signs in to the gateway, when no gateway policy has arrived. To cover that first start, deliver your choice in [client-side mana
The first registration can run before the developer signs in to the gateway, when no gateway policy has arrived. To cover that first start, deliver your choice in [client-side mana
+1 −1 lines
Upstream edited 9 Oct 2026 22:32 UTC Recorded here 9 Oct 2026 22:37 UTC
claude-code
claude-apps-gateway-config
±changed
+58−4
claude-codechanged
claude-apps-gateway-config
#### Choose `cli` or `code`
<Warning>
When a policy uses the `code` key, each of these stops the gateway from starting:
+58 −4 lines
Upstream edited 9 Oct 2026 22:32 UTC Recorded here 9 Oct 2026 22:37 UTC
claude-code
claude-apps-gateway
±changed
+11−7
claude-codechanged
claude-apps-gateway
This last step happens on a developer machine, not the server. Set `forceLoginMethod` to `"gateway"` and `forceLoginGatewayUrl` to your gateway's `public_url` in that machine's
This last step happens on a developer machine, not the server. Set `forceLoginMethod` to `"gateway"`, `forceLoginGatewayUrl` to your gateway's `public_url`, and `parentSettings
Claude Desktop runs its Cowork and Code tabs, plus the Chat tab when you enable it, on embedded Claude Code sessions and sends their model requests through the gateway. It passes p
Other `cli` keys, such as hooks, `env`, and scoped permission rules like `Bash(npm *)`, reach only clients that sign in through `/login`. Claude Desktop reads the gateway URL from
+11 −7 lines
Upstream edited 9 Oct 2026 22:32 UTC Recorded here 9 Oct 2026 22:37 UTC
claude-code
claude-tag
±changed
+2−2
claude-codechanged
claude-tag
No line of the body moved in this read.
+2 −2 lines
Recorded here 9 Oct 2026 22:07 UTC
claude-code
managed-settings
±changed
+2−0
claude-codechanged
managed-settings
If your organization has the [HIPAA configuration](/docs/en/hipaa-setup#deploy-managed-settings) applied, see `settings-hipaa.json` and `README-hipaa.md` in the [settings examples
+2 −0 lines
Upstream edited 9 Oct 2026 21:39 UTC Recorded here 9 Oct 2026 22:07 UTC
claude-code
hipaa-setup
±changed
+3−0
claude-codechanged
hipaa-setup
For a fuller `managed-settings.json` with sandboxing, a network allowlist, credential protections, and local data retention, see `settings-hipaa.json` and `README-hipaa.md` in the
* [HIPAA settings example](https://github.com/anthropics/claude-code/tree/main/examples/settings)
+3 −0 lines
Upstream edited 9 Oct 2026 21:39 UTC Recorded here 9 Oct 2026 22:07 UTC
claude-code
claude-tag
±changed
+2−2
claude-codechanged
claude-tag
No line of the body moved in this read.
+2 −2 lines
Recorded here 9 Oct 2026 21:37 UTC
claude-code
remote-control
±changed
+32−1
claude-codechanged
remote-control
* `/mcp`: from the mobile app, returns a text summary of server status instead of opening the picker. On the web, `/mcp` on its own opens a directory of [claude.ai connectors](/d
* `/mcp`: from the mobile app, returns a text summary of server status instead of opening the picker. On the web, `/mcp` on its own opens a directory of [claude.ai connectors](/d
## Authorize a connector again from your shell
+32 −1 lines
Upstream edited 9 Oct 2026 21:26 UTC Recorded here 9 Oct 2026 21:37 UTC
claude-code
mcp
±changed
+1−1
claude-codechanged
mcp
The `claude mcp login <name>` command runs a configured server's OAuth flow directly from your shell, so you don't need to open the `/mcp` panel inside a session.
The `claude mcp login <name>` command runs a configured server's OAuth flow directly from your shell, so you don't need to open the `/mcp` panel inside a session. For a claude.ai c
+1 −1 lines
Upstream edited 9 Oct 2026 21:26 UTC Recorded here 9 Oct 2026 21:37 UTC
claude-code
claude-apps-gateway-config
±changed
+19−1
claude-codechanged
claude-apps-gateway-config
In sessions signed in through `/login`, the CLI stamps each export with the authenticated user's identity, read from the gateway-issued JWT: the `user.id`, `user.email`, and `user.
In sessions signed in through `/login`, the CLI stamps each export with the authenticated user's identity, read from the gateway-issued JWT: the `user.id`, `user.email`, and `user.
#### Group changes during an open session
+19 −1 lines
Upstream edited 9 Oct 2026 21:26 UTC Recorded here 9 Oct 2026 21:37 UTC
claude-code
setup
±changed
+5−5
claude-codechanged
setup
```bash theme={null} theme={null}
```bash theme={null}
```powershell theme={null} theme={null}
```powershell theme={null}
```batch theme={null} theme={null}
+5 −5 lines
Upstream edited 9 Oct 2026 21:25 UTC Recorded here 9 Oct 2026 21:37 UTC
claude-code
agent-sdk/typescript
±changed
+83−0
claude-codechanged
agent-sdk/typescript
usage_report?: SDKUsageReport;
`usage_report` is a structured copy of the `/usage` report, typed as [`SDKUsageReport`](#sdkusagereport), and requires Agent SDK v0.3.273 or later. When you send `/usage` as a prom
* The session authenticates with a claude.ai credential
+83 −0 lines
Upstream edited 9 Oct 2026 21:25 UTC Recorded here 9 Oct 2026 21:37 UTC
claude-code
claude-tag
±changed
+1−1
claude-codechanged
claude-tag
No line of the body moved in this read.
+1 −1 lines
Recorded here 9 Oct 2026 21:07 UTC
claude-code
troubleshooting
±changed
+1−1
claude-codechanged
troubleshooting
| Update or install download fails with `The connection dropped while downloading the update` or `aborted` | [Error reference](/docs/en/errors#the-connection-dropped-while-download
| Update or install download fails with `The connection dropped while downloading the update` or `aborted` | [Troubleshoot installation and login](/docs/en/troubleshoot-install#the
+1 −1 lines
Upstream edited 9 Oct 2026 20:59 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
troubleshoot-install
±changed
+169−13
claude-codechanged
troubleshoot-install
| `Native installation exists but ... is not in your PATH` | [Add the install directory to your PATH](#verify-your-path) |
| `INFO: Could not find files for the given pattern(s).` from `where.exe claude` | [Check whether Claude Code is installed](#check-for-conflicting-installations) |
| `zsh: permission denied: /Users/you/.zshrc` or `bash: /home/you/.bashrc: Permission denied` | [Make your shell config file writable](#permission-denied-when-adding-to-your-path)
| `< was unexpected at this time` in CMD | [Install script returns HTML](#install-script-returns-html-instead-of-a-shell-script) |
| `The term 'System.Xml.XmlDocument' is not recognized` | [Install script returns HTML](#install-script-returns-html-instead-of-a-shell-script) |
+169 −13 lines
Upstream edited 9 Oct 2026 20:59 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
errors
±changed
+3−44
claude-codechanged
errors
| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |
| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
| `Installation was killed before it could finish (exit code 137)` | [Troubleshoot installation and login](/docs/en/troubleshoot-install#installation-was-killed-before-it-could-fin
| `The connection dropped while downloading the update` | [Troubleshoot installation and login](/docs/en/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |
+3 −44 lines
Upstream edited 9 Oct 2026 20:59 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
vs-code
±changed
+1−0
claude-codechanged
vs-code
| `spinnerVerbs` | `{"mode": "append", "verbs": []}` | Set the verbs the conversation spinner rotates through while a turn runs, with the same `mode` and `verbs` fields as the CLI'
+1 −0 lines
Upstream edited 9 Oct 2026 20:58 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
chrome
±changed
+35−2
claude-codechanged
chrome
Three restrictions apply to uploads:
If Claude refuses to attach a file or an upload fails, check for these causes:
* **Credential names**: Claude refuses a file whose name or folder is one that credentials are kept under, such as `.env`, a `.pem` or `.key` file, or anything under `.ssh`. Requir
### Project settings can't turn on Chrome
+35 −2 lines
Upstream edited 9 Oct 2026 20:51 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
plugins/create
±changed
+174−196
claude-codechanged
plugins/create
<Note>
These cases are covered on other pages:
* **Installing someone else's plugin**: see [Install plugins](/docs/en/plugins/install)
* **Not sure you need a plugin**: see [Decide whether you need a plugin](/docs/en/plugins/overview#decide-whether-you-need-a-plugin) on the overview
+174 −196 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
jetbrains
±changed
+37−45
claude-codechanged
jetbrains
<Steps>
<Step title="Install the Claude Code CLI">
Follow the [quickstart](/docs/en/quickstart) to install the CLI if you haven't already. The plugin shows a "Cannot launch Claude Code" notification when `claude` isn't on your
</Step>
+37 −45 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
agent-sdk/migration-guide
±changed
+50−56
claude-codechanged
agent-sdk/migration-guide
<span id="for-typescript/javascript-projects" />
<span id="for-python-projects" />
<Warning>
+50 −56 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
setup
±changed
+20−10
claude-codechanged
setup
```bash theme={null}
```bash theme={null} theme={null}
```powershell theme={null}
```powershell theme={null} theme={null}
```batch theme={null}
+20 −10 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
security-guidance
±changed
+9−3
claude-codechanged
security-guidance
### On each file edit
<span id="on-each-file-edit" />
### Checks on each file edit
### At the end of each turn
+9 −3 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
plugins/create
±changed
+10−8
claude-codechanged
plugins/create
#### From a directory or `.zip`
<span id="from-a-directory-or-zip" />
#### Load a plugin from a directory or `.zip`
<h4 id="load-a-folder-of-plugins">
+10 −8 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
monitoring-usage
±changed
+9−3
claude-codechanged
monitoring-usage
### For metrics
<span id="for-metrics" />
### Backends for metrics
### For events/logs
+9 −3 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
mcp
±changed
+12−4
claude-codechanged
mcp
#### From a URL
<span id="from-a-url" />
#### Add a server from a URL
#### From an `npx`, `uvx`, or binary command
+12 −4 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
jetbrains
±changed
+6−2
claude-codechanged
jetbrains
### From your IDE
<span id="from-your-ide" />
### Run Claude Code from your IDE
### From external terminals
+6 −2 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
glossary
±changed
+1−1
claude-codechanged
glossary
Learn more: [From cloud to terminal](/docs/en/claude-code-on-the-web#from-cloud-to-terminal)
Learn more: [Continue a cloud session in your terminal](/docs/en/claude-code-on-the-web#from-cloud-to-terminal)
+1 −1 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
claude-code-on-the-web
±changed
+6−2
claude-codechanged
claude-code-on-the-web
### From terminal to cloud
<span id="from-terminal-to-cloud" />
### Start a cloud session from your terminal
### From cloud to terminal
+6 −2 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
agent-view
±changed
+9−3
claude-codechanged
agent-view
### From agent view
<span id="from-agent-view" />
### Dispatch an agent from agent view
### From inside a session
+9 −3 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
agent-sdk/migration-guide
±changed
+6−2
claude-codechanged
agent-sdk/migration-guide
### For TypeScript/JavaScript Projects
<span id="for-typescript/javascript-projects" />
### Migrate a TypeScript or JavaScript project
### For Python Projects
+6 −2 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
agent-sdk/mcp
±changed
+7−3
claude-codechanged
agent-sdk/mcp
### In code
<span id="in-code" />
### Add a server in code
### From a config file
+7 −3 lines
Upstream edited 9 Oct 2026 20:45 UTC Recorded here 9 Oct 2026 21:07 UTC
claude-code
claude-tag
±changed
+1−1
claude-codechanged
claude-tag
No line of the body moved in this read.
+1 −1 lines
Recorded here 9 Oct 2026 20:07 UTC
claude-code
plugins/mods/api
±changed
+89−8
claude-codechanged
plugins/mods/api
A mod can ask a model a question of its own, outside the conversation, for a small job such as sorting or summarizing a piece of text. `$.model.complete` sends one prompt to a mode
A mod can send its own requests to a model for a small job such as classifying or summarizing text. `$.model.complete` sends your prompt on its own, and `$.model.fork({ prompt })`
This table compares what each request contains:
+89 −8 lines
Upstream edited 9 Oct 2026 19:51 UTC Recorded here 9 Oct 2026 20:07 UTC
claude-code
changelog
±changed
+93−0
claude-codechanged
changelog
<Update label="2.1.296" description="October 9, 2026">
**Added**
* Added a `code` key to the Claude apps gateway's `managed.policies[]`: the same settings as `cli`, also applied in Claude Desktop's Code tab; beside `desktop`, it turns on Claud
+93 −0 lines
Upstream edited 9 Oct 2026 19:44 UTC Recorded here 9 Oct 2026 20:07 UTC
claude-code
vs-code
±changed
+1−0
claude-codechanged
vs-code
* **Files Claude sends you**: when the session is connected to [Remote Control](/docs/en/remote-control#start-a-remote-control-session) and Claude sends you files with the [`SendUs
+1 −0 lines
Upstream edited 9 Oct 2026 19:41 UTC Recorded here 9 Oct 2026 20:07 UTC
claude-code
monitoring-usage
±changed
+2−0
claude-codechanged
monitoring-usage
Each time Claude Code reads a prompt, it logs at most 100 events with a `mention_type` of `"agent"` and 100 with `"mcp_resource"`. Mentions past either limit still resolve but emit
+2 −0 lines
Upstream edited 9 Oct 2026 19:41 UTC Recorded here 9 Oct 2026 20:07 UTC
claude-code
claude-code-on-the-web
±changed
+1−1
claude-codechanged
claude-code-on-the-web
* **Not restored**: background work that was still running when the VM was reclaimed, such as subagents and shell commands
* **Not restored**: background work that was still running when the VM was reclaimed, such as subagents and shell commands, and the pending wakeup of a [self-paced `/loop`](/docs/e
+1 −1 lines
Upstream edited 9 Oct 2026 19:41 UTC Recorded here 9 Oct 2026 20:07 UTC
claude-code
claude-tag
±changed
+1−1
claude-codechanged
claude-tag
No line of the body moved in this read.
+1 −1 lines
Recorded here 9 Oct 2026 19:37 UTC
claude-code
plugins/publish
±changed
+42−48
claude-codechanged
plugins/publish
<Note>
These cases are covered on other pages:
* **Your plugin isn't finished yet**: start with [Create a plugin](/docs/en/plugins/create)
* **You maintain a CLI or SDK with a plugin in an official marketplace**: see [Recommend your plugin from your CLI](/docs/en/plugins/cli-hints)
+42 −48 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
plugins/troubleshooting
±changed
+53−1
claude-codechanged
plugins/troubleshooting
<h3 id="cannot-install-plugins-from-a-marketplace-with-this-name">
`Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name`
</h3>
+53 −1 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
plugins/publish
±changed
+1−1
claude-codechanged
plugins/publish
In your shell, run `claude plugin validate .` in the repository to check the file before you push.
In your shell, run `claude plugin validate .` in the repository before you push. For what the run checks, see [Validate a directory](/docs/en/plugins/cli-reference#validate-a-direc
+1 −1 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
plugins/mods/troubleshoot
±changed
+12−0
claude-codechanged
plugins/mods/troubleshoot
### `code nested too deep to scan: more than 2000 scopes`
The line starts with the mod's name, then `hooks module did not load:`, the file, and `code nested too deep to scan: more than 2000 scopes`. A file in a hooks module can't nest sco
Rewrite the code so its scopes nest less deeply.
+12 −0 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
plugins/mods/reference
±changed
+3−2
claude-codechanged
plugins/mods/reference
| `tool.describe` | Once for each tool, when its description is first sent to Claude | `{ description }`, optionally with `isDeferred` set to `true` to put the tool behind [tool se
| `tool.describe` | Once for each tool, when its description is first sent to Claude. A second time for an MCP tool when Claude loads it through [tool search](/docs/en/mcp#scale-wi
| `session.append` | Once for each row the conversation keeps, such as a prompt, a response block, a tool result, or a notice, before it's stored | `next({ ...e, message })` to rew
| `session.append` | Once for each row the conversation keeps, such as a prompt, a response block, a tool result, or a notice, before it's stored | `next({ ...e, message })` with a
| Scopes, such as functions, blocks, and loops, nested inside one another in one file of a hooks module | 2,000 |
+3 −2 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
plugins/mods/events
±changed
+10−3
claude-codechanged
plugins/mods/events
To change a call, pass changed arguments to `next`. To retry a call, call `next(e)` again: a hook that sees `isError` on the first result can run the tool a second time and return
Your hook can also change a call, retry it, answer it itself, or withhold its result:
* **Change the call**: pass changed arguments to `next`.
* **Retry the call**: call `next(e)` again. A hook that sees `isError` on the first result can run the tool a second time and return that result.
+10 −3 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
plugins/mods/create
±changed
+1−1
claude-codechanged
plugins/mods/create
Each time Claude Code loads or reloads a mod from a directory you pass to `--plugin-dir`, or a mod [Claude wrote for you](#ask-claude-for-a-mod), it writes TypeScript declaration f
When Claude Code loads a mod from `--plugin-dir` in an interactive session, or a mod [Claude wrote for you](#ask-claude-for-a-mod), it writes TypeScript declaration files into the
+1 −1 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
plugins/marketplace-reference
±changed
+1−1
claude-codechanged
plugins/marketplace-reference
| `name` | string | Marketplace identifier: letters, digits, `.`, `_`, and `-`, starting with a letter or digit, and no `..`. `claude plugin validate` fails any other name, because
| `name` | string | Marketplace identifier: letters, digits, `.`, `_`, and `-`, starting with a letter or digit, and no `..`. `claude plugin validate` fails any other name, because
+1 −1 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
plugins/install
±changed
+2−0
claude-codechanged
plugins/install
If you haven't added that marketplace yet, the command prints `Successfully added marketplace: <name> (declared in user settings)` and then [installs the plugin](#install-from-your
+2 −0 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
plugins/host-marketplace
±changed
+8−2
claude-codechanged
plugins/host-marketplace
A user accepts a plugin entry's command each time they install or update that one plugin by itself. They do that from the plugin's own view in `/plugin`, or with `claude plugin ins
A user accepts a plugin entry's command each time they install or update that one plugin by itself. Claude Code shows the command and the archive URL, and runs the command only aft
Users can install or update the plugin inside a Claude Code session in a terminal, in their shell with no session running, or in the VS Code extension:
+8 −2 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
errors
±changed
+3−0
claude-codechanged
errors
| `Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name` | [Plugin troubleshooting](/docs/en/plugins/troubleshooting#cannot-install
| `does not load (...), so Claude Code ignores the whole file` | [Plugin troubleshooting](/docs/en/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |
| `Plugin directory does not exist: <path>` | [Plugin troubleshooting](/docs/en/plugins/troubleshooting#plugin-directory-does-not-exist) |
+3 −0 lines
Upstream edited 9 Oct 2026 19:26 UTC Recorded here 9 Oct 2026 19:37 UTC
claude-code
claude-tag
±changed
+2−2
claude-codechanged
claude-tag
No line of the body moved in this read.
+2 −2 lines
Recorded here 9 Oct 2026 19:07 UTC
claude-code
hooks-guide
±changed
+17−14
claude-codechanged
hooks-guide
When the hook succeeds, Claude Code shows nothing in the conversation. To confirm the hook ran, check that the edited file is reformatted, or see [Debug techniques](#debug-techniqu
When the hook succeeds, Claude Code shows nothing in the conversation. To confirm the hook ran, check that the edited file is reformatted, or see [Check what a hook did](#check-wha
The endpoint should return a JSON response body using the same [output format](/docs/en/hooks#json-output) as command hooks. To block a tool call, return a 2xx response with the ap
Your endpoint responds with a JSON body in the same [output format](/docs/en/hooks#json-output) as command hooks, and Claude Code also checks the response status:
+17 −14 lines
Upstream edited 9 Oct 2026 18:44 UTC Recorded here 9 Oct 2026 19:07 UTC
Nothing on this page matches that. Press Enter to search every page of the ledger.