De context van Claude Code beheren: een praktisch handboek

De Claude Code van Anthropic en de bredere Claude-familie geven ontwikkelaars nu ongekende controle over hoe veel het model ziet en hoe diep Redenen. Recente productupdates (met name het Sonnet 4 contextvenster van 1 miljoen tokens en Claude's uitgebreide "denk"-bedieningselementen) maken contextbeheer zowel krachtiger als belangrijker: u kunt hele repositories in één sessie verwerken, maar alleen als u prompts, bestanden en sessiestatussen bewust structureert. Dit artikel legt uit hoe u de context van Claude Code betrouwbaar kunt beheren: opdrachten en gebruik, denkbudgetbeheer, CLAUDE.md-patronen, subagentworkflows, tips voor ervaren gebruikers, probleemoplossing en concrete codevoorbeelden die u kunt kopiëren en plakken.

Wat is Claude-code?

Claude Code is Anthropic's agentische codering CLI — een terminal-first tool die je ontwikkelomgeving verbindt met Claude-modellen, zodat de assistent je repository kan lezen, opdrachten kan uitvoeren, bestanden kan bewerken, tests kan uitvoeren, commits kan maken en workflows met meerdere stappen kan uitvoeren vanuit de terminal. Het is zo gebouwd dat de AI in je shell kan "leven" en op je codebase kan inwerken, met functies zoals repository scanning, slash-opdrachten, subagents (gespecialiseerde assistenten met geïsoleerde context) en Model Context Protocol (MCP)-integraties voor externe tools.

---

Waarom zou ik de verband van Claude Code?

Omdat context = relevantie + kosten + veiligheid. Zonder controle veroorzaken lange geschiedenissen:

• Hoger tokengebruik (hogere kosten, tragere reacties).
• Context drift (oude/irrelevante informatie verwart de uitkomsten).
• Informatielekken (geheimen of gevoelige logs blijven in de sessie hangen).
  Door contextbeheer blijven de uitkomsten nauwkeurig, voorspelbaar en goedkoper.

Hoe organiseert en behoudt Claude Code de projectcontext?

Claude Code is een agentische CLI die uw repository, tools en configuratie als eersteklas contextbronnen beschouwt. Het leest projectbestanden, CLAUDE.md, lokale tools en geconfigureerde MCP-servers; het ondersteunt ook subagenten die elk hun eigen contextvenster krijgen (handig om vervuiling van het hoofdgesprek te voorkomen). Gebruik dit om de strategie op hoofdniveau gescheiden te houden van het gespecialiseerde agentgeheugen (bijv. testrunner, codereviewer).

Hoe verwerkt Claude Code repo-context en helperbestanden?

• Het scant de werkdirectory en alle extra directories die u toevoegt (--add-dir).
• Het zoekt naar .claude/ submappen (opdrachten, agenten) en CLAUDE.md.
• U kunt MCP-servers (Model Context Protocol) aansluiten voor externe toegang tot tools; Claude Code kan deze tools overnemen in zijn toolset.

Welke methoden kan ik gebruiken om context in Claude-code te beheren?

1. Leer de basis CLI-opdrachten voor context. Sla herbruikbare prompts op als slash-opdrachten in .claude/commands/ om te voorkomen dat je herhaaldelijk lange prompts moet plakken.
2. Ontwerp een CLAUDE.md-bestand op de juiste manier. Voeg CLAUDE.md toe aan de root van de repository om doelen, toegestane tools, stijl, escalatieregels en nuttige slash-opdrachten te definiëren. (Claude Code leest dit automatisch en gebruikt het als bindende leidraad.)
3. Gebruik subagenten voor taakisolatie. Elke subagent krijgt zijn eigen contextvenster- en toolrechten, waardoor de hoofdsessie niet gepolled kan worden. Sla subagenten op in .claude/agents/ en beheer ze met versiebeheer.

Wat zijn de basisopdrachten voor contextbeheer?

Hieronder staan ​​de opdrachten die u het vaakst zult gebruiken om de conversatiestatus in Claude Code te beheren. Ik som het gedrag, voorbeeldgebruik, aanbevolen scenario's en verwijzingen naar gerelateerde CLI-vlaggen op.

---

/clear — “een frisse start maken”

Wat het doet: wist de huidige conversatiegeschiedenis uit de sessie, zodat volgende prompts met een schone lei beginnen. De REPL-sessie gaat door, maar de heen-en-weer-berichten worden uit de context van het model verwijderd. (Projectbestanden en CLAUDE.md (blijven toegankelijk voor Claude Code.)

Wanneer te gebruiken

• Nadat u een feature of ticket hebt afgerond en u een schone sessie wilt voor een andere taak.
• Als de sessie veel verkennende rondes bevat en de antwoorden afbrekend zijn.
• Voordat de sessie aan een andere gebruiker/agent wordt overgedragen, om te voorkomen dat de eerdere conversatiestatus lekt.

Gebruik

# in the interactive REPL

/clear

Opmerkingen en tips

• /clear is destructief voor de gespreksgeschiedenis van die sessie; gebruik /resume/--continue als u terug wilt naar oude sessies die op schijf zijn opgeslagen.

---

/compact — “samenvatten en condenseren”

Wat het doet: comprimeert het huidige gesprek tot een korte samenvatting die de belangrijkste feiten en beslissingen behoudt, en vervangt vervolgens de uitgebreide geschiedenis door die samenvatting, zodat de sessie kan worden voortgezet zonder de belangrijke context te verliezen. Dit vermindert het gebruik van tokens en zorgt voor continuïteit.

Wanneer te gebruiken

• Wanneer u de belangrijke status van de thread wilt behouden, maar de token footprint wilt verkleinen.
• Voor een nieuwe, langdurige taak die anders het contextvenster tot het uiterste zou drijven.
• Als u een bondige sessie wilt onthouden, maar toch de belangrijkste beslissingen wilt onthouden.

Gebruik

# in the interactive REPL

/compact
# or with an instruction to guide the summary

/compact Summarize decisions, open TODOs, and config changes only

Opmerkingen en tips

• auto-compact, microcompacten andere intelligente compressiefuncties kunnen automatisch worden uitgevoerd wanneer de gespreksduur de limieten nadert in sommige builds of configuraties. Deze functies worden momenteel uitgerold en kunnen in uw installatie of gehoste omgeving verschijnen. (De community en changelogs bespreken microcompact- en automatisch comprimerend gedrag.)

---

--continue, --resumeen sessiecontroles (CLI-niveau)

Wat ze doen: beheer sessiepersistentie en selectie vanuit de CLI.

• claude --continue (of claude -c) — heropen en ga verder met het meest recente gesprek in de huidige projectmap.
• claude --resume (of claude -r <session-id>) — een interactieve kiezer weergeven (of een specifieke sessie hervatten op basis van ID). Handig wanneer u veel sessies hebt opgeslagen en er één wilt selecteren om verder te gaan.

Gebruiksvoorbeelden

# continue the most recent session

claude --continue

# open an interactive session picker

claude --resume

# resume by id (non-interactive)

claude --resume 550e8400-e29b-41d4-a716-446655440000

---

Interactieve snelkoppelingen die van belang zijn voor de context (terminal UX)

• Ctrl+L — wist het terminalscherm (visueel), maar houdt gespreksgeschiedenis. Gebruik /clear om de geschiedenis daadwerkelijk te resetten.
• Ctrl+D — de sessie verlaten (EOF).
• Ctrl+C — huidige generatie annuleren.
  Dit zijn handige bedieningselementen; ze hebben alleen invloed op het terminalgedrag, tenzij u expliciet /clear or --continue/--resume.

---

Andere contextgerelateerde besturingselementen en vlaggen

• --add-dir <path> — Voeg extra mappen toe die Claude kan lezen (handig om te bepalen waartoe Claude toegang heeft en om onnodig lezen van bestanden te beperken).
• --allowedTools — sta gereedschappen vooraf toe, zodat Claude ze kan uitvoeren zonder herhaaldelijk om toestemming te vragen (vermindert het heen-en-weer geloop en de lawaaierige dialoogvensters voor gereedschapstoestemmingen).
• Slash-opdrachten (/.claude/commands/ of door de MCP geleverd) — sla vaak gebruikte, token-efficiënte prompts op; het aanroepen van een slash-opdracht is goedkoper dan het herhaaldelijk plakken van lange prompts.

Hoe moet ik een CLAUDE.md-bestand ontwerpen om de projectcontext te beheren?

Wat is CLAUDE.md en waarom is het belangrijk?

CLAUDE.md is een preflight-prompt op projectniveau die Claude Code automatisch leest bij het starten in een repository. Gebruik deze prompt om korte, bruikbare en stabiele feiten over het project (zelfstandige naamwoorden, architectuur, standaarden) te vermelden. Omdat het model CLAUDE.md in de prompt opneemt, vermindert een goed opgesteld bestand de noodzaak om herhaaldelijk dezelfde informatie te plakken en bespaart het kostbare tokenbudget.

CLAUDE.md: praktische sjabloon (aanbevolen)

Houd u aan de volgende regels: korte (100–200 regels waar mogelijk), hiërarchische (globale → project → submappen overschrijven) en machineleesbare secties.

# CLAUDE.md — top of repository

Project: Acme Payment Gateway
Primary language: typescript
Build: pnpm build
Run tests: pnpm test
API routing: src/api/*
Database: Postgres via prisma (schema at prisma/schema.prisma)

# Conventions

- commit format: Conventional Commits
- test coverage threshold: 80%
- style: eslint + prettier (configs in .eslintrc, .prettierrc)

# What I'm asking Claude to do

- When asked to create a feature, always include tests and update the CHANGELOG.
- When modifying DB schema, present migration plan and migration files.

Opmerkingen:

• Zet items met een hoge waarde (API's, belangrijke bestanden, infrastructuuropdrachten, testopdrachten) op de eerste plaats.
• Apart gebruiken CLAUDE.md bestanden in submappen wanneer verschillende modules verschillende conventies hanteren; Claude zal specifiekere bestanden combineren en prioriteren.

Hoe stel ik workflows en subagenten samen om context te beheren en werk te paralleliseren?

Wat zijn subagenten?

Subagenten zijn Claude Code-patronen waarbij de hoofdagent afzonderlijke taken delegeert aan ondergeschikte agenten (bijvoorbeeld: frontend-agent, backend-agent, qa-agent) en vervolgens stemt de hoofdagent hun uitkomsten af. Met subagenten kun je parallel aan verschillende delen van het systeem werken zonder alles in één chat te proppen.

Voorbeeldworkflow: implementatie van functies (parallelle agents)

1. main-agent leest CLAUDE.md, maakt plan.
2. frontend-agent (subagent) krijgt gerichte context: UI-contracten, storybook, specifieke bestanden.
3. backend-agent (subagent) haalt DB-schema en API-contracten op en implementeert eindpunten.
4. qa-agent voert tests uit, schrijft falende tests terug naar main-agent.
5. main-agent orkestreert commits, merge-requests en updates CLAUDE.md.

CLI-patroon:

# start main session

claude --session main

# spawn frontend subagent (conceptually: new session with scoped CLAUDE.md)

claude --session frontend --cwd frontend/

Tip: Maak een scoped CLAUDE.md bestanden onder submappen (frontend/CLAUDE.md, backend/CLAUDE.md) zodat elke subagent begint met de minimale context die hij nodig heeft.

Voorbeeld subagent: .claude/agents/code-reviewer.md

---
name: code-reviewer
description: Focused code reviewer. Limited tools: Read, Grep, Bash
---

You are a code reviewer. When invoked:
1. Run `git diff --name-only` to see changed files.
2. Prioritize security, correctness, tests.
3. Return a patch (diff) and a 3-item actionable checklist.

---

Welke tips hebben ervaren gebruikers om de context gezond te houden en de kosten laag te houden?

1) Houd CLAUDE.md slank en hiërarchisch

Vermijd gigantische monolithische CLAUDE.md-bestanden. Gebruik één globale versie voor de voorkeuren van een ontwikkelaar en kleine modulebestanden voor gebiedsspecifieke informatie. Zie de eerdere sjabloon.

2) Gebruik slash-opdrachten voor werkwoorden, CLAUDE.md voor zelfstandige naamwoorden

Maak CLAUDE.md de plek voor feiten (welke bestanden er zijn, architectuur), en slash bepaalt de plaats voor procedures (tests maken, refactoring uitvoeren). Dit voorkomt dat procedurele logica bij elke sessie opnieuw wordt verzonden. De community benadrukt deze scheiding.

3) Uitgebreide modus + planmodus als debugtools

Wanneer Claude zich onverwacht gedraagt, voer dan verbose uit om de exacte context te bekijken en gebruik de planmodus om een ​​expliciet plan af te dwingen dat u kunt goedkeuren voordat er bewerkingen worden uitgevoerd.

4) Zorgvuldig nadenken over het budget

Begin met standaard/minimale denktokens en verhoog deze alleen wanneer taken meerstaps redenering vereisen (complexe refactoringen, formele verificatie). Gebruik lagere budgetten voor routinematige bewerkingen.

5) Instrumentuitvoer en commits

Heb hooks die automatisch tests uitvoeren en hun output aan de sessie koppelen (bash-modus) ! om een ​​shell-opdracht uit te voeren en uitvoer als context op te nemen). Gebruik commit-hooks om duidelijke atomaire commits met berichten te maken.

Hoe kan ik problemen oplossen als de context 'wegvalt' of Claude instructies vergeet?

Veelvoorkomende symptomen en oplossingen

• Symptoom: Claude negeert CLAUDE.md of eerdere instructies.
• fixes: Controleer of het bestand zich in de huidige werkmap van de sessie bevindt. Controleer of er een specifiekere submap CLAUDE.md is die het overschrijft. Gebruik de verbose-modus om de huidige prompt te zien.
• Symptoom: De prestaties nemen af ​​naarmate de sessies langer duren (het model ‘vergeet’ de eerste onderdelen).
• fixes: Compacteer de sessie: extraheer stabiele feiten in CLAUDE.md, of maak snapshots van delen van het gesprek in bestanden en verwijs ernaar in plaats van ze te herhalen. Overweeg ook om korte sessies opnieuw te starten en alleen beknopte context door te geven.
• Symptoom: Langdurig nadenken duurt te lang of is te tijdrovend.
• fixes: Verlaag het denkbudget, verdeel de taak in kleinere subproblemen of voer batch-offlineanalyses uit als u extreem hoge budgetten nodig hebt. Anthropic raadt batchverwerking aan wanneer de optimale denkbudgetten meer dan ~32 tokens bedragen om time-outs te voorkomen.

Conclusie

Het beheren van de context in Claude Code is nu een multidimensionaal probleem: modelkeuze, subagentontwerp, CLAUDE.md discipline, budgetten en toolingarchitectuur spelen allemaal een rol. Begin met het investeren van 1 à 2 uur om een ​​duidelijke strategie te schrijven. CLAUDE.md, stel 2-3 gerichte subagenten samen en voeg gebruiksinstrumentatie toe voor tokens en denkbudgetten. U zult direct winst zien in betrouwbaarheid, voorspelbaarheid van kosten en productiviteit van teams.

Gebruik Claude Code via CometAPI

CometAPI is een uniform API-platform dat meer dan 500 AI-modellen van toonaangevende aanbieders – zoals de GPT-serie van OpenAI, Gemini van Google, Claude, Midjourney en Suno van Anthropic – samenvoegt in één, gebruiksvriendelijke interface voor ontwikkelaars. Door consistente authenticatie, aanvraagopmaak en responsverwerking te bieden, vereenvoudigt CometAPI de integratie van AI-mogelijkheden in uw applicaties aanzienlijk. Of u nu chatbots, beeldgenerators, muziekcomponisten of datagestuurde analysepipelines bouwt, met CometAPI kunt u sneller itereren, kosten beheersen en leveranciersonafhankelijk blijven – en tegelijkertijd profiteren van de nieuwste doorbraken in het AI-ecosysteem.

We zijn verheugd u te kunnen melden dat CometAPI nu volledige ondersteuning biedt voor de krachtige Claude Code. U hoeft alleen Claude Code te installeren en u te verifiëren met de verkregen Comet API-sleutel en het basisadres om het Comet API-model op Claude Code te gebruiken.

Waarom moet ik claude-code gebruiken via CometAPI?

Belangrijkste functies van Kunstmatige Intelligentie: genereer, debug en optimaliseer eenvoudig code met behulp van modellen die speciaal voor ontwikkelaars zijn ontwikkeld.

• Flexibele modelselectie: dankzij ons uitgebreide aanbod aan modellen kunt u soepeler ontwikkelen.
• Naadloze integratie: API's zijn altijd beschikbaar. Integreer Claude Code binnen enkele minuten direct in uw bestaande workflow.
• Door Claude Code via CometAPI te gebruiken, bespaart u meer kostenDe API van CometAPI is 20% goedkoper dan de officiële prijs en wordt door de officiële leverancier bijgewerkt met het nieuwste model. Het nieuwste model is Claude Opus 4.1.

Klaar om Claude Code te gebruiken? raadpleeg de API-gids voor gedetailleerde instructies.

Zie ook Hoe installeer en voer ik Claude Code uit via CometAPI?