Claude docs changes for October 15th, 2026 [diff]
Executive Summary
- Claude Code 2.1.300 adds new mod hooks and APIs (
prompt.change,virtualText,$.ui.view({ agentId })), OpenTelemetry GenAI span attributes, and a long list of fixes for worktrees, reftable repos, cloud sessions, and hooks. - OpenTelemetry export for the Claude API and Managed Agents launched in beta. New guides cover SDK tracing, API tracing through a Console "destination", and a span reference. The Admin API also gains telemetry destination endpoints.
- Subagents can now set
autoCompactWindow(100k to 1M tokens) in frontmatter, in the Agent SDKAgentDefinition, and for agent-team teammates. - Claude Desktop SSH sessions got extensive new docs: proxy and CA setup, containers via
ProxyCommand, AWS credentials, port forwarding, helper files and processes, fail2ban notes, and a troubleshooting table. - New
CLAUDE_CODE_DISABLE_FILE_MENTIONSsetting stops@references from inlining file contents. Network secrets for cloud environments now cover Team and Enterprise plans.
New Claude Code versions
2.1.300
New features
- Mods: added
virtualTextprompt decorations,$.ui.view({ agentId })to show an agent's transcript in the main view, adirprop onTextfor right-to-left text, and aprompt.changehook for non-typed prompt changes (history recall, clear, undo, plugin fill) - The
agent.spawnmod hook can now rewrite a workflow agent'spromptandmodel - OpenTelemetry:
api_requestevents now includecache_creation_5m_tokensandcache_creation_1h_tokens, and trace spans carry GenAI semantic-convention attributes (gen_ai.provider.name,gen_ai.conversation.id,gen_ai.tool.name,error.type) - Added
/advisoron Claude Platform on AWS (opt in with/advisor,advisorModelor--advisor;CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1turns it off) - VS Code: added the
claudeCode.attachSelectionsetting to stop editor selections being added to messages - Claude Tag: Slack Connect channel support (off by default), a private Allow once / Deny card for connector approvals, and Slack voice clip transcripts
Existing feature improvements
- Artifact updates: small changes are applied and republished in one call
- WebFetch in Cowork cloud sessions tells Claude that a page failed moments ago instead of refetching it
- Hook
updatedInputfrom PreToolUse and PermissionRequest hooks is now validated like Claude's own input: unknown keys are dropped and rejected input denies the call - Large requests to api.anthropic.com use gzip even with telemetry disabled (
CLAUDE_CODE_GZIP_REQUEST_BODIES=0turns it off) - Exit force-kills background commands still running after 1.5 seconds
- Local transcripts now record each API request's system prompt, tools and parameters
claude gatewaystops at start on adesktop:policy key Claude Desktop can't use from a gateway- Removed the no-op
--sandboxand--no-sandboxflags fromclaude remote-control; passing either now exits with an error
Major bug fixes
- Fixed agent hooks ignoring their
modelsetting - Fixed
--worktreestarting from the wrong commit, failing in bare-repo worktrees, and misbehaving in reftable repositories - Fixed a conversation failing on every turn with a 400 when the API rejected an MCP tool's input schema
- Fixed resuming headless or Agent SDK sessions losing compaction summaries or recent messages
- Fixed SessionEnd hooks sometimes not running when exiting with a background command running
- Fixed automatic tool search turning off mid-conversation while MCP servers reconnect
- Fixed
claude daemon stopreporting success while a stuck service kept running - Fixed cloud sessions hanging 5 minutes per turn when the organization's policy can't be read, and several Remote Control and Cowork cloud session issues
- Fixed several VS Code issues, including fast mode staying on after credits ran out and drag-and-drop file mentions on Windows and WSL
Claude Code changes
New Documents
None.
Changed documents
agent-sdk/modifying-system-prompts [Source]
- Clarified that most, not all, system reminders reach Claude with a custom
systemPrompt. [line 371] [Source] includeGitInstructions: falsekeeps out the built-in commit and PR instructions. With the minimal default, a custom prompt, or a custom main-thread agent, the session starts without the git status snapshot. [line 410] [Source]- Documented
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1(v2.1.299+) to stop only@file mentions from expanding. [line 412] [Source]
agent-sdk/observability [Source]
agent-sdk/subagents [Source]
- New
autoCompactWindowfield onAgentDefinition(100000 to 1000000; TypeScript SDK v0.3.296+; not in Python). [line 149] [Source]
agent-sdk/typescript [Source]
- Added
autoCompactWindowto theAgentDefinitiontype and table. [lines 1099-1120] [Source] - Peer message
bodyis absent when several teammate messages are merged (behavior change in v2.1.299). [line 2233] [Source]
agent-teams [Source]
- In-process teammates apply the subagent definition's
autoCompactWindow; split-pane teammates ignore it (v2.1.296+). [line 268] [Source]
artifacts [Source]
- Small edits to an artifact's file can be made and published in one step. In Manual or
acceptEditsmode, Claude asks before publishing if the edit needs approval, even when an allow rule coversArtifact. [lines 65-69] [Source]
claude-code-on-the-web [Source]
claude-directory [Source]
claude-projects [Source]
- Removed the Environment "Connectors" link from project settings. [lines 353-372] [Source]
cloud-environments [Source]
- Network secrets now available on Pro, Max, Team, and Enterprise plans, with role-dependent behavior (Enterprise read-only without an admin role, shared environments managed by Owners). [lines 84-103] [Source]
- New section on adding a secret on a Team plan without an admin role (one host, name, secret type). [lines 125-135] [Source]
- Rewrote the environment selector steps (New environment dialog, editing a running session's environment, Archive environment). [lines 35-48] [Source]
common-workflows [Source]
- Documented
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1(v2.1.299+, ignored in project and local settings). [line 360] [Source]
context-window [Source]
- The git status snapshot is re-read after compaction only if the session started with one. [line 1158] [Source]
desktop [Source]
- Large expansion of SSH session docs: proxy/CA settings for Linux remote machines, reaching containers with
ProxyCommand, AWS credentials inProxyCommand, shell variables inProxyCommand,Match hostquirks, forwarding settings Desktop disables, and forwarding a port withssh -L. [lines 732-940] [Source] - New sections on files and processes Desktop installs on the remote machine, removing the helper, who connected, and connections that close before login (OpenSSH log patterns,
PerSourcePenaltyExemptList, fail2ban). [lines 1096-1218] [Source] - New troubleshooting table for SSH failures after login and how to get Desktop's
ssh.log. [lines 1636-1664] [Source] - Dev server
autoPortdefault changed: servers now get the next free port instead of Claude asking (Desktop v2.37337.0+), with an exception for hardcoded npm/yarn/pnpm/bun script ports. [lines 586-600] [Source] - Archive approval card is not shown in Auto or Bypass permissions mode. [line 380] [Source]
- In SSH sessions the Browser pane isn't available and
git/ghmust be set up on the remote for Create PR. [lines 112-187] [Source] - Linux remotes need glibc 2.17+ or musl. Managed settings files must be readable by each developer's account. [line 727] [Source]
desktop-changelog [Source]
- Received the same edits as
desktop(SSH session documentation,autoPortdefault, archive approval behavior). See above.
env-vars [Source]
- New
CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS: set to0to stop applying artifact edits during publishing (v2.1.300+). [line 208] [Source]
errors [Source]
- New entry: "Hook needs quotes around a path with a space" for
asyncRewakehooks. [lines 5196-5211] [Source] - New entry: "Skill or command name refused", with debug steps. [lines 5232-5249] [Source]
github-enterprise-server [Source]
- Troubleshooting for "Authentication failed while accessing the repository": connect your own GitHub Enterprise account from the repository picker. [line 193] [Source]
headless [Source]
hooks [Source]
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1makes@paths go through file tools, so matching PreToolUse hooks run. [lines 1670-1675] [Source]
ide-integrations [Source]
- New troubleshooting section: a resumed conversation can be blank at first ("Waiting for your plugins…"). [line 783] [Source]
mcp [Source]
/mcpstatus guidance updated to describe a checkmark or ✘ instead ofconnected/failed. [line 701] [Source]
model-config [Source]
monitoring-usage [Source]
plugin-evals [Source]
- Runs that end on an API error (rate or usage limit) now score 0 without grading and make the command exit non-zero (v2.1.299+). New troubleshooting section. [lines 408-410, lines 729-743]
plugins/cli-reference [Source]
- Eval exit codes updated to include API-error runs. [lines 482-483] [Source]
plugins/components [Source]
plugins/mods/reference [Source]
- New
next.error.causefield forre-entryerrors (rewritten,lent). [lines 36-37] [Source] - New
skill.promptfields:e.source,e.pluginName,e.path,e.frontmatter,e.frontmatterProblem(v2.1.299+). [lines 83-100] [Source]
routines [Source]
- Network secrets guidance now refers to Anthropic-hosted environments rather than Pro/Max plans. [line 74] [Source]
scheduled-tasks [Source]
CronListnow shows next run times, and theCronCreaterow displays the next run. A dynamic loop's pending wakeup appears as a one-shot task that can run slightly early. [lines 68-166] [Source]
self-hosted-environments-configuration [Source]
- New
CLAUDE_CODE_REMOTE_MCP_CONFIGvariable that wrappers must carry over. [line 35] [Source] - New section on quoting arguments and variables in wrapper and hook scripts. [lines 47-53] [Source]
- New "Make on-demand runners exit when idle" section covering
--release-idle-session-min,--kill-session-after-minand--exit-if-unused-min. A hook still running at--hook-timeoutcounts as a retryable failure. [lines 300-324] [Source] - Wrappers can pass
--mcp-configafter"$@". [line 453] [Source]
self-hosted-environments-deploy [Source]
--git-ssh-rewritealso suits runner hosts that have only an SSH key. [line 311] [Source]- New troubleshooting for TLS certificate errors (
RegisterRunner failed:,poll failed:) fixed withNODE_EXTRA_CA_CERTS. [lines 637-642] [Source] - Each person creating sessions must connect their own GitHub, and requeueing after a lost runner can take longer than a few minutes. [line 185] [Source]
self-hosted-environments-quickstart [Source]
- Prerequisite changed: an Owner must turn on the GitHub connector, and each developer connects their own GitHub. [line 18] [Source]
- An SSH key alone isn't enough, because the runner clones the
https://URL. Use a dedicated base directory. The runner exits after serving one session. [lines 25-121] [Source]
self-hosted-environments-reference [Source]
- Clarified
--startup-timeout-minand the orchestrator/healthzlast_errorfield. [lines 49-143] [Source]
settings-reference [Source]
includeGitInstructions: the git status snapshot is omitted when the system prompt is replaced in-pruns or the Agent SDK. [lines 3894-3898] [Source]
skills [Source]
- New section "Characters a skill name can't hold" (zero-width, control, direction-changing,
</>, etc.) and how plugin skills handle them. [lines 453-471] [Source] - Added a troubleshooting step for unrecognized
/skill-name. [line 1168] [Source]
slash-commands [Source]
- Same additions as
skills: refused-name characters section and troubleshooting step. [lines 453-471] [Source]
sub-agents [Source]
- New
autoCompactWindowfrontmatter field (v2.1.296+) and a "Set the auto-compact window for one subagent" section (write plain integers,200kis misread as 200). [line 295, lines 1126-1148] - How to find misspelled frontmatter fields via
claude --debug. [lines 281-284] [Source]
vs-code [Source]
web-quickstart [Source]
workflows [Source]
- Clarified workflow approval: in plan mode a hook's approval alone doesn't start the workflow. [lines 178-181] [Source]
API changes
New Documents
manage-claude/opentelemetry [Source]
Overview of the beta OpenTelemetry export for the Claude API and SDK. It traces Messages API requests, tool uses, and Managed Agents sessions using GenAI semantic conventions. It compares SDK tracing, API tracing, and both together, and includes example traces.
manage-claude/opentelemetry/api [Source]
How to add an OpenTelemetry destination in the Console, Admin API, or CLI. It covers choosing workspaces, verifying that spans arrive, connecting API spans to your own traces, delivery and health, limits, and troubleshooting. It is available on Claude Platform on AWS and is not ZDR eligible for Managed Agents.
manage-claude/opentelemetry/sdk [Source]
How to trace SDK requests and tool-runner tool uses. Install the SDK, register a tracer provider, and export spans to your platform. Notes that options and span schema can change during the beta.
api/opentelemetry/spans [Source]
Span reference listing span names, kinds, and attributes for SDK spans and API spans (service.name claude-platform).
api/beta/organization/telemetry_destinations [Source]
New Admin API reference (plus per-method pages for create, retrieve, list, update, delete, test, and workspaces add/list/remove) for registering OpenTelemetry destinations. An organization can have at most 10 destinations, and each starts enabled. Pages are also added for the CLI and the other SDK languages.
Changed documents
api/beta (SDK/CLI reference) [Source]
- Large expansion of the beta reference (thousands of lines), with new pages for
agents,sessions,sessions/threads, andsessions/events. Matching pages were added for the CLI (cli/beta) and C# (csharp/beta), and many SDK method pages gained links.
api/claude-platform-on-aws-iam-actions [Source]
- Added a "Telemetry destinations" section with nine IAM actions (
CreateAccountTelemetryDestination,TestAccountTelemetryDestination, and others) and their scoping rules. [lines 215-232] [Source]
api/compliance/activities/list [Source]
- New activity type
org_hipaa_artifacts_terms_accepted(an owner accepted the terms for artifacts with HIPAA configuration). The same change appears inapi/complianceandapi/compliance/activities.
api/beta/organization [Source]
- Added the telemetry destination endpoints to the organization reference.
build-with-claude/claude-platform-on-aws [Source]
- Managed Agents scheduled deployments are now listed as available. [line 538] [Source]
- CloudTrail logs telemetry destination operations as Management events. [line 837] [Source]
managed-agents/scheduled-deployments [Source]
- On Claude Platform on AWS, each run creates its session as an IAM role. Set
execution_identityto{"type": "aws_role", ...}on the agent, with trust policy, role permissions (aws-external-anthropic:CreateSession), andiam:PassRolerequirements. [lines 27-32] [Source]
manage-claude/cmek [Source]
- OpenTelemetry destination request headers are listed among data stored under Anthropic-managed encryption (write-only values).
release-notes/overview [Source]
- October 14, 2026 notes: OpenTelemetry export beta (SDK spans in Python, TypeScript, C#, Go, Java, PHP, Ruby, plus API destinations) and scheduled deployments on Claude Platform on AWS.
SDK version bumps and CLI
- Java SDK examples updated from 2.71.0 to 2.72.0 across
cli-sdks-libraries/sdks/java,get-started,agents-and-tools/mcp-connector, and the Bedrock, Foundry, Vertex, and Claude Platform on AWS pages. - The
antCLI version incli-sdks-libraries/cli/quickstartand the Managed Agentsquickstartandself-hosted-sandboxes-workerspages moved from 1.40.0 to 1.41.0.
Console navigation wording
- Many pages (MCP tunnels, workspaces, API keys, billing, pricing, WIF, CMEK, rate limits, app attest and others) now point to Console pages by name and URL, for example "Billing" and "MCP tunnels", instead of "Settings >" menu paths. "Developer Console" in
introis now "Claude Console".