Instalar y actualizar Claude Code CLI: Mac, Linux, Windows

Instalar Claude Code es un solo comando por plataforma – curl -fsSL https://claude.ai/install.sh | bash en macOS, Linux y WSL, o irm https://claude.ai/install.ps1 | iex en Windows PowerShell – y actualizar es automático (el comportamiento predeterminado) o un simple claude update. Lo que casi todas las páginas se saltan es todo lo que viene después de ese primer comando: qué método de instalación elegir cuando tienes cuatro, cómo se comporta el autoupdater y cómo desactivarlo, cómo fijar una versión concreta y cómo desinstalar cada método sin dejar restos. Esta página es esa referencia, una tabla por tarea, actualizada a la v2.1.224 (agosto de 2026).¹

TL;DR

• Usa el instalador nativo. No tiene ninguna dependencia de Node.js, entrega el binario probado de cada plataforma y es la opción predeterminada desde la v2.1.113. El paquete npm es la vía heredada – obsoleta desde la v2.1.15, y ahora exige Node.js 22 o superior.¹
• Las actualizaciones son automáticas de forma predeterminada: Claude Code comprueba al arrancar y de forma periódica durante las sesiones, descarga en segundo plano y aplica el cambio en el siguiente inicio. claude update fuerza una ahora mismo.²
• Desactivar las actualizaciones son dos interruptores distintos: DISABLE_AUTOUPDATER=1 detiene las actualizaciones en segundo plano; DISABLE_UPDATES=1 (v2.1.118+) bloquea todas las vías de actualización, incluido un claude update manual.²
• Fija una versión pasándosela al instalador: curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58. Comprueba cuál estás ejecutando con claude --version; revisa qué cambió con /release-notes.¹²
• Cuando algo se comporte raro, ejecuta claude doctor – informa del tipo de instalación, la versión y los problemas detectados, y desde la v2.1.205 el comando /doctor dentro de la sesión diagnostica y corrige los fallos de configuración.²

¿Cómo instalo Claude Code CLI?

Un comando, según la plataforma:

# macOS, Linux, 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

¿Prefieres un gestor de paquetes? Los dos son ciudadanos de primera clase:

brew install --cask claude-code          # macOS / Linux (stable channel)
winget install Anthropic.ClaudeCode      # Windows

Después ejecuta claude en el directorio de un proyecto y autentícate con una suscripción Claude Pro/Max/Team o una cuenta de la API de Anthropic.¹ El instalador nativo no necesita Node.js, ni sudo, ni nada preinstalado. Si tienes que recurrir a la vía heredada de npm (npm install -g @anthropic-ai/claude-code), esa exige Node.js 22 o superior y nunca debe ejecutarse con sudo: los módulos globales que quedan en manos de root generan problemas de permisos que sobreviven a la instalación.¹ ¿Ya estás en npm? claude install te migra al binario nativo sin moverte de sitio.

Para la puesta a punto de la primera sesión – opciones de autenticación, el primer prompt, los modos de permisos –, el recorrido de inicio rápido cubre el camino desde cero hasta el primer resultado.

¿Qué plataformas admite Claude Code?

La pregunta recurrente sobre Windows: el Windows nativo funciona y no necesita derechos de administrador; la propia recomendación de Anthropic es elegir según dónde viven tus proyectos y qué necesitas, con WSL 2 cuando quieres toolchains de Linux o ejecución de comandos en sandbox, y ahí dentro se ejecuta el mismo instalador de Linux.³ El modo automático de Claude Code no es una frontera de seguridad sostiene que la verdadera frontera es el aislamiento del sistema operativo, no el modo automático.

¿Cómo actualizo Claude Code?

Normalmente no tienes que hacer nada. Claude Code se actualiza solo de forma predeterminada – busca una versión nueva al arrancar y de forma periódica durante las sesiones, descarga en segundo plano y aplica la actualización la próxima vez que se inicia.² Para forzar una actualización de inmediato, o si has desactivado el autoupdater:

claude update

Las instalaciones hechas con un gestor de paquetes se actualizan por su propio canal – brew upgrade --cask claude-code, winget upgrade Anthropic.ClaudeCode – y desde la v2.1.129, definir CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 permite que esas instalaciones ejecuten la actualización del gestor de paquetes en segundo plano y te pidan reiniciar.²

Controlar las actualizaciones son dos interruptores distintos, y la diferencia importa en entornos blindados:

Define cualquiera de los dos como variable de entorno o dentro de "env" en settings.json.²

¿Cómo instalo una versión concreta?

Pásale la versión al instalador – útil para reproducir un error, mantener a un equipo en una versión que sabes que funciona, o volver atrás:

# Specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Latest, explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell, specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Confírmalo con claude --version y lee qué cambió cada versión con el selector /release-notes dentro de la sesión.² Si fijas una versión, combínalo con DISABLE_AUTOUPDATER=1: de lo contrario, el autoupdater te desfijará amablemente en el siguiente inicio. (Usa DISABLE_UPDATES=1 cuando además quieras dejar bloqueado el claude update manual.)

¿Cómo desinstalo Claude Code?

Haz coincidir la desinstalación con el método de instalación:

Tu configuración vive aparte en ~/.claude/, así que eliminar el binario no borra los ajustes, ni las skills, ni el historial: borra también ese directorio solo si quieres empezar de verdad desde cero.¹

Todo el ciclo de vida en una sola tabla

Y cuando algo va mal – una versión equivocada en el informe, un comando que no aparece tras una actualización, una instalación aplicada a medias –, claude doctor desde la shell informa del tipo de instalación, la versión y los problemas detectados, mientras que /doctor dentro de una sesión (v2.1.205+) hace una revisión completa capaz de arreglar lo que encuentra.² La guía completa de Claude Code cubre todo lo que viene después de la instalación: configuración, permisos, hooks, MCP y subagentes.

Solución de problemas en Windows: claude no reconocido, shell equivocada, scripts bloqueados

La mayoría de los fallos en Windows son uno de nueve, y cada uno tiene un mensaje de error reconocible. Todas las soluciones de abajo provienen de la página de solución de problemas de instalación y de la página de configuración de Anthropic, tal como estaban el 7 de septiembre de 2026.³⁴

1. 'claude' is not recognized as an internal or external command (CMD) o The term 'claude' is not recognized as the name of a cmdlet (PowerShell). El instalador dejó claude.exe en %USERPROFILE%\.local\bin\claude.exe; ese directorio no está en tu PATH, o sigues en la terminal desde la que instalaste, que conserva su PATH anterior. Compruébalo, agrégalo y luego abre una terminal nueva:⁴

$env:PATH -split ';' | Select-String '\.local\\bin'      # no output = not on PATH
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

En CMD la comprobación es echo %PATH% | findstr /i "local\bin", y la solución es agregar %USERPROFILE%\.local\bin al PATH del usuario en Variables de entorno.⁴

2. 'irm' is not recognized, The token '&&' is not a valid statement separator o A parameter cannot be found that matches parameter name 'fsSL'. Ejecutaste la línea de instalación de otra shell. Si falta irm, estás en CMD (el prompt dice C:\): usa el instalador de CMD de arriba o abre PowerShell (PS C:\). Si se rechaza &&, estás en PowerShell ejecutando la línea de CMD: usa irm https://claude.ai/install.ps1 | iex. La queja sobre fsSL significa que pegaste en PowerShell la línea curl -fsSL ... | bash de macOS/Linux, y ahí curl es un alias de Invoke-WebRequest. Si el comando imprime el texto del script y no instala nada, ejecutaste la mitad que lo descarga sin la parte que lo ejecuta.⁴

3. running scripts is disabled on this system / PSSecurityException. La política de ejecución de PowerShell está bloqueando los shims lanzadores .ps1 que crea npm (npm.ps1, claude.ps1). No afecta al instalador nativo, que pasa el texto descargado por iex en lugar de ejecutar un archivo guardado, y un ClaudeInstall.ps1 guardado y ejecutado con -ExecutionPolicy Bypass -File no es una de las vías de instalación documentadas por Anthropic (la página de configuración solo enumera la línea irm, el instalador de CMD, WinGet y npm). Las soluciones, por orden: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser; o llamar a claude.cmd (la política no cubre los .cmd); o reemplazar la instalación de npm por el instalador nativo.⁴

4. Errores de análisis de iex que citan etiquetas HTML o CSS, o curl: (22) The requested URL returned error: 403. La URL de instalación devolvió una página web en lugar del script. Si la página dice «App unavailable in region», Claude Code no está disponible en tu país; si no, hay un proxy o un filtro de por medio. Comprueba la conectividad con curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest (llama a curl.exe de forma explícita: el alias curl de PowerShell rechaza -sI); si la primera línea es un 200, el host es accesible y el fallo fue pasajero. winget install Anthropic.ClaudeCode es la alternativa documentada.⁴

5. Could not establish trust relationship for the SSL/TLS secure channel, o CRYPT_E_NO_REVOCATION_CHECK (0x80092012). Para el primero, fuerza TLS 1.2 antes del instalador: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12. Los errores de revocación significan que tu red bloquea las consultas de revocación de certificados; agrega --ssl-revoke-best-effort a la línea curl de CMD, o usa el instalador de PowerShell, que descarga a través de .NET y tolera que el servidor de revocación no responda.⁴

6. The process cannot access the file ... because it is being used by another process. Un instalador anterior sigue en ejecución o el antivirus está analizando una descarga parcial en %USERPROFILE%\.claude\downloads. Cierra las demás ventanas de PowerShell, espera a que termine el análisis y luego:⁴

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

7. Se ejecuta la versión equivocada, o dos instalaciones no coinciden. where.exe claude enumera cada claude que hay en tu PATH; Test-Path "$env:USERPROFILE\.local\bin\claude.exe" indica si el instalador nativo dejó su binario. Conserva el nativo y elimina el resto (winget uninstall Anthropic.ClaudeCode, npm uninstall -g @anthropic-ai/claude-code, Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local" para una instalación local heredada de npm). claude doctor muestra el tipo de instalación y la versión que realmente está ejecutando.⁴

8. Claude Code on Windows requires either Git for Windows (for bash) or PowerShell. No se encontró ninguna de las dos shells. Git for Windows es opcional: sin él, Claude Code ejecuta los comandos con su herramienta PowerShell; con él, la herramienta Bash usa Git Bash. Si Git Bash está instalado pero no se encuentra, indícale la ruta en settings.json:³

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

9. Claude Code does not support 32-bit Windows. Abriste la entrada x86 de PowerShell en una computadora de 64 bits. Abre «Windows PowerShell», no la de «(x86)».⁴

Si ninguno de estos casos coincide, claude doctor (de solo lectura, sin iniciar una sesión) informa del estado de la instalación, de los errores en los archivos de configuración y del resultado del último intento de actualización, y la página de solución de problemas de Anthropic mantiene la tabla completa de errores y soluciones.³⁴

Preguntas frecuentes

¿Cómo actualizo Claude Code CLI a la última versión?

Ejecuta claude update, o simplemente reinicia: de forma predeterminada, Claude Code busca actualizaciones al arrancar y durante las sesiones, las descarga en segundo plano y las aplica en el siguiente inicio. Las instalaciones con Homebrew y winget se actualizan con brew upgrade --cask claude-code y winget upgrade Anthropic.ClaudeCode.

¿Claude Code se actualiza automáticamente?

Sí, de forma predeterminada: comprueba al arrancar y de forma periódica mientras se ejecuta, y luego aplica la actualización descargada en el siguiente inicio. DISABLE_AUTOUPDATER=1 desactiva las actualizaciones en segundo plano y conserva el claude update manual; DISABLE_UPDATES=1 bloquea todas las vías de actualización.

¿Cómo instalo Claude Code en Windows?

Ejecuta irm https://claude.ai/install.ps1 | iex en PowerShell (o winget install Anthropic.ClaudeCode). Windows 10 (1809+) nativo es compatible en x64 y ARM64 sin derechos de administrador; elige WSL 2 cuando necesites toolchains de Linux o ejecución de comandos en sandbox, y ejecuta ahí dentro el comando de instalación de Linux para una paridad total con Linux.

¿Necesito Node.js para instalar Claude Code?

No – el instalador nativo recomendado no tiene ninguna dependencia de Node.js. Solo el paquete npm heredado (npm install -g @anthropic-ai/claude-code, obsoleto desde la v2.1.15) necesita Node, y exige Node.js 22 o superior. Si estás en la instalación de npm, claude install te migra al binario nativo.

¿Cómo compruebo qué versión de Claude Code tengo?

claude --version desde la shell, o /release-notes dentro de una sesión para abrir un selector interactivo del changelog. claude doctor informa además del tipo de instalación y de cualquier problema de configuración detectado.