claude update コマンド｜自動更新と手動更新の使い分け
「claude update を実行すれば最新版になるのか」「自動更新されているはずなのに古いまま」——Claude Code のアップデートで迷う理由のほとんどは、インストール方法によって更新の仕組みが異なることです。本記事では claude update コマンドの動作を軸に、ネイティブインストーラ・Homebrew・WinGet・npm・Linux パッケージマネージャの各経路ごとの更新手順と、リリースチャンネルの選び方を整理します。
claude update は ネイティブインストーラ（install.sh / install.ps1） で導入した場合に最も有効で、実行すると今すぐ最新版を適用できます。ネイティブ版は自動更新もあるため、急がなければ次回起動を待つだけで構いません。
Homebrew や WinGet は自動更新が オフが初期値で、それぞれ brew upgrade claude-code / winget upgrade Anthropic.ClaudeCode が必要。npm 版は npm update -g ではなく必ず npm install -g @anthropic-ai/claude-code@latest を使う落とし穴があります。
更新の速さは autoUpdatesChannel の "latest"（即日）と "stable"（約1週間遅れ・不具合スキップ）で選べます。claude doctor を実行すると最新の更新試行結果を診断できます。
目次 (12)
- claude update コマンドの基本動作
- インストール方法別・自動更新と手動更新の一覧
- ネイティブインストーラ版 — 自動更新が標準、claude update で即時反映
- Homebrew 版（macOS）— brew upgrade と自動更新のオプトイン
- WinGet 版（Windows）— winget upgrade と自動更新のオプトイン
- npm 版 — npm update -g は使わない
- Linux パッケージマネージャ版（apt / dnf / apk）
- リリースチャンネルの選び方 — latest と stable
- バージョン固定 — minimumVersion と DISABLE_AUTOUPDATER
- claude doctor で更新状態を診断する
- 特定バージョンをインストールする
- よくある質問
claude update コマンドの基本動作
claude update は、バックグラウンドの自動更新を待たずに 今すぐ最新版を手動で取り込むためのコマンドです（出典：Claude Code 公式ドキュメント）。
claude update
コマンドを実行すると、Claude Code の内蔵アップデータが最新バイナリをダウンロードして置き換えます。ネイティブインストーラ・npm どちらの経路でも動作しますが、Homebrew / WinGet / apt / dnf / apk でインストールした場合は claude update が更新の手段として機能しません。それぞれのパッケージマネージャのコマンドが必要です（詳細は後述）。
更新後は以下でバージョンを確認できます。
claude --version
インストール方法別・自動更新と手動更新の一覧
最初に自分がどの方法で導入したかを確認してください。
| インストール方法 | 自動更新 | 手動更新コマンド |
|---|---|---|
| ネイティブインストーラ（macOS / Linux / WSL） | あり | claude update |
| ネイティブインストーラ（Windows PowerShell / CMD） | あり | claude update |
| Homebrew（macOS） | なし（オプトイン可） | brew upgrade claude-code |
| WinGet（Windows） | なし（オプトイン可） | winget upgrade Anthropic.ClaudeCode |
| npm グローバル | なし | npm install -g @anthropic-ai/claude-code@latest |
| 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 update で即時反映
ネイティブインストーラで導入した場合、Claude Code は起動時と稼働中に定期的に更新を確認します。ダウンロードとインストールはバックグラウンドで行われ、次回起動時から新しいバージョンが有効になります。
macOS / Linux / WSL でのインストールコマンドは次の通りです。
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell でのインストールコマンドは次の通りです。
irm https://claude.ai/install.ps1 | iex
いずれも「次回起動時に最新版になる」設計なので、急ぎでなければ何もしなくて構いません。すぐに反映したい場合だけ claude update を実行してください。
claude doctor を実行すると、直近の自動更新の成否と詳細なインストール状態を確認できます。
claude doctor
Homebrew 版（macOS）— brew upgrade と自動更新のオプトイン
Homebrew インストールは自動更新がオフのため、手動で更新が必要です。
# stable チャンネルの cask をインストールした場合
brew upgrade claude-code
# latest チャンネルの cask をインストールした場合
brew upgrade claude-code@latest
2 つの cask の違いは次の通りです。
claude-code（stable）: 約1週間遅れ、重大な不具合のあるリリースをスキップclaude-code@latest（latest）: リリース即日に届く
自動更新を有効にしたい場合は、設定ファイルに CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を追加します。
{
"env": {
"CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "1"
}
}
設定後は新バージョンが出ると Claude Code がバックグラウンドで brew upgrade を実行し、完了後に再起動を促します。brew cleanup を定期的に実行すると古いバージョンのディスク領域を回収できます。
WinGet 版（Windows）— winget upgrade と自動更新のオプトイン
WinGet 版も自動更新はオフが初期値です。
winget upgrade Anthropic.ClaudeCode
Homebrew と同様に CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 に設定すると自動更新が有効になります。ただし Claude Code が実行中のときは Windows がバイナリをロックしているためアップグレードが失敗することがあります。その場合は Claude Code を終了してから再実行してください。
npm 版 — npm update -g は使わない
npm でインストールした場合の最重要ポイントは、npm update -g が最新版に上がらない場合があることです。公式ドキュメントは npm update -g が「インストール時の semver 範囲を尊重するため、最新リリースに上がらない場合がある」と明記しています。
必ず以下のコマンドで更新してください。
npm install -g @anthropic-ai/claude-code@latest
古いバイナリが残って挙動が不安定なときはクリーン再インストールが有効です。
- 既存パッケージを削除する:
npm uninstall -g @anthropic-ai/claude-code - 最新版を入れ直す:
npm install -g @anthropic-ai/claude-code@latest - バージョンを確認する:
claude --version
sudo npm install -g は権限とセキュリティの問題を招くため、権限エラーが出た場合は npm の prefix 設定を見直すのが公式の推奨です。
Linux パッケージマネージャ版（apt / dnf / apk）
apt / dnf / apk でインストールした Claude Code は自動更新されません。システムの通常アップグレードフローで更新します。
# Debian / Ubuntu（apt）
sudo apt update && sudo apt upgrade claude-code
# Fedora / RHEL（dnf）
sudo dnf upgrade claude-code
# Alpine Linux（apk）
apk update && apk upgrade claude-code
管理者権限が必要なため、これらは CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE の対象外です。パッケージマネージャに新バージョンが届く前に Claude Code が通知を出す場合があります。その際はアップグレードが失敗しますが、しばらく待ってから再実行すれば解決します。
リリースチャンネルの選び方 — latest と stable
autoUpdatesChannel 設定でアップデートの速さと安定性を選べます。
| チャンネル | 特徴 | 向いているケース |
|---|---|---|
"latest"（デフォルト） |
新機能・修正をリリース即日に受け取る | 新機能を試したい、常に最新を使いたい |
"stable" |
約1週間遅れ、重大な不具合のあるリリースをスキップ | 業務での安定運用を優先したい |
設定は /config コマンドの「Auto-update channel」から変更するか、settings.json に直接記述します。
{
"autoUpdatesChannel": "stable"
}
"latest" から "stable" に切り替えると、現在より古いバージョンへのダウングレードが発生することがあります。その場合は「現在のバージョンに留まる」を選択すると minimumVersion が自動設定され、切り替え後も古いバージョンに戻らないよう保護されます。
バージョン固定 — minimumVersion と DISABLE_AUTOUPDATER
特定バージョン以下には戻したくない場合は minimumVersion を設定します。
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.100"
}
自動更新を完全に止めたい場合は DISABLE_AUTOUPDATER を使います。
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
DISABLE_AUTOUPDATER はバックグラウンドチェックを止めるだけで、claude update コマンドは引き続き使えます。claude update を含む手動更新もすべてブロックするには DISABLE_UPDATES を設定します。自社でバイナリを配布している場合など、バージョンを固定管理したいケースで使います。
claude doctor で更新状態を診断する
更新が正しく行われているか不安なときは claude doctor で一括確認できます。インストールの状態・バージョン・最新の自動更新試行の結果・設定の問題点をまとめて診断します。
claude doctor
"Auto-updates: enabled, last check succeeded" と表示されれば自動更新は正常に動作しています。npm 版でグローバルディレクトリへの書き込み権限がない場合は、claude doctor が具体的な修正方法を案内します。
特定バージョンをインストールする
ネイティブインストーラはバージョン番号を指定してインストールできます。
# macOS / Linux（バージョン指定）
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
インストール時に選択したチャンネルがそのまま自動更新のデフォルトチャンネルになります。
よくある質問
Q. claude update を実行したが古いバージョンのままだった
Homebrew / WinGet / apt でインストールした場合、claude update は機能しません。各パッケージマネージャのアップグレードコマンドを使ってください。ネイティブ版でも即時反映するのは次回起動時です。
Q. npm 版で npm update -g を実行してしまった
npm install -g @anthropic-ai/claude-code@latest を改めて実行すれば上書きできます。
Q. 自動更新の通知が来たが、Homebrew で更新できない
パッケージマネージャへの配布が遅れている場合があります。数時間後に再試行してください。
claude update は手軽な即時更新コマンドですが、すべてのインストール方法に対応しているわけではありません。まず自分のインストール方法を確認し、対応する更新コマンドを使うことが更新を確実に行う近道です。詳細な macOS 固有の手順はClaude Mac アップデート記事を、Linux 固有の手順はLinux 更新の詳細記事を参照してください。
