Cline, Roo Code e Kilo Code com uma API gratuita
Cline, Roo Code e Kilo Code são agentes de programação para o VS Code. Cada um pode usar uma API compatível com OpenAI. Este guia os conecta a modelos gratuitos por meio do FreeLLMAPI. Também mostra quais modelos gratuitos lidam com os prompts longos e cheios de ferramentas que esses agentes enviam.
O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.
Antes de começar
O FreeLLMAPI é um gateway de código aberto que roda no seu computador. Ele reúne os planos gratuitos de 45 provedores atrás de uma única chave. Instale-o com Docker e depois adicione pelo menos duas chaves de provedores gratuitos na página Keys.
Instale no macOS ou no Linux
curl -fsSL https://freellmapi.co/install.sh | bashCopie sua chave unificada da página Keys. Os três agentes usam os mesmos valores:
| Campo | Valor |
|---|---|
| Base URL | http://localhost:3001/v1 |
| API key | <unified-key> |
| Model ID | auto, ou um ID do catálogo de GET /v1/models |
Cline
O método mais rápido é o comando de configuração. Ele lê o seu catálogo atual, faz uma cópia de segurança das configurações existentes do Cline e adiciona um provedor OpenAI Compatible.
Um comando
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>A primeira linha mostra as diferenças e não grava nada. A segunda linha grava a alteração. Para configurar o Cline manualmente, siga estas etapas:
- Abra o painel do Cline no VS Code. Clique no ícone de configurações (engrenagem).
- Defina API Provider como OpenAI Compatible.
- Defina Base URL como
http://localhost:3001/v1. - Defina API Key como a sua chave unificada.
- Defina Model ID como
autoou como um modelo da tabela abaixo. - Abra Model Configuration. Defina Context Window com o contexto do seu modelo. Ative Image Support somente para um modelo de visão.
O Cline mostra esta nota para provedores OpenAI Compatible: "Cline uses complex prompts, so behavior can vary across models." Para modelos menores, a documentação do Cline recomenda Use Compact Prompt em Cline Settings, Features.
Kilo Code
Execute o comando de configuração. Ele grava uma configuração global do Kilo com um provedor openai-compatible e o define como modelo padrão.
Um comando
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"A configuração se refere à chave como {env:FREELLMAPI_API_KEY}, então exporte a variável antes de iniciar o Kilo. O Kilo expande {env:...} somente em configurações confiáveis, por exemplo na pasta global ~/.config/kilo. Em uma configuração de projeto, o Kilo ignora essa expansão e registra um aviso. A configuração gerada tem esta forma:
Configuração global do Kilo (formato)
{
"$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 }
}
}
}
}
}Na extensão para VS Code, você também pode adicionar o provedor manualmente. Abra Settings, depois a aba Providers e clique em Custom provider. Defina Provider API como OpenAI Compatible. Informe a URL base e a chave e clique em Fetch models para ler a lista de modelos.
Roo Code (instalações existentes)
O comando de configuração grava um arquivo de importação para a extensão do VS Code. Ele também grava um perfil para a CLI do Roo.
Um comando
npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>Depois, diga ao Roo Code para carregar o arquivo de importação. Adicione esta linha ao seu settings.json do VS Code e recarregue a janela. O perfil freellmapi passa a ser o perfil atual.
settings.json do VS Code
"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"Para configurar manualmente, abra as configurações do Roo Code e defina API Provider como OpenAI Compatible. Informe a URL base, a chave e o modelo. O Roo Code usa somente chamada de ferramentas nativa. A documentação diz que um modelo sem chamada de ferramentas nativa não pode ser usado com o Roo Code.
Escolha modelos para trabalho com agentes
Estes agentes enviam em cada requisição um prompt de sistema grande, definições de ferramentas e conteúdo de arquivos. Use modelos com chamada de ferramentas e uma janela de contexto grande. A tabela mostra os modelos gratuitos com chamada de ferramentas e pelo menos 128K de contexto hoje, por nível de inteligência.
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Sim | Não |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Sim | Sim |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sim | Sim |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sim | Não |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/dia 50 req/day account-wide (1,000 after a $10 purchase) | Sim | Sim |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/dia Shared rate limit | Sim | Não |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/dia 70,000 tokens/min ~6M | Sim | Sim |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Sim | Sim |
Mostrando 12 de 109 modelos gratuitos correspondentes. Ver todos os modelos.
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
- Use
autopara deixar o roteador escolher um modelo para cada requisição. Quando um provedor envia um erro 429, o roteador tenta o próximo modelo. - Use
auto:smartpara planejamento e bugs difíceis. - Defina a janela de contexto no agente com o contexto real do modelo. Se o valor for alto demais, o agente envia prompts que o modelo recusa.
- Inicie uma nova tarefa quando o contexto ficar grande. Um contexto menor usa menos tokens por requisição.
Solução de problemas
| Problema | Causa | Solução |
|---|---|---|
| "Invalid API Key" | A chave não é a sua chave unificada do FreeLLMAPI | Copie a chave unificada novamente da página Keys |
| "Model Not Found" | O ID do modelo não está no seu catálogo | Use auto ou um ID de GET /v1/models |
| O agente para depois de uma etapa, ou as chamadas de ferramenta falham | O modelo tem chamada de ferramentas fraca ou não tem | Selecione um modelo da tabela acima |
| Erros de janela de contexto em tarefas longas | A configuração de contexto é maior que o contexto real do modelo | Defina a janela de contexto correta ou inicie uma nova tarefa |
| "Todos os modelos atingiram o limite de taxa após N tentativas" | Todas as chaves da cadeia atingiram o limite | Adicione chaves de mais provedores ou aguarde os períodos de espera |
Kilo: Model not found: openai-compatible/auto | O modelo padrão não está no mapa de modelos do provedor | Execute setup-kilo novamente, que coloca o modelo padrão em primeiro |
Perguntas frequentes
Posso usar o Cline de graça?
Sim. O Cline é gratuito e de código aberto. Defina o provedor de API como OpenAI Compatible e aponte para o FreeLLMAPI. O gateway envia cada requisição para os planos gratuitos dos provedores, então a inferência custa US$ 0.
Qual modelo gratuito é o melhor para o Cline?
Use um modelo com chamada de ferramentas e pelo menos 128K de contexto. O Cline envia prompts complexos com definições de ferramentas. A tabela desta página mostra os modelos gratuitos mais fortes que atendem às duas regras hoje.
O Roo Code ainda é mantido?
Não. O README do Roo Code diz que a extensão foi desativada em 15 de maio de 2026, e o repositório está arquivado. As instalações existentes ainda funcionam com um provedor OpenAI Compatible.
Como usar o Kilo Code com uma API própria compatível com OpenAI?
Adicione um provedor openai-compatible com um baseURL e um apiKey na configuração global do Kilo, ou execute npx freellmapi setup-kilo. Na extensão para VS Code, use Settings, Providers, Custom provider.
Por que o Cline falha com modelos gratuitos?
A maioria das falhas vem de modelos com chamada de ferramentas fraca ou com uma janela de contexto pequena. Selecione um modelo com chamada de ferramentas e 128K de contexto, e ative Use Compact Prompt para modelos menores.
Guias relacionados
- Modelos de IA gratuitos no VS Code
- Continue com uma API gratuita de LLM
- Melhores APIs gratuitas de modelos para código
- API LLM gratuita com function calling
- Como usar o Claude Code gratuitamente
Fontes
- Cline docs: OpenAI Compatible provider (verificado em 20 November 2026)
- Cline docs: running models locally (verificado em 20 November 2026)
- Kilo docs: custom models (verificado em 20 November 2026)
- Kilo docs: OpenAI Compatible provider (verificado em 20 November 2026)
- Roo Code repository (archived) (verificado em 20 November 2026)
- Roo Code docs: settings management (verificado em 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (verificado em 20 November 2026)