OpenAI Codex：一步步掌握软件工程智能体

# OpenAI Codex：一步步掌握软件工程智能体（3 个实战案例）

> 原文：DataCamp · Aashi Dutt（更新于 2026 年 6 月 3 日）  

> 来源：https://www.datacamp.com/tutorial/openai-codex


## 导读

OpenAI Codex 是运行在 ChatGPT 中的软件工程智能体。你只需用自然语言描述任务，它就会在独立沙盒中完成工作，最后把可审查的修改交付给你，甚至自动生成 Pull Request。

本文将演示如何在 GitHub 仓库中使用 Codex：修复代码并创建 PR、解释复杂函数，以及根据问答式提示定位并修复 Bug。整个过程都在 ChatGPT 内完成，且每一步都可验证。

## TL;DR

- Codex 是云端软件工程智能体，可在 ChatGPT 中使用。

- 连接 GitHub 仓库后，可让它修复 Bug、应用补丁、生成测试或解释代码。

- 每项任务都在隔离沙盒中运行，完成后生成供你审核的 Pull Request。

- 用 `AGENTS.md` 约定代码风格、测试和 PR 规则。

- Codex 也可通过 Codex CLI 和 VS Code 扩展运行。

## 什么是 OpenAI Codex？

Codex 能编写和编辑代码、运行测试、修复 Bug，并提出 Pull Request。每项任务都在独立的沙盒环境中执行。它由 OpenAI 前沿模型驱动，强调安全性、可测试性和开发效率；你可以通过 `AGENTS.md` 指导它，也可以直接在 ChatGPT 侧栏中交互。

| 方式 | 使用位置 | 适合场景 |

|---|---|---|

| ChatGPT 侧栏 | chatgpt.com | 连接 GitHub 的任务队列 |

| 独立 Mac 应用 | chatgpt.com/codex | 更丰富的界面、自动化和连接器 |

| VS Code 扩展 | VS Code Marketplace | 在编辑器内委派任务 |

| Codex CLI | 终端 | 脚本化工作流与 CI 集成 |

## 设置 Codex

### 第 1 步：找到 Codex

登录 ChatGPT，在左侧工具栏找到 Codex。现在 Codex 已覆盖所有 ChatGPT 方案，但 Free 和 Go 的使用额度非常有限。


### 第 2 步：开始使用

点击 Codex，进入初始化页面，选择“Get Started”，按提示完成身份验证。

### 第 3 步：启用多因素认证

点击“Set up MFA to continue”，用 Google Authenticator 或 Authy 扫描二维码，输入验证码完成验证。

### 第 4 步：连接 GitHub

完成 MFA 后，点击“Connect to GitHub”，授权 GitHub 连接器。随后在 GitHub organization 中选择“Add a GitHub account”，完成安装与授权。你可以授权全部仓库，也可以只选择特定仓库。

选择要处理的仓库并点击“Create environment”。在 Data Controls 中按需关闭模型改进数据共享选项。环境准备好后，可以并行启动多个任务。

### 第 5 步：使用 `AGENTS.md`（可选）

`AGENTS.md` 是 Codex 使用的项目级开发手册。例如：

```md

# AGENTS.md

## Code Style

- 使用 Black 格式化 Python。

- 变量名避免缩写。

## Testing

- 提交 PR 前运行 pytest tests/。

- 所有提交必须通过 flake8。

## PR Instructions

- 标题格式：[Fix] 简短描述

- 包含一行摘要和“Testing Done”部分

```

Codex 会查找覆盖目标文件的 `AGENTS.md`，应用其中的格式、测试与文档要求；当存在多层配置时，优先采用更深层目录的规则。

## 三个实战案例


### 案例 1：修复基础问题和拼写错误

Codex 会把一个请求拆成多个子任务，例如修复拼写、改进 README、编写测试，并在同一工作区中完成。你可以在现有任务里继续提问或要求修改。满意后点击“Push”创建 Pull Request，再点击“View Pull Request”查看并合并。

### 案例 2：解释代码库

Codex 也适合只读探索。它可以按用途梳理项目结构，而不是简单罗列文件。例如，它会指出 `qwen3_demo.py` 是主脚本，启动两个 Gradio 界面；`qwen3_demo.ipynb` 是交互式 Notebook；`test_qwen3_demo.py` 用于单元测试；`README.md` 提供文档和视频说明。

它还会总结依赖（如 Ollama CLI）、`_run_ollama` 函数的作用、扩展界面的建议，并提出模型版本管理、UI 改进和错误处理等下一步方向。

### 案例 3：发现并修复 Bug

Codex 可以扫描整个代码库，定位问题，提出修复方案，并展示变更预览。你可以通过“Logs”查看后台过程；Codex 会返回修改摘要以及受影响的文件，并允许你继续追问或要求增强实现。确认修复后，点击“Push”和“Create New PR”创建 PR，审核后合并到主分支。

## 为什么 Codex 重要？

Codex 是协作型智能体，而不是被动的代码补全工具。你可以让它编写、重构、测试、调试或解释代码，并查看每一步的终端日志、引用和输出。

- 任务过程可追踪、可验证。

- 支持并行工作，可一次排队多个变更。

- 遵循你的开发环境与 `AGENTS.md` 约定。

- 符合人工 PR 流程，并能够通过 CI 测试。

## 总结

Codex 可以修复 Bug、应用功能补丁、解释代码逻辑，同时生成 Pull Request、运行测试，并通过日志和 diff 说明操作。无论是调试遗留代码、快速熟悉新仓库，还是处理日常维护，它都能改善开发工作流。未来它还可能与 IDE、CI 流水线和任务规划器进一步集成。

## 常见问题

### Codex 和 ChatGPT 有什么区别？

Codex 是专门面向软件工程的智能体，针对 Git 仓库中的任务执行进行了优化。

### 需要安装 Codex 吗？

在 ChatGPT 应用中使用无需安装；如果要在终端使用，则需要安装 Codex CLI。

### OpenAI Codex 安全吗？

Codex 在安全、隔离的容器中运行。默认情况下，任务执行期间没有互联网访问；如需联网，可按环境配置域名白名单和允许的 HTTP 方法。

### 哪些 ChatGPT 方案包含 Codex？

Free、Go、Plus、Pro、Business、Edu 和 Enterprise 均包含 Codex，但 Free 和 Go 的访问非常有限。最新价格和可用性请查看 OpenAI 官方定价页面。

### Codex 与 GitHub Copilot 有何不同？

Copilot 在 IDE 中进行行内补全；Codex 是你分配任务后执行多步骤工作的智能体，例如修复 Bug、运行测试和创建 PR。两者互为补充。

### Codex 支持哪些编程语言？

Codex 可处理 GitHub 仓库使用的任何语言。Python、JavaScript、TypeScript、Go、Rust 和 Ruby 都有良好支持；代码库越成熟、开源训练语料越丰富，表现通常越好。

---

**版权与来源说明：**本文为基于 DataCamp 原文的中文翻译与排版稿，仅供学习和公众号编辑使用，请保留原文来源与作者署名。