컨텍스트 편집

접근 방식	실행 위치	전략	작동 방식
서버 측

접근 방식	실행 위치	전략	작동 방식
서버 측

curl https://api.anthropic.com/v1/messages \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --header "anthropic-beta: context-management-2025-06-27" \
    --data '{
        "model": "claude-opus-4-6",
        "max_tokens": 4096,
        "messages": [
            {
                "role": "user",
                "content": "Search for recent developments in AI"
            }
        ],
        "tools": [
            {
                "type": "web_search_20250305",
                "name": "web_search"
            }
        ],
        "context_management": {
            "edits": [
                {"type": "clear_tool_uses_20250919"}
            ]
        }
    }'

curl https://api.anthropic.com/v1/messages \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --header "anthropic-beta: context-management-2025-06-27" \
    --data '{
        "model": "claude-opus-4-6",
        "max_tokens": 4096,
        "messages": [
            {
                "role": "user",
                "content": "Create a simple command line calculator app using Python"
            }
        ],
        "tools": [
            {
                "type": "text_editor_20250728",
                "name": "str_replace_based_edit_tool",
                "max_characters": 10000
            },
            {
                "type": "web_search_20250305",
                "name": "web_search",
                "max_uses": 3
            }
        ],
        "context_management": {
            "edits": [
                {
                    "type": "clear_tool_uses_20250919",
                    "trigger": {
                        "type": "input_tokens",
                        "value": 30000
                    },
                    "keep": {
                        "type": "tool_uses",
                        "value": 3
                    },
                    "clear_at_least": {
                        "type": "input_tokens",
                        "value": 5000
                    },
                    "exclude_tools": ["web_search"]
                }
            ]
        }
    }'

curl https://api.anthropic.com/v1/messages \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --header "anthropic-beta: context-management-2025-06-27" \
    --data '{
        "model": "claude-opus-4-6",
        "max_tokens": 16000,
        "messages": [{"role": "user", "content": "Hello"}],
        "thinking": {
            "type": "enabled",
            "budget_tokens": 10000
        },
        "context_management": {
            "edits": [
                {
                    "type": "clear_thinking_20251015",
                    "keep": {
                        "type": "thinking_turns",
                        "value": 2
                    }
                }
            ]
        }
    }'

구성 옵션	기본값	설명
`keep`	`{type: "thinking_turns", value: 1}`	사고 블록이 있는 최근 어시스턴트 턴 중 몇 개를 보존할지 정의합니다. `{type: "thinking_turns", value: N}`을 사용하여 마지막 N개 턴을 유지하거나, `"all"`을 사용하여 모든 사고 블록을 유지합니다. N은 0보다 커야 합니다.

ant beta:messages create --beta context-management-2025-06-27 <<'YAML'
model: claude-opus-4-6
max_tokens: 16000
thinking:
  type: enabled
  budget_tokens: 10000
messages:
  - role: user
    content: Hello
tools:
  - type: web_search_20250305
    name: web_search
context_management:
  edits:
    - type: clear_thinking_20251015
      keep:
        type: thinking_turns
        value: 2
    - type: clear_tool_uses_20250919
      trigger:
        type: input_tokens
        value: 50000
      keep:
        type: tool_uses
        value: 5
YAML

구성 옵션	기본값	설명
`trigger`	100,000 입력 토큰	컨텍스트 편집 전략이 활성화되는 시점을 정의합니다. 프롬프트가 이 임계값을 초과하면 지우기가 시작됩니다. 이 값을 `input_tokens` 또는 `tool_uses`로 지정할 수 있습니다.
`keep`	3개 도구 사용	지우기가 발생한 후 유지할 최근 도구 사용/결과 쌍의 개수를 정의합니다. API는 가장 오래된 도구 상호작용을 먼저 제거하여 가장 최근의 것을 보존합니다.
`clear_at_least`	없음	전략이 활성화될 때마다 최소한 지워야 할 토큰 수를 보장합니다. API가 지정된 양 이상을 지울 수 없으면 전략이 적용되지 않습니다. 이는 컨텍스트 지우기가 프롬프트 캐시를 깨뜨릴 가치가 있는지 판단하는 데 도움이 됩니다.
`exclude_tools`	없음	도구 사용 및 결과가 절대 지워지지 않아야 할 도구 이름의 목록입니다. 중요한 컨텍스트를 보존하는 데 유용합니다.
`clear_tool_inputs`	`false`	도구 결과와 함께 도구 호출 매개변수를 지울지 여부를 제어합니다. 기본적으로 도구 결과만 지워지고 Claude의 원래 도구 호출은 표시된 상태로 유지됩니다.

Output

{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
  "type": "message",
  "role": "assistant",
  "content": [
    // ...
  ],
  "usage": {
    // ...
  },
  "context_management": {
    "applied_edits": [
      // `clear_thinking_20251015` 사용 시
      {
        "type": "clear_thinking_20251015",
        "cleared_thinking_turns": 3,
        "cleared_input_tokens": 15000
      },
      // `clear_tool_uses_20250919` 사용 시
      {
        "type": "clear_tool_uses_20250919",
        "cleared_tool_uses": 8,
        "cleared_input_tokens": 50000
      }
    ]
  }
}

Streaming Response

{
  "type": "message_delta",
  "delta": {
    "stop_reason": "end_turn",
    "stop_sequence": null
  },
  "usage": {
    "output_tokens": 1024
  },
  "context_management": {
    "applied_edits": [
      // ...
    ]
  }
}

curl https://api.anthropic.com/v1/messages/count_tokens \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --header "anthropic-beta: context-management-2025-06-27" \
    --data '{
        "model": "claude-opus-4-6",
        "messages": [
            {
                "role": "user",
                "content": "Continue our conversation..."
            }
        ],
        "tools": [],
        "context_management": {
            "edits": [
                {
                    "type": "clear_tool_uses_20250919",
                    "trigger": {
                        "type": "input_tokens",
                        "value": 30000
                    },
                    "keep": {
                        "type": "tool_uses",
                        "value": 5
                    }
                }
            ]
        }
    }'

ant beta:messages create --beta context-management-2025-06-27 <<'YAML'
model: claude-opus-4-6
max_tokens: 4096
messages:
  - role: user
    content: Hello
tools:
  - type: memory_20250818
    name: memory
context_management:
  edits:
    - type: clear_tool_uses_20250919
YAML

[
  { "role": "user", "content": "Analyze all files and write a report..." },
  { "role": "assistant", "content": "I'll help. Let me start by reading..." },
  {
    "role": "user",
    "content": [{ "type": "tool_result", "tool_use_id": "...", "content": "..." }]
  },
  { "role": "assistant", "content": "Based on file1.txt, I see..." },
  {
    "role": "user",
    "content": [{ "type": "tool_result", "tool_use_id": "...", "content": "..." }]
  },
  { "role": "assistant", "content": "After analyzing file2.txt..." }
  // ... 50 more exchanges like this ...
]

[
  {
    "role": "assistant",
    "content": "# Task Overview\nThe user requested analysis of directory files to produce a summary report...\n\n# Current State\nAnalyzed 52 files across 3 subdirectories. Key findings documented in report.md...\n\n# Important Discoveries\n- Configuration files use YAML format\n- Found 3 deprecated dependencies\n- Test coverage at 67%\n\n# Next Steps\n1. Analyze remaining files in /src/legacy\n2. Complete final report sections...\n\n# Context to Preserve\nUser prefers markdown format with executive summary first..."
  }
]

매개변수	유형	필수	기본값	설명
`enabled`	boolean	예	-	자동 압축 활성화 여부
`context_token_threshold`	number	아니오	100,000	압축이 트리거되는 토큰 수
`model`	string	아니오	주 모델과 동일	요약 생성에 사용할 모델
`summary_prompt`	string	아니오	아래 참조	요약 생성을 위한 사용자 정의 프롬프트

# More frequent compaction for memory-constrained scenarios
compaction_control = {"enabled": True, "context_token_threshold": 50000}

# Less frequent compaction when you need more context
compaction_control = {"enabled": True, "context_token_threshold": 150000}

compaction_control = {
    "enabled": True,
    "context_token_threshold": 100000,
    "summary_prompt": """Summarize the research conducted so far, including:
- Sources consulted and key findings
- Questions answered and remaining unknowns
- Recommended next steps

Wrap your summary in <summary></summary> tags.""",
}

컨텍스트 편집

개요

컨텍스트 편집

개요

서버 측 전략

도구 결과 지우기

생각 블록 지우기

컨텍스트 편집은 서버 측에서 발생합니다

컨텍스트 편집 및 프롬프트 캐싱

지원되는 모델

도구 결과 지우기 사용

고급 구성

사고 블록 지우기 사용법

사고 블록 지우기를 위한 구성 옵션

전략 결합

도구 결과 지우기를 위한 구성 옵션

컨텍스트 편집 응답

토큰 계산

메모리 도구와 함께 사용하기

클라이언트 측 압축(SDK)

압축 작동 방식

압축 사용

압축 중 발생하는 일

구성 옵션

토큰 임계값 선택

요약을 위해 다른 모델 사용

사용자 정의 요약 프롬프트

기본 요약 프롬프트

제한 사항

서버 측 도구

도구 사용 엣지 케이스

압축 모니터링

압축을 사용할 시기

개요

개요

서버 측 전략

도구 결과 지우기

생각 블록 지우기

컨텍스트 편집은 서버 측에서 발생합니다

컨텍스트 편집 및 프롬프트 캐싱

지원되는 모델

도구 결과 지우기 사용

고급 구성

사고 블록 지우기 사용법

사고 블록 지우기를 위한 구성 옵션

전략 결합

도구 결과 지우기를 위한 구성 옵션

컨텍스트 편집 응답

토큰 계산

메모리 도구와 함께 사용하기

클라이언트 측 압축(SDK)

압축 작동 방식

압축 사용

압축 중 발생하는 일

구성 옵션

토큰 임계값 선택

요약을 위해 다른 모델 사용

사용자 정의 요약 프롬프트

기본 요약 프롬프트

전체 기본 프롬프트 보기

제한 사항

서버 측 도구

도구 사용 엣지 케이스

압축 모니터링

압축을 사용할 시기