Claude Code v2.1.170: cómo actualizar sin romper tu setup

TL;DR: Claude Code v2.1.170 (publicada el 09/06/2026) añade el modelo Claude Fable 5 y corrige un fallo que impedía guardar transcripciones de sesión al lanzar la CLI desde la terminal integrada de VS Code. Actualizar es un comando, pero saltar varias versiones del ciclo 2.1.x puede cambiar cómo se comportan tus hooks, tus servidores MCP y tu settings.json. Aquí tienes el checklist para actualizar, verificar la versión y revisar tu configuración sin sorpresas a mitad de proyecto.

Por qué una release menor te puede arruinar la tarde

Actualizar Claude Code suena trivial: un claude update y a seguir. El problema no es el comando, es lo que cambia debajo. En el ciclo 2.1.x, Anthropic ha tocado el comportamiento de sesiones, hooks, MCP y memoria casi cada semana. Si arrastras un settings.json de hace diez versiones, te puedes encontrar con un hook que ahora se corta solo o un servidor MCP que deja de conectar.

El caso concreto de la v2.1.170 lo deja claro. La release corrige un bug por el que las sesiones no guardaban la transcripción (y no aparecían en --resume) cuando lanzabas Claude Code desde la terminal integrada de VS Code o cualquier shell que heredara sus variables de entorno. Si trabajas resumiendo sesiones largas, ese fallo te hacía perder contexto sin avisar. Actualizar deja de ser opcional.

¿Qué trae Claude Code v2.1.170?

La v2.1.170 tiene solo dos cambios, pero uno es grande. Según el changelog oficial:

Claude Fable 5 disponible: un modelo de clase Mythos ajustado para uso general. Ojo, queda seleccionable, no reemplaza tu modelo por defecto. Si dudas entre Fable 5 y Opus 4.8 para tareas de código, lo analizo aparte en cuándo usar Claude Fable 5 en Claude Code.
Fix de transcripciones: sesiones que no se guardaban desde la terminal de VS Code ya se registran y vuelven a aparecer en --resume.

El detalle importante es que rara vez actualizas de una versión a la siguiente. Si vienes de la 2.1.160, te tragas de golpe todos los cambios intermedios del ciclo: nuevas flags, deprecaciones y ajustes de comportamiento que sí afectan a tu configuración.

Cómo actualizar y verificar la versión en un minuto

Primero comprueba qué tienes, actualiza, y vuelve a verificar. Nunca asumas que el update se aplicó solo porque el comando no dio error.

# Comprueba la versión instalada ANTES de tocar nada
claude --version

# Actualiza a la última (las dos formas son válidas)
claude update
# o, si instalaste por npm global:
npm install -g @anthropic-ai/claude-code@latest

# Vuelve a verificar: debe mostrar 2.1.170 o superior
claude --version

Si claude --version sigue mostrando la versión vieja, casi siempre es porque tienes dos instalaciones (la del instalador nativo y una de npm) compitiendo en el PATH. Resuelve eso antes de seguir o actualizarás una y ejecutarás la otra.

Qué revisar en settings.json tras saltar de versión

El 80% de los sustos vienen de configuración heredada, no de bugs nuevos. Estos son los puntos del ciclo 2.1.x que conviene mirar en tu settings.json antes de ponerte a trabajar.

Área	Qué cambió	Acción
Transporte MCP	`sse` quedó deprecado a favor de `streamable-http` (alias `http`)	Migra los servidores MCP nuevos; los `sse` existentes funcionan un ciclo más
Hooks de stop	Un stop hook que bloquea en bucle ahora corta tras 8 bloqueos consecutivos	Ajusta el límite con `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` si lo necesitas
Colores	`NO_COLOR`/`FORCE_COLOR` en `env` ya no pisan la UI de Claude Code	Revisa que tus colores de UI vuelven; ahora solo aplican a subprocesos
MCP auto-trust	El auto-trust de `.mcp.json` ya no es el comportamiento por defecto	Declara servidores en `enabledMcpjsonServers` de forma explícita
Output styles	`/output-style` se movió a `/config`	La clave `outputStyle` en `settings.json` sigue siendo válida

Si usas servidores MCP, este es el momento de migrar el transporte. Un ejemplo mínimo del formato nuevo:

{
  "mcpServers": {
    "miServidor": {
      "type": "http",
      "url": "https://mi-mcp.example.com/mcp"
    }
  }
}

Si usas servidores MCP, este es el momento de tratarlos como integraciones estables y no como un detalle de configuración. Tienes más contexto en cómo montar flujos multi-agente con MCP en VS Code.

Qué revisar en CLAUDE.md y memoria

Un cambio de modelo o de harness puede reinterpretar tu CLAUDE.md. La v2.1.170 trae Fable 5, y cada vez que cambia el modelo por defecto las instrucciones que dabas por sentadas pueden leerse distinto. No es una teoría: con la llegada de Opus 4.8 ya vimos archivos de instrucciones que dejaron de comportarse igual, algo que detallo en cómo auditar tu CLAUDE.md cuando cambia el modelo.

Checklist rápido tras el salto de versión:

Lanza una sesión de prueba con una tarea pequeña y mira si Claude sigue respetando tus reglas (formato de commits, idioma, herramientas prohibidas).
Comprueba que --resume recupera tus sesiones, sobre todo si trabajas desde la terminal de VS Code. Ese era el bug que arregla esta release.
Revisa tu memoria automática: si tienes CLAUDE_CODE_DISABLE_AUTO_MEMORY puesto, decide si sigue teniendo sentido con el comportamiento nuevo.

Aislar fallos con safe mode

Si algo se rompe tras actualizar, arranca sin tu configuración para saber si el culpable eres tú o la release. El ciclo 2.1.x añadió una flag pensada justo para esto:

# Arranca sin CLAUDE.md, plugins, skills, hooks ni MCP
# Si el fallo desaparece, el problema está en tu config, no en la CLI
claude --safe-mode

Es el equivalente a arrancar en modo seguro. Si con --safe-mode todo funciona, vas activando piezas (primero MCP, luego hooks, luego skills) hasta encontrar la que rompe. Mucho más rápido que comentar tu settings.json a ciegas.

En Producción

En equipos, el mayor riesgo no es actualizar, es que cada uno corra una versión distinta. Un cambio de comportamiento entre la 2.1.160 y la 2.1.170 puede hacer que un pipeline que funcionaba en tu máquina falle en CI sin un solo cambio de código.

Fija la versión en CI: instala @anthropic-ai/claude-code@2.1.170 con versión explícita en lugar de @latest. Así un release nuevo no te cambia el comportamiento de un día para otro.
Desactiva el auto-updater donde no lo quieras: DISABLE_AUTOUPDATER=1 en entornos automatizados evita que la CLI salte de versión a mitad de un job.
Vigila el coste tras cambiar de modelo: Fable 5 es de clase Mythos y su perfil de tokens no es el de Opus 4.8. Antes de adoptarlo por defecto, mide. Para montar ese seguimiento, te sirve cómo ver tokens y coste de Claude Code en VS Code.
Espera unos días con un modelo recién salido: en proyectos críticos, deja que el modelo se estabilice antes de meterlo en producción. La historia reciente lo avala, basta recordar la regresión del harness en la 2.1.158 que parecía un bug del modelo.

En escenarios reales, fijar versión en el equipo y actualizar de forma coordinada cuesta cinco minutos y ahorra el clásico "en mi máquina funciona". El gasto en API ronda los 10 a 50 € al mes para un desarrollador individual, así que un cambio de modelo mal medido se nota en la factura.

Errores comunes y depuración

Error: tras actualizar, claude --version sigue mostrando la versión vieja. Causa: dos instalaciones (nativa y npm) en el PATH. Solución: localiza cuál se ejecuta primero y elimina la duplicada antes de volver a actualizar.
Error: tus sesiones de VS Code no aparecen en --resume. Causa: el bug de transcripciones previo a la 2.1.170. Solución: actualiza a 2.1.170 o superior; las sesiones nuevas ya se guardan.
Error: un servidor MCP deja de conectar tras el salto. Causa: usaba el transporte sse deprecado o dependía del auto-trust de .mcp.json. Solución: migra a streamable-http y declara el servidor en enabledMcpjsonServers.
Error: un stop hook se queda en bucle infinito. Causa: ahora la CLI corta tras 8 bloqueos consecutivos. Solución: revisa la lógica del hook o ajusta CLAUDE_CODE_STOP_HOOK_BLOCK_CAP.

Preguntas frecuentes

¿Cómo actualizo Claude Code a la v2.1.170?

Ejecuta claude update o npm install -g @anthropic-ai/claude-code@latest, y verifica con claude --version que muestra 2.1.170 o superior. Si no cambia, revisa que no tengas dos instalaciones compitiendo en el PATH.

¿La v2.1.170 cambia mi modelo por defecto a Fable 5?

No. Fable 5 queda disponible como modelo seleccionable, pero tu modelo por defecto no cambia. Tienes que elegirlo de forma explícita si quieres usarlo.

¿Es obligatorio actualizar?

Si lanzas Claude Code desde la terminal integrada de VS Code, sí conviene: la 2.1.170 corrige que las sesiones no se guardaban ni aparecían en --resume. Para el resto, actualizar te da acceso a Fable 5 y a los fixes acumulados del ciclo.

Conclusión

Hemos visto que actualizar Claude Code a la v2.1.170 es un comando, pero el valor está en lo que revisas después. La clave está en verificar la versión de verdad, repasar tu settings.json por las deprecaciones de MCP y hooks, y confirmar que tu CLAUDE.md sigue mandando con el modelo activo. En equipo, fijar versión evita que un cambio de comportamiento te rompa el pipeline sin avisar.

Si quieres dar el paso siguiente, lo natural es decidir cuándo merece la pena Fable 5 frente a Opus 4.8 para tu tipo de tarea, midiendo coste y calidad con tu propio repo. ¿Has actualizado ya y te has encontrado algo raro en tu config? Cuéntamelo en los comentarios o en Twitter @sergiomarquezp_, y de paso te leo qué modelo has dejado por defecto.