---
title: "将 Continue 接入 XiuRouter"
description: "在 Continue config.yaml 中添加 OpenAI-compatible XiuRouter 模型，并用本地 Secret 提供 API Key。"
image: "https://docs.xiu.ai/og.png"
---

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

# 将 Continue 接入 XiuRouter

Continue 可以通过 `provider: openai` 和自定义 `apiBase` 连接 XiuRouter。模型 ID 使用 XiuRouter 当前目录中的精确值。Continue 会根据模型和配置调用 Chat Completions 或 Responses API。

## 前置条件

- Continue 扩展或 CLI 可以正常读取当前配置。
- 已创建一把 Continue 专用 XiuRouter API Key。

## 配置 Secret

Continue IDE 扩展不能直接读取终端中的 `export`。把 Key 写入 Continue 可读取的 `.env` 文件，例如全局配置：

```dotenv
# ~/.continue/.env
XIUROUTER_API_KEY=YOUR_XIUROUTER_API_KEY
```

也可以使用工作区根目录的 `.env` 或 `.continue/.env`。不要提交这些文件；添加或修改后重启 IDE。Continue CLI 可以从启动进程的环境变量读取同名 Secret。

## 添加模型

把下面内容合并到 Continue 当前使用的 `config.yaml`：

```yaml
name: Local Config
version: 1.0.0
schema: v1

models:
  - name: XiuRouter
provider: openai
model: YOUR_MODEL_ID
apiBase: https://router-api.xiu.ai/v1
apiKey: ${{ secrets.XIUROUTER_API_KEY }}
```

如果配置中已有 `name`、`version`、`schema` 或 `models`，只合并模型项，不要覆盖其他 provider。不要把真实 Key 直接写入可提交的项目配置。

## 验证

1. 重新加载 Continue 配置。
2. 选择 `XiuRouter` 模型。
3. 先让它只解释一个文件，不执行编辑。
4. 再完成一次可撤销的小修改。
5. 在 XiuRouter“使用记录”核对模型、状态、Token 和费用。

Continue 的 Chat、Edit、Apply、Autocomplete 和 Embed 可以使用不同模型。本文只配置一个 OpenAI-compatible 模型；其他角色要按各自协议和模型能力单独配置。

Continue 对部分 `gpt-5` 和 o 系列模型默认使用 Responses API。文本请求失败时，先确认目标模型和服务分组是否支持 `/v1/responses`；需要强制使用 Chat Completions 时，再按 Continue 当前配置参考设置 `useResponsesApi: false`。

## 常见失败

| 现象 | 处理 |
| --- | --- |
| 配置没有加载 | 检查当前 Continue 版本实际读取的 `config.yaml` |
| `401` | 确认 `.env` 中的 Secret 名称为 `XIUROUTER_API_KEY`，重启 IDE，并核对 Key 是否有效 |
| 模型不可用 | 从 `/v1/models` 复制精确 ID，并检查 Key 的分组和模型限制 |
| Chat 配置正确但请求失败 | 确认 Continue 实际发送的是 `/v1/chat/completions` 还是 `/v1/responses`，再核对模型协议 |
| Chat 成功但 Edit 或 Apply 失败 | 为该角色选择已验证模型，不要把一次 Chat 成功视为全部角色兼容 |

## 回滚

从 `models` 删除 XiuRouter 项，重新加载配置并切回原模型。确认没有 Continue 配置仍引用该 Secret 后，撤销测试 Key。

## 来源与核对日期

本文按 Continue 当前 OpenAI provider、Secret 引用方式、协议选择和 XiuRouter 文本接口核对，日期为 2026-08-19。本轮未运行真实 Continue 计费任务。

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