最近 Codex 这个开源编程智能体在开发者圈子里热度很高OpenAI 把它从命令行一路做到了 VSCode 插件装好之后AI 可以直接在你编辑器里读代码、改代码、跑测试、提 PR体验和以前那种网页聊天完全不一样。更关键的是Codex 支持自定义模型供应商你可以把 DeepSeek、GPT 都配进去普通改动用便宜的模型复杂重构再切回 GPT成本和使用体验能兼得。这篇文章就从零开始带你装好 Codex 插件把 DeepSeek 和 GPT 都配置好顺手把几个高频报错也一起讲透。适合刚接触 Codex、想在 VSCode 里用上 AI 编程助手的朋友也适合已经装上插件但被配置文件折腾过的人。1. Codex 是什么为什么值得进 VSCode1.1 从终端命令到编辑器插件Codex 是 OpenAI 开源的 AI 编程智能体核心能力是“把一个自然语言需求变成真实的代码改动”。它不是简单的代码补全工具而是一个能自己浏览仓库、搜索符号、编辑文件、执行命令、运行测试的智能体。最初它是以命令行工具的形式发布的后来官方在 VSCode 扩展市场发布了插件版把同样的能力塞进了 IDE。插件版最有价值的一点是“上下文”。它能实时看到你当前打开的文件、选中的代码、整个工作区的目录结构甚至 Git 变更状态都能感知。这意味着它给出的修改建议高度贴合你正在做的事而不是像网页聊天那样只能靠你手动把代码复制过去。简单说CLI 版适合处理“批量任务”插件版适合“边写边改”两者互补建议都装。1.2 命令行和插件怎么选使用场景命令行 CodexVSCode 插件一次改几十个文件的机械操作顺手也凑合边写边改的日常小改动一般最顺手选中一段代码让它解释不直观右键就能问跑测试、根据报错修问题可以可视化更好在脚本或 CI 里调用可以不行我的习惯是日常开发一直开着 VSCode 插件遇到“给整个目录改注释”“批量重命名”这类活儿再单独开一个终端跑codex命令。两条路都走一遍之后你对这个工具的边界会更有感觉。1.3 为什么要把 DeepSeek 和 GPT 都接进来先说结论不是“选一个用”而是“两个都配好按任务切换”。GPTOpenAI 官方模型和 Codex 原生配合最好支持 OpenAI 最新的 Responses API能力上限最高。复杂重构、老项目迁移、看不懂的加密逻辑这些重活让 GPT 来成功率明显更高。DeepSeek接口格式兼容 OpenAI价格便宜很多上下文窗口对于日常任务完全够用具体数值以官方文档为准。补注释、写单测、改样式、处理重复代码这类任务用 DeepSeek 非常省钱。双配置的本质是“丰俭由人”。我算过一笔账一天下来如果所有请求都走 GPTAPI 账单会涨得很快但 80% 的小改动本来就不需要那么强的模型切到 DeepSeek 后账单能降一个量级而且体验几乎没有差别。这也是我强烈建议配置双模型的原因。2. 安装前准备与 Codex 插件安装2.1 需要准备的东西动手之前先把环境列个清单VSCode版本建议越新越好老版本对插件的新特性支持不好Node.js18 以上装 Codex CLI 要用GitCodex 会读取仓库状态和变更记录建议提前配好API KeyOpenAI 的 key或者 DeepSeek 的 key两者都配就都申请这里多说一句API Key 一定要在官方平台后台创建并且创建之后马上复制保存好。很多平台只在创建时显示一次完整 key关掉页面就再也看不到了只能重新创建。2.2 安装 VSCode 插件打开 VSCode左侧扩展面板搜索关键字Codex认准发布者是 OpenAI 的那个扩展点击安装。装完强烈建议重载一次窗口按CtrlShiftPmacOS 是CmdShiftP输入Reload Window回车。这一步能避免很多“插件装了但面板打不开”的诡异问题。如果扩展市场搜不到或者你是内网环境可以去 OpenAI 的 Codex 开源仓库 Releases 页面下载.vsix文件然后在 VSCode 扩展面板右上角的“更多操作”里选择“从 VSIX 安装”手动指定文件即可。2.3 安装 Codex CLI强烈建议npm install -g openai/codex装完运行codex --version确认版本号能正常打印。为什么插件之外还要装 CLI两个原因。第一官方插件的部分版本会调用本地的 codex 引擎提前装好 CLI 能避免“插件装上了却用不了”的尴尬第二CLI 本身就是最直接的调试工具后面遇到配置问题可以用命令行先测一遍快速区分是“配置错了”还是“插件坏了”。装完 CLI 之后先解决身份认证两种方式codex login用 ChatGPT 账号登录适合已经订阅 ChatGPT Plus/Pro 的人设置环境变量把 API Key 写进系统环境变量适合走 API 计费的人如果你想用 DeepSeek 这类第三方模型建议直接用环境变量方式不走 ChatGPT 登录。因为账号登录模式基本绑定官方模型用第三方模型时需要的是 API Key 模式。3. 配置 DeepSeek 与 GPT 模型供应商3.1 认识 Codex 的配置文件Codex 的全局配置文件位于用户目录下的~/.codex/config.toml。这个文件是理解整个配置体系的钥匙。文件里可以定义多个模型供应商每个供应商对应一个“OpenAI 兼容的 API 地址”。Codex 干活的时候核心就靠三个字段和一个模型名base_urlAPI 服务地址env_key从哪个环境变量读取 API Keywire_api用哪种协议通信responses对应 OpenAI 新版 Responses APIchat对应传统的 Chat Completions APImodel默认使用的模型 ID这个设计很像路由器里配置多个 DNS 服务器平时默认走一个需要时随时手动切换。理解了这个结构配置任何新模型都只是“套模板”的事。3.2 配置 OpenAI GPT打开或新建~/.codex/config.toml写入model gpt-5-mini model_provider openai [model_providers.openai] name OpenAI base_url https://api.openai.com/v1 env_key OPENAI_API_KEY wire_api responses然后设置环境变量。macOS 或 Linux 下临时设置export OPENAI_API_KEYsk-你的key想永久生效就把这行写进~/.bashrc或~/.zshrc然后执行source ~/.bashrc让它立即生效。Windows 用户用 PowerShell 临时设置$env:OPENAI_API_KEYsk-你的key永久设置用setx OPENAI_API_KEY sk-你的key注意setx设置完当前终端不生效要新开一个终端。这里有个特别容易忽略的点改完环境变量后VSCode 必须完全退出再重新打开仅仅重载窗口是不够的因为环境变量是进程启动时读取的。关于模型 IDgpt-5-mini只是我常用的一个例子具体以 OpenAI 官方模型列表为准换成你有权限访问的 ID 即可。3.3 配置 DeepSeek还是在~/.codex/config.toml里加一段model_provider deepseek model deepseek-chat [model_providers.deepseek] name DeepSeek base_url https://api.deepseek.com/v1 env_key DEEPSEEK_API_KEY wire_api chat然后设置环境变量export DEEPSEEK_API_KEYsk-你的deepseekkeyDeepSeek 官方提供的是 OpenAI 兼容接口但兼容的是 Chat Completions 这一套并没有实现 OpenAI 最新的 Responses API。所以wire_api必须写成chat。如果照抄 OpenAI 的配置写成responses请求会直接报 404 或者协议错误这是接入 DeepSeek 时最常踩的坑。另外 DeepSeek 平台一般有两个模型可用deepseek-chat是通用对话模型速度快成本低deepseek-reasoner是推理增强模型适合复杂逻辑任务。想用哪个就把model字段换成哪个。3.4 怎么在模型之间切换配置好之后切换方式有两种。第一直接改config.toml里的默认model和model_provider然后重载 VSCode 窗口。适合“这段时间主要用哪个模型”这种长期切换。第二命令行用参数临时指定适合单次任务切换codex --model deepseek-chat --model-provider deepseek codex --model gpt-5-mini --model-provider openai我的习惯是config.toml里默认放deepseek-chat日常的绝大多数请求都走它遇到复杂的重构需求再临时切到 GPT。这样既有性价比又不会在关键时刻掉链子。4. 实操在 VSCode 里用 Codex 干活4.1 插件的基本操作配置全部完成并重载窗口后左侧边栏会出现 Codex 图标。点击打开面板底部是输入框顶部可以看到当前使用的模型。插件的核心交互方式有三种直接对话在输入框里描述需求Codex 会分析当前项目并给出修改方案。涉及代码改动时它会展示 diff你确认之后改动才会真正写入文件选中代码后右键菜单里有解释代码、修改选中代码、写测试等快捷入口不用手动描述上下文终端命令授权Codex 需要跑测试或执行命令时会弹出一个授权请求你确认后它才会运行这里有个安全习惯值得养成第一次用的前几周每次改代码之前都仔细看一下 diff确认它没动不该动的东西。等你对它的行为模式熟悉了再慢慢放宽信任。4.2 一个真实场景修复登录报错比如项目里有个登录功能密码错误时没有任何提示。选中相关文件在 Codex 面板里输入“这段登录代码在认证失败时没有任何用户提示帮我补上错误提示如果是因为密码错误要给出具体原因而不是笼统的失败。”Codex 会浏览相关文件定位认证逻辑然后在合适的位置加上错误分支。它给出的 diff 会很清楚地标出改了哪个文件、加了哪些判断。确认后再让它跑一下相关测试整个流程几分钟就结束了。如果你只用网页版 AI 聊天工具这个过程需要你手动复制代码、再把修改粘回去体验完全不在一个量级。4.3 另一个场景补单测给工具函数写单测是 Codex 的强项。选中工具函数文件输入“为 src/utils/format.ts 写单元测试覆盖空字符串、超长字符串、特殊字符、null 这些边界情况测试框架用项目现有的。”它会先读懂项目里的测试框架和既有风格再生成符合规范的测试文件而不是给你一段风格完全不一致的代码。确认 diff 后你只需要运行一次测试命令看结果全绿就行。4.4 跨文件重构时怎么提需求跨文件重构是最能体现“选对模型”价值的场景。这种任务建议把模型切到 GPT 或deepseek-reasoner。提需求时尽量把“现状”和“目标”说清楚。比如“payment 模块里所有地方还在直接用旧的费率计算函数请统一改成从配置中心的 new_rate 结构读取并更新调用方最后跑一遍现有测试确保没有破坏行为。”Codex 会列出所有涉及的文件逐个修改并给出改动清单。这种多文件任务如果一次说不清楚就拆成几步做先让它列出所有受影响位置确认无误后再让它动手。实践证明任务拆得越细成功率越高来回返工也越少。4.5 省钱和提速的几个小技巧用了几个月之后我总结了几条很实用的经验简单任务直接用deepseek-chat当默认模型只有任务明显复杂时才切 GPT一次让 Codex 只做一件事比让它“一口气把所有功能都实现”成功率高而且 token 消耗更少重要改动前先让它“只给方案不要改文件”你过一遍思路再让它执行对话太长时主动新开一个会话不要让 Codex 背着冗长的历史继续干活5. 常见问题与排查实战5.1 网络连接类报错不少人在插件里会看到类似cc switch local ... failed while handling codex endpoint /responses的报错后面的内容经常被截断。这类报错的本质是插件到 API 服务之间的网络连接没有打通。我的排查顺序一般是这样第一步确认浏览器能正常打开对应的 API 官方平台。能打开说明网络基本可用问题可能出在插件或本地环境上第二步检查系统环境变量里有没有指向本机某个端口的网络配置项。Codex 发起请求时会读取这些配置如果它指向的服务并没有运行连接就会一直失败。把多余的配置项清掉然后重启 VSCode第三步关闭 VSCode 里所有可能改动网络请求的扩展重载窗口再试。有时是扩展之间相互干扰把嫌疑对象隔离出来问题就清楚了第四步如果用了 WSL确认 VSCode 当前连接的是 WSL 环境还是 Windows 本机两边的环境变量和配置要分开检查如果 API 站点本身无法访问那说明是网络环境的问题需要先把网络环境处理好再回来看插件。这不是 Codex 能解决的配置再怎么调也没有用。5.2 上下文超限报错有朋友遇到过这么一条报错error running remote compact task: codex ran out of room in the models context。翻译过来就是当前会话太长了模型的上下文窗口已经装不下Codex 想自动压缩会话释放空间结果压缩也失败了。产生的原因通常是长时间用同一个会话聊天或者一次让 Codex 看了太多文件。解决办法按优先级排列在新会话里继续插件面板里找到 New Session 或清空对话的入口把大任务拆成小步骤每个步骤单独开一个会话切换上下文更大的模型DeepSeek 在这类场景下往往比小上下文模型更从容提问时尽量用选中代码的方式减少让 Codex 全局搜索整个仓库的次数5.3 401、403、429 鉴权和额度报错报错特征可能原因处理方式401 UnauthorizedAPI Key 没设置、写错、或者多了空格检查环境变量重新复制 key注意前后不要有空白字符403 ForbiddenKey 权限不足或账号被封禁该模型登录平台后台确认 key 是否有对应模型的访问权限429 Too Many Requests触发限流或账户余额不足查看账户额度降低请求频率必要时充值这里特别要提醒一个误区OpenAI 的 ChatGPT 订阅Plus/Pro和 API 是两套完全独立的计费体系。订阅了 Plus 不代表你就有 API 额度API Key 必须在平台后台单独创建并且按量付费。很多人以为自己充了 ChatGPT 会员就能白嫖 API结果一直 401 或 403其实就是没搞清这两者的区别。DeepSeek 这边新注册用户一般会有赠送额度但赠送额度用完以后就需要自己充值否则也会报额度不足的错误。5.4 插件打不开、一直转圈装了插件但侧边栏打不开或者面板一直转圈按这个顺序排查先重载窗口很多问题重启就能解决把 VSCode 升级到最新版本老版本对扩展的 API 支持不全检查 Node.js 版本太老的 Node 会导致扩展运行时崩溃Windows 用户如果各种奇怪问题反复出现可以考虑配合 WSL 使用在 WSL 里安装 Codex CLIVSCode 用 Remote Development 插件连接 WSL很多路径分隔符、权限、环境变量不一致的问题会少很多5.5 配了 DeepSeek 但还是报错如果 config.toml 里已经写了 DeepSeek但还是各种报错按这个顺序检查base_url是否写全应该是https://api.deepseek.com/v1注意结尾的/v1少写或多写都会导致 404wire_api是否写成了responsesDeepSeek 必须用chat这是最高频的坑环境变量名是否和env_key完全一致DEEPSEEK_API_KEY少一个字母都读不到改完配置文件有没有重载config.toml不会自动生效必须重载窗口或重启 VSCode还有一个“终极排查法”先绕开插件直接用 CLI 测一遍配置codex --model deepseek-chat --model-provider deepseek 用一句话介绍你自己CLI 能正常回复说明配置没问题问题在插件侧重载窗口或重装插件CLI 也报错那说明问题出在配置文件或环境变量上而且命令行给出的错误信息通常比插件完整得多照着信息改就行。5.6 换新机器怎么快速迁移配置我换新电脑之后的做法很简单把~/.codex/config.toml备份一份新机器装好 Node.js 和 Codex CLI 之后直接把文件拷过去再重新设置一遍环境变量就完事了。注意 API Key 不要写进config.toml本身也不要提交到 git 仓库Key 一律走环境变量这样即使配置文件泄露也不会直接丢密钥。最后分享一点我的实际体会。第一次接触 Codex 时我光看官方文档没太看懂model_provider和wire_api到底起什么作用后来配 DeepSeek 一直报 404折腾了大半个晚上才发现是协议类型写错了。这个配置本质上就一句话OpenAI 官方模型走responses兼容 OpenAI 接口但没有实现 Responses API 的第三方模型走chat。想清楚这一点后面再接任何新模型都不慌。另外刚开始用的时候建议先拿一个小型开源项目练手让 Codex 帮你改点小功能、补几个测试熟悉它的操作方式和授权逻辑之后再让它碰生产代码。工具好用也要用对地方边界摸清楚后面才会越用越顺。