AI资讯 / 工程

工程 / 官方

新增 AGENTS.md 支持,修复数十项稳定性问题

Claude Code Releases

Anthropic 于 2025 年 9 月 18 日发布 Claude Code v2.1.277,这是一次覆盖面极广的版本更新。新功能方面,当项目中不存在 CLAUDE.md 时,Claude Code 现在可自动读取 AGENTS.md 作为项目指令来源,与主流 AI 代理生态实现更好的互操作性。网关层面新增了出口代理边界环境变量和自定义静态请求头支持,方便企业在自建代理前置架构下灵活配置。此次更新修复了超过 50 项已知问题,涵盖会话挂起、工具调用崩溃、插件安装损坏、编辑工具转义字符处理错误、Windows 内存溢出、提示缓存命中率下降等多个影响日常使用的关键缺陷。VSCode 扩展新增了登出入口、后台任务管理、响应复制按钮及会话成本统计等功能。Web 端则优化了团队与企业计划的环境管理体验,并修复了多个云环境配置回退问题。

Claude Code v2.1.277 最受关注的新特性是对 AGENTS.md 的支持。当项目根目录下不存在 CLAUDE.md 时,Claude Code 将自动读取 AGENTS.md 作为项目级指令文件,用户也可在 /config 的「项目指令」选项中手动切换。这一改动使 Claude Code 与 OpenAI Codex、Cursor 等同样采用 AGENTS.md 约定的 AI 编程工具实现了更好的互操作性,降低了多工具混用时的配置成本。目前该功能尚未在 Bedrock、Vertex 和 Foundry 部署上线。

网关与代理配置方面,本次更新新增了两项企业级能力。新环境变量 CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 适用于出口流量仅经过正向代理的网关场景,启用后所有出站请求将把主机名直接交由代理处理,而非在本地解析 DNS。此外,Claude 应用网关的上游配置现在支持可选的 headers 映射,允许向自建代理转发静态请求头,满足需要在提供商前置自定义鉴权或路由逻辑的企业部署需求。

稳定性修复是本次版本的重头戏。此前 claude -p 和 Agent SDK 会话在遭遇内部错误后可能无限挂起且不返回任何结果,现已修复为主动上报错误并以退出码 1 终止。Edit 工具存在两处转义字符处理缺陷:一是将反斜杠加 uXXXX 序列误识别为 Unicode 转义,导致非 ASCII 字符编辑时意外改写转义序列;二是在超大非 ASCII 文本未匹配时抛出「正则表达式过大」而非「文件中未找到字符串」的错误提示,两处均已修正。

插件系统经历了多项重要修复。重新安装正在被当前会话或其他程序占用的插件版本时,旧版本将不再被破坏性覆盖,而是保持原样。已卸载的插件不再以「加载失败」的形式残留在已安装列表中,Remove 操作也能正确清除对应条目。官方市场插件的提交记录现在会被正确写入 installed_plugins.json,固定提交版本的插件在更新后也能同步刷新记录。此外,插件重载预览不再将每次预览的解压副本保留至退出,避免了磁盘空间的无谓占用。

VSCode 扩展在本次更新中获得了多项实用功能。新增了面板菜单中的「登出」入口和 /logout 命令;后台 Shell 及运行中的任务现在显示在代理地图中,每项任务均可单独停止;响应区域新增「复制响应」按钮,同时支持 /copy 命令;会话成本与 Token 用量统计已加入账户与用量对话框,适用于 Vertex、Bedrock、Foundry 及 API Key 用户。多个已知的模式选择器、努力滑块持久化及 /fast 模式保存问题也一并得到修复。

提示处理与安全性方面同样有所改进。系统现在会自动移除提示中的不可见 Unicode 格式字符和标签字符,并在发送前展示清理后的内容供用户确认,有效防范提示注入风险。子代理返回的结果现在会以明确的标头标注为子代理输出,防止子代理结果中的文本被误读为主会话指令。危险 rm 命令的权限提示也得到改进,会具体指出被标记的命令并建议使用 ${VAR:?} 防护写法,帮助无交互运行场景下的用户快速定位和恢复。

要点

  • 新增 AGENTS.md 支持,当项目无 CLAUDE.md 时自动读取,与主流 AI 编程工具生态实现互操作,但暂不支持 Bedrock、Vertex 和 Foundry。
  • 修复超过 50 项稳定性缺陷,涵盖会话挂起、Edit 工具转义字符错误、插件安装损坏、Windows 内存溢出及提示缓存命中率下降等高频问题。
  • 企业网关新增出口代理边界环境变量和自定义静态请求头,满足复杂私有化部署场景的网络配置需求。
  • VSCode 扩展新增登出、后台任务管理、响应复制及会话成本统计等功能,显著提升日常使用体验。
  • 提示安全性增强:自动清除不可见 Unicode 字符,子代理输出明确标注来源,防范提示注入攻击。
查看原始来源

原始标题:v2.1.277

本文由 DataHub 基于公开来源整理,用于信息发现与摘要阅读;具体事实、数据和后续更新以原始来源为准。