SUPPORT

常见问题

按错误状态、软件配置和控制台状态快速排查常见接入问题。

Base URL 到底填哪个？

新配置统一填写 https://keygo.vip。OpenAI 兼容格式和 Claude Code 都优先使用这个根地址。老软件如果强制要求 /v1，可以使用兼容地址 https://keygo.vip/v1。

为什么不能写成 /v1/v1？

有些客户端会自动追加 /v1。如果你手动填写 https://keygo.vip/v1，软件再追加一次，就会变成错误路径。遇到这种软件应填写 https://keygo.vip。

收到 401 Unauthorized 怎么办？

检查 API Key 是否完整、是否复制了多余空格、是否已经被停用。请求头必须是 Authorization: Bearer YOUR_KEYGO_API_KEY。不要使用登录密码代替 API Key。

收到 403 Forbidden 或无权限怎么办？

检查 API Key 是否绑定了正确分组，模型是否对该分组开放。专属组需要显式授权，普通用户和管理员都必须被授权后才能看到和使用。

收到 429 Too Many Requests 怎么办？

通常和余额、并发、频率、模型额度或上游限流有关。降低并发，等待一段时间后重试；生产环境应使用有限次数指数退避，不要高频循环重试。

模型不可用或模型不存在怎么办？

模型名称必须使用控制台里当前账号可用的精确模型 ID。不同分组可见模型可能不同，切换 API Key 或号池后需要重新确认模型。

Claude Code 没有走 KeyGo 怎么办？

确认终端环境变量已生效：ANTHROPIC_BASE_URL=https://keygo.vip，ANTHROPIC_AUTH_TOKEN=YOUR_KEYGO_API_KEY。设置后重新打开终端，再运行 claude doctor 或重新启动 claude。

充值后仍提示余额不足怎么办？

先刷新控制台确认余额是否到账。如果余额已经到账但请求仍失败，检查是否使用了旧 API Key、错误账号或余额被冻结。必要时提供订单号和脱敏后的请求时间。

请求超时或 5xx 怎么处理？

先进行一次有限重试。如果持续失败，请记录请求时间、模型、Base URL、状态码、客户端名称和请求 ID，再联系支持人员排查。

API Key 泄露了怎么办？

立即进入控制台停用或删除该密钥，然后创建新密钥。检查代码仓库、环境变量、日志和客户端配置，确认旧密钥没有继续被使用。

联系支持前请准备