
1. **终端命令**（运行 `codex` 时使用的命令行参数 / 子命令）
2. **Slash 命令**（在交互式 TUI 界面中输入 `/` 后出现的内置指令）

### 1. 终端命令行选项与子命令（codex [subcommand] [flags]）

| 命令 / 子命令          | 常用缩写 | 主要作用                              | 典型用法示例                              | 成熟度     |
|-------------------------|----------|---------------------------------------|--------------------------------------------|------------|
| `codex`                 | —        | 启动交互式 TUI（最常用）             | `codex` 或 `codex "修复这个 bug"`          | Stable    |
| `codex exec`            | `codex e`| 非交互式执行一次任务，输出到 stdout   | `codex exec "写一个 REST API"`             | Stable    |
| `codex exec resume`     | —        | 恢复之前的 exec 会话                  | `codex exec resume --last "继续优化"`      | Stable    |
| `codex resume`          | —        | 恢复之前的交互式会话                  | `codex resume --last`                      | Stable    |
| `codex fork`            | —        | 从已有会话 fork 新分支                | `codex fork --last`                        | Stable    |
| `codex login`           | —        | 登录（ChatGPT / API key）             | `codex login`                              | Stable    |
| `codex logout`          | —        | 退出登录                              | `codex logout`                             | Stable    |
| `codex features`        | —        | 管理功能开关（list/enable/disable）   | `codex features list`                      | Stable    |
| `codex completion`      | —        | 生成 shell 自动补全脚本               | `codex completion zsh`                     | Stable    |
| `codex apply`           | `codex a`| 应用 Cloud 任务生成的 diff            | `codex apply task_abc123`                  | Stable    |
| `codex cloud`           | —        | 操作 Codex Cloud 任务（实验性）     | `codex cloud "总结 bug"`                   | Experimental |
| `codex app`             | —        | 启动桌面应用（仅 macOS）              | `codex app`                                | Stable    |

**常用全局 Flags**（几乎所有命令都支持）

| Flag                    | 缩写 | 作用                                      | 示例                                 |
|-------------------------|------|-------------------------------------------|--------------------------------------|
| `--model`               | `-m` | 指定模型                                  | `--model gpt-5.4`                    |
| `--image`               | `-i` | 附加图片                                  | `-i error.png "解释这个报错"`        |
| `--cd`                  | `-C` | 指定工作目录                              | `--cd ./backend`                     |
| `--add-dir`             | —    | 额外授权读写目录（可多次）                | `--add-dir ../shared`                |
| `--sandbox`             | `-s` | 沙箱策略（read-only / workspace-write / danger-full-access） | `-s workspace-write` |
| `--ask-for-approval`    | `-a` | 审批策略（untrusted / on-request / never）| `-a never`                           |
| `--full-auto`           | —    | 低摩擦自动模式（相当于 -a on-request + workspace-write） | `--full-auto` |
| `--config` / `-c`       | `-c` | 覆盖配置（key=value）                     | `-c web_search=live`                 |
| `--search`              | —    | 强制使用实时联网搜索                      | `--search`                           |
| `--dangerously-bypass-approvals-and-sandbox` | `--yolo` | 完全关闭审批和沙箱（极度危险） | `--yolo` |
| `--oss`                 | —    | 使用本地开源模型（需 Ollama）             | `--oss`                              |

### 2. 交互界面内的 Slash 命令（输入 / 后选择）

| Slash 命令          | 主要作用                              | 常用场景                                   |
|---------------------|---------------------------------------|--------------------------------------------|
| `/model`            | 切换模型 + 推理强度                   | 想用更强的模型或更快的模型时               |
| `/sandbox-add-read-dir` | 临时增加沙箱可读目录（Windows 常用） | 需要访问系统目录时                         |
| `/agent`            | 切换 / 查看子 agent 线程              | 多线程并行工作时                           |
| `/clear`            | 清屏 + 新建对话                       | 想从干净状态重新开始                       |
| `/compact`          | 压缩历史对话，节省 token              | 会话很长、快超上下文时                     |
| `/diff`             | 显示当前所有代码变更（含 untracked）  | 提交前 review 改动                         |
| `/exit` / `/quit`   | 退出 Codex CLI                        | 工作完成                                   |
| `/experimental`     | 切换实验性功能开关                  | 想试用新特性                               |
| `/init`             | 在项目中生成 AGENTS.md 模板           | 给仓库添加持久化指令                       |
| `/mention`          | 手动添加文件/文件夹到上下文           | 想让 Codex 特别关注某个文件                |
| `/plan`             | 切换到只规划不执行模式                | 先要完整方案再动手                         |
| `/personality`      | 切换回答风格（friendly / pragmatic / none） | 想要更友好或更直接的语气               |
| `/review`           | 让 Codex review 当前工作区代码        | 改完代码想让它再检查一遍                   |
| `/status`           | 显示当前会话配置、token 使用情况      | 排查问题 / 查看剩余上下文                  |
| `/fork`             | 当前对话 fork 新分支                  | 想尝试不同方案但保留原路线                 |
| `/resume`           | 恢复历史会话                          | 继续昨天的工作                             |
| `/new`              | 在当前 CLI 内新建一个对话             | 不退出程序，但换个新话题                   |

这些是目前（2026 年 3 月）官方文档中最新的主要命令集合。实际可用命令和 flag 可能因你的版本略有差异，建议运行以下命令查看本地最新帮助：

```bash
codex --help
codex exec --help
codex features list    # 查看可开关实验功能
```

