Разработка AI-чатбота с помощью Claude Code: результат за 4 часа и открытый код.

Для нашей платформы мы заказали разработку AI-чатбота с помощью инструмента Claude Code CLI. Через четыре часа мы получили готовое решение, включающее контекстно-зависимый виджет, базу знаний в формате Markdown, возможность эскалации в Telegram и автоматический сбор ошибок. Разработанный чатбот уже функционирует в рабочей среде, и его код опубликован в открытом доступе. **GitHub:** github.com/gmen1057/ai-chat-widget **Лицензия:** MIT **Причины создания чатбота** На наших платформах пользователи часто задают одни и те же вопросы о работе сервиса, его стоимости, проблемах с получением писем и отмене подписки. Традиционные методы решения этой проблемы, такие как найм службы поддержки или создание обширного FAQ, имеют свои недостатки: поддержка обходится дорого, а FAQ пользователи редко читают. Поэтому мы решили создать AI-консультанта. **Требования к чатботу:** * отвечать на вопросы о платформе; * определять страницу, на которой находится пользователь; * при необходимости привлекать человека; * автоматически регистрировать ошибки, когда пользователь жалуется; * встраиваться одной строкой кода; * быть полностью изолированным от основного проекта. **Почему был выбран Claude Code** Ранее мы уже использовали Claude Code для других компонентов проекта и оценили его преимущества, такие как быстрая итерация, понимание контекста и способность поддерживать архитектуру. Новая версия opus 4.5 продемонстрировала ещё более высокую эффективность. **Разработка чатбота** Для создания чатбота мы описали требования, после чего Claude Code сгенерировал архитектуру. Мы внесли коррективы, после чего инструмент написал код. Затем мы провели тестирование и исправили выявленные ошибки. Всего процесс занял четыре итерации и четыре часа. **Архитектура чатбота** Архитектура чатбота включает три слоя: 1. Виджет, написанный на чистом JavaScript, который встраивается одним тегом без дополнительных зависимостей. 2. Backend на FastAPI, который обрабатывает сообщения, хранит историю и вызывает Claude API. 3. Интеграции с Telegram для эскалации и уведомлений о багах. **Ключевые технические решения** Чатбот работает без необходимости настройки базы данных. По умолчанию история чатов хранится в JSON-файлах. Если проект вырастет, можно легко переключить хранение данных на SQLite или PostgreSQL, изменив одну переменную. Виджет не привязан к конкретной модели AI. Поддерживаются различные AI-провайдеры, включая OpenAI, Claude, Gemini, GigaChat, YandexGPT, DeepSeek, Qwen, Ollama и любые API, совместимые с OpenAI. Переключение между провайдерами осуществляется изменением трёх строк в конфигурации.