--- title: Сжатие контекста при достижении порога токенов url: https://platform.claude.com/docs/ru/build-with-claude/compaction-threshold description: API автоматически суммирует более старый контекст в рамках обычного запроса, когда разговор достигает заданного вами порога токенов. featureMetadata: status: beta betaHeader: compact-2026-01-12 zdr: eligibility: eligible note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements). supportedModels: - claude-fable-5-1 - claude-mythos-5-1 - claude-fable-5 - claude-mythos-5 - claude-mythos-preview - claude-opus-5-5 - claude-opus-5 - claude-opus-4-8 - claude-opus-4-7 - claude-opus-4-6 - claude-sonnet-5-5 - claude-sonnet-5 - claude-sonnet-4-6 - claude-haiku-5-5 supportedPlatforms: Claude API: beta Claude Platform on AWS: beta Amazon Bedrock: beta Google Cloud: beta Microsoft Foundry: beta --- «Threshold compaction» (сжатие по порогу) — это автоматическая разновидность «compaction» (сжатия): вы задаёте порог токенов в своих обычных запросах, и API суммирует более старый контекст посреди запроса, как только порог достигнут. Этот вариант поддерживается наряду со сжатием по запросу, при котором вы сами решаете, когда создаётся сводка (см. [Сжатие по запросу](https://platform.claude.com/docs/ru/build-with-claude/compaction-on-demand)). Чтобы выбрать между ними, см. [Выбор способа сжатия](https://platform.claude.com/docs/ru/build-with-claude/compaction#choose-how-to-compact). Сжатие увеличивает эффективную длину контекста для длительных разговоров и задач, автоматически суммируя более старый контекст при приближении к пределу «context window» (контекстного окна). Оно также сохраняет активный контекст небольшим: по мере роста разговора качество ответов снижается, поэтому сжатие заменяет более старое содержимое кратким резюме. Чтобы подробнее узнать, почему длинные контексты ухудшают качество и как сжатие помогает, см. [Эффективная инженерия контекста](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents). Это идеально подходит для: * Многоходовых разговоров в формате чата, когда вы хотите, чтобы пользователи долгое время работали в одном чате * Подсказок, ориентированных на задачи, которые требуют большого объёма последующей работы (часто с использованием инструментов) и могут превысить контекстное окно ## Как работает сжатие Когда сжатие включено, Claude автоматически суммирует ваш разговор, когда он достигает настроенного порога токенов. API: 1. Определяет, когда входные токены достигают указанного вами порога срабатывания. 2. Генерирует сводку текущего разговора. 3. Создаёт блок `compaction`, содержащий сводку. 4. Продолжает ответ со сжатым контекстом. В последующих запросах добавляйте ответ к своим сообщениям. API автоматически отбрасывает все блоки содержимого, предшествующие блоку `compaction`, и продолжает разговор со сводки. ![Compaction flow (процесс сжатия): когда входные токены достигают порога срабатывания (trigger), Claude записывает сводку в блок compaction и продолжает работу](https://platform.claude.com/docs/ru/images/compaction-flow.svg) ## Базовое использование Включите сжатие, добавив стратегию `compact_20260112` в `context_management.edits` в вашем запросе к Messages API. ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Help me build a website" } ], "context_management": { "edits": [ { "type": "compact_20260112" } ] } }' ``` ```bash CLI ant beta:messages create --beta compact-2026-01-12 <<'YAML' model: claude-opus-5-5 max_tokens: 4096 messages: - role: user content: Help me build a website context_management: edits: - type: compact_20260112 YAML ``` ```python Python client = anthropic.Anthropic() messages = [{"role": "user", "content": "Help me build a website"}] response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages, context_management={"edits": [{"type": "compact_20260112"}]}, ) # Добавьте ответ (включая блок сжатия, если он есть), чтобы продолжить диалог messages.append({"role": "assistant", "content": response.content}) ``` ```typescript TypeScript const client = new Anthropic(); const messages: Anthropic.Beta.Messages.BetaMessageParam[] = [ { role: "user", content: "Help me build a website" } ]; const response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages, context_management: { edits: [ { type: "compact_20260112" } ] } }); // Добавьте ответ (включая блок compaction, если он есть), чтобы продолжить диалог messages.push({ role: "assistant", content: response.content }); ``` ```csharp C# AnthropicClient client = new(); var messages = new List { new() { Role = Role.User, Content = "Help me build a website" } }; var parameters = new MessageCreateParams { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit()] } }; var response = await client.Beta.Messages.Create(parameters); // Добавьте ответ (включая блок сжатия, если он есть), чтобы продолжить диалог messages.Add(new BetaMessageParam { Role = Role.Assistant, Content = response.Content.Select(block => new BetaContentBlockParam(block.Json)).ToList() }); Console.WriteLine(response); ``` ```go Go client := anthropic.NewClient() messages := []anthropic.BetaMessageParam{ anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Help me build a website")), } response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{}}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } // Добавьте ответ (включая блок сжатия, если он есть), чтобы продолжить диалог messages = append(messages, response.ToParam()) fmt.Println(response) ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; // ... AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .addBeta("compact-2026-01-12") .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addUserMessage("Help me build a website") .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder().build()) .build()) .build(); BetaMessage response = client.beta().messages().create(params); // Добавьте ответ (включая блок сжатия, если он есть), чтобы продолжить диалог, // включив его в messages следующего запроса System.out.println(response); ``` ```php PHP $client = new Client(); $messages = [ ['role' => 'user', 'content' => 'Help me build a website'] ]; $response = $client->beta->messages->create( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ ['type' => 'compact_20260112'] ] ] ); // Добавьте ответ (включая блок сжатия, если он есть), чтобы продолжить диалог $messages[] = ['role' => 'assistant', 'content' => $response->content]; echo json_encode($response, JSON_PRETTY_PRINT), PHP_EOL; ``` ```ruby Ruby client = Anthropic::Client.new messages = [ { role: "user", content: "Help me build a website" } ] response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [{ type: "compact_20260112" }] } ) # Добавьте ответ (включая блок сжатия, если он есть), чтобы продолжить диалог messages << { role: "assistant", content: response.content } puts response ``` ## Параметры | Параметр | Тип | По умолчанию | Описание | | ------------------------ | ------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | `type` | string | Обязательный | Должен быть `"compact_20260112"` | | `trigger` | object | `{"type": "input_tokens", "value": 150000}` | Когда запускать сжатие. `input_tokens` — единственный поддерживаемый тип триггера. `value` должно быть не менее 50 000 токенов. | | `pause_after_compaction` | boolean | `false` | Приостанавливать ли работу после генерации сводки сжатия | | `instructions` | string | `null` | Пользовательская подсказка для суммаризации. Если указана, полностью заменяет подсказку по умолчанию. | ### Настройка триггера Настройте момент срабатывания сжатия с помощью параметра `trigger`: ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Hello, Claude" } ], "context_management": { "edits": [ { "type": "compact_20260112", "trigger": { "type": "input_tokens", "value": 150000 } } ] } }' ``` ```bash CLI ant beta:messages create --beta compact-2026-01-12 <<'YAML' model: claude-opus-5-5 max_tokens: 4096 messages: - role: user content: Hello, Claude context_management: edits: - type: compact_20260112 trigger: type: input_tokens value: 150000 YAML ``` ```python Python client = anthropic.Anthropic() messages = [{"role": "user", "content": "Hello, Claude"}] response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages, context_management={ "edits": [ { "type": "compact_20260112", "trigger": {"type": "input_tokens", "value": 150000}, } ] }, ) ``` ```typescript TypeScript const client = new Anthropic(); const messages: Anthropic.Beta.Messages.BetaMessageParam[] = [ { role: "user", content: "Hello, Claude" } ]; const response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages, context_management: { edits: [ { type: "compact_20260112", trigger: { type: "input_tokens", value: 150000 } } ] } }); ``` ```csharp C# AnthropicClient client = new(); List messages = [new() { Role = Role.User, Content = "Hello" }]; var parameters = new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Betas = ["compact-2026-01-12"], Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit { Trigger = new BetaInputTokensTrigger(150000) }] } }; var message = await client.Beta.Messages.Create(parameters); Console.WriteLine(message); ``` ```go Go client := anthropic.NewClient() messages := []anthropic.BetaMessageParam{anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude"))} response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{ Trigger: anthropic.BetaInputTokensTriggerParam{Value: 150000}, }}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } fmt.Println(response) ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; import com.anthropic.models.beta.messages.BetaInputTokensTrigger; // ... AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addBeta("compact-2026-01-12") .addUserMessage("Hello, Claude") .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder() .trigger(BetaInputTokensTrigger.builder() .value(150000L) .build()) .build()) .build()) .build(); BetaMessage response = client.beta().messages().create(params); System.out.println(response); ``` ```php PHP $client = new Client(); $messages = [['role' => 'user', 'content' => 'Hello, Claude']]; $message = $client->beta->messages->create( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ [ 'type' => 'compact_20260112', 'trigger' => [ 'type' => 'input_tokens', 'value' => 150000 ] ] ] ] ); echo $message; ``` ```ruby Ruby client = Anthropic::Client.new messages = [{ role: "user", content: "Hello, Claude" }] response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [ { type: "compact_20260112", trigger: { type: "input_tokens", value: 150000 } } ] } ) puts response ``` ### Пользовательские инструкции для суммаризации Подсказка для суммаризации по умолчанию зависит от модели. Каждая подсказка по умолчанию указывает Claude написать сводку внутри тегов `` с информацией, необходимой для продолжения задачи в будущем контекстном окне. Например, некоторые модели используют следующую подсказку: ```text wrap You have written a partial transcript for the initial task above. Please write a summary of the transcript. The purpose of this summary is to provide continuity so you can continue to make progress towards solving the task in a future context, where the raw history above may not be accessible and will be replaced with this summary. Write down anything that would be helpful, including the state, next steps, learnings etc. You must wrap your summary in a block. ``` Вы можете предоставить пользовательские инструкции через параметр `instructions`. Пользовательские инструкции не дополняют подсказку по умолчанию. Они полностью её заменяют: ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Hello, Claude" } ], "context_management": { "edits": [ { "type": "compact_20260112", "instructions": "Focus on preserving code snippets, variable names, and technical decisions." } ] } }' ``` ```bash CLI ant beta:messages create --beta compact-2026-01-12 <<'YAML' model: claude-opus-5-5 max_tokens: 4096 messages: - role: user content: Hello, Claude context_management: edits: - type: compact_20260112 instructions: >- Focus on preserving code snippets, variable names, and technical decisions. YAML ``` ```python Python client = anthropic.Anthropic() messages = [{"role": "user", "content": "Hello, Claude"}] response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages, context_management={ "edits": [ { "type": "compact_20260112", "instructions": "Focus on preserving code snippets, variable names, and technical decisions.", } ] }, ) ``` ```typescript TypeScript const client = new Anthropic(); const messages: Anthropic.Beta.Messages.BetaMessageParam[] = [ { role: "user", content: "Hello, Claude" } ]; const response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages, context_management: { edits: [ { type: "compact_20260112", instructions: "Focus on preserving code snippets, variable names, and technical decisions." } ] } }); ``` ```csharp C# AnthropicClient client = new(); var parameters = new MessageCreateParams { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = [ new BetaMessageParam { Role = Role.User, Content = "Help me build a Python web scraper" }, new BetaMessageParam { Role = Role.Assistant, Content = "I'll help you build a web scraper..." }, new BetaMessageParam { Role = Role.User, Content = "Add support for JavaScript-rendered pages" } ], ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit { Instructions = "Focus on preserving code snippets, variable names, and technical decisions." }] } }; var message = await client.Beta.Messages.Create(parameters); Console.WriteLine(message); ``` ```go Go client := anthropic.NewClient() response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: []anthropic.BetaMessageParam{ anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Help me build a Python web scraper")), {Role: anthropic.BetaMessageParamRoleAssistant, Content: []anthropic.BetaContentBlockParamUnion{anthropic.NewBetaTextBlock("I'll help you build a web scraper...")}}, anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Add support for JavaScript-rendered pages")), }, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{ Instructions: anthropic.String("Focus on preserving code snippets, variable names, and technical decisions."), }}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } fmt.Println(response) ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; // ... AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .addBeta("compact-2026-01-12") .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addUserMessage("Help me build a Python web scraper") .addAssistantMessage("I'll help you build a web scraper...") .addUserMessage("Add support for JavaScript-rendered pages") .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder() .instructions("Focus on preserving code snippets, variable names, and technical decisions.") .build()) .build()) .build(); BetaMessage response = client.beta().messages().create(params); System.out.println(response); ``` ```php PHP $client = new Client(); $response = $client->beta->messages->create( maxTokens: 4096, messages: [ ['role' => 'user', 'content' => 'Help me build a Python web scraper'], ['role' => 'assistant', 'content' => "I'll help you build a web scraper..."], ['role' => 'user', 'content' => 'Add support for JavaScript-rendered pages'] ], model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ [ 'type' => 'compact_20260112', 'instructions' => 'Focus on preserving code snippets, variable names, and technical decisions.' ] ] ] ); echo json_encode($response, JSON_PRETTY_PRINT), PHP_EOL; ``` ```ruby Ruby client = Anthropic::Client.new response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: [ { role: "user", content: "Help me build a Python web scraper" }, { role: "assistant", content: "I'll help you build a web scraper..." }, { role: "user", content: "Add support for JavaScript-rendered pages" } ], context_management: { edits: [ { type: "compact_20260112", instructions: "Focus on preserving code snippets, variable names, and technical decisions." } ] } ) puts response ``` В моделях Claude 5.1 и более поздних запрос с пользовательскими `instructions` создаёт сводку только на основе видимой части разговора: более ранние блоки размышлений не входят во входные данные суммаризатора. ### Пауза после сжатия Используйте `pause_after_compaction`, чтобы приостановить API после генерации сводки сжатия. Это позволяет добавить дополнительные блоки содержимого (например, сохранить недавние сообщения или определённые сообщения с инструкциями), прежде чем API продолжит ответ. Если этот параметр включён, API после генерации блока сжатия возвращает сообщение с причиной остановки `compaction`: ```bash cURL # pause_after_compaction останавливает ответ сразу после сводки # сжатия (compaction), чтобы вы могли изменить сообщения перед продолжением. Шаг # продолжения плохо переносится в разовую команду оболочки; см. вкладки SDK # с полным процессом паузы и продолжения. Один приостановленный запрос: curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Hello, Claude" } ], "context_management": { "edits": [ { "type": "compact_20260112", "pause_after_compaction": true } ] } }' ``` ```bash CLI # pause_after_compaction останавливает ответ сразу после сводки # сжатия, чтобы вы могли изменить сообщения перед продолжением. Шаг # продолжения плохо подходит для разовой команды CLI; полный цикл паузы # и продолжения см. на вкладках SDK. Один приостановленный запрос: ant beta:messages create --beta compact-2026-01-12 --format jsonl <<'YAML' model: claude-opus-5-5 max_tokens: 4096 messages: - role: user content: Hello, Claude context_management: edits: - type: compact_20260112 pause_after_compaction: true YAML ``` ```python Python client = anthropic.Anthropic() messages = [{"role": "user", "content": "Hello, Claude"}] response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages, context_management={ "edits": [{"type": "compact_20260112", "pause_after_compaction": True}] }, ) # Проверяем, вызвало ли сжатие (compaction) паузу if response.stop_reason == "compaction": # Ответ содержит только блок сжатия messages.append({"role": "assistant", "content": response.content}) # Продолжаем запрос response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages, context_management={"edits": [{"type": "compact_20260112"}]}, ) ``` ```typescript TypeScript const client = new Anthropic(); const messages: Anthropic.Beta.Messages.BetaMessageParam[] = [ { role: "user", content: "Hello, Claude" } ]; let response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages, context_management: { edits: [ { type: "compact_20260112", pause_after_compaction: true } ] } }); // Проверяем, вызвало ли сжатие (compaction) паузу if (response.stop_reason === "compaction") { // Ответ содержит только блок сжатия messages.push({ role: "assistant", content: response.content }); // Продолжаем запрос response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages, context_management: { edits: [{ type: "compact_20260112" }] } }); } ``` ```csharp C# var client = new AnthropicClient(); var messages = new List { new() { Role = Role.User, Content = "Hello, Claude" } }; var parameters = new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Betas = ["compact-2026-01-12"], Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit { PauseAfterCompaction = true }] } }; var response = await client.Beta.Messages.Create(parameters); if (response.StopReason == BetaStopReason.Compaction) { messages.Add(new BetaMessageParam { Role = Role.Assistant, Content = response.Content.Select(block => new BetaContentBlockParam(block.Json)).ToList() }); parameters = new() { Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Betas = ["compact-2026-01-12"], Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit()] } }; response = await client.Beta.Messages.Create(parameters); } Console.WriteLine(response); ``` ```go Go client := anthropic.NewClient() messages := []anthropic.BetaMessageParam{anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude"))} compactEdit := anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{ PauseAfterCompaction: anthropic.Bool(true), }}, }, } response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: compactEdit, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } if response.StopReason == "compaction" { messages = append(messages, response.ToParam()) response, err = client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{}}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } } fmt.Println(response) ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; import com.anthropic.models.beta.messages.BetaStopReason; // ... AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addBeta("compact-2026-01-12") .addUserMessage("Help me build a website") .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder() .pauseAfterCompaction(true) .build()) .build()) .build(); BetaMessage response = client.beta().messages().create(params); // Проверяем, вызвало ли сжатие контекста (compaction) паузу if (response.stopReason().isPresent() && response.stopReason().get().equals(BetaStopReason.COMPACTION)) { // Добавляем блок сжатия и продолжаем запрос // путём создания нового запроса со сжатым контекстом MessageCreateParams continueParams = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addBeta("compact-2026-01-12") .addUserMessage("Help me build a website") .addMessage(response) .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder().build()) .build()) .build(); response = client.beta().messages().create(continueParams); } System.out.println(response); ``` ```php PHP $client = new Client(); $messages = [['role' => 'user', 'content' => 'Hello, Claude']]; $response = $client->beta->messages->create( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ [ 'type' => 'compact_20260112', 'pause_after_compaction' => true ] ] ] ); if ($response->stopReason === 'compaction') { $messages[] = [ 'role' => 'assistant', 'content' => $response->content ]; $response = $client->beta->messages->create( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ ['type' => 'compact_20260112'] ] ] ); } echo $response; ``` ```ruby Ruby client = Anthropic::Client.new messages = [{ role: "user", content: "Hello, Claude" }] response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [ { type: "compact_20260112", pause_after_compaction: true } ] } ) if response.stop_reason == :compaction messages << { role: "assistant", content: response.content } response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [{ type: "compact_20260112" }] } ) end puts response ``` #### Соблюдение общего бюджета токенов Когда модель работает над длительными задачами с множеством итераций использования инструментов, общее потребление токенов может значительно возрасти. Вы можете сочетать `pause_after_compaction` со счётчиком сжатий, чтобы оценивать совокупное использование и корректно завершать задачу при достижении бюджета. Этот пример приведён только для языков SDK: его ценность — в логике отслеживания бюджета вокруг запроса. Сам запрос сочетает `trigger` из раздела [Настройка триггера](https://platform.claude.com/docs/ru/build-with-claude/compaction-threshold#trigger-configuration) с `pause_after_compaction` из раздела [Пауза после сжатия](https://platform.claude.com/docs/ru/build-with-claude/compaction-threshold#pausing-after-compaction). ```python Python client = anthropic.Anthropic() messages = [{"role": "user", "content": "Hello, Claude"}] TRIGGER_THRESHOLD = 100_000 TOTAL_TOKEN_BUDGET = 3_000_000 n_compactions = 0 response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages, context_management={ "edits": [ { "type": "compact_20260112", "trigger": {"type": "input_tokens", "value": TRIGGER_THRESHOLD}, "pause_after_compaction": True, } ] }, ) if response.stop_reason == "compaction": n_compactions += 1 messages.append({"role": "assistant", "content": response.content}) # Оценить общее число израсходованных токенов; при превышении бюджета предложить завершить работу if n_compactions * TRIGGER_THRESHOLD >= TOTAL_TOKEN_BUDGET: messages.append( { "role": "user", "content": "Please wrap up your current work and summarize the final state.", } ) ``` ```typescript TypeScript const client = new Anthropic(); const messages: Anthropic.Beta.Messages.BetaMessageParam[] = [ { role: "user", content: "Hello, Claude" } ]; const TRIGGER_THRESHOLD = 100_000; const TOTAL_TOKEN_BUDGET = 3_000_000; let compactionCount = 0; const response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages, context_management: { edits: [ { type: "compact_20260112", trigger: { type: "input_tokens", value: TRIGGER_THRESHOLD }, pause_after_compaction: true } ] } }); if (response.stop_reason === "compaction") { compactionCount += 1; messages.push({ role: "assistant", content: response.content }); // Оценить общее число израсходованных токенов; при превышении бюджета предложить завершить работу if (compactionCount * TRIGGER_THRESHOLD >= TOTAL_TOKEN_BUDGET) { messages.push({ role: "user", content: "Please wrap up your current work and summarize the final state." }); } } ``` ```csharp C# AnthropicClient client = new(); List messages = [new() { Role = Role.User, Content = "Hello, Claude" }]; const int TriggerThreshold = 100_000; const int TotalTokenBudget = 3_000_000; int compactionCount = 0; var response = await client.Beta.Messages.Create(new() { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit { Trigger = new BetaInputTokensTrigger(TriggerThreshold), PauseAfterCompaction = true }] } }); if (response.StopReason == BetaStopReason.Compaction) { compactionCount += 1; messages.Add(new() { Role = Role.Assistant, Content = response.Content.Select(b => new BetaContentBlockParam(b.Json)).ToList() }); // Оценить общее число израсходованных токенов; при превышении бюджета побудить к завершению if (compactionCount * TriggerThreshold >= TotalTokenBudget) { messages.Add(new() { Role = Role.User, Content = "Please wrap up your current work and summarize the final state." }); } } Console.WriteLine(response); ``` ```go Go client := anthropic.NewClient() messages := []anthropic.BetaMessageParam{anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude"))} const triggerThreshold = 100_000 const totalTokenBudget = 3_000_000 compactionCount := 0 response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{ Trigger: anthropic.BetaInputTokensTriggerParam{Value: triggerThreshold}, PauseAfterCompaction: anthropic.Bool(true), }}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } if response.StopReason == "compaction" { compactionCount++ messages = append(messages, response.ToParam()) // Оценить общее число израсходованных токенов; при превышении бюджета попросить завершить работу if compactionCount*triggerThreshold >= totalTokenBudget { messages = append(messages, anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Please wrap up your current work and summarize the final state."))) } } fmt.Println(response) ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; import com.anthropic.models.beta.messages.BetaInputTokensTrigger; import com.anthropic.models.beta.messages.BetaStopReason; // ... AnthropicClient client = AnthropicOkHttpClient.fromEnv(); long triggerThreshold = 100_000; long totalTokenBudget = 3_000_000; int compactionCount = 0; List messages = new ArrayList<>(); messages.add(BetaMessageParam.builder() .role(BetaMessageParam.Role.USER) .content("Hello, Claude") .build()); MessageCreateParams params = MessageCreateParams.builder() .addBeta("compact-2026-01-12") .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .messages(messages) .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder() .trigger(BetaInputTokensTrigger.builder() .value(triggerThreshold) .build()) .pauseAfterCompaction(true) .build()) .build()) .build(); BetaMessage response = client.beta().messages().create(params); if (response.stopReason().isPresent() && response.stopReason().get().equals(BetaStopReason.COMPACTION)) { compactionCount += 1; messages.add(response.toParam()); // Оценить общее число израсходованных токенов; при превышении бюджета попросить завершить работу if (compactionCount * triggerThreshold >= totalTokenBudget) { messages.add(BetaMessageParam.builder() .role(BetaMessageParam.Role.USER) .content("Please wrap up your current work and summarize the final state.") .build()); } } System.out.println(response); ``` ```php PHP $client = new Client(); $triggerThreshold = 100_000; $totalTokenBudget = 3_000_000; $compactionCount = 0; $messages = [['role' => 'user', 'content' => 'Hello, Claude']]; $response = $client->beta->messages->create( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ [ 'type' => 'compact_20260112', 'trigger' => ['type' => 'input_tokens', 'value' => $triggerThreshold], 'pause_after_compaction' => true ] ] ] ); if ($response->stopReason === 'compaction') { $compactionCount += 1; $messages[] = ['role' => 'assistant', 'content' => $response->content]; // Оценить общее число израсходованных токенов; при превышении бюджета запросить завершение работы if ($compactionCount * $triggerThreshold >= $totalTokenBudget) { $messages[] = [ 'role' => 'user', 'content' => 'Please wrap up your current work and summarize the final state.' ]; } } ``` ```ruby Ruby client = Anthropic::Client.new messages = [{ role: "user", content: "Hello, Claude" }] TRIGGER_THRESHOLD = 100_000 TOTAL_TOKEN_BUDGET = 3_000_000 compaction_count = 0 response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [ { type: "compact_20260112", trigger: { type: "input_tokens", value: TRIGGER_THRESHOLD }, pause_after_compaction: true } ] } ) if response.stop_reason == :compaction compaction_count += 1 messages << { role: "assistant", content: response.content } # Оценить общее число израсходованных токенов; при превышении бюджета предложить завершить работу if compaction_count * TRIGGER_THRESHOLD >= TOTAL_TOKEN_BUDGET messages << { role: "user", content: "Please wrap up your current work and summarize the final state." } end end ``` ## Работа с блоками сжатия Когда срабатывает сжатие, API возвращает блок `compaction` в начале ответа ассистента. Длительный разговор может привести к нескольким сжатиям. Последний блок сжатия отражает итоговое состояние подсказки, заменяя предшествующее ему содержимое сгенерированной сводкой. ```json Output { "content": [ { "type": "compaction", "content": "Summary of the conversation: The user requested help building a web scraper..." }, { "type": "text", "text": "Based on our conversation so far..." } ] } ``` ### Обратная передача блоков сжатия Вы должны передавать блок `compaction` обратно в API в последующих запросах, чтобы продолжить разговор с сокращённой подсказкой. Самый простой подход — добавлять всё содержимое ответа к своим сообщениям: ```bash cURL # Содержимое ответа, включая блок сжатия (compaction), нужно вернуть в # API как ход ассистента в следующем запросе. Управлять таким списком сообщений # в разовой команде оболочки неудобно; полный процесс см. на вкладках CLI и SDK. # Первый запрос: curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Hello, Claude" } ], "context_management": { "edits": [ { "type": "compact_20260112" } ] } }' ``` ```bash CLI ant beta:messages create \ --beta compact-2026-01-12 \ --transform content \ --format jsonl <<'YAML' > content.json model: claude-opus-5-5 max_tokens: 4096 messages: - role: user content: Hello, Claude context_management: edits: - type: compact_20260112 YAML # Получив ответ с блоком сжатия (compaction), добавьте его как # ход ассистента и продолжите диалог ant beta:messages create --beta compact-2026-01-12 < { new() { Role = Role.User, Content = "Help me build a web scraper" } }; var response = await client.Beta.Messages.Create(new() { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit()] } }); messages.Add(new BetaMessageParam { Role = Role.Assistant, Content = response.Content.Select(block => new BetaContentBlockParam(block.Json)).ToList() }); messages.Add(new BetaMessageParam { Role = Role.User, Content = "Now add error handling" }); var nextResponse = await client.Beta.Messages.Create(new() { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit()] } }); Console.WriteLine(nextResponse); ``` ```go Go client := anthropic.NewClient() messages := []anthropic.BetaMessageParam{ anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Help me build a web scraper")), } compactEdit := anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{}}, }, } response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: compactEdit, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } messages = append(messages, response.ToParam()) messages = append(messages, anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Now add error handling"))) nextResponse, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: compactEdit, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } fmt.Println(nextResponse) ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; // ... AnthropicClient client = AnthropicOkHttpClient.fromEnv(); // Первый запрос BetaMessage response = client.beta().messages().create( MessageCreateParams.builder() .addBeta("compact-2026-01-12") .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addUserMessage("Help me build a web scraper") .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder().build()) .build()) .build()); // После получения ответа с блоком сжатия добавьте полное // содержимое (включая блоки сжатия) и продолжите диалог BetaMessage nextResponse = client.beta().messages().create( MessageCreateParams.builder() .addBeta("compact-2026-01-12") .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addUserMessage("Help me build a web scraper") .addMessage(response) .addUserMessage("Now add error handling") .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder().build()) .build()) .build()); System.out.println(nextResponse); ``` ```php PHP $client = new Client(); $messages = [ ['role' => 'user', 'content' => 'Help me build a web scraper'] ]; $response = $client->beta->messages->create( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [['type' => 'compact_20260112']] ] ); $messages[] = ['role' => 'assistant', 'content' => $response->content]; $messages[] = ['role' => 'user', 'content' => 'Now add error handling']; $nextResponse = $client->beta->messages->create( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [['type' => 'compact_20260112']] ] ); echo json_encode($nextResponse, JSON_PRETTY_PRINT), PHP_EOL; ``` ```ruby Ruby client = Anthropic::Client.new messages = [ { role: "user", content: "Help me build a web scraper" } ] response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [{ type: "compact_20260112" }] } ) messages << { role: "assistant", content: response.content } messages << { role: "user", content: "Now add error handling" } next_response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [{ type: "compact_20260112" }] } ) puts next_response.content ``` В Python используйте `client.beta.messages`, как это сделано в примерах на этой странице. Если вы вызываете `client.messages` и сериализуете блоки самостоятельно, обычный `model_dump()` добавляет `text: null` и `citations: null` в блок `compaction`. В этом случае API отклоняет запрос с ошибкой 400 (`Extra inputs are not permitted`). Вместо этого используйте `to_dict()` или `model_dump(exclude_none=True)`. В разделе [Продолжение со сводки](https://platform.claude.com/docs/ru/build-with-claude/compaction-on-demand#continue-from-the-summary) даётся такой же совет для сжатия по запросу. Когда API получает блок `compaction`, все блоки содержимого перед ним игнорируются. Вы можете: * Оставить исходные сообщения в своём списке и позволить API самостоятельно удалить сжатое содержимое * Вручную удалить сжатые сообщения и включать только содержимое, начиная с блока сжатия В моделях Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5, Claude Sonnet 5.5 и Claude Haiku 5.5 блоки размышлений, предшествующие блоку `compaction`, не переносятся дальше, поэтому сводка — это всё, что остаётся у модели от той более ранней работы. Если вы пишете собственные `instructions`, укажите модели, что должна сохранить сводка; см. [Укажите модели, что сохранять в сводках сжатия](https://platform.claude.com/docs/ru/build-with-claude/prompt-engineering/prompting-claude-fable-5-1#tell-the-model-what-to-preserve-in-compaction-summaries). ### Потоковая передача Блок сжатия передаётся в потоке иначе, чем текстовые блоки. Вы получаете событие `content_block_start`, за которым следует одно событие `content_block_delta` с полным содержимым сводки (без промежуточной потоковой передачи), а затем событие `content_block_stop`. ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "stream": true, "messages": [ { "role": "user", "content": "Hello, Claude" } ], "context_management": { "edits": [ { "type": "compact_20260112" } ] } }' ``` ```bash CLI ant beta:messages create \ --stream \ --beta compact-2026-01-12 \ --format jsonl <<'YAML' model: claude-opus-5-5 max_tokens: 4096 messages: - role: user content: Hello, Claude context_management: edits: - type: compact_20260112 YAML ``` ```python Python client = anthropic.Anthropic() messages = [{"role": "user", "content": "Hello, Claude"}] with client.beta.messages.stream( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages, context_management={"edits": [{"type": "compact_20260112"}]}, ) as stream: for event in stream: match event.type: case "content_block_start": block = event.content_block match block.type: case "compaction": print("Compaction started...") case "text": print("Text response started...") case "content_block_delta": delta = event.delta match delta.type: case "compaction_delta": print(f"Compaction complete: {len(delta.content or '')} chars") case "text_delta": print(delta.text, end="", flush=True) # Получить итоговое накопленное сообщение message = stream.get_final_message() messages.append({"role": "assistant", "content": message.content}) ``` ```typescript TypeScript const client = new Anthropic(); const messages: Anthropic.Beta.Messages.BetaMessageParam[] = [ { role: "user", content: "Hello, Claude" } ]; const stream = await client.beta.messages.stream({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages, context_management: { edits: [{ type: "compact_20260112" }] } }); for await (const event of stream) { switch (event.type) { case "content_block_start": switch (event.content_block.type) { case "compaction": console.log("Compaction started..."); break; case "text": console.log("Text response started..."); break; } break; case "content_block_delta": switch (event.delta.type) { case "compaction_delta": console.log(`Compaction complete: ${event.delta.content?.length ?? 0} chars`); break; case "text_delta": process.stdout.write(event.delta.text); break; } break; } } // Получить итоговое накопленное сообщение const message = await stream.finalMessage(); messages.push({ role: "assistant", content: message.content }); ``` ```csharp C# var client = new AnthropicClient(); List messages = [new() { Role = Role.User, Content = "Hello" }]; var parameters = new MessageCreateParams { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit()] } }; await foreach (var streamEvent in client.Beta.Messages.CreateStreaming(parameters)) { if (streamEvent.TryPickContentBlockStart(out var startEvent)) { if (startEvent.ContentBlock.TryPickBetaCompaction(out _)) { Console.WriteLine("Compaction started..."); } else if (startEvent.ContentBlock.TryPickBetaText(out _)) { Console.WriteLine("Text response started..."); } } else if (streamEvent.TryPickContentBlockDelta(out var deltaEvent)) { if (deltaEvent.Delta.TryPickCompaction(out var compactionDelta)) { Console.WriteLine($"Compaction complete: {compactionDelta.Content?.Length ?? 0} chars"); } else if (deltaEvent.Delta.TryPickText(out var textDelta)) { Console.Write(textDelta.Text); } } } ``` ```go Go client := anthropic.NewClient() messages := []anthropic.BetaMessageParam{anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude"))} stream := client.Beta.Messages.NewStreaming(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{}}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) for stream.Next() { event := stream.Current() switch eventVariant := event.AsAny().(type) { case anthropic.BetaRawContentBlockStartEvent: switch eventVariant.ContentBlock.AsAny().(type) { case anthropic.BetaCompactionBlock: fmt.Println("Compaction started...") case anthropic.BetaTextBlock: fmt.Println("Text response started...") } case anthropic.BetaRawContentBlockDeltaEvent: switch deltaVariant := eventVariant.Delta.AsAny().(type) { case anthropic.BetaCompactionContentBlockDelta: fmt.Printf("Compaction complete: %d chars\n", len(deltaVariant.Content)) case anthropic.BetaTextDelta: fmt.Print(deltaVariant.Text) } } } if err := stream.Err(); err != nil { log.Fatal(err) } ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; // ... AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addBeta("compact-2026-01-12") .addUserMessage("Hello, Claude") .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder().build()) .build()) .build(); try (var streamResponse = client.beta().messages().createStreaming(params)) { streamResponse.stream().forEach(event -> { event.contentBlockStart().ifPresent(startEvent -> { startEvent.contentBlock().compaction().ifPresent(c -> System.out.println("Compaction started...") ); startEvent.contentBlock().text().ifPresent(t -> System.out.println("Text response started...") ); }); event.contentBlockDelta().ifPresent(deltaEvent -> { deltaEvent.delta().compaction().ifPresent(cd -> System.out.println("Compaction complete: " + cd.content().map(String::length).orElse(0) + " chars") ); deltaEvent.delta().text().ifPresent(td -> System.out.print(td.text()) ); }); }); } ``` ```php PHP use Anthropic\Beta\Messages\BetaCompactionBlock; use Anthropic\Beta\Messages\BetaCompactionContentBlockDelta; use Anthropic\Beta\Messages\BetaRawContentBlockDeltaEvent; use Anthropic\Beta\Messages\BetaRawContentBlockStartEvent; use Anthropic\Beta\Messages\BetaTextBlock; use Anthropic\Beta\Messages\BetaTextDelta; $client = new Client(); $messages = [['role' => 'user', 'content' => 'Hello, Claude']]; $stream = $client->beta->messages->createStream( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ ['type' => 'compact_20260112'] ] ] ); foreach ($stream as $event) { switch (true) { case $event instanceof BetaRawContentBlockStartEvent: switch (true) { case $event->contentBlock instanceof BetaCompactionBlock: echo "Compaction started...\n"; break; case $event->contentBlock instanceof BetaTextBlock: echo "Text response started...\n"; break; } break; case $event instanceof BetaRawContentBlockDeltaEvent: switch (true) { case $event->delta instanceof BetaCompactionContentBlockDelta: echo "Compaction complete: " . strlen($event->delta->content ?? '') . " chars\n"; break; case $event->delta instanceof BetaTextDelta: echo $event->delta->text; break; } break; } } ``` ```ruby Ruby client = Anthropic::Client.new messages = [{ role: "user", content: "Hello, Claude" }] stream = client.beta.messages.stream( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [{ type: "compact_20260112" }] } ) stream.each do |event| case event when Anthropic::Models::BetaRawContentBlockStartEvent case event.content_block when Anthropic::Models::BetaCompactionBlock puts "Compaction started..." when Anthropic::Models::BetaTextBlock puts "Text response started..." end when Anthropic::Models::BetaRawContentBlockDeltaEvent delta = event.delta case delta when Anthropic::Models::BetaCompactionContentBlockDelta puts "Compaction complete: #{(delta.content || "").length} chars" when Anthropic::Models::BetaTextDelta print delta.text end end end ``` ### Кэширование подсказок Сжатие хорошо сочетается с [«prompt caching» (кэшированием подсказок)](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching). Вы можете добавить точку останова `cache_control` в блоки сжатия, чтобы кэшировать суммированное содержимое. ```json { "role": "assistant", "content": [ { "type": "compaction", "content": "[summary text]", "cache_control": { "type": "ephemeral" } }, { "type": "text", "text": "Based on our conversation..." } ] } ``` #### Максимизация попаданий в кэш с системными подсказками Когда происходит сжатие, сводка становится новым содержимым, которое необходимо записать в кэш. Без дополнительных точек останова кэша это также сделало бы недействительной любую кэшированную «system prompt» (системную подсказку), и её пришлось бы кэшировать заново вместе со сводкой сжатия. Чтобы максимизировать частоту попаданий в кэш, добавьте точку останова `cache_control` в конце вашей системной подсказки. Это позволяет кэшировать системную подсказку отдельно от разговора, поэтому при сжатии: * Кэш системной подсказки остаётся действительным и считывается из кэша * Только сводку сжатия нужно записать как новую запись кэша ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "system": [ { "type": "text", "text": "You are a helpful coding assistant...", "cache_control": { "type": "ephemeral" } } ], "messages": [ { "role": "user", "content": "Hello, Claude" } ], "context_management": { "edits": [ { "type": "compact_20260112" } ] } }' ``` ```bash CLI ant beta:messages create --beta compact-2026-01-12 <<'YAML' model: claude-opus-5-5 max_tokens: 4096 system: - type: text text: You are a helpful coding assistant... cache_control: type: ephemeral messages: - role: user content: Hello, Claude context_management: edits: - type: compact_20260112 YAML ``` ```python Python client = anthropic.Anthropic() messages = [{"role": "user", "content": "Hello, Claude"}] response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, system=[ { "type": "text", "text": "You are a helpful coding assistant...", "cache_control": { "type": "ephemeral" }, # Cache the system prompt separately } ], messages=messages, context_management={"edits": [{"type": "compact_20260112"}]}, ) ``` ```typescript TypeScript const client = new Anthropic(); const messages: Anthropic.Beta.Messages.BetaMessageParam[] = [ { role: "user", content: "Hello, Claude" } ]; const response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, system: [ { type: "text", text: "You are a helpful coding assistant...", cache_control: { type: "ephemeral" } // Cache the system prompt separately } ], messages, context_management: { edits: [{ type: "compact_20260112" }] } }); ``` ```csharp C# var client = new AnthropicClient(); var parameters = new MessageCreateParams { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, System = new List { new() { Text = "You are a helpful coding assistant...", CacheControl = new BetaCacheControlEphemeral() } }, Messages = [new() { Role = Role.User, Content = "Hello, Claude" }], ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit()] } }; var response = await client.Beta.Messages.Create(parameters); Console.WriteLine(response); ``` ```go Go client := anthropic.NewClient() response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, System: []anthropic.BetaTextBlockParam{ { Text: "You are a helpful coding assistant...", CacheControl: anthropic.NewBetaCacheControlEphemeralParam(), }, }, Messages: []anthropic.BetaMessageParam{anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude"))}, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{}}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } fmt.Println(response) ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; import com.anthropic.models.beta.messages.BetaCacheControlEphemeral; // ... AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .addBeta("compact-2026-01-12") .systemOfBetaTextBlockParams(List.of( BetaTextBlockParam.builder() .text("You are a helpful coding assistant...") .cacheControl(BetaCacheControlEphemeral.builder().build()) .build() )) .addUserMessage("Hello, Claude") .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder().build()) .build()) .build(); BetaMessage response = client.beta().messages().create(params); System.out.println(response); ``` ```php PHP $client = new Client(); $response = $client->beta->messages->create( maxTokens: 4096, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], system: [ [ 'type' => 'text', 'text' => 'You are a helpful coding assistant...', 'cache_control' => [ 'type' => 'ephemeral' ] ] ], contextManagement: [ 'edits' => [ ['type' => 'compact_20260112'] ] ] ); echo json_encode($response, JSON_PRETTY_PRINT), PHP_EOL; ``` ```ruby Ruby client = Anthropic::Client.new response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, system: [ { type: "text", text: "You are a helpful coding assistant...", cache_control: { type: "ephemeral" } } ], messages: [{ role: "user", content: "Hello, Claude" }], context_management: { edits: [{ type: "compact_20260112" }] } ) puts response ``` Это позволяет сохранять длинные системные подсказки в кэше на протяжении нескольких событий сжатия в ходе разговора. ## Понимание использования Сжатие требует дополнительного шага сэмплирования, который учитывается в «rate limits» (ограничениях скорости) и при выставлении счетов. API возвращает подробную информацию об использовании в ответе: ```json Output { "usage": { "input_tokens": 23000, "output_tokens": 1000, "iterations": [ { "type": "compaction", "input_tokens": 180000, "output_tokens": 3500 }, { "type": "message", "input_tokens": 23000, "output_tokens": 1000 } ] } } ``` Массив `iterations` показывает использование для каждой итерации сэмплирования. Когда происходит сжатие, вы увидите итерацию `compaction`, за которой следует основная итерация `message`. В этом примере значения `input_tokens` и `output_tokens` верхнего уровня в точности совпадают с итерацией `message`, поскольку существует только одна итерация, не связанная со сжатием. Количество токенов в последней итерации отражает эффективный размер контекста после сжатия. Значения `input_tokens` и `output_tokens` верхнего уровня не включают использование итераций сжатия. Они отражают сумму всех итераций, не связанных со сжатием. Чтобы рассчитать общее количество потреблённых и оплачиваемых токенов для запроса, просуммируйте все записи в массиве `usage.iterations`. Если ранее вы полагались на `usage.input_tokens` и `usage.output_tokens` для отслеживания затрат или аудита, вам потребуется обновить логику отслеживания, чтобы при включённом сжатии агрегировать данные по `usage.iterations`. При включённой бета-версии сжатия каждый ответ содержит `usage.iterations`, даже если сжатие не произошло. Запись `compaction` появляется только тогда, когда во время запроса срабатывает новое сжатие. Повторное применение предыдущего блока `compaction` не влечёт дополнительных затрат на сжатие, и в этом случае поля использования верхнего уровня остаются точными. ## Сочетание с другими функциями ### Серверные инструменты При использовании серверных инструментов (например, веб-поиска) триггер сжатия проверяется в начале каждой итерации сэмплирования. В зависимости от порога срабатывания и объёма сгенерированного вывода сжатие может происходить несколько раз в рамках одного запроса. ### Подсчёт токенов Конечная точка подсчёта токенов (`/v1/messages/count_tokens`) применяет существующие блоки `compaction` в вашей подсказке, но не запускает новые сжатия. Используйте её, чтобы проверить эффективное количество токенов после предыдущих сжатий: ```bash cURL curl https://api.anthropic.com/v1/messages/count_tokens \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "messages": [ { "role": "user", "content": "Hello, Claude" } ], "context_management": { "edits": [ { "type": "compact_20260112" } ] } }' ``` ```bash CLI CURRENT=$(ant beta:messages count-tokens \ --beta compact-2026-01-12 \ --transform input_tokens \ --raw-output <<'YAML' model: claude-opus-5-5 messages: - role: user content: Hello, Claude context_management: edits: - type: compact_20260112 YAML ) ORIGINAL=$(ant beta:messages count-tokens \ --beta compact-2026-01-12 \ --transform context_management.original_input_tokens \ --raw-output <<'YAML' model: claude-opus-5-5 messages: - role: user content: Hello, Claude context_management: edits: - type: compact_20260112 YAML ) printf 'Current tokens: %s\n' "$CURRENT" printf 'Original tokens: %s\n' "$ORIGINAL" ``` ```python Python client = anthropic.Anthropic() messages = [{"role": "user", "content": "Hello, Claude"}] count_response = client.beta.messages.count_tokens( betas=["compact-2026-01-12"], model="claude-opus-5-5", messages=messages, context_management={"edits": [{"type": "compact_20260112"}]}, ) print(f"Current tokens: {count_response.input_tokens}") print(f"Original tokens: {count_response.context_management.original_input_tokens}") ``` ```typescript TypeScript const client = new Anthropic(); const messages: Anthropic.Beta.Messages.BetaMessageParam[] = [ { role: "user", content: "Summarize the key points of our conversation so far." } ]; const countResponse = await client.beta.messages.countTokens({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", messages, context_management: { edits: [{ type: "compact_20260112" }] } }); console.log(`Current tokens: ${countResponse.input_tokens}`); console.log(`Original tokens: ${countResponse.context_management!.original_input_tokens}`); ``` ```csharp C# AnthropicClient client = new(); List messages = [new() { Role = Role.User, Content = "Hello" }]; var countParams = new MessageCountTokensParams { Model = Model.ClaudeOpus5_5, Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit()] }, Betas = ["compact-2026-01-12"] }; var countResponse = await client.Beta.Messages.CountTokens(countParams); Console.WriteLine($"Current tokens: {countResponse.InputTokens}"); Console.WriteLine($"Original tokens: {countResponse.ContextManagement?.OriginalInputTokens}"); ``` ```go Go client := anthropic.NewClient() messages := []anthropic.BetaMessageParam{anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude"))} countResponse, err := client.Beta.Messages.CountTokens(context.TODO(), anthropic.BetaMessageCountTokensParams{ Model: anthropic.ModelClaudeOpus5_5, Messages: messages, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{}}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } fmt.Printf("Current tokens: %d\n", countResponse.InputTokens) fmt.Printf("Original tokens: %d\n", countResponse.ContextManagement.OriginalInputTokens) ``` ```java Java import com.anthropic.models.beta.messages.BetaMessageTokensCount; import com.anthropic.models.beta.messages.MessageCountTokensParams; import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; // ... AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCountTokensParams params = MessageCountTokensParams.builder() .model(Model.CLAUDE_OPUS_5_5) .addUserMessage("Hello, Claude") .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder().build()) .build()) .addBeta("compact-2026-01-12") .build(); BetaMessageTokensCount countResponse = client.beta().messages().countTokens(params); System.out.println("Current tokens: " + countResponse.inputTokens()); System.out.println("Original tokens: " + countResponse.contextManagement().get().originalInputTokens()); ``` ```php PHP $client = new Client(); $messages = [['role' => 'user', 'content' => 'Hello, Claude']]; $countResponse = $client->beta->messages->countTokens( messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ ['type' => 'compact_20260112'] ] ] ); echo "Current tokens: " . $countResponse->inputTokens . "\n"; echo "Original tokens: " . $countResponse->contextManagement->originalInputTokens . "\n"; ``` ```ruby Ruby client = Anthropic::Client.new messages = [{ role: "user", content: "Hello, Claude" }] count_response = client.beta.messages.count_tokens( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", messages: messages, context_management: { edits: [{ type: "compact_20260112" }] } ) puts "Current tokens: #{count_response.input_tokens}" puts "Original tokens: #{count_response.context_management.original_input_tokens}" ``` ## Примеры Вот полный пример длительного разговора со сжатием: ```bash cURL # curl отправляет отдельные запросы; массив messages поддерживайте в # вызывающем скрипте. Полный цикл chat() см. на вкладках SDK. Формат # однократного запроса: curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Help me build a Python web scraper" } ], "context_management": { "edits": [ { "type": "compact_20260112", "trigger": { "type": "input_tokens", "value": 100000 } } ] } }' ``` ```bash CLI # CLI обрабатывает отдельные ходы; массив messages ведите в # вызывающем скрипте. Полный цикл chat() см. на вкладках SDK. Формат # однократного запроса: ant beta:messages create \ --beta compact-2026-01-12 \ --transform 'content.#(type=="text").text' \ --raw-output <<'YAML' model: claude-opus-5-5 max_tokens: 4096 messages: - role: user content: Help me build a Python web scraper context_management: edits: - type: compact_20260112 trigger: type: input_tokens value: 100000 YAML ``` ```python Python client = anthropic.Anthropic() messages: list[dict] = [] def chat(user_message: str) -> str: messages.append({"role": "user", "content": user_message}) response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages, context_management={ "edits": [ { "type": "compact_20260112", "trigger": {"type": "input_tokens", "value": 100000}, } ] }, ) # Добавляем ответ (блоки сжатия включаются автоматически) messages.append({"role": "assistant", "content": response.content}) # Возвращаем текстовое содержимое return next(block.text for block in response.content if block.type == "text") # Запускаем длинный диалог print(chat("Help me build a Python web scraper")) print(chat("Add support for JavaScript-rendered pages")) print(chat("Now add rate limiting and error handling")) # Продолжайте вызывать chat() столько, сколько требуется диалогу ``` ```typescript TypeScript const client = new Anthropic(); const messages: Anthropic.Beta.Messages.BetaMessageParam[] = []; async function chat(userMessage: string): Promise { messages.push({ role: "user", content: userMessage }); const response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages, context_management: { edits: [ { type: "compact_20260112", trigger: { type: "input_tokens", value: 100000 } } ] } }); // Добавляем ответ (блоки сжатия включаются автоматически) messages.push({ role: "assistant", content: response.content }); // Возвращаем текстовое содержимое const textBlock = response.content.find((block) => block.type === "text"); return textBlock?.text ?? ""; } // Запускаем длинный диалог console.log(await chat("Help me build a Python web scraper")); console.log(await chat("Add support for JavaScript-rendered pages")); console.log(await chat("Now add rate limiting and error handling")); // Продолжайте вызывать chat() столько, сколько требуется для диалога ``` ```csharp C# AnthropicClient client = new(); List messages = new(); Console.WriteLine(await Chat(client, messages, "Help me build a Python web scraper")); Console.WriteLine(await Chat(client, messages, "Add support for JavaScript-rendered pages")); Console.WriteLine(await Chat(client, messages, "Now add rate limiting and error handling")); static async Task Chat(AnthropicClient client, List messages, string userMessage) { messages.Add(new() { Role = Role.User, Content = userMessage }); var parameters = new MessageCreateParams { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit { Trigger = new BetaInputTokensTrigger(100000) }] } }; var response = await client.Beta.Messages.Create(parameters); messages.Add(new() { Role = Role.Assistant, Content = response.Content.Select(block => new BetaContentBlockParam(block.Json)).ToList() }); return response.Content .Select(block => block.Value) .OfType() .Select(tb => tb.Text) .FirstOrDefault() ?? ""; } ``` ```go Go package main import ( "context" "fmt" "log" "github.com/anthropics/anthropic-sdk-go" ) var ( client = anthropic.NewClient() messages []anthropic.BetaMessageParam ) func chat(userMessage string) string { messages = append(messages, anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock(userMessage))) response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{ Trigger: anthropic.BetaInputTokensTriggerParam{Value: 100000}, }}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } messages = append(messages, response.ToParam()) for _, block := range response.Content { if variant, ok := block.AsAny().(anthropic.BetaTextBlock); ok { return variant.Text } } return "" } func main() { fmt.Println(chat("Help me build a Python web scraper")) fmt.Println(chat("Add support for JavaScript-rendered pages")) fmt.Println(chat("Now add rate limiting and error handling")) } ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; import com.anthropic.models.beta.messages.BetaInputTokensTrigger; // ... private static final AnthropicClient client = AnthropicOkHttpClient.fromEnv(); private static final List messages = new ArrayList<>(); public static void main(String[] args) { System.out.println(chat("Help me build a Python web scraper")); System.out.println(chat("Add support for JavaScript-rendered pages")); System.out.println(chat("Now add rate limiting and error handling")); } private static String chat(String userMessage) { messages.add(BetaMessageParam.builder() .role(BetaMessageParam.Role.USER) .content(userMessage) .build()); MessageCreateParams params = MessageCreateParams.builder() .addBeta("compact-2026-01-12") .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .messages(messages) .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder() .trigger(BetaInputTokensTrigger.builder() .value(100000L) .build()) .build()) .build()) .build(); BetaMessage response = client.beta().messages().create(params); // Добавляем ответ (блоки сжатия включаются автоматически) messages.add(response.toParam()); return response.content().stream() .filter(block -> block.text().isPresent()) .map(block -> block.text().get().text()) .findFirst() .orElse(""); } ``` ```php PHP $client = new Client(); $messages = []; function chat($client, &$messages, $userMessage) { $messages[] = ['role' => 'user', 'content' => $userMessage]; $response = $client->beta->messages->create( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ [ 'type' => 'compact_20260112', 'trigger' => ['type' => 'input_tokens', 'value' => 100000] ] ] ] ); $messages[] = ['role' => 'assistant', 'content' => $response->content]; foreach ($response->content as $block) { if ($block->type === 'text') { return $block->text; } } return ''; } echo chat($client, $messages, "Help me build a Python web scraper") . "\n"; echo chat($client, $messages, "Add support for JavaScript-rendered pages") . "\n"; echo chat($client, $messages, "Now add rate limiting and error handling") . "\n"; ``` ```ruby Ruby client = Anthropic::Client.new messages = [] def chat(client, messages, user_message) messages << { role: "user", content: user_message } response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [ { type: "compact_20260112", trigger: { type: "input_tokens", value: 100000 } } ] } ) messages << { role: "assistant", content: response.content } response.content.find { |block| block.type == :text }&.text || "" end puts chat(client, messages, "Help me build a Python web scraper") puts chat(client, messages, "Add support for JavaScript-rendered pages") puts chat(client, messages, "Now add rate limiting and error handling") ``` В моделях Claude Fable 5.1, Claude Opus 5.5, Claude Sonnet 5.5 и Claude Haiku 5.5 удаляйте блоки `thinking` и `redacted_thinking` из любого хода ассистента, который вы повторно вставляете после блока сжатия, или отправляйте `thinking.block_binding.prefix_mismatch_behavior: "drop_block"` вместе с [бета-заголовком](https://platform.claude.com/docs/ru/api/beta-headers) `thinking-binding-controls-2026-08-01`. Эти блоки были созданы, когда присутствовала полная история, поэтому они больше не проходят [проверку разговора](https://platform.claude.com/docs/ru/build-with-claude/thinking#preserved-in-conversation). Там, где эта проверка применяется, запрос на продолжение отклоняется с ошибкой 400. Сохранённые текстовые блоки и блоки инструментов можно оставить как есть. Этого можно избежать, если позволить API суммировать всё, не вставляя повторно более ранние ходы. В Claude Sonnet 5.5 `block_binding` работает только с `thinking: {"type": "adaptive"}`. При `between_tools` вместо этого удаляйте блоки. В Claude Haiku 5.5 `block_binding` работает только с `thinking: {"type": "adaptive"}`, поэтому при `thinking: {"type": "disabled"}` вместо этого удаляйте блоки. Вот пример, в котором `pause_after_compaction` используется для сохранения предыдущего обмена репликами и текущего сообщения пользователя (всего три сообщения) вместо их суммирования. Он оставляет их текстовые блоки и блоки инструментов без изменений, удаляет блоки `thinking` и `redacted_thinking` из сохранённого хода ассистента и отбрасывает этот ход, если в нём больше ничего не осталось: ```bash cURL # curl отправляет отдельные запросы; поддерживайте массив messages в # вызывающем скрипте. Полный цикл chat() с обработкой паузы и сохранения см. во вкладках SDK. # Формат однократного запроса: curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: compact-2026-01-12" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [ { "role": "user", "content": "Help me build a Python web scraper" } ], "context_management": { "edits": [ { "type": "compact_20260112", "trigger": { "type": "input_tokens", "value": 100000 }, "pause_after_compaction": true } ] } }' ``` ```bash CLI # CLI обрабатывает отдельные ходы; массив messages ведите в # вызывающем скрипте. Полный цикл chat() с обработкой паузы и сохранения см. на # вкладках SDK. Формат однократного запроса: ant beta:messages create \ --beta compact-2026-01-12 \ --transform 'content.#(type=="text").text' \ --raw-output <<'YAML' model: claude-opus-5-5 max_tokens: 4096 messages: - role: user content: Help me build a Python web scraper context_management: edits: - type: compact_20260112 trigger: type: input_tokens value: 100000 pause_after_compaction: true YAML ``` ```python Python from typing import Any client = anthropic.Anthropic() messages: list[dict[str, Any]] = [] def chat(user_message: str) -> str: messages.append({"role": "user", "content": user_message}) response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages, context_management={ "edits": [ { "type": "compact_20260112", "trigger": {"type": "input_tokens", "value": 100000}, "pause_after_compaction": True, } ] }, ) # Проверяем, произошло ли сжатие контекста и была ли приостановлена обработка if response.stop_reason == "compaction": # Получаем блок сжатия из ответа compaction_block = response.content[0] # Сохраняем предыдущий обмен + текущее сообщение пользователя (3 сообщения) # включая их после блока сжатия, без блоков размышлений; # ход ассистента, оставшийся без содержимого, отбрасывается preserved_messages = [ { **message, "content": [ block for block in message["content"] if block.type not in ("thinking", "redacted_thinking") ], } if message["role"] == "assistant" else message for message in messages[-3:] ] preserved_messages = [m for m in preserved_messages if m["content"]] # Формируем новый список сообщений: сжатие + сохранённые сообщения new_assistant_content = [compaction_block] messages_after_compaction = [ {"role": "assistant", "content": new_assistant_content} ] + preserved_messages # Продолжаем запрос со сжатым контекстом + сохранёнными сообщениями response = client.beta.messages.create( betas=["compact-2026-01-12"], model="claude-opus-5-5", max_tokens=4096, messages=messages_after_compaction, context_management={"edits": [{"type": "compact_20260112"}]}, ) # Обновляем список сообщений с учётом сжатия messages.clear() messages.extend(messages_after_compaction) # Добавляем итоговый ответ messages.append({"role": "assistant", "content": response.content}) # Возвращаем текстовое содержимое return next(block.text for block in response.content if block.type == "text") # Запускаем длинный диалог print(chat("Help me build a Python web scraper")) print(chat("Add support for JavaScript-rendered pages")) print(chat("Now add rate limiting and error handling")) # Продолжаем вызывать chat() столько, сколько требуется диалогу ``` ```typescript TypeScript const client = new Anthropic(); let messages: Anthropic.Beta.Messages.BetaMessageParam[] = []; async function chat(userMessage: string): Promise { messages.push({ role: "user", content: userMessage }); let response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages, context_management: { edits: [ { type: "compact_20260112", trigger: { type: "input_tokens", value: 100000 }, pause_after_compaction: true } ] } }); // Проверяем, произошло ли сжатие контекста и была ли приостановка if (response.stop_reason === "compaction") { // Получаем блок сжатия из ответа const compactionBlock = response.content[0]; // Сохраняем предыдущий обмен + текущее сообщение пользователя (3 сообщения) // включая их после блока сжатия, без блоков размышлений; // ход ассистента, оставшийся без содержимого, отбрасывается const preservedMessages = messages .slice(-3) .map((message) => message.role === "assistant" && Array.isArray(message.content) ? { ...message, content: message.content.filter( (block) => block.type !== "thinking" && block.type !== "redacted_thinking" ) } : message ) .filter((message) => message.content.length > 0); // Формируем новый список сообщений: сжатие + сохранённые сообщения const messagesAfterCompaction: Anthropic.Beta.Messages.BetaMessageParam[] = [ { role: "assistant", content: [compactionBlock] }, ...preservedMessages ]; // Продолжаем запрос со сжатым контекстом + сохранёнными сообщениями response = await client.beta.messages.create({ betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messagesAfterCompaction, context_management: { edits: [{ type: "compact_20260112" }] } }); // Обновляем список сообщений с учётом сжатия messages = messagesAfterCompaction; } // Добавляем итоговый ответ messages.push({ role: "assistant", content: response.content }); // Возвращаем текстовое содержимое const textBlock = response.content.find((block) => block.type === "text"); return textBlock?.text ?? ""; } // Запускаем длинный диалог console.log(await chat("Help me build a Python web scraper")); console.log(await chat("Add support for JavaScript-rendered pages")); console.log(await chat("Now add rate limiting and error handling")); // Продолжайте вызывать chat() столько, сколько требуется диалогу ``` ```csharp C# AnthropicClient client = new(); List messages = new(); Console.WriteLine(await Chat("Help me build a Python web scraper")); Console.WriteLine(await Chat("Add support for JavaScript-rendered pages")); Console.WriteLine(await Chat("Now add rate limiting and error handling")); async Task Chat(string userMessage) { messages.Add(new() { Role = Role.User, Content = userMessage }); var response = await client.Beta.Messages.Create(new() { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = messages, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit { Trigger = new BetaInputTokensTrigger(100000), PauseAfterCompaction = true }] } }); if (response.StopReason == BetaStopReason.Compaction) { if (!response.Content[0].TryPickCompaction(out _)) throw new InvalidOperationException("Expected compaction block"); // Сохраняем предыдущий обмен + текущее сообщение пользователя (3 сообщения), // без блоков размышлений; пустой ход ассистента отбрасывается var preserved = messages .Skip(Math.Max(0, messages.Count - 3)) .Select(message => message.Content.TryPickBetaContentBlockParams(out var blocks) ? new BetaMessageParam { Role = message.Role, Content = blocks .Where(block => block.Type.GetString() is not ("thinking" or "redacted_thinking")) .ToList() } : message) .Where(message => !message.Content.TryPickBetaContentBlockParams(out var blocks) || blocks.Count > 0) .ToList(); var messagesAfterCompaction = new List { new() { Role = Role.Assistant, Content = new List { new BetaContentBlockParam(response.Content[0].Json) } } }; messagesAfterCompaction.AddRange(preserved); response = await client.Beta.Messages.Create(new() { Betas = ["compact-2026-01-12"], Model = Model.ClaudeOpus5_5, MaxTokens = 4096, Messages = messagesAfterCompaction, ContextManagement = new BetaContextManagementConfig { Edits = [new BetaCompact20260112Edit()] } }); messages = messagesAfterCompaction; } messages.Add(new() { Role = Role.Assistant, Content = response.Content.Select(block => new BetaContentBlockParam(block.Json)).ToList() }); return response.Content .Select(block => block.Value) .OfType() .Select(tb => tb.Text) .FirstOrDefault() ?? ""; } ``` ```go Go package main import ( "context" "fmt" "log" "github.com/anthropics/anthropic-sdk-go" ) var ( client = anthropic.NewClient() messages []anthropic.BetaMessageParam ) func chat(userMessage string) string { messages = append(messages, anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock(userMessage))) compactEdit := anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{ Trigger: anthropic.BetaInputTokensTriggerParam{Value: 100000}, PauseAfterCompaction: anthropic.Bool(true), }}, }, } response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messages, ContextManagement: compactEdit, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } if response.StopReason == "compaction" { compactionParam := response.Content[0].ToParam() // Сохраняем предыдущий обмен + текущее сообщение пользователя (3 сообщения), // без блоков размышлений; пустой ход ассистента отбрасывается var preserved []anthropic.BetaMessageParam for _, message := range messages[max(0, len(messages)-3):] { var content []anthropic.BetaContentBlockParamUnion for _, block := range message.Content { if block.OfThinking == nil && block.OfRedactedThinking == nil { content = append(content, block) } } if len(content) == 0 { continue } message.Content = content preserved = append(preserved, message) } messagesAfterCompaction := []anthropic.BetaMessageParam{ {Role: anthropic.BetaMessageParamRoleAssistant, Content: []anthropic.BetaContentBlockParamUnion{compactionParam}}, } messagesAfterCompaction = append(messagesAfterCompaction, preserved...) response, err = client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 4096, Messages: messagesAfterCompaction, ContextManagement: anthropic.BetaContextManagementConfigParam{ Edits: []anthropic.BetaContextManagementConfigEditUnionParam{ {OfCompact20260112: &anthropic.BetaCompact20260112EditParam{}}, }, }, Betas: []anthropic.AnthropicBeta{"compact-2026-01-12"}, }) if err != nil { log.Fatal(err) } messages = messagesAfterCompaction } messages = append(messages, response.ToParam()) for _, block := range response.Content { if textBlock, ok := block.AsAny().(anthropic.BetaTextBlock); ok { return textBlock.Text } } return "" } func main() { fmt.Println(chat("Help me build a Python web scraper")) fmt.Println(chat("Add support for JavaScript-rendered pages")) fmt.Println(chat("Now add rate limiting and error handling")) } ``` ```java Java import com.anthropic.models.beta.messages.BetaContextManagementConfig; import com.anthropic.models.beta.messages.BetaCompact20260112Edit; import com.anthropic.models.beta.messages.BetaInputTokensTrigger; import com.anthropic.models.beta.messages.BetaStopReason; // ... private static final AnthropicClient client = AnthropicOkHttpClient.fromEnv(); private static final List messages = new ArrayList<>(); public static String chat(String userMessage) { messages.add(BetaMessageParam.builder() .role(BetaMessageParam.Role.USER) .content(userMessage) .build()); MessageCreateParams params = MessageCreateParams.builder() .addBeta("compact-2026-01-12") .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .messages(messages) .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder() .trigger(BetaInputTokensTrigger.builder() .value(100000L) .build()) .pauseAfterCompaction(true) .build()) .build()) .build(); BetaMessage response = client.beta().messages().create(params); // Проверяем, произошло ли сжатие контекста и была ли приостановка if (response.stopReason().isPresent() && response.stopReason().get().equals(BetaStopReason.COMPACTION)) { // Сохраняем предыдущий обмен + текущее сообщение пользователя (3 сообщения), // без блоков размышлений; пустой ход ассистента отбрасывается List preservedMessages = new ArrayList<>(); for (BetaMessageParam message : messages.subList(Math.max(0, messages.size() - 3), messages.size())) { if (message.content().isBetaContentBlockParams()) { message = message.toBuilder() .contentOfBetaContentBlockParams(message.content().asBetaContentBlockParams().stream() .filter(block -> !block.isThinking() && !block.isRedactedThinking()) .toList()) .build(); if (message.content().asBetaContentBlockParams().isEmpty()) { continue; } } preservedMessages.add(message); } // Формируем новый список сообщений: сжатие + сохранённые сообщения List messagesAfterCompaction = new ArrayList<>(); messagesAfterCompaction.add(response.toParam()); messagesAfterCompaction.addAll(preservedMessages); // Продолжаем запрос со сжатым контекстом + сохранёнными сообщениями MessageCreateParams continueParams = MessageCreateParams.builder() .addBeta("compact-2026-01-12") .model(Model.CLAUDE_OPUS_5_5) .maxTokens(4096L) .messages(messagesAfterCompaction) .contextManagement(BetaContextManagementConfig.builder() .addEdit(BetaCompact20260112Edit.builder().build()) .build()) .build(); response = client.beta().messages().create(continueParams); // Обновляем список сообщений с учётом сжатия messages.clear(); messages.addAll(messagesAfterCompaction); } // Добавляем итоговый ответ messages.add(response.toParam()); return response.content().stream() .filter(block -> block.text().isPresent()) .map(block -> block.text().get().text()) .findFirst() .orElse(""); } public static void main(String[] args) { System.out.println(chat("Help me build a Python web scraper")); System.out.println(chat("Add support for JavaScript-rendered pages")); System.out.println(chat("Now add rate limiting and error handling")); } ``` ```php PHP $client = new Client(); $messages = []; function chat($client, &$messages, $userMessage) { $messages[] = ['role' => 'user', 'content' => $userMessage]; $response = $client->beta->messages->create( maxTokens: 4096, messages: $messages, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [ [ 'type' => 'compact_20260112', 'trigger' => ['type' => 'input_tokens', 'value' => 100000], 'pause_after_compaction' => true ] ] ] ); if ($response->stopReason === 'compaction') { $compactionBlock = $response->content[0]; // Сохраняем предыдущий обмен + текущее сообщение пользователя (3 сообщения), // без блоков размышлений; пустой ход ассистента отбрасывается $preserved = array_values(array_filter(array_map( fn($message) => $message['role'] === 'assistant' ? array_merge($message, ['content' => array_values(array_filter( $message['content'], fn($block) => !in_array($block->type, ['thinking', 'redacted_thinking'], true) ))]) : $message, array_slice($messages, -3) ), fn($message) => $message['content'] !== [])); $messagesAfterCompaction = array_merge( [['role' => 'assistant', 'content' => [$compactionBlock]]], $preserved ); $response = $client->beta->messages->create( maxTokens: 4096, messages: $messagesAfterCompaction, model: 'claude-opus-5-5', betas: ['compact-2026-01-12'], contextManagement: [ 'edits' => [['type' => 'compact_20260112']] ] ); $messages = $messagesAfterCompaction; } $messages[] = ['role' => 'assistant', 'content' => $response->content]; foreach ($response->content as $block) { if ($block->type === 'text') { return $block->text; } } return ''; } echo chat($client, $messages, "Help me build a Python web scraper") . "\n"; echo chat($client, $messages, "Add support for JavaScript-rendered pages") . "\n"; echo chat($client, $messages, "Now add rate limiting and error handling") . "\n"; ``` ```ruby Ruby client = Anthropic::Client.new messages = [] def chat(client, messages, user_message) messages << { role: "user", content: user_message } response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages, context_management: { edits: [ { type: "compact_20260112", trigger: { type: "input_tokens", value: 100000 }, pause_after_compaction: true } ] } ) if response.stop_reason == :compaction compaction_block = response.content[0] # Сохраняем предыдущий обмен + текущее сообщение пользователя (3 сообщения), # без блоков размышлений; пустой ход ассистента отбрасывается preserved = messages.last(3).map do |message| next message unless message[:role] == "assistant" message.merge(content: message[:content].reject { |block| %i[thinking redacted_thinking].include?(block.type) }) end.reject { |message| message[:content].empty? } messages_after_compaction = [ { role: "assistant", content: [compaction_block] } ] + preserved response = client.beta.messages.create( betas: ["compact-2026-01-12"], model: "claude-opus-5-5", max_tokens: 4096, messages: messages_after_compaction, context_management: { edits: [{ type: "compact_20260112" }] } ) messages.clear messages.concat(messages_after_compaction) end messages << { role: "assistant", content: response.content } response.content.find { |block| block.type == :text }&.text || "" end puts chat(client, messages, "Help me build a Python web scraper") puts chat(client, messages, "Add support for JavaScript-rendered pages") puts chat(client, messages, "Now add rate limiting and error handling") ``` ## Текущие ограничения * **Та же модель для суммаризации:** для суммаризации используется модель, указанная в вашем запросе. Возможности использовать для сводки другую (например, более дешёвую) модель нет. * **Сжатие может завершиться неудачей, если определены инструменты:** когда ваш запрос включает `tools`, модель иногда вызывает инструмент на внутреннем шаге суммаризации вместо того, чтобы написать сводку. В этом случае ответ содержит блок `compaction` с `content: null`. Чтобы предотвратить это, задайте в [`instructions`](https://platform.claude.com/docs/ru/build-with-claude/compaction-threshold#custom-summarization-instructions) подсказку, которая явно запрещает модели вызывать инструменты, например: ```text wrap Summarize the transcript inside tags. Include relevant information in the summary for continuing the task in the next context window. Do not call any tools while writing this summary; respond with text only. ``` ## Следующие шаги Автоматически управляйте контекстом разговора по мере его роста с помощью редактирования контекста. Узнайте о размерах контекстных окон и стратегиях управления ими. Изучите практическую реализацию, которая управляет длительными разговорами с помощью мгновенного сжатия памяти сеанса с использованием фоновых потоков и кэширования подсказок.