Skip to Content
cc-switch(推荐)配置 AllTokens

配置 AllTokens

先准备一个密钥

cc-switch 只是把配置写进各工具,密钥还是我们这边签发的。还没有的话先看密钥与鉴权:

  • 个人密钥在控制台的「API 密钥」页(/keys)创建;
  • 企业共享密钥由管理员在共享 API 密钥里创建并分发。

两个 Base URL,按工具的协议选

这是整套配置里唯一容易错的地方:

工具用哪套协议Base URL 填
OpenAI 兼容https://alltokens.si/v1
Anthropic 兼容https://alltokens.si(不带 /v1)

Anthropic 协议的工具为什么不带 /v1:这类工具自己会补上 /v1/messages,你填的只是站点地址。带错了会出现「路径不存在」而不是鉴权失败。

两条路径在我们这边都是真实的:

POST https://alltokens.si/v1/chat/completions # OpenAI 兼容 POST https://alltokens.si/v1/messages # Anthropic 兼容 GET https://alltokens.si/v1/models # 模型列表

各工具怎么填

工具协议Base URL
Claude CodeAnthropichttps://alltokens.si
Claude DesktopAnthropic(第三方供应商)https://alltokens.si
CodexOpenAI 兼容https://alltokens.si/v1
OpenCode / OpenClaw / Hermes / Pi / MiniMax CodeOpenAI 兼容https://alltokens.si/v1

Gemini CLI、Grok Build 这类工具有自己的原生协议(不是 OpenAI 也不是 Anthropic 格式)。cc-switch 的本地路由可以做协议转换,这种情况该填什么、要不要开路由,以 cc-switch 的预设与界面提示为准——它的字段提示会告诉你这个工具吃哪种格式。我们没有逐个实测过这条路径,所以不在本页替你猜。

添加供应商

  1. 打开 cc-switch,在侧栏选中要配置的工具(比如 Claude Code 或 Codex)。
  2. 点 添加供应商:
    • 名称:AllTokens(随便起,能认出来就行)
    • Base URL:按上表填
    • API Key:粘贴你的 sk-... 密钥
    • 可以直接选「自定义配置」,也可以用预设列表新建。
  3. 保存,然后选中这条供应商,点 启用。
  4. 重启对应的终端或 CLI 工具让配置生效。Claude Code 支持免重启热切换,其它工具一般要重启。

cc-switch 首次启动时可以自动导入你已有的 CLI 配置作为默认供应商,所以不用先手工把配置删干净。

日常切换

  • 主界面:选供应商 → 启用。
  • 系统托盘:直接点供应商名称,即时生效(这是最常用的方式)。
  • 切回官方:添加官方登录预设 → 启用 → 在对应工具里执行登出/登录。

连接模式:直连、路由、聚合

  • 直连:客户端直接连供应商,请求不经过 cc-switch。
  • 路由:请求经本机 cc-switch 转发。这也是自动故障转移与熔断器生效的前提——主供应商失败时自动切备用,失败太频繁的供应商会被暂时断开而不是反复重试。
  • 聚合:Claude Code 与 Codex 专用,可以把多家供应商的模型放进同一个 /model 列表里。

本地路由还能在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 与 Gemini Native 之间转换请求格式。

排队换供应商之前先想清楚:开路由会多一层本机转发。想要故障转移就必须开;只想要「切换配置」的话直连就够。另外路由下的用量统计由 cc-switch 记录,与我们控制台的统计是两套口径,对账时以用量为准。

怎么确认接上了

  1. 在对应工具里发一个请求,能正常返回就说明配置生效;
  2. 回到我们的控制台看用量或请求明细,能看到这次调用;
  3. cc-switch 自己也有用量与余额显示——余额对得上,说明走的是你那条密钥。

模型名以平台实际提供为准。 无论哪个工具,示例里的模型名都要换成模型与价格 页面上当前确实可用的名字。看到「模型不存在」先查这个,而不是怀疑密钥。

常见问题

切换后没生效 — 重启终端或对应 CLI 工具。Claude Code 之外的工具基本都需要重启。

切换之后插件/MCP/其它配置丢了 — 用 cc-switch 的统一供应商或 Shared Config Snippet 把公共配置一起带过去,别让每次切换都重置一遍。

想同时用 AllTokens 和官方账号 — 对「共存」模式的工具(OpenCode、OpenClaw、Hermes、Pi、MiniMax Code),多个供应商会同时写进工具配置,在工具里选用哪一个;对「切换」模式的工具则是一次只启用一个。

Key 泄露了怎么办 — 先在我们控制台里停用或删除该密钥(见密钥与鉴权),再在 cc-switch 里换成新密钥。密钥本身不归 cc-switch 管,改这边才是真的失效。

配置数据在哪 — ~/.cc-switch/(SQLite 数据库与自动备份)。备份用来兜住误操作,但不要把密钥备份到处传。

相关页面