hibridge.
03 Claude Code · 安装第 8 节

版本更新、发布通道与卸载

自动更新默认开着，多数人不用管。但有两个设置值得知道——一个决定你多快拿到新功能，另一个决定你会不会被一个坏版本坑到。

约 6 分钟

谁负责更新，取决于你怎么装的

安装方式 自动更新
官方安装脚本（install.sh / install.ps1） 有
Homebrew 没有
WinGet 没有
apt / dnf / apk 没有
npm 有（前提是目录可写）

这是推荐用官方安装脚本的主要理由。 Claude Code 迭代很快，用包管理器装的人经常在几个月后发现少了一批功能——不是没有，是没升级。

自动更新是这样工作的：启动时检查一次，运行中定期再查；下载和安装在后台完成，下次启动时生效。

想知道上一次更新有没有成功：

Terminal
claude doctor

立刻更新

不想等后台检查：

Terminal
claude update
  • 装上了新版本会说 Successfully updated from ... to version ...
  • 已经是最新的会说 Claude Code is up to date (版本号)

用包管理器装的：

Terminal
brew upgrade claude-code          # Homebrew（装的是 @latest 的话换成 claude-code@latest）
winget upgrade Anthropic.ClaudeCode   # WinGet

一个已知情况：Claude Code 有时会在新版本还没进到包管理器之前就提示你更新。升级失败就过一阵再试，不是你的问题。

WinGet 上还有一条：Claude Code 正在运行时升级可能失败，因为 Windows 会锁住正在执行的程序。

两个值得知道的设置

一、发布通道：要新还是要稳

通道 含义
latest（默认） 一发布就拿到
stable 大约落后一周，会跳过有明显问题的版本

改法有两种。在 Claude Code 里：/config → Auto-update channel。

或者写进 settings.json：

JSON
{
  "autoUpdatesChannel": "stable"
}

该选哪个？

想第一时间用上新功能，留在 latest。 Claude Code 的新功能出得很快，落后一周是有代价的。

如果它是你日常工作的一部分，经不起「今天突然不好使」，切到 stable。 那一周的等待换来的是别人已经替你踩过坑。

Homebrew 用户不用改这个设置——通道由你装的是哪个 cask 决定：claude-code 是 stable，claude-code@latest 是 latest。

二、版本下限：不让它把你降级

minimumVersion 设一个地板，低于这个版本的都不装。

它解决的是一个具体问题：你已经在一个较新的版本上了，这时候切到 stable 通道，本来会被降级。

JSON
{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

在界面里切通道时会问你：是留在当前版本，还是允许降级。选留在当前版本，它会自动把 minimumVersion 设成那个版本号。切回 latest 会清掉。

关掉自动更新

一般不建议。确实需要的话：

JSON
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

它只停掉后台检查，claude update 手动更新仍然可用。

要连手动更新一起堵死，用 DISABLE_UPDATES。这一条是给需要统一分发版本的组织用的，个人用户用不上。

卸载

按你的安装方式来

官方安装脚本装的（macOS / Linux / WSL）：

Terminal
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

官方安装脚本装的（Windows PowerShell）：

PowerShell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

其他方式：

Terminal
brew uninstall --cask claude-code       # Homebrew
winget uninstall Anthropic.ClaudeCode   # WinGet
npm uninstall -g @anthropic-ai/claude-code   # npm

卸载之后 claude 还在

说明你装了不止一份，或者有旧版本留下的别名。查一下：

Terminal
which -a claude

Windows 上是 where.exe claude。处理办法见安装故障排查里的「装了两份」。

要不要一起删配置

删配置会清掉你所有的设置、已授权的工具、MCP 配置和会话历史。 只是想换个安装方式的话不要删这一块——重装之后你的配置还在。

确定要清干净：

Terminal
rm -rf ~/.claude
rm ~/.claude.json

Windows：

PowerShell
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

项目里的配置（在你干活的那个文件夹里）：

Terminal
rm -rf .claude
rm -f .mcp.json

一条容易漏的：VS Code 扩展、JetBrains 插件和桌面应用也往 ~/.claude/ 里写东西。它们只要还装着，这个目录下次就会被重新建出来。要彻底清干净，先把它们卸了。

本节事实查证日期：2026-08-05。 依据：官方 Advanced setup 的 Update 与 Uninstall 两节。

← 回到手册目录