O Roo Code é um poderoso assistente de codificação IA de código aberto que traz capacidades de desenvolvimento autônomo diretamente para o seu editor VSCode. Com mais de 1,3 milhão de instalações e uma comunidade próspera de desenvolvedores, o Roo Code se destaca por sua flexibilidade, suporte a múltiplos modelos e modos específicos de função que mantêm os agentes de IA focados e produtivos.
Neste guia, mostraremos como integrar a API de LLM do Novita AI com o Roo Code, dando a você acesso a modelos de ponta como o Kimi da Moonshot AI e o DeepSeek a preços competitivos — tudo no ambiente VSCode que você já conhece.
Por que Roo Code + Novita AI?
Roo Code: Sua Equipe de Desenvolvimento IA no VSCode
O Roo Code vai além do preenchimento automático simples. É um assistente de codificação agentivo que pode:
- Gerar código a partir de descrições em linguagem natural
- Refatorar e depurar bases de código existentes em vários arquivos
- Escrever documentação e responder perguntas sobre o seu código
- Executar comandos e rodar testes (com a sua aprovação)
- Adaptar-se ao seu fluxo de trabalho com Modos especializados (Arquiteto, Código, Depuração, Perguntar, Teste)
Ao contrário de ferramentas proprietárias como Cursor ou Windsurf, o Roo Code é:
✅ Totalmente de código aberto (licença Apache 2.0)
✅ Agnóstico a modelos (funciona com mais de 10 provedores, incluindo OpenAI, Anthropic, Google e Novita AI)
✅ Focado em privacidade (o seu código nunca sai da sua máquina, a menos que você o envie para uma API externa)
✅ Orientado pela comunidade (mais de 22,5k estrelas no GitHub, comunidade ativa no Discord)
Novita AI: Acesso a LLM com Custo-Benefício
O Novita AI oferece acesso amigável para desenvolvedores a modelos de linguagem de última geração com:
- Preços competitivos com taxas de pagamento por uso transparentes
- Ampla seleção de modelos (mais de 100 modelos, incluindo DeepSeek, Moonshot AI, Qwen e outros)
- API compatível com OpenAI (substituição direta para código existente)
- Alta confiabilidade com serviço de baixa latência
Pré-requisitos
Antes de começar, certifique-se de que você tem:
VSCode Instalado
Baixe a versão mais recente do Visual Studio Code no site oficial.
Conta e Chave de API do Novita AI
- Acesse o Novita AI e crie uma conta gratuita.
- Acesse a página de Gerenciamento de Chaves.
- Gere uma nova chave de API e copie-a (você precisará dela no Passo 2).
Crie sua Conta e Obtenha a Chave de API
Passos de Integração
Passo 1: Instalar a Extensão do Roo Code
- Abra o VSCode e acesse o painel de Extensões.
- Pesquise por “Roo Code” na marketplace.
- Clique em Instalar na extensão da Roo Veterinary Inc (ID:
RooVeterinaryInc.roo-cline). - Após a instalação, o ícone do Roo Code (um canguru) aparecerá na barra lateral do seu VSCode.
Passo 2: Configurar Provedor Terceiro (Novita AI)
Assim que a extensão estiver instalada, você precisará conectá-la à API do Novita AI:
- Clique no ícone do Roo Code na barra lateral para abrir o painel.
- Na tela de configuração, você verá duas opções:
- Roo Code Router (requer uma conta do Roo Code)
- Provedor Terceiro (use suas próprias chaves de API)
- Selecione Provedor Terceiro.
- Preencha os campos de configuração:
- Provedor de API: Escolha Compatível com OpenAI
- URL Base:
https://api.novita.ai/openai - Chave de API: Cole a sua chave de API do Novita AI (do Passo 2 dos Pré-requisitos)
- Modelo: Insira o nome do modelo desejado (ex:
moonshotai/kimi-k2.5)
- 🎉Nota: Você pode encontrar a lista completa de modelos disponíveis na página de Modelos do Novita AI.
Passo 3: Testar a Integração
Vamos verificar se o Roo Code consegue se comunicar com o Novita AI:
- Abra um projeto existente ou crie um novo arquivo no VSCode.
- Abra o painel do Roo Code (clique no ícone do canguru).
- Digite uma solicitação simples na interface de chat
- Aguarde a resposta da IA. Você verá:
- Um indicador “Pensando” (solicitação de API em andamento)
- Uma resposta do modelo (ex: “Olá! Estou no modo Arquiteto, pronto para ajudá-lo a planejar…”)
Entendendo os Modos do Roo Code
Um dos recursos mais poderosos do Roo Code é o seu sistema de Modos. Os Modos mantêm a IA focada em tarefas específicas e limitam o acesso a ferramentas a capacidades relevantes — reduzindo alucinações e evitando alterações indesejadas.
Modos Disponíveis
| Modo | Finalidade | Quando Usar |
| Arquiteto | Planejamento e design (sem alterações de código) | Ao iniciar uma nova funcionalidade, projetar arquitetura de sistema, dividir tarefas complexas |
| Código | Implementação e refatoração | Ao escrever novo código, refatorar arquivos existentes, fazer edições em vários arquivos |
| Perguntar | Perguntas e respostas e explicações (somente leitura) | Ao entender como o código funciona, obter respostas rápidas, gerar documentação |
| Depuração | Diagnóstico e correções | Ao rastrear erros, adicionar logs, isolar causas raiz |
| Orquestrador | Coordenar tarefas em vários modos | Quando o trabalho abrange várias etapas ou funções — por exemplo: primeiro planejar, depois implementar, depois depurar; lidar com solicitações grandes/complexas; dividir uma funcionalidade grande em subtarefas paralelas; ou quando você quer que o Roo gerencie as transferências entre Arquiteto / Código / Depuração automaticamente |
Solução de Problemas
Erro: “Chave de API inválida”
Solução:
- Verifique novamente se você copiou a chave de API corretamente do Novita AI.
- Certifique-se de que não há espaços extras antes/depois da chave.
- Verifique se a chave não expirou (gere uma nova se necessário).
O Roo Code está lento ou não responde
Solução:
- Verifique a sua conexão com a internet.
- Reduza o número de arquivos no contexto (use
.rooignorepara excluir diretórios grandes).
Conclusão
Você integrou com sucesso o Novita AI com o Roo Code no VSCode! Essa combinação poderosa oferece acesso flexível a modelos de IA, desenvolvimento com custo-benefício e controle total de privacidade — tudo sem bloqueio de fornecedor.
Pronto para começar a construir? Experimente pedir ao Roo Code para refatorar uma função complexa, gerar testes unitários ou depurar um erro complicado. Para mais tutoriais e suporte da comunidade, acesse a documentação do Roo Code e participe da comunidade no Discord.
Boa codificação! 🦘
Novita AI é uma plataforma de nuvem de IA que oferece aos desenvolvedores uma maneira fácil de implantar modelos de IA usando nossa API simples, além de fornecer nuvem de GPU acessível e confiável para construir e escalar.
Perguntas Frequentes
O que é o Roo Code?
O Roo Code é um assistente de codificação IA de código aberto para VSCode que traz capacidades de desenvolvimento autônomo para o seu editor. Ele pode gerar código, refatorar em vários arquivos, escrever documentação, depurar problemas e executar comandos — tudo por meio de interação em linguagem natural. Ao contrário de ferramentas de preenchimento automático, o Roo Code atua como um assistente agentivo com modos específicos de função (Arquiteto, Código, Depuração, Perguntar, Teste) que mantêm a IA focada em tarefas específicas.
O Roo Code é gratuito?
Sim, o próprio Roo Code é gratuito e de código aberto. Você pode usá-lo com:
- Suas próprias chaves de API de provedores como o Novita AI (pagamento por uso)
- Roo Code Router (serviço do Roo Code)
- Ollama para modelos locais (gratuito, roda na sua máquina)
O Roo Code é melhor que o Cursor?
O Roo Code e o Cursor servem a propósitos semelhantes, mas têm pontos fortes diferentes. O Roo Code é totalmente de código aberto e agnóstico a modelos, o que significa que você pode usar qualquer provedor de IA (OpenAI, Anthropic, Novita AI, etc.) e não fica preso a um único fornecedor. O Cursor oferece uma experiência mais polida e integrada, mas requer sua assinatura e limita suas opções de modelo. Se flexibilidade, controle de custos e valores de código aberto são importantes para você, o Roo Code é a melhor escolha.
