先看错误信息
model not foundCherry Studio model not found 核对所选 Provider、模型 ID 与当前令牌分组授权。手工名称或其他平台别名不能当作真实 ID；保存模型后新开对话，检查最终请求的 model 字段与返回。
正在打开页面…
正在加载内容，请稍候。
- 保留现场
记录状态码、错误正文和请求时间
- 缩小范围
按下方检查项逐个排除，不同时修改多项
- 最小复测
用同一请求验证，再回到原工具测试
常见表现
- 测试连接成功但聊天失败
- 错误显示 model not found
- 只有某个模型失败
这个报错是什么意思
model not found 表示 Cherry Studio 已经进入模型调用或配置读取阶段，但请求没有被正确完成。这个错误通常不要先归因到工具安装问题，优先按 API Key、Base URL、模型名、provider 类型、账户余额和当前网络顺序排查。对中文开发者来说，最容易出错的是把不同工具的接口地址混用：Claude Code 通常使用 Anthropic 兼容根地址，Cursor、opencode、Codex、Cherry Studio、Trae 这类 OpenAI 兼容场景通常使用 /v1 端点。
先判断是哪一类问题
对照请求链路定位失败阶段
判断 01
先确认错误是否稳定复现。如果每次启动 Cherry Studio 都立刻失败，优先检查 API Key 和配置文件；如果短任务正常、长任务失败，优先检查额度、限流和上下文长度。
判断 02
再看后台是否有请求记录。apizt 后台没有记录时，问题通常还停留在本地配置、Base URL、网络或 provider 选择；后台有记录但返回失败时，再看模型名、余额和上游状态。
判断 03
最后确认当前页面对应的工具类型。Cherry Studio 的正确端点是 https://api.apizt.com/v1，模型建议先用 claude-sonnet-4-6 做连通性测试，等跑通后再切换其他模型。
按顺序修复
01
手动模型名填写 claude-sonnet-4-6
02
删除旧模型别名
03
确认聊天窗口选中 apizt 服务商
04
重新保存配置
详细修复步骤
Step 01
重新复制 API Key
到 apizt 后台重新复制一个可用令牌，只保留 sk- 开头的 Key。不要把 Bearer、引号、空格或换行一起复制进 Cherry Studio。复制后先保存，再重新打开会话测试，避免旧配置缓存继续生效。
Step 02
核对 Base URL
Cherry Studio 当前应使用 https://api.apizt.com/v1。如果把官网地址、文档地址、/chat/completions 完整路径，或者另一个工具的端点填进去，就会出现 401、404、provider error、model not found、empty content 等看起来不一样但根因相同的错误。
Step 03
固定一个模型名测试
先把模型名统一改成 claude-sonnet-4-6。不要同时测试多个模型，也不要用旧教程里的过期 Claude 名称。模型名跑通后，再根据价格、速度和上下文需求切换到其他模型。
Step 04
清理覆盖配置
很多 AI 编程工具同时支持全局配置、项目配置和环境变量。若全局配置正确但某个项目仍失败，通常是项目目录里的 settings、config、auth 或 provider 文件覆盖了新配置。先用最小配置跑通，再逐步恢复个性化设置。
Step 05
降低并发后重试
Agent、Composer、Builder 或自动修复模式会连续发起多次请求。遇到限流、overloaded、request failed 时，先停止当前任务，拆成更小的 prompt，等待 30 到 120 秒后重试，避免工具自动重试把问题放大。
正确配置
模型名称: claude-sonnet-4-6
服务商: apizt
Base URL: https://api.apizt.com/v1常见原因
- 模型名拼写错误
- 使用了旧 Claude 名称
- 服务商下没有该模型
- 多服务商配置选错
怎么确认已经修好
- 保存配置后完全关闭并重新打开 Cherry Studio，不要只刷新当前聊天窗口。
- 发送一个极短测试问题，例如“只回复 OK”，确认不是长上下文导致失败。
- 打开 apizt 后台请求记录，确认请求是否到达、返回码是什么、使用了哪个模型。
- 如果短问题成功，再回到原任务；如果原任务仍失败，优先拆分上下文或切换到 claude-sonnet-4-6 重试。
避免下次再报错
- 团队内统一一份 Base URL 和模型名，不要让每个人从不同教程复制配置。
- 给生产任务和个人调试任务分开 API Key，方便定位是谁触发了限流或余额消耗。
- 工具升级后先保留旧配置备份，再用一个短 prompt 验证连通性。
- 把正确配置写进团队文档，尤其标明 Claude Code 和 OpenAI 兼容工具的 Base URL 差异。
仍未解决？这样提供排查信息
记录报错时间、工具版本、模型 ID 和 HTTP 状态码，附上脱敏后的错误正文。
说明问题是否稳定复现，以及同一配置的最小请求是否成功。
可以提供请求 ID 或控制台日志编号，不要发送完整 API Key、密码或个人业务数据。
先区分配置、权限、额度与上游服务问题；不要通过重复充值或高频重试来排查。
排查完成后，再开始接入
先按上文检查地址、鉴权与协议，并完成复测。确认要使用 apizt 后，再创建 API Key、选择模型并配置工具；充值不能修复配置错误。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
FAQ
Cherry Studio 模型显示出来还会 model not found 吗？
会，列表可见或手工添加不等于当前 Key 有调用权限。核对服务实际支持的 ID、分组和协议，并检查当前对话是否仍选择了旧模型。
Cherry Studio 的 Gemini 模型必须用 Google Provider 吗？
按模型经哪个接口提供选择协议。由 OpenAI-compatible 路由提供时应使用该协议；不能仅根据 Gemini 名称切换到原生 Google 请求格式。
Cherry Studio 出现 model not found 一定是接口不可用吗？
不一定。多数情况是 Base URL、API Key、模型名或接口协议填错，先用本文配置核对一遍，再判断是否是服务端异常。
为什么换成 apizt 后还要改模型名？
不同工具会把模型名原样传给上游接口。模型名不存在或拼写不一致时，即使 API Key 正确也会返回 model not found、provider error 或调用失败。
Claude Code 和 OpenAI 兼容工具的 Base URL 为什么不一样？
Claude Code 走 Anthropic 兼容路径，通常使用 https://api.apizt.com；Cursor、opencode、Cherry Studio、Trae、Codex 等 OpenAI 兼容场景通常使用 https://api.apizt.com/v1。
后台没有请求记录时应该查哪里？
后台没有请求记录说明请求大概率没有到达 apizt。优先检查 Base URL、网络代理、provider 类型、环境变量是否生效，以及工具是否仍在读取旧配置。
后台有请求记录但 Cherry Studio 仍然失败怎么办？
这种情况说明本地连通性基本正常，继续看返回码、模型名、余额、上下文长度和限流状态。先用短 prompt 和推荐模型验证，再回到原任务。
可以直接复制别的工具配置吗？
不建议。Claude Code、Cursor、opencode、Codex、Cherry Studio、Trae 的配置字段和端点规则不完全相同，尤其是 /v1 是否需要保留，必须按当前工具核对。