WindowsにClaude CodeとCodex CLIをインストールする方法

Windows 10と11にClaude CodeとCodex CLIをインストールするためのPowerShell、CMD、WinGet、npmの正確なコマンド。WSLを選ぶべき場面と、「claudeは認識されていません」をはじめとするエラーの直し方もまとめました。

どちらのCLIも、今はWindowsに1行でインストールできます。問題はたいていその後です。コマンドを見つけられないターミナル、npmをブロックする実行ポリシー、古いWSL 1のディストリビューション、別のシェルに貼り付けたコマンド。このガイドは方法ごとの正確なコマンドと、エラーの直し方をまとめます。

両CLIの情報は、AnthropicとOpenAIのドキュメントとインストールスクリプト自体を2026年11月16日に読んだものです(Claude Code 2.1.318、Codex CLI 0.169.0)。どちらも変化が速いので、コマンドが失敗したら各セクションの公式ページを見てください。

短い答え。 CMDではなくPowerShellを開き、次を実行します。

irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

新しいターミナルでclaude --versionとcodex --versionを実行します。Windowsがclaudeを認識しないなら、PATHの直し方は後半のエラー表にあります。

各CLIがWindowsで必要とするもの

Claude CodeCodex CLI
WindowsのバージョンWindows 10 1809以降、Windows Server 2019以降Windows 11推奨、最近のWindows 10は「ベストエフォート」
プロセッサーx64かARM64、32ビットは不可x64かARM64
アカウント有料のClaudeプランかConsoleアカウントChatGPTプランかOpenAIのAPIキー
Node.jsnpm経由のみ、バージョン22以降npm経由のみ
Git for Windowsオプション不要
ネイティブWindowsでのサンドボックスなし、WSL 2内のみあり、独自のWindowsサンドボックス
インストールに管理者権限不要不要

意外な点が2つあります。Claude CodeはもうGit for Windowsを必要とせず、なければPowerShellをシェルツールにします。そしてCodexはネイティブWindowsでもコマンドをサンドボックス化しますが、Claude CodeはWSL 2の中だけです。

WindowsにClaude Codeをインストールする

Anthropicのセットアップページには4つの方法があります。推奨はネイティブインストーラーで、Node.jsが不要なうえ、バックグラウンドで自動更新されます。

方法コマンド
PowerShell(推奨)irm https://claude.ai/install.ps1 | iex
CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget install Anthropic.ClaudeCode
npm(Node.js 22+)npm install -g @anthropic-ai/claude-code@latest

方法ごとに残るもの:

  • ネイティブインストーラー:claude.exeは%USERPROFILE%\.local\binに、各バージョンは%USERPROFILE%\.local\share\claudeに置かれます。.local\binがPATHになければ警告は出ますが、追加はしません。
  • WinGet:自動更新はなく、winget upgrade Anthropic.ClaudeCodeで更新します。Anthropicによると、Windowsが実行ファイルをロックするため、Claude Codeの実行中は更新に失敗することがあります。
  • npm:Node.jsが22より古いと、最後にEBADENGINEの警告が出ます。

最新の1つ前のリリースに留まるには、stableチャンネルを使います。

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

次に確認です。claude --versionはバージョンを表示し、claude doctorはインストールと設定を読み取り専用で診断します。

Git for Windowsがある場合、Claude CodeはGit BashをC:\Program Files\Git、C:\Program Files (x86)\Git、PATH上のgitの順に探します。別のものを使わせるには、settings.jsonのenvブロックでCLAUDE_CODE_GIT_BASH_PATHを設定します。指す先はgit-bash.exeではなく、bash.exeかsh.exeという名前のファイルです。

WindowsにCodex CLIをインストールする

OpenAIのWindowsページの方針は明確です。基本はWindowsサンドボックス付きのネイティブ版Codex、ツールがすでにLinux上にあるならWSL。古い情報が1つだけあり、GitHubリポジトリのインストールページには今も「Windows 11 via WSL2」とあります。公式ドキュメントもインストーラーも更新済みです。

方法コマンド
PowerShellインストーラーpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm install -g @openai/codex

手軽なのはPowerShellインストーラーです。スクリプトを読むと、Codexを%LOCALAPPDATA%\Programs\OpenAI\Codex\binにインストールし、そのフォルダーをユーザーのPATHと現在のセッションに追加して、新しいPowerShellウィンドウを開くよう案内することがわかります。同じコマンドを再実行すればCodexが更新されます。npmも、インストールコマンドの再実行で更新します。

続いてサインインします。codexを実行してSign in with ChatGPTを選ぶか、codex loginを実行します。ブラウザーのないマシンでは、codex login --device-authのコードを別のデバイスで入力します。codex login statusで、どのアカウントでサインインしているかがわかります。

Windowsサンドボックス

Windows版のCodexには3つのサンドボックス実装があります。

  • mxc:推奨の実装で、管理者による設定は不要です。Windows 11 24H2(ビルド26100.9278)か25H2(ビルド26200.9278)が必要です。
  • elevated:推奨される代替手段です。管理者が承認する初回だけのセットアップが必要です。
  • unelevated:ネットワークの分離が弱く、読み取り専用パスもありません。

選択はconfig.tomlで行います。

[features]
prefer_mxc = true

[windows]
sandbox = "elevated" # or "unelevated"

サンドボックスがエラー1385で失敗するのは、Windowsがサンドボックス用アカウントのログオンの種類を拒否したためです。OpenAIはその場合CODEX_HOME/.sandbox/sandbox.logを求めます。.sandbox-secrets/の中身は絶対に共有しないでください。

ネイティブWindowsかWSLか

ネイティブ(PowerShell、CMD)WSL 2
Claude Codeのインストールirm https://claude.ai/install.ps1 | iexWSL内でcurl -fsSL https://claude.ai/install.sh | bash
CodexのインストールPowerShellインストーラーWSL内でcurl -fsSL https://chatgpt.com/codex/install.sh | sh
Claude Codeのサンドボックス使えない使える(bubblewrapとsocatが必要)
CodexのサンドボックスWindowsサンドボックスLinuxサンドボックス
リポジトリの置き場所どこでもよい/mnt/c/ではなく~/の下

どのみちLinuxでビルドして動かすプロジェクトか、Claude Codeが実行するコマンドをサンドボックス化したいならWSL 2を。.NET、PowerShellスクリプト、Windowsのパスだらけの、Windowsのプロジェクトならネイティブのままで。

WSLを使うなら3つのルールがあります。

  1. WSL 2を使い、WSL 1は使わない。 Codexはバージョン0.115でWSL 1のサポートを終了しました。Claude CodeのサンドボックスはSandboxing requires WSL2でWSL 1を拒否し、WSL 1でのインストールはExec format errorで失敗することがあります。ディストリビューションはwsl --set-version <DistroName> 2で変換します。
  2. インストールも実行もWSLの中で。 Linux用のコマンドはPowerShellではなくWSLのターミナルで。exec: node: not foundは、WSLからWindows側のNode.jsを呼ぶと出ます。Node.jsはディストリビューション自体にパッケージマネージャーかnvmで入れてください。
  3. コードはLinuxのファイルシステムに置く。 両ベンダーとも、リポジトリを/mnt/c/の外に置くよう勧めています。Anthropicによれば、そこではClaude Codeの検索が不完全になります。Linuxのホームの下にクローンしてください。

「claudeが認識されない」とその他のエラー

表示原因対処
'claude' is not recognized as an internal or external command(CMD)、The term 'claude' is not recognized(PowerShell)%USERPROFILE%\.local\binがPATHにないユーザーのPATHに追加し(コマンドは下記)、新しいターミナルを開く
追加してもまだ認識されないターミナルか、それを含むエディターが変更前に起動していたターミナル(エディター内ならエディターも)を開き直す
更新の直後に認識されない入れ替え中に中断された更新でclaude.exeが消えた最新のclaude.exe.old.*をclaude.exeに戻す(コマンドは下記)
'irm' is not recognizedPowerShell用の行をCMDに貼り付けたPowerShellを開くか、CMD用の行を使う
The token '&&' is not a valid statement separatorCMD用の行をWindows PowerShellに貼り付けたPowerShell用の行を使う
npm.ps1 cannot be loaded because running scripts is disabled on this system実行ポリシーがnpmのPowerShellラッパーをブロックしているSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser、またはnpm.cmdを呼ぶ
64ビットPCなのに32ビットWindowsに関するエラースタートメニューから「Windows PowerShell (x86)」を開いた通常の64ビット版PowerShellを開く
claudeでCLIではなくデスクトップアプリが開く古いClaudeデスクトップアプリがWindowsAppsに置いたClaude.exeがPATH上でCLIより前にあるClaudeデスクトップアプリを更新する
requires either Git for Windows (for bash) or PowerShellClaude Codeがどちらのシェルも見つけられないGit for Windowsを入れるか、PowerShellがPATHにあるか確かめる
npm install中にEBADENGINENode.jsが22より古いNode.jsを更新するか、ネイティブインストーラーを使う

PATHの修正(PowerShell、現在のユーザー、管理者権限不要):

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

変更する前に、Windowsがどこを探しているかを確認するには:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude

壊れた更新のあとの名前の戻し方:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

実行ポリシーについて:Windowsに付属するWindows PowerShell 5.1は、クライアントPCでは既定でRestrictedです。買ったばかりのノートPCがnpm.ps1をブロックするのはこのためです。CurrentUserスコープは管理者権限不要です。ネイティブのClaudeインストーラーとCodexのインストーラーは影響を受けません。irm | iexと-ExecutionPolicy ByPassは、ディスクからスクリプトファイルを読み込まないからです。

更新とアンインストール

Claude CodeCodex CLI
今すぐ更新claude update(ネイティブ)、winget upgrade Anthropic.ClaudeCode、またはnpmで再インストール対応リリースではcodex update、PowerShellインストーラーの再実行、またはnpm install -g @openai/codex
自動更新ネイティブ版のみ、DISABLE_AUTOUPDATER=1で無効化記載なし
アンインストール%USERPROFILE%\.local\bin\claude.exeと%USERPROFILE%\.local\share\claudeを削除、またはwinget uninstall Anthropic.ClaudeCode、またはnpm uninstall -g @anthropic-ai/claude-codeインストールフォルダーを削除、またはnpm uninstall -g @openai/codex
残る設定%USERPROFILE%\.claudeと%USERPROFILE%\.claude.json%USERPROFILE%\.codex

WindowsでエージェントCLIを動かして学んだこと

AgentsRoomはClaude Code、CodexなどのエージェントCLIを並べて起動します。そのWindows版で、こうしたインストールがターミナルの外のどこで壊れるかを学びました。アプリを使わない人にも役立つ4点です。

スタートメニューから起動したプログラムは、起動時のPATHを持ち続けます。 Claude Codeを入れて.local\binをPATHに足しても、開いていたデスクトップアプリはclaudeを見つけられません。CLIを代わりに起動するアプリでは、ターミナルの再起動では足りません。AgentsRoomはCLIを探すたびにユーザーとマシンのPATHをレジストリから読み直すので、成功したばかりのインストールが「見つからない」とはなりません。

npmは.exeをインストールしません。 npm install -g @openai/codexは%APPDATA%\npmにcodex、codex.cmd、codex.ps1の3ファイルを書き込みます。codexを直接起動するプログラムはspawn codex ENOENTを受け取ります。Windowsは拡張子のない名前に.exeしか補わないからです。PowerShellとCMDはPATHEXTを読むため、ターミナルでは見えません。実行ファイルを置くネイティブインストーラーを選ぶ理由がここにもあります。

npmのラッパーは実行時にNode.jsを必要とします。 同じセッションでNode.jsとCLIを続けて入れると、Node.jsがPATHに入る前に起動したプログラムでは、.cmdのラッパーは見つかっても「node is not recognized」で失敗します。ラッパーが非アクティブなバージョンを指すNodeのバージョンマネージャーでも同じです。

Windowsではプロセスの起動がずっと高くつきます。 プロセスの作成は、計測でWindowsが20から80 ms、macOSが1から3 msでした。アンチウイルスの検査で、ファイル確認1回ごとのコストも上がります。初期のCLI検出は全フォルダー、名前、拡張子を試し、Windowsではアプリが最大1秒固まりました。各フォルダーを1回だけ読むことで解決しました。

アプリでは、セットアップアシスタントが足りないCLIをOSに合ったベンダー公式インストーラーで入れます(Claude Codeはirm https://claude.ai/install.ps1 | iex、CodexはOpenAIのスクリプト)。スクリプトが失敗したらnpmに切り替え、様子を見られるターミナルで実行します。CLIが起動しないときは、CLI Doctorがエラーと実際のコマンドを読み取り、何が壊れたかを教えます。両方のCLIが--versionに応答したら、続きはスタートガイドへ。アプリがWindowsで何をするかはWindows版のリリース記事にあります。

よくある質問

WindowsにClaude Codeをインストールするには?

PowerShellを開いてirm https://claude.ai/install.ps1 | iexを実行します。CMDならAnthropicのセットアップページのinstall.cmdの行、WinGetならwinget install Anthropic.ClaudeCodeを実行します。バイナリは%USERPROFILE%\.local\binに置かれますが、インストーラーはこのフォルダーをPATHに追加しません。claudeが認識されなければ自分で追加し、新しいターミナルを開いてclaude --versionを実行してください。

WindowsでClaude CodeやCodexを使うのにWSLは必要ですか?

いいえ。どちらもWindows 10と11のPowerShellやCMDでネイティブに動きます。WSL 2が役立つのは、プロジェクトがすでにLinux上にあるときと、ネイティブWindowsでは動かないClaude Codeのサンドボックスを使いたいときです。WSL 1ではなくWSL 2を。CodexはWSL 1のサポートを0.115で終了しました。

インストールした直後なのに、Windowsが'claude'を認識しないのはなぜですか?

ネイティブインストーラーはclaude.exeを%USERPROFILE%\.local\binに置き、そこがPATHになければ警告しますが、PATH自体は変えません。フォルダーをユーザーのPATHに追加し、ターミナル(エディター内ならエディターも)を開き直してください。開いていたターミナルは古いPATHのままです。

Claude CodeにGit for Windowsは必要ですか?

もう不要です。AnthropicのセットアップページでGit for Windowsはオプションです。なければClaude CodeはPowerShellをシェルツールにします。あれば、Claude CodeはC:\Program Files\GitのGit Bashを見つけます。別のbash.exeはCLAUDE_CODE_GIT_BASH_PATH設定で指定できます。

Node.jsなしでWindowsにCodex CLIをインストールできますか?

できます。OpenAIのPowerShellインストーラーは単体のCodexを取得し、%LOCALAPPDATA%\Programs\OpenAI\Codex\binに置いて、そのフォルダーをユーザーのPATHに追加します。Node.jsが必要なのはnpm経由(npm install -g @openai/codex)だけです。

インストールにはPowerShellとCMDのどちらを使えばいいですか?

PowerShellです。公式のワンライナーはどちらもPowerShell用で、よくあるエラーの多くはPowerShellの行をCMDに貼ったか、その逆が原因です。'irm' is not recognized(日本語版Windowsでは「'irm' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。」)と出たらCMD、'&&' is not a valid statement separatorと出たらPowerShellにいます。スタートメニューの「Windows PowerShell (x86)」ではなく、64ビット版のPowerShellを使ってください。

DevOpsエンジニアライターフロントエンド開発者営業担当バックエンド開発者コーチ・トレーナーソフトウェアアーキテクト法務担当QAエンジニア財務・総務フルスタック開発者クリエイティブデザイナーモバイル開発者リサーチャーセキュリティエンジニア人事・採用
プロジェクトマネージャー翻訳者GitエキスパートデータアナリストSEOスペシャリスト経理担当ローカリゼーションスペシャリスト広報・PRブレインストーマーオペレーション・物流マーケティングスペシャリストカスタマーサポートプロジェクトアシスタント購買担当コミュニティマネージャーパーソナルアシスタント

AgentsRoomをダウンロード

すべてのAIエージェントを、すべてのプロジェクトで、ひとつのウィンドウから実行。

AgentsRoomをダウンロード無料

コンパニオンアプリ:外出先でもエージェントを確認

Claude、Codex、Antigravity CLI、またはその他の AI プロバイダーを使用します。

拡張機能を入手
Chrome Web Store

バグや要望を公開バックログに直接送信できます。

会話のように読めるエージェント

各エージェントには役割と顔があり、メッセージアプリのようにスレッドを読めます。

会話ビュー

AgentsRoomの会話ビュー。AIコーディングエージェントの作業がチャットのスレッドで表示されている
マルチプロジェクト
マルチプロバイダー
マルチエージェント
ライブステータス
ファイル差分
モバイルアプリ
ライブプレビュー
エージェントチーム
ブラウザテスト
バックログ駆動開発
プロンプトライブラリ
スキルライブラリ
すべての機能を見る

続きを読む