Hai mai provato a spiegare cos'è una pull request a un tuo amico non tecnico e hai visto i suoi occhi vitrei come un nastro trasportatore di Krispy Kreme? Ora immagina di dirgli che un'AI non solo può capire il tuo repository, ma anche aprire PR per te. Benvenuti nel 2025, dove il tuo editor di codice è un po' un co-pilota, un po' un passeggero che dà consigli e, se lo configuri bene, un tirocinante abbastanza decente.
Questa guida ti mostra come connettere GitHub a Claude Code e generare automaticamente pull request. Passeremo da "Eh?" a "Ship it" con una configurazione passo dopo passo, flussi di lavoro reali e alcune insidie da evitare. Collegherai GitHub, permettendo a Claude Code di vedere cosa sta succedendo e facendogli aprire e aggiornare PR che puoi effettivamente unire senza sentirti come se avessi fatto un patto con il diavolo algoritmico.
Attenzione: qui vedrai due percorsi principali: utilizzare l'integrazione di GitHub Actions di Claude Code e utilizzare i server Model Context Protocol (MCP) per dare a Claude un accesso sicuro e limitato alle API di GitHub. Quale dovresti scegliere? Se desideri un aiuto plug-and-play per le PR direttamente in GitHub, il percorso Actions è la soluzione migliore. Se desideri un controllo locale del repository basato sulla chat con autorizzazioni granulari, MCP è il tuo strumento potente.
Cosa stiamo costruendo
- Connetti GitHub a Claude Code in modo sicuro.
- Consenti a Claude di analizzare il tuo repository, proporre modifiche e aprire PR.
- Automatizza revisioni, etichette, checklist e persino commit di follow-up.
- Aggiungi delle protezioni in modo che non rinomini l'intero tuo monorepo in "final_final_v2".
Perché è importante
Perché il cambio di contesto è la tassa sulla produttività che nessuno ha votato. Un'AI in grado di aprire una PR con lo stesso rigore che ti aspetteresti da un junior dev (nei suoi giorni buoni) è un vero risparmio di tempo. Non per sostituire gli umani (calmati), ma per sostituire le parti di ingegneria "ugh, boilerplate".
Percorso A: Genera automaticamente PR con Claude Code GitHub Actions
Se vivi dentro GitHub tutto il giorno (unisciti al club), questo percorso ti offre un bot in grado di analizzare il codice in issue e PR, suggerire modifiche e persino aprire o aggiornare PR, direttamente dal tuo repository.
Cosa ti servirà
- Un repository GitHub che controlli (o un branch che puoi rompere senza piangere).
- Accesso amministratore al repository per configurare Actions e segreti.
- Una chiave API di Claude se la tua action o il tuo flusso di lavoro ne hanno bisogno.
Passo 1: Abilita GitHub Actions nel tuo repository
- Vai al tuo repository → Impostazioni → Actions → Generale.
- Abilita "Consenti tutte le actions e i flussi di lavoro riutilizzabili" (oppure limita alle actions approvate della tua organizzazione se i tuoi responsabili della sicurezza ti stanno già guardando storto).
Passo 2: Aggiungi un flusso di lavoro di Claude Code
Crea .github/workflows/claude-pr-bot.yml con un trigger basato sul tuo flusso di lavoro preferito. Ecco due schemi comuni:
Opzione 1: PR guidate dalle issue
- Quando apri una issue con un'etichetta speciale (ad es. ai-pr), il flusso di lavoro viene eseguito.
- Legge il prompt della issue (ad es. "Aggiungi il toggle della modalità scura"), crea un nuovo branch, modifica i file usando Claude, esegue il push dei commit e apre una PR con un riepilogo dettagliato.
Opzione 2: Modifiche guidate dai commenti su una PR esistente
- Quando commenti @claude per favore rifattorizza il modal delle impostazioni, il flusso di lavoro viene eseguito.
- Analizza la diff, propone modifiche ed esegue il push degli aggiornamenti al branch della PR.
Flusso di lavoro di base (schema di alto livello)
name: Claude PR Bot
on:
issues:
types: .
- Una guida rapida sull'integrazione e sui casi d'uso ti offre una visione d'insieme di cosa è sensato automatizzare (e cosa no) nei team reali.
- Se sei un tipo da apprendimento visivo, questa dimostrazione mostra le PR AI generate automaticamente in azione, dall'inizio alla fine.
Percorso B: Connetti GitHub a Claude Code tramite MCP (per power user locali)
Se vuoi che Claude lavori con il contesto del tuo repository locale (file sulla tua macchina, branch che stai gestendo, comandi di cui ti fidi), MCP ti offre un bridge autorizzato. Pensalo come a un portiere per il tuo repository: decide quali porte Claude può aprire.
Cosa ti servirà
- Claude Desktop o un'integrazione IDE che supporti gli strumenti MCP.
- Un server GitHub MCP che esegui localmente, configurato con un token che limita gli scope.
- Un token di accesso personale (PAT) con solo gli scope di cui hai veramente bisogno (ad es. repo:status, public_repo, pull_request write).
Passo 1: Procurati un server GitHub MCP
- Esiste un server open source ufficiale che espone operazioni API di GitHub selezionate (cerca issue, crea branch, apri PR, ecc.). È configurabile in modo da abilitare solo ciò di cui hai bisogno, il che riduce anche la confusione dell'AI e mantiene contenta la sicurezza. Per una visione più ampia dei server MCP ed esempi, controlla la directory centrale.
Passo 2: Configura il tuo client per comunicare con il server
- Nel tuo file di configurazione del client (ad es. un file di configurazione JSON per la tua app AI), registra il server GitHub MCP, passagli il tuo token tramite variabili d'ambiente e aggiungi a una whitelist i repository consentiti.
- Suggerimento da professionisti: metti il token nel tuo portachiavi di sistema o in un file dotenv, non nel tuo file di configurazione. Non diventare l'esempio ammonitore nella tua prossima riunione generale.
Passo 3: Testa la superficie dello strumento
- Chiedi a Claude di elencare le issue aperte, leggere un file specifico o creare un branch. Verifica che non possa fare nulla che tu non abbia esplicitamente consentito.
- Solo dopo aver verificato la sanità dei comandi di base dovresti abilitare create_pull_request.
Passo 4: Consenti a Claude di proporre e aprire una PR
- Esempio di prompt: "Nel repository org/app-frontend, crea un nuovo branch feat/dark-toggle, implementa un toggle delle impostazioni per la modalità scura in SettingsPanel.tsx, aggiorna i test e apri una PR con una checklist per il QA."
- Il server orchestra: legge lo stato del repository, scrive le modifiche (se hai configurato strumenti per file locali), esegue il push di un branch, apre una PR con il tuo template e pubblica un riepilogo.
Parliamoci chiaro: protezioni di cui hai effettivamente bisogno
- Dry run di sola lettura: chiedi a Claude di produrre una diff unificata (git diff) prima dell'accesso in scrittura. Esegui il merge dopo averla controllata visivamente.
- Corpi delle PR con template: includi note sui rischi, piani di test e passaggi di implementazione. Fai in modo che il bot completi il template; fai in modo che gli umani lo rivedano.
- Regole di etichettatura: applica automaticamente etichette come ai-generated e needs-tests per mantenere le cose individuabili e oneste.
- Denominazione dei branch: richiedi un prefisso (ai/ o bot/) con regole di protezione del branch. Anche i robot hanno bisogno di uniformi.
Momento aneddotico: ho chiesto a un'AI di "correggere il bug di autenticazione". L'ha "corretto" rimuovendo l'autenticazione. Ottimo per la produttività! Terribile per letteralmente tutto il resto. Mantieni gli scope limitati, i prompt specifici e i test CI cattivi.
Da zero a PR: uno scenario end-to-end realistico
Scenario: correggere un test di debounce instabile in un progetto React
- Apri una issue: "Debounce util: flake sul confine di 200 ms in CI." La tagghi ai-pr.
- Il flusso di lavoro si attiva. Cerca debounce.ts e test correlati.
- Claude propone una diff: regola i timer con jest.useFakeTimers, aggiunge un margine negli assert, aggiorna i documenti.
- Il bot apre una PR con: titolo, riepilogo, motivazione, piano di test e valutazione del rischio.
- Rivedi la diff, respingi: "Caso limite quando delay=0."
- Commenti @claude gestisci delay=0 con flush immediato; aggiungi un test. Il flusso di lavoro viene rieseguito, esegue il push di un commit.
- I test CI superano. Esegui lo squash e il merge. Da qualche parte, un test instabile grida "zio".
Come appaiono i buoni prompt (e cosa evitare)
- Ottimo: "Aggiungi un toggle della modalità scura a SettingsPanel.tsx; rendilo persistente in localStorage; aggiorna SettingsPanel.test.tsx; segui le nostre regole ESLint; modifica solo /src/ui/ e /src/utils/; 250 righe al massimo."
- Meh: "Implementa la modalità scura."
Rendilo sicuro: controllo rapido di sicurezza e conformità
- Scope dei token: usa repo:contents write solo se necessario; preferisci pull_request write per la creazione di PR.
- Allowlist del repository: blocca il bot a un singolo repository o org.
- Logging: assicurati che il bot registri le sue azioni e i suoi prompt (meno i segreti). Vorrai delle prove quando "migliorerà" il tuo Dockerfile.
- Protezioni del branch: richiedi due approvazioni umane per i branch ai/*.
Risoluzione dei problemi: quando il bot non fa il bot
- Non riesce a eseguire il push dei branch: controlla le autorizzazioni Actions per contents: write e che il tuo token abbia accesso in scrittura al repository.
- Apre PR vuote: il tuo context builder non gli sta fornendo i file giusti. Stringi la tua logica di selezione dei file.
- Va in timeout su repository di grandi dimensioni: limita il contesto ai percorsi modificati o a un manifest. L'AI ha l'indigestione sui monorepo da 10 GB, proprio come il resto di noi.
- Ignora il tuo template di PR: conferma che il template sia in .github/pull_request_template.md o collegato nelle impostazioni del tuo repository.
Quando usare quale percorso
- Usa GitHub Actions se desideri un modo leggero per generare automaticamente PR da issue o commenti, con tutto che avviene in GitHub.
- Usa MCP se vuoi che Claude operi nel tuo ambiente locale o su più strumenti con controlli molto specifici.
Vale la pena notare: se desideri un rapido controllo di sanità sul flusso di lavoro o generare un prompt di base solido, Sider.AI può aiutarti a redigere template di PR e prompt di protezione e quindi iterare su di essi con frammenti di repository reali. È come avere un editor opinionato che scrive effettivamente codice. E non ruba la tua sedia da scrivania. Schemi comuni che vorrai copiare
- Etichette PR AI e CODEOWNERS: indirizza le PR ai/* a un gruppo di revisione a cui piace discutere con i robot.
- Commit passo dopo passo: chiedi a Claude di creare commit piccoli e atomici con messaggi chiari invece di un mega-commit chiamato "roba".
- Modalità test-first: fai in modo che il flusso di lavoro generi prima i test, esegua CI, quindi generi l'implementazione. È più lento. È meglio.
- Attività post-merge: aggiungi un flusso di lavoro per aprire automaticamente una issue di follow-up per documenti, feature flag o pulizia.
Un rapido controllo competitivo istintivo
- Alcune persone stanno collegando altri LLM a flussi di GitHub simili. Funzionano, ma il ragionamento sul codice e la volontà di Claude Code di dire "Non sono sicuro" possono farti risparmiare ore di tentativi. L'integrazione di GitHub Actions lo mantiene proprio dove avvengono naturalmente le revisioni e il percorso MCP è flessibile per i power user.
La checklist di configurazione in 10 minuti
- Scegli un percorso: GitHub Actions (più veloce) o MCP (più controllo).
- Crea il tuo token con scope minimi.
- Aggiungi il flusso di lavoro o configura il server MCP.
- Costruisci un context builder stretto: elenchi di file, limiti e regole.
- Aggiungi protezioni e etichette del branch.
- Testa prima su una piccola modifica. Esegui il merge. Festeggia. Dì al tuo PM che hai "scalato la produttività".
Riferimenti rapidi da tenere a portata di mano
- Documentazione di Claude Code GitHub Actions (schemi, trigger, esempi).
- Guida pratica all'integrazione e alle best practice.
- Video dimostrativo: PR generate dall'AI end to end.
- Server GitHub MCP per accesso granulare e autorizzato.
- Directory di server MCP ed esempi per ispirazione.
La conclusione di Stern
Automatizzare le PR con Claude Code non sostituirà il tuo team di ingegneri. Sostituirà le attività meno preferite del tuo team di ingegneri. Inizia con scope limitati, prompt chiari e revisioni rigorose. Lascia che il bot gestisca l'impalcatura mentre tu gestisci il pensiero. Quindi torna alle cose divertenti, come eliminare finalmente quel file utils2.ts che hai evitato perché sai che sta tenendo insieme l'app con nastro adesivo e sogni.
Ora vai a rendere il tuo futuro un po' meno scontroso. E se il bot impazzisce? Sai dove vive il pulsante Revert.
FAQ
D1: Claude Code può aprire pull request da solo?
Sì. Con GitHub Actions o una configurazione MCP, Claude Code può creare un branch, eseguire il push delle modifiche e aprire una pull request con un riepilogo e una checklist. Mantieni le autorizzazioni limitate e richiedi la revisione umana in modo che non "ottimizzi" la tua sicurezza rimuovendola.
D2: Qual è il modo più sicuro per connettere GitHub a Claude Code?
Usa token con scope minimi, allowlist di repository e protezioni del branch. Sia che tu scelga Actions o MCP, abilita i dry run e richiedi che i test vengano superati prima di unire qualsiasi pull request generata dall'AI.
D3: Come impedisco alle PR AI di toccare l'intero mio monorepo?
Limita il contesto con directory consentite e un manifest di file e limita il numero di file per esecuzione. Anche i buoni prompt aiutano: sii specifico su percorsi e limiti di dimensione.
D4: Perché le mie pull request AI sono vuote o di bassa qualità?
Il tuo context builder potrebbe fornire a Claude i file sbagliati o troppo pochi dettagli. Fornisci obiettivi chiari, vincoli e aspettative di test e considera un flusso a due passaggi: genera prima i test, quindi l'implementazione.
D5: Devo usare GitHub Actions o MCP per Claude Code?
Se desideri un'automazione rapida e nativa del repository per PR e revisioni, usa GitHub Actions. Se hai bisogno di controllo locale, strumenti personalizzati o autorizzazioni granulari, MCP ti offre più potenza, con un po' più di configurazione.
