目次
概要
Claude CodeをHomebrew（brew）でインストールした場合、Homebrew caskパッケージはデフォルトで自動アップデートされません。新機能やセキュリティアップデートを適用するには、手動でアップデートコマンドを実行する必要があります。
この記事では、手動アップデート方法、自動アップデート設定、そしてネイティブインストールへの切り替え方法を紹介します。
Claude Codeのインストール方法と基本的な使い方はClaude Code 基礎知識と基本的な使い方をご覧ください。
現在のバージョン確認
アップデート前に、現在インストールされているバージョンを確認します。
claude --versionアップデート可能なパッケージがあるか確認するには、brew outdatedを使用します。
brew outdated --caskclaude-codeがリストに表示されれば、新しいバージョンが利用可能です。
手動アップデート
Homebrewのformula情報を最新に更新してから、Claude Codeをアップグレードします。
brew update && brew upgrade --cask claude-codebrew update: Homebrew自体とformula/cask情報を最新に更新します。brew upgrade --cask claude-code: Claude Code caskを最新バージョンにアップグレードします。
brew upgrade claude-codeだけでも最新のHomebrewではcaskを自動認識しますが、--caskフラグを明示する方がより明確です。
自動アップデート設定
毎回手動でアップデートするのが面倒な場合、homebrew-autoupdateを使ってバックグラウンドで自動アップデートされるように設定できます。
homebrew-autoupdateのインストール
brew tap homebrew/autoupdate自動アップデートの開始
brew autoupdate start --upgrade --cleanupstart: macOSのlaunchdを使って定期的にbrew updateを実行するようスケジューリングします。--upgrade:brew updateの後、自動的にbrew upgradeも実行してパッケージを最新バージョンにアップグレードします。--cleanup: アップグレード後、古いバージョンのキャッシュを自動的にクリーンアップします。
デフォルトの間隔は**24時間（86400秒）**です。間隔を変更したい場合は秒単位で指定します。
# 12時間ごとに自動アップデート
brew autoupdate start 43200 --upgrade --cleanup設定の確認と管理
# 現在の自動アップデート状態を確認
brew autoupdate status
# 自動アップデートを停止
brew autoupdate stop
# 自動アップデートを削除（スケジュール削除）
brew autoupdate deleteこの設定はClaude Codeだけでなく、Homebrewでインストールしたすべてのパッケージに適用されます。特定のパッケージをアップデート対象から除外したい場合は
brew pin <package>を使用します。
ネイティブインストールへの切り替え
Homebrewの代わりにネイティブインストールスクリプトを使用すると、Claude Codeは起動時に自動的にアップデートを確認します。ネイティブの自動アップデートの方が安定性が高いため、アップデート管理が面倒な場合はネイティブインストールへの切り替えを推奨します。
1. Homebrewバージョンをアンインストール
brew uninstall --cask claude-code2. ネイティブインストールスクリプトを実行
curl -fsSL https://claude.ai/install.sh | bash3. インストールの確認
claude --versionHomebrewからネイティブインストールに切り替える際、Claude Code内で/migrate-installerコマンドを使用すると、既存の設定を維持したままインストール方式を切り替えることができます。
claude
# Claude Code内で
> /migrate-installerトラブルシューティング
Auto-update failedメッセージ
Claude Code起動時にAuto-update failedメッセージが表示される場合、ほとんどがファイルシステムの権限問題です。
# Homebrewディレクトリの権限を修正
sudo chown -R $(whoami) $(brew --prefix)/*
# またはHomebrewを再インストールしてClaude Codeを再インストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install --cask claude-codeそれでも解決しない場合は、ネイティブインストールへの切り替えを推奨します。
Homebrewキャッシュの問題
アップグレードに失敗する場合、キャッシュをクリーンアップしてから再試行します。
brew cleanup
brew update
brew upgrade --cask claude-codeまとめ
Homebrewでインストールしたクロードコードのアップデート方法について紹介しました。手動アップデート、自動アップデート設定、ネイティブインストールへの切り替えまで紹介しましたので、ご自身の環境に合った方法を選んで、常に最新バージョンのClaude Codeをお使いください。
私のブログが役に立ちましたか？下にコメントを残してください。それは私にとって大きな大きな力になります！
アプリ広報
Dekuが開発したアプリを使ってみてください。Dekuが開発したアプリはFlutterで開発されています。興味がある方はアプリをダウンロードしてアプリを使ってくれると本当に助かります。
