【慕伏白】Codex 使用建议

OpenAI 官方开发文档

1 如何安装 Codex CLI

OpenAI 官方 quickstart 和 CLI 页面给出的安装方法主要是两种：

1. 用 npm 安装

npminstall-g@openai/codex

2. 用 Homebrew 安装

brewinstallcodex

这两条命令都来自官方文档。
官方还说明了 Codex CLI 支持 macOS、Windows 和 Linux。

如果是 Windows 用户，电脑已经装好了 Node.js，通常走 npm 这条最容易。

2 安装完成后，怎么启动 Codex

安装完之后，在你的项目目录里打开终端，运行：

codex

官方 quickstart 写得很明确：运行 codex 后，你会被提示登录，可以使用 ChatGPT account 或 API key 登录。

3 Codex 登录后，默认能做什么

官方文档说，Codex 默认以 Agent mode 启动。
这个模式下，它可以：

1. 读取文件
2. 运行命令
3. 在你的项目目录里写入改动

4 为什么 Codex 每执行一步都问我一次

会看到类似这样的提示：

准备执行 Get-ChildItem
是否执行

选了 Yes 之后，它下一步又继续问。

这通常不是出错，而是 Codex 的安全确认机制。因为它能够读写文件、运行命令，所以默认比较谨慎。官方文档虽然强调了 Agent mode 能运行命令和写文件，但实际使用中，不同界面或不同策略下，会对一些操作要求确认。

简单说就是：

它怕“替你乱动项目”，所以默认会保守一些。

如果不想一直确认，想让它自己工作，怎么办，可以分三种层级操作。

1. 局部放行

如果界面里给你类似：

Yes, proceed Yes, and don’t ask againforcommands that start with … No…

那第二项通常就是“对这一类命令不再反复询问”。
这适合先试水，不至于一步一确认。这个属于使用策略层面，不是官方帮助页里固定写死的安装步骤，但符合 Codex 的交互逻辑。其前提仍然是：Codex 具有运行命令和写文件的能力。

2. 在任务里明确授权范围

直接对 Codex 说：

你可以在当前项目目录内自行读取文件、运行必要的只读命令，并在完成前尽量不要每一步都询问我。

再进一步，你可以说：

请只修改 auth 相关文件；允许你运行测试、lint 和类型检查；不要修改无关目录。

这种写法很有效，因为它既给了自由度，又给了边界。

3. 用更适合代理工作的界面

OpenAI 的 Codex app 和 Codex cloud 方向，本来就是为“让代理持续处理任务”设计的。官方对 Codex web/cloud 的描述是，它可以在自己的云环境中处理任务，甚至并行处理。

不过如果你现在是刚上手，本地 CLI 已经足够。
建议先把“授权范围 + 小任务 + Git 备份”这套习惯建立起来。

5 小白第一次使用 Codex，最推荐的完整流程

第一步：准备一个项目目录
先新建一个简单项目，或者找一个你已有的小项目。
例如一个 Python 小工具、一个前端页面、一个 Node 服务都可以。

第二步：进入项目目录

cd你的项目目录

第三步：启动 Codex

codex

第四步：用 ChatGPT 账号登录
按提示完成登录。官方支持使用 ChatGPT 账号或 API key 登录。

第五步：别一上来就让它重构整个项目
第一次任务最好这样发：

请先阅读当前仓库，并告诉我：1. 这个项目是做什么的2. 入口文件在哪里3. 如何安装依赖4. 如何运行5. 当前最值得优先修复的3个问题

这样做的好处是，它会先建立对项目的理解。
官方文档强调 Codex 可以理解陌生代码库和在当前目录工作，这种任务正好发挥它的优势。

第六步：再给它一个小而明确的任务
比如：

请帮我新增一个 /health 接口。 要求：1. 返回{"status":"ok"}2. 不要改动无关文件3. 改完后告诉我改了哪些文件4. 给我本地验证步骤

第七步：最后让它验证
比如：

请运行测试。 如果没有测试，请运行项目并告诉我怎么手动验证。

这个流程是最适合新手的：
先理解，再小改，再验证。

6 几个高质量提示词模板

下面这些是实际很好用的。

模板 1：让它先看懂项目

请先扫描当前代码仓库，然后输出：1. 项目用途2. 技术栈3. 目录结构4. 启动方法5. 潜在风险 不要立刻改代码。

模板 2：小范围修 bug

请修复登录失败的问题。 要求：1. 只改 auth 相关文件2. 不要重构无关代码3. 改完后说明原因4. 运行测试或给出验证步骤

模板 3：给它授权但设边界

你可以自行读取文件、运行必要命令并修改代码。 限制：1. 只在当前项目目录内操作2. 不安装新的大型依赖3. 不删除重要文件4. 所有改动完成后给我总结

模板 4：让它适合初学者

请按初学者能看懂的方式工作：1. 每次修改后解释原因2. 尽量少改动3. 多用注释4. 告诉我下一步该做什么

7 为什么我建议你从小任务开始，而不是“让它全自动重构一切”

因为 Codex 再强，它也是在代理式地理解你的工程。
如果你一上来就说：

“帮我把整个项目重构优化并修好所有 bug。”

它很可能会：

1. 改动范围过大
2. 引入你没预料的问题
3. 让你很难看懂改了什么。

而如果你把任务拆成：

1. 先理解项目
2. 再修登录
3. 再补测试
4. 再做接口
5. 再整理 README

你会更容易掌控。
这也更符合 Codex 官方“在项目中完成具体开发任务”的使用方式。

8 每次让 Codex 工作前，最好先做一件事：Git 备份

这是经验，不是花架子。

先在项目里执行：

gitinitgitadd.gitcommit-m"before codex"

如果你的项目本来就有 Git，那至少先 commit 一次当前状态。
因为 Codex 能写文件、改代码、运行命令，出了问题你可以随时回退。官方文档已明确它具备这些能力。

原文链接：https://blog.csdn.net/zhezhebie/article/details/159288473