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

Chatbox 国内接入指南 · AI 通道

Chatbox 是 Bin-Huang 开源的桌面 AI 客户端,对话 + 图片 + MCP 工具一站式,跨平台 macOS / Windows / Linux + 移动端 iOS / Android。在 AI 通道 dashboard 复制 API Host 和一把 API Key,在 Chatbox 里添加一个自定义 provider 粘贴进去即可 —— Claude / CC Max 选 anthropic、Codex / Gemini 选 openai,模型请求国内直连。

三步接入 · 把 AI 通道加进 Chatbox

前提:Chatbox 已安装(从 GitHub Releases 下载,或 官网下载)。然后登录 AI 通道 dashboard,复制 API Host 和一把 API Key,在 Chatbox 里加一个自定义 provider 粘贴进去。

  1. 1

    装 Chatbox + 注册 AI 通道

    Chatbox 从 GitHub Releases 或官网下安装包。AI 通道邮箱注册即可,微信/支付宝充值最低 ¥10。

  2. 2

    Dashboard 拿 API Host + API Key

    登录后在「自定义接入」里复制 API Host(https://ai.aitongdao.com/v1),在「令牌管理」里创建并复制一把 API Key(sk-…)。Chatbox 没有"一条通吃"的类型,所以按你想用的分组协议选 type。

  3. 3

    Chatbox 添加自定义 provider

    Chatbox 设置 → 添加自定义 provider → 填(Claude / CC Max 选 Anthropic,Codex / Gemini 选 OpenAI):

    名称:    AI 通道 · claude
    类型:    Anthropic(Codex / Gemini 分组则选 OpenAI)
    API Host: https://ai.aitongdao.com/v1
    API Key:  sk-xxxxxx

    完成后在 Chatbox 顶部切换 provider 即可在不同分组间换算 quota,每个分组单独计费。Gemini 走 OpenAI 兼容 shim,模型名直接填 gemini-2.5-pro 等即可。

为什么用 AI 通道接 Chatbox

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

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

  • 不用碰 endpoint / 不用查协议

    自己接 Claude / GPT / Gemini 三家要分别注册、各填一套 endpoint。用 AI 通道:一个 API Host(https://ai.aitongdao.com/v1)+ 一把 Key,按分组选 Anthropic / OpenAI 类型粘贴即可,Gemini 也走 OpenAI 兼容直通。

  • 支持 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.6x(约 0.9 折)、 Gemini 2.5x(约 3.7 折)。共用一个余额。

进阶:分组协议怎么选 / 移动端 / 多分组分开计费
  1. A

    分组协议(type)怎么选

    添加自定义 provider 时:Claude / CC Max 分组选 Anthropic,Codex / Gemini 分组选 OpenAI(Chatbox 没有 Gemini 原生 type,Gemini 走 OpenAI 兼容 shim)。API Host 一律填 https://ai.aitongdao.com/v1,API Key 填该分组的 Key。

  2. B

    移动端怎么配?

    移动端 Chatbox 同样在设置里"添加自定义 provider",填一样的 API Host + Key 即可。可在 dashboard 复制好后用备忘录 / 隔空投送传到手机粘贴。桌面和移动端各填一次,共用同一把 key 同一余额。

  3. C

    多个分组分开计费

    想把 Claude 分组和 Codex 分组分开计费,就各加一条 provider(建议命名 aitongdao-claudeaitongdao-codex 便于区分),API Host 同样、各填各自的 Key。Chatbox 顶部下拉一键切换,按各自的 key 计费。

常见问题 FAQ

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

是。源码在 github.com/Bin-Huang/chatbox。Chatbox 本地存储所有对话,不上传服务器(除非你主动开启云同步)。你在 dashboard 复制的 API key 只填进你本机的 Chatbox,AI 通道不会替你保存这把 key。

Chatbox 跟 Cherry Studio 怎么选?

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

为什么 Gemini 在 Chatbox 里走 OpenAI type?

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

支持图片输入吗?

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

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

Chatbox 没有"一条覆盖三家"的通用类型,所以按分组各加一条 provider:Claude / CC Max 选 anthropic,Codex / Gemini 选 openai,API Host 都填 https://ai.aitongdao.com/v1,各填该分组的 Key。建议命名成 aitongdao-claudeaitongdao-codex 等便于区分,顶部一键切换。

价格相对官方贵多少?

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

请求会被留存吗?

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

国内用 Chatbox 网络访问怎样?

可以。Chatbox 本地运行,对话存在本地文件系统;你在 aitongdao.com(国内 ICP 备案域名)dashboard 复制配置,模型请求走 ai.aitongdao.com 首尔节点国内直连。Windows、macOS、Linux、iOS、Android 全平台装完即可在国内网络使用

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

Chatbox 支持任意多个 provider 并存。给不同分组或不同账号各加一条自定义 provider(建议命名 aitongdao-claudeaitongdao-codexaitongdao-gemini 便于区分),API Host 都填 https://ai.aitongdao.com/v1、各填各自的 Key 即可。对话窗口顶部下拉菜单一键切换,不同 provider 的对话上下文互相隔离,按各自的 key 计费。

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

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

  • Claude 分组 · 倍率 0.7x · 折合官方约 1 折
    💰 Claude Opus 4.8 / Sonnet 4.6 / Haiku 4.5 全系,1M 上下文 + 高缓存,日常编码首选
  • CC Max 分组 · 倍率 2.5x · 折合官方约 3.7 折
    🌟 Claude 官方 Max 满血,Opus 4.8 旗舰,1M 上下文 + 超高缓存,Claude Code 重度用户首选
  • Codex 分组 · 倍率 0.6x · 折合官方约 0.9 折
    🚀 GPT-5.5 / 5.4 / 5.4-mini 全系,编码用量最省
  • Gemini 分组 · 倍率 2.5x · 折合官方约 3.7 折
    ✨ Gemini 2.5 Pro / 3 Pro / 3 Flash 全系,直连 Google T3/T1 官方号池,大上下文 + 多模态

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

开始用 Chatbox(三步接入 AI 通道)

装 Chatbox → 注册 AI 通道 → 充 ¥10 → 复制 API Host + Key → 添加自定义 provider → 完成。