Membuat aplikasi iOS tanpa Mac, dengan Codex di Mac sewaan
Anda bisa membuat aplikasi iPhone sungguhan tanpa punya Mac. Sewa sebuah Mac, lalu biarkan Codex mengerjakan bagian Mac untuk Anda. Codex adalah agen coding dari OpenAI. Sebelum mulai, Codex membaca file bernama AGENTS.md. Kami menulis satu file yang menjelaskan kepada Codex cara persis Mac membuat aplikasi iOS. Kami menguji tiga langkah pertamanya di salah satu Mac kami pada 14 November 2026. Halaman ini menjelaskan setiap langkah dan memberi Anda file lengkapnya.
Kenapa Anda tetap butuh Mac
Codex bisa menulis Swift di komputer apa pun. Tetapi hanya Mac yang bisa melakukan build aplikasi iOS. Xcode, simulator, dan alat signing dari Apple hanya jalan di macOS. Tanpa itu, Codex menulis kode yang tidak pernah bisa ia jalankan atau lihat. Dengan itu, Codex bisa melakukan build, membuka aplikasi di simulator, mengambil screenshot, dan memeriksa hasil kerjanya sendiri. Halaman kami tentang kenapa agen coding iOS butuh Mac membahasnya lebih dalam.
Yang Anda butuhkan
- Mac yang bisa Anda jangkau dari komputer Anda. Mac MacRun adalah Mac mini M6 khusus di fasilitas privat kami sendiri di New Jersey. Mac ini datang dengan Xcode 27.1 dan Homebrew. Di paket agen, Codex juga sudah terpasang.
- Akun ChatGPT. Codex login dengan akun ini. Batas pemakaian paket Anda tetap berlaku.
- Akun Apple Developer, nanti saja. Anda hanya membutuhkannya untuk memasang aplikasi di iPhone Anda sendiri atau di App Store. Biayanya 99 USD per tahun. Langkah simulator tidak butuh akun.
- Tidak perlu pengalaman Xcode. File ini meminta Codex menjelaskan setiap langkah dengan kata-kata sederhana dan menunjukkan screenshot kepada Anda.
Apa fungsi AGENTS.md
AGENTS.md adalah file teks biasa berisi instruksi. Codex membacanya sebelum setiap tugas. File di ~/.codex/AGENTS.md berlaku untuk semua proyek Anda. File di dalam folder proyek berlaku untuk proyek itu.
File kami memberi tahu Codex empat hal:
- Apa saja yang terpasang di Mac, dan cara memeriksanya.
- Aturannya. Simpan setiap aplikasi di repo git sendiri. Jangan pernah menaruh key atau password di git. Jangan pernah meminta password Apple ID Anda. Periksa hasil kerja sebelum bilang semuanya berfungsi.
- Perintah persis untuk membuat, build, menjalankan, dan menguji aplikasi.
- Cara mengunggah build uji ke TestFlight dengan API key Anda.
Langkah 0: taruh filenya
Buka Terminal di Mac, atau sambungkan lewat SSH. Unduh file ke folder Codex, lalu jalankan Codex. Jika Codex belum terpasang, pasang dulu dengan 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
Pertama kali, pilih Sign in with ChatGPT. Proses login membuka browser di Mac. Anda bisa menyelesaikannya dari desktop Mac di browser Anda.
Langkah 1: jelaskan aplikasinya, dan biarkan Codex membuatnya
File proyek Xcode sulit ditulis dengan tangan, baik oleh orang maupun oleh agen. Karena itu file kami meminta Codex memakai XcodeGen. Codex menulis project.yml yang pendek, lalu XcodeGen mengubahnya menjadi proyek Xcode sungguhan. Codex memasang XcodeGen dengan Homebrew saat dibutuhkan.
Lalu katakan kepada Codex apa yang Anda mau, dengan kata-kata Anda sendiri. Contohnya:
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 akan meminta reverse domain milik Anda, seperti com.namaanda. Itu menjadi awal dari bundle ID aplikasi.
Langkah 2: build, jalankan, dan ambil screenshot
Inilah siklus yang membuat agen berguna di iOS. Codex melakukan build, menyalakan simulator, memasang aplikasi, dan mengambil screenshot. Lalu Codex melihat gambarnya. Jika tata letaknya rusak, Codex melihatnya dan memperbaikinya sebelum Anda sempat melihat.
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
Anda tidak perlu mengetik perintah ini. Codex menjalankannya untuk Anda. Perintah ini ada di sini supaya Anda tahu apa yang sedang ia kerjakan.
Langkah 3: jalankan tes
Proyek ini punya target tes sejak awal. Minta Codex menambahkan tes untuk setiap fitur. Codex menjalankan semuanya dengan satu perintah:
xcodebuild test -scheme Tally \ -destination "platform=iOS Simulator,name=iPhone 17" -derivedDataPath build
Apa yang terjadi saat kami mengujinya
Pada 14 November 2026, kami menjalankan langkah 1 sampai 3 di salah satu Mac M6 kami. Kami memakai XcodeGen 2.46, Xcode 27.1, dan simulator iPhone 17. Proyek berhasil dibuat, aplikasi berhasil di-build dan jalan, screenshot muncul, dan semua tes lulus. Lalu kami menulis langkah-langkahnya persis seperti yang berhasil. Hasilnya adalah file ini.
Langkah 4: pasang di iPhone Anda dengan TestFlight
Mac remote tidak bisa melihat iPhone di dekat Anda. Anda tidak bisa mencolokkan ponsel ke Mac itu. TestFlight adalah cara memasang aplikasi di ponsel Anda. Anda butuh Apple Developer Program untuk langkah ini.
- Buat aplikasinya di App Store Connect, dengan bundle ID yang sama.
- Buat API key App Store Connect dengan peran App Manager. Unduh file .p8 sekali saja dan taruh di Mac, di ~/.appstoreconnect/private_keys/.
- Berikan kepada Codex key ID, issuer ID, dan Team ID Anda.
- Minta Codex mengunggah build uji. Codex membuat arsip aplikasi dan mengunggahnya dengan xcodebuild dan key Anda.
- Pasang build itu dari aplikasi TestFlight di iPhone Anda.
Codex tidak pernah butuh password Apple ID Anda. Key yang mengurus signing dan unggahan. Supaya jelas, kami belum menjalankan langkah ini dari awal sampai akhir di armada kami, karena langkah ini butuh akun developer. Langkah ini mengikuti alur xcodebuild yang didokumentasikan Apple untuk unggahan dengan API key. Panduan publikasi kami membahas App Store Connect lebih detail.
Langkah 5: otomatiskan, jika Anda mau
- Unggah di setiap push. Runner GitHub Actions bisa jalan di Mac yang sama. Lihat panduan self-hosted runner kami.
- Jalankan tugas sesuai jadwal. Sebuah LaunchAgent bisa menjalankan
codex execdengan sebuah tugas pada jam tertentu dan mencatat hasilnya. File kami meminta Codex menunjukkan cara mematikannya.
AGENTS.md lengkap
Salin dari sini, atau unduh AGENTS.md. File ini ditulis untuk Mac MacRun. Di Mac lain, ubah baris-baris pertamanya sesuai apa yang terpasang di sana.
# 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.
Tips bekerja dengan Codex untuk sebuah aplikasi
- Minta satu perubahan kecil setiap kali. Lihat screenshot setelah setiap perubahan.
- Biarkan Codex melakukan commit setelah setiap langkah yang berhasil. Jadi perubahan yang buruk mudah dibatalkan.
- Push repo ke GitHub, supaya kode Anda juga tersimpan di luar Mac.
- Jangan pernah menempelkan key atau password ke chat. Taruh sendiri file .p8 di Mac.
- Jika ada yang terlihat salah, katakan apa yang Anda lihat. Codex bisa mengambil screenshot lagi.
Yang tidak bisa dilakukan
- Tidak bisa menguji di ponsel yang dicolokkan ke Mac. Pakai simulator dan TestFlight.
- Apple meninjau setiap aplikasi App Store. Anda sendiri yang mengirim aplikasi untuk ditinjau.
- Codex bisa salah. Anda yang memutuskan apa yang dirilis.
- Kami menyediakan Mac dan filenya. Kami tidak membuatkan aplikasi Anda.
Berapa biayanya
Mac agen MacRun harganya $169 per bulan, dengan Xcode 27.1 dan Codex sudah terpasang. Mac ini tidak pernah tidur, jadi Codex bisa terus bekerja saat komputer Anda sendiri mati. Paket ChatGPT Anda membayar Codex. Apple Developer Program harganya 99 USD per tahun, dan hanya dibutuhkan untuk TestFlight dan App Store.
Siapa yang tidak perlu menyewa Mac untuk ini
Jika Anda sudah punya Mac, pakai saja. File yang sama juga berfungsi di sana. Jika Anda mau aplikasi tanpa kode sama sekali, builder no-code mungkin lebih cocok. Untuk cara lain, baca mengembangkan aplikasi iOS tanpa Mac.
Pertanyaan yang sering diajukan
Bisakah saya membuat aplikasi iOS tanpa Mac dengan agen AI?
+
Agen bisa menulis kode di mana saja, tetapi build dan menjalankan aplikasi iOS butuh Xcode, yang hanya jalan di macOS. Sewa Mac, jalankan Codex di sana, dan agen bisa melakukan build, menjalankan simulator, dan memeriksa hasil kerjanya sendiri.
Apa itu AGENTS.md?
+
File teks biasa berisi instruksi yang dibaca Codex sebelum setiap tugas. File di ~/.codex/AGENTS.md berlaku untuk semua proyek. File di folder proyek berlaku untuk proyek itu. File kami memberi tahu Codex cara membuat, build, menguji, dan mengunggah aplikasi iOS di Mac.
Apakah AGENTS.md ini sudah kalian uji?
+
Kami menguji langkah 1 sampai 3 di salah satu Mac M6 kami pada 14 November 2026. Kami memakai XcodeGen 2.46, Xcode 27.1, dan simulator iPhone 17. Langkah TestFlight belum dijalankan dari awal sampai akhir. Langkah itu mengikuti alur xcodebuild yang didokumentasikan Apple untuk unggahan dengan API key App Store Connect.
Apakah saya butuh akun Apple Developer?
+
Tidak untuk build dan menjalankan aplikasi di simulator. Anda butuh Apple Developer Program, 99 USD per tahun, untuk TestFlight di iPhone Anda. Anda juga membutuhkannya untuk merilis di App Store.
Bisakah saya menguji aplikasi di iPhone saya sendiri?
+
Bisa, lewat TestFlight. Codex membuat arsip dan mengunggah build uji, lalu Anda memasangnya dari aplikasi TestFlight. Anda tidak bisa mencolokkan iPhone ke Mac remote.
Apakah Codex butuh password Apple ID saya?
+
Tidak. File kami meminta Codex untuk tidak pernah memintanya. Signing dan unggahan memakai API key App Store Connect, yang Anda buat dan taruh sendiri di Mac.