内容核对：2026年8月7日。本文依据 OpenAI 官方 Codex 文档整理；产品入口、命令和可用功能可能更新，请以文末官方页面为准。

Codex 是 OpenAI 面向软件开发任务的智能编程助手。它可以阅读代码库、解释项目结构、修改文件、运行测试、排查错误和审查代码。与普通聊天工具不同，Codex 能在获得许可后直接操作你选定的项目，因此适合把“理解需求—修改代码—验证结果”串成一个完整流程。

本文从第一次打开 Codex 开始，介绍桌面应用、命令行和 IDE 扩展的使用方法，并重点说明提示词、项目规则、权限控制和代码审查。

Codex适合做什么

Codex 常见的使用场景包括：

• 阅读陌生项目，说明目录、依赖和关键数据流
• 根据明确需求开发小功能或修改现有功能
• 复现并修复 Bug，补充回归测试
• 编写单元测试、集成测试和项目文档
• 运行格式化、类型检查、构建和测试命令
• 审查未提交改动、某次提交或相对目标分支的差异
• 把重复的开发任务放进脚本或 CI 流程

Codex 可以提高执行速度，但不能替代需求判断、权限管理和最终验收。涉及生产环境、数据库迁移、密钥、付款或删除数据时，仍应由人确认操作范围和结果。

应该选择哪个Codex入口

入口	适合人群	主要特点
Codex 桌面应用	新手、需要同时处理多个任务的人	图形界面直观，可选择本地文件夹并查看改动
Codex CLI	熟悉终端的开发者	在项目目录中工作，可调用 Git、测试和构建工具
IDE 扩展	经常使用编辑器的人	当前打开的文件和选中的代码可直接作为上下文
Codex Web/Cloud	需要把较长任务交给云端的人	适合后台执行任务，再回来查看结果

第一次使用可以从桌面应用开始；已经习惯终端操作，则可直接选择 CLI。它们不是互斥的，同一个项目可以根据任务长短在不同入口间切换。

安装和首次启动

桌面应用

根据 Codex快速入门 下载适用于 macOS 或 Windows 的 Codex 桌面应用，安装后使用 ChatGPT 账号登录。打开本地项目时，只选择本次任务需要访问的文件夹，避免无意扩大可读写范围。

Codex CLI

OpenAI 官方文档目前提供以下 macOS 和 Linux 安装命令：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

只从官方域名下载安装脚本；如果公司安全政策不允许管道执行远程脚本，应先审核脚本或采用组织批准的安装方式。安装或更新完成后，进入项目目录启动：

cd /path/to/your-project
codex

首次启动时按提示登录。随后可以使用这些常用命令：

• /status：查看当前会话、工作目录和配置状态
• /permissions：检查或调整本次任务允许的操作范围
• /model：选择适合当前任务的模型
• /init：为项目生成初始的 AGENTS.md 指引
• /review：审查代码改动，不直接修改工作区

命令和界面可能随版本变化，最新用法请查看 Codex CLI官方文档。

第一次任务怎么做

建议先用一个范围清楚、容易验证的小任务熟悉工作流：

1. 进入正确的 Git 仓库，确认当前分支和未提交改动。
2. 启动 Codex，检查工作目录和权限设置。
3. 让 Codex先阅读相关文件并复述需求，不急于修改。
4. 对多步骤任务先要求给出计划，再开始实施。
5. 修改完成后运行测试、类型检查或构建命令。
6. 检查 diff 和验证结果，再决定是否提交或推送。

一个可直接使用的提示词如下：

请阅读 src/auth 和 tests/auth，修复登录过期后仍显示已登录的问题。
保留现有 API，不新增依赖；先说明原因和修改计划，再实施。
完成后运行相关测试，并汇总改动文件、测试结果和剩余风险。
不要提交或推送代码。

这段提示包含目标、上下文、限制、验证方式和操作边界，通常比“帮我修一下登录”更容易得到稳定结果。

怎样写出有效提示词

根据 OpenAI 的 提示词指南，实用的 Codex 请求通常包含四类信息：

• 目标：最终要实现、修复或解释什么
• 上下文：相关目录、文件、错误信息、复现步骤和已有改动
• 输出：希望得到代码、说明、测试、报告还是审查意见
• 边界：不能改什么、能否新增依赖、是否允许提交或访问网络

解释代码

阅读 app/api 和 app/services，说明一次订单创建请求的调用链。
请列出入口、校验、数据库写入和错误处理，并指出对应文件。
只分析，不修改代码。

修复Bug

复现 issue 中描述的分页重复数据问题，找出根因并修复。
只修改列表查询相关代码，保留公开接口；补充回归测试并运行测试。

开发功能

为设置页增加深色模式开关，复用现有组件和设计变量。
先检查当前主题实现并列出计划，经确认后再修改。
验收条件：刷新后保留设置，键盘可操作，现有测试通过。

审查代码

审查当前未提交改动，重点检查正确性、安全性、并发问题和测试缺口。
按严重程度列出问题，标明文件和行号；不要修改文件。

在 IDE 中，打开的文件和选中代码会自动提供部分上下文；在 CLI 中，最好明确写出文件路径，减少搜索范围和误解。

用AGENTS.md固定项目规则

AGENTS.md 是给 Codex 阅读的项目说明。根据 AGENTS.md官方说明，Codex 会在开始工作前查找这些规则；项目根目录的规则适用于整个仓库，更深目录中的文件可以为局部代码补充或覆盖要求。

一个简洁示例：

## Repository conventions
- 使用 pnpm，不要生成 npm 或 yarn 锁文件。
- 修改 TypeScript 后运行 pnpm lint 和 pnpm test。
- 复用现有组件和工具函数，不引入重复实现。
- 未经明确要求，不提交、推送或修改生产配置。
- 新增依赖和数据库迁移前先说明理由并等待确认。

规则应具体、可执行，并与仓库真实命令保持一致。不要把整份团队手册全部复制进去；优先写包管理器、测试命令、代码风格、禁止修改区域以及需要确认的高风险操作。

权限、沙箱和审批

Codex 的沙箱限制命令可访问的文件与网络范围，审批策略则决定什么时候暂停并请求用户确认。常见组合如下：

配置	能力与风险	适用场景
read-only	只能读取，不能修改	代码理解、审查和诊断
workspace-write + on-request	可修改工作区，越界操作需要审批	大多数本地开发任务
danger-full-access + never	不受沙箱限制且不请求审批	仅限已隔离、已充分信任的自动化环境

日常本地开发优先使用“工作区可写、按需审批”。不要因为任务执行失败就直接开放全部权限，应先判断缺的是网络、工作区外路径还是某条具体命令。完整机制可参考 Codex沙箱文档。

还应遵守以下安全习惯：

• 提示词、终端输出和截图中不要粘贴 API 密钥或密码
• 修改前后保留 Git 检查点，先查看 diff 再提交
• 删除文件、迁移数据库和覆盖配置前明确目标范围
• 把生产凭据与测试环境分开，使用最小权限账号
• 对第三方代码、安装脚本和 MCP 服务先核对来源

用代码审查做最后一道检查

在 CLI 中执行 /review，可以选择相对基础分支审查、审查未提交改动或审查某次提交。按照 Codex代码审查文档，该模式会报告发现的问题，但不会直接修改工作区。

审查时应明确关注点，例如：

• 用户输入是否经过校验和转义
• 权限判断是否遗漏分支
• 并发、缓存和事务是否可能产生不一致
• 错误处理是否泄露敏感信息
• 新增逻辑是否有正常、异常和边界测试

Codex 没有报告问题，不等于代码一定正确。关键改动仍需结合自动化测试、人工验收和团队评审。

MCP是什么，什么时候使用

MCP 可以让 Codex 连接额外的工具和上下文，例如官方文档服务或团队内部系统。CLI、IDE 与桌面应用在同一台主机上可以共享配置。常用命令包括：

codex mcp add <server-name> ...
codex mcp list
codex mcp login <server-name>

只有当任务确实需要外部信息或操作时才添加服务，并检查服务提供者、访问权限和可用工具。项目级 MCP 配置只应在可信仓库中启用。具体配置方式见 Codex MCP文档。

常见误区

一句话让Codex修改整个项目

范围过大时，Codex需要猜测需求和验收标准。先限定目录、接口和测试，再把大任务拆成可验证的小步骤。

不检查工作区就开始

已有未提交改动可能属于另一个任务。开始前查看 Git 状态，要求保留无关改动；完成后只审查本次涉及的 diff。

只看“完成了”，不看验证证据

要求 Codex列出运行过的命令、成功与失败结果、未运行项目及剩余风险。测试未通过时不要把任务当作已完成。

默认允许提交和推送

代码修改、提交、推送和发布是不同层级的操作。提示词中明确写出允许做到哪一步；涉及远程仓库或生产发布时再单独授权。

盲目开放全部权限

优先给出完成当前任务所需的最小范围。遇到阻塞时针对具体命令审批，而不是永久取消所有限制。

常见问题

Codex会自动修改我的全部文件吗？

不会主动修改所有文件，但它能在已授权范围内执行操作。选择正确的项目目录、使用合适的沙箱，并在提示词中限制可修改区域，可以显著降低误改风险。

Codex能替我直接发布上线吗？

在具备工具、权限和明确授权时可以参与发布流程，但生产发布属于高风险操作。更稳妥的方式是让 Codex完成修改、测试和发布前检查，由人确认差异与环境后再执行上线。

Codex和普通聊天有什么区别？

普通聊天主要返回文字或代码片段；Codex更强调在真实代码库中读取文件、实施修改、运行命令并验证结果。正因如此，项目规则和权限边界也更加重要。

新手最值得先学什么？

先学会写清目标、上下文、验收标准和禁止事项，再掌握 Git diff、测试命令与 /review。这些习惯比一次性写很长的提示词更重要。

官方资料

• Codex快速入门
• Codex CLI
• Codex IDE扩展
• Codex提示词指南
• AGENTS.md项目规则
• 权限沙箱与审批
• Codex代码审查
• Codex MCP配置