Items marked (preview) in this article are currently in public preview. This preview is provided without a service-level agreement, and we don’t recommend it for production workloads. Certain features might not be supported or might have constrained capabilities. For more information, see Supplemental Terms of Use for Microsoft Azure Previews.
How Claude models are hosted and billed
Microsoft Foundry offers Claude models in two versions:- Version 1: Hosted on Anthropic infrastructure; these models run on Anthropic’s infrastructure (outside of Azure).
- Version 2: Hosted on Azure; these models run on Azure infrastructure end-to-end and are all Generally available (GA).
You access Claude models in Microsoft Foundry through Foundry Models from partners and community. Models from partners and community that Anthropic sells and operates are Non-Microsoft Products under the Product Terms.Claude models in Foundry require an Azure Marketplace subscription and bill through Claude Consumption Units (CCU). Ensure that you have the permissions required to subscribe to model offerings before you deploy. For pricing details, see Claude Consumption Units (CCU) billing in Microsoft Foundry.
Available Claude models
The following table compares model availability for both versions of Claude models in Foundry. For details on the features referenced in the table, see the Capabilities section.
1 Claude Mythos 5 and Claude Mythos Preview are only available as gated research preview. Access to the models is granted solely at Anthropic’s discretion and prioritized for defensive cybersecurity use cases. See the Claude Mythos Preview system card and Claude Mythos 5 system card for responsible use guidance.
2 Claude Fable 5 applies additional input/output classifiers that might refuse requests whose content triggers dual-use safeguard policies. When a refusal occurs, the request returns a successful (200) response with a refusal indicator
stop_reason: "refusal" instead of model-generated content. You’re not billed for input tokens that are refused.
3 Per-turn effort controls, Mid-conversation, and Token budgets are currently in Beta state.
API overview
The following table lists the APIs that you can use to interact with both the Hosted on Azure and Hosted on Anthropic infrastructure versions of Claude models in Foundry. Use the Anthropic SDKs and the following Claude APIs:
1You can call the Messages API from the
anthropic Python package, the @anthropic-ai/foundry-sdk JavaScript package, or directly through REST. The deployment endpoint follows the shape https://<resource-name>.services.ai.azure.com/anthropic/v1/messages, and REST and JavaScript clients use the anthropic-version: 2023-06-01 header.
Capabilities
Claude models in Foundry expose core capabilities for processing, analyzing, and generating content, and tools that let Claude interact with external systems, execute code, and perform automated tasks. The following table summarizes capabilities available for both the Hosted on Azure and Hosted on Anthropic infrastructure versions of Claude models in Foundry, including core capabilities and tools.Model-specific parameter values
Extended thinking The Extended thinking feature allows specific values for thethinking parameter type, depending on the model, as described in the following table. The adaptive type allows the model to decide whether to think, based on query complexity and effort level.
1 Thinking can be
disabled only at effort high or below
Effort
The Effort feature allows specific effort levels for each model, as described in the following table. The xhigh level produces the same result as max.
Agent support
- Microsoft Agent Framework supports creating agents that use Claude models.
- Build custom AI agents with the Claude Agent SDK.
Quotas, rate limits, and regions
Use this section to understand where you can deploy Claude models, how quota is shared, and what rate limits apply to your deployments.Deployment types
Claude models in Foundry are available for the following deployment types in specific Azure regions:- Global Standard: All Claude models (Hosted on Azure and Hosted on Anthropic infrastructure).
- Data Zone Standard (US): Hosted on Azure versions of
claude-opus-5,claude-opus-4-8, andclaude-sonnet-5.
Quotas and rate limits
Subscription-level management handles the deployment quota. Resources and regions share the quota instead of allocating it separately for each resource or region.- All Global Standard deployments of the same model and version in a subscription draw from one shared quota pool across all regions.
- All Data Zone Standard deployments of the same model and version in a subscription draw from a shared quota pool within each data zone (for example, US).
- Input TPM — tokens in the request after the last cache breakpoint (uncached input).
- Cache write 5m TPM — tokens being written to the 5-minute prompt cache.
- Cache write 1h TPM — tokens being written to the 1-hour prompt cache.
- Output tokens (including tokens read from cache) don’t count towards uiTPM.
Rate limits by subscription type
Your Azure subscription type determines your rate limits. The Version 2: Hosted on Azure and Version 1: Hosted on Anthropic infrastructure columns indicate whether quota is available for that model and deployment type combination. Yes means quota is available. N/A means the model and version combination don’t have quota for that deployment type. As listed in the following table, to increase your quota beyond the default limits, submit a request through the quota increase request form.- Pay-as-you-go
- Enterprise and MCA-E
- Free Trial
Pay-as-you-go
Responsible AI considerations
When using Claude models in Foundry, consider these responsible AI practices:- Review Data, privacy, and security for Claude models in Microsoft Foundry to understand how your data is processed and retained when you deploy Claude models.
- Configure AI content safety during model inference, because Foundry doesn’t provide built-in content filtering for Claude models at deployment time.
- Ensure your applications comply with Anthropic’s Acceptable Use Policy. Also, see details of safety evaluations for Claude Fable 5, Claude Mythos 5, Claude Mythos Preview, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Opus 4.5, Claude Opus 4.1, Claude Sonnet 5, Claude Sonnet 4.6, Claude Sonnet 4.5, and Claude Haiku 4.5.
Best practices
Follow these best practices when working with Claude models in Foundry:Prompt engineering
- Clear instructions: Provide specific and detailed prompts.
- Context management: Use the available context window effectively.
- Role definitions: Use system messages to define the assistant’s role and behavior.
- Structured prompts: Use consistent formatting for better results.
Cost optimization
To optimize your usage and avoid rate limiting:- Implement retry logic: Handle 429 responses with exponential backoff.
- Batch requests: Combine multiple prompts when possible.
- Monitor token usage: Track your token consumption and request patterns.
- Use appropriate models: Use the most cost-effective model for your use case. See Available Claude models.