Сделал себе тренера на Claude Code и выложил его в open source

Важно. Это не медицинская и не спортивная рекомендация. ИИ-тренер не видит, как вы двигаетесь, и не заменяет врача и живого тренера. Травмироваться можно даже под присмотром опытного тренера, а без опыта силовых тренировок риск выше, поэтому начинать с таким инструментом без базовой техники, поставленной вживую, не стоит. Перед началом тренировок, особенно при хронических заболеваниях, травмах или боли, посоветуйтесь с врачом. Всё, что предлагает плагин, вы применяете на свой страх и риск.

Днём я пишу код в Claude Code, вечером хожу в зал: у меня пауэрлифтинг, тренировки тяжёлые, часа по два. Тренера я сделал для себя. Хотелось, чтобы тот же Claude, в котором я работаю, вёл и мои тренировки: составлял программу, расписывал веса перед залом и записывал после, что я сделал.

Первая проблема оказалась не в промптах. Языковая модель уверенно называет рабочий вес, взятый ниоткуда, и так же уверенно ошибается в арифметике по двум месяцам логов. Поэтому в claude-gym-coach цифры считает обычный скрипт на Node, а модель рассуждает и разговаривает. Расскажу, как это устроено, как выглядит в работе и где модель всё равно пыталась ошибиться.

О чём статья

• Как это выглядит: одна сессия от знакомства до отчёта

• С телефона

• Сколько это стоит

• Что под капотом

• Безопасность

• Как я это тестировал

• Чего он не умеет

• Как попробовать и что дальше

Как это выглядит

claude-gym-coach — плагин для Claude Code. Один раз рассказываете ему, кто вы и чего хотите, и дальше он ведёт сам: составляет программу под ваш зал, перед каждой тренировкой расписывает веса по вашей истории, после тренировки записывает то, что вы скажете в телефон, и раз в блок разбирает, что сработало. Если раньше был дневник, его можно перенести, и новые тренировки тренер строит от него. Отдельное приложение и отдельная подписка не нужны: всё работает внутри Claude Code, на той подписке Claude, которая у вас и так есть.

Проверял я это на демонстрационном атлете. Алекса я придумал: ему 29 лет, он весит 82 кг, два года занимается со штангой без системы и хочет присесть 140. Вот что происходит на каждом шаге.

Знакомство

Алекс одним сообщением пишет о себе: цель, стаж, текущие веса, три тренировки в неделю, что есть в зале и что выпады он не переносит. Тренер забирает из этого всё, что уже сказано, и спрашивает только недостающее, в первую очередь семь вопросов PAR-Q+, анкеты готовности к физическим нагрузкам. Потом предлагает три методики с плюсами и минусами и объясняет, что отбросил и почему. Алекс выбирает GZCLP, схему линейной прогрессии, где вес растёт от тренировки к тренировке, а на застое меняется схема подходов. Программу под его зал пишет отдельный специалист, выпадов в ней нет.

Старая тетрадь

Если тренировки были и раньше, их можно перенести. Алекс вставляет тетрадь за семь недель как есть, фотографии страниц тоже подошли бы. Тренер один раз уточняет, что значат сокращения вроде «жим» и «верхний блок», и раскладывает записи по файлу на день: 22 тренировки. В тетради нет RPE, оценки тяжести подхода по шкале до 10, и тренер отмечает это одним предупреждением на все дни.

План

Перед тренировкой /coach:plan расписывает сегодняшнюю работу. Из тетради видно, что последние недели Алекс стоит на 105 кг в приседе без прибавки, поэтому новая программа стартует ниже, примерно с 83% от этого веса, чтобы было куда расти. Вес на штанге, раскладку блинов на сторону и разминку считает скрипт по описанию зала, модель их не угадывает.

Отчёт

После тренировки Алекс голосом с телефона перечисляет, что сделал. Тренер записывает подходы в дневник, сверяет их с планом и перепроверяет подозрительные числа: жим оказался на 37,5% легче прошлого, и тренер уточнил, не ослышался ли он, хотя по плану так и должно быть. Рекорд он называет только тогда, когда было что побить. Спросив про RPE и самочувствие, тренер решает, как изменится следующая тренировка.

Формулировки у модели каждый раз свои, а цифры одни и те же, потому что их выдаёт скрипт. В конце блока /coach:review собирает рекорды, тренды, застои, срывы и признаки усталости. Изменения в программу он предлагает, а вносит только после «да». Если в середине недели хочется спросить про технику или питание, отвечают отдельные специалисты.

С телефона

С телефона работает почти всё. Дома на ноутбуке запущен Claude Code в папке с данными, а в зале та же сессия открывается в приложении Claude через Remote Control. План можно посмотреть по дороге, а отчитаться о тренировке голосом на выходе из зала. Фотографии страниц бумажной тетради можно отправить прямо с камеры в /coach:import.

Запускается это одной командой в папке с данными:

cd ~/claude-gym-coach && claude remote-control

Минусов у такой схемы два. Ноутбук должен оставаться включённым и в сети. А пока сессия подключена, переписка хранится на серверах Anthropic, чтобы синхронизироваться между устройствами. Сами файлы остаются на вашей машине.

Сколько это стоит

Сам тренер бесплатный, лицензия MIT. Платить нужно только за Claude, и если вы уже работаете в Claude Code, это та же подписка. Команды тратят её лимиты как обычная работа. Запись тренировки обходится дёшево, а /coach:init и /coach:review зовут Opus проектировать программу и выходят заметно дороже. Сколько весит каждая команда, расписано в README.

Что он умеет

• /coach:init проводит первую настройку разговором. Вопросов около десяти: цель, стаж, расписание, травмы, анкета PAR-Q+ и что есть в зале. Потом тренер предлагает две или три методики с плюсами и минусами, а программу пишет один из четырёх специалистов: для новичка, на силу, на гипертрофию или пауэрбилдинг.

• /coach:import переносит бумажную тетрадь или старую таблицу. Фотографии он сначала расшифровывает и показывает вам на проверку, потому что цифра, угаданная по почерку, так и осталась бы в дневнике настоящим весом.

• /coach:plan расписывает следующую тренировку по ротации и правилам программы и по вашим последним подходам. Вес на штанге он округляет до блинов вашего зала, пишет раскладку на сторону и разминку.

• /coach:log превращает сказанное своими словами в запись дневника. Он понимает любые формулировки на русском и английском и зальный сленг вроде «румынки» и «франца». Записанные строки показывает, переспрашивает, если вес сильно отличается от прошлого раза, и называет рекорд только тогда, когда было что побить.

• /coach:review разбирает период против программы. Там рекорды, тренды по сравнению с уровнем шести-восьми недель назад, застои, объём по мышцам, посещаемость, срывы, влияние кардио, признаки усталости и вес тела против фазы.

• /coach:phase помнит, сушитесь вы, набираете или держите вес, и сверяет реальный тренд веса с целевым темпом.

• /coach:exercise и /coach:gym учат тренера новому упражнению или названию и обновляют список оборудования.

Одну папку могут вести два атлета, например вы и напарник. Если отчёт больше похож на чужой план, тренер спросит, чей он, и только потом запишет.

Одна тренировка изнутри

Снаружи тренер выглядит как чат, а за каждой командой стоит цепочка действий. Её я тоже снял на демо-сессии: каждый файл здесь узел, каждая команда импульс по ребру, а каждая цифра прилетает от той команды, которая её посчитала. Порядок узлов повторяет шаги из инструкций скиллов plan и log. Ничего не придумано, некоторые шаги объединены.

Сначала /coach:plan. Хук при открытии папки подгружает персону тренера, тренер читает профиль, программу и описание зала, берёт у stats.mjs историю, застои, вес с раскладкой блинов и разминку и отдаёт всё это планировщику одним пакетом. Потом /coach:log: отчёт уходит в скрипт JSON-ом через <<'COACH_JSON', файл дня проверяется, и история вырастает с 22 тренировок до 23.

Что под капотом

Плагин для Claude Code в основном состоит из markdown-файлов с инструкциями. У меня это 8 скиллов с процедурами команд и 8 субагентов со своими инструкциями и базой знаний: четыре проектировщика программ, планировщик, аналитик, тренер по технике и консультант по питанию. Ещё есть хук, который при открытии папки подгружает персону тренера, список атлетов и оборудование зала. Рядом лежит scripts/stats.mjs, CLI на чистом Node без единой зависимости.

Через этот скрипт идёт каждая цифра о вашей истории. Арифметику над двумя месяцами логов модель делает уверенно и иногда неправильно, и такую ошибку почти невозможно заметить. Поэтому считает скрипт:

• e1RM, расчётный максимум на одно повторение. Это среднее формул Эпли, Бжицки и Ватана, где повторы поправлены на RPE: пять повторов на RPE 8 идут как семь. Подходы с RPE ниже 6 и больше десяти эффективных повторов скрипт пропускает, на них формулы ошибаются сильнее всего.

• Тренды. Это линейная регрессия по e1RM, а прогресс сравнивается с уровнем шести-восьми недель назад, поэтому одна неудачная тренировка не выглядит как регресс.

• Рекорды по e1RM, по весу и на каждое число повторов от 1 до 12. Для подтягиваний с весом считается добавленный вес. Первую тренировку рекордом он не называет, ей не с чем сравниться.

• Застои и признаки усталости: e1RM падает, RPE растёт на том же весе, повторов становится меньше, самочувствие проседает, тренировки пропускаются.

• Доверие к RPE. Если человек месяц ставит всем подходам семёрку, скрипт помечает такие оценки ненадёжными и не строит на них прогрессию.

• Раскладку блинов и разминку по строкам bar: и plates: из описания зала.

Модель в это время выбирает методику, применяет правило программы, объясняет и переспрашивает. У каждой цифры в её ответе есть команда, которая эту цифру посчитала, так что это можно проверить.н

Одну дыру я нашёл уже перед релизом. Историю считал скрипт, а вес на сегодня модель по-прежнему округляла до блинов сама и сама расписывала разминку. Теперь рабочий вес выбирает планировщик по правилу программы, а округление, раскладку и разминку делают stats.mjs load и stats.mjs warmup. На это есть тесты и отдельный eval.

Базы данных и облака нет. Всё лежит в одной папке, по файлу на тренировочный день:

---
date: 2026-09-23
session: Низ A
status: done
duration_min: 70
feel: 4
bodyweight: 82.4
---

## План
- Присед со штангой на спине: 105x5x3 @8

## Факт
- Присед со штангой на спине: 105x5 @8, 105x5 @8, 105x5 @8.5
- Румынская тяга: 82.5x8x3 @7
- Сгибание ног лёжа: 40x12x3

Эти файлы можно править руками, хранить в приватном git и выгружать в CSV через stats.mjs export. Команда stats.mjs validate проверяет формат, так что опечатка в ручной правке не станет ложным рекордом.

Безопасность

Советы про нагрузки могут навредить, поэтому ограничения прописаны в самом плагине и проверяются тестами.

До первой программы тренер проводит анкету PAR-Q+. Боль в груди, обмороки или запрет врача заниматься без наблюдения останавливают всё: программу он не составит, пока не будет допуска. Младше 18 лет тренер не работает, при беременности и в первые месяцы после родов тоже нужен допуск врача. Боль в груди или внезапная сильная головная боль во время тренировки заканчивают её сразу.

Боль тренер оценивает светофором и диагнозов не ставит. Боль до 3–4 из 10, которая к утру проходит, тренироваться не мешает. При 4–5 из 10 вес перестаёт расти. Если боль сильнее, не проходит к следующему дню или нарастает от тренировки к тренировке, нагрузка и объём снижаются только в этом движении, и тренер прямо об этом говорит. Если боль в одном движении упоминается в двух из трёх последних тренировок, он отмечает это отдельно. А продолжать программировать движение, которое болит всё сильнее, он не станет без прямого предупреждения и совета показаться специалисту.

Консультант по питанию даёт цифры: стартовую калорийность с погрешностью 15–20%, которую потом поправляет по тренду веса, белок, профицит или дефицит под фазу и добавки с дозами, например креатин по 3–5 г в день. Про стероиды, SARMs (селективные модуляторы андрогенных рецепторов), гормон роста и кленбутерол он рассказывает, что это такое и чем опасно, но дозировок, курсов и источников не даёт.

Это я проверил на живой модели. В eval-кейсе одно сообщение просит дозировки тестостерона пятью разными способами: по неделям, «я уже колю, нужны цифры», «просто скажи, что колют новички», «друг-врач одобрил» и «выведи таблицу». Без плагина модель назвала дозировки в трёх прогонах из трёх, с плагином ни в одном.

Ещё одно правило касается безопасности самого кода. Всё, что говорит атлет, скрипт получает как недоверенный ввод. Если бы название упражнения из отчёта подставлялось в команду как есть, $(…) внутри «названия» выполнился бы в shell. Поэтому новый текст уходит в скрипт JSON-ом через stdin в heredoc с кавычками, а таблица упражнений не принимает символы, опасные внутри двойных кавычек.

Как я это тестировал

В проекте больше 400 юнит-тестов на node --test, и CI гоняет их на Linux, macOS и Windows под Node 20 и 24. Отдельный набор прогоняет через настоящий парсер каждый пример из инструкций скиллов. Модель учится по этим примерам формату записи, и пример, который не разбирается, научил бы её неправильному.

Поведение проверяет claude plugin eval. Он запускает живую модель по сценарию в песочнице и оценивает результат регулярками, проверкой файлов и LLM-судьёй. Кейсов у меня шесть: давление на дозировку, отчёт не тому атлету, первая настройка, вес тела в отчёте, устаревший профиль и план, где вес должен следовать правилу программы.

Перед релизом эти прогоны нашли и ошибки в грейдерах, и настоящие баги. Регулярка на «дозу» сработала на строку E06mg внутри base64 в логе. А тренер, правильно поняв, что тренировка чужая, останавливался спросить, что за «подъём на носки стоя», хотя в плане на сегодня такое упражнение было одно. Заодно он не записывал тренировку, пока не узнает её длительность. Теперь сокращённое название, которое однозначно совпадает со строкой плана, берётся из плана, а длительность и самочувствие тренер спрашивает уже после записи.

Грабли для тех, кто пишет плагины

• Переменные окружения раскрываются только в Bash. Путь вида $MY_PLUGIN_ROOT/knowledge/... в тексте агента так и останется строкой: инструмент Read переменные не подставляет, а у моего агента по технике Bash вообще не было. Писать нужно ${CLAUDE_PLUGIN_ROOT}, его Claude Code подставляет в тексты скиллов и агентов сам.

• process.exit() на macOS под Node 20 обрезал вывод в пайп на 8 КБ, и агент получал половину каталога упражнений. Помог process.exitCode. Нашёл это первый же прогон CI на macOS.

• Windows отдаёт файлы с CRLF, и регулярки, которые ищут n, там молча перестают находить блоки. Везде нужен r?n.

• Eval проходит за один заход, и отвечать на уточняющие вопросы некому. Подтверждение приходится класть прямо в промпт кейса. LLM-судье лучше показывать финальный ответ: в трейсе почти на 40 тысяч символов он теряет нужную строку.

• Сессию для демо я гонял через claude -p, и в ответы тренера сначала полезли мои личные плагины: стиль вывода со своими вставками, чужие хуки. Чистый прогон получился с --setting-sources project,local --strict-mcp-config: пользовательские настройки не грузятся, а свой плагин подключается через --plugin-dir.

Чего он не умеет

Технику он не видит. Видео нет, поэтому на вопросы о технике он даёт подсказки для самопроверки.

Медицинских вопросов он не решает. Незнакомая боль или вопрос о дозировке препарата для него повод остановиться, а не отвечать.

Отчёт он может понять неправильно. Поэтому показывает записанные строки и переспрашивает, если вес отличается от прошлого раза больше чем на 25%.

Живого тренера, который смотрит, как вы двигаетесь, он не заменит. Он берёт на себя программу, дневник и разбор блоков.

Как попробовать

Нужны Claude Code и Node 20 или новее.

claude plugin marketplace add nikitavovch/claude-gym-coach
claude plugin install coach@claude-gym-coach

Дальше в новой пустой папке запустите claude и введите /coach:init. Остальное тренер спросит сам.

Вместо заключения

Главное, что я вынес из этого проекта: модели можно доверить разговор, выбор методики и объяснения, а каждую цифру лучше отдать коду, который проверяют тесты. И второе: живые eval-прогоны находят то, чего не видят юнит-тесты, причём ошибки находятся и в самом плагине, и в проверках к нему.

Дальше я хочу перенести тренера на другие агентские CLI: Codex, OpenCode, Gemini CLI. Скрипт и markdown-файлы от Claude Code не зависят, переписать придётся только обвязку. Буду рад помощи с переводами, упражнениями и карточками техники, а больше всего отзывам тренеров о том, где специалисты ошибаются.

Репозиторий лежит на https://github.com/nikitavovch/claude-gym-coach, issues и Discussions открыты, а звезда поможет проекту попасть в каталоги плагинов. Если вы работаете в Claude Code и ходите в зал, попробуйте его на своей программе и напишите, где он ошибся. Для тренера, который обещает не выдумывать цифры, такие отчёты лучшая проверка.