Claude Code estrena guía oficial para mantener el foco del agente en tareas largas

Cualquiera que haya dejado a Claude Code trabajando solo durante más de diez minutos en una tarea compleja sabe lo que ocurre: el agente empieza a derivar. Abre archivos que no tocaba, se mete en subflujos secundarios o, en el mejor de los casos, termina preguntando qué debería hacer a continuación. El 13 de mayo, Anthropic publicó una nueva sección en la documentación oficial de Claude Code titulada Keep Claude working toward a goal, que aborda directamente este problema.

La noticia llegó a través de Hacker News sin mucho ruido —un punto, sin comentarios— pero la documentación en sí tiene más sustancia de lo que el hilo sugiere.

El problema que intenta resolver

Cuando se trabaja con agentes autónomos, la pérdida de foco no es un fallo puntual: es una característica estructural de cómo los modelos de lenguaje gestionan contextos largos y objetivos compuestos. A medida que una sesión avanza, el peso relativo de las instrucciones iniciales disminuye frente al volumen de herramientas llamadas, resultados intermedios y mensajes de error acumulados. El agente no «olvida» el objetivo, pero empieza a responder más a lo inmediato que a lo estratégico.

Esto es especialmente relevante con Claude Opus 4.7 y su ventana de contexto de 1 millón de tokens: tener capacidad para retener más no significa que el modelo priorice correctamente todo ese contenido a lo largo del tiempo.

Qué propone la documentación oficial

La guía publicada por Anthropic organiza sus recomendaciones en torno a varios ejes. Aunque el contenido completo está en la página oficial, los patrones que aborda son reconocibles para quienes llevan tiempo construyendo flujos con Claude Code:

• Formulación explícita del objetivo: insistir en que el prompt inicial describa no solo la tarea sino el criterio de éxito. Un agente que sabe cuándo ha terminado tiene menos tendencia a buscar trabajo adicional.
• Uso de hooks para reorientar: los hooks de ciclo de vida —particularmente `PostToolUse` y `Stop`— permiten inyectar recordatorios del objetivo original o validaciones intermedias sin interrumpir el flujo manualmente. Es una de las aplicaciones más prácticas de hooks que hemos visto documentadas de forma oficial.
• Subagentes con alcance acotado: delegar subtareas a subagentes especializados con instrucciones cerradas reduce el riesgo de que el agente principal expanda el scope por su cuenta.
• Skills como anclas de contexto: los skills, al encapsular instrucciones y contexto reutilizable, funcionan también como puntos de referencia que el agente puede invocar para recalibrarse.

Para quién es útil esto

La guía está orientada principalmente a dos perfiles. Primero, equipos de ingeniería que usan Claude Code para automatizar flujos de trabajo de varios pasos: migraciones de código, generación de tests en masa, análisis de repositorios completos. En estos contextos, una desviación del objetivo a mitad del proceso puede costar horas de revisión.

Segundo, desarrolladores que construyen agentes a medida sobre Claude Code y necesitan garantías de comportamiento en producción. Documentar el mecanismo de pérdida de foco —y las herramientas disponibles para mitigarlo— es exactamente el tipo de información que se necesita antes de desplegar algo en un entorno real.

Para usuarios ocasionales o flujos de tarea única, la relevancia es menor. Aquí el valor está en sesiones largas y autónomas.

Contexto en el ecosistema

Esta publicación encaja en un patrón más amplio que llevamos meses observando: Anthropic está invirtiendo en hacer que Claude Code sea fiable en modo autónomo, no solo capaz. Hooks, subagentes, skills y ahora guías de comportamiento orientado a objetivos apuntan en la misma dirección. La CLI ha dejado de ser una interfaz de conveniencia para convertirse en el entorno de referencia donde se definen las mejores prácticas del ecosistema.

Lo que falta, todavía, son mecanismos más declarativos para especificar restricciones de scope desde el propio fichero de configuración, sin depender de ingeniería de prompts. La documentación reconoce el problema; las herramientas para resolverlo de forma sistemática aún no están todas ahí.

---

Desde EP consideramos que esta guía cubre un vacío real en la documentación de Claude Code. No soluciona el problema de raíz, pero da nombres y palancas concretas a algo que hasta ahora solo circulaba como conocimiento informal entre equipos.