# Codex CLI 功能
来源: https://developers.openai.ac.cn/codex/cli/features

Codex 终端客户端功能概览

Codex 支持超越聊天范畴的工作流。使用本指南了解每种工作流的作用及其适用场景。

## 交互模式下运行

Codex 会启动一个全屏终端界面 (TUI)，能够读取您的代码库、进行编辑并在您共同迭代时运行命令。当您需要通过对话式工作流实时查看 Codex 的操作时，请使用此模式。

```
codex
```
您也可以在命令行中指定初始提示。

```
codex "Explain this codebase to me"
```
会话开启后，您可以：

- 将提示词、代码片段或截图直接发送到编辑器中。
- 在 Codex 做出更改前观察其计划，并内联批准或拒绝操作步骤。
- 在 TUI 中阅读带有语法高亮的 Markdown 代码块和差异对比（diff），并使用 `/theme` 预览和保存您偏好的主题。
- 使用 `/clear` 清除终端并开始新对话，或按 Ctrl+L 清除屏幕而不开启新对话。
- 使用 `/copy` 或按 Ctrl+O 复制 Codex 最近完成的输出。
- 在 Codex 运行时按 Tab 键，可为下一轮排队后续文本、斜杠命令或 `!` Shell 命令。
- 使用 Up/Down 键在编辑器中导航草稿历史记录。
- 按 Ctrl+R 在编辑器中搜索提示词历史。
- 完成后按 Ctrl+C 或使用 `/exit` 关闭交互式会话。

## 恢复对话

Codex 会在本地存储您的对话记录，以便您可以在上次中断的地方继续。

- `codex resume` - 启动选择器恢复会话
- `codex resume --all` - 显示所有工作目录外的会话
- `codex resume --last` - 直接跳转到最近的会话
- `codex resume <SESSION_ID>` - 按 ID 恢复特定会话

非交互式运行也可恢复:
```
codex exec resume --last "Fix the race conditions you found"
codex exec resume 7f9f9a2e-1b3c-4c7a-9b0e-.... "Implement the plan"
```

## 将 TUI 连接到远程应用服务器

```
codex app-server --listen ws://127.0.0.1:4500
codex --remote ws://127.0.0.1:4500
```

带 WebSocket 认证:
```
TOKEN_FILE="$HOME/.codex/app-server-token"
openssl rand -base64 32 > "$TOKEN_FILE"
chmod 600 "$TOKEN_FILE"
codex app-server --listen ws://0.0.0.0:4500 --ws-auth capability-token --ws-token-file "$TOKEN_FILE"
```

## 模型与推理

推荐使用 `gpt-5.5` 模型。通过 `/model` 命令切换模型:
```
codex --model gpt-5.5
```

## 功能标志

```
codex features list
codex features enable unified_exec
codex features disable shell_snapshot
```

## 子 Agent

Codex 支持子代理工作流来并行处理大型任务。

## 图像输入

```
codex -i screenshot.png "Explain this error"
codex --image img1.png,img2.jpg "Summarize these diagrams"
```

## 图像生成

内置图像生成使用 `gpt-image-2`。

## 语法高亮与主题

使用 `/theme` 打开主题选择器。

## 运行本地代码审查

在 CLI 中输入 `/review` 以打开 Codex 的审查预设。

## 网络搜索

Codex 附带 Web 搜索工具，默认使用缓存模式。使用 `--search` 启用实时搜索。

## Shell 补全

```
codex completion bash
codex completion zsh
codex completion fish
```

## 批准模式

- **自动**（默认）：允许在工作目录内读取、编辑和运行命令
- **只读**：咨询模式，需要批准
- **完全访问**：完全自主

## 脚本化 Codex

使用 `exec` 子命令自动化工作流:
```
codex exec "fix the CI failure"
```

## 使用 Codex Cloud

```
codex cloud exec --env ENV_ID "Summarize open bugs"
```

## 斜杠命令

内置命令: `/review`, `/fork`, `/side` 等，也可创建自定义命令。

## 模型上下文协议 (MCP)

在 `~/.codex/config.toml` 中配置 MCP 服务器。

## 提示与快捷键

- 键入 `@` 打开模糊文件搜索
- 行首加 `!` 运行本地 Shell 命令
- 连按两次 Esc 编辑上一条消息
- `codex --cd <path>` 设置工作目录
- `codex --add-dir <path>` 添加额外写入目录