配置 Codex CLI

为 Codex CLI 设置 1A1API 提供商和认证信息，再发送一条短请求验证。已有配置只合并必要字段，不整文件覆盖。

适用范围：Codex CLI，不含桌面端定制 内容核对：2026-10-10 客户端实测：本轮未执行当前版本接入测试

查看适用版本与验证记录

适用客户端Codex CLI，按本页的 Shell 或 Windows PowerShell 示例操作；桌面端定制另看对应排查页。

已验证版本尚未建立当前版本的真实 1A1API 接入实测记录。官方配置核对与帮助页浏览器检查，不等于客户端调用成功。

反馈时附什么提供 CLI 版本、操作系统、终端类型和出错步骤；使用反馈模板，不要附完整认证文件。

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

结论

确认 Codex 接口根地址

本页的 1A1API Codex 配置使用 https://1a1api.top。推荐创建独立提供商，用环境变量传入密钥，保留已有官方登录与其他提供商设置。OpenAI SDK 的地址填法另见 SDK 教程。

Base URL按本页示例填写 https://1a1api.top，不要把完整 /responses 请求路径当作根地址。

模型 ID把 YOUR_MODEL_ID 换成当前 API 密钥可用且支持 Responses 的模型 ID。

密钥来源独立环境变量 ONEAONE_API_KEY；本页配置不要求手工改写 auth.json。

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

普通配置

合并最小配置

已有配置先备份，只合并下列必要字段，不要覆盖其他 Provider 或账号设置。macOS / Linux 的 ~ 指当前用户主目录；Windows PowerShell 可从 $HOME\.codex 找到配置。若在 WSL 运行，请使用 WSL 内的主目录。

~/.codex/config.toml

model_provider = "oneaone"
model = "YOUR_MODEL_ID"

[model_providers.oneaone]
name = "1A1API"
base_url = "https://1a1api.top"
wire_api = "responses"
env_key = "ONEAONE_API_KEY"
requires_openai_auth = false

macOS / Linux：当前终端

export ONEAONE_API_KEY="sk-your-api-key"

Windows PowerShell：当前会话

$env:ONEAONE_API_KEY="sk-your-api-key"

先替换模型和密钥占位符，按下方步骤在设置变量的同一终端中启动 Codex。关闭终端后需要重新设置。env_key 与 requires_openai_auth = false 是官方支持的网关配置方式，见连接模型网关。

已有 CC Switch 或 auth.json 配置怎么办？

已经由 CC Switch 管理且能正常调用的配置可以继续使用。排错时先确认当前启用的提供商与它使用的认证方式，不要把两套示例同时叠加，也不要覆盖已有 auth.json。新建独立提供商时，保留其他表和登录信息，只合并本页字段。

环境变量、终端历史和 auth.json 都可能包含可直接使用的凭据。不要打印完整认证文件或请求头，不要把密钥放入截图、工单或仓库；只提供密钥名称、脱敏尾号与“是否已设置”等状态。

先完成最小测试，再按需要调整推理强度、网络权限或上下文压缩阈值；这些选项会影响行为或资源消耗。代码调用示例见OpenAI SDK 教程。

最小测试

发送第一条测试请求

先确认当前 API 密钥有可用额度和目标模型权限。测试会消耗实际额度，只需发送一次，不要附带项目文件。

启动 Codex CLI

保存配置后，在自己的测试目录打开终端，运行 codex。若提示找不到命令，先检查客户端安装，不要用重复充值解决。

在对话输入框发送

Reply with exactly: ok。这里是在 Codex 对话框发送，不是在系统终端执行这句话；不需要请求读取文件或运行命令。

确认回复与日志对应

收到回复后，到 1A1API 调用日志按测试时间核对模型、状态和费用。只有客户端回复和对应日志都出现，才算通过。

日志里没有请求时先查配置是否生效；日志有请求但失败时，按 401、403 或 404 继续排查。CLI 启动方式参见 OpenAI 官方文档；本页示例不代表当前版本和当前分组已完成实机验证。

WebSocket

可选：启用 WebSocket

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

放进现有 [model_providers.oneaone] 下

supports_websockets = true

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

常见错法

配置失败时检查

404 或接口路径不存在核对当前提供商、Base URL 和最终请求路径，排除 /v1/v1 或重复的 /responses。本页示例用 https://1a1api.top；其他客户端按对应教程配置。

401 Unauthorized确认启动 Codex 的终端已设置 ONEAONE_API_KEY，提供商的 env_key 与变量名一致。使用 CC Switch 管理的认证时，先核对当前提供商和认证状态，不打印完整文件。

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

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