Claude Code 2.0: fecha de lanzamiento, novedades y cómo actualizar

Claude Code 2.0 salió el 29 de septiembre de 2025 con una extensión de VS Code, una interfaz de terminal renovada y puntos de control a los que puedes volver con /rewind. Ya no es la versión actual: la línea 2.0 terminó en la 2.0.77 el 6 de enero de 2026, y la versión más reciente el 31 de octubre de 2026 es la 2.1.316.

Para actualizar una instalación nativa:

claude update
claude --version

¿Cuándo se publicó Claude Code 2.0?

Anthropic publicó la 2.0.0 en npm el 29 de septiembre de 2025 a las 14:41 UTC, el mismo día de su anuncio "Enabling Claude Code to work more autonomously" (registro de npm, consultado el 31 de octubre de 2026). La línea 2.0 llegó hasta la 2.0.77 el 6 de enero de 2026, con 70 versiones publicadas en total. La 2.0.74 salió el 19 de diciembre de 2025 y la 2.0.76 el 22 de diciembre de 2025.

La versión 2.1.0 llegó al día siguiente, el 7 de enero de 2026, y el registro tenía 555 versiones en total el 31 de octubre de 2026. Ese día la etiqueta latest apuntaba a la 2.1.316 y la stable a la 2.1.309. La página de instalación de Anthropic dice que el canal stable suele ir aproximadamente una semana por detrás y se salta las versiones con regresiones graves (consultado el 31 de octubre de 2026).

¿Qué trajo Claude Code 2.0?

Los cambios principales, según el anuncio de Anthropic del 29 de septiembre de 2025 y el registro de cambios de la 2.0.0:

• Una extensión nativa de VS Code en beta, con panel lateral y diferencias en línea.
• Una interfaz de terminal renovada, con mejor visibilidad del estado y el historial de prompts consultable con Ctrl+r.
• Puntos de control que guardan el estado del código antes de cada cambio.
• El SDK de Claude Code pasa a llamarse Claude Agent SDK.
• Claude Sonnet 4.5 como modelo por defecto.

El registro de cambios de la 2.0.0 tiene diez entradas, entre ellas "New native VS Code extension", "Fresh coat of paint throughout the whole app", "/rewind a conversation to undo code changes" y "/usage command to see plan limits".

Los puntos de control siguen funcionando así hoy: cada prompt que inicia un turno crea uno, la sesión guarda los 100 más recientes y las instantáneas se borran unos 30 días después de la última vez que la sesión guardó una. /rewind, o Esc dos veces en un prompt vacío, abre un menú con cuatro opciones: restaurar código y conversación, restaurar la conversación, restaurar el código o resumir. Los archivos que solo cambian comandos de Bash no se registran, y las ediciones de los subagentes normalmente tampoco se capturan, así que haz commit en git antes de un cambio arriesgado.

¿Qué cambió después de la 2.0?

La versión 2.0.74, del 19 de diciembre de 2025, añadió una herramienta LSP (Language Server Protocol) para ir a la definición, buscar referencias y ver documentación al pasar el cursor. La versión 2.1.0, del 7 de enero de 2026, trajo 15 entradas, entre ellas:

• Las skills se recargan en cuanto las creas o editas, sin reiniciar.
• Las skills pueden ejecutarse en un subagente bifurcado con context: fork.
• Un ajuste language elige el idioma en el que responde Claude.
• Shift+Enter funciona sin configurar nada en iTerm2, WezTerm, Ghostty y Kitty.
• Una corrección de seguridad evita que los tokens OAuth, las claves de API y las contraseñas aparezcan en los registros de depuración.

Desde la versión 2.1.89 (31 de marzo de 2026), los manifiestos de publicación van firmados, y las versiones anteriores solo incluyen sumas de comprobación. El paquete de npm ahora pide Node.js 22 o superior, frente a Node.js 18 en la 2.0.0. El modelo por defecto para Pro, Max, Ultra, Team, Enterprise y la API de Anthropic es ahora Opus 5.5.

Las filas de opciones CLI y comandos cuentan la salida de claude --help de la 2.0.76 y la 2.1.316.

Comparada con la 2.0.76, la salida de ayuda de la 2.1.316 muestra:

• Comandos nuevos: agents para agentes en segundo plano, attach, logs, stop y rm para sesiones en segundo plano, auth, import para traer la configuración de otro agente de programación con IA, purge para borrar del ordenador los datos de Claude Code de un proyecto y ultrareview, una revisión de código con varios agentes alojada en la nube.
• Opciones nuevas, entre ellas --worktree para un árbol de trabajo nuevo de git, --effort de low a max, --bg para arrancar en segundo plano, --remote-control, --safe-mode para arrancar con todas las personalizaciones desactivadas y --name.
• --permission-mode quitó default y delegate y añadió auto y manual, así que los scripts que pasan default o delegate necesitan un valor nuevo.
• Solo desapareció una opción: --mcp-debug, que la 2.0.76 ya marcaba como deprecated.

¿Cómo compruebo mi versión y actualizo Claude Code?

Ejecuta claude --version para ver qué versión tienes: imprime el número seguido de "(Claude Code)", por ejemplo 2.1.316 (Claude Code). Después actualiza de la misma forma en que lo instalaste.

# Native installer
claude update

# Homebrew, stable channel
brew upgrade claude-code
# Homebrew, latest channel
brew upgrade claude-code@latest

# WinGet
winget upgrade Anthropic.ClaudeCode

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

Las instalaciones nativas se actualizan solas en segundo plano, con comprobaciones al arrancar y mientras se ejecutan, y la versión nueva se aplica la próxima vez que abras Claude Code. Las instalaciones de Homebrew, WinGet y de paquetes de Linux (apt, dnf, apk) necesitan una actualización manual. En una instalación nativa, claude update imprime una de las dos primeras líneas de abajo, y en una instalación de Homebrew, WinGet o apk imprime la tercera.

Successfully updated from <old version> to version <new version>
Claude Code is up to date (<version>)
Claude is up to date!

claude doctor muestra el resultado del último intento de actualización y si las actualizaciones automáticas están activadas. El número de versión de la extensión de VS Code es la versión de Claude Code que incluye.

En npm, evita npm update -g: mantiene el rango de versiones de la instalación original y puede no llegar a la versión más reciente. Tampoco uses sudo npm install -g.

¿Qué pasa al actualizar una instalación 2.0 antigua?

El 31 de octubre de 2026 hicimos cinco instalaciones nuevas en un Mac con Node.js 26.12.1, cada una en una carpeta de usuario vacía, y las apuntamos a modelos de Claude a través de la API de OmniaKey.

Las dos instalaciones nativas arrancaron, y claude update llevó cada una a la 2.1.x. Instalar la 2.0.0 tardó 36.6 segundos y su actualización 35.6 segundos, e instalar la 2.0.76 tardó 51.6 segundos y su actualización 29.6 segundos.

Successfully updated from 2.0.0 to version 2.1.308
Successfully updated from 2.0.76 to version 2.1.314

Ninguna llegó a la 2.1.316, la versión más reciente en npm a esa hora, así que comprueba claude --version después de actualizar.

La instalación 2.0.76 de npm arrancó y luego no pudo actualizarse:

New version available: 2.1.316 (current: 2.0.76)
Error: Failed to install update
Or consider using native installation with: claude install

La versión se quedó en la 2.0.76. La compilación 2.0.0 de npm no llegó tan lejos: se bloqueó al arrancar en Node.js 26.12.1 con código de salida 1.

TypeError: Cannot read properties of undefined (reading 'prototype')

El binario nativo de la 2.0.0 arrancó sin problema en la misma máquina, así que ese bloqueo corresponde a la compilación npm de la 2.0.0 en esta versión de Node. La instalación 2.1.316 de npm arrancó e imprimió 2.1.316 (Claude Code). Con una instalación de npm, actualiza con el comando de npm de arriba o, como sugiere el mensaje, pásate al instalador nativo con claude install.

Después de una actualización nativa, las dos versiones se quedan en ~/.local/share/claude/versions/ y el lanzador apunta a la nueva. Los binarios que medimos eran de 74 MB para la 2.0.0, 182 MB para la 2.0.76, 275 MB para la 2.1.308 y 279 MB para la 2.1.314, así que cada actualización dejó el binario antiguo en el disco.

¿Puedo fijar una versión, volver atrás o frenar las actualizaciones?

Instala una versión concreta con el mismo script y un número de versión:

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

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

Usa stable en lugar del número para empezar en el canal stable. El canal que elijas al instalar se convierte en el predeterminado para las actualizaciones automáticas, y puedes cambiarlo después en settings.json:

{"autoUpdatesChannel": "stable"}

latest, el valor por defecto, instala las versiones nuevas en cuanto aparecen. stable suele tener una semana de antigüedad y se salta las versiones con regresiones graves, y el mismo interruptor está en /config. Un modelo recién lanzado puede necesitar una versión más nueva que la que sirve el canal stable, así que cambia a latest para usarlo en el momento.

minimumVersion fija un mínimo, y a partir de ahí las actualizaciones automáticas y claude update se niegan a instalar algo más antiguo:

{"minimumVersion": "2.1.143"}

DISABLE_AUTOUPDATER puesto a 1 en la clave env de settings.json detiene solo la comprobación en segundo plano, y claude update sigue funcionando. DISABLE_UPDATES bloquea todas las vías, incluidas las manuales.

Los informes de errores de dos usuarios en GitHub muestran los puntos ásperos. El 12 de febrero de 2026, un usuario informó: "When running curl -fsSL https://claude.ai/install.sh | bash -s <version> to install a specific version, the script downloads the new binary but fails to update the symlink, leaving the user on the old version" (el script descarga el binario nuevo pero no actualiza el enlace simbólico y deja la versión antigua) (issue #25165, cerrado).

El 17 de mayo de 2026, un usuario de Windows informó de que, tras instalar la 2.1.143 en el canal stable, el actualizador automático volvió a poner la 2.1.133, la compilación stable de entonces. Poner autoUpdatesChannel: "latest" junto con minimumVersion: "2.1.143" "stopped the revert" (detuvo la vuelta atrás) (issue #60065, cerrado).

Después de fijar la versión, ejecuta claude --version y confirma que aparece el número que esperabas.

¿Sigue funcionando una versión antigua de Claude Code?

Anthropic no publica una fecha límite para las compilaciones antiguas, y ninguna de sus páginas que consultamos dice que se rechace la 2.0.x. La API sí puede rechazar una petición con un 400 claude_code_version_too_old cuando el modelo que elegiste necesita una compilación más nueva o cuando la política de tu organización exige una (página de errores de Anthropic, consultada el 31 de octubre de 2026).

Detrás de una pasarela, el modelo por defecto integrado de una instalación antigua puede romperla. Arrancada sin modelo, la 2.0.76 pidió claude-sonnet-4-5-20250929, su valor por defecto integrado, y la petición falló porque nuestra pasarela no sirve ese modelo. La 2.1.316 pidió claude-opus-5-5 y respondió.

Indica el modelo tú mismo con --model o con la variable de entorno ANTHROPIC_MODEL. Con --model claude-sonnet-5-5, la 2.0.76 hizo la corrección de errores de abajo sin problemas.

Las primeras compilaciones de la 2.0 también tenían sus problemas: un usuario informó el 1 de octubre de 2025 de que Claude Code 2.0.0 y 2.0.1 se quedaban congelados en Emacs y en un shell de Linux (issue #8657, cerrado).

Así que actualiza salvo que tengas un motivo para quedarte. Si te quedas en la 2.0, nombra el modelo en cada sesión.

¿Es mejor la versión nueva en la misma tarea?

Ejecutamos una tarea de corrección de errores en la 2.0.76 y la 2.1.316, sin interacción, ambas con --model claude-sonnet-5-5.

Tarea:

The tests in test_wordcount.py fail. Find the bug in wordcount.py, fix it, and run python3 test_wordcount.py to confirm. Do not change the test file.

El error era un recuento de palabras que distinguía mayúsculas de minúsculas.

Las dos versiones hicieron la misma corrección de una línea, pasando el texto a minúsculas con text.lower() antes de contar, y no tocaron el archivo de pruebas. Las pruebas pasaron en ambas y los dos diffs son idénticos byte a byte, así que la compilación nueva cambió el tiempo, no la respuesta.

La versión 2.1.316 terminó en 15.9 segundos frente a 25.8 segundos, un 38% menos, y su estimación de coste de Claude Code fue de $0.055 frente a $0.129, sobre todo porque leyó y escribió menos tokens de caché. Esas dos cifras en dólares son la estimación de coste del propio Claude Code, no lo que pagamos. Una tarea y una ejecución en cada versión es una muestra pequeña.

¿Cómo uso Claude Code con una clave de API en lugar de una suscripción?

Claude Code necesita una cuenta Pro, Max, Ultra, Team, Enterprise o Console, y el plan gratuito de claude.ai no lo incluye. Una pasarela usa dos variables: ANTHROPIC_BASE_URL para dónde van las peticiones, y una credencial, donde ANTHROPIC_AUTH_TOKEN se envía como Authorization: Bearer y ANTHROPIC_API_KEY como x-api-key. La URL base cambia a dónde van las peticiones, no qué modelo responde, así que indica también el modelo.

export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude --model claude-sonnet-5-5

Nuestras pruebas de arriba funcionaron así, con una clave de OmniaKey en ANTHROPIC_AUTH_TOKEN.

La guía de la clave de API de Claude Code cubre las variables y la configuración en Windows. Para el recorrido más largo, lee nuestra guía de instalación y Claude Code sin suscripción. Las páginas de modelo Claude Opus 5.5 y Claude Sonnet 5.5 muestran para qué sirve cada uno, y los precios de los planes están en nuestra guía de precios de Claude Code.

Preguntas frecuentes

¿Es Claude Code 2.0 la última versión?

No. La línea 2.0 terminó en la 2.0.77 el 6 de enero de 2026, y la versión más reciente el 31 de octubre de 2026 es la 2.1.316. Ejecuta claude --version para ver la tuya.

¿Cuándo se publicó Claude Code 2.0?

Claude Code 2.0 se publicó el 29 de septiembre de 2025, cuando la versión 2.0.0 llegó a npm el mismo día del anuncio de Anthropic. La línea 2.1 empezó el 7 de enero de 2026.

¿Cómo actualizo Claude Code?

En una instalación nativa, ejecuta claude update o deja que se actualice sola en segundo plano. Homebrew usa brew upgrade claude-code o brew upgrade claude-code@latest, WinGet usa winget upgrade Anthropic.ClaudeCode y npm usa npm install -g @anthropic-ai/claude-code@latest. Después comprueba el resultado con claude --version.

¿Cómo instalo una versión anterior de Claude Code?

Pasa la versión al script de instalación: curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89 en macOS, Linux o WSL, o & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89 en PowerShell.

¿Funciona Claude Code con el plan gratuito?

No. El plan gratuito de claude.ai no incluye Claude Code, que necesita una cuenta Pro, Max, Ultra, Team, Enterprise o Console. La otra vía es una clave de API, del Anthropic Console o de una pasarela, con facturación por uso.

Fuentes consultadas

• npm: @anthropic-ai/claude-code — consultado el 31 de octubre de 2026
• Anthropic: Enabling Claude Code to work more autonomously — consultado el 31 de octubre de 2026
• Claude Code changelog — consultado el 31 de octubre de 2026
• Claude Code setup — consultado el 31 de octubre de 2026
• Claude Code checkpointing — consultado el 31 de octubre de 2026
• Claude Code with an LLM gateway — consultado el 31 de octubre de 2026
• Claude Code model configuration — consultado el 31 de octubre de 2026
• Claude Code errors — consultado el 31 de octubre de 2026
• Claude Code in VS Code — consultado el 31 de octubre de 2026
• Use Claude Code with Pro, Max or Ultra — consultado el 31 de octubre de 2026
• GitHub issue #8657 — consultado el 31 de octubre de 2026
• GitHub issue #25165 — consultado el 31 de octubre de 2026
• GitHub issue #60065 — consultado el 31 de octubre de 2026