Roo Code com Claude e GPT: configurar uma API própria

O Roo Code é um agente de programação com IA, de código aberto, para o VS Code. Ele trabalha em modos, como Code, Architect e Ask, lê e edita arquivos do seu projeto e executa comandos com a sua aprovação. O Roo Code não inclui um modelo: você conecta um provedor de API, e cada passo de uma tarefa é uma requisição cobrada por esse provedor.

A APIVAI oferece uma única chave para modelos Claude e GPT, cobrada por token abaixo dos preços oficiais, a partir de um saldo que você mesmo recarrega. A mesma chave funciona no formato da OpenAI e no da Anthropic, então serve para as duas opções de provedor relevantes no Roo Code, e você pode dar um modelo diferente a cada modo sem gerenciar várias contas.

Escolha OpenAI Compatible se quiser modelos GPT ou um ID do Claude que a lista interna do Roo Code ainda não mostra. Escolha Anthropic se você usa só o Claude: o provedor Anthropic do Roo Code adiciona marcações cache_control ao prompt de sistema e às mensagens recentes, então o contexto repetido pode ser lido do cache por $0.10 por milhão de tokens no Claude Sonnet 4.6, em vez do preço cheio de entrada. A gravação em cache custa $1.31 por milhão. Com perfis (veja abaixo) você mantém os dois e alterna por modo.

1. Cadastre-se em apivai.com com seu e-mail.
2. Recarregue a partir de $10 com cartão, cripto, Alipay ou WeChat Pay. Não há teste grátis nem assinatura.
3. No Dashboard, crie uma chave e copie. Defina um limite de orçamento se quiser um teto rígido para o que o Roo Code pode gastar.

1. No VS Code, abra o painel do Roo Code, clique no ícone de engrenagem e abra Providers.
2. Em API Provider, escolha OpenAI Compatible.
3. Preencha os campos da tabela e salve.

A Base URL termina em /v1 uma única vez; o Roo Code acrescenta /chat/completions. As configurações do modelo também têm Context Window, Image Support e Computer Use; deixe nos valores padrão, a menos que tenha um motivo para mudar. Os campos de preço só alteram a estimativa de custo exibida pelo Roo Code; as cobranças reais estão no Dashboard.

O Roo Code usa exclusivamente chamadas de ferramentas nativas, então o modelo precisa suportar function calling. A APIVAI repassa as chamadas de ferramentas em /v1/chat/completions, e os modelos Claude e GPT recomendados abaixo dão suporte a elas.

Confira quais IDs a sua chave pode usar:

Modelos são adicionados e retirados com o tempo, então copie os IDs dessa lista ou da página de preços.

1. Em Providers, clique no botão + ao lado do seletor de perfis e dê um nome ao novo perfil, por exemplo "APIVAI Claude".
2. Em API Provider, escolha Anthropic.
3. Cole sua chave da APIVAI em Anthropic API Key.
4. Marque Use custom base URL e informe https://api.apivai.com.
5. Escolha um modelo Claude no menu Model.

Não adicione /v1: o Roo Code passa esse endereço ao SDK da Anthropic, que acrescenta /v1/messages sozinho, então https://api.apivai.com/v1 viraria /v1/v1/messages e retornaria 404. Veja a página do proxy da API do Claude para o formato da Anthropic.

O Roo Code lembra qual perfil de configuração você usou por último em cada modo, e nas configurações dos modos dá para associar um perfil de forma explícita. Uma divisão sensata: um perfil com Claude Opus 5.5 para o Architect (planejamento), Claude Sonnet 4.6 para o Code e um perfil barato com Claude Haiku 4.5 ou GPT-6 Luna para o Ask. Todos os perfis podem usar a mesma chave da APIVAI.

Preços por 1M de tokens de entrada / saída em 2026-10-07:

Modelos GPT precisam do provedor OpenAI Compatible. Se uma tarefa fica andando em círculos no Sonnet, troque o perfil dessa tarefa para o Opus em vez de tornar o Opus o seu padrão.

Cada passo de uma tarefa do Roo Code reenvia a conversa e os arquivos lidos até ali, então os tokens de entrada são a maior parte do gasto. Dois exemplos calculados:

• Uma tarefa no modo Code com o Claude Sonnet 4.6: cerca de 25 requisições de 35.000 tokens de entrada e 2.000 de saída cada. Custo: $1.17 com a APIVAI, $3.38 no preço oficial.
• Um mês de trabalho com três tarefas dessas por dia durante 22 dias (1.650 requisições): $77.29 com a APIVAI, $223 no preço oficial. Passar 20 perguntas diárias do modo Ask para o Claude Haiku 4.5 (8.000 tokens de entrada e 800 de saída cada, 440 por mês) acrescenta só $1.84.

Esses valores não consideram o cache de prompts, que barateia o contexto repetido quando você usa o provedor Anthropic. Tokens de raciocínio contam como tokens de saída. Os seus números reais por requisição estão no Dashboard. Para uma comparação mais ampla, leia os preços da API do Claude em 2026.

• 401 / chave inválida: a chave está incompleta, foi excluída ou passou do limite de orçamento; confira o Dashboard. No provedor Anthropic, verifique se Use custom base URL está marcado, senão a chave vai direto para a Anthropic.
• 404 Not Found: /v1 errado. OpenAI Compatible: https://api.apivai.com/v1, sem /chat/completions no final. Anthropic: https://api.apivai.com, sem /v1.
• Modelo não encontrado: use o ID exato, como claude-sonnet-4-6, e não um nome de exibição. Compare com GET /v1/models.
• Erros de chamada de ferramentas: escolha um modelo com suporte a function calling, como os da tabela acima.
• Respostas vazias ou truncadas: o raciocínio vem ativado por padrão e consome tokens de saída. Defina Max Output Tokens como 8192 (no mínimo 4096).
• 429 Too Many Requests: o limite padrão é de 60 requisições por minuto por chave. Espere um pouco ou peça ao suporte para aumentá-lo.

Há mais informações sobre os formatos de requisição na documentação e na página de API compatível com OpenAI.

Sim. Uma chave da APIVAI funciona com todos os modelos. Crie um perfil por modelo ou altere o campo Model em um perfil OpenAI Compatible.

Use OpenAI Compatible para os modelos GPT e para qualquer ID que não esteja na lista do Roo Code. Use Anthropic para trabalhar só com o Claude, em que o Roo Code solicita cache de prompts; a URL base vai sem /v1.

Sim. O Roo Code vincula os perfis de configuração aos modos, então o Architect pode usar o Opus enquanto o Code usa o Sonnet, tudo com a mesma chave.

Não. O conteúdo das requisições e respostas não é registrado; só ficam guardados dados de uso como modelo, tokens e custo, para a cobrança.

Quase igual. Veja o guia de configuração do Cline; os nomes dos campos e as URLs são os mesmos.

Crie uma conta, recarregue a partir de $10 e cole sua chave no Roo Code.