Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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, 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.
1

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é.
2

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.
3

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 :
AvertissementS’applique à
Équivalent à l’accès shellTerminal, iTerm, VS Code, Warp et autres terminaux et IDE
Peut lire ou écrire n’importe quel fichierFinder
Peut modifier les paramètres systèmeParamè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.

​
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 Échap abandonne 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. Quelques contrôles spécifiques à Desktop ne sont pas encore dans la CLI :
FonctionnalitéDesktopCLI
ActiverBasculer dans Paramètres > Général (sous Application Desktop)Activer computer-use dans /mcp
Liste des applications refuséesConfigurable dans les paramètresPas encore disponible
Basculer l’affichage automatiqueOptionnelToujours activé
Intégration DispatchLes sessions générées par Dispatch peuvent utiliser l’utilisation de l’ordinateurNon 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 n’est pas disponible sur Linux ou Windows.
  • Vous exécutez Claude Code v2.1.85 ou ultérieur. Exécutez claude --version pour vérifier.
  • Vous êtes sur un plan Pro ou Max. Exécutez /status pour 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