Руководство по установке: Магазин плагинов vs Ручная установка
Что вы сможете делать после изучения
После завершения этого урока вы сможете:
- Устанавливать Everything Claude Code в один клик через магазин плагинов
- Вручную выбирать необходимые компоненты для точной настройки
- Правильно настраивать MCP-серверы и хуки
- Проверять успешность установки
Ваша текущая ситуация
Вы хотите быстро начать работу с Everything Claude Code, но не знаете:
- Стоит ли использовать установку в один клик из магазина плагинов или вручную контролировать каждый компонент?
- Как избежать ошибок конфигурации, из-за которых функции не будут работать?
- Какие файлы и куда копировать при ручной установке?
Когда использовать каждый способ
| Сценарий | Рекомендуемый способ | Причина |
|---|---|---|
| Первое использование | Установка из магазина | Проще всего, готово за 5 минут |
| Хотите попробовать определенную функцию | Установка из магазина | Полный опыт, прежде чем решать |
| Есть конкретные требования | Ручная установка | Точный контроль каждого компонента |
| Уже есть собственная конфигурация | Ручная установка | Избежать перезаписи существующих настроек |
Основная идея
Everything Claude Code предоставляет два способа установки:
Установка из магазина плагинов (рекомендуется)
- Подходит для большинства пользователей
- Автоматическая обработка всех зависимостей
- Установка одной командой
Ручная установка
- Подходит для пользователей с конкретными требованиями
- Точный контроль устанавливаемых компонентов
- Требуется ручная настройка
Независимо от выбранного способа, в итоге файлы конфигурации копируются в директорию ~/.claude/, чтобы Claude Code мог распознавать и использовать эти компоненты.
🎒 Подготовка к началу
Предварительные требования
Перед началом убедитесь:
- [ ] Установлен Claude Code
- [ ] Есть сетевое подключение к GitHub
- [ ] Знакомы с базовыми командами командной строки (если выбираете ручную установку)
Действуем
Способ 1: Установка из магазина плагинов (рекомендуется)
Это самый простой способ, подходящий для первого использования или тех, кто хочет быстро попробовать.
Шаг 1: Добавление магазина плагинов
Зачем Нужно зарегистрировать GitHub-репозиторий как магазин плагинов Claude Code, чтобы можно было устанавливать плагины оттуда.
Введите в Claude Code:
/plugin marketplace add affaan-m/everything-claude-codeВы должны увидеть:
Successfully added marketplace affaan-m/everything-claude-codeШаг 2: Установка плагина
Зачем Установить плагин Everything Claude Code из только что добавленного магазина.
Введите в Claude Code:
/plugin install everything-claude-code@everything-claude-codeВы должны увидеть:
Successfully installed everything-claude-code@everything-claude-codeПроверочная точка ✅
Проверьте, что плагин установлен:
/plugin listВ выводе должно присутствовать everything-claude-code@everything-claude-code.
Шаг 3 (опционально): Прямая настройка settings.json
Зачем Если хотите пропустить командную строку и сразу изменить файл конфигурации.
Откройте ~/.claude/settings.json и добавьте:
{
"extraKnownMarketplaces": {
"everything-claude-code": {
"source": {
"source": "github",
"repo": "affaan-m/everything-claude-code"
}
}
},
"enabledPlugins": {
"everything-claude-code@everything-claude-code": true
}
}Вы должны увидеть:
- После обновления конфигурационного файла Claude Code автоматически загрузит плагин
- Все агенты, навыки, команды и хуки сразу станут доступны
Способ 2: Ручная установка
Подходит для пользователей, которые хотят точно контролировать, какие компоненты устанавливать.
Шаг 1: Клонирование репозитория
Зачем Получить все исходные файлы Everything Claude Code.
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-codeВы должны увидеть:
Cloning into 'everything-claude-code'...
remote: Enumerating objects...Шаг 2: Копирование агентов
Зачем Скопировать специализированные субагенты в директорию агентов Claude Code.
cp everything-claude-code/agents/*.md ~/.claude/agents/Вы должны увидеть:
- В директории
~/.claude/agents/появилось 9 новых файлов агентов
Проверочная точка ✅
Проверьте, что агенты скопированы:
ls ~/.claude/agents/Вы должны увидеть примерно:
planner.md architect.md tdd-guide.md code-reviewer.md ...Шаг 3: Копирование правил
Зачем Скопировать обязательные правила в директорию правил Claude Code.
cp everything-claude-code/rules/*.md ~/.claude/rules/Вы должны увидеть:
- В директории
~/.claude/rules/появилось 8 новых файлов правил
Шаг 4: Копирование команд
Зачем Скопировать slash-команды в директорию команд Claude Code.
cp everything-claude-code/commands/*.md ~/.claude/commands/Вы должны увидеть:
- В директории
~/.claude/commands/появилось 14 новых файлов команд
Шаг 5: Копирование навыков
Зачем Скопировать определения рабочих процессов и предметные знания в директорию навыков Claude Code.
cp -r everything-claude-code/skills/* ~/.claude/skills/Вы должны увидеть:
- В директории
~/.claude/skills/появилось 11 новых директорий навыков
Шаг 6: Настройка хуков
Зачем Добавить конфигурацию автоматических хуков в settings.json Claude Code.
Скопируйте содержимое hooks/hooks.json в ваш ~/.claude/settings.json:
cat everything-claude-code/hooks/hooks.jsonДобавьте вывод в ~/.claude/settings.json в следующем формате:
{
"hooks": [
{
"matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.(ts|tsx|js|jsx)$\"",
"hooks": [
{
"type": "command",
"command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
}
]
}
]
}Вы должны увидеть:
- При редактировании TypeScript/JavaScript файлов с
console.logпоявится предупреждение
Важное напоминание
Убедитесь, что массив hooks не перезапишет существующие конфигурации в ~/.claude/settings.json. Если есть существующие хуки, их нужно объединить.
Шаг 7: Настройка MCP-серверов
Зачем Расширить возможности интеграции Claude Code с внешними сервисами.
Выберите нужные MCP-серверы из mcp-configs/mcp-servers.json и добавьте в ~/.claude.json:
cat everything-claude-code/mcp-configs/mcp-servers.jsonСкопируйте нужную конфигурацию в ~/.claude.json, например:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "YOUR_GITHUB_TOKEN_HERE"
}
}
}
}Важно: замените плейсхолдеры
Необходимо заменить плейсхолдеры YOUR_*_HERE на реальные API-ключи, иначе MCP-серверы не будут работать.
Рекомендации по MCP
Не включайте все MCP! Слишком много MCP займет большую часть контекстного окна.
- Рекомендуется настраивать 20-30 MCP-серверов
- Держите менее 10 включенных для каждого проекта
- Сохраняйте менее 80 активных инструментов
Используйте disabledMcpServers для отключения ненужных MCP в конфигурации проекта:
{
"disabledMcpServers": ["firecrawl", "supabase"]
}Контрольная точка ✅
Проверка установки из магазина плагинов
/plugin listВы должны увидеть, что everything-claude-code@everything-claude-code включен.
Проверка ручной установки
# Проверка агентов
ls ~/.claude/agents/ | head -5
# Проверка правил
ls ~/.claude/rules/ | head -5
# Проверка команд
ls ~/.claude/commands/ | head -5
# Проверка навыков
ls ~/.claude/skills/ | head -5Вы должны увидеть:
- В директории агентов:
planner.md,tdd-guide.mdи т.д. - В директории правил:
security.md,coding-style.mdи т.д. - В директории команд:
tdd.md,plan.mdи т.д. - В директории навыков:
coding-standards,backend-patternsи т.д.
Проверка работоспособности
Введите в Claude Code:
/tddВы должны увидеть, что агент TDD Guide начал работу.
Частые проблемы
Ошибка 1: Плагин установлен, но не работает
Симптомы: После установки плагина команды недоступны.
Причина: Плагин не загружен корректно.
Решение:
# Проверьте список плагинов
/plugin list
# Если не включен, включите вручную
/plugin enable everything-claude-code@everything-claude-codeОшибка 2: MCP-сервер не подключается
Симптомы: Функции MCP не работают, ошибка подключения.
Причина: API-ключ не заменен или неверный формат.
Решение:
- Проверьте, что все плейсхолдеры
YOUR_*_HEREв~/.claude.jsonзаменены на реальные ключи - Проверьте валидность API-ключей
- Убедитесь, что путь к команде MCP-сервера корректен
Ошибка 3: Хуки не срабатывают
Симптомы: При редактировании файлов нет подсказок от хуков.
Причина: Неверный формат конфигурации хуков в ~/.claude/settings.json.
Решение:
- Проверьте правильность формата массива
hooks - Убедитесь, что синтаксис выражения
matcherкорректен - Проверьте, что путь к команде хука исполняем
Ошибка 4: Проблемы с правами доступа (ручная установка)
Симптомы: При копировании файлов ошибка "Permission denied".
Причина: Недостаточные права на директорию ~/.claude/.
Решение:
# Убедитесь, что директория .claude существует и доступна
mkdir -p ~/.claude/{agents,rules,commands,skills}
# Используйте sudo (только при необходимости)
sudo cp -r everything-claude-code/agents/*.md ~/.claude/agents/Резюме урока
Сравнение двух способов установки:
| Характеристика | Установка из магазина | Ручная установка |
|---|---|---|
| Скорость | ⚡ Быстро | 🐌 Медленно |
| Сложность | 🟢 Просто | 🟡 Средне |
| Гибкость | 🔒 Фиксировано | 🔓 Настраиваемо |
| Рекомендуется для | Начинающих, быстрый старт | Опытных пользователей, особые требования |
Ключевые моменты:
- Установка из магазина — самый простой способ, одна команда
- Ручная установка подходит для пользователей, которым нужен точный контроль компонентов
- При настройке MCP не забудьте заменить плейсхолдеры, не включайте слишком много
- При проверке установки проверяйте структуру директорий и доступность команд
Анонс следующего урока
В следующем уроке мы изучим Настройка менеджера пакетов: автоматическое обнаружение и настройка.
Вы узнаете:
- Как Everything Claude Code автоматически определяет менеджер пакетов
- Механизм работы приоритета из 6 источников
- Как настраивать менеджер пакетов на уровне проекта и пользователя
- Использование команды
/setup-pmдля быстрой настройки
Приложение: Ссылки на исходный код
Нажмите, чтобы развернуть ссылки на исходный код
Последнее обновление: 2026-01-25
| Функция | Путь к файлу | Строки |
|---|---|---|
| Метаданные плагина | source/affaan-m/everything-claude-code/.claude-plugin/plugin.json | 1-28 |
| Манифест магазина | source/affaan-m/everything-claude-code/.claude-plugin/marketplace.json | 1-45 |
| Руководство по установке | source/affaan-m/everything-claude-code/README.md | 175-242 |
| Конфигурация хуков | source/affaan-m/everything-claude-code/hooks/hooks.json | 1-146 |
| Конфигурация MCP | source/affaan-m/everything-claude-code/mcp-configs/mcp-servers.json | 1-95 |
Ключевая конфигурация:
- Название плагина:
everything-claude-code - Репозиторий:
affaan-m/everything-claude-code - Лицензия: MIT
- Поддерживает 9 агентов, 14 команд, 8 наборов правил, 11 навыков
Способы установки:
- Установка из магазина:
/plugin marketplace add+/plugin install - Ручная установка: копирование агентов, правил, команд, навыков в
~/.claude/