Nanocoder

Une entrée Custom Provider sous nanocoder.providers dans agents.config.json — name, baseUrl, apiKey, models — sans ligne sdkProvider nécessaire, car la valeur par défaut est openai-compatible.

{
  "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"]
      }
    ]
  }
}

Étape par étape

1. Créez une clé dans /app/keys et copiez-la — elle n’est affichée qu’une seule fois. Exportez-la sous le nom KUNAVO_API_KEY au lieu de la coller dans le fichier : Nanocoder remplace $VAR, ${VAR} et ${VAR:-default} de manière récursive dans chaque chaîne d’une entrée de fournisseur, et lit .env dans le répertoire de travail.
2. Exécutez /settings providers dans Nanocoder et choisissez Custom Provider. L’assistant demande, dans l’ordre qui lui est propre : Provider name, Base URL, API key (optional), Model names et Request timeout. Il propose également de récupérer la liste de modèles depuis le point de terminaison — Kunavo répond GET /v1/models, et la liste se remplit donc automatiquement.
3. Vous pouvez aussi ignorer l’assistant et rédiger vous-même agents.config.json à l’aide du bloc ci-dessus. Notez que les paramètres sont résolus fichier par fichier : si un fichier au niveau du projet définit nanocoder.providers, il fournit le bloc entier, et les entrées de votre configuration globale ne sont pas fusionnées avec celui-ci.
4. Définissez une fenêtre de contexte. Nanocoder détermine la limite dans cet ordre : /context-max, puis contextWindows[model], contextWindow, NANOCODER_CONTEXT_LIMIT et enfin models.dev. Kunavo n’étant pas un fournisseur models.dev, en l’absence de l’une des quatre premières valeurs, le calcul du budget repose sur une valeur de repli qui ne correspond pas à votre modèle. Les limites figurent sur /models.
5. Ouvrez /model, choisissez l’un des ID que vous avez répertoriés — le sélecteur les affiche sous le name que vous avez indiqué — et exécutez une petite tâche qui doit appeler un outil. Si les appels d’outil sont mal formés sur un modèle donné, disableToolModels permet de désactiver cela pour ce modèle plutôt que pour tout le fournisseur.

Vérifié avec Page Custom Provider de Nanocoder le 21 septembre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans 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-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.