Could not resolve authentication method en Claude Code: qué significa y cómo solucionarlo

Could not resolve authentication method significa que una sesión de Claude Code llegó al cliente de la API sin ninguna credencial: ni clave de API, ni token, ni inicio de sesión. Aparece en pantalla en las sesiones en segundo plano y en las sesiones en la nube. Actualiza Claude Code a la 2.1.176 o posterior y comprueba que ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN o las credenciales de tu proveedor cloud están definidas en el entorno que arranca el worker. En una sesión normal de terminal el mismo problema se muestra como Not logged in · Please run /login. Lo comprobamos en Claude Code 2.1.318 el 5 de noviembre de 2026, siguiendo la referencia oficial de errores.

El mensaje completo:

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

Qué significa could not resolve authentication method

El texto sale del cliente de la API de Anthropic que lleva Claude Code. Enumera los tipos de credencial que acepta (apiKey, authToken, credentials, config, profile) y dice que no hay ninguno. Dónde lo ves depende de cómo se ejecuta Claude Code:

• Sesiones en segundo plano y sesiones en la nube: muestran el mensaje cuando el proceso worker arranca sin credencial.
• Sesiones interactivas, claude -p y Agent SDK: muestran Not logged in · Please run /login y escriben este texto solo en el log de depuración. Si lo encontraste ahí, sigue los pasos de Not logged in.

Nuestra prueba en Claude Code 2.1.318

Ejecutamos un Claude Code 2.1.318 aislado, con un directorio home vacío, sin credenciales en el entorno y una API simulada local:

$ claude -p "say ok" --debug-file debug.log     # no credential configured
Not logged in · Please run /login

$ grep "Could not resolve" debug.log
[ERROR] API error (attempt 1/11): Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
[ERROR] Error in API request: Could not resolve authentication method. ...

La terminal solo dijo Not logged in; el log de depuración tenía la línea completa de Could not resolve authentication method. La API simulada no recibió ninguna petición: el fallo ocurre dentro de Claude Code antes de salir a la red. Cambiar el proxy o el gateway no arregla este error.

Cómo solucionar could not resolve authentication method

1. Actualiza. Antes de la v2.1.174, una sesión en segundo plano asignada a un worker preiniciado e inactivo podía fallar así aunque las credenciales fueran válidas. Antes de la v2.1.176 pasaba lo mismo con una sesión en la nube que esperaba inactiva. Revisa la versión y actualiza:
2. Pon la credencial donde el worker pueda leerla. Una clave exportada solo en el perfil de tu shell interactiva puede no llegar al proceso que lanza los workers. Mira qué contiene de verdad el entorno:
3. Elige un tipo de credencial. Para facturación por API usa ANTHROPIC_API_KEY. Para una suscripción Pro, Max, Team o Enterprise en automatizaciones, genera un token de larga duración y define CLAUDE_CODE_OAUTH_TOKEN:
4. Confirma con /status. Abre una sesión interactiva de claude en el mismo entorno y ejecuta /status para ver qué fuente de credenciales se usa.
5. Con el Agent SDK, sigue la configuración de autenticación del quickstart; el SDK lee las mismas variables de entorno.

claude --version
claude update

env | grep -E 'ANTHROPIC|CLAUDE_CODE_OAUTH'          # macOS / Linux
Get-ChildItem Env:ANTHROPIC*, Env:CLAUDE_CODE_OAUTH*   # PowerShell

claude setup-token
export CLAUDE_CODE_OAUTH_TOKEN="paste-the-token-here"

Los archivos de configuración también guardan credenciales. Nuestra guía de settings.json explica qué archivos lee Claude Code y en qué orden.

Qué credenciales busca Claude Code

Claude Code revisa estas fuentes según su orden de prioridad y usa la primera que encuentra:

1. Credenciales del proveedor cloud, si está definido CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX o CLAUDE_CODE_USE_FOUNDRY
2. ANTHROPIC_AUTH_TOKEN
3. ANTHROPIC_API_KEY
4. la salida de apiKeyHelper (si el helper falla, mira apiKeyHelper script is failing)
5. CLAUDE_CODE_OAUTH_TOKEN
6. un perfil de Anthropic o credenciales federadas
7. el inicio de sesión de la suscripción con /login

El error indica que el worker no encontró ninguna.

Casos relacionados

• Si los trabajos claude -p terminan con Not logged in justo después de que alguien vuelve a iniciar sesión en la misma cuenta de claude.ai, actualiza Claude Code. Antes de la v2.1.318, ese nuevo inicio de sesión borraba el guardado antes de guardar el nuevo.
• Si tienes sesión y la API la rechaza, recibes un 401, que tratamos en la solución al 401 OAuth token has expired.
• El issue #67747 de GitHub pidió documentar este error; la entrada citada arriba es el resultado.

Preguntas frecuentes

¿Could not resolve authentication method es un problema de red?

No se encontró credencial, así que no se envió ninguna petición. En nuestra prueba la API simulada recibió cero peticiones.

¿Lo arregla /login?

En una sesión interactiva, sí: guarda un inicio de sesión que Claude Code puede encontrar. Para workers en segundo plano, sesiones en la nube y CI, define una credencial en el entorno, porque nadie puede iniciar sesión allí.

¿Dónde veo otros errores de Claude Code?

En nuestra guía de errores de Claude Code.

Fuentes: referencia de errores de Claude Code, prioridad de autenticación, issue #67747 de GitHub, changelog de Claude Code (2.1.174, 2.1.176, 2.1.318). Revisado el 5 de noviembre de 2026 con Claude Code 2.1.318.