Codex CLI 一键配置安装

我们提供的一键脚本覆盖了安装、线路选择、Key 校验与环境变量写入的全流程。在 macOS、Linux、Windows（Git Bash/WSL）三类环境下都能运行。

0. 前置：先安装 Node.js

Codex CLI 要求 Node.js 22 及以上版本。在终端中检查：

node -v
npm -v

如果尚未安装或版本低于 22，请先参考 Node.js 安装指南，或从 nodejs.org 下载。

1. 运行一键配置命令

在终端执行：

curl -sSL https://sh.aitongdao.com/codex.sh | bash

脚本会先显示当前环境状态（系统类型、Codex 是否已装、API 是否已配），然后弹出菜单：

1) 安装 Codex CLI
2) 配置 API 密钥和线路
3) 一键全部安装（安装 + 配置）
0) 退出

首次使用选择 3 即可一步到位。

2. 这个脚本会做什么

2.1 安装 Codex CLI

脚本会调用 npm install -g @openai/codex。若默认 registry 失败，会自动切换到 registry.npmmirror.com 重试。安装结束后运行 codex --version 验证。

2.2 配置 API Key 和线路

脚本会提示你输入 API Key（输入过程以星号遮盖），然后用这个 Key 访问 /v1/models 做一次 HTTP 探测：

• 返回 200：Key 有效，继续写入。
• 返回 401：Key 无效或分组错误，会询问是否仍然保存。
• 无法连通：提示网络问题。

2.3 写入到哪里

脚本会把两个环境变量写到 shell 配置里：

export OPENAI_API_KEY="sk-xxxxxxxx..."
export OPENAI_BASE_URL="https://ai.aitongdao.com/v1"

根据你当前 shell，写入位置可能是：

• macOS 默认 zsh：~/.zshrc
• Linux / Git Bash：~/.bashrc、~/.bash_profile 或 ~/.profile
• Windows（非 WSL）：同时会调用 setx 写入用户级环境变量

3. 使用前你还需要准备什么

• 在 aitongdao.com 创建令牌：登录后在「令牌」菜单新建，分组选 codex，提交后得到 sk- 开头的密钥。
• 确认钱包有余额：余额不足时模型调用会返回错误。

4. 安装完成后怎么用

重新打开一个终端窗口（确保新环境变量生效），然后：

codex --version
echo "$OPENAI_BASE_URL"

确认版本和 Base URL 都正确，就可以进入项目目录启动：

cd your-project
codex

常见问题

npm 未找到

说明 Node.js 没装好或没有进入 PATH。先安装 Node.js 22+ 再重跑脚本。

Node 版本低于 22

脚本会警告并询问是否继续。建议升级后再装，低版本 Codex 可能无法启动。可通过 nvm、fnm 或官网安装包升级。

Windows PowerShell 提示不识别 curl -sSL | bash

PowerShell 不支持 bash 管道语法。请在 Windows 上使用 Git Bash 或 WSL2 运行该脚本。PowerShell 原生路径见 Windows 手动安装。

codex 命令找不到

重新打开终端窗口让 PATH 生效。若仍找不到，执行 npm bin -g 查看全局 bin 目录，把它加入 PATH。

Key 验证失败（401）

检查两点：一是密钥本身是否复制完整，二是创建令牌时是否选择了 codex 分组（其他分组可能不包含 GPT 模型池）。