WindowsでClaude CodeをWSLから使う環境構築の流れと注意点

WindowsでClaude Codeをまともに動かそうとすると、たいていの人はWSLにたどり着きます。デスクトップアプリでも始められますが、CLIの細かい操作や自動化までやりたい時、WSLが現実解になります。

この記事は、WSL経由でClaude Codeを動かすまでの流れと、Windowsならではのクセを整理したものです。

なぜCLIなら結局WSLに行き着くか

Claude Code自体はWindowsネイティブでも動きます。ただ、ふだんの作業の周辺ツール — シェル、git、各種コマンドラインユーティリティ — がLinux前提で書かれていることが多い。

PowerShellで頑張る道もありますが、WSLを入れれば「事実上のLinux環境」がWindowsの中に住むことになり、コマンド系の困りごとがまとめて解消されます。CLIをガッツリ使いたい人ほどWSL一択になる、というのが現場での実感です。

ターミナルが苦手な人や、まずGUIで触りたい人にはデスクトップアプリの方が向くので、そちらは別記事にまとめました。

ターミナルが苦手でも使えるClaude Codeデスクトップアプリ

claudecodelab.jp

WSLを有効化してUbuntuを入れる

WSLの導入は、PowerShellを管理者で開いて、コマンドを1本叩くだけです。

wsl --install

これでWSLが有効化され、初期状態のUbuntuが入ります。Microsoft Storeから別のディストリビューションを選ぶこともできますが、多くの場合は既定のUbuntuで困りません。インストール後の初回起動で、Linux側のユーザー名とパスワードを聞かれます。

Microsoft WSL公式ドキュメント

learn.microsoft.com

ここまでで、Windowsの中にLinux環境が並走している状態になります。

Node.jsを入れる

Claude CodeはNode.js上で動きます。Ubuntu側に新しめのNodeを入れる必要があります。

aptで入る古めのNodeではなく、nvmのようなバージョンマネージャー経由で入れるのが無難です。最新のLTS版を選んでおけばまず外しません。

Nodeが入ったら、node --version と npm --version が出るかを確認します。両方が出れば、次に進めます。

Claude Code本体のインストール

ここからはmacOSと同じ手順です。

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

インストール後、claude と打って起動します。初回はログインの案内が出るので、案内に従ってアカウントを紐付ければ、その先はふだんの操作です。

インストール周りで詰まった時の手順は別記事に整理してあります。

Claude Codeのインストール方法

claudecodelab.jp

Windows TerminalとWSLの相性が良い

WSL内のClaude Codeを動かす画面は、Windows Terminalがいちばん扱いやすいです。Windows 11なら標準で入っています。

Windows Terminalから新しいタブを開く時、ドロップダウンでUbuntuを選べる。これで、WSLのシェルが立ち上がり、その中で claude を起動する流れになります。日本語入力周りも、Windows Terminalは比較的安定しています。日本語入力で詰まる話は別記事に書きました。

Claude Codeのターミナルで日本語入力がうまくいかない時の対処

claudecodelab.jp