Claude Code Agency Workflow: Hoe wij projecten in 2025 aanpakken
SAMENVATTING
We runnen een headless webagency waar Claude Code 60-70% van het implementatiewerk voor zijn rekening neemt dat vroeger een heel team nodig had. Onze kosten per MVP daalden van $35.000-$50.000 naar $8.000-$15.000. Time-to-first-deploy daalde van 6-8 weken naar 10-18 dagen. Maar AI verving niet alles--het verving specifieke, goed afgebakende taken. Hier leest u wat werkt, wat niet, en waar we nog steeds mensen voor inschakelen.
Inhoudsopgave
- Waarom we onze agency rond Claude Code hebben heringericht
- Hoe ziet een Claude Code agency workflow er eigenlijk uit?
- Wat AI in onze projecten voor zijn rekening neemt
- Waar we nog steeds mensen voor inhuren
- Echte getallen: kosten per MVP en time-to-deploy
- Onze Claude Code projectopzet
- Is het bedrijf van één persoon met miljardenwaard echt?
- Wat nog niet werkt
- Hoe we nu client projecten scopen
- De wiskundige berekening van de founder: uren per week uitgesplitst
- Veelgestelde vragen
Waarom we onze agency rond Claude Code hebben heringericht
We hadden dit niet gepland. Eind 2024 waren we een webshop met 4 personen die Next.js en headless CMS werk voor $150 per uur factuurde. Tegen maart 2025, na het integreren van Claude Code--specifiek Claude 3.5 Sonnet in het begin, nu Claude 4 Sonnet--in elk project, waren twee van die rollen fundamenteel veranderd. Niet geëlimineerd. Veranderd. Eén senior developer werd een full-time AI-gestuurde engineer. De ander verschoof volledig naar codereview en architectuur.
De katalysator: een Sanity + Next.js 14 project waarbij we Claude Code gebruikten om de volledige schemaconditie op te zetten, GROQ-query's te genereren, 14 paginasjablonen op te bouwen en de deployment pipeline te schrijven. Wat 120 factureerbare uren zou zijn geweest, was klaar in 34. We keken elkaar aan en zeiden: "We moeten alles herstructureren."
Dat is de eerlijke oorsprong. Niet een grandioze strategie. Een project dat te snel klaar was.
Hoe ziet een Claude Code agency workflow er eigenlijk uit?
Hier is een typische week op een actieve client build:
Maandag: Architectuur + Kickoff
- Ik: 2 uur om de componentarchitectuur, datamodel en API-contracten te definiëren
- Ik: 1 uur om CLAUDE.md projectinstructies te schrijven (meer hierover hieronder)
- Claude Code: genereert de initiële projectopzet, installeert dependencies, configureert TypeScript strict mode, zet linting op
Dinsdag-Donderdag: Build Sprint
- Ik: 1-2 uur per dag Claude Code-output bekijken, fouten opvangen, omleiden
- Claude Code: 6-8 taken per dag--paginacomponenten, API-routes, CMS-schemadefinities, utilityfuncties, testbestanden
- Ik: architectuurpivots, complexe state management beslissingen, client Slack-threads
Vrijdag: Integratie + QA
- Ik: 3-4 uur handmatige QA, accessibility audit, performancetest
- Claude Code: fouten opfixen die in QA gevonden zijn, ontbrekende tests schrijven, documentatie genereren
- Ik: client demo voorbereiding, deployment naar staging
Totaal menselijke uren per week op een actieve build: 18-24. Omlaag van 35-45 in onze pre-AI workflow.
Wat AI in onze projecten voor zijn rekening neemt
Hier is de specifieke taakinventaris--dingen die Claude Code elke week op echte client projecten doet:
Code generatie (70-80% geautomatiseerd)
- React/Next.js componenten: Paginalay-outs, UI-componenten op basis van Figma-specs beschreven in prompts, formulierhandlers
- CMS-schema's: Sanity schema types, Contentful content models als migratiescripts, Payload CMS collection configs
- API-routes: Next.js Route Handlers, tRPC procedures, webhook endpoints
- Databasebewerkingen: Prisma schema wijzigingen, migratiebestanden, seed scripts
- TypeScript types: Types genereren uit API-antwoorden, Zod validatieschema's, gedeelde type packages
Code audits (bespaart 4-6 uur/week)
- Codebases bekijken vóór refactor projecten
- Ongebruikte dependencies, dode code, type inconsistenties identificeren
- Audit reports genereren met specifieke bestand:lijn verwijzingen
Content drafts (bespaart 3-5 uur/week)
- RFP antwoorden en technische vorstellen
- Projectdocumentatie en README bestanden
- Client-facing technische uitleg
- SOW eerste drafts (altijd door mens gereview en herschreven)
Testing (bespaart 5-8 uur/week)
- Vitest unit tests voor utilityfuncties
- Playwright e2e test scaffolds
- Test data generering en fixtures
- Edge case identificatie die we zouden missen
Waar we nog steeds mensen voor inhuren
| Taak | Waarom AI het (nog) niet kan | Wie we inhuren | Typische kosten |
|---|---|---|---|
| Brand strategie | Vereist kennis van de marktpositie van de client, concurrenten, klantpsychologie op een niveau waar AI hallucineert | Contract brand strategist | $3.000-$8.000/project |
| Copy direction | Toon, stem en overtuigingsarchitectuur hebben menselijk oordeel nodig | Freelance copywriter | $2.000-$5.000/project |
| Sales calls | Clients willen met een persoon spreken die hun bedrijf begrijpt | Wij doen dit zelf | Onze tijd |
| Visueel design | Figma werk, art direction, design systems | Contract designer | $4.000-$12.000/project |
| Complex DevOps | Kubernetes configs, multi-region deployments, CI/CD voor gereglementeerde industrieën | Contract DevOps engineer | $150-$200/uur |
| Legal review | Contracten, MSA's, IP clausules | Advocaat | $350-$500/uur |
| Accessibility audits | Geautomatiseerde tools vangen 30-40% van de problemen; echte screenreader testing heeft een mens nodig | A11y specialist | $1.500-$3.000/audit |
| User research | Met echte gebruikers spreken, feedback samenvatten | UX researcher | $100-$150/uur |
Dat zijn 8 categorieën waar mensen onmisbaar zijn.
Echte getallen: kosten per MVP en time-to-deploy
Hier zijn echte getallen uit onze laatste 6 client projecten (Q1-Q2 2025), geanonimiseerd:
| Project | Stack | Klassieke schatting | AI-ondersteunde werkelijkheid | Time-to-deploy |
|---|---|---|---|---|
| SaaS marketing site | Next.js 15 + Sanity v3 | $38.000 | $11.500 | 12 dagen |
| E-commerce storefront | Next.js 15 + Shopify Storefront API | $52.000 | $18.200 | 18 dagen |
| Portfolio/CMS voor creatief bureau | Astro 5 + Payload CMS 3.0 | $28.000 | $8.400 | 10 dagen |
| SaaS dashboard MVP | Next.js 15 + Supabase + Prisma | $45.000 | $14.800 | 16 dagen |
| Nonprofit site redesign | Next.js 14 + Contentful | $32.000 | $9.200 | 11 dagen |
| Developer docs site | Astro 5 + MDX + Algolia | $22.000 | $7.600 | 8 dagen |
"Klassieke schatting" is wat we in 2023 met onze oude teamstructuur hadden ingerekend. "AI-ondersteunde werkelijkheid" is wat de client in 2025 betaalde.
Kostenreductie: 62%. Time-to-first-deploy: 12,5 dagen.
Dit zijn allemaal projecten in onze sterke positie--headless CMS sites en Next.js applicaties. Enterprise RBAC systemen, real-time collaboratieve apps, of iets met complexe gedistribueerde systemen zou anders eruitzien.
Onze Claude Code projectopzet
Elk project begint met een CLAUDE.md bestand in de repo root. Dit is het meest impactvolle ding dat we hebben gedaan om de AI output kwaliteit te verbeteren. Hier is onze template structuur:
# Project: [Client Name]
## Tech Stack
- Framework: Next.js 15.1 (App Router)
- CMS: Sanity v3.72
- Styling: Tailwind CSS v4.0
- Language: TypeScript 5.7 (strict mode)
- Package manager: pnpm 9.x
- Node: 22 LTS
## Architecture Decisions
- All data fetching in Server Components
- Client components only for interactivity
- GROQ queries co-located with page components
- No barrel exports
- Prefer named exports
## Code Conventions
- Use `cn()` utility for conditional classes (already in lib/utils.ts)
- Error boundaries at route segment level
- All images through next/image with explicit dimensions
- Forms use react-hook-form + zod
## File Structure
[tree output of src/ directory]
## Known Constraints
- Client requires WCAG 2.2 AA
- Must support IE-- just kidding. Chrome 120+, Safari 17+, Firefox 121+
- Deploy target: Vercel (Pro plan, us-east-1)
## Do NOT
- Install new dependencies without asking
- Create files outside src/
- Use default exports (except for Next.js pages/layouts)
- Write CSS outside of Tailwind classes
Dit bestand elimineert ruwweg 40% van de "Claude is uit de rails gelopen" incidenten. Zonder het, krijg je generieke code die niet in je project patterns past. Ermee, genereert Claude Code componenten die eruitzien alsof je team ze heeft geschreven.
We gebruiken ook claude --dangerously-skip-permissions tijdens scaffold fases (nooit in production branches) en schakelen over naar de interactieve approval mode zodra we voorbij de initiële setup zijn. Kosten per project in API gebruik: typisch $40-$120 voor een volledige build, lopend op Claude 4 Sonnet.
Is het bedrijf van één persoon met miljardenwaard echt?
Nee. Maar het is een gedachte-experiment dat iets werkelijks onthult.
Evartology's stuk op Substack--"How to Run a Company Alone in 2026"--legt een indrukwekkende stack uit: AI voor engineering, marketing, sales, operations, zelfs recruiting. Het is een goed georganiseerd spelboek, en ik ben het eens met ongeveer 60% ervan. De onderdelen over AI gebruiken voor content drafts, code generatie en operationele docs matchen onze ervaring. Maar het stuk onderschat de onherleidbaarheid van vertrouwen. Clients kopen geen code. Ze kopen zekerheid dat iemand hun probleem begrijpt. Dat is iets menselijks.
Henry's stuk (henrythe9th op Substack) over een solo founder die zichzelf met AI agents "klonen" is meer gebaseerd. Het specifieke voorbeeld van AI gebruiken om customer support triage en first-draft antwoorden af te handelen resoneren--we doen iets soortgelijks met technische voorstel drafts. Maar de formulering van "klonen" oversells het. Wat eigenlijk gebeurde is taakdelegatie naar AI. Je hebt je oordeel niet gekloond. Je hebt je typing uitbesteed.
Nate's executive briefing over bedrijven van één persoon raakt het Carta data toon een groeiend percentage van solo-founder startups. Dat is echt. Carta's data van begin 2025 toonde solo incorporations trending naar boven. Maar een solo-ingekorpte bedrijf op Carta is niet hetzelfde als een solo-geëxploiteerd bedrijf. De meeste van die founders huren contractors, agencies (zoals wij) en fractional roles in. Ze zijn solo op de cap table, niet solo in praktijk.
Onze visie: de realistische versie hiervan is niet één persoon die miljard dollars doet. Het is één persoon (of een heel klein team) die $1M-$5M inkomsten maakt met 70-80% marges, werk afhandelt dat vroeger 8-12 mensen nodig had. Dat is geen fantasie. We kijken hoe het gebeurt. Maar het vereist AI competentie, domain expertise, en een bestaand professioneel netwerk. Niet gewoon een ChatGPT abonnement.
Wat nog niet werkt
1. Complexe Multi-File Refactors
Claude Code kan een enkel bestand briljant refactoren. Maar als je gecoördineerde wijzigingen in 15+ bestanden nodig hebt--zeg, een datamodel wijzigen dat API routes, componenten, types, tests en CMS schemas raakt tegelijk--verliest het coherentie rond bestand 8-10. We hebben gezien dat het breaking circular dependencies introduceert, vergeet imports bij te werken in bestanden die het eerder in de sessie aanraakte, en stilletjes bestanden overslaat. Onze workaround: refactors in 3-4 bestand batches breken en controleren tussen elk.
2. Design-to-Code van Figma
Ondanks de hype is het genereren van production-quality componenten uit Figma designs nog steeds een 60% nauwkeurigstask op zijn best. Claude Code (of enige LLM) kan uw Figma bestand niet rechtstreeks zien. U beschrijft lay-outs in woorden of plakt screenshots. De output krijgt de structuur ruwweg goed, maar mist spacing, responsive breakpoints en interaction states. We hebben nog steeds een mens om designs naar componenten om te zetten, dan gebruiken we Claude Code om varianten en states in te vullen.
3. Performance optimalisatie
Claude Code zal u vertellen om React.memo() toe te voegen en het als klaar beschouwen. Echte performance werk--identificeren van onnodige re-renders door React DevTools profiling, GROQ-query's optimaliseren door Sanity's execution plans analyseren, CLS verlagen door third-party scripts auditen--vereist menselijke observatie van runtime behavior. AI kan uw app niet profileren.
4. Productiefouten debuggen
Als iets om 2 uur 's nachts stuk gaat en de fout is een cryptische Vercel Edge Runtime timeout, kan Claude Code suggesties doen. Maar het kan niet naar uw Datadog dashboard kijken, de timing correleren met een deploy, controleren of de CDN cache is geleegd, of beseffen dat het probleem eigenlijk een DNS propagation delay is van een domeintransfer die 48 uur geleden plaatsvond. Productie debugging is context-zwaar en AI context windows zijn nog steeds te smal.
5. Alles dat visueel oordeel vereist
Is deze animatie te snel? Voelt deze kleurencombinatie goed voor een luxemerk? Is de whitespace in balans? Claude Code heeft hierover nul meningen. Vraag het niet.
6. Lange-sessie coherentie
Na ongeveer 45-60 minuten continu werk in een enkele Claude Code sessie, merken we kwaliteitsdegradatie op. Het begint patronen uit eerder in de sessie te herhalen zelfs als de context is veranderd. Het vergeet constraints uit de CLAUDE.md. We starten elke 45 minuten sessies opnieuw op als regel. Dit is een echte productiviteitstaks--waarschijnlijk 20-30 minuten re-orientatietijd per dag.
Hoe we nu client projecten scopen
Ons scoping proces veranderde fundamenteel. Hier is de voor en na:
Voor (2023)
- Discovery call (1 uur)
- Interne architectuurbespreking (2 uur)
- Gedetailleerde SOW met uurschatting per feature (4-6 uur)
- Client review cycle (1-2 weken)
- Ondertekend contract → kickoff
Na (2025)
- Discovery call (45 minuten)
- Claude Code genereert SOW eerste draft uit call notes (15 minuten prompting)
- Ik controleer en herschrijf de SOW (1 uur)
- We bouwen een wegwerp proof-of-concept van de moeilijkste technische uitdaging met Claude Code (2-3 uur)
- Scope is nu gebaseerd op echte implementatiedata, geen gissen
- Client review (3-5 dagen)
- Ondertekend contract → kickoff
Stap 4 is het cruciale verschil. We schatten vroeger "Shopify Storefront API integratie: 40 uur" op basis van ervaring. Nu bouwen we eigenlijk een ruwe versie in 2-3 uur en weten we dat het 22 uur is met AI-hulp. Onze schattingen liggen binnen 15% van werkelijkheden. Ze lagen vroeger binnen 30-40%.
Dit kost ons 3-4 uur onbetaald pre-sales werk per project. Maar onze sluitingspercentage steeg van ~35% naar ~55% omdat clients een werkend prototype zien vóór ondertekening.
De wiskundige berekening van de founder: uren per week uitgesplitst
Hier is hoe mijn week eigenlijk uitsplitst als een agency founder die Claude Code gebruikt:
| Activiteit | Uren/Week | AI-ondersteund? |
|---|---|---|
| Client calls en Slack | 6 | Nee |
| Architectuur en technische beslissingen | 5 | Gedeeltelijk (Claude Code voor research) |
| Code review van AI output | 8 | Nee |
| Claude Code sessies richten | 6 | N/A (dit IS het AI werk) |
| Business ops (invoicing, contracten, planning) | 3 | Gedeeltelijk (drafts) |
| Sales en voostellen | 3 | Gedeeltelijk (eerste drafts) |
| Handmatige QA en testing | 3 | Nee |
| Leren en huidig blijven | 2 | Nee |
| Totaal | 36 |
36 uur per week. Niet 80. Niet 20. En dat is het runnen van een agency die $60K-$80K per maand inkomsten maakt met 2 actieve client projecten tegelijk.
Pre-AI, deze zelfde output vereiste 3,5 FTE's en mijn 50-urige weken. De wiskunde is echt. Maar let op: 22 van die 36 uur zijn nog steeds volledig menselijk werk. AI elimineert werk niet. Het verandert de verhouding van denken-tot-typen.
Veelgestelde vragen
Hoeveel kost Claude Code per maand voor agency work? We geven ongeveer $180-$300 per maand uit aan Claude API-gebruik voor Claude Code in alle projecten. Dit is op het Claude 4 Sonnet model. Individuele project kosten variëren van $40-$120 afhankelijk van scope en sessie aantal.
Kan Claude Code een junior developer vervangen? Het vervangt de output van een junior developer maar niet de rol. Iemand moet nog steeds de AI richten, controleren en corrigeren. Die iemand heeft senioren-level oordeel nodig. AI-gegenereerde code zonder expert review verzendt bugs sneller.
Welke CMS past het beste bij een Claude Code workflow? Sanity v3, omdat de schemadefinities TypeScript bestanden zijn die Claude Code uitzonderlijk goed genereert. Payload CMS 3.0 is een dicht tweede. Contentful werkt maar de management API is complexer voor AI om betrouwbaar mee te werken.
Werkt Claude Code voor mobile app development? We hebben het gebruikt voor React Native (Expo SDK 52) projecten met redelijke resultaten voor component generering en navigation setup. Het worstelt meer met native module configuratie en platform-specifieke debugging. Ruwweg 40-50% productiviteitsversterkking versus 60-70% voor web projecten.
Hoe gaan jullie om met client IP-zorgen met AI-gegenereerde code? Onze MSA bevat een clausule die stelt dat alle deliverables origineel werkproduct zijn ongeacht de gebruikte tooling. Anthropic's voorwaarden (per juni 2025) verlenen gebruikers rechten op outputs. We sturen geen client proprietary data naar de API--alleen code patronen en generieke implementaties.
Wat gebeurt er als Claude Code incorrecte code genereert? Het gebeurt op ruwweg 15-20% van de taken. Onze workflow houdt hier rekening mee met verplichte menselijke codereview op elke PR. Veelvoorkomende foutmodi: incorrecte TypeScript generics, verouderde API patronen uit trainingsdata en ontbrekende error handling voor edge cases. We budgetten review tijd in elk raming.