Claude Mac アップデート｜Code 自動更新・brew・npm 手順
Mac で Claude を使い始めたあと、最初につまずきやすいのが「どうやって最新版に上げ続けるか」です。インストール経路によって自動更新の有無が変わり、運用コマンドも別物になります。本記事では Claude Code を中心に、3 経路ごとのアップデート手順とリリースチャンネル切替、検証コマンドまでを Anthropic 公式情報ベースで整理します。
Mac で Claude Code を最新化する経路は ネイティブインストーラ・Homebrew・npm の 3 通り で、このうち バックグラウンド自動更新が付くのはネイティブインストーラだけ です。curl -fsSL https://claude.ai/install.sh | bash の 1 行で導入でき、起動時と起動中に定期チェックが走り、次回起動から新版が有効になります。
Homebrew は brew upgrade claude-code の手動運用が原則ですが、CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 を settings.json に書けば Claude Code 自身がバックグラウンドで brew upgrade を実行 してくれます。npm 経路では npm install -g @anthropic-ai/claude-code@latest が正式で、npm update -g は最新版を取りこぼす可能性があるため非推奨 です。
どの経路でも、待たずに即時更新したいときは claude update が共通の安全策です。更新後は claude --version でバージョン番号を、claude doctor で依存と権限の整合をまとめて確認できます。リリースチャンネルは autoUpdatesChannel を stable に切り替える と約 1 週間遅らせて大きな回帰を避けられます。
目次 (12)
- Mac でのアップデート 3 経路 — 自動更新の有無で運用が変わる
- ネイティブインストーラ — バックグラウンド自動更新で最も推奨
- claude update — 即時更新したいときの共通コマンド
- Homebrew で更新する — brew upgrade と自動化フラグ
- CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE で Homebrew を自動化
- npm で更新する — sudo を避け latest を明示
- sudo npm install -g は厳禁
- リリースチャンネル切替 — latest と stable の使い分け
- 更新後の確認手順 — claude --version と claude doctor
- アップデートでよくあるトラブル — 権限・PATH・キャッシュ
- Claude Desktop App for Mac の更新 — メニューと App Store
- まとめ — Mac で Claude を最新に保つ判断軸
Mac でのアップデート 3 経路 — 自動更新の有無で運用が変わる
Claude Code は Mac 上で ネイティブインストーラ・Homebrew・npm の 3 経路から導入でき、それぞれアップデートの仕組みが異なります出典。ネイティブインストーラはバックグラウンドで自動更新が走るため、開発者が意識せずとも常に最新が維持されます。Homebrew と npm は手動運用が前提で、リリースから数週間放置すると古い版に取り残されやすい点に注意が必要です。
3 経路を選ぶ判断軸はシンプルで、チームで足並みを揃えて常に最新を使うならネイティブ、既存の Homebrew 中心の dev 環境に合わせるなら brew、Node.js プロジェクトの一部として PATH 管理したいなら npm という整理になります。新規導入であれば、後述する自動更新の差から ネイティブ経路が最有力候補 です。
なお、本記事は Claude Code を中心に扱いますが、別アプリの Claude Desktop App for Mac は dmg / App Store 配布で、アプリ内メニューの「Check for Updates」または App Store 経由で更新します。CLI コマンドではなく GUI 操作になる点で運用が異なるため、後半で個別に触れます。
ネイティブインストーラ — バックグラウンド自動更新で最も推奨
Anthropic が公式に推奨する経路がネイティブインストーラで、Mac での導入は次の 1 行で完了します出典。
curl -fsSL https://claude.ai/install.sh | bash
このインストーラ経由で入れた Claude Code は、起動時と起動中に定期的に新版をチェック し、見つかればバックグラウンドでダウンロードします。実際に新版が有効になるのは次回起動のタイミングで、手元のセッション中に挙動が変わって混乱する心配はありません。Apple Silicon / Intel Mac 双方に対応し、macOS 13.0(Ventura)以降が要件です。
claude update — 即時更新したいときの共通コマンド
バックグラウンドチェックを待たずに最新版を取りに行きたい場合は、ターミナルで次を実行します出典。
claude update
このコマンドはネイティブ・Homebrew・npm のいずれの経路でも動作する 共通の即時更新コマンド です。リリースノートの新機能をすぐ試したいとき、CI ジョブで明示的に固定したいときに使います。
Homebrew で更新する — brew upgrade と自動化フラグ
Homebrew 経由でインストールした場合、デフォルトでは自動更新が走りません。手動更新は次のコマンドで実行します出典。
# stable cask で入れた場合
brew upgrade claude-code
# latest cask で入れた場合
brew upgrade claude-code@latest
cask 名がインストール時の選択で変わる点に注意してください。stable は安定版チャネルで、latest は最新機能を即時取得するチャネルです。
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE で Homebrew を自動化
「brew でも自動更新が欲しい」という現場向けに、Anthropic は 環境フラグでの自動 upgrade を用意しています出典。settings.json に次を加えると、Claude Code 自身が定期的にバックグラウンドで brew upgrade を実行してくれます。
{
"CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "1"
}
ネイティブインストーラに切り替えずに「ほぼ自動」へ寄せたいチームはこのフラグを使うのが現実解です。なお Homebrew 本体の brew update は別物で、こちらは Formula のメタデータ更新を行うコマンドです。Claude Code を上げる目的なら upgrade が必要になります。
npm で更新する — sudo を避け latest を明示
Node.js 環境で npm install -g 経由で導入した場合の更新コマンドは次の通りです出典。
npm install -g @anthropic-ai/claude-code@latest
公式ドキュメントが明確に注意しているのが、npm update -g は最新版に進まないことがある という点です。npm の semver 解決の都合で最新パッチに留まりがちなため、必ず @latest を付けた npm install を使うのが正解です。
sudo npm install -g は厳禁
権限エラーが出たときに sudo を付けたくなりますが、Claude Code 公式ドキュメントは セキュリティと権限の観点で sudo npm install -g を禁止 しています出典。代わりに、Node.js の prefix を $HOME/.npm-global に切り替えるか、nvm でユーザー領域の Node に切り替えてからグローバルインストールするのが正攻法です。Mac で zsh をそのまま使っているなら、~/.zshrc に export PATH="$HOME/.npm-global/bin:$PATH" を追加して読み込み直すだけで通ります。
リリースチャンネル切替 — latest と stable の使い分け
ネイティブ経路では、autoUpdatesChannel 設定で更新のテンポを 2 段階で切り替えられます出典。
{
"autoUpdatesChannel": "stable"
}
選べる値は次の 2 つです。
latest(既定): リリース直後に新機能が降ってくる、開発者向けの攻めの設定。stable: 約 1 週間遅れて配信され、大きな回帰が見つかった版はスキップされる、運用向けの守りの設定。
新機能を早く試したい個人開発者は latest のまま、複数人で同じバージョンを使いたい受託案件・教育現場では stable に倒すのが基本方針です。/config のメニュー経由でも同じ切替が可能で、設定ファイルを触らずに済ませたい場合はこちらが手早いです。
更新後の確認手順 — claude --version と claude doctor
アップデートが反映されたか確認する正攻法は 2 段構えです出典。
claude --version
claude doctor
claude --version は現在動いている Claude Code のバージョン番号を返します。リリースノートの番号と一致すれば更新は成功です。claude doctor は依存ツール(ripgrep、Node、ログインセッション、通知許可など)の状態を一気に検査するコマンドで、更新後に挙動が変わって見えるときの一次切り分け に使います。
更新を反映するためにターミナルを開き直す必要があるかどうかは経路で変わります。ネイティブの場合は 次回 claude 起動から新版が動く ため、走行中のセッションを抜けて入り直してください。Homebrew / npm の手動更新では、コマンドが完了した瞬間から新版バイナリに切り替わります。
アップデートでよくあるトラブル — 権限・PATH・キャッシュ
Mac でのアップデートで実際に詰まりやすいポイントを 3 つだけ挙げます。
- 権限エラーで brew / npm が止まる:
~/Library配下や/usr/localの所有権が崩れているケースが多く、sudo chown -R $(whoami)で復旧します。Apple Silicon の Homebrew は/opt/homebrew配下なので、こちらも所有権を確認してください。 - 古い
claudeバイナリが PATH に残る:which claudeで複数経路が返るときは、brew list claude-codeとwhich -a claudeを見比べ、不要な方を削除してから入れ直すのが確実です。 - キャッシュが残ってバージョン番号が更新前のまま: ターミナル(zsh)の関数ハッシュキャッシュが古い場合があり、
hash -rで解消できます。それでも変わらない場合はターミナルを開き直してください。
claude doctor がこれらの多くを一気に検出してくれるため、まず claude doctor、次に PATH と所有権 の順で見ていくのが最短です。
Claude Desktop App for Mac の更新 — メニューと App Store
ターミナルの Claude Code とは別に、GUI 版の Claude Desktop App for Mac を使っている場合は更新経路が変わります。Anthropic 公式サイトから dmg をダウンロードしてインストールした版は、アプリのメニューバーから 「Claude」→「Check for Updates...」 を選ぶことで最新版チェックが走ります。
App Store 経由で導入した場合は App Store の「アップデート」タブ から更新します。App Store 配布版はサンドボックス制約で挙動が一部異なる点があり、開発者向けには公式サイト版が推奨される場面が多いです出典。
CLI 版と GUI 版でログインアカウントは共有されるため、片方で Pro / Max にサインインしておけばもう片方も自動で認証が引き継がれます。アップデートの単位はアプリ別である点だけ覚えておけば、Mac 上で 2 系統を混在させても運用に支障は出ません。
まとめ — Mac で Claude を最新に保つ判断軸
Mac での Claude アップデートは、ネイティブインストーラを選んだ瞬間に 9 割解決 します。バックグラウンド自動更新が標準で動き、autoUpdatesChannel で攻めと守りを切り替えるだけで運用が完結するためです。Homebrew や npm を選ぶ場合は、CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 や @latest 指定で「公式が想定する正攻法」に揃えるのが鉄則になります。
更新後の検証は claude --version と claude doctor の 2 段でほぼ十分です。「直ったように見えるが古いままだった」事故を避けるため、リリースノートのバージョン番号と手元の出力を必ず突き合わせてください。Mac での導入そのものは別記事 Claude Code Mac 入門 も合わせて参照すると、インストール → アップデートの一連の流れが揃います。
