Приложения и Claude Code - учим Claude Code работать с IOS приложением

Claude Code живёт в терминале. У него нет глаз, чтобы увидеть ваш UI, и нет рук, чтобы потыкать кнопки в симуляторе. Но три инструмента это исправляют — и превращают текстового агента в полноценного QA-инженера для iOS.

Канал с гайдами и контентом по claude code, выкладываем новости (когда режут лимиты в 10 раз) и какие инструменты через claude реализуем для проектов, канал: https://t.me/claudedevolper

TL;DR: XcodeBuildMCP даёт Claude Code 76 инструментов для сборки и тестирования iOS-приложений. AXe CLI добавляет тапы, свайпы и чтение accessibility tree. Swift Testing Agent Skill учит писать качественные тесты. Вместе они замыкают цикл: собрать → запустить → протыкать каждый экран → проверить скриншот → починить → повторить.

Когда вы просите Claude Code «протестируй UI», он может написать XCUITest-код. Но он не видит, что получилось. Не знает, билдится ли проект. Не может нажать кнопку в симуляторе и посмотреть, что произойдёт.

Чтобы замкнуть этот цикл, нужны три вещи:

XcodeBuildMCP — MCP-сервер от Sentry (они недавно его купили, 4000+ звёзд на GitHub). Даёт Claude Code 76 инструментов: билд, тесты, управление симуляторами, деплой на устройства, LLDB-дебаг.

Установка:

brew tap getsentry/xcodebuildmcp brew install xcodebuildmcp Copy

Для UI-автоматизации понадобится ещё Facebook IDB:

brew tap facebook/fb brew install idb-companion Copy

Что умеет для тестирования:

Тулы для UI-автоматизации пока в бета-версии, но уже рабочие. Claude видит accessibility tree, находит нужную кнопку, тапает — и делает скриншот, чтобы проверить результат.

AXe — CLI-утилита, которая управляет iOS-симулятором через Apple Accessibility API. Никаких серверов, просто бинарник.

Установка:

brew tap cameroncooke/axe brew install axe Copy

Интеграция с Claude Code как skill:

axe init --client claude Copy

Это создаст skill-файл в ~/.claude/skills, и Claude Code сразу получит инструкции по использованию AXe.

Главная суперсила — describe-ui:

axe describe-ui --udid SIMULATOR_UDID Copy

Возвращает полное дерево accessibility-элементов на экране в JSON. Claude читает его и понимает, что на экране: какие кнопки, поля ввода, лейблы, их accessibility identifier'ы.

Тапы — три способа:

Свайпы и жесты:

Ввод текста:

axe type 'test@example.com' --udid $UDID Copy

Скриншоты:

axe screenshot --output ~/Desktop/current-state.png --udid $UDID Copy

Batch-режим — несколько действий за один вызов:

axe batch --udid $UDID \ --step "tap --id SearchField" \ --step "type 'hello world'" \ --step "key 40" Copy

Batch снижает latency — вместо трёх отдельных вызовов Claude делает один.

Swift Testing Agent Skill от Antoine van der Lee (автора SwiftLee) — agent skill, который учит Claude Code писать тесты на Swift Testing framework вместо устаревшего XCTest.

#expect и #require. Skill кодифицирует best practices из документации Apple и WWDC-сессий.

Что покрывает:

Установка:

Клонируете репозиторий и копируете skill-файл в .claude/skills/ вашего проекта или в глобальные ~/.claude/skills/.

Вот как выглядит реальный workflow, когда все три инструмента подключены.

Шаг 1 — Сборка и запуск:

Claude вызывает XcodeBuildMCP для сборки. Если есть ошибки компиляции — видит их сразу и фиксит.

xcodebuild -project MyApp.xcodeproj -scheme "MyApp" \ -destination "platform=iphonesimulator,id=$UDID" \ -derivedDataPath DerivedData build 2>&1 | head -50 Copy

Шаг 2 — Запуск в симуляторе:

xcrun simctl install $UDID "DerivedData/Build/Products/Debug-iphonesimulator/MyApp.app" xcrun simctl launch $UDID com.myapp.bundle Copy

Шаг 3 — Считываем accessibility tree:

axe describe-ui --udid $UDID Copy

Claude получает JSON со всеми элементами на экране. Видит кнопки, поля, навигацию.

Шаг 4 — Обходим экраны:

Claude читает accessibility tree, тапает по каждому навигационному элементу, делает скриншот, анализирует:

axe tap --label "Профиль" --udid $UDID axe screenshot --output /tmp/profile-screen.png --udid $UDID Copy

Шаг 5 — Заполняем формы:

axe tap --id "emailField" --udid $UDID axe type 'test@example.com' --udid $UDID axe tap --id "submitButton" --udid $UDID axe screenshot --output /tmp/after-submit.png --udid $UDID Copy

Шаг 6 — Проверяем результат:

Claude анализирует скриншот мультимодально. Видит, что форма отправилась, или что появилась ошибка валидации. Может сравнить с предыдущим скриншотом через ImageMagick:

magick compare -metric RMSE before.png after.png null: Copy

Шаг 7 — Пишем тесты на то, что проверили:

На основе ручного прохода Claude генерирует XCUITest или Swift Testing код, который автоматизирует эту проверку навсегда.

Чтобы Claude Code не тратил токены на переоткрытие одного и того же, пропишите в CLAUDE.md:

Кешируйте UDID симулятора — Claude не будет каждый раз искать его через xcrun simctl list.

Если ваше приложение поддерживает deep links, Claude может прыгать на нужный экран напрямую:

xcrun simctl openurl $UDID "myapp://settings/notifications" Copy

Это экономит 3-5 тапов на каждый переход и делает тестирование конкретного экрана быстрым.

Для SwiftUI-вью есть отдельный подход через Swift Snapshot Testing. Claude рендерит вью в изолированном тесте, получает PNG, анализирует визуально и итерирует.

import SnapshotTesting import SwiftUI @testable import MyApp import Testing @Suite("ViewVerificationTests") @MainActor struct ViewVerificationTests { @Test("Verify ProfileView") func profileView() { let view = ProfileView(user: .mock) assertSnapshot( of: view, as: .image(layout: .fixed(width: 390, height: 844)), record: true ) } } Copy

Claude запускает тест, читает сгенерированный PNG, сравнивает с референсом. По опыту Christopher Ney из twocentstudios, больше 3 итераций до вмешательства человека делать не стоит — Claude пока плохо чувствует отступы и цвета на уровне пикселей.

idb_companion конфликтует с Xcode. После обновления Xcode Facebook IDB может сломаться. Лечение — brew reinstall idb-companion. Иногда нужно полностью удалить и поставить заново.

describe-ui не видит кастомные компоненты без accessibility. Если вы не проставили accessibilityIdentifier и accessibilityLabel на своих вью, AXe вернёт пустое дерево или generic-описания. Claude не поймёт, куда тапать. Совет: перед тестированием пройдитесь по ключевым элементам и добавьте .accessibilityIdentifier("loginButton").

Скриншоты симулятора идут в 3x scale. Координаты на скриншоте не совпадают с координатами тапа. Если Claude тапает по координатам со скриншота — промахнётся. Решение из блога twocentstudios: ресайзить скриншот до 1x через magick screenshot.png -resize 33.333% screenshot_1x.png или использовать accessibility ID вместо координат.

UI-автоматизация XcodeBuildMCP в бета. Тулы ui-automation/tap и ui-automation/swipe работают, но могут меняться между версиями. AXe стабильнее для продакшен-использования — у него собственный skill и подробная документация.

Claude бросает неудачные тесты. По наблюдениям из сообщества, если XCUITest падает, Claude иногда удаляет его и пишет новый вместо того, чтобы починить. Пропишите в CLAUDE.md: "Never delete failing tests — fix them."

Snapshot testing не даёт pixel-perfect результат. Claude плохо различает отступы в 8pt и 12pt на скриншоте. Для проверки layout лучше подходит accessibility tree (элемент есть / элемента нет), а snapshot — для общего визуального контроля.

Из трёх инструментов самую большую отдачу даёт связка AXe + describe-ui. Она позволяет Claude Code обойти все экраны приложения, тапнуть по каждому элементу и проверить результат — без единой строчки тестового кода. XcodeBuildMCP нужен для сборки и запуска в симуляторе (без него не обойтись), а Swift Testing Agent Skill окупается, когда вы хотите генерировать тесты, а не просто проводить ручной прогон.

Реалистичные ожидания: Claude Code сможет автоматически пройти по 5-10 экранам, найти очевидные проблемы (сломанная навигация, пустой экран, краш), но не заменит опытного QA с пониманием бизнес-логики. Лучший паттерн — Claude проходит smoke test, вы проверяете edge cases.

brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp brew tap facebook/fb && brew install idb-companion brew tap cameroncooke/axe && brew install axe Copy

axe init --client claude Copy

Собери проект, запусти в симуляторе, пройди по всем табам, на каждом экране сделай describe-ui и скриншот. Если видишь кнопки — тапни и проверь, что происходит. Copy

Канал с гайдами и контентом по claude code, выкладываем новости (когда режут лимиты в 10 раз) и какие инструменты через claude реализуем для проектов, канал: https://t.me/claudedevolper