Claude Code und die eroq-CLI: Assets aus dem Coding-Agenten

Coding-Agenten können auf einer Landingpage alles – außer dem Hero-Bild. Sie schreiben das <picture>-Tag, aber nicht das Bild. Medien-APIs liefern eine URL oder einen Base64-Blob, und was ein Agent eigentlich will, ist eine Datei unter einem Pfad, auf den er in der nächsten Änderung verweisen kann. Die eroq-CLI schließt diese Lücke: eroq mcp startet einen lokalen MCP-Server über stdio, dessen Tools Renders als Dateien in deinem Projekt speichern und den Pfad zurückgeben.

Das ist der Workflow, den wir selbst nutzen – mit den Befehlen, den Umgebungsvariablen und am Ende einer kompletten Session.

Installieren und anmelden

Das Paket liegt auf npm, braucht Node 18 oder neuer und hat keine einzige Abhängigkeit.

npm install -g @eroq/cli
eroq login          # paste a key from the developers dashboard
eroq account        # balance, plan, workspace

eroq login speichert den Schlüssel in ~/.config/eroq/config.json mit den Rechten 0600. Zwei Umgebungsvariablen überschreiben ihn – genau das, was du in CI oder in der Konfiguration eines Agenten willst:

• EROQ_API_KEY – der Schlüssel; hat Vorrang vor dem gespeicherten.
• EROQ_API_URL – die Basis-URL, Standard ist https://eroq.ai. Lass sie in Ruhe, außer du zeigst auf ein Staging-Deployment.

Die Befehle

Jeder Befehl gibt aus, was er gespeichert hat, plus eine Verbrauchszeile („Spent 100 credits · 887 remaining“).

eroq models                                     # models, credit prices, plan gates
eroq voices                                     # roster + your clones
eroq enhance "kettle on a counter" --kind image # free prompt rewrite
eroq image "…" -m eroq-image-one -o public/img/hero.webp
eroq video "…" -s 10 --aspect 9:16 --shot push-in -o public/video/teaser.mp4
eroq speech "…" -v orion --speed 0.95 -o public/audio/intro.mp3

Flags, die du kennen solltest: -m wählt das Modell (Bilder standardmäßig eroq-image-one, Video eroq-motion-one), -s ist die Cliplänge in Sekunden (dein Plan begrenzt sie, und das Raster der Engine rundet sie auf den nächsten gültigen Wert – siehe Video-Doku), --aspect nimmt 16:9, 9:16 oder 1:1, --shot ist eine der Kamerabewegungen, --ref übergibt eine Foto-URL (Bild-zu-Video bei Clips, ein zu haltendes Gesicht bei Standbildern), --negative ist der Negativ-Prompt und -o der Ausgabepfad. Ohne -o bekommst du ./eroq-image-<timestamp>.webp, ./eroq-video-<timestamp>.mp4 oder ./eroq-speech-<timestamp>.mp3.

Zwei Wege, eroq an Claude Code anzuschließen

Es gibt zwei Server, und sie unterscheiden sich in einem wichtigen Punkt.

Remote, über HTTP. Claude Code spricht direkt mit https://eroq.ai/mcp. Die Tools liefern URLs, und generate_video gibt eine Job-ID zurück, wenn der Render noch nicht fertig ist.

claude mcp add --transport http eroq https://eroq.ai/mcp \
  --header "Authorization: Bearer eroq_sk_YOUR_KEY"

Lokal, über stdio. Claude Code startet eroq mcp als Kindprozess. Die Tools speichern Dateien im Arbeitsverzeichnis und geben den Pfad zurück; generate_video wartet auf den Render (bis zu 8 Minuten), sodass der Agent ein MP4 bekommt und keine Quittung.

claude mcp add eroq --env EROQ_API_KEY=eroq_sk_YOUR_KEY -- npx -y @eroq/cli mcp

Für die Arbeit am Code nimm den lokalen. eroq install claude-code gibt beide Snippets aus, mit deinem gespeicherten Schlüssel schon eingesetzt. Die lokalen Tools sind generate_image, generate_video, generate_speech, enhance_prompt, list_models, list_voices, list_characters und get_account; die ersten drei akzeptieren einen out_path.

Cursor liest ~/.cursor/mcp.json (oder .cursor/mcp.json in einem Projekt):

{
  "mcpServers": {
    "eroq": {
      "url": "https://eroq.ai/mcp",
      "headers": { "Authorization": "Bearer eroq_sk_YOUR_KEY" }
    }
  }
}

Die Codex CLI liest ~/.codex/config.toml und startet den stdio-Server:

[mcp_servers.eroq]
command = "npx"
args = ["-y", "@eroq/cli", "mcp"]
env = { EROQ_API_KEY = "eroq_sk_YOUR_KEY" }

eroq install cursor und eroq install codex geben diese ebenfalls aus. Die vollständige Verbindungsmatrix steht in der MCP-Doku.

Eine realistische Session – Assets für eine Landingpage

Die Aufgabe: eine Landingpage für einen fiktiven Pour-over-Wasserkocher (Produktvideos sind der klassische Fall). Der Agent hat den lokalen Server, einen Ordner public/ und ein Budget von etwa 250 Credits. Hier das Protokoll, leicht gekürzt.

Agent: Checking the wallet before I spend anything.
       [get_account] → 1,000 credits, no plan (clips capped at 10 s)

Agent: Tightening the hero prompt first — it's free.
       [enhance_prompt kind=image prompt="black kettle, morning light, premium"]
       → "Close-up of a matte black pour-over kettle on a walnut counter, steam
          curling up into morning window light, shallow depth of field, soft cross
          lighting, a few coffee beans scattered out of focus, calm and premium,
          product photography, warm film palette."

Agent: [generate_image model=eroq-image-one out_path=public/img/hero.webp]
       → Image saved to public/img/hero.webp · Spent 10 credits · 990 remaining

Agent: Two feature tiles on the same look, then a vertical teaser.
       [generate_image … out_path=public/img/feature-pour.webp]   → 10 credits
       [generate_image … out_path=public/img/feature-temp.webp]   → 10 credits
       [generate_video model=eroq-motion-one seconds=10 aspect=9:16
        out_path=public/video/teaser.mp4
        prompt="Slow push-in on the same matte black kettle as steam rises and
        drifts toward the window, morning light warming from blue to gold, tiny
        dust motes in the beam, shallow focus holding on the spout, calm premium
        mood, 35mm film look."]
       → Clip saved to public/video/teaser.mp4 · Spent 60 credits · 910 remaining

Agent: A scratch voice-over for the hero, Orion, a touch slower.
       [generate_speech voice=orion speed=0.95 out_path=public/audio/intro.mp3
        text="Pour slower. Taste more. The kettle that waits for you."]
       → Speech saved to public/audio/intro.mp3 · Spent 3 credits · 907 remaining

Agent: Wiring them into index.html now.

Dann schreibt er das Markup – <img src="/img/hero.webp">, ein stummgeschaltetes Autoplay-<video> mit dem Teaser, ein <audio>-Element hinter einem Play-Button –, und die Seite ist echt. Insgesamt: 93 Credits, ungefähr zwei Dollar zum Preis des Einstiegspakets. Weniger Takes zu rendern als ein Mensch ist hier der eine Vorteil des Agenten; er verliebt sich nicht in die dritte Variante.

Zwei Gewohnheiten machen das zuverlässig. Bitte den Agenten, zuerst get_account aufzurufen, damit er die Längengrenze für Clips in deinem Plan und das Guthaben kennt, bevor er loslegt. Und übergib immer out_path – Standardnamen mit Zeitstempel im Projektstamm sind für einen schnellen Test okay und in einem Repository ein Chaos.

Leitplanken für einen Agenten, der Geld ausgeben kann

• Eigener Schlüssel. Leg einen für den Agenten an, mit eigenen Rate-Limits, und widerrufe ihn, wenn das Projekt endet.
• Raus aus Git. --env in Claude Code und die TOML-Datei in Codex liegen außerhalb des Repos; eine .cursor/mcp.json auf Projektebene mit einem Schlüssel darin gehört in die .gitignore.
• Fehlschläge sind kostenlos. Ein fehlgeschlagener Render wird automatisch erstattet; ein Prompt außerhalb der Richtlinien liefert content_blocked und wird nie berechnet. Der Agent braucht keine Retry-Logik über „noch einmal versuchen, dann fragen“ hinaus.
• Modell-Sperren sind eindeutig. Premium-Video-Engines brauchen einen Plan; ein gesperrtes Modell antwortet mit 403 plan_required, bevor irgendetwas abgerechnet wird. eroq models zeigt, was dein Schlüssel nutzen kann.

Häufige Fragen

Brauche ich die CLI, wenn ich schon den Remote-MCP-Server nutze?

Nein. Der Remote-Server funktioniert mit jedem Client, der Header senden kann. Der stdio-Server der CLI ist für Agenten gedacht, die Dateien auf der Platte statt URLs wollen.

Welche Modelle kann die CLI nutzen?

Alles, was dein Plan freischaltet: drei Bildmodelle, die Video-Engines, die eroq models auflistet, beide Stimmmodelle und die Auswahl an Stimmen, dazu deine Klone und Charaktere.

Kann der Agent meine Charaktere nutzen?

Ja. list_characters liefert deine Besetzung; generate_speech mit char:<id> spricht mit der Stimme dieses Charakters, und --ref mit dem Foto eines Charakters hält das Gesicht über mehrere Bilder hinweg oder steuert Bild-zu-Video.

Bereit? Hol dir einen API-Schlüssel, führ eroq login aus und lass den Agenten den langweiligen Teil erledigen.