Claude Code — практическое руководство от создателей в Anthropic

С чего начать новичку: Q&A по кодовой базе

Главная рекомендация Бориса: первый день после установки Claude Code не пиши код. Спрашивай.

Что именно спрашивать в новой кодовой базе

1. «Объясни, как работает X». Модуль, класс, фича, эндпоинт. Claude прочитает код и расскажет, не «как написать вики», а так, как объяснил бы коллега за 10 минут разговора.
2. «Какие пакеты тут используются и зачем». Это раньше занимало день — почитать каждый README. Сейчас один вопрос.
3. «Почему у этой функции 15 аргументов?» Claude посмотрит git history, увидит, кто и когда добавлял каждый аргумент, в каком контексте. Это та информация, которую обычно можно достать только из голов авторов.
4. «В чём разница между этими двумя реализациями?» Часто в больших репо есть «старая» и «новая» версия одного и того же. Claude разберёт обе и скажет, что использовать.

Важно: модель сама знает про git history

В Claude Code нет ни строчки в system prompt, заточенной под git. Модель просто понимает, что «git history» — это команда, которую можно запустить, и сама её выполняет, когда видит такой вопрос. Это часть того, что Anthropic называют «модель достаточно умная».

Что НЕ делать в первый день

Не давай Claude сразу команду «напиши большую фичу». Это распространённая ошибка: начинать сразу с агентного кодинга, не разобравшись с базой. Сначала калибровка — что модель знает, что не знает, где её надо подкармливать контекстом, где она и так справляется. Q&A-режим даёт эту калибровку дёшево и быстро.

Хочешь больше готовых ИИ-агентов?

В Hamster Club есть библиотека агентов и бесплатный ИИ-агент для участников.

CLAUDE.md — память между сессиями

Дальше — контекст. Чем больше у Claude качественного контекста о твоей кодовой базе, тем умнее его решения. CLAUDE.md — основной механизм передачи этого контекста.

Четыре слоя CLAUDE.md

1. Project root. Файл CLAUDE.md в корне репо. Коммитится в git. Подгружается автоматически в каждой сессии. Это общая память команды.
2. Local. Файл .claude.local.md (или подобный — зависит от настройки). НЕ коммитится в source control. Твои личные заметки, локальный путь к python-окружению, и т.п.
3. Nested. CLAUDE.md в подпапках. Подтягивается автоматически, когда Claude работает в этой части кодовой базы. Удобно для монорепо: разные CLAUDE.md в разных сервисах.
4. Enterprise. Глобальный CLAUDE.md от админа компании. Распространяется на все проекты всех сотрудников. Для корпоративных стандартов и compliance-правил.

Что класть в CLAUDE.md

• Часто используемые bash-команды: make test, docker compose up -d, ./scripts/deploy.sh staging.
• Список MCP-серверов и их назначение (если уже не в .mcp.json).
• Важные архитектурные решения: «мы используем event sourcing», «вся работа с БД через repository pattern», «миграции только через alembic».
• Список ключевых файлов: «src/core/engine.py — главный класс, не модифицировать без обсуждения».
• Особенности стиля кода, тестов, линтинга.
• Сленг и аббревиатуры команды (если такие есть и важны).

Не делай CLAUDE.md свалкой

CLAUDE.md грузится в каждую сессию. Каждая строка стоит токенов в каждом запросе. Если впихнуть туда всю архитектуру, всю историю компании и все известные баги — половина контекста уйдёт на это, и работа замедлится. Правило: оставь только то, что нужно практически всегда. Детали — в nested CLAUDE.md в подпапках, или в обычных .md-файлах в репо, которые Claude всё равно прочитает по запросу.

Терминал-фишки: 4 хоткея, которые экономят часы

Терминал — это очень минималистичный интерфейс. Чтобы Claude Code был удобным, в нём есть несколько неочевидных горячих клавиш.

Shift + Tab — auto-accept edits

Переключает режим: вместо «спрашивать перед каждой правкой файла» → «применять правки автоматически». Использовать, когда уверен в Claude — например, при итерациях по unit-тестам, где модель ходит туда-сюда. Один раз нажал — и не мешаешь работе.

# — попросить Claude запомнить

Печатаешь решётку, потом — что запомнить. Например: # важно: миграции БД всегда через alembic, никогда напрямую SQL. Claude добавит это в CLAUDE.md (или предложит — куда именно). Дешёвый способ накапливать память по ходу работы, а не запоминать «надо обновить CLAUDE.md».

! — bash-режим внутри Claude

Печатаешь восклицательный знак, потом — bash-команду. Claude её выполнит, и результат попадёт в контекст текущей сессии. Удобно для долгих команд (запустил тест, увидел вывод, Claude видит вывод, можно сразу спросить «почему упало»).

Esc — отмена без потери сессии

Если Claude делает что-то не то — нажми Esc. Действие прервётся, но сессия и её контекст сохранятся. Не нужно рестартить, не нужно объяснять всё заново. Просто отмена + новый промпт с корректировкой.

5 паттернов, которые меняют скорость работы

Сводная карта подходов из воркшопа Бориса — что использовать, когда задача больше «допиши строчку».

4 готовых шаблона для старта

Скопировать, заменить переменные в {{double_braces}} и положить в репо.

# Project: {{project_name}}

## Архитектура
- {{краткое описание стека и слоёв}}
- Основные модули: {{список}}

## Bash-команды (часто используемые)
```
make test       # запустить unit-тесты
make build      # сборка production
docker compose up -d  # локальное окружение
```

## MCP-серверы
- См. `.mcp.json` в корне репо — подтягиваются автоматически.

## Правила стиля
- Языки: {{python 3.11+, типы обязательны}}
- Тестирование: {{pytest + coverage ≥ 80%}}
- Линтер: {{ruff, конфиг в pyproject.toml}}

## Важные файлы
- `src/core/engine.py` — главный движок, не трогать без обсуждения
- `migrations/` — только через `alembic revision`

---
description: "Review PR — посмотри last commit, найди проблемы, оформи комментарии"
---

Прочитай последние изменения через git diff HEAD~1.
Найди потенциальные баги, нарушения стиля проекта (см. CLAUDE.md),
проблемы безопасности (SQL injection, hardcoded secrets, XSS).

Для каждой проблемы:
1. Укажи файл и строку.
2. Объясни проблему.
3. Предложи конкретную правку.

Не предлагай косметику — только то, что реально важно.

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres",
               "postgresql://localhost:5432/myapp_dev"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem",
               "/path/to/allowed/dir"]
    }
  }
}

# Анализ git-status через Claude
git status --porcelain | claude -p \
  "Какие из этих изменений потенциально опасны? Только список файлов." \
  --output-format json | jq -r '.result'

# Поиск аномалий в логах
gcloud logging read 'severity>=ERROR' --limit 100 | \
  claude -p "Выдели топ-3 типа ошибок и их вероятные причины"

# В CI: автоматический changelog
git log --since="last week" --oneline | claude -p \
  "Сгруппируй коммиты в changelog: Added / Changed / Fixed" \
  > CHANGELOG.next.md

Часто спрашивают

Чем Claude Code отличается от Claude.ai в браузере?

Claude.ai — это чат-интерфейс в браузере для общих задач: переписка, написание текстов, разбор файлов. Claude Code — это агентный CLI-инструмент специально для разработки: он живёт в твоём терминале, имеет прямой доступ к файлам проекта, может запускать команды, читать git history, делать коммиты. Они дополняют друг друга: Claude.ai — для разговоров, Claude Code — для работы в репозитории.

Нужен ли VS Code или другой IDE? Можно ли без него?

Claude Code работает в любом терминале — VS Code, JetBrains, Xcode, vim, emacs, обычный SSH в tmux. Терминал — общий знаменатель. По словам Бориса, в Anthropic люди используют все эти варианты, и Claude Code сделан так, чтобы интегрироваться в любой существующий workflow без переучивания. Отдельный IDE не нужен.

Безопасно ли давать Claude Code доступ к терминалу?

Anthropic вложили много работы в «safe bash»: статический анализ команд, разные уровни одобрения для разных операций, sandbox в development containers. Для каждой команды модель решает — нужно подтверждение или нет, и можно настраивать правила в settings. Это компромисс между безопасностью и продуктивностью: подтверждать каждую `ls` смысла нет, а на `rm -rf` — нужно остановиться. Полная документация — в anthropic.com/security.

Что класть в CLAUDE.md?

По словам Бориса — частые bash-команды, MCP-инструменты, архитектурные решения, важные файлы. Главное правило: ДЕРЖИ КОРОТКИМ. Длинный CLAUDE.md съест контекст и замедлит работу. Если нужно много контекста — раскидай по nested CLAUDE.md в подпапках, они подтянутся только когда Claude работает в этой части кода.

Что такое slash commands и MCP, нужны ли они мне?

Slash commands — твои собственные команды в Claude Code (типа /review-pr, /deploy-staging). Файлы в `.claude/commands/<имя>.md` в репо. MCP (Model Context Protocol) — это способ подключить к Claude внешние инструменты: базы данных, Playwright, файловые системы, корпоративные API. Конфиг в `.mcp.json`. Если работаешь один — можно без них. Если в команде — оба ОЧЕНЬ ускоряют общую продуктивность.

Можно ли запускать Claude Code в CI и в скриптах?

Да, через SDK: `claude -p "твой промпт" --output-format json`. Это превращает Claude в unix-утилиту: pipe-ишь данные на вход, получаешь JSON на выход. В Anthropic используют это в CI для автоматических ревью, обработки логов через gcloud/sentry CLI, в bug-репортере. Поддерживаются JSON и streaming-JSON форматы — годится для долгих задач с прогрессом.

Сколько сессий можно держать параллельно?

Технически — сколько вытянет машина. По факту у Бориса Черни ~10-15 одновременных сессий: терминалы в tmux, мобильные сессии, браузерные. Для изоляции работы используют git worktrees — несколько чекаутов одного репо в разных папках, каждый со своей сессией. Anthropic активно дорабатывает удобство параллельной работы — это направление развития.

Где официальная документация по Claude Code?

Документация: docs.anthropic.com/en/docs/claude-code. Бесплатные курсы — Anthropic Academy (anthropic.skilljar.com): Claude Code 101 и Claude Code in Action. Сайт с 89 тэками от самого Бориса Черни — howborisusesclaudecode.com. Видео-воркшоп с AI Engineer Summit — на YouTube («Claude Code and the Evolution of Agentic Coding»).

Главное

1. Начни с Q&A. Первые дни — вопросы, не код. Это формирует калибровку: что модель умеет, где надо помогать.
2. План до кода. Brainstorm → plan → approval → code. На больших задачах разница принципиальная.
3. CLAUDE.md — но коротко. Память между сессиями — мощный приём, но длинный CLAUDE.md съест контекст.
4. Slash + settings + MCP — для команды. Один человек настраивает, остальные получают через git pull.
5. SDK + параллель — для масштаба. Claude как unix-утилита: pipe-ишь, скриптуешь, держишь 10 сессий одновременно.

Читайте также: полный гайд по Claude (чат) · AI-автоматизации для бизнеса · 30 способов заработать на нейросетях · Hamster Club