📚AI 编程官方教程中文版
📘 OpenAI Codex📚 官方教程中文版新手必读

理解 Codex 定位

Codex 是 OpenAI 面向软件开发的 coding agent(编程 Agent)。ChatGPT Plus、Pro、Business、Edu 和 En

Codex 是 OpenAI 面向软件开发的 coding agent(编程 Agent)。ChatGPT Plus、Pro、Business、Edu 和 Enterprise 套餐都包含 Codex。

对于新手来说,可以先把 Codex 理解成一个能进入代码项目、理解上下文并协助完成开发任务的 AI 编程助手。它不是只回答问题的聊天窗口,而是可以围绕真实代码库工作。

官方页面配图

官方总览页展示了一张 Codex App 截图。图片内容是:Codex app 显示项目侧边栏、thread list(线程列表)和 review pane(审查面板)。

原始图片资源:

lightSrc   /images/codex/app/codex-app-basic-light.webp
darkSrc    /images/codex/app/codex-app-basic-dark.webp

Codex 能帮你做什么

写代码

你描述想构建的东西,Codex 会生成符合你意图的代码,并适配当前项目已有的结构和约定。

这里的重点是“适配现有项目”。新手容易把 AI 编程理解成从零生成代码,但 Codex 更常见的价值,是进入一个已有仓库,理解它的目录、框架、命名方式、组件边界和测试习惯,然后在这个上下文里改代码。

理解陌生代码库

Codex 可以阅读并解释复杂代码或遗留代码,帮助你理解一个团队是如何组织系统的。

如果你第一次接手一个项目,可以先让 Codex 做只读分析,例如:

请阅读这个项目,不要修改文件。告诉我它的用途、主要模块、启动方式和最值得先看的入口文件。

审查代码

Codex 可以分析代码,识别潜在 bug、逻辑错误和没有处理的边界情况。

这类任务适合在提交前使用。你可以让 Codex 只做 review,不直接改文件:

请审查当前改动,重点检查潜在 bug、边界情况和测试缺口。不要修改文件,只给问题清单。

调试和修复问题

当某个功能出错时,Codex 可以帮助追踪失败、诊断根因,并给出有针对性的修复建议。

更稳的提示词写法是让它先复现、再定位、再修复:

请先复现这个错误,确认失败日志和触发条件,再定位最小相关文件。不要一上来大范围重构。

自动化开发任务

Codex 可以执行重复性的开发工作流,例如 refactoring(重构)、testing(测试)、migration(迁移)和 setup tasks(环境设置任务),让你把精力放在更高层的工程判断上。

这里仍然要给清楚边界。不要只说“帮我优化项目”,而要说明要改哪里、不要碰哪里、完成后怎么验证。

从哪里开始

官方总览页给了四个入口。

快速开始

作用:下载 Codex,并开始用 Codex 构建。

官方入口:

https://developers.openai.com/codex/quickstart

中文版教程:

快速开始

查看实战场景

作用:获得使用 Codex 的灵感,看看 Codex 可以帮你完成哪些类型的任务。

官方入口:

https://developers.openai.com/codex/use-cases

开发者社区

作用:阅读社区文章、了解 meetup(线下或线上活动),并连接其他 Codex builders(Codex 构建者)。

官方入口:

https://developers.openai.com/community

面向开源维护者的 Codex 支持

作用:申请或提名开源维护者,获取 API credits(API 额度)、带 Codex 的 ChatGPT Pro,以及选择性开放的 Codex Security access(Codex Security 访问权限)。

官方入口:

https://developers.openai.com/community/codex-for-oss

On this page