Быстрый старт с Adapty Developer CLI

Adapty CLI позволяет настроить конфигурацию приложения полностью из командной строки. Используйте его как альтернативу быстрому старту через дашборд, если предпочитаете работу в терминале или MCP-клиенты.

По завершении ваше приложение, уровень доступа, продукт, пейвол и плейсмент будут видны в дашборде Adapty. Если вы запускаете CLI в Claude Cowork, разрешите домены Adapty перед началом работы — см. Запуск CLI в Cowork.

1. Установите CLI

Требуется Node.js версии 18 или выше.

Чтобы установить CLI, выполните команду:

npm install -g adapty

Или напрямую:

npx adapty auth login

2. Авторизация

Выполните команду входа, чтобы связать CLI с вашим аккаунтом Adapty.

adapty auth login

CLI откроет вкладку в браузере. Сверьте код, отображаемый в терминале, с кодом в браузере, затем нажмите Authorize. Терминал подтвердит успешную аутентификацию.

3. Создайте приложение

Приложение в Adapty — это ваше мобильное приложение. Одно приложение в Adapty подключается к App Store и Google Play одновременно — достаточно создать одно, сколько бы сторов вы ни использовали.

adapty apps create --title "My App" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

adapty apps create --title "My App" --platform android --google-bundle-id com.example.app

Команда возвращает <app-id>. Используйте этот ID во всех последующих командах.

4. Создайте уровень доступа (необязательно)

Уровни доступа определяют, к чему пользователь получает доступ после покупки. Вместо того чтобы проверять, купил ли пользователь конкретный продукт, приложение проверяет наличие нужного уровня доступа. Это отвязывает логику приложения от конкретных ID продуктов.

Уровень доступа premium создаётся автоматически при добавлении каждого нового приложения. Для большинства приложений этот шаг можно пропустить. Используйте premium в качестве ID уровня доступа на шаге 5. Выполняйте эту команду только в том случае, если разные продукты открывают разные функции для разных групп пользователей — например, если подписчик «Basic» и подписчик «Pro» получают доступ к разным частям приложения.

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

• --sdk-id — это идентификатор, который вы будете использовать в коде приложения, чтобы проверить, должна ли функция быть доступна пользователю (например, if user.hasAccessLevel("pro")). Если пропустить этот шаг и использовать уровень доступа по умолчанию, его --sdk-id равен premium.
• --title — отображаемое название для вашего удобства в дашборде Adapty.

Команда возвращает <access-level-id>.

5. Создайте продукт

В Adapty продукт — это всё, что ваше приложение продаёт: подписка или разовая покупка. Позиции из App Store Connect и Google Play можно объединить в один продукт Adapty и управлять ими из одного места.

Вам понадобятся идентификаторы продукта из каждого стора: Apple product ID из App Store Connect, а также Android product ID и base plan ID из Google Play Console. Подробнее о том, где их найти, читайте в разделе Продукты. Если вы пропустили шаг 4, используйте default_access_level.id, возвращённый командой apps create на шаге 3, в качестве <access-level-id>.

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id> --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

Команда возвращает <product-id>.

Если вы также продаёте этот продукт в вебе через Stripe или Paddle, добавьте эти ID в ту же команду. Подробнее см. products create в справочнике команд.

6. Создайте пейвол

Пейвол — это контейнер, в котором хранятся ваши продукты. В Adapty пейволы — единственный способ доставить продукты пользователям. Каждый продукт должен быть добавлен в пейвол, прежде чем он сможет отображаться в приложении.

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id>

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id-1> --product-id <product-id-2>

Команда возвращает <paywall-id>.

7. Создайте плейсмент

Плейсмент — это точка в приложении, где показывается пейвол. Единственное, что вы жёстко прописываете в коде, — это ID плейсмента. Всё остальное — какой пейвол показывать и каким пользователям — управляется в дашборде без выпуска новой версии приложения.

--developer-id — строка, на которую вы будете ссылаться в коде приложения, когда запрашиваете у Adapty, какой пейвол показать в этой точке. Выбирайте что-то, отражающее местоположение, например "main", "onboarding" или "settings".

adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

Флаг --audiences определяет, какой пейвол показывается каким пользователям. В примере выше задана одна дефолтная аудитория — все пользователи на этом плейсменте видят один и тот же пейвол.

Запуск CLI в Cowork

Claude Cowork выполняет команды в песочнице, которая обращается только к разрешённым доменам. Пока вы не добавите Adapty в список разрешённых, CLI не сможет войти в аккаунт или обращаться к вашим данным. Пропустите этот раздел, если запускаете CLI из собственного терминала.

Добавьте в список разрешённых оба домена: adapty.io и *.adapty.io. В большинстве реализаций вайлдкард не распространяется на корневой домен. Сам CLI обращается к api.adapty.io, а агент, который читает документацию Adapty в процессе работы, — к корневому домену.

Cowork applies these settings when a task starts. If you change the access mode or add a domain during a conversation, that conversation keeps the settings it started with — start a new task.

A task also starts on a clean machine: no CLI, no token, and no config carries over from a previous session, so the install and login steps repeat at the start of each one.

Персональные аккаунты

Список разрешённых доменов вы настраиваете самостоятельно:

1. В Claude откройте Settings → Capabilities.
2. Включите Code execution and file creation. Блок Allow network egress будет скрыт, пока вы этого не сделаете.
3. Включите Allow network egress.
4. В Domain allowlist выберите Package managers only.
5. В разделе Additional allowed domains добавьте adapty.io, затем *.adapty.io.

Другой режим доступа, All domains, разрешает песочнице обращаться к любым сайтам. При его выборе домены Adapty добавлять не нужно.

Корпоративные рабочие пространства

Доступом управляет администратор. Попросите его добавить оба домена для рабочего пространства.

Что дальше

Все сущности теперь видны в дашборде Adapty. Следующие шаги:

• Оформите пейвол — используйте Paywall Builder без написания кода, чтобы добавить визуальное оформление, разметку и тексты к только что созданному пейволу.
• Интегрируйте SDK — подключите SDK к приложению, чтобы получать и отображать плейсмент.
• Направляйте разные сегменты пользователей на разные пейволы — см. placements update и segments list в справочнике команд.