🤖 Claude Code: seu copiloto
O Claude Code é a peça central — o assistente que clona, instala, configura e roda a Fábrica a partir de instruções em português. Você não digita comandos crípticos: você descreve o objetivo e revisa o resultado.
// o pedido que dispara o setup inteiro
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.
✓ O que VOCÊ faz
- ✓Descreve o que quer, em linguagem natural
- ✓Cola as chaves quando ele pedir
- ✓Confere o resultado e pede ajustes
✗ O que o CLAUDE CODE faz
- →Roda git clone e python setup.py
- →Cria o .env e instala dependências
- →Sobe a webapp e resolve os erros
faz o trabalho braçal
sem comando críptico
descreve + revisa
pedir bem
🔑 Conta + chave Perplexity
A Perplexity é a fase de pesquisa: é ela que busca os fatos atuais da empresa na internet. A chave é gratuita e leva uns 2 minutos. É o que mantém os entregáveis atualizados — não inventados.
Criar conta
Acesse perplexity.ai e crie uma conta gratuita.
Gerar a chave
Vá em Settings → API e clique em "Generate API Key". A chave começa com pplx-.
Guardar para o .env
Copie e guarde num lugar seguro. Quando o Claude Code montar o .env, você cola ela ali.
// .env — primeira linha
PERPLEXITY_API_KEY=pplx-xxxxxxxxxxxxxxxxxxxx
💡 Por que pesquisa ao vivo importa
Rodando em 2026, a Perplexity busca dados de 2026. Se uma ferramenta foi substituída ou um modelo melhor surgiu, as recomendações refletem isso. É o que separa um diagnóstico vivo de um relatório genérico que envelhece em semanas.
~2 minutos
formato da chave
busca, não chuta
nunca commitar
✨ Conta + chave Gemini
O Gemini 2.5 Flash é a fase de síntese: é o motor de escrita que gera os 15 documentos. Foi escolhido por ser barato e com contexto gigante — é o que viabiliza um pacote inteiro por menos de US$1. A chave também é gratuita.
Abrir o AI Studio
Acesse aistudio.google.com/apikey e entre com sua conta Google.
Criar a chave
Clique em "Create API Key". A chave começa com AIzaSy.
Completar o .env
Guarde a chave. Ela é a segunda linha do .env, ao lado da Perplexity.
// .env — completo
PERPLEXITY_API_KEY=pplx-xxxxxxxxxxxxxxxxxxxx GEMINI_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxx
✓ Por que Gemini 2.5 Flash
- ✓Custo de entrada baixíssimo (US$0,075/1M tokens)
- ✓Contexto gigante — cabe muita pesquisa de uma vez
- ✓Rápido o bastante para 15 documentos seguidos
✗ Cuidados com a chave
- ✗Nunca colar a chave direto no código
- ✗Nunca commitar o .env no Git
- ✗Sem espaços extras nem aspas em volta da chave
motor de escrita
pacote < US$1
gigante
formato da chave
📥 Clonar e rodar o repo
Com as chaves em mãos, é hora de baixar a Fábrica e subi-la. Você pode pedir tudo ao Claude Code — mas vale conhecer os comandos por baixo, para saber o que está acontecendo. Ao fim, a interface abre em localhost:8888.
Clonar o repositório
Baixa o projeto ai-strategy-factory para a sua máquina.
Rodar o setup
O setup.py cria o ambiente, instala dependências e prepara o .env. Funciona em Windows, macOS e Linux.
Subir a webapp
A interface abre sozinha no navegador em localhost:8888. Digite o nome de uma empresa e clique em iniciar.
// o que o Claude Code roda por você
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
💡 Se a porta estiver ocupada
A webapp acha uma porta livre automaticamente. Se quiser fixar outra, peça ao Claude Code ou rode python -m strategy_factory.webapp --port 9000. No macOS a porta 5000 é da AirPlay — por isso o padrão é 8888.
baixa o projeto
prepara tudo
localhost:8888
Win/Mac/Linux
📣 Build in public
Construir em público é a mentalidade que transforma o seu setup em autoridade. A ideia é simples: mostrar o processo, inclusive os erros. Quem construiu esta Fábrica enfrentou limites de contexto, erros de API e até um nome de modelo errado na documentação — e mostrou tudo.
✓ O que compartilhar
- ✓O processo real, passo a passo
- ✓Os erros e como você os resolveu
- ✓O primeiro pacote que a Fábrica gerou
✗ A armadilha a evitar
- ✗Mostrar só o resultado polido
- ✗Esconder os tropeços (eles geram conexão)
- ✗Esperar estar "perfeito" para postar
🔧 Os tropeços reais da construção
Foram várias sessões de Claude Code. O que deu errado pelo caminho — e virou conteúdo:
- •Limites de contexto (estourou duas vezes)
- •Erros de API e nome de modelo errado na doc da Perplexity
- •Problema no chunking do Gemini em um arquivo
mostra a bagunça
prova de trabalho
erro aproxima
vêm da jornada
🧮 Gestão de custo
Custo baixo é o que mantém a margem alta. A Fábrica tem dois modos de pesquisa, e você escolhe em tempo real conforme o orçamento. A diferença é grande: quick custa ~US$0,05; deep custa ~US$0,50.
⚡ Modo quick
~9 queries no modelo sonar. Avaliação rápida em 2-3 minutos, ~US$0,05. É o modo da sua Missão de hoje.
🔬 Modo deep
~18 queries com sonar-pro. Investigação completa em 5-10 minutos, ~US$0,50. Use quando o cliente é grande.
💡 Divida pedidos grandes
Documentação é barata em tokens — mesmo num plano básico dá para fazer muito se você dividir os pedidos. Comece sempre no quick: ele entrega um pacote completo por centavos, e você só sobe para o deep quando o caso justificar.
~US$0,05
~US$0,50
custo < valor
pedidos menores
✅ Resumo do módulo
🎯 Missão 1.3 — Rode o primeiro pacote
Com tudo configurado, peça ao Claude Code para rodar a Fábrica em modo quick para 1 empresa que você conhece — e abra os arquivos gerados:
- Garanta as duas chaves no .env e a webapp no ar.
- Rode uma análise quick para a empresa escolhida.
- Abra a pasta output/{empresa}/ e folheie os 19 arquivos.
Sucesso: o pacote gerou e você abriu pelo menos o roadmap, o deck e o SOW. O que você ganhou: sua Fábrica funcionando e o primeiro entregável real — a prova viva de que a máquina entrega.
Próximo:
Trilha 2 — Síntese de Conhecimento (os frameworks que valem ouro e a base de cheat sheets que faz o output parecer elite)