---
title: Guida rapida alla CLI
url: https://platform.claude.com/docs/it/cli-sdks-libraries/cli/quickstart
description: Installa lo strumento da riga di comando ant, autenticati e invia la tua prima richiesta alla Claude API.
---

La CLI `ant` fornisce accesso alla Claude API dal tuo terminale. Ogni risorsa dell'API è esposta come sottocomando, con formattazione dell'output, filtraggio delle risposte e input da file YAML o JSON.

<Frame caption="La CLI ant in azione.">
  <video aria-label="Registrazione dello schermo della CLI ant in esecuzione in un terminale.">
    <source src="https://platform.claude.com/docs/videos/ant-cli-demo.webm" type="video/webm" />
    <source src="https://platform.claude.com/docs/videos/ant-cli-demo.mp4" type="video/mp4" />
  </video>
</Frame>

Rispetto a `curl`, `ant` costruisce i corpi delle richieste a partire da flag tipizzati o da YAML passato tramite pipe invece che da JSON scritto a mano, e inserisce il contenuto dei file nei campi stringa con un riferimento `@path`. Estrae i campi della risposta con una query `--transform` integrata, così non hai bisogno di uno strumento separato come `jq`, e gestisce automaticamente la paginazione degli endpoint di elenco.

<Info>
  Per i parametri specifici degli endpoint e gli schemi delle risposte, consulta il [riferimento API](https://platform.claude.com/docs/it/api/cli/messages/create). Questa pagina ti porta a un comando funzionante. Per tutto il resto che la CLI può fare, consulta [Usare la CLI](https://platform.claude.com/docs/it/cli-sdks-libraries/cli/using) e [Scripting e automazione con la CLI](https://platform.claude.com/docs/it/cli-sdks-libraries/cli/scripting).
</Info>

## Installazione

<Tabs>
  <Tab title="Homebrew (macOS)">
    ```bash
    brew install anthropics/tap/ant
    ```
  </Tab>

  <Tab title="curl (Linux/WSL)">
    Per gli ambienti Linux, scarica direttamente il binario della release.

    ```bash
    VERSION=1.42.0
    OS=$(uname -s | tr '[:upper:]' '[:lower:]')
    case $(uname -m) in
      x86_64) ARCH=amd64 ;;
      aarch64) ARCH=arm64 ;;
    esac
    curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
      | sudo tar -xz -C /usr/local/bin ant
    ```

    Puoi trovare tutte le release nella [pagina delle release su GitHub](https://github.com/anthropics/anthropic-cli/releases).
  </Tab>

  <Tab title="Go">
    Puoi anche installare la CLI dal codice sorgente usando `go install`. Richiede Go 1.25 o successivo.

    ```bash
    go install github.com/anthropics/anthropic-cli/cmd/ant@latest
    ```

    Il binario viene collocato in `$(go env GOPATH)/bin`. Aggiungilo al tuo `PATH` se non lo è già:

    ```bash
    export PATH="$PATH:$(go env GOPATH)/bin"
    ```
  </Tab>
</Tabs>

Verifica l'installazione:

```bash
ant --version
```

## Autenticazione

`ant auth login` apre un flusso OAuth basato su browser verso la Claude Console e memorizza localmente le credenziali risultanti, così puoi chiamare l'API senza creare o gestire una "API key" (chiave API).

```bash CLI
ant auth login
```

<Note>
  Per altri modi di autenticarti (variabile d'ambiente con chiave API, host headless, workspace multipli, profili con nome e Workload Identity Federation), consulta [Opzioni di autenticazione della CLI](https://platform.claude.com/docs/it/cli-sdks-libraries/cli/authentication).
</Note>

## Invia la tua prima richiesta

Con il binario installato e autenticato, chiama la [Messages API](https://platform.claude.com/docs/it/api/cli/messages/create):

```bash
ant messages create \
  --model claude-opus-5-5 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'
```

```text Output wrap
{
  "model": "claude-opus-5-5",
  "id": "msg_01YMmR5XodC5nTqMxLZMKaq6",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How are you doing today? Is there something I can help you with?"
    }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 27, "output_tokens": 20 /*, ... */ }
}
```

La risposta è l'oggetto API completo, formattato in modo leggibile perché stdout è un terminale.

## Completamento della shell

La CLI include script di completamento per bash, zsh, fish e PowerShell. Genera e installa quello per la tua shell:

<Tabs>
  <Tab title="zsh">
    ```bash
    ant @completion zsh > "${fpath[1]}/_ant"
    # Riavvia la shell o esegui: autoload -U compinit && compinit
    ```
  </Tab>

  <Tab title="bash">
    ```bash
    ant @completion bash > /etc/bash_completion.d/ant
    ```
  </Tab>

  <Tab title="fish">
    ```bash
    ant @completion fish > ~/.config/fish/completions/ant.fish
    ```
  </Tab>

  <Tab title="PowerShell">
    ```powershell
    ant @completion powershell | Out-String | Invoke-Expression
    # Per mantenerlo tra le sessioni:
    # ant @completion powershell >> $PROFILE
    ```
  </Tab>
</Tabs>

## Passaggi successivi

<CardGroup cols={3}>
  <Card title="Opzioni di autenticazione della CLI" icon="lock" href="https://platform.claude.com/docs/it/cli-sdks-libraries/cli/authentication">
    Chiavi API, host headless, workspace multipli e profili con nome
  </Card>

  <Card title="Usare la CLI" icon="terminal" href="https://platform.claude.com/docs/it/cli-sdks-libraries/cli/using">
    Struttura dei comandi, formati di output, trasformazioni GJSON e corpi delle richieste
  </Card>

  <Card title="Scripting e automazione con la CLI" icon="code" href="https://platform.claude.com/docs/it/cli-sdks-libraries/cli/scripting">
    Controllo di versione delle risorse API, pattern di scripting e utilizzo da Claude Code
  </Card>
</CardGroup>