# Cómo actualizar Claude Code a la última versión en 2026 > Cómo comprobar la versión de Claude Code, actualizarla con el comando claude update, instalar la versión más reciente mediante Homebrew o WinGet y qué hacer si no se actualiza. Source: https://ailoot.ai/blog/es/update-claude-code/ Canonical: https://ailoot.ai/blog/es/update-claude-code/ Language: es Publisher: Ailoot (https://ailoot.ai/) Translation: guide-130 Revision: sha256-0a5c2da1a717c1cb6a08dd3576d9b68a77d4d436766a5b4dd5a42ba9e2433219 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](https://ailoot.ai/docs/). ## ¿Cómo actualizar Claude Code rápidamente a la última versión?
Lo esencial La respuesta breve es esta. Si instalaste Claude Code con el instalador nativo, se actualiza en segundo plano, así que no tienes que hacer nada manualmente. Para actualizarlo ahora mismo sin esperar a la comprobación en segundo plano, escribe claude update en la terminal. Si lo instalaste mediante Homebrew, WinGet o un gestor de paquetes de Linux, no hay actualizaciones automáticas: cada uno tiene su propio comando, como brew upgrade claude-code. Siempre puedes comprobar si tienes la última versión ejecutando claude --version.
A continuación explicaré cada caso con detalle, pero si tienes poco tiempo, estos tres comandos cubren casi todas las situaciones. ```bash 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?
Lo esencial Escribe claude --version en la terminal. El comando muestra un número de versión con un formato como 2.1.211 (Claude Code) y no inicia nada. Es la forma más rápida de saber si estás usando una versión anterior a la última. Si quieres un diagnóstico más detallado —el estado de la instalación, errores de configuración y advertencias—, hay un comando aparte, claude doctor, que tampoco inicia una sesión.
Antes de actualizar, conviene saber desde qué versión partes. El comando es sencillo: ```bash 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?
Lo esencial Si instalaste Claude Code con el instalador nativo (el conocido comando curl con el script install.sh, o install.ps1 en Windows), entonces sí: se actualiza solo. Claude Code busca actualizaciones al iniciarse y de vez en cuando mientras está en ejecución, descarga la nueva versión en segundo plano y la aplica la próxima vez que lo inicias. Solo tienes que reiniciar la sesión de vez en cuando. En cambio, las instalaciones mediante Homebrew, WinGet y los gestores de paquetes de Linux no se actualizan solas; necesitan un comando manual.
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.

Las instalaciones nativas se actualizan automáticamente en segundo plano para que tengas siempre la última versión.

— Claude Code Docs, Advanced setup, documentación oficial
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?
Lo esencial Escribe claude update. El comando aplica la actualización inmediatamente, sin esperar a la comprobación en segundo plano. Si encuentra una nueva versión, verás un mensaje que confirma que la actualización de la versión anterior a la nueva se realizó correctamente. Si ya tienes la última versión, aparecerá la línea Claude Code is up to date con el número actual. El comando funciona tanto con instalaciones nativas como con gestores de paquetes, pero Homebrew y WinGet responden de forma ligeramente distinta.
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: ```bash claude update ``` Hay dos resultados posibles. Si se encuentra e instala una actualización, Claude Code mostrará una línea como `Successfully updated from to version `. Si ya tienes la versión más reciente, aparecerá `Claude Code is up to date ()`, 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?
Lo esencial Los gestores de paquetes no actualizan Claude Code automáticamente, así que tienes que ejecutar el comando de actualización por tu cuenta. En un MacBook con Homebrew, es brew upgrade claude-code. En Windows con WinGet, es winget upgrade Anthropic.ClaudeCode. En Linux con apt, dnf o apk, la actualización llega con la actualización habitual del sistema. Si quieres que Claude Code ejecute la actualización por sí mismo con Homebrew y WinGet, establece en uno la variable de entorno CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE.
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: ```bash 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: ```powershell 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. | Método de instalación | Comando de actualización | |----------------------|----------------| | Instalador nativo | se actualiza solo o `claude update` | | Homebrew (macOS) | `brew upgrade claude-code` | | WinGet (Windows) | `winget upgrade Anthropic.ClaudeCode` | | apt / dnf / apk (Linux) | actualización habitual del sistema | 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](https://ailoot.ai/blog/es/install-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?
Lo esencial Suele haber tres causas posibles. Primero, tienes varias instalaciones de Claude Code que entran en conflicto: el comando actualiza una, pero se inicia otra. Segundo, la carpeta global de npm no permite escritura, por lo que la actualización en segundo plano falla sin avisar. Tercero, puede que hayas sustituido el lanzador por un script propio. Empieza a solucionar el problema con claude doctor y el comando which -a claude; te muestran exactamente dónde está el problema.
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: ```bash 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í: ```bash 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](https://code.claude.com/docs/en/setup#install-claude-code), que no depende de un comando `claude` existente: ```bash # 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: ```bash 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?
Lo esencial Claude Code tiene dos canales de actualización. Latest es el canal predeterminado; las nuevas funciones llegan en cuanto se publican. Stable corresponde a una versión de hace aproximadamente una semana y omite las versiones con problemas importantes. Si te importan más las funciones nuevas, quédate en latest. Si priorizas la previsibilidad y no quieres encontrarte con versiones poco pulidas, cambia a stable. Puedes cambiarlo con la opción autoUpdatesChannel del archivo settings.json o con el comando /config.
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`: ```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](https://ailoot.ai/blog/es/claude-personalization-profile-memory/), 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?
Lo esencial El instalador nativo acepta tanto el nombre de un canal como un número de versión exacto. Para instalar una versión específica, añade su número al final del comando de instalación, por ejemplo, bash -s 2.1.89. También puedes instalar el canal estable en lugar de latest de la misma forma. Para impedir que las actualizaciones te hagan volver a una versión inferior a un límite determinado, establece la opción minimumVersion en settings.json. Este es el límite inferior que no sobrepasarán ni las actualizaciones en segundo plano ni claude update.
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í: ```bash curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89 ``` En Windows, el comando equivalente en PowerShell es algo distinto: ```powershell & ([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`: ```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?
Lo esencial Si no necesitas las actualizaciones en segundo plano de Claude Code, desactívalas con la variable DISABLE_AUTOUPDATER en el bloque env del archivo settings.json. Solo detiene la comprobación en segundo plano: el comando claude update seguirá funcionando si quieres actualizar manualmente. Si necesitas bloquear todas las vías de actualización, incluidas las manuales, usa la otra variable, DISABLE_UPDATES. Esto resulta útil al distribuir Claude Code a tu equipo y querer que todo el mundo use la misma versión.
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: ```json { "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](https://ailoot.ai/blog/es/claude-account-suspension-appeal/). ## ¿Por dónde empezar?
Lo esencial Empieza comprobando tu versión con claude --version y compárala con el número más reciente del changelog. Si instalaste Claude Code de forma nativa, actualízalo con claude update y reinicia tu sesión. Si lo instalaste mediante Homebrew o WinGet, ejecuta el comando de actualización de tu gestor de paquetes. Si la versión no cambia, ejecuta claude doctor y which -a claude para buscar conflictos entre varias instalaciones. Y elige qué canal usar: latest para las novedades, stable para mayor tranquilidad.
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](https://ailoot.ai/blog/es/claude-code-alternatives/) explica en qué se diferencia Claude Code de otros agentes de terminal y cuándo conviene plantearse otras opciones.
### Fuentes - [Claude Code - Advanced setup, documentación oficial](https://docs.claude.com/en/docs/claude-code/setup) - actualizaciones automáticas para instalaciones nativas, el comando claude update, los canales latest y stable, las opciones autoUpdatesChannel y minimumVersion, DISABLE_AUTOUPDATER e instalación de una versión específica - [Claude Code - Troubleshoot installation, documentación oficial](https://docs.claude.com/en/docs/claude-code/troubleshoot-install) - conflictos entre varias instalaciones, which -a claude, permisos de la carpeta npm, lanzadores personalizados y bloqueo de claude update - [Claude Code - CHANGELOG en GitHub](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) - lista de versiones y cambios de cada versión; dónde consultar el número más reciente
Conoce [Ailoot](https://ailoot.ai/). ## Preguntas sobre Claude Code ### ¿Por qué claude update sigue iniciando mi lanzador personalizado antiguo? El actualizador nativo conserva el lanzador personalizado, que sigue eligiendo el binario. Guarda el lanzador y su destino antes de repararlo; usa el instalador nativo documentado en vez de borrar el único comando e invocarlo inmediatamente. ### ¿Cómo compruebo que se recuperó el lanzador? Abre otra terminal y ejecuta claude --version: debe imprimir una versión. Después usa claude doctor para revisar instalación y avisos del lanzador. Si no aparece el comando, corrige PATH antes de continuar. ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.