GitHub Copilot Chat mit Claude über ein Gateway: Einrichtung von Custom Endpoint, Agentenmodus und Fehlerbehebungen

Der Chat von VS Code kann mit Modellen arbeiten, die Sie selbst einbinden. Der integrierte Anthropic-Provider akzeptiert nur einen API-Schlüssel und bietet kein Feld für eine andere Adresse. Ein Gateway wird daher über den Provider „Benutzerdefinierter Endpunkt“ hinzugefügt. Wählen Sie den API-Typ Messages und listen Sie die Modelle in chatLanguageModels.json. Dies ist seit Version 1.122 Bestandteil der stabilen Version von VS Code.

Was die Nutzung eines eigenen Schlüssels abdeckt

Seit VS Code 1.122 funktionieren diese Modelle ohne Anmeldung bei GitHub und ohne Copilot-Tarif. Bei Copilot Business und Enterprise ist BYOK standardmäßig aktiviert. Administratoren können dies mit der Richtlinie **Eigenen Sprachmodellschlüssel verwenden** deaktivieren.

Das Gateway als benutzerdefinierten Endpunkt hinzufügen

1. Öffnen Sie die Chatansicht, öffnen Sie die Modellauswahl und wählen Sie **Sprachmodelle verwalten**, oder führen Sie **Chat: Sprachmodelle verwalten** über die Befehlspalette aus.
2. Wählen Sie **Modelle hinzufügen** und anschließend den Provider **Benutzerdefinierter Endpunkt**.
3. Geben Sie einen Anzeigenamen und Ihren Gateway-API-Schlüssel ein.
4. Wählen Sie den API-Typ **Messages**. VS Code öffnet dann chatLanguageModels.json für die Modellliste.

chatLanguageModels.json

[
  {
    "name": "AI Prime Tech",
    "vendor": "customendpoint",
    "apiKey": "${input:aiprimeApiKey}",
    "apiType": "messages",
    "models": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5",
        "url": "https://aiprimetech.io/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      },
      {
        "id": "claude-opus-5-5",
        "name": "Claude Opus 5.5",
        "url": "https://aiprimetech.io/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      },
      {
        "id": "claude-haiku-4-5",
        "name": "Claude Haiku 4.5",
        "url": "https://aiprimetech.io/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 168000,
        "maxOutputTokens": 32000
      }
    ]
  }
]

Beim Typ Messages sendet VS Code den Schlüssel im x-api-key Header, was den Erwartungen des Gateways entspricht. Modell-IDs müssen exakt mit denen des Gateways übereinstimmen.

GPT-Modelle mit demselben Schlüssel

Der Anbieter Custom Endpoint unterstützt auch die OpenAI-Formate. Um GPT-Modelle mit einem Schlüssel aus der Codex-Gruppe des Gateways hinzuzufügen, fügen Sie einen zweiten Anbieter hinzu mit "apiType": "chat-completions" und Modell-URLs nach dem Muster https://aiprimetech.io/v1/chat/completions. Ein Schlüssel ermöglicht nur den Zugriff auf die Modelle seiner eigenen Gruppe, daher benötigen Claude und GPT in der Regel separate Einträge mit separaten Schlüsseln.

Die ältere github.copilot.chat.customOAIModels Einstellung und der Anbieter **OpenAI Compatible** sind zugunsten von Custom Endpoint veraltet. Übertragen Sie alte Einträge nach chatLanguageModels.json.

Fehlerbehebung

Für Details führen Sie **Entwickler: Protokollebene festlegen** aus, wählen Sie **Trace**, öffnen Sie dann **Ausgabe** und wählen Sie **GitHub Copilot Chat**. Die Chat-Debugansicht zeigt die genauen Anfragen. Eine Protokollzeile, die besagt, dass BYOK Anbieter deregistriert wurden, weil die Richtlinie sie nicht zulässt, weist auf eine Organisationsrichtlinie hin.

Bevorzugen Sie das Terminal? Mit demselben Schlüssel läuft Claude Code in VS Code über eine eigene Erweiterung.

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.