> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Аккаунт

> Вход, выход и проверка активного контекста CLI-аккаунта

CLI использует API key для команд с аутентификацией. Вы можете сохранить его один раз с помощью `youka login` или передать через `YOUKA_API_KEY` в CI и других неинтерактивных окружениях.

`youka login` проверяет ключ через API перед сохранением, затем кэширует определённый email аккаунта в `~/.youka/config.json` для диагностики.

## `login`

Сохранить API key в `~/.youka/config.json`.

```bash theme={null}
youka login [token]
```

<ParamField path="token" type="string">
  API key, скопированный из панели Youka. Если не указан, CLI запросит его
  в интерактивном терминале.
</ParamField>

### Примеры

<CodeGroup>
  ```bash token theme={null}
  youka login yk_live_abcd1234
  ```

  ```bash with-api theme={null}
  youka login yk_live_abcd1234 --api https://staging-api.youka.test --json
  ```
</CodeGroup>

<Tip>В CI предпочтительнее использовать `YOUKA_API_KEY` вместо записи файла конфигурации.</Tip>

## `logout`

Удалить сохранённый API key из `~/.youka/config.json`.

```bash theme={null}
youka logout
youka logout --json
```

## `whoami`

Проверить источник полученного ключа, URL API и идентификатор аккаунта.

```bash theme={null}
youka whoami
youka whoami --json
```

Пример ответа:

```json theme={null}
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/ru/api/v1",
    "apiUrlSource": "default",
    "email": "user@example.com",
    "userId": "user_123",
    "apiKeyId": "key_123",
    "org": null,
    "configPath": "/Users/you/.youka/config.json",
    "apiKeyPreview": "yk_l...1234"
  }
}
```

### Порядок определения

| Поле    | Порядок                                                                          |
| ------- | -------------------------------------------------------------------------------- |
| API key | `YOUKA_API_KEY`, затем `~/.youka/config.json`                                    |
| API URL | `--api`, затем `YOUKA_API_BASE_URL`, затем `~/.youka/config.json`, затем default |

Когда активен ключ из сохранённой конфигурации, `whoami` проверяет идентичность через API и использует кэшированный email аккаунта только если онлайн-проверка недоступна. Он не использует кэшированную identity из конфигурации для токенов `YOUKA_API_KEY`.

## Что дальше

* [Глобальные опции](/ru/cli/global-options) — флаги, общие для каждой команды
* [Проекты](/ru/cli/projects) — создание и обработка караоке-проектов