As 9 dicas práticas de Claude Code de Boris: afinal, a configuração dos especialistas é tão "simples" Boris Cherny tem um apelido dentro da Anthropic: o pai do Claude Code. Ele tem estado muito ativo no X recentemente, então muitas pessoas perguntaram a Boris: como você realmente usa o Claude Code? Ele acabou de compartilhar 9 dicas práticas no X. Não são tantas dicas quanto você imagina, cada uma é despretensiosa. 【1】Ideia central: as melhores práticas do Claude Code não têm uma resposta padrão Boris começou dizendo: > My setup might be surprisingly vanilla! Claude Code works great out of the box, so I personally don't customize it much. > A minha configuração pode ser surpreendentemente "original"! O Claude Code funciona muito bem logo de início, então eu pessoalmente não o personalizo muito. É compreensível, aquelas melhores práticas, como Skills e Plugins, como desenvolvedores do Claude Code, eles já incorporaram essas melhores práticas como funcionalidades. Não há uma única maneira correta de usar o Claude Code. A equipe intencionalmente o projetou para ser algo que você pode brincar à vontade, como você quiser, como você quiser modificar. Cada pessoa na equipe do Claude Code usa de maneira completamente diferente. Portanto, não há necessidade de se esforçar para encontrar "melhores práticas", o mais importante é encontrar o ritmo que funciona para você. 【2】Tarefas paralelas com múltiplos Agentes: execute várias instâncias do Claude ao mesmo tempo O dia a dia de Boris é assim: ele abre 5 instâncias do Claude Code no terminal, com as abas numeradas de 1 a 5, mantendo as notificações do sistema ativas, e vai para a aba que precisa de entrada. Ao mesmo tempo, ele também executa de 5 a 10 tarefas na versão web. O terminal e a web podem "interagir": usando o símbolo & para transferir a sessão local para a web, ou usando --teleport para alternar entre os dois. Ele inicia algumas tarefas no aplicativo Claude do celular pela manhã e durante o dia, e depois volta para ver os resultados. A lógica central desse modo de trabalho "multitarefa" é: o Claude Code é bom em executar tarefas de forma autônoma, muitas tarefas não precisam da sua supervisão. Você inicia a tarefa, dá uma direção, deixa que ela execute, e vai fazer outras coisas. Quando precisar da sua confirmação, você volta. Isso é completamente diferente do ritmo tradicional de "um humano digita uma linha de código, a IA complementa algumas linhas". Mas isso também exige mais do usuário, você precisa ser bom em atribuir tarefas aos Agentes e ser capaz de alternar entre várias tarefas a qualquer momento. Para quem está acostumado a desenvolver sozinho, com apenas uma tarefa em andamento, isso é um grande desafio. É constrangedor dizer, embora eu também use frequentemente o Coding Agent, ainda não estou acostumado a ter muitas tarefas rodando ao mesmo tempo, e este ano preciso melhorar nessa prática. 【3】Escolha do modelo: por que usar Opus em vez do mais rápido Sonnet Boris diz que usa Opus 4.5 com o modo de pensamento para todas as suas tarefas. Este é o melhor modelo de programação que ele já usou. Alguém pode perguntar: o Opus não é maior e mais lento que o Sonnet? A resposta de Boris é: embora a resposta única seja um pouco mais lenta, você precisa corrigir muito menos vezes, as chamadas de ferramentas também são mais precisas, e no final das contas, acaba sendo mais rápido. Eu sempre concordei com isso, escrever código não deve ser uma corrida, a qualidade é o que importa. Se um modelo rápido exige que você faça correções três vezes, é melhor usar um modelo mais lento que resolva tudo de uma vez. O tempo não é apenas o tempo de resposta do modelo, mas também o custo da sua atenção e energia. A única questão é que o Opus tem um custo mais alto. 【4】 é um arquivo de configuração especial do Claude Code, localizado no diretório raiz do projeto. Cada vez que o Claude Code é iniciado, ele lê automaticamente este arquivo e considera seu conteúdo como "conhecimento de fundo". Você pode entender isso como: é um manual do projeto que você escreve para a IA, informando-a sobre a estrutura, normas e pontos de atenção do projeto. A abordagem da equipe de Boris é: todo o repositório do Claude Code compartilha um Git, onde todos mantêm juntos. Toda semana, alguém adiciona algo. A regra é simples: cada vez que você vê o Claude cometer um erro, escreva "não faça isso" e na próxima vez ele saberá. Mais interessante é que eles também usam esse mecanismo durante as revisões de código. Boris menciona o colega no PR dele @.claude, pedindo ao Claude para adicionar uma nova regra ao . Isso é realizado através da ação do GitHub do Claude Code. Dan Shipper chama essa abordagem de "engenharia de juros compostos": cada correção se torna um ativo da equipe, fazendo com que a IA entenda cada vez mais o seu projeto. Se você ainda não usou o comando , o Claude analisará automaticamente a estrutura do projeto e gerará uma versão inicial. Então você pode usar e complementar, adicionando o que estiver errado. 【5】Modo de Planejamento: pense antes de agir Boris diz que a maioria de suas conversas começa no modo de Planejamento. No Claude Code, você pode alternar pressionando duas vezes Shift+Tab. No modo de Planejamento, o Claude não altera o código diretamente, mas primeiro fornece um plano de execução. Você pode discutir e modificar o plano até ficar satisfeito. Depois, mude para o modo de aceitação automática, e o Claude geralmente consegue completar tudo de uma vez. "Um bom plano é realmente importante", esse hábito na verdade traz a sabedoria clássica do desenvolvimento de software para a colaboração com IA: primeiro desenhe, depois codifique. O problema que muitas pessoas enfrentam ao usar IA para escrever código é que elas começam diretamente, resultando em um alto custo de retrabalho quando a direção está errada. Gastar alguns minutos alinhando o plano pode economizar horas de retrabalho. 【6】Automatização de trabalhos repetitivos: comandos de barra e sub Agentes Boris tem algumas operações que usa dezenas de vezes por dia, e ele as transformou em comandos de barra. Por exemplo, "/commit-push-pr", que completa o envio, o push e a criação do PR com um clique. Os comandos de barra são essencialmente arquivos Markdown, localizados no diretório .claude/commands/. Você pode escrever instruções em linguagem natural e também pode embutir scripts bash para obter algumas informações previamente, reduzindo o número de chamadas de ida e volta do modelo. Esses comandos podem ser enviados para o Git, compartilhados por toda a equipe. Além dos comandos de barra, ele também usa sub Agentes (um Agente é uma instância independente do Claude, dedicada a um tipo específico de trabalho. Por exemplo, ele tem um sub Agente code-simplifier, que automaticamente simplifica o código após o trabalho do Claude principal; e um sub Agente verify-app, que é responsável por testes de ponta a ponta. A característica comum dessas duas funcionalidades é: solidificar as tarefas que você faz repetidamente, permitindo que o Claude as chame por conta própria. Você não precisa explicar tudo de novo a cada vez, nem lembrar de todos os detalhes dos comandos. Use o PostToolUse Hook para formatar o código gerado pelo Claude. O Claude geralmente consegue gerar código bem formatado automaticamente, e esse Hook lidará com os últimos 10% do código, evitando erros de formatação durante o processo de integração contínua (CI). 【7】Segurança e integração: configuração de permissões e ferramentas externas Boris não usa a opção "perigosa" --dangerously-skip-permissions. Em vez disso, ele usa o comando /permissions para aprovar previamente alguns comandos de segurança comuns, evitando que a caixa de confirmação apareça a cada vez. Essas configurações são salvas em .claude/settings.json, compartilhadas pela equipe. Mais poderoso é a integração do servidor MCP. MCP é a sigla para Model Context Protocol, um protocolo padrão lançado pela Anthropic que permite que a IA se conecte a ferramentas externas. Através do MCP, o Claude Code pode diretamente: - Pesquisar e enviar mensagens no Slack - Executar consultas no BigQuery para responder a questões de dados - Puxar logs de erros do Sentry A equipe de Boris também enviou a configuração do MCP do Slack para o repositório, para que todos possam usar imediatamente. Isso significa que o Claude Code não é apenas uma ferramenta de programação, mas um "assistente multifuncional" que pode chamar toda a sua cadeia de ferramentas. 【8】Processamento de tarefas longas: deixe o Claude validar por conta própria Para tarefas que demoram muito, Boris tem algumas estratégias: Primeiro, deixe o Claude validar os resultados automaticamente com um Agente em segundo plano após a conclusão. Você pode solicitar isso na prompt, ou usar o Stop Hook para garantir que isso aconteça. > Nota: Hooks são o mecanismo de "ganchos" do Claude Code, permitindo que você insira lógica personalizada em momentos específicos da execução do Claude. Você pode entender isso como "gatilhos": quando um determinado evento ocorre, seu comando ou script pré-definido é executado automaticamente. > O Stop Hook é acionado quando o Claude completa a resposta e está prestes a devolver o controle. > Documentação relacionada: Em segundo lugar, use o plugin ralph-wiggum, que é essencialmente um "loop Bash": imagine um simples loop infinito (while true), que continuamente alimenta a mesma descrição de tarefa (arquivo de prompt) para a IA, permitindo que ela melhore seu trabalho repetidamente até que esteja completamente finalizado. Por último, use --permission-mode=dontAsk ou --dangerously-skip-permissions em um ambiente sandbox, permitindo que o Claude execute até o fim sem ser interrompido pela confirmação de permissões. A ideia central é: já que é uma tarefa longa, não a faça esperar. Dê a ela autonomia suficiente e capacidade de autocorreção. 【9】A mais importante: dê ao Claude a capacidade de validar Boris colocou essa dica por último, dizendo que isso pode ser o fator mais importante para obter bons resultados. Se o Claude puder validar seu próprio trabalho, a qualidade do resultado pode aumentar de 2 a 3 vezes. Ele deu um exemplo: cada alteração que eles submetem ao , o Claude testa automaticamente usando uma extensão do Chrome: abre o navegador, testa a interface do usuário, identifica problemas e itera até que a funcionalidade esteja correta e a experiência seja razoável. As formas de validação variam conforme o cenário. Pode ser executar um comando bash, pode ser rodar um conjunto de testes, pode ser testar um aplicativo em um navegador ou emulador de celular. A forma não importa, o importante é: dar feedback ao ciclo de feedback da IA. Esse princípio é realmente muito simples. Engenheiros humanos também garantem a qualidade através do ciclo "escrever código - testar - ver resultados - modificar". A IA funciona da mesma forma. Se ela só pode escrever e não testar, é como trabalhar de olhos fechados, a qualidade depende da sorte. A sugestão de Boris é: invista energia para solidificar o mecanismo de validação. Este é o investimento com o maior retorno.

O que Boris não mencionou é o fluxo de trabalho básico de CI/revisão de código, que pode ser algo comum para eles, que já estão habituados a grandes empresas, e que deveria ser algo padrão. Por exemplo, quando ele completa uma tarefa com o Claude Code, ele não simplesmente mescla diretamente na branch principal, mas sim submete um PR. Após submeter o PR, todos os lint e testes automatizados são executados automaticamente no servidor de CI, e se os testes falharem, o PR não pode ser mesclado. Um PR que passou por todos os testes automatizados ainda precisa ser revisado por alguém (claro que pode ser assistido por AI, mas ainda é necessário a confirmação humana), e se a revisão de código encontrar problemas, é necessário continuar a modificar. Para muitos desenvolvedores individuais, não é comum configurar um fluxo de trabalho de CI/revisão de código, e muitos nem sequer utilizam o gerenciamento de código Git, o que torna impossível reverter em caso de problemas.

【10】 Aquilo que não consegues ver Boris não mencionou um ponto importante que é a gestão de código fonte básica / CI (Integração Contínua) / workflow de revisão de código, que para eles, que estão habituados a grandes empresas, pode parecer algo comum, algo que deveria estar sempre presente. Por exemplo, quando ele usa o Claude Code para completar uma tarefa, não simplesmente mescla diretamente na branch principal, mas sim submete um PR. Após submeter o PR, todos os lint e testes automatizados são executados automaticamente no servidor CI, e se os testes falharem, o PR não pode ser mesclado. Um PR que passou em todos os testes automatizados ainda precisa ser revisado por alguém (claro que pode ser assistido por AI, mas ainda assim precisa de confirmação humana), e se a revisão de código encontrar problemas, é necessário continuar a fazer modificações. Esses também são a base para que eles consigam realizar múltiplas tarefas em paralelo; se não fizerem bem esses fluxos de trabalho básicos, não conseguem realizar múltiplas tarefas em paralelo. Para muitos desenvolvedores individuais, não é habitual construir um workflow de CI/revisão de código, e nem sequer fazem gestão de código com Git, e se houver problemas, não conseguem reverter.