Documentação

Roo Code

O provedor OpenAI Compatible do Roo Code usa três campos e um bloco de recursos do modelo. Esse bloco não é um detalhe opcional: é com base nele que o Roo Code calcula o orçamento de contexto.

Escolha o provedor OpenAI Compatible, cole a URL base e a chave e defina a janela de contexto e a saída máxima do modelo para que o orçamento do próprio Roo Code seja correto.

Painel de configurações do Roo Code

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on

O Roo Code usa chamadas de ferramentas nativas sem fallback, então o modelo escolhido precisa oferecer suporte a chamadas de ferramentas compatíveis com OpenAI. Todos os ids da tabela abaixo oferecem esse suporte; um modelo apenas de texto ou de mídia configurado aqui falhará na primeira ferramenta que o agente tentar usar, e não durante a configuração.

Preencha Context Window e Max Output Tokens em vez de manter os valores padrão. O Roo Code decide quando resumir a conversa com base nesses números. Uma janela de contexto definida muito baixa faz com que ele trunque um histórico que não precisava ser truncado, enquanto um valor muito alto causa erros 400 no provedor, em vez de um resumo bem-sucedido.

Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Roo Code.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
Abra o painel de configurações do Roo Code e defina API Provider como OpenAI Compatible.
Informe a URL base https://api.kunavo.com/v1 e sua chave. O sufixo /v1 deve fazer parte da URL base — o Roo Code acrescenta apenas o caminho da rota.
Selecione ou digite o id do modelo, abra Model Configuration e defina a janela de contexto, o número máximo de tokens de saída, o suporte a imagens e os preços de entrada e saída da tabela abaixo.
Envie uma mensagem no modo Code. Os preços informados aqui são usados pelo próprio Roo Code no cálculo de custo por tarefa, então vale a pena acertá-los.

Verificado em a página do provedor OpenAI Compatible do Roo Code em 6 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Esta é a versão resumida. O guia completo — escolha do modelo, custo de uma sessão real e modos de falha — está em o passo a passo do Roo Code + Claude.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Roo Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

ID do modelo	Entrada / saída da Kunavo	Onde se encaixa em Roo Code
`claude-sonnet-5`	$1.40 / $7.00	modo Code — o padrão, para o qual o cálculo de custo foi calibrado
`claude-opus-5`	$3.50 / $17.50	modo Architect, em que o custo de um plano errado supera o dos tokens
`claude-haiku-4-5`	$0.70 / $3.50	modo Ask e leituras repetidas de arquivos
`gpt-5-6-terra`	$0.70 / $4.20	varreduras de contexto longo em um repositório grande

A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

Perguntas frequentes

Como configuro o Roo Code para usar um endpoint personalizado compatível com OpenAI?

No painel de configurações do Roo Code, defina API Provider como "OpenAI Compatible". Em seguida, informe a URL base e a chave de API do endpoint e escolha um modelo. A URL base deve ser a raiz /v1 do serviço, pois o Roo Code acrescenta apenas o caminho da rota. A própria documentação do Roo Code destaca que o campo Base URL é essencial: é ele que determina para onde cada solicitação é enviada.

Quais modelos funcionam com o Roo Code por meio de um endpoint personalizado?

Qualquer modelo disponibilizado pelo endpoint que ofereça suporte a chamadas de ferramentas nativas compatíveis com OpenAI. O Roo Code usa exclusivamente chamadas de ferramentas nativas e não tem modo de fallback, então um modelo sem suporte a ferramentas se conectará, mas falhará assim que o agente tentar ler ou gravar um arquivo. Todos os modelos de texto Claude e GPT são compatíveis; modelos de imagem, vídeo e áudio não são.

O que devo informar em Context Window e Max Output Tokens do Roo Code?

Os limites reais do modelo selecionado, não os valores padrão. O Roo Code usa esses dois números para decidir quando resumir a conversa. Um valor abaixo do limite real de contexto do modelo faz com que ele descarte histórico sem necessidade; um valor acima causa erros 400 no provedor, em vez de um resumo bem-sucedido. Os valores de cada modelo estão no catálogo de modelos do endpoint.

Por que o Roo Code informa o custo errado para uma tarefa?

Porque os campos Input Price e Output Price em Model Configuration são preenchidos manualmente e têm como padrão zero ou as tarifas de outro provedor. O Roo Code calcula o custo por tarefa inteiramente com base nesses dois campos — ele não consulta os preços do endpoint —, então o valor só é preciso na medida em que os dados informados estejam corretos. Copie as tarifas do catálogo do próprio provedor.