Claude Code Custom API Endpoint: Opzetten van een derde-partijgateway met Chinese open-source modellen

Met Claude Code kunt u een endpoint gebruiken die compatibel is met Anthropic in plaats van een provider-endpoint direct te gebruiken. Hierdoor kunt u een door een gateway beheerde workflow testen met model-ID's die worden aangeboden door de gateway, inclusief Chinese open-source modellen die beschikbaar zijn in het huidige modelcatalogus van ECAIX.

Dit gidsartikel gaat over een provider-specifieke, derde-partijcompatibiliteitswerkflow. De officiële documentatie van Anthropic over de Claude Code gateway verklaart dat Anthropic geen ondersteuning biedt voor het routen van Claude Code naar niet-Claude modellen via een gateway. ECAIX claimt niet dat deze workflow officieel wordt ondersteund door Anthropic, en een niet-Claude model kan niet alle functies van Claude Code bieden.

Snelstart

Als je de compatibiliteitsgrenzen al begrijpt, volg eerst deze korte weg:

1. Open het actuele ECAIX modelcatalogus en kies een actieve model-ID.
2. Maak een ECAIX API-sleutel aan en houd deze buiten de broncode.
3. Stel ANTHROPIC_BASE_URL in op https://ecaix.com/api/ai/v1/anthropic.
4. Voer de diagnoseverzoek onderstaand uit en noteer de HTTP-statuscode.
5. Test Claude Code in een leesbare testproject met claude -p.
6. Test afzonderlijk de tools, streaming, contextbeperkingen en permissions.

Validatie status bij publicatie

Dit tabel is bedoeld: een configuratievoorbeeld is niet hetzelfde als een gemeten compatibiliteitsresultaat.

Wat verandert deze configuratie?

Deze configuratie bestaat uit vier afzonderlijke delen:

1. Claude Code is de client die codingopdrachten maakt en verzoeken stuurt.
2. De Anthropic-compatibele gateway ontvangt verzoeken op een Anthropic-stijl endpoint.
3. De model-ID selecteert de upstream-model die wordt aangeboden door de gateway.
4. De API-sleutel authenticert het verzoek en bepaalt de account, quotum en permissions.

Het veranderen van de endpoint maakt een niet-Claude model niet tot een Claude-model. Het verandert alleen welke compatibele API-interface het verzoek ontvangt. Gebruik van tools, contextbehandeling, modelaliases, streaminggedrag en permissionsflows kunnen variëren per clientversie en gatewayimplementatie.

Voorafgaand aan het starten

Je hebt nodig:

• Een installatie van Claude Code die ondersteuning biedt voor configuratie op basis van omgeving of instellingen voor de endpoint.
• Een ECAIX API-sleutel.
• Een model-ID die momenteel in het ECAIX modelcatalogus voorkomt.
• Een terminal waar je een klein testverzoek kunt uitvoeren zonder de API-sleutel in de broncode te plaatsen.

Het catalogus kan veranderen. Voordat je een model-ID kopieert naar een configuratiebestand, open het ECAIX modellenbestand en bevestig dat het model actief en beschikbaar is voor de API-stijl die je wilt gebruiken.

Configureer de gateway-endpoint

Claude Code slaat instellingen op in ~/.claude/settings.json op veel installaties. Het exacte schema van instellingen kan veranderen, dus behandel de onderstaande als een startpatroon en vergelijk het met de documentatie voor je geïnstalleerde versie.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

Plak dit bestand niet in een openbare repository als het een echte API-sleutel bevat. Voorkom een lokale omgevingssleutel, een secretsmanager of de aanbevolen credentiaalmechanisme voor je installatie van Claude Code.

Je kunt de endpoint ook configureren tijdens een shell-sessie terwijl je test:

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

De variabelnamen en instellingen die worden ondersteund door een bepaalde release van Claude Code kunnen veranderen. Als de client de ANTHROPIC_MODEL verwaarloost, gebruik dan het modelveld of de mechanismen voor modelaliases zoals beschreven in de documentatie van je versie. De gateway moet de eindige model-ID nog steeds herkennen.

Verifieer de Anthropic-compatibele endpoint eerst

Voordat je een interactieve coding sessie start, stuur een klein verzoek. Dit scheidt problemen met de endpoint, authenticatie en model-ID van gedrag dat specifiek is voor Claude Code.

De onderstaande command stopt de antwoordheaders en het antwoordlichter afzonderlijk en drukt de HTTP-statuscode. Gebruik een echte geautoriseerde sleutel alleen in je lokale shell; pas het nooit in een artikel, issue of gedeelde log in.

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

Interpretatie van het antwoord:

• 200: bekijk de vorm van het antwoord en bevestig de teruggegeven model of gebruiksfeld.
• 401 of 403: controleer de sleutel, het header, de account en de permissions voordat je de prompt wijzigt.
• 404: controleer de basis URL, het /messages suffix en de deployment van de endpoint.
• 400: verminder het verzoek tot het kleinste geldige lichaam en controleer de model-specifieke velden.
• 5xx of timeout: noteer de tijd van het verzoek en het antwoordlichter, en scheid het gedrag van de gateway, upstream en de client timeout.

Een succesvol antwoord bevestigt dat de sleutel, endpoint, verzoekformat en model-ID samenwerkten voor dit verzoek. Het bevestigt niet dat alle functies van Claude Code werken.

Kies een model-ID

Het ECAIX catalogus bevat modelfamilies van Chinese providers. De juiste startmodel hangt af van de taak, niet alleen van de modelnaam.

Coderen en algemene ontwikkeling

Start met een huidige DeepSeek, Qwen, GLM of Seed model die geschikt is voor coderen en die zichtbaar is in het catalogus. Bijvoorbeeld, een catalogus kan ID's zoals deepseek-v4.1-flash, qwen3.8-flash, glm-5.3 of seed-2.0-code aanbieden. Beschikbaarheid en capaciteiten kunnen veranderen, dus controleer altijd de huidige modelpagina voordat je een configuratie publiceert.

Lange context en repositorywerk

Voor grote repositories of lange technische documenten vergelijk de contextlengte die wordt weergegeven in het modelbestand. Een grotere contextvenster grootte betekent niet automatisch betere resultaten voor repositories: structuur van de prompt, ondersteuning voor tools, uitvoerbeperkingen en de beperkingen van de gateway voor verzoeken spelen ook een rol.

Tool-aanroepen en agentwerkvloei

Als de workflow functie-aanroepen of tools nodig heeft, controleer de documentatie van het model en de endpoint. Sommige providers bieden tool-aanroepen via OpenAI-compatibele APIs aan, terwijl anderen andere veldnamen bieden of slechts een deel van het toolgedrag ondersteunen. Begin met een kleine test voor tool-aanroepen voordat je de model toegang geeft tot een echte repository of externe systeem.

Ontwikkeling met Chinese taal

Chinese open-source modellen kunnen nuttig zijn als je codebasis, documentatie, issue-tracker of teamworkflow Chinese taal bevat. Evalueer het model met je eigen prompts en repositoryvoorbeelden in plaats van alleen op algemene rangschikkingen te vertrouwen.

Test Claude Code na het succesvolle API-verzoek

Als het directe verzoek succesvol is, begin met een leesbare of laagrisico-opdracht:

claude -p "Explain what this repository does without editing files."

Test vervolgens een nauw gespecificeerde taak. Bijvoorbeeld:

claude -p "List the likely entry points for the web application. Do not modify files."

Gebruik progressief meer uitdagende tests:

1. Tekstantwoord.
2. Korte codeverklaring.
3. Repositorynavigatie.
4. Een gecontroleerde bewerking in een tijdelijke branch.
5. Toolgebruik of meerstapsopdracht.
6. Streaming en gedrag met lange context.

Veronderstel niet dat een succesvol tekstantwoord betekent dat de permissionsprompts, tool-aanroepen, streaming, contextbeperkingen of bestandbewerking identiek zijn aan een Claude-gebaseerde sessie.

Kies de juiste API-route

Claude Code is slechts een clientwerkflow. De juiste API-route hangt af van de client en de functies die je nodig hebt:

Voor ECAIX gebruik de Anthropic Messages documentatie voor de Anthropic-stijl route en de Chat Completions documentatie voor clients die compatibel zijn met OpenAI. Gebruik de modellenbestand om de huidige model te bevestigen en de facturatiepagina om de huidige weergegeven facturatie te bevestigen.

Compatibiliteitsmatrix

De volgende matrix is een publicatietijd evidencegrens, niet een claim dat elke functie wordt ondersteund:

Dit onderscheid voorkomt dat een succesvol minimaal verzoek wordt gepresenteerd als een complete compatibiliteitscertificering.

Modeldetailleinden en huidige ID's

Gebruik de modeldetailleinden in plaats van een oude modelnaam uit een blogpost kopiëren:

• DeepSeek v4.1 Flash
• Qwen 3.8 Flash
• GLM 5.3
• [K