# gt: General Translation CLI tool: gt login
URL: https://generaltranslation.com/ru/docs/cli/reference/commands/login.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Вход в учётную запись для рабочих процессов CLI с хостингом. Справочник API по команде gt login.

Используйте login для аутентификации в уже настроенном окружении. Для пошаговой настройки проекта выполните [`gt init`](/docs/cli/reference/commands/init): эта команда выполняет вход при создании проекта или ключа, если нет ни ключа для инструментов, ни сохранённых данных входа. Чтобы создать ключ с ограниченной областью доступа, используйте [`gt api-key create`](/docs/cli/reference/commands/api-key-create).

## Обзор [#overview]

Требуется [Node.js 20 или новее](/docs/cli/quickstart#quickstart); рекомендуется использовать LTS-версию, которая поддерживается в настоящее время.

```bash
npx gt login [options]
```

| Параметр                        | Описание                                                                               | Тип       | Необязательно | По умолчанию     |
| ------------------------------- | -------------------------------------------------------------------------------------- | --------- | ------------- | ---------------- |
| [`--no-browser`](#flags)        | Использовать авторизацию устройства вместо обратного вызова от локального браузера. | `boolean` | Да            | `false`          |
| [`-c, --config <path>`](#flags) | Файл конфигурации, в котором `baseUrl` задаёт API для входа.                           | `string`  | Да            | `gt.config.json` |

<Callout type="info">
  **Изменено в v2.22:** прежняя команда auth и её флаг типа ключа удалены и не сохранены в виде алиасов. Вход в аккаунт теперь выполняется командой login, а за выдачу доступа отвечают init и явное создание ключей. Существующие API-ключи продолжают работать.
</Callout>

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

* Открывает браузер, чтобы вы могли подтвердить доступ CLI к своей учётной записи.
* Разрешения вашей учётной записи определяют, к каким проектам и операциям у вас есть доступ.
* Использует авторизацию устройства, если указан флаг `--no-browser` или если на этом компьютере не удаётся принять обратный вызов от браузера. В этом случае выводятся URL для подтверждения и код, который нужно подтвердить на другом устройстве.
* В SSH-сеансах авторизация устройства используется автоматически. Одна лишь неудачная попытка открыть браузер не переключает режим: откройте показанный URL авторизации вручную или перезапустите команду с `--no-browser`.
* Сохраняет сеанс учётной записи, а не выбранный проект. Команда не создаёт API-ключи и не записывает `.env.local`. SDK среды выполнения не загружают сеансы CLI.

О привязке проекта, приоритете явно указанных ключей и учётных данных для CI см. раздел [Настройка CLI](/docs/cli/guides/configuring#credentials).

## Флаги [#flags]

**`--no-browser`** · **Тип** `boolean` · **Необязательно** · **По умолчанию** `false`

Выполняет авторизацию устройства без открытия браузера. Подтверждение пользователем по-прежнему требуется, поэтому этот способ не подходит для автоматической аутентификации в CI.

**`-c, --config <path>`** · **Тип** `string` · **Необязательно** · **По умолчанию** `gt.config.json`

Считывает [`baseUrl`](/docs/cli/reference/config#base-url) из указанного файла конфигурации вместо автоматически найденного `gt.config.json`. `GT_API_URL` по-прежнему имеет приоритет над этим значением. Требуется `gt` версии 2.23.0 или новее.

Также действуют [глобальные параметры](/docs/cli/reference/global-options).

## Примеры [#examples]

```bash
# Вход через браузер на этом компьютере
npx gt login

# Подтверждение входа с другого устройства
npx gt login --no-browser
```

После подтверждения входа проверьте учётную запись с помощью [`gt whoami`](/docs/cli/reference/commands/whoami). Чтобы удалить сохранённый сеанс, выполните [`gt logout`](/docs/cli/reference/commands/logout).

## Хранение и устранение неполадок [#storage]

Сеансы хранятся в `$XDG_STATE_HOME/gt/credentials.json`, если `XDG_STATE_HOME` задан абсолютным путём, а иначе — в `~/.local/state/gt/credentials.json`. Относительные значения XDG игнорируются.

Если система это поддерживает, файлам учётных данных назначаются разрешения, дающие доступ только владельцу. Учётные данные не шифруются и не хранятся в связке ключей ОС. Данные входа, сохранённые в старых форматах, не переносятся автоматически. Если сохранённые учётные данные устарели или недействительны, войдите заново. Повреждённые файлы учётных данных сохраняются в виде резервных копий `.corrupt-<timestamp>`.

CLI сохраняет сеанс входа между запусками команд. Не обновляйте одни и те же сохранённые данные входа из нескольких процессов CLI одновременно.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.