Cómo solucionar la instalación de Claude Code en Windows, macOS y Linux

Vibe Coding Rescue · 2026-07-22 · Configuración y cuentas
Última revisión 2026-07-22Incluye Claude CodeFuentes oficiales 2

Si npm install -g @anthropic-ai/claude-code falla —o la instalación termina pero tu terminal no encuentra claude—, la solución depende del error exacto. Cuando el problema está relacionado con npm, pasar al instalador nativo suele ser la vía más rápida.

Empieza por el instalador nativo

Anthropic recomienda ahora su script de instalación nativo. No requiere Node.js.

En macOS, Linux o WSL:


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

En Windows PowerShell:


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

Si abriste el Símbolo del sistema, usa el instalador específico de CMD en lugar del comando de PowerShell:


curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Si ves EBADENGINE

Desde la versión 2.1.198 del paquete npm, Claude Code requiere Node.js 22 o superior. Anthropic señala que una versión antigua de Node puede generar únicamente una advertencia EBADENGINE aunque la instalación se complete, porque el ejecutable instalado es un binario nativo y no depende de Node.js en tiempo de ejecución.

Ejecuta primero claude --version. Si muestra un número de versión, Claude Code está instalado. Si no es así, revisa node -v y actualiza a Node.js 22 o superior, o cambia al instalador nativo anterior.

Si ves EACCES: permission denied

Tu cuenta no puede escribir en el directorio global de paquetes de npm. No intentes resolverlo con sudo npm install -g; Anthropic desaconseja expresamente hacerlo. Usa el instalador nativo en su lugar.

Si la instalación nativa encuentra el mismo error de permisos, devuelve la propiedad de ~/.local a tu cuenta actual y vuelve a intentarlo:


sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

Si el comando de instalación de Windows falla

Claude Code se ejecuta de forma nativa en Windows 10 versión 1809 o superior y Windows Server 2019 o superior. No se requiere acceso de administrador ni WSL.

Si eliges WSL, ejecuta el comando curl de macOS/Linux dentro de la terminal de WSL. Git for Windows es opcional cuando usas Windows de forma nativa: Claude Code puede usar herramientas de Bash cuando Git para Windows esté presente y herramientas de PowerShell cuando no esté.

Si Claude Code se instaló pero el comando no está disponible

El ejecutable nativo se instala en ~/.local/bin/claude en macOS y Linux, y en %USERPROFILE%\.local\bin\claude.exe en Windows. Un mensaje de command not found o "no reconocido" suele indicar que ese directorio no está en PATH.

Para zsh, el shell predeterminado de macOS:


echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Para bash en Linux o WSL, añade la misma línea a ~/.bashrc. En Windows, cierra todas las ventanas de terminal y abre una nueva. Si claude sigue faltando, añade %USERPROFILE%\.local\bin a tu PATH de usuario y abre otra terminal.

Si recibes 403 o Failed to fetch version

Estos errores suelen aparecer cuando un proxy corporativo o firewall bloquea downloads.claude.ai. Un 403 también puede significar que Claude no está disponible en la región o país desde el que te conectas, así que revisa la ubicación de salida si usas una VPN.

En una red corporativa, pide al equipo de TI la dirección del proxy y configura las variables de entorno correspondientes:


export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

Intentar la instalación con otra conexión, como el punto de acceso de un teléfono, es una forma rápida de separar un bloqueo de red de un problema específico de la máquina.

Ejecuta claude doctor para una comprobación final de la instalación y configuración. Si aún están instaladas tanto la copia de npm como la nativa, compara ls ~/.local/bin/claude con npm ls -g @anthropic-ai/claude-code y conserva una sola instalación. Anthropic recomienda la compilación nativa.

Si la instalación funciona pero el inicio de sesión no, revisa también la cuenta. Claude Code requiere una cuenta Pro, Max, Team, Enterprise o API Console; no está disponible con el plan gratuito de Claude.ai. Si el error sigue sin resolverse, busca el mensaje exacto en la guía de solución de problemas de instalación de Anthropic.

Referencias oficiales