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

Чек-лист по установке и настройке пяти дополнений для Claude Code: память между сессиями, наблюдение за работой агента, экономия контекста, резервные модели и автоматизация проекта.

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

- [ ] Установите [Claude Code](https://code.claude.com/docs/en/setup) и настройте вход через тариф 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 в своей стране](https://www.anthropic.com/supported-countries). России в приведённом списке нет.
- [ ] Установите [Node.js](https://nodejs.org/en/download) и проверьте версию командой `node -v`.

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

- [ ] Установите [uv](https://docs.astral.sh/uv/getting-started/installation/) для 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](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/claude-code-setup): `/plugin install claude-code-setup@claude-plugins-official`.

- Если маркетплейс не найден, выполните `/plugin marketplace add anthropics/claude-plugins-official` и повторите установку. Каталог также доступен через `/plugin` → Discover; [справка о плагинах](https://code.claude.com/docs/en/discover-plugins).
- Если появится запрос на перезагрузку плагинов, выполните `/reload-plugins`; при предупреждении о кэше — `/reload-plugins --force`.

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

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

- [ ] Установите [claude-mem](https://github.com/thedotmack/claude-mem) одним способом ([инструкция](https://docs.claude-mem.ai/installation)):

- В 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](https://github.com/rebelytics/one-skill-to-rule-them-all) из [последнего релиза](https://github.com/rebelytics/one-skill-to-rule-them-all/releases/latest) (`task-observer.skill`) либо скопируйте файлы из репозитория:

```bash
  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»](https://github.com/rebelytics/one-skill-to-rule-them-all/blob/main/references/environments.md), скопируйте блок активации в `CLAUDE.md` и замените `[ABSOLUTE PATH]` полным путём к папке наблюдений, например к корню проекта.
- [ ] Начните новую сессию и проверьте вызов скилла до первого обращения к инструментам. После нескольких рабочих сессий проверьте папку `skill-observations/observation-log/`.

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

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

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

- [ ] Установите [Headroom](https://github.com/headroomlabs-ai/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; [порядок выбора учётных данных](https://code.claude.com/docs/en/authentication).

- При использовании подписки Pro или Max учтите риск: `headroom wrap claude` проводит запросы с токеном подписки через сторонний прокси. Сверьтесь с [правилами Claude Code](https://code.claude.com/docs/en/legal-and-compliance). В [обсуждении Headroom](https://github.com/headroomlabs-ai/headroom/discussions/969) также описан случай, когда сжатие с 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](https://github.com/diegosouzapw/OmniRoute): `npm install -g omniroute`, затем `omniroute`.

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

- [ ] В панели откройте Providers, добавьте ключи выбранных провайдеров, например Gemini, Groq, Cerebras или Mistral. Ключ создаётся у каждого провайдера отдельно; [руководство по провайдерам и цепочкам](https://github.com/diegosouzapw/OmniRoute/blob/main/docs/guides/USER_GUIDE.md).
- [ ] Проверьте `http://localhost:20128/dashboard/free-tiers` и [условия бесплатных тарифов](https://github.com/diegosouzapw/OmniRoute/blob/main/docs/reference/FREE_TIERS.md) до выбора моделей.

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

- [ ] Не подключайте вход в подписку Claude Free, Pro или Max к OmniRoute и не храните там токен входа; ориентируйтесь на [правила Claude Code](https://code.claude.com/docs/en/legal-and-compliance). Выберите один сценарий:

- **Подписка 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](https://github.com/diegosouzapw/OmniRoute/blob/main/docs/guides/CLAUDE-CODE-CONFIGURATION.md).

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

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

- **По очереди:** работайте через `headroom wrap claude`. Когда лимит Claude закончится, выйдите и запустите `omniroute run claude --model <провайдер/модель>`, затем `/resume`. У OmniRoute есть собственное сжатие RTK + Caveman.
- **В связке:** отправляйте запросы из Headroom в OmniRoute через [`ANTHROPIC_TARGET_API_URL`](https://headroomlabs-ai.github.io/headroom/configuration/). В первом окне терминала запустите `ANTHROPIC_TARGET_API_URL=http://localhost:20128 headroom proxy --port 8787`. Во втором запустите команду ниже, подставив ключ из Dashboard → Endpoints и подключённую модель или цепочку:

```bash
    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:**

```text
recommend automations for this project
```

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

```text
Посоветуй автоматизации для этого проекта: MCP-серверы, скиллы, хуки.
```

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

```text
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.

---

Источник: https://localhost:3000/m/chek-list-5-dopolneniy-k-claude-code