Skip to content
Back to search

claude-code-pro-course

Claude Code PRO — полный курс и гайд на русском: CLAUDE.md, settings, skills, subagents, hooks, MCP, плагины, CI. 8 лабораторных, библиотека промптов и готовый starter-kit. Здесь бесплатные курсы по chatgpt -

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/justxor--claude-code-pro-course/badge.svg)](/listings/justxor--claude-code-pro-course)

HTML

<a href="/listings/justxor--claude-code-pro-course"><img src="/api/listings/justxor--claude-code-pro-course/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 767 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Claude Code PRO — курс и гайд
  2. > Практический курс по работе с **Claude Code** на русском: от первого запуска до профессиональной настройки команды.
  3. > CLAUDE.md, settings, skills, subagents, hooks, MCP, плагины, headless-режим и CI — с лабораторными работами и готовыми шаблонами, которые можно скопировать в свой проект. 🧠 **[Machine learning](https://t.me/+PwIsGaFpgjhkNTdi)** — здесь можно найти полный список самых крутых ИИ курсво, чтобы стать гуру ИИ и множество полезных инструментов и уроками работы с ними, абсолютных мастхев!
  4. [![Validate](https://github.com/justxor/claude-code-pro-course/actions/workflows/validate.yml/badge.svg)](https://github.com/justxor/claude-code-pro-course/actions/workflows/validate.yml)
  5. ![level](https://img.shields.io/badge/уровень-от_новичка_до_профи-blue)
  6. ![modules](https://img.shields.io/badge/модулей-12-orange)
  7. ![labs](https://img.shields.io/badge/лаб-8-purple)
  8. ![lang](https://img.shields.io/badge/язык-русский-green)
  9. ![license](https://img.shields.io/badge/license-MIT-lightgrey)
  10. ---
  11. ## Содержание
  12. | Старт | Как это работает | Практика | Справочник |
  13. |---|---|---|---|
  14. | [Быстрый старт](#быстрый-старт-за-5-минут) | [Агентный цикл](#как-работает-claude-code) | [Продвинутые приёмы](#продвинутые-приёмы-работы-с-claude-code) | [Безопасность](#безопасность-и-разрешения) |
  15. | [Маршрут обучения](#маршрут-обучения) | [Конфигурация](#как-устроена-конфигурация-claude-code) | [Рецепты задач](#практические-рецепты-задач) | [Шаблоны](#готовые-шаблоны) |
  16. | [Программа](#программа) | [Принципы](#главные-принципы-tldr) | [Антипаттерны](#антипаттерны-и-как-их-исправить) | [Экономия](#экономия-контекста-и-денег) · [Проблемы](#частые-проблемы) |
  17. ## Что внутри
  18. | | |
  19. |---|---|
  20. | 📚 **[12 модулей](#программа)** | Теория с примерами: от установки до мульти-агентной работы |
  21. | 🧪 **[8 лабораторных](labs/)** | Задания с критериями «готово» — закрепить на практике |
  22. | 🧰 **[Starter kit](starter-kit/)** | 8 skills, 5 субагентов, 4 hooks, правила, statusline, output style — ставится одной командой |
  23. | 💬 **[Библиотека промптов](recipes/prompts.md)** | Проверенные формулировки для 13 типов задач |
  24. | 🧩 **[Пример плагина](plugin-example/)** | Как упаковать настройки и раздать команде |
  25. | ⚙️ **[GitHub Actions](.github/workflows/)** | `@claude` в issues/PR и авто-ревью |
  26. | 📋 **[Шпаргалка](course/cheatsheet.md) · [FAQ](course/faq.md)** | Всё важное на одной странице и решения типичных проблем |
  27. ## Полезные ресурсы
  28. - 🧠 **[Machine learning](https://t.me/+PwIsGaFpgjhkNTdi)** — ИИ-инструменты для генерации Python кода, умные-агенты и все что нужно знать из области AI.
  29. - 🖥 **[Pythonl](https://t.me/+pwTlhtK8vEY4Mjky)**— с помощью понятных картинок и коротких видео авторы объясняют сложные концепции и учат профессиональному подходу в разработке.
  30. - 🖥 **[Python Интервью](https://t.me/+sTT6sbZubDM2MWEy)** — огромное количество разобранных вопросов с реальных собеседований Python разработчика.
  31. - 📖 **[PythonBooks](https://t.me/+VnfYvBmK_ZM3YzIy)** ([2](https://t.me/+8Dvl5VlUs5NhMTIy)) — мы создали канал с книгами по Linux и залили туда наверное самую большую подборку книг.
  32. - 💼 **[Python Jobs](https://t.me/+eQsE0ZVnmINmNjQy)** — вакансии и подработка для Python разработчиков.
  33. - 🔝 **[А здесь мы собрали](https://t.me/addlist/8vDUwYRGujRmZjFi)** целый кладезь полезных Python ресурсов для прокачки.
  34. - 🔥 **[Больше крутых курсов и полезных ИИ-инструментов](https://t.me/ai_machinelearning_big_data/10997)** — регулярно публикую здесь.
  35. - 📦 **[Harness_ru](https://github.com/justxor/Harness_ru)** — полный курс по Harness 2026 на русском языке: всё, что нужно знать, в одном месте.
  36. ## Для кого
  37. - Разработчики, которые уже пробовали Claude Code и хотят выжать из него максимум.
  38. - Тимлиды, которым нужно настроить единые правила для команды.
  39. - Все, кто хочет автоматизировать рутину: ревью, тесты, коммиты, CI.
  40. ## Быстрый старт за 5 минут
  41. ```bash
  42. # 1. Установите Claude Code
  43. curl -fsSL https://claude.ai/install.sh | bash # macOS / Linux / WSL
  44. # или: npm install -g @anthropic-ai/claude-code
  45. # 2. Поставьте starter-kit в свой проект
  46. git clone https://github.com/justxor/claude-code-pro-course.git
  47. bash claude-code-pro-course/install.sh ~/path/to/my-project
  48. # 3. Запустите
  49. cd ~/path/to/my-project && claude
  50. > /context # что загружено
  51. > /onboard # skill из starter-kit: обзор проекта
  52. ```
  53. ## Маршрут обучения
  54. ```mermaid
  55. flowchart LR
  56. subgraph B["🟢 Основы"]
  57. M0["00 Установка"] --> M1["01 Промптинг"] --> M2["02 CLAUDE.md"] --> M3["03 Настройки"]
  58. end
  59. subgraph W["🟡 Рабочий процесс"]
  60. M4["04 Workflow профи"]
  61. end
  62. subgraph E["🟠 Расширение"]
  63. M5["05 Skills"] --> M6["06 Subagents"] --> M7["07 Hooks"] --> M8["08 MCP"]
  64. end
  65. subgraph P["🔴 Масштаб"]
  66. M9["09 Плагины"] --> M10["10 Headless и CI"] --> M11["11 Pro-приёмы"]
  67. end
  68. B --> W --> E --> P
  69. ```
  70. ## Программа
  71. | # | Модуль | Что освоите | Практика |
  72. |---|--------|-------------|----------|
  73. | 00 | [Установка и первый запуск](course/00-install.md) | Установка, логин, интерфейс, горячие клавиши | — |
  74. | 01 | [Основы работы и промптинг](course/01-basics-prompting.md) | Постановка задач, контекст, @-упоминания, изображения | — |
  75. | 02 | [CLAUDE.md — память проекта](course/02-claude-md.md) | Иерархия, импорты, `.claude/rules/` | [Лаба 1](labs/lab-01-onboarding.md) |
  76. | 03 | [Настройки и разрешения](course/03-settings-permissions.md) | settings.json, allow/ask/deny, режимы, модели | [Лаба 2](labs/lab-02-permissions.md) |
  77. | 04 | [Workflow профи](course/04-workflow.md) | Plan mode, TDD, чекпоинты, управление контекстом | [Лаба 3](labs/lab-03-tdd-feature.md) |
  78. | 05 | [Skills и slash-команды](course/05-skills.md) | SKILL.md, аргументы, авто-вызов | [Лаба 4](labs/lab-04-skill.md) |
  79. | 06 | [Subagents](course/06-subagents.md) | Изоляция контекста, специализация, параллельность | [Лаба 5](labs/lab-05-subagents.md) |
  80. | 07 | [Hooks](course/07-hooks.md) | Автоформат, защита файлов, уведомления | [Лаба 6](labs/lab-06-hooks.md) |
  81. | 08 | [MCP](course/08-mcp.md) | GitHub, браузер, БД, свои серверы | [Лаба 7](labs/lab-07-mcp.md) |
  82. | 09 | [Плагины и маркетплейсы](course/09-plugins.md) | Упаковка и раздача конфигурации команде | [Пример](plugin-example/) |
  83. | 10 | [Headless, CI и GitHub Actions](course/10-headless-ci.md) | `claude -p`, JSON, `@claude` в PR, Agent SDK | [Лаба 8](labs/lab-08-automation.md) |
  84. | 11 | [Продвинутые приёмы](course/11-pro-tips.md) | Worktrees, мульти-агенты, экономия, безопасность | Чек-листы |
  85. ## Как работает Claude Code
  86. Claude Code — это **агент**, а не автодополнение: он сам решает, какие файлы прочитать и какие команды запустить, и крутит цикл «действие → проверка», пока задача не решена. Ваша работа — дать ему цель, контекст и способ проверить результат.
  87. ```mermaid
  88. flowchart LR
  89. U["👤 Задача<br/>промпт · @файлы · скриншоты"] --> C["📥 Сбор контекста<br/>CLAUDE.md · Read · Grep · Glob"]
  90. C --> P["🧠 План<br/>что менять и как проверить"]
  91. P --> A["🛠 Действие<br/>Edit · Write · Bash · MCP"]
  92. A --> V{"✅ Проверка<br/>тесты · линтер · сборка"}
  93. V -- "ошибка" --> C
  94. V -- "готово" --> R["📝 Результат<br/>diff · коммит · PR"]
  95. PM["🔐 Permissions"] -. "разрешить / спросить / запретить" .-> A
  96. H["🪝 Hooks"] -. "до и после каждого инструмента" .-> A
  97. ```
  98. ### Контекст — главный ресурс
  99. Всё, что Claude «знает» в сессии, лежит в одном окне контекста. Чем оно чище, тем точнее ответы. Посмотреть, чем оно занято, — `/context`.
  100. ```mermaid
  101. flowchart TB
  102. subgraph CW["🪟 Окно контекста"]
  103. direction TB
  104. S1["Системный промпт и инструменты"]
  105. S2["CLAUDE.md и правила"]
  106. S3["Описания skills · agents · MCP"]
  107. S4["История диалога"]
  108. S5["Прочитанные файлы и вывод команд"]
  109. end
  110. CW --> Q{"Что дальше?"}
  111. Q -- "новая задача" --> CL["/clear<br/>чистый лист"]
  112. Q -- "длинная задача" --> CO["/compact<br/>сжать историю"]
  113. Q -- "большое исследование" --> SA["🤖 Subagent<br/>своё окно, вернёт только вывод"]
  114. ```
  115. ## Как устроена конфигурация Claude Code
  116. ```mermaid
  117. flowchart TB
  118. subgraph U["👤 Пользователь — ~/.claude/"]
  119. U1["CLAUDE.md"]
  120. U2["settings.json"]
  121. U3["skills/ · agents/ · output-styles/"]
  122. end
  123. subgraph PR["📦 Проект — в git, для команды"]
  124. P1["CLAUDE.md · .claude/rules/"]
  125. P2[".claude/settings.json<br/>permissions · hooks · statusLine"]
  126. P3[".claude/skills/ · .claude/agents/"]
  127. P4[".mcp.json"]
  128. end
  129. subgraph L["🔒 Локально — не в git"]
  130. L1["CLAUDE.local.md"]
  131. L2[".claude/settings.local.json"]
  132. end
  133. PL["🧩 Плагины<br/>skills · agents · hooks · MCP"]
  134. U --> S(("Сессия<br/>Claude Code"))
  135. PR --> S
  136. L --> S
  137. PL --> S
  138. ```
  139. **Что куда класть:**
  140. | Хочу… | Инструмент |
  141. |---|---|
  142. | чтобы Claude знал правила проекта | `CLAUDE.md`, `.claude/rules/` |
  143. | не отвечать на одни и те же вопросы о разрешениях | `permissions.allow` в settings |
  144. | запретить опасное | `permissions.deny` + hook `PreToolUse` |
  145. | переиспользовать процедуру / промпт | **skill** |
  146. | изолировать исследование или дать узкую роль | **subagent** |
  147. | чтобы что-то происходило **всегда** | **hook** |
  148. | подключить внешнюю систему | **MCP** |
  149. | раздать всё это другим репозиториям | **плагин** |
  150. | запускать без человека | `claude -p`, GitHub Actions, Agent SDK |
  151. ### Как выбрать инструмент
  152. ```mermaid
  153. flowchart TD
  154. Q1{"Должно происходить всегда,<br/>без исключений?"} -- да --> HK["🪝 Hook"]
  155. Q1 -- нет --> Q2{"Нужна внешняя система<br/>или данные?"}
  156. Q2 -- да --> MCP["🔌 MCP-сервер"]
  157. Q2 -- нет --> Q3{"Задача шумная,<br/>нужен отдельный контекст?"}
  158. Q3 -- да --> SA["🤖 Subagent"]
  159. Q3 -- нет --> Q4{"Повторяемая процедура<br/>или промпт?"}
  160. Q4 -- да --> SK["🧰 Skill"]
  161. Q4 -- нет --> CM["📄 CLAUDE.md или обычный промпт"]
  162. ```
  163. ## Главные принципы (TL;DR)
  164. 1. **Контекст — ваш главный ресурс.** Чистите (`/clear`), сжимайте (`/compact`), выносите исследование в subagents.
  165. 2. **Сначала план, потом код.** Plan mode (`Shift+Tab`) для всего, что сложнее одного файла.
  166. 3. **Дайте Claude способ проверить себя** — тесты, линтер, скриншоты. Это самый сильный рычаг качества.
  167. 4. **CLAUDE.md короткий и конкретный.** Команды, стиль, запреты. Не роман.
  168. 5. **Повторяется трижды — сделайте skill.** Должно случаться всегда — сделайте hook.
  169. 6. **Разрешения — через allowlist,** а не через `bypassPermissions`.
  170. ## Продвинутые приёмы работы с Claude Code
  171. ### Режимы работы
  172. `Shift+Tab` переключает режимы по кругу:
  173. | Режим | Что делает Claude | Когда использовать |
  174. |---|---|---|
  175. | **Обычный** | Спрашивает разрешение на правки и команды | Незнакомый код, рискованные изменения |
  176. | **Auto-accept edits** | Правит файлы без подтверждения | План согласован, есть тесты и git |
  177. | **Plan mode** | Только читает и предлагает план | Старт любой нетривиальной задачи |
  178. ### Explore → Plan → Code → Verify → Commit
  179. Главный рабочий цикл. Не давайте Claude сразу писать код: сначала пусть разберётся и предложит план.
  180. ```mermaid
  181. sequenceDiagram
  182. actor Dev as Разработчик
  183. participant C as Claude
  184. participant R as Репозиторий
  185. Dev->>C: Plan mode — изучи модуль оплаты, ничего не меняй
  186. C->>R: Read · Grep · Glob
  187. C-->>Dev: План — файлы, шаги, риски, как проверить
  188. Dev->>C: Поправь шаг 3, остальное ок — реализуй
  189. loop пока проверки не зелёные
  190. C->>R: Edit
  191. C->>R: Bash — тесты и линтер
  192. end
  193. C-->>Dev: diff и краткий итог
  194. Dev->>C: Закоммить и открой PR
  195. ```
  196. ### Промпты, которые работают
  197. | ❌ Размыто | ✅ Конкретно |
  198. |---|---|
  199. | «Почини баг» | «При пустом email `signup()` падает с TypeError. Воспроизведи тестом, исправь, прогони `npm test`.» |
  200. | «Добавь тесты» | «Покрой `parseDate` тестами: границы месяцев, таймзоны, невалидный ввод. Без моков, стиль как в `utils.test.ts`.» |
  201. | «Отрефактори» | «Вынеси работу с БД из `orders.ts` в репозиторий. Публичный API не меняй, существующие тесты должны пройти без правок.» |
  202. | «Сделай красиво» | «Сверстай по скриншоту, сними скриншот результата через браузерный MCP, сравни и исправь расхождения.» |
  203. Формула: **цель + где искать + ограничения + как проверить**.
  204. ### Контекст и память
  205. - **CLAUDE.md — память проекта.** `/init` создаёт его автоматически. Стек, команды сборки и тестов, стиль, запреты — коротко. Редактировать — `/memory`.
  206. - **Одна задача — одна сессия.** `/clear` перед новой задачей, `/compact` для длинной (можно с подсказкой: `/compact оставь только решения по API`).
  207. - **`@` для файлов** — `@src/api/client.ts` сразу кладёт файл в контекст, без поиска.
  208. - **`!` для команд** — `!git status` выполнит команду и покажет вывод Claude.
  209. - **Скриншоты и логи** вставляйте прямо в чат или передавайте через пайп: `cat error.log | claude`.
  210. - **Пусть Claude ведёт заметки.** Для долгих задач попросите вести `PLAN.md` или `NOTES.md` — после `/clear` работу легко продолжить.
  211. ### Дайте Claude способ проверить себя
  212. Без обратной связи агент угадывает, с ней — итерирует до результата:
  213. - тесты и тайпчекер (`npm test`, `pytest`, `tsc --noEmit`);
  214. - линтер и форматтер (лучше через hook — тогда всегда);
  215. - скриншоты UI через браузерный MCP (Playwright, Chrome);
  216. - эталонный вывод: «скрипт должен напечатать ровно это».
  217. ### Hooks: гарантии вместо просьб
  218. CLAUDE.md — это просьба, hook — это правило. Hook запускается на событии и может заблокировать действие.
  219. ```mermaid
  220. sequenceDiagram
  221. participant C as Claude
  222. participant H as Hook
  223. participant T as Инструмент
  224. C->>H: PreToolUse — Bash rm -rf
  225. alt опасная команда
  226. H-->>C: exit 2 и причина в stderr
  227. Note over C: вызов заблокирован, Claude видит причину
  228. else всё в порядке
  229. H-->>C: exit 0
  230. C->>T: выполнить
  231. T-->>C: результат
  232. C->>H: PostToolUse — Edit
  233. H-->>C: prettier и eslint --fix
  234. end
  235. ```
  236. Автоформат после каждой правки (`.claude/settings.json`):
  237. ```json
  238. {
  239. "hooks": {
  240. "PostToolUse": [
  241. {
  242. "matcher": "Edit|Write",
  243. "hooks": [
  244. { "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }
  245. ]
  246. }
  247. ]
  248. }
  249. }
  250. ```
  251. | Событие | Пример использования |
  252. |---|---|
  253. | `SessionStart` | подгрузить текущую ветку, открытые задачи |
  254. | `UserPromptSubmit` | добавить контекст к каждому промпту |
  255. | `PreToolUse` | запретить `rm -rf`, правки `.env` и миграций |
  256. | `PostToolUse` | форматтер, линтер, тесты по изменённому файлу |
  257. | `Notification` | уведомление на рабочий стол, когда Claude ждёт вас |
  258. | `Stop` | финальная проверка: тесты зелёные — можно завершать |
  259. | `PreCompact` | сохранить важное перед сжатием контекста |
  260. ### Subagents: специалисты со своим контекстом
  261. Субагент работает в отдельном окне контекста и возвращает только вывод — главная сессия остаётся чистой.
  262. ```mermaid
  263. flowchart LR
  264. M["🎯 Главная сессия"] --> A1["🔍 explorer<br/>ищет по коду"]
  265. M --> A2["🧪 test-runner<br/>гоняет тесты"]
  266. M --> A3["🛡 security-reviewer<br/>ищет уязвимости"]
  267. A1 -- "краткая сводка" --> M
  268. A2 -- "только упавшие тесты" --> M
  269. A3 -- "список находок" --> M
  270. ```
  271. `.claude/agents/reviewer.md`:
  272. ```markdown
  273. ---
  274. name: reviewer
  275. description: Ревью изменений перед коммитом. Используй после любой заметной правки.
  276. tools: Read, Grep, Glob, Bash
  277. model: sonnet
  278. ---
  279. Ты строгий ревьюер. Проверь git diff на баги, пограничные случаи,
  280. утечки секретов и нарушения стиля из CLAUDE.md.
  281. Отвечай списком: файл:строка — проблема — как исправить.
  282. ```
  283. ### Параллельная работа через git worktree
  284. ```mermaid
  285. flowchart TB
  286. R["📦 Репозиторий"] --> W1["../app-auth<br/>feature/auth"]
  287. R --> W2["../app-billing<br/>feature/billing"]
  288. R --> W3["../app-fix<br/>fix/flaky-test"]
  289. W1 --> C1["🤖 Claude 1"]
  290. W2 --> C2["🤖 Claude 2"]
  291. W3 --> C3["🤖 Claude 3"]
  292. ```
  293. ```bash
  294. git worktree add ../app-auth -b feature/auth
  295. cd ../app-auth && claude
  296. ```
  297. Каждая сессия работает в своей папке и ветке — задачи идут параллельно и не мешают друг другу.
  298. **Writer / Reviewer:** один Claude пишет код, второй в чистой сессии делает ревью, первый исправляет по замечаниям. Свежий контекст замечает то, что «замылилось».
  299. ### Headless и автоматизация
  300. ```bash
  301. # Разовый запрос в скрипте или CI
  302. claude -p "Найди причину падения сборки" --output-format json < build.log
  303. # Ревью своего diff перед пушем
  304. git diff main | claude -p "Сделай ревью: баги, пограничные случаи, безопасность"
  305. # Ограничить инструменты и число шагов
  306. claude -p "Обнови CHANGELOG по последним коммитам" --allowedTools "Read,Edit,Bash(git log:*)" --max-turns 10
  307. # Массовая миграция: файл за файлом
  308. for f in $(git ls-files 'src/**/*.js'); do
  309. claude -p "Переведи $f на TypeScript, не меняя поведения" --allowedTools "Read,Edit,Bash(npx tsc:*)"
  310. done
  311. ```
  312. ### Шпаргалка по управлению
  313. | Клавиша / команда | Что делает |
  314. |---|---|
  315. | `Esc` | прервать Claude, не теряя контекст |
  316. | `Esc Esc` · `/rewind` | откатиться к прошлому шагу (код и диалог) |
  317. | `Shift+Tab` | переключить режим: обычный → auto-accept → plan |
  318. | `@файл` · `!команда` | добавить файл / вывод команды в контекст |
  319. | `/clear` · `/compact` · `/context` | очистить, сжать, посмотреть контекст |
  320. | `/model` | сменить модель |
  321. | `/permissions` · `/hooks` · `/agents` · `/mcp` | настройка разрешений, хуков, агентов, MCP |
  322. | `claude --continue` · `claude --resume` | продолжить последнюю / выбрать прошлую сессию |
  323. ## Практические рецепты задач
  324. Готовые промпты под частые задачи — копируйте и подставляйте своё. Больше — в [библиотеке промптов](recipes/prompts.md).
  325. <details>
  326. <summary><b>🗺 Разобраться в незнакомом проекте</b></summary>
  327. ```text
  328. Plan mode. Изучи репозиторий и объясни: архитектуру, точки входа,
  329. поток данных для запроса /api/orders, где тесты и как их запускать.
  330. Ничего не меняй. В конце — 5 мест, где новичку легче всего ошибиться.
  331. ```
  332. </details>
  333. <details>
  334. <summary><b>🐛 Баг по стектрейсу</b></summary>
  335. ```text
  336. @error.log Вот стектрейс из продакшена.
  337. 1) Найди корневую причину, а не место падения.
  338. 2) Напиши падающий тест, который воспроизводит баг.
  339. 3) Исправь минимальным изменением, прогони все тесты.
  340. ```
  341. </details>
  342. <details>
  343. <summary><b>🧪 Фича через TDD</b></summary>
  344. ```text
  345. Фича: скидка 10% для заказов от 5000 ₽.
  346. Сначала напиши тесты (включая границы: 4999, 5000, 0, отрицательные),
  347. убедись, что они падают, и закоммить. Потом реализуй, не меняя тесты.
  348. ```
  349. </details>
  350. <details>
  351. <summary><b>♻️ Безопасный рефакторинг</b></summary>
  352. ```text
  353. Разбей @src/services/user.ts на модули по ответственности.
  354. Поведение и публичный API не меняй. После каждого шага — тесты и tsc.
  355. Если тестов не хватает, сначала добавь характеризационные тесты.
  356. ```
  357. </details>
  358. <details>
  359. <summary><b>🔍 Ревью своего кода</b></summary>
  360. ```text
  361. Сделай ревью git diff main как строгий senior:
  362. баги, гонки, пограничные случаи, безопасность, производительность.
  363. Формат: файл:строка — проблема — критичность — как исправить.
  364. ```
  365. </details>
  366. <details>
  367. <summary><b>🎲 Плавающий (flaky) тест</b></summary>
  368. ```text
  369. Тест checkout.spec.ts падает примерно в 1 из 10 запусков.
  370. Запусти его 30 раз, собери статистику, найди источник
  371. недетерминизма (время, порядок, сеть, общий стейт) и устрани его.
  372. ```
  373. </details>
  374. <details>
  375. <summary><b>⬆️ Обновление зависимости</b></summary>
  376. ```text
  377. Обнови react-router с v5 до v6. Сначала составь план миграции
  378. по changelog и список затронутых файлов. Затем мигрируй по одному
  379. модулю, после каждого — сборка и тесты.
  380. ```
  381. </details>
  382. <details>
  383. <summary><b>🎨 Вёрстка по макету</b></summary>
  384. ```text
  385. [скриншот] Сверстай этот экран на наших компонентах из @src/ui.
  386. После — сними скриншот через браузерный MCP, сравни с макетом
  387. и исправь расхождения. Повтори, пока не совпадёт.
  388. ```
  389. </details>
  390. <details>
  391. <summary><b>⚡ Производительность</b></summary>
  392. ```text
  393. Эндпоинт /api/report отвечает 4 секунды. Найди узкое место
  394. (N+1, лишние запросы, тяжёлые вычисления), предложи 2–3 варианта
  395. с оценкой выигрыша. Реализуй лучший и замерь до/после.
  396. ```
  397. </details>
  398. <details>
  399. <summary><b>🛡 Аудит безопасности</b></summary>
  400. ```text
  401. Используй субагента: проверь проект на OWASP Top 10 —
  402. инъекции, XSS, хранение секретов, авторизацию на эндпоинтах.
  403. Верни отчёт по критичности. Ничего не исправляй без моего ок.
  404. ```
  405. </details>
  406. <details>
  407. <summary><b>📝 Описание PR и changelog</b></summary>
  408. ```text
  409. По git log main..HEAD и diff напиши описание PR:
  410. зачем, что изменилось, как проверить, риски.
  411. Добавь запись в CHANGELOG.md в нашем формате.
  412. ```
  413. </details>
  414. <details>
  415. <summary><b>🚨 Разбор инцидента</b></summary>
  416. ```text
  417. @incident.log Восстанови хронологию инцидента по логам,
  418. найди первопричину и напиши постмортем: таймлайн, причина,
  419. влияние, что сделать, чтобы не повторилось.
  420. ```
  421. </details>
  422. ## Антипаттерны и как их исправить
  423. | ❌ Ошибка | Почему плохо | ✅ Как правильно |
  424. |---|---|---|
  425. | Одна бесконечная сессия на весь день | Контекст забит старым, ответы хуже | `/clear` между задачами, заметки в файле |
  426. | «Сделай фичу» без плана | Claude уверенно идёт не туда | Plan mode → согласовать → реализовать |
  427. | Нет тестов и проверок | Агент не видит своих ошибок | Тесты, линтер, скриншоты в цикле |
  428. | CLAUDE.md на 500 строк | Важное тонет, тратится контекст | Коротко; детали — в `.claude/rules/` и skills |
  429. | Правила только словами в CLAUDE.md | Иногда игнорируются | Критичное — через hooks и `permissions.deny` |
  430. | `bypassPermissions` «чтобы не спрашивал» | Риск удалить лишнее или слить секреты | Allowlist безопасных команд, песочница |
  431. | Исправлять ошибку третьим сообщением подряд | Контекст засоряется неудачными попытками | `Esc Esc` / `/rewind` и переформулировать |
  432. | Принимать diff не глядя | Тихие баги и лишние изменения | Ревью diff или субагент-ревьюер |
  433. ## Безопасность и разрешения
  434. Каждый вызов инструмента проходит через правила. Порядок проверки: **deny → ask → allow**, запрет всегда сильнее разрешения.
  435. ```mermaid
  436. flowchart LR
  437. T["🛠 Claude хочет<br/>вызвать инструмент"] --> H{"🪝 PreToolUse<br/>hook"}
  438. H -- "exit 2" --> X["⛔ Заблокировано"]
  439. H -- "ок" --> D{"Есть правило<br/>deny?"}
  440. D -- да --> X
  441. D -- нет --> K{"Есть правило<br/>ask?"}
  442. K -- да --> Q["🙋 Спросить вас"]
  443. K -- нет --> A{"Есть правило<br/>allow?"}
  444. A -- да --> OK["✅ Выполнить"]
  445. A -- нет --> Q
  446. Q -- "разрешили" --> OK
  447. Q -- "отказали" --> X
  448. ```
  449. Пример `.claude/settings.json` для команды:
  450. ```json
  451. {
  452. "permissions": {
  453. "allow": [
  454. "Bash(npm run test:*)",
  455. "Bash(npm run lint)",
  456. "Bash(git status)",
  457. "Bash(git diff:*)"
  458. ],
  459. "ask": [
  460. "Bash(git push:*)"
  461. ],
  462. "deny": [
  463. "Read(./.env)",
  464. "Read(./.env.*)",
  465. "Read(./secrets/**)",
  466. "Bash(rm -rf:*)",
  467. "Bash(curl:*)"
  468. ]
  469. }
  470. }
  471. ```
  472. **Чек-лист:**
  473. - секреты закрыты через `deny` и не лежат в CLAUDE.md;
  474. - `git push`, деплой и миграции — только с подтверждением;
  475. - автономные запуски (`-p`, CI, `--dangerously-skip-permissions`) — только в контейнере или песочнице без доступа к проду;
  476. - данные из интернета и MCP — это данные, а не инструкции: следите за промпт-инъекциями;
  477. - перед коммитом — `git diff`, а не «принять всё».
  478. ## Готовые шаблоны
  479. <details>
  480. <summary><b>📄 CLAUDE.md — короткий и рабочий</b></summary>
  481. ```markdown
  482. # Проект: магазин на Next.js + PostgreSQL
  483. ## Команды
  484. - npm run dev — запуск
  485. - npm test — тесты (Vitest), npm run lint — линтер
  486. - npm run db:migrate — миграции (только с подтверждения!)
  487. ## Архитектура
  488. - src/app — роуты, src/lib — бизнес-логика, src/db — доступ к БД
  489. - Вся работа с БД только через src/db, не из компонентов
  490. ## Правила
  491. - TypeScript strict, без any
  492. - Новый код — с тестами, баг — сначала падающий тест
  493. - Не трогать src/legacy без явной просьбы
  494. - Перед завершением задачи: npm test && npm run lint
  495. ```
  496. </details>
  497. <details>
  498. <summary><b>🧰 Skill — повторяемая процедура</b></summary>
  499. `.claude/skills/release-notes/SKILL.md`:
  500. ```markdown
  501. ---
  502. name: release-notes
  503. description: Готовит release notes по коммитам с последнего тега. Используй, когда просят релиз, changelog или заметки к версии.
  504. ---
  505. 1. Найди последний тег: git describe --tags --abbrev=0
  506. 2. Собери коммиты: git log <тег>..HEAD --oneline
  507. 3. Сгруппируй: ✨ Новое, 🐛 Исправления, ⚙️ Внутреннее
  508. 4. Пиши для пользователей, а не для разработчиков
  509. 5. Добавь блок в начало CHANGELOG.md
  510. ```
  511. Вызов: `/release-notes` — или Claude сам подхватит skill по описанию.
  512. </details>
  513. <details>
  514. <summary><b>🔌 MCP — подключение внешних инструментов</b></summary>
  515. ```bash
  516. # Браузер для проверки UI и скриншотов
  517. claude mcp add playwright -- npx @playwright/mcp@latest
  518. # Посмотреть подключённые серверы и их статус
  519. claude mcp list
  520. ```
  521. Общий для команды `.mcp.json` в корне репозитория:
  522. ```json
  523. {
  524. "mcpServers": {
  525. "playwright": {
  526. "command": "npx",
  527. "args": ["@playwright/mcp@latest"]
  528. }
  529. }
  530. }
  531. ```
  532. </details>
  533. <details>
  534. <summary><b>🤖 GitHub Actions — @claude в issues и PR</b></summary>
  535. Самый быстрый способ — выполнить в Claude Code `/install-github-app`. После этого достаточно написать в issue или PR:
  536. ```text
  537. @claude реализуй эту задачу и открой PR
  538. @claude сделай ревью этого PR с фокусом на безопасность
  539. ```
  540. Готовые workflow — в [.github/workflows/](.github/workflows/).
  541. </details>
  542. ## Экономия контекста и денег
  543. | Приём | Эффект |
  544. |---|---|
  545. | `/clear` между задачами | не платите за чужую историю в каждом запросе |
  546. | `/compact` с подсказкой, что сохранить | длинная задача без переполнения |
  547. | Поиск и чтение логов — в субагента | в главный контекст попадает вывод, а не тысячи строк |
  548. | Модель под задачу (`/model`) | сильная — для архитектуры и сложных багов, быстрая — для рутины и поиска |
  549. | `@файл` вместо «найди сам» | меньше лишних чтений |
  550. | Короткий CLAUDE.md, детали — в skills | skill грузится только когда нужен |
  551. | Отключать неиспользуемые MCP-серверы | описания инструментов тоже занимают контекст |
  552. | `/context` и `/cost` | видно, куда уходят токены |
  553. ## Путь к уровню PRO
  554. ```mermaid
  555. flowchart LR
  556. L1["🟢 Новичок<br/>чат и правки по просьбе"] --> L2["🟡 Практик<br/>CLAUDE.md · Plan mode · тесты"]
  557. L2 --> L3["🟠 Продвинутый<br/>skills · hooks · subagents · MCP"]
  558. L3 --> L4["🔴 PRO<br/>worktrees · headless · CI · плагины для команды"]
  559. ```
  560. ## Частые проблемы
  561. | Симптом | Причина | Что сделать |
  562. |---|---|---|
  563. | Claude «забыл» договорённости | контекст сжат или переполнен | вынести в CLAUDE.md, вести `NOTES.md`, `/clear` и начать с плана |
  564. | Игнорирует правило из CLAUDE.md | правило утонуло среди прочего | сократить файл, критичное — в hook или `deny` |
  565. | Ходит по кругу с одной ошибкой | замусоренный контекст | `Esc Esc`, откатиться и дать больше данных: лог, тест, гипотезу |
  566. | Меняет лишние файлы | нет границ в задаче | указать, какие файлы трогать нельзя, работать по плану |
  567. | Постоянно спрашивает разрешения | нет allowlist | `/permissions` или `permissions.allow` в settings |
  568. | MCP-сервер не видно | не запустился или не тот scope | `claude mcp list`, `/mcp`, проверить `.mcp.json` |
  569. | Hook не срабатывает | неверный `matcher` или путь | `/hooks`, запустить скрипт вручную, проверить exit code |
  570. ## Прогресс
  571. Скопируйте в свою заметку или issue и отмечайте:
  572. ```markdown
  573. - [ ] 00 Установка - [ ] 06 Subagents + Лаба 5
  574. - [ ] 01 Промптинг - [ ] 07 Hooks + Лаба 6
  575. - [ ] 02 CLAUDE.md + Лаба 1 - [ ] 08 MCP + Лаба 7
  576. - [ ] 03 Настройки + Лаба 2 - [ ] 09 Плагины
  577. - [ ] 04 Workflow + Лаба 3 - [ ] 10 Headless и CI + Лаба 8
  578. - [ ] 05 Skills + Лаба 4 - [ ] 11 Pro-приёмы (итоговый чек-лист)
  579. ```
  580. ## Структура репозитория
  581. ```
  582. .
  583. ├── course/ # 12 модулей + cheatsheet.md + faq.md
  584. ├── labs/ # 8 лабораторных работ
  585. ├── recipes/prompts.md # библиотека промптов
  586. ├── starter-kit/ # готовая конфигурация для копирования
  587. │ ├── CLAUDE.md .mcp.json
  588. │ └── .claude/
  589. │ ├── settings.json # permissions + hooks + statusLine
  590. │ ├── skills/ # 8 skills
  591. │ ├── agents/ # 5 субагентов
  592. │ ├── hooks/ # 4 hook-скрипта
  593. │ ├── rules/ # правила по путям
  594. │ ├── output-styles/ # режим наставника
  595. │ └── statusline.sh
  596. ├── plugin-example/ # пример плагина
  597. ├── install.sh # установщик starter-kit
  598. ├── scripts/validate.py # проверки (запускаются в CI)
  599. └── .github/workflows/ # @claude, авто-ревью PR, валидация
  600. ```
  601. ## Участие
  602. Нашли устаревшую команду или хотите добавить лабу/шаблон? См. [CONTRIBUTING.md](CONTRIBUTING.md). История изменений — [CHANGELOG.md](CHANGELOG.md).
  603. ## Полезные ссылки
  604. - Документация: https://code.claude.com/docs
  605. - Best practices от Anthropic: https://www.anthropic.com/engineering/claude-code-best-practices
  606. - GitHub Action: https://github.com/anthropics/claude-code-action
  607. > ⚠️ Claude Code быстро развивается. Если команда или поле не работает — сверьтесь с `/help` и официальной документацией и [откройте issue](https://github.com/justxor/claude-code-pro-course/issues/new/choose).
  608. ## Лицензия
  609. [MIT](LICENSE) — используйте, копируйте, адаптируйте.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.