​

컨텍스트 윈도우 이해하기

• 점진적 토큰 누적: 대화가 턴을 거쳐 진행됨에 따라, 각 사용자 메시지와 어시스턴트 응답이 컨텍스트 윈도우 내에 누적됩니다. 이전 턴들은 완전히 보존됩니다.
• 선형 성장 패턴: 컨텍스트 사용량은 각 턴마다 선형적으로 증가하며, 이전 턴들은 완전히 보존됩니다.
• 200K 토큰 용량: 전체 사용 가능한 컨텍스트 윈도우(200,000 토큰)는 대화 기록을 저장하고 Claude로부터 새로운 출력을 생성하는 최대 용량을 나타냅니다.
• 입력-출력 흐름: 각 턴은 다음으로 구성됩니다:
  • 입력 단계: 모든 이전 대화 기록과 현재 사용자 메시지를 포함
  • 출력 단계: 향후 입력의 일부가 되는 텍스트 응답을 생성

​

확장된 사고와 함께하는 컨텍스트 윈도우

• 확장된 사고 제거: 확장된 사고 블록(진한 회색으로 표시)은 각 턴의 출력 단계에서 생성되지만, 후속 턴의 입력 토큰으로 전달되지 않습니다. 사고 블록을 직접 제거할 필요가 없습니다. Claude API가 다시 전달할 때 자동으로 이를 수행합니다.
• 기술적 구현 세부사항:
  • API는 대화 기록의 일부로 다시 전달할 때 이전 턴의 사고 블록을 자동으로 제외합니다.
  • 확장된 사고 토큰은 생성 시 한 번만 출력 토큰으로 청구됩니다.
  • 효과적인 컨텍스트 윈도우 계산은 다음과 같습니다: context_window = (input_tokens - previous_thinking_tokens) + current_turn_tokens.
  • 사고 토큰에는 thinking 블록과 redacted_thinking 블록이 모두 포함됩니다.

​

확장된 사고와 도구 사용이 있는 컨텍스트 윈도우

• 확장된 사고와 도구 사용에 대한 고려사항:
  • 도구 결과를 게시할 때, 해당 특정 도구 요청과 함께 제공되는 전체 수정되지 않은 사고 블록(서명/편집된 부분 포함)이 포함되어야 합니다.
  • 확장된 사고와 도구 사용에 대한 효과적인 컨텍스트 윈도우 계산은 다음과 같습니다: context_window = input_tokens + current_turn_tokens.
  • 시스템은 암호화 서명을 사용하여 사고 블록의 진위성을 확인합니다. 도구 사용 중 사고 블록을 보존하지 않으면 Claude의 추론 연속성이 깨질 수 있습니다. 따라서 사고 블록을 수정하면 API가 오류를 반환합니다.

​

1M 토큰 컨텍스트 윈도우

from anthropic import Anthropic

client = Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Process this large document..."}
    ],
    betas=["context-1m-2025-08-07"]
)

• 베타 상태: 이는 변경될 수 있는 베타 기능입니다. 기능과 가격은 향후 릴리스에서 수정되거나 제거될 수 있습니다.
• 사용 등급 요구사항: 1M 토큰 컨텍스트 윈도우는 사용 등급 4의 조직과 사용자 정의 속도 제한이 있는 조직에서 사용할 수 있습니다. 낮은 등급의 조직은 이 기능에 액세스하려면 사용 등급 4로 승급해야 합니다.
• 가용성: 1M 토큰 컨텍스트 윈도우는 현재 Claude API, Amazon Bedrock, Google Cloud의 Vertex AI에서 사용할 수 있습니다.
• 가격: 200K 토큰을 초과하는 요청은 자동으로 프리미엄 요금(입력 2배, 출력 1.5배 가격)으로 청구됩니다. 자세한 내용은 가격 문서를 참조하세요.
• 속도 제한: 긴 컨텍스트 요청에는 전용 속도 제한이 있습니다. 자세한 내용은 속도 제한 문서를 참조하세요.
• 멀티모달 고려사항: 많은 수의 이미지나 PDF를 처리할 때, 파일의 토큰 사용량이 다를 수 있음을 유의하세요. 큰 프롬프트와 많은 수의 이미지를 결합할 때 요청 크기 제한에 도달할 수 있습니다.

​

Claude Sonnet 4.5와 Haiku 4.5의 컨텍스트 인식

<budget:token_budget>200000</budget:token_budget>

<system_warning>Token usage: 35000/200000; 165000 remaining</system_warning>

• 지속적인 집중이 필요한 장기 실행 에이전트 세션
• 상태 전환이 중요한 멀티 컨텍스트 윈도우 워크플로우
• 신중한 토큰 관리가 필요한 복잡한 작업

​

최신 Claude 모델의 컨텍스트 윈도우 관리

​

다음 단계