Codex CLI 使用指南 | 安装、终端工作流与云端任务
在终端中与 Codex 协作
Codex CLI
在终端中与 Codex 协作
Codex CLI 是 OpenAI 提供的编码智能体，你可以直接在终端中本地运行它。它可以在你选定的目录中读取、修改并运行代码。 它是 开源项目，并使用 Rust 构建，以获得更好的速度和效率。
ChatGPT Plus、Pro、Business、Edu 和 Enterprise 计划都包含 Codex。更多信息见 包含内容。
概览视频： Codex CLI overview
CLI 设置
按你当前使用的包管理器完成安装、首次启动和更新。
使用 npm 安装
- 安装
使用 npm 安装 Codex CLI。
npm i -g @openai/codex- 运行
在终端中启动 Codex。它可以检查仓库、编辑文件并执行命令。
codex第一次运行时，系统会提示你使用 ChatGPT 账号或 API key 登录。如果你不确定当前计划是否包含 Codex，可先查看 定价页面。
- 升级
Codex CLI 会持续发布新版本。升级前可以先查看 最近更新。
npm i -g @openai/codex@latest使用 Homebrew 安装
- 安装
使用 Homebrew 安装 Codex CLI。
brew install codex- 运行
在终端中启动 Codex。它可以检查仓库、编辑文件并执行命令。
codex第一次运行时，系统会提示你使用 ChatGPT 账号或 API key 登录。如果你不确定当前计划是否包含 Codex，可先查看 定价页面。
- 升级
Codex CLI 会持续发布新版本。升级前可以先查看 最近更新。
brew upgrade codex如果你刚开始使用 Codex，建议先读 最佳实践指南。
使用 Codex CLI
从交互式 TUI 到本地评审、Web 搜索和云端任务，这些是 CLI 中最常用的能力入口。
-
以交互方式运行 Codex - 启动交互式终端 UI（TUI）会话，在同一个界面中持续对话、改代码并执行命令。查看详情 →
-
控制模型和推理 - 通过
/model切换可用模型，并按任务复杂度调整推理强度。查看详情 → -
图片输入 - 把截图或设计稿附加到提示词中，让 Codex 一并理解图像细节。查看详情 →
-
图片生成 - 直接在 CLI 中生成或编辑图片；如果需要 Codex 迭代现有素材，也可以附加参考图。查看详情 →
-
运行本地代码评审 - 在提交或推送前，用独立的 Codex 评审智能体先检查当前改动。查看详情 →
-
使用子智能体 - 把复杂任务拆分成多个并行子任务，在本地工作流中加速推进。查看详情 →
-
Web 搜索 - 在终端中直接使用内置 Web 搜索，获取任务需要的最新信息。查看详情 →
-
Codex Cloud 任务 - 不离开终端就能发起云端任务、选择环境，并把 diff 应回本地。查看详情 →
-
脚本化 Codex - 使用
codex exec把 Codex 接入脚本、CI 和其他可重复的自动化流程。查看详情 → -
模型上下文协议（MCP） - 接入更多第三方工具和上下文来源，扩展 Codex 在终端中的能力。查看详情 →
-
审批模式 - 在改代码或运行命令前，选择与你风险偏好相匹配的审批模式。查看详情 →