結論：Windows projectはNative、Linux toolchainはWSL 2が基本

先に答えると、Claude CodeをWindowsで使う時は、慣れているterminalではなく、projectと周辺toolが実際に動く場所で選びます。Windows専用SDK、PowerShell script、Visual Studio、Windows pathを中心に作業するならNative Windowsが自然です。Linux command、container、Linux向けbuild、sandboxed command executionが必要ならWSL 2を選びます。

読者の具体的な困りごとは、NativeとWSLの両方へ導入した後に、NodeやGitのversion、path、credential、file permissionが食い違い、「terminalでは動くのにClaude Codeでは失敗する」状態になることです。読了後は、projectごとにNativeかWSL 2かを選び、必要なinstaller、shell、sandbox、更新方法を判断できます。次の行動は、対象projectの保存場所と本番に近いtoolchainを一行で書くことです。

公式要件と2つの実行方式を確認する

公式setupでは、Claude CodeはWindows 10 version 1809以降またはWindows Server 2019以降をsupportし、4GB以上のRAM、x64またはARM64 processor、internet接続を要件としています。WindowsではNativeとWSLの両方が案内され、Nativeは追加のLinux環境なしで利用でき、WSL 2はLinux toolchainとsandboxに向くと整理されています。

NativeではPowerShell用installer、CMD用installer、WinGetを選べます。native installerは背景で自動更新し、WinGetは既定で手動更新です。WSLではWindows側のPowerShellではなく、WSL distribution内でLinux用installerを実行し、そのterminalからclaudeを起動します。一つのinstallを両側で共有する前提にしません。

Claude Codeの利用にはPro、Max、Team、Enterprise、Console account、または対応するthird-party API providerが必要です。無料Claude.ai planにはClaude Code accessが含まれないと公式setupに記載されています。installerの選択と契約条件を混同せず、利用者へaccountと組織を事前配布します。

Native Windowsが向く業務

Nativeは、repositoryがC:\\配下にあり、PowerShell、Windows service、.NET、Windows版database client、社内endpoint securityなどをそのまま使う場合に向きます。PowerShellかCMDからinstallerを実行し、管理者権限は不要です。起動後はproject directoryでclaudeを実行します。

Git for Windowsは任意です。未導入ならClaude CodeはPowerShell toolでshell commandを実行し、導入済みならGit BashをBash toolとして使えます。Git Bashを検出できない場合はCLAUDE_CODE_GIT_BASH_PATHをsettingsへ設定できます。企業端末では個人ごとにpathを手直しせず、標準install先と配布scriptを決めます。

注意点はNative WindowsがClaude Code sandboxingをsupportしないことです。permission ruleや人間承認が不要になるわけではありませんが、Linux/WSL 2と同じsandbox前提の運用にはできません。command実行を強く隔離したい、未知のrepositoryを扱う、Linux本番へ近づけたい場合はWSL 2または別の隔離環境を検討します。

WSL 2が向く業務

WSL 2は、Linux用package manager、shell script、container、Linux filesystem permission、本番Linuxと同じbuild commandを使う場合に向きます。公式表ではWSL 2がsandboxing対応、WSL 1は非対応です。WSL 2を選ぶ理由が「何となく開発者らしい」ではなく、必要なtoolchainと隔離要件に結び付いているかを確認します。

repositoryの置き場所も重要です。Windows filesystemを/mnt/c経由で扱う構成は、watcher、permission、symbolic link、I/O performanceで差が出ることがあります。Linux toolchain中心ならWSL filesystemへcloneし、Windows editorとの連携を小さなprojectで確認します。credentialもWindows側とWSL側で別になる場合があるため、Git、SSH、package registry、cloud CLIを一つずつtestします。

WSL内ではLinux版Claude Codeとして扱います。PowerShellでinstall済みでも、WSL内のclaudeとはversionやsettings locationが異なり得ます。どちらから作業を始めたか分からない事故を防ぐため、terminal prompt、repository path、claude --versionを作業記録へ残します。

NativeとWSL 2を6軸で比較する

  1. project配置：C:\\中心ならNative、WSL filesystem中心ならWSL 2。
  2. toolchain：PowerShell・Windows SDKならNative、Linux command・containerならWSL 2。
  3. sandbox：Claude Code sandboxingが必要ならWSL 2。NativeとWSL 1は非対応です。
  4. shell：PowerShellまたはGit Bashを使うNativeと、Linux shellを使うWSL 2を分けます。
  5. credential：Git、SSH、registry、provider loginがどちらに保存されるか確認します。
  6. 更新：native installerの自動更新か、WinGet等の手動更新かを統一します。

一つの会社でどちらかに統一する必要はありませんが、一つのprojectでは標準経路を決めます。READMEに「WindowsはWSL 2」などと書くだけでなく、repository path、install方式、version確認、test command、credential所有者まで記載します。

導入から確認までの8手順

  1. 対象projectの保存場所と本番toolchainを確認します。
  2. NativeかWSL 2を選び、選定理由を一文で記録します。
  3. 公式setupから該当するinstallerだけを使います。
  4. claude --versionとclaude doctorでinstallとsettingsを確認します。
  5. Git、package manager、build、testをClaude Code外で先に実行します。
  6. 読取だけの小さな依頼から始め、pathとshellを確認します。
  7. 編集、test、拒否すべきcommandを順に試します。
  8. 成功条件、失敗、戻し方、標準terminalをteamへ共有します。

installで失敗した時は連続再実行せず、公式troubleshootingでerror messageを照合します。command not found、PATH、403、TLS、proxy、loginを分け、network blockをcredential errorとして扱わないことが早い解決につながります。

Windows導入チェックリスト

OS要件を満たすか／projectはWindows側かWSL側か／本番toolchainはどちらか／sandboxが必要か／PowerShellかGit Bashか／WSLはversion 2か／credentialの保存先が分かるか／account条件を満たすか／installerを統一したか／自動更新か手動更新か／doctorを実行したか／buildとtestが通るか／標準経路を文書化したか、を確認します。

よくある質問

初心者はNativeとWSL 2のどちらが簡単ですか？

Windows側のprojectだけならNativeの手順が短いです。ただしLinux教材やcontainerを使うなら、最初からWSL 2へそろえた方がpathの混在を減らせます。

NativeとWSL 2の両方へinstallしてもよいですか？

可能ですが、version、settings、credential、repositoryを混同しやすくなります。projectごとに標準経路を明記します。

Windowsで起動できない時は何から確認しますか？

使っているterminal、install方式、PATH、version、network、loginの順で切り分け、公式troubleshootingの該当errorへ進みます。

関連ガイドと公式情報

共通の導入手順はClaude Codeインストール、VS Codeでの利用はVS Code連携ガイド、command承認は権限設定ガイドを参照してください。

Windows要件、Native・WSL比較、installer、更新はClaude Code公式Advanced setup、PATH、network、loginのerror切り分けは公式Troubleshoot installation and loginで公開直前に確認してください。

Miraigentの無料診断では、端末、project配置、toolchain、権限、更新、reviewを整理し、導入後に環境差で止まる原因を見える化します。