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

# Primi passi

> Installa la CLI, accedi e avvia la prima chat.

## Panoramica

Quattro passaggi coprono installazione, accesso e prima chat per inviare richieste dal terminale.

## Prerequisiti

Prepara due elementi:

* Node.js 20 o successivo
* Account NoimosAI attivo ([registrazione](https://noimosai.com))

## Configurare la CLI

Segui questi quattro passaggi.

### 1. Installare la CLI

Installa `@noimosai/cli` globalmente con il gestore di pacchetti.

```bash theme={null}
pnpm add -g @noimosai/cli
```

Con npm usa questo comando.

```bash theme={null}
npm install -g @noimosai/cli
```

Verifica che appaia la versione.

```bash theme={null}
noimosai --version
```

### 2. Accedere a NoimosAI

Scegli l’autenticazione interattivamente con questo comando.

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

Due metodi disponibili:

* **Browser (OAuth)** — Accedi dal browser; adatto al terminale locale.
* **Chiave API** — Chiave della scheda API del team; adatta senza browser, ad esempio CI/CD.

Per scegliere direttamente usa questi comandi.

```bash theme={null}
noimosai login --oauth
printenv NOIMOS_API_KEY | noimosai login --api-key-stdin
```

Passare la chiave con `--api-key <key>` può esporla ad altri processi del computer. Usa `--api-key-stdin` senza interazione.

> [!NOTE]
>
> La chiave è per spazi ordinari. Le chiavi Developer Platform `nmp_` non funzionano qui.

### 3. Avviare la prima chat

Dopo l’accesso avvia una sessione interattiva.

```bash theme={null}
noimosai chat
```

Chiedi all’agente, richiedi materiali di marketing o affina i contenuti conversando.

Per una sola richiesta usa `-p`.

```bash theme={null}
noimosai chat -p "Crea tre bozze LinkedIn di lancio in giapponese"
```

### 4. Consultare i comandi

Mostra comandi e opzioni della versione installata.

```bash theme={null}
noimosai --help
noimosai <command> --help
```

Consulta [Consultare i comandi](https://docs.noimosai.com/it/developers/cli/commands.md) per i comandi pubblicati.

## Risolvere problemi di connessione

Verifica secondo l’errore:

* **`Not authenticated`** — Ripeti `noimosai login`.
* **`Workspace ID not configured`** — Scegli lo spazio all’accesso o usa `-w <workspace-id>` nei comandi supportati.
* **Comando o opzione assente** — Reinstalla l’ultima versione pubblicata e consulta `noimosai --version` e `noimosai <command> --help`.
* **JSON non pubblicabile** — Verifica destinazione, testo e percorsi con `noimosai post posts.json --now --dry-run`.

`noimosai logout` rimuove le credenziali prima di un nuovo accesso.

## Pagine correlate

Queste pagine descrivono comandi e altre connessioni.

* [Consultare i comandi](https://docs.noimosai.com/it/developers/cli/commands.md)
* [Usare chat e sessioni](https://docs.noimosai.com/it/developers/cli/chat-and-sessions.md)
* [Comprendere le basi](https://docs.noimosai.com/it/developers/mcp/overview.md)


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