Claude を Linux で更新する方法｜claude update と npm の違い
Claude Code を Linux で最新の状態に保つ方法は、どのインストール手段を選んだかで大きく変わります。公式インストーラ版はバックグラウンドで自動更新される一方、npm 版や apt / dnf / apk 版は手動更新が前提です。本記事では claude update コマンド・npm の更新・パッケージマネージャでのアップグレード・自動更新の制御・トラブル対処までを、公式ドキュメントの手順に沿って整理します。
公式インストーラ（curl -fsSL https://claude.ai/install.sh | bash）で導入した Claude Code は、起動時と稼働中に更新を確認し バックグラウンドで自動更新 されるため、原則として手動操作は不要です。直近の更新結果は claude doctor で確認できます。
最大の落とし穴は npm 版で、npm update -g を使うと最新版に上がらない場合があります。npm 版は必ず npm install -g @anthropic-ai/claude-code@latest で更新し、どのインストール方法でも今すぐ反映したいときは claude update が使えます。
apt / dnf / apk 版は システムの通常アップグレードで更新 する手動運用です。更新の即時性と安定性は autoUpdatesChannel（latest / stable）と minimumVersion で制御でき、DISABLE_AUTOUPDATER を設定すれば自動更新そのものを止められます。
目次 (10)
Claude Code の Linux 更新は「3系統」を押さえる
Linux での更新方法は、インストール手段ごとに挙動が異なります。まずは自分がどの方法で入れたかを把握するのが出発点です。公式ドキュメントが定義する系統は次のとおりです。
| インストール方法 | 自動更新 | 手動更新コマンド |
|---|---|---|
| 公式インストーラ（install.sh） | あり（標準） | claude update |
| npm グローバル | なし | npm install -g @anthropic-ai/claude-code@latest |
| apt / dnf / apk | なし | システムのアップグレード |
どの方法で入れていても、claude update による即時更新と claude --version でのバージョン確認は共通で使えます。Linux の対応環境は Ubuntu 20.04 以上・Debian 10 以上・Alpine Linux 3.19 以上で、4GB 以上の RAM と x64 / ARM64 が要件です。導入そのものの手順は別記事の Claude Linux アプリ導入の使い方 で詳しく扱っています。
公式インストーラ版は自動更新 — claude doctor で結果確認
公式インストーラ（curl -fsSL https://claude.ai/install.sh | bash）で導入した場合、Claude Code は 起動時と稼働中に定期的に更新をチェック します。更新はバックグラウンドでダウンロード・インストールされ、次回起動時に反映される仕組みです。利用者が能動的に何かを実行する必要は基本的にありません。
更新が正しく適用されたかを確認したいときは、次のコマンドで直近の更新試行の結果を表示できます。
claude doctor
claude doctor はバージョン情報だけでなく、インストールや設定の問題点も併せて診断します。なお npm グローバル版で導入していて npm のグローバルディレクトリに書き込み権限がない場合、自動更新に失敗し起動時に一度だけ警告が表示されます。その際は claude doctor が修正方法を案内します。
今すぐ更新する claude update コマンド
次回起動を待たずに最新版を今すぐ適用したい場合は、インストール方法を問わず次のコマンドを実行します。
claude update
claude --version
claude update は組み込みのアップデータを呼び出すため、npm コマンドを覚えていなくても更新できるのが利点です。更新後は claude --version で反映を確認し、GitHub の Releases ページに並ぶ最新リリースと突き合わせるとよいでしょう。Claude Code は数週間ごとに新機能・モデル対応・バグ修正を加えてリリースされています。
npm 版更新の落とし穴 — npm update -g を使わない
npm でグローバルインストールした場合、更新で最も間違えやすいのが npm update -g の使用です。公式ドキュメントは明確に次のように述べています。
アップグレードには
npm install -g @anthropic-ai/claude-code@latestを実行してください。npm update -gはインストール時の semver 範囲を尊重するため、最新リリースに上がらない場合があります。
したがって npm 版の正しい更新手順は次の1コマンドです。
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 は権限とセキュリティの問題を招くため避けてください。権限エラーが出る場合は sudo ではなく npm の prefix 設定を見直すのが公式の推奨です。
apt / dnf / apk パッケージ版の更新コマンド
Anthropic は署名済みの 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
apt / dnf / apk が手動更新のままなのは、これらのアップグレードに管理者権限が必要なためです。Homebrew や WinGet では CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 に設定すると Claude Code が自動でアップグレードを実行しますが、Linux のパッケージマネージャはこの対象外です。また、パッケージマネージャに新バージョンが届く前に Claude Code が更新を通知することがあり、その場合はアップグレードが失敗します。少し待ってから再実行してください。
更新の速さと安定性を選ぶ — リリースチャンネルとバージョン固定
更新で受け取るバージョンの新しさは、autoUpdatesChannel 設定で切り替えられます。選択肢は2つです。
"latest"（既定）：新機能がリリースされ次第すぐ受け取る"stable"：大きなリグレッションを含むリリースを飛ばした、概ね1週間前のバージョンを使う
settings.json に次のように記述するか、/config の「Auto-update channel」から変更します。
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.100"
}
minimumVersion は更新の下限を定める設定で、自動更新も claude update もこの値より古いバージョンはインストールしません。すでに新しい latest 版を使っている状態で stable に切り替えてもダウングレードされないため、安定版運用へ移行する際の安全弁になります。組織で統一したい場合は managed settings で全体に強制できます。
自動更新を止める — DISABLE_AUTOUPDATER と DISABLE_UPDATES
自動更新を無効化したい場合、目的に応じて2つの環境変数を使い分けます。バックグラウンドの更新チェックだけを止めるなら、settings.json の env に次を設定します。
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
DISABLE_AUTOUPDATER は自動チェックを止めるだけで、claude update や claude install による手動更新は引き続き動作します。手動を含むすべての更新経路を塞ぎたい場合は、代わりに DISABLE_UPDATES を設定してください。社内で独自に配布し、利用者を特定バージョンに固定したい運用ではこちらを使います。
特定バージョンへの更新とロールバック
不具合のあるリリースを避けたい、検証用に過去版へ戻したい場合は、バージョンを指定してインストールできます。公式インストーラはバージョン番号やチャンネルを引数に取ります。
# 特定バージョンを指定（公式インストーラ）
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
# 安定版チャンネルを指定
curl -fsSL https://claude.ai/install.sh | bash -s stable
npm 版で特定バージョンに固定したい場合は @<バージョン> を付けて実行します。
npm install -g @anthropic-ai/claude-code@2.1.89
設定や許可ツール、MCP サーバー構成、セッション履歴は ~/.claude/ に保存され、更新やロールバックをまたいで保持されます。バージョンを切り替えても設定をやり直す必要はありません。
更新できないときのトラブル対処
更新が反映されないときは、原因の切り分けを順番に進めます。
- バージョンと診断を確認する：
claude --versionとclaude doctorで現状と直近の更新試行の結果を把握する - npm の権限を見直す：グローバルディレクトリに書き込めないと自動更新が失敗する。
sudo npm install -gは使わず、claude doctorが示す修正案に従う - Node.js のバージョンを確認する：npm 版は Node.js 18 以上が必要。
node --versionで確認する - パッケージ未反映を疑う：apt / dnf / apk で「更新あり」と出ても配信前のことがある。少し待って再度アップグレードする
- クリーン再インストールする：上記で直らなければ npm 版を削除して
@latestで入れ直す
それでも解決しない場合は、GitHub の Issues や公式のセットアップ・更新ドキュメントで既知の問題を確認するのが確実です。
まとめ
- 更新挙動はインストール方法で3系統に分かれる（公式インストーラ＝自動 / npm・apt系＝手動）
- 公式インストーラ版は バックグラウンド自動更新、
claude doctorで結果を確認 - どの方法でも
claude updateで今すぐ更新でき、claude --versionで反映を確認 - npm 版は
npm update -gではなく@latest指定 で更新するのが必須 - apt / dnf / apk は
sudo apt upgrade claude-codeなどシステム標準のアップグレードで更新 - 更新の速さは
autoUpdatesChannel、固定はminimumVersion、停止はDISABLE_AUTOUPDATERで制御
