| 缺少凭据 / 401 | 检查 Key 来源、是否完整、是否过期;环境变量是否在启动前设置 |
| 403 / permission denied | 检查 Key 与用户状态、分组、模型限制和 IP 限制 |
| 404 / 接口不存在 | 按客户端页核对地址拼接;区分 Messages、Responses 与 Chat Completions;也检查模型 ID |
| model not found / 没有可用渠道 | 核对当前 Key 的实际模型 ID、分组与渠道可用性,不能只看账号总列表 |
| 429 / 额度或限流提示 | 看具体原因,检查余额、令牌额度和并发/频率限制;避免立即反复重试 |
| 5xx / 超时 | 记录发生时间、客户端版本、模型和脱敏错误,检查服务状态;不要先随意切换协议 |
| 找不到配置文件 / 修改后不生效 | 使用客户端教程给出的完整路径;检查用户目录、覆盖变量、远程环境及多余扩展名,见路径 FAQ |
| 配置仍指向其他服务 | 检查启动参数、profile、用户级/项目级配置优先级,以及应用实际运行位置 |
| 终端可用但 IDE 不可用 | 桌面启动的编辑器、远程扩展或 WSL 可能没有相同环境变量 |
| 普通聊天正常,工具/图片失败 | 检查该模型与所选协议是否支持对应能力;基础响应不等于全部功能兼容 |
| 模型显示的上下文不对 | 按真实模型规格调整客户端支持的元数据,不照抄未知上限 |