# Слэш-команды в Claude Code: 3 готовых примера для первого вечера

> Команда слэшом заменяет длинный повторяющийся промпт коротким вызовом через `/`. Показываю, как создать такую команду в Claude Code и что проверять, если она не появляется.

Источник: https://vibeceh.ru/guides/slesh-komandy-korotkij-prompt
Автор: Сергей Мазур · опубликовано 2026-08-06

Если ты ищешь, что такое **команда слэшом**, представь готовый промпт, который больше не приходится копировать руками. В Claude Code он запускается коротким вызовом вроде `/check`: всё, что повторяется из раза в раз, лежит в Markdown-файле, а текст после имени команды можно передать как аргумент. Дальше я показываю, где создать такой файл, как его запустить и почему он иногда не появляется. Это один из приёмов Вайб-кодинга, когда ИИ-агент получает точную инструкцию вместо разговора.

## Что такое команда слэшом?

команда слэшом, или slash command, запускается в Claude Code через `/имя-команды`. Сам список доступных команд открывается вводом `/`, а текст после имени становится аргументами. Вместо длинного промпта с одинаковыми инструкциями ты вводишь короткий вызов, а Claude Code подставляет сохранённые правила и выполняет описанный сценарий.

Выглядит это так:

```text
/check
```

Или так, если команде надо передать уточнение:

```text
/check src/components/
```

Команда распознаётся только в начале сообщения. Символ `/` не делает любой текст командой сам по себе. Сначала Claude Code находит имя в списке, затем берёт всё после имени как аргументы.

Команды управляют Claude Code внутри сессии. Они позволяют быстро переключать модели, управлять разрешениями, очищать контекст, запускать рабочий процесс и многое другое. Введи `/`, чтобы увидеть доступные команды, или `/` и несколько букв, чтобы отфильтровать список. Команда распознаётся только в начале сообщения. Текст после имени команды становится её аргументами. *Перевод с английского.*

Разница с длинным промптом простая:

- длинный промпт приходится снова находить и вставлять;
- команда слэшом хранит эти инструкции в файле;
- короткий вызов легче повторить;
- аргументы можно дописать прямо после имени.

Например, вместо такого сообщения:

```text
Проверь текущий проект. Найди файл зависимостей. Определи команду тестов. Запусти только подходящие тесты. Если тесты упали, покажи первую ошибку, файл и строку. Не исправляй файлы без моего подтверждения.
```

ты пишешь:

```text
/check
```

Сама команда слэшом не становится отдельной программой и не получает новый инструмент. Она запускает сохранённый сценарий через механизм Claude Code. Если инструкции требуют изменения файлов, Claude Code действует по обычным правилам разрешений.

## Зачем заменять длинный промпт командой слэшом?

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

Представь три действия, которые повторяются в каждом рабочем цикле:

1. проверить, что изменилось в проекте;
2. запустить подходящие тесты;
3. собрать отчёт о сделанном.

Каждый раз писать полный набор инструкций неудобно. Часть текста легко забыть. Ещё проще случайно отправить старую версию промпта, где нет нового правила.

Markdown-файл решает именно эту проблему. Ты один раз записываешь последовательность действий, ограничения и формат ответа. Это приём, похожий на [сжатие рабочего промпта до пяти частей](/guides/claude-code-szhat-rabochiy-prompt-bez-poteri-pravil). После этого вызываешь короткое имя:

```text
/check
/test
/report
```

Это не делает результат автоматически правильным. Команда всего лишь удерживает повторяющиеся инструкции в одном месте. Если сам сценарий составлен плохо, Claude Code будет стабильно выполнять плохой сценарий. Поэтому в первой команде лучше оставить одну понятную задачу и явно написать, что нельзя менять файлы без подтверждения.

У готовых команд есть ещё одно практическое преимущество. Их можно посмотреть, поправить и хранить вместе с проектом. Если команда нужна только для одного репозитория, файл лежит внутри `.claude/`. Если это личный шаблон для разных проектов, его можно сохранить в `~/.claude/`.

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

## Как сделать слэш-команды для повторяющихся действий?

выбери одно повторяющееся действие, создай Markdown-файл в `.claude/commands/check.md` или `.claude/skills/check/SKILL.md`, запиши в нём инструкции и запусти `/check` в Claude Code. Имя файла становится именем команды, а текст после вызова передаётся через `$ARGUMENTS`, `$0` и `$1`.

![Мужчина с ладонью на лице смотрит на три шага создания команды и путь к файлу.](https://s3.regru.cloud/crossmark/statejnik/images/guides/slesh-komandy-korotkij-prompt/kadr-1.webp)

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

Не объединяй в первой команде проверку, исправление, коммит и публикацию. Чем шире сценарий, тем сложнее понять, какая инструкция сработала не так.

Для старого поддерживаемого формата создай `.claude/commands/check.md`.

Для рекомендуемого формата создай `.claude/skills/check/SKILL.md`. В нём `check` становится именем команды, а `SKILL.md` остаётся обязательным именем файла. Структура папки и файла подробно разобрана в статье про [первый навык](/guides/skills-navyki-pervyy-navyk-dlya-claude-code-bez-kashi).

   ```text
   .claude/
   ├── commands/
   │   └── check.md
   └── skills/
       └── check/
           └── SKILL.md
   ```

Anthropic продолжает поддерживать оба формата. `.claude/commands/` назван legacy-форматом, а `.claude/skills/<name>/SKILL.md` - рекомендуемым.

Вставь инструкции в Markdown-файл. Для первого запуска подойдёт такая заготовка:

   

Текст команды определяет её поведение. Имя файла определяет имя вызова. Сам файл должен быть Markdown-файлом.

Вставь `$ARGUMENTS` туда, где должен появиться весь текст после имени команды.

   ```markdown
   Проверь часть проекта, указанную после имени команды:

   $ARGUMENTS

   Не исправляй файлы без моего подтверждения.
   ```

Такой файл можно вызвать по-разному:

   ```text
   /check src/components/
/check authentication flow
   ```

Для отдельных аргументов доступны позиционные подстановки `$0`, `$1` и далее. Anthropic показывает такой вариант:

   ```markdown
   ---
   argument-hint: [issue-number] [priority]
   ---

   Исправь issue #$0 с приоритетом $1.
   ```

`$ARGUMENTS` получает весь текст после имени команды. `$0` и `$1` позволяют обращаться к отдельным позициям.

Открой Claude Code из терминала, перейди в нужный проект и введи:

   ```text
   /check
   ```

Если нужны аргументы, добавь их после имени:

   ```text
   /check src/components/
   ```

В Desktop список открывается через `/`. Ещё один путь: кнопка `+`, затем `Slash commands`.

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

Если команда слэшом должна только формировать отчёт, явно напиши это в файле:

   ```markdown
   Не изменяй файлы.
   Не выполняй git commit.
   В конце покажи только результат проверки и список вопросов.
   ```

Такой запрет не заменяет проверку результата. Посмотри, какие файлы затронуты и какие команды реально запускались.

Практикум помогает пройти этот путь руками: от повторяющегося промпта до устойчивого рабочего сценария для ИИ-агента. Там ты собираешь связку из инструкций, файлов проекта и проверок, а не просто копируешь набор команд.

## Где хранить команду: только в проекте или для всех проектов?

проектную команду слэшом храни внутри текущего репозитория в `.claude/`, а личную - в `~/.claude/`. Первая доступна только в этом проекте и может попасть в репозиторий вместе с настройками. Вторая работает во всех проектах для одного пользователя и не должна добавляться в репозиторий.

Для команды конкретного проекта путь выглядит так:

```text
project/
└── .claude/
    └── commands/
        └── check.md
```

Или в рекомендуемом формате:

```text
project/
└── .claude/
    └── skills/
        └── check/
            └── SKILL.md
```

Проектный вариант подходит, когда команда нужна всем, кто работает с репозиторием. Файл можно хранить вместе с кодом. Другие участники получат ту же структуру инструкций.

Личная команда лежит в домашнем каталоге:

```text
~/.claude/commands/check.md
```

Рекомендуемый личный путь:

```text
~/.claude/skills/check/SKILL.md
```

Такая команда слэшом доступна во всех проектах для одного пользователя. В репозиторий её добавлять не нужно.

Claude Code использует систему областей, чтобы определить, где применяются настройки и с кем они могут быть общими. Область User действует для одного пользователя во всех проектах, а область Project хранится в `.claude/` внутри репозитория и может быть добавлена в Git. *Перевод с английского.*

Я бы хранил в проекте только то, что относится к самому проекту: проверку его тестов, правила отчёта, локальный рабочий процесс. Универсальный личный шаблон отчёта или проверки можно оставить в `~/.claude/`.

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

## Какие команды попробовать в первый вечер?

вот три команды для первого вечера. `/project:session-current` показывает состояние активной сессии и не требует GitHub. `/test` запускает подходящие проверки по `$ARGUMENTS`: нужны только тесты в проекте. `/report` собирает сводку изменений, проверок и вопросов без правки файлов. `/reviewpr` и `/issue` отложи: они требуют GitHub CLI и процессов GitHub, поэтому не подходят для первого знакомства.

![Кот поднимает лапу рядом с карточками трёх команд для первого вечера.](https://s3.regru.cloud/crossmark/statejnik/images/guides/slesh-komandy-korotkij-prompt/kadr-2.webp)

| Команда | Назначение | Что нужно |
|---|---|---|
| `/project:session-current` | Показывает состояние текущей сессии | Только проект |
| `/test` | Запускает тесты при их наличии | Тесты и фреймворк |
| `/report` | Собирает сводку по работе | Ничего дополнительно |

`/reviewpr` и `/issue` отложи: они требуют GitHub CLI и процессов GitHub, поэтому не подходят для первого знакомства.

### `/project:session-current`

Эта команда показывает активную сессию, её длительность, последние обновления и текущие задачи. Она работает с файлами проекта и не требует GitHub.

Запуск:

```text
/project:session-current
```

В опубликованном примере команда проверяет файл `.claude/sessions/.current-session`. Это хороший первый сценарий: он читает локальные файлы и формирует отчёт, но не запускает внешние сервисы.

### `/test`

Команда `/test` может определить область тестирования по `$ARGUMENTS`, запустить подходящие проверки и отдельно обработать указанный файл, папку или весь проект.

Примеры:

```text
/test src/components/
/test all
```

Условие одно: в проекте уже должны быть тесты и подходящий тестовый фреймворк. Если тестов нет, команда не превращает их в готовую систему сама.

### `/report`

Для отчёта можно создать собственный файл `.claude/commands/report.md`:

```markdown
Составь отчёт по текущему проекту.

Покажи:
- что изменено;
- какие файлы затронуты;
- какие проверки запущены;
- что прошло;
- что не прошло;
- какие вопросы остались.

Не изменяй файлы и не выполняй git commit.
```

Запуск:

```text
/report
```

Это безопасное направление для первого вечера: результат виден сразу, а команда не должна менять проект. Когда команд станет больше, собирай их в [личный набор навыков](/guides/claude-code-sobrat-lichnyy-nabor-skills-dlya-malogo-biznesa).

### Что отложить

`/reviewpr` получает Pull Request через GitHub CLI, проверяет diff и состояние CI. Для него нужны GitHub CLI, авторизация и существующий Pull Request.

`/issue` разбирает GitHub Issue, создаёт план, ветку, код, тесты и Pull Request. Кроме GitHub CLI, тут уже надо понимать Issues, ветки и Pull Request.

В репозитории [awattar/claude-code-best-practices](https://github.com/awattar/claude-code-best-practices) `reviewpr` и `issue` описаны как команды, за которыми стоит внешний GitHub-процесс. Для первой команды бери локальный сценарий, результат которого можно проверить в текущем проекте.

## Что делать, если команда не появляется или не получает аргументы?

сначала проверь, что ты находишься в Claude Code, затем текущую папку, путь к файлу и момент создания каталога. Если команда появилась после перезапуска, ищи проблему в загрузке сессии. Если команда запускается, но игнорирует текст после имени, проверь точное написание `$ARGUMENTS` и конфликт между одинаковыми command и skill.

![Мужчина с тревожным выражением смотрит на три причины, почему команда не появляется. Нап](https://s3.regru.cloud/crossmark/statejnik/images/guides/slesh-komandy-korotkij-prompt/kadr-3.webp)

1. **Запусти именно Claude Code.** Обычный веб-чат Claude не поддерживает проектные команды Claude Code.

   Из терминала запусти:

   ```text
   claude
   ```

   Затем вводи `/` уже внутри интерфейса Claude Code. Если вставлять `/check` в обычный чат, проектный Markdown-файл не будет использован.

2. **Проверь текущую папку.** Проектная команда слэшом должна лежать в `.claude/` текущего проекта.

   Проверь структуру:

   ```text
   project/
   └── .claude/
       └── commands/
           └── check.md
   ```

   Для личной команды проверь:

   ```text
   ~/.claude/commands/check.md
   ```

   Файл в случайной папке Claude Code не ищет. Для рекомендуемого формата путь должен включать каталог команды и файл `SKILL.md`.

3. **Перезапусти сессию после создания каталога.** Если `.claude/skills/` появился уже после запуска Claude Code, новая команда может не попасть в текущий список сразу.

   Сделай так:

   1. проверь путь к файлу;
   2. заверши текущую сессию;
   3. снова запусти Claude Code;
   4. введи `/` и проверь список.

   Для старого формата безопасно сделать то же самое после создания `.claude/commands/`.

4. **Проверь вложенную папку.** Skill внутри вложенного `.claude/skills/` может не появиться в автодополнении сразу после запуска из корня.

   Пример:

   ```text
   packages/frontend/.claude/skills/ui/SKILL.md
   ```

   Сначала попроси Claude прочитать или изменить файл в этой папке. После этого skill может стать доступен в текущей сессии. Если команда нужна из любой точки проекта, положи её в корневой `.claude/`.

5. **Убери одинаковые имена.** Если одновременно существуют такие файлы:

   ```text
   .claude/commands/review.md
   .claude/skills/review/SKILL.md
   ```

   приоритет получает skill. Ты можешь менять `commands/review.md`, но запускать содержимое `skills/review/SKILL.md`.

   Оставь один вариант или назови их по-разному:

   ```text
   .claude/commands/review.md
   .claude/skills/deep-review/SKILL.md
   ```

6. **Напиши `$ARGUMENTS` без ошибки.** Рабочая переменная пишется с долларом и заглавными буквами:

   ```markdown
   Задача для проверки:

   $ARGUMENTS
   ```

   Эти варианты не подходят:

   ```text
   $arguments
   $ARGUMENT
   ARGUMENTS
   ```

   Вызов:

   ```text
   /report changes in the login flow
   ```

   Если `$ARGUMENTS` отсутствует в тексте команды, Claude Code не получает явное место для подстановки. Поэтому вставляй переменную прямо в нужную часть инструкции.

7. **Не путай ручной и автоматический запуск.** Команда запускается вручную через `/имя`. Автоматический вызов skill зависит от его описания и настроек.

   Если команда должна запускаться только вручную, в YAML-блок можно добавить:

   ```yaml
   ---
   name: review
   description: Review the current git diff
   disable-model-invocation: true
   ---
   ```

   После этого запускай её явно:

   ```text
   /review
   ```

   В этой статье я не разбираю shell-подстановки через `!`: у неё отдельный синтаксис, и для первой команды она не нужна.

## Как использовать слэш-команды в Discord?

фактуры для инструкции по Discord в собранных источниках нет, поэтому я не смешиваю Discord-команды со slash-командами Claude Code. Для Discord нужны отдельные подтверждённые сведения о регистрации приложения, правах, каналах и работе команд в тредах. Здесь можно зафиксировать только различие намерений, а не выдавать догадки за инструкцию.

Запрос **слэш команды дискорд** относится к другому сценарию. В Claude Code команда хранится в `.claude/` или `~/.claude/` и запускает сохранённый Markdown-сценарий внутри Claude Code.

Для Discord в фактуре есть список внешних страниц и поисковый запрос, но нет проверенной инструкции, которую можно безопасно пересказать. Поэтому я не буду писать, какие права включать, где регистрировать команду и поддерживаются ли команды внутри тредов. Это касается и запроса slash commands not supported in threads: подтверждённого источника по этой теме в фактуре нет. Запрос команда слэш майнкрафт и команды слэш майнкрафт тоже относятся к другой теме: это игровые команды Minecraft, для которых нужны отдельные источники.

## Вопросы и ответы

В контексте Claude Code slash command: это команда, которую ты запускаешь через `/имя-команды`. Список доступных команд открывается вводом `/`, а текст после имени считается аргументами. Сама команда хранится в Markdown-файле внутри `.claude/commands/` или `.claude/skills/` и вызывается только в начале сообщения.

Она выглядит как короткий вызов с косой чертой в начале: `/check`, `/test` или `/report`. Если нужны аргументы, их пишут после имени, например `/check src/components/`.

Создай Markdown-файл `.claude/commands/check.md` или `.claude/skills/check/SKILL.md`, запиши в него инструкции и запусти `/check` внутри Claude Code. Так команда слэшом получает имя файла как имя вызова.

Напиши текст после имени команды и вставь `$ARGUMENTS` в тело Markdown-файла. Например, вызов `/report changes in login` передаст весь текст после имени в `$ARGUMENTS`. Для отдельных позиций доступны `$0` и `$1`.

В собранной фактуре нет подтверждённого источника по запросу slash commands not supported in threads. Поэтому нельзя честно утверждать, работают они там или нет.

Это запрос про Discord, а не про проектные команды Claude Code. Для ответа нужны отдельные источники о Discord-приложениях, регистрации команд, правах и каналах.

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

В фактуре нет игровых источников про эту команду. Материалы про Claude Code не отвечают на игровой запрос.

Подтверждённых сведений о такой игровой команде в собранных материалах нет. Для точного ответа нужен отдельный источник по игре и её синтаксису.

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

Запрос команда слэш майнкрафт и команды слэш майнкрафт относятся к игре Minecraft, а не к Claude Code. В собранной фактуре нет источника по Minecraft, поэтому точный список команд привести нельзя.

- [Commands - Claude Code Docs](https://code.claude.com/docs/en/commands)
- [Slash Commands in the SDK - Claude Code Docs](https://code.claude.com/docs/en/agent-sdk/slash-commands)
- [Extend Claude with skills - Claude Code Docs](https://code.claude.com/docs/en/slash-commands)
- [Claude Code settings](https://code.claude.com/docs/en/configuration)
- [Desktop application - Claude Code Docs](https://code.claude.com/docs/en/desktop)
- [awattar/claude-code-best-practices](https://github.com/awattar/claude-code-best-practices)
- [Claude sessions commands](https://github.com/iannuttall/claude-sessions)
- [Custom slash commands: AI Coach](https://aicoach.co.za/house-of-claude/module3/custom-slash-commands/)
- [Claude Code issue #9316](https://github.com/anthropics/claude-code/issues/9316)
- [Claude Code issue #9716](https://github.com/anthropics/claude-code/issues/9716)