首次配置需要保存本地 Secret,并在 config.yaml 添加 XiuRouter 模型项。已有配置时保留原 models 和角色,只追加新项。本文固定使用 Chat Completions,避免客户端根据 gpt-5 名称自动改走 Responses。
选择配置方式
- 首次配置:保存 Secret,再添加一个 XiuRouter 模型项。
- 替换已有:保留原模型和角色,追加 XiuRouter 后再切换。
- 对话协助:让 Continue 合并不含密钥的 YAML;Secret、重启和新任务仍需手动完成。
前置条件
- Continue 扩展或 CLI 可以正常读取当前配置。
- 已创建一把 Continue 专用 XiuRouter API Key。
保存本地 Secret
Continue IDE 扩展不能直接读取终端中的 export。把 Key 写入 Continue 可读取的 .env 文件,例如全局配置:
# ~/.continue/.env
XIUROUTER_API_KEY=YOUR_XIUROUTER_API_KEY也可以使用工作区根目录的 .env 或 .continue/.env。不要提交这些文件;添加或修改后重启 IDE。不要只在另一个终端 export,IDE 扩展不会读取那个进程的环境。
添加模型
把下面内容合并到 Continue 当前使用的 config.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 }}
useResponsesApi: false如果配置中已有 name、version、schema 或 models,只追加这个模型项,不要覆盖其他 provider 或角色。不要把真实 Key 直接写入可提交的项目配置。
有配置文件权限的新 Agent 任务可以帮你合并这段不含密钥的 YAML。Secret 仍要由你保存到 Continue 可读取的 .env;合并后重启 IDE 并新建任务。
对话协助
先手动保存 Secret,再把下面消息发给有配置文件权限的 Continue Agent:
保留当前
config.yaml的名称、版本、模型和角色,只追加一个 XiuRouter 模型项。使用provider: openai、Base URLhttps://router-api.xiu.ai/v1、模型YOUR_MODEL_ID和useResponsesApi: false。API Key 只引用secrets.XIUROUTER_API_KEY,不要读取或写入真实密钥。修改后展示 diff。
验证
- 重新加载 Continue 配置。
- 选择
XiuRouter模型。 - 先让它只解释一个文件,不执行编辑。
- 再完成一次可撤销的小修改。
- 在 XiuRouter 控制台“检查实际请求”核对 Key、模型、
/v1/chat/completions和成功状态。
Continue 的 Chat、Edit、Apply、Autocomplete 和 Embed 可以使用不同模型。本文只配置一个 OpenAI-compatible 模型;其他角色要按各自协议和模型能力单独配置。
Continue 对部分 gpt-5 和 o 系列模型默认使用 Responses API。上面的配置显式使用 useResponsesApi: false,让本指南固定走 Chat Completions。删掉该字段前,先确认目标模型和服务分组支持 /v1/responses。
常见失败
| 现象 | 处理 |
|---|---|
| 配置没有加载 | 检查当前 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。
来源与核对日期
内容核对于 2026-08-31。Continue 收到完整回复,并在 XiuRouter“检查实际请求”中出现对应模型、接口和成功状态后,基础接入才算完成。