Este artigo coleta dicas de fluxo de trabalho da equipe Claude Code da Anthropic. Essas práticas cobrem execução paralela, planejamento, automação, verificação e personalização—os padrões que a equipe usa diariamente para entregar código mais rapidamente. A configuração de cada um é diferente, então experimente para ver o que funciona para você.
Importante: A dica mais impactante neste guia é verificação—dar ao Claude uma maneira de verificar sua própria saída. Se você adotar apenas uma prática, que seja essa. Veja a seção Verificação abaixo.
Antes de começar: escopo deste guia
Estes são padrões de usuário avançado coletados de engenheiros individuais da equipe Claude Code. Como resultado:
Vários comandos mostrados aqui (por exemplo
/loop,/dream,/simplify,/btw,/color,/babysit) são comandos de barra invertida personalizados ou habilidades pessoais que esses engenheiros criaram para si mesmos—eles não são integrados. Você pode recriar qualquer um deles colocando um arquivo markdown em.claude/commands/; veja Comandos de barra invertida.Os plugins referenciados (por exemplo, o plugin iMessage ou o plugin "ralph-wiggum") vêm do marketplace da comunidade e não são revisados ou sancionados pela Anthropic. Verifique com seu administrador antes de instalar plugins de terceiros em um ambiente gerenciado.
Alguns recursos—modo automático, sandbox, controle remoto, trabalhos em nuvem agendados, voz—estão desativados por padrão e podem ser desabilitados pela política da sua organização. Se um comando ou sinalizador aqui retornar "não disponível," seu administrador provavelmente não o habilitou para seu workspace.
Tudo mais neste guia funciona em uma instalação padrão do Claude Code. Em caso de dúvida, execute /help para ver o que está realmente disponível em sua sessão.
Conteúdo
Seção | Abrange |
Trabalhando em Paralelo | Worktrees, isolamento de subagentos, |
Planejamento Antes de Construir | Modo de planejamento, escolha de modelo, níveis de esforço |
Prompting Efetivo | Prompts de objeção, |
Aprendendo com Claude | Saída explicativa, diagramas, repetição espaçada |
CLAUDE.md e Memória |
|
Verificação | Extensão do Chrome, aplicativo Desktop, |
Comandos de Barra Invertida, Habilidades e Subagentos | Comandos personalizados, definições de agentes, agentes de revisão de código |
Hooks | Eventos de ciclo de vida e padrões |
Permissões e Segurança | Pré-aprovações, modo automático, sandbox, tarefas de longa duração |
Tarefas Agendadas e Recorrentes |
|
Móvel e Controle Remoto | Aplicativo móvel, teleporte, controle remoto, Dispatch |
Integrações de Ferramentas (MCP) | Análise de dados, correção de bugs, plugins |
Personalizando Seu Ambiente | Terminal, linha de status, voz, estilos de saída |
SDK e Trabalho com Múltiplos Repositórios |
|
Trabalhando em paralelo
Execute várias sessões simultaneamente
O maior desbloqueio de produtividade é executar 3–5 sessões do Claude em paralelo, cada uma em sua própria worktree git. Claude Code tem suporte nativo a worktree integrado.
Na CLI, execute
claude --worktree(ouclaude --worktree my_worktree) para iniciar uma sessão em uma worktree isolada. Adicione--tmuxpara iniciar em sua própria sessão Tmux.No aplicativo Desktop, abra a aba Code e marque a caixa de seleção worktree.
Para VCS não-git (Mercurial, Perforce, SVN), defina os hooks
WorktreeCreateeWorktreeRemoveem seusettings.jsonpara obter o mesmo isolamento.
Para se manter orientado em muitas sessões, nomeie suas worktrees, configure aliases de shell (za, zb, zc) para pular entre elas, codifique por cores suas abas de terminal e ative notificações de terminal para saber quando qualquer Claude precisa de sua atenção. Muitos engenheiros mantêm uma worktree dedicada de "análise" apenas para ler logs e executar consultas.
Subagentos com isolamento de worktree
Subagentos também podem ser executados em worktrees isoladas, o que é especialmente poderoso para grandes mudanças em lote. Adicione isolation: worktree ao frontmatter do seu agente:
# .claude/agents/worktree-worker.md
---
name: worktree-worker
model: haiku
isolation: worktree
---
Depois solicite naturalmente: "Migre toda a IO síncrona para assíncrona. Agrupe as alterações e inicie 10 agentes paralelos com isolamento de worktree. Cada agente deve testar suas alterações de ponta a ponta e depois abrir um PR."
/batch para migrações em larga escala
O comando /batch o entrevista sobre uma migração e depois distribui o trabalho para quantos agentes worktree forem necessários — dezenas, centenas ou mais. Cada agente trabalha isoladamente, testa suas próprias alterações e cria um PR independentemente.
> /batch migrate src/ from Solid to React
Planejamento antes da construção
Inicie tarefas complexas no modo de plano
Pressione Shift+Tab para alternar para o modo de plano. Dedique seu esforço ao plano para que Claude possa implementar em uma única tentativa. O fluxo típico é: entrar no modo de plano → refinar o plano → alternar para aceitar edições automaticamente → Claude executa.
Alguns padrões da equipe:
Tenha um Claude escrevendo um plano e depois inicie um segundo Claude para revisá-lo como um engenheiro sênior.
No momento em que algo der errado, volte para o modo de plano e replaneie em vez de fazer correções de curso no meio do caminho.
Após o modo de plano, Claude nomeia automaticamente sua sessão com base no que você está trabalhando — você também pode definir um nome antecipadamente com
claude --name "auth-refactor".
Use Opus com pensamento para tudo
Raciocínio da equipe Claude Code: "É o melhor modelo de codificação que já usei, e embora seja maior e mais lento que Sonnet, como você precisa orientá-lo menos e ele é melhor no uso de ferramentas, quase sempre é mais rápido do que usar um modelo menor no final."
A matemática: menos orientação + melhor uso de ferramentas = resultados gerais mais rápidos, mesmo com um modelo maior.
Nível de esforço
Execute /effort para escolher seu nível de esforço. Os quatro níveis são low (menos tokens, mais rápido), medium (padrão), high (mais tokens, mais inteligência) e max. A equipe Claude Code usa high para tudo; alterne para /effort max para depuração difícil ou decisões de arquitetura onde você quer que Claude raciocine pelo tempo que precisar. Max consome limites de uso mais rapidamente, então ative-o por sessão.
Solicitações eficazes
Não aceite a primeira solução — pressione Claude para fazer melhor. Algumas solicitações que funcionam bem:
"Questione-me sobre essas alterações e não abra um PR até eu passar no seu teste." Força Claude a validar seu entendimento antes de enviar.
"Prove para mim que isso funciona." Peça a Claude para fazer diff do comportamento entre
maine sua branch de recurso."Sabendo tudo o que você sabe agora, descarte isso e implemente a solução elegante." Útil após uma primeira tentativa medíocre.
Escreva especificações detalhadas para reduzir ambiguidade antes de delegar o trabalho. Quanto mais específico você for, melhor será o resultado.
/btw para perguntas secundárias
Enquanto Claude está trabalhando ativamente, use /btw para fazer uma pergunta rápida sem interrompê-lo. É de uma única volta sem chamadas de ferramentas, mas tem contexto completo da conversa.
> /btw what does the retry logic do?
Aprendendo com Claude
Claude Code não é apenas para escrever código — é uma ferramenta de aprendizado poderosa quando você a configura para explicar e ensinar.
Ative o estilo de saída "Explanatory" ou "Learning" em
/configpara que Claude explique o porquê por trás das alterações.Gere apresentações HTML visuais explicando código desconhecido.
Peça diagramas ASCII de novos protocolos e bases de código.
Construa uma habilidade de repetição espaçada: explique seu entendimento, Claude faz perguntas de acompanhamento para preencher lacunas.
CLAUDE.md e memória
Invista em seu CLAUDE.md
Compartilhe um único arquivo CLAUDE.md na raiz do seu repositório, verificado no git, com toda a equipe contribuindo. A prática-chave: sempre que Claude fizer algo incorretamente, adicione ao CLAUDE.md para que ele saiba não repetir o erro.
Após cada correção, termine com: "Atualize seu CLAUDE.md para não cometer esse erro novamente." Claude é muito bom em escrever regras para si mesmo.
@claude em Revisões de Código
Instale a GitHub Action com /install-github-action, depois marque @claude em comentários de PR para adicionar aprendizados ao CLAUDE.md como parte da revisão:
nit: use a string literal, not ts enum @claude add to CLAUDE.md to never use enums, always prefer literal unions
Isto é "Engenharia Composta" — cada correção torna cada sessão futura melhor.
Auto-memória e auto-sonho
Execute /memory para configurar o sistema de memória integrado do Claude Code.
Auto-memória salva automaticamente preferências, correções e padrões entre sessões. A memória do usuário vai para
~/.claude/CLAUDE.md, a memória do projeto para./CLAUDE.md.Auto-sonho executa um subagenteque periodicamente revisa sessões passadas — conforme a memória se acumula, pode ficar confusa com suposições desatualizadas, notas sobrepostas e entradas de baixo sinal. Auto-sonho mantém o que importa, remove o que não importa e mescla insights em memória estruturada mais limpa. Execute
/dreampara acioná-lo manualmente, ou ative-o nas configurações/memory.
A nomenclatura mapeia como o sono REM consolida a memória de curto prazo em armazenamento de longo prazo.
Avançado: Diretório de notas
Um engenheiro da equipe diz a Claude para manter um diretório de notas para cada tarefa e projeto, atualizado após cada PR — depois aponta CLAUDE.md para ele.
Verificação — a Dica #1
Dar a Claude uma maneira de verificar seu trabalho melhorará marcadamente a qualidade do resultado final. Se Claude puder fechar o loop de feedback por conta própria, ele iterará até que a saída esteja correta.
A verificação parece diferente por domínio — comandos bash, suites de teste, simuladores, testes de navegador — mas o princípio é o mesmo. Invista em verificação específica do domínio.
A extensão do Chrome
Para trabalho frontend, instale a extensão Claude Code Chrome. Pense nela como em qualquer outro engenheiro: se você pedir a alguém para construir um site mas não deixar usar um navegador, ficará bom? Provavelmente não. Com um navegador, ele iterará até ficar.
A equipe usa a extensão do Chrome toda vez que trabalha em código web. Baixe-a para Chrome ou Edge em code.claude.com/docs/en/chrome.
Aplicativo desktop para servidores web
O aplicativo Claude Desktop agrupa a capacidade de iniciar e testar automaticamente servidores web em um navegador integrado. Você pode configurar algo semelhante na CLI ou VS Code usando a extensão Chrome, ou simplesmente usar o aplicativo Desktop diretamente.
/simplify para Qualidade de Código
Adicione /simplify a qualquer prompt após fazer alterações. Ele executa agentes paralelos que revisam o código alterado para reutilização, qualidade, eficiência e conformidade com CLAUDE.md—tudo em uma única passagem.
> hey claude make this code change then run /simplify
Comandos de barra, habilidades e suagentes
Habilidades para fluxos de trabalho repetidos
Se você faz algo mais de uma vez por dia, transforme em uma habilidade ou comando. As habilidades são verificadas em .claude/commands/ e compartilhadas com a equipe. Algumas ideias:
Um comando
/techdebtque é executado ao final de cada sessão para encontrar código duplicado.Um comando que sincroniza 7 dias de Slack, GDrive, Asana e GitHub em um único despejo de contexto.
Agentes de engenharia analítica que escrevem modelos dbt, revisam código e testam em dev.
Comandos de barra podem incluir Bash inline para pré-computar informações (como git status) sem chamadas de modelo extras.
Suagentes para fluxos de trabalho de PR
Pense em suagentes como automações para seus fluxos de trabalho de PR mais comuns. Coloque arquivos .md em .claude/agents/:
.claude/agents/ build-validator.md code-architect.md code-simplifier.md verify-app.md
Cada agente pode ter um nome personalizado, cor, conjunto de ferramentas, ferramentas permitidas/não permitidas, modo de permissão e modelo. Defina o agente padrão para sua conversa principal adicionando "agent" a settings.json ou usando claude --agent <name>. Execute /agents para começar.
--agent para prompts de sistema personalizados
Agentes personalizados são uma primitiva poderosa que frequentemente é negligenciada. Defina um novo agente em .claude/agents, depois execute claude --agent=<name>. Exemplo de um agente somente leitura:
# .claude/agents/ReadOnly.md --- name: ReadOnly description: Read-only agent restricted to the Read tool only color: blue tools: Read --- You are a read-only agent that cannot edit files or run bash.
Aproveitando suagentes em tempo de execução
Adicione "use subagents" a qualquer solicitação onde você queira que Claude dedique mais computação ao problema.
Delegue tarefas individuais a suagentes para manter a janela de contexto do seu agente principal limpa e focada.
Encaminhe solicitações de permissão para Opus via um hook — deixe-o verificar ataques e aprovar automaticamente os seguros.
Agentes de revisão de código
Quando um PR é aberto, Claude pode distribuir uma equipe de agentes que cada um se concentra em uma preocupação diferente — erros de lógica, problemas de segurança, regressões de desempenho — e postar comentários inline. A equipe Anthropic construiu isso para si mesma primeiro; a saída de código por engenheiro aumentou significativamente e as revisões eram o gargalo.
Hooks
Hooks permitem que você execute deterministicamente a lógica em pontos do ciclo de vida do agente. Peça ao Claude para adicionar um hook para começar.
Padrões de hook comuns
Evento | Caso de uso |
| Carregue dinamicamente o contexto cada vez que você inicia Claude |
| Registre cada comando bash que o modelo executa |
| Formate automaticamente o código após Write/Edit para evitar falhas de CI |
| Encaminhe prompts de permissão para Slack, WhatsApp ou Opus para revisão |
| Execute verificações determinísticas em tarefas longas, ou incentive Claude a continuar |
| Reinjetar instruções críticas após compressão de contexto |
Exemplo de hook PostToolUse para formatação automática:
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [{ "type": "command", "command": "bun run format || true" }]
}
]
Permissões e segurança
Pré-aprove comandos comuns
Execute /permissions para pré-permitir comandos seguros comuns e verificá-los em .claude/settings.json da sua equipe. Esta é a alternativa recomendada para pular permissões inteiramente — você recebe menos prompts enquanto mantém uma lista de permissões auditável. A sintaxe de curinga completa é suportada—tente "Bash(bun run *)" ou "Edit(/docs/**)".
O sistema de permissões do Claude Code agrupa detecção de injeção de prompt, análise estática, sandboxing e supervisão humana. Um pequeno conjunto de comandos seguros é pré-aprovado fora da caixa; tudo que você adiciona via /permissions é aditivo a essa linha de base.
Modo automático
O modo automático permite que Claude tome decisões de permissão em seu nome. Classificadores avaliam cada ação antes de ser executada—operações seguras são auto-aprovadas, as arriscadas ainda são sinalizadas. Ative com claude --enable-auto-mode, ou alterne para ele com Shift+Tab durante uma sessão (modo plano → modo automático → modo normal).
Sandboxing
Execute /sandbox para optar pelo tempo de execução de sandbox de código aberto do Claude Code. Ele é executado em sua máquina e suporta isolamento de arquivo e rede, melhorando a segurança enquanto reduz prompts de permissão. Três modos estão disponíveis:
Sandbox BashTool, com auto-allow
Sandbox BashTool, com permissões regulares
Sem sandbox
Tarefas de longa duração
Para tarefas muito longas, garanta que Claude possa trabalhar sem interrupções. Abordagens recomendadas:
Solicite ao Claude que verifique com um agente de fundo quando terminar.
Use um hook
Stopde agente para verificações determinísticas (preferido para fluxos de trabalho auditáveis).Use o plugin da comunidade "ralph-wiggum".
Para ambientes em sandbox, use --permission-mode=dontAsk ou --dangerously-skip-permissions para evitar bloqueios.
Tarefas agendadas e recorrentes
/loop para tarefas recorrentes locais
/loop agenda uma tarefa recorrente localmente por até 3 dias de cada vez. Alguns exemplos que a equipe Claude Code executa:
/loop 5m /babysit # auto-address review, rebase, shepherd PRs /loop 30m /slack-feedback # auto put up PRs for Slack feedback /loop 1h /pr-pruner # close out stale PRs
/schedule para Cloud Jobs
Diferentemente de /loop, os trabalhos agendados são executados na nuvem — continuam funcionando mesmo quando seu laptop está fechado.
> /schedule a daily job that looks at all PRs shipped since yesterday and updates our docs based on the changes. Use the Slack MCP to message #docs-update with the changes
Observação: Experimente transformar seus fluxos de trabalho mais comuns em uma habilidade + um loop. É poderoso.
Controle móvel e remoto
Trabalhe a partir do seu telefone
Claude Code tem um aplicativo móvel—baixe o aplicativo Claude para iOS/Android e toque na aba Code. Um plugin iMessage também está disponível (/plugin install imessage@claude-plugins-official) para enviar tarefas de qualquer dispositivo Apple.
Teleporte sessões entre dispositivos
Mova sessões para frente e para trás entre dispositivos móveis, web, desktop e terminal:
claude --teleport(ou/teleportdentro de uma sessão) continua uma sessão em nuvem em sua máquina./remote-controlpermite que você controle uma sessão local a partir do seu telefone ou da web.claude remote-controlpermite que você inicie uma nova sessão local a partir do aplicativo móvel. Disponibilidade: Planos Max, Team e Enterprise na v2.1.74+.
Você também pode ativar "Enable Remote Control for all sessions" em /config.
Claude Cowork Dispatch
Dispatch é um controle remoto seguro para o aplicativo Claude Desktop. Pode usar seus MCPs, navegador e computador com sua permissão—útil para se atualizar no Slack e emails, gerenciar arquivos e fazer coisas em seu laptop quando você está longe.
Integrações de ferramentas (MCP)
Conecte Claude às suas ferramentas existentes para que possa pesquisar Slack, executar BigQuery, obter logs do Sentry e muito mais.
{
"mcpServers": {
"slack": {
"type": "http",
"url": "https://slack.mcp.anthropic.com/mcp"
}
}
}
Dados e análises
Peça ao Claude para usar a CLI bq para extrair e analisar métricas em tempo real—mantenha uma habilidade BigQuery verificada em seu repositório de código. A opinião da equipe Claude Code: "Pessoalmente, não escrevi uma linha de SQL em 6+ meses." Isso funciona para qualquer banco de dados que tenha uma CLI, MCP ou API.
Correção de bugs
Ative o MCP do Slack, cole um thread de bug no Claude e apenas diga "fix"—sem troca de contexto. Ou diga "go fix the failing CI tests" sem microgerenciar como. Aponte Claude para docker logs para solucionar problemas em sistemas distribuídos—é surpreendentemente capaz nisso.
Plugins
Plugins agrupam LSPs (disponíveis para todas as linguagens principais), MCPs, habilidades, agentes e hooks personalizados. Instale do marketplace oficial de plugins da Anthropic ou configure um marketplace interno para sua organização—depois verifique a referência do marketplace em settings.json para que seja adicionado automaticamente para cada desenvolvedor. Execute /plugin para começar.
Personalizando seu ambiente
Configuração do terminal
Execute /config para definir modo claro/escuro e /terminal-setup para ativar Shift+Enter para novas linhas em terminais IDE, Apple Terminal, Warp ou Alacritty. Execute /vim para modo Vim. A equipe recomenda Ghostty para renderização sincronizada e cor de 24 bits.
Linha de status, cor e atalhos de teclado
/statuslinegera uma linha de status personalizada com base em seu.bashrc/.zshrc—mostre modelo, diretório, contexto restante, custo ou qualquer outra coisa./coloraltera a cor de entrada do prompt—útil quando você tem 3–5 sessões abertas e precisa diferenciá-las à primeira vista./keybindingsremapeia qualquer tecla. As configurações são recarregadas em tempo real e armazenadas em~/.claude/keybindings.json.
Entrada de voz
O modo de voz está disponível para todos os usuários, incluindo Claude Code Desktop e Cowork. A maioria da codificação da equipe Claude Code é feita falando—você fala aproximadamente 3× mais rápido do que digita, e seus prompts ficam mais detalhados como resultado.
CLI: execute
/voicee mantenha a barra de espaço pressionadaDesktop: pressione o botão de voz (ícone de microfone)
iOS: ative ditado nas configurações do seu sistema
macOS nativo: pressione fn×2 para ditado do sistema em qualquer terminal
Sessões web
Além do terminal, execute sessões adicionais em claude.ai/code. Use o comando & para colocar uma sessão em segundo plano ou o sinalizador --teleport para alternar contextos entre local e web.
Estilos de saída
Execute /config e defina um estilo de saída. Explanatory faz Claude explicar frameworks e padrões enquanto trabalha (ótimo para novos repositórios de código). Learning faz Claude orientá-lo através das mudanças. Você também pode criar estilos personalizados para ajustar a voz do Claude.
Verbos de spinner
São os pequenos detalhes que fazem Claude Code parecer pessoal. Peça ao Claude para personalizar seus verbos de spinner para adicionar ou substituir a lista padrão. Verifique o settings.json no controle de origem para compartilhar verbos com sua equipe.
Personalize tudo
Claude Code é construído para funcionar perfeitamente pronto para uso, mas quando você personaliza, verifique settings.json no git para que sua equipe também se beneficie. A configuração é suportada por base de código, por subpasta, por usuário ou por meio de políticas em toda a empresa.
Pelos números: dezenas de configurações e variáveis de ambiente—veja a referência de configurações. Use o campo "env" em settings.json para evitar scripts de wrapper.
Trabalho com SDK e múltiplos repositórios
--bare para inicialização mais rápida do SDK
Por padrão, claude -p (e os SDKs TypeScript/Python) procura por arquivos CLAUDE.md locais, configurações e MCPs. Para uso não interativo, você geralmente deseja especificar estes explicitamente via --system-prompt, --mcp-config, --settings, etc. Adicione --bare para uma inicialização aproximadamente 10× mais rápida:
claude -p "summarize this codebase" \
--output-format=stream-json \
--verbose \
--bare
Nota: Este foi um erro de design quando o SDK foi construído pela primeira vez. Em uma versão futura, o padrão mudará para --bare. Por enquanto, ative com a flag.
--add-dir para trabalho com múltiplos repositórios
Ao trabalhar em repositórios, use --add-dir (ou /add-dir) para dar ao Claude acesso e permissões para pastas adicionais. Ou adicione "additionalDirectories" ao settings.json da sua equipe para sempre incluí-las.
Bifurcando uma sessão
Para ramificar uma sessão existente, execute /branch dentro dela, ou claude --resume <session-id> --fork-session na CLI.
Scripts de configuração para ambientes em nuvem
No Claude Code na web e desktop, adicione um script de configuração que é executado antes de cada nova sessão em nuvem—instale dependências, configure configurações, defina variáveis de ambiente. O script é ignorado ao retomar.
Apêndice: Referência rápida
Área | Comandos principais |
Trabalho paralelo |
|
Planejamento | Shift+Tab, |
Memória |
|
Verificação | Extensão Chrome, |
Automação |
|
Hooks |
|
Permissões |
|
Agendamento |
|
Remoto |
|
Personalização |
|
SDK e múltiplos repositórios |
|
Apêndice: Artigos relacionados
Recurso | Link |
Referência de hooks | |
Subagentos e agentes personalizados | |
Tarefas agendadas | |
Extensão Chrome |
Claude Code é lançado frequentemente. Verifique detalhes específicos da versão em code.claude.com/docs antes de distribuir internamente.
