Kilo Code com um provedor personalizado: DeepSeek, Claude ou qualquer modelo compatível com OpenAI

No VS Code

1. Abra as configurações do Kilo Code (a engrenagem) e vá para a aba Providers. Na parte de baixo, clique em Custom provider.
2. Defina Provider ID como zurelay, escolha um nome de exibição e defina Provider API como OpenAI Compatible.
3. Informe a URL base, https://api.zurelay.com/v1, e a sua chave. Use Fetch models para carregar a lista de modelos, adicione os que quiser e envie.
4. Escolha um modelo da Zurelay no menu de modelos do chat.

Estes passos seguem documentação de provedores da Kilo. Fizemos a configuração na Kilo CLI. A documentação da Kilo diz que a CLI, o VS Code e o JetBrains leem os mesmos arquivos de configuração, então um provedor configurado em um deles aparece nos outros.

Na CLI do Kilo ou editando o arquivo

O Kilo guarda as configurações em ~/.config/kilo/kilo.jsonc, que no Windows é %USERPROFILE%\.config\kilo\kilo.jsonc. Este é o arquivo que testamos, com os preços atuais da Zurelay por 1M de tokens:

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "zurelay/deepseek-v4.1-flash",
  "small_model": "zurelay/deepseek-v4.1-flash",
  "provider": {
    "zurelay": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zurelay",
      "options": {
        "baseURL": "https://api.zurelay.com/v1",
        "apiKey": "{env:ZURELAY_API_KEY}"
      },
      "models": {
        "deepseek-v4.1-flash": {
          "name": "DeepSeek V4.1 Flash",
          "cost": { "input": 0.03, "output": 0.12, "cache_read": 0.00074 }
        },
        "claude-sonnet-5-5": {
          "name": "Claude Sonnet 5.5",
          "cost": { "input": 0.79, "output": 3.95, "cache_read": 0.079 }
        }
      }
    }
  }
}

Depois, instale a CLI, defina a chave e execute uma tarefa:

npm install -g @kilocode/cli
export ZURELAY_API_KEY="zr_live_..."
kilo models zurelay
kilo run -m zurelay/claude-sonnet-5-5 "Add a README for this project"
kilo                     # or the full terminal UI

Três erros que encontramos

1. Provider not found: zurelay. Nossa primeira configuração tinha a URL base e a chave, mas não models, esperando que o Kilo carregasse os modelos da API. A CLI não faz isso: para ela, um provedor sem modelos listados não existe. Liste cada modelo que você quiser.
2. environment references are not allowed in project config. Ao mover o arquivo para .kilo/kilo.jsonc no projeto, ele foi recusado por causa de {env:ZURELAY_API_KEY}, e todos os modelos passaram a retornar Model not found. O Kilo não lê segredos da configuração do próprio projeto, então mantenha o provedor no arquivo global.
3. Todas as tarefas mostravam $0.00 em kilo stats. O Kilo só contabiliza o gasto de modelos que têm cost, em dólares por 1M de tokens. Com isso, o custo de cada mensagem em kilo export bateu com a nossa fatura: $0.0000406 contra $0.000041. A tabela de estatísticas ainda arredonda para centavos, então tarefas pequenas aparecem como $0.00 nela.

Quanto custou no nosso teste

Em um repositório git novo, o agente padrão do Kilo escreveu um pequeno arquivo Python com o DeepSeek V4.1 Flash, o editou com o Claude Sonnet 5.5 e depois adicionou uma linha com o DeepSeek de novo. Ele usou corretamente suas ferramentas de arquivo todas as vezes. A Zurelay cobrou:

Toda requisição leva as instruções e as definições de ferramentas do Kilo, cerca de 16.000 tokens no DeepSeek e 22.000 no Claude, antes de qualquer código seu. Por isso o preço do modelo pesa mais do que o tamanho da tarefa, e por isso o cache ajuda: na tarefa com o Claude, metade de todos os tokens do prompt veio do cache.

O que você precisa saber

• Escolha OpenAI Compatible mesmo para modelos GPT e Grok. A opção OpenAI Responses do Kilo chama a API Responses da OpenAI, que a Zurelay não oferece.
• Escolha modelos que suportem chamada de ferramentas. O agente do Kilo lê e edita arquivos por meio de ferramentas, então um modelo sem elas só consegue conversar.
• small_model cuida de títulos e outras tarefas rápidas. Um modelo barato, como o DeepSeek V4.1 Flash, já basta.
• O npm 11 pulou o script de instalação da CLI para nós (install scripts not yet covered by allowScripts). O comando kilo funcionou sem ele.

Preços dos modelos em que você usaria

Por 1M tokens, o preço de tabela do laboratório e o da Zurelay:

Testado em 3 de novembro de 2026 com a CLI do Kilo 7.8.18 no Windows, na API da Zurelay. A configuração resumida está em Kilo Code na documentação. A documentação do próprio Kilo: provedores compatíveis com OpenAI e modelos personalizados.