Codex 专页

Codex CLI 接入 1A1API

如果你只用 Codex，不需要先看完整配置索引。按这一页写入配置，发送最小测试，再去调用日志确认成功。

适用版本：以当前 Codex 配置参考为准 最后验证：2026-07-20

打开 1A1API 控制台看调用日志

结论

Codex 要填 root，不要填 /v1

Codex 这类 Responses 客户端会自己拼接口路径。Base URL 推荐写 https://1a1api.top，认证密钥写到 ~/.codex/auth.json。

Base URLhttps://1a1api.top，不是 https://1a1api.top/v1。

模型 IDgpt-5.6-sol 仅作最小测试示例；实际可用模型以当前 API 密钥所属分组的模型列表为准。

认证文件~/.codex/auth.json 里放 OPENAI_API_KEY。

成功标准Codex 有回复，并且 1A1API 调用日志里出现本次请求。

普通配置

先用普通 Responses 配置跑通

~/.codex/config.toml

model_provider = "OpenAI"
model = "gpt-5.6-sol"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://1a1api.top"
wire_api = "responses"
requires_openai_auth = true

~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

~/.codex/auth.json 保存的是可直接使用的明文凭据，安全级别等同密码。不要发送完整文件，不要把真实 API 密钥放进群聊、公开截图、工单正文或 Git 仓库；排错时只提供密钥名称或脱敏尾号。

先只复制跑通所需字段。推理强度、网络权限、上下文压缩阈值等设置会改变行为或资源消耗，应在最小测试成功后按需要单独配置。如果你是写代码调用 API，请看 OpenAI SDK 专页。

WebSocket

只有客户端和服务端都支持时再开 WebSocket

默认先使用普通 Responses 配置。确认当前 Codex 版本和对应服务端都支持 WebSocket 后，才为这个 Provider 增加可选字段。

放进现有 [model_providers.OpenAI] 下

supports_websockets = true

不要再写第二个 [model_providers.OpenAI] 表头，只把这一行加入上方已有表中。旧版本使用的实验性 responses_websockets_v2 不在当前 Codex 配置参考中，不建议继续复制。若启用后连接失败，删除 supports_websockets 并回到普通 Responses 配置。参见 Codex 配置参考。

常见错法

Codex 报错先查这 4 个点

404 或接口路径不存在多半是把 Base URL 写成 /v1 或重复拼了 /v1/v1。改回 https://1a1api.top。

401 Unauthorized检查 auth.json 里的 API 密钥是否完整，是否多了空格、换行、省略号。

403 Forbidden检查 API 密钥所属分组是否支持模型、Responses、Compact，以及余额或订阅额度是否可用。

日志里没有请求说明 Codex 可能没读到配置，或网络/代理拦住了请求。先重开终端，再看调用日志。