> ## 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.

# Cuenta

> Inicia sesión, cierra sesión e inspecciona el contexto de cuenta activo de la CLI

La CLI usa una clave de API para los comandos autenticados. Puedes guardarla una vez con `youka login` o proporcionarla mediante `YOUKA_API_KEY` en CI y otros entornos no interactivos.

`youka login` verifica la clave contra la API antes de guardarla y luego guarda en caché el correo electrónico de la cuenta resuelta en `~/.youka/config.json` para diagnósticos.

## `login`

Guarda una clave de API en `~/.youka/config.json`.

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

<ParamField path="token" type="string">
  La clave de API copiada desde el panel de Youka. Si se omite, la CLI la solicita
  en una terminal interactiva.
</ParamField>

### Ejemplos

<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>En CI, es preferible `YOUKA_API_KEY` en lugar de escribir un archivo de configuración.</Tip>

## `logout`

Elimina la clave de API guardada de `~/.youka/config.json`.

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

## `whoami`

Inspecciona la fuente de la clave resuelta, la URL de la API y la identidad de la cuenta.

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

Respuesta de ejemplo:

```json theme={null}
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/es/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"
  }
}
```

### Orden de resolución

| Campo         | Orden                                                                                            |
| ------------- | ------------------------------------------------------------------------------------------------ |
| Clave de API  | `YOUKA_API_KEY`, luego `~/.youka/config.json`                                                    |
| URL de la API | `--api`, luego `YOUKA_API_BASE_URL`, luego `~/.youka/config.json`, luego el valor predeterminado |

Cuando una clave guardada en la configuración está activa, `whoami` verifica la identidad con la API y recurre al correo electrónico de la cuenta en caché solo si la consulta en vivo no está disponible. No usa la identidad en caché de la configuración para tokens `YOUKA_API_KEY`.

## Qué sigue

* [Opciones globales](/es/cli/global-options) - flags compartidos por cada comando
* [Proyectos](/es/cli/projects) - crea y procesa proyectos de karaoke