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).¹ {.answer-block}

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, pero WSL 2 te da la experiencia idéntica a Linux, y el instalador nativo se ejecuta ahí dentro exactamente igual.¹

¿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.

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+ nativo es compatible en x64 y ARM64, pero WSL 2 es la vía recomendada para una paridad total con Linux: ejecuta ahí dentro el comando de instalación de 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.