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

# Accedi al CLI di Olostep

> Accedi con il tuo account Olostep, verifica chi sei, esci e usa un token in CI.

Il CLI accede con il tuo account Olostep, lo stesso account che usi sulla [dashboard](https://www.olostep.com/dashboard). Non hai bisogno di incollare una chiave API.

La maggior parte dei comandi richiede che tu sia autenticato. `--help`, `olostep help` e `olostep feedback` no.

## Accedi

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

Il tuo browser apre la pagina di accesso di Olostep. Accedi, e il CLI salva l'accesso su questo computer. Rimani autenticato fino a quando esegui `olostep logout`.

Se esegui un comando che richiede l'accesso prima di aver effettuato l'accesso, il CLI mostra `Per favore accedi a Olostep per continuare.` con due scelte, **Accedi** e **Esci**. Scegli **Accedi** per aprire il browser; il comando continua dopo che hai effettuato l'accesso.

## Verifica chi sei

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

Stampa il tuo account, il tuo team, il piano del team e il suo saldo crediti. `olostep whoami` è lo stesso comando di `olostep account info`.

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

## Esci

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

Olostep revoca la connessione di questo computer, e il CLI dimentica l'accesso salvato. Altri computer rimangono autenticati.

## Script, CI e agenti

Uno script o un lavoro CI non può completare un accesso tramite browser. Fornisci invece un token, con la variabile d'ambiente `OLOSTEP_TOKEN` o il flag `--token` su qualsiasi comando:

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

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

Un token in `OLOSTEP_TOKEN` o `--token` viene utilizzato al posto dell'accesso salvato.

Quando un comando che richiede l'accesso viene eseguito senza un terminale, o da un agente di codifica, e non c'è accesso o token, il CLI non richiede nulla. Stampa questo su stderr ed esce con codice `3`:

```text theme={null}
Per favore accedi a Olostep per continuare. Esegui `olostep login` (o imposta OLOSTEP_TOKEN), quindi esegui di nuovo questo comando.
```

Controlla il codice di uscita `3` negli script:

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

Consulta [Codici di uscita](https://docs.olostep.com/cli/usage.md#exit-codes) per ogni codice.

## Dove viene memorizzato l'accesso

Il CLI conserva il suo accesso in `~/.config/olostep` (o `$XDG_CONFIG_HOME/olostep` se imposti `XDG_CONFIG_HOME`). La cartella è leggibile solo dal tuo utente.

## Chiavi API

Il CLI non ha bisogno di una chiave API. Il tuo codice che chiama l'[API di Olostep](https://docs.olostep.com/get-started/authentication.md) sì. Per inserire una delle tue chiavi in un file `.env` senza stamparla:

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

Questo scrive `OLOSTEP_API_KEY=...` in `.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.