Source: https://aiprimetech.io/fr/learn/use-claude-api-with-roo-code/ [Accueil](/fr/) / [Apprendre](/fr/learn/) / Roo Code illimité avec l’API Claude # Roo Code illimité avec l’API Claude Roo Code est une puissante extension de programmation agentique pour VS Code qui répartit les responsabilités entre des modes de fonctionnement distincts — Architect, Code, Debug et Ask — chacun configurable avec son propre modèle, sa température et ses paramètres de fournisseur. Sa fonctionnalité Orchestrator crée des sous-tâches qui multiplient considérablement la consommation de l’API. Connecter Roo Code à une passerelle Claude illimitée à tarif fixe vous permet d’attribuer Opus au mode Architect et Sonnet au mode Code, sans jamais vous soucier de l’accumulation des coûts des workflows orchestrés. ## Comment Roo Code multiplie la consommation de l’API L’architecture de Roo Code est fondamentalement différente de celle des simples éditeurs IA basés sur le chat. Chaque mode de fonctionnement (Architect, Code, Debug, Ask) conserve son propre contexte et peut se voir attribuer un modèle différent. Lorsque le mode Orchestrator est actif, il décompose une tâche complexe en sous-tâches et délègue chacune au mode approprié, créant ainsi des conversations parallèles qui consomment chacune leur propre budget de tokens de façon indépendante. Une seule tâche pilotée par Orchestrator, comme « refactoriser le module d’authentification », peut créer une sous-tâche Architect pour planifier la nouvelle structure, trois sous-tâches Code pour implémenter différents composants et une sous-tâche Debug pour vérifier le résultat. Chaque sous-tâche comporte son propre prompt système, ses définitions d’outils et son historique de conversation. La consommation totale de tokens n’est pas additive : elle est multiplicative, car chaque sous-tâche démarre de zéro avec une injection du contexte complet. Ce phénomène est amplifié par l’utilisation exclusive des appels d’outils natifs dans Roo Code. Contrairement à certains agents qui se rabattent sur une invocation d’outils basée sur XML lorsque les appels natifs échouent, Roo Code exige que l’API prenne en charge les appels de fonctions natifs. Chaque invocation d’outil (lecture ou écriture de fichier, commande de terminal) constitue une paire structurée d’appel d’outil et de réponse, ce qui ajoute une surcharge à chaque interaction. L’association des modèles par mode, des sous-tâches Orchestrator et des appels d’outils natifs fait de Roo Code l’un des plus gros consommateurs d’API de l’écosystème VS Code. ## Configurer les profils de configuration API Roo Code organise les paramètres des fournisseurs en profils de configuration API. Chaque profil regroupe un type de fournisseur, une URL de base, une clé API, un identifiant de modèle et des paramètres facultatifs comme la température et le budget de raisonnement. Ouvrez le panneau des paramètres de Roo Code dans VS Code et accédez à Configuration API. Cliquez sur Créer un profil pour commencer. Pour utiliser le fournisseur Anthropic, définissez Fournisseur sur Anthropic, saisissez https://unlimited.aiprimetech.io comme URL de base (hôte racine, sans /v1 — le SDK Anthropic ajoute le chemin), puis collez votre clé AI Prime Tech Unlimited. Sélectionnez votre modèle : claude-sonnet-4-5 pour un profil équilibré ou claude-opus-4-6 pour une puissance de raisonnement maximale. Réglez la température entre 0 et 1 selon votre préférence entre déterminisme et créativité. Créez plusieurs profils pour différents scénarios : un profil rapide utilisant Haiku pour les questions ponctuelles, un profil standard utilisant Sonnet pour la programmation quotidienne et un profil puissant utilisant Opus pour les décisions d’architecture. Donnez-leur des noms clairs (par exemple, « Unlimited-Sonnet », « Unlimited-Opus »), car vous attribuerez ces profils à des modes spécifiques à l’étape suivante. ## Stratégie d’attribution des modèles par mode La fonctionnalité phare de Roo Code pour les utilisateurs d’une offre illimitée est l’attribution des modèles par mode. Dans les paramètres, chaque mode (Architect, Code, Debug, Ask) dispose d’une liste déroulante permettant de sélectionner le profil de configuration API qu’il utilise. Avec une offre illimitée, la stratégie optimale est ambitieuse : attribuez Opus aux modes Architect et Debug, où le raisonnement approfondi est le plus important, et Sonnet aux modes Code et Ask, où la vitesse et le volume priment. Le mode Architect planifie les modifications complexes avant leur exécution. Il profite énormément de la capacité supérieure d’Opus à raisonner sur les implications à l’échelle du système, les chaînes de dépendances et les modèles d’architecture. Le mode Debug bénéficie lui aussi d’Opus, car diagnostiquer des bugs exige souvent de garder plusieurs hypothèses à l’esprit simultanément et de raisonner sur les chemins d’exécution. Le mode Code effectue les modifications concrètes des fichiers et c’est le mode le plus fréquemment sollicité. Sonnet est suffisamment rapide pour maintenir une boucle de retour courte tout en produisant du code de haute qualité. Le mode Ask sert aux questions rapides et aux explications, que Sonnet traite efficacement. Avec une offre illimitée, utiliser Opus partout n’entraîne aucun surcoût, mais la différence de latence compte pour les workflows interactifs. Cette répartition vous offre le meilleur des deux mondes : un raisonnement approfondi là où il compte et des réponses rapides là où la vitesse importe. ## Orchestrator et sous-tâches Boomerang Le mode Orchestrator (parfois appelé Boomerang) est le moteur de décomposition des tâches de Roo Code. Lorsque vous décrivez une tâche complexe en mode Orchestrator, il divise le travail en sous-tâches distinctes et délègue chacune au mode approprié. Les résultats des sous-tâches reviennent « comme un boomerang » à Orchestrator, qui les synthétise et décide de l’étape suivante. Chaque sous-tâche s’exécute dans son propre contexte de conversation avec son propre budget de tokens. Ainsi, une seule tâche Orchestrator peut créer cinq conversations Claude distinctes, chacune consommant indépendamment des dizaines de milliers de tokens. Avec une facturation au token, une session Orchestrator pour une fonctionnalité de complexité moyenne peut facilement coûter plusieurs dollars. Avec une offre illimitée, elle coûte exactement autant qu’un seul message de chat : aucun supplément. Pour utiliser efficacement Orchestrator avec un accès illimité, ne le bridez pas. Laissez-le créer autant de sous-tâches que le problème l’exige. Activez le mode automatique, dans lequel Orchestrator décide de la décomposition sans demander de confirmation à chaque étape. Cela produit de meilleurs résultats, car Orchestrator peut itérer librement, en replanifiant et en réexécutant les sous-tâches à mesure qu’il découvre de nouvelles informations au cours du processus. ## Modes personnalisés avec .roomodes Roo Code prend en charge des modes personnalisés au niveau du projet, définis dans un fichier .roomodes à la racine du projet. Chaque mode personnalisé précise un nom, une description, des ajouts au prompt système, les outils autorisés et le profil de configuration API à utiliser. Vous pouvez ainsi créer des agents spécialisés pour votre projet : un mode « Migration de base de données » qui n’a accès qu’aux fichiers SQL et aux outils de migration, ou un mode « Documentation » axé sur le markdown avec un prompt optimisé pour la rédaction. Créez un fichier .roomodes JSON à la racine de votre projet. Chaque entrée de mode comprend roleDefinition (le prompt système), allowedTools (un tableau des noms des outils que le mode peut utiliser) et apiConfiguration (le profil à utiliser). Les modes personnalisés apparaissent aux côtés des modes intégrés dans le sélecteur de mode. Avec l’offre illimitée, les modes personnalisés ouvrent la voie à des workflows créatifs. Créez un mode « Recherche » utilisant Opus pour analyser en profondeur des bases de code inconnues. Créez un mode « Correction rapide » utilisant Haiku pour des modifications triviales sur une seule ligne. Créez un mode « Revue » qui lit le code et fournit des commentaires sans le modifier. La tarification forfaitaire vous permet d’expérimenter librement avec les configurations des modes sans vous soucier du coût d’une erreur. ## Exigences relatives aux appels d’outils natifs Roo Code utilise exclusivement les appels de fonctions natifs : il ne se rabat pas sur des appels d’outils basés sur XML comme certains autres agents. Le fournisseur d’API doit donc prendre correctement en charge le paramètre tools dans la Messages API, y compris les blocs tool_use et tool_result sur plusieurs tours de conversation. La passerelle AI Prime Tech Unlimited prend entièrement en charge cette fonctionnalité pour tous les modèles Claude. Si vous rencontrez des erreurs d’appel d’outils, elles sont presque toujours dues à l’un de ces deux problèmes : l’utilisation d’une ancienne version du modèle dont la prise en charge des appels d’outils est moins robuste, ou une mauvaise configuration de l’URL de base qui dirige les requêtes vers le mauvais point de terminaison. Vérifiez que l’identifiant du modèle de votre profil correspond à un modèle Claude actuel et que l’URL de base est correcte pour le type de fournisseur choisi. Les outils de Roo Code comprennent les opérations sur les fichiers (lecture, écriture, listage), les commandes du terminal (exécution, lecture de la sortie), les actions dans le navigateur (si elles sont activées) et les outils MCP (s’ils sont configurés). Chaque appel d’outil ajoute des données structurées à la conversation, généralement 200-500 tokens par appel, résultat compris. Pour une tâche complexe comportant des dizaines d’appels d’outils, ce volume s’accumule considérablement. ## Dépannage de la configuration de Roo Code Le problème le plus courant est une incohérence entre les modes et les profils : vous avez créé des profils, mais oublié de les attribuer aux modes. Vérifiez le menu déroulant de configuration API de chaque mode dans les paramètres : s’il indique « Par défaut » et que vous n’avez pas défini de profil par défaut, les requêtes échoueront. Attribuez explicitement un profil à chaque mode que vous prévoyez d’utiliser. Si les sous-tâches d’Orchestrator échouent alors que l’utilisation directe des modes fonctionne, le problème vient généralement du fait que les modes des sous-tâches héritent du profil d’Orchestrator, sauf configuration explicite contraire. Assurez-vous que chaque mode susceptible d’être appelé par Orchestrator dispose de sa propre attribution de profil valide. Une pratique courante consiste à définir votre configuration Sonnet comme profil par défaut et à utiliser Opus uniquement pour Architect et Debug. Les erreurs de délai de connexion dépassé pendant de longues sessions Orchestrator indiquent généralement que trop de sous-tâches s’exécutent simultanément et atteignent les limites de débit. La passerelle met les requêtes excédentaires en file d’attente et renvoie leurs résultats à mesure qu’ils sont disponibles, mais VS Code peut interpréter ce délai comme une expiration. Réduisez le nombre de sous-tâches simultanées d’Orchestrator dans les paramètres si cela se produit régulièrement, ou attendez simplement : la passerelle finira par traiter toutes les requêtes dans les limites d’utilisation raisonnable. Copier ``` # Roo Code -> Settings -> API Configuration -> Create New Profile # # Profile: Unlimited-Sonnet # Provider: Anthropic # Base URL: https://aiprimetech.io # API Key: # Model: claude-sonnet-4-5 # # Profile: Unlimited-Opus # Provider: Anthropic # Base URL: https://aiprimetech.io # API Key: # Model: claude-opus-4-6 # # Mode Assignment: # Architect -> Unlimited-Opus # Code -> Unlimited-Sonnet # Debug -> Unlimited-Opus # Ask -> Unlimited-Sonnet ``` ## Questions fréquentes Quel est l’avantage d’attribuer un modèle par mode avec l’offre illimitée ? Vous pouvez attribuer des modèles coûteux comme Opus aux modes exigeant beaucoup de raisonnement (Architect, Debug) sans vous soucier du coût, tout en conservant des modèles plus rapides pour les modes fréquemment utilisés (Code, Ask) afin de réduire la latence. Avec une facturation au token, cette stratégie est coûteuse ; avec l’offre illimitée, vous pouvez optimiser la qualité sans frais supplémentaires. Comment le mode Orchestrator influe-t-il sur l’utilisation de l’API ? Orchestrator décompose les tâches en sous-tâches, chacune exécutée dans sa propre conversation avec son propre budget de tokens. Une seule tâche complexe peut créer 5-10 conversations Claude distinctes. Avec une facturation au token, cela multiplie considérablement le coût ; avec l’offre illimitée, c’est compris dans le forfait. Roo Code fonctionne-t-il avec le point de terminaison compatible OpenAI ? Oui. Créez un profil en définissant le fournisseur sur Compatible OpenAI et l’URL de base sur https://unlimited.aiprimetech.io/v1,, puis saisissez manuellement l’identifiant du modèle. Toutefois, il est recommandé de passer par le fournisseur Anthropic pour une compatibilité optimale avec les appels d’outils. Que sont les fichiers .roomodes et dois-je les utiliser ? Un fichier .roomodes à la racine de votre projet définit des modes personnalisés avec des outils, des prompts et des attributions de modèles spécifiques. Avec l’offre illimitée, utilisez-les librement pour créer des agents spécialisés pour différents workflows — recherche, revue, migration, documentation — sans vous soucier du coût supplémentaire en tokens des prompts système détaillés. Pourquoi ai-je des erreurs d’appel d’outils avec Roo Code ? Roo Code exige des appels de fonctions natifs sans solution de repli XML. Assurez-vous que votre identifiant de modèle correspond à un modèle Claude actuel (claude-sonnet-4-5 ou plus récent) et que votre URL de base est correctement configurée pour le type de fournisseur sélectionné. Les anciennes versions des modèles peuvent offrir une prise en charge moins robuste des appels d’outils. Commencez à utiliser Claude en quelques minutes Obtenez une clé API — aucun compte Anthropic ni inscription sur liste d’attente requis.[Obtenir votre clé API](/register) AI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs. ## Autres guides sur l’API Claude [Comment obtenir une clé API Claude](/fr/learn/how-to-get-a-claude-api-key/)[Comprendre la tarification de l’API Claude](/fr/learn/claude-api-pricing-explained/)[La façon la moins chère d’utiliser l’API Claude](/fr/learn/cheapest-way-to-use-claude-api/)[Cursor illimité avec l’API Claude](/fr/learn/unlimited-cursor-claude-api/)[Accès illimité à Claude Code](/fr/learn/use-claude-api-with-claude-code/)[Passerelle API Claude ou accès direct à Anthropic](/fr/learn/claude-api-vs-anthropic-direct/)[Utiliser Claude via une API compatible avec OpenAI](/fr/learn/openai-compatible-claude-api/)[Comparaison des modèles Claude](/fr/learn/claude-api-models-compared/)[Payer l’API Claude en cryptomonnaies](/fr/learn/claude-api-with-crypto-payment/)[Accéder à l’API Claude sans liste d’attente](/fr/learn/claude-api-without-waitlist/)[Comment réduire la consommation de tokens de Claude](/fr/learn/how-to-reduce-claude-token-usage/)[Cline illimité avec l’API Claude](/fr/learn/use-claude-api-with-cline/)[Claude illimité dans les IDE JetBrains](/fr/learn/use-claude-api-with-jetbrains/)[Utiliser Aider sans limites avec l’API Claude](/fr/learn/use-claude-api-with-aider/)[Claude illimité dans VS Code](/fr/learn/use-claude-api-with-vscode/)[Utiliser OpenCode sans limites avec l’API Claude](/fr/learn/use-claude-api-with-opencode/)[Exécuter un agent Hermes sans limites sur Claude](/fr/learn/run-hermes-agent-with-claude-api/)[Utiliser OpenClaw sans limites avec Claude](/fr/learn/run-openclaw-with-claude-api/)[Ce que signifie une API compatible avec Anthropic](/fr/learn/anthropic-compatible-api/)[Clé API Claude Code — comment l’obtenir et la configurer](/fr/learn/claude-code-api-key-setup/)[Coûts de l’API Claude Code — Tarifs et moyens de les réduire](/fr/learn/claude-code-api-costs/)[Erreurs de l’API Claude — limites de débit et solutions pour 400, 500, 529](/fr/learn/claude-api-errors-troubleshooting/)[Comment acheter des crédits pour l’API Claude](/fr/learn/buy-claude-api-credits/)[Essai gratuit de l’API Claude : ce qui est réellement gratuit et ce qui ne l’est pas](/fr/learn/claude-api-free-trial/)[API Claude ou abonnement Claude Pro/Max — Que choisir](/fr/learn/claude-api-vs-subscription/)[Exécuter la CLI Codex sur Claude](/fr/learn/use-claude-api-with-codex/)[Connecter Claude à n8n](/fr/learn/use-claude-api-with-n8n/)[Router LiteLLM vers Claude](/fr/learn/use-claude-api-with-litellm/)[Utiliser Claude dans Kilo Code](/fr/learn/use-claude-api-with-kilo-code/)[Intégrer Claude à GitHub Copilot](/fr/learn/use-claude-api-with-github-copilot/)[Connecter Zed à Claude via la passerelle](/fr/learn/use-claude-api-with-zed/)[Connecter Cherry Studio à Claude](/fr/learn/use-claude-api-with-cherry-studio/)[Configurer LangChain pour utiliser Claude via la passerelle](/fr/learn/use-claude-api-with-langchain/)[Utiliser Factory Droid avec Claude](/fr/learn/use-claude-api-with-factory-droid/)[L’API de Claude Code expliquée](/fr/learn/claude-code-api/)[Intégrer l’API Claude à votre application](/fr/learn/claude-api-integration/)