Claude Code 更新日志（2.1.277） 2026年9月18日
- 新增 AGENTS.md 支持：当项目中没有 CLAUDE.md 时，Claude Code 会改为读取 AGENTS.md；可在 /config 的“Project instructions”下修改（暂不支持 Bedrock、Vertex 或 Foundry）
- 为唯一出口是正向代理（forward proxy）的 Claude apps 网关新增 CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1：每次出站请求都会将主机名交给代理，而不是在本地解析
- 为 Claude apps 网关上游新增可选的 headers: map，用于向部署在提供商前面的自有代理发送静态请求头
- 新增提示行：当后台任务在 /tasks 等面板打开时完成，会提示其更新正在等待显示
- 修复 claude -p 和 Agent SDK 会话在内部错误后可能挂起且无结果的问题；现在会报告错误并以退出码 1 退出
- 修复当较早的助手回合在其他内容旁边包含空文本块时，会话每次请求都失败并报“text content blocks must be non-empty”的问题（包括 –resume 之后）
- 修复在同一台机器上运行旧版 Claude Code 构建（例如 IDE 扩展捆绑的 CLI）时被意外登出的问题
- 修复 ~/.claude.json 中的 customApiKeyResponses 值格式错误时，ANTHROPIC_API_KEY 用户的交互式启动挂起或报错的问题
- 修复当代理返回无效版本时更新检查每 30 分钟报错、以及在设置最低/最高版本时 claude update 挂起的问题；格式错误的 minimumVersion 现在会被忽略
- 修复在 winget 或 apk 管理的安装上，版本查询失败时 claude update 误报“已是最新”的问题
- 修复重新安装会话或其他程序正在使用的插件版本时，claude plugin install 有时失败并破坏已安装副本的问题；未更改的副本现在保持原样
- 修复在系统进程、内存或文件句柄耗尽导致搜索无法启动时，Grep 和 Glob 报告无匹配的问题；现在会返回相应错误说明
- 修复当目标路径是已存在的目录时，Write 工具将回合静默结束为“权限被拒绝”的问题；现在会报告明确错误
- 修复 Edit 工具将转义反斜杠后跟 uXXXX 文本误判为 \uXXXX 转义的问题，这可能导致对非 ASCII 字符的编辑重写转义的反斜杠序列
- 修复当包含非 ASCII 文本的超大编辑与文件不匹配时，Edit 工具报“Invalid regular expression: regular expression too large”而非“String not found in file”的问题
- 修复当工具调用的文件路径包含以转义序列写出的 \u0000 时，回合提前结束并报“Path contains null bytes”的问题；转义的控制字符现在保持为字面文本
- 修复后台会话（claude –bg）在插件的 LSP 服务器退出或关闭其 stdin 时退出的问题
- 修复 ~/.claude.json 中 claudeAiMcpEverConnected 值格式错误时打开 /mcp 或 /plugin 管理页面崩溃（“Type error”）的问题
- 修复 ~/.claude.json 中的 theme 值格式错误时启动崩溃的问题
- 修复提示词中包含终端颜色代码的文本（例如从历史记录调出或从外部编辑器加载）时崩溃（“unrecoverable interface error”）的问题
- 修复恢复保存历史中包含以纯字符串存储的助手消息的会话时崩溃的问题
- 修复在缓慢或高负载机器上，第一个加载动画出现时会话有时以“Claude Code exited after an unrecoverable interface error”退出的问题
- 修复内部渲染错误后屏幕在整个会话剩余时间内停止更新的罕见情况
- 修复 Windows 上的罕见情况：Claude 回复后回合可能立即以“Out of memory”等错误停止，导致该回复的工具调用从未运行
- 修复在 /clear（重启、–continue、–resume）之后继续的会话在 SessionStart 钩子有输出时丢失其第一条消息的一部分、导致提示词缓存（prompt cache）完全未命中的问题
- 修复来自其他代理的消息（例如子代理的 SendMessage）在回合中途到达时，显示在“Ran N shell commands”行下方而非其到达位置的问题
- 修复在全屏 /resume 选择器及其他覆盖提示区域的面板中拖选文本后“已复制”提示不显示的问题
- 修复在启用沙盒的情况下、在沙盒外运行的 Bash 命令中 $TMPDIR 展开为空的问题
- 修复 Cowork 云会话中的 WebFetch 和 WebSearch 不告知 Claude 请求被拒绝原因（如抓取预算用尽或管理员策略）的问题
- 修复设置了代理时，Claude apps 网关的遥测中继忽略 NO_PROXY 中所列收集器主机名或域名的问题
- 修复一条格式错误的 strictKnownMarketplaces 或 blockedMarketplaces 条目静默禁用整个企业市场策略的问题
- 修复失败的自动更新在 ~/.cache/claude/staging 留下大型暂存下载文件的问题
- 修复 /plugin 未从 Installed 标签页消息中剥离终端控制字符的问题（例如插件更新失败的错误信息）
- 修复 /plugin → Installed 和 /skills 在技能或旧版命令命名为内置 Object 属性（如 constructor 或 toString）时崩溃的问题
- 修复多选安装全部失败时 /plugin 无提示关闭的问题
- 修复已卸载插件在 /plugin Installed 中重新显示为“failed to load”行、且 Remove 未清除此类行的问题
- 修复官方市场的插件在 installed_plugins.json 中未记录其 commit，以及更新固定 commit 的插件后保留旧 commit 的问题
- 修复插件重新加载预览在退出前保留插件存档的所有预览副本，并在下载失败时覆盖重新加载回退所用的缓存 –plugin-url 存档的问题
- 修复 ~/.claude.json 中占位记录格式错误时 Remote Control 会话记账失败的问题
- 修复已撤销的 claude.ai 登录后的错误归咎于过期的 Anthropic 配置文件的问题；现在以 /login 开头
- 修复在 claude agents 分发输入中按键重复或输入过快时，键入或粘贴的文本偶尔乱序的问题
- 修复恢复的会话的保存转录中包含格式不良的停止钩子摘要时崩溃（“unrecoverable interface error”）的问题
- 修复当 keybindings.json 在 Chat 上下文中重新绑定 Enter（例如绑定到 chat:queueSubmit）时，在选中的代理面板行上按 Enter 无反应的问题
- 修复工作文件夹路径较长（约 120 字符或更多）时 Windows 上 PDF 页面读取失败的问题
- 修复无头恢复（claude -p –resume、SDK、VS Code 扩展窗口重载）将会话的成本和用量总计从零开始的问题；无头会话现在会在退出时保存总计
- 修复当 .claude/skills 未被追踪时，–worktree 会话中主仓库的项目技能不加载的问题
- 修复 sandbox.excludedCommands 通配符在复合 Bash 命令仅一部分匹配时豁免整个命令脱离沙盒的问题；现在每个部分都必须匹配
- 修复恢复的子代理和队友重新渲染其已加载的 MCP 工具定义、从而破坏该代理提示词缓存的问题
- 修复被限流的 artifact 发布告知 Claude 停止重试的问题
- 修复对话中较早记录的附件在恢复或重新启动后重新渲染的问题，这会丢失扩展思考（extended thinking）并错过提示词缓存
- 修复服务器拒绝创建 API 密钥时 Console 登录只显示“Request failed with status code 400”的问题；现在会显示服务器的消息
- 修复 Claude 仍在工作时键入的消息有时被模型忽略的问题
- 改进 SDK 和无头（-p）用途的会话启动：第一回合不再等待每个目录的 CLAUDE.md 查找
- 改进 Claude apps 网关的回环错误消息，指明 CLAUDE_GATEWAY_ALLOW_LOOPBACK
- 改进 /plugin Installed：与插件分开列出的 MCP 服务器现在显示其所属插件
- 改进对已安装插件的 claude plugin install：现在会在市场提供更新版本时说明，并给出 claude plugin update 命令
- 改进徽标下的启动通知溢出行：现在显示“N more notices hidden”而不是“+N more · /status”
- 改进提示词处理：提示词中不可见的 Unicode 格式和标签字符会被移除，清理后的提示词在发送前显示供审查
- 改进没有可审查内容时的 /ultrareview：消息会说明你所处的情形，提供审查最新提交的命令，新仓库的首次提交会被完整审查
- 改进 artifact 链接处理，使 Claude 在 Artifact 工具可用时用它而非 WebFetch 读取 claude.ai artifact 链接
- 改进危险 rm 权限提示，指出被标记的 rm 命令并建议 ${VAR:?} 保护，使无头运行可以恢复
- 改进 Artifact 工具的权限提示：更简短的句子、按标题或文件名命名页面和 artifact、链接列在文本之后
- 变更：Fable 在 Anthropic API 上始终出现在 /model 中；仅当组织设置禁用它时才变灰
- 将 Bedrock、Vertex 和 Foundry 上的 Bash 沙盒指令改为一方措辞，将沙盒界定为任务被赋予的边界
- 变更：非交互式会话中的 /ultrareview 在仓库没有基础分支或共享历史时拒绝执行
- 变更：子代理结果以标头标记为子代理输出、结果缩进的方式送达主代理，使子代理结果中的文本无法冒充会话自身的指令
- 将 Bedrock、Vertex 和 Foundry 上工作流脚本的 agent() 计算提示词改为以脚本编写文本的形式送达子代理，使安全分类器不会将其读作用户
- 从在 SDK 或 IDE 之外启动的 claude -p 运行中移除后台 Haiku 自动标题请求
- 移除已弃用的 TaskOutput 工具；Claude 改用 Read 读取后台任务的输出文件，taskOutputMaxChars 设置和 TASK_MAX_OUTPUT_LENGTH 不再有效
- [VSCode] 在面板菜单中添加 Sign out 行，并在键入命令菜单中提供 /logout
- [VSCode] 将后台 shell 和其他运行中的任务添加到代理映射，每个都有 Stop，并提供打开它的键入 /tasks
- [VSCode] 在响应上添加 Copy response 按钮和键入的 /copy
- [VSCode] 为不活跃会话自动归档添加一次性通知，并在“已归档会话”组上添加“全部取消归档”操作
- [VSCode] 在不适用计划限制的会话（Vertex、Bedrock、Foundry、API 密钥）的 Account & usage 对话框和会话管理器中添加会话成本和 token 用量
- [VSCode] 修复“General config”菜单行显示 /config 用法文本而不是打开设置的问题，并使键入的 /mcp、/hooks、/memory、/rewind 等命令打开其对话框
- [VSCode] 修复已用 /effort 保存过级别的模型上，努力程度滑块的级别未持久化到后续会话的问题
- [VSCode] 修复在已使用面板中打开的对话的模式选择器缺少 Auto 的问题（当保存的模型设置是大小写不同的别名如“Sonnet”时）
- [VSCode] 修复 /fast 未将快速模式保存为默认、在扩展重启 Claude Code 后丢失的问题
- [Claude Code on the web] 在 Team 和 Enterprise 计划的环境选择器中添加 Personal 和 Organization 部分，管理员现在可以与组织共享个人环境
- [Claude Code on the web] 将 Team 和 Enterprise 计划中从 Code 标签页打开的组织环境改为只读摘要，编辑移至 Admin settings → Cloud environments
- [Claude Code on the web] 修复以“Custom network access”保存且无域名的云环境静默回退到“Trusted”的问题；对话框现在要求至少一个域名
- [Claude Code on the web] 将管理员 Claude Code 设置中标记为“Web”的改为“Cloud sessions”，并移除其下方冗余的只读 Mobile 行
- [Claude Tag] 修复在 Enterprise Grid 组织范围安装的 Slack 频道中创建的例程运行时无法读取其工作区其他公共频道的问题
- [Claude Tag] 修复 Claude Tag 访问包中凭证预设的“了解更多”链接打开各供应商的凭证设置页面而非通用 API 参考的问题
- [Claude Tag] 更改 Claude Tag 访问包中的 Pylon 凭证预设，使管理员可以指向 Pylon 的 EU 主机
- [Claude Tag] 修复 Claude Tag 访问包中的 Google Cloud 凭证表单：被拒绝的密钥文件现在说明原因，网站和范围保持锁定，被拒绝的轮换保留已粘贴的密钥
- [Claude Tag] 修复 Claude Tag 管理设置中的网络事件日志对通过使用 AWS 签名、客户端证书或自定义 CA 的连接的请求不显示响应状态的问题