OpenAI 的 Codex 作为一款专为软件工程师设计的云端编程智能体，正在改变开发者的日常工作流程。本教程将直接进入实用阶段，帮助你快速设置、使用并掌握 Codex 的各项功能，提升开发效率。
快速设置指南
要开始使用 Codex，你需要完成一系列账号授权和环境配置。以下是详细的设置流程：
账号权限与前置要求
目前（2025年5月），Codex 仅向以下用户开放：
- Utilizadores do ChatGPT Pro ($200 por mês)
- Utilizadores do ChatGPT Enterprise
- Utilizadores da equipa ChatGPT
注意：ChatGPT Plus 和 Edu 用户预计很快就能使用此功能。
设置步骤详解
- 访问 Codex 入口
- 登录你的 ChatGPT 账号
- 在侧边栏找到 Codex 选项
- 点击后会跳转到独立的 Codex 应用页面
- 启用多因素认证（MFA）
- Codex 要求你的账号必须启用 MFA
- 可以使用 Google Authenticator、OnePass 等任何认证应用
- 这是安全措施，因为 Codex 将获得对你 GitHub 仓库的访问权限
- GitHub 账号关联
- 授权 Codex 访问你的 GitHub 账号
- 选择组织访问权限（如适用于你的情况）
- 设置访问权限范围（只读或读写权限）
- 注意：如果你授予读写权限，Codex 将能够创建 PR
- 数据使用设置
- 在设置过程中，会有一个数据授权选项
- 默认情况下，Codex 会使用你的代码进行训练
- 如果不希望你的代码被用于训练，需要手动取消勾选
完成上述步骤后，你就可以开始选择代码仓库并使用 Codex 了。整个设置过程设计得非常直观，即使是首次使用的开发者也能轻松完成。
界面与基本操作
成功设置 Codex 后，你将看到一个直观的用户界面，让我们来了解如何进行基本操作。
主界面概览
Codex 的主界面包含以下关键元素：
- 仓库选择器：用于切换不同的 GitHub 仓库
- 任务列表：显示当前和历史任务
- 任务类型选择器：用于选择 Ask 或 Code 模式
- 任务输入框：输入你想要执行的任务描述
两种核心任务模式
Codex 提供两种不同的操作模式，各自适用于不同场景：
- Ask 模式（提问模式）
- 用于查询和理解代码库
- 不会修改任何代码
- 适合了解项目结构、寻求解释或探索代码库
- 示例：询问项目总代码行数、代码结构分析等
- Code 模式（编码模式）
- 用于执行实际的代码修改任务
- 将在云端环境中修改代码并生成变更
- 适合修复 bug、添加功能、重构代码等
- 允许创建 Pull Request 提交变更
创建和管理任务
要创建新任务，步骤如下：
- 选择任务类型（Ask 或 Code）
- 在输入框中描述你的任务
- 对于首次使用，可以直接点击预设的示例任务
- 点击”Start Task”按钮提交任务
提交后，Codex 会开始处理你的任务，并显示实时进度。每个任务都在单独的页面中进行管理，你可以并行运行多个任务。
查看任务结果
任务完成后，你将看到详细的执行结果：
- 对于 Ask 模式：获得问题的详细解答
- 对于 Code 模式：查看代码变更、终端输出和测试结果
对于 Code 任务，你还可以：
- 创建 GitHub PR：将变更作为 PR 提交到仓库
- 要求进一步修改：给出反馈让 Codex 调整其解决方案
- 查看详细的执行日志和证据链
任务提交与执行全流程
让我们通过一个实际例子，演示如何使用 Codex 完成一个简单的代码修复任务。
选择合适的仓库
首先，在 Codex 主界面选择一个你熟悉的 GitHub 仓库。理想情况下，选择：
- 有明确文档的项目
- 包含测试的项目
- 简单的依赖结构
这样可以让 Codex 更容易理解和执行任务。
提交一个 Code 任务
- 选择”Code”模式
- 在任务描述中输入：
向新手解释代码库。一般结构是什么，需要知道的重要事项是什么，以及接下来学习的一些要点是什么。 - 点击”Start Task”按钮
跟踪任务进度
提交任务后，你可以实时观察 Codex 的工作过程：
- Codex 会先分析代码库结构
- 然后搜索指定目录中的文件
- 检查代码中的拼写和语法问题
- 应用修复并运行测试验证
整个过程可能需要几分钟时间，取决于代码库的大小和复杂度。
审核结果并创建 PR
任务完成后，你将看到 Codex 的工作成果：
- 修改了哪些文件
- 具体修复了什么问题
- 测试通过情况
如果你对结果满意，可以点击”Create PR”按钮，Codex 将自动创建一个包含这些修改的 Pull Request。然后你可以回到 GitHub，按照常规流程审核并合并这个 PR。
通过这个简单的例子，你可以看到 Codex 如何无缝集成到你的开发工作流中，帮助处理日常编码任务。
高级使用技巧
要充分发挥 Codex 的潜力，掌握一些高级技巧和最佳实践非常重要。
提示词工程
编写高质量的任务描述（提示）是充分利用 Codex 的关键。以下是一些实用技巧：
| 技巧 | instruções | 示例 |
|---|---|---|
| 明确具体 | 提供详细的任务描述，避免模糊表述 | ❌ “修复登录问题”<br>✅ “修复用户提交空密码时的登录崩溃问题” |
| 限定范围 | 明确指定要处理的文件或代码区域 | “只修改 src/components/auth/ 目录下的文件” |
| 提供上下文 | 附上错误信息、日志或相关描述 | “修复以下错误：TypeError: Cannot read property ‘value’ of undefined at line 42” |
| 明确成功标准 | 告诉 Codex 如何判断任务是否成功完成 | “确保所有测试通过，特别是 npm run test:auth“ |
| 使用可搜索关键词 | 包含唯一标识符，便于 Codex 定位 | 函数名、类名、唯一错误消息等 |
项目优化配置
为了让 Codex 更高效地工作，可以在项目中添加辅助信息：
添加 AGENTS.md 文件
在项目根目录创建 AGENTES.md 文件，为 AI 智能体提供项目指导，包括：
- 项目结构说明
- 编码规范与风格指南
- 测试运行方法
- PR 创建规则
- 开发流程说明
示例 AGENTS.md 内容：
## 项目结构
- src/api: API 端点定义
- src/components: React 组件
- src/utils: 通用工具函数
## 测试指南
- 运行 `npm test` 执行所有测试
- 每个功能必须有单元测试
## PR 规范
- 标题格式: [模块] 简要描述
- 必须通过所有 lint 检查和测试
环境限制与注意事项
使用 Codex 时，需要注意以下限制：
- 无互联网访问
- Codex 运行环境无法访问外部网络
- 无法安装新的依赖包（如
npm install无效） - 只能使用项目中已有的代码和预装依赖
- Configuração do ambiente
- 可通过高级设置自定义环境脚本
- 需预先配置好所需的依赖和环境
- 任务隔离
- 每个任务在独立环境中运行，不共享状态
- 多个任务之间无法直接交互
应用场景与实用案例分析
基于实际开发需求，Codex 可以在多种场景中提供有效帮助。以下是一些典型用例及相应的任务设计方法。
代码审查与优化
场景描述：检查代码质量并提出改进建议
任务格式：
请审查 src/components/UserProfile.tsx 文件，分析可能的性能问题，并提出改进建议。特别关注不必要的渲染和内存泄漏风险。
实施要点：
- 请求具体、可操作的建议而非泛泛而谈
- 指定关注点（如性能、安全性、可维护性）
- 要求提供证据或解释，不仅是结论
复杂 Bug 诊断与修复
场景描述：修复难以复现的条件性错误
任务格式：
在用户同时修改多个字段并快速保存时，偶尔会出现以下错误：
TypeError: Cannot read properties of undefined (reading 'email')
at validateUserInput (/app/src/utils/validation.ts:41)
请分析可能的原因并修复此问题，确保即使在异步操作竞态条件下也能正常工作。
实施要点：
- 提供完整的错误堆栈信息
- 描述错误出现的具体场景和条件
- 明确修复的验收标准（如应通过哪些测试）
专业领域编程
场景描述：特定领域（如硬件描述语言）的代码生成
任务格式：
设计一个8位RISC处理器的Verilog模块，包含以下指令集：ADD, SUB, AND, OR, XOR, LOAD, STORE, JUMP。确保时序正确且可综合。
实施要点：
- 提供明确的技术规格要求
- 指定验证方法（如仿真测试）
- 要求符合行业标准实践
自动化测试生成
场景描述：为新实现的功能创建测试套件
任务格式：
为 src/services/authentication.js 文件中的所有公共方法生成单元测试。确保测试包含正常路径、错误处理和边缘情况。使用项目中已有的Jest测试框架和测试风格。
实施要点：
- 明确测试框架和风格要求
- 指定需要测试的方法或功能
- 要求覆盖不同类型的测试场景
实用技巧总结
根据实际使用 Codex 的开发者反馈，以下做法可以显著提高效率：
- 任务批处理
- 每天早上提交一批小任务，让 Codex 并行处理
- 回来时直接审查结果，而不是等待每个任务
- 递进式任务
- 先让 Codex 分析问题
- 根据分析结果细化后续任务
- 逐步完善解决方案
- 探索式开发
- 让 Codex 同时尝试多种解决方案
- 比较不同方案的优缺点
- 选择最佳方案进行实施
- 与团队工作流集成
- 在 PR 审查前先让 Codex 进行代码审核
- 使用 Codex 生成初步文档，然后人工完善
- 让 Codex 处理常规维护任务，如依赖更新、样式调整等
通过这些实用案例和技巧，你可以将 Codex 有效整合到日常开发流程中，让它成为你的编程助手，处理繁琐任务，提升整体开发效率。
