Редактирование контекста в настоящее время находится в бета-версии с поддержкой очистки результатов инструментов. Чтобы включить его, используйте бета-заголовок context-management-2025-06-27 в ваших API-запросах. Дополнительные стратегии редактирования контекста будут добавлены в будущих выпусках.Пожалуйста, свяжитесь с нами через нашу форму обратной связи, чтобы поделиться своими отзывами об этой функции.

​
Как это работает

Стратегия clear_tool_uses_20250919 очищает результаты инструментов, когда контекст разговора превышает ваш настроенный порог. При активации API автоматически очищает самые старые результаты инструментов в хронологическом порядке, заменяя их текстом-заполнителем, чтобы Claude знал, что результат инструмента был удален. По умолчанию очищаются только результаты инструментов. Вы можете дополнительно очистить как результаты инструментов, так и вызовы инструментов (параметры использования инструментов), установив clear_tool_inputs в true. Редактирование контекста делает недействительными кэшированные префиксы промптов, поскольку очистка содержимого изменяет структуру промпта, нарушая требование соответствия для попаданий в кэш. Чтобы учесть это, мы рекомендуем очищать достаточно токенов, чтобы сделать недействительность кэша оправданной. Используйте параметр clear_at_least, чтобы обеспечить минимальное количество токенов, очищаемых каждый раз. При использовании кэширования промптов с редактированием контекста вы будете нести расходы на запись в кэш каждый раз при очистке содержимого, но последующие запросы могут повторно использовать новый кэшированный префикс.

​
Поддерживаемые модели

Редактирование контекста доступно на:
  • Claude Opus 4.1 (claude-opus-4-1-20250805)
  • Claude Opus 4 (claude-opus-4-20250514)
  • Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)
  • Claude Sonnet 4 (claude-sonnet-4-20250514)

​
Базовое использование

Самый простой способ включить редактирование контекста - указать только тип стратегии, поскольку все остальные параметры конфигурации будут использовать свои значения по умолчанию: 
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"]
                }
            ]
        }
    }'

​
Параметры конфигурации

Параметр конфигурацииПо умолчаниюОписание
trigger100,000 входных токеновОпределяет, когда активируется стратегия редактирования контекста. Как только промпт превышает этот порог, начинается очистка. Вы можете указать это значение либо в input_tokens, либо в tool_uses.
keep3 использования инструментовОпределяет, сколько недавних пар использование инструмента/результат сохранить после очистки. API удаляет самые старые взаимодействия с инструментами первыми, сохраняя самые последние.
clear_at_leastНетОбеспечивает минимальное количество токенов, очищаемых каждый раз при активации стратегии. Если API не может очистить как минимум указанное количество, стратегия не будет применена. Это помогает определить, стоит ли очистка контекста нарушения кэша промпта.
exclude_toolsНетСписок имен инструментов, использования и результаты которых никогда не должны очищаться. Полезно для сохранения важного контекста.
clear_tool_inputsfalseКонтролирует, очищаются ли параметры вызова инструмента вместе с результатами инструмента. По умолчанию очищаются только результаты инструментов, при этом исходные вызовы инструментов Claude остаются видимыми.

​
Формат ответа

Вы можете увидеть, какие правки контекста были применены к вашему запросу, используя поле ответа context_management, а также полезную статистику об очищенном содержимом и входных токенах.
Response
{
    "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
    "type": "message",
    "role": "assistant",
    "content": [...],
    "usage": {...},
    "context_management": {
        "applied_edits": [
            {
                "type": "clear_tool_uses_20250919",
                "cleared_tool_uses": 8,
                "cleared_input_tokens": 50000
            }
        ]
    }
}
Для потоковых ответов правки контекста будут включены в финальное событие message_delta:
Streaming Response
{
    "type": "message_delta",
    "delta": {
        "stop_reason": "end_turn",
        "stop_sequence": null
    },
    "usage": {
        "output_tokens": 1024
    },
    "context_management": {
        "applied_edits": [...]
    }
}

​
Подсчет токенов

Конечная точка /v1/messages/count_tokens поддерживает управление контекстом, позволяя вам предварительно просмотреть, сколько токенов будет использовать ваш промпт после применения редактирования контекста. 
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
{
    "input_tokens": 25000,
    "context_management": {
        "original_input_tokens": 70000
    }
}
Ответ показывает как финальный подсчет токенов после применения управления контекстом (input_tokens), так и исходный подсчет токенов до любой очистки (original_input_tokens).