先运行 claude --version 和 claude doctor,确认正在启动哪个安装入口,再按安装方式更新。 更新下载完成后,通常需要重新启动 Claude Code 才会使用新版本。
先收集当前结果
在终端执行:
claude --version
claude doctor
claude doctor 会输出只读安装及配置诊断。macOS 或 Linux 还可以用 command -v claude 查看当前命令指向的位置。记录结果后结束旧会话,重新打开终端再检查版本。
若电脑上曾同时使用 npm、原生安装和 Homebrew,PATH 中排在前面的入口决定启动对象。优先修正已确认的路径问题,保留配置和项目文件。
按安装来源选择升级方式
| 安装方式 | 当前更新方式 |
|---|---|
| 原生安装 | 默认后台检查更新;可运行 claude update |
| Homebrew 的 claude-code | brew upgrade claude-code |
| Homebrew 的 claude-code@latest | brew upgrade claude-code@latest |
| WinGet | winget upgrade Anthropic.ClaudeCode |
只运行与你实际安装来源相符的一项。原生更新安装好新版本后,下一次启动才生效。包管理器可能晚于应用内通知发布新版本,升级没有新内容时可稍后再查对应渠道。
stable 与 latest 为什么版本不同
原生安装通过 autoUpdatesChannel 控制渠道,可在 /config 中查看。latest 接收新发布版本,stable 通常延后约一周并跳过重大回归版本。
Homebrew 用 cask 名区分渠道:当前官方说明 claude-code 跟随 stable,claude-code@latest 跟随 latest。配置里的原生渠道设置不能替代这一区别。
团队若设有 minimumVersion 或组织版本范围,还需核对管理策略。新模型需要更高客户端版本时,也要同时检查当前渠道是否已提供。
仍然是旧版时怎么交给支持
整理系统版本、安装方式、claude --version、claude doctor 中的相关错误和升级命令结果。删除凭据及无关个人路径后提交。支持人员可据此定位下载、安装、命令路径或旧进程的问题。
常见问题
Q: 更新提示成功,当前会话版本会立即变吗?
A: 原生后台安装的新版本在下次启动生效。保存任务进度后重新启动再核对。
Q: claude update 适用于 Homebrew 吗?
A: Homebrew 默认由包管理器升级,使用对应 cask 的 brew upgrade 命令。
Q: stable 落后一周是异常吗?
A: 官方把 stable 定位为通常延后一周的稳定渠道;具体版本仍以当前分发结果为准。
Q: 要先删除配置目录吗?
A: 先用 doctor 与命令路径定位安装问题,保留原配置和工作进度,按具体诊断修复。
Q: 更新通知出现了,brew 却没有新版本怎么办?
A: 官方记录了通知先于包管理器上架的情况,核对 cask 和渠道后等待分发,再重试升级。
Q: 这套步骤会升级其他软件吗?
A: 表格中的 Homebrew 命令指定了 Claude Code 的 cask;执行前仍应检查终端实际列出的操作范围。