Claude docs changes for Oct, 1st 2026 [diff]
Executive Summary
- New
allowedProvidersmanaged setting lets admins restrict which API providers (Anthropic, Bedrock, Vertex, Foundry, gateways...) a machine may use - New Plugins API (beta) for inventorying, publishing, versioning, sharing and validating plugins and marketplaces in a Claude Enterprise organization
- Claude Sonnet 4.5 (
claude-sonnet-4-5-20250929) is deprecated, with retirement on November 30, 2026 (replacement:claude-sonnet-5-5) - Claude Code 2.1.286 improves permission prompts and fullscreen lists, retries on the previous model when a model is refused, and adds VS Code bookmarks
- Claude apps gateway can now call Bedrock in another AWS account via
assume_role; Managed Agents examples now use limited networking
New Claude Code versions
2.1.286
New features
- Permission prompts show a count such as "2 of 5" when several requests stack up
- Mouse support for the "N more" rows of lists in fullscreen mode
- [VSCode] Bookmarks: save Claude's responses and keep them in a Bookmarks side panel
- [VSCode] Question cards now show option previews, and answered questions appear in the conversation
- [VSCode] Rows under a message open the terminal output, browser tab and selected code sent with it
- [Claude Tag] Add channel button on the spend limits page to set a limit on any channel
Existing feature improvements
- Commit guidance: if a project or user skill named
verifyexists, Claude runs it right before committing (except docs-only and tests-only commits) - Bash, PowerShell, Monitor, fetch, skill, file read and other permission prompts now match the look of file edit prompts
- Ctrl+G external editor opens on the cursor's line; slash command suggestions are more responsive and match by word prefix
/hooksopens on one list of hooks grouped by event; theme and output style pickers redesigned (number keys no longer pick)- List screens align details in one column, and scrollbars have clickable arrows
- Send now (ctrl+enter) moves the running command of a subagent or skill to the background
- Plugin installs refuse npm sources that are git repositories or folders, and install dependencies only from registry packages
- Failed API requests: one retry limit now covers a whole model call (at most 14 requests with defaults)
--bareconnects only MCP servers named on the command line, sends no system reminders and starts no background tasks- The
claude-apiskill's Managed Agents examples now use limited networking - [VSCode] Stop and Escape end only the current turn; background agents keep running
Major bug fixes
- When the API refuses the model a default or alias resolves to, Claude Code retries once on the previous model of the same tier;
--fallback-modelretries run at standard speed - Fixed
claude --resume/--continuelosing turns after parallel tool calls in a crashed session - Fixed API 400 errors after a tool or hook returned a non-text value
- Fixed multiple processes opening login browsers when gcpAuthRefresh/awsAuthRefresh credentials expire
- Fixed Remote Control sessions staying connected after org policy turns it off
- Fixed secret redaction gaps in logs, transcripts and MCP errors (Bearer/Basic tokens, URL passwords, zero-width characters)
- Fixed
/compact,/clearand/rewindsilently acting on the main conversation while viewing a background agent - Fixed the Claude apps gateway spend meter mispricing 1-hour cache writes and undercounting streamed server-tool turns
- Fixed
claude auth statusreporting a Console API key sign-in asclaude.ai - Fixed several subagent issues (duplicate messages, missing task tools, double CLAUDE.md loading, Workflow subagents restarting)
Claude Code changes
New Documents
None.
Changed documents
agent-sdk/python [Source]
- Added
ClaudeSDKClient.get_context_usage(), returning the same breakdown/contextshows, plus theContextUsageResponsetype. [lines 437-461, lines 1409-1439] query()accepts an async iterable of user message dicts, including content blocks such as images. [line 526] [Source]- Tool output schemas (Edit, Read, Bash timeout semantics) documented in detail. [lines 2665-2745] [Source]
authentication [Source]
- New section on restricting which API providers a machine may use with
allowedProviders, paired withforceLoginMethod/forceLoginOrgUUID. [lines 171-188] [Source]
claude-apps-gateway-config [Source]
- New "Bedrock in another AWS account" section:
assume_roleupstream setting (role_arn,external_id,session_name), trust policy example, requires gateway v2.1.281+. [lines 308-388] [Source] - Clarified which status codes trigger upstream failover and that
bedrock:ApplyGuardrailmust be granted. [line 157, line 300]
mcp [Source]
claude mcp addsuccess output andclaude mcp listhealth statuses explained. [lines 206-238] [Source]- Reserved built-in server names; OAuth credentials sent only to HTTPS or localhost token endpoints. [line 280, line 326]
- Transient first-connection failures retry up to three times; long MCP calls move to a background task visible in
/tasks. [lines 360-411] [Source] - Connector tools set to
blockedare filtered before Claude sees them. [line 1144] [Source]
model-config [Source]
- Fallback model behavior when the primary is overloaded or unavailable. [line 470] [Source]
- Context window behind an LLM gateway: recognized models, including Sonnet 5.5 and Sonnet 5, get the same window as on the Anthropic API; native 1M models auto-compact at about 967K tokens. [lines 698-761] [Source]
sessions [Source]
- Resuming a still-running background session now attaches to it (
claude --resumerunsclaude attach;/resumemoves the current conversation to the background), with the cases where this is skipped. [lines 26-43] [Source] - Resumed-session permission mode depends on how you resume. [line 62] [Source]
settings-reference [Source]
- New managed
allowedProviderssetting (anthropic,bedrock,vertex,foundry,anthropicAws,mantle,customEndpoint,gateway) and the endpoint pins required in managedenv. [lines 5354-5394] [Source] - Custom spinner tips can be added or replace built-ins (v2.1.247+). [lines 3360-3368] [Source]
- Strict plugin marketplace setting also rejects
--plugin-dir,--plugin-url,--agents,--mcp-config; notes on desktop-managed plugins. [lines 5790-5810] [Source] - Artifact tool disable behavior and merge rules for restriction allowlists clarified. [line 5150, line 5861]
skills [Source]
- Skill shell commands run under the Bash tool's 2-minute default timeout. [line 679] [Source]
- Table showing what
Skill(...)deny rules also block (aliases, nested skills, claude.ai-synced skills). [lines 787-801] [Source]
Other updated documents
Smaller updates across errors, tools-reference, slash-commands, vs-code, plugins/troubleshooting, claude-apps-gateway-on-aws and desktop-changelog reflect the 2.1.286 changes.
API changes
New Documents
manage-claude/plugins-api [Source]
New guide to the Plugins API (beta header ce-plugins-2026-09-01) for Claude Enterprise organizations: inventory plugins, upload plugins and versions from your own pipelines, choose the version members are served, control who can use each plugin, download plugin files for review, and validate a Git marketplace before connecting it. Includes error responses and a pointer to the Analytics APIs for usage reporting.
api/beta/organization/plugins and plugin_marketplaces [Source]
New API reference pages for plugin CRUD, versions (create, list, retrieve, download), installation settings, shares, and marketplaces (list, retrieve, update, validate archive/repository).
api/organization [Source]
New non-beta Admin API reference tree covering API keys, compliance settings, external keys, federation issuers and rules, invites, rate limits, service accounts, users, and workspaces (including members, rate limits and service accounts).
Changed documents
about-claude/model-deprecations [Source]
- Claude Sonnet 4.5 (
claude-sonnet-4-5-20250929) marked Deprecated on September 30, 2026, retiring November 30, 2026; recommended replacementclaude-sonnet-5-5. [lines 69-98] [Source]
manage-claude/cmek [Source]
- Feature support table replaced with inline coverage lists (Batch, Skills, and tool data at rest); Managed Agents and Claude Science marked beta. [lines 61-73] [Source]
- Structured outputs unavailable for Fable/Mythos models in CMEK orgs; artifacts can only be shared within the org; Design/Slides/Docs and routines unavailable. [lines 85-97] [Source]
manage-claude/compliance-org-data [Source]
- New section: Compliance Access Keys with
read:compliance_org_datacan call the Plugins API's read endpoints; writes require an Admin API key withwrite:plugins. [lines 270-282] [Source]
managed-agents/migration [Source]
- Environment examples in all SDKs switched from unrestricted to
limitednetworking withallow_package_managers. [line 709] [Source]
managed-agents/quickstart [Source]
- Quickstart environment now uses
limitednetworking with package managers allowed, in every language example. [line 351] [Source]
api/beta and api/cli/beta [Source]
- Large expansions of the beta API and CLI reference, including organization, sessions, events and threads types; cost/usage analytics pages updated.
Other updated documents
Smaller updates to claude-in-microsoft-foundry, claude-on-vertex-ai, claude-platform-on-aws, api-and-data-retention, wif-reference, sonnet-4-5/overview and release-notes/overview.