VSCode利用sub2api接入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
-
07.23
MAF 入门第六期:人工审核(HITL)
-
07.23
DeepSeek 和 CC Switch 开启思考模式完整配置教程
-
07.23
服务器数据恢复:RAID5上层分区丢失的XFS文件系统数据恢复案例
-
07.23
Higress v2.2.3 发布:正式入驻 CNCF Sandbox:AI Gateway 与 Ingress 迁移能力双向加固
-
07.23
AI英语在线考试平台的研发
-
07.23
一天学会AI工具不难:难的是这一步:90%的人都没做
推荐专题
热门阅读
-
- 杀戮尖塔2怎么卡无限锻造-杀戮尖塔2火堆bug
- 07.23
-
-
-
-
- Claude Code 卸载及配置文件清理教程
- 07.23
-
-
-
下载
- |
-
-
下载
- 《行尸走肉第一章》免安装中文汉化硬盘版下载
- 单机|436 MB
- 一款以动作冒险为主题的游戏
-
-
下载
- 《街头霸王X铁拳》免安装中文汉化硬盘版下载
- 单机|111MB
- 一款非常好玩的格斗游戏
-
-
下载
- |
-
-
下载
- 《暗黑破坏神3》免安装繁体中文正式版下载
- 单机|7630 MB
- 一款以角色扮演为主题的游戏
-
-
下载
- 《马克思佩恩3》免安装硬盘版下载
- 单机|27033 MB
- 一款以第三人称射击为主题的游戏