text-to-cad: como instalar o plugin que faz o Claude Code, o Codex e o Cursor gerarem peça 3D

O text-to-cad (earthtojake/text-to-cad, MIT, 17.112 estrelas e 1.757 forks em 05/10/2026, versão 0.7.14 de 05/10/2026) é um plugin que dá ao agente de código fluxos locais de CAD: gerar modelos 3D em STEP (saída principal), STL, 3MF ou GLB, mostrar o modelo num visualizador, fazer checagens de projeto para fabricação (DfAM/DFM), gerar desenhos técnicos e conectar a serviços de impressão 3D, chapa e CNC. Segundo o README, funciona no Claude Code, Codex, Cursor, Gemini e Grok.

São 12 skills: CAD, step.parts, Engineering Drawing, DXF, URDF, SRDF, SDF, SendCutSend, DfAM Check, DFM, G-code e Bambu Labs.

O que eu testei e o que não testei (05/10/2026, Windows 11): rodei o cadgen 0.7.14 direto, sem o agente. Um script build123d de 8 linhas gerou uma placa de 60×40×8 mm com 2 furos de Ø8 e cantos de r3: STEP de 41 KB, STL de 77 KB, 18.333,9 mm³ e 12 faces. A imagem da placa saiu do próprio cadgen step snapshot. O plugin funcionando pelo agente eu ainda não testei; os comandos de instalação abaixo são os do README.

• uv instalado. O CAD roda por ele. Confira:

uv --version

Se não tiver, use o instalador oficial do uv. - Python 3.11+ e Node 20+ (versões dos badges do README; o uv cuida do Python). - Internet na primeira inicialização: o plugin baixa o runtime de CAD. No meu teste do cadgen doctor foram 58 pacotes (o maior, o kernel de CAD, com 44,2 MiB). - Windows 11: veja a seção "Problemas comuns" (Smart App Control).

Instale o plugin ou as skills, nunca os dois no mesmo app (cada skill apareceria duas vezes).

Atalho: mande esta mensagem ao agente e ele instala sozinho:

Install text-to-cad from https://github.com/earthtojake/text-to-cad

Claude Code

claude plugin marketplace add earthtojake/text-to-cad
claude plugin install text-to-cad@earthtojake

Reinicie o Claude Code. Para atualizar:

claude plugin marketplace update earthtojake
claude plugin update text-to-cad@earthtojake

Codex

Exige Codex 0.142.0 ou mais novo: versões antigas ignoram o plugin em silêncio (ele nunca aparece em codex plugin list). Para atualizar o Codex:

npm install -g @openai/codex@latest

Depois:

codex plugin marketplace add earthtojake/text-to-cad
codex plugin add text-to-cad@earthtojake

Reinicie o Codex. No app, o plugin traz a aba CAD ao lado de cada conversa.

Cursor

O Cursor carrega o plugin que você instalou no Claude Code. Se já instalou lá, pule este passo. Senão:

git clone --depth 1 --branch plugin https://github.com/earthtojake/text-to-cad ~/.cursor/plugins/local/text-to-cad

Reinicie o Cursor. Para atualizar: git -C ~/.cursor/plugins/local/text-to-cad pull.

Qualquer outro agente (só as skills)

npx skills add earthtojake/text-to-cad

Para pular as perguntas: npx skills add earthtojake/text-to-cad -g -a <agente> -y.

Depois de reiniciar, peça a peça em linguagem natural (ou com uma imagem). O STEP é a saída principal; peça STL, 3MF ou GLB se precisar. Exemplo de pedido (ilustração minha, não é do README):

Faz uma placa 60×40×8 mm com 2 furos de Ø8 e cantos arredondados r3.

Onde o app mostra visualizações, o modelo aparece num cartão que você pode girar; no terminal, o agente devolve um link que abre o modelo no CAD Viewer, no navegador.

uvx --no-config --managed-python --python 3.13 --from cadgen==0.7.14 cadgen doctor

A linha kernel OK confirma que o kernel de CAD (OCP) carregou. No Codex, confira também que codex plugin list mostra text-to-cad@earthtojake.

• ImportError: DLL load failed while importing OCP no Windows 11: o Smart App Control (Controle Inteligente de Aplicativos) bloqueia a DLL não assinada do OCP. O README oferece duas saídas: rodar no WSL, ou desligar o Smart App Control (Configurações > Privacidade e segurança > Segurança do Windows > Controle de aplicativos e navegador). Atenção: depois de desligado, ele só volta reinstalando o Windows. O cadgen doctor aponta esse problema. No meu teste o Smart App Control não bloqueou.
• O plugin não aparece no Codex: versão abaixo de 0.142.0. Atualize o Codex e reinstale.
• Skills duplicadas: você instalou plugin e skills juntos. Fique com um.
• Para reinstalar: remova (claude plugin uninstall text-to-cad@earthtojake e claude plugin marketplace remove earthtojake) e instale de novo.

• Não há benchmark de desempenho no README; os números deste post são do repositório (estrelas, versão) e do meu teste (placa).
• O meu teste foi com o cadgen direto. Não verifiquei o plugin pelo agente, nem a impressão ou o envio a serviços de fabricação.
• Telemetria: o app e o visualizador só enviam contagens anônimas de uso se você aceitar no primeiro aviso; DO_NOT_TRACK=1 mantém desligado. O cadgen também checa versão nova no máximo 1 vez por dia (CADGEN_UPDATE_CHECK=0 desliga).
• É nicho: serve a quem projeta peças, não a quem quer economizar tokens.

• README e API do GitHub, lidos em 05/10/2026: github.com/earthtojake/text-to-cad
• Meu teste: Windows 11, uv 0.12.1, cadgen 0.7.14, 05/10/2026.

Quer o link e o passo a passo no direct? Comenta CAD3D no post do @henriquesilva.ai.