Roo Code com a Claude API — configuração do provedor e um modelo por modo

Roo Code é um agente autônomo de programação de código aberto para VS Code — um fork da família Cline, distinguido por seu sistema de modos e roteamento de modelos por modo. Ele não inclui nenhum modelo próprio, portanto precisa de uma chave de API. Este guia mostra a configuração exata para executar o Claude no Roo Code usando uma chave sk-kn- por cerca de 30% abaixo do preço de tabela da Anthropic nos modelos principais, como usar perfis de configuração para gastar com modelos fortes apenas onde isso compensa, quanto custa uma sessão e uma análise honesta da troca em relação a chamar a Anthropic diretamente.

Por que o Roo Code precisa de uma chave de API

Cada etapa executada pelo Roo Code — ler um arquivo, escrever um diff, executar um comando, ler o resultado — é uma chamada ao modelo cobrada por token. Uma assinatura claude.ai Pro ou Max não cobre isso: os planos de chat e o acesso à API são produtos separados, e o Roo Code se comunica com a API. Como um loop agêntico reenvia o contexto crescente da tarefa a cada etapa, a tarifa por token é a maior alavanca sobre o custo da sessão — o que também vale para um gateway: pagamento conforme o uso a partir de uma recarga de $10, uma chave que também acessa GPT e um saldo que nunca expira.

Configuração — os três campos

Abra Settings → Providers e defina o provedor da 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 fazer uma recarga — ela é exibida uma única vez, portanto armazene-a imediatamente; the Claude API key doc explica a rotação e os limites de gastos. Se o Roo Code solicitar metadados do modelo, como janela de contexto ou limite de saída, use os valores da model page — uma janela de contexto subestimada faz com que ele trunque antes do necessário.

Teste com algo pequeno antes de permitir que ele edite o código. Um 401 aqui quase sempre é a chave; um 404 quase sempre é a URL base ou um slug de modelo inexistente — o Kunavo corresponde exatamente aos slugs e não cria aliases para nomes com sufixo de data, portanto claude-sonnet-4-5-20250929 retorna 404, enquanto claude-sonnet-4-6 é resolvido.

Modos e perfis de configuração — a alavanca de custo

O Roo Code vem com vários modos integrados — Code, Architect, Ask e Debug — além de modos personalizados que você mesmo define. O que importa para o custo é que o Roo Code armazena perfis de configuração de API nomeados e lembra qual perfil você usou por último em cada modo. Assim, o modelo se torna uma propriedade do modo, e não algo que você precisa lembrar de alterar:

# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.

Profile "strong"         model claude-opus-5        -> bind to Architect and Debug
Profile "code-default"   model claude-sonnet-5      -> bind to Code mode
Profile "ask-cheap"      model claude-haiku-4-5     -> bind to Ask mode

Isso funciona porque os modos têm perfis de tokens muito diferentes. Architect consiste em algumas rodadas intensivas de raciocínio, nas quais a qualidade do modelo determina se as próximas vinte etapas serão produtivas — uma pequena parcela do total de tokens, portanto um modelo forte custa pouco em termos absolutos. Code envolve muitas etapas mecânicas, cada uma reenviando o contexto, e é aí que a tarifa por token se acumula. Ask geralmente é de uma única rodada e não precisa de um modelo de ponta.

Os números do exemplo estão abaixo: três etapas de Architect no Opus 5 mais dezessete etapas de Code no Sonnet 5 totalizam cerca de $1,06, contra $0,87 na execução totalmente com Sonnet — aproximadamente 23% a mais por um planejamento materialmente melhor e muito mais barato do que executar tudo no Opus.

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

O Roo Code também oferece um provedor nativo Anthropic com um campo de URL base personalizado. Aponte-o para https://api.kunavo.com — somente a origem, sem /v1, porque esse cliente acrescenta /v1/messages por conta própria — para encaminhar pela Messages API nativa. Colar aqui a forma /v1 produz um 404 que parece indicar um modelo ausente.

O benefício dessa rota é o cache de prompts: cache_control passa sem tradução e as entradas armazenadas em cache são cobradas a 10% da tarifa de entrada (como funciona). 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. As duas rotas funcionam; OpenAI Compatible é mais simples para começar, e alternar entre elas exige apenas uma alteração nas configurações.

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 OpenAI Compatible: 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 o Roo Code defina ali é mantido. Na rota nativa, a solicitação é repassada como o Roo Code a enviou e nenhum ponto de interrupção é adicionado, então o que entra em cache depende dos pontos de interrupção que o Roo Code define.

Qual modelo Claude vincular a cada modo

Todos usam a mesma chave e o mesmo endpoint — somente o slug do modelo muda, portanto um perfil é uma alteração de uma palavra. As tarifas completas por modelo, comparadas à lista oficial da Anthropic, estão na lista de preços da API Anthropic Claude, e o catálogo atualizado está na página de preços.

Roo Code no Kunavo versus chamada direta à Anthropic

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

Essa linha sobre capacidade é a verdadeira contrapartida, exposta claramente. Se você precisa de uma cota garantida, de um SLA contratual ou de uma relação de compras com o fornecedor do modelo, use o acesso direto — é isso que a diferença de preço compra. Para um desenvolvedor individual ou uma equipe pequena executando o Roo Code, a vantagem geralmente fica do outro lado.

Quanto uma sessão do Roo Code 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),
    "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 Code-mode step: Roo 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 on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
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. Comece novas tarefas em vez de prolongar uma indefinidamente. O Roo Code reenvia toda a conversa a cada etapa, portanto uma tarefa longa fica quadraticamente mais cara. Uma tarefa nova começa com um contexto novo e pequeno — o hábito de maior impacto aqui.
2. Vincule um perfil por modo. Como explicado acima: isso transforma o roteamento de modelos em configuração, em vez de algo que você precisa lembrar durante a tarefa.
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 sua própria chave com limite de gastos. Crie uma chave separada em the dashboard e verifique o uso depois de uma semana real — essa é a única estimativa honesta do que isso custa para você.

Perguntas frequentes