Crea una app de iOS sin Mac, con Codex en un Mac alquilado
Puedes hacer una app de iPhone de verdad sin tener un Mac. Alquila un Mac y deja que Codex haga el trabajo de Mac por ti. Codex es el agente de programación de OpenAI. Antes de empezar, lee un archivo llamado AGENTS.md. Escribimos uno que le dice a Codex exactamente cómo se crean apps de iOS en un Mac. Probamos sus tres primeros pasos en uno de nuestros Macs el 14 de noviembre de 2026. Esta página explica cada paso y te da el archivo completo.
Por qué sigues necesitando un Mac
Codex puede escribir Swift en cualquier ordenador. Pero solo un Mac puede compilar una app de iOS. Xcode, el simulador y las herramientas de firma de Apple solo funcionan en macOS. Sin ellos, Codex escribe código que nunca puede ejecutar ni ver. Con ellos, puede compilar la app, abrirla en el simulador, hacer una captura de pantalla y revisar su propio trabajo. Nuestra página sobre por qué un agente de programación para iOS necesita un Mac lo explica con más detalle.
Qué necesitas
- Un Mac al que puedas llegar desde tu ordenador. Un Mac de MacRun es un Mac mini M6 dedicado en nuestras propias instalaciones privadas en Nueva Jersey. Viene con Xcode 27.1 y Homebrew. En el plan para agentes, Codex también viene instalado.
- Una cuenta de ChatGPT. Codex inicia sesión con ella. Se aplican los límites de uso de tu plan.
- Una cuenta de Apple Developer, más adelante. Solo la necesitas para poner la app en tu propio iPhone o en la App Store. Cuesta 99 USD al año. Los pasos del simulador no necesitan ninguna cuenta.
- No hace falta experiencia con Xcode. El archivo le pide a Codex que explique cada paso con palabras sencillas y que te enseñe una captura de pantalla.
Qué hace AGENTS.md
AGENTS.md es un archivo de texto plano con instrucciones. Codex lo lee antes de cada tarea. Un archivo en ~/.codex/AGENTS.md se aplica a todos tus proyectos. Un archivo dentro de la carpeta de un proyecto se aplica a ese proyecto.
Nuestro archivo le dice cuatro cosas a Codex:
- Qué hay instalado en el Mac y cómo comprobarlo.
- Las reglas. Cada app va en su propio repositorio git. Nunca se guardan claves ni contraseñas en git. Nunca se pide tu contraseña del Apple ID. Se revisa el trabajo antes de decir que funciona.
- Los comandos exactos para crear, compilar, ejecutar y probar una app.
- Cómo subir una versión de prueba a TestFlight con tu clave de API.
Paso 0: coloca el archivo
Abre Terminal en el Mac, o conéctate por SSH. Descarga el archivo en la carpeta de Codex y después inicia Codex. Si Codex no está instalado, instálalo antes con 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 primera vez, elige Sign in with ChatGPT. El inicio de sesión abre un navegador en el Mac. Puedes terminarlo desde el escritorio del Mac en tu navegador.
Paso 1: describe la app y deja que Codex la cree
Un archivo de proyecto de Xcode es difícil de escribir a mano, para las personas y para los agentes. Por eso el archivo le pide a Codex que use XcodeGen. Codex escribe un project.yml corto, y XcodeGen lo convierte en un proyecto de Xcode real. Codex instala XcodeGen con Homebrew cuando lo necesita.
Después dile a Codex lo que quieres, con tus propias palabras. Por ejemplo:
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 te pedirá tu propio dominio invertido, como com.yourname. Ese será el comienzo del bundle ID de la app.
Paso 2: compilar, ejecutar y hacer una captura
Este es el ciclo que hace útil a un agente en iOS. Codex compila la app, inicia el simulador, instala la app y hace una captura de pantalla. Luego mira la imagen. Si el diseño está roto, lo ve y lo corrige antes que tú.
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
Tú no escribes esto. Codex lo ejecuta por ti. Está aquí para que sepas lo que hace.
Paso 3: ejecutar las pruebas
El proyecto tiene un target de pruebas desde el principio. Pídele a Codex que añada una prueba para cada función. Las ejecuta todas con un solo comando:
xcodebuild test -scheme Tally \ -destination "platform=iOS Simulator,name=iPhone 17" -derivedDataPath build
Qué pasó cuando lo probamos
El 14 de noviembre de 2026 ejecutamos los pasos 1 a 3 en uno de nuestros Macs M6. Usamos XcodeGen 2.46, Xcode 27.1 y el simulador del iPhone 17. El proyecto se generó, la app se compiló y se ejecutó, la captura llegó y las pruebas pasaron. Después anotamos los pasos tal como funcionaron. Así nació este archivo.
Paso 4: ponla en tu iPhone con TestFlight
Un Mac remoto no puede ver un iPhone que está cerca de ti. No puedes conectar tu teléfono a él. TestFlight es la forma de llevar la app a tu teléfono. Para este paso necesitas el Apple Developer Program.
- Crea la app en App Store Connect, con el mismo bundle ID.
- Crea una clave de API de App Store Connect con el rol App Manager. Descarga el archivo .p8 una vez y ponlo en el Mac, en ~/.appstoreconnect/private_keys/.
- Dale a Codex el ID de la clave, el ID del emisor y tu Team ID.
- Pídele a Codex que suba una versión de prueba. Archiva la app y la sube con xcodebuild y tu clave.
- Instala la versión desde la app TestFlight en tu iPhone.
Codex nunca necesita tu contraseña del Apple ID. La clave se encarga de la firma y de la subida. Para ser claros, todavía no hemos ejecutado este paso de principio a fin en nuestros Macs, porque necesita una cuenta de desarrollador. Sigue el flujo de xcodebuild que Apple documenta para subir con una clave de API. Nuestra guía de publicación explica App Store Connect con más detalle.
Paso 5: automatízalo, si quieres
- Sube en cada push. Un runner de GitHub Actions puede funcionar en el mismo Mac. Mira nuestra guía del runner autoalojado.
- Ejecuta una tarea con horario. Un LaunchAgent puede iniciar
codex execcon una tarea a una hora fija y guardar el resultado. El archivo le pide a Codex que te enseñe cómo desactivarlo.
El AGENTS.md completo
Cópialo desde aquí, o descarga AGENTS.md. Está escrito para un Mac de MacRun. En otro Mac, cambia las primeras líneas según lo que tenga instalado.
# 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.
Consejos para trabajar con Codex en una app
- Pide un cambio pequeño cada vez. Mira la captura después de cada uno.
- Deja que Codex haga un commit tras cada paso que funcione. Así es fácil deshacer un mal cambio.
- Sube el repositorio a GitHub, para que tu código también viva fuera del Mac.
- Nunca pegues claves ni contraseñas en el chat. Pon tú mismo el archivo .p8 en el Mac.
- Cuando algo se vea mal, di lo que ves. Codex puede hacer otra captura.
Lo que esto no hace
- No puede probar en un teléfono conectado al Mac. Usa el simulador y TestFlight.
- Apple revisa cada app de la App Store. Tú envías la app a revisión.
- Codex puede equivocarse. Tú decides qué se publica.
- Nosotros ponemos el Mac y el archivo. No creamos tu app.
Cuánto cuesta
Un Mac para agentes de MacRun cuesta $169 al mes, con Xcode 27.1 y Codex instalados. Nunca se duerme, así que Codex puede seguir trabajando mientras tu ordenador está apagado. Tu plan de ChatGPT paga Codex. El Apple Developer Program cuesta 99 USD al año y solo hace falta para TestFlight y la App Store.
Quién no debería alquilar un Mac para esto
Si ya tienes un Mac, úsalo. El mismo archivo funciona ahí. Si quieres una app sin nada de código, quizá te sirva mejor una herramienta sin código. Para otras opciones, lee cómo desarrollar apps de iOS sin Mac.
Preguntas frecuentes
¿Puedo crear una app de iOS sin Mac usando un agente de IA?
+
El agente puede escribir el código en cualquier sitio, pero compilar y ejecutar una app de iOS necesita Xcode, que solo funciona en macOS. Alquila un Mac, ejecuta Codex en él y el agente podrá compilar, abrir el simulador y revisar su propio trabajo.
¿Qué es AGENTS.md?
+
Un archivo de texto plano con instrucciones que Codex lee antes de cada tarea. Un archivo en ~/.codex/AGENTS.md se aplica a todos los proyectos. Un archivo en la carpeta de un proyecto se aplica a ese proyecto. El nuestro le dice a Codex cómo crear, compilar, probar y subir una app de iOS en un Mac.
¿Está probado este AGENTS.md?
+
Probamos los pasos 1 a 3 en uno de nuestros Macs M6 el 14 de noviembre de 2026. Usamos XcodeGen 2.46, Xcode 27.1 y el simulador del iPhone 17. El paso de TestFlight aún no se ha ejecutado de principio a fin. Sigue el flujo de xcodebuild que Apple documenta para subir con una clave de API de App Store Connect.
¿Necesito una cuenta de Apple Developer?
+
No para compilar y ejecutar la app en el simulador. Necesitas el Apple Developer Program, 99 USD al año, para usar TestFlight en tu iPhone. También lo necesitas para publicar en la App Store.
¿Puedo probar la app en mi propio iPhone?
+
Sí, con TestFlight. Codex archiva y sube una versión de prueba, y tú la instalas desde la app TestFlight. No puedes conectar tu iPhone a un Mac remoto.
¿Codex necesita mi contraseña del Apple ID?
+
No. El archivo le dice a Codex que nunca la pida. La firma y las subidas usan una clave de API de App Store Connect, que tú creas y pones en el Mac.