Claude Codeのアップデート方法claude updateと自動更新の仕組み
Claude Codeのアップデート方法を整理。ネイティブ版の自動更新、claude update、Homebrew・WinGet・npm の更新コマンド、stable と latest の違いを解説します。
公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて
Claude Codeのアップデート方法とは
Claude Code の更新方法は、インストール方法で変わります。公式のセットアップには、ネイティブインストールは、起動時と実行中に定期的に更新を確認し、バックグラウンドで取得して、次回の起動から有効にすると書かれています。つまり、ネイティブ版は、多くの場合、何もしなくても最新に近い状態が保たれます。
一方、Homebrew、WinGet、apt、dnf、apk、npm で入れた場合は、自動では更新されません。自分でコマンドを実行する必要があります。この記事では、方法ごとの更新コマンドと、更新が止まったときの対処を整理します。
基本（インストール方法別の更新）
| インストール方法 | 更新の仕方 | 自動更新 |
|---|---|---|
| ネイティブ（推奨） | 自動。すぐ反映したいときは claude update |
あり |
| Homebrew | brew upgrade claude-code（latest 版は brew upgrade 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 |
条件による |
公式は、npm では npm update -g を避けるよう案内しています。最初のインストールの版の範囲に従うため、最新に移れないことがあるためです。
claude update を実行すると、更新があれば「Successfully updated from <旧版> to version <新版>」、すでに最新なら「Claude Code is up to date」のように表示されます。Homebrew、WinGet、apk の場合は「Claude is up to date!」と出ます。
具体例（チャンネルと自動更新の調整）
更新の受け取り方は、設定の autoUpdatesChannel で選べます。
| 設定値 | 内容 |
|---|---|
"latest"（既定） |
新機能を、リリースされ次第すぐ受け取る |
"stable" |
約1週間遅れの版。大きな不具合のあった版を飛ばす |
設定は /config の「Auto-update channel」か、設定ファイル（settings.json）に書きます。
{
"autoUpdatesChannel": "stable"
}
latest から stable に替えると、今より古い版へ戻ることがあります。公式によると、minimumVersion（例："2.1.100"）を設定すると、それより古い版は自動更新でも claude update でも入らなくなります。/config から stable に切り替える場合は、今の版にとどまるか、戻すかを聞かれます。
自動更新を止めたいときは、設定の env に DISABLE_AUTOUPDATER を "1" で指定します。これは背景の確認を止めるだけで、claude update は使えます。手動の更新も含めてすべて止めるなら、DISABLE_UPDATES を使います。止まっているかは、claude doctor の Auto-updates の行で確認できます。
Claude Codeのアップデートを進める具体的な手順
- 現在の版を
claude --versionで確認する。 - ネイティブ版なら、
claude updateを実行する。 - Homebrew や WinGet なら、上の表のコマンドを実行する。
- 更新後、新しい端末で
claude --versionを確認する。 - 更新が失敗する場合は、
claude doctorで、直近の更新の結果を確認する。 - 最新の版が必要な新しいモデルを使いたいときは、チャンネルを
latestにする。
Claude Codeのアップデート方法の注意点
- 新しく登場したモデルは、stable チャンネルの版より新しい Claude Code を必要とすることがあります。使えないときは、
latestに切り替えます。 - WinGet では、Claude Code が起動中だと、Windows が実行ファイルをロックして、更新に失敗することがあります。
- Homebrew は、更新後も古い版をディスクに残します。
brew cleanupで空き容量を戻せます。 - パッケージマネージャーの更新は、新版の通知が出てから、実際に利用可能になるまで時間差がある場合があると、公式に記載されています。失敗したら、時間をおいて再実行します。
- 古い版では、
claude updateやclaude doctorが、設定ファイルのパスにフォルダがあると止まる問題が報告されています（v2.1.214 で解消）。
Claude Codeのアップデート方法でよくあるミス
- Homebrew や WinGet で入れたのに、自動で更新されると思い込む。
- npm で
npm update -gを使い、最新に上がらない。 - 更新したのに、同じ端末のまま確認し、古い版が表示される。
- 複数のインストールが混在し、更新したものと違う
claudeが起動する。
Claude Codeのアップデート方法のチェックリスト
- インストール方法（ネイティブ、Homebrew、WinGet、npm など）を把握しているか。
- 対応する更新コマンドを実行したか。
- 更新後の版を
claude --versionで確認したか。 - 更新の受け取り方（latest か stable）を決めているか。
- 更新が失敗するとき、
claude doctorを見たか。
Claude Codeのアップデート方法のFAQ（よくある質問）
Q. 更新を止めることはできますか。
A. できます。DISABLE_AUTOUPDATER を "1" にすると、自動の確認が止まります。
Q. 更新して、不具合が出たら戻せますか。
A. 公式のセットアップに、特定の版を指定してインストールする方法があります。インストールスクリプトに、版番号を渡します。
Q. 更新したのに、機能が増えていません。
A. stable チャンネルは、約1週間遅れで届きます。すぐ使いたければ latest に切り替えます。
筆者の見解（Claude Codeのアップデート方法）
私見では、更新で迷う原因の多くは「自分がどの方法で入れたか」を把握していないことにあります。自動更新されるのはネイティブ版だけで、Homebrew や WinGet で入れた人は、放っておくと古い版のまま使い続けることになる点が見落とされやすいと考えます。選ぶべきは latest と stable のどちらかですが、仕事で毎日使うなら、約1週間遅れで大きな不具合の版を飛ばす stable に、minimumVersion を組み合わせる運用が、新機能より安定を優先したい人には合うと考えます。ただし、新しいモデルを出てすぐ使いたい人には stable は向かないので、何を優先するかで決めるのがよいと考えます。
Claude Codeのアップデート方法の関連項目
- claude doctor と /doctor の使い方
- claudeコマンドが見つからないエラー
- Windowsへのインストール方法
- ログインできない問題
- settings.jsonが効かないときの確認
出典（一次情報）
本記事は一般的な情報の提供を目的としています。Claude Code の料金・利用上限・機能・エラーメッセージ・コマンドは頻繁に更新されるため、最新の内容は Anthropic の公式ドキュメントとお使いのバージョンで必ずご確認ください。契約・請求・セキュリティに関する判断は、公式サポートや社内の担当部門にご相談ください。「筆者の見解」は一つの考え方です。