Laisser Claude utiliser votre ordinateur depuis la CLI
Activez l'utilisation de l'ordinateur dans la CLI Claude Code pour que Claude puisse ouvrir des applications, cliquer, taper et voir votre écran sur macOS. Testez les applications natives, déboguez les problèmes visuels et automatisez les outils GUI uniquement sans quitter votre terminal.
{/* plan-availability: feature=computer-use plans=pro,max */}
L'utilisation de l'ordinateur est un aperçu de recherche sur macOS qui nécessite un plan Pro ou Max. Elle n'est pas disponible sur les plans Team ou Enterprise. Elle nécessite Claude Code v2.1.85 ou ultérieur et une session interactive, elle n'est donc pas disponible en mode non-interactif avec le drapeau -p.
L'utilisation de l'ordinateur permet à Claude d'ouvrir des applications, de contrôler votre écran et de travailler sur votre machine comme vous le feriez. Depuis la CLI, Claude peut compiler une application Swift, la lancer, cliquer sur chaque bouton et faire une capture d'écran du résultat, tout dans la même conversation où il a écrit le code.
Cette page explique comment fonctionne l'utilisation de l'ordinateur dans la CLI. Pour l'application Desktop sur macOS ou Windows, consultez utilisation de l'ordinateur dans Desktop.
Ce que vous pouvez faire avec l'utilisation de l'ordinateur
L'utilisation de l'ordinateur gère les tâches qui nécessitent une GUI : tout ce que vous devriez normalement faire en quittant le terminal et en le faisant manuellement.
- Créer et valider des applications natives : demandez à Claude de créer une application de barre de menu macOS. Claude écrit le Swift, le compile, lance l'application et clique sur chaque contrôle pour vérifier qu'il fonctionne avant que vous ne l'ouvriez jamais.
- Tests d'interface utilisateur de bout en bout : pointez Claude vers une application Electron locale et dites « teste le flux d'intégration ». Claude ouvre l'application, clique sur l'inscription et fait une capture d'écran de chaque étape. Pas de configuration Playwright, pas de harnais de test.
- Déboguer les problèmes visuels et de mise en page : dites à Claude « la modale se coupe sur les petites fenêtres ». Claude redimensionne la fenêtre, reproduit le bogue, en fait une capture d'écran, corrige le CSS et vérifie la correction. Claude voit ce que vous voyez.
- Piloter les outils GUI uniquement : interagissez avec les outils de conception, les panneaux de contrôle du matériel, le simulateur iOS ou les applications propriétaires qui n'ont pas de CLI ou d'API.
Quand l'utilisation de l'ordinateur s'applique
Claude a plusieurs façons d'interagir avec une application ou un service. L'utilisation de l'ordinateur est la plus large et la plus lente, donc Claude essaie d'abord l'outil le plus précis :
- Si vous avez un serveur MCP pour le service, Claude l'utilise.
- Si la tâche est une commande shell, Claude utilise Bash.
- Si la tâche est du travail de navigateur et que vous avez Claude dans Chrome configuré, Claude l'utilise.
- Si aucun de ces éléments ne s'applique, Claude utilise l'utilisation de l'ordinateur.
Le contrôle de l'écran est réservé aux choses que rien d'autre ne peut atteindre : les applications natives, les simulateurs et les outils sans API.
Activer l'utilisation de l'ordinateur
L'utilisation de l'ordinateur est disponible en tant que serveur MCP intégré appelé computer-use. Elle est désactivée par défaut jusqu'à ce que vous l'activiez.
Ouvrir le menu MCP
Dans une session Claude Code interactive, exécutez :
/mcp
Trouvez computer-use dans la liste des serveurs. Il s'affiche comme désactivé.
Activer le serveur
Sélectionnez computer-use et choisissez Activer. Le paramètre persiste par projet, vous ne le faites donc qu'une fois pour chaque projet où vous souhaitez utiliser l'ordinateur.
Accorder les autorisations macOS
La première fois que Claude essaie d'utiliser votre ordinateur, vous verrez une invite pour accorder deux autorisations macOS :
- Accessibilité : permet à Claude de cliquer, taper et faire défiler
- Enregistrement d'écran : permet à Claude de voir ce qui est sur votre écran
L'invite inclut des liens pour ouvrir le volet Paramètres système pertinent. Accordez les deux, puis sélectionnez Réessayer dans l'invite. macOS peut vous demander de redémarrer Claude Code après avoir accordé l'enregistrement d'écran.
Après la configuration, demandez à Claude de faire quelque chose qui nécessite la GUI :
Créez la cible d'application, lancez-la et cliquez sur chaque onglet pour
vous assurer que rien ne plante. Faites une capture d'écran de tout état
d'erreur que vous trouvez.
Approuver les applications par session
L'activation du serveur computer-use ne donne pas à Claude accès à chaque application sur votre machine. La première fois que Claude a besoin d'une application spécifique dans une session, une invite apparaît dans votre terminal montrant :
- Quelles applications Claude souhaite contrôler
- Toute autorisation supplémentaire demandée, comme l'accès au presse-papiers
- Combien d'autres applications seront masquées pendant que Claude travaille
Choisissez Autoriser pour cette session ou Refuser. Les approbations durent pour la session actuelle. Vous pouvez approuver plusieurs applications à la fois lorsque Claude les demande ensemble.
Les applications avec une large portée affichent un avertissement supplémentaire dans l'invite pour que vous sachiez ce que l'approbation leur accorde :
| Avertissement | S'applique à |
|---|---|
| Équivalent à l'accès shell | Terminal, iTerm, VS Code, Warp et autres terminaux et IDE |
| Peut lire ou écrire n'importe quel fichier | Finder |
| Peut modifier les paramètres système | Paramètres système |
Ces applications ne sont pas bloquées. L'avertissement vous permet de décider si la tâche justifie ce niveau d'accès.
Le niveau de contrôle de Claude varie également selon la catégorie d'application : les navigateurs et les plateformes de trading sont en lecture seule, les terminaux et les IDE sont en clic uniquement, et tout le reste obtient un contrôle complet. Consultez autorisations des applications dans Desktop pour la répartition complète des niveaux.
Comment Claude fonctionne sur votre écran
Comprendre le flux vous aide à anticiper ce que Claude fera et comment intervenir.
Une session à la fois
L'utilisation de l'ordinateur maintient un verrou à l'échelle de la machine pendant qu'elle est active. Si une autre session Claude Code utilise déjà votre ordinateur, les nouvelles tentatives échouent avec un message vous indiquant quelle session détient le verrou. Terminez ou quittez cette session d'abord.
Les applications sont masquées pendant que Claude travaille
Lorsque Claude commence à contrôler votre écran, les autres applications visibles sont masquées pour que Claude n'interagisse qu'avec les applications approuvées. Votre fenêtre de terminal reste visible et est exclue des captures d'écran, vous pouvez donc regarder la session et Claude ne voit jamais sa propre sortie.
Lorsque Claude termine le tour, les applications masquées sont restaurées automatiquement.
Les captures d'écran sont réduites automatiquement
Claude Code réduit chaque capture d'écran avant de l'envoyer au modèle. Vous n'avez pas besoin de réduire votre résolution d'affichage ou de redimensionner les fenêtres sur les écrans Retina ou autres écrans haute résolution. Un MacBook Pro 16 pouces à résolution Retina native capture à 3456×2234 et réduit à environ 1372×887, en préservant le rapport d'aspect.
Il n'y a pas de paramètre pour modifier la taille cible. Si le texte ou les contrôles à l'écran sont trop petits pour que Claude les lise après la réduction, augmentez leur taille dans l'application plutôt que de modifier votre résolution d'affichage.
Arrêter à tout moment
Lorsque Claude acquiert le verrou, une notification macOS apparaît : « Claude utilise votre ordinateur · appuyez sur Échap pour arrêter ». Appuyez sur Échap n'importe où pour abandonner l'action actuelle immédiatement, ou appuyez sur Ctrl+C dans le terminal. De toute façon, Claude libère le verrou, affiche vos applications et vous rend le contrôle.
Une deuxième notification apparaît lorsque Claude a terminé.
Sécurité et limite de confiance
Contrairement à l'outil Bash en bac à sable, l'utilisation de l'ordinateur s'exécute sur votre vrai bureau avec accès aux applications que vous approuvez. Claude vérifie chaque action et signale les injections de requête potentielles du contenu à l'écran, mais la limite de confiance est différente. Consultez le guide de sécurité de l'utilisation de l'ordinateur pour les meilleures pratiques.
Les garde-fous intégrés réduisent le risque sans nécessiter de configuration :
- Approbation par application : Claude ne peut contrôler que les applications que vous avez approuvées dans la session actuelle.
- Avertissements sentinelles : les applications qui accordent l'accès shell, système de fichiers ou paramètres système sont signalées avant que vous les approuviez.
- Terminal exclu des captures d'écran : Claude ne voit jamais votre fenêtre de terminal, donc les invites à l'écran dans votre session ne peuvent pas être renvoyées au modèle.
- Échappement global : la touche
Échapabandonne l'utilisation de l'ordinateur de n'importe où, et la pression sur la touche est consommée pour que l'injection de requête ne puisse pas l'utiliser pour fermer les dialogues. - Fichier de verrou : une seule session peut contrôler votre machine à la fois.
Exemples de flux de travail
Ces exemples montrent les façons courantes de combiner l'utilisation de l'ordinateur avec les tâches de codage.
Valider une compilation native
Après avoir apporté des modifications à une application macOS ou iOS, demandez à Claude de compiler et vérifier en une seule passe :
Créez la cible MenuBarStats, lancez-la, ouvrez la fenêtre des préférences
et vérifiez que le curseur d'intervalle met à jour l'étiquette. Faites une
capture d'écran de la fenêtre des préférences lorsque vous avez terminé.
Claude exécute xcodebuild, lance l'application, interagit avec l'interface utilisateur et rapporte ce qu'il trouve.
Reproduire un bogue de mise en page
Lorsqu'un bogue visuel n'apparaît qu'à certaines tailles de fenêtre, laissez Claude le trouver :
La modale des paramètres coupe son pied de page sur les fenêtres étroites.
Redimensionnez la fenêtre de l'application jusqu'à ce que vous puissiez la
reproduire, faites une capture d'écran de l'état coupé, puis vérifiez le
CSS du conteneur modal.
Claude redimensionne la fenêtre, capture l'état cassé et lit les feuilles de style pertinentes.
Tester un flux de simulateur
Pilotez le simulateur iOS sans écrire XCTest :
Ouvrez le simulateur iOS, lancez l'application, appuyez sur les écrans
d'intégration et dites-moi si un écran prend plus d'une seconde à charger.
Claude contrôle le simulateur de la même manière que vous le feriez avec une souris.
Différences par rapport à l'application Desktop
Les surfaces CLI et Desktop partagent le même moteur d'utilisation de l'ordinateur, avec quelques différences :
| Fonctionnalité | Desktop | CLI |
|---|---|---|
| Plateformes | macOS et Windows | macOS uniquement |
| Activer | Basculer dans Paramètres > Général (sous Application Desktop) | Activer computer-use dans /mcp |
| Liste des applications refusées | Configurable dans les paramètres | Pas encore disponible |
| Basculer l'affichage automatique | Optionnel | Toujours activé |
| Intégration Dispatch | Les sessions générées par Dispatch peuvent utiliser l'utilisation de l'ordinateur | Non applicable |
Dépannage
« L'utilisation de l'ordinateur est utilisée par une autre session Claude »
Une autre session Claude Code détient le verrou. Terminez la tâche dans cette session ou quittez-la. Si l'autre session a planté, le verrou est libéré automatiquement lorsque Claude détecte que le processus n'est plus en cours d'exécution.
L'invite de permissions macOS continue de réapparaître
macOS nécessite parfois un redémarrage du processus demandeur après avoir accordé l'enregistrement d'écran. Quittez complètement Claude Code et démarrez une nouvelle session. Si l'invite persiste, ouvrez Paramètres système > Confidentialité et sécurité > Enregistrement d'écran et confirmez que votre application de terminal est répertoriée et activée.
`computer-use` n'apparaît pas dans `/mcp`
Le serveur n'apparaît que sur les configurations éligibles. Vérifiez que :
- Vous êtes sur macOS. L'utilisation de l'ordinateur dans la CLI n'est pas disponible sur Linux ou Windows. Sur Windows, utilisez utilisation de l'ordinateur dans Desktop à la place.
- Vous exécutez Claude Code v2.1.85 ou ultérieur. Exécutez
claude --versionpour vérifier. - Vous êtes sur un plan Pro ou Max. Exécutez
/statuspour confirmer votre abonnement. - Vous êtes authentifié via claude.ai. L'utilisation de l'ordinateur n'est pas disponible avec les fournisseurs tiers comme Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry. Si vous accédez à Claude exclusivement via un fournisseur tiers, vous avez besoin d'un compte claude.ai séparé pour utiliser cette fonctionnalité.
- Vous êtes dans une session interactive. L'utilisation de l'ordinateur n'est pas disponible en mode non-interactif avec le drapeau
-p.
Voir aussi
- Utilisation de l'ordinateur dans Desktop : la même capacité avec une page de paramètres graphique
- Claude dans Chrome : automatisation du navigateur pour les tâches basées sur le web
- MCP : connectez Claude à des outils et des API structurés
- Bac à sable : comment l'outil Bash de Claude isole l'accès au système de fichiers et au réseau
- Guide de sécurité de l'utilisation de l'ordinateur : meilleures pratiques pour une utilisation sécurisée de l'ordinateur