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 URL | http://localhost:3001/v1 |
| API 密钥 | <unified-key> |
| 模型 ID | auto,或来自 GET /v1/models 的目录 ID |
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,请执行以下步骤:
- 在 VS Code 中打开 Cline 面板。点击设置(齿轮)图标。
- 将 API Provider 设置为 OpenAI Compatible。
- 将 Base URL 设置为
http://localhost:3001/v1。 - 将 API Key 设置为您的统一密钥。
- 将 Model ID 设置为
auto,或设置为下表中的某个模型。 - 打开 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 的免费模型。
| 模型 | 免费提供方 | 上下文 | 免费额度(最优惠) | 工具 | 视觉 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 请求/分钟 1 req/min per model | 是 | 否 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 请求/分钟 40 RPM | 是 | 是 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 是 | 是 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 是 | 否 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 请求/分钟 20 请求/天 250,000 令牌/分钟 ~3M | 是 | 是 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 请求/分钟 50 请求/天 50 req/day account-wide (1,000 after a $10 purchase) | 是 | 是 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 请求/分钟 50 请求/天 Shared rate limit | 是 | 否 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 请求/分钟 250 请求/天 70,000 令牌/分钟 ~6M | 是 | 是 |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 请求/分钟 20 请求/天 250,000 令牌/分钟 ~3M | 是 | 是 |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 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,它会将默认模型排在首位 |
常见问题
我可以免费使用 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。
相关指南
来源
- Cline docs: OpenAI Compatible provider (检查于 20 November 2026)
- Cline docs: running models locally (检查于 20 November 2026)
- Kilo docs: custom models (检查于 20 November 2026)
- Kilo docs: OpenAI Compatible provider (检查于 20 November 2026)
- Roo Code repository (archived) (检查于 20 November 2026)
- Roo Code docs: settings management (检查于 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (检查于 20 November 2026)