Se seus desenvolvedores usam o Claude Code CLI, configure-o separadamente do aplicativo de desktop. O aplicativo de desktop obtém suas configurações de provedor do Claude Desktop em configuração 3P, não de ANTHROPIC_BASE_URL ou settings.json, e as passa para as sessões de Code que inicia. O CLI lê variáveis de ambiente, arquivos de configuração e configurações gerenciadas do Claude Code, que usam uma chave de política separada.
Este guia é para administradores de organizações em planos Claude Enterprise.
Este artigo faz parte de Migrar do Claude Enterprise para Claude Desktop em um provedor de nuvem, que define os termos onda, período de sobreposição e data de corte.
O CLI e tudo que é executado localmente funcionam em todos os provedores. Após a migração, os desenvolvedores fazem login de forma diferente, suas políticas chegam aos computadores deles de forma diferente e alguns recursos não estão disponíveis.
Conectar o CLI ao seu provedor
Defina as variáveis de provedor para Amazon Bedrock, Google Cloud, Microsoft Foundry ou um gateway LLM. Os desenvolvedores não precisam de um login no navegador claude.ai. Com um gateway, defina a URL base e uma credencial de gateway. Com apenas a URL base, um login claude.ai salvo permanece como a credencial ativa, portanto seus limites e faturamento ainda se aplicam. Antes de um lançamento em equipe, fixe suas versões de modelo.
Entregar política para cada dispositivo
As configurações gerenciadas pelo servidor não se aplicam quando um provedor de terceiros ou uma URL base personalizada está definida. Mova essas políticas para configurações gerenciadas no dispositivo. Você pode entregá-las como um arquivo managed-settings.json, o perfil macOS com.anthropic.claudecode ou a chave de registro HKLM\SOFTWARE\Policies\ClaudeCode. Elas têm prioridade sobre as configurações de usuário e projeto, exceto por algumas chaves sensíveis à segurança em que um valor mais restritivo de um nível inferior ainda conta.
Limitar quais provedores um computador pode usar: Defina
allowedProviders(Claude Code v2.1.285 ou posterior). Durante o período de sobreposição, uma lista como["anthropic", "bedrock"]permite que os desenvolvedores usem qualquer um. Após a migração, liste apenas o novo provedor. Mantenha “anthropic” em computadores onde os usuários permanecem conectados ao claude.ai no Claude Desktop, porque suas sessões de Cowork são recusadas sem ele. Para um gateway acessado através deANTHROPIC_BASE_URL, liste"customEndpoint"e coloque a URL do gateway no blocoenvda mesma fonte gerenciada.Remover configurações de login antigas: Com credenciais de gateway, remova
forceLoginMethodeforceLoginOrgUUID, porque qualquer uma dessas chaves bloqueia credenciais de gateway na inicialização. Em um provedor de nuvem, essas chaves bloqueiam uma sessão apenas enquanto certas credenciais ainda estão no computador:ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKEN, uma credencialapiKeyHelperou uma chave de API salva por um login anterior do Claude Console.
Os desenvolvedores podem executar /status para ver o provedor ativo e de onde suas configurações vêm. Para telemetria, hosts de rede e atualizações, consulte Uso de dados, Configuração de rede corporativa e Configuração avançada.
Rastrear custo e uso
No Bedrock, Google Cloud e Foundry, o uso é faturado por token para sua conta de nuvem, e os controles de custo estão no seu console de faturamento de nuvem. Através de um gateway, o uso é faturado por token para quem possui a credencial que o gateway encaminha. Os painéis de análise do claude.ai e a API de Análise do Claude Code não cobrem esse uso. Para relatórios por usuário, use OpenTelemetry ou um gateway LLM.
O que é transferido para os desenvolvedores
Item | Após a migração | O que fazer |
Configurações, | Eles permanecem. Eles vivem em | Nada, a menos que você faça logout (veja abaixo). Deixe essas pastas no lugar durante qualquer limpeza. |
Transcrições de sessão local | Elas permanecem em | Teste retomar uma sessão em seu piloto. No Bedrock, Google Cloud e Foundry, o modelo anterior da sessão não é restaurado. Se o upstream de um gateway rejeitar uma assinatura de pensamento anterior, o Claude Code descarta os blocos de pensamento anterior e tenta novamente. |
Sessões de nuvem | A Anthropic as armazena sob a conta Claude. | Antes da migração, puxe cada sessão que você precisa para o terminal com |
Conectores do claude.ai | Não carregados quando um provedor de terceiros está ativo. | Adicione-os como servidores MCP no escopo de usuário ou projeto, ou implante-os através da configuração MCP gerenciada. Alguns conectores hospedados pela Anthropic, como Microsoft 365, Gmail e Google Calendar, não suportam login de um servidor que você adiciona, então planeje um servidor diferente para esses. |
Habilidades sincronizadas do claude.ai | A sincronização de habilidades não é executada em sessões no Bedrock, Google Cloud ou Foundry, ou quando uma credencial de gateway substitui o login do claude.ai. As habilidades sincronizadas anteriormente permanecem no disco em | Copie qualquer habilidade em que você confie de |
Plugins sincronizados do claude.ai | Nem baixados nem carregados em sessões no Bedrock, Google Cloud ou Foundry, porque essas sessões não buscam sinalizadores de recurso da Anthropic. O mesmo é verdadeiro quando | Reinstale-os de um marketplace, se houver um que os tenha. |
Recursos que precisam de um login no claude.ai | Não acessíveis de um provedor. Estes incluem sessões de nuvem, Rotinas, Revisão de Código gerenciada, Ultrareview, Controle Remoto, a extensão Chrome e ditado por voz. Canais e o painel de análise também não estão disponíveis no Bedrock, Google Cloud e Foundry. Nem o Advisor e o Code Mode. A busca na web do CLI não está disponível no Bedrock. O modo rápido não está disponível no Bedrock e Foundry, e no Google Cloud está limitado ao Claude Fable 5.2. | Use |
O que observar durante o período de sobreposição
As configurações gerenciadas pelo servidor têm prioridade em sessões que ainda se autenticam com claude.ai. Por padrão, o Claude Code as usa e pula as configurações gerenciadas no dispositivo, com algumas exceções como o bloco
enveallowedProviders. Se alguns desenvolvedores permanecerem no claude.ai, use configurações gerenciadas pelo servidor para eles e um arquivo ou política do SO para todos os outros.Um login claude.ai salvo permanece no computador. As credenciais do provedor de nuvem têm precedência sobre ele, e
/logoutnão está disponível uma vez que um provedor de nuvem está ativo. Se você quiser que o login seja removido, peça aos desenvolvedores que façam logout antes de implantar as configurações do provedor. Fazer logout também remove logins de servidor MCP salvos e segredos de plugin, então eles precisarão autorizar esses novamente. Com uma credencial de gateway,/logoutpermanece disponível e você pode executá-lo para limpar o login salvo.A política do CLI pode substituir parte de sua política de desktop. Por padrão, se um computador tem configurações gerenciadas do Claude Code, uma sessão de Code de desktop ignora os valores de política gerenciada que o aplicativo de desktop fornece. Para usar ambos, consulte
parentSettingsBehaviorem Implantar configurações gerenciadas.
Lista de verificação para desenvolvedores
Antes da migração
Atualize o Claude Code para a versão que seus administradores especificarem.
Puxe qualquer sessão de nuvem que você precisa para o terminal com
claude --teleport. Primeiro certifique-se de que o branch da sessão foi enviado para o remoto e limpe sua árvore de trabalho.Liste os conectores do claude.ai que você usa, para que possam ser adicionados como servidores MCP.
Copie qualquer habilidade em que você confie de
~/.claude/skills/synced/e liste os plugins sincronizados que você precisará reinstalar.
No dia da migração
Faça login em seu provedor de nuvem da forma que seus administradores descrevem, por exemplo com
aws sso login,gcloud auth application-default loginouaz login.Inicie
claudee execute/status. Verifique o provedor, o modelo e a fonte de configurações.Reabra uma sessão recente com
claude --resumee confirme que ela responde.Informe seus administradores sobre qualquer ferramenta ou conector que esteja faltando.
