Claude CodeをmacOS/Windowsで最初に設定する方法｜初心者向けセットアップガイド

読了後のゴール

このガイドを読み終わると、あなたは以下ができるようになります：

• Claude Code（クロード コード）とは何かを理解できる
• macOS/Windows環境でClaude Codeをセットアップできる
• VS Code（Visual Studio Code）とClaudeを正しく連携させられる
• 最初の簡単なコード生成タスクを実行できる
• つまずいたときの確認ポイントを自分で判断できる

前提条件

始める前に、以下の環境を用意してください。

必須

• Anthropic社のアカウント（https://console.anthropic.com で登録）
• APIキー（Dashboardから取得可能）
• インターネット接続

OS別の必須ツール

macOS向け：

1. VS Code（バージョン1.80以上）- https://code.visualstudio.com からダウンロード
2. Command Line Tools（ターミナルからコマンド実行するツール群）
3. 動作確認済みのmacOSバージョン：macOS 12.0以上

Windows向け：

1. VS Code（バージョン1.80以上）
2. Git for Windows（バージョン管理ツール）- https://git-scm.com/download/win からダウンロード
3. PowerShell 7以上（新しいコマンドシェル）

あると便利

• Node.js 16以上（JavaScriptで開発する場合）
• Python 3.8以上（Pythonで開発する場合）

セットアップ手順

ステップ1：Anthropic APIキーの取得（共通）

1. https://console.anthropic.com にアクセス
2. 画面右上の「Sign In」をクリック
3. メールアドレス＋パスワード、または外部サービス（GoogleやGitHub）で認証
4. ダッシュボード左メニューから「API Keys」を選択
5. 「Create Key」ボタンをクリック
6. キー名を入力（例：「Claude Code Local」）
7. 生成されたキー全体をコピーしておく（後で見られないため注意）

よくあるミス： キーをコピーしないまま画面を遷移すると、再度生成する必要があります。必ずコピーしてテキストエディタに一時保存しましょう。

ステップ2：VS Codeのインストール＆Claude Code拡張機能の追加

macOS向け

# Homebrewがある場合の最短インストール
brew install --cask visual-studio-code

Homebrewがない場合：

1. VS Code公式サイト（https://code.visualstudio.com）へアクセス
2. 「Download for Mac」をクリック
3. ダウンロードされた「Visual Studio Code.app」をApplicationsフォルダへドラッグ

Windows向け

1. https://code.visualstudio.com へアクセス
2. 「Download for Windows」をクリック
3. ダウンロードされた「VSCodeUserSetup-x64-xxx.exe」を実行
4. インストールウィザードで「同意して続行」を選択
5. デフォルト設定のまま進め「完了」をクリック

ステップ3：Claude Code拡張機能のインストール

VS Codeを起動した後：

1. 左サイドバーから「拡張機能」アイコン（正方形が4つ並んだマーク）をクリック
2. 検索ボックスに「Claude Code」と入力
3. Anthropic公式の拡張機能（発行者：Anthropic）を選択
4. 「インストール」ボタンをクリック
5. インストール完了後、VS Codeを再起動（Cmd+Q で終了後、再度起動）

確認ポイント： 再起動後、VS Codeのサイドバーに新しいアイコン（Claudeのロゴ）が表示されれば成功です。

ステップ4：APIキーの設定

VS Codeの左サイドバーから新たに表示されたClaudeアイコンをクリック：

1. 「Settings」または「設定」の歯車アイコンを選択
2. 「API Key」フィールドが表示される
3. ステップ1で保存したAPIキーを貼り付け
4. 「Save」（保存）をクリック

セキュリティ上の注意： APIキーは絶対にGitHubなどに公開リポジトリにアップロードしないでください。.gitignoreに設定ファイルを追加して保護しましょう。

ステップ5：簡単な動作確認

1. VS Codeで新しいファイルを作成（Cmd+N または Ctrl+N）
2. 例えば「hello.py」と名前をつけて保存
3. Claude Code画面で「Generate Code」ボタンをクリック
4. プロンプト入力欄に「Pythonで’Hello, Claude’と表示するコードを書いて」と入力
5. 送信後、数秒でコードが生成されることを確認

期待される出力例：

print("Hello, Claude")

うまくいかないときの確認ポイント

問題：拡張機能がインストールできない

確認すること：

1. VS Codeのバージョンが1.80以上か確認
   • VS Code内で Cmd+Shift+P / Ctrl+Shift+P を押し、「バージョン」と入力して確認
2. インターネット接続が安定しているか確認
3. VS Codeを完全に再起動してから再度インストール試行

問題：APIキーの設定後も認証エラーが出る

確認すること：

1. コピー＆ペースト時に余分なスペースが入っていないか確認（キーの前後のスペースを削除）
2. APIキーが有効期限切れでないか、console.anthropic.com で確認
3. VS Codeを再起動してから再度試す（設定がキャッシュされている可能性）

問題：生成されたコードがエラーになる

確認すること：

1. プロンプトに必要な情報（言語、ライブラリ、環境）が十分か確認
2. 「Pythonなら環境にXXXパッケージをインストール済み」など制約条件を追加
3. プロンプトを日本語から英語に変えて再試行（精度が高まることがあります）

問題：VS Codeが起動しない（Windows）

確認すること：

1. PowerShellを管理者権限で開き、VS Codeをアンインストール

   # VS Codeをアンインストール
   # コントロールパネル > プログラムと機能から「Visual Studio Code」を右クリック削除
   

2. 再度公式サイトからダウンロードしてインストール

次に読むと良い記事

• Claude Code実践ガイド： 実際のプロジェクトでコード生成を活用する方法
• APIの使い分け： Claude Code拡張機能とAPIの直接呼び出しの違い
• セキュリティ設定完全版： APIキー管理とローカル環境変数の設定
• Anthropic公式ドキュメント： https://docs.anthropic.com/quickstart