Claude Code is de codeeragent van Anthropic. Hij leest uw code, voert opdrachten uit en wijzigt bestanden vanuit de terminal, de IDE of de desktopapp. Die autonomie maakt hem waardevol. Daarom heeft hij ook een kader nodig voordat u hem in een team uitrolt.
Deze gids beschrijft de zeven beveiligingshefbomen die u moet configureren: rechtenmodi, regels, beheerde instellingen van de organisatie, de sandbox, MCP-servers, hooks en gegevensbeheer. De namen van instellingen en de voorbeelden komen uit de officiële documentatie van Claude Code en de changelog, bijgewerkt tot versie 2.1.319.
1. De juiste rechtenmodus kiezen
De rechtenmodus bepaalt wat Claude Code zonder te vragen mag doen. U stelt hem in met permissions.defaultMode of de optie --permission-mode.
| Modus | Wat zonder vragen wordt uitgevoerd | Aanbevolen gebruik |
|---|---|---|
default | Alleen leesacties | Werkplek van een ontwikkelaar |
acceptEdits | Leesacties, bestandswijzigingen en gangbare bestandsopdrachten | Ervaren ontwikkelaar op een bekend project |
plan | Leesacties, om een plan op te stellen zonder iets te wijzigen | Analyse en review |
auto | Alles, met veiligheidscontroles op de achtergrond | Teams die deze modus hebben goedgekeurd |
dontAsk | Leesacties en al toegestane tools, al het andere wordt geweigerd | Continuous integration en scripts |
bypassPermissions | Alles | Alleen geïsoleerde containers en virtuele machines |
Twee punten om te weten:
- Een projectbestand (
.claude/settings.json) kanautoenbypassPermissionsniet inschakelen. Een gekloonde repository kan zichzelf deze rechten dus niet toekennen. - De beheerder kan deze modi verbieden.
"permissions": {"disableBypassPermissionsMode": "disable"}blokkeertbypassPermissions, endisableAutoModeblokkeert de automodus. Bij de abonnementen Team en Enterprise is de automodus standaard beschikbaar.
2. Regels voor allow, ask en deny schrijven
De regels bepalen wat is toegestaan (allow), wat bevestiging vereist (ask) en wat wordt geweigerd (deny). Voorbeeld:
{
"permissions": {
"allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
"ask": ["Bash(git push *)"],
"deny": ["Read(./.env)", "Read(./.env.*)"]
}
}
Claude Code beoordeelt de regels in deze volgorde: deny, dan ask, dan allow. De eerste overeenkomst geldt. Een allow-regel kan een weigering dus nooit opheffen.
De regels gelden ook voor webdomeinen (WebFetch(domain:example.com)) en voor MCP-tools (mcp__serveur__outil).
Er is een beperking gedocumenteerd: regels die de argumenten van een Bash-opdracht filteren, zijn kwetsbaar. Een deny-regel kan worden omzeild als hetzelfde programma op een andere manier wordt aangeroepen, bijvoorbeeld via sh -c. Combineer deze regels met de netwerksandbox die hieronder wordt beschreven.
3. De configuratie centraliseren met beheerde instellingen
Claude Code leest zijn instellingen op meerdere niveaus. Van sterk naar zwak: beheerde instellingen van de organisatie, opdrachtregel, lokaal project (.claude/settings.local.json), gedeeld project (.claude/settings.json), dan gebruiker (~/.claude/settings.json).
De beheerde instellingen gelden verplicht voor alle werkplekken. Er zijn drie manieren om ze uit te rollen:
- Bestand
managed-settings.jsonin/Library/Application Support/ClaudeCode/(macOS),/etc/claude-code/(Linux en WSL) ofC:\Program Files\ClaudeCode\(Windows). - Tool voor apparaatbeheer (MDM): domein
com.anthropic.claudecodeop macOS, sleutelHKLM\SOFTWARE\Policies\ClaudeCodeop Windows. - Beheerconsole voor de abonnementen Team en Enterprise: Organization settings > Claude Code > Managed settings, alleen voor de rollen Owner en Primary Owner. Deze instellingen worden niet opgehaald als Claude Code via een gateway (
ANTHROPIC_BASE_URL) of een cloudprovider loopt.
Basisvoorbeeld voor een team:
{
"permissions": {
"disableBypassPermissionsMode": "disable",
"deny": ["Read(./.env)", "Read(./.env.*)"]
},
"sandbox": {
"enabled": true,
"failIfUnavailable": true,
"allowUnsandboxedCommands": false
}
}
De instelling allowManagedPermissionRulesOnly maakt de regels van de organisatie de enige geldige. Versie 2.1.319 voegt permissions.denyInsteadOfPrompting toe: een actie die op bevestiging zou wachten, wordt geweigerd en de sessie gaat door. Dat is handig voor sessies zonder iemand achter het scherm. Deze instelling staat voorlopig in de changelog, maar nog niet in de documentatie.
4. De sandbox inschakelen
De sandbox isoleert Bash-opdrachten. Hij staat standaard uit. Schakel hem in met de opdracht /sandbox of de instelling "sandbox": {"enabled": true}. Hij werkt op macOS, Linux en WSL2, maar niet op native Windows.
- Bestanden: schrijven is beperkt tot de werkmap. Standaard omvat lezen bijna de hele machine, inclusief sleutelmappen zoals
~/.ssh. Bescherm die met de instellingensandbox.filesystemensandbox.credentials. - Netwerk: elke verbinding loopt via een proxy die domeinnamen filtert. De lijst
sandbox.network.allowedDomainsis aanvankelijk leeg. Op organisatieniveau blokkeertsandbox.network.allowManagedDomainsOnlyelk niet-goedgekeurd domein.
De sandbox heeft grenzen. Hij geldt niet voor ingebouwde tools zoals het lezen van bestanden of het ophalen van webpagina's. Die tools volgen de rechtenregels. Uitgesloten opdrachten (excludedCommands) en opdrachten die de ontwikkelaar zelf met ! start, draaien ook buiten de sandbox.
5. MCP-servers beheersen
MCP (Model Context Protocol) is de standaard die Claude met uw tools verbindt: database, ticketsysteem, CRM. Elke MCP-server breidt uit wat Claude kan lezen en doen.
- Projectservers: servers die in het bestand
.mcp.jsonvan een repository staan, vereisen goedkeuring. Een gekloonde repository kan zijn eigen servers niet goedkeuren. - Lijsten van de organisatie:
allowedMcpServersendeniedMcpServersfilteren servers op URL, opdracht of naam. De weigerlijst heeft altijd voorrang.allowManagedMcpServersOnlymaakt de lijst van de organisatie de enige geldige. - Exclusieve controle: een bestand
managed-mcp.jsonlegt de volledige lijst van toegestane servers vast.
Voorbeeld van een allowlist:
{
"allowedMcpServers": [
{ "serverUrl": "https://*.intern.example.com/*" }
]
}
Nieuw in versie 2.1.319: wanneer een MCP-server een aanroep als taak uitvoert, zet Claude Code die op de achtergrond en ontvangt het resultaat later. De variabele CLAUDE_CODE_DISABLE_MCP_TASKS=1 schakelt dit gedrag uit.
6. Uw regels afdwingen met hooks
Hooks voeren uw eigen scripts uit op vaste momenten. De hook PreToolUse draait vóór elke actie en kan die blokkeren, bijvoorbeeld om een opdracht te weigeren die op een productieomgeving is gericht. Hij kan een deny-regel niet omzeilen.
Op organisatieniveau beperkt allowManagedHooksOnly de uitvoering tot hooks die de beheerder heeft gedefinieerd.
7. Uw gegevens onder controle houden
- Modeltraining. Onder commerciële voorwaarden (abonnementen Team en Enterprise, API, cloudplatforms) traint Anthropic zijn modellen niet op de code of de prompts die naar Claude Code worden gestuurd, tenzij de klant ervoor kiest zijn gegevens te delen. Voor persoonlijke accounts (Free, Pro, Max, Ultra) hangt dit af van een accountinstelling. Verplicht daarom zakelijke accounts.
- Bewaring. De standaardtermijn is 30 dagen voor commerciële accounts. Op de werkplek blijven de transcripties 30 dagen als platte tekst in
~/.claude/projects/staan. U kunt die termijn aanpassen metcleanupPeriodDays. - Nulbewaring. Nulbewaring van gegevens (in het Engels “zero data retention”) is mogelijk voor Enterprise-organisaties die in aanmerking komen, op aanvraag bij Anthropic.
- Cloudproviders en gateways. Claude Code kan via Amazon Bedrock (
CLAUDE_CODE_USE_BEDROCK=1), Google Cloud (CLAUDE_CODE_USE_VERTEX=1) of een interne LLM-gateway (ANTHROPIC_BASE_URL) lopen. De beheerde instellingallowedProviders: ["customEndpoint"]verplicht het gebruik van uw gateway.
Let op voor teams achter een LLM-gateway: sinds versie 2.1.319 worden in de automodus aanroepen die de server niet kan controleren, ter bevestiging voorgelegd of geweigerd. De variabele CLAUDE_CODE_AUTO_MODE_SERVER=0 herstelt de ingebouwde classifier.
8. Traceerbaarheid waarborgen
Claude Code exporteert zijn metrics en events via OpenTelemetry (CLAUDE_CODE_ENABLE_TELEMETRY=1). Prompts en de inhoud van tools worden standaard niet geëxporteerd. Bij de abonnementen Team en Enterprise is een gebruiksdashboard beschikbaar voor beheerders.
Actueel: het e-mailadres in webverzoeken
Begin november 2026 meldde een GitHub-ticket dat Claude in versie 2.1.318 soms het e-mailadres van het account in de User-Agent-header plaatste van opdrachten die hij schreef, bijvoorbeeld met curl. Het ging niet om een hardgecodeerde header: het adres stond in de context van het model.
Versie 2.1.317 had al een bevestiging toegevoegd voordat een web- of shellaanroep het e-mailadres van het account verstuurt. Volgens het ticket dekt deze bescherming nog niet alle gevallen. Schakel in afwachting van een volledige oplossing de netwerksandbox in met een lijst van toegestane domeinen, en houd Claude Code up-to-date. Versie 2.1.319 verhelpt ook meerdere omzeilingen van de rechtencontroles.
Checklist voor de uitrol
- Zakelijke accounts (Team, Enterprise of API) voor alle gebruikers.
- Beheerde instellingen uitgerold op alle werkplekken, met
bypassPermissionsuitgeschakeld. deny-regels voor gevoelige bestanden:.env, sleutels, certificaten.- Sandbox ingeschakeld met een lijst van toegestane domeinen.
- Allowlist van MCP-servers.
- Hooks voor kritieke acties, zoals deployments.
- OpenTelemetry-telemetrie naar uw monitoringtool.
- Regelmatige updates naar de nieuwste versie.
Veelgestelde vragen
Stuurt Claude Code onze code door om modellen te trainen?
Niet onder commerciële voorwaarden (Team, Enterprise, API en cloudplatforms), tenzij u ervoor kiest uw gegevens te delen. Bij persoonlijke accounts hangt dit af van een accountinstelling.
Kunnen we voorkomen dat een ontwikkelaar de beveiligingen uitschakelt?
Ja. De beheerde instellingen van de organisatie gaan vóór die van de gebruiker en het project. Ze kunnen de modi bypassPermissions en auto verbieden, de sandbox verplichten en MCP-servers beperken.
Is de sandbox voldoende?
Nee. Hij isoleert Bash-opdrachten, maar geen ingebouwde tools. Combineer hem met rechtenregels en een allowlist van domeinen.
Kunnen we Claude Code gebruiken zonder de API van Anthropic?
Ja, via Amazon Bedrock, Google Cloud of Microsoft Foundry, of via een interne LLM-gateway. Dan gelden de gegevensregels van de gekozen provider.
Laten we praten
ZetaBox heeft de status Certified in het Claude Partner Network. Wij helpen ontwikkelteams om Claude Code uit te rollen met instellingen, MCP-servers en processen die passen bij hun beveiligingseisen. Bekijk onze implementatiediensten voor Claude of neem contact op met ons team.


