常见报错与排查指南

欢迎查阅 API 调用常见问题解答。如果您在使用过程中遇到以下报错信息，请参考对应的排查建议进行处理。

服务端与网络连接类错误

连接失败、请求超时、上游服务暂时不可用

可能原因：

• 上游服务暂时不可用
• 您的本地网络连接不稳定
• 如果您使用的是 1M 上下文模型，单次对话上下文可能已经超过 200K，且未能自动压缩

解决方案：

1. 建议先关闭 VPN 或代理工具（包括 CCSwitch 的代理）后重试。
2. 您也可以通过 Base URL + /status 检查线路是否连通。
3. 如果当前会话上下文已经超过 200K，建议新开一个会话，并切换为非 1M 上下文版本的模型。

网络异常、连接被中断

可能原因：

• 本地网络环境异常
• 代理节点不稳定
• 网络请求被防火墙拦截

解决方案：

1. 先排查本地网络环境是否正常。
2. 关闭 VPN 或代理节点后重试。
3. 如仍有问题，建议更换网络环境再次尝试。

DNS 解析异常

可能原因：

• 本地 DNS 解析出现问题
• 域名解析被污染或劫持

解决方案：

1. 检查本地 DNS 解析是否正常。
2. 您可以在终端执行以下命令测试域名解析：

dig ddshub.cc

客户端与特定环境限制

当前分组或渠道仅允许 Claude Code 客户端调用

可能原因：

• 当前您使用的分组或渠道设置了调用限制，仅允许来自 Claude Code 客户端的请求

解决方案：

请将使用环境切换为 Claude Code 客户端后再进行调用。

触发仅允许 Claude Code 客户端调用的限制

可能原因：

• 当前请求环境不在允许范围内

解决方案：

这不会影响您在 Claude Code 客户端中的正常使用。请确认当前是在 Claude Code 扩展插件环境中进行调用。

后续补充

后续如果新增“账号与并发类错误”或“认证与权限类错误”，建议继续补充在本页中，保持同一套排查入口。