IA para UX · Passo 2 · 9 min de leitura
Gerando design com Claude Code
Um guia para iniciantes sobre como designers constroem protótipos com componentes reais no Claude Code: as peças básicas (CLAUDE.md, skills, MCP, plan mode), um fluxo de dez passos do Figma ao código, exemplos de instruções, quem faz o quê, e os limites que mantêm tudo seguro.
O Claude Code é um agente de IA que trabalha dentro de um projeto de código. Você diz o que quer em linguagem simples; ele lê os arquivos, escreve código, roda, olha o resultado e corrige o que está errado. Para designers, isso abre um jeito novo de trabalhar: desenhar direto com a sua biblioteca de componentes real, ligada ao Figma, e conferir o resultado num navegador. Você não precisa ser dev, mas precisa trabalhar junto com um.
O que você vai conseguir fazer depois de ler:
- Explicar o que é o Claude Code e quando ele é uma escolha melhor do que uma ferramenta de prompt para protótipo
- Dizer quais são as peças básicas dele:
CLAUDE.md, skills, servidores MCP, plan mode - Seguir um fluxo de dez passos, de um frame do Figma até um protótipo em código conferido
- Definir os limites que mantêm os protótipos separados da produção
Detalhes de produto em novembro de 2026.
1. O que é o Claude Code, e por que designers usam
O Claude Code roda no terminal, em editores de código, num app de desktop e na web (visão geral). Diferente de um chat, ele consegue agir: abrir arquivos, rodar comandos, iniciar o app, tirar capturas de tela.
Por que isso importa para design:
- Protótipos com os seus componentes reais. Não "parece o nosso design system", mas é o design system: estados reais, comportamento responsivo real, formatos de dados reais.
- Um caminho mais curto do design ao código. Pela ligação com o Figma, o agente lê frames, variáveis e mapeamentos de componentes, e constrói com os componentes de código correspondentes.
- Pequenas ferramentas de design. Auditorias, plugins do Figma, scripts que conferem tokens: coisas que antes pediam uma tarde de um engenheiro.
| Use o Claude Code quando | Use uma ferramenta de prompt para protótipo quando |
|---|---|
| Já existe uma base de código com os seus componentes | Você está explorando uma ideia do zero |
| O protótipo deve ficar perto do que vai ser lançado | Você precisa de um teste ou demo rápido |
| Um engenheiro vai revisar e talvez construir em cima | Ninguém vai manter o código |
Veja Prototipação com IA para a segunda coluna.
2. As peças básicas
| Peça | O que é | Como designers usam |
|---|---|---|
CLAUDE.md |
Um arquivo de instruções do projeto que o agente lê no começo de toda sessão (documentação) | Princípios de design, regras do design system ("nunca use valores de cor soltos"), convenções de pastas. Veja arquivos de contexto |
| Skills | Instruções empacotadas (um SKILL.md mais arquivos) que o agente carrega para tarefas específicas (documentação) |
A frontend-design skill da Anthropic, que afasta o resultado da interface genérica "com cara de IA" (artigo); as skills do Figma; a sua própria skill de "regras do design system" |
| Servidores MCP | Conectores que dão ferramentas ao agente (MCP, documentação) | Figma (ler designs, variáveis, Code Connect; escrever no Figma) e Playwright (abrir um navegador, tirar capturas de tela, conferir comportamento) |
| Plan mode | O agente propõe um plano antes de mudar qualquer coisa (Shift+Tab) | Revise a abordagem como um briefing de design, antes de qualquer código ser escrito |
/design |
Briefing → artboards editáveis → você escolhe um → o Claude implementa | Explorar direções visuais antes do código; veja Claude Design |
| Plugins | Pacotes de skills, comandos e conectores que dá para compartilhar (documentação) | Dar a mesma configuração para o time inteiro |
3. Um fluxo prático: Figma → protótipo em código → revisão
- 1Preparar
Arquivo de contexto e especificação.
Passos 1–2 - 2Ler e planejar
Ler o frame do Figma; aprovar um plano.
Passos 3–4 - 3Construir e conferir
Componentes reais; capturas de cada estado; acessibilidade.
Passos 5–8 - 4Revisar e compartilhar
Revisão humana; um link ou telas de volta no Figma.
Passos 9–10
- Contexto. Um
CLAUDE.mdcom as regras do design system, mais um arquivo de contexto de design (tokens, componentes, princípios). - Especificação. A especificação da funcionalidade numa pasta
specs/(veja Especificações de design para IA). - Leitura. "Leia o frame do Figma
<link>e liste os componentes e as variáveis que ele usa." - Plano. Peça um plano primeiro: componentes, estados, dados de exemplo, perguntas em aberto. Aprove ou corrija.
- Construção. Com componentes reais do design system e dados de exemplo realistas e anonimizados.
- Conferência visual. "Abra no navegador, tire capturas de tela em 375 e 1440 px, compare com o frame do Figma e liste as diferenças." A própria orientação da Anthropic recomenda esse ciclo: uma captura do navegador ao lado do mock-up (boas práticas).
- Estados. "Adicione os estados vazio, carregando, erro e com 5.000 itens, e tire uma captura de cada um."
- Acessibilidade. "Rode uma verificação de acessibilidade, corrija os problemas de teclado e de foco, e me diga o que sobrou."
- Revisão humana. Pelas etapas do Processo de revisão de design com IA.
- Compartilhar. Um link do protótipo para teste, ou as telas principais mandadas de volta para o Figma.
4. Exemplos de instruções (copie e adapte)
Um trecho de CLAUDE.md (app de reservas fictício)
## Regras de design
- Os sócios usam isto no celular, muitas vezes com uma mão só: áreas de toque grandes, fluxos curtos.
- Use só componentes de @sportsclub/design-system; nunca crie componentes que imitam os nossos.
- Use design tokens (var(--ds-*)); nunca coloque cores, espaçamentos ou tamanhos de fonte fixos no código.
- Toda lista precisa dos estados vazio, carregando, erro e lista muito longa.
- Base de acessibilidade: WCAG 2.2 AA; foco visível; nunca só a cor para indicar status.
- Se um componente de que precisamos não existir, pare e liste como pergunta em aberto.
Um prompt de tarefa
Usando specs/court-closures.md e o frame do Figma <link>, construa um protótipo do
banner de fechamento de quadra e do fluxo de horário alternativo em /prototypes/closures.
Comece com um plano e espere o meu OK. Depois de construir, tire capturas de tela de
todos os estados no celular e no desktop e compare com o frame do Figma.
5. Quem faz o quê
| Quem | Faz |
|---|---|
| Designer | Escreve a especificação e o contexto, conduz o agente, revisa o visual e o comportamento, decide |
| Time de design system | Mantém atualizados os tokens, os componentes, os mapeamentos do Code Connect e o arquivo de contexto: a gramática do agente |
| Engenheiro | Revisa o código, decide o que (se alguma coisa) avança para produção, é dono da arquitetura |
| Design lead | Define a fronteira entre protótipo e produção, as etapas de revisão e as ferramentas aprovadas |
6. Limites de segurança
- Use só planos e configurações aprovados, com os controles de dados da sua organização. Veja governança de IA e proteção de dados.
- Nada de dados reais nos prompts ou nos dados de exemplo: use exemplos anonimizados.
- Mantenha os repositórios de protótipo separados da produção, a menos que a engenharia decida outra coisa.
- Coloque em todo protótipo gerado um aviso visível de "protótipo, não é produção".
- Revise o que o agente quer rodar. Não aprove pedidos de permissão no piloto automático.
Erros comuns:
- Pular o plano e receber uma mudança grande que você não consegue revisar.
- Não ter arquivo de contexto, e aí o agente inventa componentes e cores.
- Confiar no "funciona" sem olhar as capturas de tela e os estados.
- Deixar um protótipo virar código de produção sem ninguém perceber.
7. Vocabulário
| Termo | Significado |
|---|---|
| Repositório (repo) | A pasta de código e o histórico dela, normalmente no GitHub |
CLAUDE.md |
As instruções do projeto para o Claude Code |
| Skill | Um pacote reutilizável de instruções para um tipo de tarefa. Veja skills de agente |
| MCP | O padrão que liga o agente a ferramentas como o Figma ou um navegador |
| Plan mode | O agente propõe antes de mudar qualquer coisa |
| Code Connect | O mapeamento do Figma entre componentes de design e componentes de código |
8. Experimente
Você vai precisar de um repositório de teste (sandbox), de preferência montado com um engenheiro.
- Comece com um design system público ou um conjunto pequeno dos seus componentes, com um
CLAUDE.mdcurto. - Conecte o Figma e teste o ciclo: ler um frame → planejar → construir → capturar a tela → comparar.
- Construa um protótipo a partir de uma especificação real e anonimizada. Marque o tempo e anote cada problema.
- Mostre o resultado e as suas anotações num show and tell do time.
Perguntas para refletir: quais das suas decisões de design o agente errou quando não havia uma regra no CLAUDE.md? Quem no seu time decidiria se alguma parte desse código fica?
9. Se você lidera um time
- Junte cada designer com um engenheiro no primeiro protótipo.
- Faça do arquivo de contexto e do Code Connect uma responsabilidade compartilhada entre design e engenharia.
- Escreva a fronteira entre protótipo e produção, e as etapas de revisão, antes do primeiro projeto.
Checklist
Para saber mais
- Claude Code: Overview · Best practices · Skills · MCP · Plugins
- Conferência visual: Playwright MCP · Claude in Chrome (precisa de um plano direto da Anthropic) · Desktop app previews
- Figma e Claude Code: MCP setup · Write to canvas · Code to canvas
- NN/g: GenUI vs. Vibe Coding: Who's Designing? · The Role of UX in Agentic Software Factories
Livros, cursos e vídeos para ir mais fundo (em inglês)
- The Custodial Era of UX: Cleaning Up After AINN/g (site externo)
- Sentient DesignJosh Clark and Veronika KindredRosenfeld Media (Amazon)
Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.
Relacionadas
Prototipação com IA · Especificações de design para IA · IA no Figma · Claude Design · Processo de revisão de design com IA · Arquivos de contexto · MCP · Agentes e skills de UX: um guia para designers