> ## 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.

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

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

Um Kodacode 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                                                                       |
| Base URL | `https://www.bettertoken.ai/v1`                                                           |
| 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

* VS Code ist installiert
* Die Kodacode-/Koda-Extension ist installiert
* Die ausgewählte Model ID stammt vom **unterstützten Provider**

## Installation

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

## Manuelle Einrichtung

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

### Einrichtung

<Steps>
  <Step title="Koda-Panel öffnen und Modell hinzufügen">
    Öffne das **KODA**-Panel in der VS-Code-Seitenleiste, klicke auf die Modellauswahl unter dem Eingabefeld und wähle **Add model: Agent**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/kodacode/select-model-menu.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=b4bd4b16361c0367efbcbba78322df4a" alt="Add model: Agent über die Modellauswahl im Koda-Panel auswählen." style={{ borderRadius: '0.5rem' }} width="3012" height="1600" data-path="images/kodacode/select-model-menu.png" />
    </Frame>
  </Step>

  <Step title="OpenAI-kompatible Modelleinstellungen ausfüllen">
    Verwende im Dialog zum Hinzufügen eines Modells diese Werte:

    | Feld     | Empfohlener Wert                                                                                                                               |
    | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
    | Provider | `Any OpenAI-compatible API`                                                                                                                    |
    | API Base | `https://www.bettertoken.ai/v1/`                                                                                                               |
    | Model ID | Eine Model ID eines unterstützten Providers aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a>, beispielsweise `YOUR_MODEL_ID` |
    | API Key  | Dein BetterToken API Key                                                                                                                       |

    Klicke nach dem Ausfüllen der Felder auf **Connect**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/kodacode/add-openai-compatible-model.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=099fa77d6f7720711451f39169f9ff85" alt="Any OpenAI-compatible API im Kodacode-Dialog zum Hinzufügen eines Modells auswählen und API Base, Model ID und API Key ausfüllen." style={{ borderRadius: '0.5rem' }} width="3102" height="1656" data-path="images/kodacode/add-openai-compatible-model.png" />
    </Frame>
  </Step>

  <Step title="Aktives Modell bestätigen">
    Wähle nach erfolgreicher Verbindung das neue Modell, etwa `YOUR_MODEL_ID`, in der Modellauswahl unter dem Koda-Eingabefeld aus. Sende eine kurze Nachricht, um die Antwort zu bestätigen.
  </Step>

  <Step title="config.yaml prüfen">
    Kodacode schreibt die Konfiguration nach `~/.koda/config.yaml`. Öffne diese Datei, um zu bestätigen, dass das Modell hinzugefügt wurde.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/kodacode/config-yaml-result.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=5112177597f16b97739c7d406f50749b" alt="Kodacode config.yaml mit hinzugefügter OpenAI-kompatibler Modellkonfiguration." style={{ borderRadius: '0.5rem' }} width="1618" height="1648" data-path="images/kodacode/config-yaml-result.png" />
    </Frame>
  </Step>
</Steps>

### Beispiel für config.yaml

Verwende diese vollständige Struktur als Referenz. Ersetze `YOUR_API_KEY` durch deinen BetterToken API Key und committe keinen echten API Key in dein Repository.

```yaml theme={null}
name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: YOUR_MODEL_ID
    provider: openai
    model: YOUR_MODEL_ID
    apiKey: YOUR_API_KEY
    apiBase: https://www.bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase
```

<Note>
  Wenn du ein anderes Modell als `YOUR_MODEL_ID` verwendest, aktualisiere sowohl `name` als auch `model`, damit sie der Model ID eines unterstützten Providers aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a> entsprechen.
</Note>

## 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

| Fehler                             | Prüfen                                                                              |
| ---------------------------------- | ----------------------------------------------------------------------------------- |
| `401` oder `Unauthorized`          | Prüfe den BetterToken API Key und entferne führende oder nachgestellte Leerzeichen. |
| `404`                              | Prüfe die Base URL und hänge keinen spezifischen Endpunktpfad an.                   |
| `model not found`                  | Kopiere eine aktuelle Model ID aus der model plaza.                                 |
| Änderungen werden nicht angewendet | Speichere die Konfiguration und starte das Tool vollständig neu.                    |

* Wenn die Verbindung fehlschlägt, bestätige, dass **API Base** `https://www.bettertoken.ai/v1/` ist, und behalte das abschließende `/` bei.
* Wenn das Modell nicht verfügbar ist, bestätige, dass **Model ID** vom unterstützten Provider stammt.
* Wenn die Authentifizierung fehlschlägt, kopiere den API Key erneut und vermeide zusätzliche Leerzeichen oder Zeilenumbrüche.
* Wenn Änderungen an `config.yaml` nicht angewendet werden, starte VS Code neu oder führe **Developer: Reload Window** aus.
* BetterToken benötigt normalerweise keinen zusätzlichen `User-Agent` oder eigene Header.

## 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>

### Verwandte Anleitungen

* [Kodacode-Plugin-Übersicht](https://docs.kodacode.ru/plugin/overview.html)
* [Kodacode-Plugin-Installationsanleitung](https://docs.kodacode.ru/plugin/install.html)

## Technische Details

<Accordion title="Protokoll, Endpunkt und interne Provider-Felder">
  Diese Einrichtung verwendet `https://www.bettertoken.ai/v1`. Das Tool hängt den OpenAI-kompatiblen Endpunktpfad an. Füge `/chat/completions` oder `/responses` nicht hinzu, sofern ein bestimmtes Feld dies nicht ausdrücklich verlangt.
</Accordion>