--- title: Datenresidenz url: https://platform.claude.com/docs/de/manage-claude/data-residency description: Verwalte mit geografischen Kontrollen, wo die Modellinferenz ausgeführt wird und wo Daten gespeichert werden. --- Mit Kontrollen zur „data residency“ (Datenresidenz) kannst du verwalten, wo deine Daten verarbeitet und gespeichert werden. Zwei voneinander unabhängige Einstellungen regeln dies: * **Inference geo:** Steuert pro Anfrage, wo die Modellinferenz ausgeführt wird. Wird über den API-Parameter `inference_geo` oder als Workspace-Standard festgelegt. * **Workspace geo:** Steuert, wo Daten im Ruhezustand gespeichert werden und wo die Endpunktverarbeitung (wie Bildtranskodierung und Codeausführung) stattfindet. Wird auf Workspace-Ebene in der [Claude Console](https://platform.claude.com) konfiguriert. [Claude Managed Agents](https://platform.claude.com/docs/de/managed-agents/overview) unterstützt geografisches Pinning auf Agent-Ebene: `inference_geo` in der [Modellkonfiguration eines Agenten](https://platform.claude.com/docs/de/managed-agents/agent-setup#pin-the-inference-geo) legt die Geografie fest, die Modellanfragen für Sessions bedient, in denen dieser Agent läuft, mit [Überschreibungen pro Session](https://platform.claude.com/docs/de/managed-agents/sessions#pin-the-inference-geo-for-a-session) beim Erstellen der Session. Agenten ohne Pinning folgen bei jeder Anfrage der Standard-Inference-Geo des Workspace. Managed Agents berücksichtigt außerdem die in der Console konfigurierte Workspace geo, und mit [selbst gehosteten Sandboxes](https://platform.claude.com/docs/de/managed-agents/self-hosted-sandboxes) bleiben die Tool-Ausführung und das Sandbox-Dateisystem auf Infrastruktur, die du kontrollierst; die Inhalte angehängter [Memory Stores](https://platform.claude.com/docs/de/managed-agents/self-hosted-sandboxes-memory) bleiben bei Anthropic gespeichert und werden für die Session in deine Sandbox kopiert. ## Inference geo Um zu erfahren, wie „zero data retention“ (Null-Datenspeicherung), oder ZDR, auf diese Funktion angewendet wird, siehe [API und Datenspeicherung](https://platform.claude.com/docs/de/manage-claude/api-and-data-retention). Der Parameter `inference_geo` steuert, wo die Modellinferenz für eine bestimmte API-Anfrage ausgeführt wird. Füge ihn zu jedem beliebigen `POST /v1/messages`-Aufruf hinzu. | Wert | Beschreibung | | ---------- | --------------------------------------------------------------------------------------------------------------------------------- | | `"global"` | Standard. Die Inferenz kann in jeder verfügbaren Geografie ausgeführt werden, um optimale Leistung und Verfügbarkeit zu erzielen. | | `"us"` | Die Inferenz wird ausschließlich auf US-basierter Infrastruktur ausgeführt. | ### API-Nutzung ```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) # Prüfe, wo die Inferenz tatsächlich ausgeführt wurde 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); // Prüfe, wo die Inferenz tatsächlich ausgeführt wurde 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); } } // Prüfe, wo die Inferenz tatsächlich ausgeführt wurde 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) } } // Prüfe, wo die Inferenz tatsächlich ausgeführt wurde 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())); // Prüfe, wo die Inferenz tatsächlich ausgeführt wurde 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; } } // Prüfe, wo die Inferenz tatsächlich ausgeführt wurde 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 # Prüfe, wo die Inferenz tatsächlich ausgeführt wurde puts "Inference geo: #{response.usage.inference_geo}" ``` ### Antwort Das `usage`-Objekt der Antwort enthält ein Feld `inference_geo`, das angibt, wo die Inferenz ausgeführt wurde: ```json Output { "usage": { "input_tokens": 25, "output_tokens": 150, "inference_geo": "us" } } ``` ### Modellverfügbarkeit Der Parameter `inference_geo` wird von Claude 4.6 und neueren Modellen unterstützt. Anfragen mit `inference_geo` an Claude Opus 4.5, Claude Sonnet 4.5 (abgekündigt), Claude Haiku 4.5 oder ältere Modelle geben einen 400-Fehler zurück. Der Parameter `inference_geo` ist auf der Claude API (First-Party) und auf [Claude Platform on AWS](https://platform.claude.com/docs/de/build-with-claude/claude-platform-on-aws) verfügbar. Auf Amazon Bedrock und Google Cloud wird die Inferenzregion durch die Endpunkt-URL oder das Inferenzprofil bestimmt, sodass `inference_geo` nicht anwendbar ist. Auf [Claude in Microsoft Foundry](https://platform.claude.com/docs/de/build-with-claude/claude-in-microsoft-foundry) ist `inference_geo` ebenfalls nicht anwendbar: Auf Azure gehostete Deployments können stattdessen den Deployment-Typ US Data Zone Standard verwenden, der die Inferenz innerhalb der Vereinigten Staaten hält. Der Parameter `inference_geo` ist außerdem nicht über den [OpenAI-SDK-Kompatibilitätsendpunkt](https://platform.claude.com/docs/de/cli-sdks-libraries/libraries/openai-sdk) verfügbar. ### Einschränkungen auf Workspace-Ebene Die Workspace-Einstellungen unterstützen außerdem die Einschränkung, welche Inference geos verfügbar sind: * **`allowed_inference_geos`:** Schränkt ein, welche Geos ein Workspace verwenden kann. Wenn eine Anfrage eine `inference_geo` angibt, die nicht in dieser Liste enthalten ist, gibt die API einen Fehler zurück. * **`default_inference_geo`:** Legt die Fallback-Geo fest, wenn `inference_geo` in einer Anfrage weggelassen wird. Einzelne Anfragen können dies überschreiben, indem sie `inference_geo` explizit setzen. Diese Einstellungen können über die Console oder die [Admin API](https://platform.claude.com/docs/de/manage-claude/admin-api) unter dem Feld `data_residency` konfiguriert werden. ## Workspace geo Die Workspace geo wird beim Erstellen eines Workspace festgelegt und kann danach nicht mehr geändert werden. Derzeit ist `"us"` die einzige verfügbare Workspace geo. Um die Workspace geo festzulegen, erstelle einen neuen Workspace in der [Console](https://platform.claude.com): 1. Gehe in der Console zur Seite [Workspaces](https://platform.claude.com/settings/workspaces) (`platform.claude.com/settings/workspaces`). 2. Klicke auf **Create workspace**, um die Seite [Create workspace](https://platform.claude.com/settings/workspaces/new) (`platform.claude.com/settings/workspaces/new`) in der Console zu öffnen. 3. Gib einen Namen ein, bestätige den Wert im Feld **Workspace geo** und klicke auf **Create workspace**. **Claude Platform on AWS:** Die Workspace geo ist nicht konfigurierbar. Claude Managed Agents-Sessions auf dieser Plattform laufen mit einer effektiven Workspace geo von `"us"`, was derzeit die einzige verfügbare Workspace geo ist. Siehe [Claude Platform on AWS](https://platform.claude.com/docs/de/build-with-claude/claude-platform-on-aws) für plattformspezifische Überlegungen zur Datenresidenz. ## Preise Die Preise für Datenresidenz variieren je nach Modellgeneration: * **Claude 4.6 und neuere Modelle:** Reine US-Inferenz (`inference_geo: "us"`) wird mit dem 1,1-Fachen des Standardtarifs über alle Token-Preiskategorien hinweg berechnet (Input-Token, Output-Token, Cache-Schreibvorgänge und Cache-Lesevorgänge). Bei Claude Haiku 5.5 gilt der Multiplikator auch für die höheren Preise bei Prompts über 100.000 Token (siehe [Preise für langen Kontext](https://platform.claude.com/docs/de/about-claude/pricing#long-context-pricing)). * **Globales Routing** (`inference_geo: "global"`): Es gelten die Standardpreise. * **Ältere Modelle:** Unterstützen `inference_geo` nicht (siehe [Modellverfügbarkeit](https://platform.claude.com/docs/de/manage-claude/data-residency#model-availability)); es gelten die Standardpreise. Anfragen, die den Parameter enthalten, geben einen 400-Fehler zurück. Diese Preise gelten für die Claude API (First-Party) und Claude Platform on AWS. Auf Claude in Microsoft Foundry gilt derselbe Multiplikator von 1,1x für auf Azure gehostete Deployments, die den Deployment-Typ US Data Zone Standard verwenden. Von Partnern betriebene Plattformen (Bedrock und Google Cloud) haben ihre eigenen regionalen Preise. Siehe [Preise für Datenresidenz](https://platform.claude.com/docs/de/about-claude/pricing#data-residency-pricing) für Details. Derselbe Multiplikator gilt für [Claude Managed Agents](https://platform.claude.com/docs/de/managed-agents/overview): Wenn die [Modellkonfiguration](https://platform.claude.com/docs/de/managed-agents/agent-setup) eines Agenten `inference_geo` auf `"us"` festlegt, werden Modellanfragen in Sessions, in denen dieser Agent läuft, mit dem 1,1-Fachen des Standardtarifs berechnet. Wenn du eine [Priority Tier](https://platform.claude.com/docs/de/api/service-tiers)-Verpflichtung hast, wirkt sich der Multiplikator von 1,1x für reine US-Inferenz auch darauf aus, wie Token auf deine Priority-Tier-Kapazität angerechnet werden. Jedes mit `inference_geo: "us"` verbrauchte Token zieht 1,1 Token von deinem zugesagten TPM ab, im Einklang damit, wie andere Preismultiplikatoren (wie Prompt-Caching) die Burndown-Raten beeinflussen. ## Batch-API-Unterstützung Der Parameter `inference_geo` wird von der [Batch API](https://platform.claude.com/docs/de/build-with-claude/batch-processing) unterstützt. Jede Anfrage in einem Batch kann ihren eigenen `inference_geo`-Wert angeben. ## Migration von veralteten Opt-outs Wenn deine Organisation sich zuvor vom globalen Routing abgemeldet hat, um die Inferenz in den USA zu halten, wurde dein Workspace automatisch mit `allowed_inference_geos: ["us"]` und `default_inference_geo: "us"` konfiguriert. Es sind keine Codeänderungen erforderlich. Deine bestehenden Anforderungen an die Datenresidenz werden weiterhin über die neuen Geo-Kontrollen durchgesetzt. ### Was sich geändert hat Das veraltete Opt-out war eine Einstellung auf Organisationsebene, die alle Anfragen auf US-basierte Infrastruktur beschränkte. Die neuen Kontrollen zur Datenresidenz ersetzen dies durch zwei Mechanismen: * **Kontrolle pro Anfrage:** Mit dem Parameter `inference_geo` kannst du bei jedem API-Aufruf `"us"` oder `"global"` angeben, was dir Flexibilität auf Anfrageebene gibt. * **Workspace-Kontrollen:** Mit den Einstellungen `default_inference_geo` und `allowed_inference_geos` in der Console kannst du Geo-Richtlinien für alle Keys in einem Workspace durchsetzen. ### Was mit deinem Workspace passiert ist Dein Workspace wurde automatisch migriert: | Veraltete Einstellung | Neue Entsprechung | | -------------------------------------- | --------------------------------------------------------------- | | Opt-out vom globalen Routing (nur USA) | `allowed_inference_geos: ["us"]`, `default_inference_geo: "us"` | Alle API-Anfragen, die Keys aus deinem Workspace verwenden, laufen weiterhin auf US-basierter Infrastruktur. Es ist keine Aktion erforderlich, um dein aktuelles Verhalten beizubehalten. ### Wenn du globales Routing nutzen möchtest Wenn sich deine Anforderungen an die Datenresidenz geändert haben und du globales Routing für bessere Leistung und Verfügbarkeit nutzen möchtest, aktualisiere die Inference-geo-Einstellungen deines Workspace, sodass `"global"` in den erlaubten Geos enthalten ist, und setze `default_inference_geo` auf `"global"`. Siehe [Einschränkungen auf Workspace-Ebene](https://platform.claude.com/docs/de/manage-claude/data-residency#workspace-level-restrictions) für Details. ### Auswirkungen auf die Preise Veraltete Modelle sind von dieser Migration nicht betroffen. Die aktuellen Preise für neuere Modelle findest du unter [Preise](https://platform.claude.com/docs/de/manage-claude/data-residency#pricing). ## Aktuelle Einschränkungen * **Gemeinsame Ratenlimits:** Ratenlimits werden über alle Geos hinweg geteilt. * **Inference geo:** Nur `"us"` und `"global"` sind verfügbar. * **Workspace geo:** Derzeit ist nur `"us"` verfügbar. Die Workspace geo kann nach der Erstellung des Workspace nicht mehr geändert werden. ## Nächste Schritte Sieh dir die Preisdetails zur Datenresidenz an. Erfahre mehr über die Workspace-Konfiguration. Verfolge Nutzung und Kosten nach Datenresidenz.