错误码对照

按客户端里看到的状态码找到对应行；报错文案取自真实日志，可能略有出入。

快速对照

状态码	报错文案	原因 → 处理
401	API_KEY_DISABLED / API key is disabled / 401 Unauthorized	密钥错误、未启用，或达到你自己设置的额度上限后被自动停用 → 到「API 密钥」页面启用或调整额度；还不行就换一把密钥
403	INSUFFICIENT_BALANCE / insufficient balance	余额不足。余额卡分组走账户余额，订阅卡分组走订阅额度 → 确认密钥分组是否选对；充值或续订
403	this group only allows Claude Code	该分组只允许 Claude Code 这个客户端调用 → 用 Claude Code，或换一个分组的密钥
403	Upstream returned HTTP 403	上游账号临时拒绝，多为号池个别账号问题 → 稍后重试或换分组；持续出现请联系客服
403	Your request was blocked	被 Cloudflare 拦截，常见于代理或 IPv6 出口 → 关闭代理用国内环境直连；关闭 IPv6
413	Request Entity Too Large	请求体超过服务器接收上限 → 另起一个新对话
429	Too Many Requests	到达订阅或余额限额；群里多人同时反馈则是号池额度用尽 → 站内查看订阅 / 余额；号池问题联系客服补号
502	stream disconnected before completion / stream_read_error	上下文压缩失败或上游流中断 → 重试；不行就另起新对话
503	Service Unavailable / No available accounts / model_not_supported	该分组当前没有可用账号，或模型不在分组支持列表里 → 核对模型名是否在 可用渠道；号池临时无账号时稍后重试
503	Service temporarily unavailable … cf-ray: …	带 cf-ray 字样是被 Cloudflare 拦截 → 关闭代理，用国内环境直连
504	Gateway Time-out	上下文压缩返回超时 → 重试几次；还不行就另起新对话，或把上下文调小（见下）
—	An error occurred while processing your request…	上游偶发错误 → 重试

504 超时：把上下文调小

Codex 的 ~/.codex/config.toml 里把这两个值改小一些，保存后重启：

model_context_window = 400000
model_auto_compact_token_limit = 300000

分组与余额

• 余额卡分组：按账户余额扣费，余额不足报 403 INSUFFICIENT_BALANCE。
• 订阅卡分组：按订阅套餐额度扣减，额度用完报 429，续订后恢复。
• 一把密钥只对应一个分组，换分组就是换密钥。

还是解决不了

把完整报错文案、使用的模型和大致时间发给客服（每日 9:00–23:00），我们会在日志里定位这次请求。