Questa guida accompagna gli amministratori IT nella distribuzione di Claude Cowork su Amazon Bedrock, Google Cloud Vertex AI, Azure AI Foundry o un gateway LLM. Copre il download, la configurazione MDM per macOS e Windows, la configurazione specifica del provider e il riferimento completo delle chiavi MDM.
Se stai valutando se questa distribuzione è adatta alla tua organizzazione, inizia con Claude Cowork con piattaforme di terze parti.
Prima di iniziare
Assicurati di avere:
Accesso alla piattaforma — macOS 13.0 (Ventura) o versioni successive, oppure Windows 10 o 11. Su Windows, la funzione Virtual Machine Platform deve essere abilitata, il che richiede un riavvio del sistema una sola volta.
Un provider di inferenza — Amazon Bedrock, Google Cloud Vertex AI, Azure AI Foundry o un gateway LLM che espone /v1/messages.
Credenziali per quel provider — una chiave API, un token bearer, un JSON dell'account di servizio o una chiave Foundry, a seconda del provider che stai utilizzando.
Accesso MDM — Jamf, Kandji, Mosyle o simili per macOS. Intune o Criteri di gruppo per Windows.
Scarica il programma di installazione
Scarica Claude Desktop per la tua piattaforma da la pagina di download. Lo stesso binario viene fornito sia per Claude Cowork standard che per distribuzioni di terze parti: il profilo di configurazione MDM determina in quale modalità viene eseguita l'app.
macOS
Scarica il programma di installazione macOS da la pagina di download.
Apri il file .dmg.
Trascina Claude.app nella cartella Applicazioni.
Configura l'inferenza di terze parti utilizzando l'interfaccia di configurazione (sezione successiva).
Applica la configurazione MDM (sotto la sezione Configurazione).
Windows
Scarica il programma di installazione Windows da la pagina di download.
Esegui il programma di installazione .msix. È progettato per distribuzioni aziendali e può essere distribuito tramite Intune o Criteri di gruppo.
Segui i prompt sullo schermo.
Configura l'inferenza di terze parti utilizzando l'interfaccia di configurazione (sezione successiva).
Applica la configurazione MDM (sotto la sezione Configurazione).
Configura l'inferenza di terze parti tramite l'interfaccia di configurazione
Apri l'app Claude Desktop scaricata (non è necessario effettuare l'accesso). Vai alla barra dei menu e seleziona Aiuto → Risoluzione dei problemi → Abilita modalità sviluppatore. Con la modalità sviluppatore abilitata, vai Sviluppatore → Configura inferenza di terze parti. Questo attiva un'interfaccia di configurazione per configurare i campi richiesti. Puoi trovare ulteriori informazioni su ogni campo qui: Riferimento di configurazione.
Applica la configurazione MDM
Dopo l'installazione, applica un profilo di configurazione gestito per attivare la modalità piattaforma di terze parti e indirizzare l'app al tuo provider di inferenza.
macOS
Dall'interfaccia di configurazione, seleziona Esporta per scaricare un file .mobileconfig per la distribuzione.
Distribuisci un file di configurazione .mobileconfig tramite la tua soluzione MDM.
Dominio: com.anthropic.claudefordesktop
Distribuzione: Jamf, Kandji, Mosyle, Intune per Mac o qualsiasi MDM che supporti la configurazione dell'app
Windows
Dall'interfaccia di configurazione, seleziona Esporta per scaricare un file .reg per la distribuzione.
Percorso del registro: HKCU\SOFTWARE\Policies\Claude
Distribuzione: Criteri di gruppo, Intune o qualsiasi MDM che supporti file .reg
Distribuzioni VDI
Negli ambienti VDI, si applicano le stesse chiavi MDM. Impostale nell'immagine golden (in modo che ogni sessione clonata le erediti) oppure distribuiscile in fase di esecuzione tramite il sistema di criteri del tuo broker VDI.
Configura i plugin
I plugin estendono le capacità di Claude con bundle di competenze, comandi e server MCP specifici del ruolo. Con piattaforme di terze parti, i plugin vengono distribuiti tramite un montaggio di directory locale su ogni macchina.
Posiziona le cartelle dei tuoi plugin in:
macOS: /Library/Application Support/Claude/org-plugins/
Windows: C:\ProgramData\Claude\org-plugins\
Per i dettagli sulla struttura e la gestione dei plugin, consulta Estendi Claude Cowork con piattaforme di terze parti.
Verifica l'installazione
Avvia Claude Desktop su una macchina di prova. Dovresti vedere:
Schede Cowork e Code nella navigazione a sinistra
Nessuna scheda Chat (la chat non è disponibile in questa distribuzione)
L'opzione per accedere tramite Gateway o il tuo provider di inferenza
Se gli utenti visualizzano un errore all'avvio, verifica che la chiave inferenceProvider sia impostata e che le credenziali del provider siano valide. Utilizza i log della console su macOS o Visualizzatore eventi su Windows per un debug più approfondito.
Riferimento chiavi di configurazione
Le tabelle seguenti coprono ogni chiave MDM disponibile a partire da aprile 2026. Tutte le chiavi sono facoltative se non diversamente indicato. Per l'elenco attuale e eventuali aggiunte, contatta il tuo rappresentante di account.
Impostazioni di inferenza
Chiave | Tipo | Descrizione |
| stringa | Seleziona il backend di inferenza. L'impostazione di questa chiave attiva la modalità piattaforma di terze parti. Valori: bedrock, vertex, foundry, gateway. |
| stringa | URL base del gateway. Obbligatorio quando provider = gateway. |
| stringa | Chiave API per il gateway. Obbligatorio quando provider = gateway. |
| stringa | Come viene inviata la credenziale del gateway (auto / x-api-key / bearer). |
| stringa (array JSON di stringhe "Name: Value") | Intestazioni HTTP aggiuntive facoltative inviate al tuo gateway su ogni richiesta di inferenza. |
| stringa | ID progetto GCP. Obbligatorio quando provider = vertex. |
| stringa | Regione GCP. Obbligatorio quando provider = vertex. |
| stringa | Percorso assoluto di un file JSON di account di servizio o file ADC. Nessuna espansione di tilde o variabili di ambiente. Obbligatorio quando provider = vertex. |
| stringa | Sostituisci l'endpoint Vertex AI (ad esempio, Private Service Connect). Lascia non impostato per utilizzare l'endpoint regionale pubblico. |
| stringa | ID client OAuth per un accesso Google interattivo per utente, come alternativa a un file di account di servizio condiviso. |
| stringa | Segreto client OAuth associato all'ID client sopra. |
| stringa (array JSON di stringhe di ambito) | Array di stringhe JSON degli ambiti OAuth da richiedere. Per impostazione predefinita, l'ambito richiesto per la previsione Vertex. |
| stringa | Regione AWS. Obbligatorio quando provider = bedrock. |
| stringa | Token bearer AWS. Obbligatorio quando provider = bedrock. |
| stringa | Sostituisci l'endpoint Bedrock (ad esempio, endpoint dell'interfaccia VPC o gateway LLM). Lascia non impostato per utilizzare l'endpoint regionale pubblico. |
| stringa | Profilo denominato AWS da ~/.aws/config. Utilizzare quando le credenziali sono gestite da AWS CLI, SSO o da un processo di credenziale aziendale. |
| stringa | Percorso assoluto della directory contenente i file di configurazione/credenziali AWS, se non è il valore predefinito ~/.aws. Copiato nella sandbox in modo che il profilo denominato si risolva lì. |
| stringa | Nome della risorsa Azure AI Foundry. Obbligatorio quando provider = foundry. |
| stringa | Chiave API Azure AI Foundry. Obbligatorio quando provider = foundry. |
| stringa | Array JSON di ID modello o alias (sonnet, opus, haiku). La prima voce è l'impostazione predefinita del selettore. Obbligatorio per Vertex, Bedrock e Foundry. |
| stringa | Percorso assoluto di un eseguibile il cui stdout è la credenziale di inferenza. Viene eseguito sull'host all'inizio della sessione. |
| intero | Quanto tempo (in secondi) memorizzare nella cache l'output dell'helper. Predefinito: 3600. |
Distribuzione e aggiornamento automatico
Chiave | Tipo | Descrizione |
| stringa | UUID stabile che identifica questa distribuzione. Limita l'archiviazione locale e la telemetria. |
| intero | Se impostato, forza l'installazione di un aggiornamento in sospeso dopo questo numero di ore indipendentemente dall'attività dell'utente. Se non impostato, l'app utilizza una finestra di 72 ore ma rimanda mentre l'utente è attivo. |
| booleano | Impedisce all'app di verificare e scaricare gli aggiornamenti. L'app rimane sulla versione installata fino a quando non viene aggiornata con altri mezzi. |
Telemetria
Chiave | Tipo | Descrizione |
| booleano | Blocca i rapporti di arresto anomalo ed errore e i dati di tempistica delle prestazioni inviati ad Anthropic. |
| booleano | Blocca l'analisi dell'utilizzo del prodotto — utilizzo delle funzioni, modelli di navigazione, azioni dell'interfaccia utente. |
| booleano | Blocca le favicon dei connettori (che rivelano i nomi host MCP) e la sandbox di anteprima degli artefatti. I connettori tornano alle icone con lettere; gli artefatti non vengono renderizzati. |
| stringa | URL di base del tuo raccoglitore OTLP. Se impostato, le sessioni esportano log e metriche (prompt, chiamate di strumenti, conteggi di token). L'host dell'endpoint viene aggiunto automaticamente all'elenco di autorizzazione della rete sandbox. |
| stringa | http/protobuf (predefinito), http/json o grpc. |
| stringa | Coppie chiave=valore separate da virgole inviate ad ogni richiesta OTLP (formato standard OTEL_EXPORTER_OTLP_HEADERS). |
MCP, plugin e strumenti
Chiave | Tipo | Descrizione |
| booleano | Consenti agli utenti di installare estensioni desktop locali (.dxt o .mcpb). |
| booleano | Mostra la directory delle estensioni Anthropic nell'interfaccia dei connettori. |
| booleano | Rifiuta le estensioni desktop che non sono firmate da un editore attendibile. |
| booleano | Consenti agli utenti di aggiungere i propri server MCP locali. Se false, sono disponibili solo i server dall'elenco gestito. |
| booleano | Mostra la scheda Codice (sessioni di codifica basate su terminale). Le sessioni vengono eseguite sull'host, non all'interno della VM. |
| stringa | Array JSON di configurazioni server MCP remoti. Ogni voce richiede nome e url. Facoltativo: transport (http o sse), headers, oauth, toolPolicy. |
| stringa | Array JSON di nomi di strumenti da rimuovere dall'elenco degli strumenti dell'agente. Consulta l'articolo MCP per l'elenco completo degli strumenti. |
| Stringa (array JSON di nomi host) | Percorsi assoluti che gli utenti possono allegare come cartelle dell'area di lavoro. Il ~ iniziale si espande alla home dell'utente. Se impostato, qualsiasi percorso al di fuori di questo elenco viene rifiutato. |
Limiti di area di lavoro e utilizzo
Chiave | Tipo | Descrizione |
| stringa | Array JSON di percorsi assoluti che l'utente può allegare come cartelle dell'area di lavoro. Il ~ iniziale si espande alla directory home per utente. Non impostato = senza restrizioni. |
| intero | Token di input+output totali consentiti per finestra scorrevole prima che sendMessage venga rifiutato. Applicato nel processo principale del desktop. Non impostato = nessun limite. |
| intero | Lunghezza della finestra scorrevole per il limite di token. Max 720h (30 giorni). Il contatore si ripristina quando now >= windowStartMs + windowHours×3600×1000. |
Passaggi successivi
Per ulteriori dettagli sulla configurazione, consulta la nostra documentazione Cowork su piattaforme di terze parti.
Per i dettagli sulla conformità e la postura di sicurezza, consulta la Panoramica sulla sicurezza di Claude Cowork (piattaforme di terze parti) nel nostro Trust Center.
Configura i server MCP e distribuisci i plugin: Estendi Claude Cowork con piattaforme di terze parti
Monitora le distribuzioni con OpenTelemetry: Monitora l'attività di Claude Cowork con OpenTelemetry
