球球Token球球Token - AI中转服务站

Codex CLI

Codex CLI 是在终端里使用 OpenAI Codex 的入口，适合在本地项目中完成代码理解、修改和任务协作。使用 qiuqiutoken 时，优先用自动化工具写入配置，需要手动处理时再按下面的命令操作。

前置条件

  • 只有手动 npm 安装时，才需要提前准备 Node.js 18+ 与 npm。

推荐路径

  1. Windows 用户优先使用 Windows Codex 安装器，自动完成常见安装、PATH 与基础配置。
  2. 安装器不适用时，再使用 CC Switch 可视化写入 qiuqiutoken provider、CodeX 专用令牌、Base URL 与模型。
  3. 需要手动处理时，再继续看下面的命令配置。

安装与配置

先在 快速开始 准备余额和 Codex 对应 Base URL，再到 创建 API 令牌 创建 Codex 对应分组令牌。

Windows

如果 Windows Codex 安装器 或 CC Switch 已经完成配置，直接进入项目目录运行 codex 验证；需要手动处理时再继续下面的流程。

1. 安装 Node.js

如果你不用自动安装器，可以从 Node.js 官网 下载 LTS 安装包，或在命令提示符 / Terminal 中任选一种包管理器安装。

命令提示符 / Terminal
winget install OpenJS.NodeJS.LTS
choco install nodejs-lts
scoop install nodejs-lts

安装完成后，打开新的命令提示符 / Terminal，确认 Node.js 与 npm 可用。

命令提示符 / Terminal
node -v
npm -v

2. 安装 Codex CLI

使用 npm 全局安装最新版 Codex CLI。

命令提示符 / Terminal
npm install -g @openai/codex@latest

安装后先检查版本，不要在 API 配置前直接运行交互式 codex。

命令提示符 / Terminal
codex --version

3. 配置 qiuqiutoken API

先创建 Codex 对应分组令牌，不要选择 default。Windows 配置目录是 %USERPROFILE%\.codex。

4. 启动 Codex

写完配置后，进入你的项目目录启动 Codex CLI。

命令提示符 / Terminal
cd your-project-folder
codex

手动配置

自动化工具没有写入配置时，按下面步骤手动补齐。

创建配置目录

  • Windows：%USERPROFILE%\.codex
  • macOS / Linux：~/.codex

先创建并进入对应目录。

命令提示符 / Terminal
mkdir %USERPROFILE%\.codex
cd %USERPROFILE%\.codex

创建 config.toml

在配置目录中创建 config.toml，并写入以下内容。

config.toml
model_provider = "qiuqiutoken"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true

[model_providers.qiuqiutoken]
name = "OpenAI"
base_url = "https://api.qiuqiutoken.com/v1"
wire_api = "responses"
requires_openai_auth = true

创建 auth.json

按 创建 API 令牌 准备好 Codex 对应分组令牌，并从 快速开始 复制 Codex 对应 Base URL 后，在同一目录创建 auth.json，并把示例值替换为你复制出的令牌 key。

auth.json
{
  "OPENAI_API_KEY": "粘贴为Codex对应分组令牌key"
}

提示

如果 codex 命令不存在，通常是 npm 全局 bin 目录未加入 PATH，或终端还没重启。先重新打开终端，再用 npm config get prefix 确认全局安装目录，并检查该目录下的 bin 路径是否已加入 PATH。

验证成功

  • 终端能识别 codex 命令。
  • config.toml 包含 qiuqiutoken provider、wire_api = "responses" 与 requires_openai_auth = true。
  • auth.json 包含 Codex 对应分组令牌 key。
  • Codex CLI 能在项目目录中启动并完成一次简单请求。
  • qiuqiutoken 控制台出现对应用量记录。

常见问题

  • 自动配置后仍失败：重新检查 config.toml 和 auth.json 是否写入完整。
  • 终端提示 codex 不存在：确认 npm 全局 bin 目录已加入 PATH，并重新打开终端。
  • 启动后仍连接默认服务：确认 ~/.codex/config.toml 或 %USERPROFILE%\.codex\config.toml 中的 provider 指向 qiuqiutoken。
  • 请求认证失败：确认你使用的是 Codex 对应分组令牌，不要选择 default。
  • 还没准备好余额、令牌或 Base URL：先看 快速开始 和 创建 API 令牌。
  • macOS 不想使用 npm：可使用官方支持的 brew install --cask codex。