​
第 1 步：获取 Key 和模型 ID

登录 ABCRelay，在 API Key / 令牌 页面创建或选择一个有效 Key，并选一个该 Key 有权限使用的模型。 教程中的 YOUR_ABCRELAY_API_KEY 替换为这个 Key，YOUR_MODEL_ID 替换为模型的实际 API ID。

​
第 2 步：选择客户端，填写配置

打开 客户端接入目录，选择你正在使用的软件，按教程填写地址、Key 和模型。地址以对应客户端指南为准： 查看客户端地址对照表，按所选服务商模式核对「字段名 → 是否带 /v1 → 最终请求路径」。Codex CLI 带 /v1，Claude Code CLI 不带；同一个软件的不同接入模式也可能不同。

​
第 3 步：发送第一条消息

在客户端发送「只回复 OK」。收到回复后，到 ABCRelay 调用记录核对同一时间、Key 和模型的请求。 没有成功？先看客户端教程末尾的 FAQ，或查看 接入排错。

​
常见问题与详细说明

先查看按操作系统选择，再在客户端教程的 macOS / Windows / Linux 标签中选择你的系统。公共的服务地址、Key 和模型配置通常只需填写一次。客户端教程将 Key 保存在应用或用户配置文件中，新终端无需重新配置。复制当前系统标签中的完整路径和配置内容即可；路径变量只用于表示用户目录。安装支持不代表全部模型功能已在本站实测。
Key 应已启用、未过期、额度可用，且分组、模型限制和 IP 限制允许当前用途。它是 API 凭据，不是账户密码或其他平台的订阅登录信息；不要分享真实 Key 或提交到代码仓库。选择当前 Key 实际有权限的模型 ID。账户能看到的模型不一定都对这个 Key 开放；别名或映射场景中，填写网关暴露给客户端的名字。
它们是客户端发送请求时使用的协议。先按客户端教程选择接入方式，再确认模型支持该协议。模型还可能有工具、图片和上下文限制。模型名称相似或出现在列表中，并不能证明它支持所有协议和功能。
客户端会以不同方式补充请求路径。大多数 OpenAI 兼容客户端的 Base URL 写到 /v1；Claude Code 通常填写根地址。Cherry Studio 的 New API 字段会自行补路径，也填根地址。文档站域名和 /docs 路径不是 API 地址。避免重复 /v1，也不要把完整的 /chat/completions 等操作路径填进基础地址字段。
这条可选命令只查询模型列表，不保存客户端配置，也不发送推理请求。选择你的终端，在命令中直接替换 Key 后执行：
列表可用于核对 ID 和可见范围，不能证明模型的全部协议支持或上游此刻可用。失败时按返回信息查看 接入排错。
保存配置、加载模型列表和本地状态检查，都不能代替一次真实模型请求。发送消息并核对调用记录后，才确认这次请求成功；真实调用会消耗对应额度。基础聊天通过后，再分别验证所需的流式输出、工具调用、图片或其他功能。