Cherry Studio 是一款开源 AI 桌面客户端，可以通过 Token Plan 团队版、Coding Plan或按量计费接入阿里云百炼。
安装 Cherry Studio
前往 Cherry Studio 下载页面，根据操作系统下载安装包并完成安装。
配置接入凭证
打开 Cherry Studio，点击右上角的设置按钮，在模型栏点击添加，填写供应商名称（如 Token Plan 团队版），提供商类型选择 OpenAI。
百炼提供三种计费方案，根据需要选择：
-
Token Plan 团队版：按坐席订阅，按 token 消耗抵扣 Credits。
-
Coding Plan：固定月费订阅，按模型调用次数计量。
-
按量计费：按实际调用量后付费。
Token Plan 团队版
|
配置项 |
说明 |
|---|---|
|
API 密钥 |
填入 Token Plan 团队版专属 API Key。 |
|
API 地址 |
|
|
模型 |
可用模型请参考 Token Plan 团队版支持的模型。 |
Coding Plan
|
配置项 |
说明 |
|---|---|
|
API 密钥 |
填入 Coding Plan 专属 API Key。 |
|
API 地址 |
|
|
模型 |
可用模型请参考 Coding Plan 支持的模型。 |
按量计费
|
配置项 |
说明 |
|---|---|
|
API 密钥 |
|
|
API 地址 |
根据地域，填入对应 URL：
|
|
模型 |
填入支持的模型。 |
验证配置
在模型 ID填入需要使用的模型（如 qwen3.7-max），点击添加。返回对话界面，输入任意问题，模型正常返回响应即配置成功。
如果是 RAM 子账号，请参见业务空间管理，确保拥有模型的调用权限。
常见问题
错误码
配置过程中遇到报错，请参考对应计费方案的常见问题文档：
-
按量计费：错误码排查
-
Coding Plan：Coding Plan 常见问题
-
Token Plan 团队版：Token Plan 团队版常见问题
报错 The value of the enable_thinking parameter is restricted to True
原因：该模型仅支持在思考模式下运行，但调用时未开启思考模式。
解决方案：在客户端中开启思考模式。
接入按量计费时，有免费额度但产生了费用
可能的原因：
-
地域不匹配：免费额度仅适用于华北2（北京）地域（中国内地服务部署范围）的模型。使用其他地域和部署范围的模型会产生费用。请检查API 地址是否与目标地域匹配，详情请参见新人免费额度。
-
额度按模型独立计算：各模型的免费额度相互独立，不可跨模型共享。
-
数据更新延迟：控制台显示的免费额度数据每小时更新。即使控制台显示仍有余量，实际额度也可能已耗尽。
可通过如何查看产生费用的模型？及如何查看模型调用记录？确认费用详情。