Claude Code 怎麼更新和卸載：更新命令、指定版本、更新失敗與徹底卸載

本文根據 Claude Code 官方文檔《Advanced setup》中的更新與卸載部分和《Troubleshoot installation and login》整理，核對日期 2026-10-07。首次安裝方法詳見本站《Claude Code 中文入門教學（2026）：安裝、登入、第一個任務、常用命令》。

適用於誰

• 搜「claude code 更新命令」「更新到指定版本」「更新失敗」的人；
• 新模型出來了但 Claude Code 提示「does not support this model」、需要升級的人；
• 想卸載重裝、或者徹底刪乾淨 Claude Code 的人。

結論先說

1. 原生安裝（官方推薦的方式）會在後台自動更新，啟動時和運行中都會檢查，下載好後下次啟動生效。想立刻更新就運行 claude update。
2. Homebrew、WinGet、apt / dnf / apk 預設不會自動更新，要用各自的命令手動升級；npm 安裝用 npm install -g @anthropic-ai/claude-code@latest（不要用 npm update -g）。
3. 有兩個更新通道：latest（預設，第一時間拿到新功能）和 stable（一般晚一週左右，跳過有嚴重問題的版本），在 /config 或 autoUpdatesChannel 裏切換。
4. 想裝某個具體版本：安裝腳本後面帶上版本號，例如 bash -s 2.1.89。
5. 卸載要按安裝方式對應刪除；徹底清理還要刪 ~/.claude 和 ~/.claude.json，但這會刪掉所有設定、MCP 配置和會話歷史。

一、更新

查看當前版本

bash
claude --version

claude doctor 還會顯示最近一次自動更新的結果。會話裏也可以用 /status 查看版本。

立即更新

bash
claude update

更新成功會提示 Successfully updated from <舊版本> to version <新版本>；已經是最新則提示 Claude Code is up to date。

不同安裝方式的更新命令

幾點補充：

• npm 升級不要用 npm update -g，它會遵守最初安裝時的版本範圍，可能升不到最新版；也不要加 sudo。
• Homebrew 和 WinGet 想讓 Claude Code 自己幫你跑升級命令，可以設定環境變量 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1。WinGet 在 Claude Code 運行時可能因為文件被佔用而升級失敗，這時會提示你手動運行命令。
• 官方提到一個已知問題：Claude Code 可能比包管理器更早提示有新版本，升級失敗的話過一陣再試。
• Homebrew 升級後會保留舊版本，可以定期運行 brew cleanup 釋放空間。

切換更新通道：latest 還是 stable

在會話裏運行 /config，找到 Auto-update channel；或者在 ~/.claude/settings.json 裏寫：

json
{
  "autoUpdatesChannel": "stable"
}

• latest（預設）：新功能一發布就收到；
• stable：通常是一週左右前的版本，會跳過有嚴重回歸問題的版本。

注意：新模型上線時可能需要比 stable 通道更新的版本，想馬上用新模型就切回 latest。Homebrew 用 cask 名區分通道：claude-code 跟 stable，claude-code@latest 跟 latest。

從 latest 切到 stable 時，/config 會問你是留在當前版本還是允許降級；選擇留下會自動設定 minimumVersion。也可以手動設一個「最低版本」，防止被降級：

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

安裝指定版本（回退到舊版）

在原生安裝腳本後面加上版本號（或 stable / latest）：

bash
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

powershell
# Windows PowerShell
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

bat
:: Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd

裝好後 claude --version 會顯示你指定的版本，例如 2.1.89 (Claude Code)。安裝時選的通道會成為之後自動更新的預設通道。想固定在某個版本不被自動升級，還要關閉自動更新（見下一節）。

關閉自動更新

在設定文件的 env 裏加：

json
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

用 claude doctor 確認 Auto-updates 一行顯示為 disabled。DISABLE_AUTOUPDATER 只停掉後台檢查，claude update 仍然可以手動更新；想連手動更新也禁止，用 DISABLE_UPDATES。

二、更新失敗怎麼辦

Windows 更新後提示「'claude' is not recognized」

Windows 上更新時會先把舊的 claude.exe 改名備份，再放入新版本；如果中途失敗，目錄裏只剩備份。在 PowerShell 裏運行下面這條，把最新的備份改回 claude.exe：

powershell
Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

再運行 claude --version 確認。

npm 重裝 / 升級報 npm error code ENOTEMPTY

刪掉報錯裏 npm error path 指向的目錄和旁邊殘留的 .claude-code-* 臨時目錄，再重裝：

bash
rm -rf "$(npm root -g)/@anthropic-ai/claude-code"
rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*
npm install -g @anthropic-ai/claude-code

claude update 卡在 Checking for updates

官方說明這是 v2.1.214 以前的問題：當 ~/.zshrc、~/.bashrc 等路徑恰好是一個目錄時會卡住。把那個目錄挪走，或者重新運行一遍安裝腳本來升級。

更新後運行的還是舊版本

很可能裝了兩份（比如原生安裝 + 早年的 npm 安裝）。macOS / Linux 用 which -a claude，Windows 用 where.exe claude 查看所有 claude 的位置，刪掉不用的那一份。Windows 上舊版 Claude 桌面版還可能註冊一個同名的 Claude.exe 搶佔 PATH，把桌面版升級到最新即可。

提示「Claude Code does not support this model」

新模型需要更新的 Claude Code 版本，運行 claude update；如果你在 stable 通道，暫時切到 latest。

三、卸載

先按你當初的安裝方式卸載程序本身：

原生安裝：

bash
# macOS / Linux / WSL
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

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

Homebrew：brew uninstall --cask claude-code（latest 版是 claude-code@latest）

WinGet：winget uninstall Anthropic.ClaudeCode

npm：npm uninstall -g @anthropic-ai/claude-code

apt：

bash
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

（dnf、apk 的命令見官方 setup 頁「Uninstall」一節。）

卸載後如果 claude 還能運行，說明還有另一份安裝或舊安裝程序留下的 shell 別名，用上面的 which -a claude / where.exe claude 找出來刪掉。

徹底清理配置（謹慎）

官方警告：刪除配置文件會刪掉你所有的設定、已允許的工具、MCP 伺服器配置和會話歷史。另外，VS Code 擴展、JetBrains 插件和桌面版也會寫 ~/.claude/，只要它們還裝着，下次運行就會重新生成這個目錄，所以要徹底刪除，先把它們也卸載。

bash
# macOS / Linux / WSL：用戶級設定和狀態
rm -rf ~/.claude
rm ~/.claude.json

# 某個項目裏的設定（在項目目錄下運行）
rm -rf .claude
rm -f .mcp.json

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

項目裏的 .claude/、.mcp.json 如果是團隊提交到倉庫的，刪之前想清楚。

常見問題

Q：卸載重裝能解決問題嗎？

很多安裝問題官方建議先跑 claude doctor 看診斷，常見的 PATH、重複安裝、設定文件錯誤都會列出來。真要重裝，卸載程序即可，不必刪配置；配置文件有問題再考慮清理。

Q：怎麼看每個版本更新了什麼？

會話裏運行 /release-notes 打開版本選擇器，或看官方 changelog 頁面。

Q：公司要求統一版本怎麼辦？

管理員可以在託管設定裏統一 autoUpdatesChannel、minimumVersion，或用 requiredMinimumVersion / requiredMaximumVersion 限定允許啟動的版本範圍。

參考資料

• Advanced setup · Update / Uninstall（官方）：https://code.claude.com/docs/en/setup
• Troubleshoot installation and login（官方）：https://code.claude.com/docs/en/troubleshoot-install
• All settings · autoUpdatesChannel（官方）：https://code.claude.com/docs/en/settings-reference
• Claude Code changelog（官方）：https://code.claude.com/docs/en/changelog