Mac版Claude Codeのネイティブ導入とHomebrew設定

結論

最初にやること：OSのターミナルでcurl -fsSL https://claude.ai/install.sh | bashを実行します。

macOSでは公式ネイティブインストーラーが推奨され、npmのグローバルパス変更は通常不要です。

Homebrewを利用する場合はstable系のclaude-code caskを選べます。

対応要件はmacOS 13以降で、Apple SiliconとIntelの両方を利用できます。

実行場所：OSのターミナルで実行します。

# 推奨ネイティブ版
# ターミナルで実行：公式インストーラーを取得して実行
curl -fsSL https://claude.ai/install.sh | bash
# Homebrewを使う場合
# ターミナルで実行：Homebrewでインストール
brew install --cask claude-code
# ターミナルで実行：Claude Codeのバージョンを確認
claude --version
# ターミナルで実行：インストールと設定を読み取り専用で診断
claude doctor

具体的な手順

1. ターミナルで公式インストーラーまたはHomebrewの一方を選び、重複導入を避けます。

2. claude auth loginで認証し、作業リポジトリからclaudeを起動します。

3. /initと/permissionsでプロジェクトメモリと安全ルールを設定します。

ネイティブ版はバックグラウンド更新に対応し、Homebrew版はbrew upgrade claude-codeで更新します。

GUIを希望する場合はClaude DesktopのCodeタブやVS Code公式拡張も利用できます。

実践プロンプト

Mac固有の依存関係を変更前に診断させます。

入力場所：Claude Codeの対話画面へ貼り付けます。

このmacOS環境を変更せずに診断
確認:
- CPUアーキテクチャ
- macOSバージョン
- Claude Codeの導入経路
- PATHの重複
- Gitと開発ツールの不足
重複インストールがある場合は削除前に候補を報告

注意点

• sudo npm install -gを前提にせず、ネイティブ版で権限問題を回避します。

• Homebrew版とネイティブ版が同時にPATHへ存在すると更新元が混乱するため、which -a claudeで確認します。

• 古いnpm版を残す場合はNode.js 22以上の要件と更新権限を確認します。