> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Copilot einrichten: Installation, API Key, Base URL und eigene Modelle

> Installiere GitHub Copilot, konfiguriere die BetterToken Base URL und API Key, wähle ein kompatibles Provider-Modell und behebe häufige Fehler.

Um GitHub Copilot mit BetterToken zu verbinden, bereite einen API Key vor, trage die unten angezeigte Base URL ein und wähle eine aktuelle Model ID aus der model plaza.

## Wichtige Einstellungen

| Feld                     | Wert                                                                                      |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| API Key                  | BetterToken API Key                                                                       |
| Vollständige Request-URL | `https://www.bettertoken.ai/v1/chat/completions`                                          |
| Model                    | Eine aktuelle Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |

## Voraussetzungen

* Die aktuelle Version des Tools ist installiert
* Ein BetterToken API Key: <a href={"https://bettertoken.ai/register"}>Registriere dich und erhalte einen</a>
* Eine Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a>

### Zusätzliche Anforderungen

* Neueste Version von VS Code installiert
* GitHub Copilot / Copilot Chat installiert und angemeldet
* Die ausgewählte Model ID stammt vom **unterstützten Provider**
* Eine Model ID ist verfügbar, zum Beispiel `YOUR_MODEL_ID`

<Warning>
  Schreibe deinen echten API Key nicht manuell in `chatLanguageModels.json`. Füge ihn in die API-Key-Abfrage von VS Code ein. VS Code erzeugt eine lokale Secret-Referenz wie `${input:chat.lm.secret...}`.
</Warning>

## Installation

Installiere oder öffne GitHub Copilot und fahre dann mit der manuellen Einrichtung unten fort.

## Manuelle Einrichtung

| Feld                     | Wert                                                                                      |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| API Key                  | BetterToken API Key                                                                       |
| Vollständige Request-URL | `https://www.bettertoken.ai/v1/chat/completions`                                          |
| Model                    | Eine aktuelle Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |

### Einrichtungsschritte

<Steps>
  <Step title="Modellverwaltung öffnen">
    Klicke im Eingabebereich von Copilot Chat auf die Modellauswahl und wähle dann **Manage Models...**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/github-copilot/manage-models-entry.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=3da2a3bfd2075089badec39f1539163f" alt="Manage Models über die Modellauswahl von Copilot Chat öffnen." style={{ borderRadius: '0.5rem' }} width="3012" height="1600" data-path="images/github-copilot/manage-models-entry.png" />
    </Frame>
  </Step>

  <Step title="Custom Endpoint hinzufügen">
    Klicke in **Language Models** auf **Add Models** und wähle dann **Custom Endpoint**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/github-copilot/add-custom-endpoint.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=4337457654b042759dc2ff9dd91e8361" alt="In Language Models auf Add Models klicken und Custom Endpoint auswählen." style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/github-copilot/add-custom-endpoint.png" />
    </Frame>
  </Step>

  <Step title="Gruppennamen eingeben">
    Gib in **Group Name** Folgendes ein:

    ```text theme={null}
    BetterToken
    ```

    Drücke anschließend **Enter**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/github-copilot/group-name.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=9f1b743614a84b36b9581f515c50ac28" alt="BetterToken in das Eingabefeld Group Name eingeben." style={{ borderRadius: '0.5rem' }} width="2940" height="1644" data-path="images/github-copilot/group-name.png" />
    </Frame>
  </Step>

  <Step title="API Key eingeben">
    VS Code fordert den API Key an. Füge deinen BetterToken API Key ein und drücke **Enter**.

    Dieser Wert wird nicht direkt in der Konfigurationsdatei angezeigt. VS Code speichert ihn als lokales Secret und erzeugt eine Referenz wie diese:

    ```json theme={null}
    "apiKey": "${input:chat.lm.secret.xxxxx}"
    ```

    <Warning>
      Ersetze `${input:chat.lm.secret...}` nicht durch deinen echten API Key. Behalte die von VS Code erzeugte Secret-Referenz bei.
    </Warning>
  </Step>

  <Step title="API-Typ auswählen">
    Wähle in **Custom Endpoint: API Type** **Chat Completions** aus.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/github-copilot/select-chat-completions.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=f6913b1b4f19834d2ad35b26028f2fc3" alt="Chat Completions in Custom Endpoint API Type auswählen." style={{ borderRadius: '0.5rem' }} width="3012" height="1600" data-path="images/github-copilot/select-chat-completions.png" />
    </Frame>
  </Step>

  <Step title="JSON-Konfiguration bearbeiten">
    VS Code öffnet `chatLanguageModels.json`. Bestätige oder aktualisiere die Konfiguration:

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/github-copilot/chat-language-models-json.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=5fc645433f29b1414ddc0cd5a9147ba0" alt="BetterToken-Modell-URL, toolCalling, vision und Token-Limits in chatLanguageModels.json konfigurieren." style={{ borderRadius: '0.5rem' }} width="2698" height="1414" data-path="images/github-copilot/chat-language-models-json.png" />
    </Frame>

    ```json theme={null}
    [
      {
        "name": "BetterToken",
        "vendor": "customendpoint",
        "apiKey": "${input:chat.lm.secret.xxxxx}",
        "apiType": "chat-completions",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID",
            "url": "https://www.bettertoken.ai/v1/chat/completions",
            "toolCalling": true,
            "vision": true,
            "maxInputTokens": 1000000,
            "maxOutputTokens": 64000
          }
        ]
      }
    ]
    ```

    Prüfe diese Felder:

    | Feld              | Empfohlener Wert                                                                                                                           |
    | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
    | `name`            | `BetterToken`                                                                                                                              |
    | `apiType`         | `chat-completions`                                                                                                                         |
    | `id`              | `YOUR_MODEL_ID` oder eine andere Model ID eines unterstützten Providers aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |
    | `name`            | Gleich der Model ID                                                                                                                        |
    | `url`             | `https://www.bettertoken.ai/v1/chat/completions`                                                                                           |
    | `toolCalling`     | `true`                                                                                                                                     |
    | `vision`          | `true`                                                                                                                                     |
    | `maxInputTokens`  | `1000000`                                                                                                                                  |
    | `maxOutputTokens` | `64000`                                                                                                                                    |
  </Step>

  <Step title="VS Code speichern und neu laden">
    Speichere `chatLanguageModels.json` und führe dann Folgendes aus:

    ```text theme={null}
    Developer: Reload Window
    ```

    Kehre nach dem Neuladen zur Modellauswahl von Copilot Chat zurück und wähle `YOUR_MODEL_ID`.
  </Step>

  <Step title="Testnachricht senden">
    Sende eine einfache Nachricht in Copilot Chat:

    ```text theme={null}
    Describe the model you are using in one sentence.
    ```

    Wenn Copilot Chat normal antwortet, ist der BetterToken Custom Endpoint erfolgreich konfiguriert.
  </Step>
</Steps>

## Verbindung überprüfen

Sende eine kurze Testanweisung. Wenn das Tool ohne Authentifizierungs- oder Model-ID-Fehler antwortet, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu.

## Modelle wechseln

Öffne die Modellauswahl oder ändere das Feld `Model` in der Konfiguration. Verwende die genaue Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a> und starte dann die aktuelle Sitzung neu.

## Häufige Fehler

### Warum soll ich den API Key in der Abfrage eingeben?

VS Code speichert den API Key im lokalen Secret-Speicher und referenziert ihn in JSON mit `${input:chat.lm.secret...}`. Das ist sicherer als den echten API Key in die JSON-Datei zu schreiben.

### Warum Chat Completions verwenden?

Die verifizierte funktionierende Konfiguration verwendet **Chat Completions**. Die URL lautet:

```text theme={null}
https://www.bettertoken.ai/v1/chat/completions
```

Verwende nicht `/v1/responses` und höre nicht bei `/v1` auf.

### Ersetzt dies die GitHub-Copilot-Inline-Vervollständigung?

Nein. Dieser Custom Endpoint wird hauptsächlich für Sprachmodellaufrufe von Copilot Chat verwendet. Die GitHub-Copilot-Inline-Vervollständigung wird weiterhin von GitHub Copilot selbst bereitgestellt.

### Was soll ich bei Invalid token tun?

Prüfe diese Punkte der Reihe nach:

1. Der API Key wurde in der VS-Code-Abfrage eingegeben
2. JSON behält die Referenz `${input:chat.lm.secret...}` bei
3. Die ausgewählte Model ID stammt vom **unterstützten Provider**
4. `url` ist `https://www.bettertoken.ai/v1/chat/completions`
5. `apiType` ist `chat-completions`
6. Die Model ID ist ein Modell eines unterstützten Providers aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a>

## Advanced setup

## Unterstützte Provider

| Provider | Status                 |
| -------- | ---------------------- |
| Claude   | Nicht unterstützt      |
| GPT      | Manuelle Konfiguration |
| Kimi     | Manuelle Konfiguration |
| GLM      | Manuelle Konfiguration |

<Note>Die Statusangaben gelten für die auf dieser Seite beschriebene BetterToken-Konfiguration.</Note>

<Accordion title="Bedeutung der Einrichtungsmethoden">
  * **Manuelle Konfiguration**: Gib API Key, Base URL und Model ein.
  * **Nicht unterstützt**: Derzeit gibt es keine verifizierte Methode für die direkte Verbindung.
</Accordion>

## Technische Details

<Accordion title="Protokoll, Endpunkt und interne Provider-Felder">
  Das GitHub-Copilot-URL-Feld erfordert die vollständige Adresse `https://www.bettertoken.ai/v1/chat/completions`. VS Code hängt für dieses Feld nicht `/chat/completions` an.
</Accordion>