App maken met Claude Code: tutorial voor iPhone

Een app maken met Claude Code: het korte antwoord

Om een app te maken met Claude Code heb je betaalde toegang tot Claude Code nodig (een geschikt abonnement of de Console met betalen per gebruik), Node.js, een iPhone met Expo Go en een Expo-project. Je schrijft een CLAUDE.md-bestand dat je stack en je regels beschrijft, je vraagt om één scherm tegelijk, je test elk scherm op je iPhone en daarna stuur je de app met EAS naar TestFlight.

Deze tutorial vult mijn gids een iOS-app maken met AI aan, waarin ik uitleg wat AI goed doet en wat ze mist. Hier gaan we aan de slag: de commando's, de bestanden, de prompts.

Ik codeer mijn iOS-apps elke dag met Claude Code en Cursor. Mijn stack: React Native, Expo, EAS, RevenueCat en Supabase. Solys, een wekker met minigames, en TradaZen, een app om trading te oefenen, staan in de App Store. Nolera en Clic zijn door Apple afgewezen en daarna gecorrigeerd. Alles hieronder komt uit dat werk.

Wil je deze methode toegepast zien op een gepubliceerde app? Ik heb het traject van TradaZen gedocumenteerd, van de eerste commit tot de afwijzingen door Apple en de pivots. Die ervaring vult de stappen van deze tutorial aan.

Stap 1: zorg dat je alles klaar hebt

Check voor het eerste commando of je dit allemaal hebt.

Een betaald Claude-account

Claude Code zit niet in het gratis abonnement van claude.ai. Volgens de documentatie van Anthropic heb je een Pro-, Max-, Team-, Enterprise- of Console-account nodig. Met Pro kun je beginnen, binnen de gebruikslimieten.

Node.js en een terminal

Expo vraagt om Node.js in een LTS-versie, op macOS, Windows of Linux. Claude Code draait op macOS 13 of hoger, Windows 10 of hoger en de belangrijkste Linux-distributies.

Een iPhone en Expo Go

Installeer Expo Go uit de App Store op je iPhone, zodat je je eerste schermen kunt proberen zonder je eigen app te compileren. Check voordat je het project aanmaakt op de Expo Go-pagina welke SDK-versie compatibel is met jouw installatie. De nieuwste SDK en de versie in de App Store zijn niet altijd tegelijk beschikbaar: Expo heeft die vertraging in mei 2026 bijvoorbeeld gedocumenteerd. Ga dus niet uit van een versienummer uit een oude tutorial. Wil je je eigen native modules gebruiken, reken dan op een development build.

Een Mac? Niet verplicht

iOS-builds worden met EAS Build op de servers van Expo gecompileerd, met de Xcode-versie die je Expo SDK kiest (ITMS-90725), en EAS Submit werkt op macOS, Linux en Windows. Je kunt dus vanaf een pc tot aan TestFlight komen. De gids een iOS-app publiceren zonder Mac beschrijft die keten in detail.

Een Apple Developer-account, later

Om te coderen en te testen in de Expo Go uit de App Store heb je die niet nodig. Hij wordt verplicht zodra je je app naar TestFlight stuurt. Daar komen we op terug in stap 7.

Stap 2: Claude Code installeren

Op macOS, Linux of WSL raadt Anthropic de native installer aan:

curl -fsSL https://claude.ai/install.sh | bash

Op Windows, in PowerShell:

irm https://claude.ai/install.ps1 | iex

Check daarna of de installatie gelukt is:

claude --version

Werk je liever met npm, dan is het commando npm install -g @anthropic-ai/claude-code. Zet er geen sudo voor, de documentatie raadt dat uitdrukkelijk af.

Als je claude voor het eerst start, opent er een browser om in te loggen op je account. Daarna schrijf je gewoon in het Nederlands: Claude leest je bestanden, stelt wijzigingen voor en voert commando's uit, met jouw toestemming.

Stap 3: het Expo-project aanmaken

Ga naar de map waar je je projecten bewaart en voer uit:

npx create-expo-app@latest mijn-app
cd mijn-app
npx expo start

Laat de tool je kiezen tussen compatibiliteit met de Expo Go uit de App Store en de nieuwste SDK, kies dan voor deze oefening de compatibiliteit. Check in elk geval of de aangemaakte versie ondersteund wordt door de Expo Go op je iPhone voordat je verdergaat. Een development build kun je klaarzetten zodra je project die nodig heeft.

Er verschijnt een QR-code in de terminal. Scan die met de camera van je iPhone: de app opent in Expo Go. Eén detail gaat de eerste keer vaak mis: Expo Go opent je project alleen als Expo CLI en Expo Go met hetzelfde Expo-account verbonden zijn. Voer npx expo login uit op je computer en log in de app in met hetzelfde account.

Waarom Expo en niet Swift? Claude kent React Native heel goed, en je test zonder Mac. Ik leg die keuze uit op de pagina React Native en Expo voor een mobiele app.

Houd één beperking van Expo Go in je achterhoofd: het bevat alleen de native modules die er al in zitten. Zodra je een native library toevoegt die het niet kent, bijvoorbeeld voor in-app aankopen, heb je een development build nodig. Voor de eerste schermen is dat geen probleem.

De juiste testomgeving kiezen

Expo Go, een development build en TestFlight bewijzen niet hetzelfde. Expo beschrijft de development build als je eigen test-app, met de native modules die je project nodig heeft.

Wat je wilt controleren	Waar je test	Wat de test niet bewijst
Een eerste scherm tonen en de navigatie proberen	Expo Go, met een compatibele SDK	Het gedrag van native modules die niet in Expo Go zitten
Een native library gebruiken die je aan het project toevoegde	Een development build met die library	De gedistribueerde versie of de goedkeuring door Apple
De app voor testers doorlopen en daarna de aankopen testen	Een build op TestFlight met correct geconfigureerde producten	Een echte betaling van een klant of de goedkeuring voor verkoop

Vraag Claude voordat je een dependency toevoegt: "Is die compatibel met mijn SDK en mijn huidige testomgeving? Moet de app opnieuw gecompileerd worden? Onderbouw je antwoord met de documentatie." Zo voorkom je dat je een avond kwijt bent aan een module die Expo Go simpelweg niet kan laden, of aan een SDK die bij het uploaden geweigerd wordt vanwege een niet-publieke API.

Stap 4: het CLAUDE.md-bestand van het project schrijven

Dit is de stap die het meeste oplevert. Claude Code kan een projectgeheugen bijhouden, maar je moet de regels expliciet maken. Het bestand CLAUDE.md, in de root van het project, geeft instructies die voor alle sessies gelden. Daar schrijf je op wat Claude niet kan raden.

Start in de projectmap claude en typ /init. Volgens de documentatie analyseert Claude het project en genereert een eerste CLAUDE.md met de commando's en conventies die hij vindt. Daarna vul je die aan met je eigen regels. Anthropic raadt aan onder de 200 regels te blijven: hoe langer het bestand, hoe minder de instructies worden opgevolgd.

Hier een kort voorbeeld, vergelijkbaar met wat ik gebruik:

# Mijn app

## Stack

- Expo (SDK van create-expo-app), React Native, TypeScript strict
- Navigatie: Expo Router, één bestand per scherm in app/
- Data: Supabase (later), nooit een geheime sleutel in de app

## Regels

- Eén scherm tegelijk. Raak geen bestanden aan buiten de vraag.
- Geen vaste hoogtes in punten: groottes relatief aan het scherm,
  ScrollView als de inhoud kan overlopen.
- Elk scherm heeft 3 toestanden: laden, leeg, fout.
- Interfaceteksten in het Nederlands, met correcte spelling.
- Voordat je meer dan 2 bestanden codeert: stel een plan voor en wacht op mijn akkoord.

## Commando's

- Starten: npx expo start
- Tests: gebruik het script dat echt in package.json staat.
  Bestaat het nog niet, meld dat dan; meld geen geslaagde tests.
- Types: npx tsc --noEmit
- Na elke wijziging: voer de tests en types uit en vertel me dan
  wat er veranderd is en hoe ik het op de iPhone controleer.

De regel over vaste hoogtes staat er niet voor niets. Daar komen we op terug in stap 6.

Stap 5: één scherm tegelijk prompten

"Maak een app om gewoontes bij te houden, met abonnement" levert een enorm, fragiel project op dat niet na te lezen is. De methode die werkt is precies andersom: één vraag, één scherm, één resultaat dat je in vijf minuten kunt testen.

Begin met een plan

Voor alles wat meerdere bestanden raakt, schakel je naar plan mode. Druk op Shift+Tab tot je plan mode on in de statusbalk ziet. In deze modus leest Claude de bestanden en stelt een plan voor, maar verandert niets zonder jouw akkoord. Je leest het, je corrigeert het en dan keur je het goed.

Een eerste prompt om de kaders te zetten ziet er zo uit:

Ik wil een app om gewoontes bij te houden. Versie 1: één functie,
de gewoontes van vandaag afvinken. Stel de lijst met schermen en de
mappenstructuur voor. Codeer nog niets.

Beschrijf het scherm, de toestanden en de grenzen

Daarna één prompt per scherm. Hoe meer randgevallen je noemt, hoe minder Claude ze vergeet:

Maak het scherm app/index.tsx dat de gewoontes van vandaag toont.
- Elke regel: naam van de gewoonte, vinkje, huidige reeks.
- Lege toestand: een tekst en een knop "Gewoonte toevoegen".
- Laadtoestand en fouttoestand met een knop "Opnieuw proberen".
- De data komt voorlopig uit een lokale array.
- Moet passen op een iPhone SE en op de grootste iPhone:
  geen vaste hoogte, de lijst scrolt.
Voer aan het eind de tests en types uit.

Corrigeer zonder alles te laten herschrijven

Klopt een detail niet, wees dan precies en beperk de reikwijdte:

Op mijn iPhone verdwijnt de knop "Gewoonte toevoegen" onder de onderste
balk als de lijst lang is. Los alleen dit probleem op in app/index.tsx,
zonder andere bestanden aan te raken. Leg de oorzaak uit.

Je kunt ook een screenshot in de terminal plakken: Claude leest hem.

Oefening: een gewoonte die afgevinkt blijft na herstarten

Dit is een leeroefening om in je eigen project te doen, geen screenshot van een functie die al af is. Het doel is van een gegenereerd scherm naar controleerbaar gedrag te gaan. Je hebt er geen gebruikersaccount of in-app aankoop voor nodig.

1. Houd één lokale gewoonte aan met de naam "10 minuten lezen".
2. Vraag om een vinkje en lokale opslag die compatibel is met je Expo-project.
3. Vraag de agent om de gewijzigde bestanden, de eventuele dependency en de echt uitgevoerde commando's te noemen.
4. Installeer of open je app op de iPhone en doe daarna de controles hieronder.

Maak op basis van het bestaande scherm de gewoonte "10 minuten lezen"
afvinkbaar en bewaar de toestand na het sluiten en heropenen van de app.
Gebruik lokale opslag die past bij de dependencies van het project.
Maak geen account, server, abonnement of extra statistieken.
Leg voor het coderen uit hoe je het laden en een mislukte lees- of
schrijfactie afhandelt. Doe daarna een beperkte wijziging.
Aan het eind: gewijzigde bestanden, uitgevoerde commando's, niet geteste
grenzen en de precieze stappen om het resultaat op iPhone te controleren.

Actie op je iPhone	Verwacht resultaat	Als het misgaat
De app voor het eerst openen	De gewoonte en het vinkje zijn zichtbaar, zonder fout	Controleer de begintoestand en het laden van de opslag
Afvinken, de app sluiten en heropenen	De gewoonte blijft afgevinkt	Controleer het schrijven en daarna lezen van dezelfde sleutel
Uitvinken en herstarten	De gewoonte blijft uitgevinkt	Controleer of de waarde false ook wordt opgeslagen
Hetzelfde doorlopen in vliegtuigmodus	De lokale functie blijft beschikbaar	Zoek een netwerk-dependency die zonder reden is toegevoegd
De tekstgrootte vergroten	De naam en het vinkje blijven bruikbaar	Haal de beperkingen weg die de actie afkappen of verbergen

Vraag niet om "alles herschrijven" als één regel mislukt. Beschrijf de actie, het verwachte resultaat en wat je ziet. Bijvoorbeeld: "Na herstarten is het vinkje weer leeg, terwijl ik het had aangevinkt. Leg de oorzaak uit en repareer de opslag zonder het design te veranderen."

Download het CLAUDE.md-sjabloon en de controlelijst (.md). Open het in je editor of een notitie-app. Pas de commando's aan je project aan voordat je het aan de agent geeft.

Stap 6: laten nalezen en testen

Claude Code schrijft code die er goed uitziet. Alleen je tests en je iPhone vertellen je of hij ook goed is.

Tests om niet te breken wat werkt

Hoe groter je app, hoe groter de kans dat elke vraag een scherm breekt dat al goedgekeurd was. Het project dat Expo aanmaakt heeft geen tests: vraag Claude eerst om Jest met jest-expo te installeren, zoals de documentatie van Expo aanraadt. Vraag daarna om tests voor de belangrijke logica (een reeks berekenen, een formulier valideren) en laat ze na elke wijziging draaien. Daarom staan de testcommando's in CLAUDE.md: Claude voert ze uit zonder dat jij hem eraan hoeft te herinneren. Met een regelbestand en tests breekt AI veel minder van wat al werkte.

Lees elke wijziging na

Je hoeft niet elke regel te begrijpen. Je moet wel weten welke bestanden veranderd zijn, en waarom. Heeft Claude een bestand aangeraakt dat er niets mee te maken heeft, vraag dan waarom voordat je het accepteert. Stel daarna de vraag: "Wat kan hier breken?"

Controleer op een kleine en een grote iPhone

Dit is de les die me het duurst is komen te staan. Solys werd door Apple afgewezen op basis van regel 2.1: de demo in de onboarding was onmogelijk te winnen op een iPad Air, waar de app in iPhone-compatibiliteitsmodus draaide. De oorzaak: hoogtes vastgezet in punten, niet relatief aan de schermgrootte. Op mijn iPhone ging alles goed. De code was nagelezen, de tests waren groen. Geen enkele tool had het scherm op een andere grootte bekeken.

Sindsdien controleer ik elk scherm minstens op de kleinste en de grootste iPhone. Heb je maar één telefoon, dan volstaat de Xcode-simulator op een Mac of een vriend met een ander model. Let vooral op lange teksten, het geopende toetsenbord bij formulieren en knoppen die onderaan vastzitten.

Waar Claude Code slecht in is

Claude Code blinkt uit in schermen en logica. Buiten je projectmap is hij veel minder betrouwbaar.

Signing en certificaten

Zonder geautoriseerde verbinding met je Apple-account weet Claude niet hoe dat ervoor staat. Hij kan een certificaatprocedure verzinnen die Xcode en Expo door elkaar haalt. Laat EAS de signing doen: de documentatie van Expo legt uit dat EAS CLI die bestanden voor je kan genereren en bewaren, nadat je bent ingelogd op je Apple Developer-account.

App Store Connect

De productpagina, de privacyverklaringen, de screenshots en de juridische links zijn gegevens die je in App Store Connect moet controleren. Claude Code kan inmiddels via zijn Chrome-integratie in een ingelogde browser handelen, met de nodige toegang. Dat garandeert niet dat de velden kloppen: lees de gegevens na, controleer welke accounts gebruikt worden en keur de verplichtingen en het indienen voor review zelf goed.

Abonnementen

Een paywall schrijven duurt tien minuten. De producten in App Store Connect, hun configuratie in RevenueCat en de code op elkaar laten aansluiten is een ander verhaal. Eén teken verschil in een identifier en de paywall blijft leeg bij de reviewer. De meest voorkomende valkuilen staan in de paywall-fouten van beginners op iOS.

Randgevallen

Zonder instructie behandelt Claude alleen het normale geval. Geen netwerk, een lege lijst, een onderbroken aankoop: die moet jij benoemen.

Supabase-beveiliging

Als Claude tabellen in Supabase aanmaakt, controleer dan of row-level security (RLS) aanstaat, met policies die elke gebruiker beperken tot zijn eigen data. Controleer ook dat er geen geheime sleutel in de code van de app belandt. Zet die twee verboden in je CLAUDE.md zodra je een database koppelt.

Stap 7: naar TestFlight met EAS

Je schermen zijn gecontroleerd in Expo Go of in een development build, afhankelijk van de modules die je gebruikt. Ga nu over naar de build die naar testers gaat.

EAS klaarzetten

Je hebt nu een betaald Apple Developer-account nodig: zoals Expo aangeeft is die verplicht om een app naar de App Store te sturen. Installeer daarna de tool van Expo en configureer het project:

npm install --global eas-cli
eas login
eas build:configure

Voeg een unieke bundle identifier toe in app.json, onder ios.bundleIdentifier, bijvoorbeeld com.jouwnaam.mijnapp.

Compileren en versturen

eas build --platform ios --profile production
eas submit --platform ios

Het eerste commando compileert de app op de servers van Expo. De eerste keer stelt EAS voor om in te loggen op je Apple-account om de certificaten aan te maken. Het tweede stuurt de build naar App Store Connect. Je kunt ook alles in één keer doen met eas build --platform ios --auto-submit.

De build moet door Apple verwerkt worden voordat hij in TestFlight verschijnt, en die verwerking kan hem weigeren, bijvoorbeeld met ITMS-90717 voor een transparant icoon. Een geslaagde upload betekent dus niet dat hij al te installeren is: controleer de status in App Store Connect. Interne en externe testers en de bètareview leg ik uit in mijn gids TestFlight om je iPhone-app te testen.

Doe de controles van stap 6 opnieuw op deze build. Een app die in Expo Go werkt kan in productie nog steeds crashen, bijvoorbeeld als er een native module ontbreekt.

Wat het echt kost

Dit zijn de prijzen die de diensten tonen, gecontroleerd op 27 september 2026, in dollars. Het gefactureerde bedrag hangt ook af van je regio, belastingen en je gebruik: check het aanbod voordat je je aanmeldt.

• Claude-abonnement: Pro kost 20 dollar per maand, of 17 dollar per maand bij jaarlijkse betaling. De Max-abonnementen beginnen bij 100 dollar per maand, voor meer gebruik.
• Apple Developer-account: 99 dollar per jaar, verplicht voor TestFlight en de App Store.
• EAS: het gratis abonnement van Expo bevat 15 iOS-builds per maand, in een wachtrij met lage prioriteit. Starter kost 19 dollar per maand, plus extra gebruik.

Voor een klein prototype kunnen Pro en het gratis EAS-abonnement een basis vormen, als je binnen hun quota blijft. Tel het Apple-account erbij op voor TestFlight en reken daarna apart de diensten door die je echt nodig hebt: database, opslag of een betaalde API. Het budgetsjabloon voor een eerste app helpt je die posten op een rij te zetten. Je tijd voor configuratie en controle moet je er ook nog bij rekenen.

De eerlijke grenzen, en waar je vastloopt

Claude Code heeft veranderd wie een iPhone-app kan maken. Het heeft niet veranderd wat Apple eist om hem te publiceren. Een afwijzing is zo binnen: Solys kreeg er een paar, Nolera en Clic ook. De meest voorkomende redenen staan in waarom Apple een app afwijst.

Met deze tutorial kom je alleen tot aan TestFlight. Waar je het vaakst vastloopt, is daarna: abonnementen koppelen, het dossier voor de reviewer voorbereiden, een afwijzing begrijpen. Voor het overzicht van het hele traject lees je de pagina een iPhone-app maken.

Voor dat deel bevat de iOS Kit de startcode van mijn apps, inclusief abonnementen, de Claude Code-skills voor elke stap en de Apple Review Kit. Het complete traject staat op de pagina Claude Code-training om een iOS-app te maken.

Loop je al vast en weet je niet waarop? De gratis diagnose vertelt je wat je echt tegenhoudt en stuurt je mijn checklist tegen afwijzingen door Apple.

Veelgestelde vragen

Kun je een iPhone-app maken met Claude Code zonder te kunnen programmeren?

Ja voor schermen en eenvoudige logica, als je elke stap naleest en test. Nee als je hoopt helemaal niets te hoeven begrijpen. Je moet een foutmelding kunnen lezen, een commando kunnen uitvoeren en kunnen controleren wat Claude heeft veranderd. Dat leer je snel door te bouwen.

Is Claude Code gratis?

Nee. Claude Code vraagt om een Pro-, Max-, Team-, Enterprise- of Console-account. Het gratis abonnement van claude.ai bevat het niet. Met Pro kun je beginnen, met gebruikslimieten die je in de gaten moet houden.

Heb je een Mac nodig om een iOS-app te maken met Claude Code?

Nee. Je codeert op elke computer, je test in Expo Go op je iPhone, en EAS compileert en verstuurt de app op de servers van Expo. Een Mac blijft handig voor de simulator, maar is niet verplicht.

Claude Code of Cursor voor een React Native-app?

Ik gebruik ze allebei, elke dag. Claude Code werkt in de terminal en voert zelf wijzigingen en tests achter elkaar uit. Cursor is een editor. De methode telt meer dan de tool: regels, één scherm tegelijk, tests.

Hoelang duurt het om een eerste app te publiceren met Claude Code?

Dat hangt af van de omvang van de app en hoeveel tijd je hebt. Een app met één functie gaat veel sneller. Het minst voorspelbare deel blijft de review van Apple.

Kan Claude Code in-app abonnementen configureren?

Hij kan de code van de paywall en RevenueCat schrijven. Met gekoppelde tools en de nodige rechten kan hij ook in de consoles aan de slag. Concludeer nooit uit de aanwezigheid van code dat de producten geconfigureerd zijn: controleer de identifiers, de prijzen en de rechten na aankoop, en test daarna de aankoop en het herstellen op TestFlight. De veelgemaakte fouten bij iOS-paywalls geven je de punten om te controleren.