Cline

在 VS Code Cline 插件中通过 OpenAI Compatible Provider 接入 Ling.AI

适用边界

Cline 适合在 VS Code 内使用 Ling.AI 做代码解释、补丁生成、文件读取和轻量自动化。接入方式是 Cline 自带的 OpenAI Compatible provider，Base URL 填 https://api.lingyuncx.com/v1。

CC Switch 说明

CC Switch 当前公开支持的 app-specific provider 不包含 Cline。Cline 请在 VS Code 插件自己的 Provider 设置中配置，不要手工改 VS Code 全局存储数据库，也不要把个人 API Key 写入仓库。

准备

安装 VS Code 和 Cline 扩展。
在 Ling.AI 控制台创建 API Key，并确认余额、套餐或赠送额度可用。
请求 GET https://api.lingyuncx.com/v1/models，复制一个当前启用的 chat 模型 ID。

打开配置

Cline OpenAI Compatible Provider 配置截图 — 公开截图示例：Cline 设置页中选择 OpenAI Compatible，并填写 Base URL、API Key、Model ID。

打开 VS Code。 进入要使用 Cline 的项目。
打开 Cline 侧边栏。 点击 Activity Bar 中的 Cline 图标。
进入设置。 点击 Cline 面板中的齿轮或账户/Provider 设置入口。
选择 Provider。 在 API Provider 下拉框中选择 OpenAI Compatible。

填写参数

字段	填写值	说明
Base URL	`https://api.lingyuncx.com/v1`	只填到 `/v1`，不要追加 `/chat/completions`。
API Key	`sk-xxxxxxxx`	填 Ling.AI API Key。不要写入项目文件。
Model ID	`your-model-id-from-v1-models`	必须使用 `/v1/models` 当前返回的 `id`。

settings

API Provider: OpenAI Compatible
Base URL: https://api.lingyuncx.com/v1
API Key: <YOUR_LING_AI_API_KEY>
Model ID: your-model-id-from-v1-models

验证

保存 Cline 配置。
先发只读请求，例如“解释当前打开文件的主要逻辑”。
确认 Cline 能返回结果。
到 Ling.AI 控制台核对请求状态、模型 ID、usage 和钱包扣费。
只读验证通过后，再让 Cline 执行文件修改或命令任务。

排障

问题	先检查	处理方式
连接失败或 404	Base URL 是否带 `/v1`	改为 `https://api.lingyuncx.com/v1`，不要填完整接口路径。
模型不可用	Model ID 是否来自 `/v1/models`	重新请求模型列表，复制返回的 `id`。
请求被拒绝	API Key、IP 白名单、余额和模型授权	先用 curl 请求 `/v1/models` 验证 Key，再回到 Cline 测试。
大任务中断	模型上下文、Cline 上下文设置、工具权限	先缩小文件范围，确认模型支持所需上下文后再提高任务复杂度。

参考资料