# 从会用到好用 | Codex 命令新手手册：小白可直接上手的基础命令汇总

> 作者：芯智荟
> 发布时间：2026年5月28日 19:12
> 原始链接：https://mp.weixin.qq.com/s/xaT3wk3sYZfjE2QiRkPKGg

> 这份手册专为 Codex 新手设计，用最直白的语言覆盖日常使用必备的基础命令。不需要死记硬背——先理解「Codex App / CLI / 交互式会话」的核心逻辑，再动手练习，遇到记不住的随时翻这份手册就行。
>
> 虽然部分时候在Codex中用自然语言提要求也可行，但命令有其准确性和简洁性的优势。
>
> 本手册基于 **codex-cli 0.134.0** 核对（2026 年 5 月），斜杠命令在桌面APP也可用。子命令与 flag 在不同版本可能略有差异，最权威的方式是 `codex --help` 或 `codex help <子命令>`。

* * *

## 目录

-   〇、写在前面：Codex 命令长什么样？

-   一、安装与基础配置

-   二、不同形态的启动与选择

-   三、CLI 核心基础命令

-   四、Slash Commands 斜杠命令（交互式必备）

-   五、运维与扩展命令

-   六、效率技巧

-   七、新手学习建议

-   附录：高频命令速查表

* * *

## 〇、写在前面：Codex 命令长什么样？

Codex CLI 命令的基本格式：

```
codex <subcommand> [-options] [parameter]
```

| 部分 | 含义 | 举例 |
| --- | --- | --- |
| ‎`codex` | 主命令（固定） | 所有 Codex 操作的入口 |
| ‎`subcommand` | 子命令（核心操作） | ‎`exec`、‎`login`、‎`resume`、‎`review` |
| ‎`-options` | 选项，控制命令行为 | ‎`-m`（指定模型）、‎`--last`（操作最近会话） |
| ‎`parameter` | 参数，命令操作的对象 | 任务描述、会话 ID、项目路径 |

**核心概念先理清（新手必懂）：**

| 形态 | 含义 | 通俗理解 |
| --- | --- | --- |
| Codex App | 桌面图形客户端 | 带界面的可视化工具，新手友好，不用记命令 |
| Codex CLI | 命令行工具 | 终端里的命令版本，适合习惯命令行的开发者，高效灵活 |
| 交互式 TUI | CLI 里的交互模式 | 进入后可以和 Codex 对话，类似 App 的聊天体验，支持斜杠命令 |
| 非交互 Exec | CLI 里的脚本模式 | 不用对话，直接执行任务，适合自动化、CI/CD 场景 |
| Slash Commands | 交互式会话的快捷命令 | TUI 里输入 ‎`/` 即可触发的内置命令 |

💡 **小技巧**：输入 `codex help <子命令>` 可查任意命令的帮助，比如 `codex help exec`、`codex help resume`，比搜索引擎更精准。

> 除了上述 CLI 命令，另外一类命令是 Slash Commands 也就是斜杠命令，直接在 Codex 界面中敲 `/` 然后带上命令即可。一般会有命令提示。
>
> 另外，虽然部分情况下，用自然语言描述，也可起到替代斜杠命令的作用，但是斜杠命令有其准确性和简洁性的优势，可以更快更放心的完成所想要完成的任务。

* * *

## 一、安装与基础配置

首次使用 Codex 必须先完成安装和登录，优先做这一步。

### 1.1 安装 Codex CLI

根据你的系统选择安装方式：

```
# 官方一键脚本（macOS / Linux，最新推荐）
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Windows PowerShell 一键脚本
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# 使用 npm 全局安装（全平台通用）
npm install -g @openai/codex

# 使用 Homebrew 安装（macOS / Linux 用户）
brew install --cask codex
```

> 三种方式都可以；一键脚本最省心，npm / brew 适合已经习惯包管理器的人。装好后用 `codex --version` 验证版本。

### 1.2 登录认证

安装完成后需要登录你的 OpenAI 账号：

```
# 浏览器 OAuth 登录（推荐，新手首选）
codex login

# 无浏览器环境（比如 SSH 服务器）用设备码登录
codex login --device-auth

# 自动化脚本用 API Key 登录（从环境变量读取，不留在 shell history）
printenv OPENAI_API_KEY | codex login --with-api-key

# 用预先签发的 access token 登录（CI / 服务器场景）
printenv CODEX_ACCESS_TOKEN | codex login --with-access-token
```

> 四种登录方式按"日常 → CI / 服务器"递进：图形环境直接 `codex login`；SSH / 无浏览器场景用 `--device-auth` 走设备码；脚本与流水线用 `--with-api-key` 或 `--with-access-token` 从 stdin 读取，避免凭据出现在命令行历史。

### 1.3 查看 / 管理登录状态

```
# 查看当前登录状态
codex login status

# 退出登录 / 切换账号
codex logout
```

* * *

## 二、不同形态的启动与选择

Codex 提供了多种使用形态，根据你的场景选择最合适的：

### 2.1 Codex App：新手首选的图形界面

如果你是刚接触 Codex 的小白，优先用桌面 App，不用记命令，可视化操作更友好：

```
# 启动 Codex 桌面应用（macOS / Windows / Linux，部分平台需先安装桌面客户端）
codex app

# 直接打开指定项目的 App 工作区
codex app /path/to/your-project
```

> 启动后你会看到熟悉的聊天界面，直接输入你的需求就行，比如"帮我写一个 Python 的排序算法"，也可以直接用斜杠命令。
>
> 注：`codex app` 的可用性取决于平台与版本。如果你的环境提示 unrecognized subcommand，请到 chatgpt.com/codex 下载桌面客户端或使用 IDE 插件（VS Code / Cursor / Windsurf）。Linux 服务器一般直接用 CLI 即可。

### 2.2 Codex CLI：终端党的高效选择

如果你习惯用终端工作，CLI 能让你不用切换窗口，直接在项目目录里调用 Codex：

```
# 直接启动交互式 TUI 会话，进入聊天模式
codex

# 带初始任务启动，省去输入步骤
codex "帮我梳理这个项目的代码结构"

# 附带图片启动，分析截图 / 设计稿
codex -i ui-screenshot.png "帮我看看这个页面有什么问题"

# 指定模型启动（默认走配置文件里的模型）
codex -m gpt-5 "重构这段函数"
```

💡 **小技巧**：个人新手入门先从 App 开始，熟悉后再尝试 CLI；团队开发、自动化任务优先用 CLI，效率更高。

* * *

## 三、CLI 核心基础命令

这是日常使用 CLI 最常用的命令，覆盖大部分场景。

### 3.1 非交互执行：自动化任务必备

如果你想把 Codex 接入脚本、CI/CD 流水线，用非交互的 `exec` 命令：

```
# 直接执行任务，输出结果到终端
codex exec "根据当前项目的变更，生成 PR 描述"

# 把最后一条消息写入文件，供后续脚本使用
codex exec -o result.txt "总结这个项目的所有功能"

# 从管道读取输入，和其他命令组合使用（用 - 表示从 stdin 读 prompt）
git diff | codex exec - "根据这些代码变更，写一个提交备注"

# 别名：codex exec 可以缩写为 codex e
codex e "跑一遍单元测试，把失败用例总结给我"
```

> `-o, --output-last-message <FILE>` 写出的是最后一条 assistant 消息；如果要结构化输出，可以配合 `--output-schema <FILE>` 用。

### 3.2 会话管理：继续之前的任务

Codex 会自动保存你的会话记录，随时可以恢复之前的对话：

```
# 列出所有历史会话，挑一个恢复（picker 交互式选择）
codex resume

# 直接恢复最近一次的会话，最常用
codex resume --last

# 跨目录恢复，比如你换了文件夹，也能找到之前的会话
codex resume --last --all

# 用会话 ID 精准恢复
codex resume <SESSION_ID>

# 基于之前的会话，分叉出一个新的对话，探索不同方向
codex fork --last
```

### 3.3 代码审查：直接给 PR / diff 找问题

`codex review` 是 0.134 顶层就有的子命令，非交互式跑一遍代码审查：

```
# 审查当前仓库未提交的变更
codex review

# 审查指定分支相对 main 的所有差异
codex review --base main --head feature-branch
```

也可以在交互式 TUI 里直接 `/review`（见第四章）。

### 3.4 云端任务：后台跑耗时任务

对于耗时比较久的任务，可以提交到 Codex Cloud 后台执行，不用一直开着终端：

```
# 提交云端任务，在后台执行（需要指定 env-id，先用 codex cloud 浏览）
codex cloud exec --env <ENV_ID> "帮我重构这个项目的所有模块"

# 查看云端任务列表
codex cloud list

# 查看具体任务状态
codex cloud status <TASK_ID>

# 看云端任务产生的 diff
codex cloud diff <TASK_ID>

# 把云端任务的结果拉到本地，应用代码改动
codex cloud apply <TASK_ID>
```

⚠️ **新手注意**：`codex cloud` 整个子命令在 0.134 仍标注为 **EXPERIMENTAL**，接口可能变。初期建议先从本地 `codex` / `codex exec` 任务开始熟悉。

> 区分两个 apply：`codex apply <TASK_ID>` 用于本地 agent 产生的最近 diff 重放；`codex cloud apply <TASK_ID>` 用于云端 task 结果落地。新手大概率只会碰到后者。

* * *

## 四、Slash Commands 斜杠命令（交互式必备）

在 Codex App 或 CLI 的交互式 TUI 里，输入 `/` 即可调出内置命令。下面是常用的几类。

> 💡 实际可用命令以你当前版本的 TUI 为准：进入会话后输入 `/help` 或直接打个 `/` 会出现自动补全列表。

### 4.1 会话管理：清理 / 恢复对话

```
/new          彻底结束当前对话，并创建一个全新的空白会话
/clear        仅清屏，保留当前会话的所有上下文
/compact      压缩对话上下文，释放 Token，避免对话太长失效
/resume       从历史记录里恢复之前的对话
/side         开一个临时支线对话，避免污染主任务
/fork         把当前对话分叉成新线程，探索不同方向
/quit         退出交互式会话（部分版本是 /exit）
```

💡 **小技巧**：和 Codex 聊了很久、提示上下文太长时，用 `/compact` 快速压缩，不必整段重开。有些命令是直接带上后续的提问/请求，比如 `/side 这个方案有没有明显风险` 。

### 4.2 工作模式与配置

```
/model        快速切换使用的模型（弹出选择列表）
/approval     调整命令执行的审批策略（自动 / 询问 / 只读）
/permissions  管理 Codex 可访问的资源权限（文件、网络、shell 等）
/plan         切换到计划模式，先让 Codex 出方案再动手，适合复杂任务
/fast on      开启快速模式（fast_mode），简化提示、加快响应
/fast off     关闭快速模式
/mention      用 @ 引用文件 / 路径 / app / 插件 / skill，注入到上下文
/status       查看当前会话的配置、模型、Token 用量
```

> 💡 `/fast` 可以在 TUI 用快捷键直接切换，通过在 keymap 里配置 `toggle_fast_mode` 这个快捷键。`/plan` 是很好用的命令，当需要做规划或者不确定怎么改时，就先用 `/plan`。

### 4.3 项目操作快捷功能

```
/init         自动生成 AGENTS.md 脚手架，给 Codex 配置项目规则
/diff         查看当前项目的 Git 变更（不用切窗口跑 git diff）
/review       一键审查当前的代码改动，找问题
/skills       浏览与启用预置 skill（代码审查、文档生成等可一键调用）
```

举例：你刚进项目，输入 `/init`，Codex 自动帮你生成项目级配置（`AGENTS.md`），后续它就能更懂你的项目规则；改完代码输入 `/review`，它会自动审一遍当前 diff；`/skills` 可以浏览你这台机器上已经装好的 skill 并启用。

* * *

## 五、运维与扩展命令

这一节是 0.134 版本里比较新、但日常用得着的几条。

### 5.1 自我诊断与升级

```
# 自检：本地安装、配置、登录、运行时环境
codex doctor

# 把 Codex CLI 升到最新版（避免手动跑 npm 或 brew）
codex update
```

`doctor` 在排查"为什么我登录不上""为什么 sandbox 拒绝执行"这类问题时很救命。

### 5.2 MCP 与插件

```
# 管理外部 MCP 服务器（Model Context Protocol，把外部能力挂进 Codex）
codex mcp list
codex mcp add <name> <command-or-url>
codex mcp remove <name>

# 让 Codex 自己作为 MCP server 启动（被其他 agent 调用时用）
codex mcp-server

# 插件管理（0.134 起新增的 plugin 子命令）
codex plugin list
codex plugin install <plugin-name>
```

> 具体 flag 以 `codex mcp --help`、`codex plugin --help` 为准——这两个子命令在快速迭代。

### 5.3 沙箱与 shell 补全

```
# 在 Codex 提供的沙箱里跑一条本地命令（与 agent 用同样的隔离规则）
codex sandbox -- ls /etc

# 生成 shell 补全脚本（bash / zsh / fish / powershell）
codex completion bash > ~/.codex-completion.bash
echo 'source ~/.codex-completion.bash' >> ~/.bashrc
```

* * *

## 六、效率技巧

### 6.1 交互式会话里的 Shell 快捷操作

在 CLI 的交互式 TUI 里，你不用退出会话就能执行本地命令：

```
!ls           查看当前目录的文件
!git status   查看 git 状态，不用切窗口
```

输入 `!` 加任意 shell 命令即可（前提是你的审批策略允许 shell 调用）。

### 6.2 键盘快捷键

交互式 TUI 里的常用快捷键，提升操作速度：

| 快捷键 | 作用 |
| --- | --- |
| ‎`Ctrl+C` | 中断当前任务 / 退出交互式会话 |
| ‎`Ctrl+L` | 清屏，保留对话历史 |
| ‎`Ctrl+O` | 复制最近的输出到剪贴板 |
| ‎`Ctrl+R` | 搜索你的输入历史 |
| ‎`Up/Down` | 浏览之前的输入草稿 |

### 6.3 常用命令组合

这些组合能帮你快速搞定常见场景：

```
# 快速恢复上次的对话，接着干活
codex resume --last

# 带任务快速启动，不用进会话再输入
codex "帮我修复这个项目的单元测试"

# 分析截图，找 UI 问题
codex -i bug.png "帮我看看这个报错是什么问题"

# 生成 PR 描述，直接用 git diff 的结果
git diff | codex exec - "帮我写 PR 的描述"

# 跑一遍当前 PR 的代码审查
codex review
```

### 6.4 用配置覆盖灵活定制

`-c` flag 可以临时覆盖 `~/.codex/config.toml` 的任意配置（用点号路径），不必改文件：

```
# 临时切到 o3 模型跑一条任务
codex -c model="gpt-5.4-mini" "帮我设计一下 schema"

# 临时调宽 sandbox 权限
codex -c 'sandbox_permissions=["disk-full-read-access"]' "找一下这个仓库里的硬编码密钥"
```

* * *

## 七、新手学习建议

1.  ‎**先抓核心流程**：优先掌握「安装登录 → 启动 App/CLI → 基础对话 → 常用斜杠命令」，覆盖 90% 日常使用场景。

2.  ‎**理解形态区别**：先从 App 入门，不用一开始就记 CLI 命令；熟悉后再尝试 CLI，循序渐进。

3.  ‎**动手比背诵重要**：找个小项目，反复试 ‎`/init`、‎`/plan`、‎`codex resume` 这些命令，甚至故意试不同的任务，犯错才是最快的学习方式。

4.  ‎**善用帮助命令**：记不住参数就输 ‎`codex help <子命令>` 或 ‎`codex <子命令> --help`，Codex 自带的帮助文档比碎片化教程更权威。

5.  ‎**遇到问题先 doctor**：登录异常、sandbox 拒绝、网络不通时，先跑 ‎`codex doctor` 看自检报告。

6.  ‎**从简单场景开始**：先用来写小脚本、改 bug，再尝试复杂的重构、文档生成，不要一开始就搞大项目。

7.  ‎**不要怕出错**：Codex 的操作大部分都能撤销，会话记录也都能恢复，大胆试错就好。

* * *

## 附录：高频命令速查表

| 分类 | 命令 | 用途 |
| --- | --- | --- |
| ‎**安装配置** | ‎`curl -fsSL https://chatgpt.com/codex/install.sh \| sh` | 官方一键脚本（macOS / Linux） |
|  | ‎`npm install -g @openai/codex` | npm 全局安装 |
|  | ‎`brew install --cask codex` | Homebrew 安装 |
|  | ‎`codex login` | OAuth 浏览器登录 |
|  | ‎`codex login status` | 查看登录状态 |
|  | ‎`codex logout` | 退出登录 |
| ‎**启动方式** | ‎`codex app` | 启动桌面 App（视平台与版本而定） |
|  | ‎`codex` | 启动 CLI 交互式 TUI |
|  | ‎`codex "任务描述"` | 带任务启动会话 |
|  | ‎`codex -i img.png "..."` | 带图片启动 |
|  | ‎`codex -m <model> "..."` | 指定模型启动 |
| ‎**CLI 核心** | ‎`codex exec "任务"` | 非交互执行任务 |
|  | ‎`codex exec -o file.txt "..."` | 把最后一条消息写入文件 |
|  | ‎`codex resume --last` | 恢复最近会话 |
|  | ‎`codex resume --last --all` | 跨目录恢复 |
|  | ‎`codex fork --last` | 分叉当前会话 |
|  | ‎`codex review` | 非交互式代码审查 |
| ‎**云端任务** | ‎`codex cloud exec --env <ID> "..."` | 提交云端任务（实验性） |
|  | ‎`codex cloud list` | 列出云端任务 |
|  | ‎`codex cloud apply <TASK_ID>` | 应用云端任务结果 |
| ‎**斜杠命令** | ‎`/new` | 开启新会话 |
|  | ‎`/compact` | 压缩上下文 |
|  | ‎`/model` | 切换模型 |
|  | ‎`/approval` | 调整审批策略 |
|  | ‎`/permissions` | 管理资源访问权限 |
|  | ‎`/side` | 开临时支线对话 |
|  | ‎`/plan` | 切换到计划模式 |
|  | ‎`/fast on` / ‎`/fast off` | 切换快速模式 |
|  | ‎`/mention` | @ 引用文件 / 插件 / skill |
|  | ‎`/init` | 初始化项目配置 (‎`AGENTS.md`) |
|  | ‎`/diff` | 查看 Git 变更 |
|  | ‎`/review` | 审查代码改动 |
|  | ‎`/skills` | 浏览与启用预置 skill |
| ‎**运维扩展** | ‎`codex doctor` | 自检本地环境 |
|  | ‎`codex update` | 升级 CLI |
|  | ‎`codex mcp list` | 列出 MCP server |
|  | ‎`codex plugin list` | 列出已装插件 |
|  | ‎`codex sandbox -- <cmd>` | 在沙箱里跑命令 |
|  | ‎`codex completion bash` | 生成 shell 补全 |
| ‎**效率操作** | ‎`!<shell命令>` | 会话内执行本地命令 |
|  | ‎`git diff \| codex exec - "..."` | 快速生成 PR 内容 |
|  | ‎`codex -c key=value "..."` | 临时覆盖配置 |

* * *

> 本文专为 Codex 新手打造，聚焦"能用、好用、够日常"的基础命令，避开复杂的底层原理和进阶用法。收藏起来，使用时边查边练，一周就能熟练掌握 Codex 核心操作。
>
> 本手册基于 codex-cli 0.134.0 核对，斜杠命令在 Codex App 也可用；若你的本机版本不同，命令行为可能有差异，遇到不一致以 `codex --help` 与 `codex help <子命令>` 的实际输出为准。

AI摘要

本文是一份专为Codex新手设计的手册，旨在帮助初学者快速上手Codex的基础命令。手册内容包括Codex命令的基本格式、核心概念、安装与基础配置、不同形态的启动与选择、CLI核心基础命令、Slash Commands斜杠命令、运维与扩展命令、效率技巧以及新手学习建议等。通过这份手册，新手可以快速理解Codex的工作原理，并掌握日常使用中必备的基础命令。

从会用到好用 | Codex 命令新手手册：小白可直接上手的基础命令汇总

作者：芯智荟
发布时间：2026年5月28日 19:12
原始链接：https://mp.weixin.qq.com/s/xaT3wk3sYZfjE2QiRkPKGg

这份手册专为 Codex 新手设计，用最直白的语言覆盖日常使用必备的基础命令。不需要死记硬背——先理解「Codex App / CLI / 交互式会话」的核心逻辑，再动手练习，遇到记不住的随时翻这份手册就行。
虽然部分时候在Codex中用自然语言提要求也可行，但命令有其准确性和简洁性的优势。
本手册基于 codex-cli 0.134.0 核对（2026 年 5 月），斜杠命令在桌面APP也可用。子命令与 flag 在不同版本可能略有差异，最权威的方式是 codex --help 或 codex help <子命令>。

〇、写在前面：Codex 命令长什么样？

Codex CLI 命令的基本格式：

codex <subcommand> [-options] [parameter]

部分	含义	举例
‎`codex`	主命令（固定）	所有 Codex 操作的入口
‎`subcommand`	子命令（核心操作）	‎`exec`、‎`login`、‎`resume`、‎`review`
‎`-options`	选项，控制命令行为	‎`-m`（指定模型）、‎`--last`（操作最近会话）
‎`parameter`	参数，命令操作的对象	任务描述、会话 ID、项目路径

核心概念先理清（新手必懂）：

形态	含义	通俗理解
Codex App	桌面图形客户端	带界面的可视化工具，新手友好，不用记命令
Codex CLI	命令行工具	终端里的命令版本，适合习惯命令行的开发者，高效灵活
交互式 TUI	CLI 里的交互模式	进入后可以和 Codex 对话，类似 App 的聊天体验，支持斜杠命令
非交互 Exec	CLI 里的脚本模式	不用对话，直接执行任务，适合自动化、CI/CD 场景
Slash Commands	交互式会话的快捷命令	TUI 里输入 ‎`/` 即可触发的内置命令

💡 小技巧：输入 codex help <子命令> 可查任意命令的帮助，比如 codex help exec、codex help resume，比搜索引擎更精准。

除了上述 CLI 命令，另外一类命令是 Slash Commands 也就是斜杠命令，直接在 Codex 界面中敲 / 然后带上命令即可。一般会有命令提示。
另外，虽然部分情况下，用自然语言描述，也可起到替代斜杠命令的作用，但是斜杠命令有其准确性和简洁性的优势，可以更快更放心的完成所想要完成的任务。

一、安装与基础配置

首次使用 Codex 必须先完成安装和登录，优先做这一步。

1.1 安装 Codex CLI

根据你的系统选择安装方式：

# 官方一键脚本（macOS / Linux，最新推荐）
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Windows PowerShell 一键脚本
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# 使用 npm 全局安装（全平台通用）
npm install -g @openai/codex

# 使用 Homebrew 安装（macOS / Linux 用户）
brew install --cask codex

三种方式都可以；一键脚本最省心，npm / brew 适合已经习惯包管理器的人。装好后用 codex --version 验证版本。

1.2 登录认证

安装完成后需要登录你的 OpenAI 账号：

# 浏览器 OAuth 登录（推荐，新手首选）
codex login

# 无浏览器环境（比如 SSH 服务器）用设备码登录
codex login --device-auth

# 自动化脚本用 API Key 登录（从环境变量读取，不留在 shell history）
printenv OPENAI_API_KEY | codex login --with-api-key

# 用预先签发的 access token 登录（CI / 服务器场景）
printenv CODEX_ACCESS_TOKEN | codex login --with-access-token

四种登录方式按"日常 → CI / 服务器"递进：图形环境直接 codex login；SSH / 无浏览器场景用 --device-auth 走设备码；脚本与流水线用 --with-api-key 或 --with-access-token 从 stdin 读取，避免凭据出现在命令行历史。

1.3 查看 / 管理登录状态

# 查看当前登录状态
codex login status

# 退出登录 / 切换账号
codex logout

二、不同形态的启动与选择

Codex 提供了多种使用形态，根据你的场景选择最合适的：

2.1 Codex App：新手首选的图形界面

如果你是刚接触 Codex 的小白，优先用桌面 App，不用记命令，可视化操作更友好：

# 启动 Codex 桌面应用（macOS / Windows / Linux，部分平台需先安装桌面客户端）
codex app

# 直接打开指定项目的 App 工作区
codex app /path/to/your-project

启动后你会看到熟悉的聊天界面，直接输入你的需求就行，比如"帮我写一个 Python 的排序算法"，也可以直接用斜杠命令。
注：codex app 的可用性取决于平台与版本。如果你的环境提示 unrecognized subcommand，请到 chatgpt.com/codex 下载桌面客户端或使用 IDE 插件（VS Code / Cursor / Windsurf）。Linux 服务器一般直接用 CLI 即可。

2.2 Codex CLI：终端党的高效选择

如果你习惯用终端工作，CLI 能让你不用切换窗口，直接在项目目录里调用 Codex：

# 直接启动交互式 TUI 会话，进入聊天模式
codex

# 带初始任务启动，省去输入步骤
codex "帮我梳理这个项目的代码结构"

# 附带图片启动，分析截图 / 设计稿
codex -i ui-screenshot.png "帮我看看这个页面有什么问题"

# 指定模型启动（默认走配置文件里的模型）
codex -m gpt-5 "重构这段函数"

💡 小技巧：个人新手入门先从 App 开始，熟悉后再尝试 CLI；团队开发、自动化任务优先用 CLI，效率更高。

三、CLI 核心基础命令

这是日常使用 CLI 最常用的命令，覆盖大部分场景。

3.1 非交互执行：自动化任务必备

如果你想把 Codex 接入脚本、CI/CD 流水线，用非交互的 exec 命令：

# 直接执行任务，输出结果到终端
codex exec "根据当前项目的变更，生成 PR 描述"

# 把最后一条消息写入文件，供后续脚本使用
codex exec -o result.txt "总结这个项目的所有功能"

# 从管道读取输入，和其他命令组合使用（用 - 表示从 stdin 读 prompt）
git diff | codex exec - "根据这些代码变更，写一个提交备注"

# 别名：codex exec 可以缩写为 codex e
codex e "跑一遍单元测试，把失败用例总结给我"

-o, --output-last-message <FILE> 写出的是最后一条 assistant 消息；如果要结构化输出，可以配合 --output-schema <FILE> 用。

3.2 会话管理：继续之前的任务

Codex 会自动保存你的会话记录，随时可以恢复之前的对话：

# 列出所有历史会话，挑一个恢复（picker 交互式选择）
codex resume

# 直接恢复最近一次的会话，最常用
codex resume --last

# 跨目录恢复，比如你换了文件夹，也能找到之前的会话
codex resume --last --all

# 用会话 ID 精准恢复
codex resume <SESSION_ID>

# 基于之前的会话，分叉出一个新的对话，探索不同方向
codex fork --last

3.3 代码审查：直接给 PR / diff 找问题

codex review 是 0.134 顶层就有的子命令，非交互式跑一遍代码审查：

# 审查当前仓库未提交的变更
codex review

# 审查指定分支相对 main 的所有差异
codex review --base main --head feature-branch

也可以在交互式 TUI 里直接 /review（见第四章）。

3.4 云端任务：后台跑耗时任务

对于耗时比较久的任务，可以提交到 Codex Cloud 后台执行，不用一直开着终端：

# 提交云端任务，在后台执行（需要指定 env-id，先用 codex cloud 浏览）
codex cloud exec --env <ENV_ID> "帮我重构这个项目的所有模块"

# 查看云端任务列表
codex cloud list

# 查看具体任务状态
codex cloud status <TASK_ID>

# 看云端任务产生的 diff
codex cloud diff <TASK_ID>

# 把云端任务的结果拉到本地，应用代码改动
codex cloud apply <TASK_ID>

⚠️ 新手注意：codex cloud 整个子命令在 0.134 仍标注为 EXPERIMENTAL，接口可能变。初期建议先从本地 codex / codex exec 任务开始熟悉。

区分两个 apply：codex apply <TASK_ID> 用于本地 agent 产生的最近 diff 重放；codex cloud apply <TASK_ID> 用于云端 task 结果落地。新手大概率只会碰到后者。

四、Slash Commands 斜杠命令（交互式必备）

在 Codex App 或 CLI 的交互式 TUI 里，输入 / 即可调出内置命令。下面是常用的几类。

💡 实际可用命令以你当前版本的 TUI 为准：进入会话后输入 /help 或直接打个 / 会出现自动补全列表。

4.1 会话管理：清理 / 恢复对话

/new          彻底结束当前对话，并创建一个全新的空白会话
/clear        仅清屏，保留当前会话的所有上下文
/compact      压缩对话上下文，释放 Token，避免对话太长失效
/resume       从历史记录里恢复之前的对话
/side         开一个临时支线对话，避免污染主任务
/fork         把当前对话分叉成新线程，探索不同方向
/quit         退出交互式会话（部分版本是 /exit）

💡 小技巧：和 Codex 聊了很久、提示上下文太长时，用 /compact 快速压缩，不必整段重开。有些命令是直接带上后续的提问/请求，比如 /side 这个方案有没有明显风险 。

4.2 工作模式与配置

/model        快速切换使用的模型（弹出选择列表）
/approval     调整命令执行的审批策略（自动 / 询问 / 只读）
/permissions  管理 Codex 可访问的资源权限（文件、网络、shell 等）
/plan         切换到计划模式，先让 Codex 出方案再动手，适合复杂任务
/fast on      开启快速模式（fast_mode），简化提示、加快响应
/fast off     关闭快速模式
/mention      用 @ 引用文件 / 路径 / app / 插件 / skill，注入到上下文
/status       查看当前会话的配置、模型、Token 用量

💡 /fast 可以在 TUI 用快捷键直接切换，通过在 keymap 里配置 toggle_fast_mode 这个快捷键。/plan 是很好用的命令，当需要做规划或者不确定怎么改时，就先用 /plan。

4.3 项目操作快捷功能

/init         自动生成 AGENTS.md 脚手架，给 Codex 配置项目规则
/diff         查看当前项目的 Git 变更（不用切窗口跑 git diff）
/review       一键审查当前的代码改动，找问题
/skills       浏览与启用预置 skill（代码审查、文档生成等可一键调用）

举例：你刚进项目，输入 /init，Codex 自动帮你生成项目级配置（AGENTS.md），后续它就能更懂你的项目规则；改完代码输入 /review，它会自动审一遍当前 diff；/skills 可以浏览你这台机器上已经装好的 skill 并启用。

五、运维与扩展命令

这一节是 0.134 版本里比较新、但日常用得着的几条。

5.1 自我诊断与升级

# 自检：本地安装、配置、登录、运行时环境
codex doctor

# 把 Codex CLI 升到最新版（避免手动跑 npm 或 brew）
codex update

doctor 在排查"为什么我登录不上""为什么 sandbox 拒绝执行"这类问题时很救命。

5.2 MCP 与插件

# 管理外部 MCP 服务器（Model Context Protocol，把外部能力挂进 Codex）
codex mcp list
codex mcp add <name> <command-or-url>
codex mcp remove <name>

# 让 Codex 自己作为 MCP server 启动（被其他 agent 调用时用）
codex mcp-server

# 插件管理（0.134 起新增的 plugin 子命令）
codex plugin list
codex plugin install <plugin-name>

具体 flag 以 codex mcp --help、codex plugin --help 为准——这两个子命令在快速迭代。

5.3 沙箱与 shell 补全

# 在 Codex 提供的沙箱里跑一条本地命令（与 agent 用同样的隔离规则）
codex sandbox -- ls /etc

# 生成 shell 补全脚本（bash / zsh / fish / powershell）
codex completion bash > ~/.codex-completion.bash
echo 'source ~/.codex-completion.bash' >> ~/.bashrc

六、效率技巧

6.1 交互式会话里的 Shell 快捷操作

在 CLI 的交互式 TUI 里，你不用退出会话就能执行本地命令：

!ls           查看当前目录的文件
!git status   查看 git 状态，不用切窗口

输入 ! 加任意 shell 命令即可（前提是你的审批策略允许 shell 调用）。

6.2 键盘快捷键

交互式 TUI 里的常用快捷键，提升操作速度：

快捷键	作用
‎`Ctrl+C`	中断当前任务 / 退出交互式会话
‎`Ctrl+L`	清屏，保留对话历史
‎`Ctrl+O`	复制最近的输出到剪贴板
‎`Ctrl+R`	搜索你的输入历史
‎`Up/Down`	浏览之前的输入草稿

6.3 常用命令组合

这些组合能帮你快速搞定常见场景：

# 快速恢复上次的对话，接着干活
codex resume --last

# 带任务快速启动，不用进会话再输入
codex "帮我修复这个项目的单元测试"

# 分析截图，找 UI 问题
codex -i bug.png "帮我看看这个报错是什么问题"

# 生成 PR 描述，直接用 git diff 的结果
git diff | codex exec - "帮我写 PR 的描述"

# 跑一遍当前 PR 的代码审查
codex review

6.4 用配置覆盖灵活定制

-c flag 可以临时覆盖 ~/.codex/config.toml 的任意配置（用点号路径），不必改文件：

# 临时切到 o3 模型跑一条任务
codex -c model="gpt-5.4-mini" "帮我设计一下 schema"

# 临时调宽 sandbox 权限
codex -c 'sandbox_permissions=["disk-full-read-access"]' "找一下这个仓库里的硬编码密钥"

七、新手学习建议

‎先抓核心流程：优先掌握「安装登录 → 启动 App/CLI → 基础对话 → 常用斜杠命令」，覆盖 90% 日常使用场景。
‎理解形态区别：先从 App 入门，不用一开始就记 CLI 命令；熟悉后再尝试 CLI，循序渐进。
‎动手比背诵重要：找个小项目，反复试 ‎/init、‎/plan、‎codex resume 这些命令，甚至故意试不同的任务，犯错才是最快的学习方式。
‎善用帮助命令：记不住参数就输 ‎codex help <子命令> 或 ‎codex <子命令> --help，Codex 自带的帮助文档比碎片化教程更权威。
‎遇到问题先 doctor：登录异常、sandbox 拒绝、网络不通时，先跑 ‎codex doctor 看自检报告。
‎从简单场景开始：先用来写小脚本、改 bug，再尝试复杂的重构、文档生成，不要一开始就搞大项目。
‎不要怕出错：Codex 的操作大部分都能撤销，会话记录也都能恢复，大胆试错就好。

附录：高频命令速查表

分类	命令	用途
‎安装配置	‎`curl -fsSL https://chatgpt.com/codex/install.sh \	sh`	官方一键脚本（macOS / Linux）
	‎`npm install -g @openai/codex`	npm 全局安装
	‎`brew install --cask codex`	Homebrew 安装
	‎`codex login`	OAuth 浏览器登录
	‎`codex login status`	查看登录状态
	‎`codex logout`	退出登录
‎启动方式	‎`codex app`	启动桌面 App（视平台与版本而定）
	‎`codex`	启动 CLI 交互式 TUI
	‎`codex "任务描述"`	带任务启动会话
	‎`codex -i img.png "..."`	带图片启动
	‎`codex -m <model> "..."`	指定模型启动
‎CLI 核心	‎`codex exec "任务"`	非交互执行任务
	‎`codex exec -o file.txt "..."`	把最后一条消息写入文件
	‎`codex resume --last`	恢复最近会话
	‎`codex resume --last --all`	跨目录恢复
	‎`codex fork --last`	分叉当前会话
	‎`codex review`	非交互式代码审查
‎云端任务	‎`codex cloud exec --env <ID> "..."`	提交云端任务（实验性）
	‎`codex cloud list`	列出云端任务
	‎`codex cloud apply <TASK_ID>`	应用云端任务结果
‎斜杠命令	‎`/new`	开启新会话
	‎`/compact`	压缩上下文
	‎`/model`	切换模型
	‎`/approval`	调整审批策略
	‎`/permissions`	管理资源访问权限
	‎`/side`	开临时支线对话
	‎`/plan`	切换到计划模式
	‎`/fast on` / ‎`/fast off`	切换快速模式
	‎`/mention`	@ 引用文件 / 插件 / skill
	‎`/init`	初始化项目配置 (‎`AGENTS.md`)
	‎`/diff`	查看 Git 变更
	‎`/review`	审查代码改动
	‎`/skills`	浏览与启用预置 skill
‎运维扩展	‎`codex doctor`	自检本地环境
	‎`codex update`	升级 CLI
	‎`codex mcp list`	列出 MCP server
	‎`codex plugin list`	列出已装插件
	‎`codex sandbox -- <cmd>`	在沙箱里跑命令
	‎`codex completion bash`	生成 shell 补全
‎效率操作	‎`!<shell命令>`	会话内执行本地命令
	‎`git diff \	codex exec - "..."`	快速生成 PR 内容
	‎`codex -c key=value "..."`	临时覆盖配置

本文专为 Codex 新手打造，聚焦"能用、好用、够日常"的基础命令，避开复杂的底层原理和进阶用法。收藏起来，使用时边查边练，一周就能熟练掌握 Codex 核心操作。
本手册基于 codex-cli 0.134.0 核对，斜杠命令在 Codex App 也可用；若你的本机版本不同，命令行为可能有差异，遇到不一致以 codex --help 与 codex help <子命令> 的实际输出为准。