# 4 бесплатных инструмента для Claude Code: ставим по шагам

Здесь установка всех 4-х инструментов из ролика: что понадобится, команды по шагам, как проверить, что каждый работает, и чего от него ждать. Порядок от самого простого к самому сложному: сначала два плагина, потом Graphify, в конце OmniRoute.

## Что ставим

| # | Что | Что делает | Как ставится | Лицензия |
|---|---|---|---|---|
| 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`, через Homebrew `brew install --cask claude-code`, на Windows `winget 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`, на Windows `winget install astral-sh.uv`. Подробно: https://docs.astral.sh/uv/getting-started/installation/
- **Доступ к Claude из твоей страны.** Список стран: https://www.anthropic.com/supported-countries. России в нём нет.

## Шаг 1. Ponytail: меньше лишнего кода

1. Открой Claude Code в папке проекта: `cd путь/к/проекту && claude`.
2. Отправь первой отдельной репликой `/plugin marketplace add DietrichGebert/ponytail`, а второй отдельной репликой `/plugin install ponytail@ponytail`. Одной строкой обе команды не сработают, авторы пишут об этом прямо.
3. Если после установки видишь «Run /reload-plugins to activate», Claude Code сам перезагрузит плагины. Если он предупреждает, что следующее сообщение перечитает весь диалог, набери `/reload-plugins --force`.
4. Проверка: набери `/ponytail` без слов, он назовёт текущий уровень. По умолчанию стоит `full`.
5. Уровни: `/ponytail lite` мягче, `/ponytail full` обычный, `/ponytail ultra` жёстче всего, `/ponytail off` выключает. Уровень для всех новых сессий задаётся переменной `PONYTAIL_DEFAULT_MODE`.
6. Полезные команды: `/ponytail-review` проверяет текущие изменения на лишнее и даёт список, что удалить, `/ponytail-audit` делает то же по всему проекту, `/ponytail-debt` собирает в журнал всё, что отложено на потом, `/ponytail-gain` показывает таблицу экономии из замеров авторов.
7. Чего ждать. Сильнее всего Ponytail режет там, где агент раньше городил своё: в замере авторов выбор даты сократился с 404 строк до 23, потому что вместо компонента встало обычное поле браузера. На коде, который и так минимален, разницы почти нет. Проверки безопасности он не выкидывает.
8. Если команды Ponytail работают, а постоянный режим молчит, значит хуки не нашли `node`. У тех, кто ставил Node через nvm, путь к `node` должен быть виден и в неинтерактивной оболочке.
9. Удаление: `/plugin remove ponytail`.

## Шаг 2. Agent Skills: скиллы на каждый этап

1. В Claude Code отправь `/plugin marketplace add addyosmani/agent-skills`, потом `/plugin install agent-skills@addy-agent-skills`.
2. Если маркетплейс не добавляется из-за ошибки SSH, добавь его по HTTPS-адресу: `/plugin marketplace add https://github.com/addyosmani/agent-skills.git`, а затем повтори установку.
3. Проверка: набери `/` и найди в списке команды набора: spec, plan, build, test, review, ship.
4. Порядок на новой задаче:

- `/spec` - сначала спецификация: Claude задаёт вопросы и сохраняет SPEC.md;
- `/plan` - разбивка на маленькие задачи с критериями готовности и проверкой;
- `/build` - реализует следующую задачу через тест и коммит; `/build auto` делает весь план после одного одобрения;
- `/test` - тесты, а для бага сначала тест, который его воспроизводит;
- `/review` - ревью по пяти осям: корректность, читаемость, архитектура, безопасность, производительность;
- `/ship` - чек-лист перед запуском и решение, выпускать или нет.

5. Есть ещё `/code-simplify` для упрощения кода, `/constraints` для правил качества и `/webperf` для скорости сайта.
6. Отдельно вызывать скиллы не нужно: Claude сам подключает подходящий, например при проектировании API или при работе с интерфейсом.
7. В других агентах, например Cursor или Codex, набор ставится одной командой `npx skills add addyosmani/agent-skills`.

## Шаг 3. Graphify: граф проекта вместо перечитывания файлов

1. Установи программу: `uv tool install graphifyy`. В названии пакета две буквы y, другие пакеты graphify к проекту не относятся. Если после установки терминал пишет `graphify: command not found`, выполни `uv tool update-shell` и открой новый терминал.
2. Зарегистрируй скилл в Claude Code: `graphify install`.
3. Открой Claude Code в папке проекта и набери `/graphify .`. Появится папка `graphify-out/`, в ней `graph.html` (граф, который открывается в браузере), `GRAPH_REPORT.md` (главные узлы и связи) и `graph.json` (весь граф).
4. Чтобы Claude сам шёл в граф, в папке проекта выполни `graphify claude install`. После этого перед поиском и чтением файлов хук подсказывает Claude сначала спросить граф. Жёсткий вариант: `graphify install --project --strict`, тогда первое чтение сырых файлов за сессию перенаправляется в граф.
5. Добавь в файл `.claudeignore` в корне проекта две строки: `graph.json` и `graphify-out/`. Иначе каждое обновление графа сбрасывает кэш промпта Claude Code, и следующий запрос выходит дороже.
6. Держи граф свежим: `graphify hook install` пересобирает его после каждого коммита и переключения ветки, после `git pull` выполни `graphify update .`, а после правок в документах набери в Claude Code `/graphify --update`. Если запрос не видит только что добавленное, сначала `graphify update .`.
7. Код разбирается прямо на твоём компьютере, без модели и без токенов. Документы, PDF и картинки идут через модель ассистента, это расходует лимит.
8. Проверка: `graphify query "как связаны авторизация и база данных"` или `graphify explain "ИмяКласса"` - в ответе будут узлы и связи из твоего проекта.
9. Если видишь `ModuleNotFoundError: No module named 'graphify'`, значит пакет ставился через pip в другое окружение: переустанови через `uv tool install graphifyy`.

## Шаг 4. OmniRoute: бесплатные модели, когда кончается лимит

1. Установка и запуск: `npm install -g omniroute`, затем `omniroute`. Панель откроется в браузере по адресу `localhost:20128`.
2. Подключи провайдеров: панель → Providers. Для бесплатного запаса бери провайдеров с ключом API, например Gemini, Groq, Cerebras или Mistral: регистрируешься у провайдера, создаёшь ключ и вставляешь его в карточку.
3. Открой страницу `localhost:20128/dashboard/free-tiers`: там видно, сколько бесплатных токенов осталось, и пометки по условиям провайдеров. Цифра «до 1,5 миллиарда токенов в месяц» - сумма документированных бесплатных лимитов, она набирается, только если подключить эти бесплатные пулы, и около 1 миллиарда из неё даёт Mistral. У 15 провайдеров стоит пометка avoid: по разбору авторов OmniRoute их условия конфликтуют с работой через такой шлюз, среди них Kiro и OpenCode Free. Пометка сама ничего не выключает, поэтому не подключай их.
4. **Не подключай в OmniRoute вход в подписку Claude.** Правила Claude Code запрещают пропускать запросы через учётные данные тарифов Free, Pro и Max в сторонних программах и хранить там токены входа, за это можно потерять аккаунт. Модели Claude в цепочку добавляй только через ключ API из Console.
5. Собери свою цепочку: Dashboard → Combos → Create New. Дай имя, например `my-free`, и добавь модели провайдеров из пункта 2 в нужном порядке. Имя цепочки дальше пишешь вместо названия модели. Упрётся одна модель в лимит - шлюз перейдёт к следующей.
6. Запусти Claude Code через цепочку: `omniroute run claude --model my-free`.
7. Если используешь модель `auto` вместо своей цепочки: на свежей установке в неё уже встроены провайдеры без ключей OpenCode Free и Felo. Открой в Providers их страницы и выключи переключатель рядом с «No authentication required», тогда провайдер и его модели пропадут из списка.
8. На подписке Claude работаешь в Claude Code как обычно. Кончился лимит - выходишь, запускаешь `omniroute run claude --model my-free`, внутри набираешь `/resume` и продолжаешь прошлую сессию уже на бесплатных моделях. Если `/resume` выдаёт ошибку или сессия не помещается в окно бесплатной модели - начни новую сессию и коротко перескажи задачу.
9. Проверка: `curl localhost:20128/v1/models -H "Authorization: Bearer ключ из Dashboard → Endpoints"` - в ответе список подключённых моделей. Диагностика провайдеров и портов: `omniroute doctor`.

## Если что-то не работает

- **`/plugin` не распознаётся** - проверь версию `claude --version` и обнови Claude Code: через Homebrew `brew 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 не подключай.

---

Источник: https://localhost:3000/m/4-besplatnyh-instrumenta-dlya-claude-code-stavim-po-shagam