Cómo Claude Code Ejecuta el Bucle Leer-Editar-Ejecutar-Verificar
Claude Code no es un motor de autocompletado que adivina un archivo y se detiene.
Es un agente que trabaja como lo hace un ingeniero: mira el código, cambia el código, ejecuta algo para comprobar el cambio y luego vuelve a mirar.
Ese ciclo, leer, editar, ejecutar, verificar, es el núcleo mecánico de casi todo lo que hace Claude Code, desde una corrección de un error tipográfico de una línea hasta una refactorización de varios archivos.
Comprender el bucle es importante porque explica lo que realmente estás viendo suceder en tu terminal y por qué Claude Code se comporta de manera tan diferente a un generador de código de un solo disparo.
Resumen
- Idea Central: Claude Code repite un ciclo de leer, editar, ejecutar, verificar, utilizando la salida real de cada comando para decidir su siguiente paso, hasta que la tarea se completa o se bloquea.
- Por Qué Importa: Un generador de un solo disparo solo puede adivinar; un bucle que lee la salida real puede detectar sus propios errores antes de que lleguen a ti.
- Conceptos Clave: el paso de leer (cargar el estado actual del archivo), el paso de editar (proponer un cambio), el paso de ejecutar (ejecutar un comando), el paso de verificar (interpretar el resultado) y la iteración (repetir el ciclo hasta que se complete).
- Cuándo Usar: Este es el comportamiento predeterminado para cualquier tarea no trivial de Claude Code; no hay un modo separado para activarlo.
- Limitaciones / Compensaciones: El bucle solo es tan bueno como los comandos disponibles para ejecutar; sin pruebas o un paso de compilación, la verificación es más débil y es más probable que los errores pasen desapercibidos.
- Temas Relacionados: relectura de archivos antes de las ediciones, búsqueda en la base de código, ediciones de varios archivos, iteración de pruebas automatizadas, avisos de permiso.
Fundamentos
El bucle tiene cuatro pasos, y vale la pena nombrar cada uno con precisión.
Leer significa que Claude Code abre el archivo o archivos relevantes y mira su contenido actual y real, no una memoria de lo que probablemente contienen.
Editar significa que propone un cambio específico: una nueva función, una línea modificada, una variable renombrada, expresado como un diff concreto contra lo que acaba de leer.
Ejecutar significa que ejecuta un comando, un conjunto de pruebas, un linter, una compilación, un script único, y captura la salida real: código de salida, stdout, stderr.
Verificar significa que lee esa salida y decide qué significa: ¿pasó la prueba, falló la compilación, marcó algo nuevo el linter?
El bucle no es leer-editar-hecho.
Es leer-editar-ejecutar-verificar, y luego, si la verificación indica que el trabajo no está terminado, volver a leer (o ir directamente a otra edición) y dar la vuelta de nuevo.
Una forma sencilla de visualizar un paso a través del bucle:
LEER archivo(s)
|
v
EDITAR (proponer un diff)
|
v
EJECUTAR un comando (prueba / compilación / lint)
|
v
VERIFICAR la salida
|
+--- ¿tarea completada? --> detener
|
+--- ¿no completada? --> volver a LEER o EDITAR
Este es el mismo ritmo que un desarrollador cuidadoso ya usa manualmente: abrir el archivo, hacer el cambio, ejecutar las pruebas, comprobar el resultado, arreglar lo que se rompió, ejecutar de nuevo.
Claude Code simplemente ejecuta ese ritmo explícitamente y puede repetirlo muchas veces sin que un humano reescriba cada comando.
Mecánicas e Interacciones
El paso de lectura está deliberadamente anclado en el contenido real actual del archivo en lugar de una suposición.
Si Claude Code ya miró un archivo anteriormente en la conversación, no necesariamente trata esa lectura anterior como todavía válida para cuando esté listo para editar; una copia obsoleta es una fuente común de parches fallidos, por lo que una lectura fresca justo antes de editar es parte de cómo el bucle se mantiene confiable (un artículo separado en esta sección, enlazado abajo, cubre exactamente por qué ocurre esa relectura).
El paso de edición produce un cambio concreto y aplicable en lugar de una descripción vaga del mismo.
Eso es importante para el paso de ejecución: un cambio que no se aplica realmente, o que introduce un error de sintaxis, aparecerá inmediatamente una vez que un comando intente usar el archivo, que es exactamente el tipo de señal que el bucle está diseñado para detectar temprano en lugar de dejar que una persona lo descubra más tarde.
El paso de ejecución es donde el bucle se conecta con el estado real de tu proyecto.
npm test
npm run build
npm run lint
pytest
go test ./...Cualquiera de estos, o un equivalente específico del proyecto, puede servir como paso de "ejecución".
El comando específico importa menos que el hecho de que su salida sea real: una prueba fallida imprime un error de aserción real, una compilación rota imprime un mensaje de compilador real, y Claude Code lee ese texto literal en lugar de asumir el éxito.
El paso de verificación es donde el bucle se gana su nombre.
La verificación no es Claude Code declarando "esto debería funcionar ahora"; es Claude Code leyendo el estado de salida real y la salida del comando que acaba de ejecutar y decidiendo, basándose en esa evidencia, si detenerse, continuar o cambiar de enfoque.
Un fallo de prueba en este paso no es un callejón sin salida, es información: qué aserción falló, qué valor se esperaba, qué valor se produjo, y esa información se retroalimenta directamente a la siguiente edición.
Los avisos de permiso se encuentran dentro de este bucle en el paso de ejecución específicamente, ya que ejecutar un comando es la acción que más probablemente necesite aprobación dependiendo de tu modo de permiso; las lecturas de archivos y, en muchas configuraciones, las ediciones de archivos pueden ser aprobadas automáticamente, mientras que un comando bash puede pausarse para un sí/no dependiendo de la configuración cubierta en la sección Claude Code 101 de este sitio.
Consideraciones Avanzadas y Aplicaciones
El bucle escala de un solo archivo a una base de código completa sin cambiar de forma.
Para una corrección de una línea, el ciclo podría ejecutarse una vez: leer el archivo, hacer la edición, ejecutar el linter, ver que pasa, detenerse.
Para una tarea más grande, "agregar un nuevo campo y pasarlo a través de la API, la capa de base de datos y el formulario del frontend", los mismos cuatro pasos se repiten en varios archivos y varias pasadas, y cada paso de verificación reduce lo que todavía necesita trabajo.
| Tamaño de la tarea | Forma típica del bucle | Qué verifica "verificar" usualmente |
|---|---|---|
| Corrección de una línea | Pasada única: leer, editar, ejecutar, verificar | Pasan el linter o el verificador de tipos |
| Corrección de error con reproducción | Pocas pasadas: leer, editar, ejecutar prueba, verificar, repetir | La prueba específica que falla ahora pasa |
| Característica de varios archivos | Muchas pasadas entre archivos: leer, editar conjunto, ejecutar suite, verificar, repetir | Suite de pruebas completa, compilación y cualquier sitio de llamada afectado |
Una segunda consideración es que el bucle solo es tan fuerte como lo que puede ejecutar.
Si un proyecto no tiene pruebas ni un paso de compilación, Claude Code aún puede leer, editar y ejecutar los comandos disponibles, pero el paso de verificación tiene mucha menos evidencia real de la que trabajar, por lo que los proyectos con una suite de pruebas rápida y confiable tienden a obtener una iteración notablemente más precisa que los proyectos sin una.
Una tercera consideración es que el bucle no requiere que un humano se siente y observe cada paso.
Una vez que una tarea está en marcha y el modo de permiso lo permite, Claude Code puede pasar por varias pasadas de leer-editar-ejecutar-verificar en un solo turno, solo volviendo a aparecer ante ti cuando la tarea se completa, se bloquea en una decisión que solo tú puedes tomar, o cuando un comando necesita aprobación explícita.
Conceptos Erróneos Comunes
- "Claude Code escribe código una vez y ya está." El valor completo del bucle reside en los pasos de ejecución y verificación; un cambio que no ha sido verificado contra un comando real se trata como incompleto, no como final.
- "El bucle siempre ejecuta la suite de pruebas completa." El paso de ejecución utiliza el comando apropiado para el cambio, un solo archivo de prueba, un linter, un verificador de tipos, una compilación completa, no necesariamente la suite completa cada vez.
- "La verificación significa que Claude Code confía en su propio juicio sobre la corrección." La verificación significa leer la salida literal de un comando que se ejecutó realmente; esa es una señal más fuerte que la autoevaluación.
- "Si una prueba falla, el bucle se detiene e informa del fallo." Una prueba fallida generalmente se trata como entrada para la siguiente edición, no como un punto final; el bucle continúa iterando dentro del mismo turno cuando puede hacerlo.
- "Releer un archivo a mitad del bucle es un esfuerzo perdido." Es una salvaguarda contra la edición de una copia obsoleta de un archivo que puede haber cambiado desde la última vez que se leyó, cubierto en detalle en un artículo complementario.
Preguntas Frecuentes
¿Cuáles son los cuatro pasos del bucle principal de Claude Code, en orden?
Leer el archivo relevante, proponer una edición, ejecutar un comando contra el resultado y verificar qué significa la salida de ese comando.
Si la verificación muestra que la tarea no está completa, el ciclo se repite desde leer o editar.
¿Claude Code siempre ejecuta pruebas como parte de este bucle?
Ejecuta el comando que se ajuste a la situación, que puede ser una suite de pruebas, un linter, un verificador de tipos o una compilación.
Las pruebas son la forma de verificación más común y fuerte cuando un proyecto las tiene, pero no son el único comando que el paso de ejecución puede usar.
¿Qué sucede si el paso de ejecución falla, por ejemplo, una prueba falla o una compilación se rompe?
Claude Code lee la salida de fallo real y la trata como información para la siguiente pasada: qué aserción falló, qué error informó el compilador o qué marcó el linter.
Eso generalmente se retroalimenta directamente a otra edición en lugar de finalizar la tarea.
¿Puede este bucle ejecutarse sin que un humano apruebe cada paso?
Dentro de un solo turno, sí, dependiendo de tu modo de permiso; Claude Code puede pasar por varias pasadas de leer-editar-ejecutar-verificar antes de volver a aparecer ante ti.
Los comandos que requieren aprobación explícita según tu configuración de permiso actual aún se detendrán para esa aprobación.
¿Por qué el bucle es más importante que el hecho de que Claude Code pueda "escribir código"?
Porque escribir código sin verificarlo contra una salida real es adivinar, y el bucle está diseñado específicamente para reemplazar las conjeturas con evidencia: un resultado de prueba real, un error de compilación real, una advertencia de lint real.
Eso es lo que diferencia un flujo de trabajo de agente de un generador de código de un solo disparo.
¿El bucle solo se aplica a correcciones de errores, o también a nuevas características?
Ambos. Una nueva característica generalmente pasa por más pasadas del bucle que una corrección de error de una línea, ya que generalmente toca más archivos, pero la forma del ciclo, leer, editar, ejecutar, verificar, es la misma en cualquier caso.
¿Qué pasa si mi proyecto no tiene pruebas para ejecutar?
Claude Code aún puede leer, editar y ejecutar los comandos disponibles, como una compilación o una verificación de tipos, pero con menos o más débiles verificaciones, el paso de verificación tiene menos evidencia real de la que trabajar, por lo que es más probable que los errores pasen desapercibidos.
¿Es "verificar" solo Claude Code diciendo que el código se ve correcto?
No, verificar significa específicamente interpretar la salida literal de un comando que se ejecutó realmente, un código de salida, un mensaje de error, una aserción que pasa o falla, no una opinión sin verificar sobre el código.
¿Dónde encajan los avisos de permiso en este bucle?
Se encuentran en el paso de ejecución, ya que ejecutar un comando es la acción que más probablemente necesite tu aprobación dependiendo de tu modo de permiso.
Las lecturas de archivos y, en muchas configuraciones, las ediciones de archivos pueden ser aprobadas automáticamente, mientras que ejecutar un comando bash puede pausarse para confirmación.
¿El bucle se detiene tan pronto como se aplica la edición de un archivo?
No, el bucle está orientado a que la tarea se complete, no a que se toque un solo archivo.
Para trabajos de varios archivos, se repite entre archivos y pasadas hasta que la verificación muestre que la tarea completa, no solo una edición, está terminada.
¿En qué se diferencia esto de pedirle a un LLM que "escriba una función" en una ventana de chat?
Una ventana de chat generalmente devuelve texto una vez, sin ningún mecanismo para verificar ese texto contra un archivo real, un comando real o un resultado de prueba real.
El bucle de Claude Code cierra esa brecha ejecutando comandos reales y leyendo su salida real antes de decidir que la tarea está terminada.
Relacionados
- Fundamentos de los Flujos de Trabajo Principales de Claude Code - practica el bucle de forma práctica con una tarea pequeña
- Por Qué Claude Code Relee Archivos Antes de Editarlos - la salvaguarda dentro del paso de lectura
- Ejecución de Pruebas e Iteración sobre Fallos Automáticamente - una mirada más profunda al paso de verificación en acción
- Cómo Claude Code Decide Cuándo Ejecutar un Comando vs Pedir Permiso - qué rige el comportamiento de aprobación del paso de ejecución
- Modos de Permiso Explicados: Aceptación Automática vs Preguntar Siempre - la configuración que da forma a la aprobación en todo el bucle
Versiones de Stack: Escrito contra la línea de modelos Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.