如何更新 Claude Code 并确认新版本生效

按原生安装、Homebrew 或 WinGet 更新 Claude Code,先检查版本与安装位置,更新后验证实际执行文件,并排查版本不变的常见原因。

更新 Claude Code 之前,先确认当前执行文件通过什么方式安装。如果更新了另一份副本,或不知不觉换了安装方式,即使命令成功,终端也可能还在运行旧版。

本文根据 2026 年 10 月 10 日核对的官方安装说明整理。它不会替你安装或更新,也不假定所有发布渠道的最新版本号都相同。

记录版本与安装位置

先运行只读检查。

sh
claude --versionclaude doctor

在 macOS 或 Linux 上,可以用 command -v claude 查看 Shell 找到的执行文件。保存相关结果时不要暴露私人环境值。公司管理的电脑应先确认获批的安装渠道。

机器上可能同时有旧全局软件包、原生安装和软件包管理器安装的副本。终端按搜索路径找到可执行文件,未必选中你刚更新的那一份。

沿用原来的安装渠道

原生安装按官方更新方式处理。

sh
claude update

Homebrew 应更新实际安装的 cask。当前文档区分稳定渠道与 latest 渠道。

sh
brew upgrade claude-code# Or, only if this is the cask you installed:brew upgrade claude-code@latest

已有 WinGet 安装使用以下命令。

powershell
winget upgrade Anthropic.ClaudeCode

不要把上面所有命令依次执行,只选择对应安装方式。其他软件包管理器按官方说明操作。更新过程中出现新权限或协议,也应阅读后再决定。

针对 2.1.296 的修复验证什么

官方 2.1.296 版本发布于 10 月 9 日,本文于 10 月 12 日核对。其中几项修复值得结合实际工作流检查。这里引用版本是为了说明变化,不是在建议绕过组织批准的发布渠道。

如果你遇到这类情况该版本修复的内容更新后应验证什么
升级 2.1.295 后,保存的网关登录失效组织管理的网关登录未配置网关 URL 时出现的回归重启获批客户端,检查原定网关身份能否使用;不要换成个人 Key 绕过
无交互任务使用按文件夹启用或禁用的 MCP 服务切换目录或重新加载插件后,部分已禁用服务可能被启动在不含敏感数据的测试项目重复相应操作,确认禁用状态仍生效
需要分享对话记录或诊断日志自动脱敏可能遗漏部分密钥值更新后也要在分享前检查;测试脱敏时只用虚构凭据

更新客户端不会收回已经发出的日志。如果真实凭据可能泄露,应按供应商流程撤销或轮换,并检查资料曾发往哪里。

同一版本还修正了 Sonnet 5.5 缓存读取费用的显示计算。这是客户端计费展示的修正,不能证明供应商刚给你的账号降价,也不代表此前费用已退款。实际用量仍应与供应商账单核对。

这些是根据官方更新说明整理的验证项,不是对你当前安装环境的实测结果。反馈问题时,应把未通过的检查、实际版本和相关脱敏报错放在一起。

2.1.299 具体更新了什么

官方 2.1.299 版本发布于 2026 年 10 月 14 日。按获批渠道更新后,选择与自己环境相关的变化验证。

工作方式相关变化应检查什么
云会话因 claude.ai 登录过期而被拒绝拒绝提示现在给出更明确的登录指引先核对账户与凭据来源,再按指引处理;更新本身不会续签登录
第三方网关使用自定义 API 地址多类发往 Anthropic 的辅助请求不再携带网关 API Key核对实际配置的供应商,不据此认定所有集成或以前分享的记录都安全
网关输出流长时间无数据,或 Remote Control 无法连接电脑自定义接口无数据等待从 180 秒延长至 300 秒;远端电脑不可达时,输入保留在框中且 Send 不可用等待变长不等于执行成功;先确认重连,再判断消息是否送达

这些变化不能保证供应商会接受请求,也不能保证停止的电脑会恢复任务。记录实际报错、所选账户,以及消息是否到达正在运行的会话。Macshop 托管环境可能使用不同的受管理版本,不要默认已经安装了这个发行版。

重启后检查实际运行情况

先保存未完成的任务,按要求关闭相关客户端,再开启新会话,重新检查版本和路径。

随后在熟悉的项目里测试一个无副作用的操作,例如说明某个文件,或执行已有只读检查。版本号只能证明执行文件的版本,不能证明模型、hooks 和外部集成都正常。

使用模型切换 hooks 的工作流,可以参考模型切换 hook 指南,单独验证相关行为。更新成功不等于所有项目配置都兼容。

版本没有变化时查什么

重装之前,先考虑以下原因。

  • 当前发布渠道刻意晚于另一渠道。
  • 软件包管理器还没有提供目标版本。
  • 搜索路径更靠前的位置还有另一份执行文件。
  • 长时间运行的客户端尚未重启。
  • 版本由组织策略统一控制。

保留完整报错与安装方式。遇到权限错误时,不要直接大范围修改目录所有权、删除配置文件夹,或随意给其他命令加管理员权限。

团队更新要留验证记录

团队可以记录已测版本、安装渠道与受影响的集成,先在代表项目验证,再推广给其他人。某项功能需要新版时,链接该功能的版本要求即可,避免在文章标题里写一个很快过期的“最新版本号”。

更新也不会新增模型权限或订阅额度。用量限额排查指南处理的是安装更新无法解决的问题。

如果使用 Macshop 的托管方式,应遵循该环境的支持规则,不要运行无权管理的主机更新命令。先看在 Macshop 使用 Claude Code,确认符合需要后再创建工作空间。