Codex CLI 42个命令完全指南：从入门到精准指挥AI编程

前言

OpenAI 的 Codex CLI 是一款功能丰富的命令行 AI 编程助手，但不少开发者只停留在简单对话阶段，远没有挖掘出它的全部能力。Codex CLI 实际内置了 42 个命令，覆盖模型切换、会话管理、代码审查、上下文控制等多个维度。熟练运用这些命令，能让你的开发效率产生质的飞跃。

本文将按功能分类，逐一拆解这 42 个 Codex CLI 命令的用途和适用场景，帮你从「低效对话」升级为「精准指挥」。

模型与配置相关命令

/model — 快速切换模型

输入 /model 后会弹出可选模型列表，选择后后续对话和代码操作都会使用新模型。日常改代码可以用响应更快的模型，遇到复杂架构分析或疑难 bug 时再切换到推理能力更强的模型。

OpenAI 提供多个不同规格的模型（如 GPT-4o、o3、o4-mini 等），它们在推理能力、响应速度和 Token 消耗之间存在权衡。较大的模型（如 o3）具备更强的多步推理和代码架构分析能力，但响应延迟更高、成本更大；较小的模型（如 o4-mini）响应迅速，适合简单的代码补全和文件操作。Codex CLI 的模型切换机制允许开发者在同一会话中根据任务复杂度动态调整，避免为简单任务支付不必要的算力成本。

/fast — 1.5 倍速响应

该命令将当前会话切换到速度优先模式，适合处理简单修改、查文件、跑命令等低风险任务。核心目的是缩短等待时间，让 Codex 更快给出结果。再次输入 /fast 可切回标准速度。需要留意的是，快速模式大约会消耗两倍 Token。

这里涉及到 Token 的概念：Token 是大语言模型处理文本的基本单位，一个英文单词通常对应 1-3 个 Token，中文字符通常每个字对应 1-2 个 Token。快速模式可能通过并行生成、减少内部推理链（Chain-of-Thought）步骤或使用更轻量的模型来加速响应，但这种加速往往以增加 Token 消耗为代价——例如通过多次短请求替代单次长推理，或牺牲部分压缩效率换取速度。

/personality — 调整沟通风格

提供两种风格选择：

• Friendly：更像耐心的协作伙伴，语气轻松，适合学习和头脑风暴
• Paradigmatic：更像资深工程师，回答直接，侧重结论和风险提示，适合修 bug、做工程决策

需要强调的是，Personality 不会改变模型能力或权限，只调整沟通方式。

/experimental — 实验性功能开关

这些开关会保存到配置文件中，包括：

• Terminal Resize Reflow：终端宽度变化时重排聊天记录
• Memories：允许 Codex 从对话中建立记忆，并在新会话中带入
• Prevent Sleep While Running：任务运行时防止电脑休眠

权限与安全相关命令

/permission — 操作权限设置

Codex CLI 的权限系统本质上是一个沙箱（Sandbox）机制，灵感来源于操作系统的权限管理和容器化技术。这种分层安全模型遵循「最小权限原则」（Principle of Least Privilege），确保 AI 代理在执行任务时不会意外修改系统关键文件或发起未授权的网络请求。

提供三个安全级别：

模式	文件访问	网络访问	适用场景
Default	Workspace 内可读写	需审批	日常写代码、修 bug
Auto Review	Workspace 内可读写	需审批（自动审查优先）	减少手动确认
Full Access	无限制	无限制	明确信任的高权限任务

Default 模式将文件操作限制在工作区（Workspace）内，类似于 Docker 容器的挂载卷限制；网络访问需要审批则类似于防火墙的出站规则。Full Access 风险最大，因为它可以直接影响系统环境和用户目录，只有在明确知道任务需要这些权限时再开启。

/approve — 批准被拒绝的操作

当 Auto Review 子代理拒绝了某个操作后，可以通过 /approve 手动批准执行。

会话管理相关命令

这组命令是 Codex CLI 的核心竞争力之一，提供了类似 Git 分支的会话管理能力。

Git 的分支模型允许开发者从同一个代码快照出发，探索不同的实现路径而互不干扰。Codex CLI 的会话管理借鉴了这一理念：每个会话包含完整的对话历史、上下文窗口状态和工具调用记录。Fork 操作相当于 git branch，创建一个独立的上下文副本；Resume 相当于 git checkout，切换回之前的工作状态。这种设计解决了 AI 编程助手中常见的「上下文污染」问题——当你想尝试不同方案时，不必担心破坏已有的对话进展。

/new — 开启新会话

清空当前上下文，重新开始新任务。不会退出 Codex，也不会切换项目目录。适合完成一个任务后，开始一个完全不相关的新任务。

/resume — 恢复历史会话

从历史会话中选择一条，沿着之前的上下文继续工作。比如昨天分析过一个项目，今天接着干就不需要重新给 Codex 讲背景。

/fork — 分支会话

把当前会话复制出一份新的分支，保留所有上下文，后续修改互不影响。典型场景：当前方案用 React 实现，想试试 Vue，Fork 出新会话大胆尝试，原会话保持不变。

/side — 临时旁路对话

开启一个临时对话处理小问题，不打断主任务。比如 Codex 正在改代码，你想顺手问一句报错含义，用 /side 问完切回主会话即可。

/rename — 重命名会话

当历史会话越来越多时，通过 /rename 给会话起一个有意义的名字，方便后续通过 /resume 快速找回。

/agent — 切换活跃代理

在多代理协作场景下，切换到不同的子代理查看各自任务进展或继续对话。

/subagents — 子代理管理

当任务复杂时，可以将工作拆分给多个子代理。例如一个子代理分析代码结构，一个负责测试，主代理做最终汇总。

多代理（Multi-Agent）是当前 AI 系统设计的重要范式，源自分布式系统中的「关注点分离」原则。在 Codex CLI 中，主代理负责任务编排和最终决策，子代理各自承担专项职责（如代码编写、测试执行、代码审查）。这种架构的优势在于：每个子代理可以维护独立的上下文窗口，专注于自己的任务域，避免单一超长上下文导致的注意力稀释问题。同时，子代理之间通过主代理协调，实现类似微服务架构中的松耦合协作。

/goal — 设置持续目标

不同于普通的一问一答，/goal 让 Codex 围绕一个目标持续工作直到完成。例如设置「把项目跑起来，修复启动错误，确保测试通过」，Codex 会自主推进直到 Token 用完或任务完成。

实战案例：多代理协作开发博客

将上述会话命令串联起来，看一个完整的 Codex CLI 多代理协作工作流：

1. /new — 开启干净的上下文
2. /rename — 命名为「Vue 个人博客」
3. /permission — 选择 Auto Review 模式
4. /goal — 设置目标，启动三个子代理（CodeWrite、TestRunner、CodeReview）协作完成
5. /agent — 在子代理间切换查看进度
6. /fast — 需要加速时切换 1.5 倍速

这套流程让 Codex CLI 从单线程对话变成了多线程协作，开发效率大幅提升。

代码与工作区相关命令

/init — 创建项目说明书

生成 agents.md 文件，包含项目结构、构建规范、测试流程、PR 规范等。以后 Codex 进入项目会优先参考这份文件，不需要反复解释项目约定。

agents.md 是 Codex CLI 的项目级配置文件，类似于 .editorconfig 或 .eslintrc 在各自领域的作用——它为 AI 助手提供项目特定的规范和约束。这个文件通常包含：项目的目录结构说明、首选的编码风格、构建和测试命令、PR 提交规范等。当 Codex 进入一个项目目录时，会自动读取该文件作为系统级上下文，确保生成的代码符合团队约定，减少因风格不一致导致的返工。

/plan — 规划模式

切换到 Plan 模式后，Codex 会先拆解任务、提出问题，确认后才开始写代码。适合复杂任务，可通过 Shift+Tab 快速开关。

/mention — 指定文件引入

将指定文件或目录带入当前会话上下文。不用手动复制代码，直接让 Codex 聚焦到特定文件进行分析或修改。

/skills — 技能管理

查看和启用本地技能，如浏览器调试、Figma 设计稿读取等，为 Codex 扩展更专业的工作能力。

/diff — 查看改动

展示当前工作区发生了哪些文件改动。在运行或提交之前，先用 /diff 确认 Codex 做了什么修改，避免意外变更。

/review — 代码审查

提供四种审查模式：PR 审查、未提交改动审查、特定 Commit 审查、自定义审查。

推荐工作流顺序：/init → /skills → /plan → /mention → /diff → /review

上下文记忆相关命令

/ide — 编辑器上下文同步

将 IDE 中选中的代码或当前文件上下文直接带入 CLI，免去手动复制粘贴。在局部 bug 调试时尤其好用。

/compact — 压缩上下文

当对话过长时，将当前上下文总结压缩成更精炼的版本，保留关键决策信息。可以有效减少幻觉，适合长任务中途使用。

大语言模型的上下文窗口（Context Window）是指模型单次能处理的最大 Token 数量。即使是最新的模型，上下文窗口也是有限的（通常为 128K-200K Token）。当对话过长时，早期的信息可能被截断或「遗忘」，导致模型产生幻觉（Hallucination）——即生成与之前讨论不一致的内容。/compact 命令通过对已有对话进行摘要压缩，将冗长的讨论浓缩为关键决策点和结论，既保留了重要信息，又释放了上下文空间供后续使用。

/memorize — 跨会话记忆管理

控制 Codex 是否读取已有记忆、是否从当前会话中生成新记忆，以及重置记忆。实现跨会话的长期上下文保持。

状态与调试相关命令

• /state — 查看当前会话状态，包括模型、目录、权限、会话 ID、上下文使用率等关键信息
• /statusline — 配置底部状态栏的显示内容
• /title — 配置终端标题页显示
• /ps — 查看后台运行的终端任务
• /stop — 停止后台任务

工具与扩展相关命令

• /mcp — 管理 MCP 服务（如 ChromeDevTools、Figma、Computer User 等）

MCP（Model Context Protocol）是一种标准化协议，用于将外部工具和服务连接到 AI 模型。它定义了工具描述、调用接口和结果返回的统一格式，使得 Codex CLI 可以像调用本地函数一样使用浏览器调试工具、设计软件 API 或系统级操作。这种插件化架构借鉴了 LSP（Language Server Protocol）的设计思想——通过标准协议解耦工具实现和 AI 调用逻辑，使得第三方开发者可以轻松为 Codex 扩展新能力。

• /hooks — 查看和管理生命周期钩子（如任务完成后播放提示音）
• /plugin — 查看和管理已安装插件
• /keymap — 更改快捷键配置

界面显示相关命令

• /theme — 选择代码高亮主题
• /vim — 切换 Vim 输入模式
• /raw — 切换原始滚动模式，方便复制内容
• /copy — 复制 Codex 最后一条完整回复

日常开发必记命令速查

不需要死记硬背全部 42 个命令，按场景记住以下几组就够了：

场景	推荐命令
权限管理	/permission
会话管理	/new、/resume、/fork
任务推进	/plan、/goal
上下文管理	/mention、/ide、/compact
代码检查	/diff、/review
状态监控	/state、/ps

掌握这些命令的核心逻辑，你就能从「和 AI 聊天写代码」升级为「精准指挥 AI 工程团队」，真正释放 Codex CLI 的全部潜力。