Changes on 2026-06-08

1. **Analyze the Request:** * **Role:** World-class programmer analyzing documentation changes. * **Input:** Documentation changes for two pages (`data-usage.md` and `CHANGELOG.md.md`). * **Goal:** Provide concise, insightful analysis in markdown format, focusing on what matters to developers. * **Output Language:** Chinese. * **Specific Structure:** 1. Overall Summary (1-2 sentences). 2. Key Themes (bullets). 3. Impact Level (Low/Medium/High/Breaking) with reasoning. 4. Action Items (max 5 bullets). 2. **Analyze Page 1: `data-usage.md`** * *Change:* Updated the description of "Zero data retention" (ZDR) for Claude Code on Enterprise. * *Old:* "available for Claude Code... ZDR is enabled... each new org must have ZDR enabled separately." * *New:* "available to qualified accounts... ZDR is not included in the standard Enterprise plan... enabled... after confirming eligibility." * *Implication:* ZDR is no longer automatic or standard; it's a specific add-on/qualification for Enterprise users. This clarifies entitlements for developers/companies. 3. **Analyze Page 2: `CHANGELOG.md.md` (Version 2.1.169)** * *New Features:* * `--safe-mode`: Disables customizations (CLAUDE.md, plugins, etc.) for troubleshooting. Very useful for debugging environments. * `/cd`: Move session to new working directory without breaking prompt cache. Quality of life improvement for project navigation. * `disableBundledSkills`: Hide built-in skills/commands. Allows for a cleaner, "vanilla" experience if desired. * *Fixes/Improvements:* * Up/Down arrow behavior (UI polish). * Enterprise MCP policies enforcement (Security/Compliance fix). * Performance fixes (Windows startup, UI stalls, CPU usage). * Git Credential Manager popup fix (Windows specific annoyance). * Remote Control OAuth bug fix. * Agent management (`claude agents --json`, `--all`, `id`, `state`). * Untrusted project settings security fix (OTEL paths). * Vertex/Foundry idle timeout (prevents hanging). * *Implication:* Focus on stability, security (untrusted settings, MCP policies), Windows usability, and debugging tools (`safe-mode`). 4. **Synthesize Key Themes:** * *Stability & Performance:* Reducing stalls, CPU usage, fixing hangs. * *Security & Compliance:* ZDR eligibility clarification, MCP policy enforcement, fixing untrusted settings paths. * *Debugging & Usability:* New `--safe-mode`, `/cd` command, arrow key fixes. * *Windows Fixes:* Specific attention to Git popups and startup speed. 5. **Determine Impact Level:** * *Reasoning:* * `--safe-mode` is high utility for debugging. * `/cd` improves workflow. * Security fixes (untrusted settings, MCP policies) are important for Enterprise users. * ZDR policy change is a pricing/entitlement notice. * *Verdict:* **Medium**. While not a breaking change (APIs likely remain stable), the security fixes and new debugging flags are significant for operational stability and compliance. 6. **Draft Action Items (for developers):** * Review ZDR eligibility if relying on it (it's not standard anymore). * Use `--safe-mode` if experiencing weird behavior from custom configs. * Update local scripts if using `claude agents --json` (new fields added). * Check project settings if using `ANTHROPIC_MODEL` in background agents (fix confirmed). * Be aware of the 5-min idle timeout for Vertex/Foundry (configurable). 7. **Translate and Refine (Chinese):** * *Summary:* 本次更新侧重于提升稳定性和安全性。主要变化包括新增调试工具、修复企业级策略执行漏洞，以及明确“零数据保留”功能的资格要求。 * *Themes:* * 调试与故障排除: 新增 `--safe-mode` 和 `/cd`。 * 安全与合规: 澄清 ZDR 资格，修复 MCP 策略执行和不受信任项目设置漏洞。 * Windows 体验: 修复 Git 弹窗和启动性能。 * Agent 管理: 增强命令行参数和状态字段。 * *Impact:* Medium. * *Action Items:* * 如遇配置问题，尝试使用 `claude --safe-mode` 排查。 * 检查 ZDR 权限，确认是否符合新的“合格账户”要求。 * 若依赖 `claude agents --json`，请注意新增的 `id` 和 `state` 字段。 * 针对 Vertex/Foundry 用户，注意新增的 5 分钟空闲超时机制。 8. **Final Review:** Does it meet the "concise, insightful, world-class programmer" persona? Yes. It highlights the technical nuances (prompt cache preservation, untrusted settings漏洞) rather than just listing features. 9. **Construct Output.** (Proceeding to generate markdown response).

1. **Analyze the Request:** * **Role:** World-class programmer analyzing documentation changes. * **Task:** Analyze a batch of 15 documentation changes (diffs provided). * **Format:** Markdown (Concise, insightful). * **Focus:** What matters to developers. * **Language:** Chinese (as requested: "请用中文回复"). 2. **Analyze the Diffs (Page by Page):** * **Page: `skills.md` (+1 / -1)** * *Change:* Clarified tool blocking for skills. Removed instruction to use permission settings *only*, added new instruction to use `disallowed-tools` in frontmatter for temporary restriction during skill activation. * *Impact:* New configuration option for skill developers. * **Page: `slash-commands.md` (+1 / -1)** * *Change:* Same as `skills.md`. Adds `disallowed-tools` frontmatter capability. * *Impact:* Consistent feature addition. * **Page: `get-started.md` (+4 / -4)** * *Change 1:* Update CLI installation link from `/api/sdks/cli#installation` to `/cli-sdks-libraries/cli/quickstart#installation`. * *Change 2:* Update auth link from `/api/sdks/cli#authentication` to `/cli-sdks-libraries/cli/authentication`. * *Change 3:* Update Client SDKs card link from `/api/client-sdks` to `/cli-sdks-libraries/overview`. Text change: Java -> C# in the list? Wait, looking at the text: "Python, TypeScript, C#, and other..." (Previous was "Python, TypeScript, Java..."). * *Impact:* URL restructuring/reorganization. * **Page: `api/overview.md` (+4 / -4)** * *Change 1:* Text tweak: `e.g.` -> `for example`. * *Change 2:* Update Client SDKs link `/api/client-sdks` -> `/cli-sdks-libraries/overview`. * *Change 3:* Update SDK list in card: "Python, TypeScript, C#, Go, Java, PHP, and Ruby" (Previously: "Python, TypeScript, Java, Go, C#, Ruby, and PHP"). Reordering. * *Impact:* URL restructuring, minor text standardization. * **Page: `api/client-sdks.md` (+20 / -204) - *Major Change*** * *Change:* Massive rewrite/shortening. Title changed from "Client SDKs" to "CLI, SDKs, and libraries". * *Structure:* Instead of listing install commands and quickstarts for every language *on this page*, it now provides a landing page linking out to individual pages (`/cli-sdks-libraries/...`). * *Categorization:* Split into CLI, Client SDKs, and Libraries & Integrations. * *Impact:* Documentation architecture shift. Centralized page becomes a navigation hub rather than a reference dump. * **Page: `api/rate-limits.md` (+10 / -29)** * *Change:* HTML table `<table>` converted to Markdown table. Text changes: "Credit Purchase" -> "Credit purchase". Removed some specific HTML tags. * *Impact:* Formatting consistency. * **Page: `api/versioning.md` (+5 / -5)** * *Change 1:* Link update: `/api/client-sdks` -> `/cli-sdks-libraries/overview`. * *Change 2:* Text tweak: "we will preserve" -> "Anthropic preserves". "we may do" -> "Anthropic may do". * *Change 3:* "we will not break" -> "Anthropic will not break". * *Change 4:* "We always recommend" -> "Anthropic recommends". * *Impact:* Brand voice standardization, URL restructuring. * **Page: `api/beta-headers.md` (+1 / -1)** * *Change:* Link update: `/api/client-sdks#beta-namespace...` -> `/cli-sdks-libraries/overview`. * *Impact:* URL restructuring. * **Page: `api/errors.md` (+4 / -1)** * *Change 1:* Added "SDK error types" section explaining that SDKs use typed exceptions and linking to specific language docs. * *Change 2:* Link update: `/api/client-sdks` -> `/cli-sdks-libraries/overview`. * *Impact:* Improved clarity on error handling in SDKs. * **Page: `build-with-claude/streaming.md` (+3 / -3)** * *Change 1:* Text tweak: `e.g.` -> `for example`. * *Change 2:* Link update: `/api/client-sdks` -> `/cli-sdks-libraries/overview`. * *Impact:* Text standardization, URL restructuring. * **Page: `build-with-claude/context-editing.md` (+3 / -3)** * *Change 1:* Link update: `/api/client-sdks` -> `/cli-sdks-libraries/overview`. * *Change 2:* Text tweak: `e.g.` -> `for example`. * *Impact:* Text standardization, URL restructuring. * **Page: `build-with-claude/structured-outputs.md` (+1 / -1)** * *Change:* Link update: `/api/sdks/java#requirements` -> `/cli-sdks-libraries/sdks/java#requirements`. * *Impact:* URL restructuring. * **Page: `build-with-claude/claude-on-amazon-bedrock.md` (+3 / -3)** * *Change:* Link updates: `/api/client-sdks` -> `/cli-sdks-libraries/overview`. * *Impact:* URL restructuring. * **Page: `build-with-claude/claude-on-vertex-ai.md` (+3 / -3)** * *Change:* Link updates: `/api/client-sdks` -> `/cli-sdks-libraries/overview`. * *Impact:* URL restructuring. * **Page: `build-with-claude/claude-in-microsoft-foundry.md` (+2 / -2)** * *Change 1:* Link update: `/api/client-sdks` -> Removed link in Note text, just text remains? No, the note text changed from "For available SDK platform integrations, see [Client SDKs](...)" to just "The Go and Ruby SDKs do not currently support Microsoft Foundry." (Implicit removal of link). * *Change 2:* Link update: `/api/client-sdks` -> `/cli-sdks-libraries/overview`. * *Impact:* URL restructuring. 3. **Synthesize Key Themes:** * **Documentation Restructuring (Major):** The move from `/api/sdks/...` and `/api/client-sdks` to `/cli-sdks-libraries/...` is the most pervasive change. The SDK page went from a giant list to a navigation hub. * **Feature Addition:** `disallowed-tools` in Skill frontmatter. * **Style Standardization:** Changing "e.g." to "for example" and using "Anthropic [verb]" instead of "we [verb]" for brand voice. * **Content Improvement:** Better error handling documentation for SDKs. 4. **Determine Impact Level:** * *Reasoning:* The URLs changed significantly. If developers have hardcoded links to the docs or rely on the structure, they might get 404s. The `disallowed-tools` is a new feature (high impact for skill users). The consolidation of the SDK page improves discoverability but changes the mental model. The URL changes are the most "breaking" aspect for *references*, though not for the code itself. * *Rating:* Medium. It's primarily a documentation overhaul. Code behavior hasn't changed, but the "API" for reading the docs has. 5. **Draft Action Items:** * Update saved bookmarks or internal wikis pointing to `/api/client-sdks` or `/api/sdks`. * Explore the new `disallowed-tools` frontmatter option for Skills to manage tool usage dynamically. * Check the new SDK hub page (`/cli-sdks-libraries/overview`) if looking for specific language docs. * Review the updated error handling section to ensure SDK exception handling matches best practices. * (Optional) Note the reordering of language support (C# prominence). 6. **Translate and Refine into Chinese:** * *Summary:* 本次更新主要涉及文档结构的重大重组和 SDK 相关路径的迁移，同时引入了 Skills 的新配置选项。 * *Themes:* * **文档架构重组:** SDK 文档从单一长页重构为导航中心 (`/cli-sdks-libraries/...`)。 * **功能增强:** Skills 新增 `disallowed-tools` 前置元数据。 * **标准化:** 统一语言风格（e.g. -> for example, we -> Anthropic）和链接。 * *Impact:* Medium. URL 变更影响书签/引用，但功能未破坏。 * *Action Items:* * 更新书签/链接。 * 使用 `disallowed-tools`。 * 查看新的错误处理文档。 7. **Final Polish (Markdown):** Ensure the tone is professional and concise. * *Self-Correction during translation:* Ensure the distinction between "breaking" (code) and "breaking" (docs links) is clear. This is Medium impact because of the sheer volume of link changes, but it's documentation-only. * *Drafting the "Key Themes":* 1. **大规模文档路径迁移**: 旧的 `/api/client-sdks` 和 `/api/sdks` 路径统一迁移至 `/cli-sdks-libraries/...` 结构。 2. **SDK 概览页重构**: 原有的 SDK 列表页转变为导航枢纽，不再包含所有语言的安装示例。 3. **Skills 功能增强**: 新增通过 Frontmatter 配置 `disallowed-tools` 的能力，用于临时禁用工具。 4. **语言风格与格式统一**: 文案规范化（例如 `e.g.` 改为 `for example`），表格格式标准化。 * *Drafting the "Action Items":* * **更新书签与引用**: 检查并更新所有指向旧 SDK 文档路径（如 `/api/sdks`）的链接。 * **测试 Skills 工具限制**: 在 Skills 配置中试用新的 `disallowed-tools` 字段以实现动态工具管理。 * **查阅 SDK 错误处理**: 查看新增的 "SDK error types" 部分，优化异常捕获代码。 * *Drafting the "Impact":* * **级别**: Medium * **理由**: 虽然代码层面的 API 没有破坏性变更，但文档 URL 结构发生了根本性改变，可能导致旧的内部链接失效。新的 Skills 功能是重要的能力补充。 8. **Final Output Generation.** (Proceed to generate output based on these thoughts).