Kilo Code com UberLLM: adicione um provedor personalizado em 1 minuto

A versão atual do Kilo Code (7.x) compartilha um arquivo de configurações entre o VS Code, JetBrains e a CLI kilo, assim você configura o UberLLM apenas uma vez. Guias mais antigos que mostram um menu suspenso de provedores com campos de informações do modelo descrevem a extensão legada.

Passos (no editor)

1. Crie uma chave na sua página de chaves e adicione crédito.
2. Abra o Kilo Code, clique no ícone de engrenagem → aba Providers, role até o final e clique em Custom provider.
3. Preencha:
   • Provider ID: uberllm
   • Display name: UberLLM
   • Provider API: OpenAI Compatible
   • Base URL: https://api.uberllm.dev/v1
   • API key: sua chave ull_…
4. Pressione Fetch models. A lista vem do UberLLM; mantenha os que você quiser, por exemplo moonshotai/kimi-k3.
5. Clique em Submit, depois escolha o modelo no seletor de modelos do Kilo.

Passos (arquivo de configuração)

O mesmo provedor em ~/.config/kilo/kilo.jsonc (Windows: C:\Users\<you>\.config\kilo\kilo.jsonc; para um projeto, .kilo/kilo.jsonc no projeto):

{
  "provider": {
    "uberllm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "UberLLM",
      "env": ["UBERLLM_API_KEY"],
      "options": { "baseURL": "https://api.uberllm.dev/v1" },
      "models": {
        "moonshotai/kimi-k3": {
          "name": "moonshotai/kimi-k3",
          "tool_call": true,
          "limit": { "context": 200000, "output": 32000 }
        }
      }
    }
  },
  "model": "uberllm/moonshotai/kimi-k3"
}

Em seguida, defina UBERLLM_API_KEY=ull_your_key no seu ambiente. Os números limit são um exemplo: copie o comprimento de contexto real da página do modelo em uberllm.dev/models.

Duas configurações que as pessoas esquecem

• limit: sem ele, o Kilo trata o contexto como 0 e nunca compacta uma tarefa longa, então ele acaba falhando. A caixa de diálogo do editor não consegue configurá-lo; adicione-o no arquivo ("edit advanced settings in the JSON config file").
• tool_call: true: o agente do Kilo funciona através de ferramentas. Se o modelo responde em plain text em vez de editar arquivos, isso está faltando.

Prefere o formato Anthropic?

Kilo também oferece Provider API → Anthropic Messages. Com UberLLM, use https://api.uberllm.dev/v1 como a Base URL lá também (não o host puro), e a mesma chave. A busca de modelos não está disponível nesse modo, então digite os IDs você mesmo.

Solução de Problemas

• "Authentication failed. Check the API key above and try again." ao buscar: a chave está faltando ou tem um espaço.
• Modelo não está no seletor: a chave do modelo deve corresponder a uberllm/<model id>. Execute kilo models para ver o que Kilo carregou.
• Agente nunca edita arquivos: adicione "tool_call": true ao modelo.
• Tarefa falha após uma sessão longa: defina limit.context.
• 402 créditos insuficientes: adicione crédito na página de créditos.

Continue lendo

• Página de referência: documentação do Kilo Code
• Configuração do OpenCode (o formato de configuração do Kilo vem do OpenCode)
• Configuração do Cline