Module 1: Begrip — wat is dit eigenlijk?
Voor we in de details duiken, hier is een compleet overzicht van wat Claude Code allemaal kan. Zie deze les als je referentie. Twijfel je later of Claude Code iets specifieks kan? Kom hier dan terug.
Wat je leert in deze les
- Welke tien hoofdcategorieën van werk Claude Code aankan
- Het mentale model: prompt → plan → tools → resultaat
- Wat Claude Code niet (goed) kan, zodat je geen valse verwachtingen krijgt
Het mentale model
Claude Code heeft gereedschappen. Die noemen we “tools”. Jij geeft een doel. Claude kiest welke tools nodig zijn en voert ze uit, met jouw toestemming waar nodig. Dat is de hele kringloop.
Laten we de categorieën doorlopen, met een concreet voorbeeld per stuk.
1. Bestanden beheren
Het fundament. Claude Code kan elk bestand in je werkmap lezen, wijzigen of maken.
Lezen
Elk tekstbestand werkt. Source code in elke taal: Ruby, Python, JavaScript, Go, Rust, Java. Configuratiebestanden zoals JSON, YAML, TOML. Documenten in Markdown of plain text. Data bestanden zoals CSV en TSV.
Bewerken
Claude vervangt een exacte tekst door andere tekst. De rest van het bestand blijft onaangeroerd. Kleine, precieze diffs dus.
Maken
Nieuwe bestanden voor classes, configs, migrations, tests of documenten.
Speciale bestanden
- Images (PNG, JPG, GIF): Claude “ziet” deze visueel. Handig voor design naar code, bug screenshots of grafiek analyse.
- PDFs: pagina per pagina gelezen. Voor grote PDFs (meer dan 10 pagina’s) geef je een specifieke range op.
- Jupyter notebooks (.ipynb): cells en outputs worden allebei gelezen.
- Binary files: worden gedetecteerd en overgeslagen. Claude schrijft niet in binaries.
Jij: “Kijk in @config/database.yml en leg uit welke databases we gebruiken in welke omgeving.”
Claude leest het bestand en geeft terug: “Development gebruikt PostgreSQL lokaal. Test gebruikt een in memory SQLite. Production gebruikt een externe PostgreSQL via DATABASE_URL.”
2. Code schrijven en aanpassen
Hier shines Claude Code echt:
- Features implementeren over meerdere bestanden, auth, checkout, exports, API’s, admin panels.
- Refactoren: code verplaatsen, patterns toepassen, naming consistent maken.
- Tests schrijven in jouw test framework, RSpec, Minitest, Jest, Vitest, pytest, Go testing, JUnit.
- Bug fixes: van error message naar root cause naar concrete fix.
- Documentatie genereren: README’s, comments, API docs, changelogs.
- Migrations maken voor database schema wijzigingen.
- Boilerplate volgens jouw conventies, service objects, form objects, presenters.
- Configuratie bestanden: Dockerfile, docker compose, GitHub Actions, CircleCI.
Jij: “Schrijf een service class ExportCsv in app/services/. Die krijgt een ActiveRecord relation en geeft een CSV terug. Volg ons service object pattern in @app/services/archive_user.rb.”
Claude leest eerst archive_user.rb om het pattern te snappen. Daarna schrijft het ExportCsv in dezelfde stijl. Dezelfde initialize en call structuur, dezelfde error handling, dezelfde naming.
3. Zoeken en navigeren
Voor Claude iets kan wijzigen, moet het vaak eerst iets vinden.
- Tekst zoeken in de hele codebase met regex via ripgrep. Snel, zelfs op grote codebases.
- Bestanden vinden op naam patterns (
**/*.rb,src/components/**/*.tsx). - Code referenties: waar wordt een functie aangeroepen, waar wordt een class geïmporteerd.
- Dependency analyse: wat gebruikt wat, welke modules hangen af van welke.
Jij: “Waar wordt UserService gebruikt in de codebase?”
Claude rent grep en rapporteert: “Gevonden in 7 bestanden: 3 controllers, 2 workers, 2 test files. Wil je dat ik elk bestand bekijk of wil je een samenvatting?”
4. Commando’s uitvoeren
Alles wat jij in een terminal kunt, kan Claude Code ook. Met jouw toestemming uiteraard.
- Tests runnen:
npm test,bin/rspec,pytest,go test. - Dependencies installeren:
npm install,bundle install,pip install,cargo build. - Git operaties: status, diff, branch, commit, log, push (voorzichtig).
- Dev servers starten op de achtergrond terwijl je verder werkt.
- Build processen: webpack, vite, esbuild, tsc.
- Database operaties: migrations, seeds, backups.
- Shell scripts: jouw eigen scripts uitvoeren.
- Output interpreteren: errors begrijpen, logs analyseren, stack traces uitleggen.
Probeer dit later zelf: start Claude Code in een Rails project. Vraag “draai de tests en vat samen wat er faalt, als er iets faalt.” Claude voert bin/rspec uit, leest de output en geeft je een gestructureerd rapport.
5. Reflectie en analyse
Claude is niet alleen een codemaker. Het is ook een prima reviewer en onderzoeker.
- Code uitleggen: “wat doet deze functie?” → uitleg in gewone taal.
- Architectuur analyseren: “hoe is dit project opgebouwd?” → overzicht van structuur.
- Performance bottlenecks vinden, trage queries, inefficiënte loops.
- Security issues spotten, SQL injection risks, XSS, onveilige auth.
- Deprecated patterns: oude API’s, libraries die je moet upgraden.
- Best practices beoordelen, waar wijkt jouw code af van de norm.
Jij: “Bekijk @app/controllers/api/orders_controller.rb en geef me security concerns als die er zijn.”
Claude leest het en zegt: “Regel 34 gebruikt params[:user_id] direct in SQL zonder sanitization. Regel 67 skipt CSRF zonder uitleg waarom. Regel 89 stuurt het volledige user object terug, inclusief password_digest.”
6. Integraties via MCP
Via MCP servers (Model Context Protocol) kan Claude Code praten met externe diensten.
- Linear: tickets ophalen, maken, updaten.
- GitHub: issues, PRs, commits, repos doorzoeken.
- Slack: berichten lezen of sturen.
- Notion: pagina’s lezen, nieuwe maken, databases queryen.
- Google Drive: documenten openen en analyseren.
- PostgreSQL / MySQL / MongoDB: queries direct op je database.
- Sentry: errors en events bekijken.
- Figma: designs ophalen en analyseren.
- Stripe: payments, subscriptions, customers.
MCP komt in les 23 uitgebreid aan bod. Voor nu: weet dat het bestaat. Het breidt Claude Code uit naar je hele tech stack.
7. Automatisering
Claude Code kan terugkerende workflows automatiseren.
- Sub agents: delegeer onafhankelijke taken aan aparte sessies, parallel.
- Hooks: scripts die automatisch draaien op events (bijvoorbeeld format na elke edit).
- Custom slash commands: maak je eigen
/reviewof/deploy. - Skills: bundels van slash commands, kennis en tools rondom een workflow.
- Geplande taken via de schedule skill, Claude Code op cron schema.
- Loops: herhaal een taak tot een conditie klopt.
8. Context en geheugen
Claude onthoudt dingen over jou en je project.
- CLAUDE.md: projectkennis die Claude automatisch inleest bij elke sessie.
- Auto memory: feiten die Claude zelf onthoudt tussen sessies (jouw voorkeuren, project context).
- @-mentions van bestanden of URLs in prompts.
- Long context: tot 1 miljoen tokens met Opus 4.7 [1m] of Sonnet 4.6 [1m]. Grote codebases passen in één sessie.
9. Visuele input
Claude Code is multimodaal.
- Screenshots sleep je in de VS Code extensie voor visuele context.
- Design files (PNG, JPG) analyseren, “bouw dit component in React.”
- PDFs pagina per pagina lezen, specs, whitepapers, documentatie.
- Error screenshots: “hier is een screenshot van een bug, wat gaat mis?”
- Grafieken analyseren, “hier is een performance grafiek, welke patronen zie je?”
10. Developer workflows
Claude Code past in moderne workflows.
- TDD (Test Driven Development): eerst test, dan code.
- Debugging: van error naar root cause naar fix.
- Code review: feedback op bestaande code of PRs.
- Pair programming: stap voor stap samen iets uitdokteren.
- Documentatie bijwerken na code wijzigingen.
- Changelog updates op basis van git history.
- Release notes uit commits halen.
Wat Claude Code NIET (goed) kan
Eerlijk blijven over beperkingen:
- Perfecte UX en UI beslissingen zonder jouw input, kleuren, typografie, branding.
- Business logic begrijpen zonder uitleg, Claude kent jouw bedrijfsregels niet.
- Hele specifieke legacy systemen of obscure cloud services.
- Real time collaboration: Claude Code is niet multiplayer.
- Debugging zonder reproductie: kun je het probleem niet tonen, dan gokt Claude.
- Visuele beoordeling: “ziet deze UI er goed uit?” is subjectief.
Samengevat
Zie Claude Code als een capabele junior tot mid level developer die:
- Altijd beschikbaar is, geen burnout
- Onbeperkt geduld heeft
- Geen ego heeft over code reviews
- Je hele codebase in seconden leest
- Jouw standaarden volgt als je ze duidelijk maakt
- Eindverantwoordelijkheid bij jou laat
Onthoud dit
Vijf kernpunten:
- Eén kringloop: jouw prompt → Claude plant → tools → resultaat. Snap dit en alles valt op zijn plek.
- Tools zijn de werkpaarden: Read, Edit, Write, Bash, Grep, Glob, Task, MCP. De rest van de cursus zoomt op deze in.
- Toestemming is standaard: voor schrijven en commando’s. Bewust ontworpen.
- MCP voegt jouw tech stack toe: Linear, GitHub, Slack, Stripe, je database. Komt in les 23.
- Claude is een capabele junior met onbeperkt geduld, geen senior architect. Behandel het zo.
Probeer zelf
Nog steeds geen Claude Code geïnstalleerd? Geen probleem. Doe dit:
- Bekijk de tien categorieën hierboven nog eens snel.
- Markeer voor jezelf: welke drie categorieën ga ik als eerste gebruiken in mijn werk?
- Schrijf voor elke categorie één concrete taak op uit jouw eigen project.
Dit voorkomt dat je later passief blijft lezen. Je hebt je eigen testcases klaar.
Even checken
[!QUESTION]
- Wat doet Claude voor het iets wijzigt, in vrijwel elke sessie?
- Wat is MCP in één zin?
- Wat kan Claude Code echt niet goed?
Antwoorden: 1) Eerst lezen of zoeken — om context te krijgen voor het iets aanpast. 2) Een protocol om Claude te koppelen aan externe diensten zoals Linear, GitHub of je database. 3) UX/branding beslissingen, business logic zonder uitleg, debugging zonder reproductie.
Volgende les
In de volgende les installeren we Claude Code op jouw systeem. Daarna gaan we echt aan de slag.