安装 OpenAI Codex CLI

OpenAI 的本地编码代理,用 ChatGPT 账号登录即可。两种装法、Mac 与 Windows 步骤,以及它和 Claude Code 的定位差别。

2026/08/04约 4 分钟HiBridge 原创
方法来源本文由 HiBridge 撰写,方法来自下面的出处。
出处
Codex CLI 官方文档
来自
OpenAI
查证日期
2026/08/04

Codex CLI 是 OpenAI 的本地代理工具,跑在你自己电脑上,用 ChatGPT 账号登录。定位跟 Claude Code 接近:给它一个目录,它读文件、改文件、跑命令。

装它的理由通常有两个:手上已经有 ChatGPT 订阅,或者想拿两个工具在同一个任务上做个对照。

开始之前

  • 账号:ChatGPT 账号(具体哪些订阅档位包含,以 OpenAI 官方说明为准)
  • Node.js:走 npm 安装的话需要 16 以上
  • 系统:macOS、Linux、Windows

装法一:官方脚本(Mac / Linux)

打开终端:

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

装法二:npm(跨平台)

Mac、Linux、Windows 都能用,前提是装了 Node.js:

Terminal
npm install -g @openai/codex

没装 Node.js 的话:

不要用 sudo npm install -g 它会把文件装到系统目录并留下权限问题,后面更新会更麻烦。遇到权限报错应该改 npm 的全局目录,而不是加 sudo。

验证

Terminal
codex --version

能打印版本号就装好了。

登录

Terminal
codex

首次启动会让你选登录方式,选 Sign in with ChatGPT,浏览器完成授权后回到终端。

和 Claude Code 的区别

两者形态很像——都是终端里的代理,都能读写本地文件、执行命令。真正的差别在于:

账号体系不同。 Codex 用 ChatGPT 订阅,Claude Code 用 Claude 订阅。想用哪个,取决于你手上有哪个。

模型不同。 底层是各家自己的模型,同一个任务给出的结果和风格会有明显差异。

如果你两个都有,一个务实的用法是:让它们做同一件事,比对结果。尤其是那种「我不确定这么做对不对」的任务——两个不同的模型给出一致的结论,比一个模型给出的结论可信得多。这在做资料核查、方案评估时很有用。

一个提醒

两个工具都能直接改你的文件。第一次用的时候,在一个复制出来的目录里跑,或者先把工作目录纳入版本管理(比如 Git),这样任何改动都能回滚。

这不是对某个工具的不信任,是对「代理会自主动手」这件事的基本纪律。