Changes on 2026-08-30

1. **Understand the Goal**: The user wants a concise, insightful analysis of 7 documentation pages for a developer tool (likely Claude Code or similar Anthropic tool). The output must be in markdown, focusing on what matters to developers, and the response must be in Chinese. 2. **Analyze the Diff per Page**: * **Page: amazon-bedrock.md** (+6 / -4) * *Change*: Reworked the section about streaming errors behind a gateway/proxy. * *Details*: Clarified how Claude Code handles `Content-Type` headers from Amazon Bedrock streams (`application/vnd.amazon.eventstream`). * *Key shifts*: * If the gateway drops the header but passes the binary body through, it works now (decodes as default). * If the gateway drops the header *and* converts to SSE, it falls back to non-streaming (slower). * Added advice: if converting to SSE, use `ANTHROPIC_BASE_URL` (LLM gateway) instead of `CLAUDE_CODE_USE_BEDROCK`. * Removed specific mentions of old versions (v2.1.208) to make it evergreen. * *Impact*: Developers using Bedrock via proxies/gateways need to check their streaming behavior. * **Page: desktop.md** (+1 / -1) * *Change*: Minor wording update in the "Auto" permission mode description. * *Details*: Changed reference from "availability requirements below" to "when auto mode is available". * *Impact*: Low. Documentation polish. * **Page: headless.md** (+1 / -1) * *Change*: Clarification on background task termination wait times. * *Details*: Changed "wait is capped at ten minutes" to "wait is capped at ten minutes of continuous idle waiting". * *Impact*: Low. Clarifies that the limit applies to idle time, not total duration. * **Page: hooks.md** (+2 / -1) * *Change*: Updated `agent_needs_input` hook description and added version requirement note. * *Details*: `agent_needs_input` now fires not just for background sessions, but also when a teammate asks a terminal setup question and the user is idle for ~6 seconds. * *Version*: Requires v2.1.248 or later for this specific behavior. * *Impact*: Medium for developers using hooks/notification features, specifically those using agent teams. * **Page: hooks-guide.md** (+2 / -1) * *Change*: Same as `hooks.md` (likely a duplicate or similar reference page). * *Details*: Updated `agent_needs_input` description and added v2.1.248 version note. * *Impact*: Same as above. * **Page: quickstart.md** (+5 / -5) * *Change*: 1. Code blocks have weird repeated `theme={null}` attributes (looks like a formatting glitch or build artifact, but functionally content is same). 2. Updated text about "First session after install". Previously said it asks before each change. Now links to specific doc section and clarifies Auto mode behavior. * *Impact*: Low. Mostly formatting noise and small UX clarification. * **Page: sandboxing.md** (+3 / -3) * *Change*: Updated description of default write behavior for sandboxed commands. * *Details*: Added `permissions.additionalDirectories` to the list of ways to grant write access (alongside CLI flags `--add-dir`). * *Impact*: Medium. Developers configuring sandboxing via settings files now know this JSON setting affects the sandbox's write scope. 3. **Synthesize Key Themes**: * **Amazon Bedrock Integration**: Significant clarification on how proxies/headers affect streaming (fallback to non-streaming vs. error). * **Configuration & Permissions**: Clarifications on sandboxing config (`permissions.additionalDirectories`) and Auto mode descriptions. * **Hooks/Agent Teams**: Expanded hook triggers for agent team interactions. * **Minor Polish**: Wording tweaks and potential formatting artifacts in code blocks. 4. **Determine Impact Level**: * *Medium*. The Bedrock changes explain a specific behavior change (fallback to non-streaming instead of error/hang) which is important for debugging. The sandbox change is a functional clarification for config users. The hooks change is feature-specific. 5. **Draft Action Items**: * If using Bedrock with a proxy, check `Content-Type` handling or use `ANTHROPIC_BASE_URL` if converting to SSE. * If using Hooks v2.1.248+, note new `agent_needs_input` triggers for agent teams. * If configuring sandboxing via JSON, know that `permissions.additionalDirectories` allows write access. * Ignore the repeated `theme={null}` in quickstart (likely formatting bug). 6. **Translate to Chinese**: * *Summary*: 主要更新了 Amazon Bedrock 网关代理流式传输的处理逻辑，澄清了沙盒写入权限配置，并扩展了 Agent Teams 的钩子触发条件。 * *Themes*: * Bedrock 网关兼容性：明确说明了 Content-Type 丢失或被修改时的行为（回退到非流式或报错），并建议配置方式。 * 权限与沙盒配置：更新了沙盒默认写入权限的说明，涵盖了 JSON 配置项。 * Hooks 与 Agent Teams：扩展了 `agent_needs_input` 钩子的触发场景。 * *Impact*: Medium. * *Action Items*: * 检查 Bedrock 代理配置。 * 更新 Hooks 逻辑。 * 检查沙盒设置。 7. **Refine Output**: * Ensure the tone is professional and concise. * Format as requested. *(Self-Correction during drafting)*: For the Bedrock section, the crucial point is that if the header is dropped and the body is converted to SSE, it now *falls back to non-streaming* instead of failing hard or hanging. This is a behavior worth highlighting. *Drafting the Chinese response...* **Summary**: 本次更新主要优化了 Amazon Bedrock 通过网关/代理时的流式传输处理逻辑，阐明了沙盒环境的写入权限配置，并针对 Agent Teams 扩展了钩子事件触发条件。 **Key Themes**: * **Bedrock 网关兼容性**: 重写了流式错误处理文档，明确了当网关修改或删除 `Content-Type` 头时，Claude Code 会回退到较慢的非流式路径而非直接报错，并建议此类场景下配置 `ANTHROPIC_BASE_URL`。 * **沙盒与权限配置**: 澄清了沙盒环境的默认写入行为，明确指出 `permissions.additionalDirectories` 设置项同样允许写入权限，不仅仅是 CLI 参数。 * **Hooks 与 Agent 集成**: 更新了 `agent_needs_input` 钩子，现在它会在 Agent Team 队友询问终端设置问题且用户空闲约 6 秒时触发。 **Impact**: Medium。对于使用 Bedrock 网关和依赖沙盒配置的开发者，这些变更有助于排查连接问题和理解权限范围。 **Action Items**: * **Bedrock 用户**: 如果流式传输出现“变慢”现象，请检查网关是否重写了 Content-Type 头。若网关将流转换为 SSE，请考虑使用 `ANTHROPIC_BASE_URL` 连接。 * **沙盒用户**: 利用新的 `permissions.additionalDirectories` 配置项来通过 JSON 文件精细控制沙盒写入权限。 * **Hooks 开发者**: 若使用 v2.1.248+ 版本，注意 `agent_needs_input` 现在包含 Agent Team 终端设置询问的场景。 8. **Final Review**: Matches all constraints. Markdown format, Chinese, concise, actionable.