Claude docs changes for October 26th, 2026 [diff]
Executive Summary
- Plugin marketplaces now fetch only the git submodules that hold plugin files (v2.1.295+), avoiding clone timeouts. New docs explain the rules and how to structure your repo.
- The mods admin guide lists which hooks from a user's mod are skipped by the built-in guard in managed environments.
/pluginshows a note about them (v2.1.299+). - Desktop docs add a guide to verifying a remote machine's SSH host key, plus a troubleshooting section for host key verification failures.
- Fast mode and standard speed keep separate prompt caches. The prompt caching docs were rewritten to match.
UserPromptSubmithooks that block or stop a message now have documented effects on SDK results. AsyncSessionStarthooks no longer re-add identical output on every resume.
New Claude Code versions
No new versions today.
Claude Code changes
New Documents
None.
Changed documents
agent-sdk/typescript [Source]
- When a
UserPromptSubmithook blocks a message that starts its own turn, or stops it withcontinue: false, you still get a success result withnum_turns: 0and the block or stop message asresult. [line 1829] [Source] - A message sent mid-turn that a
UserPromptSubmithook blocks at pickup is dropped and produces no result. Set a timeout when waiting on such messages. [lines 1837-1839] [Source]
claude-apps-gateway-spend-limits [Source]
- Claude Code now requests dollar spend amounts even when
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICis set. Before v2.1.295 it skipped the request, so/usageand the status line were percentage-only. [line 97] [Source]
desktop [Source]
- New section "Check a remote machine's host key". It explains how to find which machine a fingerprint belongs to, get its real fingerprint (for example with
ssh-keygen -lf), and compare before trusting. [lines 993-1014] [Source] - New troubleshooting section "SSH host key verification failed", covering the error messages Desktop shows when it refuses a host key. [line 2156] [Source]
desktop-changelog [Source]
- Same additions as
desktop: the host key check guide and the SSH host key verification troubleshooting section. [line 993] [Source]
fast-mode [Source]
- The cost note now says fast and standard speed keep separate caches, so each later switch reads part or all of the conversation uncached again. It no longer says the cost applies only once. [line 79] [Source]
hooks [Source]
- An async
SessionStarthook runs every time the event fires, but its output is skipped when it matches what Claude last received. It is redelivered when it changes or after compaction or/clear. Before v2.1.295 it was re-added on every resume. [lines 4085, 4153]
plugin-marketplaces [Source]
- New section "Keep unused submodules out of the clone" (v2.1.295+). Plugin placement decides which submodules are fetched, and root plugins should write out submodule paths explicitly, such as
${CLAUDE_PLUGIN_ROOT}/vendor/tool/run.sh. [lines 147-159] [Source]
plugins/create-marketplace [Source]
- Adds the same "Keep unused submodules out of the clone" guidance.
plugins/marketplace-reference [Source]
- New section "Git submodules in the marketplace repository". It gives the exact rules for when submodules are fetched for subdirectory plugins and root plugins, the cases where all are fetched, and the
--sparse/sparsePathsbehavior. [lines 171-200] [Source]
plugins/mods/admin [Source]
- New section "Know which hooks of a user's mod don't run". It has a table of events the built-in guard skips (
classic.<Event>,prompt.*,skill.prompt,attribution.text,session.compact,settings.read, somesession.appenddoors)./pluginshows a note about them (v2.1.299+). [lines 94-130] [Source] - Two ways to let those hooks run: install the mod as the organization's own, or remove
sec-default@builtinfromprependPlugins. [lines 116-120] [Source] - The note on
session.appendrewriting now excludes rows the guard passes over. [line 178] [Source]
plugins/mods/events [Source]
- Notes that
classic.<Event>hooks from a user's mod don't run where the built-in guard loads. [line 376] [Source]
plugins/troubleshooting [Source]
- The git clone timeout entry now advises updating to v2.1.295+ if the repo has large submodules. [line 317] [Source]
- New entry "A root plugin's files from a git submodule are missing after install", with the fix of writing out submodule paths in full. [lines 1091-1098] [Source]
prompt-caching [Source]
- The fast mode section was rewritten. Fast and standard speed keep separate caches, every toggle (including automatic fallbacks) can read uncached, and enabling fast mode on an unsupported model switches to Opus. [lines 99-104] [Source]
- Cache sharing is now described as depending on model, speed, and prefix. [lines 311-318] [Source]
self-hosted-environments-deploy [Source]
- The sample Dockerfile now installs
python3, because control-plane hooks for Claude Tag sessions (including the Slack reply hook) run it. [lines 347-352] [Source] - New troubleshooting item for Claude Tag not posting its Slack reply. It lists the checks: runner v2.1.229+,
python3available, and hooks not disabled. [line 824] [Source]
server-managed-settings [Source]
- Cached
prependPlugins,appendPlugins, orenabledPluginsvalues can't remove, move, or disable the built-in guard until the server confirms the payload. Plugins enabled only by a cached list count as the user's until then. [lines 169-173] [Source]
statusline [Source]
- Spend limit dollar fields are no longer absent when
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICis set (v2.1.295+). They are still optional. [line 379] [Source]
API changes
No API documentation changes today.