CodexインストールWindows版｜CLIとアプリの手順・確認

Codex インストール Windowsで最初に決めること

CodexをWindowsへ入れるときに迷いやすいのは、同じ「Codex」という名前で、実行場所の異なる3つの方法が案内されている点です。PowerShellから使うCLIは、現在開いているフォルダーを作業場所として、ファイルを読み、必要に応じて編集し、ローカルの開発用コマンドを呼び出します。ChatGPTデスクトップのCodexは画面からプロジェクトや会話を扱う入口です。WSL2はWindows上にLinux環境を用意し、その中のツールやパスを使う方法です。

この3つは優劣ではなく、プロジェクトの置き場所と使いたいツールで選びます。Windows側のPowerShellで作業するのにWSL2用のコマンドを入れると、版番号は合っていても別の場所の実行ファイルを呼ぶことがあります。反対に、Linux側のプロジェクトを扱うのにWindows側の実行ファイルを前提にすると、パスや権限の確認が複雑になります。導入前に「どの画面から起動するか」「プロジェクトはCドライブ側かLinux側か」「必要なコマンドはどちらにあるか」を決めると、後の切り分けが短くなります。

導入前にWindowsの状態を確認する

Step 1: Windowsの版とCPUを確認する

まずWindowsの版を確認します。OpenAIのWindows公式ドキュメントではWindows 11が推奨され、更新済みのWindows 10は動作する場合があるものの、コンソール機能などの条件によって安定性が変わると説明されています。会社や学校の管理下にあるPCでは、管理者の方針によって導入や権限境界の設定が止まることもあるため、個人PCと同じ前提で判断しません。

CPUの種類も見ます。OpenAIの公式インストーラーは64ビットWindowsを前提とし、x64とARM64を判別して対応するファイルを選びます。32ビット環境では導入を続けられません。PowerShellで次を実行し、OSの種類、CPUアーキテクチャ、PowerShellの場所を記録しておくと、問い合わせや再導入のときに役立ちます。

$PSVersionTable.PSVersion
[System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture
Get-Command powershell

Windows 11であっても、PowerShellを開いた場所と、実際にプロジェクトを置いた場所が一致しているとは限りません。エクスプローラーで開いたフォルダーのアドレスを確認し、後でGet-Locationを実行して同じ場所か比べます。特にC:\Users\名前\プロジェクトと\\wsl.localhost\Ubuntu\home\名前\プロジェクトは見た目が似ていても、扱う実行環境が異なります。

Step 2: CLI・アプリ・WSL2の入口を選ぶ

ターミナル中心ならCLIを選びます。CLIはPowerShellからcodexを呼び出すため、導入後のPATH確認が重要です。画面中心ならChatGPTデスクトップのCodexを選びます。2026年のOpenAI案内では、以前のCodexアプリを更新すると新しいChatGPTデスクトップになり、その中からCodexを開けると説明されています。Linux用のパッケージやシェルを使うプロジェクトなら、WSL2の中でLinux版CLIを導入します。

この段階で、複数の方法を一度に入れる必要はありません。最初の一台ではCLIだけを入れて版番号と簡単な読み取り確認を済ませ、その後にアプリやWSL2を追加すると、どの入口で問題が起きたかを判断しやすくなります。アプリを入れたことはCLIのcodexコマンドが使える証明ではなく、WSL2を有効にしたこともLinux側のCLIが入った証明ではありません。

PowerShellからCodex CLIをインストールする

Step 3: 公式インストーラーを実行する

WindowsのPowerShellでCodex CLIを入れる公式の入口は、OpenAI CodexリポジトリのREADMEに記載されたinstall.ps1です。管理者としてPowerShellを開くことを最初から必須にするのではなく、通常のPowerShellで公式コマンドを実行し、途中でWindowsの権限確認が表示された場合だけ内容を確かめます。コマンドは次のとおりです。

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

このコマンドは、公式の導入用URLからWindows向けのCLIを取得して設定します。参照先はOpenAI Codex公式のinstall.ps1で確認できます。実行時には、検出したCPU、解決した版番号、取得したファイル、PATHの更新結果が表示されます。表示が途中で止まった場合は、すぐに同じコマンドを繰り返さず、止まった行、PowerShellの版、通信を制限するソフトの有無を控えます。

組織のルールでURLから直接実行する形式が認められていない場合は、まずファイルとして保存して内容を確認し、その後に実行する方法があります。保存先は一時フォルダーなど、用途を限定した場所にします。

$installerPath = Join-Path $env:TEMP "codex-install.ps1"
Invoke-WebRequest -Uri "https://chatgpt.com/codex/install.ps1" -OutFile $installerPath
Get-Content -LiteralPath $installerPath -TotalCount 80
powershell -ExecutionPolicy Bypass -File $installerPath

表示されたURLがchatgpt.com/codex/install.ps1であること、保存したファイルが意図した場所にあることを確認します。公式READMEと公式スクリプトの内容が将来更新される可能性もあるので、古いブログの固定コマンドをそのまま使わず、毎回公式ページから入口をたどるのが安全です。

Step 4: PATHと版番号を確認する

インストーラーが成功したという表示だけで終わらせず、新しいPowerShellを開いてコマンドの解決先を確認します。現在のウィンドウに古いPATHが残っていると、導入直後だけcodexが見つからないことがあります。次の3つを実行し、版番号、実行ファイルの場所、同名コマンドの候補をそれぞれ記録します。

codex --version
Get-Command codex | Format-List Name,CommandType,Source,Version
where.exe codex

OpenAIのWindowsインストーラーは、既定ではユーザー領域の%LOCALAPPDATA%\Programs\OpenAI\Codex\binを見える実行場所として扱い、内部のパッケージをユーザーの.codex領域に保持します。ここは自分で推測したフォルダーへファイルをコピーするのではなく、Get-Command codexのSourceを確認するための目安として使います。出力が複数行になる場合は、PATHの先にあるものが実行されるため、npmなどで以前に入れたCLIが残っていないかも確認します。

版番号が0.150.1なら、2026年8月29日時点の公式Releasesページにある安定版と一致します。別の番号でも直ちに失敗とは限りませんが、公式の安定版か先行版か、どのチャンネルから取得したかを分けて記録します。where.exe codexが何も返さないときは、まず新しいPowerShellを開き、それでも見つからなければインストーラーの完了表示とPATHの更新結果を見直します。

初回起動とWindowsの権限境界を確認する

Step 5: ChatGPTでサインインしプロジェクトを開く

CLIが見つかったら、変更を加えてもよいプロジェクトのフォルダーへ移動してから起動します。OpenAIの公式READMEでは、初回にcodexを実行し、ChatGPTでサインインするか、利用できる別のサインイン方法を選ぶ流れが案内されています。サインイン前に、個人用と組織用のアカウントを取り違えていないか、対象フォルダーに本当に移動しているかを確認します。

Set-Location "C:\Users\名前\source\sample-app"
Get-Location
codex

最初の依頼は、変更を求める内容ではなく読み取りだけにします。たとえば「現在のフォルダー構成と主要な設定ファイルを説明し、ファイルは変更しないでください」と依頼し、返答に対象場所が正しく反映されているかを見ます。ここで起動、サインイン、フォルダー認識の3点を分けて確認できれば、インストール失敗とプロジェクト側の問題を混同しにくくなります。

Step 6: サンドボックスの動作と許可範囲を確認する

WindowsネイティブでCodexを使うと、コマンドの実行にはWindows側のサンドボックスが関わります。OpenAIの公式ドキュメントでは、elevatedを優先的な方式、unelevatedを管理者による設定が難しい場合の代替方式として説明しています。名前だけで選ばず、作業フォルダーの読み取り、書き込み可能な範囲、外部接続の扱い、追加の許可を求められた場面を確認します。

設定ファイルで方式を指定する場合の形は次のとおりです。実際に変更する前に、現在の設定を別の場所へ控え、PCの管理方針に反しないことを確認します。

[windows]
sandbox = "elevated"

elevatedの準備が通らないからといって、いきなり制限を外すのは避けます。管理者の確認が必要なPCでは、表示された理由を記録し、利用できるならunelevatedで一時的に進めるか、WSL2を使うかを判断します。公式のWindows sandbox案内には、Windowsの版、管理者による設定、サンドボックスログの確認順も掲載されています。

Windows版Codexアプリをインストールする場合

Step 7: 公式ダウンロードページからアプリを入れる

画面でCodexを使いたい場合は、OpenAIの公式デスクトップダウンロードページからWindows版を選びます。OpenAIは2026年3月4日にCodexアプリのWindows対応を案内しました。その後の公式ヘルプでは、既存のCodexアプリを更新するとChatGPTデスクトップへ切り替わり、その画面からCodexを開けると説明されています。したがって、古い記事にあるアプリ名だけを頼りにせず、現在のダウンロード画面と表示されるアプリ名を確認します。

アプリの導入後は、画面左上などの製品切り替えからCodexを開き、対象プロジェクトを登録します。アプリが起動できること、プロジェクトを表示できること、ターミナルからcodexが実行できることは別の確認です。画面のCodexだけを使うならCLIを必ず追加する必要はありませんが、PowerShellの既存フォルダーからCLIを呼びたいなら、前章のCLI導入と版番号確認を別に行います。

CLIとアプリの違いを確認する

CLIは起動したターミナルの現在地と、そこから参照できる開発用ツールを基準にします。アプリはプロジェクト選択や会話表示を画面から行いやすく、複数の作業場所を見比べるときに向いています。片方で作った設定や会話が、もう片方のすべての画面に同じ形で表示されるとは限りません。特に版番号、サインイン先、作業場所、権限方式を入口ごとに控えると、アプリの更新後にCLIが変わったように見える現象を追いやすくなります。

WSL2でCodexを使う場合の導入

Step 8: WSL2の状態と実行場所をそろえる

Linux用のパッケージ、シェル、コンパイラーを中心に開発するなら、WSL2の中でCodex CLIを使います。まずWindows側でWSL2の状態を確認します。

wsl --status
wsl --list --verbose

一覧で対象ディストリビューションがVERSION 2になっていることを確認し、起動後はLinux側のターミナルで作業フォルダーへ移動します。WSL2内でCLIを導入する場合、OpenAI Codex公式READMEにあるLinux向けのコマンドを使えます。

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

Windows側のPowerShellで実行したinstall.ps1と、WSL2側で実行したinstall.shは、同じ版番号に見えても別の実行ファイルです。Windows側でwhere.exe codex、Linux側でcommand -v codexを確認し、プロジェクトのパスと同じ側のコマンドを使います。Linux側で/mnt/c/...にあるWindowsプロジェクトを扱う場合は、ファイルアクセスの速度や権限の違いも確認してから本格的な編集を依頼します。

Windows側とLinux側のCodexを混同しない

WSL2を使うかどうかは、単にターミナルの見た目で判断しません。PowerShellなら$env:OSやGet-Location、Linuxならuname -aやpwdを確認します。VS Codeなどのエディターから起動する場合も、エディターのウィンドウがWindows側のフォルダーを開いているのか、WSL2側のフォルダーを開いているのかを確認します。

問題が起きたときは、Windows側とLinux側の両方で、版番号、解決先、現在地を1行ずつ記録します。Windows側だけ更新した後にLinux側のCLIまで変わったと考えたり、アプリの設定を変更した後にPowerShellのPATHが更新されたと考えたりしないことが重要です。二つの環境を併用する場合は、起動したシェルの種類を依頼の冒頭に書いておくと、結果の読み違いを減らせます。

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

Step 9: 読み取りだけの確認を行う

インストール後は、いきなり大きな修正を頼まず、CLIが正しいフォルダーを見ているかを確認します。まず版番号と診断情報を見ます。

codex --version
codex doctor --summary

次に、プロジェクトの構成を説明するだけの依頼を行います。変更を作らない条件を明記し、返答に現在地、主要なファイル、検出された開発用ツールが含まれているかを確認します。ここで読み取りができても、書き込みやテスト実行まで成功するとは限りません。読み取り、ファイル変更、ローカルコマンド、外部接続を別々の確認項目に分けると、どの境界で止まったかが分かります。

作業場所の確認には、Codexの画面だけでなくPowerShellでもGet-Locationを使います。Git管理されたプロジェクトなら、依頼前後にgit status --shortを確認し、意図しないファイルが変わっていないことを見ます。変更を依頼する場合も、最初は1ファイルまたは1つの小さな目的に絞り、差分を読んでから次へ進みます。

Step 10: 安定版と先行版を分けて記録する

公式Releasesページでは、安定版の0.150.1の後ろに0.151.0-alpha系の先行版が並んでいます。先行版には新しい修正が含まれる場合がありますが、通常利用の導入確認では、安定版と混ぜて評価しません。公式のCodex Releases一覧で、タグ名にalphaが付いていないか、Latestの表示がどの版かを確認します。

版番号を記録するときは、番号だけでなく実行場所も添えます。たとえば「Windows PowerShellの0.150.1」「Ubuntu-WSL2の0.150.1」「ChatGPTデスクトップの表示版」のように分けると、同じ番号でも異なる問題をまとめずに済みます。更新後に挙動が変わった場合は、更新前の版、更新日時、問題が起きた入口、実行した依頼を並べて比較します。

Windowsで多い問題と解決の順番

Step 11: codexが見つからない場合

「codexは認識されません」と表示されたら、まずPowerShellを閉じて新しく開きます。次にGet-Command codexとwhere.exe codexを実行し、何も返らなければインストーラーの完了表示、CPU判定、PATH更新の行を確認します。インストール先を手作業でPATHへ追加する前に、既存のnpm版や別フォルダーのCLIが残っていないかを調べます。

同じ名前のコマンドが複数見つかった場合は、いちばん上の行だけを見て判断しません。where.exe codexの全行を控え、Get-Command codex | Format-List *で現在選ばれている実体を確認します。以前のCLIを残したまま公式インストーラーを実行すると、PATHの順番によって古い版が起動することがあります。削除や入れ替えは、どのプロジェクトがその版を使っているかを確認してから行います。

Step 12: 実行ポリシーや権限で止まる場合

PowerShellの実行ポリシーで公式導入コマンドが拒否された場合、PC全体のポリシーを無理に変更しません。現在の状態をGet-ExecutionPolicy -Listで確認し、管理対象PCなら管理者へ相談します。公式READMEにある-ExecutionPolicy ByPassは、そのコマンドの実行時に使う指定であり、PC全体の設定を変更する指示とは分けて考えます。

Windowsネイティブのサンドボックス準備で権限エラーが出る場合は、CLIの導入成功とサンドボックスの準備失敗を分けます。codex --versionが返るなら、実行ファイルの導入は進んでいます。次にWindowsの版、管理者による設定の可否、対象フォルダーの場所、エラー表示を確認し、公式Windowsドキュメントの案内に沿ってelevatedの再試行、unelevatedの検討、WSL2への切り替えを判断します。

Step 13: 途中で止まったり結果が違ったりする場合

インストーラーの通信が途中で止まった、CLIは起動するがプロジェクトを読めない、読み取りはできるがファイル変更で止まる、という3つは別の問題です。最初にエラー文を短く保存し、版番号、実行場所、現在地、サインイン状態、サンドボックス方式を対応づけます。複数の設定を同時に変えると原因が分からなくなるため、確認は一つずつ行います。

公式のインストーラーは導入済みのCodexを検出し、既存の管理方法がある場合に扱いを尋ねることがあります。すでにnpmなどで導入している場合は、その場で削除を選ぶ前に、現在の実行先と利用中の版を記録します。再導入後に問題が消えたとしても、版の変更、PATHの変更、サンドボックスの再準備のどれが効いたのかを分けて確認します。

2026年8月29日時点で確認した公式情報

今回の導入手順で時事情報として押さえる点は、Windows対応そのものより、入口と安定版の位置づけが更新されていることです。OpenAIはCodexアプリの紹介記事で、2026年3月4日の更新としてWindows対応を明記しています。Windowsで画面から使う道が整った一方、ターミナルから使うCLIは別に公式導入手順が用意されています。

さらに、2026年8月27日公開の0.150.1では、保持した画像を圧縮時の予算に含める修正が案内されています。これはWindows専用の変更ではありませんが、同じ時期にWindowsで導入する人が版番号を確認するきっかけになります。8月28日には0.151.0-alpha系も公開されているため、検証目的でない限り、安定版と先行版を明確に分けます。

アプリについては、OpenAIの公式ヘルプが、既存のCodexアプリを更新すると新しいChatGPTデスクトップになり、Codexの画面が残ることを案内しています。古い名称のインストール記事だけを見て判断せず、公式ダウンロードページで現在の案内を確認することが、Windowsでの導入を迷わせないポイントです。

まとめ

Codex インストール Windowsの要点は、CLI、ChatGPTデスクトップ、WSL2を同じものとして扱わないことです。PowerShellでCLIを入れるなら、公式READMEのinstall.ps1を使い、新しいPowerShellでcodex --version、Get-Command codex、where.exe codexを確認します。画面で使うなら公式ダウンロードページからアプリを入れ、CLIの導入結果と混ぜません。Linux用のツールを使うならWSL2内で導入し、Windows側とLinux側の版番号・実行場所を分けて記録します。

導入が終わる条件は、コマンドが見つかることだけではありません。現在地を正しく認識し、読み取りだけの確認ができ、変更時にはWindowsのサンドボックスと許可範囲を説明できることまでを一つの流れとして確認します。安定版0.150.1と先行版を分け、問題が出たときは版、入口、場所、権限を一つずつ切り分ければ、再インストールを繰り返さずに原因へ近づけます。

参照した公式URL

本文では、OpenAI Codexの公式README、Windows用公式ドキュメント、導入スクリプト、公式Releases、OpenAIのアプリ案内とヘルプを参照しました。導入前後で内容が変わる可能性があるため、実行時には次のページを直接確認してください。

• OpenAI Codex README
• Codex install.ps1
• Codex Windows sandbox
• Codex Releases
• Introducing the Codex app
• ChatGPT desktop download
• Moving to the new ChatGPT desktop app