🧭Claude Code gevorderd

Skills, commando’s & plugins in Claude Code

Merk je dat je dezelfde instructies steeds opnieuw typt? Dan hoort dat in een skill. Een skill is niets meer dan een map met een SKILL.md erin — en dat bestand laadt pas op het moment dat het nodig is. Daardoor kost een lange procedure je nul context zolang je hem niet gebruikt.

Waar staat wat?

Een skill in drie minuten

---
name: offerte
description: Maakt een SMSAK-offerte in huisstijl op basis van een klantvraag.
             Gebruik bij "offerte", "prijsvoorstel" of "voorstel voor klant".
---

# Offerte opstellen

## Stappen
1. Vraag naar: klantnaam, sector, gewenste diensten, deadline.
2. Kies het juiste pakket uit `prijzen.md` in deze map.
3. Schrijf de offerte volgens `sjabloon.md`.
4. Toon eerst een samenvatting; pas na goedkeuring het volledige document.

## Regels
- Altijd BTW-nummer en KBO vermelden
- Nooit een korting geven die niet in prijzen.md staat
- Geldigheidsduur: 30 dagen

Opslaan, en /offerte bestaat. De description is het belangrijkste veld: daaraan beslist Claude of de skill vanzelf relevant is. Schrijf er de trefwoorden in die je in de praktijk gebruikt.

Meegeleverde skills die je meteen kunt gebruiken

Plugins: skills, hooks en agenten in één pakket

/plugin                        # plugins beheren
/plugin marketplace add anthropics/skills
/plugin install code-review@claude-plugins-official
/reload-plugins                # na een wijziging

Permissies & hooks: veilig automatiseren

Claude Code vraagt standaard toestemming voor alles wat iets verandert. Dat is de juiste instelling om mee te beginnen — maar na een dag word je gek van de vragen. De oplossing is niet “alles toestaan”, maar gericht toestaan wat veilig is.

De permissiemodi

# Verkennend starten — niets kan stuk
claude --permission-mode plan

# Alleen deze commando's mogen zonder vragen
claude --allowedTools "Read" "Bash(git log *)" "Bash(npm test)"

# En deze nooit
claude --disallowedTools "Bash(rm *)" "Bash(git push *)"

Hooks: automatisch draaien rond elke actie

Een hook is een shell-commando dat Claude Code vóór of ná een bepaalde actie uitvoert. Het is de manier om regels af te dwingen die niet van goede wil afhangen — want de hook draait altijd, ook als het model iets vergeet.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npx prettier --write $CLAUDE_FILE_PATHS" }
        ]
      }
    ]
  }
}

Bekijk je actieve hooks met /hooks. Veelgebruikte toepassingen: automatisch formatteren na elke bewerking, linten vóór een commit, een notificatie sturen als een lange taak klaar is, of een gevaarlijk commando blokkeren.

Praktische veiligheidsregels

• Werk in git. Kleine commits maken elke fout omkeerbaar
• Nooit --dangerously-skip-permissions op je eigen machine met echte data — alleen in een container
• Geheimen in .env, nooit in de code, en .env in .gitignore
• Wantrouw wat Claude ínleest. Een issue, een webpagina of een PDF kan instructies bevatten die zich richten tot de AI — dat is data, geen opdracht (zie § 67)
• Zet een budget bij lange autonome taken: --max-budget-usd en --max-turns

Subagenten & dynamische workflows

Eén agent die alles doet, loopt bij grote taken vast op zijn eigen context: na dertig bestanden lezen is er geen ruimte meer om na te denken. De oplossing is werk uitbesteden aan subagenten — aparte Claude-sessies met hun eigen context, die enkel hun conclusie terugsturen.

Wanneer een subagent, wanneer niet

Subagenten definiëren

# Interactief beheren
> /agents

# Of ad hoc meegeven bij het starten
claude --agents '{"reviewer":{"description":"Kijkt code na op bugs",
  "prompt":"Je bent een strenge reviewer. Rapporteer alleen bevindingen die je kunt bewijzen."}}'

# Lopende agenten en sessies bekijken
> /list-agents
> /tasks

Het patroon dat het verschil maakt: zoeken → verifiëren

De meeste fouten van AI-agenten zijn plausibele bevindingen die niet kloppen. Het tegengif is een tweede agent die probeert de bevinding te weerleggen — niet om ze te bevestigen.

Achtergrondagenten en teams

Claude Code in je team & je pijplijn

Claude Code is niet beperkt tot jouw laptop. Het draait in je CI, beantwoordt meldingen in Slack, kijkt automatisch pull requests na en voert ’s nachts terugkerende taken uit — met dezelfde CLAUDE.md en dezelfde skills als in je terminal.

Claude Code in CI

name: Claude review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }
      - run: curl -fsSL https://claude.ai/install.sh | bash
      - run: |
          git diff origin/main --name-only | \
          claude -p "Review deze gewijzigde bestanden op bugs en beveiligingsproblemen. \
                     Rapporteer alleen wat je kunt bewijzen." \
                 --max-turns 15 --max-budget-usd 2.00
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

De Agent SDK: Claude Code als bibliotheek

Wil je Claude Code’s motor in je eigen software gebruiken — met de ingebouwde bestands-, bash- en zoektools, maar met jouw eigen sturing? Dan gebruik je de Agent SDK (claude-agent-sdk voor Python, @anthropic-ai/claude-agent-sdk voor TypeScript). Dat is iets anders dan de gewone Claude-API: de API geeft je een model, de Agent SDK geeft je een volledige agent.