Resumen rápido: Instalar Claude Code en Windows requiere configurar WSL2 (Subsistema de Windows para Linux), instalar Ubuntu y ejecutar un script de instalación sencillo. El proceso permite a los usuarios de Windows acceder al asistente de codificación IA de Anthropic a través de su terminal. Existen binarios nativos para Windows, sin embargo, WSL2 sigue siendo la mejor práctica para la instalación en Windows.
Claude Code es un asistente de codificación impulsado por IA que opera directamente en la terminal, ayudando a los desarrolladores a crear funciones, corregir errores y automatizar tareas de desarrollo. Pero hay una advertencia para los usuarios de Windows.
Claude Code está disponible como un ejecutable nativo de Windows y se puede instalar a través de npm o una descarga binaria directa sin WSL2. Sin embargo, requiere el Subsistema de Windows para Linux (WSL2), y el método de instalación oficial todavía se basa en WSL2.
Aquí te explicamos cómo hacerlo funcionar en Windows 11 o Windows 10.
Requisitos del sistema
Antes de comenzar la instalación, verifica que la máquina con Windows cumpla estos requisitos:
- Windows 10 1809 o superior, o Windows Server 2019 o superior
- Windows 11 (cualquier versión)
- Al menos 4 GB de RAM disponible
- Privilegios de administrador en el sistema
- Conexión a Internet para descargar WSL2 y Ubuntu
La instalación requiere espacio en disco para WSL2, Ubuntu y Claude Code.
Paso 1: Habilitar el Subsistema de Windows para Linux
WSL2 proporciona un entorno Linux directamente dentro de Windows. Es la base que permite que Claude Code funcione.
Abre PowerShell como Administrador. Haz clic derecho en el botón Inicio y selecciona "Windows PowerShell (Admin)" o "Terminal (Admin)" en Windows 11.
Ejecuta este comando:
wsl –install
Este comando habilita las características necesarias de Windows e instala Ubuntu como la distribución Linux predeterminada. Es probable que el sistema solicite un reinicio.
Después de reiniciar, WSL2 completa la configuración automáticamente. Ubuntu se inicia y pide un nombre de usuario y contraseña. Estas credenciales son solo para el entorno Linux; no necesitan coincidir con las credenciales de Windows.
Paso 2: Verificar la instalación de WSL2
Una vez que el sistema se reinicia y Ubuntu termina su configuración inicial, verifica que WSL2 esté funcionando correctamente.
Abre la terminal de Ubuntu (busca "Ubuntu" en el menú Inicio) y ejecuta:
wsl –version
Esto muestra la información de la versión de WSL. Busca "WSL version: 2.x.x" en la salida.
Si el comando muestra WSL1 en su lugar, actualiza a WSL2 con:
wsl –set-default-version 2
Paso 3: Instalar Claude Code
Ahora, la instalación real de Claude Code. La documentación oficial proporciona un script de instalación de una línea.
En la terminal de Ubuntu, ejecuta:
curl -fsSL claude.ai/install.sh | bash
El script descarga el binario de Claude Code, configura los permisos necesarios y lo agrega al PATH del sistema. La duración de la instalación varía según la velocidad de Internet y las especificaciones del sistema.
Según la documentación oficial de Claude Code, el instalador detecta automáticamente la arquitectura del sistema y descarga la versión binaria apropiada.
Problemas comunes de instalación
Algunos usuarios de Windows informan ver "command not found: claude" después de la instalación. Esto suele ocurrir porque la variable PATH no se ha actualizado.
Cierra y vuelve a abrir la terminal de Ubuntu, luego intenta de nuevo. Si el problema persiste, esta configuración de ruta puede ayudar como solución alternativa no oficial:
echo ‘export PATH=”$HOME/.claude/bin:$PATH”‘ >> ~/.bashrc
source ~/.bashrc
Paso 4: Autenticar Claude Code
Claude Code requiere autenticación con una cuenta de Anthropic antes de su uso.
Ejecuta este comando:
claude
La terminal muestra una URL y solicita autenticación. El proceso varía ligeramente para usuarios individuales frente a cuentas de equipo:
| Tipo de cuenta | Método de autenticación | Lo que se requiere |
|---|---|---|
| Individual | Clave API personal | Cuenta de Anthropic con acceso a API |
| Equipo/Organización | Token de organización | Token de autenticación proporcionado por el administrador |
Abre la URL proporcionada en un navegador, inicia sesión en la cuenta de Anthropic y autoriza Claude Code. La terminal confirma la autenticación exitosa.
Trabajar con proyectos de Windows en WSL2
Aquí es donde las cosas se ponen complicadas. Los sistemas de archivos de Windows y los sistemas de archivos de WSL2 están separados.
Los archivos de Windows son accesibles desde WSL2 en /mnt/c/ (para la unidad C:), /mnt/d/ (para la unidad D:), y así sucesivamente. Pero hay un costo de rendimiento. Las discusiones de la comunidad indican diferencias de rendimiento entre directorios montados en Windows y directorios nativos de WSL2.
Para un rendimiento óptimo, copia los archivos del proyecto al directorio principal de WSL2:
cp -r /mnt/c/Users/TuNombre/Projects/tu-proyecto ~/projects/tu-proyecto
¿El inconveniente? La integración con el IDE se vuelve más compleja. Visual Studio Code maneja esto bien con su extensión Remote-WSL, pero otros IDEs pueden tener dificultades.
Probar la instalación
Verifica que Claude Code funcione correctamente con una prueba sencilla.
Navega a un directorio de proyecto (o crea una carpeta de prueba):
mkdir ~/claude-test
cd ~/claude-test
claude “crea un script simple de Python 'hola mundo'”
Claude Code debería responder, crear el archivo y mostrar el código. Esto confirma que la instalación fue exitosa.
Deja de pagar de más, reclama primero los créditos de IA disponibles
La instalación de Claude Code en Windows suele ser rápida. El costo real aparece más tarde, cuando los desarrolladores comienzan a probar prompts, ejecutar scripts e integrar el modelo en aplicaciones. Esa fase de experimentación puede generar muchas llamadas a la API, y muchos equipos solo se dan cuenta del costo después de empezar a construir.
Antes de gastar dinero en uso, vale la pena verificar si calificas para créditos de IA o programas de socios. Get AI Perks recopila estas oportunidades en un solo lugar, listando créditos y descuentos de proveedores de IA, plataformas en la nube y herramientas para desarrolladores, junto con instrucciones sencillas sobre cómo reclamarlos.
Antes de ejecutar tu primer proyecto con Claude Code, consulta Get AI Perks y reclama los créditos de IA que pueden cubrir tus costos de desarrollo.
Preguntas frecuentes
¿Puede Claude Code ejecutarse de forma nativa en Windows sin WSL2?
Sí, pero WSL2 sigue siendo el mejor método de instalación para Windows.
¿Claude Code funciona con la Terminal de Windows?
Sí. La Terminal de Windows puede abrir pestañas de Ubuntu, lo que permite acceder a Claude Code sin cambiar a una ventana separada de Ubuntu. En la Terminal de Windows, haz clic en la flecha desplegable y selecciona Ubuntu de la lista de perfiles.
¿Mis herramientas de desarrollo de Windows existentes funcionarán con Claude Code?
Depende de la herramienta. Visual Studio Code se integra bien a través de la extensión Remote-WSL. Las IDEs de JetBrains y otras herramientas pueden requerir configuración adicional. La documentación oficial menciona VS Code y JetBrains como plataformas compatibles.
¿Cómo actualizo Claude Code en Windows?
Claude Code se actualiza automáticamente por defecto. Para actualizar manualmente, ejecuta `claude update` en la terminal de Ubuntu. La función de actualización automática se puede deshabilitar a través de archivos de configuración si es necesario para entornos empresariales.
¿Cuál es la diferencia entre Claude Code y la API de Claude?
Claude Code es un asistente de codificación basado en terminal que ejecuta comandos y edita archivos. La API de Claude proporciona acceso programático al modelo de lenguaje de Claude para crear aplicaciones personalizadas. Sirven a propósitos diferentes y requieren procesos de configuración diferentes.
¿Puedo usar Claude Code con proyectos .NET en Windows?
Sí, pero con advertencias. Las discusiones de la comunidad indican que el soporte del SDK de .NET en WSL2 funciona, pero requiere la instalación de la versión Linux del SDK de .NET dentro de Ubuntu. El .NET instalado en Windows no será accesible desde WSL2.
¿Cuánto cuesta Claude Code?
El precio depende del uso y el tipo de cuenta. Consulta el sitio web oficial de Anthropic para conocer los niveles de precios actuales y los planes de equipo, ya que los costos varían según el consumo de la API y los requisitos de la organización.
Próximos pasos después de la instalación
Con Claude Code instalado, comienza a explorar sus capacidades. La documentación de inicio rápido recomienda empezar con tareas sencillas como explicaciones de código antes de pasar a operaciones más complejas.
Prueba estos comandos para familiarizarte:
- claude “explica esta función” – Obtener explicaciones de código
- claude commit – Generar mensajes de commit de Git
- claude -c – Continuar la conversación más reciente
La documentación oficial proporciona guías detalladas para la integración con IDE, la instalación de complementos y opciones de configuración avanzada. Para los equipos, la configuración administrada por servidor y el seguimiento analítico ofrecen control adicional sobre las implementaciones de Claude Code.
La configuración de WSL2 puede parecer pasos adicionales en comparación con las aplicaciones nativas de Windows, pero actualmente es la única forma de ejecutar Claude Code en Windows. ¿La buena noticia? Una vez configurado, se ejecuta sin problemas y se integra con la mayoría de los flujos de trabajo de desarrollo.
