Ratgeber

Eine iOS-App ohne Mac entwickeln, mit Codex auf einem gemieteten Mac

Sie können eine echte iPhone-App bauen, ohne einen Mac zu besitzen. Mieten Sie einen Mac und lassen Sie Codex die Arbeit am Mac für Sie machen. Codex ist der Coding Agent von OpenAI. Bevor er anfängt, liest er eine Datei namens AGENTS.md. Wir haben eine geschrieben, die Codex genau erklärt, wie ein Mac iOS-Apps baut. Ihre ersten drei Schritte haben wir am 14. November 2026 auf einem unserer Macs getestet. Diese Seite erklärt jeden Schritt und gibt Ihnen die ganze Datei.

Warum Sie trotzdem einen Mac brauchen

Codex kann Swift auf jedem Computer schreiben. Aber nur ein Mac kann eine iOS-App bauen. Xcode, der Simulator und die Signier-Werkzeuge von Apple laufen nur unter macOS. Ohne sie schreibt Codex Code, den es nie ausführen oder sehen kann. Mit ihnen kann es die App bauen, im Simulator öffnen, einen Screenshot machen und die eigene Arbeit prüfen. Unsere Seite darüber, warum ein iOS Coding Agent einen Mac braucht, geht tiefer.

Was Sie brauchen

  • Einen Mac, den Sie von Ihrem Computer aus erreichen. Ein MacRun-Mac ist ein dedizierter M6 Mac mini in unserer eigenen privaten Anlage in New Jersey. Xcode 27.1 und Homebrew sind dabei. Im Agent-Tarif ist auch Codex installiert.
  • Ein ChatGPT-Konto. Codex meldet sich damit an. Es gelten die Nutzungslimits Ihres Tarifs.
  • Ein Apple-Developer-Konto, später. Sie brauchen es nur, um die App auf Ihr eigenes iPhone oder in den App Store zu bringen. Es kostet 99 USD pro Jahr. Für die Schritte im Simulator brauchen Sie kein Konto.
  • Keine Erfahrung mit Xcode. Die Datei sagt Codex, dass es jeden Schritt in einfachen Worten erklären und Ihnen einen Screenshot zeigen soll.

Was AGENTS.md macht

AGENTS.md ist eine einfache Textdatei mit Anweisungen. Codex liest sie vor jeder Aufgabe. Eine Datei unter ~/.codex/AGENTS.md gilt für alle Ihre Projekte. Eine Datei in einem Projektordner gilt für dieses Projekt.

Unsere Datei sagt Codex vier Dinge:

  • Was auf dem Mac installiert ist und wie man es prüft.
  • Die Regeln. Jede App bekommt ein eigenes Git-Repo. Nie Schlüssel oder Passwörter in Git ablegen. Nie nach Ihrem Apple-ID-Passwort fragen. Die Arbeit prüfen, bevor es sagt, dass sie funktioniert.
  • Die genauen Befehle, um eine App anzulegen, zu bauen, zu starten und zu testen.
  • Wie es mit Ihrem API-Schlüssel einen Test-Build zu TestFlight hochlädt.

Schritt 0: die Datei an ihren Platz legen

Öffnen Sie das Terminal auf dem Mac oder verbinden Sie sich per SSH. Laden Sie die Datei in den Ordner von Codex und starten Sie dann Codex. Wenn Codex nicht installiert ist, installieren Sie es zuerst mit Homebrew.

mkdir -p ~/.codex
curl -fsSL https://macrun.dev/blueprint/AGENTS.md -o ~/.codex/AGENTS.md
brew install --cask codex   # only if codex is missing
codex

Wählen Sie beim ersten Mal Sign in with ChatGPT. Die Anmeldung öffnet einen Browser auf dem Mac. Sie können sie auf dem Desktop des Macs in Ihrem Browser abschließen.

Schritt 1: die App beschreiben und Codex sie anlegen lassen

Eine Xcode-Projektdatei ist von Hand schwer zu schreiben, für Menschen und für Agents. Deshalb sagt die Datei Codex, dass es XcodeGen nutzen soll. Codex schreibt eine kurze project.yml, und XcodeGen macht daraus ein echtes Xcode-Projekt. Codex installiert XcodeGen mit Homebrew, wenn es gebraucht wird.

Dann sagen Sie Codex in Ihren eigenen Worten, was Sie wollen. Zum Beispiel:

Make a new iPhone app called Tally. It has one big button
that counts taps and remembers the count. Use SwiftUI.
Follow AGENTS.md and show me a screenshot when it runs.

Codex fragt nach Ihrer eigenen umgekehrten Domain, etwa com.yourname. Daraus wird der Anfang der Bundle ID der App.

Schritt 2: bauen, starten und einen Screenshot machen

Diese Schleife macht einen Agent unter iOS nützlich. Codex baut die App, startet den Simulator, installiert die App und macht einen Screenshot. Dann sieht es sich das Bild an. Wenn das Layout kaputt ist, sieht es das und behebt es, bevor Sie es bemerken.

SIM="iPhone 17"
xcodebuild -scheme Tally -destination "platform=iOS Simulator,name=$SIM" \
  -derivedDataPath build build
xcrun simctl bootstatus "$SIM" -b
xcrun simctl install "$SIM" build/Build/Products/Debug-iphonesimulator/Tally.app
xcrun simctl launch "$SIM" com.yourname.tally
sleep 3; xcrun simctl io "$SIM" screenshot /tmp/shot.png

Sie tippen diese Befehle nicht ein. Codex führt sie für Sie aus. Sie stehen hier, damit Sie wissen, was es tut.

Schritt 3: die Tests ausführen

Das Projekt hat von Anfang an ein Test-Target. Bitten Sie Codex, für jede Funktion einen Test hinzuzufügen. Es führt alle mit einem Befehl aus:

xcodebuild test -scheme Tally \
  -destination "platform=iOS Simulator,name=iPhone 17" -derivedDataPath build

Was bei unserem Test passiert ist

Am 14. November 2026 haben wir die Schritte 1 bis 3 auf einem unserer M6 Macs ausgeführt. Wir nutzten XcodeGen 2.46, Xcode 27.1 und den Simulator für das iPhone 17. Das Projekt wurde erzeugt, die App wurde gebaut und lief, der Screenshot kam zurück, und die Tests waren erfolgreich. Dann haben wir die Schritte so aufgeschrieben, wie sie funktioniert haben. Daraus wurde diese Datei.

Schritt 4: die App mit TestFlight auf Ihr iPhone bringen

Ein Remote-Mac kann kein iPhone in Ihrer Nähe sehen. Sie können Ihr Handy nicht an ihn anschließen. TestFlight ist der Weg, die App auf Ihr Handy zu bringen. Für diesen Schritt brauchen Sie das Apple Developer Program.

  • Legen Sie die App in App Store Connect an, mit derselben Bundle ID.
  • Erstellen Sie einen App Store Connect API-Schlüssel mit der Rolle App Manager. Laden Sie die .p8-Datei einmal herunter und legen Sie sie auf dem Mac in ~/.appstoreconnect/private_keys/ ab.
  • Geben Sie Codex die Key ID, die Issuer ID und Ihre Team ID.
  • Bitten Sie Codex, einen Test-Build hochzuladen. Es archiviert die App und lädt sie mit xcodebuild und Ihrem Schlüssel hoch.
  • Installieren Sie den Build über die TestFlight-App auf Ihrem iPhone.

Codex braucht nie Ihr Apple-ID-Passwort. Der Schlüssel übernimmt das Signieren und den Upload. Um ehrlich zu sein: Diesen Schritt haben wir auf unseren Macs noch nicht von Anfang bis Ende ausgeführt, denn er braucht ein Developer-Konto. Er folgt dem von Apple dokumentierten xcodebuild-Ablauf für Uploads mit API-Schlüssel. Unsere Anleitung zum Veröffentlichen erklärt App Store Connect genauer.

Schritt 5: automatisieren, wenn Sie wollen

  • Bei jedem Push hochladen. Ein GitHub Actions Runner kann auf demselben Mac laufen. Siehe unsere Anleitung zum selbst gehosteten Runner.
  • Eine Aufgabe nach Zeitplan ausführen. Ein LaunchAgent kann codex exec zu einer festen Zeit mit einer Aufgabe starten und das Ergebnis protokollieren. Die Datei sagt Codex, dass es Ihnen zeigen soll, wie Sie das wieder abschalten.

Die vollständige AGENTS.md

Kopieren Sie sie von hier, oder laden Sie AGENTS.md herunter. Sie ist für einen MacRun-Mac geschrieben. Auf einem anderen Mac passen Sie die ersten Zeilen an das an, was dort installiert ist.

# This Mac: how to build iOS apps here

You are a coding agent on a dedicated MacRun Mac mini (M6, macOS 27). The person you work with
may be new to iOS. Explain what you do in plain words, one step at a time, and show them the
result (a simulator screenshot) after each change they can see.

## What is installed

- Xcode 27.1 with iOS 27.1, 27.0 and 26.5 simulators. Check with `xcrun simctl list devices available`.
- Homebrew (`/opt/homebrew/bin`), git, Node, Ruby, fastlane, Codex and Claude Code.
- Not installed until needed: XcodeGen. Install it with `brew install xcodegen`.

## Rules

- Keep projects in `~/Projects/<AppName>`. Make each one a git repo and commit after each working step.
- Never put secrets in git: no `.p8` keys, passwords or API tokens. Keep App Store Connect keys in
  `~/.appstoreconnect/private_keys/` and add `*.p8` to `.gitignore`.
- Never ask the person for their Apple ID password. Signing and uploads use an App Store Connect API key.
- The Mac does not sleep. Do not change power, sharing or network settings.
- Check the work yourself: build, run tests, and look at a screenshot before you say it works.

## 1. Create a new app

Xcode projects are hard to write by hand, so describe the project in `project.yml` and let XcodeGen
make the `.xcodeproj`:

```yaml
name: Hello
options:
  bundleIdPrefix: com.example      # ask the person for their own reverse domain
  deploymentTarget: { iOS: "26.0" }
targets:
  Hello:
    type: application
    platform: iOS
    sources: [Sources]
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: com.example.hello
        MARKETING_VERSION: "1.0"
        CURRENT_PROJECT_VERSION: "1"
        GENERATE_INFOPLIST_FILE: YES
        INFOPLIST_KEY_UILaunchScreen_Generation: YES
        INFOPLIST_KEY_UISupportedInterfaceOrientations: UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight
        TARGETED_DEVICE_FAMILY: "1"      # iPhone only; use "1,2" for iPad too
  HelloTests:
    type: bundle.unit-test
    platform: iOS
    sources: [Tests]
    dependencies: [{ target: Hello }]
    settings:
      base:
        GENERATE_INFOPLIST_FILE: YES
schemes:
  Hello:
    build: { targets: { Hello: all } }
    test: { targets: [HelloTests] }
```

Write SwiftUI code in `Sources/` (an `App` struct and a `ContentView`), tests in `Tests/`, then run
`xcodegen generate`. Run it again whenever you add or remove files.

## 2. Build and run in the simulator

```sh
SIM="iPhone 17"
xcodebuild -scheme Hello -destination "platform=iOS Simulator,name=$SIM" \
  -derivedDataPath build build
xcrun simctl bootstatus "$SIM" -b   # boots it and waits until ready
xcrun simctl install "$SIM" build/Build/Products/Debug-iphonesimulator/Hello.app
xcrun simctl launch "$SIM" com.example.hello
sleep 3; xcrun simctl io "$SIM" screenshot /tmp/shot.png
```

Open `/tmp/shot.png` to check the screen, and show it to the person. They can also open the
Mac's desktop in Screen Sharing or the browser to look for themselves.

## 3. Run the tests

```sh
xcodebuild test -scheme Hello -destination "platform=iOS Simulator,name=iPhone 17" -derivedDataPath build
```

## 4. Test builds and uploads to TestFlight

This needs the person's paid Apple Developer account. Do these steps with them:

1. They create the app in App Store Connect (Apps, +, New App) with the same bundle ID.
2. They create an API key in App Store Connect (Users and Access, Integrations, App Store Connect API,
   role App Manager). They download the `.p8` file once and put it in `~/.appstoreconnect/private_keys/`.
   You need three values: the key ID, the issuer ID, and their Team ID (Membership page).
3. Set the Team ID in `project.yml` (`DEVELOPMENT_TEAM`, with `CODE_SIGN_STYLE: Automatic`) and regenerate.

Then each upload is:

```sh
KEY_ID=...; ISSUER=...; KEY=~/.appstoreconnect/private_keys/AuthKey_$KEY_ID.p8
AUTH="-allowProvisioningUpdates -authenticationKeyPath $KEY -authenticationKeyID $KEY_ID -authenticationKeyIssuerID $ISSUER"
xcodebuild -scheme Hello -configuration Release -destination "generic/platform=iOS" \
  -archivePath build/Hello.xcarchive archive $AUTH
xcodebuild -exportArchive -archivePath build/Hello.xcarchive \
  -exportOptionsPlist ExportOptions.plist -exportPath build/export $AUTH
```

`ExportOptions.plist`:

```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
  <key>method</key><string>app-store-connect</string>
  <key>destination</key><string>upload</string>
  <key>teamID</key><string>TEAM_ID_HERE</string>
</dict></plist>
```

Raise `CURRENT_PROJECT_VERSION` before every upload; App Store Connect rejects a repeated build number.
The build shows in TestFlight after Apple processes it, which can take a while. If the person
prefers fastlane, `fastlane pilot` does the same with the same API key.

## 5. Automate it

- To upload on every push, a GitHub Actions self-hosted runner can run on this Mac. Ask first.
- To run a task on a schedule, use a LaunchAgent in `~/Library/LaunchAgents` that calls
  `codex exec "<task>"`, and log to a file. Show the person how to turn it off.

## Limits

- No physical iPhone can be plugged in. Use the simulator here and TestFlight on their own phone.
- Apple's review is done by Apple. You can prepare the build, but the person submits for review.

Tipps für die Arbeit mit Codex an einer App

  • Bitten Sie um eine kleine Änderung nach der anderen. Sehen Sie sich nach jeder den Screenshot an.
  • Lassen Sie Codex nach jedem funktionierenden Schritt committen. Dann ist eine schlechte Änderung leicht rückgängig zu machen.
  • Pushen Sie das Repo zu GitHub, damit Ihr Code auch außerhalb des Macs liegt.
  • Fügen Sie nie Schlüssel oder Passwörter in den Chat ein. Legen Sie die .p8-Datei selbst auf den Mac.
  • Wenn etwas falsch aussieht, sagen Sie, was Sie sehen. Codex kann einen neuen Screenshot machen.

Was das nicht kann

  • Es kann nicht auf einem Handy testen, das am Mac hängt. Nutzen Sie den Simulator und TestFlight.
  • Apple prüft jede App im App Store. Sie reichen die App selbst zur Prüfung ein.
  • Codex kann Fehler machen. Sie entscheiden, was veröffentlicht wird.
  • Wir stellen den Mac und die Datei. Wir bauen Ihre App nicht.

Was es kostet

Ein Agent-Mac von MacRun kostet $169 pro Monat, mit Xcode 27.1 und Codex installiert. Er schläft nie, also kann Codex weiterarbeiten, während Ihr eigener Computer aus ist. Codex bezahlen Sie über Ihren ChatGPT-Tarif. Das Apple Developer Program kostet 99 USD pro Jahr und ist nur für TestFlight und den App Store nötig.

Wer dafür keinen Mac mieten sollte

Wenn Sie schon einen Mac besitzen, nutzen Sie ihn. Dieselbe Datei funktioniert dort. Wenn Sie eine App ganz ohne Code wollen, passt ein No-Code-Baukasten vielleicht besser. Andere Wege beschreibt unsere Anleitung iOS-Apps ohne Mac entwickeln.

Häufige Fragen

Kann ich mit einem KI-Agent eine iOS-App ohne Mac entwickeln?

+

Der Agent kann den Code überall schreiben. Um eine iOS-App zu bauen und zu starten, braucht man aber Xcode, und Xcode läuft nur unter macOS. Mieten Sie einen Mac und starten Sie Codex darauf. Dann kann der Agent bauen, den Simulator starten und seine eigene Arbeit prüfen.

Was ist AGENTS.md?

+

Eine einfache Textdatei mit Anweisungen, die Codex vor jeder Aufgabe liest. Eine Datei unter ~/.codex/AGENTS.md gilt für alle Projekte. Eine Datei in einem Projektordner gilt für dieses Projekt. Unsere sagt Codex, wie es auf einem Mac eine iOS-App anlegt, baut, testet und hochlädt.

Haben Sie diese AGENTS.md getestet?

+

Wir haben die Schritte 1 bis 3 am 14. November 2026 auf einem unserer M6 Macs getestet. Wir nutzten XcodeGen 2.46, Xcode 27.1 und den Simulator für das iPhone 17. Den Schritt mit TestFlight haben wir noch nicht von Anfang bis Ende ausgeführt. Er folgt dem von Apple dokumentierten xcodebuild-Ablauf für Uploads mit einem App Store Connect API-Schlüssel.

Brauche ich ein Apple-Developer-Konto?

+

Nicht, um die App im Simulator zu bauen und zu starten. Für TestFlight auf Ihrem iPhone brauchen Sie das Apple Developer Program, 99 USD pro Jahr. Sie brauchen es auch, um im App Store zu veröffentlichen.

Kann ich die App auf meinem eigenen iPhone testen?

+

Ja, über TestFlight. Codex archiviert einen Test-Build und lädt ihn hoch, und Sie installieren ihn über die TestFlight-App. Sie können Ihr iPhone nicht an einen Remote-Mac anschließen.

Braucht Codex mein Apple-ID-Passwort?

+

Nein. Die Datei sagt Codex, dass es nie danach fragen soll. Signieren und Uploads laufen über einen App Store Connect API-Schlüssel, den Sie selbst erstellen und auf den Mac legen.

Passende Ratgeber