XXToken 工具配置文档

Codex、cc-switch、Claude Code 等工具接入 XXToken 的配置说明。

API 地址 https://token.niuwate.com/v1

一、获取 API Key

  1. 打开 XXToken 并登录。
  2. 进入 令牌管理 / API 密钥 页面。
  3. 点击 新建 或 创建 API Key。
  4. 选择合适分组。分组决定可用模型、渠道和扣费倍率。
  5. 创建后复制 Key，格式一般为 sk-xxxxxxxx。
工具里只填写 XXToken 生成的 Key，不要填写上游供应商 Key。

二、OpenAI Codex 配置

适用 Windows / macOS / Linux 的 Codex CLI、桌面 App 和 VS Code 扩展。推荐使用 GPT 分组 Key。

macOS / Linux

打开配置文件

mkdir -p ~/.codex
open -e ~/.codex/config.toml

Linux 可使用 nano ~/.codex/config.toml 或其他编辑器。

写入 config.toml

model_provider = "xxtoken"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.xxtoken]
name = "xxtoken"
base_url = "https://token.niuwate.com/v1"
wire_api = "responses"
requires_openai_auth = true

配置 auth.json

open -e ~/.codex/auth.json

写入以下内容，将 sk-你的平台Key 替换为自己的 XXToken Key：

{
  "OPENAI_API_KEY": "sk-你的平台Key"
}

Windows

按 Win + R，输入以下路径并回车：

%userprofile%\.codex

如果目录不存在，先在命令提示符执行：

mkdir %userprofile%\.codex

然后创建或编辑 config.toml 和 auth.json，内容与上方 macOS / Linux 相同。

三、cc-switch 配置

cc-switch 是一款开源桌面工具，可通过图形界面切换 Codex、Claude Code 等工具的 API 配置。

手动添加供应商

配置项填写内容
供应商名称XXToken
官网链接https://token.niuwate.com
API Key 获取地址https://token.niuwate.com/console/token
API 请求地址https://token.niuwate.com/v1
用量查询请求地址https://token.niuwate.com
用量查询地址通常不要带 /v1，API 请求地址需要带 /v1。

推荐流程

  1. 安装并打开 cc-switch。
  2. 添加自定义供应商，按上表填写。
  3. 填写 XXToken API Key。
  4. 默认模型改为 gpt-5.6-sol 或 gpt-5.4-mini。
  5. 启用该供应商配置并重启对应工具。

四、Claude Code / CCS 配置

Claude Code 工具建议使用专门的工具分组 Key。普通 ERP 接口建议使用 claude-kiro 分组；Claude Code / CCS 可使用 claude-ccmax 分组。

配置项填写内容
Base URL / API 地址https://token.niuwate.com/v1
API Keysk-你的平台Key
默认模型claude-sonnet-5 或 claude-sonnet-4-5
轻量模型claude-haiku-4-5
高性能模型claude-opus-4-5

Claude Code 使用 GPT

如果工具支持自定义 OpenAI 兼容供应商，也可以把 Claude Code 的模型映射到 GPT 模型：

用途推荐模型
高性能gpt-5.6-sol
均衡gpt-5.6-terra 或 gpt-5.4
低成本gpt-5.6-luna 或 gpt-5.4-mini
如果某个 Claude 号池提示 this group only allows Claude Code clients，说明它只适合 Claude Code / CCS 工具，不适合普通 /v1/chat/completions ERP 调用。

五、推荐模型

场景推荐模型说明
Codex 高质量代码任务gpt-5.6-sol质量优先。
Codex 日常开发gpt-5.4 / gpt-5.6-terra质量和成本均衡。
低成本文本调用gpt-5.4-mini / gpt-5.6-luna适合批量、轻量任务。
Claude 普通 APIclaude-sonnet-5 / claude-sonnet-4-5建议走 claude-kiro 分组。
图片生成gpt-image-2按张计费。

六、验证配置

配置完成后，可用下面命令测试：

curl https://token.niuwate.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的平台Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "只回复 OK"}
    ],
    "max_tokens": 10
  }'

能返回 OK 或正常模型响应，即代表 Base URL、Key、分组和渠道配置基本可用。