컨텍스트 편집

접근 방식	실행 위치	전략	작동 방식
서버 측	API	도구 결과 지우기 (`clear_tool_uses_20250919`) 사고 블록 지우기 (`clear_thinking_20251015`)	프롬프트가 Claude에 도달하기 전에 적용됩니다. 대화 기록에서 특정 콘텐츠를 지웁니다. 각 전략은 독립적으로 구성할 수 있습니다.

접근 방식	실행 위치	전략	작동 방식
서버 측	API	도구 결과 지우기 (`clear_tool_uses_20250919`) 사고 블록 지우기 (`clear_thinking_20251015`)	프롬프트가 Claude에 도달하기 전에 적용됩니다. 대화 기록에서 특정 콘텐츠를 지웁니다. 각 전략은 독립적으로 구성할 수 있습니다.

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": 1024,
        "messages": [...],
        "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은 0보다 커야 함)을 사용하여 마지막 N개 턴을 유지하거나, `"all"`을 사용하여 모든 사고 블록을 유지합니다.

// 마지막 3개 어시스턴트 턴의 사고 블록 유지
{
  "type": "clear_thinking_20251015",
  "keep": {
    "type": "thinking_turns",
    "value": 3
  }
}

// 모든 사고 블록 유지 (캐시 적중률 최대화)
{
  "type": "clear_thinking_20251015",
  "keep": "all"
}

response = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    messages=[...],
    thinking={
        "type": "enabled",
        "budget_tokens": 10000
    },
    tools=[...],
    betas=["context-management-2025-06-27"],
    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
                }
            }
        ]
    }
)

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

Response

{
    "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
                    }
                }
            ]
        }
    }'

response = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=4096,
    messages=[...],
    tools=[
        {
            "type": "memory_20250818",
            "name": "memory"
        },
        # 기타 도구
    ],
    betas=["context-management-2025-06-27"],
    context_management={
        "edits": [
            {"type": "clear_tool_uses_20250919"}
        ]
    }
)

import anthropic

client = anthropic.Anthropic()

runner = client.beta.messages.tool_runner(
    model="claude-opus-4-6",
    max_tokens=4096,
    tools=[...],
    messages=[
        {
            "role": "user",
            "content": "Analyze all the files in this directory and write a summary report."
        }
    ],
    compaction_control={
        "enabled": True,
        "context_token_threshold": 100000
    }
)

for message in runner:
    print(f"Tokens used: {message.usage.input_tokens}")

final = runner.until_done()

[
  { "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개 이상의 교환 ...
]

[
  {
    "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	아니오	아래 참조	요약 생성을 위한 사용자 정의 프롬프트

# 메모리 제약이 있는 시나리오를 위한 더 빈번한 압축
compaction_control={
    "enabled": True,
    "context_token_threshold": 50000
}

# 더 많은 컨텍스트가 필요할 때 덜 빈번한 압축
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."""
}

import logging

logging.basicConfig(level=logging.INFO)
logging.getLogger("anthropic.lib.tools").setLevel(logging.INFO)

# Logs will show:
# INFO: Token usage 105000 has exceeded the threshold of 100000. Performing compaction.
# INFO: Compaction complete. New token usage: 2500

컨텍스트 편집

개요

컨텍스트 편집

개요

서버 측 전략

도구 결과 지우기

사고 블록 지우기

컨텍스트 편집은 서버 측에서 수행됩니다

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

지원 모델

도구 결과 지우기 사용법

고급 구성

사고 블록 지우기 사용법

사고 블록 지우기 구성 옵션

전략 결합

도구 결과 지우기 구성 옵션

컨텍스트 편집 응답

토큰 카운팅

Memory Tool과 함께 사용

클라이언트 측 압축 (SDK)

압축 작동 방식

압축 사용

압축 중 발생하는 일

구성 옵션

토큰 임계값 선택

요약에 다른 모델 사용

사용자 정의 요약 프롬프트

기본 요약 프롬프트

제한 사항

서버 측 도구

도구 사용 엣지 케이스

압축 모니터링

압축을 사용해야 하는 경우

개요

개요

서버 측 전략

도구 결과 지우기

사고 블록 지우기

컨텍스트 편집은 서버 측에서 수행됩니다

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

지원 모델

도구 결과 지우기 사용법

고급 구성

사고 블록 지우기 사용법

사고 블록 지우기 구성 옵션

전략 결합

도구 결과 지우기 구성 옵션

컨텍스트 편집 응답

토큰 카운팅

Memory Tool과 함께 사용

클라이언트 측 압축 (SDK)

압축 작동 방식

압축 사용

압축 중 발생하는 일

구성 옵션

토큰 임계값 선택

요약에 다른 모델 사용

사용자 정의 요약 프롬프트

기본 요약 프롬프트

전체 기본 프롬프트 보기

제한 사항

서버 측 도구

도구 사용 엣지 케이스

압축 모니터링

압축을 사용해야 하는 경우