Este artigo reúne 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 forma 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:
A maioria dos comandos mostrados aqui é fornecida com Claude Code: /color e /btw são comandos integrados, e /simplify e /loop são habilidades agrupadas que acompanham a CLI. Veja a referência de comandos e habilidades. Você pode criar suas próprias habilidades adicionando um arquivo SKILL.md em .claude/skills/<name>/.
O plugin iMessage é fornecido no marketplace oficial claude-plugins-official. Plugins da comunidade (por exemplo, o plugin "ralph-wiggum") 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 subagentes, |
Planejamento Antes de Construir | Modo de planejamento, escolha de modelo, níveis de esforço |
Prompting Efetivo | Prompts de resistência, |
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, Habilidades e Subagentes | 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 "análise" dedicada apenas para ler logs e executar consultas.
Subagentes com isolamento de worktree
Subagentes 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 de uma só vez. 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 dirigi-lo menos e é melhor no uso de ferramentas, quase sempre é mais rápido do que usar um modelo menor no final."
A matemática: menos direcionamento + 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 níveis disponíveis são low (menos tokens, mais rápido), medium, high (mais tokens, mais inteligência), max e auto (Claude escolhe por solicitação). O padrão é high em Team, Enterprise e acesso direto à API, e medium em outros planos. 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-app, depois marque @claude nos 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.
Memória automática
Execute /memory para configurar o sistema de memória integrado do Claude Code.
Auto-memory salva automaticamente preferências, correções e padrões entre sessões. As memórias são escritas em ~/.claude/projects/<project>/memory/ (um diretório por raiz de repositório git). Isto é separado dos seus arquivos ~/.claude/CLAUDE.md no nível do usuário e ./CLAUDE.md no nível do projeto, que você mantém manualmente.
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 o resultado esteja correto.
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 bom.
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 em CLI ou VS Code usando a extensão Chrome, ou simplesmente usar o aplicativo Desktop diretamente.
/simplificar para Qualidade de Código
Adicione /simplify a qualquer prompt após fazer alterações. 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, habilidades e suagentes
Habilidades para fluxos de trabalho repetidos
Se você faz algo mais de uma vez por dia, transforme em uma habilidade. As habilidades são verificadas em .claude/skills/<name>/SKILL.md e compartilhadas com o time (o caminho legado .claude/commands/ ainda funciona, mas habilidades são a abordagem recomendada). Algumas ideias:
Um comando
/techdebtque executa 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 engenheiro de análise 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 extras de modelo.
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ê deseja que Claude aplique 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 um time 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. O time da Anthropic construiu isso para si mesmo primeiro; a saída de código por engenheiro aumentou significativamente e as revisões eram o gargalo.
Hooks
Hooks permitem que você execute lógica deterministicamente 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 no .claude/settings.json do seu time. 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, sandbox 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; uma vez ativado, Shift+Tab alterna default → acceptEdits → plan → auto durante uma sessão. Sem esse sinalizador, o ciclo é default → acceptEdits → plan.
Sandbox
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 de execução muito longa, certifique-se de que Claude possa trabalhar sem interrupções. Abordagens recomendadas:
Solicite a 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
Nota: Experimente transformar seus fluxos de trabalho mais comuns em uma skill + 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 Pro, Max, Team e Enterprise na CLI v2.1.51+.
Você também pode ativar "Ativar Controle Remoto para todas as sessões" 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. Adicione servidores MCP via claude mcp add ou o bloco "mcpServers" em settings.json — veja code.claude.com/docs/en/mcp para configuração.
Dados e análises
Peça a Claude para usar a CLI bq para extrair e analisar métricas em tempo real—mantenha uma skill 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 em Claude e apenas diga "corrigir"—zero troca de contexto. Ou diga "vá corrigir os testes de CI falhando" sem microgerenciar como. Aponte Claude para docker logs para solucionar problemas de sistemas distribuídos—é surpreendentemente capaz nisso.
Plugins
Plugins agrupam LSPs (disponíveis para todas as linguagens principais), MCPs, skills, 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 de terminal
Execute /config para definir modo claro/escuro e /terminal-setup para ativar Shift+Enter para novas linhas em terminais IDE, Warp ou Alacritty (Apple Terminal não é suportado por /terminal-setup). Para keybindings Vim, abra /config → Editor mode. A equipe recomenda Ghostty para renderização sincronizada e cor de 24 bits.
Linha de status, cor e keybindings
/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 segure a barra de espaçoDesktop: 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 de Claude.
Verbos de spinner
São os pequenos detalhes que fazem Claude Code parecer pessoal. Peça a 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ê personalizar, 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.
SDK e trabalho com 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 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 a partir da 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.
