GitHub - shanraisshan/claude-code-best-practice: practice made claude perfect

📖 Источник: github.com

Claude Code: лучшие практики

Введение

Репозиторий «Practice Makes Claude Perfect» — это исчерпывающая база знаний по эффективному использованию Claude Code, созданная на основе советов от команды Anthropic, опытных разработчиков и активного сообщества. Основной тезис: Claude Code — это не просто CLI-инструмент, а полноценная платформа для agentic-разработки, где ключ к продуктивности лежит в правильной организации workflows, agents, skills и hooks.

Архитектура Claude Code: ключевые компоненты

Subagents, Commands и Skills — три уровня абстракции

Claude Code предлагает три механизма расширения функциональности с разным уровнем сложности:

Commands (.claude/commands/ .md) — простые шаблоны промптов, вызываемые через /slash-команды. Используются для повторяющихся workflow. Борис Черны рекомендует создавать команды для каждого «внутреннего цикла», который вы выполняете много раз в день.
Skills (.claude/skills/ /SKILL.md) — более мощный механизм с поддержкой контекстного форкинга, progressive disclosure и предзагрузки. Располагаются в подпапках для монорепозиториев.
Subagents (.claude/agents/ .md) — автономные агенты в изолированном контексте с собственными инструментами, разрешениями, моделью и памятью. Один агент может внедрять баги, а другой (та же модель) — их находить (test time compute).

Хуки, MCP и настройки

Hooks (.claude/hooks/) — пользовательские обработчики (скрипты, HTTP, промпты, агенты), выполняемые вне агентного цикла при определённых событиях. Примеры: auto-format кода через PostToolUse hook, auto-approve безопасных операций через permission requests.
MCP Servers (.mcp.json) — подключение к Model Context Protocol для внешних инструментов, баз данных и API.
Settings (.claude/settings.json) — иерархическая система конфигурации: permissions, model config, output styles, sandboxing, keybindings, fast mode.

Продвинутые возможности для масштабирования

Agent Teams и параллельная разработка

Agent Teams (beta) позволяют нескольким агентам работать параллельно над одной кодовой базой с общей координацией задач. В сочетании с Git Worktrees каждый агент получает изолированную копию ветки.

Техники от Бориса Черны:

Использовать tmux + agent teams для параллельной разработки
Squash-merge PRs для линейной истории git
Запускать несколько инстансов Claude Code одновременно с /rename для маркировки сессий

Scheduled Tasks и Remote Control

/loop — локальный повторяющийся мониторинг (до 3 дней)
/schedule — облачные задачи на инфраструктуре Anthropic (работают при выключенной машине)
/remote-control — продолжение локальных сессий с любого устройства (телефон, планшет, браузер)
Ralph Wiggum Loop — автономный цикл разработки для длительных задач

Интеграции и каналы

Chrome (beta, --chrome) — автоматизация браузера через Claude для тестирования веб-приложений, отладки консоли, заполнения форм
Slack — @Claude в Slack для интеграции в рабочие чаты
GitHub Actions / GitLab CI/CD — автоматизация в рамках CI/CD пайплайнов
Code Review (beta) — мультиагентный анализ PR на баги, уязвимости и регрессии
Voice Dictation (beta, /voice) — голосовой ввод промптов с поддержкой 20 языков

Память и персистентность контекста

CLAUDE.md и Rules

CLAUDE.md — основной файл с инструкциями для проекта
.claude/rules/ — правила, загружаемые в контекст
~/.claude/projects/ /memory/ — персистентная память между сессиями
@path imports — подключение внешних файлов в контекст

Проблемы и решения:

С ростом файлов Claude может игнорировать инструкции — используйте !command`` в SKILL.md для инъекции динамического shell-вывода
Для монорепозиториев: множественные CLAUDE.md (предок + потомок) с прогрессивной загрузкой
Не полагайтесь на memory.md или constitution.md — они не гарантируют выполнения правил
Лучше использовать settings.json для принудительного поведения (например, attribution.commit: "")

Checkpointing

Esc Esc или /rewind — откат к предыдущему состоянию вместо попытки исправить ошибки в том же контексте
/compact — сжатие контекста для оптимизации использования токенов

Рабочие процессы и лучшие практики

Универсальный паттерн: Research → Plan → Execute → Review → Ship

Все major workflows сходятся к единому архитектурному паттерну. Пример: /weather-orchestrator демонстрирует Command → Agent → Skill цепочку.

Модели и режимы работы

Opus для планирования и анализа, Sonnet для кода
/model — выбор модели (до 1M токенов)
/context — просмотр использования контекста
/usage — проверка лимитов плана
thinking mode: true и Output Style: Explanatory для понимания решений Claude
High effort reasoning для сложных задач

Permissions и Sandboxing

/permissions с wildcard-синтаксисом (например, Bash(npm run *)) вместо --dangerously-skip-permissions
/sandbox — изоляция файлов и сети, снижает количество permission-запросов на 84% (по внутренним данным Anthropic)
Auto Mode (beta, --permission-mode auto) — Claude сам решает, что безопасно, блокируя prompt injection и risky escalations

Сообщество и ресурсы

Авторы и эксперты

Ключевые контрибьюторы советов:

Борис Черны (Boris Cherny) — создатель Claude Code, 37+ советов
Thariq — 6 советов по skills и hooks
Cat Wu — 3 совета по конфигурации и моделированию
Lydia Hallie — 2 совета по skills для монорепозиториев

Репозитории-компаньоны

Superpowers — TDD-first подход, Iron Laws, whole-plan review
Spec Kit — spec-driven development, constitution, 22+ инструментов
Get Shit Done (GSD) — fresh 200K contexts, wave execution, XML plans
HumanLayer — RPI, context engineering, 300k+ LOC опыт
Compound Engineering — Multi-Platform CLI, Plugin Marketplace

Заключение: следующие шаги и открытые вопросы

Практические рекомендации для старта

Изучите repo как курс — разберитесь, что такое commands, agents, skills и hooks, прежде чем использовать
Клонируйте репозиторий и экспериментируйте: /weather-orchestrator, прослушайте hook sounds, запустите agent teams
Возьмите свой проект и попросите Claude предложить best practices из этого репозитория

Открытые вопросы для исследования

Memory: как часто обновлять CLAUDE.md и как понять, что он устарел?
Agents vs Skills vs Commands: чёткие критерии выбора для конкретных сценариев
Specs: стоит ли каждый feature описывать markdown-файлом и как поддерживать актуальность?
Agent Personas: влияет ли детальный persona на качество результата?

Перспективы

Репозиторий активно развивается (Trending on GitHub в марте 2026), отслеживая эволюцию Claude Code и появление новых возможностей: Agent Teams, Chrome integration, Code Review. Ключевой тренд — context engineering и agentic engineering как отдельные инженерные дисциплины.

📢 Информация предоставлена телеграм-каналом: Data&AI Insights

🤖 Data&AI Insights - Ваш источник инсайтов о данных и ИИ