Claude Code 2.1.212: лимиты субагентов, автофон MCP и исправление кэширования на кастомных шлюзах

Версия 2.1.212 вводит настраиваемые лимиты субагентов и вызовов WebSearch на сессию, автоматически переносит долгие MCP-вызовы в фон и восстанавливает prompt caching за кастомными API gateway, Bedrock и Vertex.

Опубликовано источник Anthropic Claude Code

Архивный материал, подготовленный с помощью ИИ по указанному источнику и опубликованный без индивидуальной проверки. Ответственный редактор: Joe Werner.

Абстрактная схема маршрутизации с изображением контролей сессии и лимитов делегирования агентов
Машинный перевод с английского оригинала — читать оригинал

Дыра в управлении, позволявшая сессиям Claude Code плодить неограниченное число субагентов и бесконечно вызывать WebSearch, закрыта. В выпуске 2.1.212 появились два жёстких лимита на уровне сессии с возможностью тонкой настройки, реализован автоматический перенос долгих MCP-вызовов в фон, а также исправлено поведение prompt caching за кастомными API gateway — включая Bedrock и Vertex AI.

Ниже — разбор изменений и их значение для команд, эксплуатирующих Claude Code в продакшне.

Что произошло

Anthropic выпустила Claude Code 2.1.212 с четырьмя изменениями, критичными для операторов, плюс большим набором патчей стабильности:

  1. Лимит субагентов на сессию — по умолчанию 200 субагентов. Переопределяется через CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION. /clear сбрасывает счётчик бюджета.
  2. Лимит вызовов WebSearch — по умолчанию 200 вызовов на сессию. Переопределяется через CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION. Предотвращает неконтролируемые поисковые петли в длинных агентских прогонах.
  3. Автофон для MCP-вызовов — MCP-вызовы, выполняющиеся дольше 2 минут, автоматически переходят в фоновый режим, чтобы сессия оставалась доступной. Порог задаётся через CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS; значение 0 отключает функцию.
  4. Исправление prompt caching на кастомных шлюзах — mid-conversation system block теперь корректно кэшируется за LLM gateway и кастомными base URL, включая Bedrock и Vertex AI.

Также изменилось поведение /fork: теперь команда копирует разговор в отдельную фоновую сессию (видную в claude agents как отдельная строка), а не запускает субагент внутри текущей сессии. Прежнее поведение /fork перенесено в команду /subtask.

Два исправления с точки зрения безопасности:

  • Bash в плановом режиме — ошибка позволяла plan mode автоматически запускать деструктивные Bash-команды (touch, rm и другие) без запроса разрешения и без колбэка SDK canUseTool. Исправлено.
  • Выход за пределы репозитория через symlink — при создании worktree можно было перейти по закоммиченной symlink в .claude/worktrees и создать файлы вне репозитория. Исправлено.

Почему это важно для AI-инженерных команд

Управление неконтролируемыми агентами — главная тема выпуска. Когда Claude Code работает в многоагентном режиме — параллельные субагенты, рекурсивное делегирование, циклы глубокого поиска с WebSearch — неограниченная активность сессии напрямую превращается в неограниченные расходы на API и непредсказуемое время выполнения.

До 2.1.212 на уровне платформы не существовало механизма, ограничивающего число субагентов или WebSearch-вызовов в рамках одной сессии. Команды были вынуждены полагаться на учёт на уровне приложения или инжектировать ограничения бюджета в system prompt — оба подхода ломаются, когда агент выходит за рамки ожидаемого сценария.

Новые переменные окружения дают операторам настраиваемую страховку. Значения по умолчанию (200 для каждого лимита) достаточно либеральны, чтобы не мешать типовым рабочим потокам, и при этом достаточно жёстки, чтобы предотвратить экспоненциальное ветвление. Для операторов, маршрутизирующих Claude Code через gateway, где видимость затрат приходит с задержкой, — это контроль надёжности первого уровня.

Автофон MCP решает другой сценарий отказа: долгий MCP-вызов блокировал всю сессию. Для операторов, которые направляют MCP-вызовы к медленным внешним сервисам (обработка документов, запросы к БД, длинные оркестрационные вызовы), порог в 2 минуты предотвращает ситуацию, когда сессия выглядит зависшей. Командам, которым нужно детерминированное поведение или которые хотят отключить функцию для отладки, достаточно установить CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=0.

Взгляд с позиции router/operator

Исправление prompt caching — наиболее значимое для операторов шлюзов изменение, которое легко недооценить. Mid-conversation system block позволяет Claude Code инжектировать контекст в середине хода без повторной обработки, но до этого выпуска он молча не работал для команд, маршрутизирующих через кастомные base URL. Затронутые сценарии:

  • Операторы, направляющие запросы к Claude через самостоятельно развёрнутый AI gateway (LiteLLM proxy, TheRouter, кастомный endpoint Azure AI Foundry)
  • Команды, использующие Bedrock или Vertex AI с переопределённым base URL
  • Корпоративные развёртывания, где ANTHROPIC_BASE_URL указывает на внутренний прокси

До исправления каждый mid-conversation system message приводил к полной повторной обработке контекста. Исправление восстанавливает ожидаемое поведение кэширования. Если вы замечали аномально высокий расход токенов в сессиях Claude Code за gateway — обновление до 2.1.212 должно снизить этот показатель.

По переименованию /fork: если у вашей команды есть shell-скрипты, CI-пайплайны или автоматизация, которая вызывает /fork и ожидает получить субагент внутри текущей сессии, — теперь эти скрипты будут создавать отдельную фоновую сессию. Проверьте все зависимости от старого поведения /fork и перейдите на /subtask там, где нужен внутрисессионный паттерн.

Исправление Bash в плановом режиме критично для развёртываний, где Claude Code работает в headless-режиме без наблюдения оператора — в CI/CD пайплайнах. Поведение до исправления, при котором деструктивные операции с файлами запускались автоматически без запроса разрешения, было реальной поверхностью атаки в автоматизированных развёртываниях. Операторы, использующие план-режим, должны убедиться, что они обновились до 2.1.212 или выше.

Что проверить и попробовать

  • Настройте лимиты по своему базовому уровню: запустите производственные сессии с CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=50 и CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=50 в течение недели, чтобы понять типичный бюджет, — затем откорректируйте значения.
  • Проверьте использование /fork: найдите /fork в командных playbook, скриптах и CI-конфигах; замените на /subtask там, где нужен внутрисессионный паттерн.
  • Проверьте prompt caching на вашем gateway: после обновления сравните расход токенов в сессиях за gateway и в прямых API-сессиях — разрыв должен сократиться.
  • Оцените задержки MCP-сервисов: если у вас есть MCP-интеграции, которые регулярно работают дольше 2 минут, проверьте, влияет ли автофон на ожидания вашего рабочего потока.
  • Пересмотрите plan-mode развёртывания: убедитесь, что все headless Claude Code пайплайны, использующие план-режим, теперь корректно ждут обратного вызова canUseTool перед выполнением Bash-команд.

Для команд, маршрутизирующих Claude Code через кастомный API gateway, изменения в 2.1.212 — прежде всего исправление prompt caching и лимиты субагентов — заслуживают выделения окна для обновления в текущем спринте.

Абстрактная схема: org-level MCP server governance — поток конфигурации от администратора к параллельным Claude Code сессиям

Claude Code 2.1.259: Org-Level MCP Server Push и исправление потери состояния при параллельных сессиях

Claude Code 2.1.259 добавляет managedMcpServers для централизованного развёртывания HTTP/SSE MCP серверов, меняет семантику allowedMcpServers и закрывает баг, из-за которого параллельные сессии тихо перезаписывали состояние ~/.claude.json в CI-окружениях.

источник Claude Code CHANGELOG
Абстрактная визуализация safety gate, блокирующего деструктивную операцию в автоматизированном агентном pipeline

Claude Code 2.1.183: Auto mode блокирует деструктивные git- и IaC-команды — три изменения, которые должны проверить операторы gateway-развёртываний

Claude Code 2.1.183 ужесточает auto mode: деструктивные git- и инфраструктурные команды теперь заблокированы по умолчанию, закрыта уязвимость обхода approval через webhook-триггеры, исправлена утечка MCP auth stub в headless-режиме.

источник Anthropic / Claude Code
Помощь и контакты