步步图解

AI 工具

Codex 入门：在终端里用上 OpenAI 的编程 Agent

安装 Codex CLI，登录后在项目里完成第一个任务，再用 AGENTS.md 写好项目规则。

Codex 是 OpenAI 的编程 Agent，可以在终端里读代码、改文件和运行命令。套餐要求和支持地区以 官方文档 为准。

STEP 01 / 05

安装 Codex CLI

macOS 或 Linux 用户在终端里运行官方安装脚本。以后更新也用同一条命令：

Terminal
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows、npm 和 Homebrew 的安装方式，请查看 Codex CLI 文档。

STEP 02 / 05

登录

先进入一个项目文件夹，再启动 Codex：

Terminal
cd my-project
codex

第一次运行时选择 Sign in with ChatGPT，或其他可用的登录方式，然后按提示完成授权。

STEP 03 / 05

完成第一个任务

开始前先建一个 Git 存档，方便撤回：

Terminal
git init
git add .
git commit -m "开始前的存档"

然后在 Codex 里描述任务。可以先让它读项目，不做修改：

提示词
先阅读这个项目，用 5 句话告诉我它是做什么的、怎么运行。暂时不要修改文件。

确认它理解正确后，再提一个小修改。完成后用 git diff 检查结果。

STEP 04 / 05

查看权限

在 Codex 里输入：

Codex
/permissions

这里可以看到当前的沙箱设置和可写目录，也能调整 Codex 什么时候可以不经询问就修改文件或运行命令。新手建议保持需要确认的设置。

STEP 05 / 05

用 AGENTS.md 写项目规则

AGENTS.md 相当于 Codex 的项目说明书，它会在启动时读取。在 Codex 里输入 /init 可以生成一份，也可以手写：

AGENTS.md
# 项目规则

- 运行：npm run dev
- 构建：npm run build
- 修改后必须确认构建通过
- 不引入新依赖，除非先询问

放在不同位置，作用范围不同：

  • ~/.codex/AGENTS.md：个人全局规则
  • 项目根目录：整个项目生效
  • 子目录：越靠近当前目录的规则越优先

资料来源