claude-toolbox

claude-toolbox — коллекция инструментов для всех ваших рабочих процессов с Claude Code: преднастроенные MCP-серверы, скиллы, суб-агенты, команды, хуки, строки статуса с темами и многое другое. Всё необходимое для AI-разработки, ежедневно используемое и проверенное на реальных проектах.

[!IMPORTANT] Этот проект создан с помощью Claude Code. Тем не менее он проверяется, тестируется и дорабатывается с участием человека.

Никакого AI-мусора. Скиллы, написанные чистым AI без доработки, — это хлам, и это ещё мягко сказано.

Тем не менее, если у вас возникнут проблемы с кодом, написанным AI — вы предупреждены. Но, с другой стороны, зачем вам вообще интересоваться AI-конфигами и скиллами... ¯\_(ツ)_/¯

Зачем claude-toolbox?

Claude Code сам по себе мощный инструмент, но он не знает вашего рабочего процесса. Этот проект начинался как способ унифицировать конфигурации Claude Code во всех моих проектах без необходимости копировать настройки вручную. Со временем паттерны и повторяющиеся промпты превратились в скиллы и агентов. Сейчас claude-toolbox предоставляет две вещи:

Минималистичная, опinionated конфигурация Claude Code — разумные базовые разрешения, расширенная строка статуса, интеграция Serena LSP, подключение MCP-серверов и инфраструктура синхронизации для поддержания актуальности во всех проектах. Считайте это dotfiles-репозиторием для Claude Code.

Структурированный пайплайн разработки — 10 workflow-скиллов, которые проведут вас от идеи через проектирование, реализацию, ревью кода, тестирование — до документации, с сохранением знаний между сессиями.

Из коробки вы получаете:

• 10 workflow-скиллов — полный пайплайн разработки, вызываемый как /skill-name
• Мультиязычная поддержка — точные и раздельные инструкции от реализации до тестирования и ревью для: go, java, js/ts, kotlin, python
• Мультимодельное ревью кода — независимые ревьюеры через суб-агентов и внешние модели (Gemini и др.)
• Семантический анализ кода — навигация по символам и отслеживание ссылок через LSP с помощью Serena
• Персистентная база знаний — результаты, решения и соглашения, сохраняющиеся между сессиями через Capy
• Актуальная документация библиотек — всегда свежий поиск документации через Context7
• Проверенная конфигурация — разрешения, темы строки статуса, хуки, разумные значения по умолчанию

Выберите свой путь

Начинаете новый проект? Используйте шаблон — вы получите полную конфигурацию и плагин, уже подключённые, плюс инфраструктуру синхронизации для получения будущих обновлений. → Настройка по шаблону

Существующий проект, нужна полная настройка? Подключите конфигурацию, плагин и инфраструктуру синхронизации без создания из шаблона. → Подключение к существующим репозиториям

Нужны только скиллы? Установите плагин kk — все 10 скиллов, команды и хуки одной командой. Шаблон не нужен. → Установка только плагина

Требования

• Claude Code — AI-ассистент для разработки, который расширяет этот набор инструментов
• npm — используется при установке некоторых MCP-серверов
• uv — запускатель Python-пакетов для MCP-серверов Serena и Pal
• jq — обработчик JSON, необходим для template-cleanup

API-ключи

• API-ключ Context7 — для поиска документации библиотек
• API-ключ Gemini для Pal (или любого другого провайдера) — для мультимодельного ревью кода

Настройка MCP-серверов

[!NOTE] MCP-серверы должны быть настроены в ~/.claude.json (не в репозитории), чтобы API-ключи оставались в безопасности. Эти конфигурации достаточно универсальны для повторного использования во всех ваших проектах.

Не обязательно настраивать все серверы сразу. Добавляйте их постепенно:

1. Serena (API-ключ не нужен) — семантический анализ кода через LSP. Работает сразу после настройки.
2. Context7 (нужен API-ключ) — актуальная документация библиотек и примеры кода.
3. Pal (нужен API-ключ) — мультимодельная AI-интеграция для ревью кода, отладки, планирования и аудита безопасности.
4. Capy (опционально, автоматически настраивается при bootstrap) — персистентная база знаний между сессиями. Установка: brew install serpro69/tap/capy.

{
  "context7": {
    "type": "http",
    "url": "https://mcp.context7.com/mcp",
    "headers": {
      "CONTEXT7_API_KEY": "YOUR_CONTEXT7_API_KEY"
    }
  },
  "serena": {
    "type": "stdio",
    "command": "uvx",
    "args": [
      "--from",
      "git+https://github.com/oraios/serena",
      "serena",
      "start-mcp-server",
      "--context",
      "ide-assistant",
      "--project",
      "."
    ],
    "env": {}
  },
  "pal": {
    "command": "sh",
    "args": [
      "-c",
      "$HOME/.local/bin/uvx --from git+https://github.com/serpro69/pal-mcp-server.git pal-mcp-server"
    ],
    "env": {
      "PATH": "/usr/local/bin:/usr/bin:/bin:$HOME/.local/bin",
      "DEFAULT_MODEL": "auto",
      "DEFAULT_THINKING_MODE_THINKDEEP": "high",
      "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY",
      "GOOGLE_ALLOWED_MODELS": "gemini-3.1-pro-preview,gemini-2.5-flash"
    }
  }
}

[!TIP] Полную документацию по настройке и дополнительным опциям смотрите в репозитории: https://github.com/serpro69/claude-toolbox