OpenAI官方推出的Codex CLI，正在成为开发者终端里的新宠。它让你无需离开命令行，就能直接调用GPT模型完成代码生成、解释、重构等任务。然而，不少人在安装配置环节就被卡住——尤其是跨平台环境下的各种细节。本文将用一套完整的流程，带你一次性搞定Windows、macOS、Linux上的Codex CLI部署。
一、安装前的环境检查
Codex CLI基于Node.js运行，因此第一步是确保你的机器具备正确的Node环境。官方要求Node.js版本不低于16，但为了稳定性和兼容性，强烈建议使用LTS版本（18或20）。你可以先打开终端，执行node --version和npm --version确认版本。如果命令不存在，请前往nodejs.org下载对应系统的LTS安装包。Windows用户安装时务必勾选“添加到PATH”选项，否则后续无法直接调用npm命令。
这里要特别提醒：很多安装失败的案例，根源都是Node版本过旧。不要抱有侥幸心理，直接用LTS版本能避免绝大多数坑。
二、三大平台安装步骤详解
Windows平台：下载Node.js的.msi安装包，按默认设置完成安装后，重新打开PowerShell或CMD。执行npm install -g @openai/codex进行全局安装。安装完成后，输入codex --version验证是否成功。
macOS平台：有两种方式可选。第一种是通用的npm安装：npm install -g @openai/codex。第二种是使用Homebrew：brew install --cask codex。推荐优先使用npm方式，因为Homebrew的cask版本有时更新不及时。安装后运行which codex确认路径。
Linux平台：以Ubuntu/Debian/CentOS/Fedora/Arch为例，先确认Node.js与npm已安装，然后执行与Windows相同的npm全局安装命令。验证方式同样是codex --version。需要注意的是，部分Linux发行版可能需要sudo权限，建议根据实际环境调整。
npm方式之所以成为跨平台首选，是因为它屏蔽了系统差异，一条命令走天下。对于多设备开发者来说，这无疑是最省心的方案。
三、认证登录：ChatGPT账号与API Key
安装完成后，需要完成身份认证才能开始使用。Codex CLI提供两种登录方式，你可以根据使用场景自由选择。
方式A：ChatGPT账号登录（推荐）。直接运行codex命令，在交互界面选择“Sign in with ChatGPT”，按提示完成浏览器授权即可。目前免费账号也能使用Codex，只是存在每周限额。这种方式适合已有ChatGPT Plus/Pro/Team等账号的用户，无需手动管理密钥。
方式B：API Key登录。如果你更习惯通过API调用，可以使用codex login --with-api-key命令。Windows PowerShell下执行：$env:OPENAI_API_KEY = "sk-xxxxxxxx"; $env:OPENAI_API_KEY | codex login --with-api-key。macOS/Linux下执行：export OPENAI_API_KEY="sk-xxxxxxxx"; printenv OPENAI_API_KEY | codex login --with-api-key。输入后可用codex login status检查登录状态。
需要提醒的是，API Key相当于你的资金账户，切勿硬编码在脚本或提交到公共仓库。建议使用环境变量或密钥管理工具来保护它。
四、配置优化与实战验证
Codex CLI的配置文件位于%USERPROFILE%\.codex\config.toml（Windows）或~/.codex/config.toml（macOS/Linux）。一个最小可用的配置示例如下：
model = "gpt-5.3-codex"
model_reasoning_effort = "xhigh"
[projects."/path/to/your/project"]
trust_level = "trusted"
[tui]
status_line = ["model-with-reasoning", "current-dir", "git-branch", "codex-version"]其中，model可以根据你的账号权限调整；projects节可以将常用目录设为默认信任，避免每次询问；tui节则定制了底部状态栏的显示信息。修改配置后，建议重启终端再测试。
最后一步是实战验证。进入你的项目目录，运行codex，在交互界面输入“请自我介绍一下”。如果看到模型回复，恭喜你，Codex CLI已经可以正常工作了。接下来，你就能在终端里尽情享受AI编程带来的效率提升。