)`，表示沒有可更新的內容。
使用套件管理器時，這個指令有個細節需要留意。如果 Claude Code 是透過 Homebrew、WinGet 或 apk 安裝，`claude update` 會回覆較簡短的 `Claude is up to date!`，而且不一定會自行取得新版。這些安裝方式最好使用套件管理器本身的升級指令，詳情見下文。
## 如何更新透過 Homebrew 或 WinGet 安裝的 Claude Code？
本節重點
套件管理器不會自動更新 Claude Code，因此你必須自行執行升級指令。使用 Homebrew 的 MacBook 上，指令是 brew upgrade claude-code；使用 WinGet 的 Windows 上，則是 winget upgrade Anthropic.ClaudeCode。Linux 上的 apt、dnf 或 apk 會隨一般系統升級一併更新。如果你希望 Claude Code 使用 Homebrew 和 WinGet 自行執行升級，請將 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 環境變數設為 one。
如果你透過套件管理器而不是網站安裝指令碼安裝 Claude Code，就需要自行更新。以下是各系統的指令。
macOS 搭配 Homebrew：
```bash
brew upgrade claude-code
```
Homebrew 有兩個選項。它提供兩種 Claude Code 版本。`claude-code` 版本使用 stable 頻道，大約落後一週，並略過有重大問題的版本。`claude-code@latest` 版本則會在最新版本發布後立即取得。如果你安裝的是哪個版本，就更新哪個版本：如果使用 `claude-code@latest`，指令就是 `brew upgrade claude-code@latest`。
Windows 搭配 WinGet：
```powershell
winget upgrade Anthropic.ClaudeCode
```
使用 WinGet 時，如果 Claude Code 正在執行，升級有時會失敗，因為 Windows 正在使用執行檔。Claude Code 只會顯示手動指令；關閉它後再執行一次升級即可。
Linux 上的 apt、dnf 或 apk 不需要記另一個專用指令；Claude Code 提供經簽署的套件庫，因此最新版本會隨一般系統更新送達。
| 安裝方式 | 更新指令 |
|----------------------|----------------|
| 原生安裝程式 | 自動更新，或使用 `claude update` |
| Homebrew（macOS） | `brew upgrade claude-code` |
| WinGet（Windows） | `winget upgrade Anthropic.ClaudeCode` |
| apt / dnf / apk（Linux） | 一般系統升級 |
如果不想記住這些指令，可以使用 `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` 環境變數。將它設為 `1` 後，Claude Code 會在背景透過 Homebrew 和 WinGet 執行升級，並在更新成功後建議重新啟動。文件也提醒一項注意事項：Claude Code 有時會在新版本實際出現在套件管理器之前，就通知你有新版本。如果升級時找不到更新，請稍等片刻後再試。
順帶一提，如果你還在選擇 Claude Code 的安裝方式，另一篇[安裝 Claude Code](https://ailoot.ai/blog/zh-hant-tw/install-claude-code/)的文章提供了詳細指南，包括原生安裝程式為何比套件管理器方便。
## 為什麼 Claude Code 無法更新？該怎麼處理？
本節重點
通常有三種可能原因。第一，你安裝了多個 Claude Code 版本，彼此發生衝突：指令更新了其中一個，但實際啟動的是另一個。第二，全域 npm 資料夾沒有寫入權限，因此背景更新悄悄安裝失敗。第三，你可能用自訂指令碼取代了啟動程式。請先使用 claude doctor 和 which -a claude 開始排查；它們會準確指出問題所在。
有時你一再更新，`claude --version` 卻始終顯示舊版本號。以下從最常見的原因開始逐一說明。
首先要檢查是否同時安裝了多個 Claude Code 版本。例如，你一開始透過 npm 安裝，之後又重新安裝原生版本，就可能發生這種情況。指令更新了一個版本，但終端機啟動的是另一個，所以看起來版本沒有變。查看你安裝了幾個版本：
```bash
which -a claude
```
Claude Code 可能位於三個位置：`~/.local/bin/claude` 是原生安裝程式，`~/.claude/local/` 是早期版本使用的舊本機 npm 安裝，而全域 npm 套件則會由 `npm -g ls @anthropic-ai/claude-code` 指令列出。如果發現不只一個，請只保留一個，最好是原生安裝。可用下列方式移除多餘版本：
```bash
npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local
```
第二個常見原因是全域 npm 資料夾沒有寫入權限。如果你透過 npm 全域安裝 Claude Code，但它沒有權限寫入資料夾，背景更新就無法安裝。Claude Code 會在啟動時顯示一次性通知，而 `claude doctor` 會列出確切需要修正的項目。這也是建議使用原生安裝的另一個原因：它會寫入你的 home 資料夾，不需要這些權限。
第三種情況是你曾用自己的指令碼或符號連結取代 `~/.local/bin/claude` 啟動程式。從版本 2.1.207 開始，自動更新會保留這類啟動程式：新版本仍會安裝在 `~/.local/share/claude/versions/` 資料夾，但由你的指令碼決定要啟動哪個版本。不要刪除唯一啟動器後又以名稱叫用 `claude update`。先將自訂啟動器及符號連結目標保存到另外未使用的備份位置，確認副本後才移開原路徑。使用不依賴既有 `claude` 指令的[官方安裝器](https://code.claude.com/docs/en/setup#install-claude-code) 恢復原生啟動器：
```bash
# macOS、Linux 或 WSL：官方原生安裝器
curl -fsSL https://claude.ai/install.sh | bash
```
安裝完成後，開新終端機驗證：
```bash
claude --version
claude doctor
```
第一個指令必須顯示版本；繼續前檢查 doctor 的啟動器與 PATH 警告。替代啟動器正常運作之前，不要刪除已保存的原啟動器。
另一種狀況是，`claude update` 或 `claude doctor` 在顯示 `Checking for updates` 後立刻卡住。在較舊版本（2.1.214 之前）中，如果某個 shell 設定檔（例如 `~/.zshrc`）是資料夾而不是檔案，有時會發生這種情況。近期版本會略過這種狀況，因此更新至最新版本也會修正這個錯誤。
## 如何選擇更新頻道：latest 還是 stable？
本節重點
Claude Code 有兩個更新頻道。Latest 是預設頻道，新功能會在發布後立即推出。Stable 大約落後一週，並略過有重大問題的版本。如果你更重視新功能，就繼續使用 latest。如果你更重視可預測性，不想碰到不穩定的版本，就切換到 stable。你可以在 settings.json 檔案中修改 autoUpdatesChannel 設定，或使用 /config 指令。
更新至最新版本，不一定代表在發布當天就取得最新版本。Claude Code 讓你選擇兩個頻道，而你選擇哪個頻道，會直接影響更新時取得的內容。
`latest` 頻道是預設值。新功能會在發布後立即推出，適合想要搶先體驗的人。`stable` 頻道提供約一週前的版本：它經過一段時間穩定，並略過有重大問題的版本。這適合重視安心感勝過速度的人。
最簡單的切換方式是在 Claude Code 中使用 `/config` 指令，選擇 Auto-update channel。你也可以在 `settings.json` 設定檔中手動輸入：
```json
{
"autoUpdatesChannel": "stable"
}
```
如果你想依照自己的習慣設定 Claude Code，可以參考另一份[自訂 Claude Code](https://ailoot.ai/blog/zh-hant-tw/claude-personalization-profile-memory/)指南；內容涵蓋整個設定檔，而不只是更新頻道。
## 如何安裝特定版本或設定最低版本？
本節重點
原生安裝程式接受頻道名稱和精確版本號。若要安裝特定版本，可以在安裝指令結尾加上版本號，例如 bash -s 2.1.89。你也可以用相同方式安裝 stable 頻道，而非 latest。若要避免更新回退至低於某個版本的版本，請在 settings.json 設定 minimumVersion。這是最低限制，背景更新和 claude update 都不會低於此版本。
有時你需要特定版本，而不是最新版本，例如回到確定能正常執行工作流程的版本。原生安裝程式支援這種做法，接受頻道名稱和精確版本號。可用以下方式安裝特定版本：
```bash
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
```
在 Windows 上，PowerShell 中的對應指令略有不同：
```powershell
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
```
你也可以用相同方式安裝 stable 頻道：以 `stable` 取代版本號。安裝時選擇的頻道會成為日後自動更新的預設頻道。
若要避免回退至較舊版本，請在 `settings.json` 中設定最低版本：
```json
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.100"
}
```
這是最低限制。背景更新和 `claude update` 都不會安裝低於指定版本的版本。如果你切換至 stable，但不想從目前使用的較新版本回退，這項設定就很有用。
## 自動更新造成干擾時，如何停用？
本節重點
如果你不需要 Claude Code 的背景更新，可以在 settings.json 檔案的 env 區塊中設定 DISABLE_AUTOUPDATER 變數來停用。它只會停止背景檢查；如果你想手動更新，claude update 指令仍然可用。若要封鎖所有更新途徑，包括手動更新，請使用另一個變數 DISABLE_UPDATES。當你要將 Claude Code 發布給團隊，並希望所有人都使用相同版本時，這種設定就很有用。
有時背景更新會造成干擾，例如你想讓團隊所有人都使用完全相同的版本。你可以透過設定檔停用它：
```json
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
```
有個重要細節：`DISABLE_AUTOUPDATER` 只會停止背景檢查。`claude update` 指令仍然可用，因此你還是可以手動更新。如果你需要一次封鎖所有更新途徑，包括手動更新，則可以使用限制更嚴格的變數 `DISABLE_UPDATES`。透過自有管道發布 Claude Code，並希望使用者完全維持在你提供的版本時，就會用到這個設定。
一般自己使用時，最好不要更動這些變數：新版 Claude Code 幾乎總是比舊版好，而且更新可能會帶來安全性修正。讓工具保持最新，是維持存取權並避免奇怪錯誤的一環；另一篇文章說明了[如何避免失去 Claude 帳戶](https://ailoot.ai/blog/zh-hant-tw/claude-account-suspension-appeal/)。
## 你該從哪裡開始？
本節重點
先用 claude --version 查看版本，並與變更紀錄中的最新版本號比較。如果是原生安裝，請用 claude update 更新，然後重新啟動工作階段。如果透過 Homebrew 或 WinGet 安裝，請執行套件管理器的升級指令。如果版本沒有變更，請執行 claude doctor 和 which -a claude，檢查是否有多個安裝版本造成衝突。最後選擇要用的頻道：latest 可取得新功能，stable 則更安心。
以下是簡短的操作步驟。
1. 查看目前版本：`claude --version`。將版本號與變更紀錄中的最新版本比較。
2. 更新。原生安裝使用 `claude update`。Homebrew 使用 `brew upgrade claude-code`。WinGet 使用 `winget upgrade Anthropic.ClaudeCode`。
3. 重新啟動 Claude Code 工作階段，讓新版本生效。
4. 如果版本沒有變更，請執行 `claude doctor` 和 `which -a claude`。你可能安裝了多個版本，或 npm 資料夾沒有寫入權限。
5. 選擇適合你的頻道：想在新功能推出時立即取得就選 `latest`，更重視可預測性就選 `stable`。透過 `/config` 變更。
新版能修復錯誤並加入新指令，但更新工具不會替你建立專案。[Claude Code 替代方案](https://ailoot.ai/blog/zh-hant-tw/claude-code-alternatives/)指南說明 Claude Code 與其他終端機代理程式有何不同，以及何時值得考慮替代方案。
### 來源
- [Claude Code - 進階設定，官方文件](https://docs.claude.com/en/docs/claude-code/setup) - 原生安裝的自動更新、claude update 指令、latest 與 stable 頻道、autoUpdatesChannel 和 minimumVersion 設定、DISABLE_AUTOUPDATER、安裝特定版本
- [Claude Code - 安裝疑難排解，官方文件](https://docs.claude.com/en/docs/claude-code/troubleshoot-install) - 多個安裝版本之間的衝突、which -a claude、npm 資料夾權限、自訂啟動程式、claude update 卡住
- [Claude Code - GitHub 上的 CHANGELOG](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) - 各版本及其變更清單；查看最新版本號的位置
認識 [Ailoot](https://ailoot.ai/)。
## 常見問題：如何在 2026 年將 Claude Code 更新至最新版本
### claude update 為什麼仍啟動舊自訂 wrapper？
原生更新器會保留自訂啟動器，因此仍由 wrapper 選擇 binary。修復前保留 wrapper 及其目標，再使用官方原生安裝器；不要刪掉唯一指令後立刻叫用它。
### 如何確認啟動器恢復成功？
開新終端機執行 claude --version，應印出版本，再用 claude doctor 查安裝與啟動器警告。找不到指令時先修 PATH。
## Ailoot · 公司及其專案組合
Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。
公司及其專案組合：數百萬客戶，每月銷售額達數十億。
Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。