Codex CLI 入门教程

Codex CLI 让你在终端里围绕本地项目与 Codex 协作。命令、安装方式和登录流程可能更新，安装前请以 OpenAI 当前官方文档为准。

开始前准备

• 确认已安装项目需要的 Git、Node.js 或其他运行环境。
• 从可信来源安装 Codex CLI，并使用自己的账户登录。
• 打开正确项目目录，不要在整个用户目录或系统目录中启动。
• 先运行 git status，知道当前有哪些未提交修改。

启动与提出第一个任务

在项目目录中启动 Codex 后，先给一个范围清楚的小任务：

先读取项目说明和 package.json，不要修改文件。
告诉我首页标题在哪个文件，以及修改后应该运行哪些检查。

确认理解正确后，再授权修改：

把首页标题改为“示例项目”，只修改必要文件。
完成后运行现有检查，并汇报 git diff。

每次任务都要检查什么

1. 它读了什么：是否在正确项目和目录。
2. 它改了什么：用 git diff 查看实际变化。
3. 它运行了什么：注意安装、删除、网络和部署命令。
4. 它验证了什么：测试通过不代表所有需求都满足。

写好 Codex 指令

说明目标、范围、禁止事项和验收方式。例如：“复用现有组件；不要更换框架；不修改 .env；完成后运行 npm run check 和 npm run build。”

安全边界

不要把 API Key、密码或私钥直接发进对话。不要让 Codex 为解决普通代码问题修改系统权限、防火墙或注册表。遇到超出项目范围的权限请求，先停下来核对原因。

官方参考

• OpenAI Codex 学习中心