VS Code 中 Codex 使用中转站教程

这篇只讲一种场景：在 VS Code 里面安装 OpenAI 官方 Codex 扩展，然后使用我们的中转站 https://zhuangliping.site 作为 API 服务。
整个流程分成四步：
  1. 安装 VS Code。
  1. 在 VS Code 里安装 Codex 扩展。
  1. 在中转站注册、登录并创建 API Key。
  1. 在 VS Code Codex 扩展里选择 API 模式，粘贴 API Key，并写入 config.toml。
注意：API Key 只给自己使用，不要发到群里，也不要截图公开。

1. 下载并安装 VS Code

打开 VS Code 官方下载页：
Windows 用户选择 Windows，macOS 用户选择 Mac，Linux 用户按自己的发行版选择 .deb、.rpm 或其他安装方式。
VS Code 官方下载页
VS Code 官方下载页
下载完成后，正常双击安装即可。Windows 用户如果不确定选哪个版本，优先下载 User Installer x64。

2. 安装 Codex 扩展

打开 VS Code，点击左侧扩展图标，在搜索框里输入：
选择名称为 Codex - OpenAI's coding agent 的扩展，发布者必须是 OpenAI，然后点击安装。
VS Code 扩展市场搜索 Codex
VS Code 扩展市场搜索 Codex
也可以在浏览器中打开 VS Code Marketplace 页面确认扩展信息：
OpenAI Codex 扩展官方 Marketplace 页面
OpenAI Codex 扩展官方 Marketplace 页面
不要安装同名的第三方扩展。这里要选 OpenAI 官方的 Codex - OpenAI's coding agent。

3. 打开中转站

打开我们的中转站：
进入首页后，点击 立即开始 或右上角登录入口。
中转站首页
中转站首页
如果还没有账号，进入注册页：
按页面要求填写邮箱、密码、邀请码等信息。
中转站注册页
中转站注册页
已有账号的同学直接进入登录页：
中转站登录页
中转站登录页

4. 创建 API Key

登录后进入后台，找到 API 密钥 页面，然后新建 API Key。
新建时注意选择正确分组。如果页面里有分组选项，请选择 订阅a 分组。
创建完成后，API Key 通常只会显示一次，记得复制保存。
不要把自己的完整 API Key 发给别人。截图、群消息、博客里都只保留类似 sk-xxxx 的脱敏写法。

5. 点击“使用密钥”

在 API 密钥 列表里找到刚创建的 Key，点击右侧操作区里的 使用密钥。
在 API 密钥列表中点击使用密钥
在 API 密钥列表中点击使用密钥
弹窗打开后，选择 Codex CLI，再按自己的系统选择 Windows 或 macOS / Linux。
然后点击配置文件右侧的 复制，把网站生成的 config.toml 配置复制下来。
复制 Codex CLI 配置文件
复制 Codex CLI 配置文件
这里复制的是 Codex 配置文件内容，不只是 API Key。后面要把它粘贴到 VS Code Codex 使用的 config.toml 里。
需要特别注意：
  • 中转站基础地址是 https://zhuangliping.site。
  • 不要在地址后面自己加 /v1。
  • 配置文件以网站弹窗里复制出来的内容为准。
  • 如果配置里包含真实 API Key，不要公开。

6. 在 Codex 扩展里选择 API 模式

安装 Codex 扩展后，打开 VS Code 里的 Codex 面板。
首次使用时，Codex 会让你选择登录方式。这里选择 API 或 API Key 模式，然后粘贴刚才在中转站创建的 API Key。
这里只粘贴 Key 本身，不要加 Bearer ，也不要粘贴整段 config.toml。
如果已经登录过 Codex，但想换成中转站 Key，可以在 Codex 面板右上角打开设置菜单，退出当前登录后重新选择 API Key 登录。

7. 打开 VS Code Codex 设置

进入 Codex 面板后，点击右上角的设置图标。
VS Code Codex 面板右上角设置入口
VS Code Codex 面板右上角设置入口
在弹出的菜单中选择 Codex 设置。
选择 Codex 设置
选择 Codex 设置
进入设置页后，切换到 Configuration 或 配置 页面，找到 config.toml，点击 Open config.toml。
VS Code Codex 打开 config.toml
VS Code Codex 打开 config.toml

8. 粘贴中转站配置

打开 config.toml 后，把第 5 步从中转站复制的配置粘贴进去。
建议粘贴在文件开头，方便以后检查。
配置内容大致会包含中转站 Provider、模型和基础地址。请以网站复制出来的内容为准，核心要点是基础地址应该是：
不要写成：
如果你已经有旧配置，注意不要保留两份重复的 provider。最稳妥的做法是：用中转站弹窗复制出来的新配置替换旧的同名配置。
保存 config.toml 后，重启 VS Code，或者执行 Developer: Reload Window 重新加载窗口。

9. 测试是否可用

重新打开 VS Code 后，进入一个代码项目，打开 Codex 面板，输入一个简单任务，例如：
如果 Codex 能正常回复，说明 API Key 和中转站配置已经生效。
如果一直报错，按下面顺序检查：
  1. 是否选择了 API Key 登录。
  1. API Key 是否来自 https://zhuangliping.site 后台。
  1. API Key 创建时是否选择了 订阅a 分组。
  1. config.toml 里基础地址是否是 https://zhuangliping.site，并且没有加 /v1。
  1. 修改 config.toml 后是否重启了 VS Code。

10. 常见问题

10.1 找不到 Codex 扩展

在 VS Code 扩展市场里搜索 codex，认准：
也可以直接打开 Marketplace 页面：

10.2 粘贴 API Key 后还是不能用

API Key 只负责登录，config.toml 负责告诉 Codex 使用哪个 API 地址。两步都要做。
只粘贴 API Key，但没有写入中转站配置，可能仍然不会走中转站。

10.3 配置文件应该粘贴到哪里

在 VS Code Codex 设置里点击 Open config.toml 打开的文件，就是当前 Codex 扩展实际读取的配置文件。
不要自己随便新建一个 config.toml，否则可能改错位置。

10.4 地址要不要加 /v1

不要加。
本教程中基础地址统一写：

10.5 可以把 API Key 发给别人吗

不可以。
API Key 等同于你的使用凭证。别人拿到以后就可以消耗你的额度。公开截图前也要确认没有露出完整 Key。

参考链接