Instalar Claude Code: guía fácil para Mac, Windows y Linux (2026)
Guía para instalar Claude Code revisada el 21/10/2026: comandos oficiales para Mac, Windows y Linux, por qué ya no necesitas Node, primer inicio de sesión y nueve errores de instalación con solución.
bufferSobre el autor9 min de lectura
Si quieres instalar Claude Code sin perder la tarde, esta es la guía que me habría gustado tener la primera vez. Revisé cada comando el 21 de octubre de 2026 contra la documentación oficial de instalación y la página de solución de problemas de Anthropic. Adelanto lo más útil: casi seguro que ya no necesitas Node.js, y los tutoriales que te piden Node 18 se quedaron viejos.
Dos cosas antes de empezar. Claude Code solo funciona en los países que Anthropic admite, y aquí hablo solo de la instalación normal en esos países. Y necesitas un plan de pago: Pro, Max, Team, Enterprise o una cuenta de Console (API). La cuenta gratuita de claude.ai no incluye Claude Code. Si buscabas cómo instalar Claude Code gratis, esa es la respuesta honesta.
Antes de instalar Claude Code: lo que pide tu equipo
La lista oficial es corta: macOS 13 o posterior; Windows 10 versión 1809 o posterior (o Windows Server 2019+); en Linux, Ubuntu 20.04+, Debian 10+ o Alpine 3.19+. Al menos 4 GB de RAM, procesador x64 o ARM64 y conexión a internet. La terminal puede ser Bash, Zsh, PowerShell o CMD.
Lo de Node confunde a todo el mundo. El paquete de npm todavía dice que quiere Node 22 o superior (lo miré: versión 2.1.304, publicada el 19 de octubre, con engines: node >=22.0.0 en npm). Pero desde la primavera de 2026 ese paquete descarga el mismo binario nativo que el instalador oficial, y el comando claude ya no usa tu Node para nada. Con el instalador nativo te olvidas de Node.
Comandos para instalar Claude Code en Mac, Windows y Linux
Elige la línea que corresponde a tu terminal. Anthropic recomienda el instalador nativo porque se actualiza solo en segundo plano; los demás métodos funcionan, pero te toca actualizar a mano.
macOS, Linux o WSL (Terminal, iTerm o la consola de WSL):
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell (el prompt empieza por PS C:\):
irm https://claude.ai/install.ps1 | iexWindows CMD (el prompt es solo C:\):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdHomebrew: brew install --cask claude-code. Es el canal estable, que va más o menos una semana por detrás; claude-code@latest sigue la última versión. Actualizas tú con brew upgrade.
WinGet: winget install Anthropic.ClaudeCode y, más adelante, winget upgrade Anthropic.ClaudeCode.
apt, dnf, apk: hay repositorios firmados para Debian/Ubuntu, Fedora/RHEL y Alpine. Son varios pasos (importar la clave, añadir el repo), así que mejor sigue la sección oficial que copiarlo de aquí. La huella de la clave que publican es 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE; compárala antes de fiarte.
npm, si de verdad lo prefieres:
npm install -g @anthropic-ai/claude-codeSin sudo delante. Nunca. Para actualizar, el mismo comando con @latest al final. La documentación avisa de que npm update -g puede no darte la última versión, una trampa bastante tonta.
Una queja pequeña: el instalador no muestra barra de progreso. Parece colgado. No lo está, espera.
Primer arranque: comprobar, iniciar sesión y ver con qué cuenta entras
Cierra la terminal y abre una nueva. En serio: la ventana vieja conserva el PATH viejo, y ese simple gesto arregla muchísimos «command not found». Después:
claude --version
claude doctorDeberías ver algo como 2.1.211 (Claude Code) (es el ejemplo de la documentación; el tuyo será más nuevo). claude doctor es un chequeo de solo lectura: te dice si la instalación está rota, si tu archivo de configuración tiene errores y qué hacer. Luego entra con cd en la carpeta del proyecto y escribe claude. Se abre el navegador, inicias sesión con tu cuenta de claude.ai y listo. Si el navegador no se abre, pulsa c en el aviso para copiar la URL.
Y escribe /status. Siempre insisto en esto: Claude Code usa la primera credencial que encuentra, y una ANTHROPIC_API_KEY vieja en tu perfil de shell gana a tu sesión de Pro o Max (el orden está en la página de autenticación). Si /status muestra una API key que no esperabas, ahí tienes la causa de un montón de errores raros. Los problemas de inicio de sesión (403 después de entrar, WSL o SSH, el «Not logged in» que vuelve) están en la guía de errores de Claude Code, apartados A1 a A4.
Windows, WSL y VS Code
Windows nativo ya funciona bien. No hace falta ser administrador. Git for Windows antes era obligatorio y ahora es opcional: si lo tienes, Claude Code usa Git Bash para su herramienta Bash; si no, ejecuta los comandos con PowerShell. La única diferencia real es que Windows nativo no tiene sandbox y WSL 2 sí. Si vas por WSL, instala y arranca Claude Code dentro de la terminal de WSL, no desde PowerShell.
Para VS Code hay una extensión oficial. Pide VS Code 1.94.0 o posterior y cualquier plan de pago de Claude o una cuenta de Console, y lo que gastas ahí sale de la misma bolsa que la web y la terminal (documentación de VS Code). Ojo: instalar solo la extensión no pone claude en tu PATH; si también quieres el comando, instala la CLI aparte.
Problemas al instalar Claude Code: I1 a I9
Cada problema tiene un número para que la página de errores enlace directo aquí. Las soluciones salen de la página oficial de troubleshooting salvo que diga otra cosa.
I1. command not found: claude / ‘claude’ no se reconoce
La carpeta de instalación no está en tu PATH, o la terminal se abrió antes de instalar. El propio instalador lo avisa: Native installation exists but ~/.local/bin is not in your PATH. En macOS con Zsh:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrcEn Linux con Bash va en ~/.bashrc; en macOS con Bash, en ~/.bash_profile. En Windows PowerShell:
[Environment]::SetEnvironmentVariable('PATH', "$([Environment]::GetEnvironmentVariable('PATH','User'));$env:USERPROFILE\.local\bin", 'User')Luego abre otra terminal (y reinicia el editor si usas su terminal integrada).
I2. permission denied: ~/.zshrc
Tu archivo de configuración es de root o es de solo lectura. sudo chown $(whoami) ~/.zshrc para lo primero, chmod u+w ~/.zshrc para lo segundo.
I3. EACCES: permission denied
Alguna carpeta donde escribe Claude Code (como ~/.local/bin o ~/.claude) no tiene permisos. La documentación propone sudo mkdir -p ~/.local/bin && sudo chown -R $(whoami) ~/.local. Si el error viene de npm, Anthropic aconseja pasarse al instalador nativo. Nada de sudo npm install -g.
I4. EBADENGINE, o un tutorial que exige Node 18
EBADENGINE es solo un aviso: con Node por debajo de 22, npm protesta pero la instalación funciona, porque el binario no usa tu Node. Parecidos: Error: claude native binary not installed significa que npm se saltó los paquetes opcionales (--ignore-scripts, --omit=optional u optional=false en .npmrc); reinstala sin eso. ENOTEMPTY: borra la carpeta @anthropic-ai/claude-code que quedó en $(npm root -g) y repite. En Windows, running scripts is disabled on this system: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, o usa el instalador de PowerShell.
I5. Problemas con WSL
En WSL 1 puede salir cannot execute binary file: Exec format error. Es una regresión conocida y lo limpio es pasar a WSL 2 con wsl --set-version <NombreDistro> 2 desde PowerShell. Si which node apunta a /mnt/c/..., estás usando el Node de Windows; instala uno de Linux dentro de WSL. Y repito: el comando de Linux se ejecuta dentro de WSL.
I6. 32 bits, Illegal instruction, errores dyld
Claude Code does not support 32-bit Windows suele significar que abriste «Windows PowerShell (x86)». Usa el normal. Illegal instruction es arquitectura equivocada o una CPU sin AVX (equipos muy viejos o máquinas virtuales que no pasan AVX), y para el binario nativo no hay solución. dyld: Symbol not found en Mac quiere decir macOS anterior a 13; Homebrew no ayuda porque es el mismo binario.
I7. ‘irm’ no se reconoce / ‘&&’ no es un separador válido
Comando equivocado para tu terminal. irm es de PowerShell, ese && es de CMD, y -fsSL falla en PowerShell porque ahí curl es otra cosa. Mira el prompt y elige la línea correcta de arriba.
I8. syntax error near unexpected token ‘<‘ o curl: (22) 403
La URL del instalador devolvió una página web en vez del script. Si la salida menciona App unavailable in region, tu ubicación no está en la lista de países admitidos y aquí no hay ningún apaño que ofrecer. En un país admitido, la documentación dice que esperes unos minutos y reintentes, o que instales con Homebrew o WinGet.
I9. Killed, exit code 137 y otras instalaciones a medias
Killed en un VPS pequeño es falta de memoria; la instalación necesita unos 512 MB libres, así que añade swap y repite. curl: (23) o (56): la descarga se cortó, vuelve a lanzarla. ¿Varias instalaciones peleándose (npm, nativa y Homebrew)? Revisa which -a claude o where.exe claude y quédate con una. Yo me quedo con la nativa.
Preguntas frecuentes para instalar Claude Code
¿Se puede instalar Claude Code gratis? Instalarlo, sí; usarlo con una cuenta gratuita de claude.ai, no. Hace falta Pro, Max, Team, Enterprise o una cuenta de Console con crédito de API.
¿Cómo instalar Claude Code en Windows 10 u 11? En PowerShell: irm https://claude.ai/install.ps1 | iex. Sin permisos de administrador, Git Bash opcional, mínimo Windows 10 1809.
¿Y en Mac o Ubuntu? La misma línea de curl, o Homebrew en Mac y el repo apt firmado en Ubuntu. macOS 13 y Ubuntu 20.04 son los mínimos.
¿npm o instalador nativo? Nativo. Es el mismo binario, pero se actualiza solo y le da igual tu versión de Node.
¿Qué plan compro? Eso da para otro artículo: mi opinión está en Claude Pro vs Max, y si dudas entre herramientas, en Claude Code o Codex. Cómo funcionan los límites de 5 horas y semanales lo explico en la cuota de Claude.
¿Skills y plugins? Otro tema; tengo una lista en los mejores mods de Claude Code.
Sigue leyendo: errores de Claude Code · seguimiento de límites de Claude y Codex · comparativa de precios de suscripciones de IA · todo lo de la categoría Claude