Kilo Code com a API do Claude — base URL, modelos e custo (também Cline e Roo Code)

Kilo Code, Cline e Roo Code são os agentes de código open source mais usados dentro do VS Code — e os três aceitam um endpoint compatível com OpenAI personalizado. Ou seja: dá para rodar Claude dentro do seu editor com uma única chave sk-kn-, a cerca de 30% abaixo da tabela oficial da Anthropic nos modelos principais. Este guia traz a configuração em três campos para cada ferramenta, qual modelo Claude escolher por tipo de tarefa, o custo real de uma sessão de codificação agentic e como pagar do Brasil por Pix, sem cartão internacional.

Por que essas ferramentas pedem uma chave de API

Kilo Code, Cline e Roo Code não embarcam modelo nenhum: cada ação (ler um arquivo, propor uma alteração, rodar um comando, conferir o resultado) é uma chamada de API cobrada por token. Uma assinatura de chat como o Claude Pro não cobre isso — é preciso acesso direto à API. É exatamente para isso que serve a Kunavo: pay-as-you-go a partir de $10 de recarga, uma chave para Claude e GPT, saldo que nunca expira, e pagamento do Brasil por Pix ou cartão (o contexto completo de latência, LGPD e nota fiscal está no guia Claude API no Brasil). Como o laço agentic reenvia o contexto a cada passo, a tarifa por token é a primeira alavanca do custo de uma sessão.

Os três campos (vale para as três ferramentas)

As três extensões compartilham o mesmo modelo de provider — Kilo Code e Roo Code são forks da família Cline —, então a configuração é idêntica:

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

Crie a chave no dashboard depois de se cadastrar e recarregar $10 — ela aparece uma única vez, guarde na hora.

Configurar o Kilo Code

1. Instale o Kilo Code pelo marketplace do VS Code e abra o painel na barra lateral.
2. Abra as configurações da extensão (ícone de engrenagem), seção Providers.
3. Deixe API Provider em OpenAI Compatible.
4. Base URL: https://api.kunavo.com/v1 · chave de API: a sua sk-kn-… · modelo: claude-sonnet-5.
5. Salve e teste com um pedido simples (“explique este arquivo”) antes de deixar a ferramenta editar código.

O Kilo Code permite um modelo diferente por modo (Architect / Code / Debug) — prático para mandar o planejamento a um modelo mais forte e a execução a um mais barato.

Configurar o Cline

1. Instale o Cline e abra o painel dele.
2. Clique na engrenagem de configurações e, em API Provider, escolha OpenAI Compatible.
3. Preencha os mesmos três valores: base URL https://api.kunavo.com/v1, a sua chave e o model ID claude-sonnet-5.
4. Se o Cline pedir os metadados do modelo (janela de contexto, teto de output), use os números da página do modelo.

Configurar o Roo Code

Idêntico aos outros dois: Settings → Providers → API Provider → OpenAI Compatible, depois base URL https://api.kunavo.com/v1, chave e model ID. O sistema de modos do Roo Code (Code / Architect / Ask / Debug) também aceita um modelo por modo.

As três ferramentas oferecem ainda um provider Anthropic nativo com opção de base URL personalizada. Apontando para https://api.kunavo.com, você passa pela API nativa Messages (/v1/messages) — interessante porque cache_control passa direto e o input em cache é cobrado a 10% da tarifa de input (veja a documentação de prompt caching). As duas rotas funcionam; a compatível com OpenAI é a mais simples para começar.

Mas o prompt caching em si não depende da rota nativa. Em um prompt longo, a Kunavo define ela mesma os pontos de interrupção do cache na rota compatível com OpenAI: no system prompt, nas definições de ferramentas e na última mensagem assim que a conversa contém um turno do assistente, o que num laço agentic é todo passo depois do primeiro. Um cache_control que a extensão defina ali é mantido. Na rota nativa, a requisição segue 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.

Pagar do Brasil — Pix, sem cartão internacional

O ponto que trava a maioria dos desenvolvedores brasileiros não é a configuração, é o pagamento: cobrar a API da Anthropic direto exige cartão de crédito internacional habilitado para compras no exterior. Na Kunavo o pagamento é processado pelo Stripe e o Pix aparece como forma de pagamento para quem paga do Brasil — valor exibido em reais, compensação na hora, sem depender de cartão internacional. Cartões internacionais (Visa, Mastercard, American Express), Apple Pay, Google Pay e Link também funcionam normalmente.

As tarifas por token são definidas em USD: no Pix (e no cartão, quando o checkout aparece em reais) o Stripe mostra a conversão em reais antes de você confirmar, e essa taxa inclui um custo de câmbio de 2–4% pago por quem compra; se você escolher pagar o cartão em dólar, esse custo some e a conversão segue a taxa do emissor (confira IOF e tarifa de transação internacional no app do seu banco) — a recarga por Pix, passo a passo, está no guia de como pagar a API com Pix. É uma carteira pré-paga: recarga mínima de $10, sem mensalidade, e o saldo nunca expira — então um mês sem codificar não custa nada, ao contrário de uma assinatura.

Qual modelo Claude escolher?

O campo de modelo é apenas um slug no mesmo endpoint: trocar de modelo é mudar uma palavra — sem chave nova, sem provider novo. As tarifas completas estão no guia de preço da API do Claude e na página de preços.

O custo real de uma sessão

Ferramentas agentic consomem muitos tokens por design: cada passo reenvia o system prompt, o histórico da tarefa e o contexto dos arquivos. Números realistas às tarifas da Kunavo:

Ou seja: uma recarga de $10 por Pix cobre cerca de 11 tarefas agentic de 20 passos no Sonnet 5. A conta, para você mesmo rodar:

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

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

# Um passo do agente: a ferramenta reenvia o contexto + os arquivos lidos.
print(custo_passo("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Uma tarefa realista de 20 passos (editar, rodar, corrigir, repetir):
print(20 * custo_passo("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Português consome ~10–20% mais tokens que inglês no mesmo conteúdo — vale considerar quando o prompt e os comentários do código estão em português.

Como manter a fatura baixa

1. Abra tarefas novas em vez de esticar a mesma. A ferramenta reenvia a conversa inteira a cada passo: uma tarefa interminável custa de forma quadrática. Tarefa nova = contexto curto.
2. Roteie por modo. Kilo Code e Roo Code aceitam um modelo por modo — Architect no claude-opus-5, Code no claude-sonnet-5, perguntas rápidas no claude-haiku-4-5.
3. Use a rota Anthropic nativa para o caching. O input em cache é cobrado a 10% da tarifa — num laço que reenvia um prefixo estável a cada passo, é a maior economia disponível (como funciona).
4. Acompanhe o gasto por chave. Dê ao editor uma chave própria com teto de gasto no dashboard e confira no painel de uso quanto custa de verdade uma semana de codificação agentic.

Perguntas frequentes