Claude Codeのアップデート方法｜自動更新とバージョン固定設定

Claude Codeのアップデートは、ネイティブインストーラーで入れた場合は何もしなくてもバックグラウンドで自動更新され、すぐ上げたいときは claude update を実行すれば済みます。Homebrew・WinGet・apt などで入れた場合は既定では自動で上がらないため、それぞれのパッケージマネージャーの更新コマンドを使います。npm版で npm update -g を使うと最新版に上がらないことがあるので、npm install -g @anthropic-ai/claude-code@latest を使ってください。

この記事では、導入方式ごとの更新コマンド、自動更新を止める・遅らせる設定、更新失敗が起きたときの切り分けを、Claude Code公式ドキュメント（code.claude.com）の記述に沿って整理します。

Claude Codeのアップデートは導入方式でどう変わるのか？

更新のしかたは「どの方法でインストールしたか」で決まります。公式ドキュメントでは、ネイティブ版は自動更新され、Homebrew・WinGet・Linuxパッケージマネージャー版は既定で手動更新と書かれています。

導入方式	自動更新	手動で上げるコマンド
ネイティブインストーラー（curl / PowerShell）	あり（バックグラウンド）	`claude update`
npm（グローバル）	あり（グローバルディレクトリに書き込める場合）	`npm install -g @anthropic-ai/claude-code@latest`
Homebrew	既定はなし	入れたcaskに合わせて `brew upgrade claude-code` または `brew upgrade claude-code@latest`
WinGet	既定はなし	`winget upgrade Anthropic.ClaudeCode`
apt（Debian / Ubuntu）	なし	`sudo apt update && sudo apt upgrade claude-code`
dnf（Fedora / RHEL）	なし	`sudo dnf upgrade claude-code`
apk（Alpine Linux）	なし	`apk update && apk upgrade claude-code`

自動更新機能は起動時と実行中に定期的にチェックされ、ダウンロードとインストールは裏で進みます。反映されるのは次にClaude Codeを起動したときです。更新が入ったのに挙動が変わらないと感じたら、一度終了して起動し直してください。

自分がどの方式で入れたか分からない場合の見分け方は、ネイティブインストールの解説記事にまとめています。

今のバージョンはどう確認するのか？

ターミナルで次のコマンドを実行すると、インストール済みのバージョン番号が表示されます。

claude --version

短縮形の claude -v でも同じです。Claude Codeの直近の自動更新がうまくいったかどうかは、セッションを開始せずに診断結果を出す claude doctor で確認できます。公式ドキュメントは、直近の更新の結果を見るには claude doctor を実行するよう案内しています。

claude doctor

各バージョンの更新履歴を確認するには、セッション内で /release-notes を実行すると版を選んで読めます。表示された内容はトランスクリプトに出るだけで、Claudeが参照する会話には入りません。Web上の公式changelogページは、GitHubの CHANGELOG.md から生成されたものです。

自動更新を待たずにすぐ上げたいときはどうするのか？

ネイティブ版で次の自動チェックを待たずに更新するなら、claude update を実行します。

claude update

更新が入ると Successfully updated from <old version> to version <new version>、すでに最新なら Claude Code is up to date (<version>) と表示されます。Homebrew・WinGet・apk で管理しているインストールでは、代わりに Claude is up to date! と出ます。

npm版は `npm update -g` を使わない

npmでグローバルに入れている場合は、次のコマンドで上げます。

npm install -g @anthropic-ai/claude-code@latest

公式は npm update -g を避けるよう明記しています。最初にインストールしたときのsemver範囲を尊重するため、最新リリースまで上がらない場合があるからです。また、権限エラーやセキュリティ上のリスクにつながるため、sudo npm install -g も使わないよう注意書きがあります。npmのグローバルディレクトリに書き込めず自動更新できない場合は、起動時に一度だけ通知が出て、claude doctor に対処法が表示されます。

Homebrew・WinGetを自動で上げたい場合

Homebrew版とWinGet版は既定では自動更新されませんが、環境変数 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 にすると、新しい版が出たときにClaude Codeが裏で更新コマンドを実行し、成功すると再起動を促します。apt・dnf・apk は管理者権限が必要なため、手動更新のままです。

WinGetでは、Claude Codeの実行中にWindowsが実行ファイルをロックするため、更新に失敗することがあります。その場合は手動で実行するコマンドが表示されます。公式は既知の問題として、パッケージマネージャー側に新しい版が届く前に更新通知が出る場合があると記載しており、失敗したら時間をおいて再実行するよう案内しています。

自動更新を止めたい・遅らせたいときはどう設定するのか？

「遅らせる」「下限を決める」「止める」は別々の設定です。目的に合わせて選びます。

安定版チャネルに切り替えて遅らせる

設定キー autoUpdatesChannel で、自動更新と claude update が追うチャネルを選べます。既定は "latest" で、新機能をリリース直後に受け取ります。"stable" にすると、通常は約1週間前の版で、大きな不具合のあったリリースを飛ばしたものが使われます。セッション内の /config から「Auto-update channel」で変えるか、settings.json に次のように書きます。

{
  "autoUpdatesChannel": "stable"
}

注意点が2つあります。新しく公開されたモデルが、stableチャネルの版より新しいClaude Codeを必要とする場合があり、そのモデルをすぐ使うにはlatestへ移る必要があります。また、Homebrewはこの設定を使わず、cask名でチャネルが決まります（claude-code がstable、claude-code@latest がlatest）。

ダウングレードを防ぐ下限 `minimumVersion`

minimumVersion を設定すると、自動更新と claude update はその版より古いものを入れなくなります。latestで新しい版を使っている状態からstableに切り替えても、古い版へ戻されません。/config でlatestからstableに切り替えると、今の版に留まるかダウングレードを許すかを聞かれ、留まる方を選ぶと minimumVersion がその版で設定されます。latestに戻すと解除されます。

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

自動更新そのものを止める

自動更新を止めるには、settings.json の env に DISABLE_AUTOUPDATER を "1" で入れます。

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

ネイティブ版とnpm版では、claude doctor の Auto-updates 行が enabled ではなく disabled (set by env: DISABLE_AUTOUPDATER) になっていれば反映されています。

ここで止まるのはバックグラウンドの確認だけで、claude update と claude install は引き続き使えます。手動更新も含めてすべて止めたい場合は DISABLE_UPDATES を 1 にします。公式はこの設定を、自社の経路でClaude Codeを配布し、利用者を配布した版に留めたい場合に使うものとしています。

設定ファイルの置き場所や優先順位はsettings.jsonの解説記事で扱っています。

特定のバージョンに揃えたいときはどうするのか？

ネイティブインストーラーは、版番号かチャネル名（latest / stable）を引数に取れます。インストール時に選んだ更新チャネルが、その後の自動更新の既定になります。公式ドキュメントの「macOS, Linux, WSL」向けの形式で特定の版を入れる場合は次のとおりです。

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

stableチャネルで入れる場合は次のとおりです。

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

「Windows PowerShell」向けの形式で版を指定する場合は次のとおりです。

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

インストール済みの環境なら、claude install に版番号・stable・latest を渡しても入れ直せます。claude install stable や claude install latest は、指定したチャネルを設定にも保存します。入った版は claude --version で確認でき、指定した版番号がそのまま表示されます。

版指定のインストール後に自動更新がどう振る舞うかは、本稿で確認した公式記述の範囲では確かめられませんでした。手元で版を留めておきたい場合の一案として、前の章の設定と組み合わせる方法があります。ただし DISABLE_AUTOUPDATER は手動の claude update を止めず、DISABLE_UPDATES は claude install も含めて止める点に注意してください。

チームやCIで版をそろえる場合

Claude Codeを組織全体でチャネルを統一したい場合は、マネージド設定で強制できます。minimumVersion は更新を制約するだけなので、範囲外の版では起動させないようにしたいときは、マネージド設定の requiredMinimumVersion と requiredMaximumVersion を使います。上限を超えた版でも claude update・claude install・claude doctor は動くため、利用者が自分で復旧できます。

ホームディレクトリをNFSなどのネットワークストレージに置き、複数マシンで共有している場合、公式は DISABLE_UPDATES を設定して新しい版は自前のツールで入れるよう案内しています。DISABLE_AUTOUPDATER だけでは、利用者が claude update や claude install を実行できてしまうため不十分とされています。

法人での配布やセキュリティ要件の整理はエンタープライズ向けセキュリティガイド、GitHub Actionsで使う場合はGitHub Actions連携ガイドを参照してください。

アップデートが失敗した・動かなくなったときは何を確認するのか？

手がかりとして、claude --version で今の版を、claude doctor で直近の更新の結果を確認できます（claude doctor 自体が止まる場合は表の2行目を参照）。表示されたメッセージごとの公式の対処は次のとおりです。

症状・メッセージ	公式が示す対処
`The connection dropped while downloading the update` / `Download timed out: exceeded the total deadline`	`claude update` を再実行する。プロキシが必要な環境なら `HTTPS_PROXY` を設定してから実行する
`claude update` が `Checking for updates` の後で止まる	v2.1.214より前の版で、`~/.zshrc` などシェル設定ファイルのパスにディレクトリがあると起きる。そのディレクトリを移動するか、インストールスクリプトを再実行してv2.1.214以降に上げる
npmの更新・再インストールで `npm error code ENOTEMPTY`	`npm error path` 行に出たディレクトリと、隣にある `.claude-code-*` の残骸を削除し、`npm install -g @anthropic-ai/claude-code` で入れ直して `claude --version` で確認する
Windowsで更新直後に `'claude' is not recognized`	`%USERPROFILE%\.local\bin` に `claude.exe` が残っているか確認し、なければ `claude.exe.old.` で始まるバックアップを戻す
版が食い違う・予期しない挙動をする	複数のインストールが混在していないか確認し、1つだけ残す（公式は複数インストールが版の不一致や予期しない挙動の原因になりうるとしています）

Windowsでバックアップを戻すコマンドは、公式では次のように示されています。

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

複数インストールの確認として、公式はPATH上で見つかった claude を列挙する次のコマンドを挙げています。

which -a claude

npmの -g インストールがあるかは、公式が挙げる次のコマンドで確認できます。

npm -g ls @anthropic-ai/claude-code 2>/dev/null

Claude Codeが複数見つかった場合、公式は1つだけ残すよう案内しており、推奨はmacOS・Linuxなら ~/.local/bin/claude、Windowsなら %USERPROFILE%\.local\bin\claude.exe のネイティブ版です。不要になった方式の消し方はアンインストールの解説記事に、更新以外の主なエラーへの対処はエラー対処ガイドにまとめています。

ここに載せたコマンド名・設定キー・メッセージは、2026年10月18日に取得した公式ドキュメント（セットアップ、インストールのトラブルシューティング）を基に整理したものです。Claude Codeの版番号が関わる挙動は今後のリリースで変わることがあるため、気になる場合は /release-notes で手元の版の変更点を確かめてください。

Claude Codeを業務で使いこなすところまで仲間と一緒に学びたい場合は、月額1,980円から参加できる学習コミュニティ「AI駆動ラボ」も選択肢になります。