更新 Claude Code 之前，先确认当前执行文件通过什么方式安装。如果更新了另一份副本，或不知不觉换了安装方式，即使命令成功，终端也可能还在运行旧版。
本文根据 2026 年 10 月 10 日核对的官方安装说明整理。它不会替你安装或更新，也不假定所有发布渠道的最新版本号都相同。
记录版本与安装位置
先运行只读检查。
在 macOS 或 Linux 上，可以用 command -v claude 查看 Shell 找到的执行文件。保存相关结果时不要暴露私人环境值。公司管理的电脑应先确认获批的安装渠道。
机器上可能同时有旧全局软件包、原生安装和软件包管理器安装的副本。终端按搜索路径找到可执行文件，未必选中你刚更新的那一份。
沿用原来的安装渠道
原生安装按官方更新方式处理。
Homebrew 应更新实际安装的 cask。当前文档区分稳定渠道与 latest 渠道。
已有 WinGet 安装使用以下命令。
不要把上面所有命令依次执行，只选择对应安装方式。其他软件包管理器按官方说明操作。更新过程中出现新权限或协议，也应阅读后再决定。
重启后检查实际运行情况
先保存未完成的任务，按要求关闭相关客户端，再开启新会话，重新检查版本和路径。
随后在熟悉的项目里测试一个无副作用的操作，例如说明某个文件，或执行已有只读检查。版本号只能证明执行文件的版本，不能证明模型、hooks 和外部集成都正常。
使用模型切换 hooks 的工作流，可以参考模型切换 hook 指南，单独验证相关行为。更新成功不等于所有项目配置都兼容。
版本没有变化时查什么
重装之前，先考虑以下原因。
- 当前发布渠道刻意晚于另一渠道。
- 软件包管理器还没有提供目标版本。
- 搜索路径更靠前的位置还有另一份执行文件。
- 长时间运行的客户端尚未重启。
- 版本由组织策略统一控制。
保留完整报错与安装方式。遇到权限错误时，不要直接大范围修改目录所有权、删除配置文件夹，或随意给其他命令加管理员权限。
团队更新要留验证记录
团队可以记录已测版本、安装渠道与受影响的集成，先在代表项目验证，再推广给其他人。某项功能需要新版时，链接该功能的版本要求即可，避免在文章标题里写一个很快过期的“最新版本号”。
更新也不会新增模型权限或订阅额度。用量限额排查指南处理的是安装更新无法解决的问题。
如果使用 Agent.Space 的托管方式，应遵循该环境的支持规则，不要运行无权管理的主机更新命令。先看在 Agent.Space 使用 Claude Code，确认符合需要后再创建工作区。