
OpenAI Codex CLI
OpenAI · コーディング
OpenAI Codex CLI は OpenAI のローカル型コーディングエージェントだ。ターミナルで動き、リポジトリを読み、ファイルを編集し、コマンドを実行する。主導権は常に自分の側にある。

OpenAI Codex CLI について
What Is OpenAI Codex CLI
OpenAI Codex CLI は、自分のマシンにインストールして使うコーディングエージェントである。作業対象は手元のリポジトリそのものだ。ファイルを読み、手を入れ、すでに導入済みのツールを走らせる。操作はターミナルウィンドウから行うので、作業を始める前に何かをwebアプリへ上げる必要はない。
狙いは単純だ。いつもの開発サイクルはそのままにして、時間を食う部分をエージェントに任せる。機能がどうつながっているかを追う、リファクタリングを設計する、テストが落ちる理由を探る、といった作業がそれにあたる。Codex CLI が向くのは、普段からシェルで暮らしていて、エージェントを別タブではなくコードの隣に置きたい開発者だ。
先に押さえておきたい制約が2つある。ツール本体は Apache-2.0 ライセンスのオープンソースで無料だが、その裏のモデルを使うには有料の ChatGPT プランか、API 料金で課金される API キーが要る。加えて、単体のコマンドラインツールは、Codex の他形態にあるクラウド機能を使えない。GitHub のコードレビューや Slack 連携がそれにあたる。
Getting Started
- macOS か Linux なら1行のシェルスクリプト、Windows なら PowerShell 版で Codex CLI を入れる。
npm install -g @openai/codexやbrew install --cask codexでも構わない。 - プロジェクトのディレクトリを開いて
codexを実行する。初回起動時に Sign in with ChatGPT を選び、Plus、Pro、Business、Edu、Enterprise のいずれかのプランに紐づくアカウントを接続する。 - やりたいことを普通の言葉で書く。プロジェクトの説明を求める、狙った変更を頼む、不具合の原因を調べさせる、どれでもいい。エージェントはファイルを確認しながら編集案を出す。
- 作業の前後に Git のチェックポイントを作る。変更がこじれたら、手で解きほぐす代わりにチェックポイントへ戻せばいい。
- Codex が実行しようとするコマンドを承認するか拒否する。
/permissionsと/modelで、そのセッションの境界と推論の強さを決める。
AIツール情報
OpenAI Codex CLIの料金、対応プラットフォーム、性能を簡単に確認できます。
こんな人におすすめ
このツールが最も力を発揮するユーザー、タスク、シーン。
ユーザー
- ターミナル中心の開発者:普段からシェルで作業する人なら、慣れたサイクルの中にエージェントが入る。新しいエディタを覚える必要はない。ChatGPT プランか API キーが前提だ。
- バックエンド/システム系のエンジニア:リポジトリの深い作業、ビルドスクリプト、ツールチェーンの調査と相性がいい。Codex はすでにインストール済みのコマンドを実行するからだ。macOS、Linux、Windows に対応する。
- CI と自動化の担当者:`codex exec` は非対話のタスクを走らせるので、パイプラインや繰り返し使うワークフローに組み込める。共有環境では API キーが最も素直な選択だ。
タスク
- 見慣れないコードの下調べ:リポジトリを Codex に向け、何かを触る前に構成の説明を求める。推測ではなく、ファイルを直接読む。
- 的を絞ったリファクタリング:コンポーネントの改名、hooks への移行、モジュールの分割などを、エージェントがファイルを編集しテストを回しながら進める。Git のチェックポイントがあれば変更を戻せる。
- ローカルのコードレビュー:pull request を出す前に、未コミットの変更、単一のコミット、あるいはブランチを対象に専用のレビューを回す。Codex は作業ツリーに触れずに指摘を返す。
シーン
- 毎日の編集と実行のループ:サイクル全体を1つのターミナルセッションに収め、検索、編集、テスト実行を Codex に任せる。ツールを行き来する手間が消える。
- コミット前の点検:これからコミットする内容を、まだ直せるうちに確認する。レビュアーに指摘されてからでは遅い。
- 繰り返し作業の自動化:範囲の明確なスクリプト化できる仕事を `codex exec` に渡し、対話セッションから切り離す。
主な機能
ローカルリポジトリで働くエージェント
Codex CLI が扱うのは、今のプロジェクトのファイルそのものだ。どこかへ上げたコピーではない。コードを調べ、編集し、導入済みのツールを走らせるので、動きは実際の環境と一致する。秘密情報も依存関係もローカル設定も、置かれた場所にとどまる。
モデルと推論の柔軟な切り替え
モデルと推論の強さはセッションごとに /model で選ぶ。作業が重くなっても軽くなっても、会話の途中で切り替えられる。ChatGPT プランではコーディング用の既定が GPT-6.1 Sol で、軽い仕事には GPT-6 Luna が使える。専用の /model コマンドがあるおかげで、設定は設定ファイルに埋もれず目の前に見える。
権限とサンドボックスの制御
/permissions コマンドは、Codex が確認なしにファイルを編集したりコマンドを実行したりしてよい場面を決める。続ける前に、有効なサンドボックスと書き込み可能なルートを確認できる。壊されては困るリポジトリにエージェントを向けるときは、これが効く。
ローカルのコードレビュー
/review は未コミットの変更、1つのコミット、またはベースブランチを対象に集中して目を通し、優先度順に指摘を返す。作業ツリーには手を付けないので、コミットや pull request の前にリスクを見られる。あくまで点検であり、自動修正ではない。
codex exec によるスクリプトと CI
非対話モードを使えば、スクリプトやパイプラインから Codex を呼べる。ビルド手順や繰り返し使うワークフローから同じエージェントの論理を起動できる。チームがサブスクより API キーの道を選ぶ主な理由がこれだ。
画像と Web のコンテキスト
codex --image はスクリーンショット、構成図、デザインの参考を最初のプロンプトに渡す。エージェントは自分と同じ視覚情報を見て考える。codex --search は、最新のリリースやドキュメントに依存する作業のとき、実行をライブの Web 検索に切り替える。検索の動きは記録に残る。
セッション、再開、サブエージェント
codex resume は今のリポジトリの直近のやり取りを開き直す。古い作業に戻りたいときは、ローカルのやり取りを横断して探せる。大きな調査では、Codex に的を絞った作業をサブエージェントへ委任させ、その結果をメインのセッションに引き戻せる。
MCP 接続
Codex はローカルまたはリモートの MCP サーバーにつながり、必要なら認証し、使う前にそのセッションで利用できるツールを一覧する。チームのデータや外部サービスへ、ターミナルを離れずに手が届くのはこの経路のおかげだ。
メリットとデメリット
メリット
- 普段使っているターミナルで動く。先にエディタや web アプリを導入する必要はない。
- Apache-2.0 でオープンソースなので、何をしているかを直接読める。
- 権限とサンドボックスの制御で、エージェントに何を変えさせ、何を実行させるかを自分で決められる。
- `codex exec` があるので、対話セッションだけでなくスクリプトや CI でも使える。
- レビューモードは作業ツリーに触れずに問題を洗い出す。
デメリット
- モデルへのアクセスは無料ではない。ChatGPT プランか API 料金で課金される API キーが要り、大量に使うと費用はすぐ膨らむ。
- 単体のコマンドラインツールでは、GitHub のコードレビュー、Slack 連携、より大きなクラウド VM といったクラウド機能が使えない。
- グラフィカルな画面がない。コマンドラインを避けたい人には敷居が高い。
- API キーの道は設定の手間が増える。使えるモデルはキーが届く範囲次第だ。
よくある質問
ツール本体は Apache-2.0 ライセンスのオープンソースで無料だ。ただし利用そのものは無料ではない。裏のモデルには有料の ChatGPT プラン(Plus が $20/mo、Pro が $100/mo から、Business が1ユーザーあたり月 $20)か、API 料金で課金される API キーが要る。
関連コンテンツ
OpenAI Codex CLIに関連するツール、スキル、記事を探す。
OpenAI Codex CLIの代替ツール
Base Code
Base44 (Wix) · コーディング · 生産性向上Base CodeはBase44の共有クラウド開発環境だ。既存のGitHubリポジトリに対する変更をチャットで伝え、プレビューで確認し、プルリクエストとして返せる。
Google EmbeddingGemma 2
Google DeepMind · ライティング · 画像 · コーディングGoogle EmbeddingGemma 2 は 7 億 4000 万パラメータのオープンなモデルで、テキスト、コード、画像、音声、動画フレームを同じ 768 次元空間のベクトルに変え、スマートフォンやノート PC 上で動く。
GitGlow
GitGlow · コーディング · 生産性向上GitGlow は自分のコードと AI エージェントの変更を一つのレビューにまとめるデスクトップ Git クライアントだ。出荷前に、マシンから何が出ていくのかを確かめられる。
