Plugin Xcode pour Claude Code : installation et erreurs MCP
Connectez Claude Code à Xcode avec le plugin d’Apple ou l’enregistrement manuel d’un serveur MCP. Vérifiez la commande d’export locale et l’installation de Xcode sélectionnée, autorisez les agents externes et validez une compilation réelle. Diagnostiquez les outils manquants et connectez Codex sans confondre la portée du plugin avec la facturation du modèle.
Sommaire

Claude Code peut modifier des fichiers Swift sans pour autant avoir accès aux compilations, aux tests et aux aperçus de Xcode. Sur votre Mac, autorisez les agents externes dans Xcode et ouvrez votre projet avant de connecter Claude Code. Installez xcode@claude-plugins-official si sa commande d’export locale fonctionne ; sinon, utilisez la connexion avec xcrun mcpbridge documentée par Apple.
Les instructions ci-dessous suivent la documentation officielle disponible au 2026-11-16. Le guide d’Apple sur les agents externes décrit les autorisations et la connexion directe par MCP.
Vérifiez quelle installation de Xcode est sélectionnée sur votre Mac
Utilisez une installation complète de Xcode et une version actuelle de Claude Code CLI. L’entrée du marketplace récupère le plugin depuis les outils Xcode de votre Mac. Installer ce package ne fournit pas Xcode si l’application est absente.
Dans Bash, depuis le dépôt de votre application, vérifiez la version du client et le répertoire de développement sélectionné :
claude --version
xcode-select --print-path
Le répertoire de développement doit correspondre à l’installation de Xcode que vous comptez utiliser. Le résultat /Library/Developer/CommandLineTools désigne le package autonome d’outils en ligne de commande, pas l’application Xcode. Le guide d’Apple sur la configuration des outils en ligne de commande explique cette distinction.
Exécutez ensuite la commande exacte utilisée par le marketplace :
xcrun agent plugin path --plugin-format claude
Si la commande d’export réussit, elle affiche le chemin absolu du répertoire du plugin. Conservez ce répertoire intact : le marketplace utilise mode: "link", qui charge les fichiers générés à leur emplacement d’origine.
Claude Code prend en charge les sources de plugins basées sur une commande depuis 2.1.229, selon son journal officiel des modifications. Utilisez une version actuelle plutôt que de rester sur cette ancienne version. Pour Xcode, vérifiez que la commande d’export fonctionne. La présence de mcpbridge ne garantit pas celle de agent plugin path.
Si la commande claude elle-même est introuvable, suivez les étapes d’installation et de première exécution de Claude Code avant de diagnostiquer Xcode.
Autorisez les agents externes et ouvrez le projet
Accordez l’accès au processus externe dans les réglages Intelligence de Xcode. Cette autorisation est distincte de l’installation du plugin Claude Code.
- Ouvrez Xcode > Settings > Intelligence.
- Dans Model Context Protocol, réglez Allow External Agents to Use Xcode Tools sur While Xcode is Open ou Always.
- Ouvrez le projet ou l’espace de travail que l’agent doit utiliser.
Choisissez While Xcode is Open pour cette procédure interactive. Gardez le projet ouvert pendant les vérifications qui suivent. Selon Apple, Xcode vous avertit lorsqu’un agent externe se connecte et pendant son activité.
Conservez aussi votre connexion fonctionnelle au modèle. Un abonnement Claude éligible consomme le quota du forfait ; un compte Claude Console donne accès à une API facturée séparément. Choisissez l’abonnement si le quota disponible suffit, ou l’API pour une facturation à l’usage. Consultez les méthodes d’authentification de Claude Code et vérifiez les régions prises en charge par Anthropic avant de payer l’accès.
BetterToken offre une autre voie d’accès à l’API avec paiement à l’usage. Utilisez votre propre compte et une clé créée dans la console, avec la configuration documentée pour Claude Code. Choisissez cette option pour accéder à l’API avec un solde alimenté séparément. Avant de payer, vérifiez les unités de facturation du modèle, les moyens de paiement et les frais. Cette offre n’inclut pas d’abonnement Claude. Consultez les tarifs actuels des modèles et confirmez les conditions de paiement dans la console.
Choisissez le plugin ou la connexion directe par MCP
Utilisez le plugin si la commande d’export de votre Xcode fonctionne. Enregistrez directement le serveur MCP si vous souhaitez seulement la connexion via le pont, ou si l’export est indisponible mais que mcpbridge fonctionne.
L’entrée officielle du marketplace indique Apple Inc. comme auteur. La source du plugin exécute xcrun agent plugin path --plugin-format claude sur votre machine. La commande de connexion directe enregistre plutôt xcrun mcpbridge comme serveur MCP.
Il s’agit d’une différence de distribution du package, pas d’une preuve qu’une méthode produit de meilleures compilations. Un plugin peut contenir des compétences (skills) et d’autres composants en plus de la configuration MCP. Inspectez le package installé : ne supposez ni une liste fixe de compétences ni une équivalence complète des fonctions. Commencez par une seule méthode pour faciliter le diagnostic des erreurs.
Installez xcode@claude-plugins-official
Démarrez Claude Code depuis votre dépôt avec claude. Saisissez la commande suivante dans sa session interactive, et non dans Bash :
/plugin install xcode@claude-plugins-official
Vérifiez les options d’installation et choisissez la portée locale pour un premier essai limité au dépôt. Avant d’autoriser la commande d’export affichée, assurez-vous qu’elle correspond à celle indiquée plus haut. Suivez les éventuelles consignes de rechargement du récapitulatif d’installation, ou ouvrez une nouvelle session Claude Code.
Vérifiez ensuite l’installation depuis Bash, dans le même dépôt :
claude plugin list
claude plugin details xcode@claude-plugins-official
Assurez-vous que le package est activé et inspectez la liste de ses composants. La référence des commandes de plugins décrit cette liste, notamment les compétences et les serveurs MCP.
Dans Claude Code, exécutez /mcp et inspectez le serveur fourni par le plugin. Les serveurs MCP des plugins portent un nom au format plugin:<plugin>:<server> ; une entrée nommée uniquement xcode n’est pas nécessaire.
Pour modifier la portée ou supprimer le package plus tard, consultez le guide d’installation, de vérification et de suppression des plugins.
Enregistrez xcrun mcpbridge directement
Exécutez la commande d’enregistrement exacte d’Apple dans Bash, depuis le dépôt où vous utiliserez Claude Code :
claude mcp add --transport stdio xcode -- xcrun mcpbridge
claude mcp list
claude
Vous enregistrez ainsi une connexion à un processus local via l’entrée et la sortie standard. Le nom de serveur choisi dans cette commande est xcode. Dans la session interactive, exécutez /mcp et vérifiez l’état de la connexion avant de demander une compilation.
Par défaut, la configuration MCP ne s’applique qu’au projet actuel. Claude Code l’enregistre dans ~/.claude.json, en l’associant au projet, sans l’appliquer automatiquement à tous les dépôts. La documentation sur les portées MCP explique cette distinction.
L’enregistrement ne suffit pas à valider le fonctionnement. Confirmez que le serveur se connecte et peut agir sur le projet ouvert dans Xcode.
Vérifiez une compilation avant de demander des modifications
Demandez d’abord une compilation sans modifier les fichiers. Vous pourrez ainsi distinguer les problèmes de connexion des changements que le modèle pourrait introduire.
Envoyez ce prompt dans la session Claude Code connectée à Xcode. Il demande d’identifier le projet et le schéma actifs, puis de compiler pour un simulateur disponible sans modifier les fichiers :
Use Xcode tools to identify the open project and active scheme.
Build that scheme for an available iOS Simulator destination.
Do not edit files.
Report the build result and the first actionable error, if any.
Vérifiez qu’un outil Xcode a réellement été appelé et qu’il a renvoyé un résultat de compilation. Xcode devrait aussi signaler l’activité de l’agent externe. Une erreur du compilateur peut confirmer que la connexion fonctionne, même si l’application ne compile pas encore. Dans ce cas, corrigez l’erreur du projet au lieu de réinstaller le plugin.
Le marketplace décrit la compilation, l’exécution et les tests de schémas ; les aperçus SwiftUI ; les opérations sur simulateurs et appareils ; les journaux de compilation, les diagnostics et la recherche dans la documentation Apple. Vérifiez les opérations disponibles dans votre installation de Xcode et dans la liste des outils connectés.
Par exemple, les notes de version de Xcode 27 décrivent le démarrage de simulateurs, l’installation et le lancement d’applications, les interactions tactiles et les captures d’écran. Vérifiez que les outils correspondants sont accessibles avant de demander une tâche qui interagit avec l’interface.
Après la compilation, demandez à l’agent d’identifier les tests disponibles et d’exécuter un test ou une suite pertinente. Pour modifier une vue, demandez le rendu d’un aperçu SwiftUI existant et examinez le résultat renvoyé. Vérifiez le résultat des tests ou l’aperçu lui-même, pas seulement une déclaration de réussite.
Limitez la première tâche. Avant d’ajouter des compilations répétées et de longs diagnostics, utilisez la méthode de mesure du coût en contexte de MCP sur une tâche reproductible.
Corrigez le composant en échec, pas toute l’installation
Choisissez la vérification qui correspond à votre résultat. Ces pistes répondent à des situations différentes ; il ne faut pas toutes les exécuter dans l’ordre.
xcrun ne trouve pas agent ou mcpbridge
Vérifiez d’abord xcode-select --print-path. Si une ancienne installation de Xcode ou le package autonome d’outils en ligne de commande est sélectionné, le terminal peut utiliser d’autres outils que la fenêtre Xcode ouverte.
Si l’application voulue est installée dans /Applications/Xcode.app, sélectionnez-la dans Bash :
sudo xcode-select --switch /Applications/Xcode.app
Utilisez son chemin réel si l’installation se trouve ailleurs. Cette commande modifie le répertoire de développement par défaut. Confirmez la sélection et relancez la commande qui a échoué.
Si agent plugin path reste indisponible mais que la connexion directe par MCP fonctionne, utilisez cette connexion. Si aucune méthode ne fonctionne, installez ou sélectionnez une version de Xcode fournissant les outils requis avant de modifier les identifiants d’accès au modèle de Claude Code.
claude mcp list n’affiche pas d’entrée nommée uniquement xcode
Pour la connexion directe, exécutez la commande depuis le dépôt où vous avez ajouté le serveur. Un enregistrement limité au projet n’apparaît pas automatiquement dans un autre dépôt.
Pour le plugin, vérifiez claude plugin list, puis /mcp dans Claude Code. Cherchez un nom de serveur préfixé par le plugin, plutôt que le seul nom xcode. Si le plugin est installé mais désactivé, activez-le via /plugin et ouvrez une nouvelle session.
Si l’installateur ne trouve pas l’entrée du marketplace, actualisez son catalogue depuis la session Claude Code :
/plugin marketplace update claude-plugins-official
Réessayez l’installation après l’actualisation. Si le marketplace lui-même manque, exécutez d’abord /plugin marketplace add anthropics/claude-plugins-official. Le guide de dépannage des plugins d’Anthropic distingue ces erreurs de catalogue des types de sources non pris en charge.
Le serveur se connecte, mais le projet est inaccessible
Ouvrez le projet voulu dans Xcode et vérifiez de nouveau Allow External Agents to Use Xcode Tools. Laissez Xcode ouvert, démarrez une nouvelle session de l’agent et répétez la demande de compilation sans modification.
Une entrée de serveur confirme l’existence d’une configuration. Les informations du projet et le résultat de compilation confirment que l’agent a atteint le bon projet. Si l’outil renvoie une erreur propre au projet, appuyez-vous sur ce diagnostic pour choisir la suite.
Connectez Codex au même projet Xcode
Codex peut utiliser la connexion directe par MCP documentée par Apple, sans installer le plugin du marketplace Claude Code. Conservez la même autorisation dans Xcode et laissez le projet ouvert.
Une fois Codex CLI installé et l’authentification effectuée, exécutez ces commandes dans Bash :
codex mcp add xcode -- xcrun mcpbridge
codex mcp list
codex
Dans Codex, utilisez /mcp pour inspecter les serveurs actifs, comme l’indique la documentation MCP d’OpenAI. Envoyez ensuite la même demande de compilation sans modification et examinez le résultat renvoyé.
Pour révoquer l’accès des agents externes, revenez aux réglages Intelligence de Xcode et choisissez Never dans Allow External Agents to Use Xcode Tools.