Claude Code: "claude" no se encuentra en Windows

En resumen: en Windows, el instalador de Claude Code pone claude.exe en %USERPROFILE%\.local\bin pero no siempre añade esa carpeta a tu PATH — así que al escribir claude obtienes “‘claude’ no se reconoce…” y no puedes iniciar sesión ni conectarlo. Resuélvelo de una de estas dos formas: ejecútalo una vez desde su carpeta para iniciar sesión ahora, y luego añade esa carpeta al PATH para que funcione en todas partes.

Nota

Esto trata sobre el propio comando claude que no se ejecuta en Windows — el paso anterior a conectarlo con Thunderbird. Si en cambio claude funciona en tu terminal pero atbridge no lo encuentra al conectarlo, consulta Cuando atbridge no encuentra tu CLI de IA.

Por qué ocurre

Los programas de Windows solo se pueden ejecutar por su nombre si su carpeta está en tu PATH. El instalador de Claude Code se completa correctamente y deja claude.exe en %USERPROFILE%\.local\bin, pero no siempre pone esa carpeta en tu PATH de usuario — así que una terminal recién abierta no sabe dónde está claude. Es un paso común y esperado, no una instalación defectuosa. (Anthropic lo documenta como el caso de “command not found” tras la instalación).

¿Lo instalaste con npm?

Si instalaste Claude Code con npm install -g @anthropic-ai/claude-code, el comando se encuentra en tu carpeta de prefijo de npm en lugar de .local\bin. Localízala con npm config get prefix y usa esa ruta en lugar de %USERPROFILE%\.local\bin en todo lo que sigue.

Cómo resolverlo

1. Ejecútalo una vez desde su carpeta — para iniciar sesión ahora mismo. Abre PowerShell y ejecuta:

   cd $env:USERPROFILE\.local\bin
   .\claude

   Eso inicia Claude Code aunque todavía no esté en el PATH, así que puedes iniciar sesión con tu cuenta. (¿Prefieres arreglar el PATH primero? Haz el paso 2, abre una terminal nueva y luego simplemente ejecuta claude.)

2. Añade la carpeta a tu PATH — para que claude funcione en todas partes.

   PowerShell

   $p = [Environment]::GetEnvironmentVariable('PATH', 'User')
   [Environment]::SetEnvironmentVariable('PATH', "$p;$env:USERPROFILE\.local\bin", 'User')

   Esto actualiza tu PATH de usuario de forma permanente. Luego cierra y vuelve a abrir tu terminal para que reconozca el cambio.

   Ajustes (interfaz gráfica)

   Pulsa Inicio, escribe “variables de entorno” y abre Editar las variables de entorno del sistema → Variables de entorno…. En Variables de usuario, selecciona Path → Editar → Nuevo y añade:

   %USERPROFILE%\.local\bin

   Haz clic en Aceptar en cada cuadro de diálogo y luego cierra y vuelve a abrir tu terminal.

3. Verifica. Abre una terminal nueva y ejecuta:

   claude --version

   Una cadena de versión significa que Windows ya encuentra claude. claude doctor muestra una comprobación de estado de solo lectura si quieres confirmar la instalación.

Precaución

Los cambios en el PATH solo se aplican a las terminales recién abiertas — la ventana donde lo editaste no verá el cambio. Abre una nueva ventana de PowerShell o del Símbolo del sistema antes de probar.

Luego conéctalo en Thunderbird

Una vez que claude se ejecute en una terminal y hayas iniciado sesión al menos una vez, conéctalo como la IA que hay detrás del Chat de IA de atbridge — elige Claude Code CLI en Ajustes → proveedores de IA de atbridge. Pasos completos: Conectar una suscripción de CLI.

Si aun así atbridge no lo detecta, es la detección del lado de atbridge — un solo comando lo resuelve: Cuando atbridge no encuentra tu CLI de IA.

A dónde ir después

• Conectar una suscripción de CLI
• Cuando atbridge no encuentra tu CLI de IA
• Windows bloquea atbridge (SmartScreen)

Más rápido: pregunta a la comunidad

Para preguntas del tipo «¿cómo puedo…?» normalmente obtendrás una respuesta más rápida —y ayudarás a la siguiente persona con la misma duda— en Discord. Cualquier cosa relacionada con tu cuenta, la facturación o un error es mejor como ticket de soporte, donde respondemos por correo.