Tutorial do Kilo Code: configuração, créditos grátis e migração do Roo
O agente de programação com IA que herdou a comunidade do Roo Code: instale no VS Code, resgate 20 US$ em créditos bônus, conecte o DeepSeek com a sua própria chave e migre antes que a sua configuração do Roo desligue de vez.
Resumo rápido
- O Roo Code anunciou o encerramento em 21 de abril de 2026 e sua extensão do VS Code saiu do ar em 15 de maio — o Kilo Code, fork do Roo, é o caminho oficial de migração para as 3 milhões de instalações.
- A extensão é open source e grátis com a sua própria chave de API (BYOK); contas novas ganham 20 US$ em créditos bônus na primeira recarga, além de um trial corporativo de 14 dias sem cartão.
- O DeepSeek conecta direto: Settings → Providers → adicione sua chave de API do DeepSeek com https://api.deepseek.com como URL base e escolha deepseek-flash ou deepseek-v4-pro.
- A migração é semiautomática: renomeie os arquivos de configuração do Roo, deixe o assistente de migração convertê-los, escreva um kilo.jsonc mínimo — e autentique de novo cada chave de API, porque as chaves não migram.
Just Signed Up? Your first 14 minutes with Kilo Code
Vídeo de demonstração:Kilo (official)14:02
How to Migrate from Roo to Kilo
Vídeo de migração:Kilo (official)2:07
A demonstração foi gravada em junho de 2025 com a interface anterior à reconstrução baseada no OpenCode (GA de 2 de abril de 2026) — os menus mudaram de lugar, mas o fluxo é o mesmo. O vídeo de migração mostra a interface atual.
As capturas são quadros dos vídeos oficiais do Kilo no YouTube, usados com atribuição e com link de volta ao momento original em cada passo. O texto deste guia é nosso.
Configuração e migração do Kilo Code, passo a passo
1 · Conheça o Kilo Code (e por que usuários do Roo estão migrando)
- 1
Entenda o contexto: o Roo Code está encerrando
Em 21 de abril de 2026, a equipe do Roo Code anunciou o fim da extensão para se dedicar integralmente ao Roomote; a extensão do VS Code saiu do ar em 15 de maio e o repositório no GitHub virou um arquivo somente leitura. O Kilo Code — um fork do Roo — publicou a despedida oficial e virou o porto de destino das cerca de 3 milhões de instalações do Roo.
O anúncio do encerramento, com um mantenedor do Kilo já respondendo nos comentáriosVer aos 0:04 - 2
Conheça os cinco modos de interação
O Kilo Code traz cinco modos: o Code escreve e implementa, o Architect planeja antes de mexer no código, o Ask explica, o Debug caça erros e o Orchestrator divide uma tarefa enorme em subtarefas. Você também pode criar modos próprios — os modos personalizados do Roo são mapeados para cá na migração.
O seletor de modo fica logo acima da caixa de prompt no painel do Kilo CodeVer aos 0:22 - 3
Veja o que um único prompt produz
Na demonstração oficial, um único prompt detalhado — propósito do app, estrutura de dados, ordenação e busca, design da interface — gerou um organizador de notas funcional em um único arquivo HTML, que o Kilo abriu no navegador. Toda a geração custou cerca de 3 centavos de crédito de API.
O organizador de notas pronto: cartões, tags, busca e ordenação a partir de um promptVer aos 5:06 - 4
Deixe o modo Architect fazer as perguntas
Quando você não sabe o que especificar, o modo Architect entrevista você: para um jogo de xadrez, ele perguntou sobre a profundidade das regras, jogo contra pessoa ou contra a IA e a força da IA, com opções clicáveis. O plano final — com diagrama de arquitetura — vai para um arquivo markdown antes de o modo Code construir.
O modo Architect transforma ideias vagas em escolhas concretas e respondíveisVer aos 8:12
2 · Instale a extensão e resgate 20 US$ em créditos
- 5
Instale a extensão do Kilo Code
No VS Code, busque "Kilo Code" no marketplace ou execute o comando mostrado aqui: code --install-extension kilocode.Kilo-Code. A extensão é open source e existe para VS Code, JetBrains e um CLI independente.
A instalação de uma linha no terminal, do vídeo oficial de migraçãoVer aos 0:10 - 6
Resgate seus créditos de cadastro
Logo após o cadastro você recebe um perfil de API hospedado do Kilo Code com créditos grátis — a gravação abaixo mostra o aviso "$20 for free", e o kilo.ai/pricing segue anunciando 20 US$ em créditos bônus na primeira recarga mais um trial corporativo de 14 dias sem cartão. O BYOK continua grátis para sempre.
Settings → Providers: o perfil padrão do Kilo Code e seus 20 US$ de crédito de boas-vindasVer aos 1:18
3 · Conecte o DeepSeek com a sua própria chave
- 7
Adicione um perfil de provedor para a sua chave
Abra Settings → Providers e clique em + para criar um New Configuration Profile. Dê um nome — "DeepSeek" ou "OpenRouter" — e você terá um segundo perfil para alternar no painel principal sem mexer no embutido.
Criação de um segundo perfil de configuração chamado OpenRouterVer aos 1:46 - 8
Cole a sua chave de API e escolha um modelo
Escolha o tipo de provedor, cole a chave de API e selecione um modelo. Para o DeepSeek direto, siga kilo.ai/docs/ai-providers/deepseek: defina a URL base como https://api.deepseek.com e escolha deepseek-flash para o dia a dia ou deepseek-v4-pro para raciocínios pesados. As chaves ficam guardadas no SecretStorage do VS Code.
Tipo de provedor, chave de API e modelo — os mesmos três campos que o guia oficial do DeepSeek para o Kilo preencheVer aos 1:52
4 · Migre do Roo Code
- 9
Renomeie os arquivos do Roo (em cada repositório)
O assistente de migração não lê arquivos com prefixo Roo, então transfira antes com os comandos do guia de migração do Kilo: .roorules → AGENTS.md, .roo/rules/* → .kilo/rules/, .roomodes → .kilocodemodes, .roo/mcp.json → .kilocode/mcp.json, .rooignore → .kilocodeignore. Faça também backup da pasta globalStorage do Roo antes de começar.
O script oficial de portabilidade: cinco comandos de cópia e renomeação por repositórioVer aos 0:34 - 10
Escreva um kilo.jsonc mínimo
O kilo.jsonc substitui os grupos de ferramentas do Roo por permissões explícitas — tudo é allow, ask ou deny, com padrões de caminho opcionais. Copie o exemplo mínimo do guia de migração, defina o seu modelo e liste seus arquivos de regras em instructions.
kilo.jsonc: escolha do modelo e permissões de leitura, escrita e bash por açãoVer aos 1:10 - 11
Valide com kilo config check
Rode kilo config check no terminal para confirmar que a configuração migrada é interpretada e que todos os arquivos referenciados existem. Na primeira abertura, o assistente de migração da extensão também converte os arquivos legados automaticamente — os .kilocodemodes viram arquivos markdown de agente de verdade, e o .kilo/rules é preservado como fallback.
Um comando confirma que a configuração migrada é válidaVer aos 1:15 - 12
Verifique e depois desative o Roo (não desinstale)
Abra um repositório, escolha o agente Code e peça para listar os agentes e regras personalizados carregados — a resposta deve citar seus agentes, regras, modelo e permissões migrados. Conferido tudo, desative o Roo no painel de extensões e mantenha-o por cerca de uma semana como fallback antes de remover.
A resposta da verificação lista cada agente, regra, modelo e permissão que o Kilo carregouVer aos 1:36
Kilo Code vs Roo Code de relance
| Aspecto | Kilo Code | Roo Code |
|---|---|---|
| Status | Ativo — o caminho oficial de migração para usuários do Roo | Encerramento anunciado em 21 de abril de 2026; extensão offline desde 15 de maio de 2026 |
| Linhagem | Fork do Roo Code (que por sua vez veio do Cline), continuado por uma empresa independente | Fork do Cline; a equipe original seguiu para o Roomote |
| Extensão atual | Reconstruída sobre o servidor OpenCode — GA em 2 de abril de 2026 — além de versões para JetBrains, CLI e nuvem | Linha legada v5.x congelada no encerramento; repositório do GitHub arquivado como somente leitura |
| Caminho de migração | Renomear + assistente, permissões em kilo.jsonc, reautenticação de provedores obrigatória | Nenhum — os arquivos ficam nos caminhos .roo; dúvidas de cobrança para billing@roocode.com |