📄 claude/docs/build-with-claude/prompt-engineering/long-context-tips

File: long-context-tips.md | Updated: 11/15/2025

Source: https://docs.claude.com/en/docs/build-with-claude/prompt-engineering/long-context-tips

Agent Skills are now available! Learn more about extending Claude's capabilities with Agent Skills .

Claude Docs home pagelight logodark logo

US

English

Search...

Ctrl K

Search...

Navigation

Prompt engineering

Long context prompting tips

Home Developer Guide API Reference Model Context Protocol (MCP) Resources Release Notes

On this page

While these tips apply broadly to all Claude models, you can find prompting tips specific to extended thinking models here .

Claude’s extended context window (200K tokens for Claude 3 models) enables handling complex, data-rich tasks. This guide will help you leverage this power effectively.

Essential tips for long context prompts

  • Put longform data at the top: Place your long documents and inputs (~20K+ tokens) near the top of your prompt, above your query, instructions, and examples. This can significantly improve Claude’s performance across all models.

    Queries at the end can improve response quality by up to 30% in tests, especially with complex, multi-document inputs.

  • Structure document content and metadata with XML tags: When using multiple documents, wrap each document in <document> tags with <document_content> and <source> (and other metadata) subtags for clarity.Example multi-document structure

    Copy

    <documents>
      <document index="1">
        <source>annual_report_2023.pdf</source>
        <document_content>
          {{ANNUAL_REPORT}}
        </document_content>
      </document>
      <document index="2">
        <source>competitor_analysis_q2.xlsx</source>
        <document_content>
          {{COMPETITOR_ANALYSIS}}
        </document_content>
      </document>
    </documents>
    
    Analyze the annual report and competitor analysis. Identify strategic advantages and recommend Q3 focus areas.
    
  • Ground responses in quotes: For long document tasks, ask Claude to quote relevant parts of the documents first before carrying out its task. This helps Claude cut through the “noise” of the rest of the document’s contents.Example quote extraction

    Copy

    You are an AI physician's assistant. Your task is to help doctors diagnose possible patient illnesses.
    
    <documents>
      <document index="1">
        <source>patient_symptoms.txt</source>
        <document_content>
          {{PATIENT_SYMPTOMS}}
        </document_content>
      </document>
      <document index="2">
        <source>patient_records.txt</source>
        <document_content>
          {{PATIENT_RECORDS}}
        </document_content>
      </document>
      <document index="3">
        <source>patient01_appt_history.txt</source>
        <document_content>
          {{PATIENT01_APPOINTMENT_HISTORY}}
        </document_content>
      </document>
    </documents>
    
    Find quotes from the patient records and appointment history that are relevant to diagnosing the patient's reported symptoms. Place these in <quotes> tags. Then, based on these quotes, list all information that would help the doctor diagnose the patient's symptoms. Place your diagnostic information in <info> tags.
    

Prompt library
--------------

Get inspired by a curated selection of prompts for various tasks and use cases.
GitHub prompting tutorial
-------------------------

An example-filled tutorial that covers the prompt engineering concepts found in our docs.
Google Sheets prompting tutorial
--------------------------------

A lighter weight version of our prompt engineering tutorial via an interactive spreadsheet.

Was this page helpful?

YesNo

Chain complex prompts Extended thinking tips

Assistant

Responses are generated using AI and may contain mistakes.