连接失败、报错与额度异常的排查顺序
遇到问题时,重装客户端通常无法解决实际问题,反而会清除排查所需的线索。本文按问题出现的概率从高到低排列,请逐项确认。
首先确认三项
多数问题在这三步之内即可解决。
确认 123 GPT 仍在运行
查看菜单栏(macOS)或系统托盘(Windows)中是否仍有其图标。 从托盘执行「退出」后 Codex 即无法连接;关闭窗口则无影响。 详见《认识桌面端》。确认总览页的服务状态为「运行中」
若非运行中,请将其开启。开启后请留意提示:若 Codex 正在运行,需重启后生效。完全退出 Codex 后重新打开
需完全退出而非仅关闭窗口。配置改动只在 Codex 启动时读取, 此步骤可解决大量「服务已开启但无法使用」的情况。
确认请求是否已经发出
在总览页点击服务状态一行中的 运行详情 打开高速模式面板, 随后在 Codex 中发送一条消息。
面板中立即增加一行
链路正常,问题在其他环节,请继续查看下文的具体报错。
面板没有任何变化
Codex 未经过 123 GPT。请返回上一节完全退出并重新打开 Codex; 若仍无变化,请继续下一节的配置检查。
确认配置未被其他程序修改
在侧栏服务状态卡中点击 运行详情,再在 Codex 环境中点击查看配置。详情页会直接给出结论:
当前是 123 GPT 配置
配置正常,请排查其他环节。
配置可能被覆盖
系统中存在优先级高于配置文件的环境变量, 请检查
OPENAI_API_KEY、OPENAI_BASE_URL 等设置。当前不是 123 GPT 配置
配置已被其他工具修改。将服务状态开关关闭后重新开启,即可重新写入。
该面板的内容已打码,可直接截图提供给客服,不会泄露密钥。
常见报错的含义
- 提示「正在重新连接 1/5」。这不是错误,而是 Codex 在自动重试,通常稍候即可恢复。详见《正在重新连接 x/5 的含义》。
- 提示密钥失效、401 或 403。请勿立即重新登录。此类提示有时来自上游,并不表示您的密钥确已失效。 请先按上述步骤确认链路,仍无法解决时再退出登录并重新登录。
- 提示额度不足,但账户仍有余额。请确认当前所处的空间(个人或团队),参见《团队版》; 同时确认是否为套餐窗口额度已用尽而余额为零。
- 提示 429、请求过于频繁或套餐已满。多数情况并非额度问题,而是并发数已被占满, 通常由此前未正常释放的请求所致。请等待一至两分钟,或重启 Codex。
- 纯文本请求正常,包含图片时失败。此为图片链路的问题,与模型无关。可先尝试较小的图片; 若持续出现,请联系客服并说明「纯文本正常、带图必失败」这一特征, 该信息可显著缩短排查时间。
- 收到提示升级客户端的回复。这不是错误。版本过旧的客户端会收到升级提示, 请前往 设置› 关于 检查更新。
响应速度下降
请先确认延迟出现在哪一环节。高速模式面板的「实时请求」中, 每一行均标有阶段(准备请求 / 处理附件 / 等待响应 / 接收响应 / 思考中 / 生成回复)与耗时。
停留在「等待响应」
上游正在排队或推理,属模型本身的耗时,为正常现象。
停留在「处理附件」
附件体积较大或本机上行带宽不足,可尝试减小图片尺寸。
每次均较慢
可能为本机网络问题。若电脑上安装了其他代理或加速工具, 其可能同时改变了 123 GPT 的流量路径。
手机端问题
- 手机上未显示您的电脑。请确认电脑端的远控状态为「待命中」,且两端登录的是同一手机号。 详见《1 Claw》。
- 电脑显示为离线。电脑已休眠,或 123 GPT 已退出。
- 手机端被登出。手机端为单设备登录,同一账号在其他设备登录后,当前设备将下线。
仍未解决时
请联系客服(客户端左下角账号 → 联系客服)。 为减少沟通轮次,建议一次性提供以下信息:
- 您执行的操作、预期结果与实际结果;
- 界面上原始提示的截图(请勿转述);
- 在运行详情的Codex 环境中点击查看配置,再用页面右上角复制全部得到的诊断信息 (密钥等敏感值已打码,可直接粘贴);
- 问题发生的大致时间。
请勿为排查问题而反复卸载重装。此操作会重置配置、登录状态与密钥, 同时清除原有线索,反而会延长排查时间。
