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,
Readdeny 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
mantleupstream for Amazon Bedrock's Mantle endpoint. It also addsenforceAvailableModelsso the Default model resolves inside a policy'savailableModels. - New
CLAUDE_CODE_SUBPROCESS_ENV_SCRUBdocumentation 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
PreToolUsehook can answerAskUserQuestionthroughupdatedInput, and howifpatterns match Bash commands.
New Claude Code versions
2.1.289
New features
- Added
agent.spawnfor 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
Clientthat fails while drawn now fails alone and raisesui.faultinstead 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
Readdeny 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 evalandplugin updateshowing 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 validateskipping a plugin when the folder also holds a marketplace manifest - [VSCode] Reverted a 2.1.288 change to
claude auth statusthat 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
disallowedToolsandeffort. [lines 252-265] [Source]
amazon-bedrock [Source]
- New section on how startup model checks behave when
enforceAvailableModelsis set. Entries must use inference profile IDs with region prefixes. [lines 345-359] [Source]
claude-apps-gateway-config [Source]
- New
mantleupstream provider for Amazon Bedrock's Mantle endpoint (needs v2.1.283+). It documents fields, model-scoped routing, and that guardrail andassume_roledon'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]
availableModelsis enforced server-side at/v1/messages. A new section explains how to start sessions on an allowed model withenforceAvailableModels: 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_GCandCLAUDE_CODE_WORKER_CHECKIN_SCHEDULE. The last replaces the removedCLAUDE_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_TOKENand 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
ifpatterns match Bash commands" section. LeadingVAR=valueassignments are stripped before matching. [lines 407-421] [Source] - New section "Tools that require user interaction". A
PreToolUsehook can answerAskUserQuestionorExitPlanModeby returningallowwithupdatedInput, with an example. MCP tools markedrequiresUserInteractioncan't be bypassed. [lines 1800-1832] [Source] - Top-level
decisionandreasonon PreToolUse are deprecated. UsehookSpecificOutput.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,envisn't compared, and hostnames are case-insensitive. [lines 265-310] [Source] - Policy entries expand
${VAR}from a pinned environment (v2.1.219+). Servers frommanagedMcpServersskip 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=0behavior 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_promptevent gains aprompt_textattribute. The security notes explain how to drop both with a Collector processor. [lines 737-1567] [Source]
permission-modes [Source]
- Protected directory exceptions:
.claude/worktreesand auto memory markdown files. Critical-path removal checks now look inside inline-cscripts. [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.