Cline
Cline 接入 菜ai 教程
Cline 是一款极其强大的 VS Code 智能编程插件，它能够在你的授权下自主读取项目、创建/编辑文件、运行终端命令，甚至使用浏览器。
本文将引导你通过 OpenAI 兼容模式，将 Cline 的底层大脑无缝切换为 菜ai 提供的模型服务。
一、接入前准备（核心 3 要素）
在开始配置前，请先明确以下 3 个核心参数：
| 配置项 | 推荐填写内容 | 注意事项 |
|---|---|---|
| API Key | sk-xxxxxxxxxxxxxxxx | 请填写纯文本密钥，不要带 Bearer 前缀。 |
| Base URL | https://cloud.ai.liandxu.cn/v1 | 必须包含 /v1。 |
| 模型名称 | 例如 gpt-4o | 必须填写 菜ai 实际支持且你账号有权限调用的模型名。 |
二、安装 Cline 插件
- 打开 VS Code，点击左侧活动栏的 扩展 (Extensions) 图标（或按
Ctrl+Shift+X）。 - 在搜索框中输入
cline。 - 找到官方正版
Cline插件，点击 Install (安装)。
三、配置 菜ai API
安装完成后，VS Code 左侧导航栏会多出一个小机器人头像的图标。点击它，即可唤出 Cline 的配置与交互面板。
请在弹出的设置页面中，按以下标准严格填写：
- API Provider：点击下拉菜单，选择
OpenAI Compatible（极其重要，不要选其他官方专属选项）。 - Base URL：填入
https://cloud.ai.liandxu.cn/v1。 - API Key：粘贴你从 菜ai 控制台获取的
sk-...密钥。 - Model ID：手动输入你想使用的 菜ai 模型全称（例如
claude-sonnet-4-6）。 - 高级选项 (可选)：第一次配置时，建议不要随意修改 Temperature 等高级参数，保持默认即可。
填写完毕后，点击面板最下方的 Done 或直接开始对话，配置会自动保存。
四、测试是否配置成功
配置完成后，建议先进行一个无破坏性的“最小测试”，以验证接口是否打通。
在 Cline 底部的对话框中，发送以下指令：
请不要修改任何代码，只简单分析一下当前项目 src 目录下的文件结构。
- 🟢 成功标志：如果 Cline 能正常思考（输出 Thought 过程）并返回项目结构分析，说明接入完美成功！
- 🔴 失败标志：如果提示
API Error、Fetch Failed或一直转圈，请参考下方常见问题进行排查。
五、常见问题排查 (FAQ)
Q1：为什么提示认证失败 (Authentication Failed) 或 API Key 无效？
- 请检查填写的 API Key 是否包含多余的空格，或者误填了
Bearer前缀。这里只需要最原始的sk-...字符串。
Q2：为什么一直提示网络连接失败 (Fetch failed)？
- 最常见的错误：检查 Base URL 是否漏写了结尾的
/v1。必须是https://cloud.ai.liandxu.cn/v1。 - 检查 API Provider 是否确实选择了
OpenAI Compatible。如果选成了 Anthropic 或 OpenAI 官方，它会无视你的 Base URL，强行连接被墙的海外服务器。
Q3：为什么提示模型不存在 (Model not found)？
Model ID字段必须与 菜ai 平台上真实存在的模型名称一字不差。请勿凭直觉简写（例如把gpt-4o写成gpt4）。