Tokaify APITokaify API
API 参考
场景示例

CC Switch

CC Switch 接入教程,说明如何在一个桌面工具里配置 Tokaify,并切换 Claude Code、Codex 等 CLI 的 API Key 与请求地址。

先记住这几个值

CC Switch 是一个用于管理和切换 CLI 配置的桌面工具。接入 Tokaify 时,最容易混淆的是不同工具的请求地址:

  • Claude Code:https://api.tokaify.com
  • Codex:https://api.tokaify.com/v1
  • API Key:控制台复制出来的完整 sk-...

第一步:安装 CC Switch

打开 CC Switch 项目地址,按你的系统下载安装包并完成安装。

CC Switch 支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具。本文主要说明 Tokaify 在 Claude Code 和 Codex 两类场景里的填写方式。

第二步:先在 Tokaify 生成 Key

  1. 登录 Tokaify 官网
  2. 打开控制台的 令牌管理
  3. 点击「添加令牌」并完成保存。
  4. 在令牌列表里点击「复制密钥」,拿到完整的 sk-...

注意

接入 CC Switch 时请直接使用完整密钥,不要手动删除 sk- 前缀。

第三步:添加供应商

在 CC Switch 主界面右上角点击 +,进入「添加新供应商」页面。

在 CC Switch 主界面点击右上角加号

在顶部工具类型里选择你要配置的工具:

  • 配置 Claude Code 时,选择 Claude
  • 配置 Codex 时,选择 Codex

然后在「预设供应商」里选择「自定义配置」。

选择自定义配置并填写 Tokaify 基础信息

第四步:配置 Claude Code

如果你要通过 CC Switch 管理 Claude Code,按下面方式填写:

字段填写内容说明
供应商名称tokaify只影响 CC Switch 内部展示
官网链接https://www.tokaify.com用于记录供应商来源
API Keysk-...填完整密钥
请求地址https://api.tokaify.comClaude Code 这里填根地址,不要加 /v1
API 输入格式Anthropic Messages(原生)按 CC Switch 中的 Claude 配置项选择
认证字段ANTHROPIC_AUTH_TOKEN(默认)按 CC Switch 默认项即可
主模型例如 claude-sonnet-4-6替换成你账号里实际可用的模型
推理模型(Thinking)例如 claude-sonnet-4-6可与主模型一致
Haiku 默认模型例如 claude-sonnet-4-6可按账号可用模型填写
Sonnet 默认模型例如 claude-sonnet-4-6可按账号可用模型填写
Opus 默认模型例如 claude-opus-4-7可按账号可用模型填写

如果 CC Switch 展示了「配置 JSON」,建议确认里面包含下面这项:

在配置 JSON 中添加 Claude Code experimental betas 关闭项

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

这项用于关闭 Claude Code 的 experimental betas,避免部分版本额外发送 context_management 字段后触发参数校验错误。

第五步:配置 Codex

如果你要通过 CC Switch 管理 Codex,请切到顶部的 Codex 工具类型后再添加供应商。

字段填写内容说明
供应商名称tokaify只影响 CC Switch 内部展示
API Keysk-...填完整密钥
请求地址 / Base URLhttps://api.tokaify.com/v1Codex 这里必须带 /v1
模型例如 gpt-5.4替换成你账号里实际可用的模型

Codex 请求地址必须带 /v1

Codex 走 OpenAI 兼容接口,CC Switch 里给 Codex 填请求地址时请使用 https://api.tokaify.com/v1。不要只填 https://api.tokaify.com,否则很容易出现模型列表为空、404 或请求路径不匹配的问题。

第六步:保存并切换

保存供应商配置后,回到 CC Switch 主界面:

  1. 在顶部选择要切换的工具,例如 ClaudeCodex
  2. 选择刚才添加的 tokaify 供应商。
  3. 点击切换或保存,让 CC Switch 写入对应工具的本地配置。
  4. 关闭当前终端,重新打开后再启动对应 CLI。

第七步:验证是否生效

Claude Code 可以启动后输入:

请先回复一句“Claude Code 已连接 Tokaify”,再列出当前项目顶层目录。

Codex 可以启动后输入:

请先回复一句“Codex 已连接 Tokaify”,再说明当前模型名称。

如果能正常返回,就说明 CC Switch 已经把对应工具切到了 Tokaify。

常见问题

Claude Code 和 Codex 的请求地址为什么不一样

Claude Code 使用 Anthropic 风格配置,ANTHROPIC_BASE_URL 按根地址填写即可:

https://api.tokaify.com

Codex 使用 OpenAI 兼容接口,Base URL 需要写到版本路径:

https://api.tokaify.com/v1

Codex 配置后返回 404 怎么办

优先检查 CC Switch 里 Codex 的请求地址是否写成了:

https://api.tokaify.com/v1

如果只写了 https://api.tokaify.com,请补上 /v1 后重新保存并切换。

返回 401 / 403 怎么办

优先检查:

  1. API Key 是否是完整 sk-...
  2. 令牌是否被禁用、过期或额度不足。
  3. 当前模型是否属于该令牌允许访问的模型。
  4. 是否触发了 IP 限制。

这篇文档对您有帮助吗?

最后更新于