Reicht ein kostenloser Claude-Account für dieses Setup?

Nein. Für Claude Code brauchst du einen Account Pro (20 $/Monat) oder höher (Max, Team, Enterprise). Der Free-Tier reicht nicht. Nach der Installation prüfst du mit claude --version und claude doctor, ob alles läuft.

Braucht mein Meta-Konto eine Business Verification?

Für dein eigenes Werbekonto reicht Development Access mit bis zu 5 Ad-Accounts. Willst du mehr Konten oder Kunden-Accounts anbinden, beantragst du Standard Access. Die Verification dauert 1 bis 5 Werktage.

Warum wird jede Ad als PAUSED angelegt?

Weil Auto-Activate ein Account-Risiko ist. generate.py legt Creative und Ad immer im Status PAUSED an. Aktiviert wird erst nach dem Visual-Check im Ads Manager per Hand. So verhinderst du, dass ungeprüfte oder fehlerhafte Creatives live gehen.

Ab welchem Ad-Spend lohnt sich der Aufwand?

Das Setup zahlt sich bei etwa 3.000 bis 5.000 Dollar Ad-Spend pro Monat innerhalb von 2 bis 3 Monaten aus. Bei kleinerem Budget bist du mit manueller Optimierung schneller am Ziel.

Was darf ich auf keinen Fall automatisieren?

Budget-Erhöhungen, Audience-Änderungen, die Ad-Aktivierung und das Pausieren von Top-Performern bleiben Handarbeit. Auto-Push von Live-Ads in regulierten Branchen wie Health, Finance, Crypto oder Politik ist tabu. Die KI analysiert und schlägt vor, entscheiden tust du.

Meta Ads × Claude Code: 30-Punkte-Checkliste

Die Trockenfassung zum Blog: 30 nummerierte Setup-Punkte in 4 Phasen (Meta-Setup, Code-Setup, Workflow, Compliance + Health). Mit Commands, Permissions, Scoring-Logik. Stand: Mai 2026, Marketing API v25.0.

Meta Ads mit Claude Code aufsetzen heißt: die Marketing API von Meta an ein KI-Terminal koppeln, das deine Ad-Performance liest, analysiert und neue Creatives vorschlägt. Die Betonung liegt auf vorschlägt. Jede neue Ad wird als PAUSED angelegt, aktiviert wird nur ein Mensch nach visueller Prüfung. Diese Seite ist die abhakbare Referenz: 30 Punkte in 4 Phasen.

Wenn du wissen willst, warum du das vorsichtig angehen solltest und was schiefgeht wenn nicht, lies die ganze Story im Blog. Eine Donnerstag-Geschichte mit 23 ungewollt aktivierten Ads und 847 Euro Lehrgeld. Diese Seite hier ist die Trockenfassung zum Durcharbeiten.

Stand: Mai 2026, Marketing API v25.0, Andromeda-Algorithmus.

Was brauche ich, bevor ich anfange?

Drei Dinge müssen stehen, sonst scheitert Punkt 09.

Baustein	Anforderung
Meta-Developer-Zugang	developers.facebook.com, App-Typ Business
Claude Code	Account Pro (20 $/Mo) oder Max/Team/Enterprise. Free reicht NICHT
Ad-Spend-Realismus	Setup lohnt ab 3.000 bis 5.000 $/Monat, darunter bist du manuell schneller

Phase 1: Wie richte ich Meta-Seite und Token ein?

Acht Punkte. Reihenfolge einhalten, der Token hängt an System User und Assets.

1.Meta-Developer-App erstellen. Create App, Use Case: Other, Type: Business. Privacy-Policy-URL ist Pflicht.
2.Marketing API als Product hinzufügen. App Dashboard, Add Product, Marketing API.
3.Business Verification entscheiden. Eigenes Konto: Development Access reicht (max. 5 Ad-Accounts). Kunden-Accounts: Standard Access beantragen, Verification dauert 1 bis 5 Werktage.
4.System User anlegen. Business Settings, Users, System Users, Add. Rolle Admin.
5.Assets dem System User zuweisen. App plus Ad-Account, beide mit Rolle Admin.
6.Token generieren. Permissions ads_read plus ads_management. Expiration Never oder 60 Tage.
7.Token verifizieren. Im Token-Debugger prüfen: Permissions, Expiration, App und Asset korrekt.
8.Ad-Account-ID notieren. Format act_1234567890 mit Prefix.

Phase 2: Wie baue ich das Code-Setup auf?

Hier entsteht das Projekt. Die genauen Datei-Inhalte (pull_ads.py, generate.py, .env, .gitignore und der CLAUDE.md-Projekt-Brief) liegen fertig im PDF.

1.Claude Code installieren. Danach claude --version und claude doctor zur Prüfung.
2.Projekt-Ordner plus venv. Eigenes Verzeichnis, virtuelles Environment, requests und python-dotenv installieren.
3..env mit Credentials. Access-Token, Ad-Account-ID, API-Version v25.0.
4..gitignore setzen. .env, *.json, __pycache__/, .venv/. Token NIEMALS committen.
5.CLAUDE.md schreiben. Rolle, Scoring-Logik, Output-Format, Compliance-Regeln. Verhindert halluzinierte Empfehlungen.
6.Scoring-Logik festlegen. Relativ zum Account-Median, nicht mit fixen CTR-Schwellen. Top 25 % = scale, Bottom 25 % = iterate.
7.pull_ads.py bauen. Aktive Ads plus 14-Tage-Insights. Pagination und Rate-Limit-Handling sind Pflicht.
8.generate.py bauen, IMMER mit Status PAUSED. Aktivierung manuell nach visueller Prüfung. Auto-Activate ist Account-Risiko.

Wie sieht der wöchentliche Workflow aus?

Acht Punkte, Human-Review in der Mitte fest verankert.

1.Daten pullen. pull_ads.py schreibt ad_performance.json.
2.Claude-Analyse starten. Claude liest die JSON, folgt der CLAUDE.md und schreibt analysis.md.
3.analysis.md im Human-Review prüfen. Top 3, Bottom 3, Account-Trends. Sind die Hypothesen plausibel? Statistische Basis da?
4.approved_briefs.json kuratieren. Nur die guten Vorschläge übernehmen. Pro Brief: Quell-Ad, Name, Headline, Body, CTA.
5.Compliance pre-flight. Health/Finance/Crypto-Claims? Personal Attributes? Garantiert-Versprechen? Vorher/Nachher ohne Disclaimer?
6.generate.py ausführen. Legt pro Brief Creative plus Ad als PAUSED an, protokolliert in generation_log.json.
7.Visual-Check im Ads Manager. Layout, Lesbarkeit, Image-Hash. Aktivierung erst nach OK.
8.Alte Underperformer manuell pausieren, nicht löschen. History für Vergleich behalten. Andromeda lebt von Creative-Diversity, nicht von Single-Ad-Politur.

Welche Compliance- und Health-Regeln muss ich fahren?

Diese sechs entscheiden, ob dein Konto langfristig lebt.

1.Token-Health monatlich prüfen. Debug-Token-Call, is_valid: true? Sonst neu generieren. 30 Sekunden pro Monat.
2.Rate-Limit-Strategie. Bei HTTP 429 warten in Stufen (60s, 120s, 180s), max. 3 Versuche. Insights in 50er-Batches splitten.
3.asset_feed_spec erkennen. Ist die Original-Ad Dynamic Creative (Advantage+), dann neue Variante im Ads Manager bauen. 1:1-Replikation klappt nicht.
4.Andromeda-Diversity-Audit. Pro Ad Set 15 bis 50 Creatives anstreben. Format-Mix: Static, Video Raw, Video Polished, Carousel.
5.NIEMALS automatisieren: Budget-Erhöhungen, Audience-Änderungen, Ad-Aktivierung, Top-Performer pausieren. Kein Auto-Push in regulierten Branchen.
6.ROI-Realismus. Bei 3 bis 5k $/Monat Spend zahlt sich das Setup in 2 bis 3 Monaten aus.

Das Prinzip in einem Satz

Claude Code liest und schlägt vor. Der Mensch entscheidet und aktiviert. Jede Ad startet PAUSED, jede Aktivierung ist eine bewusste Handentscheidung. Wer diese eine Regel bricht, produziert genau die 23-Ads-Nacht aus dem Blog.

Fertig einsetzbar: der komplette CLAUDE.md-Projekt-Brief, die Skript-Vorlagen und die 30 Punkte als Druck-Checkliste liegen im PDF. Klick oben auf Download.