SpyBara
Go Premium

microsoft-foundry.md 2026-05-15 22:58 UTC to 2026-05-17 01:01 UTC

10 added, 0 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

Claude Code no Microsoft Foundry

Saiba como configurar Claude Code através do Microsoft Foundry, incluindo configuração, instalação e resolução de problemas.

export const ContactSalesCard = ({surface}) => { const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}; const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"> ; const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } }; return <div className="cc-cs not-prose"> <div className="cc-cs-card"> <div className="cc-cs-text"> Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.

<div className="cc-cs-actions"> <a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost"> View plans <a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay"> Contact sales {iconArrowRight()}
; };

Pré-requisitos

Antes de configurar Claude Code com Microsoft Foundry, certifique-se de que você tem:

Configuração

1. Provisionar recurso do Microsoft Foundry

Primeiro, crie um recurso Claude no Azure:

  1. Navegue até o portal do Microsoft Foundry
  2. Crie um novo recurso, anotando o nome do seu recurso
  3. Crie implantações para os modelos Claude:
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

2. Configurar credenciais do Azure

Claude Code suporta dois métodos de autenticação para Microsoft Foundry. Escolha o método que melhor se adequa aos seus requisitos de segurança.

Opção A: Autenticação por chave de API

  1. Navegue até seu recurso no portal do Microsoft Foundry
  2. Vá para a seção Endpoints e chaves
  3. Copie a Chave de API
  4. Defina a variável de ambiente:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

Opção B: Autenticação do Microsoft Entra ID

Quando ANTHROPIC_FOUNDRY_API_KEY não está definido, Claude Code usa automaticamente a cadeia de credenciais padrão do Azure SDK. Isso suporta uma variedade de métodos para autenticar cargas de trabalho locais e remotas.

Em ambientes locais, você pode usar comumente a Azure CLI:

az login

3. Configurar Claude Code

Defina as seguintes variáveis de ambiente para ativar Microsoft Foundry:

# Ativar integração do Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1

# Nome do recurso do Azure (substitua {resource} pelo nome do seu recurso)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Ou forneça a URL base completa:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

4. Fixar versões de modelo

Defina as variáveis de modelo para corresponder aos nomes de implantação que você criou na etapa 1.

Sem ANTHROPIC_DEFAULT_OPUS_MODEL, o alias opus no Foundry resolve para Opus 4.6. Defina-o para o ID Opus 4.7 para usar o modelo mais recente:

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

As tarefas em segundo plano, como geração de título de sessão, usam o modelo pequeno/rápido, normalmente um modelo da classe Haiku. No Foundry, Claude Code usa como padrão o modelo primário porque nem toda conta tem uma implantação Haiku. Para usar Haiku para tarefas em segundo plano, defina ANTHROPIC_DEFAULT_HAIKU_MODEL para uma implantação Haiku que esteja disponível em sua conta, conforme mostrado acima.

Para IDs de modelo atuais e legados, consulte Visão geral de modelos. Consulte Configuração de modelo para a lista completa de variáveis de ambiente.

Prompt caching está ativado automaticamente. Para solicitar um TTL de cache de 1 hora em vez do padrão de 5 minutos, defina a seguinte variável; gravações de cache com TTL de 1 hora são cobradas a uma taxa mais alta:

export ENABLE_PROMPT_CACHING_1H=1

5. Executar Claude Code

Com as variáveis de ambiente definidas, inicie Claude Code a partir do diretório do seu projeto:

claude

Claude Code lê CLAUDE_CODE_USE_FOUNDRY e as outras variáveis Foundry do ambiente e se conecta ao seu recurso Azure no primeiro prompt. Diferentemente de Bedrock e Vertex AI, Foundry não possui um assistente de configuração interativo, portanto as variáveis de ambiente nas etapas 3 e 4 são o único caminho de configuração.

Configuração do Azure RBAC

As funções padrão Azure AI User e Cognitive Services User incluem todas as permissões necessárias para invocar modelos Claude.

Para permissões mais restritivas, crie uma função personalizada com o seguinte:

{
  "permissions": [
    {
      "dataActions": [
        "Microsoft.CognitiveServices/accounts/providers/*"
      ]
    }
  ]
}

Para detalhes, consulte documentação RBAC do Microsoft Foundry.

Resolução de problemas

Se você receber um erro "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":

Recursos adicionais