Claude Code Windows完全ガイド|インストール・WSL2設定・トラブル解決【2026年版】

Claude Code Windowsのイメージ画像

Claude Code は2026年にネイティブWindows版が公式化され、Node.js不要の1コマンドでインストールできます。

  • 要点1: PowerShellで irm https://claude.ai/install.ps1 | iex を実行するだけでインストール完了
  • 要点2: WSL2版はサンドボックスに対応しており、Linux環境との連携が必要な開発者向け
  • 要点3: 「claude is not recognized」等のよくあるエラーはターミナル再起動・PATH再読み込みで解決できる

対象: WindowsでClaude Codeを使いたい方、WSL2のセットアップで詰まっている方

今日やること: PowerShellを開いて irm https://claude.ai/install.ps1 | iex を実行する

Claude CodeをWindowsで使う方法は、2026年に大きく変わりました。以前はWSL2(Windows Subsystem for Linux)の設定が必須でしたが、現在はPowerShellで1コマンドを実行するだけでインストールできるネイティブ版が公式サポートされています。

「WSL2の設定が難しそう」「インストールしたのにclaudeコマンドが認識されない」——こうした悩みを持つWindowsユーザーは多くいます。

この記事では、ネイティブ版(推奨)とWSL2版の2通りの方法を状況別に解説します。また、Windows特有のトラブルとその解決策も網羅しますので、詰まったときの参考にしてください。

Claude CodeのWindows対応状況(2026年最新)

Claude Codeには、2026年現在2種類のインストール方法があります。多くのWindowsユーザーにとって、ネイティブ版が最もシンプルな選択肢です。

ネイティブ版とWSL2版の違い

項目 ネイティブ版(推奨) WSL2版
インストール手順 PowerShellで1コマンド WSL2 + Ubuntu + Node.jsが必要
Node.jsの要否 不要 Node.js 18.0+が必要
自動更新 バックグラウンドで自動更新 手動更新が必要
サンドボックス対応 非対応 対応(WSL2の場合)
VS Code連携
安定性 高い ファイルシステムへのパスに注意が必要

ネイティブ版はAnthropicが2025年に公式リリースしたもので、Node.jsを別途インストールする必要がなく、バックグラウンドで自動更新される点が特徴です。

どちらを選ぶべきか?用途別の判断基準

ネイティブ版を選ぶべき場合:

  • プログラミング経験が浅い、またはLinux環境に不慣れな方
  • 業務効率化やドキュメント作成など、非エンジニア用途
  • とにかく早くClaude Codeを使いたい方

WSL2版を選ぶべき場合:

  • 既にWSL2でLinux開発環境を構築済みの方
  • Claude CodeのSandboxモード(セキュリティ強化機能)を使いたい場合
  • DockerやGitなどLinuxネイティブのツールとの連携が必要な場合

社内展開やビジネス利用では、多くの場合ネイティブ版で十分です。特別な理由がなければ、ネイティブ版からスタートすることをおすすめします。

方法①:ネイティブインストーラーで導入する(推奨)

ネイティブ版のインストールは、PowerShellで1つのコマンドを実行するだけです。Node.jsや追加のツールは一切不要です。

前提条件

インストール前に以下を確認してください。

項目 要件
OS Windows 10 / Windows 11
Git for Windows インストール済みであること
PowerShell バージョン5.1以上(Windows 10以降は標準搭載)
管理者権限 不要(通常ユーザーで実行可能)

Git for Windowsのインストール(未インストールの場合):

Git公式サイトからインストーラーをダウンロードして実行します。インストール時のオプションはデフォルト設定のままで構いません。

インストール手順

1. PowerShellを起動する

スタートメニューで「PowerShell」と検索して起動します。なお、管理者として実行する必要はありません

2. インストールコマンドを実行する

irm https://claude.ai/install.ps1 | iex

このコマンドは、Anthropic公式のインストールスクリプトをダウンロードして実行します。Claude Codeのバイナリが自動的に ~/.local/bin にインストールされます。

3. インストール完了後、ターミナルを再起動する

インストール後はPowerShellウィンドウを一度閉じて新しく開き直してください。これでPATHが更新されます。

インストール後の動作確認

新しいPowerShellウィンドウで以下を実行します。

claude --version

バージョン番号(例: 1.x.x)が表示されればインストール成功です。

claude

と入力するとClaude Codeのインタラクティブモードが起動します。初回起動時は認証が求められますので、Anthropicアカウントでログインしてください。

ポイントClaude Codeはバックグラウンドで自動更新されます。常に最新バージョンを使用するために、定期的に新しいターミナルセッションを開くことをおすすめします。

方法②:WSL2環境で導入する(Linux環境が必要な場合)

既存のLinux開発環境との連携や、Sandboxモードを使いたい場合は、WSL2環境でClaude Codeを利用できます。

WSL2の有効化とUbuntuのインストール

1. PowerShellを管理者として実行する

スタートメニューで「PowerShell」を右クリックし、「管理者として実行」を選択します。

2. WSL2をインストールする

wsl --install

このコマンドでWSL2とUbuntu(デフォルトディストリビューション)が同時にインストールされます。インストール後はPCの再起動が必要です。

3. 再起動後、Ubuntuの初期設定を行う

PCを再起動するとUbuntuのセットアップが自動的に始まります。ユーザー名とパスワードを設定してください。

4. WSL2のバージョンを確認する

wsl --list --verbose

VERSION列が2になっていることを確認します。もし1になっている場合は、以下で変更できます。

wsl --set-version Ubuntu 2

Node.js(18.0+)とClaude Codeのインストール

WSL2のUbuntuターミナルを開いて以下を順番に実行します。

1. システムパッケージを更新する

sudo apt update && sudo apt upgrade -y

2. Node.jsをインストールする(nvm経由が推奨)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts
node --version # v18.x.x以上であることを確認

3. Claude Codeをインストールする

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

4. 動作確認

claude --version

バージョン番号が表示されればインストール成功です。

動作確認とVS Code連携設定

VS CodeでWSL2上のClaude Codeを使う場合、VS Codeの「Remote – WSL」拡張機能をインストールします。その後、WSLターミナルからプロジェクトフォルダで code . を実行すると、WSL2環境に接続したVS Codeが起動します。

ポイントWSL2内でのプロジェクトファイルは、Windowsのファイルシステム(/mnt/c/配下)ではなく、LinuxのHOMEディレクトリ(~/配下)に置くと大幅にパフォーマンスが向上します。

WSL2環境を最適化する(パフォーマンス向上)

WSL2のデフォルト設定では、メモリやCPUのリソース割り当てが最適化されていない場合があります。.wslconfigファイルを作成して、Claude Code用のリソースを適切に確保しましょう。

.wslconfigファイルの作成と設定

.wslconfigはWindowsのユーザーホームディレクトリ(C:\Users\ユーザー名\)に配置します。

1. PowerShellで.wslconfigを作成・編集する

notepad "$env:USERPROFILE\.wslconfig"

2. 以下の内容を記述して保存する

[wsl2]
memory=8GB # 物理RAMの1/3〜1/2を目安に設定
processors=4 # CPUコア数の半分程度
swap=2GB # スワップメモリ(推奨)
localhostForwarding=true

物理RAMが16GBの場合はmemory=8GB、8GBの場合はmemory=4GBが目安です。Claude Codeは最低4GB、推奨8GBのメモリが必要です。

3. WSL2を再起動して設定を反映する

wsl --shutdown

その後、再度WSL2ターミナルを開くと新しい設定が適用されます。

重要: .wslconfigの変更はWSL2の起動時にのみ読み込まれます。変更後は必ずwsl --shutdownを実行してWSL2を完全に停止してから再起動してください。

プロジェクトファイルをLinuxファイルシステムに置く

WSL2でのファイルアクセス速度は、ファイルの置き場所によって大きく異なります。

ファイルの置き場所 アクセス速度 推奨
Linuxファイルシステム(~/配下) 高速 ○(推奨)
Windowsファイルシステム(/mnt/c/配下) 低速(WSL2のオーバーヘッドあり)

WSL2でClaude Codeを使う場合は、プロジェクトファイルをLinuxのホームディレクトリ(~/projects/など)に置くことで、コード編集や解析の速度を大幅に向上できます。

Claude Codeを社内展開する際は、個々の開発者がこの設定を各自で行うよりも、社内の標準セットアップガイドを作成して統一することをおすすめします。Nexaではこうした社内AI環境の整備もサポートしています。

AI活用の無料相談はこちら →

よくあるトラブルと解決策

Windows環境でClaude Codeを使う際に発生しやすいエラーと、その解決策をまとめました。

「claude is not recognized」エラーの解決

インストール直後に claude を実行すると「’claude’ は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません」と表示されることがあります。

原因: インストール後にPATHが更新されていない。

解決策:

  1. ターミナルを完全に閉じて新しく開き直す(最も多い解決策)
  2. 上記で解決しない場合、PowerShellで以下を実行してPATHを確認する:
    powershell
    $env:PATH
  3. ~/.local/bin がPATHに含まれていない場合は、PowerShellプロファイルに以下を追記する:
    powershell
    $env:PATH += ";$HOME\.local\bin"

TLSハンドシェイク失敗エラーの解決

インストール中に TLS connect errorSSL handshake failed が表示された場合の解決策です。

解決策: インストール前にPowerShellでTLS 1.2を有効にする。

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

上記を実行してから、改めてインストールコマンドを実行してください。企業のセキュリティポリシーによってTLSバージョンが制限されている場合に発生することがあります。

ポート54545が使えない場合の回避策

Claude Codeは認証時にポート54545を使用します。このポートが予約済みになっている場合(企業ネットワーク環境で多い)、認証が失敗することがあります。

解決策:

  1. WSL2を一時的に無効にして認証を実行する: powershell wsl --shutdown # Claude Codeの認証を実行 claude auth # 認証後にWSL2を再起動 wsl

  2. 上記で解決しない場合は、ネットワーク管理者に54545ポートの開放を依頼してください。

WSL2が固まる・切断される場合の対処

長時間の操作中にWSL2が応答しなくなったり、急に接続が切れたりすることがあります。

主な原因と解決策:

原因 解決策
メモリ不足 .wslconfigでメモリ割り当てを増やす
WSL2プロセスの異常終了 wsl --shutdown 後に再起動
ネットワーク設定の問題 .wslconfiglocalhostForwarding=true を追記
Windowsのスリープによる切断 電源オプションでスリープを無効化

これらの問題の多くは、.wslconfigでメモリ割り当てを適切に設定することで解決できます。

よくある質問

Q. Claude CodeはWSLなしでWindowsで使えますか?

はい、使えます。2025年以降、Anthropic公式のネイティブWindowsインストーラーが提供されており、WSL2は不要になりました。PowerShellで irm https://claude.ai/install.ps1 | iex を実行するだけでインストールできます。

Q. Windows 10でも動作しますか?

はい、Windows 10でも動作します。ただし、WSL2を使用する場合はWindows 10 バージョン2004以降(ビルド19041以降)が必要です。ネイティブ版であればWindows 10の主要バージョンで動作します。

Q. 企業のプロキシ環境下での設定方法は?

Claude Codeは環境変数でプロキシ設定を読み込みます。PowerShellプロファイルに以下を追記してください。

$env:HTTPS_PROXY = "http://proxy.example.com:8080"
$env:HTTP_PROXY = "http://proxy.example.com:8080"

プロキシのURLとポートは社内の情報システム部門に確認してください。

Q. WSL2とネイティブ版を両方インストールしても問題ない?

技術的には両方インストール可能ですが、バージョン管理が複雑になります。用途を明確にして、基本的には一方に統一することをおすすめします。業務効率化目的であればネイティブ版を、開発目的であればWSL2版を選ぶとよいでしょう。

Q. インストール後に古いnpm版からネイティブ版に移行するには?

npm版のClaude Codeを以前インストールしていた場合、以下で削除してからネイティブ版をインストールしてください。

npm uninstall -g @anthropic-ai/claude-code
irm https://claude.ai/install.ps1 | iex

まとめ

この記事では、Claude CodeをWindows環境で使うための方法を解説しました。

  • ネイティブ版(推奨): PowerShellで irm https://claude.ai/install.ps1 | iex を実行するだけ。Node.js不要、自動更新対応
  • WSL2版: 既存のLinux開発環境との連携が必要な場合、またはSandboxモードを使いたい場合に選択
  • WSL2最適化: .wslconfigでメモリ・CPU割り当てを設定し、プロジェクトファイルはLinuxファイルシステムに配置
  • トラブル対応: 「claude is not recognized」はターミナル再起動、TLSエラーはTLS 1.2の有効化で解決できる

Claude Codeを個人で使い始めることはできても、チームや組織全体に展開して成果を出すためにはノウハウが必要です。「どの業務から自動化を始めるか」「社内のルール整備をどうするか」といった問いに、Nexaは実務経験をもとにサポートします。

Claude Codeの活用、何から始めればいい?

無料でClaude Codeの活用について相談に乗ります。お気軽にお問い合わせください。

無料相談はこちら →




この記事の監修者

川島陸

株式会社Nexa 代表取締役

川島 陸

一橋大学経済学部卒業後、フォーティエンスコンサルティング株式会社(旧 株式会社クニエ)にて法人向けAI導入支援等を経験。独立後、AI系メディア運営やDify/n8nの導入支援を経て、株式会社Nexaを創業。法人向けAI研修・AI導入支援・AI関連メディア運営を手掛ける。

関連記事

AIの力で、ビジネスを次のステージへ

まずはお気軽にご相談ください。貴社に最適なAI活用プランをご提案します。