Einige Freiburger Teams setzen statt auf Claude Code auf OpenAI Codex, oft weil sie ohnehin mit ChatGPT arbeiten oder parallele Cloud-Aufgaben schätzen. Beim Schritt in den Apple App Store zeigt sich eine Besonderheit: Der Cloud-Agent läuft auf Linux und kann keine iOS-Builds erzeugen. Dieser Leitfaden erklärt, wie Sie Codex, macOS-CI und fastlane so kombinieren, dass Ihre App zuverlässig bei TestFlight und im Store ankommt, und welche Regeln in Ihre AGENTS.md gehören.
Codex und iOS: wo der Agent arbeitet
OpenAI Codex gibt es in zwei Formen: als Codex CLI, die lokal in Ihrem Terminal läuft, und als Cloud-Agent, der Aufgaben in einer isolierten Umgebung abarbeitet und Ergebnisse als Diff oder Pull Request zurückliefert. Für iOS ist dieser Unterschied entscheidend. Die Cloud-Umgebungen von Codex basieren auf Linux-Containern, in denen weder Xcode noch der iOS-Simulator laufen. Dort kann der Agent Swift-, React-Native- oder Web-Code schreiben und Tests für plattformunabhängige Logik ausführen, aber keinen iOS-Build erzeugen.
Die Codex CLI auf einem Mac dagegen kann xcodebuild, CocoaPods und den Simulator direkt ansprechen, je nach Freigabemodus mit oder ohne Rückfrage bei Ihnen. Viele Teams kombinieren beides: Der Cloud-Agent bearbeitet parallel mehrere Aufgaben als Pull Requests, die finale Prüfung und der Build passieren lokal oder in einer CI mit macOS-Runnern.
AGENTS.md als Release-Handbuch
Codex liest die Datei AGENTS.md im Repository als dauerhafte Anleitung. Für ein iOS-Projekt sollte sie festhalten, ob die App mit Capacitor, Expo oder nativ in Swift gebaut wird, welche Befehle Tests und Linter starten, wie Versions- und Build-Nummern gepflegt werden und welche Dateien der Agent nicht verändern darf, etwa Signing-Einstellungen im Xcode-Projekt. Je präziser diese Regeln sind, desto weniger Nacharbeit entsteht bei jedem Pull Request.
Lassen Sie Codex außerdem die fastlane-Konfiguration schreiben: eine Lane für den Build mit gym, eine für den Upload zu TestFlight mit pilot und eine für Metadaten mit deliver. Weil der Cloud-Agent den Build nicht selbst testen kann, ist ein CI-Lauf auf macOS die Kontrollinstanz. Schlägt er fehl, geben Sie Codex das Log als neue Aufgabe. Zertifikate und den App-Store-Connect-API-Schlüssel legen Sie ausschließlich in den Secrets von GitHub Actions, Codemagic, Bitrise oder Xcode Cloud ab.
Ablauf von der Codex-Aufgabe bis zur Freigabe
So entsteht aus einem Codex-Projekt ein veröffentlichter iOS-Release:
- Legen Sie eine AGENTS.md mit Architektur, Build-Befehlen und Tabu-Bereichen an und lassen Sie Codex das Capacitor- oder Expo-Projekt erzeugen.
- Richten Sie im Apple Developer Program Zertifikate, Bundle-ID und einen API-Schlüssel ein und speichern Sie diese als CI-Secrets.
- Beauftragen Sie Codex mit fastlane-Lanes und einem CI-Workflow für einen macOS-Runner und prüfen Sie den Pull Request selbst.
- Lassen Sie die CI bei jedem Release-Tag bauen und automatisch zu TestFlight hochladen.
- Ergänzen Sie Privacy Manifest, App-Privacy-Angaben und Screenshots und testen Sie auf echten Geräten.
- Reichen Sie die Version mit Demo-Zugang ein und lassen Sie Codex eventuelle Review-Anmerkungen als neue Aufgabe umsetzen.
Privacy Manifest, Review und Qualitätssicherung
Apple verlangt für Apps und eingebundene SDKs ein Privacy Manifest, das bestimmte Systemschnittstellen mit einem zulässigen Grund versieht. Agenten fügen schnell Bibliotheken hinzu, deshalb sollte vor jeder Einreichung geprüft werden, ob das Manifest noch stimmt. Weitere typische Fallen sind fehlende Kontolöschung, Login über Drittanbieter ohne Sign in with Apple und Apps, die nach Guideline 4.2 zu wenig eigene Funktion bieten. appsubmitter.io prüft diese Punkte KI-gestützt, richtet die Pipeline im eigenen Account des Kunden ein und übernimmt die Review-Kommunikation. In den Workshops von neooutput lernt Ihr Team, Codex mit AGENTS.md und sauberen Review-Prozessen produktiv einzusetzen.
OpenAI Codex und iOS-Releases für Teams in Freiburg
In Freiburg arbeiten viele kleine Teams ohne eigene Mac-Infrastruktur, etwa Start-ups im Umfeld der Lokhalle oder Projektgruppen an der Universität. Für sie ist die Kombination aus Codex-Cloud-Agent und einer CI mit macOS-Runnern ideal, weil niemand einen Build-Rechner pflegen muss. Wir zeigen, wie Sie den Kreislauf aus Aufgabe, Pull Request, CI-Build und TestFlight so einrichten, dass er ohne manuelle Zwischenschritte funktioniert. Zusätzlich legen wir fest, welche Aufgaben der Cloud-Agent übernimmt und welche lokal über die Codex CLI laufen.
jocapps hat seinen Sitz in Freiburg und bietet mit neooutput Workshops zu OpenAI Codex, Claude Code und Cursor an, vor Ort oder remote, auf Deutsch oder Englisch. Wer die Release-Strecke lieber abgibt, beauftragt appsubmitter.io, das fastlane, Signing und Store-Eintrag in Ihrem eigenen Apple-Account einrichtet. Auch Teams mit Nutzern in der Schweiz und im Elsass unterstützen wir bei mehrsprachigen Store-Einträgen.
Häufige Fragen
Kann der Codex-Cloud-Agent meine iOS-App bauen?
Nein, die Cloud-Umgebungen von Codex laufen auf Linux, Xcode steht dort nicht zur Verfügung. Der Agent kann aber Code, Tests und die gesamte Build-Konfiguration schreiben. Gebaut wird anschließend in einer CI mit macOS-Runner oder lokal über die Codex CLI auf einem Mac.
Was gehört in die AGENTS.md eines iOS-Projekts?
Die gewählte Architektur, Befehle für Build und Tests, Regeln für Versionsnummern und eine Liste von Dateien, die der Agent nicht ändern soll. Dazu zählen vor allem Signing-Einstellungen und Secrets. Eine knappe, präzise Datei wirkt besser als ein langes Handbuch.
Ist Expo eine gute Wahl für Codex-Projekte?
Ja, besonders weil EAS Build die iOS-Builds in der Cloud übernimmt und kein eigener Mac nötig ist. Codex schreibt den JavaScript- und TypeScript-Code, die EAS-Konfiguration erledigt den Rest. Für bestehende Web-Apps ist Capacitor dagegen oft schneller.
Bietet jocapps in Freiburg Workshops zu OpenAI Codex an?
Ja, neooutput-Workshops behandeln Codex ebenso wie Claude Code und Cursor. Sie arbeiten dabei an Ihrer echten Codebasis und entwickeln eine passende AGENTS.md. Die Workshops finden in Freiburg vor Ort oder remote statt.