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
145 changed this week · last read 22 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,550 of the ledger's changes in claude-code. Show every change
ReadSourcePageWhatLines
9 Sep 2026
84 pages
+2130 −948 lines
claude-code
sessions
±changed
+1−1
claude-codechanged
sessions
* Conversation history: the full history, including tool calls and results.
* Conversation history: the full history, including tool calls and results. A tool that was still running when the previous process ended, for example in a crash, doesn't finish or
+1 −1 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
prompt-caching
±changed
+3−1
claude-codechanged
prompt-caching
Claude Code applies a plugin change when you run [`/reload-plugins`](/docs/en/discover-plugins#apply-plugin-changes-without-restarting) or start a new session. You pay the cost, wh
A plugin change applies when you run [`/reload-plugins`](/docs/en/discover-plugins#apply-plugin-changes-without-restarting) or start a new session, not when you run `/plugin enable
* In interactive sessions, when you add or remove a plugin in a [folder of plugins](/docs/en/plugins#test-your-plugins-locally) you passed with `--plugin-dir`, the change applies r
* **Resumed subagents**: when Claude [resumes a subagent](/docs/en/sub-agents#resume-subagents), the resumed run's first request can read the cache the original run warmed.
+3 −1 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
plugins
±changed
+6−1
claude-codechanged
plugins
The plugin root is the individual plugin's own directory: the one you pass to `--plugin-dir` or that contains `.claude-plugin/plugin.json`. It is never `~/.claude/`. For example,
The plugin root is the individual plugin's own directory, such as `my-first-plugin/` from the [quickstart](#quickstart). It is never `~/.claude/`. For example, Claude Code doesn'
To load several plugins from one place, pass a folder that holds them, such as `--plugin-dir ./plugins`. Loading a folder of plugins requires Claude Code v2.1.265 or later. Claude
* **What loads**: if the folder has no manifest or plugin components at its top level, Claude Code treats it as a folder of plugins. Each immediate subfolder that has a `.claude-pl
+6 −1 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
plugin-dependencies
±changed
+2−0
claude-codechanged
plugin-dependencies
When both plugins sit in one parent folder, you can pass that folder to `--plugin-dir` once. If the folder isn't itself a plugin, Claude Code loads each child folder that has a `.c
+2 −0 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
permissions
±changed
+6−7
claude-codechanged
permissions
The label shown for a tool in the transcript and permission dialog can differ from its canonical name. For example, the tool labeled `Stop Task` in the transcript has the canonical
The label shown for a tool in the transcript and permission dialog can differ from its canonical name. For example, the tool labeled `Stop Task` in the transcript has the canonical
* Extra spaces: `curl http://github.com`
| Rule | Matches | Does not match |
| --------------------- | ----------------------------------------- | ---------------------------- |
+6 −7 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
permission-modes
±changed
+1−1
claude-codechanged
permission-modes
Each interface has its own control for switching permission modes during a session and its own way of choosing the permission mode new sessions start in. Asking Claude in chat to c
Each interface has its own control for switching permission modes during a session and its own way of choosing the permission mode new sessions start in. Select your interface to s
+1 −1 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
large-codebases
±changed
+9−9
claude-codechanged
large-codebases
* **Yourself only**: use `.claude/settings.local.json` at the repository root, which loads in every CLI session inside the repository regardless of starting directory, except in th
* **Yourself only**: use `.claude/settings.local.json` at the repository root, which loads in every CLI session inside the repository regardless of starting directory, except in th
The example below blocks build artifacts and a vendored SDK:
The example below blocks build artifacts and a vendored SDK. Its directory patterns end with `/**/*` rather than `/**` so that each rule covers everything inside the directory but
"Read(./**/dist/**)",
+9 −9 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
keybindings
±changed
+19−17
claude-codechanged
keybindings
| Action | Default | Description
| :-------------------- | :-------------------------------- | :---------------------------------------------------------------------------------------------------------------------
| `chat:cancel` | Escape | Cancel current input
| `chat:clearInput` | Ctrl+L | Force a full screen redraw, preserving input and conversation. In [fullscreen rendering](/docs/en/fullscreen#clear-the
| `chat:clearScreen` | Cmd+K | Same as `chat:clearInput`. See [Clear the conversation](/docs/en/fullscreen#clear-the-conversation) for how Cmd+K beha
+19 −17 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
interactive-mode
±changed
+13−0
claude-codechanged
interactive-mode
### Complete a command mid-prompt
Command completion also works partway through a prompt: type `/` after a space, then the first letters of a name, as in `run the tests, then /com`. Only commands whose names start
* **In [fullscreen rendering](/docs/en/fullscreen)**: the matches open as a list while you type, with no row highlighted, so `Enter` still sends your prompt as typed. Press `Tab` t
+13 −0 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
hooks
±changed
+8−2
claude-codechanged
hooks
When several hooks return `additionalContext` for the same event, Claude receives all of the values. If a value exceeds 10,000 characters, Claude Code writes the full text to a fil
When several hooks return `additionalContext` for the same event, Claude receives all of the values.
If a value exceeds 10,000 characters, Claude Code writes the text to a file in the session directory and passes Claude the file path with a short preview instead.
+8 −2 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
headless
±changed
+6−1
claude-codechanged
headless
By default, Claude Code emits only subagent `tool_use` and `tool_result` blocks. Pass [`--forward-subagent-text`](/docs/en/cli-reference#cli-flags) or set [`CLAUDE_CODE_FORWARD_SUB
The first message from a subagent running in the [foreground](/docs/en/sub-agents#run-subagents-in-foreground-or-background) is a `user` message carrying the prompt that drives it.
* **By default**: the subagent's `tool_use` and `tool_result` blocks.
* **With [`--forward-subagent-text`](/docs/en/cli-reference#cli-flags) or [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/en/env-vars)**: the subagent's text and thinking blocks too, s
+6 −1 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
env-vars
±changed
+8−6
claude-codechanged
env-vars
| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Set to `0` to stop Claude Code from opening the browser automatically when a new [artifact](/docs/en/artifacts) is publi
| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Set to `0` to stop Claude Code from opening the browser automatically when a new [artifact](/docs/en/artifacts#create-an
| `CLAUDE_CODE_DISABLE_THINKING` | Set to `1` to omit the `thinking` parameter from API requests entirely. This is a compatibility option for proxies and g
| `CLAUDE_CODE_DISABLE_THINKING` | Set to `1` to omit the `thinking` parameter from API requests entirely. This is a compatibility option for proxies and g
| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Set to `1` to write terminal output through a second non-blocking file descriptor, so a terminal that stops reading, suc
+8 −6 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
commands
±changed
+2−2
claude-codechanged
commands
| `/import [codex\|gemini] [--dry-run] [--yes]` | Bring configuration from other coding agents on your machine, curre
| `/init` | Initialize project with a `CLAUDE.md` guide. Set `CLAUDE_CODE_NEW_I
| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | Bring configuration from OpenAI Codex, Google Gemini CLI, or Cursor
| `/init` | Initialize project with a `CLAUDE.md` guide. Set `CLAUDE_CODE_NEW_I
+2 −2 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
cli-reference
±changed
+5−5
claude-codechanged
cli-reference
| `claude import [codex\|gemini]` | Start an interactive session that runs [`/import`](/docs/en/commands#all-commands) to bring configuration from other coding agents into Claude C
| `claude import [source]` | Start an interactive session that runs [`/import`](/docs/en/commands#all-commands) to bring configuration from other coding agents into Claude C
| `claude rm <id>` | Remove a [background session](/docs/en/agent-view#manage-sessions-from-the-shell) from the list. The conversation transcript stays on your local
| `claude rm <id>` | Remove a [background session](/docs/en/agent-view#manage-sessions-from-the-shell) from the list. Accepts `--discard-unpushed <commit>@<worktree-
| `--bg`, `--background` | Start the session as a [background agent](/docs/en/agent-view) and return immediately. Prints the session ID and management comm
+5 −5 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
artifacts
±changed
+25−1
claude-codechanged
artifacts
* Claude declares a runtime capability for the page, such as [connector calls](#pull-live-data-with-mcp-connectors)
* Claude declares a runtime capability for the page, such as [connector calls](#pull-live-data-with-mcp-connectors) or [file downloads](#offer-a-file-download)
## Read an artifact shared with you
+25 −1 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
agent-view
±changed
+1−1
claude-codechanged
agent-view
| `~/.claude/jobs/<id>/tmp/` | Per-session scratch directory. Writes here don't prompt for permission. Removed when the session is deleted
| `~/.claude/jobs/<id>/tmp/` | Per-session scratch directory. Claude's `Write` and `Edit` calls here don't prompt for permission. Removed when the session is deleted
+1 −1 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
agent-teams
±changed
+1−1
claude-codechanged
agent-teams
[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/en/sub-agents#run-every-subagent-on-one-model) applies to teammates as well as to subagents.
If you set [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1`](/docs/en/sub-agents#run-every-subagent-on-one-model), the first two sources don't apply. Claude Code picks every teammate's model
+1 −1 lines
Recorded here 9 Sep 2026 19:37 UTC
claude-code
settings-reference
±changed
+20−13
claude-codechanged
settings-reference
See [Ask before switching](/docs/en/model-config#ask-before-switching). Requires Claude Code v2.1.170 or later.
See [Ask before switching](/docs/en/model-config#ask-before-switching).
Under `"merge"`, Claude Code combines each key by its kind. This table gives the rule for each kind; the restriction allowlist and highest-source-only rows name every key they cove
| Kind of key | How Claude Code combines it
+20 −13 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
server-managed-settings
±changed
+20−5
claude-codechanged
server-managed-settings
Server-managed settings let organization Owners centrally configure Claude Code from [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-c
Server-managed settings let organization Owners centrally configure Claude Code from [**Admin Settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-c
If a later fetch finds the server-managed settings removed, Claude Code runs that helper right away instead of at the next launch. The [`policyHelper`](/docs/en/settings-reference#
Every other key in the cached `env` block, such as telemetry and OpenTelemetry configuration, applies at startup as before. Once the server confirms the payload, and you approve it
+20 −5 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
permissions
±changed
+1−6
claude-codechanged
permissions
Use both for defense-in-depth:
* Permission deny rules block Claude from even attempting to access restricted resources
* Sandbox restrictions prevent Bash commands from reaching resources outside defined boundaries, even if a prompt injection bypasses Claude's decision-making
* Filesystem restrictions in the sandbox combine the [`sandbox.filesystem`](/docs/en/sandboxing) settings with Read and Edit deny rules; both are merged into the final sandbox boun
+1 −6 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
managed-settings
±changed
+5−4
claude-codechanged
managed-settings
* **Running sessions**: a session picks up most changes on the schedule in the table without a restart. Claude Code reads [`forceRemoteSettingsRefresh`](/docs/en/settings-reference
* **Running sessions**: most changes reach a running session on the schedule in the [delivery mechanism table](#choose-a-delivery-mechanism), without a restart.
* Changes to [`forceRemoteSettingsRefresh`](/docs/en/settings-reference#forceremotesettingsrefresh), [`requiredMinimumVersion`](/docs/en/settings-reference#requiredminimumversion
* A new or changed [`policyHelper`](/docs/en/settings-reference#policyhelper) entry takes effect at the next launch, except that a helper shadowed at launch by server-managed set
This table shows how Claude Code combines each kind of key under `"merge"`; the [`managedSourcesBehavior` entry](/docs/en/settings-reference#managedsourcesbehavior) names every key
+5 −4 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
hooks
±changed
+1−8
claude-codechanged
hooks
Set `type` to `"agent"` and provide a `prompt` string. The configuration fields are the same as [prompt hooks](#prompt-hook-configuration), except that agent hooks have a longer de
| Field | Required | Description |
| :-------- | :------- | :------------------------------------------------------------------------------------------ |
| `type` | yes | Must be `"agent"` |
+1 −8 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
errors
±changed
+39−0
claude-codechanged
errors
| `Cloud gateway session expired — run /login to reconnect.`
| `Cloud gateway <url> no longer accepts this session`
| `Managed settings were not approved; exiting without applying them.`
### Cloud gateway session expired
+39 −0 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
claude-apps-gateway-deploy
±changed
+5−2
claude-codechanged
claude-apps-gateway-deploy
Don't redirect requests to the gateway's device-authorization and token endpoints. Claude Code doesn't follow redirects on those requests, so an ingress rule that redirects them, s
The mismatch message includes the gateway hostname and the first 16 characters of each fingerprint, the pinned one and the presented one.
| CLI `/login` stops with `The gateway's TLS certificate changed during sign-in: it no longer matches the one you trusted` | A si
+5 −2 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
claude-apps-gateway
±changed
+8−3
claude-codechanged
claude-apps-gateway
The CLI fingerprints the gateway's TLS leaf certificate on first connect and pins it per hostname. Publish the expected SHA-256 fingerprint alongside the gateway URL so developers
The CLI fingerprints the gateway's TLS leaf certificate on first connect and pins it per hostname. It checks that pin again during sign-in, on silent session refreshes, and on mana
Publish the expected SHA-256 fingerprint alongside the gateway URL so developers have something to compare against. The `/login` prompt shows the first 16 characters of the fingerp
Once signed in, the [model picker](/docs/en/model-config) shows the models in the developer's `availableModels` allowlist, managed settings apply at startup and refresh hourly, and
+8 −3 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
authentication
±changed
+7−1
claude-codechanged
authentication
If your organization uses [server-managed settings](/docs/en/server-managed-settings), they apply to this sign-in on Claude Code v2.1.257 or later.
To confirm which source Claude Code chose, run `/status`: a `Profile` row names the source in place of the `Login method` row. If you start Claude Code with `--debug`, it also writ
To confirm which source Claude Code chose, run `/status`. A `Profile` row names the source in place of the `Login method` row, and when the profile is the credential in use, `Organ
+7 −1 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
agent-sdk/typescript
±changed
+23−17
claude-codechanged
agent-sdk/typescript
| `forwardSubagentText` | `boolean` | `false`
| `forwardSubagentText` | `boolean` | `false`
* `user_message_uuid`: the `uuid` of the message you sent that started this turn. See [`user_message_uuid`](#user_message_uuid) for which results carry it.
* `user_message_uuid`: the `uuid` of the message you sent that this turn answered. See [`user_message_uuid`](#user_message_uuid) for which results carry it.
* `request_sent_wall_ms`: epoch milliseconds at which Claude Code dispatched the API request, for joins against server-side timestamps. Present on the success arm only, together wi
+23 −17 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
agent-sdk/python
±changed
+1−1
claude-codechanged
agent-sdk/python
| `forward_subagent_text` | `bool` | `False` | Forward subagent text
| `forward_subagent_text` | `bool` | `False` | Forward subagent text
+1 −1 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
agent-sdk/claude-code-features
±changed
+7−7
claude-codechanged
agent-sdk/claude-code-features
| Input | Behavior
| :------------------------------------------------------------------------------------------------------------------------------ | :-----------------------------------------------
| Managed policy settings | Endpoint-managed policy, such as an MDM plist, r
| `~/.claude.json` global config | Always read
| Auto memory at `~/.claude/projects/<project>/memory/` | Loaded into the system prompt at session start.
+7 −7 lines
Recorded here 9 Sep 2026 19:10 UTC
claude-code
workflows
±changed
+9−1
claude-codechanged
workflows
If you pass a `schema` on an `agent()` call, that subagent returns JSON matching the shape instead of prose. Claude Code checks the schema before starting the subagent: when it can
If the subagent's output still fails validation after five attempts, the call fails with an error that includes the last validation failure. To change the attempt count, set [`MAX_
When you stop a run, it stays in the task panel while any of its agents' processes are still running. If you stop it again, Claude Code re-signals those processes.
+9 −1 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
ultrareview
±changed
+1−1
claude-codechanged
ultrareview
| `--timeout <minutes>` | Maximum minutes to wait for the review to finish. Defaults to 30
| `--timeout <minutes>` | Maximum minutes to wait for the review to finish. Defaults to 45
+1 −1 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
tools-reference
±changed
+4−0
claude-codechanged
tools-reference
Claude Code decides permission for a Glob call before it checks whether the search directory exists. It still runs the read-permission check for a missing `path` outside the [worki
Claude Code decides permission for a Grep call before it checks whether the search `path` exists. It still runs the read-permission check for a missing `path` outside the [working
+4 −0 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
statusline
±changed
+1−1
claude-codechanged
statusline
| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Repository identity parsed from the `origin` remote, for example `"github.com"`, `"anthropics"`
| `workspace.repo.host`, `workspace.repo.owner`, `workspace.repo.name` | Repository identity parsed from the `origin` remote, for example, `"github.com"`, `"anthropics"
+1 −1 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
skills
±changed
+30−22
claude-codechanged
skills
| Field | Required | Description
| :------------------------- | :---------- | :--------------------------------------------------------------------------------------------------------------------------------------
| `name` | No | Display name shown in skill listings. Defaults to the directory name. See [How a skill gets its command name](#how-a-skill-gets-its-com
| `description` | Recommended | What the skill does and when to use it. Claude uses this to decide when to apply the skill. If omitted, uses the first paragraph of mar
| `when_to_use` | No | Additional context for when Claude should invoke the skill, such as trigger phrases or example requests. Appended to `description` in t
+30 −22 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
permissions
±changed
+1−1
claude-codechanged
permissions
`bypassPermissions` mode skips permission prompts, including for writes to [protected paths](/docs/en/permission-modes#protected-paths) such as `.git` and `.claude`. The [cross-s
In `bypassPermissions` mode, Claude Code skips permission prompts, including for writes to [protected paths](/docs/en/permission-modes#protected-paths) such as `.git` and `.claud
+1 −1 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
hooks
±changed
+12−8
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": "/tmp/claude-1000/-home-user-my-project/abc123/scratchpad",
A permission request or elicitation that arrives while another dialog is on screen keeps the same six-second gate, timed from when the request arrives. Its notification can reach
| Matcher | When it fires |
+12 −8 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
google-vertex-ai
±changed
+5−1
claude-codechanged
google-vertex-ai
Claude Code uses `ANTHROPIC_VERTEX_PROJECT_ID` as the project ID for Google Cloud's Agent Platform requests. The `GCLOUD_PROJECT` and `GOOGLE_CLOUD_PROJECT` environment variables
Claude Code addresses Google Cloud's Agent Platform requests to the project in `ANTHROPIC_VERTEX_PROJECT_ID`, even when `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT`, or the credentia
Before running the command, Claude Code requests an access token with your current credentials to confirm they're actually expired, and skips the command when they still work.
If the check doesn't finish within five seconds, Claude Code also skips the command and runs it only after a request fails with a credential error. Before v2.1.261, a check that ti
+5 −1 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
github-actions
±changed
+2−0
claude-codechanged
github-actions
`/install-github-app` works only with github.com repositories. If your repository's git remote is on gitlab.com or bitbucket.org, the command prints a notice and exits instead of s
+2 −0 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
fullscreen
±changed
+1−0
claude-codechanged
fullscreen
* Clicking also expands the output of a `!` shell command, whether an older truncated result or the live progress row while the command runs. Requires Claude Code v2.1.257 or lat
+1 −0 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
env-vars
±changed
+2−2
claude-codechanged
env-vars
| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP project ID for Google Cloud's Agent Platform requests. Overridden by `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT`, or th
| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP project ID that Google Cloud's Agent Platform requests are addressed to. See [Configure GCP credentials](/docs/en/go
| `MAX_STRUCTURED_OUTPUT_RETRIES` | Number of times Claude Code retries when the model's response fails validation against the [`--json-schema`](/docs/en/cl
| `MAX_STRUCTURED_OUTPUT_RETRIES` | Number of attempts Claude Code allows when the model's response fails validation against the [`--json-schema`](/docs/en/
+2 −2 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
debug-your-config
±changed
+3−1
claude-codechanged
debug-your-config
Edits to `settings.json` take effect in the running session after a brief file-stability delay. You don't need to restart. If `/hooks` still shows the old definition a few seconds
When you edit `settings.json`, the change takes effect in the running session after a brief file-stability delay, even if you create the file or the project's `.claude/` folder its
If `/hooks` still shows the old definition a few seconds after you save, run `/hooks` again to refresh the view.
+3 −1 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
cross-session-messaging
±changed
+5−1
claude-codechanged
cross-session-messaging
You can message a session shown as `offline` in [the listing](#see-which-sessions-claude-can-reach), one whose Remote Control connection has dropped. The send goes through, but the
* When the dialog stays unanswered past the [`dialogExpiry`](/docs/en/settings-reference#dialogexpiry) deadline, Claude Code closes it and drops the message. The deadline defaults
* When the dialog stays unanswered past the [`dialogExpiry`](/docs/en/settings-reference#dialogexpiry) deadline, Claude Code closes it and drops the message. The deadline defaults
* While no terminal is attached to a [background session](/docs/en/agent-view), Claude Code leaves the dialog open past the deadline. After you attach, if the dialog stays unanswer
+5 −1 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
cli-reference
±changed
+1−1
claude-codechanged
cli-reference
| `claude ultrareview [target]` | Run [ultrareview](/docs/en/ultrareview#run-ultrareview-non-interactively) non-interactively. Prints findings to stdout and exits 0 on success or
| `claude ultrareview [target]` | Run [ultrareview](/docs/en/ultrareview#run-ultrareview-non-interactively) non-interactively. Prints findings to stdout and exits 0 on success or
+1 −1 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
agent-view
±changed
+3−3
claude-codechanged
agent-view
* **Working, waiting on you, or attached**: the process keeps running. A running subagent, workflow, or monitor counts as working.
* **Finished and unattached for about an hour**: the supervisor stops the process to free resources. The conversation stays on disk, and the next time you attach or reply, the sess
* **Working, paused on a permission prompt or other dialog, or attached**: the process keeps running. A running subagent, workflow, or monitor counts as working.
* **Finished or waiting for your next message, and unattached for about an hour**: the supervisor stops the process to free resources. A session that ended its turn by asking you a
Once a session has finished and sat unattached for about an hour, the supervisor stops its process to free resources. Attaching starts a fresh process from where it left off and sw
+3 −3 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
agent-sdk/permissions
±changed
+11−2
claude-codechanged
agent-sdk/permissions
Apply the active [permission mode](#permission-modes). `bypassPermissions` approves everything that reaches this step except `rm` and `rmdir` removals targeting a [critical pat
Apply the active [permission mode](#permission-modes):
* In `bypassPermissions` mode, Claude Code approves everything that reaches this step except `rm` and `rmdir` removals targeting a [critical path](/docs/en/permission-modes#cri
* In `acceptEdits` mode, Claude Code approves the file operations listed under [Accept edits mode](#accept-edits-mode-acceptedits).
+11 −2 lines
Recorded here 9 Sep 2026 18:07 UTC
claude-code
remote-control
±changed
+7−1
claude-codechanged
remote-control
You're not authenticated with a claude.ai account. Run `claude auth login` and choose the claude.ai option. If `ANTHROPIC_API_KEY` is set in your environment, unset it first.
You're not signed in with a claude.ai account, or another credential is taking precedence over your login. The message takes one of these forms:
* Signed out, from `/remote-control` or `--remote-control`: `Remote Control requires a claude.ai subscription.`
* Signed out, from `claude remote-control`: `You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.`
+7 −1 lines
Recorded here 9 Sep 2026 17:37 UTC
claude-code
llm-gateway-connect
±changed
+1−1
claude-codechanged
llm-gateway-connect
| `Your apiKeyHelper script is failing`
| `Your apiKeyHelper script is failing`, or `apiKeyHelper failed:` on stderr in non-interactive mode
+1 −1 lines
Recorded here 9 Sep 2026 17:37 UTC
claude-code
keybindings
±changed
+26−1
claude-codechanged
keybindings
| `EffortSlider` | Effort slider opened by `/effort` |
| `Agents` | [Agent view](/docs/en/agent-view) (`claude agents`) |
| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | Open in external editor
| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | Open in external editor. The [agent view dispatch input](/docs/en/agent-view#keyboard-shortcuts) follows this action's
### Effort slider actions
+26 −1 lines
Recorded here 9 Sep 2026 17:37 UTC
claude-code
errors
±changed
+47−22
claude-codechanged
errors
| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid`
| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern`
| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)`
In [non-interactive mode](/docs/en/headless), stderr also carries the specific reason, prefixed with `apiKeyHelper failed:`.
+47 −22 lines
Recorded here 9 Sep 2026 17:37 UTC
claude-code
agent-view
±changed
+89−24
claude-codechanged
agent-view
To read session state from a script or another program, use [`claude agents --json`](#read-session-state-from-a-script) rather than the files under `~/.claude/jobs/`.
`←` also detaches while the [`/btw` overlay](/docs/en/interactive-mode#side-questions-with-%2Fbtw) is open. Requires Claude Code v2.1.257 or later. A side question that's still ans
`Ctrl+S`, `Ctrl+T`, and `Ctrl+G` follow your [`keybindings.json`](/docs/en/keybindings). Rebind or unbind `Ctrl+S` and `Ctrl+T` with the `agents:switchView` and `agents:togglePin`
+89 −24 lines
Recorded here 9 Sep 2026 17:37 UTC
claude-code
worktrees
±changed
+12−4
claude-codechanged
worktrees
A directory with no git metadata at all, such as one your [`WorktreeCreate` hook](#non-git-version-control) creates, passes the check only when no git repository contains it. If th
When an interactive resume can't return the session to its worktree, Claude Code says so with one of the messages below.
When you resume a session interactively and Claude Code can't return it to its worktree, Claude Code says so with one of the messages below. When Claude Code clears the worktree bi
In [non-interactive mode](/docs/en/headless) with `-p`, and on resumes the [Agent SDK](/docs/en/agent-sdk/sessions) runs, Claude Code stops the resume with a stderr error for every
+12 −4 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
sub-agents
±changed
+5−3
claude-codechanged
sub-agents
A background subagent that completes stays listed in [`/tasks`](/docs/en/commands), marked done and sorted below running work, for the same window as the footer hint above. Its det
A background subagent that completes stays listed in [`/tasks`](/docs/en/commands), marked done and sorted below running work, for the same 30 seconds as the footer hint. Its detai
Resumed subagents retain their full conversation history, including all previous tool calls, results, and reasoning. The subagent picks up exactly where it stopped rather than star
Resumed subagents retain their full conversation history, including all previous tool calls, results, and reasoning. If the subagent spawned [background subagents of its own](#let-
A completed subagent that receives a `SendMessage` auto-resumes in the background without a new `Agent` invocation. The same applies to a subagent that Claude stopped with the `Tas
+5 −3 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
settings-reference
±changed
+9−3
claude-codechanged
settings-reference
When you run `/effort low`, `medium`, `high`, or `xhigh` in an interactive session on your machine, Claude Code saves the level for the active model under [`modelSettings`](#models
When you run `/effort low`, `medium`, `high`, or `xhigh` in an interactive session on your machine, Claude Code saves the level for the active model under [`modelSettings`](#models
Within the same settings file, Claude Code uses a model's saved level rather than this key. [`modelSettings`](#modelsettings) states the cross-file precedence.
+9 −3 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
sessions
±changed
+4−2
claude-codechanged
sessions
| `claude --continue` | Resumes the most recent interactive session in the current directory |
| `claude --continue` | Reopens the most recent conversation in the current directory |
Claude Code leaves sessions created with [`claude -p`](/docs/en/headless) or the [Agent SDK](/docs/en/agent-sdk/overview) out of the session picker and out of `claude --continue`.
Claude Code leaves sessions created with [`claude -p`](/docs/en/headless) or the [Agent SDK](/docs/en/agent-sdk/overview) out of the session picker and out of `claude --continue`.
+4 −2 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
remote-control
±changed
+11−4
claude-codechanged
remote-control
Until you accept Remote Control's one-time confirmation, `claude remote-control` explains what it does and asks `Enable Remote Control? (y/n)` before starting the server. Answe
Until you accept Remote Control's one-time confirmation, a dialog appears before `/remote-control` connects. Select **Enable Remote Control** to accept and connect. If you sele
* **Pulling a session with `/teleport`**: when you pull a [Claude Code on the web session](/docs/en/claude-code-on-the-web#from-web-to-terminal) into your terminal with `/teleport`
+11 −4 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
model-config
±changed
+51−28
claude-codechanged
model-config
| **`best`** | Uses the latest Fable model where it's available to you, otherwise the same model as `opus`
| **`fable`** | Uses the latest Fable model for your hardest and longest-running tasks
| **`best`** | Uses the model the [`fable` alias resolves to](#fable-alias-resolution) where Fable is available to you, otherwise the same model as `opus`
| **`fable`** | Uses the [Fable model for your provider](#fable-alias-resolution) for your hardest and longest-running tasks
Unless you set `ANTHROPIC_DEFAULT_FABLE_MODEL`, the `fable` alias resolves to Fable 5.1. Before v2.1.255, it resolved to Fable 5.
+51 −28 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
managed-mcp
±changed
+5−5
claude-codechanged
managed-mcp
* In [cloud sessions](/docs/en/claude-code-on-the-web) on a host where the file is deployed, such as a [self-hosted runner](/docs/en/self-hosted-environments-configuration#mcp-serv
* In [cloud sessions](/docs/en/claude-code-on-the-web) on a host where the file is deployed, such as a [self-hosted runner](/docs/en/self-hosted-environments-configuration#mcp-serv
Claude Desktop has a managed setting with the same name whose value is an array of a different entry shape, so don't copy one into the other. Claude Code doesn't accept the array f
Claude Desktop has a managed setting with the same name whose value is an array of a different entry shape, so don't copy one into the other. Claude Code doesn't accept the array f
* A server a user passes with `--mcp-config` under the same name replaces the provided one for that run and is checked against `allowedMcpServers` like any server the user adds.
+5 −5 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
interactive-mode
±changed
+14−11
claude-codechanged
interactive-mode
* On macOS and Linux, Claude Code terminates running background tasks when the operating system signals memory pressure, provided the session has been idle for at least 30 minutes
* On macOS and Linux, Claude Code terminates running background tasks when the operating system signals memory pressure, provided the session has been idle for at least 30 minutes
* Background commands owned by a [subagent](/docs/en/sub-agents) have no time limit, except that a command owned by a subagent running in the foreground ends when that subagent giv
To return to the overlay after dismissing it, run `/btw` with no question. The overlay reopens on your most recent exchange. Press `Left` to step back through earlier answers. Befo
To return to the overlay after dismissing it, run `/btw` with no question. The overlay reopens on your most recent exchange. Before v2.1.212, `/btw` without a question printed a us
+14 −11 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
headless
±changed
+1−1
claude-codechanged
headless
Use `--continue` to continue the most recent conversation, or `--resume` with a session ID to continue a specific conversation. `--continue` skips [background sessions](/docs/en/se
Use `--continue` to continue the most recent conversation, or `--resume` with a session ID to continue a specific conversation. On Claude Code v2.1.257 or later, when you pass `--c
+1 −1 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
glossary
±changed
+1−1
claude-codechanged
glossary
A setting that controls how much of the adaptive-reasoning thinking budget Claude uses on each turn. Higher effort means more thinking tokens and deeper reasoning; lower effort is
A setting that controls adaptive reasoning, which lets the model decide whether and how much to think on each step. Higher effort means more thinking tokens and deeper reasoning; l
+1 −1 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
errors
±changed
+20−1
claude-codechanged
errors
| `Model switch ... blocked by a PreModelSwitch hook`
The messages name the session's Fable model, so on Fable 5 they read `continuing on Fable 5` and `Fable 5 now uses usage credits`. Before v2.1.255, the first message began `Fable 5
The messages name the session's Fable model, so on Fable 5 they read `continuing on Fable 5` and `Fable 5 now uses usage credits`. Before v2.1.257, the first message began `Fable 5
### Model switch was blocked by a PreModelSwitch hook
+20 −1 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
env-vars
±changed
+2−2
claude-codechanged
env-vars
| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Maximum lifetime in milliseconds for a [background shell command](/docs/en/interactive-mode#background-bash-commands) th
| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Removed in v2.1.260 and now a no-op. Previously capped how long a [background shell command](/docs/en/interactive-mode#b
| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Override region for Claude Fable 5.1 when using Google Cloud's Agent Platform. Added in v2.1.255
| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Override region for Claude Fable 5.1 when using Google Cloud's Agent Platform. Added in v2.1.257
+2 −2 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
costs
±changed
+5−1
claude-codechanged
costs
Extended thinking is enabled by default because it significantly improves performance on complex planning and reasoning tasks. Thinking tokens are billed as output tokens, and the
Extended thinking is enabled by default because it significantly improves performance on complex planning and reasoning tasks. Thinking tokens are billed as output tokens, and the
For simpler tasks where deep reasoning isn't needed, you can reduce costs by lowering the [effort level](/docs/en/model-config#adjust-effort-level) with `/effort` or in `/model`, o
+5 −1 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
context-window
±changed
+3−1
claude-codechanged
context-window
If you need a larger window rather than a smaller conversation, Fable 5.1, Fable 5, Sonnet 5, Opus 4.6 and later, and Sonnet 4.6 support a 1 million token context window. See [Exte
If you need a larger window rather than a smaller conversation, Fable models, Sonnet 5, Opus 4.6 and later, and Sonnet 4.6 support a 1 million token context window. See [Extended c
Sonnet 5 runs with the 1M context window and has no `[1m]` variant to select. See [Sonnet 5 context window](/docs/en/model-config#sonnet-5-context-window) for its auto-compaction t
+3 −1 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
communications-kit
±changed
+4−2
claude-codechanged
communications-kit
formatting, and mechanical edits where speed wins. *Fable* is the most
formatting, and mechanical edits where speed wins.
*Fable* is the most
| Fable | The hardest, longest-running tasks. Opt-in only: select it with `/model fable`. Cybersecurity or biology content [falls back to Opus](/docs/en/model-config#automatic-mod
+4 −2 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
cli-reference
±changed
+1−1
claude-codechanged
cli-reference
| `--continue`, `-c` | Load the most recent conversation in the current directory, skipping [background sessions, sessions created with `claude -p` or
| `--continue`, `-c` | Load the most recent conversation in the current directory, including a [background session that has finished](/docs/en/sessions
+1 −1 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
claude-security
±changed
+1−1
claude-codechanged
claude-security
**You may see "Fable 5.1's safeguards flagged this message" or "Fable 5's safeguards flagged this message" when using a Fable model.** Due to Fable's cybersecurity safety classifie
**You may see a "safeguards flagged this message" notice when scanning on a Fable model.** The message names the model, for example "Fable 5.1's safeguards flagged this message". F
+1 −1 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
artifacts
±changed
+1−1
claude-codechanged
artifacts
After the first publish, Claude prints the URL, and your browser opens to the new page. Press `Ctrl+]` at any time to reopen the most recent artifact from the terminal.
After the first publish, Claude prints the URL, and your browser opens to the new page. If you sent the prompt through [Remote Control](/docs/en/remote-control) from claude.ai, Cla
+1 −1 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
advisor
±changed
+1−1
claude-codechanged
advisor
Fable 5.1 requires Claude Code v2.1.255 or later and Fable 5 requires v2.1.170 or later, plus [Fable access](/docs/en/model-config#work-with-fable).
Fable 5.1 requires Claude Code v2.1.257 or later, and Fable 5 requires v2.1.170 or later. Both require [Fable access](/docs/en/model-config#work-with-fable).
+1 −1 lines
Recorded here 9 Sep 2026 17:07 UTC
claude-code
vs-code
±changed
+17−13
claude-codechanged
vs-code
* **Model**: select **Switch model…** from the command menu to change the model mid-session. You can also click the model name at the bottom of the prompt box to open the same pick
* **Model**: select **Switch model…** from the command menu to change the model mid-session. You can also click the model name at the bottom of the prompt box to open the same pick
To create a custom style instead, select **Build a custom style** from the **Output styles** menu. Claude Code writes the [style file](/docs/en/output-styles#create-a-custom-ou
When you flip the toggle, the change applies to the sessions already open in VS Code, not only to sessions you start afterwards. If you turn it off, the open sessions disconnec
+17 −13 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
settings-reference
±changed
+34−5
claude-codechanged
settings-reference
| [`allowedMcpServers`](#allowedmcpservers) | Allowlist which [MCP servers](/docs/en/mcp) people can use
| [`allowedMcpServers`](#allowedmcpservers) | Allowlist which [MCP servers](/docs/en/mcp) users can add
| [`managedMcpServers`](#managedmcpservers) | Provide remote [MCP servers](/docs/en/managed-mcp#provide-servers-through-
Lock the `mcp` surface. Claude Code stops loading MCP servers from `~/.claude.json` and `.mcp.json`, and keeps loading plugin MCP servers and [`managed-mcp.json`](/docs/en/managed-
Lock the `mcp` surface. Claude Code stops loading MCP servers from `~/.claude.json` and `.mcp.json`, and keeps loading plugin MCP servers, [`managed-mcp.json`](/docs/en/managed-mcp
+34 −5 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
settings-example
±changed
+3−3
claude-codechanged
settings-example
// name any server "github". Servers that don't match don't load, which includes every
// stdio server when the list has only URL entries; the lock below makes this managed
// list the only allowlist that counts
// name any server "github". User-added servers that don't match don't load, including
// every stdio server when the list has only URL entries. The allowManagedMcpServersOnly
+3 −3 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
sessions
±changed
+8−7
claude-codechanged
sessions
| Command | What it does |
| :-------------------------- | :------------------------------------------------------------------------ |
| `claude --continue` | Resumes the most recent interactive session in the current directory |
| `claude --resume` | Opens the [session picker](#use-the-session-picker) |
| `claude --resume <name>` | Resumes the named session directly |
+8 −7 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
server-managed-settings
±changed
+21−16
claude-codechanged
server-managed-settings
* A [`managed-mcp.json`](/docs/en/managed-mcp) file can't be distributed through server-managed settings. Deliver the `allowedMcpServers` and `deniedMcpServers` policy keys there i
* You can't distribute a [`managed-mcp.json`](/docs/en/managed-mcp) file through server-managed settings. Deliver the `allowedMcpServers` and `deniedMcpServers` policy keys there i
Claude Code reads a `managed-mcp.json` deployed at its [system path](/docs/en/managed-mcp#exclusive-control-with-managed-mcp-json) separately from the managed settings tier, so t
* **Cross-source lock keys**: a small set of keys, such as the sandbox allowlist locks, [listed on the managed settings page](/docs/en/managed-settings#precedence-within-the-manage
+21 −16 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
self-hosted-environments-configuration
±changed
+15−14
claude-codechanged
self-hosted-environments-configuration
| Variable | Description
| :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------
| `CLAUDE_RUNNER_SESSION_ID` | Session ID in the tagged `session_...` form
| `CLAUDE_RUNNER_SESSION_UUID` | The same session ID in canonical UUID form
| `CLAUDE_RUNNER_EXIT_REASON` | How the session ended; see the values below the table
+15 −14 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
prompt-caching
±changed
+8−2
claude-codechanged
prompt-caching
[Automatic model fallback](/docs/en/model-config#automatic-model-fallback) on Fable 5.1, Fable 5, and Opus 5 is also a model switch. When a safety classifier flags a request and th
[Automatic model fallback](/docs/en/model-config#automatic-model-fallback) on Fable models and Opus 5 is also a model switch. When a safety classifier flags a request in a category
When a skill or command's frontmatter names a [`model`](/docs/en/skills#frontmatter-reference) other than the session's current model, that turn is also a model switch: the next re
+8 −2 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
plugins-reference
±changed
+3−1
claude-codechanged
plugins-reference
When a plugin updates mid-session, hook commands, monitors, MCP servers, and LSP servers keep using the previous version's path. Run `/reload-plugins` to switch hooks, MCP servers,
When a plugin updates mid-session, hook commands, monitors, MCP servers, and LSP servers keep using the previous version's path. Run `/reload-plugins` to switch hooks, MCP servers,
For a plugin with a `command` source, Claude Code [can reload the plugin itself](/docs/en/plugin-marketplaces#when-claude-code-re-runs-the-command).
+3 −1 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
plugins
±changed
+1−1
claude-codechanged
plugins
As you make changes to your plugin, run `/reload-plugins` to pick up the updates without restarting. This reloads plugins, skills, agents, hooks, plugin MCP servers, and plugin LSP
As you make changes to your plugin, run `/reload-plugins` to pick up the updates without restarting. This reloads plugins, skills, agents, hooks, plugin MCP servers, and plugin LSP
+1 −1 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
output-styles
±changed
+1−1
claude-codechanged
output-styles
A custom output style is a Markdown file: frontmatter for metadata, then the instructions to add to the system prompt.
A custom output style is a Markdown file: frontmatter for metadata, then the instructions to add to the system prompt. In the VS Code extension, you can also create the file from t
+1 −1 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
mcp
±changed
+9−4
claude-codechanged
mcp
* `disabledMcpServers`: an opt-out list for user-configured servers, plugin servers, the claude.ai connectors Claude Code [fetches itself](#how-connectors-reach-claude-code), and b
* `disabledMcpServers`: an opt-out list for user-configured servers, plugin servers, servers your organization [provides through managed settings](/docs/en/managed-mcp#provide-serv
* If you enable or disable a plugin during a session, run `/reload-plugins` to connect or disconnect its MCP servers. When you reload, Claude Code keeps the live connections of p
* If you enable or disable a plugin during a session, run `/reload-plugins` to connect or disconnect its MCP servers. In a session without an interactive terminal, the reload doe
* When you reload, Claude Code keeps the live connections of plugin servers whose configuration is unchanged, and does the same when you [replace the session's MCP server list](/
+9 −4 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
managed-settings
±changed
+19−15
claude-codechanged
managed-settings
For managed MCP servers, which you deploy alongside any of these through `managed-mcp.json`, see [Managed MCP configuration](/docs/en/managed-mcp).
For managed MCP servers, which you deploy alongside any of these through `managed-mcp.json` or provide through the [`managedMcpServers`](/docs/en/settings-reference#managedmcpserve
* **[`extraKnownMarketplaces`](/docs/en/settings-reference#extraknownmarketplaces)**: a later entry with the same name replaces the earlier one whole
* **[`extraKnownMarketplaces`](/docs/en/settings-reference#extraknownmarketplaces) and [`managedMcpServers`](/docs/en/settings-reference#managedmcpservers)**: a later entry with th
| Provided MCP servers | Combines the server names from every source; when two sources set the same name, applies the higher-ranked source's whole entry
+19 −15 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
managed-mcp
±changed
+155−46
claude-codechanged
managed-mcp
> Restrict which MCP servers users can add or connect to with managed configuration files, allowlists, and denylists.
By default, anyone running Claude Code can connect any [MCP server](/docs/en/mcp) they choose. Anthropic reviews connectors against its [listing criteria](https://claude.com/docs/c
> Restrict which MCP servers users can add or connect to, or provide servers to every user, with managed configuration files, managed settings, allowlists, and denylists.
+155 −46 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
headless
±changed
+2−0
claude-codechanged
headless
In place of the session ID, you can pass `--resume` the absolute path to a session's `.jsonl` [transcript file](/docs/en/sessions#where-transcripts-are-stored), and Claude Code con
+2 −0 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
goal
±changed
+1−1
claude-codechanged
goal
When you resume a session, Claude Code restores a goal that was still active when the session ended. Claude Code restores it on every resume route: `--continue`, `--resume` with a
When you resume a session, Claude Code restores a goal that was still active when the session ended. Claude Code restores it on every resume route: `--continue`, `--resume` with a
+1 −1 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
discover-plugins
±changed
+6−1
claude-codechanged
discover-plugins
Claude Code reloads all active plugins and shows counts for plugins, skills, agents, hooks, plugin MCP servers, and plugin LSP servers. In the skills count, Claude Code includes ev
`/reload-plugins` also runs in sessions without an interactive terminal, such as the desktop app, the Agent SDK, and [non-interactive mode](/docs/en/headless) with `-p`. Requires C
* The command runs only when you type it directly into the session, such as in the `-p` prompt or the desktop app's prompt box. When you send it over a remote connection instead, s
* The reload doesn't connect or disconnect plugin MCP servers. Those changes take effect in your next session.
+6 −1 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
desktop
±changed
+13−13
claude-codechanged
desktop
Auto mode is available to all users on the Anthropic API and requires Claude Opus 4.6 or later, Sonnet 4.6 or later, or a Fable model. Organization administrators can turn auto mod
Auto mode is available to all users on the Anthropic API and requires Claude Opus 4.6 or later, Sonnet 4.6 or later, or a [Fable model](/docs/en/model-config#work-with-fable). Orga
| Key | Description
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------
| `permissions.disableBypassPermissionsMode` | set to `"disable"` to prevent users from enabling Bypass permissions mode.
+13 −13 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
commands
±changed
+114−114
claude-codechanged
commands
No line of the body moved in this read.
+114 −114 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
code-review
±changed
+5−1
claude-codechanged
code-review
* `--comment`: posts the findings as inline PR comments
* `--comment`: posts the findings on a GitHub pull request as inline comments, or on a GitLab merge request as a single note
When you pass `--comment` for a GitLab merge request, Claude Code posts the findings through GitLab's `glab` CLI. Requires Claude Code v2.1.257 or later. When `glab` isn't inst
+5 −1 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
cli-reference
±changed
+1−1
claude-codechanged
cli-reference
| `--resume`, `-r` | Resume a specific session by ID or name, or show an interactive picker to choose a session. The picker and name search include s
| `--resume`, `-r` | Resume a specific session by ID or name, or show an interactive picker to choose a session. In place of an ID, you can pass the
+1 −1 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
claude-apps-gateway-config
±changed
+70−56
claude-codechanged
claude-apps-gateway-config
| `trusted_proxies` | No | CIDRs or IPs of load balancers in front of the gateway. When set, the gateway trusts `X-Forwarded-For` only from these peers
| `trusted_proxies` | No | CIDRs or IPs of load balancers in front of the gateway. When set, the gateway trusts `X-Forwarded-For` only from these peers
| Field | Required | Description
| ------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------
| `issuer` | Yes | OIDC discovery base. Must serve discovery at `/.well-known/openid-configuration`. Use HTTPS in production; the gateway accepts an `ht
+70 −56 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
admin-setup
±changed
+1−1
claude-codechanged
admin-setup
| [MCP server control](/docs/en/managed-mcp) | Restrict which MCP servers users can add or connect to, or deploy a fixed set
| [MCP server control](/docs/en/managed-mcp) | Restrict which MCP servers users can add or connect to, deploy a fixed set, or provi
+1 −1 lines
Recorded here 9 Sep 2026 16:37 UTC
claude-code
settings-reference
±changed
+13−12
claude-codechanged
settings-reference
| Kind of key | How Claude Code combines it
| :----------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------
| Lists | Combines entries from every source
| Locks | Applies the strictest value any source sets. When no source sets a strict value, applies a looser value only from the highest source
| Restriction allowlists | Takes the list whole from the highest source that sets it, without adding entries from lower sources. When the highest source doesn't
+13 −12 lines
Recorded here 9 Sep 2026 16:07 UTC
claude-code
changelog
±changed
+4−0
claude-codechanged
changelog
<Update label="2.1.266" description="September 8, 2026">
* Fixed a 2.1.265 regression affecting LLM-gateway and proxy setups: the undocumented `CLAUDE_CODE_USE_GATEWAY` environment variable, previously ignored unless `ANTHROPIC_BASE_UR
</Update>
+4 −0 lines
Recorded here 9 Sep 2026 00:07 UTC
8 Sep 2026
34 pages
+247 −193 lines
claude-code
changelog
±changed
+53−0
claude-codechanged
changelog
<Update label="2.1.265" description="September 8, 2026">
* Added `user.email` and `user.groups` to the telemetry Claude Desktop and Cowork send through a Claude apps gateway, matching terminal sessions
* Added support for pointing `--plugin-dir` at a folder of plugins: each child folder with a manifest loads, and children added or removed while running are picked up
* Added a 1 GB cap on tool results saved to disk; the in-conversation preview says when a saved file was truncated
+53 −0 lines
Recorded here 8 Sep 2026 21:07 UTC
claude-code
web-changelog
−removed
+0−19
claude-coderemoved
web-changelog
No line of the body moved in this read.
+0 −19 lines
Recorded here 8 Sep 2026 19:37 UTC
claude-code
settings-reference
±changed
+1−1
claude-codechanged
settings-reference
Claude Code builds the style into the system prompt once per conversation. An edit to this key takes effect after you run `/clear` or start a new session.
If you change this key during a session, Claude uses the new style starting with your next message. That message rebuilds the [prompt cache](/docs/en/prompt-caching#changing-output
+1 −1 lines
Recorded here 8 Sep 2026 19:07 UTC
claude-code
prompt-caching
±changed
+15−13
claude-codechanged
prompt-caching
| Layer | Content | Changes when |
| --------------- | ------------------------------------------------- | ---------------------------------------------------------------------- |
| System prompt | Core instructions, tool definitions, output style | The set of loaded tool definitions changes, or Claude Code is upgraded |
| Project context | CLAUDE.md, auto memory, unscoped rules | Session starts, or after `/clear` or `/compact` |
| Conversation | Your messages, Claude's responses, tool results | Every turn |
+15 −13 lines
Recorded here 8 Sep 2026 19:07 UTC
claude-code
output-styles
±changed
+2−2
claude-codechanged
output-styles
Output style is part of the system prompt, which Claude Code reads once at session start. Changes take effect after `/clear` or a new session. See [How Claude Code uses prompt cach
When you switch styles mid-session, Claude uses the new style starting with your next message. The style is part of the system prompt, so that first message rebuilds the [prompt ca
Run `/config` in the terminal and select your style under **Output style**, or set `outputStyle` in a settings file to the style's name. It takes effect after `/clear` or the n
Run `/config` in the terminal and select your style under **Output style**. Claude uses the new style starting with your next message. In the terminal, Claude Code reads style
+2 −2 lines
Recorded here 8 Sep 2026 19:07 UTC
claude-code
claude-directory
±changed
+3−3
claude-codechanged
claude-directory
when: 'Applied at session start when selected via the outputStyle setting',
when: 'Files read at startup; the style you select with outputStyle is added to the system prompt every turn',
when: 'Applied at session start when selected via the outputStyle setting',
when: 'Files read at startup; the style you select with outputStyle is added to the system prompt every turn',
tips: ['Built-in styles Default, Proactive, Concise, Explanatory, and Learning are included with Claude Code; custom styles go here', <>Set <C>keep-coding-instructions: t
+3 −3 lines
Recorded here 8 Sep 2026 19:07 UTC
claude-code
skills
±changed
+71−86
claude-codechanged
skills
### Where skills live
Where you store a skill determines who can use it:
| Location | Path | Applies to |
+71 −86 lines
Recorded here 8 Sep 2026 18:37 UTC
Nothing on this page matches that. Press Enter to search every page of the ledger.