Claude docs changes for June 19th, 2026 [diff]
Executive Summary
- Artifacts is a new Claude Code feature (Team/Enterprise) that publishes session output as private, interactive web pages on claude.ai — shareable within your organization and live-updating as the session continues
- Agent teams UI redesigned: in-process mode now uses an agent panel with arrow-key navigation instead of Shift+Down; idle teammates auto-hide after 30 seconds; the default
teammateModechanged fromautotoin-process - New server tool versions:
web_search_20260318andweb_fetch_20260318addresponse_inclusioncontrol to reduce output tokens in agentic loops;web_fetch_20260309adds cache bypass;code_execution_20260521discloses the 90-second per-cell time limit - CMEK now supports HIPAA: the previous restriction preventing CMEK from being used with HIPAA-enabled organizations has been removed
- Automatic prompt caching for server tools: the API now automatically places 5-minute cache breakpoints on server tool results during agentic loops when prompt caching is enabled
New Claude Code versions
2.1.183
New features
- Added
attribution.sessionUrlsetting to omit the claude.ai session link from commits and PRs in web and Remote Control sessions - Added
/config --helpto list all available shorthand keys for/config key=value
Existing feature improvements
- Improved auto mode safety: destructive git commands (
git reset --hard,git checkout -- .,git clean -fd,git stash drop) are now blocked when you didn't ask to discard local work;git commit --amendis blocked when the commit wasn't made by the agent this session;terraform destroy/pulumi destroy/cdk destroyare blocked unless you asked for the specific stack - Added a warning when the requested model is deprecated or automatically updated to a newer model, shown on stderr in print mode (
-p) and now also covering models set in agent frontmatter - Changed
/configtoggle behavior: Enter and Space both change the selected setting; Esc now saves and closes instead of reverting - Removed the startup "setup issues" line under the logo — run
/doctorto see configuration issues or use--debug
Major bug fixes
- Fixed
thinking.disabled.display: Extra inputs are not permitted400 errors on subagent spawns and session-title generation for affected configurations - Fixed WebSearch returning empty results in subagents
- Fixed the terminal cursor being stranded above the prompt after navigating history in vim mode with the native cursor enabled
- Fixed fullscreen TUI corruption (statusline mid-screen, duplicated spinner rows, merged text) in Windows Terminal under heavy nested-subagent load
- Fixed turns silently completing with no visible output when the model returned only a thinking block; Claude now re-prompts once
- Fixed user-level skills appearing multiple times in slash-command autocomplete when multiple plugins are enabled
- Fixed MCP servers requiring authentication exposing auth-stub tools to the model in headless/SDK mode
- Fixed tmux teammate panes failing to launch when the shell has slow rc-file initialization, and keystrokes typed during agent spawn leaking into the new tmux pane instead of the leader prompt
- Fixed background tasks started by a teammate being killed when the teammate finishes a turn
- Fixed scheduled task and webhook trigger deliveries being treated as keyboard input; they now classify as task notifications and can no longer approve a pending action or set the session title in auto mode
- Fixed focus mode showing "Ran N PostToolUse hooks" timing lines under each response
Claude Code changes
New Documents
Artifacts [Source]
New documentation for the Artifacts beta feature (requires Team or Enterprise plan and /login authentication). Artifacts are live, interactive web pages that Claude Code publishes from your session to a private URL on claude.ai. The page updates in place as the session continues and can be shared within your organization. The doc covers when to use artifacts, how to create/update/share them, prompting patterns for richer pages, page constraints (single HTML page, no external requests, 16 MiB limit), availability requirements, and how admins can manage artifacts including retention policies, audit logs, and Compliance API endpoints.
Changed documents
Agent SDK / Subagents [Source]
- Clarified subagent depth limit: the foreground/background distinction is removed. All subagents (both foreground and background) are now capped at depth 5 — the previous rule that foreground subagents could spawn at any depth is no longer accurate. [line 119] [Source]
Agent SDK / TypeScript [Source]
- Updated
peerorigin description forSDKMessageOrigin: now explicitly documents that for in-process teammates sending tomainviaSendMessage,fromis the teammate's name andsenderTaskIdis its task ID; for cross-session peers,fromis the sender address andsenderTaskIdis absent. [line 1249] [Source]
Agent Teams [Source]
- In-process mode now uses an agent panel below the prompt input: up/down arrows to select a teammate, Enter to open their transcript and message them, Escape to interrupt. The previous Shift+Down cycling is removed. [line 72] [Source]
- As of v2.1.181, idle teammates' rows auto-hide after 30 seconds and reappear on their next turn; teammates stay running and addressable while hidden. [line 78] [Source]
- The default
teammateModechanged from"auto"to"in-process"as of v2.1.179; upgraded sessions that previously used split panes now stay in one terminal unless the mode is set explicitly. [line 94] [Source] - In-process mode now has a stop shortcut: press
xon a selected teammate to stop it. [line 140] [Source]
Amazon Bedrock [Source]
- As of v2.1.181, the flat output from
aws configure export-credentials --format processis now accepted (keys at the top level instead of nested underCredentials). [line 132] [Source]
Claude Code on the Web [Source]
- As of v2.1.179, commits that Claude creates in a web session automatically include a
Claude-Session: <url>git trailer, and PR bodies include the session URL — no manual construction needed. Instructions for linking session output in other contexts (Slack posts, reports) retained. [line 101] [Source]
CLI Reference [Source]
- New
--ax-screen-readerflag: renders screen-reader-friendly output (flat text, no decorative borders or animations). Requires v2.1.181. [line 51] [Source] --teammate-modedefault changed fromautotoin-processas of v2.1.179. [line 106] [Source]
Commands [Source]
/confignow acceptskey=valuepairs to set a setting directly without opening the UI, e.g./config thinking=false. Also works in non-interactive mode (-p) and from Remote Control. Run/config helpto list available keys. Requires v2.1.181. [line 46] [Source]
Environment Variables [Source]
- New
CLAUDE_AX_SCREEN_READERenv var: enables screen-reader-friendly output (requires v2.1.181). [line 130] [Source] - New
CLAUDE_CLIENT_PRESENCE_FILEenv var: path to a marker file that suppresses mobile push notifications while you're at the machine (requires v2.1.181). [line 132] [Source] - New
CLAUDE_CODE_ARTIFACT_AUTO_OPENenv var: set to0to prevent the browser from opening automatically when a new artifact is published. [line 153] [Source] - New
CLAUDE_CODE_DISABLE_ARTIFACTenv var: set to1to disable the Artifact tool. [line 155] [Source] - New
CLAUDE_CODE_OTEL_DIAG_STDERRenv var: set to1to write OpenTelemetry exporter diagnostic errors to stderr (requires v2.1.179). [line 214] [Source] OTEL_LOG_TOOL_DETAILSnow also includes the refusalcategoryonapi_refusalevents. [line 324] [Source]CLAUDE_AUTOCOMPACT_PCT_OVERRIDEdescription updated: Remote Control sessions no longer listed as a proactive compaction case. [line 128] [Source]
Fullscreen [Source]
- As of v2.1.181, clicking a URL or file path no longer opens it — you must hold
Cmdon macOS orCtrlon Linux/Windows while clicking. This matches native terminal behavior. [line 41] [Source]
Headless / Non-interactive Mode [Source]
- Clarified that
/config key=valueworks in-pmode;/configwithout arguments (interactive dialog) does not. [line 196] [Source]
MCP Quickstart [Source]
- New MCP server status:
! Connected · tools fetch failed— the server connected but couldn't list its tools; runclaude mcp get <name>for details. [line 56] [Source]
Monitoring Usage [Source]
api_refusalevent now emits many additional attributes:query_source,speed,attempt,effort,server_fallback_hop(whether the API's server-side fallback already retried on a different model),has_category,has_explanation,category(only withOTEL_LOG_TOOL_DETAILS=1), and skill/plugin/MCP attribution fields. [line 592] [Source]
Network Config [Source]
- New allowlist entry:
*.claudeusercontent.com— required in the browser (not the CLI) for viewing artifacts on claude.ai. [line 95] [Source]
Plugin Marketplaces [Source]
- Expanded explanation of how skills load for marketplace-root plugin entries: when
source: "./", listing specific subdirectories inskillsmakes that list the complete set for the entry; listing./skills/itself keeps the full scan. [line 471] [Source]
Remote Control [Source]
- RC failure behavior changed: a notification now appears with the failure reason and the indicator disappears from the footer (previously the indicator turned red). Run
/remote-controlagain to retry. [line 91] [Source] - New
CLAUDE_CLIENT_PRESENCE_FILEoption: configure a screen-lock listener to skip mobile push notifications while you're at the computer (requires v2.1.181). [line 166] [Source] /config key=valuenow works from mobile and web Remote Control (from v2.1.181). [line 175] [Source]
Sandboxing [Source]
- New
allowAppleEventssandbox setting (macOS only): allowsopen,osascript, and browser-based auth flows that otherwise fail with error-600. Removes code-execution isolation — sandboxed commands can launch other apps unsandboxed. Only honored from user, managed, or CLI settings, not project settings. [line 302] [Source]
Settings [Source]
- New
axScreenReadersetting: render screen-reader-friendly output (requires v2.1.181). [line 200] [Source] - New
disableArtifactsetting: set totrueto disable the Artifact tool. [line 211] [Source] teammateModedefault changed from"auto"to"in-process"as of v2.1.179. [line 273] [Source]- New sandbox setting
allowAppleEvents(macOS only): allow sandboxed commands to send Apple Events. [line 366] [Source]
Skills [Source]
- New section "Evaluate and iterate on a skill": documents how to use the
skill-creatorplugin to run automated evals comparing with-skill vs without-skill, blind A/B version comparisons, description tuning, and visual review via an HTML report viewer. [line 532] [Source]
Sub-Agents [Source]
- Simplified depth limit: the foreground/background distinction removed. All subagents are capped at depth 5; the previous rule that foreground subagents could spawn at any depth no longer applies. [line 739] [Source]
Tools Reference [Source]
- New
Artifacttool added to the built-in tools table: publishes an HTML or Markdown file as a private, interactive page on claude.ai. Requires Team/Enterprise plan and/loginauthentication. [line 9] [Source]
Ultrareview [Source]
- If a PR's diff is too large, Claude Code now refuses the review with a scoping hint before any review work runs. [line 31] [Source]
Workflows [Source]
- Added context that the closest-
.claude/workflows/saving behavior (v2.1.178) is especially useful in monorepos to keep workflows alongside the package they apply to. [line 162] [Source]
Zero Data Retention [Source]
- Artifacts added to the list of features not available with ZDR (requires storing published content on Anthropic-operated infrastructure). [line 46] [Source]
API changes
New Documents
Create an Admin API key [Source]
New guide centralizing Admin API key creation for both organization types. Covers which key type is needed (Claude Console vs Claude Enterprise), step-by-step creation instructions, the scope selection table for Claude Enterprise keys (read/write:spend_limits, read:analytics, read:compliance_activities, read/delete:compliance_user_data, read:compliance_org_data/settings), and how to use the key in API requests.
Changed documents
Agents and Tools / Tool Use / Code Execution Tool [Source]
- New tool version
code_execution_20260521: same runtime as_20260120but discloses the 90-second per-cell wall-clock time limit in the tool description, so Claude can budget long-running cells. Code exceeding the limit returns adetection_timeoutresult. [line 40] [Source] - "Free with web search or web fetch" pricing updated to say
_20260209or later (not just_20260209specifically). [line 7] [Source]
Agents and Tools / Tool Use / Computer Use Tool [Source]
- Screenshot handling guidance updated: the API does NOT silently downscale oversized screenshots — it rejects them with HTTP 400. Updated guidance requires you to resize before sending and set display dimensions to the resized size. [line 562] [Source]
Agents and Tools / Tool Use / Parallel Tool Use [Source]
- Major conceptual clarification: execution order of parallel tool calls is your decision. You may run calls concurrently or sequentially depending on your tools' dependencies. Documentation updated to reflect that running sequentially and stopping on first failure is a valid strategy; return
is_error: truefor any call you didn't execute. [line 16] [Source]
Agents and Tools / Tool Use / Server Tools [Source]
- References to
_20260209versions updated to_20260209or later throughout, covering ZDR configuration and dynamic filtering notes. [line 84] [Source]
Agents and Tools / Tool Use / Tool Reference [Source]
- New tool versions added to the server tools table:
web_search_20260318,web_fetch_20260318,web_fetch_20260309,code_execution_20260521. [line 15] [Source] code_execution_20260521andcode_execution_20260120are interchangeable inallowed_callers— a request using either version satisfies tools listing either caller. [line 69] [Source]
Agents and Tools / Tool Use / Tool Use with Prompt Caching [Source]
- New section "Server tool results are cached automatically": when prompt caching is enabled and Claude uses a server tool, the API automatically places a 5-minute cache breakpoint on the result before the next agentic loop iteration. These writes appear as
cache_creation.ephemeral_5m_input_tokensin the response. Applies only when the request already has at least onecache_controlmarker. [line 74] [Source]
Agents and Tools / Tool Use / Web Fetch Tool [Source]
- Latest version is now
web_fetch_20260318, which addsresponse_inclusioncontrol and includes dynamic filtering and cache bypass from previous versions. [line 9] [Source] - New
cache bypassoption (use_cache: false) inweb_fetch_20260309+: bypass the cache to fetch fresh content. Default istrue. [line 174] [Source] - New
response_inclusionparameter inweb_fetch_20260318+: set to"excluded"to omit fetch result blocks consumed by a completed code execution call from the API response, reducing output tokens. [line 182] [Source]
Agents and Tools / Tool Use / Web Search Tool [Source]
- Latest version is now
web_search_20260318, which addsresponse_inclusioncontrol in addition to dynamic filtering. [line 9] [Source] - New
response_inclusionparameter inweb_search_20260318+: set to"excluded"to omit search result blocks consumed by a completed code execution call from the API response, reducing output tokens. [line 168] [Source]
API / Compliance / Activities / List [Source]
- New Compliance API activity event types added:
abuse_decision_received(external anti-abuse service decision on sign-in/sign-up),claude_project_document_updated,claude_project_sync_source_created/deleted/updated,design_project_created/deleted/updated,org_capability_grant_added/removed, and others. [line 22] [Source]
Build with Claude / Prompt Caching [Source]
- Added a note explaining that unexpected
ephemeral_5m_input_tokenswrites in the response may occur when using server tools such as web search — with a link to the tool use + caching guide. [line 521] [Source]
Manage Claude / Admin API [Source]
- Added link to the new Create an Admin API key guide in the authentication section. [line 17] [Source]
Manage Claude / Analytics API [Source]
- Major content addition for the Claude Enterprise Analytics API: new sections on data availability and freshness (engagement endpoints available for dates on/after January 1, 2026; cost data refreshes within 4 hours, revisable for 30 days), metric definitions (active user counting, per-product metric blocks, connector name normalization), and working with the API (pagination cursor binding, bracket notation for list params, decimal string currency amounts, rate limits). [line 82] [Source]
Manage Claude / API and Data Retention [Source]
Manage Claude / CMEK [Source]
- Removed the restriction that CMEK is not supported for organizations with HIPAA enabled. CMEK can now be used together with HIPAA. [line 37] [Source]