Claude docs changes for Oct, 4th 2026 [diff]

Executive Summary

  • Claude Code 2.1.289 fixes several permission-rule bypasses: Bash deny/ask rules under sandbox auto-allow, Read deny rules through symlinks in the IDE, and managed-machine deny rules on nested commands. It also hardens plugins and mods.
  • The Claude Apps gateway adds a mantle upstream for Amazon Bedrock's Mantle endpoint. It also adds enforceAvailableModels so the Default model resolves inside a policy's availableModels.
  • New CLAUDE_CODE_SUBPROCESS_ENV_SCRUB documentation explains how credentials are stripped from Bash, hook and MCP subprocess environments.
  • Cloud sessions docs are reorganized. They add Quick web setup for Team and Enterprise, sending follow-ups from the CLI, a diff review view, and a table of send errors.
  • Hooks docs now explain how a PreToolUse hook can answer AskUserQuestion through updatedInput, and how if patterns match Bash commands.

New Claude Code versions

2.1.289

New features

  • Added agent.spawn for teammates, one agent id across plugin hook events, and idle and waiting states in $.agent.list()

Existing feature improvements

  • Large files open faster in a plugin code pane
  • Clearer error message when a mod's band or pane fails to draw, naming the mod
  • A mod's Client that fails while drawn now fails alone and raises ui.fault instead of taking down everything around it

Major bug fixes

  • Fixed deny or ask rules on a nested part of a compound shell command not holding over a user-installed mod's approval on managed machines
  • Fixed Bash deny and ask rules missing a command behind an environment variable prefix, or after a bare variable assignment, when the sandbox auto-allows commands
  • Fixed Read deny rules not applying to files @-mentioned, changed, or selected in the IDE through a symlink
  • Fixed a user-installed plugin being able to rewrite descriptions of an organization-managed MCP server's sign-in tools
  • Fixed the terminal freezing on short code blocks with many unclosed <script> tags, including in published artifact pages
  • Fixed installed mods not loading in the first session after an upgrade
  • Fixed plugin list, plugin eval and plugin update showing a stale copy of a plugin installed from a local folder marketplace
  • Fixed sessions ending with an interface error or "unrecoverable interface error" caused by plugin or mod rendering failures
  • Fixed claude plugin validate skipping a plugin when the folder also holds a marketplace manifest
  • [VSCode] Reverted a 2.1.288 change to claude auth status that may have made sign-outs more frequent

Claude Code changes

New Documents

None.

Changed documents

agent-sdk/mcp [Source]

  • New troubleshooting section: a tool is left out of an SDK MCP server's list, with a warning, when its input schema can't be converted to JSON Schema. Before TypeScript SDK v0.3.286 the whole listing failed. [lines 820-831] [Source]

agent-teams [Source]

  • Teammates inherit the lead's effort level by default, and a teammate's model and fast mode are fixed at spawn. [line 149] [Source]
  • Teammates can reference subagent types from any scope. In-process teammates honor the definition's disallowedTools and effort. [lines 252-265] [Source]

amazon-bedrock [Source]

  • New section on how startup model checks behave when enforceAvailableModels is set. Entries must use inference profile IDs with region prefixes. [lines 345-359] [Source]

claude-apps-gateway-config [Source]

  • New mantle upstream provider for Amazon Bedrock's Mantle endpoint (needs v2.1.283+). It documents fields, model-scoped routing, and that guardrail and assume_role don't apply to it. [lines 445-481] [Source]
  • Guardrails cover Bedrock upstreams only. A Bedrock role's upstream is usable by every admitted developer. [line 360] [Source]
  • availableModels is enforced server-side at /v1/messages. A new section explains how to start sessions on an allowed model with enforceAvailableModels: true. [lines 825-870] [Source]

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

  • Reorganized intro, with pointers to projects, Remote Control and environment setup. [lines 9-35] [Source]
  • New "Quick web setup for Team and Enterprise" org setting: enables /web-setup, skips the GitHub App prompt, and creates the Default environment. [lines 56-67] [Source]
  • Projects need the Claude GitHub App on each repository they clone. [line 47] [Source]
  • Follow-ups can be sent to a running cloud session from the CLI. Teleport needs a checkout of the same repository (not a fork) and claude.ai authentication. [lines 156-218] [Source]
  • New sections: permission modes in cloud sessions, reviewing changes (diff view with Compare against), and taking back a queued message. [lines 223-281] [Source]
  • Sharing rules are restated as lists per account type. [lines 283-292] [Source]
  • New troubleshooting for claude.ai sign-in errors and a table of errors when sending to a cloud session. An expired environment restores history but not background work. [lines 366-403] [Source]

env-vars [Source]

  • New variables: CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT, CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK, CLAUDE_CODE_SUBPROCESS_ENV_SCRUB, CLAUDE_CODE_TRANSCRIPT_LOCAL_GC and CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE. The last replaces the removed CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS. [lines 203-403] [Source]
  • New section "What the subprocess environment scrub removes". It covers which variables are removed or kept, such as GITHUB_TOKEN and proxies, and the Linux PID namespace isolation. [lines 513-538] [Source]
  • The first session after an install or upgrade can miss flag-gated features and start in a different permission mode. This also describes the setups where later sessions are affected. [lines 566-575] [Source]

errors [Source]

  • New configuration warning: denying Bash also turns off the PowerShell tool, with fixes. [lines 5336-5350] [Source]

hooks [Source]

  • New "How if patterns match Bash commands" section. Leading VAR=value assignments are stripped before matching. [lines 407-421] [Source]
  • New section "Tools that require user interaction". A PreToolUse hook can answer AskUserQuestion or ExitPlanMode by returning allow with updatedInput, with an example. MCP tools marked requiresUserInteraction can't be bypassed. [lines 1800-1832] [Source]
  • Top-level decision and reason on PreToolUse are deprecated. Use hookSpecificOutput.permissionDecision. [line 1794] [Source]

keybindings [Source]

  • New agent view actions (v2.1.288+): agents:find, agents:rename, agents:previousGroup, agents:nextGroup. [lines 411-414] [Source]

managed-mcp [Source]

  • Restructured allowlist matching into per-type sections (serverName, serverCommand, serverUrl). It adds that commands must match exactly, env isn't compared, and hostnames are case-insensitive. [lines 265-310] [Source]
  • Policy entries expand ${VAR} from a pinned environment (v2.1.219+). Servers from managedMcpServers skip the allowlist. [lines 243-335] [Source]
  • New "How a server is evaluated" section: merge lists, check denylist, check allowlist. [lines 332-356] [Source]

model-config [Source]

  • Availability fallback on Bedrock and Google's Agent Platform respects the allowlist. MAX_THINKING_TOKENS=0 behavior clarified for newer models. [lines 262-690] [Source]

monitoring-usage [Source]

  • New table of content attributes under detailed beta tracing (new_context, system_reminders, tool_input, and others) and the variable each needs. [lines 337-356] [Source]
  • The user_prompt event gains a prompt_text attribute. The security notes explain how to drop both with a Collector processor. [lines 737-1567] [Source]

permission-modes [Source]

  • Protected directory exceptions: .claude/worktrees and auto memory markdown files. Critical-path removal checks now look inside inline -c scripts. [lines 629-684] [Source]

google-vertex-ai [Source]

  • Adds a section on startup model checks under enforceAvailableModels, parallel to the Bedrock page.

Other changed documents

Smaller edits, not itemized, touched these pages: agent-view, claude-apps-gateway, claude-apps-gateway-deploy, code-review, desktop, desktop-changelog, ide-integrations, interactive-mode, managed-settings, plugins/cli-reference, plugins/loading, plugins/mods/reference, self-hosted-environments-deploy, skills, slash-commands, tools-reference, vs-code and web-quickstart.


API changes

No API documentation changes today.