Los mensajes
API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid authentication credentials"}}
API Error: 401 invalid x-api-key
Invalid API key · Fix external API key
Not logged in · Please run /login
Login expired · Please run /login
API Error: 403 x-deny-reason: host_not_allowed
Error: Poll: Access denied (403): Account is no longer a member of the organization associated with this token.Paso 1: ¿qué credencial se está enviando?
claude
/status # auth method, endpoint, model
echo $ANTHROPIC_API_KEY | cut -c1-12
echo $ANTHROPIC_BASE_URL
grep -n apiKeyHelper ~/.claude/settings.jsonEl orden de prioridad es sencillo una vez que lo conoces: un ANTHROPIC_API_KEY en el entorno (o el valor devuelto por apiKeyHelper) se usa en lugar del inicio de sesión OAuth. Una clave obsoleta exportada en .bashrc hace meses, o una clave de otra pasarela, es la causa clásica de un 401 que persiste después de cada /login. Elimina la variable o establece la clave correcta.
401 con una clave de API: la clave y el endpoint no coinciden
invalid x-api-key y Invalid API key · Fix external API key significan que el endpoint no reconoció la clave. Una clave pertenece exactamente a un endpoint: una clave de la consola de Anthropic solo funciona con api.anthropic.com; una clave de pasarela solo funciona con el ANTHROPIC_BASE_URLde esa pasarela. Enviar una clave de consola a https://aiprimetech.io o una clave de pasarela a Anthropic devuelve 401 en ambos casos. Comprueba también que no se haya pegado un salto de línea o una comilla al final de la variable, y que la clave no se haya revocado o rotado en el panel.
curl -s https://aiprimetech.io/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" | head -c 300
# a JSON list = key accepted; authentication_error = wrong key for this host401 después de /login: el token OAuth
API Error: 401 Invalid authentication credentials justo después de iniciar sesión correctamente en el navegador es el caso más notificado (#69706, abierto, Windows, suscripción Pro activa; #44265, el token aparece como caducado inmediatamente después de iniciar sesión).
Una persona que comentó en el primer hilo descubrió que el refreshToken almacenado era una cadena vacía en ~/.claude/.credentials.json, lo que hace que cada solicitud devuelva 401 hasta que un nuevo inicio de sesión sustituya el archivo. #54443 documenta que el servidor rechaza sesiones antes de la fecha de caducidad almacenada localmente y que la llamada de renovación devuelve 400, por lo que Please run /login reaparece cada pocas horas; ejecutar varias instancias de Claude Code con una misma cuenta lo empeora, porque compiten por renovar el mismo token. #44585: /login muestra *Inicio de sesión correcto* y vuelve inmediatamente a *No has iniciado sesión*.
/logout, luego elimina la credencial almacenada (~/.claude/.credentials.jsonen Linux y Windows; el elemento *Claude Code-credentials* del Llavero en macOS), después/loginen un navegador sin la extensión Claude in Chrome.- Cierra las otras ventanas de Claude Code, la aplicación de escritorio y las extensiones del IDE antes de iniciar sesión; renuevan el mismo token. La página sobre errores de OAuth aborda *No se pudo renovar el token OAuth: otro proceso de Claude Code lo está renovando*.
claude update: #54235 vinculó un 401 a una versión específica y a una variable de entorno que activaba una función beta; las regresiones de autenticación se corrigen rápidamente.- Equipo sin interfaz gráfica o conectado por SSH:
claude setup-tokenen un equipo donde funcione el inicio de sesión en el navegador y luego usa el token allí. - Poder trabajar ahora es mejor que depurar: con
ANTHROPIC_API_KEYestablecido, Claude Code nunca utiliza OAuth.
403: se permite autenticarte, pero no hacer eso
- `x-deny-reason: host_not_allowed` — un proxy que intercepta la solicitud rechaza el destino. Se ha observado con la lista de destinos de salida permitidos del entorno aislado web o de escritorio (#93562, abierto: los hosts que no están en una lista integrada reciben 403 en CONNECT incluso con *Todos los dominios* seleccionado) y con proxies corporativos. Añade el host a la lista de permitidos o ejecuta la CLI fuera del entorno aislado.
- 403 del proxy de git del entorno aislado en
git pusha una rama existente (#57356) — se debe a la política del proxy de git del entorno aislado, no a GitHub. Haz el push desde un terminal normal. - `Account is no longer a member of the organization associated with this token` — el token se emitió para una organización que abandonaste o que cambió;
claude remote-controlantes provocaba que todas las sesiones fallaran por este motivo (#53563). Cierra la sesión y vuelve a iniciarla para generar un token para la organización actual. - 403 de una pasarela — la clave es válida, pero la cuenta está deshabilitada, no tiene saldo para ese modelo o el modelo no está incluido en tu plan; el cuerpo de la respuesta indica cuál es el motivo. Revisa el panel antes de cambiar nada en el cliente.
- `/feedback` devuelve 403 (#55348) — una interrupción del servicio de ese endpoint concreto; no afecta al modelo.
La alternativa de la clave de API
unset ANTHROPIC_API_KEY ANTHROPIC_BASE_URL # back to the subscription login
# or: bypass OAuth entirely
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claudeUna clave de pasarela es una clave de API convencional: sin OAuth, sin renovación de tokens, sin pertenencia a una organización, y la familia de errores 401 se reduce a *si la clave corresponde al host*. Si estás atrapado en un /login bucle y necesitas entregar hoy, esa es la salida más rápida; tu primera recarga con criptomonedas se duplica (+50%).
¿Te has cansado de lidiar con este error?
Ejecuta Claude Code a través del gateway de AI Prime Tech: los mismos modelos Claude en las cuentas de origen propias del gateway, dos variables de entorno para cambiar, y las cuentas nuevas reciben $5 de crédito gratuito para la API con el código FIXIT — sin tarjeta.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyPreguntas frecuentes
¿Cómo soluciono «API Error: 401 Credenciales de autenticación no válidas» en Claude Code?
Consulta /status para ver la credencial activa. Elimina una ANTHROPIC_API_KEY obsoleta, o ejecuta /logout, elimina ~/.claude/.credentials.json (el llavero en macOS) y vuelve a ejecutar /login con las demás instancias de Claude Code cerradas. Como alternativa, una clave API evita OAuth por completo.
¿Por qué Claude Code indica que la clave API no es válida?
La clave no corresponde al endpoint de ANTHROPIC_BASE_URL. Una clave de la consola requiere api.anthropic.com; una clave de una pasarela requiere la URL de esa pasarela. Comprueba también si has pegado espacios en blanco y si la clave se ha revocado.
¿Por qué Claude Code sigue pidiéndome que ejecute /login?
El token de OAuth se rechaza antes de su vencimiento local o falla su renovación, a menudo porque varios procesos de Claude Code comparten un mismo token. Cierra los demás, cierra sesión, borra la credencial almacenada, vuelve a iniciar sesión y actualiza la CLI.
¿Qué significa 403 x-deny-reason: host_not_allowed?
Un proxy (la lista de destinos de salida permitidos del entorno aislado o un proxy corporativo) ha rechazado el host de destino. Tus credenciales son correctas; permite el host o ejecuta fuera del entorno aislado.
Ejecuta Claude Code con la pasarela
Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código FIXIT.
Obtener una clave de API Ver planes ilimitadosAI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.