View Categories

如何在 Codex CLI 中使用 sub2api

4 min read

📖 English version →

前置条件 #

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

Step 1 — 获取 API Key #

1. 打开控制台

访问 to.woaitoken.com/console 并登录。

2. 新建令牌

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

3. 复制密钥

复制生成的密钥——以 sk- 开头。请立即保存，密钥仅展示一次。

Step 2 — 配置 Codex CLI #

Codex CLI 读取标准 OpenAI 环境变量。sub2api 提供 OpenAI 兼容端点：https://to.woaitoken.com/v1。

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

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

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

重新加载：

source ~/.zshrc

Windows PowerShell：

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

执行后需重新打开终端窗口。

方式 B — 配置文件 #

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

model = "claude-sonnet-4-5"
provider = "openai"

[providers.openai]
base_url = "https://to.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://to.woaitoken.com/v1" \
codex

Step 3 — 验证连接 #

运行一个简单任务：

codex "用 Python 打印 Hello World"

收到回复即代表连接成功。

常见问题 #

401 Unauthorized 检查 API Key 是否完整（含 sk- 前缀，无多余空格）。

模型未找到 在 to.woaitoken.com/console → 模型 中查看可用模型列表。

连接被拒绝 / 超时 确认 OPENAI_BASE_URL 的值为 https://to.woaitoken.com/v1——必须包含 /v1 后缀。

429 Too Many Requests 账号额度已用尽，请前往 woaitoken.com 充值。

Updated on 2026年5月29日

What are your Feelings

  • Happy
  • Normal
  • Sad
Shopping Cart