Passo a passo para leigos

Instale sua Naia (Hermes + Claude)

Voce nunca abriu um terminal? Sem problema. Siga os 10 passos abaixo na ordem, copie cada comando no botao COPIAR e cole na sua VPS. Em poucos minutos sua Naia estara viva no seu Telegram, com o cerebro do Claude.

10 passos Cerebro Claude Caminho oficial

Antes de comecar

O que voce precisa ter em maos

Sao tres coisas. Separe as tres agora, porque voce vai usar todas durante a instalacao.

Uma VPS Ubuntu com acesso root E um computador na nuvem, ligado 24 horas por dia. Voce precisa do IP dela e da senha de root (o usuario master).
Assinatura Claude Pro ou Max E o cerebro da sua Naia, e ele roda dentro da sua assinatura. Voce NAO precisa de chave de API nem de cartao a mais.
Um bot no Telegram e o seu ID Crie um bot com o @BotFather e guarde o TOKEN que ele te der. Depois mande "oi" para o @userinfobot para pegar o seu ID do Telegram.

Maos a obra

Os 10 passos da instalacao

Faca um de cada vez, na ordem. Cada passo tem um comando: clique em COPIAR, cole na VPS e aperte Enter. So avance quando o anterior terminar.

Conectar na sua VPS

Primeiro voce entra dentro da sua VPS pelo seu computador. Escolha o seu sistema abaixo e siga SO o caminho dele.

No Windows: abra o PowerShell. Aperte a tecla Windows, digite powershell e de Enter.

Agora, na janela que abrir, rode o comando abaixo trocando SEU_IP pelo IP da sua VPS.

Comando

$ ssh root@SEU_IP

O que esperar: na primeira vez ele pergunta se voce confia na identidade, digite yes e de Enter. Depois ele pede a senha do root, e a tela fica EM BRANCO enquanto voce digita a senha. Isso e normal, digite mesmo sem ver e de Enter. Voce esta dentro quando a linha comeca com root@.... Dica: se a conexao cair, e so rodar o ssh de novo.

Preparar o sistema

Este comando atualiza a VPS e instala as ferramentas basicas que o resto da instalacao vai usar.

Comando

$ apt update && apt install -y curl xz-utils git

Instalar o Hermes

O Hermes e o corpo da sua Naia. Este comando baixa e instala ele sozinho.

Comando

$ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Tenha paciencia: espere terminar. Ele baixa varias coisas e pode demorar um pouco.

Instalar o Node 20

O Node e um programa que a ferramenta do Claude precisa para funcionar. Este comando instala a versao 20, que e a certa.

Comando

$ curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && apt install -y nodejs

Instalar a CLI oficial do Claude Code

Agora voce instala a ferramenta oficial da Anthropic que fala com o Claude.

Comando

$ npm install -g @anthropic-ai/claude-code

Fazer login na sua conta Claude

Aqui voce conecta a sua assinatura. E ela que vira o cerebro, sem custo de API.

Comando

$ claude auth login

O que fazer: siga o link ou a instrucao que aparecer na tela para entrar na sua conta Claude (a mesma da sua assinatura Pro ou Max).

Instalar o plugin que liga o Hermes ao Claude

Este plugin e a ponte: e ele que faz o Hermes usar o Claude como cerebro.

Comando

$ hermes plugins install claude-subscription-directsdk

Escolher o Claude como cerebro

Agora voce diz para o Hermes qual cerebro usar. Rode o comando e escolha nas opcoes que aparecerem.

Comando

$ hermes model

O que escolher: selecione a opcao Claude Subscription DirectSDK (Experimental) e depois o modelo (por exemplo, sonnet).

Conectar sua Naia ao Telegram

Ultimo comando. Ele liga a sua Naia ao seu bot do Telegram e a deixa rodando 24 horas por dia.

Comando

$ hermes gateway setup

Responda assim, na ordem: se ele perguntar se quer reconfigurar, responda y. Cole o TOKEN do seu bot quando pedir. Cole o seu ID do Telegram na parte de usuarios permitidos. Quando perguntar se quer usar o seu ID como home channel, responda y. Aceite iniciar o servico com y. Escolha a opcao System service (assim ela roda 24/7 e volta sozinha se a VPS reiniciar). E quando perguntar o usuario do servico, digite root.

Testar

Pronto. Agora e so falar com ela. Abra o Telegram, procure o SEU bot (o mesmo @ que voce criou no @BotFather) e mande "oi". A primeira resposta pode levar alguns segundos, entao tenha um pouco de paciencia.

Se algo der errado

Os tres tropecos mais comuns

Nenhum deles e grave. Veja o que fazer em cada caso e siga em frente.

Apareceu "command not found" no seu terminal

Se a linha mostra o seu proprio computador (no Windows algo como PS C:\Users...; no Mac termina com % ou $ e mostra o seu usuario) em vez de root@..., voce saiu da VPS. Rode ssh root@SEU_IP de novo para voltar e continue do passo onde parou.

A conexao caiu no meio (Connection reset)

E normal quando a internet oscila. Nao perdeu nada: reconecte com o ssh e continue do passo onde parou.

A senha "nao aparece" quando eu digito

Isso e proposital, por seguranca. A tela fica EM BRANCO de proposito. Digite a senha mesmo sem ver nada e de Enter.

Aviso honesto: o plugin do Claude e experimental, e cada resposta da sua Naia consome da cota da sua assinatura Claude. Para evitar cobranca extra, mantenha o "extra usage" (uso adicional) DESLIGADO na sua conta. Requer Hermes 0.21.4 ou mais novo, e uma instalacao nova ja vem com essa versao.