Codex CLI で Nexith を使用する
新しい Codex は OpenAI Responses プロトコル(POST /v1/responses)のみを送信します。Nexith ゲートウェイにはこの層のアダプターがあり、
リクエスト形状で Codex を識別し、内部で chat パイプラインに翻訳して実行し、結果を Responses 形状に翻訳し直します。ルーティング、課金、
出口(egress)の秘匿化は他のプロトコルと完全に同じパスを共有します。
設定#
~/.codex/config.toml に記述します:
model = "nexith-core"
model_provider = "nexith"
[model_providers.nexith]
name = "Nexith"
base_url = "https://gateway.nexith.ai/v1"
env_key = "NEXITH_API_KEY"
wire_api = "responses"続いて:
export NEXITH_API_KEY="nx-你的key"
codex
base_urlには/v1を付けてください(Codex はその後ろに/responsesを連結します)。この点は Anthropic クライアントと逆なので、 混同しないでください。api.nexith.ai/v1も同様に使用できます。
対応エンドポイント#
| エンドポイント | 用途 |
|---|---|
POST /v1/responses |
Codex のメインパス。ストリーミングと function_call をサポート |
POST /v1/chat/completions |
wire_api を chat に設定した場合はこちらを使用 |
GET /v1/models |
モデル一覧 |
ツール呼び出し(apply_patch など)#
検証の要点:
- リクエスト側:
function_callitem → assistant のtool_calls。function_call_output→toolロールの メッセージ。call_idは全体を通じてtool_call_idとして保持され、ペアリングが崩れません。 - レスポンス側:アップストリームの
tool_calls→output内のfunction_callitem。argumentsは文字列の形態を維持します (Codex は文字列を受け取るため、オブジェクトへの往復変換を行いません)。 - ストリーミング:パラメータの断片はアップストリームのスライス単位で転送され、連結後はアップストリームと一致します。
既知の制限:Responses リクエストで type が function でない組み込みツール(Codex 自身の
local_shell、web_search など)は現在破棄され、アップストリームには転送されません。Codex を使用する場合は、カスタム function
ツールを主体にしてください。
課金と長時間タスク#
- 1 リクエストの上限は 120 秒(現在)。超長い agent ループの 1 ターンが超えると打ち切られます。対応中です。
- 32k コンテキストを超える
nexith-coreリクエストは自動的に強力なアップストリームへエスカレーションされ、エスカレーション後のティアで課金されます。
トラブルシューティング#
upstream rejected / 400
多くは履歴内のツール呼び出しペアの欠損です。ゲートウェイは入口で 1 回の隣接修復(プレースホルダーの補完または孤立要素の破棄)を行いますが、根本的な解決にはクライアント
自身で function_call と function_call_output が対になることを保証する必要があります。
408 / 再接続 アップストリームのタイムアウトです。特定のアップストリームが頻繁に遅い場合、ゲートウェイはフェイルオーバーします。継続して発生する場合は具体的なタスク種別をご報告ください。
401
env_key が指す環境変数が設定されていないか、key が nx- で始まっていません。