它是什么

Codex CLI 是 OpenAI 提供的本地编程 Agent。它在你的电脑上运行，可以围绕当前项目理解代码，并根据自然语言任务协助编写、修改和检查代码。它不是只能回答问题的聊天窗口：使用时，你可以把一项具体开发工作交给它，再查看它提出或完成的改动。

Codex CLI 的代码仓库位于 https://github.com/openai/codex，使用文档位于 https://developers.openai.com/codex。本文涉及的安装方式可能随平台和版本变化；遇到本文未说明的细节，以官方文档为准。

适合谁

如果你经常在终端中处理代码，希望通过自然语言完成小型修改、理解陌生项目或整理重复工作，可以尝试 Codex CLI。它尤其适合已经有明确项目目录和任务目标的开发者：你能提供必要背景，也能检查结果是否符合预期。

它并不意味着可以跳过代码审查。涉及业务规则、数据处理或重要配置的变更，仍应由熟悉项目的人确认。初次使用时，建议先从范围小、结果容易验证的任务开始。

安装

Mac 和 Linux

可以使用官方提供的安装脚本：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

也可以通过 npm 安装：

npm install -g @openai/codex

目前 npm 最新版本为 0.166.0。若希望使用 Homebrew，也可以安装：

brew install --cask codex

Windows

在 PowerShell 中运行安装脚本：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

如果你更习惯通过 npm 管理工具，也可以使用前文所列的 npm 安装方式。不同安装渠道的更新和配置细节，以官方文档为准。

GitHub Releases

也可以从 GitHub Releases 下载二进制文件。例如，提供的文件名包括 codex-aarch64-apple-darwin.tar.gz 和 codex-x86_64-unknown-linux-musl.tar.gz。下载后解压，并将二进制文件改名为 codex。选择文件时，应确认它与自己的系统和处理器架构相匹配；具体操作以官方文档为准。

首次登录与配置

安装完成后，在终端运行 codex。首次使用时，选择 Sign in with ChatGPT，然后按提示完成登录。支持使用 Plus、Pro、Business、Edu 和 Enterprise 套餐。

如果要通过 API Key 登录，需要进行额外配置，具体说明见 https://developers.openai.com/codex/auth#sign-in-with-an-api-key。不要把密钥写入项目文件，也不要在任务描述或公开记录中粘贴敏感凭据。

进入项目后，可以在项目说明文件 AGENTS.md 中写下 Codex 应遵循的项目约定，例如代码风格、测试要求和需要留意的目录。说明应简洁、明确，并与项目实际情况一致。Codex app 可以通过 codex app 打开桌面版；IDE 插件介绍见 https://developers.openai.com/codex/ide。云端 Codex Web 位于 https://chatgpt.com/codex。

上手示例

开始时，先进入自己正在处理的项目，再运行 codex。任务描述不必写成特殊格式，重点是交代目标、范围和需要保留的行为。

例如，你可以这样提出任务：

  • “阅读这个项目的目录结构，说明主要模块分别负责什么，先不要修改文件。”
  • “检查用户资料页面的表单校验，找出可能的问题，并解释你准备如何修复。”
  • “为这段重复逻辑做一次小范围整理，保持现有行为不变，并说明改动了哪些部分。”
  • “为这个函数补充边界情况测试；先检查项目现有测试的写法。”

第一类任务适合熟悉陌生代码库，后几类则适合逐步验证的开发工作。如果任务涉及多个文件，可以先要求它梳理方案，再决定是否继续修改。改动完成后，仔细阅读差异，并在项目环境中验证行为。运行测试等具体操作方式，应遵循项目自身说明；本文未列出的命令以官方文档为准。

实用技巧与安全注意

把大任务拆成可以单独检查的小步骤。比如先定位问题，再讨论修改范围，最后检查结果。任务描述越具体，越容易判断输出是否达标；提供相关文件、预期行为和不可改变的约束，也有助于减少误解。

通过 AGENTS.md 记录稳定的项目约定，避免每次重复解释。对不确定的修改，可以先要求 Codex 只分析、不改文件；涉及重要逻辑时，逐项审阅变更，不要因为它给出了说明就直接接受结果。

同时注意本地项目的敏感信息。确认当前工作目录和任务范围，不要把密钥、个人资料或不该分享的内容交给工具处理。安装脚本会从网络获取内容，选择安装来源时应使用文中列出的官方渠道；如需核对安全细节，以官方文档为准。

小结

Codex CLI 可以在本地项目中协助理解代码、提出修改和处理开发任务。完成安装与登录后，从范围清晰、便于验证的自然语言任务开始，并用 AGENTS.md 补充项目约定。无论采用哪种安装方式，都应检查改动、保护敏感信息，并以官方文档确认本文未覆盖的细节。

官方链接

命令与版本核对于 2026-11-03，产品迭代较快，请以官方文档为准。