# Установка dbt Wizard CLI [Бета-версия](https://docs.getdbt.tech/docs/dbt-versions/product-lifecycles "Подробнее о статусе или тарифе")

Локальная разработка

Установите dbt Wizard CLI через терминал для разработки данных в dbt с помощью ИИ-агента и с соблюдением правил управления данными.

В этом руководстве описано, как установить, проверить, обновить и удалить dbt Wizard CLI на локальном компьютере.

Использование Wizard и оплата

С 1 сентября 2026 года использование dbt Wizard тарифицируется по количеству токенов и оплачивается из кредитов вашего аккаунта. Все суммы кредитов предоставляются на аккаунт, а не на пользователя. Аккаунты Enterprise и Enterprise+ получают кредиты ежемесячно. Тарифные планы Developer и Starter включают 30-дневный пробный период и кредиты на сумму $100; те же условия доступны пользователям CLI с бесплатным аккаунтом dbt.

Подробнее о том, что входит в каждый тарифный план, лимитах расходов и платном доступе, см. в разделе [Пробный период и оплата](https://docs.getdbt.tech/docs/dbt-ai/pricing-billing/trial-and-billing.md).

Вы можете запускать CLI dbt Wizard локально из любого проекта на любом движке dbt. Но будьте осторожны: известно, что волшебник умеет накладывать заклинания.

## Предварительные требования

* macOS, Windows или Linux
* Проект dbt с созданным каталогом `target/` (`dbt parse`, `dbt compile` или `dbt build`)
* Доступ к поддерживаемому провайдеру ИИ. Вы можете использовать управляемого провайдера в dbt или настроить [BYOK](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md) с собственными учётными данными провайдера.

### Поддерживаемые модели ИИ

dbt Wizard поддерживает [модели управляемое подключение](https://docs.getdbt.tech/docs/dbt-ai/pricing-billing/overview.md#dbt-managed-providers) (оплата через dbt Labs, управлять ключом не требуется) и [модели с собственным ключом (BYOK)](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md) (оплата напрямую провайдеру).

Ниже перечислены поддерживаемые провайдеры ИИ в зависимости от того, где вы работаете. Полный список доступных моделей см. в [таблице тарифов провайдеров моделей](https://www.getdbt.com/legal/dbt-wizard-token-costs-by-model).

### dbt platform

| Провайдер                                                                    | Доступ                               |
| ---------------------------------------------------------------------------- | ------------------------------------ |
| [OpenAI](https://openai.com/policies/row-terms-of-use/) (по умолчанию)       | dbt управляемое подключение или BYOK |
| [Anthropic](https://www.anthropic.com/legal/consumer-terms)†                 | dbt управляемое подключение или BYOK |
| Модели с открытыми весами (например, DeepSeek, Kimi и другие).               | dbt управляемое подключение          |
| [Azure AI Foundry](https://www.microsoft.com/licensing/terms) / Azure OpenAI | BYOK                                 |

### Локально (CLI)

| Провайдер                                                                    | Доступ                               |
| ---------------------------------------------------------------------------- | ------------------------------------ |
| [OpenAI](https://openai.com/policies/row-terms-of-use/)                      | dbt управляемое подключение или BYOK |
| [Anthropic](https://www.anthropic.com/legal/consumer-terms)†                 | dbt управляемое подключение или BYOK |
| Модели с открытыми весами (например, DeepSeek, Kimi и другие).               | dbt управляемое подключение          |
| [Azure AI Foundry](https://www.microsoft.com/licensing/terms) / Azure OpenAI | BYOK                                 |
| [AWS Bedrock](https://aws.amazon.com/service-terms/)                         | BYOK                                 |
| [Google Gemini](https://ai.google.dev/gemini-api/terms)                      | BYOK                                 |
| [Snowflake Cortex](https://www.snowflake.com/en/legal/terms-of-service/)     | BYOK                                 |
| [Databricks Unity AI Gateway](https://www.databricks.com/legal/mcsa)         | BYOK                                 |

Вы также можете подключить личную подписку OpenAI ChatGPT вместо ключа.

†Корпоративные лицензии и лицензии по подписке Anthropic (например, Claude Enterprise) не поддерживаются согласно [условиям использования](https://www.anthropic.com/legal/consumer-terms) Anthropic.

Впервые работаете с терминалом?

Если вы никогда раньше не пользовались терминалом, ознакомьтесь с [руководством по работе с терминалом](https://docs.getdbt.tech/guides/terminal-guide.md) — в нём вы найдёте полезные советы, которые помогут вам начать работу!

## Установка и настройка dbt Wizard CLI

12345

Показать все шагиДалее

1

Установите dbt Wizard CLI

Запустите скрипт установки для вашей операционной системы:

macOS/Linux:

```bash
curl -fsSL https://public.cdn.getdbt.com/dbt-wizard/install/install-wizard.sh | sh
```

Windows (PowerShell):

```powershell
irm https://public.cdn.getdbt.com/dbt-wizard/install/install-wizard.ps1 | iex
```

Эта команда устанавливает dbt Wizard в `/usr/local/bin/wizard`, а также [dbt Information Schema](https://docs.getdbt.tech/docs/build/dbt-information-schema.md), благодаря которой dbt Wizard учитывает контекст проекта при ответах. Подробности об установке и обновлении см. в разделе [Установка CLI dbt Wizard](https://docs.getdbt.tech/docs/dbt-ai/wizard-cli.md); инструкции по удалению — в разделе [Удаление](https://docs.getdbt.tech/docs/dbt-ai/wizard-cli.md#uninstall).

Нужно повторить настройку? Чтобы повторно пройти аутентификацию, сбросить конфигурацию проекта или снова вызвать запрос о доверии к папке, обратитесь к разделу [Повторный запуск процедур первоначальной настройки](https://docs.getdbt.tech/docs/dbt-ai/wizard-config.md#re-trigger-onboarding-flows).

## Обновление

Выполните следующую команду, чтобы обновить dbt Wizard до последней версии:

```bash
wizard update
```

Предпочитаете учиться по видео?

Посмотрите бесплатный [видеокурс dbt Wizard](https://learn.getdbt.com/courses/dbt-wizard) на dbt Learn!

## Удаление

1. Выполните встроенную команду удаления. Она выводит список всех двоичных файлов, конфигураций и каталогов данных, которые будут удалены, а затем запрашивает подтверждение (`Proceed? [Y/N]`), прежде чем что-либо удалять:

   ```shell
   wizard system uninstall
   ```

При удалении `~/.dbt/wizard` удаляются локальная конфигурация, журналы и кеш. Это действие нельзя отменить. Ваши профили dbt (`~/.dbt/`) и проекты dbt не относятся к dbt Wizard и не будут затронуты.

2. Убедитесь, что исполняемый файл удалён, проверив его наличие в системном пути поиска:

   ```bash
   which wizard
   ```

Если команда не возвращает путь, dbt Wizard успешно удалён.

## Телеметрия

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

Подробную информацию о том, какие данные собираются, какие не собираются и как отказаться от отправки клиентской телеметрии, см. в разделе [Использование данных и телеметрия dbt Wizard CLI](https://docs.getdbt.tech/docs/dbt-ai/wizard-telemetry.md).

Рекомендации по использованию dbt Wizard

После завершения настройки обратитесь к разделу [Как использовать dbt Wizard в вашем проекте dbt](https://docs.getdbt.tech/best-practices/how-to-use-wizard/wizard-1-intro.md), чтобы ознакомиться с рекомендуемыми рабочими процессами для реальных задач проекта.

## Связанная документация

* [Обзор dbt Wizard](https://docs.getdbt.tech/docs/platform/wizard-overview.md): где доступен dbt Wizard и как начать работу
* [Настройка BYOK](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md): управление API-ключом и выбор модели ИИ
* [Справочник команд](https://docs.getdbt.tech/docs/dbt-ai/wizard-cli-reference.md): полный справочник всех подкоманд `wizard` и глобальных флагов
* [Сценарии использования и примеры](https://docs.getdbt.tech/docs/dbt-ai/wizard-use-cases.md): практические сценарии аналитической инженерии
* [Переход с другого ИИ-агента](https://docs.getdbt.tech/docs/dbt-ai/wizard-migrate.md): переход с другого ИИ-агента на dbt Wizard
* [Использование данных и телеметрия CLI](https://docs.getdbt.tech/docs/dbt-ai/wizard-telemetry.md): какие данные собирает dbt Wizard CLI и как отказаться от их отправки
* [Как использовать dbt Wizard в вашем проекте dbt](https://docs.getdbt.tech/best-practices/how-to-use-wizard/wizard-1-intro.md): рекомендуемые рабочие процессы