Auto-estudo · Claude Code, Codex e a sua Naia

IA no seu escritorio de arquitetura, montada por voce.

Este e um guia pra voce, Mauricio, aprender a fazer o que a gente faz sem comprar curso nenhum. A cada passo voce nao le teoria: voce abre o Claude e digita um comando, e a partir dali o proprio Claude te mostra o caminho. Do primeiro arquivo de contexto ate conversar com o seu modelo do Revit, passando por sites, conteudo, atendimento e contratos.

Voce quer fazer um site? Abra o Claude e diga: extrai esse site de referencia em markdown e clona ele pra mim. A partir dai o Claude te mostra como faz.

O metodo inteiro cabe nessa frase · perguntar, fazer, verificar, guardar

10 passos colapsaveis Comando inicial em cada passo Fontes oficiais com link Onde a IA alucina, esta avisado

O passo a passoDo primeiro comando a operacao autonoma01 · 10

Passo 01 · comece aqui

Claude Code, Codex e a sua Naia

O que e cada um, e como a sua Naia orquestra os dois. O primeiro comando cria o cerebro da operacao.

Comece por aqui. Voce vai trabalhar com tres coisas. O Claude Code e o Claude rodando no seu computador com poder de ler, escrever e rodar comandos: e o dev que executa. O Codex e o agente de codigo da OpenAI, uma segunda cabeca que voce pode chamar pra tarefas paralelas ou para dar uma segunda opiniao. E a sua Naia e a camada que orquestra: ela nao executa a tarefa sozinha, ela entende o que voce quer, quebra em partes e distribui pros executores (o Claude Code, o Codex, e os subagentes que voce definir). Voce fala com a Naia; ela comanda o resto.

Como isso vira real na sua maquina

A configuracao vive em arquivos de texto na raiz do seu projeto. O CLAUDE.md guarda as regras que o Claude Code segue. O AGENTS.md guarda as regras que o Codex segue. Os subagentes (o seu dev, o seu designer, o seu SDR) ficam em arquivos dentro de .claude/agents/, cada um com a sua funcao. E a memoria de longo prazo fica num banco vetorial, que a gente ve no Passo 2. Voce nao precisa escrever isso na mao: voce pede pro Claude criar.

O comando pra abrir o Claude e digitar

> Cria um CLAUDE.md com o contrato de verificacao e as tres fases de conversa,
e um AGENTS.md com as mesmas regras para o Codex. Define os subagentes que
executam por mim (um dev, um designer, um SDR) em .claude/agents/, cada um
com a sua funcao, e me explica como a Naia orquestra os dois.

A partir daqui o Claude te mostra o resto. Ele cria os arquivos, te explica cada um e ajusta com voce.

O contrato de verificacao (a regra que muda tudo)

Peca pro Claude gravar no CLAUDE.md uma regra: toda vez que ele disser que terminou algo, tem que provar. Rodou, abriu no navegador, conferiu o resultado de fora. Nada de dar por pronto so porque o codigo parece certo. Essa unica regra e o que separa um assistente que te faz perder tempo de um que voce pode confiar. A gente volta nela no Passo 10.

Passo 02 · o cerebro da operacao

Dar o contexto do seu escritorio

O Claude so e util quando conhece o seu negocio. Aqui voce ensina ele quem voce e, e ativa a memoria.

Uma IA generica responde generico. A sua Naia fica boa quando ela conhece o seu escritorio: que tipo de projeto voce faz (residencial, comercial, reforma, interiores), como voce fala com o cliente, qual o seu processo, quanto voce cobra, quais ferramentas voce usa. Tudo isso mora no CLAUDE.md e no AGENTS.md do seu escritorio. Quanto melhor o contexto, menos voce precisa repetir e mais certeiro fica o resultado.

O que colocar no cerebro

Quem voce e: nome do escritorio, tipo de projeto, cidade, publico.
Stack e servicos: quais programas voce usa (Revit, AutoCAD, SketchUp), onde ficam seus arquivos, quais contas e ferramentas.
Tom de voz: como voce se comunica, formal ou proximo, o que nunca dizer pro cliente.
Regras: o que a IA pode fazer sozinha e o que precisa te perguntar antes.

A memoria que aprende com o tempo

Alem do arquivo fixo, da pra dar a ela uma memoria de longo prazo: cada conversa importante e consolidada e guardada num banco vetorial (a tecnologia se chama pgvector, uma extensao do Postgres que guarda o significado do texto, nao so as palavras). Assim, quando voce perguntar algo semanas depois, ela busca por semelhanca de sentido e lembra do que ja foi combinado. Voce pede pro Claude montar isso; ele te guia na instalacao.

O comando pra abrir o Claude e digitar

> Vou te dar o contexto do meu escritorio de arquitetura e quero que voce
monte o CLAUDE.md e o AGENTS.md com stack, servicos, tom de voz e regras.
Depois, monta uma memoria de longo prazo com Postgres e pgvector, que
consolida nossas conversas e busca por semelhanca. Me guia na instalacao.

Responda as perguntas que ele fizer sobre o seu negocio. Quanto mais detalhe, melhor a Naia fica.

Direto e honesto

O banco vetorial e opcional pra comecar. No comeco, so o CLAUDE.md bem escrito ja resolve a maior parte. A memoria com Postgres e o passo pra quando voce quiser que a Naia lembre de tudo entre uma sessao e outra sem voce repetir. Comece simples e evolua.

Passo 03 · presenca

Sites de arquitetura

Clonar um site de referencia, montar uma landing premium do escritorio e publicar. Tudo por comando.

Site e a parte mais direta. A gente trabalha com tres receitas. Uma clona um site que voce admira: o Claude puxa a pagina em markdown (usando um leitor chamado Jina Reader, no endereco r.jina.ai) e reconstroi. Outra monta uma landing premium do zero sobre o seu escritorio, com React, Vite e animacoes suaves. A terceira e o metodo de criacao de landing pages, que padroniza tom e estrutura. Voce escolhe pela frase que digita.

As ferramentas que o Claude usa por baixo (MCPs)

MCP e o jeito de plugar ferramentas externas no Claude. Pra sites, valem quatro. O 21st-magic gera componentes de interface bonitos. O open-design ajuda a montar e iterar o layout. O playwright abre a pagina num navegador real e confere que ficou boa (isso e a verificacao de verdade, nao um chute). E o cloudflare publica o site no ar, num servico chamado Pages. Voce nao precisa decorar nada disso: pede o resultado e o Claude usa a ferramenta certa.

Os comandos pra abrir o Claude e digitar

> Extrai esse site de referencia em markdown e clona ele pra mim.

> Monta uma landing premium sobre o meu escritorio de arquitetura,
com portfolio, servicos e um formulario de contato.

> Valida a pagina no navegador de verdade e sobe no Cloudflare Pages.

O Claude clona, monta, abre no navegador pra conferir e publica. Voce ve o link no fim.

O padrao que evita cara de IA

Peca sempre pra partir de uma referencia real que voce gosta, nunca do nada. E fuja das fontes batidas e de gradiente gritante: o resultado bom vem de tipografia caprichada, cor sobria e um layout que respira. Se faltar uma foto de projeto, use um espaco reservado e troque depois pela foto real. Espaco reservado e melhor que uma imagem falsa gerada as pressas.

Passo 04 · autoridade

Conteudo de arquitetura

Carrossel de Instagram, analise do que viraliza e video em codigo. O escritorio vira referencia.

Conteudo constante e o que constroi autoridade. A gente tem o ciclo completo de carrossel de Instagram (do tema a arte publicavel), um metodo de analise do que viraliza (pra entender o que da certo no seu nicho antes de gastar tempo) e o Remotion, que faz video em codigo, com React, entao o mesmo template gera dezenas de videos sem editor. Pra imagem, a gente gera com gpt-image-2.

Como aplicar no seu nicho

A logica e sempre a mesma: primeiro voce pesquisa o que engaja em arquitetura e interiores, depois cria em cima disso. Um carrossel sobre "cinco erros de iluminacao em sala de estar", "quanto custa um projeto de reforma de verdade", "antes e depois de uma cozinha integrada". O Claude pesquisa a tendencia, escreve os textos, gera as artes e te entrega pronto pra postar.

O comando pra abrir o Claude e digitar

> Pesquisa a tendencia de conteudo sobre reforma de apartamento e cria
um carrossel de Instagram sobre um projeto de arquitetura, com os textos
e as artes prontos pra postar.

Ele pesquisa, planeja card a card, te mostra e so entao gera. Voce aprova antes de sair.

Direto e honesto

Imagem de IA ainda erra detalhe de arquitetura (perspectiva forcada, movel impossivel). Para foto real de projeto seu, use a foto real. A IA e otima pra ilustrar conceito, capa e fundo, nao pra fingir que um projeto existe. E render fotorrealista de projeto se faz por fora, com ferramentas dedicadas, que a gente ve no Passo 9.

Passo 05 · atendimento

O seu SDR de IA

Montar o clone que atende, qualifica e agenda. Do zero a primeira venda, com metodo de vendas.

Aqui voce monta o seu proprio SDR, o atendente que conversa com quem chega, entende o que a pessoa precisa e encaminha ou agenda. E o mesmo tipo de clone que a gente usa. O metodo cobre do zero ate a primeira venda: um backend em FastAPI, o cerebro com o Claude Agent SDK, integracao com o CRM pra registrar cada lead, o metodo de vendas SPIN (perguntar sobre Situacao, Problema, Implicacao e Necessidade, nessa ordem, em vez de empurrar) e o rastreio de conversao pra voce saber o que funciona.

Por que SPIN, e nao um robo que empurra

Um cliente de arquitetura decide devagar e por confianca. O SPIN faz o agente fazer as perguntas certas em vez de despejar preco na primeira mensagem: entende o momento da obra, a dor real, o que muda se resolver, e so entao conduz. Uma pergunta por vez, tom humano, sem parecer script. O clone que atende assim qualifica melhor e nao queima o lead.

O comando pra abrir o Claude e digitar

> Monta um SDR completo pro meu escritorio de arquitetura seguindo o metodo
SDR, com FastAPI, o Claude Agent SDK e qualificacao por SPIN. Ele atende,
entende a necessidade do cliente, registra o lead e me avisa quando esta
pronto pra eu assumir. Me guia passo a passo.

O clone ainda nao esta ligado no Instagram nem no WhatsApp. Isso e o Passo 6.

Comece pelo miolo, ligue os canais depois

Construa e teste o clone conversando com ele no terminal primeiro. So quando ele estiver atendendo bem, com o tom certo e qualificando direito, e que voce liga no Instagram e no WhatsApp. Ligar cedo demais e colocar no ar um atendente que ainda erra na frente do cliente.

Passo 06 · canais

Conectar o clone no Instagram e no WhatsApp

Do comentario no post ate o clone assumindo a conversa. E o WhatsApp por QR code ou pela via oficial.

Agora o clone do Passo 5 ganha canais. No Instagram, o fluxo e: alguem comenta uma palavra combinada no seu post, recebe uma mensagem no direct com um botao, clica, e o clone assume a conversa dali. Tem um painel pra montar isso no estilo do ManyChat, e voce conecta a sua conta clicando em "Conectar meu Instagram" (uma autorizacao oficial, o OAuth). No WhatsApp, sao dois caminhos: a Evolution API, que voce liga criando uma instancia e lendo um QR code (rapido de comecar), ou a via oficial do WhatsApp Business (mais burocratica, porem oficial).

Instagram, passo a passo

Conectar a conta: no painel, clicar em "Conectar meu Instagram" e autorizar. E a via oficial, nao um robo por fora.
Definir o gatilho: a palavra que, comentada num post, dispara a mensagem no direct.
Montar a DM com botao: a primeira mensagem que a pessoa recebe, com o botao que abre a conversa.
O clone assume: dali pra frente, quem responde e o seu SDR do Passo 5.

WhatsApp, os dois caminhos

A Evolution API conecta lendo um QR code, igual quando voce abre o WhatsApp Web: cria a instancia, escaneia com o celular e pronto, o clone recebe e responde. E o jeito mais rapido de testar. A via oficial (WhatsApp Business Platform) e mais formal e estavel pra volume, mas exige aprovacao. Para comecar e validar, a Evolution resolve; para escala e formalidade, a oficial.

O comando pra abrir o Claude e digitar

> Conecta o meu clone no Instagram com o fluxo de comentario que vira DM
com botao, e depois no WhatsApp pela Evolution API por QR code. Me guia
na conexao de cada canal, passo a passo.

Guarde as chaves e tokens dos canais num cofre de senhas, nunca soltos num arquivo. O Claude te mostra como.

Trava de conta

Nunca dispare mensagens em massa pela porta dos fundos: isso arrisca o bloqueio da sua conta do Instagram ou do WhatsApp. Use sempre a conexao oficial (o "Conectar meu Instagram") e respeite o ritmo. O objetivo e atender bem quem chega, nao inundar ninguem.

Passo 07 · o coracao do seu oficio

Projetos: o Claude conectado ao CAD e ao BIM

Da pra ligar o Claude no Revit, no AutoCAD e no Blender de verdade. Aqui estao os conectores reais.

Este e o passo mais forte pra voce. Ate agora foi marketing e atendimento, coisa que qualquer negocio faz. Aqui entra o seu oficio: da pra conectar o Claude ao seu software de projeto de verdade, via MCP, e conversar com o modelo. Sao tres conectores reais, cada um com uma funcao. Nao e promessa: sao projetos que existem, com endereco.

Os tres conectores reais

Revit MCP Server, oficial da Autodesk: lancado para o Revit 2027, e um conector suportado pela propria Autodesk que liga o Claude ao seu modelo BIM. Ele le elementos, parametros e geometria do modelo, entao voce pode perguntar sobre o projeto em linguagem natural. Documentacao oficial: autodesk.com, uso do Revit 2027 MCP Server.
AutoCAD MCP (projeto aberto): gera desenho por linguagem natural. O detalhe util: o motor (uma biblioteca chamada ezdxf) roda no Linux sem precisar do AutoCAD instalado e produz arquivos DXF. Repositorio: github.com/puran-water/autocad-mcp.
Blender MCP: gera asset 3D pelo Claude. E um dos conectores mais populares da categoria (mais de vinte mil estrelas no repositorio). Repositorio: github.com/ahujasid/blender-mcp.

Como instalar e usar

Um MCP se instala uma vez: voce registra o conector na configuracao do Claude e, a partir dai, ele aparece como uma ferramenta disponivel. Com o Revit MCP ligado, por exemplo, voce conversa com o modelo. Peca pro Claude fazer a instalacao com voce, ele conhece o formato.

O comando pra abrir o Claude e digitar

> Instala o Revit MCP Server da Autodesk na minha configuracao do Claude e
me guia. Depois: conversa com o meu modelo do Revit e lista os ambientes.

Ao configurar qualquer MCP, use um espaco reservado tipo <SEU_TOKEN> e guarde a chave real no cofre. Nunca deixe token no arquivo.

O que ainda se faz por fora (sem MCP)

Nem tudo entra pelo Claude. Algumas ferramentas de arquitetura voce usa direto, por fora: render por IA (o Veras, que roda dentro de varios CADs, transforma o modelo em imagem realista), planta generativa (Maket.ai e Snaptrude propoem plantas a partir de parametros) e staging de ambientes (InteriorAI e Remodel AI mobiliam e decoram um espaco vazio). Elas nao tem um conector publico pro Claude, entao entram no seu fluxo como aplicativos a parte. O Passo 9 detalha o panorama.

Fontes

Revit MCP (Autodesk):autodesk.com/support · Revit 2027 MCP Server
AutoCAD MCP:github.com/puran-water/autocad-mcp
Blender MCP:github.com/ahujasid/blender-mcp

Passo 08 · o lado juridico

Contratos de arquitetura

Aqui a gente nao tem receita pronta. Voce monta do zero com o Claude, ancorado nas fontes oficiais do CAU.

Honestidade primeiro: a gente nao tem uma receita pronta de contrato. Isso nao te deixa na mao, so muda o metodo. Aqui voce aprende a montar o contrato do zero com o Claude, mas com uma regra rigida: tudo ancorado nas fontes oficiais, nunca no que a IA acha. O Claude e otimo pra estruturar e redigir, e perigoso pra afirmar norma. Entao a estrutura vem dele; os numeros e a base legal vem do CAU.

As fontes oficiais que ancoram tudo

Base legal: a Lei 12.378/2010, que regulamenta o exercicio da arquitetura e urbanismo no Brasil.
Tabela de honorarios oficial: a do CAU/BR (Resolucao 64/2013), com a calculadora oficial em honorario.caubr.gov.br. E dali que sai o valor, sempre.
Modelos de contrato dos CAUs estaduais: o CAU/MT publica modelo em caumt.gov.br/modelo-de-contrato, e o CAU/PE em caupe.gov.br (varios CAUs estaduais, como o do Ceara, mantem modelos parecidos). Use como esqueleto.

O comando pra abrir o Claude e digitar

> Baixa a tabela de honorarios oficial do CAU e redige uma minuta de contrato
pra esse projeto, calculando o honorario pela tabela e usando como esqueleto
um modelo de contrato de um CAU estadual. Cita a fonte de cada valor e nao
inventa nenhuma norma. No fim, marca que a minuta precisa passar por advogado.

Peca sempre a fonte de cada numero. Se o Claude nao achar a fonte, ele nao deve afirmar o valor.

Trava de seguranca, obrigatoria

O Claude alucina norma e codigo de obra: ele inventa um artigo que soa certo mas nao existe. Por isso duas regras nunca se quebram aqui. Primeira: o valor do honorario sai sempre da tabela oficial do CAU, nunca do que a IA calcula de cabeca. Segunda: todo contrato passa por um advogado antes de ir pro cliente. A IA monta o rascunho e economiza horas; a responsabilidade juridica continua sendo de um profissional humano.

Fontes oficiais

Tabela de honorarios CAU/BR:honorario.caubr.gov.br
Modelo de contrato CAU/MT:caumt.gov.br/modelo-de-contrato
Modelos CAU/PE:caupe.gov.br · modelos de contrato e proposta

Passo 09 · o panorama

IA em arquitetura hoje

O mapa do que ja existe la fora, e a divisao clara: o que entra no Claude por MCP e o que se usa por fora.

Pra decidir bem, ajuda ver o campo inteiro. A IA em arquitetura, engenharia e construcao ja se organiza em quatro frentes, e a adocao nao e pequena: por volta de 38% dos escritorios do setor no Brasil ja usam alguma IA. O ponto util pra voce nao e a lista de nomes, e saber o que voce pluga no Claude e o que voce usa por fora.

As quatro frentes que ja existem

Planta generativa: Maket.ai, Snaptrude e TestFit propoem plantas e estudos de massa a partir de parametros e restricoes do terreno.
Render por IA: Veras e ArchiVinci transformam modelo ou croqui em imagem realista, rapido, para apresentar ao cliente.
Staging de ambientes: InteriorAI, Remodel AI e Spacely mobiliam e redecoram um espaco a partir de uma foto ou de um vazio.
BIM com IA nativa: o Autodesk Forma e o assistente dentro do proprio Revit trazem IA para dentro do fluxo BIM, sem sair da ferramenta.

Traz pro Claude, via MCP

Revit pelo MCP oficial da Autodesk (le o modelo BIM).
AutoCAD pelo MCP aberto (gera DXF, roda sem o AutoCAD).
Blender pelo MCP popular (gera 3D).

Usa por fora, sem MCP publico

Render: Veras, ArchiVinci.
Planta generativa: Maket.ai, Snaptrude, TestFit.
Staging: InteriorAI, Remodel AI, Spacely.

Direto e honesto

Nenhuma dessas ferramentas projeta por voce. Elas aceleram etapas (rascunhar planta, apresentar render, decorar um vazio) e ainda erram bastante, entao tudo passa pelo seu olho de arquiteto. O valor real e ganhar tempo nas partes mecanicas e usar esse tempo no projeto de verdade.

Passo 10 · o loop

Rotina de estudo: virar autonomo

O ciclo de aprender sozinho com o Claude. Cinco movimentos que, repetidos, te tornam independente.

Nenhum dos passos anteriores importa se voce depender de alguem pra cada mexida. A meta deste guia e voce virar autonomo. E autonomia nao e saber tudo: e ter um loop que voce repete. Cinco movimentos, sempre os mesmos, com o Claude do seu lado.

Os cinco movimentos

Estudar (perguntar): antes de fazer, pergunte. "Como funciona X? Quais as opcoes? Onde tem armadilha?" O Claude e o seu professor sob demanda.
Fazer (comandar): de o comando inicial, igual aos que voce viu aqui. O Claude executa e voce acompanha.
Verificar (exigir prova): nao aceite "pronto". Peca a prova: rodou, abriu, o resultado esta certo? Ver de fora, nao confiar no relato.
Guardar (memoria): o que deu certo, o que decidiu, vira memoria. Da proxima vez a Naia ja sabe, e voce nao repete.
Evoluir: cada volta do ciclo te deixa mais rapido e mais exigente. O escritorio melhora sozinho junto.

O comando que fecha o loop

> Antes de dar por pronto, me prova que funcionou: mostra o resultado de fora
(rodou, abriu no navegador, o dado bateu). Depois guarda na memoria o que
decidimos aqui, pra proxima vez voce ja saber sem eu repetir.

Esse habito, exigir prova e guardar o aprendizado, e o que faz o escritorio andar sozinho ao seu lado.

O contrato de verificacao, de novo

A regra que abriu o Passo 1 e a que fecha o Passo 10: nao aceite "pronto" sem prova. Todo trabalho entregue vem com a evidencia de que funciona, observada de fora. Faca disso o seu padrao e voce nunca mais vai perder tempo com algo que "parecia" certo e nao era. E assim, sem comprar curso nenhum, voce faz o que a gente faz.