VSCode基于sub2api接入Codex的完整實(shí)戰(zhàn)指南
在 2026 年,很多開(kāi)發(fā)者其實(shí)已經(jīng)在用 VSCode + Codex(GPT-5.x) 做日常開(kāi)發(fā)。
但一個(gè)現(xiàn)實(shí)問(wèn)題是:
官方 API 不穩(wěn)定 / 網(wǎng)絡(luò)復(fù)雜 / 成本不可控
于是,越來(lái)越多人選擇:
用 sub2api(OpenAI兼容網(wǎng)關(guān)) 來(lái)接入 Codex
這篇文章就講清楚一件事:
? 如何讓 VSCode 直接走你的 sub2api 使用 Codex
一、先搞清楚原理(非常關(guān)鍵)
VSCode 并不是直接就調(diào)用 Codex 的。
其實(shí)真實(shí)鏈路是:
VSCode ↓ Codex CLI(本地) ↓ OpenAI兼容 API(你的 sub2api) ↓ Codex / GPT-5.4
所以本質(zhì)哇就一句話:
讓 Codex CLI 的 base_url 指向你的 sub2api
二、準(zhǔn)備工作
你需要:
- ? 一個(gè) sub2api 地址(如:https://xxx.com/v1)
- ? 一個(gè) API Key
- ? Node.js 環(huán)境
三、核心步驟(最推薦方案 ?)
1、安裝 Codex CLI
npm install -g @openai/codex
2、配置 Codex(最關(guān)鍵一步)
創(chuàng)建文件:
~/.codex/config.toml
寫(xiě)入:
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
否則會(huì)出現(xiàn)各種奇怪報(bào)錯(cuò)
3、設(shè)置 API Key
export OPENAI_API_KEY=sk-xxx
4、啟動(dòng) VSCode(重要)
code .
一定要從這個(gè)終端啟動(dòng)
否則 VSCode 讀不到環(huán)境變量
5、安裝 Codex 插件
在 VSCode 搜索:
Codex (OpenAI)
安裝即可
到這里就完成了
現(xiàn)在你的鏈路是:
VSCode → Codex → sub2api → GPT-5.4
四、效果是什么?
接入成功后,你可以:
- ? 直接在 VSCode 對(duì)話寫(xiě)代碼
- ? 自動(dòng)修改項(xiàng)目文件
- ? 理解整個(gè)工程結(jié)構(gòu)
- ? 執(zhí)行 Agent 操作(接近 AI 工程師)
五、備選方案(更自由但功能弱一點(diǎn))
如果你不想用 Codex CLI,可以用:
Continue 插件(開(kāi)源方案)
安裝插件:Continue
配置:
{
"models": [
{
"title": "Codex",
"provider": "openai",
"model": "gpt-5.4",
"apiBase": "https://你的域名/v1", // http://chongplus.plus/
"apiKey": "sk-xxx"
}
]
}優(yōu)點(diǎn)
- 完全支持 sub2api
- 不依賴 CLI
- 配置簡(jiǎn)單
缺點(diǎn)
- 不支持真正 Agent(不能自動(dòng)改項(xiàng)目)
六、兩種方案怎么選?
| 方案 | 推薦程度 | 說(shuō)明 |
|---|---|---|
| Codex CLI + VSCode | ????? | 最強(qiáng)(推薦) |
| Continue | ???? | 簡(jiǎn)單靈活 |
如果還是不會(huì),ccswitch 也是個(gè)辦法,圖形化界面: https://kazjsfecs3y.feishu.cn/wiki/JNXAwxqeOiI3Hxky3BXcYdkrnYb
七、常見(jiàn)問(wèn)題(你一定會(huì)遇到)
1:為什么 VSCode 連不上?
90% 是:
- 沒(méi)帶
/v1 - 沒(méi)用終端啟動(dòng) VSCode
- API Key 沒(méi)生效
2:為什么請(qǐng)求失敗?
檢查:
curl https://你的域名/v1/models
能不能通
3:為什么不建議 cc-switch?
因?yàn)椋?/p>
- 多一層中轉(zhuǎn) = 不穩(wěn)定
- CLI 已經(jīng)原生支持 base_url
- 服務(wù)器環(huán)境不好用
八、進(jìn)階玩法(適合你這種用戶)
如果你已經(jīng)在用 sub2api,其實(shí)可以做:
一個(gè)完整的 AI 平臺(tái):
VSCode / Cursor / CLI
↓
你的 sub2api
↓
多模型(Codex / Claude / Gemini)
可以擴(kuò)展:
- 多 key 輪詢
- 限流
- 用戶計(jì)費(fèi)
- fallback
- SaaS 面板
這已經(jīng)不是“接入教程”了
而是:
AI 開(kāi)發(fā)基礎(chǔ)設(shè)施
九、總結(jié)(一句話)
VSCode 接入 Codex,本質(zhì)就是讓 Codex CLI 指向你的 sub2api
以上就是VSCode基于sub2api接入Codex的完整實(shí)戰(zhàn)指南的詳細(xì)內(nèi)容,更多關(guān)于VSCode接入Codex指南的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章

2026年Codex的最實(shí)用教程(程序員實(shí)操版)
別再查Codex教程了,這篇實(shí)操指南直接教你用Codex自動(dòng)寫(xiě)代碼、執(zhí)行項(xiàng)目,從3分鐘搭建Go Web服務(wù)到完整API中轉(zhuǎn)系統(tǒng),結(jié)合真實(shí)開(kāi)發(fā)流程,高手都在用任務(wù)驅(qū)動(dòng)提效,現(xiàn)在是掌握AI自2026-07-22
macOS ARM Codex 安裝的實(shí)現(xiàn)步驟
本文教你用清華鏡像一鍵配置macOS ARM環(huán)境,并解決DeepSeek適配難題,輕松搞定brew update阻塞和/responses 404報(bào)錯(cuò),快速啟用Codex圖形與終端工具,感興趣的可以了解一下2026-07-22
VSCode配置Codex接DeepSeek的API服務(wù)的圖文教程
這篇文章主要介紹了VSCode配置Codex接DeepSeek的API服務(wù)的圖文教程,文中通過(guò)圖文示例介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著2026-07-22
VSCode中使用Codex命令、Agent與Skills的完整指南
本文主要基于 VSCode 使用場(chǎng)景 來(lái)整理 Codex 的使用方式,也就是說(shuō),我們不是以純命令行為主,而是以 VSCode 插件 + 項(xiàng)目配置 + Agent + Skills 的方式來(lái)使用 Codex,感興趣2026-07-21
想徹底掌控你的Codex桌面應(yīng)用,這篇完整指南帶你深入了解所有設(shè)置功能,掌握通用、Agent配置、權(quán)限管理、MCP集成等核心技巧,提升你的開(kāi)發(fā)效率,需要的朋友可以參考下2026-07-20
Codex三種任務(wù)調(diào)度模式實(shí)戰(zhàn)指南:串行、并行、SDD
Codex 本質(zhì)上是一個(gè) agent,它的上下文窗口有限,串行處理是默認(rèn)行為,當(dāng)你需要它處理多個(gè)任務(wù)或完成一個(gè)復(fù)雜功能時(shí),主動(dòng)選擇調(diào)度模式是效率的關(guān)鍵,本文覆蓋三種模式,每種2026-07-17
Codex config.toml配置實(shí)戰(zhàn)指南
你正在用的Codex可能沒(méi)發(fā)揮全部實(shí)力,這篇配置指南將逐項(xiàng)拆解config.toml的每個(gè)功能開(kāi)關(guān)、MCP服務(wù)器和全局參數(shù),告訴你如何驗(yàn)證效果、觸發(fā)場(chǎng)景,讀完就能快速定位子Agent不可2026-07-17
Codex Desktop 安裝教程:Windows、macOS 全平臺(tái)完整攻略
Codex Desktop 是 OpenAI 推出的 AI 編程桌面客戶端,支持并行處理多個(gè)任務(wù)線程,截至 2026 年 7 月,它主要支持 Windows 和 macOS,接下來(lái)通過(guò)本文給大家介紹Codex Desktop2026-07-17
從零搭建Codex工作臺(tái),告別混亂配置!本文手把手教你安裝CLI與桌面App,詳解AGENTS.md項(xiàng)目規(guī)則、config.toml與Skills配置,并直擊MCP與插件連接外部工具的核心方法,讀完即可將2026-07-16
使用Codex從零制作高質(zhì)量PPT的完整操作教學(xué)
這篇文章將給出一套可直接復(fù)用的Codex制作高質(zhì)量 PPT的完整流程,包括如何準(zhǔn)備資料,如何讓 Codex 先搭故事線,再建立視覺(jué)系統(tǒng)、生成 .pptx、制作配圖,最后把每一頁(yè)渲染成2026-07-16










