Se i tuoi sviluppatori utilizzano Claude Code CLI, configuralo separatamente dall'app desktop. L'app desktop acquisisce le impostazioni del provider da Claude Desktop on 3P, non da ANTHROPIC_BASE_URL o settings.json, e le passa alle sessioni di Code che avvia. La CLI legge le variabili di ambiente, i file di impostazioni e le impostazioni gestite di Claude Code, che utilizzano una chiave di policy separata.
Questa guida è destinata agli amministratori delle organizzazioni con piani Claude Enterprise.
Questo articolo fa parte di Passare da Claude Enterprise a Claude Desktop su un provider cloud, che definisce i termini wave, overlap period e cutoff date.
La CLI e tutto ciò che viene eseguito localmente funziona su ogni provider. Dopo il passaggio, gli sviluppatori accedono diversamente, le tue policy raggiungono i loro computer diversamente e alcune funzioni non sono disponibili.
Connetti la CLI al tuo provider
Imposta le variabili del provider per Amazon Bedrock, Google Cloud, Microsoft Foundry o un gateway LLM. Gli sviluppatori non hanno bisogno di un accesso al browser claude.ai. Con un gateway, imposta sia l'URL di base che una credenziale del gateway. Con solo l'URL di base, un accesso claude.ai salvato rimane la credenziale attiva, quindi i suoi limiti e la fatturazione continuano ad applicarsi. Prima di un rollout del team, fissa le versioni del tuo modello.
Distribuisci la policy a ogni dispositivo
Le impostazioni gestite dal server non si applicano quando è impostato un provider di terze parti o un URL di base personalizzato. Sposta quelle policy alle impostazioni gestite sul dispositivo. Puoi distribuirle come file managed-settings.json, il profilo macOS com.anthropic.claudecode o la chiave di registro HKLM\SOFTWARE\Policies\ClaudeCode. Hanno priorità rispetto alle impostazioni utente e progetto, ad eccezione di alcune chiavi sensibili alla sicurezza in cui un valore più restrittivo da un livello inferiore conta ancora.
Limita i provider che un computer può utilizzare: Imposta
allowedProviders(Claude Code v2.1.285 o successivo). Durante il periodo di sovrapposizione, un elenco come["anthropic", "bedrock"]consente agli sviluppatori di utilizzare uno qualsiasi dei due. Dopo il passaggio, elenca solo il nuovo provider. Mantieni «anthropic» sui computer in cui gli utenti rimangono connessi a claude.ai in Claude Desktop, perché le loro sessioni di Cowork vengono rifiutate senza di esso. Per un gateway raggiunto tramiteANTHROPIC_BASE_URL, elenca"customEndpoint"e inserisci l'URL del gateway nel bloccoenvdella stessa fonte gestita.Rimuovi le vecchie impostazioni di accesso: Con le credenziali del gateway, rimuovi
forceLoginMethodeforceLoginOrgUUID, perché una qualsiasi chiave blocca le credenziali del gateway all'avvio. Su un provider cloud, quelle chiavi bloccano una sessione solo mentre determinate credenziali sono ancora sul computer:ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKEN, una credenzialeapiKeyHelpero una chiave API salvata da un accesso precedente a Claude Console.
Gli sviluppatori possono eseguire /status per vedere il provider attivo e da dove provengono le loro impostazioni. Per telemetria, host di rete e aggiornamenti, consulta Utilizzo dei dati, Configurazione della rete aziendale e Configurazione avanzata.
Traccia costi e utilizzo
Su Bedrock, Google Cloud e Foundry, l'utilizzo è fatturato per token al tuo account cloud e i controlli dei costi sono nella tua console di fatturazione cloud. Tramite un gateway, l'utilizzo è fatturato per token a chi possiede la credenziale che il gateway inoltra. I dashboard di analisi claude.ai e l'API Claude Code Analytics non coprono questo utilizzo. Per la segnalazione per utente, utilizza OpenTelemetry o un gateway LLM.
Cosa si trasferisce per gli sviluppatori
Elemento | Dopo il passaggio | Cosa fare |
Impostazioni, | Rimangono. Vivono in | Nulla, a meno che tu non esegua il logout (vedi sotto). Lascia queste cartelle in posizione durante qualsiasi pulizia. |
Trascrizioni di sessioni locali | Rimangono in | Testa la ripresa di una sessione nel tuo pilot. Su Bedrock, Google Cloud e Foundry, il modello precedente della sessione non viene ripristinato. Se l'upstream di un gateway rifiuta una firma di thinking precedente, Claude Code elimina i blocchi di thinking precedenti e riprova. |
Sessioni cloud | Anthropic le archivia con l'account Claude. | Prima del passaggio, estrai ogni sessione di cui hai bisogno nel terminale con |
Connettori da claude.ai | Non caricati quando un provider di terze parti è attivo. | Aggiungili come server MCP a livello di utente o progetto, o distribuiscili tramite configurazione MCP gestita. Alcuni connettori ospitati da Anthropic, come Microsoft 365, Gmail e Google Calendar, non supportano l'accesso da un server che aggiungi tu stesso, quindi pianifica un server diverso per quelli. |
Skill sincronizzate da claude.ai | La sincronizzazione delle skill non viene eseguita nelle sessioni su Bedrock, Google Cloud o Foundry, o quando una credenziale del gateway sostituisce l'accesso a claude.ai. Le skill sincronizzate in precedenza rimangono su disco in | Copia qualsiasi skill su cui fai affidamento da |
Plugin sincronizzati da claude.ai | Né scaricati né caricati nelle sessioni su Bedrock, Google Cloud o Foundry, perché quelle sessioni non recuperano i flag di funzionalità da Anthropic. Lo stesso vale quando | Reinstallali da un marketplace, se ne ha uno. |
Funzioni che richiedono un accesso a claude.ai | Non raggiungibili da un provider. Questi includono sessioni cloud, Routine, Code Review gestito, Ultrareview, Remote Control, l'estensione Chrome e la dettatura vocale. I canali e il dashboard di analisi non sono disponibili su Bedrock, Google Cloud e Foundry. Nemmeno l'Advisor e Code Mode. La ricerca web della CLI non è disponibile su Bedrock. La modalità veloce non è disponibile su Bedrock e Foundry e su Google Cloud è limitata a Claude Fable 5.2. | Utilizza |
Cosa osservare durante il periodo di sovrapposizione
Le impostazioni gestite dal server hanno priorità nelle sessioni che si autenticano ancora con claude.ai. Per impostazione predefinita, Claude Code le utilizza e salta le impostazioni gestite sul dispositivo, con poche eccezioni come il blocco
enveallowedProviders. Se alcuni sviluppatori rimangono su claude.ai, utilizza le impostazioni gestite dal server per loro e un file o una policy del sistema operativo per tutti gli altri.Un accesso a claude.ai salvato rimane sul computer. Le credenziali del provider cloud hanno precedenza su di esso e
/logoutnon è disponibile una volta che un provider cloud è attivo. Se desideri che l'accesso venga rimosso, chiedi agli sviluppatori di eseguire il logout prima di distribuire le impostazioni del provider. Il logout rimuove anche gli accessi salvati del server MCP e i segreti dei plugin, quindi dovranno autorizzarli di nuovo. Con una credenziale del gateway,/logoutrimane disponibile e puoi eseguirlo per cancellare l'accesso salvato.La policy CLI può sovrascrivere parte della tua policy desktop. Per impostazione predefinita, se un computer ha impostazioni gestite di Claude Code, una sessione di Code desktop ignora i valori della policy gestita che l'app desktop fornisce. Per utilizzare entrambi, consulta
parentSettingsBehaviorin Distribuisci impostazioni gestite.
Checklist per gli sviluppatori
Prima del passaggio
Aggiorna Claude Code alla versione specificata dai tuoi amministratori.
Estrai qualsiasi sessione cloud di cui hai bisogno nel terminale con
claude --teleport. Prima assicurati che il ramo della sessione sia inviato al remoto e pulisci il tuo albero di lavoro.Elenca i connettori claude.ai che utilizzi, in modo che possano essere aggiunti come server MCP.
Copia qualsiasi skill su cui fai affidamento da
~/.claude/skills/synced/e elenca i plugin sincronizzati che dovrai reinstallare.
Nel giorno del passaggio
Accedi al tuo provider cloud nel modo descritto dai tuoi amministratori, ad esempio con
aws sso login,gcloud auth application-default loginoaz login.Avvia
claudeed esegui/status. Controlla il provider, il modello e l'origine delle impostazioni.Riapri una sessione recente con
claude --resumee conferma che risponde.Comunica ai tuoi amministratori qualsiasi strumento o connettore mancante.
