Roo Code avec l’API Claude — configuration du fournisseur et modèle par mode

Roo Code est un agent de programmation autonome open source pour VS Code — un fork de la famille Cline, caractérisé par son système de modes et son routage de modèles par mode. Il ne fournit aucun modèle lui-même et nécessite donc une clé API. Ce guide présente la configuration exacte pour exécuter Claude dans Roo Code avec une seule clé sk-kn- à environ 30 % sous le tarif catalogue d’Anthropic pour les modèles principaux, explique comment utiliser les profils de configuration afin de ne dépenser pour un modèle puissant que lorsque cela est rentable, détaille le coût d’une session et présente honnêtement le compromis par rapport à un appel direct à Anthropic.

Pourquoi Roo Code nécessite une clé API

Chaque étape exécutée par Roo Code — lire un fichier, écrire un diff, exécuter une commande, lire le résultat — est un appel de modèle facturé au token. Un abonnement claude.ai Pro ou Max ne le couvre pas : les formules de chat et l’accès à l’API sont des produits distincts, et Roo Code communique avec l’API. Comme une boucle agentique renvoie le contexte croissant de la tâche à chaque étape, le tarif par token est le principal levier du coût d’une session — ce qui vaut aussi pour une passerelle : paiement à l’usage à partir d’un rechargement de 10 $, une clé qui donne également accès à GPT et un solde qui n’expire jamais.

Configuration — les trois champs

Ouvrez Settings → Providers et définissez le fournisseur API sur OpenAI Compatible. Trois valeurs :

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...              # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

Créez la clé dans le tableau de bord après vous être inscrit et avoir effectué un rechargement — elle n’est affichée qu’une seule fois, alors stockez-la immédiatement ; la documentation de la clé API Claude couvre la rotation et les limites de dépenses. Si Roo Code demande des métadonnées du modèle telles que la fenêtre de contexte ou le plafond de sortie, utilisez les valeurs de la page du modèle — une fenêtre de contexte sous-estimée provoque une troncature prématurée.

Testez avec quelque chose de simple avant de lui permettre de modifier du code. Un 401 correspond presque toujours à la clé ; un 404 correspond presque toujours à l’URL de base ou à un slug de modèle inexistant — Kunavo fait correspondre les slugs exactement et ne crée pas d’alias pour les noms suffixés par une date ; ainsi, claude-sonnet-4-5-20250929 renvoie 404 tandis que claude-sonnet-4-6 fonctionne.

Modes et profils de configuration — le levier de coût

Roo Code fournit plusieurs modes intégrés — Code, Architect, Ask et Debug — ainsi que les modes personnalisés que vous définissez vous-même. L’élément important pour le coût est que Roo Code enregistre des profils de configuration API nommés et mémorise le dernier profil utilisé dans chaque mode. Le modèle devient donc une propriété du mode, et non quelque chose que vous devez penser à modifier :

# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.

Profile "strong"         model claude-opus-5        -> bind to Architect and Debug
Profile "code-default"   model claude-sonnet-5      -> bind to Code mode
Profile "ask-cheap"      model claude-haiku-4-5     -> bind to Ask mode

La raison pour laquelle cela fonctionne est que les modes ont des profils de tokens très différents. Architect consiste en quelques échanges exigeants en raisonnement, où la qualité du modèle détermine si les vingt étapes suivantes seront productives — une faible part du total des tokens, donc un modèle puissant coûte peu en valeur absolue. Code comporte de nombreuses étapes mécaniques, chacune renvoyant le contexte, et c’est là que le tarif par token se cumule. Ask est généralement ponctuel et n’a pas besoin d’un modèle de pointe.

Les chiffres détaillés sont présentés ci-dessous : trois étapes Architect sur Opus 5 plus dix-sept étapes Code sur Sonnet 5 reviennent à environ 1.06 $ contre 0.87 $ pour une exécution entièrement sur Sonnet — environ 23 % de plus pour une planification nettement meilleure, et bien moins cher que d’exécuter tout sur Opus.

La route native Anthropic (et pourquoi vous pourriez la vouloir)

Roo Code propose également un fournisseur natif Anthropic avec un champ d’URL de base personnalisé. En le pointant vers https://api.kunavo.com — l’origine uniquement, sans /v1, car ce client ajoute lui-même /v1/messages — les requêtes passent par l’API Messages native. Coller ici la forme /v1 produit un 404 qui ressemble à un modèle manquant.

Cette route apporte la mise en cache des prompts : cache_control est transmis sans traduction et l’entrée mise en cache est facturée à 10 % du tarif d’entrée (voici comment cela fonctionne). Dans une boucle qui renvoie un préfixe stable à chaque étape, il s’agit de la plus grande économie disponible — plus importante que tout changement de modèle. Les deux routes fonctionnent ; OpenAI Compatible est plus simple pour commencer, et passer de l’une à l’autre ne nécessite qu’une modification des paramètres.

Quel modèle Claude associer à chaque mode

Tous utilisent la même clé et le même endpoint ; seul le slug du modèle diffère, donc un profil se modifie en un mot. Les tarifs complets par modèle, comparés à la liste officielle d’Anthropic, figurent dans la liste des prix de l’API Anthropic Claude, et le catalogue actuel se trouve sur la page des tarifs.

Roo Code sur Kunavo contre un appel direct à Anthropic

La comparaison honnête, y compris les cas où l’accès direct est préférable :

Cette ligne consacrée à la capacité constitue le véritable compromis, énoncé clairement. Si vous avez besoin d’un quota garanti, d’un SLA contractuel ou d’une relation d’approvisionnement avec le fournisseur du modèle, optez pour l’accès direct — c’est ce que finance la différence de prix. Pour un développeur individuel ou une petite équipe utilisant Roo Code, le compromis va généralement dans l’autre sens.

Ce que coûte réellement une session Roo Code

Les outils agentiques consomment beaucoup de tokens par conception : à chaque étape, l’invite système, l’historique de la tâche et le nouveau contexte des fichiers sont renvoyés. Chiffres réalistes aux tarifs de Kunavo :

Le calcul, exécutable :

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
    "claude-opus-5":     (3.50, 17.50),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One Code-mode step: Roo resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

Réduire la facture

1. Commencez de nouvelles tâches plutôt que d’en prolonger une indéfiniment. Roo Code renvoie toute la conversation à chaque étape ; le coût d’une tâche longue augmente donc de manière quadratique. Une nouvelle tâche possède un contexte nouveau et réduit — c’est l’habitude offrant le plus grand effet de levier ici.
2. Associez un profil à chaque mode. Comme indiqué plus haut, cela transforme le routage des modèles en configuration plutôt qu’en une modification dont vous devez vous souvenir au milieu de la tâche.
3. Utilisez la route native d’Anthropic pour la mise en cache. Les entrées mises en cache, facturées à 10 % du tarif d’entrée, constituent la plus grande économie structurelle sur une boucle qui renvoie un préfixe stable.
4. Attribuez à l’éditeur sa propre clé avec limite de dépenses. Créez une clé distincte dans le tableau de bord et vérifiez l’utilisation après une vraie semaine — c’est la seule estimation honnête de ce que cela vous coûte.

Questions fréquentes