Wat de proxy doet
Een Claude Code-proxy is elke server die jij draait tussen de coding CLI van Anthropic en het model dat antwoordt. Claude Code leest een omgevingsvariabele voor het API-adres en stuurt zijn verzoeken daarheen. Als dat adres een proxy is, beslist de proxy wat er echt gebeurt: het kan verkeer loggen, regels toevoegen of de call doorsturen naar een ander model.
Het belangrijkste detail is het wireformat. Claude Code gebruikt het Messages-formaat van Anthropic. De API op https://api.claudecodeproxyapi.com/v1 gebruikt het OpenAI Chat Completions-formaat, met model-ID uncensored. De twee lijken op elkaar, maar zijn niet uitwisselbaar, dus je kunt onze URL niet zomaar in Claude Code plakken. Een vertaallaag moet elk verzoek en elk antwoord herschrijven, inclusief streamingfragmenten en function calls.
Wat waar zit
| Deel | Spreekt | Taak |
|---|---|---|
| Claude Code CLI | Anthropic Messages-formaat | Plant bewerkingen, roept tools aan, toont diffs |
| Vertaalproxy (lokaal) | Beide formaten | Converteert verzoeken en streams, mappet modelnamen |
| Deze API | OpenAI Chat Completions | Draait het open-weight model, factureert per token |
Communityprojecten verzorgen het middelste deel. De proxy van LiteLLM en claude-code-router zijn twee die publiek gedocumenteerd zijn voor dit doel. Beide zijn software van derden, dus controleer hun huidige documentatie voor ondersteunde versies en flags voordat je erop voortbouwt. Als er iets misgaat, is de proxy probleemoplossingsgids de plek om te beginnen, en deze site heeft ook een apart stappenplan voor de setup.
Voordat je het instelt: wees eerlijk over het model
Claude Code is gebouwd rond de eigen modellen van Anthropic. Het vervangen door een ander model verandert het gedrag, en geen enkele proxy kan dat verbergen. Het model hier is een open-weight model van een onafhankelijke provider, getuned om te antwoorden zonder inhoudelijke weigeringen voor legaal gebruik door volwassenen. Het is geen Claude, en het is geen officiële API van Anthropic of een andere leverancier.
Wat het je wel geeft voor agent-style werk:
- Tool calling met
tools,tool_choiceen gestreamdetool_calls, met resultaten geretourneerd alsrole: "tool"berichten. - Een contextvenster van 100.000 tokens, prompt en completion samen.
- JSON-modus met
response_format, en streaming over SSE.
Wat je zelf moet verifiëren: hoe goed het een lange agent-loop volgt, hoe vaak het fout gevormde tool calls maakt, en hoe het omgaat met jouw taal en framework. Voer drie of vier echte taken uit je repository uit voordat je een hele workflow verplaatst. Het proeftegoed van $0,50, met één klik geclaimd na het inloggen, is daarvoor genoeg.
Test eerst de upstream
Voordat je Claude Code aanraakt, bevestig dat de API-kant werkt met een standaard verzoek, inclusief een tool call, omdat agents ervan afhankelijk zijn:
curl https://api.claudecodeproxyapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the files in the src folder."}],
"tools": [{
"type": "function",
"function": {
"name": "list_files",
"description": "List files in a directory",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"]
}
}
}],
"tool_choice": "auto"
}'
Een goed antwoord bevat een tool_calls vermelding met list_files en een JSON-argumentstring. Als je dat ziet, is de upstream klaar en behoort elk later probleem tot de proxy- of CLI-configuratie.
Twee routes, en wanneer je welke kiest
Route 1: een vertaalproxy voor Claude Code
Kies dit als je de Claude Code-interface, zijn toestemmingsmeldingen en zijn workflow leuk vindt, en een ander model erachter wilt. Je draait de proxy lokaal, wijst de CLI erop en mappet de modelnamen die de CLI stuurt naar uncensored. De exacte variabelen worden behandeld in de docs en het setup artikel.
Route 2: een client die OpenAI al spreekt
Verschillende open-source code-assistenten en editor-extensies, waaronder Aider, Continue en Cline, kunnen elk OpenAI-compatible endpoint direct gebruiken. Je voert de basis-URL, sleutel en modelnaam in en er is geen vertaallaag om te onderhouden. Als je de Claude Code-interface niet specifiek nodig hebt, is dit de kortere weg en heeft het minder onderdelen die kunnen breken.
Een vuistregel: kies route 2 voor een snelle trial van het model op code, en route 1 wanneer je team al vertrouwt op de Claude Code-workflow.
Kosten van een codesessie
Agents sturen veel context opnieuw, dus input tokens domineren de rekening. Neem een sessie van 30 verzoeken, elk met 20.000 tokens input (bestanden, geschiedenis, tool output) en 800 tokens output:
- Input: 30 x 20.000 = 600.000 tokens, wat 0,6 x $0,15 = $0,09 is
- Output: 30 x 800 = 24.000 tokens, wat 0,024 x $0,50 = $0,012 is
- Totaal: $0,102
Prijzen zijn $0,15 per 1M input tokens en $0,50 per 1M output tokens. Facturatie is van prepaid credit zonder abonnement, mislukte of geweigerde verzoeken worden niet in rekening gebracht, en credit vervalt niet. Opwaarderingen lopen van $20 tot $500 met bonussen van +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Deze site accepteert opwaarderingen met crypto (USDT op TRC20, USDC op Base). De prijspagina heeft de volledige tabel, en de sleutelpagina is waar je je aanmeldt met Google of e-mail.
Limieten die agent loops beïnvloeden
Een volledige key staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe. De trial key staat 2 gelijktijdige en 60 per minuut toe. Agents die subtaken verspreiden, kunnen eerst de limiet voor gelijktijdige verzoeken raken. De API antwoordt dan met HTTP 429 met de code concurrency, terwijl de limiet op verzoeken per minuut rate_limited retourneert. Een tijdelijke overbelasting retourneert ook 429, met Retry-After: 5. Een goede proxy probeert het opnieuw bij 429 na de wachttijd, en een gestreamd verzoek houdt zijn slot vast tot de stream eindigt, dus vastgelopen streams tellen mee voor jouw limiet.
De request body kan maximaal 8 MB zijn. Houd dit in gedachten als je tool grote bestanden in prompts plakt, en houd de hele prompt binnen het 100.000-token contextvenster.
Beveiligingsopmerkingen voor een lokale proxy
Een proxy bewaart je upstream-sleutel, dus behandel hem als alle andere inloggegevens. Bind het aan localhost, niet aan alle netwerkinterfaces, tenzij je echt nodig hebt dat andere machines er toegang toe krijgen. Sla de sleutel op in een omgevingsvariabele of een secrets manager in plaats van in een bestand dat in versiebeheer komt. Als je een proxy deelt met een team, geef het dan een eigen mastersleutel zodat je het kunt draaien zonder de upstream-sleutel aan te raken.
Vergeet ook niet wat een agent verstuurt. Een coding CLI verstuurt bestandsinhoud, commando-uitvoer en je prompts naar het model. Prompts worden hier niet gebruikt voor training, maar je moet nog steeds geheimen zoals privésleutels en .env-bestanden buiten de werkmap houden die de agent kan lezen.
Een eerlijke manier om het model op je code te evalueren
Kies drie taken van toenemende moeilijkheidsgraad uit een echte repository: een fix voor één bestand, een wijziging die drie bestanden raakt, en een kleine refactoring met tests. Voer elk uit met dezelfde prompt twee keer, één keer met je huidige model en één keer met uncensored, en houd notities bij vier dingen: pasten de wijzigingen schoon door, werden tool calls geparseerd, hoeveel retries waren nodig, en wat elke run kostte. Een uur hiermee vertelt je meer dan elk leaderboard.
Als het open-weight model tekortschiet op de moeilijkste taak, kun je het misschien nog steeds gebruiken voor goedkopere taken zoals het opstellen van tests, het schrijven van commit-berichten of het uitleggen van onbekende code. Omdat de facturatie pay-as-you-go is vanuit prepaid tegoed zonder abonnement, is er geen nadeel aan het alleen gebruiken voor die taken.
