Codex は CLI か?ターミナル版の正体
「Codex は CLI なのか」という検索は、Codex を CLI と IDE 拡張 / Cloud と区別したい人からよく出ます。実際には Codex は CLI ではなくエージェントで、Codex CLI はそのエージェントを呼び出すための「ターミナル版クライアント」という関係です。
本記事では、Codex 本体と Codex CLI の関係、Codex CLI で何ができるか、IDE 拡張 / Codex Cloud / ChatGPT 内 Codex とどう違うか、CLI を選ぶべき場面を整理します。
目次 (9)
Codex は CLI ではなく AI コーディングエージェント
OpenAI 公式は Codex を「コードを書き、レビューし、出荷するための AI エージェント」と定義しています。Codex はソフトウェア(ターミナルアプリ)そのものではなく、リポジトリの読解、ファイル編集、コマンド実行、テスト確認といった一連の作業を自律的に進めるエージェントです。
Codex を呼び出す入口は 4 つあります。Codex CLI(ターミナル)、IDE 拡張(VSCode / JetBrains 系のプラグイン)、Codex Cloud(ブラウザ)、ChatGPT 内 Codex(ChatGPT の対話 UI)で、それぞれ違うインターフェースから同じエージェントに作業を依頼します。
つまり Codex 本体は「エージェント」、Codex CLI は「そのエージェントを使うための CLI 版クライアント」という関係です。「Codex は CLI か?」への答えは No、「Codex CLI はあるか?」への答えは Yes です。
Codex CLI は OpenAI 公式の CLI 版クライアント
Codex CLI は OpenAI 公式が提供する Codex のターミナル版クライアントで、macOS / Windows / Linux すべてに対応しています。OpenAI Developers の Codex CLI ドキュメントには「The Codex CLI is available on macOS, Windows, and Linux.」と明記されており、Windows ではネイティブ実行(PowerShell + Windows Sandbox)と WSL2 経由の 2 構成が用意されています。
導入は OpenAI 公式のインストール手順に従い、codex コマンドを PATH に通したあと、ChatGPT アカウントでサインインすると、サブスクリプションプラン(Plus / Pro / Business / Enterprise / Edu)に紐づいた利用枠で Codex を呼び出せるようになります。API キーを直接設定する必要がない設計のため、API 利用契約と切り離して導入できる点も Codex CLI の特徴です。
codex を起動すると、対話型のターミナル UI が立ち上がり、自然文で依頼を出せます。リポジトリ内に AGENTS.md を置くと、作業ルール / 禁止事項 / よく使うコマンドを Codex CLI に伝えやすくなります。
Codex CLI の主要機能 — リポジトリ読解・編集・実行
Codex CLI は単なる質問応答ボットではありません。リポジトリ全体を読み、ファイルを編集し、コマンド(ビルド / テスト / git / 任意のシェル)を実行できます。ユーザーが OK を出した範囲で、codex セッションの中で「依頼 → 計画 → 編集 → 実行 → レビュー」の流れが完結します。
代表的なユースケースは、特定エラーの原因調査、軽い UI 文言の一括修正、テスト追加と既存テスト通過の確認、軽いリファクタ、依存ライブラリのバージョンアップ作業などです。Codex CLI に渡せるタスクの粒度は小さなものから始められ、慣れてきたら長尺の作業も任せられます。
/model コマンドでモデル名を切り替えられる仕組みもあり、Codex CLI は GPT-5.4 / GPT-5.3-Codex などの世代を選んで使えます。タスクの性質(深い思考が必要 / リアルタイム性が必要)に応じてモデルを変えると、レイテンシと品質のトレードオフを自分で調整できます。
Codex CLI と IDE 拡張版の機能差
Codex CLI と Codex IDE 拡張(VSCode / JetBrains 系)は、できることの本質はほぼ同じで、入口とエディタ統合の有無が違います。IDE 拡張版はエディタ側の文脈(開いているファイル / 選択範囲 / カーソル位置)をそのまま Codex に渡せるため、「いま見ている関数のリファクタ」「開いているファイルへのテスト追加」のような小回りの利く依頼が得意です。
Codex CLI はターミナルから始まるため、IDE のサイドパネルではなく、シェル / シェルスクリプト / Git フックなどから Codex を呼び出すのに向きます。CI スクリプトの中で「変更されたファイルに対して Codex CLI に lint 提案を出させる」といった自動化パイプラインに組み込むのは、CLI 版にしかできない使い方です。
ふだんは IDE 拡張で対話的に Codex を使い、自動化系の作業だけ Codex CLI で書く、という両立も普通の構成です。
Codex CLI と Codex Cloud の使い分け
Codex Cloud はブラウザから利用するクラウド版で、Codex のエージェントを OpenAI 側のクラウド環境で実行します。ローカルにインストールしないため、開発 PC が落ちていても Codex 側の作業は続きます。
Codex CLI と Codex Cloud の使い分けは、「ローカルの環境を活かしたいか / クラウドに完全委任したいか」で分かれます。Codex CLI はローカルのリポジトリと環境にアクセスでき、開発機固有の依存(社内ツール / 特殊な環境変数 / オフライン環境)を活用できます。Codex Cloud はその逆で、ローカル不要・並列実行・長時間タスクに強い構成です。
長時間の調査タスクや複数の修正候補を並列で試すような場面は Codex Cloud、対話的に細かい修正を回したい場面は Codex CLI、という棲み分けが現実的です。
Codex CLI と ChatGPT 内 Codex の関係
もう 1 つの入口、ChatGPT 内 Codex は、ChatGPT の対話画面でコーディング依頼を出すと内部で Codex 系モデルが応答する形式です。導入コストはほぼゼロで、Windows / Mac / iOS / Android のいずれでも ChatGPT が動けば使えます。
Codex CLI と ChatGPT 内 Codex の違いは、リポジトリへの直接アクセスができるかどうかです。Codex CLI はローカルリポジトリを読み書きしますが、ChatGPT 内 Codex は基本的に対話の中でコードを受け渡しする形になります。
「Codex を使い始めたいが、Codex CLI を入れる前に挙動を確認したい」段階では、ChatGPT 内 Codex で雰囲気を掴んでから Codex CLI に進むと、無駄な環境構築を避けられます。
Codex CLI を選ぶべき場面
Codex CLI が他経路より優位に立つのは、(1) 自動化スクリプトに組み込みたい場面、(2) IDE が動かない環境(SSH 先のサーバ / Docker / Codespaces)で Codex を使いたい場面、(3) ローカルの細かい依存(社内 lint / 独自スクリプト)に Codex を絡めたい場面、の 3 つです。
逆に、IDE 中心で対話しながら作業したい場面は IDE 拡張、長時間 / 並列タスクは Codex Cloud、初回検証は ChatGPT 内 Codex、と入口を選び分けるのが Codex の正しい付き合い方です。Codex CLI は「ターミナルでないと困るとき」「自動化に組み込みたいとき」に強さを発揮します。
まとめ — Codex は CLI ではなく、CLI 版がある
Codex 自体は CLI ではなく、OpenAI の AI コーディングエージェントです。Codex CLI はその CLI 版クライアントで、macOS / Windows / Linux で動き、リポジトリ読解・編集・実行を codex コマンドから呼び出せます。
IDE 拡張 / Codex Cloud / ChatGPT 内 Codex と並ぶ 4 経路の 1 つで、自動化スクリプト・IDE 抜き環境・ローカル依存活用に強みを持ちます。Codex CLI を選ぶかどうかは、「ターミナルでないと困るか」「自動化に組み込みたいか」で判断すれば迷いません。
