ГлавнаяЧек-лист

Чек-лист
кодовое словоКодинг
4 бесплатных инструмента для Claude Code: ставим по шагам
Здесь установка всех 4-х инструментов из ролика: что понадобится, команды по шагам, как проверить, что каждый работает, и чего от него ждать. Порядок от самого простого к самому сложному: сначала два плагина, потом Graphify, в конце OmniRoute.
Содержание7 глав
Что ставим
| # | Что | Что делает | Как ставится | Лицензия |
|---|---|---|---|---|
| 1 | Ponytail | Claude сначала ищет готовое решение в проекте, стандартной библиотеке и возможностях платформы и пишет только нужный код | плагин Claude Code | MIT |
| 2 | Agent Skills | 25 скиллов на весь цикл разработки: спецификация, план, код, тесты, ревью, релиз; нужный включается сам | плагин Claude Code | MIT |
| 3 | Graphify | собирает проект в граф знаний, и Claude ищет ответ по графу, а не перечитывает файлы | программа через uv и скилл | Apache-2.0 |
| 4 | OmniRoute | локальный шлюз: 352 провайдера моделей, больше 90 бесплатных, цепочки моделей с переходом на следующую при лимите | программа через npm | MIT |
Все четыре бесплатные. Платишь только за Claude и за платные модели, если сам их подключишь.
Что понадобится
- Claude Code на платном тарифе Claude (Pro, Max, Team или Enterprise) либо с ключом API из Console. Установка: на macOS, Linux и WSL
curl -fsSL https://claude.ai/install.sh | bash, через Homebrewbrew install --cask claude-code, на Windowswinget install Anthropic.ClaudeCode. Документация: https://code.claude.com/docs/en/setup - Node.js для Ponytail и OmniRoute. Ponytail запускает два маленьких хука через
node, поэтому командаnodeдолжна находиться из терминала. OmniRoute требует версию от 22.22.2 в ветке 22 либо ветку с 24 по 26. Проще всего поставить Node.js 24: https://nodejs.org/en/download. Проверка:node -v. - uv и Python 3.10 или новее для Graphify. Установка uv на macOS и Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh, на Windowswinget install astral-sh.uv. Подробно: https://docs.astral.sh/uv/getting-started/installation/ - Доступ к Claude из твоей страны. Список стран: https://www.anthropic.com/supported-countries. России в нём нет.
Шаг 1. Ponytail: меньше лишнего кода
- Открой Claude Code в папке проекта:
cd путь/к/проекту && claude. - Отправь первой отдельной репликой
/plugin marketplace add DietrichGebert/ponytail, а второй отдельной репликой/plugin install ponytail@ponytail. Одной строкой обе команды не сработают, авторы пишут об этом прямо. - Если после установки видишь «Run /reload-plugins to activate», Claude Code сам перезагрузит плагины. Если он предупреждает, что следующее сообщение перечитает весь диалог, набери
/reload-plugins --force. - Проверка: набери
/ponytailбез слов, он назовёт текущий уровень. По умолчанию стоитfull. - Уровни:
/ponytail liteмягче,/ponytail fullобычный,/ponytail ultraжёстче всего,/ponytail offвыключает. Уровень для всех новых сессий задаётся переменнойPONYTAIL_DEFAULT_MODE. - Полезные команды:
/ponytail-reviewпроверяет текущие изменения на лишнее и даёт список, что удалить,/ponytail-auditделает то же по всему проекту,/ponytail-debtсобирает в журнал всё, что отложено на потом,/ponytail-gainпоказывает таблицу экономии из замеров авторов. - Чего ждать. Сильнее всего Ponytail режет там, где агент раньше городил своё: в замере авторов выбор даты сократился с 404 строк до 23, потому что вместо компонента встало обычное поле браузера. На коде, который и так минимален, разницы почти нет. Проверки безопасности он не выкидывает.
- Если команды Ponytail работают, а постоянный режим молчит, значит хуки не нашли
node. У тех, кто ставил Node через nvm, путь кnodeдолжен быть виден и в неинтерактивной оболочке. - Удаление:
/plugin remove ponytail.
Шаг 2. Agent Skills: скиллы на каждый этап
- В Claude Code отправь
/plugin marketplace add addyosmani/agent-skills, потом/plugin install agent-skills@addy-agent-skills. - Если маркетплейс не добавляется из-за ошибки SSH, добавь его по HTTPS-адресу:
/plugin marketplace add https://github.com/addyosmani/agent-skills.git, а затем повтори установку. - Проверка: набери
/и найди в списке команды набора: spec, plan, build, test, review, ship. - Порядок на новой задаче:
/spec- сначала спецификация: Claude задаёт вопросы и сохраняет SPEC.md;/plan- разбивка на маленькие задачи с критериями готовности и проверкой;/build- реализует следующую задачу через тест и коммит;/build autoделает весь план после одного одобрения;/test- тесты, а для бага сначала тест, который его воспроизводит;/review- ревью по пяти осям: корректность, читаемость, архитектура, безопасность, производительность;/ship- чек-лист перед запуском и решение, выпускать или нет.
- Есть ещё
/code-simplifyдля упрощения кода,/constraintsдля правил качества и/webperfдля скорости сайта. - Отдельно вызывать скиллы не нужно: Claude сам подключает подходящий, например при проектировании API или при работе с интерфейсом.
- В других агентах, например Cursor или Codex, набор ставится одной командой
npx skills add addyosmani/agent-skills.
Шаг 3. Graphify: граф проекта вместо перечитывания файлов
- Установи программу:
uv tool install graphifyy. В названии пакета две буквы y, другие пакеты graphify к проекту не относятся. Если после установки терминал пишетgraphify: command not found, выполниuv tool update-shellи открой новый терминал. - Зарегистрируй скилл в Claude Code:
graphify install. - Открой Claude Code в папке проекта и набери
/graphify .. Появится папкаgraphify-out/, в нейgraph.html(граф, который открывается в браузере),GRAPH_REPORT.md(главные узлы и связи) иgraph.json(весь граф). - Чтобы Claude сам шёл в граф, в папке проекта выполни
graphify claude install. После этого перед поиском и чтением файлов хук подсказывает Claude сначала спросить граф. Жёсткий вариант:graphify install --project --strict, тогда первое чтение сырых файлов за сессию перенаправляется в граф. - Добавь в файл
.claudeignoreв корне проекта две строки:graph.jsonиgraphify-out/. Иначе каждое обновление графа сбрасывает кэш промпта Claude Code, и следующий запрос выходит дороже. - Держи граф свежим:
graphify hook installпересобирает его после каждого коммита и переключения ветки, послеgit pullвыполниgraphify update ., а после правок в документах набери в Claude Code/graphify --update. Если запрос не видит только что добавленное, сначалаgraphify update .. - Код разбирается прямо на твоём компьютере, без модели и без токенов. Документы, PDF и картинки идут через модель ассистента, это расходует лимит.
- Проверка:
graphify query "как связаны авторизация и база данных"илиgraphify explain "ИмяКласса"- в ответе будут узлы и связи из твоего проекта. - Если видишь
ModuleNotFoundError: No module named 'graphify', значит пакет ставился через pip в другое окружение: переустанови черезuv tool install graphifyy.
Шаг 4. OmniRoute: бесплатные модели, когда кончается лимит
- Установка и запуск:
npm install -g omniroute, затемomniroute. Панель откроется в браузере по адресуlocalhost:20128. - Подключи провайдеров: панель → Providers. Для бесплатного запаса бери провайдеров с ключом API, например Gemini, Groq, Cerebras или Mistral: регистрируешься у провайдера, создаёшь ключ и вставляешь его в карточку.
- Открой страницу
localhost:20128/dashboard/free-tiers: там видно, сколько бесплатных токенов осталось, и пометки по условиям провайдеров. Цифра «до 1,5 миллиарда токенов в месяц» - сумма документированных бесплатных лимитов, она набирается, только если подключить эти бесплатные пулы, и около 1 миллиарда из неё даёт Mistral. У 15 провайдеров стоит пометка avoid: по разбору авторов OmniRoute их условия конфликтуют с работой через такой шлюз, среди них Kiro и OpenCode Free. Пометка сама ничего не выключает, поэтому не подключай их. - Не подключай в OmniRoute вход в подписку Claude. Правила Claude Code запрещают пропускать запросы через учётные данные тарифов Free, Pro и Max в сторонних программах и хранить там токены входа, за это можно потерять аккаунт. Модели Claude в цепочку добавляй только через ключ API из Console.
- Собери свою цепочку: Dashboard → Combos → Create New. Дай имя, например
my-free, и добавь модели провайдеров из пункта 2 в нужном порядке. Имя цепочки дальше пишешь вместо названия модели. Упрётся одна модель в лимит - шлюз перейдёт к следующей. - Запусти Claude Code через цепочку:
omniroute run claude --model my-free. - Если используешь модель
autoвместо своей цепочки: на свежей установке в неё уже встроены провайдеры без ключей OpenCode Free и Felo. Открой в Providers их страницы и выключи переключатель рядом с «No authentication required», тогда провайдер и его модели пропадут из списка. - На подписке Claude работаешь в Claude Code как обычно. Кончился лимит - выходишь, запускаешь
omniroute run claude --model my-free, внутри набираешь/resumeи продолжаешь прошлую сессию уже на бесплатных моделях. Если/resumeвыдаёт ошибку или сессия не помещается в окно бесплатной модели - начни новую сессию и коротко перескажи задачу. - Проверка:
curl localhost:20128/v1/models -H "Authorization: Bearer ключ из Dashboard → Endpoints"- в ответе список подключённых моделей. Диагностика провайдеров и портов:omniroute doctor.
Если что-то не работает
/pluginне распознаётся - проверь версиюclaude --versionи обнови Claude Code: через Homebrewbrew upgrade claude-code, при установке скриптом повтори команду установки.- Ponytail установился, но не срабатывает - команда
nodeне находится, вернись к шагу 1, пункт 8. - Agent Skills не ставится из-за SSH - добавь маркетплейс по HTTPS-адресу из шага 2.
graphify: command not found-uv tool update-shellи новый терминал.- Claude всё равно открывает файлы по одному - нет
graphify claude installв папке проекта или не построен граф, вернись к шагу 3. npm install -g omnirouteругается на версию - проверьnode -v: нужна 22.22.2 и выше в ветке 22 или ветка с 24 по 26.- Claude Code через OmniRoute не отвечает - запускай с
--modelи именем своей цепочки, проверьomniroute doctor, подписку к OmniRoute не подключай.