查看客户端地址对照表,按所选服务商模式核对「字段名 → 是否带 /v1 → 最终请求路径」。Codex CLI 带 /v1,Claude Code CLI 不带;同一个软件的不同接入模式也可能不同。

先确认失败发生在哪里

  1. 软件是否安装并能启动?如果尚未启动成功,先按客户端官方安装文档处理。
  2. 地址、Key 与模型是否已在软件实际运行的环境生效?配置文件存在不代表客户端读到了它。
  3. 有没有收到真实模型回复?再核对 ABCRelay 调用记录中的时间与模型,确认请求确实经过本站。

按现象检查

HTTP 状态码只是线索,请结合返回的具体错误信息判断。

两个常见配置误区

Base URL 与完整请求 URL 不同:例如多数 OpenAI 兼容客户端填 https://www.abcrelay.com/v1,让软件自行追加路径;Cherry Studio NewAPI 和 Claude Code 按各自教程填根地址。不要重复添加 /v1 环境变量只对继承它的进程生效。在终端设置后,从同一终端启动客户端;Windows 原生应用和 WSL 是不同环境。不要为排查问题输出完整 Key 或把配置文件原样贴到公共讨论中。

提供什么信息方便排查

提供客户端名称与版本、操作系统、所选模型 ID、所用协议、发生时间、脱敏错误和请求 ID(如果有)。配置只保留字段名、地址和非敏感值,Key 用 *** 替代。不要提供账户密码或完整凭据。 回到客户端目录查看对应工具的特殊说明。