接入自测

这一页用于在你已经按教程配置完成、但工具仍然不能正常回复时，快速确认问题出在哪里。

如果你还没开始配置，建议先看：

• CC Switch 快速接入
• 账户注册
• Claude Code

一、确认 API 地址

文档中使用的 API 地址是：

https://api.yonghu.shop

OpenAI 兼容工具常用：

https://api.yonghu.shop/v1

二、最小自测命令

下面命令适合有命令行基础的用户。请把 你的_API_Key 和 平台模型名 替换成自己的内容。

1. 测服务是否在线

curl https://api.yonghu.shop/api/status

能返回内容，说明主服务可以访问。

2. 测 Key 是否可用

curl https://api.yonghu.shop/v1/models   -H "Authorization: Bearer 你的_API_Key"

能返回模型列表，说明 Key 基本可用。

3. 测一次最小对话

curl https://api.yonghu.shop/v1/chat/completions   -H "Authorization: Bearer 你的_API_Key"   -H "Content-Type: application/json"   -d '{
    "model": "平台模型名",
    "messages": [{"role": "user", "content": "请只回复 ok"}]
  }'

能返回文本，说明 OpenAI 兼容调用基本正常。

三、排查顺序

建议按这个顺序检查：

1. API 地址是否填对
2. API Key 是否复制完整
3. 账号余额是否充足
4. 模型名是否和控制台完全一致
5. 当前工具是否需要在地址末尾加 /v1
6. 修改配置后是否重启了终端或应用

四、常见错误含义

• 401：Key 错误、Key 失效，或请求里没有带 Key
• 403：Key 不可用、余额不足，或没有该模型权限
• 404：地址路径不匹配，或模型名不存在
• model not found：模型名写错，或该 Key 暂不可用这个模型
• 429：请求太频繁，请降低并发或稍后重试
• 500 / 502 / 503：服务繁忙或临时异常，请稍后重试

五、还解决不了怎么办

请保留下面信息再反馈，处理会更快：

• 使用的工具名称和版本
• 填写的 Base URL（不要发 API Key）
• 使用的模型名
• 完整错误提示截图或文本
• 大概发生时间