Cline 接入指南
适用角色：开发者 更新日期：2026-07-15
Cline 是一款开源的 AI 编程助手，以 VS Code 插件形式运行。它支持文件编辑、终端命令执行、浏览器操作等 Agent 能力，并且可以灵活配置第三方 OpenAI 兼容端点。
前提条件
- 已安装 VS Code
- 已在 VS Code 扩展商店安装 Cline 插件
- 已在平台控制台创建 API Key
- 已确认 Base URL
配置步骤
第一步：打开 Cline 设置面板
在 VS Code 左侧活动栏中点击 Cline 图标，打开 Cline 侧边面板。点击面板顶部的齿轮图标进入 Provider 设置。
第二步：选择 OpenAI Compatible 供应商
在 Provider 设置面板中，将 API Provider 下拉选择为 OpenAI Compatible。
第三步：填写连接信息
| 字段 | 填什么 | 示例 |
|---|---|---|
| Base URL | 平台的 API 地址 | YOUR_API_BASE_URL/v1 |
| API Key | 平台的 API Key | sk-xxxxxxxx |
| Model ID | 要使用的模型名称 | claude-sonnet-4-6 |
第四步：配置模型参数
选择 OpenAI Compatible 后，Cline 无法自动检测模型的能力参数，会使用保守的默认值。建议手动配置以下参数以获得最佳体验：
| 参数 | 建议值 | 说明 |
|---|---|---|
| Context Window | 根据模型实际值设置（如 Claude Sonnet 填 200000） | 模型的最大输入 Token 数 |
| Max Output Tokens | 根据模型实际值设置（如 16384） | 单次回复最大 Token 数 |
| Supports Images | 按模型能力开启 | 是否支持图片输入 |
| Supports Computer Use | 建议开启 | 开启后 Cline 才能执行文件编辑、终端命令等 Agent 操作；关闭则只有对话功能 |
Supports Computer Use 这个选项容易被忽略。如果不开启，Cline 会把模型当作纯聊天模型，文件编辑、终端命令等 Agent 功能会静默失效。
第五步：测试对话
配置完成后，在 Cline 面板中发送一条测试消息（如"你好，请介绍一下自己"），确认能正常收到回复。
关于 Function Calling 支持
Cline 的 Agent 功能（文件编辑、终端执行、浏览器操作）依赖 OpenAI 的 Function Calling（Tool Use）协议。你的 API 端点必须支持 tools 参数，否则 Agent 功能无法正常工作。
平台的 OpenAI 兼容端点支持 Function Calling，Cline 的 Agent 功能可以正常使用。
Roo Code（Cline 分支）
Roo Code 是 Cline 的一个社区分支，配置方式完全相同。如果你使用的是 Roo Code 插件，按照上述步骤操作即可。
Roo Code 同样支持 OpenAI Compatible 供应商选项，配置字段和 Cline 一致。
常见问题
Q：配置后 Cline 能对话但不能编辑文件怎么办？ A：检查是否开启了 Supports Computer Use 选项。这个选项控制 Cline 是否以 Agent 模式运行。关闭时 Cline 只做对话，不会尝试文件操作。
Q：提示"context window exceeded"怎么办？ A：手动设置 Context Window 参数为模型的实际值。Cline 对 OpenAI Compatible 供应商使用保守的默认上下文窗口，可能远小于模型实际支持的大小。
Q：Base URL 要不要带 /v1？
A：要带。Cline 会在 Base URL 基础上拼接 /chat/completions，所以 Base URL 应为 YOUR_API_BASE_URL/v1。
Q：能在 Cline 中切换不同模型吗？ A：能。在 Provider 设置中修改 Model ID 字段即可切换。也可以在 Cline 面板顶部的模型选择器中切换（如果配置了多个模型）。
Q：Cline 和 Roo Code 有什么区别？ A：Roo Code 是 Cline 的社区分支，功能和配置方式基本相同。选择任一使用即可，接入平台 API 的方式没有区别。