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 需要所属账户有余额才能调用。

推荐路径：一键脚本

如果你只是想最快速度把环境跑起来，推荐使用我们提供的一键脚本。它会自动检测系统环境、安装 Codex CLI 并写入配置：

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

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

一键脚本完成的工作

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

1. 检测当前操作系统与 Node.js 版本，低于 22 时给出升级提示。
2. 通过 npm 安装 @openai/codex，默认源失败时切换到国内镜像。
3. 引导你输入 API Key，并调用 /v1/models 接口做一次校验。
4. 将 OPENAI_API_KEY 与 OPENAI_BASE_URL 写入 shell 配置文件（zsh/bash 自动识别）。

按系统手动安装

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

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

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

你最终要看到的效果

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

codex --version

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