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

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

Chatbox 是 Bin-Huang 开源的桌面 AI 客户端,对话 + 图片 + MCP 工具一站式,跨平台 macOS / Windows / Linux + 移动端 iOS / Android。AI 通道在 dashboard 帮你生成 chatbox://provider/import deeplink —— 选好分组点一下,桌面 app 自动新增一个 custom provider,endpoint + key 全部填好,不用手动加 provider、不用查协议路径。

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

前提:Chatbox 桌面端已安装(从 GitHub Releases 下载,或 官网下载)。然后登录 AI 通道 dashboard,点 Chatbox 卡片 → 选分组 → 点 deeplink → 浏览器跳到 Chatbox 自动填好。

  1. 1

    装 Chatbox + 注册 AI 通道

    Chatbox 从 GitHub Releases 或官网下安装包,启动一次让 OS 注册 chatbox:// 协议。AI 通道邮箱注册即可,微信/支付宝充值最低 ¥10。

  2. 2

    Dashboard 点 Chatbox 卡片

    选你想用的分组(Claude / CC Max / Codex / Gemini 任一)。Chatbox 会按分组协议自动选 type:Claude/CC Max → type=anthropic,Codex/Gemini → type=openai(Chatbox 自身没有 Gemini 原生 type,Gemini 走 OpenAI 兼容 shim)。

  3. 3

    点"在 Chatbox 中打开"

    chatbox://provider/import?config={
      "isCustom": true,
      "id": "aitongdao-claude",
      "name": "AI 通道 · claude",
      "type": "anthropic",
      "settings": {
        "apiHost": "https://ai.aitongdao.com/v1",
        "apiKey": "sk-xxxxxx"
      }
    }

    浏览器跳到 Chatbox,自动新增一条名为"AI 通道 · claude"的 custom provider。在 Chatbox 顶部切换 provider 即可在不同分组间换算 quota,每个分组单独计费。

为什么用 AI 通道接 Chatbox

  • 跨设备聊天 · 桌面 + 移动端通用

    Chatbox 是少数同时有桌面和移动端的开源 AI 客户端。AI 通道 deeplink 的 provider 配置在桌面端 / 移动端可以分别导入,共用同一把 key 同一余额。出门用手机继续聊,回家用电脑接着上文,token 用量统一计费。

  • 不用碰 endpoint / 不用查协议

    传统配置 Chatbox 需要你知道 Anthropic 协议端点不带 /v1、OpenAI 带 /v1、Gemini 还要 fallback 到 openai 兼容。AI 通道 deeplink 全部自动化,你只需要点一下。

  • 支持 MCP 工具 · 模型可调外部能力

    Chatbox 内置 MCP(Model Context Protocol)支持,模型可以调用本地工具(文件操作 / Shell / 数据库等)。AI 通道侧不限制 tool calling 协议字段,Chatbox 配的所有 MCP 工具都能正常被模型调用。

  • 按 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 没反应?或者想手动添加 provider
  1. A

    检查 Chatbox 是否注册了协议

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

  2. B

    手动添加 provider

    Chatbox 设置 → "添加自定义 provider" → 填:

    名称:    AI 通道
    类型:    OpenAI 或 Anthropic(看你想用的分组协议)
    API Host: https://ai.aitongdao.com/v1
    API Key:  sk-xxxxxx

    Claude / CC Max 分组用 Anthropic,Codex / Gemini 分组用 OpenAI。完成后在 Chatbox 顶部切换。

  3. C

    移动端怎么导入?

    移动端浏览器打开 dashboard,选 Chatbox 卡片 → 复制 deeplink → 粘贴到移动端浏览器地址栏。Chatbox 移动 app 会被唤起接收配置。或者在桌面生成 deeplink 后用扫码 / AirDrop 传到手机打开。

常见问题 FAQ

Chatbox 是开源的吗?数据安全吗?

是。源码在 github.com/Bin-Huang/chatbox。Chatbox 本地存储所有对话,不上传服务器(除非你主动开启云同步)。AI 通道生成的 deeplink 包含 API key,只在你浏览器和 Chatbox 之间传输。

Chatbox 跟 Cherry Studio 怎么选?

看你的偏好:Chatbox 更轻量,聚焦"对话 + 图片 + MCP 工具",有移动端;Cherry Studio 更全功能,内置 Agent 和知识库,只有桌面端。两个都开源、都支持 AI 通道 deeplink、都跑得起 Claude/GPT/Gemini。

为什么 Gemini 在 Chatbox 里走 OpenAI type?

Chatbox 的 custom provider 类型只有 openaianthropic,没有 Gemini 原生 type。AI 通道把 Gemini 模型也通过 OpenAI 兼容 shim 暴露出来,所以 Gemini 分组的 deeplink 用 type=openai,模型名直接填 gemini-2.5-pro 等即可正常调用。

支持图片输入吗?

支持(取决于模型)。Claude / GPT / Gemini 的 vision 输入通过 OpenAI 协议的 image_url 或 Anthropic 协议的 image content block 直通,Chatbox 在对话框拖入图片即可。

多分组想分别添加 provider 怎么做?

Chatbox 的 provider id 在 deeplink 里是按 aitongdao-<groupKey> 命名的(aitongdao-claudeaitongdao-codex 等)。重复 deeplink 流程选不同分组,会在 Chatbox 里生成多条独立 provider entry,顶部一键切换。

价格相对官方贵多少?

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

请求会被留存吗?

请求体在转发完成后即丢弃,只保留 token 用量统计用于计费。我们不持久化 prompt 内容、不训练任何模型。Dashboard 也支持按 key 关闭日志。

国内用 Chatbox 需要翻墙吗?

不需要。Chatbox 本地运行,对话存在本地文件系统;deeplink 从 aitongdao.com(国内 ICP 备案域名)直接唤起桌面 / 移动 app,模型请求也走 ai.aitongdao.com 首尔节点国内直连。Windows、macOS、Linux、iOS、Android 全平台都免翻墙,装完即用。

我有多个中转账号或想同时用多个分组,怎么用 Chatbox 切换?

Chatbox 支持任意多个 provider 并存。每条 deeplink 按 aitongdao-<groupKey> 命名生成独立 provider entry(如 aitongdao-claudeaitongdao-codexaitongdao-gemini),反复走 deeplink 流程给不同分组或不同账号加配置即可。对话窗口顶部下拉菜单一键切换,不同 provider 的对话上下文互相隔离,按各自的 key 计费。

Chatbox 可用分组价格 · 实时数据

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 全系,大上下文 + 多模态

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

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

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