在 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