安装 Codex

把 Codex 装进电脑。出错弄不坏机器，删掉重来就行。

装完之后，电脑里多了什么？

三样：底座、本体、一个黑窗口。

🧱Node.jsCodex 靠它跑

→

🤖Codex真正干活的那个

→

⌨️Git BashWindows 上的入口
Mac 用自带终端

→

✅报得出版本号就是装好了

两条路，先选一条

✓ 省事路 · 双击 install.bat

有公司发的 codex 文件夹就走这条。3–5 分钟全自动，只粘一次密钥。

⌨ 手动路 · 自己一步步装

没那个文件夹、用 Mac、脚本跑失败，走这条。15 分钟。

两条路装的是同一个 Codex。

省事路 · 双击 install.bat

脚本一次装完 Node.js、Git、Visual C++ 运行库和 Codex 本体，写好配置和密钥，再装上 Word / Excel / PPT / PDF 技能包。

✕ 只把 .bat 拷到桌面

脚本要在同一个文件夹里找 Node.js 和 Git 的安装包，找不到就退出。

✓ 整个文件夹一起拷

放一块儿双击，就一路装到底。

右键 install.bat → 以管理员身份运行

要往系统目录写文件，得给管理员权限。系统问"是否允许此应用对你的设备进行更改"，点是。
粘贴 API Key，回车

看到"请粘贴 OpenAI API Key"就把 sk-xxxxxxxx（找管理员要） 粘进去。全程只有这一步要动手。密钥会明文显示，正常，注意别被人拍到。
等 3–5 分钟，别关窗口

进度从 [1/6] 走到 [6/6]。中途的 Windows 安全提示一律点是，别按 Ctrl + C 打断。
看到"全部安装完成"，把窗口关掉

这步不能省：新装的程序要新开窗口才被认出来。老窗口里敲 codex 会说"不是内部或外部命令"，那不是没装上。
新开一个窗口验证

按 Win + R，输入 cmd 回车，弹出的黑窗口就是命令行。敲：
```
codex --version
```
报出版本号就成了。写文档时最新 0.153.4，更大很正常。

配置可能过时

脚本会把那份 config.toml 抄到 %USERPROFILE%\.codex\。它发出来有一阵子了，有几处已经过时，装完翻到下一页配置文件对一遍。

手动路 · 自己一步步装

官方给了四种装法，装出来是同一个东西：

平台	命令
任意系统（电脑上已经有 Node.js）	`npm install -g @openai/codex`
macOS · 用 Homebrew	`brew install --cask codex`
macOS / Linux 一键	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`
Windows PowerShell 一键	`irm https://chatgpt.com/codex/install.ps1 \| iex`

熟命令行的挑一条跑。下面走最稳的 Node + npm（装 Node.js 时自带）。

装 Node.js

没它 codex 这条命令就无效。打开 https://nodejs.org 下载标着 LTS 的包，不用管版本号。

一路 Next；中间那项 "Automatically install the necessary tools…" 取消勾选。装完敲 node -v，有版本号就成了。
装 Git

为的是自带的 Git Bash：在任意文件夹右键就能打开，是以后每天用 Codex 的入口。去 https://git-scm.com 下载，十几页选项全部默认一路 Next。
装 Visual C++ 运行库

最容易被跳过的一步，后果见下一节。微软官方地址 https://aka.ms/vs/17/release/vc_redist.x64.exe（约 25 MB），双击一路 Next，装完重启电脑。
装 Codex 本体

按 Win + R 输入 cmd，整行粘贴回车：
```
npm install -g @openai/codex
```
-g 是"全局安装"，装完在任何文件夹都能敲 codex。会滚一堆日志，别关，不再滚动就是装完了。

打开"终端"

Mac 上的黑窗口叫"终端"。按 Command + 空格，输入"终端"或 Terminal 回车。
装 Codex（两条挑一条）

装过 Homebrew（Mac 上常用的软件管家）用这条：
```
brew install --cask codex
```
没装过就用官方一键脚本：
```
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
验证

敲 codex --version，有版本号就好了。Mac 不需要 Visual C++ 那步，那是 Windows 专有的。

手动路少一样东西

一键脚本会顺手装上 Word / Excel / PPT / PDF 技能包，手动装不会。不补就只会聊天、动不了你的文件，去文档处理技能装。

Windows 上最容易踩的三个坑

一、敲 codex --version 完全没反应

✕ 症状：什么都不显示

不报错也不提示，光标直接跳下一行；桌面版一闪而过。看着像没装上，其实早装上了 —— 只是启动时缺几个 Windows 系统库，被系统悄悄关掉。

✓ 解法：补运行库，一次终身有效

装微软官方的 https://aka.ms/vs/17/release/vc_redist.x64.exe（约 25 MB），一路 Next。装完必须重启电脑，不重启不生效；重启后新开 cmd 再敲一次就有版本号。

二、PowerShell 里跑 npm 报"禁止运行脚本"

报错原文是 无法加载文件 npm.ps1，因为在此系统上禁止运行脚本。PowerShell 默认不许跑脚本，而 npm 恰好是脚本。这是 Windows 的安全设置，不是 Codex 的问题。

最稳的解法是别用 PowerShell：改用 cmd（Win + R → cmd）或 Git Bash，本页命令都不会被拦。非用不可就执行这条放开限制，回车输入 Y 确认：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

三、右键菜单里找不到 Open Git Bash here

Windows 11 把它折叠了：右键后点最下面的显示更多选项，或直接 Shift + 右键。展开了还没有就是 Git 没装上，重装一遍。

怎么确认真的装好了

新开一个 cmd 或 Git Bash 窗口，敲：

codex --version

有版本号就成了。想让它自己体检：

codex doctor

它会把安装、配置、登录和运行状态挨个查一遍，告诉你哪项不对 —— 出任何毛病先跑它，更多症状见出错了怎么办。

怎么升级

Codex 更新很勤，隔段时间升一次。Windows / Mac 通用：

codex update

当初用 npm 装的，重跑 npm install -g @openai/codex 也能升，只是慢些。

装乱了，想彻底重来

1卸掉本体当初用 npm 装的
才要这步

→

2删配置文件夹密钥也在里面
删了要重新要

→

3重装一遍两条路任选

第一步只有当初用 npm install 装的才做：

npm uninstall -g @openai/codex

Homebrew 或一键脚本装的跳过这条，做完第二步重跑当初那条命令。

第二步删配置文件夹。Windows：资源管理器地址栏输入 %USERPROFILE% 回车，把 .codex 整个删掉（点开头的文件夹默认隐藏，勾上"查看 → 显示 → 隐藏的项目"就出来）。

Mac：访达点前往 → 前往文件夹，输入 ~/.codex，拖进废纸篓。

装完了，下一步是填配置

Codex 能启动了，但还不知道用哪个模型、拿什么密钥 —— 这两件事写在两个小文件里，下一页配置文件带你填好。拿到桌面版的同事也一样：它最终调用的还是这里装好的 codex。