Cline / Roo Code 配置教程

开源AI编程助手接入腾讯云Token Plan,打造专属编程AI

使用教程 / AI工具配置 / Cline/Roo Code教程

Cline / Roo Code 从入门到精通

📅 2026年5月18日 ⏱️ 阅读时间:约12分钟 🏷️ Cline、Roo Code、开源AI编程
💡 什么是 Cline / Roo Code?

Cline 和 Roo Code 是两款基于 VS Code 的开源 AI 编程插件。它们通过 LLM 驱动,不仅能帮你写代码,还能自主规划、执行命令、读写文件——像一个真正的 AI 编程助手。Roo Code 是 Cline 的增强分支,增加了更多实用功能。

1

为什么选择 Cline/Roo Code?

相比 Cursor 等闭源编辑器,Cline 和 Roo Code 有以下独特优势:

  • 完全开源免费:插件本身不收费,只需支付模型调用费用
  • 自主执行能力:能自动读写文件、运行命令、管理项目
  • MCP 工具链:通过 MCP(Model Context Protocol) 连接外部工具和服务
  • 多模型支持:原生支持 OpenAI 协议,轻松接入腾讯云Token Plan
  • 自主模式:给出任务描述,AI 自动规划和执行

搭载腾讯云 Token Plan 后,Cline/Roo Code 使用国产大模型的速度和性价比远超海外方案。查看我们的 Token Plan 价格对比 选择最适合你的套餐。

2

安装 Cline / Roo Code

安装 Cline

  1. 打开 VS Code,点击左侧扩展图标(或按 Ctrl + Shift + X
  2. 搜索 Cline(作者:saoudrizwan.cline)
  3. 点击安装,安装完成后 VS Code 右侧会出现 Cline 图标

安装 Roo Code

  1. 在 VS Code 扩展商店搜索 Roo Code
  2. 选择安装(作者:rooveterinaryinc.roo-cline)
  3. 安装完成后界面会出现 Roo Code 对话面板

💡 Cline 和 Roo Code 可以同时安装,互不冲突。两者的配置方式几乎完全相同,本教程以 Cline 为例,Roo Code 用户只需将设置中的 "cline" 替换为 "roo" 即可。

3

配置腾讯云 Token Plan

3.1 获取 API 密钥

参照 Token Plan入门指南 开通套餐并获取 API Key。

3.2 在 Cline 中配置 API Provider

安装完成后,点击 VS Code 右侧的 Cline 图标打开设置:

  1. 点击 Cline 面板顶部的 API Provider 下拉菜单
  2. 选择 OpenAI compatible
  3. 填写以下配置:
API Provider: OpenAI Compatible
Base URL: https://api.tp.tencent.com/v1
API Key: 你的腾讯云API密钥
Model: tencent-hy-2.0  (或其他模型名)

自定义模型列表(可选添加):
  - tencent-hy-2.0     → 腾讯混元 2.0
  - deepseek-v4        → DeepSeek V4
  - glm-5              → 智谱 GLM-5
  - kimi-k2.6          → 月之暗面 Kimi K2.6

3.3 验证配置

Cline 面板中输入任意问题测试连接。如果返回正��回答,说明配置成功。

⚠️ 常见配置错误

如果遇到「Connection failed」或「401 Unauthorized」,请确认 API Key 没有多余空格,Base URL 末尾没有多余斜杠。如果模型不可用,请确认 Token Plan 套餐包含该模型。

4

核心功能使用指南

🛠️ 基本操作

  • 对话模式:直接在 Cline 面板输入需求,AI 会回复并执行任务
  • 选中代码提问:在编辑器中选中代码后 Ctrl + Shift + P → 「Cline: 解释选中代码」
  • 文件操作:Cline 可直接创建、编辑、删除项目文件
  • 终端命令:Cline 可以自动在你的终端中运行命令

🚀 高级玩法:自主模式

Cline 的最大亮点是自主模式。你可以直接说:

"""
帮我创建一个 React + Vite 项目:
1. 初始化项目目录
2. 安装所有依赖
3. 创建 src/App.tsx 基础组件
4. 添加一个简单的计数器功能
5. 启动开发服务器验证
"""

Cline 会自动规划步骤、创建文件、运行命令,全程无需你手动操作。

🔗 配置 MCP 工具

MCP (Model Context Protocol) 让 Cline 能够连接外部服务:

// cline_mcp_settings.json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "你的GitHub Token"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

配置后,Cline 可以直接操作 GitHub 仓库、查询文档、管理文件等。

5

模型选择与成本优化

Cline 的每次任务会消耗多个 LLM 调用。选择正确的模型可以大幅降低成本:

任务类型 推荐模型 成本
快速问答/小型修改 DeepSeek V4 ★ 低
代码生成/模块开发 GLM-5 ★★ 中
自主模式/多文件修改 Hunyuan 2.0 ★★ 中
代码审查/重构 Kimi K2.6 ★★★ 较高

💰 省钱技巧

  • 日常开发用 DeepSeek:对于常规编码任务,DeepSeek V4 的性价比最高
  • 限制 Cline 的自动执行范围:在设置中限制 Cline 只能操作当前工作区
  • 使用 Lite 套餐:如果每天使用量不大,¥40/月的 Lite 套餐足够
🎁
首月特惠
腾讯云 Token Plan 首月仅 ¥7.9,支持6+模型自由切换,Cline/Roo Code 完美兼容!
🔥 立即抢购
6

常见问题与排错

Cline 和 Roo Code 有什么区别?

Roo Code 是 Cline 的分支增强版,额外支持:角色自定义提示词、更精细的自执行控制、API 用量统计等功能。两者可以互换使用,配置方式完全一致。

Cline 会不会把我的代码上传到服务器?

Cline 只会将你选择的文件或当前编辑器的上下文发送到配置的 API 端点(即腾讯云 Token Plan 服务器)。它不会上传无关文件。你可以在设置中手动控制哪些文件被包含。

Token Plan 在 Cline 上消耗快吗?

取决于任务复杂度。简单的代码补全每次消耗约 200-500 Tokens,复杂的自主任务(多文件操作)可能消耗 5000+ Tokens。Lite 套餐约1200次/5小时,Pro 套餐约6000次/5小时。查看 Token Plan 详细价格

Cline 提示「Model not found」怎么办?

确��自定义模型名称与 Token Plan 支持的模型名称完全一致。不同平台的模型命名可能不同,建议先在官方文档中确认支持的模型列表。

🔥 限时优惠 · CodeBuddy 首月仅¥7.9
🔥 立即抢购
🎯 限时特惠 · 仅限本站访客

⏳ 别急着走!
首月特惠马上结束

已有 3,850+ 开发者通过本站购买

12 小时
00 分钟
00
¥40 ¥7.9 /首月
💰 省 ¥32.1 · 优惠仅限本站专属链接
🤖 全功能 Coding Plan 🔄 无限Token调用 📱 多工具支持 💬 中文优化
🔥 立即抢购 · 首月仅 ¥7.9
🔒 安全支付 ⭐ 开发者推荐 🛡️ 官方授权