МОДУЛЬ 01/УРОК

Слэш-команды

Slash-команды

Обзор

Slash-команды - это сокращения, управляющие поведением Claude в ходе интерактивной сессии. Они бывают нескольких типов:

  • Встроенные команды: предоставляются Claude Code (/help, /clear, /model)
  • Skills: пользовательские команды, оформленные в виде файлов SKILL.md (/optimize, /pr)
  • Команды плагинов: команды из установленных плагинов (/frontend-design:frontend-design)
  • MCP-промпты: команды с MCP-серверов (/mcp__github__list_prs)

Примечание: Пользовательские slash-команды теперь объединены со skills. Файлы в .claude/commands/ по-прежнему работают, однако рекомендуемым подходом стали skills (.claude/skills/). И тот, и другой вариант создают сокращение вида /command-name. Полную справку см. в руководстве по Skills.

Справочник встроенных команд

Встроенные команды - это сокращения для типовых действий. Доступно более 60 встроенных команд и 10 предустановленных skills. Введите / в Claude Code, чтобы увидеть полный список, либо / и любые буквы - для фильтрации.

Примечание: Начиная с v2.1.236, при нажатии Enter на slash-команде с опечаткой - или на команде, недоступной в текущей сессии, - выводится ошибка, а не молча запускается ближайшее нечёткое совпадение. Однозначные префиксы и заданные алиасы по-прежнему выполняются, как и раньше. | Command | Purpose | |---------|---------| | /add-dir <path> | Add working directory | | /advisor [model\|off] | Configure the advisor. Opens as an interactive dialog; in the desktop app, Remote Control, and headless (-p / Agent SDK) sessions it takes a text form instead - bare /advisor, /advisor <model>, or /advisor off (v2.1.260+) | | /agents | Manage agent configurations | | /branch [name] | Switch into a copy of the conversation at this point, preserving the original (return to it with /resume) | | /fork [prompt] | Copy the current conversation into a new background session and keep working here; the two are independent from that point on and the copy gets its own row in claude agents (v2.1.212+). Except when the copy edits in place, Claude Code instructs it to create a worktree of its own before making code changes (isolation instruction requires v2.1.221+) | | /subtask <task> | Spawn a forked subagent that inherits the full conversation and works on the task while you keep going; its result returns to this conversation when it finishes (v2.1.212+) | | /btw <question> | Ask an ephemeral side question while Claude is working on the main task; doesn't pollute the main conversation context | | /cd <path> | Move the session to a new working directory without breaking the prompt cache (added v2.1.169) | | /chrome | Configure Chrome browser integration | | /clear | Clear conversation (aliases: /reset, /new) | | /color [color\|default] | Set prompt bar color. Bare /color (no args) picks a random session color (v2.1.128+); pass a color name or hex to set explicitly. | | /compact [instructions] | Compact conversation with optional focus instructions. A failed compact now displays as an error in the UI instead of silently doing nothing (v2.1.216) | | /config | Open Settings (alias: /settings) | | /context | Visualize context usage as colored grid. Shows an explicit warning when usage is over the context window limit (v2.1.216) | | /copy [N] | Copy assistant response to clipboard; w writes to file | | /cost | Typing-shortcut alias for /usage - opens the cost tab (v2.1.118+) | | /desktop | Continue in Desktop app (alias: /app) | | /diff | Interactive diff viewer for uncommitted changes. In fullscreen rendering it instead opens a diff panel beside the conversation that stays open while you keep working - it lists changed files with added/removed line counts and refreshes every time Claude edits a file or runs a shell command; run /diff again or click ✕ to close it (v2.1.260+). The classic renderer opens the viewer in place of the prompt | | /doctor | Diagnose installation health - openable while Claude is responding; shows status icons; press f to auto-fix issues (enhanced in v2.1.116; layout refreshed to a flat tree with clearer icons in v2.1.178) | | /effort [low\|medium\|high\|xhigh\|max\|auto] | Set effort level via interactive arrow-key slider. Levels: low → medium → high → xhigh (new in v2.1.111) → max. Default is high on Opus 5, Sonnet 5, and Opus 4.8 (xhigh on Opus 4.7); xhigh needs Opus 5, Sonnet 5, Opus 4.8, or Opus 4.7; max works on Opus 5, Sonnet 5, Opus 4.8/4.7/4.6 and Sonnet 4.6. The menu also offers ultracode (not a model effort level - it sends xhigh and has Claude orchestrate dynamic workflows; session-only) | | /exit | Exit the REPL (alias: /quit) | | /export [filename] | Export the current conversation to a file or clipboard | | /usage-credits | Configure extra usage for rate limits (renamed from /extra-usage in v2.1.144; /extra-usage still works as an alias) | | /fast [on\|off] | Toggle fast mode. Applies to Opus 5 and Opus 4.8 (v2.1.219) | | /feedback | Submit feedback (alias: /bug). Since v2.1.141, can attach recent sessions (last 24h or 7d) so reports spanning more than one session include context. As of v2.1.178, /bug requires a description before it can be submitted. | | /focus | Toggle focus view (added v2.1.110; replaces Ctrl+O for focus toggle) | | /goal <statement> | Register a session-level completion condition; Claude keeps working until the goal is met. /goal clear removes it. Active goal appears in the status line, with a live overlay panel showing elapsed time, turn count, and token usage (added v2.1.139). | | /help | Show help | | /hooks | View hook configurations | | /ide | Manage IDE integrations | | /init | Initialize CLAUDE.md. Set CLAUDE_CODE_NEW_INIT=1 for interactive flow | | /insights | Generate session analysis report | | /install-github-app | Set up GitHub Actions app | | /install-slack-app | Install Slack app | | /keybindings | Open keybindings configuration | | /fewer-permission-prompts | Analyze recent Bash/MCP tool calls and add a prioritized allowlist to .claude/settings.json to reduce permission prompts (added v2.1.111) | | /login | Switch Anthropic accounts | | /logout | Sign out from your Anthropic account | | /mcp | Manage MCP servers and OAuth | | /memory | Edit CLAUDE.md, toggle auto-memory | | /mobile | QR code for mobile app (aliases: /ios, /android) | | /model [model] | Select model with left/right arrows for effort. Since v2.1.153, the choice is saved as the default for new sessions (matching the IDE); press s after selecting to apply it to the current session only. (The keybinding modelPicker:setAsDefault was renamed to modelPicker:thisSessionOnly; the old d action is now s.) As of v2.1.219, the picker shows the merged Opus row as "Opus (1M context)". | | /passes | Share free week of Claude Code | | /permissions | View/update permissions (alias: /allowed-tools) | | /plan [description] | Enter plan mode | | /plugin | Manage plugins | | /proactive | Alias for /loop (added v2.1.105) | | /powerup | Discover features through interactive lessons with animated demos | | /privacy-settings | Privacy settings (Pro/Max only) | | /release-notes | View changelog | | /recap | Show session recap / summary when returning to a session (added v2.1.108) | | /reload-plugins | Reload active plugins. Since v2.1.221 most installs activate immediately, so this is only needed when the install summary says Run /reload-plugins to activate. Available in headless sessions as of v2.1.260, so it also appears in the Claude Code Desktop and SDK command lists | | /reload-skills | Re-scan skill directories without restarting the session (added v2.1.152) | | /remote-control | Remote control from claude.ai (alias: /rc) | | /remote-env | Configure default remote environment | | /rename [name] | Rename session | | /resume [session] | Resume conversation (alias: /continue) | | /review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path] | Alias of /code-review (v2.1.223): reviews the current diff, or a PR number, branch, or path you pass - e.g. /review 1234. Takes the same effort levels and flags. With no level given, it reuses the last low-max level you typed | | /rewind | Rewind conversation and/or code (alias: /checkpoint) | | /sandbox | Toggle sandbox mode | | /schedule [description] | Create/manage Cloud scheduled tasks | | /scroll-speed <+N\|-N> | Tune mouse-wheel scroll speed of the TUI live-preview pane with a live preview. Persists per-machine to ~/.claude/preferences.json (added v2.1.139). | | /security-review | Analyze branch for security vulnerabilities | | /skill-doctor | Show which loaded skills go unused and what each one costs in context, so you can decide which to turn off. The report opens in the /plugin manager's Stats tab; in non-interactive -p mode it prints as text. Over Remote Control it replies Skill usage reports are not available on this connection. - run it in the terminal on the machine hosting the session (requires v2.1.252+) | | /skills | List available skills | | /stats | Typing-shortcut alias for /usage - opens the stats tab (daily usage, sessions, streaks) (v2.1.118+) | | /stickers | Order Claude Code stickers | | /status | Show version, model, account, and a Session kind row reading background job · attached, background job · unattended, or interactive (row added v2.1.221). Openable while Claude is responding | | /statusline | Configure status line | | /tasks | List/manage background tasks | | /team-onboarding | Generate a teammate ramp-up guide from the project's Claude Code setup (new in v2.1.101) | | /teleport | Resume a Claude Code on the web session in this terminal; opens a picker of your web sessions (alias: /tp). Requires a claude.ai subscription | | /terminal-setup | Configure terminal keybindings | | /theme | Open theme picker / manage custom themes (v2.1.118). Define custom themes via JSON in ~/.claude/themes/<name>.json | | /tui | Toggle fullscreen TUI (text user interface) mode with flicker-free rendering (added v2.1.110) | | /ultrareview | Comprehensive cloud-based multi-agent code review (added v2.1.111). The preferred invocation is now /code-review ultra; /ultrareview remains as an alias. Includes 3 free runs on Pro and Max, then requires usage credits | | /upgrade | Open upgrade page for higher plan tier | | /usage | Canonical usage dashboard (v2.1.118) - combines plan usage limits, rate limits, cost, and daily session stats. /cost and /stats are typing-shortcut aliases that open specific tabs | | /voice | Toggle push-to-talk voice dictation | | /workflows | View running and completed dynamic workflow runs (added v2.1.154). See Dynamic Workflows | Почему /cd важен: раньше смена директории приводила к потере «прогретости» кэша (следующий запрос становился медленнее и дороже); /cd сохраняет prompt cache при переключении.

Встроенные skills

Эти skills поставляются вместе с Claude Code и вызываются как slash-команды:

SkillPurpose
/batch <instruction>Orchestrate large-scale parallel changes using worktrees
/claude-apiLoad Claude API reference for project language
/datavizChart and dashboard design guidance with a runnable color-palette validator (v2.1.198)
/debug [description]Enable debug logging
/design [description]Create a design canvas - a multi-artboard visual design (UI mockups, screen flows, landing pages, posters) published as an artifact and refined visually rather than in code. Use it instead of hand-writing HTML when the layout is what you want to iterate on. Research preview; requires v2.1.233+ and a Pro, Max, Team, or Enterprise plan
/loop [interval] <prompt>Run prompt repeatedly on interval
/code-review [low|medium|high|xhigh|max|ultra] [--fix] [--comment] [pr#|branch|path]Review the current diff - or a PR number, branch, or path you pass - for correctness bugs. Pass --fix to apply findings, --comment to post them as inline GitHub PR comments, or ultra to run a deep cloud review; with ultra on a github.com PR target, --post preselects posting the findings to the PR. With no effort level given, the review reuses the last level you typed (v2.1.223). Originally absorbed /simplify in v2.1.146, but /simplify returned as a distinct command in v2.1.154
/simplifyRun a cleanup-only review (reuse / simplification / efficiency / altitude) and apply the fixes; does not hunt for bugs - use /code-review for that. Briefly an alias of /code-review --fix (v2.1.152), it became cleanup-only in v2.1.154

Устаревшие команды

CommandStatus
/output-styleRemoved in v2.1.91 (deprecated v2.1.73) - use /config → Output style, or the outputStyle setting
/pr-commentsRemoved in v2.1.91 - ask Claude directly to view PR comments
/vimRemoved in v2.1.92 - use /config → Editor mode
/undoNo longer listed in the official commands reference as of v2.1.245 (it was added as an alias for /rewind in v2.1.108) - use /rewind or press Esc twice

Недавние изменения

  • /fork и /subtask поменялись ролями в v2.1.212. /fork теперь копирует диалог в новую независимую фоновую сессию; прежнее поведение с forked-subagent перешло к новой команде /subtask. История: с v2.1.77 по v2.1.161 /fork был alias для /branch; с v2.1.161 по v2.1.211 он запускал forked subagent (то, что теперь делает /subtask). Когда agent view отключён, /subtask недоступна, а /fork сохраняет поведение forked-subagent
  • /resume (без аргументов) открывает список прошлых сессий - включая скрытые из видимого списка - и возобновляет выбранную как фоновую сессию (v2.1.212)
  • /output-style объявлена устаревшей (v2.1.73) и удалена (v2.1.91) - output styles по-прежнему доступны через /config → Output style или настройку outputStyle; встроенные варианты: Default, Proactive, Explanatory, Learning и Concise (добавлен в v2.1.237)
  • /review стала полным alias для /code-review - те же цели, уровни effort и флаги (v2.1.223). История: сначала, в v2.1.186, она перешла на движок /code-review medium, оставаясь только для PR
  • Добавлена команда /effort; уровень max доступен на Opus 4.6+ (изначально только на Opus 4.6)
  • Добавлена команда /voice для push-to-talk голосовой диктовки
  • Добавлена команда /schedule для создания запланированных задач и управления ими
  • Добавлена команда /color для настройки внешнего вида prompt bar
  • /pr-comments удалена в v2.1.91 - попросите Claude напрямую посмотреть комментарии PR
  • /vim удалена в v2.1.92 - вместо неё используйте /config → Editor mode
  • /ultraplan удалена в v2.1.222 - используйте вместо неё plan mode
  • Добавлена /powerup для интерактивных уроков по возможностям
  • Добавлена /sandbox для переключения sandbox mode
  • Пикер /model теперь показывает понятные человеку названия (например, "Sonnet 4.6") вместо «сырых» ID моделей
  • /resume поддерживает alias /continue
  • MCP prompts доступны как команды /mcp__<server>__<prompt> (см. MCP Prompts as Commands)
  • Добавлена /team-onboarding для автогенерации гайдов по онбордингу коллег по команде (v2.1.101)
  • Добавлена команда /tui для полноэкранного TUI-рендеринга без мерцания (v2.1.110)
  • Добавлена команда /focus для переключения focus view; Ctrl+O теперь переключает только verbose transcript (v2.1.110)
  • Добавлена команда /recap для ручного запуска recap контекста сессии (v2.1.108)
  • Добавлена /undo как alias для /rewind (v2.1.108); начиная с v2.1.245 она больше не фигурирует в официальном справочнике команд - используйте /rewind или Esc Esc
  • Добавлена /proactive как alias для /loop (v2.1.105)
  • /effort получила интерактивный слайдер, управляемый стрелками, и новый уровень xhigh между high и max; уровень по умолчанию для планов Opus 4.7 повышен до xhigh (v2.1.111). На Opus 4.8 значение по умолчанию - high (v2.1.154); Opus 5 также по умолчанию использует high (v2.1.219)
  • Добавлена /ultrareview для комплексного облачного multi-agent code review (v2.1.111)
  • Добавлена /fewer-permission-prompts - анализирует вызовы инструментов Bash/MCP и уменьшает число permission prompts за счёт allowlist в .claude/settings.json (v2.1.111)
  • Auto mode больше не требует флага --enable-auto-mode для подписчиков Max на Opus 4.7 (v2.1.112)
  • Добавлена /goal - условие завершения на уровне сессии, к которому Claude движется на протяжении нескольких ходов; live-оверлей показывает прошедшее время, количество ходов и расход tokens (v2.1.139)
  • Добавлена /scroll-speed - настройка скорости прокрутки колесом мыши в панели live-preview TUI; сохраняется отдельно для каждой машины (v2.1.139)
  • Добавлена /reload-skills - повторное сканирование каталогов skill без перезапуска сессии (v2.1.152)
  • /model теперь сохраняет выбранную модель как значение по умолчанию для новых сессий; нажмите s, чтобы применить только к текущей сессии (keybinding modelPicker:setAsDefault → modelPicker:thisSessionOnly) (v2.1.153)
  • Добавлена /workflows - просмотр запущенных и завершённых запусков dynamic workflow (v2.1.154)
  • /simplify вернулась как отдельная команда review, ориентированная только на cleanup (reuse / simplification / efficiency / altitude), в отличие от bug hunt в /code-review (v2.1.154)
  • /status получила строку Session kind, отличающую attached и unattended фоновые задачи от интерактивных сессий (v2.1.221)
  • Установка плагинов теперь активирует их сразу, когда это безопасно; /reload-plugins нужна только тогда, когда об этом просит сводка установки (v2.1.221)
  • /ultraplan удалена - используйте plan mode (v2.1.222)
  • /code-review и /review запоминают последний введённый вами уровень effort и подставляют его, если вы его не указали (v2.1.223)
  • /code-review ultra стала предпочтительной точкой входа для облачного multi-agent review; /ultrareview остаётся её alias (v2.1.223)
  • /code-review на уровнях effort high, xhigh и max теперь запускается в фоновом агенте, как и на остальных уровнях (v2.1.232)
  • Стартовая подсказка с предложением создать собственные subagents и соответствующий совет в туре /powerup были убраны (v2.1.232)
  • /permissions теперь можно открыть, пока Claude работает - изменения правил применяются к оставшейся части текущего хода (v2.1.234)
  • /add-dir <path> теперь можно использовать, пока Claude работает; диалоги /add-dir, /autocompact, /theme, /help, /config и /advisor открываются посреди хода в полноэкранном TUI, не откладываясь в очередь до завершения ответа Claude (/bug уже открывалась сразу, начиная с v2.1.232) (v2.1.234)

/goal - условие завершения на уровне сессии

Новое в v2.1.139

Используйте /goal, чтобы задать условие завершения для текущей сессии. Claude движется к нему на протяжении нескольких ходов, а панель-оверлей показывает прошедшее время, количество ходов и израсходованные tokens. Сбросить условие можно с помощью /goal clear. Работает в интерактивном режиме, в claude -p и в Remote Control.

CODE
User: /goal Migrate the payments service from REST to gRPC and get the integration tests passing.
Claude: Goal registered. I'll work toward this until you clear it.
[Goal panel: ⏱ 0s · turns 0 · tokens 0]

User: start by listing the REST endpoints
Claude: [does the work, panel updates]

Проверка зависших фоновых задач (v2.1.234): пока активна цель, если фоновая задача не продвигается 30+ минут, Claude присылает статус вместо того, чтобы молча продолжать работу. Порог (в минутах) настраивается переменной окружения CLAUDE_CODE_GOAL_CHECKIN_MINUTES; значение 0 полностью отключает такие проверки.

/team-onboarding - руководство по адаптации новых участников команды

Новое в v2.1.101

Используйте /team-onboarding, чтобы сгенерировать руководство по адаптации нового участника команды на основе того, как Claude Code используется в вашем проекте локально. Команда анализирует CLAUDE.md, установленные skills, subagents, hooks и недавние сценарии работы, после чего формирует onboarding-документ, который помогает новым разработчикам быстрее выйти на продуктивную работу.

Это встроенная команда - ничего устанавливать не нужно.

Использование:

bash
claude /team-onboarding

Сгенерированное руководство включает:

  • Назначение проекта и ключевые соглашения из CLAUDE.md
  • Доступные skills и условия их автоматического вызова
  • Настроенные subagents и их зоны ответственности
  • Hooks, срабатывающие на типовых событиях
  • Основные рабочие процессы, с которыми стоит ознакомиться новым участникам

Доступность: появилось в Claude Code v2.1.101 (11 апреля 2026 г.).

Пользовательские команды (теперь skills)

Пользовательские slash-команды были объединены со skills. Оба подхода создают команды, вызываемые через /command-name:

ApproachLocationStatus
Skills (Recommended).claude/skills/<name>/SKILL.mdCurrent standard
Legacy Commands.claude/commands/<name>.mdStill works
Если skill и команда имеют одинаковое имя, приоритет у skill. Например, если одновременно существуют .claude/commands/review.md и .claude/skills/review/SKILL.md, будет использоваться версия из skill.

Миграция

Существующие файлы в .claude/commands/ продолжают работать без изменений. Чтобы перейти на skills:

Было (команда):

CODE
.claude/commands/optimize.md

После (Skill):

CODE
.claude/skills/optimize/SKILL.md

Зачем нужны Skills?

Skills предоставляют дополнительные возможности по сравнению с устаревшими командами:

  • Структура каталога: объединяйте скрипты, шаблоны и справочные файлы
  • Автоматический вызов: Claude может сам запускать skills, когда это уместно
  • Управление вызовом: выбирайте, кто может вызывать skill - пользователь, Claude или оба
  • Выполнение в subagent: запускайте skills в изолированных контекстах с помощью context: fork
  • Постепенное раскрытие: подгружайте дополнительные файлы только при необходимости

Создание пользовательской команды в виде skill

Создайте каталог с файлом SKILL.md:

bash
mkdir -p .claude/skills/my-command

Файл: .claude/skills/my-command/SKILL.md

yaml
---
name: my-command
description: What this command does and when to use it
---

# My Command

Instructions for Claude to follow when this command is invoked.

1. First step
2. Second step
3. Third step

Справочник по frontmatter

FieldPurposeDefault
nameCommand name (becomes /name)Directory name
descriptionBrief description (helps Claude know when to use it)First paragraph
argument-hintExpected arguments for auto-completionNone
allowed-toolsTools the command can use without permissionInherits
modelSpecific model to useInherits
disable-model-invocationIf true, only user can invoke (not Claude)false
user-invocableIf false, hide from / menutrue
contextSet to fork to run in isolated subagentNone
agentAgent type when using context: forkgeneral-purpose
hooksSkill-scoped hooks (PreToolUse, PostToolUse, Stop)None

Аргументы

Команды могут принимать аргументы:

Все аргументы через $ARGUMENTS:

yaml
---
name: fix-issue
description: Fix a GitHub issue by number
---

Fix issue #$ARGUMENTS following our coding standards

Использование: /fix-issue 123 → $ARGUMENTS принимает значение "123"

Отдельные аргументы через $0, $1 и т. д.:

yaml
---
name: review-pr
description: Review a PR with priority
---

Review PR #$0 with priority $1

Использование: /review-pr 456 high → $0="456", $1="high"

${CLAUDE_PROJECT_DIR} раскрывается в абсолютный путь к корню проекта (v2.1.196).

Динамический контекст через shell-команды

Выполняйте bash-команды перед промптом с помощью !`command`:

yaml
---
name: commit
description: Create a git commit with context
allowed-tools: Bash(git *)
---

## Context

- Current git status: !`git status`
- Current git diff: !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -5`

## Your task

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

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

Подключайте содержимое файлов с помощью @:

markdown
Review the implementation in @src/utils/helpers.js
Compare @src/old-version.js with @src/new-version.js

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

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

CODE
/plugin-name:command-name

Или просто /command-name, если нет конфликта имён.

Примеры:

bash
/frontend-design:frontend-design
/commit-commands:commit

MCP-промпты как команды

MCP-серверы могут предоставлять промпты в виде slash-команд:

CODE
/mcp__<server-name>__<prompt-name> [arguments]

Примеры:

bash
/mcp__github__list_prs
/mcp__github__pr_review 456
/mcp__jira__create_issue "Bug title" high

Синтаксис разрешений MCP

Управление доступом к MCP-серверам через разрешения:

  • mcp__github - доступ ко всему MCP-серверу GitHub
  • mcp__github__* - wildcard-доступ ко всем инструментам
  • mcp__github__get_issue - доступ к конкретному инструменту

Архитектура команд

graph TD A["User Input: /command-name"] --> B{"Command Type?"} B -->|Built-in| C["Execute Built-in"] B -->|Skill| D["Load SKILL.md"] B -->|Plugin| E["Load Plugin Command"] B -->|MCP| F["Execute MCP Prompt"] D --> G["Parse Frontmatter"] G --> H["Substitute Variables"] H --> I["Execute Shell Commands"] I --> J["Send to Claude"] J --> K["Return Results"]

Жизненный цикл команды

sequenceDiagram participant User participant Claude as Claude Code participant FS as File System participant CLI as Shell/Bash User->>Claude: Types /optimize Claude->>FS: Searches .claude/skills/ and .claude/commands/ FS-->>Claude: Returns optimize/SKILL.md Claude->>Claude: Parses frontmatter Claude->>CLI: Executes !`command` substitutions CLI-->>Claude: Command outputs Claude->>Claude: Substitutes $ARGUMENTS Claude->>User: Processes prompt Claude->>User: Returns results

Доступные команды в этой папке

Эти примеры команд можно установить как skills или как legacy commands.

1. /optimize - оптимизация кода

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

Использование:

CODE
/optimize
[Paste your code]

2. /pr - подготовка Pull Request

Проводит по чек-листу подготовки PR: линтинг, тестирование и оформление commit-сообщений.

Использование:

CODE
/pr

Скриншот: /pr

3. /generate-api-docs - генератор документации API

Формирует полную документацию API на основе исходного кода.

Использование:

CODE
/generate-api-docs

4. /commit - git-коммит с контекстом

Создаёт git-коммит с динамическим контекстом из вашего репозитория.

Использование:

CODE
/commit [optional message]

5. /push-all - индексация, commit и push

Добавляет все изменения в индекс, создаёт commit и отправляет их в удалённый репозиторий с проверками безопасности.

Использование:

CODE
/push-all

Проверки безопасности:

  • Секреты: .env*, *.key, *.pem, credentials.json
  • API-ключи: отличает реальные ключи от placeholder-значений
  • Большие файлы: >10MB без Git LFS
  • Артефакты сборки: node_modules/, dist/, __pycache__/

6. /doc-refactor - реструктуризация документации

Перестраивает документацию проекта для повышения ясности и удобства навигации.

Использование:

CODE
/doc-refactor

7. /setup-ci-cd - настройка CI/CD-пайплайна

Настраивает pre-commit hooks и GitHub Actions для контроля качества.

Использование:

CODE
/setup-ci-cd

8. /unit-test-expand - расширение тестового покрытия

Повышает покрытие тестами, фокусируясь на непокрытых ветках кода и граничных случаях.

Использование:

CODE
/unit-test-expand

Установка

В виде Skills (рекомендуется)

Скопируйте в каталог skills:

bash
# Create skills directory
mkdir -p .claude/skills

# For each command file, create a skill directory
for cmd in optimize pr commit; do
  mkdir -p .claude/skills/$cmd
  cp 01-slash-commands/$cmd.md .claude/skills/$cmd/SKILL.md
done

В виде legacy-команд

Скопируйте в ваш каталог команд:

bash
# Project-wide (team)
mkdir -p .claude/commands
cp 01-slash-commands/*.md .claude/commands/

# Personal use
mkdir -p ~/.claude/commands
cp 01-slash-commands/*.md ~/.claude/commands/

Создание собственных команд

Шаблон skill (рекомендуется)

Создайте файл .claude/skills/my-command/SKILL.md:

yaml
---
name: my-command
description: What this command does. Use when [trigger conditions].
argument-hint: [optional-args]
allowed-tools: Bash(npm *), Read, Grep
---

# Command Title

## Context

- Current branch: !`git branch --show-current`
- Related files: @package.json

## Instructions

1. First step
2. Second step with argument: $ARGUMENTS
3. Third step

## Output Format

- How to format the response
- What to include

Команда только для пользователя (без автоматического вызова)

Для команд с побочными эффектами, которые Claude не должен вызывать автоматически:

yaml
---
name: deploy
description: Deploy to production
disable-model-invocation: true
allowed-tools: Bash(npm *), Bash(git *)
---

Deploy the application to production:

1. Run tests
2. Build application
3. Push to deployment target
4. Verify deployment

Лучшие практики

DoDon't
Use clear, action-oriented namesCreate commands for one-time tasks
Include description with trigger conditionsBuild complex logic in commands
Keep commands focused on single taskHardcode sensitive information
Use disable-model-invocation for side effectsSkip the description field
Use ! prefix for dynamic contextAssume Claude knows current state
Organize related files in skill directoriesPut everything in one file

Устранение неполадок

Команда не найдена

Решения:

  • Убедитесь, что файл находится по пути .claude/skills/<name>/SKILL.md или .claude/commands/<name>.md
  • Проверьте, что поле name во frontmatter совпадает с ожидаемым именем команды
  • Перезапустите сессию Claude Code
  • Выполните /help, чтобы посмотреть список доступных команд

Команда работает не так, как ожидалось

Решения:

  • Сформулируйте инструкции более конкретно
  • Добавьте примеры в файл skill
  • Проверьте allowed-tools, если используются bash-команды
  • Сначала протестируйте на простых входных данных

Конфликт между skill и командой

Если skill и команда имеют одинаковое имя, приоритет отдаётся skill. Удалите одно из них или переименуйте.

Связанные руководства

  • Skills - полный справочник по skills (автоматически вызываемые возможности)
  • Memory - постоянный контекст через CLAUDE.md
  • Subagents - делегирование задач AI-агентам
  • Plugins - готовые наборы команд
  • Hooks - автоматизация на основе событий

Дополнительные материалы


Последнее обновление: 6 сентября 2026 г. Версия Claude Code: 2.1.263 Источники:

Часть серии руководств Claude How To

ЛОКАЛЬНАЯ ОТМЕТКА · БЕЗ ПРОВЕРКИ
cc-learnМОДУЛЬ 01
МОДУЛЬ 01/УРОК

Слэш-команды

Slash-команды

Обзор

Slash-команды - это сокращения, управляющие поведением Claude в ходе интерактивной сессии. Они бывают нескольких типов:

  • Встроенные команды: предоставляются Claude Code (/help, /clear, /model)
  • Skills: пользовательские команды, оформленные в виде файлов SKILL.md (/optimize, /pr)
  • Команды плагинов: команды из установленных плагинов (/frontend-design:frontend-design)
  • MCP-промпты: команды с MCP-серверов (/mcp__github__list_prs)

Примечание: Пользовательские slash-команды теперь объединены со skills. Файлы в .claude/commands/ по-прежнему работают, однако рекомендуемым подходом стали skills (.claude/skills/). И тот, и другой вариант создают сокращение вида /command-name. Полную справку см. в руководстве по Skills.

Справочник встроенных команд

Встроенные команды - это сокращения для типовых действий. Доступно более 60 встроенных команд и 10 предустановленных skills. Введите / в Claude Code, чтобы увидеть полный список, либо / и любые буквы - для фильтрации.

Примечание: Начиная с v2.1.236, при нажатии Enter на slash-команде с опечаткой - или на команде, недоступной в текущей сессии, - выводится ошибка, а не молча запускается ближайшее нечёткое совпадение. Однозначные префиксы и заданные алиасы по-прежнему выполняются, как и раньше. | Command | Purpose | |---------|---------| | /add-dir <path> | Add working directory | | /advisor [model\|off] | Configure the advisor. Opens as an interactive dialog; in the desktop app, Remote Control, and headless (-p / Agent SDK) sessions it takes a text form instead - bare /advisor, /advisor <model>, or /advisor off (v2.1.260+) | | /agents | Manage agent configurations | | /branch [name] | Switch into a copy of the conversation at this point, preserving the original (return to it with /resume) | | /fork [prompt] | Copy the current conversation into a new background session and keep working here; the two are independent from that point on and the copy gets its own row in claude agents (v2.1.212+). Except when the copy edits in place, Claude Code instructs it to create a worktree of its own before making code changes (isolation instruction requires v2.1.221+) | | /subtask <task> | Spawn a forked subagent that inherits the full conversation and works on the task while you keep going; its result returns to this conversation when it finishes (v2.1.212+) | | /btw <question> | Ask an ephemeral side question while Claude is working on the main task; doesn't pollute the main conversation context | | /cd <path> | Move the session to a new working directory without breaking the prompt cache (added v2.1.169) | | /chrome | Configure Chrome browser integration | | /clear | Clear conversation (aliases: /reset, /new) | | /color [color\|default] | Set prompt bar color. Bare /color (no args) picks a random session color (v2.1.128+); pass a color name or hex to set explicitly. | | /compact [instructions] | Compact conversation with optional focus instructions. A failed compact now displays as an error in the UI instead of silently doing nothing (v2.1.216) | | /config | Open Settings (alias: /settings) | | /context | Visualize context usage as colored grid. Shows an explicit warning when usage is over the context window limit (v2.1.216) | | /copy [N] | Copy assistant response to clipboard; w writes to file | | /cost | Typing-shortcut alias for /usage - opens the cost tab (v2.1.118+) | | /desktop | Continue in Desktop app (alias: /app) | | /diff | Interactive diff viewer for uncommitted changes. In fullscreen rendering it instead opens a diff panel beside the conversation that stays open while you keep working - it lists changed files with added/removed line counts and refreshes every time Claude edits a file or runs a shell command; run /diff again or click ✕ to close it (v2.1.260+). The classic renderer opens the viewer in place of the prompt | | /doctor | Diagnose installation health - openable while Claude is responding; shows status icons; press f to auto-fix issues (enhanced in v2.1.116; layout refreshed to a flat tree with clearer icons in v2.1.178) | | /effort [low\|medium\|high\|xhigh\|max\|auto] | Set effort level via interactive arrow-key slider. Levels: low → medium → high → xhigh (new in v2.1.111) → max. Default is high on Opus 5, Sonnet 5, and Opus 4.8 (xhigh on Opus 4.7); xhigh needs Opus 5, Sonnet 5, Opus 4.8, or Opus 4.7; max works on Opus 5, Sonnet 5, Opus 4.8/4.7/4.6 and Sonnet 4.6. The menu also offers ultracode (not a model effort level - it sends xhigh and has Claude orchestrate dynamic workflows; session-only) | | /exit | Exit the REPL (alias: /quit) | | /export [filename] | Export the current conversation to a file or clipboard | | /usage-credits | Configure extra usage for rate limits (renamed from /extra-usage in v2.1.144; /extra-usage still works as an alias) | | /fast [on\|off] | Toggle fast mode. Applies to Opus 5 and Opus 4.8 (v2.1.219) | | /feedback | Submit feedback (alias: /bug). Since v2.1.141, can attach recent sessions (last 24h or 7d) so reports spanning more than one session include context. As of v2.1.178, /bug requires a description before it can be submitted. | | /focus | Toggle focus view (added v2.1.110; replaces Ctrl+O for focus toggle) | | /goal <statement> | Register a session-level completion condition; Claude keeps working until the goal is met. /goal clear removes it. Active goal appears in the status line, with a live overlay panel showing elapsed time, turn count, and token usage (added v2.1.139). | | /help | Show help | | /hooks | View hook configurations | | /ide | Manage IDE integrations | | /init | Initialize CLAUDE.md. Set CLAUDE_CODE_NEW_INIT=1 for interactive flow | | /insights | Generate session analysis report | | /install-github-app | Set up GitHub Actions app | | /install-slack-app | Install Slack app | | /keybindings | Open keybindings configuration | | /fewer-permission-prompts | Analyze recent Bash/MCP tool calls and add a prioritized allowlist to .claude/settings.json to reduce permission prompts (added v2.1.111) | | /login | Switch Anthropic accounts | | /logout | Sign out from your Anthropic account | | /mcp | Manage MCP servers and OAuth | | /memory | Edit CLAUDE.md, toggle auto-memory | | /mobile | QR code for mobile app (aliases: /ios, /android) | | /model [model] | Select model with left/right arrows for effort. Since v2.1.153, the choice is saved as the default for new sessions (matching the IDE); press s after selecting to apply it to the current session only. (The keybinding modelPicker:setAsDefault was renamed to modelPicker:thisSessionOnly; the old d action is now s.) As of v2.1.219, the picker shows the merged Opus row as "Opus (1M context)". | | /passes | Share free week of Claude Code | | /permissions | View/update permissions (alias: /allowed-tools) | | /plan [description] | Enter plan mode | | /plugin | Manage plugins | | /proactive | Alias for /loop (added v2.1.105) | | /powerup | Discover features through interactive lessons with animated demos | | /privacy-settings | Privacy settings (Pro/Max only) | | /release-notes | View changelog | | /recap | Show session recap / summary when returning to a session (added v2.1.108) | | /reload-plugins | Reload active plugins. Since v2.1.221 most installs activate immediately, so this is only needed when the install summary says Run /reload-plugins to activate. Available in headless sessions as of v2.1.260, so it also appears in the Claude Code Desktop and SDK command lists | | /reload-skills | Re-scan skill directories without restarting the session (added v2.1.152) | | /remote-control | Remote control from claude.ai (alias: /rc) | | /remote-env | Configure default remote environment | | /rename [name] | Rename session | | /resume [session] | Resume conversation (alias: /continue) | | /review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path] | Alias of /code-review (v2.1.223): reviews the current diff, or a PR number, branch, or path you pass - e.g. /review 1234. Takes the same effort levels and flags. With no level given, it reuses the last low-max level you typed | | /rewind | Rewind conversation and/or code (alias: /checkpoint) | | /sandbox | Toggle sandbox mode | | /schedule [description] | Create/manage Cloud scheduled tasks | | /scroll-speed <+N\|-N> | Tune mouse-wheel scroll speed of the TUI live-preview pane with a live preview. Persists per-machine to ~/.claude/preferences.json (added v2.1.139). | | /security-review | Analyze branch for security vulnerabilities | | /skill-doctor | Show which loaded skills go unused and what each one costs in context, so you can decide which to turn off. The report opens in the /plugin manager's Stats tab; in non-interactive -p mode it prints as text. Over Remote Control it replies Skill usage reports are not available on this connection. - run it in the terminal on the machine hosting the session (requires v2.1.252+) | | /skills | List available skills | | /stats | Typing-shortcut alias for /usage - opens the stats tab (daily usage, sessions, streaks) (v2.1.118+) | | /stickers | Order Claude Code stickers | | /status | Show version, model, account, and a Session kind row reading background job · attached, background job · unattended, or interactive (row added v2.1.221). Openable while Claude is responding | | /statusline | Configure status line | | /tasks | List/manage background tasks | | /team-onboarding | Generate a teammate ramp-up guide from the project's Claude Code setup (new in v2.1.101) | | /teleport | Resume a Claude Code on the web session in this terminal; opens a picker of your web sessions (alias: /tp). Requires a claude.ai subscription | | /terminal-setup | Configure terminal keybindings | | /theme | Open theme picker / manage custom themes (v2.1.118). Define custom themes via JSON in ~/.claude/themes/<name>.json | | /tui | Toggle fullscreen TUI (text user interface) mode with flicker-free rendering (added v2.1.110) | | /ultrareview | Comprehensive cloud-based multi-agent code review (added v2.1.111). The preferred invocation is now /code-review ultra; /ultrareview remains as an alias. Includes 3 free runs on Pro and Max, then requires usage credits | | /upgrade | Open upgrade page for higher plan tier | | /usage | Canonical usage dashboard (v2.1.118) - combines plan usage limits, rate limits, cost, and daily session stats. /cost and /stats are typing-shortcut aliases that open specific tabs | | /voice | Toggle push-to-talk voice dictation | | /workflows | View running and completed dynamic workflow runs (added v2.1.154). See Dynamic Workflows | Почему /cd важен: раньше смена директории приводила к потере «прогретости» кэша (следующий запрос становился медленнее и дороже); /cd сохраняет prompt cache при переключении.

Встроенные skills

Эти skills поставляются вместе с Claude Code и вызываются как slash-команды:

SkillPurpose
/batch <instruction>Orchestrate large-scale parallel changes using worktrees
/claude-apiLoad Claude API reference for project language
/datavizChart and dashboard design guidance with a runnable color-palette validator (v2.1.198)
/debug [description]Enable debug logging
/design [description]Create a design canvas - a multi-artboard visual design (UI mockups, screen flows, landing pages, posters) published as an artifact and refined visually rather than in code. Use it instead of hand-writing HTML when the layout is what you want to iterate on. Research preview; requires v2.1.233+ and a Pro, Max, Team, or Enterprise plan
/loop [interval] <prompt>Run prompt repeatedly on interval
/code-review [low|medium|high|xhigh|max|ultra] [--fix] [--comment] [pr#|branch|path]Review the current diff - or a PR number, branch, or path you pass - for correctness bugs. Pass --fix to apply findings, --comment to post them as inline GitHub PR comments, or ultra to run a deep cloud review; with ultra on a github.com PR target, --post preselects posting the findings to the PR. With no effort level given, the review reuses the last level you typed (v2.1.223). Originally absorbed /simplify in v2.1.146, but /simplify returned as a distinct command in v2.1.154
/simplifyRun a cleanup-only review (reuse / simplification / efficiency / altitude) and apply the fixes; does not hunt for bugs - use /code-review for that. Briefly an alias of /code-review --fix (v2.1.152), it became cleanup-only in v2.1.154

Устаревшие команды

CommandStatus
/output-styleRemoved in v2.1.91 (deprecated v2.1.73) - use /config → Output style, or the outputStyle setting
/pr-commentsRemoved in v2.1.91 - ask Claude directly to view PR comments
/vimRemoved in v2.1.92 - use /config → Editor mode
/undoNo longer listed in the official commands reference as of v2.1.245 (it was added as an alias for /rewind in v2.1.108) - use /rewind or press Esc twice

Недавние изменения

  • /fork и /subtask поменялись ролями в v2.1.212. /fork теперь копирует диалог в новую независимую фоновую сессию; прежнее поведение с forked-subagent перешло к новой команде /subtask. История: с v2.1.77 по v2.1.161 /fork был alias для /branch; с v2.1.161 по v2.1.211 он запускал forked subagent (то, что теперь делает /subtask). Когда agent view отключён, /subtask недоступна, а /fork сохраняет поведение forked-subagent
  • /resume (без аргументов) открывает список прошлых сессий - включая скрытые из видимого списка - и возобновляет выбранную как фоновую сессию (v2.1.212)
  • /output-style объявлена устаревшей (v2.1.73) и удалена (v2.1.91) - output styles по-прежнему доступны через /config → Output style или настройку outputStyle; встроенные варианты: Default, Proactive, Explanatory, Learning и Concise (добавлен в v2.1.237)
  • /review стала полным alias для /code-review - те же цели, уровни effort и флаги (v2.1.223). История: сначала, в v2.1.186, она перешла на движок /code-review medium, оставаясь только для PR
  • Добавлена команда /effort; уровень max доступен на Opus 4.6+ (изначально только на Opus 4.6)
  • Добавлена команда /voice для push-to-talk голосовой диктовки
  • Добавлена команда /schedule для создания запланированных задач и управления ими
  • Добавлена команда /color для настройки внешнего вида prompt bar
  • /pr-comments удалена в v2.1.91 - попросите Claude напрямую посмотреть комментарии PR
  • /vim удалена в v2.1.92 - вместо неё используйте /config → Editor mode
  • /ultraplan удалена в v2.1.222 - используйте вместо неё plan mode
  • Добавлена /powerup для интерактивных уроков по возможностям
  • Добавлена /sandbox для переключения sandbox mode
  • Пикер /model теперь показывает понятные человеку названия (например, "Sonnet 4.6") вместо «сырых» ID моделей
  • /resume поддерживает alias /continue
  • MCP prompts доступны как команды /mcp__<server>__<prompt> (см. MCP Prompts as Commands)
  • Добавлена /team-onboarding для автогенерации гайдов по онбордингу коллег по команде (v2.1.101)
  • Добавлена команда /tui для полноэкранного TUI-рендеринга без мерцания (v2.1.110)
  • Добавлена команда /focus для переключения focus view; Ctrl+O теперь переключает только verbose transcript (v2.1.110)
  • Добавлена команда /recap для ручного запуска recap контекста сессии (v2.1.108)
  • Добавлена /undo как alias для /rewind (v2.1.108); начиная с v2.1.245 она больше не фигурирует в официальном справочнике команд - используйте /rewind или Esc Esc
  • Добавлена /proactive как alias для /loop (v2.1.105)
  • /effort получила интерактивный слайдер, управляемый стрелками, и новый уровень xhigh между high и max; уровень по умолчанию для планов Opus 4.7 повышен до xhigh (v2.1.111). На Opus 4.8 значение по умолчанию - high (v2.1.154); Opus 5 также по умолчанию использует high (v2.1.219)
  • Добавлена /ultrareview для комплексного облачного multi-agent code review (v2.1.111)
  • Добавлена /fewer-permission-prompts - анализирует вызовы инструментов Bash/MCP и уменьшает число permission prompts за счёт allowlist в .claude/settings.json (v2.1.111)
  • Auto mode больше не требует флага --enable-auto-mode для подписчиков Max на Opus 4.7 (v2.1.112)
  • Добавлена /goal - условие завершения на уровне сессии, к которому Claude движется на протяжении нескольких ходов; live-оверлей показывает прошедшее время, количество ходов и расход tokens (v2.1.139)
  • Добавлена /scroll-speed - настройка скорости прокрутки колесом мыши в панели live-preview TUI; сохраняется отдельно для каждой машины (v2.1.139)
  • Добавлена /reload-skills - повторное сканирование каталогов skill без перезапуска сессии (v2.1.152)
  • /model теперь сохраняет выбранную модель как значение по умолчанию для новых сессий; нажмите s, чтобы применить только к текущей сессии (keybinding modelPicker:setAsDefault → modelPicker:thisSessionOnly) (v2.1.153)
  • Добавлена /workflows - просмотр запущенных и завершённых запусков dynamic workflow (v2.1.154)
  • /simplify вернулась как отдельная команда review, ориентированная только на cleanup (reuse / simplification / efficiency / altitude), в отличие от bug hunt в /code-review (v2.1.154)
  • /status получила строку Session kind, отличающую attached и unattended фоновые задачи от интерактивных сессий (v2.1.221)
  • Установка плагинов теперь активирует их сразу, когда это безопасно; /reload-plugins нужна только тогда, когда об этом просит сводка установки (v2.1.221)
  • /ultraplan удалена - используйте plan mode (v2.1.222)
  • /code-review и /review запоминают последний введённый вами уровень effort и подставляют его, если вы его не указали (v2.1.223)
  • /code-review ultra стала предпочтительной точкой входа для облачного multi-agent review; /ultrareview остаётся её alias (v2.1.223)
  • /code-review на уровнях effort high, xhigh и max теперь запускается в фоновом агенте, как и на остальных уровнях (v2.1.232)
  • Стартовая подсказка с предложением создать собственные subagents и соответствующий совет в туре /powerup были убраны (v2.1.232)
  • /permissions теперь можно открыть, пока Claude работает - изменения правил применяются к оставшейся части текущего хода (v2.1.234)
  • /add-dir <path> теперь можно использовать, пока Claude работает; диалоги /add-dir, /autocompact, /theme, /help, /config и /advisor открываются посреди хода в полноэкранном TUI, не откладываясь в очередь до завершения ответа Claude (/bug уже открывалась сразу, начиная с v2.1.232) (v2.1.234)

/goal - условие завершения на уровне сессии

Новое в v2.1.139

Используйте /goal, чтобы задать условие завершения для текущей сессии. Claude движется к нему на протяжении нескольких ходов, а панель-оверлей показывает прошедшее время, количество ходов и израсходованные tokens. Сбросить условие можно с помощью /goal clear. Работает в интерактивном режиме, в claude -p и в Remote Control.

CODE
User: /goal Migrate the payments service from REST to gRPC and get the integration tests passing.
Claude: Goal registered. I'll work toward this until you clear it.
[Goal panel: ⏱ 0s · turns 0 · tokens 0]

User: start by listing the REST endpoints
Claude: [does the work, panel updates]

Проверка зависших фоновых задач (v2.1.234): пока активна цель, если фоновая задача не продвигается 30+ минут, Claude присылает статус вместо того, чтобы молча продолжать работу. Порог (в минутах) настраивается переменной окружения CLAUDE_CODE_GOAL_CHECKIN_MINUTES; значение 0 полностью отключает такие проверки.

/team-onboarding - руководство по адаптации новых участников команды

Новое в v2.1.101

Используйте /team-onboarding, чтобы сгенерировать руководство по адаптации нового участника команды на основе того, как Claude Code используется в вашем проекте локально. Команда анализирует CLAUDE.md, установленные skills, subagents, hooks и недавние сценарии работы, после чего формирует onboarding-документ, который помогает новым разработчикам быстрее выйти на продуктивную работу.

Это встроенная команда - ничего устанавливать не нужно.

Использование:

bash
claude /team-onboarding

Сгенерированное руководство включает:

  • Назначение проекта и ключевые соглашения из CLAUDE.md
  • Доступные skills и условия их автоматического вызова
  • Настроенные subagents и их зоны ответственности
  • Hooks, срабатывающие на типовых событиях
  • Основные рабочие процессы, с которыми стоит ознакомиться новым участникам

Доступность: появилось в Claude Code v2.1.101 (11 апреля 2026 г.).

Пользовательские команды (теперь skills)

Пользовательские slash-команды были объединены со skills. Оба подхода создают команды, вызываемые через /command-name:

ApproachLocationStatus
Skills (Recommended).claude/skills/<name>/SKILL.mdCurrent standard
Legacy Commands.claude/commands/<name>.mdStill works
Если skill и команда имеют одинаковое имя, приоритет у skill. Например, если одновременно существуют .claude/commands/review.md и .claude/skills/review/SKILL.md, будет использоваться версия из skill.

Миграция

Существующие файлы в .claude/commands/ продолжают работать без изменений. Чтобы перейти на skills:

Было (команда):

CODE
.claude/commands/optimize.md

После (Skill):

CODE
.claude/skills/optimize/SKILL.md

Зачем нужны Skills?

Skills предоставляют дополнительные возможности по сравнению с устаревшими командами:

  • Структура каталога: объединяйте скрипты, шаблоны и справочные файлы
  • Автоматический вызов: Claude может сам запускать skills, когда это уместно
  • Управление вызовом: выбирайте, кто может вызывать skill - пользователь, Claude или оба
  • Выполнение в subagent: запускайте skills в изолированных контекстах с помощью context: fork
  • Постепенное раскрытие: подгружайте дополнительные файлы только при необходимости

Создание пользовательской команды в виде skill

Создайте каталог с файлом SKILL.md:

bash
mkdir -p .claude/skills/my-command

Файл: .claude/skills/my-command/SKILL.md

yaml
---
name: my-command
description: What this command does and when to use it
---

# My Command

Instructions for Claude to follow when this command is invoked.

1. First step
2. Second step
3. Third step

Справочник по frontmatter

FieldPurposeDefault
nameCommand name (becomes /name)Directory name
descriptionBrief description (helps Claude know when to use it)First paragraph
argument-hintExpected arguments for auto-completionNone
allowed-toolsTools the command can use without permissionInherits
modelSpecific model to useInherits
disable-model-invocationIf true, only user can invoke (not Claude)false
user-invocableIf false, hide from / menutrue
contextSet to fork to run in isolated subagentNone
agentAgent type when using context: forkgeneral-purpose
hooksSkill-scoped hooks (PreToolUse, PostToolUse, Stop)None

Аргументы

Команды могут принимать аргументы:

Все аргументы через $ARGUMENTS:

yaml
---
name: fix-issue
description: Fix a GitHub issue by number
---

Fix issue #$ARGUMENTS following our coding standards

Использование: /fix-issue 123 → $ARGUMENTS принимает значение "123"

Отдельные аргументы через $0, $1 и т. д.:

yaml
---
name: review-pr
description: Review a PR with priority
---

Review PR #$0 with priority $1

Использование: /review-pr 456 high → $0="456", $1="high"

${CLAUDE_PROJECT_DIR} раскрывается в абсолютный путь к корню проекта (v2.1.196).

Динамический контекст через shell-команды

Выполняйте bash-команды перед промптом с помощью !`command`:

yaml
---
name: commit
description: Create a git commit with context
allowed-tools: Bash(git *)
---

## Context

- Current git status: !`git status`
- Current git diff: !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -5`

## Your task

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

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

Подключайте содержимое файлов с помощью @:

markdown
Review the implementation in @src/utils/helpers.js
Compare @src/old-version.js with @src/new-version.js

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

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

CODE
/plugin-name:command-name

Или просто /command-name, если нет конфликта имён.

Примеры:

bash
/frontend-design:frontend-design
/commit-commands:commit

MCP-промпты как команды

MCP-серверы могут предоставлять промпты в виде slash-команд:

CODE
/mcp__<server-name>__<prompt-name> [arguments]

Примеры:

bash
/mcp__github__list_prs
/mcp__github__pr_review 456
/mcp__jira__create_issue "Bug title" high

Синтаксис разрешений MCP

Управление доступом к MCP-серверам через разрешения:

  • mcp__github - доступ ко всему MCP-серверу GitHub
  • mcp__github__* - wildcard-доступ ко всем инструментам
  • mcp__github__get_issue - доступ к конкретному инструменту

Архитектура команд

graph TD A["User Input: /command-name"] --> B{"Command Type?"} B -->|Built-in| C["Execute Built-in"] B -->|Skill| D["Load SKILL.md"] B -->|Plugin| E["Load Plugin Command"] B -->|MCP| F["Execute MCP Prompt"] D --> G["Parse Frontmatter"] G --> H["Substitute Variables"] H --> I["Execute Shell Commands"] I --> J["Send to Claude"] J --> K["Return Results"]

Жизненный цикл команды

sequenceDiagram participant User participant Claude as Claude Code participant FS as File System participant CLI as Shell/Bash User->>Claude: Types /optimize Claude->>FS: Searches .claude/skills/ and .claude/commands/ FS-->>Claude: Returns optimize/SKILL.md Claude->>Claude: Parses frontmatter Claude->>CLI: Executes !`command` substitutions CLI-->>Claude: Command outputs Claude->>Claude: Substitutes $ARGUMENTS Claude->>User: Processes prompt Claude->>User: Returns results

Доступные команды в этой папке

Эти примеры команд можно установить как skills или как legacy commands.

1. /optimize - оптимизация кода

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

Использование:

CODE
/optimize
[Paste your code]

2. /pr - подготовка Pull Request

Проводит по чек-листу подготовки PR: линтинг, тестирование и оформление commit-сообщений.

Использование:

CODE
/pr

Скриншот: /pr

3. /generate-api-docs - генератор документации API

Формирует полную документацию API на основе исходного кода.

Использование:

CODE
/generate-api-docs

4. /commit - git-коммит с контекстом

Создаёт git-коммит с динамическим контекстом из вашего репозитория.

Использование:

CODE
/commit [optional message]

5. /push-all - индексация, commit и push

Добавляет все изменения в индекс, создаёт commit и отправляет их в удалённый репозиторий с проверками безопасности.

Использование:

CODE
/push-all

Проверки безопасности:

  • Секреты: .env*, *.key, *.pem, credentials.json
  • API-ключи: отличает реальные ключи от placeholder-значений
  • Большие файлы: >10MB без Git LFS
  • Артефакты сборки: node_modules/, dist/, __pycache__/

6. /doc-refactor - реструктуризация документации

Перестраивает документацию проекта для повышения ясности и удобства навигации.

Использование:

CODE
/doc-refactor

7. /setup-ci-cd - настройка CI/CD-пайплайна

Настраивает pre-commit hooks и GitHub Actions для контроля качества.

Использование:

CODE
/setup-ci-cd

8. /unit-test-expand - расширение тестового покрытия

Повышает покрытие тестами, фокусируясь на непокрытых ветках кода и граничных случаях.

Использование:

CODE
/unit-test-expand

Установка

В виде Skills (рекомендуется)

Скопируйте в каталог skills:

bash
# Create skills directory
mkdir -p .claude/skills

# For each command file, create a skill directory
for cmd in optimize pr commit; do
  mkdir -p .claude/skills/$cmd
  cp 01-slash-commands/$cmd.md .claude/skills/$cmd/SKILL.md
done

В виде legacy-команд

Скопируйте в ваш каталог команд:

bash
# Project-wide (team)
mkdir -p .claude/commands
cp 01-slash-commands/*.md .claude/commands/

# Personal use
mkdir -p ~/.claude/commands
cp 01-slash-commands/*.md ~/.claude/commands/

Создание собственных команд

Шаблон skill (рекомендуется)

Создайте файл .claude/skills/my-command/SKILL.md:

yaml
---
name: my-command
description: What this command does. Use when [trigger conditions].
argument-hint: [optional-args]
allowed-tools: Bash(npm *), Read, Grep
---

# Command Title

## Context

- Current branch: !`git branch --show-current`
- Related files: @package.json

## Instructions

1. First step
2. Second step with argument: $ARGUMENTS
3. Third step

## Output Format

- How to format the response
- What to include

Команда только для пользователя (без автоматического вызова)

Для команд с побочными эффектами, которые Claude не должен вызывать автоматически:

yaml
---
name: deploy
description: Deploy to production
disable-model-invocation: true
allowed-tools: Bash(npm *), Bash(git *)
---

Deploy the application to production:

1. Run tests
2. Build application
3. Push to deployment target
4. Verify deployment

Лучшие практики

DoDon't
Use clear, action-oriented namesCreate commands for one-time tasks
Include description with trigger conditionsBuild complex logic in commands
Keep commands focused on single taskHardcode sensitive information
Use disable-model-invocation for side effectsSkip the description field
Use ! prefix for dynamic contextAssume Claude knows current state
Organize related files in skill directoriesPut everything in one file

Устранение неполадок

Команда не найдена

Решения:

  • Убедитесь, что файл находится по пути .claude/skills/<name>/SKILL.md или .claude/commands/<name>.md
  • Проверьте, что поле name во frontmatter совпадает с ожидаемым именем команды
  • Перезапустите сессию Claude Code
  • Выполните /help, чтобы посмотреть список доступных команд

Команда работает не так, как ожидалось

Решения:

  • Сформулируйте инструкции более конкретно
  • Добавьте примеры в файл skill
  • Проверьте allowed-tools, если используются bash-команды
  • Сначала протестируйте на простых входных данных

Конфликт между skill и командой

Если skill и команда имеют одинаковое имя, приоритет отдаётся skill. Удалите одно из них или переименуйте.

Связанные руководства

  • Skills - полный справочник по skills (автоматически вызываемые возможности)
  • Memory - постоянный контекст через CLAUDE.md
  • Subagents - делегирование задач AI-агентам
  • Plugins - готовые наборы команд
  • Hooks - автоматизация на основе событий

Дополнительные материалы


Последнее обновление: 6 сентября 2026 г. Версия Claude Code: 2.1.263 Источники:

Часть серии руководств Claude How To

ЛОКАЛЬНАЯ ОТМЕТКА · БЕЗ ПРОВЕРКИ
СЛЕДУЮЩИЙMemory Guide→