Claude Codeセットアップ完全ガイド【macOS/Windows/WSL】インストールから最初の動作確認まで

Claude Codeとは

Claude Code は Anthropic が提供するターミナルベースのAIコーディングエージェントです。

一般的なAIチャット:
  ユーザー → ChatGPT/Claude.ai → コードをコピペ → 自分でエディタに貼り付け

Claude Code:
  ユーザー → ターミナルで「claude '〇〇を実装して'」
  → Claude がファイルを読み・書き・テストを実行 → 自律的に完成

macOSへのインストール

方法A：Homebrew（推奨・最もシンプル）

# Homebrewをインストール（まだの場合）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Claude Codeをインストール（Node.js不要・PATH自動設定）
brew install anthropic/tap/claude

# インストール確認
claude --version
# Claude Code x.x.x

方法B：npm（Node.jsが既にある場合）

# Node.js 18以上が必要（確認）
node --version

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

# PATHが通らない場合はこれを.zshrcに追記
echo 'export PATH="$(npm bin -g):$PATH"' >> ~/.zshrc
source ~/.zshrc

# 確認
which claude
claude --version

Windowsへのインストール

方法A：Scoop（推奨・管理者権限不要）

# Scoopのインストール（初回のみ）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# Claude Codeをインストール
scoop bucket add extras
scoop install claude

# 確認
claude --version

方法B：npm（PowerShell管理者で実行）

# Node.js 18以上が必要（winget でインストール可能）
winget install OpenJS.NodeJS

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

# PATH設定（PowerShellに永続的に追加）
$npmBin = npm bin -g
[Environment]::SetEnvironmentVariable(
    "PATH",
    [Environment]::GetEnvironmentVariable("PATH", "User") + ";$npmBin",
    "User"
)

# ターミナルを再起動してから確認
claude --version

WSL（Windows Subsystem for Linux）経由

# WSL2をセットアップ済みであること（PowerShellで: wsl --install）
# WSL内のターミナルで：

# Node.js 20をインストール
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

# PATHに追加
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

claude --version

APIキーの設定

# 方法1：環境変数（推奨）
# APIキーは console.anthropic.com → API Keys で取得
export ANTHROPIC_API_KEY=sk-ant-api03-...

# .zshrc/.bashrcに追記して永続化（.envファイルには書かないこと）
echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc
source ~/.zshrc

# 方法2：Claude Codeのconfig設定
claude config set apiKey sk-ant-api03-...

動作確認

# プロジェクトディレクトリに移動
cd ~/projects/my-project

# 最初のコマンド（対話モード）
claude "このプロジェクトの構造を説明して"

# 非対話モード（スクリプト用）
claude --print "src/以下のファイル一覧を表示して" 

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

VS Code拡張機能の追加（オプション）

CLIインストール後、VS Codeとの統合を追加できます。

# VS Code拡張機能マーケットプレイスでインストール
# 拡張機能パネル → 「Anthropic.claude-code」を検索 → インストール

# またはコマンドパレット（Cmd+Shift+P / Ctrl+Shift+P）で:
# "Extensions: Install Extensions" → "Claude Code" を検索

# CLIが使えるなら拡張機能のインストール確認もCLIから
code --install-extension Anthropic.claude-code

よくあるエラーと解決方法

# エラー: command not found: claude
which claude || echo "PATHに追加が必要"
npm bin -g  # npmバイナリのパスを確認して.zshrcに追記

# エラー: ANTHROPIC_API_KEY is not set
echo $ANTHROPIC_API_KEY  # 空なら設定されていない

# エラー: Invalid API key
# console.anthropic.com でキーの有効期限・スコープを確認

# エラー: rate limit exceeded
# APIの利用制限に達した。1分待ってから再試行
# または claude config set model claude-haiku-4-5-20251001 で軽量モデルに変更

あわせて読みたい

• Claude Code「command not found」エラーの解決方法
• Claude Codeのリモート実行時にローカルから権限承認する方法
• Claude Code「Connection timeout」エラーの原因と解決方法