Claude Code 能够顺利启动固然令人安心，但先别急着下结论。真正值得关注的地方在于更新路径本身：原生安装会在后台静默检查新版本，而通过 Homebrew、WinGet、Linux 包管理器以及 npm 安装的版本，则必须沿着各自的安装来源进行升级。很多用户正是在这一步遇到问题——明明看到“已是最新”的提示，实际上包管理器根本没有执行更新操作。因此，在开始之前，先确认当前版本和安装状态，再决定是等待后台自动更新，还是主动执行升级命令，这样才能避免“看起来没问题，实际版本已经落后好几个版本”的尴尬局面。
这套流程在 Windows、macOS 和 Linux 系统上均适用。最终目标很明确：记录下更新前的版本号，确认更新通道，根据安装来源执行一次正确的升级操作，最后通过版本号和诊断结果来验证整个更新是否成功。
先锁定更新前的版本基线
-
入口位置：打开实际运行 Claude Code 的终端——Windows 原生安装请使用 PowerShell 或 CMD，WSL、macOS 和 Linux 则使用对应的 Bash 或 Zsh 终端。
主要动作：首先执行
claude --version，将输出的版本号记录下来；接着运行claude doctor，检查安装类型、配置文件以及最近一次更新尝试的状态。成功标志：版本命令返回版本号和 Claude Code 名称，doctor 命令给出诊断结果，且没有阻断启动的错误提示。这个版本号就是后续判断升级是否生效的基准线。
失败处理：如果出现
command not found或“无法识别命令”的提示，先关闭当前终端窗口再重新打开；如果问题仍然存在，请检查 Claude Code 的安装目录是否已添加到 PATH 环境变量中。如果 doctor 提示配置文件错误，请先按照提示修复配置，然后再进入更新环节。
官方 Advanced setup 页面将 claude --version 和 claude doctor 放在同一个验证区域——前者用于确认程序版本，后者负责更详细的安装与配置诊断。
分清后台更新适用于哪种安装
-
入口位置：查看
claude doctor输出的安装信息，然后回忆最初是通过 Claude Code 原生安装脚本、Homebrew、WinGet、apt、dnf、apk 还是 npm 安装的。主要动作：原生安装可以依赖后台自动更新——Claude Code 会在启动时和运行期间定期检查，下载与安装均在后台进行，新版本通常会在下一次启动时生效。如果是通过包管理器安装的，请不要依赖这条后台更新路径，后续升级仍需要由相同的包管理器负责。
成功标志：清楚知道自己属于“原生自动更新”还是“包管理器更新”类型，后续使用的命令与最初的安装来源保持一致。
失败处理：如果无法判断安装来源，不要混着执行多组命令。先运行
claude doctor，再检查终端的命令位置：Windows 使用where claude，macOS 和 Linux 使用which claude。如果发现多个路径，请先处理重复安装的问题，避免升级了一份却启动另一份。
截图中的 Auto-updates 区域说明了两个关键时间点：更新在后台下载和安装，下一次启动时才会切换到新版本；最近一次尝试的结果可以通过 doctor 查看。
在 latest 与 stable 之间做一次明确选择
-
入口位置：启动 Claude Code 后输入
/config，找到 Auto-update channel；也可以在用户级settings.json文件中检查autoUpdatesChannel字段。主要动作：如果希望新功能发布后尽快收到更新，请选择
latest（这也是默认值）；如果更看重稳定性，请选择stable，该通道通常落后约一周，并且会跳过存在重大回归问题的版本。写入设置文件时，将autoUpdatesChannel的值设为latest或stable。成功标志：
/config显示目标通道，或者保存后的settings.json能被 Claude Code 正常读取，没有格式错误。失败处理：设置保存后没有生效，请先检查 JSON 文件中的逗号、引号和层级结构。如果配置由组织统一管理，个人设置可能被覆盖，应以管理员下发的通道为准。对于 Homebrew 安装，通道是通过 cask 名称选择的，不要只修改这个字段。
官方页面对两个通道的区别说明得很清楚：latest 接收每次发布，stable 使用通常约一周前、且避开重大回归的版本。截图中的 autoUpdatesChannel 示例可用于核对字段拼写。
原生安装需要立刻升级时运行 claude update
-
入口位置：回到能正常执行
claude --version的同一个终端，先退出正在运行的 Claude Code 交互会话。主要动作：执行
claude update。这会立即检查并应用目标通道上的更新，无需等待下一次后台检查。成功标志：如果有新版本，终端会显示从旧版本更新到新版本的信息；如果已经处于目标通道的最新版本，终端会明确提示 Claude Code 已是最新状态，并显示当前版本号。
失败处理：如果遇到网络错误，请先保留终端的原始提示信息，确认普通网页和 Claude 下载服务都能正常访问后再处理。权限错误时不要直接使用高权限反复执行——先用 doctor 检查安装位置和文件权限。如果通过 Homebrew、WinGet 或 apk 管理的安装只返回简短的“已是最新”提示，请改走下一步的包管理器升级流程。
Update manually 区域既给出了 claude update 命令，也列出了“成功更新”和“已经最新”两种结果。看清终端属于哪一种情况，才能判断版本是否真的发生了变化。
包管理器安装沿原渠道升级
-
入口位置：打开最初安装 Claude Code 时使用的终端和包管理器。不要先卸载，也不要切换到另一种安装方式。
主要动作：Homebrew 稳定通道执行
brew upgrade claude-code，latest cask 执行brew upgrade claude-code@latest；WinGet 执行winget upgrade Anthropic.ClaudeCode；apt、dnf 与 apk 使用各自的正常系统升级流程更新claude-code；npm 安装执行npm install -g @anthropic-ai/claude-code@latest。成功标志：包管理器显示 Claude Code 包被升级，或者确认当前仓库中没有更高版本；命令结束时没有出现依赖、签名或权限错误。
失败处理：npm 不要使用
npm update -g来获取最新版本，因为它可能受原有版本范围限制。Homebrew 找不到 cask 时，请先确认最初安装的是稳定 cask 还是 latest cask；WinGet 找不到包时，请先刷新源并核对包 ID。Linux 仓库错误应先修复仓库与签名配置，不要通过安装另一份二进制文件来掩盖问题。
用更新后的版本和 doctor 收口
-
入口位置：关闭更新时使用的终端，重新打开一个新终端，进入日常项目目录。
主要动作：再次执行
claude --version，与第一步记录的版本号进行比较；随后执行claude doctor，确认安装状态、配置和最近更新结果。成功标志：如果存在新版本，版本号已经发生变化；如果本来就是最新版本，版本号保持不变，且更新命令明确给出了最新状态。doctor 没有出现新的阻断错误，执行
claude能正常进入会话。失败处理：更新命令显示成功但版本号没有变化，请先用
where claude或which claude检查是否存在多份安装，再确认新终端加载的是刚升级的路径。如果 doctor 报告更新失败，请根据安装来源修复网络、仓库、签名或权限问题；不要在同一目录下叠加第二种安装方式。
确认这次升级真正生效
版本有记录：更新前后的
claude --version输出已经对比过，知道版本是变化了，还是原本就处于最新状态。安装来源唯一：原生、Homebrew、WinGet、Linux 包管理器或 npm 只保留一条主要更新路径。
通道符合预期：
latest或stable已按功能速度与稳定性需求选定，没有被组织配置意外覆盖。诊断可读：
claude doctor能完成检查，没有 PATH、配置、仓库或权限方面的阻断错误。新终端可用：重新打开终端后，
claude能在日常项目目录启动，不会调用到另一份旧安装。图片可访问：四张当前官方页面截图都能打开，并分别证明版本诊断、后台更新、发布通道和手动更新。
