1. 安装并打开 Codex
先安装 Codex 桌面应用。可以从 OpenAI Codex 官网 下载，也可以在 Microsoft Store 搜索 Codex 安装。
安装完成后，Codex 不一定会自动在桌面生成图标，也可能不会固定到任务栏。Windows 用户可以直接在任务栏搜索框里搜索 Codex，找到后右键固定到任务栏，之后打开会方便很多。
第一次打开 Codex 前，建议先把配置文件里的服务地址改好。这样后面使用 API Key 登录时，不容易连到默认地址。
2. 修改 Codex 配置文件
Codex 的配置文件一般在你当前 Windows 用户目录下：
C:\Users\你的用户名\.codex\config.toml可以按下面步骤找到它：
- 打开系统盘，一般是
C:。 - 进入
用户文件夹。 - 打开你自己的用户文件夹。
- 找到
.codex文件夹。 - 打开里面的
config.toml文件。
如果你看不到 .toml 后缀，说明 Windows 隐藏了文件扩展名。可以在文件资源管理器顶部点击“查看”，找到“显示”，勾选“文件扩展名”。
用记事本或 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"
wire_api = "responses"
requires_openai_auth = true保存时建议直接按 Ctrl + S。如果用记事本，也可以关闭窗口时选择保存。
推荐写成站点里显示的 API 端点：https://yohohoho.online。不要在后面手动拼接 /v1、/api/v1 或具体接口路径。
3. 创建 YOHOHOHO API Key
打开 YOHOHOHO 用户中心，登录你的账号。进入后点击左侧菜单里的“API 密钥”。
点击右上角“创建密钥”。创建时需要填写密钥名称，并选择分组。
名称建议写得容易区分，例如：
自己的电脑宿舍台式机朋友A公司笔记本
分组会影响这个 Key 可以使用哪些模型和倍率。不要随便选错分组，如果不确定就先使用默认或管理员推荐的分组。
创建完成后，回到 API 密钥列表，点击密钥旁边的复制按钮。
sk-... 是你的消费凭证。别人拿到后可能直接消耗你的余额。不要把完整 Key 发到群里，也不要发未打码截图。
4. 使用 API Key 登录 Codex
打开 Codex。第一次打开时界面可能是英文，也可能是中文，按钮位置基本一致。
在登录页选择“使用其他方式登录”。英文界面一般对应 “Use another login method” 或类似按钮。
然后选择使用 API Key 登录，把刚刚从 YOHOHOHO 用户中心复制的密钥粘贴进去。
登录成功后，可以用一个最短测试确认连接正常：
codex exec "只回复 OK"如果返回 OK，说明 Codex 已经能通过 YOHOHOHO 调用模型。
5. 在项目文件夹中使用 Codex
Codex 既可以像网页版一样直接对话，也可以绑定一个项目文件夹，让它在指定工作区里读写文件。
在 Codex 左侧找到“项目”区域。把光标移动到项目位置，右侧通常会出现“新建空白项目”或“使用现有文件夹”之类的选项。
建议新手先这样使用：
- 为每个任务单独建一个文件夹。
- 在 Codex 里选择这个文件夹作为项目。
- 之后让 Codex 创建、修改、解释文件时，都尽量围绕这个项目文件夹进行。
如果你希望文件保存到其他位置，也可以在提示词里写清楚具体路径。但对新手来说，让 Codex 固定在一个项目文件夹里更稳。
6. 常见问题
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 登录失败或一直连不上 | base_url 写错，或配置文件没有保存 | 检查 config.toml，确认是 https://yohohoho.online，保存后重启 Codex |
提示 401 Unauthorized | API Key 复制错、Key 被禁用、登录缓存异常 | 重新复制 Key，必要时在用户中心重新创建一个 Key |
| 账号有余额但用不了 | API Key 没有可用分组，或分组里没有对应模型 | 回到 API 密钥页面检查分组，或联系管理员 |
提示 upstream HTTP 400 | 模型名、协议或上游渠道不匹配 | 换一个可用模型；如果仍不行，把完整报错发给管理员 |
| 修改配置后没有变化 | Codex 没重启，或项目目录里有局部配置覆盖 | 关闭并重新打开 Codex，再检查项目内是否有 .codex/config.toml |
7. 安全提醒
- 不要公开完整 API Key。
- 不要把
~/.codex/auth.json、config.toml或完整终端截图发到公开群。 - 每台设备可以单独创建一个 Key，后续更容易查看用量和单独停用。
- 如果怀疑 Key 泄露，立刻到用户中心禁用旧 Key，并创建新 Key。
- 公共电脑或临时电脑使用完后，记得退出 Codex，并删除保存过的密钥。
完成以上步骤后，就可以开始使用 Codex 了。祝你猛猛开工。