Guia
6 min de leitura · Atualizado em 11/10/2026
Como instalar o Reveza no Mac, no Windows e no Linux
O Reveza AI instala com um comando só, no macOS, no Windows e no Linux, inclusive numa VPS sem tela. Este guia mostra o que você precisa antes, como abrir o terminal em cada sistema, o que o instalador pergunta e o que muda de um sistema para outro.
Em resumo
- Precisa do Node 20.19 ou mais novo e do Claude Code. Para o painel online, contas grátis no Supabase e na Vercel; sem elas,
--sem-nuvem. - O comando é
npx github:dantaspaulo/reveza, igual nos três sistemas. No Windows, ele pede o Git instalado. - O instalador pergunta e monta tudo. A troca automática começa desligada, e você liga quando quiser.
Neste guia
O que você precisa antes
- Node 20.19 ou mais novo
- Baixe a versão LTS em nodejs.org. Para conferir, rode
node -vno terminal: o número precisa ser 20.19 ou maior. - Claude Code instalado
- Em cada computador que vai revezar contas, pela página oficial, com as contas do Claude que você já usa.
- Supabase e Vercel, nos planos grátis
- Para o painel online, uma conta em cada um. O instalador cria o projeto e publica o painel com tokens que ele não guarda. Sem elas, use
--sem-nuvem: o agente decide sozinho no computador. - Git, só no Windows
- O
npx github:baixa o código pelo Git. Instale o Git for Windows ou use o pacote da versão, que aparece mais abaixo.
Quer só ver antes de instalar? npx github:dantaspaulo/reveza --demo abre o painel com dados de exemplo, sem nuvem e sem mexer em conta nenhuma.
Como abrir o terminal em cada sistema
macOS
- Abra o Terminal: aperte Command + Espaço, digite Terminal e Enter.
- Ele também fica em Aplicativos, na pasta Utilitários.
Windows
- Abra o PowerShell ou o Terminal do Windows: clique no menu Iniciar, digite PowerShell (ou Terminal) e Enter.
Linux e VPS
- No computador com tela, abra o aplicativo de terminal (em muitas distribuições, Ctrl + Alt + T).
- Numa VPS, entre por SSH:
ssh usuario@endereco-do-servidor.
O comando
Com o terminal aberto, rode:
npx github:dantaspaulo/revezaO npx vem junto com o Node. Na primeira vez, ele pergunta se pode baixar o pacote: responda y. O comando é o mesmo no Mac, no Windows e no Linux.
No Windows, sem o Git
O npx github: precisa do Git. Sem ele, use o pacote da versão 0.6.0, que não precisa:
npx https://github.com/dantaspaulo/reveza/archive/refs/tags/v0.6.0.tar.gzWindows sem Git: o mesmo instalador, baixado do pacote da versão.
O que o instalador pergunta
Ele numera as etapas do seu caminho (de 1 até o total) e diz o que está fazendo em cada uma. As perguntas, na ordem:
Este computador
Se ele cria uma instalação nova ou entra numa que já existe. No primeiro computador, escolha criar.
Conferência
Confere o Node, o npm e o Claude Code. Sem o Claude Code, ele avisa e segue, mas o mod das sessões e o login das contas ficam para quando você instalar.
Agente e comando reveza
Instala o agente e o mod das sessões e pergunta se pode pôr o comando
revezano PATH.Supabase
O token pessoal da sua conta no Supabase (a página de criar o token abre sozinha no navegador), o projeto (novo, só do Reveza, ou um que já existe) e a região. Depois, o e-mail e a senha de quem administra o painel. O token não fica guardado.
Vercel
O token da Vercel (a página também abre sozinha), onde publicar, o nome do projeto e o endereço do painel: o da Vercel ou um subdomínio seu. Esse token também não fica guardado. A troca automática não tem pergunta: já vem ligada, avisando em 90% e trocando em 95%, e muda no painel.
Contas
A conta que já está em uso no Claude Code entra sozinha. Para cada conta a mais, digite o e-mail: o navegador abre o login oficial e você entra com ela.
Alertas e prova final
Onde avisar (Telegram, e-mail, webhook ou agora não; a notificação no celular se liga no painel) e uma prova final: o computador aparece na nuvem e responde a um comando do painel.
No fim, ele mostra o endereço do painel. No primeiro login, o painel pede a verificação em duas etapas. No terminal, reveza status mostra a conta em uso e o uso de cada uma; dentro do Claude Code, /reveza.
Sem nuvem
Com --sem-nuvem, as etapas do Supabase e da Vercel não aparecem: o agente, o mod e as contas ficam só neste computador, sem painel online. Dá para ligar a nuvem depois.
O que muda em cada sistema
macOS
- Os segredos do Reveza (a chave do cofre e a identidade do computador) ficam no Keychain, o chaveiro do sistema.
- O agente roda como um serviço do launchd, que sobe sozinho quando você entra no Mac.
Windows
- Os segredos ficam em arquivos protegidos pela DPAPI, a proteção do Windows presa ao seu usuário: outro usuário do computador não abre.
- O serviço é uma tarefa do Agendador de Tarefas, que sobe quando você entra no Windows.
- O
npx github:precisa do Git; sem ele, use o pacote da versão.
Linux e VPS
- Com o Secret Service (
secret-tool), os segredos ficam no chaveiro do sistema. Sem ele, num arquivo que só o seu usuário lê (permissão 0600), e oreveza doctoravisa. - O serviço é um serviço de usuário do systemd. Numa VPS, para ele seguir rodando depois que você sai do SSH, ative o
loginctl enable-lingerdo seu usuário: o instalador mostra o comando. - Funciona sem tela: numa VPS, tudo pelo terminal, e o painel abre no navegador de outro aparelho.
Se algo der errado
Parou em "agente/package-lock.json ausente"
Foi corrigido na versão 0.1.1. Rode de novo apontando para a versão atual: npx github:dantaspaulo/reveza#v0.6.0 (com --ligar no fim, se estava ligando um computador novo).
Diz que o Node é antigo
O Reveza pede o Node 20.19 ou mais novo. Instale a versão LTS em nodejs.org, abra um terminal novo e confira com node -v antes de rodar de novo.
Diz que o Claude Code não foi encontrado
O instalador procura o comando claude no PATH. Instale o Claude Code pela página oficial, abra um terminal novo, confira com claude --version e rode o instalador de novo.
No Windows, o npx reclama do Git
O npx github: usa o Git para baixar o código. Instale o Git for Windows e abra um terminal novo, ou use o pacote da versão: npx https://github.com/dantaspaulo/reveza/archive/refs/tags/v0.6.0.tar.gz.
Na VPS, o serviço não subiu
Sem o systemd de usuário, o instalador avisa. Rode reveza rodar num terminal, ou ponha o mesmo comando no crontab com @reboot. Depois, reveza doctor confere a instalação inteira.
Já existe um programa na porta 7788
Outro gestor de contas está rodando. O instalador oferece o modo sombra: o Reveza lê e mostra o que faria, sem trocar conta. Quando parar o outro, rode com --atualizar para sair do modo sombra.
