Claude Code「command not found」エラーの解決方法【macOS・Windows・WSL完全対応】

症状の確認

# インストールしたはずなのに...
claude

# エラー:
# zsh: command not found: claude
# または
# bash: claude: command not found

Claude Code（CLI）は npm install -g @anthropic-ai/claude-code または brew install でインストールしますが、インストール後に command not found になるケースが頻繁に起きます。

原因の診断

# Step 1: インストールされているか確認
npm list -g @anthropic-ai/claude-code

# インストール済みの例:
# /usr/local/lib
# └── @anthropic-ai/claude-code@1.x.x

# Step 2: npmのグローバルバイナリがどこにあるか確認
npm bin -g
# 例: /usr/local/bin（macOS） または ~/.npm-global/bin（一部の設定）

# Step 3: 現在のPATHを確認
echo $PATH

# Step 4: claudeコマンドの場所を確認
which claude  # 見つかれば場所が表示される

解決方法：macOS（zsh）

# npmのグローバルパスを確認
NPM_BIN=$(npm bin -g)
echo $NPM_BIN
# 例: /opt/homebrew/bin  または  /Users/user/.npm-global/bin

# .zshrcに追記（まだPATHになければ）
echo 'export PATH="'$NPM_BIN':$PATH"' >> ~/.zshrc

# 設定を反映
source ~/.zshrc

# 確認
which claude
# /opt/homebrew/bin/claude（またはnpmのパス）

claude --version
# Claude Code 1.x.x

解決方法：Homebrew経由でインストール（推奨・最も簡単）

# npmを使わずにHomebrewで直接インストール
brew install anthropic/tap/claude

# 確認
claude --version

# Homebrewはパスを自動で通すため「command not found」になりにくい

解決方法：Windows（PowerShell）

# npmのグローバルバイナリパスを確認
npm bin -g
# 例: C:\Users\user\AppData\Roaming\npm

# PowerShellのProfileにPATHを追記
notepad $PROFILE  # Profileを開く（なければ作成）

# 以下の行を追記して保存:
$env:PATH += ";$(npm bin -g)"

# または永続的に設定:
[System.Environment]::SetEnvironmentVariable(
    "PATH",
    [System.Environment]::GetEnvironmentVariable("PATH", "User") + ";$(npm bin -g)",
    "User"
)

# PowerShellを再起動してから確認
claude --version

# Scoopを使う場合（npmが不要、PATH設定も自動）
scoop bucket add extras
scoop install claude

解決方法：WSL（Windows Subsystem for Linux）

# WSL内でnpmをLinux向けにインストール
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Claude Codeをインストール
npm install -g @anthropic-ai/claude-code

# WSLのPATH確認・修正
which claude || echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 確認
claude --version

VS Code拡張機能が見つからない場合

VS Codeの拡張機能は「Claude Code CLI」とは別物です。

拡張機能マーケットプレイスでの検索:
  Publisher: Anthropic
  Extension ID: Anthropic.claude-code

または、CLIが使える状態なら VS Code内ターミナルで:

# CLIをインストール後、VS Code拡張機能をCLI経由で確認
claude ext install  # VS Code拡張機能の確認コマンド（CLIが必要）

インストール後の動作確認

# バージョン確認
claude --version

# APIキーを設定（最初の1回だけ）
claude config set apiKey sk-ant-...

# または環境変数で設定（推奨：.envに書いてシェルに読み込む）
export ANTHROPIC_API_KEY=sk-ant-...

# 動作確認（最初のコマンド）
claude "Hello, world! と出力するPythonコードを書いて"

# プロジェクトディレクトリで使う
cd /path/to/your/project
claude "このプロジェクトの構造を説明して"

あわせて読みたい

• Claude Code初心者向けセットアップ｜macOS/Windows手順と動作確認
• Claude Code「Connection timeout」エラーの原因と解決方法
• Claude Code「403 Forbidden」エラーの原因と対処法