Харви: открытый ИИ-агент продаж на Claude Code, как работает и как запустить

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

Оглавление

1. Что такое Харви и что он делает
2. Как работает Харви: шаги от поиска до письма
3. Что нужно для запуска
4. Сколько это стоит
5. Как настроить Харви через Claude Code
6. Как настроить Харви вручную
7. Ограничения, которые нужно знать до запуска
8. Холодные письма: правила и отдельный домен
9. Кому Харви подходит, а кому нет
10. Памятка
11. Частые вопросы
12. Источники

Так поиск клиентов вручную съедает вечера и всё равно идёт волнами. Неделю Вы пишете каждый день, две недели не пишете вовсе, потому что нет сил. Компании, которым Вы были бы полезны, о Вас не узнают, а продажи держатся на случайных рекомендациях.

Часть этой работы можно отдать помощнику, а решения оставить себе. В этой статье разберём Харви: открытого ИИ-агента продаж, который ищет компании, читает их сайты и готовит письма. Что он делает, что нужно для запуска, как его настроить и где у него границы. Описание построено на README проекта (в нём указана версия 0.2.1, на GitHub уже есть релиз 0.3.0, описание могло устареть), самой работы Харви я пока не проверяла.

Что такое Харви и что он делает

Харви (Harvey) это открытый проект на GitHub. В описании сказано, что это автономный агент продаж, который работает на Вашей подписке Claude Code или Codex. Он находит компании, которым есть смысл продавать, и узнаёт про каждую что-то конкретное.

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

Главная особенность в том, что у проекта нет отдельной оплаты за обращения к модели. Харви использует подписку, которую Вы уже оплачиваете: Claude Pro или Max через Claude Code либо ChatGPT через Codex. Лицензия проекта MIT, то есть код открытый и его можно изменять.

Показательно и то, как автор понимает автономность: контроль остаётся. У агента есть тихие часы, лимит на расход подписки, потолок отправок, очередь одобрения и аварийный выключатель. Перед тратой денег и перед отправкой письма Харви спрашивает Вас, пока Вы сами не решите иначе.

Как работает Харви: шаги от поиска до письма

Внутри Харви работает циклом. Он просыпается, проверяет лимиты и тихие часы, решает, что сейчас важнее всего, делает это и засыпает. По умолчанию цикл повторяется каждые 15 минут.

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

Работа над одной партией компаний выглядит так.

1. Обучение. Вы даёте адрес своего сайта, и Харви читает его, чтобы понять, что Вы продаёте, кому и чем Вы полезны.
2. Подтверждение сигналов. Харви умеет собирать 23 сигнала о компании, например, нет ли у неё онлайн-записи, запущена ли реклама, давно ли обновлялся блог. Пока Вы не подтвердите, он не собирает ни один. Бесплатных сигналов 21, их можно подтвердить одной командой.
3. Поиск компаний. По умолчанию источником служит карта OpenStreetMap, это бесплатно. Платные источники тоже есть, но перед запуском Харви показывает оценку расхода и ничего не вызывает, пока Вы не нажмёте «пуск».
4. Чтение сайтов. Для каждой компании он делает три обычных запроса к её сайту и вытаскивает факты: какое агентство обслуживает сайт, есть ли реклама, заброшен ли блог. Модель на этом шаге не вызывается, поэтому шаг бесплатный.
5. Поиск контактов и проверка адресов. Агент определяет, кто принимает решения, и проверяет адрес. Письма уходят только на адреса, которые прошли проверку.
6. Письма. Для каждой компании готовится цепочка из трёх писем. Первое и второе до 75 слов, третье до 40. Есть список запрещённых оборотов, которые выдают ИИ.
7. Одобрение и отправка. Каждое письмо ждёт Вашего решения. Перед отправкой его проверяет код без участия модели: нет ли незаполненных полей, лишних ссылок, запрещённых фраз.
8. Ответы. Харви читает ответы, определяет, чего хочет собеседник, и готовит следующее сообщение. Оно проходит ту же очередь одобрения.

Есть и побочная польза. Если письма Вы не хотите отправлять вовсе, команда harvey export выгрузит найденные компании с проверенными адресами в файл CSV. Автор прямо пишет, что Харви стоит запускать и в таком режиме.

Что нужно для запуска

Список недлинный.

1. Python 3.11 или новее. Проверить версию можно командой python3 --version. На Mac из коробки часто стоит версия 3.9, ей запустить Харви не получится. В README советуют поставить python@3.13 через brew.
2. Подписка. Активный Claude Pro или Max, на компьютере должен быть установлен Claude Code и выполнен вход. Вместо этого можно взять тариф ChatGPT с Codex, но этот вариант включается отдельно и работает на macOS и Linux.
3. Почтовый ящик. Для отправки нужен ящик: рекомендуют Gmail или Google Workspace, подходит и Microsoft 365, и обычная почта по SMTP. Ящик лучше завести на отдельном вторичном домене (подробнее в разделе про правила холодных писем).
4. Время на проверку. Письма придётся одобрять самим, а ящик прогревать, об этом ниже.

Если Вы выбираете подписку ChatGPT, учтите, что для Codex проект требует точную версию программы Codex CLI. В README указана версия 0.159.3, другие, в том числе более новые, Харви не принимает. На Windows вариант с Codex не поддерживается, там нужен Claude.

Сколько это стоит

Отдельной платы за модель нет, это Ваша обычная подписка. Остальное по таблице из README выглядит так.

Цены сервисов меняются, поэтому перед запуском сверьте их на сайтах провайдеров. Дополнительно у подписок есть лимиты. Харви сам читает остаток и притормаживает, чтобы оставить запас для Вашей работы, но проверить условия выбранного тарифа должны Вы.

Как настроить Харви через Claude Code

Это самый простой путь, и он нужен тем, кому неудобна командная строка. В README он назван первым.

1. Скачайте проект: в терминале выполните git clone https://github.com/ethanplusai/harvey.git, затем перейдите в папку harvey.
2. Запустите Claude Code командой claude.
3. Напишите ему: set up Harvey for me.

В репозитории лежит файл CLAUDE.md, который превращает Claude Code в мастера установки. Он смотрит, на каком этапе Вы находитесь, доустанавливает недостающее, задаёт вопросы и обучает Харви на Вашем продукте. Вопросы он задаёт по ходу, поэтому ответы лучше подготовить заранее. Пригодятся адрес сайта, по которому Харви поймёт Ваш продукт, портрет компаний, которым Вы полезны, и почтовый ящик на отдельном домене.

Как настроить Харви вручную

Для тех, кто привык к терминалу, в README есть шесть шагов.

python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .
cp .env.example .env
harvey train https://your-company.com
harvey signals --confirm free
harvey discover
harvey dashboard
harvey run

Что делает каждая команда.

• Первая строка создаёт виртуальное окружение и ставит проект. В README подчёркнуто: на Mac нужен именно python3.13, а не просто python3, иначе окружение соберётся из старой версии 3.9.
• .env это файл с доступами. Его нужно открыть и заполнить, у каждой переменной внутри есть пояснение. Обязательна только почта, остальное по желанию.
• harvey train читает Ваш сайт и учит агента. Вместо адреса из примера впишите свой.
• harvey signals --confirm free подтверждает бесплатные сигналы. Без этого шага поиск ничего не найдёт.
• harvey discover ищет компании. Перед ним можно выполнить harvey discover --estimate, чтобы увидеть оценку расхода.
• harvey dashboard открывает панель на Вашем компьютере по адресу localhost:5555, там видны компании, очередь писем и ответы.
• harvey run запускает цикл.

Остановить Харви можно в любой момент. Сочетание клавиш Ctrl+C выключает цикл, а команда harvey sending pause останавливает только отправку. Состояние хранится в локальной базе, так что работа возобновляется без потерь.

Ограничения, которые нужно знать до запуска

Часть ограничений названа в README прямо. Вот главное.

• Только компании. Харви ищет бизнесы и пишет им. Частных людей в поиске нет.
• Письма ждут одобрения. По умолчанию ничего не уходит без Вашего «да». Настройку можно выключить, но для начала лучше оставить: так Вы увидите, что именно уходит от Вашего имени.
• Автозаписи в календарь нет. Интеграция календаря для автоматической записи на встречу указана в планах проекта. Сейчас агент ведёт разговор к встрече, но не бронирует её.
• Всё на английском. Инструкции и шаблоны писем рассчитаны на английский язык. Как Харви пишет и понимает ответы по-русски, об этом не сказано.
• Россия не проверена. Правовая часть описывает США, Евросоюз и Великобританию. Как агент работает с российскими компаниями и найдутся ли они в источнике данных, неизвестно.
• Охват бесплатного источника неравномерный. OpenStreetMap описывает помещения, поэтому компаний без заметного офиса или магазина там мало. Автор признаёт это сам.
• Подписка не безлимитна. У Вашего тарифа есть лимиты, и агент их учитывает, как и тихие часы. Когда лимит выбран, Харви притормаживает и ждёт.

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

Холодные письма: правила и отдельный домен

*Не юридическая консультация. Ниже пересказаны рекомендации из описания проекта. Нормы права Вашей страны это не заменяет.*

Отправитель писем Вы, а не Харви: он только автоматизирует рассылку. Холодное письмо, по тексту проекта, законно в большинстве мест, если делать всё правильно, и дорого обходится, если неправильно. Для США приведён пример штрафа до 53 088 долларов за одно письмо за нарушения закона CAN-SPAM.

Для Евросоюза и Великобритании сказано, что письмо компании требует обоснованного законного интереса. Предложение должно быть по делу для конкретного человека, а источник адреса Вы обязаны знать.

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

Практические правила оттуда же:

1. Заведите отдельный домен для рассылки. Не пишите холодные письма с основного домена. Например, к адресу acme.com берут вторичный getacme.com.
2. Настройте SPF, DKIM и DMARC: три записи в настройках домена, которые подтверждают, что письма шлёте именно Вы. Без всех трёх Gmail отправит письма в спам.
3. Прогрейте ящик 2–4 недели. Если с первого дня разослать всё сразу, письма попадут в спам, а репутацию домена потом долго восстанавливать.
4. Начинайте с малого. Советуют 10–20 писем в день на один ящик и рост примерно на 5 в день. Лимит 50 писем в день в настройках по умолчанию это верхняя граница, ориентироваться на неё не нужно.
5. Следите за возвратами. Если недоставленных писем больше примерно 3%, остановитесь и поправьте список адресов.

Для США перечислены условия: честная тема письма, рабочий отказ от рассылки и физический почтовый адрес в подписи, который нужно настроить до первой кампании. Если собеседник спросит, с ИИ ли он общается, Харви по инструкции отвечает честно. Автор проекта просит не менять это поведение.

Кому Харви подходит, а кому нет

Подойдёт, если Вы продаёте услуги компаниям и у Вас есть понятный портрет клиента: отрасль, размер, город. Сюда относятся студии, агентства, фрилансеры с B2B-услугами, специалисты по автоматизации. Подойдёт и тем, кто любит проверять всё сам: очередь одобрения оставляет Вам последнее слово.

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

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

Наконец, Харви не заменяет разговор с живым клиентом. Он готовит почву и ведёт переписку, а встречу, цену и решение о сотрудничестве обсуждаете Вы.

Если Вам интересны смежные задачи, посмотрите разбор бесплатного инструмента для сбора базы компаний ScrapeGraphAI и подборку 5 MCP-серверов для Claude Code.