# gt: General Translation CLI tool: Быстрый старт
URL: https://generaltranslation.com/ru/docs/cli/quickstart.mdx
---
title: Быстрый старт
description: Узнайте, что делает CLI General Translation, когда его использовать и как перевести свой первый проект.
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/configuring
    - /docs/cli/guides/managing-translations
    - /docs/cli/guides/using-auto-jsx

---

CLI General Translation (`gt`) настраивает интернационализацию и переводит ваш проект из командной строки.

Он работает с [`gt-react`, `gt-next` и `gt-react-native`](/docs/react/overview), со сторонними i18n-библиотеками, такими как `next-intl` и `i18next`, а также с отдельными файлами, такими как JSON, YAML, Markdown и MDX.

## Что делает CLI [#what-it-does]

CLI предоставляет прямой доступ к:

* **Настройке** для установки зависимостей, интеграции вашего фреймворка и создания `gt.config.json`.
* **Переводу** для отправки исходного контента в API General Translation и сохранения результатов в вашей кодовой базе или CDN.
* **Компонентам для CI** для загрузки, постановки в очередь и скачивания переводов на отдельных этапах pipeline.
* **Проверке** для выявления ошибок перевода в проекте без вызова API.

## Когда использовать CLI [#when-to-use]

Используйте CLI, если хотите:

* Настроить новый проект для перевода с помощью пошагового мастера.
* Переводить проект в рамках сборки или CI-конвейера.
* Переводить автономные файлы контента без подключения библиотеки фреймворка.
* Хранить переводы в системе контроля версий вместе с исходным контентом.

## Быстрый старт [#quickstart]

Установите `gt`, настройте проект и запустите свой первый перевод.

### 1. Установите `gt`

Установите CLI как зависимость для этапа разработки.

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install gt --save-dev
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

### 2. Настройте проект

Запустите мастер настройки, чтобы определить используемый фреймворк, создать `gt.config.json` и сгенерировать учетные данные.

```bash
npx gt init
```

Мастер настройки задаёт локаль по умолчанию и целевые локали, выбирает, где хранятся переводы, и записывает API-ключ и идентификатор проекта в `.env.local`. Подробно об этой настройке см. в разделе [Настройка CLI](/docs/cli/guides/configuring), а полное описание команды — в [`gt init`](/docs/cli/reference/commands/init).

### 3. Добавьте свой production API-ключ

Для команды [`translate`](/docs/cli/reference/commands/translate) нужны production API-ключ и идентификатор проекта. Мастер может сгенерировать их за вас, либо создайте их на [странице API Keys](https://generaltranslation.com/dashboard). Задайте их в виде переменных окружения, чтобы CLI мог их прочитать.

```bash title=".env"
GT_API_KEY=your-api-key
GT_PROJECT_ID=your-project-id
```

*Примечание: укажите свой API-ключ в переменной окружения — никогда не добавляйте его в `gt.config.json`.*

### 4. Переведите свой проект

Запустите команду `translate`, чтобы перевести все файлы, указанные в `gt.config.json`, а также все встроенные компоненты [`<T>`](/docs/react/reference/components/t) и элементы словаря в исходном коде.

```bash
npx gt translate
```

Переводы сохраняются в вашей кодовой базе и готовы к коммиту. Запускайте это в вашем CI-пайплайне перед сборкой для продакшена. Полное описание workflow см. в разделе [Генерация переводов](/docs/cli/guides/generating-translations).
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/configuring
- /docs/cli/guides/managing-translations
- /docs/cli/guides/using-auto-jsx