Claude docs changes for Oct, 1st 2026 [diff]

Executive Summary

  • New allowedProviders managed 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 verify exists, 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
  • /hooks opens 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)
  • --bare connects only MCP servers named on the command line, sends no system reminders and starts no background tasks
  • The claude-api skill'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-model retries run at standard speed
  • Fixed claude --resume/--continue losing 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, /clear and /rewind silently 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 status reporting a Console API key sign-in as claude.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 /context shows, plus the ContextUsageResponse type. [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 with forceLoginMethod/forceLoginOrgUUID. [lines 171-188] [Source]

claude-apps-gateway-config [Source]

  • New "Bedrock in another AWS account" section: assume_role upstream 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:ApplyGuardrail must be granted. [line 157, line 300]

mcp [Source]

  • claude mcp add success output and claude mcp list health 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 blocked are 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 --resume runs claude attach; /resume moves 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 allowedProviders setting (anthropic, bedrock, vertex, foundry, anthropicAws, mantle, customEndpoint, gateway) and the endpoint pins required in managed env. [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 replacement claude-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_data can call the Plugins API's read endpoints; writes require an Admin API key with write:plugins. [lines 270-282] [Source]

managed-agents/migration [Source]

  • Environment examples in all SDKs switched from unrestricted to limited networking with allow_package_managers. [line 709] [Source]

managed-agents/quickstart [Source]

  • Quickstart environment now uses limited networking 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.