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

No VS Code

1. Abra as definições do Kilo Code (a roda dentada) e vá ao separador Providers. Em baixo, clique em Custom provider.
2. Defina o Provider ID como zurelay, escolha um nome a apresentar e defina a Provider API como OpenAI Compatible.
3. Introduza o URL base, https://api.zurelay.com/v1, e a sua chave. Use Fetch models para carregar a lista de modelos, adicione os que pretende e submeta.
4. Escolha um modelo da Zurelay no menu de modelos do chat.

Estes passos seguem o documentação de fornecedores do Kilo. Fizemos a configuração no Kilo CLI. A documentação do Kilo indica que o CLI, o VS Code e o JetBrains leem os mesmos ficheiros de configuração, por isso um fornecedor configurado num deles aparece nos outros.

Na CLI do Kilo, ou ao editar o ficheiro

O Kilo guarda as suas definições em ~/.config/kilo/kilo.jsonc, que no Windows é %USERPROFILE%\.config\kilo\kilo.jsonc. Este é o ficheiro que testámos, 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 encontrámos

1. Provider not found: zurelay. A nossa primeira configuração tinha o URL base e a chave, mas não models, na expectativa de que o Kilo os carregasse a partir da API. A CLI não o faz: um fornecedor sem modelos listados não existe para ela. Liste cada modelo que pretende.
2. environment references are not allowed in project config. Ao passá-lo para .kilo/kilo.jsonc no projeto, o mesmo ficheiro foi recusado por causa de {env:ZURELAY_API_KEY}, e todos os modelos passaram a devolver Model not found. O Kilo não lê segredos da configuração do próprio projeto, por isso mantenha o fornecedor no ficheiro global.
3. Todas as tarefas mostravam $0.00 em kilo stats. O Kilo só contabiliza a despesa dos modelos com cost, em dólares por 1M de tokens. Com ele, o custo de cada mensagem em kilo export coincidiu com a nossa fatura: $0.0000406 contra $0.000041. A tabela de estatísticas continua a arredondar aos cêntimos, por isso as tarefas pequenas mostram aí $0.00.

Quanto custou no nosso teste

Num repositório git novo, o agente predefinido do Kilo escreveu um pequeno ficheiro Python no DeepSeek V4.1 Flash, editou-o no Claude Sonnet 5.5 e depois acrescentou uma linha, de novo no DeepSeek. Usou corretamente as suas ferramentas de ficheiros de cada vez. A Zurelay faturou:

Cada pedido 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 que o preço do modelo conta mais do que o tamanho da tarefa, e por isso a cache ajuda: na tarefa com o Claude, metade de todos os tokens do prompt veio da cache.

O que deve saber

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

Preços dos modelos em que o pode executar

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, com a API da Zurelay. A configuração resumida está em Kilo Code na documentação. A documentação do próprio Kilo: fornecedores compatíveis com OpenAI e modelos personalizados.