白云 API 教程：Codex CLI 接入
自定义 Responses 供应商、环境变量及压缩和搜索的实际边界。 附完整检查步骤、实操验证和错误处理。
Codex CLI 接入
准备
先安装官方 Codex CLI，确认终端中 codex --version 能输出版本；备份自己已有的 ~/.codex/config.toml。不要用一份新配置覆盖原来的 MCP、项目权限或其他供应商设置。
添加本站供应商
将下面内容合并到配置文件，顶层 model 与 model_provider 不要重复定义：
model = "gpt-6-luna"
model_provider = "baiyun"
[model_providers.baiyun]
name = "白云超级智能"
base_url = "https://api.baiyun.si/v1"
env_key = "BAIYUN_API_KEY"
wire_api = "responses"在启动 Codex 的同一终端设置 BAIYUN_API_KEY；Windows PowerShell 使用环境变量方式，Linux / macOS 使用终端环境变量。不要把密钥硬编码在 TOML 的公开副本里。桌面与终端进程的环境不一定相同，切换启动方式后应重新核对。
验证顺序
- 重启读取配置的 Codex 进程。
- 查看实际选择的模型和供应商是否为
baiyun。 - 在临时测试目录发送一句简短问题，观察流式结果与本站消费日志。
- 需要工具时，从读取一个测试文件开始；执行命令和修改文件仍遵循 Codex 的权限设置。
本站密钥是自定义供应商凭据，不是 ChatGPT 登录凭据，也不赋予官方订阅权益。
上下文、搜索与额度
本站已接入原生账户信息、模型列表、Responses、压缩、独立搜索和额度相关桥接路径。路径开放不代表上游每项功能稳定可用：上下文压缩此前收到上游 404，应记录错误并等待修复，不能承诺永远不会报错。独立搜索还取决于客户端版本、运行时和模型支持；只有确认需要且版本支持时才添加 supports_standalone_web_search = true。本站 DK 钱包不因上游用量周期更新而重置为免费余额。
官方资料
Codex 自定义供应商配置。本页针对本站写法，不把第三方网关等同官方 OpenAI 服务。
实操前的检查清单
- 准备自己的账户与调用密钥，不使用他人的共享凭据。
- 记录客户端版本、系统和准备使用的模型，便于排查时复现。
- 保存原配置或截图，隐藏密钥、验证码与私人内容。
- 确认测试可能消费少量 DK，先用一句话、一次请求开始。
- 查阅当前模型广场与状态页，再决定是否启用更多功能。
详细排查：配置不生效
先确认合并的是实际用户目录下的 config.toml，而非项目里的同名文件。查看顶层 model_provider 是否指向 baiyun，env_key 是否与终端变量名一致。配置重名会导致启动失败，GUI 从桌面启动时不一定继承终端变量。不要删除全部配置来排错，也不要放开命令执行权限来修复网络问题。
怎样确认本节已经学会
不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议，能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准；账户教程以安全信息完善为标准；计费教程以本金、通道费与 DK 的对应关系核对为标准。
如果出现错误，记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥，也不要把密码和验证码交给其他人。对 401 应先解决认证，对 400 应先解决参数，对 429 应停止密集重试，对 404 应核对请求路径与上游是否实现，不能用重新充值解决所有报错。
一个适合练习的小任务
在自己的测试环境完成本节的最小步骤，用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能，先查看对应协议教程，再考虑添加功能；一次只变更一个配置，容易判断哪一步导致错误。
下一步与版本边界
返回完整学习地图 · API 站精简配置 · 本站实时状态。
教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化；配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准；压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。