哪里错了，就从这里排查
常见问题
接入失败通常不是大问题，多数是 Base URL、多写了路径、密钥复制不完整、当前配置没有切换成功，或者账号额度不足。
API Key required / Invalid API Key
优先检查密钥
确认客户端里填的是完整的 sk- 密钥，没有漏字符，没有多复制空格或换行。
- 重新进入本站
API 密钥页面，复制一次密钥。 - 确认密钥状态是启用。
- 如果怀疑泄露，删除旧密钥，重新创建。
404 / Not Found
最常见原因是 Base URL 填错。
| 填写方式 | 是否正确 |
|---|---|
https://issueacard.top |
正确 |
https://issueacard.top/v1 |
不推荐，容易重复路径 |
https://issueacard.top/v1/messages |
错误，不要填到具体接口 |
余额不足 / 订阅不可用
如果返回类似 INSUFFICIENT_BALANCE、SUBSCRIPTION_NOT_FOUND、API_KEY_QUOTA_EXHAUSTED，说明密钥能识别，但账号或套餐当前不能继续调用。
- 检查账号余额或订阅状态。
- 检查 API 密钥是否绑定了正确分组。
- 如果你刚充值或刚购买订阅，刷新页面后再试一次。
CC Switch 已切换，但 Claude Code 没变化
部分工具需要重新打开终端或重新启动 Claude Code 才能读取新配置。
# 退出当前 Claude Code
# 重新打开终端，进入项目目录
claude如果仍然不生效，在 CC Switch 里重新切换一次配置，或使用刷新配置功能。
想确认本站接口是否在线
可以访问健康检查地址：
https://issueacard.top/health如果返回下面内容，说明网站服务本身正常：
{"status":"ok"}仍然解决不了
联系管理员时，请尽量提供下面信息，但不要发送完整 API 密钥。
- 你使用的系统：Windows、macOS、Linux。
- 你使用的工具：Claude Code、CC Switch、OpenClaw 或其他客户端。
- 报错截图或完整错误文字。
- API 密钥前 6 位和后 4 位，中间用星号隐藏。
- 你填写的 Base URL。
不要公开完整密钥
排查问题时只发脱敏后的密钥，例如 sk-abc123****wxyz。完整密钥一旦泄露，请立即删除并重建。