Se la tua organizzazione instrada Claude attraverso un gateway LLM interno connesso ad AWS Bedrock, Google Cloud Vertex AI o Microsoft Azure, puoi utilizzare i componenti aggiuntivi Claude for Excel e Claude for PowerPoint senza un account Claude.
Questo è lo stesso modello di gateway utilizzato da Claude Code. Se la tua organizzazione esegue già Claude Code attraverso un gateway LLM, puoi indirizzare i componenti aggiuntivi di Office allo stesso endpoint—non è richiesta alcuna nuova infrastruttura.
Requisiti
Claude for Excel o Claude for PowerPoint installato (da Microsoft Marketplace o distribuito dal tuo amministratore)
Un URL del gateway e un token API dal tuo team IT
Il team IT della tua organizzazione gestisce il gateway. Se non disponi di queste credenziali, contattali—Anthropic non può fornirle o ripristinarle per te.
Istruzioni di connessione al gateway per gli utenti finali
Un amministratore deve distribuire Claude for Excel o PowerPoint alla tua organizzazione prima di poter effettuare la connessione. Per le istruzioni, fai riferimento alle seguenti sezioni:
Dopo che il tuo amministratore ha distribuito i componenti aggiuntivi, segui questi passaggi:
Apri Excel o PowerPoint e avvia il componente aggiuntivo Claude.
Nella schermata di accesso, seleziona "Gateway aziendale".
Immetti l'URL del gateway e il token API forniti dal tuo team IT.
URL del gateway: L'URL di base HTTPS del tuo proxy LLM (ad esempio,
https://llm-gateway.tuaazienda.com).Token API: Il token bearer che il tuo proxy si aspetta. Il componente aggiuntivo lo invia nell'intestazione
Authorization: Bearer <token>con ogni richiesta.
Il componente aggiuntivo verifica la connessione inviando una richiesta di test al gateway. Se ha successo, vedrai l'esperienza dell'app principale.
Le tue credenziali sono archiviate localmente nel localStorage del browser all'interno dell'iframe sandbox del componente aggiuntivo. Non vengono sincronizzate con i server di Anthropic. Poiché il componente aggiuntivo di Office viene eseguito all'interno di un iframe sandbox all'interno dell'applicazione Microsoft, non può utilizzare il tuo keychain del sistema operativo come fa Claude Code—per questo motivo, inserisci solo token emessi dal gateway, non credenziali grezze del provider cloud.
Modificare o aggiornare il tuo gateway
Se il tuo token API scade o il tuo team IT ti fornisce un nuovo URL, vai a "Impostazioni" nella barra laterale del componente aggiuntivo, immetti i nuovi valori e seleziona "Verifica connessione".
Requisiti del gateway per i team IT
I componenti aggiuntivi di Office supportano solo il formato dell'API Anthropic Messages tramite l'endpoint unificato. Questo è più specifico di Claude Code, che supporta anche direttamente i formati Bedrock InvokeModel e Vertex rawPredict.
Endpoint richiesti
Il tuo gateway deve esporre questi due endpoint:
Endpoint | Descrizione |
| Invia messaggi a Claude. Supporta sia risposte in streaming che non in streaming. |
| Ottieni un elenco dei modelli disponibili. |
Intestazioni richieste
Il gateway deve inoltrare le seguenti intestazioni di richiesta dal componente aggiuntivo al provider upstream:
anthropic-beta— Abilita le funzionalità beta richieste dal componente aggiuntivo.anthropic-version— Specifica la versione dell'API per il formato richiesta/risposta.
La mancata inoltro di queste intestazioni può comportare una riduzione della funzionalità o impedire il funzionamento del componente aggiuntivo.
Scoperta dei modelli
Al momento dell'accesso, il componente aggiuntivo convalida il token tramite GET /v1/messages e quindi tenta di scoprire i modelli Claude disponibili tramite GET /v1/models. Se il tuo gateway non espone un elenco di modelli in quel percorso, il componente aggiuntivo ricade nel chiedere all'utente un ID modello manualmente.
Differenze dalla configurazione del gateway di Claude Code
Aspetto | Claude Code | Claude for Excel e PowerPoint |
Formati API supportati | Anthropic Messages, Bedrock InvokeModel, Vertex rawPredict | Solo Anthropic Messages (endpoint unificato) |
Tipi di endpoint | Unificato e pass-through | Solo unificato |
Archiviazione delle credenziali | Keychain del sistema operativo o variabili di ambiente | localStorage del browser (iframe sandbox) |
Configurazione dell'autenticazione | Variabili di ambiente, file di configurazione, script helper | Immissione manuale nell'interfaccia utente del componente aggiuntivo (URL e token) |
Aggiornamento del token | Supporta script helper per la rotazione | Reinserimento manuale nelle impostazioni |
Nomi di modelli personalizzati | Configurabile tramite variabili di ambiente | Non configurabile nella v1 |
Esempio di configurazione del gateway con LiteLLM
Molte organizzazioni utilizzano LiteLLM come gateway. Di seguito è riportato un litellm_config.yaml minimo per l'instradamento delle richieste dei componenti aggiuntivi di Office verso Anthropic, Bedrock o Vertex.
Nota: LiteLLM è software open-source di terze parti e non è mantenuto da Anthropic.
Instradamento direttamente ad Anthropic
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
# Abilita l'endpoint unificato di Anthropic
# Questo è quello che il componente aggiuntivo di Office chiamerà
Instradamento ad 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
Instradamento a Google Cloud Vertex AI
Aggiorna il tuo 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
Instradamento ad Azure
Aggiorna il tuo 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
Per istruzioni di configurazione dettagliate, fai riferimento alla documentazione del formato Anthropic di LiteLLM.
Cosa raccoglie Anthropic
Quando utilizzi i componenti aggiuntivi attraverso un gateway, Anthropic raccoglie informazioni in conformità ai termini di AWS Bedrock, Google Cloud Vertex AI o Microsoft Azure ed è coerente con gli accordi di Anthropic con i clienti. Anthropic non ha accesso all'istanza AWS, Google o Microsoft di un cliente, inclusi i prompt o gli output che contiene. Anthropic non addestra modelli generativi con tali contenuti e non li utilizza per altri scopi. Anthropic può accedere ai metadati—come l'uso degli strumenti, i conteggi dei token e altri elementi—e utilizzare tali metadati per scopi analitici e di miglioramento dei prodotti.
Per i dettagli su cosa registra il gateway della tua organizzazione, contatta il tuo team IT.
Come questo differisce dall'accesso con un account Claude
Quando accedi con un account Claude, i componenti aggiuntivi si connettono direttamente ad Anthropic. Quando ti connetti attraverso un gateway, i componenti aggiuntivi inviano richieste all'infrastruttura della tua organizzazione, e il tuo team IT controlla come quel traffico viene instradato e registrato.
Alcune funzionalità che si basano su un account Claude non sono ancora disponibili attraverso un gateway, ma stiamo lavorando per aggiungere il supporto presto:
Funzionalità | Account Claude | Gateway aziendale |
Chat con il tuo foglio di calcolo o presentazione | ✓ | ✓ |
Leggi e modifica celle, diapositive, formule | ✓ | ✓ |
Connettori (S&P, FactSet, ecc.) | ✓ | — |
Lavoro tra app | ✓ | — |
Competenze | ✓ | — |
Caricamenti di file | ✓ | — |
Memoria | ✓ | — |
Ricerca web | ✓ | Solo Vertex |
Se il tuo team ha bisogno di queste funzionalità, parla con il tuo amministratore Claude su quale percorso di accesso si adatta meglio alla tua organizzazione.
Risoluzione dei problemi
"Connessione rifiutata" o errore di rete
L'URL del gateway non è raggiungibile dalla rete dell'utente. Verifica che l'URL sia corretto, che il gateway sia in esecuzione e che non ci siano restrizioni firewall o VPN che bloccano la connessione.
401 Non autorizzato o "Token non valido"
Il token di autenticazione non è valido o è scaduto. Conferma il token con il tuo team IT. I token del gateway sono gestiti dalla tua organizzazione, non da Anthropic.
403 Vietato o "Accesso negato"
Il token è valido ma non ha i permessi giusti. Per Bedrock, verifica che il ruolo IAM del gateway abbia i permessi bedrock:InvokeModel. Per Vertex, verifica che l'account di servizio abbia i permessi aiplatform.endpoints.predict. Contatta il tuo amministratore IT per i permessi corretti.
404 Non trovato
Il componente aggiuntivo non ha potuto raggiungere il percorso API previsto. Verifica che l'URL del gateway sia l'URL di base (ad esempio, https://litellm-server:4000) — non includere /v1/messages nel campo URL.
500 o altri errori del server
Il gateway ha riscontrato un errore interno. Controlla i log del gateway (ad esempio, docker logs litellm se utilizzi LiteLLM) per gli errori del provider upstream. Riprova la richiesta e contatta il tuo amministratore IT se il problema persiste.
"Nessun modello disponibile"
Il componente aggiuntivo non ha potuto trovare modelli Claude sul tuo gateway. Il tuo gateway potrebbe non esporre un elenco di modelli in GET /model/info. Il tuo team IT può configurare il gateway per servire un elenco di modelli o darti uno specifico ID modello da inserire manualmente quando richiesto.
Le risposte in streaming non riescono o si bloccano
Verifica che il tuo gateway supporti il pass-through di Server-Sent Events (SSE). Alcune configurazioni proxy rimuovono o memorizzano nel buffer le connessioni SSE, il che impedisce alle risposte in streaming di raggiungere il componente aggiuntivo.
Una funzionalità che mi aspettavo non è presente
I connettori, le competenze, i caricamenti di file e la memoria non sono disponibili attraverso un gateway aziendale. Se hai bisogno di questi, chiedi al tuo amministratore di accedere con un account Claude.