# gt: General Translation CLI tool: CLI для перевода
URL: https://generaltranslation.com/ru/docs/cli.mdx
---
title: CLI для перевода
description: Настройте и переводите свой проект с помощью CLI-инструмента General Translation
---

## Обзор

CLI-инструмент General Translation (`gt`) позволяет настроить интернационализацию и автоматически переводить ваш проект на любой из [поддерживаемых языков](/docs/platform/supported-locales).

Он работает с [`gt-next`](/docs/next), [`gt-react`](/docs/react), [`gt-react-native`](/docs/react-native) и сторонними библиотеками i18n, такими как `next-intl` и `i18next`. Вы также можете использовать его для перевода автономных файлов (JSON, MDX, HTML и других).

## Быстрый старт

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

```bash
npx gt@latest
```

Это запустит мастер настройки, который:

* Установит необходимые зависимости (например, `gt-next` или `gt-react`)
* Настроит ваш фреймворк (plugin для Next.js, провайдер React и т. д.)
* Создаст `gt.config.json` с вашими локалями и настройками файлов
* Сгенерирует учётные данные API


### 2. translate

```bash
npx gt translate
```

Эта команда переводит ваш проект с помощью API General Translation. Запускайте её в CI/CD pipeline **до** build для продакшена.

<Callout type="info">
  **Примечание:** Для команды `translate` требуется production API-ключ. Мастер настройки может сгенерировать его для вас, или вы можете получить его на [generaltranslation.com](https://generaltranslation.com).
</Callout>

Вот и всё — две команды, чтобы превратить одноязычный проект в полностью переведённый.


## Команды

| Команда                                     | Описание                                                                                               |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| [`npx gt@latest`](/docs/cli/init)           | Запустите мастер настройки. Устанавливает зависимости, настраивает проект и генерирует учётные данные. |
| [`npx gt translate`](/docs/cli/translate)   | Переведите проект через API GT.                                                                        |
| [`npx gt configure`](/docs/cli/configure)   | Обновите настройки GT для проекта (`gt.config.json`).                                                  |
| [`npx gt auth`](/docs/cli/auth)             | Сгенерируйте или обновите учётные данные API.                                                          |
| [`npx gt generate`](/docs/cli/generate)     | Сгенерируйте JSON-файл с данными перевода для автономного использования.                               |
| [`npx gt upload`](/docs/cli/upload)         | Загрузите исходные файлы и переводы на платформу GT.                                                   |
| [`npx gt enqueue`](/docs/cli/enqueue)       | Поместите файлы в очередь на перевод без скачивания результатов.                                       |
| [`npx gt download`](/docs/cli/download)     | Скачайте переводы, которые ранее были поставлены в очередь или подготовлены.                           |
| [`npx gt stage`](/docs/cli/stage)           | Подготовьте переводы к проверке человеком перед публикацией.                                           |
| [`npx gt save-local`](/docs/cli/save-local) | Сохраните локальные изменения переводов на платформе GT.                                               |

## Руководства

| Руководство                      | Описание                                             |
| -------------------------------- | ---------------------------------------------------- |
| [Ветвление](/docs/cli/branching) | Отдельно отслеживайте переводы для разных веток Git. |
| [FAQ](/docs/cli/faqs)            | Частые вопросы о CLI-инструменте.                    |

## Поддерживаемые форматы

CLI поддерживает перевод файлов в различных форматах:

[GT](/docs/cli/formats/gt) · [JSON](/docs/cli/formats/json) · [MDX](/docs/cli/formats/mdx) · [TypeScript/JavaScript](/docs/cli/formats/ts) · [YAML](/docs/cli/formats/yaml) · [PO/POT](/docs/cli/formats/po) · [HTML](/docs/cli/formats/html) · [Обычный текст](/docs/cli/formats/txt)