Entender la prioridad de autenticación en Claude Code
Al usar Claude Code, es importante entender cómo se priorizan los métodos de autenticación para evitar cargos inesperados en la API y asegurar que estés usando tu cuenta prevista.
Importante: Si tienes una variable de entorno ANTHROPIC_API_KEY configurada en tu sistema, Claude Code usará esta clave API para la autenticación en lugar de tu suscripción Claude.ai (Pro, Max, Team o Enterprise), lo que resultará en cargos por uso de API en lugar de usar el uso incluido en tu suscripción.
Cómo funciona la autenticación
Claude Code prioriza las claves API de variables de entorno sobre las suscripciones autenticadas.
Este es un comportamiento intencional diseñado para darte flexibilidad en la elección de tu método de autenticación.
Cuando una clave API se establece como variable de entorno, se te cobrará según las tarifas de pago por uso de API usando la cuenta de API asociada con esa clave.
Esto ocurre incluso si has iniciado sesión en Claude Code con una suscripción claude.ai o una cuenta de Console diferente.
Mejores prácticas
Para usar Claude Code con tu suscripción Claude: Mantén la variable de entorno ANTHROPIC_API_KEY sin configurar.
Esto previene cargos inesperados en la API y asegura que estés usando el uso incluido en tu suscripción.
Si necesitas usar una clave API específica ocasionalmente, configúrala temporalmente solo cuando sea necesario.
Ejecuta /status en Claude Code periódicamente para verificar tu método de autenticación actual.
Advertencias de conflicto de autenticación
Claude Code te notificará cuando haya un conflicto entre tu suscripción autenticada y una clave API de variable de entorno:
Durante la configuración inicial, si se detecta una clave API en tus variables de entorno, Claude Code te pedirá que confirmes qué método de autenticación deseas usar
Después de un inicio de sesión exitoso, verás una notificación si ambas credenciales están activas, alertándote sobre el potencial de cargos inesperados en la API
Verificar tu configuración actual
Para verificar si una clave API está configurada como variable de entorno, ejecuta /status en Claude Code. Esto te mostrará qué método de autenticación está activo actualmente.
Para verificar tu variable de entorno directamente, ejecuta uno de estos comandos en una terminal (fuera de Claude Code):
macOS/Linux:
echo $ANTHROPIC_API_KEY
Windows CMD:
echo %ANTHROPIC_API_KEY%
Windows PowerShell:
echo $env:ANTHROPIC_API_KEY
Configurar una clave API temporalmente
Si necesitas usar una clave API solo para la sesión de terminal actual:
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"
Configurar una variable de entorno de clave API permanentemente
macOS/Linux:
Para zsh (predeterminado en macOS):
bash
# Agregar al archivo de configuración del shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Aplicar cambios
source ~/.zshrc
Para bash:
bash
# Agregar al archivo de configuración del shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Aplicar cambios
source ~/.bash_profile
Windows:
Abre Propiedades del sistema → Avanzado → Variables de entorno
En "Variables de usuario", haz clic en "Nueva"
Nombre de variable: ANTHROPIC_API_KEY
Valor de variable: your-api-key-here
Haz clic en OK y reinicia tu terminal
Eliminar una variable de entorno de clave API
macOS/Linux (temporal):
unset ANTHROPIC_API_KEY
macOS (permanente):
# Eliminar del archivo de configuración
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): Elimina la variable de la configuración de Variables de entorno del sistema.
Problemas comunes a evitar
Configurar variables de entorno en archivos de configuración del shell y olvidarse de ellas.
No reiniciar tu terminal después de cambiar variables de entorno.
Asumir que estás usando tu suscripción cuando una clave API está configurada en tu entorno.
Si tienes alguna pregunta, por favor contacta a nuestro equipo de soporte de productos.