--- title: Opções de autenticação da CLI url: https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/authentication description: Autentique a CLI ant com login interativo, chaves de API, perfis nomeados e Workload Identity Federation. --- A CLI `ant` oferece suporte a várias fontes de credenciais. O [Quickstart](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/quickstart#authentication) cobre o caminho feliz de um único comando (`ant auth login`). Esta página cobre cada opção por completo. ## Login interativo `ant auth login` permite que você chame a API sem criar ou gerenciar uma chave de API. Ele abre um fluxo OAuth baseado em navegador contra o Claude Console e armazena as credenciais resultantes em `$ANTHROPIC_CONFIG_DIR` (consulte [Diretório de configuração](https://platform.claude.com/docs/pt-BR/manage-claude/wif-reference#configuration-directory) para o padrão específico do sistema operacional). Em um host remoto ou em qualquer ambiente sem um navegador local, passe `--no-browser` para imprimir a URL de autorização e cole o código retornado de volta no terminal. ```bash CLI ant auth login # Em um host remoto sem navegador: ant auth login --no-browser # Vincule a um workspace específico e pule o seletor do navegador: ant auth login --workspace-id wrkspc_01... # Se o perfil nomeado que você passa com --profile não existir, # um novo perfil nomeado será criado com esse nome. ant auth login --profile ``` Durante o fluxo do navegador, você seleciona uma organização e, em seguida, um [workspace](https://platform.claude.com/docs/pt-BR/manage-claude/workspaces). O token emitido é [limitado a esse workspace](https://platform.claude.com/docs/pt-BR/manage-claude/workspaces#api-keys-and-resource-scoping), de modo que a CLI só pode ver os recursos que pertencem a ele. Passe `--workspace-id` para vincular diretamente e pular o seletor. Para trabalhar em mais de um workspace, consulte [Alternar entre workspaces](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/authentication#switch-between-workspaces). O login interativo é destinado ao desenvolvimento local e scripting na sua própria máquina. Para cargas de trabalho não interativas, como CI, servidores e contêineres, use [Workload Identity Federation](https://platform.claude.com/docs/pt-BR/manage-claude/workload-identity-federation) em vez disso. O login grava credenciais em `credentials/.json`. O primeiro login de um perfil também cria `configs/.json` e o define como o perfil ativo. Para remover credenciais armazenadas, execute `ant auth logout`, ou `ant auth logout --all` para limpar todos os perfis. ## Acesso de administrador Por padrão, `ant auth login` solicita um token limitado ao workspace. Para gerenciar os recursos documentados na página [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api), solicite o escopo `org:admin` sob um perfil dedicado: ```bash CLI ant auth login --profile admin --scope "org:admin" # Imprime um bearer token para cabeçalhos Authorization: ant auth print-credentials --profile admin --access-token ``` O escopo `org:admin` é concedido apenas a membros da organização com a função de admin, owner ou primary owner. O token emitido tem acesso a toda a organização, e qualquer vinculação de workspace no perfil não o restringe. Mantenha o perfil de administrador separado do seu perfil do dia a dia para que os comandos de rotina nunca sejam executados com acesso elevado. ## Chave de API A CLI também lê sua chave de API a partir da variável de ambiente `ANTHROPIC_API_KEY`. Obtenha uma chave no [Claude Console](https://platform.claude.com/settings/keys). ```bash echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc source ~/.zshrc ``` ```bash echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.bashrc source ~/.bashrc ``` ```powershell setx ANTHROPIC_API_KEY "sk-ant-api03-..." ``` Abra um novo terminal para que a alteração tenha efeito. Para substituir a chave em uma única invocação, passe `--api-key`. Para apontar para um host de API diferente, defina `ANTHROPIC_BASE_URL` ou passe `--base-url`. Se você estiver usando uma chave de API limitada a vários workspaces, como uma [chave de conta pessoal ou de serviço](https://platform.claude.com/docs/pt-BR/manage-claude/authentication#key-types), você deve [especificar o workspace](https://platform.claude.com/docs/pt-BR/manage-claude/authentication#select-a-workspace) no qual executar seu comando. Faça isso definindo uma variável de ambiente `ANTHROPIC_WORKSPACE_ID`, que a CLI lê automaticamente, ou usando a [flag `--workspace-id`](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/using#global-flags). O valor deve ser um ID `wrkspc_...`. ```bash CLI ant messages create \ --workspace-id wrkspc_01... \ --model claude-opus-5-5 \ --max-tokens 1024 \ --message '{role: user, content: "Hello, Claude"}' ``` ## Verificar o status de autenticação `ant auth status` imprime a fonte de credencial que a CLI selecionou (variável de ambiente de chave de API, login OAuth, federação ou perfil), o perfil ativo, o workspace ao qual o token ativo está vinculado e os caminhos do diretório de configuração. Use-o para diagnosticar por que uma carga de trabalho escolheu a credencial ou o workspace errado. ```bash CLI ant auth status ``` ```text Active profile: default Config dir: ~/.config/anthropic Profile config: ~/.config/anthropic/configs/default.json Credentials: ~/.config/anthropic/credentials/default.json Credentials (active) * Profile (user_oauth) [via active_config] sk-ant-oat01-EXA... ... Workspace (active) * Workspace wrkspc_01... (Engineering) ``` Leia as linhas `(active)` para ver qual fonte de credencial e workspace venceram. O comando relata o status em vez de realizar uma verificação de integridade, então não crie scripts com base no status de saída. Para a ordenação completa das fontes de credenciais, consulte [Precedência de credenciais](https://platform.claude.com/docs/pt-BR/manage-claude/wif-reference#credential-precedence). ## Alternar entre workspaces Um token de login interativo é vinculado a um único workspace. Para usar a CLI contra mais de um workspace, faça login em cada um sob seu próprio perfil nomeado e, em seguida, alterne entre eles: ```bash CLI # 1. Crie o perfil (interativo; escolha o outro workspace no # navegador, ou passe --workspace-id para pular o seletor): # ant auth login --profile other-ws # 2. Torne-o o padrão para os comandos subsequentes: ant profile activate other-ws # 3. Ou selecione-o para um único comando sem alterar o padrão: ant --profile other-ws models list ANTHROPIC_PROFILE=other-ws ant models list ``` Execute [`ant auth status`](https://platform.claude.com/docs/pt-BR/cli-sdks-libraries/cli/authentication#check-authentication-status) para confirmar qual perfil e workspace estão ativos. Os perfis só são consultados quando nenhuma chave de API está definida. Se `ANTHROPIC_API_KEY` estiver presente no seu ambiente, ela substitui todos os perfis e esses comandos usam o workspace dessa chave (ou, para uma chave de múltiplos workspaces, o workspace definido com `ANTHROPIC_WORKSPACE_ID` ou `--workspace-id`). Remova-a antes de alternar perfis. ## Gerenciar perfis Os subcomandos `ant profile` inspecionam e editam o estado do perfil diretamente: ```bash CLI ant profile list ant profile get --profile other-ws ant profile set workspace_id wrkspc_01... --profile other-ws ``` As chaves graváveis para `ant profile set` são `workspace_id`, `base_url`, `organization_id`, `scope`, `client_id` e `console_url`. Definir `workspace_id` registra o workspace de destino na configuração do perfil, mas não revincula credenciais que já foram emitidas; execute `ant auth login` novamente sob esse perfil para gerar um token para o novo workspace. Para o esquema do arquivo de perfil e o bloco de federação, consulte [Arquivo de configuração de perfil](https://platform.claude.com/docs/pt-BR/manage-claude/wif-reference#profile-configuration-file). Para Workload Identity Federation, consulte a [Visão geral de autenticação](https://platform.claude.com/docs/pt-BR/manage-claude/authentication) e a [referência de WIF](https://platform.claude.com/docs/pt-BR/manage-claude/wif-reference). ## Próximos passos Estrutura de comandos, formatos de saída, transformações GJSON e corpos de requisição Controle de versão de recursos da API, padrões de scripting e uso a partir do Claude Code Autenticação não interativa para CI, servidores e contêineres