Créer une app iOS sans Mac, avec Codex sur un Mac loué
Vous pouvez créer une vraie app iPhone sans posséder de Mac. Louez un Mac, et laissez Codex faire le travail sur le Mac à votre place. Codex est l’agent de code d’OpenAI. Il lit un fichier appelé AGENTS.md avant de commencer. Nous en avons écrit un qui explique à Codex exactement comment un Mac compile des apps iOS. Nous avons testé ses trois premières étapes sur un de nos Mac le 14 novembre 2026. Cette page explique chaque étape et vous donne le fichier complet.
Pourquoi il vous faut quand même un Mac
Codex peut écrire du Swift sur n’importe quel ordinateur. Mais seul un Mac peut compiler une app iOS. Xcode, le simulateur et les outils de signature d’Apple tournent seulement sur macOS. Sans eux, Codex écrit du code qu’il ne peut jamais lancer ni voir. Avec eux, il peut compiler l’app, l’ouvrir dans le simulateur, prendre une capture d’écran et vérifier son propre travail. Notre page sur pourquoi un agent de code iOS a besoin d’un Mac va plus loin.
Ce qu’il vous faut
- Un Mac accessible depuis votre ordinateur. Un Mac MacRun est un Mac mini M6 dédié, dans notre propre site privé du New Jersey. Il est livré avec Xcode 27.1 et Homebrew. Avec l’offre agent, Codex est installé aussi.
- Un compte ChatGPT. Codex se connecte avec. Les limites d’usage de votre abonnement s’appliquent.
- Un compte Apple Developer, plus tard. Il vous sert seulement à installer l’app sur votre propre iPhone ou à la mettre sur l’App Store. Il coûte 99 USD par an. Les étapes dans le simulateur ne demandent aucun compte.
- Aucune expérience de Xcode. Le fichier demande à Codex d’expliquer chaque étape avec des mots simples et de vous montrer une capture d’écran.
Ce que fait AGENTS.md
AGENTS.md est un simple fichier texte d’instructions. Codex le lit avant chaque tâche. Un fichier placé dans ~/.codex/AGENTS.md s’applique à tous vos projets. Un fichier dans le dossier d’un projet s’applique à ce projet.
Notre fichier dit quatre choses à Codex :
- Ce qui est installé sur le Mac, et comment le vérifier.
- Les règles. Garder chaque app dans son propre dépôt git. Ne jamais mettre de clés ni de mots de passe dans git. Ne jamais demander votre mot de passe d’identifiant Apple. Vérifier le travail avant de dire qu’il marche.
- Les commandes exactes pour créer, compiler, lancer et tester une app.
- Comment envoyer un build de test sur TestFlight avec votre clé d’API.
Étape 0 : mettre le fichier en place
Ouvrez le Terminal sur le Mac, ou connectez-vous en SSH. Téléchargez le fichier dans le dossier de Codex, puis lancez Codex. Si Codex n’est pas installé, installez-le d’abord avec 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
La première fois, choisissez Sign in with ChatGPT (se connecter avec ChatGPT). La connexion ouvre un navigateur sur le Mac. Vous pouvez la terminer depuis le bureau du Mac, dans votre navigateur.
Étape 1 : décrire l’app et laisser Codex la créer
Un fichier de projet Xcode est difficile à écrire à la main, pour les humains comme pour les agents. Le fichier demande donc à Codex d’utiliser XcodeGen. Codex écrit un court project.yml, et XcodeGen le transforme en vrai projet Xcode. Codex installe XcodeGen avec Homebrew quand il en a besoin.
Dites ensuite à Codex ce que vous voulez, avec vos propres mots. Par exemple :
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 vous demandera votre propre domaine inversé, comme com.votrenom. Il devient le début du bundle ID de l’app.
Étape 2 : compiler, lancer et prendre une capture d’écran
C’est cette boucle qui rend un agent utile sur iOS. Codex compile l’app, démarre le simulateur, installe l’app et prend une capture d’écran. Puis il regarde l’image. Si la mise en page est cassée, il le voit et la corrige avant vous.
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
Vous ne tapez pas ces commandes. Codex les lance pour vous. Elles sont là pour que vous sachiez ce qu’il fait.
Étape 3 : lancer les tests
Le projet a une cible de test dès le départ. Demandez à Codex d’ajouter un test pour chaque fonction. Il les lance tous avec une seule commande :
xcodebuild test -scheme Tally \ -destination "platform=iOS Simulator,name=iPhone 17" -derivedDataPath build
Ce qui s’est passé pendant notre test
Le 14 novembre 2026, nous avons suivi les étapes 1 à 3 sur un de nos Mac M6. Nous avons utilisé XcodeGen 2.46, Xcode 27.1 et le simulateur iPhone 17. Le projet a été généré, l’app a compilé et s’est lancée, la capture d’écran est revenue, et les tests sont passés. Nous avons ensuite noté les étapes telles qu’elles ont marché. C’est devenu ce fichier.
Étape 4 : installer l’app sur votre iPhone avec TestFlight
Un Mac distant ne peut pas voir un iPhone près de vous. Vous ne pouvez pas y brancher votre téléphone. TestFlight est le moyen de mettre l’app sur votre téléphone. Cette étape demande l’Apple Developer Program.
- Créez l’app dans App Store Connect, avec le même bundle ID.
- Créez une clé d’API App Store Connect avec le rôle App Manager. Téléchargez le fichier .p8 une seule fois et placez-le sur le Mac dans ~/.appstoreconnect/private_keys/.
- Donnez à Codex l’ID de la clé, l’ID de l’émetteur et votre Team ID.
- Demandez à Codex d’envoyer un build de test. Il archive l’app et l’envoie avec xcodebuild et votre clé.
- Installez le build depuis l’app TestFlight sur votre iPhone.
Codex n’a jamais besoin de votre mot de passe d’identifiant Apple. La clé s’occupe de la signature et de l’envoi. Pour être clair, nous n’avons pas encore suivi cette étape de bout en bout sur notre parc, car elle demande un compte développeur. Elle suit le processus xcodebuild documenté par Apple pour les envois avec une clé d’API. Notre guide de publication couvre App Store Connect plus en détail.
Étape 5 : automatiser, si vous voulez
- Envoyer à chaque push. Un runner GitHub Actions peut tourner sur le même Mac. Voir notre guide du runner auto-hébergé.
- Lancer une tâche à heure fixe. Un LaunchAgent peut démarrer
codex execavec une tâche à une heure donnée et noter le résultat. Le fichier demande à Codex de vous montrer comment le désactiver.
Le fichier AGENTS.md complet
Copiez-le ici, ou téléchargez AGENTS.md. Il est écrit pour un Mac MacRun. Sur un autre Mac, modifiez les premières lignes pour qu’elles correspondent à ce qui y est installé.
# 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.
Conseils pour travailler avec Codex sur une app
- Demandez un seul petit changement à la fois. Regardez la capture d’écran après chacun.
- Laissez Codex faire un commit après chaque étape qui marche. Un mauvais changement est alors facile à annuler.
- Poussez le dépôt sur GitHub, pour que votre code existe aussi hors du Mac.
- Ne collez jamais de clés ni de mots de passe dans la conversation. Placez vous-même le fichier .p8 sur le Mac.
- Quand quelque chose semble faux, dites ce que vous voyez. Codex peut prendre une autre capture d’écran.
Ce que cela ne fait pas
- Pas de test sur un téléphone branché au Mac. Utilisez le simulateur et TestFlight.
- Apple examine chaque app de l’App Store. Vous soumettez vous-même l’app à l’examen.
- Codex peut se tromper. C’est vous qui décidez de ce qui est publié.
- Nous fournissons le Mac et le fichier. Nous ne créons pas votre app.
Combien ça coûte
Un Mac pour agents MacRun coûte $169 par mois, avec Xcode 27.1 et Codex installés. Il ne se met jamais en veille, donc Codex peut continuer à travailler quand votre ordinateur est éteint. Votre abonnement ChatGPT paie Codex. L’Apple Developer Program coûte 99 USD par an, et il sert seulement pour TestFlight et l’App Store.
Qui ne devrait pas louer un Mac pour cela
Si vous avez déjà un Mac, utilisez-le. Le même fichier y fonctionne. Si vous voulez une app sans aucun code, un outil no-code vous conviendra peut-être mieux. Pour d’autres options, lisez développer des apps iOS sans Mac.
Questions fréquentes
Puis-je créer une app iOS sans Mac grâce à un agent IA ?
+
L’agent peut écrire le code n’importe où, mais compiler et lancer une app iOS demande Xcode, qui tourne seulement sur macOS. Louez un Mac, lancez Codex dessus, et l’agent peut compiler, lancer le simulateur et vérifier son propre travail.
Qu’est-ce que AGENTS.md ?
+
Un simple fichier texte d’instructions que Codex lit avant chaque tâche. Un fichier placé dans ~/.codex/AGENTS.md s’applique à tous les projets. Un fichier dans le dossier d’un projet s’applique à ce projet. Le nôtre explique à Codex comment créer, compiler, tester et envoyer une app iOS sur un Mac.
Avez-vous testé ce AGENTS.md ?
+
Nous avons testé les étapes 1 à 3 sur un de nos Mac M6 le 14 novembre 2026. Nous avons utilisé XcodeGen 2.46, Xcode 27.1 et le simulateur iPhone 17. L’étape TestFlight n’a pas encore été suivie de bout en bout. Elle suit le processus xcodebuild documenté par Apple pour les envois avec une clé d’API App Store Connect.
Ai-je besoin d’un compte Apple Developer ?
+
Pas pour compiler et lancer l’app dans le simulateur. Il vous faut l’Apple Developer Program, à 99 USD par an, pour TestFlight sur votre iPhone. Il vous le faut aussi pour publier sur l’App Store.
Puis-je tester l’app sur mon propre iPhone ?
+
Oui, avec TestFlight. Codex archive et envoie un build de test, et vous l’installez depuis l’app TestFlight. Vous ne pouvez pas brancher votre iPhone sur un Mac distant.
Codex a-t-il besoin de mon mot de passe d’identifiant Apple ?
+
Non. Le fichier demande à Codex de ne jamais le demander. La signature et les envois utilisent une clé d’API App Store Connect, que vous créez et placez vous-même sur le Mac.