Claude Code: лучшие практики — от вайбкодинга к агентной разработке
Практика делает Claude совершенным. Этот справочник собирает концепции, воркфлоу и советы по Claude Code от создателей инструмента и сообщества: от базовых суб-агентов и команд до продвинутых паттернов оркестрации.
🧠 Концепции
| Фича | Расположение | Описание |
|---|
| Суб-агенты | .claude/agents/<имя>.md | Специализированные агенты (ревьюер, бэкенд, тесты) с собственным контекстом |
| Команды | .claude/commands/<имя>.md | Слэш-команды для повторяющихся воркфлоу: /review, /test, свои |
| Навыки (Skills) | .claude/skills/<имя>/SKILL.md | Прогрессивное раскрытие инструкций: папка навыка с инструкциями и рефами; есть официальные навыки Anthropic |
| Воркфлоу | .claude/commands/... | Общие воркфлоу: план, реализация, ревью |
| Хуки (Hooks) | .claude/hooks/ | Скрипты, запускающиеся до/после действий агента (форматирование, проверки, разрешения) |
| MCP-серверы | .claude/settings.json, .mcp.json | Подключение внешних инструментов через Model Context Protocol |
| Плагины | распространяемые пакеты | Команды, навыки и агенты, упакованные для повторного использования; есть маркетплейсы |
| Настройки | .claude/settings.json | Права, модель, атрибуция, песочница, статус-лайн, хоткеи, авто-режим |
| Статус-лайн | .claude/settings.json | Кастомная строка состояния (контекст, токены, компактизация) |
| Память | CLAUDE.md, .claude/rules/, ~/.claude/rules/, ~/.claude/projects/<проект>/memory/ | Правила проекта, глобальные правила, автопамять сессий |
| Code Review | /code-review | Многоагентное ревью PR, ловит баги, уязвимости и регрессии до мержа |
| CI-действия | .Git/workflows/ | CI-интеграция Claude Code; есть и CI/CD |
| Удалённое управление | /remote-control, /rc | Управление через API/веб; есть headless-режим |
| Deep Links | claude-cli://open?repo=… | Глубокие ссылки для открытия репозиториев |
| Динамические воркфлоу | /workflows, ключевое слово ultracode, /effort ultracode, .claude/workflows/ | Сложные многошаговые воркфлоу (например, Deep Research) |
| Agent Teams (бета) | встроено (env var) | Команды агентов, работающие параллельно (например, через tmux) |
| Agent View (бета) | claude agents, --bg, /bg | Фоновые агенты |
| Кросс-сессионные сообщения | SendMessage, ListAgents, /list-agents | Обмен сообщениями между агентами |
| Запланированные задачи | /loop, /schedule, cron-инструменты | Периодические задачи локально и в облаке |
| Routines (бета) | claude.ai/code/routines, /schedule | Повторяющиеся задачи на десктопе |
| Задачи (Tasks) | /tasks, ~/.claude/tasks/ | Система задач с трекингом |
| Цель (Goal) | /goal <условие>, /goal clear | Условие завершения сессии |
| Голосовой ввод | /voice | Диктовка промптов голосом |
| Встроенные навыки | /code-review, /batch | Навыки, поставляемые из коробки |
| Git Worktrees | --worktree/-w, .worktreeinclude, хуки EnterWorktree/ExitWorktree | Параллельная разработка в изолированных рабочих деревьях |
🔥 Горячие фичи
| Фича | Где | Что делает |
|---|
| Ultrareview (бета) | /code-review ultra, claude ultrareview [цель] | Усиленное многоагентное ревью с трекингом задач |
| Devcontainers | .devcontainer/ | Контейнеризованное окружение разработки |
| Channels (бета) | --channels, через плагины | Каналы вывода/управления |
| No Flicker Mode (бета) | /tui fullscreen, CLAUDE_CODE_NO_FLICKER=1 | Полноэкранный TUI без мерцания |
| Auto Mode | --permission-mode auto, Shift+Tab | Классификатор сам одобряет безопасные команды и спрашивает на рискованных |
| Power-ups | /powerup | Усилители возможностей |
| Fast Mode (бета) | /fast, "fastMode": true | Ускоренный режим |
| Advisor (бета) | /advisor, advisorModel, --advisor | Стратегия советника: вторая модель проверяет решения |
| Computer Use (бета) | MCP-сервер computer-use | Claude управляет компьютером |
| Agent SDK | пакет npm / pip | SDK для построения собственных агентов на Claude |
| Ralph Wiggum Loop | плагин | Самоэволюционирующий цикл для длительных автономных задач |
⚙️ Воркфлоу разработки
Все основные воркфлоу сходятся к одному архитектурному паттерну: Исследование → План → Выполнение → Ревью → Запуск.
Популярные реализации (по убыванию звёзд):
| Название | ★ | Компоненты |
|---|
| Superpowers (Jesse Kriss) | 285k | Агенты + команды + 14 навыков |
| Matt Pocock Skills | 259k | 37 навыков |
| Everything Claude Code | 256k | 68 агентов, 94 команды, 286 навыков |
| Spec Kit (Git) | 135k | 10 команд |
| gstack (Garry Tan) | 132k | 58 навыков |
| agent-skills (Addy Osmani) | 89k | 3 агента, 7 команд, 21 навык |
| OpenSpec | 67.9k | 12 команд, 12 навыков |
| Get Shit Done | 64.6k | 33 агента, 85 команд |
| BMAD-METHOD | 52.9k | 5 агентов |
| oh-my-claudecode | 39.1k | 19 агентов, 37 навыков |
| Compound Engineering | 25k | 1 команда, 35 навыков |
| HumanLayer | 11.5k | 6 агентов, 27 команд |
Примечание: жёлтые теги — под-циклы: шаги, повторяющиеся внутри основного шага (на задачу, на историю, пока не пройдёт проверка).
Другие воркфлоу: RPI, Ralph Wiggum Loop (самоэволюционирующий цикл), воркфлоу Андрея Карпати (сооснователь OpenAI), воркфлоу Питера Штайнбергера (создатель OpenClaw), серии советов Бориса Черни (создатель Claude Code) — 13, 10, 12, 2, 15 и 6 советов; и советы Тарика (Anthropic) — про навыки и управление сессиями.
🔀 Кросс-модельные воркфлоу
Используйте Claude Code вместе с другими моделями — Codex, Gemini, GPT, Kimi, DeepSeek, локальными — тремя способами:
- Плагин — CLI другой модели запускается внутри Claude Code (слэш-команды вроде
/codex:review).
- MCP — Claude Code вызывает другую модель как инструмент через Model Context Protocol.
- Роутер — API-endpoint Claude Code подменяется на другого провайдера.
Проверенный метод: кросс-модельный воркфлоу (Claude Code + Codex) — ручной двух-терминальный поток: план в Claude, QA-ревью в Codex.
| Название | ★ | Тип | Мосты | Что делает |
|---|
| claude-code-router | 34k | Роутер | агрегатор моделей, DeepSeek, Ollama, Gemini, Kimi, Qwen, Groq и др. | Маршрутизирует API Claude Code к любому совместимому провайдеру, выбор модели по задаче |
| CLIProxyAPI | 32k | Роутер | Gemini CLI, Codex, Claude Code, Antigravity | Оборачивает каждый CLI как API-сервис, совместимый с OpenAI/Gemini/Claude/Codex |
| codex-plugin-cc (OpenAI) | 18k | Плагин | Codex / GPT-5 | Официальный плагин OpenAI: /codex:review, /codex:adversarial-review, /codex:rescue внутри Claude Code |
| pal-mcp-server | 12k | MCP | Gemini, OpenAI, Azure, Grok, Ollama, агрегатор моделей (50+ моделей) | Мультимодельный MCP-сервер — вызов других моделей как инструментов Claude |
🧰 Коллекции навыков
Репозитории, известные в первую очередь как курируемые библиотеки файлов SKILL.md (отдельно от полных методологий воркфлоу выше). По убыванию звёзд:
| Название | ★ | Навыков |
|---|
| mattpocock/skills | 259k | 37 |
| anthropics/skills | 176k | 19 |
| Egonex-AI/Understand-Anything | 67k | 8 |
| scientific-agent-skills | 44k | 164 |
| wshobson/agents | 40k | 183 |
| awesome-agent-skills | 34k | 1497+ (курируемый список) |
| impeccable | 27k | 1 (с 7 ссылками на дизайн-домены) |
| agent-skills (Addy Osmani) | 27k | 21 |
| claude-skills | 15k | 246 (в 9 доменах) |
| draw-json-architecture-skill | 3 | 1 |
🤖 Коллекции агентов
Репозитории, известные в первую очередь как курируемые библиотеки определений суб-агентов (.claude/agents/*.md). По убыванию звёзд:
| Название | ★ | Агентов |
|---|
| msitarzewski/agency-agents | 151k | 273 |
| VoltAgent/awesome-claude-code-subagents | 25k | 130+ (курируемый список) |
| ...и другие курируемые подборки суб-агентов под разные роли | | |
💡 Советы и трюки (83 штуки)
Каждый совет взят от команды Claude или из сообщества. Используйте их как источник для реструктуризации вашего CLAUDE.md.
Память: CLAUDE.md + .claude/rules (8)
| Совет |
|---|
CLAUDE.md должен быть меньше 200 строк на файл. 60 строк — ещё надёжнее (и даже это не гарантия на 100%) | Борис, Dex |
Файлы .claude/rules/*.md авто-загружаются в каждую сессию, как CLAUDE.md — добавьте YAML frontmatter с paths: для ленивой загрузки только когда Claude касается файлов по glob |
Оборачивайте доменные правила CLAUDE.md в теги <important if="...">, чтобы Claude не игнорировал их по мере роста файлов |
Используйте несколько CLAUDE.md для монорепозиториев — загрузка предков и потомков |
Используйте .claude/rules/ для разделения больших инструкций |
| Любой разработчик должен уметь запустить Claude, сказать «прогони тесты» — и оно заработает с первого раза; если нет — в вашем CLAUDE.md не хватает ключевых команд установки/сборки/тестов |
| Держите кодовую базу чистой и заканчивайте миграции — частично мигрированные фреймворки сбивают модели, которые могут выбрать неправильный паттерн |
Используйте settings.json для поведения, навязываемого обвязкой (атрибуция, права, модель) — не пишите «НИКОГДА не добавляй Co-Authored-By» в CLAUDE.md, когда attribution.commit: "" детерминированно решает это |
Агенты (4)
| Совет |
|---|
| Делайте специфичные для фич суб-агентов (дополнительный контекст) с навыками (прогрессивное раскрытие) вместо общих «QA-инженер», «бэкенд-инженер» |
| Говорите «используй суб-агентов», чтобы добавить мощности задаче — выгружайте задачи, держа главный контекст чистым и сфокусированным |
| Команды агентов с tmux и git worktrees — для параллельной разработки |
| Используйте test-time compute: раздельные контекстные окна дают лучшие результаты — один агент может внести баги, а другой (та же модель) их найти |
Команды (3)
| Совет |
|---|
| Используйте команды для ваших воркфлоу вместо суб-агентов |
Используйте слэш-команды для каждого «внутреннего цикла», который вы делаете много раз в день — экономит повторное промптирование; команды лежат в .claude/commands/ и коммитятся в git |
Если вы делаете что-то чаще раза в день — превратите это в навык или команду: соберите /techdebt, context-dump или analytics-команды |
Навыки (9)
| Совет |
|---|
Используйте context: fork, чтобы запустить навык в изолированном суб-агенте — главный контекст видит только итоговый результат, а не промежуточные вызовы инструментов. Поле agent позволяет задать тип суб-агента |
| Используйте навыки в подпапках для монорепозиториев |
| Навыки — это папки, а не файлы: используйте подкаталоги references/, scripts/, examples/ для прогрессивного раскрытия |
| Стройте в каждом навыке секцию Gotchas — самые важные фишки и точки отказа Claude, накапливаемые со временем |
| Поле description навыка — это триггер, а не резюме: пишите его для модели («когда мне его запустить?») |
| Не пишите очевидное в навыках — фокусируйтесь на том, что выталкивает Claude из его поведения по умолчанию |
| Не «рельсуйте» Claude в навыках — давайте цели и ограничения, а не предписывающие пошаговые инструкции |
| Включайте скрипты и библиотеки в навыки, чтобы Claude компоновал, а не реконструировал шаблонный код |
Встраивайте !command в SKILL.md, чтобы инжектить динамический вывод shell в промпт — Claude запускает его при вызове, а модель видит только результат |
Хуки (5)
| Совет |
|---|
Используйте хуки по требованию в навыках: /careful блокирует разрушительные команды, /freeze блокирует правки вне директории |
| Замеряйте использование навыков PreToolUse-хуком, чтобы найти популярные или недоиспользуемые навыки |
| Используйте PostToolUse-хук для авто-форматирования кода — Claude генерирует хорошо отформатированный код, хук добирает последние 10%, чтобы избежать падений CI |
| Маршрутизируйте запросы разрешений к Opus через хук — пусть он сканирует на атаки и сам одобряет безопасные |
| Используйте Stop-хук, чтобы подталкивать Claude продолжать или проверять свою работу в конце хода |
Воркфлоу (5)
| Совет |
|---|
Используйте /model для выбора модели и рассуждений, /context для просмотра использования контекста, /usage для проверки лимитов плана, /extra-usage для настройки свыше лимита, /config для настроек — используйте Opus для режима плана и Sonnet для кода, чтобы получить лучшее от обоих |
Всегда включайте thinking mode (чтобы видеть рассуждения) и Output Style Explanatory (чтобы видеть детальный вывод с блоками «Insight») в /config для лучшего понимания решений Claude |
Используйте ключевое слово ultrathink в промптах для рассуждений с высоким усилием |
Режим /focus скрывает всю промежуточную работу и показывает только итог — доверьтесь модели и смотрите на результат |
| Настраивайте уровень усилий с адаптивным мышлением Opus: low — скорость и меньше токенов, max — максимум интеллекта |
Продвинутые воркфлоу (9)
| Совет |
|---|
| Часто рисуйте ASCII-диаграммы, чтобы понимать свою архитектуру |
Используйте /loop для локального периодического мониторинга (до 7 дней) · используйте /schedule для облачных периодических задач, работающих даже когда машина выключена |
| Используйте плагин Ralph Wiggum для длительных автономных задач |
| Используйте auto mode вместо dangerously-skip-permissions — классификатор на основе модели решает, безопасна ли команда, и сам одобряет; при риске — пауза и вопрос. Shift+Tab переключает режимы Ask → Plan → Auto |
| Используйте навык /less-permission-prompts: сканирует историю сессии на безопасные bash/MCP-команды, которые постоянно спрашивают разрешение, и даёт рекомендуемый allowlist для настроек |
Соберите навык /go, который (1) тестирует end-to-end через bash/браузер/computer use, (2) запускает /simplify, (3) открывает PR — чтобы, вернувшись, вы знали, что код работает |
Git / PR (5)
| Совет |
|---|
| Держите PR маленькими и сфокусированными — медиана 118 строк, одна фича на PR, проще ревьюить и откатывать |
| Всегда делайте squash merge — чистая линейная история, один коммит на фичу, лёгкие git revert и git bisect |
| Коммитьте часто — хотя бы раз в час, как только задача завершена |
Тегайте @claude в PR коллеги, чтобы авто-генерировать lint-правила из повторяющегося ревью-фидбека |
Используйте /code-review для многоагентного анализа PR — ловит баги, уязвимости и регрессии до мержа |
Отладка (6)
| Совет |
|---|
| Возьмите привычку делать скриншоты и делиться с Claude, когда застряли на любой проблеме |
| Используйте MCP (Claude in Chrome, Playwright, Chrome DevTools), чтобы Claude сам видел консольные логи Chrome |
| Всегда просите Claude запускать нужный терминал в фоне для лучшей отладки |
/doctor — диагностика установки, авторизации и конфигурации |
| Используйте кросс-модельный воркфлоу для QA — например, Codex для ревью плана и реализации |
| Агентский поиск (glob + grep) лучше RAG — Claude Code пробовал и отбросил векторные базы: код расходится с синхронизацией, а права сложны |
Утилиты (5)
| Совет |
|---|
| Терминалы iTerm/Ghostty/tmux вместо IDE (VS Code/Cursor) |
/voice или голосовая диктовка для промптов (10x продуктивности) |
| Claude Code Hooks — пакет хуков для фидбека от Claude |
| Статус-лайн — осведомлённость о контексте и быстрая компактизация | Борис + сообщество |
| Изучите функции settings.json: Plans Directory, Spinner Verbs и другие для персонализации |
Ежедневные (2)
| Совет |
|---|
| Обновляйте Claude Code ежедневно |
| Начинайте день с чтения changelog |
📚 Как пользоваться этим справочником
Получите максимум, следуя этим шагам:
- Читайте этот справочник как курс, а не как воркфлоу или навык. Сначала это справочный материал; запускать будете позже.
- Не используйте Claude как чат-бота. Изучите примитивы — агенты, команды, навыки, хуки — и собирайте из них свой воркфлоу.
- Запустите
/weather-orchestrator, чтобы увидеть полный поток команда → агент → навык. Используйте его как шаблон для любого воркфлоу разработки — от планирования до запуска.
- Слушайте кастомные звуки хуков во время работы. Их реализация живёт в отдельном репозитории Claude Code Hooks; другие паттерны (например, Agent Teams) поставляются в директории implementation/ этого репозитория.
- Изучите продвинутые темы и их реализации из под-таблицы «Горячие фичи» — например, Ralph Wiggum Loop — это полноценный рабочий репозиторий, который можно склонировать и увидеть паттерн от начала до конца.
- Укажите Claude на секцию «Советы и трюки» в вашем проекте и попросите предложить правки — особенно как реструктурировать ваш
CLAUDE.md. Каждый совет sourced от команды Claude или сообщества.
- Читайте официальную документацию и changelog Claude Code, чтобы быть в курсе новинок.
📄 Отчёты (REPORTS)
В репозитории есть углублённые отчёты:
- Agent SDK против системных промптов CLI
- Claude in Chrome против Chrome DevTools MCP
- Глобальные и проектные настройки (система задач)
- Навыки для больших монорепозиториев
- Память агента: глубокое погружение
- Продвинутое использование инструментов
- Использование и лимиты (usage и rate limits)
- Паттерн агент-команда-навык
- Деградация LLM день ото дня
- Почему важна обвязка (harness)
- Spinner Verbs и советы (извлечены из бинарника CLI)
- Агентная инженерия: вопросы про спецификации и код
⭐ Другие репозитории
- Claude Code Hooks — пакет хуков для фидбека
- Codex CLI Best Practice и Codex CLI Hooks
- Gemini CLI Best Practice и Gemini CLI Hooks
🔄 Как этот репозиторий обновляется сам
Весь репозиторий поддерживается воркфлоу самого Claude Code (паттерн команда → агент → навык):
| # | Воркфлоу | Что делает |
|---|
| 1 | /workflows:development-workflows | Обновляет таблицу воркфлоу разработки, исследуя все 10 репозиториев воркфлоу параллельно |
| 2 | /workflows:skill-collections | Обновляет таблицу коллекций навыков |
| 3 | /workflows:agent-collections | Обновляет таблицу коллекций агентов |
| 4 | /workflows:best-practice:workflow-concepts | Обновляет секцию концепций новыми фичами Claude Code |
| 5 | /workflows:best-practice:workflow-claude-settings | Отслеживает изменения в отчёте по настройкам |
| 6 | /workflows:best-practice:workflow-claude-subagents | Отслеживает изменения в отчёте по суб-агентам |
| 7 | /workflows:best-practice:workflow-claude-commands | Отслеживает изменения в отчёте по командам |
| 8 | /workflows:best-practice:workflow-claude-skills | Отслеживает изменения в отчёте по навыкам |
🎓 Дополнительно
- Claude for OSS — бесплатный доступ для open source-проектов
- Claude Community Ambassador — программа амбассадоров
- Claude Certified Architect — сертификация архитектора
- Anthropic Academy — академия обучения
⚖️ Лицензия
Материал репозитория распространяется на условиях MIT. Данный перевод — учебная статья сайта E-VibeCoding.