第七篇：《Codex IDE 插件实战：在 VS Code 中无缝集成》

在前两篇文章中我们分别掌握了 Codex CLI 和桌面应用的用法。但很多开发者最习惯的工作环境仍然是 IDE——代码补全、调试、版本控制、终端全都在一个窗口里完成。Codex 的 VS Code 插件正是为这类开发者设计的它把 Codex 的能力直接嵌入到编辑器的侧边栏让你在不离开 IDE 的情况下完成“编码-委托-审查”的完整闭环。相比桌面 App在 VS Code 中使用 Codex 可以更直接地看到文件目录结构和修改前后的对比适合习惯在编辑器里工作的开发者。本文从插件安装讲起深入讲解 AGENTS.md 的配置艺术并通过重构和写测试两个实战场景帮你掌握 IDE 插件的高效用法。一、安装与登录1.1 安装插件打开 VS Code点击左侧边栏的「扩展」图标在搜索框中输入 Codex选择 OpenAI 官方发布的插件点击「安装」即可。命令行安装更快 code --install-extension openai.chatgpt1.2 登录安装完成后在 VS Code 中打开任意项目文件右上角会出现 ChatGPT 的图标。点击该图标右侧边栏展开 Codex 对话窗口。首次使用需要登录Sign in with ChatGPT适合已有 ChatGPT 订阅的用户。API Key适合需要在 CI/CD 中程序化调用的场景。1.3 界面速览对话窗口打开后直接输入需求Codex 就会开始辅助完成开发任务用法与桌面 App 基本一致。核心交互方式包括 指定文件在对话框中输入 后选择具体文件Codex 会直接定位到该文件进行分析或修改比让它全局搜索更快、更准确。选区加入线程选中代码后从命令面板选择“Add to Codex Thread”将选中的精确行数喂给 Codex。编辑器内 diffCodex 的修改可以直接在编辑器的 diff 视图中查看逐行审查。二、AGENTS.md给 Codex 写一份“项目说明书”2.1 AGENTS.md 是什么AGENTS.md 是写给编码 Agent 的项目说明书作用类似面向 AI 的 README。它使用普通 Markdown没有强制字段可记录安装、构建、测试、代码风格、目录边界和 Pull Request 要求。截至 2026 年已有超过 60,000 个非 Fork、非归档的开源项目使用该文件该格式由 OpenAI Codex、Google Jules、Cursor 等工具生态共同采用并由 Linux Foundation 旗下 Agentic AI Foundation 管理。2.2 读取顺序与优先级Codex 按“全局规则 → 项目根目录 → 当前工作目录”的顺序合并指令越靠近目标代码的文件优先级越高。读取规则可以概括为三层全局层默认检查 ~/.codex/AGENTS.override.md不存在时再读取 ~/.codex/AGENTS.md只采用第一个非空文件。项目层从 Git 项目根目录向当前工作目录逐级查找每一级依次检查 AGENTS.override.md、AGENTS.md 和配置的备用文件名。合并层从根目录到子目录依次拼接后出现的具体规则覆盖前面的通用规则。text~/.codex/AGENTS.md # 所有项目的个人默认规则repo/AGENTS.md # 仓库级规则repo/apps/web/AGENTS.md # Web 应用规则repo/apps/web/tests/AGENTS.override.md # 测试目录临时覆盖2.3 一份可执行的 AGENTS.md 模板高质量 AGENTS.md 应告诉 Codex“改哪里、怎么验证、哪些事情不能做”而不是重复通用编程常识。每条规则最好对应一个可观察的行为或可执行命令。以下是一份适合 TypeScript 项目的完整模板markdownAGENTS.mdProject scopeApplication code lives insrc/; tests live intests/.Do not edit generated files underdist/orcoverage/.Keep changes limited to the requested feature or bug.SetupInstall dependencies withpnpm install --frozen-lockfile.Copy.env.exampleto.env.local; never commit secrets.Development commandsRun the app:pnpm dev.Run type checks:pnpm typecheck.Run lint:pnpm lint.Run tests:pnpm test.Code conventionsUse TypeScript strict mode.Reuse existing components and utilities before adding abstractions.Keep public API changes backward compatible unless the task says otherwise.Testing requirementsAdd or update focused tests for changed behavior.Run the narrowest relevant test first, then the full test suite.Do not delete failing tests to make CI pass.Security boundariesNever print or commit credentials, tokens, or customer data.Ask before adding a production dependency or changing database schemas.Do not run destructive database or Git commands.三、实战一在 IDE 中重构代码3.1 重构的“命根子”对外行为不能变我曾吃过这个亏早期图省事让 Codex 重构一个没测试的金额格式化函数它顺手“优化”掉了一个处理负数的分支本地跑着没事测试环境对账才发现负数全显示错了。从那以后我立下规矩——没测试先补测试再重构一次都不破例。3.2 IDE 中的重构流程在 IDE 中你可以选中需要重构的函数通过“Add to Codex Thread”加入上下文然后给出明确指令text重构这个函数将重试逻辑抽取为可复用的工具函数。约束对外行为不变API 签名不变。先出分步计划我确认后再动手。四、实战二在 IDE 中写测试4.1 为什么“写测试”最容易踩坑Codex 写测试很顺手——它会翻你现有的测试文件照着已在用的框架和断言风格写。但有个坑你必须知道你不特别交代它默认偏向只测“正常情况” 。什么叫只测正常情况比如一个反转列表的函数它给你测“[1,2,3] 反转成 [3,2,1]”——对是对但空列表呢只有一个元素呢传进来 null 呢这些边界情况才是真正会出 bug 的地方。4.2 IDE 中的写测试流程打开有目标函数的文件选中定义这个函数的那几行从命令面板选“Add to Codex Thread”把这几行加进上下文然后text给这个函数写单元测试。遵循其他测试里已有的约定。覆盖正常路径外加边界情况空输入、单元素、null、超大输入。模糊问法 vs 精确问法的效果差距结果只测正常路径覆盖率虚高 结果真正会炸的地方都测到五、IDE 插件 vs 桌面应用怎么选根据自己的使用习惯选择即可两者可以配合使用。六、小结安装VS Code 扩展市场搜索 Codex安装官方插件。 指定文件精确锁定目标文件比全局搜索更快。AGENTS.md项目说明书三层读取全局→项目→工作目录越近的规则优先级越高。重构流程先出计划 → 磨计划 → 补测试 → 小步改 → 改前改后都测。写测试必须明确要求覆盖边界情况否则 Codex 只测 happy path。IDE vs 桌面IDE 适合日常编码桌面适合多任务指挥。