安装 OpenAI Codex CLI
OpenAI 的本地编码代理,用 ChatGPT 账号登录即可。两种装法、Mac 与 Windows 步骤,以及它和 Claude Code 的定位差别。
- 出处
- Codex CLI 官方文档
- 来自
- OpenAI
- 查证日期
- 2026/08/04
Codex CLI 是 OpenAI 的本地代理工具,跑在你自己电脑上,用 ChatGPT 账号登录。定位跟 Claude Code 接近:给它一个目录,它读文件、改文件、跑命令。
装它的理由通常有两个:手上已经有 ChatGPT 订阅,或者想拿两个工具在同一个任务上做个对照。
开始之前
- 账号:ChatGPT 账号(具体哪些订阅档位包含,以 OpenAI 官方说明为准)
- Node.js:走 npm 安装的话需要 16 以上
- 系统:macOS、Linux、Windows
装法一:官方脚本(Mac / Linux)
打开终端:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
装法二:npm(跨平台)
Mac、Linux、Windows 都能用,前提是装了 Node.js:
npm install -g @openai/codex
没装 Node.js 的话:
- Mac:
brew install node,或去 https://nodejs.org 下载安装包 - Windows:
winget install OpenJS.NodeJS,或去 https://nodejs.org 下载
不要用
sudo npm install -g。 它会把文件装到系统目录并留下权限问题,后面更新会更麻烦。遇到权限报错应该改 npm 的全局目录,而不是加 sudo。
验证
codex --version
能打印版本号就装好了。
登录
codex
首次启动会让你选登录方式,选 Sign in with ChatGPT,浏览器完成授权后回到终端。
和 Claude Code 的区别
两者形态很像——都是终端里的代理,都能读写本地文件、执行命令。真正的差别在于:
账号体系不同。 Codex 用 ChatGPT 订阅,Claude Code 用 Claude 订阅。想用哪个,取决于你手上有哪个。
模型不同。 底层是各家自己的模型,同一个任务给出的结果和风格会有明显差异。
如果你两个都有,一个务实的用法是:让它们做同一件事,比对结果。尤其是那种「我不确定这么做对不对」的任务——两个不同的模型给出一致的结论,比一个模型给出的结论可信得多。这在做资料核查、方案评估时很有用。
一个提醒
两个工具都能直接改你的文件。第一次用的时候,在一个复制出来的目录里跑,或者先把工作目录纳入版本管理(比如 Git),这样任何改动都能回滚。
这不是对某个工具的不信任,是对「代理会自主动手」这件事的基本纪律。