Claude Codeの更新方法を導入経路別に選ぶ

結論：導入した方法に合わせて更新する

「更新したはずなのに古いまま」「同僚とバージョンが違う」という問題は、更新コマンドだけでは切り分けられません。Nativeはバックグラウンド更新が次回起動時に反映され、パッケージ管理では配布の時差もあります。まずclaude --versionとclaude doctorで、今動いているバージョンと更新の診断結果を記録します。

2026年11月1日に公式Advanced setupとSettings files and precedenceを確認しました。特定の番号を「常に最新」として固定せず、自分の更新経路に合う操作と、更新を止める条件を選ぶための手順です。

インストール方法別の更新手順

Claude Codeの更新経路

導入方法	更新方法	注意点
Native	claude update	自動更新も利用可能。導入済みの設定を確認
Homebrew stable	brew upgrade claude-code	cask名がstableを選ぶ
Homebrew latest	brew upgrade claude-code@latest	別のcaskを重ねて導入しない
WinGet	winget upgrade Anthropic.ClaudeCode	実行中のファイルがロックされる場合がある
apt・dnf・apk	各パッケージ管理の更新手順	利用リポジトリと管理者の配布方針に従う

Nativeの自動更新は起動時と実行中に確認し、取得した更新を次回起動時に反映します。重要な作業の途中で無理に再起動する必要はありません。作業を区切って終了し、再起動後にバージョンを確認してください。更新前の番号だけを見たまま、成功と失敗を判断しないようにします。

Homebrew、WinGet、Linuxのパッケージ管理は既定で手動更新です。HomebrewとWinGetにはCLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEを使う選択肢もありますが、組織の配布方法がある場合は勝手に有効にしません。導入方法が分からないときはインストール方法の確認から整理します。

stableとlatestの選び方

latestは新しいリリースを早く受け取るchannelで、既定の選択です。stableは通常約1週間遅れ、重大な不具合を含むリリースを避ける方針です。stableなら不具合がないという保証ではないため、自社で使う認証、権限、フック、MCP連携の確認は残してください。

Nativeでは対話画面の/configにあるAuto-update channel、またはautoUpdatesChannelで選べます。一方、Homebrewはcask名、apt・dnf・apkは利用するリポジトリでchannelを選びます。すべての端末に同じ設定ファイルを書けば揃う、という運用にはしません。

{
  "autoUpdatesChannel": "stable"
}

この例はNativeでstableを選ぶ設定部分です。既存のsettings.json全体を置き換えず、他の設定を残して統合します。個人用と共有用の保存先はsettings.jsonの置き場所で確認できます。管理設定で指定された値がある場合は、その方針に従います。

新しく提供されたモデルには、stableで配布されるより新しいClaude Codeが必要な場合があります。そのときはモデルの利用を急ぐか、代表端末でlatestを試すかを判断します。新機能が欲しいという理由だけで、組織の全端末を一度に切り替えないようにしてください。

更新の下限と起動の制限を区別する

minimumVersionは更新先の下限です。自動更新とclaude updateが、この値より古いバージョンを導入しないようにします。現在latestの新しい番号で動いている場合、channelをstableへ変えても、この下限があると古い番号へ戻らないことがあります。

公式資料では/configでlatestからstableへ変更すると、今のバージョンを維持するか、古いバージョンへの変更を認めるかを選びます。維持を選ぶと現在の番号がminimumVersionになります。channelの表示だけを見て更新先を判断せず、下限と実際の番号を併せて確認してください。

これに対して、管理設定のrequiredMinimumVersionとrequiredMaximumVersionは、指定範囲外のバージョンで起動させないための制限です。更新では上限も尊重されます。更新に成功したのに組織の範囲外で起動できない場合と、下限のため更新先が変わらない場合を分けて調べます。

個人の設定で管理制限を迂回する方法は取りません。管理者へ渡す情報は端末のOS、導入経路、現在の番号、期待する番号、警告の本文、対象の設定元です。秘密値を含む環境変数や設定ファイルを丸ごと送る必要はありません。

更新されないときの診断手順

1. claude --versionで現在の番号を記録し、claude doctorでインストール状態と最後の更新結果を確認します。
2. Native、Homebrew、WinGet、Linuxパッケージのどれで導入したかを確かめ、対応する更新手順だけを選びます。
3. channel、minimumVersion、管理設定の上下限を確認します。設定ファイルが複数ある場合は適用元も調べます。
4. 自動更新を止める設定を確認します。DISABLE_AUTOUPDATERとDISABLE_UPDATESは同じ意味ではありません。
5. パッケージ管理側に候補が配布済みか確認します。通知が先行する既知の問題があるため、見つからない番号を繰り返し導入しません。
6. WinGetで実行ファイルのロックが原因なら、作業を保存してClaude Codeを終了し、承認された更新操作をやり直します。
7. 更新後に起動し直し、番号とdoctorの結果を読み戻します。失敗が続く場合は、新しい導入方法を重ねる前に診断結果を整理します。

DISABLE_AUTOUPDATERはバックグラウンドの更新確認を止めますが、手動のclaude updateやclaude installまで止める指定ではありません。手動経路も含めて更新を制限するのはDISABLE_UPDATESです。会社が独自配布している場合は、どちらを使っているかを管理者と確認してください。

macOSやLinuxのNative導入で起動用のファイルを独自のスクリプトへ差し替えている場合は、新しい本体が入っても、起動用スクリプトが選ぶ番号で動くことがあります。公式資料ではdoctorが独自の起動用ファイルを報告します。ファイルを手で削除する前に、その構成を管理している担当を確かめます。

組織へ展開する前のチェックリスト

• 代表端末の導入方法と前後の番号を記録した
• channelと管理設定の制限を確認した
• 通常のログインと対象プロジェクトを開ける
• 権限の確認画面と禁止操作が想定どおり動く
• 主要なフック、MCP、テストを一つずつ試した
• 問題が出た端末の展開を止める担当が決まっている

一台が通れば全端末が合格するわけではありません。OSや導入経路の代表ごとに試し、問題のある組み合わせだけを保留します。更新後の調査では診断ログの確認方法も使い、前後の番号と再現条件を添えて記録してください。

よくある質問

claude updateを実行すれば全環境で更新できますか？

導入経路によります。HomebrewやWinGetなどでは、対応するパッケージ管理の更新手順を使います。別経路で上書きせず、導入方法を先に確かめてください。

stableへ変えると古いバージョンになりますか？

必ず戻るわけではありません。現在の番号を維持する選択やminimumVersionの下限が影響します。channelと実際の番号を別に確認します。

minimumVersionで古いバージョンの起動も禁止できますか？

minimumVersionは更新の下限です。起動できる範囲を強制する場合は、管理設定のrequiredMinimumVersionとrequiredMaximumVersionを確認します。

公式資料と導入相談

公式Advanced setupでは導入方法別の更新、channel、更新制限を、Settings files and precedenceでは設定の範囲と優先順位を確認できます。更新番号や配布状況は変わるため、実行時にも公式情報と端末の表示を照らしてください。

Miraigentの無料診断ではAI導入による外注費削減の候補と、利用料・保守費・社内確認費を含めた実質削減額を整理します。更新を含む維持作業も費用に含め、導入後に誰が確認するかまで決めることが出発点です。