Кастомныеslash-команды Claude Code

Если ты пишешь Claude один и тот же длинный промт в каждом проекте — «сделай ревью по нашему чек-листу», «собери коммит по конвенции», — самое время превратить его в команду. Кастомная slash-команда (своя команда через слеш) — это просто markdown-файл с готовым промтом, к которому ты обращаешься коротким /имя. Никакого кода, никаких плагинов: создал файл, и команда работает.

Часть 1 · Понятие

Что такое своя slash-команда

Расшифруем. Slash-команда — это всё, что ты вводишь в чате Claude Code через слеш: /clear, /compact, /init. Встроенные команды идут «из коробки». А кастомные ты добавляешь сам: кладёшь файл в специальную папку, и его имя становится новой командой. Внутри файла — обычный текст, тот самый промт, что ты раньше копировал вручную.

Зачем это нужно. Промт, который ты повторяешь, перестаёт жить в голове и буфере обмена. Он лежит в файле, его видит вся команда (если файл в гите), его можно улучшать как код. Разовое поручение остаётся промтом, а вот повторяемый сценарий заслуживает своей команды.

Команда, скил, промт — в чём разница

Полный разбор встроенных команд — в гайде про все команды Claude Code. А чем команда отличается от навыка, который подключается сам, — подробно в гайде про скилы Claude Code.

Часть 2 · Старт

Первая команда за минуту

Сделаем команду /review, которая запускает ревью кода по твоему чек-листу. Создаём папку и файл внутри проекта:

# Папка для проектных команд (поедет в гит вместе с кодом)
mkdir -p .claude/commands

# Дальше кладём review.md — имя файла станет именем команды /review

Содержимое review.md — обычный markdown. Это и есть промт, который выполнится по команде /review:

Сделай ревью изменений в текущей ветке. Проверь по чек-листу:

1. Логика и крайние случаи (пустой ввод, ошибки, гонки)
2. Обработка ошибок — нет проглоченных исключений
3. Нет утечек секретов и небезопасных мест
4. Тесты покрывают новое поведение

Выдай список замечаний по приоритету, без воды.

Теперь в чате Claude Code набираешь /review, и модель выполняет ровно этот сценарий. Не нужно каждый раз вспоминать формулировку: она зафиксирована в файле. Хочешь поправить чек-лист — правишь файл, как обычный код.

Часть 3 · Динамика

Аргументы и вывод терминала

Команда без аргументов делает всегда одно и то же. Но часто хочется параметра: «протестируй вот этот паттерн», «почини вот эту задачу». Тут и нужен $ARGUMENTS — на его место встанет всё, что ты напишешь после имени команды.

---
argument-hint: [паттерн-теста]
description: Прогнать тесты по паттерну и починить упавшие
---

Прогони тесты по паттерну: $ARGUMENTS

1. Определи фреймворк тестов (Jest, pytest и т.п.)
2. Запусти тесты с этим паттерном
3. Если упали — найди причину и почини
4. Перезапусти, чтобы убедиться, что зелено

Вызов /test auth подставит auth на место $ARGUMENTS. Если аргументов несколько и они разные по смыслу — разбирай их позиционно через $0 и $1. Например, для команды /fix-issue 123 high в теле $0 будет 123, а $1 — high.

Подтянуть вывод bash в промт

Команда может сама собрать контекст из терминала ещё до того, как Claude начнёт работу. Префикс ! перед строкой в обратных кавычках выполняет bash-команду, и её вывод попадает прямо в промт. Это мощно для команд вокруг git:

---
# Перечисляем, какие именно bash-вызовы команде разрешены
allowed-tools: Bash(git add *), Bash(git status *), Bash(git commit *)
description: Собрать git-коммит по изменениям
---

## Контекст

- Текущий статус: !`git status`
- Текущий дифф: !`git diff HEAD`

## Задача

Собери коммит с осмысленным сообщением по этим изменениям.

К моменту, когда Claude читает задачу, статус и дифф уже подставлены в текст. Модель не тратит ход на отдельный вызов git status — контекст готов. Безопасный git-воркфлоу с командами и ветками разбираем отдельно в гайде про Claude Code и Git.

Часть 4 · Заголовок

Что писать в заголовке команды

Заголовок — это настройки команды. Без него файл всё равно работает, но с ним команда становится аккуратнее: в списке команд видно описание, а Claude понимает границы. Разбор по полям:

---
allowed-tools: Read, Grep, Glob
description: Скан кода на уязвимости
model: claude-opus-4-7
---

Проанализируй код на уязвимости:
- SQL-инъекции
- XSS
- утёкшие секреты и ключи
- небезопасные конфигурации

Здесь команда ограничена чтением (Read, Grep, Glob) — она не сможет ничего изменить, только проанализировать. Это разумно для проверяющих команд: меньше прав, меньше шанс что-то сломать.

Часть 5 · Порядок

Как разложить команды по папкам

Десяток команд в одной папке быстро превращается в кашу. Подпапки наводят порядок: команды по фронту в frontend/, по бэку в backend/. Имя команды от этого не удлиняется, но в списке видно, к какой области она относится.

.claude/commands/
├── frontend/
│   ├── component.md      # /component (группа frontend)
│   └── style-check.md    # /style-check (группа frontend)
├── backend/
│   ├── api-test.md       # /api-test (группа backend)
│   └── db-migrate.md     # /db-migrate (группа backend)
└── review.md             # /review (без группы)

Дальше — по тому же принципу, что и со скилами: заводи команды только под сценарии, которые реально повторяешь. По шагам:

1. Собери повторы. Выпиши промты, которые копируешь из проекта в проект: ревью, коммиты, прогон тестов, генерация бойлера.
2. Заведи по команде на каждый. Файл в .claude/commands/, внутри — тот самый промт.
3. Добавь аргументы, где нужно. Если сценарий меняется от входа — вставь $ARGUMENTS вместо жёсткого значения.
4. Разложи по подпапкам. Когда команд больше пяти — группируй, иначе список перестанет читаться.
5. Чисти. Команда, которой не пользовался месяц, удаляется. Лишние команды только засоряют список.

Повторяемый промт — кандидат в команду. Разовый — остаётся промтом.

Вопросы

Частые вопросы

Читать дальше

Соседние гайды