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 ponCLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1y deja que Claude lo haga por ti en Homebrew y WinGet. Si no se actualiza,claude doctorte dice por qué en la líneaAuto-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_AUTOUPDATERoDISABLE_UPDATESen elenvde tusettings.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
/doctor: chequea install, versión, MCP y skills cuando algo falla.- Cheat sheet de slash commands: incluye
/release-notesy/config. - Cuando el auto-update falla: la línea de
claude doctorque dice cuál de las cuatro causas te ha tocado. - "Premature close": el error que, hasta la 2.1.289, escondía un git o un gh sin instalar.
- "Unrecoverable interface error": diez causas de ese cierre, corregidas entre la 2.1.275 y la 2.1.289.
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