muend/codex-image

Bildgenerierung durch Codex

Claude schreibt die Art Direction; gpt-6.1-sol führt sie buchstabengetreu mit seinem integrierten Bildwerkzeug aus. Das Briefing ist die gesamte Qualitätsgrenze: Sol wird fehlende Details nicht gut erfinden und keine "Entscheidungsfindung" bei offenen Fragen anwenden. Entscheide alles zuerst, dann schreibe es auf.

Engine und Rollenprofile

Bilder stammen aus Codex' integriertem image_gen-Tool beim ChatGPT Pro-Login – keine API, keine Kosten pro Bild. Dieses Tool akzeptiert nur einen Prompt, Referenzbilder und transparent_background; der Server wählt das Bildmodell, daher können spezifische Modelle (GPT Image 2.6 Sunburst / Flare usw.) hier nicht ausgewählt werden. Wechsle niemals zu einem API-Key oder Codex' Bild-CLI-Fallback.

Die rollenspezifische Steuerung erfolgt über Profile in ~/.claude/skills/codex/image-profiles.json, übergeben mit -ImageProfile <Name>. Ein Profil fügt dem Brief Notizen zum Rollenstil hinzu und kann Transparenz erzwingen:

Profil	Verwendung	Notizen
default	alles andere	nur Brief
photoreal	Produktaufnahmen, Hero-Banner, Redaktionsfotos	fotorealistische Regeln
illustration	Marketing-/Blog-/Onboarding-Grafiken	kohärente Illustrationsregeln
icon	App-/UI-Symbole, Marken, Sticker, Sprites	transparent, Padding, 32px Lesbarkeit
ui-asset	Mockups, Dashboard-Visualisierungen, Leerzustände	klare Geometrie, keine falschen Mikrotexte
text-heavy	Poster, Cover, Infografiken	zuerst exakte Typografie

-Transparent funktioniert mit jedem Profil. Füge neue Rollen hinzu, indem du einen Eintrag (transparent, roles, style_notes) zur JSON hinzufügst. Der Brief bleibt der Hauptqualitätshebel: Profile ergänzen, ersetzen nie.

Arbeitsablauf

1. Klärung nur dessen, was dich wirklich blockiert (Zweck, Verwendungsort, Größe/Seitenverhältnis, Text auf Bild, Markenfarben). Ansonsten nimm sinnvolle Standardwerte und halte sie im Brief fest.
2. Schreibe den Brief in eine Datei im Scratchpad (z. B. brief-hero.md) mit der Vorlage unten. Fülle jeden Abschnitt aus; schreibe "keine" statt einen Abschnitt wegzulassen.
3. Führe aus:

   pwsh -NoProfile -File "$HOME\.claude\skills\codex\scripts\codex.ps1" -Mode image `
     -PromptFile <brief.md> -Out <projekt>\assets\<name>.png [-ImageProfile icon] [-Transparent] `
     [-Count 3] [-Images ref1.png,ref2.png]
   

   Verwende timeout: 600000. Mehrere verschiedene Bilder → ein Hintergrundlauf pro Bild (eine Flotte).
4. Überprüfe selbst: Lies jede CODEX_IMAGE=-Datei und prüfe sie gegen die Akzeptanz-Checkliste. Codex' Selbstprüfung ist eine Behauptung, kein Beweis.
5. Iteriere mit -Session <CODEX_THREAD_ID> und einem kurzen Delta-Brief ("Alles behalten; nur ändern: ...") oder führe eine gezielte Bearbeitung durch, indem du die vorherige Ausgabe mit -Images und einem Bearbeitungsbrief übergibst.
6. Liefere aus: Zeige dem Benutzer das Bild (Read / SendUserFile), gib den Pfad an und erwähne, dass die Thread-ID für weitere Iterationen verfügbar ist.

Brief-Vorlage (kopieren, jedes Feld ausfüllen)

# Zweck & Verwendung
<wofür dieses Bild ist, wo es erscheint (Hero-Banner, App-Symbol, Folie, Druck), Zielgruppe>

# Ausgabe
- Seitenverhältnis / Größe: <z. B. 16:9 Querformat, 1:1 Quadrat, 9:16 Hochformat; Ziel-Px falls bekannt>
- Format/Hintergrund: <opak | transparenter Hintergrund | einfarbig #FFFFFF>
- Varianten: <1 | N, und wie sich die Varianten unterscheiden sollen>

# Motiv
<Hauptmotiv(e) in konkreten Begriffen: wer/was, Anzahl, Pose, Ausdruck, Aktion, Kleidung/Material,
Alter/Ethnie nur, wenn relevant und vom Benutzer angegeben>

# Komposition & Kamera
- Bildausschnitt: <Nahaufnahme | Halbtotale | Totale | Draufsicht | isometrisch | flach orthogonal>
- Platzierung: <Motivposition (Goldener Schnitt, zentriert), negativer Raum für Text auf welcher Seite>
- Kamera/Objektiv (Fotostile): <z. B. 50mm, f/2.8 geringe Schärfentiefe, Augenhöhe>
- Vordergrund / Mittelgrund / Hintergrund: <jeweils beschrieben>

# Stil
- Medium: <fotorealistisch | 3D-Render | flacher Vektor | Strichzeichnung | Aquarell | Pixel-Art | Ton | isometrisch ...>
- Referenzen in Worten: <Epoche, Bewegung, Textur, Strichstärke, Detailgrad> (keine Namen lebender Künstler)
- Detailgrad der Darstellung: <minimale Formen | moderat | sehr detailreich>

# Farbe & Licht
- Palette: <Hex-Codes mit Rollen, z. B. Primär #1E6FFF, Akzent #FFC233, Hintergrund #F5F5F7>
- Beleuchtung: <weiches Tageslicht von links | Studio-Dreipunkt | goldene Stunde | Neon-Randlicht>
- Stimmung: <ruhig, energiegeladen, exklusiv, verspielt ...>

# Text im Bild
<"keine" ODER jeder String wörtlich in Anführungszeichen, mit Schriftgefühl (fettgeometrische Sans), Farbe, Position, Größe relativ zum Bild. Halte Strings kurz; exakte Schreibweise und Groß-/Kleinschreibung zählen.>

# Muss enthalten
- <nicht verhandelbare Elemente>

# Darf NICHT enthalten
- <Wasserzeichen, zusätzlicher Text, zusätzliche Finger, Logos echter Marken, Unordnung, bestimmte Farben ...>

# Bearbeitungsanweisungen (nur beim Bearbeiten eines angehängten Bildes)
- Bild 1 ist: <das zu bearbeitende Bild | eine Stilreferenz | eine Motivreferenz>
- Ändern: <genau das>
- Beibehalten: <alles andere, das identisch bleiben muss: Layout, Gesichter, Farben, Text>

# Akzeptanz-Checkliste
- [ ] <objektive Prüfungen, die Claude verifizieren wird: Seitenverhältnis, Motiv vorhanden, Text exakt, Palette, kein X>

Gestaltungstipps für starke Ergebnisse

• Konkrete Substantive und messbare Attribute schlagen Adjektive ("drei Keramiktassen, mattes Salbeigrün #9CAF88, auf einem Nusstisch" ≫ "schöne gemütliche Tassen").
• Ein klarer Fokuspunkt; gib an, wohin der leere Raum geht, wenn später Text überlagert wird.
• Für Icons/Logos: flach, wenige Farben, zentriert, großzügiges Padding, kein Text außer gewünscht, in kleiner Größe testen.
• Für UI-/Marketing-Assets: gib den exakten Text an und halte Text im Bild minimal – echter UI-Text wird besser im Code hinzugefügt.
• Für Serien/Sets (Sprites, Icon-Pakete, Storyboard): schreibe einen gemeinsamen "Style-Bibel"-Abschnitt und verwende ihn wörtlich im Brief jeder Spur, damit das Set konsistent bleibt; generiere zuerst ein Heldbild, genehmige es, übergib es dann mit -Images als Stilreferenz für den Rest.
• Fordere keine Abbilder realer Personen, urheberrechtlich geschützte Charaktere oder echte Markenlogos an.