La tua prima chiamata API

Principiante

L'API consente al tuo programma di parlare con Claude. Alla fine di questa lezione avrai eseguito una richiesta reale e capirai esattamente cosa fa ogni sua parte.

What you'll learn

Creare una chiave API e conservarla in modo sicuro come variabile d'ambiente
Installare l'SDK ufficiale per Python o TypeScript (oppure usare semplice cURL)
Inviare la tua prima richiesta messages e leggere la risposta di Claude
Capire i quattro campi fondamentali: model, max_tokens, messages e system

L'intero percorso in tre passi

Tutto ciò che segue rientra in una semplice sequenza. Tieni a mente questa mappa mentre procedi.

Guided walkthrough1 of 3

Crea una chiave nella Anthropic Console ed esportala come variabile d'ambiente così che non finisca mai nel tuo codice.

1. Ottieni una chiave API

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

Esporta la tua chiave API

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

Watch out

Non committare mai la tua chiave. Conserva le chiavi in variabili d'ambiente o in un secrets manager, mai nel controllo di versione. Vedi la pagina sulla Sicurezza (/docs/security).

2. Installa l'SDK

Scegli il tuo linguaggio. L'SDK legge la chiave automaticamente dalla variabile d'ambiente che hai appena impostato.

Python
TypeScript
cURL

Installazione (Python)

pip install anthropic

Installazione (TypeScript)

npm install @anthropic-ai/sdk

Nulla da installare — ti serve solo curl.

3. Esegui la chiamata

Ogni richiesta è una lista di messages. Il modello risponde con content. Esegui lo snippet per il tuo linguaggio e vedrai Claude rispondere alla domanda.

Python
TypeScript
cURL

import anthropic

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

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

print(message.content[0].text)

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-5",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "In one sentence, what is an API?" },
  ],
});

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

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-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "In one sentence, what is an API?"}
    ]
  }'

Cosa è appena successo

Hai inviato quattro informazioni. Ecco cosa controlla ciascuna:

model — quale Claude usare. Non scriverlo a mano 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 finora. L'API è stateless: per continuare una chat, devi rinviare l'intera cronologia ogni volta.
system (opzionale) — un'istruzione di alto livello che definisce il ruolo di Claude per la chiamata.

I quattro campi fondamentali

Premi Invio o Spazio per girare la carta. Usa le frecce sinistra e destra per spostarti tra le carte.Termine mostrato.

1 / 4

Pro tip

Poiché l'API è stateless, una chat multi-turno è semplicemente un array messages che cresce: aggiungi ogni risposta e rinvia l'intera lista alla chiamata successiva.

Mettiti alla prova

0/3

Cosa controlla max_tokens?
Come continui una conversazione multi-turno con l'API?
Dove dovrebbe risiedere la tua chiave API?

Key takeaways

Tre passi: ottieni una chiave, installa l'SDK, invia una richiesta messages.
Conserva la chiave in ANTHROPIC_API_KEY così che l'SDK la legga automaticamente e non entri mai nel tuo codice.
Una richiesta è una lista di messaggi; la risposta torna in content.
L'API è stateless: rinvia l'intera cronologia della conversazione per continuare una chat.
model, max_tokens, messages e system sono i campi a cui ricorrerai per primi.

Avanti

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

L'intero percorso in tre passi​

1. Ottieni una chiave API​