Codex CLI 功能特性

Codex 提供了丰富的工作流程，远不止聊天界面。本指南帮助你了解每种体验能解锁什么功能，以及如何充分利用它们。

交互式终端界面（TUI）

Codex 启动后会进入全屏终端界面，可以读取你的仓库、进行编辑，并在你迭代时运行命令。当你需要实时查看 Codex 操作的对话式工作流程时，使用它。

codex

会话打开后，你可以：

• 输入自然语言指令
• 查看 Codex 的计划和操作
• 审批或拒绝命令执行
• 实时查看输出结果

会话恢复

Codex 在本地存储你的对话记录，因此你可以从上次中断的地方继续，而不需要重复上下文。当你想用相同的仓库状态和指令重新打开之前的会话时，使用 resume 子命令。

# 恢复最近的会话
codex resume --last

# 恢复指定会话
codex resume <session-id>

非交互式自动化运行也可以恢复：

codex exec resume --last "修复你发现的竞态条件"
codex exec resume 7f9f9a2e-1b3c-4c7a-9b0e-.... "实现这个计划"

每次恢复运行都会保留原始对话记录、计划历史和审批记录，因此 Codex 可以使用之前的上下文，同时你提供新的指令。如果需要在恢复前调整环境，可以使用 --cd 覆盖工作目录，或使用 --add-dir 添加额外的根目录。

模型选择

Codex 在 macOS 和 Linux 上默认使用 gpt-5-codex，在 Windows 上默认使用 gpt-5。你可以在会话中使用 /model 命令切换模型，或在启动 CLI 时指定。

codex --model gpt-5-codex

图片输入

附加截图或设计稿，让 Codex 可以在处理你的提示时读取图片细节。你可以将图片粘贴到交互式编辑器中，或在命令行提供文件。

codex -i screenshot.png "解释这个错误"
codex --image img1.png,img2.jpg "总结这些图表"

Codex 接受常见格式如 PNG 和 JPEG。使用逗号分隔多个文件名，并结合文本指令添加上下文。

代码审查

在 CLI 中输入 /review 打开 Codex 的审查预设。CLI 会启动一个专门的审查器，读取你选择的 diff 并报告优先级排序的、可操作的发现，而不会修改你的工作目录。

# 在交互式会话中
/review

每次运行都会作为单独的回合显示在对话记录中，因此你可以在代码演进时重新运行审查并比较反馈。

网络搜索

Codex 附带一个第一方网络搜索工具，默认关闭。在 ~/.codex/config.toml 中启用它（或传递 --search 标志），如果你在默认沙箱中运行，还可以选择允许网络访问：

[features]
web_search_request = true

[sandbox_workspace_write]
network_access = true

启用后，Codex 可以在需要新鲜上下文时调用搜索工具。你会在对话记录或 codex exec --json 输出中看到 web_search 项目，表示 Codex 正在查找内容。

快速问答模式

当你只需要快速回答时，使用单个提示运行 Codex，跳过交互式界面。

codex "解释这个代码库"

Codex 会读取工作目录，制定计划，并将响应流式输出到终端后退出。结合 --path 等标志来定位特定目录，或使用 --model 来预先调整行为。

Shell 补全

通过为你的 shell 安装生成的补全脚本来加速日常使用：

codex completion bash
codex completion zsh
codex completion fish

在 shell 配置文件中运行补全脚本以为新会话设置补全。例如，如果你使用 zsh，可以在 ~/.zshrc 文件末尾添加：

# ~/.zshrc
eval "$(codex completion zsh)"

启动新会话，输入 codex 并按 Tab 查看补全。如果看到 command not found: compdef 错误，需要在 eval "$(codex completion zsh)" 行之前添加 autoload -Uz compinit && compinit 到 ~/.zshrc 文件，然后重启 shell。

审批模式

审批模式定义了 Codex 在停止确认之前可以做多少事情。在交互式会话中使用 /approvals 命令，随着你的舒适度变化切换模式。

• untrusted - 仅已知安全的只读命令自动运行
• on-failure - 在沙箱中自动运行，仅在失败时提示
• on-request - 由模型决定何时询问（默认）
• never - 从不提示（有风险）

Codex 始终会显示其操作的记录，因此你可以使用常规的 git 工作流程查看或回滚更改。

非交互式执行（exec）

使用 exec 子命令自动化工作流程或将 Codex 集成到现有脚本中。这会非交互式运行 Codex，将最终计划和结果输出到 stdout。

codex exec "修复 CI 失败"

结合 exec 和 shell 脚本构建自定义工作流程，例如自动更新变更日志、整理问题，或在 PR 发布前执行编辑检查。

云端任务

codex cloud 命令让你无需离开终端就可以分类和启动 Codex 云端任务。不带参数运行它会打开交互式选择器，浏览活动或已完成的任务，并将更改应用到本地项目。

你也可以直接从终端启动任务：

codex cloud exec --env ENV_ID "总结未解决的 bug"

添加 --attempts（1-4）来请求 best-of-N 运行，当你希望 Codex 云端生成多个解决方案时。例如：

codex cloud exec --env ENV_ID --attempts 3 "总结未解决的 bug"

环境 ID 来自你的 Codex 云端配置——使用 codex cloud 并按 Ctrl+O 选择环境，或使用 Web 仪表板确认确切值。认证遵循你现有的 CLI 登录，如果提交失败命令会以非零退出，因此你可以将其集成到脚本或 CI 中。

斜杠命令

斜杠命令让你快速访问专门的工作流程，如 /review、/plan，或你自己的可复用提示。Codex 附带一组精选的内置命令，你可以为团队特定任务或个人快捷方式创建自定义命令。

Model Context Protocol（MCP）

通过配置 Model Context Protocol 服务器将 Codex 连接到更多工具。在 ~/.codex/config.toml 中添加 STDIO 或流式 HTTP 服务器，或使用 codex mcp CLI 命令管理它们——Codex 在会话启动时自动启动它们，并将它们的工具与内置工具一起暴露。你甚至可以在需要时将 Codex 本身作为 MCP 服务器运行在另一个代理中。

详见 MCP 服务器配置 了解示例配置、支持的认证流程和更深入的介绍。