Facade Code Dokumentation
Agenten konfigurieren

Claude Code + Ihr Provider

Behalten Sie Claude Code als CLI und verbinden Sie eine Startkonfiguration mit einem anderen Anthropic-kompatiblen Modell-Provider.

Die Angaben Ihres Providers

Installieren Sie Claude Code und besorgen Sie sich die Anthropic-kompatible Basis-URL, den API-Schlüssel und die Modell-IDs Ihres Providers. Ein rein OpenAI-kompatibler Endpunkt funktioniert mit Claude Code nicht.

Das Beispiel legt einen eigenen Eintrag Claude · work an. Ihre übrigen Claude Code-Einträge behalten ihre Einstellungen.

1. Die Provider-Konfiguration hinzufügen

Fügen Sie diese Konfiguration in facade.json ein (siehe Agenteneinstellungen). Ersetzen Sie Beispiel-URL, Schlüssel und Modell-IDs durch die Werte Ihres Providers:

facade.json
{
  "clis": {
    "Claude · work": {
      "type": "claude",
      "model": "YOUR_MODEL_ID",
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.example.com/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_API_KEY": null,
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_SMALL_MODEL_ID"
      }
    }
  }
}

Verwenden Sie für jeden Alias ein Modell, das Ihr Provider unterstützt. Die Haiku-Zuordnung wird für kleinere Hintergrundaufgaben genutzt und kann ein anderes Modell als das Hauptmodell verwenden.

2. Endpunkt und Modellzuordnungen prüfen

EinstellungFunktion
ANTHROPIC_BASE_URLLeitet Claude Code an die Anthropic-kompatible API des Providers.
ANTHROPIC_AUTH_TOKENÜbergibt das Token des Providers.
ANTHROPIC_API_KEY: nullEntfernt einen geerbten Anthropic-API-Schlüssel für diese Konfiguration.
modelLegt das Startmodell für diesen Eintrag fest.
ANTHROPIC_DEFAULT_…_MODELOrdnet Anfragen für Opus, Sonnet und Haiku IDs zu, die der Provider anbietet.

Im Beispiel steht der Schlüssel in facade.json. Um stattdessen eine vorhandene Umgebungsvariable zu lesen, verwenden Sie "ANTHROPIC_AUTH_TOKEN": "${env:WORK_API_KEY}". Diese Variable muss in der Umgebung des Editors verfügbar sein, bevor der Agent startet.

Diese Variablen gelten nur für Agenten, die mit diesem Eintrag gestartet werden. Ihre globalen Claude Code-Einstellungen müssen Sie nicht ändern.

3. Claude Code mit dieser Konfiguration starten

Speichern Sie facade.json, wählen Sie New Agent und dann Claude · work. Geben Sie dem Agenten eine kurze Aufgabe in Ihrem Projekt.

Wenn Ihr Provider die Nutzung ausweist, prüfen Sie, ob die Anfrage auf dem richtigen Konto erscheint. Lässt sich der Agent nicht starten oder schlägt die Anfrage fehl, führen Sie Show Agent Launch aus und wählen Sie den Arbeitsort. Suchen Sie den Eintrag im Bericht, um zu sehen, wie Facade ihn starten würde.

Bei Authentifizierungsfehlern oder fehlenden Modellen lesen Sie die Fehlerbehebung.

Beispiel: QwenCloud

Für einen Schlüssel aus dem QwenCloud Token Plan verwenden Sie https://token-plan.maas.qwencloudapi.com/apps/anthropic als Basis-URL. Wählen Sie Modell-IDs, die in Ihrem Tarif verfügbar sind. Schlüssel für nutzungsbasierte Abrechnung verwenden einen regionalen Endpunkt.

Aktuelle Endpunkt- und Modelleinstellungen von QwenCloud ↗

Als Markdown anzeigen ↗Dokumentation

Dokumentation durchsuchen

Diese Anleitung durchsuchen. Mit ↑ ↓ navigieren, Enter öffnet, Esc schließt.