Skip to content

Codex CLI 一键配置安装

公共 codex.sh 支持 macOS、Linux 和 Windows WSL。它按需准备 Node.js 22、安装官方 @openai/codex,再安全合并 Codex 配置。Windows 原生 PowerShell 暂无对应资产,推荐使用 WSL;已装好 Node/npm 的 Git Bash 也可执行 Bash 命令,但上游安装器兼容性以 WSL 为准。 纯 PowerShell 可按 Windows 手动安装 操作。

运行前准备

aitongdao.com 创建 codex 分组令牌,并确认账户余额可用。 下面的交互命令省略 Key,脚本运行时会从终端安全读取,不会回显到屏幕或写入命令历史。

运行 installer

bash
curl -fsSL https://gh.auranaiss-dev.com/ding-rs/ai-cli-installers/releases/latest/download/codex.sh \
  | bash -s -- --endpoint https://ai.aitongdao.com/v1 --model gpt-5.6-sol

如果检测到已有 codex 命令,脚本会询问是否重装或更新。选择否只跳过 npm 安装,配置仍会 更新;选择是会重新安装最新官方包。

脚本会修改什么

  • 当前 Node.js 不满足 22+ 时,通过官方 nvm v0.40.3 安装 Node.js 22。
  • 需要安装或重装时执行 npm install --global @openai/codex
  • 合并 ~/.codex/config.toml,写入 model = "gpt-5.6-sol"、自定义 provider 和精确 base_url = "https://ai.aitongdao.com/v1"
  • 合并 ~/.codex/auth.json,并在 shell rc 的受管区块写入 OPENAI_API_KEY
  • 修改已有文件前创建带编号的 .ai-cli-installers.bak 私有备份;配置失败时尝试自动回滚。

验证

重新打开终端,然后运行:

bash
codex --version
codex

Codex 使用 OpenAI 兼容协议,endpoint 必须包含 /v1。如果首次调用返回 401,检查 Key 是否 复制完整、令牌是否属于 codex 分组;如果模型不可用,以站内当前可用模型为准重新运行脚本并 修改 --model

自动化调用

无人值守环境不要把 Key 放在命令行参数中。由 secret store 注入环境变量后再执行下载到临时 文件的 installer:

bash
installer=$(mktemp)
trap 'rm -f "$installer"' EXIT
curl -fsSL https://gh.auranaiss-dev.com/ding-rs/ai-cli-installers/releases/latest/download/codex.sh -o "$installer"
AI_ENDPOINT=https://ai.aitongdao.com/v1 AI_API_KEY="$AI_API_KEY" AI_INSTALL_YES=1 \
  bash "$installer" --model gpt-5.6-sol

AI_INSTALL_YES=1 表示无人值守:缺少工具时安装,已有工具时跳过重装,但仍更新配置;必需参数 缺失会直接失败,不会等待交互输入。

AI通道 · 让国内开发者直连全球 AI 模型