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 ↓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.
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.
Dietro il comando c'è una catena di 16 passi, ognuno affidato a un agente diverso. Quelli che contano:
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.
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:
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.
Apri Claude Code dentro la cartella ricerche. Se era già aperto lì, chiudilo e riaprilo: gli agenti nuovi li carica all'avvio.
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.
/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.
/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.
/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:
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.
hyperresearch profile use premier hyperresearch profile use full
Limiti, comandi di installazione, comando di lancio e i quattro prompt. Tienilo aperto la prima volta che la installi.
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 ↓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ì.
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.