Cline 配置
Cline 是一款运行在 VS Code 中的 AI 编码 Agent，可以读取项目、修改文件和执行命令。通过 OpenAI Compatible Provider，即可使用 LAYSO AI 模型。
一个 Key，访问全平台模型
同一个 LAYSO AI API Key 可以访问平台内的模型。成功请求会按所选模型的当前价格产生逐笔扣费明细；失败任务不会产生扣费。
前提条件
- 已安装最新版 Visual Studio Code ↗。
- 已在 LAYSO AI API Key 页面 ↗ 创建 API Key。
- 已从 LAYSO AI 模型与价格页面 ↗ 复制需要使用的完整模型 ID。
- 建议选择支持工具调用的模型，以便 Cline 正常读取文件和执行操作。
配置步骤
第 1 步：安装 Cline
打开 VS Code 扩展市场，搜索 Cline，确认扩展名称为 Cline、发布者为 Cline，然后点击 Install。
第 2 步：打开 Cline 设置
安装完成后打开 Cline 面板，点击右上角的齿轮图标进入 Settings。
第 3 步：配置 LAYSO AI
在左侧选择 API Configuration，然后填写：
| 配置项 | 填写内容 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.layso.ai/v1 |
| OpenAI Compatible API Key | 从 LAYSO AI API Key 页面复制的完整密钥 |
| Model ID | 从模型与价格页面复制的完整模型 ID |
Base URL 只填写到 /v1，不要追加 /chat/completions、/responses 或模型名称。截图中的模型仅为示例，请以模型与价格页面的当前信息为准。
如需调整 Reasoning Effort、上下文长度或其他模型参数，也应按照目标模型的实际能力设置。配置完成后点击右上角 Done。
第 4 步：发送消息验证
返回 Cline 对话界面，确认输入框下方显示的是刚刚配置的模型，然后发送一个简短的只读任务，例如：
text
请介绍一下自己，不要修改任何文件。出现 COMPLETED 并收到正常回复，说明连接成功。随后可在 LAYSO AI 用户端核对请求使用的模型、Token 和扣费明细。
使用建议
- 首次连接先执行只读任务，确认 Provider、模型和工作区均正确。
- Cline 执行写文件或终端命令前，应仔细检查将要进行的操作。
- 不确定时不要开启宽泛的 Auto Approve 权限。
- 大范围修改前使用版本控制创建可恢复的提交或检查点。
- 不要在项目文件、截图、日志或 Git 仓库中暴露完整 API Key。
常见问题
| 现象 | 排查方法 |
|---|---|
| 找不到 Cline 图标 | 运行 Cline: Open In New Tab，或重载 VS Code 窗口 |
| Invalid API Key、401 / 403 | 重新复制 API Key，确认没有空格、换行或缺失字符 |
| 404 | Base URL 必须为 https://api.layso.ai/v1，不要重复添加 /v1 或完整请求路径 |
| Model Not Found | 从模型与价格页面复制完整模型 ID，并确认 Provider 仍为 OpenAI Compatible |
| 无法使用工具 | 确认所选模型支持工具调用，并检查 Cline 的模型配置 |
| Cline 显示的费用不同 | Cline 中的费用仅为本地估算，实际扣费以 LAYSO AI 的逐笔明细为准 |