Expert Tools · Trilha 5: avançado · Guia 11
Conectar o Claude ao Revit
Ligue a inteligência artificial ao seu modelo: você pede em português, o Claude lê a seleção, consulta parâmetros, edita em lote e ainda guarda o que deu certo como automação reutilizável.
Para que serve
Existe uma categoria de tarefa que nenhum botão resolve, porque ela muda a cada projeto: "coloque o comentário X em todas as tomadas deste ambiente", "confira se estes circuitos têm o mesmo parâmetro preenchido", "me diga por onde passa a rota deste circuito". São tarefas de cinco minutos que, repetidas, viram uma hora.
Com a conexão ativa, você conversa com o Claude e ele age no seu Revit: lê o que está selecionado, consulta e escreve parâmetros, lista avisos do modelo e percorre circuitos. E quando uma sequência funciona, ele salva como automação para você repetir depois com um clique, sem gastar conversa.
O plugin fornece a ponte, mas o Claude é um aplicativo separado: você precisa ter o Claude Desktop (ou o Claude Code) instalado e com a sua conta.
Passo a passo: parear
- Clique em Conectar Claude abre a tela de status, mostrando se o Claude já conversa com este Revit.
- Escolha onde você usa o Claude Três opções: Claude Desktop, Claude Code (VS Code, JetBrains ou terminal) e Outro cliente MCP (Cursor, Windsurf, Zed). a tela mostra só as instruções do aplicativo que você escolheu.
- Siga a instalação em um clique (Claude Desktop) O plugin entrega um instalador de extensão pronto. O botão Abrir pasta da extensão leva direto ao arquivo. o Claude Desktop passa a enxergar o seu Revit.
- Para Claude Code ou outro cliente, use o comando e o token A tela mostra o comando a rodar uma vez no terminal, e os botões Copiar token e Copiar evitam digitação.
- Volte ao Revit e confira o status a tela indica o estado da conexão.
Como ler o status
| Mensagem | Significado | O que fazer |
|---|---|---|
| Conectado, ativo agora | O Claude está conversando com este Revit neste momento | Nada. Pode pedir |
| Servidor pronto, ainda sem conversa nesta sessão | Tudo configurado, mas você ainda não pediu nada desde que abriu o Revit | Faça um pedido ao Claude |
| Servidor de pé, mas sem notícia do Claude há um tempo | A conexão existiu e ficou ociosa | Normal. Basta pedir algo de novo |
| Já configurado, mas o servidor não iniciou | Pode acontecer se o Revit acabou de abrir | Aguarde alguns segundos e use Tentar novamente |
| O Claude ainda não está conectado a este Revit | Falta parear | Siga o passo a passo acima |
A tela nunca mostra "conectado" só porque a configuração existe. Ela diferencia configurado de conversando, para você não perder tempo procurando defeito onde não há.
O que dá para pedir
O Claude não faz qualquer coisa no Revit: ele usa um conjunto curado de ferramentas. Saber quais são ajuda a formular pedidos que funcionam.
| Capacidade | Exemplo de pedido |
|---|---|
| Ler a seleção atual | "O que eu tenho selecionado agora?" |
| Selecionar elementos | "Selecione as tomadas deste ambiente" |
| Consultar parâmetro | "Qual o valor do comentário desses elementos?" |
| Escrever parâmetro | "Preencha o comentário com REVISAR em todos os selecionados" |
| Listar avisos do modelo | "Quais avisos existem neste projeto?" |
| Percorrer um circuito | "Me mostre a rota física deste circuito" |
| Salvar uma automação | "Salve isso como automação para eu repetir depois" |
Selecione no Revit antes de pedir. "Faça isso nos selecionados" é mais preciso e mais rápido que descrever o conjunto por escrito.
Minhas automações
Quando uma sequência de passos funciona, ela pode ser guardada. A partir daí você a executa direto do painel, sem conversar com o Claude e sem consumir crédito de conversa.
- Peça ao Claude para salvar depois de algo dar certo a automação passa a aparecer em Minhas automações.
- Atualize a lista Use ↻ Atualizar logo após o Claude salvar.
- Execute com ▶ Rodar os passos são aplicados de uma vez. Ao final aparece "Automação concluída".
Os selos da lista
| Selo | O que quer dizer |
|---|---|
| ⚡ Automação | Pronta para rodar |
| 📋 Playbook | Roteiro de passos, para você seguir ou pedir ao Claude executar |
| 🎓 candidata | Sequência que deu certo e pode virar automação |
| ⚠ indisponível | Um passo usa recurso que não está disponível nesta sessão |
O botão ⧉ Copiar prompt copia o texto do pedido para você colar no Claude. Serve para ajustar um passo antes de rodar, ou para compartilhar a instrução com um colega da equipe.
Segurança e bom senso
- Peça alterações com o escopo claro. "Todos os elementos do projeto" é diferente de "os selecionados".
- Uma alteração feita por automação é uma alteração normal do Revit: Ctrl + Z desfaz.
- Em modelo compartilhado, trate como qualquer edição em lote: confira antes de sincronizar.
Quando não funciona
| Sintoma | Por que acontece | Solução |
|---|---|---|
| O Claude diz que não encontra o Revit | Pareamento não concluído, ou Revit fechado | Abra o Revit, clique em Conectar Claude e confira o status |
| Status preso em "não iniciou" | O Revit acabou de abrir e o servidor ainda está subindo | Aguarde e use Tentar novamente |
| A automação aparece como indisponível | Um passo dela usa ferramenta que não está registrada nesta sessão | Reabra o Revit; se persistir, refaça a automação |
| A lista de automações não mostra a que acabei de salvar | A lista não recarrega sozinha | Clique em ↻ Atualizar |
| "Automação não concluída" | Um passo não pôde ser aplicado no contexto atual | Confira se a seleção e a vista são as mesmas de quando ela foi criada |
Limites conhecidos
- Não é acesso irrestrito à API do Revit. São ferramentas curadas: o que não está na lista, ele não faz.
- Não modela para você. O foco é consulta, seleção e edição de dados.
- Precisa do Revit aberto. A ponte é com esta sessão, não com o arquivo.
Resumo de 30 segundos
- Aba Expert Tools, botão Conectar Claude.
- Escolha o seu aplicativo: Desktop, Claude Code ou outro cliente.
- Desktop tem instalação em um clique; os demais usam comando e token.
- Status honesto: "configurado" é diferente de "conversando".
- Selecione no Revit e peça em português: ler, selecionar, consultar, escrever, listar avisos, percorrer circuito.
- Deu certo? Peça para salvar e rode depois em Minhas automações.
Notas de gravação
- Não mostre o token na tela. Corte ou borre: ele dá acesso à sua sessão.
- Comece com um pedido de leitura ("o que está selecionado?"). Ver a IA acertar sem alterar nada baixa a resistência do aluno.
- Só depois mostre uma edição em lote, e desfaça com Ctrl+Z na frente da câmera. Isso resolve o medo principal.
- Feche com uma automação salva e rodando: é o argumento de produtividade recorrente.