Migrazione di Claude Code da Console a Enterprise

Questa guida è stata creata per i team che migrano dall'accesso a Claude Code basato su Console a Claude Enterprise. Nota che gli utenti individuali non devono migrare la cronologia delle sessioni per le sessioni CLI poiché vengono archiviate localmente. Devi solo provisioning degli account Claude Enterprise per ogni utente, quindi gli utenti dovrebbero cambiare il loro metodo di accesso da Console a Claude Enterprise.

Claude Code su Console API è un modo veloce per far iniziare gli sviluppatori, ma lascia la governance a ogni singola macchina. Claude Enterprise mette lo stesso Claude Code che i tuoi sviluppatori già utilizzano dietro i controlli di cui i team di sicurezza, IT e finanza hanno bisogno per eseguirlo su larga scala. Ottieni identità centralizzata e accesso attraverso il tuo IdP esistente, impostazioni gestite dal server che applicano le politiche di strumenti, file e MCP su ogni client senza MDM, e limiti di spesa granulari che si propagano dall'organizzazione ai singoli utenti.

Claude Enterprise aggiunge analitiche avanzate e log di audit (incluse metriche di contributo come PR e righe committate), controlli di conservazione dati personalizzati e superfici di prodotto aggiuntive—Claude Code sul web, mobile e Slack (Claude Tag), più Code Review—che non sono disponibili su Console. E poiché Claude Enterprise è disponibile tramite AWS Marketplace, l'approvvigionamento può avvenire attraverso il canale che hai già.

Documentazione: Ruoli e autorizzazioni, Acquisto e gestione dei posti nei piani Enterprise, Come vengo fatturato per il mio piano Enterprise?, Utilizzo di Claude Code con il tuo piano Enterprise

Ecco cosa deve fare il tuo team di identità:

Se l'SSO dell'organizzazione Enterprise è configurato come solo accesso, l'accesso non crea account — gli utenti devono essere invitati manualmente. Abilita JIT o il provisioning SCIM prima di indirizzare gli sviluppatori ad accedere. Vedi Configura JIT o provisioning SCIM.

I piani Claude Enterprise offrono un sistema di controllo della spesa gerarchico. I limiti si propagano in cascata — un utente non può mai superare i limiti dell'organizzazione.

I proprietari possono impostare i limiti su "illimitato," ma tutto il consumo viene comunque fatturato. Se un utente con un posto a consumo raggiunge il suo limite, non può utilizzare Claude o Claude Code fino al prossimo periodo di fatturazione o fino a quando un amministratore non aumenta il suo limite.

Documentazione: Configurazione dei limiti di spesa, Gestisci gruppi e limiti di spesa dei gruppi nei piani Enterprise

Per gli utenti forniti tramite SCIM, l'assegnazione dei posti avviene automaticamente in base ai mapping dei gruppi. Gli utenti vengono assegnati per impostazione predefinita al livello di posto più alto disponibile se non è configurato alcun mapping di gruppo.

Gli sviluppatori attualmente autenticati rispetto all'organizzazione Console dovranno ri-autenticarsi rispetto all'organizzazione Claude Enterprise:

CI e automazione

Le pipeline e gli script non utilizzano /login. Mantieni un'organizzazione Console (e le sue chiavi API) per l'automazione e migra solo i posti degli sviluppatori interattivi, oppure passa CI a una credenziale Enterprise: esegui claude setup-token mentre sei connesso all'organizzazione Enterprise e imposta il token stampato come CLAUDE_CODE_OAUTH_TOKEN nel tuo ambiente CI. Non rimuovere le credenziali CI fino a quando una di queste non è in atto.

Dopo la convalida della migrazione

Rimuovi gli sviluppatori migrati dall'organizzazione Console (o ruota le loro chiavi). La rimozione revoca i loro token di accesso Console e disabilita la loro chiave dell'area di lavoro Claude Code, interrompendo ulteriori fatturazioni Console dall'uso interattivo. Le chiavi API che hanno creato in altri spazi di lavoro Console non vengono disabilitate dalla rimozione — rivedi e disabilita quelle separatamente. Non rimuovere i membri fino a quando non hai confermato che l'accesso Enterprise funziona; non esiste un rollback automatico.

Documentazione: Acquisto e gestione dei posti nei piani Enterprise

Il passaggio dall'API Console a Claude Enterprise sblocca analitiche più ricche per l'utilizzo di Claude Code:

Tutti i report sono accessibili da Analytics nel pannello di amministrazione di Claude. Per l'accesso programmatico, l'API Claude Enterprise Analytics restituisce metriche di coinvolgimento per utente, attività Claude Code (commit, pull request, righe di codice) e dati di utilizzo e costi. Gli analytics non migrano: l'organizzazione Enterprise inizia con una cronologia di report nuova, e la sua API Analytics/Admin richiede una nuova chiave API creata nell'organizzazione Enterprise — le chiavi Console non vengono trasferite. Esporta gli analytics Console di cui hai bisogno per i dashboard storici prima della migrazione. Il traffico che rimane sulle chiavi API Console (ad esempio CI) continua a comparire solo nei report Console.

Docs: Claude Code Usage Analytics

Questo è l'aggiornamento più significativo per i team di sicurezza e IT. Le impostazioni gestite dal server consentono il controllo centralizzato e applicabile su ciò che Claude Code può e non può fare su ogni macchina dello sviluppatore. Ci sono due modi per distribuirle, e non hai bisogno di MDM per usare il primo.

Claude Code legge la configurazione da una gerarchia di fonti di impostazioni. Il file managed-settings.json si trova in cima e non può essere sovrascritto dalle impostazioni dell'utente o del progetto:

Impostazioni gestite dal server (nessun MDM richiesto): Un proprietario o proprietario principale definisce le impostazioni in Impostazioni organizzazione → Claude Code → Impostazioni gestite nella console di amministrazione. Ogni client Claude Code connesso all'organizzazione le recupera automaticamente all'avvio e le controlla ogni ora per gli aggiornamenti. Questa è la scelta giusta per le organizzazioni senza infrastruttura di gestione dei dispositivi o con utenti su dispositivi non gestiti. Scopri di più sulle impostazioni gestite dal server.

Impostazioni gestite dall'endpoint: L'IT distribuisce le impostazioni direttamente ai dispositivi, tramite criteri OS nativi (preferenze gestite macOS o il registro di Windows, tramite Jamf, Intune, Group Policy, ecc.) o come file managed-settings.json spinto ai percorsi di sistema di seguito. Proteggi il file con autorizzazioni a livello di OS in modo che gli utenti finali non possano modificarlo. Su dispositivi registrati, questo fornisce garanzie più forti rispetto alla distribuzione gestita dal server perché l'OS impedisce la manomissione da parte dell'utente.

Queste sono le impostazioni più rilevanti per una migrazione da Console a Enterprise. Claude Code supporta molte altre: per l'elenco completo e aggiornato, consulta Impostazioni di Claude Code.

Distribuzione: Utilizza il tuo strumento MDM (Intune, Jamf, SCCM, Puppet, ecc.) per inviare managed-settings.json a tutti i computer degli sviluppatori. Proteggi il file con autorizzazioni a livello di sistema operativo in modo che gli utenti finali non possano modificarlo.

Documentazione: Impostazioni di Claude Code, Impostazioni gestite, Ambiti di installazione MCP