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
812pages tracked
765 changed this week · last read 23 Oct 2026
Claude Code CLI
228pages tracked
147 changed this week · last read 23 Oct 2026
Claude Documentation
280pages tracked
77 changed this week · last read 23 Oct 2026
Model Context Protocol
357pages tracked
171 changed this week · last read 22 Oct 2026
100 on this page
5,591 of the ledger's changes in claude-code. Show every change
ReadSourcePageWhatLines
25 Sep 2026
81 pages
+2079 −6172 lines
claude-code
agent-sdk/plugins
±changed
+219−227
claude-codechanged
agent-sdk/plugins
<CodeGroup>
```typescript TypeScript theme={null}
import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
+219 −227 lines
Upstream edited 25 Sep 2026 23:42 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
headless
±changed
+33−33
claude-codechanged
headless
| To load | Use |
| ----------------------- | ------------------------------------------------------- |
| To load | Use |
| - | - |
| Settings | `--settings <file-or-json>` |
+33 −33 lines
Upstream edited 25 Sep 2026 23:42 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
headless
±changed
+6−4
claude-codechanged
headless
| Field | Type | Description
| --------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------
| `plugins` | array | plugins that loaded successfully, each with `name` and `path`
| `plugin_errors` | array | plugin load-time errors, each with `plugin`, `type`, and `message`. Includes unsatisfied dependency versions and `--plugin-dir` load failures such as a
| Field | Type | Description
+6 −4 lines
Upstream edited 25 Sep 2026 23:42 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
agent-sdk/plugins
±changed
+1−1
claude-codechanged
agent-sdk/plugins
If your plugin doesn't appear in the init message:
If your plugin doesn't appear in the init message's `plugins` list, check its [`plugin_errors`](/docs/en/agent-sdk/typescript#sdksystemmessage) field for the reason, then work thro
+1 −1 lines
Upstream edited 25 Sep 2026 23:42 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
permission-modes
±changed
+8−2
claude-codechanged
permission-modes
The [actions no mode auto-approves](#actions-no-mode-auto-approves) still prompt in this mode.
The [actions no mode auto-approves](#actions-no-mode-auto-approves) still prompt in this mode. The [Remove-Item in PowerShell](#remove-item-in-powershell) denies also apply in this
When you enable the [PowerShell tool](/docs/en/tools-reference#powershell-tool), Claude Code gives `Remove-Item` its own check, separate from the `rm` critical-path list. The outco
When you enable the [PowerShell tool](/docs/en/tools-reference#powershell-tool), Claude Code gives `Remove-Item` and the `cmd` built-ins `rd`, `rmdir`, `del`, and `erase` their own
+8 −2 lines
Upstream edited 25 Sep 2026 23:41 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
env-vars
±changed
+1−0
claude-codechanged
env-vars
| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Set to `1` to turn off the [PowerShell tool](/docs/en/tools-reference#powershell-tool) check that denies the `cmd` built
+1 −0 lines
Upstream edited 25 Sep 2026 23:41 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
keybindings
±changed
+22−10
claude-codechanged
keybindings
Actions available in the `MessageSelector` context:
| Action | Default | Description |
| :----------------------- | :---------------------------------------- | :---------------- |
| `messageSelector:up` | Up, K, Ctrl+P | Move up in list |
+22 −10 lines
Upstream edited 25 Sep 2026 23:41 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
claude-directory
±changed
+89−89
claude-codechanged
claude-directory
| File | Location | Purpose
| ----------------------- | ------------------------------------------ | -----------------------------------------------------------------------------------------------------------
| `managed-settings.json` | System-level, varies by OS | Enterprise-enforced settings that you can't override, apart from [narrow exceptions](/docs/en/settings#secu
| `CLAUDE.local.md` | Project root | Your private preferences for this project, loaded alongside CLAUDE.md. Create it manually and add it to `.g
| `AGENTS.md` | Project root, `.claude/`, or any directory | Project instructions you write for AI coding agents. Claude Code can [load it](/docs/en/memory#agents-md) o
+89 −89 lines
Upstream edited 25 Sep 2026 23:24 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
hooks
±changed
+1−1
claude-codechanged
hooks
| `scratchpad_dir` | Path to the session's scratchpad directory, where Claude keeps temporary working files. Absent when the session has no scratchpad or the temp directory is una
| `scratchpad_dir` | Path to the session's [scratchpad directory](/docs/en/claude-directory#session-scratchpad-directory), where Claude keeps temporary working files. Absent when
+1 −1 lines
Upstream edited 25 Sep 2026 23:24 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
claude-directory
±changed
+21−1
claude-codechanged
claude-directory
### Session scratchpad directory
The scratchpad is a per-session directory that Claude Code gives Claude for temporary files: intermediate results, helper scripts, and drafts that don't belong in your project. Whe
The scratchpad lives under Claude Code's temp directory rather than `~/.claude`. Find the current session's path for your platform:
+21 −1 lines
Upstream edited 25 Sep 2026 23:24 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
platforms
±changed
+23−23
claude-codechanged
platforms
| Platform | Best for | What you get
| :-------------------------------- | :------------------------------------------------------------------------------------------------- | :----------------------------------------
| [CLI](/docs/en/quickstart) | Terminal workflows, scripting, remote servers | Full feature set, [Agent SDK](/docs/
| [Desktop](/docs/en/desktop) | Visual review, parallel sessions, managed setup | Diff viewer, app preview, [computer
| [VS Code](/docs/en/vs-code) | Working inside VS Code without switching to a terminal | Inline diffs, integrated terminal, f
+23 −23 lines
Upstream edited 25 Sep 2026 23:19 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
remote-control
±changed
+22−5
claude-codechanged
remote-control
* **Feature-flag evaluation**: [`DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, and `DISABLE_GROWTHBOOK`](/docs/en/env-vars) each disable the featu
* **Feature-flag evaluation**: if you set an [environment variable that turns off feature-flag evaluation](/docs/en/env-vars#features-that-need-feature-flag-fetching), whether Remo
* If you set `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` or `DISABLE_GROWTHBOOK`, Remote Control is unavailable. Unset the variable wherever it's set, in your shell environment or
* If you set only `DISABLE_TELEMETRY` or `DO_NOT_TRACK`, Remote Control stays available unless your organization requires [Trusted Devices](#trusted-devices). If it does, unset t
You can start a Remote Control session from the CLI or the VS Code extension. The CLI offers three invocation modes; VS Code uses the `/remote-control` command.
+22 −5 lines
Upstream edited 25 Sep 2026 23:19 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
platforms
±changed
+1−1
claude-codechanged
platforms
| [Remote Control](/docs/en/remote-control) | Drive a running session from [claude.ai/code](https://claude.ai/code) or the Claude mobile app | Your machine (CLI
| [Remote Control](/docs/en/remote-control) | Drive a running session from [claude.ai/code](https://claude.ai/code) or the Claude mobile app | Your machine (CLI
+1 −1 lines
Upstream edited 25 Sep 2026 23:19 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
agent-sdk/typescript
±changed
+16−3
claude-codechanged
agent-sdk/typescript
Claude Code sets the list together with `user_message_uuid` on each reply frame that carries that field and on the result. For the full set of frames that carry `user_message_uuid`
Claude Code sets the list together with `user_message_uuid` on each reply frame that carries that field and on the result. For the full set of turn frames that echo the answered me
Claude Code also emits this message when an MCP server's [prompts](/docs/en/mcp#use-mcp-prompts-as-commands) join or leave the list, for example when a server finishes connecting a
};
+16 −3 lines
Upstream edited 25 Sep 2026 23:19 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
headless
±changed
+5−1
claude-codechanged
headless
When you [resume the session](#continue-conversations), Claude Code continues the turn that SIGTERM left unfinished.
When you [resume the session](#continue-conversations), Claude Code leaves the interrupted turn as it is, and your next prompt drives the conversation. To have Claude Code continue
### If the working directory is deleted
+5 −1 lines
Upstream edited 25 Sep 2026 23:09 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
server-managed-settings
±changed
+14−14
claude-codechanged
server-managed-settings
| Approach | Best for | Security model
| :------------------------------------------------------------------------ | :------------------------------------------------------- | :------------------------------------------
| **Server-managed settings** | Organizations without MDM, or users on unmanaged devices | Settings that Claude Code fetches from Anth
| **[Endpoint-managed settings](/docs/en/managed-settings#delivery-mechanisms)** | Organizations with MDM or endpoint management | Settings deployed to devices via MDM c
| Approach | Best for | Security model |
+14 −14 lines
Upstream edited 25 Sep 2026 23:09 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
server-managed-settings
±changed
+11−2
claude-codechanged
server-managed-settings
* The cache at `~/.claude/remote-settings.json` stores the salvaged payload with invalid entries removed, apart from invalid `cleanupPeriodDays` and `desktopSessionCleanupPeriodDay
* When no field in the payload can be salvaged and the payload isn't only those retention keys, Claude Code rejects the payload, keeps the last-accepted cached settings, and writes
* A startup that runs on the cache at `~/.claude/remote-settings.json` treats invalid entries the way the fetch that wrote the cache did:
* Entries that failed validation stay dropped.
* [Keys that fail closed](/docs/en/managed-settings#keys-that-fail-closed) keep their stricter values.
+11 −2 lines
Upstream edited 25 Sep 2026 23:09 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
errors
±changed
+6−1
claude-codechanged
errors
Your session is eligible for [server-managed settings](/docs/en/server-managed-settings), but Claude Code couldn't fetch them, so it shows this warning in interactive sessions. The
Your session is eligible for [server-managed settings](/docs/en/server-managed-settings), but Claude Code couldn't fetch them or couldn't apply what the server returned, so it show
The parenthesized cause names what failed, such as `network error`, `request timed out`, or `authentication rejected (401)`. The cause `no setting in the server response could be a
+6 −1 lines
Upstream edited 25 Sep 2026 23:09 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
settings-reference
±changed
+1−1
claude-codechanged
settings-reference
* **Default**: unset, so auto-connect follows your organization's admin default when one is set, and otherwise Claude Code's current default
* **Default**: unset, so the [auto-connect default](/docs/en/remote-control#enable-remote-control-for-all-sessions) applies
+1 −1 lines
Upstream edited 25 Sep 2026 23:07 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
managed-settings
±changed
+1−1
claude-codechanged
managed-settings
If you turn telemetry off, Claude Code stops sending the usage data that feeds your organization's [analytics dashboard](/docs/en/analytics) for the developers the policy reaches.
If you turn telemetry off, Claude Code stops sending the usage data that feeds your organization's [analytics dashboard](/docs/en/analytics) for the developers the policy reaches.
+1 −1 lines
Upstream edited 25 Sep 2026 23:07 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
env-vars
±changed
+4−4
claude-codechanged
env-vars
| `DISABLE_TELEMETRY` | Set to any non-empty value, such as `1`, to opt out of telemetry. **Setting it to `0` or `false` still opts out**, unlik
| `DISABLE_TELEMETRY` | Set to any non-empty value, such as `1`, to opt out of telemetry. **Setting it to `0` or `false` still opts out**, unlik
| `DO_NOT_TRACK` | Set to `1` to opt out of telemetry, with the same effect as `DISABLE_TELEMETRY`, including making [Remote Control](/docs
| `DO_NOT_TRACK` | Set to `1` to opt out of telemetry, with the same effect as `DISABLE_TELEMETRY`, including on [feature-flag fetching](#f
* Use [Remote Control](/docs/en/remote-control#requirements)
+4 −4 lines
Upstream edited 25 Sep 2026 23:07 UTC Recorded here 25 Sep 2026 23:37 UTC
claude-code
troubleshoot-install
±changed
+10−0
claude-codechanged
troubleshoot-install
| `Claude Code access has not been granted for this account` | [Get a role that includes Claude Code](#claude-code-access-has-not-be
### Claude Code access has not been granted for this account
If the sign-in page shows `Authorization failed` with the message `Claude Code access has not been granted for this account. Contact your administrator.` after you log in from Clau
+10 −0 lines
Upstream edited 25 Sep 2026 23:04 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
mcp
±changed
+8−0
claude-codechanged
mcp
### Images in tool results
When an MCP tool returns a PNG, JPEG, GIF, or WebP image, Claude sees the image inline in the conversation. The inline copy may be scaled down or compressed to fit the model's imag
If you disable session persistence with [`--no-session-persistence`](/docs/en/cli-reference#cli-flags) or [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/en/env-vars), Claude Code writes
+8 −0 lines
Upstream edited 25 Sep 2026 23:02 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
claude-directory
±changed
+1−1
claude-codechanged
claude-directory
| `projects/<project>/<session>/tool-results/` | Large tool outputs spilled to separate files
| `projects/<project>/<session>/tool-results/` | Large tool outputs spilled to separate files, an
+1 −1 lines
Upstream edited 25 Sep 2026 23:02 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
plugins/manifest-reference
±changed
+6−4
claude-codechanged
plugins/manifest-reference
Every component path must resolve inside the plugin root and must exist. `claude plugin validate` doesn't check the `outputStyles`, `lspServers`, `monitors`, or `themes` paths, so
* **Containment**: a path that resolves outside the plugin root doesn't load, and the `/plugin` **Errors** tab shows `<component> path escapes plugin directory: <path>`. A path con
* **Existence**: a path that doesn't exist doesn't load, and the `/plugin` **Errors** tab shows `<component> path not found: <path>`. `claude plugin validate` reports it as `Path n
Every component path must resolve inside the plugin root and must exist. `claude plugin validate` checks the paths under every component key:
+6 −4 lines
Upstream edited 25 Sep 2026 23:01 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
claude-apps-gateway-config
±changed
+2−0
claude-codechanged
claude-apps-gateway-config
No model request is sent to the provider, so a replica's CPU per request is an estimate and reads lower than production, which also encrypts its traffic to the provider. Confirm a
+2 −0 lines
Upstream edited 25 Sep 2026 23:01 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
plugin-evals
±changed
+91−91
claude-codechanged
plugin-evals
| Target | What runs
| :-------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------
| A plugin's root directory, such as `.` | Every case under its eval directory, with that plugin loaded
| A single `prompt.md` or `case.yaml` file | That case, with its enclosing plugin loaded
| Target | What runs |
+91 −91 lines
Upstream edited 25 Sep 2026 23:00 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
plugin-evals
±changed
+15−0
claude-codechanged
plugin-evals
* Git 2.31 or later, if git is installed. Run `git --version` to check. With an older git, `claude plugin eval` [stops before running any case](#git-is-too-old-for-claude-plugin-ev
<h3 id="git-is-too-old-for-claude-plugin-eval">
"is too old for claude plugin eval"
</h3>
+15 −0 lines
Upstream edited 25 Sep 2026 23:00 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
llm-gateway-protocol
±changed
+2−1
claude-codechanged
llm-gateway-protocol
The headers carry only what the rows below list: fixed vocabularies, tool names, and durations, never prompt text or file contents. Every value is printable ASCII.
The headers carry only what the rows below list: fixed vocabularies, tool names, durations, and a random prompt identifier, never prompt text or file contents. Every value is print
| `x-claude-code-prompt-id` | Random UUID that identifies the user prompt a request serves. Requests serving one prompt share the value, including the turns of subagents
+2 −1 lines
Upstream edited 25 Sep 2026 23:00 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
agent-sdk/observability
±changed
+10−10
claude-codechanged
agent-sdk/observability
| Signal | What it contains | Enable with |
| ---------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| Metrics | Counters for tokens, cost, sessions, lines of code, and tool decisions | `OTEL_METRICS_EXPORTER` |
| Log events | Structured records for each prompt, API request, API error, and tool result | `OTEL_LOGS_EXPORTER` |
| Traces | Spans for each interaction, model request, tool call, and hook (beta) | `OTEL_TRACES_EXPORTER` plus `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1` |
+10 −10 lines
Upstream edited 25 Sep 2026 22:58 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
monitoring-usage
±changed
+12−9
claude-codechanged
monitoring-usage
MCP tools, WebFetch, and WebSearch record this event too, on Claude Code v2.1.283 or later.
* A call to any tool other than Read, Edit, Write, and Bash, including MCP tools and WebFetch
* A call to any tool other than Read, Edit, Write, Bash, WebFetch, WebSearch, and MCP tools
* A WebFetch or WebSearch call that Claude Code moved to the background because you interrupted the turn to [send your queued messages right away](/docs/en/interactive-mode#when-cl
+12 −9 lines
Upstream edited 25 Sep 2026 22:58 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
agent-sdk/observability
±changed
+1−1
claude-codechanged
agent-sdk/observability
| `OTEL_LOG_TOOL_CONTENT=1` | A [`tool.output` span event](/docs/en/monitoring-usage#tool-output-span-event) on `claude_code.tool` with file contents and Bash output, truncated at
| `OTEL_LOG_TOOL_CONTENT=1` | A [`tool.output` span event](/docs/en/monitoring-usage#tool-output-span-event) on `claude_code.tool` with file contents, Bash output, and what MCP too
+1 −1 lines
Upstream edited 25 Sep 2026 22:58 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
self-hosted-environments-deploy
±changed
+13−13
claude-codechanged
self-hosted-environments-deploy
| Host | Port | Used for
| :----------------------------------------------------------------- | :----------------------------------------- | :---------------------------------------------------------------
| `api.anthropic.com` | 443, HTTPS; WSS for the SCM connector only | Runner control plane and session streaming, model inference, fea
| Your git host, such as `github.com` or your GitHub Enterprise host | 443 or 22 | Cloning and pushing repositories. Not needed if the runner uses
| Host | Port | Used for |
+13 −13 lines
Upstream edited 25 Sep 2026 22:49 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
self-hosted-environments-deploy
±changed
+7−3
claude-codechanged
self-hosted-environments-deploy
Swap `linux-x64` for `linux-arm64` if your nodes are ARM, or for `linux-x64-musl` or `linux-arm64-musl` on a musl-based image such as Alpine; see [Alpine Linux setup](/docs/en/setu
Swap `linux-x64` for `linux-arm64` if your nodes are ARM, or for `linux-x64-musl` or `linux-arm64-musl` on a musl-based image such as Alpine; see [Alpine Linux setup](/docs/en/setu
docker build --build-arg CLAUDE_CODE_VERSION=2.1.267 -t <your-registry>/claude-runner:latest .
```
docker build \
+7 −3 lines
Upstream edited 25 Sep 2026 22:49 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
desktop-quickstart
±changed
+8−7
claude-codechanged
desktop-quickstart
> Install Claude Code on desktop and start your first coding session
> Install the Claude desktop app, open the Code tab, and start your first Claude Code session on a project folder on your computer.
The desktop app gives you Claude Code with a graphical interface built for running multiple sessions side by side: a sidebar for managing parallel work, a drag-and-drop layout with
The desktop app gives you Claude Code with a graphical interface, so you can ask Claude to work on the code in a folder on your computer and review its changes without using a term
Claude Code requires a [Pro, Max, Team, or Enterprise subscription](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=desktop_quickstart_pricing).
+8 −7 lines
Upstream edited 25 Sep 2026 22:48 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
sandboxing
±changed
+40−40
claude-codechanged
sandboxing
| Prefix | Meaning | Example
| :---------------- | :------------------------------------------------------------------------------------- | :--------------------------------------------------------------------
| `/` | Absolute path from filesystem root | `/tmp/build` stays `/tmp/build`
| `~/` | Relative to home directory | `~/.kube` becomes `$HOME/.kube`
| Prefix | Meaning | Example |
+40 −40 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
desktop-scheduled-tasks
±changed
+16−16
claude-codechanged
desktop-scheduled-tasks
| | [Cloud](/docs/en/routines) | [Desktop](/docs/en/desktop-scheduled-tasks) | [`/loop`](/docs/en/scheduled-tasks)
| :------------------------- | :---------------------------------- | :------------------------------------- | :---------------------------------------------------------------------
| Runs on | Cloud, Anthropic-managed by default | Your machine | Your machine
| Requires machine on | No | Yes | Yes
| Requires open session | No | No | Yes
+16 −16 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
agent-sdk/tool-search
±changed
+7−7
claude-codechanged
agent-sdk/tool-search
| Value | Behavior
| :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------
| (unset) | Tool search is on. Tool definitions are deferred and discovered on demand. Falls back to loading upfront on Google Cloud's Agent Platform models earlier than the Claud
| `true` | Tool search is always on, except on a Microsoft Foundry deployment hosted on Azure, where the server-side rejection still forces upfront loading, and on Google Cloud's
| `auto` | Counts the tokens in the tool definitions that tool search can defer and compares the total against the model's context window. When the total reaches 10% of the windo
+7 −7 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
skills
±changed
+14−14
claude-codechanged
skills
Every skill needs a `SKILL.md` file with two parts: YAML frontmatter between `---` markers that tells Claude when to use the skill, and markdown content with the instructions C
Every skill needs a `SKILL.md` file with two parts: YAML frontmatter between `---` markers that tells Claude when to use the skill, and markdown content with the instructions C
When a nested skill shares a name with another skill, both stay available. With a `deploy` skill at the repository root and another in `apps/web/.claude/skills/`:
When a nested skill's directory name matches another skill's name, both stay available. With a `deploy` skill at the repository root and another in `apps/web/.claude/skills/`:
When two skills share a name, where each one came from decides which one `/name` runs. The table covers the enterprise, personal, project, nested, plugin, and claude.ai locations,
+14 −14 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
settings-reference
±changed
+3−3
claude-codechanged
settings-reference
Control which paths sandboxed commands can read and write. By default they can write to the working directory, the session temp directory, and directories you add with `--add-dir`,
Control which paths sandboxed commands can read and write. By default they can write to the working directory, the per-user temp directory, and directories you add with `--add-dir`
Add paths where sandboxed commands can write, beyond the working directory, the session temp directory, and the directories you've added with `--add-dir`, `/add-dir`, or `permissio
Add paths where sandboxed commands can write, beyond the working directory, the per-user temp directory, and the directories you've added with `--add-dir`, `/add-dir`, or `permissi
* **Default**: unset, so sandboxed commands can write to the working directory, the session temp directory, directories you've added with `--add-dir` or `/add-dir`, and directories
+3 −3 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
sandboxing
±changed
+6−6
claude-codechanged
sandboxing
Ask Claude to run a command, such as a build or a test suite. By default, commands inside the sandbox can write to the working directory, the session temp directory, and any [d
Ask Claude to run a command, such as a build or a test suite. By default, commands inside the sandbox can write to the working directory, a [per-user temp directory](/docs/en/e
The session temp directory is writable inside the sandbox by default, alongside the working directory. Unless you [disable filesystem isolation](#disable-filesystem-isolation), Cla
A per-user temp directory is writable inside the sandbox by default, alongside the working directory. Unless you [disable filesystem isolation](#disable-filesystem-isolation), Clau
By default, sandboxed commands can write to the current working directory, the session temp directory, and any [directories you've added](/docs/en/permissions#additional-directorie
+6 −6 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
routines
±changed
+2−2
claude-codechanged
routines
Pick a preset frequency for a recurring run, or schedule a single one-off run at a specific timestamp. See [Add a schedule trigger](#add-a-schedule-trigger) for timezone ha
Pick a preset frequency for a recurring run, or schedule a single one-off run at a specific timestamp. See [Add a schedule trigger](#add-a-schedule-trigger) for timezone ha
Runs may start a few minutes after the scheduled time due to stagger. The offset is consistent for each routine.
If you schedule a run exactly on the hour, such as 9:00, it can start several minutes late. To start close to the scheduled time, pick a few minutes past the hour, for example 9:07
+2 −2 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
permission-modes
±changed
+4−1
claude-codechanged
permission-modes
[`permissions.allow`](/docs/en/permissions#manage-permissions) rules in settings files do not pre-approve protected-path writes. The safety check runs before Claude Code evaluates
[`permissions.allow`](/docs/en/permissions#manage-permissions) rules in settings files do not pre-approve protected-path writes. The safety check runs before Claude Code evaluates
* For the project's `.claude/` folder: **Yes, and allow Claude to edit files in this project's .claude folder for this session**
* For `~/.claude/`: **Yes, and allow Claude to edit files in its \~/.claude folder for this session**
+4 −1 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
desktop-scheduled-tasks
±changed
+1−1
claude-codechanged
desktop-scheduled-tasks
* **Daily**: shows a time picker, defaults to 9:00 AM local time
* **Daily**: runs every day at the local time you pick
+1 −1 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
claude-apps-gateway
±changed
+1−1
claude-codechanged
claude-apps-gateway
| HTTPS | The gateway must be reachable over `https://` from developer laptops and from any browser used for sign-in; the gateway serves the devic
| HTTPS | The gateway must be reachable over `https://` from developer laptops and from any browser used for sign-in; the gateway serves the devic
+1 −1 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
agent-sdk/tool-search
±changed
+1−1
claude-codechanged
agent-sdk/tool-search
You can also add a system prompt section listing available tool categories. This gives the agent context about what kinds of tools are available to search for. Pass the text throug
You can also add a system prompt section listing available tool categories. This gives the agent context about what kinds of tools are available to search for. Pass the text in the
+1 −1 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
advisor
±changed
+1−0
claude-codechanged
advisor
* **Unavailable**: the advisor call failed, and the line reads `Advisor unavailable (<error_code>)`, where `<error_code>` is the code the call returned.
+1 −0 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
agent-sdk/typescript
±changed
+7−1
claude-codechanged
agent-sdk/typescript
| `verbatimPrompts` | `boolean`
client_composed?: true;
Set `shouldQuery` to `false` to append the message to the transcript without triggering an assistant turn. The message is held and merged into the next user message that does trigg
Set `shouldQuery` or `client_composed` to change how Claude Code handles a message you send:
+7 −1 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
agent-sdk/python
±changed
+52−50
claude-codechanged
agent-sdk/python
verbatim_prompts: bool = False
| Property | Type | Default | Description
| :---------------------------- | :------------------------------------------------------------------------------------ | :--------------------------------- | :--------------------
| `tools` | `list[str] \| ToolsPreset \| None` | `None` | Tools configuration.
| `allowed_tools` | `list[str]` | `[]` | Tools to auto-approve
+52 −50 lines
Upstream edited 25 Sep 2026 22:47 UTC Recorded here 25 Sep 2026 23:07 UTC
claude-code
claude-apps-gateway-config
±changed
+31−0
claude-codechanged
claude-apps-gateway-config
When you [add your own labels](#add-your-own-labels), the gateway also pushes `OTEL_RESOURCE_ATTRIBUTES`.
#### Add your own labels
+31 −0 lines
Upstream edited 25 Sep 2026 22:34 UTC Recorded here 25 Sep 2026 22:37 UTC
claude-code
permissions
±changed
+2−0
claude-codechanged
permissions
Before it starts or restarts a [background session](/docs/en/agent-view), Claude Code also checks workspace trust for the directory the session runs in. If you run `claude --bg` fr
+2 −0 lines
Upstream edited 25 Sep 2026 22:31 UTC Recorded here 25 Sep 2026 22:37 UTC
claude-code
errors
±changed
+23−1
claude-codechanged
errors
| `Workspace not trusted.` when starting or restarting a background session
You tried to start a [background session](/docs/en/agent-view) in a directory that doesn't exist anymore. This happens when you dispatch from agent view or run `/background` after
You tried to start a [background session](/docs/en/agent-view) in a directory that doesn't exist anymore. Claude Code doesn't start the session, and the message names the missing d
### Workspace not trusted when dispatching a background session
+23 −1 lines
Upstream edited 25 Sep 2026 22:31 UTC Recorded here 25 Sep 2026 22:37 UTC
claude-code
cli-reference
±changed
+2−2
claude-codechanged
cli-reference
| `--bg`, `--background` | Start the session as a [background agent](/docs/en/agent-view) and return immediately. Prints the session ID and management comm
| `--bg`, `--background` | Start the session as a [background agent](/docs/en/agent-view) and return immediately. Prints the session ID and management comm
| `--setting-sources` | Comma-separated list of setting sources to load (`user`, `project`, `local`)
| `--setting-sources` | Comma-separated list of setting sources to load (`user`, `project`, `local`). See [agent view](/docs/en/agent-view#what-carries-
+2 −2 lines
Upstream edited 25 Sep 2026 22:31 UTC Recorded here 25 Sep 2026 22:37 UTC
claude-code
agent-view
±changed
+21−5
claude-codechanged
agent-view
* `--setting-sources`
If you run `claude --bg` from a terminal in a directory you haven't [trusted](/docs/en/permissions#project-allow-rules-and-workspace-trust), the workspace trust dialog appears firs
* Delete the session again to remove the directory anyway, by pressing `Ctrl+X` twice on its row in agent view or running the `claude rm <id> --force-remove-worktree <worktree-id
* Fix what stands in the way, such as committing or stashing the uncommitted changes, closing whatever is using the directory, or fixing the hook, then delete the session again.
+21 −5 lines
Upstream edited 25 Sep 2026 22:31 UTC Recorded here 25 Sep 2026 22:37 UTC
claude-code
agent-teams
±changed
+12−12
claude-codechanged
agent-teams
| | Subagents | Agent te
| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- | :-------
| **Context** | Own context window; results return to the caller | Own cont
| **Communication** | Return a result to the caller. Subagents that Claude named when it spawned them can also [message each other](/docs/en/sub-agents#what-loads-at-startup) | Tea
| **Coordination** | Main agent manages all work | Self-coo
+12 −12 lines
Upstream edited 25 Sep 2026 22:12 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
agent-teams
±changed
+3−1
claude-codechanged
agent-teams
Each teammate has its own context window. When spawned, a teammate loads the same project context as a regular session: CLAUDE.md, MCP servers, and skills. It also receives the spa
Each teammate has its own context window. When spawned, a teammate loads the same project context as a regular session: CLAUDE.md, MCP servers, and skills. If you start the lead wi
A teammate also receives the spawn prompt from the lead. The lead's conversation history does not carry over.
+3 −1 lines
Upstream edited 25 Sep 2026 22:12 UTC Recorded here 25 Sep 2026 22:37 UTC
claude-code
monitoring-usage
±changed
+13−12
claude-codechanged
monitoring-usage
| `request_id` | Anthropic API request ID from the `request-id` response header
| `request_id` | API request ID. Same value as the `request_id` [event correlation attribute](#event-correlation-attributes)
| Attribute | Description
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------
| `prompt.id` | UUID v4 identifier linking all events produced while processing a single user prompt
+13 −12 lines
Upstream edited 25 Sep 2026 22:10 UTC Recorded here 25 Sep 2026 22:37 UTC
claude-code
remote-control
±changed
+1−0
claude-codechanged
remote-control
* `/focus`, from v2.1.281: pass `on` or `off` as an argument, for example `/focus on`, or run it with no argument to toggle the [focus view](/docs/en/commands#all-commands). Both
+1 −0 lines
Upstream edited 25 Sep 2026 22:10 UTC Recorded here 25 Sep 2026 22:37 UTC
claude-code
changelog
±changed
+97−0
claude-codechanged
changelog
<Update label="2.1.283" description="September 25, 2026">
* Added `x-claude-code-prompt-id` to the gateway hint headers so LLM gateways can group the requests that serve one user prompt; opt in with `CLAUDE_CODE_GATEWAY_HINT_HEADERS=1`
* Added `availableModelsMatch` managed setting: with `"exact"`, an `availableModels` entry allows only the model version it names, so new releases stay blocked until listed
* Added `deniedModels` managed setting to block specific models, even when `availableModels` allows them
+97 −0 lines
Upstream edited 25 Sep 2026 22:00 UTC Recorded here 25 Sep 2026 22:07 UTC
claude-code
fullscreen
±changed
+32−32
claude-codechanged
fullscreen
| Your situation
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| You set [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1`](/docs/en/env-vars) or `CLAUDE_CODE_NO_FLICKER=0`
| You set `CLAUDE_CODE_NO_FLICKER=1`
| Claude Code [turned fullscreen off after a failed fullscreen start](#fullscreen-renderer-didnt-finish-starting) on this machine
+32 −32 lines
Upstream edited 25 Sep 2026 21:48 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
settings-reference
±changed
+6−4
claude-codechanged
settings-reference
| Field | Type | What it does
| :---------------------- | :------------------------------------------------------------------------------------ | :---------------------------------------------------------------
| `options` | array of rows, each with a required `model` and an optional `label` and `description` | The rows the picker shows, in this order, except that a grayed-o
| `replaceBuiltInOptions` | Boolean, default `false` | Set it to `true` to show only these rows, **Default**, and a row
| Field | Type | What it does
+6 −4 lines
Upstream edited 25 Sep 2026 21:48 UTC Recorded here 25 Sep 2026 22:07 UTC
claude-code
keybindings
±changed
+16−10
claude-codechanged
keybindings
In most dialogs, pressing `Ctrl+C` or `Ctrl+D` twice closes the dialog instead of exiting Claude Code. The hint after the first press says whether the second press closes the dialo
In a tabbed dialog, `tabs:next` and `tabs:previous` switch tabs while the tab row has focus. In some dialogs, such as `/help` and `/sandbox`, the tab-switching keys also work from
`Up` and `Down` move focus between the tab row and the tab's content, and a list in the content responds to keys only while it has focus.
+16 −10 lines
Upstream edited 25 Sep 2026 21:48 UTC Recorded here 25 Sep 2026 22:07 UTC
claude-code
interactive-mode
±changed
+28−24
claude-codechanged
interactive-mode
| Shortcut | Description
| :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------
| `Ctrl+C` | Interrupt, or clear input
| `Ctrl+X Ctrl+K` | Stop all running [background subagents](/docs/en/sub-agents#run-subagents-in-foregr
| `Ctrl+D` | Exit Claude Code session
+28 −24 lines
Upstream edited 25 Sep 2026 21:48 UTC Recorded here 25 Sep 2026 22:07 UTC
claude-code
fullscreen
±changed
+3−1
claude-codechanged
fullscreen
* **Scroll an overflowing list with its scrollbar.** In list panels such as `/skills`, `/mcp`, and `/plugin`'s Installed list, a scrollbar appears beside a list with more rows than
* Clicking also expands a dim `Message from @<sender>` line when the sender is a [teammate](/docs/en/agent-teams) or another agent running in your session. The line for a message
With mouse capture disabled, keyboard scrolling with `PgUp`, `PgDn`, `Ctrl+Home`, and `Ctrl+End` still works, and your terminal handles selection natively. You lose click-to-positi
With mouse capture disabled, keyboard scrolling with `PgUp`, `PgDn`, `Ctrl+Home`, and `Ctrl+End` still works, and your terminal handles selection natively. You lose click-to-positi
+3 −1 lines
Upstream edited 25 Sep 2026 21:48 UTC Recorded here 25 Sep 2026 22:07 UTC
claude-code
troubleshooting
±changed
+13−13
claude-codechanged
troubleshooting
| Symptom | Go to
| :--------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------
| `command not found`, install fails, PATH issues, `EACCES`, TLS errors | [Troubleshoot installation
| Update or install download fails with `The connection dropped while downloading the update` or `aborted` | [Error reference](/docs/en/
| Symptom | Go to |
+13 −13 lines
Upstream edited 25 Sep 2026 21:48 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
troubleshooting
±changed
+1−0
claude-codechanged
troubleshooting
| A command Claude runs fails with `Your disk quota is full`, `is full (ENOSPC)`, or `Command output was lost` | [Error reference](/docs/en/
+1 −0 lines
Upstream edited 25 Sep 2026 21:48 UTC Recorded here 25 Sep 2026 22:07 UTC
claude-code
errors
±changed
+25−0
claude-codechanged
errors
| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)`
| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)`
| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes`
<h3 id="disk-quota-or-temp-filesystem-is-full">
Disk quota or temp filesystem is full
+25 −0 lines
Upstream edited 25 Sep 2026 21:48 UTC Recorded here 25 Sep 2026 22:07 UTC
claude-code
prompt-library
±changed
+3−2
claude-codechanged
prompt-library
const SAFE_HREF = /^(\/(?![\/\\\s])|#|https?:\/\/)/;
out.push(<a key={m.index} href={doc(m[2])}>{m[1]}</a>);
out.push(SAFE_HREF.test(m[2]) ? <a key={m.index} href={doc(m[2])}>{m[1]}</a> : m[1]);
{p.nextHref && p.next && <div className="pl-next">
{p.nextHref && p.next && SAFE_HREF.test(p.nextHref) && <div className="pl-next">
+3 −2 lines
Upstream edited 25 Sep 2026 21:47 UTC Recorded here 25 Sep 2026 22:07 UTC
claude-code
remote-control
±changed
+19−3
claude-codechanged
remote-control
Claude Code could not reach the feature-flag service to check whether Remote Control is enabled for your account, typically because you are offline or a proxy is blocking the reque
Claude Code could not reach the feature-flag service to check whether Remote Control is enabled for your account, typically because you are offline or a proxy is blocking the reque
A policy blocks Remote Control, or Claude Code couldn't load your organization's policy on this machine and keeps Remote Control off in the meantime. Check these causes in order:
A policy blocks Remote Control. Check these causes in order:
* **The organization policy didn't load on this machine**: run `claude doctor` and read the `Organization policy` line. If the line shows the policy isn't loaded, that is what's ke
+19 −3 lines
Upstream edited 25 Sep 2026 21:36 UTC Recorded here 25 Sep 2026 21:37 UTC
claude-code
errors
±changed
+1−0
claude-codechanged
errors
| `Couldn't verify your organization's policy for remote control`
+1 −0 lines
Upstream edited 25 Sep 2026 21:36 UTC Recorded here 25 Sep 2026 21:37 UTC
claude-code
agent-sdk/typescript
±changed
+83−2
claude-codechanged
agent-sdk/typescript
### Import the `/core` entry when you bundle the Agent SDK
If your application bundles the Agent SDK together with its own dependencies, import from `@anthropic-ai/claude-agent-sdk/core` instead of the package root. The `/core` entry requi
+83 −2 lines
Upstream edited 25 Sep 2026 21:30 UTC Recorded here 25 Sep 2026 21:37 UTC
claude-code
agent-sdk/hosting
±changed
+6−1
claude-codechanged
agent-sdk/hosting
The container exposes an HTTP or WebSocket endpoint and maps each active session to a long-lived query and the subprocess behind it. In TypeScript, use [`streamInput()`](/docs/en/a
The container exposes an HTTP or WebSocket endpoint and maps each active session to a long-lived query and the subprocess behind it. The calls that keep sessions open and warm diff
* **TypeScript**: use [`streamInput()`](/docs/en/agent-sdk/typescript#query-object) to add turns to an active session. Call [`startup()`](/docs/en/agent-sdk/typescript#startup) to
* **Python**: use [`ClaudeSDKClient`](/docs/en/agent-sdk/python#claudesdkclient) to hold a session open across turns.
+6 −1 lines
Upstream edited 25 Sep 2026 21:30 UTC Recorded here 25 Sep 2026 21:37 UTC
claude-code
authentication
±changed
+19−3
claude-codechanged
authentication
```bash theme={null}
export CLAUDE_CODE_OAUTH_TOKEN=your-token
```
<Tabs>
<Tab title="macOS, Linux, WSL">
+19 −3 lines
Upstream edited 25 Sep 2026 21:21 UTC Recorded here 25 Sep 2026 21:37 UTC
claude-code
troubleshoot-install
±changed
+8−1
claude-codechanged
troubleshoot-install
For Bash, the default on most Linux distributions:
For Bash on Linux, where it's the default on most distributions:
```
For Bash on macOS, add the line to `~/.bash_profile` instead. Terminal on macOS starts Bash as a login shell, which ignores `~/.bashrc` and reads only the first of `~/.bash_pro
+8 −1 lines
Upstream edited 25 Sep 2026 21:20 UTC Recorded here 25 Sep 2026 21:37 UTC
claude-code
plugins/install
±changed
+10−10
claude-codechanged
plugins/install
| Source | What you type
| :------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------
| GitHub repository | `owner/repo`. Add `#ref` to pin a branch or tag.
| Git repository on any host | The full clone URL. Add `#ref` to pin a branch or tag.
| Local directory or file | A relative or absolute path to a directory that holds `.claude-plugin/marketplace.json`, or to the JSON file itself. Start a relative path with `./`
+10 −10 lines
Upstream edited 25 Sep 2026 21:04 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
plugins/install
±changed
+1−1
claude-codechanged
plugins/install
* **Project scope**: the plugin is enabled for everyone who works in this repository. The entry goes in `.claude/settings.json`, which you commit.
* **Project scope**: the plugin is enabled for everyone who works in this repository. The entry goes in `.claude/settings.json`, which you commit. Committing that entry turns the p
+1 −1 lines
Upstream edited 25 Sep 2026 21:04 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
plugin-evals
±changed
+2−2
claude-codechanged
plugin-evals
This page is for plugin and skill authors who have a working plugin and want to test its behavior, and for teams that gate plugin changes in CI. Its case format is separate from th
This page is for plugin and skill authors who have a working plugin and want to test its behavior, and for teams that gate plugin changes in CI. For iterating on one skill inside a
Problems writing or publishing the HTML report never change the exit code.
The with-minus-without delta is reported but never changes the exit code, and neither do problems writing or publishing the HTML report.
+2 −2 lines
Upstream edited 25 Sep 2026 21:04 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
terminal-config
±changed
+51−51
claude-codechanged
terminal-config
| Terminal | Shift+Enter for newline |
| :------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
| Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal | Works without setup |
| Terminal | Shift+Enter for newline |
| :- | :- |
+51 −51 lines
Upstream edited 25 Sep 2026 20:51 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
terminal-config
±changed
+4−0
claude-codechanged
terminal-config
## Cap response width in wide terminals
In a wide terminal, each line of prose in Claude's responses runs the full width of the window. To wrap the prose at a set number of columns instead, set [`maxProseWidth`](/docs/en
+4 −0 lines
Upstream edited 25 Sep 2026 20:51 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
skills
±changed
+23−10
claude-codechanged
skills
* **Reserved name**: don't name a skill folder `synced`, in any capitalization. Claude Code uses `~/.claude/skills/synced/` for [skills downloaded from claude.ai](#where-synced-ski
* **Reserved name `synced`**: don't name a skill folder `synced`, in any capitalization. Claude Code uses `~/.claude/skills/synced/` for [skills downloaded from claude.ai](#where-s
* **Reserved name `anthropic-skills`**: outside a plugin, a skill folder or command file whose name is `anthropic-skills` or starts with `anthropic-skills:` doesn't load. See [Name
| Same name in | Which one runs
| :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------
+23 −10 lines
Upstream edited 25 Sep 2026 20:51 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
settings-reference
±changed
+15−0
claude-codechanged
settings-reference
| [`maxProseWidth`](#maxprosewidth) | Cap how wide the prose in Claude's responses runs in a wide terminal
### `maxProseWidth`
Cap the width of the prose in Claude's responses so lines stay readable in a wide terminal. Paragraphs, headings, lists, and blockquotes wrap within this many columns, while tables
+15 −0 lines
Upstream edited 25 Sep 2026 20:51 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
remote-control
±changed
+1−0
claude-codechanged
remote-control
| `-d`, `--debug[=<filter>]` | Turn on debug logging for the server, optionally filtered by category. Pass a filter only in the `=` form, such as `--debug=
+1 −0 lines
Upstream edited 25 Sep 2026 20:51 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
mcp
±changed
+2−0
claude-codechanged
mcp
Prompts from a server named `anthropic-skills` don't appear, because Claude Code [reserves that name](/docs/en/skills#names-reserved-for-synced-skills) for skills synced from claud
+2 −0 lines
Upstream edited 25 Sep 2026 20:51 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
errors
±changed
+21−0
claude-codechanged
errors
| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account`
<h3 id="a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved">
A skill, command, or workflow wasn't loaded because its name is reserved
</h3>
+21 −0 lines
Upstream edited 25 Sep 2026 20:51 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
permission-modes
±changed
+1−1
claude-codechanged
permission-modes
To skip asking the server and always use Claude Code's own classifier requests, set [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/en/env-vars). On a direct connection to the Anthropic A
To skip asking the server and always use Claude Code's own classifier requests, set [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/en/env-vars). On a direct connection to the Anthropic A
+1 −1 lines
Upstream edited 25 Sep 2026 20:51 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
llm-gateway-protocol
±changed
+3−1
claude-codechanged
llm-gateway-protocol
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` stops Claude Code from sending pre-release capabilities and their body fields on every provider, including context management and the bet
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` stops Claude Code from sending pre-release capabilities and their body fields, including context management and the beta tool fields. The
When a host platform that embeds Claude Code sets [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/en/env-vars), `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` doesn't stop auto mode sessi
+3 −1 lines
Upstream edited 25 Sep 2026 20:51 UTC Recorded here 25 Sep 2026 21:07 UTC
claude-code
claude-apps-gateway-deploy
±changed
+1−1
claude-codechanged
claude-apps-gateway-deploy
If your IdP goes down, existing sessions work until `ttl_hours`, new logins fail, and a session refresh gets a try-again answer and goes through once the IdP is back. Set a longer
If your IdP goes down, existing sessions work until `ttl_hours` and new logins fail. A session refresh gets a try-again answer and succeeds once the IdP is back. Set a longer `ttl_
+1 −1 lines
Upstream edited 25 Sep 2026 19:37 UTC Recorded here 25 Sep 2026 20:07 UTC
claude-code
claude-apps-gateway-config
±changed
+7−5
claude-codechanged
claude-apps-gateway-config
* [`load_test_mode`](#load_test_mode): load test the gateway without calling a model provider
* [`load_test_mode`](#load_test_mode): load testing the gateway without calling a model provider
Requires v2.1.283 or later. Earlier versions refuse to start when the key is set, so upgrade every replica before you add the block and remove it before you roll back.
The example below turns the mode on with the defaults, a reply of 750 output tokens streamed over about 10 seconds:
+7 −5 lines
Upstream edited 25 Sep 2026 19:37 UTC Recorded here 25 Sep 2026 20:07 UTC
claude-code
plugins/measure
±changed
+17−17
claude-codechanged
plugins/measure
> * **Testing how reliably the plugin changes Claude's behavior**: see [Test plugins with evals](/docs/en/plugin-evals)
> * **Trimming your own session's context**: see [Manage installed plugins](/docs/en/plugins/install#manage-installed-plugins) and the [context window](/docs/en/context-window) pag
> * **Testing how reliably the plugin changes Claude's behavior**: see [Test plugins with evals](/docs/en/plugin-evals.md)
> * **Trimming your own session's context**: see [Manage installed plugins](/docs/en/plugins/install.md#manage-installed-plugins) and the [context window](/docs/en/context-window.m
If you maintain the plugin, these changes reduce what it adds to every session. If you only use it, your options are to disable or uninstall it; see [Manage installed plugins](/doc
+17 −17 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
plugins/cli-hints
±changed
+7−7
claude-codechanged
plugins/cli-hints
This page applies only if your plugin is listed in `claude-plugins-official` or another marketplace with one of Anthropic's [official marketplace names](/docs/en/plugins/security#o
This page applies only if your plugin is listed in `claude-plugins-official` or another marketplace with one of Anthropic's [official marketplace names](/docs/en/plugins/security.m
> To publish a plugin, see [Publish and distribute a plugin](/docs/en/plugins/publish).
> To publish a plugin, see [Publish and distribute a plugin](/docs/en/plugins/publish.md).
The [environment variables reference](/docs/en/env-vars) has the details.
+7 −7 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 22 Oct 2026 18:07 UTC
claude-code
plugins/measure
±changed
+7−9
claude-codechanged
plugins/measure
<Note>
These cases are covered on other pages:
* **Testing how reliably the plugin changes Claude's behavior**: see [Test plugins with evals](/docs/en/plugin-evals)
* **Trimming your own session's context**: see [Manage installed plugins](/docs/en/plugins/install#manage-installed-plugins) and the [context window](/docs/en/context-window) pag
+7 −9 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
plugins/cli-hints
±changed
+30−32
claude-codechanged
plugins/cli-hints
<Note>
To publish a plugin, see [Publish and distribute a plugin](/docs/en/plugins/publish).
</Note>
> [!NOTE]
>
+30 −32 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 20 Oct 2026 18:37 UTC
claude-code
plugins/publish
±changed
+5−5
claude-codechanged
plugins/publish
| Route | Who can install
| :------------------------------------------------------------ | :-----------------------------------------------------------------------------------------------------------------
| [No marketplace](#share-a-plugin-without-a-marketplace) | The people you send the plugin folder or a `.zip` of it
| [Your own marketplace](#publish-through-your-own-marketplace) | Anyone who can reach the repository, which can be a private one your team can clone
| [Anthropic's directory](#submit-to-anthropics-directory) | People who add it on claude.ai or in Cowork. It also loads in their Claude Code sessions through [account sync](/d
+5 −5 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
plugins/org
±changed
+19−19
claude-codechanged
plugins/org
| Surface | Managed `extraKnownMarketplaces` and `enabledPlugins`
| :-------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------
| Terminal, interactive | Applied at session start on every machine that receives the settings
| `-p` and CI | Applied at session start, with installs running in the background
| Cloud sessions | In an Anthropic-hosted environment, only server-managed settings reach the session, which waits for them before it installs plugins. MDM policies and mana
+19 −19 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
plugins/measure
±changed
+12−12
claude-codechanged
plugins/measure
| Question | OpenTelemetry event or attribute
| :------------------------------------------------ | :-----------------------------------------------------------------------------------------------------------------------------
| Which plugins get installed, and from where | [`claude_code.plugin_installed`](/docs/en/monitoring-usage#plugin-installed-event), one per install
| Which plugins are active in how many sessions | [`claude_code.plugin_loaded`](/docs/en/monitoring-usage#plugin-loaded-event), one per enabled plugin at session start
| Which skills activate, and which plugin owns them | [`claude_code.skill_activated`](/docs/en/monitoring-usage#skill-activated-event), with `plugin.name` and `marketplace.name` fo
+12 −12 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
plugins/host-marketplace
±changed
+19−19
claude-codechanged
plugins/host-marketplace
| Host | Users run, in a Claude Code session | What users need
| :--------------------------------------------------------------- | :--------------------------------------------------------------------- | :-------------------------------------
| GitHub | `/plugin marketplace add your-org/your-marketplace` | `git`, and for a private repository th
| GitLab, Bitbucket, GitHub Enterprise Server, or another git host | `/plugin marketplace add https://gitlab.example.com/team/plugins.git` | `git`, and access to the host from the
| A hosted `marketplace.json` URL | `/plugin marketplace add https://plugins.example.com/marketplace.json` | HTTPS access to the URL. Users don't n
+19 −19 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
plugins/create-marketplace
±changed
+5−5
claude-codechanged
plugins/create-marketplace
| Source | Use it when | Minimal `source` value
| :------------ | :------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------
| Relative path | The plugin's files are inside the marketplace directory itself | `"./plugins/my-first-plugin"`
| `github` | The plugin is a GitHub repository of its own | `{ "source": "github", "repo": "your-org/my-first-plugin" }`
| `git-subdir` | The plugin is a subdirectory of some other repository, such as a monorepo | `{ "source": "git-subdir", "url": "your-org/monorepo", "path": "tools/my-first-plugin"
+5 −5 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
plugins/components
±changed
+4−4
claude-codechanged
plugins/components
| Component | Save as | Format | Appears i
| :----------- | :------------------------ | :-------------------------------------------------------------------------------------------------------------------------- | :--------
| Theme | `themes/<slug>.json` | The [custom theme file](/docs/en/terminal-config#create-a-custom-theme) format users write in `~/.claude/themes/` | `/th
| Output style | `output-styles/<name>.md` | The [custom output style](/docs/en/output-styles#create-a-custom-output-style) format, with `name` and `description` frontmatter | `/ou
| Component | Save as | Format | Appears in | Manifest key |
+4 −4 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
plugins/cli-hints
±changed
+5−5
claude-codechanged
plugins/cli-hints
| Attribute | Description |
| :-------- | :------------------------------------------------ |
| `v` | Protocol version. `1` is the only supported value |
| `type` | Hint kind. `plugin` is the only supported value |
| `value` | Plugin identifier in `name@marketplace` form |
+5 −5 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
plugins/anthropic-marketplaces
±changed
+6−6
claude-codechanged
plugins/anthropic-marketplaces
| | Official
| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------
| Repository | [`anthropics/claude-plugins-official`](https://github.com/anthropics/claude-plugins-official)
| Marketplace name | `claude-plugins-official`
| What's in it | Plugins Anthropic maintains, plus plugins from partners and other authors
+6 −6 lines
Upstream edited 25 Sep 2026 18:09 UTC Recorded here 28 Sep 2026 23:37 UTC
Nothing on this page matches that. Press Enter to search every page of the ledger.