Codex 一键配置安装教程
0. 前置：先安装 Node.js
一键配置脚本会自动安装 Codex CLI，但前提仍然是你的电脑已经装好 Node.js 和 npm。
Codex 对 Node.js 版本要求更高，建议直接使用 Node.js 22+。
先装 Node.js：
- macOS：Nodejs macOS
- Linux：Nodejs Linux
- Windows：Nodejs Windows
验证安装：分别执行下面两个命令
node -vnpm -v如果看到版本号，说明 Node.js 安装成功了。
1. 运行一键配置命令
第一步：打开终端
- macOS：打开
Terminal - Linux：打开你常用的终端
- Windows：请使用
Git Bash、MSYS2或WSL终端运行下面命令，不要直接在cmd里执行
第二步：执行一键配置命令
curl -sSL https://sh.ci-yuan-ai.com/codex.sh | bash脚本启动后会显示菜单，你可以按提示选择：
1只安装 Codex CLI2只配置 API Key 和线路3一键全部安装（推荐）
如果你是第一次安装，直接选 3 即可。
2. 这个脚本会做什么
2.1 安装 Codex CLI
脚本会先检查你的电脑里有没有 npm。
如果没有 npm，脚本会提示你先安装 Node.js。
然后它还会检查你的 Node.js 主版本号：
- 如果低于
22，脚本会提醒你 Codex CLI 建议使用Node.js 22+ - 你可以选择继续安装，也可以先升级 Node.js 再回来执行
安装时脚本会执行：
npm install -g @openai/codex如果默认 npm 源安装失败，脚本会自动切换到国内 npm 镜像继续安装。
如果你之前已经装过 Codex CLI，脚本会先检测版本，并询问你是否重新安装。
2.2 配置 API Key 和线路
脚本会引导你完成下面几件事：
- 选择 API 线路
- 输入你的闪电 API Key
- 自动验证这个 Key 是否能正常获取模型列表
- 把配置写入 Shell 环境变量
你可以选择两条线路：
https://api.ci-yuan-ai.com：国内直连，适合中国大陆用户https://cdn.ci-yuan-ai.com：海外 CDN，适合海外网络环境
脚本最终保存的是这两个环境变量：
OPENAI_API_KEYOPENAI_BASE_URL
其中 OPENAI_BASE_URL 会写成带 /v1 的完整地址，例如：
https://api.ci-yuan-ai.com/v12.3 写入到哪里
脚本会自动识别你正在使用的 Shell，并把环境变量写入对应配置文件。
常见情况如下：
- macOS：通常写入
~/.zshrc - Linux：通常写入
~/.bashrc或~/.zshrc - Windows Git Bash：通常写入
~/.bashrc
如果机器上已经存在多个 Shell 配置文件，脚本也会一并写入，避免你换终端后配置失效。
3. 使用前你还需要准备什么
在运行一键配置前，请先准备好下面两样：
- 一个可用的闪电 API Key
- 你已经在
ai.ci-yuan-ai.com后台创建好对应的令牌分组
脚本本身也会提示你：如果没有先创建令牌分组，可能拿不到模型列表。
4. 安装完成后怎么用
脚本执行完成后，建议你关闭当前终端，再重新打开一个新的终端窗口。
然后先验证：
codex --version你也可以顺手检查环境变量：
echo "$OPENAI_BASE_URL"应该显示类似：
https://api.ci-yuan-ai.com/v1然后进入你的项目目录启动 Codex：
cd /path/to/your/project
codex把 /path/to/your/project 替换成你的实际项目路径。
常见问题
1. 一键脚本提示未找到 npm
原因：你的机器还没有安装 Node.js，或者终端还没加载到 npm。
解决方法：
- 先按你的系统安装 Node.js
- 重新打开一个新的终端窗口
- 先执行
node -v和npm -v - 确认正常后，再重新运行一键脚本
2. Node.js 版本低于 22，还能装吗？
可以，脚本会先给你提示，然后询问你是否继续。
但更推荐直接升级到 Node.js 22+，这样和 Codex CLI 的要求更一致，后面也更省事。
3. Windows 为什么不能直接用 PowerShell 跑这条命令？
这条命令本质上是把远程 bash 脚本交给本地 bash 执行，所以 Windows 需要有 Bash 环境。
推荐三种方式：
- 使用 Git Bash
- 使用 WSL
- 使用 MSYS2
如果你更想在 PowerShell 里手动配置，可以改看 Codex Windows。
4. 脚本执行完后，codex 还是找不到
原因：新的 PATH 或环境变量还没有在当前终端里生效。
解决方法：
- 先关闭当前终端
- 再打开一个新的终端窗口
- 重新执行
codex --version
如果还是不行，再重新运行一次脚本，选择 1 或 3。
5. API Key 验证失败，还能继续保存吗？
可以。脚本在验证失败时会再次询问你是否仍然保存配置。
但更推荐先检查：
- API Key 是否复制完整
- 令牌分组是否已经创建
- 你选择的线路是否适合当前网络环境