L’intégration Chrome est en bêta et fonctionne actuellement avec Google Chrome uniquement. Elle n’est pas encore prise en charge sur Brave, Arc ou d’autres navigateurs basés sur Chromium. WSL (Windows Subsystem for Linux) n’est pas non plus pris en charge.
Capacités
Avec Chrome connecté, vous pouvez enchaîner les actions du navigateur avec les tâches de codage dans un seul flux de travail :- Débogage en direct : lisez les erreurs de console et l’état du DOM directement, puis corrigez le code qui les a causées
- Vérification de la conception : créez une interface utilisateur à partir d’une maquette Figma, puis ouvrez-la dans le navigateur pour vérifier qu’elle correspond
- Test d’application web : testez la validation des formulaires, vérifiez les régressions visuelles ou vérifiez les flux utilisateur
- Applications web authentifiées : interagissez avec Google Docs, Gmail, Notion ou n’importe quelle application à laquelle vous êtes connecté sans connecteurs API
- Extraction de données : extrayez des informations structurées des pages web et enregistrez-les localement
- Automatisation des tâches : automatisez les tâches répétitives du navigateur comme la saisie de données, le remplissage de formulaires ou les flux multi-sites
- Enregistrement de session : enregistrez les interactions du navigateur sous forme de GIF pour documenter ou partager ce qui s’est passé
Prérequis
Avant d’utiliser Claude Code avec Chrome, vous avez besoin de :- Navigateur Google Chrome
- Extension Claude in Chrome version 1.0.36 ou supérieure
- Claude Code version 2.0.73 ou supérieure
- Un plan Anthropic direct (Pro, Max, Team ou Enterprise)
L’intégration Chrome n’est pas disponible via des 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é.
Démarrer dans la CLI
Lancer Claude Code avec Chrome
Démarrez Claude Code avec le drapeau Vous pouvez également activer Chrome au sein d’une session existante en exécutant
--chrome :/chrome./chrome à tout moment pour vérifier l’état de la connexion, gérer les autorisations ou reconnecter l’extension.
Pour VS Code, consultez l’automatisation du navigateur dans VS Code.
Activer Chrome par défaut
Pour éviter de passer--chrome à chaque session, exécutez /chrome et sélectionnez « Enabled by default ».
Dans l’extension VS Code, Chrome est disponible chaque fois que l’extension Chrome est installée. Aucun drapeau supplémentaire n’est nécessaire.
L’activation de Chrome par défaut dans la CLI augmente l’utilisation du contexte puisque les outils du navigateur sont toujours chargés. Si vous remarquez une augmentation de la consommation de contexte, désactivez ce paramètre et utilisez
--chrome uniquement si nécessaire.Gérer les autorisations du site
Les autorisations au niveau du site sont héritées de l’extension Chrome. Gérez les autorisations dans les paramètres de l’extension Chrome pour contrôler les sites que Claude peut parcourir, cliquer et taper.Exemples de flux de travail
Ces exemples montrent les façons courantes de combiner les actions du navigateur avec les tâches de codage. Exécutez/mcp et sélectionnez claude-in-chrome pour voir la liste complète des outils de navigateur disponibles.
Tester une application web locale
Lors du développement d’une application web, demandez à Claude de vérifier que vos modifications fonctionnent correctement :Déboguer avec les journaux de console
Claude peut lire la sortie de la console pour aider à diagnostiquer les problèmes. Dites à Claude quels modèles rechercher plutôt que de demander toute la sortie de la console, car les journaux peuvent être verbeux :Automatiser le remplissage de formulaires
Accélérez les tâches répétitives de saisie de données :Rédiger du contenu dans Google Docs
Utilisez Claude pour écrire directement dans vos documents sans configuration d’API :Extraire des données des pages web
Extrayez des informations structurées des sites web :Exécuter des flux de travail multi-sites
Coordonnez les tâches sur plusieurs sites web :Enregistrer un GIF de démonstration
Créez des enregistrements partageables des interactions du navigateur :Dépannage
Extension non détectée
Si Claude Code affiche « Chrome extension not detected » :- Vérifiez que l’extension Chrome est installée et activée dans
chrome://extensions - Vérifiez que Claude Code est à jour en exécutant
claude --version - Vérifiez que Chrome est en cours d’exécution
- Exécutez
/chromeet sélectionnez « Reconnect extension » pour rétablir la connexion - Si le problème persiste, redémarrez Claude Code et Chrome
- macOS :
~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json - Linux :
~/.config/google-chrome/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json - Windows : vérifiez
HKCU\Software\Google\Chrome\NativeMessagingHosts\dans le Registre Windows
Le navigateur ne répond pas
Si les commandes du navigateur de Claude cessent de fonctionner :- Vérifiez si une boîte de dialogue modale (alerte, confirmation, invite) bloque la page. Les boîtes de dialogue JavaScript bloquent les événements du navigateur et empêchent Claude de recevoir des commandes. Fermez la boîte de dialogue manuellement, puis demandez à Claude de continuer.
- Demandez à Claude de créer un nouvel onglet et réessayez
- Redémarrez l’extension Chrome en la désactivant et en la réactivant dans
chrome://extensions
La connexion s’interrompt lors de longues sessions
Le service worker de l’extension Chrome peut devenir inactif lors de sessions prolongées, ce qui rompt la connexion. Si les outils du navigateur cessent de fonctionner après une période d’inactivité, exécutez/chrome et sélectionnez « Reconnect extension ».
Problèmes spécifiques à Windows
Sous Windows, vous pouvez rencontrer :- Conflits de tuyau nommé (EADDRINUSE) : si un autre processus utilise le même tuyau nommé, redémarrez Claude Code. Fermez toute autre session Claude Code qui pourrait utiliser Chrome.
- Erreurs d’hôte de messagerie native : si l’hôte de messagerie native plante au démarrage, essayez de réinstaller Claude Code pour régénérer la configuration d’hôte.
Messages d’erreur courants
Ce sont les erreurs les plus fréquemment rencontrées et comment les résoudre :| Erreur | Cause | Solution |
|---|---|---|
| « Browser extension is not connected » | L’hôte de messagerie native ne peut pas atteindre l’extension | Redémarrez Chrome et Claude Code, puis exécutez /chrome pour reconnecter |
| « Extension not detected » | L’extension Chrome n’est pas installée ou est désactivée | Installez ou activez l’extension dans chrome://extensions |
| « No tab available » | Claude a tenté d’agir avant qu’un onglet soit prêt | Demandez à Claude de créer un nouvel onglet et réessayez |
| « Receiving end does not exist » | Le service worker de l’extension est devenu inactif | Exécutez /chrome et sélectionnez « Reconnect extension » |
Voir aussi
- Utiliser Claude Code dans VS Code : automatisation du navigateur dans l’extension VS Code
- Référence CLI : drapeaux de ligne de commande incluant
--chrome - Flux de travail courants : plus de façons d’utiliser Claude Code
- Données et confidentialité : comment Claude Code gère vos données
- Démarrer avec Claude in Chrome : documentation complète pour l’extension Chrome, incluant les raccourcis, la planification et les autorisations