Três meses atrás quase contratei um segundo desenvolvedor backend. Tínhamos um backlog que era constrangedor -- quatorze features prometidas aos clientes, duas pessoas sobrecarregadas, e eu alternando entre chamadas de vendas e pull requests como um completo idiota. Aí comecei a usar Claude Code propriamente. Não apenas colando funções numa janela de chat. Quero dizer integrando isso no fluxo de trabalho real diário. Limpamos aquele backlog em seis semanas. Não contratei o segundo desenvolvedor.using Claude Code properly. Not just pasting functions into a chat window. I mean integrating it into the real daily flow. We cleared that backlog in six weeks. I didn't hire the second developer.
Isso não é um pitch. É só o que aconteceu.
O Que "Propriamente" Realmente Significa
A maioria das pessoas que falo em meetups estão usando ferramentas de codificação com IA da mesma forma preguiçosa. Colam uma função, recebem algo de volta, colam no editor, quebra, desistem. Isso não é um fluxo de trabalho. É desespero.
Propriamente -- para mim -- significa que Claude Code vive dentro do meu terminal via Claude Code CLI, trabalhando direto no meu repo real, lendo arquivos reais, não snippets sanitizados. A diferença é enorme. Quando tem contexto completo de um plugin WordPress de 4.000 linhas que construímos para um cliente de saúde dos EUA no ano passado, o output é utilizável. Quando está trabalhando às cegas com um paste de 40 linhas, está chutando.Claude Code CLI, working directly on my actual repo, reading real files, not sanitised snippets. The difference is enormous. When it has full context of a 4,000-line WordPress plugin we built for a US healthcare client last year, the output is usable. When it's working blind off a 40-line paste, it's guessing.
Rodo em um MacBook Pro M3. Meu editor ainda é VS Code com os suspeitos usuais -- Prettier, ESLint, GitLens. Claude Code não substitui nada disso. Fica ao lado.alongside it.
O Setup Que Eu Realmente Uso
- Claude Code CLI instalado globalmente via npm
- Um diretório .claude na raiz de cada projeto com um arquivo CLAUDE.md -- isto é basicamente um brief que escrevo para Claude sobre o projeto: stack, convenções, o que não mexer.
.claudedirectory in each project root with aCLAUDE.mdfile -- this is basically a brief I write for Claude about the project: stack, conventions, what not to touch - iTerm2 com split panes: código à esquerda, sessão do Claude à direita
- Git commits depois de cada mudança gerada pelo Claude, sem exceções. Já fui queimado.
Esse último ponto. Lá em 2022 num projeto de cliente -- migração Shopify para uma varejista de móveis de Manchester -- deixei três horas de edições assistidas por IA se acumularem sem fazer commit. A sessão toda corrompeu. Seis horas de trabalho perdidas. Agora faço commit obsessivamente, quase neuroticamente. Claude Code ou não.
A Rotina Matinal (Isso É Propositalmente Entediante)
Estou no escritório às 8h30. Café do lugar na Exmouth Market. Abro o Notion, vejo o que está na fila para o dia, aí abro meu terminal.
A primeira coisa que faço com Claude Code toda manhã é o que comecei a chamar de "context dump". Abro o projeto, rodo claude e dou um parágrafo de onde parei no dia anterior. Ele lê o git diff recente automaticamente. Isso leva uns três minutos e significa que não estou gastando vinte minutos relendo meu próprio código para lembrar no que estava. Só isso já vale a assinatura.claude and give it a paragraph of where I left off the previous day. It reads the recent git diff automatically. This takes about three minutes and means I'm not spending twenty minutes re-reading my own code to remember what I was doing. That alone is worth the subscription.
Depois trabalho. Não estou pedindo a Claude para escrever features do zero -- embora às vezes faça. Principalmente estou pedindo para fazer as coisas que me deixam lento mas exigem zero criatividade.
Coisas como:
- Escrever casos de teste PHPUnit para funções que já escrevi
- Gerar interfaces TypeScript a partir de uma resposta JSON que colo
- Refatorar um componente de 300 linhas que sei que precisa dividir mas não quero pensar sobre.know needs splitting but don't want to think about
- Documentação em primeira versão para APIs internas
Nada disso é emocionante. Tudo isso costumava consumir uma hora que eu não tinha.
Onde Realmente Economiza Tempo (Com Números)
Seahawk construiu mais de 12.000 sites até agora. Uma grande parte disso é WordPress -- temas, plugins, customizações WooCommerce. Há uma categoria de tarefa no desenvolvimento WordPress que é entediante mas tecnicamente precisa: escrever custom hooks, registrar endpoints REST API, construir páginas de configurações com a Settings API.
Medi isso mês passado. Escrever uma classe custom shipping method do WooCommerce do zero: historicamente me leva uns 45 minutos incluindo testes. Com Claude Code fazendo o scaffold enquanto descrevo a lógica de negócio em inglês puro: 12 minutos. E o scaffold é bom -- segue padrões de código WordPress porque disse isso no meu CLAUDE.md.good -- it follows WordPress coding standards because I told it to in my CLAUDE.md.
Isso não é 10% mais rápido. É uma categoria diferente de velocidade.
A economia maior é o custo de troca de contexto. Quando estou no meio de uma feature e um cliente avisa sobre um bug em um projeto completamente diferente, eu costumava ignorar o cliente (ruim) ou perder meu raciocínio inteiro (também ruim). Agora posso pedir ao Claude para escrever um bloco de comentário detalhado resumindo exatamente onde estamos na tarefa atual, mudar para o bug, corrigi-lo, voltar, ler o comentário e continuar em cerca de quatro minutos. Antes, essa recuperação me custava vinte.
Onde Isso Falha
Honestidade total. E isso importa mais que as vitórias.
Claude Code é genuinely ruim em qualquer coisa que exija entender por que uma decisão foi tomada historicamente. Tínhamos um projeto fintech na Seahawk — um dashboard para uma startup de pagamentos baseada em Londres — onde existia um pedaço particularmente complicado de gerenciamento de estado por uma razão que predatava nosso envolvimento. Um edge case em como sua API legada fazia batch de respostas. Claude continuava "corrigindo". Cada sugestão era tecnicamente mais limpa e completamente errada. Não sabia o que não sabia.why a decision was made historically. We had a fintech project at Seahawk -- a dashboard for a London-based payments startup -- where a particularly gnarly bit of state management existed for a reason that predated our involvement. Some edge case in how their legacy API batched responses. Claude kept "fixing" it. Every suggestion was technically cleaner and completely wrong. It didn't know what it didn't know.
Esse é o failure mode que ninguém fala o suficiente. O output parece correto. Passa na revisão básica. E aí quebra em produção numa quinta à noite quando um usuário bate naquele edge case.looks correct. It passes basic review. And then it breaks in production on a Thursday evening when a user hits that edge case.
Minha regra agora: Claude Code não toca em nada onde o comentário diz "não mude isso sem perguntar para o Ravi." (Ravi é nosso lead backend dev.) Ponto final.
Também tem dificuldade séria com:
- Refatorações multi-arquivo onde a cadeia de dependências tem mais de três níveis de profundidade
- Qualquer coisa envolvendo um SDK de terceiros com menos de dois anos — ele alucina nomes de método com confiança
- CSS que precisa corresponder exatamente ao comp do designer (fica perto, aí te deixa louco com pequenos erros)
- Otimização de performance onde o gargalo não é óbvio — ele otimiza a coisa errada
No ponto dois especificamente: estava integrando a API do Resend num projeto Next.js em janeiro. Claude ficava referenciando um método .send() que não existe no Resend Node SDK. Levou mais tempo debugando a confiante incorreção de Claude do que teria levado apenas ler a documentação eu mesmo. Lição aprendida. Para qualquer SDK, colo o README real na janela de contexto primeiro.Next.js project in January. Claude kept referencing a.send()method that doesn't exist in the Resend Node SDK. Took me longer to debug Claude's confident wrongness than it would've taken to just read the docs myself. Lesson learned. For any SDK, I paste the actual README into the context window first.
Os Padrões de Prompt Que Realmente Funcionam
Itersei sobre isso por meses. Prompts ruins geram outputs ruins. Aqui está o que cheguei.
Seja o dev sênior, não o estagiário. Não pergunta "escreve uma função que faz X." Pergunta "preciso implementar X. Aqui está a restrição: Y. Aqui está o que já descartei: Z. Qual é sua abordagem antes de escrever qualquer coisa?" Faz ele pensar primeiro. O output depois dessa conversa é dramaticamente melhor.Don't ask "write me a function that does X." Ask "I need to implement X. Here's the constraint: Y. Here's what I've already ruled out: Z. What's your approach before you write anything?" Make it think first. The output after that conversation is dramatically better.
Dá a ele uma persona com riscos. Eu literalmente escrevo: "Você é um desenvolvedor WordPress sênior que se importa profundamente em não introduzir vulnerabilidades de segurança. O cliente é uma empresa de saúde. Priorize sanitização e verificação de nonce acima de tudo." Isso parece boba? Sim. Funciona? Também sim.I literally write: "You're a senior WordPress developer who cares deeply about not introducing security vulnerabilities. The client is a healthcare company. Prioritise sanitisation and nonce verification above everything." Does this feel silly? Yes. Does it work? Also yes.
Especifique o formato do output. "Me dá só a função, sem explicação" ou "Me dá a função, depois uma lista com bullet points do que eu deveria verificar manualmente." Output não estruturado desperdça tempo."Give me just the function, no explanation" or "Give me the function, then a bullet list of what I should manually verify." Unstructured output wastes time.
Um padrão que eu uso constantemente:
- Descreva o objetivo em uma frase
- Cole o código existente relevante com um comentário explicando seu propósito
- Declare a restrição ("deve ser compatível com versões anteriores do PHP 7.4")
- Peça uma abordagem primeiro, código depois
- Revise a abordagem, questione se necessário, depois peça o códigothen ask for the code
Cinco passos. Parece overhead. Me poupa quinze minutos de código ruim sempre que faço.
Como Isso Mudou o Que Eu Delego
Essa é a parte que mais me surpreendeu. Claude Code não apenas me tornou mais rápido. Mudou o que eu repasso para desenvolvedores juniores.me faster. It changed what I hand off to junior developers.
Antes, um dev junior na Seahawk passaria suas primeiras duas semanas apenas se familiarizando com nossas convenções e nossa stack. Agora eu repasso um projeto com um CLAUDE.md bem escrito e digo a eles para usar Claude Code para gerar código de scaffold, depois revisar contra as convenções. Eles estão contribuindo com trabalho real em três dias em vez de três semanas.CLAUDE.md and tell them to use Claude Code to generate scaffold code, then review it against the conventions. They're contributing real work in three days instead of three weeks.
O arquivo CLAUDE.md está fazendo o mentoring que eu costumava fazer em walkthroughs de uma hora. Essa é uma mudança significativa. Não porque eu não queira fazer mentoring — eu quero — mas porque agora as conversas de mentoring são sobre decisões e trade-offs, não "lembre-se de usar wp_nonce_field() em cada formulário."CLAUDE.md file is doing the mentoring I used to do in hourly walkthroughs. That's a meaningful shift. Not because I don't want to mentor -- I do -- but because now the mentoring conversations are about decisions and trade-offs, not "remember to use wp_nonce_field()in every form."
A documentação de especificação do modelo Anthropic vale a pena ler se você tem curiosidade sobre os guardrails dentro dos quais Claude opera — entendê-los ajuda você a trabalhar com suas tendências em vez de contra elas.Anthropic model spec documentation is worth a read if you're curious about the guardrails Claude operates within -- understanding them helps you work with its tendencies rather than against them.
A Perspectiva do Fundador
A maioria dos artigos sobre ferramentas de IA para codificação é escrita para desenvolvedores. Tudo bem. Mas há um problema específico do fundador que Claude Code resolve e que eu não tinha visto bem articulado.
Quando você está administrando uma agência e também entregando código, seu maior inimigo não são lacunas de habilidade. É o custo de re-entrada. Você é puxado para uma call de preço por quarenta minutos, depois precisa corrigir uma regressão de CSS, depois tem um 1-on-1 com um membro da equipe. Quando você finalmente volta para a feature que estava construindo, perdeu o fio de forma tão completa que começar de novo parece mais fácil do que continuar.re-entry cost. You get pulled into a pricing call for forty minutes, then you need to go fix a CSS regression, then you have a 1-on-1 with a team member. By the time you get back to the feature you were building, you've lost the thread so completely that starting again feels easier than picking up.
Claude Code, usado corretamente, reduz drasticamente o custo de retomada. Mencionei o truque do bloco de comentário de resumo antes. Eu também uso para gerar uma rápida mensagem no Slack para mim mesmo com bullet points do que foi feito, o que vem a seguir e o que está bloqueado. Leva dez segundos. Poupa dez minutos de reconstrução.
Não vai te fazer um gestor melhor. Não vai limpar sua agenda. Mas se você é um founder que ainda shippa código — e acho que mais de nós deveríamos — ele remove um imposto específico e doloroso no seu tempo de codificação.
FAQ
Vale a pena Claude Code se você não é um desenvolvedor em tempo integral?
Honestamente, provavelmente menos. O valor se compõe quando você está na ferramenta todos os dias e investe tempo construindo bons arquivos de contexto (CLAUDE.md, briefs de projeto claros, etc.). Se você está usando uma vez por semana, você vai gastar mais tempo re-estabelecendo contexto do que economiza. GitHub Copilot pode ser mais adequado para usuários ocasionais — é mais ambient e exige menos setup deliberado.CLAUDE.md, clear project briefs, etc.). If you're dipping in once a week, you'll spend more time re-establishing context than you save. GitHub Copilot might suit occasional users better -- it's more ambient and requires less deliberate setup.
Como você lida com qualidade de código — você apenas confia no que ele gera?
Nunca cegamente. Todo arquivo gerado por Claude passa por ESLint e nossa config do Prettier automaticamente. Para qualquer coisa tocando autenticação, pagamentos ou manipulação de dados, eu faço uma leitura manual linha por linha. Para funções utilitárias e testes, sou mais relaxado. Você calibra baseado no risco. O OWASP Top Ten é um checklist mental útil ao revisar código gerado por IA que manipula entrada do usuário.OWASP Top Ten is a useful mental checklist when reviewing AI-generated code that handles user input.
Funciona bem especificamente com WordPress?
Melhor do que esperava, com ressalvas. Ele conhece WordPress profundamente — hooks, filters, a Settings API, internals do WooCommerce. Mas seu conhecimento de desenvolvimento mais novo de blocos Gutenberg (particularmente a Interactivity API) é irregular. Sempre verifico contra o Block Editor Handbook para qualquer coisa relacionada a blocos.Block Editor Handbook for anything block-related.
E quanto ao custo?
Pago por Claude Pro, que custa $20/mês. No nível em que o uso, a economia de tempo fica entre quatro e seis horas por semana. Faça as contas com sua própria taxa horária. Para mim não é uma pergunta que valha a pena fazer.
---
Eu ainda escrevo bastante código. Não estou interessado em me tornar um prompt jockey que nunca toca em uma função real. Mas o founder que finge que ferramentas de codificação AI não mudaram o craft está se enganando. A questão não é se usar ou não. É se você está usando com rigor suficiente para obter valor real — ou apenas negligência suficiente para introduzir problemas reais.
Para mim, a diferença entre essas duas coisas veio de tratar o Claude Code como um desenvolvedor capaz mas júnior. Inteligente. Rápido. Precisa de um bom briefing. Precisa de revisão. E absolutamente não deve ser deixado sem supervisão perto de qualquer coisa mission-critical.
Esse enquadramento mudou tudo.