AI 编程开发

Claude Code v2.1.318 发布:登录过期提示、MCP 配置锁与多项稳定性修复

Anthropic 于 2026 年 11 月 4 日发布 Claude Code v2.1.318。该版本在新增登录凭证过期提示、网关跨账号角色与 mod 分叉 effort 选项等功能的同时,修复了 –continue 丢失历史对话、MCP 配置写入未加锁、共享网络家目录下配置被静默丢弃等一批问题,并调整了 IDE 扩展安装与子智能体后台化等默认行为。

登录凭证过期可见性与认证修复

v2.1.318 把已存储 claude.ai 登录的到期日期暴露出来:claude auth status 中新增 loginExpiresAt 字段,claude -p 的 JSON 结果中新增 credential_expires_at 字段。同时,claude -p 的文本输出会在登录到期前 10 天开始向 stderr 打印一行警告。

当存储的 claude.ai 登录到达时限时,此前的登录失败现在会明确说明原因,并在 claude -p 中提示使用 claude auth login 和 claude setup-token。此外,在配置了 forceLoginOrgUUID 的机器上,若 setup-token 生成的令牌属于被允许的组织,启动时不再被拒绝。

网关与 mod 能力扩展

Claude apps 网关的 mantle 上游新增 assume_role 支持,可用于另一 AWS 账户中的角色,并支持按开发者进行 AWS 成本归因。网关还会在来自 federation(external_account)凭证文件的 Google 访问令牌即将过期时输出日志警告。

mod 方面,$.model.fork 新增 effort 选项,使快速附带任务可以按会话所用的低 effort 运行,结果中会报告实际发送的 effort。此外,mod 在 prompt.submit 时附加的内容改为留在用户回合内,而不再作为系统消息发出。

会话续接与 MCP 配置可靠性

本次修复了 –continue 在畸形工具调用的重试耗尽后有时丢失先前对话的问题,该问题被标注为 2.1.314 引入的回归。同时修复了空闲压缩把对话替换为非摘要回复、以及重启会话重复发送 API 报错消息等问题。

MCP 相关修复集中在配置写入:claude mcp add 和 remove 此前写配置时不加锁,现在会等待锁或退出码 1,但另一任务的保存仍可能覆盖已保存的服务器。stdio MCP 服务器若在版本探测时退出,不再每次启动都重新探测;因自身原因在 3 秒内退出的服务器会被固定为旧版握手 7 天。MCP 工具错误信息也有改进,工具加载前发起的调用现在会返回其输入 schema。

共享网络家目录与配置文件保护

针对共享网络家目录场景,v2.1.318 改进了 ~/.claude.json、设置文件和已存储登录在保存时的存活能力,减少被删除、短暂清空或被近乎空白的旧副本替换的情况。当配置文件被错误报告为缺失时,网络文件系统上的会话会重新检查,从而减少启动时缺少 MCP 服务器和受信任文件夹的情况。

配置损坏的处理也更明确:非交互启动遇到无效 JSON 的 ~/.claude.json 时不再用默认值替换,而是启动失败、说明如何恢复并保持文件原样;没有备份的空文件不再被报告为损坏,而是按文件缺失处理。保留清理在仅运行 claude -p 且无备份的家目录上,会先做新备份再删除最后一个可用备份。

默认行为调整与云会话更新

行为变更方面,Claude Code 在 IDE 终端中启动时不再安装或更新 IDE 扩展,需从外部终端使用 /ide 或通过编辑器扩展视图安装。后台子智能体在所有提供商上会在 shell 命令运行 3 分钟后将其转入后台,以避免提示缓存过期。当“消息被标记时切换模型”设为“每次询问”时,子智能体改为停止而非切换模型。

云会话新增 No repository 选项,可在 Anthropic 托管环境中不选仓库直接启动;内置 Chromium 增加了常见 Chrome 名称,便于 Playwright 之外的工具通过 google-chrome 和 CHROME_PATH 找到它。云会话中读取 GitHub Actions 日志、创建 PR 的失败提示以及连接器搜索结果说明也有修复与改进。

知序观察

观察:v2.1.318 的更新重心偏向可靠性而非新功能,登录过期可见性、MCP 配置加锁和网络家目录配置保护都指向长期运行与多环境协作中的易损环节。对团队用户而言,配置损坏时的明确报错与恢复指引比静默回退更有价值;但 MCP 保存仍可能被并发任务覆盖,说明锁机制只解决了一部分竞态问题。

留下你的想法

欢迎交流。你的邮箱地址不会公开。