### 整体摘要
本次文档更新主要进行了广泛的术语重命名,将 "Claude Code on the web" 统一重构为 "cloud sessions"(云端会话),以反映其跨平台(浏览器、终端、桌面、移动端)运行的能力。同时,文档对 Hooks 和 Skills 的高级功能进行了增强描述,特别是新增了通过 Bash 命令追踪文件变更的能力。
### 关键主题
* **全局术语重构**:将 "Claude Code on the web"、"web session" 等术语统一更改为 "cloud sessions" 或 "in the cloud"。这不仅是名称变更,更强调云端会话是一种可以在基础设施上持续运行的状态,不仅限于 Web 界面。
* **品牌规范化**:统一将域名 `Claude.ai` 改为小写 `claude.ai`,并修正了多处文案(如将 "Navigate to" 改为 "Go to"),提升文档一致性。
* **Hooks 功能增强 (`hooks.md`)**:在 `PostToolUse` Hook 中新增了 `bashEditDiff` 字段。当 Bash 命令修改了 Git 仓库中的文件时,该字段会记录变更列表和 Diff,这对于审计和代码审查工具至关重要。
* **Skills 权限逻辑细化 (`skills.md`)**:详细阐明了注入命令在 `auto mode` 与其他权限模式下的不同行为。在 `auto mode` 中,原本需要批准的注入命令现在可以正常加载并由 Claude 的分类器进行后续检查,而不是直接中断调用。
* **配置与路径说明**:优化了 MCP 服务器环境变量配置的说明(如必须在 `--env` 后加参数),并增强了插件市场路径解析的文档描述。
### 影响等级:中低
**理由**:此次更新绝大部分属于非破坏性的术语修正和品牌统一,对现有代码逻辑没有影响。然而,对于依赖 `PostToolUse` Hooks 进行文件监控的开发者,新增的 `bashEditDiff` 是一个重要的功能补充;对于深度使用 Skills 的开发者,新的权限逻辑说明有助于避免因权限配置不当导致的任务中断。
### 开发者行动项
* **更新内部文档**:检查团队内部的 Wiki、脚本或教程,将引用 "Claude Code on the web" 的地方更新为 "cloud sessions"。
* **利用 Hooks 文件追踪**:如果你使用 `PostToolUse` Hooks 来监控操作,建议更新代码以读取 `tool_response.bashEditDiff`,从而精确捕获通过 Bash 执行的文件修改(不仅限于直接编辑)。
* **审查 Skills 权限配置**:阅读 Skills 中关于注入命令的新说明,特别是在 `auto mode` 下,确保你的 `allowed-tools` 和权限规则符合预期,避免意外的调用失败。
* **检查 MCP 配置**:如果使用自定义 MCP 服务器,确认其启动命令中 `--env` 参数的书写格式符合新文档要求。
💭 Model Reasoning
1. **Analyze the Request:**
* **Role:** World-class programmer analyzing documentation changes.
* **Task:** Analyze a batch of 34 documentation changes (though the input provided only diffs for specific pages: `amazon-bedrock.md`, `checkpointing.md`, `claude-code-on-the-web.md`, `cli-reference.md`, `data-usage.md`, `desktop.md`, `devcontainer.md`, `discover-plugins.md`, `github-actions.md`, `google-vertex-ai.md`, `hooks.md`, `iam.md`, `jetbrains.md`, `mcp.md`, `microsoft-foundry.md`, `model-config.md`, `network-config.md`, `overview.md`, `plugin-marketplaces.md`, `plugins-reference.md`, `sandboxing.md`, `security.md`, `settings.md`, `setup.md`, `skills.md`).
* **Output Format:** Markdown, Chinese language, concise, insightful.
* **Structure:**
1. Overall Summary (1-2 sentences).
2. Key Themes (bullets).
3. Impact Level (Low/Medium/High/Breaking) with reasoning.
4. Action Items for Developers (bullets, max 5).
2. **Analyze the Diffs:**
* *General Pattern:* The most significant change is the rebranding/terminology shift from "Claude Code on the web" to "Claude Code in the cloud" or simply "cloud sessions". This appears in almost every file.
* *Minor Fixes:* Typographical fixes (e.g., "Navigate" -> "Go", "bash" -> "Bash", capitalization of specific terms).
* **Page-by-Page Analysis:**
* `amazon-bedrock.md`: Changed "Navigate to" to "Go to". Added anchor links for "AWS credentials", "IAM permissions", etc. (Minor usability improvement).
* `checkpointing.md`: "bash commands" -> "Bash commands". (Capitalization consistency).
* `claude-code-on-the-web.md`: **Major Rename**. Title changed from "Use Claude Code on the web" to "Use Claude Code in the cloud". Content updated to emphasize "cloud sessions" running on infrastructure vs "local sessions". Mentions starting sessions from browser, mobile, desktop, terminal, routines. Changed terminology like "web and terminal" to "terminal and cloud".
* `cli-reference.md`: "web session" -> "cloud session".
* `data-usage.md`: "Claude Code on the web" -> "cloud sessions". Updated wording.
* `desktop.md`: Updated section titles to match "cloud sessions". "remotely" -> "in the cloud".
* `devcontainer.md`: Updated `DISABLE_AUTOUPDATER` instruction. "Claude.ai" -> "claude.ai" (brand consistency).
* `discover-plugins.md`: Clarified error message instructions.
* `github-actions.md`: "Claude Code on the web" -> "Claude Code in the cloud".
* `google-vertex-ai.md`: "Navigate to" -> "Go to".
* `hooks.md`: "Claude Code on the web" -> "cloud sessions". Added new `PostToolUse` hook functionality (`bashEditDiff` for tracking file changes via Bash). This is a new feature/documentation.
* `iam.md`: "Claude.ai" -> "claude.ai". "Claude Code on the Web" -> "Cloud sessions".
* `jetbrains.md`: "bash execution" -> "Bash execution".
* `mcp.md`: Clarified MCP server setup instructions (adding options between `--env` and server name). Updated variable expansion documentation. Added section on how references appear in `/mcp`.
* `microsoft-foundry.md`: "Navigate to" -> "Go to".
* `model-config.md`: "Claude Code on the web" -> "cloud sessions". Added clarification about server-side rejection.
* `network-config.md`: "Claude Code on the web" -> "cloud sessions".
* `overview.md`: Updated terminology. Links updated (`from-terminal-to-web` -> `from-terminal-to-cloud`).
* `plugin-marketplaces.md`: Formatting changes (tables). Clarified path resolution. Clarified "See below" references.
* `plugins-reference.md`: Clarified `defaultEnabled` precedence.
* `sandboxing.md`: "narrower path wins" -> "rule with the narrower path applies". "Claude.ai" -> "claude.ai".
* `security.md`: "Claude Code on the web" -> "cloud sessions".
* `settings.md`: "Claude Code on the web" -> "cloud session". Refined text about settings.
* `setup.md`: "Claude.ai" -> "claude.ai".
* `skills.md`: "remote session" -> "cloud session". Added significant detail on permission checks for injected commands (especially in Auto mode).
3. **Synthesize Key Themes:**
* **Terminology Rebranding:** The shift from "Claude Code on the web" to "cloud sessions" / "in the cloud" is ubiquitous. This aligns the naming with the fact that these sessions can be started from desktop, terminal, mobile, etc., not just the web interface.
* **Brand Consistency:** Standardizing on lowercase "claude.ai" instead of "Claude.ai".
* **New Features/Documentation:**
* `hooks.md`: New `bashEditDiff` in `PostToolUse` to track file changes made via Bash commands.
* `skills.md`: Detailed explanation of permission checks for injected commands (specifically how Auto mode handles them vs interactive modes).
* **Minor Usability Fixes:** "Navigate to" -> "Go to", specific capitalization fixes ("Bash"), better link anchors.
4. **Determine Impact Level:**
* *Rebranding:* Low technical impact, medium documentation impact. Users need to know the new terms to search docs.
* *New Features (Hooks/Skills):* Medium to High impact for developers using those specific advanced features.
* *Overall:* **Low to Medium**. It's mostly terminology alignment, but the new hook data and skills permission logic are important for power users.
5. **Formulate Action Items:**
* Update internal documentation/scripts referencing "Claude Code on the web".
* Review `bashEditDiff` if using PostToolUse hooks to track file changes.
* Understand new permission behavior for injected commands in Skills (especially regarding Auto mode).
* Update links/anchors if relying on old URL fragments (though ID changes aren't explicitly shown as breaking, the text implies reorganization).
6. **Drafting the Response (in Chinese):**
* *Summary:* 本次文档更新主要涉及将 "Claude Code on the web" 统一重命名为 "cloud sessions"(云端会话),并统一了品牌术语(如 `claude.ai`)。此外,还对 Hooks(特别是 Bash 文件变更追踪)和 Skills 的权限检查逻辑进行了功能增强和文档细化。
* *Themes:*
* **术语重命名**:将 "Claude Code on the web" 全局替换为 "cloud sessions" 或 "in the cloud",以反映会话可从多端(终端、桌面、移动端)启动的特性。
* **品牌规范**:统一使用小写 `claude.ai`,修正大写 `Claude.ai` 及相关措辞。
* **Hooks 功能增强**:在 `PostToolUse` 中新增 `bashEditDiff` 字段,用于捕获通过 Bash 命令修改的文件列表。
* **Skills 权限逻辑**:详细说明了注入命令在 `auto mode` 和其他模式下的权限检查行为。
* **文档细节优化**:增加了内部链接锚点,修正了 "Navigate to" 等指令措辞,统一了 "Bash" 的大小写。
* *Impact:* **Low to Medium**。大部分是术语重命名,不影响现有代码功能。但对于依赖 Hooks 追踪文件变更或深入使用 Skills 权限控制的开发者,新文档提供了重要的实现细节。
* *Action Items:*
* 检查并更新内部文档或脚本中对 "Claude Code on the web" 的引用,改用 "cloud sessions"。
* 如果使用 `PostToolUse` Hooks,利用新增的 `bashEditDiff` 字段来更准确地追踪 Bash 命令带来的文件变更。
* 重新审视 Skills 中的注入命令权限逻辑,特别是在 Auto 模式下的行为变化,以避免意外的调用中断。
* 更新任何可能受 URL 结构影响的文档链接。
7. **Review and Refine:**
* Make sure the tone is professional ("World-class programmer").
* Ensure the translation is natural.
* Check against the provided diffs to ensure no hallucinated features. (Checked: `bashEditDiff` is in `hooks.md`, Auto mode logic in `skills.md`, MCP var expansion clarifications).
8. **Final Output Generation.** (Matches the drafted content).