--- title: Résidence des données url: https://platform.claude.com/docs/fr/manage-claude/data-residency description: Gérez l'endroit où s'exécute l'inférence du modèle et où les données sont stockées grâce à des contrôles géographiques. --- Les contrôles de « data residency » (résidence des données) vous permettent de gérer l'endroit où vos données sont traitées et stockées. Deux paramètres indépendants régissent cela : * **Inference geo (zone géographique d'inférence) :** contrôle l'endroit où s'exécute l'inférence du modèle, requête par requête. Défini via le paramètre API `inference_geo` ou comme valeur par défaut de l'espace de travail. * **Workspace geo (zone géographique de l'espace de travail) :** contrôle l'endroit où les données sont stockées au repos et où s'effectue le traitement des points de terminaison (comme le transcodage d'images et l'exécution de code). Configuré au niveau de l'espace de travail dans la [Claude Console](https://platform.claude.com). [Claude Managed Agents](https://platform.claude.com/docs/fr/managed-agents/overview) prend en charge l'épinglage géographique au niveau de l'agent : `inference_geo` dans la [configuration du modèle d'un agent](https://platform.claude.com/docs/fr/managed-agents/agent-setup#pin-the-inference-geo) épingle la zone géographique qui traite les requêtes au modèle pour les sessions exécutant cet agent, avec des [remplacements par session](https://platform.claude.com/docs/fr/managed-agents/sessions#pin-the-inference-geo-for-a-session) lors de la création de la session. Les agents sans épinglage suivent la zone géographique d'inférence par défaut de l'espace de travail pour chaque requête. Managed Agents respecte également la Workspace geo configurée dans la Console, et avec les [sandboxes auto-hébergées](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes), l'exécution des outils et le système de fichiers de la sandbox restent sur une infrastructure que vous contrôlez ; le contenu des [magasins de mémoire](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes-memory) attachés reste stocké par Anthropic et est copié dans votre sandbox pour la durée de la session. ## Zone géographique d'inférence Pour savoir comment la « zero data retention » (rétention zéro des données), ou ZDR, s'applique à cette fonctionnalité, consultez [API et rétention des données](https://platform.claude.com/docs/fr/manage-claude/api-and-data-retention). Le paramètre `inference_geo` contrôle l'endroit où s'exécute l'inférence du modèle pour une requête API spécifique. Ajoutez-le à n'importe quel appel `POST /v1/messages`. | Valeur | Description | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `"global"` | Valeur par défaut. L'inférence peut s'exécuter dans n'importe quelle zone géographique disponible pour des performances et une disponibilité optimales. | | `"us"` | L'inférence s'exécute uniquement sur une infrastructure basée aux États-Unis. | ### Utilisation de l'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) # Vérifiez où l'inférence s'est réellement exécutée. 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); // Vérifiez où l'inférence s'est réellement exécutée. 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); } } // Vérifiez où l'inférence a réellement été exécutée. 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) } } // Vérifiez où l'inférence a réellement été exécutée. 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())); // Vérifiez où l'inférence a réellement été exécutée. 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; } } // Vérifiez où l'inférence s'est réellement exécutée. 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 # Vérifiez où l'inférence a réellement été exécutée. puts "Inference geo: #{response.usage.inference_geo}" ``` ### Réponse L'objet `usage` de la réponse inclut un champ `inference_geo` indiquant où l'inférence s'est exécutée : ```json Output { "usage": { "input_tokens": 25, "output_tokens": 150, "inference_geo": "us" } } ``` ### Disponibilité des modèles Le paramètre `inference_geo` est pris en charge sur Claude 4.6 et les modèles ultérieurs. Les requêtes avec `inference_geo` sur Claude Opus 4.5, Claude Sonnet 4.5 (déprécié), Claude Haiku 4.5 ou des modèles antérieurs renvoient une erreur 400. Le paramètre `inference_geo` est disponible sur la Claude API (première partie) et sur [Claude Platform on AWS](https://platform.claude.com/docs/fr/build-with-claude/claude-platform-on-aws). Sur Amazon Bedrock et Google Cloud, la région d'inférence est déterminée par l'URL du point de terminaison ou le profil d'inférence, donc `inference_geo` ne s'applique pas. Sur [Claude dans Microsoft Foundry](https://platform.claude.com/docs/fr/build-with-claude/claude-in-microsoft-foundry), `inference_geo` ne s'applique pas non plus : les déploiements hébergés sur Azure peuvent à la place utiliser le type de déploiement US Data Zone Standard, qui maintient l'inférence aux États-Unis. Le paramètre `inference_geo` n'est pas non plus disponible via le [point de terminaison de compatibilité avec le SDK OpenAI](https://platform.claude.com/docs/fr/cli-sdks-libraries/libraries/openai-sdk). ### Restrictions au niveau de l'espace de travail Les paramètres de l'espace de travail permettent également de restreindre les zones géographiques d'inférence disponibles : * **`allowed_inference_geos` :** restreint les zones géographiques qu'un espace de travail peut utiliser. Si une requête spécifie un `inference_geo` qui ne figure pas dans cette liste, l'API renvoie une erreur. * **`default_inference_geo` :** définit la zone géographique de repli lorsque `inference_geo` est omis d'une requête. Les requêtes individuelles peuvent remplacer cette valeur en définissant explicitement `inference_geo`. Ces paramètres peuvent être configurés via la Console ou l'[Admin API](https://platform.claude.com/docs/fr/manage-claude/admin-api) sous le champ `data_residency`. ## Workspace geo La Workspace geo est définie lorsque vous créez un espace de travail et ne peut pas être modifiée par la suite. Actuellement, `"us"` est la seule Workspace geo disponible. Pour définir la Workspace geo, créez un nouvel espace de travail dans la [Console](https://platform.claude.com) : 1. Dans la Console, accédez à la page [Workspaces](https://platform.claude.com/settings/workspaces) (`platform.claude.com/settings/workspaces`). 2. Cliquez sur **Create workspace** pour ouvrir la page [Create workspace](https://platform.claude.com/settings/workspaces/new) (`platform.claude.com/settings/workspaces/new`) dans la Console. 3. Saisissez un nom, confirmez la valeur du champ **Workspace geo**, puis cliquez sur **Create workspace**. **Claude Platform on AWS :** la Workspace geo n'est pas configurable. Les sessions Claude Managed Agents sur cette plateforme s'exécutent avec une Workspace geo effective de `"us"`, qui est actuellement la seule Workspace geo disponible. Consultez [Claude Platform on AWS](https://platform.claude.com/docs/fr/build-with-claude/claude-platform-on-aws) pour les considérations de résidence des données propres à cette plateforme. ## Tarification La tarification de la résidence des données varie selon la génération du modèle : * **Claude 4.6 et modèles ultérieurs :** l'inférence limitée aux États-Unis (`inference_geo: "us"`) est facturée à 1,1x le tarif standard pour toutes les catégories de tarification des tokens (tokens d'entrée, tokens de sortie, écritures en cache et lectures en cache). Sur Claude Haiku 5.5, le multiplicateur s'applique également aux prix plus élevés pour les prompts de plus de 100 000 tokens (voir [Tarification du contexte long](https://platform.claude.com/docs/fr/about-claude/pricing#long-context-pricing)). * **Routage global** (`inference_geo: "global"`) : la tarification standard s'applique. * **Modèles plus anciens :** ne prennent pas en charge `inference_geo` (voir [Disponibilité des modèles](https://platform.claude.com/docs/fr/manage-claude/data-residency#model-availability)) ; la tarification standard s'applique. Les requêtes qui incluent le paramètre renvoient une erreur 400. Cette tarification s'applique à la Claude API (première partie) et à Claude Platform on AWS. Sur Claude dans Microsoft Foundry, le même multiplicateur de 1,1x s'applique aux déploiements hébergés sur Azure qui utilisent le type de déploiement US Data Zone Standard. Les plateformes exploitées par des partenaires (Bedrock et Google Cloud) ont leur propre tarification régionale. Consultez [Tarification de la résidence des données](https://platform.claude.com/docs/fr/about-claude/pricing#data-residency-pricing) pour plus de détails. Le même multiplicateur s'applique à [Claude Managed Agents](https://platform.claude.com/docs/fr/managed-agents/overview) : lorsque la [configuration de modèle](https://platform.claude.com/docs/fr/managed-agents/agent-setup) d'un agent épingle `inference_geo` sur `"us"`, les requêtes de modèle dans les sessions exécutant cet agent sont facturées à 1,1x le tarif standard. Si vous avez un engagement [Priority Tier](https://platform.claude.com/docs/fr/api/service-tiers), le multiplicateur de 1,1x pour l'inférence limitée aux États-Unis affecte également la façon dont les tokens sont comptabilisés par rapport à votre capacité Priority Tier. Chaque token consommé avec `inference_geo: "us"` déduit 1,1 token de votre TPM engagé, conformément à la façon dont les autres multiplicateurs de tarification (comme la mise en cache des prompts) affectent les taux de consommation. ## Prise en charge de l'API Batch Le paramètre `inference_geo` est pris en charge sur l'[API Batch](https://platform.claude.com/docs/fr/build-with-claude/batch-processing). Chaque requête d'un lot peut spécifier sa propre valeur `inference_geo`. ## Migration depuis les anciennes options de désactivation Si votre organisation avait auparavant désactivé le routage global pour maintenir l'inférence aux États-Unis, votre espace de travail a été automatiquement configuré avec `allowed_inference_geos: ["us"]` et `default_inference_geo: "us"`. Aucune modification de code n'est requise. Vos exigences existantes en matière de résidence des données continuent d'être appliquées via les nouveaux contrôles géographiques. ### Ce qui a changé L'ancienne option de désactivation était un paramètre au niveau de l'organisation qui restreignait toutes les requêtes à une infrastructure basée aux États-Unis. Les nouveaux contrôles de résidence des données la remplacent par deux mécanismes : * **Contrôle par requête :** le paramètre `inference_geo` vous permet de spécifier `"us"` ou `"global"` à chaque appel API, vous offrant une flexibilité au niveau de la requête. * **Contrôles de l'espace de travail :** les paramètres `default_inference_geo` et `allowed_inference_geos` dans la Console vous permettent d'appliquer des politiques géographiques à toutes les clés d'un espace de travail. ### Ce qui est arrivé à votre espace de travail Votre espace de travail a été migré automatiquement : | Ancien paramètre | Nouvel équivalent | | ------------------------------------------------------- | --------------------------------------------------------------- | | Désactivation du routage global (États-Unis uniquement) | `allowed_inference_geos: ["us"]`, `default_inference_geo: "us"` | Toutes les requêtes API utilisant des clés de votre espace de travail continuent de s'exécuter sur une infrastructure basée aux États-Unis. Aucune action n'est nécessaire pour conserver votre comportement actuel. ### Si vous souhaitez utiliser le routage global Si vos exigences en matière de résidence des données ont changé et que vous souhaitez profiter du routage global pour de meilleures performances et une meilleure disponibilité, mettez à jour les paramètres de zone géographique d'inférence de votre espace de travail pour inclure `"global"` dans les zones géographiques autorisées et définissez `default_inference_geo` sur `"global"`. Consultez [Restrictions au niveau de l'espace de travail](https://platform.claude.com/docs/fr/manage-claude/data-residency#workspace-level-restrictions) pour plus de détails. ### Impact sur la tarification Les anciens modèles ne sont pas affectés par cette migration. Pour la tarification actuelle des modèles plus récents, consultez [Tarification](https://platform.claude.com/docs/fr/manage-claude/data-residency#pricing). ## Limitations actuelles * **Limites de débit partagées :** les limites de débit sont partagées entre toutes les zones géographiques. * **Inference geo :** seules `"us"` et `"global"` sont disponibles. * **Workspace geo :** seule `"us"` est actuellement disponible. La Workspace geo ne peut pas être modifiée après la création de l'espace de travail. ## Étapes suivantes Consultez les détails de la tarification de la résidence des données. Découvrez la configuration des espaces de travail. Suivez l'utilisation et les coûts par résidence des données.