Codex CLI 是 OpenAI 的 coding agent,可以从你的 terminal 本地运行。它可以在所选目录中读取、修改并运行你机器上的代码。它是 开源 的,并使用 Rust 构建,以获得速度和效率。
ChatGPT Plus、Pro、Business、Edu 和 Enterprise 方案包含 Codex。了解 包含哪些内容 。
安装
使用适用于 macOS 和 Linux 的 standalone installer 安装 Codex CLI。
curl -fsSL https://chatgpt.com/codex/install.sh | sh 无人值守安装时,在运行下载 installer 的 shell 上设置 CODEX_NON_INTERACTIVE=1。详情请参阅 Environment variables 。
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh 运行
在 terminal 中运行 Codex。它可以检查你的 repository、编辑文件并运行命令。
codex 第一次运行 Codex 时,系统会提示你登录。使用你的 ChatGPT account 或 API key 完成认证。
如果不确定哪些方案包含 Codex access,请参阅 定价页面 。
升级
Codex CLI 会定期发布新版本。请查看 changelog 了解 release notes。要升级 standalone install,请重新运行 installer:
curl -fsSL https://chatgpt.com/codex/install.sh | sh Codex CLI 可在 macOS、Windows 和 Linux 上使用。在 Windows 上,可以在 PowerShell 中配合 Windows sandbox 原生运行 Codex;当需要 Linux-native environment 时,也可以使用 WSL2。安装详情请参阅 Windows setup guide 。
如果你刚开始使用 Codex,请阅读 best practices guide 。
使用 Codex CLI 工作
交互式运行 Codex
运行 codex,启动 interactive terminal UI (TUI) session。
控制模型和 reasoning
使用 /model 在可用模型之间切换,或调整 reasoning levels。
图像输入
附加 screenshots 或 design specs,让 Codex 与你的 prompt 一起读取。
图像生成
直接在 CLI 中生成或编辑图像;当你希望 Codex 迭代现有 asset 时,可以附加 references。
运行本地 code review
在 commit 或 push changes 之前,让一个单独的 Codex agent 审查你的代码。
使用 subagents
使用 subagents 并行处理复杂任务。
Web search
使用 Codex 搜索网页,为你的任务获取最新信息。
Codex Cloud tasks
启动一个 Codex Cloud task,选择 environments,并在不离开 terminal 的情况下应用生成的 diffs。
脚本化 Codex
通过使用 exec command 脚本化 Codex,自动化可重复的 workflows。
Model Context Protocol
通过 Model Context Protocol (MCP),让 Codex 访问额外的 third-party tools 和 context。
Approval modes
在 Codex 编辑或运行命令之前,选择符合你舒适度的 approval mode。