Claude Code · Solución de problemas
Error 401 de la API de Claude Code: soluciones para clave de API no válida
Un 401 significa que la API recibió tu solicitud pero no pudo autenticarla. La causa casi siempre es la clave en sí o la variable desde la que Claude Code la lee.
Última comprobación
El texto del error
API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"..."}}Solución paso a paso
1. Copia la clave de nuevo
Cópiala de nuevo desde la página de claves de API y revisa que no tenga espacios ni saltos de línea. Asegúrate de que la clave no se haya eliminado.
2. Usa la variable correcta
ANTHROPIC_AUTH_TOKEN contiene la clave de aicodewith; ANTHROPIC_API_KEY permanece vacía.
~/.claude/settings.json{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_API_KEY": "", "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai" } }3. Busca residuos
Ejecuta echo $ANTHROPIC_API_KEY y echo $ANTHROPIC_AUTH_TOKEN en una terminal nueva. Elimina las exportaciones antiguas de ~/.zshrc o ~/.bashrc.
4. Reinicia y comprueba
Cierra todas las sesiones de Claude Code, vuelve a iniciarlo y ejecuta /status.
Otras causas
| Síntoma | Causa | Solución |
|---|---|---|
| 401 justo después de la configuración | Clave pegada en ANTHROPIC_API_KEY | Muévela a ANTHROPIC_AUTH_TOKEN |
| Funcionaba ayer, 401 hoy | Clave eliminada o rotada | Crea una clave nueva y actualiza settings.json |
| 401 solo en una terminal | Esa shell exporta una clave antigua | Elimínala con unset o abre una terminal limpia |
| Te pide /login en su lugar | No se cargó ninguna clave; Claude Code está en el inicio de sesión del plan | Revisa la ruta de settings.json y la sintaxis JSON |
¿Sigue fallando?
- Revisa la página del modelo en aicodewith: muestra el estado reciente de cada canal.
- Busca la solicitud en los registros de uso de tu panel para ver su modelo, estado y coste.
- Envía un correo a support@aicodewith.com con la hora del error, el modelo y el texto del error (nunca tu clave de API completa).
Estado y precios de los modelosContacta con soporteDocumentación
FAQ
¿Qué significa el error 401 de Claude Code?
No se pudo autenticar la solicitud: la clave es incorrecta, se eliminó o se envió mediante la variable incorrecta.
¿Debo usar ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN?
Coloca la clave de aicodewith en ANTHROPIC_AUTH_TOKEN y establece ANTHROPIC_API_KEY como una cadena vacía.
¿Por qué funciona en una terminal pero no en otra?
Probablemente una shell todavía exporta una ANTHROPIC_API_KEY antigua. Ejecuta echo $ANTHROPIC_API_KEY para comprobarlo.
¿Un saldo bajo puede causar un 401?
Los problemas de saldo muestran su propio error de saldo insuficiente. Recarga si el mensaje menciona saldo; de lo contrario, revisa la clave.
¿Es seguro compartir mi clave para soporte?
No. Nunca envíes la clave completa. Comparte la hora del error y el modelo en su lugar.
¿Listo para probarlo?
El cobro es por token desde un saldo prepago. Se aplican límites de velocidad y concurrencia, y puedes establecer topes de gasto diarios, mensuales o totales en cada clave de API.
Relacionado
Fuentes
- Documentación de Claude Code: errores
- Documentación de Claude Code: configuración
- Documentación de la API de Anthropic: errores
Claude y Claude Code son marcas registradas de Anthropic PBC. aicodewith es una plataforma independiente y no está afiliada a Anthropic ni respaldada por Anthropic. Los formatos de error se citan de Claude Code y pueden cambiar. Comprobado 2026-10-10.