Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Esta página coleta receitas curtas para desenvolvimento cotidiano. Para orientação de nível superior sobre prompting e gerenciamento de contexto, consulte Melhores práticas. Esta página aborda:

​
Receitas de prompt

Estes são padrões de prompt para tarefas cotidianas como explorar código desconhecido, depuração, refatoração, escrita de testes e criação de PRs. Cada um funciona em qualquer superfície do Claude Code; adapte a redação ao seu projeto.

​
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
  • Instale um plugin de inteligência de código para sua linguagem para dar ao Claude navegação precisa de “ir para definição” e “encontrar referências”

​
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 obtenha 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 pequenos incrementos testáveis

​
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
Claude pode gerar testes que seguem os padrões e convenções existentes do seu projeto. Ao solicitar testes, seja específico sobre qual comportamento você quer verificar. Claude examina seus arquivos de teste existentes para corresponder ao estilo, frameworks e padrões de asserção já em uso. Para cobertura abrangente, peça ao Claude para identificar casos extremos que você pode ter perdido. Claude pode analisar seus caminhos de código e sugerir testes para condições de erro, valores de limite e entradas inesperadas que são fáceis de negligenciar.

​
Criar pull requests

Você pode criar pull requests pedindo ao Claude diretamente (“create a pr for my changes”), ou guiar Claude através disso passo a passo:
1

Resuma suas alterações

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

Gere uma pull request

create a pr
3

Revise e refine

enhance the PR description with more context about the security improvements
Quando você cria uma PR usando gh pr create, a sessão é automaticamente vinculada a essa PR. Para retornar a ela mais tarde, execute claude --from-pr <number> ou cole a URL da PR no seletor /resume.
Revise a PR gerada por Claude antes de enviar e 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 em notas e pastas não-código

Claude Code funciona em qualquer diretório. Execute-o dentro de um cofre de notas, uma pasta de documentação ou qualquer coleção de arquivos markdown para pesquisar, editar e reorganizar conteúdo da mesma forma que você faria com código. O diretório .claude/ e CLAUDE.md ficam ao lado dos diretórios de configuração de outras ferramentas sem conflito. Claude lê arquivos novamente em cada chamada de ferramenta, então vê edições que você faz em outro aplicativo na próxima vez que lê esse arquivo.

​
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
  • Quando Claude referencia imagens (por exemplo, [Image #1]), Cmd+Click (Mac) ou Ctrl+Click (Windows/Linux) o link para abrir a imagem em seu visualizador padrão

​
Referenciar arquivos e diretórios

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

Referencie um único arquivo

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. Consulte recursos MCP para detalhes.
Dicas:
  • Os 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”)

​
Executar Claude em um cronograma

Suponha que você queira que Claude lide com uma tarefa automaticamente em uma base recorrente, como revisar PRs abertas todas as manhãs, auditar dependências semanalmente ou verificar falhas de CI durante a noite. Escolha uma opção de agendamento com base em onde você quer que a tarefa seja executada:
OpçãoOnde é executadoMelhor para
RotinasInfraestrutura gerenciada pela AnthropicTarefas que devem ser executadas mesmo quando seu computador está desligado. Também podem ser acionadas por chamadas de API ou eventos do GitHub além de um cronograma. Configure em claude.ai/code/routines.
Tarefas agendadas no desktopSua máquina, via aplicativo desktopTarefas que precisam de acesso direto a arquivos locais, ferramentas ou alterações não confirmadas.
GitHub ActionsSeu pipeline de CITarefas vinculadas a eventos de repositório como PRs abertos, ou cronogramas cron que devem viver junto com sua configuração de fluxo de trabalho.
/loopA sessão CLI atualPolling rápido enquanto uma sessão está aberta. As tarefas são canceladas quando você inicia uma nova conversa; --resume e --continue restauram as não expiradas.
Ao escrever prompts para tarefas agendadas, seja explícito sobre o que o sucesso parece e o que fazer com os resultados. A tarefa é executada autonomamente, então não pode fazer perguntas de esclarecimento. Por exemplo: “Review open PRs labeled needs-review, leave inline comments on any issues, and post a summary in the #eng-reviews Slack channel.”

​
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 skills 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 demonstrações práticas, execute /powerup para lições interativas com demos animadas, ou consulte as seções de fluxo de trabalho específicas acima.
Dicas:
  • Claude sempre tem acesso à documentação mais recente do 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

​
Retomar conversas anteriores

Quando uma tarefa abrange múltiplas sessões, retome de onde parou em vez de re-explicar o contexto. Claude Code salva cada conversa localmente. 
claude --continue
Isso retoma a sessão mais recente no diretório atual; se não houver uma ainda, ele imprime No conversation found to continue e sai. Use claude --resume para escolher de uma lista, ou /resume de dentro de uma sessão em execução. Consulte Gerenciar sessões para nomeação, ramificação e referência completa do seletor.

​
Executar sessões paralelas com worktrees

Trabalhe em um recurso em um terminal enquanto Claude corrige um bug em outro, sem que as edições colidam. Cada worktree é um checkout separado em seu próprio branch. 
claude --worktree feature-auth
Execute o mesmo comando com um nome diferente em um segundo terminal para iniciar uma sessão paralela isolada. Consulte Worktrees para limpeza, .worktreeinclude e suporte a VCS não-git. Para monitorar sessões paralelas de uma tela em vez de terminais separados, consulte agentes em segundo plano.

​
Planejar antes de editar

Para alterações que você quer revisar antes de tocarem o disco, mude para plan mode. Claude lê arquivos e propõe um plano, mas não faz edições até que você aprove. 
claude --permission-mode plan
Você também pode pressionar Shift+Tab durante uma sessão para alternar para plan mode. Consulte Plan mode para o fluxo de aprovação e edição do plano em seu editor de texto.

​
Delegar pesquisa para subagents

Explorar uma base de código grande preenche seu contexto com leituras de arquivo. Delegue a exploração para que apenas os achados retornem. 
use a subagent to investigate how our auth system handles token refresh
O subagent lê arquivos em sua própria janela de contexto e relata um resumo. Consulte Subagents para definir agentes personalizados com suas próprias ferramentas e prompts.

​
Canalizar Claude em scripts

Execute Claude de forma não interativa para CI, hooks de pré-commit ou processamento em lote. Stdin e stdout funcionam como qualquer ferramenta Unix. 
git log --oneline -20 | claude -p "summarize these recent commits"
Consulte Modo não interativo para formatos de saída, flags de permissão e padrões de fan-out.

​
Próximos passos

Melhores práticas

Padrões para aproveitar ao máximo Claude Code

Gerenciar sessões

Retomar, nomear e ramificar conversas

Worktrees

Executar sessões paralelas isoladas

Estender Claude Code

Adicionar skills, hooks, MCP, subagents e plugins