返回AI 通道
CC Switch · 国内一键接入

CC Switch 国内一键 deeplink 接入指南 · AI 通道

CC Switch 是 farion1231 开源的桌面多账号切换器 —— 一个 GUI 把 Claude Code、Codex CLI、Gemini CLI、OpenClaw、OpenCode 的 provider 配置统一管理,一键切换。AI 通道在 dashboard 帮你生成 ccswitch://v1/import?... deeplink,点一下浏览器就把 AI 通道的 endpoint + API key + 模型默认值 + 余额自动查询 全部写进 CC Switch,不用复制粘贴。

一键接入 · 30 秒把 AI 通道导进 CC Switch

前提:CC Switch 桌面端已安装(从 GitHub Releases 下载,启动一次即可)。然后登录 AI 通道 dashboard,点 CC Switch 卡片 → 选目标客户端 + 分组 → 点 deeplink → 浏览器跳到 CC Switch 自动填好。不需要打开任何配置文件、不需要懂 endpoint 协议

  1. 1

    安装 CC Switch + 注册 AI 通道

    CC Switch 从 GitHub Releases 下 macOS / Windows / Linux 安装包,安装后启动一次让 OS 注册 ccswitch:// 协议。AI 通道邮箱注册即可,微信/支付宝充值最低 ¥10。

  2. 2

    Dashboard 点 CC Switch 卡片

    选你要在 CC Switch 里新增哪个客户端的 provider:Claude Code / Codex CLI / Gemini CLI / OpenClaw / OpenCode。然后选分组(Claude / CC Max / Codex / Gemini 取决于客户端协议)。后端实时为该分组拉取/创建 API key。

  3. 3

    点"在 CC Switch 中打开"

    ccswitch://v1/import?resource=provider&app=claude
      &name=AI 通道
      &endpoint=https://ai.aitongdao.com
      &apiKey=sk-xxxxxx
      &model=claude-opus-4-7
      &usageEnabled=true
      &usageBaseUrl=https://console.aitongdao.com

    浏览器跳到 CC Switch,自动填好 provider 配置、apiKey、模型默认值,默认还把 NewAPI 余额查询脚本一起注入 —— CC Switch 之后每 60 分钟自动刷一次余额,你在桌面端就能看剩余额度,不用再开浏览器登 dashboard。

为什么用 AI 通道接 CC Switch

  • 5 种客户端共用同一个桌面切换器

    CC Switch 把 Claude Code / Codex CLI / Gemini CLI / OpenClaw / OpenCode 的 provider 配置统一管理。AI 通道为每种客户端提供专门的 deeplink —— 比如 Claude Code 走 Anthropic 协议 + claude/ccmax 分组,Gemini CLI 走 Gemini 原生协议 + gemini 分组,后端按规则自动选。

  • 不用碰任何 config 文件

    传统方式需要你打开 ~/.bashrc~/.codex/config.toml~/.config/gemini-cli/config.toml 分别编辑 endpoint + key + model。AI 通道 deeplink 把这一切自动化:点链接 → CC Switch 把 OS-level 的客户端 config 改好 → 重启 CLI 即用。

  • 桌面端实时显示余额

    deeplink 默认携带 NewAPI 余额查询脚本(可在 dashboard 取消勾选)。CC Switch 每 60 分钟拉一次余额,在 GUI 直接显示剩余 USD 金额,不用再开浏览器登后台查。链接含访问令牌,不要截图分享给他人。

  • 按 1 RMB ≈ 1 USD 计价 · 跨分组单独折扣

    Claude 0.7x(约 1 折)、 CC Max 2.5x(约 3.7 折)、 Codex 0.35x(约 0.5 折)、 Gemini 0.8x(约 1.2 折)。共用一个余额。

deeplink 没反应?手动复制链接 / 命令行打开
  1. A

    检查 CC Switch 是否注册了协议

    首次安装 CC Switch 后必须启动一次,OS 才会注册 ccswitch:// 协议处理器。如果没启动过,deeplink 会被浏览器当成无效链接忽略。

  2. B

    复制完整 deeplink 手动打开

    Dashboard 的 CC Switch modal 里有"复制链接"按钮。复制后:

    # macOS
    open "ccswitch://v1/import?resource=provider&app=claude&..."
    
    # Windows
    start "" "ccswitch://v1/import?resource=provider&app=claude&..."
    
    # Linux (xdg-open)
    xdg-open "ccswitch://v1/import?resource=provider&app=claude&..."

    或者直接粘贴到任意浏览器地址栏回车 —— 浏览器会问"是否打开 CC Switch",选"允许"或"打开"。

  3. C

    不带余额查询的版本

    Dashboard modal 里取消勾选"包含余额查询"复选框,生成的 deeplink 就不含 access token —— 链接更短、更可分享(但 CC Switch 不会自动刷余额)。

常见问题 FAQ

CC Switch 是开源的吗?数据安全吗?

是。源码在 github.com/farion1231/cc-switch。CC Switch 本身只在本地写客户端的 config 文件,不上传任何数据。AI 通道生成的 deeplink 包含你的 API key 和(可选)access token,只在你的浏览器和 CC Switch 之间传输,不经过 AI 通道服务器。

同一客户端可以导入多个 provider 吗?

可以。CC Switch 支持每个客户端有多个 provider profile,你可以同时导入"AI 通道 - Claude"和"AI 通道 - CC Max"两个,在 GUI 里一键切换默认 provider,Claude Code 重启后用新的。

deeplink 里的 access token 安全吗?

access token 是你的 NewAPI dashboard 访问令牌,只用来查余额(不能用来调模型 API)。即便如此,**不要截图分享 deeplink**,因为别人复制后可以查到你的余额信息。Dashboard 里可以随时撤销重新生成 access token。

支持 Linux 吗?

支持。CC Switch 提供 macOS / Windows / Linux 三平台的 release 包。Linux 用户可能需要额外配置 xdg-openccswitch:// 关联到 CC Switch 二进制(参考 GitHub README)。

余额查询的 60 分钟间隔可以改吗?

可以。CC Switch 在 GUI 设置里能调 usage 自动刷新间隔。AI 通道 deeplink 默认填 60 分钟(usageAutoInterval=60),够用且不会给后端造成压力。

跨设备同步 CC Switch 配置吗?

CC Switch 本身不做云端同步(避免泄露 key)。建议每台机器独立运行 deeplink 导入。或者你可以手动备份 CC Switch 的本地存储文件(平台相关路径,见 GitHub README)。

价格相对官方贵多少?

不贵 —— AI 通道按 1 RMB ≈ 1 USD 计价(不是按汇率折算成 ¥7),倍率即真实折扣。当前实时汇率 1 USD ≈ 6.84 RMB。具体单价见 价格页

国内用 CC Switch 需要翻墙吗?

不需要。CC Switch 是本地桌面工具,只在你电脑上读写客户端 config 文件,不走网络。deeplink 从 aitongdao.com dashboard 通过 https 直接唤起 CC Switch app(aitongdao.com 是国内 ICP 备案域名);之后 Claude Code / Codex CLI 等客户端的模型请求也走 ai.aitongdao.com 首尔节点国内直连。整条链路无需 VPN 或科学上网工具,Windows / macOS / Linux 都一致。

我有多个中转账号或多个分组,怎么用 CC Switch 切换?

CC Switch 天然为多账号 / 多 provider 场景而生。同一客户端(如 Claude Code)可以同时导入多个 provider:AI 通道 - Claude、AI 通道 - CC Max、其它中转、Anthropic 官方 API 等。GUI 里点一下就切换默认 provider,Claude Code 重启后就跑新配置。你也可以给团队不同成员、不同项目、家用 vs 工作分别建 provider,按需切换,profile 之间完全隔离。

CC Switch 可用分组价格 · 实时数据

AI 通道按 1 RMB ≈ 1 USD 计价 —— 倍率就是官方折扣,不要再 × 汇率(那样会算贵)。当前实时汇率 1 USD ≈ 6.84 RMB:

  • Claude 分组 · 倍率 0.7x · 折合官方约 1 折
    💰 Claude Opus 4.7 / Sonnet 4.6 / Haiku 4.5 全系,1M 上下文 + 高缓存,日常编码首选
  • CC Max 分组 · 倍率 2.5x · 折合官方约 3.7 折
    🌟 Claude 官方 Max 满血,1M 上下文 + 超高缓存,Claude Code 重度用户首选
  • Codex 分组 · 倍率 0.35x · 折合官方约 0.5 折
    🚀 GPT-5 / 5.1 / 5.2 / 5.4 + Codex 全系,编码用量最省
  • Gemini 分组 · 倍率 0.8x · 折合官方约 1.2 折
    ✨ Gemini 2.5 Pro / 3 Pro / 3 Flash 全系,大上下文 + 多模态

完整模型清单和单价见 价格页

开始用 CC Switch(AI 通道一键导入)

装 CC Switch → 注册 AI 通道 → 充 ¥10 → 选 CC Switch 卡片 → 点 deeplink → 完成。