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 SDK AgentDefinition, 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_MENTIONS setting 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 virtualText prompt decorations, $.ui.view({ agentId }) to show an agent's transcript in the main view, a dir prop on Text for right-to-left text, and a prompt.change hook for non-typed prompt changes (history recall, clear, undo, plugin fill)
  • The agent.spawn mod hook can now rewrite a workflow agent's prompt and model
  • OpenTelemetry: api_request events now include cache_creation_5m_tokens and cache_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 /advisor on Claude Platform on AWS (opt in with /advisor, advisorModel or --advisor; CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 turns it off)
  • VS Code: added the claudeCode.attachSelection setting 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 updatedInput from 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=0 turns 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 gateway stops at start on a desktop: policy key Claude Desktop can't use from a gateway
  • Removed the no-op --sandbox and --no-sandbox flags from claude remote-control; passing either now exits with an error

Major bug fixes

  • Fixed agent hooks ignoring their model setting
  • Fixed --worktree starting 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 stop reporting 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: false keeps 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]

  • Added a pointer to the new OpenTelemetry for the Claude API guide. [line 16] [Source]

agent-sdk/subagents [Source]

  • New autoCompactWindow field on AgentDefinition (100000 to 1000000; TypeScript SDK v0.3.296+; not in Python). [line 149] [Source]

agent-sdk/typescript [Source]

  • Added autoCompactWindow to the AgentDefinition type and table. [lines 1099-1120] [Source]
  • Peer message body is 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 acceptEdits mode, Claude asks before publishing if the edit needs approval, even when an allow rule covers Artifact. [lines 65-69] [Source]

claude-code-on-the-web [Source]

  • Network secrets are no longer described as Pro/Max only. [line 353] [Source]

claude-directory [Source]

  • autoCompactWindow added to the supported agents/*.md frontmatter keys. [line 1294] [Source]

claude-projects [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 in ProxyCommand, shell variables in ProxyCommand, Match host quirks, forwarding settings Desktop disables, and forwarding a port with ssh -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 autoPort default 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/gh must 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, autoPort default, archive approval behavior). See above.

env-vars [Source]

  • New CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS: set to 0 to stop applying artifact edits during publishing (v2.1.300+). [line 208] [Source]

errors [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]

  • Replacing the system prompt in -p runs also drops the git status snapshot. [line 358] [Source]

hooks [Source]

  • CLAUDE_CODE_DISABLE_FILE_MENTIONS=1 makes @ 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]

  • /mcp status guidance updated to describe a checkmark or ✘ instead of connected/failed. [line 701] [Source]

model-config [Source]

  • Added per-subagent auto-compact window to the places you can set it. [line 776] [Source]

monitoring-usage [Source]

  • Added a pointer to OpenTelemetry for the Claude API / Managed Agents. [line 7] [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]

plugins/components [Source]

plugins/mods/reference [Source]

  • New next.error.cause field for re-entry errors (rewritten, lent). [lines 36-37] [Source]
  • New skill.prompt fields: 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]

  • CronList now shows next run times, and the CronCreate row 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_CONFIG variable 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-min and --exit-if-unused-min. A hook still running at --hook-timeout counts as a retryable failure. [lines 300-324] [Source]
  • Wrappers can pass --mcp-config after "$@". [line 453] [Source]

self-hosted-environments-deploy [Source]

  • --git-ssh-rewrite also suits runner hosts that have only an SSH key. [line 311] [Source]
  • New troubleshooting for TLS certificate errors (RegisterRunner failed:, poll failed:) fixed with NODE_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-min and the orchestrator /healthz last_error field. [lines 49-143] [Source]

settings-reference [Source]

  • includeGitInstructions: the git status snapshot is omitted when the system prompt is replaced in -p runs 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 autoCompactWindow frontmatter field (v2.1.296+) and a "Set the auto-compact window for one subagent" section (write plain integers, 200k is misread as 200). [line 295, lines 1126-1148]
  • How to find misspelled frontmatter fields via claude --debug. [lines 281-284] [Source]

vs-code [Source]

  • New troubleshooting section for a blank resumed conversation. [line 783] [Source]

web-quickstart [Source]

  • You can add multiple repositories to work across them in one session. [line 125] [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, and sessions/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 in api/compliance and api/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_identity to {"type": "aws_role", ...} on the agent, with trust policy, role permissions (aws-external-anthropic:CreateSession), and iam:PassRole requirements. [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 ant CLI version in cli-sdks-libraries/cli/quickstart and the Managed Agents quickstart and self-hosted-sandboxes-workers pages 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 intro is now "Claude Console".