第 1 步:安装并准备
从 官方下载页 选择电脑对应的系统和架构:- macOS
- Windows
- Linux
下载
.dmg:Apple Silicon(M 系列)选 arm64,Intel Mac 选 x64。打开安装包,将 AionUI 放入 Applications 后启动。YOUR_ABCRELAY_API_KEY、YOUR_MODEL_ID 分别替换为这两个实际值。
第 2 步:配置 ABCRelay
以下界面字段在 macOS、Windows、Linux 上共用。 打开 Settings → Models → Add Model,填写后保存:
Base URL 保留一个
/v1,不要追加 /chat/completions 或 /responses。普通 Custom 模式使用此地址作为前缀,再追加 /chat/completions,最终请求 https://www.abcrelay.com/v1/chat/completions。选择支持 OpenAI 兼容聊天的模型。
第 3 步:发消息验证
新建 AionUI 内置代理会话,选择刚配置的模型,发送「只回复 OK,不调用工具」。如需工作目录,先选一个空目录。 收到回复后,到 ABCRelay 控制台 核对同一时间、Key 和模型的请求记录。常见问题与详细说明
连接失败或模型不出现怎么办?
连接失败或模型不出现怎么办?
Custom 和 New API 有什么区别?
Custom 和 New API 有什么区别?
官方 Wiki 将 Custom 描述为 OpenAI 兼容模型服务,也单独提供 New API 平台。New API 可为不同模型使用 OpenAI、Gemini 或 Anthropic 协议,并支持模型级协议覆盖。本页步骤使用 Custom + 关闭完整 URL。官方当前源码确认两种平台的地址处理不同:
若切到完整 URL,字段含义变成完整请求地址,客户端不再按普通 Base URL 规则拼接;不要对着
/v1 的示例开启该开关。New API 的多协议模式仍需核对具体模型的协议支持。不要仅凭模型名称或导入成功认定协议正确,也不要将本页 Custom 聊天接法用于只支持 Responses 的模型。其他客户端的规则见地址与 /v1 对照。这会配置外部代理吗?
这会配置外部代理吗?
AionUI 支持 Windows、macOS 和 Linux,既有内置代理,也能连接外部代理。本页配置的是 AionUI 自身的 Custom 模型服务,使用 ABCRelay 的 OpenAI 兼容接口。添加这个模型服务不等于已经配置了独立的 Claude Code、Codex 或其他外部代理。外部代理的认证和配置需要按各自教程处理。AionUI 的文件、工具、图片和自动化能力也不代表每个 ABCRelay 模型都支持。
模型怎么选?可以一键导入吗?
模型怎么选?可以一键导入吗?
选择当前 Key 有权限使用、且适合本页 OpenAI 兼容接法的模型。手动填写模型名并不创建上游模型;能在界面选中,也不保证余额、有效期、分组和模型限制都满足请求条件。若 ABCRelay 当前页面提供「Chat → AionUI」,可主动使用它导入服务商信息。导入可能使用 New API 平台,和本页手动选择的 Custom 有区别;请核对平台、地址、Key、模型与协议后再试用。没有导入入口时使用上面的手动配置。
为什么 GitHub Releases 没有安装包?
为什么 GitHub Releases 没有安装包?
官方最新发布说明已将安装包迁移到 AionUI 官网。到官网选择 macOS、Windows 或 Linux 下载;GitHub Releases 仍可用于查看更新记录。
资料来源与验证范围
资料来源与验证范围
官方资料核对日期:2026-09-10。本页核对了 AionUI 官方 README、LLM Configuration Wiki 和平台地址处理源码;本次没有使用真实 ABCRelay Key 运行客户端或代理任务测试。