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

Executive Summary

• New DirectoryAdded hook event fires when a working directory is added mid-session via /add-dir or the SDK's register_repo_root control request, letting hooks prepare newly added repositories.
• Fullscreen rendering is no longer purely opt-in: anyone who first used Claude Code on or after May 6, 2026 now gets it by default, with /tui default to switch back to the classic renderer.
• A new built-in claude subagent handles background sessions dispatched via claude agents or claude --bg when no agent is named.
• Bare mode (claude --bare) documentation now spells out that it skips OAuth and the system keychain entirely, so scripts must set ANTHROPIC_API_KEY (or apiKeyHelper) explicitly.
• Official plugin marketplace auto-registration behavior is clarified: it doesn't cover non-interactive environments or machines where an earlier policy blocked the marketplace, and the block isn't retried after the policy changes.

Claude Code changes

Changed documents

agent-loop [Source]

• permission_mode docs now point to a new "How permissions are evaluated" section describing the fixed order modes and allow/deny rules are checked in. [line 146] [Source]

desktop [Source]

• Clarifies that the desktop app doesn't save side chats to disk, so you can't reopen one after closing the app. [line 300] [Source]

discover-plugins [Source]

• Auto-registration of the official marketplace now happens on first interactive start, and a blocked prior attempt due to marketplace policy is called out as another reason to add it manually. [line 26] [Source]

env-vars [Source]

• CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL is now documented as a one-time, permanent skip: Claude Code only checks it during first interactive launch, and unsetting it later doesn't undo the skip. [line 218] [Source]

fullscreen [Source]

• Fullscreen rendering is now the default renderer for anyone whose first Claude Code use was on or after May 6, 2026; earlier users keep the classic renderer unless they opt in with /tui fullscreen. [line 3] [Source]

headless [Source]

• Documents claude -p exit codes: 0 on success, non-zero on failure, so scripts can branch on exit status. [line 26] [Source]
• Bare mode now explicitly requires setting ANTHROPIC_API_KEY since it doesn't use your subscription login, and it skips OAuth and the system keychain entirely. [lines 32-38] [Source]
• Added a package.json lint example run command and a "$1" argument-substitution explanation for the security-review script example. [lines 89, 242-250]

hooks [Source]

• New DirectoryAdded hook event: fires after a directory is added mid-session via /add-dir or the SDK's register_repo_root request, with directory and source input fields and no decision control. [lines 2296-2327] [Source]

hooks-guide [Source]

• Adds the new DirectoryAdded event to the lifecycle event table and spells out the PreToolUse input fields explicitly. [line 448] [Source]

interactive-mode [Source]

• Renames the "default renderer" to the "classic renderer" throughout, reflecting fullscreen becoming the default for newer users.

keybindings [Source]

• Same "default renderer" → "classic renderer" terminology update for transcript and history-search keybindings.

migration-guide [Source]

• Corrects the documentation-location note: Agent SDK docs live in the Claude Code docs under a dedicated section, not in the API Guide as previously stated. [line 11] [Source]

plugin-marketplaces [Source]

• Expands on when official-marketplace auto-registration doesn't apply: non-interactive environments, and machines where an earlier blocked attempt (e.g. empty-array lockdown) isn't retried after the policy changes. Recommends pairing with extraKnownMarketplaces to cover those machines. [lines 682-687] [Source]

plugins [Source]

• Notes that a marketplace-policy block, not just non-interactive timing, can prevent official marketplace auto-registration.

plugins-reference [Source]

• Adds DirectoryAdded to the plugin hooks lifecycle event table.

quickstart [Source]

• Permission modes description now links to the new "How permissions are evaluated" section covering the fixed evaluation order. [line 326] [Source]

routines [Source]

• Clarifies the /schedule "Unknown command" troubleshooting: a Console API key now shows a dedicated "available with Claude for Enterprise" message instead of the generic unknown-command error. [line 354] [Source]

settings [Source]

• Same official-marketplace auto-registration caveats (non-interactive environments, blocked-policy machines) added to the strictKnownMarketplaces/extraKnownMarketplaces reference. [lines 996-1001] [Source]

streaming-vs-single-mode [Source]

• Drops the "(Default & Recommended)" label from the Streaming Input Mode summary bullet (the dedicated section heading still calls it recommended). [lines 5-6] [Source]

sub-agents [Source]

• Documents a new built-in claude subagent, used for background sessions dispatched via claude agents or claude --bg when no agent is named, and which Claude can also delegate to directly. [line 59] [Source]

troubleshoot-install [Source]

• Splits the connectivity-check command into separate macOS/Linux and Windows PowerShell tabs, and clarifies the expected success status line differs by platform (HTTP/2 200 vs. HTTP/1.1 200 OK). [lines 51-62] [Source]

API changes

No significant changes today — the only diffs were Cloudflare email-obfuscation hash refreshes in files and thinking.