---
title: Panoramica dell'API
url: https://platform.claude.com/docs/it/api/overview
description: Comprendi gli endpoint disponibili dell'API di Claude, gli header di autenticazione, gli SDK client, la paginazione, i limiti di velocità e le opzioni di accesso alle piattaforme cloud.
---

L’API di Claude è un’API RESTful disponibile all’indirizzo `https://api.anthropic.com` che fornisce accesso programmatico ai modelli Claude e ai Claude Managed Agents.

<Note>
  **Nuovo su Claude?** Per l’accesso diretto ai modelli, inizia con [Inizia](https://platform.claude.com/docs/it/get-started) e [Lavorare con i Messaggi](https://platform.claude.com/docs/it/build-with-claude/working-with-messages). Per l’infrastruttura di agenti gestiti, consulta la [guida rapida ai Claude Managed Agents](https://platform.claude.com/docs/it/managed-agents/quickstart).
</Note>

## Prerequisiti

Per usare l’API di Claude, hai bisogno di:

* Un [account Claude Console](https://platform.claude.com/)
* Una [chiave API](https://platform.claude.com/settings/keys) dalla Console, oppure una regola di [Workload Identity Federation](https://platform.claude.com/docs/it/manage-claude/workload-identity-federation) configurata

Per istruzioni di configurazione passo passo, consulta [Inizia](https://platform.claude.com/docs/it/get-started).

## API disponibili

L’API di Claude include le seguenti API:

* **[Messages API](https://platform.claude.com/docs/it/api/messages/create):** Invia messaggi a Claude per interazioni conversazionali (`POST /v1/messages`)
* **[Message Batches API](https://platform.claude.com/docs/it/api/messages/batches/create):** Elabora grandi volumi di richieste Messages in modo asincrono con una riduzione dei costi del 50 percento (`POST /v1/messages/batches`)
* **[Token Counting API](https://platform.claude.com/docs/it/api/messages/count_tokens):** Conta i token in un messaggio prima dell’invio per gestire i costi e i limiti di velocità (`POST /v1/messages/count_tokens`)
* **[Models API](https://platform.claude.com/docs/it/api/models/list):** Elenca i modelli Claude disponibili e i relativi dettagli (`GET /v1/models`)
* **[Files API](https://platform.claude.com/docs/it/api/files/upload):** Carica e gestisci file da usare in più chiamate API (`POST /v1/files`, `GET /v1/files`)
* **[Skills API](https://platform.claude.com/docs/it/api/skills/create):** Crea e gestisci skill personalizzate per agenti (`POST /v1/skills`, `GET /v1/skills`)

Le seguenti API sono in beta:

* **[Agents API](https://platform.claude.com/docs/it/managed-agents/agent-setup):** Definisci configurazioni di agenti riutilizzabili e versionate per Claude Managed Agents (`POST /v1/agents`, `GET /v1/agents`)
* **[Sessions API](https://platform.claude.com/docs/it/managed-agents/sessions):** Esegui sessioni di agenti con stato in sandbox cloud gestite (`POST /v1/sessions`, `GET /v1/sessions/{id}/events/stream`)
* **[Environments API](https://platform.claude.com/docs/it/managed-agents/environments):** Configura i template di sandbox per le sessioni degli agenti (`POST /v1/environments`, `GET /v1/environments`)

Per il riferimento API completo con tutti gli endpoint, i parametri e gli schemi di risposta, esplora le pagine di riferimento API elencate nella navigazione. Per accedere alle funzionalità beta, consulta [Header beta](https://platform.claude.com/docs/it/api/beta-headers).

## Autenticazione

Per i dettagli su ciascun metodo di autenticazione e su quando utilizzarlo, consulta [Autenticazione](https://platform.claude.com/docs/it/manage-claude/authentication). Le richieste all’API di Claude includono questi header:

| Header                   | Valore                                                                                                                                                                                                                                                                                         | Obbligatorio                                                                                                                                                                                                                                                                                                            |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Authorization`          | `Bearer <token>`, dove `<token>` è la tua chiave API o un token di accesso di breve durata ottenuto da `POST /v1/oauth/token` tramite [Workload Identity Federation](https://platform.claude.com/docs/it/manage-claude/workload-identity-federation)                                           | Sì, a meno che non sia impostato `x-api-key`                                                                                                                                                                                                                                                                            |
| `x-api-key`              | La tua chiave API dalla Console. Alternativa legacy ad `Authorization`, ancora supportata                                                                                                                                                                                                      | No                                                                                                                                                                                                                                                                                                                      |
| `anthropic-workspace-id` | ID del [workspace](https://platform.claude.com/docs/it/manage-claude/workspaces) in cui viene eseguita la richiesta (ad esempio, `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`). Consulta [Selezionare un workspace](https://platform.claude.com/docs/it/manage-claude/authentication#select-a-workspace). | Obbligatorio con una chiave API non limitata a un workspace. Facoltativo per le altre chiavi API. Una chiave creata per un singolo workspace viene eseguita in quel workspace quando ometti l’header. Non usato con i token di Workload Identity Federation, che selezionano un workspace durante lo scambio del token. |
| `anthropic-version`      | Versione dell’API (ad esempio, `2026-10-21`)                                                                                                                                                                                                                                                   | Sì                                                                                                                                                                                                                                                                                                                      |
| `content-type`           | `application/json`                                                                                                                                                                                                                                                                             | Sì                                                                                                                                                                                                                                                                                                                      |

Se stai utilizzando gli [SDK client](https://platform.claude.com/docs/it/api/overview#client-sdks), l’SDK invia automaticamente gli header di autenticazione, versione e content-type; passi tu stesso `anthropic-workspace-id` quando la tua chiave lo richiede. Per i dettagli sul versionamento dell’API, consulta [Versioni dell’API](https://platform.claude.com/docs/it/api/versioning).

Quando accedi a Claude tramite una [piattaforma cloud](https://platform.claude.com/docs/it/api/overview#claude-api-vs-cloud-platforms), l’autenticazione è integrata con il sistema IAM del provider cloud. Consulta la documentazione specifica della piattaforma per i tipi di credenziali supportati, gli header richiesti e le opzioni di autenticazione.

### Ottenere le chiavi API

L’API è resa disponibile tramite la [Console](https://platform.claude.com/) web. Nella Console, puoi usare il [Playground](https://platform.claude.com/playground) (`platform.claude.com/playground`) per provare l’API nel browser e poi generare chiavi API nella pagina [Chiavi API](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`). Per sapere come fare, consulta [Ottieni la tua chiave API di Claude](https://platform.claude.com/docs/it/get-api-key). Scegli il tipo di ciascuna chiave (consulta [Tipi di chiave](https://platform.claude.com/docs/it/manage-claude/authentication#key-types)) e la sua [scadenza](https://platform.claude.com/docs/it/manage-claude/authentication#key-expiration) al momento della creazione. Usa i [workspace](https://platform.claude.com/settings/workspaces) nella Console per separare gli ambienti e [controllare la spesa](https://platform.claude.com/docs/it/api/rate-limits) per caso d’uso.

## SDK client

Anthropic fornisce SDK ufficiali che semplificano l’integrazione dell’API gestendo l’autenticazione, la formattazione delle richieste, la gestione degli errori e altro ancora.

**Vantaggi:**

* Gestione automatica degli header (autenticazione, `anthropic-version`, `content-type`)
* Gestione type-safe di richieste e risposte
* Logica di nuovo tentativo e gestione degli errori integrate
* Supporto per lo streaming
* Timeout delle richieste e gestione delle connessioni

Per un elenco degli SDK client, consulta [SDK, CLI e librerie](https://platform.claude.com/docs/it/cli-sdks-libraries/overview).

## API di Claude e piattaforme cloud a confronto

Claude è disponibile tramite la Claude API di prima parte e tramite piattaforme cloud. Scegli in base alla tua infrastruttura, alla disponibilità delle funzionalità, ai requisiti di conformità e alle preferenze di prezzo.

### API di Claude

* **Accesso diretto** ai modelli e alle funzionalità più recenti
* **Fatturazione e supporto Anthropic**
* **Ideale per:** Nuove integrazioni, accesso completo alle funzionalità, relazione diretta con Anthropic

### API delle piattaforme cloud

Accedi a Claude tramite AWS, Google Cloud o Microsoft Azure:

* **Integrato** con la fatturazione e l’IAM del provider cloud
* **La disponibilità delle funzionalità varia in base alla piattaforma:** Le piattaforme gestite da Anthropic includono [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/it/build-with-claude/claude-models-on-google-cloud/anthropic-managed) e [Microsoft Foundry](https://platform.claude.com/docs/it/build-with-claude/claude-in-microsoft-foundry); le piattaforme gestite da partner includono Claude Models on Google Cloud (Google managed) e Amazon Bedrock. Consulta la pagina di ciascuna piattaforma per la disponibilità e i tempi delle funzionalità.
* **Ideale per:** Impegni cloud esistenti, requisiti di conformità specifici, fatturazione cloud consolidata

| Piattaforma                                       | Provider                               | Documentazione                                                                                                                                                                                                                                                        |
| ------------------------------------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Models on Google Cloud (Google managed)    | Google Cloud                           | [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/it/build-with-claude/claude-models-on-google-cloud/google-managed)                                                                                                                  |
| Amazon Bedrock                                    | AWS                                    | [Claude in Amazon Bedrock (`bedrock-mantle`)](https://platform.claude.com/docs/it/build-with-claude/claude-in-amazon-bedrock) e [Claude su Amazon Bedrock (`bedrock-runtime`)](https://platform.claude.com/docs/it/build-with-claude/claude-on-amazon-bedrock-legacy) |
| Claude Platform on AWS                            | AWS (gestito da Anthropic)             | [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws)                                                                                                                                                                |
| Claude Models on Google Cloud (Anthropic managed) | Google Cloud (gestito da Anthropic)    | [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/it/build-with-claude/claude-models-on-google-cloud/anthropic-managed)                                                                                                            |
| Microsoft Foundry                                 | Microsoft Azure (gestito da Anthropic) | [Claude in Microsoft Foundry](https://platform.claude.com/docs/it/build-with-claude/claude-in-microsoft-foundry)                                                                                                                                                      |

<Note>
  Claude Managed Agents è disponibile tramite la Claude API di prima parte, [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws) e [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/it/build-with-claude/claude-models-on-google-cloud/anthropic-managed). Per la disponibilità delle funzionalità tra le piattaforme, consulta la [Panoramica delle funzionalità](https://platform.claude.com/docs/it/build-with-claude/overview).
</Note>

## Formato di richiesta e risposta

### Limiti di dimensione delle richieste

La Claude API di prima parte applica questi limiti di dimensione delle richieste:

| Endpoint                                                                                                                    | Dimensione massima della richiesta |
| --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Messaggi, Conteggio dei token                                                                                               | 128 MB                             |
| Message Batches API (consulta [Elaborazione batch](https://platform.claude.com/docs/it/build-with-claude/batch-processing)) | 256 MB                             |
| [Files API](https://platform.claude.com/docs/it/build-with-claude/files)                                                    | 500 MB                             |
| Sessioni, Agenti, Ambienti                                                                                                  | 32 MB                              |

Se superi questi limiti, riceverai un errore 413 `request_too_large`.

<Note>
  Le piattaforme gestite da partner hanno i propri limiti di dimensione delle richieste: Bedrock limita le richieste a 20 MB e Claude Models on Google Cloud (Google managed) limita le richieste a 30 MB. Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) e Microsoft Foundry supportano richieste Messages e di conteggio dei token fino a 32 MB. Consulta la documentazione della tua piattaforma per i valori attuali.
</Note>

### Header di risposta

L’API di Claude include i seguenti header nelle sue risposte:

| Header                      | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `request-id`                | Un identificatore univoco globale per la richiesta, come `req_018EeWyXxfu5pfWkrYcMdjWG`. Includilo quando contatti il supporto riguardo a una richiesta specifica. Consulta [ID della richiesta](https://platform.claude.com/docs/it/api/errors#request-id).                                                                                                                                                                                                                                                                                                                                                                                |
| `anthropic-organization-id` | L’ID dell’organizzazione a cui appartiene la chiave API o il token di accesso utilizzato nella richiesta.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `anthropic-workspace-id`    | L’ID con prefisso `wrkspc_` del [workspace](https://platform.claude.com/docs/it/manage-claude/workspaces) a cui la chiave API o il token di accesso è stato risolto, come `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`, incluso quando si tratta del Workspace predefinito della tua organizzazione. Assente quando la credenziale non si risolve in un workspace (ad esempio, nelle richieste Admin API) o la richiesta fallisce prima del completamento dell’autenticazione. Consulta [Identifica il workspace dietro una risposta API](https://platform.claude.com/docs/it/manage-claude/workspaces#identify-the-workspace-behind-an-api-response). |

Per gli header dei limiti di velocità, consulta [Header di risposta](https://platform.claude.com/docs/it/api/rate-limits#response-headers) in Limiti di velocità. Per esempi che leggono un header di risposta per nome con ciascun SDK, consulta [Identifica il workspace dietro una risposta API](https://platform.claude.com/docs/it/manage-claude/workspaces#identify-the-workspace-behind-an-api-response).

<Note>
  Claude Platform on AWS aggiunge un ID di richiesta AWS (`x-amzn-requestid`) accanto all’header standard `request-id`. Consulta [ID delle richieste](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws#request-ids) per il pattern di gestione del doppio ID.
</Note>

## Paginazione

Gli endpoint di elenco restituiscono i risultati in pagine. La maggior parte degli endpoint di elenco più recenti utilizza lo schema di cursore `page` e `next_page` descritto in questa sezione. Alcuni utilizzano uno schema diverso; consulta la nota alla fine di questa sezione. Usa il parametro di query `limit` per controllare la dimensione della pagina e il parametro di query `page` per recuperare una pagina adiacente. Ogni risposta include un array `data` insieme ai campi del cursore per navigare tra le pagine.

| Nome        | Posizione          | Descrizione                                                                                                                                                                                                      |
| ----------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`     | Parametro di query | Numero massimo di elementi da restituire per pagina.                                                                                                                                                             |
| `page`      | Parametro di query | Cursore opaco da una risposta precedente. Passa qui un valore `next_page` o `prev_page` per recuperare la pagina adiacente.                                                                                      |
| `order`     | Parametro di query | Direzione di ordinamento per i risultati (`asc` o `desc`), sugli endpoint di elenco che supportano l’ordinamento. Un cursore `page` è valido solo con l’`order` con cui è stato creato.                          |
| `next_page` | Campo di risposta  | Cursore per la pagina successiva, o `null` se non ci sono altri risultati.                                                                                                                                       |
| `prev_page` | Campo di risposta  | Cursore per la pagina precedente sugli endpoint che supportano la paginazione all’indietro (attualmente `GET /v1/sessions`), o `null` se sei sulla prima pagina. Gli altri endpoint di elenco omettono il campo. |

Per tornare indietro di una pagina, passa `prev_page` come parametro `page`. `prev_page` è `null` quando sei sulla prima pagina. Non tutti gli endpoint di elenco supportano `prev_page`. Solo `GET /v1/sessions` restituisce `prev_page`; sugli endpoint di elenco che non supportano la paginazione all’indietro, il campo è assente dalla risposta anziché `null`. Per una guida dettagliata alle richieste, consulta [Elencare le sessioni](https://platform.claude.com/docs/it/managed-agents/session-operations#listing-sessions).

L’SDK fornisce un iteratore con paginazione automatica che segue `next_page` per te. Ad esempio, `for session in client.beta.sessions.list()` (typescript: `for await (const session of client.beta.sessions.list())`; go: `client.Beta.Sessions.ListAutoPaging()`; java: `client.beta().sessions().list().autoPager()`; csharp: `(await client.Beta.Sessions.List()).Paginate()`; php: `$client->beta->sessions->list()->pagingEachItem()`; ruby: `client.beta.sessions.list.auto_paging_each`) scorre tutte le sessioni. La paginazione automatica dell’SDK procede solo in avanti; per tornare indietro di una pagina, leggi `prev_page` dalla risposta e ripassalo tu stesso come parametro `page`. Consulta [SDK, CLI e librerie](https://platform.claude.com/docs/it/cli-sdks-libraries/overview) per i dettagli.

<Note>
  Alcuni endpoint di elenco usano uno schema di cursore diverso. La Message Batches API (consulta [Elaborazione batch](https://platform.claude.com/docs/it/build-with-claude/batch-processing)), la [Models API](https://platform.claude.com/docs/it/api/models/list) e diversi endpoint dell’[Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api) accettano i parametri di query `after_id` e `before_id` invece di `page`. Le loro risposte restituiscono `has_more`, `first_id` e `last_id` invece di `next_page`. Consulta la pagina di riferimento di ciascun endpoint per i suoi campi di paginazione esatti.
</Note>

## Limiti di velocità e disponibilità

### Limiti di velocità

L’API applica limiti di velocità e limiti di spesa per prevenire abusi e gestire la capacità. I limiti sono organizzati in livelli di utilizzo; la tua organizzazione viene assegnata automaticamente a un livello e può passare a un livello superiore nel tempo. Ogni livello ha:

* **Limiti di spesa:** Costo mensile massimo per l’utilizzo dell’API
* **Limiti di velocità:** Numero massimo di richieste al minuto (RPM) e di token al minuto (TPM)

Puoi visualizzare i tuoi limiti di velocità in [Limiti di richieste nella Claude Console](https://platform.claude.com/usage/limits). I tuoi limiti di spesa si trovano in [Limiti di spesa nella Claude Console](https://platform.claude.com/settings/spend-limits) (`platform.claude.com/settings/spend-limits`). Per limiti di velocità più elevati o un tetto di spesa mensile più alto, usa **Richiedi un livello superiore** nella pagina **Limiti di richieste**.

Per informazioni dettagliate su limiti, livelli e l’algoritmo token bucket utilizzato per la limitazione della velocità, consulta [Limiti di velocità](https://platform.claude.com/docs/it/api/rate-limits).

### Disponibilità

L’API di Claude è disponibile in [molti paesi e regioni](https://platform.claude.com/docs/it/api/supported-regions) in tutto il mondo. Controlla la pagina delle regioni supportate per confermare la disponibilità nella tua posizione.

## Prossimi passi

<CardGroup cols={2}>
  <Card title="Riferimento Messages API" icon="book" href="https://platform.claude.com/docs/it/api/messages/create">
    Specifica API completa per le interazioni dirette con i modelli
  </Card>

  <Card title="Riferimento Claude Managed Agents" icon="brain" href="https://platform.claude.com/docs/it/managed-agents/sessions">
    Endpoint Agents, Sessions ed Environments
  </Card>

  <Card title="SDK client" icon="code" href="https://platform.claude.com/docs/it/cli-sdks-libraries/overview">
    Python, TypeScript, C#, Go, Java, PHP e Ruby
  </Card>

  <Card title="Limiti di velocità" icon="gauge" href="https://platform.claude.com/docs/it/api/rate-limits">
    Livelli di utilizzo, richiesta di limiti più elevati e l’algoritmo token bucket
  </Card>
</CardGroup>
