Cómo Instalar Claude Code: Guía Completa 2026 (NPM, Nativo, Homebrew y WinGet)

Claude Code es el agente de programación oficial de Anthropic que se ejecuta directamente en tu terminal. Te permite hablar con Claude sobre tu código, pedirle que implemente funcionalidades, corrija bugs, refactorice y mucho más — todo sin salir de la línea de comandos.

En esta guía te mostraré todos los métodos de instalación disponibles en 2026, desde el instalador nativo (recomendado) hasta NPM, Homebrew y WinGet, con configuración paso a paso.

Requisitos del sistema

Antes de instalar, asegúrate de que tu equipo cumple con los siguientes requisitos:

Método 1: Instalador nativo (Recomendado)

Desde 2026, el instalador nativo es el método recomendado por Anthropic. Es más rápido, no requiere Node.js, y se actualiza automáticamente en segundo plano.

macOS / Linux / WSL

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

Windows PowerShell

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

Windows CMD

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

El instalador nativo se actualiza automáticamente. No necesitas hacer nada para mantenerlo al día.

Método 2: Instalación con NPM

Si prefieres usar NPM (por ejemplo, en entornos CI/CD o cuando ya tienes Node.js configurado), este método sigue funcionando aunque Anthropic lo considera deprecado.

Paso 1: Verificar Node.js 18+

Claude Code requiere Node.js 18 o superior. Verifica tu versión:

1node --version
2# Debe mostrar v18.x.x o superior
3
4npm --version
5# Verifica que npm esté disponible

Si no tienes Node.js o tu versión es antigua, te recomiendo instalarlo con nvm (Node Version Manager):

1# Instalar nvm (macOS/Linux)
2curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
3
4# Reiniciar terminal y luego:
5nvm install 22
6nvm use 22
7
8# Verificar
9node --version  # v22.x.x

Paso 2: Instalar Claude Code globalmente

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

Paso 3: Verificar la instalación

1claude --version

Para un chequeo más detallado de tu instalación y configuración:

1claude doctor

Método 3: Homebrew (macOS/Linux)

Si usas Homebrew, puedes instalar Claude Code como un cask:

1brew install --cask claude-code

Método 4: WinGet (Windows)

En Windows puedes usar WinGet directamente desde PowerShell:

1

Para actualizar manualmente:

1

Autenticación: Primer inicio de sesión

Una vez instalado, abre tu terminal en el proyecto donde quieras trabajar y ejecuta:

1claude

Claude Code abrirá automáticamente tu navegador para que inicies sesión con tu cuenta de Anthropic. El flujo es el siguiente:

1. Se abre una pestaña del navegador con la página de autenticación de Anthropic
2. Inicias sesión con tu cuenta (Google, email, etc.)
3. Autorizas a Claude Code
4. Las credenciales se almacenan de forma segura en tu máquina local
5. En futuras sesiones, no necesitas autenticarte de nuevo

Configuración en Windows: Opciones detalladas

Windows tiene dos opciones de configuración que vale la pena conocer:

Opción A: Windows nativo con Git Bash

Instala Git for Windows y luego ejecuta el comando de instalación. Claude Code usa Git Bash internamente para ejecutar comandos. No necesitas ejecutar PowerShell como Administrador.

Si Claude Code no encuentra tu instalación de Git Bash, configura la ruta en tu settings.json:

1{
2  "env": {
3    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
4  }
5}

Opción B: WSL (Windows Subsystem for Linux)

Tanto WSL 1 como WSL 2 están soportados. WSL 2 soporta sandboxing para mayor seguridad. La instalación dentro de WSL es idéntica a Linux:

1# Dentro de WSL
2curl -fsSL https://claude.ai/install.sh | bash

Migrar de NPM al instalador nativo

Si ya tienes Claude Code instalado via NPM y quieres migrar al instalador nativo (recomendado), el proceso es simple:

1# 1. Instalar el binario nativo
2curl -fsSL https://claude.ai/install.sh | bash
3
4# 2. Remover la instalación antigua de NPM
5npm uninstall -g @anthropic-ai/claude-code
6
7# 3. Verificar que funciona
8claude --version

También puedes ejecutar claude install desde tu instalación de NPM existente para instalar el binario nativo junto a ella, y luego eliminar la versión de NPM.

Actualizaciones y canales de release

El instalador nativo se actualiza automáticamente en segundo plano. Puedes configurar el canal de actualizaciones:

Para configurar el canal, usa /config dentro de Claude Code o edita tu settings.json:

1{
2  "autoUpdatesChannel": "stable"
3}

Para forzar una actualización inmediata:

1claude update

Para desactivar las actualizaciones automáticas completamente:

1{
2  "env": {
3    "DISABLE_AUTOUPDATER": "1"
4  }
5}

Primeros pasos después de instalar

Una vez que tengas Claude Code funcionando, aquí van algunos comandos esenciales para que te familiarices:

1# Iniciar Claude Code en tu proyecto actual
2cd mi-proyecto
3claude
4
5# Iniciar con un prompt directo
6claude "explica la arquitectura de este proyecto"
7
8# Continuar la última conversación
9claude --continue
10
11# Ver la versión instalada
12claude --version
13
14# Diagnóstico completo del sistema
15claude doctor

Atajos útiles dentro de Claude Code

Desinstalación

Si necesitas desinstalar Claude Code, el proceso depende del método que usaste:

1# Instalador nativo (macOS/Linux/WSL)
2rm -f ~/.local/bin/claude
3rm -rf ~/.local/share/claude
4
5# Homebrew
6brew uninstall --cask claude-code
7
8# NPM
9npm uninstall -g @anthropic-ai/claude-code
10
11# WinGet
12winget uninstall Anthropic.ClaudeCode

Para eliminar también los archivos de configuración:

1# Configuración del usuario
2rm -rf ~/.claude
3rm ~/.claude.json
4
5# Configuración del proyecto (ejecutar desde el directorio del proyecto)
6rm -rf .claude
7rm -f .mcp.json

Solución de problemas comunes

Error de permisos con NPM

Si obtienes EACCES: permission denied al instalar con NPM:

1# NO uses sudo. En su lugar, instala nvm:
2curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
3source ~/.bashrc  # o ~/.zshrc
4
5# Reinstala Node.js bajo tu usuario
6nvm install 22
7nvm use 22
8
9# Ahora instala Claude Code sin problemas
10npm install -g @anthropic-ai/claude-code

Claude Code no encuentra Git Bash en Windows

Asegúrate de que Git for Windows está instalado y configura la ruta manualmente si es necesario:

1{
2  "env": {
3    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
4  }
5}

Error de conexión o timeout

Claude Code necesita acceso a internet. Si estás detrás de un proxy corporativo, configura las variables de entorno estándar:

1export HTTPS_PROXY=http://tu-proxy:8080
2export HTTP_PROXY=http://tu-proxy:8080

Conclusión

Claude Code es una herramienta que puede transformar tu flujo de desarrollo. Con la instalación nativa como método recomendado, empezar es tan simple como ejecutar un solo comando. Si vienes del mundo Node.js, la opción NPM sigue disponible aunque deprecada.

Mi recomendación personal: usa el instalador nativo. Se actualiza solo, no depende de Node.js, y te garantiza siempre la última versión. Si ya lo tienes por NPM, migrar toma 30 segundos.

¿Tienes algún problema con la instalación? Revisa la guía oficial de troubleshooting o reporta tu issue en GitHub.