常见问题

报错 / 现象	含义	建议处理
401 API_KEY_REQUIRED	请求没有携带有效认证头	检查 Codex++ 供应商 Key 是否填写并启用
401 INVALID_API_KEY	Key 填错、已撤销或仍在使用旧 Key	在主站确认当前有效 Key，重新填入 Codex++
403 INSUFFICIENT_BALANCE	用户没有可用余额/订阅预算	检查订阅是否生效，必要时联系管理员
“从上游获取模型”失败	Codex++ 无法同步模型列表	检查 纯 API、Base URL、个人 Key、订阅状态；修复后重新获取
Codex 仍显示官方模型	模型目录或进程缓存未刷新	彻底退出 Codex/Codex++ 后从 Codex++ 冷启动
能聊天但不能执行 Agent / 文件工具	使用了 Chat Completions / Chat-only 模型	切换到 Responses API，并选择 Agent 模型；deepseek-v4-pro 不用于 Agent
Pro 在 Codex Agent 中失败	deepseek-v4-pro 是 Chat Completions	这是 Chat only；普通聊天可用，Agent 请换 Responses 模型
503 No available accounts	对应模型没有可调度上游账号	联系管理员检查账号状态、模型权限和分组

向管理员反馈问题时，请提供：发生时间、模型名、HTTP 状态码、错误消息、Request ID。不要提供完整 API Key。