功能

接入 CC Switch

安装 CC Switch,并使用基元律动 API Key 完成接入。

关于 CC Switch

CC Switch 是一个桌面配置管理工具,可以集中管理 Claude Code、Codex 等工具的模型供应商、API 地址和密钥。本文以 Claude Code CLI 为例,使用 CC Switch 本地路由 + OpenAI Chat Completions 配置基元律动 API。

安装 CC Switch

从 CC Switch 官网进入下载页面,选择对应系统的安装包并完成安装。Windows 可使用 MSI 安装包,macOS 可使用 DMG 安装包。

如果还没有安装 Claude Code,先按 ClaudeCode 接入教程中的安装步骤准备好命令行工具,再回到本页配置路由。

配置基元律动API

登录或注册基元律动账号,完成实名认证后在用户中心创建并保存 API Key。从模型页复制支持 OpenAI Chat Completions 和工具调用的模型 ID。

1. 添加自定义供应商

打开 CC Switch,选择 Claude Code 应用,点击 添加供应商,选择 自定义配置。已添加“基元律动”的用户可以直接编辑原供应商。

配置项填写内容
名称基元律动
官网链接(可选)https://tokenrhythm.studio
请求地址 / Base URLhttps://tokenrhythm.studio
完整 URL关闭
API Key用户中心创建并保存的 API Key
上游格式(高级选项)OpenAI Chat Completions(需开启路由)
模型模型页复制的、支持工具调用的模型 ID

这里的请求地址填写根地址,末尾不加斜杠;本地路由会拼接 /v1/chat/completions。展开高级选项,确认上游格式后再保存。

2. 配置模型

将默认模型及 Opus、Sonnet、Haiku 对应的模型设置为同一个可用的基元律动模型 ID。如果使用 JSON 编辑框,对应字段为 ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL 和 ANTHROPIC_DEFAULT_HAIKU_MODEL。

填写实际模型 ID,不要保留示例占位符。点击 添加 或 保存。

3. 开启路由

  1. 在 Claude Code 应用页打开 路由 标签,点击 开始路由。
  2. 在确认框的 路由到 中选择 基元律动,再点击 开始路由 确认。若路由已经开启,在基元律动卡片上点击 路由到此。
  3. 确认页面显示 路由生效中,基元律动卡片显示 路由中。

只点击“路由”标签不会启用路由。使用 Claude Code 时,需要保持 CC Switch 和本地路由服务运行。

路由生效后,CC Switch 会自动把 Claude Code 的请求地址改为本机地址,例如 http://127.0.0.1:15721(端口以实际设置为准),并管理客户端中的密钥占位符。真实的基元律动地址和 API Key 填在供应商配置中;不要把客户端配置里的本机地址改回站点地址。

4. 验证接入

退出原来的 Claude Code,在终端重新运行 claude,开启新会话。通过 /status 核对配置,发送“请只回复:接入成功”。收到正常回复后,在 CC Switch 的请求记录和基元律动用户中心核对模型调用。

供应商测速仅用于检查地址,是否接入成功以实际会话回复和调用记录为准。

常见问题

如果出现 400 尚未验证或不支持的 anthropic-beta,先确认 路由生效中、目标供应商是 基元律动,并且上游格式为 OpenAI Chat Completions。