教程/遇到问题

连接失败、报错与额度异常的排查顺序

遇到问题时,重装客户端通常无法解决实际问题,反而会清除排查所需的线索。本文按问题出现的概率从高到低排列,请逐项确认。

7 分钟更新于 2026 年 8 月 26 日macOSWindows
本页内容

首先确认三项

多数问题在这三步之内即可解决。

  1. 确认 123 GPT 仍在运行

    查看菜单栏(macOS)或系统托盘(Windows)中是否仍有其图标。 从托盘执行「退出」后 Codex 即无法连接;关闭窗口则无影响。 详见《认识桌面端》
  2. 确认总览页的服务状态为「运行中」

    若非运行中,请将其开启。开启后请留意提示:若 Codex 正在运行,需重启后生效。
  3. 完全退出 Codex 后重新打开

    需完全退出而非仅关闭窗口。配置改动只在 Codex 启动时读取, 此步骤可解决大量「服务已开启但无法使用」的情况。

确认请求是否已经发出

在总览页点击服务状态一行中的 运行详情 打开高速模式面板, 随后在 Codex 中发送一条消息。

面板中立即增加一行
链路正常,问题在其他环节,请继续查看下文的具体报错。
面板没有任何变化
Codex 未经过 123 GPT。请返回上一节完全退出并重新打开 Codex; 若仍无变化,请继续下一节的配置检查。

确认配置未被其他程序修改

在侧栏服务状态卡中点击 运行详情,再在 Codex 环境中点击查看配置。详情页会直接给出结论:

当前是 123 GPT 配置
配置正常,请排查其他环节。
配置可能被覆盖
系统中存在优先级高于配置文件的环境变量, 请检查 OPENAI_API_KEYOPENAI_BASE_URL 等设置。
当前不是 123 GPT 配置
配置已被其他工具修改。将服务状态开关关闭后重新开启,即可重新写入。
该面板的内容已打码,可直接截图提供给客服,不会泄露密钥。

常见报错的含义

  • 提示「正在重新连接 1/5」。这不是错误,而是 Codex 在自动重试,通常稍候即可恢复。详见《正在重新连接 x/5 的含义》
  • 提示密钥失效、401 或 403。请勿立即重新登录。此类提示有时来自上游,并不表示您的密钥确已失效。 请先按上述步骤确认链路,仍无法解决时再退出登录并重新登录。
  • 提示额度不足,但账户仍有余额。请确认当前所处的空间(个人或团队),参见《团队版》; 同时确认是否为套餐窗口额度已用尽而余额为零。
  • 提示 429、请求过于频繁或套餐已满。多数情况并非额度问题,而是并发数已被占满, 通常由此前未正常释放的请求所致。请等待一至两分钟,或重启 Codex。
  • 纯文本请求正常,包含图片时失败。此为图片链路的问题,与模型无关。可先尝试较小的图片; 若持续出现,请联系客服并说明「纯文本正常、带图必失败」这一特征, 该信息可显著缩短排查时间。
  • 收到提示升级客户端的回复。这不是错误。版本过旧的客户端会收到升级提示, 请前往 设置›  关于 检查更新。

响应速度下降

请先确认延迟出现在哪一环节。高速模式面板的「实时请求」中, 每一行均标有阶段(准备请求 / 处理附件 / 等待响应 / 接收响应 / 思考中 / 生成回复)与耗时。

停留在「等待响应」
上游正在排队或推理,属模型本身的耗时,为正常现象。
停留在「处理附件」
附件体积较大或本机上行带宽不足,可尝试减小图片尺寸。
每次均较慢
可能为本机网络问题。若电脑上安装了其他代理或加速工具, 其可能同时改变了 123 GPT 的流量路径。

手机端问题

  • 手机上未显示您的电脑。请确认电脑端的远控状态为「待命中」,且两端登录的是同一手机号。 详见《1 Claw》
  • 电脑显示为离线。电脑已休眠,或 123 GPT 已退出。
  • 手机端被登出。手机端为单设备登录,同一账号在其他设备登录后,当前设备将下线。

仍未解决时

请联系客服(客户端左下角账号 → 联系客服)。 为减少沟通轮次,建议一次性提供以下信息:

  • 您执行的操作、预期结果与实际结果;
  • 界面上原始提示的截图(请勿转述);
  • 运行详情Codex 环境中点击查看配置,再用页面右上角复制全部得到的诊断信息 (密钥等敏感值已打码,可直接粘贴);
  • 问题发生的大致时间。
请勿为排查问题而反复卸载重装。此操作会重置配置、登录状态与密钥, 同时清除原有线索,反而会延长排查时间。