Agentes para tus gastos (Claude Code + Google Sheets)

Por qué este kit

Cargar los gastos a mano es la tarea que todos posponen: abrís el extracto, copiás, pegás, corregís categorías, y a fin de mes seguís sin saber cuánto gastaste ni en qué. Es repetitiva, mecánica y fácil de verificar: justo lo que un agente hace bien.

Este kit arma ese sistema con dos agentes de Claude Code. El primero carga el CSV de tu banco en una hoja de Google, categoriza los comercios nuevos y arma el resumen con gráficos. El segundo revisa en frío que los números cierren al centavo y deja la hoja prolija. El trabajo se hace y vos revisás.

Qué incluye

• Seis prompts, uno por tarea — los pegás en orden. Cada uno termina con una lista de verificación: si Claude no escribió "TAREA N LISTA", la tarea no terminó y no pasás a la siguiente.
• Dos agentes listos para usar — carga-gastos y revisor-de-gastos, en la carpeta agents/.
• El código de la hoja — Apps Script con una puerta protegida por token y la pestaña Resumen con tres bloques: selector, mini tabla y gráfico.
• Tres capturas de referencia de cómo tienen que verse los gráficos.
• Un CSV de ejemplo inventado — 398 movimientos ficticios con el formato de la exportación de Monzo, para probar todo sin usar tus datos.
• Una tabla para decidir qué automatizar después, con cinco preguntas de sí o no.

Cómo funciona

1. Tarea 1: Claude crea el primer agente y la estructura de carpetas.
2. Tarea 2: desde tu Chrome, Claude crea la puerta a tu hoja con Apps Script. El permiso de Google lo aprobás vos.
3. Tarea 3: carga tu CSV y verifica que la hoja coincida con el archivo al centavo. Cargar dos veces el mismo archivo no duplica nada.
4. Tarea 4: arma el Resumen con tres gráficos y selectores que actualizan tabla y gráfico.
5. Tarea 5: el segundo agente revisa los números y pule la hoja. Si cambiás un monto a mano, tiene que dar NO PASA y decirte cuál.
6. Tarea 6: una matriz para decidir qué conviene automatizar después.

Antes de usarlo con tus datos reales

Tu CSV tiene movimientos reales. Limpialo antes de cargarlo: el agente manda el archivo entero a tu hoja y no puede anonimizar nombres ni cuentas. Nada de esto se conecta a tu banco: trabaja con el CSV que vos descargás. Si querés probar primero, en datos/ viene Gastos-ejemplo.csv, inventado de punta a punta. Cuando pases a tus datos, sacalo de esa carpeta para que no se mezclen en la hoja.

La puerta es una dirección pública que protege solo un token. El token vive en .env.local y en las propiedades del script, nunca dentro del código. Cuando termines de usar el sistema, archivá la implementación.

Para usar los agentes de la carpeta agents

Claude Code busca los agentes de un proyecto en .claude/agents/, una carpeta oculta. Para que se vean en el ZIP vienen en agents/: copiá esos dos archivos a .claude/agents/ dentro de tu carpeta de trabajo y ya los podés invocar. El README del ZIP lo explica paso a paso.

Recursos relacionados

• Video de este sistema, paso a paso