YOHOHOHO Codex 使用教程

1. 下载codex应用现在codex的应用已经上Windows了，所以没必要继续在终端使用，这里的第一步就... 2. 配置 Codex安装好codex后完成以下文件的配置 3. 测试是否成功进入任意项目目录，执行一个最短测试： 4. 日常使用建议- 先在小项目里测试，确认模型、余额、速度都正常，再用于正式工作。 - 每个设备可以...

1. 下载codex应用

现在codex的应用已经上Windows了，所以没必要继续在终端使用，这里的第一步就是下载codex应用。

打开下载网站：打开 https://openai.com/zh-Hans-CN/codex/，并下载到你的download文件夹里。
安装：这里不做详细描述，你按照你的习惯安装好就可以了。

Base URL 写法

Codex 推荐填写 https://yohohoho.online/v1。不要写成 /api/v1，也不要把具体接口路径继续拼到后面。

2. 配置 Codex

安装好codex后完成以下文件的配置

打开你的系统盘找到用户，然后进入你自己的用户名命名的文件夹里

在这里你需要找到.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 登录缓存。