NNexithDocs
状态控制台 ↗
概览与快速开始模型目录指南API 参考集成OAuth2 / OIDC

在 Codex CLI 中使用 Nexith

新版 Codex 只说 OpenAI Responses 协议(POST /v1/responses)。Nexith 网关有这一层适配: 按请求形状识别 Codex,内部翻译成 chat 管道执行,再把结果翻回 Responses 形状——路由、计费、 出口擦除与其它协议完全共用一条路径。

配置#

写进 ~/.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 项 → assistant 的 tool_calls;function_call_output → tool 角色 消息。call_id 全程保留为 tool_call_id,配对不会被打乱。
  • 响应侧:上游的 tool_calls → output 里的 function_call 项,arguments 保持字符串形态 (Codex 就吃字符串,不做对象往返)。
  • 流式:参数分片按上游切片转发,拼接后与上游一致。

已知限制:Responses 请求里 type 不是 function 的内置工具(如 Codex 自己的 local_shell、web_search)当前会被丢弃,不会转给上游。用 Codex 时请以自定义 function 工具为主。

计费与长任务#

  • 单请求 120 秒上限(当前),超长 agent 循环的单轮若超过会被截断——正在处理中。
  • 超过 32k 上下文的 nexith-core 请求会自动升级到更强上游并按升级档位计价。

故障排除#

upstream rejected / 400 多为历史里工具调用配对残缺。网关会在入口做一次邻接修复(补占位或丢孤儿),但根治要靠客户端 自身保证 function_call 与 function_call_output 成对。

408 / 重连 上游超时。若某个上游经常慢,网关会走故障转移;持续出现请反馈具体任务类型。

401 env_key 指向的环境变量没设,或 key 不是 nx- 开头。