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 выигрывает, где уступает и как выбирать инструмент под задачу. ›

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. Когда платить за более сильную модель, а когда хватит быстрой. ›

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 в строительный блок скриптов и пайплайнов. ›

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 или хук Решающая матрица: какой механизм расширения под какую задачу. Разбор пересечений и типичных ошибок выбора на практических сценариях. ›

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. Паттерны, безопасность доступа и типичные подводные камни. ›

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 там, где работает команда. ›

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, подсчёт токенов и практики снижения стоимости. Как сделать продакшн-нагрузку дешевле в разы. ›

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 и субагентов. Как агент помогает приручить наследие и масштаб. ›