在 macOS、Linux 和 Windows 上安装 Codex CLI

安装 Codex CLI、验证可执行文件、登录，并在项目目录中从一个小任务开始。官方安装程序现已覆盖 macOS、Linux 和 Windows；npm 与 Homebrew 仍是可选方案。请选择下面的一种路径。可正常工作的安装是第一步；账户访问和 API 计费是独立的选择。

1. 选择一种安装方式

这些命令来自官方 Codex CLI 安装指南。请使用与运行代理的环境相匹配的安装程序。安装 Windows 可执行文件不会在 WSL 内额外安装 Linux 副本，而在笔记本电脑上安装也不会在您之后连接的远程服务器上安装。

macOS 或 Linux：官方独立安装程序

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

Windows：官方独立安装程序

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

如果您已经使用包管理器管理开发工具，请使用其替代方案，不要同时运行两个安装程序：

方式	安装	更新
npm	`npm install -g @openai/codex`	`npm install -g @openai/codex`
Homebrew	`brew install --cask codex`	`brew upgrade --cask codex`
独立安装	运行适用于您操作系统的安装程序	再次运行同一个安装程序

npm 路径要求 npm 正常可用；请先检查 npm --version。如果您没有其他 Node 工具需求，独立安装路径会更实用。在受管理的计算机上，请使用管理员支持的安装方式，以便后续更新保持可预测。

2. 验证实际运行的是哪个可执行文件

如果找不到命令，请在安装后启动全新的终端。在 macOS 或 Linux 上，command -v codex会显示 shell 选择的可执行文件。在 PowerShell 中，请使用Get-Command codex。重新安装前，将该路径与您选择的安装方式进行比较。安装了两个副本可能导致您更新的是一个副本，却继续启动另一个副本。

验证、登录并运行第一个任务

codex --version
codex --help

# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."

将示例项目路径替换为您自己的路径。最后一条命令会为初始说明使用只读沙箱。这是一个有用的首次检查，因为您可以在要求代理进行更改前，确认使用的是正确的代码仓库并且拥有模型访问权限。如果想查看可用标志，请使用已安装 CLI 的帮助信息或命令参考。

3. 选择正确的账户路径

codex login会启动账户登录流程。完成登录前，请检查浏览器账户和工作区。若要直接使用 OpenAI API 计费，文档所述的替代方式支持通过标准输入提供 Platform 密钥：

可选：OpenAI Platform API 身份验证

# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-key

此 API 命令适用于 OpenAI Platform 密钥，不是第三方网关的完整设置。自定义提供商需要自己的配置、端点、凭据来源和受支持模型。身份验证文档解释了各条路径，而我们的 Codex API 密钥指南介绍了更深入的提供商设置。

4. 将首次响应转化为有用的第一个任务

询问相关源代码和测试位于何处，然后根据代码仓库检查答案。
选择一项小改动，并说明其预期行为。
使用干净的分支或检查点，并选择与该改动相匹配的权限。
让 Codex 运行相关检查，然后审查它的差异和说明。

例如，从一个失败的测试或小型文档修复开始。避免把第一次任务设为重写整个应用：安装、凭据、本地依赖和任务质量都将难以同时评估。短流程运行正常后，再添加项目说明并扩大范围。

如果设置中断，请修复对应层

“找不到命令”指向安装或 PATH。“401”指向身份验证。模型错误指向所选提供商和模型。限制警告指向用量或计费。保留已经正常工作的层，并视情况参阅401 检查清单或用量限制指南；重新安装可执行文件不会补充账户余额。

要评估 Kunavo 是否适合本地 Codex 工作，请创建账户并按照Codex 集成指南操作。它使用兼容 Responses 的提供商配置。在为大型项目采用新的计费路径前，请先验证一个小任务。

常见问题

如何安装 Codex CLI？

使用适用于您操作系统的官方独立安装程序，或选择 npm 或 Homebrew 方案。如有需要，请打开新终端，运行 codex --version 进行检查，然后从项目目录启动 Codex 并选择身份验证方式。

仍支持 npm install -g @openai/codex 吗？

支持。2026 年 9 月 17 日核验的官方安装文档将 npm 与独立安装程序和 Homebrew 并列。请选择一种安装方式，并沿用该方式的更新路径，以避免出现相互冲突的副本。

安装 Codex 需要 ChatGPT 订阅吗？

安装与模型访问是两件不同的事。对于受支持的本地工作，请选择可用的 ChatGPT 登录方式，或选择单独计费的 API 访问。在决定如何付款前，请查看当前账户选项；安装 CLI 不会增加模型额度。

可以在 Windows 上安装 Codex 吗？

可以。OpenAI 提供 Windows 独立安装程序。如果您选择在 WSL 中工作，请在该环境内安装并运行 Linux 版本，并注意其独立的项目路径和环境变量。

官方安装文档和本地 CLI 帮助信息已于 2026 年 9 月 17 日核验。