Alguna vegada has intentat explicar què és una pull request al teu amic no tècnic i has vist com els seus ulls es vidrien com una cinta transportadora de Krispy Kreme? Ara imagina't dir-li que una IA no només pot entendre el teu repositori, sinó que també pot obrir PRs per tu. Benvingut al 2025, on el teu editor de codi és una mica copilot, una mica conductor del seient del darrere i, si ho configures bé, un becari bastant decent.
Aquesta guia et mostra com connectar GitHub a Claude Code i generar pull requests automàticament. Passarem de "Què?" a "Ship it" amb una configuració pas a pas, fluxos de treball del món real i uns quants sotracs a evitar. Connectaràs GitHub, permetràs que Claude Code vegi què està passant i faràs que obri i actualitzi PRs que realment puguis fusionar sense sentir que has fet un pacte amb el diable algorítmic.
Atenció: aquí veuràs dues vies principals: utilitzar la integració de GitHub Actions de Claude Code i utilitzar servidors Model Context Protocol (MCP) per donar a Claude un accés segur i limitat a les API de GitHub. Quina hauries de triar? Si vols ajuda de PR directament a GitHub, la ruta d'Actions és la millor opció. Si vols un control del repositori local i impulsat per xat amb permisos granulars, MCP és la teva eina potent.
Què estem construint
- Connectar GitHub a Claude Code de forma segura.
- Permetre que Claude analitzi el teu repositori, proposi canvis i obri PRs.
- Automatitzar revisions, etiquetes, llistes de verificació i fins i tot seguiments de commits.
- Afegir proteccions perquè no canviï el nom de tot el teu monorepositori a "final_final_v2".
Per què és important
Perquè el canvi de context és l'impost a la productivitat que ningú ha votat. Una IA que pot obrir una PR amb el mateix rigor que esperaries d'un desenvolupador junior (en un bon dia) és un autèntic estalvi de temps. No per substituir humans (calma't), sinó per substituir les parts "ugh, boilerplate" de l'enginyeria.
Via A: Generació automàtica de PRs amb Claude Code GitHub Actions
Si vius dins de GitHub tot el dia (uneix-te al club), aquesta via et proporciona un bot que pot analitzar el codi en i PRs, suggerir canvis i fins i tot obrir o actualitzar PRs, directament des del teu repositori.
Què necessitaràs
- Un repositori de GitHub que controles (o una branca que puguis trencar sense plorar).
- Accés d'administrador al repositori per configurar Actions i secrets.
- Una clau API de Claude si la teva acció o flux de treball la necessita.
Pas 1: Activa GitHub Actions al teu repositori
- Ves al teu repositori → Settings → Actions → General.
- Activa "Allow all actions and reusable workflows" (o restringeix-ho a les accions aprovades de la teva organització si els teus responsables de seguretat ja t'estan mirant de reüll).
Pas 2: Afegeix un flux de treball de Claude Code
Crea .github/workflows/claude-pr-bot.yml amb un activador basat en el teu flux de treball preferit. Aquí hi ha dos patrons comuns:
Opció 1: PRs impulsades per
- Quan obres una amb una etiqueta especial (per exemple, ai-pr), s'executa el flux de treball.
- Llegeix la indicació de la (per exemple, "Afegeix un interruptor de mode fosc"), crea una nova branca, edita fitxers mitjançant Claude, envia commits i obre una PR amb un resum detallat.
Opció 2: Edicions impulsades per comentaris en una PR existent
- Quan comentes @claude please refactor the settings modal, s'executa el flux de treball.
- Analitza el diff, proposa canvis i envia actualitzacions a la branca de la PR.
Flux de treball inicial (esbós d'alt nivell)
name: Claude PR Bot
on:
issues:
types: .
- Una guia ràpida sobre la integració i els casos d'ús t'ofereix una visió general del que és sensat automatitzar (i del que no) en equips reals.
- Si ets un aprenent visual, aquest tutorial mostra les PRs d'IA generades automàticament en acció, de principi a fi.
Via B: Connectar GitHub a Claude Code mitjançant MCP (per a usuaris avançats locals)
Si vols que Claude treballi amb el context del teu repositori local (fitxers a la teva màquina, branques amb les quals fas malabarismes, ordres en les quals confies), MCP et proporciona un pont permès. Pensa en ell com un porter per al teu repositori: decideix quines portes pot obrir Claude.
Què necessitaràs
- Claude Desktop o una integració IDE que admeti eines MCP.
- Un servidor GitHub MCP que executes localment, configurat amb un token que limiti els àmbits.
- Un (PAT) amb només els àmbits que realment necessites (per exemple, repo:status, public_repo, pull_request write).
Pas 1: Aconsegueix un servidor GitHub MCP
- Hi ha un servidor oficial de codi obert que exposa operacions selectes de l'API de GitHub (cerca , crea branques, obre PRs, etc.). És configurable, de manera que només actives el que necessites, la qual cosa també redueix la confusió de la IA i manté contenta la seguretat. Per obtenir una visió més àmplia dels servidors MCP i exemples, consulta el directori central.
Pas 2: Configura el teu client perquè es comuniqui amb el servidor
- Al teu fitxer de configuració del client (per exemple, una configuració JSON per a la teva aplicació d'IA), registra el servidor GitHub MCP, passa-li el teu token mitjançant variables d'entorn i posa a la llista blanca els repositoris permesos.
- Consell professional: posa el token al teu del sistema o a un fitxer dotenv, no al teu fitxer de configuració. No et converteixis en l'exemple admonitori en la teva propera reunió general.
Pas 3: Prova l'àrea de superfície de l'eina
- Demana a Claude que enumeri les obertes, que llegeixi un fitxer específic o que creï una branca. Verifica que no pot fer res que no hagis permès explícitament.
- Només després de comprovar la integritat de les ordres bàsiques hauries d'activar create_pull_request.
Pas 4: Permet que Claude proposi i obri una PR
- Exemple de sol·licitud: "Al repositori org/app-frontend, crea una nova branca feat/dark-toggle, implementa un interruptor de configuració per al mode fosc a SettingsPanel.tsx, actualitza les proves i obre una PR amb una llista de verificació per a QA."
- El servidor orquestra: llegeix l'estat del repositori, escriu canvis (si has configurat eines de fitxer locals), envia una branca, obre una PR amb la teva plantilla i publica un resum.
Realment: proteccions que realment necessites
- Execucions en sec de només lectura: fes que Claude produeixi un diff unificat (git diff) abans de l'accés d'escriptura. Fusiona després d'haver-ho mirat amb els teus propis ulls.
- Cossos de PR amb plantilla: inclou notes de risc, plans de prova i passos de desplegament. Fes que el bot completi la plantilla; fes que els humans la revisin.
- Regles d'etiquetatge: aplica automàticament etiquetes com ai-generated i needs-tests per mantenir les coses detectables i honestes.
- Nomenament de branques: requereix un prefix (ai/ o bot/) amb regles de protecció de branques. Els robots també necessiten uniformes.
Hora de l'anècdota: vaig demanar a una IA que "corregís l'error d'autenticació". El va "corregir" eliminant l'autenticació. Genial per a la productivitat! Terrible per a literalment tot el que no sigui això. Mantingues els àmbits estrets, les sol·licituds específiques i les proves de CI mitjanes.
De zero a PR: Un escenari realista de principi a fi
Escenari: Corregeix la prova de poc fiable en un projecte de React
- Obres una : "Debounce util: flake on 200ms boundary in CI." L'etiquetes com ai-pr.
- S'activa el flux de treball. Busca debounce.ts i proves relacionades.
- Claude proposa un diff: ajusta els temporitzadors amb jest.useFakeTimers, afegeix un marge a les afirmacions, actualitza els documents.
- El bot obre una PR amb: títol, resum, justificació, pla de prova i qualificació de risc.
- Revises el diff, respons: "Cas límit quan delay=0."
- Comentes @claude handle delay=0 with immediate flush; add test. El flux de treball torna a executar-se, envia un commit.
- CI passa. Apliques i fusiones. En algun lloc, una prova poc fiable crida "oncle".
Com són les bones sol·licituds (i què s'ha d'evitar)
- Genial: "Afegeix un interruptor de mode fosc a SettingsPanel.tsx; persisteix a localStorage; actualitza SettingsPanel.test.tsx; segueix les nostres regles d'ESLint; modifica només /src/ui/ i /src/utils/; 250 línies màxim."
- Meh: "Implementa el mode fosc."
Fes-ho segur: verificació ràpida de seguretat i compliment
- Àmbits de token: utilitza repo:contents write només si és necessari; prefereix pull_request write per a la creació de PR.
- Llista de permissos de repositoris: bloqueja el bot a un únic repositori o organització.
- Registre: assegura't que el bot registri les seves accions i sol·licituds (menys els secrets). Veuràs proves quan "millori" el teu Dockerfile.
- Proteccions de branca: requereix dues aprovacions humanes per a les branques ai/*.
Resolució de problemes: Quan el bot no vol fer de bot
- No pot enviar branques: verifica els permisos d'Actions per a contents: write i que el teu token tingui accés d'escriptura al repositori.
- Obre PRs buides: el teu constructor de context no li està donant els fitxers correctes. Ajusta la teva lògica de selecció de fitxers.
- S'esgota el temps en repositoris grans: limita el context a camins canviats o a un manifest. La IA té indigestió en monorepositoris de 10 GB, igual que la resta de nosaltres.
- Ignora la teva plantilla de PR: confirma que la plantilla està a .github/pull_request_template.md o enllaçada a la configuració del teu repositori.
Quan utilitzar cada via
- Utilitza GitHub Actions si vols una manera lleugera de generar PRs automàticament a partir d' o comentaris, amb tot passant a GitHub.
- Utilitza MCP si vols que Claude funcioni al teu entorn local o a través de diverses eines amb controls molt específics.
Val la pena assenyalar: si vols una verificació ràpida de la integritat del flux de treball o generar una sol·licitud inicial sòlida, Sider.AI et pot ajudar a redactar plantilles de PR i sol·licituds de protecció, i després iterar-hi amb fragments de repositoris reals. És com tenir un editor amb opinió que realment escriu codi. I no et roba la cadira d'escriptori. Patrons comuns que voldràs copiar
- Etiquetes de PR d'IA i CODEOWNERS: encamina les PRs ai/* a un grup de revisió que gaudeixi discutint amb robots.
- Commits pas a pas: demana a Claude que creï commits petits i atòmics amb missatges clars en lloc d'un mega-commit anomenat "coses".
- Mode de prova primer: fes que el flux de treball generi proves primer, executi CI i després generi la implementació. És més lent. És millor.
- Tasques posteriors a la fusió: afegeix un flux de treball per obrir automàticament una de seguiment per a documents, senyalitzadors de funcions o neteja.
Una verificació ràpida de la competència
- Algunes persones estan connectant altres LLMs a fluxos de GitHub similars. Funcionen, però el raonament de codi de Claude Code i la voluntat de dir "No estic segur" et poden estalviar hores d'endevinar i verificar. La integració de GitHub Actions ho manté just on passen les revisions de manera natural, i la ruta MCP és flexible per als usuaris avançats.
La llista de verificació de configuració de 10 minuts
- Tria una via: GitHub Actions (més ràpid) o MCP (més control).
- Crea el teu token amb àmbits mínims.
- Afegeix el flux de treball o configura el servidor MCP.
- Construeix un constructor de context estret: llistes de fitxers, límits i regles.
- Afegeix proteccions de branca i etiquetes.
- Prova amb un petit canvi primer. Fusiona. Celebra. Digues-li al teu PM que "has escalat el rendiment".
Referències ràpides per tenir a mà
- Documentació de Claude Code GitHub Actions (patrons, activadors, exemples).
- Guia pràctica de la integració i les millors pràctiques.
- Recorregut en vídeo: PRs generades per IA de principi a fi.
- Servidor GitHub MCP per a un accés granular i permès.
- Directori de servidors MCP i exemples per a la inspiració.
El resum de Stern
Automatitzar les PRs amb Claude Code no substituirà el teu equip d'enginyeria. Substituirà les tasques menys preferides del teu equip d'enginyeria. Comença amb àmbits estrets, sol·licituds clares i revisions estrictes. Permet que el bot gestioni l'andamiatge mentre tu gestiones el pensament. Després, torna a les coses divertides, com ara suprimir finalment el fitxer utils2.ts que has estat evitant perquè saps que manté l'aplicació unida amb cinta adhesiva i somnis.
Ara ves a fer que el teu jo futur estigui una mica menys malhumorat. I si el bot es torna malvat? Saps on viu el botó Revert.
PMF
P1: Pot Claude Code obrir pull requests per si sol?
Sí. Amb GitHub Actions o una configuració MCP, Claude Code pot crear una branca, enviar canvis i obrir una pull request amb un resum i una llista de verificació. Mantingues els permisos estrets i requereix una revisió humana perquè no "optimitzi" la teva seguretat eliminant-la.
P2: Quina és la manera més segura de connectar GitHub a Claude Code?
Utilitza tokens d'àmbit mínim, llistes de permissos de repositoris i proteccions de branca. Tant si tries Actions com MCP, activa les execucions en sec i requereix que les proves passin abans de fusionar qualsevol pull request generada per IA.
P3: Com puc evitar que les PRs d'IA toquin tot el meu monorepositori?
Limita el context amb directoris permesos i un manifest de fitxers i limita el nombre de fitxers per execució. Les bones sol·licituds també ajuden: sigues específic sobre els camins i els límits de mida.
P4: Per què les meves pull requests d'IA estan buides o són de baixa qualitat?
El teu constructor de context pot estar proporcionant a Claude els fitxers incorrectes o massa pocs detalls. Proporciona objectius clars, restriccions i expectatives de prova, i considera un flux de dues passades: genera les proves primer, després la implementació.
P5: Hauria d'utilitzar GitHub Actions o MCP per a Claude Code?
Si vols una automatització ràpida i nativa del repositori per a PRs i revisions, utilitza GitHub Actions. Si necessites control local, eines personalitzades o permisos granulars, MCP et proporciona més poder, amb una mica més de configuració.
