Ao usar Claude Code, é importante entender como os métodos de autenticação são priorizados para evitar cobranças inesperadas de API e garantir que você esteja usando a conta pretendida.
Como funciona a autenticação
Claude Code prioriza chaves de API de variáveis de ambiente em relação a assinaturas autenticadas.
Este é um comportamento intencional projetado para lhe dar flexibilidade na escolha do seu método de autenticação.
Quando uma chave de API é definida como uma variável de ambiente, você será cobrado por meio de taxas de pagamento conforme o uso da API usando a conta de API associada a essa chave.
Isso acontece mesmo se você estiver conectado ao Claude Code com uma assinatura claude.ai ou uma conta Console diferente.
Melhores práticas
Para usar Claude Code com sua assinatura Claude: Mantenha a variável de ambiente ANTHROPIC_API_KEY não definida.
Isso evita cobranças inesperadas de API e garante que você esteja usando o uso incluído na sua assinatura.
Se você precisar usar uma chave de API específica ocasionalmente, defina-a temporariamente apenas quando necessário.
Execute /status no Claude Code periodicamente para verificar seu método de autenticação atual.
Avisos de conflito de autenticação
Claude Code o notificará quando houver um conflito entre sua assinatura autenticada e uma chave de API de variável de ambiente:
Durante a configuração inicial, se uma chave de API for detectada em suas variáveis de ambiente, Claude Code pedirá que você confirme qual método de autenticação deseja usar.
Após o login bem-sucedido, você verá uma notificação se ambas as credenciais estiverem ativas, alertando-o sobre o potencial de cobranças inesperadas de API.
Verifique sua configuração atual
Para verificar se uma chave de API está definida como uma variável de ambiente, execute /status no Claude Code. Isso mostrará qual método de autenticação está ativo no momento.
Para verificar sua variável de ambiente diretamente, execute um destes comandos em um terminal (fora do Claude Code):
macOS/Linux:
echo $ANTHROPIC_API_KEY
Windows CMD:
echo %ANTHROPIC_API_KEY%
Windows PowerShell:
echo $env:ANTHROPIC_API_KEY
Definir uma chave de API temporariamente
Se você precisar usar uma chave de API apenas para a sessão de terminal atual:
macOS/Linux:
export ANTHROPIC_API_KEY='your-api-key-here'
Windows CMD:
set ANTHROPIC_API_KEY=your-api-key-here
Windows PowerShell:
$env:ANTHROPIC_API_KEY="your-api-key-here"
Definir uma variável de ambiente de chave de API permanentemente
macOS/Linux:
For zsh (default on macOS):
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Apply changes
source ~/.zshrc
For bash:
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Apply changes
source ~/.bash_profile
Windows:
Abra Propriedades do Sistema → Avançado → Variáveis de Ambiente
Em "Variáveis do usuário", clique em "Novo"
Nome da variável: ANTHROPIC_API_KEY
Valor da variável: sua-chave-api-aqui
Clique em OK e reinicie seu terminal
Remover uma variável de ambiente de chave de API
macOS/Linux (temporário):
unset ANTHROPIC_API_KEY
macOS (permanente):
# Remove from config file
sed -i '' '/ANTHROPIC_API_KEY/d' ~/.zshrc
source ~/.zshrc
Linux (permanente)
sed -i '/ANTHROPIC_API_KEY/d' ~/.zshrc
Windows CMD:
set ANTHROPIC_API_KEY=
Windows PowerShell:
Remove-Item Env:ANTHROPIC_API_KEY
Windows (permanente): Exclua a variável das configurações de Variáveis de Ambiente do Sistema.
Problemas comuns a evitar
Definir variáveis de ambiente em arquivos de configuração de shell e esquecer delas.
Não reiniciar seu terminal após alterar variáveis de ambiente.
Assumir que você está usando sua assinatura quando uma chave de API está configurada em seu ambiente.
Se você tiver alguma dúvida, entre em contato com nossa equipe de Suporte.