Встроенные команды с косой чертой

КомандаНазначение
/add-dirДобавить дополнительные рабочие каталоги
/agentsУправлять пользовательскими AI подагентами для специализированных задач
/bugСообщить об ошибках (отправляет беседу в Anthropic)
/clearОчистить историю беседы
/compact [instructions]Сжать беседу с дополнительными инструкциями фокуса
/configОткрыть интерфейс параметров (вкладка Config)
/costПоказать статистику использования токенов (см. руководство отслеживания затрат для деталей, специфичных для подписки)
/doctorПроверяет здоровье вашей установки Claude Code
/helpПолучить справку по использованию
/initИнициализировать проект с руководством CLAUDE.md
/loginПереключить учетные записи Anthropic
/logoutВыйти из вашей учетной записи Anthropic
/mcpУправлять подключениями MCP сервера и аутентификацией OAuth
/memoryРедактировать файлы памяти CLAUDE.md
/modelВыбрать или изменить модель AI
/permissionsПросмотреть или обновить разрешения
/pr_commentsПросмотреть комментарии запроса на слияние
/reviewЗапросить проверку кода
/sandboxВключить инструмент bash в изолированной среде с изоляцией файловой системы и сети для более безопасного и автономного выполнения
/rewindПеремотать беседу и/или код
/statusОткрыть интерфейс параметров (вкладка Status), показывающий версию, модель, учетную запись и подключение
/terminal-setupУстановить привязку клавиши Shift+Enter для новых строк (только iTerm2 и VSCode)
/usageПоказать лимиты использования плана и статус ограничения скорости (только планы подписки)
/vimВойти в режим vim для чередования режимов вставки и команд

Пользовательские команды с косой чертой

Пользовательские команды с косой чертой позволяют вам определять часто используемые подсказки как файлы Markdown, которые Claude Code может выполнять. Команды организованы по области (специфичные для проекта или личные) и поддерживают пространства имен через структуры каталогов.

Синтаксис

/<command-name> [arguments]

Параметры

ПараметрОписание
<command-name>Имя, полученное из имени файла Markdown (без расширения .md)
[arguments]Дополнительные аргументы, передаваемые команде

Типы команд

Команды проекта

Команды, хранящиеся в вашем репозитории и общие с вашей командой. При перечислении в /help эти команды показывают “(project)” после их описания. Местоположение: .claude/commands/ В следующем примере мы создаем команду /optimize:
# Создать команду проекта
mkdir -p .claude/commands
echo "Analyze this code for performance issues and suggest optimizations:" > .claude/commands/optimize.md

Личные команды

Команды, доступные во всех ваших проектах. При перечислении в /help эти команды показывают “(user)” после их описания. Местоположение: ~/.claude/commands/ В следующем примере мы создаем команду /security-review:
# Создать личную команду
mkdir -p ~/.claude/commands
echo "Review this code for security vulnerabilities:" > ~/.claude/commands/security-review.md

Функции

Пространства имен

Организуйте команды в подкаталогах. Подкаталоги используются для организации и отображаются в описании команды, но они не влияют на само имя команды. Описание будет показывать, откуда команда поступает из каталога проекта (.claude/commands) или каталога уровня пользователя (~/.claude/commands), вместе с именем подкаталога. Конфликты между командами уровня пользователя и проекта не поддерживаются. В противном случае несколько команд с одинаковым базовым именем файла могут сосуществовать. Например, файл в .claude/commands/frontend/component.md создает команду /component с описанием, показывающим “(project:frontend)”. Между тем, файл в ~/.claude/commands/component.md создает команду /component с описанием, показывающим “(user)”.

Аргументы

Передавайте динамические значения командам, используя заполнители аргументов:
Все аргументы с $ARGUMENTS
Заполнитель $ARGUMENTS захватывает все аргументы, переданные команде:
# Определение команды
echo 'Fix issue #$ARGUMENTS following our coding standards' > .claude/commands/fix-issue.md

# Использование
> /fix-issue 123 high-priority
# $ARGUMENTS становится: "123 high-priority"
Отдельные аргументы с $1, $2 и т.д.
Получайте доступ к конкретным аргументам отдельно, используя позиционные параметры (аналогично скриптам оболочки):
# Определение команды  
echo 'Review PR #$1 with priority $2 and assign to $3' > .claude/commands/review-pr.md

# Использование
> /review-pr 456 high alice
# $1 становится "456", $2 становится "high", $3 становится "alice"
Используйте позиционные аргументы, когда вам нужно:
  • Получить доступ к аргументам отдельно в разных частях вашей команды
  • Предоставить значения по умолчанию для отсутствующих аргументов
  • Построить более структурированные команды с определенными ролями параметров

Выполнение команд bash

Выполняйте команды bash перед запуском команды с косой чертой, используя префикс !. Вывод включается в контекст команды. Вы должны включить allowed-tools с инструментом Bash, но вы можете выбрать конкретные команды bash для разрешения. Например:
---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a git commit
---

## Context

- Current git status: !`git status`
- Current git diff (staged and unstaged changes): !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -10`

## Your task

Based on the above changes, create a single git commit.

Ссылки на файлы

Включайте содержимое файлов в команды, используя префикс @ для ссылки на файлы. Например:
# Reference a specific file

Review the implementation in @src/utils/helpers.js

# Reference multiple files

Compare @src/old-version.js with @src/new-version.js

Режим мышления

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

Frontmatter

Файлы команд поддерживают frontmatter, полезный для указания метаданных о команде:
FrontmatterНазначениеПо умолчанию
allowed-toolsСписок инструментов, которые может использовать командаНаследуется из беседы
argument-hintАргументы, ожидаемые для команды с косой чертой. Пример: argument-hint: add [tagId] | remove [tagId] | list. Эта подсказка показывается пользователю при автодополнении команды с косой чертой.Нет
descriptionКраткое описание командыИспользует первую строку из подсказки
modelСтрока конкретной модели (см. Обзор моделей)Наследуется из беседы
disable-model-invocationПредотвращает ли вызов инструмента SlashCommand этой командыfalse
Например:
---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: Create a git commit
model: claude-3-5-haiku-20241022
---

Create a git commit with message: $ARGUMENTS
Пример использования позиционных аргументов:
---
argument-hint: [pr-number] [priority] [assignee]
description: Review pull request
---

Review PR #$1 with priority $2 and assign to $3.
Focus on security, performance, and code style.

Команды плагинов

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

Как работают команды плагинов

Команды плагинов:
  • С пространством имен: Команды могут использовать формат /plugin-name:command-name для избежания конфликтов (префикс плагина необязателен, если нет коллизий имен)
  • Автоматически доступны: После установки и включения плагина его команды появляются в /help
  • Полностью интегрированы: Поддерживают все функции команд (аргументы, frontmatter, выполнение bash, ссылки на файлы)

Структура команды плагина

Местоположение: каталог commands/ в корне плагина Формат файла: Файлы Markdown с frontmatter Базовая структура команды:
---
description: Brief description of what the command does
---

# Command Name

Detailed instructions for Claude on how to execute this command.
Include specific guidance on parameters, expected outcomes, and any special considerations.
Расширенные функции команды:
  • Аргументы: Используйте заполнители типа {arg1} в описаниях команд
  • Подкаталоги: Организуйте команды в подкаталогах для пространства имен
  • Интеграция Bash: Команды могут выполнять скрипты оболочки и программы
  • Ссылки на файлы: Команды могут ссылаться и изменять файлы проекта

Шаблоны вызова

Прямая команда (когда нет конфликтов)
/command-name
С префиксом плагина (когда требуется для уточнения)
/plugin-name:command-name
С аргументами (если команда их поддерживает)
/command-name arg1 arg2

Команды MCP с косой чертой

Серверы MCP могут предоставлять подсказки как команды с косой чертой, которые становятся доступными в Claude Code. Эти команды динамически обнаруживаются из подключенных серверов MCP.

Формат команды

Команды MCP следуют шаблону:
/mcp__<server-name>__<prompt-name> [arguments]

Функции

Динамическое обнаружение

Команды MCP автоматически доступны, когда:
  • Сервер MCP подключен и активен
  • Сервер предоставляет подсказки через протокол MCP
  • Подсказки успешно получены во время подключения

Аргументы

Подсказки MCP могут принимать аргументы, определенные сервером:
# Без аргументов
> /mcp__github__list_prs

# С аргументами
> /mcp__github__pr_review 456
> /mcp__jira__create_issue "Bug title" high

Соглашения об именовании

  • Имена сервера и подсказки нормализованы
  • Пробелы и специальные символы становятся подчеркиваниями
  • Имена приводятся в нижний регистр для согласованности

Управление подключениями MCP

Используйте команду /mcp для:
  • Просмотра всех настроенных серверов MCP
  • Проверки статуса подключения
  • Аутентификации с помощью серверов с поддержкой OAuth
  • Очистки токенов аутентификации
  • Просмотра доступных инструментов и подсказок от каждого сервера

Разрешения MCP и подстановочные символы

При настройке разрешений для инструментов MCP обратите внимание, что подстановочные символы не поддерживаются:
  • Правильно: mcp__github (одобряет ВСЕ инструменты с сервера github)
  • Правильно: mcp__github__get_issue (одобряет конкретный инструмент)
  • Неправильно: mcp__github__* (подстановочные символы не поддерживаются)
Чтобы одобрить все инструменты с сервера MCP, используйте только имя сервера: mcp__servername. Чтобы одобрить только конкретные инструменты, перечислите каждый инструмент отдельно.

Инструмент SlashCommand

Инструмент SlashCommand позволяет Claude выполнять пользовательские команды с косой чертой программно во время беседы. Это дает Claude возможность вызывать пользовательские команды от вашего имени, когда это уместно. Чтобы побудить Claude запустить инструмент SlashCommand, ваши инструкции (подсказки, CLAUDE.md и т.д.) обычно должны ссылаться на команду по имени с косой чертой. Пример:
> Run /write-unit-test when you are about to start writing tests.
Этот инструмент помещает метаданные каждой доступной пользовательской команды с косой чертой в контекст до лимита бюджета символов. Вы можете использовать /context для мониторинга использования токенов и следовать операциям ниже для управления контекстом.

Поддерживаемые команды инструмента SlashCommand

Инструмент SlashCommand поддерживает только пользовательские команды с косой чертой, которые:
  • Определены пользователем. Встроенные команды типа /compact и /init не поддерживаются.
  • Имеют заполненное поле frontmatter description. Мы используем description в контексте.
Для версий Claude Code >= 1.0.124 вы можете увидеть, какие пользовательские команды с косой чертой инструмент SlashCommand может вызывать, запустив claude --debug и запустив запрос.

Отключить инструмент SlashCommand

Чтобы предотвратить выполнение Claude любых команд с косой чертой через инструмент:
/permissions
# Add to deny rules: SlashCommand
Это также удалит инструмент SlashCommand (и описания команд с косой чертой) из контекста.

Отключить только конкретные команды

Чтобы предотвратить доступность конкретной команды с косой чертой, добавьте disable-model-invocation: true в frontmatter команды с косой чертой. Это также удалит метаданные команды из контекста.

Правила разрешений SlashCommand

Правила разрешений поддерживают:
  • Точное совпадение: SlashCommand:/commit (разрешает только /commit без аргументов)
  • Совпадение префикса: SlashCommand:/review-pr:* (разрешает /review-pr с любыми аргументами)

Лимит бюджета символов

Инструмент SlashCommand включает бюджет символов для ограничения размера описаний команд, показываемых Claude. Это предотвращает переполнение токенов, когда доступно много команд. Бюджет включает имя, аргументы и описание каждой пользовательской команды с косой чертой.
  • Лимит по умолчанию: 15 000 символов
  • Пользовательский лимит: Установить через переменную окружения SLASH_COMMAND_TOOL_CHAR_BUDGET
Когда бюджет символов превышен, Claude будет видеть только подмножество доступных команд. В /context будет показано предупреждение с “M of N commands”.

Навыки против команд с косой чертой

Команды с косой чертой и Agent Skills служат разным целям в Claude Code:

Используйте команды с косой чертой для

Быстрых, часто используемых подсказок:
  • Простые фрагменты подсказок, которые вы часто используете
  • Быстрые напоминания или шаблоны
  • Часто используемые инструкции, которые помещаются в один файл
Примеры:
  • /review → “Review this code for bugs and suggest improvements”
  • /explain → “Explain this code in simple terms”
  • /optimize → “Analyze this code for performance issues”

Используйте Skills для

Комплексных возможностей со структурой:
  • Сложные рабочие процессы с несколькими шагами
  • Возможности, требующие скриптов или утилит
  • Знания, организованные в несколько файлов
  • Командные рабочие процессы, которые вы хотите стандартизировать
Примеры:
  • Skill обработки PDF с скриптами заполнения форм и валидацией
  • Skill анализа данных со справочной документацией для разных типов данных
  • Skill документации со стилями и шаблонами

Ключевые различия

АспектКоманды с косой чертойAgent Skills
СложностьПростые подсказкиСложные возможности
СтруктураОдин файл .mdКаталог с SKILL.md + ресурсы
ОбнаружениеЯвный вызов (/command)Автоматическое (на основе контекста)
ФайлыТолько один файлНесколько файлов, скриптов, шаблонов
ОбластьПроект или личноеПроект или личное
Совместное использованиеЧерез gitЧерез git

Пример сравнения

Как команда с косой чертой:
# .claude/commands/review.md
Review this code for:
- Security vulnerabilities
- Performance issues
- Code style violations
Использование: /review (ручной вызов) Как Skill:
.claude/skills/code-review/
├── SKILL.md (overview and workflows)
├── SECURITY.md (security checklist)
├── PERFORMANCE.md (performance patterns)
├── STYLE.md (style guide reference)
└── scripts/
    └── run-linters.sh
Использование: “Can you review this code?” (автоматическое обнаружение) Skill предоставляет более богатый контекст, скрипты валидации и организованный справочный материал.

Когда использовать каждый

Используйте команды с косой чертой:
  • Вы вызываете одну и ту же подсказку повторно
  • Подсказка помещается в один файл
  • Вы хотите явный контроль над тем, когда она запускается
Используйте Skills:
  • Claude должен автоматически обнаружить возможность
  • Требуются несколько файлов или скриптов
  • Сложные рабочие процессы с шагами валидации
  • Команде нужны стандартизированные, подробные инструкции
Команды с косой чертой и Skills могут сосуществовать. Используйте подход, который соответствует вашим потребностям. Узнайте больше о Agent Skills.

См. также