Claude Code PRO — русскоязычный курс и готовая конфигурация

Claude Code умеет читать проект, запускать тесты, править код и делать коммиты. Но чтобы он работал хорошо, его нужно настроить: объяснить правила проекта, разрешить безопасные команды, запретить опасные, вынести повторяющиеся процедуры в skills. Это неочевидная работа, и на ней чаще всего спотыкаются.

Репозиторий justxor/claude-code-pro-course — это готовый курс на русском языке из 12 модулей. Вместе с теорией там лежит starter-kit с конфигурацией, которая ставится в проект одной командой.

Что внутри

Быстрый старт

Установка Claude Code:

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# или через npm
npm install -g @anthropic-ai/claude-code

Дальше ставим starter-kit в свой проект:

git clone https://github.com/justxor/claude-code-pro-course.git
bash claude-code-pro-course/install.sh ~/path/to/my-project
cd ~/path/to/my-project && claude

Внутри сессии полезно сразу посмотреть, что загрузилось, и запустить skill из starter-kit:

/context          # что загружено в контекст
/onboard          # skill из starter-kit: обзор проекта

Программа курса

Материалы лежат в репозитории: программа курса, лабораторные работы.

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

Главная мысль курса: не всё нужно класть в одно место. У Claude Code три уровня настроек плюс плагины.

Дальше из этой таблицы легко выбирается инструмент под задачу:

Рабочий цикл

Базовый цикл, который авторы рекомендуют: сначала изучить код, потом составить план, и только потом писать код.

1. EXPLORE   > прочитай src/billing/ и объясни, как считается скидка. Код пока не меняй.
2. PLAN      [Shift+Tab → plan mode] > составь план добавления промокодов
3. CODE      > реализуй план. После каждого шага запускай тесты.
4. COMMIT    > сделай коммит и открой PR с описанием

Plan mode включается через Shift+Tab или флагом. В этом режиме Claude только читает код и предлагает план. План можно поправить до того, как написана хоть строка кода.

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

Управление контекстом

Контекстное окно — ограниченный ресурс. Чем полнее оно забито, тем хуже Claude следует инструкциям.

Отдельная статья расходов — субагенты на Haiku для поиска. Исследование не требует дорогой модели, а контекст основной сессии остаётся чистым.

Starter-kit

Готовая конфигурация, которая ставится одной командой. Внутри:

• 8 skills: code-review, commit, fix-issue, onboard, pr-description, refactor, release-notes, write-tests
• 5 субагентов: architect, code-reviewer, debugger, docs-writer, test-runner
• 4 hook-скрипта: format-on-edit.sh, notify.sh, protect-files.sh, session-context.sh
• правила по путям в .claude/rules/, statusline, режим наставника в output styles

Skills и субагенты — обычные файлы с YAML-шапкой, поэтому их легко править под себя.

---
name: my-skill
description: Что делает. Когда использовать.
allowed-tools: Read, Grep
---
Инструкции... $ARGUMENTS

---
name: reviewer
description: Используй проактивно после изменений кода
tools: Read, Grep, Glob, Bash
model: sonnet
---
Системный промпт агента...

Hooks выглядят так. Скрипт, который вышел с кодом 0, ничего не делает, а с кодом 2 блокирует действие и показывает Claude текст из stderr:

"hooks": { "PostToolUse": [ { "matcher": "Edit|Write",
  "hooks": [ { "type": "command", "command": "./.claude/hooks/fmt.sh" } ] ] } }

Разрешения описываются тремя списками. Важно: deny побеждает allow.

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

Библиотека промптов

Отдельный файл — библиотека промптов. Это готовые формулировки для 13 типов задач: онбординг в незнакомом коде, планирование, отладка, тесты, рефакторинг, ревью, git и PR, фронтенд, работа с базой, документация, производительность, безопасность.

Несколько характерных примеров:

[plan mode] Мне нужно <задача>. Изучи релевантный код и предложи 2–3 варианта
реализации с плюсами и минусами и оценкой риска. Рекомендуй один. Код не пиши.

Сделай ревью `git diff main...HEAD` как строгий senior: баги, граничные случаи,
безопасность, тесты, читаемость. Формат: 🔴/🟡/🟢, файл:строка,
проблема → исправление. Не придумывай проблем.

Проанализируй эту сессию: какие правила стоит добавить в CLAUDE.md, чтобы в
следующий раз ты не делал тех же ошибок? Предложи изменения, не применяй.

Типичные проблемы

FAQ в репозитории собирает самые частые ситуации. Коротко:

Главные принципы

Авторы курса собрали шесть правил, к которым сводится всё остальное.

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

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

Для запусков без человека есть claude -p и режим headless с JSON-выводом. В репозитории есть пример настройки GitHub Actions: упоминание @claude в issues и PR плюс автоматическое ревью.

claude -p "..." --output-format json
claude --allowedTools "Read,Bash(npm test:*)"

Для параллельной работы над разными задачами авторы предлагают git worktrees: у каждой задачи своя копия репозитория и своя сессия Claude, конфликтов нет.

Ссылки

• Шпаргалка — клавиши, слаш-команды, CLI, файлы, разрешения, hooks, skills, субагенты
• FAQ — поведение Claude, разрешения, skills, hooks, MCP, деньги
• Документация Claude Code
• Best practices от Anthropic
• GitHub Action

Репозиторий под лицензией MIT: можно копировать и адаптировать. Автор предупреждает, что Claude Code развивается быстро — если команда не работает, сверяйтесь с /help и официальной документацией.