如何在 2026 年將 Claude Code 更新至最新版本

Claude Code 幾乎每天都在變。你打開最新的變更紀錄，會看到新指令、修復的錯誤和速度改善。與此同時，你的終端機還在執行兩週前的版本，其中一半改善根本無法使用。Claude 也不會告訴你：它照常啟動，讓你納悶為什麼別人有某項功能，你卻沒有。

我會說明如何查看版本、更新至最新版本，以及更新無法安裝時該怎麼處理。指令皆逐字引用自 Claude Code 官方文件，並於 2026 年 9 月上旬確認過。當時最新發布的版本是 2.1.261，但你的版本號會不同。沒必要追著特定版本號跑，重要的是使用近期版本即可。

Ailoot 的使用資訊請見文件。

如何快速將 Claude Code 更新至最新版本？#

下文會詳細說明各種情況。如果你時間不多，以下三個指令就能應付幾乎所有情況。

claude --version   # 目前安裝的版本
claude update      # 立即更新（原生安裝）
claude doctor      # 檢查安裝狀態與更新

第一個指令會顯示版本，第二個會更新，第三個則會在出現問題時診斷原因。下文會說明何時使用每個指令，以及為什麼有些人的 claude update 無法運作。

如何查看目前安裝的 Claude Code 版本？#

更新之前，最好先知道目前使用的是哪個版本。指令很簡單：

claude --version

你會看到類似 2.1.211 (Claude Code) 的一行文字。這就是目前的版本。將前兩個數字與變更紀錄中的最新版本號比較；如果你的版本低很多，就該更新了。

若想更全面了解狀況，可以執行 claude doctor。它只會檢查，不會變更任何內容：不會啟動工作階段，但會顯示安裝狀態、設定檔中的錯誤，以及附有可直接採用之修正建議的警告。它也會顯示上次自動更新嘗試的結果，當你懷疑背景更新悄悄安裝失敗時，這項資訊就很有用。

Claude Code 會自動更新嗎？#

這完全取決於你如何安裝 Claude Code。Anthropic 推薦的原生安裝方式，也是網站安裝指令碼所使用的方式，可以自動更新，文件也明確說明了這一點。

運作方式如下：Claude Code 會在啟動時，以及執行期間定期檢查更新。如果找到新版本，就會在背景下載並安裝，然後於下次啟動時套用。每隔幾天關閉並重新開啟工作階段，就能再次保持在最新狀態。

你可以使用同一個 claude doctor 指令查看上次背景更新的結果。它會告訴你更新是否因某些原因而安裝失敗。

不過，如果你透過套件管理器安裝 Claude Code，例如 MacBook 上的 Homebrew、Windows 上的 WinGet，或 Linux 上的 apt、dnf，就不會有背景更新。這些安裝方式必須使用一般的升級指令更新；下文會有專節說明。

新版 Claude Code 是重要基礎，但光靠它無法帶你達成目標。穩定的成果來自你的使用方式，而非工具版本。

如何用一個指令手動更新 Claude Code？#

你不必等候背景檢查發現新版本。有個指令可以立即更新：

claude update

可能有兩種結果。如果找到並安裝更新，Claude Code 會顯示類似 Successfully updated from <old version> to version <new version> 的訊息。如果你已經使用最新版本，則會看到 Claude Code is up to date (<version>)，表示沒有可更新的內容。

使用套件管理器時，這個指令有個細節需要留意。如果 Claude Code 是透過 Homebrew、WinGet 或 apk 安裝，claude update 會回覆較簡短的 Claude is up to date!，而且不一定會自行取得新版。這些安裝方式最好使用套件管理器本身的升級指令，詳情見下文。

如何更新透過 Homebrew 或 WinGet 安裝的 Claude Code？#

如果你透過套件管理器而不是網站安裝指令碼安裝 Claude Code，就需要自行更新。以下是各系統的指令。

macOS 搭配 Homebrew：

brew upgrade claude-code

Homebrew 有兩個選項。它提供兩種 Claude Code 版本。claude-code 版本使用 stable 頻道，大約落後一週，並略過有重大問題的版本。claude-code@latest 版本則會在最新版本發布後立即取得。如果你安裝的是哪個版本，就更新哪個版本：如果使用 claude-code@latest，指令就是 brew upgrade claude-code@latest。

Windows 搭配 WinGet：

winget upgrade Anthropic.ClaudeCode

使用 WinGet 時，如果 Claude Code 正在執行，升級有時會失敗，因為 Windows 正在使用執行檔。Claude Code 只會顯示手動指令；關閉它後再執行一次升級即可。

Linux 上的 apt、dnf 或 apk 不需要記另一個專用指令；Claude Code 提供經簽署的套件庫，因此最新版本會隨一般系統更新送達。

如果不想記住這些指令，可以使用 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 環境變數。將它設為 1 後，Claude Code 會在背景透過 Homebrew 和 WinGet 執行升級，並在更新成功後建議重新啟動。文件也提醒一項注意事項：Claude Code 有時會在新版本實際出現在套件管理器之前，就通知你有新版本。如果升級時找不到更新，請稍等片刻後再試。

順帶一提，如果你還在選擇 Claude Code 的安裝方式，另一篇安裝 Claude Code的文章提供了詳細指南，包括原生安裝程式為何比套件管理器方便。

為什麼 Claude Code 無法更新？該怎麼處理？#

有時你一再更新，claude --version 卻始終顯示舊版本號。以下從最常見的原因開始逐一說明。

首先要檢查是否同時安裝了多個 Claude Code 版本。例如，你一開始透過 npm 安裝，之後又重新安裝原生版本，就可能發生這種情況。指令更新了一個版本，但終端機啟動的是另一個，所以看起來版本沒有變。查看你安裝了幾個版本：

which -a claude

Claude Code 可能位於三個位置：~/.local/bin/claude 是原生安裝程式，~/.claude/local/ 是早期版本使用的舊本機 npm 安裝，而全域 npm 套件則會由 npm -g ls @anthropic-ai/claude-code 指令列出。如果發現不只一個，請只保留一個，最好是原生安裝。可用下列方式移除多餘版本：

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 指令的官方安裝器 恢復原生啟動器：

# macOS、Linux 或 WSL：官方原生安裝器
curl -fsSL https://claude.ai/install.sh | 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 頻道提供約一週前的版本：它經過一段時間穩定，並略過有重大問題的版本。這適合重視安心感勝過速度的人。

最簡單的切換方式是在 Claude Code 中使用 /config 指令，選擇 Auto-update channel。你也可以在 settings.json 設定檔中手動輸入：

{
  "autoUpdatesChannel": "stable"
}

如果你想依照自己的習慣設定 Claude Code，可以參考另一份自訂 Claude Code指南；內容涵蓋整個設定檔，而不只是更新頻道。

如何安裝特定版本或設定最低版本？#

有時你需要特定版本，而不是最新版本，例如回到確定能正常執行工作流程的版本。原生安裝程式支援這種做法，接受頻道名稱和精確版本號。可用以下方式安裝特定版本：

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

在 Windows 上，PowerShell 中的對應指令略有不同：

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

你也可以用相同方式安裝 stable 頻道：以 stable 取代版本號。安裝時選擇的頻道會成為日後自動更新的預設頻道。

若要避免回退至較舊版本，請在 settings.json 中設定最低版本：

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

這是最低限制。背景更新和 claude update 都不會安裝低於指定版本的版本。如果你切換至 stable，但不想從目前使用的較新版本回退，這項設定就很有用。

自動更新造成干擾時，如何停用？#

有時背景更新會造成干擾，例如你想讓團隊所有人都使用完全相同的版本。你可以透過設定檔停用它：

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

有個重要細節：DISABLE_AUTOUPDATER 只會停止背景檢查。claude update 指令仍然可用，因此你還是可以手動更新。如果你需要一次封鎖所有更新途徑，包括手動更新，則可以使用限制更嚴格的變數 DISABLE_UPDATES。透過自有管道發布 Claude Code，並希望使用者完全維持在你提供的版本時，就會用到這個設定。

一般自己使用時，最好不要更動這些變數：新版 Claude Code 幾乎總是比舊版好，而且更新可能會帶來安全性修正。讓工具保持最新，是維持存取權並避免奇怪錯誤的一環；另一篇文章說明了如何避免失去 Claude 帳戶。

你該從哪裡開始？#

以下是簡短的操作步驟。

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 替代方案指南說明 Claude Code 與其他終端機代理程式有何不同，以及何時值得考慮替代方案。

認識 Ailoot。