排查要点
检查密钥有效性、认证方式、模型权限和供应商状态。错误码可以缩小范围，但不能单凭 401 或 403 断定具体原因。
- 适用范围
- 配置排查参考；以当前工具版本和供应商文档为准。
- 适用系统
- macOSWindowsLinux
- 问题类型
- 配置 / 兼容问题
检查凭据与认证方式
核对供应商要求 API Key 还是 Auth Token，确认字段与地址来自同一份供应商文档。不要把网页登录凭据当作 API 密钥。
检查终端环境变量、项目配置和 Claude Code 的设置文件，确认没有旧凭据覆盖 NexoX 写入的配置。不要在公开日志中保留密钥。
检查模型与账号权限
确认账号有目标模型权限、可用额度和有效订阅或 API 计费状态。网页产品订阅与第三方 API 账号的权益应分别核对。
使用相同供应商、相同模型和新会话重试。如果仍失败，保留时间、错误码和去除密钥后的错误信息，再向供应商核实。