¿No puedes iniciar sesión en Claude Code? Cómo arreglar «Invalid code» y los errores al pegar en Mac y Windows

¿Claude Code no inicia sesión? La causa casi siempre es una de estas cuatro: un código de inicio de sesión que caducó o se copió a medias, una terminal que no pega en el campo del código, un navegador que se abrió en otro equipo o una credencial antigua que se impone a tu sesión. El mensaje más habitual es OAuth error: Invalid code. Please make sure the full code was copied, y la propia documentación de Anthropic dice que significa que el código caducó o se cortó. Si pegar no hace nada, la alternativa documentada es claude auth login, que lee el código desde la entrada estándar en lugar del campo interactivo. Hemos comprobado esta guía con Claude Code v2.1.296, la última versión a 12/10/2026.

Esta página nació para resolver un único fallo: en abril de 2026, Claude Code v2.1.105 rompió el pegado en el campo del código de /login, y v2.1.108 lo arregló al día siguiente. Nos topamos con ese fallo nosotros mismos, y la historia está más abajo. Desde entonces, Anthropic ha publicado decenas de correcciones menores del inicio de sesión, así que los consejos empiezan por lo que falla hoy y el fallo de abril queda como historia. Si eres nuevo en el ecosistema de Claude, nuestra guía sobre Claude Mythos y Project Glasswing es un buen complemento para saber qué está construyendo Anthropic.

Solución más rápida: ejecuta claude update, luego claude auth login, abre el enlace que muestra y pega en la terminal el código completo de la página del navegador, incluido el # y todo lo que va después.

Lo esencial

• «OAuth error: Invalid code» significa que el código caducó o se cortó al copiarlo. Pulsa Intro para reintentar y pega el código nuevo enseguida.
• Si pegar en el campo no hace nada, ejecuta claude auth login. Anthropic lo documenta como la alternativa para cualquier terminal en la que el pegado no llega al campo.
• Por SSH, en WSL2 o en un contenedor, el navegador se abre en otro equipo. Pulsa c para copiar la URL de inicio de sesión y ábrela en tu navegador local.
• Una ANTHROPIC_API_KEY olvidada en tu perfil de shell se impone a tu sesión de Pro o Max en cuanto la has aprobado.
• El fallo de pegado de abril de 2026 estuvo en v2.1.105 a v2.1.107 y se corrigió en v2.1.108. Hoy no vuelvas a v2.1.104: actualiza.

¿Claude Code no inicia sesión? Encuentra tu error

Busca la fila que coincide con lo que ves en pantalla y salta a la solución. Todas las causas y soluciones de esta tabla salen de la documentación oficial de resolución de problemas de Claude Code o del registro de cambios de Claude Code.

Solución 1: actualiza Claude Code a la última versión

Actualizar arregla más fallos de inicio de sesión de Claude Code que cualquier otro paso, porque Anthropic no deja de publicar correcciones. Desde el fallo de abril, el registro de cambios de Claude Code recoge arreglos para la URL de inicio de sesión que se abría cortada en Windows Terminal al partirse en varias líneas (v2.1.191), para la URL que perdía caracteres al copiarla en pantalla completa (v2.1.234), para el atajo c por SSH (v2.1.243) y para /login, que en el Mac indicaba éxito aunque el llavero hubiera rechazado el nuevo inicio de sesión (v2.1.290).

Si usaste el instalador nativo, ejecuta:

claude update

Si instalaste con npm, Anthropic indica actualizar así y evitar npm update -g, que puede no llevarte a la última versión:

npm install -g @anthropic-ai/claude-code@latest

Para reinstalar desde cero, el instalador nativo es curl -fsSL https://claude.ai/install.sh | bash en macOS y Linux, y este en Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Después de actualizar, reinicia la terminal, comprueba la versión con claude --version, ejecuta /logout si una sesión se ha quedado atascada y luego claude para iniciar sesión de nuevo. Las instalaciones con Homebrew y WinGet no se actualizan solas, así que usa brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode.

Si alguna versión nueva vuelve a romper el inicio de sesión, cámbiate al canal stable. Anthropic lo describe como una versión de hace aproximadamente una semana que se salta las versiones con regresiones graves, justo el tipo de fallo que fue el de abril.

Solución 2: pega el código en claude auth login

claude auth login es la alternativa oficial cuando pegar en el campo interactivo de inicio de sesión no hace nada. Lee el código pegado desde la entrada estándar, así que no depende de cómo tu terminal entrega el pegado al campo de Claude Code. Según Anthropic, sirve en WSL2, SSH, contenedores, Windows nativo y «cualquier terminal en la que falle pegar en el campo interactivo».

claude auth login

Abre la URL que muestra, inicia sesión, copia el código de la página del navegador, pégalo en la terminal y pulsa Intro. Antes de cambiar de comando, prueba el atajo de pegado alternativo de tu terminal: en Windows Terminal suele ser clic derecho o Mayús+Insert. Para comprobar que la sesión quedó iniciada, ejecuta claude auth status --text.

Ten en cuenta que claude login a secas no es un comando de Claude Code. Los comandos son /login dentro de una sesión y claude auth login desde tu shell.

Cómo arreglar «OAuth error: Invalid code»

«OAuth error: Invalid code. Please make sure the full code was copied» significa que el código caducó o se cortó al copiarlo y pegarlo. Es la explicación de la propia Anthropic. Repasa estos puntos en orden:

1. Empieza de nuevo y date prisa. Pulsa Intro para reintentar, termina de iniciar sesión en cuanto se abra el navegador y pega el código nuevo enseguida. Los códigos duran poco, así que uno de un intento anterior puede haber caducado ya.
2. Copia el código entero, incluido el #. Un usuario que analizó el error en GitHub (issue #91157) descubrió que el código tiene dos partes unidas por un # y que Claude Code rechaza cualquier pegado sin el # y texto a ambos lados. Al hacer doble clic, la selección se detiene en el #, así que arrastra sobre toda la línea.
3. Abre la URL en el equipo correcto. En una sesión SSH, el navegador puede abrirse en el equipo remoto. Copia la URL de la terminal y ábrela en tu navegador local.
4. No escribas el código a mano. Es largo, y un solo carácter equivocado o escribir despacio provoca el mismo error.

Si el error vuelve una y otra vez con la última versión, usa claude auth login de la solución 2 para que el código llegue entero. A octubre de 2026, siguen apareciendo en GitHub casos de «Invalid code» en entornos concretos como GitHub Codespaces (issue #91176), así que busca tu entorno en el gestor de incidencias de Claude Code en GitHub antes de dedicarle una hora.

Solución 3: el inicio de sesión falla por SSH, en WSL2 o en un contenedor

Por SSH, en WSL2 o dentro de un contenedor, el navegador suele abrirse en otro equipo, así que su redirección no llega al callback local de Claude Code. Después de iniciar sesión, el navegador muestra un código en lugar de devolverte automáticamente. Pega ese código en la terminal, en el campo Paste code here if prompted.

Si no se abre ningún navegador: pulsa c en el campo de inicio de sesión para copiar la URL de OAuth completa y pégala tú en un navegador. También funciona cuando la URL se parte en varias líneas en una terminal estrecha y no se puede pulsar. Desde v2.1.243, pulsar c por SSH te dice cómo se copió la URL en lugar de anunciar siempre que todo salió bien.

Si WSL2 no encuentra tu navegador: apunta la variable BROWSER a tu navegador de Windows antes de iniciar Claude Code.

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Si la terminal se queda en «Waiting for authentication…»: el callback de localhost está bloqueado, algo que según el centro de ayuda de Anthropic es habitual por SSH, en devcontainers y detrás de cortafuegos estrictos. Copia la URL, termina de iniciar sesión en cualquier navegador y pega en la terminal el código que te devuelve.

Solución 4: sáltate OAuth con una clave de API o un token de larga duración

Una clave de API de Anthropic Console permite a Claude Code saltarse por completo el inicio de sesión en el navegador. Crea una clave en Claude Console y expórtala antes de ejecutar Claude Code:

export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude

En Windows PowerShell:

$env:ANTHROPIC_API_KEY = "sk-ant-your-key-here"
claude

Claude Code te pide una vez que apruebes la clave y después la usa. El uso de la clave de API se factura por token a través de tu cuenta de Console, aparte de cualquier suscripción Pro o Max, y si te estás planteando si seguir con Claude, nuestra selección de las mejores alternativas a Claude Cowork sirve para contrastar rápido.

La trampa de la clave de API olvidada

Una ANTHROPIC_API_KEY aprobada tiene prioridad sobre tu sesión de Pro o Max. Si una clave antigua de otro trabajo o proyecto sigue en ~/.zshrc, ~/.bashrc o ~/.profile, Claude Code puede fallar con This organization has been disabled aunque tu suscripción esté activa. Ejecuta unset ANTHROPIC_API_KEY (o Remove-Item Env:ANTHROPIC_API_KEY en PowerShell), borra la línea de tu perfil y ejecuta /status dentro de Claude Code para confirmar qué inicio de sesión está activo.

Para pipelines de CI y servidores sin navegador, claude setup-token genera un token de OAuth válido durante un año y ligado a tu suscripción de Claude. Defínelo como CLAUDE_CODE_OAUTH_TOKEN. Quita esa variable de tu perfil cuando ya no la necesites, porque Claude Code la vuelve a leer en cada sesión nueva.

Solución 5: restablece tu inicio de sesión de forma segura

Volver a autenticarte desde cero arregla la mayoría de los fallos de inicio de sesión sin causa clara. El restablecimiento de Anthropic tiene tres pasos: ejecutar /logout, cerrar Claude Code y volver a abrirlo con claude para iniciar sesión. Si claude ni siquiera arranca, ejecuta esto desde tu shell para obtener un informe de diagnóstico:

claude doctor

No borres ~/.claude/ para «restablecer» el inicio de sesión. Esa carpeta guarda tu configuración, tu memoria y tu historial de sesiones, y en el Mac tu inicio de sesión normalmente ni siquiera está ahí: Claude Code lo guarda en el llavero de inicio de sesión.

Cuando el problema es el llavero del Mac

Si el llavero está bloqueado, algo habitual en una sesión SSH, o su contraseña no coincide con la de tu cuenta, Claude Code recurre a un archivo de texto sin cifrar, ~/.claude/.credentials.json. claude doctor muestra entonces un aviso que empieza por macOS Keychain is not writable. Desbloquea el llavero:

security unlock-keychain ~/Library/Keychains/login.keychain-db

Si el aviso sigue, abre Acceso a Llaveros, selecciona el llavero login y sincroniza su contraseña con Edit > Change Password for Keychain “login” (en un Mac en español el menú aparece traducido). Después ejecuta /logout y /login para devolver tu inicio de sesión al llavero cifrado. Cerrar sesión también elimina los inicios de sesión guardados de los servidores MCP, así que tendrás que volver a autorizarlos.

El fallo de pegado de abril de 2026

Entre el 13 y el 14 de abril de 2026, Claude Code descartó sin avisar cualquier código pegado en el campo de /login, mientras seguía aceptando lo que se escribía. v2.1.105 se publicó en npm el 13 de abril a las 19:51 UTC, y v2.1.108 llegó al día siguiente a las 18:35 UTC con esta línea en el registro de cambios: «Fixed paste not working in the /login code prompt (regression in 2.1.105)». Los informes de GitHub culpaban a las secuencias de pegado entre corchetes (bracketed paste) de la terminal, que envuelven cada pegado y que el campo se tragaba.

No era un problema del portapapeles, de la VPN ni de la cuenta, y reiniciar la terminal no servía de nada. Otra rareza del portapapeles afecta a quien quiere pasarle a Claude Code una captura de pantalla en lugar de un código, y de eso se ocupa nuestra guía sobre cómo pegar imágenes en Claude Code.

Cómo nos topamos con el fallo (y qué funcionó de verdad)

Nos encontramos con el fallo la primera vez que instalamos Claude Code en un equipo recién configurado. Ctrl+V en Windows Terminal no hacía nada. Mayús+Insert y pegar con clic derecho tampoco. Cmd+V en el Mac se comportaba igual. El campo seguía parpadeando como si el portapapeles estuviera vacío.

Le preguntamos al propio Claude qué pasaba y nos dio los sospechosos habituales: reiniciar la terminal, revisar el portapapeles, probar otro shell. Nada funcionó. Escribiendo el código a mano, Claude Code lo aceptó, pero Anthropic respondió con un error 401, porque un código largo tecleado carácter a carácter es fácil de escribir mal o de dejar caducar.

Miramos status.anthropic.com para descartar una caída. Todo estaba en verde. En el gestor de incidencias de Claude Code en GitHub encontramos varios informes abiertos con pocas horas de diferencia (#47669, #47745, #47799, #47887), todos con el mismo fallo a partir de v2.1.105, y en r/ClaudeAI había gente chocando contra el mismo muro.

Lo que nos funcionó ese día fue volver a v2.1.104, la última versión antes del fallo. El inicio de sesión salió al primer intento. Anthropic publicó la corrección de verdad en v2.1.108 al día siguiente.

¿Todavía conviene volver a una versión anterior?

No. v2.1.104 tiene seis meses y no incluye ninguna de las correcciones de la solución 1, así que volver a ella hoy cambia un fallo por varios. Si de verdad necesitas fijar una versión, el instalador nativo acepta un número de versión, como curl -fsSL https://claude.ai/install.sh | bash -s 2.1.104, pero el canal stable de la solución 1 es la forma más segura de evitar una regresión nueva.

Si Claude Code te sigue dando guerra y solo necesitas preguntarle algo a Claude mientras la terminal está bloqueada, Fello AI reúne Claude, GPT y Gemini en una sola ventana de chat en tu Mac, y tu trabajo no espera a un campo de inicio de sesión. Para comparar opciones antes de invertir más tiempo, la comparativa Muse Spark vs ChatGPT vs Claude vs Gemini muestra dónde gana cada modelo, y el análisis Grok vs ChatGPT es una buena referencia si te estás replanteando tu asistente de programación por defecto.

Conclusión

En 2026, los problemas de inicio de sesión de Claude Code se reducen a una lista corta. «OAuth error: Invalid code» significa que el código caducó o no se copió entero: reintenta y pega el código completo, con el # incluido. Si pegar no hace nada, la solución es claude auth login. Las sesiones remotas y de WSL2 necesitan abrir la URL en tu propio equipo, y una clave de API olvidada o un llavero del Mac bloqueado explican el resto. Actualiza primero, porque la mayoría de estos fallos tienen arreglo en una versión más reciente. Cuando vuelvas a entrar, nuestra guía de instrucciones de sistema para IA te ayudará a sacar mejores resultados desde el primer prompt.

Preguntas frecuentes