Changes on 2026-08-28

1. **Analyze the Request:** * **Role:** World-class programmer analyzing documentation changes. * **Input:** A single batch of documentation diffs (21 pages). * **Output Format:** Concise, insightful analysis in Markdown. * **Language:** Chinese. * **Structure:** 1. Overall Summary (1-2 sentences). 2. Key Themes across pages (bullets). 3. Impact level (Low/Medium/High/Breaking) with reasoning. 4. Action items for developers (bullets, max 5). 2. **Analyze the Diffs (Page by Page):** * *amazon-bedrock.md*: Minor wording changes. "picks up your region" -> "asks for your region". Clarification on 1M context window for "Invoke API" models vs Mantle. * *Theme*: Clarification of Bedrock integration behavior. * *claude-code-on-the-web.md*: Clarification of error handling for `--teleport` without session ID when auth fails/stale. * *Theme*: Error handling/user experience clarity. * *cli-reference.md*: Updated `--agents` flag docs to mention validation at startup and error handling. * *Theme*: CLI reliability/validation. * *costs.md*: **Major Addition**. Added Data Residency pricing (1.1x multiplier). Added detailed Prompt Cache statistics (hits, misses, warm/cold state). Fixed a Bash hook example script syntax (using `jq` correctly). * *Theme*: Cost visibility/transparency, Prompt caching. * *desktop.md*: Cross-session messaging update (Claude can reply). Extended thinking behavior update with specific model details (Opus 5). * *Theme*: Desktop features, model behavior. * *devcontainer.md*: Firewall script description changed from "blocks all... except" to "limits outbound traffic to...". Minor accuracy update. * *Theme*: Security/Networking accuracy. * *hooks.md*: Hooks definition updated to include "subagents". Updated directory fallback logic if current dir is deleted. Bash matching logic update (expanded table). * *Theme*: Hooks robustness, matching logic. * *hooks-guide.md*: Clarification on exit codes and JSON validation/parse errors. Updated troubleshooting for "JSON parse message". * *Theme*: Hooks debugging. * *interactive-mode.md*: Behavior of queued commands (`/model`, `/effort`, `/fast`). Clarification on when prompt suggestions are disabled. * *Theme*: Interactive UX. * *mcp.md*: Retry logic for authentication errors with `headersHelper`. Timeout calculation clarification. URL length cap in URL mode. Prompt naming convention change (`/servername:promptname` vs `/mcp__servername__promptname`). * *Theme*: MCP reliability, auth, UX. * *model-config.md*: Effort level interaction with Extended Thinking. Clarification on `MAX_THINKING_TOKENS` behavior (Opus 5 specifics). * *Theme*: Model configuration. * *network-config.md*: **Major Update**. Introduction of "First-byte deadline" watchdog. Detailed table of timers. * *Theme*: Network reliability/timeouts. * *plugin-marketplaces.md*: Path traversal restriction enforcement. Error handling for paths outside plugin root. * *Theme*: Security/Plugin safety. * *plugins-reference.md*: Path traversal limitations explained. Security restriction enforcement. * *Theme*: Security/Plugin safety. * *sandboxing.md*: Sandbox write scope now includes `--add-dir` directories. Unsandboxed retry escape hatch clarity. `injectHosts` warning command update (`claude doctor`). * *Theme*: Sandbox behavior, security. * *setup.md*: Code blocks had duplicate `theme={null}` attributes (cleanup, likely). * *Theme*: Documentation formatting (no functional change). * *skills.md*: Feature-specific skills availability. Frontmatter parsing rules (`---` must be first line). Removed `npm --version` from example. * *Theme*: Skills definition. * *slash-commands.md*: Same changes as skills.md (feature-specific skills, frontmatter rules). * *Theme*: Commands definition. * *statusline.md*: **Major Update**. Added `prompt_cache` fields (warm, ttl, hit ratio, etc.). Added `spend_limit` fields. Trigger updates on cache expiry. * *Theme*: Observability/Statusline. * *sub-agents.md*: `--agents` validation details. Experimental options for `cacheTtl`. Frontmatter parsing rules. Background subagent notification updates. * *Theme*: Sub-agent configuration. * *terminal-config.md*: Theme token updates. Added `effortUltra` token. Clarified `diffAddedDimmed` context. * *Theme*: UI customization. 3. **Synthesize Themes:** * **Observability & Cost Tracking:** Significant additions to `costs.md` and `statusline.md` regarding prompt cache stats and data residency pricing. * **Reliability & Robustness:** MCP auth retries, network watchdogs (first-byte deadline), hooks path fallback, sandbox write scope including added dirs, plugin path traversal security. * **Model & Behavior Specifics:** Interactions between extended thinking, effort levels, and specific models (Opus 5, Sonnet 5). * **Configuration & Validation:** `--agents` validation, frontmatter parsing rules, `injectHosts` warnings. 4. **Determine Impact Level:** * **High?** No breaking changes for core workflows. * **Medium?** Yes. There are significant behavioral clarifications (network timeouts, prompt cache reporting) and feature additions (statusline fields, cost tracking) that affect how developers monitor and configure Claude Code. * *Decision:* **Medium**. The changes improve transparency (costs/cache) and robustness (network/security) without breaking existing workflows. 5. **Draft Action Items (Chinese):** * Review cost tracking updates (Data Residency pricing). * Check network timeout configurations if experiencing connection hangs. * Verify MCP authentication flows if using `headersHelper`. * Update statusline scripts to utilize new `prompt_cache` data. * Review sandbox permissions if using `--add-dir`. 6. **Draft the Response (Iterative refinement for tone and conciseness):** * *Summary:* This update focuses on enhancing operational visibility (prompt caching, cost tracking) and system robustness (network timeouts, security enforcement, MCP authentication). * *Themes:* * **增强可观测性**: Added detailed prompt cache statistics and data residency pricing in costs/statusline. * **提升稳定性与安全性**: Introduced "first-byte deadline" network watchdogs, plugin path traversal enforcement, and MCP auth retry logic. * **明确行为**: Clarified interactions between extended thinking, effort levels, and specific models (Opus 5). * *Impact:* Medium. * *Action Items:* * Review the new cost tracking logic for 1.1x data residency rates. * Update statusline configurations to leverage the new `prompt_cache` object. * Audit MCP servers using `headersHelper` to benefit from improved auth retry logic. * Check sandbox configurations as write scope now includes `--add-dir` paths. * Verify plugin paths to ensure they don't reference outside the plugin root. 7. **Final Polish (Chinese):** Ensure technical terms are handled correctly (e.g., "Prompt Cache", "Data Residency", "Watchdog"). * *Self-Correction during drafting:* The setup.md change looks like a formatting glitch (multiple `theme={null}`). I will ignore it in the "meaningful" themes but ensure the overall summary focuses on the functional changes. 8. **Final Output Generation:** (Matches the structured markdown format).

1. **Analyze the Request:** * **Role:** World-class programmer analyzing documentation changes. * **Format:** Markdown. * **Scope:** Batch analysis of 9 pages. * **Language:** Chinese. * **Focus:** What changed and why it matters to developers. 2. **Analyze the Diff Changes (Page by Page):** * **Page: `chrome.md`** * *Change:* Removed "Browser selection requires Claude Code v2.1.154 or later." * *Implication:* The feature is now standard/stable, likely dropping backward compatibility concerns or just cleaning up the doc as the version requirement is met by the current baseline. * **Page: `costs.md`** * *Change:* Updated the explanation of cost calculation. Added details about `modelPricing` managed setting. * *New Content:* Section "Report spend at your contracted rates". Steps to configure `modelPricing`. Notes about where the note `at your organization's configured rates` appears (`/usage`). * *Implication:* Enterprise users can now see accurate costs based on their specific contract rates in `/usage` and status lines, not just list prices. Requires `modelPricing` config. * **Page: `plugin-marketplaces.md`** * *Change:* Removed "Requires Claude Code v2.1.154 or later" from `defaultEnabled` field description. * *Implication:* Feature stabilization/version cleanup. * **Page: `plugins-reference.md`** * *Change:* Removed "Requires Claude Code v2.1.154 or later" from `defaultEnabled` field description and the description text. * *Implication:* Feature stabilization/version cleanup. * **Page: `statusline.md`** * *Change:* Updated `cost.total_cost_usd` description to include mention of `modelPricing` (contracted rates) vs list price. * *Implication:* Consistent with `costs.md`. Shows developers that status line costs might be accurate to their org's billing now. * **Page: `about-claude/models/overview.md`** * *Change:* Updated model links. "Migrating to Claude Opus 5" link changed. * *Implication:* Documentation polish, ensuring links point to the correct migration guides or overviews. Update to "Opus 5" terminology. * **Page: `api/beta/files/upload.md`** * *Change:* Added `expires_in_seconds` parameter (1h to 90 days). Added `expires_at` return field. Removed a specific `anthropic-beta` header from example (implies it might be GA or default). Added example `expires_at` field in response. * *Implication:* Files API now supports expiration. Developers can set TTL on uploaded files. * **Page: `build-with-claude/structured-outputs.md`** * *Change:* Updated example model names from `claude-opus-4-8` to `claude-opus-5`. * *Implication:* Examples updated to reflect the latest generation models. * **Page: `CHANGELOG.md.md`** * *Change:* Added version `2.1.251`. * *Highlights:* * Hooks: `PreModelSwitch`, `PostModelSwitch`. * Remote Control: Live streaming of subagent tool calls. * Cost/Usage: `modelPricing` support (matches docs), spend limit bar, prompt-cache metrics. * Security Fixes: Symlink path traversal fixes (Read/Write/Edit, Grep, Workflow scriptPath). File tools following swapped symlinks. * Agent Teams: Fixing communication between teammates/leads. * Cloud/Gateway fixes: Handling profiles, retries. * General fixes: TUI lag, `--input-format`, background sessions, terminal rendering. * *Implication:* Major feature additions (hooks, pricing) and significant security hardening regarding symlinks. 3. **Synthesize Key Themes:** * **Pricing Transparency:** Huge focus on `modelPricing`. Docs updated to explain how orgs can see contracted rates in the CLI (`/usage`, status line). * **Model Updates:** References moving to Opus 5/Fable 5. Examples updated. * **API Enhancements:** Files API now supports expiration (`expires_in_seconds`). * **Security & Hardening:** Changelog mentions multiple path traversal/symlink fixes. This is critical. * **Feature Stability:** Removal of specific version requirement text (v2.1.154) indicates these features are now standard. * **Developer Experience (DX):** New hooks, better status line fields, prompt-cache metrics. 4. **Determine Impact Level:** * *High* for Enterprise/Orgs (Pricing changes). * *High* for Security (Symlink fixes in changelog, though docs don't explicitly detail the vulnerabilities, the fixes imply severity). * *Medium* for API users (Files API update). * *Reasoning:* The ability to display contracted costs is a major QoL improvement for enterprise devs. The API change is additive but important for file management. Security fixes are always high priority to note. 5. **Draft Action Items:** * **Admins:** Configure `modelPricing` if you want accurate cost tracking. * **API Users:** Update Files API implementation to handle `expires_at` and optional `expires_in_seconds`. * **Developers:** Update model references to use Opus 5. * **Security:** Review symlink usage if using complex file structures. * **Plugin Devs:** Note that `defaultEnabled` is now fully stable (though version check removal is minor). 6. **Translate to Chinese & Format (Iterative refinement):** * *Summary:* 本次更新主要涉及企业级成本追踪能力的增强（支持合约价格）、API 功能扩展（文件过期设置）以及安全性加固（符号链接漏洞修复）。 * *Themes:* * Enterprise Cost Reporting (`modelPricing`). * API Updates (Files API expiration). * Security Fixes (Symlinks). * Version Updates (Opus 5). * DX Improvements (Hooks, Status line). * *Impact:* High. Because of the security fixes and enterprise pricing features. * *Actions:* 1. Admins configure `modelPricing`. 2. API devs check file upload logic. 3. Update model names to Opus 5. 4. (Self-correction: Action items should be actionable for the developer reading this). 7. **Final Polish (Markdown Structure):** * **Overall Summary**: Focus on cost accuracy, API updates, and security. * **Key Themes**: * *企业级成本透明化*: Use `modelPricing` to see real costs. * *API 功能增强*: Files API supports TTL. * *安全加固*: Symlink fixes. * *文档与模型更新*: Opus 5 examples. * **Impact Level**: High. (Reasoning: New pricing capability + Security fixes). * **Action Items**: * Check `modelPricing` setup. * Update code for Files API. * Update model names. * Review security notes. *(Self-Correction during drafting)*: Make sure to explicitly link the `costs.md` change to the `statusline.md` change as they relate to the same feature. Note the changelog version `2.1.251` corresponds to these changes. *Refining the "Why it matters":* * `costs.md`: Stops devs from seeing fake (list) prices if their org pays less. * `api`: Allows temporary file uploads without manual cleanup. * `changelog`: Security fixes prevent reading/writing files outside the allowed workspace via symlink tricks. 8. **Final Output Generation** (Matches the requested Chinese response).

1. **Analyze the Request:** * **Input:** 30 pages of documentation changes (diffs provided). * **Role:** World-class programmer analyzing docs. * **Output:** Concise, insightful markdown summary. * **Language:** Chinese. * **Structure:** Overall Summary, Key Themes, Impact Level, Action Items. 2. **Scan and Analyze the Diffs (Batch Processing):** * *Page 1: `claude-code-on-the-web.md`*: * Updated TOC (added "permission modes"). * Refine cloud environment descriptions (organization-level environments, self-hosted). * Updated GitHub auth flow descriptions for routines. * **Significant CLI behavior change:** `--cloud` flag usage clarified. "Interactive attach" seems to be removed or rephrased as "queue-and-exit" only (`-p` is now the primary way to send follow-ups). The text "Without `-p`, `claude --cloud <session-id>` attaches your terminal..." is deleted. * *Page 2: `cli-reference.md`*: * Confirms `--cloud` behavior change. Now emphasizes queuing messages *with* `-p`. Removes mention of attaching without `-p`. * *Page 3: `desktop.md`*: * Added version requirement for `disableDesktopLocalSessions` (v1.37937.0). * Clarified managed settings for Cloud sessions and Cowork sessions. * Added external host domains for Artifacts (CDNs). * Clarified that local/SSH sessions deliver connectors directly; managed MCP settings don't reach connectors. * *Page 4: `hooks.md`*: * Clarified managed settings fallback logic. * Added version requirement for `disableCommandPluginSources` (v2.1.229). * Updated table formatting. * *Page 5: `hooks-guide.md`*: * Refined `elicitation_complete` description. * Updated permission decision logic descriptions regarding connectors/MCP tools. * *Page 6: `interactive-mode.md`*: * Added `Ctrl+[` for NORMAL mode entry (with version req v2.1.242). * Added new Vim commands `df{char}` and `dt{char}`. * *Page 7: `mcp.md`*: * Clarified `headersHelper` working directory rules, especially regarding `/cd` and `primary working directory`. * Updated trust dialog logic. * Added version requirements (v2.1.195+, v2.1.238+). * Clarified MCP server lifecycle when moving sessions with `/cd` (v2.1.246). * *Page 8: `model-config.md`*: * Clarified how managed settings apply to Cloud and Cowork sessions. * *Page 9: `monitoring-usage.md`*: * Minor text refinements regarding "managed tier". * *Page 10: `network-config.md`*: * Minor table formatting updates. * *Page 11: `plugin-marketplaces.md`*: * Updated naming rules (kebab-case, no spaces, control chars, bidirectional chars). * *Page 12: `plugins.md`*: * Added link for testing dependencies. * *Page 13: `plugins-reference.md`*: * Updated project-scope plugin loading logic (primary working directory). * Clarified synced plugins visibility. * Updated naming rules. * *Page 14: `settings.md`*: * Clarified `.claude` folder locations and "primary working directory". * Updated behavior of `.claude/settings.local.json` in git repos (root vs start dir). * Added version requirements (v2.1.211+, v2.1.242+). * *Page 15 & 16 (`skills.md`, `slash-commands.md`)*: * Updated project skills loading logic (primary working directory). * Added version req for `/cd` loading skills (v2.1.246). * Minor text refinements. * *Page 17: `statusline.md`*: * Added rate-limit reset logic for status line refreshes. * Clarified `rate_limits` object lifecycle. * *Page 18: `sub-agents.md`*: * Minor formatting change (space in agent name). * Updated connector/MCP tool permission descriptions. * *Page 19: `terminal-config.md`*: * Added behavior for deleting placeholders (Ctrl+W, etc.). * *Page 20: `vs-code.md`*: * Added version req for restoring plan mode (v2.1.246). * *Page 21: `get-started.md`*: * Updated Java SDK version from 2.57.0 to 2.58.0. * *Page 22: `api/overview.md`*: * **API Change:** Added `anthropic-workspace-id` header documentation. * Clarified Key types and workspace usage. * *Page 23: `build-with-claude/batch-processing.md`*: * Minor text refinements on workspace scoping. * *Page 24: `build-with-claude/files.md`*: * **Major Update:** Files API is out of beta. Migration guide from `files-api-2025-04-14` provided. * Updated list response shapes (`next_page` vs cursors). * SDK beta namespace updates. * *Page 25: `build-with-claude/claude-on-amazon-bedrock.md`*: * Updated Java SDK version to 2.58.0. 3. **Synthesize Key Themes:** * **CLI Behavior Change (`--cloud`):** The "attach" functionality for cloud sessions seems removed or deprecated in favor of explicit message queuing (`-p`). This is a significant workflow change for terminal-to-web interaction. * **Workspace Scoping & Managed Settings:** Heavy emphasis on how settings, files, and permissions are scoped to "workspaces" or "primary working directories". Refinements on how Cowork and Cloud sessions handle managed settings. * **Files API Graduation:** The Files API is now stable (out of beta), requiring migration from the beta header. * **Specific Version Requirements:** Multiple features (vim mode `Ctrl+[`, plan mode restore, `/cd` behavior) explicitly reference new Claude Code versions (v2.1.211, v2.1.242, v2.1.246, etc.). * **Directory & Path Logic:** Clarifications on where files/settings are read from (start dir vs. repo root vs. primary working directory), especially after using `/cd`. 4. **Determine Impact Level:** * **High:** The `--cloud` CLI flag change breaks existing workflows if users relied on attaching without `-p`. The Files API migration is a necessary step for stability. * **Medium:** The detailed scoping changes for managed settings/workspaces are important for enterprise/admins but might be transparent to casual users. Version requirements indicate new features are gated. 5. **Draft Action Items:** * Update CLI scripts using `--cloud` to use the new queuing syntax (`-p`). * Review and migrate code using the Files API beta header to the stable version. * Check API keys/workspace isolation for file uploads based on new warnings. * Update documentation or internal tooling regarding managed settings delivery to Cowork/Cloud sessions. 6. **Translate to Chinese and Format:** * *Summary:* 聚焦于 CLI 行为变更（`--cloud` 标志不再支持直接附加，仅支持消息排队）、Files API 正式转正（移除 beta 标头）、以及对工作区和管理设置的细粒度作用域说明。 * *Themes:* CLI 行为变更, API 稳定化, 权限与作用域细化, 版本依赖更新. * *Impact:* High (Breaking change in CLI workflow, API migration required). * *Action Items:* Migrate `--cloud` usage, Migrate Files API, Review workspace scoping. 7. **Refine Content (Self-Correction during drafting):** * *Check:* Did `--cloud` *really* break? The diff shows "Interactive attach is rolling out gradually..." was removed, and now it says "The command posts one message and exits" and the `--cloud` reference explicitly mentions "-p". Yes, the "attach" mode seems removed or rebranded, making the behavior change distinct. * *Check:* Files API. The diff clearly shows a "Migrate from..." section. This is a standard breaking change cycle. * *Check:* SDKs. Java SDK bumped to 2.58.0. 8. **Final Output Generation** (Proceeding to generate response in the requested format).