BLOG

Lanzar un SaaS en directorios con Claude Code, paso a paso

Una ejecución de lanzamiento en directorios con Claude Code: el prompt de inicio exacto, onboarding, Chrome, salida real y los 11 estados del tracker.

Por Publicado Actualizado 14 min de lectura

Esta es una ejecución completa de LaunchRepo con Claude Code, en el orden en que ocurre: el prompt que pegas, las preguntas que hace el agente, la conexión con el navegador, la ejecución planificada y cada estado que puede registrar el tracker. Sigue la versión 1.9.0 del toolkit, del 29 de septiembre de 2026, y la salida de terminal que aparece más abajo procede de una ejecución real de los propios scripts del toolkit el 30 de septiembre de 2026. Si antes quieres saber si LaunchRepo encaja con Claude Code, la página de Claude Code lo responde en una sola pantalla. La guía de la ejecución de lanzamiento describe la misma ejecución para cualquier agente.

La versión corta: Claude Code hace el trabajo repetitivo de leer playbooks, rellenar formularios y escribir el tracker. Tú aportas cuatro cosas que solo puede aportar una persona: los datos de tu producto, un Chrome con la sesión iniciada, tu aprobación de los textos, y los CAPTCHA y avisos de verificación en dos pasos que las plataformas reservan para humanos. Cada ficha sigue siendo decisión del directorio, y las revisiones gratuitas suelen tardar semanas, así que el objetivo de una ejecución es un conjunto de envíos honestos y confirmados, no páginas instantáneas.

La ejecución de un vistazo

Paso Qué hace Claude Code Qué haces tú Prueba de que funcionó
1. Prompt de inicio Crea el espacio de trabajo privado y arranca el panel Pegas un prompt Se abre un enlace 127.0.0.1
2. Onboarding Te entrevista y rellena product.json y copy.md Respondes, corriges, apruebas Un briefing que firmarías
3. Chrome Configura Chrome DevTools MCP y hace una prueba visible Activas la depuración remota y apruebas el aviso de Chrome Ves cómo se mueve la pestaña
4. Permisos Registra el alcance una vez por producto Decides sobre badges, cuentas y correo authorizations.json
5. La ejecución Planifica 10 envíos, una plataforma cada vez Resuelves los relevos cuando te lo pide Recuento confirmado en el panel
6. Tracker Registra cada resultado con evidencia Confirmas las fichas públicas Un estado por plataforma
7. Reanudar Guarda el progreso y las próximas fechas Nada, hasta la siguiente sesión El siguiente agente continúa

Paso 0: qué necesitas

  • El repositorio. Tras la compra recibes una invitación a un repositorio privado de GitHub. Clónalo y abre la carpeta en Claude Code.
  • Git y Python 3.10 o superior en Windows, macOS o Linux. El tracker, el panel y los scripts auxiliares solo usan la biblioteca estándar de Python, así que no hay nada que instalar. En Windows usas py -3 donde la documentación dice python3.
  • Chrome, una versión LTS actual de Node.js y npm para la conexión con el navegador. El toolkit se conecta mediante Chrome DevTools MCP, y su modo --autoConnect necesita Chrome 144 o superior.
  • Los datos de tu producto: nombre, URL, público, funciones reales, el precio tal como es hoy, fase de lanzamiento, capturas auténticas y un logo.

El repositorio recomienda usar Claude Code como CLI en un terminal y no la app de escritorio. Ese es el flujo documentado, y el prompt de inicio te lo recuerda una vez.

Paso 1: el prompt de inicio

Pega el prompt de START.md exactamente como está escrito:

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone. Read AGENTS.md, then follow “Start the dashboard for the owner”. Create my private workspace if I do not have one yet, start the dashboard, and give me the link. Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of asking again unless their scope is missing or conflicting. Actually test my visible existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the OS fallback if needed. Use one platform/browser worker by default. Build the normal run only from suitable free-ready routes, keep research separate, and preserve any draft that needs one exact human CAPTCHA/2FA action. Never claim browser control bypasses or reduces those challenges.

El prompt se queda en inglés; Claude Code te responde en tu idioma en cuanto ha leído las instrucciones. Crea un espacio de trabajo privado junto a la copia del repositorio, de modo que tus productos y credenciales nunca vivan en el repositorio de entrega. Después arranca el panel local y responde con un enlace 127.0.0.1. Todo lo que sigue puede hacerse en esa pestaña o en el chat, porque los formularios del panel escriben los mismos archivos que lee el agente.

¿Prefieres echar un vistazo antes de decidirte? python3 scripts/dashboard.py --demo sirve un espacio de trabajo desechable con un producto ficticio.

Paso 2: la entrevista de onboarding

ONBOARDING.md tiene siete fases, y el agente las dirige de una en una. Lee los archivos existentes antes de preguntar nada, así que una segunda sesión nunca repite la primera.

Dónde estamos. El agente pregunta el nombre y la URL de tu primer producto y la carpeta con su código o sus notas, e inspecciona esas fuentes antes de hacer más preguntas. También determina tu sistema operativo y qué herramientas de navegador puede invocar de verdad. Las instrucciones son tajantes: un terminal por sí solo no es control del navegador, y el agente no debe afirmar que tiene herramientas que la sesión no tiene.

Un hogar privado. Claude Code te ayuda a crear tu propio remoto privado para el espacio de trabajo y explica que cualquier dato de acceso guardado allí lo puede leer cualquiera con acceso a ese repositorio, incluido su historial. Tú eliges: credenciales en el espacio de trabajo, referencias a un gestor de secretos o nada. También pregunta una vez si los problemas pueden comunicarse a los mantenedores de LaunchRepo como issues de GitHub, sin secretos ni direcciones de correo. Sin respuesta, la respuesta es no.

El producto. Un script crea la carpeta del producto; después el agente rellena el archivo de contexto del producto product.json con tus respuestas y ejecuta el taller de textos, que produce copy.md con variantes para distintos límites de campo. Lo desconocido se queda vacío. Las funciones planeadas nunca se convierten en disponibles.

Esta fase también fija tu fecha mínima de lanzamiento. Muchos directorios gratuitos ponen los envíos en cola de revisión durante semanas, así que el agente pregunta si hay una fecha antes de la cual no debe publicarse nada, y a partir de ahí el tracker rechaza cualquier registro scheduled anterior a ella.

Identidad. identity.json guarda el nombre público, el correo de inicio de sesión y los datos de organización que permites. Antes de que nada de eso llegue a una ficha, el agente ejecuta el briefing de representación: tres frases breves de ejemplo sobre ti, mostradas literalmente para que las corrijas.

Paso 3: conectar Chrome y tu buzón

Este es el paso que hace funcionar todo lo demás. El agente necesita un navegador que puedas ver y supervisar, y BROWSER-SETUP.md admite exactamente un transporte: Chrome DevTools MCP sobre la depuración remota de Chrome. La guía para conectar Chrome recorre las dos rutas.

Ruta A: tu Chrome de siempre. Comprueba chrome://version (144 o superior), abre chrome://inspect/#remote-debugging en el Chrome que quieres que use el agente y activa allí la depuración remota. Después registra el servidor en Claude Code con claude mcp add; la guía de clientes de Chrome DevTools MCP tiene la línea exacta, y el repositorio le añade --autoConnect. La propia documentación de MCP de Claude Code explica los ámbitos si quieres el servidor solo para este proyecto.

Ruta B: un perfil dedicado. Si falta el control de depuración remota o la conexión automática falla, Chrome arranca con su propio directorio de perfil dentro del espacio de trabajo y un puerto local de depuración, y la configuración usa --browserUrl en su lugar. Inicias sesión una vez en esa ventana. El puerto nunca sale de localhost y las cookies nunca se copian.

Luego viene la prueba visible. Abres una pestaña en blanco en el perfil previsto, el agente la lleva a https://example.com/ y lee el título “Example Domain”, y tú confirmas que se movió esa misma pestaña. Eso demuestra el control de esa única pestaña mediante el Chrome DevTools Protocol, nada más; un proceso MCP en marcha o una pantalla de OAuth completada no son prueba. En macOS, una conexión así normalmente no necesita permisos de Accesibilidad, Automatización ni Grabación de pantalla. Tras tu primer inicio de sesión real, el agente revisa el menú de cuenta para comprobar la identidad correcta y confirma el acceso al buzón, porque los correos de verificación completan la mayoría de los registros. Reenviar los códigos a mano es un recurso admitido que el tracker registra como relevo humano.

Chrome puede volver a mostrar su aviso de conexión tras reconectar. Es un control de seguridad, y el agente tiene instrucciones de no prometer nunca que desaparecerá ni saltarse los CAPTCHA.

Paso 4: permisos, una vez por producto

Antes de enviar nada, el agente lee WEBSITE-AND-EMAIL.md y hace un puñado de preguntas que no volverá a hacer: dónde vive el código de tu web, cómo se despliega, qué rama es producción y si puede añadir a tu pie de página los badges de directorio obligatorios, hacer commit y volver a desplegar. También pregunta si están permitidos los registros gratuitos, los envíos finales gratuitos y las acciones correspondientes con correos de verificación. Las respuestas, la fecha y el alcance exacto van a authorizations.json. El gasto se queda en cero y se rechaza todo upsell de pago.

Decir que no a los badges está bien: solo descarta los directorios que exigen uno. Cada producto tiene su propia autorización, así que un sí para un producto nunca se traslada al siguiente.

Paso 5: planificar la ejecución y mirar el contador

Ahora doctor.py separa la configuración que falta de los permisos que rechazaste, y el agente abre el planificador de la ejecución. Los valores por defecto son deliberados: 10 envíos nuevos, un worker de navegador, 150 minutos activos en total y 15 por plataforma. En la cola solo entran rutas listas y gratuitas: actuales, con evidencia, que funcionan y son gratuitas sin condiciones. Las rutas con condiciones se muestran aparte con sus requisitos previos. Si hay menos rutas adecuadas listas que tu objetivo, el agente te ofrece la ejecución más pequeña y veraz. Donde Claude Code admite /goal, se ofrece el objetivo generado para usarlo ahí; si no, el mismo texto funciona como prompt normal.

Así se ve la ejecución en el terminal. El 30 de septiembre de 2026 creamos un espacio de trabajo nuevo y un producto vacío con los scripts del toolkit y ejecutamos los comandos documentados. Las líneas de abajo están copiadas de esa ejecución, recortadas a los campos relevantes:

$ python3 scripts/run.py --project projects/my-product start --target 10 --total-minutes 150 --platform-minutes 15
  "target": 10,
  "parallel": 1,
  "remaining": 10,
$ python3 scripts/run.py --project projects/my-product claim pitchwall --worker worker-1 --window window-1
$ python3 scripts/record.py --project projects/my-product pitchwall live --worker worker-1 --note 'Thank-you page shown' --next-action 'Open the public listing'
Tracker rejected input: Public states require a reviewed URL and --confirmed-public
$ python3 scripts/record.py --project projects/my-product pitchwall submitted_pending_review --worker worker-1 --note 'Dashboard confirms Under Review' --next-action 'Recheck after the stated review window'
Recorded pitchwall: submitted_pending_review
$ python3 scripts/run.py --project projects/my-product status
  "completed_count": 1,
  "remaining": 9,

Hay dos cosas que merece la pena ver. El tracker se negó a llamar live a una página de agradecimiento: los estados públicos necesitan una URL revisada y tu confirmación explícita. Y el registro honesto, un envío en revisión, movió el contador de 10 pendientes a 9. Los acuses de recibo cuentan para el objetivo; no tienes que esperar semanas a la publicación para saber que tu ejecución avanzó.

Cuenta con relevos por el camino. Cuando aparece un CAPTCHA, un aviso de verificación en dos pasos o un estado de cuenta poco claro, el agente mantiene el borrador abierto, registra prepared_needs_human con exactamente una acción para ti, y el panel lo muestra bajo «te necesita». Lo resuelves en la misma ventana y la ejecución continúa.

Paso 6: qué significan los estados del tracker

Cada resultado pasa por record.py a submissions.json, y el panel muestra los mismos once estados. Cada uno exige una observación mínima, así que un resultado no puede inflarse. Solo cuatro de ellos mueven el contador de la ejecución:

Estado Observación mínima Cuenta para el objetivo de la ejecución
draft Trabajo preparado, envío final no confirmado No
prepared_needs_human Un bloqueo concreto que solo tú puedes resolver No
submitted_pending_review La plataforma confirmó la recepción; moderación pendiente Sí
queued La plataforma confirmó una posición en la cola Sí
scheduled Una fecha confirmada igual o posterior a tu fecha mínima de lanzamiento Sí
live URL pública revisada más tu confirmación Sí
already_listed Una ficha pública existente, con la misma prueba que live No
blocked Elegibilidad, límite de la cuenta o un dato que falta No
deferred_paid La única ruta utilizable cuesta dinero; no se compró nada No
not_a_fit El público o los criterios de la ficha no encajan No
unavailable La ruta no se puede usar ahora mismo No

Cada plataforma cuenta una vez por ejecución, por mucho que cambie su estado después. La entrada sobre el estado de la ficha explica el vocabulario, y la guía de seguimiento de envíos cubre casos límite como una casilla de socios que promete un segundo sitio.

Paso 7: dejar un espacio de trabajo reanudable

Al final de una sesión, el agente marca en el onboarding solo las comprobaciones que observó de verdad, escribe la evidencia no sensible y los pasos abiertos en SESSION.md, apunta las próximas fechas en FOLLOW-UP.md y ejecuta una comprobación de privacidad de git antes de subir a tu remoto privado. La siguiente sesión, tuya o de otro agente, lee primero el tracker: relevos, lanzamientos programados que toca verificar y después revisiones pendientes cuya ventana ya pasó. Vuelve a comprobar los registros existentes en lugar de enviar dos veces.

Esa es la verdadera recompensa. Tu segundo producto reutiliza la configuración del navegador, la identidad, el patrón de permisos y los 299 playbooks activos de la instantánea del catálogo del 24 de septiembre de 2026; solo product.json y los textos son nuevos.

Por dónde seguir

Cómo funciona muestra los pasos con el vídeo del fundador. En el catálogo de directorios puedes leer algunas guías prácticas públicas antes de decidir, y el changelog recoge cada versión del toolkit. ¿Quieres que Claude Code también escriba textos de marketing? Compara las skills de Claude Code para marketing. Los demás agentes están en las páginas de agentes. El repositorio en sí se compra una sola vez en la página de precios.

Preguntas frecuentes

¿Puede Claude Code enviar mi SaaS a directorios por su cuenta?

En gran parte, sí. Con el repositorio, un Chrome conectado y tus permisos, Claude Code lee cada playbook, rellena el formulario y registra el resultado. Tú apruebas los textos, confirmas las fichas públicas y resuelves los CAPTCHA o los avisos de verificación en dos pasos cuando la ejecución se detiene para ti.

¿Necesito la CLI de Claude Code o sirve la app de escritorio?

El repositorio recomienda la CLI en un terminal para obtener los mejores resultados, y el prompt de inicio lo dice. La app de escritorio no está bloqueada: si te quedas en ella, el agente continúa el trabajo autorizado y el progreso guardado se mantiene intacto.

¿Cuánto tarda la primera ejecución?

El planificador presupuesta 150 minutos activos para 10 plataformas, 15 por plataforma. Son límites de coordinación que pausan la ejecución al alcanzarse, no una promesa de velocidad, y el tiempo que dedicas a los relevos depende de las plataformas.

¿Qué pasa cuando un directorio muestra un CAPTCHA?

El agente se detiene ante el desafío, mantiene el borrador abierto y registra prepared_needs_human con una acción exacta para ti. Lo resuelves en la misma ventana y la ejecución continúa desde ahí.

¿Funciona esta misma guía con Codex o Cursor?

Sí. Los archivos, el tracker y la configuración del navegador son los mismos para cualquier agente que pueda leer el repositorio y usar Chrome DevTools MCP. Las páginas de agentes recogen lo que cambia con cada herramienta.

Fuentes: START.md, ONBOARDING.md, BROWSER-SETUP.md, WEBSITE-AND-EMAIL.md, RUNBOOK.md y CHANGELOG.md del toolkit de LaunchRepo (versión 1.9.0, 29 de septiembre de 2026); el prompt de inicio, citado literalmente; una ejecución de run.py y record.py el 30 de septiembre de 2026; la referencia de configuración de Chrome DevTools MCP (Chrome 144 o superior para --autoConnect), consultada el 30 de septiembre de 2026. No se dan cifras de tiempo ni de resultados entre clientes, porque no se midió ninguna.

  • claude-code
  • walkthrough
  • tracker
  • agents

Dale a tu agente la lista completa

LaunchRepo es el repositorio que ejecuta tu agente de programación con IA: 299 playbooks de directorios, una plantilla de producto y un tracker. Pagas una vez al precio actual de 119,00 € y lo usas con cada producto que construyas.

Ver precio