Kilo Code

在 Kilo Code 中通过 OpenAI Compatible Provider 接入 Ling.AI

适用边界

Kilo Code 可在 VS Code 扩展里选择 OpenAI Compatible provider。Ling.AI 接入时 Base URL 使用 https://api.lingyuncx.com/v1,API Key 使用 Ling.AI API Key,模型 ID 使用 /v1/models 当前返回值。

CC Switch 说明

CC Switch 当前公开支持的 app-specific provider 不包含 Kilo Code。Kilo Code 请在自己的 Provider 设置中配置;不要把 Claude Code、Codex 或 OpenCode 的 CC Switch 配置套到 Kilo Code 上。

准备

  • 安装 Kilo Code,并确认 VS Code 侧边栏能看到 Kilo Code 图标。
  • 在 Ling.AI 控制台创建 API Key,确认余额、套餐和模型授权可用。
  • 请求 GET https://api.lingyuncx.com/v1/models,复制一个适合代码任务的模型 ID。
  • 确认当前 Kilo Code 版本提供 OpenAI Compatible provider。

选择 Provider

Kilo Code OpenAI Compatible provider 下拉框公开截图
公开截图示例:Kilo Code Provider 下拉框中选择 OpenAI Compatible。
  1. 打开 Kilo Code。 在 VS Code 左侧 Activity Bar 点击 Kilo Code 图标。
  2. 进入设置。 点击 Kilo Code 面板右上角设置图标。
  3. 选择 provider。 在 API Provider 下拉框中选择 OpenAI Compatible
  4. 不要选择 OpenAI 原生项。 Ling.AI 是 OpenAI-compatible 网关,应使用可自定义 Base URL 的 provider。

填写参数

Kilo Code OpenAI Compatible provider 配置公开截图
公开截图示例:Kilo Code OpenAI Compatible 配置区域。示例图里的供应商地址和模型名需要替换为 Ling.AI。
字段 填写值 说明
Base URL https://api.lingyuncx.com/v1 Kilo Code 也支持完整 endpoint,但 Ling.AI 推荐只填到 /v1
API Key sk-xxxxxxxx 填 Ling.AI API Key,不写入仓库。
Model ID your-model-id-from-v1-models 必须和 /v1/models 返回的 id 完全一致。
Context Window 按模型能力填写 不要盲目填最大值;先用模型目录或 /v1/models 能力确认。
Image / Computer Use 按需开启 只有模型和 Ling.AI 账号能力都支持时再开启。

验证

  1. 保存 Kilo Code 设置。
  2. 先发送只读 prompt,例如“解释当前文件的主要逻辑”。
  3. 确认 Kilo Code 返回结果。
  4. 回到 Ling.AI 控制台核对请求状态、模型 ID、usage 和钱包扣费。
  5. 只读验证通过后,再使用 Code / Debug / Architect 等会写文件或执行命令的模式。

排障

问题 先检查 处理方式
Invalid API Key Key 是否复制完整、是否启用 用同一个 Key 请求 /v1/models 验证,再回到 Kilo Code。
Model Not Found 模型 ID 是否来自 /v1/models 重新复制 id,不要使用截图里的旧模型名。
404 或连接失败 Base URL 是否正确 使用 https://api.lingyuncx.com/v1;不要填网站首页。
输出被截断 Max Output Tokens 和模型限制 调高输出限制,但不要超过模型能力。

参考资料