Фундамент Claude Code

1 Что такое Claude Code: агентный кодинг в терминале Определение, краткая история продукта, понятие агентного цикла и Unix-философия композируемости. Чем агент отличается от обычного чат-ассистента и почему это меняет рабочий процесс.

2 Установка, поверхности и окружения Способы установки (native, Homebrew, WinGet, npm), четыре поверхности (Terminal, VS Code, JetBrains, Desktop, Web) и единый движок между ними. Аутентификация и сторонние провайдеры моделей: Bedrock, Vertex AI, Foundry.

3 Интерактивный режим и навигация по сессии REPL Claude Code изнутри: горячие клавиши, @-упоминания файлов, шорткат # для памяти, вставка изображений, переключение режимов. Как эффективно вести длинную сессию.

4 Модель разрешений, безопасность и доверие Режимы разрешений (default, acceptEdits, plan, bypassPermissions), правила allow/deny, песочница и риски prompt injection. Как давать агенту ровно столько свободы, сколько нужно.

5 Claude Code среди альтернатив Позиционирование относительно Cursor, Aider, GitHub Copilot, OpenAI Codex CLI и Gemini CLI: где Claude Code выигрывает, где уступает и как выбирать инструмент под задачу.

2

Контекст, память и конфигурация

6 CLAUDE.md и система памяти Иерархия файлов памяти (enterprise/project/user), авто-память, импорты через @path и шорткат #. Как писать CLAUDE.md, который реально улучшает поведение агента.

7 Управление контекстным окном Контекстное окно как ресурс: /clear, /compact, /rewind, авто-компакт и бюджет токенов. Практики гигиены контекста для долгих и сложных задач.

8 Настройки и иерархия конфигурации settings.json на уровнях user, project, local и enterprise, переменные окружения и правила приоритета. Как настроить разрешения, инструменты и поведение команды под проект.

9 Выбор модели и режимы мышления Семейство Opus/Sonnet/Haiku, переключение через /model и extended thinking. Когда платить за более сильную модель, а когда хватит быстрой.

3

Рабочие процессы и best practices

10 Типовые рабочие процессы: исследование, план, реализация Паттерн explore → plan → code → commit и его вариации. Как ставить задачу так, чтобы агент сначала понял кодовую базу, а потом действовал.

11 Плановый режим и разработка через тесты Плановый режим для безопасного проектирования изменений и TDD-петля с верификацией результата. Как использовать тесты как контур обратной связи для агента.

12 Best practices и паттерны организации кода Официальные рекомендации Anthropic: дисциплина контекста, настройка CLAUDE.md, декомпозиция задач и мульти-агентные паттерны. Что отличает опытного пользователя от новичка.

13 Git, коммиты и пул-реквесты Работа Claude Code с git: стейджинг, осмысленные коммиты, ветки, пул-реквесты, worktrees и разрешение конфликтов. Как встроить агента в командный git-процесс.

14 Headless-режим и скриптинг через CLI Неинтерактивный запуск claude -p, форматы вывода json и stream-json, пайпы и композиция с другими утилитами. Как превратить Claude Code в строительный блок скриптов и пайплайнов.

4

Расширяемость: команды, навыки, субагенты, хуки

15 Слэш-команды: встроенные и кастомные Встроенные команды и создание собственных в .claude/commands: frontmatter, аргументы, переиспользование промптов. Самый лёгкий способ кодифицировать повторяющийся запрос.

16 Субагенты и контекстная изоляция Субагенты как изолированные экземпляры с собственным контекстом, их описание в .claude/agents, параллельный запуск и команды агентов. Когда делегирование подзадачи окупается.

17 Skills — переносимые навыки Agent Skills: структура SKILL.md, progressive disclosure, вложенные скрипты и файлы. Как упаковать экспертизу так, чтобы она подгружалась только при необходимости.

18 Hooks — события жизненного цикла Хуки как детерминированные shell-команды на событиях PreToolUse, PostToolUse, Stop, SessionStart и др. Автоформат, линт-гейты и аудит действий агента.

19 Plugins и marketplace Плагин как версионируемый бандл из команд, субагентов, навыков, хуков и MCP-серверов; манифест plugin.json и публикация в marketplace. Канонический способ делиться расширениями.

20 Output styles и статусная строка Настройка стиля вывода и кастомной statusline. Мелкая, но влияющая на удобство персонализация интерфейса агента.

21 Что выбрать: команда, навык, субагент, MCP или хук Решающая матрица: какой механизм расширения под какую задачу. Разбор пересечений и типичных ошибок выбора на практических сценариях.

5

MCP и интеграции с внешними инструментами

22 Model Context Protocol: архитектура и основы MCP как открытый стандарт: клиент-серверная модель, примитивы tools/resources/prompts, история и место в экосистеме. Почему протокол не привязан к Claude Code.

23 Подключение MCP-серверов в Claude Code Команда claude mcp add, скоупы local/project/user, файл .mcp.json, транспорты stdio/SSE/HTTP и OAuth для удалённых серверов. Как безопасно подключить готовый сервер к проекту.

24 Создание собственного MCP-сервера Сборка сервера на FastMCP и SDK (Python/TypeScript), экспонирование инструментов и ресурсов, отладка через MCP Inspector, подход code execution with MCP. От идеи интеграции до рабочего сервера.

25 Практика: GitHub, базы данных и веб-API через MCP Разбор реальных интеграций: GitHub, Postgres и другие БД, произвольные веб-API. Паттерны, безопасность доступа и типичные подводные камни.

6

Облачные агенты, автоматизация и CI/CD

26 GitHub Actions и автоматический code review claude-code-action как обёртка над Agent SDK: триггер @claude, установка через /install-github-app, секреты и автоматический ревью пул-реквестов. Агент в вашем CI-раннере.

27 GitLab CI/CD и headless-автоматизация Запуск Claude Code в GitLab-пайплайнах и других CI через headless-режим. Паттерны автоматизации задач сборки, ревью и рутинных правок.

28 Облачные агенты: web, routines и фоновые задачи Claude Code on the web, routines на инфраструктуре Anthropic, фоновые агенты в agent view и /loop. Запуск длительных и периодических задач без участия вашей машины.

29 Динамические workflows и оркестрация агентов Команды агентов, ведущий агент и распределение подзадач, динамические workflows. Как собирать многоагентные конвейеры для крупных задач.

30 Интеграции с командой: Slack, Chrome и удалённое управление Маршрутизация задач из Slack в PR, браузерная автоматизация через Chrome, remote control и channels (Telegram, Discord, webhooks). Claude Code там, где работает команда.

7

Программный доступ: Agent SDK и Claude API

31 Claude Agent SDK: программная сборка агентов Обзор Agent SDK (TypeScript/Python), функция query(), управление оркестрацией, доступом к инструментам и разрешениями. Связь SDK с движком Claude Code и GitHub Action.

32 Claude API и Anthropic SDK: основы Messages API, семейство моделей и их идентификаторы, ценообразование и официальные SDK. Базовый фундамент любого программного обращения к Claude.

33 Tool use, MCP и потоковая передача в API Определение инструментов и цикл tool use, подключение MCP-серверов на уровне API, streaming-ответы. Как дать собственному приложению агентные способности.

34 Промпт-кэширование, батчи и оптимизация затрат Prompt caching (экономика записи и чтения кэша), batch API, подсчёт токенов и практики снижения стоимости. Как сделать продакшн-нагрузку дешевле в разы.

8

Применение в предметных областях

35 Веб-разработка и отладка фронтенда Цикл build → test → debug без переключения контекста: Claude in Chrome и Chrome DevTools MCP (DOM, console, network), способы подключения браузера. Агент как помощник фронтендера.

36 Данные, SQL и аналитика Работа с базами данных через MCP, генерация и проверка SQL, поддержка Jupyter-ноутбуков и разведочного анализа. Паттерны для дата-инженеров и аналитиков.

37 ML-эксперименты и работа с пайплайнами Применение Claude Code в ML: подготовка данных, прогон экспериментов, ведение пайплайнов и воспроизводимость. Где агент ускоряет исследовательский цикл, а где требует надзора.

38 Легаси-код, рефакторинг и большие кодовые базы Навигация по незнакомому и большому коду, безопасный рефакторинг, онбординг через CLAUDE.md и субагентов. Как агент помогает приручить наследие и масштаб.

Claude Code: справочник разработчика

Содержание