Субагенты тратят слишком много токенов: как дать им модель подешевле?
В Claude Code напишите model: haiku в начале файла субагента. В Codex задайте default_subagent_model в разделе [agents] файла ~/.codex/config.toml. Каждый субагент делает собственные запросы из того же лимита, поэтому поиск, чтение файлов и другую простую работу дешевле всего отдавать маленькой модели.
Codex
Задайте default_subagent_model в разделе [agents] файла ~/.codex/config.toml — и все субагенты по умолчанию будут работать на модели поменьше.
Без настройки субагент наследует модель и уровень рассуждений основной сессии. Задайте значение по умолчанию для всех в разделе [agents] файла config.toml или дайте отдельному субагенту свой файл .toml с полями model и model_reasoning_effort; файл важнее значения по умолчанию. OpenAI советует GPT-5.6 Terra для поиска, чтения больших файлов и обработки материалов, а GPT-5.6 Luna — для чётко поставленной, повторяющейся работы. Чтобы ограничить число одновременно работающих субагентов, задайте max_concurrent_threads_per_session в разделе [agents].
Что сказано в официальной документации
Because each subagent does its own model and tool work, subagent workflows consume more tokens than comparable single-agent runs.If you don't configure a subagent model or model_reasoning_effort, the subagent inherits the parent agent's model and reasoning effort.To balance intelligence, speed, and price for each task, request a specific model or reasoning effort in your prompt, configure [agents] defaults in config.toml, or set model and model_reasoning_effort directly in the custom agent file.Use gpt-5.6-terra when you want a faster, lower-cost option for lighter subagent work.If a custom agent file sets model or model_reasoning_effort, the value in the file takes precedence.Claude
Напишите model: haiku в начале файла субагента. Чтобы поменять всех сразу, задайте переменную окружения CLAUDE_CODE_SUBAGENT_MODEL.
Причину называет панель /usage: «Each subagent runs its own requests. Be deliberate about spawning them — and consider configuring a cheaper model for simpler subagents.» (каждый субагент делает собственные запросы; запускайте их обдуманно и подумайте о более дешёвой модели для простых субагентов). Файлы субагентов лежат в .claude/agents/ (этот проект) или ~/.claude/agents/ (все проекты). Поле model в начале файла принимает haiku, sonnet, opus, fable, полный ID модели или inherit; если его не указать, субагент использует модель основной сессии. CLAUDE_CODE_SUBAGENT_MODEL задаёт значение по умолчанию для всех субагентов, но только по умолчанию: модель, записанная в файле, или та, которую Claude называет при делегировании, важнее. Пока субагент работает, /tasks показывает, на какой он модели.
Что сказано в официальной документации
For simple subagent tasks, specify model: haiku in your subagent configuration.CLAUDE_CODE_SUBAGENT_MODEL is a default, so a subagent's definition or a model Claude passes still takes precedence over it. To apply one model to every subagent, teammate, and workflow agent, also set CLAUDE_CODE_SUBAGENT_MODEL_FORCE to 1.A user or project subagent named Explore overrides the built-in and keeps its own model field, so define one with model: haiku to keep exploration on a lower-cost model.Agent teams use approximately 7x more tokens than standard sessions when teammates run in plan mode, because each teammate maintains its own context window and runs as a separate Claude instance.A single burst of heavy activity, such as a large workflow fanout, can exhaust the weekly allowance before the session window resets.Codex: что написать
По умолчанию для всех субагентов: в ~/.codex/config.toml, в разделе [agents], добавьте default_subagent_model = "gpt-5.6-terra" и default_subagent_reasoning_effort = "medium".
Только для одного субагента: создайте файл .toml в .codex/agents/ (этот проект) или ~/.codex/agents/ (все проекты). Обязательных полей три: name, description и developer_instructions. Затем добавьте model и model_reasoning_effort. В официальном примере pr-explorer.toml заданы name = "pr_explorer", model = "gpt-5.6-luna" и model_reasoning_effort = "medium".
Порядок приоритета: модель, названная при запуске субагента, затем значение по умолчанию из [agents], затем модель основной сессии. Значение в файле агента важнее значения по умолчанию.
Claude Code: что написать
Один субагент: создайте log-reader.md в .claude/agents/. Между двумя строками --- в начале файла напишите три строки. Первая — name: log-reader. Вторая — description: Reads logs and runs tests, reports failures only. Третья — model: haiku. Ниже напишите инструкции, например: Report only the failing tests and their errors. Do not paste the full output.
Все субагенты: в блок env файла settings.json добавьте "CLAUDE_CODE_SUBAGENT_MODEL": "haiku". Чтобы это действовало на всех субагентов без исключений, добавьте ещё "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1" (нужна версия v2.1.257 или новее).
Только встроенный Explore: создайте собственного субагента с именем Explore и model: haiku. Он заменит встроенного.
Порядок приоритета: модель, названная при делегировании задачи, затем model в файле субагента, затем CLAUDE_CODE_SUBAGENT_MODEL, затем модель основной сессии.
Частые заблуждения
- У субагентов свой лимит, поэтому параллельный запуск многих не задевает основную сессию
Своего лимита у них нет. Субагенты, команды агентов и параллельные облачные задачи расходуют одни и те же 5-часовой и недельный лимиты. Параллельный запуск лишь тратит их быстрее.
- Стоит задать CLAUDE_CODE_SUBAGENT_MODEL — и все субагенты на маленькой модели
Не совсем. Это только значение по умолчанию: модель, записанная в файле субагента, или та, которую Claude называет при делегировании, важнее, а встроенных Explore и Plan оно не касается. Чтобы перевести всех принудительно, задайте ещё CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1, а затем проверьте через /tasks.
- Передать работу субагенту — значит сэкономить токены
Не обязательно. Субагент экономит контекст основной сессии: длинный вывод остаётся у него, а основная сессия получает резюме. Но ему приходится читать вводные с нуля, поэтому в сумме часто выходит больше. Передавайте работу с длинным и шумным выводом (запуск тестов, загрузка документации, чтение логов) — и окупается это только с маленькой моделью.
Советы
- Начните с субагента, которого запускаете чаще всего. /usage в Claude Code показывает, какой субагент тратит больше всех; поменяв его, вы быстрее всего получите отдачу.
- Поиск, чтение файлов, запуск тестов и чтение логов отдавайте маленькой модели. Решения (архитектура, трудные баги) оставляйте модели основной сессии.
- Запускайте меньше. Команды агентов (agent teams) у Claude расходуют примерно в 7 раз больше токенов, чем обычная сессия, а один большой параллельный запуск может исчерпать недельный лимит раньше, чем сбросится 5-часовой.
- При делегировании указывайте рамки задачи и что именно вернуть, например «сообщи только об упавших тестах и их ошибках». Для субагента, которого вы запускаете часто, панель /usage советует ровно это: модель поменьше или промпт поточнее.
- Завершайте их работу, когда они закончили. Участник команды, который не вышел, продолжает тратить токены.
- В Codex модель можно назвать и прямо в промпте: «use gpt-5.6-terra at medium for this subagent». Модель, названная при запуске, важнее значения по умолчанию.
- Субагенту Claude Code можно задать и собственный effort (low, medium, high и выше) — там же, где model.