兴一 XINGYI

接入教程 / codex

Codex 自定义服务商配置:Base URL 与 Responses 协议

兴一 XINGYI · 2026-11-21

本教程适用于支持自定义服务商的 Codex CLI。先安装客户端并运行 codex --version;实际字段支持情况以当前客户端文档为准。兴一是独立的第三方 API 服务。

1. 准备 Responses 模型

在控制台创建密钥,并在模型广场确认该分组支持 Responses 的完整模型 ID。模型列表可见并不代表所有协议都可调用。

2. 合并配置

编辑 ~/.codex/config.toml;Windows 对应 %USERPROFILE%\.codex\config.toml。先备份现有文件,再合并顶层字段和服务商表,避免重复声明。

model_provider = "xingyi"
model = "YOUR_CODEX_MODEL"

[model_providers.xingyi]
name = "XINGYI"
base_url = "https://api.xingyi888.com/v1"
wire_api = "responses"
env_key = "XINGYI_API_KEY"
requires_openai_auth = false

3. 设置密钥并运行

Windows PowerShell:

$env:XINGYI_API_KEY="YOUR_API_KEY"
codex

macOS / Linux:

export XINGYI_API_KEY="YOUR_API_KEY"
codex

4. 验证接入

发送短消息,在使用记录核对实际调用。Base URL 填到 /v1 即可,客户端会构造 Responses 路径,不要填成 /v1/responses。

常见问题

进一步参考本站完整文档与Codex 配置参考。