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

# Iniciar sesión en el CLI de Olostep

> Inicia sesión con tu cuenta de Olostep, verifica quién eres, cierra sesión y usa un token en CI.

El CLI inicia sesión con tu cuenta de Olostep, la misma cuenta que usas en el [dashboard](https://www.olostep.com/dashboard). No necesitas pegar una clave API.

La mayoría de los comandos requieren que hayas iniciado sesión. `--help`, `olostep help` y `olostep feedback` no lo requieren.

## Iniciar sesión

```bash theme={null}
olostep login
```

Tu navegador abrirá la página de inicio de sesión de Olostep. Inicia sesión, y el CLI guardará la sesión en este ordenador. Permanecerás conectado hasta que ejecutes `olostep logout`.

Si ejecutas un comando que requiere inicio de sesión antes de haber iniciado sesión, el CLI mostrará `Por favor, inicia sesión en Olostep para continuar.` con dos opciones, **Iniciar sesión** y **Salir**. Elige **Iniciar sesión** para abrir el navegador; el comando continuará después de que inicies sesión.

## Verificar quién eres

```bash theme={null}
olostep whoami
```

Imprime tu cuenta, tu equipo, el plan del equipo y su saldo de crédito. `olostep whoami` es el mismo comando que `olostep account info`.

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

## Cerrar sesión

```bash theme={null}
olostep logout
```

Olostep revoca la conexión de este ordenador, y el CLI olvida la sesión guardada. Otros ordenadores permanecen conectados.

## Scripts, CI y agentes

Un script o trabajo de CI no puede completar un inicio de sesión en el navegador. Proporciónale un token en su lugar, con la variable de entorno `OLOSTEP_TOKEN` o la bandera `--token` en cualquier comando:

```bash theme={null}
export OLOSTEP_TOKEN="<token>"
olostep credits balance --json
```

```bash theme={null}
olostep credits balance --json --token "<token>"
```

Un token en `OLOSTEP_TOKEN` o `--token` se usa en lugar de la sesión guardada.

Cuando un comando que requiere inicio de sesión se ejecuta sin un terminal, o desde un agente de codificación, y no hay sesión ni token, el CLI no solicita. Imprime esto en stderr y sale con el código `3`:

```text theme={null}
Por favor, inicia sesión en Olostep para continuar. Ejecuta `olostep login` (o configura OLOSTEP_TOKEN), luego ejecuta esto nuevamente.
```

Verifica el código de salida `3` en scripts:

```bash theme={null}
olostep credits balance --json > balance.json
if [ $? -eq 3 ]; then
  echo "Primero inicia sesión: olostep login"
fi
```

Consulta [Códigos de salida](https://docs.olostep.com/cli/usage.md#exit-codes) para cada código.

## Dónde se guarda la sesión

El CLI guarda su sesión en `~/.config/olostep` (o `$XDG_CONFIG_HOME/olostep` si configuras `XDG_CONFIG_HOME`). La carpeta es legible solo por tu usuario.

## Claves API

El CLI no necesita una clave API. Tu código que llama a la [API de Olostep](https://docs.olostep.com/get-started/authentication.md) sí lo necesita. Para poner una de tus claves en un archivo `.env` sin imprimirla:

```bash theme={null}
olostep keys reveal <key> --write-env .env
```

Esto escribe `OLOSTEP_API_KEY=...` en `.env`. Consulta [`olostep keys reveal`](https://docs.olostep.com/cli/reference/account-billing#olostep-keys-reveal).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.