在 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- 开头。