컨텍스트 편집

접근 방식	실행 위치	전략	작동 방식
서버 측	API	도구 결과 지우기 (`clear_tool_uses_20250919`) 생각 블록 지우기 (`clear_thinking_20251015`)	프롬프트가 Claude에 도달하기 전에 적용됩니다. 대화 기록에서 특정 콘텐츠를 지웁니다. 각 전략은 독립적으로 구성할 수 있습니다.
클라이언트 측	SDK	압축	`tool_runner`를 사용할 때 Python 및 TypeScript SDK에서 사용 가능합니다. 요약을 생성하고 전체 대화 기록을 바꿉니다. 아래의 압축을 참조하세요.

접근 방식	실행 위치	전략	작동 방식
서버 측	API	도구 결과 지우기 (`clear_tool_uses_20250919`) 생각 블록 지우기 (`clear_thinking_20251015`)	프롬프트가 Claude에 도달하기 전에 적용됩니다. 대화 기록에서 특정 콘텐츠를 지웁니다. 각 전략은 독립적으로 구성할 수 있습니다.
클라이언트 측	SDK	압축	`tool_runner`를 사용할 때 Python 및 TypeScript SDK에서 사용 가능합니다. 요약을 생성하고 전체 대화 기록을 바꿉니다. 아래의 압축을 참조하세요.

접근 방식	실행 위치	전략	작동 방식
서버 측	API	도구 결과 지우기 (`clear_tool_uses_20250919`) 생각 블록 지우기 (`clear_thinking_20251015`)	프롬프트가 Claude에 도달하기 전에 적용됩니다. 대화 기록에서 특정 콘텐츠를 지웁니다. 각 전략은 독립적으로 구성할 수 있습니다.
클라이언트 측	SDK	압축	`tool_runner`를 사용할 때 Python 및 TypeScript SDK에서 사용 가능합니다. 요약을 생성하고 전체 대화 기록을 바꿉니다. 아래의 압축을 참조하세요.

접근 방식	실행 위치	전략	작동 방식
서버 측	API	도구 결과 지우기 (`clear_tool_uses_20250919`) 생각 블록 지우기 (`clear_thinking_20251015`)	프롬프트가 Claude에 도달하기 전에 적용됩니다. 대화 기록에서 특정 콘텐츠를 지웁니다. 각 전략은 독립적으로 구성할 수 있습니다.
클라이언트 측	SDK	압축	`tool_runner`를 사용할 때 Python 및 TypeScript SDK에서 사용 가능합니다. 요약을 생성하고 전체 대화 기록을 바꿉니다. 아래의 압축을 참조하세요.

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-sonnet-4-5",
        "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"}
            ]
        }
    }'

접근 방식	실행 위치	전략	작동 방식
서버 측	API	도구 결과 지우기 (`clear_tool_uses_20250919`) 생각 블록 지우기 (`clear_thinking_20251015`)	프롬프트가 Claude에 도달하기 전에 적용됩니다. 대화 기록에서 특정 콘텐츠를 지웁니다. 각 전략은 독립적으로 구성할 수 있습니다.
클라이언트 측	SDK	압축	`tool_runner`를 사용할 때 Python 및 TypeScript SDK에서 사용 가능합니다. 요약을 생성하고 전체 대화 기록을 바꿉니다. 아래의 압축을 참조하세요.

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-sonnet-4-5",
        "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-sonnet-4-5",
        "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"]
                }
            ]
        }
    }'

접근 방식	실행 위치	전략	작동 방식
서버 측	API	도구 결과 삭제(`clear_tool_uses_20250919`) 사고 블록 삭제(`clear_thinking_20251015`)	프롬프트가 Claude에 도달하기 전에 적용됩니다. 대화 기록에서 특정 콘텐츠를 삭제합니다. 각 전략은 독립적으로 구성할 수 있습니다.
클라이언트 측	SDK	압축	`tool_runner`를 사용할 때 Python 및 TypeScript SDK에서 사용 가능합니다. 요약을 생성하고 전체 대화 기록을 바꿉니다. 아래의 압축을 참조하세요.

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-sonnet-4-5",
        "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-sonnet-4-5",
        "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-sonnet-4-5-20250929",
        "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}`	보존할 최근 어시스턴트 턴의 개수를 정의합니다. 마지막 N개 턴을 유지하려면 `{type: "thinking_turns", value: N}`을 사용하세요(N > 0이어야 함). 모든 사고 블록을 유지하려면 `"all"`을 사용하세요.

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

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

구성 옵션	기본값	설명
`keep`	`{type: "thinking_turns", value: 1}`	보존할 최근 어시스턴트 턴의 개수를 정의합니다. 마지막 N개 턴을 유지하려면 `{type: "thinking_turns", value: N}`을 사용하세요(N > 0이어야 함). 모든 사고 블록을 유지하려면 `"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-sonnet-4-5-20250929",
    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
                }
            }
        ]
    }
)

구성 옵션	기본값	설명
`keep`	`{type: "thinking_turns", value: 1}`	보존할 최근 어시스턴트 턴의 개수를 정의합니다. 마지막 N개 턴을 유지하려면 `{type: "thinking_turns", value: N}`을 사용하세요(N > 0이어야 함). 모든 사고 블록을 유지하려면 `"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-sonnet-4-5-20250929",
    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의 원래 도구 호출을 표시하면서 도구 결과만 삭제됩니다.

구성 옵션	기본값	설명
`keep`	`{type: "thinking_turns", value: 1}`	보존할 최근 어시스턴트 턴의 개수를 정의합니다. 마지막 N개 턴을 유지하려면 `{type: "thinking_turns", value: N}`을 사용하세요(N > 0이어야 함). 모든 사고 블록을 유지하려면 `"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-sonnet-4-5-20250929",
    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의 원래 도구 호출을 표시하면서 도구 결과만 삭제됩니다.

응답

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

스트리밍 응답

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

구성 옵션	기본값	설명
`keep`	`{type: "thinking_turns", value: 1}`	생각 블록이 있는 최근 어시스턴트 턴을 몇 개 보존할지 정의합니다. 마지막 N개 턴을 유지하려면 `{type: "thinking_turns", value: N}`을 사용하세요. 여기서 N은 0보다 커야 하며, 모든 생각 블록을 유지하려면 `"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-sonnet-4-5-20250929",
    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-sonnet-4-5",
        "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-sonnet-4-5",
    max_tokens=4096,
    messages=[...],
    tools=[
        {
            "type": "memory_20250818",
            "name": "memory"
        },
        # Your other tools
    ],
    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-sonnet-4-5",
    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 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	아니오	아래 참조	요약 생성을 위한 사용자 정의 프롬프트

# 메모리 제약 시나리오에서 더 자주 압축
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."""
}

response = client.beta.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=4096,
    messages=[...],
    tools=[
        {
            "type": "memory_20250818",
            "name": "memory"
        },
        # Your other tools
    ],
    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-sonnet-4-5",
    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 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."""
}

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

개요

개요

개요

개요

서버 측 전략

개요

서버 측 전략

도구 결과 지우기

개요

서버 측 전략

도구 결과 지우기

생각 블록 지우기

개요

서버 측 전략

도구 결과 지우기

생각 블록 지우기

지원되는 모델

개요

서버 측 전략

도구 결과 지우기

생각 블록 지우기

지원되는 모델

도구 결과 지우기 사용

개요

서버 측 전략

도구 결과 지우기

생각 블록 지우기

지원되는 모델

도구 결과 지우기 사용

고급 구성

개요

서버 측 전략

도구 결과 삭제

사고 블록 삭제

지원되는 모델

도구 결과 삭제 사용

고급 구성

사고 블록 삭제 사용

사고 블록 삭제를 위한 구성 옵션

사고 블록 삭제를 위한 구성 옵션

전략 결합

사고 블록 삭제를 위한 구성 옵션

전략 결합

도구 결과 삭제를 위한 구성 옵션

사고 블록 삭제를 위한 구성 옵션

전략 결합

도구 결과 삭제를 위한 구성 옵션

컨텍스트 편집 응답

생각 블록 지우기 구성 옵션

전략 결합

도구 결과 지우기 구성 옵션

컨텍스트 편집 응답

토큰 계산

메모리 도구와 함께 사용

클라이언트 측 압축 (SDK)

압축 작동 방식

압축 사용

압축 중 발생하는 일

구성 옵션

토큰 임계값 선택

요약을 위해 다른 모델 사용

사용자 정의 요약 프롬프트

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

클라이언트 측 압축 (SDK)

압축 작동 방식

압축 사용

압축 중에 발생하는 일

구성 옵션

토큰 임계값 선택

요약을 위해 다른 모델 사용

사용자 정의 요약 프롬프트

기본 요약 프롬프트

전체 기본 프롬프트 보기

제한 사항

서버 측 도구

도구 사용 엣지 케이스

제한 사항

서버 측 도구

도구 사용 엣지 케이스

압축 모니터링