lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

caso de uso intermedio claude-codegoogle-sheetspython

FP&A Agent: revisa fórmulas y escenarios en Google Sheets

Inspecciona tu modelo financiero, explica fórmulas y compara escenarios desde Claude Code. Revisa el plan de las modificaciones antes de escribir en la hoja.

✓ verificado el 27 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara el entorno

Comprueba que tienes Git, Python ≥3.11 con venv y pip, Node.js ≥18 y Claude Code instalado y autenticado. Los comandos de activación siguientes usan una shell de macOS o Linux.

git clone https://github.com/jeffgraySF/fpa-agent.git
cd fpa-agent
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Paso 2: configura Sheets

Sigue el apartado OAuth del README: habilita Sheets API, configura consentimiento y usuario de prueba y crea un cliente de escritorio. Guarda el JSON como credentials.json en la raíz de fpa-agent, sin versionarlo. La primera llamada abre el navegador para autorizar; el token queda en ~/.fpa-agent/token.json.

Paso 3: inicia Claude Code

claude

Dentro de Claude Code usa /connect https://docs.google.com/spreadsheets/d/YOUR_SHEET_ID, sustituyendo el ID por el de una copia de prueba. Ejecuta /inspect Monthly Summary con el nombre real de una pestaña, y /explain Monthly!B15 con una celda que contenga una fórmula conocida; contrasta la explicación con esa celda.

Comprobación

Comprueba que puedes explicar una fórmula y ejecutar un escenario sin alterar la hoja. Antes de probar /modify, revisa el plan y comprueba después las celdas afectadas.

Si algo falla

Si OAuth muestra acceso bloqueado, revisa el usuario de prueba y el cliente de escritorio. Si el resultado parece incompleto, compara /inspect con el escaneo completo /scan descrito en el README.

Consulta el README oficial para el procedimiento completo y los cambios de versión.

ver en .md ¿Prefieres el recurso entero?

Qué es

FP&A Agent es un conjunto de comandos de Claude Code y utilidades Python para trabajar con modelos financieros en Google Sheets. Está orientado a tareas de planificación de empresas SaaS en fase inicial.

Para qué te sirve

  • Cuando una fórmula encadena referencias y necesitas entender su cálculo.
  • Cuando quieres comparar una hipótesis financiera sin cambiar el modelo.
  • Cuando necesitas una instantánea de los resultados antes de modificar la hoja.

Cómo funciona

Los comandos consultan una capa de acceso a Sheets y herramientas de análisis. Separan inspección, auditoría, explicación, escenarios e instantáneas. El comando de modificación incorpora un plan con aprobación antes de ejecutar escrituras.

Antes de empezar

El README requiere Python 3.11 o posterior, Node.js 18 o posterior, acceso a Claude y un proyecto Google Cloud con Sheets API. Configura el consentimiento OAuth y tu usuario de prueba antes de conectar una hoja.

Límites y alternativas

GitHub clasifica su licencia como NOASSERTION: lee el texto de la licencia antes de reutilizar código. La auditoría no certifica un modelo financiero ni sustituye la revisión de sus supuestos. Empieza con una copia de la hoja y valida que las fórmulas y permisos corresponden al alcance esperado.

Recursos