Agents в Claude Code: отправляем помощников за работой

Что такое Agent простыми словами

Представьте: вы готовите запуск нового продукта. Нужно сделать лэндинг, написать посты для соцсетей и подготовить email-рассылку. Можно делать всё по очереди — сначала лэндинг, потом посты, потом рассылку. Но это долго.

А можно отправить трёх помощников: один делает лэндинг, другой пишет посты, третий готовит рассылку. Каждый работает параллельно, каждый занят своим делом. Вы получаете результаты от всех троих.

Именно так работают агенты в Claude Code.

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

Зачем отдельный контекст:

• Не засоряет ваш диалог. Агент может перечитать сотни файлов — вы этого не увидите, только итог.
• Может работать параллельно. Несколько агентов работают одновременно.
• Можно ограничить. Одному агенту разрешить только читать файлы, другому — ещё и редактировать.

---

Встроенные агенты

Claude Code уже имеет встроенных агентов. Вы их не создаёте — Claude сам решает, когда их использовать.

| Агент | Модель | Что делает | |-------|--------|------------| | Explore | Haiku (быстрая) | Ищет файлы и код в проекте. Только чтение — ничего не меняет | | Plan | Та же, что у вас | Исследует проект для составления плана. Только чтение | | General-purpose | Та же, что у вас | Сложные задачи: и чтение, и изменение файлов |

Например, когда вы просите Claude "найди, где в проекте обрабатываются платежи" — он запустит агента Explore, который быстро просканирует проект и вернёт ответ. Ваш диалог останется чистым.

Подсказка: Помимо встроенных, вы можете создавать своих агентов — под свои задачи.

---

Из чего состоит Agent

Агент — это Markdown-файл с YAML frontmatter. Похоже на скилл, но поля другие:

---
name: landing-page-builder
description: Пишет лэндинги для запуска продуктов. Используй когда нужен текст и структура лэндинга.
tools: Read, Write, Edit, Bash, Grep, Glob
model: sonnet
---

Ты пишешь лэндинги для запуска продуктов.

Когда получаешь задачу:
1. Изучи описание продукта
2. Определи целевую аудиторию
3. Создай структуру лэндинга: hero, проблема/решение, преимущества, отзывы, CTA
4. Напиши текст для каждого блока
5. Сохрани результат в файл

Всё между --- — frontmatter (настройки агента). Всё после — системный промпт (инструкция, которую агент получает при запуске).

Ключевые поля frontmatter

| Поле | Обязательно | Что делает | |------|:-----------:|------------| | name | Да | Уникальное имя агента (латиница и дефисы) | | description | Да | Описание для Claude: когда использовать этого агента. Claude читает это описание и решает, нужно ли делегировать задачу | | tools | Нет | Какие инструменты доступны агенту. Если не указано — агент наследует все инструменты из основного диалога | | model | Нет | Какую модель использовать: haiku, sonnet, opus или inherit (та же, что у вас). По умолчанию — inherit | | skills | Нет | Скиллы, которые агент получит при запуске | | mcpServers | Нет | MCP-серверы, доступные агенту — для работы с внешними сервисами |

Важно: Поле description — самое важное. Именно по нему Claude решает, когда запускать агента. Пишите конкретно: "Пишет лэндинги для запуска продуктов" лучше, чем "Полезный агент".

Есть более продвинутые поля — подробнее о них можно прочитать в документации.

---

Где хранятся агенты

Как и скиллы, агенты могут быть проектными или персональными.

Проектные агенты доступны только в этом проекте. Персональные агенты — во всех проектах, где вы откроете Claude Code.

| Тип | Где лежит | Когда использовать | |-----|-----------|-------------------| | Проектные | В папке проекта: .claude/agents/имя-агента.md (например, my-project/.claude/agents/landing-page-builder.md) | Агент нужен только в этом проекте | | Персональные | В домашней папке компьютера: ~/.claude/agents/имя-агента.md | Агент нужен во всех проектах |

---

Создаём своего первого агента: пошагово

Создадим агента, который будет верстать лэндинги для запуска продуктов.

Способ 1: через /agents

В Claude Code есть встроенный интерфейс для управления агентами. Напишите:

/agents

Откроется список всех агентов. Выберите Create new agent:

1. Выберите, где сохранить агента: Project (только этот проект) или Personal (все проекты):

2. Выберите Generate with Claude — это лучший вариант для начала. Claude сам напишет системный промпт на основе вашего описания — получится подробнее и качественнее, чем писать вручную. Появится поле "Describe what this agent should do and when it should be used". Опишите своего агента — чем подробнее, тем лучше результат:

3. Выберите инструменты. Это то, что агент умеет делать: читать файлы, редактировать, выполнять команды в терминале, использовать MCP. Если не уверены — оставьте все:

4. Выберите модель. Для создания лэндингов подойдёт Sonnet или Opus:

5. Выберите цвет. Он помогает отличать агентов в интерфейсе — когда агент работает, его имя подсвечивается выбранным цветом:

6. Настройте память. По умолчанию агент забывает всё после завершения задачи. Если включить память — агент будет сохранять заметки о проекте и использовать их в следующих сессиях. Для начала можно выбрать None, а включить позже:

7. Проверьте и сохраните. Claude покажет итоговую карточку: имя, путь, инструменты, модель, описание и системный промпт. Нажмите s или Enter для сохранения. Если хотите отредактировать — нажмите e:

Готово! Агент создан и готов к работе. После сохранения агент сразу появится в списке /agents.

Способ 2: попросить Claude

Можно просто попросить Claude:

Проектный агент:

Создай в моем проекте агента для написания лэндингов.
Он должен изучать описание продукта, определять аудиторию
и создавать полный текст лэндинга с hero, проблемой, преимуществами и CTA.

Персональный агент:

Создай мне персонального (на уровне пользователя) агента для написания лэндингов.
Он должен изучать описание продукта, определять аудиторию
и создавать полный текст лэндинга с hero, проблемой, преимуществами и CTA.

Claude сам придумает имя, подберёт инструменты и создаст файл агента. После создания перезапустите Claude Code: /exit → claude.

---

Что создал Claude?

Claude создал файл агента.

Если проектный агент:

my-project/.claude/agents/landing-page-builder.md

Если персональный агент:

~/.claude/agents/landing-page-builder.md

Содержимое будет примерно таким:

---
name: landing-page-builder
description: "Use this agent when you need to create a landing page structure
  and copy for a new product, feature, or service launch. This includes creating
  hero sections, problem/solution blocks, benefits, social proof sections, and CTAs."
model: opus
color: green
memory: user
---

You are an elite product marketing strategist and conversion copywriter
with 15+ years of experience launching products at top-tier tech companies
and startups...

## Process

When given a product or feature description, follow this systematic approach:

### Phase 1: Discovery & Analysis
1. Analyze the product/feature: Identify the core value proposition
2. Define target audience: Create a clear picture of who this product serves
3. Map pain points: Identify 3-5 specific pain points
4. Identify the transformation: Define the before/after state
...

### Phase 3: Landing Page Structure
#### 1. Hero Block
#### 2. Problem Block
#### 3. Solution Block
#### 4. Benefits Block
#### 5. How It Works
#### 6. Social Proof Block
#### 7. FAQ Block
#### 8. Final CTA Block

Обратите внимание — Claude сгенерировал подробный системный промпт на основе вашего короткого описания: процесс из нескольких фаз, структуру лэндинга из 8 блоков, гайдлайны по стилю и чеклист качества. Всё это он придумал сам.

Это обычный текстовый файл — можете попросить Claude показать его или отредактировать.

---

Используем агента

Просто опишите задачу — Claude сам поймёт, что нужно делегировать агенту:

Напиши лэндинг для приложения по учёту финансов "КошелёкПро".
Целевая аудитория — фрилансеры, которые путаются в доходах и расходах.

Или попросите использовать агента явно:

Используй агента landing-page-builder, чтобы написать лэндинг
для приложения "КошелёкПро" — учёт финансов для фрилансеров.

Claude запустит агента, тот поработает в своём контексте и вернёт готовый лэндинг.

Важно: Если Claude не находит агента — перезапустите Claude Code: /exit → claude.

---

Что это нам даёт?

Представьте, что агенты — это люди в вашей команде. У каждого своя роль, свой опыт, своя специализация. Вы не объясняете дизайнеру, как писать код, а копирайтеру — как верстать. Вы просто даёте задачу нужному человеку.

С агентами — то же самое. Вы создаёте специалиста один раз: описываете его роль, даёте контекст, объясняете, как он должен работать. И дальше просто делегируете ему задачи — как реальному сотруднику.

Хотите маркетолога, который пишет лэндинги? Создайте агента. Нужен редактор, который вычитывает тексты? Ещё один агент. Аналитик, который разбирает данные? Третий.

Вы можете создавать агентов под любую задачу — нет никаких ограничений. Чем точнее вы опишете роль и контекст, тем лучше агент будет работать. Это как нанять идеального сотрудника, который никогда не устаёт, не забывает инструкции и всегда доступен.

---

Несколько агентов параллельно: готовим запуск продукта

Одного лэндинга для запуска мало. Нужны ещё посты для соцсетей и email-рассылка.

Представим, что мы таким же способом создали ещё двух агентов: social-posts (пишет посты для Telegram, Instagram и LinkedIn) и email-campaign (готовит email-рассылку с вариантами для тёплой и холодной аудитории).

Теперь у вас три агента. Запустите их одновременно:

Готовим запуск приложения "КошелёкПро" — учёт финансов для фрилансеров.
Запусти параллельно:
- landing-page-builder — лэндинг
- social-posts — посты для соцсетей
- email-campaign — email-рассылку

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

Подсказка: Если агент работает долго, нажмите Ctrl+B — он уйдёт в фоновый режим, и вы сможете продолжить работать в основном диалоге.

Вместо того чтобы делать всё по очереди — лэндинг, потом посты, потом рассылку — вы получаете всё одновременно. Три задачи, которые заняли бы час последовательной работы, выполняются параллельно за время самой длинной из них.

---

Ограничение инструментов

Не все агенты должны уметь всё. Ревьюер кода должен только читать файлы, а не редактировать их. Аналитик данных должен выполнять SQL-запросы, но не трогать код.

Используйте поле tools в frontmatter:

---
name: code-reviewer
description: Проверяет код на качество и ошибки. Только чтение.
tools: Read, Grep, Glob, Bash
model: sonnet
---

Этот агент может читать файлы и выполнять команды, но не может редактировать или создавать файлы — у него нет Write и Edit.

Основные инструменты

| Инструмент | Что делает | |------------|------------| | Read | Читает файлы | | Write | Создаёт файлы | | Edit | Редактирует файлы | | Bash | Выполняет команды в терминале | | Grep | Ищет текст в файлах | | Glob | Ищет файлы по шаблону |

Если tools не указано — агент наследует все инструменты из вашего основного диалога.

---

Выбор модели

Поле model определяет, какая модель будет думать за агента:

| Модель | Когда использовать | |--------|-------------------| | haiku | Быстрые, простые задачи: поиск файлов, сбор информации. Дешевле и быстрее | | sonnet | Баланс скорости и качества. Подходит для большинства задач | | opus | Сложный анализ, нестандартные задачи. Самая мощная, но медленнее | | inherit | Та же модель, что в вашем основном диалоге. Используется по умолчанию |

Пример: агент, который только ищет информацию, может работать на haiku — быстро и дёшево. А агент, который пишет тексты, лучше поставить на sonnet или opus.

---

Память агента

По умолчанию агент забывает всё после завершения задачи. Каждый запуск — с чистого листа. Но можно включить память — и тогда агент будет сохранять заметки о своей работе и использовать их в следующих сессиях.

Как это работает: после выполнения задачи агент записывает в специальную папку то, что узнал — какие паттерны встретил, какие решения принял, что сработало хорошо. При следующем запуске он сначала читает свои заметки и учитывает их.

---
name: code-reviewer
description: Проверяет код на качество и ошибки
memory: user
---

Например, агент для лэндингов после нескольких задач запомнит: "Этот пользователь предпочитает короткие заголовки и неформальный тон". В следующий раз он сразу будет писать в нужном стиле.

Поле memory определяет, где агент хранит заметки:

| Значение | Что это значит | |----------|---------------| | user | Агент помнит всё, что узнал — в любом проекте. Подходит для персональных агентов | | project | Агент помнит только этот проект. Подходит для проектных агентов |

---

Готовые агенты через плагины

Необязательно создавать агентов с нуля — можно установить готовых. Плагины — это готовые наборы скиллов и агентов, которые написали другие люди и выложили в открытый доступ. В Claude Code есть маркетплейс, где их можно найти и установить в пару кликов.

Введите /plugin в Claude Code — откроется список доступных плагинов:

Нажмите Install, выберите куда хотите установить — и агент готов к работе. Вы можете искать нужные плагины по названию или описанию и использовать те, которые подходят под ваши задачи.

Подробнее про плагины — в документации.

---

Хорошие практики

Один агент — одна задача

Не пытайтесь сделать одного агента, который умеет всё. Агент для лэндингов не должен заодно писать посты для соцсетей. Чем точнее роль — тем лучше результат.

Пишите подробные описания

Поле description — это главное, на что смотрит Claude, когда решает, какого агента запустить. "Полезный агент" — плохо. "Пишет лэндинги для запуска продуктов с hero-секцией, преимуществами и CTA" — хорошо.

Ограничивайте инструменты

Если агент должен только анализировать — не давайте ему возможность редактировать файлы. Меньше инструментов — меньше шансов, что агент сделает что-то лишнее.

Отправляйте тяжёлую работу агентам

Если задача требует перечитать много файлов, прогнать тесты или обработать большой объём данных — отдайте её агенту. Вся эта работа останется в его контексте, а вам вернётся только краткий результат. Ваш основной диалог не засорится.

Продолжайте работу агента

Каждый запуск агента — это новый старт с чистого листа. Но если агент уже сделал часть работы и вы хотите продолжить — попросите Claude:

Продолжи работу предыдущего агента — пусть теперь добавит секцию с отзывами.

Claude возобновит агента с полным контекстом предыдущей работы. Агент вспомнит всё, что делал, и продолжит с того места, где остановился.

Выстраивайте цепочки

Агенты могут работать не только параллельно, но и последовательно — один за другим:

Сначала запусти агента code-reviewer — пусть найдёт проблемы в коде.
Потом передай результат агенту optimizer — пусть исправит то, что нашёл ревьюер.

Claude передаст результат первого агента второму.

---

Наделяем агентов суперсилами

Агенты и так умеют многое. Но их можно сделать ещё мощнее.

Агент vs CLAUDE.md

CLAUDE.md — это общие правила вашего проекта. Агенты их тоже видят. Если в CLAUDE.md написано "все тексты на русском" — агент будет писать на русском. Если "используй табы вместо пробелов" — агент будет использовать табы.

То есть вам не нужно дублировать общие правила в каждом агенте. Достаточно один раз прописать их в CLAUDE.md — и все агенты в проекте будут их соблюдать.

---

Агент vs Skill

Skill — инструкция для Claude в вашем диалоге. Как шпаргалка, которую Claude держит перед глазами. Подходит для правил, стилей, шаблонов.

Agent — отдельный работник с отдельным контекстом. Подходит для задач, которые можно отдать и забыть: "сходи проверь код", "напиши лэндинг", "собери данные".

Агент работает в отдельном контексте и не видит ваши скиллы. Но можно подгрузить скиллы прямо в агента через поле skills::

---
name: landing-page-builder
description: Пишет лэндинги для запуска продуктов
skills:
  - presentation-style
  - brand-guidelines
model: sonnet
---

Ты пишешь лэндинги. Используй правила оформления из загруженных скиллов.

Теперь агент при запуске сразу получит содержимое скиллов presentation-style и brand-guidelines — и будет следовать вашим правилам, хотя работает в отдельном контексте.

---

Агент vs MCP

MCP подключает Claude к внешним сервисам — Google Sheets, Slack, базы данных, Figma. Без MCP агент просто не может туда достучаться.

Пример: вы хотите, чтобы агент для лэндингов брал данные о продукте из Google Sheets, а не из вашего промпта. MCP для Google Sheets даёт агенту доступ к таблицам. А системный промпт агента объясняет — какую таблицу открывать и что с данными делать.

Или агент для email-рассылки может через MCP отправить готовое письмо в Mailchimp, а агент для постов — опубликовать пост в Telegram через бота.

Чтобы дать агенту доступ к MCP-серверам, используйте поле mcpServers:

---
name: landing-page-builder
description: Пишет лэндинги для запуска продуктов
mcpServers:
  - google-sheets
model: sonnet
---

Имя сервера должно совпадать с тем, что уже настроено в вашем Claude Code.

---

Как это всё работает вместе

Каждая сущность отвечает за своё. В реальном проекте они дополняют друг друга:

• CLAUDE.md задаёт общие правила: "тексты на русском, тон дружелюбный"
• Skill хранит инструкции для конкретной задачи: как оформлять лэндинг
• MCP подключает внешние сервисы: Google Sheets с данными о продукте
• Agent берёт на себя работу: один пишет лэндинг, другой — посты, третий — рассылку

---

Частые проблемы

Агент не появляется

• Если создавали вручную (файл .md) — перезапустите Claude Code: /exit → claude
• Если через /agents — должен быть доступен сразу
• Проверьте путь: файл должен быть в .claude/agents/ (проектный) или ~/.claude/agents/ (персональный)

Claude не использует агента автоматически

• Проверьте description — он должен чётко описывать, когда использовать агента
• Попробуйте попросить явно: "Используй агента landing-page-builder для этой задачи"

Агент делает то, что не должен

Ограничьте инструменты через tools. Если агент должен только читать — уберите Write и Edit.

Агент работает слишком долго

Добавьте maxTurns в frontmatter — это ограничит количество шагов:

maxTurns: 20

---

Готово!

Теперь вы знаете, как создавать агентов и использовать их для параллельной работы.

Полезные ссылки:

• Документация по агентам: code.claude.com/docs/en/sub-agents
• Документация по плагинам: code.claude.com/docs/ru/discover-plugins