Vai al contenuto principale

Sposta gli utenti di Claude Code CLI

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 tramite ANTHROPIC_BASE_URL, elenca "customEndpoint" e inserisci l'URL del gateway nel blocco env della stessa fonte gestita.

  • Rimuovi le vecchie impostazioni di accesso: Con le credenziali del gateway, rimuovi forceLoginMethod e forceLoginOrgUUID, 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 credenziale apiKeyHelper o 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, CLAUDE.md, memoria automatica, skill, subagent, comandi, hook, plugin e server MCP

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 ~/.claude/projects/ fino a quando cleanupPeriodDays le rimuove. L'impostazione predefinita è 30 giorni. claude --continue e claude --resume le riaprono.

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. --cloud non è disponibile quando Claude Code è configurato per un provider di terze parti e --resume non elenca le sessioni cloud.

Prima del passaggio, estrai ogni sessione di cui hai bisogno nel terminale con --teleport. Crea una copia locale. Richiede un accesso a claude.ai, un albero di lavoro pulito, un checkout dello stesso repository e il ramo della sessione inviato al remoto.

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 ~/.claude/skills/synced/.

Copia qualsiasi skill su cui fai affidamento da ~/.claude/skills/synced/ in ~/.claude/skills/.

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 ANTHROPIC_AUTH_TOKEN o apiKeyHelper fornisce la credenziale.

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 /loop per la pianificazione, GitHub Actions o GitLab CI/CD per le esecuzioni cloud (solo GitHub Actions su Foundry) e /code-review locale. Decidi se gli sviluppatori hanno ancora bisogno di posti Team o Enterprise.

Cosa osservare durante il periodo di sovrapposizione

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

  1. Accedi al tuo provider cloud nel modo descritto dai tuoi amministratori, ad esempio con aws sso login, gcloud auth application-default login o az login.

  2. Avvia claude ed esegui /status. Controlla il provider, il modello e l'origine delle impostazioni.

  3. Riapri una sessione recente con claude --resume e conferma che risponde.

  4. Comunica ai tuoi amministratori qualsiasi strumento o connettore mancante.

Hai ricevuto la risposta alla tua domanda?