Kilo Code com a API do Claude — configuração da URL base (também Cline e Roo Code)

Kilo Code, Cline e Roo Code são os agentes de programação de IA de código aberto mais usados no VS Code — e os três aceitam um endpoint compatível com OpenAI personalizado. Assim, você pode executar o Claude no seu editor com uma única chave sk-kn-, por aproximadamente 30 % abaixo da tarifa oficial da Anthropic nos principais modelos. Este guia apresenta a configuração em três campos para cada ferramenta, o modelo Claude a escolher conforme a tarefa e o custo real de uma sessão de programação agêntica.

Por que essas ferramentas exigem uma chave de API

Kilo Code, Cline e Roo Code não incluem um modelo: cada ação (ler um arquivo, propor uma alteração, executar um comando e verificar o resultado) é uma chamada de API, cobrada por token. Uma assinatura de chat como Claude Pro não cobre isso — é necessário acesso direto à API. É exatamente isso que o Kunavo oferece: modelo pré-pago a partir de uma recarga de $10, uma chave para Claude e GPT, saldo que nunca expira e pagamento com cartão a partir da França (os detalhes de IVA e RGPD estão no guia da API Claude na França). Como o loop agêntico reenvia o contexto em cada etapa, a tarifa por token é o primeiro fator do custo de uma sessão.

Os três campos (todas as ferramentas)

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

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # à créer sur kunavo.com/app/keys
Model ID       claude-sonnet-5        # ou claude-opus-4-7 / claude-haiku-4-5

Crie a chave no painel após a inscrição e uma recarga de $10 — ela será exibida apenas uma vez; armazene-a imediatamente.

Configurar o 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), na seção Providers.
3. Defina API Provider como OpenAI Compatible.
4. URL base: https://api.kunavo.com/v1 · chave de API: sua sk-kn-… · modelo: claude-sonnet-5.
5. Salve e teste com uma solicitação simples (« explique este arquivo ») antes de permitir que ele modifique código.

O Kilo Code permite um modelo diferente por modo (Architect / Code / Debug) — útil para encaminhar o planejamento a um modelo mais poderoso e a execução a um mais barato.

Configurar o Cline

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

Configurar o Roo Code

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

As três ferramentas também oferecem um provedor Anthropic nativo com uma opção de URL base personalizada. Ao apontá-lo para https://api.kunavo.com, você passa pela API nativa Messages (/v1/messages) — algo interessante porque cache_control passa sem alterações e a entrada em cache é cobrada a 10% da tarifa de entrada (consulte a documentação de cache de prompts). As duas rotas funcionam; a rota compatível com OpenAI é a mais simples para começar.

Qual modelo Claude devo escolher?

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

O custo real de uma sessão

As ferramentas agênticas consomem muitos tokens por design: cada etapa reenvia o prompt de sistema, o histórico da tarefa e o contexto dos arquivos. Números realistas com as tarifas do Kunavo:

O cálculo, pronto para executar:

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

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

# Une étape agentique : l'outil renvoie le contexte + les fichiers lus.
print(cout_etape("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Une tâche réaliste de 20 étapes (éditer, lancer, corriger, répéter) :
print(20 * cout_etape("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Mantendo a fatura baixa

1. Abra novas tarefas em vez de prolongar a mesma. A ferramenta reenvia toda a conversa a cada etapa: uma tarefa interminável fica quadraticamente cara. Nova tarefa = contexto curto.
2. Faça o roteamento por modo. Kilo Code e Roo Code aceitam um modelo por modo — Architect em claude-opus-4-7, Code em claude-sonnet-5 e perguntas rápidas em claude-haiku-4-5.
3. Use a rota Anthropic nativa para o cache. A entrada em cache é cobrada a 10% da tarifa — 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 em uso quanto realmente custa uma semana de programação agêntica.

Perguntas frequentes