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

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

Установите dbt Wizard локально и начните сеанс разработки dbt с ИИ-агентом из терминала.

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

Использование 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).

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

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

dbt Wizard не зависит от используемого хранилища данных и работает как с v1, так и с v2.

## Поддерживаемые поставщики ИИ

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.

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

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).

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

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

## Полезные команды терминала

Для начала работы используйте следующие команды:

| Команда                       | Описание                                                                                                      | Пример                                        |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| `wizard "[prompt]"`           | Запустить интерактивный сеанс с начальным запросом. После активации сеанса запросы можно вводить без кавычек. | `wizard "summarize what this project does"`   |
| `wizard exec "[prompt]"`      | Выполнить один запрос в неинтерактивном режиме и завершить работу                                             | `wizard exec "list all models with no tests"` |
| `wizard review --uncommitted` | Выполнить проверку кода для незакоммиченных изменений в неинтерактивном режиме                                | `wizard review --uncommitted`                 |
| `wizard review --base BRANCH` | Проверить изменения относительно базовой ветки                                                                | `wizard review --base main`                   |
| `wizard resume`               | Возобновить предыдущий сеанс                                                                                  | `wizard resume --last`                        |
| `wizard apply`                | Применить последние изменения Wizard к рабочему каталогу                                                      | `wizard apply TASK_ID`                        |
| `wizard login` / `logout`     | Пройти аутентификацию с помощью учётной записи dbt                                                            | `wizard login`                                |
| `wizard mcp`                  | Управлять подключениями к серверам MCP                                                                        | `wizard mcp add dbt`                          |
| `wizard update`               | Обновить Wizard до последней версии                                                                           | `wizard update`                               |

Нужно повторить первоначальную настройку?

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

## Дальнейшие шаги

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

Посмотрите, как это работает, и поделитесь отзывом

Хотите увидеть dbt Wizard в действии? Посмотрите [демонстрационное видео](https://www.youtube.com/watch?v=-lIzh1xQWMA).

Нам было бы интересно узнать о вашем опыте работы с dbt Wizard. Поделитесь отзывом, выполнив слеш-команду `/feedback` в интерактивном сеансе терминала или перейдя в канал [#dbt-wizard](https://getdbt.slack.com/archives/C0B6KLW6T26) в [Slack-сообществе dbt](https://docs.getdbt.com/community/join?version=2.0).

Большое спасибо за помощь в улучшении dbt Wizard и процесса разработки данных с помощью dbt!