🤖 Claude Code: tu copiloto
Claude Code es la pieza central: el asistente que clona, instala, configura y ejecuta la Fábrica a partir de instrucciones en portugués. No escribes comandos crípticos: tú describe el objetivo y revisa el resultado.
// la solicitud que activa toda la configuración
Clone o repo https://github.com/inematds/ai-strategy-factory, me ajude a gerar e configurar as chaves de API no .env e suba a interface web.
✓ Lo que TÚ haces
- ✓Describe lo que quieres en lenguaje natural
- ✓Pega las claves cuando te las pida
- ✓Revisa el resultado y pide ajustes
✗ Lo que hace CLAUDE CODE
- →Ejecuta git clone e python setup.py
- →Crea el .env e instala dependencias
- →Inicia la webapp y resuelve los errores
hace el trabajo pesado
sin comandos crípticos
describe + revisa
pedir bien
🔑 Cuenta + clave de Perplexity
Perplexity es la fase de investigación: es quien busca en internet los datos actuales de la empresa. La clave es gratuita y te lleva unos 2 minutos. Es lo que mantiene actualizados los entregables actualizados — no inventados.
Crear una cuenta
Accede a perplexity.ai y crea una cuenta gratuita.
Generar la clave
Ve a Settings → API y haz clic en "Generate API Key". La clave comienza con pplx-.
Guardar para el .env
Copia y guarda en un lugar seguro. Cuando Claude Code arme el .env, la pegas ahí.
// .env — primera línea
PERPLEXITY_API_KEY=pplx-xxxxxxxxxxxxxxxxxxxx
💡 Por qué importa investigar en vivo
Al ejecutarse en 2026, Perplexity busca datos de 2026. Si una herramienta fue reemplazada o surgió un modelo mejor, las recomendaciones lo reflejan. Eso es lo que distingue un diagnóstico actualizado de un informe genérico que queda obsoleto en semanas.
~2 minutos
formato de la clave
busca, no adivines
nunca hagas commit
✨ Cuenta + clave de Gemini
Gemini 2.5 Flash es la fase de síntesis: el motor de escritura que genera los 15 documentos. Se eligió por ser barato y con contexto enorme — es lo que hace posible un paquete completo por menos de US$1. La clave también es gratuita.
Abrir AI Studio
Accede a aistudio.google.com/apikey e inicia sesión con tu cuenta de Google.
Crear la clave
Haz clic en "Create API Key". La clave comienza con AIzaSy.
Completar el .env
Guarda la clave. Es la segunda línea del .env, junto a Perplexity.
// .env — completo
PERPLEXITY_API_KEY=pplx-xxxxxxxxxxxxxxxxxxxx GEMINI_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxx
✓ Por qué Gemini 2.5 Flash
- ✓Costo de entrada bajísimo (US$0,075/1M tokens)
- ✓Contexto enorme: cabe mucha investigación de una sola vez
- ✓Lo bastante rápido para 15 documentos seguidos
✗ Cuidados con la clave
- ✗Nunca pegues la clave directamente en el código
- ✗Nunca hagas commit del .env en Git
- ✗Sin espacios extra ni comillas alrededor de la clave
motor de escritura
paquete < US$1
gigante
formato de la clave
📥 Clonar y ejecutar el repo
Con las claves listas, es hora de descargar la Fábrica y ponerla en marcha. Puedes pedirle todo a Claude Code, pero conviene conocer los comandos básicos para saber qué está pasando. Al final, la interfaz se abre en localhost:8888.
Clona el repositorio
Descarga el proyecto ai-strategy-factory para tu máquina.
Ejecutar la configuración
O setup.py crea el entorno, instala dependencias y prepara el .env. Funciona en Windows, macOS y Linux.
Iniciar la webapp
La interfaz se abre sola en el navegador en localhost:8888. Escribe el nombre de una empresa y haz clic en iniciar.
// lo que Claude Code ejecuta por ti
git clone https://github.com/inematds/ai-strategy-factory cd ai-strategy-factory python setup.py # cria venv, instala, prepara .env # (cole suas chaves no .env) python -m strategy_factory.webapp # → http://localhost:8888
💡 Si el puerto está ocupado
La webapp encuentra automáticamente un puerto disponible. Si quieres fijar otro, pídeselo a Claude Code o ejecuta python -m strategy_factory.webapp --port 9000. En macOS, el puerto 5000 lo usa AirPlay; por eso el valor predeterminado es 8888.
descarga el proyecto
prepara todo
localhost:8888
Win/Mac/Linux
📣 Build in public
Construir en público es la mentalidad que transforma tu setup en autoridad. La idea es simple: mostrar el proceso, incluidos los errores. Quien construyó esta Fábrica enfrentó límites de contexto, errores de API e incluso un nombre de modelo equivocado en la documentación, y lo mostró todo.
✓ Qué compartir
- ✓El proceso real, paso a paso
- ✓Los errores y cómo los resolviste
- ✓El primer paquete que generó la Fábrica
✗ La trampa que debes evitar
- ✗Mostrar solo el resultado pulido
- ✗Ocultar los tropiezos (generan conexión)
- ✗Esperar a que esté "perfecto" para publicar
🔧 Los tropiezos reales de la construcción
Fueron varias sesiones de Claude Code. Lo que salió mal en el camino — y se convirtió en contenido:
- •Límites de contexto (se excedió dos veces)
- •Errores de API y nombre de modelo incorrecto en la documentación de Perplexity
- •Problema con el chunking de Gemini en un archivo
muestra el desorden
prueba de trabajo
el error acerca
vienen del recorrido
🧮 Gestión de costos
El bajo costo es lo que mantiene alta la rentabilidad. La Fábrica tiene dos modos de investigación y tú eliges en tiempo real según el presupuesto. La diferencia es grande: quick cuesta ~US$0,05; deep cuesta ~US$0,50.
⚡ Modo quick
~9 queries en el modelo sonar. Evaluación rápida en 2-3 minutos, ~US$0,05. Es el modo de tu Misión de hoy.
🔬 Modo deep
~18 queries con sonar-pro. Investigación completa en 5-10 minutos, ~US$0,50. Úsalo cuando el cliente sea grande.
💡 Divide las solicitudes grandes
La documentación cuesta pocos tokens: incluso con un plan básico puedes hacer mucho si divides las solicitudes. Empieza siempre con quick: entrega un paquete completo por unos centavos, y solo pasa a deep cuando el caso lo justifique.
~US$0,05
~US$0,50
costo < valor
pedidos más pequeños
✅ Resumen del módulo
🎯 Misión 1.3 — Ejecuta el primer paquete
Con todo configurado, pídele a Claude Code que ejecute la Fábrica en modo quick para 1 empresa que conozcas — y abre los archivos generados:
- Asegúrate de tener las dos claves en .env y la webapp en línea.
- Ejecuta un análisis quick para la empresa elegida.
- Abre la carpeta output/{empresa}/ y hojea los 19 archivos.
Éxito: el paquete se generó y abriste al menos el roadmap, el deck y el SOW. Lo que obtuviste: tu Fábrica funcionando y el primer entregable real: la prueba viva de que la máquina entrega.
Siguiente:
Ruta 2 — Síntesis de Conocimiento (los frameworks que valen oro y la base de cheat sheets que hace que el resultado parezca de élite)