更新日期:2026-06-06Cherry Studio 是一款适合桌面多模型聊天、知识整理和 MCP 工具联动的 AI 客户端。对接 Crazyrouter 时,推荐走 Cherry Studio 的
OpenAI 自定义服务商模式,这样最容易兼容模型列表、流式输出和常规聊天功能。
概览
通过 Cherry Studio 的自定义服务商功能,你可以把 Crazyrouter 作为一个 OpenAI 兼容上游接入:- 推荐协议:
OpenAI-compatible API - 推荐服务商类型:
OpenAI - API 地址:
https://api.crazyrouter.com - 认证方式:
sk-...token - 推荐首次验证模型:
gpt-5.5
Cherry Studio 官方文档说明:如果上游给出的接口是
https://xxx.com/v1/chat/completions 这种格式,在 API 地址 中通常只填写根地址即可。也就是说,对接 Crazyrouter 时优先填写 https://api.crazyrouter.com,而不是 https://api.crazyrouter.com/v1。适合谁用
- 想在桌面端统一管理多个模型的人
- 想把 Crazyrouter 用于日常聊天、写作、翻译和资料整理的人
- 想把 MCP 工具接到本地聊天客户端的人
- 想在一个界面里快速切换低成本模型和高性能模型的人
使用协议
推荐协议:OpenAI-compatible API
推荐接法是新增一个 OpenAI 类型的自定义服务商,然后把 Crazyrouter 根域名填进 API 地址:
https://api.crazyrouter.com/v1/chat/completionshttps://api.crazyrouter.com/v1/models
# 结尾;Crazyrouter 常规聊天接入不需要这样做。
前置条件
推荐首批白名单:
gpt-5.5claude-opus-4-8gemini-3.1-pro
5 分钟快速开始
1
创建 Cherry Studio 专用 token
在 Crazyrouter 后台创建一个新 token,名称建议写成
cherry-studio。首次只放行 2 到 4 个你确定会用到的模型,不要一开始把全部模型都开放。2
添加自定义服务商
打开 Cherry Studio,进入
设置 → 模型服务,点击底部 添加 或 + Add。服务商类型选择 OpenAI,名称建议写成 Crazyrouter。3
填写连接信息
在服务商配置页填写:
API Key: 你的sk-...API 地址:https://api.crazyrouter.com
检查 确认 token 与地址有效。4
拉取并添加模型
点击
管理 或 Manage 拉取模型列表,然后手动把需要的模型加入该服务商。注意:弹窗里出现模型不代表已经加入可用列表,通常还需要再点一次 +。首次建议只加一个基线模型:gpt-5.5。5
开启服务商并做首次对话
打开右上角启用开关,回到聊天界面选择
gpt-5.5,发送一句简单请求,例如:Reply only OK。收到正常回复后,再开始添加其他模型。推荐模型配置
推荐顺序:先让
gpt-5.5 跑通,再逐步加入 claude-opus-4-8 和 gemini-3.1-pro。
Token 设置最佳实践
验证清单
-
检查按钮可以通过 -
API 地址已设置为https://api.crazyrouter.com - 服务商右上角开关已开启
- 至少一个模型已从
管理 / Manage页面加入列表 - 第一条对话请求成功返回
- 流式输出能正常显示
- 如需 MCP,MCP 服务能正常启用
- Crazyrouter 后台日志能看到对应请求
MCP 使用建议
Cherry Studio 支持 MCP 服务,但建议分两步做:- 先只验证 Crazyrouter 聊天模型能否稳定工作
- 再单独添加 MCP 服务并逐个测试工具
- 优先选一个支持工具调用稳定的模型
- 先只挂一个 MCP 服务做验证
- 第一次调用工具时,先测试最简单的读操作或查询操作
常见错误与修复
性能与成本建议
- 初次接入只保留 1 到 2 个模型,避免模型太多导致选择混乱
- 默认先用
gpt-5.5,复杂长文和代码解释再切claude-opus-4-8 - 如果你经常做长对话,建议单独给 Cherry Studio 配额上限
- Cherry Studio 支持多模型切换,最好把高价模型只留给重任务使用
- 发现消耗异常时,先回看 Crazyrouter 日志确认是否出现高频重试或长上下文多轮对话
FAQ
Cherry Studio 里应该填哪个地址?
优先填https://api.crazyrouter.com。
为什么这里不推荐一开始就填 /v1?
因为 Cherry Studio 官方说明,很多 OpenAI 兼容上游只需要填写根地址,客户端会自动拼接标准路径。对 Crazyrouter 也建议先按这种方式接入。
什么时候才需要填写完整接口地址并加 #?
当你的上游不是标准 OpenAI 路由时才需要。Crazyrouter 常规聊天接入不要这样填,先用根域名就好。
第一个推荐模型是什么?
先用gpt-5.5。
我可以一次性配置很多模型吗?
可以,但不建议第一次就这样做。先用一个模型跑通,再逐步添加。Cherry Studio 能和 Crazyrouter 一起用 MCP 吗?
可以,但建议先验证聊天模型,再启用 MCP,这样更容易定位问题。如果你的主要目标是桌面多模型聊天和 MCP 轻量协作,Cherry Studio 是很合适的入口;如果你更看重 IDE 编码代理体验,优先级仍然建议放在 Cursor、Claude Code、Codex、Cline 这类工具上。