CC Switch 连接 TokenOnly.ai 教程

June 13, 2026·TokenOnly Team

适用于：Claude Code、Codex、OpenCode 等通过 CC Switch 管理的工具

什么是 CC Switch？

CC Switch 是一个跨平台桌面应用，用于一键切换 AI 编程工具的 API 供应商。支持：

  • Claude Code
  • Codex (OpenAI)
  • OpenCode
  • Gemini CLI
  • 等多个工具

为什么选择 TokenOnly.ai？

  • 统一接口：一个 API Key 访问 OpenAI、Claude、Gemini 等多种模型
  • 协议兼容：支持 OpenAI Chat、Anthropic Messages、Gemini 原生协议
  • 按量计费：用多少付多少，支持多种支付方式
  • 稳定可靠：企业级稳定性，99.7% SLA

前置准备

1. 注册 TokenOnly 账号

访问 https://tokenonly.ai 注册账号

2. 获取 API Key

  1. 登录 TokenOnly 控制台
  2. 进入「API Keys」页面
  3. 点击「创建 API Key」
  4. 复制生成的 sk-tokenonly-xxxxx 格式的 Key

3. 充值余额

在控制台完成充值后即可开始使用

配置步骤

Claude Code 配置

  1. 打开 CC Switch，选择 Claude Code 标签页

  2. 添加 TokenOnly 供应商：

    点击「添加供应商」→「自定义」，填写以下信息：

    配置项 值
    供应商名称 TokenOnly
    API Key sk-tokenonly-xxxxx（你的 Key）
    Base URL https://api.tokenonly.ai
    默认模型（高性价比） anthropic/claude-haiku-4-5
    默认模型（均衡） anthropic/claude-sonnet-4-6
    默认模型（高性能） anthropic/claude-opus-4-7

  3. 保存并启用：点击「保存」后，选中 TokenOnly 供应商，点击「启用」

  4. 验证连接：重启终端，运行 Claude Code 进行测试

Codex (OpenAI) 配置

  1. 在 CC Switch 中切换到 Codex 标签页

  2. 添加供应商，配置如下：

    配置项 值
    供应商名称 TokenOnly
    API Key sk-tokenonly-xxxxx
    Base URL https://api.tokenonly.ai
    默认模型 openai/gpt-5-4

  3. 保存并启用

OpenCode 配置

  1. 在 CC Switch 中切换到 OpenCode 标签页

  2. 配置信息（双 Provider 支持）：

    Provider 1 (Anthropic)：

    配置项 值
    Provider 名称 TokenOnly-Claude
    API Key sk-tokenonly-xxxxx
    Base URL https://api.tokenonly.ai/v1
    默认模型 anthropic/claude-sonnet-4-6

    Provider 2 (OpenAI)：

    配置项 值
    Provider 名称 TokenOnly-OpenAI
    API Key sk-tokenonly-xxxxx
    Base URL https://api.tokenonly.ai/v1
    默认模型 openai/gpt-5-4

    Provider 3 (Google)（可选）：

    配置项 值
    Provider 名称 TokenOnly-Google
    API Key sk-tokenonly-xxxxx
    Base URL https://api.tokenonly.ai/v1beta
    默认模型 google/gemini-3-flash-preview

可用模型列表

通过 TokenOnly 可以使用以下模型（使用 canonical 名称）：

Claude 系列

  • anthropic/claude-opus-4-7 - 最强推理
  • anthropic/claude-opus-4-6 - 高性能
  • anthropic/claude-sonnet-4-6 - 均衡选择
  • anthropic/claude-haiku-4-5 - 快速响应

OpenAI 系列

  • openai/gpt-5-5 - 最新 GPT-5.5
  • openai/gpt-5-4 - GPT-5
  • openai/gpt-5-3-codex - 代码专用

Gemini 系列

  • google/gemini-3-flash-preview - 快速响应
  • google/gemini-3.1-pro-preview - 高性能
  • google/gemini-3.1-flash-lite-preview - 轻量级

智谱系列

  • zhipu/glm-5-1 - 国产大模型

协议兼容性说明

OpenAI 协议转换

TokenOnly 支持通过 OpenAI 格式调用 Claude 和 Gemini：

// 使用 OpenAI SDK 调用 Claude
{
  "model": "anthropic/claude-sonnet-4-6",
  "messages": [{"role": "user", "content": "Hello!"}]
}

系统会自动完成协议转换，返回 OpenAI 格式响应。

Anthropic 原生协议

对于 Claude 系列，也可以使用原生 /v1/messages 协议：

{
  "model": "anthropic/claude-sonnet-4-6",
  "max_tokens": 4096,
  "messages": [{"role": "user", "content": "Hello!"}]
}

Gemini 原生协议

支持 Gemini 原生 generateContent 协议。

常见问题

Q: 切换后需要重启终端吗？

A: 大多数工具需要重启终端。但 Claude Code 支持热切换，无需重启。

Q: 如何查看用量？

A: 登录 TokenOnly 控制台，在「用量明细」页面查看详细账单。

Q: 余额不足会怎样？

A: API 会返回 402 状态码，请在控制台充值后继续使用。

Q: 支持流式输出吗？

A: 支持，所有工具的流式输出功能均可正常使用。

Q: 如何联系客服？

A: 通过 TokenOnly 控制台的在线客服功能，或加入官方社群。

进阶配置

设置消费上限

在创建 API Key 时，可以设置 quota_limit_amount_e8 参数来限制该 Key 的最大消费额度。

选择质量优先

在请求时添加 Header：

X-Route-Strategy: quality

这会在可用 Provider 中选择质量最优的路线（可能费用略高）。

项目标识

添加 Header 用于在用量统计中区分不同项目：

X-Project: my-awesome-project

技术支持

祝您使用愉快！

← Back to About