Codex CLI

Codex CLI は OpenAI 公式のコマンドライン用コーディングエージェントで、~/.codex/config.toml でモデルプロバイダーを定義します。カスタム provider を aicentos に向ければ、ターミナル内で aicentos が接続しているモデルを利用できます。

複数の設定を GUI で管理したい場合は、CC Switch でワンクリック切り替えもできます。本記事では手動設定のみを扱います。

準備アンカーリンクをコピー

まずコンソールの「API キー」ページで、Codex CLI 専用のキーを作成してください（名前は codex-cli のようにすると使用量の追跡に便利です）：

• コンソール：https://aicentos.com
• キーの作成：https://aicentos.com/keys
• 残高不足のときのチャージ：https://aicentos.com/wallet

Codex CLI がインストール済みか確認します：

codex --version

設定値アンカーリンクをコピー

設定手順アンカーリンクをコピー

1. API Key 環境変数の設定アンカーリンクをコピー

export AICENTOS_API_KEY="sk-あなたの-API-Key"

永続化するには ~/.zshrc または ~/.bashrc に書き込み、source で反映させ、echo $AICENTOS_API_KEY で確認します。

2. config.toml の編集アンカーリンクをコピー

~/.codex/config.toml に次を追加します：

model = "あなたのモデル名"
model_provider = "aicentos"

[model_providers.aicentos]
name = "aicentos"
base_url = "https://aicentos.com/v1"
env_key = "AICENTOS_API_KEY"
wire_api = "responses"

あなたのモデル名 はコンソール「モデル広場」に表示されているモデル名に置き換えてください。対応モデル を参考にできます。

3. Codex の起動アンカーリンクをコピー

codex

簡単なリクエストを 1 つ送り、provider が正常に動作していることを確認します。

テストアンカーリンクをコピー

codex exec "1+1 はいくつですか？一文で答えてください"

内容が正常に返れば接続成功です。返ってきた内容に応じて少量のクレジットを消費します。コンソールの使用量ログで確認できます。

注意事項アンカーリンクをコピー

• Base URL は /v1 までにしてください。/v1/chat/completions までの完全なパスにしないでください。
• base_url、env_key などのフィールドはユーザーレベルの ~/.codex/config.toml でのみ有効です。プロジェクト内の .codex/config.toml に書いても無視され、起動時の警告が出ることがあります。
• wire_api には responses を指定します。aicentos の Responses インターフェース に対応します。公式ドキュメントでは現時点でこの値のみサポートされています。バージョンによって unknown variant エラーが出る場合は CLI が古すぎるので、先にアップグレードしてください。
• openai、ollama、lmstudio は予約済みの provider ID です。内蔵 openai の base_url を書き換えてサードパーティのゲートウェイに向けることはできません。新しい provider 名を起ち上げる必要があります（本記事では aicentos を使用しています）。
• 切り分けの順序：モデル名がコンソールと一致しているか → Base URL が /v1 までか → 環境変数が codex を起動したターミナルから見えているか → アカウント残高は十分か。

関連リンクアンカーリンクをコピー

• Codex への接続（CC Switch 方式）