Opções de autenticação da CLI

A CLI ant suporta várias fontes de credenciais. O Quickstart cobre o caminho feliz de um único comando (ant auth login). Esta página cobre todas as opções em detalhes.

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 no Claude Console e armazena as credenciais resultantes em $ANTHROPIC_CONFIG_DIR (consulte Diretório de configuração 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.

ant auth login

# Em um host remoto sem navegador:
ant auth login --no-browser

# Vincular a um workspace específico e pular o seletor do navegador:
ant auth login --workspace-id wrkspc_01...

# Se o perfil nomeado que você passar com --profile não existir,
# um novo perfil nomeado será criado com esse nome.
ant auth login --profile <profile-name>

Durante o fluxo no navegador, você seleciona uma organização e, em seguida, um workspace. O token emitido tem escopo limitado a esse workspace, então a CLI só pode ver 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.

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 em vez disso.

O login grava credenciais em credentials/<profile>.json. O primeiro login para um perfil também cria configs/<profile>.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.

Chave de API

A CLI também lê sua chave de API da variável de ambiente ANTHROPIC_API_KEY. Obtenha uma chave no Claude Console.

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.

Verificar 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.

ant auth status

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 foram selecionados. O comando reporta status em vez de realizar uma verificação de integridade, então não crie scripts baseados no status de saída. Para a ordenação completa das fontes de credenciais, consulte Precedência de credenciais.

Alternar entre workspaces

Um token de login interativo está vinculado a um único workspace. Para usar a CLI em mais de um workspace, faça login em cada um sob seu próprio perfil nomeado e, em seguida, alterne entre eles:

# 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. Defina-o como 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 para confirmar qual perfil e workspace estão ativos.

Gerenciar perfis

Os subcomandos ant profile inspecionam e editam o estado do perfil diretamente:

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. Para Workload Identity Federation, consulte a Visão geral de autenticação e a referência de WIF.