OpenAI Codex CLI 使用文档 (2025 最新版)

Codex CLI 是 OpenAI 推出的开源终端编码 Agent，采用 Rust 编写，主打高性能、低延迟和高度可配置性。与 Claude Code 类似，它能直接操作你的文件系统、运行命令并协助编程，但它更强调开发者的控制权和自定义能力。

一、 Slash Commands (斜杠命令大全)

Codex CLI 的命令体系非常丰富，主要分为以下四类：

1. 会话与流程控制 (Session Flow)

命令	功能说明	典型场景
/new	新建会话。在不退出 CLI 的情况下开启一段新对话。	当上一个任务结束，想开始毫无关联的新任务时。
/undo	撤销上一步。回滚 Codex 的上一次回复或操作。	当 Codex 改错代码或理解错意时，快速回退。
/exit / /quit	退出程序。结束当前 CLI 进程。	下班或切换项目时。
/logout	登出账号。清除本地认证信息。	切换 OpenAI 账号时。

2. 配置与权限 (Configuration & Safety)

这是 Codex 与 Claude Code 最大的不同点之一，提供了更细粒度的控制。

命令	功能说明	典型场景
/approvals	设置权限模式。控制 Codex 执行命令是否需要你批准。支持 Auto (默认/建议), Read Only (只读), Full Access (全自动)。	想让它自动跑脚本时开 Full Access；调试敏感库时开 Read Only。
/model	切换模型。选择使用的 GPT 模型（如 gpt-4o, o1-preview 等）及推理等级。	简单任务用 mini 模型省钱，复杂架构设计用 o1 模型。
/status	查看状态。显示当前 Token 使用量、剩余上下文空间、权限模式等。	检查是否快要超出上下文限制。
/mcp	管理 MCP 工具。查看已连接的 Model Context Protocol 服务器。	调试外部工具连接（如数据库、浏览器）。

3. 上下文与记忆 (Context & Memory)

命令	功能说明	典型场景
/init	初始化项目。在当前目录生成 AGENTS.md 文件（类似于 CLAUDE.md）。	项目必做。在此文件中写入项目的技术栈、代码规范，Codex 会永久记住。
/compact	压缩历史。总结当前对话，释放 Token。	对话过长导致变慢时使用。
/mention	提及文件。显式地将某个文件或文件夹加入上下文。	当 Codex 找不到文件，或者你想让它专注于特定模块时。
/diff	查看变更。显示 Git Diff（包含未追踪文件）。	在提交代码前，最后检查一遍 Codex 到底改了什么。

4. 动作与高级功能 (Actions & Advanced)

命令	功能说明	典型场景
/review	代码审查。让 Codex 审查当前的工作区更改。	写完代码后，让 AI 充当同事帮你 Review。
/skills	浏览技能。浏览和插入实验性的技能（Experimental）。	探索新功能。

---

二、 详细使用指南

1. 初始化项目 (Setup)

进入你的项目目录，运行：

codex
> /init

这会生成 AGENTS.md。请编辑这个文件，告诉 Codex：“本项目使用 Next.js 14 App Router，样式使用 Tailwind，禁止使用 any 类型。”

2. 权限控制 (The Approvals System)

Codex 默认处于 建议模式 (Auto/Suggested)。

• 读取文件：自动执行。
• 修改文件/运行命令：它会生成计划，需要你按 Enter 确认。

如果你正在进行大规模重构，不想一直按 Enter，可以输入：

> /approvals
# 选择 Full Access (慎用，它将拥有完全的终端控制权)

3. 自定义命令 (Custom Slash Commands) —— 杀手级功能

Codex 允许你编写自己的 Slash 命令。你只需要创建一个 Markdown 文件。

• 原理：将 Markdown 文件放在 ~/.codex/prompts/ 目录下。
• 示例：创建一个 ~/.codex/prompts/security-audit.md 文件，内容如下：

# Security Audit
请扫描当前代码库，查找以下漏洞：
1. SQL 注入
2. 硬编码的密钥
3. XSS 漏洞
并生成一份 Markdown 报告。

• 使用：重启 Codex 后，直接在对话框输入 /security-audit，它就会自动执行这一套流程！这比每次重复输入 Prompt 效率高得多。

---

三、 Codex CLI vs Claude Code：详细区别

这两个工具是目前市场上最强的两个终端 Agent，选择哪一个取决于你的需求。

维度	OpenAI Codex CLI	Anthropic Claude Code
底层技术	Rust (速度极快，资源占用低)	Node.js (生态兼容性好)
开源属性	开源 (Apache 2.0)	闭源 (Proprietary)
核心哲学	精细控制：强调用户对 AI 行为的约束 (/approvals) 和自定义能力。	深度推理：强调 AI 的自主思考，像一个高级工程师全面接管项目。
自定义扩展	极强：支持通过 Markdown 文件自定义 Slash 命令 (/my-cmd)。	较弱：主要依赖 CLAUDE.md 被动提示，无自定义命令功能。
记忆文件	AGENTS.md	CLAUDE.md
适用人群	极客/架构师：喜欢折腾配置、需要自定义工作流、看重开源。	业务开发者：需要 AI 快速理解复杂业务逻辑，即开即用。

💡 总结建议：

• 如果你喜欢自己定义工作流（比如定义一个 /fix-bug 命令自动跑测试、修bug、提交），选 Codex CLI。
• 如果你面对的是一个巨型屎山代码，需要 AI 拥有极强的上下文长窗口推理能力来帮你理清头绪，选 Claude Code。

下一步建议：
您可以尝试在您的 ~/.codex/prompts/ 目录下创建一个简单的 daily-report.md 自定义命令，体验一下 Codex 独有的自动化工作流。需要我提供一个自定义命令的模板代码吗？