Claude Code
Mini-tutorial
Hoe je Claude Code gebruikt om 100x productiever te zijn. Complete systeemgids voor kenniswerkers.
Wie je dit leert
Iwo Szapar
Mede-oprichter van AI Maturity Index (in januari 2026 overgenomen door ISG, Nasdaq: III). Hielp meer dan 3.000 bedrijven hun manier van werken te transformeren. Te zien in de Financial Times en Forbes - en ik run mijn hele bedrijf op het systeem dat je zo gaat leren.
Referenties:
- • Meer dan 1.164 dagen dagelijks AI-gebruik
- • Meer dan 30 eigen agents in productie
- • 3 AI-gestuurde producten gebouwd
- • Adviseur voor Fortune 500-teams
Wat mij anders maakt:
- • Context engineering, geen prompttrucs
- • Een echt systeem met meer dan 30 agents (geen theorie)
- • Focus op niet-technische mensen
Hoe je deze tutorial doorloopt
Deze gids is opgebouwd uit 6 opeenvolgende fases, plus een nieuwe harness-engineering-laag voor betrouwbaar AI-werk.
Fase 1-2: Fundamenten (15 min)
Begrijp wat Claude Code is en krijg het geïnstalleerd
Fase 3-4: De kernkracht (30 min)
Progressive disclosure, hooks, agents, skills en cumulatief leren
Fase 5: Gevorderd (20 min)
MCP-integraties om je zakelijke tools te koppelen
Fase 6: Implementatie (10 min)
Je weg vooruit met kant-en-klare templates
Pro-tip: Klik op de sectietitels om uit en in te klappen. Bespaar tijd door je te richten op wat je het hardst nodig hebt.
Snelstart: je eerste 10 minuten
Wil je de magie zien voordat je de theorie leest? Kies je setup en doe dit meteen.
Installeer Claude Code (2 min)
curl -fsSL https://claude.ai/install.sh | bashOpen de terminal, authenticeer, start
claude login
claudeZeg dit (letterlijk kopiëren en plakken):
"Research the top 3 competitors in my space and
summarize their pricing models. Run them in parallel
with subagents."Kijk hoe Claude automatisch meerdere agents start
Je hebt zojuist een multi-agent-workflow uitgevoerd. Drie AI-werkers deden parallel onderzoek terwijl jij achterover leunde. Dat is het kernidee - lees nu verder om te zien hoe je er een compleet systeem omheen bouwt.
Gebruik je Claude Code al? Spring meteen naar Fase 4: Agents, skills, hooks & harnesses voor de geavanceerde orkestratiepatronen.
Begrijpen: de overstap van chat naar repository-gebaseerde AI
Intro in 30 seconden
Claude Code is een AI-coding-agent van Anthropic die werkt in je terminal, IDE, desktop-app en browser. Sessies beginnen nog steeds bij nul, maar je repository kan blijvende context meedragen via bestanden als CLAUDE.md, .claude/rules/, skills, agents en projectdocumentatie.
"Claude Code is de meest ondergewaardeerde AI-tool voor niet-technische mensen."
Drie manieren om met Claude te werken
De naamgeving is verwarrend omdat de desktop-app nu meerdere tabbladen bevat. Scheid het productoppervlak van de workflow die je wilt.
Chat-tabblad · Browser of app
Claude Chat
- • Het beste voor vragen, concepten, brainstormen
- • Geen repository-workflow nodig
- • Bestanden zijn bijlagen, geen werkend projectbrein
- • Gebruik dit als de taak eenmalig is
Het beste voor: snel denken, niet voor herbruikbare systemen
Cowork-tabblad · Desktop-app
Claude Cowork
- • Autonome achtergrond-agent in een cloud-VM
- • Goed voor langere kenniswerk-taken
- • Minder installatie dan terminal-workflows
- • Mooi startpunt als je resultaten wilt, geen infrastructuur
Het beste voor: consultants, analisten, operators
Code-tabblad, CLI, IDE, web
Claude Code (deze gids)
- • Coding-agent voor bestanden, repo's, GitHub en automatisering
- • Draait in de terminal, IDE's, desktop-app, browser, Slack en CI/CD
- • Skills, subagents, hooks, MCP, routines en achtergrondsessies
- • Het krachtigst wanneer je werk in een gestructureerde repository leeft
Het beste voor: powerusers die een herbruikbaar besturingssysteem bouwen
Je leest de gids hiervoor ↗Niet zeker? Gebruik Chat voor eenmalig denken, Cowork voor achtergrondwerk met weinig installatie en Claude Code wanneer je projectgeheugen, eigen workflows, hooks, MCP en herhaalbare systemen wilt.
Elke kenniswerker die:
- Doet terugkerend werk dat patronen volgt (rapporten, e-mails, voorstellen, content)
- Beheert lopende projecten waar context ertoe doet over weken en maanden heen
- Jongleert met meerdere tools (CRM, e-mail, agenda, analytics, contentplatforms)
- Een AI wil die slimmer wordt na verloop van tijd, in plaats van eentje die na elke chat alles vergeet
Consultants
Klantrapporten, voorstellen, frameworks
Productmanagers
PRD's, roadmaps, user stories
Marketeers
Contentkalenders, campagnes
Oprichters
Strategie, investeerdersupdates, operations
Sales & revenue
Pipeline, outreach, CRM-automatisering
Onderzoekers & analisten
Datasynthese, concurrentie-intelligentie
Niet ideaal voor:
Eenmalige vragen zonder vervolg, simpele brainstormsessies of taken die zich nooit herhalen. Daarvoor volstaat de gewone Claude-chat prima.
"Ik ben geen programmeur. Ik schrijf geen code. Dus het is ongelooflijk dat dit soort dingen beschikbaar zijn en echt kunnen gebeuren."
— Dominic, cloudconsultant • Bouwde met Claude Code een abonnementsplatform zonder enige programmeerachtergrond
Voordat we erin duiken
Zie waar je naartoe bouwt
Deze tutorial leert elk concept stap voor stap. Maar als je wilt zien hoe een compleet systeem er in de praktijk uitziet, hier is een clip van 3 minuten uit een live sessie.
Eén commando. De AI leest je e-mails, WhatsApp-berichten, taken en CRM - en vertelt je vervolgens waar je je vandaag op moet richten. Alles wat je hier ziet, leer je in de fases hieronder te bouwen.
Probleem #1: geen blijvend geheugen
Traditionele AI (ChatGPT, Claude Chat): Elk gesprek begint vanaf nul. Je legt je project meer dan 10 keer per week opnieuw uit.
Claude Code-oplossing: De repository als blijvend geheugen. Het bestand CLAUDE.md laadt bij elke sessiestart. Dev-docs (plan.md, context.md, tasks.md) voor projecten van meerdere weken.
Traditionele AI-sessie:
Session 1:
You: "I'm building a SaaS product..."
[Explain project for 10 minutes]
Session 2 (next day):
You: "Remember my SaaS product?"
AI: "What product? Please explain."
[Re-explain AGAIN]Claude Code-sessie:
Session 1:
Claude reads CLAUDE.md
"I see you're building a SaaS
product. What would you like?"
Session 2 (next day):
Claude reads CLAUDE.md
"Back to the SaaS project.
What's next?"Kernpunt: Blijvend geheugen elimineert de overhead van contextwisseling
Echte impact: Richard (managementconsultant, Australië) deed er een week over om Claude Code in zijn eentje op te zetten. Na één sessie van 2 uur met de Second Brain-templates: "Je hebt in deze call opgelost wat ik nog steeds fout deed - ik promptte het alsof het een chatbot was. Terwijl je met commando's en agents je dagelijkse workflow effectief voor je kunt laten beheren. Dat is enorm. Het geld absoluut waard, want het scheelt me drie tot vier maanden van me erdoorheen worstelen."
Probleem #2: de sequentiële flessenhals
Traditionele AI: Kan maar aan ÉÉN ding tegelijk werken. 10 bestanden analyseren? Op elk apart wachten.
Claude Code-oplossing: Subagents voeren binnen de sessie meerdere taken parallel uit. Voor onafhankelijk, langlopend werk gebruik je achtergrondsessies vanuit Claude Code op web, desktop, Slack of de Agent View.
SEQUENTIAL (ChatGPT Way):
[Agent 1: Research] → [Agent 2: Content] → [Agent 3: Analysis]
15 min 20 min 10 min
Total: 45 minutes
PARALLEL (Claude Code Way):
[Agent 1: Research] ─┐
[Agent 2: Content] ─┼─ All running simultaneously
[Agent 3: Analysis] ─┘
Total: MAX(15, 20, 10) = 20 minutes
Speedup: 45 min → 20 min = 2.25x fasterEchte impact: Een consultant analyseerde 5 concurrenten (Asana, Monday, ClickUp, Notion, Airtable). ChatGPT deed er 45 min over en voltooide er maar 3. Claude Code met subagents deed er 20 min over en voltooide alle 5 tegelijk.
Kernpunt: Achtergrond-agents maken echte parallelle verwerking mogelijk
Echte impact: Damian (AI-consultant, Zwitserland) bouwde in 2 dagen een complete social-media-contentflow - iets wat een commerciële SaaS-tool verkoopt voor honderden per maand. Zijn workflow: ideeën vastleggen → LinkedIn-stem-DNA extraheren → carrousel-PDF's genereren → posts inplannen. "Een vriend vertelde me net over deze nieuwe, supercoole oplossing die hij had gekocht. Het was precies wat ik in twee dagen met de Second Brain had gebouwd. Pure magie."
Probleem #3: de contextwisselings-belasting
Traditionele AI: Docs kopiëren → plakken → wachten. Code kopiëren → plakken → wachten. Meer dan 30 minuten verloren per sessie.
Claude Code-oplossing: MCP (Model Context Protocol) koppelt rechtstreeks aan Gmail, Agenda, CRM, Analytics. Geen geknip en geplak meer tussen apps.
Handmatig proces:
- 1. HubSpot openen
- 2. 200 webinardeelnemers exporteren
- 3. CSV downloaden
- 4. E-maillijst kopiëren
- 5. Plakken in ChatGPT
- 6. Om analyse vragen
- 7. Resultaten terugkopiëren
- 8. Uploaden naar HubSpot
Tijd: 35 minuten
MCP-proces:
- 1. "Tag de webinardeelnemers"
- 2. Claude koppelt aan HubSpot
- 3. Klaar.
Tijd: 3 minuten
Echte impact: Een Sales Ops-manager ging van 2 uur per week handmatige CRM-updates naar nul. Alles geautomatiseerd via MCP.
Probleem #4: tool-isolatie
Traditionele AI: De AI kan niet bij je echte zakelijke tools. Overal handmatige dataoverdracht.
Claude Code-oplossing: Skills activeren zichzelf op basis van trefwoorden. Hooks voeren scripts automatisch uit. Eén keer bouwen, voor altijd hergebruiken.
Traditional AI:
You: "Generate weekly sales report"
AI: "Please provide data..."
You: [Copy sales from HubSpot]
You: [Copy traffic from Analytics]
You: [Copy revenue from Stripe]
AI: [Generates report]
You: [Format manually]
You: [Send to team]
Time: 45 minutes
Claude Code with Skills:
You: "Generate weekly sales report"
Skill auto-loads:
├─ MCP: Fetch HubSpot deals
├─ MCP: Fetch GA4 traffic
├─ MCP: Fetch Stripe revenue
└─ Generate formatted report
└─ Save to reports/weekly-2025-01-11.md
Time: 2 minutesEchte impact: Een marketingmanager automatiseerde 5 weekrapporten. Ging van 3,5 uur per week naar 10 minuten per week. Dat is 21x sneller.
Wat één tool + gestructureerde context echt verving
Dit is niet theoretisch. Dit zijn echte adminpagina's die op dit moment in productie draaien.
| SaaS-categorie | Typische maandkosten | Nu ingebouwd in Second Brain |
|---|---|---|
| CRM (HubSpot/Pipedrive) | $45-100/mo | Sales-pipeline + prospect-tracking |
| E-mailmarketing (Mailchimp) | $30-60/mo | Geautomatiseerde sequenties + nieuwsbrief |
| Content-planning (Buffer) | $15-30/mo | Contentkalender + wachtrijbeheer |
| Taakbeheer (Asana/Linear) | $10-25/mo | Taak-tracking + sessie-workflow |
| Analytics-dashboard | $20-50/mo | Business intelligence + rapportage |
| Klant-afleverportaal | Maatwerk | Repository-generator + onboarding |
$120-265/mnd ervoor
$20/mnd erna (Claude Pro)
Dit is geen vergelijking tussen Claude en HubSpot. HubSpot is beter in CRM zijn. Maar voor een solopreneur of klein team dekt Claude Code + gestructureerde context 80% van waar je die tools echt voor gebruikt - tegen 10% van de kosten.
Checklist fase 1
Wil je de snelle route?
Sla 2-3 weken trial-and-error over. Alles hieronder is al kant-en-klaar gebouwd in de Second Brain.
Bekijk pakkettenInstallatie: aan de slag
Claude-abonnement of API-facturering
De meeste mensen kunnen het beste starten met een Claude Pro- of Max-abonnement voor voorspelbaar maandelijks gebruik. API-facturering is ook beschikbaar voor programmatische of teamworkflows.
Kies hoe je Claude Code gebruikt
Kies het oppervlak dat past bij je comfortniveau en besturingssysteem
Claude Code op het web
Research preview. Koppel GitHub op claude.ai/code. Draait in een door Anthropic beheerde cloud-VM.
Code-tabblad van de desktop-app
Native app voor macOS en Windows. GUI voor Claude Code met zijbalk, terminal, bestandseditor, diffs, previews en PR-monitoring.
Terminal-CLI (het krachtigst)
Volledige controle over lokale bestanden, shell, MCP, hooks, scripts, CI en automatisering.
IDE-extensie
VS Code, Cursor en IDE's uit de JetBrains-familie. Claude Code draait in je editor, naast je bestanden.
GitHub-account (optioneel maar aanbevolen)
Zie het als "Google Drive voor het brein van je AI" - het maakt een back-up van je repository en synct over apparaten heen.
Checklist fase 2
De beste manier om Claude Code te adopteren
Probeer niet het hele systeem in één keer te bouwen. De grootste fout die mensen maken is alles op dag één willen automatiseren. Dat werkt nooit.
Kies één gebruiksscenario per dag. Meer niet.
Dag 1
"Help me dit bedrijf te onderzoeken."
Dag 2
"Schrijf een LinkedIn-post voor me over X."
Dag 3
"Audit deze landingspagina."
Dag 4
"Maak een skill voor mijn weekrapport."
Beetje bij beetje vult je repo zich. Je skills, agents, rules en CLAUDE.md worden slimmer. Na een paar weken kijk je terug en besef je dat je een heel systeem hebt gebouwd - één klein stukje per keer.
Je 4-weekse adoptie-roadmap
Subagents (nul installatie nodig)
Vraag Claude Code om subagents te gebruiken voor 2-3 onafhankelijke onderzoekstaken. Let op hoe je hoofdgesprek schoon blijft terwijl de specialisten parallel werken.
Je eerste skill
Kies je meest herhaalde workflow (contentcreatie, code-review, data-analyse). Maak .claude/skills/my-workflow/SKILL.md met een heldere beschrijving en stapsgewijze instructies. Test door er natuurlijk om te vragen of /my-workflow aan te roepen, en itereer dan.
Skills + subagents gecombineerd
Voeg in je skill stappen toe die subagents gebruiken voor onderzoek. Koppel twee skills aan elkaar. Stel je CLAUDE.md in met projectcontext en voorkeuren.
Harness + MCP + gevorderd (optioneel)
Voeg plan-, test-, review- en goedkeurings-gates toe rond je belangrijkste workflows. Koppel daarna zakelijke tools via MCP. De meesten kunnen het beste de harness bouwen voordat ze meer autonomie geven.
Geheugensysteem: CLAUDE.md & repository-structuur
Opmerking: CLAUDE.md is optioneel maar sterk aanbevolen voor blijvende context. Het maakt een einde aan het telkens opnieuw uitleggen van je project.
Een speciaal Markdown-bestand dat Claude Code aan het begin van elke sessie laadt. Zie het als de handleiding van je project - maar voor de AI, niet voor mensen.
Zonder CLAUDE.md:
- • Elke sessie: "Dit is mijn project..."
- • Context meer dan 10 keer/week opnieuw uitleggen
- • Claude vergeet je voorkeuren
- • Inconsistente output
Met CLAUDE.md:
- • Claude leest het één keer per sessie
- • Direct context over je project
- • Onthoudt stijl & vereisten
- • Consistente kwaliteit
# CLAUDE.md
## Project Overview
[One sentence: What you're building]
**Mission**: [Your project's goal]
**Target Users**: [Who uses this]
## Repository Structure
- `company-brain/`: Business knowledge
- `agents/`: AI agent templates
- `data/`: Datasets and analysis
## Key Guidelines
- [Important fact #1 Claude should always know]
- [Important fact #2]
- [Important fact #3]
## Output Standards
- [How you want deliverables formatted]
- [Your writing style preferences]
## Guardrails
- [Things Claude should NEVER do]
- [Data privacy rules]Zie het in de praktijk
Hoe een echte Second Brain eruitziet op GitHub
Vergeet de theorie even. Hier is een echte Second Brain-repository met meer dan 30 agents, skills, commando's en kennisbestanden - de structuur die alles in deze tutorial laat werken.
"Ik stopte alles in CLAUDE.md - 500 regels. Claude begon de helft te negeren. Toen leerde ik over progressive disclosure en viel alles op zijn plek."
— Andrew, Product Director
De fout #1 die iedereen maakt
Mensen proppen alles in CLAUDE.md - bedrijfscontext, API-docs, stijlgidsen, gotchas, templates. Bij 500+ regels begint Claude instructies te negeren. Onderzoek toont dat het opvolgen van instructies achteruitgaat voorbij ongeveer 300 regels en ongeveer 50 regels. Meer instructies leiden paradoxaal genoeg tot slechter opvolgen van instructies.
De oplossing is progressive disclosure: houd CLAUDE.md kort (onder de 200 regels) met verwijstabellen die gedetailleerde docs op aanvraag laden. Zie het als een inhoudsopgave, geen encyclopedie.
Monolithisch (breekt bij schaal):
CLAUDE.md (972 lines)
├─ Business context (50 lines)
├─ API documentation (200 lines)
├─ Database schema (150 lines)
├─ Style guide (100 lines)
├─ Email templates (120 lines)
├─ Gotchas list (80 lines)
├─ MCP configs (150 lines)
└─ ... Claude ignores half of itGelaagd (schaalt oneindig):
CLAUDE.md (200 lines)
├─ Business context (always loaded)
├─ Tech stack (always loaded)
├─ Pointer table → docs/
├─ Critical gotchas (3-5 rules)
└─ Self-improvement protocol
.claude/docs/ (loaded on demand)
├─ api-guide.md
├─ database-ops.md
├─ email-system.md
└─ gotchas.mdDe drie lagen
Laag 1: CLAUDE.md (altijd geladen - onder de 200 regels)
Alleen universeel toepasbare context hoort hier thuis. Bedrijfscontext, tech-stack, kritieke gotchas en een verwijstabel naar al het andere.
## Architecture & Patterns
| Area | Read This File |
|-------------------|----------------------------|
| Writing API code | .claude/docs/api-guide.md |
| Database work | .claude/docs/database.md |
| Email system | docs/EMAIL_SYSTEM.md |
| Known gotchas | .claude/docs/gotchas.md |
| Troubleshooting | docs/TROUBLESHOOTING.md |
Read the relevant file BEFORE making changes
in that area.Wanneer Claude aan het e-mailsysteem moet werken, leest het CLAUDE.md, ziet de verwijzing en laadt docs/EMAIL_SYSTEM.md op aanvraag. De overige docs blijven buiten de context.
Laag 2: .claude/docs/ (op aanvraag geladen)
Gedetailleerde documentatie die Claude alleen leest wanneer het in een specifiek gebied werkt. Elk bestand begint met een "wanneer lezen"-trigger.
# API Development Guide
> When to read: Before writing or modifying
> any API endpoint
## Pattern: Legacy Request/Response
All endpoints MUST use VercelRequest/
VercelResponse pattern. Web API pattern
causes 30-second timeouts.
## Required: .js Extensions
All imports in API files MUST include .js
extension. Missing extensions cause silent
build failures in production.
## Template
export default async function handler(
req: VercelRequest,
res: VercelResponse
) { ... }Laag 3: knowledge/ (agentspecifieke context)
Diepgaand referentiemateriaal dat alleen specifieke agents of skills nodig hebben. Wordt nooit in algemene sessies geladen.
.claude/knowledge/
├─ content-creator/ # Voice DNA, templates
│ ├─ brand-voice.md
│ └─ content-types.md
├─ sales/ # CRM context, scripts
│ ├─ objection-handling.md
│ └─ email-sequences.md
└─ data-analysis/ # Schema, query patterns
└─ common-queries.mdWaarom dit werkt:
Context-efficiëntie
Een slanke CLAUDE.md met verwijzingen gebruikt veel minder tokens dan één gigantisch bestand. Laat ruimte over voor het echte werk.
Beter instructies opvolgen
50 regels in een gefocust bestand verslaan 200 regels in een opgeblazen bestand. Elke keer.
Schaalt oneindig
Voeg nieuwe docs toe zonder CLAUDE.md aan te raken. Voeg gewoon een rij toe aan de verwijstabel.
Snelstart: progressive disclosure in 3 stappen
- 1. Maak de directory .claude/docs/ aan
Verplaats elke sectie die langer is dan 20 regels uit CLAUDE.md naar een eigen bestand.
- 2. Voeg een verwijstabel toe aan CLAUDE.md
Koppel elk werkgebied aan het bestand dat Claude moet lezen voordat het begint.
- 3. Voeg "wanneer lezen"-triggers toe
Begin elk docs-bestand met een trigger van één regel: "Wanneer lezen: voordat je aan [X] werkt"
Deze architectuur bouwen kost 4-6 uur
Verwijstabellen schrijven, docs organiseren met "wanneer lezen"-triggers, testen of Claude het juiste bestand op het juiste moment laadt. De Second Brain komt met meer dan 10 voorgeconfigureerde docs, triggertabellen en de volledige, gebruiksklare progressive-disclosure-architectuur.
Sla de installatie overChecklist fase 3
Automatisering: agents, skills, hooks, harnesses & leren
"Dat is het echte voordeel van Claude Code. Parallel programmeren. Je vuurt 3 onderzoeks-agents af en ze komen allemaal terug met resultaten terwijl jij op de hoofdthread blijft werken."
— Wytze, communitylid
Subagents zijn gespecialiseerde AI-werkers met geïsoleerde context. Net als een onderzoeksanalist ÉN een schrijver in je team die tegelijk werken.
Wanneer subagents gebruiken:
- ✅ Parallelle analyse (10 concurrenten tegelijk)
- ✅ Gespecialiseerde expertise nodig
- ✅ Onafhankelijke deeltaken
- ✅ Grote projecten met duidelijk gescheiden fases
Wanneer NIET gebruiken:
- ❌ Enkele, eenvoudige taken
- ❌ Sequentiële afhankelijkheden
- ❌ Taken die gedeelde context vereisen
Echt voorbeeld: concurrentieanalyse
Taak: analyseer 5 concurrenten (Asana, Monday, ClickUp, Notion, Airtable)
Sequentieel (ChatGPT): 45 minuten
Eén analyseren → volgende → volgende... 3 slecht gedaan, 2 overgeslagen door vermoeidheid
Parallel (Claude Code): 8 minuten
5 subagents draaien tegelijk. Alle 5 voltooid, hoge kwaliteit, consistent format
USER PROMPT:
"Analyze these 5 competitors: Asana, Monday, ClickUp,
Notion, Airtable. For each, analyze pricing, features,
target market."
CLAUDE CODE SPAWNS 5 SUBAGENTS:
┌─────────────────────────────────────────────┐
│ Main Claude │
│ ├─ Subagent 1: Analyze Asana │
│ ├─ Subagent 2: Analyze Monday │
│ ├─ Subagent 3: Analyze ClickUp │
│ ├─ Subagent 4: Analyze Notion │
│ └─ Subagent 5: Analyze Airtable │
│ │
│ [All run in parallel] │
│ │
│ After 8 min: Aggregate results → │
│ Generate comparison table │
└─────────────────────────────────────────────┘Realitycheck van de kosten
Subagents verbruiken hun eigen contextvensters. Een parallelle taak met 3 agents gebruikt ongeveer 3x de tokens van sequentieel werken. Agent-teams (5+ agents) kunnen 7x of meer halen. Dit is belangrijk als je per API afrekent.
| Strategie | Hoe | Besparing |
|---|---|---|
| Kleinere modellen voor werkers | Gebruik Haiku voor eenvoudige taken, Opus voor beslissingen | 60-80% |
| Beperk de scope van de agent | Beperk tools en bestandstoegang per agent | 30-50% |
| Gebruik Explore-agents om te zoeken | Alleen-lezen, snel, minimaal tokenverbruik | ~70% |
| Cache in CLAUDE.md | Sla resultaten op zodat agents niet opnieuw onderzoeken | Aanzienlijk |
| Stel max_turns in | Voorkom op hol geslagen agent-loops | Harde limiet |
Met een Claude Pro/Max-abonnement ($20-200/mnd) draaien subagents binnen je abonnementslimieten - geen extra kosten per token. API-sleutelgebruikers moeten hun verbruik zorgvuldiger in de gaten houden.
Zie het in de praktijk
Wat er echt in een agent-bestand zit
Je hebt net over agent-configuraties gelezen. Hier wordt er één live geopend - een content-creator-agent met toolingtoegang, een beslisboom, steminstellingen en verwijzingen naar kennisbestanden. Het is een tekstbestand, geen code.
"Ik merk betere content wanneer ik een centrale agent heb plus een set skills die hij zelf kan aanroepen. In plaats van dat ik elke keer de exacte workflow onthoud, zeg ik gewoon 'schrijf een LinkedIn-post' en pakt hij de juiste skill."
— Shaun, specialist marketing & growth
Agent = Model + Harness
De meeste mensen blijven het model upgraden. Powerusers upgraden de harness rond het model. Een harness is het besturingssysteem voor AI-werk: het definieert het plan, geeft de agent veilige tools, controleert de output, vraagt om review, legt lessen vast en laat het werk pas daarna uitleveren.
Het model is maar één input. De harness is al het andere: prompts, CLAUDE.md, rules, tools, MCP-servers, bestandssysteem, Git, sandboxes, hooks, subagents, contextbeleid, logs, graders, herstelpaden en release-gates. Claude Code, Cursor, Codex, Aider, Cline en Managed Agents zijn allemaal harnesses rond modellen.
De ratel: elke fout wordt een permanente reparatie
Harness engineering begint wanneer je stopt met standaard het model de schuld te geven. Als de agent een fout herhaalt, is het de taak om de harness zo te veranderen dat precies die fout de volgende keer moeilijker of onmogelijk wordt.
| Waargenomen fout | Harness-reparatie | Waar het leeft |
|---|---|---|
| Negeerde een projectconventie | Voeg een korte, verdiende regel toe | CLAUDE.md of .claude/rules/ |
| Voerde een destructief commando uit | Blokkeer het vóór uitvoering | PreToolUse-hook |
| Raakte verdwaald in een lange taak | Scheid de rollen planner, uitvoerder en reviewer | Skill + subagents |
| Eindigde met kapotte output | Voer objectieve controles uit en voer fouten terug | Verificatiehook of grader |
| Herhaalde hetzelfde zwakke concept | Voeg voorbeelden, rubriek en reviewvragen toe | Referentiebestanden van de skill |
Voeg alleen beperkingen toe wanneer ze terug te leiden zijn tot een echte fout. Verwijder ze wanneer ze achterhaald zijn. Een goede harness is een levend artefact, geen prompt-kerkhof.
1. Plan-gate
Voordat Claude handelt, moet het het doel, de aannames, de bestanden of bronnen die het aanraakt en de betekenis van "klaar" opnieuw formuleren.
2. Werkgrens
De agent krijgt alleen de tools en scope die hij nodig heeft. Alleen-lezen voor onderzoek. Goedkeuring voor het verzenden, verwijderen, publiceren of wijzigen van records.
3. Verificatie-gate
De output wordt getoetst aan objectieve criteria: bronnen geciteerd, cijfers afgestemd, checklist compleet, verplichte velden aanwezig.
4. Review-gate
Een aparte ronde zoekt naar wat de automatisering mist: verkeerde diagnose, over-engineering, niet-passende toon, verborgen aannames.
5. Cumulatie-gate
Elke fout wordt een regel, template, voorbeeld of checklistitem. Het systeem wordt beter omdat de harness leert.
6. Ship-gate
Niets verlaat het systeem totdat de artefacten voor plan, verificatie, review en goedkeuring bestaan. Claude kan voorstellen; de harness beslist.
De dragende delen van een harness
Status
Bestandssysteem, Git, taakbestanden, geheugenbestanden en outputmappen. Hier overleeft het werk voorbij het huidige contextvenster.
Tools
Bash, code-uitvoering, browserautomatisering, MCP-servers en API's. Houd tools gefocust; overlappende tools verwarren het model en blazen de context op.
Contextbeleid
Wat geladen, gecompacteerd, weggeschreven of later opgehaald wordt. Dit bepaalt wat de contextgrens van het model passeert.
Handhaving
Hooks, rechten, sandboxes, testcommando's en goedkeurings-gates. Deze maken van voorkeuren beperkingen.
Evaluatie
Rubrieken, graders, review-agents en acceptatiecriteria. Beoordeel het resultaat, niet de rare weg die de agent nam.
Observeerbaarheid
Logs, traces, tokenverbruik, kosten, latentie en fout-clusters. Een score zonder ticket is niets meer dan dashboardkunst.
Contextbeheer is harness-ontwerp
Het model kan niet nadenken over tokens die het nooit ontvangt. Wanneer het contextvenster vol raakt, moet de harness beslissen wat blijft, wat gecomprimeerd wordt, wat naar schijf gaat en wat later wordt opgehaald. Die beslissing is vaak belangrijker dan de modelkeuze.
Afkappen
Gooi output met lage waarde of oud transcript weg wanneer continuïteit er niet toe doet.
Compacteren
Vat de sessie samen en ga verder met de gecomprimeerde status.
Wegschrijven
Sla lange logs, toolresultaten en concepten op in bestanden; houd alleen de nuttige preview in de context.
Onthullen
Laad gedetailleerde docs, skills en tools alleen wanneer de taak ze echt nodig heeft.
Praktische regel: houd de altijd geladen context kort, blader met offset/limit door grote bestanden, zoek voordat je hele bestanden leest en sla lange tooloutput op schijf op in plaats van het terug in het gesprek te plakken.
Uitkomst-rubrieken: definieer hoe "klaar" eruitziet
De Managed Agents API van Anthropic maakt dit patroon expliciet: definieer een uitkomst, hang er een rubriek aan, laat een aparte grader het artefact beoordelen en voer de hiaten dan terug naar de agent voor een nieuwe iteratie. Je kunt hetzelfde idee handmatig gebruiken in Claude Code.
Outcome:
Create a competitor pricing report for the 5 named companies.
Rubric:
- Includes all 5 companies
- Every price claim has a source URL
- Pricing tiers are normalized into one table
- Unknown prices are marked "not published" instead of invented
- Final section recommends what we should change
Iteration rule:
If any rubric item fails, revise once before showing me the final.De belangrijke zet is de scheiding: de ene loop maakt het artefact, de andere beoordeelt het tegen de rubriek. Dit vermindert zelffelicitatie en spoort hiaten sneller op.
De harness-template voor de kenniswerker
1. Track
Capture the request in a task, client folder, or project log.
2. Plan
Ask Claude: "Before doing the work, give me the plan,
assumptions, sources/tools needed, and acceptance criteria."
3. Work
Let Claude execute inside clear boundaries:
read-only research, draft-only writing, no external sends.
4. Verify
Run a checklist that matches the work type:
sources, calculations, brand voice, missing fields, risks.
5. Review
Ask a second pass: "Find what is wrong, overbuilt,
unsupported, or not how we do things here."
6. Learn
Capture one reusable rule or template improvement.
7. Ship
Only publish, send, update CRM, or hand off after approval.Copy-paste-prompt: verander elke workflow in een harness
I want to turn this repeated workflow into a reliable AI harness:
[describe the workflow]
Create:
1. The planning questions Claude must answer before starting
2. The tool and permission boundaries
3. The verification checklist
4. The review questions a second pass should ask
5. The human approval points
6. The learning rule to update after each run
Keep it practical for a non-technical knowledge worker.Wekelijkse harness-audit: snijd de onzichtbare overhead weg
Als Claude trager, dommer aanvoelt of door je limieten heen vreet, audit de harness voordat je het model de schuld geeft. De meeste verspilling verstopt zich in de altijd geladen context.
| Controle | Waar te letten | Reparatie |
|---|---|---|
CLAUDE.md -grootte | Regels die er niet meer toe doen of in nauwere docs thuishoren | Houd de root-context kort; verplaats specifieke zaken naar rules, docs of skills |
| Hooks | UserPromptSubmit- of SessionStart-hooks die elke keer context injecteren | Schakel alles zonder specifieke taak uit |
| MCP-servers | Toolschema's die geladen worden voor tools die je zelden gebruikt | Houd alleen dagelijkse tools altijd actief; activeer andere per sessie |
| Skills | Brede beschrijvingen die ervoor zorgen dat irrelevante skills laden | Scherp de beschrijvingen aan of schakel ongebruikte skills uit |
| Gesprekslengte | Lange sessies die verouderde geschiedenis opnieuw lezen | Compacteer, vat samen of begin opnieuw met een overdrachtsnotitie |
Voorbeelden per rol
| Workflow | Verificatie-gate | Menselijke gate |
|---|---|---|
| Adviesrapport | Beweringen gekoppeld aan klantdata, aanbevelingen afgestemd op de scope, geen vertrouwelijke namen gelekt | De partner beoordeelt de kwaliteit van de inzichten vóór verzending |
| Sales-outreach | CRM-geschiedenis gecontroleerd, personalisatiebron geciteerd, geen verzonnen trigger-event | Jij keurt goed vóór verzending via e-mail, LinkedIn of WhatsApp |
| Financiële analyse | Totalen kloppen, aannames opgesomd, afwijkingen gemarkeerd, bronbestanden benoemd | Jij keurt de interpretatie goed vóór het delen |
| Content publiceren | Stemcontrole, verboden zinnen verwijderd, feiten met bron, CTA aanwezig | Jij keurt de definitieve versie goed vóór de wachtrij of publicatie |
Wat geen enkele harness betrouwbaar opvangt
- • Verkeerde diagnose: de verkeerde grondoorzaak oplossen
- • Over-engineering: complexiteit toevoegen waar niemand om vroeg
- • Verkeerd begrepen instructies: de aangrenzende taak doen
- • Teamnormen in de trant van "zo doen we dat hier niet"
- • Smaak, oordeelsvermogen en bestuurlijke afwegingen
- • Sociale verantwoordelijkheid voor het eindresultaat
De regel: automatiseer het typen, onderzoeken, controleren en formatteren. Houd verantwoordelijkheid, het eindoordeel en externe verplichtingen bij een mens.
"Ik ben VERLIEFD op dit nieuwe systeem. Ik deed ongeveer 10 dagen werk op één dag."
— Shaun, specialist marketing & growth • Bouwde in zijn eerste week een audio-naar-social-post-automatisering
Hier reageerden 5.475 mensen "BRAIN" op
De meeste mensen gebruiken Claude als één enkele assistent. Stel een vraag, krijg een antwoord. Maar met Claude Code kun je een heel team van specialisten bouwen dat het werk onderling doorgeeft - terwijl jij beoordeelt.
Belangrijk onderscheid: subagents vs. achtergrond-agents
Subagents zijn specialisten binnen één Claude Code-sessie. Ze hebben hun eigen context en toolrechten en rapporteren daarna terug aan de hoofdsessie. Achtergrond-agents zijn aparte cloudsessies die je beheert via Claude Code op web, desktop, Slack of de Agent View.
Gebruik subagents wanneer:
Eén hoofd-workflow meerdere gefocuste analyses, reviews of concepten parallel nodig heeft.
Gebruik achtergrond-agents wanneer:
Je onafhankelijke, langlopende sessies wilt op verschillende repo's, branches, PR's of geplande jobs.
Drie niveaus van agentcoördinatie
Niveau 1: solo-agent
Eén Claude-sessie die alles doet. Net als werken met één zeer capabele generalist. Hier stoppen de meeste mensen.
Niveau 2: delegerende lead (subagents)
Je hoofd-Claude-sessie fungeert als lead. Hij stuurt specialisten op pad om gefocust werk te doen - onderzoek, concepten, analyse - en wel parallel. Elke specialist rapporteert terug aan de lead, die de resultaten synthetiseert. Dit is productieklaar en is wat de meeste powerusers bouwen.
Niveau 3: achtergrondsessies + Agent View
Meerdere Claude Code-sessies die onafhankelijk draaien. Gebruik claude agents of de web-/desktop-oppervlakken om werk uit te zetten, te monitoren en te hervatten. Research-preview-terrein - krachtig maar nog in ontwikkeling.
Echt voorbeeld: sales-outreach-pipeline
Dit gebeurt er echt wanneer ik zeg "stel outreach op voor deze prospect":
Lead Agent orchestrates the pipeline:
│
├─ Research Agent
│ → Pulls LinkedIn profile + company intel
│ → Returns: role, company size, recent posts
│
├─ CRM Agent
│ → Checks prospect history, stage, past notes
│ → Returns: last contact, deal stage, context
│
├─ Draft Agent
│ → Writes personalized email using research
│ → Uses voice guidelines from knowledge files
│
├─ Quality Agent
│ → Scores draft against brand voice rubric
│ → Flags generic phrases, suggests improvements
│
└─ Lead Agent
→ Reviews final draft
→ I approve → sends via email MCP
5 agents. 3 minutes.
What used to take 45 minutes of tab-switching
between LinkedIn, CRM, email, and style guides.Multi-agent-review: wanneer specialisten elkaar uitdagen
Op niveau 2 loopt alle communicatie via de lead-sessie. Je kunt Claude nog steeds vragen om onafhankelijke specialistenrondes uit te voeren, hun bevindingen te vergelijken en de meningsverschillen te synthetiseren. Voor aparte, langlopende werkstromen gebruik je achtergrondsessies en de Agent View.
"Our conversion rate dropped 15% last week.
Use three specialist subagents to investigate:
- One analyzes traffic sources
- One reviews checkout funnel
- One checks pricing page changes
Then compare their findings and challenge contradictions."
What happens:
Traffic Agent: "Paid traffic quality dropped"
Checkout Agent: "But checkout completion is
stable. The issue is upstream."
Pricing Agent: "New pricing page went live
Tuesday. Bounce rate up 40%."
Traffic Agent: "That explains the drop—
the traffic was fine, the page wasn't."
→ Root cause found in minutes, not hours.De debatstructuur voorkomt verankeringsbias. Sequentieel onderzoek neigt ertoe één theorie te vinden en te stoppen. Meerdere onafhankelijke onderzoekers die elkaar uitdagen brengen het echte antwoord aan het licht.
Meer dan 30 gespecialiseerde agents bouwen met de juiste persona's, toolrechten, kennisbestanden en coördinatielogica kostte maanden aan iteratie. Elke agent moet weten waar hij bij kan, in welk format hij output moet geven en wanneer hij overdraagt aan de volgende agent. De Second Brain komt met de volledige agent-bibliotheek - voorgeconfigureerd voor contentcreatie, sales-outreach, klantbeheer, data-analyse en dagelijkse operations.
Claude Code werkt naast andere tools
De effectiefste setups zijn niet "alleen Claude Code". Powerusers combineren tools strategisch: ChatGPT voor creatief brainstormen, Claude Code voor gestructureerde uitvoering, Gemini voor review. Claude Code wordt de orkestratielaag die alles aan elkaar knoopt - niet de enige tool in je stack.
1. Brainstorm with ChatGPT (creative, divergent thinking)
2. Hand the brief to Claude Code (precise execution)
3. Review output with Gemini (catching edge cases)
4. Final polish back in Claude Code
Why: Each model has different strengths.
Claude Code orchestrates the whole thing
through skills and sub-agents.Checklist fase 4
Zo ziet een compleet systeem eruit
Meer dan 30 agents, meer dan 50 skills, meer dan 6 hooks, harness-gates, cumulatief leren, progressive disclosure, agentcoördinatie - alles geconfigureerd en in samenspel. Dit systeem kostte maanden aan iteratie. De Second Brain levert een aangepaste versie in uren.
Zie wat erbij zitIntegratie: MCP-verbindingen
MCP (Model Context Protocol) is een standaardmanier om Claude Code te koppelen aan externe tools. Zie het als USB-C voor AI - één protocol verbindt met alles.
┌─────────────────────────────────────────────┐
│ Claude Code │
│ └─ MCP Client (built-in) │
└─────────┬───────────────────────────────────┘
│
├─ MCP Server: Gmail
│ └─ Functions: send_email, search, read
│
├─ MCP Server: HubSpot
│ └─ Functions: create_contact, update_deal
│
├─ MCP Server: PostgreSQL
│ └─ Functions: query, insert, update
│
└─ MCP Server: Google Calendar
└─ Functions: create_event, list_eventsZakelijke tools
- • HubSpot (CRM)
- • Gmail
- • Google Calendar
- • Notion
- • Slack
Dev-tools
- • GitHub
- • Linear
- • PostgreSQL
- • Jira
Analytics
- • Google Analytics
- • Stripe
- • Mixpanel
Echt voorbeeld: sales-operations
Taak: 200 webinardeelnemers taggen in HubSpot
Zonder MCP: 35 minuten
- 1. Deelnemers exporteren uit Zoom
- 2. HubSpot openen
- 3. E-mails handmatig matchen
- 4. Bulkimport met tags
- 5. Fouten herstellen
Met MCP: 3 minuten
- 1. "Tag de deelnemers uit webinar.csv"
- 2. Claude koppelt aan HubSpot
- 3. Klaar.
Kernpunt: De MCP-installatie kan de grootste tijdbarrière zijn
Andrew (product director, Nederland) bouwde een geautomatiseerd systeem voor het volgen van zijn sollicitaties - LinkedIn-scraper → database → opvolgplanner. MCP-installatie in eigen beheer: 6-8 uur OAuth-debuggen. Met de Second Brain-templates: 20 minuten.
Zie het in de praktijk
Eén MCP, drie platforms, 96 seconden
Abstracte diagrammen zijn leuk. Hier is wat een MCP echt doet: één commando haalt 20 posts van elk van Reddit, X en LinkedIn - 60 datapunten geanalyseerd in minder dan 2 minuten. Geen geknip en geplak tussen tabbladen.
MCP-OAuth-debuggen duurt gemiddeld 6-8 uur
Het Done-With-You-pakket bevat een live configuratiesessie waarin we je tools voor Gmail, Calendar, CRM en database samenbrengen - plus templates die je kunt hergebruiken voor toekomstige toolverbindingen.
Bekijk Done-With-YouChecklist fase 5
Wat klanten echt bouwden (eerste maand)
Week 1: Damian (AI-consultant, Zwitserland)
Systeem voor automatisering van social-media-content. Ideeën vastleggen → LinkedIn-stem-DNA extraheren → carrousel-PDF's genereren → posts inplannen. "Een vriend vertelde me net over deze nieuwe, supercoole oplossing die hij had gekocht. Het was precies wat ik in twee dagen met de Second Brain had gebouwd."
Week 2: Andrew (product director, Nederland)
Geautomatiseerd systeem voor het volgen van sollicitaties. LinkedIn-scraper, sollicitatiedatabase, opvolgplanner. Verving een commerciële SaaS-tool waar hij maandelijks voor betaalde - gebouwd in twee dagen met de Second Brain.
Week 3: Dominic (cloudconsultant)
Geautomatiseerde wekelijkse klant-statusrapporten. Salesforce-MCP-integratie die deal-data ophaalt, Microsoft Graph voor de agenda-/e-mailcontext. Bespaarde 3 uur per week aan administratief werk.
Week 4: Richard (managementconsultant, Australië)
Na een week solo worstelen: "Je hebt in deze call opgelost wat ik nog steeds fout deed - ik promptte het alsof het een chatbot was. Terwijl je met commando's en agents je dagelijkse workflow effectief voor je kunt laten beheren. Het geld absoluut waard, want het scheelt me drie tot vier maanden van me erdoorheen worstelen."
Volgende stappen: je weg vooruit
Je hebt gezien hoe een compleet systeem eruitziet: progressive-disclosure-architectuur, afdwingbare hooks, cumulatief leren, het skills-vs-agents-framework, MCP-integraties. Dit vanaf nul bouwen kost 3-4 weken trial-and-error- bestandsstructuren debuggen, hooks schrijven, skill-triggers testen, MCP-OAuth-flows configureren, geheugenschema's ontwerpen...
Of je slaat dat allemaal over en krijgt een aangepaste versie in uren.
"Dit was een van de beste investeringen voor mij en mijn bedrijf. Het opende de wereld van eenvoudig configureerbaar agentisch werk. De gewone AI-tools lijken nu kinderspel."
— Damian, AI-consultant • Done-With-You-klant die in 2 dagen een compleet systeem voor contentautomatisering bouwde
Het complete plaatje
5 taken. 20 minuten. Eén systeem.
E-mailtriage, klantreacties, financiële analyse, LinkedIn-content en een landingspagina - allemaal in gang gezet vanuit dezelfde terminal in één sessie. Dit is wat het complete systeem levert.
Kies je weg
$197
DIY-pakket
Complete Second Brain-repository met agents, commando's en skills. De installatie regel je zelf.
- ✅ Volledige Second Brain-repository
- ✅ Voorgeconfigureerd hooks-systeem
- ✅ MCP-configuratiegidsen
- ✅ Documentatie-gebaseerde support
Tijdlijn: 1-2 weken installatie
$597
Kickstart-pakket
Alles uit DIY + een AI-agent configureert je systeem op basis van de antwoorden uit de vragenlijst.
- ✅ Alles uit DIY, gepersonaliseerd voor jou
- ✅ Een AI-agent bouwt het systeem uit je antwoorden
- ✅ Asynchrone priority-support binnen 48 uur
- ✅ Eerste jaar MemoryOS Pro inbegrepen (waarde $349)
Tijdlijn: werkend in minuten, niet weken
$2,497
Done-With-You
Alles uit Kickstart + een onboarding-call van 2 uur met Iwo. Volledige uitrol van de infrastructuur.
- ✅ Alles uit Kickstart
- ✅ Onboarding-call van 2 uur met Iwo
- ✅ Volledige uitrol van de infrastructuur (Vercel + Supabase)
- ✅ Maandelijkse Second Brain-updates
- ✅ 12 maanden MemoryOS inbegrepen
Tijdlijn: productief in 2 uur
Bijlage: geavanceerde patronen
Blijf leren
Opname van de cowork-sessie
Live sessie van 60 minuten met meer dan 10 demo's - dagplanning, contentcreatie, MCP-onderzoek, WhatsApp-agents en meer.
AI Chief of Staff-template
Gratis agent-template met volledige configuratie, structuur voor de kennisbank en aanpassingsgids voor jouw rol.
Officiële documentatie
Dit zijn de gezaghebbende bronnen. Deze tutorial voegt het praktische "hoe" en "wanneer" toe dat de officiële documentatie niet behandelt.
Klaar om je eigen Second Brain te bouwen?
Drie pakketten beschikbaar - van DIY-templates tot done-with-you-implementatie.
Bekijk pakketten30 dagen niet-goed-geld-terug-garantie • Bespaar in de eerste maand meer dan 10 uur of volledige terugbetaling