Dein Claude-Agent für neue Kunden
Harvey ist ein kostenloses Open-Source-Projekt auf GitHub (von ethanplusai, MIT-Lizenz). Es macht aus Claude Code einen Vertriebs-Assistenten: Er findet passende Firmen, recherchiert sie und schreibt persönliche Mails. Nichts wird verschickt, ohne dass du es freigibst.
Harvey läuft auf deinem Rechner in einer Schleife: Etwa alle 15 Minuten wacht er auf, schaut, was gerade wichtig ist, erledigt es und schläft wieder. Die KI-Arbeit läuft über dein Claude-Abo, es gibt also keine extra KI-Rechnung.
Was es kostet
| Harvey selbst | kostenlos |
| Claude Pro oder Max (hast du vielleicht schon) | dein Abo |
| Firmen finden über OpenStreetMap | kostenlos |
| Optional: bessere Datenquellen | ab ca. 0,37 $ / 1.000 Firmen |
| Postfach (Google Workspace) | ca. 7 $ / Monat |
| Eigene Absender-Domain | ca. 10–15 € / Jahr |
Was du brauchst
- Einen Rechner (Mac, Windows oder Linux), der laufen darf, während Harvey arbeitet
- Claude Pro oder Max mit installiertem Claude Code (claude.com/product/claude-code)
- Git (git-scm.com) und Python 3.11 oder neuer, am besten 3.13 (python.org)
- Ein Postfach auf einer zweiten Domain nur zum Versenden, nie deine Haupt-Mailadresse
- Die Adresse deiner Webseite, damit Harvey lernt, was du anbietest
⚠ Wichtig: Werbe-Mails in Deutschland
In Deutschland brauchst du für Werbe-Mails grundsätzlich eine vorherige Einwilligung des Empfängers, auch bei Firmen. Wer ohne Einwilligung kalt anschreibt, riskiert Abmahnungen. Harveys eigene Anleitung weist ebenfalls darauf hin.
- Nutze Harvey bei deutschen Firmen vor allem zum Finden, Recherchieren und Vorschreiben. Ob und wie du Kontakt aufnimmst, entscheidest du.
- Harvey hat eine Prüffunktion namens Precleared. Laut Harveys Einstellungen ist sie aber derzeit nur für Absender aus Großbritannien und den USA gedacht. Verlass dich als Absender aus Deutschland nicht darauf.
- Jede Mail braucht: deinen echten Namen, dein Impressum und eine einfache Möglichkeit, „Nein danke“ zu sagen.
Das ist keine Rechtsberatung. Wenn du im großen Stil verschickst, frag einen Anwalt.
1 Harvey herunterladen
Öffne das Terminal (Mac: Programm „Terminal“, Windows: „PowerShell“) und füge diese Zeilen nacheinander ein:
Claude Code startet im Harvey-Ordner. Wenn es nach einer Anmeldung fragt, wähle dein Claude-Konto.
2 Claude richtet alles für dich ein
Harvey bringt eine eigene Anleitung für Claude mit. Claude wird damit zum Einrichtungs-Assistenten. Tippe einfach:
Claude prüft, was fehlt, installiert es, stellt dir ein paar Fragen und bringt Harvey dein Angebot bei. Wenn du nicht weiterkommst:
3 Harvey beibringen, was du verkaufst
Meist erledigt Claude das für dich. Falls nicht:
Dann beschreibst du Claude deinen Wunschkunden in ein, zwei Sätzen, zum Beispiel:
4 Festlegen, worauf Harvey achten soll
Harvey kann viele Merkmale einer Firma prüfen, z. B. ob sie Google-Werbung schaltet, ob es eine Online-Buchung gibt oder ob der Blog eingeschlafen ist. Er sammelt nur, was du bestätigst. Alle kostenlosen Merkmale einschalten:
5 Firmen finden
Die erste Zeile zeigt dir vorher, was die Suche kostet (die Standardquelle ist kostenlos). Die zweite startet die Suche. OpenStreetMap hat nicht jede Branche gut erfasst. Wenn zu wenig gefunden wird: größere Stadt, breitere Beschreibung oder eine günstige bezahlte Quelle.
6 Dashboard öffnen und Harvey starten
Öffne http://localhost:5555 im Browser. Dort siehst du alles live. Neue Mails landen im Postausgang: lesen, dann freigeben, bearbeiten oder ablehnen. Das Terminal mit harvey run muss offen bleiben.
Not-Aus, falls etwas schiefläuft: harvey sending pause
7 Die Mails klingen lassen wie du
Harveys Verkaufswissen steht in einfachen Textdateien im Ordner skills/. Lass Claude sie anpassen:
Damit deine Mails nicht im Spam landen
- Eigene Absender-Domain (z. B. deinname-mail.de), nie deine Haupt-Domain
- SPF, DKIM und DMARC für diese Domain einrichten. Ohne die drei landet fast alles im Spam. Claude kann dir dabei Schritt für Schritt helfen.
- 2–4 Wochen aufwärmen, bevor du richtig loslegst
- Langsam steigern: mit 10–20 Mails pro Tag anfangen, dann vorsichtig mehr
- Nie Adresslisten kaufen und Rückläufer im Blick behalten. Ab ca. 3 % stoppen und prüfen.
Wenn etwas nicht klappt
- „python not found“ oder Versionsfehler: Python 3.13 von python.org installieren, dann Claude sagen: „Repariere meine Python-Einrichtung für Harvey.“
- Keine Firmen gefunden: Deine Branche oder Stadt ist bei OpenStreetMap dünn. Größere Stadt, breitere Beschreibung oder bezahlte Quelle (vorher
--estimate). - Harvey arbeitet nicht mehr: Dein Rechner ist eingeschlafen, oder dein Claude-Kontingent ist aufgebraucht. Harvey lässt automatisch Platz für deine eigene Claude-Arbeit und wartet.
- Windows: Statt der Mac-Befehle nutzt Claude
py -3.13. Sag einfach, dass du Windows hast.
Offizielles Projekt: github.com/ethanplusai/harvey
Mehr KI-Tools wie dieses gibt's auf Instagram: @metingms1
