codex.exe とは？Windows 版の実体・場所・インストール方法

codex.exe とは — Codex CLI の Windows 用ネイティブバイナリ

codex.exe は、OpenAI のコーディングエージェント Codex をターミナルから使うためのツール「Codex CLI」の Windows 用実行ファイルだ。Codex CLI は Rust で実装されたネイティブバイナリとして配布されており、OS ごとにビルドが分かれている。macOS や Linux では拡張子のない実行ファイルになるのに対し、Windows では慣例どおり .exe 形式になる。それが codex.exe である。OpenAI の公式ドキュメントは Codex CLI を macOS / Windows / Linux でサポートすると明記しており、Windows では PowerShell からネイティブに実行する構成と、WSL2 で Linux 環境として動かす構成の両方が正規ルートだ(出典: https://developers.openai.com/codex/cli )。ネイティブ実行を選んだ場合にマシン上で動いているのが codex.exe で、WSL2 を選んだ場合は Linux 版バイナリが動く。同じ「codex コマンド」でも、どちらの実体が呼ばれているかは構成によって変わる点を押さえておきたい。

ChatGPT の Codex や旧 Codex モデルと混同しない

「codex」という名前は歴史的に複数の意味で使われてきたため、exe の話をするときは対象を限定しておく必要がある。本記事で扱う codex.exe は、ローカルのリポジトリを読み書きする Codex CLI の実行ファイルだけを指す。ブラウザで完結する Codex Cloud や ChatGPT 内の Codex にはローカルの実行ファイルが存在しないし、2021 年ごろの旧 Codex モデル(API 専用)もダウンロードして使うものではなかった。「codex.exe をダウンロードしたのに ChatGPT の画面が出ない」といった混乱は、この区別で解消できる。

codex.exe の入手方法 — npm と GitHub Releases の 2 ルート

codex.exe を手に入れる公式ルートは二つある。一つは Node.js のパッケージマネージャー npm で @openai/codex をインストールする方法、もう一つは GitHub の openai/codex リポジトリの Releases ページから Windows 向けバイナリを直接ダウンロードする方法だ(出典: https://github.com/openai/codex/releases )。npm ルートはバージョン管理と更新が楽で、既に Node.js を使っている開発者に向く。直接ダウンロードは Node.js を入れたくない環境や、配布物そのものを検証してから導入したい場合に向く。どちらで入れても実体は同じ Rust 製バイナリであり、機能差はない。以下では確実性の高い npm ルートを手順として示し、その後に直接ダウンロードの注意点を補足する。

Step 1: Node.js v20 以上を用意する

npm ルートの前提は Node.js v20 以上だ。PowerShell で node -v を実行し、バージョンが v20 未満または「認識されません」と出る場合は、Node.js 公式サイトから LTS 版をインストールする。既に WSL2 で開発している人は、Windows 側と WSL2 側のどちらに入れるかで codex の実体(exe か Linux バイナリか)が変わるため、普段作業する側に揃えるとよい。

Step 2: @openai/codex をグローバルインストールする

PowerShell で npm install -g @openai/codex を実行する。これで codex コマンドが使えるようになる。このとき npm のグローバル bin フォルダー(既定では %APPDATA%\npm)に起動用のシムが置かれ、プラットフォームに合ったネイティブバイナリがパッケージ内部に配置される。更新したいときは同じコマンドを再実行するか、npm update -g @openai/codex を使う。

Step 3: サインインして動作確認する

インストール後、PowerShell で codex を実行すると初回はサインインを求められる。ChatGPT アカウント(Plus / Pro / Business / Enterprise / Edu)でサインインすれば、プラン内の利用枠で Codex を使える(出典: https://developers.openai.com/codex/cli )。起動してバージョン表示や対話画面が出れば導入は完了だ。

GitHub Releases から直接ダウンロードする場合

openai/codex の Releases ページには、リリースごとにプラットフォーム別のバイナリが添付されており、Windows 向けには x86_64-pc-windows-msvc 版の codex.exe(zip 形式)が用意されている(出典: https://github.com/openai/codex/releases )。zip を展開して codex.exe を任意のフォルダーに置き、PATH を通せば npm なしで使える。この方式の注意点は更新が手動になることと、安定版(Latest)とプレリリース(alpha)が同じページに並ぶことだ。特段の理由がなければ Latest マークの付いた安定版を選ぶ。

codex.exe はどこにある？ — 置き場所と確認コマンド

「タスクマネージャーに codex.exe がいるが、どこから起動されたのか」を確認したい場面では、PowerShell で where.exe codex を実行するのが最短だ(PowerShell では where がエイリアスに取られるため where.exe と書く)。npm ルートで入れた場合、まず %APPDATA%\npm 配下の起動用シムが見つかり、実体のネイティブバイナリはグローバルの node_modules\@openai\codex パッケージ内部に配置される。直接ダウンロードで入れた場合は、自分で zip を展開したフォルダーがそのまま置き場所になる。逆に、身に覚えのない場所(一時フォルダーや他アプリのフォルダーの奥など)に codex.exe を名乗るファイルがある場合は、後述の安全性の観点で配布元を確かめたほうがよい。ファイルの出どころは、プロパティのデジタル署名や、入手時の URL が openai 公式(npmjs.com の @openai/codex または github.com/openai/codex)かどうかで判断する。

codex.exe は安全か — 配布元とウイルス誤検知の考え方

結論から言えば、公式ルートで入手した codex.exe は OpenAI がオープンソースで開発・配布している正規のツールであり、ソースコードも openai/codex リポジトリで公開されている(出典: https://github.com/openai/codex )。一方で、知名度のあるツール名を騙った偽配布は世の常なので、「codex.exe ダウンロード」で出てくる非公式のダウンロードサイトからは入手しないことが大原則だ。また、新しめのリリース直後は、セキュリティソフトや SmartScreen が「一般的にダウンロードされていないファイル」として警告を出すことがある。これは未知のバイナリに対する一般的な反応であり、入手元が公式であれば過度に恐れる必要はないが、判断に迷う場合はハッシュ値の照合や、npm ルートへの切り替えで回避できる。加えて Codex CLI 自体が、コマンド実行を承認制にするサンドボックス機構を備えている点も安心材料になる。エージェントに任せる操作の範囲を段階的に広げられる設計だ(出典: https://developers.openai.com/codex/cli )。

codex.exe が動かないときの確認ポイント

導入したのに codex が起動しない場合、原因はほぼ環境側にある。切り分けは次の順で行うとよい。

1. where.exe codex でコマンドの解決先を確認する。何も出ない場合は PATH に npm のグローバル bin(%APPDATA%\npm)が含まれているかを見る。
2. node -v で Node.js が v20 以上かを確認する。古い Node.js のまま npm インストールすると失敗や不安定動作の原因になる。
3. PowerShell の実行ポリシーを Get-ExecutionPolicy で確認する。シムの実行がブロックされる環境では、社内ルールに従いスコープ限定で緩和する。
4. 社内プロキシ配下でサインインや通信に失敗する場合は、後述のシステムプロキシ対応が入った v0.142.1 以降へ更新する。

この 4 点で解決しない場合は、いったんアンインストールして npm ルートで入れ直すのが早い。同種のエラー切り分けは別記事「Codex が動かないときの原因と対処」でも詳しく扱っている。

Windows 対応はいま強化中 — v0.142 系の変更を押さえる

codex.exe を今から導入するなら、バージョンは v0.142 系の安定版を選びたい。2026 年 6 月 25 日公開の v0.142.1 では、Windows のシステムプロキシ対応(オプトイン)が追加され、PAC / WPAD / 静的プロキシ / バイパスルールを OS 側の設定から拾えるようになった。企業ネットワークでプロキシ越えに悩んでいた Windows ユーザーには効果の大きい変更だ(出典: https://developers.openai.com/codex/changelog )。その後も修正リリースが続き、2026 年 7 月時点の安定版は v0.142.5 まで進んでいる。並行して次期 v0.143 系の alpha がプレリリースとして公開されているが、日常利用は Latest マークの安定版で追うのが安全だ(出典: https://github.com/openai/codex/releases )。Windows ネイティブ実行は「一応動く」段階から「業務ネットワークでも運用できる」段階へ着実に進んでおり、codex.exe を選ぶ理由は以前より強くなっている。

まとめ — codex.exe は Codex CLI の本体、公式ルートで入れて場所を把握する

codex.exe は Codex CLI の Windows 用ネイティブバイナリであり、npm の @openai/codex か GitHub Releases という二つの公式ルートで入手できる。置き場所は where.exe codex で確認でき、npm ルートならシムが %APPDATA%\npm、実体がパッケージ内部という構造だ。安全性は配布元が公式かどうかで判断し、非公式の再配布サイトは避ける。そして v0.142 系ではシステムプロキシ対応など Windows 向けの改善が続いているため、これから入れるなら最新の安定版を選ぶ。exe の正体と置き場所さえ押さえれば、Windows での Codex 運用に不安要素はない。

出典

• OpenAI Developers: Codex CLI
• OpenAI Developers: Codex Changelog
• openai/codex Releases (GitHub)
• openai/codex リポジトリ (GitHub)