Claude Code en Windows funciona de forma nativa, sin instalar Linux dentro y sin ser administrador. Lo que falla casi nunca es Claude Code: es Windows, con sus dos ventanas negras que se parecen, su ruta de programas que no se actualiza y su antivirus de empresa. Aquí está la decisión entre nativo, WSL y app de escritorio, la instalación en PowerShell paso a paso, ocho fallos con su mensaje exacto y qué hacer en un ordenador de empresa.
Claude Code en Windows: nativo, WSL o la app de escritorio
| Opción | Qué necesita | Para quién |
|---|---|---|
| Nativo (PowerShell o CMD) | Windows 10 versión 1809 o posterior, 4 GB de memoria, un plan de Claude de pago. Git para Windows es opcional | Casi todo el mundo, y desde luego quien no programa |
| WSL 2 (Linux dentro de Windows) | Activar WSL 2 y trabajar dentro de la terminal de Linux | Quien ya usa herramientas de Linux o quiere el sandbox de comandos, que en nativo no está |
| App de escritorio de Claude, pestaña Code | Descargarla (hay versión x64 y ARM64) y un plan de pago. Trae Claude Code dentro | Quien no quiere ver una terminal |
La regla: nativo, salvo que alguien de informática te diga WSL. Y no mezcles las dos; elige una. Si además la terminal te echa para atrás, la app de escritorio hace lo mismo con ventana normal, y la misma app tiene Claude Cowork, la versión con botones. Si aún no sabes si te hace falta, antes: qué es Claude Code.
La instalación nativa en PowerShell, paso a paso
- Abre PowerShell. Pulsa Win + X y elige «Windows PowerShell» o «Terminal». No hace falta «como administrador». Comprueba que cada línea empieza por
PS C:\Users\TuNombre>; si no lleva el «PS», estás en CMD, que es la otra ventana. - Pega el comando y pulsa Intro:
irm https://claude.ai/install.ps1 | iex. Verás texto pasando y, al final, «Claude Code successfully installed!». Si estás en CMD, el comando es otro:curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. - Cierra la ventana y abre otra. Sin este paso, el comando
claudeno existe todavía en esa sesión. - Comprueba:
claude --version. Tiene que devolver un número y «(Claude Code)». - Crea una carpeta de prueba con copias, con nombre corto y fuera de la nube:
C:\trabajo\prueba-claude. Entra concd C:\trabajo\prueba-claude. - Arranca:
claude. Se abre el navegador para iniciar sesión con tu cuenta de Claude. Una vez. Después, un primer encargo que no toque nada: «explícame qué hay en esta carpeta».
Es el mismo instalador que en Mac con otra línea, y los pasos comunes están en instalar Claude Code. La alternativa para quien usa el gestor de paquetes de Windows es winget install Anthropic.ClaudeCode, con una pega: no se actualiza sola. Todo esto sale de la documentación de instalación, comprobada hoy.
¿Git para Windows sí o no?
Muchas guías, y nuestra versión anterior de este artículo, decían que Git era obligatorio. La documentación es clara: es opcional. Sin Git, Claude Code ejecuta los comandos con la herramienta de PowerShell, que se activa sola. Con Git instalado, usa su Bash, que entiende mejor los comandos que se escriben en tutoriales y en la documentación, casi todos pensados para Mac y Linux.
La recomendación práctica: instálalo, desde git-scm.com, aceptando todas las opciones por defecto, y no aprendas Git. Es un programa que se instala en dos minutos y que hace que muchas cosas copiadas de internet funcionen a la primera. Si Claude Code no lo encuentra después de instalarlo, la guía de terminal para nuevos usuarios explica cómo indicarle la ruta.
Los ocho fallos de Windows, con su mensaje exacto
Todos con el texto literal que verás en pantalla, para que puedas buscarlo en esta tabla en vez de en inglés.
| Lo que ves | Qué pasa | Arreglo |
|---|---|---|
| «’claude’ is not recognized» | No has abierto una ventana nueva, o el instalador no pudo añadir su carpeta a la ruta de programas | Cierra y abre PowerShell. Si sigue, dos líneas en PowerShell: $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User') y [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User'). Ventana nueva |
| «irm is not recognized» | Estás en CMD, no en PowerShell | Abre PowerShell (Win + X) o usa el comando de CMD |
| «The token ‘&&’ is not a valid statement separator» | Al revés: has pegado el comando de CMD en PowerShell | Usa irm https://claude.ai/install.ps1 | iex |
| «Could not create SSL/TLS secure channel» | Windows 10 antiguo con TLS viejo | Antes del instalador: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 |
| «Claude Code does not support 32-bit Windows» | Has abierto la entrada «Windows PowerShell (x86)» del menú de inicio | Abre la que no lleva «(x86)» |
| «requires either Git for Windows (for bash) or PowerShell» | No encuentra ninguna de las dos; casi siempre, PowerShell fuera de la ruta de programas | Añade C:\Windows\System32\WindowsPowerShell\v1.0\ al PATH, o instala Git para Windows |
| «The process cannot access the file … being used by another process» | Una descarga anterior a medias sigue abierta | Vacía la carpeta de descargas del instalador y repite |
| Error 403 o una página web en vez del instalador | Un proxy que filtra o un país donde no está disponible | Prueba desde otra red; si es el proxy, el apartado de empresa de abajo. WinGet como alternativa |
Y el fallo que ya no es lo que era: «la ejecución de scripts está deshabilitada en este sistema». Esa política de PowerShell bloquea los lanzadores de npm, no el instalador de arriba, que ejecuta texto y no un archivo. Si te sale, es que instalaste con npm; la documentación de errores de instalación tiene el arreglo, y también la instalación nativa que lo evita.
¿Te avisamos del próximo artículo?
Publicamos uno nuevo cada día, de lunes a sábado. Te mandamos el título, dos líneas y el enlace: en cuanto sale o en un resumen los lunes. Te das de baja con un clic.
Lo que pasa después de instalar (y no viene en ningún vídeo)
Usa Terminal de Windows, no la ventana clásica. Viene con Windows 11 y se instala gratis en Windows 10. En ella, Shift+Intro añade una línea sin enviar el mensaje sin configurar nada; en otras ventanas hace falta Ctrl+J. Y las tildes y las eñes se ven bien.
Si Retroceso borra una palabra entera en vez de una letra, es la terminal enviando un código antiguo. Se arregla con la variable CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0, según la documentación de configuración de terminal.
Los acentos en los archivos. Desde la versión 2.1.214, la herramienta de PowerShell escribe los archivos en UTF-8 y los textos con acentos ya no llegan como interrogaciones. Si tu instalación es de antes, claude update.
Si la búsqueda no encuentra archivos que sabes que están, el buscador que trae Claude Code no ha arrancado en tu equipo: winget install BurntSushi.ripgrep.MSVC y la variable USE_BUILTIN_RIPGREP=0. claude doctor te dice si ha funcionado.
Y el modo de permisos. En Pro, Max y Team la sesión arranca en modo auto y edita sin preguntar. La primera semana, Shift+Tab hasta ver «manual mode on», y la regla de la carpeta escrita en un CLAUDE.md.
En un ordenador de empresa
No hace falta administrador: todo se instala en tu carpeta de usuario. Lo que sí puede parar la instalación es lo que la empresa haya puesto entre tu ordenador e internet. Si hay proxy, se indica antes del comando: $env:HTTPS_PROXY = 'http://proxy.tuempresa:8080', con la dirección que te dé quien administra la red.
Si hay antivirus corporativo, avísale antes con este párrafo: «Voy a instalar Claude Code, una herramienta de Anthropic que ejecuta comandos y modifica archivos en una carpeta que yo elijo. Se instala en mi carpeta de usuario, sin permisos de administrador, y descarga un programa firmado por Anthropic». Es más fácil que explicarlo después de que el antivirus lo haya borrado.
Y si en la empresa prefieren que todo vaya dentro de WSL, la app de escritorio tiene esa opción integrada: eliges «WSL» como entorno y Claude Code trabaja en el lado Linux. Cómo se instala la app, en Claude en el escritorio.
De los ocho fallos, siete son de Windows y no de Claude Code. Es la parte de la instalación que ningún vídeo grabado en un Mac te va a enseñar, y la que separa diez minutos de una tarde.
Por dónde seguir
Con claude --version respondiendo, la primera hora está guiada en el tutorial de Claude Code. Si en tu oficina se usa Visual Studio Code, la extensión evita la ventana de PowerShell y enseña los cambios en el archivo: Claude Code en Visual Studio Code.
Lo que marca la diferencia después no es la instalación, es pedir bien, y eso se aprende antes en el chat: Claude para principiantes. El curso de Claude sin programar, con Claude Code dentro, está en preparación. Para varios equipos con el proxy y el antivirus de por medio, contadnos cuántos sois en la página de empresas.
Preguntas frecuentes
¿Claude Code funciona en Windows 10?
Sí, desde Windows 10 versión 1809, y también en Windows 11 y Windows Server 2019 o posterior, con procesador x64 o ARM64 y 4 GB de memoria. En un Windows 10 antiguo puede hacer falta activar TLS 1.2 con una línea en PowerShell antes de instalar.
¿Hace falta WSL para usar Claude Code en Windows?
No. Claude Code se instala de forma nativa desde PowerShell o CMD. WSL 2 sigue siendo una opción para quien ya usa herramientas de Linux o quiere el sandbox de comandos, que en la instalación nativa no está disponible. Conviene elegir una de las dos y no mezclarlas.
¿Hace falta Git para Windows para Claude Code?
No, es opcional. Sin Git, Claude Code ejecuta los comandos con PowerShell. Con Git instalado usa Git Bash, que entiende mejor los comandos escritos para Mac y Linux que aparecen en la mayoría de tutoriales. Anthropic lo recomienda, pero funciona sin él.
¿Por qué «claude» no se reconoce después de instalar?
Casi siempre porque no has abierto una ventana nueva de PowerShell. Si al abrirla sigue igual, el instalador no pudo añadir su carpeta a la ruta de programas: se añade con dos líneas en PowerShell que apuntan a la carpeta .local\bin de tu usuario, y se vuelve a abrir la ventana.
¿Necesito ser administrador para instalar Claude Code?
No. Se instala en tu carpeta de usuario, sin permisos de administrador. Lo que sí puede necesitar a quien administra el equipo es el proxy o el antivirus corporativo, que pueden bloquear la descarga o borrar el programa después de instalarlo.