Модели и уровень рассуждений
Как Cusp выбирает модель, как переключать модели и как уровень рассуждений переводится в параметры каждого провайдера.
У каждой сессии есть модель и уровень рассуждений. Cusp выбирает и то и другое за вас, а вы можете изменить любой из них в любой момент, в том числе посреди сессии.
Как Cusp выбирает модель
Когда вы добавляете провайдера, Cusp получает список его моделей и ранжирует их. В результате делается два выбора:
- Основная модель. Модель, на которой работает агент. Cusp выбирает модель с наивысшим рейтингом для агентной разработки, которая поддерживает вызов инструментов и не помечена как устаревшая.
- Малая модель. Быстрая и недорогая модель для вспомогательной работы: заголовков сессий, классификатора режима auto, сводок при сжатии контекста и извлечения содержимого веб-страниц. Cusp предпочитает известную малую модель того же провайдера, затем самую дешёвую из подходящих, а если таких нет — использует основную модель.
Рейтинг берётся из каталога моделей Cusp. В нём для каждой модели записаны контекстное окно, лимит вывода, цены, возможности (инструменты, зрение, ввод PDF, рассуждения, кеширование промптов) и оценка для агентной разработки. Каталог обновляется из публичных источников, таких как models.dev и список моделей OpenRouter.
Типичный выбор для только что добавленного провайдера:
| Провайдер | Основная | Малая |
|---|---|---|
| Anthropic | claude-opus-5-5 | claude-haiku-5-5 |
| OpenAI | gpt-6.1-sol | gpt-6-luna |
gemini-4-argon | gemini-3.8-flash | |
| xAI | grok-4.7 | grok-build-0.1 |
| DeepSeek | deepseek-v4.1-flash | deepseek-v4.1-flash |
| Z.ai | glm-5.3 | glm-5.3-flash |
| MiniMax | MiniMax-M3 | MiniMax-M3.1-Flash |
| Alibaba | qwen3.8-max-0902 | qwen3.8-flash |
Этот выбор меняется вместе с каталогом. Для шлюзов, таких как OpenRouter и Vercel, Cusp предлагает список моделей шлюза, отсортированный по агентному рейтингу.
Как выбрать модель самостоятельно
Модели записываются как provider:model, где provider — id настроенного вами провайдера. Id модели без префикса означает «эта модель у текущего провайдера сессии».
| Где | Как |
|---|---|
| CLI, при запуске | cusp -m anthropic:claude-sonnet-5-5 или cusp --model gpt-6.1-sol |
| CLI, в сессии | /model открывает список для выбора; /model openrouter:z-ai/glm-5.3 переключает сразу |
| Десктопное приложение | Выбор модели в поле ввода |
| Настройки | "model": "anthropic:claude-opus-5-5" в любом файле настроек |
| Субагенты и навыки | model: во frontmatter |
Переключение посреди сессии
Модель можно сменить в любой момент. Разговор сохраняется. Что нужно знать:
- Состояние рассуждений воспроизводится в точности для той же модели. Другая модель получает вместо него безопасную проекцию (видимый текст без непрозрачных подписей), а Cusp записывает, что воспроизведение было изменено.
- Инструмент правки может смениться. При переходе с Claude на GPT агент переключается с
Editнаapply_patch. На переписку и правила разрешений это не влияет, потому что оба инструмента относятся к одному каноническому семейству. - Кеш промптов начинается с нуля у нового провайдера. Первый ход после переключения стоит дороже.
Вокруг переключения выполняются хуки PreModelSwitch и PostModelSwitch, причём хук PreModelSwitch может его запретить. См. Хуки.
Уровень рассуждений
Уровень рассуждений определяет, сколько модель рассуждает перед ответом. Cusp использует одну шкалу для всех провайдеров и переводит её в их параметры.
| Уровень | Когда использовать |
|---|---|
none | Без рассуждений, если модель это позволяет. Быстрее и дешевле всего |
minimal | Механические правки, переименования, форматирование |
low | Простые, чётко описанные изменения |
medium | Повседневная работа. Хороший вариант по умолчанию для большинства сессий |
high | Отладка, сквозные изменения, незнакомый код |
xhigh | Сложные задачи, где неверный шаг обходится дорого |
max | Весь бюджет рассуждений модели |
Как задать:
/effort highв CLI (low,medium,high,xhighилиmax) или переключатель уровня рассуждений в десктопном приложенииcusp --effort highпри запуске"effortLevel": "high"в настройках илиeffort:во frontmatter навыков и субагентов
Как уровень переводится для провайдеров
Каждая модель объявляет, какие уровни она принимает. Если вы запросите уровень, который модель не поддерживает, Cusp выберет ближайший поддерживаемый и сообщит вам об этом.
| Тип провайдера | Что отправляет Cusp |
|---|---|
| Anthropic, адаптивное мышление | thinking: adaptive с уровнем рассуждений. minimal отправляется как low |
| Anthropic, мышление с бюджетом (старые модели) | Бюджет токенов на размышления: 1024 для minimal, 4096 для low, 10 000 для medium, 24 000 для high, 32 000 для xhigh, 48 000 для max |
| OpenAI Responses | reasoning.effort |
| Gemini | Уровень или бюджет размышлений, в зависимости от модели |
| Открытые модели (DeepSeek, GLM, Kimi, Qwen, MiniMax) | Собственный переключатель рассуждений провайдера, если он есть |
Некоторые модели не умеют отключать рассуждения. Для них none означает минимальное значение, которое допускает модель.
Контекстное окно
Cusp следит за расходом токенов относительно контекстного окна модели. Когда окно заполняется, сжатие контекста освобождает место: сначала обрезаются большие старые выводы инструментов (они остаются доступны как артефакты), затем разговор пересказывается в виде структурированной передачи дел, которая сохраняет список задач, затронутые файлы и принятые решения.
Выполните /compact, чтобы сжать контекст сразу, при желании с инструкциями: /compact keep the API design discussion. Вокруг сжатия выполняются хуки PreCompact и PostCompact.
Стоимость
Каждое сообщение ассистента записывает расход: входные токены (включая чтение и запись кеша), выходные токены и токены рассуждений. Стоимость считается по ценам из каталога, а чтение кеша оплачивается по тарифу кеша. /cost в CLI показывает итог по сессии. Неинтерактивные запуски сообщают total_cost_usd в выводе JSON. Если цена модели неизвестна, стоимость указывается как null, а не угадывается.
Провайдеры и шлюзы
Все провайдеры, шлюзы и локальные среды выполнения, которые поддерживает Cusp, как он их определяет и как подстраивается под каждое семейство моделей.
Сессии
Сессия — это журнал событий, в который можно только дописывать; именно он позволяет возобновлять, ветвить и откатывать сессии и изолировать их в worktree.