Cómo actualizar Claude Code en 2026 (última versión, changelog y desinstalación)

Si instalaste Claude Code con el instalador nativo, se actualiza solo en segundo plano, y el comando de actualización integrado de Claude Code aplica una nueva versión al instante. Las instalaciones con Homebrew, WinGet, apt, dnf y apk no se actualizan solas por defecto, así que las actualizas con tu gestor de paquetes. Las instalaciones con npm se actualizan reinstalando el paquete con la etiqueta @latest. Todos los comandos están abajo, agrupados por método de instalación.

Esta guía también cubre los canales de versiones (latest o stable), fijar o volver a una versión anterior, desactivar las actualizaciones, leer el changelog, arreglar actualizaciones fallidas y desinstalar. Se comprobó con la documentación y el changelog de Claude Code de Anthropic el 17 de octubre de 2026.

Paso 1: comprueba tu versión actual

claude --version

La salida tiene este aspecto: 2.1.302 (Claude Code). Dentro de una sesión en marcha, este comando muestra tu versión, modelo, cuenta y conectividad:

/status

Para leer qué cambió en cada versión sin salir de Claude Code, abre el selector interactivo de versiones:

/release-notes

¿No sabes cómo lo instalaste?

El comando de actualización depende del método de instalación, así que compruébalo primero. El instalador nativo coloca un lanzador en ~/.local/bin/claude en macOS y Linux (un enlace simbólico a ~/.local/share/claude/versions/) o claude.exe en %USERPROFILE%\.local\bin en Windows. En macOS o Linux, esto lista todos los claude de tu PATH, lo que también revela instalaciones duplicadas:

which -a claude

En Windows PowerShell:

where.exe claude

Para ver si lo instaló Homebrew, y con qué cask:

brew list --cask | grep claude-code

Para un informe completo de solo lectura, que incluye el estado de la instalación y el resultado del último intento de actualización, ejecuta:

claude doctor

Paso 2: actualiza con el comando de tu método de instalación

Instalador nativo (macOS, Linux, WSL, Windows)

claude update

Cuando se instala una actualización, indica Successfully updated de la versión antigua a la nueva. Si ya estás al día, indica que Claude Code está actualizado. Las instalaciones gestionadas por Homebrew, WinGet o apk muestran en su lugar Claude is up to date!, porque de ellas se encarga el gestor de paquetes.

Homebrew

Para el cask stable:

brew upgrade claude-code

Para el cask latest:

brew upgrade claude-code@latest

Homebrew guarda las versiones antiguas en disco después de actualizar. Ejecuta de vez en cuando el comando de limpieza para liberar espacio:

brew cleanup

WinGet

winget upgrade Anthropic.ClaudeCode

apt (Debian, Ubuntu)

sudo apt update && sudo apt upgrade claude-code

dnf (Fedora, RHEL)

sudo dnf upgrade claude-code

apk (Alpine)

apk update && apk upgrade claude-code

npm

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

En instalaciones con npm, evita el comando de actualización global del propio npm. Respeta el rango de versiones de tu instalación original y puede que no te lleve a la versión más reciente. Usa el comando @latest de arriba y nunca instales con sudo.

Después de cualquier actualización, abre una sesión nueva (o reinicia Claude Code) y vuelve a comprobar la versión. Las actualizaciones se aplican la próxima vez que se inicia Claude Code.

Cómo funcionan las actualizaciones automáticas

Claude Code busca actualizaciones al arrancar y periódicamente mientras se ejecuta. Las actualizaciones se descargan e instalan en segundo plano y se aplican la próxima vez que inicias Claude Code. El informe doctor del Paso 1 muestra el resultado del último intento de actualización.

• Las instalaciones nativas se actualizan solas por defecto.
• Las instalaciones con npm se actualizan solas cuando el directorio global de npm tiene permisos de escritura. Si no los tiene, Claude Code muestra un aviso único al arrancar, y el informe doctor indica las soluciones.
• Las instalaciones con Homebrew, WinGet, apt, dnf y apk no se actualizan solas por defecto. apt, dnf y apk siempre necesitan una actualización manual, porque esos comandos requieren privilegios elevados.
• Lanzadores personalizados: si sustituyes ~/.local/bin/claude por tu propio script o enlace simbólico, las actualizaciones siguen instalando nuevas versiones en el directorio versions/ pero no tocan tu lanzador, y Claude Code conserva en disco todas las versiones instaladas. Elimina tu lanzador y ejecuta el comando de actualización para devolverle el control a Claude Code.

En las instalaciones nativas, Claude Code borra solo las versiones antiguas: además de la versión en uso, conserva las dos más recientes y elimina el resto.

Deja que Claude Code ejecute por ti las actualizaciones de Homebrew o WinGet

Pon la variable de entorno CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE a 1, por ejemplo en el bloque env de settings.json. Claude Code ejecutará entonces la actualización del gestor de paquetes en segundo plano cuando haya una nueva versión y mostrará un aviso para reiniciar cuando termine bien. La actualización solo afecta al paquete de Claude Code.

{
  "env": {
    "CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "1"
  }
}

En WinGet, la actualización puede fallar mientras Claude Code está en ejecución porque Windows bloquea el ejecutable; en ese caso Claude Code muestra el comando manual. Anthropic también recoge un problema conocido: Claude Code puede anunciar una actualización antes de que tu gestor de paquetes la tenga, así que si una actualización falla, espera y vuelve a intentarlo más tarde.

Elige un canal de versiones: latest o stable

El ajuste autoUpdatesChannel controla qué compilaciones reciben las instalaciones nativas y de npm, tanto en las actualizaciones en segundo plano como con el comando de actualización manual. Cámbialo en Auto-update channel en la pantalla de configuración, que abres con este comando dentro de Claude Code:

/config

O configúralo en settings.json:

{
  "autoUpdatesChannel": "stable"
}

Un modelo recién lanzado puede requerir una versión de Claude Code más nueva que la que ofrece stable. Si quieres ese modelo enseguida, cámbiate a latest. Las organizaciones pueden imponer un canal para todos mediante la configuración gestionada.

Canales para Homebrew y paquetes de Linux

Homebrew elige el canal por el nombre del cask en lugar del ajuste: claude-code sigue stable y claude-code@latest sigue latest. Los repositorios apt, dnf y apk eligen el canal por la URL del repositorio. En apt, pasar a latest cambia tanto la ruta de la URL como el nombre de la suite:

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list

En dnf, cambia baseurl en /etc/yum.repos.d/claude-code.repo al repositorio latest:

baseurl=https://downloads.claude.ai/claude-code/rpm/latest

En apk, quita la línea de stable y añade el repositorio latest:

sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories
echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

Mantén una versión mínima al pasar a stable

Pasar de latest a stable podría, si no, devolverte a una compilación más antigua. Cuando cambias en la pantalla de configuración, Claude Code te pregunta si quieres quedarte en tu versión actual o permitir la bajada de versión; si te quedas, configura minimumVersion por ti. También puedes fijar ese mínimo tú mismo, y las actualizaciones rechazarán cualquier cosa por debajo:

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

Instalar una versión concreta o volver atrás

El instalador nativo acepta un número de versión o un nombre de canal. Si una nueva versión te rompe algo, reinstalar una versión anterior es la forma oficial de volver atrás. Por ejemplo, para instalar la versión 2.1.89 en macOS, Linux o WSL:

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

En Windows PowerShell:

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

En Windows CMD:

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

Si Claude Code ya está instalado, su propio subcomando install hace lo mismo y también acepta stable o latest:

claude install 2.1.89

El comando de versión mostrará entonces exactamente la versión que pediste. Salvo que también desactives las actualizaciones automáticas (siguiente sección), la próxima actualización en segundo plano te volverá a llevar hacia delante.

Desactivar las actualizaciones automáticas

Para detener las actualizaciones en segundo plano, añade DISABLE_AUTOUPDATER con el valor "1" en el bloque env de settings.json. Las actualizaciones manuales y el subcomando install siguen funcionando.

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

En una instalación nativa o con npm, comprueba que ha surtido efecto en el informe doctor del Paso 1: la línea Auto-updates debería decir disabled (set by env: DISABLE_AUTOUPDATER) en lugar de enabled. Para bloquear todas las vías de actualización, incluidas las manuales, usa DISABLE_UPDATES. Anthropic lo recomienda para organizaciones que distribuyen Claude Code por sus propios canales y necesitan que todo el mundo use la versión que ellas proporcionan.

{
  "env": {
    "DISABLE_UPDATES": "1"
  }
}

Usar una versión antigua significa perderte correcciones de seguridad y la compatibilidad con nuevos modelos. Si fijas una versión, ponte un recordatorio para revisar el changelog y avanzar cuando a ti te convenga.

Dónde encontrar el changelog de Claude Code

• Dentro de Claude Code, el comando de notas de versión del Paso 1 abre un selector de versiones; las notas aparecen en tu transcripción sin enviarse a Claude.
• El changelog de la documentación en code.claude.com/docs/en/changelog se genera a partir de CHANGELOG.md en el repositorio de GitHub anthropics/claude-code.
• Cuando lo comprobamos el 17 de octubre de 2026, la entrada más reciente era la versión 2.1.302, del 16 de octubre de 2026. Las versiones salen a menudo, a veces más de una al día, así que revisa el changelog para ver el número actual.

El changelog también es donde Anthropic registra las correcciones del propio actualizador, algo útil cuando una actualización da problemas. Por ejemplo, la documentación de solución de problemas indica que un bloqueo de los comandos de actualización y doctor se corrigió en la v2.1.214, y que un fallo de actualización en Windows que podía perder la copia de seguridad de claude.exe se corrigió en la v2.1.281.

Solución de problemas con las actualizaciones

"The connection dropped while downloading the update"

Claude Code reintenta una descarga cortada, atascada o corrupta hasta un total de tres intentos. Una descarga que sigue conectada pero no termina en 10 minutos falla con Download timed out: exceeded the total deadline y no se reintenta. Vuelve a ejecutar la actualización, mejor con una red más rápida. Si tu red necesita proxy, configura antes HTTPS_PROXY; si un proxy corporativo sigue cortando la transferencia, pide a tu equipo de red que permita las descargas desde downloads.claude.ai.

El comando de actualización se queda colgado tras "Checking for updates"

Antes de la v2.1.214, un directorio situado en la ruta de un archivo de configuración del shell, como ~/.zshrc o ~/.bashrc, hacía que los comandos de actualización y doctor se colgaran. Encuéntralo con:

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

Una línea que empieza por d señala al culpable. Muévelo a otro sitio, o actualiza volviendo a ejecutar el script de instalación, ya que el propio comando de actualización se cuelga en las versiones afectadas:

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

'claude' is not recognized justo después de actualizar en Windows

Las actualizaciones en Windows renombran el claude.exe antiguo a una copia de seguridad llamada claude.exe.old. seguida de una marca de tiempo y después colocan la nueva versión. Si eso falló, restaura la copia más reciente en PowerShell:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

Si no hay copia de seguridad, reinstala:

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

npm error code ENOTEMPTY durante una actualización

npm no pudo apartar el directorio del paquete antiguo. En macOS o Linux, bórralo junto con cualquier copia temporal sobrante y reinstala:

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"
rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*
npm install -g @anthropic-ai/claude-code

Homebrew: "Cask 'claude-code@latest' is not installed"

Estás actualizando el otro cask. Comprueba cuál tienes con el comando brew list del Paso 1 y actualiza ese. Si Homebrew ofrece una versión más antigua que la del changelog, recuerda que el cask claude-code sigue stable, que va una semana por detrás; actualiza el índice de Homebrew o cámbiate al cask latest.

La versión no cambió después de actualizar

• La nueva versión se aplica en el siguiente arranque, así que cierra Claude Code y ábrelo de nuevo.
• Puede que tengas dos instalaciones (por ejemplo, npm y nativa) y la antigua aparezca primero en tu PATH. Usa la comprobación del PATH del Paso 1, quédate con una instalación y elimina las demás.
• Un lanzador personalizado en ~/.local/bin/claude decide qué versión se ejecuta; las actualizaciones no lo sustituyen.
• Tu configuración puede fijar el canal stable, una minimumVersion, o DISABLE_AUTOUPDATER o DISABLE_UPDATES, o tu organización puede imponer una versión mediante la configuración gestionada. El informe doctor muestra cuál se aplica.

Cómo desinstalar Claude Code

Usa los pasos de eliminación que correspondan a cómo lo instalaste. Si claude sigue ejecutándose después, probablemente tienes una segunda instalación o un alias de shell olvidado.

Instalación nativa: macOS, Linux, WSL

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Instalación nativa: Windows PowerShell

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Homebrew

brew uninstall --cask claude-code

O, para el cask latest:

brew uninstall --cask claude-code@latest

WinGet

winget uninstall Anthropic.ClaudeCode

apt

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

dnf

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

apk

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

npm

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

Eliminar configuración e historial (opcional)

Esto borra toda tu configuración, las herramientas permitidas, las configuraciones de servidores MCP y el historial de sesiones. La extensión de VS Code, el plugin de JetBrains y la app de escritorio también escriben en ~/.claude, así que desinstálalos antes o la carpeta volverá a aparecer.

rm -rf ~/.claude
rm ~/.claude.json

Para eliminar también la configuración de Claude Code de un proyecto concreto, ejecuta esto dentro de la carpeta del proyecto:

rm -rf .claude
rm -f .mcp.json

Desinstalar la app no cancela la suscripción. Gestiona tu plan en la configuración de tu cuenta de claude.ai. Consulta precios de Claude Code y precios de Claude para ver las opciones de plan, o reinstálalo cuando quieras con nuestra guía de instalación de Claude Code.

Mantener Claude Code al día: qué más revisar

• Plan y facturación: algunas funciones nuevas necesitan un plan más alto o acceso a un modelo. Revisa precios de Claude Code si una función del changelog no te aparece.
• Usuarios con clave de API: si usas Claude Code con una clave de API, las actualizaciones no cambian la facturación. Nuestra guía de la clave de API de Anthropic cubre los créditos y los límites de gasto.
• Flujos de trabajo que cambian: las versiones grandes pueden cambiar comandos y modos. Nuestra guía del plan mode de Claude Code se mantiene alineada con la versión actual.
• Acceso gratuito: los mantenedores de código abierto pueden mirar Claude for Open Source y los estudiantes las ofertas de Claude para estudiantes.