Adaptive Thinking в Claude: настройка

Adaptive Thinking в Claude 5.5 и 4.x (2026): параметры thinking и effort, отличия от budget_tokens, матрица поддержки моделей и советы по учёту стоимости.

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Adaptive Thinking (адаптивное рассуждение) — режим рассуждения Claude 4.6 и новее: модель сама решает, когда и сколько токенов тратить на рассуждение, а глубину регулирует параметр effort (в Claude Code — команда /effort). В этом руководстве — вызовы API, матрица поддерживаемых моделей, отличия от budget_tokens и способы следить за стоимостью.

Откуда взяты параметры: строки ниже составлены по официальной документации Anthropic (по состоянию на 2026-10-15). Модели 4.x ранее проверены на QCode как вызываемые; модели 5-й серии пока не проверены на QCode по каждому пункту. О выборе модели 5-й серии см. Выбор модели.

Ключевые отличия от прежнего Extended Thinking¶

Краткое правило: для моделей 4.6 и новее используйте adaptive; budget_tokens — только для 4.5 и ранее (эти старые модели отвечают на type: "adaptive" ошибкой 400).

Матрица поддержки моделей¶

Перечисленные модели 4.x ранее проверены на QCode как вызываемые; поведение параметров моделей 5-й серии соответствует официальной документации. Цены и доступность по моделям смотрите на qcode.cc/models.

Параметр effort: грубый регулятор глубины рассуждения¶

effort управляет общей интенсивностью adaptive thinking (токены рассуждения, число вызовов инструментов, подробность ответа). В запросе он записывается как output_config.effort.

Практическое правило: у Opus 5.5 и Haiku 5.5 по умолчанию medium, у Sonnet 5.5 в API — high; Anthropic советует после смены модели заново прогнать собственные тесты, а не переносить настройки со старой. xhigh лучше всего подходит для длинных агентных циклов (многошаговое ревью кода, глубокое исследование); max оправдан, только когда корректность гораздо важнее стоимости. Повышая уровень, увеличьте и max_tokens: токены рассуждения входят в лимит вывода.

Смена effort сбрасывает кэш промпта: чтобы кэш продолжал срабатывать, держите конфигурацию рассуждения и effort неизменными в рамках диалога. Если уровень нужно менять посреди диалога, используйте официальное изменение effort для отдельного сообщения (beta, нужен beta-заголовок mid-conversation-output-config-2026-07-01; поддерживается у Opus 5.5, Sonnet 5.5, Haiku 5.5 и других).

Примеры вызова API¶

Python (anthropic SDK)¶

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.qcode.cc/api",
    api_key="cr_xxxxxxxx",
)

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "Отрефакторь логику аутентификации в модуле user service..."}],
)

for block in response.content:
    if block.type == "thinking":
        print(f"[Рассуждение] {block.thinking}")
    elif block.type == "text":
        print(f"[Ответ] {block.text}")

TypeScript (@anthropic-ai/sdk)¶

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.qcode.cc/api",
  apiKey: "cr_xxxxxxxx",
});

const response = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 16000,
  thinking: { type: "adaptive" },
  output_config: { effort: "high" },
  messages: [{ role: "user", content: "Отрефакторь user service..." }],
});

Claude Code CLI¶

В Claude Code уровень меняется командой /effort: без аргументов открывается ползунок, /effort high задаёт уровень напрямую, /effort auto сбрасывает сохранённый уровень. Можно также передать --effort при запуске или задать переменную окружения CLAUDE_CODE_EFFORT_LEVEL. Текущий уровень показан в шапке сеанса рядом с названием модели. Доступные уровни: low, medium, high, xhigh и max у Opus 5.5 / Sonnet 5.5 / Haiku 5.5 / Opus 5 / Sonnet 5 / Opus 4.8 / Opus 4.7; low, medium, high и max у Opus 4.6 и Sonnet 4.6.

Значения по умолчанию в Claude Code (официальная документация, по состоянию на 2026-10-15): medium у Opus 5.5, Sonnet 5.5 и Haiku 5.5, xhigh у Opus 4.7, high у остальных моделей с поддержкой effort. В Claude Code рассуждение этих трёх моделей 5.5 отключить нельзя; чтобы оно было короче, снижайте effort.

Отображение содержимого рассуждения¶

Модели 5-й серии (включая Opus 5.5, Sonnet 5.5 и Haiku 5.5) по умолчанию не показывают текст рассуждения (display по умолчанию "omitted"): рассуждение идёт только внутри, а токены рассуждения тарифицируются как обычно. Чтобы показать ход рассуждения в интерфейсе:

thinking={"type": "adaptive", "display": "summarized"}

display: "summarized" заставляет модель выдавать краткое изложение рассуждения (видимые блоки thinking); omitted лишь учитывает токены рассуждения без вывода текста.

Task Budgets (Beta)¶

Если вы запускаете агентный цикл и хотите задать общий лимит на весь ход (рассуждение + инструменты + итоговый вывод), используйте task_budget. По официальной документации beta-поддержка есть у Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Opus 4.8, Opus 4.7 и других; Sonnet 5 не поддерживается:

response = client.beta.messages.create(
    betas=["task-budgets-2026-03-13"],
    model="claude-opus-5-5",
    max_tokens=64000,
    thinking={"type": "adaptive"},
    output_config={
        "effort": "high",
        "task_budget": {"type": "tokens", "total": 128000},
    },
    messages=[...],
)

Модель видит обратный отсчёт оставшегося бюджета и сама регулирует расход, чтобы не выйти за лимит. Минимальное значение total — 20 000; меньшие значения возвращают 400.

Рекомендации по мониторингу стоимости¶

После включения adaptive thinking растут и входные, и выходные токены, поэтому за ними нужно следить:

print(response.usage)
# Обращайте внимание на: input_tokens, output_tokens, cache_read_input_tokens
# Adaptive thinking не тарифицирует thinking tokens отдельно — они тарифицируются как выходные токены и входят в output_tokens

QCode тарифицирует по токенам; цены по моделям — на qcode.cc/models. Запросы отправляются в probe.qcode.cc, где можно увидеть соотношение input / output / рассуждение по каждому запросу.

Часто задаваемые вопросы¶

Как пересчитать budget_tokens при переходе на adaptive thinking?¶

Линейного пересчёта нет. budget_tokens=8000 не соответствует какому-то конкретному уровню effort. Начните с effort: "medium" и подстраивайте по качеству ответов и расходу токенов. Если нужен жёсткий лимит, используйте task_budget (см. выше).

Мой запрос к Opus 4.7 / 4.8 / модели 5-й серии возвращает 400 с сообщением, что budget_tokens недопустим¶

Замените все thinking={"type": "enabled", "budget_tokens": N} на thinking={"type": "adaptive"}. Opus 4.7 и новее больше не поддерживают budget_tokens (любое значение даёт 400).

Стоит ли продолжать использовать budget_tokens в Sonnet 4.6?¶

Не рекомендуется. Для нового кода всегда используйте adaptive thinking. budget_tokens в 4.6 пока работает, но это deprecated-путь.

Я хочу отключить рассуждение, а Opus 5.5 возвращает 400. Что делать?¶

У Opus 5.5 рассуждение отключить нельзя. Чтобы оно рассуждало меньше, снизьте effort (например, до low). Для Sonnet 5.5 используйте thinking: {"type": "between_tools"}, для Haiku 5.5 — thinking: {"type": "disabled"}; оба варианта работают только при effort high и ниже.

Как изменить effort в Claude Code CLI?¶

Используйте /effort (см. выше) или добавьте --effort при запуске; постоянное значение хранится в ~/.claude/settings.json в ключе effortLevel или в modelSettings для конкретной модели.

Дальнейшие шаги¶

• Руководство по выбору модели — цены и сравнение возможностей моделей
• Лучшие практики — приёмы промптинга для большого контекста и агентных процессов
• Точки доступа и форматы API — полный список доменов доступа QCode.cc
• Полное руководство по Claude Code — все возможности CLI

Enterprise →