Dicas práticas do Código Claude 9 de Boris: Acontece que a configuração do mestre é tão "simples" Boris Cherny tem um apelido dentro de Anthropic: pai de Claude Code. Ele tem estado ativo no X ultimamente, então muita gente pergunta ao Boris: Como exatamente você usa o Claude Code? Ele acabou de compartilhar 9 dicas práticas sobre X. Não há tantos truques quanto você imagina, e cada um é simples. [1] Filosofia Central: Não existe uma resposta padrão para as melhores práticas de Claude Code Boris começou dizendo: > Minha configuração pode ser surpreendentemente simples! Claude Code funciona muito bem logo de saída, então pessoalmente não personalizo muito. > Minha configuração pode ser "original", como você espera. Claude Code funciona muito bem logo de cara, e pessoalmente não fiz muita personalização. É compreensível que essas melhores práticas, como Skills e Plugins, já estejam integradas há muito tempo em recursos como desenvolvedores do Claude Code. Não existe uma única maneira correta de usar o Claude Code. A equipe projetou deliberadamente para ser jogado casualmente, e você pode usar como quiser, como quiser mudar e como quiser mudar. Cada um na equipe do Claude Code usa de formas completamente diferentes. Então não há necessidade de lutar para encontrar "melhores práticas", o mais importante é seguir seu próprio ritmo. [2] Tarefas multi-agente em paralelo: Abrir mais de uma dúzia de Claudes ao mesmo tempo A rotina diária do Boris é assim: abrir 5 instâncias do Claude Code no terminal, abas números 1 a 5, ativar as notificações do sistema e pular qual precisa ser inserida. Ao mesmo tempo, ele também executa de 5 a 10 tarefas na versão web. Terminais e páginas web podem "transferir-se" um ao outro: use o símbolo & para transferir a sessão local para a página web, ou use --teleport para alternar entre ambos os lados. Ele inicia várias tarefas pelo aplicativo Claude no celular todas as manhãs e durante o dia, e volta depois para ver os resultados. A lógica central desse modo "multi-threaded" de trabalhar é que o Claude Code é bom em autonomia, e muitas tarefas não exigem que você fique de olho. Você começa a tarefa, dá uma direção, deixa rodar e faz outra coisa por conta própria. Reduza quando precisar da sua confirmação. Isso é completamente diferente do tradicional "humano digitando uma linha de código, IA formando algumas linhas". No entanto, isso também exige requisitos maiores para os usuários, e você precisa ser bom em atribuir tarefas aos agentes e poder alternar entre várias tarefas a qualquer momento. Esse é um grande desafio para modelos tradicionais de desenvolvimento que estão acostumados a desenvolver sozinhos e têm apenas uma tarefa ao mesmo tempo. Tenho vergonha de dizer que, embora eu também use o Coding Agent regularmente, ainda não estou acostumado a executar muitas tarefas ao mesmo tempo, então vou fortalecer minha prática nessa área este ano. [3] Seleção de modelos: Por que usar o Opus em vez do Sonnet, mais rápido. Boris diz que usa o Opus 4.5 para todas as tarefas com o modo de pensamento. Esse é o melhor modelo de programação que ele já usou. Algumas pessoas vão perguntar: Opus não é maior e mais lento que Sonnet? A resposta do Boris é que, embora a resposta única seja um pouco mais lenta, você precisa corrigi-la muito menos, as chamadas de ferramenta são mais precisas e o resultado final é mais rápido. Na verdade, sempre concordei que escrever código não pode ser rápido, mas deve ser de alta qualidade; se um modelo rápido exigir que você corrija três vezes, é melhor usar um modelo lento para fazer isso de uma vez. Tempo não é apenas sobre o tempo de resposta do modelo, mas também sobre seus custos de atenção e esforço. O único problema é que o Opus custa mais. 【4】 é um arquivo de configuração especial do Claude Code, colocado na raiz do projeto. Toda vez que você inicia o Claude Code, ele lê automaticamente o arquivo e trata seu conteúdo como "conhecimento de fundo". Você pode entendê-lo como: Esta é a especificação do projeto que você escreveu para a IA, informando a estrutura, especificações e precauções do projeto. A abordagem da equipe Boris é que todo o repositório Claude Code é mantido em um único Git. Toda semana, as pessoas adicionam coisas ao Rigano. A regra é simples: toda vez que você vir Claude fazendo algo errado, escreva "não faça isso" nele, e da próxima vez ele saberá. O que é ainda mais interessante é que eles também usam esse mecanismo ao revisar código. Boris vai @.claude no PR de um colega e pedir para Claude adicionar uma nova regra a . Isso é alcançado por meio do GitHub Action do Claude Code. Dan Shipper chama isso de "projeto de juros compostos": toda correção de erro se torna um ativo da equipe, permitindo que a IA compreenda cada vez melhor seu projeto. Se você ainda não usou o comando, Claude analisará automaticamente a estrutura do projeto e gerará uma versão inicial. Depois, você adiciona conforme usa, e adiciona o que está errado quando vê. [5] Modo planejamento: pense claramente antes de fazer isso Boris diz que começa a maioria das sessões no modo Plano. Clique duas vezes em Shift+Tab no Claude Code para trocar. No modo Plano, Claude não altera o código diretamente, mas te dá um plano de execução primeiro. Você pode discutir e revisar seu plano de um lado para o outro até ficar satisfeito. Depois mude para o modo de aceitação automática, que Claude geralmente faz de uma vez só. "Um bom planejamento é realmente importante", esse hábito na verdade transfere a sabedoria clássica do desenvolvimento de software para a colaboração em IA: primeiro projetar e depois programar. O problema de muitas pessoas usarem IA para escrever código é iniciar diretamente, e o resultado é que o custo de rework é alto devido à direção errada. Gastar alguns minutos alinhando seu plano economiza horas de retrabalho. [6] Automatizar trabalho repetitivo: comandos de barra e subagentes Boris teve várias operações que teve que fazer dezenas de vezes por dia, e as transformou em comandos de corte. Por exemplo, "/commit-push-pr" completa a submissão, o push e a criação de PR com um clique. Comandos de barra são basicamente arquivos Markdown que são colocados no diretório .claude/commands/. Você pode escrever comandos em linguagem natural, e também pode incorporar scripts bash para obter algumas informações no início, reduzindo o número de chamadas de ida e volta do modelo. Esses comandos podem ser submetidos ao Git e compartilhados por toda a equipe. Além do comando de barra, ele também usa um subagente (um agente é uma instância separada de Claude que se especializa em certos tipos de trabalho. Por exemplo, ele possui um subagente simplificador de código que simplifica automaticamente o código após o Claude principal concluir seu trabalho. Há também um subagente de verificação de apps responsável pelos testes de ponta a ponta. O que essas duas características têm em comum é que você solidifica o que faz repetidamente e deixa Claude chamar isso de si mesmo. Você não precisa repetir a explicação toda vez ou lembrar dos detalhes do comando. Use o Gancho PostToolUse para formatar o código gerado por Claude. Claude geralmente gera automaticamente código bem formatado, e esse gancho lida com os últimos 10% do código para evitar mau formato posteriormente no 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 --perigosamente-pular-permissões. Em vez disso, ele pré-aprova alguns comandos de segurança comumente usados com o comando /permissions para evitar que a caixa de confirmação apareça toda vez. Essas configurações são salvas em .claude/settings.json e compartilhadas pela equipe. Ainda mais poderosa é a integração com servidores MCP. MCP, abreviação de Model Context Protocol, é um protocolo padrão lançado pela Anthropic que permite que a IA se conecte a ferramentas externas. Com MCP, o Claude Code pode diretamente: - Buscar e enviar mensagens no Slack - Executar consultas BigQuery para responder perguntas de dados - Puxar o log de erros do Sentry A equipe do Boris também enviou a configuração MCP do Slack para o repositório, e todos a usaram logo de saída. Isso significa que o Claude Code não é apenas uma ferramenta de programação, mas um "assistente tudo-em-um" que pode acionar toda a sua cadeia de ferramentas. [8] Processamento de tarefas longas: Deixe Claude verificar ele mesmo Para missões de longa duração, Boris tem várias estratégias: A primeira é permitir que Claude use automaticamente o agente em segundo plano para verificar os resultados após a conclusão. Você pode solicitar isso no prompt, ou usar um Gancho de Parada para acionar de forma mais determinista. > Nota: Ganchos são o mecanismo de "gancho" do Claude Code que permite inserir lógica personalizada em momentos específicos em que Claude está realizando uma ação. Você pode pensar nisso como um "gatilho": quando um evento ocorre, execute automaticamente seu comando ou script predefinido. > Stop Hook é quando Claude responde e está pronto para entregar o controle. > Documentação Relacionada: A segunda é usar o plugin ralph-wiggum, que é essencialmente um loop Bash": imagine um loop morto simples (embora verdadeiro) que continua alimentando a mesma instrução de tarefa (arquivo de prompt) para o agente de IA, fazendo com que ele melhore seu trabalho repetidas vezes até que esteja completamente concluído. A terceira é usar --permission-mode=dontAsk ou --dangerously-skip-permissions no ambiente sandbox, para que Claude não seja interrompido pela confirmação de permissão e corra até o final sozinho. A ideia central é: como é uma tarefa longa, não deixe esperar por você. Dê autonomia e capacidade de autocorreção suficientes. [9] A mais importante: dar ao Claude capacidades de validação Boris coloca este no final, dizendo que provavelmente esse é o fator mais importante para obter um bom resultado. Se Claude conseguir validar seu trabalho, a qualidade final da saída pode ser aumentada de 2 a 3 vezes. Ele deu um exemplo: para cada alteração que eles submetem, Claude testará a si mesmo com extensões do Chrome: abra o navegador, teste a interface e itere quando encontrar um problema até que funcione corretamente e a experiência seja razoável. Os métodos de verificação variam dependendo do cenário. Pode ser rodar um comando bash, executar um conjunto de testes ou testar um aplicativo em um navegador ou emulador de celular. A forma não é importante, mas o importante é: deixe a IA ter um ciclo de feedback. Essa verdade é muito simples. Engenheiros humanos também dependem do ciclo de "escrever código, testar, ver resultados, modificação" para garantir qualidade. O mesmo vale para a IA. Se só puder ser escrito e não medido, é como fazer as coisas de olhos fechados, e a qualidade depende da sorte. A sugestão de Boris é investir na solidificação do mecanismo de verificação. Esse é o maior retorno sobre o investimento. [10] Mestres usam espadas para vencer sem movimentos Nos romances de artes marciais, mestres não têm tantos recursos com espadas, e não há movimentos para vencer. Boris não exibe configurações personalizadas complexas, não tem prompts privados misteriosos e usa funções oficiais. A diferença é que ele realmente entende a lógica por trás dessas funcionalidades e as combina em um fluxo de trabalho eficiente. O trabalho paralelo é feito porque Claude pode executar de forma autônoma; O Opus é usado por causa da maior eficiência geral; É transformar a correção de erros em ativos; O modo Plano é pensar claramente antes de fazer isso; comandos de barra e subagentes são trabalho repetitivo automatizado; O mecanismo de verificação é dar feedback à IA um ciclo fechado. Se você está começando com o Claude Code, não precisa se apressar em configurações avançadas. Faça bom uso do básico primeiro: aprenda a trabalhar em paralelo, aprenda a planejar e aprenda a acumular métodos de verificação por IA. Quando você realmente encontra um gargalo, ainda não é tarde para jogar essas flores fora.

Uma coisa que o Boris não mencionou é o fluxo básico de CI/revisão de código, que pode ser normal para suas grandes empresas e deveria existir por padrão Por exemplo, quando ele completa uma tarefa com o Claude Code, ele não diz para mesclar diretamente para o ramo principal, mas envia um PR. Após enviar um PR, todos os testes de lint e automatizados serão executados automaticamente no servidor CI, e se o teste falhar, o PR não poderá ser mesclado. Um PR passa em todos os testes automatizados e precisa de alguém para fazer uma revisão de código (claro, a ajuda de IA é possível, mas ainda precisa ser confirmada), e se a revisão de código encontrar problemas, precisa ser revisada. Para muitos desenvolvedores individuais, eles não estão acostumados a construir um fluxo de trabalho de CI/revisão de código, e nem sequer gerenciam Git code, então não podem reverter se algo der errado.

[10] Aquelas coisas que você não consegue ver Uma coisa que o Boris não mencionou é o fluxo básico de controle de versão/CI/revisão de código, que pode ser normal para suas grandes empresas e deveria estar lá por padrão Por exemplo, quando ele completa uma tarefa com o Claude Code, ele não diz para mesclar diretamente para o ramo principal, mas envia um PR. Após enviar um PR, todos os testes de lint e automatizados serão executados automaticamente no servidor CI, e se o teste falhar, o PR não poderá ser mesclado. Um PR passa em todos os testes automatizados e precisa de alguém para fazer uma revisão de código (claro, a ajuda de IA é possível, mas ainda precisa ser confirmada), e se a revisão de código encontrar problemas, precisa ser revisada. Esses também são a base para a capacidade deles de fazer multitarefa em paralelo, e sem esses fluxos de trabalho básicos, eles não podem fazer multitarefa em paralelo. Para muitos desenvolvedores individuais, eles não estão acostumados a construir um fluxo de trabalho de CI/revisão de código, e nem sequer gerenciam Git code, então não podem reverter se algo der errado.