Codex CLI 是一个编码代理，您可以从终端本地运行它，并且可以在您的计算机上的所选目录中读取、修改和运行代码。它是开源的，使用 Rust 构建以提高速度和效率，并且在GitHub 上的openai/codex上快速改进。
设置
Codex CLI 正式支持 macOS 和 Linux。Windows 支持仍处于实验阶段，我们建议在 WSL 中运行。
安装 Codex
您可以使用您喜欢的包管理器安装 Codex CLI：
使用 npm 安装
npm install -g @openai/codex使用 Homebrew 安装
brew install codex运行 Codex
然后运行codex即可开始：
codex首次运行 Codex CLI 时，系统会提示您进行身份验证。我们建议您登录 ChatGPT 帐户，以便在 Plus、Pro、Team、Edu 或 Enterprise 套餐中使用 Codex。您也可以通过 API 密钥使用 Codex，但这需要额外的设置。您可以访问我们的定价页面
，了解更多信息以及每个套餐包含的内容。
升级法典
您可以使用您喜欢的包管理器升级 Codex：
使用 npm 升级
npm install -g @openai/codex@latest使用 Homebrew 升级
brew upgrade codex使用 Codex CLI
Codex 在交互式终端 UI 中运行。您可以让 Codex 执行任何操作，它会读取您的代码库、进行编辑并运行命令。由于 Codex 支持提示符（包括图像输入），因此操作起来非常简单。
使用输入提示运行
您可以使用提示直接运行 Codex：
codex "explain this codebase"模型与推理
我们建议将 Codex 与 GPT-5-Codex 结合使用，这是我们针对代理编码优化的最佳编码模型。默认情况下，Codex 将运行 GPT-5，但您可以使用/model命令切换到 GPT-5-Codex。
默认推理级别为中等，您可以使用相同/model命令升级到高级以执行复杂任务。
您还可以通过使用基于 API 的身份验证并使用以下标志启动 codex来使用旧模型--model：
codex --model o4-mini您可以在我们的模型页面中了解有关不同模型和推理级别的更多信息。
审批模式
我们为 Codex 在您的计算机上运行选择了强大的默认设置：auto。
在此批准模式下，Codex 可以自动读取工作目录中的文件、进行编辑并运行命令。但是，Codex 需要您的批准才能在工作目录外工作或访问网络。
当您只是想聊天，或者想要在开始之前制定计划时，您可以Read Only使用/approvals命令切换到模式。
如果您需要 Codex 在未经批准的情况下读取文件、进行编辑以及通过网络访问运行命令，则可以使用Full Access。 请在执行此操作前务必谨慎。
图像输入
你可以直接将图片粘贴到编辑器中，并将其附加到你的提示符中。你也可以通过 CLI 使用以下image标志附加图片文件：
codex -i screenshot.png "Explain this error"
codex --image img1.png,img2.jpg "Summarize these diagrams"脚本法典
您还可以使用以下命令以非交互方式运行 Codex exec：
codex exec "fix the CI failure"后续步骤Next steps
由于 Codex CLI 是一个开源项目，主要文档位于 github 存储库：github.com/openai/codex。
有关高级配置、MCP 等的更详细文档，请直接查看开源仓库中的 README 和链接。