Webseiten & Web-Apps bauen mit Codex in deiner IDE
Von der ersten Datei bis in die Produktion — mit einem KI-Agenten, der direkt in deinem Editor mitarbeitet. In 8 Stufen, an einem durchgehenden Praxis-Beispiel.
Worum geht's?
Du lernst, wie du mit Codex direkt im integrierten Terminal deiner IDE (VS Code, Cursor, Antigravity) echte Dinge baust: Webseiten, kleine Web-Apps, Automatisierungen — und wie du das in einer Firma sinnvoll und sicher einsetzt. Der rote Faden: sichtbarer Quick-Win → Zeit sparen → echter Code (Brownfield) → bis ins Deployment.
Dieses Portal ist beides: Live-Präsentation für den Workshop und Selbstlern-Kurs zum Durchklicken. Dein Fortschritt wird lokal gespeichert.
? Warum Codex — zusätzlich zur eingebauten KI deiner IDE?
Deine IDE hat meist schon KI (Code-Vervollständigung, Chat — z. B. Copilot in VS Code, der Cursor-Chat oder Gemini in Antigravity). Codex ist etwas anderes: ein Agent, der eigenständig mehrere Dateien liest, ändert, Befehle ausführt und Schritt für Schritt arbeitet.
- Vervollständigt die aktuelle Zeile / Datei
- Beantwortet Fragen im Chat
- Du führst Befehle selbst aus
- Kontext meist auf das offene File begrenzt
- Plant Aufgaben & arbeitet über viele Dateien
- Liest/schreibt Dateien, führt Tests & Befehle aus
- Fragt bei heiklen Aktionen um Freigabe
- Versteht das ganze Projekt (inkl.
AGENTS.md)
🧠 Mentales Modell: ein Agent in deinem Terminal
Codex macht keine Magie. Es ist ein wiederkehrender Kreislauf — und du bleibst an der Kontrolle.
… und dann wieder von vorn. Du gibst die Richtung vor und bestätigst — Codex übernimmt die Fleißarbeit.
🏭 Unser Beispiel: die „Nordwerk GmbH"
Damit alles zusammenhängt, digitalisieren wir über alle Stufen hinweg eine fiktive kleine Firma.
🗺️ Die 8 Stufen
Setup & Orientierung
Codex im integrierten Terminal deiner IDE installieren, einloggen und das erste Mal etwas bauen.
1 Installieren & starten
Codex läuft im integrierten Terminal deiner IDE — ob VS Code, Cursor oder Antigravity. Einmal installieren, dann mit einem Befehl starten.
- In deiner IDE das Terminal öffnen (
Strg/Cmd + öbzw. View → Terminal). - Codex installieren: empfohlen ist der offizielle Installer aus der Codex-CLI-Doku. Alternativen wie npm oder Homebrew sind dort ebenfalls aufgeführt.
codexeingeben und mit deinem ChatGPT-Konto oder einem API-Key anmelden.- Mit
/statusprüfen, in welchem Ordner, mit welchem Modell und mit welchen Freigaben Codex läuft.
2 Die IDE-Oberfläche verstehen
Vier Bereiche, die du kennen solltest. Die Skizze zeigt das Layout schematisch (VS Code, Cursor & Antigravity sind hier nahezu gleich) — die Nummern erklärt die Legende darunter.
- 1 Datei-Explorer — dein Projektbaum. Codex sieht genau diese Dateien.
- 2 Editor — hier siehst du Änderungen sofort, kannst selbst eingreifen.
- 3 Terminal mit Codex — dein Prompt-Eingabefeld an den Agenten.
- 4 Diff/Änderungen — was Codex geändert hat, prüfst du hier (Quellcode-Verwaltung).
3 Erstes Prompt → erste Datei
Sag in einfachen Worten, was du willst. Codex legt die Datei an — nach deiner Freigabe.
Lege eine Datei hallo.html an mit einer zentrierten Überschrift „Hallo Nordwerk" und einem Lime-Hintergrund.
Ich erstelle hallo.html mit einem einfachen, zentrierten Layout. Darf ich die Datei anlegen?
→ [Freigabe erteilt] → Datei erstellt. Öffne sie im Browser, um sie zu sehen.
✓ Geschafft, wenn du …
Grundlagen des Arbeitens
Wie du gut promptest, Kontext gibst, wie Codex plant und wie du über Approval-Modi die Kontrolle behältst.
1 Gut prompten
Je klarer Ziel, Kontext und gewünschtes Ergebnis, desto besser. Vage Prompts kosten Runden.
- „Mach die Seite schöner."
- „Bau mir ein Tool."
- „Fix den Bug."
- „Mach die Hero-Sektion responsive, max. Breite 1100px, mehr Abstand."
- „Bau ein Dashboard mit 3 Kennzahl-Karten aus
daten.json." - „Der Filter zeigt 0 Treffer bei Großbuchstaben — vergleiche case-insensitive."
2 Dateien & Kontext referenzieren
Zeig Codex, worum es geht — statt es raten zu lassen.
@dateiname hängst du konkrete Dateien an dein Prompt. „Richte dich nach @styles.css" liefert viel bessere Ergebnisse als eine allgemeine Bitte.3 Erst der Plan, dann die Änderung
Bei größeren Aufgaben legt Codex zuerst einen Plan an — eine Schritt-für-Schritt-Liste, die du live mitverfolgst — und arbeitet ihn dann ab. So bleibt nachvollziehbar, was als Nächstes passiert.
index.html lesenstyles.css ergänzenSo sieht das im Terminal aus:
4 Approval-Modi & Sandbox
Du bestimmst, wie eigenständig Codex arbeiten darf — und es läuft standardmäßig in einer Sandbox.
unless-trusted: maximale Aufsicht, fragt fast immer nach.on-request: guter Standard, fragt bei Aktionen außerhalb der Sandbox.on-failure: versucht erst die Sandbox, fragt nach, wenn es scheitert.never: keine Rückfragen — nur in kontrollierten Umgebungen.
read-only: Codex darf lesen, aber nichts ändern.workspace-write: Änderungen im Projektordner sind möglich.danger-full-access: volle Freiheit — nur isoliert einsetzen.- Netzwerkzugriff und sensible Befehle können separat Freigaben brauchen.
/status siehst du beides jederzeit.✓ Geschafft, wenn du …
Erste Webseite
Eine echte Landingpage von Null — responsive, live geändert. Der sichtbare Quick-Win.
1 Von Null zur Landingpage
Ein Prompt mit klarem Ziel reicht für ein erstes, vorzeigbares Ergebnis.
Bau eine einseitige Landingpage für die „Nordwerk GmbH" (Metallbau): Hero mit Slogan, 3 Leistungs-Karten, Kontakt-Abschnitt. Modern, dunkel, responsive. Nur HTML/CSS, keine Frameworks.
Ich lege index.html und styles.css an, mit Hero, Karten-Grid und Kontaktbereich. Danach kannst du im Browser draufschauen.
2 Ansehen & nachschärfen (Vorher / Nachher)
Iterieren ist der Normalfall: erste Version ansehen, gezielt verbessern.
Mehr Abstand im Hero, die Karten sollen beim Hover leicht anheben, und die Akzentfarbe auf Lime (#bce941).
So fühlt sich Iterieren an — ein Klick verwandelt v1 in die finale Version:
3 Responsive prüfen
„Sieht das auf dem Handy gut aus?" ist ein gültiges Prompt.
✓ Geschafft, wenn du …
Interaktivität & Web-App
Ein kleines internes Dashboard mit echtem Verhalten — und wie Codex beim Debugging hilft.
1 Internes Dashboard bauen
Aus statisch wird interaktiv: Daten anzeigen, filtern, reagieren.
Bau ein internes Dashboard: lies auftraege.json, zeige Kennzahl-Karten (offen/erledigt/Umsatz) und eine filterbare Tabelle. Vanilla JS.
Ich erstelle dashboard.html + app.js: Karten rechnen die Summen, das Suchfeld filtert die Tabelle live.
2 Debugging: Bug → Fix
Bugs gehören dazu. Beschreibe das Symptom — Codex findet und erklärt die Ursache. Klick „Fix anwenden".
Symptom: Der Filter findet „Schmidt" nicht, wenn man „schmidt" tippt.
includes vergleicht Groß-/Kleinschreibung. „schmidt" ≠ „Schmidt"..toLowerCase() vergleichen — jetzt case-insensitive.Im Terminal läuft das so ab:
✓ Geschafft, wenn du …
Codex methodisch nutzen
Die Features, die aus „nettem Helfer" einen verlässlichen, wiederholbaren Arbeitspartner machen.
1 Die Werkzeuge im Überblick
codex exec/review2 AGENTS.md anlegen
Die AGENTS.md im Projekt-Wurzelverzeichnis ist das Gedächtnis deines Projekts: Konventionen, Befehle, „nicht anfassen"-Zonen. Codex liest sie automatisch — du kannst sie von Codex erstellen lassen.
› /init ● analysiert Repo-Struktur, Befehle und Konventionen › Ergänze in AGENTS.md: Build-/Test-Befehle, Code-Stil, Review-Regeln und Do-not-touch-Zonen. ● erstellt AGENTS.md ✓
3 Automatisieren mit codex exec
Wiederkehrende Aufgaben musst du nicht jedes Mal von Hand starten. codex exec lässt Codex nicht-interaktiv laufen — perfekt für Skripte, Cron-Jobs oder CI-Pipelines.
codex exec-Aufrufe in ein npm-Skript oder einen nächtlichen Cron-Job packen — die Monatsreports entstehen dann automatisch. Standardmäßig ist codex exec eher vorsichtig; für Dateien brauchst du bewusst --sandbox workspace-write.4 Konfiguration, Profile & MCP
In ~/.codex/config.toml legst du einmal fest, wie Codex sich verhält — und bindest externe Tools über MCP an. Für einzelne vertrauenswürdige Projekte kann Konfiguration auch in .codex/config.toml liegen.
# Standard-Verhalten approval_policy = "on-request" # bei heiklen Aktionen nachfragen sandbox_mode = "workspace-write" # MCP-Server: lokale Doku als Datenquelle [mcp_servers.docs] command = "npx" args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
codex mcp add … hinzufügen und im TUI mit /mcp prüfen.✓ Geschafft, wenn du …
Produktiv im Alltag
Refactoring, Tests, Git, MCP und eine Automatisierung, die über die Web-Welt hinausgeht.
1 Refactoring & Code erklären
Erklär mir, was app.js macht, und schlage 3 Verbesserungen vor — ohne Verhalten zu ändern.
Überblick + 3 konkrete Refactorings (Funktionen trennen, Namen klären, Duplikate entfernen). Soll ich sie umsetzen?
2 Tests
„Schreib Tests dafür" ist ein hervorragendes Prompt — Tests sichern künftige Änderungen ab.
Schreib die kleinsten sinnvollen Tests für den Filter und führe sie aus. Wenn etwas fehlschlägt, erkläre zuerst die Ursache, bevor du den Code änderst.
Ich ergänze gezielte Tests, starte den Testbefehl aus AGENTS.md und fasse Ergebnis + nächste Schritte zusammen.
3 Git — kurz, aber wichtig
/review, um uncommitted changes oder einen Commit gegen eure Review-Regeln prüfen zu lassen. Das ersetzt kein eigenes Lesen, ist aber ein gutes zweites Paar Augen.4 MCP / Connectors
Über MCP verbindet sich Codex mit externen Werkzeugen & Datenquellen (z. B. Ticket-System, Datenbank, Doku).
5 Automatisierungs-Skript (CSV → Report)
Der Nutzen über Webseiten hinaus: wiederkehrende Büroarbeit automatisieren.
Schreib ein Skript, das auftraege.csv einliest und einen Monatsreport (Summen pro Kunde, als HTML) erzeugt.
✓ Geschafft, wenn du …
Echte Projekte & Deployment
Bestehenden Code verstehen und ändern (Brownfield) — und das Ergebnis live bringen.
1 Brownfield verstehen
Der Firmenalltag ist selten „grüne Wiese". Codex hilft, fremden Code schnell zu erfassen.
Verschaff dir einen Überblick über dieses Projekt und erkläre mir die Architektur in 5 Sätzen. Wo würde ich eine neue Funktion „Angebots-PDF" einhängen?
AGENTS.md anlegen lassen, dann gezielt fragen — so arbeitet Codex von Anfang an mit dem richtigen Kontext.2 Große Aufgaben zerlegen
- Ziel klären & zuerst planen lassen.
- In kleine, prüfbare Schritte aufteilen.
- Schritt umsetzen → ansehen → nächster Schritt.
- Nach jedem sinnvollen Schritt committen (Git).
3 Statisch deployen — zuerst der einfache Weg
Eine statische Seite live zu bringen ist erstaunlich einfach.
4 Docker als Kür
Für reproduzierbares Deployment auf dem eigenen Server: ein Container.
FROM caddy:alpine COPY ./dist /usr/share/caddy
Build & Deployment im Terminal:
✓ Geschafft, wenn du …
Best Practices, Grenzen & Sicherheit
Damit Codex im Firmenalltag ein Gewinn bleibt — und kein Risiko.
1 Was Codex (nicht) gut kann
- Boilerplate, Refactoring, Tests
- fremden Code erklären
- wiederkehrende Aufgaben
- Vorschläge & Varianten
- fachlichen Entscheidungen ohne Kontext
- brandneuen/seltenen APIs
- „einfach alles" ohne Review
- sicherheitskritischen Details
2 Review-Pflicht & Halluzinationen
3 Prompt-Injection / nicht vertrauenswürdige Inhalte
4 Secrets & .gitignore
.env, und .env in .gitignore. Falls doch passiert: Secret widerrufen — Details (auch „aus der Historie entfernen") in der Git-Schulung.5 Sicherheitsnetz: Sandbox + Git
6 Kontext & Kosten
AGENTS.md pflegen. Das spart Geld und macht die Ergebnisse besser.✓ Geschafft, wenn du …
Cheat-Sheet
Zum Mitnehmen: gute Prompts, nützliche Befehle, Automatisierungs-Ideen. (Zählt nicht für den Fortschritt.)
★ Prompt-Muster, die funktionieren
- Ziel + Kontext + Format: „Bau X, richte dich nach
@datei, nur HTML/CSS." - Symptom statt Lösung: „Bei Großbuchstaben 0 Treffer" — Ursache findet Codex.
- Erst Plan: „Mach erst einen Plan, bevor du etwas änderst."
- Verifizieren: „Führe die Tests aus und zeig mir das Ergebnis."
⌨ Nützliche Befehle & Slash-Kommandos
codexcodex exec "…"/permissions/model/status/review🧩 Automatisierungs-Ideen für die Firma
- Report-Generator (CSV/Excel → formatierter Bericht, per
codex exec) - Onboarding-Helfer (Projekt erklären, Setup-Schritte) — via AGENTS.md
- Review-Checkliste (Stil, Sicherheit, Tests) vor jedem Commit
- Doku-Schreiber (Code → README/Spec) als nächtlicher Job
Quiz
10 Fragen quer durch die Stufen. Ab 8 richtigen Antworten schaltest du dein Zertifikat frei.
Dein Zertifikat
Glückwunsch! Trage deinen Namen ein und drucke das Zertifikat (oder speichere als PDF).