# gt: General Translation CLI tool: gt init
URL: https://generaltranslation.com/ru/docs/cli/reference/commands/init.mdx
---

title: gt init
description: Запустите мастер настройки General Translation, чтобы настроить проект. Справочник API для команды `gt init`.

---

`init` — команда по умолчанию: если выполнить `npx gt` без команды, запустится `init`.

Мастер настройки определяет ваш фреймворк и, в зависимости от проекта, устанавливает зависимости, настраивает фреймворк, создает `gt.config.json` и генерирует учетные данные. Пошаговое руководство см. в разделе [Настройка CLI](/docs/cli/guides/configuring).

```bash
npx gt init
```

## Как это работает [#how-it-works]

1. Определяет ваш фреймворк. Для проекта на Next.js App Router или Mintlify вместо этого предлагает подключить AI-агент [Locadex](/docs/platform/locadex/quickstart).
2. Для проекта на React при желании устанавливает `gt-react` или `gt-next` и настраивает фреймворк (экспериментально). Приложения Vite получают загрузчик [`initializeGTSPA`](/docs/react/reference/config#initialize-spa), который запускается до существующей точки входа приложения; другие поддерживаемые приложения React используют [`GTProvider`](/docs/react/reference/components/gt-provider).
3. Запрашивает отсутствующие локаль по умолчанию и целевые локали, а также создает или обновляет `gt.config.json`. Существующие настройки локалей и файлов сохраняются. При локальном хранилище Vite также создает файл [`loadTranslations`](/docs/react/reference/functions/load-translations) и пустые файлы для целевых локалей.
4. Устанавливает `gt` как зависимость для разработки, если настроенному workflow требуется постоянная установка CLI. Настройка фреймворка Vite не добавляет `gt`; продолжайте запускать его с помощью `npx gt`.
5. При желании генерирует ключ API и Project ID и записывает их в `.env.local`.

*Примечание: Шаг настройки React экспериментальный и может работать не во всех проектах. Проверьте внесенные изменения.*

## Флаги [#flags]

| Параметр              | Описание                                    | Тип        | Необязательный | По умолчанию                                     |
| --------------------- | ------------------------------------------- | ---------- | -------------- | ------------------------------------------------ |
| `--src <paths...>`    | Glob-шаблоны для исходного кода приложения. | `string[]` | Да             | glob-шаблоны `src`, `app`, `pages`, `components` |
| `-c, --config <path>` | Путь к файлу конфигурации.                  | `string`   | Да             | `gt.config.json`                                 |

## Пример [#example]

```bash
# Запустить полный мастер настройки
npx gt init

# Запуск gt без команды делает то же самое
npx gt
```

## Другие примечания [#notes]

* `init` выполняет те же шаги, что и [`gt configure`](/docs/cli/reference/commands/configure) и [`gt auth`](/docs/cli/reference/commands/auth) вместе, а также запускает экспериментальный мастер настройки React. Чтобы повторить только один из этих шагов, запустите соответствующую команду отдельно. [`gt setup`](/docs/cli/reference/commands/setup) при этом не запускается — эта команда загружает ваши исходные файлы.
* В монорепозитории запускайте `init` из каталога конкретного приложения. Команда завершится без изменения файлов, если текущий каталог является корнем workspace с `pnpm-workspace.yaml` или полем `workspaces`.
* Автоматическая настройка недоступна для приложений Electron.
* ключ API и Project ID не нужны для использования `gt-react` или `gt-next` — они требуются только для вызова API General Translation.
* Если экспериментальная настройка React не подходит для вашего проекта, настройте его вручную по документации [React](/docs/react/react-quickstart).