WindowsでClaude Codeを使う方法をお探しですね。
広告
WindowsでClaude Codeを使う2つの方法:WSL2とNativeインストールの手順
AIでコーディングをサポートしてくれる「Claude Code」が話題になっていますが、Windowsで使うにはちょっとしたコツが必要です。
公式サイトでは「Nativeインストール(PowerShellを使う方法)」と「WSL2(Windowsの中でLinuxを動かす方法)」の2つが紹介されていて、どっちがいいのか迷ってしまいますよね。
この記事では、それぞれのインストール方法をわかりやすく説明しながら、あなたに合った選び方や、Windows特有のトラブル対処法も詳しくお伝えします。
Windowsユーザーは「Native」と「WSL2」どっちを選べばいい?
Claude Codeを入れるとき、まず決めなきゃいけないのが「Windows上で直接動かすか(Native)」「Linux環境で動かすか(WSL2)」という選択です。
簡単に言うと、**普段の開発スタイルがWindows中心ならNative、Linux中心ならWSL2**を選ぶのがおすすめです。
Nativeインストールは、公式が推奨している方法で、セットアップが比較的簡単なのが魅力です。
PowerShellでコマンドを1つ打つだけで導入できて、自動アップデートにも対応しています。
Cドライブにあるプロジェクトをよく触る人や、コマンドプロンプト・PowerShellに慣れている人にはこっちがぴったりです。
ただし、Git for Windows(Git Bash)が必須なので、環境によってはパスの設定が必要になることもあります。
一方のWSL2インストールは、Linuxのコマンドやツールをよく使う開発者向けです。
特に、Node.jsやPythonのバージョン管理(nvmやpyenv)をLinux側でやっている人や、Dockerコンテナと連携させたい人はWSL2が自然な選択肢になります。
ただし、WSL2からWindows側のファイル(`/mnt/c/`とか)を操作すると動作が遅くなることがあるので、プロジェクトファイル自体もWSL2のファイルシステム内(`/home/ユーザー名/`など)に置くのがおすすめです。
方法1:Nativeインストール(PowerShell)の手順と注意点
Nativeインストールをするなら、まず「Git for Windows」が入っているか確認しましょう。
Claude CodeはGit Bashを使って動くので、これがないと正常に動きません。
まだ入れていない人は、Gitの公式サイトからインストーラーをダウンロードして、先にセットアップを済ませておいてください。
準備ができたら、PowerShellを開いてインストールコマンドを実行します。
公式で用意されている次のコマンドを入力してください。
“`powershell
irm https://claude.ai/install.ps1 | iex
“`
このコマンドを実行すると、必要なファイルが自動的にダウンロードされて、セットアップが進みます。
インストールが終わったら、ちゃんと入ったか確認するために `claude doctor` コマンドを実行してみましょう。
ここで「Claude Code on Windows requires git-bash」というエラーが出たら、システムがGit Bashの場所を見つけられていません。
そんなときは、環境変数 `CLAUDE_CODE_GIT_BASH_PATH` を設定して、`bash.exe` へのフルパス(例:`C:\Program Files\Git\bin\bash.exe`)を指定すれば解決します。
あと、インストール直後に `claude` コマンドが認識されない場合は、環境変数 `PATH` にインストール先(だいたい `%USERPROFILE%\.local\bin`)が追加されていない可能性があります。
一度ターミナルを再起動するか、それでもダメなら手動で環境変数を編集してパスを通してください。
この最初の設定さえクリアすれば、Windows環境でもスムーズにClaude Codeが使えるようになります。
方法2:WSL2環境でのインストールと環境設定
WSL2を使う場合は、まずWSL2本体とUbuntuなどのディストリビューションがちゃんとセットアップされている必要があります。
ターミナル(Windows Terminalがおすすめ)を開いて、Ubuntuのシェルに入った状態で作業を進めましょう。
以前はnpm経由でインストールするのが一般的でしたが、今はセキュリティや依存関係の問題から、公式が用意しているスタンドアロンのインストールスクリプトを使う方法が推奨されています。
次のコマンドをWSL2のターミナルで実行してください。
“`bash
curl -fsSL https://claude.ai/install.sh | bash
“`
このコマンドで、Linux向けのファイルがダウンロードされて、`~/.local/bin/claude` に配置されます。
インストールが終わったら、`~/.bashrc` や `~/.zshrc` などの設定ファイルを再読み込み(`source ~/.bashrc` など)して、パスを反映させてください。
WSL2で使うときに特に気をつけたいのが、Windows側のNode.jsとの競合です。
WSL2はデフォルトでWindows側のPATHを引き継ぐので、WindowsにインストールされたNode.jsやnpmを間違って参照してしまうことがあります。
これで「OSプラットフォームの検出エラー」や「パーミッションエラー」が出ることがあるんです。
これを防ぐには、WSL2の中で `nvm`(Node Version Manager)を使ってLinux専用のNode.js環境を作って、Linux側のパスが優先されるように設定しておくのが大事です。
`which node` コマンドを実行したとき、`/mnt/c/` じゃなくて `/home/` 以下のパスが表示されていれば、環境はちゃんと分離できています。
よくあるトラブルと解決策:認証・権限・ネットワーク
インストールが無事に終わっても、いざ使い始めるといくつかの壁にぶつかることがあります。
一番よく報告されるのが「認証」関連のトラブルです。
Claude Codeを初めて起動するとブラウザで認証を求められますが、認証が完了してもターミナル側が反応しないことがあります。
そんなときは一度 `Ctrl+C` でプロセスを終了して、もう一度 `claude login` を実行してみてください。
それでもダメなら `claude doctor` でネットワーク接続状況を確認しましょう。
特に会社のネットワークやVPN環境では、認証サーバーへの通信がブロックされている可能性があります。
次に多いのが、WSL2環境でのネットワークとファイアウォールの問題です。
JetBrains製のIDE(IntelliJやPyCharmなど)と連携させようとしたときに「IDEが見つからない」と表示されることがあります。
これはWSL2のネットワークモードが原因の場合が多くて、Windows DefenderファイアウォールがWSL2からの通信を遮断していることが考えられます。
対処法としては、PowerShell(管理者権限)でWSL2の通信を許可するルールを追加するか、WSLの設定ファイル(`.wslconfig`)で `networkingMode=mirrored` を設定して、ホストOSとの通信をスムーズにする方法が有効です。
最後に、パーミッション(権限)関連のエラーです。
特に「npm install」などの古い方法でインストールを試みた場合や、システムディレクトリに書き込もうとした場合に発生します。
公式推奨のスタンドアロンインストーラーを使っていればこの問題は起きにくいですが、もし権限エラーが頻発するなら、一度関連ファイルをクリーンアップ(`~/.claude` ディレクトリの削除など)してから、推奨手順で再インストールするのが一番確実です。
安定した環境を作るには、自己流のパス設定よりも公式スクリプトに任せる方が、結果的にトラブルを減らす近道になりますよ。
広告
