← All reports

Changes on 2026-06-29

38 total changes in 5 runs

19:58 EST

🤖 AI Batch Analysis

### 1. Overall Summary 版本 2.1.196 侧重于后台任务的稳定性、数据安全性以及用户体验的优化。该版本修复了可能导致对话数据丢失的严重 Bug,收紧了 MCP 服务器的安全审查策略,并显著提升了远程会话和后台代理的恢复能力及终端渲染性能。 ### 2. Key Themes * **关键稳定性修复**:解决了唤醒后台任务时因误读 Transcript 导致对话被永久删除的数据灾难性 Bug;修复了远程会话中断后的自动恢复机制。 * **安全策略变更**:`claude mcp list`/`get` 不再自动启动仓库通过 `.claude/settings.json` 自行批准的服务器,未信任的工作区将显示“⏸ Pending approval”。 * **后台任务增强**:大幅提升了后台会话和代理的可靠性,现在它们能存活于进程停止/重启/更新之后(包括 Windows),且代理在守护进程重启后会自动恢复。 * **开发者工具修复**:修复了 PowerShell 中 `git diff`/`grep` 等命令退出码处理(现对齐 Bash 行为)、GitLab 自托管 OAuth 范围请求失败、插件验证跳过源码等问题。 * **性能与体验**:优化了 `/code-review` 工作流(Token 使用减少约 25%);流式看门狗默认开启(5分钟无响应自动重试);优化了终端 UI 渲染开销。 ### 3. Impact Level **High (高)** * **理由**: 1. **数据安全**:修复了“唤醒后台任务永久删除对话”的严重 Bug,这对用户数据至关重要。 2. **安全变更**:MCP 服务器启动逻辑的改变(不再信任仓库自批准设置)可能会破坏现有的自动化工作流,需要开发者介入确认。 3. **可靠性提升**:后台任务的持久化和自动恢复能力是开发体验的重大改进。 ### 4. Action Items for Developers * **审核 MCP 权限**:检查现有的 MCP 服务器配置,未被信任的工作区现在会显示为“Pending approval”,需在 Org console 或本地手动审批。 * **调整超时设置**:流式看门狗默认开启(5分钟超时),如果您的长运行任务因此中断,请设置环境变量 `CLAUDE_ENABLE_STREAM_WATCHDOG=0`。 * **更新操作习惯**:了解新的 UI 交互,例如从前台会话打开 Agents 现在只需按一次 `←`;停止后台代理建议使用 `Ctrl+C`。 * **验证 PowerShell 环境**:Windows 用户应验证 `git diff`、`egrep` 等包含 `|` 的命令是否不再被错误报告为失败。 * **检查远程控制**:如果使用了自定义 `ANTHROPIC_BASE_URL`,请注意 Remote Control 现在会被禁用。
💭 Model Reasoning
1. **Analyze the Request:** * **Role:** World-class programmer, expert in dev tools/docs. * **Input:** A changelog diff for version 2.1.196. * **Output Language:** Chinese. * **Format:** Markdown, concise, insightful. * **Structure:** Overall Summary, Key Themes, Impact Level, Action Items. 2. **Analyze the Input (CHANGELOG.md.md diff):** * *Version:* 2.1.196. * *New Features:* Organization default models, readable default session names, clickable file attachments. * *Security:* `claude mcp list`/`get` no longer spawns servers from untrusted/repo-approved `.claude/settings.json` (pending approval required). * *Bug Fixes:* * Waking background jobs deleting conversation (critical data loss bug fixed). * Rate limit warning flickering/telemetry over-counting. * Duplicate recap lines. * PowerShell git diff/grep exit code handling (exit 1 is not failure). * `claude agents` side panel issues (focus, subagent types, status). * `--dangerously-skip-permissions` falling back to auto mode. * Mid-turn crash recovery for Remote sessions. * Sessions moved with `/cd` reappearing incorrectly. * `claude plugin validate` skipping local plugins. * `Esc Esc` regression, Ctrl+C for background agents. * MCP OAuth scope issues (GitLab enterprise). * `/context` token count on Bedrock. * `/deep-research` verifier failure messages. * Plugin dependency version pins. * `claude agents` session status labels. * Voice dictation swallowing spaces. * *Improvements:* * Background session reliability (survive restart/kill, Windows support). * Background agents auto-resume after daemon restart. * `/code-review` workflow efficiency (25% token reduction). * TUI rendering performance (skipping no-op subtrees). * Streaming idle watchdog default enabled (5 min timeout). * Remote Control disabled for non-Anthropic hosts. * UI change: opening agents view requires one `←` press. 3. **Synthesize - Overall Summary:** * Version 2.1.196 focuses heavily on stability, reliability (especially for background tasks and Remote sessions), and security hardening regarding MCP servers. It also introduces user experience improvements like organization defaults and UI refinements. 4. **Synthesize - Key Themes:** * *Reliability & Resilience:* Fixes for data loss (waking jobs), crash recovery, background job survival across restarts. * *Security:* Tightening MCP server spawning rules to prevent untrusted execution. * *Tooling & Agents:* Fixes for `claude agents`, PowerShell compatibility, and plugin validation. * *UX & Performance:* Better session naming, TUI performance, `/code-review` efficiency. * *Cloud Integration:* Bedrock token fixes, GitLab OAuth fixes, Remote Control behavior. 5. **Synthesize - Impact Level:** * *Level:* High. * *Reasoning:* It fixes a critical bug where waking a background job could permanently delete a conversation (data loss). It changes security defaults regarding MCP server spawning. It significantly improves the reliability of background processes. 6. **Synthesize - Action Items:** * Review `.claude/settings.json` if using MCP, as untrusted servers now require manual approval. * Note the new environment variable `CLAUDE_ENABLE_STREAM_WATCHDOG=0` if the 5-minute timeout causes issues. * Update user behavior regarding background agents (Ctrl+C to stop, auto-resume functionality). * Be aware of the UI change (single `←` to open agents view). 7. **Drafting the Response (in Chinese):** * *Summary:* 版本 2.1.196 侧重于后台任务的稳定性、数据安全性以及用户体验的优化。它修复了可能导致对话丢失的关键 Bug,加强了 MCP 服务器的安全审查,并提升了远程会话和代理 的恢复能力。 * *Themes:* * **稳定性与可靠性**:修复了唤醒后台任务导致对话永久删除的严重 Bug;大幅改进了后台会话在进程终止或重启后的存活与自动恢复能力。 * **安全性增强**:收紧了 MCP 服务器启动策略,现在不再自动执行仓库通过 `.claude/settings.json` 自批准的 `.mcp.json` 服务器,需手动审批。 * **开发者工具修复**:修复了 PowerShell 中 git 命令退出码处理、插件验证跳过、OAuth 授权范围请求等多个开发者工具层面的兼容性问题。 * **体验与性能优化**:改进了 `/code-review` 工作流的 Token 效率,默认开启流式看门狗超时机制,并优化了终端 UI 渲染。 * *Impact:* High (高)。 * *Reasoning:* 此版本包含了一个针对“唤醒后台任务导致对话永久删除”的关键修复,直接影响数据安全。同时,MCP 服务器启动逻辑的安全变更可能会影响现有的自动化工作流,需要开发者关注。 * *Action Items:* * 检查 MCP 配置:确认仓库中的 `.claude/settings.json` 不会被自动信任,如有需要请手动审批新出现的“Pending approval”服务器。 * 留意超时机制:流式看门狗默认开启(5分钟),如果您的长任务受此影响,请设置环境变量 `CLAUDE_ENABLE_STREAM_WATCHDOG=0`。 * 使用后台代理:了解后台代理现在会在守护进程重启后自动恢复,停止它们请使用 `Ctrl+C`。 * 测试 PowerShell 环境:如果在 Windows 上运行,验证 `git diff`/`grep` 等命令的行为是否符合预期(现已对齐 Bash 行为)。 8. **Final Review:** Does the output match the constraints? Yes. Concise, markdown, Chinese, insightful. * *Self-Correction during drafting:* Ensure the "Esc Esc" fix is mentioned as a regression fix. Ensure the significance of the "waking a background job deleting conversation" fix is highlighted as a major reason for the High impact. Mention the UI change for agents view. 9. **Final Polish:** (Proceed to generate output based on drafted points).

📚 Claude Code GitHub

18:51 EST

🤖 AI Batch Analysis

# 文档变更分析 ### 总体概览 此次文档更新核心在于明确了 Microsoft Foundry 平台上不同托管模式的功能差异,强制要求高级功能必须使用 "Hosted on Anthropic" 部署,同时正式废弃了旧版 Opus 模型的 Fast Mode 功能。 ### 关键变更主题 * **Microsoft Foundry 功能托管限制**: * 文件 API、代码执行工具、Web 搜索/抓取工具、MCP 连接器、Agent Skills 以及结构化输出等高级功能,现在明确要求必须在 Microsoft Foundry 上使用 **"Hosted on Anthropic"** 部署方式。 * 这意味着 "Hosted on Azure" 模式的功能范围被显著缩小(甚至 Sonnet 系列模型在该模式下的可用性也被移除)。 * **Fast Mode 废弃与调整**: * **Claude Opus 4.6**:已停止支持 Fast Mode。即使请求中包含 `speed: "fast"`,也将以标准速度执行并按标准费率计费。 * **Claude Opus 4.7**:Fast Mode 已被标记为废弃,将于 **2026 年 7 月 24 日** 移除。 * **上下文窗口与可用性升级**: * Microsoft Foundry 现已全面支持 Claude Opus (4.8, 4.7, 4.6) 和 Sonnet 4.6 的 **1M token 上下文窗口**(此前 Opus 4.8 仅支持 200k)。 * 结构化输出在 Microsoft Foundry 上从 Beta 版转为 **Generally Available (GA)**。 ### 影响等级:**Medium (中)** **理由**:虽然这些变更大多不会导致现有 API 代码立即崩溃,但对基础设施部署策略和成本控制有显著影响。特别是依赖 Microsoft Foundry "Hosted on Azure" 模式的开发者将发现许多高级功能不可用,且使用旧版 Opus 模型 Fast Mode 的用户需尽快调整逻辑以避免计费或性能不符合预期。 ### 开发者行动项 * **检查 Foundry 部署配置**:如果你在 Microsoft Foundry 上使用文件处理、代码执行、Web 工具或 MCP,必须确保部署设置选择了 **"Hosted on Anthropic"**,而非 "Hosted on Azure"。 * **移除 Opus 4.6 Fast Mode**:代码中若存在对 `claude-opus-4-6` 设置 `speed: "fast"` 的逻辑,请立即移除,因为该参数已被忽略且无加速效果。 * **规划 Opus 4.7 迁移**:针对 Claude Opus 4.7 的 Fast Mode 废弃(截止日期 2026-07-24),提前准备迁移方案,切换回标准模式或升级到新模型。 * **更新计费预估**:调整计费系统,不再对 Opus 4.6 和未来的 4.7 应用 Fast Mode 的溢价费率。 * **利用 1M 上下文**:如果在 Foundry 上使用 Opus/Sonnet 4.6,现在可以利用扩展的 1M 上下文窗口处理更大输入。
💭 Model Reasoning
1. **Analyze the Request:** * **Role:** World-class programmer, expert in dev tools/docs. * **Task:** Analyze a batch of 13 documentation changes. * **Output Format:** Markdown, concise, insightful, Chinese language. * **Specific Requirements:** Overall summary, Key themes, Impact level, Action items. 2. **Analyze the Input Data (Diff-by-Diff):** * *Page 1: `about-claude/models/overview.md`* * Diff shows a table comparison. The specific line changes are a bit cut off at the end (`+| [Extended thinking](/docs/en/build-with-claude/extended-thinking)** | No`), but the context implies table formatting/updates. * Wait, looking closer at the snippet provided for Page 1: The diff cuts off abruptly. However, usually, these diffs imply updates to feature flags or metadata. Let's look at the context provided. It shows "Latest models comparison". The diff shows the table headers and rows. * *Correction*: The provided diff for page 1 is actually incomplete (ends mid-line). I need to be careful not to over-interpret. However, usually, updates in the overview table reflect deprecations or feature additions seen elsewhere. Let's look at the other pages to infer the big picture. * *Page 2: `about-claude/pricing.md`* * **Key Change:** "Fast mode" text updated. * **Detail:** Removed "Claude Opus 4.6" from the list of supported models in the intro sentence. * **Detail:** Table removed Opus 4.6, kept 4.7 and 4.8. * **Crucial Detail:** Added a note: "Fast mode for Claude Opus 4.7 is deprecated and will be removed on July 24, 2026." * **Crucial Detail:** "As of June 29, 2026, fast mode is not available on Claude Opus 4.6: requests... run at standard speed and are billed at standard rates." * *Page 3: `api/rate-limits.md`* * **Key Change:** Fast mode rate limits section. * **Detail:** Removed "or Opus 4.6" from the list of models with dedicated rate limits. * **Detail:** Added note stating Fast Mode is not available on Opus 4.6 (runs at standard speed). * *Page 4: `build-with-claude/context-windows.md`* * **Key Change:** Context window sizes. * **Detail:** Microsoft Foundry now supports 1M tokens for Opus 4.8, 4.7, 4.6, and Sonnet 4.6 (previously it only supported 200k for Opus 4.8). * *Page 5: `build-with-claude/structured-outputs.md`* * **Key Change:** Availability on Microsoft Foundry. * **Detail:** Changed "Structured outputs are available in beta" to "generally available" on Microsoft Foundry. * **Detail:** Added requirement: requires a "Hosted on Anthropic deployment". * *Page 6: `build-with-claude/files.md`* * **Key Change:** Files API on Microsoft Foundry. * **Detail:** Added requirement: requires a "Hosted on Anthropic deployment". * *Page 7: `build-with-claude/claude-in-microsoft-foundry.md`* * **Key Change:** "Hosted on Azure" vs "Hosted on Anthropic" comparison table. * **Detail:** "Hosted on Azure" model availability changed from "Opus, Sonnet, and Haiku" to just "Opus and Haiku". (Sonnet seems removed from Hosted on Azure? Or implies Sonnet isn't the "latest" there? It says "The latest models in the Opus and Haiku families"). * **Detail:** Updated deployment instruction text regarding "Default settings" to be more specific about when it auto-configures to Azure. * *Page 8: `agents-and-tools/tool-use/web-search-tool.md`* * **Key Change:** Web search tool on Microsoft Foundry. * **Detail:** Added requirement: requires a "Hosted on Anthropic deployment". * *Page 9: `agents-and-tools/tool-use/web-fetch-tool.md`* * **Key Change:** Web fetch tool on Microsoft Foundry. * **Detail:** Added requirement: requires a "Hosted on Anthropic deployment". * *Page 10: `agents-and-tools/tool-use/code-execution-tool.md`* * **Key Change:** Code execution on Microsoft Foundry. * **Detail:** Added requirement: requires a "Hosted on Anthropic deployment". * *Page 11: `agents-and-tools/tool-use/programmatic-tool-calling.md`* * **Key Change:** Programmatic tool calling on Microsoft Foundry. * **Detail:** Added requirement: requires a "Hosted on Anthropic deployment". * *Page 12: `agents-and-tools/agent-skills/overview.md`* * **Key Change:** Agent Skills on Microsoft Foundry. * **Detail:** Added requirement: requires a "Hosted on Anthropic deployment". * *Page 13: `agents-and-tools/mcp-connector.md`* * **Key Change:** MCP connector on Microsoft Foundry. * **Detail:** Added requirement: requires a "Hosted on Anthropic deployment". 3. **Synthesize the Findings:** * **Theme 1: Fast Mode Deprecation/Restriction.** Fast Mode is being phased out for older models (4.7 deprecated, 4.6 removed/ignored). * **Theme 2: Microsoft Foundry Hosting Requirements.** This is the biggest theme. There is a strong push to differentiate between "Hosted on Azure" and "Hosted on Anthropic". Almost every advanced feature (Files, Web Search, Web Fetch, Code Execution, Tool Calling, Agent Skills, MCP, Structured Outputs) now explicitly requires "Hosted on Anthropic" deployment, implying these features are *not* available or fully supported on the "Hosted on Azure" tier. * **Theme 3: Model Availability Shifts.** Sonnet family removed from "Hosted on Azure" list in the comparison table. * **Theme 4: Context Window Expansion.** Foundry now supports 1M tokens for more models (Opus/Sonnet). 4. **Draft the Analysis (Internal Monologue/Translation to Chinese):** * *Summary:* The updates primarily clarify Microsoft Foundry deployment requirements (pushing towards "Hosted on Anthropic") and deprecate Fast Mode for older Opus models. * *Themes:* * Microsoft Foundry Feature Gating: Most advanced tools/features now require "Hosted on Anthropic" deployment, effectively restricting them from "Hosted on Azure". * Fast Mode Sunset: Opus 4.6 support dropped; 4.7 deprecated. * Context Window Increase: 1M tokens support expanded on Foundry. * GA Status: Structured Outputs on Foundry is now Generally Available (GA). * *Impact Level:* Medium. It's not breaking existing code immediately, but it restricts feature availability based on hosting configurations and forces migration off deprecated features. It's significant for Foundry/Azure users. * *Action Items:* * Check Foundry hosting config if using advanced tools. * Stop using Fast Mode on Opus 4.6/4.7. * Update billing expectations (no more fast mode premium or standard rates). 5. **Refine the Output (Chinese):** * *Overall Summary:* 此次更新主要针对 Microsoft Foundry 的部署模型进行了重大功能限制澄清,明确区分了 "Hosted on Azure" 和 "Hosted on Anthropic" 的能力差异,并废弃了旧版 Opus 模型的 Fast Mode 功能。 * *Key Themes:* * **Microsoft Foundry 功能门槛**:文件 API、代码执行、Web 搜索/抓取、MCP 连接器、Agent Skills 及结构化输出等高级功能,现在明确要求使用 "Hosted on Anthropic" 部署方式。 * **Fast Mode 废弃**:停止支持 Claude Opus 4.6 的 Fast Mode,并宣布 Opus 4.7 的 Fast Mode 将于 2026 年 7 月 24 日废弃。 * **上下文窗口扩展**:Microsoft Foundry 现在支持 Claude Opus 4.8/4.7/4.6 和 Sonnet 4.6 的 1M token 上下文窗口。 * **可用性更新**:Sonnet 系列模型似乎已从 "Hosted on Azure" 的可用列表中移除;结构化输出在 Foundry 上转为正式发布 (GA)。 * *Impact Level:* Medium。主要影响 Microsoft Foundry 和 Azure 用户。虽然代码层面不一定立即报错,但功能可用性受到严格限制,且 Fast Mode 用户需迁移。 * *Action Items:* * 如果你是 Microsoft Foundry 用户,且需要使用文件处理、代码执行、MCP 或 Web 工具,请务必检查并切换至 "Hosted on Anthropic" 部署模式。 * 立即停止在 `claude-opus-4-6` 上使用 `speed: "fast"` 参数(将被忽略并以标准速度/价格运行)。 * 为 Claude Opus 4.7 的 Fast Mode 废弃(2026-07-24)做准备,计划迁移至标准模式或更新后的模型。 * 更新计费逻辑,不再依赖 Fast Mode 的特定费率。 6. **Final Review:** Does this capture all the nuances? * The distinction between Hosted on Azure vs Anthropic is the most critical finding. * The deprecation of Fast Mode is the second most critical. * The context window update is a nice "plus" for Foundry users. The prompt asks for concise, insightful analysis. The summary looks good. *Self-Correction on Page 7:* The change "The latest models in the Opus and Haiku families" for Hosted on Azure vs previous "Opus, Sonnet, and Haiku" implies Sonnet is not available on the "Hosted on Azure" tier anymore or only Opus/Haiku are considered "latest" for that specific hosting path. This reinforces the "Feature Gating" theme. 7. **Final Output Generation** (matching the requested format).
17:20 EST

🤖 AI Batch Analysis

### 1. Overall Summary 本次文档更新主要引入了名为 **“Claude apps gateway”** 的全新自托管功能,旨在为企业管理员提供在 Claude Code 与云服务商之间部署 SSO(单点登录)和策略控制的能力,并显著增强了在 Bedrock、Vertex AI 和 Foundry 等平台上的使用追踪与成本管控。 ### 2. Key Themes * **核心功能发布**:新增 `claude gateway` CLI 命令及相关文档,允许管理员通过配置文件(`gateway.yaml`)启动自托管网关服务。 * **认证流程重构**:网关提供了一种新的“Cloud gateway”认证方式,通过企业 IdP 进行 SSO 登录。**重要提示**:网关会话的优先级高于环境变量(如 `CLAUDE_CODE_USE_BEDROCK`),即一旦通过网关登录,CLI 将忽略针对特定云提供商的本地环境配置。 * **精细化可观测性**:网关解决了云提供商模式下缺乏指标的问题,自动提供基于 IdP 的用户身份归因(`user.email`, `user.groups`)、OTLP 指标(含 Token 计数)以及每用户消费限制。 * **数据隐私与合规**:在网关会话中,反馈数据默认被重定向到本地存档(`~/.claude/feedback-bundles/`)而非直接上传,且默认禁用了向 Anthropic 发送的使用分析和错误报告。 * **配置管理扩展**:托管设置现在支持通过网关远程下发,新增 `forceLoginMethod: "gateway"` 和 `forceLoginGatewayUrl` 配置项,强制开发者通过特定网关登录。 ### 3. Impact Level **High (for Enterprise Admins)** / **Medium (for Developers)** **Reasoning**: * **架构变更**:引入网关是一个重要的架构补充,它改变了在企业环境中(特别是使用 AWS/GCP/Azure 时)流量路由、认证和监控的方式。 * **行为改变**:对于开发者的本地环境变量优先级逻辑产生了影响,网关认证将“覆盖”直接的云提供商凭证设置。 * **非破坏性**:虽然有新功能,但不破坏现有的直接 API Key 或云提供商环境变量的工作流,只有在配置了网关时才会生效。 ### 4. Action Items for Developers * **检查登录方式**:如果您的组织部署了 Claude apps gateway,请在 `/login` 时选择 **Cloud gateway** 选项,使用企业 SSO 登录,而不是配置本地环境变量。 * **更新监控配置**:如果您在 Bedrock/Vertex 环境下手动配置了 `OTEL_RESOURCE_ATTRIBUTES` 来标记用户,切换到网关后可移除这些手动配置,因为网关会自动注入准确的 IdP 身份信息(`user.id`, `user.email` 等)。 * **利用本地归档**:在网关模式下,如需提供反馈或日志支持,请检查 `~/.claude/feedback-bundles/` 目录下的本地存档文件。 * **管理员参考**:若您负责工具部署,请参考新文档使用 `claude gateway --config gateway.yaml` 启动服务,并配置 `forceLoginGatewayUrl` 以标准化团队登录入口。
💭 Model Reasoning
1. **Understand the Goal**: The user wants a concise, insightful analysis of a batch of documentation changes (10 pages) related to a developer tool (Claude Code). I need to focus on what changed and why it matters to developers. The response must be in Chinese and Markdown format. 2. **Analyze the Input Data**: * **Total pages**: 10. * **Page 1 (cli-reference.md)**: Added `claude gateway` command to start a self-hosted server for administrators (SSO/policy on Bedrock/Vertex/Foundry). * **Page 2 (costs.md)**: Updated info on Bedrock/Vertex/Foundry. Previously said it doesn't send metrics. Now says "Claude apps gateway" provides per-user attribution, OTLP metrics, and spend limits. * **Page 3 (data-usage.md)**: Updated feedback upload behavior. On Bedrock/Vertex/Foundry + "Claude apps gateway", feedback writes to a local archive (`~/.claude/feedback-bundles/`) instead of uploading. Also mentions gateway disables specific telemetry. * **Page 4 (iam.md)**: Added "Cloud gateway" auth option (SSO). Added "Claude apps gateway" to the list of authentication types. Added a note that gateway sessions outrank Bedrock/Vertex/Foundry env vars. * **Page 5 (llm-gateway.md)**: Renamed section from "LLM gateways" to "Other LLM gateways". Differentiates between the new "Claude apps gateway" and third-party gateways. * **Page 6 (monitoring-usage.md)**: Updated OTLP metrics to include gateway-specific attributes (IdP subject, email, groups). Mentions `identity.source: gateway-oidc`. * **Page 7 (network-config.md)**: Minor updates. Added "Claude apps gateway" to the list of where traffic goes (replacing api.anthropic.com). Added a note about Node version requirements for OS cert store reading. * **Page 8 (quickstart.md)**: Added "Claude apps gateway" to login options. * **Page 9 (settings.md)**: Updated "Server-managed settings" to include delivery via the gateway. Added `forceLoginMethod` support for "gateway" and new `forceLoginGatewayUrl` setting. * **Page 10 (third-party-integrations.md)**: Added "Claude apps gateway" to the list of authentication options. 3. **Synthesize Findings**: * **Core Change**: Introduction of a new self-hosted feature called "Claude apps gateway". * **Functionality**: It acts as a gateway for administrators to deploy SSO (Single Sign-On) and policies in front of Claude Code, specifically for cloud providers like Bedrock, Vertex AI, or Foundry. * **CLI Impact**: New command `claude gateway`. * **Auth Impact**: New login method ("Cloud gateway") that can override other provider env vars. * **Telemetry/Metrics**: It provides better usage attribution (per-user), OTLP metrics, and spend limits. It also changes how data is handled (local archives for feedback). * **Admin/Settings**: New settings for managed settings delivery and forcing the gateway login method. 4. **Draft the Analysis (Internal Monologue/Translation)**: * *Summary*: The docs update focuses heavily on the introduction of the "Claude apps gateway," a self-hosted solution for enterprise SSO and policy management. * *Key Themes*: * New "Claude apps gateway" feature introduction. * SSO integration for cloud providers (Bedrock, Vertex, Foundry). * Enhanced telemetry and cost tracking (OTLP, per-user limits). * Authentication hierarchy changes (Gateway > Env vars). * *Impact Level*: High for enterprise administrators. Medium for general developers (if their org uses it). It's a new feature, so it's not "breaking" in the sense of destroying existing workflows, but it introduces a major new architectural component. * *Action Items*: * Check if your org is deploying this. * Use `claude gateway --config ...` if you are an admin. * Update auth flows if your org mandates gateway login. * Note the change in telemetry/metrics attribution if using the gateway. 5. **Refine the Output (Chinese)**: * *Overall Summary*: 本次文档更新主要引入了名为“Claude apps gateway”的新功能,这是一个面向企业管理的自托管网关,支持在 Claude Code 与云服务提供商之间实施 SSO 和策略控制。 * *Key Themes*: * **引入 Claude apps gateway**:新增 `claude gateway` 命令和配套文档,允许管理员部署自托管网关。 * **企业级认证集成**:网关支持通过企业 IdP 进行 SSO 登录,且优先级高于现有的 Bedrock/Vertex/Foundry 环境变量。 * **增强的可观测性**:网关提供细粒度的使用归因(OTLP 指标、Token 计数、用户群组)以及每用户消费限制。 * **数据隐私与本地化**:在网关会话下,反馈数据默认存档至本地而非上传,且特定的遥测数据会被禁用。 * **配置管理**:支持通过网关远程下发托管设置,并新增 `forceLoginGatewayUrl` 等配置项。 * *Impact Level*: **High (for Enterprise Admins)** / **Medium (for Developers)** * *Reasoning*: 这是一个重大的架构更新,引入了新的认证路径和管理能力。对于使用 Bedrock/Vertex/Foundry 的企业用户,这将显著改变认证、流量路由和成本追踪的方式。 * *Action Items*: * **管理员**: 若需部署 SSO 或策略控制,请查阅 `claude-apps-gateway` 相关文档并使用 `claude gateway --config gateway.yaml` 启动服务。 * **开发者**: 若组织启用了网关,请使用 `/login` 中的 **Cloud gateway** 选项通过企业 SSO 登录;注意网关会话下的流量不再直接发送至 `api.anthropic.com`。 * **监控**: 利用网关提供的自动 OTLP 指标(如 `user.groups`, `user.email`)替代手动配置的 `OTEL_RESOURCE_ATTRIBUTES` 以进行用户归因。 6. **Final Review**: Does this meet all constraints? Yes. Concise, insightful, markdown, Chinese, developer-focused. 7. **Construct Final Output**: (Proceed to generate markdown).
15:01 EST

🤖 AI Batch Analysis

# 文档变更分析 ### 1. 总体摘要 此次更新核心在于 **Microsoft Foundry 平台的重大升级**(从 Beta 转为正式发布 GA),引入了新的 Azure 托管选项、全平台统一的 1M 上下文窗口支持以及明确的 CCU 计费模式。此外,文档中统一更新了 Node.js 代码示例的模块导入规范。 ### 2. 关键变更主题 * **Microsoft Foundry 正式发布 (GA)**:移除了所有功能(如自动缓存、引用、自适应思考等)的“Beta”标记,标志着其在功能完整性上已与 Claude API 和 AWS 平台持平。 * **引入新的托管选项**:在 Foundry 中新增了“Hosted on Azure”(Azure 托管)与“Hosted on Anthropic”两种模式,前者允许推理在 Azure 基础设施上运行,以增强数据驻留合规性。 * **上下文窗口统一**:确认 Microsoft Foundry 现已支持完整的 1M token 上下文窗口,移除了之前仅限 200k 的限制。 * **计费与合规细节明确**:新增了“Claude Consumption Units (CCU)”计费说明($0.01/CCU),并明确了美国数据区域部署的 1.1x 价格倍率。 * **Node.js 代码规范更新**:将核心模块导入从 `fs` 更新为 `node:fs`,符合现代 Node.js 最佳实践。 ### 3. 影响等级:**高** **理由**:对于使用 Microsoft Foundry 的开发者,此次变更不仅仅是文档更新,更是产品功能的实质性扩展(特别是 Azure 托管模式和 1M 上下文支持)。这可能影响架构决策(数据驻留)、成本预估(CCU 计费)以及代码维护(移除旧的限制性配置)。 ### 4. 开发者行动项 * **重新评估托管架构**:如果在 Foundry 上部署,需在“Hosted on Azure”(数据保留在 Azure 内)和“Hosted on Anthropic”(功能更全)之间做出选择。 * **移除旧的限制代码**:检查针对 Foundry 的代码,移除任何基于 200k 上下文窗口的变通方案或 Beta 头部信息。 * **更新成本模型**:熟悉 CCU 计费逻辑,若使用 US Data Zone Standard 部署,请注意 1.1x 的定价倍率。 * **遵循 Node.js 最佳实践**:将项目中的 `import fs from 'fs'` 等语句更新为 `import fs from 'node:fs'`,以避免与第三方库命名冲突。 * **审查 Foundry 迁移指南**:参考更新后的 [migration guide](/docs/en/about-claude/models/migration-guide),确保从旧版本或 4.7 平滑升级至 4.8 时考虑 Foundry 的最新特性。
💭 Model Reasoning
1. **Understand the Goal**: The user wants a world-class programmer's analysis of a batch of documentation changes. The response must be in Chinese, in markdown format, concise, and insightful. It needs to cover four specific areas: Overall Summary, Key Themes, Impact Level, and Action Items. 2. **Analyze the Source Material (Diffs)**: * **Page 1: `about-claude/models/migration-guide.md`** * *Change*: Removed a note stating Microsoft Foundry has a 200k context window (initial launch limitation). Updated text to say 1M context window applies to Foundry as well (API, Bedrock, GC, Foundry). * *Significance*: Microsoft Foundry now supports the full 1M context window, removing the previous limitation. * **Page 2: `about-claude/pricing.md`** * *Change*: Added a new section "Claude in Microsoft Foundry pricing". Details CCU (Claude Consumption Units) billing ($0.01/CCU). Added "Inference geography" for Foundry (US Data Zone Standard = `inference_geo: "us"`, 1.1x multiplier). Updated text regarding `inference_geo` parameter scope. * *Significance*: Foundry billing is now clearly defined (CCUs), and data residency pricing (1.1x multiplier) is confirmed for US Data Zone deployments. * **Page 3 & 4: `build-with-claude/overview.md` & `build-with-claude/text-generation.md`** (Identical diffs) * *Change*: Updated "Availability" column in feature tables. Changed `<PlatformAvailability ... azureAiBeta />` to `azureAi`. * *Significance*: Microsoft Foundry is now generally available (GA) / stable, out of beta, for features like Context windows, Adaptive thinking, Citations, Effort, and Extended thinking. * **Page 5, 6, 9, 10: `vision.md`, `pdf-support.md`, `files.md`, `code-execution-tool.md`** * *Change*: Changed `import fs from "fs"` or `import fs from "fs/promises"` to `import fs from "node:fs"` or `import fs from "node:fs/promises"`. * *Significance*: Node.js best practice update. Using explicit protocol (`node:`) for built-in modules avoids conflicts with local modules named `fs`. * **Page 7: `build-with-claude/prompt-caching.md`** * *Change*: Removed "(beta)" mentions for Microsoft Foundry in various notes (automatic caching, cache isolation, etc.). * *Significance*: Prompt caching features for Foundry are now GA (matching the "azureAi" change in other docs). * **Page 8: `build-with-claude/claude-in-microsoft-foundry.md`** * *Change*: Massive rewrite. * "Preview" removed/replaced with general availability context. * New section "Hosting options": Distinguishes between "Hosted on Azure" vs "Hosted on Anthropic". * Azure hosting: Inference runs on Azure infra, prompts remain in Azure (metadata/safety flags egress). * Deployment types: Global Standard, US Data Zone Standard. * Updated provisioning steps (new portal flow). * *Significance*: Foundry integration has matured significantly. New hosting option (On Azure) implies data residency compliance benefits. New provisioning flow. 3. **Synthesize the Analysis**: * **Overall Summary**: The primary focus is the graduation of **Microsoft Foundry** from Beta to General Availability (GA), specifically introducing new Azure-hosted deployment options and full 1M token context window support. Additionally, minor code updates were made to use Node.js explicit imports. * **Key Themes**: * **Microsoft Foundry GA**: Removal of "beta" tags across multiple features (caching, context windows, etc.). * **New Hosting Option**: Introduction of "Hosted on Azure" vs "Hosted on Anthropic" within Foundry. * **Data Residency & Pricing**: Clarification of US Data Zone pricing (1.1x multiplier) and CCU billing. * **Context Window Equality**: Foundry now supports the full 1M context window (no longer limited to 200k). * **Node.js Best Practices**: Updating import statements to use `node:` protocol. * **Impact Level**: **High** (or Medium-High). * *Reasoning*: The Foundry changes represent a major platform update (GA status, new hosting model, billing changes). If a developer is using Foundry, they need to know about the new hosting options and the removal of context limits. If they are just using the raw API, the impact is lower, but the Foundry section is substantial. * **Action Items for Developers**: * Review Foundry deployment options: Decide between "Hosted on Azure" and "Hosted on Anthropic". * Update code if using Foundry: Remove any context window limitations (beta headers). * Check billing: Understand the CCU (Claude Consumption Units) billing model. * Consider Data Residency: If using Foundry for US data, note the 1.1x pricing multiplier for US Data Zone. * Code Hygiene: Update Node.js imports to `node:fs`/`node:fs/promises`. 4. **Draft the Response (in Chinese)**: * *Drafting Summary*: 此次文档更新主要集中在 **Microsoft Foundry 平台的重大升级**(从 Beta 转为 GA),包括新的 Azure 托管选项、1M 上下文窗口支持及 CCU 计费模式,同时更新了 Node.js 代码示例中的最佳实践。 * *Drafting Themes*: * Microsoft Foundry 正式发布 (GA):移除了 Beta 标签,功能完全可用。 * 新增托管选项:区分“Azure 托管”和“Anthropic 托管”。 * 上下文窗口升级:Foundry 现支持完整 1M token。 * 计费与合规:明确了 CCU 计费单位及美国数据区域的定价倍率。 * Node.js 代码优化:统一使用 `node:` 前缀导入核心模块。 * *Drafting Impact*: **High**。对于使用 Foundry 的开发者,这是功能上的重大扩展和配置流程的变化。 * *Drafting Actions*: 1. 评估 Foundry 托管模式(Azure vs Anthropic)。 2. 移除 Foundry 相关的 200k 上下文限制代码。 3. 熟悉 CCU 计费模式。 4. 更新 Node.js 导入语句(`fs` -> `node:fs`)。 5. **Refine and Polish**: Ensure the tone is professional and "world-class". Make sure the markdown formatting is correct. * *Self-Correction during drafting*: The Node.js change is minor but good to mention as a best practice update. The Foundry changes are the "meat" of this update. The migration guide change is important because it affects the actual code if someone was working around the 200k limit. 6. **Final Output Generation** (matches the requested structure).
12:36 EST

🤖 AI Batch Analysis

## 文档变更分析 ### 1. 总体概述 本次文档更新围绕一系列新模型发布(Claude Opus 4.8/4.7/4.6、Sonnet 4.6、Fable 5、Mythos 5),对上下文窗口规格、工具搜索兼容性、细粒度工具流式传输等关键功能进行了重要行为澄清和 API 迁移说明。 ### 2. 关键主题 - **新模型矩阵**:多个新模型登场,1M token 上下文窗口成为高端模型的默认配置,无需 beta header;Microsoft Foundry 上 Opus 4.8 仅 200k - **细粒度工具流式传输正式化**:从 `fine-grained-tool-streaming-2025-05-14` beta header 迁移到逐工具的 `eager_input_streaming` 字段,代码示例全面重写以展示实际流式输入处理 - **工具搜索兼容性明确化**:新增模型兼容性表格,Opus 4.1 及更早模型不支持 tool search;两个变体(regex/BM25)版本号统一为 `20251119` - **并行工具调用的边界行为**:web fetch 与客户端工具在同一轮并行调用时,API 会先返回 `stop_reason: "tool_use"`,待客户端返回 `tool_result` 后才执行 fetch - **Thinking block 上下文处理变更**:此前文档称"thinking blocks 被自动剥离",现改为"是否保留取决于模型"(Opus 4.5+ 行为不同) - **上下文窗口计入范围明确化**:明确 system prompt、所有 messages(含工具结果/图片/文档)、工具定义、prompt caching 的三类 input token 均计入上下文窗口 ### 3. 影响级别:**中高** **理由**:`eager_input_streaming` 字段替代 beta header 是一个需要代码迁移的 API 变更;新模型兼容性矩阵直接影响工具搜索的可用性判断;并行 server/client 工具调用行为和 thinking block 保留策略的变化可能引发难以调试的 bug。代码示例的大幅重写也暗示 SDK 行为有实质变化。 ### 4. 开发者行动项 - **迁移细粒度流式传输配置**:将 `fine-grained-tool-streaming-2025-05-14` beta header 替换为每个工具定义中的 `eager_input_streaming: true` 字段;显式设为 `false` 可在旧 header 仍存在时保持缓冲行为 - **检查工具搜索模型兼容性**:若使用 Opus 4.1 或更早模型,tool search 不可用;需对照新兼容性表格确认目标模型支持 - **处理并行工具调用的异步行为**:当 web fetch 与客户端工具并行调用时,需在收到 `stop_reason: "tool_use"` 后先返回客户端 `tool_result`,fetch 才会执行——不要假设 fetch 结果已就绪 - **验证 thinking block 保留逻辑**:多轮对话中,Opus 4.5+ 模型的 thinking block 可能保留在上下文中并计入 token,需重新评估上下文预算和压缩策略 - **更新上下文窗口预期**:新模型默认 1M token(Microsoft Foundry 为 200k);单次请求最多 600 张图片/PDF 页(200k 模型为 100),大文档可能先触及请求大小限制而非 token 限制
💭 Model Reasoning
Let me analyze the documentation changes across all four pages. 1. **Context Windows** (+60/-67): Major restructuring. Adds a summary line, reorganizes content about how context windows work, adds a new "Context window sizes by model" section mentioning new models (Claude Opus 4.8, 4.7, 4.6, Sonnet 4.6, Fable 5, Mythos 5), clarifies that everything counts toward context (system prompt, messages, tool definitions, tool results, images, documents, extended thinking output), and changes the guidance about how previous thinking blocks are handled (now model-dependent rather than always stripped). 2. **Web Fetch Tool** (+1/-1): Small but important clarification about mixing server tools and client tools in parallel tool calls - when Claude calls web fetch AND a client tool simultaneously, the API returns with `stop_reason: "tool_use"` before the fetch completes, then runs the fetch when you send back the client tool_result. 3. **Tool Search Tool** (+109/-95): Significant rewrite. Adds a "Model compatibility" section with a table showing which models support tool search (Fable 5, Mythos 5, Opus 4.8/4.7/4.6, Sonnet 4.6, Opus 4.5, Sonnet 4.5, Haiku 4.5). Clarifies that at least one tool must stay non-deferred. Adds more detail about the workflow. Code examples updated. 4. **Fine-Grained Tool Streaming** (+136/-75): Major rewrite. The `eager_input_streaming` per-tool field replaces the legacy `fine-grained-tool-streaming-2025-05-14` beta header. All code examples are completely rewritten to actually show streaming tool input (printing partial JSON fragments) instead of just showing token usage. Added clearer warning about invalid/partial JSON. Added note about `max_tokens` stop reason cutting parameters off midway. Key themes: - New model introductions (Opus 4.8, 4.7, 4.6, Sonnet 4.6, Fable 5, Mythos 5) - Better documentation of edge cases and behavior nuances - Migration from beta headers to stable per-tool configuration - Improved code examples that actually demonstrate the feature - Clarification on server tool + client tool interaction in parallel calls Impact: Medium-High. The fine-grained tool streaming migration from beta header to per-tool field is a significant API change. The new models and their context window sizes matter. The parallel tool call behavior for web fetch is important to know about. Action items: 1. Migrate from `fine-grained-tool-streaming-2025-05-14` beta header to per-tool `eager_input_streaming` field 2. Review new model compatibility for tool search - older models don't support it 3. Handle the case where web fetch + client tool are called in parallel (stop_reason: tool_use before fetch completes) 4. Update context window expectations for new models (1M tokens for several new models, 200k on Microsoft Foundry) 5. Be aware that thinking block handling in context varies by model (no longer universally stripped)