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)
进入你的项目目录，运行：
bash
codex
> /init这会生成 AGENTS.md。请编辑这个文件，告诉 Codex："本项目使用 Next.js 14 App Router，样式使用 Tailwind，禁止使用 any 类型。"
2. 权限控制 (The Approvals System)
Codex 默认处于 建议模式 (Auto/Suggested)。
- 读取文件：自动执行。
- 修改文件/运行命令 ：它会生成计划，需要你按 Enter 确认。
如果你正在进行大规模重构，不想一直按 Enter，可以输入：
bash
> /approvals
# 选择 Full Access (慎用，它将拥有完全的终端控制权)3. 自定义命令 (Custom Slash Commands) ------ 杀手级功能
Codex 允许你编写自己的 Slash 命令。你只需要创建一个 Markdown 文件。
- 原理 ：将 Markdown 文件放在
~/.codex/prompts/目录下。 - 示例 ：创建一个
~/.codex/prompts/security-audit.md文件，内容如下：
markdown
# 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 独有的自动化工作流。需要我提供一个自定义命令的模板代码吗？