---
title: "选择 XiuRouter 项目集成方式"
description: "按客户端实际使用的 Chat Completions、Responses、Messages 或 Gemini GenerateContent 协议选择配置指南。"
image: "https://docs.xiu.ai/og.png"
---

> XiuAI 文档索引
> 完整文档索引：https://docs.xiu.ai/llms.txt
> 阅读前先通过索引确认当前可用页面。

# 选择 XiuRouter 项目集成方式

不要只看客户端名称判断能否接入。先确认它发送 Chat Completions、Responses、Messages 还是 Gemini GenerateContent，再选择对应指南和 Base URL。

## 集成目录

| 项目 | 协议 | 配置入口 | 当前判断 |
| --- | --- | --- | --- |
| [Codex](/router/integrations/codex) | Responses | `~/.codex/config.toml` | 路由和配置合同匹配，需用你的 Key 实测模型 |
| [Claude Code](/router/integrations/claude-code) | Messages | 环境变量 | Messages 合同匹配；需用真实小任务验证当前客户端 |
| [OpenClaw](/router/integrations/openclaw) | Chat Completions | 自定义 provider | 配置合同匹配，工具能力取决于模型 |
| [Hermes Agent](/router/integrations/hermes) | Chat Completions | `hermes model` | 自定义 endpoint 合同匹配，需验证上下文与工具调用 |
| [DeepSeek Harness](/router/integrations/dsh) | Chat Completions | Settings → Models | 自定义 provider 合同匹配，需按模型验证请求兼容项 |
| [OpenCode](/router/integrations/opencode) | Chat Completions | `/connect` 与 `opencode.json` | 使用 OpenAI Compatible provider |
| [Cline](/router/integrations/cline) | Chat Completions | VS Code 设置 | 使用 OpenAI Compatible provider |
| [Open WebUI](/router/integrations/open-webui) | Chat Completions | Admin Settings → Connections | 使用 OpenAI-compatible connection |
| [Aider](/router/integrations/aider) | Chat Completions | 环境变量与 `--model` | 使用 `openai/模型ID` |
| [LibreChat](/router/integrations/librechat) | Chat Completions | `librechat.yaml` | 使用 custom endpoint |
| [Continue](/router/integrations/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 字段，仍需单独验证。

## 接入前统一准备

1. 按[快速开始](/router/quickstart)创建一把专用 API Key。
2. 限制这把 Key 的模型、剩余额度和有效期。
3. 从[模型与价格](https://router.xiu.ai/pricing)复制精确模型 ID。
4. 先用 `curl` 跑通客户端将要使用的协议。
5. 再修改客户端配置并新建一个小任务。

不要复用生产项目的 Key 做试错。现有 Key 若带有 IP 限制，云端代发客户端可能因出口地址不同被拒绝；控制台当前不提供该限制的编辑入口。

## 怎么判断接入成功

同时满足以下三项才算接入成功：

1. 客户端收到完整回复，而不是只通过“验证 Key”。
2. XiuRouter“使用记录”出现对应模型、服务分组、状态和费用。
3. 客户端需要的最小工具调用能正常完成。

一次普通文本回复不能证明 Agent 编辑、图片、文件、托管搜索或长上下文也可用。按真实任务逐项扩大验证范围。

## 暂不列为已支持

| 项目 | 当前判断 |
| --- | --- |
| OpenWork | 当前发布版没有一条已核对、已实测的自定义模型服务配置合同；不复制参考站点的专用接入方式 |
| Cursor | 参考站点的方案依赖专用桥接；XiuRouter 尚未验证 Cursor 的自定义 Base URL、Responses 和 Apply 行为 |

这两项不是永久不支持。需要先完成当前客户端版本的真实配置和最小工具任务测试，再新增指南。

## 怎么回滚

- 保留客户端原来的 provider 或 Base URL。
- 新配置失败时，先切回原 provider，不要反复改同一把 Key 的范围。
- 删除测试 provider 前，先确认没有项目仍把它设为默认。
- 测试 Key 不再使用时，在 XiuRouter 撤销或删除。

## 参考范围

Cheaper Inference 的集成页用于参考信息架构：按应用列出前置条件、配置、验证、限制和回滚。本文覆盖了有 XiuRouter 路由和客户端官方配置合同的项目，并明确列出未验证项；没有复制其服务能力、专用桥接、模型支持或兼容承诺。

## 来源与核对日期

本文按 XiuRouter 当前路由和各客户端配置方式整理，核对日期为 2026-08-19。第三方客户端升级后，设置名称、配置文件和请求协议可能变化。

源文件：https://docs.xiu.ai/router/integrations/index.mdx