Claude Code-Kustomisierte API-Endpunkt: Einrichtung eines Drittanbieter-Gateways mit chinesischen Open-Source-Modellen

Claude Code kann mit einem anthropic-kompatiblen Endpunkt konfiguriert werden, anstatt direkt mit einem Anbieter-Endpunkt zu kommunizieren. Dadurch ist es möglich, einen von einem Gateway verwalteten Workflow mit Modell-IDs zu testen, die vom Gateway bereitgestellt werden, einschließlich chinesischer Open-Source-Modelle, die sich in der aktuellen Modellkataloge von ECAIX befinden.

Diese Anleitung befasst sich mit einem anbieter-spezifischen, Drittanbieter-Kompatibilitätsworkflow. Die offizielle Dokumentation von Anthropic zu Claude Code erklärt, dass Anthropic keine Unterstützung für die Routing von Claude Code zu nicht-Claude-Modellen über ein Gateway bereitstellt. ECAIX behauptet nicht, dass dieser Workflow offiziell von Anthropic unterstützt wird, und ein nicht-Claude-Modell kann möglicherweise nicht alle Funktionen von Claude Code bieten.

Schnellstart

Wenn Sie die Kompatibilitätsgrenzen bereits verstehen, gehen Sie mit diesem kurzen Pfad zuerst vor:

1. Öffnen Sie den aktuellen ECAIX-Modellkatalog und wählen Sie eine aktive Modell-ID.
2. Erstellen Sie eine ECAIX-API-Schlüssel und halten Sie ihn außerhalb des Quellcodes.
3. Setzen Sie ANTHROPIC_BASE_URL auf https://ecaix.com/api/ai/v1/anthropic.
4. Senden Sie die Diagnoseanfrage unten und notieren Sie den HTTP-Status.
5. Führen Sie Claude Code in einem lesenden Testprojekt mit claude -p aus.
6. Testen Sie Tools, Streaming, Kontextgrenzen und Berechtigungen separat.

Verifizierter Status bei Veröffentlichung

Diese Tabelle ist beabsichtigt: eine Konfigurationsbeispiel ist nicht dasselbe wie ein gemessenes Kompatibilitätsergebnis.

Was diese Einrichtung ändert

Die Einrichtung besteht aus vier separaten Teilen:

1. Claude Code ist der Client, der Coding-Aufgaben erstellt und Anfragen sendet.
2. Das anthropic-kompatible Gateway empfängt Anfragen an einem anthropic-ähnlichen Endpunkt.
3. Die Modell-ID wählt das von dem Gateway exponierte Upstream-Modell aus.
4. Der API-Schlüssel authentifiziert die Anfrage und bestimmt die Konten-, Nutzungsbegrenzung und Berechtigungen.

Ändern Sie den Endpunkt nicht, um ein nicht-Claude-Modell zu einem Claude-Modell zu machen. Er ändert nur, welche kompatible API-Oberfläche die Anfrage empfängt. Die Nutzung von Tools, die Verarbeitung von Kontext, Modell-Aliassen, Streaming-Verhalten und Berechtigungsflüsse können je nach Client-Version und Gateway-Implementierung variieren.

Vor dem Start

Sie benötigen:

• Eine Installation von Claude Code, die die Konfiguration eines Endpunkts über Umgebungsvariablen oder Einstellungen unterstützt.
• Einen ECAIX-API-Schlüssel.
• Eine Modell-ID, die derzeit im ECAIX-Modellkatalog vorhanden ist.
• Einen Terminal, in dem Sie eine kleine Testanfrage ausführen können, ohne den API-Schlüssel in den Quellcode aufzunehmen.

Der Katalog ändert sich über die Zeit. Bevor Sie eine Modell-ID in eine Konfigurationsdatei kopieren, öffnen Sie den ECAIX-Modellverzeichnis und bestätigen Sie, dass das Modell aktiv und für den gewünschten API-Stil verfügbar ist.

Konfigurieren des Gateways

Claude Code speichert Einstellungen in ~/.claude/settings.json auf vielen Installationen. Die genaue Schema-Struktur kann sich ändern, daher behandeln Sie die folgenden Einstellungen als einen Anfangs-Muster und vergleichen Sie sie mit der Dokumentation für Ihre installierte 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ügen Sie diese Datei nicht in einen öffentlichen Repository ein, wenn sie einen echten API-Schlüssel enthält. Bevorzugen Sie stattdessen eine lokale Umgebungsvariable, einen Secrets Manager oder die von Ihrer Claude Code-Installation empfohlene Authentifizierungsmechanismus.

Sie können die Konfiguration auch während eines Test-Shell-Sitzung ausführen:

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"

Die Namen der Variablen und von einer bestimmten Claude Code-Version unterstützten Einstellungen können sich ändern. Wenn der Client die Modell-ID ignoriert, verwenden Sie die Modellfeld- oder Modell-Alias-Methode, die in der Dokumentation für Ihre Version beschrieben ist. Das Gateway muss jedoch die finale Modell-ID erkennen.

Anthropic-kompatiblen Endpunkt zuerst verifizieren

Bevor Sie eine interaktive Coding-Sitzung starten, senden Sie eine kleine Anfrage. Dies trennt Probleme mit dem Endpunkt, der Authentifizierung und der Modell-ID von Verhalten, das spezifisch für Claude Code ist.

Die folgende Befehlszeile speichert die Antwort-Header und den Antwortkörper separat und gibt dann den HTTP-Status aus. Verwenden Sie einen echten, autorisierten Schlüssel nur in Ihrer lokalen Shell; nie in einem Artikel, einer Issue oder einem geteilten Log einfügen.

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

Interpretation der Erwartungsergebnisse:

• 200: Prüfen Sie die Antwortstruktur und bestätigen Sie die zurückgegebenen Modell- oder Nutzungsfelder.
• 401 oder 403: Prüfen Sie den Schlüssel, die Kopfzeile, das Konto und den Berechtigungsscope, bevor Sie den Prompt ändern.
• 404: Prüfen Sie die Base URL, den Pfad /messages und die Endpunktverfügbarkeit.
• 400: Reduzieren Sie die Anfrage auf den kleinsten gültigen Körper und prüfen Sie die modellspezifischen Felder.
• 5xx oder Timeout: Notieren Sie die Anfragedauer und den Antwortkörper, trennen Sie dann das Gateway-, Upstream- und Client-Timeout-Verhalten.

Eine erfolgreiche Antwort bestätigt, dass der Schlüssel, der Endpunkt, die Anfrageformatierung und die Modell-ID für diese Anfrage zusammenwirkten. Sie beweist jedoch nicht, dass alle Funktionen von Claude Code funktionieren.

Modell-ID auswählen

Der ECAIX-Katalog enthält Modellfamilien von chinesischen Anbietern. Die richtige Ausgangsmodell-ID hängt von der Aufgabe ab, nicht nur vom Modellnamen.

Programmieren und allgemeine Entwicklung

Starten Sie mit einem aktuellen DeepSeek-, Qwen-, GLM- oder Seed-Modell, das für Programmieren geeignet ist und im Katalog sichtbar ist. Zum Beispiel könnte der Katalog IDs wie deepseek-v4.1-flash, qwen3.8-flash, glm-5.3 oder seed-2.0-code anzeigen. Verfügbarkeit und Fähigkeiten können sich ändern, also prüfen Sie immer die aktuelle Modellseite vor der Veröffentlichung einer Konfiguration.

Langer Kontext und Repository-Arbeit

Für große Repositories oder lange technische Dokumente vergleichen Sie die Kontextlänge, die in der Modellseite angezeigt wird. Eine größere Kontextfenstergröße bedeutet nicht automatisch bessere Ergebnisse für Repositories: Prompt-Struktur, Tool-Unterstützung, Ausgabegrenzen und die Request-Grenzen des Gateways spielen ebenfalls eine Rolle.

Toolaufrufe und Agentenworkflows

Wenn der Workflow Toolaufrufe oder Tools benötigt, prüfen Sie die Dokumentation des Modells und des Endpunkts. Manche Anbieter bieten Toolaufrufe über OpenAI-kompatible APIs an, während andere andere Feldnamen verwenden oder nur einen Teil des Toolverhaltens unterstützen. Starten Sie mit einem kleinen Toolaufruf-Test vor der Bereitstellung des Modells für ein echtes Repository oder eine externe Systemumgebung.

Chinesischsprachige Entwicklungsarbeit

Chinesische Open-Source-Modelle können nützlich sein, wenn die Codebasis, die Dokumentation, das Problemverfolgungs-Tool oder der Teamworkflow chinesischsprachige Materialien enthält. Bewerten Sie das Modell mit Ihren eigenen Prompts und Repository-Beispielen, statt nur auf allgemeine Ranglisten zu vertrauen.

Claude Code nach erfolgreicher API-Anfrage testen

Sobald die direkte Anfrage erfolgreich ist, starten Sie mit einer lesenden oder geringen Risiko-Anfrage:

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

Dann testen Sie eine eng begrenzte Aufgabe. Zum Beispiel:

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

Nutzen Sie schrittweise anspruchsvollere Tests:

1. Textantwort.
2. Kurze Code-Erklärung.
3. Repository-Navigation.
4. Eine kontrollierte Bearbeitung in einer temporären Verzweigung.
5. Toolnutzung oder Mehrschritt-Aufgabe.
6. Streaming- und langkontextiges Verhalten.

Vermeiden Sie die Annahme, dass eine erfolgreiche Textantwort bedeutet, dass die Berechtigungsanfragen, Toolaufrufe, Streaming, Kontextgrenzen oder Dateibearbeitung identisch zu einer Claude-basierten Sitzung sind.

Die richtige API-Pfadwahl

Claude Code ist nur ein Client-Workflow. Die richtige API-Pfadwahl hängt vom gewünschten Client und der Funktion ab:

Für ECAIX verwenden Sie die Anthropic Messages Dokumentation für den anthropic-ähnlichen Pfad und die Chat Completions Dokumentation für OpenAI-kompatible Clients. Verwenden Sie die Modellverzeichnis-Seite, um die aktuelle Modell-ID zu bestätigen und die Preisseite für die aktuelle angezeigte Preisinformation.

Kompatibilitätsmatrix

Die folgende Matrix ist eine Evidenz-Grenze bei der Veröffentlichung, nicht eine Aussage, dass alle Funktionen unterstützt werden:

Diese Unterscheidung verhindert, dass eine erfolgreiche minimale Anfrage als vollständige Zertifizierung der Kompatibilität von Claude Code dargestellt wird.

Modell-Detailloseiten und