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

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

但一个现实问题是：

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

于是，越来越多人选择：

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

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

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

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

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

其实真实链路是：

text 复制代码

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

bash 复制代码

npm install -g @openai/codex

2️⃣ 配置 Codex（最关键一步）

创建文件：

bash 复制代码

~/.codex/config.toml

写入：

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

bash 复制代码

export OPENAI_API_KEY=sk-xxx

4️⃣ 启动 VSCode（重要）

bash 复制代码

code .

👉 一定要从这个终端启动

否则 VSCode 读不到环境变量

5️⃣ 安装 Codex 插件

在 VSCode 搜索：

👉 Codex (OpenAI)

安装即可

✅ 到这里就完成了

现在你的链路是：

text 复制代码

VSCode → Codex → sub2api → GPT-5.4

🔥 四、效果是什么？

接入成功后，你可以：

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

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

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

👉 Continue 插件（开源方案）

安装插件：Continue

配置：

json 复制代码

{
  "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：为什么请求失败？

👉 检查：

bash 复制代码

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

能不能通

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

👉 因为：

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

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

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

👉 一个完整的 AI 平台：

text 复制代码

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

可以扩展：

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

👉 这已经不是"接入教程"了

👉 而是：

AI 开发基础设施

🧾 九、总结（一句话）

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