Claude docs changes for October 11th, 2026 [diff]

Executive Summary

  • New network path permission check: reads from UNC paths (Windows) and /net automounts (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_FILE variables 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.location setting, Worktree folder field), and the Agent SDK documents a new forkSession() 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]
  • allowedTools auto-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+C behavior 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-dir directories also carry over. [lines 455-473] [Source]
  • Background sessions in bypassPermissions mode require a recorded acceptance of the disclaimer. [lines 707-711] [Source]
  • New claude respawn <id> command, claude daemon stop --any --keep-workers, and name-based claude attach/claude logs. [lines 756-765] [Source]
  • Supervisor stop/restart behavior: sessions wait about a minute for a new supervisor to reconnect; claude daemon status warns 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 sshConfigs in 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 answer row. [lines 32] [Source]
  • New entry for the reserved marketplace name error. [line 259] [Source]
  • /net automount 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_id now also identifies in-process teammates. [lines 717-721] [Source]
  • additionalContext containing <system-reminder> tags has the < escaped. [line 1052] [Source]
  • New section on persisting CLAUDE_ENV_FILE variables 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, or ExitPlanMode. [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_ATTRIBUTES on each remote machine. [lines 435-464] [Source]

permission-modes [Source]

  • dontAsk mode 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; rm of 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 /net reads always prompt and are denied in dontAsk mode (v2.1.292+), with workarounds via drive mapping or local mounts. [lines 459-475] [Source]
  • New section on exec wrappers (watch, setsid, flock...) and find actions that prefix rules can't auto-approve. [lines 231-242] [Source]
  • ps with 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 dontAsk description and WebFetch(domain:*.example.com) subdomain tip. [lines 78-480] [Source]
  • A mod's tool.check approval 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.location setting for Desktop SSH session worktrees. [lines 5184-5203] [Source]
  • copyFullResponse documented as the "Always copy full response" /copy picker option. [lines 588-6216] [Source]
  • forceLoginOrgUUID with an invalid value blocks sign-in with an explanatory message. [line 5615] [Source]
  • sshConfigs managed 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: Read deny rules block edits, and Bash views such as cat/grep/rg can satisfy the read-before-edit requirement. [lines 246-256] [Source]
  • New "Large files" section: 25,000-token and 256 KB read limits, PARTIAL view notices. [lines 508-516] [Source]
  • PowerShell follows the same working-directory reset behavior as Bash and receives CLAUDE_ENV_FILE variables (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.