知识库章节 ▾

导航

▸ 从这里开始 按角色

类别

工具 54
词汇表 12

工具

Roo Code + Gonka AI — VS Code 中的自主 AI 代理

重要提示:Roo Code 扩展已于 2026 年 5 月 15 日停止维护。 仓库已转入存档,后续不会再有任何更新。该项目的开发工作由 Zoo Code 继续进行,这是一个由 Roo Code 社区发起的项目分支:其提供程序的配置方式相同,迁移方法请参考迁移指南以及我们的 Zoo Code 指南。其他面向 VS Code 的开源智能体包括 Kilo Code 和 Cline(Roo Code 即衍生自 Cline)。已安装的扩展仍可继续运行,以下说明对其依然有效。

Roo Code 是一个面向 VS Code 的自主 AI 智能体:它能够读取和编辑文件、在终端执行命令、使用浏览器,并完成复杂的多步骤开发任务。它是 Cline 的分支并在此基础上进行了扩展:包括可自定义的工作模式(Architect、Code、Ask、Debug 及自定义模式)、项目级自定义指令以及灵活的模型配置面板。本质上,它就像是在编辑器中内置了一整支 AI 专家团队。

此类智能体的主要问题在于代币消耗。对于单项任务,Roo Code 需要处理文件上下文、命令输出、工具结果等——这涉及数千万个代币。按照 Anthropic 的价格(每百万代币 $3-15),单次完整会话可能花费 $30-1500。这对于日常工作来说是不切实际的。

JoinGonka Gateway 将成本降低了数千倍:同样的会话仅需 $0.01-1.00。网关转售来自 去中心化 Gonka 网络 的模型推理,并同时支持 OpenAI 格式(“OpenAI Compatible”提供程序)和 Anthropic 格式(端点 /v1/messages)——Roo Code 可通过其中任意一种方式连接。这使 Roo Code 从昂贵的演示工具变成了日常工作的得力助手。

第 1 步:安装 Roo Code 并获取密钥

Roo Code 安装:在 VS Code 中打开 Extensions (Ctrl/Cmd+Shift+X),搜索“Roo Code”并点击 Install。安装后,侧边栏会出现一个 Roo Code 的袋鼠图标。该插件仍在 Marketplace 中,但其 2026 年 5 月 15 日发布的 3.54.0 版本将是最后一个版本。

JoinGonka API 密钥:如果还没有密钥,请注册 gate.joingonka.ai/register,获取 3M 免费 token,并在 Dashboard 中创建一个以 jg- 为前缀的密钥。

第 2 步:配置 Roo Code (OpenAI Compatible)

最简单的方式是用一条命令的安装器完成配置。对于 CLI/文件类工具,它会自动写入 JoinGonka 提供商配置(baseUrl、模型);对于 UI 类工具,它会直接显示可复制粘贴的现成值:

npx @joingonka/setup --tool roo

该命令会先提醒你关闭 Roo Code,并告诉你该前往哪里(--tool zoo、--tool cline、--tool kilo),然后为仍安装有该扩展的用户打印出相应的值——包括真实的上下文窗口和模型响应上限。安装器会询问 jg-… 密钥,最后通过向 gateway 发送请求完成 live 检查。如果你更愿意自己配置,下面是手动方法。

手动配置(备选方案)

打开 Roo Code 面板,进入设置(齿轮图标)。在提供商部分设置:

  1. API Provider — 选择 OpenAI Compatible。
  2. Base URL — https://gate.joingonka.ai/v1
  3. API Key — jg-your-key
  4. Model(Model ID)— MiniMaxAI/MiniMax-M2.7

在下方 Model Configuration 区块中,你可以手动微调模型参数:

  • Context Window — 180000(180K tokens;DeepSeek V4 Flash 为 380000)。
  • Max Output Tokens — MiniMax M2.7 和 GLM-5.3 Flash 为 8192,DeepSeek V4 Flash 为 32768。
  • Input Price / Output Price — 可以填入真实费率(≈$0.0062 / 1M 输入,输出 ×3),这样 Roo Code 就能在界面中正确计算任务成本。

关于 tool calling 的重要说明:Roo Code 仅使用原生 tool calling——这里没有旧式智能体中的 XML 回退方案。因此模型必须支持 function calling。网络中的模型通过我们的 Gateway 均支持原生 tool calling——Roo Code 开箱即可使用。

验证:在 Roo Code 聊天中输入“创建一个 hello.py 文件,包含一个打印 Hello World 的函数”。智能体将提议创建该文件,并显示 diff 等待你批准。

代理会话成本比较

Roo Code 是一个 Agent 工具:它不仅仅通过单条消息回复,而是执行任务——它读取文件、编写代码、运行测试并修复 bug。每一个操作都是一次模型调用。让我们比较典型会话的成本:

任务Token 数Anthropic ClaudeOpenAI GPTJoinGonka Gonka
简单 bug 修复~5M$15 — $75$12 — $50$0.048
新功能 (2-3 个文件)~20M$60 — $300$50 — $200$0.19
模块重构~50M$150 — $750$125 — $500$0.48
完整开发会话 (4 小时)~100M$300 — $1,500$250 — $1,000$0.96

使用 JoinGonka Gateway,Roo Code 变成了日常工具——你可以为每个工单、每个 bug、每个功能运行它,无需担心账单。初始赠送的 3M 免费 Token 让你无需绑定信用卡即可尝试这套组合。

模型参数:MiniMax M2.7 — 180K 上下文窗口及最高 8192 个输出 Token,DeepSeek V4 Flash — 380K 及最高 32768,GLM-5.3 Flash — 390K 及最高 8192。如果非流式请求未指定 max_tokens,网关默认返回最多 1500 个 Token(GLM-5.3 Flash 为 3000)。Roo Code 会自动将长内容生成拆分为多个步骤。

Roo Code 与 Cline 的区别:模式和 Anthropic 格式

Roo Code 是 Cline 的 fork,但有一些显著差异会改变工作流:

  • Modes(模式):按任务切换 agent 角色——Architect 用于规划,Code 用于写代码,Ask 用于项目答疑,Debug 用于排查错误。你还可以创建自定义模式,并为每个模式配置单独的指令和允许使用的工具集。
  • 仅原生 tool calling:与采用文本/XML 解析的 agent 不同,Roo Code 通过原生 OpenAI tools schema 发送工具,并以独立事件的形式接收调用——延迟更低,结果更可靠。代价是:模型必须支持 function calling(网络中的模型通过我们的 Gateway 均支持)。
  • 自定义指令与配置档案:可按项目设置规则(例如通过仓库中的规则文件),并可保存多套提供商配置,方便随时切换。

通过 Anthropic 格式接入。如果你想用我们的 /v1/messages endpoint 代替 OpenAI 格式:在设置中选择 API Provider → Anthropic,勾选 "Use custom base URL" 并填入 https://gate.joingonka.ai,在 Anthropic API Key 字段粘贴同一个 jg-your-key 密钥,然后设置模型名称(例如 MiniMaxAI/MiniMax-M2.7)。密钥和余额在两种格式间通用,Anthropic 模式下的原生 tool_use 同样经过 Gateway。

Roo Code + Gonka = VS Code 中的自治 AI 代理,具有模式和原生 tool calling 功能,价格低廉。开发会话只需 $0.10,而 Anthropic 则需 $300-1,500,初始 token 让您无需信用卡即可尝试。原扩展程序于 2026 年 5 月 15 日停止维护:对于新安装,请使用 Zoo Code(社区分支)、Kilo Code 或 Cline。

想了解更多?

探索其他章节或立即开始赚取 GNK。

获取免费 token →