← Blog
Kilo CodeIntegraçãoAgentes de código

Kilo Code com Claude e GPT: configurar um provedor de API

(os preços do texto seguem a tabela de preços atual)

Resposta curta

Para usar o Kilo Code com a APIVAI, abra Settings no Kilo Code, vá até a aba Providers, clique em Custom provider, escolha OpenAI Compatible em Provider API, informe https://api.apivai.com/v1 como Base URL, cole sua chave da APIVAI em API key e adicione um ID de modelo como claude-sonnet-4-6 ou gpt-5.5. Se você só usa o Claude, pode escolher Anthropic Messages como Provider API, e no Kilo Code essa opção também recebe https://api.apivai.com/v1 com /v1, porque o Kilo Code acrescenta apenas /messages à Base URL. Em 2026-10-10, o Claude Sonnet 4.6 custa $1.15 / $5.74 por milhão de tokens de entrada / saída pela APIVAI, contra $3.00 / $15.00 no preço oficial. Você paga por token a partir de um saldo pré-pago, sem assinatura.

O que é o Kilo Code e por que conectar sua própria chave de API?

O Kilo Code é um agente de programação com IA, de código aberto, que roda como extensão do VS Code, plugin do JetBrains e ferramenta de linha de comando. Ele planeja mudanças, edita arquivos em todo o projeto e executa comandos com a sua aprovação. O Kilo Code precisa de um provedor de modelos, e cada passo de uma tarefa é uma requisição cobrada por esse provedor.

Este guia segue a documentação atual do Kilo Code e a extensão do VS Code 7.8 (outubro de 2026), em que APIs de terceiros são adicionadas pelo diálogo Custom provider. Se a sua tela de configurações não tem o botão Custom provider, atualize a extensão primeiro.

A APIVAI oferece uma única chave para modelos Claude e GPT, cobrada por token (abaixo dos preços oficiais na maioria dos modelos), a partir de um saldo que você mesmo recarrega. A mesma chave funciona no formato da OpenAI e no da Anthropic, então serve para todas as opções de Provider API do Kilo Code.

Qual Provider API escolher no Kilo Code?

O diálogo de provedor personalizado oferece três protocolos. Com a APIVAI, os três usam a mesma Base URL:

Provider APIBase URLModelosLista de modelos
OpenAI Compatiblehttps://api.apivai.com/v1Claude e GPTFetch models funciona
Anthropic Messageshttps://api.apivai.com/v1Só ClaudeVocê digita os IDs
OpenAI Responseshttps://api.apivai.com/v1GPTFetch models funciona

Escolha OpenAI Compatible se quiser um único provedor para Claude e GPT. Adicione um provedor Anthropic Messages se você trabalha principalmente com o Claude: o Kilo Code passa a enviar requisições nativas da Anthropic com marcações cache_control, e o contexto repetido é cobrado pelo preço de leitura do cache, $0.12 por milhão de tokens no Claude Sonnet 4.6, em vez do preço cheio de entrada. A gravação em cache custa $1.44 por milhão. OpenAI Responses é opcional: os modelos GPT já funcionam pelo OpenAI Compatible.

Como configurar o Kilo Code com a APIVAI passo a passo?

Passo 1: Crie uma chave da APIVAI

  1. Cadastre-se em apivai.com com seu e-mail.
  2. Recarregue a partir de $10 com cartão, cripto, Alipay ou WeChat Pay. Não há teste grátis nem assinatura.
  3. No Dashboard, crie uma chave e copie. Defina um limite de orçamento se quiser um teto rígido para o que o Kilo Code pode gastar.

Passo 2: Adicione a APIVAI como provedor personalizado

  1. No VS Code, abra o painel do Kilo Code, clique no ícone de engrenagem para abrir Settings e vá até a aba Providers.
  2. Role até o final e clique em Custom provider.
  3. Preencha o diálogo conforme a tabela e clique em Submit.
CampoValor
Provider IDapivai (letras minúsculas, números, hifens ou sublinhados)
Display nameAPIVAI
Provider APIOpenAI Compatible
Base URLhttps://api.apivai.com/v1
API keySua chave da APIVAI
ModelsClique em Fetch models e selecione, por exemplo, claude-sonnet-4-6 e gpt-5.5

Com a Base URL e a chave preenchidas, o Kilo Code chama GET /v1/models com a sua chave e mostra uma lista pesquisável, então você só adiciona IDs que a APIVAI realmente oferece. Se a busca falhar, confira a chave e a URL, ou clique em Add model e digite o ID exato. A Base URL contém /v1 uma única vez; o Kilo Code acrescenta /chat/completions. Depois do Submit, escolha o modelo no seletor de modelos do Kilo Code.

Você pode conferir a mesma lista pelo terminal:

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer YOUR_APIVAI_KEY"

Modelos são adicionados e retirados com o tempo, então copie os IDs dessa lista ou da página de preços.

Passo 3 (opcional): Adicione um provedor Claude com Anthropic Messages

  1. Clique em Custom provider de novo.
  2. Defina Provider ID como apivai-claude e Display name como "APIVAI Claude".
  3. Em Provider API, escolha Anthropic Messages.
  4. Informe https://api.apivai.com/v1 como Base URL e cole a mesma chave em API key.
  5. Em Models, clique em Add model e digite cada ID do Claude, por exemplo claude-sonnet-4-6 e claude-opus-5-5. Fetch models não está disponível para esse Provider API.
  6. Clique em Submit.

Mantenha o /v1 aqui. O cliente Anthropic Messages do Kilo Code trata a Base URL como o prefixo versionado da API (o padrão dele é https://api.anthropic.com/v1) e acrescenta apenas /messages, então as requisições vão para https://api.apivai.com/v1/messages. É o oposto do Claude Code e do Roo Code, em que a URL base da Anthropic é https://api.apivai.com sem /v1. Veja mais sobre o formato da Anthropic na página do proxy da API do Claude.

Passo 4: Defina os limites de tokens no arquivo de configuração

O diálogo não define limites de contexto nem de saída. A documentação do Kilo Code recomenda definir limit.context e limit.output para modelos personalizados: se os dois faltarem, eles valem 0 e a compactação automática de contexto fica desativada. Edite o provedor (o diálogo tem o link Edit advanced settings in the JSON config file) ou abra a configuração global ~/.config/kilo/kilo.json e adicione os limites no seu provedor:

{
  "provider": {
    "apivai": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.apivai.com/v1"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "tool_call": true,
          "limit": { "context": 200000, "output": 16384 }
        }
      }
    }
  },
  "model": "apivai/claude-sonnet-4-6"
}

Use em limit.context a janela de contexto informada na página do modelo e mantenha limit.output em 16384 (no mínimo 4096). A chave que você digitou no diálogo continua onde o Kilo Code a salvou; para lê-la de uma variável de ambiente, adicione "apiKey": "{env:APIVAI_API_KEY}" em options (funciona na configuração global, não em um kilo.json do projeto). O Kilo CLI lê o mesmo arquivo.

Qual modelo escolher no Kilo Code?

Preços por 1M de tokens de entrada / saída em 2026-10-10:

ID do modeloPreço (entrada / saída)Indicado para
claude-sonnet-4-6$1.15 / $5.74Programação do dia a dia: o padrão
claude-sonnet-5-5$0.77 / $3.82Programar com o Sonnet mais novo
claude-opus-5-5$1.54 / $7.65Planejamento, os bugs mais difíceis
claude-haiku-4-5$0.38 / $1.92Perguntas rápidas e baratas, edições pequenas
gpt-6-sol$0.30 / $1.52Alternativa GPT para programar ou revisar
gpt-6-luna$0.0144 / $0.0768Perguntas muito baratas

Os agentes do Kilo Code chamam ferramentas em quase todo passo, então escolha modelos com suporte a function calling; todos os da tabela têm. Se uma tarefa fica andando em círculos no Sonnet, troque essa tarefa para o Opus em vez de tornar o Opus o seu padrão.

Quanto custa o Kilo Code com a APIVAI?

Cada passo de uma tarefa do agente reenvia a conversa e os arquivos lidos até ali, então os tokens de entrada são a maior parte do gasto. Dois exemplos calculados:

  • Uma tarefa de programação com o Claude Sonnet 4.6: cerca de 25 requisições de 35.000 tokens de entrada e 2.000 de saída cada. Custo: $1.29 com a APIVAI, $3.38 no preço oficial.
  • Um mês de trabalho com três tarefas dessas por dia durante 22 dias (1.650 requisições): $85.35 com a APIVAI, $223 no preço oficial. Mandar 20 perguntas rápidas por dia para o Claude Haiku 4.5 (8.000 tokens de entrada e 800 de saída cada, 440 por mês) acrescenta $2.01.

Esses valores não consideram o cache de prompts, que barateia o contexto repetido no provedor Anthropic Messages. Tokens de raciocínio contam como tokens de saída. Os seus números reais por requisição estão no Dashboard. Para uma comparação mais ampla, leia os preços da API do Claude em 2026.

Como resolver os erros mais comuns do Kilo Code?

  • "Authentication failed" ao buscar os modelos, ou 401: a chave está incompleta, foi excluída ou passou do limite de orçamento; confira o Dashboard e cole a chave de novo, sem espaços.
  • 404 Not Found: /v1 errado. No Kilo Code, todo Provider API usa https://api.apivai.com/v1. Sem o /v1, o Anthropic Messages chama /messages e o OpenAI Compatible chama /chat/completions no caminho errado.
  • Anthropic Messages não encontra modelos: é o esperado; esse Provider API não busca a lista. Adicione os IDs do Claude com Add model.
  • Modelo não encontrado: use o ID exato, como claude-sonnet-4-6, e não um nome de exibição. Compare com GET /v1/models.
  • Respostas vazias ou truncadas: o raciocínio vem ativado por padrão e consome tokens de saída. Defina limit.output como 16384 (no mínimo 4096).
  • O contexto nunca é compactado em tarefas longas: defina limit.context e limit.output como no passo 4.
  • 429 Too Many Requests: o limite padrão é de 60 requisições por minuto por chave. Espere um pouco ou peça ao suporte para aumentá-lo.

Há mais informações sobre os formatos de requisição na documentação e na página de API compatível com OpenAI.

Perguntas frequentes

Posso usar Claude e GPT no Kilo Code com uma única chave?

Sim. Uma chave da APIVAI funciona com todos os modelos. Um único provedor OpenAI Compatible pode listar IDs do Claude e do GPT lado a lado.

Uso OpenAI Compatible ou Anthropic Messages?

Use OpenAI Compatible para os modelos GPT ou para ter um único provedor. Adicione Anthropic Messages para trabalhar principalmente com o Claude, em que o Kilo Code usa cache de prompts; a Base URL dele também é https://api.apivai.com/v1.

Por que o Kilo Code precisa de /v1 na Anthropic e o Claude Code não?

O cliente do Claude Code acrescenta /v1/messages à URL base, enquanto o cliente Anthropic Messages do Kilo Code acrescenta só /messages. Os dois chegam a https://api.apivai.com/v1/messages.

A mesma configuração funciona no Kilo CLI?

Sim. O CLI lê o provedor do kilo.json, então o bloco de configuração do passo 4 funciona lá também.

A APIVAI armazena meu código?

Não. O conteúdo das requisições e respostas não é registrado; só ficam guardados dados de uso como modelo, tokens e custo, para a cobrança.

Qual a diferença em relação ao Roo Code ou ao Cline?

Os modelos e a chave são os mesmos, mas as telas mudam. Veja o guia do Roo Code e o guia do Cline.

Crie uma conta, recarregue a partir de $10 e cole sua chave no Kilo Code.

Pronto para começar?

Obtenha sua chave de API em 30 segundos. Pague pelo uso do Claude e do GPT.

Começar