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

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

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

# 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

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/>своё окно, вернёт только вывод"]

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

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

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 или обычный промпт"]

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

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

Главный рабочий цикл. Не давайте 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

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

• 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 работу легко продолжить.

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

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

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" }
        ]
      }
    ]
  }
}

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

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.
Отвечай списком: файл:строка — проблема — как исправить.

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 пишет код, второй в чистой сессии делает ревью, первый исправляет по замечаниям. Свежий контекст замечает то, что «замылилось».

# Разовый запрос в скрипте или 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

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

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

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

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

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

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

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

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

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

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

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

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

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

Каждый вызов инструмента проходит через правила. Порядок проверки: 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, а не «принять всё».

# Проект: магазин на 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

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

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

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

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

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

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

Скопируйте в свою заметку или 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 — используйте, копируйте, адаптируйте.