Claude Code を macOS にインストールする完全ガイド：Homebrew、Git、PATH、環境変数、よくあるエラーまで解説
macOS で Claude Code を入れるとき、実は一番つまずきやすいのは「インストールコマンド」そのものではありません。
むしろ次のような問題の方がよく起きます。
- npm は成功したのに
claudeコマンドが見つからない - Git が入っていない、あるいはシェルから認識されない
- PATH が正しく設定されていない
- 環境変数が今のターミナルでは見えるのに、新しいウィンドウでは消える
- Apple Silicon と Intel で Homebrew のパスが違って混乱する
この記事では、macOS で Claude Code を 実際に使える状態にするまで を順番に整理して解説します。
Claude Code を使う前に必要なもの
Claude Code は単体のツールというより、次のような環境の上で動きます。
- ターミナル
- Homebrew
- Git
- Node.js / npm
- Claude Code
- PATH
- 環境変数
- Git 管理されたテスト用プロジェクト
このどこかが欠けていると、「入ったはずなのに動かない」という状態になりやすいです。
Step 1: Apple Silicon か Intel か確認する
まずアーキテクチャを確認します。
uname -m
一般的には次のどちらかです。
-
arm64→ Apple Silicon -
x86_64→ Intel
これは Homebrew のパスに関係します。
- Apple Silicon:
/opt/homebrew - Intel:
/usr/local
PATH トラブルを追うときに重要です。
Step 2: 今使っているシェルを確認する
echo $SHELL
最近の macOS なら zsh であることが多いです。
zsh の場合、主に確認するのは次のファイルです。
~/.zshrc~/.zprofile
PATH や環境変数はこのあたりで読み込まれます。
Step 3: Homebrew を入れる
まず Homebrew があるか確認します。
brew --version
なければインストールします。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
インストール後、Homebrew をシェルに読み込ませます。
Apple Silicon の場合
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
Intel の場合
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"
確認：
which brew
brew --version
Step 4: Git を入れる
確認：
git --version
入っていなければ Homebrew で入れます。
brew install git
確認：
which git
git --version
必要ならテスト用のリポジトリも作ります。
mkdir -p ~/Projects/claude-code-test
cd ~/Projects/claude-code-test
git init
Step 5: Node.js と npm を入れる
Claude Code は npm 経由でインストールするケースが多いため、Node.js と npm が正常に使える必要があります。
確認：
node --version
npm --version
未インストールなら Homebrew で入れます。
brew install node
確認：
node --version
npm --version
which node
which npm
Step 6: Claude Code をインストールする
まず既にインストール済みか確認します。
which claude
claude --version
なければインストールします。
npm install -g @anthropic-ai/claude-code
再確認：
which claude
claude --version
Step 7: claude が見つからないときは PATH を確認する
macOS でよくあるのは次のエラーです。
zsh: command not found: claude
この場合、まず npm の global prefix を確認します。
npm config get prefix
その中の bin を見ます。
ls "$(npm config get prefix)/bin"
もしそこに claude があるなら、PATH に追加します。
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
確認：
which claude
claude --version
Step 8: 環境変数を設定する
利用するワークフローによっては、次のような変数を使うことがあります。
export ANTHROPIC_API_KEY="your_key_here"
export OPENAI_API_KEY="your_gateway_key"
export OPENAI_BASE_URL="https://crazyrouter.com/v1"
ただし、このままだと現在のターミナルだけ有効です。
永続化するなら ~/.zshrc に書き込みます。
echo 'export ANTHROPIC_API_KEY="your_key_here"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="your_gateway_key"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://crazyrouter.com/v1"' >> ~/.zshrc
source ~/.zshrc
確認用コマンド一覧
git --version
node --version
npm --version
claude --version
echo $SHELL
git status || true
これらが問題なく動くなら、Claude Code を使うための基本環境はかなり整っています。
よくあるエラー 5 選
1. claude が見つからない
多くの場合、npm の global bin が PATH に入っていません。
2. Git が見つからない
Git が未インストール、もしくはターミナルが新しい PATH を読み込んでいない可能性があります。
3. Node.js / npm が不安定
古い Node.js が残っていたり、複数の管理方法が混在していることがあります。
4. 環境変数が新しいターミナルで消える
一時的に export しただけで、~/.zshrc に保存していない可能性があります。
5. Homebrew はあるのに別ウィンドウで使えない
~/.zprofile や ~/.zshrc への設定が正しく入っていないことがあります。
まとめ
macOS で Claude Code を安定して使いたいなら、次の順番で整えるのが一番わかりやすいです。
- Homebrew
- Git
- Node.js / npm
- Claude Code
- PATH
- 環境変数
- Git リポジトリでテスト
この順番で進めれば、「インストールはできたのに使えない」という問題をかなり減らせます。