Claude Codeアップデートの方法 — 更新コマンドと自動更新の停止
Claude Codeの更新はclaude updateの1コマンドです。DISABLE_AUTOUPDATERでの自動更新の停止、autoUpdatesChannelでのチャネル選択、インストール方法別の更新コマンドを載せます。
Claude Codeは何もしなくても最新版に保たれる
ネイティブインストール(curl -fsSL https://claude.ai/install.sh | bash などの標準手順)を使っていれば、Claude Codeは起動のたびに更新を確認し、バックグラウンドで新しいバージョンを取得します。手を動かすのは、今すぐ更新したいとき、追いかけるチャネルを変えたいとき、自動更新を止めて特定のバージョンに留めたいときの3つです。
Claude Codeの更新方法は、手動なら claude update、チャネルの選択なら autoUpdatesChannel、自動更新の停止なら DISABLE_AUTOUPDATER が対応します。Homebrewやnpmで入れた場合のコマンドは、後半の表にあります。インストール自体がまだならClaude Code install完全ガイドが先です。特定バージョンへの固定やダウングレードはClaude Codeのバージョン確認と固定・ダウングレードにあります。
自動更新が反映されるまでの流れ
見つかった新バージョンは、次の順で反映されます。
自動更新の流れ
- 1
起動時と実行中に確認する
起動時のほか、実行中も定期的に新しいバージョンがないかを調べます。
- 2
バックグラウンドで入れる
ダウンロードとインストールは、バックグラウンドで進みます。
- 3
次回起動で切り替わる
実際に新しいバージョンになるのは、次にClaude Codeを起動したときです。
直近の更新がどうなったかは claude doctor で確認できます。v2.1.287で claude doctor --help を実行すると、次の説明が出ました。
claude doctor --helpUsage: claude doctor [options]
Check the health of your Claude Code installation. Reads settings files in the
current directory without a trust prompt. For a full checkup that can also fix
issues, run /doctor in a session.つまりシェルから打つ claude doctor は診断だけで、修復まで含めた点検はセッション内の /doctor です。自動更新を環境変数で止めた後は、Auto-updates の行が enabled から disabled (set by env: DISABLE_AUTOUPDATER) に変われば反映済みです(ネイティブインストールとnpmインストールの場合)。
macOS/Linuxでは、~/.local/bin/claude が ~/.local/share/claude/versions/ 配下の実体へのシンボリックリンクです。ここを自分のスクリプトやシンボリックリンクに置き換えている場合、v2.1.207以降は自動更新がそのランチャーを上書きしません。新しいバージョンは versions/ に追加されるだけで、どれを実行するかはランチャー側が決めます(v2.1.207より前は更新のたびに上書きされていました)。
この状態は claude doctor が「ネイティブインストーラーが作成していないランチャー」として報告します。ランチャーがある間は、Claude Codeがどのバージョンが必要か判断できないため、入れたバージョンをすべてディスクに残します。管理をClaude Codeに戻すなら ~/.local/bin/claude を削除して claude update を実行します。ランチャーが標準のままなら、ネイティブインストーラーはランチャーが指すバージョンと、同じマシンで実行中のバージョン、新しい方から2つを残して、古いバージョンを自動で削除します。
今すぐ更新したいとき
自動チェックを待たずに更新を当てるコマンドは次の1つです。
claude update更新が入ると Successfully updated from <旧バージョン> to version <新バージョン> と表示されます。すでに最新なら Claude Code is up to date (<バージョン>) です。Homebrew・WinGet・apk管理下では Claude is up to date! という表示になります。
v2.1.287の claude update --help では、コマンド名が claude update|upgrade と表示されました。claude upgrade でも同じ動作になる別名です。
Usage: claude update|upgrade [options]
Check for updates and install if available
Options:
-h, --help Display help for commandチャネルや特定バージョンを指定して入れ直す場合は claude install です。[target] に stable・latest・バージョン番号のいずれかを渡せ、--force で導入済みでも再インストールします(v2.1.287の claude install --help より)。
Usage: claude install [options] [target]
Install Claude Code native build. Use [target] to specify version (stable,
latest, or specific version)
Options:
--force Force installation even if already installed
-h, --help Display help for command追いかけるチャネルを変える
追いかける速さは autoUpdatesChannel 設定で選びます。既定は "latest" で、リリース直後に新機能を受け取れます。"stable" にすると、大きな不具合のあるリリースをスキップした、およそ1週間遅れのバージョンを追いかけます。
{
"autoUpdatesChannel": "stable"
}切り替えは /config の「Auto-update channel」でも、settings.jsonへの直接記述でも行えます。/config で "latest" から "stable" へ変えると、今のバージョンに留まるかダウングレードを許可するかを尋ねられます。留まる方を選ぶと minimumVersion にそのバージョンが設定され、"latest" へ戻すと消えます。claude install stable や claude install latest を実行したときも、指定したチャネルが保存されます。settings.jsonの書き方全般はClaude Code設定ガイドを参照してください。
Homebrewだけは別で、このキーを無視してcaskの名前でチャネルを選びます。claude-code が安定版、claude-code@latest が最新版です。
自動更新を止める・バージョンを固定する
止め方は2段階あり、混同すると意図と違う挙動になります。設定はsettings.jsonの env キーに書きます。
自動更新を止める2つの環境変数
DISABLE_AUTOUPDATER
バックグラウンドの自動チェックだけを止めます。claude update と claude install は使えるままなので、更新のタイミングだけ自分で決めたいときに使います。
DISABLE_UPDATES
自動更新に加え、claude update と claude install も使えなくなります。社内の配布経路でバージョンを配り、ユーザーに自己更新させたくないときに使います。
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}settings.json ではなく ~/.claude.json に直接 autoUpdates: false を置く形について、GitHubのissue #91646に報告があります。起票者によると、ネイティブアップデーターがこの設定を無視しました。起票者は、2日間に2回、うち1回はセッション中に更新されたと書いています。同種の報告はissue #75607にもあります。詳細はClaude CodeでautoUpdatesが無視されるという報告と確実な止め方にあります。
バージョンの下限・上限を決める設定は3つあり、効く範囲が違います。
| 設定 | 置ける場所 | 効き方 |
|---|---|---|
minimumVersion | 置ける場所どの設定ファイルでも可 | 効き方自動更新と claude update が、この値より古いバージョンを入れない |
requiredMinimumVersion | 置ける場所managed settingsのみ | 効き方実行中のバージョンが下回ると起動を拒否する |
requiredMaximumVersion | 置ける場所managed settingsのみ | 効き方上回ると起動を拒否し、自動更新と claude update も上限を超えるバージョンをスキップする |
minimumVersion は "stable" へ切り替えても新しいビルドからダウングレードされない安全弁です。managed settingsに置けば、ユーザー設定で上書きできない組織全体の下限になります。後の2つは起動そのものを止めますが、範囲外でも claude update ・claude install ・claude doctor は動くので、ユーザー側で復旧できます。環境変数の全体像はClaude Code環境変数リファレンスにまとめています。
使っているインストール方法から更新コマンドを選ぶ
どの経路で入れても中身は同じネイティブバイナリですが、自動更新の有無と手動コマンドは方法によって変わります。
| インストール方法 | 既定の自動更新 | 手動更新コマンド |
|---|---|---|
| ネイティブインストーラー | 既定の自動更新あり | 手動更新コマンドclaude update |
| Homebrew | 既定の自動更新なし | 手動更新コマンドbrew upgrade claude-code(または claude-code@latest) |
| WinGet | 既定の自動更新なし | 手動更新コマンドwinget upgrade Anthropic.ClaudeCode |
| apt | 既定の自動更新なし | 手動更新コマンドsudo apt update && sudo apt upgrade claude-code |
| dnf | 既定の自動更新なし | 手動更新コマンドsudo dnf upgrade claude-code |
| apk | 既定の自動更新なし | 手動更新コマンドapk update && apk upgrade claude-code |
| npm | 既定の自動更新書き込み権限があれば有効 | 手動更新コマンドnpm install -g @anthropic-ai/claude-code@latest |
HomebrewとWinGetは、CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE を 1 にすると自動化できます。新しいバージョンがあるときにClaude Code自身がバックグラウンドで brew upgrade ・winget upgrade 相当の処理を走らせ、成功すると再起動を促します。対象はClaude Codeのパッケージだけです。apt・dnf・apkは管理者権限が要るため、この環境変数でも自動化できず手動のままです。Homebrewは更新後も旧バージョンをディスクに残すので、brew cleanup で空き容量を回収します。
npmの更新に npm update -g を使わないのは、元のインストール時のsemver範囲に従うため最新バージョンに上がらないことがあるからです。明示的に @latest を付けます。
共有ストレージに置く環境では、npm install -g による更新が古いバイナリを削除します。他のマシンで動いているセッションは、実行中のバイナリを失います。各バージョンを別ディレクトリに置き、自動更新はDISABLE_UPDATESで止めます。
更新がうまくいかないときの症状別の対処
claude update が Checking for updates のまま止まる。claude update と claude doctor は、古い claude エイリアスを探すためにシェル設定ファイルをスキャンします。対象は ~/.zshrc ・~/.bashrc ・~/.config/fish/config.fish で、macOSでは ~/.bash_profile ・~/.bash_login ・~/.profile のうち最初に存在するものも含みます。ZDOTDIR を設定している場合、Zshのファイルは $ZDOTDIR/.zshrc です。これらのパスがディレクトリだとハングします(v2.1.214以降は該当パスをスキップします)。該当ディレクトリを退避するか、v2.1.214以降へ更新します。ただしハング中は claude update が使えないため、更新はインストールスクリプトの再実行で行います。
npmのグローバルディレクトリに書き込めず、自動更新が効かない。起動時に一度だけ通知が出て、claude doctor に具体的な対処法が並びます。ネイティブインストーラーへ切り替えるのも手です。個別のエラーメッセージからの切り分けはClaude Codeインストールエラーの切り分けチェックリストにあります。
WinGetの更新がClaude Code実行中に失敗する。Windowsが実行ファイルをロックするためで、この場合Claude Codeは手動コマンドを案内します。終了してから winget upgrade Anthropic.ClaudeCode を実行します。デスクトップアプリ側の更新が進まない場合はWindows 11で更新されないときの切り分けを参照してください。
更新通知が出ても、新バージョンがまだ入らない。apt・dnf・apk・Homebrew・WinGetでは、Claude Codeが更新を通知した時点でパッケージ側に新バージョンが無いことがあります。既知の挙動で、失敗したら時間を置いて再試行します。Homebrewで古いバージョンしか入らないときは、claude-code caskが安定版(最新より約1週間遅れ)を追っている影響もあり、最新が欲しければ brew install --cask claude-code@latest です。
ダウンロード中に The connection dropped while downloading the update で失敗する。プロキシ環境でのタイムアウトやトンネル切断が疑われます。切り分けはThe connection droppedエラーの対処にあります。
ログインし直す場面では、claude.ai・APIキー・OAuthトークンのどれで入り直すかの選び方をClaude Codeログイン方法3種の使い分けで確認できます。
まとめ
更新のタイミングだけ自分で決めたいなら DISABLE_AUTOUPDATER で足ります。配布経路の外から更新させたくない環境や共有ストレージでは、claude update まで止まる DISABLE_UPDATES を選ぶ形になります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。