Cherry Studio × AI Code With
Cherry Studio 接入第三方 API/ 中转站配置教程
在 Cherry Studio 桌面客户端中使用 AI Code With 的 OpenAI 兼容 API。只需添加一个自定义 Provider，填入 API Key 与 API 地址，即可在 Cherry Studio 中使用 DeepSeek、Gemini、GLM、Kimi 等模型。本页提供配置步骤、常见错误排查与 FAQ。
先下载并安装 Cherry Studio，然后在设置中添加 AI Code With 自定义 Provider；API Key 只在 Cherry Studio 中填写，不在网页输入真实 Key。
- Provider Name
- AI Code With
- API Address
- https://api.aicodewith.ai/v1
- API Key
- sk-xxxxxxxx
- Model
- deepseek-v4-flash
快速配置
按下面 3 步完成安装、添加自定义 Provider，并发送一条测试消息，全程约 3 分钟。
Cherry Studio 是一款支持自定义 Provider 的桌面 AI 客户端。字段填写、复制和验证都在下面 3 步完成。
下载并安装 Cherry Studio
从官网下载对应平台（Windows、macOS 或 Linux）的安装包并完成安装。安装后启动 Cherry Studio，按引导完成首次设置。
添加 AI Code With 自定义 Provider
打开设置，进入模型服务。在服务商列表中选择 New API（或点击底部「添加服务商」新建），开启右上角开关。填写 API 密钥（粘贴 AI Code With API Key，只保存在本机），API 地址填 https://api.aicodewith.ai/v1。可先点击检测确认连通。
在设置 → 模型服务中选择 New API，填入 API 密钥和 API 地址 https://api.aicodewith.ai/v1。开启右上角开关后，可先点检测，再点同步模型。 添加模型并验证
点击「同步模型」拉取可调用模型，或点击 + 手动输入 Model ID。添加后新建对话，选择刚配置的模型发送一条测试消息。模型返回正常回复即表示接入成功；再到 AI Code With 用量记录中按时间与模型名称核对本次调用。不要把内置「产品反馈」助手的回复当成接入成功。
推荐模型
添加 Provider 后，点击「同步模型」自动拉取，或点击 + 手动输入以下 Model ID（推荐模型默认选中，可直接复制）：
已选 1 个
Claude
GPT
Gemini
DeepSeek
GLM
Kimi
完整模型列表以 AI Code With 文档与定价页为准，本站不维护独立模型清单。
点击同步模型后，从列表中添加要用的模型。完整目录以当前账号可见模型为准。添加后请新建对话，选择该模型发送测试消息，并用 AI Code With 用量记录核对。
接入原理
Cherry Studio 把自定义 Provider 保存在本机设置里。发送消息时，请求经 OpenAI 兼容端点转发到 AI Code With，再到达所选模型。Provider Name、API Key、API Address 的填写位置见上方快速配置，本节只说明请求怎么走。
- 桌面客户端
- Cherry Studio 负责对话界面、模型选择和本地保存配置，不需要插件，也不用编辑配置文件。
- 自定义 Provider
- 一条 OpenAI 兼容供应商记录，用来把 Cherry Studio 接到 AI Code With，而不是官方模型厂商。
- 请求路径
- Cherry Studio → 自定义 Provider → API Address → 模型。切换模型不会改写已经保存的 API 地址。
字段、复制和验证都在快速配置里完成。这里只说明请求如何从客户端到达模型。
常见问题
在 Cherry Studio 中使用 AI Code With 需要安装什么插件？
不需要任何插件。Cherry Studio 是桌面客户端，直接在设置 → 模型服务中选择 New API，填入 API 地址 https://api.aicodewith.ai/v1 与你的 AI Code With API Key。
API 地址应该填什么？
填 https://api.aicodewith.ai/v1。在设置 → 模型服务中选择 New API，把该地址填进 API 地址字段。不要去掉 /v1，也不要额外追加 /v1/models 等路径。
获取不到模型列表怎么办？
点击「同步模型」无法拉取时，可以直接点击 + 手动输入 Model ID（例如 deepseek-v4-flash），保存后即可在聊天界面选择使用。
API Key 从哪里获取？
登录 AI Code With 控制台的密钥管理页面创建 API Key。Key 只显示一次，请妥善保存；在 Cherry Studio 的 Provider 设置中粘贴即可。
配置完成后怎么确认成功？
开启 Provider 开关后，新建对话并选择刚添加的模型发送一条消息。必须是该模型本人的回复才算接入成功，不要把内置「产品反馈」助手的回复当成成功；再到 AI Code With 用量记录中按时间、模型核对这次调用。
未安装 Cherry Studio？
从 Cherry Studio 官网下载 Windows、macOS 或 Linux 版本并完成安装。
Cherry Studio 官方下载
访问官网下载页面，选择对应平台的安装包。支持 Windows、macOS（Intel 与 Apple Silicon）和 Linux（x86_64 与 ARM64）。
前往官方下载完整安装说明以 Cherry Studio 官方文档为准，本站不托管或修改安装包。
常见错误排查
配置过程中最常见的问题集中在 4 类。
401 / API Key 无效
现象： 发送消息后提示 401、Unauthorized 或 Invalid API Key。
原因： 通常是 API Key 无效、填写错误，或复制时带了多余字符。
- 回到 Cherry Studio 的 Provider 设置，重新粘贴 API Key（确认没有多余空格）
- 确认 Key 是 AI Code With 的有效 API Key
- 重试发送一条消息
Model Not Found / Model ID 错误
现象： 请求提示 Model Not Found 或模型不存在。
原因： Model ID 输入错误，或该模型当前不可用。
- 在 Provider 设置中核对 Model ID 与页面提供的一致
- 确认使用的 Key 有权限访问该模型
- 在 AI Code With 定价页确认该模型可用
API 地址错误
现象： 点击检测或发送消息时请求失败，或同步模型列表为空。
原因： API Address 填错路径，或填入了不带 /v1 的地址。
- 确认填的是 https://api.aicodewith.ai/v1（含 /v1）
- 删除末尾多余的 /v1/models 或猜测路径
- 保存设置后重新点击检测
同步模型列表为空
现象： 点击「同步模型」后没有任何模型返回。
原因： API Address 不可达、网络受限，或该端点暂不支持自动拉取模型列表。
- 确认 API Address 以 https://api.aicodewith.ai/v1 开头
- 切换网络环境后重试
- 直接点击 + 手动输入 Model ID 使用