Skip to content

使用 Cline 和 Roo Code 集成 GenStudio API

ClineRoo Code 都是 VS Code 中优秀的开源 AI 编程助手扩展。两者均支持 OpenAI 兼容协议,可完美接入GenStudio 提供的高性能模型。

本文将首先介绍如何快速配置这两款工具,随后深入对比两者的差异,帮助您根据开发习惯做出选择。

获取 API 接入信息

在配置之前,您需要先获取对应的 API Key

Infini 编码套餐 (Coding Plan)

适用于订阅了预付费编程套餐的开发者,提供专享配额与预算控制。Coding Plan 使用专用的 Base URLEndpoints,请根据您的客户端工具支持的协议(OpenAI 兼容或 Anthropic)来配置。详见 Infini 编码套餐

  • API Key:前往编码套餐页面创建 API 密钥。Infini 编码套餐专用 API 密钥均带有 sk-cp- 前缀。

  • OpenAI (OpenAI Compatible)

    • Base URL: https://cloud.infini-ai.com/maas/coding/v1
    • Endpoints
      • Create Chat Completion: /chat/completions
      • List Models: /models
  • Anthropic (Anthropic Messages)

    • Base URL: https://cloud.infini-ai.com/maas/coding
    • Endpoints
      • Create a Message: /v1/messages
      • List Models: /v1/models

通过 API 获取最新可用模型列表

若需获取当前接入方式下最新可用的模型 ID,建议通过 Agent 或手动调用模型列表接口。

该接口仅返回当前可用的模型列表,不返回上下文长度、最大输出长度等模型元数据。请使用编码套餐专属 API Key(sk-cp- 前缀)查询。

language-shell
curl --request GET \
  --url 'https://cloud.infini-ai.com/maas/coding/v1/models' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer sk-cp-xxxxxxxxxx'

在控制台查看上下文长度和最大输出长度

如需查看模型的上下文长度和最大输出长度,请前往模型广场查看对应模型卡片。模型卡片会展示每个模型的上下文长度、最大输出长度等信息。

快速集成指南

要在 VS Code 中使用 GenStudio 的模型服务,您需要在扩展设置中配置 API 提供商为 OpenAI Compatible,并填入相应的 Base URL 和 API Key。以下是针对两款工具的具体配置步骤。

信息

Cline 和 Roo Code 的 Anthropic API 提供商不支持自定义模型 ID,仅限使用 Anthropic 官方模型。而 GenStudio 并未托管 Anthropic 官方模型,因此无法通过 Anthropic 提供商接入 GenStudio 服务。请使用 OpenAI Compatible 提供商进行配置。

Cline 配置

Cline 是一个强调安全、清晰和人在环路(Human-in-the-loop)控制的 AI 助手。

  1. 在 VS Code 中安装 Cline 扩展

  2. 打开 Cline 设置面板。

    信息

    Cline 的 Task 聊天框中 PlanAct 两种功能的 API 配置是不互通的,需分别配置。建议均配置为 GenStudio API。

  3. 配置 OpenAI Compatible 选项:

    • API Provider: 选择 OpenAI Compatible
    • Base URL: 填写 https://cloud.infini-ai.com/maas/coding/v1
    • API Key: 填写在 GenStudio 获取的 API Key 密钥
    • Model ID: 填写模型名称

    alt text

  4. 点击 Done 保存。

Roo Code 配置

Roo Code(原 Roo Cline)构建在 Cline 的基础之上,提供了基于角色的自主性(Modes)和多 Agent 协作能力。

  1. 在 VS Code 中安装 Roo Code 扩展

  2. 打开 Roo Code 设置面板。

  3. 配置 OpenAI Compatible 选项(与 Cline 类似):

    • API Provider: 选择 OpenAI Compatible
    • Base URL: 填写 https://cloud.infini-ai.com/maas/coding/v1
    • API Key: 填写在 GenStudio 获取的 API Key 密钥
    • Model ID: 填写模型名称
    • Custom Model Info (可选): 某些情况下可能需要配置上下文窗口大小等参数。

    alt text

  4. 点击 Done 保存。

选择 Cline 还是 Roo Code?

Cline 和 Roo Code 虽然同源,但在设计哲学和工作流上存在显著差异。Cline 侧重于逐步确认与安全控制,而 Roo Code 侧重于角色化分工与任务编排

核心特性与工作流对比

Cline 和 Roo Code 虽然同源,但在设计哲学和工作流上存在显著差异。

  • Cline精准控制的人在环路助手

    • 核心理念:强调安全与控制 (Human-in-the-loop)。采用 Plan → Act 模式,规划与执行分离。
    • 信任机制按需授权。除非开启自动批准,否则代码修改、命令执行等每一步操作默认均需用户审核确认,适合低容错场景。
    • Agent 设计:单一通用 Agent,主要通过 MCP (Model Context Protocol) 协议扩展能力。
    • 工作流特点:在使用工具后会自动创建工具级检查点。流程通常为:提出计划 -> 用户确认 -> 执行单步 -> 用户审查 -> 提交
    • 适用场景:核心算法开发、安全敏感代码修改、学习新代码库。
  • Roo Code:角色化协作的半自主助手

    • 核心理念:强调分工与半自主执行 (Role-based)。采用 Role-driven 模式,引入了预设角色(Modes)。
    • 信任机制围栏内授权。角色在特定权限范围内运行,自主性更高,支持任务编排。
    • Agent 设计:多角色(Modes)设计,如架构师、QA、代码专家。除了支持 MCP,还增加了自定义模式 (Custom Modes) 功能。
    • 工作流特点:在任务开始及文件修改前自动创建任务级检查点。流程通常为:选择模式 -> 模式在权限内执行 -> 拆解子任务
    • 适用场景:复杂功能开发、多步骤任务流、需要特定角色(测试、文档)介入的场景。

决策参考

需求维度选择 Cline选择 Roo Code
控制粒度需要完全掌控每一步操作接受在一定监督下的半自主执行
任务类型线性、明确的单点任务复杂、多步骤的复合型任务
配置复杂度低,开箱即用中,需理解模式配置与任务编排
定制需求仅需通用编码辅助需要定制特定工作流(如专门的文档编写模式)

总结

  • Cline 适合追求极致控制与安全性的开发者,操作透明度高。
  • Roo Code 适合需要处理复杂任务与角色分工的场景,自动化程度更高。

无论选择哪款工具,搭配 GenStudio 提供的高性能模型,都能为您带来高效的 AI 编程体验。

相关文档