Melhores práticas de prompting

Este guia fornece técnicas específicas de engenharia de prompts para modelos Claude 4.x, com orientação específica para Sonnet 4.5 e Haiku 4.5. Esses modelos foram treinados para seguir instruções com mais precisão do que gerações anteriores de modelos Claude.

Princípios gerais

Seja explícito com suas instruções

Os modelos Claude 4.x respondem bem a instruções claras e explícitas. Ser específico sobre sua saída desejada pode ajudar a melhorar os resultados. Clientes que desejam o comportamento "acima e além" dos modelos Claude anteriores podem precisar solicitar esses comportamentos de forma mais explícita com os modelos mais novos.

Adicione contexto para melhorar o desempenho

Fornecer contexto ou motivação por trás de suas instruções, como explicar ao Claude por que tal comportamento é importante, pode ajudar os modelos Claude 4.x a entender melhor seus objetivos e entregar respostas mais direcionadas.

Claude é inteligente o suficiente para generalizar a partir da explicação.

Seja vigilante com exemplos e detalhes

Os modelos Claude 4.x prestam muita atenção aos detalhes e exemplos como parte de suas capacidades precisas de seguimento de instruções. Certifique-se de que seus exemplos se alinhem com os comportamentos que você deseja encorajar e minimize os comportamentos que deseja evitar.

Raciocínio de longo horizonte e rastreamento de estado

Os modelos Claude 4.5 se destacam em tarefas de raciocínio de longo horizonte com capacidades excepcionais de rastreamento de estado. Ele mantém orientação em sessões estendidas focando no progresso incremental—fazendo avanços constantes em algumas coisas por vez em vez de tentar tudo de uma vez. Essa capacidade emerge especialmente em múltiplas janelas de contexto ou iterações de tarefas, onde Claude pode trabalhar em uma tarefa complexa, salvar o estado e continuar com uma janela de contexto nova.

Consciência de contexto e fluxos de trabalho multi-janela

Os modelos Claude 4.5 apresentam consciência de contexto, permitindo que o modelo rastreie sua janela de contexto restante (ou seja, "orçamento de tokens") durante uma conversa. Isso permite que Claude execute tarefas e gerencie o contexto de forma mais eficaz compreendendo quanto espaço ele tem para trabalhar.

Gerenciando limites de contexto:

Se você estiver usando Claude em um harness de agente que compacta contexto ou permite salvar contexto em arquivos externos (como em Claude Code), sugerimos adicionar essa informação ao seu prompt para que Claude possa se comportar de acordo. Caso contrário, Claude pode às vezes tentar naturalmente encerrar o trabalho conforme se aproxima do limite de contexto. Abaixo está um exemplo de prompt:

Your context window will be automatically compacted as it approaches its limit, allowing you to continue working indefinitely from where you left off. Therefore, do not stop tasks early due to token budget concerns. As you approach your token budget limit, save your current progress and state to memory before the context window refreshes. Always be as persistent and autonomous as possible and complete tasks fully, even if the end of your budget is approaching. Never artificially stop any task early regardless of the context remaining.

A ferramenta de memória se combina naturalmente com consciência de contexto para transições de contexto perfeitas.

Fluxos de trabalho multi-janela de contexto

Para tarefas que abrangem múltiplas janelas de contexto:

1. Use um prompt diferente para a primeira janela de contexto: Use a primeira janela de contexto para configurar um framework (escrever testes, criar scripts de configuração), depois use futuras janelas de contexto para iterar em uma lista de tarefas.

2. Faça o modelo escrever testes em um formato estruturado: Peça ao Claude para criar testes antes de começar o trabalho e acompanhá-los em um formato estruturado (por exemplo, tests.json). Isso leva a uma melhor capacidade de longo prazo para iterar. Lembre Claude da importância dos testes: "É inaceitável remover ou editar testes porque isso pode levar a funcionalidades ausentes ou com bugs."

3. Configure ferramentas de qualidade de vida: Incentive Claude a criar scripts de configuração (por exemplo, init.sh) para iniciar graciosamente servidores, executar suites de testes e linters. Isso evita trabalho repetido ao continuar de uma janela de contexto nova.

4. Começar do zero vs compactar: Quando uma janela de contexto é limpa, considere começar com uma janela de contexto completamente nova em vez de usar compactação. Os modelos Claude 4.5 são extremamente eficazes em descobrir estado do sistema de arquivos local. Em alguns casos, você pode querer aproveitar isso em vez de compactação. Seja prescritivo sobre como deve começar:

   • "Call pwd; you can only read and write files in this directory."
   • "Review progress.txt, tests.json, and the git logs."
   • "Manually run through a fundamental integration test before moving on to implementing new features."

5. Forneça ferramentas de verificação: Conforme o comprimento das tarefas autônomas cresce, Claude precisa verificar a correção sem feedback humano contínuo. Ferramentas como servidor Playwright MCP ou capacidades de uso de computador para testes de UIs são úteis.

6. Incentive o uso completo do contexto: Solicite ao Claude que complete componentes de forma eficiente antes de prosseguir:

This is a very long task, so it may be beneficial to plan out your work clearly. It's encouraged to spend your entire output context working on the task - just make sure you don't run out of context with significant uncommitted work. Continue working systematically until you have completed this task.

Melhores práticas de gerenciamento de estado

• Use formatos estruturados para dados de estado: Ao rastrear informações estruturadas (como resultados de testes ou status de tarefas), use JSON ou outros formatos estruturados para ajudar Claude a entender requisitos de schema
• Use texto não estruturado para notas de progresso: Notas de progresso em forma livre funcionam bem para rastrear progresso geral e contexto
• Use git para rastreamento de estado: Git fornece um log do que foi feito e pontos de verificação que podem ser restaurados. Os modelos Claude 4.5 funcionam especialmente bem usando git para rastrear estado em múltiplas sessões.
• Enfatize progresso incremental: Peça explicitamente ao Claude para acompanhar seu progresso e focar em trabalho incremental

Estilo de comunicação

Os modelos Claude 4.5 têm um estilo de comunicação mais conciso e natural em comparação com modelos anteriores:

• Mais direto e fundamentado: Fornece relatórios de progresso baseados em fatos em vez de atualizações auto-celebratórias
• Mais conversacional: Ligeiramente mais fluente e coloquial, menos mecanizado
• Menos verboso: Pode pular resumos detalhados para eficiência, a menos que solicitado de outra forma

Este estilo de comunicação reflete com precisão o que foi realizado sem elaboração desnecessária.

Orientação para situações específicas

Equilibre verbosidade

Os modelos Claude 4.5 tendem à eficiência e podem pular resumos verbais após chamadas de ferramentas, pulando diretamente para a próxima ação. Embora isso crie um fluxo de trabalho simplificado, você pode preferir mais visibilidade no seu processo de raciocínio.

Se você quiser que Claude forneça atualizações conforme trabalha:

After completing a task that involves tool use, provide a quick summary of the work you've done.

Padrões de uso de ferramentas

Os modelos Claude 4.5 são treinados para seguimento preciso de instruções e se beneficiam de direção explícita para usar ferramentas específicas. Se você disser "você pode sugerir algumas mudanças", às vezes fornecerá sugestões em vez de implementá-las—mesmo que fazer mudanças possa ser o que você pretendia.

Para que Claude tome ação, seja mais explícito:

Para tornar Claude mais proativo em tomar ação por padrão, você pode adicionar isto ao seu prompt do sistema:

<default_to_action>
By default, implement changes rather than only suggesting them. If the user's intent is unclear, infer the most useful likely action and proceed, using tools to discover any missing details instead of guessing. Try to infer the user's intent about whether a tool call (e.g., file edit or read) is intended or not, and act accordingly.
</default_to_action>

Por outro lado, se você quiser que o modelo seja mais hesitante por padrão, menos propenso a pular direto para implementações, e apenas tomar ação se solicitado, você pode orientar esse comportamento com um prompt como o abaixo:

<do_not_act_before_instructions>
Do not jump into implementatation or changes files unless clearly instructed to make changes. When the user's intent is ambiguous, default to providing information, doing research, and providing recommendations rather than taking action. Only proceed with edits, modifications, or implementations when the user explicitly requests them.
</do_not_act_before_instructions>

Controle o formato das respostas

Existem algumas maneiras que descobrimos serem particularmente eficazes em orientar a formatação de saída nos modelos Claude 4.x:

1. Diga ao Claude o que fazer em vez do que não fazer

   • Em vez de: "Do not use markdown in your response"
   • Tente: "Your response should be composed of smoothly flowing prose paragraphs."

2. Use indicadores de formato XML

   • Tente: "Write the prose sections of your response in <smoothly_flowing_prose_paragraphs> tags."

3. Combine seu estilo de prompt com a saída desejada

   O estilo de formatação usado em seu prompt pode influenciar o estilo de resposta do Claude. Se você ainda estiver tendo problemas de direcionabilidade com formatação de saída, recomendamos que, o máximo possível, combine seu estilo de prompt com seu estilo de saída desejado. Por exemplo, remover markdown do seu prompt pode reduzir o volume de markdown na saída.

4. Use prompts detalhados para preferências de formatação específicas

   Para mais controle sobre uso de markdown e formatação, forneça orientação explícita:

<avoid_excessive_markdown_and_bullet_points>
When writing reports, documents, technical explanations, analyses, or any long-form content, write in clear, flowing prose using complete paragraphs and sentences. Use standard paragraph breaks for organization and reserve markdown primarily for `inline code`, code blocks (```...```), and simple headings (###, and ###). Avoid using **bold** and *italics*.

DO NOT use ordered lists (1. ...) or unordered lists (*) unless : a) you're presenting truly discrete items where a list format is the best option, or b) the user explicitly requests a list or ranking

Instead of listing items with bullets or numbers, incorporate them naturally into sentences. This guidance applies especially to technical writing. Using prose instead of excessive formatting will improve user satisfaction. NEVER output a series of overly short bullet points.

Your goal is readable, flowing text that guides the reader naturally through ideas rather than fragmenting information into isolated points.
</avoid_excessive_markdown_and_bullet_points>

Pesquisa e coleta de informações

Os modelos Claude 4.5 demonstram capacidades excepcionais de busca agêntica e podem encontrar e sintetizar informações de múltiplas fontes de forma eficaz. Para resultados de pesquisa ideais:

1. Forneça critérios de sucesso claros: Defina o que constitui uma resposta bem-sucedida para sua pergunta de pesquisa

2. Incentive verificação de fontes: Peça ao Claude para verificar informações em múltiplas fontes

3. Para tarefas de pesquisa complexas, use uma abordagem estruturada:

Search for this information in a structured way. As you gather data, develop several competing hypotheses. Track your confidence levels in your progress notes to improve calibration. Regularly self-critique your approach and plan. Update a hypothesis tree or research notes file to persist information and provide transparency. Break down this complex research task systematically.

Essa abordagem estruturada permite que Claude encontre e sintetize praticamente qualquer informação e critique iterativamente suas descobertas, não importa o tamanho do corpus.

Orquestração de subagentos

Os modelos Claude 4.5 demonstram capacidades significativamente melhoradas de orquestração nativa de subagentos. Esses modelos podem reconhecer quando tarefas se beneficiariam de delegar trabalho a subagentos especializados e fazem isso proativamente sem exigir instrução explícita.

Para aproveitar esse comportamento:

1. Garanta ferramentas de subagentos bem definidas: Tenha ferramentas de subagentos disponíveis e descritas em definições de ferramentas
2. Deixe Claude orquestrar naturalmente: Claude delegará apropriadamente sem instrução explícita
3. Ajuste conservadorismo se necessário:

Only delegate to subagents when the task clearly benefits from a separate agent with a new context window.

Autoconhecimento do modelo

Se você gostaria que Claude se identificasse corretamente em sua aplicação ou usasse strings de API específicas:

The assistant is Claude, created by Anthropic. The current model is Claude Sonnet 4.5.

Para aplicativos alimentados por LLM que precisam especificar strings de modelo:

When an LLM is needed, please default to Claude Sonnet 4.5 unless the user requests otherwise. The exact model string for Claude Sonnet 4.5 is claude-sonnet-4-5-20250929.

Aproveite as capacidades de pensamento e pensamento intercalado

Os modelos Claude 4.x oferecem capacidades de pensamento que podem ser especialmente úteis para tarefas envolvendo reflexão após uso de ferramentas ou raciocínio complexo multi-etapas. Você pode orientar seu pensamento inicial ou intercalado para melhores resultados.

After receiving tool results, carefully reflect on their quality and determine optimal next steps before proceeding. Use your thinking to plan and iterate based on this new information, and then take the best next action.

Criação de documentos

Os modelos Claude 4.5 se destacam na criação de apresentações, animações e documentos visuais. Esses modelos igualam ou excedem Claude Opus 4.1 neste domínio, com criatividade impressionante e seguimento de instruções mais forte. Os modelos produzem saída polida e utilizável na primeira tentativa na maioria dos casos.

Para melhores resultados com criação de documentos:

Create a professional presentation on [topic]. Include thoughtful design elements, visual hierarchy, and engaging animations where appropriate.

Otimize chamadas de ferramentas paralelas

Os modelos Claude 4.x se destacam na execução de ferramentas paralelas, com Sonnet 4.5 sendo particularmente agressivo em disparar múltiplas operações simultaneamente. Os modelos Claude 4.x irão:

• Executar múltiplas buscas especulativas durante pesquisa
• Ler vários arquivos de uma vez para construir contexto mais rápido
• Executar comandos bash em paralelo (o que pode até criar gargalo no desempenho do sistema)

Esse comportamento é facilmente direcionável. Embora o modelo tenha uma alta taxa de sucesso em chamadas de ferramentas paralelas sem prompting, você pode aumentar isso para ~100% ou ajustar o nível de agressão:

<use_parallel_tool_calls>
If you intend to call multiple tools and there are no dependencies between the tool calls, make all of the independent tool calls in parallel. Prioritize calling tools simultaneously whenever the actions can be done in parallel rather than sequentially. For example, when reading 3 files, run 3 tool calls in parallel to read all 3 files into context at the same time. Maximize use of parallel tool calls where possible to increase speed and efficiency. However, if some tool calls depend on previous calls to inform dependent values like the parameters, do NOT call these tools in parallel and instead call them sequentially. Never use placeholders or guess missing parameters in tool calls.
</use_parallel_tool_calls>

Execute operations sequentially with brief pauses between each step to ensure stability.

Reduza criação de arquivos em codificação agêntica

Os modelos Claude 4.x podem às vezes criar novos arquivos para fins de teste e iteração, particularmente ao trabalhar com código. Essa abordagem permite que Claude use arquivos, especialmente scripts python, como um 'bloco de rascunho temporário' antes de salvar sua saída final. Usar arquivos temporários pode melhorar resultados particularmente para casos de uso de codificação agêntica.

Se você preferir minimizar criação de novos arquivos líquidos, você pode instruir Claude a limpar depois de si:

If you create any temporary new files, scripts, or helper files for iteration, clean up these files by removing them at the end of the task.

Melhore geração de código visual e frontend

Os modelos Claude 4.x podem gerar interfaces de usuário de alta qualidade, visualmente distintas e funcionais. No entanto, sem orientação, o código frontend pode usar padrões genéricos que carecem de interesse visual. Para obter resultados excepcionais de UI:

1. Forneça encorajamento explícito para criatividade:

Don't hold back. Give it your all. Create an impressive demonstration showcasing web development capabilities.

1. Especifique direção estética e restrições de design:

Create a professional dashboard using a dark blue and cyan color palette, modern sans-serif typography (e.g., Inter for headings, system fonts for body), and card-based layouts with subtle shadows. Include thoughtful details like hover states, transitions, and micro-interactions. Apply design principles: hierarchy, contrast, balance, and movement.

1. Incentive diversidade de design e estéticas de fusão:

Provide multiple design options. Create fusion aesthetics by combining elements from different sources—one color scheme, different typography, another layout principle. Avoid generic centered layouts, simplistic gradients, and uniform styling.

1. Solicite recursos específicos explicitamente:

• "Include as many relevant features and interactions as possible"
• "Add animations and interactive elements"
• "Create a fully-featured implementation beyond the basics"

Evite focar em passar testes e hard-coding

Os modelos Claude 4.x podem às vezes focar muito pesadamente em fazer testes passarem em detrimento de soluções mais gerais, ou podem usar workarounds como scripts auxiliares para refatoração complexa em vez de usar ferramentas padrão diretamente. Para evitar esse comportamento e garantir soluções robustas e generalizáveis:

Please write a high-quality, general-purpose solution using the standard tools available. Do not create helper scripts or workarounds to accomplish the task more efficiently. Implement a solution that works correctly for all valid inputs, not just the test cases. Do not hard-code values or create solutions that only work for specific test inputs. Instead, implement the actual logic that solves the problem generally.

Focus on understanding the problem requirements and implementing the correct algorithm. Tests are there to verify correctness, not to define the solution. Provide a principled implementation that follows best practices and software design principles.

If the task is unreasonable or infeasible, or if any of the tests are incorrect, please inform me rather than working around them. The solution should be robust, maintainable, and extendable.

Minimizando alucinações em codificação agêntica

Os modelos Claude 4.x são menos propensos a alucinações e fornecem respostas mais precisas, fundamentadas e inteligentes baseadas no código. Para encorajar esse comportamento ainda mais e minimizar alucinações:

<investigate_before_answering>
Never speculate about code you have not opened. If the user references a specific file, you MUST read the file before answering. Make sure to investigate and read relevant files BEFORE answering questions about the codebase. Never make any claims about code before investigating unless you are certain of the correct answer - give grounded and hallucination-free answers.
</investigate_before_answering>

Considerações de migração

Ao migrar para modelos Claude 4.5:

1. Seja específico sobre comportamento desejado: Considere descrever exatamente o que você gostaria de ver na saída.

2. Enquadre suas instruções com modificadores: Adicionar modificadores que encorajem Claude a aumentar a qualidade e detalhe de sua saída pode ajudar a moldar melhor o desempenho do Claude. Por exemplo, em vez de "Create an analytics dashboard", use "Create an analytics dashboard. Include as many relevant features and interactions as possible. Go beyond the basics to create a fully-featured implementation."

3. Solicite recursos específicos explicitamente: Animações e elementos interativos devem ser solicitados explicitamente quando desejados.