本页对应 XiuRouter“Agent 集成”产品页。公开页提供占位配置；登录后可以选择 API Key 和可用模型，再用“检查实际请求”确认连接。要先比较 Codex、Claude Code 与 Cursor 的协议边界，可阅读 Agent 开发场景。
三种配置方式
- 首次配置：默认路径。创建或选择专用 API Key，再按客户端要求添加连接。
- 替换已有：保留原 provider、Base URL、模型和凭据来源作为回滚点，只新增或修改 XiuRouter 项。
- 对话协助：仅在 Agent 能访问目标配置文件或终端时提供。Agent 不读取 API Key，也不代替重启和新建任务。
集成目录
| 项目 | 主要入口 | 替换已有 | 对话协助 | 模型处理 |
|---|---|---|---|---|
| ChatGPT | ChatGPT 桌面端、Codex CLI 或 IDE | 备份后新增 provider | 可合并非密钥 TOML | 首次配置需要模型；已有同名 ID 可保留 |
| Claude Code | Claude Desktop、CLI 或 VS Code | 先记录原连接 | 不提供 | 从网关发现，再在客户端选择 |
| Cursor | Cursor Settings → Models | 记录原设置后开启 Base URL 覆盖 | 不提供 | 只覆盖符合条件的 OpenAI 系模型 |
| DeepSeek Harness | Settings → Models | 新增或编辑 xiurouter |
不提供 | 用 Fetch available models 选择 |
| OpenCode | /connect 与 opencode.json |
更新同名凭据并保留其他 provider | 可合并非密钥 JSON | 必须显式列出模型 |
| OpenWork | 工作区 .config/opencode/opencode.json |
合并工作区 provider | 不提供 | 每个工作区单独配置模型 |
| Cline | Cline 设置 | 记录原连接后切换 | 不提供 | 必须填写精确 Model ID |
| Continue | config.yaml 与本地 Secret |
追加模型项 | 可合并非密钥 YAML | 固定走 Chat Completions |
| OpenClaw | ~/.openclaw/openclaw.json |
合并 provider 和模型白名单 | 可合并非密钥 JSON | provider 和白名单都要显式列出模型 |
| Hermes Agent | 会话外运行 hermes model |
新增 Custom endpoint | 不提供 | 在 Hermes 中从 endpoint 列表选择 |
| Aider | 环境变量与 --model |
在独立终端临时切换 | 不提供 | 启动时使用 openai/模型ID |
| Open WebUI | Admin Settings → Connections | 新增独立连接 | 不提供 | 通过 /v1/models 自动发现 |
| LibreChat | librechat.yaml |
追加 custom endpoint | 不提供 | models.default 必填，fetch 扩充 |
| Vercel AI SDK | 服务端代码与环境变量 | 不提供独立路径 | 不提供 | 必须填写精确 Model ID |
替换现有连接
先记录原 provider、Base URL、模型和凭据来源。然后只新增或修改 XiuRouter 对应项，不删除原连接：
| 协议 | 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。
配置完成后必须新建会话或任务。已经运行的 Agent 进程通常保留启动时读取的环境变量、provider 和模型，不会因为配置文件被修改而自动切换。
对话协助的边界
ChatGPT 中的 Codex、OpenCode、Continue 和 OpenClaw 可以协助处理不含密钥的配置文件。其他客户端不显示该入口，因为它们依赖设置界面、父进程环境变量、服务端部署环境或会话外向导。
- 当前 Agent 进程不能修改启动它的父进程环境变量。
- API Key 不应进入模型上下文，也不应让 Agent 写入项目仓库。
- Hermes 的
/model只能切换已经配置的 provider，新增 Custom endpoint 必须退出会话后运行hermes model。 - Cline、DeepSeek Harness 和 Open WebUI 的凭据由设置界面保存，不是普通项目文件。
- 有目标配置文件权限的 Agent 可以协助合并不含密钥的 TOML、JSON 或 YAML。是否能写用户目录取决于当前沙箱和权限；凭据、重载客户端和新建任务仍需你完成。
因此各指南只提供产品页列出的配置入口。不要把“Agent 已修改文件”当作连接已切换；客户端完成请求并在 XiuRouter 控制台“检查实际请求”出现对应记录后，才算基础接入成功。
Cherry Studio、AionUI、DeepChat、Lobe Chat、OpenCat 等没有单独指南的客户端，如果当前版本提供 OpenAI Compatible、Anthropic Compatible、Gemini Compatible 或 Custom provider，也可以按对应协议配置。基础接入成功需要同时看到客户端完整回复和“检查实际请求”中的对应记录；专有工具调用、文件上传、托管搜索或特定 Responses 字段还需使用目标模型单独验证。
统一准备
- 按快速开始创建一把专用 API Key。
- 限制这把 Key 的模型、剩余额度和有效期。
- 只有客户端要求显式模型时，才从模型与价格复制精确模型 ID。
- 首次配置直接新增连接；替换已有时先保留原连接。
- 配置完成后新建一个小任务，并在“检查实际请求”核对请求。
不要复用生产项目的 Key 做试错。现有 Key 若带有 IP 限制，云端代发客户端可能因出口地址不同被拒绝；控制台当前不提供该限制的编辑入口。
怎么判断接入成功
同时满足以下三项才算接入成功：
- 客户端收到完整回复，而不是只通过“验证 Key”。
- XiuRouter 控制台“检查实际请求”出现对应 Key、模型、接口和成功状态。
- 客户端需要的最小工具调用能正常完成。
一次普通文本回复不能证明 Agent 编辑、图片、文件、托管搜索或长上下文也可用。按真实任务逐项扩大验证范围。
怎么回滚
- 保留客户端原来的 provider 或 Base URL。
- 新配置失败时，先切回原 provider，不要反复改同一把 Key 的范围。
- 删除测试 provider 前，先确认没有项目仍把它设为默认。
- 测试 Key 不再使用时，在 XiuRouter 撤销或删除。
来源与核对日期
内容核对于 2026-08-31。第三方客户端升级后，设置名称、配置文件和请求协议可能变化，请以客户端当前界面和官方文档为准。