Marcus Andrey Estudo
Read in English Biblioteca

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

  1. 1Preparar

    Arquivo de contexto e especificação.

    Passos 1–2
  2. 2Ler e planejar

    Ler o frame do Figma; aprovar um plano.

    Passos 3–4
  3. 3Construir e conferir

    Componentes reais; capturas de cada estado; acessibilidade.

    Passos 5–8
  4. 4Revisar e compartilhar

    Revisão humana; um link ou telas de volta no Figma.

    Passos 9–10
O fluxo de dez passos, de um frame do Figma a um protótipo em código conferido, em quatro fases. Diagrama: Marcus Andrey, CC BY 4.0.
  1. Contexto. Um CLAUDE.md com as regras do design system, mais um arquivo de contexto de design (tokens, componentes, princípios).
  2. Especificação. A especificação da funcionalidade numa pasta specs/ (veja Especificações de design para IA).
  3. Leitura. "Leia o frame do Figma <link> e liste os componentes e as variáveis que ele usa."
  4. Plano. Peça um plano primeiro: componentes, estados, dados de exemplo, perguntas em aberto. Aprove ou corrija.
  5. Construção. Com componentes reais do design system e dados de exemplo realistas e anonimizados.
  6. 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).
  7. Estados. "Adicione os estados vazio, carregando, erro e com 5.000 itens, e tire uma captura de cada um."
  8. Acessibilidade. "Rode uma verificação de acessibilidade, corrija os problemas de teclado e de foco, e me diga o que sobrou."
  9. Revisão humana. Pelas etapas do Processo de revisão de design com IA.
  10. 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.

  1. Comece com um design system público ou um conjunto pequeno dos seus componentes, com um CLAUDE.md curto.
  2. Conecte o Figma e teste o ciclo: ler um frame → planejar → construir → capturar a tela → comparar.
  3. Construa um protótipo a partir de uma especificação real e anonimizada. Marque o tempo e anote cada problema.
  4. 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

Livros, cursos e vídeos para ir mais fundo (em inglês)

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

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar