Riccardo Belli. Risorsa · Claude Code
// risorsa · dal reel

La deep research
dentro Claude Code

Hyperresearch è una skill gratuita e open source che fa fare a Claude Code le ricerche approfondite: gli fai una domanda, legge decine di fonti, scrive il report e controlla che ogni citazione sia vera prima di consegnartelo. Qui trovi il repo, l'installazione, il comando per lanciarla, i prompt per le prime ricerche e i limiti da sapere prima.

Tool
Hyperresearch
Lettura
~6 min
Aggiornata
5 novembre 2026
Claude Code Codex GitHub Python Open source
Scorri

Il tool: Hyperresearch

Licenza MIT
jordan-gibbs/hyperresearch4.404

Hyperresearch è un pacchetto Python con una skill per Claude Code: una volta installato, in Claude Code scrivi /hyperresearch e la tua domanda. Lui cerca sul web e nelle banche dati dei paper scientifici, legge le fonti, le salva una per una sul tuo computer e ti restituisce un report in markdown con ogni frase legata alla sua fonte.

Il codice è gratis e non chiede chiavi API: lavora con i modelli della tua sessione di Claude Code. Gira anche su Codex di OpenAI.

Sul loro benchmark DRACO, 10 domande con lo stesso giudice, la versione completa prende 77,7. La Deep Research di Perplexity prende 57,8, quella di ChatGPT 55,2, quella di Gemini 54,7. Claude Research, la ricerca dentro claude.ai, sta a 73,0. La misura l'hanno fatta loro e la pubblicano nel README.

01Come lavora

Cosa fa in parole semplici

16 passi

Dietro il comando c'è una catena di 16 passi, ognuno affidato a un agente diverso. Quelli che contano:

  1. Scompone la domanda. Ogni cosa che chiedi diventa una voce da coprire nel report. Qui decide anche da solo se basta la versione leggera o serve quella completa.
  2. Legge le fonti in parallelo. Fino a 12 lettori alla volta su siti, paper (OpenAlex, Crossref, CORE), bilanci depositati alla SEC e dati economici FRED. Se un paper è a pagamento cerca una copia gratuita e legale del testo intero.
  3. Scrive tre bozze in parallelo, ognuna da un'angolazione diversa, poi le fonde in un report solo.
  4. Lo fa attaccare da quattro critici. Uno cerca le prove contrarie, uno i punti rimasti in superficie, uno gli argomenti dimenticati, uno le parti della domanda saltate. Le correzioni le applica un agente che può solo modificare righe: riscrivere il report da capo gli è vietato.
  5. Controlla le citazioni. Ogni frase citata deve esistere parola per parola nella fonte salvata. Le citazioni inventate e le fonti ritirate bloccano la consegna. I numeri senza una fonte vengono segnalati.
  6. Tiene tutto in archivio. Ogni fonte letta diventa un file markdown nella cartella research/notes/. La ricerca dopo guarda lì prima di tornare sul web.
02Prima di installare

I limiti veri

Avvertenze
  1. Consuma parecchia quota del tuo piano. Gira sugli agenti della sessione: bozze, critici e correzioni su Opus, i lettori su Sonnet. Una ricerca completa tiene Opus al lavoro per ore. Se il piano arriva al limite a metà, la ricerca si ferma e la riprendi dopo dal punto in cui era: c'è il prompt più sotto.
  2. Non è una risposta da chat. La versione leggera dura 30-40 minuti, quella completa 1,5-2,5 ore. La lanci e fai altro.
  3. La versione leggera salta i critici. Per le domande delimitate (un confronto, una lista, una panoramica) fa una bozza sola e la rifinisce. Le tre bozze e i quattro critici partono sulle domande di analisi.
  4. Le 200 fonti sono della marcia premier. Con la marcia di base legge 55-80 fonti. Per arrivare a più di 200 passi alla marcia premier con un comando. Così la ricerca completa sale a 3-5 ore.
  5. Vive in una cartella sua. L'installazione crea nella cartella in cui la lanci research/, .hyperresearch/, 16 agenti in .claude/ e un blocco nel CLAUDE.md. Usa una cartella vuota fatta apposta e apri Claude Code sempre da lì.
  6. Login e CAPTCHA li lascia a te. Quello che sta dietro un abbonamento che non hai non lo legge. Le pagine con un muro di login finiscono in una coda e alla fine ti dice quali sono.
03Setup

Installala passo per passo

Una volta sola

Ti servono Claude Code e Python in una versione dalla 3.11 alla 3.14. Apri il terminale e incolla queste righe: creano la cartella delle ricerche, installano il pacchetto con il browser che legge le pagine e mettono la skill nella cartella.

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

Su Mac, se il comando pip non esiste, usa pip3. La prima volta hyperresearch install scarica anche il browser Chromium che usa per leggere le pagine: ci mette qualche minuto.

Se pip rifiuta l'installazione per la versione di Python, installala con uv, che si porta dietro un Python giusto. Dalla stessa cartella:

Alternativa con uvterminale
uv tool install --python 3.12 "hyperresearch[crawl4ai]"
hyperresearch install

Se dopo uv il terminale non trova hyperresearch, lancia uv tool update-shell e riapri il terminale. Per Codex al posto di Claude Code l'ultima riga diventa hyperresearch install . --target codex.

04Il lancio

Lanciala da Claude Code

Prompt

Apri Claude Code dentro la cartella ricerche. Se era già aperto lì, chiudilo e riaprilo: gli agenti nuovi li carica all'avvio.

Apri Claude Codeterminale
cd ricerche
claude

Poi scrivi /hyperresearch seguito dalla domanda. Il tipo di domanda decide la versione: un confronto o una lista va sulla leggera, un'analisi con un giudizio va sulla completa. Cambia quello che sta tra parentesi quadre.

Prompt 1 · un confrontoversione 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.
Prompt 2 · un'analisiversione 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.
Prompt 3 · imparare un temacon i paper
/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.

Il report finisce in research/notes/, nel file che inizia con final_report_. Se la ricerca si è fermata a metà, per esempio sul limite del piano, riapri Claude Code nella stessa cartella:

Prompt 4 · riprenderein Claude Code
Riprendi la ricerca di hyperresearch rimasta a metà: lancia hyperresearch run resume -j e continua dal passo che ti indica.

Per le ricerche da più di 200 fonti cambi marcia dal terminale, sempre nella cartella ricerche. La seconda riga ti riporta alla marcia di base.

Marcia premierterminale
hyperresearch profile use premier
hyperresearch profile use full
05L'ordine

Da dove partire

Riepilogo
  1. Crea la cartella ricerche e installa il pacchetto.
  2. Apri Claude Code da quella cartella.
  3. Fai la prima ricerca con il prompt del confronto: in 30-40 minuti vedi come lavora e quanta quota consuma.
  4. Passa all'analisi quando hai una domanda che vale un paio d'ore di lavoro.
  5. Accendi la marcia premier solo per le ricerche che finiscono davanti a un cliente o in una decisione importante.

Tutti i passi in un file

Download

Limiti, comandi di installazione, comando di lancio e i quattro prompt. Tienilo aperto la prima volta che la installi.

hyperresearch-claude-code.md

La guida di questa pagina in un file: i limiti, i comandi in ordine e i prompt per Claude Code. Le parti da cambiare sono tra parentesi quadre.

Scarica · MD ↓
E adesso?

Una domanda.
Un report con le fonti.

Qualche minuto per installarla, mezz'ora per la prima ricerca leggera. Le ricerche lunghe lanciale quando Claude Code non ti serve per altro. Ogni fonte che legge resta nella cartella, così la ricerca dopo parte da lì.

0
stelle su GitHub, lette il 5 novembre 2026
0
passi fra la domanda e il report
0
fonti in una ricerca con la marcia premier

Vuoi andare più a fondo?

Se vuoi impararlo per bene, dal primo comando a Claude Code, c'è il corso. Se invece hai un'azienda e vuoi portare l'AI dentro i processi, parliamone in una call.

Il corso su Claude → Parliamo del tuo progetto →
La risorsa che ti ho promesso. Hyperresearch è open source, licenza MIT. Dati letti il 5 novembre 2026. Riccardo Belli.