--- title: Magpie | RunAPI description: Ajoutez RunAPI à Magpie et sélectionnez ses modèles pour Claude Code ou Codex. url: https://runapi.ai/fr/docs/resources/tool-integrations/magpie.md canonical: https://runapi.ai/fr/docs/resources/tool-integrations/magpie locale: fr --- > Version HTML: https://runapi.ai/fr/docs/resources/tool-integrations/magpie > Index du site pour les agents: https://runapi.ai/llms.txt # Magpie ## Installer et préparer Installez la dernière version stable de [Magpie][1]. Consultez la [référence officielle][2] pour les instructions propres à votre plateforme. Installez Claude Code ou Codex séparément. [1]: https://usemagpie.ai [2]: https://github.com/yetone/magpie/blob/main/docs/reference.md Créez une clé API standard dédiée en suivant le [guide d’authentification](https://runapi.ai/fr/docs/guides/authentication.md). Copiez un identifiant de modèle et son protocole pris en charge dans le [catalogue des modèles](https://runapi.ai/fr/models). Sauvegardez la configuration de votre agent avant de changer de fournisseur. ## Ajouter un fournisseur compatible avec OpenAI Utilisez cette option pour les modèles qui prennent en charge Chat Completions. Remplacez les deux valeurs fictives avant d’exécuter la commande. La base `url=` se termine par `/v1` ; Magpie y ajoute `/chat/completions`. ```shell magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` ## Ajouter un fournisseur compatible avec Anthropic Utilisez cette option pour les modèles qui prennent en charge Anthropic Messages. La base `anthropic=` ne contient pas `/v1` ; Magpie y ajoute `/v1/messages`. ```shell magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` Choisissez d’abord une seule option. Magpie refuse un second fournisseur utilisant la même clé. Pour conserver les deux fournisseurs, créez une clé RunAPI dédiée différente pour chacun. Conservez les clés RunAPI dans Magpie, en dehors de vos dépôts. ## Attribuer un modèle à un agent Démarrez Magpie et laissez sa passerelle fonctionner. Dans l’écran Agents, sélectionnez Claude Code ou Codex, puis choisissez le modèle sous votre fournisseur RunAPI. La CLI propose la même sélection. Exécutez une commande avec le fournisseur et l’identifiant de modèle choisis. ```shell magpie serve ``` Dans un autre terminal, sélectionnez le modèle. ```shell magpie models magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID ``` Pour l’option Anthropic, remplacez `runapi-chat` par `runapi-anthropic`. Magpie utilise `provider/model` localement et transmet l’identifiant de modèle d’origine à RunAPI. L’agent se connecte à Magpie sur `127.0.0.1:3425` ; il n’a pas besoin de la clé RunAPI. Codex utilise l’interface Responses locale, ce qui ne signifie pas que RunAPI reçoit une requête Responses. Ces options de fournisseur sélectionnent Chat Completions ou Messages côté RunAPI. ## Vérifier la configuration Vérifiez le fournisseur et le modèle sélectionné avec ces commandes, puis démarrez une nouvelle session d’agent et envoyez une courte invite. ```shell magpie version magpie providers magpie claude magpie codex ``` Confirmez le modèle et la requête attendus dans les journaux d’utilisation RunAPI. Une réponse réussie de l’agent ne suffit pas à identifier le fournisseur qui l’a traitée. Les fonctions Test models, Detect APIs et le test de fournisseur de Magpie peuvent envoyer des requêtes d’inférence. La configuration et les routes locales ont été vérifiées avec Magpie 0.1.1307 et Claude Code 2.1.295 sous Linux. Les deux options de fournisseur ont renvoyé une réponse fixe issue d’une fixture locale. L’inférence réelle RunAPI et l’inférence Codex n’ont pas été testées pour ce guide. Vérifiez le protocole et la prise en charge des outils du modèle sélectionné avant de l’utiliser avec un agent. ## Résoudre les problèmes Si Magpie indique qu’un fournisseur a déjà été ajouté avec cette clé, réutilisez ce fournisseur ou utilisez une autre clé dédiée pour la seconde option. Cette erreur a été reproduite localement. Un test avec une fixture locale a reproduit `no model list` avec `connection refused` lorsque le serveur configuré était arrêté. Vérifiez l’adresse et la disponibilité du serveur, puis utilisez `models=` avec l’identifiant exact du modèle. Laissez Magpie fonctionner pendant que les agents utilisent sa passerelle locale. Claude Code a signalé `unrecognized_model` pour les identifiants de fixture, mais a tout de même renvoyé la réponse de la fixture. Si cet avertissement apparaît, vérifiez l’identifiant de modèle d’origine et la configuration du modèle dans Claude Code. La fixture n’a pas validé les limites de contexte, les appels d’outils ni la qualité du modèle. ## Restaurer la configuration précédente Restaurez l’agent avant de supprimer son fournisseur. Ces commandes rétablissent la configuration précédente de chaque agent. ```shell magpie claude default magpie codex default magpie provider rm runapi-chat magpie provider rm runapi-anthropic ``` Supprimez uniquement les fournisseurs que vous avez ajoutés. Révoquez les clés RunAPI dédiées si vous n’en avez plus besoin. Restaurez votre sauvegarde si vous avez effectué d’autres modifications manuelles de configuration. ## Étapes suivantes Consultez le [démarrage rapide de l’API LLM](https://runapi.ai/fr/docs/guides/llm-api/quickstart.md) pour les exemples de protocoles publics RunAPI et le [catalogue des modèles](https://runapi.ai/fr/models) pour les modèles pris en charge. La référence officielle de Magpie mentionne également une intégration Grok Build ; Grok Build n’a pas été testé pour ce guide. --- ## Plus de ressources de RunAPI - [Accueil](https://runapi.ai/fr/.md) - [Catalogue de modèles](https://runapi.ai/fr/models.md) - [Tarifs](https://runapi.ai/fr/pricing.md) - [Fournisseurs](https://runapi.ai/fr/models) - [Documentation](https://runapi.ai/fr/docs/guides) - [SDK](https://runapi.ai/fr/sdk.md) - [CLI](https://runapi.ai/fr/cli.md) - [Serveur MCP](https://runapi.ai/fr/mcp.md) - [x402](https://runapi.ai/fr/x402.md) - [Claude Code vs Cursor](https://runapi.ai/fr/claude-code-vs-cursor.md) - [Configuration de l’API Cursor](https://runapi.ai/fr/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/fr/openrouter-alternative.md) - [Entreprise](https://runapi.ai/fr/contact.md) - [Contact](https://runapi.ai/fr/contact.md) - [Conditions](https://runapi.ai/fr/terms.md) - [Confidentialité](https://runapi.ai/fr/privacy.md) - [Index du site pour les agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Données structurées ```json [ { "@context": "https://schema.org", "inLanguage": "fr", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/fr", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/fr/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "fr", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/fr", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/fricon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "fr", "@type": "TechArticle", "headline": "Magpie", "description": "Ajoutez RunAPI à Magpie et sélectionnez ses modèles pour Claude Code ou Codex.", "url": "https://runapi.ai/fr/docs/resources/tool-integrations/magpie", "mainEntityOfPage": "https://runapi.ai/fr/docs/resources/tool-integrations/magpie" } ] ```