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 Code | Codex CLI | |
|---|---|---|
| Windowsのバージョン | Windows 10 1809以降、Windows Server 2019以降 | Windows 11推奨、最近のWindows 10は「ベストエフォート」 |
| プロセッサー | x64かARM64、32ビットは不可 | x64かARM64 |
| アカウント | 有料のClaudeプランかConsoleアカウント | ChatGPTプランかOpenAIのAPIキー |
| Node.js | npm経由のみ、バージョン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 |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget 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" |
| npm | npm 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 | iex | WSL内で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つのルールがあります。
- 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で変換します。 - インストールも実行もWSLの中で。 Linux用のコマンドはPowerShellではなくWSLのターミナルで。
exec: node: not foundは、WSLからWindows側のNode.jsを呼ぶと出ます。Node.jsはディストリビューション自体にパッケージマネージャーかnvmで入れてください。 - コードは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 recognized | PowerShell用の行をCMDに貼り付けた | PowerShellを開くか、CMD用の行を使う |
The token '&&' is not a valid statement separator | CMD用の行を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 PowerShell | Claude Codeがどちらのシェルも見つけられない | Git for Windowsを入れるか、PowerShellがPATHにあるか確かめる |
npm install中にEBADENGINE | Node.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 Code | Codex 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を使ってください。
AgentsRoomをダウンロード
すべてのAIエージェントを、すべてのプロジェクトで、ひとつのウィンドウから実行。
コンパニオンアプリ:外出先でもエージェントを確認
Claude、Codex、Antigravity CLI、またはその他の AI プロバイダーを使用します。
バグや要望を公開バックログに直接送信できます。
続きを読む
Codex、OpenCode、Antigravity、Claude Code の音声モード:どの CLI にあるのか?
2026年10月13日に、5 つのコーディングエージェント CLI と 2 つのアプリを確認しました。Codex CLI と oh-my-pi は音声で会話でき、Claude Code と Antigravity CLI はプロンプトへのディクテーションだけ、OpenCode には何も組み込まれていません。それぞれの起動方法、音声がどこへ送られるか、そして音声がトークンでいくらかかるかを解説します。
記事を読むClaude Code vs Codex CLI : 2026年にどちらを選ぶか(そして両方使うべき理由)
Claude Code と Codex CLI を正直に比較。料金、速度、MCP、コントロール性。そして数週間使った末に、私が片方を選ぶのをやめた理由。
記事を読むGit コミットから Co-Authored-By Claude を削除する方法
Claude Code はコミットに Co-Authored-By トレーラーを、プルリクエストに Generated with Claude Code の 1 行を付けます。それを消す設定、その設定を置くファイル、すでにプッシュしたコミットをきれいにする方法を解説します。
記事を読む
