Kodacode einrichten: API Key, Base URL und 429-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. Tritt der Fehler in MonkeyCode auf, verwende die separate MonkeyCode-Anleitung.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	Eine aktuelle Model ID aus der model plaza

Voraussetzungen

• Die aktuelle Version des Tools ist installiert
• Ein BetterToken API Key: Registriere dich und erhalte einen
• Eine Model ID aus der model plaza

Registrieren und BetterToken API Key erhalten→

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Zusätzliche Anforderungen

• VS Code ist installiert
• Die Kodacode-/Koda-Extension ist installiert
• Kopieren Sie die genaue Model ID aus der model plaza.

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://bettertoken.ai/v1
Model	Eine aktuelle Model ID aus der model plaza

Einrichtung

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.

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://bettertoken.ai/v1/
Model ID	Eine Model ID aus der model plaza, beispielsweise YOUR_MODEL_ID
API Key	Dein BetterToken API Key

Klicke nach dem Ausfüllen der Felder auf Connect.

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.

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.

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.

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://bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase

Wenn du ein anderes Modell als YOUR_MODEL_ID verwendest, aktualisiere sowohl name als auch model, damit sie der Model ID aus der model plaza entsprechen.

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 model plaza 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://bettertoken.ai/v1/ ist, und behalte das abschließende / bei.
• Kopieren Sie die genaue Model ID aus der model plaza.
• 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

Verwandte Anleitungen

• Kodacode-Plugin-Übersicht
• Kodacode-Plugin-Installationsanleitung
• Alle unterstützten Tools vergleichen
• API-Fehler, Statuscodes und Ratenbegrenzungen

Technische Details

Protokoll, Endpunkt und interne Provider-Felder

Diese Einrichtung verwendet https://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.