Windows版Codexの使い方|アプリ版とCLIの違い・導入手順・プロキシ設定【2026年7月版】
Windows版のCodexは、2026年3月4日にMicrosoft Storeで一般提供が始まってから4か月で姿を変えました。2026年7月9日(米国時間)の更新でChatGPTとCodexが1つのデスクトップアプリに統合され、単体の「Codexアプリ」ではなく、ChatGPTデスクトップアプリの中のモードとして使う形になっています。この記事では、統合後の現在地、検索で最も多く問われる「アプリ版とCodex CLIの違い」、Windowsへの導入手順、WSLを使わずに動くサンドボックスの仕組み、企業プロキシ下での設定、そして2026年4月にトークン課金へ移行した料金とレート制限を、公式情報にもとづいて整理します。
まとめ:Windows版Codexの要点
- 提供形態:2026年3月4日にMicrosoft Store/WinGetでWindows版が一般提供開始。2026年7月9日(米国時間・日本時間10日)にmacOS版とともにChatGPTデスクトップアプリへ統合され、Chat/Work/Codexの3モードを1つのアプリで切り替える。既存のCodexアプリは通常どおり更新すれば新しいアプリになる。
- アプリ版とCLIの使い分け:複数エージェントを並列で走らせて差分をレビューキューで承認するのがアプリ版、単一リポジトリでターミナルから素早く回すのがCLI。アカウントと利用上限は共通なので、併用しても別料金にはならない。
- WSL:Windowsネイティブのサンドボックス(制限付きトークン・ファイルシステムACL・専用サンドボックスユーザー・ファイアウォール)で動くため必須ではない。エージェントの実行環境としてWSLも選べるが、Codex 0.115以降はWSL2のみ対応。
- 企業プロキシ:TLSインスペクション環境では
CODEX_CA_CERTIFICATEにPEMバンドルを指定する(未設定時はSSL_CERT_FILEにフォールバック)。サンドボックスの通信はfeatures.network_proxyで上流プロキシへチェーンできる一方、Codex本体のAPI通信をconfig.tomlのプロキシ設定で指定する機能は未実装のまま残っている。 - 料金:2026年4月2日にメッセージ単位からトークン(クレジット)単位の課金へ移行。上限は5時間のローリングウィンドウで管理される(週次の上限が別途かかる場合がある)。提供開始時の「レート制限2倍」は4月2日までの期間限定措置で、現在は適用されない。
Windows版Codexの現在地:単体アプリからChatGPTデスクトップアプリへの統合
Windows版Codexアプリは2026年3月4日に一般提供が始まりました。配布はMicrosoft Storeからのダウンロードに加えて、WinGetによるコマンドラインインストールにも対応しています。macOS版から約1か月遅れての提供でしたが、Windowsに固有のサンドボックス機構を伴っての登場でした。
状況が大きく動いたのは2026年7月9日(米国時間)です。OpenAIはChatGPTとCodexを1つのデスクトップアプリに統合し、macOS版とWindows版を同時に公開しました(日本時間では7月10日)。押さえておくべきなのは、Codexが廃止されたわけではなく、ChatGPTデスクトップアプリの中のモードになったという点です。アプリはChat(通常の対話)、Work(資料やスプレッドシートなどの成果物を作る業務向けエージェント)、Codex(コーディングエージェント)の3モードを切り替える構成で、Codexの機能はCodexモードに残っています。既存のCodexアプリは通常どおり更新すれば新しいアプリになり、入れ直しは不要です。3月以降に書かれた「Codexアプリを単体でインストールする」という手順は、この統合を前提に読み替えてください。
モデル面も動いています。提供開始直後はGPT-5.4を推奨としつつGPT-5.3-CodexやGPT-5.2-Codexが選べる構成でしたが、統合後はGPT-5.6系(Sol/Terra/Luna)が中心になり、ProプランではリサーチプレビューのGPT-5.3-Codex-Sparkも使えます。ラインナップは数か月単位で入れ替わるため、実際に選べるモデルはアプリのモデル選択画面と公式の料金ページで確認してください。Codexというプロダクト全体の位置づけから押さえたい場合は、Codexとは?OpenAIの自律型AIコーディングエージェントの使い方・料金・モデルを解説【2026年最新】が入口になります。
アプリ版CodexとCodex CLIの違いと使い分けの基準
Windows版Codexで最も多く検索されているのは、インストール手順ではなく「アプリ版とCLIはどう違うのか」です。両者は同じCodexの別インターフェースであり、能力の優劣ではなく作業スタイルの違いで選びます。
実行環境とUIの違い:worktree隔離の並列実行か、ターミナル常駐か
アプリ版は、複数のエージェントを同時に走らせることを前提に設計されています。左側のカラムでスレッドを並べ、それぞれのエージェントがGitのworktreeで隔離された作業領域を持つため、同じリポジトリに対する複数の変更が衝突しません。生成された差分はレビューキューに積まれ、人間が確認してから承認・修正指示・再開を出します。バグ修正・テスト追加・リファクタリングを別々のエージェントに委任し、自分は差分の判断だけを行う——という監督型の進め方に向いています。クラウド実行では1つのプロンプトに対して最大4通りの並列試行を走らせ、結果を比べることもできます。
CLIは逆に、いま開いているターミナルとカレントリポジトリに密着します。エディタとシェルを行き来する既存のワークフローを崩さずにエージェントを呼び出せるため、単一リポジトリで手を動かしながら進める作業では起動から着手までが最短です。CIやスクリプトからcodex execで非対話実行できるのもCLI側の領分で、これはアプリ版では代替できません。CLI単体の始め方や学習させない設定はCodex CLIとは|始め方・料金・コードを学習させない設定まで解説で詳しく扱っています。
アカウントと利用上限は共通、選択の分かれ目は「監督するか、手を動かすか」
アプリ版とCLIは同一アカウント・同一の利用枠を共有します。有料プランで一度サインインすれば、アプリ・CLI・IDE拡張・Web・クラウドのいずれからでも同じ枠を消費するため、「アプリを使うと別料金がかかる」という心配は要りません。片方に絞る必要はなく、タスクの性質で選べます。
| 観点 | アプリ版(Codexモード) | Codex CLI |
|---|---|---|
| 主な操作 | GUI・レビューキュー承認 | ターミナル対話 |
| 並列エージェント | 可(worktreeで隔離) | 基本は1セッション |
| 差分の確認 | アプリ内でdiff表示・介入 | ターミナル出力・エディタ |
| スケジュール実行 | Automationsで可 | タスクスケジューラ等と併用 |
| CI・非対話実行 | 不向き | codex execで可 |
| アカウント・上限 | 共通(同一プランの枠を共有) | |
判断の目安は明快です。同時に3つ以上のタスクを走らせて自分はレビューに回りたいならアプリ版、1つのリポジトリで対話しながら詰めたいならCLI。長時間の自律実行を任せて席を離れる使い方はアプリ版が前提の設計で、CLIで同じことをすると承認待ちで止まったセッションを見失います。逆に既存のシェルスクリプトやCIへ組み込む要件をアプリ版で満たそうとするのは筋が悪く、ここは素直にCLIです。CLIのセッションが増えて使用量が見えなくなってきたら、GUIで束ねるCodex Monitorとは?Codex CLIを束ねるデスクトップGUIの使い方・インストールと使用量監視も使えます。
Windowsへの導入手順:Microsoft Store版とCLI版
アプリ版:Microsoft StoreまたはWinGetから導入する
スタートメニューからMicrosoft Storeを開いて「ChatGPT」で検索し、インストールします。コマンドラインから入れる場合はWinGetを使います。
winget install Codex -s msstore
インストール後にアプリを起動し、ChatGPT(OpenAI)アカウントでサインインすると、作業対象のプロジェクトフォルダを登録する画面に進みます。ここで登録したディレクトリがエージェントの作業範囲になり、以降のスレッドはこのフォルダを基点に動きます。Git・Node.js・Python・.NET SDK・GitHub CLIを入れておくとレビューパネルやビルド実行が機能するため、開発機であれば先に揃えておくと初回から詰まりません。
初回で迷いやすいのは、サインインに使うアカウントとプランの対応です。CodexはChatGPTのプランに紐づくため、業務で使う組織のBusiness/Enterpriseアカウントと個人アカウントを取り違えると、利用上限も履歴も別枠になります。サインイン画面でアカウントを確認してから進めてください。エージェントに渡す前提(コーディング規約・ビルド手順・触ってほしくないディレクトリ)は、リポジトリ直下のAGENTS.mdに書いておくとアプリ版・CLIの双方で参照されます。
CLI版:WSLを介さずPowerShellから動かす
CLIはNode.js 22以上の環境があればnpmから導入できます。WindowsではPowerShellから直接実行でき、WSLを噛ませる必要はありません。パッケージ名をcodexとだけ指定すると別の無関係なパッケージが入るため、スコープ付きの名前で入れてください。
npm install -g @openai/codex
codex
初回起動でブラウザ認証が走り、ChatGPTアカウントと紐づきます。設定ファイルとセッションの状態は既定で~/.codex(Windowsではユーザープロファイル配下)に置かれ、CODEX_HOMEで変更できます。アプリ版とCLIは同じアカウントを見るため、片方でログインした認証情報をもう片方で使い回せます。macOSでの導入手順が必要な場合はOpenAI CodexをMacにインストールする方法|Apple Silicon・Intel対応のダウンロード手順とCLI(npm)を参照してください。
WindowsネイティブサンドボックスとWSLの扱い
「Codex app wsl」という検索が一定数あるのは、Windows上でエージェントを動かすなら仮想環境が要るのではないか、という懸念があるからです。結論としてWSLも仮想マシンも必須ではありません。Windows版Codexは、OSの標準機構を組み合わせた多層のサンドボックスでエージェントを隔離しています。
- 制限付きトークン:エージェントのプロセスを、ログインユーザーの権限をそのまま引き継がない制限された権限で起動する。
- ファイルシステムACL:アクセス制御リストで、エージェントが触れるディレクトリを登録済みのプロジェクト範囲に限定する。
- 専用サンドボックスユーザー:エージェント実行専用のユーザーアカウントを用意し、ユーザー本来の資格情報や個人フォルダと分離する。
- ファイアウォールルール:サンドボックス内からの通信経路を制御し、許可した宛先以外に出られないようにする。
この分離は管理者権限で動かす構成が既定で、権限が取れない環境では機能を落としたフォールバック構成になります。狙いは、PowerShellのコマンドをWSL越しではなく直接実行しながら、エージェントの暴走がユーザー領域全体へ波及しないようにすることです。ただし全アクセスを許可するモードを選べばこの防護は外れるため、業務リポジトリでは入力欄の承認設定を「承認を求める」にしておくのが前提になります。
一方で、開発環境がすでにWSL上に構築されている場合は、設定でエージェントの実行環境をWSLへ切り替えられます(切り替えにはアプリの再起動が必要)。つまり「WSLは不要」ですが「WSLは使えない」わけではありません。注意点として、WSL1のサポートはCodex 0.114までで、0.115以降はLinux側のサンドボックスがbubblewrapへ移行したためWSL2が必須です。Linuxツールチェーンに依存したビルドがある場合は、WSL2であることを確認したうえでWSL側を選んでください。
企業プロキシ・TLSインスペクション環境でのCodex設定
社内ネットワークからCodexを使おうとして最初につまずくのがここです。ZscalerやPalo AltoのようにTLSインスペクションを行うプロキシは、HTTPS通信を社内ルートCAで再署名します。CodexはそのCAを知らないため、サインインの時点で証明書検証に失敗します。プロキシを止めてもらう交渉に走る前に、Codex側へCAバンドルを教えてください。公式に用意されている環境変数は次の2つで、指定したCAはHTTPS通信・ログイン・WebSocket接続のいずれにも適用されます。
| 環境変数 | 役割 | 優先度 |
|---|---|---|
CODEX_CA_CERTIFICATE |
企業TLSインスペクション・プライベートルートCA用のPEMバンドルのパス | 高(優先) |
SSL_CERT_FILE |
上記が未設定のときに参照されるPEMバンドルのパス | フォールバック |
設定はログイン前に行います。PowerShellの$env:はそのセッション限りなので、恒久化するなら[Environment]::SetEnvironmentVariableかシステム環境変数に登録してください。
$env:CODEX_CA_CERTIFICATE = "C:\certs\corporate-root-ca.pem"
codex login
CODEX_CA_CERTIFICATEを先に見る設計になっているのは、同じマシンの他のツールに影響を与えずCodexだけCAを上書きできるようにするためです。すでに社内の配布ツールがSSL_CERT_FILEを設定済みなら、そのままでも通ることがあります。
プロキシ設定でつまずく人が多い理由は、Codexのプロキシ関連の設定が「サンドボックス内の通信」と「Codex本体のAPI通信」の2層に分かれていることが知られていないからです。ここを区別できると、どのIssueを追うべきかも見えてきます。
- サンドボックス内の通信:config.tomlの
features.network_proxy.proxy_url(既定はhttp://127.0.0.1:3128)でHTTPリスナーの宛先を指定でき、features.network_proxy.allow_upstream_proxy(既定true)で環境側の上流プロキシへチェーンできます。サンドボックス内のプロセスが社内プロキシ経由で外に出る経路は、この設定で扱います。 - Codex本体のAPI通信:config.tomlに
http_proxy相当の項目を設けてほしいという要望はGitHubのIssue #6060として提出されたままで、2026年7月時点で未実装です。ここはHTTPS_PROXYなどの環境変数を手で設定する、ドキュメント化されていない回避に頼ることになります。
もう1つ踏んでおきたい地雷は、サンドボックスから起動される子プロセスに環境変数が引き継がれないケースです。MCPのstdioサブプロセスでCA証明書とプロキシの環境変数が落ちる問題はIssue #29124として報告されており、Codex本体は接続できるのに、エージェントが呼び出したツールだけが証明書エラーで落ちる、という切り分けの難しい症状になります。config.tomlのshell_environment_policyで、サンドボックスへ渡す環境変数のホワイトリストにCA関連(CODEX_CA_CERTIFICATE/SSL_CERT_FILE/NODE_EXTRA_CA_CERTS/REQUESTS_CA_BUNDLE)を明示的に含めておくと、この失敗を避けられます。全社配布の前に、検証端末1台で「ログイン」「エージェントのタスク実行」「MCPツールの呼び出し」の3段階まで疎通を確認してから展開するのが安全です。
Windows版で使える主要機能:並列エージェント・Automations・Skills・コンピューター使用
並列エージェントとレビューキュー:スループットは上がるがレビュー負荷も上がる
アプリ版の中心機能です。プロンプトごとにスレッドが立ち、エージェントはそれぞれのworktreeで作業します。人間の仕事は差分の確認と承認へ寄り、コードを書く時間よりレビューする時間のほうが長くなります。並列化はスループットを上げますが、レビューの目を増やすわけではありません。3体走らせるなら3体分の差分を読む時間が要る——この前提を飛ばすと、動くけれども設計意図から外れたコードが静かに混入します。
AutomationsとSkills:定期実行とWinUIスキルの再利用
Automationsは、繰り返しのタスクをスケジュール実行し、実行のたびに独立したスレッドを作ります。日次のテスト実行やCI失敗のトリアージのように、人間が起点になる必要のない作業を寝かせておけます。Skillsは、プロジェクトをまたいで再利用できるタスクのテンプレートで、Windows版ではWinUIアプリのコードを生成するスキルのようにプラットフォーム固有のものも用意されています。エージェントの役割分担をさらに踏み込んで設計したい場合は、Codexサブエージェントの仕組みと従来の単一エージェント実行との根本的な違いで扱っている考え方が参考になります。
コンピューター使用とリモート接続:GUI操作の委任と提供地域の制限
2026年5月29日のv26.527で、Windows版に「コンピューター使用」が追加されました。Codexがデスクトップの画面を認識し、マウスのクリックやキーボード入力で最前面のアプリを直接操作します。コード編集の枠を越えて、GUIしか操作手段のないツールを含む作業まで委任できるようになった、というのが実務上の意味です。ただし提供対象はPlus・Pro・Enterpriseで、EEA・英国・スイスでは利用できません。同時にリモート接続も入り、iOS/AndroidのChatGPTアプリやmacOS版から自分のWindows機のCodexへ接続できます。外部から使うには接続設定で「このPCをスリープさせない」を有効にしておく必要があります。
料金とレート制限:2026年4月のトークン課金移行後の見方
ここは3月時点の解説と現在で最も食い違う部分です。2026年4月2日に、Codexの課金はメッセージ単位からAPIのトークン消費に沿った方式へ変更されました。提供開始時に告知されていた「Plus・Pro・Business・Enterprise・Eduのレート制限2倍」はこの4月2日までの期間限定キャンペーンで、現在は適用されません。古い記事の上限値をそのまま前提に見積もると外します。
2026年7月時点のプランは次のとおりです。上限は日次・月次ではなく5時間のローリングウィンドウで管理され、これとは別に週次の上限がかかる場合があります。同じ枠でも下位モデルのほうが多く回せます。
| プラン | 月額 | Codexの位置づけ |
|---|---|---|
| Free | 0ドル | 短いタスクでの試用 |
| Go | 8ドル | 軽量なコーディング用途 |
| Plus | 20ドル | Web・CLI・IDEを含む標準枠 |
| Pro | 100ドル〜 | Plusの5倍/20倍の上限。GPT-5.3-Codex-Sparkを利用可 |
| Business | 25ドル/ユーザー(年払い20ドル・2名〜) | 管理機能・SAML SSO付き |
| Enterprise・Edu | 個別見積 | 優先処理・企業向けセキュリティ |
費用対効果の判断で見るべきは月額そのものではなく、5時間ウィンドウの中で自分のタスクが何回入るかです。長時間の自律実行や並列エージェントは消費が大きく、Plusの枠は監督型の使い方を本格的に始めた途端に足りなくなります。かといって先に上位プランへ倒す必要はありません。まずPlusで実リポジトリに対する1〜2週間の検証を回し、ウィンドウ内で上限に当たる頻度を測ってからProへの移行を判断してください。料金とモデル別の消費係数は改定が続いているため、稟議に使う数字は公式の料金ページで最新値を確認する必要があります。
よくある質問
Codexアプリを更新したらChatGPTのアプリになりました。Codexはもう使えないのですか?
使えます。2026年7月の統合で、CodexアプリはChatGPTデスクトップアプリに一本化されました。アプリ内でChat・Work・Codexの3モードを切り替えられ、Codexの機能はCodexモードに残っています。アンインストールや再インストールは不要です。
Windows版CodexにWSLは必要ですか?
必要ありません。制限付きトークン・ファイルシステムACL・専用サンドボックスユーザー・ファイアウォールによるWindowsネイティブのサンドボックスで動作し、PowerShellのコマンドを直接実行できます。開発環境がWSL上にある場合は実行環境をWSLへ切り替えられますが、Codex 0.115以降はWSL2のみ対応です。
アプリ版とCodex CLIは、どちらを選ぶべきですか?
複数のタスクを並列で走らせて差分レビューに専念したいならアプリ版、単一リポジトリでターミナルから対話的に進めたい、あるいはCIから非対話で呼びたいならCLIです。アカウントと利用上限は共通なので、両方入れて場面ごとに使い分けても追加費用は発生しません。
会社のプロキシ環境でCodexにログインできません。
TLSインスペクションを行うプロキシが原因である可能性が高いです。社内ルートCAのPEMバンドルをCODEX_CA_CERTIFICATEに指定してからログインしてください(未設定時はSSL_CERT_FILEが参照されます)。サンドボックス内の通信はfeatures.network_proxyで上流プロキシへチェーンできますが、Codex本体のAPI通信をconfig.tomlで指定する項目は未実装のため、環境変数での設定になります。
無料プランでもWindows版Codexは使えますか?
Freeプランでも短いコーディングタスクの範囲で試せます。ただし5時間のローリングウィンドウで管理される上限は小さく、並列エージェントや長時間の自律実行を伴う使い方を評価するにはPlus以上が実質的な前提になります。