Claude docs changes for October 11th, 2026 [diff]
Executive Summary
- New network path permission check: reads from UNC paths (Windows) and
/netautomounts (macOS/Linux) now always prompt, ignoring allow rules, hooks and auto mode (v2.1.292+). - Edit and NotebookEdit now refuse files that aren't valid UTF-8 instead of silently corrupting them with
U+FFFD(v2.1.296+). There is a new error section and a new "Non-UTF-8 files" section. - Hooks docs gained a precise description of how stdout is parsed as JSON, and
CLAUDE_ENV_FILEvariables now reach PowerShell commands under strict conditions (v2.1.296+). - Agent view and background sessions got a lot of detail on backgrounding behavior,
claude respawn,claude daemon stop --keep-workers, and bypass-permission acceptance rules. - Desktop SSH sessions can now choose where worktrees go (
worktree.locationsetting, Worktree folder field), and the Agent SDK documents a newforkSession()function.
New Claude Code versions
No new version files in this update.
Claude Code changes
New Documents
No new documents.
Changed documents
agent-sdk/typescript [Source]
- Documented the new
forkSession()function, which copies a session transcript into a new session, optionally up to a given message (upToMessageId). [lines 397-424] [Source] allowedToolsauto-approval doesn't cover reads from network paths. [line 494] [Source]
agent-view [Source]
- New
∙status icon for exited processes; replying or attaching restarts them from the saved conversation. [line 137] [Source] - Clarified detaching and
Ctrl+Cbehavior while attached, and that detaching never stops a background session. [lines 243-245] [Source] - Detailed what happens when pressing
←while a tool runs, a prompt is pending, or the turn is stopped, and that foreground shell commands are stopped on backgrounding. [lines 265-275] [Source] - In-flight background work (shell commands, subagents, workflows, scheduled tasks) carries over on backgrounding; monitors can't and are stopped.
/add-dirdirectories also carry over. [lines 455-473] [Source] - Background sessions in
bypassPermissionsmode require a recorded acceptance of the disclaimer. [lines 707-711] [Source] - New
claude respawn <id>command,claude daemon stop --any --keep-workers, and name-basedclaude attach/claude logs. [lines 756-765] [Source] - Supervisor stop/restart behavior: sessions wait about a minute for a new supervisor to reconnect;
claude daemon statuswarns on version mismatch. [lines 815-836] [Source]
costs [Source]
- New section explaining the token count shown beside the spinner (output-only, per turn, resets on compaction). [lines 75-85] [Source]
desktop [Source]
- Worktree location can be customized for local sessions, with a Branch prefix setting and auto-archive after PR merge. [lines 331-340] [Source]
- New Worktree folder for SSH connections and a precedence order for choosing where SSH worktrees go (Desktop v1.44121.0+). [lines 699-719] [Source]
- Administrators can distribute SSH connections through
sshConfigsin managed settings. [line 768] [Source]
errors [Source]
- New error entry: "File is not valid UTF-8" (Edit/NotebookEdit refusal) with remedies. [lines 4375-4393] [Source]
- New entry for the
Not run · auto mode's check had no usable answerrow. [lines 32] [Source] - New entry for the reserved marketplace name error. [line 259] [Source]
/netautomount paths are refused as working directories; reads under them go through the network path check. [line 5117] [Source]
hooks [Source]
- Precise rules for when hook stdout is parsed as JSON versus plain text or a parse failure; multi-line JSON requires v2.1.295+ for async hooks. [lines 786-791] [Source]
agent_idnow also identifies in-process teammates. [lines 717-721] [Source]additionalContextcontaining<system-reminder>tags has the<escaped. [line 1052] [Source]- New section on persisting
CLAUDE_ENV_FILEvariables to PowerShell commands (v2.1.296+) and which events have access to it. [lines 1295-1308] [Source] permissionDecision: "allow"doesn't skip prompts for network path reads,AskUserQuestion, orExitPlanMode. [line 1869] [Source]- Resuming a deferred session in plan mode needs
--permission-prompt-tool(v2.1.246+). [line 1970] [Source] - Debug log now records a duration line per command hook (v2.1.296+) for finding slow hooks. [line 4089] [Source]
monitoring-usage [Source]
- New section on attributing telemetry to Desktop SSH sessions using
OTEL_RESOURCE_ATTRIBUTESon each remote machine. [lines 435-464] [Source]
permission-modes [Source]
dontAskmode described in the modes table. [line 19] [Source]- Auto mode: network path reads always prompt; protected-path writes go to the classifier even with an allow rule;
rmof critical paths is denied despite allow rules or hooks. [lines 495-556] [Source] - Bypass mode acceptance rules for non-interactive and background sessions. [lines 598-601] [Source]
- Symlinked settings files' targets count as protected paths. [line 666] [Source]
- Expanded Windows critical paths (8.3 short names,
\\?\C:\, volume GUID paths; v2.1.292+). [lines 682-702] [Source]
permissions [Source]
- New "Network paths" section: UNC and
/netreads always prompt and are denied indontAskmode (v2.1.292+), with workarounds via drive mapping or local mounts. [lines 459-475] [Source] - New section on exec wrappers (
watch,setsid,flock...) andfindactions that prefix rules can't auto-approve. [lines 231-242] [Source] pswith arguments that could print environment variables now prompts. [line 273] [Source]- Some prompts offer only a one-time approval when a saved rule couldn't be fully shown. [line 31] [Source]
- Expanded
dontAskdescription andWebFetch(domain:*.example.com)subdomain tip. [lines 78-480] [Source] - A mod's
tool.checkapproval doesn't skip prompts for tools requiring user interaction. [line 578] [Source] /cd <path>moves the session to a new primary working directory. [line 600] [Source]
settings-reference [Source]
- New
worktree.locationsetting for Desktop SSH session worktrees. [lines 5184-5203] [Source] copyFullResponsedocumented as the "Always copy full response"/copypicker option. [lines 588-6216] [Source]forceLoginOrgUUIDwith an invalid value blocks sign-in with an explanatory message. [line 5615] [Source]sshConfigsmanaged setting documented for Desktop; Artifacts disable key description added. [lines 5297-5415] [Source]
tools-reference [Source]
- New "Non-UTF-8 files" section: Edit and NotebookEdit refuse them; Write can replace them as UTF-8. [lines 258-265] [Source]
- Edit:
Readdeny rules block edits, and Bash views such ascat/grep/rgcan satisfy the read-before-edit requirement. [lines 246-256] [Source] - New "Large files" section: 25,000-token and 256 KB read limits,
PARTIAL viewnotices. [lines 508-516] [Source] - PowerShell follows the same working-directory reset behavior as Bash and receives
CLAUDE_ENV_FILEvariables (v2.1.296+). [lines 469-471] [Source]
plugins/troubleshooting [Source]
- Added a troubleshooting section for reserved marketplace names.
terminal-config [Source]
- Added content on seeing session status in the terminal (referenced from agent view).
API changes
No API documentation changes in this update.