← Claude Code Hub
May 17, 2026 · 7 min de lectura ✦ Tip #073

Cómo actualizar Claude Code: un comando, salvo que Homebrew o npm te hayan dejado semanas atrás

Con el installer nativo, claude update, y ni eso: se actualiza solo. Homebrew, WinGet, apt, dnf y apk no, y si llevas semanas sin ver una novedad, claude doctor te dice por qué.

Actualizar Claude Code: tabla por método de instalación con auto-update y comando manual

TL;DR Comprueba tu versión con claude --version. Si lo instalaste con el installer nativo (curl … | bash), se actualiza solo en segundo plano y la versión nueva entra la próxima vez que abres Claude Code. Para forzarlo ahora: claude update. Con Homebrew, WinGet, apt, dnf o apk usa el comando del package manager, o pon CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 y deja que Claude lo haga por ti en Homebrew y WinGet. Si no se actualiza, claude doctor te dice por qué en la línea Auto-updates.

Para actualizar Claude Code instalado con el installer nativo, ejecuta claude update, aunque normalmente no hace falta: se actualiza solo en segundo plano. Con Homebrew, WinGet, apt, dnf o apk no se actualiza solo, y tienes que usar el comando de tu gestor de paquetes. Con npm se actualiza solo mientras pueda escribir en la carpeta global de npm. Aquí están todos en una sola tabla.

Si llevas meses sin ver una novedad, probablemente estás en el segundo grupo: instalado con un package manager que no se actualiza solo.

¿Tienes que actualizar? Sí

Las novedades llegan cada par de semanas: skills, subagents, agent teams, /goal, GitHub Actions, el Agent SDK. El binario nativo mantiene compatibilidad con tu CLAUDE.md y tus settings entre versiones, así que el coste de actualizar es prácticamente cero. El de no hacerlo es perderte features que probablemente ya están en otros tips de este sitio. Y un modelo recién lanzado puede exigir una versión más nueva que la que tienes.

Comprueba tu versión

claude --version
# 2.1.293 (Claude Code)

Compáralo con la última versión publicada o, desde dentro de Claude, usa /release-notes (picker interactivo del changelog).

¿Claude Code se actualiza solo?

Depende de cómo lo instalaste. El installer nativo se actualiza solo, y npm también mientras pueda escribir en su carpeta global: Claude Code busca versiones nuevas al arrancar y cada cierto tiempo mientras está abierto, las descarga en segundo plano y la nueva entra en vigor la próxima vez que inicias Claude Code. La sesión que tienes abierta sigue en la versión anterior.

Cómo lo instalaste Auto-update Cómo actualizar a mano
Installer nativo (curl … | bash) ✅ En segundo plano claude update
Homebrew (brew install --cask claude-code) ❌ brew upgrade claude-code (o brew upgrade claude-code@latest, según el cask que instalaste)
WinGet (Windows) ❌ 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 (global) ✅ Si la carpeta global de npm es escribible npm install -g @anthropic-ai/claude-code@latest

Importante para npm: NO uses npm update -g. Respeta el rango semver del install original y puede no moverte a la última versión. Si la carpeta global de npm no es escribible, Claude Code no puede actualizarse solo y te lo avisa una vez al arrancar.

¿Cómo forzar la actualización de Claude Code?

No hace falta esperar al siguiente chequeo en segundo plano:

claude update

Si había versión nueva, responde Successfully updated from <versión anterior> to version <versión nueva>. Si ya estás en la última, Claude Code is up to date (<versión>). En instalaciones de Homebrew, WinGet o apk el mensaje es Claude is up to date!. Cierra y vuelve a abrir Claude Code para empezar a usar la versión nueva.

¿Por qué no se actualiza Claude Code?

La respuesta está en claude doctor, que imprime el diagnóstico sin abrir una sesión. Las líneas que importan aquí son estas (salida real de mi máquina):

Running: native (2.1.293)
Auto-updates: disabled (set by env: DISABLE_AUTOUPDATER)
Auto-update channel: latest
Last update attempt: success → 2.1.282 (2026-09-25)

Running te dice el método de instalación. Auto-updates te dice si el chequeo en segundo plano está apagado y quién lo apagó: en mi caso, la variable DISABLE_AUTOUPDATER. Last update attempt es el resultado del último intento.

Las causas más habituales:

  • Instalaste con un package manager. Homebrew, WinGet, apt, dnf y apk no se actualizan solos. Usa su comando de la tabla.
  • Tienes DISABLE_AUTOUPDATER o DISABLE_UPDATES en el env de tu settings.json, o en las managed settings de tu empresa.
  • Sí se actualizó, pero no has reiniciado. La versión nueva entra al volver a abrir Claude Code.
  • El package manager aún no tiene la versión. Claude Code puede avisarte de una versión antes de que llegue a Homebrew o WinGet. Espera y repite el upgrade más tarde.
  • WinGet falla con Claude Code abierto, porque Windows bloquea el ejecutable. Ciérralo y ejecuta winget upgrade Anthropic.ClaudeCode.

Si Last update attempt muestra un error, las cuatro causas de ese fallo y su arreglo están en cuando el auto-update falla.

Instalar una versión específica (o hacer downgrade)

A veces no quieres la última, sino una versión concreta, por CI o porque una actualización reciente rompió algo. El installer nativo acepta versión exacta o canal:

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

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

El canal que elijas al instalar (latest, stable, o un número exacto) queda como predeterminado para futuros auto-updates.

El truco para los package managers

Si instalaste con Homebrew o WinGet pero quieres que Claude Code se actualice solo, pon esto en tu settings.json:

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

A partir de ahí, cuando haya nueva versión Claude la instala en segundo plano y te muestra un prompt para reiniciar. apt, dnf y apk siguen requiriendo actualización manual porque necesitan permisos elevados.

Canal: latest vs stable

Por defecto estás en "latest": novedades al instante. Si alguna regression reciente te ha afectado y prefieres ser más conservador:

{
  "autoUpdatesChannel": "stable"
}

"stable" está alrededor de una semana por detrás y salta releases con regressions importantes. Cambias el canal con /config → Auto-update channel, o editando el settings.json directamente. Para equipos: las managed settings imponen canal y minimumVersion en toda la organización.

Homebrew no lee este setting, porque el canal lo decide el cask (claude-code sigue stable y claude-code@latest sigue latest). En apt, dnf y apk tampoco: lo decide el repositorio que registraste.

Pin de versión mínima

Para garantizar que no bajes accidentalmente de una versión concreta (por ejemplo al cambiar de "latest" a "stable"):

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

Útil en CI o en equipos donde quieres garantizar un piso común.

Desactivar auto-updates

Si tu red o tu política interna no permite que Claude se actualice solo:

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

DISABLE_AUTOUPDATER solo apaga el chequeo en segundo plano: claude update sigue funcionando. Para bloquear TODO (incluido el update manual), usa DISABLE_UPDATES.

Referencia: env vars y settings

Variable / setting Para
claude --version Ver versión instalada
claude update Forzar update ahora
claude doctor Ver si el auto-update está activo y el resultado del último intento
autoUpdatesChannel "latest" o "stable"
minimumVersion Piso de versión (no permite downgrade)
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 Auto-update vía Homebrew/WinGet
DISABLE_AUTOUPDATER=1 Apaga el chequeo en segundo plano
DISABLE_UPDATES=1 Bloquea todos los caminos de update

Combina con

Un caso en el que actualizar es todo el arreglo: "Request rejected as unprocessable by the model" en sesiones con cientos de capturas, corregido en la 2.1.290.

Documentación oficial: Update Claude Code

¿Te ha servido? Haz que wmedia.es te salga antes en Google.

Añadir wmedia.es como fuente preferida en Google
GUÍA GRATUITA

Aprueba menos, pero mejor.

A los diez minutos ya le das a «sí» sin leer. Eso no es revisar, es rezar. La guía de 10 páginas con las cinco palancas, en orden de riesgo.

  • 1. Reglas la primera que coincide gana
  • 2. Modo un dial, no un interruptor
  • 3. Auto mode un clasificador aprueba por ti
  • 4. Sandbox una valla del sistema operativo
  • 5. Bypass solo dentro de un contenedor
¿Eres desarrollador/a Web profesional?

Recibirás la guía por email · Te unes a la newsletter Gravitas · Cancela cuando quieras

de 10
#

Wmedia · 10 páginas
GUÍA GRATUITA · 10 páginas · 5 palancas

Aprueba menos, pero mejor.

A los diez minutos ya le das a «sí» sin leer. Eso no es revisar, es rezar. La guía de 10 páginas con las cinco palancas, en orden de riesgo.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras
Cómo trabajo con IA

Mi flujo de trabajo con Claude Code.

Las skills, agentes e instrucciones que uso como Software Engineer profesional. Se llama Craft y es un plugin que puedes instalarte.

Ver las skills

¿Harto de aprobar permisos sin leer?