Vai al contenuto principale

Installare e configurare Claude Cowork con piattaforme di terze parti

Aggiornato oggi

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

  1. Scarica il programma di installazione macOS da la pagina di download.

  2. Apri il file .dmg.

  3. Trascina Claude.app nella cartella Applicazioni.

  4. Configura l'inferenza di terze parti utilizzando l'interfaccia di configurazione (sezione successiva).

  5. Applica la configurazione MDM (sotto la sezione Configurazione).

Windows

  1. Scarica il programma di installazione Windows da la pagina di download.

  2. Esegui il programma di installazione .msix. È progettato per distribuzioni aziendali e può essere distribuito tramite Intune o Criteri di gruppo.

  3. Segui i prompt sullo schermo.

  4. Configura l'inferenza di terze parti utilizzando l'interfaccia di configurazione (sezione successiva).

  5. 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

inferenceProvider

stringa

Seleziona il backend di inferenza. L'impostazione di questa chiave attiva la modalità piattaforma di terze parti. Valori: bedrock, vertex, foundry, gateway.

inferenceGatewayBaseUrl

stringa

URL base del gateway. Obbligatorio quando provider = gateway.

inferenceGatewayApiKey

stringa

Chiave API per il gateway. Obbligatorio quando provider = gateway.

inferenceGatewayAuthScheme

stringa

Come viene inviata la credenziale del gateway (auto / x-api-key / bearer).

inferenceGatewayHeaders

stringa (array JSON di stringhe "Name: Value")

Intestazioni HTTP aggiuntive facoltative inviate al tuo gateway su ogni richiesta di inferenza.

inferenceVertexProjectId

stringa

ID progetto GCP. Obbligatorio quando provider = vertex.

inferenceVertexRegion

stringa

Regione GCP. Obbligatorio quando provider = vertex.

inferenceVertexCredentialsFile

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.

inferenceVertexBaseUrl

stringa

Sostituisci l'endpoint Vertex AI (ad esempio, Private Service Connect). Lascia non impostato per utilizzare l'endpoint regionale pubblico.

inferenceVertexOAuthClientId

stringa

ID client OAuth per un accesso Google interattivo per utente, come alternativa a un file di account di servizio condiviso.

inferenceVertexOAuthClientSecret

stringa

Segreto client OAuth associato all'ID client sopra.

inferenceVertexOAuthScopes

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.

inferenceBedrockRegion

stringa

Regione AWS. Obbligatorio quando provider = bedrock.

inferenceBedrockBearerToken

stringa

Token bearer AWS. Obbligatorio quando provider = bedrock.

inferenceBedrockBaseUrl

stringa

Sostituisci l'endpoint Bedrock (ad esempio, endpoint dell'interfaccia VPC o gateway LLM). Lascia non impostato per utilizzare l'endpoint regionale pubblico.

inferenceBedrockProfile

stringa

Profilo denominato AWS da ~/.aws/config. Utilizzare quando le credenziali sono gestite da AWS CLI, SSO o da un processo di credenziale aziendale.

inferenceBedrockAwsDir

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ì.

inferenceFoundryResource

stringa

Nome della risorsa Azure AI Foundry. Obbligatorio quando provider = foundry.

inferenceFoundryApiKey

stringa

Chiave API Azure AI Foundry. Obbligatorio quando provider = foundry.

inferenceModels

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.

inferenceCredentialHelper

stringa

Percorso assoluto di un eseguibile il cui stdout è la credenziale di inferenza. Viene eseguito sull'host all'inizio della sessione.

inferenceCredentialHelperTtlSec

intero

Quanto tempo (in secondi) memorizzare nella cache l'output dell'helper. Predefinito: 3600.

Distribuzione e aggiornamento automatico

Chiave

Tipo

Descrizione

deploymentOrganizationUuid

stringa

UUID stabile che identifica questa distribuzione. Limita l'archiviazione locale e la telemetria.

autoUpdaterEnforcementHours

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.

disableAutoUpdates

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

disableEssentialTelemetry

booleano

Blocca i rapporti di arresto anomalo ed errore e i dati di tempistica delle prestazioni inviati ad Anthropic.

disableNonessentialTelemetry

booleano

Blocca l'analisi dell'utilizzo del prodotto — utilizzo delle funzioni, modelli di navigazione, azioni dell'interfaccia utente.

disableNonessentialServices

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.

otlpEndpoint

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.

otlpProtocol

stringa

http/protobuf (predefinito), http/json o grpc.

otlpHeaders

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

isDesktopExtensionEnabled

booleano

Consenti agli utenti di installare estensioni desktop locali (.dxt o .mcpb).

isDesktopExtensionDirectoryEnabled

booleano

Mostra la directory delle estensioni Anthropic nell'interfaccia dei connettori.

isDesktopExtensionSignatureRequired

booleano

Rifiuta le estensioni desktop che non sono firmate da un editore attendibile.

isLocalDevMcpEnabled

booleano

Consenti agli utenti di aggiungere i propri server MCP locali. Se false, sono disponibili solo i server dall'elenco gestito.

isClaudeCodeForDesktopEnabled

booleano

Mostra la scheda Codice (sessioni di codifica basate su terminale). Le sessioni vengono eseguite sull'host, non all'interno della VM.

managedMcpServers

stringa

Array JSON di configurazioni server MCP remoti. Ogni voce richiede nome e url. Facoltativo: transport (http o sse), headers, oauth, toolPolicy.

disabledBuiltinTools

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.

coworkEgressAllowedHosts

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

allowedWorkspaceFolders

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.

inferenceMaxTokensPerWindow

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.

inferenceTokenWindowHours

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

Hai ricevuto la risposta alla tua domanda?