NNexithDocs
ステータスダッシュボード ↗
概要とクイックスタートモデルカタログガイドAPI リファレンス連携OAuth2 / OIDC

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_call item → assistant の tool_calls。function_call_output → tool ロールの メッセージ。call_id は全体を通じて tool_call_id として保持され、ペアリングが崩れません。
  • レスポンス側:アップストリームの tool_calls → output 内の function_call item。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- で始まっていません。