Codex 走 OpenAI 兼容协议，因此接入 Zivv 很直接：把 OpenAI 的请求地址换成 Zivv，API Key 换成 Zivv Key。真正需要注意的是团队怎么分发 Key、模型怎么选、出错时怎么判断问题。
适合谁读
这篇适合三类用户：
- 已经在用 Codex，希望降低调用成本
- 团队里同时用 Claude Code 和 Codex，想统一账单
- 自己的工具链只支持 OpenAI 协议，但想调用更多模型
Zivv 的定位是统一入口。你可以用 OpenAI 兼容方式调用，也可以用 Anthropic 兼容方式调用，Key 可以统一管理。
基础配置
设置两个环境变量：
export OPENAI_BASE_URL=https://zivv.pro/v1
export OPENAI_API_KEY=sk-your-key-here
codexWindows PowerShell：
$env:OPENAI_BASE_URL="https://zivv.pro/v1"
$env:OPENAI_API_KEY="sk-your-key-here"
codex注意：OpenAI 兼容入口通常需要 /v1，Anthropic 入口则使用根域名。很多配置失败都来自这两个地址混用。更完整的参数和客户端示例见 Codex CLI 配置文档 和 OpenAI SDK 接入文档。
模型选择建议
Codex 场景可以按任务分层：
| 任务 | 推荐策略 |
|---|---|
| 小改动、解释代码 | 低成本通用模型 |
| 多文件重构 | 强推理模型 |
| 生成测试、补文档 | 中等模型即可 |
| 复杂架构判断 | 顶配模型短时间使用 |
不要所有任务都默认最贵模型。更好的方式是：日常用通用模型，卡住时再临时切强模型。
团队分发方式
团队里最怕两件事：Key 到处复制、账单看不清。推荐做法：
- Owner 创建团队
- 给每个成员发独立 Key
- 给自动化任务单独建 Key
- 设置日预算或月预算
- 每周看一次用量排行
这样可以把 Codex、Claude Code、CI 任务、业务服务端调用分开，不会混成一笔账。
常见错误排查
401 或 unauthorized 通常是 Key 填错、复制时多了空格，或者用了已经停用的团队 Key。错误含义可以对照 错误码说明。
404 或 model not found 检查模型名是否可用，或者当前 Key 所在分组是否有这个模型。可对照 模型列表文档。
请求走到官方 OpenAI 说明 OPENAI_BASE_URL 没生效。确认启动 Codex 的终端就是设置环境变量的同一个终端。
中文内容乱码 这通常不是 API 问题，而是终端编码或日志查看器问题。先用简单英文问题验证链路。
与 Claude Code 一起用
很多开发者会组合使用：
- Claude Code：处理长上下文代码任务
- Codex：处理 OpenAI 生态工具、脚本和自动化
- Zivv：统一 Key、统一账单、统一模型入口
这比每个工具分别绑官方账号更清晰，也更容易控制成本。
结论
Codex 接入 Zivv 的核心就是两项配置：OPENAI_BASE_URL=https://zivv.pro/v1 和 Zivv API Key。个人用户可以直接用；团队用户建议从第一天就按成员和项目拆 Key，后面排查和控费会轻松很多。