Início / Guias / Cline, Roo Code e Kilo Code com uma API gratuita

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 | bash

Copie sua chave unificada da página Keys. Os três agentes usam os mesmos valores:

CampoValor
Base URLhttp://localhost:3001/v1
API key<unified-key>
Model IDauto, ou um ID do catálogo de GET /v1/models
Status do Roo Code: o README do Roo Code diz que a extensão foi desativada em 15 de maio de 2026. O repositório está arquivado e somente leitura. As etapas abaixo ainda valem para uma instalação existente, mas novos usuários devem escolher Cline ou Kilo Code.

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:

  1. Abra o painel do Cline no VS Code. Clique no ícone de configurações (engrenagem).
  2. Defina API Provider como OpenAI Compatible.
  3. Defina Base URL como http://localhost:3001/v1.
  4. Defina API Key como a sua chave unificada.
  5. Defina Model ID como auto ou como um modelo da tabela abaixo.
  6. 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.

Modelos gratuitos para Cline, Roo Code e Kilo Code: chamada de ferramentas e contexto de 128K ou mais
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
SimNão
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
SimSim
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSimSim
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSimNão
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSimSim
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSimSim
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimSim
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/dia
Shared rate limit
SimNão
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/dia
70,000 tokens/min
~6M
SimSim
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySimSim

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 auto para 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:smart para 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

ProblemaCausaSolução
"Invalid API Key"A chave não é a sua chave unificada do FreeLLMAPICopie a chave unificada novamente da página Keys
"Model Not Found"O ID do modelo não está no seu catálogoUse auto ou um ID de GET /v1/models
O agente para depois de uma etapa, ou as chamadas de ferramenta falhamO modelo tem chamada de ferramentas fraca ou não temSelecione um modelo da tabela acima
Erros de janela de contexto em tarefas longasA configuração de contexto é maior que o contexto real do modeloDefina 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 limiteAdicione chaves de mais provedores ou aguarde os períodos de espera
Kilo: Model not found: openai-compatible/autoO modelo padrão não está no mapa de modelos do provedorExecute setup-kilo novamente, que coloca o modelo padrão em primeiro
Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produção.

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

Fontes

Todos os guias · Ver todos os modelos gratuitos