Claude docs changes for May 3rd, 2026 [diff]

Executive Summary

• Three new dedicated documentation pages added: Sessions (session lifecycle, resume, branching), Worktrees (parallel Claude sessions with git worktrees), and Deep Links (claude-cli:// URL scheme)
• Plan mode enhanced with a new Ctrl+G shortcut to edit plans in your editor before Claude proceeds, plus the ability to set plan mode as the default in settings
• Extended thinking controls fully documented in model-config: keyboard toggle (Option+T/Alt+T), alwaysThinkingEnabled setting, and MAX_THINKING_TOKENS=0 to disable
• Headless mode docs now cover piping stdin to Claude and adding Claude as a build script step, with cost tracking via --output-format json
• Hooks guide now documents all notification hook matcher values (permission_prompt, idle_prompt, auth_success, etc.)

Claude Code changes

New Documents

Deep Links [Source]

Documents the claude-cli:// custom URL scheme registered by Claude Code (v2.1.91+). Covers the claude-cli://open URL format with q (prompt), cwd, and repo parameters; security model (never auto-executes — shows a review banner first); embedding links in runbooks and shell scripts across macOS, Linux, and Windows; OS-specific registration locations; supported terminal emulators; and the disableDeepLinkRegistration setting.

Sessions [Source]

Comprehensive reference for CLI session management. Covers resuming sessions via --continue, --resume, --from-pr, and /resume; session picker keyboard navigation; naming sessions at startup (-n), mid-session (/rename), or automatically on plan accept; branching sessions with /branch or --fork-session; context management (/clear, /compact, /context); exporting sessions; and storage/cleanup details including CLAUDE_CODE_SKIP_PROMPT_HISTORY and --no-session-persistence flags.

Worktrees [Source]

Dedicated reference for running parallel Claude sessions using git worktrees. Covers the --worktree <name> / -w flag; base branch selection; .worktreeinclude for copying gitignored files (e.g. .env) into new worktrees; isolating subagents with isolation: worktree; cleanup behavior (auto-removed if no changes, prompted otherwise); and non-git VCS support via WorktreeCreate/WorktreeRemove hooks.

Changed documents

Amazon Bedrock [Source]

• Removed an enterprise sales promotional call-to-action block ("Deploying Claude Code across your organization?"). [line 9] [Source]

Best Practices [Source]

• "Resume conversations" section condensed to a brief summary with a link to the new dedicated Sessions page. [line 397] [Source]
• "Run parallel sessions" section updated to list four options with worktrees as a first-class entry, linking to the new Worktrees page. [line 419] [Source]

CLI Reference [Source]

• The --worktree / -w flag description now links to the dedicated Worktrees page. [line 105] [Source]

Common Workflows [Source]

• Page significantly restructured: all former top-level sections ("Fix bugs," "Refactor code," "Write tests," etc.) are now grouped under a new "Prompt recipes" ## section. A table of contents was added at the top. [lines 9-19] [Source]
• The detailed "Use specialized subagents" and "Use Plan Mode for safe code analysis" sections were removed.
• The detailed "Resume previous conversations" section was removed and replaced with a short summary linking to the new Sessions page. [line 253] [Source]
• The detailed "Run parallel Claude Code sessions with Git worktrees" section was removed and replaced with a brief summary linking to Worktrees. [line 398] [Source]
• The "Get notified when Claude needs your attention" section (desktop notification hooks) was removed.
• The "Use Claude as a Unix-style utility" section was removed and replaced with a short "Pipe Claude into scripts" summary linking to headless.md. [line 498] [Source]

Google Vertex AI [Source]

• Removed an enterprise sales promotional call-to-action block. [line 9] [Source]

GitHub Actions [Source]

• All occurrences of "AWS Bedrock" renamed to "Amazon Bedrock" throughout the file, including section headings and the section anchor ID. [lines 255, 270, 322, 405]

GitLab CI/CD [Source]

• All occurrences of "AWS Bedrock" renamed to "Amazon Bedrock" throughout the file, including section headings and the section anchor ID. [lines 19, 29, 91, 99]

Headless [Source]

• New "Pipe data through Claude" section added: explains piping stdin to Claude in non-interactive mode and notes that --output-format json includes per-invocation cost data (total_cost_usd). [line 63] [Source]
• New "Add Claude to a build script" section added: shows how to wrap a non-interactive Claude call in a package.json script, piping git diff main into Claude as a linter/reviewer. [line 79] [Source]

Hooks Guide [Source]

• New reference table added for notification hook matchers, documenting all 6 matcher values: permission_prompt, idle_prompt, auth_success, elicitation_dialog, elicitation_complete, and elicitation_response, with descriptions of when each fires. [lines 166-178] [Source]

How Claude Code Works [Source]

• "Resume or fork sessions" section condensed: the detailed --fork-session code example and warning about opening the same session in multiple terminals were removed; content now briefly describes the behavior and links to Sessions. [lines 91-107] [Source]

Microsoft Foundry [Source]

• Removed an enterprise sales promotional call-to-action block. [line 9] [Source]

Model Config [Source]

• ultrathink promoted to its own "Use ultrathink for one-off deep reasoning" subsection, with a new note clarifying that "think", "think hard", and "think more" are NOT recognized keywords and are passed as ordinary prompt text. [line 176] [Source]
• New "Extended thinking" subsection added with a controls reference table: Option+T / Alt+T to toggle, /config to set alwaysThinkingEnabled, MAX_THINKING_TOKENS=0 to disable, Ctrl+O for verbose mode, and showThinkingSummaries setting. Also notes that users are charged for all thinking tokens even when collapsed or redacted. [lines 198-209] [Source]

Overview [Source]

• "Create custom commands" renamed to "Create skills" in the feature list. [line 139] [Source]

Permission Modes [Source]

• New content added to "Review and approve a plan": Ctrl+G keyboard shortcut opens the plan in the default text editor for direct editing before Claude proceeds; showClearContextOnPlanAccept setting now required to show the "clear context" option; accepting a plan automatically names the session. [lines 109-130] [Source]
• New "Set plan mode as the default" subsection added, showing how to set "defaultMode": "plan" in .claude/settings.json. [lines 120-130] [Source]

Settings [Source]

• disableDeepLinkRegistration description simplified and now links to the new Deep Links page for details on the claude-cli://open?q=... format. [line 178] [Source]

Skills [Source]

• The "Getting started" example changed from an "explain code with diagrams" skill to a summarize-changes skill that diffs git changes, with updated code samples and instructions throughout. [line 10] [Source]
• New warning added under allowed-tools: for project-scoped skills, allowed-tools only takes effect after accepting the workspace trust dialog; users are advised to review project skills before trusting a repo. [line 286] [Source]
• The codebase-visualizer example now uses ${CLAUDE_SKILL_DIR} substitution variable and python3 in the allowed-tools entry. [line 482] [Source]
• Security fix in the bundled visualize.py script: added from html import escape and applied HTML-escaping to data["name"] and node.name to prevent XSS in generated HTML output. [line 528] [Source]

Enterprise Deployment Overview [Source]

• Removed an enterprise sales promotional call-to-action block. [line 10] [Source]

VS Code [Source]

• "Launch a VS Code tab from other tools" section expanded with explicit, tabbed code blocks for macOS (open), Linux (xdg-open), and Windows (cmd.exe/Start-Process), including a note that cmd.exe's start requires an empty title argument before the URL. [line 228] [Source]
• New reference added to Deep Links for the CLI's claude-cli:// handler as an alternative to the VS Code vscode:// handler. [line 255] [Source]

API changes

Changed documents

No significant API documentation changes today.