首页 / 指南 / Cline、Roo Code 和 Kilo Code 使用免费 API

Cline、Roo Code 和 Kilo Code 使用免费 API

Cline、Roo Code 和 Kilo Code 是适用于 VS Code 的编程智能体。它们每一个都可以使用兼容 OpenAI 的 API。本指南通过 FreeLLMAPI 将它们连接到免费模型。本指南还列出了哪些免费模型能够处理这些智能体发送的长篇、工具调用密集的提示词。

代码、模型名称和目录中的实时标签以英文显示。

开始之前

FreeLLMAPI 是一个在您计算机上运行的开源网关。它通过一个密钥汇集 45 个提供商的免费套餐。请通过 Docker 安装,然后在密钥页面至少添加两个免费提供商密钥。

在 macOS 或 Linux 上安装

curl -fsSL https://freellmapi.co/install.sh | bash

从密钥页面复制您的统一密钥。三个智能体都使用相同的值:

字段值
Base URLhttp://localhost:3001/v1
API 密钥<unified-key>
模型 IDauto,或来自 GET /v1/models 的目录 ID
Roo Code 状态:Roo Code 的 README 称,该扩展已于 2026 年 5 月 15 日关闭。该仓库已归档且为只读。以下步骤仍适用于现有安装,但新用户应选择 Cline 或 Kilo Code。

Cline

最快的方法是使用设置命令。它会读取您的实时目录,备份现有的 Cline 设置,并添加一个 OpenAI Compatible 提供商。

一条命令

npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key>

第一行显示差异,但不写入任何内容。第二行写入更改。如需手动设置 Cline,请执行以下步骤:

  1. 在 VS Code 中打开 Cline 面板。点击设置(齿轮)图标。
  2. 将 API Provider 设置为 OpenAI Compatible。
  3. 将 Base URL 设置为 http://localhost:3001/v1。
  4. 将 API Key 设置为您的统一密钥。
  5. 将 Model ID 设置为 auto,或设置为下表中的某个模型。
  6. 打开 Model Configuration。将 Context Window 设置为您所选模型的上下文长度。仅对视觉模型开启 Image Support。

对于 OpenAI Compatible 提供商,Cline 会显示以下提示:"Cline uses complex prompts, so behavior can vary across models."对于较小的模型,Cline 文档建议在 Cline Settings, Features 中开启 Use Compact Prompt。

Kilo Code

运行设置命令。它会写入一个全局 Kilo 配置,其中包含一个 openai-compatible 提供商,并将其设为默认模型。

一条命令

export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-kilo --url http://localhost:3001 --dry-run
npx freellmapi setup-kilo --url http://localhost:3001
kilo run "Say hello"

配置文件以 {env:FREELLMAPI_API_KEY} 引用密钥,因此请在启动 Kilo 之前导出该变量。Kilo 仅在受信任的配置中展开 {env:...},例如全局文件夹 ~/.config/kilo。在项目配置中,Kilo 会忽略它并记录一条警告。生成的配置结构如下:

Kilo 全局配置(结构)

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "openai-compatible/auto",
  "provider": {
    "openai-compatible": {
      "options": {
        "apiKey": "{env:FREELLMAPI_API_KEY}",
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "tool_call": true,
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

在 VS Code 扩展中,您也可以手动添加提供商。打开 Settings,然后打开 Providers 选项卡,点击 Custom provider。将 Provider API 设置为 OpenAI Compatible。输入 Base URL 和密钥,然后点击 Fetch models 读取模型列表。

Roo Code(现有安装)

设置命令会为 VS Code 扩展写入一个导入文件。它还会为 Roo CLI 写入一个配置文件。

一条命令

npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>

然后让 Roo Code 加载该导入文件。将此行添加到您的 VS Code settings.json 中,并重新加载窗口。freellmapi 配置文件将成为当前配置文件。

VS Code settings.json

"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"

如需手动设置,请打开 Roo Code 设置,并将 API Provider 设置为 OpenAI Compatible。输入 Base URL、密钥和模型。Roo Code 仅使用原生工具调用。其文档称,不支持原生工具调用的模型无法用于 Roo Code。

为智能体工作选择模型

这些智能体在每个请求中都会发送大型系统提示词、工具定义和文件内容。请使用支持工具调用且上下文窗口较大的模型。下表按智能能力列出了目前支持工具调用且上下文至少为 128K 的免费模型。

适用于 Cline、Roo Code 和 Kilo Code 的免费模型:工具调用与 128K 以上上下文
模型免费提供方上下文免费额度(最优惠)工具视觉
GLM 5.3UnoRouter1M1 请求/分钟
1 req/min per model
是否
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 请求/分钟
40 RPM
是是
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quota是是
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowance是否
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit是是
Gemini 3.7 FlashGoogle AI Studio1M10 请求/分钟
20 请求/天
250,000 令牌/分钟
~3M
是是
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit是是
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 请求/分钟
50 请求/天
50 req/day account-wide (1,000 after a $10 purchase)
是是
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 请求/分钟
50 请求/天
Shared rate limit
是否
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 请求/分钟
250 请求/天
70,000 令牌/分钟
~6M
是是
Gemini 3.6 FlashGoogle AI Studio1M10 请求/分钟
20 请求/天
250,000 令牌/分钟
~3M
是是
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/day是是

显示 12 个(共 109 个匹配的免费模型)。 查看所有模型.

数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。

  • 使用 auto,让路由器为每个请求选择模型。当某个提供商返回 429 错误时,路由器会尝试下一个模型。
  • 规划和复杂的错误修复请使用 auto:smart。
  • 将智能体中的上下文窗口设置为模型的实际上下文长度。如果该值过高,智能体发送的提示词会被模型拒绝。
  • 当上下文变大时,请开始新任务。较小的上下文每个请求使用的 token 更少。

故障排除

问题原因解决方法
"Invalid API Key"密钥不是您的 FreeLLMAPI 统一密钥从密钥页面重新复制统一密钥
"Model Not Found"模型 ID 不在您的目录中使用 auto,或使用来自 GET /v1/models 的 ID
智能体在一步后停止,或工具调用失败模型的工具调用能力较弱或不支持从上表中选择模型
长任务出现上下文窗口错误上下文设置大于模型的实际上下文设置正确的上下文窗口,或开始新任务
错误信息:所有模型在 N 次尝试后均已限流链中的每个密钥都已达到限制添加更多提供商的密钥,或等待冷却时间结束
Kilo:Model not found: openai-compatible/auto默认模型不在提供商的模型映射中再次运行 setup-kilo,它会将默认模型排在首位
通过一个密钥使用以上每一个模型。 FreeLLMAPI 是一个开源的自托管路由器。它将所有这些免费套餐放在一个兼容 OpenAI 的端点之后,并在某个套餐被限速时自动切换。 浏览目录 或 立即开始.

常见问题

我可以免费使用 Cline 吗?

可以。Cline 是免费的开源软件。将其 API 提供商设置为 OpenAI Compatible,并指向 FreeLLMAPI。网关会将每个请求发送到免费的提供商套餐,因此推理费用为 $0。

哪个免费模型最适合 Cline?

请使用支持工具调用且上下文至少为 128K 的模型。Cline 会发送带有工具定义的复杂提示词。本页的表格列出了目前同时满足这两项条件的最强免费模型。

Roo Code 仍在维护吗?

不再维护。Roo Code 的 README 称,该扩展已于 2026 年 5 月 15 日关闭,该仓库已归档。现有安装仍可通过 OpenAI Compatible 提供商使用。

如何将 Kilo Code 与自定义的兼容 OpenAI 的 API 配合使用?

在全局 Kilo 配置中添加一个带有 baseURL 和 apiKey 的 openai-compatible 提供商,或运行 npx freellmapi setup-kilo。在 VS Code 扩展中,使用 Settings、Providers、Custom provider。

为什么 Cline 在使用免费模型时会失败?

大多数失败源于工具调用能力较弱或上下文窗口较小的模型。请选择支持工具调用且上下文为 128K 的模型,对于较小的模型,请开启 Use Compact Prompt。

相关指南

来源

全部指南 · 浏览所有免费模型