Cline com a API do Claude — configuração da URL base, roteamento dos modelos Plan/Act e custos reais

O Cline é um agente de programação autônomo e de código aberto para o VS Code, e não inclui um modelo — você o conecta a um, geralmente com sua própria chave de API. Este guia mostra as configurações exatas para executar o Claude no Cline por meio de uma chave sk-kn- com preço cerca de 30% abaixo da tarifa de tabela da Anthropic nos modelos principais: as duas rotas de provedor, como aproveitar os modos Plan/Act para reduzir a conta, quanto custa uma sessão real e uma descrição honesta do que você abre mão em comparação com chamar a Anthropic diretamente.

Por que o Cline precisa de uma chave de API

Cada ação executada pelo Cline — ler um arquivo, propor um diff, executar um comando de terminal, ler a saída e tentar novamente — é uma chamada ao modelo. O Cline pode executar essas chamadas em uma assinatura Claude Pro ou Max por meio do seu provedor Claude Code, que aciona a CLI do Claude e usa os limites da sua assinatura em vez da cobrança da API — com as desvantagens listadas na documentação do Cline em setembro de 2026: as respostas podem não ser transmitidas token a token, e os uploads de imagens e o cache de prompts são limitados nesse modo. Todas as outras rotas, incluindo os provedores OpenAI Compatible e Anthropic configurados neste guia, cobram por token por meio de uma chave de API. Nessas rotas, a questão não é pagar ou não por token, mas a que tarifa, e como um loop agentivo reenvia o contexto crescente da tarefa a cada etapa, a tarifa por token é o maior fator individual no custo de uma sessão. Essa é toda a justificativa para usar um gateway aqui: pagamento conforme o uso a partir de uma recarga de $10, uma chave que também alcança GPT e um saldo que nunca expira.

Configuração — os três campos

Abra o painel do Cline, clique na engrenagem de configurações e defina o provedor de API como OpenAI Compatible. Três valores:

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

Crie a chave em the dashboard depois de se inscrever e adicionar fundos — ela é exibida uma única vez, portanto armazene-a imediatamente. O gerenciamento de chaves, a rotação e os limites de gastos são abordados no documento sobre chaves da Claude API. Se o Cline pedir metadados do modelo, como a janela de contexto ou o limite de saída, obtenha os números na página do modelo, em vez de adivinhar — uma janela de contexto subestimada faz o Cline truncar mais cedo do que deveria.

Antes de permitir que ele edite qualquer coisa, peça algo pequeno (“explique este arquivo”) para confirmar a conexão. Um 401 nesse ponto quase sempre é a chave; um 404 quase sempre é a URL base ou um slug de modelo inexistente — a Kunavo corresponde exatamente aos slugs e não cria aliases para nomes com sufixo de data, portanto claude-sonnet-4-5-20250929 resulta em 404, enquanto claude-sonnet-4-6 é resolvido.

Modo Plan e modo Act — a divisão mais barata

A principal característica do Cline é separar Plan (ler a base de código, fazer perguntas, propor uma abordagem) de Act (fazer as edições, executar os comandos), permitindo configurar um modelo diferente para cada um. Isso se encaixa quase perfeitamente no custo, porque os dois modos têm perfis de tokens muito diferentes:

• Plan é curto e intenso em raciocínio. Algumas poucas interações em que a qualidade do modelo determina se as próximas vinte etapas serão produtivas ou desperdiçadas. Coloque claude-opus-5 aqui — ele representa uma pequena parcela dos tokens, portanto o modelo mais forte custa pouco em termos absolutos.
• Act é longo e mecânico. Muitas etapas, cada uma reenviando o contexto. É aqui que a tarifa por token se acumula, portanto o Sonnet mais barato pertence a este modo — claude-sonnet-5 na Kunavo hoje.

Os números calculados estão na seção de custos abaixo: planejar três etapas no Opus 5 e executar dezessete no Sonnet 5 custa cerca de $1,06, contra $0,87 na execução totalmente com Sonnet — aproximadamente 23% a mais por um planejamento materialmente melhor, e muito menos do que executar toda a tarefa no Opus.

A rota nativa da Anthropic (e por que você pode querer usá-la)

O Cline também oferece um provedor nativo Anthropic com um campo de URL base personalizado. Apontá-lo para a Kunavo usa a nativa Messages API (/v1/messages) em vez do endpoint compatível com OpenAI:

API Provider   Anthropic
Base URL       https://api.kunavo.com   # origin only — the client appends /v1/messages
API Key        sk-kn-...
Model ID       claude-sonnet-5

Observe que a URL base difere entre as duas rotas. O provedor compatível com OpenAI requer https://api.kunavo.com/v1; o provedor Anthropic requer a origem simples https://api.kunavo.com, porque esse cliente acrescenta /v1/messages por conta própria. Colar a forma /v1 no provedor Anthropic produz um 404 que parece indicar um modelo ausente.

O que a rota nativa oferece é o cache de prompts: cache_control é transmitido sem tradução, e a entrada armazenada em cache é cobrada a 10% da tarifa de entrada (consulte o documento sobre cache de prompts). Em um loop que reenvia um prefixo estável a cada etapa, essa é a maior economia disponível — maior do que qualquer troca de modelo. Ambas as rotas funcionam; a compatível com OpenAI é mais simples para começar, e a troca posterior é uma alteração de configuração.

Mas o cache de prompts 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 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 agentivo, é cada etapa depois da primeira. Um cache_control que o Cline defina ali é mantido. Na rota nativa, a solicitação é repassada como o Cline a enviou e nenhum ponto de interrupção é adicionado, então o que entra em cache depende dos pontos de interrupção que o Cline define.

Qual modelo Claude configurar

A troca é uma alteração de uma palavra no campo do modelo — mesma chave, mesma configuração do provedor, mesmo endpoint. As tarifas completas por modelo em comparação com a lista oficial da Anthropic estão na lista de preços da Claude API da Anthropic, e o catálogo atual está na página de preços.

Cline na Kunavo versus chamar a Anthropic diretamente

A comparação honesta, incluindo os casos em que chamar diretamente é a melhor escolha:

Leia essa linha de capacidade exatamente como está escrita. Se sua equipe precisar de uma cota garantida, um SLA contratual ou uma relação de compras com o fornecedor do modelo, vá diretamente — é por isso que você está pagando a diferença. Para um desenvolvedor individual ou uma equipe pequena executando o Cline, a troca geralmente funciona no sentido oposto.

Quanto custa realmente uma sessão do Cline

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),
    "claude-opus-5":     (3.50, 17.50),
}

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 Act-mode step: Cline resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, read the error, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# The same task planned on Opus 5, executed on Sonnet 5:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

Mantendo a conta baixa

1. Inicie tarefas novas em vez de estender uma para sempre. O Cline reenvia toda a conversa a cada etapa, portanto uma tarefa longa cresce quadraticamente em custo. Uma tarefa nova é um contexto novo e pequeno — este é o hábito de maior impacto da lista.
2. Divida Plan e Act entre modelos. Abordado acima: é um campo de configuração, não um problema de disciplina.
3. Use a rota nativa da Anthropic para o cache. A entrada armazenada em cache a 10% da tarifa de entrada é a maior economia estrutural em um loop que reenvia um prefixo estável.
4. Dê ao editor uma chave própria com limite de gastos. Crie uma chave separada em the dashboard, defina um limite mensal de gastos para ela e acompanhe usage — uma semana de programação agentiva real é a única estimativa honesta do custo para você. O limite é verificado antes de cada solicitação e é redefinido com o mês do calendário, e a chave pode ser revogada individualmente, portanto interromper o editor é uma ação, em vez de exigir a rotação de tudo.
5. Ainda está escolhendo entre as duas ferramentas? Cline vs Claude Code compara os formatos de cobrança, em vez das listas de recursos — e ambos usam este mesmo endpoint, portanto a escolha continua reversível.

Perguntas frequentes