Codex CLI 一键配置安装

我们提供的一键脚本覆盖了安装、线路配置与环境变量写入的全流程。在 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://static.aitongdao.com/codex.sh | bash

脚本是非交互式的，无需选择菜单，会自动按顺序跑完整流程：显示环境与平台 → 检测并（必要时经 nvm）安装 Node 22 → 用 npm 安装 @openai/codex（镜像竞速回退）→ 提示输入 API Key（输入以星号遮盖）→ 写入配置。中途仅在需要安装/覆盖时询问确认。

2. 这个脚本会做什么

2.1 安装 Codex CLI

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

2.2 配置 API Key 和线路

脚本会提示你输入 API Key（输入过程以星号遮盖），读取后直接写入配置（不在安装阶段对 Key 做联网校验）。

2.3 写入到哪里

脚本会把 OPENAI_API_KEY 导出到 shell 配置里（Codex 0.118+ 只从该环境变量读 Key）：

export OPENAI_API_KEY="sk-xxxxxxxx..."

根据你当前 shell，写入位置可能是 ~/.bashrc、~/.zshrc 或 ~/.profile（存在哪个写哪个）。

base_url 不走环境变量，而是写进 ~/.codex/config.toml 的 [model_providers.<key>] 段（base_url = "https://ai.aitongdao.com/v1"）。

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

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

4. 安装完成后怎么用

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

codex --version
echo "$OPENAI_API_KEY"
cat ~/.codex/config.toml

确认版本号、OPENAI_API_KEY 已生效、config.toml 里的 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。

运行 codex 时返回 401

脚本在安装阶段不校验 Key，401 通常在首次调用时才暴露。检查两点：一是密钥本身是否复制完整，二是创建令牌时是否选择了 codex 分组（其他分组可能不包含 GPT 模型池）。

运行 codex 报 Missing environment variable: OPENAI_API_KEY

Codex 0.118+ 只读环境变量，请确认已重开终端让 export OPENAI_API_KEY 生效（或先 source ~/.bashrc / source ~/.zshrc）。