Kilo Code com a Claude API — configuração de URL base compatível com OpenAI e roteamento por modo

Kilo Code é um dos agentes de programação de IA de código aberto mais usados para o VS Code e, como seus semelhantes da família Cline, permite que você traga seu próprio endpoint de API compatível com OpenAI. Isso significa que você pode executar Claude dentro do seu editor com uma única chave sk-kn-, por cerca de 30% abaixo do preço de lista da Anthropic nos modelos principais. Este guia mostra a configuração dos três campos, qual modelo Claude escolher por tarefa e quanto uma sessão de programação agentiva realmente custa.

Por que o Kilo Code precisa de uma chave de API

O Kilo Code não inclui um modelo — cada ação (ler um arquivo, propor uma edição, executar um comando, verificar o resultado) é uma chamada de API, cobrada por token. Uma assinatura de chat como o Claude Pro não cobre isso; a extensão precisa de acesso direto à API. Esse é exatamente o formato oferecido pelo Kunavo: pré-pago a partir de uma recarga de $10, uma chave para Claude e GPT e saldo que nunca expira. Como os loops agentivos reenviam o contexto crescente da tarefa a cada etapa, a tarifa por token é o maior fator individual no custo de uma sessão — por isso o desconto de ~30% no claude-sonnet-5 se acumula rapidamente.

Os três campos

O Kilo Code expõe o provedor como três campos de configuração:

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

Obtenha a chave no painel depois de criar uma conta e recarregar $10 — ela é exibida uma única vez, então armazene-a imediatamente. O gerenciamento completo de chaves está descrito no documento sobre chaves da API do Claude.

Configuração do Kilo Code

1. Instale o Kilo Code pelo marketplace do VS Code e abra-o na barra lateral.
2. Abra as configurações da extensão (ícone de engrenagem) e vá para a seção Providers.
3. Defina API Provider como OpenAI Compatible.
4. URL base: https://api.kunavo.com/v1 · Chave da API: sua chave sk-kn-… · Modelo: claude-sonnet-5.
5. Salve e peça algo pequeno (“explique este arquivo”) para confirmar a conexão antes de permitir que ele edite o código.

O Kilo Code aceita substituições de modelo por modo (Architect / Code / Debug) — um bom lugar para direcionar o planejamento a um modelo mais forte (claude-opus-5) e a execução a um mais barato (claude-sonnet-5).

Cline e Roo Code

Kilo Code e Roo Code são forks da família Cline, portanto os três campos acima são idênticos nas três ferramentas — provedor OpenAI Compatible, URL base https://api.kunavo.com/v1, chave e ID do modelo. O que muda é o recurso que cada uma oferece para rotear modelos, e é aí que estão as economias de custo, portanto cada uma tem seu próprio guia: Cline com a API do Claude cobre a separação Plan/Act, e Roo Code com a API do Claude cobre seus perfis de configuração nomeados e a associação de modelos por modo.

As três ferramentas também oferecem um provedor nativo Anthropic com opção de URL base personalizada. Apontá-la para https://api.kunavo.com usa a Messages API nativa (/v1/messages) — útil porque cache_control é repassado sem tradução e a entrada em cache é cobrada a 10% da tarifa de entrada (consulte o documento sobre cache de prompts). Ambas as rotas funcionam; a compatível com OpenAI é a mais simples para começar.

Mas o cache de prompts em si não depende da rota nativa. Em um prompt longo, o Kunavo define ele mesmo os pontos de interrupção do cache na rota compatível com OpenAI: no prompt do sistema, nas definições de ferramentas e na última mensagem assim que a conversa contém um turno do assistente, o que, em um loop de agente, é cada etapa depois da primeira. Um cache_control que a extensão defina ali é mantido. Na rota nativa, a solicitação é repassada como a extensão a enviou e nenhum ponto de interrupção é adicionado, então o que entra em cache depende dos pontos de interrupção que a extensão define.

Qual modelo Claude escolher

claude-opus-5 é a escolha de raciocínio forte aqui: é o Opus mais novo da Anthropic e é cobrado à mesma tarifa $3,50 / $17,50 do claude-opus-4-7 da geração anterior ($3,50 / $17,50), que continua disponível se você estiver fixado nele. Como o campo do modelo é apenas um slug no mesmo endpoint, a troca exige uma palavra — nenhuma chave nova, nenhuma configuração de provedor nova. As tarifas completas de todos os modelos estão no guia de preços da API do Claude e na página de preços.

Quanto uma sessão realmente custa

Ferramentas agentivas consomem muitos tokens por design: cada etapa reenvia o prompt do sistema, o histórico da tarefa e o contexto novo dos arquivos. Números realistas às tarifas do Kunavo:

A matemática, pronta para executar:

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One agentic step: the tool resends the task context + file reads.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Mantendo a conta baixa

1. Comece tarefas novas em vez de prolongar uma indefinidamente. A ferramenta reenvia toda a conversa a cada etapa, portanto uma tarefa longa fica quadraticamente cara. Tarefa nova = contexto novo e pequeno.
2. Faça o roteamento por modo. O Kilo Code aceita um modelo por modo — Architect em claude-opus-5, Code em claude-sonnet-5, perguntas rápidas em claude-haiku-4-5. O planejamento representa uma pequena parte dos tokens, então o modelo mais forte nesse ponto custa pouco.
3. Use a rota nativa da Anthropic para cache. A entrada em cache é cobrada a 10% da tarifa de entrada — em um loop que reenvia um prefixo estável a cada etapa, essa é a maior economia disponível (como funciona).
4. Acompanhe os gastos por chave. Dê ao editor sua própria chave com um limite de gastos no painel e verifique o uso para saber quanto uma semana de programação agentiva realmente custa para você.

Perguntas frequentes