不要只看客户端名称判断能否接入。先确认它发送 Chat Completions、Responses、Messages 还是 Gemini GenerateContent，再选择对应指南和 Base URL。
集成目录
| 项目 | 协议 | 配置入口 | 当前判断 |
|---|---|---|---|
| Codex | Responses | ~/.codex/config.toml |
路由和配置合同匹配，需用你的 Key 实测模型 |
| Claude Code | Messages | 环境变量 | Messages 合同匹配；需用真实小任务验证当前客户端 |
| OpenClaw | Chat Completions | 自定义 provider | 配置合同匹配，工具能力取决于模型 |
| Hermes Agent | Chat Completions | hermes model |
自定义 endpoint 合同匹配，需验证上下文与工具调用 |
| DeepSeek Harness | Chat Completions | Settings → Models | 自定义 provider 合同匹配，需按模型验证请求兼容项 |
| OpenCode | Chat Completions | /connect 与 opencode.json |
使用 OpenAI Compatible provider |
| Cline | Chat Completions | VS Code 设置 | 使用 OpenAI Compatible provider |
| Open WebUI | Chat Completions | Admin Settings → Connections | 使用 OpenAI-compatible connection |
| Aider | Chat Completions | 环境变量与 --model |
使用 openai/模型ID |
| LibreChat | Chat Completions | librechat.yaml |
使用 custom endpoint |
| Continue | Chat Completions / Responses | config.yaml |
使用 OpenAI provider；实际协议取决于模型和配置 |
从其他 API 服务切换
已经在使用其他兼容 API 时，先按客户端协议替换连接信息：
| 协议 | Base URL | 认证 |
|---|---|---|
| OpenAI Chat Completions | https://router-api.xiu.ai/v1 |
Authorization: Bearer |
| OpenAI Responses | https://router-api.xiu.ai/v1 |
Authorization: Bearer |
| Anthropic Messages | https://router-api.xiu.ai |
x-api-key；部分客户端使用 Bearer Token |
| Gemini GenerateContent | https://router-api.xiu.ai |
x-goog-api-key 或 key 查询参数 |
把认证值换成你的 XiuRouter API Key。目标模型 ID 在 XiuRouter 中相同时，原模型配置可以保留；没有相同 ID 时，再改为当前目录中的精确模型 ID。
Cherry Studio、AionUI、DeepChat、Lobe Chat、OpenCat 等没有单独指南的客户端，如果当前版本提供 OpenAI Compatible、Anthropic Compatible、Gemini Compatible 或 Custom provider，也可以按对应协议配置。本轮没有逐一运行真实 Key 任务；客户端收到完整回复并在“使用记录”中出现对应请求后，才算基础接入成功。客户端若依赖专有工具调用、文件上传、托管搜索或特定 Responses 字段，仍需单独验证。
接入前统一准备
- 按快速开始创建一把专用 API Key。
- 限制这把 Key 的模型、剩余额度和有效期。
- 从模型与价格复制精确模型 ID。
- 先用
curl跑通客户端将要使用的协议。 - 再修改客户端配置并新建一个小任务。
不要复用生产项目的 Key 做试错。现有 Key 若带有 IP 限制，云端代发客户端可能因出口地址不同被拒绝；控制台当前不提供该限制的编辑入口。
怎么判断接入成功
同时满足以下三项才算接入成功：
- 客户端收到完整回复，而不是只通过“验证 Key”。
- XiuRouter“使用记录”出现对应模型、服务分组、状态和费用。
- 客户端需要的最小工具调用能正常完成。
一次普通文本回复不能证明 Agent 编辑、图片、文件、托管搜索或长上下文也可用。按真实任务逐项扩大验证范围。
暂不列为已支持
| 项目 | 当前判断 |
|---|---|
| OpenWork | 当前发布版没有一条已核对、已实测的自定义模型服务配置合同；不复制参考站点的专用接入方式 |
| Cursor | 参考站点的方案依赖专用桥接；XiuRouter 尚未验证 Cursor 的自定义 Base URL、Responses 和 Apply 行为 |
这两项不是永久不支持。需要先完成当前客户端版本的真实配置和最小工具任务测试，再新增指南。
怎么回滚
- 保留客户端原来的 provider 或 Base URL。
- 新配置失败时，先切回原 provider，不要反复改同一把 Key 的范围。
- 删除测试 provider 前，先确认没有项目仍把它设为默认。
- 测试 Key 不再使用时，在 XiuRouter 撤销或删除。
参考范围
Cheaper Inference 的集成页用于参考信息架构：按应用列出前置条件、配置、验证、限制和回滚。本文覆盖了有 XiuRouter 路由和客户端官方配置合同的项目，并明确列出未验证项；没有复制其服务能力、专用桥接、模型支持或兼容承诺。
来源与核对日期
本文按 XiuRouter 当前路由和各客户端配置方式整理，核对日期为 2026-08-19。第三方客户端升级后，设置名称、配置文件和请求协议可能变化。