Claude Codeper WhatsApp.

OpenWA läuft in Docker und bringt ein Dashboard im Browser mit. Voraussetzung ist Docker Desktop, gestartet. Die Befehle gibst du in PowerShell oder im Mac-Terminal ein.

1. Wechsle in einen Ordner, in dem das Projekt liegen soll, und lade OpenWA mit dem ersten Befehl herunter.
2. Leg im neuen Ordner OpenWA eine Textdatei mit dem Namen .env an und schreib die zwei Zeilen aus dem zweiten Kasten hinein. Unter Windows speichert der Editor sonst gern .env.txt: Wähl beim Speichern den Dateityp „Alle Dateien“. Die erste liefert der Brücke deine echte Nummer, die zweite erlaubt OpenWA, die Brücke auf deinem Rechner zu erreichen.
3. Starte OpenWA mit dem dritten Befehl. Beim ersten Mal baut Docker das Programm, das dauert eine Weile.
4. Öffne http://localhost:2785 im Browser. Das Dashboard fragt nach einem API-Key, also einem Zugangsschlüssel. Den findest du in der Datei OpenWA/data/.api-key.

git clone https://github.com/rmyndharis/OpenWA.git
cd OpenWA

RESOLVE_LID_TO_PHONE=true
SSRF_ALLOWED_HOSTS=host.docker.internal

docker compose -f docker-compose.dev.yml up -d

• Kontrolle: Das Dashboard nimmt den Schlüssel an und zeigt dir die Verwaltung. Das zeigt, dass OpenWA läuft. Es zeigt noch nicht, dass eine Nummer verbunden ist.

Die Verbindung funktioniert wie WhatsApp auf dem Laptop: OpenWA wird ein verknüpftes Gerät deiner Zweitnummer. Nimm dafür das Handy mit der Zweitnummer, nie das mit deiner Hauptnummer: Genau dieses Verknüpfen kann zur Sperre führen, siehe Schritt 1.

1. Leg im Dashboard eine neue Session an, also eine Verbindung zu einer Nummer, und starte sie.
2. Lass dir den QR-Code anzeigen. Er gilt 60 Sekunden, danach holst du einen neuen.
3. Öffne am Zweithandy in WhatsApp den Bereich für verknüpfte Geräte, füg dort ein neues Gerät hinzu und scann den Code. Die Menünamen können je nach Handy leicht abweichen.

• Kontrolle: Die Session steht im Dashboard auf ready, und am Handy taucht OpenWA unter den verknüpften Geräten auf. Das zeigt, dass die Leitung steht. Antworten kann noch niemand, dafür fehlt die Brücke.
• Handy liegen lassen: WhatsApp meldet verknüpfte Geräte ab, wenn das Haupthandy länger als 14 Tage nicht benutzt wird. Lass das Zweithandy am Ladekabel und nutz es ab und zu.

Die Brücke ist ein kleines Programm. OpenWA schickt ihr jede neue Nachricht über einen Webhook, also eine Adresse auf deinem Rechner, die OpenWA bei jeder Nachricht aufruft. Die Brücke prüft den Absender, gibt den Auftrag an Claude Code weiter und schickt die Antwort zurück. Schreiben musst du sie nicht selbst, das macht Claude Code mit meinem Prompt. Voraussetzung sind die Schritte 2 und 3, für Sprachnachrichten auch Schritt 4, und Claude Code ab Pro, installiert und angemeldet.

Bevor du den Prompt abschickst: Wer auf der Liste erlaubter Nummern steht, kann über WhatsApp auf deinem Rechner arbeiten lassen. Trag nur deine eigene Nummer ein. Der Prompt legt neben der Brücke einen Unterordner arbeit an. Nur dort liest und schreibt Claude für deine Aufträge, ohne Werkzeug für Terminal-Befehle, und den Code der Brücke kann Claude nicht ändern. Voraussetzung dafür ist Claude Code ab Version 2.1.257. Programme, die Claude in arbeit ablegt, führt die Brücke nicht aus. Ist auf deinem Rechner ANTHROPIC_API_KEY gesetzt, würde jeder Auftrag über die API abgerechnet, deshalb entfernt die Brücke diese Variable. Außerdem ist offen, ob ein Dauerbetrieb über dein Pro- oder Max-Abo von den Bedingungen von Anthropic gedeckt ist. Eindeutig erlaubt ist der Weg über einen API-Schlüssel. Warum, steht unten.

1. Leg einen neuen, leeren Ordner an, zum Beispiel whatsapp-bruecke, und starte darin Claude Code mit claude.
2. Kopier den Prompt, füg ihn ein und ersetz die drei Stellen in eckigen Klammern.
3. Beantworte die Rückfragen. Claude Code zeigt dir am Ende, wie du die Brücke startest, und testet die Verbindung von OpenWA aus.

Bau mir in diesem Ordner eine Brücke zwischen WhatsApp und Claude Code, als Python-Programm nur mit der Standardbibliothek. Leg daneben einen leeren Unterordner arbeit an. Nur darin arbeitet Claude später für meine Aufträge.

Meine eigene Nummer, die einzige erlaubte: [DEINE NUMMER MIT LÄNDERVORWAHL, NUR ZIFFERN]
OpenWA liegt hier: [PFAD ZUM ORDNER OPENWA]
whisper.cpp liegt hier: [PFAD ZUM ORDNER WHISPER.CPP ODER „NICHT INSTALLIERT“]

Bevor du baust:
1. Lies in OpenWA die Datei docs/06-api-specification.md, vor allem Webhooks, Nachrichten senden, Medien und API-Keys. Nimm Feldnamen und Endpunkte nur von dort.
2. Prüf, ob OpenWA unter http://localhost:2785 läuft und eine Session den Status ready hat, und ob claude --version mindestens 2.1.257 ist.
3. Stell mir höchstens drei Rückfragen und warte auf meine Antworten.

Beim Einrichten, einmalig:
- mit dem Admin-Key aus data/.api-key im OpenWA-Ordner einen eigenen API-Key mit der Rolle operator anlegen, beschränkt auf meine Session. Die Brücke speichert und nutzt nur diesen Key, nie den Admin-Key.
- einen Webhook für message.received mit einem zufälligen Secret registrieren. Die Brücke lauscht auf einem freien Port, den du wählst, und OpenWA erreicht sie über host.docker.internal.
- Key und Secret in einer Datei im Brückenordner ablegen, nicht in arbeit.

Die Brücke soll:
- dem Webhook sofort antworten und die Aufträge danach der Reihe nach abarbeiten, immer nur einen zur Zeit
- jede Zustellung über die Signatur X-OpenWA-Signature prüfen und doppelte über X-OpenWA-Idempotency-Key verwerfen
- nur Nachrichten annehmen, deren senderPhone gleich meiner Nummer ist oder deren from gleich meiner Nummer mit @c.us ist, keine Gruppen, alles andere kommentarlos verwerfen
- Sprachnachrichten (type voice) aus den Mediendaten holen, mit ffmpeg in 16-kHz-Mono-WAV umwandeln und mit whisper-cli, Modell ggml-small.bin und -l de in Text verwandeln. Ist whisper.cpp nicht installiert, auf Sprachnachrichten kurz antworten, dass nur Text geht.
- den Text an claude -p übergeben, mit arbeit als Arbeitsverzeichnis und genau diesen Optionen: --tools "Read,Glob,Grep,Edit,Write", --disallowedTools "mcp__*", --permission-mode dontAsk, --allowedTools "Edit(/**)", --settings '{"permissions":{"blockReadsOutsideWorkingDirectories":true}}', --setting-sources project, --output-format json, dazu --continue für Folgenachrichten, außer meine Nachricht lautet genau "neu"
- mit --append-system-prompt festlegen: höchstens fünf Sätze, kein Markdown, direkt mit dem Ergebnis anfangen, bei Unklarheit genau eine Rückfrage, nichts löschen und nichts nach außen senden
- ANTHROPIC_API_KEY aus der Umgebung dieses Aufrufs entfernen und kein --bare nutzen
- jeden claude-Aufruf nach 10 Minuten abbrechen und mir das melden
- vor längeren Aufträgen kurz "läuft" schicken und die Antwort über send-text an meine Nummer senden, höchstens 4096 Zeichen je Nachricht

Regeln:
- Gib Claude keine weiteren Werkzeuge oder Rechte als oben und ändere die Optionen nur nach meiner Zustimmung.
- Die Brücke führt nie Dateien aus arbeit aus.
- Schreib niemanden an. Die Brücke antwortet nur auf Nachrichten von meiner Nummer.

Zum Schluss: Prüf mit dem Test-Endpunkt des Webhooks, dass OpenWA die Brücke erreicht, und zeig mir, wie ich sie starte und stoppe.

• Kontrolle: Der Test des Webhooks meldet "success": true und "statusCode": 200. Das zeigt, dass OpenWA die Brücke erreicht. Es zeigt nicht, dass die Liste erlaubter Nummern und die Signaturprüfung greifen, das prüfst du in Schritt 6.

Jetzt schickst du deiner Zweitnummer von deinem eigenen Handy aus eine Nachricht. Starte vorher die Brücke so, wie Claude Code es dir gezeigt hat.

1. Schreib an die Zweitnummer: „Welche Dateien liegen im Arbeitsordner?“
2. Schick danach eine kurze Sprachnachricht mit einer ähnlichen Frage.
3. Schreib von einer dritten Nummer, etwa der eines Freundes mit seinem Einverständnis, eine Testnachricht. Sie darf keine Antwort bekommen.

• Das zeigt es: Auf deine Text- und Sprachnachricht kommt eine kurze Antwort, auf die fremde Nummer nichts. Dann arbeiten die Liste erlaubter Nummern, whisper.cpp und Claude zusammen.
• Das zeigt es nicht: ob WhatsApp die Nummer auf Dauer akzeptiert. Das Sperrrisiko bleibt, auch wenn alles läuft.