MÓDULO 1.4

🏠 Onde o Hermes Vive

Terminal, local ou VPS: as casas possíveis do Hermes. Cada uma tem um trade-off de custo, controle e segurança — e saber escolher é o que evita dor de cabeça (e conta alta) depois.

🖥️ Local (seu PC) grátis · fácil · seguro controle: ★★★ custo: grátis uptime: PC ligado ☁️ VPS (alugada) paga mensal · proteja portas controle: ★★ custo: $/mês uptime: 24/7 🌐 Nuvem gerenciada · menos controle controle: ★ custo: $$/uso uptime: alto
6
Tópicos
22
Minutos
Básico
Nível
Prático
Tipo
1

📖 Os termos: terminal, local, VPS

Antes de escolher a casa, três palavras. Terminal é onde você digita comandos; local é o seu próprio computador; VPS é o computador de outra empresa que você aluga.

Terminal
A "janela preta" de comandos
Local
Sua própria máquina
VPS
Computador alugado, remoto

💡 Dica prática

VPS = "Virtual Private Server". É como alugar um quarto numa casa que não é sua: cômodo, mas você precisa trancar a porta.

2

🖥️ No seu computador

Rodar no seu PC é grátis, fácil e seguro. Funciona enquanto o computador estiver ligado — por isso muita gente usa um MacBook velho 24/7 só para isso.

✓ Vantagens do local

  • Zero custo de hospedagem
  • Controle total sobre seus dados
  • Setup simples para começar

✗ Limitações

  • Só roda com o PC ligado
  • Depende do seu hardware
  • Sua internet pode oscilar

💡 Dica prática

A solução do "MacBook velho 24/7" é o melhor dos mundos para começar: uptime quase total e custo zero de hospedagem.

3

⌨️ Como instalar

Há dois caminhos: colar o comando no terminal ou pedir ao Claude Code para instalar por você.

1

Abra o terminal

No Mac: Cmd+Space → digite "terminal" → Enter.

2

Cole o comando de instalação

Copie o comando oficial e cole. Ele baixa e configura o Hermes.

3

Ou peça ao Claude Code

"Instale o Hermes para mim" — ele cuida do processo no terminal.

Exemplo ilustrativo no terminal

# cole o comando de instalação (exemplo)
$ curl -fsSL https://get.hermes.example | sh
# ...e siga as instruções na tela
4

☁️ VPS: aluga, paga, protege

Uma VPS roda no computador de outra empresa (hosting). Você aluga, paga mensal e precisa proteger as portas — caso contrário, há risco de ataque. É a opção para ter o Hermes 24/7 sem deixar seu PC aceso.

📊 O que considerar numa VPS

  • Custo mensal — você paga enquanto a usa
  • Segurança — portas abertas são superfície de ataque
  • Uptime — fica ligada 24/7 sem depender de você
  • Caso de uso — ex.: alugar inferência rápida

⚠️ Erro comum

Subir uma VPS e deixar portas abertas sem proteção. Numa máquina exposta à internet, isso é convite para invasão. Trate segurança como parte do setup, não como "depois".

5

🔗 Cuidado com indicações

Provedores de VPS costumam pagar por indicação via links de afiliados. Nem toda recomendação que você vê é neutra — pode haver comissão por trás.

✓ Escolha bem

  • Compare preço, suporte e região
  • Leia avaliações de fontes independentes
  • Desconfie de "o único certo"

✗ Não caia em

  • Seguir só o link de afiliado mais empurrado
  • Ignorar custos que aparecem depois
  • Achar que recomendação = neutralidade
6

🎚️ Controle na sua máquina

Como roda na sua máquina, você pode pedir ao Hermes coisas como "desligue o gateway" ou "reinicie" — ele administra a própria infraestrutura, por linguagem natural.

🛠️ Auto-administração

O agente consegue mexer no próprio ambiente porque tem acesso ao sistema onde vive:

  • "desligue o gateway" — pausa o ponto de entrada
  • "reinicie" — recomeça o serviço
  • tudo em linguagem natural, sem decorar comandos

💡 Dica prática

Esse poder de auto-administração é ótimo, mas reforça a importância de segurança (Trilha 3): um agente que controla a infra precisa do menor acesso necessário.

7

🧭 Qual casa escolher

Uma referência rápida para decidir entre local, VPS e nuvem conforme a sua prioridade.

Tabela de decisão (ilustrativa)

prioridade         -> escolha
custo zero/começar -> 🖥️ Local (PC, MacBook 24/7)
ligado 24/7        -> ☁️ VPS (paga mensal, proteja portas)
não quero gerir    -> 🌐 Nuvem (gerenciada, menos controle)

✓ Boa prática

  • Comece local, migre só quando precisar de 24/7
  • Trate segurança como parte do setup da VPS

✗ Erro comum

  • Subir VPS cara antes de precisar
  • Deixar portas abertas sem proteção

📌 Resumo do Módulo

Termos — terminal (comandos), local (seu PC), VPS (alugada).
Local — grátis, fácil, seguro; roda com o PC ligado (MacBook 24/7).
Instalar — colar comando no terminal ou pedir ao Claude Code.
VPS — paga mensal, 24/7, mas proteja as portas.
Controle — na sua máquina, ele se auto-administra ("desligue o gateway").

Próximo Módulo:

1.5 — OAuth vs API Key