OpenAI Codex CLI 适合想在本地终端直接运行编码代理的用户:它能在你选定的代码目录里读文件、改代码、执行命令。支持 macOS、Windows 和 Linux;Windows 可用 PowerShell 沙箱,或在需要 Linux 原生环境时使用 WSL2。

OpenAI Codex CLI 安装与使用

OpenAI Codex CLI 是 OpenAI 的编码代理,可以在本地终端运行。它能读取、修改并在你机器上执行代码,工作范围限定在你选定的目录中。Codex CLI 开源,使用 Rust 构建,强调速度和效率。

ChatGPT Plus、Pro、Business、Edu 和 Enterprise 计划都包含 Codex。查看 what’s included

CLI setup

Codex CLI 可在 macOS、Windows 和 Linux 上使用。Windows 上可以原生运行 Codex,并配合 Windows sandbox 使用 PowerShell;如果你需要 Linux 原生环境,也可以使用 WSL2。Windows 详细设置请看 Windows setup guide

如果你刚开始接触 Codex,建议先看 best practices guide


使用 Codex CLI

交互式运行 Codex

运行 codex 即可启动一个交互式终端界面(TUI)会话。

控制模型和 reasoning

使用 /model 在 GPT-5.4、GPT-5.3-Codex 和其他可用模型之间切换,也可以调整 reasoning levels。

图片输入

把截图或设计稿附加给 Codex,让它把图片和你的提示词一起读取。

图片生成

可以在 CLI 里直接生成或编辑图片;如果你想让 Codex 继续迭代现有素材,也可以附上参考图。

本地代码审查

在你提交或推送改动前,先让另一个 Codex 代理审查你的代码。

使用子代理

用 subagents 把复杂任务拆开并行处理。

让 Codex 搜索网页,为当前任务获取最新信息。

Codex Cloud 任务

在不离开终端的情况下启动 Codex Cloud 任务、选择环境,并应用生成的 diff。

脚本化 Codex

通过 exec 命令把 Codex 自动化到可重复执行的工作流里。

Model Context Protocol

通过 Model Context Protocol(MCP)给 Codex 接入更多第三方工具和上下文。

审批模式

在 Codex 编辑文件或运行命令前,先选一个符合你信任程度的审批模式。

常见问题

OpenAI Codex CLI 怎么安装

Codex CLI 支持 macOS、Windows 和 Linux。Windows 上可以原生运行,也可以在需要 Linux 原生环境时使用 WSL2。
如果你在 Windows 上遇到环境差异问题,先看 Windows setup guide

OpenAI Codex CLI 怎么用

进入你的目标项目目录后运行 codex,就会启动 TUI 交互会话。之后你可以让它读文件、改代码、执行命令,所有操作都限定在当前选定目录里。

OpenAI Codex CLI 支持哪些计划

ChatGPT Plus、Pro、Business、Edu 和 Enterprise 计划都包含 Codex。具体包含内容请查看 what’s included