【2026年最新】WindowsでClaude Codeを動かす完全セットアップガイド

Windows PC しかない環境でも、Claude Code さえ使えば AI 駆動開発がフルに活用できます。本記事では、WSL・Git Bash 両対応のセットアップ手順から認証方法、実行例、よくあるエラー対処、そして利用上の注意点まで、2026年3月時点の最新情報で順を追って解説します。

[目次を開く]

1. Claude Code とは？入手方法と公式リソース 2. Windows 上でのセットアップ手順（Node.js・npm・シェル環境） Step 1: Node.js および npm のインストール Step 2: シェル環境の準備 (WSL または Git Bash) Step 3: Claude Code CLI のインストール Step 4: プロジェクトディレクトリへの移動 Step 5: CLI の起動 3. API キーの取得と認証方法 4. 実行例：CLI コマンドの使用方法と結果インタラクティブな質問応答ワンライナーでのコマンド実行コード生成・リファクタリング・テスト生成 5. よくあるエラーと対処法 6. Claude Code Hooks によるセキュリティ強化（応用） Hook の種類設定方法（~/.claude/settings.json） .env ファイルの保護（重要） 7. よくある質問（FAQ） 8. ライセンスや利用上の注意事項

1. Claude Code とは？入手方法と公式リソース

Claude Code は Anthropic が提供する公式 CLI ツールで、ターミナルから Claude を利用できるようにするものです。コードベースの理解・生成・編集などを自然言語コマンドで行える AI コーディングアシスタントとして設計されており、現在は Windows にも正式対応しています。

入手方法: Claude Code は npm 経由で配布されています。Node.js 環境が整ったら、以下のコマンドでグローバルインストールできます。

npm install -g @anthropic-ai/claude-code

インストール後は claude コマンドがパスに追加され、ターミナルから直接 Claude を操作できます。

公式リソース: Anthropic は Claude Code の詳細なドキュメントを公開しています。セットアップ手順・CLI コマンド一覧・設定方法はもちろん、トラブルシューティングガイドや最新の変更点を確認できる CHANGELOG も用意されています。自動アップデート機能も備わっているため、常に最新バージョンが維持されます。

📝 補足: Claude Code は当初 Mac/Linux のみ対応でしたが、現在は Windows への正式サポートが安定稼働しています。WSL 経由と Git Bash 経由の2つの方法があり、どちらも公式にサポートされています。

2. Windows 上でのセットアップ手順（Node.js・npm・シェル環境）

Windows で Claude Code CLI を使うには、Node.js 18 以上の実行環境と、Linux 互換のシェル環境が必要です。

Step 1: Node.js および npm のインストール

Claude Code は Node.js 製の CLI ツールです。Node.js (version 18 以降) が必要です。公式サイトや Node Version Manager (nvm) を使って導入してください。インストール後、バージョンを確認します（npm は Node.js に同梱）:

node -v && npm -v

Step 2: シェル環境の準備 (WSL または Git Bash)

Claude Code は UNIX 系シェルで動作するよう設計されており、Windows ネイティブのコマンドプロンプトや PowerShell では動作しません。以下のどちらかを使いましょう。

方法 A: WSL を使用する — WSL2 上に Ubuntu 等の Linux ディストロをインストールし、その Linux ターミナル内で Claude Code を実行します。管理者権限の PowerShell から wsl --install 一発で有効化できます。
方法 B: Git Bash を使用する — Git for Windows をインストールすると使える Git Bash 上で動かす方法です。ポータブル版を使う場合は環境変数 CLAUDE_CODE_GIT_BASH_PATH で bash.exe のパスを指定します。

🔍 参考: Anthropic 公式ドキュメントでも「Option 1: WSL 経由」または「Option 2: Git Bash 経由」のどちらかを推奨しています。用途に合わせて選択してください。

Step 3: Claude Code CLI のインストール

適切なシェルが準備できたら、npm グローバルインストールを実行します。

npm install -g @anthropic-ai/claude-code

インストール成功後、バージョン確認をしてみましょう:

claude --version

バージョン情報が表示されれば OK です。command not found となる場合はパスが通っていない可能性があるため、シェルを再起動するか、インストールログを確認してください。

⚠️ 注意: インストール時に sudo は使わないでください。sudo npm install -g は権限問題やセキュリティリスクにつながります。権限エラーが出る場合は「5. よくあるエラーと対処法」を参照してください。

Step 4: プロジェクトディレクトリへの移動

Claude Code は現在のディレクトリをワークスペースとして扱います。CLI を起動する前に、作業したいプロジェクトのフォルダに移動しておきましょう。

# WSL/Linux 環境の場合
cd /mnt/c/path/to/your-project

Step 5: CLI の起動

準備が整ったら CLI を起動します。

対話モード: claude と入力するだけで、プロンプトが表示され会話形式で利用できます。
ワンショット実行: --print（または -p）フラグで一度きりの応答を得られます。

claude -p "Hello, Claude! 今日は調子はどう？"

パイプでファイル内容を渡すことも可能です（例: cat foo.txt | claude -p "次の内容を要約して"）。

✅ この段階で、Windows 上に Claude Code CLI をインストール・起動する環境が整いました。

3. API キーの取得と認証方法

Claude Code を利用するには、Anthropic の API アクセス権限が必要です。主に2つの認証方法があります。

認証方法の選び方

方法	向いている人
Anthropic Console（API キー方式）	個人開発者・従量課金で使いたい人
Claude.ai Pro/Max プラン	すでにサブスク加入済みで定額内で使いたい人

API キー方式の設定手順:

Anthropic Console でアカウント登録 — 開発者向けサイト（Anthropic Console）でアカウントを作成し、ダッシュボードから API キーを発行します。
環境変数に登録 — 発行した API キーを ANTHROPIC_API_KEY に格納します。

echo "export ANTHROPIC_API_KEY=<取得した API キー>" >> ~/.bashrc
source ~/.bashrc

認証確認 — claude コマンドを実行し、初回起動時のプロンプトで「Use API key」を選択するか、環境変数が設定されていれば自動的に認証されます。

ℹ️ メモ: 環境変数に有効なキーがあれば、起動のたびにブラウザで OAuth 認証する手間が省けます。

利用料金について: API 利用はリクエストしたトークン数に応じた従量課金です。CLI 内の /cost コマンドで現在のコストを確認したり、Anthropic Console で予算アラートを設定すると安心です。

4. 実行例：CLI コマンドの使用方法と結果

実際にどう使うか、典型的なコマンド例をいくつか紹介します。

インタラクティブな質問応答

claude と入力して Enter を押すと対話モードがスタートします。

> ユーザー: このリポジトリの全体構成を要約してください。
AI: 現在のプロジェクトは以下のような構成になっています。
1. src/ ディレクトリ - アプリケーションのソースコードが含まれています。
2. src/api.js - データ取得用の関数 fetchData() が定義されています。
...

追加の質問や指示を続けて入力することで、会話の文脈を保ったままやり取りできます。

ワンライナーでのコマンド実行

claude -p "utils/api.js 内の fetchData() 関数が何をするか説明してください。"

-p を付けた場合は対話セッションを開始せず一度だけ応答するため、スクリプトからの呼び出しにも便利です。

💡 ヒント: --output-format json フラグを付けると、Claude の応答を JSON 構造で受け取ることもできます。

コード生成・リファクタリング・テスト生成

# コード自動生成
claude -p "与えられた JSON データを読み込み CSV に変換する Python スクリプトを書いて"

# リファクタリング
claude -p "src/app.ts の中でコールバックを使っている部分を async/await に書き換えて"

# ユニットテスト生成
claude -p "ユーザー入力を検証する関数 validateInput の単体テストを Jest で作成して"

Claude Code はリポジトリ内のコンテキストを考慮しながら高度なコード操作を行ってくれます。対話モードではさらに細かい指示や修正依頼も可能です。

5. よくあるエラーと対処法

セットアップや利用時に遭遇しがちなエラーと対処方法をまとめます。

「Claude Code is not supported on Windows.」と表示される
原因: Windows ネイティブ環境（コマンドプロンプト / PowerShell）でインストール・実行しようとしている可能性があります。

対処: WSL 上の Linux か Git Bash 経由で実行してください。コマンドプロンプトや PowerShell 単体では動作しません。
「EACCES: permission denied」権限エラー
原因: npm install -g で管理者権限がなく書き込めない、または誤って sudo を使った場合に発生します。

対処: sudo を絶対に使わないでください。代わりに以下の手順でグローバルディレクトリをユーザ権限の場所に変更します。
1. npm config set prefix ~/.npm-global でインストール先を変更
2. export PATH=~/.npm-global/bin:$PATH を .bashrc に追記して反映
3. 再度 npm install -g @anthropic-ai/claude-code を実行
あるいは claude migrate-installer コマンドでローカルインストール方式に切り替える方法もあります。
exec: node: not found と表示される
原因: WSL 内で Linux 用 Node.js が認識されていない状態です。which node が /mnt/c/...（Windows 側のパス）になっているケースが多いです。

対処: WSL 上で apt または nvm を使い、Linux 用 Node.js をインストールし直してください。which node で /usr/bin/node 等 Linux 側のパスが表示されれば OK です。
WSL で npm install 時に OS チェックに失敗する
原因: npm が Windows 用として動作しており、OS 要件チェックが誤検知しています。

対処: インストール前に npm config set os linux を実行し、以下のコマンドでインストールします。
```
npm install -g @anthropic-ai/claude-code --force --no-os-check
```
その他: 初回起動時にブラウザ認証がうまくいかない場合は、環境変数に正しい API キーがセットされているか再確認してください。

6. Claude Code Hooks によるセキュリティ強化（応用）

Claude Code には Hooks 機能があり、ツール実行の前後に任意のシェルスクリプトを割り込ませることができます。Windows + WSL 環境でも同様に利用可能です。

Hook の種類

Hook タイプ	タイミング	主な用途
PreToolUse	ツール実行前	危険なコマンドのブロック・承認要求
PostToolUse	ツール実行後	ログ記録・通知送信
PreCompact	コンテキスト圧縮前	重要情報の保護
Notification	通知発生時	Slack 等への転送
Stop	セッション終了時	クリーンアップ処理

設定方法（`~/.claude/settings.json`）

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/check-dangerous-commands.sh"
          }
        ]
      }
    ]
  }
}

.env ファイルの保護（重要）

Claude Code が .env ファイルを誤って読み取るリスクを防ぐには、PreToolUse Hook で .env 系ファイルへのアクセスをインターセプトするのが最も確実です。settings.json の denyList だけでは防ぎきれないケースがあるため、Hook による多重防御を推奨します。

💡 Hook の詳細は「Claude Code Hooks によるセキュリティ設計」も参照してください。

7. よくある質問（FAQ）

Q. Claude Code は Windows ネイティブで動きますか？

A. PowerShell / コマンドプロンプト単体では動作しません。WSL 上の Linux 環境か Git Bash 経由で実行してください。

Q. WSL と Git Bash どちらがおすすめ？

A. 開発用途なら WSL 推奨です。Linux のネイティブ環境に近いため、Docker との連携や Node.js の動作も安定します。Git Bash は軽量に試したい場合に向いています。

Q. Claude Code のレート制限はありますか？

A. あります。claude.ai の Pro / Max プランと API キー方式の両方でレート制限が適用されます。上限に達した場合はしばらく待つか、プランのアップグレードを検討してください。同一の Anthropic アカウントでレートは共有されます。

Q. プロジェクトの機密コードを渡しても大丈夫？

A. デフォルトでは入力内容が Anthropic のサーバに送信されます。機密性が高い場合は企業向けの Zero Data Retention（ZDR）契約を検討するか、送信前に機密部分を除外するのがおすすめです。

Q. Windows の WSL で node: not found になります

A. WSL 内で改めて Linux 用の Node.js をインストールしてください（nvm 経由が便利）。Windows 側の Node.js は WSL から見えないことがあります。which node で /usr/bin/node などが表示されれば OK です。

8. ライセンスや利用上の注意事項

Claude Code を利用するにあたり、ライセンスと利用制限についても把握しておくと良いと考えています。

ライセンス: Claude Code は Anthropic の商用ライセンス下で提供されています。オープンソースではなく、改変・再配布には制限があります。Anthropic の利用規約に従って使用するものであり、ソフトウェア自体の再利用・再販は許可されていません。
利用制限: 違法行為への利用や他者のプライバシーを侵害するような用途は禁止されています。また、機密情報を含むコードベースを扱う際は、そのデータが Anthropic のクラウドに送信されることを念頭に置いてください。
データの取り扱い: Anthropic は利用データを一部収集しますが、モデルの再学習には使用しない方針を明言しています。ログは最大30日間保存後に削除されます。機密性が求められる企業利用では、Zero Data Retention（ZDR）契約を結ぶことでログ保存なしの運用も可能です。
生成コードのライセンス: AI が生成したコードについて Anthropic 自身は権利を主張しませんが、生成コード中にオープンソースコードが混入する可能性はゼロではありません。重要なプロジェクトに取り入れる前にレビューすることをお勧めします。

以上、Windows 環境での Claude Code セットアップと活用方法を解説しました。適切な環境構築と認証設定を行えば、ターミナルから強力な AI アシスタントを自在に操ることができます。

Claude Code を使った AI 駆動開発に興味がある方は、弊社 AR-ACA（Spell The Space） の AI・IT 研修プログラムもご活用ください。社内の非エンジニアスタッフも含めた DX 推進をサポートしています。

アルアカ - Arcadia Academia