Agent skills, MCP-servers of rules-bestanden gebruiken?
Kies de juiste methode voor uw coding agent. Ontdek de verschillen in tokenverbruik en onderhoud tussen skills, MCP-servers en rules-bestanden om uw contextvenster te optimaliseren.
Agent skills versus MCP-servers versus rules-bestanden: het korte antwoord
Agent skills, MCP-servers en rules-bestanden bieden alle drie kennis aan een coding agent. Maak uw keuze op basis van de functie van de kennis. MCP (Model Context Protocol) is bedoeld voor gegevens die kunnen veranderen wanneer u ze opnieuw raadpleegt. Een skill is bedoeld voor een procedure die u vandaag kunt uitschrijven en die over zes weken nog steeds correct is. Een rules-bestand is bedoeld voor de weinige feiten die in elke sessie moeten gelden.
Aan deze keuze zijn kosten verbonden, en die kosten worden uitgedrukt in context. Elke token die wordt besteed aan een instructie die de agent niet nodig had, is een token die niet beschikbaar is voor de code die de agent leest. Bovendien betaalt u deze token bij elke beurt opnieuw, omdat het volledige contextvenster bij elk verzoek opnieuw wordt verzonden. De relevante vraag is dus niet welk mechanisme de taak kan uitvoeren. Meestal kunnen ze alle drie de taak aan. De vraag is welke optie de minste kosten met zich meebrengt wanneer deze niet actief is.
Wat elk onderdeel kost voordat u het gebruikt
De drie onderdelen laden op verschillende momenten, en die timing maakt het volledige verschil.
Een onvoorwaardelijk regelsbestand laadt bij het opstarten, in elke sessie, ongeacht of het relevant is, tenzij het is uitgesloten. Claude Code leest opstartbestanden CLAUDE.md aan het begin van elk gesprek, verwijdert HTML-commentaar op blokniveau buiten codeblokken voordat de inhoud wordt geïnjecteerd, en slaat bestanden groter dan 4 MiB over; claudeMdExcludes kan ook bestanden uitsluiten, met uitzondering van het beheerde beleidsbestand. Het gedocumenteerde doel is minder dan 200 regels per bestand, omdat een langer bestand meer context kost en minder betrouwbaar wordt opgevolgd. Die twee effecten werken in dezelfde richting, en daarom is een regelsbestand van 900 regels erger dan nutteloos.
Een skill laadt in twee fasen. Bij het opstarten komt alleen de regel description uit de frontmatter van elke SKILL.md in de context, zodat het model weet dat de skill bestaat en ongeveer wanneer deze van toepassing is. De hoofdtekst laadt pas wanneer de skill wordt aangeroepen. Een referentiedocument van 400 regels kost u daarom vrijwel niets tot het moment dat het nodig is.
Een MCP server was voorheen de dure optie, en dit is waar de meeste vergelijkingen die u zult lezen inmiddels verouderd zijn. Zoeken naar tools staat standaard aan in de huidige Claude Code. Alleen de toolnamen en het instructieveld van de server laden bij de start van de sessie, en de volledige JSON (JavaScript object notation) schema's worden uitgesteld totdat Claude ernaar zoekt. Het toevoegen van een server kost niet langer duizenden tokens vooraf. Het kost nog steeds iets, en het kost nog steeds alles vooraf in configuraties waar het zoeken naar tools is uitgeschakeld.
De gegevens achter deze grafiek
[
{
"label": "Rules file, 200 lines",
"at_startup": "2,500",
"after_use": "2,500"
},
{
"label": "Skill, 12 KB body",
"at_startup": 40,
"after_use": "3,000"
},
{
"label": "MCP server, tool search on",
"at_startup": 500,
"after_use": "3,200"
},
{
"label": "MCP server, tool search off",
"at_startup": "4,500",
"after_use": "4,500"
}
]Dit zijn schattingen, geen metingen vanaf uw machine. Ze zijn gebaseerd op de grootte van de tekst die elk mechanisme laadt, bij ongeveer vier tekens per token: een regelsbestand van 200 regels is ongeveer 10 KB aan markdown, een skill-beschrijving is ongeveer 160 tekens, en een server die twaalf tools aanbiedt bevat ongeveer 18 KB aan schema plus een instructieblok van 2 KB. Claude Code kapt het instructieveld van de server, en de beschrijving van elke tool die vooraf laadt, standaard af op 4.096 tekens, en een toolbeschrijving die via tool search wordt geladen op 16.384. Vóór v2.1.296 was de kortere limiet 2.048 tekens, en CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH vervangt beide limieten als u deze instelt. Instructies en beschrijvingen van sommige door Anthropic gehoste MCP servers bereiken Claude volledig, zelfs met die variabele ingesteld, dus deze limieten zijn geen universeel plafond. De volgende sectie laat zien hoe u uw eigen werkelijke getallen kunt aflezen.
Lees de eerste twee rijen samen. Het regelsbestand kost 2,500 tokens in een sessie waarin niemand het nodig had. De skill kost 40 tokens in diezelfde sessie, en 3,000 in de ene sessie op de tien waarin deze wordt geactiveerd. De laatste twee rijen zijn dezelfde server twee keer, met tool search aan en uit: 500 tokens tegenover 4,500. Dat verschil is de reden waarom oud advies over MCP-contextvervuiling nog steeds de ronde doet.
Sinds oktober 2026 gebruikt Claude Code tool search op Claude Opus 4, Sonnet 4, Haiku 4.5 en latere modellen, en op Opus 4.5, Sonnet 4.5, Haiku 4.5 en later op het Agent Platform van Google Cloud. Op eerdere modellen, en op Microsoft Foundry-implementaties gehost op Azure, laadt elke MCP tool vooraf, ongeacht wat u instelt. Met ANTHROPIC_BASE_URL gericht op een LLM gateway, staat tool search standaard aan sinds v2.1.304; oudere versies schakelden dit daar uit tenzij u zich hiervoor aanmeldde. Sinds v2.1.305 kan Claude Code een gateway-verzoek opnieuw proberen zonder tool search na een 400 of 422, waarbij tools vooraf worden geladen wanneer die nieuwe poging slaagt. Stel ENABLE_TOOL_SEARCH in om dit te beheren: false laadt elk schema vooraf, true stelt ze uit met dezelfde model- en implementatiefallbacks als wanneer het niet is ingesteld, en auto laadt ze vooraf zolang hun definities in totaal onder de 10% van het contextvenster blijven, en houdt tool search daarna aan zodra die drempel is bereikt, zelfs als het totaal later weer daalt. Een server die is geconfigureerd met "alwaysLoad": true laadt zijn tools vooraf, ongeacht ENABLE_TOOL_SEARCH.
# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claudeDe doorslaggevende vraag: verandert de data tussen aanroepen?
Stel die vraag als eerste, omdat deze direct één optie elimineert. Als de agent iets moet lezen of schrijven dat de volgende keer dat hij kijkt anders kan zijn, heeft u een server nodig. Een issue tracker, een database, een monitoring dashboard, uw eigen interne API (application programming interface). Het opschrijven helpt niet, omdat wat u schreef verouderd is zodra iemand anders het record bewerkt. Uw eigen codebase hoort ook op die lijst, aangezien de structuur verandert bij elke commit. Dat is de reden achter het aanbieden van een geparseerde map van de repository via MCP aan de agent in plaats van de lay-out te beschrijven in een bestand dat veroudert.
Als het antwoord over zes weken nog steeds correct zou zijn zonder dat iemand het onderhoudt, dan wilt u een skill. Een release-checklist. Een migratieprocedure. De vorm van uw foutmeldingen. Hoe deze repository wil dat tests worden geschreven. Een skill is een bestand in git. Het heeft geen poort, geen proces en geen faalmodus behalve dat het onjuist is, wat een code review kan opvangen.
Als het één feit is dat van toepassing moet zijn op werk waar u nog niet aan heeft gedacht, zet het dan in het rules-bestand. Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. Eén regel per stuk. Zodra een item uitgroeit tot stappen, is het geen feit meer maar een procedure, en moet het worden verplaatst naar een skill.
Wanneer een rules-bestand volstaat
Rules-bestanden worden vanaf verschillende locaties geladen, van algemeen naar specifiek: een beheerd policy-bestand, uw persoonlijke ~/.claude/CLAUDE.md, het ./CLAUDE.md of ./.claude/CLAUDE.md van het project, en een gitignored ./CLAUDE.local.md. Alle gevonden bestanden worden samengevoegd in plaats van dat ze elkaar overschrijven, en bestanden die zich dichter bij uw werkmap bevinden, worden als laatste gelezen.
Sinds v2.1.277 leest Claude Code ook AGENTS.md, maar standaard alleen wanneer er geen CLAUDE.md, .claude/CLAUDE.md of CLAUDE.local.md in uw werkmap of daarboven aanwezig is. Als uw repository beide bevat, leest Claude alleen de CLAUDE.md-bestanden; beheer daarom geen twee kopieën die van elkaar kunnen gaan afwijken.
ln -s AGENTS.md CLAUDE.mdDe symlink geeft bij succes geen uitvoer. Start een sessie, voer /context all uit en bevestig dat CLAUDE.md verschijnt onder Memory files. Als het daar niet wordt vermeld, heeft de agent het bestand nooit gezien en zal herschrijven niet helpen. Wanneer u ook Claude-specifieke regels wilt, gebruik dan de import-vorm en plaats deze onder de import.
@AGENTS.md
## Claude Code
Use plan mode for changes under `src/billing/`.Hier schuilt een valkuil. @path-imports slaan geen context op. Het geïmporteerde bestand wordt bij het opstarten uitgebreid en geladen naast het bestand dat ernaar verwees, tot vier niveaus diep. Het opsplitsen van een rules-bestand van 600 regels in zes imports maakt het overzichtelijker voor mensen en verandert de tokencost met precies nul. De conventies achter AGENTS.md en de tegenhanger voor mensen zijn het lezen waard voordat u een indeling kiest.
Wat de kosten wel verlaagt, is .claude/rules/ met een paths-veld. Een rules-bestand met paths frontmatter wordt alleen geladen wanneer de agent een bestand aanraakt dat overeenkomt met een van de patronen.
---
paths:
- "src/api/**/*.ts"
---
# API rules
- Every endpoint validates its input.
- Use the standard error response shape.Een regel zonder paths-veld wordt bij het opstarten geladen met dezelfde prioriteit als .claude/CLAUDE.md. Het werkbare patroon is dus korte, onvoorwaardelijke regels, aangevuld met een paths-lijst voor alles wat alleen relevant is binnen één map.
Wanneer u een skill wilt gebruiken
Een skill is een map met daarin een SKILL.md. Persoonlijke skills staan in ~/.claude/skills/<name>/SKILL.md en zijn van toepassing op elk project op uw machine. Project-skills staan in .claude/skills/<name>/SKILL.md, reizen mee met de repository en kunnen net als elk ander bestand worden beoordeeld in een pull request.
mkdir -p ~/.claude/skills/summarize-changes---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---
Run `git status` and `git diff` against the merge base.
Group the changes by intent, not by file.
Call out anything touching auth, migrations or deletions.De description is het enige onderdeel van dat bestand dat in de context staat voordat de skill wordt uitgevoerd, waardoor deze twee taken vervult. Het beschrijft wat de skill doet en wanneer deze moet worden ingezet. Een beschrijving als "Helpt bij deploys" geeft het model geen aanknopingspunten om een verzoek aan te koppelen, waardoor de skill stilzwijgend nooit wordt geactiveerd en u ten onrechte concludeert dat skills niet werken.
De mapnaam wordt het commando, dus het bovenstaande voorbeeld geeft u /summarize-changes. Bij een persoonlijke of project-skill zorgt een frontmatter name die afwijkt van de mapnaam ervoor dat het /-menu een ander commando toont, tenzij een ander commando die naam al gebruikt; de mapnaam roept de skill dan nog steeds aan.
Zodra een skill is aangeroepen, wordt de gerenderde inhoud als één bericht in het gesprek opgenomen en blijft daar voor de rest van de sessie staan. Claude Code leest het bestand niet opnieuw bij latere interacties. Schrijf permanente instructies in plaats van eenmalige stappen en houd de tekst beknopt, omdat vanaf dat moment elke regel een terugkerende kostenpost is bij elk verzoek. Na automatische compressie voegt Claude Code de meest recente aanroep van elke skill opnieuw toe, waarbij de eerste 5.000 tokens van elk worden bewaard binnen een gezamenlijk budget van 25.000 tokens. Als u meerdere grote skills in één sessie aanroept, worden de oudste volledig verwijderd; dit is de reden waarom een skill na een lang gesprek niet meer relevant lijkt te zijn. Roep de skill opnieuw aan en deze is weer actief. Een skill die zwaar leunt op procedures maakt die afweging concreet: de unlazy skill en de bijbehorende Depth Tree-methode verbruikt daadwerkelijk context voor gates en een planbestand, in ruil voor een agent die niet voortijdig stopt met het werk. Wanneer dezelfde procedure op meer dan één codebase van toepassing is, kunt u één skill delen over meerdere repositories in plaats van het bestand te kopiëren.
Wanneer u een MCP-server nodig heeft
Het toevoegen van een server is een enkel commando, en het transport bepaalt de vorm ervan.
# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp
# Remote HTTP server behind a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
# Local stdio server: everything after -- is passed through untouched
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
-- npx -y airtable-mcp-serverDe -- is van belang. Bij een stdio-server scheidt deze de opties van Claude Code zelf van de command line die uw server start. Laat u deze weg, dan wordt een --port 8080 die voor de server bedoeld is, geparseerd als een optie voor claude mcp add, welke deze vervolgens afwijst.
claude mcp list
claude mcp get notionclaude mcp add bevestigt dit met een Added ...-regel, die enkel aangeeft dat de configuratie naar de schijf is geschreven. claude mcp list is het commando dat u de waarheid vertelt, omdat het een gezondheidsstatus naast elke server afdrukt: ✔ Connected, ! Needs authentication of ✘ Failed to connect. Een foutstatus betekent dat Claude Code die server niet kon bereiken, niet dat het list-commando defect is. Binnen een sessie geeft /mcp hetzelfde overzicht per server, inclusief het aantal tools.
Elke aanroep naar een MCP-server staat op zichzelf en bevat alles wat nodig is, wat de reden is waarom een MCP-server uw vorige verzoek niet onthoudt. Dat is een ontwerpkeuze met een consequentie die u overneemt: elke status die het bewaren waard is, moet achter de server worden opgeslagen, in een database of een bestand, en dat is iets wat u vanaf nu beheert.
Een MCP server is een proces dat u moet draaien
Dit zijn de kosten die leveranciersvergelijkingen achterwege laten. Een skill is een bestand. Een MCP server is software die ergens draait, en wanneer dat 'ergens' uw VPS (virtual private server) is, bent u zelf verantwoordelijk voor de uptime.
Een stdio server is de goedkope variant. Claude Code start deze als een onderliggend proces wanneer de sessie begint, en het proces stopt wanneer de sessie eindigt. Er is niets om te monitoren en niets om volgens een eigen schema te patchen. Een externe HTTP server is een langlopende service, en deze heeft nodig wat elke langlopende service nodig heeft, te beginnen met een eigen gebruiker. Maak de mcp gebruiker aan waaronder de onderstaande unit draait, en wijs de directory van de server toe:
sudo useradd --system --home-dir /srv/notes-mcp --shell /usr/sbin/nologin mcp
sudo chown -R mcp:mcp /srv/notes-mcp[Unit]
Description=Notes MCP server
After=network-online.target
Wants=network-online.target
[Service]
User=mcp
WorkingDirectory=/srv/notes-mcp
ExecStart=/usr/bin/node /srv/notes-mcp/dist/server.js
Environment=PORT=8931
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pagersystemctl is-active zou active moeten weergeven. Als het failed weergeeft, bevat de journal de reden; bij een eerste uitvoering is dit bijna altijd een ontbrekende omgevingsvariabele of een poort die al door iets anders in gebruik is. Restart=on-failure is hier niet optioneel, omdat een gecrashte MCP server zichzelf niet aankondigt. U komt er pas achter wanneer de agent meldt dat deze uw issue tracker niet kan lezen.
Bind het proces aan 127.0.0.1 en plaats een reverse proxy met TLS (transport layer security) ervoor. Een MCP server die uw database bereikt en antwoordt op een publieke poort zonder authenticatie, is in feite een database die u openbaar heeft gemaakt. Een MCP server draaien op een VPS behandelt de proxy, het certificaat en de firewall op de juiste wijze.
Reken vervolgens het terugkerende werk eerlijk door. De service ontvangt beveiligingsupdates volgens een eigen schema, los van de agent die ermee communiceert. Het OAuth-token verloopt en claude mcp list begint op een ongelegen moment ! Needs authentication weer te geven. De inloggegevens staan in een configuratiebestand of een Authorization header, dus deze vereisen dezelfde zorg als elk ander geheim, wat op zichzelf al een volledig onderwerp is: geheimen buiten het bereik van een AI-agent houden. Dat werk bestaat niet voor een skill.
Weg dit af tegen het alternatief voordat u begint met bouwen. Als de data achter de voorgestelde server ongeveer eens per kwartaal wijzigt, is een skill die de agent vertelt waar hij moet kijken en wat de velden betekenen goedkoper dan een service die u in de lucht moet houden.
Hoe u uw eigen contextkosten meet
Stop met schatten en voer /context all uit binnen een sessie. Dit geeft een actueel overzicht weer: de systeemprompt, geheugenbestanden, tools en MCP-servers, inclusief het token-gewicht van elk onderdeel.
Controleer twee zaken. Controleer onder Memory files of elk regelbestand dat u verwacht, wordt vermeld. Een ontbrekend bestand is onzichtbaar voor de agent; dit is dus het eerste wat u moet uitsluiten wanneer instructies worden genegeerd. Als het bestand wel in de lijst staat en de regel nog steeds wordt overgeslagen, ligt de oorzaak ergens anders en is het de moeite waard om de redenen waarom een agent een instructie negeert die hij kan zien door te nemen voordat u de regel opnieuw herschrijft. Kijk vervolgens naar de kosten van uw servers. Als een server die u twee keer per maand gebruikt een van de grootste posten in die lijst is, schakel deze dan uit in /mcp en schakel hem weer in voor de sessies waarvoor u hem nodig heeft. De configuratie blijft in beide gevallen behouden.
Als de discovery cache is ingeschakeld voor uw account, kan een externe server die u eerder heeft gebruikt een status zoals cached 2h ago · connects on first use · 5 tools tonen. Dit betekent dat Claude Code de toollijst uit een eerdere sessie heeft gelezen in plaats van bij het opstarten verbinding te maken; de verbinding wordt gelegd zodra een tool voor de eerste keer wordt aangeroepen. De tools zijn beschikbaar vanaf uw eerste bericht, dus er is niets dat gerepareerd moet worden. De cache staat standaard uit, tenzij een geleidelijke uitrol deze voor u heeft ingeschakeld: stel MCP_DISCOVERY_CACHE=0 in om elke server bij het opstarten te laten verbinden, of 1 om de cache in te schakelen. Voor een breder beeld behandelt het beheren van het Claude Code contextvenster wat behouden blijft na compressie, en wat die tokens u daadwerkelijk kosten zet de getallen om in geld.
Waarom wordt mijn skill nooit geactiveerd?
De gebruikelijke oorzaak is de description. Dit is de enige tekst in de context voordat de skill wordt uitgevoerd; als deze de situatie niet benoemt, komt er niets overeen. Verwerk de trigger in de zin: "Use when the user asks what changed, wants a commit message, or asks to review their diff." Vage omschrijvingen falen geruisloos, waardoor dit lastig op te merken is.
De tweede oorzaak is een typefout in de frontmatter, en in Claude Code blijft dit eveneens onopgemerkt. Een veldnaam moet exact overeenkomen, inclusief koppeltekens, en Claude Code negeert een veld dat het niet herkent zonder een foutmelding te geven. De expliciete versie verschijnt pas wanneer u de skill verpakt of uploadt naar claude.ai of de Skills API, die minder velden accepteren en de rest direct afwijzen:
Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, nameDe derde oorzaak is de locatie. Project-skills worden geladen vanuit .claude/skills/ in uw werkmap en in elke bovenliggende map tot aan de repository-root. Skills in geneste mappen onder de locatie waar u bent gestart, worden niet geladen bij het opstarten. Ze verschijnen pas de eerste keer dat de agent een bestand in die submap leest of bewerkt; tot die tijd worden ze niet aangevuld en kunnen ze niet bij naam worden aangeroepen.
Het MCP-equivalent van dit geruisloze falen is een .mcp.json-vermelding met een url en zonder type. Claude Code leest elke vermelding zonder type als een stdio-server, dus slaat het de vermelding over en rapporteert:
MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entryAlle drie tegelijk gebruiken
Deze mechanismen concurreren niet met elkaar. Een werkende configuratie gebruikt elk mechanisme daar waar het efficiënt is. Het rules-bestand bevat een beperkt aantal regels die overal gelden. Skills bevatten de procedures en worden alleen geladen wanneer ze van toepassing zijn. Eén MCP-server, soms twee, verbindt de systemen waarvan de inhoud niet vooraf te voorspellen is. Als u nog bezig bent met het vormen van een mentaal model van het eerste mechanisme, behandelt wat een agent skill precies is het formaat in detail.
Eén test beslecht de meeste discussies over waar iets thuishoort. Verwijder het onderdeel, start een nieuwe sessie en geef de agent de taak. Als de agent alleen trager is, hoorde het thuis in een skill. Als de agent zelfverzekerd een fout maakt, hoorde het thuis in het rules-bestand. Als de agent de informatie helemaal niet kan verkrijgen, had u de server nodig, en nu heeft u ook een plan nodig om die server draaiende te houden.
FAQ
Moet ik een skill schrijven of een MCP server opzetten?
Maak uw keuze op basis van de vraag of de informatie verandert tussen twee aanroepen. Als de agent live-gegevens moet lezen die door anderen kunnen worden gewijzigd, zoals een issue tracker, een database of een dashboard, dan heeft u een MCP server nodig. Alles wat u opschrijft is immers verouderd zodra het brondocument verandert. Als u het antwoord één keer kunt opschrijven en het over zes weken nog steeds correct is, schrijf dan een skill. Een skill is een bestand in git zonder draaiend proces, zonder poort die opengezet moet worden en zonder onderhoudsschema voor patches. Het is daarom altijd de goedkopere optie wanneer dit mogelijk is.
Nemen MCP servers nog steeds mijn context window in beslag?
Veel minder dan voorheen. Tool-zoeken is standaard ingeschakeld in de huidige Claude Code. Hierdoor worden bij de start van een sessie alleen de toolnamen en het instructieveld van de server geladen. De volledige schema's worden pas opgehaald wanneer Claude ernaar zoekt. Dit geldt nu ook voor sessies achter een LLM-gateway die is ingesteld via ANTHROPIC_BASE_URL, vanaf versie v2.1.304. Vooraf laden gebeurt nog wel met ENABLE_TOOL_SEARCH=false, voor een server die is ingesteld op "alwaysLoad": true, op een model ouder dan Claude Opus 4 en Sonnet 4 (ouder dan de 4.5-generatie op het Google Cloud Agent Platform), en op Microsoft Foundry-implementaties die op Azure worden gehost. Voer /context all uit om te zien in welke situatie u zich bevindt, aangezien de cijfers in oudere vergelijkende artikelen uitgaan van vooraf laden.
Leest Claude Code AGENTS.md?
Ja, sinds v2.1.277, maar standaard alleen als er geen CLAUDE.md, .claude/CLAUDE.md of CLAUDE.local.md in uw werkmap of daarboven aanwezig is. Als uw repository beide bevat, leest Claude alleen de CLAUDE.md-bestanden. Verwijs daarom naar het ene bestand vanuit het andere in plaats van twee kopieën bij te houden. Voer ln -s AGENTS.md CLAUDE.md uit voor een eenvoudige symlink, of plaats @AGENTS.md op de eerste regel van een CLAUDE.md en voeg daaronder Claude-specifieke instructies toe. Start vervolgens een sessie en voer /context all uit om te bevestigen dat CLAUDE.md verschijnt onder Memory files.
Waarom heeft mijn skill halverwege een sessie geen effect meer?
Auto-compaction is meestal de oorzaak. Wanneer het gesprek wordt samengevat, koppelt Claude Code de meest recente aanroep van elke skill opnieuw, waarbij de eerste 5.000 tokens van elk worden behouden, binnen een gezamenlijk budget van 25.000 tokens voor alle skills samen. Dit budget wordt gevuld vanaf de meest recent aangeroepen skill. Als u dus meerdere grote skills heeft aangeroepen, worden de oudere volledig verwijderd. Roep de skill opnieuw aan om de volledige inhoud te herstellen.
Hoe voorkom ik dat een lang regelsbestand in elke sessie wordt geladen?
Verplaats de onderdelen die slechts soms relevant zijn naar .claude/rules/-bestanden met een paths-veld in hun frontmatter. Zo wordt elk bestand alleen geladen wanneer de agent een bijbehorend bestand aanraakt. Het opsplitsen van het bestand in @path-imports helpt niet, omdat geïmporteerde bestanden bij het opstarten worden uitgebreid en geladen naast het bestand dat ernaar verwees. Alles wat een procedure in meerdere stappen is in plaats van een vaststaand feit, moet een skill worden, aangezien de inhoud van een skill niets kost totdat deze wordt aangeroepen.