# Hyperresearch: la deep research dentro Claude Code

Guida di Riccardo Belli · riccardobelli.com/hyperresearch · dati letti il 5 novembre 2026

Repo: https://github.com/jordan-gibbs/hyperresearch (licenza MIT, 4.404 stelle, versione 0.13.0)

## Cosa fa

Scrivi in Claude Code `/hyperresearch` e la tua domanda. Lui scompone la domanda, legge le fonti in parallelo (siti, paper da OpenAlex, Crossref e CORE, bilanci SEC, dati FRED), scrive il report e controlla che ogni frase citata esista parola per parola nella fonte salvata. Sulle domande di analisi scrive tre bozze e le fa attaccare da quattro critici prima di consegnare. Ogni fonte letta resta in `research/notes/` e la ricerca dopo parte da lì.

## I limiti da sapere prima

1. Consuma parecchia quota del tuo piano Claude: bozze, critici e correzioni girano su Opus, i lettori su Sonnet. Nessuna chiave API da pagare a parte.
2. Versione leggera 30-40 minuti, versione completa 1,5-2,5 ore, marcia premier 3-5 ore.
3. La versione leggera (confronti, liste, panoramiche) fa una bozza sola e salta i critici.
4. Con la marcia di base legge 55-80 fonti. Per più di 200 fonti serve la marcia premier.
5. L'installazione crea `research/`, `.hyperresearch/`, 16 agenti in `.claude/` e un blocco nel `CLAUDE.md` della cartella: usa una cartella vuota fatta apposta.
6. Login, CAPTCHA e contenuti a pagamento non li supera da solo.
7. Il primo posto sul benchmark DRACO (77,7 contro Perplexity 57,8, ChatGPT 55,2, Gemini 54,7, Claude Research 73,0) è una misura loro, su 10 domande.

## Installazione

Servono Claude Code e Python dalla 3.11 alla 3.14.

```
mkdir ricerche
cd ricerche
pip install "hyperresearch[crawl4ai]"
hyperresearch install
```

Su Mac, se `pip` non esiste, usa `pip3`. La prima volta `hyperresearch install` scarica il browser Chromium che legge le pagine.

Se pip rifiuta la versione di Python, dalla stessa cartella:

```
uv tool install --python 3.12 "hyperresearch[crawl4ai]"
hyperresearch install
```

Se poi il terminale non trova `hyperresearch`: `uv tool update-shell` e riapri il terminale.

Per Codex l'ultima riga diventa `hyperresearch install . --target codex`.

## Lancio

```
cd ricerche
claude
```

Se Claude Code era già aperto nella cartella, chiudilo e riaprilo. Poi `/hyperresearch` e la domanda.

## Prompt

Confronto (versione leggera):

```
/hyperresearch Confronta [Notion], [ClickUp] e [Asana] per un team di [15] persone in Italia: prezzi per utente nel 2026, integrazioni, limiti dei piani e cosa dicono gli utenti. Chiudi con una tabella e le fonti. Scrivi il report in italiano.
```

Analisi (versione completa):

```
/hyperresearch Valuta se per un'azienda di [logistica] con [50] dipendenti conviene introdurre [agenti AI nel servizio clienti] nei prossimi 12 mesi. Analizza costi, casi reali documentati, rischi e cosa dicono gli studi. Chiudi con una raccomandazione motivata. Scrivi il report in italiano.
```

Imparare un tema:

```
/hyperresearch Spiegami da zero [come funzionano le batterie allo stato solido]: i paper principali, i numeri che contano e a che punto è la produzione. Scrivi il report in italiano.
```

Riprendere una ricerca interrotta:

```
Riprendi la ricerca di hyperresearch rimasta a metà: lancia hyperresearch run resume -j e continua dal passo che ti indica.
```

## Dove trovi il report

`research/notes/final_report_<nome-della-ricerca>.md`

## Marcia premier

```
hyperresearch profile use premier
hyperresearch profile use full
```

La prima accende le ricerche da più di 200 fonti, la seconda ti riporta alla marcia di base.
