Como usar o Cline — separe os modelos entre Plan e Act e calcule até o custo de uma tarefa

O Cline é um agente de programação de IA de código aberto que funciona em editores como o VS Code. O uso tem 3 etapas — instalar a extensão, configurar o provedor de API e a chave (o Cline não inclui modelos) e planejar no modo Plan antes de executar no modo Act. O custo é determinado pelos modelos atribuídos ao Plan e ao Act: ative “Use different models for Plan and Act” nas configurações e atribua claude-opus-5 ao Plan e claude-haiku-4-5 ao Act usando a mesma chave; assim, uma tarefa de 20 etapas cai de aproximadamente $2.17 usando apenas Opus 5 para aproximadamente $0.69 (calculado com as tarifas da Kunavo).

Muitos artigos explicativos em japonês terminam na instalação e no primeiro pedido, mantendo o modelo fixo em um modelo gratuito ou em um único modelo pago. Esta página vai além — a configuração que separa os modelos do Plan e do Act e o cálculo do custo de uma tarefa — usando uma única chave do início ao fim.

O que é o Cline — os dois modos, Plan e Act

O Cline é um agente que executa um ciclo em que lê arquivos, propõe alterações, executa comandos no terminal, lê os resultados e corrige novamente. Há dois modos; na documentação oficial do Cline, eles são definidos da seguinte forma.

• Modo Plan: ler a base de código, pesquisar e discutir a abordagem. Não pode alterar arquivos nem executar comandos.
• Modo Act: manter o contexto da conversa no Plan, alterar arquivos e executar comandos.

Essa separação também se torna uma separação de custos. O Plan tem menos interações, e a qualidade das decisões tomadas nele influencia as dezenas de etapas seguintes. O Act tem mais interações e reenvia o contexto da tarefa a cada vez, acumulando o preço dos tokens. Use um modelo forte no Plan e um modelo barato no Act — a própria documentação do Cline sugere um modelo com forte raciocínio para o planejamento e um modelo rápido para a implementação.

Instalação e configuração inicial

1. No VS Code, abra a visualização de extensões (Ctrl / Cmd + Shift + X), pesquise “Cline” e instale-o. Ele também funciona no Cursor, Windsurf, IDEs da JetBrains e outros.
2. Abra o Cline na barra lateral e, nas configurações (⚙︎), selecione “OpenAI Compatible” em API Provider.
3. Preencha Base URL, API Key e Model ID e complete os campos de Model Configuration (janela de contexto, saída máxima, suporte a imagens e preços de entrada e saída).

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1   # /v1 まで入れる
API Key        sk-kn-...                    # /app/keys で発行（表示は一度きり）
Model ID       claude-opus-5

Informe a Base URL até /v1. O Cline acrescenta apenas a rota depois disso; sem /v1, ocorrerá um erro 404. Se retornar 401, a URL está correta e a chave está errada. Em vez de permitir edições imediatamente, é mais seguro confirmar a conexão primeiro com um pedido pequeno, como “explique este arquivo”. A chave é gerada em /app/keys e é exibida apenas uma vez, então salve-a imediatamente.

Input Price / Output Price em Model Configuration são a base do cálculo do custo exibido pelo Cline durante a tarefa. Esses valores não são obtidos automaticamente a partir do endpoint; se ficarem vazios ou com os valores padrão, o custo exibido ficará incorreto. Informe as tarifas por 1 milhão de tokens do modelo usado. A lista de campos de configuração está na documentação de integração do Cline.

Separar os modelos do Plan e do Act

Ao marcar “Use different models for Plan and Act” nas configurações, você poderá escolher modelos separados para o Plan e o Act. A Base URL e a chave são iguais nos dois; apenas o Model ID e as tarifas mudam.

[✓] Use different models for Plan and Act

── Plan Mode ─────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...
Model ID           claude-opus-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        3.50      # 1M トークンあたり USD
  Output Price       17.50

── Act Mode ──────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...            # Plan と同じキーでよい
Model ID           claude-haiku-4-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        0.70
  Output Price       3.50

O motivo para colocar o Opus 5 no Plan é simples. O Plan representa apenas uma pequena parte do total de tokens, mas um erro de abordagem ali pode desperdiçar todas as etapas do Act. O Haiku 4.5 no Act funciona bem porque, quando o plano é concreto, o restante consiste em repetir edição e execução, e é aí que a tarifa dos tokens tem maior impacto.

Se o modo Plan estiver configurado para Sonnet 5, cada etapa custa cerca de $0.0434; com Opus 5, cerca de $0.11.Claude Sonnet 5 custa $1.40 / $7.00 por 1 milhão de tokens.

Se o Act travar, passe a usar Opus 5 no Act apenas nessa tarefa. Repetir o mesmo erro duas vezes é um sinal para mudar. Tentar insistir com Haiku e aumentar o número de etapas acaba custando mais. Basta alterar um Model ID nas configurações; a chave e o endpoint permanecem iguais.

Calcular o custo de uma tarefa

O Cline reenvia o prompt do sistema, o histórico da tarefa e os arquivos lidos a cada etapa, portanto o custo é determinado pelo número de etapas, não pelo tempo. Assim como nas outras páginas de preços deste site, calculamos uma etapa como 25.000 tokens de entrada / 1.200 de saída e uma tarefa como 20 etapas (Plan 3 + Act 17).

Separando Plan e Act, o custo fica em aproximadamente 32% do custo de usar Opus 5 em tudo, mantendo a qualidade do planejamento do Opus 5. Usar Haiku em tudo fica ainda mais barato, mas, considerando o retrabalho causado por erros de planejamento, a diferença de $0.26 é um pequeno preço de seguro para o Plan. O código para conferir o cálculo é este.

# 1 タスクの費用を、ステップ数から出す。
# 単価は Kunavo の 1M トークンあたり USD (input, output)。
RATES = {
    "claude-opus-5":    (3.50, 17.50),
    "claude-haiku-4-5": (0.70, 3.50),
}

def step(model, inp=25_000, out=1_200):
    i, o = RATES[model]
    return inp / 1e6 * i + out / 1e6 * o

all_opus = 20 * step("claude-opus-5")
split = 3 * step("claude-opus-5") + 17 * step("claude-haiku-4-5")

print(round(all_opus, 2))   # -> 2.17  全部 Opus 5
print(round(split, 2))      # -> 0.69  Plan = Opus 5 / Act = Haiku 4.5

Como escolher os modelos

O GPT-5.6 Sol é cobrado com 2x para a entrada e 1,5x para a saída em toda a solicitação quando o prompt ultrapassa 272K tokens. Se você o usar no Plan, é seguro manter a Context Window abaixo de 272K. Para saber mais sobre as diferenças entre Opus e Sonnet, consulte Diferenças entre Claude Opus e Sonnet; as tarifas de todos os modelos Claude estão reunidas em Preços do Claude.

5 hábitos para reduzir custos

1. Não prolongue a tarefa; divida-a e inicie uma nova tarefa. Como todo o histórico é reenviado a cada etapa, quanto mais longa a tarefa, mais cara fica cada etapa. É o hábito mais eficaz.
2. Se usar cache de prompts, faça isso pelo provedor Anthropic. Defina API Provider como “Anthropic”, marque “Use custom base URL” e informe https://api.kunavo.com (não inclua /v1; o cliente acrescenta /v1/messages). As leituras do cache do Claude custam 10% da tarifa de entrada, e as gravações custam 1,25 vez a tarifa de entrada. Consulte o funcionamento na documentação de cache.
3. Escreva as regras em .clinerules/. É um arquivo Markdown na raiz do projeto cujas instruções se aplicam a todas as conversas. Como ele é incluído em todas as solicitações, mantenha-o curto e restrito às regras (documentação de regras do Cline).
4. Use a aprovação automática apenas para operações de leitura. Permitir leituras de arquivos e ações semelhantes com o Auto Approve reduz as confirmações. O modo YOLO, que aprova tudo automaticamente, deve ser usado apenas em ambientes descartáveis, como a própria documentação do Cline deixa claro ao classificá-lo como perigoso. É possível reverter alterações com Checkpoints.
5. Crie uma chave exclusiva para o Cline e defina um limite mensal. Em /app/keys você pode definir um limite mensal de uso por chave (que retorna 402 ao ser atingido) e uma lista de permissões de IP. Para interromper o editor, basta desativar essa chave.

Honestamente — quando uma assinatura ou um contrato direto é mais adequado

Se você tem Claude Pro / Max, também pode escolher o provedor “Claude Code” do Cline. Nesse caso, a franquia da assinatura é usada, em vez da cobrança por token, por meio da CLI do Claude Code instalada. De acordo com a documentação do Cline, esse método limita o upload de imagens e o cache de prompts, e as respostas podem não ser transmitidas em fluxo por token. Como o limite da franquia é compartilhado com o chat e o Claude Code, consulte limites do Claude Pro para entender esse mecanismo.

Ao usar uma chave de API, o acesso via Kunavo funciona com capacidade compartilhada e não há cota dedicada nem SLA contratual. Equipes que precisam de garantia devem contratar diretamente com a Anthropic. Para pessoas ou equipes pequenas que usam o Cline, o pagamento conforme o uso, que permite separar Plan e Act com uma única chave, é adequado.

Diferenças em relação ao uso do Roo Code

O Roo Code é uma extensão derivada do Cline e aceita diretamente a configuração OpenAI Compatible (Base URL, chave e modelo). A diferença está na estrutura dos modos: em vez de Plan / Act, há modos como Architect, Code, Ask e Debug, e você atribui um perfil de configuração de API a cada modo. A mesma ideia — Opus 5 no Architect e um modelo mais barato no Code — pode ser usada. As instruções estão na documentação de configuração do Roo Code e em Roo Code + Claude API (em inglês).

Para uma explicação mais detalhada em inglês, consulte o guia Cline + Claude API; para comparar com agentes de terminal, consulte Comparação entre Cline e Claude Code e Como usar o Claude Code; para os preços unitários de todos os modelos, consulte a página de preços.

Perguntas frequentes