--- title: Residência de dados url: https://platform.claude.com/docs/pt-BR/manage-claude/data-residency description: Gerencie onde a inferência do modelo é executada e onde os dados são armazenados com controles geográficos. --- Os controles de "data residency" (residência de dados) permitem que você gerencie onde seus dados são processados e armazenados. Duas configurações independentes governam isso: * **Inference geo:** Controla onde a inferência do modelo é executada, por requisição. Definido por meio do parâmetro de API `inference_geo` ou como padrão do workspace. * **Workspace geo:** Controla onde os dados são armazenados em repouso e onde o processamento de endpoint (como transcodificação de imagens e execução de código) acontece. Configurado no nível do workspace no [Claude Console](https://platform.claude.com). O [Claude Managed Agents](https://platform.claude.com/docs/pt-BR/managed-agents/overview) oferece suporte à fixação geográfica no nível do agente: `inference_geo` na [configuração de modelo de um agente](https://platform.claude.com/docs/pt-BR/managed-agents/agent-setup#pin-the-inference-geo) fixa a geografia que atende às requisições de modelo para sessões que executam esse agente, com [substituições por sessão](https://platform.claude.com/docs/pt-BR/managed-agents/sessions#pin-the-inference-geo-for-a-session) na criação da sessão. Agentes sem fixação seguem o inference geo padrão do workspace em cada requisição. O Managed Agents também respeita o Workspace geo configurado no Console e, com [sandboxes auto-hospedados](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes), a execução de ferramentas e o sistema de arquivos do sandbox permanecem em uma infraestrutura que você controla; o conteúdo dos [memory stores](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes-memory) anexados permanece armazenado pela Anthropic e é copiado para o seu sandbox durante a sessão. ## Inference geo Para saber como a "zero data retention" (retenção zero de dados), ou ZDR, se aplica a este recurso, consulte [API e retenção de dados](https://platform.claude.com/docs/pt-BR/manage-claude/api-and-data-retention). O parâmetro `inference_geo` controla onde a inferência do modelo é executada para uma requisição de API específica. Adicione-o a qualquer chamada `POST /v1/messages`. | Valor | Descrição | | ---------- | ------------------------------------------------------------------------------------------------------------------ | | `"global"` | Padrão. A inferência pode ser executada em qualquer geografia disponível para desempenho e disponibilidade ideais. | | `"us"` | A inferência é executada apenas em infraestrutura baseada nos EUA. | ### Uso da 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) # Verifique onde a inferência foi realmente executada 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); // Verifique onde a inferência foi realmente executada 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); } } // Verifique onde a inferência foi realmente executada 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) } } // Verifique onde a inferência foi realmente executada 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())); // Verifique onde a inferência foi realmente executada 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; } } // Verifique onde a inferência foi realmente executada 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 # Verifique onde a inferência foi realmente executada puts "Inference geo: #{response.usage.inference_geo}" ``` ### Resposta O objeto `usage` da resposta inclui um campo `inference_geo` indicando onde a inferência foi executada: ```json Output { "usage": { "input_tokens": 25, "output_tokens": 150, "inference_geo": "us" } } ``` ### Disponibilidade de modelos O parâmetro `inference_geo` é suportado no Claude 4.6 e em modelos posteriores. Requisições com `inference_geo` no Claude Opus 4.5, Claude Sonnet 4.5 (descontinuado), Claude Haiku 4.5 ou modelos anteriores retornam um erro 400. O parâmetro `inference_geo` está disponível na Claude API (primária) e no [Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws). No Amazon Bedrock e no Google Cloud, a região de inferência é determinada pela URL do endpoint ou pelo perfil de inferência, portanto `inference_geo` não se aplica. No [Claude no Microsoft Foundry](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-microsoft-foundry), `inference_geo` também não se aplica: implantações hospedadas no Azure podem, em vez disso, usar o tipo de implantação US Data Zone Standard, que mantém a inferência dentro dos Estados Unidos. O parâmetro `inference_geo` também não está disponível por meio do [endpoint de compatibilidade com o OpenAI SDK](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/libraries/openai-sdk). ### Restrições no nível do workspace As configurações do workspace também permitem restringir quais inference geos estão disponíveis: * **`allowed_inference_geos`:** Restringe quais geos um workspace pode usar. Se uma requisição especificar um `inference_geo` que não esteja nesta lista, a API retorna um erro. * **`default_inference_geo`:** Define o geo de fallback quando `inference_geo` é omitido de uma requisição. Requisições individuais podem substituir isso definindo `inference_geo` explicitamente. Essas configurações podem ser definidas por meio do Console ou da [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api) no campo `data_residency`. ## Workspace geo O Workspace geo é definido quando você cria um workspace e não pode ser alterado depois. Atualmente, `"us"` é o único workspace geo disponível. Para definir o workspace geo, crie um novo workspace no [Console](https://platform.claude.com): 1. No Console, acesse a página [Workspaces](https://platform.claude.com/settings/workspaces) (`platform.claude.com/settings/workspaces`). 2. Clique em **Create workspace** para abrir a página [Create workspace](https://platform.claude.com/settings/workspaces/new) (`platform.claude.com/settings/workspaces/new`) no Console. 3. Insira um nome, confirme o valor no campo **Workspace geo** e clique em **Create workspace**. **Claude Platform on AWS:** O Workspace geo não é configurável. As sessões do Claude Managed Agents nesta plataforma são executadas com um Workspace geo efetivo de `"us"`, que atualmente é o único workspace geo disponível. Consulte [Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws) para considerações de residência de dados específicas dessa plataforma. ## Preços Os preços de residência de dados variam de acordo com a geração do modelo: * **Claude 4.6 e modelos posteriores:** A inferência somente nos EUA (`inference_geo: "us"`) tem preço de 1,1x a tarifa padrão em todas as categorias de preço de tokens (tokens de entrada, tokens de saída, gravações em cache e leituras de cache). No Claude Haiku 5.5, o multiplicador também se aplica aos preços mais altos para prompts acima de 100.000 tokens (consulte [Preços de contexto longo](https://platform.claude.com/docs/pt-BR/about-claude/pricing#long-context-pricing)). * **Roteamento global** (`inference_geo: "global"`): Aplicam-se os preços padrão. * **Modelos mais antigos:** Não oferecem suporte a `inference_geo` (consulte [Disponibilidade de modelos](https://platform.claude.com/docs/pt-BR/manage-claude/data-residency#model-availability)); aplicam-se os preços padrão. Requisições que incluem o parâmetro retornam um erro 400. Esses preços se aplicam à Claude API (primária) e ao Claude Platform on AWS. No Claude no Microsoft Foundry, o mesmo multiplicador de 1,1x se aplica a implantações hospedadas no Azure que usam o tipo de implantação US Data Zone Standard. Plataformas operadas por parceiros (Bedrock e Google Cloud) têm seus próprios preços regionais. Consulte [Preços de residência de dados](https://platform.claude.com/docs/pt-BR/about-claude/pricing#data-residency-pricing) para mais detalhes. O mesmo multiplicador se aplica ao [Claude Managed Agents](https://platform.claude.com/docs/pt-BR/managed-agents/overview): quando a [configuração de modelo](https://platform.claude.com/docs/pt-BR/managed-agents/agent-setup) de um agente fixa `inference_geo` em `"us"`, as requisições de modelo em sessões que executam esse agente têm preço de 1,1x a tarifa padrão. Se você tiver um compromisso de [Priority Tier](https://platform.claude.com/docs/pt-BR/api/service-tiers), o multiplicador de 1,1x para inferência somente nos EUA também afeta como os tokens são contabilizados em relação à sua capacidade do Priority Tier. Cada token consumido com `inference_geo: "us"` deduz 1,1 tokens do seu TPM comprometido, de forma consistente com a maneira como outros multiplicadores de preço (como o cache de prompt) afetam as taxas de consumo. ## Suporte à Batch API O parâmetro `inference_geo` é compatível com a [Batch API](https://platform.claude.com/docs/pt-BR/build-with-claude/batch-processing). Cada requisição em um lote pode especificar seu próprio valor de `inference_geo`. ## Migração a partir de opt-outs legados Se sua organização optou anteriormente por não usar o roteamento global para manter a inferência nos EUA, seu workspace foi configurado automaticamente com `allowed_inference_geos: ["us"]` e `default_inference_geo: "us"`. Nenhuma alteração de código é necessária. Seus requisitos de residência de dados existentes continuam sendo aplicados por meio dos novos controles de geo. ### O que mudou O opt-out legado era uma configuração no nível da organização que restringia todas as requisições à infraestrutura baseada nos EUA. Os novos controles de residência de dados substituem isso por dois mecanismos: * **Controle por requisição:** O parâmetro `inference_geo` permite que você especifique `"us"` ou `"global"` em cada chamada de API, oferecendo flexibilidade no nível da requisição. * **Controles do workspace:** As configurações `default_inference_geo` e `allowed_inference_geos` no Console permitem que você aplique políticas de geo em todas as chaves de um workspace. ### O que aconteceu com seu workspace Seu workspace foi migrado automaticamente: | Configuração legada | Novo equivalente | | ------------------------------------------ | --------------------------------------------------------------- | | Opt-out do roteamento global (somente EUA) | `allowed_inference_geos: ["us"]`, `default_inference_geo: "us"` | Todas as requisições de API que usam chaves do seu workspace continuam sendo executadas em infraestrutura baseada nos EUA. Nenhuma ação é necessária para manter seu comportamento atual. ### Se você quiser usar o roteamento global Se seus requisitos de residência de dados mudaram e você deseja aproveitar o roteamento global para melhor desempenho e disponibilidade, atualize as configurações de inference geo do seu workspace para incluir `"global"` nos geos permitidos e defina `default_inference_geo` como `"global"`. Consulte [Restrições no nível do workspace](https://platform.claude.com/docs/pt-BR/manage-claude/data-residency#workspace-level-restrictions) para mais detalhes. ### Impacto nos preços Os modelos legados não são afetados por esta migração. Para os preços atuais dos modelos mais recentes, consulte [Preços](https://platform.claude.com/docs/pt-BR/manage-claude/data-residency#pricing). ## Limitações atuais * **Limites de taxa compartilhados:** Os limites de taxa são compartilhados entre todos os geos. * **Inference geo:** Apenas `"us"` e `"global"` estão disponíveis. * **Workspace geo:** Apenas `"us"` está disponível atualmente. O Workspace geo não pode ser alterado após a criação do workspace. ## Próximos passos Veja os detalhes de preços de residência de dados. Saiba mais sobre a configuração de workspaces. Acompanhe o uso e os custos por residência de dados.