---
title: "Быстрый старт с Adapty Developer CLI"
description: "Настройте аккаунт Adapty с нуля через Developer CLI — от создания приложения до живого плейсмента, всего за несколько команд."
---

:::link
Используете AI-ассистент? Доступен [навык Adapty CLI](https://github.com/adaptyteam/adapty-cli/tree/main/skills/adapty-cli), который помогает языковым моделям работать с CLI.
:::

Adapty CLI позволяет полностью настроить конфигурацию приложения из командной строки. Используйте его как альтернативу [быстрому старту через дашборд](integrate-payments), если вы предпочитаете терминальные инструменты или [MCP-клиенты](https://github.com/adaptyteam/adapty-cli/tree/main/skills/adapty-cli).

:::note
Подключение Adapty к App Store Connect и Google Play по-прежнему требует однократной настройки в дашборде — это описано в шаге 3.
:::

По завершении ваше приложение, уровень доступа, продукт, пейвол и плейсмент будут отображаться в [дашборде Adapty](https://app.adapty.io).

## 1. Установите CLI \{#1-install-the-cli\}

Требуется [Node.js](https://nodejs.org/en/download) версии 18 или выше.

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

```bash
npm install -g adapty
```

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

```bash
npx adapty auth login
```

## 2. Авторизация \{#2-authenticate\}

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

```bash
adapty auth login
```

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

## 3. Создайте приложение \{#3-create-your-app\}

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

<Tabs>
  <TabItem value="ios-android" label="iOS + Android">
    ```bash
    adapty apps create --title "My App" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app
    ```
  </TabItem>
  <TabItem value="ios" label="iOS only">
    ```bash
    adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app
    ```
  </TabItem>
  <TabItem value="android" label="Android only">
    ```bash
    adapty apps create --title "My App" --platform android --google-bundle-id com.example.app
    ```
  </TabItem>
</Tabs>

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

:::important
Прежде чем продолжить, подключите приложение к App Store Connect и Google Play в дашборде Adapty. Идентификаторы продуктов из обоих сторов понадобятся на шаге 5.

- [Подключить App Store Connect](app-store-connection-configuration)
- [Подключить Google Play](google-play-store-connection-configuration)
:::

## 4. Создайте уровень доступа (необязательно) \{#4-create-an-access-level-optional\}

[Уровни доступа](access-level) определяют, к чему пользователь получает доступ после покупки. Вместо того чтобы проверять, купил ли пользователь конкретный продукт, приложение проверяет наличие определённого уровня доступа. Это позволяет отвязать логику приложения от конкретных идентификаторов продуктов.

Уровень доступа `premium` создаётся автоматически для каждого нового приложения. **Для большинства приложений этот шаг можно пропустить.** Используйте `premium` в качестве идентификатора уровня доступа на шаге 5.

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

```bash
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. Создайте продукт \{#5-create-a-product\}

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

Вам понадобятся идентификаторы продуктов из каждого стора: Apple product ID из App Store Connect, а также Android product ID и base plan ID из Google Play Console. Подробнее о том, где их найти, читайте в разделе [Продукты](quickstart-products).

Если вы пропустили шаг 4, используйте значение `default_access_level.id`, возвращённое командой `apps create` на шаге 3, в качестве `<access-level-id>`.

:::important
Идентификаторы продуктов стора, которые вы привязываете здесь (`--ios-product-id`, `--android-product-id`), нельзя изменить после создания. Чтобы использовать другие идентификаторы, создайте новый продукт.
:::

<Tabs>
  <TabItem value="ios-android" label="iOS + Android">
    ```bash
    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>
    ```
  </TabItem>
  <TabItem value="ios" label="iOS only">
    ```bash
    adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id>
    ```
  </TabItem>
  <TabItem value="android" label="Android only">
    ```bash
    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>
    ```
  </TabItem>
</Tabs>

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

## 6. Создайте пейвол \{#6-create-a-paywall\}

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

:::important
После привязки пейвола к плейсменту его продукты нельзя изменить. Чтобы использовать другие продукты, создайте новый пейвол и обновите плейсмент, чтобы он указывал на него.
:::

<Tabs>
  <TabItem value="single" label="Один продукт">
    ```bash
    adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id>
    ```
  </TabItem>
  <TabItem value="multiple" label="Несколько продуктов">
    ```bash
    adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id-1> --product-id <product-id-2>
    ```
  </TabItem>
</Tabs>

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

## 7. Создайте плейсмент \{#7-create-a-placement\}

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

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

```bash
adapty placements create --app <app-id> --title "Main" --developer-id "main" --paywall-id <paywall-id>
```

## Что дальше \{#whats-next\}

Все сущности теперь отображаются в [дашборде Adapty](https://app.adapty.io). Следующие шаги:

- [Оформите пейвол](adapty-paywall-builder) — используйте Paywall Builder без кода, чтобы добавить визуальные элементы, разметку и тексты к только что созданному пейволу.
- [Интегрируйте Adapty SDK](quickstart-sdk) — добавьте SDK в приложение для получения и отображения плейсмента.