Моды в Claude Code: как переделать Claude под себя — полная инструкция

Раньше Claude Code у всех выглядел одинаково: чат, поле ввода, спиннер. Хотел видеть, сколько контекста осталось, или чтобы агент не удалял файлы без спроса, — ставил сторонние скрипты и надеялся, что они не сломаются. С октября 2026 года это решается одной фразой. Пишешь Claude, что хочешь, — и он сам дописывает себе панель, кнопку или правило, прямо в работающей сессии. Эта штука называется моды. Ниже — всё, что нужно, чтобы начать пользоваться ими сегодня: готовые фразы, как сохранить мод, где брать чужие и где подводные камни.

Что такое мод

Мод — это маленькая программа внутри Claude Code. Как мод в игре: ты меняешь не свой проект, а сам инструмент, которым работаешь.

Технически мод — это обычный плагин Claude Code, в котором лежит код на JavaScript или TypeScript. Claude Code вызывает этот код на свои события: Claude собирается запустить команду, ты отправил сообщение, интерфейс перерисовывается. Мод на каждом таком событии может:

• подсмотреть — например, посчитать, сколько раз Claude вызвал инструменты;
• поменять — переписать твой промпт или дописать текст к спиннеру;
• ответить сам — запретить команду или выполнить её по-своему.

Что это даёт на практике:

• Свой интерфейс. Панель справа от чата или полоса над полем ввода — с вкладками, кнопками и полями ввода.
• Перерисовка родного интерфейса. Спиннер, строки вызовов инструментов, окно вопросов Claude.
• Контроль над действиями. Задержать опасную команду, спросить тебя и только потом пустить дальше. Или отправить запрос другой модели.
• Свои команды. /команда, которая срабатывает мгновенно, без ответа Claude, — даже пока он работает.

Важно: окно разрешений мод перерисовать не может. То, что Claude Code спрашивает у тебя перед опасным действием, всегда остаётся честным.

Чем мод отличается от хуков, скиллов и MCP

Что нужно, чтобы начать

• Claude Code версии 2.1.287 или новее в терминале. Проверить: claude --version. В приложении Claude Desktop (вкладка Code) моды работают с версии 2.1.286 — посмотреть можно командой /status.
• Доступ к Claude Code — любой тариф, на котором он у тебя уже работает (Pro, Max, Team, Enterprise), или API-ключ.
• Моды включены по умолчанию, ничего активировать не нужно.

Где работают:

Единственный нюанс: официально Claude в России недоступен, это стоит учитывать заранее.

Способ 1. Попросить Claude — без единой строчки кода

Это главный способ, и для 90% задач его хватает.

1. Опиши мод словами в обычной сессии Claude Code. Например: сделай мод, который показывает текущую ветку git над полем ввода. Claude подгрузит встроенный скилл plugin-authoring — там всё про устройство модов в твоей версии. Скилл можно вызвать и вручную: /plugin-authoring.
2. Подтверди создание файлов. Claude пишет мод в папку сессии ~/.claude/dev-mods/<id-сессии>/<имя-мода>/. Это защищённая папка, поэтому в обычном режиме Claude Code спросит разрешение на каждый файл.
3. Включи горячую загрузку. Как только появится первый файл, Claude Code спросит: «Enable hot reloading for this session?». Выбери Enable for this session. Мод загрузится сразу после ответа Claude — без перезапуска.
4. Проверь, что мод загрузился. Набери /plugin и открой вкладку Installed — мод будет в списке. Там же его можно выключить.
5. Допиливай словами. Не понравилось — скажи, что поменять. Мод перезагружается в конце каждого ответа, в котором Claude его поправил.

10 фраз для первых модов

Копируй в Claude Code как есть. Каждую можно менять под себя — Claude поймёт.

1. Ветка git всегда перед глазами — чтобы не закоммитить не туда.

Сделай мод, который показывает текущую ветку git над полем ввода

2. График контекста — видишь заранее, когда пора начинать новый чат.

Сделай мод: панель справа с графиком, сколько контекста занято после каждого запроса. Если больше 80% — подсвети красным и напиши «пора в новый чат»

3. Панель субагентов — моя любимая. Видно, кого Claude запустил, что делает каждый и кто уже закончил.

Сделай мод: панель справа, где видно, каких субагентов запустил Claude, что делает каждый (задача, тип агента, текущее действие) и кто уже закончил (статус и время работы). Плюс команда /subagents, чтобы открыть или закрыть панель

4. Страховка от удаления — Claude не снесёт тебе проект.

Сделай мод: если Claude собирается выполнить rm -rf, git reset --hard или git push --force — останови команду, покажи, какие файлы она затронет, и дай кнопки «Продолжить» и «Отмена»

5. Запрет трогать секреты.

Сделай мод, который запрещает Claude читать и править файлы .env и всё, что лежит в папке secrets. Вместо этого пусть объясняет, что файл защищён

6. «Готово!» голосом — можно отойти, пока Claude работает. Мод говорит системным голосом компьютера: чтобы «готово» звучало по-русски, в настройках системы должен быть установлен русский голос.

Сделай мод: если ответ Claude шёл дольше минуты, по завершении покажи уведомление «Claude закончил» и скажи голосом «готово»

7. Счётчик действий у спиннера.

Сделай мод, который во время работы показывает рядом со спиннером, сколько инструментов Claude уже вызвал в этом ответе

8. Повтор правок — разобраться, что Claude сделал за последний ответ.

Сделай мод с командой /replay: она открывает панель и пошагово показывает правки файлов из последнего ответа Claude, с кнопками «Назад» и «Дальше»

9. Правило ко всем промптам.

Сделай мод, который к каждому моему сообщению добавляет для Claude правило: отвечай по-русски, коротко и сначала давай план, потом код

10. Заметки рядом с чатом.

Сделай мод с командой /note: она открывает панель заметок с полем ввода, куда я записываю мысли по проекту. Заметки должны сохраняться между сессиями

Ловушка: мод живёт в одной сессии

Вот где спотыкаются все. Мод, который написал Claude, загружается только в той сессии, где его сделали. А папку ~/.claude/dev-mods/ Claude Code со временем чистит. Закрыл сессию, открыл новую — мода нет.

Чтобы мод остался, перенеси его к себе. Проще всего попросить Claude:

Скопируй мод, который ты сделал, в папку ~/mods и сделай так, чтобы он загружался во всех моих сессиях

Что произойдёт под капотом:

• папка мода переедет, например, в ~/mods/git-branch;
• запускать с ним можно так: claude --plugin-dir ~/mods/git-branch;
• чтобы мод грузился всегда, полный путь к его папке прописывается в переменную CLAUDE_CODE_PLUGIN_DIRS в разделе env файла ~/.claude/settings.json. Путь именно полный, вроде /Users/имя/mods/git-branch: сокращение ~ там не сработает. Несколько модов — через двоеточие. Так мод подхватывается и в приложении Claude Desktop, куда флаг не передать.

Способ 2. Написать мод самому

Если хочется понять, как это устроено, — мод состоит из трёх файлов. Node.js, сборщик и компиляция не нужны: Claude Code читает .js и .ts напрямую.

my-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

plugin.json — паспорт плагина:

{
  "name": "my-mod",
  "version": "0.1.0",
  "description": "Уведомляет, когда Claude закончил, и считает ответы"
}

hooks.json — говорит, где лежит код. Именно ключ modules делает плагин модом:

{ "modules": ["./register.js"] }

register.js — сам мод. Этот пример показывает уведомление после каждого ответа Claude и добавляет команду /turns:

let turns = 0

export function register(on) {
  // при старте сессии регистрируем свою команду
  on('session.start', async ($, e, next) => {
    await $.command.register({ name: 'turns', description: 'Сколько ответов дал Claude' })
    return next(e)
  })

  // Claude закончил ответ (субагентов не считаем)
  on('turn.complete', async ($, e, next) => {
    if (e.agentId === undefined) {
      turns += 1
      $.ui.toast('Claude закончил ✓')
    }
    return next(e)
  })

  // ответ на команду /turns — без участия Claude
  on('command.run', { command: 'turns' }, async () => {
    return { text: 'Ответов за сессию: ' + turns }
  })
}

Как это читать: on('событие', обработчик) — подписка на событие. В обработчик приходят три вещи: $ — всё, что мод может сделать (рисовать, читать файлы, вызывать модель), e — данные события, next(e) — «пусти дальше как обычно». Не вызвал next — значит, ответил сам.

Запуск и проверка:

# загрузить мод на одну сессию; при сохранении файла он перезагружается сам
claude --plugin-dir ./my-mod

# посмотреть, какие события мод слушает и что он делает, — без запуска
claude plugin validate ./my-mod

# прогнать тесты мода (файлы *.test.ts), без сессии и без интернета
claude plugin test

Подсказки по API писать не придётся: когда мод загружен, Claude Code сам кладёт в папку .claude-plugin/types/ описания всех событий и методов твоей версии. Редактор подхватывает их и подсказывает. События и методы меняются от версии к версии — этим файлам верь больше, чем любой статье, включая эту.

Где брать готовые моды

Отдельного «магазина модов» нет — мод распространяется как обычный плагин. Значит, ищем там же, где плагины.

Официальный маркетплейс Anthropic — claude-plugins-official. Он подключается сам при первом запуске Claude Code. Каталог:

• в Claude Code: команда /plugin, вкладка Discover, можно искать по названию;
• на сайте: claude.com/marketplace/plugins — там видно число установок и отметку «Anthropic verified».

Установка из него:

/plugin install <имя>@claude-plugins-official

В приложении Claude Desktop то же самое делается мышкой: кнопка + рядом с полем ввода → Plugins → Add plugin.

Комьюнити-маркетплейс — плагины, которые авторы прислали в Anthropic:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install <имя>@claude-community

Примеры модов от Anthropic — три готовых мода в репозитории claude-code-playground. Их выкладывают как есть, без поддержки:

• token-weather — «прогноз погоды» для контекста над полем ввода: Clear → Showers → Storm по мере заполнения;
• blast-radius — держит опасные команды вроде rm -rf и force push, показывает, что они затронут, и даёт кнопки Proceed / Cancel;
• replay-theater — команда /replay, которая пошагово показывает правки из последнего ответа.

Как поставить:

git clone https://github.com/anthropics/claude-code-playground.git
cd claude-code-playground
claude

Потом в открывшемся Claude Code:

/plugin marketplace add ./claude-code/mods
/plugin install token-weather@claude-code-playground-mods

Маркетплейс указывает на твою копию репозитория — удалишь папку, моды перестанут загружаться.

Живые демо всех трёх модов есть на странице claude.dev/mods.

Сторонние маркетплейсы — любой GitHub-репозиторий с файлом .claude-plugin/marketplace.json. Подключаются так же: /plugin marketplace add владелец/репозиторий. Anthropic их не проверяет — читай раздел про безопасность ниже.

Встроенные моды. Часть функций самого Claude Code уже сделана на модах: команда /diff, загрузка AGENTS.md и подсказки «You should know» (их отдельный агент показывает, когда находит то, что ты мог упустить; по умолчанию выключены). Их видно в /plugin → Installed → раздел Built-in.

Безопасность: прочитай до установки чужого мода

Мод — это код, который работает с твоими правами и без песочницы. Загрузившись, он может:

• читать и менять любые файлы, к которым есть доступ у тебя, запускать программы и ходить в интернет;
• видеть переменные окружения и настройки — включая API-ключи;
• видеть все твои промпты и все действия Claude;
• переписать промпт или команду и сам одобрить действие, о котором Claude Code спросил бы тебя;
• тратить твой лимит, вызывая модель.

Даже если включена песочница Claude Code, она изолирует только команды самого Claude — процессы, которые запускает мод, идут мимо неё.

Правила простые:

Ставь моды только от авторов и из маркетплейсов, которым доверяешь.

Перед установкой посмотри, что мод делает, — без запуска:

claude plugin validate ./папка-мода

В выводе строки hooks: и calls: покажут, на какие события мод подписан и что он вызывает: чтение файлов, сеть, запуск процессов.

Если что-то пошло не так — выключай:

• один мод: /plugin → Installed → выключить или удалить;
• все моды на одну сессию: запусти claude --safe-mode (выключит и остальные твои настройки — скиллы, хуки, плагины);
• все установленные моды везде: "disableAllHooks": true в ~/.claude/settings.json (выключит и обычные хуки, и кастомную строку статуса).

Встроенные моды Claude Code (/diff, AGENTS.md) эти настройки не трогают — их выключают отдельно в /plugin.

Управление модами: шпаргалка

Мой вывод

Моды — первое обновление Claude Code, после которого инструмент перестаёт быть одинаковым для всех. Я за один вечер сделал себе панель субагентов: теперь вижу, кого Claude запустил, что каждый делает и кто закончил, — раньше это была чёрная коробка. Начни с одной фразы из списка выше, а понравившийся мод сразу перенеси в ~/mods, чтобы он не пропал вместе с сессией.

И главное — чужие моды ставь с той же осторожностью, что и чужой код. Потому что это и есть чужой код.

Больше разборов про Claude Code и вайб-кодинг — в моём Telegram-канале: https://t.me/neprostonewsai

Источники: документация Claude Code по модам, анонс в блоге Claude, гайд «Getting started with Claude Code mods», маркетплейсы Anthropic.