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 la cuenta que pretendías.
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á a través de 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 de claude.ai o una cuenta de Console diferente.
Mejores prácticas
Para usar Claude Code con tu suscripción de Claude: Mantén la variable de entorno ANTHROPIC_API_KEY sin establecer.
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, establécela 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 iniciar sesión exitosamente, verás una notificación si ambas credenciales están activas, alertándote sobre la posibilidad de cargos inesperados en la API.
Verificar tu configuración actual
Para verificar si una clave API está establecida como variable de entorno, ejecuta /status en Claude Code. Esto te mostrará qué método de autenticación está actualmente activo.
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
Establecer 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"
Establecer 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
Establecer 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.