Ir para conteúdo principal

Mover usuários do Claude Code CLI

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 de ANTHROPIC_BASE_URL, liste "customEndpoint" e coloque a URL do gateway no bloco env da mesma fonte gerenciada.

  • Remover configurações de login antigas: Com credenciais de gateway, remova forceLoginMethod e forceLoginOrgUUID, 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 credencial apiKeyHelper ou 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, CLAUDE.md, memória automática, habilidades, subagendes, comandos, hooks, plugins e servidores MCP

Eles permanecem. Eles vivem em ~/.claude, ~/.claude.json e a pasta do projeto.

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 ~/.claude/projects/ até que cleanupPeriodDays as remova. O padrão é 30 dias. claude --continue e claude --resume as reabrem.

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. --cloud não está disponível quando o Claude Code está configurado para um provedor de terceiros, e --resume não lista sessões de nuvem.

Antes da migração, puxe cada sessão que você precisa para o terminal com --teleport. Isso faz uma cópia local. Precisa de um login no claude.ai, uma árvore de trabalho limpa, um checkout do mesmo repositório e o branch da sessão enviado para o remoto.

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

Copie qualquer habilidade em que você confie de ~/.claude/skills/synced/ para ~/.claude/skills/.

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 ANTHROPIC_AUTH_TOKEN ou apiKeyHelper fornece a credencial.

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 /loop para agendamento, GitHub Actions ou GitLab CI/CD para execuções de nuvem (apenas GitHub Actions no Foundry) e /code-review local. Decida se os desenvolvedores ainda precisam de assentos Team ou Enterprise.

O que observar durante o período de sobreposição

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

  1. Faça login em seu provedor de nuvem da forma que seus administradores descrevem, por exemplo com aws sso login, gcloud auth application-default login ou az login.

  2. Inicie claude e execute /status. Verifique o provedor, o modelo e a fonte de configurações.

  3. Reabra uma sessão recente com claude --resume e confirme que ela responde.

  4. Informe seus administradores sobre qualquer ferramenta ou conector que esteja faltando.

Isto respondeu à sua pergunta?