📚AI 编程官方教程中文版
官方教程中文版产品入口

使用命令行版 Codex

Codex CLI 是 OpenAI 的 coding agent(编程 Agent),可以从你的终端本地运行。它能在你选定的目录里读取代码、修改代码,并运行代

Codex CLI 是 OpenAI 的 coding agent(编程 Agent),可以从你的终端本地运行。它能在你选定的目录里读取代码、修改代码,并运行代码。

Codex CLI 是开源项目:

https://github.com/openai/codex

它使用 Rust 构建,重点是速度和效率。

ChatGPT Plus、Pro、Business、Edu 和 Enterprise 套餐都包含 Codex。你可以在官方 pricing(价格)页面了解具体包含内容:

https://developers.openai.com/codex/pricing

官方页面还提供了一个 Codex CLI overview(Codex CLI 概览)视频:

title     Codex CLI overview
videoId   iqNzfK4_meQ

CLI 设置

Codex CLI 支持 macOS、Windows 和 Linux。

在 Windows 上,你可以在 PowerShell 中原生运行 Codex,并使用 Windows sandbox(Windows 沙箱)。如果你需要 Linux-native environment(原生 Linux 环境),可以使用 WSL2。

Windows 设置细节见官方 Windows setup guide:

https://developers.openai.com/codex/windows

如果你是 Codex 新手,建议阅读官方 best practices guide:

https://developers.openai.com/codex/learn/best-practices

使用 Codex CLI 工作

交互式运行 Codex

运行 codex,启动一个 interactive terminal UI(交互式终端界面,也就是 TUI)会话。

官方对应页面:

https://developers.openai.com/codex/cli/features#running-in-interactive-mode

控制模型和推理

使用 /model 可以在 GPT-5.4、GPT-5.3-Codex 以及其他可用模型之间切换,也可以调整 reasoning levels(推理强度)。

官方对应页面:

https://developers.openai.com/codex/cli/features#models-reasoning

图片输入

你可以附加截图或设计稿,让 Codex 在阅读提示词的同时参考这些图片。

官方对应页面:

https://developers.openai.com/codex/cli/features#image-inputs

图片生成

你可以直接在 CLI 里生成或编辑图片。如果希望 Codex 基于已有素材迭代,也可以附加参考图。

官方对应页面:

https://developers.openai.com/codex/cli/features#image-generation

运行本地代码审查

在 commit 或 push 之前,可以让另一个 Codex agent(Codex Agent)审查你的代码。

官方对应页面:

https://developers.openai.com/codex/cli/features#running-local-code-review

使用 subagents

使用 subagents(子 Agent)可以并行处理复杂任务。

官方对应页面:

https://developers.openai.com/codex/subagents

网页搜索

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

官方对应页面:

https://developers.openai.com/codex/cli/features#web-search

Codex Cloud 任务

你可以从终端发起 Codex Cloud 任务,选择 environments(环境),并在不离开终端的情况下应用任务产生的 diffs(差异改动)。

官方对应页面:

https://developers.openai.com/codex/cli/features#working-with-codex-cloud

把 Codex 脚本化

你可以用 exec command(exec 命令)把 Codex 脚本化,自动执行可重复的工作流。

官方对应页面:

https://developers.openai.com/codex/noninteractive

Model Context Protocol(MCP)

通过 Model Context Protocol(MCP,模型上下文协议),你可以给 Codex 接入更多第三方工具和上下文。

官方对应页面:

https://developers.openai.com/codex/mcp

审批模式

在 Codex 编辑文件或运行命令之前,你可以选择适合自己风险承受程度的 approval mode(审批模式)。

官方对应页面:

https://developers.openai.com/codex/cli/features#approval-modes

On this page