Codex

Codex CLI とは：仕組みと App・Web との違い

Codex CLI がローカルターミナルでどう動くかを説明し、Codex App と Codex Web の実行環境を比較します。

Codex CLI は OpenAI のローカルコマンドライン型コーディングエージェントです。ターミナルで実行され、選択したワークスペースを読み取り、ファイルを編集し、コマンドを実行します。開発タスクでは、設定したサンドボックスと承認ルールに従います。

短い答え

ローカルリポジトリでのコード変更、コードレビュー、テスト修正、スクリプト作成、複数手順のエンジニアリング作業をエージェントに任せたいときに役立ちます。

Codex CLI は通常の ChatGPT との会話とは異なります。コードを提案するだけでなく、現在のディレクトリ、プロジェクトの指示、ツールの実行結果、ローカル実行権限を使って作業します。

Codex CLI・App・Web の比較

選択肢	実行場所	向いている用途
Codex CLI	ローカルターミナルとワークスペース	コマンド、自動化、リポジトリ内の作業
Codex App	デスクトップアプリ	視覚的なセッション、ローカルタスク、アカウント機能
Codex Web	ブラウザまたはクラウド環境	ローカルターミナルに依存しないリモートタスク

詳しい違いは Codex CLI、Codex App、Codex Web の比較をご覧ください。

この情報が役立つ場面

初めて @openai/codex をインストールするとき
Codex CLI、Codex App、Codex Web を比較するとき
ローカルプロジェクトのファイルをエージェントに編集させたいとき
カスタム API プロバイダー、Base URL、モデルを設定するとき
サンドボックス、承認、AGENTS.md を理解したいとき

基本概念

概念	意味
Codex CLI	ローカルターミナルで実行する Codex コーディングエージェント
ワークスペース	Codex が読み取り、検索、変更できるディレクトリ
`config.toml`	モデル、プロバイダー、サンドボックス、承認などを設定するローカルの Codex 設定ファイル
`AGENTS.md`	リポジトリのルールや共同作業の方針を Codex に伝えるプロジェクト指示ファイル
サンドボックス	ファイルシステム、ネットワーク、コマンドアクセスに対するローカルのセキュリティ境界
承認	どの操作に確認が必要かを決めるポリシー

推奨ワークフロー

変更したいプロジェクトディレクトリ内で Codex CLI を起動します。
大きな変更の前に、関連ファイルや指示を確認するよう依頼します。
複雑な作業では、ファイルを変更する前に計画を作成するよう依頼します。
タスクのリスクに合わせてサンドボックスと承認の設定を選びます。
継続的なプロジェクトルールは AGENTS.md に、今回だけの要件は現在の会話に記載します。

サードパーティの API プロバイダーを使う場合は、model_provider、base_url、wire_api、config.toml 内のモデル関連の項目に注目します。Codex や他の OpenAI 互換ツールでは通常 OpenAI 互換エンドポイントを使用し、このドキュメントでは https://bettertoken.ai/v1 です。