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

在 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

npminstall-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

exportOPENAI_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（不能自动改项目）

🧠 六、两种方案怎么选？

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

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

❓1：为什么 VSCode 连不上？

👉 90% 是：

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

❓2：为什么请求失败？

👉 检查：

curlhttps://你的域名/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