VSCode基于sub2api接入Codex的完整实战指南

本教程将一步步指导你如何在 VSCode 中通过

网关接入 模型，解决官方 API 不稳定、网络复杂及成本不可控等实际问题，实现高效、稳定的 AI 编程体验。

一、先搞清楚底层原理（非常关键）

VSCode 并非直接调用 Codex。其真实链路如下：

VSCode
 ↓
Codex CLI（本地）
 ↓
OpenAI兼容 API（你的 sub2api）
 ↓
Codex / GPT-5.4

所以，核心本质就是：

。

二、准备工作

开始前，请确保已准备以下内容：

• ✅ 一个

  sub2api
  地址（如：https://xxx.com/v1）
• ✅ 一个

  API Key
• ✅

  Node.js
  环境（确保已安装并可用）

小提示：如果 Node.js 尚未安装，请前往 nodejs.org 下载最新版本并完成安装。

三、核心步骤（推荐方案 ⭐）

1、安装 Codex CLI

打开终端，执行以下命令进行全局安装：

npm install -g @openai/codex

小提示：安装过程可能需要一些时间，请耐心等待。若遇网络问题，可尝试切换 npm 镜像源。

2、配置 Codex（最关键一步）

创建配置文件：

~/.codex/config.toml

在文件中写入以下内容：

model = "gpt-5.4"
model_provider = "sub2api"
model_reasoning_effort = "high"
[model_providers.sub2api]
name = "sub2api"
base_url = "https://你的域名/v1"
wire_api = "responses"
requires_openai_auth = true

注意（很多人踩坑）：base_url 必须带 /v1，否则会出现各种奇怪报错。

3、设置 API Key

在终端中导出环境变量：

export OPENAI_API_KEY=sk-xxx

小提示：记得将 sk-xxx 替换为你的实际 API Key。

4、启动 VSCode（重要）

在同一个终端中，通过命令启动 VSCode：

code .

注意：一定要从该终端启动 VSCode，否则 VSCode 无法读取环境变量。

5、安装 Codex 插件

在 VSCode 扩展市场搜索：

Codex (OpenAI)

找到后点击安装即可。

至此，配置完成。你的链路变为：

VSCode → Codex → sub2api → GPT-5.4

四、接入后的效果

成功接入后，你将获得以下能力：

• ✅ 直接在 VSCode 中通过对话编写代码
• ✅ 自动修改项目文件
• ✅ 理解整个工程结构
• ✅ 执行 Agent 操作（接近 AI 工程师）

五、备选方案：Continue 插件（更自由但功能弱一点）

如果你不想使用 Codex CLI，可以尝试

插件（开源方案）。

操作步骤

1. 安装插件：在 VSCode 扩展市场搜索 Continue 并安装。

2. 配置插件：在设置中添加以下内容：

{
  "models": [
    {
      "title": "Codex",
      "provider": "openai",
      "model": "gpt-5.4",
      "apiBase": "https://你的域名/v1", // http://chongplus.plus/
      "apiKey": "sk-xxx"
    }
  ]
}

优点

• 完全支持 sub2api
• 不依赖 CLI
• 配置简单

缺点

• 不支持真正 Agent（不能自动改项目）

六、方案对比与选择

方案	推荐程度	说明
Codex CLI + VSCode	⭐⭐⭐⭐⭐	最强（推荐）
Continue	⭐⭐⭐⭐	简单灵活

如果还是不会，ccswitch 也是个办法，图形化界面： https://kazjsfecs3y.feishu.cn/wiki/JNXAwxqeOiI3Hxky3BXcYdkrnYb

七、常见问题（你一定会遇到）

1：为什么 VSCode 连不上？

90% 的可能是以下原因：

• 配置文件中 base_url 没有带 /v1
• 没有通过终端启动 VSCode
• API Key 未生效或配置错误

2：为什么请求失败？

请检查网络连接，并尝试在终端中运行以下命令，确认 sub2api 地址是否可用：

curl https://你的域名/v1/models

如果返回模型列表，则地址正常；否则，请检查地址或网络。

3：为什么不建议 cc-switch？

原因如下：

• 多一层中转更不稳定
• Codex CLI 已原生支持 base_url 配置
• 在服务器环境中不易使用

八、进阶玩法（适合你这种用户）

如果你已经在使用 sub2api，可以进一步构建一个完整的 AI 开发平台：

VSCode / Cursor / CLI
        ↓
你的 sub2api
        ↓
多模型（Codex / Claude / Gemini）

可以扩展的功能包括：

• 多 key 轮询
• 限流
• 用户计费
• fallback
• SaaS 面板

这已经不是简单的“接入教程”，而是构建

。

九、总结（一句话）

VSCode 接入 Codex，本质就是让 Codex CLI 指向你的 sub2api

。通过本教程的步骤，你已经成功将 VSCode 与 sub2api 结合，解锁了 Codex 的强大能力。现在，你可以享受稳定、低成本的 AI 编程体验，并在此基础上进一步扩展你的 AI 开发基础设施。