Agent 接入
Roo Code Agent 接入
Roo Code 是用于 VS Code 和 JetBrains 的编辑器编码 Agent，可以检查与修改工作区、运行命令，并在不同任务模式间切换。它的 OpenAI Compatible 提供方可以直接连接 Lumoswitch。
请先创建输出协议为 OpenAI-compatible 的 Lumoswitch 配置 API。模型必须支持原生工具调用，Roo 的文件编辑和终端操作依赖结构化工具。
选择接入方式
| 方式 | 是否支持 | 说明 |
|---|---|---|
| 仅本次启动 | 否 | 编辑器扩展管理提供方状态和加密凭证 |
| 永久使用 | 是 | 在 Roo 中保存命名 API 配置档案 |
| 清除接入 | 是 | 只删除 Lumoswitch 配置档案和对应凭证 |
| 设置导入 | 可选 | Roo 支持导入配置档案，但导出文件会以明文包含 API Key |
Lumoswitch 不为 Roo 发布终端自动导入。当前 Roo CLI 的提供方列表没有通用自定义 OpenAI-compatible 端点，而编辑器扩展通过编辑器 SecretStorage 保存凭证。
准备连接值
| 占位符 | 值 |
|---|---|
{{api_base_url}} | 下游 API URL，包含 /v1 |
{{access_key}} | 为该配置选择的 Lumoswitch Access Key |
{{model}} | 配置 API 显示的「下游模型名称」 |
配置 Roo 档案
- 在 VS Code 或 JetBrains 中安装并打开官方 Roo Code 扩展。
- 打开 Roo 设置，新建名为
Lumoswitch的 API Configuration Profile。 - API Provider 选择 OpenAI Compatible。
- Base URL 填写
{{api_base_url}}，API Key 填写{{access_key}}，Model 填写{{model}}。 - 填写模型真实的上下文窗口和最大输出长度，不要直接假设上游默认值。
- 保存并选中档案，先执行一个小型只读任务，再允许编辑文件或运行终端命令。
请保持原生工具调用开启。如果模型无法可靠调用工具，应改用其他 Lumoswitch 配置，而不是把聊天成功视为完整的 Agent 验证。
谨慎复用设置
在编辑器或机器之间迁移配置时，应使用 Roo 原生的 Export Settings 和 Import Settings。导出的设置会以明文包含 API Key，因此：
- 只把导出文件放在私有位置；
- 不要提交到仓库，也不要附加到 Issue；
- 导入并验证后删除传输文件。
如果团队已经维护受保护的 Roo 设置导出，可以让 VS Code 设置 roo-cline.autoImportSettingsPath 指向它。只有明确了解文件生命周期和访问控制时才这样做；本指南不会自动启用。
清除接入
- 打开 Roo 的 API Configuration Profiles。
- 选择
Lumoswitch，使用配置档案删除操作。 - 如果 Roo 仍显示旧凭证，请通过同一提供方界面清除档案凭证，然后重新加载编辑器。
- 删除任何包含 Access Key 的临时设置导出文件。
不要删除整个 Roo 扩展数据目录，其中可能有任务历史、模式、规则和其他提供方；编辑器 SecretStorage 也可能单独管理。
验证与排错
401表示保存的档案 Key 缺失、已失效，或绑定在其他档案上。- 遇到
404，检查是否重复拼接/v1，并确认填写的是下游模型名称。 - 请求成功但工具失败时，检查模型的原生工具调用能力，并确认 Lumoswitch 输出协议为 OpenAI-compatible。
- 上下文和输出限制必须准确；虚高的数值会让 Roo 构造出模型无法接受的请求。
参考：Roo OpenAI Compatible 提供方、设置管理 和 API 配置档案。最后核验：2026-08-23。
维护者发布字段
- 平台 ID：
roo-code - 显示名称：
Roo Code - 下游协议：
openai-compatible - 临时发布：关闭；Roo 编辑器扩展管理提供方状态与凭证
- 永久发布：关闭；原生配置档案和 SecretStorage 比改写编辑器状态更安全
- 显示顺序：
89 - 最后核验：
2026-08-23