其他客户端

我在 /app/connect 首页只推了 3 个客户端(Cursor / Claude Code / Chatbox),因为它们覆盖 90% 用户。但实际上,任何支持 Anthropic 协议或 OpenAI 兼容协议的客户端都能接入 HyperAI Relay,协议栈是透明的。

这篇文档是一份"通用接入说明",给那些没单独成页面的客户端用。

通用配置原则

所有场景下你只需要这三项:

字段 值
Base URL https://api.hyper-ailab.com
API Key 你在 /app/keys 生成的 sk-relay-xxx
Model claude-opus-4-6(或 claude-sonnet-4-6 / claude-haiku-4-5)

我们不是 OpenAI 协议转换层,我们是 Anthropic 原生协议的透明代理 —— 所以首选支持 Anthropic 的客户端;如果客户端只有 OpenAI 协议而没有 Anthropic 协议,就需要一层协议转换(我列了几个常见方案在下面)。

已知兼容的客户端

下面这些我都实测过,直接填 Base URL + API Key 就能跑:

支持 Anthropic 原生协议

  • Zed:Settings → Language Models → Anthropic → 改 api_url
  • LibreChat:.env 里 ANTHROPIC_REVERSE_PROXY=https://api.hyper-ailab.com
  • Cline (VSCode 扩展):provider 选 Anthropic,自定义 endpoint
  • Aider:--anthropic-api-base https://api.hyper-ailab.com
  • Continue.dev:config.json 的 models 项里加 apiBase
  • Jan:本地模型以外,设置里支持自定义 Anthropic provider

只支持 OpenAI 协议的客户端

这些客户端不能直接连我们,需要中间加一层协议转换:

推荐方案:用 openrouter-like 开源项目(比如 one-api)在本地跑一个协议桥,对上游填我们的 Base URL + key,对客户端暴露 OpenAI /v1/chat/completions。我在考虑把这个桥做成我们自己的"官方转换层",但目前还没做(优先级没这么高)。

通用配置步骤(心法)

不管是哪个客户端,思路都一样:

  1. 找到"自定义 provider"或者"API endpoint override"设置 —— 不同客户端叫法不同,关键词搜 "anthropic" / "base url" / "api endpoint"
  2. 填三件套(见上面表格)
  3. 跑一次最简测试:问一句 "Hi, what model are you?",看返回里有没有 claude-opus-4-6 的字样
  4. 在 /app/usage 验证请求确实落到我们这里

如果第 4 步看不到请求,但客户端又能收到响应,说明你的客户端根本没走我们 —— 多半是 Base URL 填错、或者客户端硬编码了官方 URL。这种情况通常改 .env 或环境变量就能解决。

不兼容的客户端怎么办

如果你发现某个客户端的"自定义 endpoint"在我们这里报错(400 / 协议不匹配 / 格式错),有两条路:

  • 给我发 issue:邮件 admin@hyper-ailab.com,带上客户端名、版本、报错截图。不保证每个都适配,但如果用户多我会优先处理
  • 自己写转换层:我们是开放 API,自己起个 FastAPI 做协议翻译也就几十行代码

未来会不会在 /app/connect 加更多卡片?

会。我的优先级判断是看 /app/usage 里不同 User-Agent 的请求量 —— 哪些客户端的用户多,就把哪些做成一键卡片。目前排队里有 Zed 和 Cline,但没敲定上线时间。

下一步