Как сделать iOS-приложение с Claude Code. Проект, симулятор, навыки и задания

Что нужно до начала

Claude Code работает в терминале или в программе Claude для Мака, а iOS-приложение собирает Xcode. Поэтому нужны Мак, Xcode и подписка Claude с доступом к Claude Code.

Что	Требование на 16.10.2026
Claude Code	macOS 13 и новее, от 4 ГБ памяти. Ставится командой curl -fsSL https://claude.ai/install.sh | bash или через Homebrew
Подписка	Pro за $20 в месяц или $17 при оплате за год, Max за $100 или $200. На бесплатном тарифе Claude Code нет
Xcode	Xcode 26.3 последний, что ставится на macOS Sequoia 15.6. Xcode 27 требует macOS Tahoe 26.6 и Мак на Apple M
Аккаунт Apple Developer	$99 в год, нужен для TestFlight и публикации, не для первых сборок

По документации Claude Code, ценам Claude и таблице версий Xcode, проверено 16.10.2026.

России нет в списке стран Anthropic, который действует с 12 мая 2026 года (anthropic.com). Учтите это до того, как платить за остальное.

Первый проект, от пустой папки до симулятора

1. Папка и Git. Создайте пустую папку, сделайте в ней git init и запустите claude. Git нужен, чтобы откатить неудачную правку.
2. Проект Xcode. Попросите агента создать проект SwiftUI для iPhone. Удобнее, когда проект описан текстовым файлом и собирается программой XcodeGen. Агенту проще менять настройки в тексте, чем в файле проекта Xcode.
3. CLAUDE.md. Команда /init пишет стартовый файл с правилами проекта. Его стоит сразу дополнить, пример ниже.
4. План первой версии. Включите режим плана сочетанием Shift+Tab. Claude опишет экраны и порядок работы и не тронет код, пока вы не одобрите план.
5. Первый экран. Попросите собрать проект для симулятора, запустить и прислать снимок. Если на снимке то, что вы просили, сохраните коммит и переходите к следующему экрану.

Первую версию держите на пяти экранах. Как её описать агенту, разобрано в статье «Как описать приложение ИИ-агенту».

Как Claude Code видит симулятор

Claude Code видит приложение через снимки экрана. Он собирает проект, ставит его в симулятор, запускает и делает снимок, а потом смотрит на картинку и правит код. Способов три.

• Команды Xcode в терминале. xcodebuild собирает проект, xcrun simctl включает симулятор, ставит и запускает приложение, делает снимок и переключает тёмную тему. Так работают все наши приложения.
• Панель симулятора в программе Claude. В программе Claude для Мака есть панель iOS Simulator, пока в режиме предварительного доступа. До четырёх устройств, Claude сам нажимает на экран и делает снимки. Нужен тариф Pro, Max, Team или Enterprise, настоящий iPhone панель не поддерживает (документация, 16.10.2026).
• Инструменты самого Xcode. С Xcode 26.3 к Claude Code можно подключить инструменты Xcode командой xcrun mcpbridge. Агент собирает проект, запускает тесты и получает снимки SwiftUI Preview, пока проект открыт в Xcode (Apple).

Есть и открытые инструменты. MobileBuildMCP от Sentry, бывший XcodeBuildMCP, собирает и запускает приложения в симуляторе, у него 6 486 звёзд на GitHub (GitHub, 17.10.2026).

CLAUDE.md и навыки для iOS

CLAUDE.md это файл с правилами проекта, который Claude Code читает в начале каждой работы. Anthropic советует держать его короче 200 строк (документация). Для iPhone-приложения в нём полезны четыре блока.

# Проект
Нативное приложение для iPhone на SwiftUI, iOS 18 и новее.
Без сторонних библиотек, если я не попросил.

# Сборка
После каждой правки собирай для симулятора iPhone 17 Pro
и присылай снимок экрана, который менял.

# Новые возможности iOS
Перед Liquid Glass, StoreKit и Foundation Models читай
документацию из Xcode, а не по памяти.

# Git
Рабочую версию сохраняй коммитом после каждого экрана.

Третий блок важнее, чем кажется. Модели плохо знают новые возможности последних версий iOS и уверенно пишут вызовы, которых нет. А Xcode хранит документацию для своего помощника прямо внутри программы. В Xcode 27.0 это 20 файлов Markdown, среди них Liquid Glass для SwiftUI и UIKit, обновления StoreKit и работа с Foundation Models (папка AdditionalDocumentation внутри Xcode, проверено на нашем Маке 17.10.2026). Укажите агенту этот путь.

Повторяющиеся действия выносят в навыки. Навык это папка .claude/skills/имя/ с файлом SKILL.md, Claude подключает его сам, когда он к месту, или по команде /имя (документация). Для iOS навык обычно описывает сборку и проверку экранов. Официальный плагин swift-lsp показывает агенту ошибки компиляции сразу после каждой правки, ставится командой /plugin install swift-lsp@claude-plugins-official (документация).

Ошибки, на которых мы теряли сборки

Claude Code пишет рабочий SwiftUI, но некоторые ошибки повторяет и не замечает сам. Вот четыре из наших приложений, с датами.

• Папка Resources. 20 августа 2026 года в приложении «Продам планету» папка с главами книги называлась Resources, и подпись сборки падала с ошибкой про соседний файл. Ушло около четырёх сборок, пока не выяснилось, что программа подписи принимает такую папку за часть приложения для Мака. Назовите папку иначе.
• Рывки в прокрутке. 22 августа 2026 года в пасьянсе Solitaire Collection прокрутка уроков дёргалась. Причина в модификаторах .shadow, .clipShape и .mask на блоках с содержимым, они перерисовывают всё внутри на каждом кадре. Симулятор этого не показывает, видно только на телефоне.
• Шторка вместо экрана. В IQ-тесте Matriq тренировка открывалась пустой шторкой, которую нельзя закрыть. Шторку показывали флагом, а данные читали из соседнего состояния. Исправление 17 августа 2026 года передаёт данные вместе со шторкой.
• Чужой rsync. 2 октября 2026 года выгрузка сборки в App Store Connect стала падать с ошибкой Copy failed. Xcode брал rsync 3.5.1 из Homebrew вместо системного. Помогает запуск выгрузки с системным путём.

От сборки до App Store

Когда пять экранов работают на симуляторе и на вашем iPhone, Claude Code собирает архив и загружает его в App Store Connect. Дальше TestFlight для нескольких человек, страница в App Store, покупки и отправка на проверку. Все восемь шагов разобраны в статье «Как опубликовать приложение в App Store».

Всё вокруг кода Claude Code делает только по вашим заданиям. Appto работает на том же Claude Code по вашей подписке и добавляет остальное. До кода она проверяет нишу по живым данным App Store, потом рисует экраны живыми макетами, сама проходит каждый экран на симуляторе, делает кадры и тексты страницы на всех языках и заполняет App Store Connect, перед каждой записью спрашивая «да». Чем это отличается от работы с одним Claude Code, мы сравнили на странице «Appto и Claude Code».