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

在 2026 年，很多开发者其实已经在用 VSCode + Codex（GPT-5.x） 做日常开发。

但一个现实问题是：

官方 API 不稳定 / 网络复杂 / 成本不可控

于是，越来越多人选择：

用 sub2api（OpenAI兼容网关） 来接入 Codex

这篇文章就讲清楚一件事：

✅ 如何让 VSCode 直接走你的 sub2api 使用 Codex

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

VSCode 并不是直接就调用 Codex 的。

其实真实链路是：

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

所以本质哇就一句话：

让 Codex CLI 的 base_url 指向你的 sub2api

二、准备工作

你需要：

• ✅ 一个 sub2api 地址（如：https://xxx.com/v1）
• ✅ 一个 API Key
• ✅ Node.js 环境

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

1、安装 Codex CLI

npm install -g @openai/codex

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

4、启动 VSCode（重要）

code .

一定要从这个终端启动
否则 VSCode 读不到环境变量

5、安装 Codex 插件

在 VSCode 搜索：

Codex (OpenAI)

安装即可

到这里就完成了

现在你的链路是：

VSCode → Codex → sub2api → GPT-5.4

四、效果是什么？

接入成功后，你可以：

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

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

如果你不想用 Codex CLI，可以用：

Continue 插件（开源方案）

安装插件：Continue

配置：

{
  "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% 是：

• 没带 /v1
• 没用终端启动 VSCode
• API Key 没生效

2：为什么请求失败？

检查：

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

能不能通

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

因为：

• 多一层中转 = 不稳定
• CLI 已经原生支持 base_url
• 服务器环境不好用

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

如果你已经在用 sub2api，其实可以做：

一个完整的 AI 平台：

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

可以扩展：

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

这已经不是“接入教程”了
而是：

AI 开发基础设施

九、总结（一句话）

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