# Claude Code 2.0: fecha de lanzamiento, novedades y cómo actualizar > Claude Code 2.0 salió el 29 de septiembre de 2025 y ya no está vigente: el 31 de octubre de 2026 la última es la 2.1.316. Cómo actualizar cada instalación. - Canonical HTML: https://omniakey.com/es/blog/claude-code-2-0 - Markdown: https://omniakey.com/es/blog/claude-code-2-0.md - Published: 2026-10-31 (updated 2026-10-31) - Author: Kiki, COO at OmniaKey - Language: es - Category: Guide - Reading time: 10 min - All posts: https://omniakey.com/blog/llms.txt --- 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. |Versión|Publicación|Estado| |-|-|-| |2.0.0|29 sep 2025|Primera 2.0| |2.0.77|6 ene 2026|Última 2.0.x| |2.1.0|7 ene 2026|Primera 2.1| |2.1.316|31 oct 2026|Más reciente| Para actualizar una instalación nativa: ```bash 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. ||2.0 (2025)|Ahora| |-|-|-| |Versión|2.0.0|2.1.316| |Modelo por defecto|Sonnet 4.5|Opus 5.5| |Node para npm|18+|22+| |Opciones CLI|40|66| |Comandos|6|18| 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. ```bash # Native installer claude update ``` ```bash # Homebrew, stable channel brew upgrade claude-code # Homebrew, latest channel brew upgrade claude-code@latest ``` ```bash # WinGet winget upgrade Anthropic.ClaudeCode ``` ```bash # 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. ```text Successfully updated from to version Claude Code is up to date () 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. |Instalación|¿Arrancó?|Tras actualizar| |-|-|-| |Nativa 2.0.0|Sí|2.1.308| |Nativa 2.0.76|Sí|2.1.314| |npm 2.0.76|Sí|Falló| |npm 2.0.0|Se bloqueó|No ejecutada| 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. ```text 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: ```text 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. ```text 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: ```bash curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89 ``` ```powershell & ([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: ```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: ```json {"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 ` 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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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. ||2.0.76|2.1.316| |-|-|-| |Corrección|Misma línea|Misma línea| |Tests después|Pasan|Pasan| |Tiempo|25.8 s|15.9 s| |Turnos|5|5| |Coste estimado CLI|$0.129|$0.055| |Lectura de caché|50,547|34,306| 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. ```bash 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](https://docs.omniakey.com/es/guides/claude-code-api-key) cubre las variables y la configuración en Windows. Para el recorrido más largo, lee [nuestra guía de instalación](https://omniakey.com/es/blog/claude-code-setup) y [Claude Code sin suscripción](https://omniakey.com/es/blog/claude-code-api-without-subscription). Las páginas de modelo [Claude Opus 5.5](https://omniakey.com/es/claude-opus-5-5) y [Claude Sonnet 5.5](https://omniakey.com/es/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](https://omniakey.com/es/blog/claude-code-pricing). ## 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](https://www.npmjs.com/package/@anthropic-ai/claude-code) — consultado el 31 de octubre de 2026 - [Anthropic: Enabling Claude Code to work more autonomously](https://www.anthropic.com/news/enabling-claude-code-to-work-more-autonomously) — consultado el 31 de octubre de 2026 - [Claude Code changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) — consultado el 31 de octubre de 2026 - [Claude Code setup](https://code.claude.com/docs/en/setup) — consultado el 31 de octubre de 2026 - [Claude Code checkpointing](https://code.claude.com/docs/en/checkpointing) — consultado el 31 de octubre de 2026 - [Claude Code with an LLM gateway](https://code.claude.com/docs/en/llm-gateway-connect) — consultado el 31 de octubre de 2026 - [Claude Code model configuration](https://code.claude.com/docs/en/model-config) — consultado el 31 de octubre de 2026 - [Claude Code errors](https://code.claude.com/docs/en/errors) — consultado el 31 de octubre de 2026 - [Claude Code in VS Code](https://code.claude.com/docs/en/vs-code) — consultado el 31 de octubre de 2026 - [Use Claude Code with Pro, Max or Ultra](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-max-or-ultra) — consultado el 31 de octubre de 2026 - [GitHub issue #8657](https://github.com/anthropics/claude-code/issues/8657) — consultado el 31 de octubre de 2026 - [GitHub issue #25165](https://github.com/anthropics/claude-code/issues/25165) — consultado el 31 de octubre de 2026 - [GitHub issue #60065](https://github.com/anthropics/claude-code/issues/60065) — consultado el 31 de octubre de 2026