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