# 文档变更分析
## Overall Summary
此次文档更新将多项管理功能（如 SSO 和模型限制）从 Enterprise 计划扩展到了 Team 计划，优化了 CLI、Desktop 和 Cloud 之间的跨平台会话流转体验，并清理了 API 文档中关于结构化输出的 Beta 阶段说明。同时，引入了包含大量错误修复的 v2.1.285 版本更新说明。
## Key Themes across pages
- **功能权限下放**：多项此前仅限 "Enterprise administrators" 的功能（如 SSO、`allowManagedHooksOnly`、`availableModels`）现在文档描述改为通用的 "Administrators"，意味着 Team 计划用户可能也获得了这些管理控制能力。
- **跨端会话管理增强**：详细完善了 CLI 与 Desktop App 之间的会话衔接逻辑（`/desktop` 和 `/resume` 命令），明确了会话状态同步及适用范围（如 SSH/WSL/Cloud 会话的限制）。
- **API 稳定性与文档清理**：结构化输出文档进行了大幅重构，移除了关于 Beta 头部和 `output_format` 迁移的说明，标志着该功能已正式稳定。
- **语法与依赖细节**：补充了 `CLAUDE.md` 中导入含空格路径文件的具体语法（反斜杠转义），以及在 VS Code 中读取特定 PDF 页面对 `poppler-utils` 的依赖要求。
- **安全性配置细化**：增强了关于沙箱读取权限（`blockReadsOutsideWorkingDirectories`）和插件配置的文档描述。
## Impact level
**Medium** (中)
**理由**：虽然大部分是文档措辞优化，但将管理权限扩展到 Team 计划对组织用户是重要更新；v2.1.285 包含了大量影响核心工作流（如 SSH、Artifacts、会话同步）的 Bug 修复；API 文档的清理也暗示了功能的正式稳定。没有直接的破坏性变更，但开发者应关注新功能 availability 的变化。
## Action items for developers
- **检查 Team 计划权限**：如果您所在的组织使用 Team 计划，请确认是否现在可以配置 SSO 强制登录和模型可用性限制。
- **更新 CLAUDE.md 语法**：如果您的项目内存文件引用了包含空格的路径，请确保使用反斜杠进行转义（例如 `@Design\ Docs/file.md`）。
- **安装系统依赖**：在 VS Code 扩展中使用 Claude Code 读取特定 PDF 页面时，请确保运行环境已安装 `poppler-utils`。
- **升级客户端**：建议升级至 Claude Code v2.1.285，以解决 SSH 连接、Cloud 会话、Artifacts 发布及文件附件处理等方面的已知问题。
- **审查管理设置**：管理员可查看新增的 `allowedProviders` 设置，以限制机器可使用的 API 提供商。
💭 Model Reasoning
1. **Understand the Goal**: The user wants a concise, insightful analysis of 12 documentation change pages for Claude Code. I need to summarize what changed, why it matters, identify key themes, assess impact, and list action items, all in Chinese.
2. **Analyze Each Page**:
* **`claude-code-on-the-web.md`**: Minor styling changes. Capitalized "Desktop", added backticks to `--cloud` and `--teleport`.
* *Implication*: Consistency improvement.
* **`desktop.md`**:
* Auth/SSO: Added "Team" to organizations that can require SSO (previously just Enterprise).
* CLI/Desktop integration (`/desktop`, `/resume`): Clarified that `/resume` works in local sessions only (not SSH/WSL/cloud). Added step-by-step instructions for moving a CLI session to Desktop. Crucial detail: Desktop continues the *same* session, so `claude --resume` in terminal still finds it.
* *Implication*: Better cross-platform workflow clarification.
* **`hooks.md`** & **`hooks-guide.md`**:
* Changed "Enterprise administrators" to "Administrators" regarding `allowManagedHooksOnly` and `availableModels` (and added links/cross-references).
* Updated `agent_needs_input` trigger description to include "auto mode's notice about classifier request charges".
* *Implication*: Broader admin control (Team vs Enterprise), new hook trigger logic.
* **`memory.md`**:
* Added instructions on importing files with spaces in path names in `CLAUDE.md` (use backslashes).
* *Implication*: Fixes a specific syntax pain point.
* **`model-config.md`**:
* Changed "Enterprise administrators" to "Administrators" for `availableModels`.
* Added specific error message link for unsupported model versions.
* Added anchor `extended-context-with-1m` for jumping.
* *Implication*: Consistency and better error guidance.
* **`sandboxing.md`**:
* Added detail about `permissions.blockReadsOutsideWorkingDirectories`.
* *Implication*: Clarifies security settings.
* **`sub-agents.md`**:
* Changed "permissions" to "permission rules".
* Updated example code (removed `$TOOL_INPUT` from command string).
* Clarified that session-wide agents apply "tool restrictions and model" (removed "system prompt" in one bullet, but corrected in the next paragraph to say "custom subagent's system prompt").
* *Implication*: Technical accuracy and clarity.
* **`vs-code.md`**:
* Added requirement for `poppler-utils` when reading specific PDF pages.
* *Implication*: Important dependency note.
* **`api/errors.md`**:
* Updated URL for `output_config.format`.
* *Implication*: Link fix.
* **`build-with-claude/structured-outputs.md`**:
* Major rewrite.
* Removed "Migrating from beta" tip (deprecated section).
* Restructured content (Quick start -> How it works -> Usage).
* Moved "Strict tool use" to a separate link.
* *Implication*: Cleaned up API documentation, removed deprecated beta references.
* **`CHANGELOG.md.md`**:
* Version 2.1.285 added.
* New features: `CLAUDE_CODE_DISABLE_WEB_FETCH`, `claude --desktop`, `claude plugin configure`, `allowedProviders`.
* Bug fixes galore: SSH issues, cloud session compaction, file attachment handling, model switching, artifacts, ultrareview, etc.
3. **Synthesize Key Themes**:
* **Broader Admin Control**: Changing "Enterprise" to "Administrators" implies features (SSO, Managed Settings, Model selection) are now available for Team plans, not just Enterprise.
* **Cross-Platform Session Management**: Improvements in moving sessions between CLI, Desktop, and Cloud (`/resume`, `/desktop`).
* **Structural Documentation Cleanup**: Removing beta flags, fixing links, clarifying workflows (like file imports with spaces).
* **Security & Permissions**: Updates to sandboxing and managed settings.
* **API Stability**: Cleaning up `structured-outputs` docs by removing deprecated migration notes.
4. **Assess Impact**:
* **Medium**: While individual changes are small (mostly text fixes), the expansion of admin features to Team plans and the bug fixes affecting core workflows (sessions, artifacts, SSH) are significant. The removal of beta flags in the API is also notable for stability.
* *Reasoning*: No breaking code changes explicitly mentioned in the docs, but feature availability expanded.
5. **Determine Action Items**:
* Admins: Check if Team plans now have access to SSO and model restriction features previously limited to Enterprise.
* Users: Update CLAUDE.md files if using paths with spaces (need backslashes).
* Users: Install `poppler-utils` if using VS Code extension for PDF page reading.
* API Users: Note that `output_format` beta header migration tips are gone (the feature is now standard/stable).
* All: Update to version 2.1.285 for bug fixes.
6. **Draft the Response (in Chinese)**:
* *Overall Summary*: This update primarily focuses on expanding administrative capabilities to Team plans (previously Enterprise-only), refining cross-platform session workflows (CLI/Desktop/Cloud), cleaning up API documentation (removing beta flags), and introducing version 2.1.285 with numerous bug fixes. (此更新主要侧重于将管理功能扩展到 Team 计划（此前仅限 Enterprise），优化跨平台会话工作流，清理 API 文档，并引入了包含大量错误修复的 2.1.285 版本。)
* *Key Themes*:
* **Feature Expansion**: Features like SSO and model restriction (`availableModels`) are now available to "Administrators" (Team & Enterprise), not just Enterprise admins.
* **Session Mobility**: Improved documentation on moving sessions between CLI, Desktop, and Cloud (`/desktop`, `/resume`).
* **API Cleanup**: Structured outputs documentation finalized, removing deprecated beta migration notes.
* **Syntax Nuances**: Clarification on importing files with spaces in `CLAUDE.md`.
* **Bug Fixes**: v2.1.285 addresses issues with SSH, artifacts, and file attachments.
* *Impact Level*: **Medium**.
* *Reasoning*: Significant expansion of features for Team users. Documentation clarifications prevent confusion. Bug fixes improve stability.
* *Action Items*:
* Update `CLAUDE.md` syntax for paths with spaces.
* Verify `poppler-utils` installation if reading specific PDF pages in VS Code.
* Review `allowedProviders` setting if managing access to API providers.
* Update Claude Code to v2.1.285 to benefit from fixes.
7. **Review and Refine**:
* The translation looks natural.
* The formatting follows the requested Markdown structure.
* The analysis is concise and focuses on developer impact.
8. **Final Polish**: Ensure the distinction between "Enterprise" and "Team" is highlighted as a key takeaway. (Self-correction: Ensure I mention the specific version 2.1.285 changelog inclusion).
* *Self-Correction during drafting*: The "Team" expansion is a subtle change in text ("Team and Enterprise organizations" vs "Enterprise organizations") but has high implications for access control. I should highlight that.
* *Another detail*: The memory.md change about backslashes in paths is a specific syntax rule that developers using `CLAUDE.md` need to know to avoid import errors.
* *API*: The structured outputs page rewrite implies the beta period is over. Developers can rely on the stable `output_config` without worrying about old `output_format` deprecation docs cluttering the view.
* *Result*: Ready to output.