Codex CLI 怎么安装？Windows / macOS 完整步骤

Codex 的图形界面能用，但真正提效是在命令行里——它可以直接读你项目的文件、跑测试、改完再验证。这篇是零基础到跑通第一条命令的完整流程。

前置条件：Node 环境

Codex CLI 是 Node 包，所以第一步是把 Node 装好。版本建议 20 以上，低于 18 会有兼容问题。

装完在终端里跑 node -v 和 npm -v 确认两个都有输出。Windows 上如果提示「不是内部或外部命令」，说明 PATH 没配好，重新安装时勾选「Add to PATH」，或者手动把 Node 的安装目录加进环境变量。

安装与首次登录

环境就绪后，命令很短：

• 全局安装：npm install -g @openai/codex（或者用你习惯的包管理器，注意全局目录权限）。
• macOS / Linux 权限报错时在命令前加 sudo，或者配置 npm 的全局目录到用户目录下，避免动系统目录。
• 在项目根目录执行 codex，首次会要求登录。用你订阅的账户完成授权，成功后会在本地写入凭证文件。
• 验证：随便问一句话，能正常返回就说明链路通了。

Windows 上的三个常见坑

Windows 用户踩的坑最集中，先看这几个：

• 坑一：PowerShell 执行策略拦截。用管理员身份打开 PowerShell，把执行策略设为 RemoteSigned，再重试。
• 坑二：路径里有中文或空格。项目尽量放在纯英文短路径下，比如 D:\code\demo，避免奇怪的编码错误。
• 坑三：终端编码导致的乱码。把终端切到 UTF-8，或者在启动前设置编码环境变量。

第一次使用建议这样跑

别一上来就让它改整个项目。推荐从只读任务开始：让它解释某个文件的逻辑、找出潜在 bug、列出重构建议。

确认它的理解没问题之后，再让它做「改一个函数 + 跑测试」这种小闭环。信任是逐步建立的，尤其它会直接改你的文件。

重要项目先提交一次 git，让它改坏了你能一键回滚。这一步千万别省。