--- title: Residenza dei dati url: https://platform.claude.com/docs/it/manage-claude/data-residency description: Gestisci dove viene eseguita l'inferenza del modello e dove vengono archiviati i dati con controlli geografici. --- I controlli di "data residency" (residenza dei dati) ti consentono di gestire dove i tuoi dati vengono elaborati e archiviati. Due impostazioni indipendenti regolano questo aspetto: * **Inference geo:** Controlla dove viene eseguita l'inferenza del modello, per singola richiesta. Impostato tramite il parametro API `inference_geo` o come valore predefinito del workspace. * **Workspace geo:** Controlla dove i dati vengono archiviati a riposo e dove avviene l'elaborazione degli endpoint (come la transcodifica delle immagini e l'esecuzione del codice). Configurato a livello di workspace nella [Claude Console](https://platform.claude.com). [Claude Managed Agents](https://platform.claude.com/docs/it/managed-agents/overview) supporta il vincolo geografico a livello di agente: `inference_geo` nella [configurazione del modello di un agente](https://platform.claude.com/docs/it/managed-agents/agent-setup#pin-the-inference-geo) vincola l'area geografica che serve le richieste al modello per le sessioni che eseguono quell'agente, con [override per sessione](https://platform.claude.com/docs/it/managed-agents/sessions#pin-the-inference-geo-for-a-session) alla creazione della sessione. Gli agenti senza vincolo seguono l'inference geo predefinito del workspace per ogni richiesta. Managed Agents rispetta anche il Workspace geo configurato nella Console e, con le [sandbox self-hosted](https://platform.claude.com/docs/it/managed-agents/self-hosted-sandboxes), l'esecuzione degli strumenti e il filesystem della sandbox restano su un'infrastruttura sotto il tuo controllo; i contenuti dei [memory store](https://platform.claude.com/docs/it/managed-agents/self-hosted-sandboxes-memory) collegati restano archiviati da Anthropic e vengono copiati nella tua sandbox per la durata della sessione. ## Inference geo Per scoprire come la "zero data retention" (conservazione zero dei dati), o ZDR, si applica a questa funzionalità, consulta [API e conservazione dei dati](https://platform.claude.com/docs/it/manage-claude/api-and-data-retention). Il parametro `inference_geo` controlla dove viene eseguita l'inferenza del modello per una specifica richiesta API. Aggiungilo a qualsiasi chiamata `POST /v1/messages`. | Valore | Descrizione | | ---------- | ------------------------------------------------------------------------------------------------------------------------------- | | `"global"` | Predefinito. L'inferenza può essere eseguita in qualsiasi area geografica disponibile per prestazioni e disponibilità ottimali. | | `"us"` | L'inferenza viene eseguita solo su infrastruttura situata negli Stati Uniti. | ### Utilizzo dell'API ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 1024, "inference_geo": "us", "messages": [{ "role": "user", "content": "Summarize the key points of this document." }] }' ``` ```bash CLI ant messages create \ --model claude-opus-5-5 \ --max-tokens 1024 \ --inference-geo us \ --message '{role: user, content: "Summarize the key points of this document."}' \ --transform '{content.#(type=="text").text,usage.inference_geo}' --format yaml ``` ```python Python client = anthropic.Anthropic() response = client.messages.create( model="claude-opus-5-5", max_tokens=1024, inference_geo="us", messages=[ {"role": "user", "content": "Summarize the key points of this document."} ], ) for block in response.content: if block.type == "text": print(block.text) # Verifica dove è stata effettivamente eseguita l'inferenza print(f"Inference geo: {response.usage.inference_geo}") ``` ```typescript TypeScript const client = new Anthropic(); const response = await client.messages.create({ model: "claude-opus-5-5", max_tokens: 1024, inference_geo: "us", messages: [ { role: "user", content: "Summarize the key points of this document." } ] }); const textBlock = response.content.find( (block): block is Anthropic.TextBlock => block.type === "text" ); console.log(textBlock?.text); // Verifica dove è stata effettivamente eseguita l'inferenza console.log(`Inference geo: ${response.usage.inference_geo}`); ``` ```csharp C# var client = new AnthropicClient(); var response = await client.Messages.Create( new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 1024, InferenceGeo = "us", Messages = [ new() { Role = Role.User, Content = "Summarize the key points of this document." }, ], } ); foreach (var block in response.Content) { if (block.TryPickText(out var textBlock)) { Console.WriteLine(textBlock.Text); } } // Verifica dove è stata effettivamente eseguita l'inferenza Console.WriteLine($"Inference geo: {response.Usage.InferenceGeo}"); ``` ```go Go client := anthropic.NewClient() message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 1024, InferenceGeo: anthropic.String("us"), Messages: []anthropic.MessageParam{ anthropic.NewUserMessage(anthropic.NewTextBlock("Summarize the key points of this document.")), }, }) if err != nil { log.Fatal(err) } for _, block := range message.Content { if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok { fmt.Println(textBlock.Text) } } // Verifica dove è stata effettivamente eseguita l'inferenza fmt.Printf("Inference geo: %s\n", message.Usage.InferenceGeo) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); Message response = client.messages().create( MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(1024L) .inferenceGeo("us") .addUserMessage("Summarize the key points of this document.") .build()); response.content().stream() .flatMap(block -> block.text().stream()) .forEach(textBlock -> IO.println(textBlock.text())); // Verifica dove è stata effettivamente eseguita l'inferenza IO.println("Inference geo: " + response.usage().inferenceGeo().get()); ``` ```php PHP $client = new Client(); $response = $client->messages->create( model: 'claude-opus-5-5', maxTokens: 1024, inferenceGeo: 'us', messages: [ ['role' => 'user', 'content' => 'Summarize the key points of this document.'], ], ); foreach ($response->content as $block) { if ($block->type === 'text') { echo $block->text, PHP_EOL; } } // Verifica dove è stata effettivamente eseguita l'inferenza echo "Inference geo: {$response->usage->inferenceGeo}\n"; ``` ```ruby Ruby client = Anthropic::Client.new response = client.messages.create( model: "claude-opus-5-5", max_tokens: 1024, inference_geo: "us", messages: [ {role: "user", content: "Summarize the key points of this document."} ] ) response.content.each do |block| puts block.text if block.type == :text end # Verifica dove è stata effettivamente eseguita l'inferenza puts "Inference geo: #{response.usage.inference_geo}" ``` ### Risposta L'oggetto `usage` della risposta include un campo `inference_geo` che indica dove è stata eseguita l'inferenza: ```json Output { "usage": { "input_tokens": 25, "output_tokens": 150, "inference_geo": "us" } } ``` ### Disponibilità dei modelli Il parametro `inference_geo` è supportato su Claude 4.6 e modelli successivi. Le richieste con `inference_geo` su Claude Opus 4.5, Claude Sonnet 4.5 (deprecato), Claude Haiku 4.5 o modelli precedenti restituiscono un errore 400. Il parametro `inference_geo` è disponibile sulla Claude API (first-party) e su [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws). Su Amazon Bedrock e Google Cloud, la regione di inferenza è determinata dall'URL dell'endpoint o dal profilo di inferenza, quindi `inference_geo` non è applicabile. Su [Claude in Microsoft Foundry](https://platform.claude.com/docs/it/build-with-claude/claude-in-microsoft-foundry), `inference_geo` non è ugualmente applicabile: i deployment ospitati su Azure possono invece utilizzare il tipo di deployment US Data Zone Standard, che mantiene l'inferenza all'interno degli Stati Uniti. Il parametro `inference_geo` non è inoltre disponibile tramite l'[endpoint di compatibilità con l'OpenAI SDK](https://platform.claude.com/docs/it/cli-sdks-libraries/libraries/openai-sdk). ### Restrizioni a livello di workspace Le impostazioni del workspace supportano anche la limitazione degli inference geo disponibili: * **`allowed_inference_geos`:** Limita quali geo un workspace può utilizzare. Se una richiesta specifica un `inference_geo` non presente in questo elenco, l'API restituisce un errore. * **`default_inference_geo`:** Imposta il geo di fallback quando `inference_geo` viene omesso da una richiesta. Le singole richieste possono sovrascriverlo impostando esplicitamente `inference_geo`. Queste impostazioni possono essere configurate tramite la Console o l'[Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api) nel campo `data_residency`. ## Workspace geo Il Workspace geo viene impostato quando crei un workspace e non può essere modificato successivamente. Attualmente, `"us"` è l'unico workspace geo disponibile. Per impostare il workspace geo, crea un nuovo workspace nella [Console](https://platform.claude.com): 1. Nella Console, vai alla pagina [Workspaces](https://platform.claude.com/settings/workspaces) (`platform.claude.com/settings/workspaces`). 2. Fai clic su **Create workspace** per aprire la pagina [Create workspace](https://platform.claude.com/settings/workspaces/new) (`platform.claude.com/settings/workspaces/new`) nella Console. 3. Inserisci un nome, conferma il valore nel campo **Workspace geo** e fai clic su **Create workspace**. **Claude Platform on AWS:** Il Workspace geo non è configurabile. Le sessioni di Claude Managed Agents su questa piattaforma vengono eseguite con un Workspace geo effettivo pari a `"us"`, che è attualmente l'unico workspace geo disponibile. Consulta [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws) per le considerazioni sulla residenza dei dati specifiche di quella piattaforma. ## Prezzi I prezzi della residenza dei dati variano in base alla generazione del modello: * **Claude 4.6 e modelli successivi:** L'inferenza solo negli Stati Uniti (`inference_geo: "us"`) ha un prezzo pari a 1,1x la tariffa standard in tutte le categorie di prezzo dei token (token di input, token di output, scritture nella cache e letture dalla cache). Su Claude Haiku 5.5, il moltiplicatore si applica anche ai prezzi più elevati per i prompt oltre 100.000 token (consulta [Prezzi del contesto lungo](https://platform.claude.com/docs/it/about-claude/pricing#long-context-pricing)). * **Routing globale** (`inference_geo: "global"`): Si applicano i prezzi standard. * **Modelli precedenti:** Non supportano `inference_geo` (vedi [Disponibilità dei modelli](https://platform.claude.com/docs/it/manage-claude/data-residency#model-availability)); si applicano i prezzi standard. Le richieste che includono il parametro restituiscono un errore 400. Questi prezzi si applicano alla Claude API (first-party) e a Claude Platform on AWS. Su Claude in Microsoft Foundry, lo stesso moltiplicatore 1,1x si applica ai deployment ospitati su Azure che utilizzano il tipo di deployment US Data Zone Standard. Le piattaforme gestite dai partner (Bedrock e Google Cloud) hanno i propri prezzi regionali. Consulta [Prezzi della residenza dei dati](https://platform.claude.com/docs/it/about-claude/pricing#data-residency-pricing) per i dettagli. Lo stesso moltiplicatore si applica a [Claude Managed Agents](https://platform.claude.com/docs/it/managed-agents/overview): quando la [configurazione del modello](https://platform.claude.com/docs/it/managed-agents/agent-setup) di un agente fissa `inference_geo` su `"us"`, le richieste al modello nelle sessioni che eseguono quell'agente hanno un prezzo pari a 1,1x la tariffa standard. Se hai un impegno [Priority Tier](https://platform.claude.com/docs/it/api/service-tiers), il moltiplicatore 1,1x per l'inferenza solo negli Stati Uniti influisce anche sul modo in cui i token vengono conteggiati rispetto alla tua capacità Priority Tier. Ogni token consumato con `inference_geo: "us"` scala 1,1 token dal tuo TPM impegnato, in linea con il modo in cui altri moltiplicatori di prezzo (come la cache dei prompt) influiscono sui tassi di consumo. ## Supporto della Batch API Il parametro `inference_geo` è supportato sulla [Batch API](https://platform.claude.com/docs/it/build-with-claude/batch-processing). Ogni richiesta in un batch può specificare il proprio valore `inference_geo`. ## Migrazione dagli opt-out legacy Se la tua organizzazione aveva precedentemente effettuato l'opt-out dal routing globale per mantenere l'inferenza negli Stati Uniti, il tuo workspace è stato configurato automaticamente con `allowed_inference_geos: ["us"]` e `default_inference_geo: "us"`. Non sono necessarie modifiche al codice. I tuoi requisiti di residenza dei dati esistenti continuano a essere applicati tramite i nuovi controlli geo. ### Cosa è cambiato L'opt-out legacy era un'impostazione a livello di organizzazione che limitava tutte le richieste all'infrastruttura situata negli Stati Uniti. I nuovi controlli di residenza dei dati la sostituiscono con due meccanismi: * **Controllo per richiesta:** Il parametro `inference_geo` ti consente di specificare `"us"` o `"global"` in ogni chiamata API, offrendoti flessibilità a livello di richiesta. * **Controlli del workspace:** Le impostazioni `default_inference_geo` e `allowed_inference_geos` nella Console ti consentono di applicare policy geo su tutte le chiavi di un workspace. ### Cosa è successo al tuo workspace Il tuo workspace è stato migrato automaticamente: | Impostazione legacy | Nuovo equivalente | | ------------------------------------- | --------------------------------------------------------------- | | Opt-out dal routing globale (solo US) | `allowed_inference_geos: ["us"]`, `default_inference_geo: "us"` | Tutte le richieste API che utilizzano chiavi del tuo workspace continuano a essere eseguite su infrastruttura situata negli Stati Uniti. Non è necessaria alcuna azione per mantenere il comportamento attuale. ### Se vuoi utilizzare il routing globale Se i tuoi requisiti di residenza dei dati sono cambiati e vuoi sfruttare il routing globale per prestazioni e disponibilità migliori, aggiorna le impostazioni di inference geo del tuo workspace per includere `"global"` tra i geo consentiti e imposta `default_inference_geo` su `"global"`. Consulta [Restrizioni a livello di workspace](https://platform.claude.com/docs/it/manage-claude/data-residency#workspace-level-restrictions) per i dettagli. ### Impatto sui prezzi I modelli legacy non sono interessati da questa migrazione. Per i prezzi attuali dei modelli più recenti, consulta [Prezzi](https://platform.claude.com/docs/it/manage-claude/data-residency#pricing). ## Limitazioni attuali * **Limiti di velocità condivisi:** I "rate limits" (limiti di velocità) sono condivisi tra tutti i geo. * **Inference geo:** Sono disponibili solo `"us"` e `"global"`. * **Workspace geo:** Attualmente è disponibile solo `"us"`. Il Workspace geo non può essere modificato dopo la creazione del workspace. ## Passaggi successivi Visualizza i dettagli sui prezzi della residenza dei dati. Scopri la configurazione dei workspace. Monitora utilizzo e costi per residenza dei dati.