Claude Codeの更新経路を組織でそろえる

結論：更新commandより先に導入方法とchannelを確認する

読者の具体的な困りごとは、ある端末はbackground更新、別端末は手動更新、さらにstableとlatestが混在し、不具合がversion差なのか設定差なのか切り分けられないことです。この記事を読むと、今すぐ更新、代表端末だけ更新、stable維持、展開停止を9手順で判断できます。

次の行動：利用端末を一台選び、現在version、install方法、release channel、自動更新の有無、最終確認日を一行へ記録してください。install方法が不明な端末へ更新commandを配りません。

Claude Codeの更新方式と公式の最新version

Anthropic公式Advanced setupでは、Native installは起動時と実行中にupdateを確認し、backgroundでdownloadして次回起動時に反映します。Homebrew、WinGet、apt、dnf、apkは既定で手動更新です。Homebrewはbrew upgrade claude-codeまたはclaude-code@latest、WinGetはwinget upgrade Anthropic.ClaudeCodeを使います。package managerが違えば同じcommandではそろいません。

HomebrewとWinGetではCLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1によりClaude Codeが対象packageだけをbackground更新する選択肢があります。一方、WinGetはClaude Code実行中にexecutableがlockされ、更新に失敗する場合があると公式guideに記載されています。通知が先に届きpackage manager側へreleaseがまだ現れないknown issueもあるため、一度の失敗を破損と断定せず、versionと配布状況を記録します。

release channelはlatestが既定で、新機能を公開直後に受け取ります。stableは通常約1週間遅れ、重大なregressionを含むreleaseをskipする方針です。NativeはautoUpdatesChannel、Homebrewはcask名でchannelを選びます。組織ではmanaged settingsを使って同じchannelを強制できます。

2026年8月13日0時台JSTの公開直前readbackでは、公式Changelogの最新表示は2026年8月11日公開のv2.1.228です。interactive redraw、WindowsのGit検出、session cleanup、synced Skills、Remote Controlなどの修正を含みます。ただしこの記事の目的は特定versionを無条件に推奨することではありません。Changelogの最新値は更新のたびに変わるため、導入直前に再確認します。

latest・stable・固定下限を6軸で比較する

1. 受取速度：latestは公開直後、stableは通常約1週間後です。新機能の必要日と変更窓を比較します。
2. regression回避：stableは重大なregressionをskipする運用です。ただし「不具合がない保証」ではなく、代表taskの試験は残します。
3. security修正：permission bypassやcredential関連など影響が大きい修正は、stable待ちのriskと早期更新のriskを個別評価します。
4. 導入経路：Nativeはsetting、Homebrewはcask、WinGetやLinux package managerは配布反映時差を含めて管理します。
5. version下限：minimumVersionは自動更新とclaude updateが下限未満を入れないようにします。channel変更と別の設定です。
6. 復旧：前versionへ戻す方法、設定backup、代表project、停止責任者がない場合は一斉展開せずcanaryにします。

latestからstableへ切り替える時、公式guideでは現在versionを維持するかdowngradeを許可するか確認されます。現在version維持を選ぶと、そのversionがminimumVersionに設定されます。つまりchannel名だけ見て「stable相当へ戻った」と判断できません。実際のclaude --versionと設定の両方を記録します。

更新によってClaudeのsubscriptionやAPI料金が別のplanへ自動変更されるわけではありませんが、新機能の使い方、model選択、長時間taskによって利用量は変わり得ます。version展開では技術試験だけでなく、代表taskの所要時間、利用表示、review工数も比較します。

安全に更新する9手順

1. 対象端末でclaude --versionとclaude doctorを実行し、現在version、install health、update失敗、settings errorを記録します。
2. Native、Homebrew stable、Homebrew latest、WinGet、apt、dnf、apkのどれかを台帳へ固定します。複数経路で上書きしません。
3. autoUpdatesChannel、Homebrew cask、minimumVersion、package manager自動更新envを確認します。
4. 公式Changelogで現在versionから候補versionまでを読み、permission、認証、filesystem、MCP、Hooks、IDE、OS別の変更を分類します。
5. 本番秘密を外した代表端末一台をcanaryにし、組織が承認した正しいupdate方法で更新します。
6. 更新後にversionとdoctorを再確認し、login、workspace trust、managed settings、permission、sandbox、MCP接続を照合します。
7. 代表taskとしてread、edit、test、Git差分review、Hook、MCPの小さな一件を実行し、期待外のwriteやnetworkがないか確認します。
8. 不具合、費用増、review差、OS固有問題がなければ段階展開し、各端末のversionと完了時刻を記録します。
9. 異常が出たら配布を止め、再現条件、前version、channel、install方法、設定差を保存してrollbackまたはstable待ちを判断します。

自動更新でも運用責任は消えません。updateは次回起動で反映されるため、同じ日に起動し続けた端末と再起動した端末でversionが分かれます。朝会やdeploy前にversionを固定する必要があるteamは、代表作業の開始時にversionを記録し、重要な変更中の自動反映タイミングを確認します。

展開チェックリストとHOLD条件

• 全端末のinstall方法を分類した
• stable・latestの方針を決めた
• minimumVersionを確認した
• Changelogの差分を読んだ
• 代表端末を分離した
• 更新前後のversionを記録した
• doctorの警告を確認した
• 認証とmanaged settingsを確認した
• permissionとsandboxを試した
• HooksとMCPを試した
• 費用とreview工数を比較した
• rollback方法を確認した

HOLDするのは、install方法が不明、Changelog未確認、代表projectがない、managed settingsと端末設定が競合、credentialやpermissionの挙動が変わった、package managerへ候補versionが未配布、rollbackできない場合です。更新本数や期限のために、検証未達端末を完了扱いにしません。

よくある質問と次の行動

install別の更新、stable・latest、minimumVersionはAnthropic公式Advanced setup、最新versionと修正内容はClaude Code公式Changelog、組織配布するsettingsのscopeは公式Settings guideで公開直前にも確認してください。

導入経路の整理はClaude Codeのインストール、Windows差はNativeとWSL 2の比較、更新影響の記録は監査ログと判断記録へつなげます。Miraigentの無料診断では、install方法、channel、canary、検証、rollbackを一枚の更新表へ整理します。