Claude no Roo Code. Um cartão central de planejamento que se ramifica em vários cartões menores de trabalho com código, cada um em sua própria prateleira organizada, representando subtarefas orquestradas.

Roo Code ilimitado com a API do Claude

O Roo Code é uma poderosa extensão de programação com agentes para o VS Code que separa responsabilidades em modos operacionais distintos — Architect, Code, Debug e Ask —, cada um configurável com seu próprio modelo, temperatura e configurações de provedor. Seu recurso Orchestrator cria subtarefas que multiplicam drasticamente o consumo de API. Conectar o Roo Code a um gateway ilimitado do Claude por um preço fixo significa que você pode atribuir Opus ao modo Architect e Sonnet ao modo Code, sem nunca se preocupar com o custo acumulado dos fluxos de trabalho orquestrados.

Como o Roo Code multiplica o consumo de API

A arquitetura do Roo Code é fundamentalmente diferente da de editores de IA simples baseados em chat. Cada modo operacional (Architect, Code, Debug, Ask) mantém seu próprio contexto e pode receber um modelo diferente. Quando o modo Orchestrator está ativo, ele decompõe uma tarefa complexa em subtarefas e delega cada uma ao modo apropriado — na prática, criando conversas paralelas que consomem seus próprios orçamentos de tokens de forma independente.

Uma única tarefa conduzida pelo Orchestrator, como 'refatorar o módulo de autenticação', pode criar uma subtarefa Architect para planejar a nova estrutura, três subtarefas Code para implementar componentes diferentes e uma subtarefa Debug para verificar o resultado. Cada subtarefa carrega seu próprio prompt de sistema, definições de ferramentas e histórico de conversa. O consumo total de tokens não é aditivo — é multiplicativo, porque cada subtarefa começa do zero com a inserção do contexto completo.

Isso é agravado pelo uso exclusivo de chamadas nativas de ferramentas pelo Roo Code. Ao contrário de alguns agentes que recorrem à invocação de ferramentas baseada em XML quando as chamadas nativas falham, o Roo Code exige suporte nativo a chamadas de funções na API. Cada invocação de ferramenta (leitura de arquivo, escrita, comando de terminal) é um par estruturado de chamada de ferramenta e resposta, adicionando sobrecarga a cada interação. A combinação de modelos por modo, subtarefas do Orchestrator e chamadas nativas de ferramentas faz do Roo Code um dos maiores consumidores de API no ecossistema do VS Code.

Como configurar perfis de configuração de API

O Roo Code organiza as configurações de provedor em perfis de configuração de API. Cada perfil reúne um tipo de provedor, URL base, chave de API, identificador de modelo e parâmetros opcionais, como temperatura e orçamento de raciocínio. Abra o painel de configurações do Roo Code no VS Code e acesse Configuração de API. Clique em Criar novo perfil para começar.

Para a configuração com o provedor Anthropic, defina Provedor como Anthropic, insira https://unlimited.aiprimetech.io como URL base (host raiz, sem /v1 — o SDK da Anthropic acrescenta o caminho) e cole sua chave AI Prime Tech Unlimited. Selecione seu modelo — claude-sonnet-4-5 para um perfil equilibrado ou claude-opus-4-6 para máxima capacidade de raciocínio. Defina a temperatura entre 0 e 1 conforme sua preferência por determinismo ou criatividade.

Crie vários perfis para cenários diferentes: um perfil rápido usando Haiku para perguntas rápidas, um perfil padrão usando Sonnet para programação diária e um perfil avançado usando Opus para decisões de arquitetura. Dê nomes claros a eles (por exemplo, 'Unlimited-Sonnet', 'Unlimited-Opus'), pois você atribuirá esses perfis a modos específicos na próxima etapa.

Estratégia de atribuição de modelos por modo

O grande diferencial do Roo Code para usuários de planos ilimitados é a atribuição de modelos por modo. Nas configurações, cada modo (Architect, Code, Debug, Ask) tem um menu suspenso para selecionar o perfil de configuração de API que usa. A estratégia ideal em um plano ilimitado é agressiva: atribua Opus aos modos Architect e Debug, nos quais o raciocínio profundo é mais importante, e Sonnet aos modos Code e Ask, nos quais velocidade e volume predominam.

O modo Architect planeja mudanças complexas antes da execução. Ele se beneficia enormemente da capacidade superior do Opus de raciocinar sobre implicações em todo o sistema, cadeias de dependências e padrões de arquitetura. O modo Debug também se beneficia do Opus, porque diagnosticar bugs muitas vezes exige manter várias hipóteses em mente simultaneamente e raciocinar sobre os caminhos de execução.

O modo Code cuida das edições efetivas dos arquivos e é acionado com mais frequência. O Sonnet é rápido o suficiente para manter o ciclo de feedback ágil e, ao mesmo tempo, produzir código de alta qualidade. O modo Ask serve para perguntas rápidas e explicações — o Sonnet lida com elas de forma eficiente. Em um plano ilimitado, não há custo adicional por usar Opus em todos os modos, mas a diferença de latência importa para fluxos de trabalho interativos. Essa divisão oferece o melhor dos dois mundos: raciocínio profundo onde ele faz diferença e respostas rápidas onde a velocidade importa.

Orchestrator e subtarefas Boomerang

O modo Orchestrator (às vezes chamado de Boomerang) é o mecanismo de decomposição de tarefas do Roo Code. Quando você descreve uma tarefa complexa no modo Orchestrator, ele divide o trabalho em subtarefas distintas e delega cada uma ao modo apropriado. Os resultados das subtarefas voltam como um 'bumerangue' ao Orchestrator, que os sintetiza e decide a próxima etapa.

Cada subtarefa é executada em seu próprio contexto de conversa, com seu próprio orçamento de tokens. Isso significa que uma única tarefa do Orchestrator pode criar cinco conversas separadas com Claude, cada uma consumindo dezenas de milhares de tokens de forma independente. Na cobrança por token, uma sessão do Orchestrator para um recurso de complexidade média pode facilmente custar vários dólares. Em um plano ilimitado, ela custa exatamente o mesmo que uma única mensagem de chat — nada a mais.

Para usar o Orchestrator de forma eficaz com acesso ilimitado, não o restrinja. Deixe que ele crie quantas subtarefas o problema exigir. Ative o modo automático — no qual o Orchestrator decide a decomposição sem pedir confirmação a cada etapa. Isso produz resultados melhores porque o Orchestrator pode iterar livremente, replanejando e reexecutando subtarefas à medida que descobre novas informações durante o processo.

Modos personalizados com .roomodes

O Roo Code oferece suporte a modos personalizados no nível do projeto, definidos em um arquivo .roomodes na raiz do projeto. Cada modo personalizado especifica um nome, uma descrição, acréscimos ao prompt de sistema, ferramentas permitidas e qual perfil de configuração da API usar. Isso permite criar agentes especializados para seu projeto específico — um modo 'Migração de banco de dados' que só tem acesso a arquivos SQL e ferramentas de migração, ou um modo 'Documentação' voltado para Markdown, com um prompt otimizado para escrita.

Crie um arquivo .roomodes JSON na raiz do seu projeto. Cada entrada de modo inclui roleDefinition (o prompt de sistema), allowedTools (uma lista de nomes de ferramentas que o modo pode usar) e apiConfiguration (qual perfil usar). Os modos personalizados aparecem junto aos modos integrados no seletor de modos.

No plano ilimitado, os modos personalizados permitem padrões criativos de fluxo de trabalho. Crie um modo 'Pesquisa' que use Opus para analisar em profundidade bases de código desconhecidas. Crie um modo 'Correção rápida' que use Haiku para alterações triviais de uma linha. Crie um modo 'Revisão' que leia código e forneça comentários sem fazer alterações. O modelo de preço fixo permite experimentar livremente configurações de modos sem se preocupar com o custo de errar.

Requisitos para chamadas nativas de ferramentas

O Roo Code usa exclusivamente chamadas nativas de funções — ele não recorre à invocação de ferramentas baseada em XML como alguns outros agentes. Isso significa que o provedor de API precisa oferecer suporte correto ao parâmetro tools na Messages API, incluindo blocos tool_use e tool_result em múltiplos turnos. O gateway AI Prime Tech Unlimited oferece suporte completo a isso para todos os modelos Claude.

Se você encontrar erros em chamadas de ferramentas, eles quase sempre são causados por um de dois problemas: o uso de uma versão mais antiga do modelo, com suporte menos robusto a chamadas de ferramentas, ou uma configuração incorreta da URL base, que encaminha as solicitações ao endpoint errado. Verifique se o identificador do modelo no seu perfil corresponde a um modelo Claude atual e se a URL base está correta para o tipo de provedor escolhido.

O repertório de ferramentas do Roo Code inclui operações de arquivos (ler, escrever, listar), comandos de terminal (executar, ler a saída), ações de navegador (quando habilitadas) e ferramentas MCP (quando configuradas). Cada chamada de ferramenta adiciona dados estruturados à conversa — normalmente 200-500 tokens por invocação de ferramenta, incluindo o resultado. Em uma tarefa complexa com dezenas de chamadas de ferramentas, esse volume se acumula significativamente.

Solução de problemas de configuração do Roo Code

O problema mais comum é a incompatibilidade entre modo e perfil: você criou perfis, mas esqueceu de atribuí-los aos modos. Verifique o menu suspenso de configuração da API de cada modo nas configurações — se ele indicar 'Padrão' e você não tiver definido um perfil padrão, as solicitações falharão. Atribua explicitamente um perfil a cada modo que pretende usar.

Se as subtarefas do Orchestrator falharem enquanto o uso direto dos modos funcionar, o problema geralmente é que os modos das subtarefas herdam o perfil do Orchestrator, a menos que sejam explicitamente configurados de outra forma. Certifique-se de que cada modo que possa ser chamado pelo Orchestrator tenha sua própria atribuição de perfil válida. Um padrão comum é definir o perfil padrão com sua configuração do Sonnet e substituir apenas os perfis de Architect e Debug por Opus.

Erros de tempo limite de conexão durante sessões longas do Orchestrator geralmente indicam que há subtarefas demais em execução simultânea, atingindo os limites de requisições. O gateway coloca as solicitações excedentes em uma fila e as retorna à medida que ficam disponíveis, mas o VS Code pode interpretar o atraso como um tempo limite excedido. Reduza a simultaneidade do Orchestrator nas configurações se isso ocorrer com frequência, ou simplesmente aguarde — o gateway acabará processando todas as solicitações dentro dos limites de uso justo.

# Roo Code -> Settings -> API Configuration -> Create New Profile
#
# Profile: Unlimited-Sonnet
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-sonnet-4-5
#
# Profile: Unlimited-Opus
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-opus-4-6
#
# Mode Assignment:
#   Architect -> Unlimited-Opus
#   Code      -> Unlimited-Sonnet
#   Debug     -> Unlimited-Opus
#   Ask       -> Unlimited-Sonnet

Perguntas frequentes

Qual é a vantagem de atribuir modelos por modo no plano ilimitado?

Você pode atribuir modelos caros como Opus a modos que exigem raciocínio intenso (Architect, Debug) sem se preocupar com o custo, enquanto mantém modelos mais rápidos nos modos usados com maior frequência (Code, Ask) para reduzir a latência. Na cobrança por token, essa estratégia é cara; no plano ilimitado, você pode otimizar a qualidade sem custo adicional.

Como o modo Orchestrator afeta o uso da API?

O Orchestrator decompõe tarefas em subtarefas, cada uma executada em sua própria conversa, com seu próprio orçamento de tokens. Uma única tarefa complexa pode gerar 5-10 conversas separadas com o Claude. Na cobrança por token, isso multiplica drasticamente o custo; no plano ilimitado, está incluído no preço fixo.

O Roo Code funciona com o endpoint compatível com OpenAI?

Sim. Crie um perfil com o provedor definido como Compatível com OpenAI, a URL base definida como https://unlimited.aiprimetech.io/v1, e insira o ID do modelo manualmente. No entanto, recomenda-se usar a integração com o provedor Anthropic para obter a melhor compatibilidade com chamadas de ferramentas.

O que são arquivos .roomodes e devo usá-los?

Um arquivo .roomodes na raiz do seu projeto define modos personalizados com ferramentas, prompts e atribuições de modelos específicos. No plano ilimitado, use-os livremente para criar agentes especializados para diferentes fluxos de trabalho — pesquisa, revisão, migração, documentação — sem se preocupar com o custo adicional de tokens de prompts de sistema detalhados.

Por que recebo erros em chamadas de ferramentas com o Roo Code?

O Roo Code exige chamadas nativas de funções, sem alternativa baseada em XML. Certifique-se de que o identificador do seu modelo corresponda a um modelo Claude atual (claude-sonnet-4-5 ou mais recente) e de que sua URL base esteja configurada corretamente para o tipo de provedor selecionado. Versões mais antigas dos modelos podem ter suporte menos robusto a chamadas de ferramentas.

Comece a usar o Claude em minutos

Obtenha uma chave de API — sem precisar de conta na Anthropic nem de lista de espera.

Obtenha sua chave de API

AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários.