In Weg met de GUI schreef ik wat Claude Code thuis allemaal voor me doet. Een paar mensen vroegen hoe je daaraan begint. Dit is de checklist die ik zelf zou volgen als ik opnieuw moest starten.

Het idee: Claude Code draait op een computer die altijd aan staat (een Mac mini is ideaal, maar een Linux-server of Windows-pc kan ook) en beheert van daaruit de rest. Alles wat Claude bouwt of bijleert, komt in GitHub terecht. Zo gaat niets verloren en begint geen enkele sessie bij nul.

Elke stap heeft twee delen. Zelf doe je met de hand: accounts, aanmeldingen, wachtwoorden. Vraag aan Claude staat in een codeveld: kopieer het en plak het in Claude, in het tabblad Code van de app. Claude voert het uit, test het en schrijft op wat het deed.

1. Accounts en app

Zelf

• Claude Pro nemen op claude.ai (Claude Code zit erin)
• De Claude-app installeren via claude.ai/download (Mac en Windows), aanmelden, het tabblad Code openen en de thuismap kiezen. Op Linux: Claude Code in de terminal (curl -fsSL https://claude.ai/install.sh | bash, daarna claude).
• Een account maken op github.com
• Een account maken op tailscale.com (aanmelden met GitHub kan)
• Tailscale installeren op gsm en laptop

2. De computer als server

Vraag aan Claude

Installeer git en de GitHub-CLI (Mac: via Homebrew; Windows: via winget; Linux: via de pakketbeheerder), en meld aan bij GitHub.

Laat de computer nooit slapen en automatisch herstarten na een stroompanne.

Zet SSH aan (Mac: Extern inloggen; Windows: de OpenSSH-server; Linux: openssh-server) en, op Mac en Windows, automatisch aanmelden.

3. Een extern geheugen in GitHub

Claude vergeet alles na een sessie, tenzij het ergens opgeschreven staat. Daarvoor dient een privé-repo in GitHub: het extern geheugen.

Vraag aan Claude

Maak een privé-repo claude-geheugen in ~/repos, met globaal.md, README.md (index) en todo.md.

Zet in ~/.claude/CLAUDE.md enkel de regel @~/repos/claude-geheugen/globaal.md.

Claude leest ~/.claude/CLAUDE.md bij elke start. Dat bestand staat in de gebruikersmap van deze computer en wordt niet gesynchroniseerd: op een andere computer staat het er niet, of staat er iets anders in. Daarom bevat het enkel een verwijzing. De @ laat Claude het bestand uit de repo inlezen alsof het er zelf in stond. De echte inhoud staat in GitHub, met versiebeheer, en is voor Claude op elke computer beschikbaar: repo clonen, dezelfde regel zetten, klaar.

Zet deze werkregels in globaal.md:
- antwoord in het Nederlands
- lees eerst README.md en open enkel het relevante bestand
- schrijf nieuwe kennis bij in de repo (één bestand per onderwerp), werk de index bij, commit en push zelf
- geen auto-memory; to-do's enkel in todo.md
- maak eerst een kopie vóór je iets wist of overschrijft
- elk nieuw gepland script krijgt meteen een push-monitor in Uptime Kuma

Controle

Start een nieuwe sessie en vraag:

Wat weet je over mij?

4. Tailscale

Tailscale is de ruggengraat van alles wat volgt. Zonder Tailscale bereikt Claude enkel de toestellen in hetzelfde thuisnetwerk. Met Tailscale hangen al je toestellen in één privénetwerk, waar ze ook staan: de computer thuis, de NAS, Home Assistant, een tweede huis, je laptop en gsm onderweg. Eén toestel per locatie kan als subnet-router het hele lokale netwerk daar doorgeven, zodat Claude ook routers en toestellen bereikt waar zelf geen Tailscale op kan.

Vraag aan Claude

Installeer Tailscale op deze computer.

Aanmelden doe je zelf.

Test of de laptop deze computer bereikt via Tailscale en SSH.

Zet op elke andere locatie een toestel in als subnet-router, zodat het hele netwerk daar bereikbaar is.

Zet een overzicht van alle toestellen, namen en netwerken in het geheugen.

5. Docker

Docker draait programma’s in containers: afgesloten pakketjes met het programma en alles wat het nodig heeft. Een container installeer je niet, je start hem. Hij botst niet met de rest van het systeem, en weggooien laat niets achter. Wat een container moet bewaren (instellingen, databank, bestanden), komt in een gewone map ernaast.

Zo draait thuis zowat alles: Jellyfin voor films en series, Immich voor de foto’s, Vaultwarden voor de wachtwoorden, Uptime Kuma als bewaking (stap 6), en een container met rclone die elke nacht de back-ups maakt (stap 7). Per dienst één compose.yml van een paar regels, en Claude schrijft die. Bijwerken, verhuizen naar een andere computer of terugzetten na een crash gaat daardoor in een paar minuten.

Docker werkt overal, maar wordt op elk systeem anders geïnstalleerd:

• Mac: Colima, een lichte achtergronddienst zonder Docker Desktop
• Linux: Docker Engine, rechtstreeks, zonder extra laag
• Windows: Docker Desktop, op WSL2

Vraag aan Claude

Installeer Docker op de manier die past bij dit systeem, met autostart bij het opstarten.

Noteer in het geheugen: elke container in een compose.yml in git, nooit een losse docker run.

6. Uptime Kuma

Eén overzicht van alles wat moet draaien, met een melding zodra iets stilvalt.

Uptime Kuma controleert om de zoveel minuten of alles nog leeft. Diensten zoals Jellyfin, Immich of Home Assistant: antwoordt de webpagina nog? Servers, NAS en routers: reageren ze nog op het netwerk? Websites: zijn ze bereikbaar en is het certificaat nog geldig? Scripts werken omgekeerd: zij melden zich zelf na elke run bij Kuma (stap 7), en blijft dat signaal weg, dan weet Kuma dat er iets mis is.

Valt iets uit, dan komt er een melding op de gsm of in de mail. Zo merk je een stilgevallen back-up of een NAS die niet meer opstartte dezelfde dag, en niet pas wanneer je hem nodig hebt.

Vraag aan Claude

Installeer Uptime Kuma in Docker, met de compose in een repo ~/repos/docker.

Aanmelden doe je zelf, op http://<computer>:3001.

Stel meldingen in naar gsm of mail.

Maak monitors voor de websites en toestellen.

7. Scripts en back-ups met rclone

rclone kopieert en synchroniseert naar zowat elke cloud: pCloud, Google Drive, OneDrive, Dropbox of een NAS. Je hoeft het niet zelf te leren. In gewone taal werk je met Claude een volledige back-upstrategie uit: wat moet beschermd worden (foto’s, documenten, de configuratie van Home Assistant, databanken), waarheen, hoe vaak, versleuteld of niet, en hoe lang oude versies bewaard blijven. Met versioning blijven gewiste of overschreven bestanden nog een tijd terug te halen, ook na een vergissing of ransomware.

Claude schrijft de scripts, plant ze en zet ze in git. Elk script meldt zich na afloop bij Uptime Kuma. Mislukt het, dan krijg je een melding. Draait het niet (computer uit, container weg), dan blijft het signaal weg en krijg je ook een melding.

Vraag aan Claude

Maak een privé-repo ~/repos/scripts met één container scripts (rclone en cron) die alle geplande scripts draait. Wachtwoorden en logs blijven buiten git.

Koppel rclone aan de cloud.

Aanmelden doe je zelf.

Werk een back-upstrategie uit: wat, waarheen, hoe vaak, met hoeveel versies. Schrijf ze in het geheugen.

Maak de back-upscripts volgens die strategie, te beginnen met een nachtelijke back-up van de map Documenten met versioning.

Maak voor elk script een push-monitor in Kuma, met als naam <scriptnaam> (<tijdstip>), een interval van 25 uur en een beschrijving. Zet de push op het einde van het script.

Test het script met de hand en toon de log.

Laat het script eens mislukken en controleer of de melding binnenkomt.

8. Toegang tot andere systemen

Sleutels maak je zelf aan in de webinterface, met zo weinig mogelijk rechten. Ze komen in een bestand op de computer (~/.config/<dienst>/api_key, enkel leesbaar voor de eigenaar), nooit in git en nooit in de chat. In het geheugen staat enkel waar een sleutel ligt.

Vraag aan Claude

Noteer deze afspraak in het geheugen en maak een SSH-sleutel voor deze computer.

Home Assistant

Home Assistant is waar Claude het meest tovert. Een dashboard bouwen was vroeger avonden schuiven met kaarten en YAML. Nu beschrijf je wat je wil zien, en Claude zet het neer: per ruimte, met passende iconen en kleuren, op gsm en tablet. Bevalt het niet, dan zeg je wat er anders moet.

Met automations gaat het net zo. Je zegt in gewone taal wat er moet gebeuren, Claude zoekt de juiste sensoren, schrijft de automation, test ze en legt uit wat ze doet.

En het handwerk van vroeger gebeurt nu in een flits. Honderd entities met namen als sensor.0x00158d0001a2b3c4_temperature hernoemen naar iets leesbaars, ze in de juiste ruimte zetten, oude en dubbele entities opruimen: dat is één zin en een paar minuten wachten.

Zelf

• Profiel → Beveiliging → een token met lange levensduur maken
• De add-on Advanced SSH & Web Terminal installeren

Vraag aan Claude

Bewaar het token veilig en test de verbinding met de API van Home Assistant.

Stel SSH-toegang met een sleutel (zonder wachtwoord) in en zet de configuratie in een privé-repo.

Hernoem alle entities naar een duidelijke Nederlandse naam en zet ze in de juiste ruimte. Toon eerst de lijst.

Maak een dashboard voor de gsm met per ruimte de temperatuur, de lichten en wat er openstaat.

Doe het licht in de gang aan bij beweging na zonsondergang, behalve 's nachts.

DNS (NextDNS, Cloudflare, …)

Zelf

• Een API-sleutel maken. NextDNS: Account → API. Cloudflare: een API-token met enkel rechten op het eigen domein.

Vraag aan Claude

Bewaar de sleutel, lees de DNS-instellingen uit en beschrijf ze in het geheugen.

Daarna volstaat een zin als “blokkeer dit domein” of “voeg dit record toe”.

Router: UniFi

Zelf

• In UniFi Network bij de instellingen een API-sleutel maken (het menu verschilt per firmwareversie). Voor meerdere locaties kan ook een sleutel op unifi.ui.com.

Vraag aan Claude

Test de UniFi-API en beschrijf het netwerk (toestellen, vaste adressen, netwerken) in het geheugen.

Router: TP-Link Deco

Deco heeft geen officiële API, maar wel een lokale webinterface die met het beheerderswachtwoord uit te lezen is, bijvoorbeeld met de Python-bibliotheek tplinkrouterc6u. Zo zijn de nodes, alle toestellen, IP-adressen, het signaal tussen de nodes en de kanalen zichtbaar. Clients hernoemen en sommige wifi-instellingen lukken niet langs die weg: dat blijft werk voor de Deco-app.

Zelf

• Het wachtwoord van de lokale webinterface van de Deco opzoeken (meestal dat van het TP-Link-account)

Vraag aan Claude

Bewaar het wachtwoord veilig en maak een script dat de Deco uitleest (nodes, toestellen, signaal, kanalen).

Beschrijf het netwerk in het geheugen: welke node waar staat, welke toestellen een vast adres nodig hebben, wat de zwakke plekken zijn.

Tailscale

Zelf

• In de admin-console een API-sleutel maken (die vervalt na hoogstens 90 dagen)

Vraag aan Claude

Bewaar de sleutel en zet een overzicht van alle toestellen in het geheugen.

9. Een eigen startpagina

Een belangrijke tip: laat Claude een privé-startpagina voor je maken, met al je diensten en adressen op één plek: Home Assistant, Kuma, de NAS, de routers, Jellyfin, Immich, maar ook de websites die je dagelijks gebruikt. De pagina staat in een eigen repo in GitHub en wordt gepubliceerd achter een wachtwoord. Zet ze in elke browser als openingspagina, op de computer, de laptop en de gsm. Zo heb je overal dezelfde bladwijzers, zonder ze te synchroniseren. Een nieuwe dienst erbij? Eén zin aan Claude, en ze staat overal.

Vraag aan Claude

Maak een privé-repo ~/repos/startpagina met een eenvoudige startpagina: per groep tegels met icoon, naam en link naar al mijn diensten en adressen. Haal de lijst uit het geheugen.

Publiceer de startpagina achter een wachtwoord (bv. Cloudflare Pages met Cloudflare Access) en zet de werkwijze in het geheugen.

10. Gewoontes

• Een sessie starten in de juiste map en zeggen wat je wil, niet hoe
• Na elk stuk werk vragen: “Staat alles in git?”
• Wachtwoorden en tokens zelf invullen, nooit in de chat plakken

Daarna

• Versleutelde back-ups met oude versies; twee clouds, of een cloud en een NAS, gelijk houden
• Eigen diensten in Docker: Immich (foto’s), Jellyfin (films en series), Vaultwarden (wachtwoorden), Home Assistant
• Alles van overal bereikbaar via Tailscale, zonder open poorten
• Eén overzicht in Kuma, met een melding op de gsm zodra iets stilvalt
• Een nieuwe computer? Vraag Claude om alles uit GitHub terug te zetten, en het weet alles weer.