Lancia il tuo SaaS sulle directory con Claude Code

Di cosa ha bisogno Claude Code

Una sessione claude nella cartella clonata

Avvia claude dentro il repository privato che hai clonato dopo l’acquisto. Il repository include un CLAUDE.md che importa AGENTS.md, così Claude Code carica il runbook come istruzioni di progetto senza passaggi aggiuntivi.

Python 3.10+ e Node.js LTS

Python esegue lo script del workspace, record.py e la dashboard locale, solo con la libreria standard. Node.js fornisce npx, che Claude Code usa per avviare Chrome DevTools MCP come server stdio locale.

Una sola voce MCP, limitata a te

claude mcp add scrive di default nell’ambito locale: solo tu, solo questo progetto. L’ambito utente renderebbe il server del browser disponibile in ogni progetto, una portata maggiore di quella che serve a un lancio.

Permessi fissi per prodotto

Sono le richieste di permesso di Claude Code a decidere quali strumenti possono girare. LaunchRepo aggiunge un livello per prodotto in authorizations.json: registrazioni gratuite, invii definitivi, azioni sulla posta e badge, ognuno concesso una volta. La spesa resta a zero.

Collegare Claude Code al tuo Chrome

Claude Code raggiunge il tuo browser tramite il server Chrome DevTools MCP. Il percorso preferito in BROWSER-SETUP.md riusa il Chrome in cui lavori già, con tutti i tuoi accessi: Chrome 144 o successivo, debug remoto attivato su chrome://inspect/#remote-debugging e il flag --autoConnect sul server.

Se sul tuo computer l’auto-connect non è disponibile, la stessa guida descrive un profilo Chrome dedicato su una porta di debug locale. In quel caso sostituisci --autoConnect con --browserUrl=http://127.0.0.1:9222. Usa una sola modalità, mai entrambe, e non esporre mai la porta.

Lato Claude Code la configurazione è tutta qui. I due flag dopo --autoConnect disattivano le statistiche d’uso e le ricerche CrUX, come fa la guida browser del repository:

claude mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest --autoConnect --no-usage-statistics --no-performance-crux
claude mcp list

Formato come documentato da code.claude.com, controllato il 30 settembre 2026. ↗

Ora claude mcp list dovrebbe mostrare chrome-devtools come ✔ Connected. Chiedi a Claude Code di aprire example.com in una nuova scheda vuota, approva la richiesta di connessione di Chrome e guarda muoversi proprio quella scheda. Solo allora accedi alla prima directory.

Collega il tuo coding agent al tuo Chrome →

Il prompt di avvio

Incolla il prompt di avvio pubblico di START.md nella stessa sessione claude. Crea il tuo workspace privato accanto al checkout, così dati del prodotto e credenziali non finiscono mai nel repository consegnato, avvia la dashboard e risponde con un link 127.0.0.1.

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

Playbook e istruzioni sono Markdown in inglese, il formato che gli agenti di coding gestiscono meglio. I testi del tuo prodotto possono essere in qualsiasi lingua accettata da una directory; l’agente ti risponde nella tua lingua.

Da lì in poi è la dashboard a darti il prompt successivo: primo gruppo, ripresa, revisione. Claude Code rilegge ogni volta i file del workspace, quindi chiudere il terminale non fa perdere nulla.

Avvia LaunchRepo in tre passaggi →

Com’è un’esecuzione

Un’esecuzione in Claude Code si può seguire con gli occhi: il terminale mostra quale playbook legge e quale strumento chiama, Chrome mostra il modulo che compila. Qui sotto trovi il piccolo gruppo di esempio della home page; i tuoi stati reali vengono da submissions.json.

Quando la connessione di Claude Code si interrompe

I problemi più frequenti con Claude Code e Chrome DevTools MCP, ognuno con la soluzione indicata dalla documentazione. Nessuno tocca LaunchRepo, e ogni esito registrato fin lì resta nel tracker.

claude mcp list mostra ✘ Failed to connect

Esegui npx chrome-devtools-mcp@latest --help nello stesso terminale per vedere se il server parte, e assicurati che Claude Code usi lo stesso Node.js e lo stesso npm. Un primo download lento può superare il timeout di avvio; avvia Claude Code con un valore più alto, per esempio MCP_TIMEOUT=20000 claude.

“MCP server disconnected · open /mcp to reconnect”

Ricollega il server da /mcp, poi ripeti il controllo con la scheda vuota prima dell’invio successivo, perché una riconnessione può far ricomparire la richiesta di approvazione di Chrome. Il gruppo riprende dal tracker nel punto in cui si era fermato.

Si muove un’altra finestra

Fermati prima di qualsiasi accesso. Con più profili Chrome, l’auto-connect si collega a quello predefinito. Passa al profilo giusto o usa il profilo dedicato di riserva, poi ripeti il test visibile.

Se gli strumenti del browser vanno in timeout con --autoConnect, controlla quattro cose: Chrome 144 o successivo è già aperto, il debug remoto è attivo su chrome://inspect/#remote-debugging, hai accettato la richiesta di connessione di Chrome e nessun altro strumento sta usando lo stesso browser. Chrome DevTools MCP carica ogni scheda aperta, quindi chiudi quelle che non ti servono.

Dove servi ancora tu

LaunchRepo di proposito non è un servizio in background. Questi momenti fermano l’esecuzione e vengono registrati come passaggi a una persona; l’agente non li aggira mai:

CAPTCHA e controlli anti-bot

Claude Code mette in pausa quella piattaforma, registra prepared_needs_human e lo scrive nel terminale; la dashboard la elenca sotto “needs you”. Risolvi la verifica nella stessa scheda di Chrome e di’ a Claude Code di continuare.

2FA e codici di verifica

I codici arrivano nella casella di posta aperta nel Chrome collegato, dove Claude Code può aprire il link di conferma. Se la tua posta sta altrove, il codice lo passi tu e il tracker annota un passaggio a una persona.

Upsell a pagamento

Un percorso solo a pagamento finisce come deferred_paid con una breve nota. Claude Code non autorizza mai un acquisto né avvia una prova con carta, anche dove una richiesta di permesso consentirebbe il clic.

Confermare “live”

Claude Code può trovare l’URL pubblico della scheda, ma una piattaforma viene segnata come live solo dopo che l’hai guardata tu. Una schermata di ringraziamento resta una schermata di ringraziamento.

Nessun benchmark, nessuna classifica: dichiariamo la compatibilità con Claude Code perché soddisfa i due requisiti qui sopra, non perché l’abbiamo misurato rispetto ad altri agenti.

Domande