🎯 О чём этот конспект: Пошаговое руководство по созданию нативного iOS-приложения (таймера фокуса в ретро-стиле) с помощью Claude Code Desktop и модели Claude 3.5 Sonnet / Opus. Рассматривается полный цикл разработки: от структурированного промпта и планирования архитектуры до поддержки StandBy mode, Live Activities, виджетов WidgetKit и деплоя в TestFlight через Xcode.

👤 Кому будет полезно: Вайбкодерам, инди-хакерам и разработчикам без глубокого опыта в Swift, которые хотят быстро создавать нативные мобильные приложения для iPhone с поддержкой системных фич Apple.

✨ Что получите: Готовый воркфлоу разработки iOS-приложений с помощью AI-агента, понимание настройки связки Xcode MCP + Claude Code, шаблоны промптов для архитектурного планирования и инструкцию по доставке билда на физические устройства через TestFlight.

1. Подготовка окружения: связка Claude Code Desktop, Xcode и Model Context Protocol

Контекст: Для полноценной разработки нативных приложений под iOS AI-агенту требуется прямой доступ к инструментам сборки, компилятору и симуляторам Apple. Обычного текстового чата недостаточно: Claude Code Desktop использует Model Context Protocol (MCP), встроенный в Xcode, чтобы автоматически создавать проект, управлять настройками и запускать тесты. Это устраняет необходимость вручную настраивать структуру файлов и зависимости в Swift.

Тайминг: ▶ 00:39, ▶ 04:06

Выгода: Автоматизация 100% рутинной настройки Xcode-проекта и прямое управление процессом компиляции агентом через MCP.

Как применить:

• Шаг 1: Установка базовых инструментов — Загрузите приложение Claude Code Desktop и установите Xcode из Mac App Store (или скачайте актуальную версию с поддержкой нужных симуляторов с developer.apple.com/downloads). Установите приложение TestFlight на ваш iPhone.
• Шаг 2: Настройка аккаунта Apple — Откройте Xcode, перейдите в настройки нажатием сочетания клавиш Cmd + ,. Во вкладке Apple Accounts авторизуйтесь со своим Apple ID (Apple Developer Account).
• Шаг 3: Активация Model Context Protocol (MCP) — В настройках Xcode перейдите во вкладку Intelligence, прокрутите до пункта Model Context Protocol и переключите режим на Always Enabled. Это даст Claude Code права на вызов внутренних инструментов сборки и SDK.

Результат: Окружение настроено для автономной работы AI-агента с компилятором Xcode и симуляторами iOS.

2. Структурированный Plan-режим: создание спецификации и ограничений для AI-агента

Контекст: Генерация сложного нативного приложения без четких ограничений часто приводит к ошибкам компиляции, лишним библиотекам и перегруженной логике. Использование специального режима /plan с максимальным уровнем рассуждений (UltraCode / Max Thinking) и детальным описанием архитектурных рамок позволяет Claude выстроить дорожную карту проекта до написания первой строчки кода.

Тайминг: ▶ 01:13, ▶ 02:18, ▶ 03:36

Выгода: Экономия токенов и времени на отладку; агент сразу закладывает правильную архитектуру SwiftUI, локальное хранение данных и модульную структуру.

Как применить:

• Шаг 1: Инициализация режима планирования — Создайте пустую директорию (например, FocusTime), откройте её в Claude Code Desktop и введите команду:

/plan

• Шаг 2: Передача детального системного промпта — Передайте агенту спецификацию, содержащую целевую аудиторию, основной пользовательский сценарий (User Flow), стилистику интерфейса и технические ограничения (Client-side, Offline-first, Liquid Glass, Swift UI):

I want to build an iPhone application called Focus Time. It's for someone who wants to focus on studying, reading, or a personal project. You name what you're doing, start a timer, and take a short break afterward. 
 
App Specifications:
- Target User: Someone focusing on studying, reading, or personal tasks.
- Main Flow: Start a 25-minute focus session, show large readable timer, allow pause/resume, provide a manual 5-minute break trigger. Include a testing toggle for 25-second sessions.
- Screens: Main Focus Screen and a simple Session History view.
- Design: Large readable timer, one obvious primary action, generous spacing, retro look & feel (70s analog dial inspired), dark mode support, modern Liquid Glass native styling. Subtle elegant animations and haptics.
- Native Features: Live Activities (Dynamic Island & Lock Screen), Home Screen Widgets (Small & Medium), Swift UI framework.
- Constraints: Client-side only. All data and history live strictly on the local device (no external backend/database).
 
Create a complete step-by-step implementation plan and initialize the native Xcode project in this directory.

• Шаг 3: Выбор режима рассуждений — Установите флаг UltraCode (максимальный уровень thinking/reasoning) для этапа первичного планирования и базовой кодогенерации. После подтверждения плана выберите Accept and bypass permissions, чтобы агент приступил к выполнению этапов без постоянных подтверждений каждого действия.

Результат: Сгенерирован структурированный 5-фазный план разработки, и агент инициализировал нативный Xcode-проект с подписанными сертификатами.

3. Фоновая разработка, симуляторы и удаленный мониторинг через Remote Control

Контекст: Сборка iOS-приложения с поддержкой виджетов и Live Activities занимает значительное время (от 30 до 60 минут), так как агент пишет код, компилирует его, запускает UI-тесты и делает скриншоты симуляторов для валидации. Функция Remote Control позволяет отслеживать процесс и передавать команды прямо со смартфона, пока Mac занят сборкой.

Тайминг: ▶ 02:48, ▶ 04:47, ▶ 05:25

Выгода: Полная автономность разработки без необходимости непрерывно находиться перед экраном компьютера.

Как применить:

• Шаг 1: Подключение симулятора к интерфейсу агента — В Claude Code Desktop нажмите Attach Simulator в верхнем правом углу, выберите целевое устройство (например, iPhone или iPhone Duo) и подтвердите доступ. Агент сможет самостоятельно делать скриншоты и тестировать интерфейс.
• Шаг 2: Включение удаленного управления — В терминале Claude Code выполните команду:

/rc

• Шаг 3: Мониторинг со смартфона — Откройте мобильное приложение Claude на вашем смартфоне, перейдите во вкладку Code -> Add Device и подключитесь к активной сессии для контроля процесса сборки.
• Шаг 4: Ручная проверка через Device Hub — По завершении работы агента откройте инструмент управления симуляторами: в Xcode перейдите в меню Xcode -> Open Developer Tool -> Device Hub и запустите собранное приложение для проверки жестов, поворотов экрана и отображения виджетов.

Результат: Приложение успешно скомпилировано, протестировано агентом в симуляторе и готово к установке на физическое устройство.

4. Быстрый запуск на физическом iPhone и итеративное добавление StandBy Mode

Контекст: Симуляторы iOS не способны воспроизвести все нативные условия работы устройства — например, тактильный отклик (Haptics) и режим горизонтального экрана при зарядке (StandBy Mode). Для реализации специфических API Apple эффективнее всего скармливать агенту прямые ссылки на официальную документацию Apple Developer.

Тайминг: ▶ 06:47, ▶ 07:22, ▶ 07:56

Выгода: Исключение галлюцинаций AI относительно сигнатур API Apple за счет предоставления актуальной документации WidgetKit.

Как применить:

• Шаг 1: Быстрое открытие проекта из терминала — В Claude Code нажмите Cmd + J, чтобы открыть терминал, и выполните системную команду запуска проекта:

xed .

• Шаг 2: Первый запуск на физическом iPhone — Подключите iPhone кабелем/по Wi-Fi, выберите его в списке устройств в верхней панели Xcode и нажмите кнопку Play (Cmd + R) для компиляции и установки билда.
• Шаг 3: Добавление режима StandBy через документацию — Скопируйте URL раздела документации Apple по StandBy / WidgetKit и отправьте итеративный запрос агенту:

https://developer.apple.com/documentation/widgetkit
 
This looks great. Please add full support for iOS StandBy mode based on the documentation above. When the user charges their phone and turns it into landscape orientation, they should see the live retro timer with full progress UI matching our current design system.

• Шаг 4: Тестирование StandBy — Скомпилируйте обновленный проект на физический телефон, заблокируйте его, поставьте на горизонтальную зарядку и убедитесь в корректном отображении полноэкранного таймера.

Результат: Приложение поддерживает нативный режим iOS StandBy и отображает кастомный интерфейс таймера при зарядке.

5. Подготовка архива и дистрибуция через TestFlight

Контекст: Чтобы передать приложение тестировщикам, друзьям или клиентам, не требуется публиковать его в открытый App Store — достаточно использовать инфраструктуру TestFlight. Для этого требуется правильная настройка подписи сертификатов (Code Signing) и компиляция общего архива под архитектуру arm64.

Тайминг: ▶ 08:69, ▶ 09:20, ▶ 09:54

Выгода: Быстрая доставка продакшен-бета-версии на устройства без необходимости кабельного подключения и повторной ручной компиляции.

Как применить:

• Шаг 1: Настройка подписи проекта — В Xcode выберите корневой узел проекта Focus Time, перейдите во вкладку Signing & Capabilities, выберите ваш Team и убедитесь, что включен чекбокс Automatically manage signing.
• Шаг 2: Выбор целевой архитектуры — В селекторе устройств выберите Any iOS Device (arm64).
• Шаг 3: Создание архива — В верхнем меню выберите Product -> Archive. Дождитесь завершения сборки.
• Шаг 4: Отправка в App Store Connect — В открывшемся окне Organizer выберите созданный билд, нажмите Distribute App -> выберите App Store Connect -> нажмите Distribute и дождитесь окончания загрузки.
• Шаг 5: Настройка группы тестирования — Перейдите на сайт appstoreconnect.apple.com, откройте вкладку TestFlight, перейдите в раздел Internal Testing, создайте группу (например, Internal), добавьте ваш email в список тестировщиков и привяжите обработанный билд.

Результат: Приложение отправлено в TestFlight, готово к установке на устройства тестировщиков в один клик.

FAQ

В: Обязательно ли иметь Mac для создания приложений по этой методике? О: Да, среда разработки Xcode доступна исключительно на macOS. Скомпилировать нативный код под iOS и отправить билд в TestFlight без Mac (или виртуальной машины macOS) невозможно.

В: Зачем включать Model Context Protocol (MCP) в настройках Xcode? О: MCP позволяет Claude Code напрямую взаимодействовать со встроенными инструментами Apple: собирать проект, читать ошибки компилятора, управлять симуляторами и выполнять тесты без ручного копирования логов пользователем.

В: Что делать, если виджет или Live Activity не обновляются в реальном времени? О: Убедитесь, что для фоновых обновлений в проекте включены соответствующие entitlements (Live Activities в Info.plist), а логика обновления таймера использует системные интервалы WidgetKit TimelineProvider.

В: Можно ли протестировать StandBy Mode в симуляторе Xcode? О: Полноценно проверить отображение режима StandBy можно только на физическом iPhone, подключенном к зарядному устройству в горизонтальном положении.

В: Чем отличается запуск через кнопку Play в Xcode от установки через TestFlight? О: Запуск через Play собирает Debug-версию приложения для локальной отладки. TestFlight устанавливает оптимизированный Production/Release билд, который работает значительно быстрее и ведет себя в точности как приложение из App Store.

В: Сколько времени занимает первичная генерация полноценного приложения с нуля? О: Комплексная генерация архитектуры, UI, нескольких экранов, виджетов и Live Activities занимает в среднем от 40 до 55 минут непрерывной работы агента с симуляторами.

Ресурсы и ссылки

• Claude Code Desktop — десктопное приложение для работы с AI-агентом Claude — упомянут в видео.
• Apple Developer Downloads — страница загрузки бета-версий и актуальных релизов Xcode — https://developer.apple.com/downloads
• Apple Developer Documentation (WidgetKit) — официальная документация по разработке виджетов и StandBy режима под iOS — https://developer.apple.com/documentation/widgetkit
• App Store Connect — панель управления приложениями и дистрибуцией TestFlight — упомянут в видео.

Конспект создан на основе видео «How to Build an iPhone App with Claude Code» канала Diego Builds. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=S4h0TWyjOV0