Hermes Agent e Claude Code: onde cada um entra no fluxo de quem programa?

Fala aí, beleza? Todo mundo que testa um agente pessoal de IA cai na mesma armadilha: acha que ele vai substituir o assistente de código

Não vai

E o contrário também não acontece: teu assistente de desenvolvimento não vai responder aquela mensagem que chegou no Telegram enquanto você tava longe do editor

Se você já usa Claude Code no dia a dia e ouviu falar do Hermes Agent nas últimas semanas, esse post é pra separar as duas camadas de uma vez

Uma cuida da tua ROTINA, a outra cuida do teu CÓDIGO

E, sim, elas conversam entre si de um jeito bem direto, se liga…

O que é o Hermes Agent e de onde ele veio

O Hermes Agent é um agente pessoal de IA de código aberto, projeto da Nous Research, com repositório oficial em NousResearch/hermes-agent e site próprio em hermes-agent.nousresearch.com

A licença é MIT, então é aquele tipo de projeto que tu clona, lê e adapta sem pedir licença pra ninguém

Ele foi lançado em 25 de fevereiro de 2026, posicionado como sucessor direto do OpenClaw

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

A versão mais recente é a v0.19.0, publicada em 3 de agosto de 2026, ou seja, é projeto em movimento de verdade

E o modelo de custo? Aqui mora uma diferença importante

O software em si é gratuito e auto-hospedado: você roda na tua máquina (ou na tua VPS) e usa a chave de API do teu próprio provedor

A lista de provedores suportados inclui OpenRouter, Anthropic, OpenAI, Nous Portal, Ollama ou um endpoint customizado teu

Ou seja, não tem assinatura do agente, tem consumo de modelo, que é a conta que você já paga de qualquer jeito 🙂

Assistente de rotina x assistente de desenvolvimento: o que muda

Antes da tabela, um aviso: essa comparação NÃO é "qual é melhor"

É "qual pergunta cada um responde"

Se você conhece a diferença entre um gerenciador de pacotes e uma IDE, o raciocínio é o mesmo: são camadas diferentes do mesmo dia de trabalho

Repara que quase nenhuma linha é concorrência direta

O Hermes responde "quem me atende quando eu não estou no editor?"

O Claude Code responde "quem mexe no arquivo?"

E quando você quer VÁRIAS frentes de código rodando ao mesmo tempo, aí a resposta nem é o agente pessoal: é usar subagents no Claude Code, que é outra camada ainda

O que você precisa antes de rodar o Hermes Agent

Lista curta, sem PC da Nasa:

• Sistema Linux, macOS ou WSL2 (se você é do Windows puro, é o WSL2 mesmo)
• Python 3.11, que é o mínimo exigido no pyproject.toml; o próprio instalador resolve isso rodando uv python install 3.11
• Um modelo com no mínimo 64.000 tokens de contexto: modelo menor é REJEITADO na inicialização
• Chave de API de um provedor suportado (OpenRouter, Anthropic, OpenAI, Nous Portal, Ollama ou endpoint customizado)
• Claude Code instalado, se a ideia é delegar a parte de código pra ele

Esse item do contexto mínimo pega muita gente desprevenida, então guarda ele aí que a gente volta nisso no passo a passo

Como instalar o Hermes Agent e ligar ele ao Claude Code

1. Instala pelo script oficial

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

É um script único, e é ele que cuida da versão do Python pra você

2. Roda o assistente de setup

hermes setup

Aqui você configura provedor de modelo, modelo padrão e diretório de memória

Detalhe massa pra quem vem do agente anterior: o hermes setup detecta uma instalação em ~/.openclaw e oferece migrar antes de começar a configuração

O erro comum deste passo: escolher um modelo pequeno demais só porque é barato

Abaixo de 64.000 tokens de contexto ele é rejeitado na inicialização, e você vai ficar achando que a instalação quebrou quando o problema era a escolha do modelo

3. Sobe o agente

hermes

Esse é o comando que inicia o agente, simples assim

4. Usa a skill embutida de delegação

O Hermes já vem com uma skill nativa pra jogar programação pro Claude Code: ela mora em skills/autonomous-ai-agents/claude-code/SKILL.md no repositório oficial e é documentada como "Delegate coding to Claude Code CLI"

Ou seja, você não precisa inventar cola nenhuma entre as duas ferramentas, a ponte já existe

O erro comum deste passo: esperar que o Claude Code abra no modo interativo dentro dessa delegação

A documentação indica o print mode como caminho preferido pra tarefa única, com saída estruturada, e o modo interativo depende de tmux

5. Entende como a delegação acontece de verdade

No fundo, delegar é chamar o Claude Code sem sessão interativa

claude -p "Find and fix the bug in auth.py" --allowedTools "Read,Edit,Bash"

Esse é o exemplo oficial, e ele mostra duas coisas de uma vez: a tarefa vai por texto e as ferramentas liberadas vão explícitas

O modo print também lê stdin, o que abre o caminho mais prático do mundo real:

cat build-error.txt | claude -p 'corrija o erro deste build'

E tem a flag --output-format, com a opção stream-json, quando você quer consumir a saída em outro lugar em vez de só ler no terminal

O erro comum deste passo: achar que claude -p parte leve por padrão

Não parte: sem a flag --bare, ele carrega o mesmo contexto de uma sessão interativa

A --bare pula o auto-discovery de hooks, skills, plugins e servidores MCP, e é ela que reduz o tempo de partida

claude -p --bare "gera o CHANGELOG do último commit"

Tome cuidado com o outro lado dessa moeda: pulando o auto-discovery, você também abre mão do que aquele contexto traria

Rodando na prática: o que aprendi usando o Hermes no dia a dia

Minha rotina com o Hermes começou pelo lado menos confortável: terminal ou app de mensagem

Dava pra conversar com o agente pelo Telegram ou WhatsApp numa boa, mas mudar CONFIGURAÇÃO por ali travava

Trocar o modelo, por exemplo, virava um problema chato de resolver por chat

A primeira mensagem que eu mandei ficou sem resposta e não era bug do agente: o modelo que eu usava como principal estava indisponível pra mim naquele momento

Troquei de modelo e aí sim, ele respondeu pelo nome que eu tinha definido lá no setup e foi buscar informação na internet quando eu perguntei a previsão do tempo de uma cidade

A leitura que fica é essa: o gargalo do agente pessoal nunca foi a capacidade dele, foi o ACESSO

Enquanto gerenciar o agente exigia entrar no servidor ou brigar com um chat, ele não colava na rotina de verdade

Nesse vídeo eu mostro essa parte prática na tela, do meu lado, incluindo o primeiro teste real do agente respondendo

Aviso que ele é nível dois, então não cobre a instalação nem os fundamentos do Hermes Agent (pra isso eu aponto um conteúdo anterior meu ali no vídeo)

Quando usar cada um: 5 situações do dia a dia de quem programa

1. Chegou pedido pelo Telegram e você não está no editor

Camada do Hermes, sem dúvida

O gateway dele atende por Telegram, Discord, Slack, WhatsApp, Signal e e-mail, entre outras plataformas, então o agente é alcançável de onde você estiver

Claude Code não resolve isso, ele nem sabe que a mensagem existe

2. Você tem um log de erro e quer o arquivo corrigido

Camada do Claude Code, direto:

cat build-error.txt | claude -p 'corrija o erro apontado neste log'

É tarefa única, entrada por pipe, saída estruturada se você quiser

3. Aquela rotina que você repete toda semana

Camada do Hermes

Ele tem learning loop com criação e curadoria de skills a partir do uso, além de memória persistente entre sessões

O que você faz repetido tende a virar skill, e é isso que separa um agente pessoal de um chat bonitinho

4. Puxar ferramenta externa pro fluxo

Camada do Hermes de novo, por causa do cliente MCP nativo, com transportes stdio e HTTP, carregamento seletivo de ferramentas e recarga automática quando a configuração mcp_servers muda

Se o teu cenário é orquestrar processo de empresa inteiro, aí a conversa encosta em agentes de IA autônomos com n8n, que é um outro tipo de trilho

5. O agente pessoal disparando uma tarefa de código

Aqui as duas camadas se encontram: o Hermes usa a skill embutida claude-code e chama o Claude Code em print mode pra resolver a tarefa

É o desenho certo, não a exceção: quem recebe o pedido é o agente de rotina, quem mexe no repositório é o assistente de desenvolvimento

Conclusão

A divisão é simples de guardar: Hermes Agent cuida da ROTINA, Claude Code cuida do CÓDIGO

Um é alcançável por mensagem, tem memória entre sessões e aprende skill pelo uso; o outro executa tarefa de código com controle explícito de ferramentas

E eles não brigam, tanto que a ponte já vem embutida no repositório do Hermes

O próximo passo prático é bem pequeno: roda o hermes setup, aponta um modelo com contexto suficiente (lembra do mínimo de 64.000 tokens) e testa UMA delegação com claude -p antes de montar qualquer automação maior

Se essa primeira delegação funcionar limpa, o resto é só empilhar em cima

Faça o teste e me conta como foi, até o próximo post!