Codex CLI 配置指南
什么是 Codex CLI
Codex CLI 是一个强大的 AI 编程助手，让您可以直接在终端与 AI 协作编程。支持 macOS、Linux、Windows (WSL) 系统。
安装要求
- Node.js 版本 ≥ 18.0
- 支持的操作系统：macOS、Linux、Windows (WSL)
注意
如果您使用 Windows 系统，请确保安装了 WSL 来使用 Codex CLI，请勿使用 Windows 自带的 cmd。
安装步骤
1. 安装 Node.js
如果尚未安装 Node.js 18.0 或更高版本，请先安装。
2. 安装 Codex CLI
使用 npm 安装：
bash
npm install -g @openai/codex或使用 Homebrew（macOS）：
bash
brew install codex配置 ai.TokenHub API
获取必要的配置信息
您需要准备两个重要的配置项：
| 配置项 | 说明 | 获取方式 |
|---|---|---|
| OPENAI_API_KEY | API 认证令牌 | 注册后在 API 令牌 页面点击 添加令牌 获得（以 sk- 开头） |
| OPENAI_BASE_URL | API 服务地址 | 使用 https://ai-tokenhub.com/v1 |
配置环境变量
方式 1：临时配置
请在您的项目目录下运行：
bash
export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://ai-tokenhub.com/v1"方式 2：永久配置
为了避免每次都需要手动设置环境变量，建议将配置写入系统配置文件：
bash
# 将以下内容添加到 ~/.bashrc 或 ~/.zshrc
export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://ai-tokenhub.com/v1"然后执行：
bash
source ~/.bashrc # 或 source ~/.zshrc运行 Codex CLI
确定使用的模型
如果您想使用的模型是 gpt-5，在平台上对应的模型名称为 gpt-5-2025-08-07，则启动时需要用上参数 --model gpt-5-2025-08-07。
启动 Codex CLI
进入项目目录后，直接输入命令运行：
bash
codex启动后在界面中选择第 2 项（使用 API 运行）。
第一次运行授权
第一次运行时需要选择第 1 项给予权限。
测试验证
成功启动后，输入 "你好" 进行测试。
常见问题
请求失败
检查 API Key 是否正确，以及账户是否有足够的余额。
连接超时
检查网络连接，确保可以访问 https://ai-tokenhub.com。
模型名称错误
确保模型名称拼写正确，可用的模型列表请在平台查看。