Cómo instalar Claude Code en Windows, macOS y Linux (mayo 2026)

Claude Code pasó de cero a más de un millón de búsquedas mensuales en menos de un año. Si llegaste acá porque “todo el mundo está hablando de eso” y querés probarlo vos mismo, esta es tu guía de setup en 5 minutos para cualquier sistema operativo.

Cuatro cosas que tenés que saber antes de empezar:

1. Necesitás un plan pago. Claude Pro ($20/mes), Max, Team, Enterprise o una cuenta de Claude Console te desbloquean Claude Code. El plan gratuito de Claude.ai no lo incluye.
2. Claude Code vive en tu terminal — esa ventana de texto donde escribís comandos. (Anthropic también tiene una app de escritorio si preferís evitar la terminal por completo.)
3. El instalador nativo es el método oficial en 2026. Anthropic también agregó Homebrew, WinGet y repositorios de paquetes Linux firmados a principios de 2026. Quien ya trabaja con un gestor de paquetes ahora tiene opciones de primera línea. La ruta legacy de npm sigue funcionando pero ya no se recomienda.
4. Heads-up del bug de tokens: Las versiones desde v2.1.100 inflan el consumo de tokens cerca de 40%. La última al 4 de mayo es v2.1.126 — más adelante te explico el workaround.

Elegí tu OS — cada ruta de instalación es un solo comando:

Vamos.

Requisitos del sistema

Antes de instalar, verificá que tenés un OS soportado:

Si estás en Windows 11, andás bien. Si estás en macOS Monterey (12) o anterior, primero actualizá.

Instalar en Windows

Tenés tres rutas en Windows. Elegí según si necesitás un toolchain estilo Linux (WSL) o querés quedarte nativo (PowerShell + Git Bash).

Windows nativo: PowerShell (la ruta más simple)

Abrí PowerShell (no necesitás Administrador) y ejecutá:

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

Si irm te tira “is not recognized as an internal or external command”, estás en CMD, no en PowerShell. El prompt muestra PS C:\ en PowerShell vs C:\ en CMD. Para usar CMD:

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

Después de instalar, cerrá y reabrí tu terminal para que el PATH se actualice, y verificá:

claude --version
claude doctor

Recomendado: Instalá Git for Windows antes de lanzar claude. Anthropic lo recomienda porque Claude Code usa Git Bash internamente para tooling de shell. Sin él, Claude Code cae a PowerShell como herramienta de shell, que tiene menos features.

Si claude doctor se queja de no encontrar Git Bash, indicale dónde está en ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Windows nativo: WinGet (instalación gestionada)

Anthropic publica Claude Code a través del gestor de paquetes oficial de Microsoft:

winget install Anthropic.ClaudeCode

Las instalaciones de WinGet no se actualizan solas — corré winget upgrade Anthropic.ClaudeCode periódicamente.

Instalar en Windows con WSL

WSL 2 (Windows Subsystem for Linux) te da un entorno Linux real adentro de Windows. Anthropic recomienda WSL cuando querés ejecución de comandos en sandbox o ya trabajás con toolchains Linux.

Paso 1 — Instalar WSL. Abrí PowerShell como Administrador y ejecutá:

wsl --install

Reiniciá cuando te lo pida. Después del reinicio, abrí la terminal de Ubuntu desde el menú Inicio.

Paso 2 — Instalar Claude Code dentro de WSL. Desde el prompt de Ubuntu:

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

Paso 3 — Verificar y empezar a trabajar en un proyecto:

claude --version
claude doctor
cd /mnt/c/Users/TU_USUARIO/ruta/al/proyecto
claude

La ruta /mnt/c/ es cómo WSL accede a tus discos de Windows. Tu C: vive en /mnt/c/, D: en /mnt/d/, etc.

Instalar en macOS o Linux

Abrí Terminal. Pegá esto. Apretá Enter.

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

Esa es toda la instalación. El instalador nativo descarga el binario, lo pone en ~/.local/bin y configura auto-actualizaciones. No hace falta Node.js, ni dependencias, ni drama de gestores de paquetes.

Verificá que funcionó:

claude --version
claude doctor

claude doctor corre diagnósticos: estado de auth, PATH, config, servidores MCP. Corrélo siempre después de instalar para detectar problemas temprano.

Ahora entrá a un proyecto:

cd /ruta/a/tu/proyecto
claude

Listo. Estás dentro de Claude Code.

Instalar con Homebrew (macOS)

Si ya manejás tus herramientas con Homebrew, Anthropic publica un cask oficial:

brew install --cask claude-code

En realidad hay dos casks:

• claude-code — sigue el canal stable (alrededor de una semana atrás de latest, salta releases con regresiones grandes). Opción más segura.
• claude-code@latest — sigue el canal latest (versiones nuevas apenas salen).

# Para el canal bleeding-edge:
brew install --cask claude-code@latest

Heads-up: las instalaciones de Homebrew no se actualizan solas. Corré brew upgrade claude-code (o claude-code@latest) para versiones nuevas y parches de seguridad.

Instalar en Linux con gestores de paquetes

Anthropic publica repositorios firmados de apt, dnf y apk. Es la ruta más limpia en Debian/Ubuntu, Fedora/RHEL y Alpine porque las actualizaciones fluyen por tu workflow normal de actualización del sistema.

Debian / Ubuntu (apt):

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Verificá el fingerprint de la clave GPG antes de confiar en ella: gpg --show-keys /etc/apt/keyrings/claude-code.asc debería mostrar 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.

Fedora / RHEL (dnf):

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

Alpine (apk):

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

Si querés el canal rolling, cambiá stable por latest en la URL y nombre de suite. Actualizá después con tu comando normal de gestor de paquetes (sudo apt upgrade claude-code, sudo dnf upgrade claude-code, apk upgrade claude-code).

Instalar vía npm (la ruta legacy)

Si ya tenés Node.js 18+ instalado y preferís npm:

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

Esto instala el mismo binario nativo que el instalador standalone, a través de una dependencia opcional por plataforma. Tres razones por las que la mayoría ya lo evita:

1. No tiene auto-actualización. Tenés que hacer npm update manualmente cuando salen versiones nuevas.
2. Requiere Node.js 18+. El instalador nativo tiene cero dependencias.
3. Errores de permisos. Especialmente con sudo npm install -g — no lo hagas.

Si ya instalaste por npm y querés migrar a nativo:

curl -fsSL https://claude.ai/install.sh | bash
npm uninstall -g @anthropic-ai/claude-code

Autenticación (el baile del login)

La primera vez que ejecutás claude, te abre el navegador para login OAuth. Iniciá sesión con la cuenta de Anthropic que uses:

• Suscripción personal Claude Pro/Max — login de claude.ai
• Claude Team o Enterprise — login de tu workspace
• Claude Console — si tu org te invitó

Si tu navegador no abre solo, apretá c en la terminal para copiar la URL de login, pegala en tu navegador, terminá el login, y pegá el código de vuelta en la terminal cuando te lo pida.

Para cambiar de cuenta más adelante:

/logout

(Ese comando va dentro de Claude Code, no en tu shell.)

Tus primeros comandos

Después de que claude te deja en una sesión interactiva, probá:

/help          # Mostrar todos los comandos disponibles
/status        # Ver auth, suscripción, rate limits
/config        # Ver configuración actual
/logout        # Cerrar sesión

Desde tu shell (fuera de la sesión interactiva):

claude doctor    # Reporte de diagnóstico
claude --version # Versión instalada
claude mcp list  # Listar servidores MCP configurados

Una primera tarea real

Abrí un proyecto que ya tenés. Cualquiera — una app Next.js, un script de Python, un repo de configs. Iniciá Claude Code:

cd /ruta/al/proyecto
claude

Después tipeá una tarea real en español o inglés. Algo como:

“Leé el README y contame cómo está organizado este proyecto.”

O:

“Agregá una función nueva que valide direcciones de email. Ponela donde mejor encaje en el codebase.”

O:

“Encontrá todos los comentarios TODO y listámelos con las rutas de archivo.”

Claude mira tus archivos, piensa y propone cambios. Te pide aprobar cada edit antes de hacerlo. Vos mantenés el control.

Problemas típicos del setup (y soluciones)

“command not found: claude”

El instalador puso el binario en ~/.local/bin, pero tu shell no conoce ese directorio. Agregalo al PATH:

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

Cambiá .bashrc por .zshrc si estás en zsh (default de macOS desde Catalina).

“The token ‘&&’ is not a valid statement separator”

Pegaste un comando estilo CMD en PowerShell. Cambiá a CMD, o usá la versión PowerShell:

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

“Permission denied” durante npm install

Probaste sudo npm install -g y rompiste permisos. No uses sudo con npm. En vez de eso:

• Usá el instalador nativo (no necesita sudo): curl -fsSL https://claude.ai/install.sh | bash
• Usá nvm (Node Version Manager) para instalar Node en tu home

WSL no llega a internet

Probá con curl https://claude.ai. Si falla, tu firewall de Windows o VPN está bloqueando WSL. La mayoría de las VPNs tienen una opción “exclude local traffic” — activala.

Rate limit ni bien instalás

¿Estás en Pro y llegás al límite en menos de una hora? Es un problema real que Anthropic reconoció el 31 de marzo de 2026. Verificá tu versión de Claude Code:

claude --version

La última build al 4 de mayo es v2.1.126 (lanzada el 1 de mayo), que agregó el comando útil claude project purge [path] y arregló un bug del porcentaje /context de Opus 4.7 — pero el problema de inflación de tokens introducido en v2.1.100 sigue sin parche público. Workaround según reportes de la comunidad: bajá a v2.1.34, o reinstalá vía npm en vez del binario nativo.

Podés fijar una versión específica con el instalador nativo:

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

O fijá un piso mínimo en ~/.claude/settings.json para que futuras actualizaciones no te lleven sin querer a una versión mala:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.34"
}

Extender Claude Code con MCP

Cuando ya tenés lo básico funcionando, el verdadero poder está en conectar Claude Code a otras herramientas vía MCP (Model Context Protocol). MCP convierte a Claude Code de “asistente de programación” en “asistente con acceso directo a tus bases de datos, APIs y herramientas de equipo.”

Listar servidores MCP actuales:

claude mcp list

Agregar uno nuevo (ejemplo — conectar una base de datos):

claude mcp add my-db --command "docker run --rm my-db-mcp:latest"

Cada proyecto puede tener su propio archivo .claude/.mcp.json listando los servidores MCP que ese proyecto usa. Codebases compartidos pueden commitear este archivo para que todo el equipo tenga el mismo setup de herramientas.

Referencia rápida por OS

Qué significa esto para vos

Si nunca usaste una terminal: Quedate con macOS o WSL en Windows. La terminal es parte de la identidad de Claude Code — no podés usarlo realmente sin al menos comodidad básica con la terminal. Pasá un rato aprendiendo cd, ls, pwd y lo básico de git si todavía no.

Si sos un dev evaluando Claude Code: Instalalo en 5 minutos, apuntalo a un side project, dale una tarea real. Cursor es más estilo IDE, Copilot es más estilo autocompletar — Claude Code es genuinamente diferente, y lo tenés que sentir para entenderlo.

Si configurás esto para tu equipo: Creá un directorio .claude/ en tus repos compartidos con configuración MCP del equipo. Commiteala. Los nuevos miembros corren el instalador, se autentican y heredan el setup de herramientas del equipo automáticamente.

Si ya instalaste Claude Code: El ecosistema de plugins y MCP es donde subís de “usuario de Claude Code” a “power user”. Nuestro curso Claude Code Mastery entra en profundidad en skills, hooks y MCP.

En definitiva

Instalar Claude Code lleva entre 30 segundos y 5 minutos según tu OS. El instalador nativo (default desde abril de 2026) es confiable, rápido y sin dependencias.

La verdadera curva de aprendizaje no es la instalación — es darte cuenta cómo usar Claude Code productivamente una vez instalado. Empezá con tareas chicas, crecé hacia workflows más grandes, agregá herramientas MCP cuando encuentres necesidades reales. No intentes configurar todo el día uno.

Y presupuestá la suscripción. El plan gratuito no te alcanza. Pro a $20/mes es el punto de entrada real.

Próximo paso: Nuestro curso Claude Code Mastery cubre todo el workflow — desde la primera instalación hasta patrones agentic avanzados con skills, hooks y MCP. Si ya estás instalado, también te puede interesar Herramientas MCP para IA para conectar Claude Code con tus bases de datos y APIs.

Fuentes (verificadas el 4 de mayo de 2026):

• Claude Code Setup — Documentación oficial (verificado en vivo para sintaxis de comandos)
• Claude Code Changelog — Oficial
• Release de Claude Code v2.1.126 — 1 de mayo de 2026
• Install Claude Code — Anthropic