Встроенные команды с косой чертой
| Команда | Назначение |
|---|---|
/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> | Имя, полученное из имени файла Markdown (без расширения .md) |
[arguments] | Дополнительные аргументы, передаваемые команде |
Типы команд
Команды проекта
Команды, хранящиеся в вашем репозитории и общие с вашей командой. При перечислении в/help эти команды показывают “(project)” после их описания.
Местоположение: .claude/commands/
В следующем примере мы создаем команду /optimize:
Личные команды
Команды, доступные во всех ваших проектах. При перечислении в/help эти команды показывают “(user)” после их описания.
Местоположение: ~/.claude/commands/
В следующем примере мы создаем команду /security-review:
Функции
Пространства имен
Организуйте команды в подкаталогах. Подкаталоги используются для организации и отображаются в описании команды, но они не влияют на само имя команды. Описание будет показывать, откуда команда поступает из каталога проекта (.claude/commands) или каталога уровня пользователя (~/.claude/commands), вместе с именем подкаталога.
Конфликты между командами уровня пользователя и проекта не поддерживаются. В противном случае несколько команд с одинаковым базовым именем файла могут сосуществовать.
Например, файл в .claude/commands/frontend/component.md создает команду /component с описанием, показывающим “(project:frontend)”.
Между тем, файл в ~/.claude/commands/component.md создает команду /component с описанием, показывающим “(user)”.
Аргументы
Передавайте динамические значения командам, используя заполнители аргументов:Все аргументы с $ARGUMENTS
Заполнитель $ARGUMENTS захватывает все аргументы, переданные команде:
Отдельные аргументы с $1, $2 и т.д.
Получайте доступ к конкретным аргументам отдельно, используя позиционные параметры (аналогично скриптам оболочки):
- Получить доступ к аргументам отдельно в разных частях вашей команды
- Предоставить значения по умолчанию для отсутствующих аргументов
- Построить более структурированные команды с определенными ролями параметров
Выполнение команд bash
Выполняйте команды bash перед запуском команды с косой чертой, используя префикс!. Вывод включается в контекст команды. Вы должны включить allowed-tools с инструментом Bash, но вы можете выбрать конкретные команды bash для разрешения.
Например:
Ссылки на файлы
Включайте содержимое файлов в команды, используя префикс@ для ссылки на файлы.
Например:
Режим мышления
Команды с косой чертой могут запустить расширенное мышление, включив ключевые слова расширенного мышления.Frontmatter
Файлы команд поддерживают frontmatter, полезный для указания метаданных о команде:| Frontmatter | Назначение | По умолчанию |
|---|---|---|
allowed-tools | Список инструментов, которые может использовать команда | Наследуется из беседы |
argument-hint | Аргументы, ожидаемые для команды с косой чертой. Пример: argument-hint: add [tagId] | remove [tagId] | list. Эта подсказка показывается пользователю при автодополнении команды с косой чертой. | Нет |
description | Краткое описание команды | Использует первую строку из подсказки |
model | Строка конкретной модели (см. Обзор моделей) | Наследуется из беседы |
disable-model-invocation | Предотвращает ли вызов инструмента SlashCommand этой команды | false |
Команды плагинов
Плагины могут предоставлять пользовательские команды с косой чертой, которые беспрепятственно интегрируются с Claude Code. Команды плагинов работают точно так же, как пользовательские команды, но распространяются через маркетплейсы плагинов.Как работают команды плагинов
Команды плагинов:- С пространством имен: Команды могут использовать формат
/plugin-name:command-nameдля избежания конфликтов (префикс плагина необязателен, если нет коллизий имен) - Автоматически доступны: После установки и включения плагина его команды появляются в
/help - Полностью интегрированы: Поддерживают все функции команд (аргументы, frontmatter, выполнение bash, ссылки на файлы)
Структура команды плагина
Местоположение: каталогcommands/ в корне плагина
Формат файла: Файлы Markdown с frontmatter
Базовая структура команды:
- Аргументы: Используйте заполнители типа
{arg1}в описаниях команд - Подкаталоги: Организуйте команды в подкаталогах для пространства имен
- Интеграция Bash: Команды могут выполнять скрипты оболочки и программы
- Ссылки на файлы: Команды могут ссылаться и изменять файлы проекта
Шаблоны вызова
Прямая команда (когда нет конфликтов)
С префиксом плагина (когда требуется для уточнения)
С аргументами (если команда их поддерживает)
Команды MCP с косой чертой
Серверы MCP могут предоставлять подсказки как команды с косой чертой, которые становятся доступными в Claude Code. Эти команды динамически обнаруживаются из подключенных серверов MCP.Формат команды
Команды MCP следуют шаблону:Функции
Динамическое обнаружение
Команды MCP автоматически доступны, когда:- Сервер MCP подключен и активен
- Сервер предоставляет подсказки через протокол MCP
- Подсказки успешно получены во время подключения
Аргументы
Подсказки MCP могут принимать аргументы, определенные сервером:Соглашения об именовании
- Имена сервера и подсказки нормализованы
- Пробелы и специальные символы становятся подчеркиваниями
- Имена приводятся в нижний регистр для согласованности
Управление подключениями MCP
Используйте команду/mcp для:
- Просмотра всех настроенных серверов MCP
- Проверки статуса подключения
- Аутентификации с помощью серверов с поддержкой OAuth
- Очистки токенов аутентификации
- Просмотра доступных инструментов и подсказок от каждого сервера
Разрешения MCP и подстановочные символы
При настройке разрешений для инструментов MCP обратите внимание, что подстановочные символы не поддерживаются:- ✅ Правильно:
mcp__github(одобряет ВСЕ инструменты с сервера github) - ✅ Правильно:
mcp__github__get_issue(одобряет конкретный инструмент) - ❌ Неправильно:
mcp__github__*(подстановочные символы не поддерживаются)
mcp__servername. Чтобы одобрить только конкретные инструменты, перечислите каждый инструмент отдельно.
Инструмент SlashCommand
Инструмент SlashCommand позволяет Claude выполнять пользовательские команды с косой чертой программно
во время беседы. Это дает Claude возможность вызывать пользовательские команды
от вашего имени, когда это уместно.
Чтобы побудить Claude запустить инструмент SlashCommand, ваши инструкции (подсказки,
CLAUDE.md и т.д.) обычно должны ссылаться на команду по имени с косой чертой.
Пример:
/context для мониторинга использования токенов и следовать операциям ниже для управления контекстом.
Поддерживаемые команды инструмента SlashCommand
Инструмент SlashCommand поддерживает только пользовательские команды с косой чертой, которые:
- Определены пользователем. Встроенные команды типа
/compactи/initне поддерживаются. - Имеют заполненное поле frontmatter
description. Мы используемdescriptionв контексте.
SlashCommand может вызывать, запустив claude --debug и запустив запрос.
Отключить инструмент SlashCommand
Чтобы предотвратить выполнение Claude любых команд с косой чертой через инструмент:
Отключить только конкретные команды
Чтобы предотвратить доступность конкретной команды с косой чертой, добавьтеdisable-model-invocation: true в frontmatter команды с косой чертой.
Это также удалит метаданные команды из контекста.
Правила разрешений SlashCommand
Правила разрешений поддерживают:
- Точное совпадение:
SlashCommand:/commit(разрешает только/commitбез аргументов) - Совпадение префикса:
SlashCommand:/review-pr:*(разрешает/review-prс любыми аргументами)
Лимит бюджета символов
ИнструментSlashCommand включает бюджет символов для ограничения размера описаний команд,
показываемых Claude. Это предотвращает переполнение токенов, когда доступно много команд.
Бюджет включает имя, аргументы и описание каждой пользовательской команды с косой чертой.
- Лимит по умолчанию: 15 000 символов
- Пользовательский лимит: Установить через переменную окружения
SLASH_COMMAND_TOOL_CHAR_BUDGET
/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 |
Пример сравнения
Как команда с косой чертой:/review (ручной вызов)
Как Skill:
Когда использовать каждый
Используйте команды с косой чертой:- Вы вызываете одну и ту же подсказку повторно
- Подсказка помещается в один файл
- Вы хотите явный контроль над тем, когда она запускается
- Claude должен автоматически обнаружить возможность
- Требуются несколько файлов или скриптов
- Сложные рабочие процессы с шагами валидации
- Команде нужны стандартизированные, подробные инструкции
См. также
- Плагины - Расширьте Claude Code пользовательскими командами через плагины
- Identity and Access Management - Полное руководство по разрешениям, включая разрешения инструментов MCP
- Интерактивный режим - Ярлыки, режимы ввода и интерактивные функции
- Справочник CLI - Флаги командной строки и опции
- Параметры - Опции конфигурации
- Управление памятью - Управление памятью Claude между сеансами