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
820pages tracked
773 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 23 Oct 2026
100 on this page
5,591 of the ledger's changes in claude-code. Show every change
ReadSourcePageWhatLines
26 Sep 2026
53 pages
+1717 −1262 lines
claude-code
remote-control
±changed
+1−1
claude-codechanged
remote-control
Use Remote Control when you're in the middle of local work and want to keep going from another device. Use a cloud session when you want to start a task without any local setup, wo
Use Remote Control when you're in the middle of local work and want to keep going from another device. Use a cloud session when you want to start a task without any local setup, wo
+1 −1 lines
Upstream edited 26 Sep 2026 03:05 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
permission-modes
±changed
+61−39
claude-codechanged
permission-modes
On Pro, Max, and Team plans, the built-in starting permission mode is auto mode. [Which mode a session starts in](#which-mode-a-session-starts-in) covers the surfaces and settings
With Claude Code v2.1.283 or later, auto mode is the built-in starting permission mode for interactive terminal and VS Code sessions. On earlier versions, it's the built-in startin
| Work hands-off in auto mode | `claude --permission-mode auto`, the [built-in starting permission mode](#which-mode-a-session-starts-in) on Pro, Max,
| Work hands-off in auto mode | `claude --permission-mode auto`, the [built-in starting permission mode](#which-mode-a-session-starts-in) with v2.1.283
The built-in default depends on how you run Claude Code, on your plan, and on whether Claude Code could fetch its feature flags. The first row that matches your session applies. Th
+61 −39 lines
Upstream edited 26 Sep 2026 03:05 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
mobile
±changed
+6−6
claude-codechanged
mobile
| Feature | What you connect to | When to use
| :--------------------------------------------- | :------------------------------------------------------------------------- | :---------------------------------------------------
| [Cloud sessions](/docs/en/claude-code-on-the-web) | A session on cloud infrastructure, Anthropic-managed by default | Your repository is on GitHub and the task shoul
| [Projects](/docs/en/claude-projects) | A conversation where Claude coordinates parallel cloud sessions as threads | You have a stream of related work rather than o
| [Remote Control](/docs/en/remote-control) | A Claude Code session running on your computer | The work needs your local filesystem, tools, or
+6 −6 lines
Upstream edited 26 Sep 2026 03:05 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
claude-projects
±changed
+44−6
claude-codechanged
claude-projects
Each thread is usually a [cloud session](/docs/en/claude-code-on-the-web): Claude Code running in the cloud rather than on your machine. When a task needs something only your compu
Each thread is usually a [cloud session](/docs/en/claude-code-on-the-web): Claude Code running in the cloud rather than on your machine. When a task needs something only your compu
* **A build or migration bigger than a session**: "Build what `docs/spec.md` describes" or "Move the app off the deprecated ORM." The work splits into threads that each take a part
* **A build or migration bigger than a session**: "Build what `docs/spec.md` describes" or "Move the app off the deprecated ORM." The work splits into threads that each take a part
Cloud threads work on GitHub repositories and on the files, folders, and Google Drive folders you upload to the project, not on files or tools that exist only on your machine. If a
+44 −6 lines
Upstream edited 26 Sep 2026 03:05 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
agents
±changed
+7−7
claude-codechanged
agents
| Approach | What it gives you
| :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------
| [Subagents](/docs/en/sub-agents) | Delegated workers inside one session that do a side task in their own context and return a summary
| [Agent view](/docs/en/agent-view) | One screen to dispatch and monitor sessions running in the background, opened with `claude agents`. Research preview
| [Agent teams](/docs/en/agent-teams) | Multiple coordinated sessions with a shared task list and inter-agent messaging, managed by a lead. Experimental and disabled by default
+7 −7 lines
Upstream edited 26 Sep 2026 03:05 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
tools-reference
±changed
+66−66
claude-codechanged
tools-reference
| Tool | Description
| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------
| `Agent` | Spawns a [subagent](/docs/en/sub-agents) with its own context window to handle a task. With [agent teams](/docs/en/agent-teams) enabled, a call that carr
| `Artifact` | Publishes an HTML or Markdown file as an [artifact](/docs/en/artifacts): a private, interactive page on claude.ai. You can share it with a public link, o
| `AskUserQuestion` | Asks multiple-choice questions to gather requirements or clarify ambiguity. Questions stay open until you answer them by default. See [AskUserQuestion to
+66 −66 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
quickstart
±changed
+12−12
claude-codechanged
quickstart
| Command | What it does | Example |
| ------------------- | ------------------------------------------------------ | ----------------------------------- |
| `claude` | Start interactive mode | `claude` |
| `claude "task"` | Start interactive mode with an initial prompt | `claude "fix the build error"` |
| `claude -p "query"` | Run one-off query, then exit | `claude -p "explain this function"` |
+12 −12 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
best-practices
±changed
+25−25
claude-codechanged
best-practices
| Strategy | Before | After
| ------------------------------------- | ------------------------------------------------------- | --------------------------------------------------------------------------------
| **Provide verification criteria** | *"implement a function that validates email addresses"* | *"write a validateEmail function. example test cases: [[email protected]](mailto:
| **Verify UI changes visually** | *"make the dashboard look better"* | *"\[paste screenshot] implement this design. take a screenshot of the result and
| **Address root causes, not symptoms** | *"the build is failing"* | *"the build fails with this error: \[paste error]. fix it and verify the build s
+25 −25 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
vs-code
±changed
+2−2
claude-codechanged
vs-code
* **Permission modes**: click the mode indicator at the bottom of the prompt box to switch permission modes. On Pro, Max, and Team plans, Auto is the built-in starting permission m
* **Permission modes**: click the mode indicator at the bottom of the prompt box to switch permission modes. With Claude Code v2.1.283 or later, Auto is the built-in starting permi
* **Claude Code settings** in `~/.claude/settings.json`: shared between the extension and CLI. Use it for allowed commands, environment variables, hooks, and MCP servers. On Pro, M
* **Claude Code settings** in `~/.claude/settings.json`: shared between the extension and CLI. Use it for allowed commands, environment variables, hooks, and MCP servers. With Clau
+2 −2 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
tools-reference
±changed
+1−1
claude-codechanged
tools-reference
On Pro, Max, and Team plans, Claude Code starts sessions in [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode), where a classifier decides most of these prom
In [auto mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode), a classifier decides most permission prompts instead of you. The `Permission required` column shows wh
+1 −1 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
sub-agents
±changed
+1−1
claude-codechanged
sub-agents
Set `permissionMode` to choose the permission mode a subagent runs in. Use the modes' config values, so Manual mode is `default`. If you leave it unset, the subagent inherits the m
Set `permissionMode` to choose the permission mode a subagent runs in. Use the modes' config values, so Manual mode is `default`. If you leave it unset, the subagent inherits the m
+1 −1 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
settings-reference
±changed
+4−3
claude-codechanged
settings-reference
Choose whether Claude Code uses the auto mode classifier to review shell commands in plan mode. With the default `true`, the classifier reviews each command during planning when au
Choose whether Claude Code uses the auto mode classifier to review shell commands in plan mode. With the default `true`, the classifier reviews each command during planning when au
* `true`: the same as unset; when auto mode is available, the classifier reviews each shell command during planning instead of prompting you for it. A `false` in any of these fil
* `true`: the same as unset; when auto mode is available, the classifier reviews each shell command during planning instead of prompting you for it, except [critical-path removal
Set the [permission mode](/docs/en/permission-modes) new sessions start in. When you leave it unset, sessions start in the [built-in default](/docs/en/permission-modes#which-mode-a
+4 −3 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
quickstart
±changed
+6−6
claude-codechanged
quickstart
```bash theme={null}
```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
```powershell theme={null}
```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme=
```batch theme={null}
+6 −6 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
how-claude-code-works
±changed
+1−1
claude-codechanged
how-claude-code-works
* **Auto**: a classifier reviews most actions in the background and blocks the risky ones instead of asking you. On Pro, Max, and Team plans, it's the [built-in starting permission
* **Auto**: a classifier reviews most actions in the background and blocks the risky ones instead of asking you. With Claude Code v2.1.283 or later, it's the [built-in starting per
+1 −1 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
glossary
±changed
+1−1
claude-codechanged
glossary
A [permission mode](#permission-mode) where a separate classifier model reviews actions instead of you, so Claude Code runs most of them without asking you. Claude Code still asks
A [permission mode](#permission-mode) where a separate classifier model reviews actions instead of you, so Claude Code runs most of them without asking you. Claude Code still asks
+1 −1 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
feature-availability
±changed
+1−1
claude-codechanged
feature-availability
<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> On these providers, auto mode supports only Claude Sonnet 5, Opus 4.7 or later, and th
<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> On these providers, auto mode supports only Claude Sonnet 5, Opus 4.7 or later, and th
+1 −1 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
env-vars
±changed
+3−3
claude-codechanged
env-vars
| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Set to `1` to turn off the time limit on [critical-path removal](/docs/en/permission-modes#critical-paths) prompts. In `
| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Set to `1` to turn off the [critical-path](/docs/en/permission-modes#critical-paths) check for a recursive `rm` whose ta
* [Start sessions in auto mode by default](/docs/en/permission-modes#which-mode-a-session-starts-in) on Pro, Max, and Team plans
* Have the VS Code extension [read settings files for the starting permission mode](/docs/en/permission-modes#switch-permission-modes)
In your first session after you install Claude Code, or upgrade to a version that adds a feature, a [flag-gated feature](#features-that-need-feature-flag-fetching) can be missing,
+3 −3 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
best-practices
±changed
+3−3
claude-codechanged
best-practices
On Pro, Max, and Team plans, auto mode is the [built-in starting permission mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode) for interactive terminal and VS Code s
In Manual mode, the built-in starting permission mode on other plans, Claude Code asks before actions that might modify your system: file writes, Bash commands, MCP tools. That's s
With Claude Code v2.1.283 or later, auto mode is the [built-in starting permission mode](/docs/en/permission-modes#eliminate-prompts-with-auto-mode) for interactive terminal and VS
+3 −3 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
admin-setup
±changed
+1−1
claude-codechanged
admin-setup
| [Starting permission mode](/docs/en/permission-modes#which-mode-a-session-starts-in) | Choose the permission mode your developers' terminal sessions start in instead of the built
| [Starting permission mode](/docs/en/permission-modes#which-mode-a-session-starts-in) | Choose the permission mode your developers' terminal sessions start in instead of the built
+1 −1 lines
Upstream edited 26 Sep 2026 02:54 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
auto-mode-config
±changed
+1−1
claude-codechanged
auto-mode-config
Set `autoMode.classifyAllShell` to `true` to suspend every Bash and PowerShell allow rule while auto mode is active, so the classifier evaluates every shell command regardless of y
Set `autoMode.classifyAllShell` to `true` to suspend every Bash and PowerShell allow rule while auto mode is active, so the classifier evaluates every shell command regardless of y
+1 −1 lines
Upstream edited 26 Sep 2026 02:53 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
agent-sdk/permissions
±changed
+6−2
claude-codechanged
agent-sdk/permissions
Check `allow` rules (from `allowed_tools` and settings.json). If a rule matches, the tool is approved. A call the tool approves on its own is resolved at this step too, with no
Check `allow` rules (from `allowed_tools` and settings.json). If a rule matches, the tool is approved. A call the tool approves on its own is resolved at this step too, with no
`rm` and `rmdir` removals targeting a [critical path](/docs/en/permission-modes#critical-paths) are never approved by an allow rule. Whether they then reach your callback depen
**Auto-approved tools never reach `canUseTool`.** A tool call approved at any earlier step, by `acceptEdits` or `bypassPermissions`, or by an allow rule, skips your `canUseTool`
+6 −2 lines
Upstream edited 26 Sep 2026 02:53 UTC Recorded here 26 Sep 2026 03:07 UTC
claude-code
auto-mode-classifier-billing
+new page
+55−0
claude-codenew page
auto-mode-classifier-billing
No line of the body moved in this read.
+55 −0 lines
Upstream edited 26 Sep 2026 02:50 UTC Recorded here 10 Oct 2026 18:07 UTC
claude-code
sub-agents
±changed
+8−4
claude-codechanged
sub-agents
The `--agents` flag accepts JSON with a `prompt` field plus these [frontmatter](#supported-frontmatter-fields) fields: `description`, `tools`, `disallowedTools`, `model`, `permissi
Each top-level key in the JSON is the agent's name. Don't start a name with `-`.
In [non-interactive mode](/docs/en/headless), `--agents` also accepts the path to a JSON file holding the same object, for definitions too large to pass on the command line. For ex
+8 −4 lines
Upstream edited 26 Sep 2026 01:36 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
errors
±changed
+9−2
claude-codechanged
errors
| `Error: --agents takes a JSON object, or a file path only with --print (-p)`
| `Error: --agents file not found`
The value you passed to `--agents` is invalid, so `claude` exits with code 1 instead of starting the session. When you pass `--safe-mode`, `--resume`, or `--continue`, or set [`CLA
The value you passed to `--agents` is invalid, so `claude` exits with code 1 instead of starting the session. When you pass `--safe-mode` or set [`CLAUDE_CODE_SAFE_MODE`](/docs/en/
1. When the value doesn't parse as JSON, Claude Code prints one `invalid JSON:` line carrying the JSON parser's own message
+9 −2 lines
Upstream edited 26 Sep 2026 01:36 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
cli-reference
±changed
+1−1
claude-codechanged
cli-reference
| `--agents` | Define custom subagents dynamically via JSON. Accepts the [fields listed for CLI-defined subagents](/docs/en/sub-agents#choose-t
| `--agents` | Define custom subagents dynamically via JSON. Accepts the [fields listed for CLI-defined subagents](/docs/en/sub-agents#choose-t
+1 −1 lines
Upstream edited 26 Sep 2026 01:36 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
jetbrains
±changed
+3−3
claude-codechanged
jetbrains
| Tool name (as seen by hooks) | What it does
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------
| `mcp__ide__getDiagnostics` | Returns the IDE's inspection diagnostics, the errors and warnings shown in the editor. Each call covers one file: the file Claude specifies, or the
| Tool name (as seen by hooks) | What it does | Read-only |
| - | - | - |
+3 −3 lines
Upstream edited 26 Sep 2026 01:12 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
vs-code
±changed
+10−2
claude-codechanged
vs-code
Browse or search your cloud sessions. Click any session to download it and continue the conversation locally.
Browse or search the sessions. Click one to continue the conversation locally.
Only cloud sessions started with a GitHub repository appear in the Web tab. Resuming loads the conversation history locally; changes are not synced back to claude.ai.
When the folder you have open is a GitHub repository, the Web tab shows only sessions from that repository.
+10 −2 lines
Upstream edited 26 Sep 2026 01:12 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
jetbrains
±changed
+5−1
claude-codechanged
jetbrains
**Selection and open-file context.** While connected, the CLI includes your current editor selection and the path of the active file as context on each prompt you send. The transcr
**Selection and open-file context.** While connected, the CLI includes your current editor selection and the path of the active file as context on each prompt you send. The transcr
If you [queue a message while Claude works](/docs/en/interactive-mode#queue-messages-while-claude-works), it keeps the selection you had when you pressed `Enter`, whatever you sele
+5 −1 lines
Upstream edited 26 Sep 2026 01:12 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
interactive-mode
±changed
+3−1
claude-codechanged
interactive-mode
Type a message and press `Enter` while Claude is working. Claude Code queues the message instead of interrupting the turn, and lists the queued entries above the input box until it
Type a message and press `Enter` while Claude is working. Claude Code queues the message instead of interrupting the turn, and lists the queued entries in the conversation until it
If you queue a message with a selection attached from a [connected IDE](/docs/en/vs-code#the-built-in-ide-mcp-server) or the [diff panel](#diff-panel), it keeps the selection you h
+3 −1 lines
Upstream edited 26 Sep 2026 01:12 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
how-claude-code-works
±changed
+1−1
claude-codechanged
how-claude-code-works
* **Type a correction and press `Enter`** without stopping Claude. The message shows as queued above the input box. If Claude is running tool calls, it reads the message as soon as
* **Type a correction and press `Enter`** without stopping Claude. The message shows as queued in the conversation. If Claude is running tool calls, it reads the message as soon as
+1 −1 lines
Upstream edited 26 Sep 2026 01:12 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
checkpointing
±changed
+1−1
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
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
+1 −1 lines
Upstream edited 26 Sep 2026 01:12 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
voice-dictation
±changed
+26−26
claude-codechanged
voice-dictation
| Command | Effect |
| :------------ | :-------------------------------------------- |
| `/voice` | Toggle on or off, keep the current mode |
| `/voice hold` | Enable in [hold mode](#hold-to-record) |
| `/voice tap` | Enable in [tap mode](#tap-to-record-and-send) |
+26 −26 lines
Upstream edited 26 Sep 2026 01:10 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
voice-dictation
±changed
+2−2
claude-codechanged
voice-dictation
Run `/voice` to enable dictation. The first time you enable it, Claude Code runs a microphone check. On macOS, this triggers the system microphone permission prompt for your termin
Run `/voice` to enable dictation. When you enable it, Claude Code runs a microphone check. On macOS, this triggers the system microphone permission prompt for your terminal if it h
* **`Voice input is failing repeatedly and has been paused`**: voice dictation hit three capture failures within 10 seconds. Claude Code pauses dictation until 10 seconds have pass
* **`Voice input is failing repeatedly and has been paused`**: voice dictation hit three failures within 10 seconds. Claude Code pauses dictation until 10 seconds have passed since
+2 −2 lines
Upstream edited 26 Sep 2026 01:10 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
agent-sdk/typescript
±changed
+8−2
claude-codechanged
agent-sdk/typescript
Generic text banner emitted by the loop. Carries non-error status lines, hook feedback such as a `UserPromptSubmit` hook's block reason, and command output. On Claude Code v2.1.227
Generic text banner emitted by the loop. Carries warnings, notices, and other non-error status lines Claude Code raises, and hook feedback such as a `UserPromptSubmit` hook's block
On Claude Code v2.1.227 or later, a hook's [`systemMessage`](/docs/en/hooks#json-output) can arrive as this message, with each line prefixed by the hook's name, such as `PostToolUs
+8 −2 lines
Upstream edited 26 Sep 2026 01:10 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
code-review
±changed
+18−18
claude-codechanged
code-review
| Marker | Severity | Meaning |
| :----- | :----------- | :------------------------------------------------------------------ |
| 🔴 | Important | A bug that should be fixed before merging |
| 🟡 | Nit | A minor issue, worth fixing but not blocking |
| 🟣 | Pre-existing | A bug that exists in the codebase but was not introduced by this PR |
+18 −18 lines
Upstream edited 26 Sep 2026 01:09 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
code-review
±changed
+2−2
claude-codechanged
code-review
Review runs are best-effort. A failed run never blocks your PR, but it also doesn't retry on its own. This section covers how to recover from a failed run and where to look when th
Review runs are best-effort, and a failed run never blocks your PR. Code Review retries some interrupted reviews on its own. This section covers how to run a review again yourself
When the review infrastructure hits an internal error or exceeds its time limit, the check run completes with a title of **Code review encountered an error** or **Code review timed
When a review fails or exceeds its time limit, the check run completes with a title such as **Code review failed** or **Code review timed out**. The conclusion is still neutral, so
+2 −2 lines
Upstream edited 26 Sep 2026 01:09 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
agent-sdk/python
±changed
+1−1
claude-codechanged
agent-sdk/python
"auto", # Model classifier approves or denies permission prompts
"auto", # A model classifier reviews actions such as shell commands and network requests
+1 −1 lines
Upstream edited 26 Sep 2026 01:08 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
settings-reference
±changed
+1−1
claude-codechanged
settings-reference
* **Default**: unset, so Claude Code adds `Co-Authored-By: <name> <[email protected]>`. The name is the session's active model, such as `Claude Sonnet 5`.
* **Default**: unset, so Claude Code adds `Co-Authored-By: <name> <[email protected]>`. The name is the model in use when the commit is made, such as `Claude Sonnet 5`. When a
+1 −1 lines
Upstream edited 26 Sep 2026 01:08 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
accessibility
±changed
+22−22
claude-codechanged
accessibility
| Option | Type | What it changes
| :---------------------------------------------------------------------- | :------------------- | :--------------------------------------------------------------------------------
| [`--ax-screen-reader`](/docs/en/cli-reference#cli-flags) | Flag | Screen reader mode for one session.
| [`CLAUDE_AX_SCREEN_READER`](/docs/en/env-vars#variables) | Environment variable | Screen reader mode for sessions started from the shell where you set it.
| [`axScreenReader`](/docs/en/settings-reference#axscreenreader) | Setting | Screen reader mode for every session when `true`.
+22 −22 lines
Upstream edited 26 Sep 2026 01:07 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
accessibility
±changed
+1−1
claude-codechanged
accessibility
In screen reader mode, menus you'd normally navigate with the arrow keys, including permission prompts, become numbered lists. Claude Code announces each option as a numbered line,
In screen reader mode, menus you'd normally navigate with the arrow keys, including permission prompts, become numbered lists. Claude Code announces each option as a numbered line,
+1 −1 lines
Upstream edited 26 Sep 2026 01:07 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
debug-your-config
±changed
+29−29
claude-codechanged
debug-your-config
| Command | Shows
| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------
| `/memory` | Memory file locations across user and project scopes with the option to open each in your editor, plus access to the auto memory folder and the auto memory tog
| `/skills` | Available skills from project, user, and plugin sources
| `/hooks` | Active hook configurations
+29 −29 lines
Upstream edited 26 Sep 2026 01:07 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
debug-your-config
±changed
+1−1
claude-codechanged
debug-your-config
| Permissions, hooks, or env set globally are ignored | Configuration was added to `~/.claude.json`
| Permissions or hooks set globally are ignored | Configuration was added to `~/.claude.json`
+1 −1 lines
Upstream edited 26 Sep 2026 01:07 UTC Recorded here 26 Sep 2026 01:37 UTC
claude-code
routines
±changed
+13−13
claude-codechanged
routines
| Event | Triggers when |
| :----------- | :---------------------------------------------------------------------------- |
| Event | Triggers when |
| :- | :- |
| Release | A release is created, published, edited, or deleted |
+13 −13 lines
Upstream edited 26 Sep 2026 01:06 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
routines
±changed
+2−1
claude-codechanged
routines
* The artifact isn't shared publicly, and isn't shared with specific people or your organization with the latest version chosen as the version viewers see
* The artifact isn't shared publicly
* If the artifact is shared with specific people or your organization, its viewers don't automatically see each new version
+2 −1 lines
Upstream edited 26 Sep 2026 01:06 UTC Recorded here 26 Sep 2026 01:07 UTC
claude-code
plugins/create
±changed
+2−0
claude-codechanged
plugins/create
To have Claude scaffold and check a larger plugin with you, [install](/docs/en/plugins/install#install-a-plugin) Anthropic's `plugin-dev` plugin from the `claude-plugins-official`
+2 −0 lines
Upstream edited 26 Sep 2026 01:05 UTC Recorded here 26 Sep 2026 01:07 UTC
claude-code
model-config
±changed
+11−7
claude-codechanged
model-config
Opus 5.5 [defaults to `medium`](#adjust-effort-level), one level below Opus 5's default of `high`. In Anthropic's testing, Opus 5.5 at `medium` matches or exceeds Opus 5 at `high`
On third-party providers, [Customize pinned model display and capabilities](#customize-pinned-model-display-and-capabilities) describes what a pinned model's row in the `/model` pi
| Environment variable | Description |
+11 −7 lines
Upstream edited 26 Sep 2026 00:33 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
llm-gateway-protocol
±changed
+4−0
claude-codechanged
llm-gateway-protocol
Deliver each response's full event sequence without dropping, duplicating, or reordering events. When an event references a content block whose `content_block_start` never arrived,
Relay each response through its final `message_delta` and `message_stop` events before ending the body. A body that ends after a `message_delta` carrying a `stop_reason`, with no c
+4 −0 lines
Upstream edited 26 Sep 2026 00:30 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
errors
±changed
+12−1
claude-codechanged
errors
| `Part of the response never arrived` / `The response stream was malformed`
| `API Error: Content block not found` / `API Error: Content block already closed`
API Error: Part of the response never arrived. The response above may be incomplete.
API Error: The response stream was malformed. The response above may be incomplete.
* `Connection lost mid-response`: the connection dropped.
+12 −1 lines
Upstream edited 26 Sep 2026 00:30 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
memory
±changed
+4−0
claude-codechanged
memory
If you point a `.claude/rules/` or `CLAUDE.md` symlink at a network path such as the UNC share `\\server\share` or a path under `/net` or `/Network`, the linked instructions don't
If one of your instruction files is over the recommended length, you see a warning at startup and when you run `/status`. You also see a warning when files that are each within tha
+4 −0 lines
Upstream edited 26 Sep 2026 00:30 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
prompt-caching
±changed
+29−14
claude-codechanged
prompt-caching
These actions cause the next request to miss part or all of the cache. You see a one-time slower, more expensive turn, after which the new prefix is cached. Most of them are avoida
These actions can cause the next request to miss part or all of the cache. You see a one-time slower, more expensive turn, after which the new prefix is cached. Most of them are av
* [Connecting or disconnecting an MCP server](#connecting-or-disconnecting-an-mcp-server)
* [Connecting or removing an MCP server](#connecting-or-removing-an-mcp-server)
### Connecting or disconnecting an MCP server
+29 −14 lines
Upstream edited 26 Sep 2026 00:29 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
cloud-environments
±changed
+38−38
claude-codechanged
cloud-environments
| Level | Outbound connections |
| :---------- | :------------------------------------------------------------------------------------------- |
| **None** | No outbound network access through the session's network |
| Level | Outbound connections |
| :- | :- |
+38 −38 lines
Upstream edited 26 Sep 2026 00:27 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
cloud-environments
±changed
+14−3
claude-codechanged
cloud-environments
In Anthropic-hosted environments, each session gets a fresh virtual machine (VM) running Ubuntu 24.04 on x86\_64, regardless of your own operating system and CPU architecture, with
In Anthropic-hosted environments, each session gets a fresh virtual machine (VM) running Ubuntu 24.04 on x86\_64, regardless of your own operating system and CPU architecture, with
### Time limits
In Anthropic-hosted environments, these time limits apply to long-running work in a cloud session, such as a build, an install, or a test run. Each entry links to the section that
+14 −3 lines
Upstream edited 26 Sep 2026 00:27 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
claude-code-on-the-web
±changed
+1−0
claude-codechanged
claude-code-on-the-web
* **Time limits**: commands Claude runs and SessionStart hooks have default timeouts you can change, and a setup script is cached only when it finishes in roughly five minutes. See
+1 −0 lines
Upstream edited 26 Sep 2026 00:27 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
skills
±changed
+80−80
claude-codechanged
skills
| Skill | Purpose |
| :--------------------- | :---------------------------------------------------------------------------------------------------------------- |
| `/run` | Launch and drive your app to see a change working |
| `/verify` | Build and run your app to confirm a code change does what it should, without falling back to tests or type checks |
| `/run-skill-generator` | Teach `/run` and `/verify` how to build and launch your project |
+80 −80 lines
Upstream edited 26 Sep 2026 00:27 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
skills
±changed
+4−2
claude-codechanged
skills
Claude Code watches skill directories for file changes, except in [bare mode](/docs/en/headless#start-faster-with-bare-mode). When you add, edit, or remove a skill under `~/.claude
Claude Code watches skill directories for file changes, except in [bare mode](/docs/en/headless#start-faster-with-bare-mode). When you add, edit, or remove a skill under `~/.claude
If you create a top-level skills directory that didn't exist when the session started, run [`/reload-skills`](/docs/en/commands#all-commands) to pick up the skills you put there. C
Claude Code loads a listing of skill names and descriptions into context so Claude knows what's available. The listing always contains every skill name, but if you have many skills
+4 −2 lines
Upstream edited 26 Sep 2026 00:27 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
goal
±changed
+5−5
claude-codechanged
goal
| Approach | Next turn starts when
| :------------------------------------------------------------------ | :-----------------------------------------------------------------------------------------------------------
| `/goal` | The previous turn finishes, or, in an interactive session, an [idle check-in](#background-work-defers-evalua
| [`/loop`](/docs/en/scheduled-tasks#run-a-prompt-repeatedly-with-%2Floop) | A time interval elapses
| [Stop hook](/docs/en/hooks-guide#prompt-based-hooks) | The previous turn finishes
+5 −5 lines
Upstream edited 26 Sep 2026 00:26 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
goal
±changed
+1−1
claude-codechanged
goal
* An authentication failure, when Claude Code manages its own credentials. When a host manages them for you, such as the desktop app, the VS Code extension, or a [cloud session](/d
* An authentication failure, when Claude Code manages its own credentials. When a host manages them for you, such as the desktop app or a [cloud session](/docs/en/claude-code-on-th
+1 −1 lines
Upstream edited 26 Sep 2026 00:26 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
statusline
±changed
+57−57
claude-codechanged
statusline
| Field | Description
| -------------------------------------------------------------------------------- | -----------------------------------------------------------------------------------------------
| `model.id`, `model.display_name` | Current model identifier and display name
| `cwd`, `workspace.current_dir` | Current working directory. Both fields contain the same value; `workspace.current_dir` is prefe
| `workspace.project_dir` | Directory where Claude Code was launched, which may differ from `cwd` if the working directory
+57 −57 lines
Upstream edited 26 Sep 2026 00:24 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
statusline
±changed
+2−2
claude-codechanged
statusline
<Note>The status line runs locally and does not consume API tokens. It temporarily hides during certain UI interactions, including autocomplete suggestions, the help menu, and perm
<Note>The status line runs locally and does not consume API tokens. It temporarily hides during certain UI interactions, including the help menu and permission prompts.</Note>
* Run `claude --debug` to log the exit code and stderr from the first status line invocation in a session
* Run `claude --debug` to log your script's stderr on every status line invocation, and its exit code on the first invocation in a session
+2 −2 lines
Upstream edited 26 Sep 2026 00:24 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
env-vars
±changed
+1−1
claude-codechanged
env-vars
| `DISABLE_PROMPT_CACHING_HAIKU` | Set to `1` to disable prompt caching for Haiku models
| `DISABLE_PROMPT_CACHING_HAIKU` | Set to `1` to disable prompt caching for the [default Haiku model](/docs/en/prompt-caching#disable-prompt-caching), wher
+1 −1 lines
Upstream edited 26 Sep 2026 00:20 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
workflows
±changed
+41−41
claude-codechanged
workflows
| | Subagents | Skills | Agent teams | Workflows |
| :------------------------------ | :----------------------------- | :--------------------------- | :------------------------------------- | :----------------------------------- |
| What it is | A worker Claude spawns | Instructions Claude follows | A lead agent supervising peer sessions | A script the runtime executes |
| Who decides what runs next | Claude, turn by turn | Claude, following the prompt | The lead agent, turn by turn | The script |
| Where intermediate results live | Claude's context window | Claude's context window | A shared task list | Script variables |
+41 −41 lines
Upstream edited 26 Sep 2026 00:20 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
workflows
±changed
+3−1
claude-codechanged
workflows
When workflows are disabled, the bundled workflow commands and the `/workflow-authoring` skill are unavailable, the `ultracode` keyword no longer triggers a run, and `ultracode` is
When workflows are disabled, the bundled workflow commands and the `/workflow-authoring` skill are unavailable, the `ultracode` keyword no longer triggers a run, and `ultracode` is
No setting turns off [ultracode](#let-claude-decide-with-ultracode) alone. To keep workflows but rule out ultracode, set an [effort cap](/docs/en/model-config#organization-effort-l
+3 −1 lines
Upstream edited 26 Sep 2026 00:20 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
worktrees
±changed
+5−5
claude-codechanged
worktrees
| Message starts with | What happened and what to do
| :------------------------------------------------ | :-----------------------------------------------------------------------------------------------------------------------------
| `Your worktree <path> no longer exists` | The worktree directory was removed. The session continues in the current directory without isolation, and Claude Code clears t
| Message starts with | What happened and what to do |
| :- | :- |
+5 −5 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
sandbox-environments
±changed
+18−18
claude-codechanged
sandbox-environments
| Approach | What is isolated | Requires Docker | Setup effort
| :------------------------------------------ | :-------------------------------------------------------------------------- | :-------------- | :-----------------------------------
| [Sandboxed Bash tool](#sandboxed-bash-tool) | Bash, PowerShell, and Monitor commands and their child processes | No | Minimal on macOS; low on Linux and W
| [Sandbox runtime](#sandbox-runtime) | The whole Claude Code process, including file tools, MCP servers, and hooks | No | Low
| [Dev container](#dev-containers) | Full development environment | Yes | Medium
+18 −18 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
monitoring-usage
±changed
+190−190
claude-codechanged
monitoring-usage
| Environment Variable | Description
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------
| `CLAUDE_CODE_ENABLE_TELEMETRY` | Enables telemetry collection (required)
| `OTEL_METRICS_EXPORTER` | Metrics exporter types, comma-separated. Use `none` to disable
| `OTEL_LOGS_EXPORTER` | Logs/events exporter types, comma-separated. Use `none` to disable
+190 −190 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
github-enterprise-server
±changed
+28−28
claude-codechanged
github-enterprise-server
| Feature | GHES support | Notes |
| :------------------- | :-------------- | :----------------------------------------------------------------------------------------------------------------------------- |
| Cloud sessions | ?
| Code Review | ?
| Claude Security | ?
+28 −28 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
channels
±changed
+10−10
claude-codechanged
channels
| Setting | Purpose
| :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------
| `channelsEnabled` | Master switch. Must be `true` for any channel to deliver messages. Blocks all channels including the development flag when off. See [Enable channels for
| `allowedChannelPlugins` | Which plugins can register once channels are enabled. Replaces the Anthropic-maintained list when set.
| Setting | Purpose | When not configured |
+10 −10 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
worktrees
±changed
+3−3
claude-codechanged
worktrees
* **The worktree has work in it**: Claude prompts you to keep or remove the worktree. Keeping preserves the directory and branch so you can return later. Removing deletes the workt
* **The worktree has work in it**: Claude prompts you to keep or remove the worktree. Keeping preserves the directory and branch. To return later, run the `claude --worktree <name>
When you resume a session that was inside a worktree, Claude Code returns the session to that worktree. This holds for interactive resumes, for `--continue` and `--resume` in [non-
When you resume a session that ended inside a worktree without [exiting it](#clean-up-worktrees), Claude Code returns the session to that worktree. This holds for interactive resum
* **Launch directory**: resume from the main checkout or another directory of the repository. Claude Code re-enters a worktree it created with git under `.claude/worktrees/` even w
+3 −3 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
sandbox-environments
±changed
+1−1
claude-codechanged
sandbox-environments
mkdir -p ~/.claude && echo '{}' > ~/.claude.json
mkdir -p ~/.claude && { [ -f ~/.claude.json ] || echo '{}' > ~/.claude.json; }
+1 −1 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
monitoring-usage
±changed
+3−3
claude-codechanged
monitoring-usage
If nothing arrives, run `claude --debug` and check the debug log. Claude Code reports failures from the exporters you configure as `[3P telemetry]` errors, where 3P means third-par
If nothing arrives, start Claude Code with `claude --debug-file <path>` and check the log it writes to that path. Claude Code reports failures from the exporters you configure as `
When you set an `OTEL_EXPORTER_OTLP_*` variable in managed settings, Claude Code removes conflicting developer-set variables at startup and logs a warning you can see with `claude
When you set an `OTEL_EXPORTER_OTLP_*` variable in managed settings, Claude Code removes conflicting developer-set variables at startup and logs a warning in the debug log. What it
To confirm events arrive, submit a prompt in a session running under this configuration and check your SIEM for the `claude_code.user_prompt` event. If nothing arrives, run `claude
+3 −3 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
llm-gateway-connect
±changed
+1−1
claude-codechanged
llm-gateway-connect
curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
+1 −1 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
hooks
±changed
+1−1
claude-codechanged
hooks
In addition to the [common input fields](#common-input-fields), Stop hooks receive `stop_hook_active`, `last_assistant_message`, `background_tasks`, and `session_crons`. The `stop_
In addition to the [common input fields](#common-input-fields), Stop hooks receive `stop_hook_active`, `last_assistant_message`, `background_tasks`, and `session_crons`. The `stop_
+1 −1 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
github-enterprise-server
±changed
+1−1
claude-codechanged
github-enterprise-server
Cloud sessions require a Team or Enterprise organization. Sign in with `/login` using your organization account. If you authenticate with an API key instead, cloud sessions fail ea
Sign in with `/login` using your organization account. If you authenticate with an API key instead, cloud sessions fail earlier with a message asking you to run `/login`.
+1 −1 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
channels
±changed
+1−1
claude-codechanged
channels
To test a channel you're building, use `--dangerously-load-development-channels`. See [Test during the research preview](/docs/en/channels-reference#test-during-the-research-previe
To test a channel you're building, pass it to `--dangerously-load-development-channels` in the `plugin:<name>@<marketplace>` or `server:<name>` form. See [Test during the research
+1 −1 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
best-practices
±changed
+1−1
claude-codechanged
best-practices
* **As a deterministic gate**: a [Stop hook](/docs/en/hooks#stop) runs your check as a script and blocks the turn from ending until it passes. Claude Code overrides the hook and en
* **As a deterministic gate**: a [Stop hook](/docs/en/hooks#stop) runs your check as a script and blocks the turn from ending until it passes. [Stop input](/docs/en/hooks#stop-inpu
+1 −1 lines
Upstream edited 26 Sep 2026 00:15 UTC Recorded here 26 Sep 2026 00:37 UTC
claude-code
settings-reference
±changed
+51−4
claude-codechanged
settings-reference
| [`availableModelsMatch`](#availablemodelsmatch) | Make each `availableModels` model ID entry [permit only the version it nam
| [`deniedModels`](#deniedmodels) | [Block specific models](/docs/en/model-config#block-specific-models-or-ver
Restrict which models people can select for the main session, [subagents](/docs/en/sub-agents), [skills](/docs/en/skills), and the [advisor](/docs/en/advisor). A managed list const
Restrict which models people can select for the main session, [subagents](/docs/en/sub-agents), [skills](/docs/en/skills), and the [advisor](/docs/en/advisor). A managed list const
See [Restrict model selection](/docs/en/model-config#restrict-model-selection).
+51 −4 lines
Upstream edited 26 Sep 2026 00:04 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
model-config
±changed
+40−8
claude-codechanged
model-config
* [`availableModels`](#restrict-model-selection) or [organization model restrictions](#organization-model-restrictions) exclude the model
* Your organization's [model restrictions](#restrict-model-selection) exclude the model
Enterprise administrators can use `availableModels` in [managed or policy settings](/docs/en/managed-settings) to restrict which models users can select. Entries match a model fami
Enterprise administrators can use `availableModels` in [managed or policy settings](/docs/en/managed-settings) to restrict which models users can select. Entries match a model fami
On its own, `availableModels` leaves the Default option on the system's [runtime default](#default-model-setting) for the account until you also set [`enforceAvailableModels`](#enf
+40 −8 lines
Upstream edited 26 Sep 2026 00:04 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
managed-settings
±changed
+25−23
claude-codechanged
managed-settings
| Lists | Combines the entries from every source
| Locks | Applies the strictest value any source sets; a looser value applies only from the highest-ranked source
| Lists | Combines the entries from every source
| Locks | Applies the strictest value any source sets; a looser value applies only from the highest-ranked source
| Field | Behavior when present but invalid
+25 −23 lines
Upstream edited 26 Sep 2026 00:04 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
errors
±changed
+28−2
claude-codechanged
errors
| `Model ... is not available. Your organization restricts model selection.`
| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableM
* Check whether `ANTHROPIC_BASE_URL` is set by running `echo $ANTHROPIC_BASE_URL`, or `echo $env:ANTHROPIC_BASE_URL` in PowerShell, and look for it in the `env` block of your [sett
Your organization admin has disabled this model in the claude.ai admin console, or it is excluded by an [`availableModels`](/docs/en/model-config#restrict-model-selection) allowlis
Your organization admin has disabled this model in the claude.ai admin console, or managed settings exclude it through an [`availableModels`](/docs/en/model-config#restrict-model-s
+28 −2 lines
Upstream edited 26 Sep 2026 00:04 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
agent-sdk/typescript
±changed
+37−18
claude-codechanged
agent-sdk/typescript
| Value | What stopped the session
| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------
| `org_pin_api_key_conflict` | Managed settings [require a first-party or Cloud gateway sign-in](/docs/en/authentication#restrict-login-to-your-organization), and an An
| `org_verify_failed` | The sign-in's organization couldn't be verified against the pin, for example because of a network failure or a revoked token
| `org_pin_mismatch` | The sign-in belongs to an organization the pin doesn't allow
+37 −18 lines
Upstream edited 26 Sep 2026 00:04 UTC Recorded here 26 Sep 2026 00:07 UTC
25 Sep 2026
81 pages
+2079 −6172 lines
claude-code
setup
±changed
+5−5
claude-codechanged
setup
| Option | Requires | [Sandboxing](/docs/en/sandboxing) | When to use |
| -------------- | ---------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------- |
| Native Windows | None; [Git for Windows](https://git-scm.com/downloads/win) is optional | Not supported | Windows-native projects and tools |
| WSL 2 | WSL 2 enabled | Supported | Linux toolchains or sandboxed command execution |
| WSL 1 | WSL 1 enabled | Not supported | If WSL 2 is unavailable |
+5 −5 lines
Upstream edited 25 Sep 2026 23:59 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
overview
±changed
+11−11
claude-codechanged
overview
| What I want to do | Best option
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------
| Continue a local session from my phone or another device | [Remote Control](/docs/en/remote-control)
| Push events from Telegram, Discord, iMessage, or my own webhooks into a session | [Channels](/docs/en/channels)
| Start a task locally, continue on mobile | [`claude --cloud`](/docs/en/claude-code-on-the-web#from-terminal-to-cloud), then the [Claude mob
+11 −11 lines
Upstream edited 25 Sep 2026 23:59 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
setup
±changed
+3−3
claude-codechanged
setup
New to the terminal? See the [terminal guide](/docs/en/terminal-guide) for step-by-step instructions.
To install Claude Code, use one of the following methods:
To install Claude Code, open a terminal and run the command for your system. If you haven't used a terminal before, the [terminal guide](/docs/en/terminal-guide) shows how to open
+3 −3 lines
Upstream edited 25 Sep 2026 23:59 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
quickstart
±changed
+3−1
claude-codechanged
quickstart
To install Claude Code, use one of the following methods:
To install Claude Code, open a terminal and run the command for your system. If you haven't used a terminal before, the [terminal guide](/docs/en/terminal-guide) shows how to open
When the installer finishes, open a new terminal window and run `claude --version`. A working installation prints a version number. If your shell says `claude` isn't found or i
+3 −1 lines
Upstream edited 25 Sep 2026 23:59 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
overview
±changed
+3−1
claude-codechanged
overview
To install Claude Code, use one of the following methods:
To install Claude Code, open a terminal and run the command for your system. If you haven't used a terminal before, the [terminal guide](/docs/en/terminal-guide) shows how to o
When the installer finishes, open a new terminal window and run `claude --version`. A working installation prints a version number. If your shell says `claude` isn't found
+3 −1 lines
Upstream edited 25 Sep 2026 23:59 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
interactive-mode
±changed
+2−0
claude-codechanged
interactive-mode
When a command reaches its timeout before it finishes, Claude Code automatically [moves it to the background](/docs/en/tools-reference#background-commands) instead of stopping it,
+2 −0 lines
Upstream edited 25 Sep 2026 23:53 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
workflows
±changed
+7−1
claude-codechanged
workflows
With ultracode on, Claude decides when a task warrants a workflow. A single request can turn into several workflows in a row: one to understand the code, one to make the change, an
With ultracode on, Claude decides when a task warrants a workflow. A single request can turn into several workflows in a row: one to understand the code, one to make the change, an
Turning ultracode on already opts you in to large runs, so these checks don't apply while it's on:
+7 −1 lines
Upstream edited 25 Sep 2026 23:53 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
sub-agents
±changed
+2−2
claude-codechanged
sub-agents
Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions. When Claude encounters a task that matches a subagent's
Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions. It also sends its own requests, which count toward the
When subagents complete, their results return to your main conversation. Running many subagents that each return detailed results can consume significant context.
When subagents complete, their results return to your main conversation. Running many subagents that each return detailed results can consume significant context, and each subage
+2 −2 lines
Upstream edited 25 Sep 2026 23:53 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
costs
±changed
+3−0
claude-codechanged
costs
The subagent's own requests still draw on your usage. To spend less on them, [choose a smaller model for a subagent](/docs/en/sub-agents#choose-a-model) or [run every subagent on o
* **Subagents and workflows**: every subagent, and every agent a [dynamic workflow](/docs/en/workflows#cost) spawns, sends its own requests on top of the main conversation's. The [
+3 −0 lines
Upstream edited 25 Sep 2026 23:53 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
sessions
±changed
+3−3
claude-codechanged
sessions
A `claude -p --resume` or `claude -p --continue` run resumes in plan mode only when all four conditions hold:
* You pass [`--permission-prompt-tool`](/docs/en/cli-reference#cli-flags), so that Claude Code can present the plan for approval
A `claude -p --resume` or `claude -p --continue` run resumes in plan mode only when all of these conditions hold:
+3 −3 lines
Upstream edited 25 Sep 2026 23:51 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
hooks
±changed
+1−1
claude-codechanged
hooks
To resume a deferred session in plan mode, pass [`--permission-prompt-tool`](/docs/en/cli-reference#cli-flags) along with `--resume` so that Claude Code can present the plan for
To resume a deferred session in plan mode, pass [`--permission-prompt-tool`](/docs/en/cli-reference#cli-flags) along with `--resume` so that Claude Code can present the plan for
+1 −1 lines
Upstream edited 25 Sep 2026 23:51 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
auto-mode-config
±changed
+12−30
claude-codechanged
auto-mode-config
Auto mode is available to all users on every provider, including the Anthropic API, [Claude Platform on AWS](/docs/en/claude-platform-on-aws), Amazon Bedrock, Google Cloud's Agen
This page is the configuration reference. Turning auto mode on and off is covered on the Permission modes page:
* **Switch to auto mode mid-session, or back out of it**: see [Switch permission modes](/docs/en/permission-modes#switch-permission-modes)
* **Start a session in auto mode**: see [Start in a different permission mode](/docs/en/permission-modes#start-in-a-different-mode)
+12 −30 lines
Upstream edited 25 Sep 2026 23:49 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
troubleshoot-install
±changed
+43−43
claude-codechanged
troubleshoot-install
| What you see | Solution
| :--------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------
| `command not found: claude` or `'claude' is not recognized` | [Fix your PATH](#command-not-found-claude-after-installation)
| `syntax error near unexpected token '<'` | [Install script returns HTML](#install-script-returns-html-instead-of
| `curl: (22) The requested URL returned error: 403` | [Install script returned 403](#install-script-returns-html-instead-of
+43 −43 lines
Upstream edited 25 Sep 2026 23:45 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
agent-sdk/mcp
±changed
+5−5
claude-codechanged
agent-sdk/mcp
| Server type | Delays the first turn? | First-turn wait timeout
| :------------------------------------------------------------------------------------- | :----------------------------------------------------- | :-------------------------------
| stdio server, or HTTP/SSE server without a cached tool list | Yes, until it connects | [`MCP_TIMEOUT`](/docs/en/env-var
| Remote server with a cached tool list, saved by Claude Code from a previous connection | No; the cached tools are available from the first turn | None; connects on its first tool
| In-process [SDK server](#sdk-mcp-servers) | Yes, until it connects and lists its tools | [`MCP_TIMEOUT`](/docs/en/env-var
+5 −5 lines
Upstream edited 25 Sep 2026 23:45 UTC Recorded here 28 Sep 2026 23:37 UTC
claude-code
troubleshoot-install
±changed
+23−0
claude-codechanged
troubleshoot-install
| `'claude' is not recognized` right after an update on Windows | [Restore `claude.exe` from its backup](#claude-exe-missing-after-an-u
<h3 id="claude-exe-missing-after-an-update-on-windows">
`claude.exe` missing after an update on Windows
</h3>
+23 −0 lines
Upstream edited 25 Sep 2026 23:45 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
tools-reference
±changed
+1−1
claude-codechanged
tools-reference
| `ListMcpResourcesTool` | Lists resources exposed by connected [MCP servers](/docs/en/mcp)
| `ListMcpResourcesTool` | Lists resources exposed by connected [MCP servers](/docs/en/mcp), leaving out [MCP Apps UI resources](/docs/en/mcp#reference-mcp-resources), which are pa
+1 −1 lines
Upstream edited 25 Sep 2026 23:45 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
mcp
±changed
+10−2
claude-codechanged
mcp
Only an SDK host application, such as an [Agent SDK](/docs/en/agent-sdk/mcp) application or the [desktop app](/docs/en/desktop), can register an in-process `"type": "sdk"` server.
The three scopes match duplicates by name. Plugins and connectors match by endpoint, so one that points at the same URL or command as a server above is treated as a duplicate.
Claude Code matches duplicates across the three scopes by name. It matches plugins and connectors by endpoint, so one that points at the same URL or command as a server above count
+10 −2 lines
Upstream edited 25 Sep 2026 23:45 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
agent-sdk/mcp
±changed
+5−5
claude-codechanged
agent-sdk/mcp
| Server type | Delays the first turn? | First-turn wait timeout
| :------------------------------------------------------------------------------------- | :----------------------------------------------------- | :-------------------------------
| stdio server, or HTTP/SSE server without a cached tool list | Yes, until it connects | [`MCP_TIMEOUT`](/docs/en/env-var
| Remote server with a cached tool list, saved by Claude Code from a previous connection | No; the cached tools are available from the first turn | None; connects on its first tool
| In-process [SDK server](#sdk-mcp-servers) | Yes, until it connects and lists its tools | None; the connect and tool listi
+5 −5 lines
Upstream edited 25 Sep 2026 23:45 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
skills
±changed
+15−11
claude-codechanged
skills
| Same name in | Which one runs
| :------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------
| Two of enterprise, personal, and project | Enterprise over personal, and personal over project. With `deploy
| Any of those locations and a [bundled skill](#bundled-skills) | Your skill replaces the bundled command, but not its aliases. A p
| A skill and a file in `.claude/commands/` | The skill
+15 −11 lines
Upstream edited 25 Sep 2026 23:44 UTC Recorded here 26 Sep 2026 00:07 UTC
claude-code
agent-sdk/plugins
±changed
+7−7
claude-codechanged
agent-sdk/plugins
For complete information on plugin structure and how to create plugins, see [Plugins](/docs/en/plugins/overview).
For complete information on plugin structure and how to create plugins, see [Plugins](/docs/en/plugins/overview.md).
To use a plugin distributed through a [marketplace](/docs/en/plugins/overview) or remote repository, download it first and provide the local directory path. For the directory layou
To use a plugin distributed through a [marketplace](/docs/en/plugins/overview.md) or remote repository, download it first and provide the local directory path. For the directory la
* [Plugins](/docs/en/plugins/overview) - Complete plugin development guide
+7 −7 lines
Upstream edited 25 Sep 2026 23:42 UTC Recorded here 22 Oct 2026 18:07 UTC
Nothing on this page matches that. Press Enter to search every page of the ledger.