先看错误信息
invalid url /v1/v1Cherry Studio /v1/v1 说明 API 根地址与客户端自动附加路径可能重复。检查 Base URL、API Path 和当前版本拼接规则，只保留一次 /v1；修改后看最终聊天请求地址，而不是仅测试域名能否打开。
正在打开页面…
正在加载内容，请稍候。
- 保留现场
记录状态码、错误正文和请求时间
- 缩小范围
按下方检查项逐个排除，不同时修改多项
- 最小复测
用同一请求验证，再回到原工具测试
常见表现
- 请求地址包含 /v1/v1
- 404 或 invalid url
- 模型列表接口异常
这个报错是什么意思
invalid url /v1/v1 表示 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
查看最终请求 URL
02
如果出现 /v1/v1，则把 Base URL 改为 https://api.apizt.com
03
否则使用 https://api.apizt.com/v1
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 秒后重试，避免工具自动重试把问题放大。
正确配置
优先: https://api.apizt.com/v1
如果最终请求变成 /v1/v1: https://api.apizt.com常见原因
- 工具自动补路径
- 手动 Base URL 已带 /v1
- 从其他教程复制了完整接口地址
- 服务商模板重复拼接
怎么确认已经修好
- 保存配置后完全关闭并重新打开 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 /v1/v1 应该删哪一个 /v1？
先确认哪个字段由客户端自动补全。如果 API Path 或 Provider 已附加 /v1，则调整根地址；若没有自动附加，保留正确的 /v1 根路径。以最终请求 URL 为准。
Cherry Studio invalid url 修好后怎么确认？
发送短文本对话，检查最终 URL、HTTP 状态和有效返回，并对照平台记录。模型列表成功与浏览器打开首页都不足以验证聊天端点。
Cherry Studio 出现 invalid url /v1/v1 一定是接口不可用吗？
不一定。多数情况是 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 是否需要保留，必须按当前工具核对。