Nanocoder

Ein Custom-Provider-Eintrag unter nanocoder.providers in agents.config.json — name, baseUrl, apiKey, models — ohne sdkProvider-Zeile, da standardmäßig openai-compatible verwendet wird.

{
  "nanocoder": {
    "providers": [
      {
        "name": "Kunavo",
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "models": ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-sol"]
      }
    ]
  }
}

Schritt für Schritt

1. Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt. Exportieren Sie ihn als KUNAVO_API_KEY, statt ihn in die Datei einzufügen: Nanocoder ersetzt $VAR, ${VAR} und ${VAR:-default} rekursiv in jeder Zeichenfolge eines Provider-Eintrags und liest .env aus dem Arbeitsverzeichnis.
2. Führen Sie /settings providers in Nanocoder aus und wählen Sie Custom Provider. Der Assistent fragt in dieser Reihenfolge nach Provider name, Base URL, API key (optional), Model names und Request timeout. Er bietet außerdem an, die Modellliste vom Endpunkt abzurufen — Kunavo antwortet mit GET /v1/models, sodass die Liste automatisch ausgefüllt wird.
3. Alternativ können Sie den Assistenten überspringen und agents.config.json mit dem obigen Block selbst schreiben. Beachten Sie, dass Einstellungen dateiweise aufgelöst werden: Definiert eine Datei auf Projektebene nanocoder.providers, liefert sie den gesamten Block. Einträge in Ihrer globalen Konfiguration werden also nicht damit zusammengeführt.
4. Legen Sie ein Kontextfenster fest. Nanocoder ermittelt den Grenzwert zuerst aus /context-max, dann aus contextWindows[model], contextWindow, NANOCODER_CONTEXT_LIMIT und schließlich aus models.dev. Kunavo ist kein models.dev-Provider. Wenn Sie also keinen der ersten vier Werte angeben, kalkuliert Nanocoder anhand eines Ersatzwerts, der nicht dem Kontextfenster Ihres Modells entspricht. Die Zahlen finden Sie unter /models.
5. Öffnen Sie /model, wählen Sie eine der aufgeführten IDs aus — die Auswahl zeigt sie unter dem von Ihnen angegebenen name — und führen Sie eine kleine Aufgabe aus, für die ein Tool aufgerufen werden muss. Wenn Tool-Aufrufe bei einem bestimmten Modell fehlerhaft zurückkommen, grenzt disableToolModels das Problem für dieses Modell ein, nicht für den gesamten Provider.

Abgeglichen mit Die Seite „Custom Provider“ von Nanocoder am 21. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Nanocoder.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.