如何在 Codex CLI 中使用 WoAiToken Next

📖 English version →

前置条件 #

• 已安装 Codex CLI — npm install -g @openai/codex
• 已有 WoAiToken 账号并完成充值 — new.woaitoken.com
• 您的 NewAPI API Key（Step 1 中获取）

Step 1 — 获取 API Key #

1. 打开控制台

访问 new.woaitoken.com/dashboard/overview 并登录。

2. 新建令牌

进入 令牌 → 新增令牌，填写名称（如 “Claude Code”），有效期选 无限制，点击 提交。

3. 复制密钥

复制生成的密钥（以 sk- 开头）。

Step 2 — 配置 Codex CLI #

NewAPI 提供完全兼容 OpenAI 的端点：https://new.woaitoken.com/v1。

以下提供四种配置方式，任选其一：

方式 A — 环境变量（推荐） #

macOS / Linux — 在 ~/.zshrc 或 ~/.bashrc 末尾添加：

export OPENAI_API_KEY="sk-your-key-here"
export OPENAI_BASE_URL="https://new.woaitoken.com/v1"

然后重新加载配置：

source ~/.zshrc

Windows PowerShell：

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY","sk-your-key-here","User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL","https://new.woaitoken.com/v1","User")

⚠️ 执行后需重新打开终端窗口生效。

方式 B — 配置文件 #

创建或编辑 ~/.codex/config.toml：

model = "gpt-5.5"
provider = "openai"

[providers.openai]
base_url = "https://new.woaitoken.com/v1"

然后通过环境变量设置 API Key：

export OPENAI_API_KEY="sk-your-key-here"

方式 C — 临时生效（仅测试用） #

OPENAI_API_KEY="sk-your-key-here" \
OPENAI_BASE_URL="https://new.woaitoken.com/v1" \
codex

⚠️ 仅对当前终端窗口有效，日常使用请选方式 A 或 B。

方式 D — CC Switch（图形界面，可多端点切换） #

CC Switch 是一款桌面应用，通过图形界面管理多个 AI API 配置，无需手动编辑 JSON 文件，适合需要在多个 API 服务之间切换的用户。

安装

从 ccswitch.io 下载对应平台的安装包，macOS 用户也可通过 Homebrew 安装：

brew tap farion1231/ccswitch && brew install --cask cc-switch

配置步骤

打开 new.woaitoken.com/keys，左侧点击 API 密钥 → 右侧 … → 选择 CC切换：

点击 Save 后再点击 Activate，配置将自动写入 ~/.codex/config.toml。

测试配置

Step 3 — 验证连接 #

打开 Codex，随便发送一个问题，正常收到回复即表示连接成功 ✅。

常见问题 #