Ir para conteúdo principal

Dicas de usuário avançado do Claude Code

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, /batch

Planejamento Antes de Construir

Modo de planejamento, escolha de modelo, níveis de esforço

Prompting Efetivo

Prompts de resistência, /btw

Aprendendo com Claude

Saída explicativa, diagramas, repetição espaçada

CLAUDE.md e Memória

/init, @claude em PRs, memória automática, sonho automático

Verificação

Extensão do Chrome, aplicativo Desktop, /simplify

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

/loop, /schedule

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

--bare, --add-dir, forking, scripts de configuração


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 (ou claude --worktree my_worktree) para iniciar uma sessão em uma worktree isolada. Adicione --tmux para 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 WorktreeCreate e WorktreeRemove em seu settings.json para 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 main e 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 /config para 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 /techdebt que 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

SessionStart

Carregue dinamicamente o contexto cada vez que você inicia Claude

PreToolUse

Registre cada comando bash que o modelo executa

PostToolUse

Formate automaticamente o código após Write/Edit para evitar falhas de CI

PermissionRequest

Encaminhe prompts de permissão para Slack, WhatsApp ou Opus para revisão

Stop

Execute verificações determinísticas em tarefas longas ou incentive Claude a continuar

PostCompact

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 Stop de 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 /teleport dentro de uma sessão) continua uma sessão em nuvem em sua máquina.

  • /remote-control permite que você controle uma sessão local a partir do seu telefone ou da web.

  • claude remote-control permite 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

  • /statusline gera uma linha de status personalizada com base em seu .bashrc/.zshrc—mostre modelo, diretório, contexto restante, custo ou qualquer outra coisa.

  • /color altera a cor de entrada do prompt—útil quando você tem 3–5 sessões abertas e precisa diferenciá-las à primeira vista.

  • /keybindings remapeia 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 /voice e segure a barra de espaço

  • Desktop: 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

claude --worktree, /batch, isolation: worktree

Planejamento

Shift+Tab, /effort max, claude --name

Memória

CLAUDE.md, /memory, /dream, @claude em PRs

Verificação

Extensão Chrome, /simplify, Aplicativo Desktop

Automação

.claude/skills/, .claude/agents/, --agent

Hooks

PostToolUse, Stop, PostCompact, PermissionRequest

Permissões

/permissions, modo automático, /sandbox

Agendamento

/loop, /schedule

Remoto

--teleport, /remote-control, aplicativo móvel, iMessage

Personalização

/statusline, /color, /voice, /keybindings, /config

SDK e múltiplos repositórios

--bare, --add-dir, /branch


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.

Isto respondeu à sua pergunta?