Report su Installazione Hermes Agent e CLI Claude

5 minuti

Vista grafico

Report su Installazione Hermes Agent e CLI Claude

Obiettivo

Documentare il processo completo di installazione e configurazione di Hermes Agent e della CLI Claude Code (Anthropic) su un sistema Linux/WSL, in modo da avere un ambiente AI locale pienamente operativo, con accesso al modello Claude e alle funzionalità agentiche avanzate.

Contesto

Hermes Agent è un AI agent personale orchestrato localmente che integra tool, skill, memoria persistente, cron job e supporto multi-piattaforma (Telegram, Discord, WhatsApp, ecc.). È il livello di orchestrazione che avvolge i modelli LLM e li rende autonomi e riusabili.

Claude Code è la CLI ufficiale di Anthropic per interagire con i modelli Claude in modalità agente: legge file, scrive codice, esegue comandi shell, gestisce workflow git e può orchestrare subagenti in parallelo.

I due strumenti si integrano nativamente: Hermes può delegare task di coding a Claude Code tramite il tool terminal(), e Claude Code può essere potenziato con MCP server configurati da Hermes.

Stack richiesto:

  • Linux (Ubuntu 22.04+) o WSL2 su Windows
  • Node.js 18+ (per Claude Code)
  • Python 3.10+ (per Hermes)
  • Connessione internet per autenticazione e API

Architettura / Soluzione

┌─────────────────────────────────────┐
│           Hermes Agent              │
│  (orchestrazione, memoria, skill)   │
│                                     │
│  ┌─────────┐  ┌──────────────────┐  │
│  │ Skills  │  │   Cron / Tools   │  │
│  └─────────┘  └──────────────────┘  │
│         │                           │
│         ▼                           │
│  ┌─────────────────────────────┐    │
│  │   Claude Code CLI (agent)   │    │
│  │   npm: @anthropic-ai/       │    │
│  │         claude-code         │    │
│  └─────────────────────────────┘    │
│         │                           │
│         ▼                           │
│  ┌─────────────────────────────┐    │
│  │    API Anthropic / OAuth    │    │
│  │    claude-sonnet / opus     │    │
│  └─────────────────────────────┘    │
└─────────────────────────────────────┘

Hermes gestisce le interazioni con l’utente, la memoria, le skill e la pianificazione. Quando serve lavoro di coding intensivo o autonomo, delega a Claude Code che opera in modalità print (-p) o interattiva via tmux.

Implementazione

1. Prerequisiti di sistema

Verificare che Node.js e npm siano installati (versione 18+):

node --version   # deve essere >= 18
npm --version

Se assenti, installare via nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts

2. Installazione Claude Code CLI

Installare il pacchetto globalmente tramite npm:

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

Verificare l’installazione:

claude --version

Eseguire il check di salute:

claude doctor

3. Autenticazione Claude Code

Opzione A — OAuth (consigliata per piani Pro/Max):

claude auth login

Si apre il browser per il login con account Anthropic. Dopo l’autorizzazione, il token viene salvato localmente.

Opzione B — API Key (per billing diretto):

claude auth login --console

Oppure esportare la chiave come variabile d’ambiente (aggiungere a ~/.bashrc):

export ANTHROPIC_API_KEY="sk-ant-..."

Opzione C — SSO Enterprise:

claude auth login --sso

Verificare lo stato dell’autenticazione:

claude auth status --text

4. Installazione Hermes Agent

Hermes si installa tramite il suo installer ufficiale. Dalla documentazione su https://claude-code.nousresearch.com/docs:

# Scaricare e avviare il setup
curl -fsSL https://get.hermes-agent.com/install.sh | bash

Oppure seguendo il metodo manuale:

# Clonare il repository
git clone https://github.com/nousresearch/hermes ~/.hermes-src
 
# Installare le dipendenze Python in un venv
cd ~/.hermes-src
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Avviare il setup interattivo:

hermes setup

Il wizard guida attraverso:

  • Scelta del provider (Anthropic, OpenAI, OpenRouter, custom)
  • Inserimento API key o configurazione OAuth
  • Scelta del modello predefinito
  • Configurazione dei canali di notifica (opzionale: Telegram, Discord, ecc.)

5. Configurazione provider in Hermes

Impostare Anthropic come provider e selezionare il modello:

hermes config set provider anthropic
hermes config set model claude-sonnet-4-6

Verificare la configurazione attiva:

hermes config list

6. Test dell’integrazione

Avviare Hermes in modalità CLI:

hermes

Testare un task semplice che delega a Claude Code:

> scrivi un hello world in Python e salvalo in /tmp/test.py

Hermes eseguirà il task tramite il tool terminal() invocando Claude Code in print mode:

claude -p "write hello world to /tmp/test.py" --allowedTools "Write" --max-turns 3

7. Configurazione memoria e skill

Hermes salva la memoria persistente in ~/.hermes/memories/. Le skill sono in ~/.hermes/skills/. Dopo l’installazione è possibile caricare skill preesistenti o crearne di nuove:

hermes skills list

8. Aggiornamenti futuri

Per aggiornare Claude Code:

claude update
# oppure
npm update -g @anthropic-ai/claude-code

Per aggiornare Hermes: seguire la procedura di aggiornamento del repository sorgente o il comando dedicato se disponibile.

Risultati

Al termine dell’installazione l’ambiente risulta pienamente operativo:

  • claude --version risponde con la versione corrente (es. 2.x.x)
  • claude auth status --text mostra l’account autenticato
  • hermes avvia la sessione CLI interattiva
  • I task di coding vengono delegati correttamente a Claude Code
  • La memoria persiste tra sessioni in ~/.hermes/memories/
  • Le skill sono caricate e disponibili via hermes skills list

Configurazione verificata su: Ubuntu 22.04 LTS / WSL2 (Windows 11), Node.js 20 LTS, Python 3.12.

Prossimi step

  • Configurare un gateway di messaggistica (es. Telegram) per interagire con Hermes da mobile
  • Installare MCP server aggiuntivi per Claude Code (claude mcp add github, claude mcp add postgres, ecc.)
  • Creare skill personalizzate per i workflow ricorrenti del proprio progetto
  • Impostare cron job automatici con hermes cronjob
  • Esplorare la modalità multi-agente con delegate_task per task paralleli
  • Leggere la documentazione completa su https://claude-code.nousresearch.com/docs

Hermes Agent Claude Code CLI Setup Ambiente AI Locale

Vista grafico