Cómo instalar Claude Code en Windows y macOS (2026): guía paso a paso

verifica cada comando y número de versión en la documentación oficial en code.claude.com/docs antes de seguir la guía, ya que Anthropic publica cambios con rapidez.

Soy Jasmine, una dev que usa Claude Code todos los días tanto en Windows como en macOS. Esta guía cubre los dos sistemas operativos en una sola página, con comandos listos para copiar y pegar en cada paso, además de cómo elegir el método adecuado, cómo verificar la instalación y cómo solucionar los errores más comunes. Si todavía no tienes claro qué es esta herramienta, lee primero qué es Claude Code y luego vuelve aquí.

Lo que necesitas antes de instalar (requisitos del sistema)

Antes de escribir cualquier comando, repasa esta lista rápida para que no termines la instalación y solo entonces descubras que no funciona:

• Sistema operativo: Windows 10 (build 1809 o posterior) o Windows 11; o macOS (funciona tanto en Apple Silicon como en Intel).
• Una cuenta de pago de Claude: obligatoria. Claude Code necesita un plan Pro ($20/mes), Max 5x ($100/mes), Max 20x ($200/mes), Team/Enterprise o facturación por tokens a través de Anthropic Console (API). El plan gratuito de claude.ai no desbloquea Claude Code.
• Terminal: PowerShell o Windows Terminal (Windows); Terminal o iTerm2 (macOS).
• Según tu método: si instalas con npm, necesitas Node.js 22 o posterior. El instalador nativo no necesita Node en absoluto. En Windows, instalar WSL2 o Git for Windows te da una experiencia de línea de comandos más fluida.

Importante: aquí es donde tropiezan muchos principiantes: puedes descargar e instalar Claude Code con un plan gratuito, pero el inicio de sesión se bloquea porque la cuenta no tiene acceso. Primero pásate a un plan de pago, o ten lista una clave de API de la Console.

Un consejo rápido antes de empezar: si tu equipo ya tiene Node, ejecuta node --version para ver en qué versión estás; si es una versión antigua (18 o 20), tendrás que actualizarla antes de instalar con npm, o simplemente cambia al instalador nativo y olvídate de Node. En cuanto al espacio, Claude Code es una herramienta de línea de comandos ligera que no exige mucho disco ni RAM; lo que de verdad determina la velocidad es tu conexión de red, no tu hardware.

Cómo elegir el método de instalación adecuado

Hay cuatro enfoques habituales. Si tienes dudas, ve con el instalador nativo: es la opción más ligera y se actualiza solo. La tabla de abajo te ayuda a decidir en unos 30 segundos:

Instalar Claude Code en Windows

Windows en 2026 tiene instalador nativo y WinGet, así que WSL ya no es obligatorio como antes. Dicho esto, WSL2 sigue ofreciendo la línea de comandos estilo Linux más fluida. Elige uno de los tres enfoques de abajo.

Método 1 - Instalador nativo (recomendado)

Abre PowerShell y ejecuta el comando de instalación de una línea de Anthropic. Esta vía no necesita Node.js y se actualiza sola después:

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

Este comando descarga la compilación estable para tu sistema operativo y arquitectura, instala el binario en tu directorio de usuario y lo añade a tu PATH automáticamente. Cuando termine, cierra y vuelve a abrir el terminal para que el PATH se actualice, y comprueba con claude --version. Si PowerShell bloquea el script por la Execution Policy, puedes relajarla solo para la sesión actual con Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass y ejecutarlo de nuevo.

Método 2 - WinGet

Si ya gestionas software con WinGet, puedes instalarlo directamente:

winget install Anthropic.ClaudeCode

WinGet le va bien a quien quiere mantener Claude Code actualizado junto con todo lo demás mediante winget upgrade.

Método 3 - WSL2 + npm (entorno Linux)

Esta es la opción para quien quiere un entorno Linux de verdad en Windows. Abre PowerShell como administrador y activa WSL2:

wsl --install

Reinicia si te lo pide, abre Ubuntu y luego instala Node.js 22 LTS dentro de WSL (usa nvm o el repositorio oficial de NodeSource). Después, instala Claude Code con npm:

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

Algunas cosas que conviene tener en cuenta con WSL2:

• NO ejecutes sudo npm install -g: instalar de forma global con sudo suele causar dolores de cabeza con los permisos más adelante. Configura un prefix de npm en tu directorio de usuario, o usa nvm.
• Mantén tu código dentro del sistema de archivos de WSL (por ejemplo, ~/projects) en lugar de una ruta montada /mnt/c/...: la E/S es muchísimo más rápida.
• Instala Git for Windows (o git dentro de WSL): Claude Code funciona mejor con git disponible. Si usas PowerShell a secas sin git, algunas operaciones quedan limitadas.

Instalar Claude Code en macOS

En macOS tienes dos vías limpias: instalador nativo/Homebrew (sin Node) o npm si ya tienes Node. Ambas funcionan bien en Macs con Apple Silicon (M1/M2/M3 en adelante) e Intel; el instalador detecta la arquitectura correcta, así que nunca eliges a mano. Si nunca has usado Terminal en un Mac, ábrelo desde Spotlight (Cmd+Space, escribe "Terminal") y listo.

Método 1 - Instalador nativo / Homebrew

La vía más rápida, sin Node.js, se ejecuta en Terminal:

curl -fsSL https://claude.ai/install.sh | bash

Si ya usas Homebrew y quieres gestionarlo junto con tus otras herramientas:

brew install --cask claude-code

Método 2 - npm

Si te manejas con Node, instala primero Node.js 22+ (consigue el LTS en nodejs.org o ejecuta brew install node) y luego instala Claude Code:

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

Confirma que Node es lo bastante reciente con node --version (debe ser 22 o superior). Si te topas con un error de permisos durante una instalación global, evita sudo: en su lugar, restablece el prefix de npm a tu directorio de usuario.

Autenticación y tu primera sesión

Instalar no basta: tienes que iniciar sesión para desbloquearlo. Entra en cualquier carpeta de proyecto y ejecuta:

cd path-to-your-project
claude

En la primera ejecución, Claude Code abre tu navegador para iniciar sesión en tu cuenta de Anthropic (o pegar una clave de API si usas la Console). Una vez que hayas iniciado sesión, vuelve al terminal y tu sesión comienza. Si entras con una cuenta Pro/Max, tus límites de uso siguen tu suscripción; si usas una clave de API, se te cobra por token: son cosas separadas, así que elige la que encaje con tus necesidades y tu presupuesto.

De inmediato, prueba un prompt sencillo como "lista la estructura de este directorio" para confirmar que Claude Code puede leer tu proyecto. Este también es un buen momento para tomar confianza: puedes escribir tus peticiones en inglés (o en cualquier idioma), y siempre ves una vista previa de los cambios antes de aprobar la escritura de un archivo.

Claude Code también te pregunta si confías en la carpeta actual. Es un mecanismo de seguridad: la herramienta solo lee y escribe archivos en las carpetas que autorices. Para un proyecto desconocido que acabas de clonar, piénsalo antes de conceder acceso.

Verifica que la instalación funcionó

La mayoría de las guías se saltan este paso, pero verificar te ayuda a detectar problemas de PATH o de versión a tiempo. Ejecuta estos comandos y compáralos con el resultado esperado:

Si claude --version funciona y claude doctor no muestra errores en rojo, considera que tu instalación fue un éxito.

Errores comunes de instalación y soluciones rápidas

Estos son los errores con los que más me topo al instalar en ambos sistemas operativos, con una solución rápida para cada uno:

• 'claude' is not recognized / command not found: el ejecutable no está en tu PATH. Cierra y vuelve a abrir el terminal; si sigue fallando, añade el directorio de instalación (normalmente ~/.local/bin) a tu PATH y reinicia el terminal.
• Node demasiado antiguo: npm falla cuando Node está por debajo de la versión requerida. Actualiza Node a 22+ con nvm o reinstalando el LTS desde nodejs.org.
• Error de permisos (EACCES) durante npm install -g: no lo parchees con sudo. Reconfigura el prefix de npm a un directorio de usuario, o cambia al instalador nativo para esquivar por completo los problemas de permisos globales.
• WSL no habilitado (Windows): si wsl --install da error, activa tanto "Plataforma de máquina virtual" como "Subsistema de Windows para Linux" en las Características de Windows y reinicia.
• Terminal sin actualizar: después de instalar, las nuevas variables de entorno solo se aplican a las nuevas sesiones de terminal. Abre siempre un terminal nuevo antes de volver a intentarlo.

¿Te topaste con otra cosa o quieres profundizar? Consulta la guía dedicada sobre cómo corregir errores comunes de Claude Code, donde reúno la solución completa para cada situación.

Actualizar y desinstalar

Actualizar:

• Instalador nativo: se actualiza solo en segundo plano, no hay nada que hacer. Para comprobarlo manualmente puedes ejecutar claude update.
• npm: ejecuta npm update -g @anthropic-ai/claude-code.

Desinstalar:

• npm: npm uninstall -g @anthropic-ai/claude-code.
• Homebrew: brew uninstall --cask claude-code.
• Instalador nativo: elimina el binario en ~/.local/bin y el directorio de configuración relacionado.

Qué hacer después de instalar

Ahora que Claude Code funciona, es hora de usarlo de verdad. Un camino sugerido:

• Si eres principiante, lee los 10 pasos para empezar como principiante para aprender el flujo de trabajo básico.
• Si programas en VS Code, mira cómo usar Claude Code en VS Code para la integración con el editor.
• ¿Aún no te queda claro el concepto? Vuelve a qué es Claude Code.

Cuando te resulte natural, puedes ir más rápido con paquetes prediseñados de skill y subagent; por ejemplo, el bundle de AgentKit para Claude Code (que se activa a través de la ak CLI (20% de descuento por el enlace)) te ahorra configurar cada skill a mano. Es opcional: Claude Code funciona perfectamente antes de que recurras a un kit.

Preguntas frecuentes (FAQ)

¿Instalar Claude Code cuesta dinero?

Instalarlo es gratis, pero para usarlo necesitas una cuenta de pago de Claude: Pro ($20/mes), Max 5x ($100/mes), Max 20x ($200/mes), un plan Team/Enterprise, o facturación por tokens a través de Anthropic Console. El plan gratuito de claude.ai no desbloquea Claude Code.

¿Necesito saber programar?

Tener conocimientos básicos de programación te ayuda a trabajar con eficacia, pero no hace falta que seas experto. Necesitas saber abrir un terminal, moverte entre carpetas y leer la salida. Incluso quienes empiezan de cero pueden usarlo si siguen los pasos con cuidado.

¿WSL es obligatorio en Windows?

No. Windows en 2026 tiene instalador nativo y WinGet, así que puedes instalar directamente sin WSL. Dicho esto, WSL2 sigue ofreciendo la experiencia estilo Linux más fluida, lo que te conviene si tus proyectos esperan un entorno POSIX.

¿Qué versión de Node.js necesito?

Solo necesitas Node si instalas con npm, y deberías usar Node.js 22 o posterior. Si usas el instalador nativo, no necesitas Node.js en absoluto.

¿Puedo ejecutarlo en un equipo de pocas prestaciones?

Sí. Claude Code ejecuta la mayor parte de su procesamiento en los servidores de Anthropic, así que no exige un equipo potente; los requisitos de verdad son una conexión de red estable y una cuenta de pago. Un equipo modesto funciona bien.

¿Cómo desinstalo Claude Code?

Depende de cómo lo instalaste: con npm usa npm uninstall -g @anthropic-ai/claude-code; con Homebrew usa el brew uninstall correspondiente; con el instalador nativo, elimina el binario en ~/.local/bin junto con su directorio de configuración.

Conclusión

Instalar Claude Code en Windows o macOS se reduce a tres cosas: elegir un método (el instalador nativo es el más seguro para principiantes), iniciar sesión con una cuenta de pago y luego verificar con claude --version y claude doctor. Si te atascas, vuelve a la sección de errores comunes de arriba o a la guía dedicada sobre cómo corregir errores de Claude Code. Una vez instalado, empieza con los 10 pasos para principiantes para que tu primera sesión sea realmente productiva.

Fuente de los comandos de instalación y los requisitos del sistema: documentación oficial de Anthropic en code.claude.com/docs (consultado en 08/2026).