Claude no Microsoft Foundry

Este guia o orienta através do processo de configuração e realização de chamadas de API para Claude no Foundry em Python, TypeScript ou usando requisições HTTP diretas. Quando você consegue acessar Claude no Foundry, você é cobrado pelo uso de Claude no Microsoft Marketplace com sua assinatura do Azure, permitindo que você acesse os recursos mais recentes do Claude enquanto gerencia custos através de sua assinatura do Azure.

Disponibilidade regional: No lançamento, Claude está disponível como um tipo de implantação Global Standard em recursos Foundry (US DataZone em breve). O preço do Claude no Microsoft Marketplace usa o preço padrão da API do Anthropic. Visite a página de preços para detalhes.

Visualização

Nesta integração de plataforma de visualização, os modelos Claude são executados na infraestrutura do Anthropic. Esta é uma integração comercial para cobrança e acesso através do Azure. Como processador independente para a Microsoft, os clientes que usam Claude através do Microsoft Foundry estão sujeitos aos termos de uso de dados do Anthropic. O Anthropic continua a fornecer seus compromissos de segurança e dados líderes do setor, incluindo disponibilidade de retenção zero de dados.

Pré-requisitos

Antes de começar, certifique-se de que você tem:

• Uma assinatura ativa do Azure
• Acesso ao Foundry
• A CLI do Azure instalada (opcional, para gerenciamento de recursos)

Instalar um SDK

Os SDKs cliente do Anthropic suportam Foundry através de pacotes específicos da plataforma.

Provisionamento

Foundry usa uma hierarquia de dois níveis: recursos contêm sua configuração de segurança e cobrança, enquanto implantações são as instâncias de modelo que você chama via API. Você primeiro criará um recurso Foundry e depois criará uma ou mais implantações Claude dentro dele.

Provisionamento de recursos Foundry

Crie um recurso Foundry, que é necessário para usar e gerenciar serviços no Azure. Você pode seguir estas instruções para criar um recurso Foundry. Alternativamente, você pode começar criando um projeto Foundry, que envolve criar um recurso Foundry.

Para provisionar seu recurso:

1. Navegue até o portal Foundry
2. Crie um novo recurso Foundry ou selecione um existente
3. Configure o gerenciamento de acesso usando chaves de API emitidas pelo Azure ou Entra ID para controle de acesso baseado em função
4. Opcionalmente, configure o recurso para fazer parte de uma rede privada (Rede Virtual do Azure) para segurança aprimorada
5. Anote o nome do seu recurso. Você usará isso como {resource} nos endpoints da API (por exemplo, https://{resource}.services.ai.azure.com/anthropic/v1/*)

Criando implantações Foundry

Após criar seu recurso, implante um modelo Claude para torná-lo disponível para chamadas de API:

1. No portal Foundry, navegue até seu recurso
2. Vá para Modelos + endpoints e selecione + Implantar modelo > Implantar modelo base
3. Procure e selecione um modelo Claude (por exemplo, claude-sonnet-4-6)
4. Configure as configurações de implantação:
   • Nome da implantação: Padrão para o ID do modelo, mas você pode personalizá-lo (por exemplo, my-claude-deployment). O nome da implantação não pode ser alterado após sua criação.
   • Tipo de implantação: Selecione Global Standard (recomendado para Claude)
5. Selecione Implantar e aguarde a conclusão do provisionamento
6. Uma vez implantado, você pode encontrar sua URL de endpoint e chaves em Chaves e Endpoint

Autenticação

Claude no Foundry suporta dois métodos de autenticação: chaves de API e tokens Entra ID. Ambos os métodos usam endpoints hospedados no Azure no formato https://{resource}.services.ai.azure.com/anthropic/v1/*.

Autenticação por chave de API

Após provisionar seu recurso Claude Foundry, você pode obter uma chave de API do portal Foundry:

1. Navegue até seu recurso no portal Foundry
2. Vá para a seção Chaves e Endpoint
3. Copie uma das chaves de API fornecidas
4. Use o cabeçalho api-key ou x-api-key em suas requisições, ou forneça-o ao SDK

Os SDKs Python e TypeScript requerem uma chave de API e um nome de recurso ou URL base. Os SDKs lerão automaticamente esses valores das seguintes variáveis de ambiente se estiverem definidas:

• ANTHROPIC_FOUNDRY_API_KEY - Sua chave de API
• ANTHROPIC_FOUNDRY_RESOURCE - Seu nome de recurso (por exemplo, example-resource)
• ANTHROPIC_FOUNDRY_BASE_URL - Alternativa ao nome do recurso; a URL base completa (por exemplo, https://example-resource.services.ai.azure.com/anthropic/)

Exemplo usando chave de API:

Autenticação Microsoft Entra

Para segurança aprimorada e gerenciamento centralizado de acesso, você pode usar tokens Entra ID (anteriormente Azure Active Directory):

1. Habilite a autenticação Entra para seu recurso Foundry
2. Obtenha um token de acesso do Entra ID
3. Use o token no cabeçalho Authorization: Bearer {TOKEN}

Exemplo usando Entra ID:

IDs de requisição de correlação

Foundry inclui identificadores de requisição nos cabeçalhos de resposta HTTP para depuração e rastreamento. Ao entrar em contato com o suporte, forneça os valores request-id e apim-request-id para ajudar as equipes a localizar e investigar rapidamente sua requisição em ambos os sistemas Anthropic e Azure.

Recursos suportados

Claude no Foundry suporta a maioria dos poderosos recursos do Claude. Você pode encontrar todos os recursos atualmente suportados na documentação de visão geral.

Janela de contexto

Claude Opus 4.7, Claude Opus 4.6 e Claude Sonnet 4.6 têm uma janela de contexto de 1M-token no Microsoft Foundry. Outros modelos Claude, incluindo Sonnet 4.5, têm uma janela de contexto de 200k-token.

Recursos não suportados

• Admin API (endpoints /v1/organizations/*)
• Models API (/v1/models)
• Message Batch API (/v1/messages/batches)

Respostas de API

As respostas de API do Claude no Foundry seguem o formato de resposta padrão da API Claude. Isso inclui o objeto usage nos corpos de resposta, que fornece informações detalhadas de consumo de tokens para suas requisições. O objeto usage é consistente em todas as plataformas (API de primeira parte, Foundry, Amazon Bedrock e Google Vertex AI).

Para detalhes sobre cabeçalhos de resposta específicos do Foundry, consulte a seção de IDs de requisição de correlação.

IDs de modelo de API e implantações

Os seguintes modelos Claude estão disponíveis através do Foundry. Os modelos de geração mais recente (Opus 4.7, Opus 4.6, Sonnet 4.6 e Haiku 4.5) oferecem os recursos mais avançados:

Por padrão, os nomes de implantação correspondem aos IDs de modelo mostrados acima. No entanto, você pode criar implantações personalizadas com nomes diferentes no portal Foundry para gerenciar diferentes configurações, versões ou limites de taxa. Use o nome da implantação (não necessariamente o ID do modelo) em suas requisições de API.

Monitoramento e registro

O Azure fornece recursos abrangentes de monitoramento e registro para seu uso de Claude através de padrões padrão do Azure:

• Azure Monitor: Rastreie uso de API, latência e taxas de erro
• Azure Log Analytics: Consulte e analise logs de requisição/resposta
• Cost Management: Monitore e preveja custos associados ao uso de Claude

O Anthropic recomenda registrar sua atividade em pelo menos uma base de rolagem de 30 dias para entender padrões de uso e investigar possíveis problemas.

Solução de problemas

Erros de autenticação

Erro: 401 Unauthorized ou Invalid API key

• Solução: Verifique se sua chave de API está correta. Você pode obter uma nova chave de API do portal do Azure em Chaves e Endpoint para seu recurso Claude.
• Solução: Se estiver usando Azure Entra ID, certifique-se de que seu token de acesso é válido e não expirou. Os tokens normalmente expiram após 1 hora.

Erro: 403 Forbidden

• Solução: Sua conta do Azure pode não ter as permissões necessárias. Certifique-se de ter a função Azure RBAC apropriada atribuída (por exemplo, "Cognitive Services OpenAI User").

Limitação de taxa

Erro: 429 Too Many Requests

• Solução: Você excedeu seu limite de taxa. Implemente lógica de backoff exponencial e retry em sua aplicação.
• Solução: Considere solicitar aumentos de limite de taxa através do portal do Azure ou suporte do Azure.

Cabeçalhos de limite de taxa

Foundry não inclui os cabeçalhos de limite de taxa padrão do Anthropic (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining e anthropic-ratelimit-output-tokens-reset) nas respostas. Gerencie a limitação de taxa através das ferramentas de monitoramento do Azure.

Erros de modelo e implantação

Erro: Model not found ou Deployment not found

• Solução: Verifique se você está usando o nome de implantação correto. Se você não criou uma implantação personalizada, use o ID do modelo padrão (por exemplo, claude-sonnet-4-6).
• Solução: Certifique-se de que o modelo/implantação está disponível em sua região do Azure.

Erro: Invalid model parameter

• Solução: O parâmetro model deve conter seu nome de implantação, que pode ser personalizado no portal Foundry. Verifique se a implantação existe e está configurada corretamente.

Recursos adicionais

• Documentação Foundry: ai.azure.com/catalog
• Preços do Azure: azure.microsoft.com/en-us/pricing
• Detalhes de preços do Anthropic: Documentação de preços
• Guia de autenticação: Consulte a seção de autenticação acima
• Portal do Azure: portal.azure.com