pilotfish — оркестрация моделей для Claude Code
pilotfish
Плагин для Claude Code: старшая модель планирует и принимает работу, а поиск, правки и проверку берут на себя роли на более дешевых моделях
- 718 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Прежняя установка меняет глобальные `settings.json` и `CLAUDE.md`, а политика загружается в каждую будущую сессию
- Роли-исполнители правят файлы проекта и запускают команды, а плагин подключается хуком, который срабатывает при старте каждой сессии
- Автор предупреждает о границе доверия: просмотрите шаблоны ролей и политику до согласия на запись
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/pilotfishОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Прежняя установка меняет глобальные `settings.json` и `CLAUDE.md`, а политика загружается в каждую будущую сессию
- Роли-исполнители правят файлы проекта и запускают команды, а плагин подключается хуком, который срабатывает при старте каждой сессии
- Автор предупреждает о границе доверия: просмотрите шаблоны ролей и политику до согласия на запись
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pilotfish задает Claude Code правила делегирования. Главная сессия работает на семействе `opus` и решает, что оставить себе, а что отдать узким ролям. Разведку по репозиторию ведет `scout` на `haiku`, типовые правки по готовой спецификации делает `mech-executor` на `sonnet`, задачи с локальными решениями берет `executor` тоже на `sonnet`. Перед согласованием плана его оспаривает `plan-verifier`, после реализации результат проверяет `verifier` в свежем контексте, а за задачи по безопасности отвечают `security-reviewer` и `security-executor`. Плагин для macOS и Linux ставит роли и вешает на запуск сессии хук, который подгружает политику сам. Прежняя установка клонирует репозиторий, и Claude Code по инструкции `install/AGENT-INSTALL.md` показывает план и после вашего согласия записывает восемь файлов ролей в `~/.claude/agents/`, блок политики в `CLAUDE.md` и поля `model` и `fallbackModel` в `settings.json`. Перед работой политика выбирает форму взаимодействия: обсуждение, план или прямое выполнение. Мелкая и ясная работа остается в главной сессии, роли подключаются, когда граница задачи понятна и делегирование окупается. Независимую проверку запускает цена ошибки, число затронутых файлов на это не влияет.
Для кого. Для разработчиков, у которых длинные сессии Claude Code тратят много токенов на поиск, повторяющиеся правки и тесты, и которым нужна управляемая экономия без потери контроля над решениями.
Подходит, если
- Большой репозиторий: разведку и поиск по файлам стоит отдавать роли на `haiku`, и главная модель остается свободной
- Есть пачка однотипных правок по готовой спецификации, и их хочется исполнить на `sonnet`
- Перед реализацией нужен независимый взгляд на план, а после нее проверка результата в свежем контексте
- Задача касается безопасности: схема предусматривает отдельного ревьюера только для чтения и отдельного исполнителя
- Вы хотите увидеть стоимость сессии по ролям и моделям
Не подходит, если
- У вас Windows: плагин на нее не рассчитан, прежняя установка требует Claude Code 2.1.219 или новее
- Задачи короткие и однозначные: накладные расходы на роли не окупятся, главная сессия справится одна
- Вы хотите запускать роли по расписанию без участия человека: pilotfish задает правила делегирования внутри сессии и не планирует задания
- В `CLAUDE.md` уже лежит старая политика pilotfish: плагин в этом случае не запустится и попросит перейти на новую схему
Пример запроса к агенту
Use pilotfish. Следуй его правилу торможения: найди все места, где используется старый клиент оплаты, перепиши их на новый, а проверку отдай отдельной ролиОграничения
Автоматическое делегирование не гарантировано. Системные инструкции Claude Code приоритетнее пользовательского `CLAUDE.md`, поэтому иногда нужна прямая просьба в сообщении: «Use pilotfish» и ссылка на правило торможения. Автор отдельно оговаривает, что это экономный режим по умолчанию, и не утверждает, что одна модель выигрывает везде.
Плагин рассчитан на macOS и Linux. На macOS с Claude Code 2.1.239 автор проверил его вживую, для Linux он подтверждает только соответствие контракту без живой проверки. Для работы нужен хук запуска сессии, и плагин нельзя ставить рядом с прежней глобальной установкой: хук откажется работать и попросит перенести настройки.
Переопределенная роль `Explore` в плагин не входит: Claude Code называет роли плагина по пространству имен, поэтому заменить встроенного разведчика может только прежняя установка. Переменная `CLAUDE_CODE_SUBAGENT_MODEL` переопределяет модель у всех ролей, и при ее наличии проверка перед установкой остановится.
Как отключить. Отключить плагин можно командой `claude plugin disable --scope user pilotfish@pilotfish`, удалить командами `claude plugin uninstall --scope user pilotfish@pilotfish` и `claude plugin marketplace remove --scope user pilotfish`. Прежнюю установку снимает раздел Uninstall в `install/AGENT-INSTALL.md`: восемь файлов ролей и блок политики.
Частые вопросы
Как установить pilotfish в Claude Code?
Добавьте каталог командой `claude plugin marketplace add --scope user Nanako0129/pilotfish`, затем поставьте плагин: `claude plugin install --scope user pilotfish@pilotfish`. Работает на macOS и Linux, нужен Claude Code 2.1.219 или новее.
Какие роли и модели использует pilotfish?
Главная сессия идет на семействе `opus`. Разведчик `scout` работает на `haiku`, исполнители `mech-executor` и `executor` на `sonnet`, проверяющие `plan-verifier`, `verifier` и `security-reviewer` на `opus`, а `security-executor` тоже на `opus`.
Чем плагин отличается от прежней глобальной установки?
Плагин подключается как обычный плагин Claude Code и подгружает политику хуком запуска сессии. Прежняя установка пишет роли в `~/.claude/agents/`, блок в `CLAUDE.md` и поля моделей в `settings.json`, зато умеет заменить встроенную роль `Explore`.
Почему агенты не запускаются сами?
Высокоприоритетные инструкции Claude Code могут подавить запуск субагентов. Попросите прямо: «Use pilotfish. Follow its dispatch brake: keep direct work in the main session and call the named agents only when the policy selects delegation».
Есть ли такие же проекты для других агентов?
Да, у проекта есть соседи: `remora` для Claude Code с подменой на GPT, `pilotfish-grok` для Grok Build и `pilotfish-codex` для Codex CLI. Каждый ведется в отдельном репозитории.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныОркестрация нескольких агентов для Claude Code: команды, роли, автопилот и распределение задач между скиллами и субагентами
Плагин Claude Code поручает кодинг-задачи агентам Codex, следит за их работой и проверяет результат независимо
Плагин для Claude Code, который прогоняет одну задачу через несколько внешних моделей и подсвечивает расхождения до релиза
claude-mods ставит в Claude Code 112 скиллов, 3 агента и 3 команды: стеки, запуск агентов, защита, непрерывность сессий.
Рабочие процессы для Claude Code: команды /do, /omo, /bmad-pilot и другие, а код пишут Codex, Gemini или OpenCode через codeagent-wrapper
Claude Code руководит, а Codex, opencode и pi работают на вашей квоте: делегирование правок, независимое ревью, обсуждения моделей
Коротко о README
Документация объясняет схему слоев: настройки машины, роли и политику, подкрепляет ее диаграммой потока и таблицей ролей с усилием по умолчанию. Рядом лежат замеры автора по самопроизвольному запуску ролей, сжатию промптов и границам проверяющего.