Claude Code y Codex: cómo reducir errores repetidos

Cómo usar CLAUDE.md, AGENTS.md y pruebas para reducir errores repetidos en Claude Code y Codex. Ejemplos e instrucciones para copiar.

Para reducir errores repetidos en Claude Code y Codex, combiná instrucciones persistentes, tareas acotadas y pruebas que detecten el fallo. Guardar una corrección ayuda a futuras sesiones, pero no garantiza que se cumpla. La mejora aparece cuando podés comprobar qué cambió y conservar ese criterio en el proyecto.

¿Te encontraste explicando por tercera vez algo que ya habías corregido? Antes de cambiar de modelo, revisá el proceso. Tal vez la indicación quedó en el chat, contradice otra regla o nunca se verificó. Proponemos un ejemplo didáctico: un formulario que permite enviar consultas sin email. No representa un resultado de un cliente.

¿Dónde guardar las instrucciones: CLAUDE.md o AGENTS.md?

En Claude Code podés usar CLAUDE.md para las reglas del proyecto; en Codex, AGENTS.md. Dentro de sus interfaces de terminal, /init permite generar un punto de partida. Revisá lo propuesto: rutas, comandos y restricciones deben coincidir con tu repositorio. No ejecutes ese comando como si fuera una instrucción del shell.

/init

Una regla útil describe cuándo actuar, qué hacer y cómo comprobarlo. Para el formulario: “Si falta el email, bloqueá el envío y mostrale un aviso al usuario”. Guardá también el comando de prueba que realmente utiliza ese proyecto. Mantené el archivo breve y eliminá instrucciones contradictorias o vencidas.

Persistencia no significa garantía: Estas instrucciones aportan contexto; no reentrenan el modelo ni reemplazan las validaciones del programa. Claude Code también dispone de memoria automática: conviene revisar qué conserva, sin asumir que guardó cada corrección.

Cómo dividir una tarea sin perder el objetivo

Trabajá en tres entregas verificables. Primero, entender; después, corregir; por último, demostrar. Ese orden permite detectar un diagnóstico equivocado antes de acumular cambios. No hace falta abrir tres conversaciones: podés pedir estas etapas dentro de una misma sesión.

• Diagnóstico: “Reproducí el envío sin email y explicá dónde falta la validación”.
• Cambio: “Corregí ese comportamiento sin modificar el diseño ni otras funciones”.
• Verificación: “Probá con email vacío y válido; mostrá el resultado de cada caso”.

Si delegás a varios agentes, asigná responsables y archivos distintos. Uno puede investigar y otro revisar pruebas, pero acordá quién integra los cambios. Cuando dos personas o agentes editan el mismo lugar sin coordinación, el problema pasa a ser la organización del trabajo.

Qué pedir después de corregir el error

Pedí una prueba de regresión: una comprobación diseñada para detectar ese mismo fallo si reaparece. Debería fallar en una versión sin el arreglo y pasar después. La comparación se hace en un entorno de prueba; no requiere deshacer cambios en producción. Podés usar esta instrucción:

Agregá una prueba para el envío sin email.
Verificá que detecte el fallo y pase con el arreglo.
Probá también un email válido.
Guardá la regla breve y el comando de prueba
en el archivo de instrucciones del proyecto.

En algunos proyectos Node, npm test ejecuta el script test de package.json. Primero confirmá que exista y qué cubre. Un comando que termina bien no demuestra por sí solo que se haya probado el formulario. Pedí el nombre del caso, su resultado y cualquier comprobación pendiente.

¿Qué hacer si vuelve a pasar?

Revisá si el agente leyó la regla, si hay otra instrucción incompatible y si la prueba cubre el escenario real. En la siguiente sesión, pedile que identifique las instrucciones aplicables antes de modificar archivos. Si cambia el requisito, actualizá también la verificación: conservar una regla equivocada puede perpetuar el problema.

¿Qué error te gustaría dejar de explicar? Elegí uno y probá este recorrido. En MAMBO ayudamos a revisar procesos e implementar IA con criterios comprobables. La pregunta útil es qué evidencia necesitás para confiar en la próxima ejecución.

Para seguir trabajando el enfoque y aplicarlo a tu equipo:
Implementación de IA en MAMBO
El primer modelo a cambiar es el nuestro

Fuentes y alcance

Guía elaborada con documentación oficial consultada el 21 de septiembre de 2026. Los comandos dependen de la versión y del proyecto; los ejemplos son orientativos.
Memoria e instrucciones de Claude Code
AGENTS.md en Codex
Comandos de Codex CLI