星桥

Codex 中转站配置：config.toml 与 Responses 教程

在 Codex CLI 中使用星桥，需要一个支持 Responses 协议的模型与分组。用户级配置包含三项：模型 ID、提供商 ID，以及提供商的 Base URL 和密钥来源。仅支持 Chat Completions 的渠道不能直接使用这份配置。

资料核对：。配置字段已对照官方文档；不同版本和模型的完整任务能力仍需实际验证。

1. 确认密钥和 Responses 端点

在星桥创建密钥，到模型价格页确认目标模型支持 Responses。下文的 YOUR_MODEL_ID 是占位值，必须替换成当前密钥可以调用的模型 ID。

2. 设置当前终端的密钥

macOS / Linux：

export XINGQIAO_API_KEY="替换为你的星桥密钥"

Windows PowerShell：

$env:XINGQIAO_API_KEY = "替换为你的星桥密钥"

环境变量只影响当前终端及其启动的程序。不要把真实密钥粘贴到公开问题、截图或项目配置中。

3. 合并用户级 config.toml

先备份 ~/.codex/config.toml；Windows 通常为 %USERPROFILE%\.codex\config.toml。将下列字段合并进去，已有同名键和提供商配置只保留一份，保留其他设置。

model = "YOUR_MODEL_ID"
model_provider = "xingqiao"

[model_providers.xingqiao]
name = "星桥 API"
base_url = "https://newapi.xingqiaoapi.cn/v1"
env_key = "XINGQIAO_API_KEY"
wire_api = "responses"

model_provider 与配置表的 xingqiao 必须一致。提供商和凭据路由配置放在用户级文件；官方说明项目级 .codex/config.toml 不能覆盖这些设置。

4. 启动并检查一次短请求

codex

从设置了环境变量的同一终端启动，在测试目录发送一个简单问题，再核对星桥使用日志的时间、模型、分组与消耗。先验证普通请求，再验证流式输出、工具调用和长任务。

常见问题

缺少 XINGQIAO_API_KEY 怎么办？

确认变量已在启动 Codex CLI 的同一终端设置，名称与 env_key 完全一致。新终端通常不继承另一个终端临时设置的变量。

为什么普通对话成功，Codex 仍报错？

普通对话可能只验证了 Chat Completions。Codex 还需要兼容的 Responses 协议、流式事件及任务所需工具能力，请核对模型、分组、客户端版本和实际报错端点。

版本与能力边界

本教程以 Codex CLI 为准；从 Dock 启动的桌面程序不一定继承终端变量。CLI 配置成功不代表桌面端、编辑器扩展或所有代理任务均已验证。本站密钥不等同于 ChatGPT 订阅登录，无需为了此配置覆盖已有登录文件。

出现 401、429 或 503 时，参照API 状态码与路由错误排查。长任务费用还应核对缓存读取、写入与实际用量。

参考来源

OpenAI 官方：自定义模型提供商和用户级配置。本站地址与限制见星桥服务说明；其他请求示例见完整接入文档。