Power BI end-to-end con IA: cómo instalar Claude Code + pbi-cli en Windows (guía a prueba de bobos)

Imagina esto. Abres Power BI Desktop, cargas tu .pbix vacío con la conexión a tu data y le escribes a una IA, en español plano:

«Crea un star schema con la tabla Ventas y Calendario, marca la fecha, arma 12 medidas DAX típicas de cierre mensual, documenta todo y exporta el modelo a TMDL.»

Y la IA lo hace. Trabajando contra tu instancia local de Power BI Desktop, leyendo tu modelo real, validando sintaxis DAX, generando el diccionario de datos. No es ChatGPT pegando código que después tienes que probar a mano. Es la IA tocando el modelo directamente y devolviéndote todo listo.

Eso es lo que hace Claude Code + pbi-cli trabajando juntos. Y una vez que entras a este flujo, ya no vuelves al click-to-create.

Pero antes de llegar ahí, hay que instalar bien el stack: Node.js, Claude Code, Python, pipx y pbi-cli. Y ahí es donde 9 de cada 10 personas que conozco se traban — peleas con permisos, rutas con espacios, el clásico «python no se reconoce», alias de Microsoft Store que secuestran comandos, ECONNRESET cuando el antivirus bloquea npm…

Así que armé una guía de 20 páginas a prueba de bobos que cubre el camino completo, desde un Windows recién comprado hasta Claude Code conversando con tu Power BI Desktop. Sin saltos. Sin «se entiende, ¿no?». Una sola vez bien hecho, y nunca más vuelves a pelear con esto.

Qué vas a poder hacer cuando termines

Una vez instalado todo, le hablas a Claude en lenguaje natural y él elige solo qué hacer:

• «¿Cuáles son los 10 productos top por ingresos?» → ejecuta DAX y te devuelve el resultado.
• «Crea una medida Total Ventas que sume Importe de la tabla Ventas.» → escribe la medida, la valida y la guarda.
• «Saca un snapshot antes de que rompa algo.» → exporta TMDL en una transacción reversible.
• «Configura RLS para gerentes regionales.» → crea roles, filtros y perspectivas.
• «Documenta todo el modelo y dame un diccionario de datos.» → genera el inventario completo.
• «¿Por qué esta query está tan lenta?» → traza la ejecución, mide y te dice el bottleneck.
• «Muéstrame el M de la tabla Ventas.» → te abre las particiones y expresiones Power Query.

Y eso es solo el lado del modelo semántico. La misma filosofía aplica al reporte PBIR: agregar páginas, colocar visuales, atar datos, aplicar temas, configurar filtros TopN o de fecha relativa. La idea final es reporte completo end-to-end — modelo + medidas + páginas + visuales + filtros — orquestado desde el terminal con IA.

El stack, en una imagen mental

Windows
   │
   ├─ nvm-windows ──── Node.js 22 LTS ──── npm
   │                                        │
   │                                        └── Claude Code (CLI con IA)
   │                                                │
   │                                                ▼
   ├─ Python (Microsoft Store) ── pipx ── pbi-cli ──┘
   │                                        │
   │                                        ▼
   └── Power BI Desktop (.pbix abierto) ◄── 7 skills auto-registradas
                                            (DAX, Modeling, Deployment,
                                             Security, Docs, Partitions,
                                             Diagnostics)

Dos entornos limpios (Node por un lado, Python por el otro), y arriba de eso, Claude Code que descubre solo las skills que expone pbi-cli y las usa cuando vos le hablas.

Por qué NO te conviene instalar Node.js desde su web

Primer error que veo todo el tiempo.

Cuando descargas el .msi de la página oficial, Node queda fijado a una sola versión y los paquetes globales (npm install -g) caen en carpetas protegidas de Windows. Resultado: errores de permisos al instalar Claude Code y dolor crónico cada vez que una herramienta nueva exija otra versión.

La guía te lleva por el camino profesional: nvm-windows primero (vía winget), después Node 22 LTS, después Claude Code globalmente. En ese orden, todo encaja.

pbi-cli: el corazón open-source de este flujo

Para que no quede como caja negra: pbi-cli es un proyecto open-source de MinaSaad1. Está escrito en Python y se conecta directamente a tu instancia de Power BI Desktop usando interop .NET TOM. No hay servidor intermedio, no hay nube, no necesita Premium ni licencia paga. Es tu Power BI local con tu modelo real.

Lo más elegante del proyecto: cuando ejecutas pbi connect dentro de la carpeta de un .pbix abierto, la herramienta hace dos cosas en un solo comando:

1. Detecta automáticamente la instancia de Analysis Services que Power BI Desktop levanta en un puerto local.
2. Instala las 7 skills en tu Claude Code para que las descubra al arrancar.

Cero clonar repos. Cero copiar archivos. Cero editar settings.json a mano. Por eso este combo se siente diferente a otras integraciones de IA con Power BI.

👉 Repo oficial: github.com/MinaSaad1/pbi-cli

Si te gusta lo que ves, dale una ⭐ — proyectos open-source en este nicho se sostienen con visibilidad.

Las 7 skills que vas a tener disponibles

Una vez ejecutado pbi connect, Claude descubre estas skills automáticamente y elige la correcta según lo que le pidas:

No tienes que memorizar comandos. Le hablas a Claude en español y él elige.

Qué cubre la guía, parte por parte

El recorrido tiene 7 partes etiquetadas A → G:

• Parte A — Limpieza previa. Solo si tenías Node anterior. Te dice exactamente qué carpetas borrar (C:\Program Files\nodejs, %APPDATA%\npm, %APPDATA%\npm-cache).
• Parte B — nvm-windows + Node 22 LTS. Instalación con winget, el detalle crítico del primer nvm use 22 como Administrador, y verificación con node -v / npm -v / nvm list.
• Parte C — Claude Code. npm install -g @anthropic-ai/claude-code, primer login en el navegador, y por qué claude doctor es tu mejor amigo cuando algo falla.
• Parte D — Python + pipx. Por qué Microsoft Store es el método recomendado (te ahorra el 95 % de dolores con el PATH), cómo apagar los alias de ejecución que secuestran el comando python, y qué hacer si tuviste que ir por python.org.
• Parte E — pbi-cli. Una sola línea: pipx install pbi-cli-tool. Después abrir Power BI Desktop con cualquier .pbix y ejecutar pbi connect — eso instala las 7 skills automáticamente.
• Parte F — Las 7 skills en acción. Tabla completa con ejemplos de prompts en lenguaje natural y el modo REPL (pbi repl) para probar comandos sin pasar por Claude.
• Parte G — Errores comunes. Los 11 problemas reales que la gente reporta más seguido, con síntoma exacto, causa y solución directa. Desde «Access Denied al crear el symlink» hasta «Funciona en CMD pero no en VS Code», pasando por el ECONNRESET típico cuando un antivirus corporativo bloquea npm.

Cierra con un cheat sheet de comandos de mantenimiento (nvm, pipx, claude doctor, pbi --help) que podés tener abierto en una pestaña mientras trabajas.

Por qué la hice «a prueba de bobos»

Porque cada vez que alguien me escribía pidiendo ayuda, era el mismo error que ya había resuelto veinte veces. Y porque cada uno de esos errores tiene causa concreta, identificable y reproducible. No es magia. Es saber:

• Que las rutas con espacios rompen nvm históricamente (si tu carpeta de usuario es C:\Users\Fernando Pullutasig, instala nvm en C:\nvm y Node en C:\nodejs).
• Que el primer nvm use necesita PowerShell como Administrador porque crea un enlace simbólico; después ya no.
• Que Set-ExecutionPolicy RemoteSigned -Scope CurrentUser se aplica una sola vez y te ahorra el error de «ejecución de scripts deshabilitada» dentro de VS Code o Cursor.
• Que si python te abre Microsoft Store, hay dos toggles muy específicos en Configuración → Aplicaciones → Alias de ejecución de aplicaciones que tienes que apagar.

Cosas chiquitas. Pero cuando no las sabés, te tiran abajo una tarde entera.

📥 Descarga la guía completa en PDF

Dejé el PDF de 20 páginas (con formato cuidado, capturas, callouts y la tabla de errores) en una carpeta pública de Google Drive:

👉 Descargar la Guía a prueba de bobos — Beat Data

Es gratuita. Compártela con ese colega que está empezando con Power BI + IA, súbela al Notion de tu equipo, imprímela si querés. Lo único que pido a cambio: si te ahorró horas, contámelo en redes — me ayuda a saber qué guías valen la pena hacer después.

Qué viene después

Una vez que tengas el entorno listo, en próximos posts voy a mostrar el flujo end-to-end de un reporte completo generado con IA:

• Cómo usar la skill Modeling para que Claude arme tu star schema desde cero.
• Cómo combinar DAX + Deployment para tener tu modelo en Git con TMDL y diff legible.
• Cómo enlazar pbi-cli con el flujo PBIR de visuales, páginas y filtros, para que el reporte completo (incluidos gráficos) salga del terminal.
• Cómo integrar todo esto con la metodología IBCS que enseño en mi curso de Udemy, para que los gráficos generados por IA ya nazcan comunicando bien.

Si quieres que te avise cuando salgan, sígueme en redes — links en el footer.

🚀 ¿Listo para dejar de clickear y empezar a automatizar Power BI con IA?

👉 Descarga la guía completa en PDF

20 páginas. Cero relleno. Probala y contame cómo te fue.

¿Te sirvió este artículo? Compártelo con ese analista que sigue instalando Node desde la web. Y si te quedaste atorado en algún paso, escríbeme un comentario en cualquiera de mis redes indicando exactamente en qué paso te quedaste y el error que ves — las preguntas más comunes terminan en un video tutorial.

Fernando Pullutasig Analista de datos · Creador de Beat Data fernandotestv2.local