Codex（OpenAI CLI）

通过 OneProvider 的流式 Responses API 运行新的本地 Codex 任务。

Codex 编程智能体 CLI 与桌面应用

支持的功能

支持流式响应、函数调用、apply_patch 等本地工具以及用量统计。此设置只对新建的本地 CLI、桌面端和 IDE 任务生效，不会改变 Codex 云端对话。

客户端限制

更改服务商后，请重启 Codex 并新建一个本地任务。已有的任务会沿用它们启动时的模型和服务商。

设置

1. 安装或检查 Codex

   如果 codex --version 已经能输出版本号，请直接继续；否则请安装最新版 CLI。

   npm install --global @openai/codex
   codex --version

2. 准备一个专用密钥

   创建一个专用的 OneProvider 密钥，并在启动 Codex 的同一个终端会话中 export 它。

   export ONEPROVIDER_API_KEY="sk-your-key-here"

3. 添加自定义服务商

   打开 ~/.codex/config.toml（桌面端：Settings → Configuration → Open config.toml，即设置 → 配置 → 打开 config.toml），并添加 OneProvider 服务商。

   model_provider = "oneprovider"
   model = "gpt-6.1-sol"
   [model_providers.oneprovider]
   name = "OneProvider"
   base_url = "https://api.oneprovider.dev/v1"
   env_key = "ONEPROVIDER_API_KEY"
   wire_api = "responses"

4. 重启并测试一个新的本地任务

   CLI 用户应运行一次只读探测。桌面端用户必须完全退出、重新打开，并新建一个本地任务。

   codex

验证连接

在仪表板中确认请求

完成的请求应显示所选的模型、/v1/responses、token 用量和实际扣费金额。

连接信息

协议

responses

接口地址

https://api.oneprovider.dev/v1

密钥安全

请使用专用的、限定范围的密钥。在 macOS 上，从 Dock 打开的桌面应用可能不会继承终端的环境变量；请使用 Codex 由命令提供的钥匙串认证，而不要把机密写进 config.toml。

如何选择模型

在同一个 config.toml 里，于 model_provider 下面设置 model。gpt-6.1-sol 是旗舰档，适合复杂的智能体任务；gpt-6.1-terra 是均衡的默认选择，适合日常工作；gpt-5.6-luna 是低成本档，适合大批量和快速任务。Codex 使用 Responses API，所以请从模型页面 选择 GPT ID；费率见价格页面 。

常见错误与解决办法

401，或 “missing credentials”

Codex 看不到 ONEPROVIDER_API_KEY。请在启动 Codex 的那个终端里 export 它。在 macOS 上，从 Dock 打开的桌面应用不会继承它：请使用由命令提供的钥匙串认证。

404

base_url 必须是带 /v1 的 https://api.oneprovider.dev/v1，并且 wire_api 必须是 "responses"。

Codex 仍在使用旧的模型或服务商

已有的任务会沿用它们启动时的服务商。请重启 Codex，并新建一个本地任务。

“You've hit your usage limit”，或 Codex 要我登录 ChatGPT

这是 ChatGPT 订阅的额度限制：请求发到了 ChatGPT，说明 OneProvider 服务商没有生效。请把 model_provider = "oneprovider" 放在 config.toml 的最顶部，位于任何 [table] 之前（不要用智能引号），完全退出 Codex，然后新建一个本地任务。接着用 codex logout 退出 ChatGPT 登录（桌面应用：在其设置中），再在已 export ONEPROVIDER_API_KEY 的终端里启动 codex：服务商生效后，只凭密钥就能工作。快速测试：codex -c model_provider=oneprovider。wire_api 只接受 "responses"。

429 “Insufficient balance”

余额或密钥的限额已用完。请充值余额；重试没有用。

常见问题

这会改变 Codex 云端对话吗？

不会，只影响新建的本地 CLI、桌面端和 IDE 任务。

需要 OpenAI 账号吗？

不需要，本地任务由 OneProvider 密钥代替。

能在 Codex 里使用 Claude 模型吗？

Codex 使用 Responses API 和 GPT ID。要使用 Claude，请用 Claude Code 。

在哪里查看费用？

在仪表板的“用量”页面：每个请求都会显示模型、/v1/responses 和实际扣费金额。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。