Claude Code Pro Course MCP Server

Claude Code PRO — курс и гайд

Практический курс по работе с Claude Code на русском: от первого запуска до профессиональной настройки команды. CLAUDE.md, settings, skills, subagents, hooks, MCP, плагины, headless-режим и CI — с лабораторными работами и готовыми шаблонами, которые можно скопировать в свой проект. 🧠 Machine learning — здесь можно найти полный список самых крутых ИИ курсво, чтобы стать гуру ИИ и множество полезных инструментов и уроками работы с ними, абсолютных мастхев!

---

Содержание

Старт	Как это работает	Практика	Справочник
Быстрый старт	Агентный цикл	Продвинутые приёмы	Безопасность
Маршрут обучения	Конфигурация	Рецепты задач	Шаблоны
Программа	Принципы	Антипаттерны	Экономия · Проблемы

Что внутри

📚 12 модулей	Теория с примерами: от установки до мульти-агентной работы
🧪 8 лабораторных	Задания с критериями «готово» — закрепить на практике
🧰 Starter kit	8 skills, 5 субагентов, 4 hooks, правила, statusline, output style — ставится одной командой
💬 Библиотека промптов	Проверенные формулировки для 13 типов задач
🧩 Пример плагина	Как упаковать настройки и раздать команде
⚙️ GitHub Actions	@claude в issues/PR и авто-ревью
📋 Шпаргалка · FAQ	Всё важное на одной странице и решения типичных проблем

Полезные ресурсы

• 🧠 Machine learning — ИИ-инструменты для генерации Python кода, умные-агенты и все что нужно знать из области AI.
• 🖥 Pythonl— с помощью понятных картинок и коротких видео авторы объясняют сложные концепции и учат профессиональному подходу в разработке.
• 🖥 Python Интервью — огромное количество разобранных вопросов с реальных собеседований Python разработчика.
• 📖 PythonBooks (2) — мы создали канал с книгами по Linux и залили туда наверное самую большую подборку книг.
• 💼 Python Jobs — вакансии и подработка для Python разработчиков.
• 🔝 А здесь мы собрали целый кладезь полезных Python ресурсов для прокачки.
• 🔥 Больше крутых курсов и полезных ИИ-инструментов — регулярно публикую здесь.
• 📦 Harness_ru — полный курс по Harness 2026 на русском языке: всё, что нужно знать, в одном месте.

Для кого

• Разработчики, которые уже пробовали Claude Code и хотят выжать из него максимум.
• Тимлиды, которым нужно настроить единые правила для команды.
• Все, кто хочет автоматизировать рутину: ревью, тесты, коммиты, CI.

Быстрый старт за 5 минут

# 1. Установите Claude Code
curl -fsSL https://claude.ai/install.sh | bash     # macOS / Linux / WSL
# или: npm install -g @anthropic-ai/claude-code

# 2. Поставьте starter-kit в свой проект
git clone https://github.com/justxor/claude-code-pro-course.git
bash claude-code-pro-course/install.sh ~/path/to/my-project

# 3. Запустите
cd ~/path/to/my-project && claude
> /context          # что загружено
> /onboard          # skill из starter-kit: обзор проекта

Маршрут обучения

flowchart LR
    subgraph B["🟢 Основы"]
        M0["00 Установка"] --> M1["01 Промптинг"] --> M2["02 CLAUDE.md"] --> M3["03 Настройки"]
    end
    subgraph W["🟡 Рабочий процесс"]
        M4["04 Workflow профи"]
    end
    subgraph E["🟠 Расширение"]
        M5["05 Skills"] --> M6["06 Subagents"] --> M7["07 Hooks"] --> M8["08 MCP"]
    end
    subgraph P["🔴 Масштаб"]
        M9["09 Плагины"] --> M10["10 Headless и CI"] --> M11["11 Pro-приёмы"]
    end
    B --> W --> E --> P

Программа

#	Модуль	Что освоите	Практика
00	Установка и первый запуск	Установка, логин, интерфейс, горячие клавиши	—
01	Основы работы и промптинг	Постановка задач, контекст, @-упоминания, изображения	—
02	CLAUDE.md — память проекта	Иерархия, импорты, .claude/rules/	Лаба 1
03	Настройки и разрешения	settings.json, allow/ask/deny, режимы, модели	Лаба 2
04	Workflow профи	Plan mode, TDD, чекпоинты, управление контекстом	Лаба 3
05	Skills и slash-команды	SKILL.md, аргументы, авто-вызов	Лаба 4
06	Subagents	Изоляция контекста, специализация, параллельность	Лаба 5
07	Hooks	Автоформат, защита файлов, уведомления	Лаба 6
08	MCP	GitHub, браузер, БД, свои серверы	Лаба 7
09	Плагины и маркетплейсы	Упаковка и раздача конфигурации команде	Пример
10	Headless, CI и GitHub Actions	claude -p, JSON, @claude в PR, Agent SDK	Лаба 8
11	Продвинутые приёмы	Worktrees, мульти-агенты, экономия, безопасность	Чек-листы

Как работает Claude Code

Claude Code — это агент, а не автодополнение: он сам решает, какие файлы прочитать и какие команды запустить, и крутит цикл «действие → проверка», пока задача не решена. Ваша работа — дать ему цель, контекст и способ проверить результат.

flowchart LR
    U["👤 Задача<br/>промпт · @файлы · скриншоты"] --> C["📥 Сбор контекста<br/>CLAUDE.md · Read · Grep · Glob"]
    C --> P["🧠 План<br/>что менять и как проверить"]
    P --> A["🛠 Действие<br/>Edit · Write · Bash · MCP"]
    A --> V{"✅ Проверка<br/>тесты · линтер · сборка"}
    V -- "ошибка" --> C
    V -- "готово" --> R["📝 Результат<br/>diff · коммит · PR"]
    PM["🔐 Permissions"] -. "разрешить / спросить / запретить" .-> A
    H["🪝 Hooks"] -. "до и после каждого инструмента" .-> A

Контекст — главный ресурс

Всё, что Claude «знает» в сессии, лежит в одном окне контекста. Чем оно чище, тем точнее ответы. Посмотреть, чем оно занято, — /context.

flowchart TB
    subgraph CW["🪟 Окно контекста"]
        direction TB
        S1["Системный промпт и инструменты"]
        S2["CLAUDE.md и правила"]
        S3["Описания skills · agents · MCP"]
        S4["История диалога"]
        S5["Прочитанные файлы и вывод команд"]
    end
    CW --> Q{"Что дальше?"}
    Q -- "новая задача" --> CL["/clear<br/>чистый лист"]
    Q -- "длинная задача" --> CO["/compact<br/>сжать историю"]
    Q -- "большое исследование" --> SA["🤖 Subagent<br/>своё окно, вернёт только вывод"]

Как устроена конфигурация Claude Code

flowchart TB
    subgraph U["👤 Пользователь — ~/.claude/"]
        U1["CLAUDE.md"]
        U2["settings.json"]
        U3["skills/ · agents/ · output-styles/"]
    end
    subgraph PR["📦 Проект — в git, для команды"]
        P1["CLAUDE.md · .claude/rules/"]
        P2[".claude/settings.json<br/>permissions · hooks · statusLine"]
        P3[".claude/skills/ · .claude/agents/"]
        P4[".mcp.json"]
    end
    subgraph L["🔒 Локально — не в git"]
        L1["CLAUDE.local.md"]
        L2[".claude/settings.local.json"]
    end
    PL["🧩 Плагины<br/>skills · agents · hooks · MCP"]
    U --> S(("Сессия<br/>Claude Code"))
    PR --> S
    L --> S
    PL --> S

Что куда класть:

Хочу…	Инструмент
чтобы Claude знал правила проекта	CLAUDE.md, .claude/rules/
не отвечать на одни и те же вопросы о разрешениях	permissions.allow в settings
запретить опасное	permissions.deny + hook PreToolUse
переиспользовать процедуру / промпт	skill
изолировать исследование или дать узкую роль	subagent
чтобы что-то происходило всегда	hook
подключить внешнюю систему	MCP
раздать всё это другим репозиториям	плагин
запускать без человека	claude -p, GitHub Actions, Agent SDK

Как выбрать инструмент

flowchart TD
    Q1{"Должно происходить всегда,<br/>без исключений?"} -- да --> HK["🪝 Hook"]
    Q1 -- нет --> Q2{"Нужна внешняя система<br/>или данные?"}
    Q2 -- да --> MCP["🔌 MCP-сервер"]
    Q2 -- нет --> Q3{"Задача шумная,<br/>нужен отдельный контекст?"}
    Q3 -- да --> SA["🤖 Subagent"]
    Q3 -- нет --> Q4{"Повторяемая процедура<br/>или промпт?"}
    Q4 -- да --> SK["🧰 Skill"]
    Q4 -- нет --> CM["📄 CLAUDE.md или обычный промпт"]

Главные принципы (TL;DR)

1. Контекст — ваш главный ресурс. Чистите (/clear), сжимайте (/compact), выносите исследование в subagents.
2. Сначала план, потом код. Plan mode (Shift+Tab) для всего, что сложнее одного файла.
3. Дайте Claude способ проверить себя — тесты, линтер, скриншоты. Это самый сильный рычаг качества.
4. CLAUDE.md короткий и конкретный. Команды, стиль, запреты. Не роман.
5. Повторяется трижды — сделайте skill. Должно случаться всегда — сделайте hook.
6. Разрешения — через allowlist, а не через bypassPermissions.

Продвинутые приёмы работы с Claude Code

Режимы работы

Shift+Tab переключает режимы по кругу:

Режим	Что делает Claude	Когда использовать
Обычный	Спрашивает разрешение на правки и команды	Незнакомый код, рискованные изменения
Auto-accept edits	Правит файлы без подтверждения	План согласован, есть тесты и git
Plan mode	Только читает и предлагает план	Старт любой нетривиальной задачи

Explore → Plan → Code → Verify → Commit

Главный рабочий цикл. Не давайте Claude сразу писать код: сначала пусть разберётся и предложит план.

sequenceDiagram
    actor Dev as Разработчик
    participant C as Claude
    participant R as Репозиторий
    Dev->>C: Plan mode — изучи модуль оплаты, ничего не меняй
    C->>R: Read · Grep · Glob
    C-->>Dev: План — файлы, шаги, риски, как проверить
    Dev->>C: Поправь шаг 3, остальное ок — реализуй
    loop пока проверки не зелёные
        C->>R: Edit
        C->>R: Bash — тесты и линтер
    end
    C-->>Dev: diff и краткий итог
    Dev->>C: Закоммить и открой PR

Промпты, которые работают

❌ Размыто	✅ Конкретно
«Почини баг»	«При пустом email signup() падает с TypeError. Воспроизведи тестом, исправь, прогони npm test.»
«Добавь тесты»	«Покрой parseDate тестами: границы месяцев, таймзоны, невалидный ввод. Без моков, стиль как в utils.test.ts.»
«Отрефактори»	«Вынеси работу с БД из orders.ts в репозиторий. Публичный API не меняй, существующие тесты должны пройти без правок.»
«Сделай красиво»	«Сверстай по скриншоту, сними скриншот результата через браузерный MCP, сравни и исправь расхождения.»

Формула: цель + где искать + ограничения + как проверить.

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

• CLAUDE.md — память проекта. /init создаёт его автоматически. Стек, команды сборки и тестов, стиль, запреты — коротко. Редактировать — /memory.
• Одна задача — одна сессия. /clear перед новой задачей, /compact для длинной (можно с подсказкой: /compact оставь только решения по API).
• @ для файлов — @src/api/client.ts сразу кладёт файл в контекст, без поиска.
• ! для команд — !git status выполнит команду и покажет вывод Claude.
• Скриншоты и логи вставляйте прямо в чат или передавайте через пайп: cat error.log | claude.
• Пусть Claude ведёт заметки. Для долгих задач попросите вести PLAN.md или NOTES.md — после /clear работу легко продолжить.

Дайте Claude способ проверить себя

Без обратной связи агент угадывает, с ней — итерирует до результата:

• тесты и тайпчекер (npm test, pytest, tsc --noEmit);
• линтер и форматтер (лучше через hook — тогда всегда);
• скриншоты UI через браузерный MCP (Playwright, Chrome);
• эталонный вывод: «скрипт должен напечатать ровно это».

Hooks: гарантии вместо просьб

CLAUDE.md — это просьба, hook — это правило. Hook запускается на событии и может заблокировать действие.

sequenceDiagram
    participant C as Claude
    participant H as Hook
    participant T as Инструмент
    C->>H: PreToolUse — Bash rm -rf
    alt опасная команда
        H-->>C: exit 2 и причина в stderr
        Note over C: вызов заблокирован, Claude видит причину
    else всё в порядке
        H-->>C: exit 0
        C->>T: выполнить
        T-->>C: результат
        C->>H: PostToolUse — Edit
        H-->>C: prettier и eslint --fix
    end

Автоформат после каждой правки (.claude/settings.json):

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }
        ]
      }
    ]
  }
}

Событие	Пример использования
SessionStart	подгрузить текущую ветку, открытые задачи
UserPromptSubmit	добавить контекст к каждому промпту
PreToolUse	запретить rm -rf, правки .env и миграций
PostToolUse	форматтер, линтер, тесты по изменённому файлу
Notification	уведомление на рабочий стол, когда Claude ждёт вас
Stop	финальная проверка: тесты зелёные — можно завершать
PreCompact	сохранить важное перед сжатием контекста

Subagents: специалисты со своим контекстом

Субагент работает в отдельном окне контекста и возвращает только вывод — главная сессия остаётся чистой.

flowchart LR
    M["🎯 Главная сессия"] --> A1["🔍 explorer<br/>ищет по коду"]
    M --> A2["🧪 test-runner<br/>гоняет тесты"]
    M --> A3["🛡 security-reviewer<br/>ищет уязвимости"]
    A1 -- "краткая сводка" --> M
    A2 -- "только упавшие тесты" --> M
    A3 -- "список находок" --> M

.claude/agents/reviewer.md:

---
name: reviewer
description: Ревью изменений перед коммитом. Используй после любой заметной правки.
tools: Read, Grep, Glob, Bash
model: sonnet
---
Ты строгий ревьюер. Проверь git diff на баги, пограничные случаи,
утечки секретов и нарушения стиля из CLAUDE.md.
Отвечай списком: файл:строка — проблема — как исправить.

Параллельная работа через git worktree

flowchart TB
    R["📦 Репозиторий"] --> W1["../app-auth<br/>feature/auth"]
    R --> W2["../app-billing<br/>feature/billing"]
    R --> W3["../app-fix<br/>fix/flaky-test"]
    W1 --> C1["🤖 Claude 1"]
    W2 --> C2["🤖 Claude 2"]
    W3 --> C3["🤖 Claude 3"]

git worktree add ../app-auth -b feature/auth
cd ../app-auth && claude

Каждая сессия работает в своей папке и ветке — задачи идут параллельно и не мешают друг другу.

Writer / Reviewer: один Claude пишет код, второй в чистой сессии делает ревью, первый исправляет по замечаниям. Свежий контекст замечает то, что «замылилось».

Headless и автоматизация

# Разовый запрос в скрипте или CI
claude -p "Найди причину падения сборки" --output-format json < build.log

# Ревью своего diff перед пушем
git diff main | claude -p "Сделай ревью: баги, пограничные случаи, безопасность"

# Ограничить инструменты и число шагов
claude -p "Обнови CHANGELOG по последним коммитам" --allowedTools "Read,Edit,Bash(git log:*)" --max-turns 10

# Массовая миграция: файл за файлом
for f in $(git ls-files 'src/**/*.js'); do
  claude -p "Переведи $f на TypeScript, не меняя поведения" --allowedTools "Read,Edit,Bash(npx tsc:*)"
done

Шпаргалка по управлению

Клавиша / команда	Что делает
Esc	прервать Claude, не теряя контекст
Esc Esc · /rewind	откатиться к прошлому шагу (код и диалог)
Shift+Tab	переключить режим: обычный → auto-accept → plan
@файл · !команда	добавить файл / вывод команды в контекст
/clear · /compact · /context	очистить, сжать, посмотреть контекст
/model	сменить модель
/permissions · /hooks · /agents · /mcp	настройка разрешений, хуков, агентов, MCP
claude --continue · claude --resume	продолжить последнюю / выбрать прошлую сессию

Практические рецепты задач

Готовые промпты под частые задачи — копируйте и подставляйте своё. Больше — в библиотеке промптов.

<details> <summary><b>🗺 Разобраться в незнакомом проекте</b></summary>

Plan mode. Изучи репозиторий и объясни: архитектуру, точки входа,
поток данных для запроса /api/orders, где тесты и как их запускать.
Ничего не меняй. В конце — 5 мест, где новичку легче всего ошибиться.

</details> <details> <summary><b>🐛 Баг по стектрейсу</b></summary>

@error.log Вот стектрейс из продакшена.
1) Найди корневую причину, а не место падения.
2) Напиши падающий тест, который воспроизводит баг.
3) Исправь минимальным изменением, прогони все тесты.

</details> <details> <summary><b>🧪 Фича через TDD</b></summary>

Фича: скидка 10% для заказов от 5000 ₽.
Сначала напиши тесты (включая границы: 4999, 5000, 0, отрицательные),
убедись, что они падают, и закоммить. Потом реализуй, не меняя тесты.

</details> <details> <summary><b>♻️ Безопасный рефакторинг</b></summary>

Разбей @src/services/user.ts на модули по ответственности.
Поведение и публичный API не меняй. После каждого шага — тесты и tsc.
Если тестов не хватает, сначала добавь характеризационные тесты.

</details> <details> <summary><b>🔍 Ревью своего кода</b></summary>

Сделай ревью git diff main как строгий senior:
баги, гонки, пограничные случаи, безопасность, производительность.
Формат: файл:строка — проблема — критичность — как исправить.

</details> <details> <summary><b>🎲 Плавающий (flaky) тест</b></summary>

Тест checkout.spec.ts падает примерно в 1 из 10 запусков.
Запусти его 30 раз, собери статистику, найди источник
недетерминизма (время, порядок, сеть, общий стейт) и устрани его.

</details> <details> <summary><b>⬆️ Обновление зависимости</b></summary>

Обнови react-router с v5 до v6. Сначала составь план миграции
по changelog и список затронутых файлов. Затем мигрируй по одному
модулю, после каждого — сборка и тесты.

</details> <details> <summary><b>🎨 Вёрстка по макету</b></summary>

[скриншот] Сверстай этот экран на наших компонентах из @src/ui.
После — сними скриншот через браузерный MCP, сравни с макетом
и исправь расхождения. Повтори, пока не совпадёт.

</details> <details> <summary><b>⚡ Производительность</b></summary>

Эндпоинт /api/report отвечает 4 секунды. Найди узкое место
(N+1, лишние запросы, тяжёлые вычисления), предложи 2–3 варианта
с оценкой выигрыша. Реализуй лучший и замерь до/после.

</details> <details> <summary><b>🛡 Аудит безопасности</b></summary>

Используй субагента: проверь проект на OWASP Top 10 —
инъекции, XSS, хранение секретов, авторизацию на эндпоинтах.
Верни отчёт по критичности. Ничего не исправляй без моего ок.

</details> <details> <summary><b>📝 Описание PR и changelog</b></summary>

По git log main..HEAD и diff напиши описание PR:
зачем, что изменилось, как проверить, риски.
Добавь запись в CHANGELOG.md в нашем формате.

</details> <details> <summary><b>🚨 Разбор инцидента</b></summary>

@incident.log Восстанови хронологию инцидента по логам,
найди первопричину и напиши постмортем: таймлайн, причина,
влияние, что сделать, чтобы не повторилось.

</details>

Антипаттерны и как их исправить

❌ Ошибка	Почему плохо	✅ Как правильно
Одна бесконечная сессия на весь день	Контекст забит старым, ответы хуже	/clear между задачами, заметки в файле
«Сделай фичу» без плана	Claude уверенно идёт не туда	Plan mode → согласовать → реализовать
Нет тестов и проверок	Агент не видит своих ошибок	Тесты, линтер, скриншоты в цикле
CLAUDE.md на 500 строк	Важное тонет, тратится контекст	Коротко; детали — в .claude/rules/ и skills
Правила только словами в CLAUDE.md	Иногда игнорируются	Критичное — через hooks и permissions.deny
bypassPermissions «чтобы не спрашивал»	Риск удалить лишнее или слить секреты	Allowlist безопасных команд, песочница
Исправлять ошибку третьим сообщением подряд	Контекст засоряется неудачными попытками	Esc Esc / /rewind и переформулировать
Принимать diff не глядя	Тихие баги и лишние изменения	Ревью diff или субагент-ревьюер

Безопасность и разрешения

Каждый вызов инструмента проходит через правила. Порядок проверки: deny → ask → allow, запрет всегда сильнее разрешения.

flowchart LR
    T["🛠 Claude хочет<br/>вызвать инструмент"] --> H{"🪝 PreToolUse<br/>hook"}
    H -- "exit 2" --> X["⛔ Заблокировано"]
    H -- "ок" --> D{"Есть правило<br/>deny?"}
    D -- да --> X
    D -- нет --> K{"Есть правило<br/>ask?"}
    K -- да --> Q["🙋 Спросить вас"]
    K -- нет --> A{"Есть правило<br/>allow?"}
    A -- да --> OK["✅ Выполнить"]
    A -- нет --> Q
    Q -- "разрешили" --> OK
    Q -- "отказали" --> X

Пример .claude/settings.json для команды:

{
  "permissions": {
    "allow": [
      "Bash(npm run test:*)",
      "Bash(npm run lint)",
      "Bash(git status)",
      "Bash(git diff:*)"
    ],
    "ask": [
      "Bash(git push:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(curl:*)"
    ]
  }
}

Чек-лист:

• секреты закрыты через deny и не лежат в CLAUDE.md;
• git push, деплой и миграции — только с подтверждением;
• автономные запуски (-p, CI, --dangerously-skip-permissions) — только в контейнере или песочнице без доступа к проду;
• данные из интернета и MCP — это данные, а не инструкции: следите за промпт-инъекциями;
• перед коммитом — git diff, а не «принять всё».

Готовые шаблоны

<details> <summary><b>📄 CLAUDE.md — короткий и рабочий</b></summary>

# Проект: магазин на Next.js + PostgreSQL

## Команды
- npm run dev — запуск
- npm test — тесты (Vitest), npm run lint — линтер
- npm run db:migrate — миграции (только с подтверждения!)

## Архитектура
- src/app — роуты, src/lib — бизнес-логика, src/db — доступ к БД
- Вся работа с БД только через src/db, не из компонентов

## Правила
- TypeScript strict, без any
- Новый код — с тестами, баг — сначала падающий тест
- Не трогать src/legacy без явной просьбы
- Перед завершением задачи: npm test && npm run lint

</details> <details> <summary><b>🧰 Skill — повторяемая процедура</b></summary>

.claude/skills/release-notes/SKILL.md:

---
name: release-notes
description: Готовит release notes по коммитам с последнего тега. Используй, когда просят релиз, changelog или заметки к версии.
---
1. Найди последний тег: git describe --tags --abbrev=0
2. Собери коммиты: git log <тег>..HEAD --oneline
3. Сгруппируй: ✨ Новое, 🐛 Исправления, ⚙️ Внутреннее
4. Пиши для пользователей, а не для разработчиков
5. Добавь блок в начало CHANGELOG.md

Вызов: /release-notes — или Claude сам подхватит skill по описанию.

</details> <details> <summary><b>🔌 MCP — подключение внешних инструментов</b></summary>

# Браузер для проверки UI и скриншотов
claude mcp add playwright -- npx @playwright/mcp@latest

# Посмотреть подключённые серверы и их статус
claude mcp list

Общий для команды .mcp.json в корне репозитория:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

</details> <details> <summary><b>🤖 GitHub Actions — @claude в issues и PR</b></summary>

Самый быстрый способ — выполнить в Claude Code /install-github-app. После этого достаточно написать в issue или PR:

@claude реализуй эту задачу и открой PR
@claude сделай ревью этого PR с фокусом на безопасность

Готовые workflow — в .github/workflows/.

</details>

Экономия контекста и денег

Приём	Эффект
/clear между задачами	не платите за чужую историю в каждом запросе
/compact с подсказкой, что сохранить	длинная задача без переполнения
Поиск и чтение логов — в субагента	в главный контекст попадает вывод, а не тысячи строк
Модель под задачу (/model)	сильная — для архитектуры и сложных багов, быстрая — для рутины и поиска
@файл вместо «найди сам»	меньше лишних чтений
Короткий CLAUDE.md, детали — в skills	skill грузится только когда нужен
Отключать неиспользуемые MCP-серверы	описания инструментов тоже занимают контекст
/context и /cost	видно, куда уходят токены

Путь к уровню PRO

flowchart LR
    L1["🟢 Новичок<br/>чат и правки по просьбе"] --> L2["🟡 Практик<br/>CLAUDE.md · Plan mode · тесты"]
    L2 --> L3["🟠 Продвинутый<br/>skills · hooks · subagents · MCP"]
    L3 --> L4["🔴 PRO<br/>worktrees · headless · CI · плагины для команды"]

Частые проблемы

Симптом	Причина	Что сделать
Claude «забыл» договорённости	контекст сжат или переполнен	вынести в CLAUDE.md, вести NOTES.md, /clear и начать с плана
Игнорирует правило из CLAUDE.md	правило утонуло среди прочего	сократить файл, критичное — в hook или deny
Ходит по кругу с одной ошибкой	замусоренный контекст	Esc Esc, откатиться и дать больше данных: лог, тест, гипотезу
Меняет лишние файлы	нет границ в задаче	указать, какие файлы трогать нельзя, работать по плану
Постоянно спрашивает разрешения	нет allowlist	/permissions или permissions.allow в settings
MCP-сервер не видно	не запустился или не тот scope	claude mcp list, /mcp, проверить .mcp.json
Hook не срабатывает	неверный matcher или путь	/hooks, запустить скрипт вручную, проверить exit code

Прогресс

Скопируйте в свою заметку или issue и отмечайте:

- [ ] 00 Установка          - [ ] 06 Subagents        + Лаба 5
- [ ] 01 Промптинг          - [ ] 07 Hooks            + Лаба 6
- [ ] 02 CLAUDE.md + Лаба 1 - [ ] 08 MCP              + Лаба 7
- [ ] 03 Настройки + Лаба 2 - [ ] 09 Плагины
- [ ] 04 Workflow  + Лаба 3 - [ ] 10 Headless и CI    + Лаба 8
- [ ] 05 Skills    + Лаба 4 - [ ] 11 Pro-приёмы (итоговый чек-лист)

Структура репозитория

.
├── course/                  # 12 модулей + cheatsheet.md + faq.md
├── labs/                    # 8 лабораторных работ
├── recipes/prompts.md       # библиотека промптов
├── starter-kit/             # готовая конфигурация для копирования
│   ├── CLAUDE.md  .mcp.json
│   └── .claude/
│       ├── settings.json    # permissions + hooks + statusLine
│       ├── skills/          # 8 skills
│       ├── agents/          # 5 субагентов
│       ├── hooks/           # 4 hook-скрипта
│       ├── rules/           # правила по путям
│       ├── output-styles/   # режим наставника
│       └── statusline.sh
├── plugin-example/          # пример плагина
├── install.sh               # установщик starter-kit
├── scripts/validate.py      # проверки (запускаются в CI)
└── .github/workflows/       # @claude, авто-ревью PR, валидация

Участие

Нашли устаревшую команду или хотите добавить лабу/шаблон? См. CONTRIBUTING.md. История изменений — CHANGELOG.md.

Полезные ссылки

• Документация: https://code.claude.com/docs
• Best practices от Anthropic: https://www.anthropic.com/engineering/claude-code-best-practices
• GitHub Action: https://github.com/anthropics/claude-code-action

⚠️ Claude Code быстро развивается. Если команда или поле не работает — сверьтесь с /help и официальной документацией и откройте issue.

Лицензия

MIT — используйте, копируйте, адаптируйте.