1 / 8
или Space для навигации
Гайд для команды

Как создавать AI-агентов
в Claude Code

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

Агенда
  1. 00.Зачем нужен сервер с VS Code
  2. 01.Концепция — что такое агент и как он работает
  3. 02.Процесс создания нового агента
  4. 03.Два типа агентов
  5. 04.Типичные ошибки
Контекст

Зачем нужен сервер с VS Code

💻

Проблема без сервера

У каждого всё хранится локально — на своём компьютере. Нет единой базы. Один сделал агента — другой его не видит. Уехал в отпуск, сломался ноутбук — работа встала.

🗄️

Сервер решает это

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

🔒

Надёжность

Если аккаунт Claude заблокируют или сервис ляжет — вся информация остаётся на сервере. Подключил другой аккаунт — продолжил с того же места.

Часть 1

Что такое агент

Агент — это отдельный экземпляр Claude, которому дана конкретная роль, набор инструментов и системный промпт. Это тот же Claude, но запущенный с определёнными ограничениями и инструкциями.
Обычный чат Агент
Отвечает на любые вопросы Ограничен конкретной зоной ответственности
Без роли и контекста Имеет чёткую роль и знает свои задачи
Не работает с файлами автоматически Самостоятельно читает данные, пишет файлы, запускает скрипты
Интерактивный Запускается автоматически, работает до конца задачи
Помнит сессию только в чате Помнит контекст проекта между запросами (через memory)
Часть 1 · Термины

Ключевые термины

01
Системный промпт
Должностная инструкция агента: кто он, что умеет, где искать данные. Пользователь не видит.
02
Инструменты Tools
Что агент умеет: читать/писать файлы, терминал, веб, Drive. Разрешаются явно.
03
Бриф
Задание агенту. Первое сообщение, должно содержать весь контекст.
04
Ход Turn
Один цикл: подумал → вызвал инструмент → получил результат. maxTurns: 30 = лимит циклов.
05
Скилл Skill
Отдельный файл со сценарием. Подгружается через Read только когда нужен.
06
Self-critique
Агент сам оценивает свой результат, ставит балл, при необходимости переделывает.
07
jobs.jsonl
Лог задач: что делали, для кого, результат. Для отслеживания истории и качества.
08
Таймаут
Лимит времени работы агента в секундах. По истечении процесс останавливается.
09
Memory
Память агента. memory: project = помнит контекст проекта между сообщениями сессии.
Часть 2

Процесс создания агента

Главный flow

1 Идея
2 Claude составляет план
3 Вы утверждаете план
4 Пошаговая реализация
Готовый агент

Шаг 1. Шаблон промпта

Мне нужен агент [название].
Он должен [что делает], чтобы [зачем / какая цель].
На входе получает [что подаётся].
На выходе возвращает [что должно получиться].
Агент должен включать в себя:
- prompt.md         ← роль агента и инструкции
- output/jobs.jsonl ← лог выполненных задач
- скиллы            ← если есть типовые сценарии

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

Пример формулировки

Мне нужен агент-аналитик конкурентов.
Он должен находить рекламные объявления
конкурентов в ВК и Telegram и анализировать
офферы и триггеры, чтобы понять чем мы
отличаемся.
На входе получает список конкурентов
и проект для сравнения.
На выходе возвращает структурированный
отчёт: что продвигают, какие триггеры
используют, в чём наше отличие.
Часть 2 · Шаги 2–4

План, утверждение, реализация

Шаг 2. План от Claude

agents/analyst/
├── prompt.md
├── skills/
│   ├── vk-scan.md
│   ├── tg-scan.md
│   └── offer-analysis.md
└── output/jobs.jsonl

Инструменты: WebSearch, WebFetch, Read/Glob.

projects/context.txt — общая база, держите актуальной.

Шаг 3. Чек-лист утверждения

  • Правильно ли определена роль?
  • Нет ли лишних инструментов?
  • Понятен ли выход агента?

Шаг 4. Пошаговая реализация

  1. Создаю структуру папок
  2. Пишу файл агента
  3. Создаю скиллы
  4. Тестирую агента
  5. Агент добавлен в команду — готов к работе
Каждый шаг — с вашим подтверждением.
Часть 3

Два типа агентов

Тип 1. Координатор (Teamlead)

Главный агент. Декомпозирует задачу, вызывает исполнителей, проверяет результат.

Каждый ход = одно действие + показать + спросить.
Пользователь: «Пост с баннером для ВК»
       ↓
Teamlead: план (Copywriter → Creator)
       ↓ «Запускаю шаг 1?»
Copywriter → текст → «Идём к баннеру?»
       ↓
Creator → баннер → «Правки нужны?»

Тип 2. Исполнитель (Субагент)

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

Агент Делает Не делает
SMM контент-планы, посты, аналитика лендинги, видео
Copywriter статьи, сценарии, ВК, email баннеры, контент-планы
Creator баннеры, видео, визуалы тексты, аналитику
Один агент = одна зона ответственности
Часть 4

Типичные ошибки

Ошибка 01
Агент делает слишком много
× Пишет, генерит, публикует, анализирует — всё в одном.
Один агент = одна зона. Несколько агентов под координатором.
Ошибка 02
Устаревший context.txt
× Контент по старым данным: несуществующие программы, изменившаяся ЦА.
Обновляйте при любых значимых изменениях.
Ошибка 03
Агент решает за пользователя
× Сам выбирает, публикует, удаляет без подтверждения.
Агент предлагает варианты → пользователь выбирает → агент делает.
Ошибка 04
Слабый бриф субагенту
× «Напиши пост про набор» — без контекста.
Бриф = проект + ЦА + tone of voice + задача + ограничения.
Ошибка 05
Неправильный таймаут
× 480 сек на текст или 60 сек на баннер.
Таймаут под тип задачи.
Ошибка 06
Нет логирования в jobs.jsonl
× Агент работает, но не записывает.
Каждая задача → запись в jobs.jsonl.
Финал

Что запомнить

01
Один агент = одна зона ответственности
02
Держите context.txt в projects/ актуальным
03
Пользователь утверждает — агент делает
04
Логируйте всё в jobs.jsonl
Готовы создать своего агента?