Claude Code を Homebrew からネイティブインストールに切り替えたら快適になった話
目次
brew upgrade claude-code を2台の Mac で実行したら、インストールされたバージョンが違う。Mac mini は 2.1.73、MacBook Pro は 2.1.74。同じコマンドなのに、なぜ？
この「あれ？」をきっかけに、Claude Code のインストール方法を Homebrew からネイティブインストールに切り替えました。結論から言うと、切り替えてよかったです。この記事では、なぜバージョンが食い違うのか、どうやって切り替えるのか、設定やデータは消えないのか、といった疑問をまとめて解消していきます。
なぜ Homebrew だとバージョンが食い違うのか
調べてみたところ、いくつかの要因が重なっているようです。
まず、Claude Code の Homebrew cask は stable リリースチャンネルを追う設計になっているそうです。stable チャンネルは latest より約1週間遅れで提供されるため、Anthropic が新しいバージョンをリリースしても、Homebrew 側の cask 定義に反映されるまでにはタイムラグがあるようです。さらに、Homebrew 4.0 以降は cask 定義を CDN 経由の JSON API から取得する仕組みに変わっており、CDN エッジノードやローカルキャッシュの鮮度の違いも影響するとのこと。そのため、2台の Mac でほぼ同時に brew upgrade を実行しても、取得される cask 定義が異なる、ということが起こり得るようです。
さらに、公式ドキュメントにはこう書かれています。
Homebrew installations do not auto-update. Run
brew upgrade claude-codeperiodically to get the latest features and security fixes. Known issue: Claude Code may notify you of updates before the new version is available in these package managers. If an upgrade fails, wait and try again later.
つまり Homebrew 版は自動更新されず、手動で brew upgrade を実行する必要があります。しかも、Claude Code 本体が「新しいバージョンがあります」と通知してきても、Homebrew 側にはまだ来ていない、というケースもあるわけです。複数台の Mac を使っていると、この食い違いが地味にストレスになります。
ネイティブインストールが推奨されている
公式ドキュメントでは、インストール方法として Native Install に「Recommended」のラベルが付いています。Homebrew や WinGet よりもネイティブインストールが推奨されているのは、自動更新が効くからです。
ネイティブインストール版は、起動時と実行中に定期的にバックグラウンドで更新を確認し、ダウンロード・インストールまで自動で行ってくれます。次回の起動時には新しいバージョンが反映されています。
複数台の Mac で作業していても、それぞれが勝手に最新版に追従してくれるので、「あっちは新しいのにこっちは古い」という状況が起きにくくなります。
切り替え手順
切り替えはとてもシンプルです。Homebrew 版をアンインストールして、ネイティブインストールを実行するだけ。
1. Homebrew 版を削除
brew uninstall --cask claude-code
2. npm グローバル版が入っていれば削除
過去に npm 経由でインストールしたことがある場合は、こちらも削除しておきます。
npm uninstall -g @anthropic-ai/claude-code
3. ネイティブインストールを実行
curl -fsSL https://claude.ai/install.sh | bash
4. 確認
claude --version
バージョンが表示されれば成功です。which -a claude も実行して、余計な別経路の claude が残っていないか確認しておくと安心です。
which -a claude
出力が ~/.local/bin/claude だけになっていれば、切り替えは完了です。
command not found になったら
claude --version で command not found が出た場合は、~/.local/bin が PATH に含まれていない可能性があります。以下のコマンドで確認できます。
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
何も出力されなければ、.zshrc に PATH を追加します。
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
もう一度 claude --version を実行して、バージョンが表示されれば OK です。
設定やデータは消えないの？
これが一番気になるところだと思います。結論から言うと、通常は消えません。
Claude Code の設定や状態は、実行ファイルとは別の場所に保存されています。
~/.claude/settings.json— ユーザー設定~/.claude.json— OAuth、テーマ、MCP サーバーなどのグローバル状態- プロジェクトごとの
.claude/や.mcp.json— プロジェクト固有の設定
brew uninstall --cask claude-code とネイティブインストールでは、これらのファイルには触れません。ログイン状態や許可設定、MCP サーバーの構成もそのまま残ります。
公式ドキュメントでも、設定をリセットしたい場合は ~/.claude や ~/.claude.json を 明示的に削除する よう案内されています。逆に言えば、削除しなければ消えないということです。
念のためバックアップしたい場合
心配な方は、切り替え前にバックアップを取っておくと安心です。
# グローバル設定のバックアップ
mkdir -p ~/claude-backup-$(date +%Y%m%d)
cp -R ~/.claude ~/.claude.json ~/claude-backup-$(date +%Y%m%d) 2>/dev/null
# プロジェクトごとの設定のバックアップ（プロジェクトディレクトリで実行）
cp -R .claude .mcp.json ~/claude-backup-$(date +%Y%m%d)/ 2>/dev/null
ネイティブ版のアップデート方法
ネイティブインストール版は基本的に自動更新です。起動時と実行中に定期的に更新を確認し、バックグラウンドでダウンロード・インストールが行われます。次回起動時に反映されるので、普段は何もする必要がありません。
今すぐ手動で更新したいとき
claude update
リリースチャンネルの切り替え
リリースチャンネルを設定することで、更新の受け取り方を変えられます。
"latest"（デフォルト）— 新機能をリリース直後に受け取る"stable"— 通常約1週間遅れの安定版を受け取る
設定するには、Claude Code 内で /config から Auto-update channel を選ぶか、settings.json に直接書きます。
{
"autoUpdatesChannel": "stable"
}
安定重視なら "stable" がおすすめです。
自動更新を止めたい場合
settings.json の env にこう書きます。
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
更新後の確認
claude --version
claude doctor
claude doctor は設定や状態の詳しい確認に使えるコマンドです。何か挙動がおかしいときにも役立ちます。
まとめ
Homebrew 版の Claude Code は手軽にインストールできますが、自動更新が効かないため、複数台で使っていると手動更新のタイミング次第でバージョンが食い違うことがあります。
ネイティブインストールに切り替えれば、バックグラウンドで自動更新されるため、この問題はかなり起きにくくなります（更新は次回起動時に反映されるので、再起動タイミングの差で一時的にズレることはあり得ます）。
- 切り替えは簡単 —
brew uninstall→curlで再インストール → 確認、の3ステップ - 設定やデータは消えない — 設定ファイルは実行ファイルとは別の場所に保存されている
- 自動更新が効く — バックグラウンドで更新されるので、常に最新版が使える
- リリースチャンネルで更新頻度を調整可能 — 安定重視なら
"stable"を選べる
公式が推奨しているのもネイティブインストールなので、まだ Homebrew で使っている方は、このタイミングで切り替えてみてはいかがでしょうか。
