Claude Code Custom API Endpoint: Oppsett med tredjepartsgateway for kinesiske åpne-kilde-modeller

Claude Code kan konfigureres til å kommunisere med en Anthropic-kompatibel endepunkt i stedet for å bruke en direkte leverandør-endepunkt. Dette gjør det mulig å teste en gateway-styrt arbeidsflyt med modell-ID-er som gatewayen tilbyr, inkludert kinesiske åpne-kilde-modeller som finnes i ECAIXs nåværende modellkatalog.

Dette veilederen omhandler en leverandør-spesifikk, tredjepartskompatibilitetsarbeidsflyt. Offisiell dokumentasjon fra Anthropic påpeker at Anthropic ikke støtter routing av Claude Code til ikke-Claus-modeller gjennom en gateway. ECAIX gjør ikke noe påstand om at denne arbeidsflyten er offisielt støttet av Anthropic, og en ikke-Claus-modell kan ikke tilby alle Claude Code-funksjonaliteter.

Hurtigstart

Hvis du allerede forstår kompatibilitetsgrensen, bruk denne korte veien først:

1. Åpne nåværende ECAIX-modellkatalog og velg en aktiv modell-ID.
2. Opprett en ECAIX-API-nøkkel og lag den utenfor kildekontroll.
3. Sett ANTHROPIC_BASE_URL til https://ecaix.com/api/ai/v1/anthropic.
4. Send den diagnostiske requesten under og notere HTTP-statusen.
5. Test Claude Code i en lesemodifisert testprosjekt med claude -p.
6. Test verktøy, streaming, kontekstgrenser og tillatelser separat.

Publiseringsvalideringsstatus

Denne tabellen er hensiktsmessig: en konfigurasjonseksempel er ikke det samme som en målt kompatibilitetsresultat.

Hva denne oppsetten endrer

Oppsetten har fire separate deler:

1. Claude Code er klienten som skaper programmeringsoppgaver og sender requester.
2. Anthropic-kompatible gateway mottar requester på en Anthropic-stil endepunkt.
3. Modell-ID velger den oppstrems modellen som gatewayen tilbyr.
4. API-nøkkel autentifiserer requesten og bestemmer kontoen, kvoten og tillatelsene.

Endring av endepunktet gjør ikke en ikke-Claus-modell til en Claus-modell. Det endrer bare hvilken kompatibel API-overflate som mottar requesten. Verktøysbruk, kontekthåndtering, modell-aliaser, streamingadferd og tillatelsesflyter kan variere etter klientversjon og gateway-implementasjon.

Før du starter

Du trenger:

• En Claude Code-installasjon som støtter miljø- eller innstillingsbasert endepunktkonfigurasjon.
• En ECAIX-API-nøkkel.
• En modell-ID som finnes i ECAIX-modellkataloget.
• En terminal hvor du kan kjøre en liten testrequest uten å plassere API-nøkkelen i kildekontroll.

Kataloget endrer seg over tid. Før du kopierer en modell-ID inn i en konfigurasjonsfil, åpner du ECAIX-modelldirektoriet og bekreter at modellen er aktiv og tilgjengelig for den API-stilen du planlegger å bruke.

Konfigurer gateway-endepunktet

Claude Code lagrer innstillinger i ~/.claude/settings.json på mange installasjoner. Den eksakte innstillingsstrukturen kan endre seg, så behandle følgende som et startmønster og sammenlign det med dokumentasjonen til din installerte versjon.

{
  "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"
}

Kommentér ikke denne filen i et offentlig repository hvis den inneholder en virkelig API-nøkkel. Foretrekker en lokal miljøvariabel, en hemmelighetsforvalter eller den anbefalte kredittilsynsmekanismen for din Claude Code-installasjon.

Du kan også konfigurere endepunktet i en shell-sesjon under testing:

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"

Variablene og innstillingene som støttes av en bestemt Claude Code-versjon kan endre seg. Hvis klienten ignorerer ANTHROPIC_MODEL, bruk modellfeltet eller modell-alias-mekanismen som er dokumentert for din versjon. Gatewayen trenger likevel å gjenkjenne den endelige modell-ID-en.

Verifiser Anthropic-kompatibelt endepunkt først

Før du starter en interaktiv programmerings-sesjon, send en liten request. Dette skiller ut endepunkt-, autentiserings- og modell-ID-problemer fra Claude Code-spesifikk adferd.

Kommandot under lagrer responshoder og responskroppen separat, og trykker deretter HTTP-statusen. Bruk en virkelig autorisert nøkkel bare i din lokale shell; aldri paste den inn i en artikkel, issue eller delt logg.

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."}
    ]
  }'

Forventet tolkning:

• 200: Inspekter responsstrukturen og bekræft at returnert modell eller bruksfelt er korrekt.
• 401 eller 403: Kontroller nøkkelen, hodefeltet, kontoen og tillatelsesområdet før du endrer prompten.
• 404: Kontroller baser URL, /messages-suffikset og endepunkt-deployeringen.
• 400: Reduser requesten til den minste gyldige kropp og kontroll modell-spesifikk felt.
• 5xx eller timeout: Noter requesttiden og responskroppen, og skille mellom gateway-, oppstrems- og klient-timeout-adferd.

En vellykket respons bekreter at nøkkelen, endepunktet, requestformatet og modell-ID-en fungerte sammen for denne requesten. Det bekrefter ikke at alle Claude Code-funksjoner vil fungere.

Test Claude Code etter API-kall fungerer

Når direkte kallen lykkes, start med en lesbare eller lavrisiko kommando:

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

Deretter test en smalere oppgave. For eksempel:

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

Bruk stadig mer krevende tester:

1. Enkel tekstrespons.
2. Kort kodeløsning.
3. Repositorynavigasjon.
4. En kontrollert redigering i en midlertidig grein.
5. Bruk av verktøy eller flerstegsoppgaver.
6. Streaming og langkontekst oppførsel.

Ikke antak at en vellykket tekstrespons beviser at tillatelsesprompter, verktøykall, streaming, kontekstbegrensninger eller filredigering oppfører seg identisk i et Claude-baket sesjon.

Velg riktig API-veipunkt

Claude Code er bare ett klientarbeidsfløye. Riktig API-veipunkt avhenger av klienten og funksjonsmengden du trenger:

For ECAIX, bruk Anthropic Messages-dokumentasjonen for Anthropic-stilveipunktet og Chat Completions-dokumentasjonen for OpenAI-kompatible klienter. Bruk modellkatalogen for å bekrefte den aktuelle modellen og pricing-siden for aktuell prissetting.

Kompatibilitetsmatrise

Den følgende matrisen er en publikasjons-tidspunkt begrensning, ikke en påstand om at alle funksjoner er støttet:

Denne forskjellen forhindrer at en vellykket minimal kall presenteres som en fullstendig Claude Code kompatibilitetsbevis.

Modellsidetider og aktuelle ID-er

Bruk modellsidetider i stedet for å kopiere gamle modellnavn fra blogginnlegg:

• DeepSeek v4.1 Flash
• Qwen 3.8 Flash
• GLM 5.3
• Kimi K3

Disse lenkene er inngangspunkter for å sjekke den aktuelle modell-ID, kontekstinformasjon og sidetid.

Etter en feil, bruk denne ordningen i stedet for å endre flere variabler samtidig:

1. Lagre HTTP-status og responskropp.
2. Bekrefte basert URL og endepunkt-suffiks.
3. Bekrefte at API-nøkkelen er tilgjengelig lokalt og har den forventede skope.
4. Bekrefte den eksakte modell-ID i den live modellkatalog.
5. Prøv med den minste gyldige kallen.
6. Sammenlign resultatet med klienten som sendte kallen av Claude Code.
7. Bare deretter undersøk oppstrøms ruting, timeout eller verktøyschema forskjeller.

For Modell ikke funnet, skiller dette en stavfeil fra en tillatelsesproblem, en gatevakt-mapping-problem og et oppstrøms leverandørfeil. For 401 og 403, endre ikke modell er vanligvis ikke første løsning. For en tekst-suksess/verktøysuksess tilstand, bør neste test være verktøyschemaet i stedet for en annen enkel tekstprompt.

Vanlige feil

Sikkerhet og databehandling

Behandle gatevakten som en separat tjenestegrense. Før du sender kildekode eller kunde-data, gjennomgå:

• Hvilken tjeneste mottar promptene og filinnholdet.
• Om kaller og respons er logget.
• Hvordan API-nøkler lagres og roteres.
• Om modellruten er en virkelig oppstrømsforbindelse eller en annen leverandørs-fallback-route.
• Hvilke verktøy klienten kan bruke.
• Hvordan du kan revoke nøkkelen etter en test.

Ikke paste en produktions-API-nøkkel i et offentlig issue, artikkel, skjermbilde eller skrivebordshistorie som deler seg med andre.

Hvordan dette skiller seg fra offisiell Claude Code-støtte

Offisiell Anthropic-dokumentasjon er autoriteten for Claude Code-støtte. En tredjeparts gatevakt kan vise en kompatibel kallesformat, men kompatibilitet er ikke det samme som offisiell støtte. Den sikre måten å beskrive denne arbeidsfløyen på er:

• Støttet av denne gatevaktkonfigurasjonen: endepunktet, autentiseringsheter, modell-ID-er og funksjoner som ECAIX har testet.
• Ikke automatisk støttet: alle Claude Code-funksjoner, ikke-Claude-modellopførsel, leverandør-spesifikk verktøysemantikk og fremtidige klientversjoner.
• Behov for retesting etter endringer: modelltilgjengelighet, kallesfelt, kontekstbegrensninger, streaming, verktøykall og priser.

FAQ

Trenger jeg en Claude-abonnements for denne arbeidsfløyen?

Det avhenger av din Claude Code-installasjon, kontovilkår og gatevaktkonfigurasjonen. Denne artikkelen endrer ikke Anthropics abonnement eller produktkrav. Verifiser den offisielle Claude Code-dokumentasjonen og gatevaktens vilkår du vil bruke.

Kan jeg bruke noen modell-ID fra katalogen?

Nei. Bruk en modell-ID som er synlig, aktiv og kompatibel med endepunktet og kontoen. En modell kan være tilgjengelig i en katalogen, men ikke tilgjengelig for en bestemt API-stil eller nøkkel.

Garanterer en Anthropic-kompatibel endepunkt verktøykall?

Nei. Protokollkompatibilitet og verktøysopførsel er separate tester. Kjør en liten funksjonskall-test og verifiser modellens nåværende dokumentasjon før du bruker verktøy i et automatisert arbeidsfløye.

Hvor skal jeg sjekke nåværende modeller og priser?

Bruk ECAIX-modellkatalogen og pricing-siden. Disse sidene er kilden til sannheten for nåværende tilgjengelighet og prissetting; ikke kopier gamle modell-ID-er eller priser fra denne artikkelen.

Sammenfatning

En sikker integrasjonssekvens er:

1. Les offisiell Claude Code og gatevakt-dokumentasjon.
2. Opprett en ECAIX-API-nøkkel uten å eksponere den offentlig.
3. Velg en aktuell modell-ID fra /models.
4. Konfigurer ANTHROPIC_BASE_URL og nøkkelen lokalt.
5. Test /api/ai/v1/anthropic/messages med en minimal kall.
6. Test Claude Code med en lesbare oppgave.
7. Test verktøy, streaming, kontekst og tillatelser separat.
8. Sjekk kompatibilitet hver gang klienten, gatevakten, modellen eller endepunktet endres.

For neste trinn, les Anthropic Messages API-dokumentasjonen, gjennomgå den nåværende modellkatalogen og opprett en nøkkel fra API-nøkler.

En en praktisk kompatibilitetsliste

Før du betrakter integrasjonen som nyttig for et team, notere resultatet av hver test:

| Streaming | Om hendelser ankommer i formatet som klienten forventer | | Tool kall | Om verktøyschemaet aksepteres og argumentene returneres korrekt | | Lang kontekst | Den største prompt som fullføres innen tidsgrensen din | | Filredigering | Om tillatelser og patch-applikasjon oppfører seg som forventet | | Feilbehandling | Hvordan klienten rapporterer rate-limiter, tidsutløp og oppstrømsfeil | | Nøkkelavslåing | Om testnøkkelen kan deaktiveres og erstattes |

Denne listen er mer nyttig enn en enkelt vellykket hilsing. En gateway kan akseptere en tekstanfrage mens den samtidig krever forskjellige innstillinger for verktøy, streaming, kontekstvinduer eller modellalternativer.

Når ikke å bruke konfigurasjonen

Bruk ikke denne oppsettet på sensitive produksjonsrepositorier før du forstår logging, oppbevaring, routing og tilgangskontroller. Ikke antag at en provider-kompatibel endepunkt gir samme sikkerhetsadferd, systemprompts, verktøyspermisjoner eller kontekstregnskap som den opprinnelige leverandøren. For regulerte eller konfidensielle arbeidslast, gjennomfør en internt sikkerhetsgranskning og bruk en deploimentsvei som din organisasjon har godkjent.

Bevare konfigurasjonen oppdatert

Vurder oppsettet når følgende endringer skjer:

• Claude Code blir oppgradert.
• Gateway endrer sin Anthropic-kompatible implementering.
• Modell-ID blir omdøpt, fjernet eller kartlagt til en annen opprinnelig modell.
• Streaming, verktøygrenser, kontekstbegrensninger eller feiladferd endres.
• ECAIX endrer modellene eller API-grensene som vises i den levende katalogen.

Bevar konfigurasjonen i et lite, dokumentert testprosjekt. Dette gjør det enklere å sammenligne adferden etter en klient- eller modelloppdatering uten å eksponere et produksjonsrepositorium.

Kilder

• Anthropic Claude Code: Andre LLM gateways
• DeepSeek API-dokumentasjon
• Qwen Quickstart
• Zhipu OpenAI API kompatibilitet