Claude Code 會自動更新嗎？

看安裝方式。用官方安裝指令裝的原生版，會在啟動時和執行中檢查，在背景下載安裝，下次啟動生效。用 Homebrew、WinGet 或 Linux 套件管理工具裝的，預設不會自動更新。

怎麼看 Claude Code 現在是哪個版本？

在終端機打 claude --version。已經在對話裡的話，打 /status 也看得到版本、模型和登入的帳號。

更新之後出問題，可以裝回舊版嗎？

官方的安裝指令可以指定版本號，文件的例子是在指令最後加上版本，例如 bash -s 2.1.89。另外也可以把更新頻道改成 stable，拿比較保守的版本。

VS Code 的擴充套件要另外更新嗎？

要。擴充套件自己帶一份 Claude Code，擴充套件的版本號就是它帶的那一版，跟終端機裡的是分開的。我這台終端機是 2.1.280，擴充套件是 2.1.278。

Claude Code 怎麼更新？看版本、手動更新、改用穩定版、關掉自動更新

Claude Code 出新版的速度很快。我數了官方的更新紀錄：2026 年 9 月出了 27 個版本，10 月的前九天又出了 10 個。

所以「我的是不是最新版」「要不要更新」「怎麼更新」這幾個問題，用一陣子就會碰到。

先交代哪些是我實際看到的。版本號是這台 Mac 上的。更新指令我沒有在這台電腦上執行，因為這台的版本我刻意不動，所以指令跑出來的訊息是照官方文件寫的。

先看自己是哪一版

在終端機打：

claude --version

我這台的結果：

2.1.280 (Claude Code)

如果已經在 Claude Code 的對話裡，打 /status 也可以。它會開一個狀態頁，列出版本、模型、登入的帳號。

怎麼更新，看你當初怎麼裝的

這是最容易搞混的地方。安裝方式不同，更新的做法就不同。

安裝方式	會自動更新嗎	手動更新的指令
官方安裝指令（原生版）	會	`claude update`
npm	目錄可以寫入的話會	`npm install -g @anthropic-ai/claude-code@latest`
Homebrew	預設不會	`brew upgrade claude-code`
WinGet	預設不會	`winget upgrade Anthropic.ClaudeCode`
apt	不會	`sudo apt update && sudo apt upgrade claude-code`

不記得當初怎麼裝的，最快是打 claude doctor。它會做一次健康檢查，開頭就寫你是哪一種安裝。我 10 月 12 日在這台跑的結果：

Running: npm-global (2.1.280)
Platform: darwin-arm64
Auto-updates: disabled (set by env: DISABLE_AUTOUPDATER)

npm-global 就是用 npm 裝的。中間我省略了幾行。

另一個辦法是看 claude 這個指令實際指到哪裡：

ls -l "$(which claude)"

我這台指到的是 /opt/homebrew/lib/node_modules/@anthropic-ai/claude-code/ 底下，路徑裡有 node_modules，也看得出是 npm 裝的。原生版的話，文件寫它在 ~/.local/bin/claude。

幾個文件裡特別提醒的地方。

npm 的不要用 npm update -g。文件說它會照當初安裝時的版本範圍，不一定會跳到最新版，要用上面那一行重新安裝。也不要加 sudo。

Homebrew 有兩個套件。claude-code 追的是穩定版，claude-code@latest 追的是最新版，升級時要打對應的名字。

Homebrew、WinGet 這類的，有時候 Claude Code 會先通知你有新版，但套件庫裡還沒上架。文件把這個列為已知問題，升級失敗就晚點再試。

手動更新會看到什麼

原生版和 npm 版，想馬上更新可以打：

claude update

照文件的說法，更新成功會顯示 Successfully updated from 舊版本 to version 新版本。已經是最新的話，顯示 Claude Code is up to date (版本號)。

自動更新則是在背景做的：啟動的時候檢查一次，執行中也會定期檢查，下載安裝完，要等你下次啟動才換成新版。想知道上一次自動更新成功了沒，文件說一樣是看 claude doctor。

不想追最新：改成 stable

每天換版本，偶爾會換到有問題的。官方提供兩個更新頻道。

latest 是預設，一出新版就拿到。

stable 拿到的是大約一週前的版本，而且會跳過出過重大問題的那幾版。

改法是在對話裡打 /config，找到 Auto-update channel。或是直接在設定檔 ~/.claude/settings.json 加一行：

{
  "autoUpdatesChannel": "stable"
}

用 stable 有一個代價。文件寫，新推出的模型可能需要比 stable 更新的版本才能用，想馬上用就得切回 latest。

從 latest 切到 stable 的時候，它會問你要留在現在的版本，還是降回 stable 那一版。選留著的話，它會記下一個最低版本，之後不會把你降到那一版以下。

完全關掉自動更新

在 ~/.claude/settings.json 的 env 裡加一個設定：

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

設好之後打 claude doctor，Auto-updates 那一行會從 enabled 變成 disabled。上面我貼的那次輸出就是關掉的狀態，後面還寫了是誰關的。那次是我跑測試時臨時用環境變數關的，不是寫在設定檔裡。

這個設定只停掉背景的自動檢查。你自己打 claude update 還是會更新。要連手動更新都擋掉，文件寫的是另一個變數 DISABLE_UPDATES，那是給公司統一管版本用的。

VS Code 和桌面版是分開更新的

這一點我是看自己電腦才注意到的。

我這台同時裝了終端機的 Claude Code 和 VS Code 的擴充套件。終端機是 2.1.280，擴充套件的資料夾名稱寫的是 2.1.278，兩個不一樣。

文件有解釋：擴充套件自己帶一份 Claude Code 給聊天面板用，擴充套件的版本號就是它帶的那一版。所以更新終端機的，不會動到擴充套件；擴充套件要從 VS Code 的擴充功能頁更新。

順帶一提，我的擴充套件資料夾裡還留著 2.1.274 和 2.1.276 兩個舊版，每個兩百多 MB。

桌面版又是另一套。它的 Code 分頁用的是 App 自己帶的一份 Claude Code，我這台帶的是 2.1.295。所以同一台電腦上有三個版本：終端機 2.1.280、VS Code 擴充套件 2.1.278、桌面版 2.1.295。文件寫，桌面版在 Mac 上是從選單的 Claude 點 Check for Updates，Windows 是從 Help 選單。桌面版的其他細節在Claude Code 桌面版怎麼用。

我踩過的坑：換安裝方式

10 月 12 日我為了測官方的安裝指令，在一台本來用 npm 裝的電腦上跑了原生安裝程式。它偵測到舊的 npm 版，直接移除了，畫面上沒有問我。

所以如果你想從 npm 換成原生版，知道會發生這件事就好。經過寫在Claude Code 安裝教學。

這篇沒有測的

claude update 實際執行。這台電腦的版本我沒有動。

切換更新頻道時的詢問畫面。

Homebrew、WinGet、apt 這幾種安裝方式。我這台是 npm 裝的。

Claude Code 怎麼更新？看版本、手動更新、改用穩定版、關掉自動更新

先講結論