1. 准备账号和密钥
先在用户中心完成账号、余额和 API Key。Codex 使用的是你自己创建的 API Key，不需要管理员账号。
- 登录用户中心：打开
https://yohohoho.online，注册或登录你的账号。 - 充值或兑换余额：进入充值或兑换页面，确保账号余额大于 0。
- 创建 API Key：进入 API 密钥页面，创建一个新的密钥，并立即复制保存。密钥通常只完整显示一次。
Base URL 写法
Codex 推荐填写 https://yohohoho.online/v1。不要写成 /api/v1，也不要把具体接口路径继续拼到后面。
2. 配置 Codex
推荐用环境变量保存 API Key，再在 Codex 配置里读取这个环境变量。这样不会把密钥明文写进配置文件。
Windows PowerShell
把下面命令里的 sk-xxxxxxxx 换成你自己的 API Key。执行后重新打开终端或重启 Codex。
setx YOHOHOHO_API_KEY "sk-xxxxxxxxxxxxxxxx"macOS / Linux
如果你用的是 zsh，执行下面这段；如果用 bash，把 ~/.zshrc 换成 ~/.bashrc。
echo 'export YOHOHOHO_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc编辑 Codex 配置文件
配置文件路径如下。没有这个文件就新建一个。
| 系统 | 配置文件路径 |
|---|---|
| Windows | %USERPROFILE%\.codex\config.toml |
| macOS / Linux | ~/.codex/config.toml |
把下面配置加入到 config.toml。如果文件里已经有 model 或 model_provider，以你最后保留的一份为准，避免重复。
model_provider = "yohohoho"
model = "gpt-5.5"
[model_providers.yohohoho]
name = "YOHOHOHO"
base_url = "https://yohohoho.online/v1"
wire_api = "responses"
env_key = "YOHOHOHO_API_KEY"模型名说明
model = "gpt-5.5" 只是示例。实际能用哪些模型，以用户中心的可用渠道和管理员公告为准。
3. 测试是否成功
进入任意项目目录，执行一个最短测试：
codex exec "只回复 OK"如果返回 OK，说明 Codex 已经能通过 YOHOHOHO 调用模型。
4. 日常使用建议
- 先在小项目里测试，确认模型、余额、速度都正常，再用于正式工作。
- 每个设备可以创建一个单独的 API Key，方便后续查看用量或单独停用。
- 余额不足、Key 被停用、分组不可用，都会导致 Codex 无法正常调用。
- 不要把 API Key 发给别人，也不要截图暴露完整密钥。
5. 常见错误
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
401 Unauthorized | API Key 输错、Key 被禁用、环境变量没有生效。 | 重新复制 Key，重启终端或 Codex，再执行测试命令。 |
| 账号有余额但用不了 | Key 没有绑定可用分组，或所选模型所在渠道不可用。 | 到 API 密钥页面检查 Key 状态和分组，或联系管理员。 |
404 或连接失败 | Base URL 写错。 | 确认是 https://yohohoho.online/v1。 |
upstream HTTP 400 | 模型、协议或上游渠道不匹配。 | 换一个可用模型；如果仍不行，把完整报错发给管理员。 |
| 修改配置后还是没变化 | Codex 没重启，或项目目录里还有局部配置覆盖。 | 重启 Codex，并检查项目里的 .codex/config.toml。 |
6. 安全提醒
sk-...是你的消费凭证，泄露后别人可能直接消耗你的余额。- 不要把
~/.codex/auth.json、config.toml、终端截图发到公开群里。 - 如果怀疑密钥泄露，立刻到用户中心停用旧 Key，并创建新的 Key。
- 公共电脑或临时电脑使用完后，记得删除环境变量和 Codex 登录缓存。