先搞清楚：插件和 CLI 用同一份配置
Codex 的 VS Code 扩展（Cursor 里也能装）和 Codex CLI 是同一套程序，读的是同一个配置目录。你在终端里给 CLI 配好的 config.toml 和 auth.json，插件打开时会直接读取，不需要再配一遍。
- macOS / Linux：~/.codex/config.toml 和 ~/.codex/auth.json
- Windows：按 Win+R，输入 %userprofile%\.codex 回车，就是这个目录；目录不存在就手动新建一个
所以这篇教程的顺序是：先把 CLI 的配置写好，再装插件，最后在插件里确认它用的是本站。
小贴士：最省事的做法是登录控制台，到 API 密钥 页，点你那把密钥右侧的「使用」，在弹窗里切到 Codex CLI 页签，直接复制生成好的两个文件内容。弹窗会按你选的系统（macOS/Linux 或 Windows）给出正确的文件路径。
第一步：按 Codex CLI 教程配好
完整步骤在 Codex CLI 教程。这里只放最终要落到文件里的内容，方便你核对。
config.toml
控制台提示「请确保以下内容位于 config.toml 文件的开头部分」。如果文件是新建的，整个文件就是这些：
model_provider = "OpenAI"
model = "gpt-6.1-sol"
review_model = "gpt-6.1-sol"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.zyuou.com/v1"
model_catalog_url = "https://api.zyuou.com/v1/models"
wire_api = "responses"
requires_openai_auth = true
[features]
goals = true
三处要点：base_url 写到 /v1 为止，Codex 会自己拼上 /responses；wire_api 只能是 "responses"；model 填你想默认使用的模型名，后面还能在插件里换。
auth.json
{
"OPENAI_API_KEY": "sk-你的密钥"
}
把 sk-你的密钥 换成你在 API 密钥 页创建的那把。密钥明文只在创建时显示一次，当时没存下来就重新创建一把。
注意：控制台弹窗里有「兼容模式」和「API Key Mode」两个选项，新手用默认的「兼容模式」就行，它生成的就是上面这两个文件。另一种模式把密钥写进 config.toml、不生成 auth.json，用于客户端的图片执行器，一般用不到。
第二步：安装插件，处理登录状态
- 打开 VS Code（或 Cursor），进入扩展市场，搜索 Codex，安装 OpenAI 发布的那个扩展。
- 安装后侧边栏会多出一个 Codex 图标，点开它。
- 如果面板里显示你已经用 ChatGPT 账号登录，先退出登录。不退出的话，请求会走 ChatGPT 的订阅额度而不是本站，本站的使用记录里什么都看不到。
- 退出后，插件会重新读取配置目录。因为 auth.json 里已经有密钥，多数版本会直接进入可用状态；如果它弹出「用 ChatGPT 登录」和「使用 API Key」两种选择，选 API Key，然后粘贴 sk-你的密钥。
- 最后完全退出 VS Code 再重新打开。改过配置文件后，Codex 要重启才会重新读取；控制台在 API Key Mode 下也提醒「必须完全退出并重启 Codex Desktop 或 CLI，然后新建 task」。只关掉面板不算。
注意：插件的按钮文字和位置随版本变化，上面写的是通用说法，请以你装的版本为准。只要记住两件事：不要用 ChatGPT 登录；改过配置文件后要重启整个编辑器。
第三步：在插件里切换模型
有两种方法，效果一样。
- 在面板里选。插件的输入框附近有当前模型名，点它会出现可选列表。列表来自配置里的 model_catalog_url，也就是本站的 /v1/models 接口，所以看到的是你这把密钥所在分组允许的模型（远程目录需要 Codex 0.156.0 以上版本）。
- 改配置文件。把 config.toml 里的 model = "..." 改成别的模型名，保存后重启编辑器。
几个最常用的模型名和官方参考价（每百万 token，输入 / 输出）：
| 模型名 | 官方价 | 0.12× 分组实际扣 |
|---|---|---|
| gpt-6.1-sol | $2 / $10 | $0.24 / $1.20 |
| gpt-6-astra | $10 / $50 | $1.20 / $6.00 |
| gpt-5.6-luna | $0.2 / $1.2 | $0.024 / $0.144 |
1 元人民币 = 1 美元额度。模型名必须和列表里一字不差，大小写、横线都不能错。分组之间的区别看 分组怎么选。
第四步：确认请求走的是本站
- 在插件里随便发一句话，例如「你好」。
- 打开控制台的 使用记录 页，刷新。应该多出一条记录，密钥名是你刚才那把，模型名是你选的那个，并显示这次扣了多少额度。
- 如果等了一分钟还是没有记录，说明请求没经过本站。最常见的原因是插件仍在用 ChatGPT 登录，回到第二步退出登录并重启编辑器。
以后每天花了多少、哪把密钥花的、哪个模型花的，都在这一页。余额不够了去 充值与兑换。
还是不行？
插件里报错，先看错误文字，这几条是本站返回的：
- Invalid API key（HTTP 401）：密钥写错、多了空格，或密钥已被停用。到 API 密钥 页核对，必要时重新创建一把。
- API key 额度已用完（HTTP 429，type 为 insufficient_quota）：这把密钥的额度用完了，去 兑换 页充值。
- Concurrency limit exceeded …, please retry later（HTTP 429）：同时发出的请求太多，等几秒再试。
其他报错和对应的处理办法见 常见报错。解决不了就加 QQ 群 1104498354（备注「新手」），或联系客服 QQ 3480261526，把错误文字截图发过来。