Claude Code changelog: qué cambió y cuándo volver atrás

El registro completo de cambios de Claude Code es el changelog oficial, que se genera a partir del CHANGELOG.md del repositorio anthropics/claude-code y recoge cada versión con todas sus correcciones. Solo existe en inglés. En español tienes Novedades, un resumen semanal de lo más destacado que no sustituye al changelog.

A 23 de septiembre de 2026, la versión más reciente es la 2.1.280 (22 de septiembre de 2026) y la etiqueta stable de npm apunta a la 2.1.267 (9 de septiembre). Para saber qué ha cambiado en tu caso, mira tu versión con claude --version y compárala con el changelog con el comando de más abajo. Si una actualización te ha roto algo, tienes tres salidas: esperar la corrección en latest, pasarte al canal stable o instalar una versión concreta mientras tanto.

Dónde mirar según lo que quieres saber

Anthropic publica varios registros y cada uno responde a una pregunta distinta. Si buscas una corrección menor en el resumen semanal o un cambio de la API en el changelog del CLI, no la vas a encontrar.

Las URL del changelog con prefijo de idioma (por ejemplo /docs/ja/changelog o /docs/zh-CN/changelog) sirven el mismo archivo en inglés. Novedades, en cambio, sí está traducido, pero solo selecciona lo que más puede cambiar tu forma de trabajar: cada semana va etiquetada con su rango, como la semana 37 (7–11 de septiembre de 2026, v2.1.263–v2.1.269), que presentó claude plugin eval. Las correcciones de errores y las mejoras pequeñas solo están en el changelog.

/release-notes abre el changelog en un selector de versiones dentro de la propia sesión: eliges una versión o todas, y las notas aparecen en pantalla sin entrar en la conversación que ve Claude, así que no ocupan contexto.

Los agregadores de terceros no siempre están al día. A 23 de septiembre de 2026, la página «Claude Code Changelog: All Release Notes (2026)» de claudefa.st decía cubrir el historial hasta mayo de 2026 y su última entrada era la v2.1.128. Si usas un rastreador externo, comprueba cuál es la versión más reciente que recoge antes de fiarte de él.

Qué ha cambiado desde tu versión

El changelog completo pesa unos 764 KB y, a 23 de septiembre de 2026, tenía 402 entradas, desde la 0.2.21 (2 de abril de 2025) hasta la 2.1.280. Leerlo de arriba abajo no tiene sentido; lo útil es cortar justo en tu versión.

Primero, tu número de versión:

claude --version
# 2.1.275 (Claude Code)

Después, descarga el archivo en bruto y muestra todo lo que hay por encima de tu versión:

curl -fsSL https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md -o CHANGELOG.md
awk -v mine="2.1.275" '/^## /{ if ($2==mine) exit } {print}' CHANGELOG.md

Con mine="2.1.275", el 23 de septiembre de 2026 este comando mostraba los encabezados de la 2.1.280, 2.1.278, 2.1.277 y 2.1.276, con 204 líneas de cambios en total. Algunos detalles que evitan resultados raros:

• Escribe el número tal como lo imprime claude --version, sin «(Claude Code)». Si el número no coincide con ningún encabezado, awk no encuentra dónde parar e imprime el archivo entero.
• Guarda primero el archivo. Si encadenas curl directamente con un comando que termina antes de leerlo todo, verás curl: (56) Failure writing output.
• El comando depende de que los encabezados del archivo sigan el formato ## 2.1.x. Si Anthropic cambia ese formato, habrá que ajustar el patrón.
• En Windows necesitas WSL u otra shell con curl y awk.

Si prefieres no salir de la sesión, /release-notes te deja elegir la versión en el selector, aunque tendrás que ir versión por versión.

En qué versión cambió un comportamiento

Cuando algo funciona distinto y quieres saber desde cuándo, busca una palabra clave en el mismo archivo. Este awk imprime cada coincidencia precedida de la versión en la que aparece:

awk '/^## /{v=$2} tolower($0) ~ /agents\.md/ {print v ": " $0}' CHANGELOG.md
# 2.1.277: - Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; ...

Cambia agents\.md por lo que busques, en minúsculas y escapando los puntos. Con grep -n -i "palabra" CHANGELOG.md obtienes lo mismo con número de línea, pero sin la versión al lado.

Las regresiones llevan etiqueta

Una regresión es algo que funcionaba y dejó de funcionar tras una actualización. El changelog marca muchas de ellas en la línea de la corrección, con la forma «(regression in 2.1.x)», que indica qué versión introdujo el fallo. A 23 de septiembre de 2026 había 24 líneas con esa etiqueta y al menos otras tres con la variante «regression introduced in». Por ejemplo:

• La 2.1.269 corrigió teclas que fallaban en terminales con protocolo kitty y en WezTerm, una regresión de la 2.1.247.
• La 2.1.270 corrigió que los comandos git de solo lectura en Bash pidieran permiso tras un rato de sesión, una regresión de la 2.1.269.
• La 2.1.275 corrigió en VS Code que renombrar una sesión en marcha volviera al nombre generado, también una regresión de la 2.1.269.
• La 2.1.258 corrigió que Claude Code no arrancara en macOS 12 (Monterey), «a regression introduced in 2.1.255».

Para saber si tu versión introdujo algún fallo ya conocido y en qué versión se arregló, busca su número en la etiqueta (el patrón cubre las dos formas):

awk '/^## /{v=$2} /regression (introduced )?in 2\.1\.269/ {print v ": " $0}' CHANGELOG.md
# 2.1.275: - [VSCode] Fixed renaming a running session reverting to the generated name (regression in 2.1.269)
# 2.1.270: - Fixed read-only git commands in Bash unexpectedly asking for permission ... (regression in 2.1.269)

Que tu versión no aparezca no demuestra que esté libre de regresiones: no todas se etiquetan. Y si lo que te ha cambiado son los avisos de permisos, el problema puede ser de configuración y no de versión; para eso tienes Auto mode o bypassPermissions en Claude Code: menos avisos no significa acceso sin límites.

Versiones que no existen y fechas que no cuadran

La numeración salta. Dentro de la serie 2.1.x hay 57 números sin entrada en el changelog; la 2.1.262, la 2.1.264 y la 2.1.279, por ejemplo, devuelven 404 tanto en npm como en las etiquetas de GitHub, así que nunca se publicaron. No busques cambios en esos números.

El changelog muestra fechas sin zona horaria y GitHub Releases muestra la hora en UTC (la 2.1.280 se publicó el 2026-09-22T16:38:14Z). Según tu zona horaria, la fecha puede variar en un día.

Qué ha llegado en 2026, versión a versión

En 2026 hubo 226 entradas hasta el 22 de septiembre, entre 20 y 28 al mes (enero 26, febrero 28, marzo 20, abril 26, mayo 27, junio 28, julio 22, agosto 28 y 21 entre el 1 y el 22 de septiembre). El tamaño varía muchísimo: la 2.1.280 tiene 114 líneas y la 2.1.277, 87, mientras que la 2.1.276, la 2.1.272 y la 2.1.270 tienen una sola. Con ese ritmo, dos semanas sin actualizar pueden suponer una docena de versiones, y el número de versión dice poco sobre cuánto cambió.

Estos son los cambios de 2026 que más afectan al uso diario, con la versión en la que aparecen en el changelog:

Que un modelo esté en Claude Code no garantiza que lo tengas: depende también de tu plan y de tu proveedor. Si el cambio que te afecta es el de modelo, los detalles de precio y migración están en Claude Opus 5.5: precio de la API y qué revisar antes de migrar y en Claude Fable 5.1: precio API, cambios y guía de migración.

latest o stable: qué canal te conviene

El ajuste autoUpdatesChannel decide qué versiones recibes por actualización automática y con claude update, según la documentación de instalación:

• "latest" (valor por defecto): recibes cada versión en cuanto sale.
• "stable": usas una versión que normalmente tiene alrededor de una semana y se salta las que tuvieron regresiones graves.

«Alrededor de una semana» es lo habitual, no una garantía. El 23 de septiembre de 2026, las etiquetas de npm eran stable = 2.1.267 (9 de septiembre) y latest = 2.1.280 (22 de septiembre): 13 días y 12 versiones publicadas de diferencia. Quien estaba en stable ese día no había recibido todavía la 2.1.269, la versión a la que el changelog atribuye dos regresiones corregidas después. Puedes repetir la comprobación en cualquier momento:

npm view @anthropic-ai/claude-code dist-tags

Ese mismo día, el canal stable del instalador nativo coincidía con npm: la dirección que consulta el script de instalación, https://downloads.claude.ai/claude-code-releases/stable, devolvía 2.1.267, y la de latest, 2.1.280. Esa dirección no aparece en la documentación y Anthropic puede cambiarla sin aviso, así que sirve para comprobar, no como garantía:

curl -fsSL https://downloads.claude.ai/claude-code-releases/stable

La regla exacta con la que una versión pasa a stable no es pública. Dentro de una sesión, /doctor comprueba si hay una versión más nueva en tu canal.

Cómo decidir:

• Quieres los modelos y funciones nuevos en cuanto salen: quédate en latest. Opus 5.5, por ejemplo, llegó con la 2.1.280 y ese día no estaba en stable.
• Trabajas en equipo, en CI o en algo que no puede pararse por un fallo del CLI: stable te da una semana, más o menos, de colchón frente a regresiones. El repositorio apt del canal stable da un ejemplo: pasa de la 2.1.236 (publicada el 19 de agosto) a la 2.1.267 (9 de septiembre) sin ninguna versión intermedia, de modo que la compilación que no arrancaba en macOS 12 (la 2.1.257; la 2.1.255 y la 2.1.256 nunca llegaron a publicarse) no llegó a quien usaba ese repositorio. Las fechas son de publicación, no de paso a stable, y el ejemplo supone que el repositorio conserva cada versión que pasó por stable. También muestra que el retraso puede ser bastante mayor que una semana.
• Una versión concreta te ha roto algo: busca la regresión en el changelog. Si ya hay corrección publicada, claude update en latest basta; si no, vuelve temporalmente a una versión anterior (más abajo).
• Gestionas una organización: las managed settings permiten imponer el canal a todos y fijar un rango con requiredMinimumVersion y requiredMaximumVersion; fuera de ese rango, Claude Code no arranca, y las actualizaciones respetan el máximo.

Para cambiar de canal, entra en /config → Auto-update channel o añádelo a settings.json:

{
  "autoUpdatesChannel": "stable"
}

Al pasar de latest a stable desde /config, Claude Code te pregunta si quieres quedarte en tu versión actual o permitir la bajada. Si te quedas, fija minimumVersion en esa versión. Ese ajuste es un suelo, no un ancla: las actualizaciones nunca instalarán nada por debajo, pero sí seguirán subiendo. Volver a latest lo elimina.

Actualizar, cambiar de canal o volver atrás según cómo instalaste Claude Code

Lo que funciona depende del método de instalación. Si no recuerdas cuál usaste, claude doctor imprime el diagnóstico de la instalación, incluido el resultado del último intento de actualización.

Tres detalles que cambian el resultado:

• npm: no uses npm update -g, que respeta el rango de versiones de la instalación original y puede no llevarte a la última. Desde la 2.1.198 el paquete requiere Node.js 22 o posterior; con una versión anterior verás un aviso EBADENGINE, pero la instalación termina y claude funciona.
• Homebrew y WinGet: Claude Code puede avisarte de una actualización antes de que el gestor de paquetes la tenga. Si la actualización falla, espera un rato y vuelve a intentarlo.
• claude update respeta tu canal. Si instala algo, responde Successfully updated from <versión anterior> to version <versión nueva>; si ya estás al día, Claude Code is up to date (<versión>). En instalaciones de Homebrew, WinGet o apk verás Claude is up to date!.

Volver a una versión anterior con el instalador nativo

El instalador nativo acepta un número de versión o un canal:

# macOS, Linux o WSL: una versión concreta
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.267

# macOS, Linux o WSL: el canal stable
curl -fsSL https://claude.ai/install.sh | bash -s stable

# Windows PowerShell: una versión concreta
& ([scriptblock]::Create((irm https://claude.ai/install.ps1 ))) 2.1.267

Si Claude Code ya está instalado, claude install 2.1.267 hace lo mismo: el comando está documentado y acepta un número de versión, stable o latest. Después, claude --version debe mostrar 2.1.267 (Claude Code).

Instalar un número antiguo no basta para quedarte en él. La documentación no lo aclara, pero los informes del issue #91309 de GitHub sí: en septiembre de 2026, usuarios de macOS 12 cuyo actualizador los había llevado a la 2.1.257, que no arrancaba, volvieron a la 2.1.252 con bash -s 2.1.252 y tuvieron que activar DISABLE_AUTOUPDATER porque, si no, la siguiente actualización en segundo plano volvía a instalar la versión rota. Son dos usuarios en un mismo sistema, no una declaración de Anthropic, pero basta para no confiar en la bajada sola. Desactiva la actualización automática en el bloque env de settings.json:

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

Comprueba que ha surtido efecto con claude doctor: la línea Auto-updates debe decir disabled (set by env: DISABLE_AUTOUPDATER). Esta variable solo detiene la comprobación en segundo plano; claude update y claude install siguen funcionando. Cuando el changelog recoja la corrección que esperabas, quita la variable y ejecuta claude update, como hizo el autor del issue cuando salió la 2.1.258.

Si usas Claude Code desde la app Claude Desktop, ten en cuenta que esa copia integrada (en macOS, ~/Library/Application Support/Claude/claude-code/<versión>/) se instala y actualiza por su cuenta. Según el issue #92401, ni DISABLE_AUTOUPDATER ni fijar la versión con el script de instalación le afectan: solo cambian el CLI independiente.

Si lo que necesitas es bloquear cualquier actualización, incluidas las manuales (por ejemplo, porque distribuyes Claude Code con tus propios canales y todos deben usar la versión que tú das), la variable es DISABLE_UPDATES.

Volver atrás con npm

La sintaxis de versión concreta es la estándar de npm:

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

El paquete npm instala el mismo binario nativo, y DISABLE_AUTOUPDATER funciona igual en instalaciones npm que en las nativas: si no quieres que la actualización automática te vuelva a subir, añade también la variable y quítala cuando llegue la corrección.

Volver atrás con Homebrew, WinGet, apt, dnf o apk

Anthropic no documenta cómo instalar una versión antigua con estos gestores. Lo que sigue es lo que ofrecía cada uno a 23 de septiembre de 2026, con la sintaxis propia de cada herramienta, no instrucciones de Anthropic; después de usarla, comprueba el resultado con claude --version.

• Homebrew solo tiene dos casks: claude-code, que iba por la 2.1.267 (stable), y claude-code@latest, por la 2.1.280. No hay un cask por número de versión, así que la única bajada posible es pasar de claude-code@latest a claude-code. Si necesitas un número concreto, la vía documentada es el instalador nativo.
• WinGet conserva muchas versiones anteriores del paquete Anthropic.ClaudeCode (por ejemplo, la 2.1.252, la 2.1.267 y la 2.1.268). Con la opción estándar de versión: winget install Anthropic.ClaudeCode --version 2.1.267. Los manifiestos los genera una herramienta automática en el repositorio comunitario de WinGet, y ese día el más reciente era la 2.1.268, que no era ni stable ni latest; lo que haya disponible depende de que ese repositorio se actualice.
• apt guarda compilaciones antiguas con la versión exacta: el repositorio stable tenía 54 versiones (de la 2.1.108 a la 2.1.267) y el latest, 134. Instala y retén una con sudo apt install claude-code=2.1.267-1 y sudo apt-mark hold claude-code; quita la retención cuando llegue la corrección.
• dnf: sudo dnf install claude-code-2.1.267. En el repositorio stable de rpm, la más reciente era la 2.1.267.
• apk: apk add claude-code=2.1.267-r1. El repositorio stable tenía 54 versiones con el formato 2.1.267-r1.

Preguntas frecuentes

¿Cuál es la última versión de Claude Code?

A 23 de septiembre de 2026, la 2.1.280, publicada el 22 de septiembre, y la 2.1.267 en el canal stable, tanto en npm como en el instalador nativo. En 2026 han salido entre 20 y 28 versiones al mes, así que conviene comprobarlo en el momento: npm view @anthropic-ai/claude-code dist-tags muestra ambas etiquetas y /doctor te dice si hay algo más nuevo en tu canal.

¿Hay un changelog de Claude Code en español?

No. Las URL localizadas del changelog muestran el archivo en inglés. En español está Novedades, que resume cada semana lo más destacado con su rango de versiones, pero no incluye todas las correcciones.

¿Cómo actualizo Claude Code?

Con el instalador nativo, claude update. Con npm, npm install -g @anthropic-ai/claude-code@latest. Con Homebrew, WinGet, apt, dnf o apk, el comando de actualización de tu gestor de paquetes, que tienes en la tabla de métodos de instalación.

¿Por qué no encuentro la versión 2.1.279?

Porque no se publicó. La numeración salta: la 2.1.279, la 2.1.264 y la 2.1.262 devuelven 404 en npm y en GitHub. Después de la 2.1.278 viene la 2.1.280.

¿Leer el changelog con /release-notes consume contexto?

No. Las notas aparecen en la transcripción de la sesión, pero no entran en la conversación que ve Claude.