Skip to content

Esta página se tradujo del original en coreano con IA y puede contener errores.

Capítulo 5. Comprobar y probar: dar un mecanismo de comprobación y recibir pruebas ​

En una línea: la IA se detiene cuando el trabajo parece terminado. Si le das un mecanismo de comprobación que le diga si de verdad ha terminado, la IA entra en un ciclo en el que se corrige y vuelve a comprobar por sí misma. Y en vez de «ya está todo aprobado», recibe pruebas (el comando que se ha ejecutado y su salida, o una captura de pantalla).

Este capítulo se escribió a partir de la documentación oficial de Claude Code y de GitHub consultada el 1 de noviembre de 2026. El hábito de contrastar el resultado con las notas originales que viste en la etapa 3 se automatiza en la etapa 4 con el nombre de «mecanismo de comprobación».

Por qué hace falta un mecanismo de comprobación ​

El documento oficial de buenas prácticas lo dice así. Claude se detiene cuando el trabajo parece terminado. Si no tiene nada que le diga si de verdad está terminado, «parece terminado» es todo lo que tiene para juzgar.[1] Entonces acabo siendo yo la prueba, y los errores se quedan ahí hasta que yo los descubra por casualidad.[2]

En cambio, si le das algo que responda aprobado/suspendido, Claude cierra el ciclo por sí mismo. Hace el cambio, pasa la comprobación y, si se ha roto, lee la salida, lo corrige y vuelve a pasarla.[3]

Sin mecanismo de comprobaciónCon mecanismo de comprobación
«Ya está» → yo lo abro y busco lo que está malLa comprobación falla → Claude lo corrige → vuelve a comprobar → aprueba

Fuente: resumen de esta guía (la base está en la documentación oficial)[3:1]

Comprueba lo aprendido

¿Qué cambia si le das un mecanismo de comprobación (una prueba que responde pasa/falla)?

Tipos de mecanismos de comprobación ​

Un mecanismo de comprobación puede ser cualquier cosa de la que Claude pueda leer el resultado. La documentación oficial pone como ejemplos un archivo de pruebas, si la compilación ha tenido éxito, un verificador de sintaxis, un script que compara salidas y la pantalla del navegador comparada junto a un boceto.[4] Si tienes alguno de ellos, llega a decir que la línea más útil del CLAUDE.md es el comando que lo ejecuta.[5]

El método más fácil es escribirlo en la petición. Sirve hoy mismo, sin ajustes.[6]

Después de corregir el tablero de tareas, comprueba una por una las condiciones de comprobación de SPEC.md y sigue hasta que pasen todas.

En la aplicación de escritorio, Claude puede arrancar un servidor de desarrollo y abrirlo en la ventana del navegador de la aplicación para comprobar sus propios cambios. Por defecto lo comprueba automáticamente cada vez que edita.[7] Es un mecanismo que encaja bien con el tablero de tareas, que es una página web.

Cuando pidas pruebas, di con concreción qué comportamiento hay que comprobar.[8]

Petición mejorablePetición mejor
Hazme pruebasHazme una prueba que compruebe que las 5 tareas del acta se ven todas en la pantalla y que el plazo tiene formato de fecha

Fuente: ejemplo de esta guía (el consejo es de la documentación oficial)[8:1]

Comprueba lo aprendido

Si ya hay un mecanismo de comprobación, ¿cuál dice la documentación oficial que es la línea más útil de CLAUDE.md?

Recibir pruebas ​

Uses el mecanismo que uses, pide pruebas: el comando que se ha ejecutado y su salida, o una captura de pantalla.[9] Con solo la frase «ya han pasado todas» se sabe casi nada, y leer la salida es más rápido que volver a ejecutarlo tú mismo.[9:1]

Enséñame tal cual el comando de comprobación que acabas de ejecutar y su salida. Y también cuántas han pasado y cuántas han fallado.

Comprueba también que la comprobación comprueba de verdad. Una comprobación que no falla cuando se hace mal a propósito no es un mecanismo, es un adorno. Por ejemplo, ejecútala después de borrar una tarea y mira si la comprobación falla.

Comprueba lo aprendido

Claude dijo: «He pasado todas las pruebas». ¿Qué respuesta recomienda esta guía?

Automáticamente cada vez que subes: GitHub Actions ​

Puedes hacer que no tengas que pedir la comprobación a mano cada vez. GitHub Actions es la función de GitHub que ejecuta automáticamente compilaciones, pruebas y despliegues. Puedes hacer que se pasen las pruebas cada vez que subes un cambio.[10]

  • Lo que hay que hacer se define con un archivo YAML (archivo de configuración) que pones en la carpeta .github/workflows del repositorio.[11]
  • El hábito de hacer commits a menudo y comprobar a menudo se llama integración continua (CI). Te permite encontrar los errores pronto.[12]
  • GitHub muestra el resultado de la comprobación en la pantalla del PR del capítulo 6. Puedes ver enseguida si los cambios de tu rama han provocado un error.[12:1]
  • En los repositorios públicos puedes usar gratis los ejecutores estándar que ofrece GitHub.[13]

El archivo de configuración puedes pedírselo a Claude. Aunque al principio basta con lo de «escribirlo en la petición» y con la comprobación en el navegador. No hace falta tener toda la automatización desde el primer día.

Comprueba lo aprendido

¿Qué afirmación sobre GitHub Actions es correcta?

Pruébalo tú mismo ​

  1. En la rama first-board del capítulo 4, pide que cree un mecanismo que compruebe las condiciones de comprobación de SPEC.md.
  2. Pasa la comprobación y pide que te enseñe tal cual el comando ejecutado y su salida.
  3. Borra una tarea a propósito, vuelve a pasarla y mira si la comprobación falla. Cuando lo hayas comprobado, deshazlo.
  4. Abre el tablero de tareas en la ventana del navegador de la aplicación y cuenta tú mismo el número de tareas.
  5. Anota en una línea del CLAUDE.md el comando de comprobación.

Proyecto continuo: en el capítulo 6 subirás a un PR los cambios hechos hasta ahora y recibirás una revisión.

Resumen ​

  • La IA se detiene cuando parece terminado. Si le das un mecanismo de comprobación que responda aprobado/suspendido, se corrige y vuelve a comprobar por sí misma.
  • Un mecanismo de comprobación puede ser una prueba, una compilación, un script de comparación, una pantalla del navegador… cualquier cosa de la que Claude pueda leer el resultado.
  • En vez de «han pasado todas», recibe pruebas: el comando y la salida. Comprueba también que la comprobación falla si se hace mal a propósito.
  • GitHub Actions comprueba automáticamente cada vez que subes. En los repositorios públicos los ejecutores estándar son gratuitos.

Glosario ​

TérminoEn españolEn una línea
TestPrueba (test)Comprobación que verifica automáticamente si el resultado es el esperado
CICIHábito de integrar a menudo y comprobar automáticamente a menudo (integración continua)
GitHub ActionsGitHub ActionsFunción que ejecuta automáticamente tareas fijadas cada vez que subes algo
YAMLYAMLFormato de texto que se usa en la configuración de tareas automáticas

¿Terminaste este capítulo?

El progreso se guarda solo en este navegador. Puedes ver tu avance en el índice completo.

Siguiente capítulo: Capítulo 6. PR y revisión

Referencias (13)
  1. Documentación oficial de Claude Code, «Best practices for Claude Code». "Claude stops when the work looks done. If it has nothing to run that tells it whether the work actually is done, "looks done" is all it has to go on." code.claude.com (consultado el 2026-11-01) ↩︎

  2. Documentación oficial de Claude Code, «Best practices for Claude Code». "In practice that makes you the test suite, and every mistake sits there until you happen to notice it." code.claude.com (consultado el 2026-11-01) ↩︎

  3. Documentación oficial de Claude Code, «Best practices for Claude Code». "If you give it something that comes back pass or fail, Claude can close that loop itself." code.claude.com (consultado el 2026-11-01) ↩︎

  4. Documentación oficial de Claude Code, «Best practices for Claude Code». "The check can be almost anything, as long as Claude can read the result:" / "A test file" / "A build's exit code" / "A linter" / "A script that diffs output against a fixture" code.claude.com (consultado el 2026-11-01) ↩︎

  5. Documentación oficial de Claude Code, «Best practices for Claude Code». "If your repo already has one of these, the single most useful line in your CLAUDE.md is the command that runs it." code.claude.com (consultado el 2026-11-01) ↩︎

  6. Documentación oficial de Claude Code, «Best practices for Claude Code». "In the prompt: run the auth tests after, and keep going until they pass. Claude decides for itself when it's satisfied." code.claude.com (consultado el 2026-11-01) ↩︎

  7. Documentación oficial de Claude Code, «Desktop application». "Claude can start a dev server and open it in the Browser pane to verify its changes." / "By default, Claude auto-verifies changes after every edit." code.claude.com (consultado el 2026-11-01) ↩︎

  8. Documentación oficial de Claude Code, «Common workflows». "When asking for tests, be specific about what behavior you want to verify." code.claude.com (consultado el 2026-11-01) ↩︎

  9. Documentación oficial de Claude Code, «Best practices for Claude Code». "Whichever option you use, ask Claude for evidence: the command it ran and its output, or the screenshot." / "reading the output is faster than rerunning the check yourself." code.claude.com (consultado el 2026-11-01) ↩︎

  10. Documentación oficial de GitHub, «Quickstart for GitHub Actions». "GitHub Actions is a continuous integration and continuous delivery (CI/CD) platform that allows you to automate your build, test, and deployment pipeline." / "You can create workflows that run tests whenever you push a change to your repository, or that deploy merged pull requests to production." docs.github.com (consultado el 2026-11-01) ↩︎

  11. Documentación oficial de GitHub, «Understanding GitHub Actions». "Workflows are defined in the .github/workflows directory in a repository." docs.github.com (consultado el 2026-11-01) ↩︎

  12. Documentación oficial de GitHub, «Continuous integration». "Committing code more often detects errors sooner and reduces the amount of code a developer needs to debug when finding the source of an error." / "GitHub runs your CI tests and provides the results of each test in the pull request, so you can see whether the change in your branch introduces an error." docs.github.com (consultado el 2026-11-01) ↩︎

  13. Documentación oficial de GitHub, «Billing and usage». "GitHub Actions usage is free for standard GitHub-hosted runners in public repositories, and for self-hosted runners." docs.github.com (consultado el 2026-11-01) ↩︎