Claude CodeをWindowsで使う｜導入とWSL選択
Claude Code と Windows 環境とは
Claude Code は Anthropic のエージェント型コーディングツールで、Windows でも利用できます。かつては「WSL 前提」という印象が強かった時期もありますが、公式ドキュメント（2026年時点）では ネイティブ Windows と WSL の両方が案内されています。
本記事は Windows 特化です。macOS 中心の導入全体像は セットアップ完全ガイド を参照し、ここでは PowerShell / CMD / WinGet / WSL2 / サンドボックスの違いに絞ります。手順と制約は Overview、Advanced setup、Sandboxing、Desktop in WSL に基づきます。
前提環境
| 項目 | 内容 |
|---|---|
| OS | Windows 10 / 11（Desktop の WSL 連携は WSL 2 が必要） |
| シェル | PowerShell または CMD（Windows Terminal 推奨） |
| アカウント | Pro / Max / Team / Enterprise、または API（Free では Claude Code 不可） |
| 推奨追加 | ネイティブ利用時は Git for Windows（Bash tool 用） |
| WSL を使う場合 | WSL 2 ディストリビューション（例: Ubuntu）と、その中の git |
管理者権限は、公式のネイティブインストール手順では必須とされていません。
まず選ぶ：ネイティブか WSL か
公式の比較は次の整理です。
| 方式 | 必要なもの | サンドボックス | 向くケース |
|---|---|---|---|
| Native Windows | 特別な前提は少ない。Git for Windows は任意 | 非対応 | Windows ネイティブのプロジェクト・ツールチェーン |
| WSL 2 | WSL 2 有効化 + Linux ディストリ | 対応 | Linux ツールチェーン、サンドボックス付き実行 |
| WSL 1 | WSL 1 | 非対応 | WSL 2 が使えない場合の代替 |
選び方の実務ルールは単純です。
- リポジトリが Windows 側（
C:\...）で、Visual Studio や Windows 専用ツールが中心 → ネイティブ - リポジトリが WSL 内（
/home/...）で、Docker / Linux ビルドが中心 → WSL 2 - コマンド実行の OS レベル隔離（sandbox）を使いたい → WSL 2（ネイティブ Windows では未サポート）
WSL のファイルを Windows 側からネットワーク経由で触ると遅く、ファイル監視も壊れやすい、という注意が Desktop の WSL ドキュメントにあります。リポジトリがある場所で Claude Code を動かす、が基本です。
ネイティブ Windows へのインストール
PowerShell（推奨されることが多い経路）
PowerShell を開き、次を実行します。
irm https://claude.ai/install.ps1 | iex
プロンプトが PS C:\ のように PS で始まることを確認してください。
CMD
CMD（PS が付かない C:\ プロンプト）では次です。
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
公式ドキュメントには、取り違え時の症状も書かれています。
- PowerShell で CMD 用の
&&を使う →The token '&&' is not a valid statement separator - CMD で
irmを使う →'irm' is not recognized...
WinGet
winget install Anthropic.ClaudeCode
WinGet 経由は 自動更新されない ため、定期的に次が必要です。
winget upgrade Anthropic.ClaudeCode
ネイティブインストーラ（install.ps1 / install.sh）経路は、公式 Overview ではバックグラウンド自動更新があると説明されています。更新方針を揃えたい場合は、インストール経路を混在させすぎない方が管理しやすいです。
Git for Windows を入れる理由
ネイティブ Windows では、Git for Windows があると Claude Code が Bash tool を使えます。未導入の場合は shell tool として PowerShell が使われます。WSL 上で動かす場合、Git for Windows は不要です（ディストリ内の git を使います）。
起動
cd path\to\your-project
claude
初回はログインを求められます。有料プランまたは API の準備が必要です（詳細は 料金記事）。
WSL 2 へのインストール
- PowerShell でディストリのバージョンを確認する
wsl -l -v
VERSION が 2 であることを確認します。WSL 1 のままサンドボックスを使うと、公式の通り失敗します。
-
WSL ディストリのターミナルを開く（PowerShell のまま Linux 用コマンドを流さない）
-
Linux 用インストーラを実行する
curl -fsSL https://claude.ai/install.sh | bash
- プロジェクトディレクトリへ移動して起動する
cd ~/your-project
claude
ポイントは、「インストールも起動も WSL の中」です。Windows 側に入れた claude と、WSL 内の claude は別物として管理してください。
Desktop アプリと WSL
Windows 向け Desktop アプリ（x64 / ARM64）もあります。Code タブでは、環境ピッカーから WSL 2 ディストリ内セッションを選べます。リポジトリが WSL ファイルシステム上にあるなら、Desktop でも WSL セッションを選ぶ方が一貫します。
前提（公式）:
- Windows 10/11 + WSL 2
- ディストリが1つ以上入っている
- ディストリ内に
gitがある
初回はそのディストリ内セットアップのため少し時間がかかることがあります。
PowerShell と WSL、運用上の使い分け
| 観点 | PowerShell（ネイティブ） | WSL 2 |
|---|---|---|
| パス | C:\Users\... | /home/... |
| パッケージ | winget / scoop 等 | apt 等 |
| sandbox | 不可 | 可（追加パッケージが必要な場合あり） |
| Windows バイナリ呼び出し | 自然 | サンドボックス中は /mnt/c 経由が制限される場合あり |
WSL 2 のサンドボックスでは、cmd.exe や powershell.exe、/mnt/c/ 配下の Windows バイナリ起動がブロックされる、という説明があります。どうしても必要なコマンドは excludedCommands でサンドボックス外実行にする、という調整になります（詳細は sandboxing）。
インストール後にやること（Windows 共通）
claudeが解決するか確認する（新しいターミナルを開いてから）- 作業したいリポジトリで起動する
- 最初は読むだけの指示（構成説明、要約）から始める
- 権限モードは最初 default（都度確認）を維持する
過去に広がった npm install -g @anthropic-ai/claude-code は、いま公式 Overview が先頭で案内する経路ではありません。新規導入は native install / WinGet /（mac なら Homebrew） を正とします。古い記事や手順書を見たら、日付と公式ドキュメントを優先してください。
よくあるつまずき
| 症状 | 原因 | 対処 |
|---|---|---|
irm が認識されない | CMD で PowerShell 用コマンドを実行 | PowerShell に切り替えるか CMD 用コマンドを使う |
&& が無効 | PowerShell で CMD 構文 | シェルに合ったコマンドへ |
claude が見つからない | PATH 未反映、別シェルに入れた | 端末を開き直す。入れた場所（Win / WSL）を確認 |
| サンドボックスが使えない | ネイティブ Windows または WSL 1 | WSL 2 へ移すか、sandbox なしで運用 |
| WSL のファイル操作が極端に遅い | Windows 側から WSL ファイルを触っている | WSL 内セッションで作業 |
| 認証が進まない | ブラウザ許可未完了、プラン不足 | ログイン手順のやり直し、有料プラン/API 確認 |
インストール失敗（403、curl の HTML 返り、syntax error near < など）は、公式の Troubleshoot installation を当たるのが最短です。
Windows Terminal を推奨する理由と追加トラブルシュート
公式の Advanced setup でも、Windows では Windows Terminal の利用が推奨されています。PowerShell と CMD を同一アプリ内でプロファイル切り替えでき、claude 実行後に PATH が反映されない場合も「新しいタブを開く」だけで切り分けやすいためです。
Windows Terminal を Microsoft Store または GitHub Releases から入れたら、既定のプロファイルを PowerShell に設定し、作業リポジトリを cd してから claude を起動してください。WSL 利用時は、Ubuntu 等の Linux プロファイルを別タブで開き、Windows 側と WSL 側で別々に Claude Code を入れる点に注意します（片方にだけ入れて「見つからない」と混乱するパターンが多いです）。
追加のトラブルシュートとして、(1) Defender / 企業 AV が install.ps1 や claude.exe をブロックしていないか、(2) 実行ポリシー で PowerShell スクリプトが拒否されていないか（Get-ExecutionPolicy）、(3) プロキシ環境 で irm が HTML エラーページを返していないか、を確認します。WSL 2 で Docker を併用する場合、Claude の sandbox と Docker のネットワーク設定が競合することがあるため、まず sandbox なしで再現するか、公式 Sandboxing の excludedCommands を検討してください。
FAQ
Q. Windows でも Claude Code は使えますか。 使えます。ネイティブ Windows と WSL の両方が公式に案内されています。プロジェクトの置き場所と、サンドボックス要否で選ぶのが安全です。
Q. WSL は必須ですか。 必須ではありません。Windows ネイティブプロジェクトならネイティブインストールで進められます。Linux ツールチェーンやサンドボックスが必要なら WSL 2 が適します。
Q. PowerShell と CMD のどちらで入れればよいですか。
どちらでも入れられますが、コマンドが違います。プロンプトを見て、PowerShell なら irm ...、CMD なら install.cmd 手順を使ってください。
Q. Git for Windows は必須ですか。 ネイティブ利用では必須ではありませんが、Bash tool を使うために推奨されています。未導入なら PowerShell が shell tool になります。WSL 利用時はディストリ内の git を使います。
Q. WinGet と install.ps1 はどちらがよいですか。
どちらも公式に案内があります。WinGet は自動更新されない点に注意し、winget upgrade Anthropic.ClaudeCode を運用に入れてください。
Q. 料金はどうなりますか。 Free では Claude Code を使えません。Pro / Max 等のサブスクか API 従量が必要です。詳細は Claude Code料金記事 を参照してください。
関連記事
- Claude Code セットアップ完全ガイド
- Claude Code料金｜Pro・Max・APIの違いと目安
- Claude CodeのVSCode拡張｜導入と差分の見方
- Claude Code の権限モード
インストールコマンドは公式ドキュメントの更新に追随します。実行前に code.claude.com/docs の最新手順を確認してください。
関連サービス
最終確認日: 2026-07-23