Codex 详细介绍与必装插件指南

图 1：Codex App 官方界面图，来源：OpenAI Developers。

一、Codex 是什么？

Codex 是 OpenAI 面向软件开发的智能编码代理（coding agent）。传统代码补全工具通常只负责“根据光标附近的内容续写几行代码”，而 Codex 可以围绕一个目标完成更长的工程链路：读取项目、理解约定、制定计划、修改多个文件、运行命令、执行测试、查看网页、分析失败原因，再继续修复。

简单来说：代码补全工具帮你写下一段代码，Codex 则更像一名能使用电脑和开发工具协作的工程师。

根据 OpenAI 官方文档，Codex 的核心用途包括：

• • 编写代码，并适应现有项目结构与编码规范；
• • 阅读、解释陌生或遗留代码库；
• • 审查代码，发现错误、边界条件和高风险问题；
• • 调试失败，定位根因并实施针对性修复；
• • 自动完成重构、测试、迁移、环境配置等重复工作。
• 

二、Codex 可以在哪里使用？

Codex 不是单一编辑器插件，而是一套覆盖不同开发环境的产品形态。

Codex App 目前官方文档列出 macOS 与 Windows 版本。不同平台、套餐及组织策略可能影响部分功能是否可用。

三、Codex 的核心功能

1. 理解整个代码库

Codex 可以搜索文件、追踪函数调用、读取配置和测试，从项目层面回答问题，例如：

解释这个项目的登录流程，列出前端入口、后端接口、鉴权中间件和数据库表。

它特别适合新项目接手、遗留系统梳理、模块依赖分析和技术债调查。项目中加入 AGENTS.md后，还可以告诉 Codex 固定的构建命令、代码规范、目录边界、测试要求和审查规则。

2. 跨文件编写与修改代码

Codex 能完成新增功能、修复缺陷、重构、依赖升级、接口迁移和文档补充。它会尽量沿用项目已有的框架和模式，而不是只生成一段孤立示例。

高质量任务描述通常包含四部分：

目标：为订单接口增加按状态筛选。
范围：只修改 API、服务层和相关测试，不改数据库结构。
验收：支持 pending/paid/cancelled，非法值返回 400。
验证：运行订单模块测试和类型检查。

3. 执行命令与测试

在授权范围内，Codex 可以运行构建、测试、Lint、格式化、数据库迁移或其他终端命令。测试失败后，它还能读取错误输出、定位相关代码并继续修复。

这使它能够形成“修改 -> 测试 -> 分析 -> 再修改”的闭环，而不是把未经验证的代码直接交给用户。

4. 调试与根因分析

你可以把错误日志、堆栈信息、失败测试或复现步骤交给 Codex。它可以结合代码路径进行诊断，并区分表面症状与真正根因。

推荐提示词：

复现并定位这个问题。先说明根因和受影响范围，再做最小修改；修复后增加回归测试。

5. 代码审查与 GitHub 协作

Codex 可以检查本地 diff，也可以在 GitHub Pull Request 中执行审查。官方 GitHub 集成支持通过 @codex review请求审查，还可配置自动审查。Codex 会读取仓库中的 AGENTS.md审查规则，并可根据反馈继续修复分支。

Codex App 还支持查看 diff、暂存文件、提交、推送以及处理 PR 反馈，适合把开发和交付放在同一条线程里完成。

6. 多任务并行与 Worktree

Codex App 可以同时运行多个项目和线程。对于同一仓库的并行任务，可以使用 Git Worktree 隔离修改，避免“任务 A 改到一半，任务 B 又覆盖当前工作区”。

常见组合：

• • 主工作区：人工正在开发核心功能；
• • Worktree 1：Codex 修复测试；
• • Worktree 2：Codex 升级依赖；
• • Worktree 3：Codex审查并修复文档问题。

7. 浏览器与界面验证

Codex App 的内置浏览器可以打开本地网页、检查渲染结果并操作页面流程。前端开发时，Codex可以在改完代码后访问 localhost，验证布局、交互、表单和控制台错误。

Chrome 扩展则适合需要使用已有登录状态的网站任务。因为这类操作可能接触账号数据，必须认真管理网站授权和操作权限。

8. 图片生成与视觉工作

在支持的环境中，Codex 可以在同一线程内生成或编辑图片，并把结果加入网站、游戏或应用资源。它也能结合截图理解界面，完成“参考截图实现页面”“修复视觉偏差”等任务。

9. Automations 自动化

Automations 用于定时运行重复任务，例如：

• • 每天汇总项目错误日志；
• • 每周生成代码变化报告；
• • 定期检查依赖风险；
• • 监控测试失败并生成修复建议；
• • 定时整理 issue、发布说明或项目状态。

自动化可以结合 Skills 与 Plugins。项目级本地自动化运行时，电脑需要开机、Codex App 需要运行，项目目录也必须可访问。对于可能改代码的任务，优先使用独立 Worktree，避免影响正在进行的本地修改。

10. 安全、沙箱与审批

Codex 默认采用受控权限模型。文件写入、网络访问、外部应用和高权限命令会受到沙箱、规则及用户审批限制。可以为可信且重复的命令配置规则，但不建议为了省一次确认就长期开放过宽权限。

使用原则：

• • 只给完成任务所需的最小权限；
• • 安装插件前检查它能访问的数据与可执行动作；
• • 对部署、删除、支付、生产数据库等操作保留人工确认；
• • 不要把密钥直接写入提示词、代码或 Markdown；
• • 安全扫描只用于自己拥有或明确获授权的代码。

四、插件、Skills、Apps 和 MCP 有什么区别？

• • Plugin（插件）：面向安装和分发的完整能力包，可以同时包含 Skills、应用连接和 MCP Server。
• • Skill（技能）：可复用的任务工作流，通常由 SKILL.md、参考资料、脚本和资源组成。
• • App / Connector（应用连接）：连接 GitHub、Slack、Gmail、Google Drive 等外部服务，并在授权后读取数据或执行动作。
• • MCP Server：通过 Model Context Protocol 向 Codex 提供第三方工具和上下文，例如开发文档、Figma、浏览器、数据库或公司内部平台。

一个实用判断方式是：团队流程写成 Skill，对外分发打包成 Plugin，需要实时外部工具时接 MCP，需要访问 SaaS 数据时使用 App/Connector。

五、推荐安装的 Codex 插件

图 2：Codex 官方插件目录示例。实际可见插件会随版本、平台、地区和组织策略变化。

第一梯队：开发者通常最值得安装

1. GitHub

推荐指数：★★★★★

适合绝大多数使用 GitHub 的开发者。它可以帮助 Codex 读取和处理仓库、Issue、Pull Request、CI 状态与代码审查流程。典型用途包括：

• • 总结 PR 变更和讨论；
• • 根据 Issue 定位代码并实施修复；
• • 审查 PR、回复评论、处理审查意见；
• • 检查失败的 GitHub Actions；
• • 创建分支、提交和 Pull Request。

注意区分“Codex 的 GitHub 应用连接”和“仓库本地 Git 命令”：前者访问 GitHub 平台数据，后者处理本地仓库。两者配合最好。

2. OpenAI Developers / 开发文档能力

推荐指数：★★★★★（使用 OpenAI API 时）

如果项目使用 OpenAI API，这类官方文档插件或 Docs MCP 非常有价值。它能让 Codex查询最新官方说明，减少根据旧知识写出过期模型名、参数或接口的风险。

适合：Responses API、Agents SDK、Realtime API、模型迁移、工具调用和提示词工程。

3. Chrome 或 Browser

推荐指数：★★★★★（前端与全栈开发）

用于打开网页、执行交互、验证本地应用和排查浏览器问题。Chrome 扩展更适合需要已有登录态的任务；内置浏览器更适合本地开发、测试和相对隔离的网页流程。

安装后可以这样提问：

启动项目并打开登录页，完成一次错误密码和一次正确密码登录，检查控制台与网络请求。

第二梯队：按工作内容选择

4. Codex Security

推荐指数：★★★★☆

官方 Codex Security 插件用于授权代码的安全审查，可执行仓库扫描、深度扫描、差异扫描和单项漏洞修复。它强调基于代码证据验证候选问题，并输出 Markdown 或 HTML 报告。

适合：重要版本发布前、安全敏感模块、认证与权限变更、外部输入处理、依赖或配置风险审查。它不能替代专业渗透测试、合规审计和人工安全评审。

5. Google Drive

推荐指数：★★★★☆（文档驱动团队）

可让 Codex 在授权范围内处理 Drive、Docs、Sheets 和 Slides。适合读取产品需求、整理会议材料、对照技术方案、生成表格和汇报文档。

6. Slack

推荐指数：★★★★☆（团队协作）

适合总结频道、检索讨论背景、整理决策、起草回复，并把沟通上下文带入开发任务。安装时应关注它能读取哪些工作区和频道，避免把不必要的私密对话暴露给任务。

7. Gmail 与 Google Calendar

推荐指数：★★★☆☆（个人效率与项目管理）

Gmail 适合整理未读邮件、提取待办和起草回复；Calendar 适合查看日程、整理会议和安排任务。这两项并非纯编码必装，但对技术负责人、自由职业者和需要跨工具协作的人很实用。

8. Figma

推荐指数：★★★★☆（UI/前端团队）

用于读取设计上下文并辅助实现界面。适合从设计稿分析组件、颜色、间距和页面结构，再结合浏览器做视觉验证。设计稿不是完整需求，仍需要明确响应式、交互、无障碍与数据状态。

9. Sites

推荐指数：★★★★☆（快速建站）

Sites 插件面向网站、Web App 和游戏的创建与部署。适合原型、活动页、演示项目和快速上线，但生产项目仍要审查域名、数据、权限、监控和部署配置。

10. 部署平台插件

插件目录可能提供 Vercel、Netlify、Cloudflare 等平台能力。它们适合查看部署项目、构建状态和发布流程。只安装团队实际使用的平台，并对生产部署保留审批。

六、一套实用的“必装组合”

通用软件开发

GitHub + OpenAI Developers/Docs + Codex Security

前端与全栈

GitHub + Browser/Chrome + Figma + 实际使用的部署平台

团队技术负责人

GitHub + Slack + Google Drive + Calendar + Codex Security

独立开发者快速上线

GitHub + Browser/Chrome + Sites 或部署平台 + Gmail

不要为了“看起来齐全”安装所有插件。最好的组合是：高频任务覆盖充分，低频敏感权限尽量少。

七、插件安装与使用方法

Codex App

1. 1. 打开侧边栏中的 Plugins。
2. 2. 浏览 OpenAI 精选、团队共享或自己创建的插件。
3. 3. 打开插件详情，查看能力和所需权限。
4. 4. 点击添加或安装，并按提示完成外部服务授权。
5. 5. 安装后新建线程，再直接描述任务或通过 @插件名指定插件。

Codex CLI

启动 Codex 后输入：

/plugins

在插件浏览器中可以查看详情、安装、卸载和启用/停用插件。安装后通常需要开启新线程，使插件能力进入新会话上下文。

MCP

MCP 不是所有场景都需要的“插件替代品”。当你需要连接专用文档、内部工具或第三方开发服务时，可以使用：

codex mcp add <server-name> -- <server-command>
codex mcp --help

配置通常保存在 ~/.codex/config.toml，可信项目也可以使用项目级 .codex/config.toml。MCP Server 可能需要环境变量、Bearer Token 或 OAuth 登录。

八、提高 Codex 效果的最佳实践

1. 1. 先给目标，再给约束。说明要实现什么、不能改什么、怎样验收。
2. 2. 让 Codex 先阅读项目。对陌生代码库，先让它总结架构和现有模式。
3. 3. 要求实际验证。明确要求运行测试、类型检查、构建或浏览器流程。
4. 4. 大任务分阶段。先调查和规划，再实施，最后审查和交付。
5. 5. 用 AGENTS.md固化团队规则。把常用命令、目录边界和 Review 标准写入仓库。
6. 6. 用 Skill 固化重复流程。例如发布检查、故障复盘、依赖升级和安全审查。
7. 7. 并行任务使用 Worktree。减少多个任务互相覆盖。
8. 8. 保持人工负责。关键架构、安全、数据迁移和生产发布必须由人审查。

九、可以直接使用的提示词

新项目理解

阅读这个仓库，说明技术栈、目录结构、启动方式、核心数据流、测试方式和主要风险。只分析，不修改文件。

功能开发

实现用户头像上传。先查找现有上传与鉴权模式，给出简短计划后开始修改。限制图片类型和大小，补充错误处理与测试，最后运行相关验证并总结改动。

Bug 修复

复现这个失败，定位根因并做最小修复。不要掩盖错误或跳过测试；增加能在修复前失败、修复后通过的回归测试。

代码审查

审查当前分支相对主分支的改动。优先找行为回归、安全问题、数据损坏风险、并发错误和缺失测试。按严重程度列出文件与行号。

前端验收

启动本地应用，用浏览器检查桌面和移动端布局，完成主要用户流程，记录控制台和网络错误。发现问题后修复并重新验证。

十、总结

Codex 的价值不只是“写代码更快”，而是把理解、实现、执行、验证和交付连接成一个可监督的工程流程。对个人开发者，它可以减少机械工作；对团队，它可以把规范写入 AGENTS.md和 Skills，把外部系统接入 Plugins、Apps 与 MCP，再用 Worktree 和审批机制控制风险。

最推荐的起步方式是：先熟悉 Codex App 或 CLI，接入 GitHub；前端项目再加入 Browser/Chrome 和 Figma；OpenAI API 项目加入官方开发文档能力；重要仓库加入 Codex Security。使用一段时间后，再把团队反复执行的步骤沉淀成自己的 Skill 或 Plugin。

官方参考资料

• • Codex 官方概览
• • Codex App
• • Codex App 功能
• • Codex Plugins
• • Agent Skills
• • Model Context Protocol
• • Codex GitHub Code Review
• • Codex Security Plugin
• • Codex Automations