Quatro Workflows do Claude Code para Desenvolvedores WordPress
A maioria dos artigos sobre assistentes de codificação com IA para WordPress é escrita por pessoas que nunca deployaram um plugin. Dá para notar porque os exemplos são sempre "construa um shortcode Hello World" ou "gere um custom post type". Ninguém na verdade te paga para fazer isso. Te pagam quando o checkout quebra às 2 da manhã na Black Friday, e o ambiente de staging não consegue reproduzir o problema.
Estou usando Claude Code em produção desde o início de 2025, principalmente em trabalho de WordPress e WooCommerce para clientes de consultoria, e no meu próprio plugin WP-AutoInsight. O que segue são quatro workflows que realmente rodo, com os prompts que realmente uso.
Se você ainda não configurou Claude Code, comece aqui. A configuração do terminal importa mais do que as pessoas admitem, e não vou repetir aquele post.
1. Scaffolding de plugin que parece moderno
Todo autor de plugin WordPress tem um template privado que cola em novos projetos. O meu estava envelhecendo. Propriedades tipadas em PHP 8, namespaces, autoloading, padrões de hook modernos. O tipo de coisa que você fica querendo atualizar e nunca faz porque o template existente ainda funciona.
O prompt que uso:
Read the structure of WP-AutoInsight at ~/projects/wp-autoinsight
and use it as a reference for code style, but generate a fresh plugin scaffold for
[plugin name and one-line description]. Use PHP 8.1+, namespaces, PSR-4 autoloading
via Composer, a Singleton main class, and separate files for admin UI,
REST endpoints, and hooks. Include readme.txt with the WordPress.org format.
Do not invent functionality. Stop at empty class shells with proper docblocks.
A linha "do not invent functionality" é fundamental. Sem ela, Claude Code vai construir um plugin completamente funcional para algo que você não pediu, e você vai passar uma hora deletando código em vez de escrever.
O output é um diretório que posso imediatamente git init e começar a trabalhar. Aproximadamente quinze minutos de limpeza comparado a quarenta minutos começando do zero.
Qual é a pegadinha? Claude Code às vezes gera código em um formato ligeiramente desatualizado. Sempre compare com a especificação atual de readme do plugin antes de enviar.
2. Geração de scripts WP-CLI para tarefas pontuais de cliente
Metade do meu trabalho de consultoria envolve uma frase tipo "precisamos migrar 4.000 produtos dessa taxonomia antiga para essa nova sem quebrar SEO", e a melhor abordagem é "vamos criar um script WP-CLI", mas não estamos sendo pagos para criar um script; estamos sendo pagos para entregar a migração.
O prompt:
Generate a WP-CLI command class for [task]. The class should: register
a custom command, accept --dry-run and --verbose flags, batch operations
in groups of 200 with WP_CLI::log progress output, handle errors per item
without aborting the whole run, and write a CSV log file to wp-content/uploads/.
Use $wpdb only when WP_Query/WP_Term_Query is the wrong fit.
No external composer dependencies.
As restrições nesse prompt vêm de coisas que deram errado antes. --dry-run porque precisamos garantir que funcionará no lado do cliente sem erros. Tratamento de erro por item porque uma única linha corrompida quer dizer que uma migração de uma hora inteira vai abortar. Arquivo CSV de log porque alguém vai perguntar "quais produtos falharam?" três dias depois, e "não sabemos" não é uma resposta.
Esse é o valor de usar Claude Code em vez de um prompt genérico do ChatGPT. O modelo tem toda a estrutura do projeto disponível. Sabe quais classes existem, qual convenção de nomeação você usa, e onde você coloca scripts. O script volta, se encaixando no seu repo.
3. Verificações de sanidade em migração de tema
Não faço muitas migrações de tema mais. São trabalho tedioso, alto risco, baixa margem. Mas às vezes um cliente de longo prazo pede e, bem, você diz sim.
O que Claude Code faz bem aqui é a parte entediante: comparar dois diretórios de tema e dizer a você o que é realmente diferente versus o que é só espaço em branco e variáveis renomeadas.
Compare ~/projects/client-old-theme and ~/projects/client-new-theme.
List, in priority order:
(1) template files in the old theme that have no equivalent in the new theme,
(2) functions registered in the old theme's functions.php that are not registered
or differently named in the new one,
(3) hooks added/removed,
(4) enqueued scripts and styles that changed handles or paths.
Ignore whitespace, comments, and version numbers. Output as a markdown table.
O que isso economiza: aproximadamente quatro horas de verificação manual de diff por migração. O que não substitui: rodar o novo tema em staging com conteúdo real e clicar por aí. Claude Code pode dizer a você a diferença estrutural, mas você ainda precisa testar. A diferença é que agora a migração começa de um lugar sensato.
4. Auditoria de segurança de plugin antes de handoff de cliente
Esse é o workflow que justifica seu uso.
Quando entrego um plugin a um cliente, seja um que construí ou um que estão herdando de um desenvolvedor anterior, rodo uma passagem de segurança. Manualmente, isso pode levar um tempo, e é o tipo de trabalho onde você faz erros quando está cansado. Claude Code faz os erros para mim, que é o que prefiro.
Audit the plugin at ~/projects/[plugin-path] for the following, in this order:
1. SQL queries not using $wpdb->prepare()
2. $_GET, $_POST, $_REQUEST values used without sanitization functions
3. Output not escaped with esc_html, esc_attr, esc_url, or wp_kses
4. AJAX endpoints missing nonce verification
5. capability checks missing on admin actions
6. file_get_contents or wp_remote_get on user-supplied URLs without validation
For each finding, output: file path, line number, the offending code,
and the WordPress function that should be used instead.
Also, check if the codebase is WPCS-compliant and report any new errors or warnings that you didn't catch
Do not fix anything yet. Report only.
"Do not fix anything yet" importa. Claude Code é entusiasta. Se você não especificar, ele vai começar a tentar consertar as coisas para você, mesmo antes de você decidir se é OK gastar tokens e tempo naquele conserto. Encontre primeiro. Conserte depois, um achado de cada vez, com você revisando cada mudança.
Também, a linha WPCS é importante. Qualquer dev WordPress deveria ter phpcs rodando globalmente, com regras WPCS atualizadas.
O que esses workflows têm em comum
Todo prompt acima inclui uma restrição que para Claude Code de fazer a coisa errada. "Do not invent functionality." "Report only." "Stop at empty class shells." O modelo é prestativo, mas prestativo na direção errada é pior que não prestativo. Aprendi isso da forma cara, em um projeto de cliente real.
Claude Code é a melhor ferramenta de IA que já usei para trabalho com WordPress, e testei a maioria delas dentro de WP-AutoInsight. É também aquela que requer mais disciplina. Os prompts acima não são impressionantes. São chatos. Esse é o ponto.
Se seu time está preso no estágio de protótipo com ferramentas de IA e não consegue descobrir como colocá-las em produção com segurança, isso é literalmente o que faço para viver. Mande uma mensagem.