Lança o teu SaaS em diretórios com o Claude Code

De que o Claude Code precisa

Uma sessão claude na pasta clonada

Arranca o claude dentro do repositório privado que clonaste depois da compra. O repositório traz um CLAUDE.md que importa o AGENTS.md, por isso o Claude Code carrega o runbook como instruções do projeto sem nenhum passo extra.

Python 3.10+ e Node.js LTS

O Python corre o script do workspace, o record.py e o dashboard local, só com a biblioteca padrão. O Node.js fornece o npx, que o Claude Code usa para arrancar o Chrome DevTools MCP como servidor stdio local.

Uma entrada MCP, só para ti

O claude mcp add escreve por defeito no âmbito local: só tu, só este projeto. O âmbito de utilizador tornaria o servidor de browser disponível em todos os projetos, o que é mais alcance do que um lançamento precisa.

Permissões permanentes por produto

Os pedidos de permissão do próprio Claude Code decidem que ferramentas podem correr. O LaunchRepo acrescenta uma camada ao nível do produto no authorizations.json: registos gratuitos, submissões finais, ações de email e badges, cada um concedido uma vez. A despesa fica em zero.

Ligar o Claude Code ao teu Chrome

O Claude Code chega ao teu browser através do servidor Chrome DevTools MCP. A rota preferida do BROWSER-SETUP.md reutiliza o Chrome onde já trabalhas, com todas as sessões iniciadas: Chrome 144 ou mais recente, remote debugging ativado em chrome://inspect/#remote-debugging e a opção --autoConnect no servidor.

Se o auto-connect não estiver disponível na tua máquina, o mesmo guia descreve um perfil Chrome dedicado numa porta de debugging local. Nesse caso substituis --autoConnect por --browserUrl=http://127.0.0.1:9222. Usa um modo só, nunca os dois, e nunca exponhas a porta.

Do lado do Claude Code, a configuração é só isto. As duas opções depois de --autoConnect desligam as estatísticas de utilização e as consultas ao CrUX, tal como faz o guia de browser do repositório:

claude mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest --autoConnect --no-usage-statistics --no-performance-crux
claude mcp list

Formato conforme documentado por code.claude.com, verificado em 30 de setembro de 2026. ↗

O claude mcp list deve agora mostrar chrome-devtools como ✔ Connected. Pede ao Claude Code para abrir example.com num separador novo em branco, aprova o pedido de ligação do Chrome e confirma que é exatamente esse separador que se mexe. Só depois inicias sessão no primeiro diretório.

Liga o teu agente de código ao teu Chrome →

O prompt de arranque

Cola o prompt de arranque público do START.md na mesma sessão claude. Ele cria o teu workspace privado ao lado do checkout, para que os factos do produto e as credenciais nunca fiquem no repositório de entrega, arranca o dashboard e responde com um link 127.0.0.1.

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.

Os playbooks e as instruções são Markdown em inglês, o formato com que os agentes de programação lidam melhor. Os textos do teu produto podem estar em qualquer língua que um diretório aceite; o agente responde-te na tua língua.

A partir daí, é o dashboard que te dá o prompt seguinte — primeiro lote, retoma, revisão. O Claude Code volta a ler os ficheiros do workspace de cada vez, por isso fechar o terminal não faz perder nada.

Arrancar com o LaunchRepo em três passos →

Como é uma execução

Uma execução no Claude Code é algo que podes acompanhar: o terminal mostra que playbook está a ler e que ferramenta chama, o Chrome mostra o formulário que preenche. Abaixo está o pequeno lote de exemplo da página inicial; os teus estados reais vêm do submissions.json.

Quando a ligação do Claude Code falha

Os problemas mais comuns com o Claude Code e o Chrome DevTools MCP, cada um com a solução que a respetiva documentação indica. Nenhum deles mexe no LaunchRepo, e todos os resultados já registados ficam no tracker.

O claude mcp list mostra ✘ Failed to connect

Corre npx chrome-devtools-mcp@latest --help no mesmo terminal para ver se o servidor sequer arranca, e garante que o Claude Code usa esse mesmo Node.js e npm. Um primeiro download lento pode ultrapassar o tempo limite de arranque; inicia o Claude Code com um valor mais alto, por exemplo MCP_TIMEOUT=20000 claude.

“MCP server disconnected · open /mcp to reconnect”

Volta a ligar o servidor a partir de /mcp e repete o teste do separador em branco antes da submissão seguinte, porque uma nova ligação pode fazer reaparecer o pedido de aprovação do Chrome. O lote retoma a partir do tracker onde parou.

Mexe-se outra janela

Para antes de qualquer início de sessão. Com vários perfis do Chrome, o auto-connect liga-se ao perfil predefinido. Muda para o perfil pretendido ou usa a alternativa do perfil dedicado, e depois repete o teste visível.

Se as ferramentas de browser esgotarem o tempo com --autoConnect, verifica quatro coisas: o Chrome 144 ou mais recente já está aberto, o remote debugging está ativo em chrome://inspect/#remote-debugging, aceitaste o pedido de ligação do Chrome e nenhuma outra ferramenta está a usar o mesmo browser. O Chrome DevTools MCP carrega todos os separadores abertos, por isso fecha os de que não precisas.

O que continua a precisar de ti

O LaunchRepo não é, de propósito, um serviço em segundo plano. Estes momentos param a execução e são registados como passagens para humano; o agente nunca os contorna:

CAPTCHAs e verificações anti-bot

O Claude Code põe essa plataforma em pausa, regista prepared_needs_human e avisa no terminal; o dashboard lista-a em “precisa de ti”. Resolves o desafio no mesmo separador do Chrome e dizes ao Claude Code para continuar.

2FA e códigos de verificação

Os códigos chegam à caixa de correio com sessão iniciada no Chrome ligado, onde o Claude Code consegue abrir o link de confirmação. Se o teu correio estiver noutro sítio, passas tu o código e o tracker anota uma passagem para humano.

Upsells pagos

Uma rota só paga termina como deferred_paid com uma nota curta. O Claude Code nunca autoriza uma compra nem inicia um trial com cartão, mesmo quando um pedido de permissão deixaria passar o clique.

Confirmar “live”

O Claude Code consegue encontrar o URL público da listagem, mas uma plataforma só é marcada como live depois de a teres visto tu. Um ecrã de agradecimento continua a ser um ecrã de agradecimento.

Sem benchmark, sem ranking: afirmamos compatibilidade com Claude Code porque cumpre os dois requisitos acima, não porque o tenhamos medido face a outros agentes.

Perguntas