Tutorials/Codex/Lektion 1
Lektion 1 von 4

Codex in der Cloud + GitHub

Tasks delegieren, Pull Requests bauen, parallele Cloud-Environments nutzen

Digitales Pausenbrot · 22. Mai 2026

Tasks delegieren, Pull Requests bauen, parallele Cloud-Environments nutzen

1 Codex Cloud verstehen

«Codex Cloud» ist die Web-Variante auf chatgpt.com/codex. Sie hat drei Kernkonzepte, die du kennen solltest:

  • Tasks — eine konkrete Arbeitsanweisung, die Codex in einer Cloud-Umgebung abarbeitet (z. B. «Schreibe Tests für die Datei foo.py»). Du kannst mehrere Tasks parallel starten.
  • Environments — Konfigurationen pro Repository: welches Repo, welche Setup-Schritte, welche Tools (Python? Node?), welche Internet-Zugriffe. Du legst sie einmal an, Codex nutzt sie für alle Tasks im Repo.
  • Worktrees — parallele lokale Entwicklungs-Verzweigungen. Codex kann mehrere Branches gleichzeitig bearbeiten, ohne dass du manuell wechselst.

Für eine Lehrperson, die ein Lehrmittel-Repo verwaltet, heisst das: Du kannst Codex bitten, gleichzeitig drei Differenzierungs-Niveaus zu generieren — alle drei laufen parallel in der Cloud.

Cloud-Tasks haben kein Zeitlimit im klassischen Sinn. Goal Mode kann Stunden oder Tage durchlaufen — du checkst zwischendurch vorbei.
2 GitHub-Integration einrichten

Codex spielt am stärksten mit GitHub zusammen. So verbindest du es:

Schritt 1: GitHub-Konto verknüpfen

In chatgpt.com/codex auf Settings → Connect GitHub. Folge dem OAuth-Flow, gib Codex Zugriff auf die gewünschten Repos (du kannst einzelne Repos oder eine ganze Organisation freigeben).

Schritt 2: Environment für ein Repo definieren

Wähle ein Repo, klicke «New Environment». Codex fragt dich nach:

  • Setup-Befehle (z. B. npm install oder pip install -r requirements.txt)
  • Internet-Zugriff erlauben? (für Recherche-Tasks ja, für reine Code-Reviews nein)
  • Welcher Branch ist Default?

Schritt 3: @codex in GitHub-Issues

Schreibst du in einem GitHub-Issue oder Pull-Request @codex, springt Codex direkt darauf an und übernimmt die Aufgabe. Das funktioniert, ohne dass du Codex Web öffnen musst.

Für Schul-Repos empfiehlt sich ein separater GitHub-Account ohne Schüler:innen-Daten. Codex sieht alles, was du ihm freigibst.
3 Erster Cloud-Task: Pull Request

Wir lassen Codex einen kompletten Pull Request bauen:

Schritt 1: Task formulieren

In Codex Web → Repo wählen → Task starten:

Erstelle eine neue Datei arbeitsblaetter/bruchrechnen-niveau-3.md. Inhalt: 12 Aufgaben Bruchrechnen mit Lösungsweg, Niveau 9. Klasse, Schwerpunkt gemischte Zahlen. Öffne danach einen Pull Request gegen den main-Branch.

Schritt 2: Codex arbeitet

Du siehst live, wie Codex die Datei erstellt, lokal testet (öffnet sie kurz, prüft Markdown-Syntax), und dann den Branch pusht.

Schritt 3: PR reviewen

Codex liefert einen GitHub-Link. Du öffnest den PR, siehst den Diff, kannst Kommentare schreiben («Bitte 3 leichtere Aufgaben am Anfang ergänzen»). Codex iteriert auf dem gleichen PR weiter.

So wird Codex zur asynchronen Hilfskraft: du gibst Aufträge, gehst unterrichten, schaust am Abend auf die PRs.

Codex schreibt Commit-Messages auf Englisch. Wenn du Deutsch willst: bitte explizit darum oder ändere die Globalanweisung im Environment.
4 Praxis: Differenziertes Lehrmittel parallelisieren

Eine realistische Anwendung im Schulkontext:

Setup

Du hast ein GitHub-Repo fotosynthese-lehrmittel mit einer Basisversion in standard.md. Jetzt brauchst du drei Niveaus.

Drei Tasks parallel starten

  1. Task A: «Erstelle niveau-leicht.md als vereinfachte Version von standard.md. Kürzere Sätze, weniger Fachbegriffe.»
  2. Task B: «Erstelle niveau-erweitert.md mit Vertiefungsfragen und Experiment-Anleitung.»
  3. Task C: «Erstelle quiz.md mit 15 Multiple-Choice-Fragen zu standard.md, inkl. Lösungen.»

Alle drei laufen gleichzeitig in eigenen Cloud-Environments. Du siehst drei Fortschrittsbalken nebeneinander. Nach 5–10 Minuten sind alle drei Pull Requests offen.

Mergen

Im GitHub-UI klickst du «Merge» pro PR, oder lässt Codex die drei PRs in einen Sammel-PR konsolidieren.

Parallele Tasks lohnen sich, sobald die Aufgaben unabhängig sind. Aufeinander aufbauende Schritte sequenziell halten.

Quiz

1. Was ist ein «Environment» in Codex Cloud?

  1. Der dunkle/helle Modus der Web-Oberfläche.
  2. Eine Konfiguration pro Repository: Setup-Befehle, Tools, Internet-Zugriff, Default-Branch.
  3. Ein Synonym für ChatGPT-Plan (Free/Plus/Pro).
  4. Eine virtuelle Maschine, die du selbst aufsetzen musst.
Lösung anzeigen

Richtige Antwort: b) — Environments sind Repository-Konfigurationen: welche Setup-Schritte laufen vor jedem Task, welche Tools sind installiert, welche Internet-Zugriffe sind erlaubt. Du legst sie einmal an und Codex nutzt sie für alle Tasks im Repo.

2. Wie startest du einen Codex-Task direkt aus einem GitHub-Issue?

  1. Du musst das Issue exportieren und in Codex Web hochladen.
  2. Du schreibst <code>@codex</code> in einem Kommentar — Codex übernimmt automatisch.
  3. Du musst eine spezielle Codex-CLI auf GitHub Actions konfigurieren.
  4. Das geht nicht — Codex arbeitet nur über die Web-Oberfläche.
Lösung anzeigen

Richtige Antwort: b) — Nach der GitHub-Verknüpfung reagiert Codex auf @codex-Mentions in Issues und Pull Requests. Du musst Codex Web nicht öffnen — die ganze Interaktion läuft in GitHub.

3. Wann lohnen sich parallele Cloud-Tasks?

  1. Immer — mehr parallel ist immer besser.
  2. Wenn die Aufgaben voneinander unabhängig sind (z.&nbsp;B. drei Differenzierungs-Niveaus).
  3. Nur in der Pro-Variante.
  4. Nur, wenn die Aufgaben aufeinander aufbauen.
Lösung anzeigen

Richtige Antwort: b) — Parallele Tasks sind ideal für unabhängige Arbeitspakete — z.&nbsp;B. drei Niveaus eines Lehrmittels. Bei aufeinander aufbauenden Schritten bleibt sequenziell sinnvoller, sonst überschreiben sich die Branches.