Guida rapida alla CLI

La CLI ant fornisce accesso all'API di Claude dal tuo terminale. Ogni risorsa dell'API è esposta come sottocomando, con formattazione dell'output, filtraggio delle risposte e supporto per input da file YAML o JSON che la rendono pratica sia per l'esplorazione interattiva che per l'automazione.

Rispetto a chiamare l'API con curl, ant ti consente di costruire i corpi delle richieste da flag tipizzati o YAML in pipe anziché da JSON scritto a mano, di incorporare il contenuto dei file nei campi stringa con un riferimento @path e di estrarre campi dalla risposta con una query --transform integrata (senza bisogno di strumenti JSON separati). Gli endpoint di tipo lista gestiscono automaticamente la paginazione. Claude Code ha supporto nativo per ant.

Installazione

Verifica l'installazione:

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 chiave API.

ant auth login

Invia la tua prima richiesta

Con il binario installato e autenticato, chiama la Messages API:

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

{
  "model": "claude-opus-4-8",
  "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:

Passaggi successivi

• Opzioni di autenticazione della CLI: chiavi API, host headless, workspace multipli e profili denominati
• Utilizzo della CLI: struttura dei comandi, formati di output, trasformazioni GJSON e corpi delle richieste
• Scripting e automazione con la CLI: controllo di versione delle risorse API, pattern di scripting e utilizzo da Claude Code