Руководство

iOS-приложение без Mac: Codex на арендованном Mac

Настоящее приложение для iPhone можно сделать и без своего Mac. Арендуйте Mac, и пусть Codex сделает на нём всю работу. Codex это агент OpenAI для написания кода. Перед началом работы он читает файл AGENTS.md. Мы написали такой файл. Он точно объясняет Codex, как на Mac собирают iOS-приложения. Первые три шага мы проверили на одном из наших Mac 14 ноября 2026 года. На этой странице мы разбираем каждый шаг и даём файл целиком.

Зачем всё равно нужен Mac

Codex пишет код на Swift на любом компьютере. Но собрать iOS-приложение может только Mac. Xcode, симулятор и инструменты подписи Apple работают только на macOS. Без них Codex пишет код, который не может ни запустить, ни увидеть. С ними он собирает приложение, открывает его в симуляторе, делает скриншот и сам проверяет свою работу. Подробнее читайте на странице почему ИИ-агенту для iOS нужен Mac.

Что понадобится

  • Mac, к которому можно подключиться со своего компьютера. Mac от MacRun это выделенный Mac mini на M6 на нашей собственной частной площадке в Нью-Джерси. На нём уже есть Xcode 27.1 и Homebrew. На тарифе для агентов установлен и Codex.
  • Аккаунт ChatGPT. Codex входит через него. Действуют лимиты вашего тарифа.
  • Аккаунт Apple Developer, но позже. Он нужен, только чтобы поставить приложение на свой iPhone или выложить в App Store. Он стоит 99 USD в год. Для шагов в симуляторе аккаунт не нужен.
  • Опыт с Xcode не нужен. Файл просит Codex объяснять каждый шаг простыми словами и показывать скриншот.

Что делает AGENTS.md

AGENTS.md это обычный текстовый файл с инструкциями. Codex читает его перед каждой задачей. Файл ~/.codex/AGENTS.md действует для всех ваших проектов. Файл в папке проекта действует только для этого проекта.

Наш файл сообщает Codex четыре вещи:

  • Что установлено на Mac и как это проверить.
  • Правила. Каждое приложение живёт в своём git-репозитории. Никаких ключей и паролей в git. Никогда не спрашивать пароль от Apple ID. Проверять работу, прежде чем говорить, что всё работает.
  • Точные команды, чтобы создать, собрать, запустить и протестировать приложение.
  • Как загрузить тестовую сборку в TestFlight с вашим API-ключом.

Шаг 0: положите файл на место

Откройте Терминал на Mac или подключитесь по SSH. Скачайте файл в папку Codex и запустите Codex. Если Codex не установлен, сначала установите его через 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

При первом запуске выберите Sign in with ChatGPT. Вход откроет браузер на Mac. Завершить его можно на рабочем столе Mac, открытом в вашем браузере.

Шаг 1: опишите приложение, и Codex его создаст

Файл проекта Xcode трудно написать вручную, и людям, и агентам. Поэтому файл просит Codex использовать XcodeGen. Codex пишет короткий project.yml, а XcodeGen превращает его в настоящий проект Xcode. Codex сам ставит XcodeGen через Homebrew, когда он нужен.

Потом скажите Codex своими словами, что вы хотите. Например:

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 спросит ваш обратный домен, например com.yourname. С него начнётся bundle ID приложения.

Шаг 2: сборка, запуск и скриншот

Именно этот цикл делает агента полезным для iOS. Codex собирает приложение, запускает симулятор, устанавливает приложение и делает скриншот. Потом он смотрит на картинку. Если вёрстка сломалась, он это видит и исправляет раньше вас.

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

Вводить это вам не нужно. Codex выполняет команды сам. Они здесь, чтобы вы понимали, что он делает.

Шаг 3: запустите тесты

В проекте с самого начала есть тестовая цель. Попросите Codex добавлять тест для каждой функции. Он запускает все тесты одной командой:

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

Что получилось в нашей проверке

14 ноября 2026 года мы прошли шаги с 1 по 3 на одном из наших Mac на M6. Мы использовали XcodeGen 2.46, Xcode 27.1 и симулятор iPhone 17. Проект создался, приложение собралось и запустилось, скриншот пришёл, тесты прошли. Потом мы записали шаги в том виде, в каком они сработали. Так и появился этот файл.

Шаг 4: поставьте приложение на iPhone через TestFlight

Удалённый Mac не видит iPhone, который лежит рядом с вами. Подключить к нему телефон кабелем нельзя. Чтобы приложение попало на телефон, используйте TestFlight. Для этого шага нужна Apple Developer Program.

  • Создайте приложение в App Store Connect с тем же bundle ID.
  • Создайте API-ключ App Store Connect с ролью App Manager. Файл .p8 скачивается только один раз. Положите его на Mac в ~/.appstoreconnect/private_keys/.
  • Дайте Codex ID ключа, ID издателя (issuer ID) и ваш Team ID.
  • Попросите Codex загрузить тестовую сборку. Он архивирует приложение и загружает его через xcodebuild с вашим ключом.
  • Установите сборку из приложения TestFlight на iPhone.

Пароль от Apple ID Codex не нужен. Подпись и загрузку делает ключ. Скажем честно: этот шаг целиком мы на своих Mac ещё не проходили, потому что для него нужен аккаунт разработчика. Он следует описанному Apple порядку загрузки через xcodebuild с API-ключом. Подробнее про App Store Connect читайте в нашем руководстве по публикации.

Шаг 5: автоматизируйте, если хотите

  • Загрузка при каждом push. Раннер GitHub Actions может работать на том же Mac. Смотрите наше руководство по self-hosted раннеру.
  • Задача по расписанию. LaunchAgent может запускать codex exec с задачей в заданное время и записывать результат в лог. Файл просит Codex показать вам, как это выключить.

Полный AGENTS.md

Скопируйте его отсюда или скачайте AGENTS.md. Он написан для Mac от MacRun. На другом Mac поправьте первые строки под то, что там установлено.

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

Советы по работе с Codex над приложением

  • Просите по одному небольшому изменению. После каждого смотрите скриншот.
  • Пусть Codex делает коммит после каждого рабочего шага. Тогда неудачное изменение легко отменить.
  • Отправьте репозиторий на GitHub, чтобы код хранился не только на Mac.
  • Никогда не вставляйте ключи и пароли в чат. Файл .p8 положите на Mac сами.
  • Если что-то выглядит не так, опишите, что видите. Codex может сделать ещё один скриншот.

Чего это не сделает

  • Тестировать на телефоне, подключённом к Mac, нельзя. Используйте симулятор и TestFlight.
  • Apple проверяет каждое приложение в App Store. На проверку вы отправляете приложение сами.
  • Codex может ошибаться. Что выпускать, решаете вы.
  • Мы даём Mac и файл. Ваше приложение мы не делаем.

Сколько это стоит

Mac для агентов от MacRun стоит $169 в месяц, Xcode 27.1 и Codex уже установлены. Он никогда не засыпает, так что Codex работает, даже когда ваш компьютер выключен. Codex оплачивается вашим тарифом ChatGPT. Apple Developer Program стоит 99 USD в год и нужна только для TestFlight и App Store.

Кому не стоит арендовать Mac для этого

Если у вас уже есть Mac, работайте на нём. Тот же файл подойдёт и там. Если вам нужно приложение совсем без кода, вам может больше подойти no-code конструктор. О других путях читайте в руководстве как разрабатывать iOS-приложения без Mac.

Частые вопросы

Можно ли сделать iOS-приложение без Mac с помощью ИИ-агента?

+

Код агент может писать где угодно. Но чтобы собрать и запустить iOS-приложение, нужен Xcode, а он работает только на macOS. Арендуйте Mac и запустите на нём Codex. Тогда агент сможет собирать приложение, запускать симулятор и сам проверять свою работу.

Что такое AGENTS.md?

+

Обычный текстовый файл с инструкциями, который Codex читает перед каждой задачей. Файл ~/.codex/AGENTS.md действует для всех проектов. Файл в папке проекта действует для этого проекта. Наш файл объясняет Codex, как создать, собрать, протестировать и загрузить iOS-приложение на Mac.

Вы проверяли этот AGENTS.md?

+

Шаги с 1 по 3 мы проверили на одном из наших Mac на M6 14 ноября 2026 года. Мы использовали XcodeGen 2.46, Xcode 27.1 и симулятор iPhone 17. Шаг с TestFlight целиком ещё не проходили. Он следует описанному Apple порядку загрузки через xcodebuild с API-ключом App Store Connect.

Нужен ли аккаунт Apple Developer?

+

Чтобы собрать и запустить приложение в симуляторе, не нужен. Apple Developer Program за 99 USD в год нужна для TestFlight на вашем iPhone. Она же нужна для публикации в App Store.

Можно ли протестировать приложение на своём iPhone?

+

Да, через TestFlight. Codex архивирует и загружает тестовую сборку, а вы ставите её из приложения TestFlight. Подключить iPhone к удалённому Mac кабелем нельзя.

Нужен ли Codex мой пароль от Apple ID?

+

Нет. Файл запрещает Codex его спрашивать. Подпись и загрузка идут через API-ключ App Store Connect. Вы сами создаёте его и кладёте на Mac.

Похожие руководства