Codex CLI 接入指南

Codex CLI 是 OpenAI 官方发布的命令行编程助手，基于 GPT-5 系列模型运行。本页汇总在 AI通道上使用 Codex CLI 的准备工作与安装路径，帮助你快速跑通第一次调用。

开始前需要准备

使用前请确认以下几项：

• Node.js 22 或更高版本：Codex CLI 以 npm 包形式分发，对 Node 版本有硬性要求。
• AI通道 API Key：登录 aitongdao.com 后在「令牌」菜单创建，密钥以 sk- 开头。
• 推荐使用 codex 分组：该分组针对 GPT 全系模型做了倍率优化，是 Codex CLI 的最佳搭配。
• 钱包余额：API Key 需要所属账户有余额才能调用。

推荐路径：一键脚本

如果你只是想最快速度把环境跑起来，推荐使用公共 GitHub Release installer。它会按需准备 Node.js 22、安装 Codex CLI，并写入精确 endpoint、Key 和默认模型：

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

详细说明见 一键配置安装。

一键脚本完成的工作

脚本内部会依次处理这些任务：

1. 缺少可用 Node.js 22 时通过官方 nvm 安装 Node.js 22。
2. 缺少 Codex CLI 时通过 npm 安装官方 @openai/codex 包。
3. 从终端安全读取 API Key；已有安装会询问是否重装，选择否仍继续更新配置。
4. 合并 ~/.codex/config.toml、~/.codex/auth.json 与 shell 受管环境区块，默认模型为 gpt-5.6-sol，base_url 为 https://ai.aitongdao.com/v1。

按系统手动安装

如果你更希望自己掌控每一步，请根据系统选择对应教程：

• Windows 手动安装
• macOS 手动安装
• Linux 手动安装

手动流程的核心是在 ~/.codex/ 目录下创建两个文件：config.toml（模型与端点）和 auth.json（API Key）。

你最终要看到的效果

完成任一种安装方式后，在终端执行：

codex --version

应当输出具体版本号。然后进入任意项目目录运行 codex，即可进入交互会话，Codex 会读取当前目录的文件并回答问题、生成代码。