チャージ準備中ログインAPIキーを発行
ドキュメントCodex CLI

Codex CLI

OpenAI の Codex CLI から Echo Token Station のモデルを使うための設定です。Codex CLI は Responses API で接続します。

Codex CLI は、OpenAI のコーディング用 AI ツールです。ターミナルで動きます。Codex CLI は Responses API（/v1/responses）だけを使って Echo に接続します。

動作確認：Codex CLI 0.157.1（2026-09-27、Echo の検証環境）

始める前に

  • Echo の API キーと、使うモデルの ID を用意します。モデル ID はモデル一覧で確認できます
  • Codex CLI は OpenAI のモデル向けのツールです。OpenAI 以外のモデルを Codex CLI で使ったときの動作は確認していません

設定する

  1. Echo の API キーを環境変数 ECHO_API_KEY に入れます
bash
export ECHO_API_KEY="sk-..."
  1. Codex CLI の設定ファイル ~/.codex/config.toml に、次の内容を書きます。環境変数 CODEX_HOME を設定している場合は、そのフォルダーの config.toml です
toml
model = "gpt-6-sol"
model_provider = "echo"

[model_providers.echo]
name = "Echo Token Station"
base_url = "https://token.echohub.io/v1"
env_key = "ECHO_API_KEY"
wire_api = "responses"
項目意味
model使うモデルの ID
model_provider使う接続先の名前。下の [model_providers.echo] の echo と同じにします
name画面に表示する名前
base_url接続先。/v1 まで含めます
env_keyAPI キーを読む環境変数の名前
wire_api通信の形式。"responses" にします

wire_api に "chat" を指定すると、Codex CLI 0.157.1 は起動時に wire_api = "chat" is no longer supported というエラーで止まります。

動作を確かめる

  1. ECHO_API_KEY を設定したターミナルで、作業するフォルダーに移動し、次のコマンドを実行します。Git のリポジトリではないフォルダーで試す場合は、--skip-git-repo-check を付けます
bash
codex exec "Reply with the single word hi."
  1. 回答が表示されれば完了です。コンソールの「呼び出し履歴」にも記録が出ます

Codex CLI が知らないモデル ID を指定すると、Model metadata for ... not found という警告が出ます。呼び出しはそのまま続きます。

うまくいかないとき

症状原因対処
起動時に wire_api = "chat" is no longer supportedwire_api が "chat" になっているwire_api = "responses" にする
404 で、JSON ではなく HTML のページが返るbase_url の末尾に /v1 がないhttps://token.echohub.io/v1 にする
401 と Invalid API keyキーが違う、停止している、有効期限切れ、または利用上限を使い切ったコンソールでキーの状態を確認する
404 と Invalid URL (POST /v1/v1/responses)base_url に /v1 が 2 回入っているhttps://token.echohub.io/v1 にする
403 と Insufficient balance残高が足りないチャージする
503 と The model … does not exist or is not availableモデル ID が違う、または Echo が提供していないモデルmodel のモデル ID を確認する

エラー本文の一覧はエラーと対処にあります。

Codex CLI はリクエストに store: false（経由先の API に回答を保存させない指定）を付けて送ります。Echo はこの値を変えずに経由先に渡します。

確認した情報源

内容情報源確認日
config.toml の設定での接続、wire_api = "chat" のエラー、知らないモデル ID の警告、store: false を送ることEcho の検証環境での実測（Codex CLI 0.157.1）。本番と同じ中継設定で、経由先の API の代わりに試験用の応答を返すサーバーを使いました2026-09-27
model_provider と [model_providers.<id>] の項目（name、base_url、env_key、wire_api）、CODEX_HOMEhttps://developers.openai.com/codex/config-advanced2026-09-27
wire_api = "chat" の廃止https://github.com/openai/codex/discussions/77822026-09-27