一键导入流程
- 进入 DimiLinks 控制台 → 「API 密钥」页。
- 在目标密钥右侧点「导入到 CC Switch」或「导入到 Cherry Studio」。导入 CC Switch 前,可以先在「CC Switch 配置给」里选择要写入的工具(Claude Code / Codex / Gemini CLI),默认按密钥模型自动推荐。
- 浏览器会弹出系统级跳转,由对应客户端接管 deep link,自动写入 base URL、密钥与模型。
api-direct.dimilinks.com。一键导入会根据目标客户端是否自动追加 API 路径,写入带 /v1 或不带 /v1 的正确格式。
如果导入失败,常见原因:
- 客户端没有安装或未注册 deep link 协议(
ccswitch:///cherrystudio://)。 - 浏览器拦截了 scheme 跳转,可在地址栏回车一次再试。
- 操作系统首次见到该协议会询问是否打开本地应用,记得点允许。
- 导入成功但在 CC Switch 里找不到:provider 只会出现在导入时所选工具的列表里(Claude Code / Codex / Gemini 各自独立),请切到对应工具页签查看,或回控制台重新选择目标后再导入。
- 给 Claude Code 使用时,请选 Claude 分组的密钥;通用分组的密钥无法调用 Claude 系列模型。
CC Switch deep link 结构
控制台生成的链接形如:Cherry Studio deep link 结构
data 是一段 URL-safe base64,解码后是 JSON:
type 取值与 Cherry Studio 内的 provider 类型对齐:openai / anthropic / gemini。
手动添加(不走 deep link)
如果你不想用一键导入,也可以在客户端里手动新建 provider:
填完后建议先用「测试连接」或发一条最简单的对话,确认链路通。