Лучшие практики настройки Claude Code

English | 日本語

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

Примечание: Часть настроек в этом репозитории ориентирована на японских пользователей. Используйте LLM для перевода и адаптации под своё окружение.

Файлы конфигурации из этого репозитория предназначены для размещения в директории ~/.claude/. Разместив их в нужных местах, вы сможете настроить поведение Claude Code и выстроить эффективную среду разработки.

Подход

Современные модели достаточно мощны, чтобы не требовать сложной конфигурации. Избыточная настройка может дать обратный эффект. Этот репозиторий сосредоточен только на нескольких ключевых областях.

• Claude Code располагает богатым набором slash-команд. Освойте их в первую очередь — кастомную конфигурацию добавляйте позже.
  • /resume, /rewind, /fork, /copy: возобновление, восстановление, ветвление и копирование диалогов
  • /review: ревью pull request'ов
  • /simplify: проверка и исправление изменённого кода
  • /copy: копирование содержимого сессии в буфер обмена
  • /add-dir: добавление директорий в область поиска
  • /batch: создание нескольких PR для масштабных изменений с использованием git worktrees
  • /plan: запуск в режиме планирования
• Agent Teams позволяют распределять задачи между несколькими агентами, работающими параллельно. Разделение ролей — проектирование, ревью, реализация, тестирование — даёт возможность эффективно решать масштабные задачи.
• Включайте официальные плагины. LSP-плагины typescript-lsp, pyright-lsp и rust-analyzer-lsp обеспечивают точную навигацию по коду без дополнительных затрат токенов.
• В ряде случаев предпочитайте CLI-инструменты MCP. MCP-серверы потребляют контекст при каждом вызове. CLI-инструменты решают те же задачи при значительно меньшем расходе токенов. Например, замена Playwright MCP на Playwright CLI.

Структура проекта

О папке symlinks

Папка symlinks/ содержит файлы конфигурации различных внешних инструментов, связанных с Claude Code. Поскольку Claude Code часто обновляется и конфигурация регулярно меняется, централизованное хранение всех файлов конфигурации в одной папке значительно упрощает редактирование. Даже если связанные файлы обычно размещаются за пределами директории ~/.claude/, удобно хранить их здесь в виде символических ссылок для единого управления.

В реальных окружениях эти файлы размещаются как символические ссылки в указанных местах.

# Привязка конфигурации Claude Code
ln -s /path/to/settings.json ~/.claude/settings.json

Это позволяет управлять изменениями конфигурации в репозитории и синхронизировать их между несколькими окружениями.

Ключевые возможности

1. Скиллы

Репозиторий предоставляет скиллы для расширения возможностей Claude Code:

Скиллы — вызываемые пользователем команды для типовых задач:

• Завершение dev-процессов
• Токен-эффективная автоматизация браузера через Playwright CLI

2. Интерактивный воркфлоу разработки

Правила, определённые в CLAUDE.md, способствуют интерактивной разработке с Claude Code:

• Соблюдать порядок: исследование → план → согласование → реализация. Код — только после согласования.
• Записывать результаты исследований и планы в виде markdown в .tmp, чтобы пользователь мог их просмотреть и аннотировать
• Использовать AskUserQuestion для поддержки принятия решений пользователем
• Всегда запускать систему управления задачами при появлении задач для чёткой организации деталей

3. Правила эффективной разработки

• Использовать Context7 MCP: всегда обращаться к актуальной информации о библиотеках
• Токен-эффективная автоматизация браузера: использовать Playwright CLI вместо MCP для ~4-кратного снижения расхода токенов
• LSP для анализа кода: точная навигация и анализ кода

4. Командный воркфлоу

Команды агентов формируются по структурированной схеме:

• Lead + Reviewer: агенты Claude Code, отвечающие за проектирование и ревью
• Implementer + Tester: агенты Claude Code для реализации и тестирования

Разделение ответственности обеспечивает качество за счёт независимых ролей ревью и реализации.

Описание файлов

CLAUDE.md

Определяет глобальные пользовательские правила. Содержит следующее:

• Правила верхнего уровня: базовые операционные правила, включая использование MCP, требования к тестированию и командные воркфлоу
• Всегда использовать Context7 MCP для информации о библиотеках
• Использовать LSP для точной навигации и анализа кода
• Проверять функциональность фронтенда с помощью Playwright CLI (playwright-cli через Bash)
• Использовать playwright-cli console и playwright-cli network для логов консоли и сетевых запросов
• Не писать код до согласования. Соблюдать порядок: исследование → план → согласование → реализация
• Записывать результаты исследований и планы в виде markdown в .tmp — никогда не сообщать только устно
• Учитывать все аннотации пользователя к планам и не приступать к реализации до явного указания
• Использовать AskUserQuestion для принятия решений
• Отвечать критически, без лести, но без давления
• Всегда запускать систему управления задачами для задач
• Формирование команды: Lead + Reviewer (агенты Claude Code) и Implementer + Tester (агенты Claude Code)

settings.json

Файл конфигурации, управляющий поведением Claude Code:

Конфигурация переменных окружения (env)

{
  "DISABLE_TELEMETRY": "1",                         // Отключить телеметрию
  "DISABLE_ERROR_REPORTING": "1",                   // Отключить отчёты об ошибках
  "DISABLE_BUG_COMMAND": "1"                        // Отключить команду bug
}