安装 Codex
这一页只做一件事：把 Codex 装进你的电脑。有两条路 —— 有公司发的一键脚本就双击了事；没有脚本或者用 Mac，自己一步步来也不难。中途出错不会弄坏电脑，删掉重来一遍就行。
两条路，先选一条
| 你的情况 | 走哪条 | 大概多久 |
|---|---|---|
手上有公司发的 codex 文件夹，里面有 install.bat |
省事路 · 双击脚本 | 3–5 分钟，全自动 |
| 没有那个文件夹，或者你用的是 Mac | 手动路 · 自己一步步装 | 15 分钟左右 |
两条路装出来的是同一个 Codex，选哪条都行。
省事路 · 双击 install.bat
为什么省事：脚本会按顺序一次装完 —— Node.js（Codex 的运行环境）、Git、Visual C++ 运行库、Codex 本体，再帮你写好配置文件和密钥，最后装上处理 Word / Excel / PPT / PDF 的技能包。全程只需要你粘贴一次 API Key（一串字符，相当于公司发给你的通行证，Codex 靠它证明这次调用是公司授权的）。
脚本会去同一个文件夹里找 Node.js 和 Git 的安装包。只把这个 .bat 单独拷到桌面运行，它会提示"找不到安装包"然后退出。
- 找到 install.bat，右键 → 以管理员身份运行
装 Node.js 和 Git 要往系统目录里写文件，需要管理员权限。直接双击也行，脚本会自己弹出提权窗口，只是右键更省一步。系统问"是否允许此应用对你的设备进行更改"，点是。
- 粘贴 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 这条最稳的路走（npm 是装 Node.js 时自带的软件安装工具，不用另外装）。
- 装 Node.js
为什么要它：Node.js 是 Codex 的"翻译官"，没有它
codex这条命令就无效。打开 https://nodejs.org，下载标着 LTS（长期支持版）的那个安装包 —— 认准 LTS 就行，不用管版本号。双击，一路 Next 保持默认。中间有一项 "Automatically install the necessary tools…"（自动安装额外工具）取消勾选，我们用不到。装完按
Win + R输入cmd回车，敲node -v，能看到版本号就说明成了。 - 装 Git
为什么要它：Git 自带一个叫 Git Bash 的窗口，比 cmd 好用，装完能在任意文件夹空白处右键直接打开 —— 这是以后每天用 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 的技能包，手动路不会。想让 Codex 帮你改文档，装完之后还要去文档处理技能那页补上，否则它只会跟你聊天，动不了你的文件。
Windows 上最容易踩的三个坑
一、敲 codex --version 完全没反应
症状很有迷惑性：命令敲下去什么都不显示，不报错也不提示，光标直接跳到下一行；桌面版则是一闪而过。看着像"没装上"，其实已经装上了 —— 只是 Codex 启动时找不到几个 Windows 系统库，被系统悄悄关掉了。
修法（装一次，终身有效）：浏览器打开微软官方地址 https://aka.ms/vs/17/release/vc_redist.x64.exe，下载约 25 MB 的安装包，双击一路 Next。装完必须重启电脑 —— 不重启系统库不生效，你会以为白装了。重启后新开 cmd 再敲一次 codex --version，版本号就出来了。
二、PowerShell 里跑 npm 报"禁止运行脚本"
报错原文是：无法加载文件 npm.ps1，因为在此系统上禁止运行脚本。PowerShell 默认不许运行脚本，而 Windows 上的 npm 恰好就是个脚本，于是被拦下了。这是 Windows 自己的安全设置，不是 Codex 的问题。
最稳的解法是别用 PowerShell —— 改用 cmd（Win + R → 输入 cmd）或者 Git Bash，本页所有命令在这两个窗口里都不会被拦。如果你就是想用 PowerShell，执行下面这条把限制放开，回车后输入 Y 确认：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned三、右键菜单里找不到 Open Git Bash here
Windows 11 默认把它折叠了。在文件夹空白处右键后，点菜单最下面的显示更多选项就能看到；或者直接按 Shift + 右键，一步到位。展开了还是没有，那就是 Git 没装上，重装一遍 Git 就行。
怎么确认真的装好了
新开一个 cmd 或 Git Bash 窗口，敲这一行：
codex --version能看到版本号就成了。如果想让它自己体检一遍，还可以敲：
codex doctor这条命令会把本地的安装、配置、登录和运行状态挨个检查一遍，然后告诉你哪一项不对。以后遇到任何毛病，先跑它，比自己瞎试快得多。更多症状对照见出错了怎么办。
怎么升级
Codex 更新很勤，隔段时间升一次就行。这条命令 Windows 和 Mac 通用，在任意窗口里敲：
codex update如果你当初是用 npm 装的，重新跑一遍 npm install -g @openai/codex 也能升到最新版，只是慢一点。
装乱了，想彻底重来
删干净重装一遍就行，弄不坏电脑。两步：
第一步，卸掉 Codex 本体。当初用 npm install 装的跑这条：
npm uninstall -g @openai/codex用 Homebrew 或者官方一键脚本装的同事跳过这条 —— 直接做第二步，然后重新跑一遍你当初用的那条安装命令。
第二步，删掉配置文件夹。Windows 在资源管理器地址栏输入 %USERPROFILE% 回车，找到里面的 .codex 文件夹整个删掉（看不到它是因为以点开头的文件夹默认隐藏，在"查看 → 显示 → 隐藏的项目"上打个勾就出来了）。Mac 在访达点前往 → 前往文件夹，输入 ~/.codex 回车，把这个文件夹拖进废纸篓。
API Key 和模型配置都存在这个文件夹里。删了之后要重新找管理员要一次 key，再照配置页填一遍 —— 不是什么大事，但先确认真有必要再删。
Codex 现在能启动了，但它还不知道该用哪个模型、拿什么密钥去访问。这两件事写在两个小文件里，下一页配置文件会带你填好。有的同事拿到的文件夹里还带一个桌面版程序，它最终调用的还是这里装好的命令行 codex，所以本页的步骤一步都不能省。