Zum Hauptinhalt springen
Claude Code integriert sich mit der Claude in Chrome Browser-Erweiterung, um Ihnen Browser-Automatisierungsfunktionen über die CLI oder die VS Code-Erweiterung bereitzustellen. Erstellen Sie Ihren Code und testen und debuggen Sie ihn dann im Browser, ohne den Kontext zu wechseln. Claude öffnet neue Registerkarten für Browser-Aufgaben und teilt den Anmeldestatus Ihres Browsers, sodass er auf alle Websites zugreifen kann, bei denen Sie bereits angemeldet sind. Browser-Aktionen werden in Echtzeit in einem sichtbaren Chrome-Fenster ausgeführt. Wenn Claude auf eine Anmeldeseite oder ein CAPTCHA trifft, wird es angehalten und fordert Sie auf, es manuell zu bearbeiten. Die Erweiterung sammelt die Registerkarten, die Claude öffnet, in einer Chrome-Registerkartengruppe, die an Ihre Sitzung gebunden ist. In lokalen Sitzungen hängt davon ab, ob Claude Code diese Gruppe beim Beenden der Sitzung schließt, wie die Sitzung endet:
  • Wenn Sie /clear eingeben, schließt Claude Code die Gruppe einschließlich offener Seiten, es sei denn, Arbeit, die das Löschen übersteht, wird noch ausgeführt
  • Wenn Sie Sitzungen mit einem Befehl wie /resume wechseln, Claude Code beenden oder /clear ausführen, während Arbeit, die es übersteht, noch läuft, schließt Claude Code die Gruppe nur, wenn sie nichts als leere neue Registerkarten enthält, sodass Seiten, die Sie möglicherweise noch lesen, offen bleiben
Die Chrome-Integration funktioniert mit Google Chrome und Microsoft Edge. Claude Code erkennt die Erweiterung auch in anderen Chromium-basierten Browsern, einschließlich Brave, Arc, Vivaldi und Opera, und richtet die Verbindung ein. Die Chrome-Integration wird in Windows Subsystem for Linux (WSL) nicht unterstützt.

Funktionen

Mit verbundenem Chrome können Sie Browser-Aktionen mit Codierungsaufgaben in einem einzigen Workflow verketten:
  • Live-Debugging: Lesen Sie Konsolenfehler und DOM-Status direkt aus und beheben Sie dann den Code, der sie verursacht hat
  • Design-Verifizierung: Erstellen Sie eine Benutzeroberfläche aus einem Figma-Mock und öffnen Sie sie dann im Browser, um zu überprüfen, ob sie übereinstimmt
  • Web-App-Tests: Testen Sie die Formularvalidierung, überprüfen Sie auf visuelle Regressionen oder überprüfen Sie Benutzerflüsse
  • Authentifizierte Web-Apps: Interagieren Sie mit Google Docs, Gmail, Notion oder einer beliebigen App, bei der Sie angemeldet sind, ohne API-Konnektoren
  • Datenextraktion: Extrahieren Sie strukturierte Informationen von Webseiten und speichern Sie sie lokal
  • Task-Automatisierung: Automatisieren Sie wiederholte Browser-Aufgaben wie Dateneingabe, Formularausfüllung oder Multi-Site-Workflows
  • Datei-Uploads: Fügen Sie Dateien von Ihrem Computer an Upload-Felder auf Webseiten an
  • Sitzungsaufzeichnung: Zeichnen Sie Browser-Interaktionen als GIFs auf, um zu dokumentieren oder zu teilen, was passiert ist

Voraussetzungen

Bevor Sie Claude Code mit Chrome verwenden, benötigen Sie: In Enterprise-Organisationen, in denen HIPAA aktiviert ist, ist Claude in Chrome standardmäßig ausgeschaltet, und ein Owner kann es unter Organisationseinstellungen > Claude in Chrome einschalten. Ihre Business Associate Agreement (BAA) mit Anthropic deckt keine Daten ab, die über Claude in Chrome an Websites von Drittanbietern gesendet werden. Eine Liste der Eligible Services finden Sie im Implementation Guide. Die Chrome-Integration erfordert auch die Anmeldung mit /login. Wenn Sie sich mit einem API-Schlüssel oder einem langlebigen Token von claude setup-token authentifizieren, behält Claude Code die Chrome-Integration aus, auch wenn Sie --chrome übergeben. Die Browser-Erweiterung kann sich nicht mit diesen Anmeldedaten authentifizieren.
Die Chrome-Integration ist nicht über Drittanbieter wie Amazon Bedrock, Google Cloud’s Agent Platform oder Microsoft Foundry verfügbar. Wenn Sie Claude ausschließlich über einen Drittanbieter nutzen, benötigen Sie ein separates claude.ai-Konto, um diese Funktion zu verwenden.

Erste Schritte in der CLI

1

Claude Code mit Chrome starten

Starten Sie Claude Code mit dem Flag --chrome:
Beim ersten Start mit Chrome zeigt Claude Code einen einmaligen Dialog an, der die Integration vorstellt und erklärt, wie Website-Berechtigungen funktionieren. Drücken Sie Enter, um fortzufahren.Wie Sie Chrome für zukünftige Sitzungen ohne das Flag aktivieren, erfahren Sie unter Chrome standardmäßig aktivieren.
2

Claude bitten, den Browser zu verwenden

Dieses Beispiel navigiert zu einer Seite, interagiert mit ihr und meldet, was es findet, alles direkt aus Ihrem Terminal oder Editor:
Wenn Claude Code vor einer Browser-Aktion um Erlaubnis fragt, bestätigen Sie diese. Der Dialog beginnt mit Claude in Chrome wants to und bietet eine Option, alle Aktionen auf dieser Website für die Sitzung zu erlauben. Claude öffnet einen neuen Tab und beginnt mit der Aufgabe.
Führen Sie jederzeit /chrome aus, um den Verbindungsstatus zu prüfen, Berechtigungen zu verwalten, die Erweiterung erneut zu verbinden oder auszuwählen, welcher verbundene Browser verwendet werden soll. Die Integration funktioniert, wenn das Statusfenster „Status: Enabled“ und „Extension: Installed“ anzeigt. Wenn mehr als ein Browser verbunden ist, wählen Sie aus, welchen Claude verwendet. Wenn eine Browser-Aktion startet, bevor Sie eine Auswahl getroffen haben, fordert Claude Sie auf, einen auszuwählen. Um später den Browser zu wechseln, führen Sie /chrome aus und wählen Select browser…. Claude verwendet weiterhin Ihre Auswahl, auch wenn sich ein anderer Browser verbindet. Informationen zu VS Code finden Sie unter Browser-Automatisierung in VS Code.

Die Erweiterung installieren, wenn Claude danach fragt

Wenn Claude in einer interaktiven Sitzung Ihren Browser benötigt und Claude Code die Erweiterung nicht erkennt, zeigt Claude Code eine Installationsabfrage mit dem Titel „Claude wants to use your browser“ an. Claude Code fragt höchstens einmal pro Sitzung. Die Abfrage bietet drei Optionen:
  • Install extension: Öffnet die Installationsseite der Erweiterung in Ihrem Browser und startet eine geführte Einrichtung. Claude Code wartet auf die Installation, verbindet die Erweiterung und aktiviert die Browser-Tools in derselben Sitzung. Wenn die Verbindung bereit ist, wählen Sie „Continue with browser tools“, und Claude setzt die Aufgabe in Ihrem Browser fort. Sie können die Einrichtung verlassen, indem Sie „Continue without browser tools“ wählen, und sie später mit /chrome abschließen.
  • Not now: Setzt die Aufgabe ohne Browser-Tools fort. Claude Code kann in einer späteren Sitzung erneut fragen.
  • Don’t ask again: Unterdrückt die Abfrage in zukünftigen Sitzungen. Sie können die Integration trotzdem jederzeit mit /chrome einrichten.
Zwei verwaltete MCP-Richtlinien schalten die Abfrage aus:

Chrome standardmäßig aktivieren

Um Chrome zu verbinden, ohne jedes Mal --chrome zu übergeben, führen Sie /chrome in einer CLI-Sitzung aus und wählen Enabled by default. Geben Sie in der VS Code-Erweiterung /chrome in das Eingabefeld ein und schalten Sie den Schalter Enabled by default ein. Beide teilen sich eine Einstellung, sodass das Einschalten an einer der beiden Stellen sie sowohl für die CLI als auch für VS Code einschaltet. Mit aktivierter Einstellung und Claude Code v2.1.287 oder höher verbindet sich jede VS Code-Sitzung beim Start mit Ihrem Browser, sodass Claude ihn verwenden kann, bevor Sie @browser eingeben. In früheren Versionen oder bei deaktivierter Einstellung verbindet sich eine VS Code-Sitzung, wenn Sie @browser eingeben. Claude Code startet normal, wenn Chrome nicht läuft.
Die standardmäßige Aktivierung von Chrome erhöht die Kontextnutzung, da die Browser-Tools und ihre Anweisungen immer geladen sind. Wenn Sie einen erhöhten Kontextverbrauch bemerken, schalten Sie die Einstellung aus und verbinden Sie sich nur bei Bedarf, mit --chrome in der CLI oder durch Eingabe von @browser im Eingabefeld von VS Code.

Den Startdialog beantworten

Wenn beim Start von claude der Dialog „Claude in Chrome extension detected“ erscheint, ändert Ihre Antwort die Einstellung Enabled by default:
  • Yes, use my browser: Schaltet die Einstellung ein und verbindet diese Sitzung
  • No, keep browser tools off oder Esc: Schaltet die Einstellung aus, und Claude Code bietet nicht mehr an, Chrome einzurichten
Um Ihre Antwort für spätere Sitzungen zu ändern, führen Sie /chrome aus.

Website-Berechtigungen verwalten

Berechtigungen auf Website-Ebene werden von der Chrome-Erweiterung übernommen. Verwalten Sie Berechtigungen in den Einstellungen der Chrome-Erweiterung, um festzulegen, auf welchen Websites Claude surfen, klicken und tippen kann. Im Auto-Modus überspringt die Erweiterung ihre eigene Prüfung pro Website für einen Browser-Aufruf, wenn der Klassifikator des Auto-Modus diesen Aufruf an eine Website selbst genehmigt, es sei denn, Ihre Berechtigungsregeln verweigern Claude in Chrome eine beliebige Website.

Berechtigungsabfragen in VS Code-Sitzungen

Wenn Claude Code in einer VS Code-Sitzung vor einer Browser-Aktion nachfragt, erscheint die Abfrage als Karte im Chat-Bereich. Wenn die Aktion auf eine Website abzielt, die Sie nicht erlaubt haben, bietet die Karte zusätzlich an, diese Website zu erlauben. In einer Sitzung, die sich beim Start mit Ihrem Browser verbunden hat, weil Enabled by default eingeschaltet ist, fragt Claude Code in den Berechtigungsmodi Manual, Edit automatically, Auto und Bypass permissions vor Browser-Aktionen auf einer Website nach, die Sie nicht erlaubt haben. In den Modi Auto und Bypass permissions gilt dies, bis Sie in dieser Sitzung @browser eingeben.

Browser-Tools im Plan-Modus

Im Plan-Modus erscheint eine Berechtigungsabfrage, bevor Claude ein GIF aufzeichnet oder einen neuen Tab öffnet. Wenn in einer interaktiven CLI-Sitzung der Bypass-Permissions-Modus verfügbar ist und das Abrufen von Feature-Flags ausgeschaltet ist, laufen diese Aufrufe ohne Abfrage. Ein tabs_context_mcp-Aufruf löst ebenfalls eine Abfrage aus, wenn er createIfEmpty setzt, ebenso ein browser_batch-Aufruf, der eine dieser Aktionen enthält.

Beispiel-Workflows

Diese Beispiele zeigen gängige Möglichkeiten, Browser-Aktionen mit Programmieraufgaben zu kombinieren. Führen Sie /mcp aus, wählen Sie claude-in-chrome und anschließend View tools, um die vollständige Liste der verfügbaren Browser-Tools anzuzeigen.

Eine lokale Webanwendung testen

Bitten Sie Claude bei der Entwicklung einer Web-App, zu überprüfen, ob Ihre Änderungen korrekt funktionieren:
Claude navigiert zu Ihrem lokalen Server, interagiert mit dem Formular und berichtet, was es beobachtet.

Mit Konsolen-Logs debuggen

Claude kann die Konsolenausgabe lesen, um bei der Diagnose von Problemen zu helfen. Teilen Sie Claude mit, nach welchen Mustern es suchen soll, anstatt die gesamte Konsolenausgabe anzufordern, da Logs sehr umfangreich sein können:
Claude liest die Konsolenmeldungen und kann nach bestimmten Mustern oder Fehlertypen filtern.

Formulare automatisch ausfüllen

Beschleunigen Sie sich wiederholende Dateneingabeaufgaben:
Claude liest Ihre lokale Datei, navigiert durch die Weboberfläche und gibt die Daten für jeden Datensatz ein.

Dateien auf Webseiten hochladen

Claude kann Dateien von Ihrem Rechner an Upload-Felder auf einer Seite anhängen. Claude Code liest die Datei und sendet ihren Inhalt an den Browser, sodass Uploads sowohl in lokalen als auch in Remote-Sitzungen funktionieren. Dieses Beispiel hängt eine Logdatei an ein Formular an:
Wenn Claude sich weigert, eine Datei anzuhängen, oder ein Upload fehlschlägt, prüfen Sie folgende Ursachen:
  • Berechtigungen: Claude kann eine Datei nur hochladen, wenn die Sitzung sie lesen darf. Berechtigungsregeln, die den Read-Zugriff auf eine Datei verweigern, blockieren daher auch deren Upload.
  • Größe: Ein einzelner Upload kann insgesamt bis zu 10 MB an Dateien umfassen.
  • Hardlinks: Claude lehnt Dateien mit mehreren Hardlinks ab, was in Speichern von Paketmanagern wie node_modules häufig vorkommt. Kopieren Sie die Datei und laden Sie die Kopie hoch.
  • Namen von Anmeldedaten: Claude lehnt eine Datei ab, deren Name oder Ordner einer ist, unter dem Anmeldedaten gespeichert werden, etwa .env, eine .pem- oder .key-Datei oder alles unter .ssh. Erfordert Claude Code v2.1.293 oder neuer.

Inhalte in Google Docs entwerfen

Lassen Sie Claude direkt in Ihre Dokumente schreiben, ohne API-Einrichtung:
Claude öffnet das Dokument, klickt in den Editor und tippt den Inhalt ein. Dies funktioniert mit jeder Web-App, bei der Sie angemeldet sind: Gmail, Notion, Sheets und mehr.

Daten aus Webseiten extrahieren

Rufen Sie strukturierte Informationen von Websites ab:
Claude navigiert zur Seite, liest den Inhalt und stellt die Daten in einem strukturierten Format zusammen.

Workflows über mehrere Websites ausführen

Koordinieren Sie Aufgaben über mehrere Websites hinweg:
Claude arbeitet tabübergreifend, um Informationen zu sammeln und den Workflow abzuschließen.

Ein Demo-GIF aufnehmen

Erstellen Sie teilbare Aufnahmen von Browser-Interaktionen:
Claude zeichnet die Interaktionsabfolge auf und speichert sie als GIF-Datei. Die Aufnahme erfasst alles, was im Browser sichtbar ist, einschließlich Kontodaten auf Seiten, auf denen Sie angemeldet sind. Überprüfen Sie sie daher, bevor Sie sie außerhalb Ihres Teams teilen.

Screenshots auf der Festplatte speichern

Bitten Sie Claude, einen Screenshot als Datei zu speichern:
Claude speichert das Bild auf der Festplatte und gibt den Dateipfad an.

Fehlerbehebung

Erweiterung nicht erkannt

Wenn Claude Code die Chrome-Erweiterung nicht erkennen kann:
  1. Überprüfen Sie, ob die Chrome-Erweiterung in chrome://extensions installiert und aktiviert ist
  2. Überprüfen Sie, ob Claude Code aktuell ist, indem Sie claude --version ausführen
  3. Überprüfen Sie, ob Chrome ausgeführt wird
  4. Führen Sie /chrome aus und wählen Sie „Erweiterung erneut verbinden“, um die Verbindung wiederherzustellen
  5. Wenn das Problem weiterhin besteht, starten Sie sowohl Claude Code als auch Chrome neu
Wenn Sie die Chrome-Integration zum ersten Mal aktivieren, installiert Claude Code eine Konfigurationsdatei für den nativen Messaging-Host. Chrome liest diese Datei beim Start, daher sollten Sie Chrome neu starten, um die neue Konfiguration zu übernehmen, wenn die Erweiterung beim ersten Versuch nicht erkannt wird. Claude Code öffnet beim ersten Installieren einen Browser-Tab, der Sie auffordert, die Erweiterung zu verbinden. Claude Code öffnet ihn nicht erneut, wenn eine spätere Sitzung die Konfigurationsdatei neu schreibt, z. B. nach dem Wechsel von Builds oder Konfigurationsverzeichnissen. Wenn die Verbindung weiterhin fehlschlägt, überprüfen Sie, ob die Host-Konfigurationsdatei vorhanden ist unter: Für 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: Überprüfen Sie HKCU\Software\Google\Chrome\NativeMessagingHosts\ in der Windows-Registrierung
Für Edge:
  • macOS: ~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Linux: ~/.config/microsoft-edge/NativeMessagingHosts/com.anthropic.claude_code_browser_extension.json
  • Windows: Überprüfen Sie HKCU\Software\Microsoft\Edge\NativeMessagingHosts\ in der Windows-Registrierung
Andere Chromium-basierte Browser lesen die gleiche Datei aus ihrem eigenen Konfigurationsverzeichnis, das nach dem Browser benannt ist. Beispielsweise verwendet Brave auf macOS ~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/, und unter Windows hat jeder Browser seinen eigenen Registrierungsschlüssel, z. B. HKCU\Software\BraveSoftware\Brave-Browser\NativeMessagingHosts\.

Projekteinstellungen können Chrome nicht einschalten

Diese Warnung in Ihrem Terminal bedeutet, dass das Projekt, in dem Sie arbeiten, versucht hat, die Chrome-Integration einzuschalten, und Claude Code dies nicht zugelassen hat:
Die Datei .claude/settings.json oder .claude/settings.local.json des Projekts setzt CLAUDE_CODE_ENABLE_CFC in ihrem env-Block auf 1, um die Chrome-Integration einzuschalten. Claude Code hat diese Einstellung nicht angewendet, daher ist die Chrome-Integration in dieser Sitzung ausgeschaltet und Claude verfügt über keine Browser-Tools. Claude Code überspringt die Einstellung, weil diese Dateien im Projektverzeichnis gespeichert sind und ein Repository, das Sie auschecken, Claude nicht mit Ihrem Browser verbinden können darf. Sie können wie bisher weiterarbeiten. Wenn Sie Browser-Tools nutzen möchten oder die Warnung nicht mehr sehen möchten, gehen Sie auf eine der folgenden Arten vor:
  • Um Browser-Tools sofort zu erhalten: Beenden Sie Claude Code und starten Sie es in Ihrer Shell erneut mit claude --chrome.
  • Um Browser-Tools in späteren Sitzungen zu erhalten: Führen Sie /chrome in der Eingabeaufforderung von Claude Code aus und wählen Sie Standardmäßig aktiviert. Dies gilt für Sitzungen, die Sie danach starten, nicht für die laufende Sitzung.
  • Um die Warnung ohne Browser-Tools zu beenden: Entfernen Sie die Zeile CLAUDE_CODE_ENABLE_CFC aus der Einstellungsdatei des Projekts.

Browser antwortet nicht

Wenn Claudes Browser-Befehle nicht mehr funktionieren:
  1. Überprüfen Sie, ob ein modales Dialogfeld (Warnung, Bestätigung, Eingabeaufforderung) die Seite blockiert. JavaScript-Dialoge blockieren Browser-Ereignisse und verhindern, dass Claude Befehle empfängt. Schließen Sie das Dialogfeld manuell und teilen Sie Claude mit, dass es fortfahren soll.
  2. Bitten Sie Claude, eine neue Registerkarte zu erstellen und es erneut zu versuchen
  3. Starten Sie die Chrome-Erweiterung neu, indem Sie sie in chrome://extensions deaktivieren und erneut aktivieren

Verbindung wird während langer Sitzungen unterbrochen

Der Service Worker der Chrome-Erweiterung kann während längerer Sitzungen in den Leerlauf gehen, was die Verbindung unterbricht. Wenn Browser-Tools nach einer Inaktivitätsphase nicht mehr funktionieren, führen Sie /chrome aus und wählen Sie „Erweiterung erneut verbinden“. Wenn Sie /chrome ausführen, prüfen Sie die Zeile Status. Lautet sie „Nicht verbunden“, ist die eigene Verbindung der laufenden Sitzung zu Chrome fehlgeschlagen. Wählen Sie „Erweiterung erneut verbinden“, um diese Verbindung neu zu starten. Nachdem die Verbindung erfolgreich hergestellt wurde, öffnet sich die Seite zum erneuten Verbinden der Erweiterung in Chrome. Vor v2.1.290 öffnete „Erweiterung erneut verbinden“ nur diese Seite und startete eine fehlgeschlagene Verbindung nicht neu. Wenn die Browser-Tools in einer älteren Version also nicht zurückkehren, aktualisieren Sie Claude Code.

Erweiterung bei einer anderen Organisation angemeldet

Wenn Sie mehr als einer claude.ai-Organisation angehören, muss die Erweiterung bei derselben Organisation angemeldet sein wie Claude Code. Wenn sich die beiden unterscheiden, geben Claudes Browser-Tools „Browser extension is not connected“ zurück, selbst wenn beide dasselbe claude.ai-Konto verwenden. Um zu sehen, bei welcher Organisation Claude Code angemeldet ist, führen Sie /status in der Eingabeaufforderung von Claude Code aus und lesen Sie die Zeile Organization.
Wenn Sie sich von der Erweiterung abmelden, verlieren Sie die darin gespeicherten Shortcuts und geplanten Aufgaben. Probieren Sie zuerst die anderen Lösungen unter Häufige Fehlermeldungen aus.
Um die Organisation der Erweiterung zu ändern, melden Sie sich in den Einstellungen der Erweiterung ab, melden Sie sich dann wieder an und wählen Sie die Organisation aus, die /status anzeigt.

Windows-spezifische Probleme

Unter Windows können folgende Probleme auftreten:
  • Named Pipe-Konflikte (EADDRINUSE): Wenn ein anderer Prozess das gleiche Named Pipe verwendet, starten Sie Claude Code neu. Schließen Sie alle anderen Claude Code-Sitzungen, die möglicherweise Chrome verwenden.
  • Fehler beim nativen Messaging-Host: Wenn der native Messaging-Host beim Start abstürzt, versuchen Sie, Claude Code neu zu installieren, um die Host-Konfiguration zu regenerieren.
  • Setup-Seiten können nicht geöffnet werden: Aktualisieren Sie Claude Code. Vor v2.1.211 konnte der Browser-Tab, der Sie auffordert, die Erweiterung zu verbinden, unter Windows nicht geöffnet werden.

Häufige Fehlermeldungen

Dies sind die am häufigsten auftretenden Fehler und wie man sie behebt:

Siehe auch