eroq-Plugin für Claude Code: Server, Login und Skill mit Preisen

Es gibt inzwischen drei Wege, Claude Code die eroq-Tools zu geben, und sie sind nicht dasselbe. Der Einzeiler claude mcp add gibt ihm die Tools. Das Plugin gibt ihm die Tools und einen Skill – ein kurzes Dokument, das Claude Code erklärt, wie eroq abrechnet, welches Modell es wählen soll und wie es auf ein Video wartet, ohne dass man es ihm sagen muss. Die CLI gibt ihm einen lokalen Server, der Dateien schreibt. In diesem Leitfaden geht es um das Plugin: Installation, was der Skill sagt und wann du was wählst.

Installation

Plugins für Claude Code kommen aus Marketplaces, und eroq stellt seinen eigenen auf eroq.ai bereit – ganz ohne Git-Repository:

/plugin marketplace add https://eroq.ai/claude-code/marketplace.json
/plugin install eroq@eroq

Dann /mcp, eroq auswählen und Authenticate wählen. eroq öffnet sich im Browser; melde dich an und klick auf Allow (Erlauben). Claude Code bekommt einen eigenen Schlüssel, „Claude Code (connected)“, unter Entwickler → API-Schlüssel – widerruf ihn dort, um die Verbindung zu trennen.

Der Marketplace-Eintrag ist ein per SHA-256 fixiertes Archiv – installiert wird also genau das, was wir veröffentlicht haben. Ohne Plugin bekommst du nur den Server so:

claude mcp add --transport http eroq https://eroq.ai/mcp

(mit --scope user hast du ihn in jedem Projekt), danach dasselbe /mcp → Authenticate. Lieber einen Schlüssel im Header? --header "Authorization: Bearer eroq_sk_…" funktioniert auch.

Was der Skill beibringt

Ein Skill ist eine Markdown-Datei, die Claude Code liest, wenn die Aufgabe zu ihrer Beschreibung passt. Der eroq-Skill springt an, wenn du nach einem Bild, einem Clip, einer Sprachzeile oder visuellen Assets für das Projekt fragst, und sagt kurz gefasst:

• Preise nicht raten. Ruf list_models einmal pro Sitzung auf, wenn der Nutzer kein Modell genannt hat; es liefert jedes Modell mit Preis und der Angabe, ob der Plan es freischaltet. Ruf get_account für das Guthaben auf, und sag Bescheid, statt zu rendern, wenn eine Generierung es klar übersteigen würde.
• Grobe Briefings verbessern. enhance_prompt ist kostenlos; nutz es bei einer vagen Anfrage und zeig dem Nutzer den Prompt, wenn er die Absicht verändert.
• Bilder: generate_image wartet und liefert das Bild plus einen signierten Link, der dreißig Minuten gültig ist; aspect aus den fünf Seitenverhältnissen zum selben Preis; sofort mit curl -L -o <path> "<url>" ins Projekt speichern, weil der Link abläuft. Eine Job-ID bei langsamem Start heißt: get_image_status abfragen.
• Video: asynchron. generate_video wartet bis zu etwa 45 Sekunden und gibt dann eine Job-ID zurück; frag get_video_status etwa alle zehn Sekunden ab; Renders dauern eine bis fünf Minuten. Nenn die Engine mit model, wenn der Look zählt; seconds ist durch den Plan begrenzt und wird auf das Raster der Engine gerundet; reference_image_url ist der erste Frame bei Engines mit Bild-zu-Video.
• Sprache: generate_speech liefert MP3; wähl eine Stimme aus list_voices oder char:<id> aus list_characters, um als einer der Charaktere des Nutzers zu sprechen.
• Prompts: ein fließender Absatz – Motiv, Handlung, Schauplatz, Licht, Objektiv oder Kamerabewegung, Stimmung; konkrete Substantive statt Adjektive; bei Video die Bewegung und die Kamera beschreiben.
• Richtlinie: niemals Inhalte mit Minderjährigen oder realen Personen ohne Einwilligung anfordern; die Ablehnungsmeldungen von eroq so weitergeben, wie sie kommen.

Nichts davon ist Magie. Es ist der Unterschied zwischen einem Agenten, der einen 20-Sekunden-Clip auf der teuersten Engine rendert, weil du „mach ein Video“ gesagt hast, und einem, der nach der Engine fragt, 45 Credits für fünf Sekunden mit der Standard-Engine nennt und so lange abfragt, bis die Datei existiert.

Eine Sitzung mit dem Plugin

Du: Die Onboarding-Screens brauchen Illustrationen – eine pro Schritt in steps.ts, 4:3, flacher Pastellstil, einheitlich.

Claude Code liest steps.ts (fünf Schritte), ruft list_models und get_account auf („1.240 Credits; fünf Bilder mit Krea 2 kosten 50“), lässt enhance_prompt einmal über den Stil laufen und verwendet die verbesserte Stilzeile für jeden Schritt, ruft generate_image fünfmal mit aspect: "4:3" auf, speichert jedes Bild mit curl unter public/onboarding/step-N.webp und trägt die Pfade in steps.ts ein. „50 Credits ausgegeben, 1.190 übrig.“

Ohne den Skill bekommt dieselbe Anfrage meist fünf getrennt geratene Stile und keine Budgetzeile.

Plugin, Befehl oder CLI

	claude mcp add	Plugin	CLI (eroq mcp)
Tools	Remote-Server	Remote-Server	Lokaler Server
Anmeldung	OAuth über /mcp	OAuth über /mcp	Schlüssel in env
Skill	Nein	Ja	Nein
Ausgabe	Links + Inline-Bilder	Links + Inline-Bilder	Dateien unter Pfaden
Ideal für	Ausprobieren	Täglichen Einsatz	Build-Schritte, CI

Plugin und Befehl nutzen denselben Server; das Plugin fügt den Skill hinzu und fixiert eine Version. Die CLI ist ein anderer, lokaler Server, der Dateien schreibt – kombinier sie mit dem Plugin, wenn du sowohl das Urteilsvermögen des Skills als auch Dateiausgabe willst, denn die Ratschläge des Skills gelten für beide.

Aktualisieren

Der Marketplace-Eintrag trägt eine Version; führ /plugin update eroq@eroq aus, wenn wir eine neue veröffentlichen (der Skill ändert sich mit den Modellen und Preisen). Wenn du das Plugin forkst, prüfst du eine lokale Kopie mit claude plugin validate.

Häufige Fragen

Was bringt das Plugin gegenüber dem Einzeiler?

Denselben Server plus einen Skill, der Claude Code beibringt, wie Prompts, Preise und asynchrone Videos bei eroq funktionieren – so wählt es sinnvolle Modelle, nennt die Credits und fragt Clips ab, ohne dass man es ihm sagen muss.

Brauche ich einen API-Schlüssel?

Nein – /mcp → Authenticate startet die Anmeldung im Browser. Für geskriptete Setups funktioniert ein Schlüssel im Header weiterhin.

Kann es Renders in mein Repo speichern?

Der Remote-Server antwortet mit Links und Inline-Bildern; der Skill sagt Claude Code, sie per curl ins Projekt zu holen. Für direkte Dateiausgabe nimm den lokalen Server der CLI: npx -y @eroq/cli mcp.

Ist es sicher, den Marketplace hinzuzufügen?

Er wird von eroq.ai über HTTPS ausgeliefert, und das Plugin-Archiv ist in der Marketplace-Datei per SHA-256 fixiert – Claude Code prüft also, was es installiert.

Auf der Claude-Code-Seite findest du beide Befehle zum Kopieren.