---
title: "Panoramica della CLI"
description: "Installa la CLI, accedi, collega una cartella di progetto a un sito e pubblicala online."
canonical: "https://atelier201.com/docs/it/cli/overview"
updated: "2026-11-06"
---

# Panoramica della CLI

```bash
npm install -g @atelier201/cli
atelier201 auth login
atelier201 account
```

`atelier201 auth login` apre una finestra del browser, ti chiede a quale workspace
collegarti e quali autorizzazioni concedere, quindi salva il token nel portachiavi del
sistema operativo, non in un file nascosto. Se usi un computer senza browser, esegui
`atelier201 auth login --device`.

## Dalla cartella di progetto alla pubblicazione online

```bash
atelier201 sites create "Maison Dupont" --link   # crea il sito e collega questa cartella
atelier201 site pull                             # scarica qui i file del sito
# ...modifica...
atelier201 site push --build --wait              # carica la cartella, crea la build e attende
atelier201 previews create                       # crea un link privato alla build
atelier201 publish                               # mostra cosa sarà pubblicato, chiede conferma e procede
```

Tutti i comandi relativi ai siti accettano `--site <id>` oppure usano il sito
collegato alla cartella corrente. `atelier201 site link --site <id>` crea
`.atelier201/site.json`, che non contiene dati segreti e viene aggiunto a `.gitignore`.

Per modificare testi, voci e dati aziendali, preferisci i comandi dei contenuti alla
modifica dei file: convalidano i dati in base al modello dei contenuti del sito e non
possono comprometterne il layout.

```bash
atelier201 content set business:/tagline "Fresh bread daily"
```

Per l'elenco completo, consulta [Comandi](/docs/cli/commands). Per sapere quali dati
può contenere un sito, consulta [Modello dei contenuti e contenuti
multimediali](/docs/platform/content-model).

## Output

**L'output è automaticamente in formato JSON quando stdout non è un terminale.**
Puoi reindirizzarlo a `jq` senza configurazioni aggiuntive; in CI non serve passare
`--json` a nessun comando. Nel terminale viene mostrata una tabella. Per forzare un
formato, usa `--output json|table|ndjson`.

## Codici di uscita

Uno script può gestire ogni caso senza dover interpretare un messaggio:

| Codice | Significato                                                                                 |
| ------ | ------------------------------------------------------------------------------------------- |
| 0      | Operazione riuscita                                                                         |
| 1      | Errore imprevisto                                                                           |
| 2      | Uso non corretto o richiesta rifiutata dal server perché non valida                         |
| 3      | Problema di autenticazione o autorizzazione                                                 |
| 4      | Elemento non trovato                                                                        |
| 5      | Limite di richieste raggiunto                                                               |
| 6      | Conflitto: conflitto durante una scrittura, pubblicazione non aggiornata o limite del piano |