Claude Code GitHub koppelen: zo doe je het, stap voor stap

Eerst kiezen

Claude en GitHub: vier koppelingen die op elkaar lijken

Zoek je op "claude github", dan vind je vier verschillende dingen door elkaar. Ze delen de naam, maar doen iets anders en vragen andere rechten. Kies eerst welke je nodig hebt, dan sla je de helft van de stappen over. De meeste beginners hebben genoeg aan route 1.

Waarom dit onderscheid ertoe doet

Route 1, 2 en 3 kunnen naar je repository schrijven. Route 4 leest alleen bestandsnamen en bestandsinhoud en ziet geen commits, pull requests of issues. Wil je dat Claude echt iets verandert, dan heb je Claude Code nodig. Wil je alleen een vraag stellen over code, dan is de chat-integratie de lichtste en veiligste keuze.

Voorbereiding

Wat heb je nodig om Claude Code met GitHub te koppelen?

Zet dit klaar voordat je begint. De meeste vastlopers in onze trainingen komen niet door Claude, maar door een ontbrekend recht op GitHub of een login met het verkeerde account.

Wat het kost

Lokaal werken en cloudsessies op claude.ai/code tellen mee in de limieten van je Claude-plan; voor de cloud-VM betaal je niets extra. Bij GitHub Actions betaal je twee dingen: GitHub Actions-minuten van de runner en het Claude-gebruik. Dat laatste loopt via een API-key op API-tarief, of via een token van je Claude-abonnement. Zie Wat kost Claude Code? en de abonnementen.

Werkt je team met Azure DevOps of GitLab?

Veel Nederlandse MKB-bedrijven in een Microsoft 365-omgeving hebben hun code in Azure DevOps staan. Lokaal voert Claude Code gewone git-commando's uit, dus committen en branches maken werkt met elke git-remote. De Claude GitHub App, /install-github-app en het klonen en pushen vanuit cloudsessies werken alleen met GitHub. Voor GitLab bestaat een aparte GitLab CI/CD-integratie.

Stappenplan

Claude Code GitHub koppelen in zeven stappen

Dit is route 1: Claude Code op je eigen computer, gekoppeld aan GitHub via de GitHub CLI. Elke stap zegt waarom je hem zet, zodat je weet wat je overslaat als je iets anders doet.

Twijfel je over een grote wijziging? Begin in plan mode

Druk op Shift+Tab tot onderin plan mode aan staat, of start met claude --permission-mode plan. Claude leest dan je code en stelt een plan voor, maar wijzigt nog niets. Pas als jij het plan goedkeurt, gaat hij bestanden aanpassen. Dat is de goedkoopste manier om een verkeerde aanpak te vangen.

Controle

Werkt het? Zo test je de koppeling met een eerste prompt

Test met een kleine, onschuldige taak op een eigen branch. Gaat er iets mis, dan is er niets kapot en zie je precies welke stap faalt.

De eerste prompt om te plakken

Plak dit in Claude Code, in de map van je repository:

Maak een nieuwe branch test/claude-koppeling. Voeg aan README.md onderaan een regel toe: "Getest met Claude Code op [datum van vandaag]". Commit dit met een korte beschrijving en maak daarna een pull request naar main. Merge de pull request niet. Laat me aan het eind de link naar de pull request zien.

Waar je op let

Je ziet drie dingen. Claude vraagt toestemming voordat hij een commando uitvoert dat iets wijzigt, zoals git push. Er verschijnt een link naar een nieuwe pull request op github.com. En op GitHub staat die pull request open met de branch test/claude-koppeling, niet gemerged. Zie je alle drie, dan werkt de koppeling. Sluit de pull request daarna en verwijder de branch.

Waarom de regel "merge de pull request niet" erin staat

Zonder die regel kan Claude het werk als af beschouwen zodra alles groen is. Door expliciet te zeggen wat hij niet mag, leer je jezelf meteen de gewoonte aan die verderop in Ons oordeel terugkomt: de mens beslist over de merge.

GitHub App

Claude Code GitHub Actions: @claude in issues en pull requests

Met de Claude GitHub App en een GitHub Actions-workflow reageert Claude op @claude in een issue of pull request. Hij leest de vraag, wijzigt code en opent een pull request, zonder dat iemand een terminal open heeft. De snelste installatie loopt via /install-github-app in Claude Code.

Handmatig installeren

Werkt het commando niet, of wil je zelf controle: installeer de app via github.com/apps/claude, zet het secret zelf onder Settings van je repository, en kopieer examples/claude.yml uit de claude-code-action-repository naar .github/workflows/. Een abonnementstoken maak je lokaal met claude setup-token. Druk tijdens /install-github-app op Esc om te stoppen; de afsluitmelding zegt wat al gedaan is.

Wie @claude kan aanroepen

Alleen gebruikers met schrijfrechten op de repository starten een run. Bots worden standaard geweigerd, zodat twee automatiseringen elkaar niet eindeloos aanroepen. Dat is een goede standaard: een willekeurige bezoeker van een publieke repo kan Claude dus niet aan het werk zetten.

API-key of abonnement

Met een API-key betaal je per token op API-tarief. Met CLAUDE_CODE_OAUTH_TOKEN telt het gebruik mee in je Claude-abonnement. Voor een secret dat je over meerdere repositories deelt, raadt Anthropic een API-key aan, omdat een OAuth-token vastzit aan het abonnement van de persoon die het aanmaakte. Begrens kosten met --max-turns in claude_args, een timeout op de job en GitHub-concurrency.

Let op de rechten van de app

De Claude GitHub App vraagt meer dan de Action gebruikt, onder meer schrijfrechten op Workflows en Repository hooks, omdat dezelfde app ook Code Review en auto-fix bedient. GitHub laat je geen deel accepteren. Wil je alleen Contents, Issues en Pull requests geven, dan maak je volgens de setup-gids van de action een eigen GitHub App; Code Review en auto-fix werken dan niet.

In de browser

Claude Code op het web met een GitHub-repo

Op claude.ai/code draait Claude Code in een cloud-VM van Anthropic. Claude kloont je GitHub-repo, werkt in een eigen branch en pusht die. Je laptop mag dicht; de sessie loopt door. Dit staat open voor Pro, Max en Team, en voor Enterprise met premium seats of Chat plus Claude Code-seats.

Gebruik je al gh? Dan kan het ook met /web-setup

Typ /web-setup in Claude Code (niet in je shell). Claude Code leest het token van gh, vraagt bevestiging en bewaart het versleuteld bij je Claude-account. Cloudsessies kunnen dan elke repo bereiken waar dat token bij kan, ook zonder de Claude GitHub App. Daarna start je een cloudtaak vanuit je terminal met claude --cloud "jouw taak" en haal je hem terug met claude --teleport. Op Team en Enterprise is /web-setup alleen zichtbaar als een Owner Quick setup heeft aangezet.

Wat er met je GitHub-gegevens gebeurt

In door Anthropic gehoste omgevingen komen je GitHub-credentials niet in de VM. Git-verkeer loopt via een proxy die de credentials aan de serverkant toevoegt. Organisaties met Zero Data Retention, de HIPAA-configuratie of eigen encryptiesleutels (CMEK) kunnen geen cloudsessies starten.

In de chat

De Claude GitHub-integratie in claude.ai: code lezen zonder te wijzigen

In de gewone Claude-app voeg je een GitHub-repository toe aan een gesprek of project, zodat Claude vragen over je code kan beantwoorden. Dit werkt op elk plan, ook Free. Claude leest bestandsnamen en bestandsinhoud van een branch, maar geen commits, pull requests of issues, en wijzigt niets.

Melding "Claude cannot access that resource"

Dan is de repo vrijwel zeker privé. De link in die melding opent de installatiepagina van de Claude GitHub App. Daar geef je zelf toegang tot alle of tot gekozen repositories, of je vraagt toegang aan bij de beheerders van de organisatie. Kies de repo daarna opnieuw.

Voor wie dit de beste keuze is

Een projectleider, consultant of eigenaar die wil weten hoe iets in de code werkt, zonder risico dat er iets verandert. Voeg alleen de mappen toe die je vraag raken: alles moet in het contextvenster passen.

Problemen oplossen

Claude GitHub-koppeling werkt niet: melding, oorzaak, oplossing

De meldingen hieronder komen uit de officiële documentatie. Zoek je melding op in de eerste kolom.

Ons oordeel

Ons oordeel: veilig werken met Claude Code en GitHub in een team

De koppeling zelf is in een half uur gedaan. Het verschil tussen een team dat er blij van wordt en een team dat het na een maand uitzet, zit in de afspraken eromheen. Dit adviseren we MKB-teams in onze trainingen.

Wanneer wel, wanneer niet

Wel: als er per taak iemand is die de pull request echt leest, en als je taken klein en concreet kunt omschrijven. Begin met route 1; voeg @claude pas toe als je team al gewend is aan pull requests. Niet (nog niet): als er secrets of klantdata in je repository of git-geschiedenis staan, als niemand tijd heeft om te reviewen, of als je repo comment-gestuurde automatisering heeft die infrastructuur uitrolt. Auto-fix reageert namelijk onder jouw GitHub-account en kan zulke workflows starten.

De fout die we beginners het vaakst zien maken: direct op main laten pushen

Het gaat zo: je werkt alleen, je vraagt Claude iets te fixen en je keurt "git push" goed omdat het snel moet. Het werk staat direct op main, zonder moment waarop iemand meekijkt. Publiceert je hosting automatisch vanaf main, dan staat een fout meteen live. Het probleem is niet dat Claude slechte code schrijft, maar dat je het enige controlemoment hebt weggehaald. Werk daarom altijd met een branch per taak en een pull request, ook als je alleen bent.

Zo dwing je die werkwijze af, in drie lagen

1. Op GitHub: ga naar Settings > Rulesets > New ruleset > New branch ruleset, kies je standaardbranch als doel en zet Require a pull request before merging aan, met minimaal 1 vereiste goedkeuring in een team. Block force pushes staat standaard aan. Rulesets werken op publieke repo's met GitHub Free en op privérepo's met GitHub Pro, Team of Enterprise Cloud. Dit is de enige laag die niet te omzeilen is.
2. In Claude Code: zet in .claude/settings.json een ask-regel, zodat Claude elke push eerst aan je voorlegt: "permissions": { "ask": ["Bash(git push *)"] }. Weet dat zo'n regel een anders geschreven push, zoals git -C . push, niet herkent. Daarom is laag 1 nodig.
3. In CLAUDE.md: schrijf de afspraak op, bijvoorbeeld "Werk altijd op een nieuwe branch. Push nooit naar main. Maak een pull request en merge niet zelf." Claude leest dat bestand bij elke sessie, ook in GitHub Actions.

Geen secrets in de repo, en de AVG

API-keys en tokens horen in GitHub Secrets of in een .env-bestand dat in .gitignore staat, nooit in code. Blokkeer het lezen van zo'n bestand met een Read-deny-regel, bijvoorbeeld Read(./.env). Voor de AVG geldt: zet geen klantexports, databasedumps of echte persoonsgegevens als testdata in de repository. Alles in de repo kan in een sessie terechtkomen. Lees voor de afspraken over data Claude Code en privacy, en deel op Pro of Max een cloudsessie niet als Public zonder te checken: sessies kunnen code en credentials uit privérepo's bevatten.

Een MKB-voorbeeld

Neem een installatiebedrijf met één eigen ontwikkelaar en een freelancer die samen een interne planningsapp onderhouden. Een planner meldt in een GitHub-issue dat het datumveld 31 februari accepteert. De ontwikkelaar typt eronder: "@claude voeg datumvalidatie toe aan het planningsformulier, met een test voor 31 februari en 29 februari in een schrikkeljaar". Claude opent een pull request; de ruleset dwingt af dat de freelancer hem goedkeurt voordat hij naar main gaat. Niemand hoefde een terminal te openen, en er keek toch een mens mee. Wil je dit met je team in één dag goed neerzetten, dan is dat precies wat we in de Claude Code Masterclass oefenen.

Wat nu?

Wat nu? Vervolgstappen na je Claude GitHub-koppeling

Werkt de koppeling, dan zijn dit de logische volgende stappen. Kies er één die bij je volgende klus past.

Pull requests laten reviewen

Laat Claude je pull requests nalopen voordat een collega ze leest. Dat kan lokaal met /code-review op elk plan, of met de beheerde Code Review voor Team en Enterprise. Stap voor stap in de tutorial code review.

In je editor werken

Liever diffs naast je code dan in de terminal? Volg Claude Code in VS Code. Wil je dat Claude ook issues en pull requests via een MCP-server leest, kijk dan bij een MCP-server toevoegen en in de MCP-gids.

Dieper in Claude Code

Alle commando's uit deze tutorial, zoals /install-github-app, /web-setup en /autofix-pr, staan in de commands-gids. Wat Claude Code in GitHub nog meer kan staat bij GitHub Actions in de functiegids. Wil je weten waarom een AI-agent in je repo ook een aanvalsdoel is, lees dan onze uitleg over agentjacking en het woordenboekitem prompt injection.

Meer tutorials

Een eigen site bouwen met Claude Code en via GitHub publiceren: website bouwen. Een complete set agents, skills en hooks in je repo: Everything Claude Code. Alle tutorials staan in het overzicht.