Best Practices 2026

Claude Code

Полное руководство по эффективной работе

CLAUDE.md Skills Rules Memory MCP
Начать изучение
CLAUDE.md
# My Project

## Стек
Python 3.12, FastAPI, PostgreSQL

## Команды
pytest tests/ -v
docker compose up

## Правила
- Не коммитить .env
- Русский в UI, English в коде
00

Что такое Claude Code

AI-ассистент для разработчиков, который живёт в вашем терминале

Claude Code — это официальный CLI-инструмент от Anthropic, который превращает Claude в полноценного напарника по разработке. Он читает ваш код, понимает структуру проекта, пишет и редактирует файлы, запускает команды и работает с внешними сервисами.

Не просто чат-бот. Не просто автокомплит. Это агент, который думает, планирует и действует.

💻

Пишет и редактирует код

Создаёт файлы, рефакторит, фиксит баги, добавляет фичи. Видит весь проект, а не один файл. Понимает контекст и зависимости.

🔎

Исследует кодовую базу

Ищет по файлам, читает код, анализирует архитектуру. Может разобраться в незнакомом проекте за минуты — быстрее, чем вы.

Запускает команды

Тесты, сборка, деплой, git — всё через терминал. Claude сам решает что запустить, анализирует вывод и реагирует на ошибки.

🎓

Помнит ваш проект

CLAUDE.md, Memory, Rules — система долгосрочной памяти. Claude знает ваш стек, правила, стиль и не забывает между сессиями.

🔌

Подключает внешние сервисы

MCP-протокол: трекер задач, почта, БД, мессенджеры — Claude работает с ними напрямую, без копипасты между окнами.

🤖

Запускает подагентов

Параллельные задачи: один агент ищет по коду, другой планирует архитектуру, третий запускает тесты. Всё одновременно.

Что можно делать

Разработка

Писать фичи, фиксить баги, рефакторить, добавлять тесты, генерировать код по описанию

Девопс

Dockerfile, CI/CD, деплой, настройка инфраструктуры, мониторинг, диагностика

Аналитика

SQL-запросы, анализ данных, парсинг, трансформация CSV/JSON, работа с API

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

Боты, скрипты, MCP-серверы, интеграции между сервисами, workflow

Документация

README, API-доки, презентации, PDF-отчёты, сайты — как эта страница

Управление

Задачи в трекере, почта, календарь, отчёты — через MCP без переключения контекста

0%
Применение правил при <200 строках
0%
Экономия токенов с Skills
0
Уровней иерархии памяти
0
Секций идеального CLAUDE.md
01

Что такое CLAUDE.md

Файл инструкций, который Claude Code читает при каждом запуске. Как README, но для ИИ.

📄

Без CLAUDE.md

Claude каждый раз начинает с нуля. Не знает стек, структуру, правила. Приходится объяснять заново.

С CLAUDE.md

Сразу в контексте: знает проект, конвенции, команды. Работает точнее и быстрее с первого сообщения.

💡

Ключевой принцип

Держи <200 строк. Для каждой строки спроси: «Если убрать — Claude будет ошибаться?» Нет — удаляй.

10 секций идеального CLAUDE.md

1
Project Overview
Что за проект — 1-2 предложения
2
Tech Stack
Языки, фреймворки, библиотеки
3
Architecture
Структура папок, паттерны
4
Coding Rules
Именование, стиль, импорты
5
File Naming
Конвенции именования файлов
6
Testing
Как запускать тесты, фреймворк
7
Build/Run
Команды запуска и сборки
8
Key Files
Точки входа, конфиги
9
Git Conventions
Ветки, формат коммитов
10
Known Gotchas
Что Claude часто делает не так

Правило 200 строк

Чем короче CLAUDE.md, тем точнее Claude следует правилам

92%
82%
71%
45%
02

Иерархия памяти

5 уровней, которые комбинируются, а не заменяют друг друга

~/.claude/CLAUDE.md
Глобальный
Все проекты, все сессии. Кто вы, язык, стиль, карта проектов.
./CLAUDE.md
Проект (корень)
Загружается при запуске. Коммитится в git. Структура, стек, правила.
./CLAUDE.local.md
Личный
Ваши override-ы. Не коммитится (gitignored). Личные привычки.
./sub/CLAUDE.md
Подпапка
Lazy loading — грузится когда Claude читает файлы из этой папки.
.claude/rules/*.md
Rules
Модульные правила по path-паттернам. Автоматически по папке/файлу.
03

Skills — рецепты по запросу

Загружаются только когда нужны. Экономия до 80% токенов.

CLAUDE.md
Загружается ВСЕГДА
  • Структура проекта
  • Ключевые правила
  • Стек технологий
Расходует токены постоянно
VS
Skills
Загружается ПО ЗАПРОСУ
  • /deploy-amvera
  • /new-mcp-server
  • /career-update
Экономия до 80% токенов!

Формат SKILL.md

.claude/skills/deploy-amvera/SKILL.md
---
name: deploy-amvera
description: Деплой сервера на Amvera. Использовать
  когда пользователь просит задеплоить.
---

# Деплой на Amvera

## Шаги
1. Проверить amvera.yaml
2. git push amvera main:master
3. Проверить статус в панели

## Правила
- ВСЕГДА master, не main!
- amvera.yaml, не .yml!
- Не коммитить .env

Когда что использовать

CLAUDE.md Rules Skills
Когда загружаетсяВсегдаПо path-паттернуПо запросу
НазначениеСтандарты проектаПравила для папокWorkflow / рецепты
Кто вызываетАвтоматическиАвтоматическиПользователь или Claude
Расход токеновПостоянныйУмеренныйМинимальный
Пример"Не коммить .env""В tests/ — pytest"/deploy, /review-pr
04

MCP — внешние инструменты

Model Context Protocol подключает Claude к вашим рабочим сервисам

Yandex Tracker
Gmail
PostgreSQL
Telegram
Wiki
Bitrix24
Calendar
Custom API

Подключение MCP-сервера

.mcp.json
{
  "mcpServers": {
    "yandex": {
      "command": "python3",
      "args": ["servers/yandex/server.py"]
    },
    "gmail": {
      "command": "python3",
      "args": ["servers/gmail/server.py"]
    }
  }
}

stdio (локальный)

Быстрый запуск через процесс. Идеален для разработки.

HTTP/SSE (удалённый)

Для продакшена. Деплой на Amvera, VPS, облако.

FastMCP SDK

Python SDK для создания своих MCP-серверов за минуты.

05

Советы и горячие клавиши

Приёмы, которые ускорят вашу работу

Shift+Tab

Plan Mode

Переключает в режим планирования. Claude продумает архитектуру, прежде чем писать код.

Escape

Прервать

Если Claude пошёл не туда — прерви и скорректируй направление. Не трать токены впустую.

/compact

Сжать контекст

Когда контекст раздувается — сожми, чтобы сэкономить токены и сохранить фокус.

/init

Создать CLAUDE.md

Автогенерация CLAUDE.md по текущему проекту. Отличная отправная точка.

/model

Сменить модель

Opus для сложного, Sonnet для быстрого, Haiku для простых вопросов.

@ файл

Прикрепить файл

Явно укажи файл для контекста: @src/main.py — Claude прочитает его.

Продвинутые приёмы

🤖

Подагенты

Claude запускает подагентов для параллельных задач: Explore для поиска, Plan для архитектуры.

🌳

Worktree

Агент работает в изолированной git-ветке. Безопасно для экспериментов.

🧠

Memory

Долгосрочная память между сессиями: user, feedback, project, reference.

Hooks

Shell-команды на события: автоформатирование, линтер перед коммитом.

06

Практика

Упражнения для самостоятельного тестирования

Level 1

Базовый

Level 2

Средний

Level 3

Продвинутый

Чеклист проекта

07

Ресурсы

08

Об авторе

Викентий Жеребов

Викентий Жеребов

Lead Automation Engineer

Системный практик с инженерным мышлением. Строю инфраструктуру автоматизации лидогенерации в HR/рекрутинге, разрабатываю MCP-серверы для Claude, деплою в Kubernetes и облако. Превращаю хаос в порядок, рутину — в автоматизацию, а разрозненные инструменты — в единую рабочую систему.

Чем занимаюсь

  • Автоматизация лидогенерации в массовом рекрутинге (Авито, HH, РаботаРу)
  • MCP-серверы для Claude — Yandex Tracker, Gmail, Wiki, Telegram
  • Python-боты, ZennoPoster, браузерная автоматизация
  • Деплой через ArgoCD/Helm в Kubernetes, Amvera
  • Архитектура отказоустойчивости (failover, семафоры)
  • SQL-аналитика, BI-мониторинг (Grafana)

Суперсилы

  • Вижу систему целиком — от SQL-запроса до бизнес-процесса
  • Перевожу хаос в структуру и автоматизацию
  • Работаю на стыке: рекрутинг + AI + данные + DevOps
  • Связываю разрозненные инструменты в единый workflow
  • Довожу до прикладного результата, а не до прототипа

Стек

Core
Python SQL PostgreSQL
DevOps
Kubernetes Docker ArgoCD Helm
AI & API
Claude Code MCP SDK FastAPI n8n
Интеграции
Yandex API Gmail API Telegram Avito API HH API
Автоматизация
ZennoPoster Grafana Bitrix24