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

Para instalar Claude Code, ejecuta el instalador nativo de Anthropic en una terminal (un comando para macOS, Linux y WSL, otro para Windows PowerShell y otro para Windows CMD; los tres están más abajo), después inicia Claude Code en la carpeta de tu proyecto e inicia sesión en el navegador. Necesitas un plan Claude Pro, Max, Team o Enterprise, una cuenta de Claude Console (API) o acceso a través de Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry, porque el plan gratuito de Claude no incluye Claude Code. Node.js solo es necesario si eliges el método npm.

Esta guía cubre todos los métodos de instalación oficiales, cómo comprobar la instalación, el primer inicio de sesión, las particularidades de Windows y Alpine, y soluciones para los errores que más aparecen en la página de solución de problemas de Anthropic. Todos los comandos se comprobaron con la documentación de Claude Code de Anthropic el 17 de octubre de 2026.

Antes de instalar: requisitos de cuenta y de sistema

Qué cuenta necesitas

Si no tienes claro si te basta un plan gratuito, nuestra guía ¿Claude es gratis? explica qué cubre el nivel gratuito. Los estudiantes y los mantenedores de código abierto deberían revisar las páginas de ofertas de Claude para estudiantes y Claude for Open Source antes de pagar.

Requisitos del sistema

• Sistema operativo: macOS 13.0+, Windows 10 1809+ o Windows Server 2019+, Ubuntu 20.04+, Debian 10+ o Alpine Linux 3.19+
• Hardware: 4 GB+ de RAM, procesador x64 o ARM64 (Windows de 32 bits no es compatible)
• Shell: Bash, Zsh, PowerShell o CMD
• Red y ubicación: conexión a internet, en un país en el que Anthropic tenga servicio
• ripgrep: normalmente viene incluido con Claude Code; en Alpine hay que instalarlo aparte (ver más abajo)

Paso 1: elige un método de instalación

La mayoría debería usar el instalador nativo. Es el método que recomienda Anthropic, se mantiene actualizado solo y no necesita ningún otro software. Los gestores de paquetes tienen sentido si tu equipo ya gestiona las herramientas así o si quieres actualizar cuando tú decidas.

Paso 2: ejecuta el instalador nativo

Abre una terminal y ejecuta el comando correspondiente a tu sistema.

macOS, Linux y WSL

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

Windows PowerShell

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

Windows CMD

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

En Windows, el prompt muestra PS C:\ en PowerShell y C:\ sin PS en CMD. Si ves "The token '&&' is not a valid statement separator", estás en PowerShell, así que usa el comando de PowerShell. Si ves "'irm' is not recognized", estás en CMD.

El instalador no muestra progreso mientras descarga, así que espera a que termine. En macOS y Linux coloca el lanzador claude en ~/.local/bin/claude y guarda las versiones en ~/.local/share/claude/versions/. En Windows el programa va a %USERPROFILE%\.local\bin\claude.exe. No necesitas permisos de administrador.

Instalar el canal stable

Por defecto obtienes el canal latest, que publica las nuevas versiones al momento. El canal stable ofrece una versión que suele tener una semana y se salta las versiones con regresiones importantes. El canal que elijas al instalar pasa a ser el predeterminado para las actualizaciones automáticas. macOS, Linux y WSL:

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

Windows PowerShell:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Windows CMD:

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

También puedes indicar un número de versión concreto en lugar de stable. Nuestra guía de actualización explica cómo fijar versiones, cambiar de canal más adelante y volver a una versión anterior.

Otros métodos de instalación oficiales

Homebrew (macOS y Linux)

brew install --cask claude-code

El cask claude-code sigue el canal stable. Para recibir las nuevas versiones en cuanto salen, instala el cask latest:

brew install --cask claude-code@latest

WinGet (Windows)

winget install Anthropic.ClaudeCode

apt (Debian y Ubuntu)

Anthropic publica repositorios firmados de apt, dnf y apk. Estos comandos configuran el canal stable. Primero, si faltan curl o gpg en un sistema recién instalado:

sudo apt install curl gnupg

Descarga la clave de firma:

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

Comprueba la clave antes de confiar en ella. La huella debe ser 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE:

gpg --show-keys /etc/apt/keyrings/claude-code.asc

Registra el repositorio e instala:

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

dnf (Fedora y RHEL)

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

dnf te pide confirmar la huella de la clave en la primera instalación. Debe coincidir con 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.

apk (Alpine Linux)

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

npm

El paquete de npm requiere Node.js 22 o posterior. Con un Node.js más antiguo, npm muestra un aviso EBADENGINE, pero la instalación se completa igualmente:

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

El paquete de npm instala el mismo binario nativo que el instalador independiente, a través de una dependencia opcional por plataforma, y el comando claude instalado no usa Node en tiempo de ejecución. Las plataformas npm compatibles son darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 y win32-arm64, y tu gestor de paquetes debe permitir dependencias opcionales.

No uses sudo con una instalación global de npm. Anthropic advierte de que puede causar problemas de permisos y riesgos de seguridad. Si te da errores de permisos, cambia al instalador nativo o sigue la página oficial de solución de problemas.

Paso 3: comprueba la instalación

Abre una ventana de terminal nueva (la anterior conserva su PATH antiguo) y ejecuta:

claude --version

Una instalación correcta muestra un número de versión seguido de (Claude Code). Si tu shell dice que no encuentra claude, la carpeta de instalación aún no está en tu PATH; la sección de solución de problemas de abajo tiene el arreglo. Para una comprobación de estado más completa, de solo lectura y sin iniciar una sesión, que también informa de errores y avisos en los archivos de configuración con soluciones sugeridas, ejecuta:

claude doctor

Paso 4: inicia Claude Code e inicia sesión

Ve a la carpeta de tu proyecto e inicia una sesión:

cd /path/to/your/project
claude

En el primer arranque, Claude Code abre una ventana del navegador para iniciar sesión. Si el navegador no se abre, pulsa c para copiar la URL de inicio de sesión y pégala en un navegador. Cuando termina, la terminal muestra Login successful y te pide que pulses Enter. Estas cuentas funcionan:

• Claude Pro, Max, Team o Enterprise: inicia sesión con tu cuenta de claude.ai. El uso cuenta para los límites de tu plan.
• Claude Console: facturación de API con pago por uso. Si te unes a la organización de la Console de otra persona, un administrador tiene que invitarte primero. En el primer inicio de sesión, Claude Code crea un workspace "Claude Code" en la Console para seguir los costes.
• Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry: configura las variables de entorno del proveedor o elige 3rd-party platform (plataforma de terceros) en el aviso de inicio de sesión. No hace falta iniciar sesión en el navegador.

Si ANTHROPIC_API_KEY está configurada y la apruebas cuando te lo pregunte, Claude Code se salta el inicio de sesión en el navegador y cobra de tus créditos de API; nuestra guía de la clave de API de Anthropic explica cómo crear una y añadirle saldo. Para cambiar de cuenta más adelante, escribe esto dentro de una sesión:

/login

Iniciar sesión por SSH, en WSL2 o en un contenedor

En estos casos el navegador suele abrirse en otra máquina y no puede redirigir de vuelta a Claude Code. Después de iniciar sesión, el navegador muestra un código de inicio de sesión; pégalo en el aviso Paste code here if prompted. Si pegarlo en el aviso no funciona, inicia sesión con este comando, que lee el código pegado desde la entrada estándar:

claude auth login

Si el navegador no se abre en absoluto desde WSL2, apunta la variable BROWSER a tu navegador de Windows, por ejemplo:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Prueba una primera tarea

El inicio rápido de Anthropic sugiere empezar con preguntas en lenguaje natural sobre tu código. Escribe prompts como estos en Claude Code:

what does this project do?
where is the main entry point?
add a hello world function to the main file

Claude Code lee los archivos que necesita y pregunta antes de hacer cambios, según el modo de permisos de la sesión (pulsa Shift+Tab para cambiar de modo). Para cambios más grandes, consulta nuestra guía del plan mode de Claude Code.

Instalar Claude Code en Windows

Puedes ejecutar Claude Code de forma nativa en Windows o dentro de WSL:

• No necesitas ejecutar el instalador como Administrador.
• Sin Git for Windows, Claude Code ejecuta los comandos de shell con su herramienta de PowerShell. Si lo tienes instalado, Claude Code también puede usar Git Bash para su herramienta Bash.
• Para WSL, abre tu distribución de WSL y ejecuta allí el instalador de Linux. Instala y lanza claude dentro de WSL, no desde PowerShell ni CMD.
• Si una instalación antigua de Claude Desktop hace que el comando claude abra la app de escritorio en lugar del CLI, actualiza Claude Desktop a la última versión.

Si Claude Code no encuentra Git Bash, indica su ruta en tu archivo settings.json:

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

Instalar en Alpine y otros Linux basados en musl

El comando de instalación necesita bash y curl, y Claude Code necesita libgcc, libstdc++ y ripgrep en tiempo de ejecución. Alpine no incluye bash ni curl por defecto, así que instala primero los paquetes:

apk add bash curl libgcc libstdc++ ripgrep

ripgrep está en el repositorio community de Alpine; añádelo a /etc/apk/repositories si apk no encuentra el paquete. Después indica a Claude Code que use el ripgrep del sistema en settings.json:

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Solución de problemas de instalación

Estos son los problemas que más trata la página de solución de problemas de instalación de Anthropic, con las soluciones oficiales.

"command not found: claude" o "'claude' is not recognized"

La instalación funcionó, pero su carpeta no está en tu PATH. Primero abre una terminal nueva. Si sigue fallando en macOS o Linux, comprueba que el archivo existe:

ls -la ~/.local/bin/claude

Si existe, añade la carpeta a tu PATH. Para Zsh, el predeterminado de macOS:

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

Para Bash en Linux:

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

Para Bash en macOS, usa ~/.bash_profile en lugar de ~/.bashrc, porque Terminal inicia Bash como shell de inicio de sesión. En Windows PowerShell, añade la carpeta de instalación al PATH de tu usuario y reinicia la terminal:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Una terminal dentro de un editor como VS Code toma su PATH del editor, así que cierra y vuelve a abrir también el editor. Ten en cuenta que la extensión de VS Code incluye su propia copia privada de Claude Code y no pone claude en tu PATH; ejecuta el instalador independiente si quieres el comando en una terminal.

"syntax error near unexpected token '<'" o un 403 del instalador

La URL de instalación devolvió una página web o un error en lugar del script. Si la salida menciona App unavailable in region, Claude Code no está disponible en tu país. Si no, suele ser un problema temporal, un proxy o cortafuegos, o el enrutamiento regional. Vuelve a intentarlo en unos minutos, comprueba que llegas al servidor de descarga o usa Homebrew o WinGet. Para probar la conectividad en macOS o Linux:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Si la primera línea tiene un estado 200, has llegado al servidor. Detrás de un proxy corporativo, configura HTTP_PROXY y HTTPS_PROXY con la dirección de tu proxy antes de ejecutar el instalador.

"Killed" durante la instalación en un servidor Linux pequeño

El out-of-memory killer detuvo la instalación. Anthropic dice que la instalación necesita unos 512 MB de memoria libre, y Claude Code requiere al menos 4 GB de RAM para funcionar. Cierra otros procesos, usa una instancia más grande o añade espacio de swap y vuelve a intentarlo:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

La instalación se queda colgada en Docker

Ejecutar el instalador como root desde / hace que recorra todo el sistema de archivos. Fija antes un directorio de trabajo:

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

Errores de TLS o SSL

Errores como curl: (35) TLS connect error o el Could not create SSL/TLS secure channel de PowerShell significan que falló la conexión segura. En Ubuntu o Debian, actualiza tus certificados de CA:

sudo apt-get update && sudo apt-get install ca-certificates

En Windows PowerShell 5.1, activa TLS 1.2 en la misma ventana antes de ejecutar el instalador:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Detrás de un proxy corporativo que inspecciona TLS, pide a IT el certificado de CA del proxy y apunta NODE_EXTRA_CA_CERTS a él una vez instalado Claude Code.

Homebrew dice que el cask no está disponible

Tu índice local de Homebrew es más antiguo que el cask. Actualízalo y vuelve a intentarlo:

brew update
brew install --cask claude-code

npm: "claude native binary not installed" o scripts desactivados

El paquete de npm entrega el binario real como dependencia opcional y lo enlaza con un paso postinstall. Si instalaste con --omit=optional o --ignore-scripts (o con una configuración de pnpm que los omite), reinstala sin esas opciones. En Windows, "running scripts is disabled on this system" se debe a que la política de ejecución de PowerShell bloquea los shims .ps1 de npm; permite los scripts creados localmente para tu usuario o usa el instalador nativo:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Sigue ejecutándose una versión antigua después de instalar

Probablemente tienes dos instalaciones, por ejemplo una instalación antigua con npm y una nueva nativa. En macOS o Linux, lista todos los claude de tu PATH:

which -a claude

Quédate con una (Anthropic recomienda la nativa) y elimina las demás, por ejemplo la copia de npm:

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

Problemas al iniciar sesión

• API Error: 403 Request not allowed después de iniciar sesión: en Pro o Max, comprueba que tu suscripción está activa en la configuración de claude.ai. En cuentas de la Console, un administrador debe darte el rol Claude Code o Developer en la página Members.
• OAuth error: Invalid code: el código caducó o se cortó. Vuelve a intentarlo y termina rápido, o pulsa c para copiar la URL completa.
• "This organization has been disabled" aunque tienes una suscripción activa: una ANTHROPIC_API_KEY antigua en tu perfil de shell está sobrescribiendo tu inicio de sesión. Quítala de tu perfil y elimínala con unset (el comando está en nuestra guía de la clave de API).
• Se cierra la sesión una y otra vez: comprueba que el reloj de tu sistema es correcto, ya que la validación de tokens depende de él, y vuelve a iniciar sesión.

Para reiniciar el inicio de sesión desde cero, escribe esto dentro de Claude Code, ciérralo, ejecuta claude de nuevo e inicia sesión:

/logout

¿Prefieres no usar una terminal?

Anthropic también ofrece Claude Code en una app de escritorio para macOS, Windows y Linux, en la web en claude.ai/code y como extensiones para VS Code y los IDE de JetBrains. Sigues necesitando un plan de pago elegible o una cuenta de la Console. Para mantener actualizada la versión de línea de comandos, consulta cómo actualizar Claude Code.