逸尘的AI知识库

Codex从入门到精通

24分钟阅读

Codex 从入门到精通

写给第一次接触 Codex 的你。
不默认你懂命令行，也不把你当“已经会写代码的人”。
目标很简单：让你知道 Codex 是什么、怎么开始、怎么用得顺手、怎么少踩坑。

目录

1. 先用一句人话讲清楚：Codex 是什么

Codex 可以理解成“会看项目、会改代码、会跑命令、会解释问题的 AI 编程搭档”。

它不是只能吐一段代码的聊天机器人。现在官方主推的 Codex，已经可以在终端、IDE、云端和桌面 App 里工作。它能：

  • 看懂你的项目结构
  • 解释某段代码在干嘛
  • 帮你修 bug
  • 帮你补测试
  • 帮你做代码 review
  • 按你的要求改文件、跑命令、验证结果

如果用更接地气的话说：

你负责说清楚目标，Codex 负责帮你动手。

但前提是：你得会“指挥”它。

2. 它适合谁

Codex 很适合下面这几类人：

2.1 刚学编程的人

你可能还没建立完整的项目思维，但已经开始接触真实仓库了。这个时候，Codex 很适合拿来做“项目翻译器”。

比如你可以问：

  • 这个项目入口在哪？
  • 登录逻辑在哪几个文件？
  • 这个报错大概是什么原因？
  • 我应该先改前端还是后端？

2.2 会一点代码，但看项目容易懵的人

很多人不是不会写 if，而是一进真实项目就迷路。文件一多、模块一多、配置一多，脑子直接乱掉。

Codex 最强的一点，就是能帮你先把“地图”画出来。

2.3 已经在做项目的人

如果你已经开始做网页、脚本、小工具或者公司项目，那 Codex 更像一个“提高效率的搭子”：

  • 帮你查问题
  • 帮你整理思路
  • 帮你做小步修改
  • 帮你补测试和自检

3. 你会在哪些地方用到 Codex

OpenAI 现在把 Codex 放在几个主要入口里。

3.1 终端里：Codex CLI

这是很多人最常用的入口。

你在项目目录里打开终端，输入 codex，就能直接让它在当前目录干活。

它适合：

  • 看项目
  • 改文件
  • 跑命令
  • 做小步迭代

如果你以后想成为真正能做项目的人，CLI 很值得早点适应。

3.2 编辑器里：Codex IDE 扩展

如果你平时用 VS Code、Cursor、Windsurf 这类编辑器，可以直接在编辑器里和 Codex 协作。

它适合：

  • 一边看代码一边问
  • 把当前选中的文件直接给它
  • 在侧边栏里持续对话
  • 本地写代码时让它帮你补、改、解释

3.3 云端：Codex web / cloud

这个入口的意思不是“在网页里聊天”，而是：

把任务委托给云端环境去跑。

它适合更重一点的工作，比如：

  • 扫一遍项目，找 bug
  • 并行做几件事
  • 生成候选改动
  • 做批量分析

3.4 桌面应用：Codex App

可以把它理解成一个更“项目管理化”的 Codex 控制台。

它支持：

  • 多线程并行
  • worktree
  • Git 功能
  • automations

这个更适合中后期你项目多了、任务多了的时候用。

4. 新手 10 分钟上手

这一段最重要。你不用先变高手，先把它跑起来。

4.1 安装 CLI

官方当前提供两种常见安装方式：

npm install -g @openai/codex

或者：

brew install codex

装好之后，终端里输入：

codex

第一次运行时，按官方文档说明，你可以用 ChatGPT 账号 或 API key 登录。

4.2 先别急着改代码，第一句先这样问

进入你的项目目录后，先来一句：

codex "Explain this project to me like I'm new to the codebase"

如果你想中文一点，也可以直接写：

codex "请先不要修改代码，用小白能听懂的话解释这个项目的结构、入口、核心模块和运行流程"

这是最推荐的入门第一步。

因为很多新手一上来就说“帮我写一个功能”，结果自己连项目入口都不知道，最后看不懂改动，也不知道对不对。

先让 Codex 给你讲明白项目，你后面会轻松很多。

4.3 在 IDE 里用

如果你不想一开始就泡终端，也可以先装官方的 Codex IDE 扩展。

思路很简单：

  1. 安装扩展
  2. 登录账号
  3. 打开项目
  4. 在侧边栏里跟 Codex 说你要做什么

官方 quickstart 里提到，Codex 默认是 Agent mode，也就是它不只是聊天，而是可以读文件、跑命令、写改动。

4.4 第一次使用前，先给自己留后路

这是很重要的一条：

在让 Codex 改代码之前，先做 Git 提交或至少做一个 checkpoint。

原因很简单：

  • 你是新手
  • 它可能改多了
  • 你可能看不懂某一步
  • 有回滚点，你才敢放心试

一句大白话：

别裸奔。

5. 第一次用，最推荐你做的 5 件事

5.1 让它解释项目

这是新手必学。

你可以这样说：

先不要修改代码。
请用小白能懂的话告诉我：
1. 这个项目的目录结构分别是干什么的
2. 入口文件在哪
3. 登录流程会经过哪些文件
4. 如果我要改首页，应该先看哪几个文件

5.2 让它定位 bug

比如你网页点按钮没反应，你可以这样说：

请帮我定位这个问题，但先不要大改：
- 现象：点击提交按钮后没有任何反应
- 预期：应该提交表单并提示成功
- 约束：先找根因，再做最小修改
- 修改后请告诉我怎么验证

这类任务很适合 Codex，因为它会去读相关文件、找事件处理、看调用链。

5.3 让它补测试

很多人会忽略这一点，但这是让你从“瞎改”走向“稳改”的关键。

请为刚才的修改补上相关测试：
- 只覆盖本次改动相关逻辑
- 优先覆盖边界情况
- 不要引入新框架
- 写完后运行相关测试

5.4 让它做最小功能

比如你要加一个“修改昵称”的功能：

帮我做一个最小可用版本：
- 功能：用户可以修改昵称
- 范围：前端表单 + 调用已有接口
- 不做：权限系统重构，不改数据库结构
- 完成标准：
  - 页面可操作
  - 输入校验正常
  - 失败有提示
  - 成功后界面状态更新

这类写法的重点不在“会不会说话”，而在于：

  • 你把范围说清了
  • 你把不该动的地方说清了
  • 你把完成标准说清了

Codex 最怕你一句：

“帮我把这个项目优化一下。”

这种话听起来很高级，实际上最容易把事情搞大。

5.5 让它给你做代码审查

如果你接上 GitHub，官方支持在 PR 里用 @codex review 发起 review。

这个很适合你在做完改动后，让它再帮你查一遍：

  • 有没有明显 bug
  • 有没有漏掉边界情况
  • 有没有该补没补的测试

6. 真正决定效果的，不是“模型强不强”，而是你怎么下指令

这里是整篇里最值钱的一段。

很多人觉得 AI 不好用，真相往往不是模型不行，而是：

自己给的任务描述太糊。

6.1 好指令的基本结构

你可以记住这个模板：

目标：我要做什么
背景：这个功能/问题发生在什么场景
范围：哪些可以动，哪些不要动
标准：做完以后，怎样算完成
验证：修改后需要怎么检查

比如：

目标：修复注册页提交失败的问题
背景：用户填写表单后点击注册，页面没有报错，但也没有成功跳转
范围：只改注册相关前后端逻辑，不重构整个表单系统
标准：用户提交后能正常注册；失败时有明确提示
验证：请运行相关测试或给出手动验证步骤

6.2 新手非常好用的提示词套路

套路 1：先解释，再动手

先不要改代码。
先告诉我你认为问题最可能出在哪几个文件，以及你准备怎么改。
等你解释清楚后，再开始修改。

这句非常有用。

因为它会强迫 Codex 先思考，不要一上来乱改。

套路 2：要求最小改动

请做最小、最高置信度的修改，不要顺手重构无关代码。

这句对新手特别重要。

不然它有时会“好心办坏事”，顺手帮你改出一大片。

套路 3：要求列出改动说明

修改后请告诉我：
1. 改了哪些文件
2. 每个文件为什么要改
3. 风险点是什么
4. 我接下来应该怎么验证

这能帮助你真正学到东西，而不是只得到结果。

套路 4：要求它像老师一样说人话

请用初学者能听懂的话解释，不要默认我熟悉这个项目。

这个很重要。真的很重要。

因为很多 AI 默认输出会偏工程师口吻，不加这句，解释容易太硬。

7. Codex 为什么有时会停下来问你要不要继续

你可能会碰到这种情况：

  • 它准备运行某个命令
  • 它准备写文件
  • 它准备联网
  • 它准备做某些可能有风险的操作

然后它停下来问你：要不要批准。

这不是它卡了，这是正常的安全设计。

7.1 为什么要这样

因为 Codex 是 agent，不只是“说”。

它会真的动你的项目。

所以很多环境会加这些限制：

  • 文件系统权限
  • 命令执行权限
  • 网络权限
  • 沙箱限制
  • 审批确认

你可以把它理解成：

它不是没能力，而是不能在没打招呼的情况下乱动。

7.2 新手应该怎么处理

原则很简单：

  • 看懂它要干什么，再批准
  • 看不懂的命令，先问
  • 大改动前先做 Git checkpoint
  • 不要在你完全不了解的仓库里盲点通过

8. CLI 是什么，怎么学

CLI = Command Line Interface，也就是命令行界面。

如果你是小白，别被这个名字吓到。它本质上就是：

在终端里和 Codex 对话，并让它在当前目录工作。

8.1 为什么 CLI 值得学

因为一旦你会一点 CLI，你和项目的距离会突然拉近很多。

你会更容易：

  • 切到正确目录
  • 运行项目
  • 看报错
  • 跑测试
  • 让 Codex 在对的位置干活

8.2 最基础的使用方式

在项目目录下输入：

codex

或者直接附一句任务：

codex "请解释这个仓库的核心结构"

8.3 对新手最有用的 3 个 CLI 场景

场景 1：看懂仓库

codex "先不要改代码，帮我解释这个仓库的目录结构、入口和主要数据流"

场景 2：修一个具体问题

codex "请修复登录页按钮点击没反应的问题，要求最小改动，并在修改后告诉我验证步骤"

场景 3：给我学习路径

codex "如果我是这个项目的新成员，请告诉我应该按什么顺序阅读文件"

这个用法对小白特别友好。

因为你不只是拿它干活，还能拿它当“项目导师”。

9. IDE 里怎么用 Codex

如果你主要在 VS Code 里学习和写项目，那 IDE 入口对你会更友好。

9.1 为什么 IDE 更适合新手

因为你可以一边看文件，一边问问题。

这种体验比纯终端更直观：

  • 左边是文件树
  • 中间是代码
  • 旁边是 Codex

你看到哪，问到哪，改到哪。

9.2 最推荐的用法

用法 1：选中一段代码直接问

例如你选中一段表单提交逻辑，然后问：

这段代码在干嘛？请按执行顺序解释。

用法 2：指定文件一起分析

请结合 LoginPage、auth.ts 和 api.ts 一起分析，告诉我登录按钮点击后请求是怎么走的。

用法 3：边改边讲

请帮我改这个 bug，但每改一步都顺便告诉我你为什么这样改。

这个非常适合学习。

你会慢一点，但会真的长本事。

10. 云端 Codex 和桌面 App 是干嘛的

很多人看到 cloud、app、threads 这类词会有点懵，其实可以这样理解。

10.1 云端 Codex

云端的好处是：

  • 能跑更重的任务
  • 可以并行处理
  • 不一定全靠你本地机器

适合这些事：

  • 帮我梳理整个项目
  • 帮我审一批改动
  • 帮我找潜在问题
  • 帮我给几个方案

10.2 Codex App

桌面 App 更像“你的 Codex 指挥中心”。

适合：

  • 同时处理多个任务
  • 在不同线程里推进不同改动
  • 结合 Git 看结果
  • 做更工程化的工作流

如果你现在还是新手，不一定要一上来就用 App。
但你要知道：Codex 不只是一个对话框，它正在变成一个完整开发工作台。

11. 用 Codex 做 GitHub Review

如果你已经开始用 GitHub 提 PR，这个功能很有价值。

官方支持在 PR 评论里写：

@codex review

然后 Codex 会像一个队友一样给出 review。

11.1 它通常会帮你看什么

  • 潜在 bug
  • 边界情况
  • 回归风险
  • 测试缺失
  • 文档问题

11.2 什么时候最适合用

  • 你自己改完后，想再过一遍
  • 你帮别人 review，又怕漏问题
  • 你想建立更规范的开发习惯

11.3 一个很实在的提醒

它能帮你看出很多问题，但它不是“判决书”。

你还是要自己判断：

  • 这个建议是否符合业务
  • 这个风险是否真实存在
  • 这个改动值不值得做

12. 小白最容易踩的坑

这一段你一定要看。

坑 1：一句话让它“优化整个项目”

这类指令最容易翻车：

  • 帮我优化一下
  • 帮我重构一下
  • 帮我改得更高级

为什么危险？

因为没有边界。

它一旦“发挥起来”，新手几乎接不住。

更好的说法是：

请只优化这个函数的可读性，不改变行为，不影响其他模块。

坑 2：自己没看懂就直接接受改动

新手最容易这样：

  • 看它改了很多
  • 感觉好厉害
  • 直接全收

然后项目就炸了。

正确做法是：

  • 先看它改了哪些文件
  • 先让它解释为什么这样改
  • 先跑测试或自己点一遍关键流程

坑 3：不给验证标准

你不说“怎么才算改好了”，它就只能自己猜。

所以尽量补一句：

完成后请运行相关测试，或者给出明确的手动验证步骤。

坑 4：一口气让它干太多事

比如：

帮我把登录、注册、权限、数据库、UI、部署全都整理一下。

这不是任务，这是许愿。

正确做法是拆开：

  1. 先解释登录流程
  2. 再修登录 bug
  3. 再补测试
  4. 再考虑抽离复用逻辑

坑 5：把 Codex 当“自动正确”

这个心态一定要改。

更正确的理解是：

Codex 很强，但你才是最后拍板的人。

13. 一条真正靠谱的学习路线

如果你是编程小白，我建议你按这个顺序来。

第 1 阶段：把它当“解释器”

你先别急着让它大改代码。

先大量使用这些问法：

  • 这段代码在干嘛？
  • 项目入口在哪？
  • 这个错误是什么意思？
  • 如果我要改这里，先看哪几个文件？

目标是：训练你的项目理解力。

第 2 阶段：让它做最小改动

开始尝试：

  • 修一个按钮事件
  • 改一个显示 bug
  • 补一个接口调用
  • 增加一个简单表单校验

目标是：学会“小步修改”。

第 3 阶段：让它帮你验证

开始习惯让它：

  • 补测试
  • 跑测试
  • 列出验证步骤
  • 解释风险点

目标是：从“会改”变成“会稳”。

第 4 阶段：让它和 Git、PR、Review 配合

当你已经能做小项目后，再把 Codex 用进完整流程：

  • 建分支
  • 做改动
  • 自检
  • PR review
  • 合并

目标是：学会真实开发流程。

14. 常用指令速查

下面这些很适合你直接复制改一改。

14.1 解释项目

codex "请先不要修改代码，用小白能听懂的话解释这个项目的目录结构、入口和核心模块"

14.2 找 bug

codex "请帮我定位并修复登录按钮无响应的问题，要求最小改动，并给出验证步骤"

14.3 补测试

codex "请为刚才的修改补充相关测试，只覆盖本次改动相关逻辑，并运行相关测试"

14.4 给学习顺序

codex "如果我是新成员，请告诉我应该按什么顺序阅读这个仓库"

14.5 先计划后修改

codex "先不要改代码，先告诉我你准备改哪些文件、为什么改、风险点是什么，等解释清楚后再开始"

14.6 要求说人话

codex "请用初学者能听懂的话解释，不要默认我熟悉这个项目"

参考资料

下面这些是整理本教程时参考的 OpenAI 官方文档，建议你后续按需深入看：

一句话收尾

Codex 最值得学的，不是“让它帮你写多少代码”，而是“你能不能借它更快看懂项目、拆清任务、稳定交付”。

你把这件事练会了，它就不只是工具，而是你开发能力的放大器。

关系图谱

反向链接