Cómo instalar Claude Code en macOS, Linux, WSL2 y Windows

Hola, bienvenido. En la lección anterior vimos las superficies desde las que puedes usar Claude Code y por qué en el curso vamos a trabajar en la terminal, así que en esta lección vamos a instalarlo. Veremos el instalador nativo, que es el recomendado, y las alternativas con Homebrew, WinGet, los repositorios de Linux y npm, cómo elegir el canal de actualizaciones, qué hacer si la terminal no encuentra el comando claude y cómo comprobar que todo está bien con claude --version y claude doctor.

La regla más importante de esta lección es muy sencilla: Claude Code se instala en el mismo entorno donde vive el proyecto. Si trabajas en macOS o en Linux, eso es tu sistema directamente. Si trabajas en Windows con WSL2 y Sail, como vamos a hacer en el curso, Claude Code se instala y se ejecuta dentro de la terminal de WSL, no desde PowerShell ni desde CMD. ¿Por qué? Porque así Claude ve las mismas rutas, los mismos permisos y los mismos comandos que usa el proyecto, y cuando ejecute ./vendor/bin/sail lo hará en el mismo sitio en el que lo harías tú. Si todavía no tienes montado WSL2 con Sail, te recomiendo que antes pases por el curso WSL 2 en Windows con Laravel Sail↗ (se abre en una pestaña nueva).

Claude Code funciona en estos sistemas, según la documentación oficial: macOS 13.0 o superior, Windows 10 1809 o superior y Windows Server 2019 o superior, Ubuntu 20.04 o superior, Debian 10 o superior y Alpine Linux 3.19 o superior. Necesita al menos 4 GB de RAM, un procesador x64 o ARM64, conexión a internet y una shell Bash, Zsh, PowerShell o CMD. Y para usarlo, una cuenta con acceso a Claude Code, que es lo que configuraremos en la siguiente lección.

En Windows tienes 3 opciones, y no son equivalentes:

Para este curso, WSL2. Además de ser donde corre Sail, es la opción que admite el sandbox, el aislamiento de sistema de archivos y red para los comandos que Claude ejecuta, y que veremos en la lección Sandbox de Claude Code en WSL2 y Linux. Y si tu distribución sigue en WSL1, conviértela: la documentación recoge un fallo conocido del binario nativo en WSL1 que hace que claude termine con cannot execute binary file: Exec format error, y la solución que propone es pasar la distribución a WSL2 desde PowerShell.

Sustituye <DistroName> por el nombre de tu distribución, por ejemplo Ubuntu.