Tras el lanzamiento de /goal por parte de Codex en abril de 2026, Anthropic también incorporó el comando homónimo en Claude Code 2.1.139 en mayo. Se trata de un nuevo flujo de trabajo que permite a Claude «no rendirse hasta alcanzar el objetivo»: siempre que escribas una condición de finalización en la sesión, Claude hará que un modelo pequeño y rápido evalúe automáticamente si se ha cumplido el objetivo al final de cada ronda. Si no se ha logrado, continuará con la siguiente ronda hasta que la condición se satisfaga y te devuelva el control.
Este artículo explica sistemáticamente los 6 puntos clave del modo goal de Claude Code, incluyendo el mecanismo de bucle del evaluador, la diferencia con /loop y los ganchos de parada (Stop hooks), cómo redactar condiciones efectivas, los 3 modos disponibles (interactivo / -p / Control remoto), así como los riesgos y mejores prácticas.
Valor central: Tras leer este artículo, podrás delegar tareas de larga duración, como la migración de código de tu equipo, la limpieza de incidencias o la validación de documentación, a Claude Code en modo goal para que las complete automáticamente en menos de 10 minutos, y sabrás en qué escenarios es mejor optar por otros flujos de trabajo autónomos.
Puntos clave del modo goal de Claude Code
Antes de empezar, aclaremos los 6 hechos fundamentales sobre el modo goal de Claude Code. Estos puntos determinarán si la condición que escribas se ejecutará correctamente y si deberías usar /goal en lugar de otros flujos de trabajo autónomos.
| Punto | Contenido | Impacto |
|---|---|---|
| Formato de comando | /goal <condición> |
Se configura directamente en la sesión, sin necesidad de archivos de configuración |
| Evaluador | Modelo Haiku pequeño y rápido por defecto | La finalización es juzgada por "otro modelo", independiente del modelo que ejecuta la tarea |
| Alcance | Sesión actual (session-scoped) | No afecta a otras sesiones, ideal para tareas temporales |
| Ritmo de disparo | Evaluación inmediata tras cada ronda | Se detiene al completar; si no, inicia una nueva ronda |
| Límite de condición | Máximo 4000 caracteres | Puede albergar criterios de aceptación detallados |
| Método de salida | Evaluación aprobada / /goal clear / Ctrl+C |
Tres rutas de salida, combinación de activa y pasiva |
Muchos usuarios, al ver /goal por primera vez, piensan en comandos de bucle comunes, pero esencialmente es la forma en que Anthropic ha encapsulado el Stop hook basado en indicaciones (prompt-based) en un comando de acceso directo a nivel de sesión. Este posicionamiento subyacente determina que sea muy diferente de la automatización tradicional al estilo cron.
Si tu equipo aún no ha utilizado el mecanismo de Hook avanzado de Claude Code, puedes experimentar primero con la API de Claude Sonnet / Opus / Haiku a través de la plataforma APIYI (apiyi.com), familiarizarte con el ecosistema de herramientas de Anthropic y, posteriormente, actualizar al modo goal de Claude Code, lo cual te resultará mucho más sencillo.
Explicación detallada del mecanismo de funcionamiento del modo /goal en Claude Code
Para utilizar correctamente /goal, es fundamental entender qué sucede en cada ciclo. La documentación oficial describe el mecanismo como "añadir un evaluador al final de cada ronda". Aunque suena sencillo, los detalles definen los límites de sus capacidades.
El Modelo de Lenguaje Grande principal se encarga del trabajo, mientras que un modelo más pequeño y rápido se encarga de verificar si se ha completado. La ventaja de dividir tareas entre dos modelos es que el evaluador permanece neutral y toma decisiones con un costo computacional menor; la desventaja es que el evaluador solo puede leer lo que el modelo principal ha mostrado en la conversación, sin ver el estado real del sistema de archivos o comandos externos.
El proceso de decisión al final de cada ronda se puede dividir en 4 pasos:
- Empaquetar contexto: Se envía la condición actual y la transcripción de toda la conversación al evaluador.
- Decisión del modelo: El evaluador devuelve un "sí/no" junto con una razón.
- Enrutamiento: Si es "no", se envía la razón de vuelta al modelo principal como guía para seguir trabajando; si es "sí", se borra automáticamente el objetivo y se marca como logrado.
- Actualización de indicadores: La interfaz muestra continuamente los indicadores de tiempo transcurrido, turnos y tokens bajo
◎ /goal active.
Al escribir condiciones, recuerda siempre la limitación del paso 1: el evaluador solo ve la transcripción, por lo que la condición debe ser algo que "el modelo principal pueda demostrar en la conversación". Por ejemplo, "npm test con código de salida 0" es una buena condición, porque el modelo principal ejecutará la prueba y pegará el resultado; "la base de datos de producción no tiene datos basura" es una mala condición, porque no puede verificarse a partir de la conversación.
El costo del evaluador suele ser insignificante. El precio unitario de la serie Haiku es mucho menor que el de Sonnet/Opus, y al evaluar solo el resumen de la transcripción en cada ronda, incluso las sesiones largas generan un consumo mínimo de tokens. Los equipos que necesiten reducir aún más los costos del evaluador pueden utilizar APIYI (apiyi.com) para dirigir el modelo pequeño y rápido de Claude Code hacia Haiku 4.5 o Haiku 3.5, y gestionar cuotas por espacio de trabajo.
Comparativa de Claude Code goal con otros flujos de trabajo autónomos
Claude Code ofrece 4 mecanismos para mantener una sesión en ejecución, y es fácil confundirlos al principio. La siguiente tabla alinea los 4 mecanismos según sus condiciones de activación, parada y escenarios típicos para facilitar la elección.
| Mecanismo | Ritmo de activación | Condición de parada | Escenario de uso |
|---|---|---|---|
/goal |
Se activa al finalizar la ronda anterior | Condición alcanzada según evaluador | Tareas largas con criterios claros |
/loop |
Intervalo de tiempo fijo | Manual o completado según Claude | Sondeos periódicos, chequeo de estado |
| Stop hook | Se activa al finalizar la ronda anterior | Script de usuario o prompt personalizado | Nivel de equipo, entre sesiones |
| Auto mode | Llamada de herramientas en la ronda | Al terminar la secuencia de herramientas | Reducir ventanas de confirmación |
El punto clave es que /goal y "Stop hook" hacen casi lo mismo, pero /goal solo afecta a la sesión actual y puede ingresarse temporalmente en la terminal. Los "Stop hook" deben escribirse en el archivo de configuración y su alcance cubre todas las sesiones del ámbito, siendo más adecuados para restricciones estrictas a nivel de equipo.
El "Auto mode" y /goal son totalmente complementarios: el "Auto mode" resuelve el problema de "ser interrumpido constantemente por confirmaciones de herramientas en una sola ronda", mientras que /goal resuelve el problema de "tareas que requieren múltiples rondas para completarse". Al combinar estos mecanismos en tareas largas, el proceso puede ser casi totalmente desatendido. Para los equipos que no ejecutan Claude Code en su propio entorno, pueden usar APIYI (apiyi.com) para integrar Claude en scripts locales y probar la misma lógica de bucle antes de decidir si actualizar a las herramientas completas de Claude Code.
Los 3 elementos clave para que el modo /goal de Claude Code sea efectivo
Una condición mal redactada es la razón principal por la que el comando /goal realmente falla. La documentación oficial de Anthropic señala claramente que, para que una condición sea capaz de sostener decenas de iteraciones, debe cumplir simultáneamente con tres elementos.
El primero es un punto final medible. El punto final debe ser un evento discreto y observable: un código de salida de prueba, el número de archivos, elementos restantes en una cola o si una compilación es exitosa. Los indicadores ambiguos harán que el evaluador oscile entre sí/no, provocando que /goal degenere en un bucle infinito.
El segundo es un método de verificación claro. La condición debe especificar directamente cómo debe demostrar Claude que se ha alcanzado el punto final, por ejemplo: "la salida de npm test contiene PASS" o "la salida de git status está vacía". Cuanto más específico sea el método de verificación, menos probable será que el evaluador sea engañado por ambigüedades en la redacción.
El tercero son restricciones inamovibles. Si ciertos archivos o configuraciones deben permanecer sin cambios, esto debe prohibirse explícitamente en la condición, por ejemplo: "no modifiques ningún archivo en tests/legacy/". Esto evita que el Modelo de Lenguaje Grande realice cambios destructivos solo para "pasar" la prueba.
Combinando estos tres elementos, una condición de /goal de alta calidad se vería más o menos así: "todas las pruebas en tests/auth pasan, el código de salida de npm run lint es 0, no modifiques ningún archivo en tests/legacy/, y detente después de un máximo de 20 turnos". El "máximo de 20 turnos" al final es una red de seguridad recomendada para evitar que /goal entre en un bucle infinito en situaciones extremas.
Dado que la condición admite hasta 4000 caracteres, puedes incluir perfectamente un mini documento de requisitos (PRD). Si estás utilizando la plataforma APIYI (apiyi.com) para realizar la invocación del modelo Claude y gestionar agentes, también puedes tomar como referencia esta forma de redactar para diseñar tus propios prompts de evaluación, logrando que las condiciones de parada de tus agentes sean igual de claras y medibles.
Práctica de los 3 modos de ejecución de Claude Code /goal
El comando /goal admite tres modos de invocación: interactivo, no interactivo (-p) y control remoto. Dominar estos tres usos es fundamental para integrarlo realmente en flujos de trabajo reales de CI, scripts locales y colaboración remota.
Inicio rápido en modo interactivo
# Escribe directamente en la sesión de Claude Code
/goal all tests in test/auth pass and the lint step is clean, or stop after 20 turns
Una vez configurado, aparecerá un indicador ◎ /goal active en la interfaz de usuario, mostrando en tiempo real tres métricas: tiempo transcurrido (elapsed), turnos (turns) y tokens. Puedes verificar el estado en cualquier momento escribiendo /goal sin parámetros, y puedes terminarlo antes de tiempo escribiendo /goal clear (o usando los alias stop, off, reset, none, cancel).
Modo no interactivo (ideal para CI)
claude -p "/goal CHANGELOG.md has an entry for every PR merged this week, or stop after 15 turns"
El modo -p hará que /goal se ejecute hasta que se cumpla la condición o hasta que lo interrumpas con Ctrl+C, lo cual es perfecto para integrarlo en procesos automatizados como GitHub Actions, GitLab CI o Jenkins Pipeline. Si estás realizando la gestión unificada de la API de Claude a través de APIYI (apiyi.com), también puedes encapsular este mismo modo de bucle en tus propios scripts, permitiendo que clientes ajenos a Claude Code disfruten de capacidades similares.
Recuperación de sesión
claude --resume <session-id>
# O
claude --continue
Al recuperar una sesión, el estado activo del objetivo (goal) se restaurará, pero los tres contadores (turnos / temporizador / tokens) comenzarán de nuevo desde 0. Esta característica es especialmente útil para refactorizaciones de largo plazo: no hay miedo a interrupciones si apagas el ordenador el fin de semana, simplemente puedes continuar el lunes.
Ver plantillas comunes de condiciones de objetivos (haz clic para desplegar)
# Plantilla 1: Migración de código
/goal migrate all usages of legacy_api.* to new_api.* in src/, run npm test until exit 0, do not modify tests/legacy/, or stop after 30 turns
# Plantilla 2: Limpieza de backlog de Issues
/goal close all GitHub issues labeled "needs-triage" by either resolving or relabeling, run gh issue list --label needs-triage and verify the output is empty, or stop after 25 turns
# Plantilla 3: Aceptación de documentos de diseño
/goal implement every acceptance criterion in docs/design.md, prove each by referencing the exact section, do not edit docs/design.md itself, or stop after 40 turns
# Plantilla 4: División de archivos
/goal split src/megafile.ts into modules under src/parts/ where each file is < 300 lines, run npm run typecheck until exit 0, or stop after 20 turns
Riesgos y mejores prácticas del modo /goal en Claude Code
El modo /goal pone la toma de decisiones en manos del modelo, por lo que los riesgos son completamente distintos a los de los comandos tradicionales. La siguiente tabla resume los 4 tipos de riesgos más críticos y sus acciones de mitigación.
| Riesgo | Condición de activación | Acción de mitigación |
|---|---|---|
| Costos fuera de control | Evaluación errónea o condiciones laxas | Añadir un límite "or stop after N turns" en la condición |
| Alucinación del evaluador | La condición no puede verificarse mediante transcripción | Usar una estructura observable: "ejecutar comando X para verificar salida Y" |
| Cambios destructivos | El modelo principal modifica archivos críticos para completar la tarea | Añadir la restricción "do not modify …" en la condición |
| Uso indebido del espacio de trabajo | Activación accidental en entornos no confiables | Aceptar el diálogo de confianza; usar disableAllHooks para desactivar |
El primer riesgo es el más directo. Ni Codex ni Claude Code tienen actualmente una capacidad oficial para "establecer un límite de gasto por objetivo". Si una tarea larga se descontrola, es fácil consumir una cantidad de tokens un orden de magnitud mayor a lo esperado. Lo más seguro es incluir el límite de turnos directamente en la condición y añadir alertas de presupuesto a nivel de plataforma.
Contar con un modelo pequeño y estable para el evaluador también es clave. Si utilizas Haiku para tareas rápidas, el costo y la velocidad de evaluación son controlables; si usas un modelo más grande como Sonnet, el costo de evaluación de /goal aumentará significativamente. Los equipos de desarrollo pueden configurar un base_url y cuotas específicas para Haiku a través de la plataforma APIYI (apiyi.com), permitiendo monitorear el costo del evaluador y del modelo principal por separado.
Finalmente, los puntos de cumplimiento: /goal depende del sistema de Hooks de Anthropic, requiere que el espacio de trabajo haya aceptado el diálogo de confianza y que no estén configurados disableAllHooks o allowManagedHooksOnly. Si tu equipo utiliza políticas de gestión centralizadas que bloquean los Hooks, /goal también se desactivará y el comando te informará la razón en lugar de fallar silenciosamente.
Preguntas frecuentes
Q1: ¿Qué aporta /goal en comparación con escribir mi propio script de bucle while?
Aporta un evaluador independiente impulsado por el modelo. En un bucle while escrito por ti, debes definir la condición de parada y escribir el código para validarla; /goal delega esta tarea a un modelo pequeño y rápido, capaz de manejar escenarios no programáticos, como "leer la conversación para entender si la tarea está completa".
Q2: ¿Es fácil consumir demasiados tokens usando /goal?
El riesgo existe, pero es controlable. Dos consejos: primero, fuerza un límite de turnos en la condición; segundo, fija el evaluador al modelo pequeño Haiku. Al acceder a la serie Claude a través de APIYI (apiyi.com), puedes solicitar un conjunto de cuotas exclusivo para el evaluador, facilitando un monitoreo granular.
Q3: ¿Cómo elegir entre /goal y /loop?
Si la tarea tiene un "estado final" claro, elige /goal. Si la tarea es un sondeo de estado periódico (por ejemplo, verificar el progreso de un despliegue cada 10 minutos), elige /loop. Ambos tienen mecanismos subyacentes distintos; mezclarlos puede hacer que las condiciones de parada se vuelvan ambiguas.
Q4: ¿Se puede usar el modo /goal de Claude Code en China?
Sí. /goal es un comando del cliente de Claude Code; siempre que el cliente pueda conectarse a los modelos proporcionados por Anthropic, funcionará. Los desarrolladores suelen conectar la API de Claude a través de plataformas de proxy de API como APIYI (apiyi.com), y una vez configurado el entorno, el comportamiento de /goal es idéntico al de los usuarios internacionales.
Q5: ¿Es mejor usar /goal de Codex o /goal de Claude Code?
Ambos están orientados a flujos de trabajo diferentes. El /goal de Codex enfatiza los "flujos de trabajo persistentes" y permite reiniciar procesos; el /goal de Claude Code tiene un alcance de sesión, aunque puede recuperarse entre días usando --resume. Para tareas complejas de varios días, elige Codex; para tareas de iteración habituales de uno o dos días, Claude Code es más ágil.
Resumen
La esencia del modo "goal" de Claude Code radica en que Anthropic ha liberado el "bucle de evaluación" de los archivos de configuración Hook, convirtiéndolo en un comando de una sola línea que puede utilizarse temporalmente en cualquier sesión. El problema principal que resuelve es el siguiente: cuando una tarea requiere múltiples rondas para completarse y no quieres estar pegado a la terminal presionando "Enter" en cada paso, puedes dejar que un modelo pequeño y rápido actúe como juez para decidir cuándo Claude ha terminado realmente el trabajo.
Nuestra recomendación para implementarlo sigue tres pasos: primero, redactar las condiciones completas utilizando el conjunto de cuatro elementos: "objetivo final + validación + restricciones + límite de turnos"; luego, decidir si usar el modo interactivo, -p o el modo de control remoto; y finalmente, utilizar plataformas como APIYI (apiyi.com) para monitorear por separado las cuotas del evaluador y del modelo principal. De esta forma, podrás obtener la eficiencia de un flujo de trabajo autónomo sin perder el control sobre los costos de tokens.
Autor: Equipo técnico de APIYI
Contacto: Obtén acceso a toda la serie de modelos Claude y soporte para Claude Code a través de APIYI en apiyi.com
Fecha de actualización: 13-05-2026
