[BUG]

Preflight Checklist

• [x] I have searched existing issues and this hasn't been reported yet
• [x] This is a single bug report (please file separate reports for different bugs)
• [x] I am using the latest version of Claude Code

What's Wrong?

Documentación de instalación en Windows no menciona configuración del PATH

Descripción del problema

Al instalar Claude Code en Windows siguiendo la documentación oficial mediante el comando:

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

El comando claude no es reconocido por PowerShell después de la instalación:

claude: The term 'claude' is not recognized as a name of a cmdlet, function, script file, or executable program.

Causa

Windows no agrega automáticamente la carpeta de paquetes globales de npm al PATH del sistema. El ejecutable se instala correctamente en C:\Users\<usuario>\AppData\Roaming\npm, pero como esa ruta no está en el PATH, PowerShell no puede encontrarlo.

Solución aplicada

Agregar manualmente la ruta al PATH:

[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;C:\Users\<usuario>\AppData\Roaming\npm", [EnvironmentVariableTarget]::User)
$env:PATH = "$env:PATH;C:\Users\<usuario>\AppData\Roaming\npm"

Sugerencia

Agregar en la documentación de instalación para Windows una advertencia indicando que es necesario verificar y configurar el PATH de npm manualmente, o bien destacar el instalador nativo como opción preferida:

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

Entorno

• OS: Windows
• Shell: PowerShell
• Node.js: instalado vía instalador oficial
• Método de instalación: npm install -g @anthropic-ai/claude-code

What Should Happen?

Documentación de instalación en Windows no menciona configuración del PATH

Descripción del problema

Al instalar Claude Code en Windows siguiendo la documentación oficial mediante el comando:

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

El comando claude no es reconocido por PowerShell después de la instalación:

claude: The term 'claude' is not recognized as a name of a cmdlet, function, script file, or executable program.

Causa

Windows no agrega automáticamente la carpeta de paquetes globales de npm al PATH del sistema. El ejecutable se instala correctamente en C:\Users\<usuario>\AppData\Roaming\npm, pero como esa ruta no está en el PATH, PowerShell no puede encontrarlo.

Solución aplicada

Agregar manualmente la ruta al PATH:

[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;C:\Users\<usuario>\AppData\Roaming\npm", [EnvironmentVariableTarget]::User)
$env:PATH = "$env:PATH;C:\Users\<usuario>\AppData\Roaming\npm"

Sugerencia

Agregar en la documentación de instalación para Windows una advertencia indicando que es necesario verificar y configurar el PATH de npm manualmente, o bien destacar el instalador nativo como opción preferida:

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

Entorno

• OS: Windows
• Shell: PowerShell
• Node.js: instalado vía instalador oficial
• Método de instalación: npm install -g @anthropic-ai/claude-code

Error Messages/Logs

## Documentación de instalación en Windows no menciona configuración del PATH

**Descripción del problema**

Al instalar Claude Code en Windows siguiendo la documentación oficial mediante el comando:


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


El comando `claude` no es reconocido por PowerShell después de la instalación:


claude: The term 'claude' is not recognized as a name of a cmdlet, function, script file, or executable program.


**Causa**

Windows no agrega automáticamente la carpeta de paquetes globales de npm al PATH del sistema. El ejecutable se instala correctamente en `C:\Users\<usuario>\AppData\Roaming\npm`, pero como esa ruta no está en el PATH, PowerShell no puede encontrarlo.

**Solución aplicada**

Agregar manualmente la ruta al PATH:


[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;C:\Users\<usuario>\AppData\Roaming\npm", [EnvironmentVariableTarget]::User)
$env:PATH = "$env:PATH;C:\Users\<usuario>\AppData\Roaming\npm"


**Sugerencia**

Agregar en la documentación de instalación para Windows una advertencia indicando que es necesario verificar y configurar el PATH de npm manualmente, o bien destacar el instalador nativo como opción preferida:


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


**Entorno**
- OS: Windows
- Shell: PowerShell
- Node.js: instalado vía instalador oficial
- Método de instalación: `npm install -g @anthropic-ai/claude-code`

Steps to Reproduce

Documentación de instalación en Windows no menciona configuración del PATH

Descripción del problema

Al instalar Claude Code en Windows siguiendo la documentación oficial mediante el comando:

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

El comando claude no es reconocido por PowerShell después de la instalación:

claude: The term 'claude' is not recognized as a name of a cmdlet, function, script file, or executable program.

Causa

Windows no agrega automáticamente la carpeta de paquetes globales de npm al PATH del sistema. El ejecutable se instala correctamente en C:\Users\<usuario>\AppData\Roaming\npm, pero como esa ruta no está en el PATH, PowerShell no puede encontrarlo.

Solución aplicada

Agregar manualmente la ruta al PATH:

[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;C:\Users\<usuario>\AppData\Roaming\npm", [EnvironmentVariableTarget]::User)
$env:PATH = "$env:PATH;C:\Users\<usuario>\AppData\Roaming\npm"

Sugerencia

Agregar en la documentación de instalación para Windows una advertencia indicando que es necesario verificar y configurar el PATH de npm manualmente, o bien destacar el instalador nativo como opción preferida:

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

Entorno

• OS: Windows
• Shell: PowerShell
• Node.js: instalado vía instalador oficial
• Método de instalación: npm install -g @anthropic-ai/claude-code

Claude Model

Not sure / Multiple models

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.1.68

Platform

Anthropic API

Operating System

Windows

Terminal/Shell

PowerShell

Additional Information

_No response_