Claude Code no es solo un autocomplete glorificado. Es un runtime de agentes con acceso completo a tu filesystem, terminal y capacidad de ejecutar cualquier comando. Cuando entiendes eso, las posibilidades cambian.

El punto de partida

Quería un agente simple: monitorizar un directorio src/, detectar cambios en archivos .ts, ejecutar los tests afectados y reportar el resultado. Sin configurar watchers externos. Sin CI. Solo Claude haciendo el trabajo.

El prompt inicial fue así de directo:

claude "Monitoriza el directorio src/. Cuando detectes cambios en archivos .ts,
ejecuta los tests relacionados con npx jest y reporta el resultado con un resumen
de qué pasó y qué falló."

Claude Code tiene acceso a Bash y Read tools de serie. Sabe ejecutar comandos y leer archivos. El agente funcionó en el primer intento — no porque el prompt fuera perfecto, sino porque la tarea encajaba con las herramientas disponibles.

Añadiendo persistencia con un CLAUDE.md

El problema con el agente anterior es que pierde contexto entre sesiones. La solución es un CLAUDE.md en la raíz del proyecto — Claude Code lo lee automáticamente al iniciar.

# Proyecto: API de usuarios

## Stack
- TypeScript + Node.js
- Jest para tests
- PostgreSQL con Drizzle ORM

## Convenciones de tests
- Los tests viven en `src/__tests__/`
- Nombre del archivo: `[feature].test.ts`
- Ejecutar solo los tests del módulo afectado: `npx jest [filename]`

## Reglas del agente
- Si un test falla, busca primero el error en los logs antes de editar código
- No modifiques archivos fuera de `src/`

Con este contexto persistente, el agente tiene las instrucciones necesarias para operar correctamente incluso en sesiones nuevas.

El resultado

El agente tardó unos 3 minutos en configurarse y funcionó de forma fiable durante semanas. La clave no fue la complejidad del prompt sino la claridad: tarea concreta, herramientas conocidas, restricciones explícitas.

Lo que me sorprendió fue la capacidad de Claude para encadenar acciones: detectar el archivo cambiado → identificar qué tests ejecutar → correr los tests → parsear el output → reportar solo los fallos con contexto. Todo eso sin código adicional de mi parte.

Si tienes una tarea que se puede describir en lenguaje natural y ejecutar con comandos de terminal, probablemente puedas automatizarla con Claude Code en menos tiempo del que crees.