Se sua organização roteia Claude através de um gateway LLM interno conectado ao AWS Bedrock, Google Cloud Vertex AI ou Microsoft Azure, você pode usar os complementos Claude for Excel e Claude for PowerPoint sem uma conta Claude.
Este é o mesmo padrão de gateway usado pelo Claude Code. Se sua organização já executa Claude Code através de um gateway LLM, você pode apontar os complementos do Office para o mesmo endpoint—nenhuma infraestrutura nova é necessária.
Requisitos
Claude for Excel ou Claude for PowerPoint instalado (do Microsoft Marketplace ou implantado pelo seu administrador)
Uma URL de gateway e token de API da sua equipe de TI
A equipe de TI da sua organização gerencia o gateway. Se você não tiver essas credenciais, entre em contato com eles—Anthropic não pode fornecê-las ou redefini-las para você.
Instruções de conexão do gateway para usuários finais
Um administrador precisa implantar Claude for Excel ou PowerPoint em sua organização antes que você possa se conectar. Para obter instruções, consulte as seguintes seções:
Depois que seu administrador implantar os complementos, siga estas etapas:
Abra Excel ou PowerPoint e inicie o complemento Claude.
Na tela de entrada, selecione "Enterprise gateway".
Digite a URL do Gateway e o token de API fornecidos pela sua equipe de TI.
URL do Gateway: A URL base HTTPS do seu proxy LLM (por exemplo,
https://llm-gateway.yourcompany.com).Token de API: O token de portador que seu proxy espera. O complemento envia isso no cabeçalho
Authorization: Bearer <token>com cada solicitação.
O complemento verifica a conexão enviando uma solicitação de teste ao gateway. Se for bem-sucedida, você verá a experiência principal do aplicativo.
Suas credenciais são armazenadas localmente no localStorage do navegador dentro do iframe em sandbox do complemento. Elas não são sincronizadas com os servidores da Anthropic. Como o complemento do Office é executado dentro de um iframe em sandbox dentro do aplicativo Microsoft, ele não pode usar seu keychain do SO da mesma forma que Claude Code faz—por esse motivo, insira apenas tokens emitidos pelo gateway, não credenciais brutas do provedor de nuvem.
Alterar ou atualizar seu gateway
Se seu token de API expirar ou sua equipe de TI lhe der uma nova URL, vá para "Settings" na barra lateral do complemento, insira os novos valores e selecione "Test connection".
Requisitos de gateway para equipes de TI
Os complementos do Office suportam apenas o formato da API de Mensagens Anthropic através do endpoint Unificado. Isso é mais específico que Claude Code, que também suporta formatos Bedrock InvokeModel e Vertex rawPredict diretamente.
Endpoints obrigatórios
Seu gateway deve expor estes dois endpoints:
Endpoint | Descrição |
| Enviar mensagens para Claude. Suporta respostas de streaming e não-streaming. |
| Obter uma lista de modelos disponíveis. |
Cabeçalhos obrigatórios
O gateway deve encaminhar os seguintes cabeçalhos de solicitação do complemento para o provedor upstream:
anthropic-beta— Habilita recursos beta necessários pelo complemento.anthropic-version— Especifica a versão da API para formato de solicitação/resposta.
A falha em encaminhar esses cabeçalhos pode resultar em funcionalidade reduzida ou impedir que o complemento funcione.
Descoberta de modelos
No login, o complemento valida o token via GET /v1/messages e depois tenta descobrir modelos Claude disponíveis via GET /v1/models. Se seu gateway não expuser uma lista de modelos nesse caminho, o complemento volta a solicitar ao usuário um ID de modelo manualmente.
Diferenças da configuração do gateway Claude Code
Aspecto | Claude Code | Claude for Excel e PowerPoint |
Formatos de API suportados | Anthropic Messages, Bedrock InvokeModel, Vertex rawPredict | Anthropic Messages apenas (endpoint Unificado) |
Tipos de endpoint | Unificado e pass-through | Unificado apenas |
Armazenamento de credenciais | Keychain do SO ou variáveis de ambiente | localStorage do navegador (iframe em sandbox) |
Configuração de autenticação | Variáveis de ambiente, arquivo de configuração, scripts auxiliares | Entrada manual na UI do complemento (URL e token) |
Atualização de token | Suporta scripts auxiliares para rotação | Re-entrada manual em configurações |
Nomes de modelos personalizados | Configurável via variáveis de ambiente | Não configurável na v1 |
Exemplo de configuração de gateway com LiteLLM
Muitas organizações usam LiteLLM como seu gateway. Abaixo está um litellm_config.yaml mínimo para rotear solicitações de complementos do Office para Anthropic, Bedrock ou Vertex.
Nota: LiteLLM é software de código aberto de terceiros e não é mantido pela Anthropic.
Roteamento para Anthropic diretamente
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: claude-sonnet-4-5-20250929
api_key: os.environ/ANTHROPIC_API_KEY
litellm_settings:
drop_params: true
# Habilitar o endpoint Anthropic unificado
# Isto é o que o complemento do Office chamará
Roteamento para Amazon Bedrock
yaml
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: bedrock/anthropic.claude-sonnet-4-5-20250929-v1:0
aws_region_name: us-east-1
litellm_settings:
drop_params: true
Roteamento para Google Cloud Vertex AI
Atualize seu litellm_config.yaml:
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: vertex_ai/claude-sonnet-4-5-20250929
vertex_project: your-gcp-project-id
vertex_location: us-east5
litellm_settings:
drop_params: true
Roteamento para Azure
Atualize seu litellm_config.yaml:
model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: azure_ai/claude-sonnet-4-5-20250929
api_base: https://your-resource.services.ai.azure.com/anthropic
api_key: os.environ/AZURE_API_KEY
extra_headers:
x-api-key: os.environ/AZURE_API_KEY
litellm_settings:
drop_params: true
Para instruções de configuração detalhadas, consulte a documentação do formato Anthropic do LiteLLM.
O que Anthropic coleta
Quando você usa os complementos através de um gateway, Anthropic coleta informações de acordo com os termos do AWS Bedrock, Google Cloud Vertex AI ou Microsoft Azure e é consistente com os arranjos da Anthropic com clientes. Anthropic não tem acesso à instância AWS, Google ou Microsoft de um cliente, incluindo prompts ou saídas que ela contém. Anthropic não treina modelos generativos com tal conteúdo nem o usa para outros fins. Anthropic pode ter acesso a metadados—como uso de ferramentas, contagens de tokens e outros itens—e usar tais metadados para fins analíticos e de melhoria de produtos.
Para detalhes sobre o que o gateway da sua organização registra, entre em contato com sua equipe de TI.
Como isso difere de entrar com uma conta Claude
Quando você entra com uma conta Claude, os complementos se conectam diretamente à Anthropic. Quando você se conecta através de um gateway, os complementos enviam solicitações para a infraestrutura da sua organização, e sua equipe de TI controla como esse tráfego é roteado e registrado.
Alguns recursos que dependem de ter uma conta Claude ainda não estão disponíveis através de um gateway, mas estamos trabalhando para adicionar suporte em breve:
Recurso | Conta Claude | Gateway empresarial |
Conversar com sua planilha ou apresentação | ✓ | ✓ |
Ler e editar células, slides, fórmulas | ✓ | ✓ |
Conectores (S&P, FactSet, etc.) | ✓ | — |
Trabalhar entre aplicativos | ✓ | — |
Skills | ✓ | — |
Uploads de arquivos | ✓ | — |
Memória | ✓ | — |
Busca na web | ✓ | Apenas Vertex |
Se sua equipe precisa desses recursos, converse com seu administrador Claude sobre qual caminho de entrada se adequa à sua organização.
Solução de problemas
"Connection refused" ou erro de rede
A URL do gateway está inacessível a partir da rede do usuário. Verifique se a URL está correta, o gateway está em execução e não há restrições de firewall ou VPN bloqueando a conexão.
401 Unauthorized ou "Invalid token"
O token de autenticação é inválido ou expirou. Confirme o token com sua equipe de TI. Os tokens de gateway são gerenciados pela sua organização, não pela Anthropic.
403 Forbidden ou "Access denied"
O token é válido mas não tem as permissões corretas. Para Bedrock, verifique se a função IAM do gateway tem permissões bedrock:InvokeModel. Para Vertex, verifique se a conta de serviço tem permissões aiplatform.endpoints.predict. Entre em contato com seu administrador de TI para as permissões corretas.
404 Not Found
O complemento não conseguiu alcançar o caminho da API esperado. Verifique se a URL do gateway é a URL base (por exemplo, https://litellm-server:4000) — não inclua /v1/messages no campo de URL.
500 ou outros erros de servidor
O gateway encontrou um erro interno. Verifique seus logs de gateway (por exemplo, docker logs litellm se usar LiteLLM) para erros do provedor upstream. Tente a solicitação novamente e entre em contato com seu administrador de TI se o problema persistir.
"No models available"
O complemento não conseguiu encontrar modelos Claude em seu gateway. Seu gateway pode não expor uma lista de modelos em GET /model/info. Sua equipe de TI pode configurar o gateway para servir uma lista de modelos ou lhe dar um ID de modelo específico para inserir manualmente quando solicitado.
Respostas de streaming falham ou travam
Verifique se seu gateway suporta pass-through de Server-Sent Events (SSE). Algumas configurações de proxy removem ou armazenam em buffer conexões SSE, o que impede que respostas de streaming cheguem ao complemento.
Um recurso que eu esperava não está lá
Conectores, Skills, uploads de arquivos e memória não estão disponíveis através de um gateway empresarial. Se você precisar desses, peça ao seu administrador sobre entrar com uma conta Claude.