Klara Code-kustomiserad API-ändpunkt: Tredjepartsgateway med kinesiska öppen-källkodsmodeller

Klara Code kan konfigureras för att kommunicera med en Anthropic-kompatibel ändpunkt istället för att använda en direktprovidersändpunkt. Detta gör det möjligt att testa en gatewayhanterad arbetsflöde med modell-ID:er som exponeras av gateways, inklusive de kinesiska öppen-källkodsmodeller som finns i ECAIX:s nuvarande modellkatalog.

Denna guide handlar om en providerspecifik, tredjepartskompatibilitetsarbetsflöde. Anthropics officiella Klara Code-gatewaydokumentation påpekar att Anthropic inte stödjer rutinledning av Klara Code till icke-Klara modeller genom en gateway. ECAIX gör inte någon påstående om att detta arbetsflöde är officiellt stött av Anthropic, och en icke-Klara modell kan inte tillhandahålla alla Klara Code-funktioner.

Snabbstart

Om du redan förstår kompatibilitetsgränsen, använd först den korta vägen:

1. Öppna ECAIX:s nuvarande modellkatalog och välj en aktiv modell-ID.
2. Skapa en ECAIX API-nöjdhet och håll den utanför källkoden.
3. Sätt ANTHROPIC_BASE_URL till https://ecaix.com/api/ai/v1/anthropic.
4. Skicka den diagnostiska begäran nedan och notera HTTP-statuskoden.
5. Kör Klara Code i ett läsbart testprojekt med claude -p.
6. Testa verktyg, streaming, kontextgränser och tillåtelser separat.

Publikationsvalideringsstatus

Tabellen är avsedd för att vara avsiktlig: en konfigurationsexempel är inte detsamma som en mätt kompatibilitet.

Vad denna konfiguration ändrar

Konfigurationen består av fyra separata delar:

1. Klara Code är klienten som skapar koduppgifter och skickar begäran.
2. Anthropic-kompatibla gateways tar emot begäran på en Anthropic-stiländpunkt.
3. Modell-ID väljer den uppströmsmodell som exponeras av gateways.
4. API-nöjdhet autentifierar begäran och bestämmer konto, kvot och tillåtelser.

Ändringen av ändpunkten gör inte om en icke-Klara modell till Klara. Det ändrar bara vilken kompatibel API-yta som tar emot begäran. Verktygsanvändning, hantering av kontext, modellalias, streamingbeteende och tillåtelseflöden kan variera beroende på klientversion och gateways implementation.

Innan du börjar

Du behöver:

• En Klara Code-installation som stödjer miljö- eller inställningsbaserad ändpunktkonfiguration.
• En ECAIX API-nöjdhet.
• En modell-ID som finns i ECAIX:s modellkatalog.
• En terminal där du kan köra en liten testbegäran utan att placera API-nöjdheten i källkoden.

Katalogen ändras över tid. Innan du kopierar en modell-ID till en konfigurationstabell, öppna ECAIX:s modeller katalog och bekräfta att modellen är aktiv och tillgänglig för den API-stil du planerar att använda.

Konfigurera gatewaysändpunkten

Klara Code lagrar inställningar i ~/.claude/settings.json på många installationer. Exakt schema för inställningarna kan ändras, så behandla följande som ett startmönster och jämför det med dokumentationen för din installerade version.

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

Försök inte lägga upp denna fil i en offentlig repository om den innehåller en verklig API-nöjdhet. Preferera en lokal miljövariabel, en hemlighetshanterare eller den kredentiemekanism som rekommenderas av din Klara Code-installation.

Du kan också konfigurera ändpunkten under ett testskript:

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"

Variablerna och inställningarna som stöds av en specifik Klara Code-utgåva kan ändras. Om klienten ignorerar ANTHROPIC_MODEL, använd modelfältet eller modellanalsmekanismen som dokumenteras av din version. Gateways måste fortfarande erkänna den slutgiltiga modell-ID:n.

Verifiera den Anthropic-kompatibla ändpunkten först

För att börja en interaktiv kodsession, skicka först en liten begäran. Detta skiljer ändpunkts-, autentiserings- och modell-ID-problem från Klara Code-specifika beteenden.

Kommandot nedan sparar responshuvuden och responsen separat, sedan trycker det ut HTTP-statuskoden. Använd en verklig godkänd nyckel endast i din lokala terminal; aldrig kopiera den in i en artikel, problem eller delad 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."}
    ]
  }'

Förväntad tolkning:

• 200: undersök responsens form och bekräfta vilka modeller eller användningsfält som returneras.
• 401 eller 403: kontrollera nyckeln, hädern, konto och tillåtelseområdet innan du ändrar prompten.
• 404: kontrollera basURL, /messages-ändelsen och ändpunktsdeploiementet.
• 400: minska begäran till den minsta giltiga kroppen och kontrollera modellspecifika fält.
• 5xx eller timeout: notera begärandetid och responsen, sedan skilja gateways, uppströms och klientens timeoutbeteende.

En framgångsrik respons bekräftar att nyckeln, ändpunkten, begärandeformaten och modell-ID:n fungerade tillsammans för den aktuella begäran. Det bevisar inte att alla Klara Code-funktioner kommer att fungera.

Testa Claude Code efter att API-anropet lyckats

När direktanropen lyckas, börja med en läsbart eller lågrisk kommandon:

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

Testa sedan en smalare uppgift. Till exempel:

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

Använd successivt mer krävande test:

1. Textsvarsformat.
2. Kort kodförklaring.
3. Repositorynavigering.
4. En kontrollerad redigering i en tillfällig gren.
5. Verktygsanvändning eller flerstegsuppgift.
6. Strömning och långkontextbeteende.

Använd inte att en framgångsrik textsvarsuppgift bevisar att tillståndsanrop, verktygsanrop, strömning, kontextbegränsningar eller filredigering fungerar identiskt i en Claude-bakade session.

Välj rätt API-ändpunkt

Claude Code är bara en av klientflödena. Den rätta API-ändpunkten beror på vilken klient och funktion du behöver:

För ECAIX används Anthropic Messages dokumentation för Anthropic-stilvägen och Chat Completions dokumentation för OpenAI-kompatibla klienter. Använd modellkatalogen för att bekräfta nuvarande modell och prissättningssidan för nuvarande prissättning.

Kompatibilitetsmatris

Den här matrisen är en publikationsdatumgräns, inte en påstående om att alla funktioner stöds:

Denna distinktion förhindrar att en framgångsrik minimalansökan framställs som en fullständig Claude Code kompatibilitetscertifiering.

Modellspecifikationer och nuvarande ID:er

Använd modellspecifikationssidor istället för att kopiera en gammal modellnamn från en bloggpost:

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

Dessa länkar är ingångar för att kontrollera den nuvarande modell-ID:n, kontextinformation och sidaspecifikationer. Tillgängligheten kan förändras efter publiceringen.

Efter ett fel, använd följande ordning istället för att ändra flera variabler samtidigt:

1. Spara HTTP-status och responskroppen.
2. Bekräfta basURL och ändpunktsuffix.
3. Bekräfta att APInyckeln finns lokalt och har den förväntade tillåtelsen.
4. Bekräfta den exakta modell-ID:n i den levande modellkatalogen.
5. Försök igen med den minsta giltiga ansökan.
6. Jämför resultatet med den klientansökan som skickades av Claude Code.
7. Enbart då undersök uppströmsruting, tidout eller verktygschema skillnader.

För "Modell inte hittad", skiljer det en stavfel från ett tillståndsproblem, en väggenomläggningsproblem och en uppströmsleverantörsfel. För "401" och "403", ändra modellen vanligen inte först. För en textlyckad/verktygsfel, bör nästa test vara verktygschemat istället för en annan textansökan.

Vanliga fel

Säkerhet och dathantering

Behandla väggen som en separat tjänstegräns. Före att skicka källkod eller kunddata, granska:

• Vilken tjänst tar emot promptar och filinnehåll.
• Om ansökningar och svar är loggade.
• Hur APInycklar lagras och byts ut.
• Om modellrutten är en verklig uppströmsanslutning eller en annan leverantörs fallback-route.
• Vilka verktyg klienten kan använda.
• Hur man avaktiverar nyckeln efter ett test.

När du inte ska kopiera en produktions-APInyckel i ett offentligt issue, artikel, skärmdump eller skripthistorik som delas med andra.

Praktisk kompatibilitetschecklista

För att bedöma om integrationen är användbar för ett team, dokumentera resultatet av varje test:

Denna checklista är mer användbar än ett enda framgångsrikt välkomnande. En port är kompatibel med textbegäran men kan kräva olika inställningar för verktyg, streaming, kontextfönster eller modellalias.

När inte att använda konfigurationen

Använd inte denna konfiguration för känsliga produktionsrepositorier förrän du förstått loggning, behållning, rutin och tillgångskontroller. Använd inte antagandet att en provider-kompatibel endpoint ger samma säkerhetsbeteende, systemprompts, verktygspermisser eller kontexträkning som den ursprungliga providören. För reglerade eller konfidentiella arbetsuppgifter, genomför en inhämtning av säkerhetsfrågor och använd en avlämningsväg som din organisation har godkänt.

Bevarande av konfigurationen

Granska konfigurationen när något av följande ändras:

• Claude Code uppgraderas.
• Porten ändrar sin Anthropic-kompatibla implementation.
• Modell-ID renamnförs, tas bort eller kartläggs till en annan uppströmsmodell.
• Streaming, verktygsgränser, kontextbegränsningar eller felbeteende ändras.
• ECAIX ändrar de modeller eller API-begränsningar som visas i den levande katalogen.

Håll konfigurationen i ett litet, dokumenterat testprojekt. Det underlättar jämförelsen av beteende efter en klient- eller modelluppdatering utan att exponera ett produktionsrepositorium.

Källor

• Anthropic Claude Code: Andra LLM-portar
• DeepSeek API-dokumentation
• Qwen Quickstart
• Zhipu OpenAI API kompatibilitet