Pular para o conteúdo principal
Cada tarefa neste documento inclui instruções claras, comandos de exemplo e melhores práticas para ajudá-lo a aproveitar ao máximo o Claude Code.

​
Entender novas bases de código

​
Obter uma visão geral rápida da base de código

Suponha que você acabou de ingressar em um novo projeto e precisa entender sua estrutura rapidamente.
1

Navegue até o diretório raiz do projeto

cd /path/to/project
2

Inicie Claude Code

claude
3

Peça uma visão geral de alto nível

> give me an overview of this codebase
4

Aprofunde-se em componentes específicos

> explain the main architecture patterns used here 

> what are the key data models?

> how is authentication handled?
Dicas:
  • Comece com perguntas amplas e depois estreite para áreas específicas
  • Pergunte sobre convenções de codificação e padrões usados no projeto
  • Solicite um glossário de termos específicos do projeto

​
Encontrar código relevante

Suponha que você precise localizar código relacionado a um recurso ou funcionalidade específica.
1

Peça ao Claude para encontrar arquivos relevantes

> find the files that handle user authentication
2

Obtenha contexto sobre como os componentes interagem

> how do these authentication files work together?
3

Entenda o fluxo de execução

> trace the login process from front-end to database
Dicas:
  • Seja específico sobre o que você está procurando
  • Use linguagem de domínio do projeto

​
Corrigir bugs com eficiência

Suponha que você tenha encontrado uma mensagem de erro e precise encontrar e corrigir sua origem.
1

Compartilhe o erro com Claude

> I'm seeing an error when I run npm test
2

Peça recomendações de correção

> suggest a few ways to fix the @ts-ignore in user.ts
3

Aplique a correção

> update user.ts to add the null check you suggested
Dicas:
  • Diga ao Claude o comando para reproduzir o problema e obter um rastreamento de pilha
  • Mencione quaisquer etapas para reproduzir o erro
  • Deixe Claude saber se o erro é intermitente ou consistente

​
Refatorar código

Suponha que você precise atualizar código antigo para usar padrões e práticas modernas.
1

Identifique código legado para refatoração

> find deprecated API usage in our codebase
2

Obtenha recomendações de refatoração

> suggest how to refactor utils.js to use modern JavaScript features
3

Aplique as alterações com segurança

> refactor utils.js to use ES2024 features while maintaining the same behavior
4

Verifique a refatoração

> run tests for the refactored code
Dicas:
  • Peça ao Claude para explicar os benefícios da abordagem moderna
  • Solicite que as alterações mantenham compatibilidade com versões anteriores quando necessário
  • Faça refatoração em incrementos pequenos e testáveis

​
Usar subagentes especializados

Suponha que você queira usar subagentes de IA especializados para lidar com tarefas específicas de forma mais eficaz.
1

Visualize os subagentes disponíveis

> /agents
Isso mostra todos os subagentes disponíveis e permite que você crie novos.
2

Use subagentes automaticamente

Claude Code delegará automaticamente tarefas apropriadas para subagentes especializados:
> review my recent code changes for security issues

> run all tests and fix any failures
3

Solicite explicitamente subagentes específicos

> use the code-reviewer subagent to check the auth module

> have the debugger subagent investigate why users can't log in
4

Crie subagentes personalizados para seu fluxo de trabalho

> /agents
Em seguida, selecione “Create New subagent” e siga os prompts para definir:
  • Tipo de subagente (por exemplo, api-designer, performance-optimizer)
  • Quando usá-lo
  • Quais ferramentas ele pode acessar
  • Seu prompt de sistema especializado
Dicas:
  • Crie subagentes específicos do projeto em .claude/agents/ para compartilhamento em equipe
  • Use campos description descritivos para permitir delegação automática
  • Limite o acesso a ferramentas ao que cada subagente realmente precisa
  • Verifique a documentação de subagentes para exemplos detalhados

​
Usar Plan Mode para análise segura de código

Plan Mode instrui Claude a criar um plano analisando a base de código com operações somente leitura, perfeito para explorar bases de código, planejar alterações complexas ou revisar código com segurança.

​
Quando usar Plan Mode

  • Implementação em várias etapas: Quando seu recurso requer fazer edições em muitos arquivos
  • Exploração de código: Quando você quer pesquisar a base de código completamente antes de alterar qualquer coisa
  • Desenvolvimento interativo: Quando você quer iterar sobre a direção com Claude

​
Como usar Plan Mode

Ative Plan Mode durante uma sessão Você pode mudar para Plan Mode durante uma sessão usando Shift+Tab para alternar entre modos de permissão. Se você estiver em Normal Mode, Shift+Tab primeiro mudará para Auto-Accept Mode, indicado por ⏵⏵ accept edits on na parte inferior do terminal. Um Shift+Tab subsequente mudará para Plan Mode, indicado por ⏸ plan mode on. Inicie uma nova sessão em Plan Mode Para iniciar uma nova sessão em Plan Mode, use a flag --permission-mode plan: 
claude --permission-mode plan
Execute consultas “headless” em Plan Mode Você também pode executar uma consulta em Plan Mode diretamente com -p (ou seja, em “modo headless”): 
claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

​
Exemplo: Planejando uma refatoração complexa

claude --permission-mode plan

> I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
Claude analisará a implementação atual e criará um plano abrangente. Refine com acompanhamentos: 
> What about backward compatibility?
> How should we handle database migration?

​
Configure Plan Mode como padrão

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}
Veja documentação de configurações para mais opções de configuração.

​
Trabalhar com testes

Suponha que você precise adicionar testes para código não coberto.
1

Identifique código não testado

> find functions in NotificationsService.swift that are not covered by tests
2

Gere scaffolding de teste

> add tests for the notification service
3

Adicione casos de teste significativos

> add test cases for edge conditions in the notification service
4

Execute e verifique os testes

> run the new tests and fix any failures
Dicas:
  • Peça testes que cubram casos extremos e condições de erro
  • Solicite testes unitários e de integração quando apropriado
  • Peça ao Claude para explicar a estratégia de teste

​
Criar pull requests

Suponha que você precise criar um pull request bem documentado para suas alterações.
1

Resuma suas alterações

> summarize the changes I've made to the authentication module
2

Gere um PR com Claude

> create a pr
3

Revise e refine

> enhance the PR description with more context about the security improvements
4

Adicione detalhes de teste

> add information about how these changes were tested
Dicas:
  • Peça ao Claude diretamente para fazer um PR para você
  • Revise o PR gerado pelo Claude antes de enviar
  • Peça ao Claude para destacar riscos ou considerações potenciais

​
Lidar com documentação

Suponha que você precise adicionar ou atualizar documentação para seu código.
1

Identifique código não documentado

> find functions without proper JSDoc comments in the auth module
2

Gere documentação

> add JSDoc comments to the undocumented functions in auth.js
3

Revise e melhore

> improve the generated documentation with more context and examples
4

Verifique a documentação

> check if the documentation follows our project standards
Dicas:
  • Especifique o estilo de documentação que você deseja (JSDoc, docstrings, etc.)
  • Peça por exemplos na documentação
  • Solicite documentação para APIs públicas, interfaces e lógica complexa

​
Trabalhar com imagens

Suponha que você precise trabalhar com imagens em sua base de código e queira ajuda do Claude para analisar o conteúdo da imagem.
1

Adicione uma imagem à conversa

Você pode usar qualquer um destes métodos:
  1. Arraste e solte uma imagem na janela do Claude Code
  2. Copie uma imagem e cole-a no CLI com ctrl+v (Não use cmd+v)
  3. Forneça um caminho de imagem ao Claude. Por exemplo, “Analyze this image: /path/to/your/image.png”
2

Peça ao Claude para analisar a imagem

> What does this image show?

> Describe the UI elements in this screenshot

> Are there any problematic elements in this diagram?
3

Use imagens para contexto

> Here's a screenshot of the error. What's causing it?

> This is our current database schema. How should we modify it for the new feature?
4

Obtenha sugestões de código do conteúdo visual

> Generate CSS to match this design mockup

> What HTML structure would recreate this component?
Dicas:
  • Use imagens quando descrições de texto seriam pouco claras ou complicadas
  • Inclua capturas de tela de erros, designs de UI ou diagramas para melhor contexto
  • Você pode trabalhar com múltiplas imagens em uma conversa
  • A análise de imagem funciona com diagramas, capturas de tela, mockups e muito mais

​
Referenciar arquivos e diretórios

Use @ para incluir rapidamente arquivos ou diretórios sem esperar que Claude os leia.
1

Referencie um arquivo único

> Explain the logic in @src/utils/auth.js
Isso inclui o conteúdo completo do arquivo na conversa.
2

Referencie um diretório

> What's the structure of @src/components?
Isso fornece uma listagem de diretório com informações de arquivo.
3

Referencie recursos MCP

> Show me the data from @github:repos/owner/repo/issues
Isso busca dados de servidores MCP conectados usando o formato @server:resource. Veja recursos MCP para detalhes.
Dicas:
  • Caminhos de arquivo podem ser relativos ou absolutos
  • Referências de arquivo @ adicionam CLAUDE.md no diretório do arquivo e diretórios pai ao contexto
  • Referências de diretório mostram listagens de arquivo, não conteúdos
  • Você pode referenciar múltiplos arquivos em uma única mensagem (por exemplo, “@file1.js and @file2.js”)

​
Usar pensamento estendido

Suponha que você esteja trabalhando em decisões arquitetônicas complexas, bugs desafiadores ou planejando implementações em várias etapas que exigem raciocínio profundo.
Pensamento estendido é desabilitado por padrão em Claude Code. Você pode habilitá-lo sob demanda usando Tab para alternar Thinking, ou usando prompts como “think” ou “think hard”. Você também pode habilitá-lo permanentemente definindo a variável de ambiente MAX_THINKING_TOKENS em suas configurações.
1

Forneça contexto e peça ao Claude para pensar

> I need to implement a new authentication system using OAuth2 for our API. Think deeply about the best approach for implementing this in our codebase.
Claude reunirá informações relevantes de sua base de código e usará pensamento estendido, que será visível na interface.
2

Refine o pensamento com prompts de acompanhamento

> think about potential security vulnerabilities in this approach 

> think hard about edge cases we should handle
Dicas para obter o máximo valor do pensamento estendido:Pensamento estendido é mais valioso para tarefas complexas como:
  • Planejamento de mudanças arquitetônicas complexas
  • Depuração de problemas intrincados
  • Criação de planos de implementação para novos recursos
  • Compreensão de bases de código complexas
  • Avaliação de compensações entre diferentes abordagens
Use Tab para alternar Thinking ligado e desligado durante uma sessão.A forma como você solicita resultados de pensamento resulta em níveis variados de profundidade de pensamento:
  • “think” dispara pensamento estendido básico
  • frases intensificadoras como “keep hard”, “think more”, “think a lot” ou “think longer” disparam pensamento mais profundo
Para mais dicas de prompt de pensamento estendido, veja Dicas de pensamento estendido.
Claude exibirá seu processo de pensamento como texto cinza itálico acima da resposta.

​
Retomar conversas anteriores

Suponha que você tenha estado trabalhando em uma tarefa com Claude Code e precise continuar de onde parou em uma sessão posterior. Claude Code fornece duas opções para retomar conversas anteriores:
  • --continue para continuar automaticamente a conversa mais recente
  • --resume para exibir um seletor de conversa
1

Continue a conversa mais recente

claude --continue
Isso retoma imediatamente sua conversa mais recente sem nenhum prompt.
2

Continue em modo não interativo

claude --continue --print "Continue with my task"
Use --print com --continue para retomar a conversa mais recente em modo não interativo, perfeito para scripts ou automação.
3

Mostrar seletor de conversa

claude --resume
Isso exibe um seletor de conversa interativo com uma visualização de lista limpa mostrando:
  • Resumo da sessão (ou prompt inicial)
  • Metadados: tempo decorrido, contagem de mensagens e branch git
Use as setas para navegar e pressione Enter para selecionar uma conversa. Pressione Esc para sair.
Dicas:
  • O histórico de conversa é armazenado localmente em sua máquina
  • Use --continue para acesso rápido à sua conversa mais recente
  • Use --resume quando você precisar selecionar uma conversa passada específica
  • Ao retomar, você verá todo o histórico de conversa antes de continuar
  • A conversa retomada começa com o mesmo modelo e configuração da original
Como funciona:
  1. Armazenamento de Conversa: Todas as conversas são automaticamente salvas localmente com seu histórico completo de mensagens
  2. Desserialização de Mensagem: Ao retomar, todo o histórico de mensagens é restaurado para manter o contexto
  3. Estado da Ferramenta: O uso de ferramentas e resultados da conversa anterior são preservados
  4. Restauração de Contexto: A conversa retoma com todo o contexto anterior intacto
Exemplos:
# Continue a conversa mais recente
claude --continue

# Continue a conversa mais recente com um prompt específico
claude --continue --print "Show me our progress"

# Mostrar seletor de conversa
claude --resume

# Continue a conversa mais recente em modo não interativo
claude --continue --print "Run the tests again"

​
Executar sessões paralelas de Claude Code com Git worktrees

Suponha que você precise trabalhar em múltiplas tarefas simultaneamente com isolamento completo de código entre instâncias de Claude Code.
1

Entenda Git worktrees

Git worktrees permitem que você faça checkout de múltiplos branches do mesmo repositório em diretórios separados. Cada worktree tem seu próprio diretório de trabalho com arquivos isolados, enquanto compartilha o mesmo histórico Git. Saiba mais na documentação oficial de Git worktree.
2

Crie um novo worktree

# Crie um novo worktree com um novo branch 
git worktree add ../project-feature-a -b feature-a

# Ou crie um worktree com um branch existente
git worktree add ../project-bugfix bugfix-123
Isso cria um novo diretório com uma cópia de trabalho separada de seu repositório.
3

Execute Claude Code em cada worktree

# Navegue até seu worktree 
cd ../project-feature-a

# Execute Claude Code neste ambiente isolado
claude
4

Execute Claude em outro worktree

cd ../project-bugfix
claude
5

Gerencie seus worktrees

# Liste todos os worktrees
git worktree list

# Remova um worktree quando terminar
git worktree remove ../project-feature-a
Dicas:
  • Cada worktree tem seu próprio estado de arquivo independente, tornando-o perfeito para sessões paralelas de Claude Code
  • Alterações feitas em um worktree não afetarão outros, impedindo que instâncias de Claude interfiram uma com a outra
  • Todos os worktrees compartilham o mesmo histórico Git e conexões remotas
  • Para tarefas de longa duração, você pode ter Claude trabalhando em um worktree enquanto continua o desenvolvimento em outro
  • Use nomes de diretório descritivos para identificar facilmente qual tarefa cada worktree é
  • Lembre-se de inicializar seu ambiente de desenvolvimento em cada novo worktree de acordo com a configuração do seu projeto. Dependendo de sua stack, isso pode incluir:
    • Projetos JavaScript: Executar instalação de dependências (npm install, yarn)
    • Projetos Python: Configurar ambientes virtuais ou instalar com gerenciadores de pacotes
    • Outras linguagens: Seguir o processo de configuração padrão do seu projeto

​
Usar Claude como um utilitário estilo unix

​
Adicione Claude ao seu processo de verificação

Suponha que você queira usar Claude Code como um linter ou revisor de código. Adicione Claude ao seu script de build: 
// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}
Dicas:
  • Use Claude para revisão de código automatizada em seu pipeline CI/CD
  • Personalize o prompt para verificar problemas específicos relevantes ao seu projeto
  • Considere criar múltiplos scripts para diferentes tipos de verificação

​
Pipe in, pipe out

Suponha que você queira fazer pipe de dados para Claude e obter dados de volta em um formato estruturado. Faça pipe de dados através de Claude: 
cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt
Dicas:
  • Use pipes para integrar Claude em scripts shell existentes
  • Combine com outras ferramentas Unix para fluxos de trabalho poderosos
  • Considere usar —output-format para saída estruturada

​
Controlar formato de saída

Suponha que você precise da saída do Claude em um formato específico, especialmente ao integrar Claude Code em scripts ou outras ferramentas.
1

Use formato de texto (padrão)

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt
Isso produz apenas a resposta de texto simples do Claude (comportamento padrão).
2

Use formato JSON

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json
Isso produz um array JSON de mensagens com metadados incluindo custo e duração.
3

Use formato JSON de streaming

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json
Isso produz uma série de objetos JSON em tempo real conforme Claude processa a solicitação. Cada mensagem é um objeto JSON válido, mas a saída inteira não é JSON válido se concatenado.
Dicas:
  • Use --output-format text para integrações simples onde você apenas precisa da resposta do Claude
  • Use --output-format json quando você precisar do log de conversa completo
  • Use --output-format stream-json para saída em tempo real de cada turno de conversa

​
Criar comandos slash personalizados

Claude Code suporta comandos slash personalizados que você pode criar para executar rapidamente prompts ou tarefas específicas. Para mais detalhes, veja a página de referência Comandos slash.

​
Criar comandos específicos do projeto

Suponha que você queira criar comandos slash reutilizáveis para seu projeto que todos os membros da equipe possam usar.
1

Crie um diretório de comandos em seu projeto

mkdir -p .claude/commands
2

Crie um arquivo Markdown para cada comando

echo "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md
3

Use seu comando personalizado em Claude Code

> /optimize
Dicas:
  • Nomes de comando são derivados do nome do arquivo (por exemplo, optimize.md se torna /optimize)
  • Você pode organizar comandos em subdiretórios (por exemplo, .claude/commands/frontend/component.md cria /component com “(project:frontend)” mostrado na descrição)
  • Comandos de projeto estão disponíveis para todos que clonam o repositório
  • O conteúdo do arquivo Markdown se torna o prompt enviado ao Claude quando o comando é invocado

​
Adicione argumentos de comando com $ARGUMENTS

Suponha que você queira criar comandos slash flexíveis que possam aceitar entrada adicional dos usuários.
1

Crie um arquivo de comando com o placeholder $ARGUMENTS

echo 'Find and fix issue #$ARGUMENTS. Follow these steps: 1.
Understand the issue described in the ticket 2. Locate the relevant code in
our codebase 3. Implement a solution that addresses the root cause 4. Add
appropriate tests 5. Prepare a concise PR description' >
.claude/commands/fix-issue.md
2

Use o comando com um número de problema

Em sua sessão de Claude, use o comando com argumentos.
> /fix-issue 123
Isso substituirá $ARGUMENTS por “123” no prompt.
Dicas:
  • O placeholder $ARGUMENTS é substituído por qualquer texto que segue o comando
  • Você pode posicionar $ARGUMENTS em qualquer lugar em seu template de comando
  • Outras aplicações úteis: gerar casos de teste para funções específicas, criar documentação para componentes, revisar código em arquivos particulares ou traduzir conteúdo para idiomas especificados

​
Criar comandos slash pessoais

Suponha que você queira criar comandos slash pessoais que funcionem em todos os seus projetos.
1

Crie um diretório de comandos em sua pasta home

mkdir -p ~/.claude/commands
2

Crie um arquivo Markdown para cada comando

echo "Review this code for security vulnerabilities, focusing on:" >
~/.claude/commands/security-review.md
3

Use seu comando personalizado pessoal

> /security-review
Dicas:
  • Comandos pessoais mostram “(user)” em sua descrição quando listados com /help
  • Comandos pessoais estão disponíveis apenas para você e não são compartilhados com sua equipe
  • Comandos pessoais funcionam em todos os seus projetos
  • Você pode usar estes para fluxos de trabalho consistentes em diferentes bases de código

​
Pergunte ao Claude sobre suas capacidades

Claude tem acesso integrado à sua documentação e pode responder perguntas sobre seus próprios recursos e limitações.

​
Perguntas de exemplo

> can Claude Code create pull requests?

> how does Claude Code handle permissions?

> what slash commands are available?

> how do I use MCP with Claude Code?

> how do I configure Claude Code for Amazon Bedrock?

> what are the limitations of Claude Code?
Claude fornece respostas baseadas em documentação para essas perguntas. Para exemplos executáveis e demonstrações práticas, consulte as seções de fluxo de trabalho específicas acima.
Dicas:
  • Claude sempre tem acesso à documentação mais recente de Claude Code, independentemente da versão que você está usando
  • Faça perguntas específicas para obter respostas detalhadas
  • Claude pode explicar recursos complexos como integração MCP, configurações empresariais e fluxos de trabalho avançados

​
Próximos passos

Implementação de referência de Claude Code

Clone nossa implementação de referência de contêiner de desenvolvimento.