La tua prima chiamata API

🟢Principiante

✅

Ultima verifica: 2026-06-20.

La struttura dell'API qui sotto è stabile, ma gli ID dei modelli e le versioni dell'SDK cambiano. Vedi la tabella dei modelli attuali.

Conferma confrontando con la fonte ufficiale.

L'API consente al tuo programma di dialogare con Claude. Tre passi: ottieni una chiave, installa l'SDK, invia un messaggio.

1. Ottieni una API key

Creane una nella Console Anthropic. Poi impostala come variabile d'ambiente così non finisce mai nel tuo codice:

export ANTHROPIC_API_KEY="sk-ant-..."

:::warning Non committare mai la tua chiave Mantieni le chiavi in variabili d'ambiente o in un secrets manager — mai nel controllo di versione. Vedi Sicurezza. :::

2. Installa l'SDK

Python

pip install anthropic

TypeScript

npm install @anthropic-ai/sdk

cURL

Niente da installare — ti serve solo curl.

3. Effettua la chiamata

Ogni richiesta è una lista di messages. Il modello risponde con content.

Python

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "In one sentence, what is an API?"}
    ],
)

print(message.content[0].text)

TypeScript

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY from the environment

const message = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "In one sentence, what is an API?" },
  ],
});

console.log(message.content[0].text);

cURL

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "In one sentence, what is an API?"}
    ]
  }'

Cosa è appena successo

• model — quale Claude usare. Non codificarlo alla cieca; vedi Scegliere un modello.
• max_tokens — un limite sulla lunghezza della risposta (in token). Non imposta la finestra di contesto.
• messages — la conversazione fino a quel momento. L'API è stateless: per continuare una chat, rinvia ogni volta l'intera cronologia.
• system (opzionale) — un'istruzione di livello superiore che definisce il ruolo di Claude per la chiamata.

Avanti

• Scegli il modello giusto e stima il costo → Scegliere un modello · Token e prezzi
• Esegui lo streaming delle risposte e mantieni una conversazione → Streaming e multi-turno
• Lascia che Claude chiami le tue funzioni → Uso degli strumenti
• Snippet pronti per la produzione → Snippet API