Guia

Crie um app iOS sem Mac, com o Codex num Mac alugado

Você pode fazer um app de iPhone de verdade sem ter um Mac. Alugue um Mac e deixe o Codex fazer o trabalho de Mac por você. O Codex é o agente de programação da OpenAI. Ele lê um arquivo chamado AGENTS.md antes de começar. Nós escrevemos um que diz ao Codex exatamente como um Mac cria apps iOS. Testamos os três primeiros passos dele num dos nossos Macs em 14 de novembro de 2026. Esta página explica cada passo e traz o arquivo inteiro.

Por que você ainda precisa de um Mac

O Codex escreve Swift em qualquer computador. Mas só um Mac consegue compilar um app iOS. O Xcode, o simulador e as ferramentas de assinatura da Apple só rodam no macOS. Sem eles, o Codex escreve código que nunca consegue rodar nem ver. Com eles, ele compila o app, abre no simulador, tira um print da tela e confere o próprio trabalho. A nossa página sobre por que um agente de programação iOS precisa de um Mac explica melhor.

Do que você precisa

  • Um Mac que você acessa do seu computador. Um Mac da MacRun é um Mac mini M6 dedicado na nossa instalação privada em Nova Jersey. Ele vem com Xcode 27.1 e Homebrew. No plano para agentes, o Codex também vem instalado.
  • Uma conta do ChatGPT. O Codex faz login com ela. Os limites de uso do seu plano valem.
  • Uma conta Apple Developer, mais tarde. Você só precisa dela para pôr o app no seu iPhone ou na App Store. Ela custa 99 USD por ano. Os passos no simulador não pedem conta.
  • Nenhuma experiência com Xcode. O arquivo pede ao Codex que explique cada passo com palavras simples e mostre um print da tela.

O que o AGENTS.md faz

O AGENTS.md é um arquivo de texto simples com instruções. O Codex lê o arquivo antes de cada tarefa. Um arquivo em ~/.codex/AGENTS.md vale para todos os seus projetos. Um arquivo dentro da pasta de um projeto vale para aquele projeto.

O nosso arquivo diz quatro coisas ao Codex:

  • O que está instalado no Mac, e como conferir.
  • As regras. Cada app fica no seu próprio repositório git. Nunca pôr chaves ou senhas no git. Nunca pedir a senha do seu Apple ID. Conferir o trabalho antes de dizer que funciona.
  • Os comandos exatos para criar, compilar, rodar e testar um app.
  • Como enviar uma build de teste para o TestFlight com a sua chave de API.

Passo 0: coloque o arquivo no lugar

Abra o Terminal no Mac, ou conecte por SSH. Baixe o arquivo na pasta do Codex e depois inicie o Codex. Se o Codex não estiver instalado, instale primeiro com o 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

Na primeira vez, escolha Sign in with ChatGPT. O login abre um navegador no Mac. Você pode terminar pela área de trabalho do Mac, no seu navegador.

Passo 1: descreva o app e deixe o Codex criar

Um arquivo de projeto do Xcode é difícil de escrever à mão, para pessoas e para agentes. Por isso o arquivo pede ao Codex que use o XcodeGen. O Codex escreve um project.yml curto, e o XcodeGen transforma ele num projeto Xcode de verdade. O Codex instala o XcodeGen com o Homebrew quando precisa.

Depois diga ao Codex o que você quer, com as suas palavras. Por exemplo:

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.

O Codex vai pedir o seu domínio reverso, como com.seunome. Ele vira o começo do bundle ID do app.

Passo 2: compile, rode e tire um print da tela

Este é o ciclo que torna um agente útil no iOS. O Codex compila o app, inicia o simulador, instala o app e tira um print da tela. Depois ele olha a imagem. Se o layout estiver quebrado, ele vê e corrige antes de você.

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

Você não digita esses comandos. O Codex roda eles por você. Eles estão aqui para você saber o que ele está fazendo.

Passo 3: rode os testes

O projeto tem um target de testes desde o início. Peça ao Codex um teste para cada recurso. Ele roda todos com um só comando:

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

O que aconteceu quando testamos

Em 14 de novembro de 2026, rodamos os passos 1 a 3 num dos nossos Macs M6. Usamos XcodeGen 2.46, Xcode 27.1 e o simulador do iPhone 17. O projeto foi gerado, o app compilou e rodou, o print da tela voltou e os testes passaram. Depois anotamos os passos do jeito que funcionaram. Assim nasceu este arquivo.

Passo 4: coloque no seu iPhone com o TestFlight

Um Mac remoto não enxerga um iPhone perto de você. Você não consegue ligar o celular nele. O TestFlight é o jeito de levar o app para o seu celular. Para este passo você precisa do Apple Developer Program.

  • Crie o app no App Store Connect, com o mesmo bundle ID.
  • Crie uma chave de API do App Store Connect com a função App Manager. Baixe o arquivo .p8 uma vez e coloque no Mac em ~/.appstoreconnect/private_keys/.
  • Passe ao Codex o key ID, o issuer ID e o seu Team ID.
  • Peça ao Codex que envie uma build de teste. Ele arquiva o app e envia com o xcodebuild e a sua chave.
  • Instale a build pelo app TestFlight no seu iPhone.

O Codex nunca precisa da senha do seu Apple ID. A chave faz a assinatura e o envio. Para ser claro: ainda não rodamos este passo de ponta a ponta na nossa frota, porque ele exige uma conta de desenvolvedor. Ele segue o fluxo do xcodebuild que a Apple documenta para envios com chave de API. O nosso guia de publicação explica o App Store Connect com mais detalhes.

Passo 5: automatize, se quiser

  • Envie a cada push. Um runner do GitHub Actions pode rodar no mesmo Mac. Veja o nosso guia de runner auto-hospedado.
  • Rode uma tarefa em horário marcado. Um LaunchAgent pode iniciar o codex exec com uma tarefa num horário definido e registrar o resultado. O arquivo pede ao Codex que mostre como desligar isso.

O AGENTS.md completo

Copie daqui, ou baixe o AGENTS.md. Ele foi escrito para um Mac da MacRun. Em outro Mac, mude as primeiras linhas para combinar com o que está instalado lá.

# 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.

Dicas para trabalhar com o Codex num app

  • Peça uma mudança pequena por vez. Olhe o print da tela depois de cada uma.
  • Deixe o Codex fazer commit depois de cada passo que funciona. Assim fica fácil desfazer uma mudança ruim.
  • Envie o repositório para o GitHub, para o seu código também ficar fora do Mac.
  • Nunca cole chaves ou senhas no chat. Coloque o arquivo .p8 no Mac você mesmo.
  • Quando algo parecer errado, diga o que você vê. O Codex pode tirar outro print da tela.

O que isto não faz

  • Não dá para testar num celular ligado ao Mac. Use o simulador e o TestFlight.
  • A Apple revisa todo app da App Store. Você mesmo envia o app para revisão.
  • O Codex pode errar. Você decide o que vai ao ar.
  • Nós fornecemos o Mac e o arquivo. Não criamos o seu app.

Quanto custa

Um Mac para agentes da MacRun custa $169 por mês, com Xcode 27.1 e Codex instalados. Ele nunca entra em repouso, então o Codex continua trabalhando com o seu computador desligado. O seu plano do ChatGPT paga o Codex. O Apple Developer Program custa 99 USD por ano, e só é necessário para o TestFlight e a App Store.

Quem não deveria alugar um Mac para isso

Se você já tem um Mac, use ele. O mesmo arquivo funciona lá. Se você quer um app sem nenhum código, uma ferramenta no-code pode servir melhor. Para outros caminhos, leia como desenvolver apps iOS sem Mac.

Perguntas frequentes

Dá para criar um app iOS sem Mac usando um agente de IA?

+

O agente escreve o código em qualquer lugar, mas compilar e rodar um app iOS exige o Xcode, que só roda no macOS. Alugue um Mac, rode o Codex nele, e o agente consegue compilar, rodar o simulador e conferir o próprio trabalho.

O que é o AGENTS.md?

+

Um arquivo de texto simples com instruções que o Codex lê antes de cada tarefa. Um arquivo em ~/.codex/AGENTS.md vale para todos os projetos. Um arquivo na pasta de um projeto vale para aquele projeto. O nosso diz ao Codex como criar, compilar, testar e enviar um app iOS num Mac.

Vocês testaram este AGENTS.md?

+

Testamos os passos 1 a 3 num dos nossos Macs M6 em 14 de novembro de 2026. Usamos XcodeGen 2.46, Xcode 27.1 e o simulador do iPhone 17. O passo do TestFlight ainda não foi rodado de ponta a ponta. Ele segue o fluxo do xcodebuild que a Apple documenta para envios com uma chave de API do App Store Connect.

Preciso de uma conta Apple Developer?

+

Não para compilar e rodar o app no simulador. Você precisa do Apple Developer Program, 99 USD por ano, para usar o TestFlight no seu iPhone. Você também precisa dele para publicar na App Store.

Posso testar o app no meu próprio iPhone?

+

Sim, pelo TestFlight. O Codex arquiva e envia uma build de teste, e você instala pelo app TestFlight. Não dá para ligar o seu iPhone num Mac remoto.

O Codex precisa da senha do meu Apple ID?

+

Não. O arquivo diz ao Codex para nunca pedir a senha. A assinatura e os envios usam uma chave de API do App Store Connect, que você mesmo cria e coloca no Mac.

Guias relacionados