适用边界
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。 在 VS Code 左侧 Activity Bar 点击 Kilo Code 图标。
- 进入设置。 点击 Kilo Code 面板右上角设置图标。
- 选择 provider。 在 API Provider 下拉框中选择 OpenAI Compatible。
- 不要选择 OpenAI 原生项。 Ling.AI 是 OpenAI-compatible 网关,应使用可自定义 Base URL 的 provider。
填写参数
| 字段 | 填写值 | 说明 |
|---|---|---|
| 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 账号能力都支持时再开启。 |
验证
- 保存 Kilo Code 设置。
- 先发送只读 prompt,例如“解释当前文件的主要逻辑”。
- 确认 Kilo Code 返回结果。
- 回到 Ling.AI 控制台核对请求状态、模型 ID、usage 和钱包扣费。
- 只读验证通过后,再使用 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 和模型限制 | 调高输出限制,但不要超过模型能力。 |