短い答え
Codex CLI は OpenAI のローカルコマンドライン型コーディングエージェントです。ターミナルで実行され、選択したワークスペースを読み取り、ファイルを編集し、コマンドを実行します。開発タスクでは、設定したサンドボックスと承認ルールに従います。 ローカルリポジトリでのコード変更、コードレビュー、テスト修正、スクリプト作成、複数手順のエンジニアリング作業をエージェントに任せたいときに役立ちます。 Codex CLI は通常の ChatGPT との会話とは異なります。コードを提案するだけでなく、現在のディレクトリ、プロジェクトの指示、ツールの実行結果、ローカル実行権限を使って作業します。この情報が役立つ場面
- 初めて
@openai/codexをインストールするとき - Codex CLI、Codex App、Codex Web を比較するとき
- ローカルプロジェクトのファイルをエージェントに編集させたいとき
- カスタム API プロバイダー、Base URL、モデルを設定するとき
- サンドボックス、承認、
AGENTS.mdを理解したいとき
基本概念
推奨ワークフロー
- 変更したいプロジェクトディレクトリ内で Codex CLI を起動します。
- 大きな変更の前に、関連ファイルや指示を確認するよう依頼します。
- 複雑な作業では、ファイルを変更する前に計画を作成するよう依頼します。
- タスクのリスクに合わせてサンドボックスと承認の設定を選びます。
- 継続的なプロジェクトルールは
AGENTS.mdに、今回だけの要件は現在の会話に記載します。
model_provider、base_url、wire_api、config.toml 内のモデル関連の項目に注目します。Codex や他の OpenAI 互換ツールでは通常 OpenAI 互換エンドポイントを使用し、このドキュメントでは https://www.bettertoken.ai/v1 です。
よくある間違い
- Codex CLI をチャット専用アシスタントとして扱うこと。
- Codex CLI、Codex App、Codex Web が同じ環境で実行されると考えること。
- 対応するプロバイダーと Base URL を設定せずに
modelだけを変更すること。 - テスト、レビュー、コマンドの境界を設けずにサンドボックスと承認設定を緩めること。
- OpenAI 互換と Anthropic 互換の Base URL を混同すること。
BetterToken について
カスタムの OpenAI 互換プロバイダーを使用する場合、BetterToken は Codex CLI のモデル API レイヤーとして利用できます。API Key、Base URL、モデルルーティング、残高、使用履歴を管理します。 BetterToken は Codex CLI のローカルサンドボックス、承認、AGENTS.md、コマンド実行ポリシーを置き換えるものではありません。
関連ドキュメント
- Codex の BetterToken 設定ガイド
- Codex CLI、Codex App、Codex Web の違い
- Codex CLI の config.toml を設定する方法
- OpenAI 互換 API と Anthropic 互換 API の違い