Source: https://aiprimetech.io/es/claude-code/errors/auth-401-403/ [Inicio](/es/) › [Claude Code](/es/claude-code/) › [Errores](/es/claude-code/errors/) › Autenticación 401 / 403 [Descripción general](/es/claude-code/)[Instalación](/es/claude-code/install/)[referencia de la CLI](/es/claude-code/cli/)[Precios y límites](/es/claude-code/pricing/)[Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins](/es/claude-code/skills/)[GitHub](/es/claude-code/github/)[Web, escritorio e IDE](/es/claude-code/web-and-desktop/)[Modelos](/es/claude-code/models/)[Errores](/es/claude-code/errors/)[¿Código abierto?](/es/claude-code/open-source/)[Tutorial](/es/claude-code/tutorial/)[Para estudiantes](/es/claude-code/for-students/)[Automatización de QA](/es/claude-code/qa-automation/)[Comparación con Cursor](/es/claude-code/vs-cursor/)[Comparación con Codex y OpenCode](/es/claude-code/vs-codex/)[Subagentes](/es/claude-code/subagents/)[Hooks](/es/claude-code/hooks/)[MCP](/es/claude-code/mcp/)[Ecosistema](/es/claude-code/ecosystem/)[VS Code](/es/claude-code/vscode/)[OpenRouter](/es/claude-code/openrouter/)[Límites de solicitudes](/es/claude-code/rate-limits/)[Guía en chino](/claude-code/zh/) Última actualización: 11 de octubre de 2026 # Claude Code 401 y 403: credenciales de autenticación no válidas, clave API no válida, «No has iniciado sesión», host_not_allowed 401 significa que no se aceptó la credencial enviada por Claude Code; 403 significa que se aceptó, pero la solicitud no estaba permitida. Casi todos los informes de 401 del registro de incidencias se reducen a *qué* credencial se envió, porque Claude Code puede tener tres a la vez: un inicio de sesión OAuth, un ANTHROPIC_API_KEY en el entorno y un apiKeyHelper en la configuración. Empieza por averiguar cuál está activo. ## TLDR - /status muestra el método de autenticación y el endpoint activos. Una clave de API en el entorno siempre tiene prioridad sobre /login. - invalid x-api-key / Invalid API key · Fix external API key — la clave no pertenece al endpoint de ANTHROPIC_BASE_URL. - 401 Invalid authentication credentials después de /login — el token OAuth se revocó o se renovó incorrectamente; cierra la sesión, elimina la credencial almacenada y vuelve a iniciar sesión. - 403 — un proxy, una regla de salida del entorno aislado o la pertenencia a una organización bloquearon la solicitud; la credencial es válida. ## 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.json ``` El 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 host ``` ## 401 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](https://github.com/anthropics/claude-code/issues/69706), abierto, Windows, suscripción Pro activa; [#44265](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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.json en Linux y Windows; el elemento *Claude Code-credentials* del Llavero en macOS), después /login en 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](/es/claude-code/errors/oauth-error/) aborda *No se pudo renovar el token OAuth: otro proceso de Claude Code lo está renovando*. - claude update: [#54235](https://github.com/anthropics/claude-code/issues/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-token en 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_KEY establecido, 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](https://github.com/anthropics/claude-code/issues/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 push a una rama existente ([#57356](https://github.com/anthropics/claude-code/issues/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-control antes provocaba que todas las sesiones fallaran por este motivo ([#53563](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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 claude ``` Una 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_key ``` [Crea una cuenta con el código FIXIT](/register?promo=FIXIT) ## Preguntas 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](/register?promo=FIXIT) [Ver planes ilimitados](/es/plans/) AI 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. ## Más guías de Claude Code [Errores de Claude Code y cómo solucionarlos](/es/claude-code/errors/)[Claude Code «Error de la API: 500»: qué significa y qué lo soluciona realmente](/es/claude-code/errors/api-error-500/)[Error «Sobrecargado» de Claude (error de la API 529): qué significa y qué hacer](/es/claude-code/errors/overloaded-529/)[Error de la API de Claude Code 400: prompt demasiado largo, concurrencia en el uso de herramientas y los demás](/es/claude-code/errors/api-error-400/)[Errores OAuth de Claude Code: se ha superado el tiempo de espera de 15000ms y código de estado 500](/es/claude-code/errors/oauth-error/)[«El proceso de Claude Code terminó con el código 1»: cómo encontrar el error real y solucionarlo](/es/claude-code/errors/process-exited-code-1/)[Claude «El prompt es demasiado largo», «La entrada es demasiado larga para el modelo solicitado» y «Se ha alcanzado el límite de contexto»: qué llena la ventana y cómo recuperar espacio](/es/claude-code/errors/prompt-too-long/)[Se ha alcanzado el límite de uso de Claude: límites de sesión, semanales y de Opus, «límites de uso de la API especificados», «el saldo de créditos es demasiado bajo» y qué hacer](/es/claude-code/errors/usage-limit-reached/)[Errores de conexión de Claude Code: ECONNRESET, conexión perdida durante la respuesta, «Esperando respuesta de la API», «No se puede conectar con la API», errores de certificados SSL](/es/claude-code/errors/connection-lost/)[Claude Code se bloquea, se queda atascado o deja de responder: cómo averiguar dónde se ha atascado y salir del bloqueo](/es/claude-code/errors/claude-code-hangs/)[Claude.ai no funciona: «Algo ha salido mal», restricciones de capacidad, «Se ha alcanzado el límite de 5 horas», «Error al iniciar sesión» y los demás](/es/claude-code/errors/claude-ai-not-working/)