配置 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 Code | Anthropic | https://alltokens.si |
| Claude Desktop | Anthropic(第三方供应商) | https://alltokens.si |
| Codex | OpenAI 兼容 | https://alltokens.si/v1 |
| OpenCode / OpenClaw / Hermes / Pi / MiniMax Code | OpenAI 兼容 | https://alltokens.si/v1 |
Gemini CLI、Grok Build 这类工具有自己的原生协议(不是 OpenAI 也不是 Anthropic 格式)。cc-switch 的本地路由可以做协议转换,这种情况该填什么、要不要开路由,以 cc-switch 的预设与界面提示为准——它的字段提示会告诉你这个工具吃哪种格式。我们没有逐个实测过这条路径,所以不在本页替你猜。
添加供应商
- 打开 cc-switch,在侧栏选中要配置的工具(比如 Claude Code 或 Codex)。
- 点 添加供应商:
- 名称:
AllTokens(随便起,能认出来就行) - Base URL:按上表填
- API Key:粘贴你的
sk-...密钥 - 可以直接选「自定义配置」,也可以用预设列表新建。
- 名称:
- 保存,然后选中这条供应商,点 启用。
- 重启对应的终端或 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 记录,与我们控制台的统计是两套口径,对账时以用量为准。
怎么确认接上了
模型名以平台实际提供为准。 无论哪个工具,示例里的模型名都要换成模型与价格 页面上当前确实可用的名字。看到「模型不存在」先查这个,而不是怀疑密钥。
常见问题
切换后没生效 — 重启终端或对应 CLI 工具。Claude Code 之外的工具基本都需要重启。
切换之后插件/MCP/其它配置丢了 — 用 cc-switch 的统一供应商或 Shared Config Snippet 把公共配置一起带过去,别让每次切换都重置一遍。
想同时用 AllTokens 和官方账号 — 对「共存」模式的工具(OpenCode、OpenClaw、Hermes、Pi、MiniMax Code),多个供应商会同时写进工具配置,在工具里选用哪一个;对「切换」模式的工具则是一次只启用一个。
Key 泄露了怎么办 — 先在我们控制台里停用或删除该密钥(见密钥与鉴权),再在 cc-switch 里换成新密钥。密钥本身不归 cc-switch 管,改这边才是真的失效。
配置数据在哪 — ~/.cc-switch/(SQLite 数据库与自动备份)。备份用来兜住误操作,但不要把密钥备份到处传。
相关页面
- cc-switch 是什么 — 支持的工具与系统要求
- 安装 — 三平台安装步骤
- 接入客户端 — 不用 cc-switch 时的通用接入方式
- 官方文档 — 字段与功能以官方为准