接入到 Roo Code (VS Code 插件)

Roo Code 是一款强大的 VS Code AI 编程助手。本教程将引导您如何在 Roo Code 中配置灵息 API。

配置步骤

1. 安装插件

在 VS Code 扩展市场搜索并安装 Roo Code。

2. 进入设置

安装完成后，点击 VS Code 左侧活动栏的 Roo Code 图标，在打开的面板右上角点击 “设置” (齿轮图标 ⚙️)。

3. 新建配置文件

在设置界面的顶部 “配置文件 (Settings Profiles)” 栏，点击 “+” 号新建一个配置，可以命名为 LingXi 或 BreathAI。

4. 填写配置参数

请按照下图示例进行配置：

参数项	填写内容
API 提供商 (API Provider)	选择 OpenAI Compatible
OpenAI 基础 URL (Base URL)	https://ask.ling.rest/api/v1
API 密钥 (API Key)	您的灵息 API Key
模型 (Model ID)	填入模型 ID，如 gemini-3-pro-preview-vertex

🚨 核心注意：基础 URL

在 Roo Code 中配置时，请务必确保 URL 正确：

• ✅ 推荐：https://ask.ling.rest/api/v1
• 如果您在连接测试时遇到问题，请检查结尾是否包含 /v1。

推荐模型设置

为了获得最佳的编程辅助体验，建议在 “模型” 栏中填入以下高性能模型之一：

• gemini-3-pro-preview-vertex (推荐：平衡速度与逻辑能力)
• gpt-5.2-codex (推荐：推理能力最强，适合复杂任务)
• claude-opus-4.5-20251101 (推荐：编程能力最强，适合复杂代码生成任务)

常见问题排查

• 连接失败 (Connection Error)：
  • 请确认您的网络可以正常访问 ask.ling.rest。
  • 检查 API Key 是否有误，建议先在 API 测试场 验证。
• 模型不响应：
  • 请确认填写的模型 ID 是否在 模型名获取 列表中。
  • 部分模型可能需要较高的 Token 限制，Roo Code 默认会自动处理。

💡 小技巧

您可以创建多个配置文件（Profile），分别对应不同的模型（如一个用于快速 Flash 模型，一个用于高逻辑 Pro 模型），点击顶部的下拉菜单即可快速切换。