Cómo actualizar Claude Code a la última versión en 2026

Claude Code cambia casi todos los días. Abres el changelog más reciente y encuentras comandos nuevos, errores corregidos y mejoras de velocidad. Mientras tanto, tu terminal está ejecutando una versión de hace dos semanas y la mitad de esas mejoras simplemente no funciona. Claude tampoco te lo dice: se inicia como siempre y te preguntas por qué otras personas tienen una función que a ti te falta.

Te explicaré cómo comprobar tu versión, actualizar a la más reciente y qué hacer si la actualización no se instala. Los comandos están copiados literalmente de la documentación oficial de Claude Code y se comprobaron a principios de septiembre de 2026. En ese momento, la última versión publicada era la 2.1.261, pero tu número será distinto. No tiene sentido perseguir un número concreto; lo importante es usar una versión reciente.

Puedes encontrar información sobre cómo trabajar con Ailoot en la documentación.

¿Cómo actualizar Claude Code rápidamente a la última versión?#

A continuación explicaré cada caso con detalle, pero si tienes poco tiempo, estos tres comandos cubren casi todas las situaciones.

claude --version   # which version is installed now
claude update      # update immediately (native installation)
claude doctor      # check the installation and updates

El primero muestra tu versión, el segundo la actualiza y el tercero diagnostica problemas si algo sale mal. A continuación explicaré cuándo usar cada uno y por qué claude update no funciona para algunas personas.

¿Cómo comprobar qué versión de Claude Code está instalada ahora?#

Antes de actualizar, conviene saber desde qué versión partes. El comando es sencillo:

claude --version

Verás una línea como 2.1.211 (Claude Code). Esa es tu versión actual. Compara los dos primeros números con el número más reciente del changelog: si el tuyo es mucho más bajo, es hora de actualizar.

Si quieres una visión más amplia, ejecuta claude doctor. Solo comprueba cosas y no cambia nada: no inicia una sesión, pero muestra el estado de la instalación, los errores del archivo de configuración y advertencias con sugerencias listas para usar sobre lo que debes corregir. También muestra el resultado del último intento de actualización automática, algo útil si sospechas que la actualización en segundo plano no llegó a instalarse sin avisar.

¿Claude Code se actualiza solo?#

Todo depende de cómo instalaste Claude Code. La instalación nativa —la que recomienda Anthropic y que instala el script del sitio web— puede actualizarse sola, y la documentación lo dice explícitamente.

Así es como funciona: Claude Code busca actualizaciones al iniciarse y periódicamente mientras se está ejecutando. Si encuentra una nueva versión, la descarga y la instala en segundo plano, y la aplica la próxima vez que lo inicias. Cierra y vuelve a abrir la sesión cada pocos días y volverás a tener todo actualizado.

Puedes comprobar cómo fue el último intento en segundo plano con el mismo comando claude doctor. Te mostrará si la actualización no se instaló por algún motivo.

Pero si instalaste Claude Code mediante un gestor de paquetes —Homebrew en un MacBook, WinGet en Windows, apt o dnf en Linux—, no hay actualizaciones en segundo plano. Esas instalaciones se actualizan con el comando habitual de actualización; más abajo encontrarás una sección específica al respecto.

Una versión reciente de Claude Code es una base, pero por sí sola no te llevará muy lejos. Los resultados constantes no dependen de la versión de la herramienta, sino de cómo trabajas con ella.

¿Cómo actualizar Claude Code manualmente con un solo comando?#

No tienes que esperar a la comprobación en segundo plano para enterarte de que hay una nueva versión. Hay un comando que la actualiza ahora mismo:

claude update

Hay dos resultados posibles. Si se encuentra e instala una actualización, Claude Code mostrará una línea como Successfully updated from <old version> to version <new version>. Si ya tienes la versión más reciente, aparecerá Claude Code is up to date (<version>), lo que significa que no hay nada que actualizar.

Este comando tiene una particularidad cuando se usan gestores de paquetes. Si Claude Code se instaló mediante Homebrew, WinGet o apk, claude update da una respuesta más breve —Claude is up to date!— y no siempre descarga por sí mismo la nueva versión. Para estas instalaciones es más fiable usar el comando de actualización propio del gestor de paquetes, que se describe más abajo.

¿Cómo actualizar Claude Code instalado mediante Homebrew o WinGet?#

Si instalaste Claude Code mediante un gestor de paquetes en vez de usar el script del sitio web, eres responsable de actualizarlo. Estos son los comandos para cada sistema.

En macOS con Homebrew:

brew upgrade claude-code

Homebrew ofrece dos opciones. Instala Claude Code en dos variantes. La variante claude-code sigue el canal estable: una versión de hace aproximadamente una semana que omite las versiones con problemas importantes. La variante claude-code@latest recibe la versión más reciente en cuanto se publica. Actualiza la que instalaste: si tienes claude-code@latest, el comando será brew upgrade claude-code@latest.

En Windows con WinGet:

winget upgrade Anthropic.ClaudeCode

Con WinGet, a veces la actualización falla mientras Claude Code está en ejecución porque Windows está usando el archivo ejecutable. Claude Code simplemente te mostrará el comando manual; ciérralo y vuelve a ejecutar la actualización.

En Linux con apt, dnf o apk, no hay ningún comando aparte que tengas que aprender: la última versión llega con la actualización habitual del sistema porque Claude Code publica repositorios firmados.

Si no quieres tener que acordarte, existe la variable de entorno CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Establécela en 1 y Claude Code ejecutará la actualización en segundo plano con Homebrew y WinGet; después de una actualización correcta, te sugerirá reiniciarlo. La documentación incluye una salvedad: a veces Claude Code te avisa de una nueva versión antes de que aparezca realmente en el gestor de paquetes. Si la actualización no encuentra ninguna versión nueva, espera un poco y vuelve a intentarlo.

Por cierto, si aún estás eligiendo cómo instalar Claude Code, encontrarás una guía detallada en un artículo aparte sobre cómo instalar Claude Code, que incluye los motivos por los que el instalador nativo es más cómodo que los gestores de paquetes.

¿Por qué no se actualiza Claude Code y qué debes hacer?#

A veces actualizas una y otra vez, pero claude --version sigue mostrando obstinadamente el número antiguo. Repasaré las causas principales, empezando por la más común.

Lo primero que debes comprobar es si tienes varias instalaciones de Claude Code a la vez. Puede ocurrir si primero lo instalaste mediante npm y después lo volviste a instalar de forma nativa. El comando actualiza una copia, pero el terminal inicia otra, así que parece que la versión no cambia. Comprueba cuántas copias tienes:

which -a claude

Claude Code puede estar en tres lugares: ~/.local/bin/claude corresponde al instalador nativo, ~/.claude/local/ es la antigua instalación local de npm de las primeras versiones, y el paquete global de npm aparece con el comando npm -g ls @anthropic-ai/claude-code. Si encuentras más de una, conserva solo una, preferiblemente la instalación nativa. Elimina las demás así:

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

La segunda causa habitual es que la carpeta global de npm no permite escritura. Si instalaste Claude Code globalmente con npm y no tiene permiso para escribir en su carpeta, la actualización en segundo plano no se instalará. Claude Code muestra una notificación única al iniciarse, y claude doctor indica exactamente qué debes corregir. Esa es otra razón para preferir la instalación nativa: escribe en tu carpeta de inicio y no necesita esos permisos.

La tercera situación es que en algún momento sustituyeras el lanzador ~/.local/bin/claude por tu propio script o enlace simbólico. Desde la versión 2.1.207, las actualizaciones automáticas lo dejan intacto: las nuevas versiones se siguen instalando en ~/.local/share/claude/versions/, pero tu script decide cuál se inicia. No borres tu único lanzador para llamar después a claude update por su nombre. Conserva primero una copia del lanzador personalizado y, si es un enlace, de su destino en otra ubicación de respaldo sin usar. Retíralo de su ruta original solo después de verificar la copia. Restaura el lanzador nativo mediante el instalador oficial, que no depende de un comando claude existente:

# macOS, Linux o WSL: instalador nativo oficial
curl -fsSL https://claude.ai/install.sh | bash

Al terminar, abre una terminal nueva y verifica el resultado:

claude --version
claude doctor

El primer comando debe imprimir una versión. Revisa en doctor los avisos del lanzador o PATH antes de continuar; no elimines el lanzador conservado hasta que funcione su sustituto.

Otro síntoma es que claude update o claude doctor se queda bloqueado justo después de la línea Checking for updates. En versiones antiguas (anteriores a la 2.1.214), esto ocurría a veces cuando uno de los archivos de configuración del shell, como ~/.zshrc, era un directorio en vez de un archivo. Las versiones recientes ya omiten este caso, por lo que actualizar a la última versión también corrige el error.

¿Cómo elegir un canal de actualización: latest o stable?#

Actualizar a la última versión no siempre significa obtener el build más reciente desde el primer día. Claude Code te permite elegir entre dos canales, lo que determina exactamente qué recibes al actualizar.

El canal latest es el predeterminado. Las nuevas funciones llegan en cuanto se publican, lo cual viene bien si quieres probarlas antes que nadie. El canal stable ofrece una versión de hace aproximadamente una semana: ha tenido tiempo para asentarse y omite las versiones con problemas importantes. Es la opción para quienes valoran más la tranquilidad que la rapidez.

La forma más sencilla de cambiar de canal es usar el comando /config dentro de Claude Code, en Auto-update channel. También puedes introducirlo manualmente en el archivo de configuración settings.json:

{
  "autoUpdatesChannel": "stable"
}

Si estás configurando Claude Code para adaptarlo a tus hábitos, hay una guía aparte sobre cómo personalizar Claude Code, que trata el archivo de configuración en su conjunto, no solo el canal de actualización.

¿Cómo instalar una versión específica o establecer una versión mínima?#

A veces necesitas una versión específica en vez de la última; por ejemplo, para volver a una versión con la que tu flujo de trabajo funcionaba con seguridad. El instalador nativo lo permite: acepta tanto el nombre de un canal como un número de versión exacto. Instala una versión específica así:

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

En Windows, el comando equivalente en PowerShell es algo distinto:

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

Puedes instalar el canal estable de la misma manera: escribe stable en vez de un número. El canal que elijas durante la instalación se convierte en el canal predeterminado para futuras actualizaciones automáticas.

Si quieres evitar volver a una versión anterior, establece una versión mínima en settings.json:

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

Este es el límite inferior. Ni una actualización en segundo plano ni claude update instalará una versión inferior a la especificada. Esto resulta útil si cambias a stable y no quieres volver a una versión anterior a la que ya estás usando.

¿Cómo desactivar las actualizaciones automáticas si te estorban?#

A veces las actualizaciones en segundo plano estorban, por ejemplo, cuando quieres que tu equipo use exactamente una versión. Puedes desactivarlas mediante el archivo de configuración:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Un detalle importante: DISABLE_AUTOUPDATER silencia únicamente la comprobación en segundo plano. El comando claude update seguirá funcionando, así que podrás actualizar manualmente. Si necesitas bloquear todas las vías de actualización de una vez, incluidas las manuales, existe una variable más estricta, DISABLE_UPDATES. Se utiliza cuando distribuyes Claude Code por tu propio canal y quieres que todos se queden exactamente con la versión que proporcionaste.

Para el uso habitual por tu cuenta, es mejor no cambiar estas variables: una versión reciente de Claude Code casi siempre es mejor que una antigua, y una actualización puede incluir una corrección de seguridad. Mantener la herramienta actualizada forma parte de conservar el acceso y evitar errores extraños; hay un artículo aparte sobre cómo evitar perder tu cuenta de Claude.

¿Por dónde empezar?#

Aquí tienes un plan breve.

1. Comprueba tu versión actual: claude --version. Compárala con el número más reciente del changelog.
2. Actualiza. Instalación nativa: claude update. Homebrew: brew upgrade claude-code. WinGet: winget upgrade Anthropic.ClaudeCode.
3. Reinicia la sesión de Claude Code para que se aplique la nueva versión.
4. Si la versión no ha cambiado, ejecuta claude doctor y which -a claude. Probablemente tengas varias instalaciones o una carpeta npm que no permite escritura.
5. Elige el canal que más te convenga: latest si quieres las nuevas funciones en cuanto aparezcan o stable si te importa más la previsibilidad. Cámbialo mediante /config.

Una versión reciente corrige errores y añade comandos nuevos, pero una herramienta actualizada no construirá tu proyecto por ti. La guía sobre alternativas a Claude Code explica en qué se diferencia Claude Code de otros agentes de terminal y cuándo conviene plantearse otras opciones.

Conoce Ailoot.