Codex 专页

Codex CLI 接入 1A1API

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

打开控制台 · 复制 API Key 看调用日志 Codex 报错排查

结论

Codex 要填 root，不要填 /v1

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

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

模型 ID先用 gpt-5.5 跑通；轻量任务再换 mini。

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

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

普通配置

先用普通 Responses 配置跑通

~/.codex/config.toml

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[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 CLI 使用。里面的 xhigh、model_context_window、model_auto_compact_token_limit 等字段属于 Codex 类客户端配置，不适合直接复制到普通 OpenAI SDK。如果你是写代码调用 API，请看 OpenAI SDK 专页。

WebSocket

只有客户端支持时再开 WebSocket

不确定版本是否支持时，先用普通配置。普通配置能跑通后，再加下面两项。

在 config.toml 里增加

[model_providers.OpenAI]
supports_websockets = true

[features]
responses_websockets_v2 = true

常见错法

Codex 报错先查这 4 个点

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

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

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

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