はじめに
Claude Codeを使い始めようとして調べてみると、
- PowerShellやBashで使うのか？
- VS Codeから使うのか？
- WSL、DockerやDev Containerが必要か？
- 何が違うのか？
など、複数の動作環境がありすぎてインストールに迷いました。
それぞれの記事はあるものの、「結局何が違うのか？」が文章だけでは非常にわかりにくいと感じました。
そこで、自分の整理のためにも文章だけでなく図で理解することを目的に、Claude CodeのWindows動作環境を整理してみました。
この記事を読むと、WindowsでClaude Codeを使う際に「どの環境を選べばいいか」が一目でわかります。
全体像（まずこれを見る）
| No | 実行環境 | 操作UI | 動作実体 | 特徴と用途 |
|---|---|---|---|---|
| ① | Windows ネイティブ | Browser | Claude.ai | - Windowsのブラウザで使う構成 - ChatGPTと同様エンジニア・非エンジニア問わず手軽に使える |
| ② | Windows ネイティブ | Claude for Windows | Claude for Windows | - Windowsのデスクトップアプリケーションで動作 - エンジニア・非エンジニア問わず手軽に使える - Claude Coworkが使える |
| ③ | Windows ネイティブ | CLI (PowerShell) | Claude Code | - Claude CodeをCLI（PowerShell, Git Bash）から操作 - ターミナル操作に慣れた人向け - Windows環境による一部制限あり |
| ④ | Windows ネイティブ | VS Code (Claude Code Extension) |
Claude Code | - WindowsネイティブでVS Code使いには最も手軽 - VS CodeのClaude Code Extensionから操作 - VS Codeのファイル操作重視（③ CLI操作と併用する） - Windows環境により一部制限あり - Windowsネイティブアプリ開発向け |
| ⑤ | WSL (Linux) | CLI (Bash) | Claude Code | - 個人開発に最適 - Linux環境でフル機能（最も制約が少ない） |
| ⑥ | WSL (Linux) | VS Code (Claude Code Extension) |
Claude Code | - WSLで制約がほぼなく最も安定 - Linux環境でフル機能（最も制約が少ない） - VS Codeのファイル操作重視（⑤ CLIと併用する） - Linux前提のプロジェクトやOSS開発向け |
| ⑦ | Docker | CLI (Bash) | Claude Code | - チーム開発向け - Linux環境でフル機能 - 環境の再現性を重視 - 権限、ボリューム、ネットワークはDocker環境設計に依存 - Docker環境設計によりセキュリティ的な隔離可能 - ホストマシンのファイルシステムから分離して自動実行 |
| ⑧ | Docker (Dev Container) |
VS Code (Claude Code Extension) |
Claude Code | - チーム開発の再現性が最も高い - Linux環境でフル機能 - 環境の再現性を重視 - VS Codeのファイル操作重視（⑦ CLIと併用する） - 権限、ボリューム、ネットワークはDocker環境設計に依存 - Docker環境設計によりセキュリティ的な隔離可能 - ホストマシンのファイルシステムから分離して自動実行 |
Claude Codeの理解が難しい理由は、以下の3つが混ざっているためです。
- 実行環境（Windows / WSL / Docker）
- 操作UI（CLI / VS Code / Claude Code Extention）
- 実体（Claude Code / Claude.ai）
これらが組み合わさることで、一見バラバラな環境に見えるのが混乱の原因です。
各環境のイメージ（図で理解）
✅ 迷ったらこれを選べばOK
用途別にまとめると以下のようになります。
手軽に始めたい ： 👉 ④ VS Code（Windowsネイティブ）
個人開発におすすめ ： 👉 ⑥ WSL + VS Code
チーム開発におすすめ ： 👉 ⑧ Dev Container
🔥 Windowsネイティブの制約（要点だけ）
Windowsネイティブ環境はLinux環境に比べると一部制約がある。
WSL/Docker(Dev Container)を使用しても実行速度や権限問題が発生する場合がある。
| 項目 | Windows の制約 |
|---|---|
| サンドボックス機能 | 未対応 |
| MCPサーバー | 動かないものがある |
| スクリプト実行 | PowerShellとBashの違い |
| パス表記 | 自動生成コードが動かないことがある |
| 依存ツール | Python/Nodeの互換性問題 |
おわりに
この記事では、「図で理解する」ことができるように厳密さよりもわかりやすさを重視して整理してみました。
私と同じように、どの環境を選べばいいか迷っているという方の参考になれば幸いです。
Claude Codeの動作環境を整理してみると、LinuxやMacといった環境がベースにあり、その上でWindows環境が整備されてきたことがわかります。
WSLやDockerを前提とする構成が主流になっている点からも、開発環境の前提が変化してきていることを実感しました。
参考
- VS Code で Claude Code を使用する https://code.claude.com/docs/ja/vs-code
- 高度なセットアップ https://code.claude.com/docs/ja/setup
- 開発コンテナ https://code.claude.com/docs/ja/devcontainer