5 дополнений к Claude Code

0. Подготовка

• Установите Claude Code и настройте вход через тариф Claude (Pro, Max, Team или Enterprise) либо ключ API из Claude Console.

• macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash.

• macOS через Homebrew: brew install --cask claude-code.

• Windows: winget install Anthropic.ClaudeCode.

• Проверьте доступность Claude в своей стране. России в приведённом списке нет.

• Установите Node.js и проверьте версию командой node -v.

• Для OmniRoute нужна ветка 22 начиная с 22.22.2 либо версия 24–26; для claude-mem — 20 и выше. Node.js 24 подходит обоим.

• Установите uv для Headroom.

• macOS и Linux: curl -LsSf https://astral.sh/uv/install.sh | sh. Команда для Windows — в документации uv.

• Проверьте расходы: сами пять дополнений бесплатны; отдельно оплачиваются Claude и модели, которые вы подключите.

1. Claude Code Setup: рекомендации для проекта

• Откройте Claude Code в папке нужного проекта: cd путь/к/проекту && claude.

• Установите Claude Code Setup: /plugin install claude-code-setup@claude-plugins-official.

• Если маркетплейс не найден, выполните /plugin marketplace add anthropics/claude-plugins-official и повторите установку. Каталог также доступен через /plugin → Discover; справка о плагинах.

• Если появится запрос на перезагрузку плагинов, выполните /reload-plugins; при предупреждении о кэше — /reload-plugins --force.

• Отправьте плагину готовый запрос из раздела «Промпты» ниже. Проверьте предложенные MCP-серверы, скиллы, хуки, субагентов и слэш-команды; выберите нужные для проекта. Плагин анализирует проект без изменения файлов.

2. claude-mem: память между сессиями

• Установите claude-mem одним способом (инструкция):

• В Claude Code: /plugin marketplace add thedotmack/claude-mem, затем /plugin install claude-mem.

• Через терминал: npx claude-mem install --provider claude. Этот флаг использует тариф Claude для сжатия заметок без регистрации на cmem.ai; при выборе модели возьмите Haiku, чтобы меньше расходовать лимит.

• Перезапустите Claude Code. Откройте новую сессию в том же проекте и проверьте, что в начале появился контекст прошлых сессий. Данные хранятся в ~/.claude-mem/.

• Если память перестала работать после обновления, выполните npx claude-mem repair, затем начните новую сессию.

• Не используйте npm install -g claude-mem для установки памяти: так ставится библиотека без нужных хуков.

• Установка через npx claude-mem install без --provider claude предлагает вход на cmem.ai и пробный период CMEM Pro; далее возможны подписка или возврат к расходу своего тарифа Claude. Также доступны собственные ключи OpenRouter или Gemini.

• В шапке README проект может называться Grok Mem; пакет и команды по-прежнему называются claude-mem.

3. Task Observer: наблюдения и предложения по скиллам

• Установите Task Observer из последнего релиза (task-observer.skill) либо скопируйте файлы из репозитория:

  git clone https://github.com/rebelytics/one-skill-to-rule-them-all.git
  mkdir -p ~/.claude/skills/task-observer
  cp -R one-skill-to-rule-them-all/SKILL.md one-skill-to-rule-them-all/references one-skill-to-rule-them-all/scripts ~/.claude/skills/task-observer/

• ~/.claude/skills/task-observer/ включает скилл для всех проектов, .claude/skills/task-observer/ внутри проекта — только для него. При ручном копировании нужны вместе SKILL.md, references/ и scripts/.

• Откройте references/environments.md, раздел «The activation block», скопируйте блок активации в CLAUDE.md и замените [ABSOLUTE PATH] полным путём к папке наблюдений, например к корню проекта.

• Начните новую сессию и проверьте вызов скилла до первого обращения к инструментам. После нескольких рабочих сессий проверьте папку skill-observations/observation-log/.

• Если папка не появилась, проверьте блок активации в CLAUDE.md.

• В конце сессии отправьте запрос из раздела «Промпты». Просмотрите предложения в skill-updates/ и одобрите подходящие правки; Task Observer не вносит их самостоятельно.

4. Headroom: сжатие ответов инструментов

• Установите Headroom: uv tool install --python 3.13 "headroom-ai[all]".

• В готовом Python-окружении допустимо pip install "headroom-ai[all]". Пакет npm headroom-ai не содержит команду headroom.

• Определите способ оплаты Claude до подключения прокси. Для работы с ключом API задайте ANTHROPIC_API_KEY из Claude Console и подтвердите его в Claude Code; порядок выбора учётных данных.

• При использовании подписки Pro или Max учтите риск: headroom wrap claude проводит запросы с токеном подписки через сторонний прокси. Сверьтесь с правилами Claude Code. В обсуждении Headroom также описан случай, когда сжатие с Pro без API-ключа не заработало.

• Запускайте сессию командой headroom wrap claude. Если Serena для навигации по коду не нужна, используйте headroom wrap claude --code-memory none.

• Проверьте маршрут командой headroom doctor, а реальную экономию — headroom dashboard при работающем прокси или headroom savings по накопленному трафику.

• Наибольший эффект ожидается на логах, JSON и результатах поиска; на обычном тексте экономия может быть почти нулевой. Если экономия не растёт, не считайте сжатие работающим только по факту запуска.

• Если Headroom больше не нужен, отмените настройку командой headroom unwrap claude.

5. OmniRoute: запасные модели

• Установите и запустите OmniRoute: npm install -g omniroute, затем omniroute.

• Панель: http://localhost:20128; API: http://localhost:20128/v1.

• В панели откройте Providers, добавьте ключи выбранных провайдеров, например Gemini, Groq, Cerebras или Mistral. Ключ создаётся у каждого провайдера отдельно; руководство по провайдерам и цепочкам.

• Проверьте http://localhost:20128/dashboard/free-tiers и условия бесплатных тарифов до выбора моделей.

• Пометка avoid сама не отключает провайдера: не подключайте и не выбирайте такие модели, в том числе Kiro и OpenCode Free. Указанные в материале «до 1,5 млрд токенов в месяц» — сумма документированных лимитов при подключении соответствующих пулов; около 1 млрд приходится на Mistral. Это не лимит одного готового аккаунта.

• Не подключайте вход в подписку Claude Free, Pro или Max к OmniRoute и не храните там токен входа; ориентируйтесь на правила Claude Code. Выберите один сценарий:

• Подписка Claude + запасные модели. Работайте в Claude Code как обычно. Когда лимит закончится, выйдите и запустите omniroute run claude --model <провайдер/модель>; внутри используйте /resume для продолжения сессии.

• Работа через шлюз. Подключите к OmniRoute ключ API Anthropic из Console с оплатой по факту и выбранных других провайдеров. Перед использованием auto выключите в Providers переключатель «No authentication required» у OpenCode Free и Felo, чтобы убрать их из списка моделей, затем запускайте omniroute run claude --model auto.

• Своя цепочка вместо auto. В Dashboard → Combos → Create New создайте, например, my-free, добавьте модели в нужном порядке и запускайте omniroute run claude --model my-free. При исчерпании лимита одной модели шлюз перейдёт к следующей.

• Проверьте подключённые модели: curl http://localhost:20128/v1/models -H "Authorization: Bearer <ключ из Dashboard → Endpoints>".

• omniroute launch запускает Claude Code через шлюз с моделью Claude по умолчанию. Для других моделей используйте omniroute run claude --model … либо omniroute launch --profile <имя> после omniroute setup-claude; настройка Claude Code.

6. Если нужны и Headroom, и OmniRoute

• Выберите способ запуска; не запускайте две обёртки wrap/run поверх одной сессии.

• По очереди: работайте через headroom wrap claude. Когда лимит Claude закончится, выйдите и запустите omniroute run claude --model <провайдер/модель>, затем /resume. У OmniRoute есть собственное сжатие RTK + Caveman.

• В связке: отправляйте запросы из Headroom в OmniRoute через ANTHROPIC_TARGET_API_URL. В первом окне терминала запустите ANTHROPIC_TARGET_API_URL=http://localhost:20128 headroom proxy --port 8787. Во втором запустите команду ниже, подставив ключ из Dashboard → Endpoints и подключённую модель или цепочку:

    ANTHROPIC_BASE_URL=http://localhost:8787 ANTHROPIC_AUTH_TOKEN=<ключ из Dashboard → Endpoints> ANTHROPIC_MODEL=<провайдер/модель или имя цепочки> claude

ANTHROPIC_MODEL обязателен: без него Claude Code запросит модель Claude по умолчанию.

• Для связки выполните headroom doctor и убедитесь, что запросы появились в панели OmniRoute.

Промпты для копирования

Рекомендации Claude Code Setup:

recommend automations for this project

Русский вариант из материала:

Проверка наблюдений Task Observer в конце сессии:

Any observations logged?

Быстрая диагностика

• Если /plugin не распознаётся, проверьте claude --version и обновите Claude Code: brew upgrade claude-code при установке через Homebrew либо повторите команду установочного скрипта.
• Если Claude Code не видит официальный маркетплейс, выполните /plugin marketplace add anthropics/claude-plugins-official.
• Если claude-mem не подгружает контекст, выполните npx claude-mem repair и откройте новую сессию.
• Если Task Observer не ведёт журнал, проверьте блок активации в CLAUDE.md.
• Если команда headroom не найдена, установите Headroom через uv, а не через npm.
• Если OmniRoute сообщает о неподходящей версии Node.js, проверьте node -v: нужна 22.22.2+ в ветке 22 либо 24–26.