VS Code Codex 插件 + DeepSeek V4 Pro + codex-bridge 本地桥接实现Codex的完美应用，完整配置教程 VS Code Codex 插件 DeepSeek V4 Pro 完整配置教程推荐方案VS Code Codex 插件 DeepSeek V4 Pro codex-bridge 本地桥接最轻量概述本教程将 OpenAI Codex 的 VS Code 插件接入 DeepSeek V4 Pro 模型通过本地codex-bridge桥接实现✅ 在 VS Code 中直接使用 Codex Agent 写代码✅ 使用 DeepSeek V4 Pro 模型而非 OpenAI 官方模型✅ 本地运行数据不出机器✅ 无需科学上网国内网络友好架构说明VS Code └─ Codex 插件 ──→ 本地 bridge ──→ DeepSeek API ↑ (API 格式转换 / 路由)codex-bridge是一个本地代理服务负责接收 Codex 插件的 OpenAI 格式 API 请求转换为 DeepSeek 兼容的 API 请求转发到 DeepSeek V4 Pro 并返回结果前置条件项目说明VS Code已安装最新版1.96Node.jsv18运行 bridge 用DeepSeek API Key已开通 DeepSeek V4 Pro 权限操作系统Windows / macOS / Linux 均可第一步安装 VS Code Codex 插件打开VS Code进入扩展市场CtrlShiftX搜索“Codex”OpenAI 官方出品点击Install也可以直接从 VS Code 官网扩展市场下载https://marketplace.visualstudio.com/items?itemNameOpenAI.codex安装完成后左侧会出现 Codex 图标。第二步获取 DeepSeek API Key访问DeepSeek 开放平台https://platform.deepseek.com/登录账号未注册则先注册进入API Keys 页面创建新的 API Key如sk-xxx...xxxx确认账户已开通V4 Pro模型权限 DeepSeek V4 Pro 当前定价远低于 OpenAI GPT-4o且在中文场景和编程任务上表现优秀。第三步配置 codex-bridge 本地桥接方法 A使用 Node.js 本地代理推荐创建本地 API 桥接服务# 1. 创建工作目录mkdir-p~/codex-bridgecd~/codex-bridge# 2. 初始化项目npminit-y# 3. 安装依赖npminstallexpress cors body-parser# 4. 创建桥接脚本touchbridge.js编辑bridge.jsconstexpressrequire(express);constcorsrequire(cors);constcryptorequire(crypto);constappexpress();app.use(cors());app.use(express.json());// ⚡ 随机生成本地代理 Keybridge 启动时打印到终端constPROXY_API_KEY***crypto.randomBytes(24).toString(hex);constDEEPSEEK_API_KEYsk-你的DeepSeek密钥;// ← 替换为你的 KeyconstDEEPSEEK_BASE_URLhttps://api.deepseek.com/v1;app.post(/v1/chat/completions,async(req,res){try{constresponseawaitfetch(${DEEPSEEK_BASE_URL}/chat/completions,{method:POST,headers:{Content-Type:application/json,Authorization:Bearer${DEEPSEEK_API_KEY}},body:JSON.stringify({model:deepseek-chat,// DeepSeek V4 Promessages:req.body.messages,max_tokens:req.body.max_tokens||8192,temperature:req.body.temperature||0.7,stream:req.body.stream||false})});if(req.body.stream){// 流式响应res.setHeader(Content-Type,text/event-stream);res.setHeader(Cache-Control,no-cache);res.setHeader(Connection,keep-alive);response.body.pipeTo(newWritableStream({write(chunk){res.write(chunk);}}));}else{constdataawaitresponse.json();res.json(data);}}catch(error){console.error(Bridge error:,error);res.status(500).json({error:error.message});}});app.post(/v1/models,async(req,res){// Codex 需要模型列表告知支持 DeepSeekres.json({data:[{id:deepseek-chat,object:model,created:Date.now(),owned_by:deepseek}]});});constPORT31415;app.listen(PORT,(){console.log(✅ codex-bridge running on http://localhost:${PORT});console.log( Proxy API Key:${PROXY_API_KEY});console.log(Copy this key to VS Code Codex settings → codex.apiKey);});方法 B使用三方桥接工具如果不想自己写代理也可以使用已有桥接工具# 安装 cc-switchCodex Custom Switchnpminstall-gcc-switch# 或使用 one-api 等网关工具dockerrun-d--nameone-api\-p3000:3000\-v~/one-api/data:/data\songquanpeng/one-api配置 DeepSeek 渠道即可。为什么推荐 codex-bridge 而非 cc-switch对比维度codex-bridge cc-switch代码量一个 JS 文件约 50 行完整 npm 包 依赖链依赖express cors3 个包全局安装依赖较多学习成本开箱即读5 分钟理解全部逻辑需了解 CLI 参数 / 配置格式灵活性可自由修改路由、加日志、加断点固定配置模式可定制性弱调试加console.log或 Node 断点即可黑盒运行出问题难定位适用场景✅ 固定使用 DeepSeek V4 Pro多模型间频繁切换启动方式node bridge.jscc-switch start 配置核心结论如果目标是在 VS Code 中用 DeepSeek V4 Pro 写代码且不需要频繁切换模型codex-bridge 更轻量、更可控、更好理解。cc-switch 的优势在于多模型管理和开箱即用适合需要在一台机器上切换 DeepSeek / Claude / GPT 的复杂场景。本教程面向单一模型方案所以推荐 codex-bridge。第四步启动 codex-bridgecd~/codex-bridgenodebridge.js看到类似以下输出即表示启动成功上图展示的是 codex-bridge 实际运行效果代理服务监听在 localhost:7899自动将 Codex 发起的gpt-5.5请求路由到 DeepSeek V4 Pro并对消息历史做智能裁剪以节省 Token。将输出的Proxy API Key复制到 VS Code Codex 配置的codex.apiKey中。建议将 bridge 设为开机自启使用 pm2 或 systemd或放在后台运行# 后台运行nohupnodebridge.jsbridge.log21# 或使用 pm2npminstall-gpm2 pm2 start bridge.js--namecodex-bridge pm2 save第五步配置 VS Code Codex 插件打开命令面板CtrlShiftP搜索设置“Codex: Open Settings”或“Codex: Configure”配置项如下{// 将 API 地址指向本地 bridgecodex.apiBaseUrl:http://localhost:31415/v1,// API Key填入 bridge 启动时打印的 Key见终端输出codex.apiKey:sk-pro...xxxx,// 指定模型codex.model:deepseek-chat,// 关闭 OpenAI 官方验证使用自定义 endpoint 时codex.skipAuthValidation:true}也可以直接在 VS Code 的settings.json中添加codex.apiBaseUrl:http://localhost:31415/v1,codex.apiKey:sk-pro...xxxx,codex.model:deepseek-chat,codex.skipAuthValidation:true第六步测试运行打开项目在 VS Code 中打开一个项目文件夹启动AgentCtrlShiftP→ 选择“Codex: Start Agent”输入指令你是什么模型上图是配置成功后的实际效果。可以看到 Codex Agent 正常启动并响应虽然它自称是 GPT-5Codex 默认标签实际全部请求已通过 codex-bridge 路由到DeepSeek V4 Pro。Agent 可以正常读写文件、执行命令、分析代码等。使用其他测试指令验证功能帮我写一个 Python 函数从 CSV 文件读取数据并计算每列的平均值Codex Agent 会✅ 创建任务计划✅ 生成代码文件✅ 显示实时进度✅ 最终输出结果如果看到代码正确生成说明配置成功 使用技巧常用 Codex 命令命令功能Codex: Start Agent启动 Agent 会话Codex: Quick Chat快速问答不操作文件Codex: Code Review审查当前文件代码Codex: Fix Bug自动修复 BugCodex: Explain Code解释选中代码最佳实践每个任务单独会话完成一个功能后关闭再开新会话用自然语言描述需求越具体Codex 产出越精准结合 Git 使用Codex 修改代码前会自动创建 Git commit善用 引用文件在对话中用文件名让 Codex 关注特定文件复杂任务分步描述先描述整体架构再逐步细化性能调优// 根据需求调整 VS Code 中 Codex 配置codex.maxTokens:8192,// 最大 Token 数codex.temperature:0.7,// 创造力 (0-1)codex.timeout:120,// 超时时间秒常见问题Q: 启动 Codex Agent 后提示 “API Key 验证失败”原因Codex 对自定义 endpoint 可能校验 Key 格式。解决确认codex.apiKey与 bridge 启动时打印的 Key 一致。在 VS Code settings.json 中增加codex.skipAuthValidation:true,codex.apiKey:sk-pro...xxxxKey 忘了的话重新生成node-econsole.log(*** require(crypto).randomBytes(24).toString(hex))如果显示这种错误的话需要使用命令,vscode中 使用代理的key是通过这个命令随机生成的node-econsole.log(sk-proxy-local- require(crypto).randomBytes(24).toString(hex))修改.env里面的PROXY_AUTH_KEY这个值Q: DeepSeek 返回速度慢或不稳定原因DeepSeek API 响应时间受网络和负载影响。解决检查网络连接是否稳定减少max_tokens到 4096降低temperature到 0.3更确定的输出Q: Bridge 启动后端口被占用原因31415 端口已被其他程序使用。解决修改bridge.js中的端口号同时更新 VS Code 配置中的codex.apiBaseUrl。Q: 想切换回 OpenAI 官方模型解决在 VS Code settings 中注释掉自定义配置或直接设为 OpenAI 官方地址// 注释掉以下行即可恢复官方默认// codex.apiBaseUrl: http://localhost:31415/v1,// codex.skipAuthValidation: true总结VS Code Codex 插件 ↓ 使用熟悉的 IDE 界面 codex-bridge 本地桥接 ↓ API 路由与格式转换 DeepSeek V4 Pro 模型 ↓ 高性能中文编程 你的代码 ✅这套方案的优势轻量一个 Node.js 脚本搞定无需 Docker省钱DeepSeek V4 Pro 价格远低于 OpenAI可控数据走本地 bridge不经过第三方代理灵活可随时切换模型或增加新的模型渠道版本信息教程编写于 2026-06-14适用环境VS Code 1.96 / Codex 插件 / DeepSeek V4 Pro如有问题请在后台留言咨询