Claude Code settings.json en omgevingsvariabelen: Base URL, Auth Token en model

Claude Code haalt de configuratie uit JSON-instellingenbestanden en omgevingsvariabelen. Als je het via een gateway wilt gebruiken in plaats van via de API van Anthropic, heb je twee variabelen nodig, ANTHROPIC_BASE_URL en een token, en meestal ook een model. De variabelen zijn eenvoudig. Wat mensen in verwarring brengt, is waar ze die moeten instellen, omdat dezelfde variabele kan voorkomen in je shell-profiel, in verschillende settings.json-bestanden en in de instellingen van VS Code.

Deze handleiding begint met een werkende configuratie en legt daarna uit waar de bestanden staan, welke waarde voorrang krijgt en welke fouten je waarschijnlijk tegenkomt. De informatie is gecontroleerd aan de hand van de documentatie van Anthropic en getest met AIHubMix op Claude Code 2.1.304 op 20 oktober 2026. De voorbeelden gebruiken AIHubMix als gateway; elke Anthropic-compatibele endpoint stel je op dezelfde manier in.

Kort samengevat

• Je persoonlijke instellingenbestand is ~/.claude/settings.json, of %USERPROFILE%\.claude\settings.json op Windows.
• Voor een gateway zet je ANTHROPIC_BASE_URL (zonder /v1) en ANTHROPIC_AUTH_TOKEN in het env-blok van dat bestand.
• Een waarde in het env-blok van een instellingenbestand overschrijft dezelfde variabele die in je shell is geëxporteerd.
• Zodra er een token is ingesteld, worden aanvragen niet meer via je Claude-abonnement verwerkt, maar gefactureerd door de gateway.
• De VS Code-extensie heeft dezelfde variabelen nodig in de eigen instelling claudeCode.environmentVariables.

Een werkende AIHubMix-configuratie

1. Maak een sleutel aan in de AIHubMix-console.
2. Zet dit in ~/.claude/settings.json. Maak het bestand aan als het nog niet bestaat.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-aihubmix-key"
  },
  "model": "claude-sonnet-5-5"
}

3. Voer een snelle test uit:

claude -p "1+1, output only the answer"

4. Start claude in een project. In de kop onder het logo moet iets staan als Sonnet 5.5 · API Usage Billing, en met /status zie je je gateway op de regel Anthropic base URL.

Twee details zijn belangrijk. De base URL is het basisadres: Claude Code voegt zelf /v1/messages toe, dus als een URL eindigt op /v1, mislukken alle aanvragen. AIHubMix gebruikt bovendien de eigen model-ID's van Anthropic, zoals claude-sonnet-5-5, zodat de snelkoppelingen sonnet, opus en haiku zonder extra configuratie werken.

De regel $schema is optioneel. Hiermee kunnen VS Code, Cursor en andere editors tijdens het typen fouten in het bestand markeren.

Je kunt dezelfde twee variabelen ook in je shell exporteren, maar een instellingenbestand is de betere plek: elke terminal, IDE-extensies en achtergrondagents kunnen het lezen.

Waar de instellingenbestanden staan

Zet nooit een token in het projectbestand .claude/settings.json, want dat wordt vastgelegd in git. Gebruik je gebruikersbestand of .claude/settings.local.json.

Instellingenbestanden moeten geldige JSON bevatten. Een opmerking met // of een komma achter het laatste item zorgt ervoor dat Claude Code het hele bestand overslaat, inclusief het token. Je krijgt dan het inlogscherm te zien in plaats van je gateway.

Verwar dit niet met ~/.claude.json, een afzonderlijk bestand in je thuismap. Dat bestand bevat de eigen status van Claude Code, zoals je aanmeldgegevens en MCP-servers, en hoef je zelden aan te passen.

Welke waarde krijgt voorrang?

Als meerdere bestanden dezelfde instelling bevatten, geldt de voorrangsvolgorde van instellingen van Anthropic, van hoog naar laag:

1. Beheerde instellingen van je organisatie
2. --settings op de opdrachtregel, alleen voor die sessie
3. .claude/settings.local.json
4. .claude/settings.json
5. ~/.claude/settings.json

Voor omgevingsvariabelen geldt nog een regel: een variabele in het env-blok van een instellingenbestand overschrijft dezelfde variabele uit je shell. Een export ANTHROPIC_BASE_URL=... in ~/.zshrc doet dus niets als een instellingenbestand die variabele ook instelt. Hulpmiddelen om van provider te wisselen schrijven meestal naar ~/.claude/settings.json, en daarom krijgen hun waarden voorrang op die in je shell.

In Claude Code toont /status op de regel Setting sources welke bestanden zijn geladen.

ANTHROPIC_AUTH_TOKEN of ANTHROPIC_API_KEY

Gebruik de variabele die je gateway leest. AIHubMix accepteert beide, en in de Claude Code-handleiding wordt ANTHROPIC_AUTH_TOKEN gebruikt; dat is ook de eenvoudigste keuze. Laat ze niet allebei ingesteld. Claude Code stuurt dan beide headers mee, en AIHubMix controleert eerst x-api-key: in onze test kreeg een correct token in settings.json toch een 401, omdat er een oude ANTHROPIC_API_KEY in de shell was geëxporteerd. Het env-blok overschrijft alleen de variabelen die erin zijn ingesteld. Verwijder dus de oude sleutel uit je shell-profiel wanneer je overschakelt.

Hoe zit het met je Claude-abonnement? Volgens de gatewayhandleiding van Anthropic worden aanvragen, zodra er een token- of API-sleutelvariabele is ingesteld, daarmee verwerkt in plaats van via je claude.ai-aanmelding, en brengt de gateway kosten per token in rekening. Je aanmelding blijft opgeslagen en wordt weer gebruikt zodra je de variabele verwijdert. Als je alleen ANTHROPIC_BASE_URL instelt, zonder token, blijf je je abonnement gebruiken.

Een model kiezen

De pagina van Anthropic over modelconfiguratie geeft deze volgorde, van hoog naar laag:

1. /model <name> tijdens een sessie
2. claude --model <name> bij het opstarten
3. De variabele ANTHROPIC_MODEL
4. De sleutel model in een instellingenbestand

/model slaat je keuze op als de nieuwe standaard. Maar als ANTHROPIC_MODEL is ingesteld, begint elke nieuwe sessie daar opnieuw mee. Als je vaak van model wisselt, stel dan de sleutel model in en laat ANTHROPIC_MODEL weg. Als nergens een model is ingesteld, gebruikt Claude Code Opus 5.5.

ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL en ANTHROPIC_DEFAULT_HAIKU_MODEL bepalen welk model elke snelkoppeling gebruikt. Je hebt ze alleen nodig als je een snelkoppeling naar een ander model wilt laten verwijzen, bijvoorbeeld om sonnet op een oudere versie te houden.

AIHubMix biedt ook modellen van andere leveranciers aan op hetzelfde adres, maar Anthropic ondersteunt Claude Code niet voor niet-Claude-modellen. Sommige functies werken daarmee dus mogelijk niet.

Wanneer wijzigingen van kracht worden

Claude Code houdt de instellingenbestanden in de gaten, en de meeste opgeslagen wijzigingen, waaronder die in het env-blok, worden toegepast op de actieve sessie. Voor de sleutel model, verwijderde variabelen en shell-exports moet je opnieuw opstarten. Start Claude Code opnieuw als je twijfelt.

De VS Code-extensie

De extensie leest dezelfde instellingenbestanden, maar controleert voordat deze start of je bent aangemeld. Daarvoor gebruikt de extensie de eigen instelling claudeCode.environmentVariables. Daarom kan VS Code je vragen om aan te melden terwijl de CLI wel werkt. Open Preferences: Open User Settings (JSON) vanuit het Command Palette en voeg het volgende toe:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://aihubmix.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-your-aihubmix-key" }
  ]
}

Voer daarna Developer: Reload Window uit. Meer opties vind je in de VS Code-documentatie van Anthropic. De Claude Desktop-app is een afzonderlijke toepassing: die leest noch settings.json, noch deze variabelen.

Andere handige variabelen

Je kunt ze allemaal in het env-blok zetten. De volledige lijst staat in het overzicht van omgevingsvariabelen van Anthropic.

Veelvoorkomende fouten en hun betekenis

Not logged in · Please run /login, of het inlogscherm bij de eerste start
Claude Code heeft geen token gevonden. Controleer drie dingen: een JSON-fout waardoor het bestand is overgeslagen, een ontbrekende ANTHROPIC_AUTH_TOKEN, of een token dat alleen in een projectbestand staat. De inlogstap wordt uitgevoerd voordat de projectinstellingen worden geladen, dus verplaats het token naar ~/.claude/settings.json.

Invalid or malformed JSON
Het bestand dat in het bericht wordt genoemd, bevat een opmerking, een komma achter het laatste item of een andere syntaxisfout. Geen van de instellingen uit dat bestand is toegepast.

There's an issue with the selected model (...)
De model-ID is onjuist, of de base URL eindigt op /v1 en de aanvraag is naar /v1/v1/messages gestuurd. Controleer eerst de URL als de model-ID er goed uitziet.

API Error: 400 met This model ID is incorrect
AIHubMix heeft geen model met die ID, en het bericht herhaalt de ID die het heeft ontvangen. Meestal is het een typefout. Kopieer de ID opnieuw uit de modellenlijst van AIHubMix.

Failed to authenticate. API Error: 401 invalid key: ...
AIHubMix accepteert de sleutel niet. Het bericht eindigt met de laatste zes tekens van de ontvangen sleutel. Vergelijk die dus met het einde van je token. PI_KEY betekent dat de tijdelijke aanduiding AIHUBMIX_API_KEY is geplakt in plaats van een echte sleutel. In alle andere gevallen is meestal een oude ANTHROPIC_API_KEY uit je shell meegestuurd. Staat er in plaats daarvan this key is not enabled, controleer dan in de AIHubMix-console of de sleutel is ingeschakeld en er tegoed op staat.

auth may not work as expected
Er is zowel een tokenvariabele als een opgeslagen claude.ai-aanmelding actief. Voer /logout uit om de gateway te blijven gebruiken, of verwijder de variabele om terug te keren naar je abonnement.

Claude Code doesn't recognize the model ...
Dit is een waarschuwing, geen fout: de aanvraag wordt nog steeds verzonden, maar Claude Code gaat uit van een contextvenster van 200K tokens. Als de ID bij een nieuwer Claude-model hoort, verhelpt claude update dit.

Het lijkt vast te lopen met een ongeldige sleutel
Claude Code probeert mislukte aanvragen maximaal 10 keer opnieuw. In een test met een sleutel die steeds werd afgewezen, bleef claude -p ongeveer drie minuten opnieuw proberen. Verlaag CLAUDE_CODE_MAX_RETRIES om de fout eerder te zien.

Als je één sleutel wilt gebruiken voor Claude in Claude Code en voor OpenAI, Google en andere leveranciers in je overige tools, biedt AIHubMix de Anthropic API aan op https://aihubmix.com. Het instellingenbestand hierboven is alles wat Claude Code nodig heeft.

Veelgestelde vragen

Waar staat het settings.json-bestand van Claude Code?
Je persoonlijke bestand is ~/.claude/settings.json, of %USERPROFILE%.claude\settings.json op Windows. Een project kan ook .claude/settings.json bevatten, dat via git wordt gedeeld, en .claude/settings.local.json, dat alleen voor jou is. Claude Code maakt deze bestanden niet aan tijdens de installatie.

Overschrijft settings.json omgevingsvariabelen?
Ja. Een waarde in het env-blok van een instellingenbestand overschrijft dezelfde variabele die in je shell is geëxporteerd. Variabelen die niet in het bestand zijn ingesteld, zoals een oude ANTHROPIC_API_KEY, blijven afkomstig uit de shell.

Moet ik ANTHROPIC_AUTH_TOKEN of ANTHROPIC_API_KEY gebruiken?
Gebruik de variabele die je gateway uitleest. ANTHROPIC_AUTH_TOKEN verstuurt een Bearer-token en vereist geen goedkeuring. Voor AIHubMix is ANTHROPIC_AUTH_TOKEN de aanbevolen keuze. Stel ze niet allebei in: AIHubMix leest eerst x-api-key, dus een verouderde ANTHROPIC_API_KEY veroorzaakt een 401-fout.

Moet ANTHROPIC_BASE_URL eindigen op /v1?
Nee. Claude Code voegt zelf /v1/messages toe. Gebruik voor AIHubMix https://aihubmix.com.

Moet ik Claude Code opnieuw starten nadat ik settings.json heb bewerkt?
De meeste wijzigingen, waaronder wijzigingen in env, worden van kracht zodra je het bestand opslaat. Voor de modelkey en shell-exporten is een herstart nodig. Opnieuw starten is de veiligste keuze.

Waarom vraagt VS Code me om in te loggen terwijl de CLI werkt?
Voordat de extensie start, controleert deze via de instelling claudeCode.environmentVariables of je bent ingelogd. Waarden in ~/.claude/settings.json zijn niet beschikbaar voor die controle. Voeg daar de base-URL en het token toe en laad het venster opnieuw.

Gebruikt het instellen van ANTHROPIC_BASE_URL mijn Claude-abonnement?
Alleen als er geen token is ingesteld. Als ANTHROPIC_AUTH_TOKEN of ANTHROPIC_API_KEY is ingesteld, gebruiken verzoeken die sleutel en brengt de gateway kosten per token in rekening.

Bronnen

• Instellingenbestanden en prioriteit, Anthropic
• Omgevingsvariabelen, Anthropic
• Claude Code verbinden met een LLM-gateway, Anthropic
• Modelconfiguratie, Anthropic
• Integratiehandleiding voor Claude Code, AIHubMix