YOHOHOHO Codex Guide

Codex 配置和使用教程

这份教程适合第一次使用 Codex 的用户。按顺序完成安装、配置 Base URL、创建 API Key、登录 Codex 和选择项目文件夹后，就可以通过 YOHOHOHO 在本地使用 Codex。

开始配置 打开用户中心
PS C:\project> codex exec "只回复 OK"
Using model provider: yohohoho
Base URL: https://yohohoho.online/v1
OK

1安装并打开 Codex

这一节先完成三件事：

  • 检查 C:\Users 里的真实用户名是不是英文。
  • 安装 Codex 桌面应用。
  • 从任务栏搜索打开 Codex，但先不要急着登录。

先检查 Windows 用户目录名

打开文件资源管理器，进入 C:\Users。这里看的不是桌面昵称，而是真实用户文件夹名。

  • 如果文件夹名像 fuboy、yoho、admin 这样是英文，可以继续安装。
  • 如果文件夹名是中文，建议先切换到英文用户名的 Windows 账户，或者新建一个英文用户名账户后再安装 Codex。
  • 不建议只改桌面显示昵称，因为它不一定会改掉 C:\Users\... 这个真实路径。

再安装 Codex

确认用户目录没问题后，再安装 Codex 桌面应用。可以从 OpenAI Codex 官网 下载，也可以在 Microsoft Store 搜索 Codex 安装。

最后打开并固定 Codex

安装完成后，先不要急着登录。Codex 不一定会自动在桌面生成图标，也可能不会固定到任务栏。Windows 用户可以直接在任务栏搜索框里搜索 Codex，找到后右键固定到任务栏，之后打开会方便很多。

如果安装结束后自动弹出了登录界面，可以先关掉。下一步先把配置文件写好，再回来用 API Key 登录。

在 Windows 搜索栏中找到 Codex

先别急着登录

第一次使用 API Key 登录前，建议先把配置文件里的服务地址改好。这样后面登录时会直接连到 YOHOHOHO，不容易连到默认地址。

2修改 Codex 配置文件

先找到 Codex 的配置文件位置。它一般在你当前 Windows 用户目录下：

C:\Users\你的用户名\.codex\config.toml

按这个顺序进入：

  1. 打开系统盘，一般是 C:。
  2. 进入 用户 文件夹。
  3. 打开你自己的用户文件夹。
  4. 找到 .codex 文件夹。
  5. 打开里面的 config.toml 文件。

确认或新建 config.toml

如果 .codex 里没有 config.toml 文件，也可以自己新建。最简单的做法是右键新建文本文档，改名为 config.toml。

如果你看不到 .toml 后缀，说明 Windows 隐藏了文件扩展名。可以在文件资源管理器顶部点击“查看”，找到“显示”，勾选“文件扩展名”。保存前请确认文件名是 config.toml，不是 config.toml.txt。

复制下面这段配置

用记事本或 VS Code 打开 config.toml，把下面整段配置复制进去。如果文件里原本已经有重复的 model_provider 或同名 [model_providers.xxx]，建议先清理掉，避免多个配置互相覆盖。

model_provider = "yohohoho"
model = "gpt-5.5"

[model_providers.yohohoho]
name = "YOHOHOHO"
base_url = "https://yohohoho.online/v1"
wire_api = "responses"
requires_openai_auth = true

保存时建议直接按 Ctrl + S。如果用记事本，也可以关闭窗口时选择保存。

Base URL 不要写错

这里请写成：https://yohohoho.online/v1。不要写成 https://yohohoho.online，也不要改成 /api/v1 或拼接其它接口路径。

3创建 YOHOHOHO API Key

这一节的目标是拿到一串 sk-... 开头的 API Key。按三个动作来做：进入密钥页、创建密钥、复制密钥。

进入 API 密钥页

打开 YOHOHOHO 用户中心，登录你的账号。进入后台后，点击左侧菜单里的“API 密钥”。

进入 API 密钥页面

创建密钥并选择分组

点击右上角“创建密钥”。创建时需要填写密钥名称，并选择分组。

创建 API 密钥并选择分组

名称建议写得容易区分，之后你看用量或停用某个设备时不会混乱。可以这样写：

  • 自己的电脑
  • 宿舍台式机
  • 朋友A
  • 公司笔记本

分组会影响这个 Key 可以使用哪些模型和倍率。不要随便选错分组，如果不确定就先使用默认或管理员推荐的分组。

复制并保存密钥

创建完成后，回到 API 密钥列表，点击密钥旁边的复制按钮。

复制 API 密钥，示例截图已脱敏

密钥只保存给自己

sk-... 是你的消费凭证。别人拿到后可能直接消耗你的余额。不要把完整 Key 发到群里，也不要发未打码截图。

4使用 API Key 登录 Codex

这一节把刚刚复制的 API Key 填进 Codex。只要登录成功，并且测试命令返回 OK，就说明连接已经跑通。

选择其他方式登录

打开 Codex。第一次打开时界面可能是英文，也可能是中文，按钮位置基本一致。

在登录页选择“使用其他方式登录”。英文界面一般对应 “Use another login method” 或类似按钮。

Codex 登录页选择其他方式登录

粘贴 API Key

然后选择使用 API Key 登录，把刚刚从 YOHOHOHO 用户中心复制的密钥粘贴进去。

如果粘贴后提示失败，先不要反复重试。回到前面的配置文件，确认 base_url 已经保存为 https://yohohoho.online/v1，然后关闭并重新打开 Codex。

运行最短测试

登录成功后，可以用一个最短测试确认连接正常：

codex exec "只回复 OK"

如果返回 OK，说明 Codex 已经能通过 YOHOHOHO 调用模型。

5在项目文件夹中使用 Codex

这一节决定 Codex 在哪里读写文件。新手建议先绑定一个专门的项目文件夹，文件不容易乱放，也更容易回头检查。

选择项目文件夹

在 Codex 左侧找到“项目”区域。把光标移动到项目位置，右侧通常会出现“新建空白项目”或“使用现有文件夹”之类的选项。

选择项目文件夹作为工作区

新手建议这样用

建议新手先这样使用：

  1. 为每个任务单独建一个文件夹。
  2. 在 Codex 里选择这个文件夹作为项目。
  3. 之后让 Codex 创建、修改、解释文件时，都尽量围绕这个项目文件夹进行。

需要指定其它位置时

如果你希望文件保存到其他位置，也可以在提示词里写清楚具体路径。但对新手来说，让 Codex 固定在一个项目文件夹里更稳。

6常见问题

如果配置过程中卡住，先按现象对照下面几项。大多数问题都来自配置文件没保存、地址写错、密钥复制错或 Codex 没重启。

登录失败或一直连不上

  • 检查 config.toml 是否保存成功。
  • 确认 base_url 是 https://yohohoho.online/v1。
  • 保存后关闭并重新打开 Codex。

提示 401 Unauthorized

  • 重新复制一次 API Key，确认没有少复制或多复制空格。
  • 如果 Key 被禁用，回到用户中心重新创建一个 Key。
  • 如果仍然失败，可以退出 Codex 后重新登录。

账号有余额但用不了

  • 回到 API 密钥页面检查这个 Key 的分组。
  • 确认分组里有可用模型。
  • 如果不确定该选哪个分组，联系管理员确认。

提示 upstream HTTP 400

  • 先换一个可用模型再试。
  • 如果仍不行，把完整报错发给管理员。
  • 不要只截图一小段错误，完整报错更容易判断问题。

修改配置后没有变化

  • 关闭并重新打开 Codex。
  • 检查项目文件夹里是否还有局部 .codex/config.toml 覆盖了全局配置。
  • 如果你改过多个配置文件，优先保留一个最确定的位置，避免互相覆盖。

7安全提醒

API Key 相当于你的使用凭证。配置能跑通之后，最重要的是别把密钥泄露出去。

不要公开这些内容

  • 不要公开完整 API Key。
  • 不要把 ~/.codex/auth.json 发到公开群。
  • 不要发未打码的终端截图、配置截图或用户中心截图。

每台设备单独建一个 Key

每台设备可以单独创建一个 Key。这样后续更容易查看用量，也方便只停用某一台设备的密钥。

怀疑泄露时立刻处理

如果怀疑 Key 泄露，立刻到用户中心禁用旧 Key，并创建新 Key。公共电脑或临时电脑使用完后，也要记得退出 Codex，并删除保存过的密钥。

完成以上步骤后，就可以开始使用 Codex 了。祝你猛猛开工。