工程 / 官方
新增反馈工具与 API 成本优化,修复逾二十项已知问题
Anthropic 于 2025 年 8 月 26 日发布 Claude Code v2.1.247,涵盖新功能添加、体验改进与大量缺陷修复。新增的 SendFeedback 工具允许 Claude 在会话出现问题时自动起草反馈报告,用户可通过 /feedback 命令审阅并提交,也可通过 feedbackDrafts 设置关闭该功能。新增的 /claude-api cost-optimize 命令可对现有项目的 Claude API 支出进行画像分析,并逐步引导用户通过缓存、Token 清理、批处理、推理力度与模型选择等维度降低成本。/claude-api 技能同步扩展了 Admin API 覆盖范围,包括组织成员、邀请、工作区、API 密钥、速率限制报告、工作负载身份联合及 CMEK 等管理能力。此外,本版本修复了子代理首次调用遭遇 404 时崩溃、后台任务输出过大导致会话卡死、非拉丁键盘布局下 Ctrl 快捷键失效等二十余项问题,并对 Sonnet 5 的自动压缩窗口、跨会话消息折叠显示等行为进行了调整。
Claude Code v2.1.247 最受关注的新功能是 SendFeedback 工具。当会话中出现异常时,Claude 可自动起草一份结构化的反馈报告,用户在 /feedback 界面审阅后即可一键提交。对于不希望启用该功能的团队,可通过 feedbackDrafts 配置项将其关闭。与此同时,组织现在可以通过 spinnerTipsOverride 配置自定义加载提示,支持设置 id、text、cooldownSessions、priority 等字段,以及 tipsFile 和 label,实现与内置提示的轮播混排。
成本管控方面,新增的 /claude-api cost-optimize 命令为开发者提供了一套系统化的 API 支出优化流程。该命令会对现有项目的 Claude API 消耗进行全面画像,然后逐一引导用户评估并实施缓存策略、Token 清理、批量请求、推理力度调节与模型选型等降本手段,每次只做一项可量化的改动,便于追踪效果。/claude-api 技能同步新增了 Admin API 的完整覆盖,涵盖组织成员管理、邀请流程、工作区配置、API 密钥管理、速率限制报告、工作负载身份联合(Workload Identity Federation)及客户自管密钥(CMEK)等企业级管理能力。
本次版本修复了多项影响稳定性的关键缺陷。子代理在首次调用时若遭遇模型 404 错误,此前会直接崩溃;现在子代理会自动切换至会话的备用模型链继续运行,并将包含错误类型、状态码、请求 ID 和模型名称的详细错误信息返回给父代理。此外,当钩子或后台代理输出数兆字节的错误日志时,原本可能导致会话因「Prompt is too long」而完全卡死,此问题现已修复,同时修复了后台任务输出文件无法写入时引发的无限内存增长问题。
键盘与终端交互方面同样得到多项修复。在使用 kitty 协议的终端中,非拉丁键盘布局(如西里尔字母)下 Ctrl 快捷键无法触发的问题已解决。历史搜索、/config、/mcp、/skills、后台任务及 /model 等界面中,快速按方向键后按 Enter 会误操作上一行的问题也已修复。鼠标报告在转义前缀后跨读分割到达时,类似 <35;150;7M> 的原始字符被插入输入框的问题同样得到处理。/terminal-setup 命令此前会覆盖整个 Zed keymap.json 文件,现已改为仅合并所需的快捷键绑定。
云端会话与插件生态方面,本次更新修复了云端会话在发送消息后立即切换权限模式时显示旧模式的问题,以及容器在后台代理、Shell 或监控器运行期间重启导致会话静默失联的问题——恢复后的会话现在会主动报告丢失的工作内容。插件市场安全性得到加固,名称中包含控制字符或不可见字符的插件将被拒绝,市场提供的文本在 /plugin 输出中也经过转义处理。Bedrock、Vertex 和 Foundry 等会话现在会在 MCP 服务器连接失败时明确告知 Claude,而非让其误以为相关工具不存在。
行为层面的调整同样值得关注。Sonnet 5 的默认自动压缩窗口已扩展至完整的 100 万 Token 上下文,自动压缩触发点从约 93.4 万 Token 提升至约 96.7 万 Token,减少了不必要的压缩频率。跨会话的对等消息现在默认折叠为单行预览,按 Ctrl+O 可展开完整内容。Markdown 渲染中指向网络路径、包含控制字符或以不可见字符开头的超链接目标,现在将以纯文本形式呈现,避免潜在的安全风险。分析数据收集在托管设置强制网关登录或配置了自定义 OAuth 部署时,将从启动阶段起就保持关闭状态。
要点
- 新增 SendFeedback 工具,Claude 可在会话异常时自动起草反馈报告,支持通过 feedbackDrafts 设置关闭。
- /claude-api cost-optimize 命令提供系统化的 API 成本优化引导,涵盖缓存、批处理、模型选型等多个降本维度。
- 子代理首次调用遭遇模型 404 时不再崩溃,改为自动切换备用模型链并向父代理返回详细错误信息。
- Sonnet 5 自动压缩触发点从约 93.4 万 Token 提升至约 96.7 万 Token,减少不必要的上下文压缩。
- 云端会话容器重启后可恢复并报告丢失工作,插件市场安全加固拒绝含控制字符的插件名称。