【結論】macOSはネイティブ版かHomebrew caskで導入する
macOSではNode.jsとnpmを先に入れる必要はなく、公式ネイティブインストーラーが推奨されています。
自動更新を使いたい場合は公式スクリプト、Homebrewで管理したい場合は「brew install --cask claude-code」を選びます。
sudo付きnpmグローバルインストールは権限事故の原因になるため、新規導入では避けてください。
# 推奨ネイティブインストール
curl -fsSL https://claude.ai/install.sh | bash
# 確認
claude --version
claude doctor
claude
具体的な手順・設定方法
-
ターミナルを開いてネイティブインストーラーを実行します。
完了後に新しいターミナルを開き、バージョンと診断結果を確認してください。
-
Homebrew管理を選ぶ場合はcaskを使います。
stableチャンネルは最新より少し遅れる場合があり、自動更新されないため手動でupgradeします。
brew install --cask claude-code brew upgrade claude-code -
プロジェクトへ移動して起動し、ブラウザで認証します。
初回はGit差分を確認できる状態にしてから編集を依頼してください。
cd ~/Projects/my-app git status --short claude
実践プロンプト / 活用テクニック
macOS固有の操作を依頼するときは、IntelかApple Siliconか、Homebrewの場所、使用シェルをClaudeに確認させると安全です。
このMacのCPU種別、macOSバージョン、現在のシェル、Homebrewの有無を読み取り専用で確認してください。
不足ツールがあってもまだインストールしないでください。
このプロジェクトの起動に必要なものだけを一覧化し、各コマンドの目的と影響範囲を説明してください。
私が承認した項目だけを順番に実行してください。
注意点・よくあるエラーと対処法
-
「EACCES」が出たからといってsudoでnpm導入を繰り返さないでください。
ネイティブ版へ切り替えるか、古いnpm版を整理してから再インストールします。
claude install stable -
Homebrew版は自動更新されません。
新機能が見当たらない場合は「brew upgrade claude-code」を実行し、バージョンを確認してください。
brew upgrade claude-code claude --version